pmx-canvas 0.5.1 → 0.6.2

package/CHANGELOG.md

@@ -3,6 +3,56 @@
 All notable changes to `pmx-canvas` are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## [0.6.2] - 2026-09-09
+
+### Changed
+
+- Double-left-click opens the board, node, or edge menu; right-button dragging pans with a grabbing-hand cursor, while single-left-click still selects.
+- Rename nodes through their action menu instead of double-clicking the title.
+- The Session panel starts compact, opens for pending approvals, and closes after they settle unless the user opened it manually.
+- Skill guidance distinguishes product-source testing from consumer testing and requested app dimensions from persisted post-mount sizes.
+
+### Fixed
+
+- Focusing a node stays clear of the minimap and command bar instead of being interrupted by server layout or window-size updates.
+- Relative file paths resolve against the configured workspace rather than the daemon's process directory.
+- Published artifact builds automatically clear a corrupted Parcel cache and retry once; genuine build errors still fail.
+- Expanded embedded apps accept their first click reliably during loading in Chromium.
+- The extreme resize corner is hittable, and all timeline filter chips fit on one row.
+- WebView startup errors now retain the Chrome constructor failure in `lastError`.
+
+### Known limitations
+
+- Native Copilot/WebKit Excalidraw tiles can still appear blank despite a successful paint probe; expand-close remains a workaround, not a confirmed first-render fix.
+
+## [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).

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
@@ -32,7 +36,7 @@ communication — proximity means relatedness, pinning means *focus here*.
 Drag, group, arrange, and **pin** nodes spatially. Connect nodes with typed
 edges — flow, depends-on, relation, references — drawn as smooth curves that
 leave each card perpendicular to its border and bend toward their target.
-Edges stay editable in place: right-click one to relabel, retype, restyle, or
+Edges stay editable in place: double-click one to relabel, retype, restyle, or
 delete it, or click it and press Delete. Curation is the channel
 from human intent to agent context — the agent reads `canvas://pinned-context`
 and `canvas://spatial-context` (proximity clusters, reading order, pinned
@@ -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.1
+npm install -g pmx-canvas@0.6.2
 ```
 
 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;
@@ -1313,7 +1377,7 @@ body,
   animation: session-panel-in 180ms ease;
 }
 .session-panel.is-collapsed {
-  width: 28px;
+  width: 40px;
   align-items: center;
   padding-top: 10px;
   gap: 10px;
@@ -1326,6 +1390,17 @@ body,
   text-transform: uppercase;
   color: var(--c-dim);
 }
+.session-collapsed-live {
+  display: inline-flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  font: 9px var(--mono);
+  color: var(--c-dim);
+}
+.session-collapsed-live .session-live-dot {
+  background: var(--c-ok);
+}
 
 .session-panel-header {
   height: var(--hud-bar-height);
@@ -1653,7 +1728,7 @@ body,
 }
 .session-timeline-filters .activity-filter {
   flex-shrink: 0;
-  padding: 2px 4px;
+  padding: 2px 3px;
 }
 
 .session-timeline-row {
@@ -2830,9 +2905,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;
@@ -3670,6 +3756,12 @@ body,
 }
 
 /* Node resize handle */
+.canvas-node:has(.node-resize-handle) {
+  /* Keep the four-pixel corner grab inside the shell's inner clip, not on
+     its rounded border. The other corners retain the standard card radius. */
+  border-bottom-right-radius: 8px;
+}
+
 .canvas-node .node-resize-handle {
   position: absolute;
   bottom: 0;
@@ -3714,7 +3806,9 @@ html.is-node-dragging .attention-field-layer {
 }
 
 html.is-node-dragging,
-html.is-node-dragging * {
+html.is-node-dragging *,
+html.is-canvas-panning,
+html.is-canvas-panning * {
   cursor: grabbing !important;
   user-select: none !important;
   -webkit-user-select: none !important;