pmx-canvas 0.9.3 → 0.11.0

package/dist/types/server/operations/mcp-contracts.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MCP's output is the FORMATTER projection, never the larger HTTP payload.
+ * `result` wraps prose/arrays without pretending they are JSON objects. Each
+ * operation validates its stable fields; loose payloads preserve full:true and
+ * extensible node/app data. No schema advertises an unconstrained root record.
+ */
+import { z } from 'zod';
+import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+export declare function operationOutputSchema(operations: string[]): z.ZodObject<{
+    result: z.ZodUnion<readonly [...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[], z.ZodObject<{
+        operation: z.ZodNull;
+        outcome: z.ZodLiteral<"error">;
+        data: z.ZodObject<{
+            message: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export declare function structuredOperationResult(operation: string, formatted: CallToolResult): CallToolResult;
+export declare function operationToolError(error: unknown): CallToolResult;
+export declare function operationToolAnnotations(toolName: string): ToolAnnotations;

package/dist/types/server/operations/mcp.d.ts

@@ -12,6 +12,8 @@ export interface OperationToolHost extends OperationMcpToolHost {
     recordContextRead(read: ContextReadInput): Promise<void>;
 }
 export declare function registerOperationTools(server: McpServer, getHost: () => Promise<OperationToolHost>): void;
+/** Registry metadata only: never boots a canvas or records a content read. */
+export declare function registerOperationHelpTool(server: McpServer): void;
 /**
  * Register composite (action-discriminated) MCP tools (plan-006). Each action
  * dispatches to a registered operation, reusing that op's `mcp.buildInput` and

package/dist/types/server/operations/ops/batch.d.ts

@@ -5,6 +5,7 @@ export interface BatchEnvelope {
     refs: Record<string, unknown>;
     failedIndex?: number;
     error?: string;
+    cancelled?: boolean;
 }
 export declare const batchOperations: Operation[];
 /**

package/dist/types/server/operations/ops/boards.d.ts

@@ -1,6 +1,5 @@
 import { type CanvasLayout } from '../../canvas-state.js';
 import { type Operation } from '../types.js';
-export declare const boardCatalogEpoch: `${string}-${string}-${string}-${string}-${string}`;
 export declare function boardsPayload(reloaded?: boolean): Record<string, unknown>;
 /** Read a board without opening it. Omitted board preserves the active-board contract. */
 export declare function readTargetBoard(boardId?: unknown, includeBlobs?: boolean): {

package/dist/types/server/operations/registry.d.ts

@@ -1,4 +1,4 @@
-import { type Operation } from './types.js';
+import { type Operation, type OperationExecutionOptions } from './types.js';
 export declare function registerOperation(op: Operation): void;
 export declare function getOperation(name: string): Operation;
 export declare function listOperations(): Operation[];
@@ -12,7 +12,7 @@ export declare function getOperationEventEmitter(): OperationEventEmitter | null
 export declare function isEmitSuppressed(): boolean;
 /** Suppress this call chain's per-entry frames; the batch emits its final frame afterward. */
 export declare function runWithSuppressedEmits<T>(fn: () => Promise<T>): Promise<T>;
-export interface ExecuteOperationMeta {
+export interface ExecuteOperationMeta extends OperationExecutionOptions {
     /**
      * Skip the synthesized auto-ghost: set by the workbench's own HTTP calls
      * (a human dragging a node is not agent activity) and by canvas.batch for

package/dist/types/server/operations/types.d.ts

@@ -20,7 +20,17 @@ export declare class OperationError extends Error {
     readonly details?: Record<string, unknown>;
     constructor(message: string, status?: OperationErrorStatus, details?: Record<string, unknown>);
 }
-export interface OperationContext {
+export interface OperationProgress {
+    progress: number;
+    total?: number;
+    message?: string;
+}
+/** Cooperative cancellation: completed writes are never rolled back. */
+export interface OperationExecutionOptions {
+    signal?: AbortSignal;
+    onProgress?: (progress: OperationProgress) => void | Promise<void>;
+}
+export interface OperationContext extends OperationExecutionOptions {
     /** Emit a workbench SSE event (e.g. extra `canvas-layout-update` frames, focus, viewport). */
     emit(event: string, payload?: Record<string, unknown>): void;
 }
@@ -53,7 +63,7 @@ export interface OperationMcpToolHost {
      * restore summary).
      */
     invoker(): {
-        invoke(name: string, input: Record<string, unknown>): Promise<unknown>;
+        invoke(name: string, input: Record<string, unknown>, options?: OperationExecutionOptions): Promise<unknown>;
     };
 }
 export interface OperationMcpTool {

package/dist/types/server/server.d.ts

@@ -80,6 +80,8 @@ export interface PrimaryWorkbenchCanvasPromptRequest {
     contextNodeIds: string[];
 }
 type PrimaryWorkbenchCanvasPromptHandler = (request: PrimaryWorkbenchCanvasPromptRequest) => Promise<void>;
+/** In-process invalidation observers share the same events as daemon SSE clients. */
+export declare function onWorkbenchEvent(listener: (event: string) => void): () => void;
 export declare function setPrimaryWorkbenchAutoOpenEnabled(enabled: boolean): void;
 export declare function isPrimaryWorkbenchAutoOpenEnabled(): boolean;
 export declare function hasWorkbenchSubscribers(): boolean;

package/dist/types/server/tour-control.d.ts

@@ -8,13 +8,21 @@
  *
  * This module must never import server.ts or index.ts.
  */
-import { type Camera, type Tour, type TourStop } from '../shared/tour.js';
+import { type Camera, type Tour, type TourPresenter, type TourStop } from '../shared/tour.js';
 export type TourStep = number | 'next' | 'previous';
-export interface TourStepResult {
+export interface TourDelivery {
+    catalogEpoch: string;
+    boardGeneration: number;
+    sequence: number;
+}
+export interface TourStepResult extends TourDelivery {
     index: number;
     total: number;
     stop: TourStop;
 }
+export interface TourSuperseded {
+    superseded: true;
+}
 export interface TourState {
     tour: Tour;
     derived: boolean;
@@ -23,7 +31,9 @@ export interface TourState {
 export declare function currentTour(): TourState;
 /** Move the shared cursor. `next`/`previous` clamp at the ends; an explicit index must exist. */
 export declare function goToTourStop(step: TourStep): TourStepResult;
-export declare function exitTour(): void;
+export declare function goToTourStop(step: TourStep, presenter: TourPresenter | undefined): TourStepResult | TourSuperseded;
+export declare function exitTour(): TourDelivery;
+export declare function exitTour(presenter: TourPresenter | undefined): TourDelivery | TourSuperseded;
 /**
  * Resolve an eased camera move and store its end camera as the board viewport
  * (unrecorded). The size is the last window a browser reported, so this is the

package/dist/types/server/webpage-node.d.ts

@@ -37,6 +37,7 @@ export declare function checkWebpageHop(originScope: AddressScope, hopScope: Add
 export declare function fetchWebpageSnapshot(inputUrl: string, options?: {
     resolveHost?: ResolveHost;
     timeoutMs?: number;
+    signal?: AbortSignal;
 }): Promise<WebpageSnapshot>;
 export declare function getWebpageFetchErrorDetails(error: unknown): {
     message: string;

package/dist/types/shared/ax-surface-protocol.d.ts

@@ -16,12 +16,3 @@ export declare const AX_SURFACE_ACK_SOURCE = "pmx-canvas-ax-ack";
 export declare const HTML_SURFACE_PUSH_SOURCE = "pmx-canvas-html-node";
 /** Tab-local JSON viewer state handoff, independent of AX capabilities. */
 export declare const JSON_VIEWER_STATE_SOURCE = "pmx-canvas-json-state";
-/** Ext-app boot beacon: the iframe's scripts executed (WebKit watchdog liveness). */
-export declare const EXT_APP_BOOT_BEACON_SOURCE = "pmx-canvas-ext-app-alive";
-/**
- * Parent→ext-app paint probe (Finding N): the parent asks the app document to
- * answer with a double-rAF `paint-tick` beacon. A frame whose rendering
- * pipeline is live answers within a frame or two; silence past the timeout is
- * the paint-fail signal that drives the recovery ladder.
- */
-export declare const EXT_APP_PAINT_PROBE_SOURCE = "pmx-canvas-ext-app-paint-probe";

package/dist/types/shared/tour.d.ts

@@ -81,6 +81,14 @@ export declare const tourSchema: z.ZodObject<{
         pullback: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/** Latest intent from one document, scoped to the server's board activation. */
+export declare const tourPresenterSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    intent: z.ZodNumber;
+    catalogEpoch: z.ZodString;
+    boardGeneration: z.ZodNumber;
+}, z.core.$strip>;
+export type TourPresenter = z.infer<typeof tourPresenterSchema>;
 export type Tour = z.infer<typeof tourSchema>;
 export type TourStop = z.infer<typeof tourStopSchema>;
 export type Camera = z.infer<typeof cameraSchema>;

package/docs/api-reference.md

@@ -6,7 +6,7 @@
 
 ## MCP Server
 
-24 tools: 18 action-discriminated composites (`canvas_import`, `canvas_board`, `canvas_node`, `canvas_render`, `canvas_edge`, `canvas_group`, `canvas_history`, `canvas_view`, `canvas_query`, `canvas_webview`, `canvas_app`, `canvas_snapshot`, `canvas_ax_state`, `canvas_ax_work`, `canvas_ax_gate`, `canvas_ax_timeline`, `canvas_ax_delivery`, `canvas_intent`) plus 6 standalone tools (`canvas_batch`, `canvas_pin_nodes`, `canvas_invoke_command`, `canvas_ax_interaction`, `canvas_ingest_activity`, `canvas_screenshot`). `canvas_import` is the agent half of the human-consented attachment workflow: agents list/read requested imports, submit reviewable Markdown, or report unavailable; they cannot request, cancel, or commit. The 57 legacy single-purpose tools the composites replaced were removed in v0.3.0; v0.4.0 shipped the `canvas_snapshot` composite and removed the 6 deprecated snapshot standalones. Prefer composites for new MCP calls; see `docs/mcp.md` for the authoritative tool list and the legacy-to-composite migration reference.
+25 tools: 18 action-discriminated composites (`canvas_import`, `canvas_board`, `canvas_node`, `canvas_render`, `canvas_edge`, `canvas_group`, `canvas_history`, `canvas_view`, `canvas_query`, `canvas_webview`, `canvas_app`, `canvas_snapshot`, `canvas_ax_state`, `canvas_ax_work`, `canvas_ax_gate`, `canvas_ax_timeline`, `canvas_ax_delivery`, `canvas_intent`) plus 7 standalone tools (`canvas_help`, `canvas_batch`, `canvas_pin_nodes`, `canvas_invoke_command`, `canvas_ax_interaction`, `canvas_ingest_activity`, `canvas_screenshot`). `canvas_help { op }` returns one MCP registry operation's public arguments and guidance without accessing the canvas; omit `op` to list names. `canvas_import` is the agent half of the human-consented attachment workflow: agents list/read requested imports, submit reviewable Markdown, or report unavailable; they cannot request, cancel, or commit. The 57 legacy single-purpose tools the composites replaced were removed in v0.3.0; v0.4.0 shipped the `canvas_snapshot` composite and removed the 6 deprecated snapshot standalones. Prefer composites for new MCP calls; see `docs/mcp.md` for the authoritative tool list and the legacy-to-composite migration reference.
 
 ### Agent-assisted document imports
 
@@ -18,7 +18,7 @@ The `diagram` action of `canvas_app` is a thin preset in `src/server/diagram-pre
 
 15 static canvas resources: `canvas://boards`, `canvas://pinned-context`, `canvas://schema`, `canvas://layout`, `canvas://summary`, `canvas://spatial-context`, `canvas://history`, `canvas://code-graph`, `canvas://ax`, `canvas://ax-context`, `canvas://ax-timeline`, `canvas://ax-work`, `canvas://ax-pending-steering`, `canvas://ax-delivery`, `canvas://skills`; two canvas resource templates: `canvas://context{?budget,consumer,since}` and `canvas://graph{?focus,depth}`. Bundled skills additionally register per-skill `canvas://skills/<name>` resources and the `skill://{name}/{+path}` file template.
 
-Resource change notifications: the MCP server emits `notifications/resources/updated` when canvas state changes. Pin changes notify `canvas://pinned-context`; all mutations notify `canvas://layout`, `canvas://summary`, `canvas://spatial-context`, `canvas://history`, `canvas://code-graph`, and `canvas://graph`. This enables real-time human→agent collaboration — humans pin nodes in the browser, agents are notified immediately.
+Resource change notifications: subscribe to each live URI to receive `notifications/resources/updated` when canvas state or knowledge policies change. Notifications invalidate cached data without reading it. Subscriptions belong to the connection; subscribe again after reconnecting. See [Resource subscriptions](mcp.md#resource-subscriptions-010).
 
 ### AX Primitives (host-agnostic)
 

package/docs/cli.md

@@ -100,7 +100,7 @@ Tours persist with the board and snapshots, participate in undo, and clear with
 the board. A file containing `null` resets the tour: when none is saved, groups
 are sorted by y, then x, then ID. A saved empty `stops` array deliberately has no
 stops. SDK: `canvas.setTour(tourOrNull)` / `canvas.getTour()`, which returns
-the tour directly; read stops from `.stops`.
+`{ tour, derived, position }` as of 0.10; read stops from `.tour.stops`.
 
 ### Driving a tour (agents)
 

package/docs/design/Chrome.dc.html

@@ -13,7 +13,7 @@
 body{margin:0}
 </style>
 </helmet>
-<div style="width: 1440px; height: 1000px; box-sizing: border-box; padding: 40px 48px; background: #081524; color: #e6eef7; font-family: 'IBM Plex Sans', system-ui, sans-serif; font-size: 13px; line-height: 1.5; display: grid; grid-template-columns: 500px repeat(2, minmax(0, 1fr)); gap: 40px">
+<div style="width: 1440px; height: 1360px; box-sizing: border-box; padding: 40px 48px; background: #081524; color: #e6eef7; font-family: 'IBM Plex Sans', system-ui, sans-serif; font-size: 13px; line-height: 1.5; display: grid; grid-template-columns: 500px repeat(2, minmax(0, 1fr)); gap: 40px">
 
 <section style="display: flex; flex-direction: column; gap: 14px">
 <div><h2 style="margin: 0; font-size: 15px; font-weight: 600">7 · Tool rail in a 690px-tall window</h2><p style="margin: 2px 0 0; font-size: 12px; color: #8ea3bd">20 buttons need 850px. Settings-type tools move into one menu.</p></div>
@@ -62,7 +62,7 @@ body{margin:0}
 </section>
 
 <section style="display: flex; flex-direction: column; gap: 14px">
-<div><h2 style="margin: 0; font-size: 15px; font-weight: 600">8 · Node header</h2><p style="margin: 2px 0 0; font-size: 12px; color: #8ea3bd">Expand and the context pin always show; ⋯ on hover opens the existing node menu (now with Open in new tab), and Set as README stays in the markdown footer.</p></div>
+<div><h2 style="margin: 0; font-size: 15px; font-weight: 600">8 · Node header</h2><p style="margin: 2px 0 0; font-size: 12px; color: #8ea3bd">Expand and the context pin always show; ⋯ on hover or keyboard focus opens the node menu. Set as README lives here, becoming Remove as README on the current README. Edit stays visible below Markdown.</p></div>
 
 <span style="font-size: 11px; font-weight: 500; letter-spacing: 0.06em; text-transform: uppercase; color: #6b7d94">Today</span>
 <div style="border-radius: 12px 12px 8px 8px; border: 1px solid #1b2c44; background: #0f1d31; box-shadow: 0 0 0 1px rgba(244,197,66,0.3), 0 8px 24px rgba(244,197,66,0.1); overflow: hidden">
@@ -78,7 +78,8 @@ body{margin:0}
 <div style="border-radius: 10px; border: 1px solid #1b2c44; background: #0f1d31; box-shadow: 0 1px 2px rgba(0,0,0,0.4), 0 6px 20px rgba(0,0,0,0.24); overflow: hidden">
 <div style="display: flex; align-items: center; gap: 8px; height: 36px; padding: 0 8px 0 12px; border-bottom: 1px solid #1b2c44">
 <svg width="16" height="16" viewBox="0 0 24 24" style="color: #8ea3bd; fill: none; stroke: currentColor; stroke-width: 1.6; stroke-linecap: round; stroke-linejoin: round"><path d="M6 5h12a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2zM8 10h8M8 14h5"></path></svg>
-<span style="flex: 1; font-size: 12px; font-weight: 600">PMX Canvas — guided tour</span>
+<span style="flex: 1; min-width: 0; overflow: hidden; white-space: nowrap; text-overflow: ellipsis; font-size: 12px; font-weight: 600">PMX Canvas — guided tour</span>
+<span style="flex-shrink: 0; font-size: 11px; color: #8ea3bd">README</span>
 <button aria-label="Expand (Enter)" style="width: 22px; height: 22px; border: 0; border-radius: 6px; padding: 0; background: transparent; color: #b9c6d6; display: flex; align-items: center; justify-content: center; flex-shrink: 0"><svg width="13" height="13" viewBox="0 0 24 24" style="fill: none; stroke: currentColor; stroke-width: 2; stroke-linecap: round; stroke-linejoin: round"><path d="M14 4h6v6M20 4l-7 7M10 20H4v-6M4 20l7-7"></path></svg></button>
 <button aria-label="Add to context (P)" style="width: 18px; height: 18px; box-sizing: border-box; border: 1.5px solid #6b7d94; border-radius: 999px; padding: 0; background: transparent; color: #b9c6d6; display: flex; align-items: center; justify-content: center; flex-shrink: 0"><svg width="10" height="10" viewBox="0 0 24 24" style="fill: none; stroke: currentColor; stroke-width: 2.4; stroke-linecap: round; stroke-linejoin: round"><path d="M9 4h6l-.8 5.5 2.8 3H7l2.8-3zM12 12.5V20"></path></svg></button>
 <!-- Reserve the hover-action slots: revealing More/Close must not move the pin. -->
@@ -111,7 +112,8 @@ body{margin:0}
 <div style="height: 236px; display: flex; flex-direction: column; border: 1px solid #1b2c44; border-radius: 10px; overflow: hidden; background: #0f1d31">
 <div style="flex-shrink: 0; height: 36px; display: flex; align-items: center; padding: 0 12px; border-bottom: 1px solid #1b2c44; font-size: 12px; font-weight: 600">Research index</div>
 <div style="flex: 1; min-height: 0; display: flex; flex-direction: column">
-<div style="flex: 1; min-height: 0; padding: 10px 12px; overflow: auto; font-size: 13px; color: #b9c6d6">Read the source, then follow <a href="#reference-footer" style="color: #e6eef7">the evidence</a>.<div style="margin-top: 20px; font-size: 12px; color: #8ea3bd">Set as README <span style="float: right">Edit</span></div></div>
+<div style="flex: 1; min-height: 0; padding: 10px 12px; overflow: auto; font-size: 13px; color: #b9c6d6">Read the source, then follow <a href="#reference-footer" style="color: #e6eef7">the evidence</a>.</div>
+<div style="flex-shrink: 0; border-top: 1px solid #1b2c44; padding: 6px 36px 6px 8px; text-align: right"><button style="border: 1px solid transparent; border-radius: 6px; padding: 4px 8px; background: transparent; color: #8ea3bd; font: 500 11px 'IBM Plex Sans', sans-serif">Edit</button></div>
 <div id="reference-footer" role="region" aria-label="Cross-board references" tabindex="0" style="flex-shrink: 0; max-height: min(40%, 132px); overflow: auto; overscroll-behavior: contain">
 <div style="padding: 6px 12px; border-top: 1px solid #1b2c44; font-size: 12px; color: #b9c6d6">↗ references: Research / Interview notes</div>
 <div style="padding: 6px 12px; border-top: 1px solid #1b2c44; font-size: 12px; color: #b9c6d6">↗ references: Research / Findings</div>
@@ -174,11 +176,35 @@ body{margin:0}
 <span style="font-size: 11px; color: #8ea3bd">Fit and focus keep a lane clear for floating chrome.</span>
 </div>
 </div>
+
+<div style="display: flex; flex-direction: column; gap: 8px">
+<h2 style="margin: 0; font-size: 15px; font-weight: 600">Present · hover / keyboard focus</h2>
+<p style="margin: 0; font-size: 11px; color: #8ea3bd">2026-10-25: the button describes this tooltip with aria-describedby. In the narrow ⋯ menu, the same text appears in flow below Present so the scrolling menu cannot clip it.</p>
+<div role="tooltip" style="max-width: 240px; padding: 10px 12px; border: 1px solid #2a4566; border-radius: 10px; background: #0f1d31; color: #b9c6d6; font-size: 12px; line-height: 1.35">
+<strong style="color: #e6eef7">Present board</strong>
+<p>A presentation follows either a saved tour or the board’s groups.</p>
+<p>Saved tour: ask your agent to define the stops and their order. Each stop can focus on a card, a group, a rectangular area, or a specific camera position.</p>
+<p style="margin-bottom: 0">No saved tour: every group becomes a stop, ordered top-to-bottom, then left-to-right. It doesn’t automatically visit every card.</p>
+</div>
+</div>
+<div style="display: flex; flex-direction: column; gap: 8px">
+<h2 style="margin: 0; font-size: 15px; font-weight: 600">Presentation · navigation</h2>
+<p style="margin: 0; font-size: 11px; color: #8ea3bd">Owner decision, 2026-10-25: Back and Next sit beside Exit at the top-right. Instructions appear only in hover/focus tooltips, never in a corner panel. End buttons stay focusable but unavailable; their descriptions remain accessible.</p>
+<div style="position: relative; height: 180px; border: 1px solid #1b2c44; border-radius: 10px; background: #081524">
+<div style="position: absolute; top: 16px; right: 16px; display: flex; gap: 8px">
+<button style="padding: 8px 14px; min-height: 38px; border: 1px solid #8ea3bd; border-radius: 8px; background: #0f1d31; color: #e6eef7; font: inherit; font-weight: 600; opacity: .5" aria-disabled="true">Back</button>
+<button style="padding: 8px 14px; min-height: 38px; border: 1px solid #8ea3bd; border-radius: 8px; background: #0f1d31; color: #e6eef7; font: inherit; font-weight: 600">Next</button>
+<button style="padding: 8px 14px; min-height: 38px; border: 1px solid #8ea3bd; border-radius: 8px; background: #0f1d31; color: #e6eef7; font: inherit; font-weight: 600">Exit presentation</button>
+</div>
+<div style="position: absolute; top: 66px; right: 16px; width: 168px; padding: 10px 12px; border: 1px solid #2a4566; border-radius: 10px; background: #0f1d31; box-shadow: 0 14px 36px #0006; font-size: 12px"><strong>Next stop</strong><br><span style="color: #8ea3bd">→ / ↓ / Space</span></div>
+</div>
+<p style="margin: 0; font-size: 11px; color: #8ea3bd">Back: Previous stop, ← / ↑. Next: Next stop, → / ↓ / Space. Exit: Exit presentation, Esc. Fit clears the top controls; exact camera targets and recording remain exact.</p>
+</div>
 </section>
 
 </div>
 </x-dc>
-<script type="text/x-dc" data-dc-script data-props='{"$preview":{"width":1440,"height":1000}}'>
+<script type="text/x-dc" data-dc-script data-props='{"$preview":{"width":1440,"height":1360}}'>
 class Component extends DCLogic {
   renderVals() {
     var P = {
@@ -245,7 +271,7 @@ class Component extends DCLogic {
       optIn('Trace', 'Show execution traces. Turning off keeps existing traces and never starts an agent.', false, false),
       setting('Send feedback', '', 'Share feedback about PMX Canvas.')
     ];
-    var nodeMenu = [m('Focus', ''), m('Rename…', ''), m('Collapse', ''), m('Open in new tab', '', true), msep, m('Delete', '⌫')];
+    var nodeMenu = [m('Focus', ''), m('Rename…', ''), m('Collapse', ''), m('Open in new tab', ''), msep, m('Set as README', '', true), msep, m('Delete', '⌫')];
     var oldIcons = [{ d: P.ctx }, { d: P.ask }, { d: P.open }, { d: P.expand }, { d: P.chevron }, { d: P.close }];
     return { railToday: railToday, railNew: railNew, settings: settings, nodeMenu: nodeMenu, oldIcons: oldIcons };
   }

package/docs/design/Types1.dc.html

@@ -22,7 +22,7 @@ body{margin:0}
 </div>
 
 <div style="{{s.row}}">
-<div><div style="{{s.type}}">markdown</div><p style="{{s.what}}">Body 11 → 12px. “Set as README / Edit” footer moves into ⋯; double-click still edits.</p></div>
+<div><div style="{{s.type}}">markdown</div><p style="{{s.what}}">Body 11 → 12px. Set as README moves into ⋯, becoming Remove as README when assigned. A quiet README header word stays visible on the designated card, including heading display (Chrome §8). Edit stays visible; double-click still edits. Heading display has no footer.</p></div>
 <div style="{{o.node}}">
 <div style="{{o.head}}"><svg width="16" height="16" viewBox="0 0 24 24" style="{{o.icon}} color: #4BBCFF"><path d="{{i.note}}"></path></svg><span style="{{o.title}}">PMX Canvas — guided tour</span><span style="{{o.ctl}}">⤢⌄×</span></div>
 <div style="padding: 10px 14px; display: flex; flex-direction: column; gap: 6px">
@@ -39,6 +39,7 @@ body{margin:0}
 <div style="color: #b9c6d6">An infinite spatial canvas that agents drive over MCP, HTTP or the Bun SDK — and that humans steer by pinning nodes.</div>
 <div style="color: #b9c6d6">• Pin a node in the browser<br>• The agent reads it from <code style="{{n.code}}">canvas://pinned-context</code></div>
 </div>
+<div style="border-top: 1px solid #1b2c44; padding: 6px 36px 6px 8px; text-align: right"><button style="border: 1px solid transparent; border-radius: 6px; padding: 4px 8px; background: transparent; color: #8ea3bd; font: 500 11px 'IBM Plex Sans', sans-serif">Edit</button></div>
 </div>
 </div>
 
@@ -120,7 +121,7 @@ body{margin:0}
 </div>
 
 <div style="{{s.row}}">
-<div><div style="{{s.type}}">file</div><p style="{{s.what}}">The extra toolbar row folds into the header (path · lines). Code 10 → 12px with dim line numbers.</p></div>
+<div><div style="{{s.type}}">file</div><p style="{{s.what}}">The extra toolbar row folds into the header (path · lines). Only metadata clips as space tightens; Reload and AX evidence hints remain visible on hover/focus. Code 10 → 12px with dim line numbers.</p></div>
 <div style="{{o.node}}">
 <div style="{{o.head}}"><svg width="16" height="16" viewBox="0 0 24 24" style="{{o.icon}} color: #4BBCFF"><path d="{{i.file}}"></path></svg><span style="{{o.title}}">node-sizes.ts</span><span style="{{o.ctl}}">⤢⌄×</span></div>
 <div style="display: flex; align-items: center; gap: 6px; padding: 4px 12px; border-bottom: 1px solid #1b2c44; font-family: 'IBM Plex Mono', monospace; font-size: 9px; color: #8ea3bd"><span style="padding: 1px 4px; border-radius: 3px; background: #13243b; color: #4BBCFF">TS</span><span>46 lines</span><span style="color: #5c6b80">src/shared/node-sizes.ts</span></div>

package/docs/design/Types2.dc.html

@@ -90,7 +90,7 @@ body{margin:0}
 </div>
 
 <div style="{{s.row}}">
-<div><div style="{{s.type}}">html</div><p style="{{s.what}}">The white outline around the frame goes. The page gets the canvas tokens, so it sits on the node surface.</p></div>
+<div><div style="{{s.type}}">html</div><p style="{{s.what}}">The white outline around the frame goes. The page gets the canvas tokens, so it sits on the node surface. Owner decision, 2026-10-25: generated primitives have no shared header copy buttons. Copy JSON lives in the card's ⋯ menu and includes live edits. Copy prompt is removed; primitive-specific copy controls remain.</p></div>
 <div style="{{o.node}}">
 <div style="{{o.head}}"><svg width="16" height="16" viewBox="0 0 24 24" style="{{o.icon}} color: #4BBCFF"><path d="{{i.html}}"></path></svg><span style="{{o.title}}">Release gates</span><span style="{{o.ctl}}">↗⤢⌄×</span></div>
 <div style="flex: 1; margin: 8px; border: 1px solid #f2f2f2; border-radius: 2px; padding: 10px 12px; display: flex; flex-direction: column; gap: 5px">

package/docs/design/Types3.dc.html

@@ -49,7 +49,7 @@ body{margin:0}
 </div>
 
 <div style="{{s.row}}">
-<div><div style="{{s.type}}">graph</div><p style="{{s.what}}">Chart sits on the node surface. The title isn't repeated inside; the chart type becomes header meta.</p></div>
+<div><div style="{{s.type}}">graph</div><p style="{{s.what}}">Chart sits on the node surface. The title isn't repeated inside; the chart type becomes header meta. Close slopegraph labels separate by 14px when space permits; points stay at their values, with short same-ink leaders.</p><svg width="200" height="60" role="img" aria-label="Close slopegraph labels, values unchanged"><path d="M10 42L70 20M10 52L70 26L75 34" fill="none" stroke="#4BBCFF" stroke-width="1.5"></path><circle cx="70" cy="20" r="2.5" fill="#4BBCFF"></circle><circle cx="70" cy="26" r="2.5" fill="#4BBCFF"></circle><text x="78" y="20" dominant-baseline="central" fill="#e6eef7" font-size="11">59 cli</text><text x="78" y="34" dominant-baseline="central" fill="#e6eef7" font-size="11">58 client</text></svg></div>
 <div style="{{o.node}}">
 <div style="{{o.head}}"><svg width="16" height="16" viewBox="0 0 24 24" style="{{o.icon}} color: #f4c542"><path d="{{i.chart}}"></path></svg><span style="{{o.title}}">bar — merged PRs per week</span><span style="{{o.ctl}}">↗⤢⌄×</span></div>
 <div style="flex: 1; margin: 0 8px 8px; position: relative; background: #000000; border-radius: 8px; padding: 10px 12px; font-family: system-ui, sans-serif">

package/docs/design/Zoom.dc.html

@@ -2,79 +2,56 @@
 <html lang="en">
 <head>
 <meta charset="utf-8">
-<title>Zoomed out — fit all</title>
+<title>Native spatial zoom</title>
 <script src="./support.js"></script>
 </head>
 <body>
 <x-dc>
 <helmet>
-<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500&amp;family=IBM+Plex+Sans:wght@400;500;600&amp;display=swap">
-<style>
-body{margin:0}
-</style>
+<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600&amp;display=swap">
+<style>body{margin:0}</style>
 </helmet>
-<div style="width: 1440px; height: 640px; box-sizing: border-box; padding: 40px 48px; background: #081524; color: #e6eef7; font-family: 'IBM Plex Sans', system-ui, sans-serif; font-size: 13px; line-height: 1.5; display: flex; flex-direction: column; gap: 20px">
-<div><h2 style="margin: 0; font-size: 15px; font-weight: 600">11 · Fit all on the demo board lands at 8%</h2><p style="margin: 2px 0 0; font-size: 12px; color: #8ea3bd">41 of 70 nodes are embedded frames and render as empty cards. Below ~25%, draw each node as its kind and title at screen size.</p></div>
-<div style="flex: 1; display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 40px">
-
-<div style="display: flex; flex-direction: column; gap: 8px">
-<span style="font-size: 11px; font-weight: 500; letter-spacing: 0.06em; text-transform: uppercase; color: #6b7d94">Today</span>
-<div style="position: relative; flex: 1; border-radius: 10px; border: 1px solid #1b2c44; overflow: hidden; background: #081524">
-<sc-for list="{{sections}}" as="sct" hint-placeholder-count="2">
-<div style="position: absolute; left: 24px; top: {{sct.y}}px; width: 600px; height: 10px; border-radius: 3px; background: #0f1d31; border: 1px solid #1b2c44; box-shadow: 0 0 0 1px rgba(244,197,66,0.3)"></div>
+<div style="width:1440px;height:640px;box-sizing:border-box;padding:40px 48px;background:#081524;color:#e6eef7;font-family:'IBM Plex Sans',system-ui,sans-serif;font-size:13px;line-height:1.5">
+<h2 style="margin:0;font-size:20px;font-weight:600">11 · Keep the native board at every zoom</h2>
+<p style="color:#8ea3bd">Maintainer decision, 2026-10-25. The same positions, sizes, groups, connections and contents scale together. No alternate grid or content enlargement.</p>
+<div style="display:flex;gap:24px;margin-top:28px">
+<sc-for list="{{views}}" as="view" hint-placeholder-count="3">
+<section style="width:432px">
+<h3 style="font-size:14px">{{view.label}}</h3>
+<svg width="432" height="380" viewBox="0 0 432 380" style="border:1px solid #1b2c44;border-radius:10px;background:#081524">
+<g transform="translate(16 44)">
+<g transform="scale({{view.scale}})">
+<rect x="0" y="0" width="396" height="308" rx="8" fill="none" stroke="#536c88"/>
+<text x="12" y="22" fill="#e6eef7" font-size="16">Release evidence</text>
+<path d="M182 128 L218 218" stroke="#6b7d94" stroke-width="2" fill="none"/>
+<path d="M211 213 L218 218 L218 210" stroke="#6b7d94" stroke-width="2" fill="none"/>
+<g transform="translate(12 36)">
+<rect width="170" height="154" rx="8" fill="#0f1d31" stroke="#1b2c44"/>
+<text x="12" y="22" fill="#e6eef7" font-size="{{view.titleSize}}">Build durations</text>
+<path d="M14 126 L45 99 L77 110 L110 72 L153 84" fill="none" stroke="#62c4b8" stroke-width="3"/>
+<path d="M14 44 V138 H156" fill="none" stroke="#536c88"/>
+<text x="16" y="59" fill="#8ea3bd" font-size="11">37 → 19 minutes</text>
+</g>
+<g transform="translate(218 146)">
+<rect width="166" height="146" rx="8" fill="#0f1d31" stroke="#1b2c44"/>
+<text x="12" y="22" fill="#e6eef7" font-size="{{view.titleSize}}">Release gates</text>
+<text x="12" y="56" fill="#e6eef7" font-size="13">✓ Tests passed</text>
+<text x="12" y="82" fill="#e6eef7" font-size="13">✓ Review complete</text>
+<text x="12" y="108" fill="#8ea3bd" font-size="12">Source: build report</text>
+</g>
+</g>
+</g>
+</svg>
+</section>
 </sc-for>
-<sc-for list="{{tiles}}" as="t" hint-placeholder-count="20">
-<div style="position: absolute; left: {{t.x}}px; top: {{t.y}}px; width: 112px; height: 72px; box-sizing: border-box; border-radius: 4px; background: #0f1d31; border: 1px solid #1b2c44; overflow: hidden"><div style="height: 6px; background: #13243b"></div></div>
-</sc-for>
-<span style="position: absolute; right: 12px; bottom: 10px; font-family: 'IBM Plex Mono', monospace; font-size: 11px; color: #5c6b80">8%</span>
-</div>
-</div>
-
-<div style="display: flex; flex-direction: column; gap: 8px">
-<span style="font-size: 11px; font-weight: 500; letter-spacing: 0.06em; text-transform: uppercase; color: #6b7d94">Proposed</span>
-<div style="position: relative; flex: 1; border-radius: 10px; border: 1px solid #1b2c44; overflow: hidden; background: #081524">
-<sc-for list="{{sections}}" as="sct" hint-placeholder-count="2">
-<div style="position: absolute; left: 24px; top: {{sct.yt}}px; font-size: 15px; font-weight: 600; line-height: 20px">{{sct.title}}</div>
-</sc-for>
-<sc-for list="{{tiles}}" as="t" hint-placeholder-count="20">
-<div style="position: absolute; left: {{t.x}}px; top: {{t.y}}px; width: 112px; height: 72px; box-sizing: border-box; padding: 8px 10px; border-radius: 6px; background: #0f1d31; border: 1px solid #1b2c44; display: flex; flex-direction: column; gap: 4px">
-<div style="display: flex; align-items: center; gap: 6px"><svg width="14" height="14" viewBox="0 0 24 24" style="flex-shrink: 0; color: #8ea3bd; fill: none; stroke: currentColor; stroke-width: 1.8; stroke-linecap: round; stroke-linejoin: round"><path d="{{t.icon}}"></path></svg><span style="font-size: 11px; color: #8ea3bd">{{t.kind}}</span></div>
-<span style="font-size: 12px; font-weight: 600; line-height: 1.3">{{t.title}}</span>
-</div>
-</sc-for>
-<span style="position: absolute; right: 12px; bottom: 10px; font-family: 'IBM Plex Mono', monospace; font-size: 11px; color: #6b7d94">8%</span>
-</div>
-</div>
-
 </div>
+<p style="color:#8ea3bd">Automatic previews stay on the board. Zoom or expand to read details. Title text grows at most 1.2×; the header line and content space stay fixed.</p>
 </div>
 </x-dc>
 <script type="text/x-dc" data-dc-script data-props='{"$preview":{"width":1440,"height":640}}'>
 class Component extends DCLogic {
   renderVals() {
-    var chart = 'M4 4v16h16M8 16v-4M12 16V8M16 16v-6';
-    var html = 'M8 8l-4 4 4 4M16 8l4 4-4 4M13.5 5l-3 14';
-    var charts = [
-      ['line', 'p95 latency'], ['bar', 'Merged PRs'], ['area', 'Nodes created'], ['pie', 'Node types'], ['stacked', 'CI minutes'],
-      ['composed', 'Throughput'], ['scatter', 'PR size'], ['radar', 'Coverage'], ['sparkline', 'Build time'], ['bullet', 'Release KPIs']
-    ];
-    var prims = [
-      ['html', 'Choice grid'], ['html', 'Plan timeline'], ['html', 'Review sheet'], ['html', 'PR write-up'], ['html', 'System map'],
-      ['html', 'Walkthrough'], ['html', 'Design sheet'], ['html', 'Component gallery'], ['html', 'Flowchart'], ['html', 'Triage board']
-    ];
-    var sections = [
-      { y: 22, yt: 18, title: '④ Charts' },
-      { y: 222, yt: 218, title: '⑦ HTML primitives' }
-    ];
-    var tiles = [];
-    function place(list, top, icon) {
-      list.forEach(function (it, i) {
-        tiles.push({ x: 24 + (i % 5) * 122, y: top + Math.floor(i / 5) * 82, kind: it[0], title: it[1], icon: icon });
-      });
-    }
-    place(charts, 50, chart);
-    place(prims, 250, html);
-    return { sections: sections, tiles: tiles };
+    return { views: [{ label: '100%', scale: 1, titleSize: 12 }, { label: '39%', scale: 0.39, titleSize: 14.4 }, { label: '20%', scale: 0.2, titleSize: 14.4 }] };
   }
 }
 </script>

package/docs/design/canvas.json

@@ -38,7 +38,7 @@
       "y": 10260
     },
     "Chrome.dc.html": {
-      "h": 1000,
+      "h": 1360,
       "title": "Rail, node header, section labels",
       "w": 1440,
       "x": 1520,