pmx-canvas 0.4.3 → 0.4.5

package/CHANGELOG.md

@@ -3,6 +3,83 @@
 All notable changes to `pmx-canvas` are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## [0.4.5] - 2026-08-07
+
+### Added
+
+- A third bundled skill, `pmx-canvas-orchestration`: the choreography for
+  multi-agent orchestration ON a canvas board — the agent host executes, the
+  canvas is the shared graph, state, human-steering surface, and audit trail.
+  It ships in the package's `skills/`; `pmx-canvas skills sync --yes` refreshes
+  installed copies of it like the others (sync never creates a copy — install
+  one the way your agent layout expects first).
+- Per-agent identity for orchestration: work items, timeline events, and
+  steering messages accept an optional `agentId` (who within the host), on
+  top of the coarse `source` host label.
+- Addressed steering: a steer can carry a `target` agent id — a consumer
+  claiming deliveries only sees steers addressed to it or broadcast steers.
+- Work-item status now mirrors onto linked canvas nodes automatically (an
+  `axWorkStatus` chip on the node), so the board reflects step state without
+  double-writing.
+- Running as an Amp orb service now binds the portal-assigned `$PORT`
+  automatically, so the service command is just `pmx-canvas --no-open` — no
+  port flags or `$PORT` interpolation. Honored only when `AMP_ORB` is set, so
+  a stray `PORT` in normal shells never changes the default. The README now
+  carries the full zero-config orb recipe (setup + services.yaml).
+- Auto-ghost: agent mutations that arrive without an explicit `canvas_intent`
+  signal now synthesize a short ghost that settles the moment the mutation
+  lands, so agent activity is visible even when the caller doesn't signal.
+  Auto-ghosts render lighter (dimmer, dotted, no veto) than a deliberate
+  signal; human actions in the browser and `canvas_batch` churn never ghost.
+  Disable with `PMX_CANVAS_AUTO_INTENT=0`.
+- Ghost minimum dwell: a ghost now stays visible for a perceptible floor
+  (~0.65s) even when its mutation settles within milliseconds.
+- The `amp` AX source label, for Amp host adapters and steering loop
+  prevention.
+
+### Changed
+
+- The `volt` theme's accent was retuned from coral to the Amp app's cream
+  (`#DFDFC1`).
+- Marking an AX delivery is now compare-and-set: `delivered:true` only on the
+  actual undelivered→delivered transition, so racing adapters can detect lost
+  claims.
+- The WebView-automation unavailable error now names the running Bun version
+  and clarifies that the canvas itself keeps working — only automation and
+  screenshots need Bun >= 1.3.12.
+
+### Fixed
+
+- File nodes are no longer created as content-less slivers: they get a real
+  code-preview default size, and untitled file nodes show their filename in
+  the title bar instead of a bare "FILE" chip.
+
+## [0.4.4] - 2026-08-06
+
+### Fixed
+
+- Amp orb pages now default straight to the polling transport instead of
+  waiting out the 3-second SSE watchdog behind the portal's buffering proxy —
+  on slow proxy days that wait could trip the "did not finish booting" modal.
+  `?transport=sse` still overrides for diagnosis.
+- When the SSE watchdog does fall back to polling mid-boot (non-orb buffering
+  proxies), the boot screen now shows "switching to polling" and restarts its
+  deadline instead of alarming while the fallback is already recovering.
+
+### Added
+
+- A ninth theme, `volt` — built from the Amp app's real palette (green-tinted
+  charcoal neutrals, warm green-white text, coral accent). `ember` stays
+  unchanged.
+- `pmx-canvas skills sync --yes` refreshes the pmx-canvas skill copies already
+  installed in the workspace — whatever agent layout owns them — by comparing
+  and replacing whole trees from the installed package; `--check` (or running
+  without `--yes`) reports drift and exits 1 without changing anything. A
+  directory whose `SKILL.md` identity doesn't match the bundled skill is
+  skipped, never replaced, and it never creates a copy where none is
+  installed. This automates the sync every release test cycle previously did
+  by hand.
+
 ## [0.4.3] - 2026-08-05
 
 ### Added
@@ -2912,6 +2989,8 @@ otherwise have to discover by trial and error.
 - Regression coverage for snapshot flat-`id` aliases on both MCP and
   HTTP surfaces, plus async / top-level-`await` WebView script bodies.
 
+[0.4.5]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.4.5
+[0.4.4]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.4.4
 [0.4.3]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.4.3
 [0.4.2]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.4.2
 [0.4.1]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.4.1

