@1agh/maude 0.15.0 → 0.17.1

package/README.md

@@ -1,8 +1,10 @@
-# Maude — Claude Code marketplace
+# Maude
 
 A personal marketplace of Claude Code plugins. Two plugins today, plus a `maude` CLI for scaffolding and running the bundled dev tooling.
 
-> **Renamed from `md-claude`.** See [`docs/MIGRATING-MD-CLAUDE-TO-MAUDE.md`](./docs/MIGRATING-MD-CLAUDE-TO-MAUDE.md) if you came from the old name.
+<!-- Demo video lives at https://github.com/1aGh/maude/releases/download/v0.16.0/demo.mp4 once uploaded.
+     Until then the inline tag below stays a soft 404; landing page at https://maude.iagh.cz autoplays the same file. -->
+<video src="https://github.com/1aGh/maude/releases/download/v0.16.0/demo.mp4" controls muted playsinline poster="https://maude.iagh.cz/demo-poster.jpg" width="800"></video>
 
 > **📚 Full docs: https://maude.iagh.cz** (or browse the source under [`site/content/docs/`](./site/content/docs/) until the public URL lands).
 > Contributing? See [CONTRIBUTING.md](./CONTRIBUTING.md). Security? See [SECURITY.md](./SECURITY.md).

package/cli/commands/design.mjs

