pmx-canvas 0.1.9 → 0.1.11

package/CHANGELOG.md

@@ -3,6 +3,158 @@
 All notable changes to `pmx-canvas` are documented here. This project follows
 [Semantic Versioning](https://semver.org/).
 
+## [0.1.11] - 2026-05-02
+
+Agent ergonomics + chart polish on top of 0.1.10. Adds a `--strict-size`
+mode for nodes that should scroll instead of auto-fit, surfaces
+`pmx-canvas json-render` and `pmx-canvas screenshot` as top-level CLI
+shortcuts, lets graph nodes hide legends and pie labels for compact
+tile layouts, propagates explicit geometry to reused MCP-app nodes, and
+folds Excalidraw bound text into container labels before sending it
+through the diagram MCP.
+
+### Added
+
+- **`--strict-size` / `--scroll-overflow` for node create and update.**
+  All node types now accept `strictSize` to keep the explicit
+  `width`/`height` frame fixed and scroll overflowing content instead of
+  letting the canvas auto-fit the node to its content. Surfaced through
+  CLI flags, HTTP `POST/PATCH /api/canvas/node`, dedicated json-render
+  and graph endpoints, and MCP tools (`canvas_add_node`,
+  `canvas_add_json_render_node`, `canvas_add_graph_node`).
+  `canvas_describe_schema` and `canvas://schema` advertise the field on
+  markdown, webpage, and graph entries with kebab-case aliases.
+- **`pmx-canvas json-render` top-level CLI command.** Agent-friendly
+  shortcut for the json-render schema/example explorer. Supports
+  `--schema`, `--summary`, `--component <name>`, `--field <name>`, and
+  `--example`/`--examples`, mirroring the existing `node schema --type
+  json-render` data in a more direct shape.
+- **`pmx-canvas screenshot` top-level CLI command.** Shorthand for
+  `pmx-canvas webview screenshot`, with the same `--output`,
+  `--format`, and `--quality` flags. Routes through the agent CLI like
+  the other top-level subcommands.
+- **`showLegend` / `showLabels` chart display flags.** Graph node
+  payloads now accept `showLegend` and `showLabels` booleans that
+  cascade through CLI (`--show-legend`, `--show-labels`), HTTP, MCP,
+  and the json-render chart components. Set `showLegend: false` for
+  compact tile dashboards or `showLabels: false` to hide pie slice
+  labels.
+- **Skill catches up to the new CLI surface.** The agent-facing
+  `skills/pmx-canvas/SKILL.md` now documents `pmx-canvas screenshot`,
+  `pmx-canvas json-render`, the `--strict-size` flag, and the chart
+  display flags, so agents do not have to discover them by reading the
+  CHANGELOG.
+
+### Changed
+
+- **Reused MCP-app nodes accept explicit geometry on reopen.** When
+  `canvas_open_mcp_app` (or the workbench `ext-app-open` SSE event)
+  reopens an existing mcp-app node and the call passes `x`, `y`,
+  `width`, or `height`, the server now applies that geometry to the
+  existing node instead of leaving the original frame in place. This
+  lets agents resize a previously created Excalidraw or other reusable
+  app node with a single call.
+- **Compact json-render charts trim whitespace.** Bar, line, area,
+  scatter, pie, radar, stacked-bar, and composed charts share new
+  `chartMargin`, `polarChartMargin`, `axisTickMargin`, and
+  `legendMargin` constants, so axis ticks and legends sit closer to the
+  plot and small graph nodes keep more of their frame for the actual
+  chart.
+- **Diagram preset folds bound text into container labels.** The
+  Excalidraw normalization path now collapses `text` elements that
+  reference a container into the container's `label` field (when the
+  container does not already carry a label) and removes the redundant
+  text element from the outgoing payload. This produces the in-shape
+  labels Excalidraw renders by default while still keeping the
+  bound-element references repaired from 0.1.10. The same normalization
+  also runs through `buildExcalidrawOpenMcpAppInput` so MCP `open`
+  payloads are repaired identically to checkpoint and tool-input
+  payloads.
+- **Diagram preset seeds defaults when nothing renderable is present.**
+  An elements array containing only deletion or camera-update entries
+  (or stale ghosts) now falls back to the default Excalidraw preset
+  instead of being sent as an empty diagram.
+
+### Internal
+
+- Regression coverage for: `--strict-size` end-to-end through CLI,
+  HTTP, and MCP plus the auto-fit guard that keeps strict-size content
+  nodes from being auto-fitted; top-level CLI routing for `screenshot`
+  and `json-render`; compact graph specs that hide legends and pie
+  labels; reused mcp-app open with explicit geometry; Excalidraw
+  defaults for non-renderable element arrays; shared MCP open
+  normalization through the diagram-preset path.
+
+## [0.1.10] - 2026-05-01
+
+Agent-ergonomics and correctness pass on top of 0.1.9. Tightens
+structured-frame auto-fit behavior, restores semantic Badge variants in
+json-render, repairs Excalidraw bound-text references on the way out,
+fixes `pmx-canvas fit` routing through the top-level CLI, and grows the
+`node update` surface with `--pinned` and `--node-height`.
+
+### Added
+
+- **`pmx-canvas node update --pinned <true|false>`.** Agents can flip a
+  node's pin state directly through `node update` without round-tripping
+  through `pin add`/`pin remove`. The flag goes through the same
+  PATCH path as the rest of `node update`, so it composes with geometry
+  and arrange-lock flags.
+- **`pmx-canvas node update --node-height` alias.** `--node-height` is now
+  accepted as an alias for `--height` on `node update`, matching the
+  alias already supported on `node add`. Passing both `--height` and
+  `--node-height` rejects with a clear error.
+- **AGENTS.md mirrors CLAUDE.md for harness-agnostic guidance.** The
+  AGENTS.md guidance file is now a complete, self-contained mirror of
+  the project instructions in CLAUDE.md so any coding agent harness
+  finds the same architecture rules, TypeScript guardrails, build
+  commands, and testing conventions.
+
+### Changed
+
+- **`pmx-canvas fit` routes through the top-level CLI.** The `fit`
+  subcommand was added to the agent dispatcher in 0.1.9 but was missing
+  from the top-level CLI's known-subcommand list, so `pmx-canvas fit`
+  was being treated as a server-startup invocation. It now routes to
+  the agent CLI like every other subcommand.
+- **All explicit graph and json-render frames are preserved by auto-fit.**
+  The client-side auto-fit guard previously only respected explicit
+  heights when they exceeded the 600px content-fit cap. It now treats
+  all `graph` and `json-render` nodes as having explicit visual frames,
+  so agent-authored sizes survive expand-and-close cycles regardless of
+  the chosen height.
+- **json-render Badge keeps semantic variants.** The 0.1.6 normalizer
+  that mapped `success`/`info`/`warning`/`error`/`danger` to the
+  shadcn-default `default`/`secondary`/`outline`/`destructive` set has
+  been removed. The json-render catalog now declares these variants as
+  first-class, and the bundled renderer ships a Badge component that
+  styles them, so dashboards keep their intended traffic-light
+  semantics instead of collapsing to a generic neutral palette.
+
+### Fixed
+
+- **Group containment accepts the canonical children list.** Layout
+  validation flagged group/child overlaps as containment violations
+  whenever the child only carried `parentGroup` via the parent's
+  `children` array instead of the back-reference field. The check now
+  treats either side of the relationship as authoritative, so grouped
+  nodes pinned via `data.children` are no longer reported as overlap
+  violations.
+- **Excalidraw tool input repairs one-sided bound-text references.**
+  When a text element points at a container via `containerId` but the
+  container's `boundElements` list is missing the reverse pointer, the
+  diagram preset now reattaches the missing reference before sending
+  the elements to the Excalidraw MCP app. This stops labels from
+  silently dropping out of agent-authored diagrams.
+
+### Internal
+
+- Regression coverage for: structured-frame auto-fit preservation across
+  graph and json-render heights (including small frames), `node update
+  --pinned` end-to-end through CLI/HTTP, top-level CLI routing for the
+  `fit` subcommand, group-children list containment validation, and
+  Excalidraw bound-text repair on the diagram preset.
+
 ## [0.1.9] - 2026-05-01
 
 Workflow ergonomics pass for agent-authored boards. This release tightens
@@ -164,6 +316,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.11]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.11
+[0.1.10]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.10
 [0.1.9]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.9
 [0.1.8]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.8
 [0.1.7]: https://github.com/pskoett/pmx-canvas/releases/tag/v0.1.7