package/Readme.md

@@ -128,6 +128,16 @@ surfaces (the core never imports a host SDK).
 </p>
 <p align="center"><sub>The live PMX workbench in the Codex in-app Browser.</sub></p>
 
+<p align="center">
+  <img src="docs/screenshots/claude-code-desktop.png" alt="PMX Canvas in the Claude Code desktop app's built-in browser pane, driven over MCP" width="100%" />
+</p>
+<p align="center"><sub>Claude Code desktop: the workbench in the built-in browser pane, mutated live over MCP.</sub></p>
+
+<p align="center">
+  <img src="docs/screenshots/amp-orb-portal.png" alt="PMX Canvas running as an Amp orb service, viewed through the Amp portal in the Volt theme" width="100%" />
+</p>
+<p align="center"><sub>AMPCode: the canvas as an orb service through the Amp portal (Volt theme).</sub></p>
+
 - **GitHub Copilot app** — a committed project canvas extension
   (`.github/extensions/pmx-canvas/`) opens the live PMX workbench in a native
   Copilot panel (light-themed by default to match the app, via the `?theme=`
@@ -151,13 +161,13 @@ surfaces (the core never imports a host SDK).
   live workbench through the Amp portal (the `*.onamp.dev` URL ampcode.com
   embeds for the thread). Zero configuration: orbs set `AMP_ORB` in the
   service environment, and the canvas auto-adapts to the portal's constraints
-  — it switches to a polling transport when the portal proxy buffers the live
-  event stream, and renders HTML, graph, json-render, and app surfaces inline
-  via `srcdoc` because the nested-iframe embed blocks `src`-URL child iframes
-  (`/workbench?transport=poll` and `?iframe-mode=srcdoc` force either behavior
-  when diagnosing). The same detection helps other buffering proxies and
-  nested-iframe embeds.
-  <!-- screenshot: docs/screenshots/amp-orb-portal.png — PMX Canvas live inside the Amp portal (to be added) -->
+  — it defaults straight to the proxy-safe polling transport (the portal
+  proxy buffers the live event stream), and renders HTML, graph, json-render,
+  and app surfaces inline via `srcdoc` because the nested-iframe embed blocks
+  `src`-URL child iframes (`?transport=sse` and `?iframe-mode=src` override
+  either behavior when diagnosing). Non-orb buffering proxies get the same
+  protections via runtime detection: an SSE watchdog that falls back to
+  polling, and the boot-time iframe probe.
 
 Any other app browser (the ChatGPT desktop app, an IDE webview, …) works the
 same zero-adapter way: open the workbench URL, and add `?theme=<name|auto>` to
@@ -252,7 +262,29 @@ the full workflow and live-test checklist.
 
 Amp needs no adapter either. Run `pmx-canvas` as an orb service (the orb sets
 `AMP_ORB` in the environment automatically) and open the workbench through the
-thread's portal URL. The canvas detects the orb and the portal's nested-iframe
+thread's portal URL. The zero-config recipe for the repo the orb runs in:
+
+```yaml
+# .amp/services.yaml — supervised portal service
+services:
+  pmx-canvas:
+    command: pmx-canvas --no-open
+    portal: true
+    health: /health
+```
+
+```bash
+# .agents/setup — install the CLI (pin the version for reproducible starts)
+npm install -g pmx-canvas@latest
+```
+
+The server binds the portal-assigned `$PORT` automatically (gated on the
+`AMP_ORB` env the orb always sets, so a stray `PORT` elsewhere never changes
+the default), restores `.pmx-canvas/canvas.db`, and the portal manifest picks
+it up — no port flags or `$PORT` interpolation in the service command. One
+caveat: WebView automation (`pmx-canvas screenshot`) needs Bun >= 1.3.12 in
+the orb image; the canvas itself runs fine without it and says so in the
+error. The canvas detects the orb and the portal's nested-iframe
 embed on its own: live updates arrive over the proxy-safe polling transport,
 and iframe-backed nodes (HTML, graph, json-render, web artifacts) render
 inline via `srcdoc` with their theme styling included. Cross-origin hosted

package/dist/canvas/global.css

@@ -446,6 +446,61 @@
   --c-annotation: #EDF5EF;
 }
 
