pmx-canvas 0.8.0 → 0.9.0

package/src/server/demo-state.json

@@ -22,7 +22,8 @@
       "data": {
         "title": "① Start here",
         "content": "What the agent is doing, what context it holds, what it decided, and the tool calls behind it.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -33,6 +34,9 @@
         "source": "api"
       },
       "contentRevision": 1,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "① Start here",
       "content": "What the agent is doing, what context it holds, what it decided, and the tool calls behind it.",
@@ -58,7 +62,8 @@
       "data": {
         "title": "PMX Canvas — guided tour",
         "content": "# PMX Canvas\n\nAn infinite spatial canvas that agents drive over **MCP**, **HTTP** or the **Bun SDK** — and that humans steer by pinning nodes.\n\nThis board is a live catalogue. Bands ① to ④ and ⑧ run down the left, ⑤ to ⑦ down the right.\n\n| Band | Shows |\n| --- | --- |\n| ① Start here | status · context · ledger · trace |\n| ② Files & review | file · CSV table · diff · image · webpage |\n| ③ Diagrams & surfaces | mermaid · raw HTML · MCP app |\n| ④ Charts | all 12 graph types |\n| ⑤ Structured UI | json-render specs |\n| ⑥ Grouping | one group frame |\n| ⑦ HTML primitives | all 21 generated surfaces |\n| ⑧ Agent at work | a live AX flow, mid-task |\n\n> Pin a node in the browser and the agent reads it back from `canvas://pinned-context`. That is the whole collaboration loop.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -69,6 +74,9 @@
         "source": "api"
       },
       "contentRevision": 2,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "PMX Canvas — guided tour",
       "content": "# PMX Canvas\n\nAn infinite spatial canvas that agents drive over **MCP**, **HTTP** or the **Bun SDK** — and that humans steer by pinning nodes.\n\nThis board is a live catalogue. Bands ① to ④ and ⑧ run down the left, ⑤ to ⑦ down the right.\n\n| Band | Shows |\n| --- | --- |\n| ① Start here | status · context · ledger · trace |\n| ② Files & review | file · CSV table · diff · image · webpage |\n| ③ Diagrams & surfaces | mermaid · raw HTML · MCP app |\n| ④ Charts | all 12 graph types |\n| ⑤ Structured UI | json-render specs |\n| ⑥ Grouping | one group frame |\n| ⑦ HTML primitives | all 21 generated surfaces |\n| ⑧ Agent at work | a live AX flow, mid-task |\n\n> Pin a node in the browser and the agent reads it back from `canvas://pinned-context`. That is the whole collaboration loop.",
@@ -105,6 +113,9 @@
         "source": "api"
       },
       "contentRevision": 3,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "board",
       "title": "Related research",
       "content": null,
@@ -149,6 +160,9 @@
         "source": "api"
       },
       "contentRevision": 4,
+      "linksRevision": 92,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "status",
       "title": "Agent",
       "content": null,
@@ -189,6 +203,9 @@
         "source": "api"
       },
       "contentRevision": 5,
+      "linksRevision": 93,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "trace",
       "title": "canvas_query",
       "content": null,
@@ -229,6 +246,9 @@
         "source": "api"
       },
       "contentRevision": 6,
+      "linksRevision": 93,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "trace",
       "title": "edit_file",
       "content": null,
@@ -298,6 +318,9 @@
         "source": "api"
       },
       "contentRevision": 7,
+      "linksRevision": 94,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "context",
       "title": "Working context",
       "content": null,
@@ -338,6 +361,9 @@
         "source": "api"
       },
       "contentRevision": 8,
+      "linksRevision": 94,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "ledger",
       "title": "Decision ledger",
       "content": "09:12  Ship 0.4.7 behind the existing smoke gate\n09:26  Keep demo board offline-only — no live sessions\n10:03  strictSize on every demo node so layout is stable\n10:41  Drop the OKR board; catalogue every node type instead\n11:15  Charts band shows all 12 graph types, Tufte row last\n11:48  Pin the intro, the context card and the diff under review\n13:20  Bands get section labels; only one group frame survives",