@@ -3,7 +3,7 @@ import { mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';
 import { basename, join, resolve } from 'node:path';
 import { parseArgs } from '../lib/argv.mjs';
 
-const SUBCOMMANDS = new Set(['serve', 'init', 'help']);
+const SUBCOMMANDS = new Set(['serve', 'init', 'export', 'help']);
 
 export async function run({ args, pkgRoot }) {
   const { positional } = parseArgs(args);
@@ -25,10 +25,13 @@ export async function run({ args, pkgRoot }) {
   if (sub === 'init') {
     return runInit({ args, pkgRoot });
   }
+  if (sub === 'export') {
+    return runExport({ args });
+  }
 }
 
 function usage() {
-  return `maude design <serve|init> [options]
+  return `maude design <serve|init|export> [options]
 
   serve [--port N] [--root PATH]
         Start the design plugin's dev server in the current repo. Equivalent
@@ -45,6 +48,13 @@ function usage() {
         --discovery-payload <path> reads a JSON file with answers + tokens and
         scaffolds Core + the derived specimens deterministically (this is the
         path skill 'design-system' uses when shelling out from Claude Code).
+
+  export <format> [--scope selection|artboard|canvas-as-separate|project-raw]
+         [--port N] [--out <path>] [--option key=value ...]
+        Drive the same POST /_api/export endpoint the UI uses. Auto-detects
+        port from .design/_server.json; requires a running dev server. The
+        response body is written to --out (default: current dir, server-
+        supplied filename). Formats: png pdf svg html pptx canva zip.
 `;
 }
 
@@ -98,6 +108,102 @@ async function runServe({ args, pkgRoot }) {
   });
 }
 
+async function runExport({ args }) {
+  // `maude design export <format> [--scope ...] [--port N] [--out <path>] [--option key=value]`
+  const subArgs = args.slice(args.indexOf('export') + 1);
+  const { positional, flags } = parseArgs(subArgs, {
+    booleans: ['help'],
+  });
+  if (flags.help) {
+    process.stdout.write(usage());
+    return;
+  }
+
+  const format = positional[0];
+  const VALID_FORMATS = new Set(['png', 'pdf', 'svg', 'html', 'pptx', 'canva', 'zip']);
+  if (!format || !VALID_FORMATS.has(format)) {
+    process.stderr.write(
+      `maude design export: missing or unknown <format>. Try one of: ${Array.from(VALID_FORMATS).join(', ')}\n`
+    );
+    process.exit(2);
+  }
+
+  const scope = flags.scope ?? 'canvas-as-separate';
+  const VALID_SCOPES = new Set(['selection', 'artboard', 'canvas-as-separate', 'project-raw']);
+  if (!VALID_SCOPES.has(scope)) {
+    process.stderr.write(`maude design export: unknown --scope "${scope}"\n`);
+    process.exit(2);
+  }
+
+  // Resolve port: --port > .design/_server.json
+  let port = flags.port ? Number(flags.port) : null;
+  if (!port) {
+    try {
+      const raw = await readFile(resolve(process.cwd(), '.design', '_server.json'), 'utf8');
+      port = JSON.parse(raw).port;
+    } catch {
+      /* no server.json — handled below */
+    }
+  }
+  if (!port) {
+    process.stderr.write(
+      'maude design export: no --port given and .design/_server.json not found. Start the dev server first (`maude design serve`).\n'
+    );
+    process.exit(1);
+  }
+
+  // Collect `--option key=value` repeated flags into an object.
+  const options = {};
+  const repeated = collectRepeatedFlag(subArgs, '--option');
+  for (const item of repeated) {
+    const eq = item.indexOf('=');
+    if (eq < 0) {
+      process.stderr.write(
+        `maude design export: invalid --option "${item}" (expected key=value)\n`
+      );
+      process.exit(2);
+    }
+    const key = item.slice(0, eq);
+    const value = item.slice(eq + 1);
+    // Coerce common JSON-ish values: true/false, numbers, arrays via comma.
+    options[key] = value === 'true' ? true : value === 'false' ? false : value;
+  }
+
+  const url = `http://localhost:${port}/_api/export`;
+  const r = await fetch(url, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ format, scope, options }),
+  });
+  if (!r.ok) {
+    const text = await r.text();
+    process.stderr.write(`maude design export: server returned ${r.status}: ${text}\n`);
+    process.exit(1);
+  }
+
+  const disp = r.headers.get('content-disposition') ?? '';
+  const serverFilename = /filename="([^"]+)"/.exec(disp)?.[1] ?? `export.${format}`;
+  const outPath = flags.out
+    ? resolve(process.cwd(), flags.out)
+    : resolve(process.cwd(), serverFilename);
+  const bytes = new Uint8Array(await r.arrayBuffer());
+  await writeFile(outPath, bytes);
+  process.stdout.write(`maude design export: wrote ${outPath} (${bytes.byteLength} bytes)\n`);
+}
+
+function collectRepeatedFlag(argv, name) {
+  const out = [];
+  for (let i = 0; i < argv.length; i += 1) {
+    if (argv[i] === name && argv[i + 1] !== undefined) {
+      out.push(argv[i + 1]);
+      i += 1;
+    } else if (argv[i].startsWith(`${name}=`)) {
+      out.push(argv[i].slice(name.length + 1));
+    }
+  }
+  return out;
+}
+
 async function runInit({ args, pkgRoot }) {
   const subArgs = args.slice(args.indexOf('init') + 1);
   const { flags } = parseArgs(subArgs, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1agh/maude",
-  "version": "0.15.0",
+  "version": "0.17.1",
   "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": {
@@ -34,18 +34,20 @@
     "video:smoke": "bash scripts/video/smoke/run.sh",
     "video:smoke:terminal": "vhs scripts/video/smoke/terminal.tape",
     "video:smoke:browser": "playwright test --config scripts/video/smoke/playwright.config.ts",
-    "video:smoke:card": "remotion render scripts/video/smoke/card/index.tsx SmokeCard scripts/video/.work/smoke/card.mp4 --mute",
+    "video:smoke:card": "cd scripts/video/final && pnpm run render SmokeCard ../.work/smoke/card.mp4 --mute",
+    "video:render": "cd scripts/video/final && pnpm run render",
+    "video:studio": "cd scripts/video/final && pnpm run studio",
     "postinstall": "node cli/install.cjs",
     "prepublishOnly": "bash scripts/check-version-parity.sh"
   },
   "optionalDependencies": {
-    "@1agh/maude-darwin-arm64": "0.15.0",
-    "@1agh/maude-darwin-x64": "0.15.0",
-    "@1agh/maude-linux-arm64": "0.15.0",
-    "@1agh/maude-linux-arm64-musl": "0.15.0",
-    "@1agh/maude-linux-x64": "0.15.0",
-    "@1agh/maude-linux-x64-musl": "0.15.0",
-    "@1agh/maude-win32-x64": "0.15.0"
+    "@1agh/maude-darwin-arm64": "0.17.1",
+    "@1agh/maude-darwin-x64": "0.17.1",
+    "@1agh/maude-linux-arm64": "0.17.1",
+    "@1agh/maude-linux-arm64-musl": "0.17.1",
+    "@1agh/maude-linux-x64": "0.17.1",
+    "@1agh/maude-linux-x64-musl": "0.17.1",
+    "@1agh/maude-win32-x64": "0.17.1"
   },
   "files": [
     "cli",
@@ -81,14 +83,6 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@changesets/cli": "^2.27.10",
-    "@playwright/test": "^1.60.0",
-    "@remotion/bundler": "^4.0.463",
-    "@remotion/cli": "^4.0.463",
-    "@remotion/renderer": "^4.0.463",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6",
-    "remotion": "^4.0.463"
+    "@playwright/test": "^1.60.0"
   }
 }

package/plugins/design/dev-server/annotations-context-toolbar.tsx

@@ -36,14 +36,14 @@ const TOOLBAR_CSS = `
   display: flex;
   align-items: center;
   gap: 6px;
-  background: var(--bg-1, rgba(255,255,255,0.98));
-  border: 1px solid var(--u-border-2, rgba(0,0,0,0.08));
-  border-radius: 8px;
+  background: var(--u-bg-2, var(--bg-1, rgba(255,255,255,0.98)));
+  border: 1px solid var(--u-fg-0, #1c1917);
+  border-radius: 0;
   padding: 6px 8px;
-  box-shadow: 0 8px 24px rgba(0,0,0,0.10);
-  font-family: ui-sans-serif, system-ui, sans-serif;
+  box-shadow: 4px 4px 0 var(--u-fg-0, #1c1917);
+  font-family: var(--u-font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);
   font-size: 12px;
-  color: var(--fg-0, #1a1a1a);
+  color: var(--u-fg-0, var(--fg-0, #1a1a1a));
   user-select: none;
   pointer-events: auto;
 }
@@ -79,8 +79,8 @@ const TOOLBAR_CSS = `
 .dc-annot-ctx-btn {
   appearance: none;
   background: transparent;
-  border: 1px solid rgba(0,0,0,0.12);
-  border-radius: 4px;
+  border: 1px solid var(--u-fg-0, rgba(0,0,0,0.6));
+  border-radius: 0;
   padding: 3px 8px;
   font: inherit;
   color: inherit;

package/plugins/design/dev-server/annotations-layer.tsx

@@ -118,9 +118,7 @@ const STROKE_WIDTH_THIN = 2;
 const STROKE_WIDTH_THICK = 6;
 type Thickness = typeof STROKE_WIDTH_THIN | typeof STROKE_WIDTH_THICK;
 
-const FONT_SIZE_SMALL = 12;
 const FONT_SIZE_MEDIUM = 14;
-const FONT_SIZE_LARGE = 20;
 const DEFAULT_FONT_SIZE = FONT_SIZE_MEDIUM;
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -459,15 +457,15 @@ const ANNOT_CSS = `
   display: flex;
   align-items: center;
   gap: 8px;
-  background: var(--bg-1, rgba(255,255,255,0.98));
-  border: 1px solid var(--u-border-2, rgba(0,0,0,0.08));
-  border-radius: 8px;
+  background: var(--u-bg-2, var(--bg-1, rgba(255,255,255,0.98)));
+  border: 1px solid var(--u-fg-0, #1c1917);
+  border-radius: 0;
   padding: 6px 10px;
-  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-family: var(--u-font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);
   font-size: 11px;
-  color: rgba(40,30,20,0.85);
+  color: var(--u-fg-0, rgba(40,30,20,0.85));
   z-index: 6;
-  box-shadow: 0 6px 24px rgba(0,0,0,0.08);
+  box-shadow: 4px 4px 0 var(--u-fg-0, #1c1917);
   user-select: none;
 }
 .dc-annot-chrome .dc-annot-swatches { display: flex; gap: 4px; }
@@ -1481,7 +1479,7 @@ function TextEditor({
           textAlign: 'center',
           color: existing?.color ?? '#1a1a1a',
           fontSize: `${fontSize}px`,
-          fontFamily: 'ui-sans-serif, system-ui, sans-serif',
+          fontFamily: 'var(--u-font-mono, ui-monospace, SFMono-Regular, Menlo, monospace)',
           lineHeight: 1.25,
           outline: 'none',
           background: 'transparent',
@@ -1568,7 +1566,7 @@ function StrokeNode({
         fontSize={stroke.fontSize}
         textAnchor="middle"
         dominantBaseline="middle"
-        style={{ fontFamily: 'ui-sans-serif, system-ui, sans-serif' }}
+        style={{ fontFamily: 'var(--u-font-mono, ui-monospace, SFMono-Regular, Menlo, monospace)' }}
       >
         {stroke.text}
       </text>

package/plugins/design/dev-server/api.ts

@@ -78,6 +78,19 @@ async function findFiles(absRoot: string, prefix: string, exts: string[]): Promi
 
 // ---------- Comments ----------
 
+/**
+ * Phase 6 — single reply on a comment thread. `id` is `r_<hex>`; persists inside
+ * the parent `Comment.thread[]`. Bodies are bounded the same way as comment
+ * bodies (4000 chars), and `@handle` tokens in `body` flow into the parent's
+ * `mentions[]` union.
+ */
+export interface Reply {
+  id: string;
+  author: string;
+  body: string;
+  created: string;
+}
+
 export interface Comment {
   id: string;
   file: string;
@@ -91,6 +104,29 @@ export interface Comment {
   status: 'open' | 'resolved';
   created: string;
   resolved_at: string | null;
+  // Phase 6 — author + threading + mentions. Default-filled on read for legacy
+  // comments missing these fields (see `loadCommentsForFile`); persisted on next
+  // write. `author` defaults to the local `git config user.name` resolved at
+  // create time, `thread` to `[]`, `mentions` to `[]`.
+  author: string;
+  thread: Reply[];
+  mentions: string[];
+}
+
+export interface GitCommitter {
+  name: string;
+  email: string;
+  commits: number;
+}
+
+// Phase 6.5 T10 — export history. Five-deep ring buffer of recent exports
+// surfaced by the dialog's "Recent" tab + ⌘⇧E re-run.
+export interface ExportHistoryEntry {
+  format: string;
+  scope: string;
+  options?: Record<string, unknown>;
+  filename: string;
+  at: string;
 }
 
 export interface Api {
@@ -102,6 +138,9 @@ export interface Api {
   commentsAdd(payload: Partial<Comment> & { file: string; text: string }): Promise<Comment | null>;
   commentsPatch(id: string, patch: Partial<Comment>): Promise<Comment | null>;
   commentsDelete(id: string): Promise<boolean>;
+  commentsAddReply(id: string, payload: { body: string; author?: string }): Promise<Comment | null>;
+  gitCommitters(): Promise<GitCommitter[]>;
+  parseMentions(text: string): string[];
   // Canvas state
   loadCanvasState(file: string): Promise<Record<string, unknown> | null>;
   saveCanvasState(file: string, state: Record<string, unknown>): Promise<void>;
@@ -117,6 +156,9 @@ export interface Api {
   // Aggregate data
   buildIndexData(): Promise<unknown>;
   buildSystemData(): Promise<unknown>;
+  // Export history (Phase 6.5 T10)
+  loadExportHistory(): Promise<ExportHistoryEntry[]>;
+  appendExportHistory(entry: ExportHistoryEntry): Promise<void>;
 }
 
 export function createApi(ctx: Context, onCommentsChanged: (file: string) => void): Api {
@@ -147,12 +189,26 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
     try {
       const raw = await Bun.file(commentsPath(file)).text();
       const arr = JSON.parse(raw);
-      return Array.isArray(arr) ? arr : [];
+      if (!Array.isArray(arr)) return [];
+      // Phase 6 — default-fill `author` / `thread` / `mentions` for legacy
+      // rows. No write-back here; the on-disk shape stays stable until the
+      // next mutation persists the upgraded record.
+      return arr.map(backfillComment);
     } catch {
       return [];
     }
   }
 
+  function backfillComment(raw: unknown): Comment {
+    const c = (raw ?? {}) as Partial<Comment>;
+    return {
+      ...(c as Comment),
+      author: typeof c.author === 'string' ? c.author : '',
+      thread: Array.isArray(c.thread) ? c.thread : [],
+      mentions: Array.isArray(c.mentions) ? c.mentions : [],
+    };
+  }
+
   async function saveCommentsForFile(file: string, list: Comment[]) {
     await Bun.write(commentsPath(file), JSON.stringify(list, null, 2));
   }
@@ -172,7 +228,8 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
         const arr = JSON.parse(raw);
         if (!Array.isArray(arr) || arr.length === 0) continue;
         const file = arr[0]?.file as string | undefined;
-        if (file) out[file] = arr;
+        // Backfill legacy rows so callers see the v2 shape uniformly.
+        if (file) out[file] = arr.map(backfillComment);
       } catch {
         /* ignore */
       }
@@ -184,10 +241,111 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
     return `c_${crypto.randomBytes(6).toString('hex')}`;
   }
 
+  function newReplyId(): string {
+    return `r_${crypto.randomBytes(6).toString('hex')}`;
+  }
+
+  // ---------- Git author resolution ----------
+  //
+  // Author defaults flow from `git config user.name` resolved against the
+  // repo root. Cached for the lifetime of the process — the local git
+  // identity doesn't shift mid-session and `Bun.spawn` is cheap-but-not-free.
+
+  let cachedGitUser: string | null = null;
+  let cachedGitUserAttempted = false;
+  async function gitCurrentUser(): Promise<string> {
+    if (cachedGitUserAttempted) return cachedGitUser ?? '';
+    cachedGitUserAttempted = true;
+    try {
+      const proc = Bun.spawn(['git', 'config', 'user.name'], {
+        cwd: paths.repoRoot,
+        stdout: 'pipe',
+        stderr: 'pipe',
+      });
+      const out = await new Response(proc.stdout).text();
+      await proc.exited;
+      const name = out.trim();
+      cachedGitUser = name || null;
+    } catch {
+      cachedGitUser = null;
+    }
+    return cachedGitUser ?? '';
+  }
+
+  // `git shortlog -sne` against the repo head — cached for 60 s so the
+  // @mention popup doesn't re-fork git on every keystroke.
+  let cachedCommitters: GitCommitter[] | null = null;
+  let cachedCommittersAt = 0;
+  async function gitCommitters(): Promise<GitCommitter[]> {
+    const now = Date.now();
+    if (cachedCommitters && now - cachedCommittersAt < 60_000) return cachedCommitters;
+    try {
+      const proc = Bun.spawn(['git', 'shortlog', '-sne', 'HEAD'], {
+        cwd: paths.repoRoot,
+        stdout: 'pipe',
+        stderr: 'pipe',
+      });
+      const text = await new Response(proc.stdout).text();
+      await proc.exited;
+      const lines = text
+        .split('\n')
+        .map((l) => l.trim())
+        .filter(Boolean)
+        .slice(0, 20);
+      const out: GitCommitter[] = [];
+      for (const line of lines) {
+        // Format: `<spaces><count>\t<name> <<email>>`
+        const m = line.match(/^(\d+)\s+(.+?)\s+<([^>]+)>$/);
+        if (!m) continue;
+        const commits = Number(m[1]);
+        const name = m[2]?.trim() ?? '';
+        const email = m[3]?.trim() ?? '';
+        if (!name) continue;
+        out.push({ name, email, commits });
+      }
+      cachedCommitters = out;
+      cachedCommittersAt = now;
+      return out;
+    } catch {
+      cachedCommitters = cachedCommitters ?? [];
+      cachedCommittersAt = now;
+      return cachedCommitters;
+    }
+  }
+
+  /**
+   * Extract `@handle` tokens from free text. Deduped, returns the literal
+   * `@name` form (matching what the autocomplete inserts), so a comment with
+   * `"@ada @lin @ada"` collapses to `["@ada","@lin"]`.
+   */
+  function parseMentions(text: string): string[] {
+    const out: string[] = [];
+    const seen = new Set<string>();
+    if (typeof text !== 'string' || !text) return out;
+    const re = /@[\w][\w.-]*/g;
+    for (const m of text.matchAll(re)) {
+      const tok = m[0];
+      if (!tok || seen.has(tok)) continue;
+      seen.add(tok);
+      out.push(tok);
+    }
+    return out;
+  }
+
+  function mentionsUnion(c: Comment): string[] {
+    const all = [c.text, ...c.thread.map((r) => r.body)].join('\n');
+    return parseMentions(all);
+  }
+
   async function commentsAdd(payload: Partial<Comment> & { file: string; text: string }) {
     if (!payload || typeof payload.file !== 'string' || !payload.file) return null;
     if (typeof payload.text !== 'string' || !payload.text.trim()) return null;
     const list = await loadCommentsForFile(payload.file);
+    const text = String(payload.text).trim().slice(0, 4000);
+    const author =
+      typeof payload.author === 'string' && payload.author.trim()
+        ? payload.author.trim().slice(0, 120)
+        : await gitCurrentUser();
     const c: Comment = {
       id: newCommentId(),
       file: payload.file,
@@ -197,10 +355,13 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
       classes: String(payload.classes || ''),
       bounds: payload.bounds ?? null,
       html_excerpt: String(payload.html_excerpt || '').slice(0, 2000),
-      text: String(payload.text).trim().slice(0, 4000),
+      text,
       status: 'open',
       created: new Date().toISOString(),
       resolved_at: null,
+      author,
+      thread: [],
+      mentions: parseMentions(text),
     };
     list.push(c);
     await saveCommentsForFile(payload.file, list);
@@ -208,6 +369,37 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
     return c;
   }
 
+  async function commentsAddReply(
+    id: string,
+    payload: { body: string; author?: string }
+  ): Promise<Comment | null> {
+    if (!payload || typeof payload.body !== 'string' || !payload.body.trim()) return null;
+    const all = await loadAllComments();
+    for (const [file, list] of Object.entries(all)) {
+      const i = list.findIndex((c) => c.id === id);
+      if (i < 0) continue;
+      const entry = list[i];
+      if (!entry) continue;
+      const body = payload.body.trim().slice(0, 4000);
+      const author =
+        typeof payload.author === 'string' && payload.author.trim()
+          ? payload.author.trim().slice(0, 120)
+          : await gitCurrentUser();
+      const reply: Reply = {
+        id: newReplyId(),
+        author,
+        body,
+        created: new Date().toISOString(),
+      };
+      entry.thread = [...entry.thread, reply];
+      entry.mentions = mentionsUnion(entry);
+      await saveCommentsForFile(file, list);
+      onCommentsChanged(file);
+      return entry;
+    }
+    return null;
+  }
+
   async function commentsPatch(id: string, patch: Partial<Comment>) {
     const all = await loadAllComments();
     for (const [file, list] of Object.entries(all)) {
@@ -221,6 +413,7 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
       }
       if (typeof patch.text === 'string' && patch.text.trim()) {
         entry.text = patch.text.trim().slice(0, 4000);
+        entry.mentions = mentionsUnion(entry);
       }
       await saveCommentsForFile(file, list);
       onCommentsChanged(file);
@@ -514,6 +707,32 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
     };
   }
 
+  // ---------- Export history (Phase 6.5 T10) ----------
+  //
+  // 5-deep ring buffer persisted at `<designRoot>/_export-history.json`.
+  // Reads tolerate missing / malformed files (returns []). Writes truncate
+  // to most-recent-first.
+
+  const HISTORY_PATH = path.join(paths.designRoot, '_export-history.json');
+  const HISTORY_DEPTH = 5;
+
+  async function loadExportHistory(): Promise<ExportHistoryEntry[]> {
+    try {
+      const raw = await Bun.file(HISTORY_PATH).text();
+      const arr = JSON.parse(raw);
+      if (!Array.isArray(arr)) return [];
+      return arr.slice(0, HISTORY_DEPTH);
+    } catch {
+      return [];
+    }
+  }
+
+  async function appendExportHistory(entry: ExportHistoryEntry): Promise<void> {
+    const prev = await loadExportHistory();
+    const next = [entry, ...prev].slice(0, HISTORY_DEPTH);
+    await Bun.write(HISTORY_PATH, JSON.stringify(next, null, 2));
+  }
+
   function tokenKind(name: string, value: string): string {
     const n = name.toLowerCase();
     const v = String(value).trim();
@@ -662,6 +881,9 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
     commentsAdd,
     commentsPatch,
     commentsDelete,
+    commentsAddReply,
+    gitCommitters,
+    parseMentions,
     loadCanvasState,
     saveCanvasState,
     loadCanvasMeta,
@@ -670,5 +892,7 @@ export function createApi(ctx: Context, onCommentsChanged: (file: string) => voi
     saveAnnotations,
     buildIndexData,
     buildSystemData,
+    loadExportHistory,
+    appendExportHistory,
   };
 }

package/plugins/design/dev-server/bin/_enumerate-artboards-playwright.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+// Tiny playwright shim that lists `[data-dc-screen]` IDs on a canvas-shell URL,
+// one per line on stdout. Spawned by `exporters/pptx.ts` for canvas-as-separate
+// merge. Lives as a subprocess (not a direct import) so `bun build --compile`
+// of the dev-server binary doesn't pull in playwright + chromium-bidi deep deps.
+
+import { chromium } from 'playwright';
+
+const args = process.argv.slice(2);
+let url;
+let timeoutSec = 20;
+for (let i = 0; i < args.length; i += 1) {
+  if (args[i] === '--url') {
+    i += 1;
+    url = args[i];
+  } else if (args[i] === '--timeout') {
+    i += 1;
+    timeoutSec = Number(args[i]);
+  }
+}
+if (!url) {
+  console.error('usage: _enumerate-artboards-playwright.mjs --url <url> [--timeout <sec>]');
+  process.exit(2);
+}
+
+const timeoutMs = timeoutSec * 1000;
+const browser = await chromium.launch();
+try {
+  const ctx = await browser.newContext({ viewport: { width: 1440, height: 900 } });
+  const page = await ctx.newPage();
+  await page.goto(url, { waitUntil: 'networkidle', timeout: timeoutMs });
+  const ids = await page.evaluate(() =>
+    Array.from(document.querySelectorAll('[data-dc-screen]')).map(
+      (el) => el.getAttribute('data-dc-screen') ?? ''
+    )
+  );
+  for (const id of ids.filter(Boolean)) console.log(id);
+} finally {
+  await browser.close();
+}