pmx-canvas 0.11.0 → 0.12.1

package/src/server/card-relocation.ts

@@ -0,0 +1,53 @@
+import type { Database } from 'bun:sqlite';
+
+/** JSON target list parameter; event ranges prevent a reused old ID inheriting the moved card's history. */
+export const CARD_HISTORY_CTE = `WITH RECURSIVE
+  targets AS (SELECT json_extract(value, '$.boardId') AS current_board,
+                     json_extract(value, '$.cardId') AS node_id FROM json_each(?)),
+  history(current_board, node_id, board_id, review_after, review_through, read_after, read_through, move_before) AS (
+    SELECT current_board, node_id, current_board,
+      COALESCE((SELECT MAX(review_through) FROM card_relocations r WHERE (r.from_board = t.current_board OR r.to_board = t.current_board) AND r.node_id = t.node_id), 0),
+      9223372036854775807,
+      COALESCE((SELECT MAX(read_through) FROM card_relocations r WHERE (r.from_board = t.current_board OR r.to_board = t.current_board) AND r.node_id = t.node_id), 0),
+      9223372036854775807, 9223372036854775807 FROM targets t
+    UNION ALL
+    SELECT h.current_board, h.node_id, r.from_board, r.review_after, r.review_through,
+      r.read_after, r.read_through, r.sequence
+    FROM history h JOIN card_relocations r ON r.to_board = h.board_id AND r.node_id = h.node_id
+    AND r.sequence = (SELECT MAX(sequence) FROM card_relocations prior
+      WHERE (prior.to_board = h.board_id OR prior.from_board = h.board_id)
+      AND prior.node_id = h.node_id AND prior.sequence < h.move_before)
+  )`;
+
+/** Record locations, not new reads or validations. Called inside the move transaction. */
+export function recordCardRelocation(
+  db: Database,
+  requestId: string,
+  from: string,
+  to: string,
+  nodeIds: string[],
+): void {
+  const reviewThrough = db
+    .query<{ value: number }, []>('SELECT COALESCE(MAX(sequence), 0) AS value FROM review_records')
+    .get()!.value;
+  const readThrough = db
+    .query<{ value: number }, []>('SELECT COALESCE(MAX(seq), 0) AS value FROM context_reads')
+    .get()!.value;
+  for (const id of nodeIds)
+    db.run(
+      `
+    INSERT INTO card_relocations(request_id, node_id, from_board, to_board, review_after, review_through, read_after, read_through)
+    VALUES (?, ?, ?, ?,
+      COALESCE((SELECT MAX(review_through) FROM card_relocations WHERE (from_board = ? OR to_board = ?) AND node_id = ?), 0), ?,
+      COALESCE((SELECT MAX(read_through) FROM card_relocations WHERE (from_board = ? OR to_board = ?) AND node_id = ?), 0), ?)`,
+      [requestId, id, from, to, from, from, id, reviewThrough, from, from, id, readThrough],
+    );
+}
+
+export function boardMoveBoundary(db: Database, boardId: string): string | null {
+  return (
+    db
+      .query<{ request_id: string }, [string]>('SELECT request_id FROM board_move_boundaries WHERE board_id = ?')
+      .get(boardId)?.request_id ?? null
+  );
+}

package/src/server/code-graph.ts

@@ -18,6 +18,7 @@ import { resolve, dirname, basename, extname, relative } from 'node:path';
 import { existsSync } from 'node:fs';
 import { canvasState } from './canvas-state.js';
 import type { CanvasNodeState, CanvasEdge } from './canvas-state.js';
+import { createBoardLocal } from './board-local.js';
 
 // ── Types ────────────────────────────────────────────────────────────
 