+:root[data-theme="volt"] {
+  /* ── Core palette (volt · green-tinted charcoal + coral) ── */
+  --c-bg: #0B0D0B;
+  --c-panel: #171A17;
+  --c-panel-soft: #111311;
+  --c-line: #272A27;
+  --c-text: #F6FFF5;
+  --c-text-soft: #CBD3CA;
+  --c-muted: #9CA49C;
+  --c-dim: #626962;
+  --c-accent: #DFDFC1;
+  --c-ok: #52C880;
+  --c-warn: #E4C465;
+  --c-warn-alt: #FFB300;
+  --c-danger: #D67670;
+  --c-purple: #BC8FB4;
+  --c-thinking: #BC8FB4;
+  --c-subagent: #6CA0E0;
+  --c-input-bg: #111311;
+  --c-dot-grid: rgba(223, 223, 193, 0.08);
+  --c-panel-overlay: rgba(11, 13, 11, 0.6);
+  --c-panel-glass: rgba(23, 26, 23, 0.92);
+  --c-shadow: rgba(0, 0, 0, 0.3);
+  --c-shadow-heavy: rgba(0, 0, 0, 0.5);
+  --c-glow-accent: rgba(223, 223, 193, 0.15);
+  --c-surface-hover: rgba(255, 255, 255, 0.06);
+  --c-surface-subtle: rgba(255, 255, 255, 0.03);
+  --c-surface-th: rgba(255, 255, 255, 0.04);
+  --c-accent-8: rgba(223, 223, 193, 0.08);
+  --c-accent-10: rgba(223, 223, 193, 0.1);
+  --c-accent-12: rgba(223, 223, 193, 0.12);
+  --c-accent-15: rgba(223, 223, 193, 0.15);
+  --c-accent-25: rgba(223, 223, 193, 0.25);
+  --c-accent-30: rgba(223, 223, 193, 0.3);
+  --c-accent-40: rgba(223, 223, 193, 0.4);
+  --c-ok-10: rgba(82, 200, 128, 0.1);
+  --c-ok-12: rgba(82, 200, 128, 0.12);
+  --c-ok-20: rgba(82, 200, 128, 0.2);
+  --c-ok-25: rgba(82, 200, 128, 0.25);
+  --c-warn-10: rgba(228, 196, 101, 0.1);
+  --c-warn-12: rgba(228, 196, 101, 0.12);
+  --c-warn-15: rgba(228, 196, 101, 0.15);
+  --c-warn-20: rgba(228, 196, 101, 0.2);
+  --c-warn-22: rgba(228, 196, 101, 0.22);
+  --c-warn-30: rgba(228, 196, 101, 0.3);
+  --c-warn-60: rgba(228, 196, 101, 0.6);
+  --c-danger-12: rgba(214, 118, 112, 0.12);
+  --c-line-30: rgba(39, 42, 39, 0.3);
+  --c-contrast-fg: #0B0D0B;
+  --c-accent-hover: #EDEDDB;
+  --c-warn-hover: #EBD087;
+  --c-canvas-wash: linear-gradient(180deg, rgba(255, 255, 255, 0.02), rgba(0, 0, 0, 0));
+  --c-annotation: #F1F7F0;
+}
+
 * {
   box-sizing: border-box;
   margin: 0;
@@ -614,6 +669,29 @@ body,
   flex-shrink: 0;
 }
 
+.canvas-node .node-ax-status {
+  font-size: calc(9px * var(--node-chrome-scale, 1));
+  padding: calc(1px * var(--node-chrome-scale, 1)) calc(6px * var(--node-chrome-scale, 1));
+  border-radius: calc(4px * var(--node-chrome-scale, 1));
+  background: var(--c-panel-overlay);
+  color: var(--c-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  flex-shrink: 0;
+}
+
+.canvas-node .node-ax-status-in-progress {
+  color: var(--c-accent);
+}
+
+.canvas-node .node-ax-status-done {
+  color: var(--c-ok);
+}
+
+.canvas-node .node-ax-status-blocked {
+  color: var(--c-warn);
+}
+
 .canvas-node .node-controls {
   display: flex;
   align-items: center;
@@ -3900,6 +3978,19 @@ button.welcome-hint:hover {
   display: contents;
 }
 
+/* Auto-ghosts (server-synthesized for unlinked agent mutations) read lighter
+   than a deliberate canvas_intent signal: desaturated, dotted, no veto —
+   the opacity drop lives in ghostOpacity() (inline style). */
+.intent-ghost.is-auto {
+  filter: saturate(0.7);
+  border-style: dotted;
+}
+
+.intent-ghost.is-auto .intent-ghost-titlebar,
+.intent-ghost.is-auto .intent-chip {
+  border-style: dotted;
+}
+
 .intent-ghost {
   position: absolute;
   pointer-events: none;