@@ -363,7 +389,8 @@
       "data": {
         "title": "② Files & review",
         "content": "Inline file text, delimited data as a table, unified diffs, images, and cached webpage snapshots.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -374,6 +401,9 @@
         "source": "api"
       },
       "contentRevision": 9,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "② Files & review",
       "content": "Inline file text, delimited data as a table, unified diffs, images, and cached webpage snapshots.",
@@ -412,6 +442,9 @@
         "source": "api"
       },
       "contentRevision": 10,
+      "linksRevision": 95,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "file",
       "title": "node-sizes.ts",
       "content": "import { canvasState } from './canvas-state.js';\nimport { nodeMinSize } from '../shared/node-sizes.js';\n\n/** Clamp an agent-supplied frame up to the per-type readability floor. */\nexport function clampNodeFrame(type: string, width: number, height: number) {\n  const min = nodeMinSize(type);\n  if (!min) return { width, height };\n  return {\n    width: Math.max(width, min.width),\n    height: Math.max(height, min.height),\n  };\n}\n\nexport function nodeCountByType(): Record<string, number> {\n  const counts: Record<string, number> = {};\n  for (const node of canvasState.getLayout().nodes) {\n    counts[node.type] = (counts[node.type] ?? 0) + 1;\n  }\n  return counts;\n}",
@@ -448,6 +481,9 @@
         "source": "api"
       },
       "contentRevision": 11,
+      "linksRevision": 95,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "diff",
       "title": "Readability floor — 2 files",
       "content": "diff --git a/src/shared/node-sizes.ts b/src/shared/node-sizes.ts\n--- a/src/shared/node-sizes.ts\n+++ b/src/shared/node-sizes.ts\n@@ -20,6 +20,8 @@ export const NODE_MIN_SIZES: Record<string, { width: number; height: number }> =\n   markdown: { width: 360, height: 180 },\n   context: { width: 360, height: 180 },\n   file: { width: 360, height: 200 },\n+  diff: { width: 420, height: 240 },\n+  mermaid: { width: 360, height: 240 },\n   status: { width: 280, height: 120 },\n\ndiff --git a/src/client/canvas/auto-fit.ts b/src/client/canvas/auto-fit.ts\n--- a/src/client/canvas/auto-fit.ts\n+++ b/src/client/canvas/auto-fit.ts\n@@ -63,7 +63,8 @@ export function computeAutoFitHeight(node: CanvasNodeState, contentHeight: numbe\n   const fitted = Math.min(contentHeight + AUTO_FIT_TITLEBAR_HEIGHT, AUTO_FIT_MAX_HEIGHT);\n-  return fitted;\n+  const min = nodeMinSize(node.type);\n+  return min ? Math.max(fitted, min.height) : fitted;\n }",
@@ -499,6 +535,8 @@
         "source": "api"
       },
       "contentRevision": 12,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "kind": "file",
       "title": "weekly-throughput.csv",
       "content": "week,merged_prs,review_hours,p95_ci_minutes,flaky_reruns\n2026-W23,41,18.5,11.2,6\n2026-W24,38,21.0,12.8,9\n2026-W25,52,16.4,10.1,4\n2026-W26,47,15.2,9.6,3\n2026-W27,55,14.8,9.1,2\n2026-W28,61,13.9,8.4,2",
