@1agh/maude 0.16.0 → 0.17.2

package/README.md

@@ -2,6 +2,10 @@
 
 A personal marketplace of Claude Code plugins. Two plugins today, plus a `maude` CLI for scaffolding and running the bundled dev tooling.
 
+<!-- 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

@@ -1,9 +1,10 @@
-import { spawn } from 'node:child_process';
+import { execSync, spawn } from 'node:child_process';
 import { mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';
-import { basename, join, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+import { basename, dirname, 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 +26,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,28 +49,54 @@ 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.
 `;
 }
 
 async function runServe({ args, pkgRoot }) {
   const forwarded = args.slice(args.indexOf('serve') + 1);
+  const fs = await import('node:fs');
 
   // Resolution order:
-  //   1. Side-channel from postinstall (cli/.platform-binary-path) — direct
-  //      native exec, zero Node startup tax. DDR-015.
-  //   2. Bun + server.ts (local dev or postinstall-skipped install).
-  //   3. Legacy server.mjs on Node — last-resort fallback for boxes without
-  //      bun. Should only fire mid-migration; removed in v1.0.
+  //   1. Side-channel cache from postinstall (cli/.platform-binary-path).
+  //   2. Lazy resolve of @1agh/maude-<slug>/maude (postinstall was skipped
+  //      — Bun global, --ignore-scripts, Docker layer without scripts, etc.).
+  //   3. (only in local dev tree) Bun + server.ts from source.
+  //   4. Hard-fail with actionable hint.
+  // Maintainers hacking on the dev-server source can force #3 with
+  // MAUDE_FORCE_SOURCE=1.
+  const forceSource = process.env.MAUDE_FORCE_SOURCE === '1';
   const sideChannel = resolve(pkgRoot, 'cli', '.platform-binary-path');
   let binPath = null;
-  try {
-    const { readFileSync, existsSync } = await import('node:fs');
-    if (existsSync(sideChannel)) {
-      const candidate = readFileSync(sideChannel, 'utf8').trim();
-      if (candidate && existsSync(candidate)) binPath = candidate;
+
+  if (!forceSource) {
+    try {
+      if (fs.existsSync(sideChannel)) {
+        const candidate = fs.readFileSync(sideChannel, 'utf8').trim();
+        if (candidate && fs.existsSync(candidate)) binPath = candidate;
+      }
+    } catch {
+      /* fall through to lazy resolve */
+    }
+
+    if (!binPath) {
+      const resolved = lazyResolveBinary({ pkgRoot, fs });
+      if (resolved.binPath) {
+        binPath = resolved.binPath;
+        // Cache for next invocation (best-effort — read-only fs is fine).
+        try {
+          fs.writeFileSync(sideChannel, binPath, 'utf8');
+        } catch {
+          /* read-only fs / no permission — non-fatal */
+        }
+      }
     }
-  } catch {
-    /* fall through */
   }
 
   if (binPath) {
@@ -79,6 +109,30 @@ async function runServe({ args, pkgRoot }) {
     return;
   }
 
+  // No binary found. Two possibilities:
+  //   - Production install missing platform package — hard-fail with guidance.
+  //   - Local dev tree (claude-design checkout) — fall through to source.
+  const inDevTree = isLocalDevTree(pkgRoot, fs);
+
+  if (!inDevTree && !forceSource) {
+    const slug = detectPlatformSlug();
+    const siblingHint = slug ? resolve(pkgRoot, '..', `maude-${slug}`) : '(unknown platform)';
+    process.stderr.write(
+      `maude design serve: platform binary not found.\n\n  Expected:  @1agh/maude-${slug || '<platform>'}/maude\n  Looked in: ${siblingHint}\n\nLikely causes:\n  • Installer skipped postinstall (Bun global, npm --ignore-scripts,\n    pnpm strict-scripts, Docker layer rebuilds).\n  • Optional dependency for your platform did not install.\n  • Global 'maude' is a leftover 'npm link' to a source checkout.\n\nFix (clean reinstall):\n  cd ~                          # NOT inside a maude source repo\n  npm uninstall -g @1agh/maude  # remove any stale link\n  npm i -g @1agh/maude          # real tarball install + postinstall\n\nOr re-run postinstall on the existing install:\n  npm rebuild -g @1agh/maude\n\nPlatform: ${process.platform}-${process.arch}\n`
+    );
+    process.exit(1);
+  }
+
+  // Local dev tree (or forced source). Verify deps before invoking source —
+  // catches the npm/pnpm/oxc-parser native-binding bug (npm#4828) up front.
+  const missing = checkDevDeps({ pkgRoot });
+  if (missing.length) {
+    process.stderr.write(
+      `maude design serve: missing dev-server dependencies in local checkout.\n\n  Missing: ${missing.join(', ')}\n  Repo:    ${pkgRoot}\n\nThis repo uses pnpm (see packageManager in package.json). Install deps:\n  cd ${pkgRoot} && pnpm install\n\nIf you already ran 'npm install' here, the npm optional-deps bug\n(npm#4828) may have left native bindings broken. Reset first:\n  rm -rf node_modules package-lock.json && pnpm install\n`
+    );
+    process.exit(1);
+  }
+
   const tsEntry = resolve(pkgRoot, 'plugins', 'design', 'dev-server', 'server.ts');
   const mjsEntry = resolve(pkgRoot, 'plugins', 'design', 'dev-server', 'server.mjs');
 
@@ -98,6 +152,200 @@ async function runServe({ args, pkgRoot }) {
   });
 }
 
