docs: add TUI dashboard to architecture and history

Co-Authored-By: Charon <charon@lethean.io>
This commit is contained in:
Claude 2026-02-23 00:06:28 +00:00
parent 0aba33fa6e
commit cd8ed3d502
No known key found for this signature in database
GPG key ID: AF404715446AEB41
2 changed files with 24 additions and 0 deletions

View file

@ -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

View file

@ -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