@@ -546,6 +584,9 @@
         "source": "api"
       },
       "contentRevision": 13,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "image",
       "title": "Canvas data flow",
       "content": "data:image/svg+xml;utf8,%3Csvg%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%20viewBox%3D'0%200%20480%20300'%20width%3D'480'%20height%3D'300'%3E%3Crect%20width%3D'480'%20height%3D'300'%20rx%3D'16'%20fill%3D'%230f1420'%2F%3E%3Ctext%20x%3D'24'%20y%3D'40'%20fill%3D'%23e6ecff'%20font-family%3D'ui-sans-serif%2Csystem-ui'%20font-size%3D'17'%20font-weight%3D'600'%3ECanvas%20data%20flow%3C%2Ftext%3E%3Crect%20x%3D'24'%20y%3D'70'%20width%3D'128'%20height%3D'62'%20rx%3D'10'%20fill%3D'%2316203a'%20stroke%3D'%234a9eff'%2F%3E%3Ctext%20x%3D'88'%20y%3D'106'%20fill%3D'%239ec5ff'%20font-family%3D'ui-sans-serif%2Csystem-ui'%20font-size%3D'13'%20text-anchor%3D'middle'%3EAgent%20(MCP)%3C%2Ftext%3E%3Crect%20x%3D'176'%20y%3D'70'%20width%3D'128'%20height%3D'62'%20rx%3D'10'%20fill%3D'%2316203a'%20stroke%3D'%237c5cff'%2F%3E%3Ctext%20x%3D'240'%20y%3D'100'%20fill%3D'%23c3b4ff'%20font-family%3D'ui-sans-serif%2Csystem-ui'%20font-size%3D'13'%20text-anchor%3D'middle'%3ECanvas%20state%3C%2Ftext%3E%3Ctext%20x%3D'240'%20y%3D'118'%20fill%3D'%237b86a8'%20font-family%3D'ui-sans-serif%2Csystem-ui'%20font-size%3D'11'%20text-anchor%3D'middle'%3Esingle%20source%20of%20truth%3C%2Ftext%3E%3Crect%20x%3D'328'%20y%3D'70'%20width%3D'128'%20height%3D'62'%20rx%3D'10'%20fill%3D'%2316203a'%20stroke%3D'%2322c55e'%2F%3E%3Ctext%20x%3D'392'%20y%3D'106'%20fill%3D'%238ee5ad'%20font-family%3D'ui-sans-serif%2Csystem-ui'%20font-size%3D'13'%20text-anchor%3D'middle'%3EBrowser%3C%2Ftext%3E%3Cpath%20d%3D'M152%20101%20L172%20101'%20stroke%3D'%234a9eff'%20stroke-width%3D'2'%2F%3E%3Cpath%20d%3D'M304%20101%20L324%20101'%20stroke%3D'%2322c55e'%20stroke-width%3D'2'%2F%3E%3Cpath%20d%3D'M392%20140%20L392%20196%20L88%20196%20L88%20140'%20fill%3D'none'%20stroke%3D'%23eab308'%20stroke-width%3D'2'%20stroke-dasharray%3D'5%205'%2F%3E%3Ctext%20x%3D'240'%20y%3D'188'%20fill%3D'%23eab308'%20font-family%3D'ui-sans-serif%2Csystem-ui'%20font-size%3D'12'%20text-anchor%3D'middle'%3Ehuman%20pins%20nodes%20-%26gt%3B%20canvas%3A%2F%2Fpinned-context%3C%2Ftext%3E%3Crect%20x%3D'24'%20y%3D'222'%20width%3D'432'%20height%3D'52'%20rx%3D'10'%20fill%3D'%23111827'%20stroke%3D'%23243049'%2F%3E%3Ctext%20x%3D'240'%20y%3D'253'%20fill%3D'%237b86a8'%20font-family%3D'ui-monospace%2Cmonospace'%20font-size%3D'12'%20text-anchor%3D'middle'%3Estate%20survives%20refresh%20%C2%B7%20SQLite%20at%20.pmx-canvas%2Fcanvas.db%3C%2Ftext%3E%3C%2Fsvg%3E",
@@ -606,6 +647,8 @@
         "source": "api"
       },
       "contentRevision": 16,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "kind": "webpage",
       "title": "Model Context Protocol — Resources",
       "content": "https://modelcontextprotocol.io/docs/concepts/resources",
@@ -642,7 +685,8 @@
       "data": {
         "title": "③ Diagrams & surfaces",
         "content": "Mermaid renders from plain text; HTML and MCP App nodes are sandboxed iframes the agent authors.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -653,6 +697,9 @@
         "source": "api"
       },
       "contentRevision": 17,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "③ Diagrams & surfaces",
       "content": "Mermaid renders from plain text; HTML and MCP App nodes are sandboxed iframes the agent authors.",
@@ -689,6 +736,9 @@
         "source": "api"
       },
       "contentRevision": 18,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "mermaid",
       "title": "Flowchart — request path",
       "content": "flowchart LR\n  A[Agent] -->|MCP tool call| B(Canvas server)\n  B --> C{{SSE stream}}\n  C --> D[Browser canvas]\n  D -->|human pins a node| B\n  B --> E[(canvas.db)]",
@@ -725,6 +775,9 @@
         "source": "api"
       },
       "contentRevision": 19,
