@1agh/maude 0.17.1 → 0.18.0

package/plugins/design/dev-server/runtime-bundle.ts

@@ -194,7 +194,12 @@ export async function getRuntimeBundle(pkg: RuntimePackage): Promise<BundleCache
         return `[${lvl}] ${l.message}`;
       })
       .join('\n');
-    throw new Error(`Failed to build runtime bundle for "${pkg}":\n${msg || '(no log messages)'}`);
+    const remediation = bunCacheRemediation(pkg, msg);
+    throw new Error(
+      `Failed to build runtime bundle for "${pkg}":\n${msg || '(no log messages)'}${
+        remediation ? `\n\n${remediation}` : ''
+      }`
+    );
   }
 
   const out = built.outputs[0];
@@ -206,6 +211,29 @@ export async function getRuntimeBundle(pkg: RuntimePackage): Promise<BundleCache
   return entry;
 }
 
+/**
+ * Detect the "Bun's global install cache is in a bad state" failure mode and
+ * return a one-paragraph remediation message. Returns null when the build
+ * failure has a different shape (real syntax error, missing package, etc.) —
+ * the original log is enough then.
+ *
+ * Symptoms: log messages like `EISDIR reading '/Users/foo/.bun/install/cache/
+ * react@19.2.6@@@1 @@1/index.js'` or `ENOENT … .bun/install/cache/<pkg>@…`.
+ * Surfacing the cache path + the exact `bun pm cache rm <pkg>` command saves
+ * the user from grepping the error to figure out what to do. Phase 19 / DDR-044.
+ */
+export function bunCacheRemediation(pkg: string, log: string): string | null {
+  const cacheHit = /(EISDIR|ENOENT).*\.bun\/install\/cache\/([\w@/.-]+?)(?:@@@|\/)/i.test(log);
+  if (!cacheHit) return null;
+  const basePkg = pkg.split('/')[0] ?? pkg;
+  return [
+    `  ⚠ Bun's global package cache for "${basePkg}" appears to be in a bad state`,
+    `    (truncated install, EISDIR/ENOENT on an index file).`,
+    ``,
+    `    Fix: run \`bun pm cache rm ${basePkg}\` then reload the page.`,
+  ].join('\n');
+}
+
 function escapeRegex(s: string): string {
   return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }

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

@@ -23,6 +23,12 @@ import { createHttp } from './http.ts';
 import { createInspect } from './inspect.ts';
 import { startHeapWatch } from './mem.ts';
 import { createWs } from './ws.ts';
+import { bootSelfHeal } from './boot-self-heal.ts';
+
+// Phase 19 / DDR-044 — covers the marketplace-cache-install gap where
+// node_modules/ ships empty (git clone honors .gitignore). Auto-installs +
+// builds on first boot; opt out with MAUDE_NO_AUTOBUILD=1.
+await bootSelfHeal();
 
 const ctx = createContext();
 

package/plugins/design/dev-server/test/boot-self-heal.test.ts

