@1agh/maude 1.4.5 → 1.5.0

package/apps/studio/whats-new.json

@@ -1,6 +1,69 @@
 {
   "$schema": "./whats-new.schema.json",
   "entries": [
+    {
+      "id": "whiteboard-text-sections-live-previews",
+      "version": "1.5.0",
+      "date": "2026-09-30",
+      "kind": "improvement",
+      "title": "Smoother whiteboard editing, live together",
+      "summary": "Typing in stickies and shapes now wraps exactly as it will look, works with any input method (accents, Japanese), and is never lost — it reaches teammates within a second, and if someone deletes the note you are typing in, Enter puts it back with your text. Sections move, copy and delete together with everything in them, teammates see your drag or resize live before you let go, and undo only takes back your own changes.",
+      "surface": "design-ui"
+    },
+    {
+      "id": "whiteboard-edits-sync-per-element",
+      "version": "1.5.0",
+      "date": "2026-09-30",
+      "kind": "improvement",
+      "title": "Whiteboard edits no longer overwrite each other",
+      "summary": "Each sticky, shape and arrow now saves on its own, so two people editing the same board keep both changes, and even text typed into the same sticky at once is merged. Existing boards convert automatically on start, and editing text is steadier: the cursor stays on a new line after Shift+Enter, double-clicking a word selects it, and Shift+click removes an item from a selection.",
+      "surface": "design-ui"
+    },
+    {
+      "id": "file-tree-remembers-folders",
+      "version": "1.5.0",
+      "date": "2026-09-30",
+      "kind": "improvement",
+      "title": "The file tree remembers your folders",
+      "summary": "The Files panel now starts collapsed and keeps the folders you open, even after you switch panels, reload or restart the app. Opening a canvas unfolds the way to it.",
+      "surface": "design-ui"
+    },
+    {
+      "id": "comments-stay-where-you-put-them",
+      "version": "1.4.6",
+      "date": "2026-09-30",
+      "kind": "fix",
+      "title": "Comments stay where you put them",
+      "summary": "A comment on a sticky, a drawing or empty canvas no longer disappears a few seconds after you save it. A comment on a sticky moves with it, and if the thing it points at is deleted the comment stays, marked as detached, until you remove it.",
+      "surface": "design-ui"
+    },
+    {
+      "id": "comments-reach-every-peer",
+      "version": "1.4.6",
+      "date": "2026-09-30",
+      "kind": "fix",
+      "title": "Web comments reach the desktop app",
+      "summary": "Comments added on the web while your desktop app was closed now show up when you reopen it, and a comment deleted elsewhere no longer comes back.",
+      "surface": "design-ui"
+    },
+    {
+      "id": "large-boards-pan-smoothly",
+      "version": "1.4.6",
+      "date": "2026-09-30",
+      "kind": "improvement",
+      "title": "Large boards pan smoothly again",
+      "summary": "Panning a board with many artboards stays smooth while something is selected or a teammate is on the canvas — on the desktop app it could drop to a frame a second.",
+      "surface": "design-ui"
+    },
+    {
+      "id": "sync-no-phantom-waiting-files",
+      "version": "1.4.6",
+      "date": "2026-09-30",
+      "kind": "fix",
+      "title": "Sync stops counting files that are done",
+      "summary": "The Sync panel no longer shows files as waiting or stuck when there is nothing left to deliver, and Resync now brings down a file the project changed while you were uploading it.",
+      "surface": "design-ui"
+    },
     {
       "id": "team-projects-hold-up",
       "version": "1.4.5",

package/cli/lib/design-link.mjs

@@ -809,7 +809,11 @@ function collectAdoptManifest(cwd) {
   const files = [];
   try {
     for (const f of readdirSync(base)) {
-      if (f.endsWith('.html') || f.endsWith('.annotations.svg')) {
+      if (
+        f.endsWith('.html') ||
+        f.endsWith('.annotations.json') ||
+        f.endsWith('.annotations.svg')
+      ) {
         try {
           files.push({ rel: `.design/${f}`, bytes: statSync(resolve(base, f)).size });
         } catch {

package/cli/lib/gitignore-block.mjs

@@ -25,7 +25,7 @@ export function buildBlock(designRel = '.design', { s3Assets = false } = {}) {
   // The canonical IGNORED set is the DDR-115 runtime-state taxonomy — kept in
   // lockstep with `apps/studio/git/service.ts` (isMaudeRuntimeState backstop)
   // and the repo's own `.gitignore`. VERSIONED content (canvases, `.meta.json`,
-  // `*.annotations.svg`, `system/**`, `config.json`) is deliberately absent.
+  // `*.annotations.json` (v1 `.svg`), `system/**`, `config.json`) is deliberately absent.
   const lines = [
     BEGIN_MARKER,
     '# Maude design plugin runtime — gitignored even in linked mode (DDR-056/DDR-115).',

package/cli/lib/gitignore-drift.mjs

@@ -37,7 +37,8 @@
  * `gitignore-block.mjs` and the taxonomy in `apps/studio/git/service.ts`.
  */
 const VERSIONED_PATTERNS = [
-  { pattern: '*.annotations.svg', what: 'canvas draw layers (annotations)' },
+  { pattern: '*.annotations.json', what: 'canvas draw layers (annotations)' },
+  { pattern: '*.annotations.svg', what: 'canvas draw layers (annotations, v1 form)' },
   { pattern: '*.meta.json', what: 'canvas sidecars (layout, artboards, tags)' },
   { pattern: '*.tsx', what: 'canvas bodies' },
   { pattern: 'config.json', what: 'the project design config' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1agh/maude",
-  "version": "1.4.5",
+  "version": "1.5.0",
   "description": "Marketplace of Claude Code plugins by Michal Dovrtěl: `design` (canvas-first design iteration) + `flow` (generic agentic workflow loop with .ai second brain). Ships the `maude` CLI (with `mdcc` legacy alias) to scaffold workspace, run the design dev server, and manage configs.",
   "type": "module",
   "engines": {
@@ -58,13 +58,13 @@
     "test:e2e:desktop:parity:cloud": "pnpm --filter @maude/desktop-e2e e2e:parity:cloud"
   },
   "optionalDependencies": {
-    "@1agh/maude-darwin-arm64": "1.4.5",
-    "@1agh/maude-darwin-x64": "1.4.5",
-    "@1agh/maude-linux-arm64": "1.4.5",
-    "@1agh/maude-linux-arm64-musl": "1.4.5",
-    "@1agh/maude-linux-x64": "1.4.5",
-    "@1agh/maude-linux-x64-musl": "1.4.5",
-    "@1agh/maude-win32-x64": "1.4.5"
+    "@1agh/maude-darwin-arm64": "1.5.0",
+    "@1agh/maude-darwin-x64": "1.5.0",
+    "@1agh/maude-linux-arm64": "1.5.0",
+    "@1agh/maude-linux-arm64-musl": "1.5.0",
+    "@1agh/maude-linux-x64": "1.5.0",
+    "@1agh/maude-linux-x64-musl": "1.5.0",
+    "@1agh/maude-win32-x64": "1.5.0"
   },
   "files": [
     "cli",
@@ -131,6 +131,7 @@
     "@decimalturn/toml-patch": "3.0.5",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
+    "diff": "8.0.4",
     "happy-dom": "20.10.6",
     "svgo": "^4.0.1",
     "yaml": "2.9.0"

package/plugins/design/templates/brief-board.tsx.template

@@ -13,7 +13,7 @@
  * a VERBATIM brief and inserts the matching generated artboards right here, below
  * this frame — the board becomes a living brief you sketch and Claude fills in.
  *
- * The annotation layer lives in a sibling `<slug>.annotations.svg` (NEVER in this
+ * The annotation layer lives in a sibling `<slug>.annotations.json` (NEVER in this
  * file), so your notes stay floating on top across every regeneration. No design
  * system tokens or classes are wired in — the board is a neutral surface; the
  * generated artboards bring the DS with them on ingest.

package/apps/studio/annotation-edit-base.ts

@@ -1,36 +0,0 @@
-// Which SVG an annotation edit names as its base (DDR-241 accepted revisions).
-//
-// The project merges an annotation proposal element by element against the
-// text it was derived from. The canvas used to send the CANONICAL
-// re-serialization of the strokes it held — fine while the stored text is
-// canonical too, and silently fatal when it is not: an element written by an
-// older serializer, a hand edit or any other writer then looks changed on BOTH
-// sides, the merge refuses it as a conflict, and the person's edit is reverted
-// without a word (plan T31, L09 arrowheads on a non-canonical arrow).
-//
-// An edit made on exactly the state this canvas last RECEIVED names the text
-// it received — the project then sees "nothing changed underneath", accepts
-// the edit whole, and the stored text becomes canonical as a side effect. Any
-// other state (edits stacked before the echo returns) is this canvas's own
-// canonical output, which is what the project holds after accepting it.
-
-import { type Stroke, strokesToSvg } from './annotations-model.ts';
-
-export interface ReceivedAnnotations {
-  /** The SVG text exactly as the project delivered it. */
-  raw: string;
-  /** The same state as this client serializes it. */
-  canon: string;
-}
-
-export function receivedAnnotations(raw: string, strokes: readonly Stroke[]): ReceivedAnnotations {
-  return { raw, canon: strokesToSvg(strokes) };
-}
-
-export function annotationEditBase(
-  before: readonly Stroke[],
-  received: ReceivedAnnotations | null
-): string {
-  const canon = strokesToSvg(before);
-  return received && received.canon === canon ? received.raw : canon;
-}

package/apps/studio/commands/annotation-strokes-command.ts

@@ -1,137 +0,0 @@
-/**
- * @file       commands/annotation-strokes-command.ts — undo entry for annotation
- *             stroke add / erase / batch-translate.
- * @scope      apps/studio/commands/annotation-strokes-command.ts
- * @purpose    Records a `Stroke[]` pair (before/after) and routes both
- *             directions through a single `putFn`. The server endpoint is
- *             `PUT /_api/annotations` which replaces the entire SVG; we
- *             match that shape rather than diffing.
- *
- *             Per DDR-050 rev 2 the runtime command is rebuilt per iframe
- *             mount from a serializable `CommandRecord` so the stack
- *             survives canvas switches. The `putFn` here also updates the
- *             iframe's local React strokes state (see annotations-layer
- *             `putStrokes`) so undo/redo visibly refresh, not just PUT.
- *
- *             Why per-stroke commands (not coalesced into a 300 ms window):
- *             matches Figma/FigJam — Cmd+Z reverts the most recent tap or
- *             pen stroke individually. Coalescing into windows led to a
- *             matoucí "why did Cmd+Z erase two of my last lines?" UX.
- */
-
-import type { Stroke } from '../annotations-layer.tsx';
-import type { CommandRecord, EditCommand } from '../undo-stack.ts';
-import { registerCommand } from '../undo-stack.ts';
-
-/**
- * Push-once callable that submits a full `Stroke[]` to the server (or its
- * test stub) AND updates the iframe's local strokes state. The
- * annotations-layer `putStrokes` is the production binding.
- *
- * `before` is the baseline THIS command's `next` was computed from — passed
- * through so the consumer can distinguish "an id `prev` still has that
- * `before` already lacked too" (a genuinely concurrent addition, fold it in)
- * from "an id `before` had that `next` deliberately dropped" (this command's
- * own delete — must stay dropped even if React's rendered state hasn't
- * caught up yet). See `reconcileCommit` in annotations-layer.tsx.
- */
-export type StrokesPutFn = (
-  next: readonly Stroke[],
-  before: readonly Stroke[]
-) => void | Promise<void>;
-
-export interface AnnotationStrokesPayload {
-  before: readonly Stroke[];
-  after: readonly Stroke[];
-}
-
-export const ANNOTATION_STROKES_KIND = 'annotation-strokes';
-
-export interface AnnotationStrokesCommandInit {
-  before: readonly Stroke[];
-  after: readonly Stroke[];
-  putFn: StrokesPutFn;
-  /** Optional label override (eraser → "erase 1 stroke"). */
-  label?: string;
-  /** Telemetry kind. */
-  kind?: string;
-}
-
-export function createAnnotationStrokesCommand(init: AnnotationStrokesCommandInit): EditCommand {
-  const { putFn } = init;
-  const before = init.before.map(cloneStroke);
-  const after = init.after.map(cloneStroke);
-  const label = init.label ?? defaultLabel(before, after);
-  const kind = init.kind ?? ANNOTATION_STROKES_KIND;
-
-  return {
-    kind,
-    label,
-    async do() {
-      await putFn(after.map(cloneStroke), before.map(cloneStroke));
-    },
-    async undo() {
-      await putFn(before.map(cloneStroke), after.map(cloneStroke));
-    },
-  };
-}
-
-/**
- * Build a persistable record from the same inputs as `createAnnotationStrokesCommand`.
- * Used by the consumer alongside the EditCommand so the runtime side-effect
- * and the stored shape share one snapshot.
- */
-export function buildAnnotationStrokesRecord(opts: {
-  before: readonly Stroke[];
-  after: readonly Stroke[];
-  label?: string;
-}): CommandRecord<AnnotationStrokesPayload> {
-  const before = opts.before.map(cloneStroke);
-  const after = opts.after.map(cloneStroke);
-  return {
-    kind: ANNOTATION_STROKES_KIND,
-    label: opts.label ?? defaultLabel(before, after),
-    payload: { before, after },
-  };
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Registry
-
-registerCommand<AnnotationStrokesPayload>(ANNOTATION_STROKES_KIND, (record, sinks) => {
-  const putFn = sinks.strokesPutFn as StrokesPutFn | undefined;
-  if (!putFn) return null;
-  return createAnnotationStrokesCommand({
-    before: record.payload.before,
-    after: record.payload.after,
-    putFn,
-    label: record.label,
-  });
-});
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Internals
-
-/**
- * Structured clone — works for every Stroke variant because they're plain
- * JSON-shaped (no Date / Map / DOM nodes). The pen `points: WorldPoint[]`
- * array is nested-cloned too so callers can't poison the snapshot by
- * mutating the source.
- */
-function cloneStroke<T extends Stroke>(s: T): T {
-  // structuredClone is available on every runtime we ship to (Bun, modern
-  // browsers, Node 17+). Fall back to JSON for the rare older harness.
-  if (typeof structuredClone === 'function') return structuredClone(s);
-  return JSON.parse(JSON.stringify(s)) as T;
-}
-
-function defaultLabel(before: readonly Stroke[], after: readonly Stroke[]): string {
-  const added = after.length - before.length;
-  if (added > 0) return `add ${added} stroke${added === 1 ? '' : 's'}`;
-  if (added < 0) {
-    const erased = -added;
-    return `erase ${erased} stroke${erased === 1 ? '' : 's'}`;
-  }
-  // Same count — could be translate / edit / fill-change.
-  return `edit ${after.length} stroke${after.length === 1 ? '' : 's'}`;
-}