+      "linksRevision": 96,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "mermaid",
       "title": "Sequence — the pin loop",
       "content": "sequenceDiagram\n  participant H as Human\n  participant C as Canvas\n  participant A as Agent\n  H->>C: pin 3 nodes\n  C-->>A: resources/updated\n  A->>C: read canvas://pinned-context\n  A->>C: canvas_node add (summary)\n  C-->>H: SSE layout update",
@@ -761,6 +814,9 @@
         "source": "api"
       },
       "contentRevision": 20,
+      "linksRevision": 96,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "mermaid",
       "title": "State — approval gate",
       "content": "stateDiagram-v2\n  [*] --> pending\n  pending --> approved: human approves\n  pending --> rejected: human rejects\n  pending --> expired: timeout\n  approved --> [*]\n  rejected --> [*]\n  expired --> [*]",
@@ -800,6 +856,9 @@
         "source": "api"
       },
       "contentRevision": 21,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Release gates",
       "content": "Five release gates with pass/running/warning status for 0.4.7.\nRelease gates — 0.4.7 Raw HTML in a sandboxed iframe. No scripts, no network, no build step. typecheck passing unit tests 612 passed web-canvas e2e running bundle size +4.1% vs 0.4.6 pack dry-run clean",
@@ -850,6 +909,8 @@
         "source": "api"
       },
       "contentRevision": 22,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "kind": "external-app",
       "title": "Board inspector",
       "content": null,
@@ -885,7 +946,8 @@
       "data": {
         "title": "④ Charts",
         "content": "Every canonical graph type, then the Tufte primitives in the compact bottom row.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -896,6 +958,9 @@
         "source": "api"
       },
       "contentRevision": 23,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "④ Charts",
       "content": "Every canonical graph type, then the Tufte primitives in the compact bottom row.",
@@ -1024,6 +1089,9 @@
         "source": "api"
       },
       "contentRevision": 24,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "line — p95 latency",
       "content": null,
@@ -1156,6 +1224,9 @@
         "source": "api"
       },
       "contentRevision": 25,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "bar — merged PRs per week",
       "content": null,
@@ -1276,6 +1347,9 @@
         "source": "api"
       },
       "contentRevision": 26,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "area — canvas nodes created",
       "content": null,
@@ -1390,6 +1464,9 @@
         "source": "api"
       },
       "contentRevision": 27,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "pie — node types on real boards",
       "content": null,
@@ -1527,6 +1604,9 @@
         "source": "api"
       },
       "contentRevision": 28,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "stacked-bar — CI minutes by stage",
       "content": null,
@@ -1650,6 +1730,9 @@
         "source": "api"
       },
       "contentRevision": 29,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "composed — throughput vs review load",
       "content": null,
@@ -1792,6 +1875,9 @@
         "source": "api"
       },
       "contentRevision": 30,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "scatter — PR size vs review time",
       "content": null,
@@ -1929,6 +2015,9 @@
         "source": "api"
       },
       "contentRevision": 31,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "radar — surface coverage",
       "content": null,
@@ -2079,6 +2168,9 @@
         "source": "api"
       },
       "contentRevision": 32,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "sparkline — build time",
       "content": null,
@@ -2193,6 +2285,9 @@
         "source": "api"
       },
       "contentRevision": 33,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "dot-plot — test time by suite",
       "content": null,
@@ -2337,6 +2432,9 @@
         "source": "api"
       },
       "contentRevision": 34,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "bullet — release KPIs vs target",
       "content": null,
@@ -2465,6 +2563,9 @@
         "source": "api"
       },
       "contentRevision": 35,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "graph",
       "title": "slopegraph — coverage 0.4.6 → 0.4.7",
       "content": null,
@@ -2490,7 +2591,8 @@
       "data": {
         "title": "⑤ Structured UI",
         "content": "json-render nodes: an agent posts a validated component spec and the canvas renders real UI.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -2501,6 +2603,9 @@
         "source": "api"
       },
       "contentRevision": 36,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "⑤ Structured UI",
       "content": "json-render nodes: an agent posts a validated component spec and the canvas renders real UI.",
@@ -2709,6 +2814,9 @@
         "source": "api"
       },
       "contentRevision": 37,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "json-render",
       "title": "Release dashboard",
       "content": null,