@@ -176,7 +177,7 @@ function tryResolveWithExtensions(basePath: string): string | null {
 const AUTO_EDGE_PREFIX = 'codegraph-';
 
 /** Cache of last recomputed edges for buildCodeGraphSummary() to reuse. */
-let _lastDiscoveredEdges: CodeGraphEdge[] = [];
+const discovered = createBoardLocal(() => ({ edges: [] as CodeGraphEdge[] }));
 
 /**
  * Get all file nodes currently on the canvas.
@@ -263,7 +264,7 @@ export function recomputeCodeGraph(): CodeGraphEdge[] {
     }
   });
 
-  _lastDiscoveredEdges = discoveredEdges;
+  discovered.current.edges = discoveredEdges;
   return discoveredEdges;
 }
 
@@ -295,7 +296,7 @@ export function buildCodeGraphSummary(): CodeGraphSummary {
   for (const node of fileNodes) idToPath.set(node.id, node.data.path as string);
 
   // Group import specifiers by source node from cached edges
-  for (const edge of _lastDiscoveredEdges) {
+  for (const edge of discovered.current.edges) {
     const specs = importSpecs.get(edge.fromNodeId);
     if (specs && !specs.includes(edge.importSpecifier)) {
       specs.push(edge.importSpecifier);

package/src/server/context-reads.ts

@@ -6,9 +6,11 @@
  * recording never notifies (a read must not trigger more reads).
  */
 import type { Database } from 'bun:sqlite';
-import { randomUUID } from 'node:crypto';
+import { createHash, randomUUID } from 'node:crypto';
+import { CARD_HISTORY_CTE } from './card-relocation.js';
 import type { MemoryGraph } from '../shared/memory-graph.js';
 import type { CompiledContextEntry } from './context-brief.js';
+import { OperationError } from './operations/types.js';
 
 export const CONTEXT_READ_RETENTION = 5000;
 const CONTEXT_READ_DEFAULT_LIMIT = 50;
@@ -51,6 +53,8 @@ export interface ContextRead {
 }
 
 export type ContextReadInput = Omit<ContextRead, 'seq' | 'id' | 'at' | 'boardId' | 'readNodes' | 'seenLinks'> & {
+  /** Stable adapter receipt identity. Retries record this delivery once per consumer and board. */
+  deliveryId?: string;
   /** Explicit read target, captured before asynchronous formatting/proxy work. */
   boardId?: string | null;
   /** Ids of every serialized node in what the reader received; the server keeps those on the board. */
@@ -264,6 +268,7 @@ export function graphReads(
 }
 
 export const CONTEXT_READS_SCHEMA_SQL = `
+  CREATE TABLE IF NOT EXISTS context_read_receipts (id TEXT PRIMARY KEY);
   CREATE TABLE IF NOT EXISTS context_reads (
     seq INTEGER PRIMARY KEY AUTOINCREMENT,
     id TEXT NOT NULL UNIQUE,
@@ -289,30 +294,47 @@ export function appendContextReadToDB(
   readNodes: Record<string, number> = {},
   seenLinks: Record<string, number> = {},
 ): ContextRead {
-  const id = `read-${randomUUID()}`;
-  const at = new Date().toISOString();
-  db.run(
-    'INSERT INTO context_reads (id, at, channel, resource, source, consumer, agent_id, pinned_node_ids, delivered_node_ids, bytes, board_id, read_nodes, seen_links) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
-    [
-      id,
-      at,
-      input.channel,
-      input.resource,
-      input.source,
-      input.consumer,
-      input.agentId,
-      JSON.stringify(input.pinnedNodeIds),
-      JSON.stringify(input.deliveredNodeIds),
-      input.bytes,
-      boardId,
-      JSON.stringify(readNodes),
-      JSON.stringify(seenLinks),
-    ],
-  );
-  const seq = Number(db.query<{ seq: number }, []>('SELECT last_insert_rowid() AS seq').get()?.seq ?? 0);
-  db.run('DELETE FROM context_reads WHERE seq <= ?', [seq - CONTEXT_READ_RETENTION]);
-  const { readNodeIds: _readNodeIds, seenNodeIds: _seenNodeIds, ...record } = input;
-  return { ...record, seq, id, at, boardId, readNodes, seenLinks };
+  return db.transaction(() => {
+    const id = input.deliveryId
+      ? `read-${createHash('sha256')
+          .update(JSON.stringify([input.source, input.consumer, boardId, input.deliveryId]))
+          .digest('hex')}`
+      : `read-${randomUUID()}`;
+    if (input.deliveryId) {
+      const existing = db.query<ContextReadRow, [string]>('SELECT * FROM context_reads WHERE id = ?').get(id);
+      if (existing) {
+        db.run('INSERT OR IGNORE INTO context_read_receipts VALUES (?)', [id]);
+        return rowToContextRead(existing);
+      }
+      if (db.query('SELECT id FROM context_read_receipts WHERE id = ?').get(id))
+        throw new OperationError('Context receipt expired. Obtain fresh context instead of retrying this token.', 409, {
+          code: 'context_receipt_expired',
+        });
+    }
+    const at = new Date().toISOString();
+    db.run(
+      'INSERT INTO context_reads (id, at, channel, resource, source, consumer, agent_id, pinned_node_ids, delivered_node_ids, bytes, board_id, read_nodes, seen_links) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) ON CONFLICT(id) DO NOTHING',
+      [
+        id,
+        at,
+        input.channel,
+        input.resource,
+        input.source,
+        input.consumer,
+        input.agentId,
+        JSON.stringify(input.pinnedNodeIds),
+        JSON.stringify(input.deliveredNodeIds),
+        input.bytes,
+        boardId,
+        JSON.stringify(readNodes),
+        JSON.stringify(seenLinks),
+      ],
+    );
+    const row = db.query<ContextReadRow, [string]>('SELECT * FROM context_reads WHERE id = ?').get(id)!;
+    if (input.deliveryId) db.run('INSERT INTO context_read_receipts VALUES (?)', [id]);
+    db.run('DELETE FROM context_reads WHERE seq <= ?', [row.seq - CONTEXT_READ_RETENTION]);
+    return rowToContextRead(row);
+  })();
 }
 
 interface ContextReadRow {
@@ -351,27 +373,43 @@ function rowToContextRead(row: ContextReadRow): ContextRead {
   };
 }
 
+/** Read only the matching card's observation, not a copy of the whole receipt for every card. */
+function loadCardReads(db: Database, boardId: string, field: 'read_nodes' | 'seen_links') {
+  const ids = db
+    .query<{ id: string }, [string, string, string]>(`
+    SELECT id FROM nodes WHERE board_id = ?
+    UNION SELECT j.key AS id FROM context_reads r, json_each(r.read_nodes) j WHERE r.board_id = ?
+    UNION SELECT j.key AS id FROM context_reads r, json_each(r.seen_links) j WHERE r.board_id = ?
+  `)
+    .all(boardId, boardId, boardId);
+  return db
+    .query<{ nodeId: string; revision: number; at: string; who: string }, [string]>(`
+    ${CARD_HISTORY_CTE} SELECT h.node_id AS nodeId, j.value AS revision, r.at,
+      COALESCE(r.consumer, r.agent_id, r.source) AS who FROM history h JOIN context_reads r
+      ON r.board_id = h.board_id AND r.seq > h.read_after AND r.seq <= h.read_through
+      JOIN json_each(r.${field}) j ON j.key = h.node_id
+    ORDER BY r.seq DESC
+  `)
+    .all(JSON.stringify(ids.map(({ id }) => ({ boardId, cardId: id }))));
+}
+
 /** Per node on a board, the latest agent read that delivered its content (newest row wins). */
 export function loadNodeReadStatusFromDB(db: Database, boardId: string): NodeReadStatus[] {
-  const rows = db
-    .query<ContextReadRow, [string]>('SELECT * FROM context_reads WHERE board_id = ? ORDER BY seq DESC')
-    .all(boardId);
   const status = new Map<string, NodeReadStatus>();
-  for (const read of rows.map(rowToContextRead)) {
-    for (const [nodeId, readRevision] of Object.entries(read.readNodes)) {
-      const known = status.get(nodeId);
-      if (known) {
-        known.readCount += 1;
-        continue;
-      }
-      status.set(nodeId, {
-        nodeId,
-        lastReadAt: read.at,
-        lastReadBy: read.consumer ?? read.agentId ?? read.source,
-        readRevision,
-        readCount: 1,
-      });
+  for (const read of loadCardReads(db, boardId, 'read_nodes')) {
+    const nodeId = read.nodeId;
+    const known = status.get(nodeId);
+    if (known) {
+      known.readCount += 1;
+      continue;
     }
+    status.set(nodeId, {
+      nodeId,
+      lastReadAt: read.at,
+      lastReadBy: read.who,
+      readRevision: read.revision,
+      readCount: 1,
+    });
   }
   return [...status.values()];
 }
@@ -391,27 +429,17 @@ export function loadBoardLastReadFromDB(
 
 /** Per node on a board, the newest links revision any agent read has carried (connection marks). */
 export function loadSeenLinksFromDB(db: Database, boardId: string): Record<string, number> {
-  const rows = db
-    .query<{ seen_links: string }, [string]>('SELECT seen_links FROM context_reads WHERE board_id = ?')
-    .all(boardId);
   const seen: Record<string, number> = {};
-  for (const row of rows) {
-    for (const [nodeId, revision] of Object.entries(JSON.parse(row.seen_links) as Record<string, number>)) {
-      if (revision > (seen[nodeId] ?? -1)) seen[nodeId] = revision;
-    }
+  for (const { nodeId, revision } of loadCardReads(db, boardId, 'seen_links')) {
+    if (revision > (seen[nodeId] ?? -1)) seen[nodeId] = revision;
   }
   return seen;
 }
 
 /** Every node on a board whose content an agent read at or after `since` (ISO). */
 export function loadReadNodeIdsSince(db: Database, boardId: string, since: string): string[] {
-  const rows = db
-    .query<{ read_nodes: string }, [string, string]>(
-      'SELECT read_nodes FROM context_reads WHERE board_id = ? AND at >= ? ORDER BY seq',
-    )
-    .all(boardId, since);
   const ids = new Set<string>();
-  for (const row of rows) for (const id of Object.keys(JSON.parse(row.read_nodes) as object)) ids.add(id);
+  for (const row of loadCardReads(db, boardId, 'read_nodes')) if (row.at >= since) ids.add(row.nodeId);
   return [...ids];
 }
 

package/src/server/demo-state.json

@@ -204,7 +204,7 @@
         "source": "api"
       },
       "contentRevision": 5,
-      "linksRevision": 93,
+      "linksRevision": 94,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "trace",
@@ -247,7 +247,7 @@
         "source": "api"
       },
       "contentRevision": 6,
-      "linksRevision": 93,
+      "linksRevision": 94,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "trace",
@@ -319,7 +319,7 @@
         "source": "api"
       },
       "contentRevision": 7,
-      "linksRevision": 94,
+      "linksRevision": 95,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "context",
@@ -362,7 +362,7 @@
         "source": "api"
       },
       "contentRevision": 8,
-      "linksRevision": 94,
+      "linksRevision": 95,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "ledger",
@@ -444,7 +444,7 @@
         "source": "api"
       },
       "contentRevision": 10,
-      "linksRevision": 95,
+      "linksRevision": 96,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "file",
@@ -483,7 +483,7 @@
         "source": "api"
       },
       "contentRevision": 11,
-      "linksRevision": 95,
+      "linksRevision": 96,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "diff",
@@ -778,7 +778,7 @@
         "source": "api"
       },
       "contentRevision": 19,
-      "linksRevision": 96,
+      "linksRevision": 97,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "mermaid",
@@ -817,7 +817,7 @@
         "source": "api"
       },
       "contentRevision": 20,
-      "linksRevision": 96,
+      "linksRevision": 97,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "mermaid",
@@ -886,7 +886,7 @@
       "pinned": false,
       "data": {
         "mode": "ext-app",
-        "html": "<!doctype html>\n<html lang=\"en\"><head><meta charset=\"utf-8\"><style>\n  body { margin:0; font:14px/1.5 var(--font-ui); background:var(--c-panel); color:var(--c-text); }\n  main { padding:16px; display:grid; gap:12px; }\n  .row { display:grid; grid-template-columns:1fr auto; align-items:center; gap:12px; padding:11px 13px; border:1px solid var(--c-line); border-radius:6px; background:var(--c-panel-soft); }\n  .row b { font-weight:600; font-size:13px; } .row small { display:block; color:var(--c-muted); font-size:12px; }\n  .pill { font:11px var(--font-mono); padding:3px 9px; border-radius:99px; background:var(--c-panel); color:var(--c-text-soft); border:1px solid var(--c-line); }\n  footer { padding:12px 16px; border-top:1px solid var(--c-line); color:var(--c-muted); font-size:12px; }\n</style></head><body>\n  <main>\n    <div class=\"row\"><span><b>Nodes on board</b><small>across 8 spatial bands</small></span><span class=\"pill\">69</span></div>\n    <div class=\"row\"><span><b>Edges</b><small>flow · depends-on · relation · references</small></span><span class=\"pill\">6</span></div>\n    <div class=\"row\"><span><b>Context pins</b><small>read via canvas://pinned-context</small></span><span class=\"pill\">3</span></div>\n    <div class=\"row\"><span><b>Groups</b><small>one example frame</small></span><span class=\"pill\">1</span></div>\n  </main>\n  <footer>An MCP App surface rendered through the app bridge from inline HTML — no live server session required.</footer>\n</body></html>",
+        "html": "<!doctype html>\n<html lang=\"en\"><head><meta charset=\"utf-8\"><style>\n  body { margin:0; font:14px/1.5 var(--font-ui); background:var(--c-panel); color:var(--c-text); }\n  main { padding:16px; display:grid; gap:12px; }\n  .row { display:grid; grid-template-columns:1fr auto; align-items:center; gap:12px; padding:11px 13px; border:1px solid var(--c-line); border-radius:6px; background:var(--c-panel-soft); }\n  .row b { font-weight:600; font-size:13px; } .row small { display:block; color:var(--c-muted); font-size:12px; }\n  .pill { font:11px var(--font-mono); padding:3px 9px; border-radius:99px; background:var(--c-panel); color:var(--c-text-soft); border:1px solid var(--c-line); }\n  footer { padding:12px 16px; border-top:1px solid var(--c-line); color:var(--c-muted); font-size:12px; }\n</style></head><body>\n  <main>\n    <div class=\"row\"><span><b>Nodes on board</b><small>across 8 spatial bands</small></span><span class=\"pill\">69</span></div>\n    <div class=\"row\"><span><b>Edges</b><small>flow · depends-on · relation · references</small></span><span class=\"pill\">7</span></div>\n    <div class=\"row\"><span><b>Context pins</b><small>read via canvas://pinned-context</small></span><span class=\"pill\">3</span></div>\n    <div class=\"row\"><span><b>Groups</b><small>one example frame</small></span><span class=\"pill\">1</span></div>\n  </main>\n  <footer>An MCP App surface rendered through the app bridge from inline HTML — no live server session required.</footer>\n</body></html>",
         "serverName": "pmx-demo",
         "toolName": "inspect_board",
         "title": "Board inspector",
@@ -3264,7 +3264,7 @@
         "source": "api"
       },
       "contentRevision": 46,
-      "linksRevision": 97,
+      "linksRevision": 98,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "markdown",
@@ -3308,7 +3308,7 @@
         "source": "api"
       },
       "contentRevision": 47,
-      "linksRevision": 97,
+      "linksRevision": 98,
       "contentChangedAt": "2026-08-01T09:00:00.000Z",
       "freshnessStartedAt": "2026-08-01T09:00:00.000Z",
       "kind": "status",
@@ -5966,6 +5966,26 @@
       },
       "createdAt": "2026-08-01T09:00:00.000Z"
     },
+    {
+      "id": "edge-review-loop",
+      "from": "trace-apply",
+      "to": "trace-plan",
+      "type": "flow",
+      "kind": "loop",
+      "reason": "An illustrated review loop, not an execution trigger.",
+      "label": "review again",
+      "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-decisions",
       "from": "context",
@@ -5974,7 +5994,7 @@
       "kind": "supports",
       "reason": "The working context explains the recorded decisions.",
       "label": "decisions",
-      "revision": 94,
+      "revision": 95,
       "changedBy": {
         "actor": "agent",
         "source": "api"
@@ -5993,7 +6013,7 @@
       "type": "depends-on",
       "label": "changed in",
       "sourceRevision": 11,
-      "revision": 95,
+      "revision": 96,
       "changedBy": {
         "actor": "agent",
         "source": "api"
@@ -6012,7 +6032,7 @@
       "type": "references",
       "label": "approval gate",
       "style": "dashed",
-      "revision": 96,
+      "revision": 97,
       "changedBy": {
         "actor": "agent",
         "source": "api"
@@ -6030,7 +6050,7 @@
       "to": "group-status",
       "type": "relation",
       "style": "dashed",
-      "revision": 97,
+      "revision": 98,
       "changedBy": {
         "actor": "agent",
         "source": "api"

package/src/server/file-watcher.ts

@@ -10,6 +10,7 @@ import { watch, existsSync, statSync } from 'node:fs';
 import type { FSWatcher } from 'node:fs';
 import { canvasState } from './canvas-state.js';
 import { applyFileContentToNodeData, readFileNodeContent } from './file-content.js';
+import { createBoardLocal } from './board-local.js';
 
 function logFileWatcherWarning(action: string, error: unknown, details?: Record<string, unknown>): void {
   console.warn(`[file-watcher] ${action}`, { error, ...(details ?? {}) });
@@ -22,7 +23,22 @@ interface WatchedFile {
   lastMtime: number;
 }
 
-const watched = new Map<string, WatchedFile>();
+const watcherSets = new Set<Map<string, WatchedFile>>();
+function stopWatching(watched: Map<string, WatchedFile>): void {
+  for (const entry of watched.values()) entry.watcher.close();
+  watched.clear();
+}
+const boardWatchers = createBoardLocal(
+  () => {
+    const watched = new Map<string, WatchedFile>();
+    watcherSets.add(watched);
+    return watched;
+  },
+  (watched) => {
+    stopWatching(watched);
+    watcherSets.delete(watched);
+  },
+);
 let onFileChanged: ((nodeId: string) => void) | null = null;
 
 /** Register a callback for when a watched file changes. */
@@ -34,6 +50,7 @@ export function onFileNodeChanged(cb: (nodeId: string) => void): void {
 export function watchFileForNode(nodeId: string, filePath: string): void {
   if (!filePath || !existsSync(filePath)) return;
 
+  const watched = boardWatchers.current;
   const existing = watched.get(filePath);
   if (existing) {
     existing.nodeIds.add(nodeId);
@@ -42,10 +59,14 @@ export function watchFileForNode(nodeId: string, filePath: string): void {
 
   try {
     const stat = statSync(filePath);
-    const watcher = watch(filePath, { persistent: false }, (eventType) => {
-      if (eventType !== 'change') return;
-      handleFileChange(filePath);
-    });
+    const watcher = watch(
+      filePath,
+      { persistent: false },
+      canvasState.bindBoard((eventType) => {
+        if (eventType !== 'change') return;
+        handleFileChange(filePath);
+      }),
+    );
 
     watched.set(filePath, {
       path: filePath,
@@ -60,6 +81,7 @@ export function watchFileForNode(nodeId: string, filePath: string): void {
 
 /** Stop watching a file for a given node. */
 export function unwatchFileForNode(nodeId: string, filePath?: string): void {
+  const watched = boardWatchers.current;
   for (const [path, entry] of watched) {
     if (filePath && path !== filePath) continue;
     entry.nodeIds.delete(nodeId);
@@ -72,14 +94,11 @@ export function unwatchFileForNode(nodeId: string, filePath?: string): void {
 
 /** Stop all watchers. */
 export function unwatchAll(): void {
-  for (const entry of watched.values()) {
-    entry.watcher.close();
-  }
-  watched.clear();
+  for (const watched of watcherSets) stopWatching(watched);
 }
 
 export function rewatchAllFileNodes(): void {
-  unwatchAll();
+  stopWatching(boardWatchers.current);
   for (const node of canvasState.getLayout().nodes) {
     if (node.type === 'file' && typeof node.data.path === 'string') {
       watchFileForNode(node.id, node.data.path);
@@ -88,6 +107,7 @@ export function rewatchAllFileNodes(): void {
 }
 
 function handleFileChange(filePath: string): void {
+  const watched = boardWatchers.current;
   const entry = watched.get(filePath);
   if (!entry) return;
 

package/src/server/human-presence.ts

@@ -1,12 +1,14 @@
 import { z } from 'zod';
 import {
   HUMAN_GRAB_TTL_MS,
+  HUMAN_NAME_MAX_LENGTH,
   HUMAN_PRESENCE_TTL_MS,
   type HumanPresence,
   type HumanPresenceSnapshot,
   MAX_HUMANS,
 } from '../shared/human-presence.js';
 import { OperationError } from './operations/types.js';
+import { canvasState } from './canvas-state.js';
 
 /**
  * Registry of open workbench tabs (rail-chrome-v2 phase 8). Fed by the
@@ -17,7 +19,7 @@ import { OperationError } from './operations/types.js';
  */
 export const HUMAN_PRESENCE_SHAPE = {
   clientId: z.string().min(1).max(64),
-  name: z.string().min(1).max(40).optional(),
+  name: z.string().min(1).max(HUMAN_NAME_MAX_LENGTH).optional(),
   cursor: z.object({ x: z.number().finite(), y: z.number().finite() }).nullable().optional(),
   grabbingNodeId: z.string().max(200).nullable().optional(),
   /** Explicit leave (tab closing): drop the presence now. */
@@ -26,6 +28,7 @@ export const HUMAN_PRESENCE_SHAPE = {
 const presenceSchema = z.object(HUMAN_PRESENCE_SHAPE);
 
 interface Stored extends HumanPresence {
+  boardId: string | null;
   lastSeenMs: number;
   grabSinceMs: number | null;
 }
@@ -57,6 +60,7 @@ export class HumanPresenceRegistry {
     }
     const existing = this.humans.get(input.clientId);
     const stored: Stored = existing ?? {
+      boardId: canvasState.activeBoardId,
       clientId: input.clientId,
       name: input.name ?? 'Human',
       cursor: null,
@@ -65,6 +69,11 @@ export class HumanPresenceRegistry {
       lastSeenMs: now,
       grabSinceMs: null,
     };
+    if (stored.boardId !== canvasState.activeBoardId) {
+      stored.boardId = canvasState.activeBoardId;
+      stored.grabbingNodeId = null;
+      stored.grabSinceMs = null;
+    }
     stored.lastSeenMs = now;
     stored.lastSeenAt = new Date(now).toISOString();
     if (input.name) stored.name = input.name;
@@ -91,9 +100,10 @@ export class HumanPresenceRegistry {
   }
 
   /** Nodes a human is holding right now → that human's name. The edit lock. */
-  lockedNodes(now = Date.now()): Map<string, string> {
+  lockedNodes(now = Date.now(), boardId = canvasState.activeBoardId): Map<string, string> {
     const locked = new Map<string, string>();
     for (const human of this.humans.values()) {
+      if (human.boardId !== boardId) continue;
       if (human.grabbingNodeId && human.grabSinceMs !== null && now - human.grabSinceMs <= HUMAN_GRAB_TTL_MS) {
         locked.set(human.grabbingNodeId, human.name);
       }
@@ -111,13 +121,16 @@ export class HumanPresenceRegistry {
   }
 
   private publicView(stored: Stored): HumanPresence {
-    const { lastSeenMs: _lastSeenMs, grabSinceMs, ...human } = stored;
+    const { lastSeenMs: _lastSeenMs, grabSinceMs, boardId, ...human } = stored;
     // An expired grab reads as released even before the sweep drops it.
     const grabbing =
-      human.grabbingNodeId && grabSinceMs !== null && Date.now() - grabSinceMs <= HUMAN_GRAB_TTL_MS
+      boardId === canvasState.activeBoardId &&
+      human.grabbingNodeId &&
+      grabSinceMs !== null &&
+      Date.now() - grabSinceMs <= HUMAN_GRAB_TTL_MS
         ? human.grabbingNodeId
         : null;
-    return { ...human, grabbingNodeId: grabbing };
+    return { ...human, cursor: boardId === canvasState.activeBoardId ? human.cursor : null, grabbingNodeId: grabbing };
   }
 
   private sweep(now = Date.now(), options: { emit?: boolean } = {}): void {