Files
claude-hud/docs/CHANGELOG.md
Jarrod Watts e1b8d313f0 docs: Update CHANGELOG and bump version to 2.0.0
Phase 7 - Documentation:
- Update CHANGELOG with all v2.0.0 changes
- Document unified context tracking, cost display, hooks architecture
- List all fixes: flickering, session handling, test reliability
- Reference ADRs and research documents
- Bump version to 2.0.0

All phases complete:
- Phase 1: Research
- Phase 2: Architecture decisions
- Phase 3: Foundation (ESLint, Prettier, hooks)
- Phase 4: Context system rewrite
- Phase 5: Architecture refactor
- Phase 6: Polish & features
- Phase 7: Documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-02 23:25:07 +11:00

1.9 KiB

Changelog

All notable changes to claude-hud will be documented in this file.

[2.0.0] - 2026-01-02

Architecture Overhaul

A complete rewrite focusing on stability, accuracy, and developer experience.

Added

  • UnifiedContextTracker: Single source of truth for context tracking
    • Reads real token counts from Claude transcript files
    • Falls back to estimation when transcript unavailable
    • Eliminates flickering from dual data sources
  • CostDisplay: Real-time API cost estimation
    • Tracks input/output tokens separately
    • Automatic model detection for accurate pricing
    • Supports Opus, Sonnet, and Haiku pricing
  • Custom hooks architecture:
    • useHudState - Centralized state management
    • useElapsedTime - Session timer hook
  • Code quality tooling:
    • ESLint with TypeScript, React, and React Hooks rules
    • Prettier with consistent formatting
    • Husky pre-commit hooks with lint-staged
  • Comprehensive test suite: 152 tests covering all components

Changed

  • app.tsx: Reduced from 329 lines to 136 lines (59% reduction)
  • Context tracking: Reads transcript on Stop events only, not polling
  • State management: Follows ADR 001 pattern with custom hooks

Fixed

  • Context flickering: Eliminated dual-source updates
  • Session handling: Proper transcript path detection on /resume
  • Test reliability: Fixed race condition in smoke tests

Technical

  • Added Architecture Decision Records (ADRs):
    • ADR 001: State management via custom hooks
    • ADR 002: Event-driven data flow with minimal polling
    • ADR 003: Minimal shell scripts, logic in TypeScript
    • ADR 004: Session ID tracking for graceful transitions
  • Research documented in docs/research/RESEARCH.md

[1.0.0] - Initial Release

  • Context meter with sparkline
  • Tool stream with live status
  • Agent tracking
  • Todo list display
  • Session statistics
  • Git status panel
  • MCP server status