@@ -2735,6 +2843,11 @@
         "title": "Blocker intake form",
         "spec": {
           "root": "form",
+          "state": {
+            "form": {
+              "severity": "major"
+            }
+          },
           "elements": {
             "form": {
               "type": "Card",
@@ -2805,7 +2918,9 @@
                   "major",
                   "minor"
                 ],
-                "value": "major"
+                "value": {
+                  "$bindState": "/form/severity"
+                }
               },
               "children": [],
               "visible": true,
@@ -2894,6 +3009,9 @@
         "source": "api"
       },
       "contentRevision": 38,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "json-render",
       "title": "Blocker intake form",
       "content": null,
@@ -3062,6 +3180,9 @@
         "source": "api"
       },
       "contentRevision": 39,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "json-render",
       "title": "Usage panel",
       "content": null,
@@ -3087,7 +3208,8 @@
       "data": {
         "title": "⑥ Grouping",
         "content": "A group says \"these belong together\". One frame is enough — bands carry a board’s structure.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -3098,6 +3220,9 @@
         "source": "api"
       },
       "contentRevision": 40,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "⑥ Grouping",
       "content": "A group says \"these belong together\". One frame is enough — bands carry a board’s structure.",
@@ -3124,6 +3249,7 @@
         "title": "Sprint 41 — canvas polish",
         "content": "Three nodes, one frame. Moving the frame moves the children; ungrouping leaves them exactly where they are.\n\n- Group children keep their own positions by default\n- `childLayout` opts into auto-packing\n- The frame is stored as `data.children` on the group",
         "strictSize": true,
+        "wikiLinks": [],
         "parentGroup": "group"
       },
       "createdBy": {
@@ -3135,6 +3261,9 @@
         "source": "api"
       },
       "contentRevision": 46,
+      "linksRevision": 97,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "Sprint 41 — canvas polish",
       "content": "Three nodes, one frame. Moving the frame moves the children; ungrouping leaves them exactly where they are.\n\n- Group children keep their own positions by default\n- `childLayout` opts into auto-packing\n- The frame is stored as `data.children` on the group",
@@ -3175,6 +3304,9 @@
         "source": "api"
       },
       "contentRevision": 47,
+      "linksRevision": 97,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "status",
       "title": "Sprint state",
       "content": null,
@@ -3216,6 +3348,9 @@
         "source": "api"
       },
       "contentRevision": 48,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "trace",
       "title": "canvas_group",
       "content": null,
@@ -3257,6 +3392,9 @@
         "source": "api"
       },
       "contentRevision": 45,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "group",
       "title": "Sprint 41",
       "content": null,
@@ -3282,7 +3420,8 @@
       "data": {
         "title": "⑦ HTML primitives",
         "content": "All 21 generated communication surfaces — self-contained sandboxed documents, no build step.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -3293,6 +3432,9 @@
         "source": "api"
       },
       "contentRevision": 49,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "⑦ HTML primitives",
       "content": "All 21 generated communication surfaces — self-contained sandboxed documents, no build step.",
@@ -3378,6 +3520,9 @@
         "source": "api"
       },
       "contentRevision": 50,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "How should the demo board be generated?",
       "content": "Side-by-side options with tradeoffs, pros, cons, and code or evidence snippets.",
@@ -3488,6 +3633,9 @@
         "source": "api"
       },
       "contentRevision": 51,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Demo board rebuild",
       "content": "Implementation plan with milestones, data flow, code checkpoints, and risks.",
@@ -3567,6 +3715,9 @@
         "source": "api"
       },
       "contentRevision": 52,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Review — auto-fit floor",
       "content": "Annotated PR/code review sheet with severity-colored findings and diff excerpts.",
@@ -3655,6 +3806,9 @@
         "source": "api"
       },
       "contentRevision": 53,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "PR — replace the demo board",
       "content": "Reviewer-ready PR narrative with motivation, before/after, file tour, test plan, and rollout notes.",
@@ -3767,6 +3921,9 @@
         "source": "api"
       },
       "contentRevision": 54,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Canvas server map",
       "content": "Module or architecture map with boxes, relationships, entry points, and hot paths.",