@@ -0,0 +1,112 @@
+// Boot self-heal logic — Phase 19 / DDR-044.
+// Covers the marketplace-cache-install gap: if dist/ or node_modules/ is
+// missing on boot, self-heal runs bun install + build. Opt out with
+// MAUDE_NO_AUTOBUILD=1.
+
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+import { bootSelfHeal, type SelfHealOptions } from '../boot-self-heal.ts';
+
+let TMP: string;
+
+beforeEach(() => {
+  TMP = mkdtempSync(join(tmpdir(), 'maude-self-heal-'));
+});
+
+afterEach(() => {
+  rmSync(TMP, { recursive: true, force: true });
+});
+
+function harness(extra: Partial<SelfHealOptions> = {}) {
+  const calls: { cmd: readonly string[]; cwd: string }[] = [];
+  const logs: string[] = [];
+  let exited: number | null = null;
+  const opts: SelfHealOptions = {
+    here: TMP,
+    optOut: false,
+    spawn: async (cmd, cwd) => {
+      calls.push({ cmd, cwd });
+      return { code: 0 };
+    },
+    log: (m) => logs.push(m),
+    exit: ((code: number) => {
+      exited = code;
+      throw new Error(`__exit:${code}`);
+    }) as never,
+    ...extra,
+  };
+  return { opts, calls, logs, getExited: () => exited };
+}
+
+function seedDist() {
+  mkdirSync(join(TMP, 'dist'), { recursive: true });
+  writeFileSync(join(TMP, 'dist', 'client.bundle.js'), '/* stub */');
+}
+
+function seedDeps() {
+  mkdirSync(join(TMP, 'node_modules', 'react'), { recursive: true });
+  writeFileSync(join(TMP, 'node_modules', 'react', 'package.json'), '{}');
+}
+
+describe('bootSelfHeal', () => {
+  test('skips when dist + node_modules both present', async () => {
+    seedDist();
+    seedDeps();
+    const { opts, calls } = harness();
+    const result = await bootSelfHeal(opts);
+    expect(result.skipped).toBe('all-present');
+    expect(result.ran).toEqual([]);
+    expect(calls).toEqual([]);
+  });
+
+  test('runs `bun install --production` when node_modules/react is missing', async () => {
+    seedDist();
+    const { opts, calls } = harness();
+    const result = await bootSelfHeal(opts);
+    expect(result.ran).toEqual(['install']);
+    expect(calls).toHaveLength(1);
+    expect(calls[0]?.cmd).toEqual(['bun', 'install', '--production']);
+    expect(calls[0]?.cwd).toBe(TMP);
+  });
+
+  test('runs `bun run build.ts` when dist/client.bundle.js is missing', async () => {
+    seedDeps();
+    const { opts, calls } = harness();
+    const result = await bootSelfHeal(opts);
+    expect(result.ran).toEqual(['build']);
+    expect(calls).toHaveLength(1);
+    expect(calls[0]?.cmd).toEqual(['bun', 'run', 'build.ts']);
+  });
+
+  test('runs install BEFORE build when both missing (build needs deps)', async () => {
+    const { opts, calls } = harness();
+    const result = await bootSelfHeal(opts);
+    expect(result.ran).toEqual(['install', 'build']);
+    expect(calls[0]?.cmd).toEqual(['bun', 'install', '--production']);
+    expect(calls[1]?.cmd).toEqual(['bun', 'run', 'build.ts']);
+  });
+
+  test('MAUDE_NO_AUTOBUILD=1: exits 1 with remediation message; no spawn', async () => {
+    const { opts, calls, logs, getExited } = harness({ optOut: true });
+    await expect(bootSelfHeal(opts)).rejects.toThrow('__exit:1');
+    expect(getExited()).toBe(1);
+    expect(calls).toEqual([]);
+    expect(logs.join('\n')).toMatch(/MAUDE_NO_AUTOBUILD=1/);
+    expect(logs.join('\n')).toMatch(/dist\/client\.bundle\.js/);
+    expect(logs.join('\n')).toMatch(/node_modules\/react/);
+  });
+
+  test('spawn failure aborts with exit 1 + remediation hint', async () => {
+    seedDist(); // only deps missing
+    const { opts, logs, getExited } = harness({
+      spawn: async () => ({ code: 42 }),
+    });
+    await expect(bootSelfHeal(opts)).rejects.toThrow('__exit:1');
+    expect(getExited()).toBe(1);
+    expect(logs.join('\n')).toMatch(/exited 42/);
+    expect(logs.join('\n')).toMatch(/MAUDE_NO_AUTOBUILD=1/);
+  });
+});

package/plugins/design/dev-server/test/compile-entry.test.ts

