pmx-canvas 0.4.5 → 0.4.6

package/CHANGELOG.md

@@ -3,6 +3,61 @@
 All notable changes to `pmx-canvas` are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## [0.4.6] - 2026-08-08
+
+### Added
+
+- A `pmx-canvas smoke` command: one-command check that a running canvas works
+  in the current environment — server health + workspace, CLI/server version
+  skew, MCP initialize handshake, a temporary node create/search/remove
+  round-trip, and board validation. JSON report, exit 1 on failure.
+- The `/health` endpoint now reports the server's package `version`, so tools
+  can detect version skew between a CLI and the daemon it targets.
+- The CLI now accepts `--agent-id` on `ax work add/update` and `ax event add`,
+  and `--agent-id` / `--target` on `ax steer`; the SDK's work, event, and
+  steering methods accept the same identity fields.
+- The skill now teaches in-view placement and content sizing: focus or fit
+  newly created user-facing nodes, use per-type default sizes, and keep AX
+  state reads lean.
+- A new `diff` node type: unified diffs render with per-file headers, hunk
+  rows, and colored added/removed lines instead of a plain code fence.
+- A new `mermaid` node type: flowcharts, sequence and state diagrams render
+  client-side from mermaid text — no hosted app needed; Excalidraw remains
+  for interactive drawing.
+- A live work-item board: `canvas_render { action: "workboard" }` (HTTP
+  `POST /api/canvas/workboard`) materializes one board node showing all AX
+  work items by status, and it refreshes automatically whenever work items
+  change.
+
+### Changed
+
+- **Nodes created with unreadably small explicit sizes are now clamped up to a
+  per-type minimum.** A request for e.g. 200x100 now yields a readable
+  default-ish size instead; pass `strictSize: true` to keep a genuinely small
+  fixed frame. `validate` reports any undersized nodes as advisory size
+  warnings. Agents doing their own layout arithmetic should read back the
+  created size (or set `strictSize`).
+- The README's MCP and Amp orb setup guides now cover portable configs: pin
+  the package version in orb setup scripts and avoid hard-coding an absolute
+  `PMX_CANVAS_WORKSPACE_ROOT` in committed MCP configs.
+- Focus margins are now screen-space and zoom-aware, so a focused node clears
+  the floating toolbar at any scale.
+
+### Fixed
+
+- A browser panel left open across a `pmx-canvas` upgrade now reloads itself
+  once on reconnect instead of silently running the old client bundle (which
+  hid new client behavior such as the auto-ghost minimum dwell).
+- A batch that pins nodes now updates the browser's pin state immediately —
+  the context menu no longer shows a stale "Pin as context" until reload.
+- The MCP stdio server now exits when its client closes the connection instead
+  of remaining as an orphaned process.
+- Black app tiles in WebKit host panels (e.g. the GitHub Copilot app): hosted
+  app frames now boot one at a time, confirm they actually painted via a paint
+  probe, and recover automatically when they did not — soft resize, then
+  remount, then an explicit Retry button instead of a silent black tile. The
+  loading overlay stays up until the paint is confirmed.
+
 ## [0.4.5] - 2026-08-07
 
 ### Added
@@ -2989,6 +3044,7 @@ 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.6]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.4.6
 [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

package/Readme.md

@@ -228,7 +228,21 @@ Add to your agent's MCP config:
 }
 ```
 
-The canvas auto-starts on first tool call.
+The canvas auto-starts on first tool call. Keep the config portable: commit it
+to the repo and let the workspace default to the launch directory — hard-coding
+an absolute `PMX_CANVAS_WORKSPACE_ROOT` breaks other checkouts and machines.
+Set that env var only when your host spawns the MCP server from an incidental
+directory (e.g. `~/.copilot`) instead of the project root.
+
+Verify any environment in one command against a running server:
+
+```bash
+bunx pmx-canvas smoke
+```
+
+It checks server health + workspace, CLI/server version skew, the MCP stdio
+initialize handshake, a temp-node create/search/remove round-trip, and board
+validation — JSON report, exit 1 on failure.
 
 ### Use inside the GitHub Copilot app
 
@@ -274,8 +288,9 @@ services:
 ```
 
 ```bash
-# .agents/setup — install the CLI (pin the version for reproducible starts)
-npm install -g pmx-canvas@latest
+# .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.4.5
 ```
 
 The server binds the portal-assigned `$PORT` automatically (gated on the
@@ -291,7 +306,9 @@ inline via `srcdoc` with their theme styling included. Cross-origin hosted
 apps (e.g. the hosted Excalidraw MCP app) cannot be inlined and may stay
 blocked by the portal embed — everything served from the canvas itself works.
 Debug overrides: `/workbench?transport=poll|sse` and
-`?iframe-mode=srcdoc|src`.
+`?iframe-mode=srcdoc|src`. Once the service is up, `pmx-canvas smoke` verifies
+the whole stack (health, versions, MCP handshake, node lifecycle, validation)
+in one command.
 
 ### Install the agent skill (recommended)
 

package/dist/canvas/global.css

@@ -1895,6 +1895,74 @@ html.is-node-resizing .ext-app-preview-catcher {
   }
 }
 
+/* Diff nodes — unified diff viewer with per-file sections */
+.diff-node {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  height: 100%;
+  overflow: auto;
+  font-family: var(--mono);
+  font-size: 12px;
+  color: var(--c-text);
+}
+
+.diff-node.diff-node-empty {
+  align-items: center;
+  justify-content: center;
+  color: var(--c-muted);
+}
+
+.diff-node .diff-file {
+  border: 1px solid var(--c-line);
+  border-radius: 6px;
+  overflow: hidden;
+  flex-shrink: 0;
+}
+
+.diff-node .diff-file-header {
+  padding: 4px 8px;
+  background: var(--c-panel-overlay);
+  border-bottom: 1px solid var(--c-line);
+  color: var(--c-text-soft);
+  font-weight: 600;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.diff-node .diff-lines {
+  margin: 0;
+  padding: 4px 0;
+  overflow-x: auto;
+  font-family: inherit;
+  font-size: inherit;
+  line-height: 1.5;
+}
+
+.diff-node .diff-lines > div {
+  padding: 0 8px;
+  white-space: pre;
+}
+
+.diff-node .diff-hunk {
+  color: var(--c-muted);
+}
+
+.diff-node .diff-line-add {
+  color: var(--c-ok);
+  background: var(--c-ok-10);
+}
+
+.diff-node .diff-line-remove {
+  color: var(--c-danger);
+  background: var(--c-danger-12);
+}
+
+.diff-node .diff-line-context {
+  color: var(--c-text-soft);
+}
+
 /* Docked node — compact toolbar-flanking panel */
 .docked-node {
   min-width: 200px;