@@ -3896,6 +4053,9 @@
         "source": "api"
       },
       "contentRevision": 55,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Walkthrough — creating a node",
       "content": "Guided code-path map with modules, ordered file steps, snippets, key files, and gotchas.",
@@ -3999,6 +4159,9 @@
         "source": "api"
       },
       "contentRevision": 56,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Board typography directions",
       "content": "Visual design directions, tokens, swatches, type samples, and rationale.",
@@ -4082,6 +4245,9 @@
         "source": "api"
       },
       "contentRevision": 57,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Node titlebar states",
       "content": "Contact sheet for component variants, states, sizes, and accessibility notes.",
@@ -4180,6 +4346,9 @@
         "source": "api"
       },
       "contentRevision": 58,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Node expand transition",
       "content": "Throwaway interaction or motion sandbox with a live stage, controls, annotations, and copyable config.",
@@ -4266,6 +4435,9 @@
         "source": "api"
       },
       "contentRevision": 59,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Release pipeline",
       "content": "Clickable flowchart for pipelines, user journeys, process diagrams, and failure paths.",
@@ -4361,6 +4533,9 @@
         "source": "api"
       },
       "contentRevision": 60,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Why a spatial canvas",
       "content": "Arrow-key HTML deck with sections, speaker notes, and copyable JSON payload. Slides: Chat is a queue, work is a graph, The canvas is the agent’s working memory, Pinning is the steering wheel.",
@@ -4479,6 +4654,9 @@
         "source": "api"
       },
       "contentRevision": 61,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "PMX Canvas 0.4.7 briefing",
       "content": "PowerPoint-style fullscreen-ready HTML presentation with slide navigation, progress, speaker notes, and presentation metadata. Slides: Where we are, What changed in 0.4.7, Next.",
@@ -4644,6 +4822,9 @@
         "source": "api"
       },
       "contentRevision": 62,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Figures — the collaboration loop",
       "content": "Inline SVG figure sheet with captions and per-figure SVG copy/export controls.",
@@ -4750,6 +4931,9 @@
         "source": "api"
       },
       "contentRevision": 63,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "How context pins work",
       "content": "Readable explainer with TLDR, collapsible steps, annotated snippets, FAQ, and glossary.",
@@ -4871,6 +5055,9 @@
         "source": "api"
       },
       "contentRevision": 64,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Blank ext-app tiles on WebKit",
       "content": "Post-incident report with impact metrics, minute-by-minute timeline, root cause, log excerpts, and action checklist.",
@@ -4957,6 +5144,9 @@
         "source": "api"
       },
       "contentRevision": 65,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Weekly canvas status",
       "content": "Skimmable report with metrics, shipped/slipped lists, blockers, and next actions.",
@@ -5043,6 +5233,9 @@
         "source": "api"
       },
       "contentRevision": 66,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Post-0.4.7 triage",
       "content": "Draggable Now/Next/Later/Cut board with copy-as-markdown export.",
@@ -5135,6 +5328,9 @@
         "source": "api"
       },
       "contentRevision": 67,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Canvas feature flags",
       "content": "Form-like editor for flags or structured config with dependency warnings and copy-diff export.",
@@ -5204,6 +5400,9 @@
         "source": "api"
       },
       "contentRevision": 68,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Board summary prompt",
       "content": "Side-by-side prompt/template editor with live variable previews and copy export.",
@@ -5257,6 +5456,9 @@
         "source": "api"
       },
       "contentRevision": 69,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Agent board",
       "content": "Live agent work board: hand the agent tasks, watch status, steer, and run bounded task loops.",
@@ -5337,7 +5539,10 @@
         "actor": "agent",
         "source": "api"
       },
-      "contentRevision": 85,
+      "contentRevision": 88,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "html",
       "title": "Release flow",
       "content": "HTML primitive: ax-flow\nLive task-flow control panel: a step diagram with an explicit loop-back, per-step status, and a one-click materialize onto the board.\nRelease flow PMX HTML primitive / ax-flow Release flow Live task-flow control panel: a step diagram with an explicit loop-back, per-step status, and a one-click materialize onto the board. Copy JSON Copy prompt AX bridge unavailable This flow is not running as an AX-enabled canvas node, so its controls are inert. Release flow Each step is a canvas AX work item. Materialize drops the same flow onto the board as real nodes. loops back to step 1 · max 3 runs Run the flow Queue every step A step is queued once — after that its status control advances it (todo → in-progress → done). or run the whole flow as a bounded loop: max runs Start loop Steer Queue steering message Queued for the agent's next turn — steering is recorded on the timeline, it does not wake a running agent. Loop run 0 of 0 Each run is its own work item. When you mark the current run done , the surface opens the next run...",