@@ -0,0 +1,134 @@
+// Regression test for writeCompileEntry — the per-target build helper that
+// works around Bun 1.3.4+ --compile NAPI native-binding embedding (DDR-NNN-
+// oxc-parser-bun-compile-workaround). The helper itself is pure (no compile,
+// no spawn): given a target, it writes two files (`init-oxc-<slug>.ts` +
+// `server-<slug>.ts`) under dist/.compile-entries/ and returns the entry path.
+
+import { existsSync, readFileSync, rmSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { describe, expect, test } from 'bun:test';
+
+import { writeCompileEntry } from '../build.ts';
+
+const ROOT = dirname(fileURLToPath(import.meta.url));
+const DEV_SERVER_ROOT = join(ROOT, '..');
+const ENTRY_DIR = join(DEV_SERVER_ROOT, 'dist', '.compile-entries');
+
+// PlatformTarget union mirrored from build.ts. Kept inline so the test fails
+// loudly if build.ts adds/removes a target without updating the test.
+const ALL_TARGETS = [
+  'bun-darwin-arm64',
+  'bun-darwin-x64',
+  'bun-linux-x64',
+  'bun-linux-arm64',
+  'bun-linux-x64-musl',
+  'bun-linux-arm64-musl',
+  'bun-windows-x64',
+] as const;
+
+// Maude-slug → @oxc-parser/binding-<X> NAPI slug. Mirrored from
+// build.ts:oxcBindingSlug — kept in sync intentionally.
+const EXPECTED_OXC_SLUG: Record<string, string> = {
+  'darwin-arm64': 'darwin-arm64',
+  'darwin-x64': 'darwin-x64',
+  'linux-x64': 'linux-x64-gnu',
+  'linux-arm64': 'linux-arm64-gnu',
+  'linux-x64-musl': 'linux-x64-musl',
+  'linux-arm64-musl': 'linux-arm64-musl',
+  'win32-x64': 'win32-x64-msvc',
+};
+
+function maudeSlug(target: string): string {
+  const s = target.replace(/^bun-/, '');
+  return s === 'windows-x64' ? 'win32-x64' : s;
+}
+
+describe('writeCompileEntry', () => {
+  test('produces init + entry files for every supported target', () => {
+    for (const target of ALL_TARGETS) {
+      const slug = maudeSlug(target);
+      const initPath = join(ENTRY_DIR, `init-oxc-${slug}.ts`);
+      const entryPath = join(ENTRY_DIR, `server-${slug}.ts`);
+
+      const returned = writeCompileEntry(target);
+      expect(returned).toBe(entryPath);
+      expect(existsSync(initPath)).toBe(true);
+      expect(existsSync(entryPath)).toBe(true);
+    }
+  });
+
+  test('init file embeds the matching oxc binding via with-type-file', () => {
+    for (const target of ALL_TARGETS) {
+      const slug = maudeSlug(target);
+      const oxcSlug = EXPECTED_OXC_SLUG[slug];
+      const initPath = join(ENTRY_DIR, `init-oxc-${slug}.ts`);
+
+      writeCompileEntry(target);
+      const content = readFileSync(initPath, 'utf8');
+
+      // Asset embed via Bun's with-type-file syntax — load-bearing for the
+      // workaround. Without `with { type: 'file' }` the import resolves to
+      // the .node's exports rather than its filesystem path.
+      expect(content).toContain(
+        `import bindingPath from "@oxc-parser/binding-${oxcSlug}/parser.${oxcSlug}.node" with { type: 'file' };`
+      );
+      // Env var must be set so oxc-parser's NAPI-RS loader (bindings.js)
+      // skips its broken platform-detection switch.
+      expect(content).toContain('process.env.NAPI_RS_NATIVE_LIBRARY_PATH = bindingPath;');
+    }
+  });
+
+  test('entry file imports init BEFORE server.ts (ESM evaluation order matters)', () => {
+    for (const target of ALL_TARGETS) {
+      const slug = maudeSlug(target);
+      const entryPath = join(ENTRY_DIR, `server-${slug}.ts`);
+
+      writeCompileEntry(target);
+      const content = readFileSync(entryPath, 'utf8');
+
+      const initIdx = content.indexOf(`./init-oxc-${slug}.ts`);
+      const serverIdx = content.indexOf('server.ts');
+      expect(initIdx).toBeGreaterThanOrEqual(0);
+      expect(serverIdx).toBeGreaterThanOrEqual(0);
+      // If server.ts is imported before init-oxc, oxc-parser evaluates first
+      // and reads NAPI_RS_NATIVE_LIBRARY_PATH before our env-var setter runs.
+      expect(initIdx).toBeLessThan(serverIdx);
+    }
+  });
+
+  test('entry uses POSIX path separators in the server.ts import', () => {
+    writeCompileEntry('bun-windows-x64');
+    const content = readFileSync(join(ENTRY_DIR, 'server-win32-x64.ts'), 'utf8');
+    // Even on a Windows host the generated import specifier must use forward
+    // slashes — ESM specifiers are not OS paths.
+    expect(content).not.toMatch(/\\/);
+  });
+
+  test('idempotent — calling twice yields identical content', () => {
+    const target = 'bun-darwin-arm64';
+    const slug = maudeSlug(target);
+
+    writeCompileEntry(target);
+    const a1 = readFileSync(join(ENTRY_DIR, `init-oxc-${slug}.ts`), 'utf8');
+    const e1 = readFileSync(join(ENTRY_DIR, `server-${slug}.ts`), 'utf8');
+
+    writeCompileEntry(target);
+    const a2 = readFileSync(join(ENTRY_DIR, `init-oxc-${slug}.ts`), 'utf8');
+    const e2 = readFileSync(join(ENTRY_DIR, `server-${slug}.ts`), 'utf8');
+
+    expect(a2).toBe(a1);
+    expect(e2).toBe(e1);
+  });
+
+  test('cleanup — generated files live under dist/.compile-entries/', () => {
+    // Sanity: the helper writes only to the expected directory; nothing
+    // leaks elsewhere. Sweep a stale prior dir, regenerate, verify scope.
+    rmSync(ENTRY_DIR, { recursive: true, force: true });
+    writeCompileEntry('bun-darwin-arm64');
+    expect(existsSync(ENTRY_DIR)).toBe(true);
+    expect(existsSync(join(ENTRY_DIR, 'init-oxc-darwin-arm64.ts'))).toBe(true);
+    expect(existsSync(join(ENTRY_DIR, 'server-darwin-arm64.ts'))).toBe(true);
+  });
+});

package/plugins/design/dev-server/test/runtime-bundle-error-mapping.test.ts

@@ -0,0 +1,43 @@
+// Phase 19 / DDR-044 — runtime-bundle error-message remediation.
+// When Bun.build fails because the global install cache is corrupted
+// (EISDIR/ENOENT on a cached package's entry file), surface an actionable
+// `bun pm cache rm <pkg>` hint instead of just relaying the raw log.
+
+import { describe, expect, test } from 'bun:test';
+
+import { bunCacheRemediation } from '../runtime-bundle.ts';
+
+describe('bunCacheRemediation', () => {
+  test('returns null on unrelated build failures (real syntax errors etc.)', () => {
+    expect(bunCacheRemediation('react', '[error] Unexpected token <')).toBeNull();
+    expect(bunCacheRemediation('react-dom', '[error] Could not resolve "missing-pkg"')).toBeNull();
+  });
+
+  test('matches EISDIR on .bun/install/cache + names the base package', () => {
+    const log =
+      "[error] EISDIR reading '/Users/iagh/.bun/install/cache/react@19.2.6@@@1 @@1/index.js'";
+    const out = bunCacheRemediation('react', log);
+    expect(out).not.toBeNull();
+    expect(out).toMatch(/bun pm cache rm react/);
+    expect(out).toMatch(/bad state/);
+  });
+
+  test('matches ENOENT on .bun/install/cache too', () => {
+    const log = "[error] ENOENT: '/Users/x/.bun/install/cache/react-dom@19.0.0/index.js'";
+    const out = bunCacheRemediation('react-dom', log);
+    expect(out).toMatch(/bun pm cache rm react-dom/);
+  });
+
+  test('subpath specifiers strip to the base package for the cache rm command', () => {
+    // bun pm cache works on base package names — "react/jsx-runtime" → "react".
+    const log = "[error] EISDIR '/Users/x/.bun/install/cache/react@19.2.6/jsx-runtime.js'";
+    const out = bunCacheRemediation('react/jsx-runtime', log);
+    expect(out).toMatch(/bun pm cache rm react\b/);
+    expect(out).not.toMatch(/bun pm cache rm react\//);
+  });
+
+  test('case-insensitive match (Bun has bounced casing across versions)', () => {
+    const log = '[error] eisdir reading /Users/x/.bun/install/cache/react@19/index.js';
+    expect(bunCacheRemediation('react', log)).not.toBeNull();
+  });
+});

package/plugins/design/templates/canvas.tsx.template

@@ -11,11 +11,11 @@
  *
  * Authored under {{DS_NAME}}. Tokens + shared component classes load via the
  * dev-server's _shell.html harness — link tags arrive automatically from the
- * iframe's ?tokens= / ?components= query. Class names match the DS's
- * `_components.css` (`.btn`, `.tile`, `.sku`, `.seg`, ...). Bespoke classes go
- * into a sibling .module.css iff `css_mode === "modules"`; for `inline` (the
- * MDCC-DSN/01 default) prefer existing classes + `style={{}}` for arbitrary
- * one-off values.
+ * iframe's ?tokens= / ?components= query. Class names come from the DS's
+ * own `_components.css` — see `system/{{DS_NAME}}/preview/` for the available
+ * class shapes. Bespoke classes go into a sibling .module.css iff
+ * `css_mode === "modules"`; for `inline` prefer existing classes + `style={{}}`
+ * for arbitrary one-off values.
  *
  * The envelope primitives (`DesignCanvas`, `DCSection`, `DCArtboard`) and any
  * specimen helpers come from the dev-server-bundled canvas library via the
@@ -40,11 +40,11 @@ export default function {{COMPONENT_NAME}}() {
     <DesignCanvas>
       <DCSection id="overview" title="{{SUBTITLE}}">
         <DCArtboard id="primary" label="A · primary" width={1280} height={800}>
-          <div className="mdcc" data-theme="{{THEME_DEFAULT}}">
+          <div className="{{ROOT_CLASS}}" data-theme="{{THEME_DEFAULT}}">
             {/* Replace this scaffold with the actual canvas content. The
                 envelope this template was rendered against is in
                 {{HISTORY_DIR}}/000-envelope.md. */}
-            <h1 className="sku">{{NAME}}</h1>
+            <h1>{{NAME}}</h1>
             <p>{{BRIEF}}</p>
           </div>
         </DCArtboard>

package/plugins/design/templates/design-system-inspiration/audience-pro/colors-presence.html

@@ -4,7 +4,7 @@ DEMONSTRATES: --presence-online, --presence-away, --presence-offline; presence d
 COMPOSITION: 4 avatars with presence dots (online / away / offline / idle) + a "live cursors" mockup with 3 simultaneous users
 COPY VOICE: real names, real timestamps
 WHEN SCAFFOLDED: presence family (IF "presence" ∈ activeFamilies — typically pro tools with multiplayer)
-NOTES: Presence dot is 8px circle bottom-right of 32-40px avatars (anchor on the visual bottom-right, not on a math grid). Cursor labels are subtle (pill at 11px, low opacity bg). Don't blink presence — too noisy in a busy view.
+NOTES: Presence dot is 8px circle bottom-right of 32-40px avatars (anchor on the visual bottom-right, not on a math grid). Per-user cursor colors below are illustrative only — the inline `oklch(...)` values are NOT part of the project's design system. A real implementation should source these from a `--presence-user-*` family or derive from `--accent` deterministically. Cursor labels are subtle (pill at 11px, low opacity bg). Don't blink presence — too noisy in a busy view.
 -->
 <!doctype html>
 <html lang="en">

package/plugins/design/templates/design-system-inspiration/core/README.philosophy.md.tpl

@@ -19,13 +19,15 @@
 
 ## Foundations
 
-### One-accent rule
+### Token contract
 
-Exactly one accent family lives in `colors_and_type.css`: `--accent`, `--accent-hover`, `--accent-active`, `--accent-fg`. **No `--accent2`.** Calls-to-attention compete with each other; one accent forces hierarchy decisions at design time, not runtime.
+All visuals reference `var(--*)` tokens declared in `colors_and_type.css`. Adding a new visual concept means **extending the tokens CSS first**, never inventing values inline in a canvas.
 
-### Token contract
+{{color_space_block}}
+
+### Accent strategy
 
-All visuals reference `var(--*)` tokens declared in `colors_and_type.css`. No hardcoded hex / px / rem in canvases or production code. Adding a new visual concept means **extending the tokens CSS first**, never inventing values inline.
+{{accent_rules_block}}
 
 ### Active token families
 
@@ -33,8 +35,9 @@ All visuals reference `var(--*)` tokens declared in `colors_and_type.css`. No ha
 
 ## Hard rules (non-negotiable)
 
-- **Accessibility:** WCAG 2.1 AA contrast at every theme. Focus-visible always rendered. Touch targets ≥ 44×44. `prefers-reduced-motion: reduce` respected.
-- **No off-token colors / radii / spacings** in canvases. Extend tokens; don't inline.
+- **Accessibility:** WCAG 2.1 AA contrast at every theme. Focus-visible always rendered. `prefers-reduced-motion: reduce` respected.
+- **Touch targets:** {{touch_target_rule}}
+- **No off-token values** in canvases. Extend tokens; don't inline.
 - **No placeholder copy.** Real product strings only — no "Lorem Solutions Inc.", no "Click here".
 - **Type ladder:** {{type_scale_summary}}
 - **Motion:** every animation uses a `var(--dur-*)` and `var(--ease-*)` token. No magic numbers.
@@ -52,7 +55,8 @@ All visuals reference `var(--*)` tokens declared in `colors_and_type.css`. No ha
 ## Hard-stops the completeness-critic enforces
 
 - Core tokens present (`--accent`, `--bg-0..4`, `--fg-0..3`, `--dur-flip`)
-- Exactly one accent family
+- Accent family count matches the declared strategy ({{accent_strategy_summary}})
+- Color space matches the declared choice ({{color_space_summary}})
 - `system/{{ds_dirname}}/preview/` populated with at least 8 specimens
 - `colors_and_type.css` linked from every specimen
 - `prefers-reduced-motion: reduce` guard present in tokens CSS

package/plugins/design/templates/design-system-inspiration/core/SKILL.md.tpl

@@ -24,8 +24,9 @@ It is **not** auto-invoked by `/design:edit` or `/design:new` on a project with
 
 ## What the agent should remember
 
-- **One accent.** No `--accent2`. Calls-to-attention compete; one accent forces hierarchy decisions.
-- **All visuals reference `var(--*)` tokens.** No hardcoded hex / px / rem in canvases.
+- **Accent strategy:** {{accent_strategy_summary}}. {{accent_rules_summary}}
+- **All visuals reference `var(--*)` tokens.** No off-token values in canvases.
+- **Color space:** {{color_space_summary}}.
 - **Voice:** {{voice_tone_summary}}
 - **Iconography:** {{iconography_summary}}
 - **Theme default:** `{{theme_default}}`. {{theme_extra}}
@@ -47,4 +48,4 @@ It is **not** auto-invoked by `/design:edit` or `/design:new` on a project with
 
 ## How to extend
 
-If a canvas iteration needs a value not currently in the system, **extend `colors_and_type.css` first**. Adding a new variant of an existing token (e.g. `--accent-tertiary`) is fine; adding a parallel accent family (e.g. `--accent2`) violates the one-accent rule and the completeness-critic will block.
+If a canvas iteration needs a value not currently in the system, **extend `colors_and_type.css` first**. Adding a new variant of an existing token (e.g. `--accent-tertiary`) is fine. Adding a parallel accent family (e.g. `--accent2`) is only allowed if the project's declared `accentStrategy` in `config.json` permits it (e.g. `paired` or `chromatic-N`) — the completeness-critic enforces the declared strategy.

package/plugins/design/templates/design-system-inspiration/core/colors_and_type.css.tpl

@@ -4,55 +4,59 @@
  * Authoritative token file. Every canvas in <designRoot>/ui/ links to this.
  * Production code should consume the same values (compiled to TS/JS or kept as CSS vars).
  *
- * Contract:
- * - OKLCH for accent + status colors (better gamut control than HSL/hex)
- * - One accent family only (no --accent2)
- * - Theme: {{theme_default}} (single-block) — duplicate for both-equal projects
- * - Motion durations + easings + reduced-motion guard
- * - 8-step type ladder, 4px-base spacing scale
+ * This file is the single source of truth for the project's visual language.
+ * Every concrete value below is supplied by the discovery payload — there are
+ * NO universal defaults baked into this template. Spacing, type, easing,
+ * shadows, max-width, accent strategy, and color space are all project-flavored.
+ *
+ * Two invariants this template does enforce:
+ *   1. `prefers-reduced-motion: reduce` collapses every duration to 1ms (a11y).
+ *   2. Tokens used by canvases live under one of the documented family prefixes
+ *      (--bg-*, --fg-*, --accent*, --border-*, --status-*, --space-*, --type-*,
+ *      --lh-*, --radius-*, --shadow-*, --dur-*, --ease-*, --layout-*, --font-*).
+ *
+ * Everything else — palette structure, type ladder, motion personality — is
+ * a project decision recorded during /design:setup-ds.
  */
 
 :root,
 .{{root_class}}[data-theme="{{theme_default}}"] {
   /* ─── Surfaces (deepest → highest) ─────────────────────────────────── */
-  --bg-0: {{bg_0_oklch}};   /* page bg                    */
-  --bg-1: {{bg_1_oklch}};   /* card / panel bg            */
-  --bg-2: {{bg_2_oklch}};   /* nested panel / popover     */
-  --bg-3: {{bg_3_oklch}};   /* input bg / subtle row hover */
-  --bg-4: {{bg_4_oklch}};   /* hover / pressed state      */
+  --bg-0: {{bg_0}};   /* page bg                    */
+  --bg-1: {{bg_1}};   /* card / panel bg            */
+  --bg-2: {{bg_2}};   /* nested panel / popover     */
+  --bg-3: {{bg_3}};   /* input bg / subtle row hover */
+  --bg-4: {{bg_4}};   /* hover / pressed state      */
 
   /* ─── Borders ──────────────────────────────────────────────────────── */
-  --border-subtle:  oklch(from var(--bg-1) calc(l + 0.04) c h);
-  --border-default: oklch(from var(--bg-1) calc(l + 0.08) c h);
-  --border-strong:  oklch(from var(--bg-1) calc(l + 0.14) c h);
+  --border-subtle:  {{border_subtle}};
+  --border-default: {{border_default}};
+  --border-strong:  {{border_strong}};
 
   /* ─── Text ─────────────────────────────────────────────────────────── */
-  --fg-0: {{fg_0_oklch}};   /* primary text                */
-  --fg-1: {{fg_1_oklch}};   /* secondary text              */
-  --fg-2: {{fg_2_oklch}};   /* tertiary / muted            */
-  --fg-3: {{fg_3_oklch}};   /* disabled                    */
+  --fg-0: {{fg_0}};   /* primary text                */
+  --fg-1: {{fg_1}};   /* secondary text              */
+  --fg-2: {{fg_2}};   /* tertiary / muted            */
+  --fg-3: {{fg_3}};   /* disabled                    */
 
-  /* ─── Accent (ONE family only) ─────────────────────────────────────── */
-  --accent:        {{accent_oklch}};
-  --accent-hover:  oklch(from var(--accent) calc(l - 0.04) c h);
-  --accent-active: oklch(from var(--accent) calc(l - 0.08) c h);
-  --accent-fg:     {{accent_fg_oklch}};
+  /* ─── Accent ({{accent_strategy_summary}}) ─────────────────────────── */
+{{accent_block}}
 
   /* ─── Status (only if "status" ∈ activeFamilies) ───────────────────── */
-  --status-success: oklch(70% 0.18 145);
-  --status-warn:    oklch(78% 0.16  85);
-  --status-error:   oklch(64% 0.21  25);
-  --status-info:    oklch(70% 0.13 230);
+  --status-success: {{status_success}};
+  --status-warn:    {{status_warn}};
+  --status-error:   {{status_error}};
+  --status-info:    {{status_info}};
 
   /* ─── Presence (only if "presence" ∈ activeFamilies) ───────────────── */
-  --presence-online:  var(--status-success);
-  --presence-away:    var(--status-warn);
-  --presence-offline: var(--fg-3);
+  --presence-online:  {{presence_online}};
+  --presence-away:    {{presence_away}};
+  --presence-offline: {{presence_offline}};
 
   /* ─── Shadows / elevation ──────────────────────────────────────────── */
-  --shadow-sm: 0 1px 2px oklch(0 0 0 / 0.20);
-  --shadow-md: 0 4px 12px oklch(0 0 0 / 0.25);
-  --shadow-lg: 0 12px 32px oklch(0 0 0 / 0.30);
+  --shadow-sm: {{shadow_sm}};
+  --shadow-md: {{shadow_md}};
+  --shadow-lg: {{shadow_lg}};
 
   /* ─── Radii ────────────────────────────────────────────────────────── */
   --radius-xs: {{radius_xs}};
@@ -60,45 +64,45 @@
   --radius-md: {{radius_md}};
   --radius-lg: {{radius_lg}};
   --radius-xl: {{radius_xl}};
-  --radius-pill: 999px;
+  --radius-pill: {{radius_pill}};
 
-  /* ─── Spacing (4px base) ───────────────────────────────────────────── */
-  --space-0:  0;
-  --space-1:  4px;
-  --space-2:  8px;
-  --space-3: 12px;
-  --space-4: 16px;
-  --space-5: 24px;
-  --space-6: 32px;
-  --space-7: 48px;
-  --space-8: 64px;
+  /* ─── Spacing ──────────────────────────────────────────────────────── */
+  --space-0: {{space_0}};
+  --space-1: {{space_1}};
+  --space-2: {{space_2}};
+  --space-3: {{space_3}};
+  --space-4: {{space_4}};
+  --space-5: {{space_5}};
+  --space-6: {{space_6}};
+  --space-7: {{space_7}};
+  --space-8: {{space_8}};
 
   /* ─── Typography ───────────────────────────────────────────────────── */
   --font-display: {{font_display}};
   --font-body:    {{font_body}};
   --font-mono:    {{font_mono}};
 
-  /* 8-step type scale */
-  --type-xs:   12px;  --lh-xs:   16px;
-  --type-sm:   13px;  --lh-sm:   18px;
-  --type-base: 14px;  --lh-base: 20px;
-  --type-md:   16px;  --lh-md:   22px;
-  --type-lg:   18px;  --lh-lg:   26px;
-  --type-xl:   22px;  --lh-xl:   30px;
-  --type-2xl:  28px;  --lh-2xl:  36px;
-  --type-3xl:  36px;  --lh-3xl:  44px;
+  /* Type scale */
+  --type-xs:   {{type_xs}};    --lh-xs:   {{lh_xs}};
+  --type-sm:   {{type_sm}};    --lh-sm:   {{lh_sm}};
+  --type-base: {{type_base}};  --lh-base: {{lh_base}};
+  --type-md:   {{type_md}};    --lh-md:   {{lh_md}};
+  --type-lg:   {{type_lg}};    --lh-lg:   {{lh_lg}};
+  --type-xl:   {{type_xl}};    --lh-xl:   {{lh_xl}};
+  --type-2xl:  {{type_2xl}};   --lh-2xl:  {{lh_2xl}};
+  --type-3xl:  {{type_3xl}};   --lh-3xl:  {{lh_3xl}};
 
   /* ─── Motion ───────────────────────────────────────────────────────── */
   --dur-flip:  {{dur_flip}};
   --dur-panel: {{dur_panel}};
   --dur-route: {{dur_route}};
   --dur-soft:  {{dur_soft}};
-  --ease-out:    cubic-bezier(0.22, 1, 0.36, 1);
-  --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
+  --ease-out:    {{ease_out_curve}};
+  --ease-in-out: {{ease_in_out_curve}};
 
   /* ─── Layout ───────────────────────────────────────────────────────── */
-  --layout-max-w: 1200px;
-  --layout-gutter: var(--space-4);
+  --layout-max-w:  {{layout_max_w}};
+  --layout-gutter: {{layout_gutter}};
 }
 
 @media (prefers-reduced-motion: reduce) {

package/plugins/design/templates/design-system-inspiration/core/config.json.tpl

@@ -17,6 +17,8 @@
   "extensions": [],
   "completenessProfile": "standard",
   "activeFamilies": {{active_families}},
+  "accentStrategy": "{{accent_strategy}}",
+  "colorSpace": "{{color_space}}",
   "designSystems": [
     {
       "name": "{{ds_dirname}}",