pmx-canvas 0.5.0 → 0.6.1

package/CHANGELOG.md

@@ -3,6 +3,51 @@
 All notable changes to `pmx-canvas` are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## [0.6.1] - 2026-09-07
+
+The Bun 1.4.2 upgrade and fixes from the 0.5.1 field reports (Amp orb, Copilot app).
+Version 0.6.0 was tagged but not published; this release includes its full changes.
+
+### Breaking
+
+- Bun 1.4.2 or newer is now required. Upgrade Bun before installing this release.
+
+### Internal
+
+- Fresh orbs prepare and cache the pinned toolchain, dependencies, and Chromium during setup.
+- CI uses Bun 1.4.2, and browser tests handle delayed transport startup and early iframe input reliably.
+- WebView integration tests allow server navigation timeouts and cleanup to complete on slower hosts.
+- Installation and skill guidance now explain workspace targeting, managed services, and safe disposable smoke tests.
+- Added the September product review and vision documents, including the direction for personal and shared context.
+
+### Fixed
+
+- MCP calls now reject removed or dead fields (such as `dockPosition`) with the same error HTTP returns, instead of silently dropping them.
+- `canvas_ax_state { action: "set-presence" }` accepts `contextUsage` over MCP, so agents can report their real token window from any transport.
+- Focusing a node (including the automatic focus when an MCP app opens) keeps the whole node clear of the command bar and minimap, zooming out when it would not fit.
+- Panning from a node can no longer start a stray text drag that minted webpage nodes from card text; pan now works across the entire node surface.
+- Embedded app tiles verify painted pixels, not just a laid-out canvas — a blank Excalidraw surface now fails honestly, keeps its overlay, and offers Retry instead of logging a false `content-verified`.
+- The web-artifact bundler recovers from a corrupted Parcel cache in a reused build project (clear and retry cold) instead of failing every later build.
+- Idle agents no longer park their cursor pills over the board — a cursor fades out when its agent goes idle and returns the moment it works again.
+- On a many-agent board the top bar shows the most active agents plus one census chip with the total (e.g. `+13 · 16 agents`), instead of one chip per agent flooding the bar and pushing the zoom controls over the session panel.
+
+## [0.5.1] - 2026-08-28
+
+Fixes from the 0.5.0 field reports (Amp orb, Copilot app, Codex app).
+
+### Fixed
+
+- Fit now reserves the space under the command bar and minimap, so fitted nodes are never hidden behind the floating UI.
+- Embedded app tiles (Excalidraw and other MCP apps) verify that real content rendered before reporting success; a tile that fails to paint keeps its loading overlay and offers a visible Retry — including in the expanded view.
+- The Bun SDK's `saveSnapshot()` reuses the existing snapshot for an unchanged board, matching HTTP and MCP.
+- `pmx-canvas pump` is listed in `--help`, `pmx-canvas pump --help` prints usage, and the bundled skill documents the pump recipe for agents without an adapter.
+- The session timeline's filter row no longer overflows narrow panels.
+- Creating or updating a node with the removed `dockPosition` field now returns an error instead of silently ignoring it.
+
+### Changed
+
+- The fit endpoint's `padding` option is measured in screen pixels.
+
 ## [0.5.0] - 2026-08-28
 
 The multi-agent workbench release. The canvas becomes a live, shared surface

package/Readme.md

@@ -1,5 +1,9 @@
 # pmx-canvas
 
+pmx-canvas is a visual workspace for planning, discovery, analysis, coordination,
+and orchestrating work with agents—from exploring an idea to directing its
+execution and carrying the learning forward.
+
 **A moldable canvas for agent-assisted thinking.** An infinite 2D surface
 where files, plans, status, charts, fetched web pages, annotations, code
 diffs, and diagrams live side by side. Every node carries its own renderer; agents
@@ -234,7 +238,7 @@ hooks, canvas, and session APIs onto PMX's AX primitives — no core changes.
 
 ## Prerequisites
 
-- [Bun](https://bun.sh) >= 1.3.14
+- [Bun](https://bun.sh) >= 1.4.2
 
 The published SDK entrypoint is Bun-first. Node.js consumers should use the
 CLI, MCP server, or HTTP API.
@@ -355,16 +359,15 @@ services:
 ```bash
 # .agents/setup — install the CLI (pin the exact version: a fresh orb running
 # @latest can silently pick up a newer release than the one you validated)
-npm install -g pmx-canvas@0.5.0
+npm install -g pmx-canvas@0.6.1
 ```
 
 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
+it up — no port flags or `$PORT` interpolation in the service command. The
+orb image needs Bun >= 1.4.2; WebView automation (`pmx-canvas screenshot`)
+also needs a working Chrome installation. 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, mermaid, graph, json-render, web artifacts)
 render inline via `srcdoc` with their theme styling included. Two things can't

package/dist/canvas/global.css

@@ -986,10 +986,21 @@ body,
   /* NOT overflow:hidden — the BarHint tooltips hang below the bar and were
      clipped invisible for everyone (the e2e asserted opacity, which cannot
      see ancestor clipping). Children ellipsize themselves; the narrow-screen
-     collapse is media-query display, not clipping. */
+     collapse is media-query display, not clipping. overflow-x: clip is the
+     one safe axis (visible/clip is the valid mixed pair): tooltips still
+     hang below, but bar content can never paint over the session panel
+     again (0.5.1 user feedback — the agent-chip flood pushed the zoom
+     cluster out of the bar). */
+  overflow-x: clip;
   min-width: 0;
   z-index: 9998;
 }