@@ -5363,7 +5568,8 @@
       "data": {
         "title": "⑧ Agent at work",
         "content": "A task caught mid-flight: one work item per step, status chips on the nodes, controls that steer the agent.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -5374,6 +5580,9 @@
         "source": "api"
       },
       "contentRevision": 71,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "⑧ Agent at work",
       "content": "A task caught mid-flight: one work item per step, status chips on the nodes, controls that steer the agent.",
@@ -5402,6 +5611,7 @@
         "axFlowId": "axflow-primitive-ax-flow",
         "axFlowStep": 1,
         "axFlowSourceNodeId": "primitive-ax-flow",
+        "wikiLinks": [],
         "axWorkStatus": "done",
         "axStep": {
           "flowId": "axflow-primitive-ax-flow",
@@ -5454,7 +5664,10 @@
         "actor": "agent",
         "source": "api"
       },
-      "contentRevision": 86,
+      "contentRevision": 89,
+      "linksRevision": 84,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "1. Reproduce",
       "content": "Ran the publish gate 20× in a loop. Fails 3 in 20, always on the registry probe.",
@@ -5483,6 +5696,7 @@
         "axFlowId": "axflow-primitive-ax-flow",
         "axFlowStep": 2,
         "axFlowSourceNodeId": "primitive-ax-flow",
+        "wikiLinks": [],
         "axWorkStatus": "in-progress",
         "axStep": {
           "flowId": "axflow-primitive-ax-flow",
@@ -5500,7 +5714,10 @@
         "actor": "agent",
         "source": "api"
       },
-      "contentRevision": 87,
+      "contentRevision": 90,
+      "linksRevision": 85,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "2. Fix",
       "content": "Retry the probe with backoff instead of failing the gate on the first timeout.",
@@ -5529,6 +5746,7 @@
         "axFlowId": "axflow-primitive-ax-flow",
         "axFlowStep": 3,
         "axFlowSourceNodeId": "primitive-ax-flow",
+        "wikiLinks": [],
         "axWorkStatus": "todo",
         "axStep": {
           "flowId": "axflow-primitive-ax-flow",
@@ -5547,6 +5765,9 @@
         "source": "api"
       },
       "contentRevision": 80,
+      "linksRevision": 86,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "3. Verify",
       "content": "Re-run the same 20× loop and require 20 green.",
@@ -5575,6 +5796,7 @@
         "axFlowId": "axflow-primitive-ax-flow",
         "axFlowStep": 4,
         "axFlowSourceNodeId": "primitive-ax-flow",
+        "wikiLinks": [],
         "axWorkStatus": "todo",
         "axStep": {
           "flowId": "axflow-primitive-ax-flow",
@@ -5593,6 +5815,9 @@
         "source": "api"
       },
       "contentRevision": 83,
+      "linksRevision": 86,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "4. Ship",
       "content": "Land the patch, then watch the next three releases.",
@@ -5618,7 +5843,8 @@
       "data": {
         "title": "How to read this band",
         "content": "Each step is a real **AX work item**, so the chip on a step node is the\nagent’s live status — it moves as the agent works.\n\nThe buttons in each step footer steer it: **Start**, **Done** and\n**Blocked** write that step’s work item, which the agent reads back from\n`canvas://ax-work`.\n\nStep 2 is pinned, so `canvas://pinned-context` hands the agent the\nstep it is actually on.",
-        "strictSize": true
+        "strictSize": true,
+        "wikiLinks": []
       },
       "createdBy": {
         "actor": "agent",
@@ -5628,7 +5854,10 @@
         "actor": "agent",
         "source": "api"
       },
