pmx-canvas 0.3.2 → 0.3.4

package/CHANGELOG.md

@@ -3,6 +3,73 @@
 All notable changes to `pmx-canvas` are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## [0.3.4] - 2026-08-03
+
+### Added
+
+- A client component test harness (happy-dom + Testing Library) with the
+  first 20 render tests, plus dedicated suites for the semantic watch
+  reducer and the canvas schema (46 new tests). Test files are now
+  typechecked, and CI fails when total coverage drops below the recorded
+  floor.
+
+### Fixed
+
+- App tiles now show a spinner and a "Connecting to <app>..." overlay while an
+  app frame boots or recovers, instead of a dark tile body (0.3.3 report: the
+  transient black window during automatic recovery).
+- Composite tools now name the missing field when a required argument for the
+  chosen action is absent, instead of failing deep in the handler or silently
+  doing nothing.
+- A pending code-graph recompute timer no longer outlives its server across
+  start/stop cycles.
+
+### Changed
+
+- The sandboxed-surface AX bridge (the listener that validates and submits
+  iframe interactions) is now one shared implementation across html, app, and
+  viewer nodes, with the protocol tags defined in a single module. No behavior
+  change — this hardens a security boundary that was previously copy-pasted.
+- The CLI dispatches every canvas command through the operation registry's
+  HTTP invoker instead of hand-written request paths; success output is
+  unchanged. One failure-path improvement: a failed `pmx-canvas batch` now
+  prints the full result envelope (`ok:false`, `failedIndex`, partial
+  `results`, `refs`) on stdout and exits 1, instead of a bare stderr error.
+
+### Docs
+
+- WebView backend preflight: prefer webkit on macOS; the chrome backend can
+  show an "Allow remote debugging?" dialog that must be approved promptly, and
+  `PMX_CANVAS_WEBVIEW_TIMEOUT_MS` can be raised for slow starts.
+- Skill evals: the two file-node eval prompts now reference the bundled
+  fixture paths, so a literal eval run works in any workspace.
+- Web-artifact builds are documented as POSIX-only (the build pipeline runs
+  bash scripts); already-built artifacts render on every platform.
+- All `PMX_*` environment variables are documented in
+  [`docs/environment.md`](docs/environment.md).
+
+## [0.3.3] - 2026-07-08
+
+### Fixed
+
+- App tiles that load while a WebKit host panel is hidden now retry their
+  repaint when the panel becomes visible, instead of staying black until a
+  manual expand-and-close (0.3.2 report Finding N; best-effort — the manual
+  recovery still applies).
+- The WebKit repaint watchdog no longer remount-loops apps that boot without
+  sending an initialized handshake.
+- `HEAD` requests to graph and json-render surface URLs now answer like `GET`
+  instead of returning 404 (Finding O).
+- `serve status` now reports the pid actually serving the port and marks a
+  stale pid file explicitly, instead of the confusing `running: true,
+  pidRunning: false` combination after a host adapter respawn (Finding P).
+
+### Added
+
+- Black-tile diagnostics: the canvas mirrors its app-recovery trail to the
+  server; read it at `GET /api/canvas/debug/ext-app-recovery` when reporting a
+  rendering issue from a host panel.
+
 ## [0.3.2] - 2026-07-08
 
 ### Added
@@ -2712,6 +2779,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.3.4]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.3.4
+[0.3.3]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.3.3
 [0.3.2]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.3.2
 [0.3.1]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.3.1
 [0.3.0]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.3.0

package/Readme.md

@@ -107,7 +107,8 @@ the DB so SQLite WAL data is checkpointed into the file.
 
 Harness-agnostic. Drive the canvas from [MCP](docs/mcp.md) (27 tools,
 14 resources, change notifications), the [CLI](docs/cli.md), the
-[HTTP API](docs/http-api.md), or the [Bun SDK](docs/sdk.md). Works with
+[HTTP API](docs/http-api.md), or the [Bun SDK](docs/sdk.md) — all
+[environment variables documented here](docs/environment.md). Works with
 Claude Code, GitHub Copilot CLI, Codex, Cursor, Windsurf, or any agent
 that can spawn an MCP stdio server, call a CLI, or hit an HTTP endpoint.