+// Mirrors cli/install.cjs:detectSlug — kept in sync intentionally. Both forms
+// run during the lifecycle of a single install (postinstall + first serve).
+function detectPlatformSlug() {
+  const p = process.platform;
+  const a = process.arch;
+  if (p === 'darwin') {
+    if (a === 'arm64') return 'darwin-arm64';
+    try {
+      const t = execSync('sysctl -n sysctl.proc_translated', {
+        stdio: ['ignore', 'pipe', 'ignore'],
+      })
+        .toString()
+        .trim();
+      if (t === '1') return 'darwin-arm64';
+    } catch {
+      /* not under Rosetta */
+    }
+    return 'darwin-x64';
+  }
+  if (p === 'linux') {
+    let isMusl = false;
+    try {
+      const report = process.report?.getReport?.();
+      isMusl = !report?.header?.glibcVersionRuntime;
+    } catch {
+      /* default to glibc */
+    }
+    if (a === 'arm64') return isMusl ? 'linux-arm64-musl' : 'linux-arm64';
+    return isMusl ? 'linux-x64-musl' : 'linux-x64';
+  }
+  if (p === 'win32') return 'win32-x64';
+  return null;
+}
+
+function lazyResolveBinary({ pkgRoot, fs }) {
+  const slug = detectPlatformSlug();
+  if (!slug) return { binPath: null, slug: null };
+  const filename = process.platform === 'win32' ? 'maude.exe' : 'maude';
+
+  // Flat layout — production npm/bun global install. pkgRoot is
+  // <node_modules>/@1agh/maude, sibling is <node_modules>/@1agh/maude-<slug>.
+  const sibling = resolve(pkgRoot, '..', `maude-${slug}`, filename);
+  if (fs.existsSync(sibling)) {
+    try {
+      fs.chmodSync(sibling, 0o755);
+    } catch {
+      /* read-only — ignore */
+    }
+    return { binPath: sibling, slug };
+  }
+
+  // Nested layout — pnpm with isolation, or dev tree's own node_modules.
+  try {
+    const require = createRequire(import.meta.url);
+    const manifest = require.resolve(`@1agh/maude-${slug}/package.json`, {
+      paths: [pkgRoot, resolve(pkgRoot, 'cli')],
+    });
+    const fromManifest = resolve(dirname(manifest), filename);
+    if (fs.existsSync(fromManifest)) {
+      try {
+        fs.chmodSync(fromManifest, 0o755);
+      } catch {
+        /* ignore */
+      }
+      return { binPath: fromManifest, slug };
+    }
+  } catch {
+    /* platform package not installed */
+  }
+
+  return { binPath: null, slug };
+}
+
+// Mirrors cli/install.cjs:isLocalDev — the `packages/` directory is only present
+// in the source checkout, never in a published npm tarball (excluded from
+// package.json:files).
+function isLocalDevTree(pkgRoot, fs) {
+  return fs.existsSync(resolve(pkgRoot, 'packages', 'maude-darwin-arm64', 'package.json'));
+}
+
+function checkDevDeps({ pkgRoot }) {
+  const require = createRequire(import.meta.url);
+  // The dev-server source path imports these as bare specifiers. If they
+  // resolve, bun/node will load them; if they don't, the spawn will fail
+  // with a less actionable error.
+  const required = ['magic-string', 'oxc-parser'];
+  const missing = [];
+  const paths = [resolve(pkgRoot, 'plugins', 'design', 'dev-server'), resolve(pkgRoot)];
+  for (const dep of required) {
+    try {
+      require.resolve(dep, { paths });
+    } catch {
+      missing.push(dep);
+    }
+  }
+  return missing;
+}
+
+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.16.0",
+  "version": "0.17.2",
   "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.16.0",
-    "@1agh/maude-darwin-x64": "0.16.0",
-    "@1agh/maude-linux-arm64": "0.16.0",
-    "@1agh/maude-linux-arm64-musl": "0.16.0",
-    "@1agh/maude-linux-x64": "0.16.0",
-    "@1agh/maude-linux-x64-musl": "0.16.0",
-    "@1agh/maude-win32-x64": "0.16.0"
+    "@1agh/maude-darwin-arm64": "0.17.2",
+    "@1agh/maude-darwin-x64": "0.17.2",
+    "@1agh/maude-linux-arm64": "0.17.2",
+    "@1agh/maude-linux-arm64-musl": "0.17.2",
+    "@1agh/maude-linux-x64": "0.17.2",
+    "@1agh/maude-linux-x64-musl": "0.17.2",
+    "@1agh/maude-win32-x64": "0.17.2"
   },
   "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

@@ -119,6 +119,16 @@ export interface GitCommitter {
   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 {
   // File tree
   fileSlug(file: string): string;
@@ -146,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 {
@@ -694,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();
@@ -853,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();
+}