Skip to content

Changelog

All notable changes to HtmlGraph will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.3.4] - 2024-12-22

Added

  • Hash-Based ID System: Collision-resistant IDs for multi-agent collaboration
  • Short, readable format: {prefix}-{hash} (e.g., feat-a1b2c3d4)
  • Content-addressable with entropy for collision resistance
  • Hierarchical sub-task support (e.g., feat-a1b2c3d4.1.2)
  • Type-specific prefixes for visual identification
  • Inspired by Beads
  • New htmlgraph.ids module: generate_id(), parse_id(), is_valid_id(), etc.
  • ID Generation API documentation: Complete guide with examples

Changed

  • SDK FeatureBuilder now generates hash-based IDs
  • CLI feature create now generates hash-based IDs
  • Server API creates hash-based IDs for new nodes
  • Session IDs now use hash-based format

Fixed

  • mkdocstrings configuration updated for newer versions (inventories option)

0.3.0 - 2024-12-22

Added

  • TrackBuilder Fluent API: Deterministic track creation with specs and plans
  • Multi-Agent Collaboration: Agent assignment, handoff notes, feature claiming
  • Comprehensive Documentation: Complete docs site with MkDocs Material theme
  • Agent Integration Docs: TrackBuilder documentation in Claude, Codex, and Gemini skills
  • Time Estimation Parsing: Automatic parsing of (Xh) time estimates in task descriptions
  • Track Validation: Pydantic validation for all track components

Changed

  • Updated all agent integration documentation with TrackBuilder examples
  • Improved session start hook with track creation quick reference
  • Enhanced feature creation decision framework

Fixed

  • Track ID persistence in HTML files
  • Drift detection for new modules and directories

0.2.2 - 2024-12-20

Added

  • Drift Detection: Automatic detection of activity misalignment with features
  • Session Validation: Validate attribution with session validate-attribution
  • Enhanced Activity Logging: Richer activity log with agent attribution

Changed

  • Improved session end summaries with next steps
  • Better feature completion tracking
  • Enhanced dashboard with session history view

Fixed

  • Session continuity across conversation compacts
  • Activity attribution edge cases
  • Dashboard refresh issues

0.2.0 - 2024-12-18

Added

  • Tracks: Multi-feature project support with specs and plans
  • Spec Model: Requirements and acceptance criteria
  • Plan Model: Phased implementation planning
  • Track HTML Files: index.html, spec.html, plan.html per track
  • Feature-Track Linking: track_id field on features

Changed

  • Enhanced SDK with tracks API
  • Updated CLI with track commands
  • Improved dashboard with track views

Fixed

  • Feature status transitions
  • Session event ordering

0.1.3 - 2024-12-16

Added

  • Session Management: Automatic session tracking via hooks
  • Activity Logging: Comprehensive activity tracking in sessions
  • Dashboard: Interactive Kanban board and graph views

Changed

  • Improved feature query performance
  • Enhanced HTML file structure
  • Better CSS styling for nodes

Fixed

  • Feature step completion tracking
  • Edge relationship types
  • SQLite index synchronization

0.1.2 - 2024-12-15

Added

  • CLI Commands: htmlgraph command-line interface
  • Dashboard Server: htmlgraph serve for local development
  • Feature Relationships: Typed edges (blocks, related, etc.)

Changed

  • Simplified SDK initialization
  • Improved error messages
  • Better type hints

Fixed

  • Feature file path generation
  • CSS selector query edge cases

0.1.1 - 2024-12-14

Added

  • Pydantic Models: Type-safe Feature, Track, Session models
  • HTML Conversion: Automatic HTML ↔ Pydantic conversion
  • CSS Selector Queries: Query features with CSS selectors

Changed

  • Refactored graph operations
  • Improved HTML file format
  • Enhanced documentation

Fixed

  • HTML parsing edge cases
  • Property serialization

0.1.0 - 2024-12-13

Added

  • Initial release
  • Core SDK: Feature creation and management
  • HTML Files: Features as HTML files on disk
  • Basic Queries: Filter features by status and priority
  • Git Integration: Text-based storage for version control
  • Zero Dependencies: Pure Python with justhtml