manpengan
b91f8d1bdb
docs: all 3 spikes completed - spec gate passed, ready for impl plan
...
Spike 1 (pane mode): PASS
- dual probe: $TMUX env + display-message stdout non-empty (not exit code!)
- split-window geometry correct (200x45 main + 200x4 HUD)
- kill-pane reliable, main pane survives
Spike 3 (inline fallback): PASS (conditional)
- scroll region works in real TTY (tmux session)
- SIGINT + exit cleanup both fire correctly
- codex --no-alt-screen confirmed no alternate screen sequences
- isTTY check required at startup
Architecture decisions locked:
- pane mode: primary (confirmed)
- inline mode: fallback (confirmed, keep)
- passthrough: last resort
- rate limits from JSONL token_count (no extra API needed)
- stdout parsing: dropped from v1
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-22 09:13:22 +08:00
manpengan
befc86acaa
docs: record spike 2 results, add spike 1/3 manual scripts
...
Spike 2 (data source) completed:
- All SQLite threads fields verified stable (model, cwd, git_branch, tokens_used)
- JSONL event names stable across 2 sessions (function_call, task_started, token_count, etc.)
- Bonus: token_count event has rate_limits.primary/secondary.used_percent and plan_type
- HudState updated with rateLimitPrimary, rateLimitSecondary, planType fields
Spike 1 (pane mode): pending - tmux not installed, manual steps documented
Spike 3 (inline): pending - needs real TTY, test script provided
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-22 09:05:37 +08:00
manpengan
ebaf9c8f9a
docs: add pre-implementation spikes section to design spec
...
Three spikes gating the implementation plan:
- Spike 1: pane mode capability (tmux split + cleanup)
- Spike 2: data source stability (SQLite fields + JSONL event names)
- Spike 3: inline fallback safety (scroll region + terminal cleanup)
Each spike has goal, verification method, pass criteria, and fallback decisions.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-22 08:59:01 +08:00
manpengan
9176bd9c1b
docs: tighten design spec with risk assessment and mode hierarchy
...
- Add confidence/risk assessment section (confirmed, unverified, risks)
- Explicitly frame inline mode as degraded fallback, not peer to pane
- Clarify renderer shared boundary (layout output only, not terminal control)
- Add SQLite schema versioning and JSONL protocol instability mitigations
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-03-22 08:56:03 +08:00
manpengan
e38e56ba3e
docs: add codex-hud design spec and original plan
...
Design spec covers dual-mode architecture (tmux pane + inline fallback),
SQLite/JSONL data layer, HUD layout, installation, and error handling.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-03-22 08:48:25 +08:00
