diff --git a/docs/architecture.md b/docs/architecture.md index 1a6a1c7..5abf289 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -310,6 +310,23 @@ detect new blocks. Re-fetches the template when the chain height advances. **Testing:** Mock `TemplateProvider` for unit tests. Build-tagged integration test against C++ testnet daemon on `localhost:46941`. +### tui/ — Terminal Dashboard + +Model library for the blockchain TUI dashboard: + +| File | Purpose | +|------|---------| +| `node.go` | Node wrapper — polls chain for status snapshots | +| `status_model.go` | StatusModel (FrameModel) — chain sync header bar | +| `explorer_model.go` | ExplorerModel (FrameModel) — block list / block detail / tx detail | +| `keyhints_model.go` | KeyHintsModel (FrameModel) — context-sensitive key hints | +| `messages.go` | Custom bubbletea message types | + +### cmd/chain/ — TUI Binary + +Thin wiring: creates Node, StatusModel, ExplorerModel, KeyHintsModel, wires into +core/cli Frame ("HCF" layout), starts P2P sync in background, runs Frame. + --- ## Key Types diff --git a/docs/history.md b/docs/history.md index 483e5c6..6afd637 100644 --- a/docs/history.md +++ b/docs/history.md @@ -675,3 +675,10 @@ coverage. **Future forks are placeholders.** HF3 through HF6 are defined with activation height 999,999,999 on mainnet. These heights will be updated when each fork is scheduled for activation on the live network. + +## TUI Dashboard (Phase 9) + +- `tui/` model library: Node wrapper, StatusModel, ExplorerModel, KeyHintsModel +- `cmd/chain/` standalone binary with P2P sync +- Uses core/cli Frame (bubbletea + lipgloss) +- Block explorer with three views: block list, block detail, tx detail