+/* CHIP BarHint anchors must pass shrink through to their chip (flex min-auto
+   sizing) or an unshrinkable anchor re-creates the overflow. Chip anchors
+   ONLY — a blanket min-width: 0 crushed the zoom buttons to slivers. */
+.top-bar .toolbar-tooltip-anchor:has(.agent-chip) {
+  min-width: 0;
+}
 
 .top-bar-title {
   font-size: 13px;
@@ -1104,14 +1115,46 @@ body,
   font-size: 11px;
   font-weight: 600;
   white-space: nowrap;
+  /* Rigid: the chip never shrinks and never lies about its min size (a
+     min-width: 0 here let BarHint anchors collapse under their chips, and
+     neighboring chips painted over each other). The .agent-chips wrapper is
+     the ONE squeeze point — it clips whole trailing chips at its edge. */
   flex-shrink: 0;
-  min-width: 0;
   max-width: 280px;
 }
+/* Many-agent bar (0.5.1 user feedback): the visible chips sit in ONE
+   clipping flex wrapper. Chips keep their natural readable width; when the
+   bar is overconstrained the WRAPPER shrinks and clips at its edge, so chip
+   content can never shove or paint over the census chip, the context meter,
+   or the zoom cluster (16 unshrinkable chips used to push the zoom controls
+   out of the bar and over the session panel). */
+.agent-chips {
+  display: inline-flex;
+  align-items: center;
+  gap: 12px;
+  min-width: 0;
+  overflow: hidden;
+}
+/* Rigid anchors: nested-flex min-content lets a BarHint anchor collapse
+   under its chip (ellipsizing spans zero the chip's min-content), and the
+   chip then paints into the next anchor. Only the wrapper above may give. */
+.agent-chips .toolbar-tooltip-anchor {
+  flex-shrink: 0;
+}
 .agent-chip.phase-idle {
   background: none;
   border-color: var(--c-line);
 }
+/* The census chip is the "how many" answer — it never compresses away. Its
+   BarHint anchor must hold width too: a shrinking anchor around an
+   unshrinkable chip lets the chip paint over the next bar item. */
+.agent-chip-more {
+  flex-shrink: 0;
+}
+.top-bar .toolbar-tooltip-anchor:has(.agent-chip-more) {
+  flex-shrink: 0;
+  min-width: max-content;
+}
 .agent-chip-dot {
   width: 7px;
   height: 7px;
@@ -1134,6 +1177,11 @@ body,
   font-weight: 400;
   color: var(--c-muted);
   white-space: nowrap;
+  /* Leaf-level truncation: a compressed chip must ellipsize the agent name,
+     never paint it past the pill (0.5.1 user feedback, many-agent bar). */
+  overflow: hidden;
+  text-overflow: ellipsis;
+  min-width: 0;
 }
 
 /* On-canvas cursor + phase chip (world layer; counter-scaled inner) */
@@ -1146,7 +1194,9 @@ body,
   top: 0;
   z-index: 9000;
   pointer-events: none;
-  transition: transform 220ms cubic-bezier(0.22, 1, 0.36, 1);
+  transition:
+    transform 220ms cubic-bezier(0.22, 1, 0.36, 1),
+    opacity 320ms ease;
   color: var(--presence-color);
 }
 .agent-cursor.is-worker {
@@ -1160,6 +1210,20 @@ body,
   font-size: 9px;
   padding: 1px 6px;
 }
+/* Idle cursors leave the board (user feedback, 0.5.1 cycle): with many agents
+   attached, a wall of parked "Idle" pills covers real node content. The
+   element stays MOUNTED — counts, twin-merge, and cursor-follow logic are
+   untouched, and visibility (not display) keeps its layout box so position
+   polls still resolve — but it paints nothing; any non-idle phase fades it
+   back in. Placed after .is-worker so opacity: 0 wins that collision. */
+.agent-cursor.phase-idle {
+  opacity: 0;
+  visibility: hidden;
+  transition:
+    transform 220ms cubic-bezier(0.22, 1, 0.36, 1),
+    opacity 320ms ease,
+    visibility 0s linear 320ms;
+}
 .agent-chip-workers {
   margin-left: 4px;
   padding: 0 5px;
@@ -1632,7 +1696,9 @@ body,
   flex-wrap: nowrap;
   gap: 1px;
   margin: 2px -12px 8px;
-  padding: 0 10px;
+  /* Compact panels (Amp portal, 0.5.0 report B): six chips overflowed the
+     row by 11px — tighter inset + chip padding buys ~16px back. */
+  padding: 0 8px;
   overflow-x: auto;
   scrollbar-width: none;
 }
@@ -1651,7 +1717,7 @@ body,
 }
 .session-timeline-filters .activity-filter {
   flex-shrink: 0;
-  padding: 2px 5px;
+  padding: 2px 4px;
 }
 
 .session-timeline-row {
@@ -2828,9 +2894,20 @@ body,
 }
 
 /* Pan tool / held Space: the world layer goes pointer-inert so drags land on
-   the viewport container itself and pan — nodes cannot swallow the drag. */
+   the viewport container itself and pan — nodes cannot swallow the drag.
+   user-select too: text selection sweeps straight through pointer-inert
+   content, and a selection made mid-pan later becomes a native text drag the
+   drop handler mints webpage nodes from (0.5.1 Amp finding D). */
 .canvas-viewport.pan-mode .canvas-world {
   pointer-events: none;
+  -webkit-user-select: none;
+  user-select: none;
+}
+/* The resize handle and connect ports carry their own pointer-events: auto,
+   which punches through the inert world — a pan started on them never pans. */
+.canvas-viewport.pan-mode .node-resize-handle,
+.canvas-viewport.pan-mode .node-port {
+  pointer-events: none;
 }
 .canvas-viewport.pan-mode:active {
   cursor: grabbing;