@stylecrib/cli 0.3.1 → 0.3.2

package/dist/index.js

@@ -281,10 +281,10 @@ var init_slop_rules = __esm({
       },
       {
         id: "R-SECOND-ACCENT",
-        description: "Component introduces a second saturated accent hue on a theme whose theme.yml declares single_accent (e.g. signal-dark, enterprise-tech, pharma-clinical, kinetic-data). Alarms/status must use ink + hairline + mono glyph, not a second hue.",
+        description: "Component introduces a second saturated accent hue on a theme whose policy permits exactly one (signal-dark, enterprise-tech, pharma-clinical, kinetic-data). Alarms/status must use ink + hairline + mono glyph, not a second hue. Theme-aware: resolves the active theme from .stylecrib/config.json and its permitted accent from the bundled themes/, then compares hue distance. No-ops when the theme isn't resolvable or has no single-accent policy.",
         severity: "block",
         category: "palette",
-        specSource: "theme.yml single_accent field",
+        specSource: "slop-blocklist.md",
         detectorAt: "check.ts"
       },
       {
@@ -371,19 +371,19 @@ var init_slop_rules = __esm({
       },
       {
         id: "R-MONO-CAPS-SECTION-EYEBROW",
-        description: "Section source renders `SECTION \xB7 X` / `CHAPTER \xB7 X` / `PART <N>` / `WHAT WE X` mono-caps section eyebrow above content \u2014 universal slop.",
+        description: "Renders `SECTION \xB7 X` / `CHAPTER \xB7 X` / `PART <N>` / `WHAT WE X` mono-caps section eyebrow above content \u2014 universal slop. Detected at both the component level (check.ts, anchored to quoted/JSX text) and at theme materialization (slop-blocklist.ts).",
         severity: "block",
         category: "typography",
-        specSource: "theme-harness/gates/slop-blocklist.ts",
-        detectorAt: "slop-blocklist.ts"
+        specSource: "slop-blocklist.md",
+        detectorAt: "check.ts"
       },
       {
         id: "R-CORNER-TAG-ABBREVIATION",
-        description: "Small mono-caps corner tags with period abbreviations (`NO. 03`, `EST. 2019`, `VOL. 2`, `CH. 4`, `ESSAY NO. 04`) \u2014 editorial-ornament defaults, always slop.",
+        description: "Small mono-caps corner tags with period abbreviations (`NO. 03`, `EST. 2019`, `VOL. 2`, `CH. 4`, `ESSAY NO. 04`) \u2014 editorial-ornament defaults, always slop. Detected at both the component level (check.ts, digit-suffixed only) and at theme materialization (slop-blocklist.ts, which also matches interpolated values).",
         severity: "block",
         category: "content",
-        specSource: "theme-harness/gates/slop-blocklist.ts",
-        detectorAt: "slop-blocklist.ts"
+        specSource: "slop-blocklist.md",
+        detectorAt: "check.ts"
       },
       {
         id: "R-READ-TIME-META",
@@ -403,19 +403,19 @@ var init_slop_rules = __esm({
       },
       {
         id: "R-BYLINE-MONO-CAPS",
-        description: "Bylines rendered in mono-caps (`BY R. IWASAKI`, `WORDS BY X`, `PHOTOGRAPHY BY Y`) \u2014 real editorial bylines are set in body type; mono-caps bylines are editorial cosplay.",
+        description: "Bylines rendered in mono-caps (`BY R. IWASAKI`, `WORDS BY X`, `PHOTOGRAPHY BY Y`) \u2014 real editorial bylines are set in body type; mono-caps bylines are editorial cosplay. Detected at both the component level (check.ts) and at theme materialization (slop-blocklist.ts).",
         severity: "block",
         category: "typography",
-        specSource: "theme-harness/gates/slop-blocklist.ts",
-        detectorAt: "slop-blocklist.ts"
+        specSource: "slop-blocklist.md",
+        detectorAt: "check.ts"
       },
       {
         id: "R-TAG-ROW-ABOVE-BODY",
-        description: "`\u25B8 TAG` / `\u25C6 TAG` / `\xBB TAG` / `\u25CF TAG` mono-caps prefix labels used as category tags next to body copy \u2014 the eyebrow relocated, still slop.",
+        description: "`\u25B8 TAG` / `\u25C6 TAG` / `\xBB TAG` / `\u25CF TAG` mono-caps prefix labels used as category tags next to body copy \u2014 the eyebrow relocated, still slop. Detected at both the component level (check.ts) and at theme materialization (slop-blocklist.ts).",
         severity: "block",
         category: "typography",
-        specSource: "theme-harness/gates/slop-blocklist.ts",
-        detectorAt: "slop-blocklist.ts"
+        specSource: "slop-blocklist.md",
+        detectorAt: "check.ts"
       },
       {
         id: "R-TRUSTED-BY-EMPTY-ROW",
@@ -477,9 +477,8 @@ import { Command } from "commander";
 
 // src/commands/init.ts
 init_esm_shims();
-import { resolve as resolve6, basename, dirname as dirname6 } from "path";
+import { resolve as resolve5, join as join8, basename } from "path";
 import { readFile as readFile6 } from "fs/promises";
-import { fileURLToPath as fileURLToPath4 } from "url";
 import { confirm as confirm2 } from "@inquirer/prompts";
 
 // src/lib/colors.ts
@@ -508,6 +507,74 @@ function step(n, total, label) {
 // src/wizard.ts
 init_esm_shims();
 import { select, input, confirm, editor } from "@inquirer/prompts";
+
+// src/lib/errors.ts
+init_esm_shims();
+var CliError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "CliError";
+  }
+};
+var MissingApiKeyError = class extends CliError {
+  constructor() {
+    super(
+      "ANTHROPIC_API_KEY not set.\n\nThe key is needed for two things: synthesizing a direction from your own\nreferences, and the deep review the pre-commit hook runs. Installing a\ncanonical theme as-is needs no key and makes no API call:\n\n  npx stylecrib init --style soft-modern --yes\n\nTo use references, get a key at https://console.anthropic.com/ and run:\n\n  export ANTHROPIC_API_KEY=sk-ant-...\n\nOr pass it inline for one run:\n\n  ANTHROPIC_API_KEY=sk-ant-... npx stylecrib init"
+    );
+    this.name = "MissingApiKeyError";
+  }
+};
+var NotAGitRepoError = class extends CliError {
+  constructor(target) {
+    super(
+      `Not a git repository: ${target}
+
+The enforcement layer is a git pre-commit hook, so there has to be a repo
+to hook into. Run \`git init\` there first, then \`stylecrib install-hooks\`.`
+    );
+    this.name = "NotAGitRepoError";
+  }
+};
+var HookCollisionError = class extends CliError {
+  paths;
+  wrote;
+  /**
+   * @param paths  files skipped because they exist with different content
+   * @param wrote  how many files DID land before this was thrown
+   *
+   * The count matters. installHooks writes every non-colliding file and only
+   * then throws, so the install is partial — saying "nothing was written"
+   * (as this did) sends the customer looking for a clean slate that isn't
+   * there.
+   */
+  constructor(paths, wrote = 0) {
+    super(
+      `${paths.length} file(s) already exist with different content and were left alone.
+
+` + paths.map((p) => `  \xB7 ${p}`).join("\n") + (wrote > 0 ? `
+
+${wrote} other file(s) WERE written, so this install is partial \u2014 the enforcement layer is not fully wired yet.` : "") + "\n\nRe-run with --force to overwrite the files above (each is backed up to\n<name>.pre-stylecrib.bak first), or merge them by hand and re-run."
+    );
+    this.name = "HookCollisionError";
+    this.paths = paths;
+    this.wrote = wrote;
+  }
+};
+var StackMismatchError = class extends CliError {
+  constructor(detail) {
+    super(
+      `Project stack not supported in v1.
+
+${detail}
+
+v1 targets React + Tailwind + Vite + TS. Vue, Svelte, Next, styled-components, CSS modules are v2.
+If you're sure the project matches and detection misfired, pass --target with the correct path.`
+    );
+    this.name = "StackMismatchError";
+  }
+};
+
+// src/wizard.ts
 var DIRECTION_CHOICES = [
   // reading-first
   {
@@ -650,11 +717,29 @@ var DIRECTION_CHOICES = [
   }
 ];
 async function runWizard(opts) {
+  assertValidDirection(opts.skippedStyle);
+  if (opts.nonInteractive) {
+    const out = {
+      baseDirection: opts.skippedStyle ?? "soft-modern",
+      projectName: opts.defaultProjectName,
+      references: [],
+      antiReferences: [],
+      vibe: "",
+      urls: [],
+      imagePaths: []
+    };
+    console.log(header("StyleCrib \u2014 non-interactive install"));
+    printSummary(out);
+    console.log(
+      c.dim("  Refine any of this later with `npx stylecrib init` from a terminal.\n")
+    );
+    return out;
+  }
   console.log(header("StyleCrib \u2014 design upgrade wizard"));
   console.log(
     "Answer a few questions and the Director will synthesize a design direction\nfor your project. Reference brands beat hex codes; vivid words beat specs.\n"
   );
-  const baseDirection = opts.skippedStyle && isValidDirection(opts.skippedStyle) ? opts.skippedStyle : await select({
+  const baseDirection = opts.skippedStyle ? opts.skippedStyle : await select({
     message: "Pick a starting direction (you can refine it with references next):",
     choices: DIRECTION_CHOICES,
     default: "soft-modern"
@@ -717,14 +802,14 @@ async function runWizard(opts) {
     }
   }
   console.log(header("Summary"));
-  console.log("  " + c.dim("Base direction: ") + c.bold(baseDirection));
-  console.log("  " + c.dim("Project:        ") + projectName);
-  console.log("  " + c.dim("References:     ") + (references.length ? references.join(", ") : c.dim("(none)")));
-  console.log("  " + c.dim("Avoid:          ") + (antiReferences.length ? antiReferences.join(", ") : c.dim("(none)")));
-  console.log("  " + c.dim("Vibe:           ") + (vibe || c.dim("(none)")));
-  console.log("  " + c.dim("URLs:           ") + (urls.length ? urls.join(", ") : c.dim("(none)")));
-  console.log("  " + c.dim("Images:         ") + (imagePaths.length ? imagePaths.join(", ") : c.dim("(none)")));
-  console.log("");
+  printSummary({ baseDirection, projectName, references, antiReferences, vibe, urls, imagePaths });
+  const willCallDirector = baseDirection === "custom" || references.length > 0 || antiReferences.length > 0 || !!vibe || urls.length > 0 || imagePaths.length > 0;
+  if (willCallDirector && !process.env.ANTHROPIC_API_KEY) {
+    console.log(
+      c.warn("  \u26A0 ANTHROPIC_API_KEY is not set, and these answers need the Director.\n") + c.dim("    Set the key and re-run, or clear the references above to install the\n") + c.dim(`    canonical "${baseDirection}" theme verbatim with no API call.
+`)
+    );
+  }
   const proceed = await confirm({
     message: "Send this to the Director and write outputs?",
     default: true
@@ -746,73 +831,36 @@ async function runWizard(opts) {
 function parseList(raw) {
   return raw.split(",").map((s) => s.trim()).filter(Boolean);
 }
+function printSummary(w) {
+  console.log("  " + c.dim("Base direction: ") + c.bold(w.baseDirection));
+  console.log("  " + c.dim("Project:        ") + w.projectName);
+  console.log("  " + c.dim("References:     ") + (w.references.length ? w.references.join(", ") : c.dim("(none)")));
+  console.log("  " + c.dim("Avoid:          ") + (w.antiReferences.length ? w.antiReferences.join(", ") : c.dim("(none)")));
+  console.log("  " + c.dim("Vibe:           ") + (w.vibe || c.dim("(none)")));
+  console.log("  " + c.dim("URLs:           ") + (w.urls.length ? w.urls.join(", ") : c.dim("(none)")));
+  console.log("  " + c.dim("Images:         ") + (w.imagePaths.length ? w.imagePaths.join(", ") : c.dim("(none)")));
+  console.log("");
+}
+var VALID_DIRECTIONS = DIRECTION_CHOICES.map((d) => d.value);
 function isValidDirection(s) {
-  return [
-    "editorial",
-    "newsletter",
-    "soft-modern",
-    "dense-utility",
-    "glassmorphic-modern",
-    "signal-dark",
-    "cinematic-dark",
-    "outdoor-adventure",
-    "brutalist",
-    "hyperminimal-mono",
-    "mid-century",
-    "maximalist",
-    "y2k-chrome",
-    "couture-luxury",
-    "stadium-sport",
-    "performance-engineered",
-    "saturday-morning",
-    "enterprise-tech",
-    "creator-social",
-    "kaiju-reveal",
-    "runway-fashion",
-    "streetwear-hype",
-    "architectural",
-    "kinetic-data",
-    "indie-art-game",
-    "custom"
-  ].includes(s);
+  return VALID_DIRECTIONS.includes(s);
+}
+function assertValidDirection(slug) {
+  if (slug === void 0 || isValidDirection(slug)) return;
+  throw new CliError(
+    `Unknown --style "${slug}".
+
+Valid directions:
+${VALID_DIRECTIONS.map((v) => `  \xB7 ${v}`).join("\n")}
+
+Browse them at https://github.com/frischermf/stylecrib/tree/main/themes`
+  );
 }
 
 // src/ingest.ts
 init_esm_shims();
 import { readFile } from "fs/promises";
 import { extname } from "path";
-
-// src/lib/errors.ts
-init_esm_shims();
-var CliError = class extends Error {
-  constructor(message, options) {
-    super(message, options);
-    this.name = "CliError";
-  }
-};
-var MissingApiKeyError = class extends CliError {
-  constructor() {
-    super(
-      "ANTHROPIC_API_KEY not set.\n\nStyleCrib calls the Anthropic API to synthesize your design direction.\nGet a key at https://console.anthropic.com/, then run:\n\n  export ANTHROPIC_API_KEY=sk-ant-...\n\nOr pass it inline for one run:\n\n  ANTHROPIC_API_KEY=sk-ant-... npx stylecrib init"
-    );
-    this.name = "MissingApiKeyError";
-  }
-};
-var StackMismatchError = class extends CliError {
-  constructor(detail) {
-    super(
-      `Project stack not supported in v1.
-
-${detail}
-
-v1 targets React + Tailwind + Vite + TS. Vue, Svelte, Next, styled-components, CSS modules are v2.
-If you're sure the project matches and detection misfired, pass --target with the correct path.`
-    );
-    this.name = "StackMismatchError";
-  }
-};
-
-// src/ingest.ts
 async function ingestUrl(url) {
   const res = await fetch(url, {
     headers: {
@@ -835,16 +883,16 @@ async function ingestUrl(url) {
     );
   }
   const html = await res.text();
-  const text = htmlToReadableText(html);
+  const text2 = htmlToReadableText(html);
   console.log(
     c.dim(
-      `  \xB7 fetched ${url} (${(html.length / 1024).toFixed(1)} KB HTML \u2192 ${(text.length / 1024).toFixed(1)} KB text)`
+      `  \xB7 fetched ${url} (${(html.length / 1024).toFixed(1)} KB HTML \u2192 ${(text2.length / 1024).toFixed(1)} KB text)`
     )
   );
   return {
     type: "text",
     text: `=== URL reference: ${url} ===
-` + text.slice(0, 12e3) + (text.length > 12e3 ? "\n[...truncated]" : "")
+` + text2.slice(0, 12e3) + (text2.length > 12e3 ? "\n[...truncated]" : "")
   };
 }
 async function ingestImage(path2) {
@@ -1026,32 +1074,62 @@ Now produce the JSON object exactly as your system prompt specifies. Synthesize,
 // src/writer.ts
 init_esm_shims();
 import { mkdir, writeFile, readFile as readFile2, access, cp, readdir, stat } from "fs/promises";
-import { join, dirname, resolve, relative } from "path";
+import { join as join2, dirname as dirname2, relative } from "path";
+
+// src/lib/assets.ts
+init_esm_shims();
+import { existsSync, readdirSync } from "fs";
+import { dirname, join, resolve } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var __dirname2 = dirname(fileURLToPath2(import.meta.url));
-function findAgentsDir() {
+var cache = /* @__PURE__ */ new Map();
+function resolveAssetDir(kind) {
+  const hit = cache.get(kind);
+  if (hit !== void 0) return hit;
   const candidates = [
-    resolve(__dirname2, "..", "agents"),
-    resolve(__dirname2, "..", "..", "agents")
+    resolve(__dirname2, "..", kind),
+    // npm install: <pkg>/dist/../<kind>
+    resolve(__dirname2, "..", "..", kind),
+    // dev monorepo: cli/dist/../../<kind>
+    resolve(__dirname2, "..", "..", "..", kind)
   ];
-  return candidates[0];
+  const found = candidates.find((p) => existsSync(p) && looksLikeOurs(p, kind)) ?? null;
+  cache.set(kind, found);
+  return found;
+}
+function looksLikeOurs(dir, kind) {
+  try {
+    if (kind === "agents") {
+      return existsSync(join(dir, "MANIFEST.yml"));
+    }
+    const entries = readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).slice(0, 40);
+    return entries.some(
+      (e) => existsSync(join(dir, e.name, "THEME.md")) || existsSync(join(dir, e.name, "tokens.ts"))
+    );
+  } catch {
+    return false;
+  }
+}
+function missingAssetMessage(kind) {
+  return `The CLI install is missing its bundled ${kind}/ directory. Reinstall with \`npm install -D @stylecrib/cli\`, or report this at https://github.com/frischermf/stylecrib/issues.`;
 }
+
+// src/writer.ts
 async function stageOutputs(opts) {
   const { targetRoot, director, emitted } = opts;
-  const stagingRoot = join(targetRoot, ".design-upgrade");
+  const stagingRoot = join2(targetRoot, ".design-upgrade");
   const filesStaged = [];
   const filesSkipped = [];
   await mkdir(stagingRoot, { recursive: true });
   await stage(
-    join(targetRoot, "design-system", "THEME.md"),
+    join2(targetRoot, "design-system", "THEME.md"),
     director.directionMarkdown,
     stagingRoot,
     targetRoot,
     filesStaged,
     filesSkipped
   );
-  const agentsDir = findAgentsDir();
-  for (const name of [
+  const agentNames = [
     "design-director.md",
     "design-systems-engineer.md",
     "component-qa.md",
@@ -1060,22 +1138,31 @@ async function stageOutputs(opts) {
     "logo-designer.md",
     "brand-identity.md",
     "marketing-designer.md"
-  ]) {
-    try {
-      const content = await readFile2(join(agentsDir, name), "utf8");
-      await stage(
-        join(targetRoot, ".claude", "agents", name),
-        content,
-        stagingRoot,
-        targetRoot,
-        filesStaged,
-        filesSkipped
-      );
-    } catch (e) {
-      filesSkipped.push({
-        targetPath: join(targetRoot, ".claude", "agents", name),
-        reason: `source missing \u2014 ${e.message}`
-      });
+  ];
+  const agentsDir = resolveAssetDir("agents");
+  if (!agentsDir) {
+    filesSkipped.push({
+      targetPath: join2(targetRoot, ".claude", "agents"),
+      reason: missingAssetMessage("agents")
+    });
+  } else {
+    for (const name of agentNames) {
+      try {
+        const content = await readFile2(join2(agentsDir, name), "utf8");
+        await stage(
+          join2(targetRoot, ".claude", "agents", name),
+          content,
+          stagingRoot,
+          targetRoot,
+          filesStaged,
+          filesSkipped
+        );
+      } catch (e) {
+        filesSkipped.push({
+          targetPath: join2(targetRoot, ".claude", "agents", name),
+          reason: `source missing \u2014 ${e.message}`
+        });
+      }
     }
   }
   await stage(
@@ -1099,11 +1186,11 @@ async function stageOutputs(opts) {
 }
 async function stage(targetPath, content, stagingRoot, targetRoot, filesStaged, _filesSkipped) {
   const rel = relative(targetRoot, targetPath);
-  const stagedPath = join(stagingRoot, rel);
-  await mkdir(dirname(stagedPath), { recursive: true });
+  const stagedPath = join2(stagingRoot, rel);
+  await mkdir(dirname2(stagedPath), { recursive: true });
   await writeFile(stagedPath, content, "utf8");
   filesStaged.push({ stagedPath, targetPath });
-  console.log(c.ok("  + ") + c.dim(relPath(stagedPath)));
+  console.log(c.ok("  + ") + c.dim(relPath(stagedPath, targetRoot)));
 }
 var ROUTING_MARK_START = "<!-- stylecrib:routing:start -->";
 var ROUTING_MARK_END = "<!-- stylecrib:routing:end -->";
@@ -1129,7 +1216,7 @@ Source of truth for design: \`design-system/THEME.md\`.
 ${ROUTING_MARK_END}
 `;
 async function writePatchInstruction(targetRoot, stagingRoot, filesStaged) {
-  const claudeMdPath = join(targetRoot, "CLAUDE.md");
+  const claudeMdPath = join2(targetRoot, "CLAUDE.md");
   const exists = await fileExists(claudeMdPath);
   let stagedContent;
   if (!exists) {
@@ -1147,23 +1234,23 @@ See \`design-system/THEME.md\` and \`.claude/agents/\` for the design team.
     }
     stagedContent = current.replace(/\s*$/, "") + "\n\n" + ROUTING_BLOCK;
   }
-  const stagedPath = join(stagingRoot, "CLAUDE.md");
-  await mkdir(dirname(stagedPath), { recursive: true });
+  const stagedPath = join2(stagingRoot, "CLAUDE.md");
+  await mkdir(dirname2(stagedPath), { recursive: true });
   await writeFile(stagedPath, stagedContent, "utf8");
   filesStaged.push({ stagedPath, targetPath: claudeMdPath });
-  console.log(c.ok("  + ") + c.dim(relPath(stagedPath)));
+  console.log(c.ok("  + ") + c.dim(relPath(stagedPath, targetRoot)));
 }
 async function* walk(dir) {
   const entries = await readdir(dir);
   for (const e of entries) {
-    const p = join(dir, e);
+    const p = join2(dir, e);
     const s = await stat(p);
     if (s.isDirectory()) yield* walk(p);
     else yield p;
   }
 }
 async function copyFile(src, dest) {
-  await mkdir(dirname(dest), { recursive: true });
+  await mkdir(dirname2(dest), { recursive: true });
   await cp(src, dest);
 }
 async function fileExists(p) {
@@ -1174,22 +1261,21 @@ async function fileExists(p) {
     return false;
   }
 }
-function relPath(p) {
-  const cwd = process.cwd();
-  return p.startsWith(cwd) ? p.slice(cwd.length + 1) : p;
+function relPath(p, base) {
+  return relative(base, p) || p;
 }
 
 // src/codemod/detect.ts
 init_esm_shims();
 import { readFile as readFile3, access as access2 } from "fs/promises";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 var REQUIRED_DEPS = {
   react: { name: "react", minMajor: 18 },
   vite: { name: "vite", minMajor: 5 },
-  tailwind: { name: "tailwindcss", minMajor: 3 }
+  tailwind: { name: "tailwindcss", minMajor: 3, maxMajor: 3 }
 };
 async function detectStack(rootPath) {
-  const pkgPath = join2(rootPath, "package.json");
+  const pkgPath = join3(rootPath, "package.json");
   let pkg;
   try {
     pkg = JSON.parse(await readFile3(pkgPath, "utf8"));
@@ -1202,6 +1288,7 @@ async function detectStack(rootPath) {
   const versions = {};
   const missing = [];
   const wrongVersion = [];
+  const unparseable = [];
   for (const [key, req] of Object.entries(REQUIRED_DEPS)) {
     const raw = allDeps[req.name];
     if (!raw) {
@@ -1210,11 +1297,30 @@ async function detectStack(rootPath) {
     }
     const major = parseMajor(raw);
     versions[key] = { raw, major };
+    if (major === 0) {
+      unparseable.push(
+        `${req.name}@"${raw}" \u2014 can't read a version out of that. Pin an explicit range (e.g. "^${req.minMajor}.0.0") in package.json, or pass --target at the workspace member that has one.`
+      );
+      continue;
+    }
     if (major < req.minMajor) {
       wrongVersion.push(
         `${req.name}@${raw} \u2014 v1 requires ${req.name} >= ${req.minMajor}.x`
       );
     }
+    if (req.maxMajor !== void 0 && major > req.maxMajor) {
+      wrongVersion.push(
+        `${req.name}@${raw} \u2014 v1 requires ${req.name} <= ${req.maxMajor}.x.
+  Taste emits a Tailwind 3 config (tailwind.config.ts + @tailwind directives
+  in src/index.css). Tailwind 4 ignores the JS config and uses CSS-first
+  @theme instead, so the generated tokens would silently do nothing.
+  Downgrade with \`npm install -D tailwindcss@^3.4.17\`, or run with
+  --no-apply and port the emitted tokens to @theme by hand.`
+      );
+    }
+  }
+  if (unparseable.length) {
+    throw new StackMismatchError(unparseable.join("\n"));
   }
   if (missing.length) {
     throw new StackMismatchError(
@@ -1232,13 +1338,13 @@ async function detectStack(rootPath) {
   ];
   let tailwindConfigPath = null;
   for (const c2 of tailwindConfigCandidates) {
-    if (await fileExists2(join2(rootPath, c2))) {
-      tailwindConfigPath = join2(rootPath, c2);
+    if (await fileExists2(join3(rootPath, c2))) {
+      tailwindConfigPath = join3(rootPath, c2);
       break;
     }
   }
-  const ts = await fileExists2(join2(rootPath, "tsconfig.json"));
-  const srcPath = join2(rootPath, "src");
+  const ts = await fileExists2(join3(rootPath, "tsconfig.json"));
+  const srcPath = join3(rootPath, "src");
   const hasSrcDir = await fileExists2(srcPath);
   if (!hasSrcDir) {
     throw new StackMismatchError(
@@ -1285,19 +1391,20 @@ async function fileExists2(p) {
 
 // src/codemod/emit-tokens.ts
 init_esm_shims();
-import { join as join3, dirname as dirname2, resolve as resolve2 } from "path";
+import { join as join4 } from "path";
 import { readFile as readFile4 } from "fs/promises";
-import { fileURLToPath as fileURLToPath3 } from "url";
-var __dirname3 = dirname2(fileURLToPath3(import.meta.url));
 async function emitTokens(opts) {
   const { direction, stack } = opts;
   const tokensTs = await loadDirectionTokensSource(direction);
   const directionMd = await loadDirectionMarkdown(direction);
   const parsed = parseDirectionTokens(tokensTs, direction);
+  if (Object.keys(parsed.colors).length === 0) {
+    throw unemittableError(direction, tokensTs);
+  }
   const tailwindConfig = renderTailwindConfig(parsed, stack);
   const indexCss = renderIndexCss(parsed, directionMd);
-  const tailwindPath = stack.tailwindConfigPath ? stack.tailwindConfigPath : join3(stack.rootPath, stack.ts ? "tailwind.config.ts" : "tailwind.config.js");
-  const indexCssPath = join3(stack.srcPath, "index.css");
+  const tailwindPath = stack.tailwindConfigPath ? stack.tailwindConfigPath : join4(stack.rootPath, stack.ts ? "tailwind.config.ts" : "tailwind.config.js");
+  const indexCssPath = join4(stack.srcPath, "index.css");
   const notes = [];
   if (stack.hasTailwindConfig) {
     notes.push(
@@ -1310,33 +1417,55 @@ async function emitTokens(opts) {
     notes
   };
 }
+async function assertDirectionEmittable(slug) {
+  const src = await loadDirectionTokensSource(slug);
+  const parsed = parseDirectionTokens(src, slug);
+  if (Object.keys(parsed.colors).length === 0) {
+    throw unemittableError(slug, src);
+  }
+}
+function unemittableError(slug, src) {
+  const shape = /^\s*palette:\s*\{/m.test(src) ? `"${slug}" ships the newer theme.yml palette format, which the token
+emitter can't consume yet.` : `"${slug}" has no readable colors block in its tokens.ts.`;
+  return new CliError(
+    `Can't generate tokens for direction "${slug}".
+
+${shape}
+
+Directions that emit cleanly today include:
+  soft-modern \xB7 signal-dark \xB7 brutalist \xB7 newsletter \xB7 cinematic-dark
+  dense-utility \xB7 mid-century \xB7 maximalist \xB7 couture-luxury \xB7 architectural
+
+Nothing has been written \u2014 pick another --style and re-run.`
+  );
+}
 async function loadDirectionTokensSource(slug) {
-  const candidates = [
-    resolve2(__dirname3, "..", "..", "themes", slug, "tokens.ts"),
-    resolve2(__dirname3, "..", "..", "..", "themes", slug, "tokens.ts")
-  ];
-  for (const p of candidates) {
-    try {
-      return await readFile4(p, "utf8");
-    } catch {
-      continue;
-    }
+  const themesDir = resolveAssetDir("themes");
+  if (!themesDir) {
+    throw new CliError(
+      `Canonical tokens.ts for direction "${slug}" not found.
+
+${missingAssetMessage("themes")}`
+    );
+  }
+  try {
+    return await readFile4(join4(themesDir, slug, "tokens.ts"), "utf8");
+  } catch {
+    throw new CliError(
+      `Canonical tokens.ts for direction "${slug}" not found at ${join4(themesDir, slug, "tokens.ts")}.
+
+Pass a different --style, or report this at https://github.com/frischermf/taste/issues.`
+    );
   }
-  throw new CliError(`Canonical tokens.ts for direction "${slug}" not found.`);
 }
 async function loadDirectionMarkdown(slug) {
-  const candidates = [
-    resolve2(__dirname3, "..", "..", "themes", slug, "THEME.md"),
-    resolve2(__dirname3, "..", "..", "..", "themes", slug, "THEME.md")
-  ];
-  for (const p of candidates) {
-    try {
-      return await readFile4(p, "utf8");
-    } catch {
-      continue;
-    }
+  const themesDir = resolveAssetDir("themes");
+  if (!themesDir) return "";
+  try {
+    return await readFile4(join4(themesDir, slug, "THEME.md"), "utf8");
+  } catch {
+    return "";
   }
-  return "";
 }
 function parseDirectionTokens(src, slug) {
   const ethos = matchString(src, /ethos:\s*"([^"]+)"/) ?? `(no ethos for ${slug})`;
@@ -1524,6 +1653,11 @@ ${indent(k.css, 4)}
     box-shadow: ${value};
   }`
   ).join("\n\n");
+  const borderReset = d.colors.border ? `  * {
+    @apply border-border;
+  }
+
+` : "";
   return `${headerComment}${fontImport}@tailwind base;
 @tailwind components;
 @tailwind utilities;
@@ -1535,11 +1669,7 @@ ${tokenLines}
 }
 
 @layer base {
-  * {
-    @apply border-border;
-  }
-
-  html {
+${borderReset}  html {
     scroll-behavior: smooth;
   }
 
@@ -1623,12 +1753,12 @@ function indent(s, n) {
 
 // src/commands/apply.ts
 init_esm_shims();
-import { join as join4, relative as relative2, resolve as resolve3 } from "path";
+import { join as join5, relative as relative2, resolve as resolve2 } from "path";
 import { access as access3, mkdir as mkdir2, readFile as readFile5, writeFile as writeFile2 } from "fs/promises";
 import { execSync } from "child_process";
 var ROUTING_MARK_START2 = "<!-- stylecrib:routing:start -->";
 async function apply(opts = {}) {
-  const targetRoot = resolve3(opts.target ?? process.cwd());
+  const targetRoot = resolve2(opts.target ?? process.cwd());
   await applyFromStaging({
     targetRoot,
     branchName: opts.branch,
@@ -1637,13 +1767,13 @@ async function apply(opts = {}) {
 }
 async function applyFromStaging(opts) {
   const { targetRoot, noBranch } = opts;
-  const stagingRoot = join4(targetRoot, ".design-upgrade");
+  const stagingRoot = join5(targetRoot, ".design-upgrade");
   if (!await dirExists(stagingRoot)) {
     throw new CliError(
       `No staged changes at ${stagingRoot}. Run \`stylecrib init\` first.`
     );
   }
-  const isGit = await dirExists(join4(targetRoot, ".git"));
+  const isGit = await dirExists(join5(targetRoot, ".git"));
   if (isGit && !noBranch) {
     const branchName = opts.branchName ?? defaultBranchName();
     try {
@@ -1672,7 +1802,7 @@ Pass --no-branch to skip branch creation.`,
   const filesCopied = [];
   for await (const stagedPath of walk(stagingRoot)) {
     const rel = relative2(stagingRoot, stagedPath);
-    const targetPath = join4(targetRoot, rel);
+    const targetPath = join5(targetRoot, rel);
     if (rel === "CLAUDE.md" && await fileExists3(targetPath)) {
       const existing = await readFile5(targetPath, "utf8");
       if (existing.includes(ROUTING_MARK_START2)) {
@@ -1734,8 +1864,8 @@ function dirname3(p) {
 // src/commands/install-hooks.ts
 init_esm_shims();
 var import_picocolors2 = __toESM(require_picocolors(), 1);
-import { existsSync, mkdirSync, writeFileSync, chmodSync, readFileSync } from "fs";
-import { resolve as resolve4, join as join5, dirname as dirname4 } from "path";
+import { existsSync as existsSync2, mkdirSync, writeFileSync, chmodSync, readFileSync } from "fs";
+import { resolve as resolve3, join as join6, dirname as dirname4 } from "path";
 
 // src/lib/bundled-agents.ts
 init_esm_shims();
@@ -1833,11 +1963,11 @@ var BUNDLED_AGENTS = {
 };
 function loadAgentDoctrine(target, agentName) {
   try {
-    const { existsSync: existsSync16, readFileSync: readFileSync17 } = __require("fs");
-    const { join: join22 } = __require("path");
-    const localPath = join22(target, ".claude", "agents", `${agentName}.md`);
-    if (existsSync16(localPath)) {
-      return readFileSync17(localPath, "utf8");
+    const { existsSync: existsSync20, readFileSync: readFileSync20 } = __require("fs");
+    const { join: join27 } = __require("path");
+    const localPath = join27(target, ".claude", "agents", `${agentName}.md`);
+    if (existsSync20(localPath)) {
+      return readFileSync20(localPath, "utf8");
     }
   } catch {
   }
@@ -1846,73 +1976,77 @@ function loadAgentDoctrine(target, agentName) {
 
 // src/commands/install-hooks.ts
 async function installHooks(opts = {}) {
-  const target = resolve4(opts.target ?? process.cwd());
-  if (!existsSync(join5(target, ".git"))) {
-    console.error(import_picocolors2.default.red("\u2717 ") + "Not a git repository.");
-    console.error(import_picocolors2.default.dim("  Run `git init` first, then `stylecrib install-hooks`."));
-    process.exit(1);
+  const target = resolve3(opts.target ?? process.cwd());
+  if (!existsSync2(join6(target, ".git"))) {
+    throw new NotAGitRepoError(target);
   }
   const writes = [];
-  const huskyDir = join5(target, ".husky");
-  const useHusky = existsSync(huskyDir);
-  const hookPath = useHusky ? join5(huskyDir, "pre-commit") : join5(target, ".git/hooks/pre-commit");
+  const huskyDir = join6(target, ".husky");
+  const useHusky = existsSync2(huskyDir);
+  const hookPath = useHusky ? join6(huskyDir, "pre-commit") : join6(target, ".git/hooks/pre-commit");
   const hookBody = PRE_COMMIT_HOOK;
   writes.push({ path: hookPath, body: hookBody, chmod: 493 });
   if (opts.cursorrules !== false) {
     writes.push({
-      path: join5(target, ".cursorrules"),
+      path: join6(target, ".cursorrules"),
       body: CURSORRULES
     });
   }
   writes.push({
-    path: join5(target, ".github/workflows/stylecrib-review.yml"),
+    path: join6(target, ".github/workflows/stylecrib-review.yml"),
     body: GITHUB_ACTION
   });
   writes.push({
-    path: join5(target, ".claude/settings.json"),
+    path: join6(target, ".claude/settings.json"),
     body: CLAUDE_SETTINGS
   });
   writes.push({
-    path: join5(target, ".stylecrib/config.json"),
-    body: TASTE_CONFIG
+    path: join6(target, ".stylecrib/config.json"),
+    body: mergeTasteConfig(join6(target, ".stylecrib/config.json"), opts.theme),
+    merge: true
   });
   writes.push({
-    path: join5(target, ".stylecrib/RULEBOOK.md"),
+    path: join6(target, ".stylecrib/RULEBOOK.md"),
     body: renderRulebook()
   });
   for (const [name, doctrine] of Object.entries(BUNDLED_AGENTS)) {
     writes.push({
-      path: join5(target, ".claude/agents", `${name}.md`),
+      path: join6(target, ".claude/agents", `${name}.md`),
       body: doctrine
     });
   }
   console.log(import_picocolors2.default.bold("\u25C7 StyleCrib enforcement layer\n"));
   const collisions = [];
   let wroteAny = false;
+  let wroteCount = 0;
   for (const w of writes) {
-    const exists = existsSync(w.path);
+    const exists = existsSync2(w.path);
     if (exists) {
       const existing = readFileSync(w.path, "utf8");
       if (existing === w.body) {
         console.log(import_picocolors2.default.dim("  \xB7 " + relPath2(w.path, target) + " (unchanged)"));
         continue;
       }
-      if (!opts.force) {
+      if (w.merge) {
+        console.log(import_picocolors2.default.dim("  \xB7 " + relPath2(w.path, target) + " (merged)"));
+      } else if (!opts.force) {
         console.log(
           import_picocolors2.default.yellow("  \u26A0 ") + relPath2(w.path, target) + import_picocolors2.default.dim(" exists with different content \u2014 see summary below")
         );
         collisions.push({ path: w.path, existing });
         continue;
+      } else {
+        const backup = w.path + ".pre-stylecrib.bak";
+        writeFileSync(backup, existing);
+        console.log(import_picocolors2.default.dim("    \u21AA backed up existing content to " + relPath2(backup, target)));
       }
-      const backup = w.path + ".pre-taste.bak";
-      writeFileSync(backup, existing);
-      console.log(import_picocolors2.default.dim("    \u21AA backed up existing content to " + relPath2(backup, target)));
     }
     mkdirSync(dirname4(w.path), { recursive: true });
     writeFileSync(w.path, w.body);
     if (w.chmod) chmodSync(w.path, w.chmod);
     console.log(import_picocolors2.default.green("  \u2713 ") + relPath2(w.path, target));
     wroteAny = true;
+    wroteCount++;
   }
   if (collisions.length > 0) {
     console.error("");
@@ -1921,7 +2055,7 @@ async function installHooks(opts = {}) {
     console.error(import_picocolors2.default.bold("  What to do:"));
     console.error("");
     console.error("    Option 1 \u2014 pass --force to overwrite. The existing content of each file");
-    console.error("    will be backed up to `<path>.pre-taste.bak` before the new content lands.");
+    console.error("    will be backed up to `<path>.pre-stylecrib.bak` before the new content lands.");
     console.error("");
     console.error("    Option 2 \u2014 inspect each collision, merge by hand, and re-run.");
     console.error("");
@@ -1932,7 +2066,7 @@ async function installHooks(opts = {}) {
     console.error("");
     console.error(import_picocolors2.default.dim("  Half-installed enforcement is worse than none \u2014 the customer would"));
     console.error(import_picocolors2.default.dim("  assume the gate is active. Refusing to print the success banner."));
-    process.exit(1);
+    throw new HookCollisionError(collisions.map((x) => relPath2(x.path, target)), wroteCount);
   }
   if (!wroteAny) {
     console.log("");
@@ -1957,7 +2091,7 @@ async function installHooks(opts = {}) {
   console.log("    AI agents should read this at session start; humans should read it in code review.");
   console.log("");
   console.log(import_picocolors2.default.bold("The agents:"));
-  console.log("  \xB7 " + import_picocolors2.default.cyan(".claude/agents/") + " \u2014 qa-conductor + 15 specialist agents, ready for immediate use.");
+  console.log("  \xB7 " + import_picocolors2.default.cyan(".claude/agents/") + " \u2014 qa-conductor + 18 specialist agents, ready for immediate use.");
   console.log("");
   console.log(import_picocolors2.default.dim("Config: .stylecrib/config.json (enforce: 'hard' by default; downgrade to 'warn' for gradual migration)."));
   console.log(import_picocolors2.default.dim('Bypass: `git commit --no-verify` or `STYLECRIB_SKIP_QA="reason" git commit` (logged for review).'));
@@ -1994,15 +2128,46 @@ var CLAUDE_SETTINGS = `{
   }
 }
 `;
-var TASTE_CONFIG = `{
-  "enforce": "hard",
-  "notes": [
+function mergeTasteConfig(path2, theme) {
+  let existing = null;
+  if (existsSync2(path2)) {
+    try {
+      const parsed = JSON.parse(readFileSync(path2, "utf8"));
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        existing = parsed;
+      }
+    } catch {
+      try {
+        writeFileSync(path2 + ".pre-stylecrib.bak", readFileSync(path2, "utf8"));
+      } catch {
+      }
+    }
+  }
+  if (!existing) return tasteConfig(theme);
+  const merged = { ...existing };
+  if (typeof merged.enforce !== "string") merged.enforce = "hard";
+  if (theme && typeof merged.theme !== "string") merged.theme = theme;
+  merged.notes = JSON.parse(tasteConfig(typeof merged.theme === "string" ? merged.theme : theme)).notes;
+  return JSON.stringify(merged, null, 2) + "\n";
+}
+function tasteConfig(theme) {
+  const notes = [
     "enforce: 'hard' (default) \u2014 pre-commit BLOCKs on block-severity slop hits AND requires qa-conductor auth on every UI-touching commit.",
-    "enforce: 'warn' \u2014 downgrades every gate to advisory. Reserved for gradual-migration mode when the pack was installed on top of a large existing codebase.",
+    "enforce: 'warn' \u2014 downgrades every gate to advisory. Reserved for gradual-migration mode when the pack was installed on top of a large existing codebase."
+  ];
+  if (theme) {
+    notes.push(
+      "theme: the active StyleCrib theme slug. Read by 'stylecrib check' to enforce per-theme rules such as R-SECOND-ACCENT. Change it if you switch themes."
+    );
+  }
+  notes.push(
     "See https://github.com/frischermf/stylecrib/blob/main/README.md for the full rule catalog and each rule's escape hatch."
-  ]
+  );
+  const config = { enforce: "hard" };
+  if (theme) config.theme = theme;
+  config.notes = notes;
+  return JSON.stringify(config, null, 2) + "\n";
 }
-`;
 function renderRulebook() {
   const { SLOP_RULES: SLOP_RULES2 } = (init_slop_rules(), __toCommonJS(slop_rules_exports));
   const lines = [];
@@ -2122,10 +2287,10 @@ jobs:
         with:
           node-version: "20"
           cache: npm
-      # Install the project's own dependencies so \`stylecrib\` resolves from
-      # node_modules. Without this, \`npx stylecrib\` on a CI runner would
-      # fetch whatever package owns that name on the registry and run it
-      # with ANTHROPIC_API_KEY in the environment.
+      # Install the repo's own pinned dependencies first. Without this, a bare
+      # \`npx stylecrib\` on a fresh runner would fetch whatever package owns
+      # that name on the registry and run it with ANTHROPIC_API_KEY in the
+      # environment.
       - run: npm ci
       - name: Diff against base
         run: |
@@ -2142,11 +2307,13 @@ jobs:
 init_esm_shims();
 var import_picocolors3 = __toESM(require_picocolors(), 1);
 import { execSync as execSync2 } from "child_process";
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname5, join as join6, relative as relative3, resolve as resolve5 } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname5, join as join7, relative as relative3, resolve as resolve4 } from "path";
+var RUNTIME_PKG = "@stylecrib/react";
+var RUNTIME_PKG_RANGE = ">=0.2.2 <0.3.0";
 function readDeps(target) {
-  const path2 = join6(target, "package.json");
-  if (!existsSync2(path2)) return null;
+  const path2 = join7(target, "package.json");
+  if (!existsSync3(path2)) return null;
   try {
     const pkg = JSON.parse(readFileSync2(path2, "utf8"));
     return { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
@@ -2161,14 +2328,55 @@ function hasReactRouter(deps) {
   return "react-router-dom" in deps;
 }
 function resolveWireFilePath(target) {
-  const srcLib = join6(target, "src", "lib");
-  const src = join6(target, "src");
-  if (existsSync2(srcLib)) return join6(srcLib, "stylecrib-wire.tsx");
-  if (existsSync2(src)) return join6(src, "lib", "stylecrib-wire.tsx");
-  return join6(target, "src", "lib", "stylecrib-wire.tsx");
+  const srcLib = join7(target, "src", "lib");
+  const src = join7(target, "src");
+  if (existsSync3(srcLib)) return join7(srcLib, "stylecrib-wire.tsx");
+  if (existsSync3(src)) return join7(src, "lib", "stylecrib-wire.tsx");
+  return join7(target, "src", "lib", "stylecrib-wire.tsx");
+}
+function runtimeAtLeast(target, major, minor, patch = 0) {
+  try {
+    const pkg = JSON.parse(
+      readFileSync2(join7(target, "node_modules", RUNTIME_PKG, "package.json"), "utf8")
+    );
+    const m = String(pkg.version ?? "").match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!m) return false;
+    const [maj, min, pat] = [m[1], m[2], m[3]].map((n) => parseInt(n, 10));
+    if (maj !== major) return maj > major;
+    if (min !== minor) return min > minor;
+    return pat >= patch;
+  } catch {
+    return false;
+  }
 }
-function buildStyleCribWireTemplate(opts) {
+function resolveThemeFonts(themeSlug) {
+  const themesDir = resolveAssetDir("themes");
+  if (!themesDir) return null;
+  const tokensPath = join7(themesDir, themeSlug, "tokens.ts");
+  if (!existsSync3(tokensPath)) return null;
+  let src;
+  try {
+    src = readFileSync2(tokensPath, "utf8");
+  } catch {
+    return null;
+  }
+  const pick = (role) => {
+    const block = src.match(new RegExp(`${role}:\\s*\\{([\\s\\S]{0,600}?)\\}`));
+    if (!block) return [];
+    const fam = block[1].match(/family:\s*"([^"]+)"/);
+    return fam ? [fam[1]] : [];
+  };
+  const fonts = { display: pick("display"), body: pick("body"), mono: pick("mono") };
+  if (!fonts.display.length && !fonts.body.length && !fonts.mono.length) return null;
+  return fonts;
+}
+function buildTasteWireTemplate(opts) {
   const { themeSlug, themeName, themeSwatch, scaffoldedAt } = opts;
+  const fonts = opts.emitFonts ? resolveThemeFonts(themeSlug) : null;
+  const themeFontsBlock = fonts ? `
+    fonts: {
+` + ["display", "body", "mono"].filter((role) => fonts[role].length > 0).map((role) => `      ${role}: ${JSON.stringify(fonts[role])},`).join("\n") + `
+    },` : "";
   return `// StyleCrib \u2014 customer runtime wire-up
 // Scaffolded by \`stylecrib init\` on ${scaffoldedAt}.
 //
@@ -2208,7 +2416,7 @@ const INSTALLED_THEMES: RegisteredTheme[] = [
     name: "${themeName}",
     swatch: "${themeSwatch}",
     installed: true,
-    briefUrl: "https://github.com/frischermf/stylecrib/tree/main/themes/${themeSlug}",
+    briefUrl: "https://github.com/frischermf/stylecrib/tree/main/themes/${themeSlug}",${themeFontsBlock}
   },
 ];
 
@@ -2242,9 +2450,10 @@ export function StyleCribWire({ children }: { children: ReactNode }) {
 }
 function runNpmInstall(target, silent) {
   try {
-    const hasYarnLock = existsSync2(join6(target, "yarn.lock"));
-    const hasPnpmLock = existsSync2(join6(target, "pnpm-lock.yaml"));
-    const cmd = hasPnpmLock ? "pnpm add @stylecrib/react" : hasYarnLock ? "yarn add @stylecrib/react" : "npm install @stylecrib/react";
+    const hasYarnLock = existsSync3(join7(target, "yarn.lock"));
+    const hasPnpmLock = existsSync3(join7(target, "pnpm-lock.yaml"));
+    const spec = `"${RUNTIME_PKG}@${RUNTIME_PKG_RANGE}"`;
+    const cmd = hasPnpmLock ? `pnpm add ${spec}` : hasYarnLock ? `yarn add ${spec}` : `npm install ${spec}`;
     if (!silent) console.log(import_picocolors3.default.dim("  running: " + cmd));
     execSync2(cmd, { cwd: target, stdio: silent ? "ignore" : "inherit" });
     return true;
@@ -2253,7 +2462,7 @@ function runNpmInstall(target, silent) {
   }
 }
 async function installRuntimeScaffold(opts) {
-  const target = resolve5(opts.target);
+  const target = resolve4(opts.target);
   const themeSwatch = opts.themeSwatch ?? "#FFDF29";
   const silent = opts.silent ?? false;
   if (!silent) console.log(import_picocolors3.default.bold("\u25C7 Runtime pack\n"));
@@ -2290,29 +2499,30 @@ async function installRuntimeScaffold(opts) {
   }
   const scaffoldPath = resolveWireFilePath(target);
   const scaffoldRel = relative3(target, scaffoldPath);
-  if (existsSync2(scaffoldPath) && !opts.force) {
+  if (existsSync3(scaffoldPath) && !opts.force) {
     if (!silent) {
       console.log("");
       console.log(import_picocolors3.default.red("  \u2717 ") + scaffoldRel + " already exists.");
       console.log(import_picocolors3.default.dim("    Refusing to overwrite. Options:"));
       console.log(import_picocolors3.default.dim("    \xB7 Rename / archive the existing file and re-run `stylecrib init`."));
-      console.log(import_picocolors3.default.dim("    \xB7 Pass `--force-runtime` to overwrite (backs up existing to `.pre-taste.bak` first)."));
+      console.log(import_picocolors3.default.dim("    \xB7 Pass `--force-runtime` to overwrite (backs up existing to `.pre-stylecrib.bak` first)."));
       console.log(import_picocolors3.default.dim("    \xB7 Skip this scaffold with `--no-runtime` \u2014 copy the wire-up manually per docs/STYLECRIB_ADMIN.md."));
     }
     return { kind: "collision", scaffoldPath };
   }
-  if (existsSync2(scaffoldPath) && opts.force) {
-    const backup = scaffoldPath + ".pre-taste.bak";
+  if (existsSync3(scaffoldPath) && opts.force) {
+    const backup = scaffoldPath + ".pre-stylecrib.bak";
     writeFileSync2(backup, readFileSync2(scaffoldPath, "utf8"));
     if (!silent) console.log(import_picocolors3.default.dim("    \u21AA backed up existing " + scaffoldRel + " to " + relative3(target, backup)));
   }
   mkdirSync2(dirname5(scaffoldPath), { recursive: true });
   writeFileSync2(
     scaffoldPath,
-    buildStyleCribWireTemplate({
+    buildTasteWireTemplate({
       themeSlug: opts.themeSlug,
       themeName: opts.themeName,
       themeSwatch,
+      emitFonts: runtimeAtLeast(target, 0, 2, 2),
       scaffoldedAt: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)
     })
   );
@@ -2337,12 +2547,36 @@ async function installRuntimeScaffold(opts) {
   return { kind: "installed", scaffoldPath, ranNpmInstall };
 }
 
+// src/lib/tty.ts
+init_esm_shims();
+function isInteractive() {
+  return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+function assertInteractive(what) {
+  if (isInteractive()) return;
+  throw new CliError(
+    `${what} needs a terminal, and none is attached.
+
+Re-run one of these ways:
+  \u2022 --yes                 accept canonical defaults, no prompts
+  \u2022 --style <slug>        pick the theme directly, no prompts
+  \u2022 from an interactive shell (not piped, not CI)`
+  );
+}
+
+// src/lib/version.ts
+init_esm_shims();
+var VERSION = true ? "0.3.2" : "0.0.0-dev";
+
 // src/commands/init.ts
-var __dirname4 = dirname6(fileURLToPath4(import.meta.url));
 async function init(opts) {
-  const target = resolve6(opts.target ?? process.cwd());
-  if (!process.env.ANTHROPIC_API_KEY) throw new MissingApiKeyError();
-  console.log(c.brand("StyleCrib") + c.dim(" \u2014 design upgrade CLI \xB7 v0.1.0"));
+  const target = resolve5(opts.target ?? process.cwd());
+  assertValidDirection(opts.style);
+  if (opts.style && opts.style !== "custom") {
+    await assertDirectionEmittable(opts.style);
+  }
+  const nonInteractive = opts.yes === true || !isInteractive();
+  console.log(c.brand("StyleCrib") + c.dim(` \u2014 design upgrade CLI \xB7 v${VERSION}`));
   console.log(c.dim("target: ") + target);
   if (opts.dryRun) console.log(c.warn("DRY RUN \u2014 no files will be written\n"));
   console.log(step(1, 5, "Detect stack"));
@@ -2352,7 +2586,8 @@ async function init(opts) {
   console.log(header(step(2, 5, "Collect direction")));
   const wizard = await runWizard({
     defaultProjectName: basename(target),
-    skippedStyle: opts.style
+    skippedStyle: opts.style,
+    nonInteractive
   });
   console.log(header(step(3, 5, "Ingest references")));
   const contextBlocks = [];
@@ -2403,6 +2638,7 @@ async function init(opts) {
       rationale: `Pure-canonical "${wizard.baseDirection}" install \u2014 Director call skipped to save tokens.`
     };
   } else {
+    if (!process.env.ANTHROPIC_API_KEY) throw new MissingApiKeyError();
     console.log(c.dim("  calling Anthropic API (this can take 20-60s)..."));
     const baseMd = wizard.baseDirection === "custom" ? "" : await loadCanonicalDirectionMarkdown(wizard.baseDirection);
     directorOutput = await callDirector({
@@ -2450,10 +2686,17 @@ async function init(opts) {
   console.log(
     c.dim(`  ${result.filesStaged.length} file(s) staged at ${result.stagingRoot}`)
   );
-  const apply2 = await confirm2({
-    message: "Apply now? This creates a new git branch and copies staged files into your project.",
-    default: true
-  });
+  let apply2;
+  if (opts.apply !== void 0) {
+    apply2 = opts.apply;
+  } else if (nonInteractive) {
+    apply2 = false;
+  } else {
+    apply2 = await confirm2({
+      message: "Apply now? This creates a new git branch and copies staged files into your project.",
+      default: true
+    });
+  }
   if (apply2) {
     await applyFromStaging({ targetRoot: target });
   } else {
@@ -2461,6 +2704,11 @@ async function init(opts) {
     console.log(c.dim("Next:"));
     console.log(c.dim("  \u2022 Review .design-upgrade/ in your editor."));
     console.log(c.dim("  \u2022 Run `stylecrib apply` when ready to commit the changes to a new branch."));
+    if (nonInteractive && opts.apply === void 0) {
+      console.log(
+        c.dim("    (staged rather than applied because there was no terminal to confirm with \u2014\n") + c.dim("     pass --apply to skip this step next time.)")
+      );
+    }
   }
   if (opts.runtime !== false && !opts.dryRun) {
     console.log("");
@@ -2478,6 +2726,16 @@ async function init(opts) {
             "  \u26A0 Runtime scaffold skipped \u2014 src/lib/stylecrib-wire.tsx already exists. Re-run with --force-runtime to overwrite (backup taken), or --no-runtime to suppress this step."
           )
         );
+      } else if (result2.kind === "skipped-no-react-router") {
+        console.log(
+          c.warn(
+            "  \u26A0 Runtime pack skipped \u2014 react-router-dom is not a dependency.\n    The <StyleCribAdmin> drawer uses useLocation for its route-scoped section\n    registry, so it can't mount without a router. Install it and re-run:\n      npm install react-router-dom && npx stylecrib init --no-hooks"
+          )
+        );
+      } else if (result2.kind === "skipped-no-package-json") {
+        console.log(
+          c.warn("  \u26A0 Runtime pack skipped \u2014 no package.json at the target.")
+        );
       }
     } catch (err) {
       console.log(
@@ -2496,7 +2754,10 @@ async function init(opts) {
       )
     );
     try {
-      await installHooks({ target });
+      await installHooks({
+        target,
+        theme: wizard.baseDirection === "custom" ? void 0 : wizard.baseDirection
+      });
     } catch (err) {
       console.log(
         c.warn(
@@ -2569,23 +2830,24 @@ async function runSelfTest(target) {
   }
 }
 async function loadCanonicalDirectionMarkdown(slug) {
-  const candidates = [
-    resolve6(__dirname4, "..", "themes", slug, "THEME.md"),
-    resolve6(__dirname4, "..", "..", "themes", slug, "THEME.md")
-  ];
-  for (const p of candidates) {
+  const themesDir = resolveAssetDir("themes");
+  if (themesDir) {
     try {
-      return await readFile6(p, "utf8");
+      return await readFile6(join8(themesDir, slug, "THEME.md"), "utf8");
     } catch {
-      continue;
+      console.log(
+        c.warn(`  ! No THEME.md for ${slug} at ${join8(themesDir, slug)} \u2014 falling back to a stub.`)
+      );
+      return `# Design Direction \u2014 ${slug}
+
+(Canonical THEME.md not bundled \u2014 re-install stylecrib.)
+`;
     }
   }
-  console.log(
-    c.warn(`  ! Couldn't locate canonical THEME.md for ${slug} \u2014 falling back to a stub.`)
-  );
+  console.log(c.warn(`  ! ${missingAssetMessage("themes")}`));
   return `# Design Direction \u2014 ${slug}
 
-(Canonical THEME.md not bundled \u2014 re-install taste.)
+(Canonical THEME.md not bundled \u2014 re-install stylecrib.)
 `;
 }
 function extractEthos(md) {
@@ -2597,13 +2859,61 @@ function extractEthos(md) {
 init_esm_shims();
 var import_picocolors4 = __toESM(require_picocolors(), 1);
 import { execSync as execSync3, spawnSync } from "child_process";
-import { readFileSync as readFileSync3, existsSync as existsSync3, mkdirSync as mkdirSync3, appendFileSync, writeFileSync as writeFileSync3 } from "fs";
-import { resolve as resolve7, join as join7 } from "path";
+import { readFileSync as readFileSync4, existsSync as existsSync5, mkdirSync as mkdirSync3, appendFileSync, writeFileSync as writeFileSync3 } from "fs";
+import { resolve as resolve6, join as join10 } from "path";
 import { homedir } from "os";
 import Anthropic2 from "@anthropic-ai/sdk";
 
 // src/lib/slop-detectors.ts
 init_esm_shims();
+
+// src/lib/color.ts
+init_esm_shims();
+function hexToHsl(hex) {
+  let m = hex.match(/^#([0-9a-f]{3})$/i);
+  let r, g, b;
+  if (m) {
+    const [a, c2, d] = m[1].split("");
+    r = parseInt(a + a, 16);
+    g = parseInt(c2 + c2, 16);
+    b = parseInt(d + d, 16);
+  } else {
+    m = hex.match(/^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i);
+    if (!m) return null;
+    r = parseInt(m[1], 16);
+    g = parseInt(m[2], 16);
+    b = parseInt(m[3], 16);
+  }
+  return rgbToHsl(r, g, b);
+}
+function rgbToHsl(r8, g8, b8) {
+  const r = r8 / 255, g = g8 / 255, b = b8 / 255;
+  const max = Math.max(r, g, b), min = Math.min(r, g, b);
+  const l = (max + min) / 2;
+  const d = max - min;
+  if (d === 0) return { h: 0, s: 0, l: l * 100 };
+  const s = d / (1 - Math.abs(2 * l - 1));
+  let h;
+  if (max === r) h = 60 * ((g - b) / d % 6);
+  else if (max === g) h = 60 * ((b - r) / d + 2);
+  else h = 60 * ((r - g) / d + 4);
+  if (h < 0) h += 360;
+  return { h, s: s * 100, l: l * 100 };
+}
+function parseHslTriplet(raw) {
+  const m = raw.trim().match(/^(\d+(?:\.\d+)?)\s+(\d+(?:\.\d+)?)%\s+(\d+(?:\.\d+)?)%$/);
+  if (!m) return null;
+  return { h: parseFloat(m[1]), s: parseFloat(m[2]), l: parseFloat(m[3]) };
+}
+function hueDistance(a, b) {
+  const d = Math.abs((a % 360 + 360) % 360 - (b % 360 + 360) % 360);
+  return d > 180 ? 360 - d : d;
+}
+function isAccentLike(c2) {
+  return c2.s >= 45 && c2.l >= 20 && c2.l <= 80;
+}
+
+// src/lib/slop-detectors.ts
 function extractOverrides(body) {
   const local = /* @__PURE__ */ new Map();
   const fileScope = /* @__PURE__ */ new Set();
@@ -2664,7 +2974,7 @@ function detectMonoDecorativeEyebrow(file, body) {
     if (/<kbd\b|<code\b|<pre\b/i.test(window)) continue;
     if (/⌘|⌃|⌥|⇧|⏎|⇥|←|→|↑|↓/.test(window)) continue;
     if (/\$\s|\bLEAD-\d|\bAC-\d|\bID-\d|\bDEA-\d|\bCDN-\d|\bPT-\d/.test(window)) continue;
-    if (/[a-z]+\/[a-z\-]+\/?[a-z\-]*/.test(window) && /taste\/|routes?\.|route:/i.test(window)) continue;
+    if (/[a-z]+\/[a-z\-]+\/?[a-z\-]*/.test(window) && /stylecrib\/|routes?\.|route:/i.test(window)) continue;
     if (/terminal|CLI|specimen|\$\s*[a-z\-]+ /i.test(window)) continue;
     if (/tabular-nums/i.test(line)) continue;
     hits.push({ ruleId: "R-MONO-DECORATIVE-EYEBROW", file, line: i + 1, sample: line.trim().slice(0, 120) });
@@ -2722,11 +3032,13 @@ function detectMonoCapsCTA(file, body) {
 function detectDotMetadataRow(file, body) {
   const hits = [];
   const lines = body.split("\n");
-  const dotToken = String.raw`[A-Za-z0-9][\w./\-]{1,20}(?:\s[A-Za-z0-9][\w./\-]{1,20})?`;
+  const dotToken = String.raw`[A-Z0-9][A-Z0-9./\-]{0,20}(?:\s[A-Z0-9][A-Z0-9./\-]{0,20}){0,2}`;
   const dotTokens = new RegExp(`(?:${dotToken}\\s\xB7\\s){2,}${dotToken}`);
   const smallMarker = /fontSize\s*:\s*(?:['"]?)(?:[1-9]|1[0-4])(?:px)?['"]?|text-xs|text-\[0\.\d+rem\]|font-mono/;
   for (let i = 0; i < lines.length; i++) {
-    if (!dotTokens.test(lines[i])) continue;
+    const dotHit = lines[i].match(dotTokens);
+    if (!dotHit) continue;
+    if (!/[A-Z]/.test(dotHit[0])) continue;
     const window = lines.slice(Math.max(0, i - 2), Math.min(lines.length, i + 4)).join("\n");
     if (!smallMarker.test(window)) continue;
     if (/<p\b[^>]*(?:lede|prose|body)/i.test(window)) continue;
@@ -3248,14 +3560,113 @@ function detectTechBroGradient(file, body) {
   }
   return hits.filter((h) => !isOverridden(lines, h.line - 1, h.ruleId));
 }
-function runAllTextDetectors(file, body) {
-  const overrides = extractOverrides(body);
-  const cleaned = stripJsxExpressionBraces(file, stripBlockComments(body));
-  const rawHits = [
-    ...detectMonoDecorativeEyebrow(file, cleaned),
-    ...detectMonoInCssApply(file, cleaned),
-    ...detectArrowEyebrowPrefix(file, cleaned),
-    ...detectMonoCapsCTA(file, cleaned),
+function detectMonoCapsSectionEyebrow(file, body) {
+  const hits = [];
+  const lines = body.split("\n");
+  const eyebrowRe = /["'`>]\s*(SECTION|CHAPTER|PART|WHAT WE)\s*[·•]?\s*[A-Z][A-Z']/;
+  for (let i = 0; i < lines.length; i++) {
+    if (isCommentOrRuleDoc(lines[i], "R-MONO-CAPS-SECTION-EYEBROW")) continue;
+    if (!eyebrowRe.test(lines[i])) continue;
+    hits.push({
+      ruleId: "R-MONO-CAPS-SECTION-EYEBROW",
+      file,
+      line: i + 1,
+      sample: lines[i].trim().slice(0, 120)
+    });
+  }
+  return hits.filter((h) => !isOverridden(lines, h.line - 1, h.ruleId));
+}
+function detectCornerTagAbbreviation(file, body) {
+  const hits = [];
+  const lines = body.split("\n");
+  const cornerRe = /\b(NO|EST|VOL|CH|PT|SEC|EP|PG)\.\s*\d/;
+  for (let i = 0; i < lines.length; i++) {
+    if (isCommentOrRuleDoc(lines[i], "R-CORNER-TAG-ABBREVIATION")) continue;
+    const m = lines[i].match(cornerRe);
+    if (!m) continue;
+    hits.push({
+      ruleId: "R-CORNER-TAG-ABBREVIATION",
+      file,
+      line: i + 1,
+      sample: lines[i].trim().slice(0, 120)
+    });
+  }
+  return hits.filter((h) => !isOverridden(lines, h.line - 1, h.ruleId));
+}
+function detectBylineMonoCaps(file, body) {
+  const hits = [];
+  const lines = body.split("\n");
+  const bylineRe = /["'`>]\s*(BY|WORDS BY|WRITTEN BY|PHOTOGRAPHY BY|PHOTOS BY|EDITED BY)\s+[A-Z]/;
+  for (let i = 0; i < lines.length; i++) {
+    if (isCommentOrRuleDoc(lines[i], "R-BYLINE-MONO-CAPS")) continue;
+    if (!bylineRe.test(lines[i])) continue;
+    hits.push({
+      ruleId: "R-BYLINE-MONO-CAPS",
+      file,
+      line: i + 1,
+      sample: lines[i].trim().slice(0, 120)
+    });
+  }
+  return hits.filter((h) => !isOverridden(lines, h.line - 1, h.ruleId));
+}
+function detectTagRowAboveBody(file, body) {
+  const hits = [];
+  const lines = body.split("\n");
+  const tagRe = /[▸◆»●]\s+[A-Z][A-Z]{2,}/;
+  for (let i = 0; i < lines.length; i++) {
+    if (isCommentOrRuleDoc(lines[i], "R-TAG-ROW-ABOVE-BODY")) continue;
+    const m = lines[i].match(tagRe);
+    if (!m) continue;
+    hits.push({
+      ruleId: "R-TAG-ROW-ABOVE-BODY",
+      file,
+      line: i + 1,
+      sample: lines[i].trim().slice(0, 120)
+    });
+  }
+  return hits.filter((h) => !isOverridden(lines, h.line - 1, h.ruleId));
+}
+function detectSecondAccent(file, body, theme) {
+  if (!theme || !theme.singleAccentOnly || !theme.accent) return [];
+  const hits = [];
+  const lines = body.split("\n");
+  const HUE_TOLERANCE = 40;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (isCommentOrRuleDoc(line, "R-SECOND-ACCENT")) continue;
+    const candidates = [];
+    for (const m of line.matchAll(/#[0-9a-fA-F]{6}\b|#[0-9a-fA-F]{3}\b/g)) {
+      candidates.push({ raw: m[0], hsl: hexToHsl(m[0]) });
+    }
+    for (const m of line.matchAll(/hsl\(\s*(\d+(?:\.\d+)?)\s*,?\s*(\d+(?:\.\d+)?)%\s*,?\s*(\d+(?:\.\d+)?)%/g)) {
+      candidates.push({
+        raw: m[0],
+        hsl: { h: parseFloat(m[1]), s: parseFloat(m[2]), l: parseFloat(m[3]) }
+      });
+    }
+    for (const c2 of candidates) {
+      if (!c2.hsl || !isAccentLike(c2.hsl)) continue;
+      const dist = hueDistance(c2.hsl.h, theme.accent.h);
+      if (dist <= HUE_TOLERANCE) continue;
+      hits.push({
+        ruleId: "R-SECOND-ACCENT",
+        file,
+        line: i + 1,
+        sample: `${c2.raw} (hue ${c2.hsl.h.toFixed(0)}\xB0 vs ${theme.slug} accent ${theme.accent.h.toFixed(0)}\xB0) ${line.trim().slice(0, 70)}`
+      });
+      break;
+    }
+  }
+  return hits.filter((h) => !isOverridden(lines, h.line - 1, h.ruleId));
+}
+function runAllTextDetectors(file, body, theme = null) {
+  const overrides = extractOverrides(body);
+  const cleaned = stripJsxExpressionBraces(file, stripBlockComments(body));
+  const rawHits = [
+    ...detectMonoDecorativeEyebrow(file, cleaned),
+    ...detectMonoInCssApply(file, cleaned),
+    ...detectArrowEyebrowPrefix(file, cleaned),
+    ...detectMonoCapsCTA(file, cleaned),
     ...detectDotMetadataRow(file, cleaned),
     ...detectStaticGlowBloom(file, cleaned),
     ...detectTrustedByRow(file, cleaned),
@@ -3272,11 +3683,97 @@ function runAllTextDetectors(file, body) {
     ...detectMotionNoReducedMotion(file, cleaned),
     ...detectClaudeCream(file, cleaned),
     ...detectVoidAcid(file, cleaned),
-    ...detectTechBroGradient(file, cleaned)
+    ...detectTechBroGradient(file, cleaned),
+    ...detectMonoCapsSectionEyebrow(file, cleaned),
+    ...detectCornerTagAbbreviation(file, cleaned),
+    ...detectBylineMonoCaps(file, cleaned),
+    ...detectTagRowAboveBody(file, cleaned),
+    ...detectSecondAccent(file, cleaned, theme)
   ];
   return rawHits.filter((h) => !isOverriddenByMap(h.line - 1, h.ruleId, overrides));
 }
 
+// src/lib/theme-policy.ts
+init_esm_shims();
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
+import { join as join9 } from "path";
+var SINGLE_ACCENT_THEMES = [
+  "signal-dark",
+  "enterprise-tech",
+  "pharma-clinical",
+  "kinetic-data"
+];
+function resolveActiveThemeSlug(target) {
+  const cfgPath = join9(target, ".stylecrib", "config.json");
+  if (existsSync4(cfgPath)) {
+    try {
+      const cfg = JSON.parse(readFileSync3(cfgPath, "utf8"));
+      if (typeof cfg.theme === "string" && cfg.theme.trim()) return cfg.theme.trim();
+    } catch {
+    }
+  }
+  const wirePath = join9(target, "src", "lib", "stylecrib-wire.tsx");
+  if (existsSync4(wirePath)) {
+    try {
+      const m = readFileSync3(wirePath, "utf8").match(/defaultTheme=["']([a-z0-9-]+)["']/);
+      if (m) return m[1];
+    } catch {
+    }
+  }
+  return null;
+}
+function themePermitsSingleAccentOnly(slug, themeYmlSrc) {
+  if (SINGLE_ACCENT_THEMES.includes(slug)) return true;
+  if (themeYmlSrc && /^\s*single_accent:\s*true\s*$/m.test(themeYmlSrc)) return true;
+  return false;
+}
+function resolveThemeContext(slug) {
+  const themesDir = resolveAssetDir("themes");
+  if (!themesDir) return null;
+  const dir = join9(themesDir, slug);
+  if (!existsSync4(dir)) return null;
+  let accent = null;
+  let accentSource = "unresolved";
+  let ymlSrc;
+  const ymlPath = join9(dir, "theme.yml");
+  if (existsSync4(ymlPath)) {
+    try {
+      ymlSrc = readFileSync3(ymlPath, "utf8");
+      const m = ymlSrc.match(/^\s*accent:\s*["']?(#[0-9a-fA-F]{3,6})["']?/m);
+      if (m) {
+        accent = hexToHsl(m[1]);
+        accentSource = `theme.yml palette.accent ${m[1]}`;
+      }
+    } catch {
+    }
+  }
+  if (!accent) {
+    const tokPath = join9(dir, "tokens.ts");
+    if (existsSync4(tokPath)) {
+      try {
+        const src = readFileSync3(tokPath, "utf8");
+        const m = src.match(/\bprimary:\s*\{\s*hsl:\s*["']([^"']+)["']/);
+        if (m) {
+          accent = parseHslTriplet(m[1]);
+          accentSource = `tokens.ts colors.primary "${m[1]}"`;
+        }
+      } catch {
+      }
+    }
+  }
+  return {
+    slug,
+    accent,
+    accentSource,
+    singleAccentOnly: themePermitsSingleAccentOnly(slug, ymlSrc)
+  };
+}
+function themeContextForTarget(target) {
+  const slug = resolveActiveThemeSlug(target);
+  if (!slug) return null;
+  return resolveThemeContext(slug);
+}
+
 // src/lib/regression-detectors.ts
 init_esm_shims();
 function firstLineWith(body, needle) {
@@ -3354,7 +3851,7 @@ function existsInHead(target, rel) {
   return r.status === 0;
 }
 async function check(opts = {}) {
-  const target = resolve7(opts.target ?? process.cwd());
+  const target = resolve6(opts.target ?? process.cwd());
   const apiKey = process.env.ANTHROPIC_API_KEY;
   const changed = detectChangedFiles(target, opts);
   const changedApp = detectChangedAppFiles(target, opts);
@@ -3367,7 +3864,7 @@ async function check(opts = {}) {
   const precedentMisses = [];
   for (const rel of changed) {
     if (!isComponentFile(rel)) continue;
-    const body = readSafe(join7(target, rel));
+    const body = readSafe(join10(target, rel));
     if (!body) continue;
     const hasDeclaration = /\/\/\s*Composition study:/i.test(body);
     if (!hasDeclaration) {
@@ -3413,7 +3910,7 @@ async function check(opts = {}) {
   const fullScan = process.env.STYLECRIB_LINT_FULL === "1";
   for (const rel of changed) {
     if (!isComponentFile(rel)) continue;
-    const body = readSafe(join7(target, rel));
+    const body = readSafe(join10(target, rel));
     if (!body) continue;
     const newHits = runMonoTrackedCapsCheck(rel, body);
     if (fullScan) {
@@ -3444,22 +3941,23 @@ async function check(opts = {}) {
     );
     process.exit(1);
   }
+  const theme = themeContextForTarget(target);
   const allHits = [];
   for (const rel of changed) {
     if (!looksLikeUiFile(rel)) continue;
-    const body = readSafe(join7(target, rel));
+    const body = readSafe(join10(target, rel));
     if (!body) continue;
-    const newHits = runAllTextDetectors(rel, body);
+    const newHits = runAllTextDetectors(rel, body, theme);
     if (fullScan) {
       allHits.push(...newHits);
       continue;
     }
     const oldBody = readHeadBody(target, rel);
-    const oldHits = oldBody ? runAllTextDetectors(rel, oldBody) : [];
+    const oldHits = oldBody ? runAllTextDetectors(rel, oldBody, theme) : [];
     allHits.push(...subtractHitsBySample(newHits, oldHits));
   }
   for (const rel of changedApp) {
-    const body = readSafe(join7(target, rel));
+    const body = readSafe(join10(target, rel));
     if (!body) continue;
     const oldBody = readHeadBody(target, rel);
     if (oldBody === null) continue;
@@ -3538,7 +4036,7 @@ async function check(opts = {}) {
     console.error(import_picocolors4.default.dim('    STYLECRIB_SKIP_QA="<one-line reason>" git commit'));
     process.exit(1);
   }
-  const conductor = readSafe(join7(target, ".claude/agents/qa-conductor.md"));
+  const conductor = readSafe(join10(target, ".claude/agents/qa-conductor.md"));
   if (!conductor) {
     console.error(import_picocolors4.default.red("\u2717 ") + "QA Conductor agent not installed.");
     console.error(
@@ -3548,8 +4046,8 @@ async function check(opts = {}) {
     );
     process.exit(1);
   }
-  const direction = readSafe(join7(target, "design-system/DIRECTION.md")) || readSafe(join7(target, "design-system/THEME.md")) || "(No design-system/DIRECTION.md or THEME.md found \u2014 review will rely on the QA Conductor's general principles.)";
-  const feedback = readSafe(join7(target, ".stylecrib/feedback.md"));
+  const direction = readSafe(join10(target, "design-system/DIRECTION.md")) || readSafe(join10(target, "design-system/THEME.md")) || "(No design-system/DIRECTION.md or THEME.md found \u2014 review will rely on the QA Conductor's general principles.)";
+  const feedback = readSafe(join10(target, ".stylecrib/feedback.md"));
   if (!opts.silent) {
     const route = apiKey ? "Anthropic API" : "Claude Code CLI";
     console.log(
@@ -3560,7 +4058,7 @@ async function check(opts = {}) {
     for (const f of changed) console.log(import_picocolors4.default.dim("  \xB7 " + f));
   }
   const fileContents = changed.map((rel) => {
-    const path2 = join7(target, rel);
+    const path2 = join10(target, rel);
     const body = readSafe(path2);
     return body ? `## ${rel}
 
@@ -3690,7 +4188,7 @@ function looksLikeAppFile(path2) {
 }
 function logQaBypass(target, files, kind, reason) {
   try {
-    const dir = join7(target, "reports");
+    const dir = join10(target, "reports");
     mkdirSync3(dir, { recursive: true });
     ensureReportsReadme(dir);
     const record = {
@@ -3706,13 +4204,13 @@ function logQaBypass(target, files, kind, reason) {
         }
       })()
     };
-    appendFileSync(join7(dir, "qa-bypasses.jsonl"), JSON.stringify(record) + "\n");
+    appendFileSync(join10(dir, "qa-bypasses.jsonl"), JSON.stringify(record) + "\n");
   } catch {
   }
 }
 function ensureReportsReadme(reportsDir) {
-  const path2 = join7(reportsDir, "README.md");
-  if (existsSync3(path2)) return;
+  const path2 = join10(reportsDir, "README.md");
+  if (existsSync5(path2)) return;
   const body = `# reports/
 
 This directory is written by the StyleCrib harness. Files here are not
@@ -3817,8 +4315,8 @@ function isComponentFile(path2) {
 }
 function readSafe(path2) {
   try {
-    if (!existsSync3(path2)) return null;
-    return readFileSync3(path2, "utf8");
+    if (!existsSync5(path2)) return null;
+    return readFileSync4(path2, "utf8");
   } catch {
     return null;
   }
@@ -3839,7 +4337,7 @@ function findClaudeCli() {
     "/opt/homebrew/bin/claude"
   ];
   for (const p of candidates) {
-    if (existsSync3(p)) return p;
+    if (existsSync5(p)) return p;
   }
   return null;
 }
@@ -3847,21 +4345,21 @@ function findClaudeCli() {
 // src/commands/review-site.ts
 init_esm_shims();
 var import_picocolors5 = __toESM(require_picocolors(), 1);
-import { readFileSync as readFileSync4, readdirSync, statSync, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
-import { resolve as resolve8, join as join8, relative as relative4 } from "path";
+import { readFileSync as readFileSync5, readdirSync as readdirSync2, statSync, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
+import { resolve as resolve7, join as join11, relative as relative4 } from "path";
 init_slop_rules();
 function walkUiFiles(siteRoot) {
   const out = [];
   const visit = (dir) => {
     let entries;
     try {
-      entries = readdirSync(dir);
+      entries = readdirSync2(dir);
     } catch {
       return;
     }
     for (const name of entries) {
       if (name.startsWith(".") || name === "node_modules" || name === "dist" || name === "build") continue;
-      const p = join8(dir, name);
+      const p = join11(dir, name);
       let s;
       try {
         s = statSync(p);
@@ -3882,22 +4380,23 @@ function walkUiFiles(siteRoot) {
   return out;
 }
 async function reviewSite(opts = {}) {
-  const target = resolve8(opts.target ?? process.cwd());
-  const siteRoot = resolve8(opts.siteRoot ?? join8(target, "site/src"));
-  const outDir = resolve8(opts.outDir ?? join8(target, "reports"));
+  const target = resolve7(opts.target ?? process.cwd());
+  const siteRoot = resolve7(opts.siteRoot ?? join11(target, "site/src"));
+  const outDir = resolve7(opts.outDir ?? join11(target, "reports"));
   console.log(import_picocolors5.default.dim(`Walking ${siteRoot} for UI files\u2026`));
   const files = walkUiFiles(siteRoot);
   console.log(import_picocolors5.default.dim(`  ${files.length} files found. Running structural slop detectors\u2026`));
+  const sweepTheme = themeContextForTarget(resolve7(target));
   const allHits = [];
   for (const abs of files) {
     let body;
     try {
-      body = readFileSync4(abs, "utf8");
+      body = readFileSync5(abs, "utf8");
     } catch {
       continue;
     }
-    const rel = relative4(resolve8(target), abs);
-    allHits.push(...runAllTextDetectors(rel, body));
+    const rel = relative4(resolve7(target), abs);
+    allHits.push(...runAllTextDetectors(rel, body, sweepTheme));
   }
   const byRule = /* @__PURE__ */ new Map();
   const byFile = /* @__PURE__ */ new Map();
@@ -3919,8 +4418,14 @@ async function reviewSite(opts = {}) {
   lines.push(`Block-severity hits: **${blocks}**`);
   lines.push(`Warn-severity hits: **${warns}**`);
   lines.push("");
-  if (blocks === 0 && warns === 0) {
-    lines.push("**No slop detected.** Every UI file in the tree passes the structural gate.");
+  if (files.length === 0) {
+    lines.push(
+      "**Scanned nothing \u2014 this sweep proves nothing.** No UI files were found under the scan root, so the result below is vacuous rather than clean. Check that the sweep is pointed at a directory that actually contains `src/components` / `src/pages`."
+    );
+  } else if (blocks === 0 && warns === 0) {
+    lines.push(
+      `**No slop detected.** All ${files.length} UI file(s) under the scan root pass the structural gate.`
+    );
   } else {
     lines.push("## Hits by rule");
     lines.push("");
@@ -3947,9 +4452,9 @@ async function reviewSite(opts = {}) {
     }
   }
   mkdirSync4(outDir, { recursive: true });
-  const outPath = join8(outDir, `nightly-slop-${today}.md`);
+  const outPath = join11(outDir, `nightly-slop-${today}.md`);
   writeFileSync4(outPath, lines.join("\n") + "\n");
-  writeFileSync4(join8(outDir, "nightly-slop-latest.md"), lines.join("\n") + "\n");
+  writeFileSync4(join11(outDir, "nightly-slop-latest.md"), lines.join("\n") + "\n");
   console.log("");
   console.log(import_picocolors5.default.dim(`Wrote ${outPath}`));
   console.log(import_picocolors5.default.dim(`  ${blocks} block-severity, ${warns} warn-severity`));
@@ -3958,8 +4463,8 @@ async function reviewSite(opts = {}) {
 // src/commands/rule.ts
 init_esm_shims();
 var import_picocolors6 = __toESM(require_picocolors(), 1);
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync5, existsSync as existsSync4, mkdirSync as mkdirSync5 } from "fs";
-import { resolve as resolve9, join as join9 } from "path";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync5, existsSync as existsSync6, mkdirSync as mkdirSync5 } from "fs";
+import { resolve as resolve8, join as join12 } from "path";
 import { input as input2, select as select2 } from "@inquirer/prompts";
 var CATEGORIES = [
   "chrome",
@@ -3973,7 +4478,8 @@ var CATEGORIES = [
   "provenance"
 ];
 async function ruleAdd(opts = {}) {
-  const target = resolve9(opts.target ?? process.cwd());
+  const target = resolve8(opts.target ?? process.cwd());
+  assertInteractive("`stylecrib rule add`");
   console.log(import_picocolors6.default.bold("Add a slop rule to this repo's custom rulebook."));
   console.log(import_picocolors6.default.dim("  Custom rules live at .stylecrib/custom-rules.ts and load automatically."));
   console.log("");
@@ -4022,10 +4528,10 @@ async function ruleAdd(opts = {}) {
     message: "Sample fix \u2014 what to write instead:",
     validate: (v) => v.length > 0 || "Write the corrected version so authors know the right pattern."
   });
-  const dir = join9(target, ".stylecrib");
+  const dir = join12(target, ".stylecrib");
   mkdirSync5(dir, { recursive: true });
-  const path2 = join9(dir, "custom-rules.ts");
-  const existing = existsSync4(path2) ? readFileSync5(path2, "utf8") : SEED_CUSTOM_RULES;
+  const path2 = join12(dir, "custom-rules.ts");
+  const existing = existsSync6(path2) ? readFileSync6(path2, "utf8") : SEED_CUSTOM_RULES;
   const insertion = `
   // \u2500\u2500\u2500 ${id} \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
   // ${description}
@@ -4059,13 +4565,13 @@ async function ruleAdd(opts = {}) {
   console.log(import_picocolors6.default.dim(`  To share with the community: stylecrib rule share ${id}`));
 }
 async function ruleShare(id, opts = {}) {
-  const target = resolve9(opts.target ?? process.cwd());
-  const path2 = join9(target, ".stylecrib", "custom-rules.ts");
-  if (!existsSync4(path2)) {
+  const target = resolve8(opts.target ?? process.cwd());
+  const path2 = join12(target, ".stylecrib", "custom-rules.ts");
+  if (!existsSync6(path2)) {
     console.error(import_picocolors6.default.red("\u2717 ") + ".stylecrib/custom-rules.ts not found. Run `stylecrib rule add` first.");
     process.exit(1);
   }
-  const body = readFileSync5(path2, "utf8");
+  const body = readFileSync6(path2, "utf8");
   const start = body.indexOf(`id: "${id}"`);
   if (start < 0) {
     console.error(import_picocolors6.default.red("\u2717 ") + `Rule ${id} not found in .stylecrib/custom-rules.ts.`);
@@ -4163,11 +4669,11 @@ function extractFilePaths(event) {
 // src/commands/audit.ts
 init_esm_shims();
 var import_picocolors7 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync6, statSync as statSync2 } from "fs";
-import { resolve as resolve10, join as join10, basename as basename2 } from "path";
+import { existsSync as existsSync7, readdirSync as readdirSync3, readFileSync as readFileSync7, statSync as statSync2 } from "fs";
+import { resolve as resolve9, join as join13, basename as basename2 } from "path";
 import Anthropic3 from "@anthropic-ai/sdk";
 async function audit(opts = {}) {
-  const target = resolve10(opts.target ?? process.cwd());
+  const target = resolve9(opts.target ?? process.cwd());
   const apiKey = process.env.ANTHROPIC_API_KEY;
   if (!apiKey) {
     console.error(import_picocolors7.default.red("\u2717 ") + "ANTHROPIC_API_KEY not set.");
@@ -4187,8 +4693,8 @@ async function audit(opts = {}) {
     );
     process.exit(1);
   }
-  const usingBundled = !existsSync5(
-    join10(target, ".claude/agents/homogeneity-detector.md")
+  const usingBundled = !existsSync7(
+    join13(target, ".claude/agents/homogeneity-detector.md")
   );
   if (usingBundled && !opts.silent) {
     console.log(
@@ -4197,7 +4703,7 @@ async function audit(opts = {}) {
       )
     );
   }
-  const directionDoctrine = readSafe2(join10(target, "design-system/THEME.md")) ?? "";
+  const directionDoctrine = readSafe2(join13(target, "design-system/THEME.md")) ?? "";
   if (!opts.silent) {
     console.log(import_picocolors7.default.bold("\u25C7 StyleCrib audit \u2014 whole-project drift report"));
     console.log("");
@@ -4225,7 +4731,7 @@ async function audit(opts = {}) {
       );
     }
     const filesBody = fam.files.map((rel) => {
-      const body = readSafe2(join10(target, rel));
+      const body = readSafe2(join13(target, rel));
       return body ? `## ${rel}
 
 \`\`\`tsx
@@ -4315,18 +4821,18 @@ function discoverFamilies(target, only) {
   const out = [];
   for (const c2 of candidates) {
     if (only && c2.name !== only) continue;
-    const abs = join10(target, c2.dir);
-    if (!existsSync5(abs)) continue;
+    const abs = join13(target, c2.dir);
+    if (!existsSync7(abs)) continue;
     if (!statSync2(abs).isDirectory()) continue;
-    const files = readdirSync2(abs).filter((f) => f.endsWith(".tsx")).map((f) => join10(c2.dir, f));
+    const files = readdirSync3(abs).filter((f) => f.endsWith(".tsx")).map((f) => join13(c2.dir, f));
     if (files.length > 0) out.push({ name: c2.name, files });
   }
   return out;
 }
 function readSafe2(path2) {
   try {
-    if (!existsSync5(path2)) return null;
-    return readFileSync6(path2, "utf8");
+    if (!existsSync7(path2)) return null;
+    return readFileSync7(path2, "utf8");
   } catch {
     return null;
   }
@@ -4335,11 +4841,11 @@ function readSafe2(path2) {
 // src/commands/reject.ts
 init_esm_shims();
 var import_picocolors8 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync6, mkdirSync as mkdirSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "fs";
-import { resolve as resolve11, join as join11, dirname as dirname7 } from "path";
+import { existsSync as existsSync8, mkdirSync as mkdirSync6, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
+import { resolve as resolve10, join as join14, dirname as dirname6 } from "path";
 async function reject(opts = {}) {
-  const target = resolve11(opts.target ?? process.cwd());
-  const path2 = join11(target, ".stylecrib", "feedback.md");
+  const target = resolve10(opts.target ?? process.cwd());
+  const path2 = join14(target, ".stylecrib", "feedback.md");
   const pattern = opts.pattern?.trim();
   const replacement = opts.replacement?.trim();
   if (!pattern) {
@@ -4354,7 +4860,7 @@ async function reject(opts = {}) {
     );
     process.exit(1);
   }
-  const now = process.env.TASTE_NOW ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const now = process.env.STYLECRIB_NOW ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const entry = `
 ## Rejection \u2014 ${now}
 
@@ -4364,9 +4870,9 @@ async function reject(opts = {}) {
 ` : `
 **Replacement:** _(not specified \u2014 propose alternatives that don't repeat this pattern)_
 `);
-  const existing = existsSync6(path2) ? readFileSync7(path2, "utf8") : HEADER_TEMPLATE;
+  const existing = existsSync8(path2) ? readFileSync8(path2, "utf8") : HEADER_TEMPLATE;
   const body = existing.trimEnd() + "\n" + entry;
-  mkdirSync6(dirname7(path2), { recursive: true });
+  mkdirSync6(dirname6(path2), { recursive: true });
   writeFileSync6(path2, body);
   console.log(import_picocolors8.default.green("\u2713 ") + "Rejection recorded in " + import_picocolors8.default.cyan(".stylecrib/feedback.md"));
   console.log("");
@@ -4397,19 +4903,19 @@ that gap. It's plain markdown \u2014 readable by humans, loaded by agents.
 // src/commands/status.ts
 init_esm_shims();
 var import_picocolors9 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync7, readFileSync as readFileSync8, statSync as statSync3 } from "fs";
-import { resolve as resolve12, join as join12 } from "path";
+import { existsSync as existsSync9, readFileSync as readFileSync9, statSync as statSync3 } from "fs";
+import { resolve as resolve11, join as join15 } from "path";
 async function status(opts = {}) {
-  const target = resolve12(opts.target ?? process.cwd());
+  const target = resolve11(opts.target ?? process.cwd());
   console.log(import_picocolors9.default.bold("\u25C7 StyleCrib enforcement status"));
   console.log(import_picocolors9.default.dim("  " + target));
   console.log("");
   let anyFail = false;
-  const huskyPath = join12(target, ".husky", "pre-commit");
-  const gitHookPath = join12(target, ".git", "hooks", "pre-commit");
-  const hookPath = existsSync7(huskyPath) ? huskyPath : gitHookPath;
-  const hookExists = existsSync7(hookPath);
-  const hookCallsCheck = hookExists ? readFileSync8(hookPath, "utf8").includes("stylecrib check") : false;
+  const huskyPath = join15(target, ".husky", "pre-commit");
+  const gitHookPath = join15(target, ".git", "hooks", "pre-commit");
+  const hookPath = existsSync9(huskyPath) ? huskyPath : gitHookPath;
+  const hookExists = existsSync9(hookPath);
+  const hookCallsCheck = hookExists ? readFileSync9(hookPath, "utf8").includes("stylecrib check") : false;
   const hookExec = hookExists ? (statSync3(hookPath).mode & 73) !== 0 : false;
   const hookOk = hookExists && hookCallsCheck && hookExec;
   printLine(
@@ -4418,7 +4924,7 @@ async function status(opts = {}) {
     hookOk ? "pass" : "fail"
   );
   if (!hookOk) anyFail = true;
-  const agentsDir = join12(target, ".claude", "agents");
+  const agentsDir = join15(target, ".claude", "agents");
   const requiredAgents = [
     "design-director.md",
     "design-systems-engineer.md",
@@ -4429,7 +4935,7 @@ async function status(opts = {}) {
     "brand-precedent.md"
   ];
   const presentAgents = requiredAgents.filter(
-    (f) => existsSync7(join12(agentsDir, f))
+    (f) => existsSync9(join15(agentsDir, f))
   );
   const agentsOk = presentAgents.length === requiredAgents.length;
   printLine(
@@ -4437,24 +4943,24 @@ async function status(opts = {}) {
     agentsOk ? `PASS (${presentAgents.length}/${requiredAgents.length})` : `WARN (${presentAgents.length}/${requiredAgents.length}) \u2014 missing: ` + requiredAgents.filter((f) => !presentAgents.includes(f)).join(", "),
     agentsOk ? "pass" : "warn"
   );
-  const cursorrulesOk = existsSync7(join12(target, ".cursorrules"));
+  const cursorrulesOk = existsSync9(join15(target, ".cursorrules"));
   printLine(
     ".cursorrules",
     cursorrulesOk ? "PASS (Cursor users routed through agents)" : "WARN: missing \u2014 Cursor users won't route through agents on this repo",
     cursorrulesOk ? "pass" : "warn"
   );
-  const actionPath = join12(target, ".github", "workflows", "stylecrib-review.yml");
-  const actionOk = existsSync7(actionPath);
+  const actionPath = join15(target, ".github", "workflows", "stylecrib-review.yml");
+  const actionOk = existsSync9(actionPath);
   printLine(
     "GitHub Action (PR gating)",
     actionOk ? "PASS" : "WARN: not installed \u2014 PRs won't be gated by the QA loop in CI",
     actionOk ? "pass" : "warn"
   );
-  const feedbackPath = join12(target, ".stylecrib", "feedback.md");
-  const feedbackOk = existsSync7(feedbackPath);
+  const feedbackPath = join15(target, ".stylecrib", "feedback.md");
+  const feedbackOk = existsSync9(feedbackPath);
   let rejectionCount = 0;
   if (feedbackOk) {
-    const body = readFileSync8(feedbackPath, "utf8");
+    const body = readFileSync9(feedbackPath, "utf8");
     rejectionCount = (body.match(/^## Rejection — /gm) || []).length;
   }
   printLine(
@@ -4462,7 +4968,7 @@ async function status(opts = {}) {
     feedbackOk ? `PASS (${rejectionCount} rejection${rejectionCount === 1 ? "" : "s"} recorded)` : 'INFO: no rejections recorded yet \u2014 add one with `stylecrib reject "<pattern>"`',
     feedbackOk ? "pass" : "info"
   );
-  const directionOk = existsSync7(join12(target, "design-system", "THEME.md"));
+  const directionOk = existsSync9(join15(target, "design-system", "THEME.md"));
   printLine(
     "design-system/THEME.md",
     directionOk ? "PASS" : "FAIL: missing \u2014 agents have no project direction to pivot reviews on. Run `stylecrib init`",
@@ -4475,9 +4981,9 @@ async function status(opts = {}) {
     apiKey ? "PASS" : "WARN: not set \u2014 `stylecrib check` will exit early; hook will warn & no-op",
     apiKey ? "pass" : "warn"
   );
-  const bypassPath = join12(target, "reports", "qa-bypasses.jsonl");
-  if (existsSync7(bypassPath)) {
-    const lines = readFileSync8(bypassPath, "utf8").split("\n").filter((l) => l.trim());
+  const bypassPath = join15(target, "reports", "qa-bypasses.jsonl");
+  if (existsSync9(bypassPath)) {
+    const lines = readFileSync9(bypassPath, "utf8").split("\n").filter((l) => l.trim());
     printLine(
       "qa-bypass log",
       `INFO: ${lines.length} bypass${lines.length === 1 ? "" : "es"} recorded \u2192 reports/qa-bypasses.jsonl`,
@@ -4504,20 +5010,574 @@ function printLine(label, state, level) {
   console.log("  " + tag + import_picocolors9.default.bold(label.padEnd(28)) + import_picocolors9.default.dim(" " + state));
 }
 
-// src/commands/harness.ts
+// src/commands/verify.ts
 init_esm_shims();
 var import_picocolors10 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync15 } from "fs";
-import { join as join21, resolve as resolve13 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync10, mkdirSync as mkdirSync7 } from "fs";
+import { resolve as resolve12, join as join16, dirname as dirname7 } from "path";
+import { spawn, execSync as execSync4, execFileSync } from "child_process";
+async function verify(opts = {}) {
+  const target = resolve12(opts.target ?? process.cwd());
+  const bootTimeoutMs = Math.max(5e3, parseInt(opts.timeout ?? "60000", 10) || 6e4);
+  console.log(import_picocolors10.default.bold("\u25C7 StyleCrib verify") + import_picocolors10.default.dim(" \u2014 runtime smoke gate"));
+  console.log(import_picocolors10.default.dim("  " + target));
+  console.log("");
+  const results = [];
+  if (opts.typecheck === false) {
+    results.push({ name: "typecheck", status: "skip", detail: "--no-typecheck" });
+  } else {
+    results.push(runTypecheck(target));
+  }
+  if (opts.boot === false) {
+    results.push({ name: "dev-server boot", status: "skip", detail: "--no-boot" });
+  } else {
+    results.push(await runBoot(target, opts.route ?? "/", opts.screenshot, bootTimeoutMs));
+  }
+  console.log("");
+  for (const r of results) {
+    const tag = r.status === "pass" ? import_picocolors10.default.green("PASS") : r.status === "fail" ? import_picocolors10.default.red("FAIL") : import_picocolors10.default.dim("SKIP");
+    console.log(`  ${tag}  ${r.name}${r.detail ? import_picocolors10.default.dim(" \u2014 " + r.detail) : ""}`);
+  }
+  const failed = results.filter((r) => r.status === "fail");
+  if (failed.length > 0) {
+    console.log("");
+    for (const f of failed) {
+      if (!f.output) continue;
+      console.log(import_picocolors10.default.red(`\u2500\u2500 ${f.name} output \u2500\u2500`));
+      console.log(indent2(trimOutput(f.output), 2));
+      console.log("");
+    }
+    console.log(import_picocolors10.default.red(`\u2717 verify failed \u2014 ${failed.length} of ${results.length} step(s).`));
+    console.log(import_picocolors10.default.dim("  A sweep that passes `stylecrib check` can still break the app."));
+    console.log(import_picocolors10.default.dim("  Fix the above before pushing."));
+    process.exitCode = 1;
+    return;
+  }
+  const ran = results.filter((r) => r.status === "pass").length;
+  console.log("");
+  if (ran === 0) {
+    console.log(import_picocolors10.default.yellow("\u26A0 verify ran no checks \u2014 nothing was verified."));
+    for (const r of results) {
+      console.log(import_picocolors10.default.dim(`  ${r.name}: ${r.detail}`));
+    }
+    process.exitCode = 1;
+    return;
+  }
+  console.log(import_picocolors10.default.green(`\u2713 verify passed \u2014 ${ran} step(s), 0 failures.`));
+}
+function runTypecheck(target) {
+  const pkgPath = join16(target, "package.json");
+  if (!existsSync10(pkgPath)) {
+    return { name: "typecheck", status: "skip", detail: "no package.json" };
+  }
+  let scripts = {};
+  try {
+    scripts = JSON.parse(readFileSync10(pkgPath, "utf8")).scripts ?? {};
+  } catch {
+    return { name: "typecheck", status: "skip", detail: "unreadable package.json" };
+  }
+  const hasTsconfig = existsSync10(join16(target, "tsconfig.json"));
+  let cmd;
+  if (scripts.typecheck) {
+    cmd = "npm run typecheck --silent";
+  } else if (hasTsconfig) {
+    cmd = "npx --no-install tsc --noEmit";
+  } else {
+    return { name: "typecheck", status: "skip", detail: "no typecheck script and no tsconfig.json" };
+  }
+  process.stdout.write(import_picocolors10.default.dim(`  \xB7 typecheck (${cmd}) \u2026 `));
+  try {
+    execSync4(cmd, {
+      cwd: target,
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: 3e5,
+      encoding: "utf8"
+    });
+    console.log(import_picocolors10.default.green("ok"));
+    return { name: "typecheck", status: "pass", detail: cmd };
+  } catch (err) {
+    console.log(import_picocolors10.default.red("failed"));
+    const e = err;
+    return {
+      name: "typecheck",
+      status: "fail",
+      detail: cmd,
+      output: [e.stdout, e.stderr].filter(Boolean).join("\n") || e.message || "(no output)"
+    };
+  }
+}
+async function runBoot(target, route, screenshotPath, timeoutMs) {
+  const pkgPath = join16(target, "package.json");
+  if (!existsSync10(pkgPath)) {
+    return { name: "dev-server boot", status: "skip", detail: "no package.json" };
+  }
+  let scripts = {};
+  try {
+    scripts = JSON.parse(readFileSync10(pkgPath, "utf8")).scripts ?? {};
+  } catch {
+    return { name: "dev-server boot", status: "skip", detail: "unreadable package.json" };
+  }
+  if (!scripts.dev) {
+    return { name: "dev-server boot", status: "skip", detail: "no `dev` script" };
+  }
+  if (!existsSync10(join16(target, "node_modules"))) {
+    return { name: "dev-server boot", status: "skip", detail: "node_modules missing \u2014 run npm install" };
+  }
+  process.stdout.write(import_picocolors10.default.dim("  \xB7 booting dev server \u2026 "));
+  const child = spawn("npm", ["run", "dev"], {
+    cwd: target,
+    detached: true,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  let log = "";
+  const onData = (b) => {
+    log += b.toString();
+  };
+  child.stdout?.on("data", onData);
+  child.stderr?.on("data", onData);
+  const killGroup = () => {
+    if (child.pid === void 0) return;
+    try {
+      process.kill(-child.pid, "SIGTERM");
+    } catch {
+    }
+    try {
+      process.kill(-child.pid, "SIGKILL");
+    } catch {
+    }
+    try {
+      child.kill("SIGKILL");
+    } catch {
+    }
+  };
+  const onSignal = (sig) => {
+    killGroup();
+    process.exitCode = 130;
+    process.removeListener("SIGINT", onSignal);
+    process.removeListener("SIGTERM", onSignal);
+    process.kill(process.pid, sig);
+  };
+  process.once("SIGINT", onSignal);
+  process.once("SIGTERM", onSignal);
+  try {
+    const url = await waitForUrl(child, () => log, timeoutMs);
+    if (!url) {
+      console.log(import_picocolors10.default.red("failed"));
+      return {
+        name: "dev-server boot",
+        status: "fail",
+        detail: `no server URL within ${Math.round(timeoutMs / 1e3)}s`,
+        output: log
+      };
+    }
+    const pageUrl = url.replace(/\/$/, "") + (route.startsWith("/") ? route : "/" + route);
+    const res = await fetchWithRetry(pageUrl, 10, 500);
+    if (!res) {
+      console.log(import_picocolors10.default.red("failed"));
+      return { name: "dev-server boot", status: "fail", detail: `no response from ${pageUrl}`, output: log };
+    }
+    if (!res.ok) {
+      console.log(import_picocolors10.default.red("failed"));
+      return {
+        name: "dev-server boot",
+        status: "fail",
+        detail: `${pageUrl} returned HTTP ${res.status}`,
+        output: res.body.slice(0, 2e3) + "\n---\n" + log
+      };
+    }
+    const dom = renderDom(pageUrl);
+    if (!dom) {
+      console.log(import_picocolors10.default.yellow("skipped"));
+      return {
+        name: "dev-server boot",
+        status: "skip",
+        detail: `server came up at ${pageUrl}, but no headless Chrome was usable, so the render could not be verified \u2014 install Chrome, or re-run where it is available`
+      };
+    }
+    const inspected = dom;
+    const method = "rendered DOM";
+    const bodyProblem = describeBodyProblem(inspected, true);
+    if (bodyProblem) {
+      console.log(import_picocolors10.default.red("failed"));
+      return {
+        name: "dev-server boot",
+        status: "fail",
+        detail: `${bodyProblem} (checked ${dom ? "rendered DOM" : "HTTP body"})`,
+        output: inspected.slice(0, 3e3)
+      };
+    }
+    let shotNote = "";
+    if (screenshotPath) {
+      const abs = resolve12(screenshotPath);
+      mkdirSync7(dirname7(abs), { recursive: true });
+      try {
+        captureScreenshot(pageUrl, abs);
+        shotNote = ` \xB7 screenshot \u2192 ${screenshotPath}`;
+      } catch (e) {
+        shotNote = ` \xB7 screenshot skipped (${e.message})`;
+      }
+    }
+    console.log(import_picocolors10.default.green("ok"));
+    return {
+      name: "dev-server boot",
+      status: "pass",
+      detail: `${pageUrl} \xB7 ${method}, ${inspected.length} bytes${shotNote}`
+    };
+  } finally {
+    process.removeListener("SIGINT", onSignal);
+    process.removeListener("SIGTERM", onSignal);
+    killGroup();
+  }
+}
+function waitForUrl(child, getLog, timeoutMs) {
+  return new Promise((res) => {
+    const started = Date.now();
+    let settled = false;
+    const done = (v) => {
+      if (!settled) {
+        settled = true;
+        clearInterval(t);
+        res(v);
+      }
+    };
+    child.once("exit", () => done(null));
+    child.once("error", () => done(null));
+    const t = setInterval(() => {
+      const m = getLog().match(/https?:\/\/(?:localhost|127\.0\.0\.1)(?::\d+)?\/?/);
+      if (m) return done(m[0]);
+      if (Date.now() - started > timeoutMs) done(null);
+    }, 250);
+  });
+}
+async function fetchWithRetry(url, attempts, delayMs) {
+  for (let i = 0; i < attempts; i++) {
+    try {
+      const r = await fetch(url, { redirect: "follow" });
+      return { ok: r.ok, status: r.status, body: await r.text() };
+    } catch {
+      await sleep(delayMs);
+    }
+  }
+  return null;
+}
+function renderDom(url) {
+  for (const c2 of chromeCandidates()) {
+    try {
+      return execFileSync(c2, [
+        "--headless",
+        "--disable-gpu",
+        "--hide-scrollbars",
+        "--virtual-time-budget=5000",
+        "--dump-dom",
+        url
+      ], { stdio: ["ignore", "pipe", "ignore"], timeout: 3e4, encoding: "utf8" });
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+function describeBodyProblem(body, isDom) {
+  if (/vite-error-overlay/i.test(body)) {
+    return "page served a Vite error overlay";
+  }
+  if (/Internal Server Error|Cannot GET |Failed to resolve import/i.test(body)) {
+    return "page contains a server error";
+  }
+  if (isDom) {
+    const mount = body.match(/<div[^>]+id=["']root["'][^>]*>([\s\S]*?)<\/div>/i);
+    if (mount && mount[1].trim().length === 0) {
+      return "mount node #root is empty after JS ran \u2014 the app threw before rendering";
+    }
+    if (!mount && !/<div[^>]+id=["']app["']/i.test(body)) {
+      return "no #root / #app mount node in the rendered DOM";
+    }
+  } else if (body.trim().length < 80) {
+    return `page body is only ${body.trim().length} bytes \u2014 likely not a real render`;
+  }
+  return null;
+}
+function chromeCandidates() {
+  return [
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    "google-chrome",
+    "chromium"
+  ];
+}
+function captureScreenshot(url, outPath) {
+  for (const c2 of chromeCandidates()) {
+    try {
+      execFileSync(c2, [
+        "--headless",
+        "--disable-gpu",
+        "--hide-scrollbars",
+        `--screenshot=${outPath}`,
+        "--window-size=1440,1600",
+        url
+      ], { stdio: ["ignore", "ignore", "ignore"], timeout: 3e4 });
+      return;
+    } catch {
+      continue;
+    }
+  }
+  throw new Error("no headless Chrome found");
+}
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+function trimOutput(s, maxLines = 40) {
+  const lines = s.split("\n").filter((l) => l.trim() !== "");
+  if (lines.length <= maxLines) return lines.join("\n");
+  return [...lines.slice(0, maxLines), `\u2026 ${lines.length - maxLines} more line(s)`].join("\n");
+}
+function indent2(s, n) {
+  const pad = " ".repeat(n);
+  return s.split("\n").map((l) => pad + l).join("\n");
+}
+
+// src/commands/mcp.ts
+init_esm_shims();
+import { readFileSync as readFileSync11, existsSync as existsSync11 } from "fs";
+import { join as join17 } from "path";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+init_slop_rules();
+async function mcp(_opts = {}) {
+  const toStderr = (...args) => console.error(...args);
+  console.log = toStderr;
+  console.info = toStderr;
+  console.warn = toStderr;
+  const server = new McpServer({ name: "stylecrib", version: VERSION });
+  server.registerTool(
+    "list_themes",
+    {
+      title: "List StyleCrib themes",
+      description: "The 25 canonical StyleCrib directions: slug, display name, one-line description, and whether `emit_theme_tokens` can currently generate a Tailwind config for it. Four themes use a newer token format the emitter can't read yet and are marked emittable: false \u2014 pick another or use get_theme for the brief alone.",
+      inputSchema: {}
+    },
+    async () => {
+      const themes = DIRECTION_CHOICES.filter((d) => d.value !== "custom").map((d) => ({
+        slug: d.value,
+        name: d.name,
+        description: d.description,
+        emittable: isEmittable(d.value)
+      }));
+      return text(JSON.stringify({ count: themes.length, themes }, null, 2));
+    }
+  );
+  server.registerTool(
+    "get_theme",
+    {
+      title: "Get a StyleCrib theme",
+      description: "The full THEME.md design brief for one theme \u2014 ethos, palette, typography, motion, and the per-theme refusals. Use this to brief an agent before it writes UI for a project on that theme.",
+      inputSchema: {
+        slug: z.string().describe("Theme slug from list_themes, e.g. 'signal-dark'")
+      }
+    },
+    async ({ slug }) => {
+      if (!VALID_DIRECTIONS.includes(slug) || slug === "custom") {
+        return fail(`Unknown theme "${slug}". Call list_themes for valid slugs.`);
+      }
+      const themesDir = resolveAssetDir("themes");
+      if (!themesDir) return fail(missingAssetMessage("themes"));
+      const mdPath = join17(themesDir, slug, "THEME.md");
+      if (!existsSync11(mdPath)) return fail(`No THEME.md for "${slug}" at ${mdPath}.`);
+      const header2 = `# ${slug}
+
+emittable: ${isEmittable(slug)}
+tokens: themes/${slug}/tokens.ts
+
+---
+
+`;
+      return text(header2 + readFileSync11(mdPath, "utf8"));
+    }
+  );
+  server.registerTool(
+    "emit_theme_tokens",
+    {
+      title: "Generate Tailwind tokens for a theme",
+      description: "Generate tailwind.config.ts (or .js) and src/index.css for a theme \u2014 the same files `stylecrib init` writes. Returns both as text. The config references `tailwindcss-animate`, so that package must be installed alongside Tailwind 3. Fails cleanly for the four themes whose token format isn't readable yet; list_themes marks those.",
+      inputSchema: {
+        slug: z.string().describe("Theme slug from list_themes"),
+        typescript: z.boolean().optional().describe("Emit tailwind.config.ts (default true) or tailwind.config.js")
+      }
+    },
+    async ({ slug, typescript }) => {
+      if (!VALID_DIRECTIONS.includes(slug) || slug === "custom") {
+        return fail(`Unknown theme "${slug}". Call list_themes for valid slugs.`);
+      }
+      try {
+        const direction = slug;
+        await assertDirectionEmittable(direction);
+        const emitted = await emitTokens({ direction, stack: syntheticStack(typescript ?? true) });
+        return text(
+          `// ===== ${emitted.tailwindConfig.path} =====
+` + emitted.tailwindConfig.content + `
+
+/* ===== ${emitted.indexCss.path} ===== */
+` + emitted.indexCss.content
+        );
+      } catch (err) {
+        return fail(err instanceof Error ? err.message : String(err));
+      }
+    }
+  );
+  server.registerTool(
+    "list_rules",
+    {
+      title: "List slop rules",
+      description: "The 39-rule catalog StyleCrib enforces \u2014 what each refuses, severity, category, and where it's detected (commit time vs theme materialization). Filter by any field.",
+      inputSchema: {
+        category: z.string().optional().describe("e.g. typography, palette, layout, content, motion"),
+        severity: z.enum(["block", "warn"]).optional(),
+        detectorAt: z.string().optional().describe("check.ts | slop-blocklist.ts | qa-conductor")
+      }
+    },
+    async ({ category, severity, detectorAt }) => {
+      const rules = SLOP_RULES.filter(
+        (r) => (!category || r.category === category) && (!severity || r.severity === severity) && (!detectorAt || r.detectorAt === detectorAt)
+      );
+      return text(JSON.stringify({ count: rules.length, rules }, null, 2));
+    }
+  );
+  server.registerTool(
+    "check_slop",
+    {
+      title: "Check a file for AI-default slop",
+      description: "Run StyleCrib's text-pattern slop detectors against a file's contents and return every hit with its rule, line, and the offending sample. Covers 26 of the 32 commit-time rules \u2014 everything in the pre-commit hook except the two composition-study provenance checks, R-MONO-CAPS-TRACKED, the three diff-signature regression detectors (which need a diff, not a file), and the LLM review. Whole-file, not diff-scoped: it reports every hit present, not only ones a change introduced. Pass `theme` to also enforce per-theme rules such as R-SECOND-ACCENT.",
+      inputSchema: {
+        path: z.string().describe("File path, used for rule scoping (JSX brace-stripping applies to .tsx/.jsx)"),
+        content: z.string().describe("The file's full contents"),
+        theme: z.string().optional().describe("Active theme slug, enables theme-aware rules (e.g. 'signal-dark')")
+      }
+    },
+    async ({ path: path2, content, theme }) => {
+      let themeCtx = null;
+      if (theme) {
+        if (!VALID_DIRECTIONS.includes(theme)) {
+          return fail(`Unknown theme "${theme}". Call list_themes for valid slugs.`);
+        }
+        themeCtx = resolveThemeContext(theme);
+      }
+      const hits = runAllTextDetectors(path2, content, themeCtx);
+      return text(JSON.stringify(summarise(path2, hits), null, 2));
+    }
+  );
+  server.registerResource(
+    "rules",
+    "stylecrib://rules",
+    {
+      title: "StyleCrib slop-rule catalog",
+      description: "All 39 rules as JSON. Same data as list_rules with no filter.",
+      mimeType: "application/json"
+    },
+    async (uri) => ({
+      contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(SLOP_RULES, null, 2) }]
+    })
+  );
+  server.registerResource(
+    "agents",
+    new ResourceTemplate("stylecrib://agents/{name}", {
+      list: async () => ({
+        resources: Object.keys(BUNDLED_AGENTS).map((name) => ({
+          uri: `stylecrib://agents/${name}`,
+          name,
+          mimeType: "text/markdown"
+        }))
+      })
+    }),
+    {
+      title: "StyleCrib agent doctrines",
+      description: "The 19 subagent prompts that ship with the pack, by name.",
+      mimeType: "text/markdown"
+    },
+    async (uri, { name }) => {
+      const key = String(name);
+      const doc = BUNDLED_AGENTS[key];
+      if (!doc) throw new CliError(`No agent named "${key}". Known: ${Object.keys(BUNDLED_AGENTS).join(", ")}`);
+      return { contents: [{ uri: uri.href, mimeType: "text/markdown", text: doc }] };
+    }
+  );
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`stylecrib mcp ${VERSION} \u2014 serving over stdio`);
+}
+function text(body) {
+  return { content: [{ type: "text", text: body }] };
+}
+function fail(message) {
+  return { content: [{ type: "text", text: message }], isError: true };
+}
+var emittableCache = /* @__PURE__ */ new Map();
+function isEmittable(slug) {
+  const cached = emittableCache.get(slug);
+  if (cached !== void 0) return cached;
+  let ok = true;
+  try {
+    const themesDir = resolveAssetDir("themes");
+    const src = themesDir ? readFileSync11(join17(themesDir, slug, "tokens.ts"), "utf8") : "";
+    ok = /^\s*colors:\s*\{/m.test(src);
+  } catch {
+    ok = false;
+  }
+  emittableCache.set(slug, ok);
+  return ok;
+}
+function syntheticStack(ts) {
+  return {
+    rootPath: "",
+    packageJsonPath: "",
+    ts,
+    react: { version: "n/a", major: 0 },
+    vite: { version: "n/a", major: 0 },
+    tailwind: { version: "n/a", major: 0 },
+    hasTailwindConfig: false,
+    tailwindConfigPath: null,
+    hasSrcDir: true,
+    srcPath: "src",
+    notes: []
+  };
+}
+function summarise(path2, hits) {
+  const enriched = hits.map((h) => {
+    const rule2 = ruleById(h.ruleId);
+    return {
+      rule: h.ruleId,
+      severity: rule2?.severity ?? "block",
+      category: rule2?.category ?? "unknown",
+      line: h.line,
+      sample: h.sample,
+      description: rule2?.description ?? ""
+    };
+  });
+  const blocks = enriched.filter((h) => h.severity === "block").length;
+  return {
+    path: path2,
+    verdict: blocks > 0 ? "BLOCK" : enriched.length > 0 ? "WARN" : "PASS",
+    blockHits: blocks,
+    warnHits: enriched.length - blocks,
+    hits: enriched,
+    override: enriched.length > 0 ? "Silence a legitimate hit with `// slop-override: R-XXX \u2014 <reason>` within 3 lines above or 8 below." : void 0
+  };
+}
+
+// src/commands/harness.ts
+init_esm_shims();
+var import_picocolors11 = __toESM(require_picocolors(), 1);
+import { existsSync as existsSync19 } from "fs";
+import { join as join26, resolve as resolve13 } from "path";
 
 // src/theme-harness/materialize.ts
 init_esm_shims();
 import { writeFileSync as writeFileSync7 } from "fs";
-import { join as join13 } from "path";
+import { join as join18 } from "path";
 
 // src/theme-harness/lib/theme-yml.ts
 init_esm_shims();
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync12 } from "fs";
 import { parse as parseYaml } from "yaml";
 var REQUIRED_TOP = [
   "name",
@@ -4543,7 +5603,7 @@ var HEX_RE = /^#[0-9A-Fa-f]{6}$/;
 function loadTheme(path2) {
   let raw;
   try {
-    raw = parseYaml(readFileSync9(path2, "utf8"));
+    raw = parseYaml(readFileSync12(path2, "utf8"));
   } catch (e) {
     return { ok: false, errors: [`YAML parse error: ${e.message}`] };
   }
@@ -4629,7 +5689,7 @@ function validateTheme(raw) {
 
 // src/theme-harness/materialize.ts
 function materializeTheme(slug, themeDir) {
-  const ymlPath = join13(themeDir, "theme.yml");
+  const ymlPath = join18(themeDir, "theme.yml");
   const parsed = loadTheme(ymlPath);
   if (!parsed.ok) return { ok: false, errors: parsed.errors };
   const theme = parsed.theme;
@@ -4637,11 +5697,11 @@ function materializeTheme(slug, themeDir) {
   const tokensTs = renderTokensTs(slug, theme);
   const tailwindSnippet = renderTailwindSnippet(slug, theme);
   const wrote = [];
-  writeFileSync7(join13(themeDir, "THEME.md"), themeMd);
+  writeFileSync7(join18(themeDir, "THEME.md"), themeMd);
   wrote.push("THEME.md");
-  writeFileSync7(join13(themeDir, "tokens.ts"), tokensTs);
+  writeFileSync7(join18(themeDir, "tokens.ts"), tokensTs);
   wrote.push("tokens.ts");
-  writeFileSync7(join13(themeDir, "tailwind.snippet.ts"), tailwindSnippet);
+  writeFileSync7(join18(themeDir, "tailwind.snippet.ts"), tailwindSnippet);
   wrote.push("tailwind.snippet.ts");
   return { ok: true, wrote };
 }
@@ -4726,9 +5786,27 @@ function renderTokensTs(slug, t) {
   ].join("\n");
 }
 function renderTailwindSnippet(slug, t) {
+  const display = extractFontStack(t.typography.display);
+  const body = extractFontStack(t.typography.body);
+  const mono = extractFontStack(t.typography.mono);
+  const fontLines = [];
+  if (display) fontLines.push(`    display: ${JSON.stringify(display)},`);
+  if (body) fontLines.push(`    body: ${JSON.stringify(body)},`);
+  if (mono) fontLines.push(`    mono: ${JSON.stringify(mono)},`);
+  const fontBlock = fontLines.length ? [`  fontFamily: {`, ...fontLines, `  },`] : [
+    `  // fontFamily omitted \u2014 theme.yml's typography brief doesn't state a`,
+    `  // machine-readable fallback stack. Read the Typography section of`,
+    `  // THEME.md and set the stack by hand.`
+  ];
+  const unresolved = [
+    !display ? "display" : "",
+    !body ? "body" : "",
+    !mono ? "mono" : ""
+  ].filter(Boolean);
   return [
     `// Generated from theme.yml. Merge into your tailwind.config.ts under theme.extend.`,
     `// slug: ${slug}`,
+    unresolved.length ? `// Unresolved font stack(s): ${unresolved.join(", ")} \u2014 see THEME.md \xA7 Typography.` : "",
     ``,
     `export const ${camelCase(slug)}TailwindExtend = {`,
     `  colors: {`,
@@ -4739,15 +5817,21 @@ function renderTailwindSnippet(slug, t) {
     t.palette.secondary ? `    secondary: ${JSON.stringify(t.palette.secondary)},` : "",
     t.palette.signal ? `    signal: ${JSON.stringify(t.palette.signal)},` : "",
     `  },`,
-    `  fontFamily: {`,
-    `    display: ${JSON.stringify([t.typography.display])},`,
-    `    body: ${JSON.stringify([t.typography.body])},`,
-    `    mono: ${JSON.stringify([t.typography.mono])},`,
-    `  },`,
+    ...fontBlock,
     `};`,
     ``
   ].filter((l) => l !== "").join("\n");
 }
+function extractFontStack(brief) {
+  if (!brief) return null;
+  const text2 = String(brief).trim();
+  if (/^none\b/i.test(text2)) return null;
+  const m = text2.match(/fallback stack\s*[—–-]\s*([^.]+)\./i);
+  if (!m) return null;
+  const families = m[1].split(",").map((f) => f.trim().replace(/^["'“”]|["'“”]$/g, "").trim()).filter((f) => f.length > 0 && f.length < 40 && !/\s{2,}/.test(f));
+  if (families.length < 2) return null;
+  return families;
+}
 function camelCase(slug) {
   return slug.split("-").map((p, i) => i === 0 ? p : p[0].toUpperCase() + p.slice(1)).join("");
 }
@@ -4763,8 +5847,8 @@ function inferFamily(t) {
 
 // src/theme-harness/grade.ts
 init_esm_shims();
-import { appendFileSync as appendFileSync3, readFileSync as readFileSync14, existsSync as existsSync12 } from "fs";
-import { join as join18 } from "path";
+import { appendFileSync as appendFileSync3, readFileSync as readFileSync17, existsSync as existsSync16 } from "fs";
+import { join as join23 } from "path";
 
 // src/theme-harness/gates/slop-blocklist.ts
 init_esm_shims();
@@ -4884,14 +5968,14 @@ function runSourceRules(src, theme, failures) {
   const capsCssRe2 = /letterSpacing:\s*["']?(0?\.\d+)em[\s\S]{0,200}?textTransform:\s*["']uppercase["']/g;
   const fontSizeRe = /fontSize:\s*(\d+)/;
   const capsHits = [];
-  const scanCaps = (re, text) => {
+  const scanCaps = (re, text2) => {
     let m;
-    while ((m = re.exec(text)) !== null) {
+    while ((m = re.exec(text2)) !== null) {
       const spacing = parseFloat(m[1]);
       if (spacing < 0.18) continue;
       const start = Math.max(0, m.index - 240);
-      const end = Math.min(text.length, m.index + m[0].length + 240);
-      const window = text.slice(start, end);
+      const end = Math.min(text2.length, m.index + m[0].length + 240);
+      const window = text2.slice(start, end);
       const fs = window.match(fontSizeRe);
       const fontSize = fs ? parseInt(fs[1], 10) : 12;
       if (fontSize < 20) capsHits.push(`${m[1]}em @ ~${fontSize}px`);
@@ -5026,8 +6110,8 @@ function normalizeFont(f) {
 
 // src/theme-harness/gates/avoid-rubric.ts
 init_esm_shims();
-import { readFileSync as readFileSync10, existsSync as existsSync8 } from "fs";
-import { join as join14 } from "path";
+import { readFileSync as readFileSync13, existsSync as existsSync12 } from "fs";
+import { join as join19 } from "path";
 import Anthropic4 from "@anthropic-ai/sdk";
 var RUBRIC_TOOL = {
   name: "report_verdict",
@@ -5141,25 +6225,25 @@ async function runAvoidRubric(theme, themeDir) {
   return { passed: failures.length === 0, failures };
 }
 function collectEvidence(themeDir) {
-  const readOr = (p) => existsSync8(p) ? readFileSync10(p, "utf8") : "<file not present>";
+  const readOr = (p) => existsSync12(p) ? readFileSync13(p, "utf8") : "<file not present>";
   return {
-    themeMd: readOr(join14(themeDir, "THEME.md")),
-    tokensTs: readOr(join14(themeDir, "tokens.ts")),
-    tailwindSnippet: readOr(join14(themeDir, "tailwind.snippet.ts"))
+    themeMd: readOr(join19(themeDir, "THEME.md")),
+    tokensTs: readOr(join19(themeDir, "tokens.ts")),
+    tailwindSnippet: readOr(join19(themeDir, "tailwind.snippet.ts"))
   };
 }
 
 // src/theme-harness/gates/regression-scan.ts
 init_esm_shims();
-import { readFileSync as readFileSync11, existsSync as existsSync9 } from "fs";
-import { join as join15 } from "path";
+import { readFileSync as readFileSync14, existsSync as existsSync13 } from "fs";
+import { join as join20 } from "path";
 function resolveRegressionSet(themeDir) {
-  return join15(themeDir, "..", "..", "site", "design-system", "regression-set.jsonl");
+  return join20(themeDir, "..", "..", "site", "design-system", "regression-set.jsonl");
 }
 function loadRegressionRules(themeDir) {
   const p = resolveRegressionSet(themeDir);
-  if (!existsSync9(p)) return [];
-  const raw = readFileSync11(p, "utf8").trim();
+  if (!existsSync13(p)) return [];
+  const raw = readFileSync14(p, "utf8").trim();
   if (!raw) return [];
   const rules = [];
   for (const line of raw.split("\n")) {
@@ -5175,9 +6259,9 @@ function loadRegressionRules(themeDir) {
 function runRegressionScan(theme, themeDir) {
   const rules = loadRegressionRules(themeDir);
   if (rules.length === 0) return { passed: true, failures: [] };
-  const tokensSrc = safeRead(join15(themeDir, "tokens.ts"));
-  const twSrc = safeRead(join15(themeDir, "tailwind.snippet.ts"));
-  const themeMdSrc = safeRead(join15(themeDir, "THEME.md"));
+  const tokensSrc = safeRead(join20(themeDir, "tokens.ts"));
+  const twSrc = safeRead(join20(themeDir, "tailwind.snippet.ts"));
+  const themeMdSrc = safeRead(join20(themeDir, "THEME.md"));
   const combined = tokensSrc + "\n" + twSrc;
   const failures = [];
   for (const rule2 of rules) {
@@ -5233,7 +6317,7 @@ function checkRule(rule2, theme, materializedCode, themeMdSrc) {
   return null;
 }
 function safeRead(p) {
-  return existsSync9(p) ? readFileSync11(p, "utf8") : "";
+  return existsSync13(p) ? readFileSync14(p, "utf8") : "";
 }
 function hexToRgb2(hex) {
   const m = hex.match(/^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i);
@@ -5249,9 +6333,9 @@ function rgbDistance2(a, b) {
 
 // src/theme-harness/gates/anchor-compare.ts
 init_esm_shims();
-import { existsSync as existsSync10, readFileSync as readFileSync12 } from "fs";
-import { execSync as execSync4 } from "child_process";
-import { join as join16 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync15 } from "fs";
+import { execSync as execSync5 } from "child_process";
+import { join as join21 } from "path";
 import Anthropic5 from "@anthropic-ai/sdk";
 var RUBRIC_TOOL2 = {
   name: "report_anchor_verdict",
@@ -5318,16 +6402,16 @@ async function runAnchorCompare(theme, themeDir, repoRoot) {
       skipped: `Family ${family} has no golden-set anchor yet \u2014 anchor-compare skipped (per Matt's Path B decision, families A+G bootstrap from their own first-authored theme).`
     };
   }
-  const familyDir = join16(repoRoot, "site", "design-system", "golden-set", family);
-  const rubricPath = join16(familyDir, "rubric.md");
-  if (!existsSync10(rubricPath)) {
+  const familyDir = join21(repoRoot, "site", "design-system", "golden-set", family);
+  const rubricPath = join21(familyDir, "rubric.md");
+  if (!existsSync14(rubricPath)) {
     return {
       passed: true,
       failures: [],
       skipped: `Family ${family} rubric.md missing at ${rubricPath} \u2014 anchor-compare skipped.`
     };
   }
-  const rubric = readFileSync12(rubricPath, "utf8");
+  const rubric = readFileSync15(rubricPath, "utf8");
   const anchorPngs = findAnchorPngs(familyDir);
   if (anchorPngs.length === 0) {
     return {
@@ -5343,7 +6427,7 @@ async function runAnchorCompare(theme, themeDir, repoRoot) {
       skipped: `theme.yml has no render_url \u2014 anchor-compare skipped. Add render_url to enable.`
     };
   }
-  const renderPath = join16(themeDir, ".anchor-render.png");
+  const renderPath = join21(themeDir, ".anchor-render.png");
   try {
     captureRender(theme.render_url, renderPath);
   } catch (e) {
@@ -5353,7 +6437,7 @@ async function runAnchorCompare(theme, themeDir, repoRoot) {
       skipped: `Render capture failed: ${e.message}. Verify dev server is running at ${theme.render_url}. Gate skipped.`
     };
   }
-  if (!existsSync10(renderPath)) {
+  if (!existsSync14(renderPath)) {
     return {
       passed: true,
       failures: [],
@@ -5374,7 +6458,7 @@ async function runAnchorCompare(theme, themeDir, repoRoot) {
     source: {
       type: "base64",
       media_type: "image/png",
-      data: readFileSync12(p).toString("base64")
+      data: readFileSync15(p).toString("base64")
     }
   }));
   const renderBlock = {
@@ -5382,7 +6466,7 @@ async function runAnchorCompare(theme, themeDir, repoRoot) {
     source: {
       type: "base64",
       media_type: "image/png",
-      data: readFileSync12(renderPath).toString("base64")
+      data: readFileSync15(renderPath).toString("base64")
     }
   };
   const userContent = [
@@ -5466,20 +6550,20 @@ Grade the render against each rubric axis. Return via report_anchor_verdict.`
   return { passed: failures.length === 0, failures };
 }
 function findAnchorPngs(familyDir) {
-  if (!existsSync10(familyDir)) return [];
-  const dirents = execSync4(`ls -1 "${familyDir}" 2>/dev/null`).toString().split("\n").filter(Boolean);
-  return dirents.filter((n) => /^[0-9]+-[a-z0-9-]+\.png$/.test(n)).map((n) => join16(familyDir, n));
+  if (!existsSync14(familyDir)) return [];
+  const dirents = execSync5(`ls -1 "${familyDir}" 2>/dev/null`).toString().split("\n").filter(Boolean);
+  return dirents.filter((n) => /^[0-9]+-[a-z0-9-]+\.png$/.test(n)).map((n) => join21(familyDir, n));
 }
 function captureRender(url, outPath) {
-  const chromeCandidates = [
+  const chromeCandidates2 = [
     "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
     "/Applications/Chromium.app/Contents/MacOS/Chromium",
     "google-chrome",
     "chromium"
   ];
-  for (const c2 of chromeCandidates) {
+  for (const c2 of chromeCandidates2) {
     try {
-      execSync4(`"${c2}" --headless --disable-gpu --hide-scrollbars --screenshot="${outPath}" --window-size=1440,1600 "${url}"`, {
+      execSync5(`"${c2}" --headless --disable-gpu --hide-scrollbars --screenshot="${outPath}" --window-size=1440,1600 "${url}"`, {
         stdio: ["ignore", "ignore", "ignore"],
         timeout: 3e4
       });
@@ -5488,13 +6572,13 @@ function captureRender(url, outPath) {
       continue;
     }
   }
-  throw new Error(`No headless Chrome found. Tried: ${chromeCandidates.join(", ")}`);
+  throw new Error(`No headless Chrome found. Tried: ${chromeCandidates2.join(", ")}`);
 }
 
 // src/theme-harness/dismiss.ts
 init_esm_shims();
-import { existsSync as existsSync11, readFileSync as readFileSync13, writeFileSync as writeFileSync8, appendFileSync as appendFileSync2 } from "fs";
-import { join as join17 } from "path";
+import { existsSync as existsSync15, readFileSync as readFileSync16, writeFileSync as writeFileSync8, appendFileSync as appendFileSync2 } from "fs";
+import { join as join22 } from "path";
 var DISMISSALS_FILE = "dismissals.jsonl";
 function writeDismissal(themeDir, finding_id, reason, scope, now) {
   const d = {
@@ -5504,18 +6588,18 @@ function writeDismissal(themeDir, finding_id, reason, scope, now) {
     dismissed_at: now,
     applied: false
   };
-  appendFileSync2(join17(themeDir, DISMISSALS_FILE), JSON.stringify(d) + "\n");
+  appendFileSync2(join22(themeDir, DISMISSALS_FILE), JSON.stringify(d) + "\n");
   return d;
 }
 function loadDismissals(themeDir) {
-  const p = join17(themeDir, DISMISSALS_FILE);
-  if (!existsSync11(p)) return [];
-  const raw = readFileSync13(p, "utf8").trim();
+  const p = join22(themeDir, DISMISSALS_FILE);
+  if (!existsSync15(p)) return [];
+  const raw = readFileSync16(p, "utf8").trim();
   if (!raw) return [];
   return raw.split("\n").filter(Boolean).map((line) => JSON.parse(line));
 }
 function persistDismissals(themeDir, ds) {
-  const p = join17(themeDir, DISMISSALS_FILE);
+  const p = join22(themeDir, DISMISSALS_FILE);
   const body = ds.map((d) => JSON.stringify(d)).join("\n") + (ds.length ? "\n" : "");
   writeFileSync8(p, body);
 }
@@ -5537,7 +6621,7 @@ function claimDismissal(ds, finding_id, runTimestamp) {
 
 // src/theme-harness/grade.ts
 async function gradeTheme(slug, themeDir, now, repoRoot = process.cwd()) {
-  const ymlPath = join18(themeDir, "theme.yml");
+  const ymlPath = join23(themeDir, "theme.yml");
   const parsed = loadTheme(ymlPath);
   if (!parsed.ok) return { error: parsed.errors };
   const theme = parsed.theme;
@@ -5595,18 +6679,18 @@ async function gradeTheme(slug, themeDir, now, repoRoot = process.cwd()) {
   }
   const overall = gates.some((g) => !g.verdict.passed) ? "BLOCK" : "PASS";
   const report = { slug, gates, overall, ran_at: now };
-  const logPath = join18(themeDir, "audit.log.jsonl");
+  const logPath = join23(themeDir, "audit.log.jsonl");
   appendFileSync3(logPath, JSON.stringify(report) + "\n");
   if (dismissalsMutated) persistDismissals(themeDir, dismissals);
   return report;
 }
 function readSectionSource(slug, repoRoot) {
   const candidates = [
-    join18(repoRoot, "site", "src", "components", "sections", `${slug}.tsx`),
-    join18(repoRoot, "src", "components", "sections", `${slug}.tsx`)
+    join23(repoRoot, "site", "src", "components", "sections", `${slug}.tsx`),
+    join23(repoRoot, "src", "components", "sections", `${slug}.tsx`)
   ];
   for (const p of candidates) {
-    if (existsSync12(p)) return readFileSync14(p, "utf8");
+    if (existsSync16(p)) return readFileSync17(p, "utf8");
   }
   return void 0;
 }
@@ -5680,15 +6764,15 @@ function formatReport(r) {
 
 // src/theme-harness/promote.ts
 init_esm_shims();
-import { readFileSync as readFileSync15, writeFileSync as writeFileSync9, existsSync as existsSync13, appendFileSync as appendFileSync4 } from "fs";
-import { join as join19 } from "path";
+import { readFileSync as readFileSync18, writeFileSync as writeFileSync9, existsSync as existsSync17, appendFileSync as appendFileSync4 } from "fs";
+import { join as join24 } from "path";
 function regressionSetPath(themeDir) {
-  return join19(themeDir, "..", "..", "site", "design-system", "regression-set.jsonl");
+  return join24(themeDir, "..", "..", "site", "design-system", "regression-set.jsonl");
 }
 function nextRegressionId(themeDir) {
   const p = regressionSetPath(themeDir);
-  if (!existsSync13(p)) return "REG-0001";
-  const raw = readFileSync15(p, "utf8");
+  if (!existsSync17(p)) return "REG-0001";
+  const raw = readFileSync18(p, "utf8");
   let max = 0;
   for (const line of raw.split("\n")) {
     const m = line.match(/"id":\s*"REG-(\d+)"/);
@@ -5710,7 +6794,7 @@ function promoteToRegression(themeDir, input3) {
     scope: "global"
   };
   const p = regressionSetPath(themeDir);
-  if (!existsSync13(p)) {
+  if (!existsSync17(p)) {
     writeFileSync9(p, "// Regression matchers \u2014 permanent lessons from caught defects.\n// One JSON object per line. See site/design-system/HARNESS_DESIGN.md.\n");
   }
   appendFileSync4(p, JSON.stringify(rule2) + "\n");
@@ -5719,8 +6803,8 @@ function promoteToRegression(themeDir, input3) {
 
 // src/theme-harness/waivers.ts
 init_esm_shims();
-import { existsSync as existsSync14, mkdirSync as mkdirSync7, readFileSync as readFileSync16, readdirSync as readdirSync3, statSync as statSync4, writeFileSync as writeFileSync10 } from "fs";
-import { join as join20, relative as relative5 } from "path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync8, readFileSync as readFileSync19, readdirSync as readdirSync4, statSync as statSync4, writeFileSync as writeFileSync10 } from "fs";
+import { join as join25, relative as relative5 } from "path";
 var SKIP_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
@@ -5735,9 +6819,9 @@ var SKIP_DIRS = /* @__PURE__ */ new Set([
 ]);
 var CODE_SUFFIXES = /\.(?:tsx?|jsx?|mjs|cjs|css|scss|md|ya?ml)$/;
 function walk2(root, acc) {
-  for (const entry of readdirSync3(root)) {
+  for (const entry of readdirSync4(root)) {
     if (SKIP_DIRS.has(entry) || entry.startsWith(".")) continue;
-    const full = join20(root, entry);
+    const full = join25(root, entry);
     let st;
     try {
       st = statSync4(full);
@@ -5775,7 +6859,7 @@ function collectWaivers(target) {
   for (const abs of files) {
     let body;
     try {
-      body = readFileSync16(abs, "utf8");
+      body = readFileSync19(abs, "utf8");
     } catch {
       continue;
     }
@@ -5816,15 +6900,15 @@ function formatWaiverDigest(waivers, today) {
   return lines.join("\n") + "\n";
 }
 function writeDigest(target, waivers, today) {
-  const dir = join20(target, "reports");
-  if (!existsSync14(dir)) {
+  const dir = join25(target, "reports");
+  if (!existsSync18(dir)) {
     if (waivers.length === 0) return null;
-    mkdirSync7(dir, { recursive: true });
+    mkdirSync8(dir, { recursive: true });
   }
   const digest = formatWaiverDigest(waivers, today);
-  const outPath = join20(dir, `qa-waivers-${today}.md`);
+  const outPath = join25(dir, `qa-waivers-${today}.md`);
   writeFileSync10(outPath, digest);
-  writeFileSync10(join20(dir, "qa-waivers-latest.md"), digest);
+  writeFileSync10(join25(dir, "qa-waivers-latest.md"), digest);
   return outPath;
 }
 
@@ -5841,30 +6925,30 @@ function registerHarnessCommand(program2) {
   const harness = program2.command("harness").description("v2 theme-authoring harness \u2014 materialize + grade + (later) dismiss.");
   harness.command("materialize <slug>").description("Read themes/<slug>/theme.yml \u2192 write THEME.md + tokens.ts + tailwind.snippet.ts.").option("--themes-dir <path>", "Root directory containing per-theme folders", DEFAULT_THEMES_DIR).action((slug, opts) => {
     const dir = resolveThemeDir(slug, opts);
-    if (!existsSync15(join21(dir, "theme.yml"))) {
-      console.error(import_picocolors10.default.red(`\u2717 No theme.yml at ${join21(dir, "theme.yml")}`));
+    if (!existsSync19(join26(dir, "theme.yml"))) {
+      console.error(import_picocolors11.default.red(`\u2717 No theme.yml at ${join26(dir, "theme.yml")}`));
       process.exit(1);
     }
     const result = materializeTheme(slug, dir);
     if (!result.ok) {
-      console.error(import_picocolors10.default.red(`\u2717 theme.yml validation failed:`));
-      for (const e of result.errors) console.error(import_picocolors10.default.red(`  \xB7 ${e}`));
+      console.error(import_picocolors11.default.red(`\u2717 theme.yml validation failed:`));
+      for (const e of result.errors) console.error(import_picocolors11.default.red(`  \xB7 ${e}`));
       process.exit(1);
     }
-    console.log(import_picocolors10.default.green(`\u2713 Materialized ${slug}:`));
+    console.log(import_picocolors11.default.green(`\u2713 Materialized ${slug}:`));
     for (const f of result.wrote) console.log(`  \xB7 ${f}`);
   });
   harness.command("grade <slug>").description("Run harness gates against themes/<slug>. Appends audit.log.jsonl and exits 1 on BLOCK.").option("--themes-dir <path>", "Root directory containing per-theme folders", DEFAULT_THEMES_DIR).action(async (slug, opts) => {
     const dir = resolveThemeDir(slug, opts);
-    if (!existsSync15(join21(dir, "theme.yml"))) {
-      console.error(import_picocolors10.default.red(`\u2717 No theme.yml at ${join21(dir, "theme.yml")}`));
+    if (!existsSync19(join26(dir, "theme.yml"))) {
+      console.error(import_picocolors11.default.red(`\u2717 No theme.yml at ${join26(dir, "theme.yml")}`));
       process.exit(1);
     }
     const repoRoot = resolve13(opts.themesDir ?? DEFAULT_THEMES_DIR, "..");
     const report = await gradeTheme(slug, dir, isoNow(), repoRoot);
     if ("error" in report) {
-      console.error(import_picocolors10.default.red(`\u2717 theme.yml validation failed:`));
-      for (const e of report.error) console.error(import_picocolors10.default.red(`  \xB7 ${e}`));
+      console.error(import_picocolors11.default.red(`\u2717 theme.yml validation failed:`));
+      for (const e of report.error) console.error(import_picocolors11.default.red(`  \xB7 ${e}`));
       process.exit(1);
     }
     console.log(formatReport(report));
@@ -5874,14 +6958,14 @@ function registerHarnessCommand(program2) {
     "Turn a caught defect into a permanent regression matcher \u2014 appends to site/design-system/regression-set.jsonl. Rules are tracked in git so the whole team inherits the lesson."
   ).requiredOption("--matcher-type <type>", "hex_distance | class_pattern | inline_style").requiredOption("--target <value>", "For hex_distance: a hex color like #D97757. For class_pattern / inline_style: a regex.").option("--threshold <n>", "For hex_distance: RGB distance threshold (default: 12).", "12").requiredOption("-r, --reason <text>", "Human-readable explanation of the defect and why it's a permanent rule.").option("--themes-dir <path>", "Root directory containing per-theme folders", DEFAULT_THEMES_DIR).action((slug, opts) => {
     const dir = resolveThemeDir(slug, opts);
-    if (!existsSync15(join21(dir, "theme.yml"))) {
-      console.error(import_picocolors10.default.red(`\u2717 No theme.yml at ${join21(dir, "theme.yml")}`));
+    if (!existsSync19(join26(dir, "theme.yml"))) {
+      console.error(import_picocolors11.default.red(`\u2717 No theme.yml at ${join26(dir, "theme.yml")}`));
       process.exit(1);
     }
     let matcher;
     if (opts.matcherType === "hex_distance") {
       if (!/^#[0-9A-Fa-f]{6}$/.test(opts.target)) {
-        console.error(import_picocolors10.default.red(`\u2717 --target must be a 6-digit hex for hex_distance matcher, got: ${opts.target}`));
+        console.error(import_picocolors11.default.red(`\u2717 --target must be a 6-digit hex for hex_distance matcher, got: ${opts.target}`));
         process.exit(1);
       }
       matcher = { type: "hex_distance", target: opts.target, threshold: parseInt(opts.threshold, 10) };
@@ -5890,7 +6974,7 @@ function registerHarnessCommand(program2) {
     } else if (opts.matcherType === "inline_style") {
       matcher = { type: "inline_style", pattern: opts.target };
     } else {
-      console.error(import_picocolors10.default.red(`\u2717 --matcher-type must be hex_distance | class_pattern | inline_style, got: ${opts.matcherType}`));
+      console.error(import_picocolors11.default.red(`\u2717 --matcher-type must be hex_distance | class_pattern | inline_style, got: ${opts.matcherType}`));
       process.exit(1);
     }
     const rule2 = promoteToRegression(dir, {
@@ -5900,30 +6984,30 @@ function registerHarnessCommand(program2) {
       matcher,
       now: isoNow()
     });
-    console.log(import_picocolors10.default.green(`\u2713 Promoted to regression-set as ${rule2.id}`));
+    console.log(import_picocolors11.default.green(`\u2713 Promoted to regression-set as ${rule2.id}`));
     console.log(`  matcher: ${JSON.stringify(matcher)}`);
     console.log(`  reason: ${rule2.reason}`);
-    console.log(import_picocolors10.default.dim(`  Rule now runs against every future grade. Delete from regression-set.jsonl to reverse.`));
+    console.log(import_picocolors11.default.dim(`  Rule now runs against every future grade. Delete from regression-set.jsonl to reverse.`));
   });
   harness.command("dismiss <slug> <finding-id>").description(
     "Dismiss a finding from the theme's next grade run (this_run) or permanently for this theme (this_theme). Default scope: this_run \u2014 dismissal applies once, then is consumed. Nothing regresses silently."
   ).requiredOption("-r, --reason <text>", "Why this finding is not a real defect. Persisted to dismissals.jsonl and shown in every future run's report.").option("-s, --scope <scope>", "this_run | this_theme (default: this_run)", "this_run").option("--themes-dir <path>", "Root directory containing per-theme folders", DEFAULT_THEMES_DIR).action((slug, findingId, opts) => {
     const dir = resolveThemeDir(slug, opts);
-    if (!existsSync15(join21(dir, "theme.yml"))) {
-      console.error(import_picocolors10.default.red(`\u2717 No theme.yml at ${join21(dir, "theme.yml")}`));
+    if (!existsSync19(join26(dir, "theme.yml"))) {
+      console.error(import_picocolors11.default.red(`\u2717 No theme.yml at ${join26(dir, "theme.yml")}`));
       process.exit(1);
     }
     if (opts.scope !== "this_run" && opts.scope !== "this_theme") {
-      console.error(import_picocolors10.default.red(`\u2717 --scope must be "this_run" or "this_theme", got: ${opts.scope}`));
+      console.error(import_picocolors11.default.red(`\u2717 --scope must be "this_run" or "this_theme", got: ${opts.scope}`));
       process.exit(1);
     }
     const d = writeDismissal(dir, findingId, opts.reason, opts.scope, isoNow());
-    console.log(import_picocolors10.default.green(`\u2713 Dismissed ${findingId} for ${slug} (scope: ${d.scope})`));
+    console.log(import_picocolors11.default.green(`\u2713 Dismissed ${findingId} for ${slug} (scope: ${d.scope})`));
     console.log(`  reason: ${d.reason}`);
     if (d.scope === "this_run") {
-      console.log(import_picocolors10.default.dim(`  Applies to the next grade run only. If ${findingId} fires again after that, it will BLOCK.`));
+      console.log(import_picocolors11.default.dim(`  Applies to the next grade run only. If ${findingId} fires again after that, it will BLOCK.`));
     } else {
-      console.log(import_picocolors10.default.dim(`  Applies to every future grade run for this theme. Delete the entry from dismissals.jsonl to reverse.`));
+      console.log(import_picocolors11.default.dim(`  Applies to every future grade run for this theme. Delete the entry from dismissals.jsonl to reverse.`));
     }
   });
   harness.command("waivers").description(
@@ -5933,10 +7017,10 @@ function registerHarnessCommand(program2) {
     const waivers = collectWaivers(target);
     const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
     if (waivers.length === 0) {
-      console.log(import_picocolors10.default.green(`\u2713 No slop-override waivers found in ${target}.`));
+      console.log(import_picocolors11.default.green(`\u2713 No slop-override waivers found in ${target}.`));
       return;
     }
-    console.log(import_picocolors10.default.bold(`\u25C7 Waivers \u2014 ${waivers.length} static override${waivers.length === 1 ? "" : "s"} across the tree`));
+    console.log(import_picocolors11.default.bold(`\u25C7 Waivers \u2014 ${waivers.length} static override${waivers.length === 1 ? "" : "s"} across the tree`));
     console.log("");
     const byRule = /* @__PURE__ */ new Map();
     for (const w of waivers) {
@@ -5944,37 +7028,43 @@ function registerHarnessCommand(program2) {
       byRule.get(w.ruleId).push(w);
     }
     for (const [ruleId, ws] of byRule) {
-      console.log(import_picocolors10.default.yellow(`  ${ruleId}`) + import_picocolors10.default.dim(` \u2014 ${ws.length} waiver${ws.length === 1 ? "" : "s"}`));
+      console.log(import_picocolors11.default.yellow(`  ${ruleId}`) + import_picocolors11.default.dim(` \u2014 ${ws.length} waiver${ws.length === 1 ? "" : "s"}`));
       for (const w of ws.slice(0, 8)) {
-        const scope = w.scope === "file" ? import_picocolors10.default.magenta("[file]") : import_picocolors10.default.cyan("[local]");
-        const reason = w.reason || import_picocolors10.default.dim("(no reason given)");
-        console.log(`    ${scope} ${import_picocolors10.default.cyan(w.file + ":" + w.line)}`);
+        const scope = w.scope === "file" ? import_picocolors11.default.magenta("[file]") : import_picocolors11.default.cyan("[local]");
+        const reason = w.reason || import_picocolors11.default.dim("(no reason given)");
+        console.log(`    ${scope} ${import_picocolors11.default.cyan(w.file + ":" + w.line)}`);
         console.log(`      ${reason}`);
       }
-      if (ws.length > 8) console.log(import_picocolors10.default.dim(`    \u2026 +${ws.length - 8} more`));
+      if (ws.length > 8) console.log(import_picocolors11.default.dim(`    \u2026 +${ws.length - 8} more`));
     }
     console.log("");
     if (opts.write) {
       const path2 = writeDigest(target, waivers, today);
-      if (path2) console.log(import_picocolors10.default.dim(`  Digest written to ${path2.replace(target + "/", "")}`));
+      if (path2) console.log(import_picocolors11.default.dim(`  Digest written to ${path2.replace(target + "/", "")}`));
     }
   });
 }
 
 // src/index.ts
-var import_picocolors11 = __toESM(require_picocolors(), 1);
+var import_picocolors12 = __toESM(require_picocolors(), 1);
 var program = new Command();
 program.name("stylecrib").description(
   "Design upgrade for vibe-coded React apps. Installs 19 Claude Code subagents (craft reviewers, enforcer, exec auditors) + a chosen theme from a 118-theme library into your repo. See https://github.com/frischermf/stylecrib for the mandate."
-).version("0.2.0");
+).version(VERSION);
 program.command("init").description(
   "Interactive wizard: pick a direction, describe references, drop the agents into your repo, and install the enforcement layer (pre-commit hook + .cursorrules + GitHub Action). The hook is what makes the agents actually fire \u2014 installed by default. Pass --no-hooks to skip."
 ).option(
   "-s, --style <direction>",
-  "Skip the wizard, use a canonical direction (editorial | soft-modern | dense-utility)"
+  "Skip the direction picker and use a canonical theme (soft-modern, brutalist, signal-dark, newsletter, \u2026 \u2014 an unknown slug is an error, not a fallback). Run `stylecrib init --help` or browse themes/ for the full list."
 ).option(
   "-y, --yes",
-  "Use defaults wherever possible (still prompts for required inputs)"
+  "Non-interactive: no prompts at all. Takes --style (or soft-modern), the directory name as the project name, and no references \u2014 which keeps the run on the canonical path, so it makes no Anthropic call and needs no API key. Implied when there's no terminal attached."
+).option(
+  "--apply",
+  "Apply staged files without asking. Overwrites tailwind.config.* and src/index.css on a new git branch."
+).option(
+  "--no-apply",
+  "Stage into .design-upgrade/ and stop. Review, then run `stylecrib apply` yourself. This is the default when running non-interactively against a project that already exists."
 ).option(
   "--target <path>",
   "Target project root (defaults to current working directory)"
@@ -5989,7 +7079,7 @@ program.command("init").description(
   "Skip installing @stylecrib/react + scaffolding src/lib/stylecrib-wire.tsx. Default-on: init installs the runtime pack and writes a wire-up file the customer imports into their App.tsx. Opt out for repos that have the runtime wired already."
 ).option(
   "--force-runtime",
-  "Overwrite src/lib/stylecrib-wire.tsx if it exists. Existing content is backed up to `src/lib/stylecrib-wire.tsx.pre-taste.bak` first."
+  "Overwrite src/lib/stylecrib-wire.tsx if it exists. Existing content is backed up to `src/lib/stylecrib-wire.tsx.pre-stylecrib.bak` first."
 ).action(init);
 program.command("apply").description(
   "Apply staged changes from .design-upgrade/ to your project (on a new git branch)."
@@ -6027,6 +7117,27 @@ program.command("install-hooks").description(
 program.command("hook-check", { hidden: true }).description(
   "Internal \u2014 reads Claude Code PostToolUse hook JSON from stdin, forwards to `stylecrib check` on the touched file. Wired by install-hooks. Not intended for direct invocation."
 ).action(hookCheck);
+program.command("verify").description(
+  "Runtime smoke gate \u2014 typecheck the project, then boot its dev server and fetch a route to prove the app still renders. Catches the class of regression a diff-scoped detector cannot see: a sweep that leaves the source looking plausible but the app broken (a type error, a bad import, an empty render). Run it after an AI sweep and before a push \u2014 NOT on every commit, it takes tens of seconds."
+).option(
+  "--target <path>",
+  "Project root (defaults to current working directory)"
+).option(
+  "--no-typecheck",
+  "Skip the typecheck step."
+).option(
+  "--no-boot",
+  "Skip the dev-server boot. Leaves only the typecheck \u2014 useful in CI without a browser."
+).option(
+  "--route <path>",
+  "Route to fetch once the server is up (default: /)"
+).option(
+  "--screenshot <file>",
+  "Also capture a headless-Chrome screenshot of the route to this path."
+).option(
+  "--timeout <ms>",
+  "How long to wait for the dev server to announce a URL (default: 60000)"
+).action(verify);
 program.command("status").description(
   "Print which enforcement layers are active in this repo. Verifies the hook is installed + executable + wired, agents are present, .cursorrules exists, GH Action wired, feedback memory initialized, THEME.md present, and ANTHROPIC_API_KEY set. Use any time to confirm the loop will actually fire."
 ).option(
@@ -6057,12 +7168,15 @@ program.command("reject").description(
     target: opts.target
   });
 });
+program.command("mcp").description(
+  "Run StyleCrib as an MCP server over stdio, so Cursor, Windsurf, Claude Desktop, Zed, or any other MCP client can list themes, fetch a theme's brief, generate its Tailwind tokens, read the rule catalog, and run the slop detectors on a file \u2014 without Claude Code or the pre-commit hook. Point your client's MCP config at `npx -y @stylecrib/cli mcp`."
+).action(mcp);
 registerHarnessCommand(program);
 program.parseAsync(process.argv).catch((err) => {
   console.error("");
-  console.error(import_picocolors11.default.red("\u2717 ") + (err instanceof Error ? err.message : String(err)));
+  console.error(import_picocolors12.default.red("\u2717 ") + (err instanceof Error ? err.message : String(err)));
   if (err instanceof Error && err.cause) {
-    console.error(import_picocolors11.default.dim("  caused by: " + String(err.cause)));
+    console.error(import_picocolors12.default.dim("  caused by: " + String(err.cause)));
   }
   process.exit(1);
 });