pmx-canvas 0.11.0 → 0.12.0

package/docs/product-vision-2026-09.md

@@ -336,10 +336,13 @@ The move the evidence demands before any other. A workspace holds many named boa
   vocabulary onto a chosen board without changing existing relation kinds or reasons. Each
   board's dropdown lists its actual relation kinds and only changes the view. Unclassified
   lifecycle stays unknown; it does not create a Custom vocabulary category or badge.
-- **Growth by gesture.** "Make board" turns a group into a board and leaves a portal; "Inline board" reverses it. Group, board and board of boards are one scale.
-  **Wave 5 maintenance checkpoint (2026-10-11):** define how board-qualified relations,
-  provenance and review records move before implementing these gestures. Moving a card must
-  preserve its outside links and audit identity; copying a claim must not invent a validation.
+- **Growth by gesture (decided 2026-10-27).** **Move to new board** moves a multi-selection
+  or a group chosen through its **⋯** menu into a new board and leaves a portal. No copying,
+  reverse move or inline-board operation in Wave 5. Opening a group within an existing board
+  is navigation only, with breadcrumbs and outside connections, not board creation.
+  Moving preserves outside links and audit identity without renewing validation. Resolve
+  board-qualified references, snapshot/Undo boundaries and runtime ownership through
+  [plan 020](plans/plan-020-wave-5-work-planning.md) before implementing the move.
 - **Search across boards.** The ⌘K palette searches the whole library, not just the open board: board names, README summaries, card titles and card text, with the board each hit lives on. A wiki a human cannot search is a pile; the agent's `canvas_query` search gains the same library scope.
 - **Backup.** Once boards are the wiki, `canvas.db` holds the whole library, its history and its snapshots in one file. `pmx-canvas backup` writes a consistent copy (`VACUUM INTO`, safe while the server runs) to a folder the human chooses, keeps the last N, and runs on a schedule the human sets; `pmx-canvas restore` brings one back. It is a local file, so the no-externals rule holds. The per-board folder export in move 4 is the human-readable companion, not a substitute.
 - **Agent surface.** `canvas://boards` (the library: README summary, folder, links, backlinks, last touched; levels dropped 2026-10-06), `canvas://graph{?focus,depth}` (the relation graph above, local around a focus), a `board` target on every operation with the MCP session bound to one board, and a `canvas_board` composite (22 → 23 tools, with the freeze test and all four transports updated together).
@@ -454,19 +457,32 @@ Above. Objection: none raised; the panel missed it. Risk: noise. Mitigation: the
 
 ### 3. The agent's output moves onto the board (M)
 
-**Decided with the maintainer, 2026-09-06: the fleet features stay.** They are new, deliberate capability, and the same rule that protects the node types protects them. Scope fences, consumer keys, the `pump`, parent rollups, census chips, addressed versus broadcast steering and per-consumer delivery are all kept as they are. What follows is a relocation, not a cut.
-
-The problem this move solves is one surface too many. When the agent opens a work item, raises a gate, asks a question or files evidence, it lands in a side table that the canvas cannot show. The human reads it in a panel while the board, the surface built for exactly this, stays blank about it. Two side effects follow: deleting a node forces the server to re-anchor orphaned items, and the panel and the board have different lifetimes, since canvas-bound state rides snapshots while the timeline does not.
-
-So the agent's output becomes nodes. A work item is a `status` node carrying the work state. Approval gates, elicitations and mode requests become one new `ask` node with a typed answer that records who gave it (move 7). Evidence is a node or a file node. Every gesture that already exists then applies to agent output: drag it beside the file it concerns, group it, pin it, connect it to the diff that raised it. Nothing to re-anchor, because the item is the node. One lifetime, because there is one surface.
-
-The evidence is the maintainer's own board. When three agents reviewed the product for him, they wrote markdown cards and patched each other's sections rather than filing work items. The card won because it was visible and spatial. This move makes the winner the design.
-
-Deletes: the duplicate storage only. The three timeline tables fold into the journal in move 4, which was already happening.
-
-**Three primitives I would still question, as open questions rather than proposals.** The `policy` singleton, `host-capability`, and the command registry (`pmx.plan`, `pmx.review`, and the rest) each carry a schema, a route, an MCP action and a doc section, and I cannot find a use for them on any board or in any field report. I no longer claim the evidence to delete them, and the maintainer's rule is that my not finding a use is not proof. They are worth a deliberate decision, not a default one. Separately, ghost intents: keep the capability, but change the bundled skill so signalling one is opt-in rather than required before every mutation. That is a default, not a feature.
-
-Objection (value lens): steer is the one verb the human demonstrably uses, so any move that touched it would remove the thing that works. Accepted, and now moot: steering, delivery and the fleet around it are untouched. Objection (feasibility): the presence cursors are the presence registry, so they cannot be separated. Accepted, and also moot: presence is untouched.
+**Revised with the maintainer, 2026-10-27:** the primary use is human-agent planning and
+showing work through cards and relations, not relocating every session record onto the board.
+The owner reaffirmed Uses' work-planning drawings: steps, progress, dependencies,
+alternatives, conditional paths and illustrated loops. Presentation is deliberate. Creating a
+task or starting a session does not automatically create cards, and drawing a loop does not run it.
+
+Ordinary canvas nodes and edges own the authored plan. Humans and agents can edit them without
+a session. Existing session records own running session work; a card deliberately showing a
+live task refers to that record rather than owning a second editable copy of its status.
+Starting a session does not convert existing plans. Removing the presentation does not cancel
+the underlying task. Session linkage is optional, not a prerequisite for planning.
+
+Questions and alternatives use existing card types; defer a general `ask` node. Ordinary cards
+do not approve or reject native-agent work. Approvals stay in the native host unless the user
+explicitly uses PMX's session controls. Existing gate and fence protections remain available
+even when session chrome is hidden. Timeline consolidation still belongs to the later journal.
+
+**Kept:** `policy`, `host-capability`, the named command registry, scope fences, consumer keys,
+the `pump`, parent rollups, census chips, presence, steering and per-consumer delivery.
+**Ghost feedback stays unchanged:** it is human-facing visibility, not dispensable orchestration.
+Keep explicit previews and their veto window as well as automatic ghosts; do not change the
+bundled skill's signalling default as part of this wave.
+
+[Plan 020](plans/plan-020-wave-5-work-planning.md) replaces the earlier automatic conversion
+proposal and defines implementation and acceptance. No new execution engine or session-state
+rewrite is required for ordinary planning.
 
 ### 4. One journal is the truth; the app owns its history and its store (L, then XL)
 

