docs: keep mermaid diagram, link interactive map to maps.lab.audasmedia

docs/README.md

@@ -4,7 +4,26 @@ Architecture artifacts for pi-dashboard, generated by the `project-diagramming-m
 
 ## Interactive map
 
-[▶ Open the interactive map](./pi-dashboard-map.html) — self-contained HTML; open in a browser for pan/zoom, search, theme toggle, route tracing.
+[▶ 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