zhanj/claude-hud
1
0
Fork 0
mirror of https://github.com/jarrodwatts/claude-hud.git synced 2026-05-12 01:06:21 +00:00
Code Issues Packages Projects Releases Wiki Activity
30 Commits 46 Branches 3 Tags
5d01f9ce7793f33fa0e4e6a677dc08d2da07d0e2
Commit Graph

4 Commits

Author SHA1 Message Date
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
Jarrod Watts
6bb9c675f2 docs: Add changelog for v2 development 
Tracks all changes being made during the architecture overhaul.
Users can read this to understand what's changing and why.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-02 23:10:43 +11:00
Jarrod Watts
e39933fac2 docs: Add architecture decision records for v2 
ADR 001: State Management - Custom hooks + useReducer
- Extract state logic from app.tsx into domain-specific hooks
- useReducer for predictable state transitions
- Each hook independently testable

ADR 002: Data Flow - Event-driven with minimal polling
- Primary: Hook events via FIFO (real-time)
- Secondary: Single consolidated poll (git/mcp only)
- Eliminate redundant polling sources that cause flickering

ADR 003: Shell vs TypeScript - Minimal shell, logic in TS
- Hooks must be shell scripts (Claude Code requirement)
- Keep shell scripts minimal (extract data, write FIFO)
- Complex logic moves to testable TypeScript

ADR 004: Session Handling - Track session ID, graceful reset
- Session ID in all events for change detection
- Reset state on session change (/new, /exit, /resume)
- Exponential backoff reconnection strategy

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-02 23:10:26 +11:00
Jarrod Watts
07e6584e5f docs: Add research findings for claude-hud v2 architecture 
Research covers:
- Claude Code plugin best practices from Anthropic
- TUI design principles from lazygit, btop, and awesome-tuis
- Ink/React terminal UI performance patterns
- Current architecture problems analysis
- Architecture recommendations

Key findings:
- Event-driven over polling for real-time updates
- Use <Static> component for stable UI sections
- Custom hooks + useReducer for state management
- Keep bash hooks minimal, move logic to TypeScript

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

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