pmx-canvas 0.1.30 → 0.1.32

package/CHANGELOG.md

@@ -3,6 +3,121 @@
 All notable changes to `pmx-canvas` are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## [Unreleased]
+
+## [0.1.32] - 2026-06-07
+
+### Added
+
+- **Composable AX surfaces (emit + reflect).** AX-enabled `html`, `json-render`,
+  and `web-artifact` nodes can now both EMIT AX interactions and RENDER live AX
+  state, so an agent (or human) can build an interactive work board / review board
+  / inbox as a canvas node. The canvas seeds each surface with a compact AX
+  snapshot and pushes live updates over the existing nonce-validated postMessage
+  channel: `html` exposes `window.PMX_AX.state` + a `pmx-ax-update` event;
+  `json-render` binds the snapshot under `/ax` (e.g. `{ "$state": "/ax/workItems" }`);
+  `web-artifact` gets the same `window.PMX_AX` bridge injected at the `/artifact`
+  route. New `GET /api/canvas/ax/surface-snapshot`. See the "Building an AX
+  surface" section in the pmx-canvas skill.
+- **AX opt-in via MCP/SDK (report #42).** `canvas_add_html_node` and
+  `canvas_update_node` accept an `axCapabilities` parameter ({ enabled, allowed })
+  so an agent can turn an html node into an AX surface without hand-crafting raw
+  HTTP — the previously-missing opt-in that made the (already-working) AX bridge
+  look broken. Clamped to the node-type ceiling server-side; cannot escalate.
+  (#42 was not a missing listener — the emit bridge + listeners already existed
+  and are e2e-verified.)
+- **Open in system browser.** A node-header / expanded-overlay "Open in system
+  browser" action (and `POST /api/canvas/open-external`) opens a node's surface in
+  the real OS browser via the existing launcher — for hosts (e.g. Codex) whose
+  embedded browser makes a normal new tab feel in-place. Accepts only `{ nodeId }`
+  (opens this server's own surface URL — no arbitrary-URL launch), honors
+  `PMX_CANVAS_DISABLE_BROWSER_OPEN`, and falls back to a normal new tab.
+
+### Changed
+
+- **Responsive top HUD (report #41).** The toolbar + docked status/context pills
+  now wrap instead of clipping in narrow embedding panels (e.g. the Copilot side
+  panel); low-value text (session id, zoom %, counts) is hidden below ~720px.
+
+### Fixed
+
+- **Body-only review annotations succeed (report #39).** `ax.review.add` /
+  `canvas_add_review_annotation` with only a `body` (no `anchorType`, no `nodeId`)
+  now creates an unanchored note instead of returning 400 — `anchorType` defaults
+  to a node anchor only when a usable `nodeId` is present. An explicit bad node
+  anchor still rejects.
+- **CLI can undock a node (report #40).** `pmx-canvas node update --dock-position
+  left|right|none` docks/undocks a node (`none` → `null`). The previous
+  `--data '{"dockPosition":null}'` never worked because `--data` is reserved for
+  graph datasets; the CLI had no path mapping it to the top-level field.
+
+### Removed
+
+- **Status node "Track as work" button.** Tracking a status signal as a work item
+  produced a thin, auto-titled item (often just "idle") with no visible effect on
+  the board and no proactive agent reaction — confusing UI for little value. The
+  underlying AX work-item primitive (`ax.work.create`) is unchanged and still
+  available to agents, the SDK/MCP/HTTP API, and authored AX surfaces
+  (json-render/HTML bridges) — the better home for a deliberate, in-canvas
+  work-item/steering experience.
+
+## [0.1.31] - 2026-06-07
+
+### Added
+
+- **Default docked status + context widgets.** A freshly opened canvas now shows
+  the agent's status widget docked at the left of the top menu and the context
+  widget docked at the right — flanking the toolbar as one continuous bar at the
+  same height. They are the same `status-main` / `context-main` nodes the
+  agent-event path already creates, just present from the start. Each collapsed
+  widget has an expand (▸) and an undock (⊙) control; undocking returns it to the
+  canvas as a normal node. Seeded **once on first run** (brand-new workspace
+  only) — never added to a canvas that already has content, and deleting or
+  undocking them is remembered (they are not re-seeded). `--demo` is unaffected
+  (it seeds the demo board instead).
+
+### Changed
+
+- **Collapsed docked widgets match the toolbar height.** The collapsed context
+  widget now renders inline in the top HUD row (mirroring the status widget)
+  instead of as a separate right-edge side-tab, and a shared `--hud-bar-height`
+  keeps the toolbar and both docked pills at an identical height.
+
+### Fixed
+
+- **Context nodes can be undocked.** Previously a `context` node was re-forced to
+  `dockPosition: 'right'` on every write, so it could never leave the dock. The
+  right-docked collapsed default is now applied at create time only; updates
+  (including undock → `dockPosition: null`) are respected.
+
+- **SDK node-response parity (report #31/#32).** `PmxCanvas.addNode`, `getNode`,
+  and `addHtmlNode` now return the fully serialized node enriched with a
+  `surfaceUrl` (for surface-eligible types) and a `nodeId` alias for `id`,
+  matching the HTTP/CLI `node`-create responses field-for-field. `addHtmlNode`
+  now returns the created node object instead of a bare id string (consistent
+  with `addNode`); read `.id` if you only need the identifier. The internal
+  `CanvasAccess` contract is unchanged (still returns a bare id).
+
+- **HTML "Open as site" tab title (report #35).** The standalone surface document
+  for an `html` node now carries a `<title>` (the node title) when the author
+  HTML does not already declare one, so the browser tab shows the node title
+  instead of falling back to the raw `/api/canvas/surface/<id>` URL. An
+  author-provided `<title>` is never overridden, and the injected title is
+  HTML-escaped.
+
+### Notes
+
+- **Report #33/#34/#36 — not reproduced.** #33 (elicitation/mode immediate
+  resolve) and #34 (delivery "claim" route) were already closed by the tester's
+  Codex retest as wrong-route repros. #36 (CLI emitting invalid JSON for html
+  primitives) does not reproduce: all 19 primitive kinds return valid JSON
+  through both `pmx-canvas html primitive add | jq` and raw `curl | jq`, with
+  zero unescaped control characters — the CLI re-serializes via `JSON.stringify`
+  and the server uses `Response.json`, both of which always escape U+0000–U+001F.
+  The full rendered HTML body is intentionally retained in the create response
+  (it is relied upon by consumers and renderer tests; agents wanting a compact
+  payload can use the MCP tool, which is already compact by default).
+
 ## [0.1.30] - 2026-06-07
 
 ### Added
@@ -1575,6 +1690,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.1.32]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.32
+[0.1.31]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.31
 [0.1.30]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.30
 [0.1.29]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.29
 [0.1.28]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.28

package/dist/canvas/global.css

@@ -56,6 +56,10 @@
   --mono: "IBM Plex Mono", "SF Mono", "Fira Code", monospace;
   --radius: 10px;
   --radius-sm: 6px;
+  /* Shared height for the top HUD row so the toolbar and the collapsed docked
+     status/context widgets that flank it line up to the same height. Matches the
+     toolbar's natural content height (icon buttons at 6px padding). */
+  --hud-bar-height: 44px;
 }
 
 :root[data-theme="light"] {
@@ -453,13 +457,15 @@ body,
   font-weight: 600;
 }
 
-/* HUD layer — fixed row: [left-dock] [toolbar] [right-dock] */
+/* HUD layer — [left-dock] [toolbar] [right-dock]. Wraps onto multiple rows in a
+   narrow embedding panel (e.g. the Copilot side panel) instead of clipping. */
 .hud-layer {
   position: fixed;
   top: 12px;
   left: 12px;
   right: 12px;
   display: flex;
+  flex-wrap: wrap;
   align-items: flex-start;
   justify-content: center;
   gap: 8px;
@@ -472,20 +478,24 @@ body,
 .hud-left,
 .hud-right {
   display: flex;
+  flex-wrap: wrap;
   gap: 8px;
 }
 
 /* Toolbar */
 .canvas-toolbar {
   display: flex;
+  flex-wrap: wrap;
   align-items: center;
   gap: 6px;
   padding: 6px 10px;
+  min-height: var(--hud-bar-height);
+  max-width: 100%;
+  box-sizing: border-box;
   background: var(--c-panel-glass);
   backdrop-filter: blur(12px);
   border: 1px solid var(--c-line);
   border-radius: var(--radius);
-  flex-shrink: 0;
 }
 
 .toolbar-tooltip-anchor {
@@ -660,9 +670,11 @@ body,
 
 .toolbar-group {
   display: flex;
+  flex-wrap: wrap;
   align-items: center;
   gap: 6px;
-  flex-shrink: 0;
+  min-width: 0;
+  max-width: 100%;
 }
 
 .canvas-toolbar button svg {
@@ -686,6 +698,15 @@ body,
   }
 }
 
+/* Narrow embedding panels: drop low-value text from the HUD so the icon controls
+   fit in fewer rows. Buttons keep their aria-labels + tooltips, so nothing is
+   lost for a11y or discovery. */
+@media (max-width: 720px) {
+  .hud-collapsible-text {
+    display: none;
+  }
+}
+
 /* Raw markdown source editor */
 .md-editor-split {
   display: flex;
@@ -1409,6 +1430,38 @@ html.is-node-resizing .ext-app-preview-catcher {
   max-width: 320px;
 }
 
+/* Collapsed docked widget = a single menu-height pill that flanks the toolbar.
+   Pinned to the same height as .canvas-toolbar so the top HUD row reads as one
+   continuous bar (status on the left, context on the right). */
+.docked-node--collapsed {
+  height: var(--hud-bar-height);
+  box-sizing: border-box;
+  justify-content: center;
+  width: auto;
+  /* Reset the base .docked-node min-width so the collapsed pill hugs its content
+     (badge + count + controls) instead of stretching to a 200px bar. */
+  min-width: 0;
+}
+.docked-node--collapsed .docked-node-header {
+  height: 100%;
+  padding: 0 10px;
+  border-bottom: none;
+}
+.docked-node-count {
+  min-width: 18px;
+  height: 18px;
+  padding: 0 5px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 9px;
+  background: var(--c-accent);
+  color: var(--c-contrast-fg);
+  font-size: 10px;
+  font-weight: 700;
+  flex-shrink: 0;
+}
+
 .docked-node-header {
   display: flex;
   align-items: center;
@@ -1948,62 +2001,6 @@ html.is-node-resizing .ext-app-preview-catcher {
   max-width: 200px;
 }
 
-/* Context dock — collapsed pill mirrors Updates pill, sits above it */
-.context-dock-tab {
-  position: fixed;
-  top: 92px;
-  right: 0;
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  padding: 8px 12px 8px 14px;
-  background: color-mix(in srgb, var(--c-panel-glass) 96%, transparent);
-  backdrop-filter: blur(16px);
-  border: 1px solid color-mix(in srgb, var(--c-line) 82%, var(--c-accent) 18%);
-  border-right: 0;
-  border-radius: 14px 0 0 14px;
-  box-shadow: 0 12px 36px var(--c-shadow);
-  color: var(--c-text);
-  cursor: pointer;
-  font: inherit;
-  font-size: 11px;
-  font-weight: 600;
-  letter-spacing: 0.08em;
-  text-transform: uppercase;
-  z-index: 60;
-}
-
-.context-dock-tab:hover {
-  border-color: color-mix(in srgb, var(--c-accent) 40%, var(--c-line) 60%);
-  color: var(--c-accent);
-}
-
-.context-dock-tab svg {
-  display: block;
-  color: var(--c-accent);
-  flex-shrink: 0;
-}
-
-.context-dock-tab-label {
-  white-space: nowrap;
-}
-
-.context-dock-tab-badge {
-  min-width: 18px;
-  height: 18px;
-  padding: 0 5px;
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  border-radius: 9px;
-  background: var(--c-accent);
-  color: var(--c-contrast-fg);
-  font-size: 10px;
-  font-weight: 700;
-  letter-spacing: 0;
-  text-transform: none;
-}
-
 /* Context dock — expanded panel anchored top-right edge.
    Mutually exclusive with the Updates panel (see DockedNode.tsx and
    AttentionHistory.tsx) — opening one collapses the other, so they can both