package/docs/sdk.md

@@ -36,6 +36,24 @@ Missing/stale validating preconditions fail. Reviewed content must persist befor
 record. Read, edit, refresh and explicit retirement restore never renew validation; historical
 records retain their reviewed revision, and legacy unversioned evidence remains unknown.
 
+## Canvas annotations
+
+```ts
+const markId = await canvas.addAnnotation({
+  id: 'question-about-option-b',
+  type: 'text',
+  points: [{ x: 160, y: 320 }],
+  text: 'Use this option?',
+});
+await canvas.removeAnnotation(markId);
+```
+
+Omit `type` for freehand ink and supply at least two world-coordinate points.
+Both methods are asynchronous and use the same validation and scope fences as
+HTTP/MCP. Creation returns the mark ID; removal returns `true` or rejects if the
+ID does not exist. Bounds and creation time are server-derived, not SDK inputs.
+See [annotation defaults and retries](http-api.md#annotations).
+
 ## Board tours
 
 `canvas.getTour()` returns `{ tour, derived, position }`, matching HTTP and MCP.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmx-canvas",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Spatial canvas workbench for coding agents — infinite 2D canvas with agent-native CLI, MCP integration, nodes, edges, file watching, and snapshots",
   "type": "module",
   "main": "./src/server/index.ts",
@@ -24,6 +24,7 @@
     "dist/canvas/",
     "dist/json-render/",
     "dist/types/",
+    "dist/amp-plugin/",
     "Readme.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -37,7 +38,7 @@
     "build:mcp-app": "bun run scripts/build-mcp-app.ts",
     "build:json-render": "bash scripts/build-json-render.sh",
     "build:types": "tsc -p tsconfig.types.json",
-    "build:plugin": "bun run scripts/build-agent-plugin.ts",
+    "build:plugin": "bun run scripts/build-agent-plugin.ts && bun run scripts/build-amp-plugin.ts",
     "build": "bun run build:client && bun run build:mcp-app && bun run build:json-render && bun run build:types && bun run build:plugin",
     "start": "bun run src/cli/index.ts --no-open",
     "pack:dry-run": "bun pm pack --dry-run",
@@ -58,7 +59,8 @@
     "test:all": "bun run test && bun run test:client && bun run test:web-canvas",
     "test:install-browsers": "bun x playwright install chromium",
     "validate:agent-skills": "bash scripts/validate-agent-skill-mirrors.sh",
-    "prepublishOnly": "bun run build && bun run typecheck"
+    "prepublishOnly": "bun run build && bun run typecheck",
+    "acceptance": "bun run scripts/acceptance.ts"
   },
   "dependencies": {
     "@joplin/turndown-plugin-gfm": "^1.0.64",
@@ -81,6 +83,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@ampcode/plugin": "0.0.0-20261027001613-g52e251f",
     "@biomejs/biome": "^2.5.2",
     "@fontsource/ibm-plex-mono": "^5.3.0",
     "@fontsource/ibm-plex-sans": "^5.3.0",

package/plugins/pmx-canvas/com.github.copilot/extensions/pmx-canvas/extension.mjs

@@ -352,7 +352,9 @@ async function getAxContext(baseUrl, workspaceRoot, input = {}, options = {}) {
     // A proxied read is one this extension records itself with what it actually
     // injected (after truncation), so the server does not record it again.
     const headers = { "x-pmx-source": "copilot", ...(options.proxied ? { "x-pmx-proxied-read": "1" } : {}) };
-    return await fetchJson(resolved.baseUrl, "/api/canvas/ax/context", { headers, timeoutMs: 2_000 });
+    // Attribution headers do not select a delivery queue. Read the same consumer
+    // the pump marks, excluding its own mirrored instructions and prior pickups.
+    return await fetchJson(resolved.baseUrl, "/api/canvas/ax/context?consumer=copilot", { headers, timeoutMs: 2_000 });
 }
 
 function deliveredPinnedIds(pinnedNodeIds, payloadText) {

package/plugins/pmx-canvas/com.github.copilot/extensions/pmx-canvas/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.11.0"
+  "version": "0.12.0"
 }

package/plugins/pmx-canvas/plugin.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "pmx-canvas",
-  "description": "PMX Canvas spatial workbench and MCP tools, with a native canvas panel in the GitHub Copilot app.",
-  "version": "0.11.0",
+  "description": "PMX Canvas is a collaborative canvas where you and your AI agent collect evidence, analyze findings, and develop ideas together. Pin material as context for your agent, then ask it to add findings, comparisons, or diagrams to the board for you to review, present, and build on.",
+  "version": "0.12.0",
   "author": {
     "name": "pskoett",
     "url": "https://github.com/pskoett"

package/plugins/pmx-canvas/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.11.0"
+  "version": "0.12.0"
 }