# Pi Dashboard — Diagrams

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

## Interactive map

[▶ Open the interactive map](https://maps.lab.audasmedia.com.au/pi-dashboard/docs/pi-dashboard-map.html) — self-contained HTML; open in a browser for pan/zoom, search, theme toggle, route tracing.

## Diagram (Mermaid)

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

```mermaid
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

```bash
# 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
```