-      "contentRevision": 88,
+      "contentRevision": 91,
+      "linksRevision": 0,
+      "contentChangedAt": "2026-08-01T09:00:00.000Z",
+      "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
       "title": "How to read this band",
       "content": "Each step is a real **AX work item**, so the chip on a step node is the\nagent’s live status — it moves as the agent works.\n\nThe buttons in each step footer steer it: **Start**, **Done** and\n**Blocked** write that step’s work item, which the agent reads back from\n`canvas://ax-work`.\n\nStep 2 is pinned, so `canvas://pinned-context` hands the agent the\nstep it is actually on.",
@@ -5644,21 +5873,54 @@
       "from": "axflow-primitive-ax-flow-step-1",
       "to": "axflow-primitive-ax-flow-step-2",
       "type": "flow",
-      "style": "solid"
+      "style": "solid",
+      "revision": 84,
+      "changedBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "changedAt": "2026-08-01T09:00:00.000Z",
+      "createdBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "createdAt": "2026-08-01T09:00:00.000Z"
     },
     {
       "id": "axflow-primitive-ax-flow-edge-2",
       "from": "axflow-primitive-ax-flow-step-2",
       "to": "axflow-primitive-ax-flow-step-3",
       "type": "flow",
-      "style": "solid"
+      "style": "solid",
+      "revision": 85,
+      "changedBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "changedAt": "2026-08-01T09:00:00.000Z",
+      "createdBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "createdAt": "2026-08-01T09:00:00.000Z"
     },
     {
       "id": "axflow-primitive-ax-flow-edge-3",
       "from": "axflow-primitive-ax-flow-step-3",
       "to": "axflow-primitive-ax-flow-step-4",
       "type": "flow",
-      "style": "solid"
+      "style": "solid",
+      "revision": 86,
+      "changedBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "changedAt": "2026-08-01T09:00:00.000Z",
+      "createdBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "createdAt": "2026-08-01T09:00:00.000Z"
     },
     {
       "id": "edge-runs",
@@ -5666,7 +5928,18 @@
       "to": "trace-plan",
       "type": "flow",
       "label": "runs",
-      "animated": true
+      "animated": true,
+      "revision": 92,
+      "changedBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "changedAt": "2026-08-01T09:00:00.000Z",
+      "createdBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "createdAt": "2026-08-01T09:00:00.000Z"
     },
     {
       "id": "edge-then",
@@ -5674,21 +5947,57 @@
       "to": "trace-apply",
       "type": "flow",
       "label": "then",
-      "style": "dotted"
+      "style": "dotted",
+      "revision": 93,
+      "changedBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "changedAt": "2026-08-01T09:00:00.000Z",
+      "createdBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "createdAt": "2026-08-01T09:00:00.000Z"
     },
     {
       "id": "edge-decisions",
       "from": "context",
       "to": "ledger",
       "type": "relation",
-      "label": "decisions"
+      "kind": "supports",
+      "reason": "The working context explains the recorded decisions.",
+      "label": "decisions",
+      "revision": 94,
+      "changedBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "changedAt": "2026-08-01T09:00:00.000Z",
+      "createdBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "createdAt": "2026-08-01T09:00:00.000Z"
     },
     {
       "id": "edge-changed-in",
       "from": "file-ts",
       "to": "diff",
       "type": "depends-on",
-      "label": "changed in"
+      "label": "changed in",
+      "sourceRevision": 11,
+      "revision": 95,
+      "changedBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "changedAt": "2026-08-01T09:00:00.000Z",
+      "createdBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "createdAt": "2026-08-01T09:00:00.000Z"
     },
     {
       "id": "edge-gate",
@@ -5696,14 +6005,36 @@
       "to": "mermaid-state",
       "type": "references",
       "label": "approval gate",
-      "style": "dashed"
+      "style": "dashed",
+      "revision": 96,
+      "changedBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "changedAt": "2026-08-01T09:00:00.000Z",
+      "createdBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "createdAt": "2026-08-01T09:00:00.000Z"
     },
     {
       "id": "edge-sprint",
       "from": "group-note",
       "to": "group-status",
       "type": "relation",
-      "style": "dashed"
+      "style": "dashed",
+      "revision": 97,
+      "changedBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "changedAt": "2026-08-01T09:00:00.000Z",
+      "createdBy": {
+        "actor": "agent",
+        "source": "api"
+      },
+      "createdAt": "2026-08-01T09:00:00.000Z"
     }
   ],
   "annotations": [