Go to file

Sam Rolfe 3b3e63afb9 docs: add architecture diagrams (Mermaid + Archify map) for pi-dashboard

- docs/pi-dashboard.mmd — Mermaid source of truth
- docs/diagrams/pi-dashboard.png|svg — rendered via mmdc (mermaid-cli 11.16.0)
- docs/archify/pi-dashboard.architecture.json — Archify JSON IR
- docs/pi-dashboard-map.html — interactive map (9/9 showcase checks)
- docs/README.md — embedded mermaid + artifact index + regenerate commands
- visual-check screenshots/evidence at 1440x900 + 2048x1320 (light/dark)

Generated by project-diagramming-mermaid + project-diagramming-archify skills.

2026-09-06 11:35:09 +10:00

docs

docs: add architecture diagrams (Mermaid + Archify map) for pi-dashboard

2026-09-06 11:35:09 +10:00

config.go

TUI: folder/started/closed columns, heartbeat staleness, hide-closed (x), hide-sub (z), sort (s), detail pane, hunk in agent cwd, tuxedo project todo, zellij/tmux attach, fix remote JSON parsing

2026-08-04 11:04:41 +10:00

go.mod

Pi Dashboard TUI viewer — Go + Bubble Tea. Reads pi agent state files, cross-machine SSH pull, Enter=tmux attach, d=Hunk diff, Tab=Tuxedo tasks

2026-07-31 14:25:37 +10:00

go.sum

Pi Dashboard TUI viewer — Go + Bubble Tea. Reads pi agent state files, cross-machine SSH pull, Enter=tmux attach, d=Hunk diff, Tab=Tuxedo tasks

2026-07-31 14:25:37 +10:00

main_test.go

TUI: Del key deletes closed/lost state files (local+SSH, live refused), sort-column ▼ marker, delete/shellquote/sort-column tests

2026-08-06 15:23:06 +10:00

main.go

TUI: fix broken sort-marker — plain ▼ text (ANSI in truncated titles corrupted the header)

2026-08-06 15:43:44 +10:00

state.go

TUI: async polling off UI thread, 5s SSH hard timeout + remote cooldown, at-most-one-fetch, ? help menu

2026-08-06 15:12:17 +10:00

docs/README.md

Pi Dashboard — Diagrams

Architecture artifacts for pi-dashboard, generated by the project-diagramming-mermaid + project-diagramming-archify skills (per-project docs/ convention).

Overview

Source of truth: pi-dashboard.mmd
Rendered (via mmdc, mermaid-cli 11.16.0):
- diagrams/pi-dashboard.png (@2x, white bg)
- diagrams/pi-dashboard.svg (vector)
Interactive map (Archify, 9/9 showcase checks): pi-dashboard-map.html — open in a browser for pan/zoom, search, theme toggle, route tracing
Archify spec (JSON IR): archify/pi-dashboard.architecture.json

Diagram (Mermaid)

Renders natively in Obsidian; shows as ASCII in pi via the pi-mermaid extension.

flowchart LR
  EXT["dashboard.ts pi extension"] -->|"writes JSON"| SF[("state files ~/.pi/agent/dashboard")]
  REM["remote machines .13 .51"] -->|"ssh cat *.json, 5s timeout + cooldown"| ST["state.go"]
  SF -->|"readLocalStates"| ST
  ST -->|"AgentState"| MAIN["main.go bubbletea TUI"]
  CFG["pi-dashboard.yaml"] -->|"loadConfig"| MAIN
  MAIN -->|"2s poll tick"| ST
  MAIN -->|"table + detail"| UI["Table + Detail panes"]
  UI -->|"Enter"| AT["tmux / zellij attach"]
  UI -->|"d"| HK["hunk diff"]
  UI -->|"Tab"| TX["tuxedo todo.txt"]
  UI -->|"Del"| SF

Regenerate

# update the source
vim pi-dashboard.mmd
# re-render images
mmdc -i pi-dashboard.mmd -o diagrams/pi-dashboard.png --scale 2 -b white
mmdc -i pi-dashboard.mmd -o diagrams/pi-dashboard.svg
# update the Archify map (JSON IR in archify/, then):
node ~/.agents/skills/archify/bin/archify.mjs validate architecture archify/pi-dashboard.architecture.json --quality showcase --json
node ~/.agents/skills/archify/bin/archify.mjs deliver architecture archify/pi-dashboard.architecture.json pi-dashboard-map.html --quality showcase --json