# 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