@decantr/cli 1.0.0 → 1.1.1

package/dist/index.js

@@ -1,1965 +1,3 @@
-#!/usr/bin/env node
-import {
-  RegistryClient,
-  syncRegistry
-} from "./chunk-PWTUBGGJ.js";
-import {
-  __require
-} from "./chunk-PDX44BCA.js";
-
-// src/index.ts
-import { readFileSync as readFileSync4, existsSync as existsSync4 } from "fs";
-import { join as join4 } from "path";
-import { validateEssence, evaluateGuard } from "@decantr/essence-spec";
-import { createResolver, createRegistryClient } from "@decantr/registry";
-
-// src/detect.ts
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-var RULE_FILES = [
-  "CLAUDE.md",
-  ".cursorrules",
-  ".cursor/rules",
-  "AGENTS.md",
-  "GEMINI.md",
-  "copilot-instructions.md"
-];
-function detectProject(projectRoot = process.cwd()) {
-  const result = {
-    framework: "unknown",
-    packageManager: "unknown",
-    hasTypeScript: false,
-    hasTailwind: false,
-    existingRuleFiles: [],
-    existingEssence: false,
-    projectRoot
-  };
-  result.existingEssence = existsSync(join(projectRoot, "decantr.essence.json"));
-  for (const ruleFile of RULE_FILES) {
-    if (existsSync(join(projectRoot, ruleFile))) {
-      result.existingRuleFiles.push(ruleFile);
-    }
-  }
-  if (existsSync(join(projectRoot, "pnpm-lock.yaml"))) {
-    result.packageManager = "pnpm";
-  } else if (existsSync(join(projectRoot, "yarn.lock"))) {
-    result.packageManager = "yarn";
-  } else if (existsSync(join(projectRoot, "bun.lockb"))) {
-    result.packageManager = "bun";
-  } else if (existsSync(join(projectRoot, "package-lock.json"))) {
-    result.packageManager = "npm";
-  }
-  result.hasTypeScript = existsSync(join(projectRoot, "tsconfig.json"));
-  result.hasTailwind = existsSync(join(projectRoot, "tailwind.config.js")) || existsSync(join(projectRoot, "tailwind.config.ts")) || existsSync(join(projectRoot, "tailwind.config.mjs")) || existsSync(join(projectRoot, "tailwind.config.cjs"));
-  if (existsSync(join(projectRoot, "next.config.js")) || existsSync(join(projectRoot, "next.config.ts")) || existsSync(join(projectRoot, "next.config.mjs"))) {
-    result.framework = "nextjs";
-    result.version = getPackageVersion(projectRoot, "next");
-    return result;
-  }
-  if (existsSync(join(projectRoot, "nuxt.config.js")) || existsSync(join(projectRoot, "nuxt.config.ts"))) {
-    result.framework = "nuxt";
-    result.version = getPackageVersion(projectRoot, "nuxt");
-    return result;
-  }
-  if (existsSync(join(projectRoot, "astro.config.mjs")) || existsSync(join(projectRoot, "astro.config.ts"))) {
-    result.framework = "astro";
-    result.version = getPackageVersion(projectRoot, "astro");
-    return result;
-  }
-  if (existsSync(join(projectRoot, "svelte.config.js")) || existsSync(join(projectRoot, "svelte.config.ts"))) {
-    result.framework = "svelte";
-    result.version = getPackageVersion(projectRoot, "svelte");
-    return result;
-  }
-  if (existsSync(join(projectRoot, "angular.json"))) {
-    result.framework = "angular";
-    result.version = getPackageVersion(projectRoot, "@angular/core");
-    return result;
-  }
-  const packageJsonPath = join(projectRoot, "package.json");
-  if (existsSync(packageJsonPath)) {
-    try {
-      const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-      const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
-      if (deps.next) {
-        result.framework = "nextjs";
-        result.version = deps.next.replace(/^\^|~/, "");
-      } else if (deps.nuxt) {
-        result.framework = "nuxt";
-        result.version = deps.nuxt.replace(/^\^|~/, "");
-      } else if (deps.astro) {
-        result.framework = "astro";
-        result.version = deps.astro.replace(/^\^|~/, "");
-      } else if (deps.svelte) {
-        result.framework = "svelte";
-        result.version = deps.svelte.replace(/^\^|~/, "");
-      } else if (deps["@angular/core"]) {
-        result.framework = "angular";
-        result.version = deps["@angular/core"].replace(/^\^|~/, "");
-      } else if (deps.vue) {
-        result.framework = "vue";
-        result.version = deps.vue.replace(/^\^|~/, "");
-      } else if (deps.react) {
-        result.framework = "react";
-        result.version = deps.react.replace(/^\^|~/, "");
-      }
-    } catch {
-    }
-  }
-  if (result.framework === "unknown" && !existsSync(packageJsonPath)) {
-    if (existsSync(join(projectRoot, "index.html"))) {
-      result.framework = "html";
-    }
-  }
-  return result;
-}
-function getPackageVersion(projectRoot, packageName) {
-  const packageJsonPath = join(projectRoot, "package.json");
-  if (!existsSync(packageJsonPath)) return void 0;
-  try {
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-    const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
-    const version = deps[packageName];
-    return version?.replace(/^\^|~/, "");
-  } catch {
-    return void 0;
-  }
-}
-
-// src/prompts.ts
-import { createInterface } from "readline";
-var BOLD = "\x1B[1m";
-var DIM = "\x1B[2m";
-var RESET = "\x1B[0m";
-var GREEN = "\x1B[32m";
-var YELLOW = "\x1B[33m";
-var CYAN = "\x1B[36m";
-function ask(question, defaultValue) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const prompt = defaultValue ? `${question} ${DIM}(${defaultValue})${RESET}: ` : `${question}: `;
-  return new Promise((resolve) => {
-    rl.question(prompt, (answer) => {
-      rl.close();
-      resolve(answer.trim() || defaultValue || "");
-    });
-  });
-}
-async function select(question, options, defaultIdx = 0, allowOther = false) {
-  console.log(`
-${BOLD}${question}${RESET}`);
-  for (let i = 0; i < options.length; i++) {
-    const marker = i === defaultIdx ? `${GREEN}>${RESET}` : " ";
-    const desc = options[i].description ? ` ${DIM}\u2014 ${options[i].description}${RESET}` : "";
-    console.log(`  ${marker} ${i + 1}. ${options[i].label}${desc}`);
-  }
-  if (allowOther) {
-    console.log(`    ${options.length + 1}. ${DIM}other (enter custom value)${RESET}`);
-  }
-  const maxIdx = allowOther ? options.length + 1 : options.length;
-  const answer = await ask(`Choose (1-${maxIdx})`, String(defaultIdx + 1));
-  const idx = parseInt(answer, 10) - 1;
-  if (allowOther && idx === options.length) {
-    const custom = await ask("Enter custom value");
-    return custom;
-  }
-  const validIdx = Math.max(0, Math.min(idx, options.length - 1));
-  return options[validIdx].value;
-}
-async function confirm(question, defaultYes = true) {
-  const hint = defaultYes ? "Y/n" : "y/N";
-  const answer = await ask(`${question} [${hint}]`, defaultYes ? "y" : "n");
-  return answer.toLowerCase() === "y" || answer.toLowerCase() === "yes";
-}
-function warn(message) {
-  console.log(`
-${YELLOW}  Warning: ${message}${RESET}`);
-}
-function showDetection(detected) {
-  console.log(`
-${CYAN}Detected project configuration:${RESET}`);
-  if (detected.framework !== "unknown") {
-    const version = detected.version ? ` ${detected.version}` : "";
-    console.log(`  Framework: ${detected.framework}${version}`);
-  }
-  if (detected.packageManager !== "unknown") {
-    console.log(`  Package manager: ${detected.packageManager}`);
-  }
-  if (detected.hasTypeScript) {
-    console.log(`  TypeScript: ${GREEN}yes${RESET}`);
-  }
-  if (detected.hasTailwind) {
-    console.log(`  Tailwind CSS: ${GREEN}yes${RESET}`);
-  }
-  if (detected.existingEssence) {
-    console.log(`  Existing essence: ${YELLOW}yes${RESET}`);
-  }
-}
-async function runInteractivePrompts(detected, archetypes, blueprints, themes) {
-  showDetection(detected);
-  const blueprintOptions = [
-    { value: "none", label: "none", description: "Start from scratch (blank canvas)" },
-    ...blueprints.map((b) => ({
-      value: b.id,
-      label: b.id,
-      description: b.description
-    }))
-  ];
-  const blueprint = await select("What are you building?", blueprintOptions, 0, true);
-  const isBlank = blueprint === "none";
-  const themeOptions = themes.map((t) => ({
-    value: t.id,
-    label: t.id,
-    description: t.description
-  }));
-  const defaultThemeIdx = themeOptions.findIndex((t) => t.value === "luminarum") || 0;
-  const theme = await select("Choose a theme", themeOptions, Math.max(0, defaultThemeIdx), true);
-  const mode = await select(
-    "Color mode",
-    [
-      { value: "dark", label: "dark", description: "Dark background" },
-      { value: "light", label: "light", description: "Light background" },
-      { value: "auto", label: "auto", description: "Follow system preference" }
-    ],
-    0
-  );
-  const shape = await select(
-    "Border shape",
-    [
-      { value: "pill", label: "pill", description: "Fully rounded corners" },
-      { value: "rounded", label: "rounded", description: "Moderately rounded" },
-      { value: "sharp", label: "sharp", description: "No border radius" }
-    ],
-    0,
-    true
-  );
-  const frameworkOptions = [
-    { value: "react", label: "react", description: "React / Create React App" },
-    { value: "nextjs", label: "nextjs", description: "Next.js" },
-    { value: "vue", label: "vue", description: "Vue.js" },
-    { value: "nuxt", label: "nuxt", description: "Nuxt" },
-    { value: "svelte", label: "svelte", description: "Svelte / SvelteKit" },
-    { value: "astro", label: "astro", description: "Astro" },
-    { value: "angular", label: "angular", description: "Angular" },
-    { value: "html", label: "html", description: "Plain HTML/CSS/JS" }
-  ];
-  let defaultFrameworkIdx = frameworkOptions.findIndex((f) => f.value === detected.framework);
-  if (defaultFrameworkIdx < 0) defaultFrameworkIdx = 0;
-  const target = await select("Target framework", frameworkOptions, defaultFrameworkIdx, true);
-  if (detected.framework !== "unknown" && target !== detected.framework) {
-    warn(`This project appears to be ${detected.framework} but you selected ${target}.`);
-    const proceed = await confirm("Continue anyway?", false);
-    if (!proceed) {
-      console.log(`${DIM}Using detected framework: ${detected.framework}${RESET}`);
-    }
-  }
-  const guardMode = await select(
-    "Guard enforcement level",
-    [
-      { value: "creative", label: "creative", description: "Advisory only (new projects)" },
-      { value: "guided", label: "guided", description: "Style, structure, recipe enforced" },
-      { value: "strict", label: "strict", description: "All 5 rules enforced exactly" }
-    ],
-    detected.existingEssence ? 1 : 2
-    // Default to guided for existing, strict for new
-  );
-  const density = await select(
-    "Spacing density",
-    [
-      { value: "compact", label: "compact", description: "Dense UI, minimal spacing" },
-      { value: "comfortable", label: "comfortable", description: "Balanced spacing" },
-      { value: "spacious", label: "spacious", description: "Generous whitespace" }
-    ],
-    1
-  );
-  const shellOptions = [
-    { value: "sidebar-main", label: "sidebar-main", description: "Collapsible sidebar with main content" },
-    { value: "top-nav-main", label: "top-nav-main", description: "Horizontal nav with full-width content" },
-    { value: "centered", label: "centered", description: "Centered card (auth flows)" },
-    { value: "full-bleed", label: "full-bleed", description: "No persistent nav (landing pages)" },
-    { value: "minimal-header", label: "minimal-header", description: "Slim header with centered content" }
-  ];
-  let defaultShellIdx = 0;
-  if (["nextjs", "nuxt", "astro"].includes(target)) {
-    defaultShellIdx = shellOptions.findIndex((s) => s.value === "top-nav-main");
-  }
-  const shell = await select("Default page shell (layout)", shellOptions, Math.max(0, defaultShellIdx), true);
-  return {
-    blueprint: isBlank ? void 0 : blueprint,
-    archetype: void 0,
-    // Will be derived from blueprint
-    theme,
-    mode,
-    shape,
-    target,
-    guard: guardMode,
-    density,
-    shell,
-    personality: ["professional"],
-    features: [],
-    existing: detected.existingEssence
-  };
-}
-function parseFlags(args, detected) {
-  const options = {};
-  if (typeof args.blueprint === "string") options.blueprint = args.blueprint;
-  if (typeof args.archetype === "string") options.archetype = args.archetype;
-  if (typeof args.theme === "string") options.theme = args.theme;
-  if (args.mode === "dark" || args.mode === "light" || args.mode === "auto") options.mode = args.mode;
-  if (typeof args.shape === "string") options.shape = args.shape;
-  if (typeof args.target === "string") options.target = args.target;
-  if (args.guard === "creative" || args.guard === "guided" || args.guard === "strict") options.guard = args.guard;
-  if (args.density === "compact" || args.density === "comfortable" || args.density === "spacious") options.density = args.density;
-  if (typeof args.shell === "string") options.shell = args.shell;
-  if (typeof args.personality === "string") options.personality = args.personality.split(",").map((s) => s.trim());
-  if (typeof args.features === "string") options.features = args.features.split(",").map((s) => s.trim());
-  if (args.existing === true) options.existing = true;
-  return options;
-}
-function mergeWithDefaults(flags, detected) {
-  return {
-    blueprint: flags.blueprint,
-    archetype: flags.archetype,
-    theme: flags.theme || "luminarum",
-    mode: flags.mode || "dark",
-    shape: flags.shape || "rounded",
-    target: flags.target || (detected.framework !== "unknown" ? detected.framework : "react"),
-    guard: flags.guard || (detected.existingEssence ? "guided" : "strict"),
-    density: flags.density || "comfortable",
-    shell: flags.shell || "sidebar-main",
-    personality: flags.personality || ["professional"],
-    features: flags.features || [],
-    existing: flags.existing || detected.existingEssence
-  };
-}
-async function runSimplifiedInit(blueprints) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const question = (q) => new Promise((resolve) => rl.question(q, resolve));
-  console.log("\n? What blueprint would you like to scaffold?\n");
-  console.log("  1. Decantr default (recommended)");
-  console.log("  2. Search registry...\n");
-  const choice = await question("Enter choice (1 or 2): ");
-  if (choice === "1" || choice === "") {
-    rl.close();
-    return { choice: "default" };
-  }
-  const searchQuery = await question("Search: ");
-  const matches = blueprints.filter(
-    (b) => b.id.toLowerCase().includes(searchQuery.toLowerCase()) || b.name?.toLowerCase().includes(searchQuery.toLowerCase()) || b.description?.toLowerCase().includes(searchQuery.toLowerCase())
-  ).slice(0, 10);
-  if (matches.length === 0) {
-    console.log("\nNo matches found. Using Decantr default.");
-    rl.close();
-    return { choice: "default" };
-  }
-  console.log("\nResults:");
-  matches.forEach((b, i) => {
-    console.log(`  ${i + 1}. ${b.id} \u2014 ${b.description || b.name || ""}`);
-  });
-  const selection = await question("\nSelect (number): ");
-  const idx = parseInt(selection, 10) - 1;
-  rl.close();
-  if (idx >= 0 && idx < matches.length) {
-    return { choice: "search", selectedBlueprint: matches[idx].id };
-  }
-  return { choice: "default" };
-}
-
-// src/scaffold.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync, appendFileSync } from "fs";
-import { join as join2, dirname } from "path";
-import { fileURLToPath } from "url";
-var __dirname = dirname(fileURLToPath(import.meta.url));
-var CLI_VERSION = "1.0.0";
-function serializeLayoutItem(item) {
-  if (typeof item === "string") {
-    return item;
-  }
-  if (typeof item === "object" && item !== null) {
-    const obj = item;
-    if (typeof obj.pattern === "string") {
-      const preset = obj.preset ? ` (${obj.preset})` : "";
-      const alias = obj.as ? ` as ${obj.as}` : "";
-      return `${obj.pattern}${preset}${alias}`;
-    }
-    if (Array.isArray(obj.cols)) {
-      const cols = obj.cols.map(serializeLayoutItem).join(" | ");
-      const breakpoint = obj.at ? ` @${obj.at}` : "";
-      return `[${cols}]${breakpoint}`;
-    }
-  }
-  return "custom";
-}
-function extractPatternNames(item) {
-  if (typeof item === "string") {
-    return [item];
-  }
-  if (typeof item === "object" && item !== null) {
-    const obj = item;
-    if (typeof obj.pattern === "string") {
-      return [obj.pattern];
-    }
-    if (Array.isArray(obj.cols)) {
-      return obj.cols.flatMap(extractPatternNames);
-    }
-  }
-  return [];
-}
-function loadTemplate(name) {
-  const fromDist = join2(__dirname, "..", "src", "templates", name);
-  if (existsSync2(fromDist)) {
-    return readFileSync2(fromDist, "utf-8");
-  }
-  const fromSrc = join2(__dirname, "templates", name);
-  if (existsSync2(fromSrc)) {
-    return readFileSync2(fromSrc, "utf-8");
-  }
-  throw new Error(`Template not found: ${name}`);
-}
-function renderTemplate(template, vars) {
-  let result = template;
-  for (const [key, value] of Object.entries(vars)) {
-    result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, "g"), value);
-  }
-  return result;
-}
-function resolvePatternAlias(item, patterns) {
-  if (!patterns) return item;
-  if (typeof item === "string") {
-    const patternDef = patterns.find((p) => p.as === item);
-    if (patternDef) {
-      if (patternDef.preset) {
-        return { pattern: patternDef.pattern, preset: patternDef.preset };
-      }
-      return patternDef.pattern;
-    }
-    return item;
-  }
-  if (typeof item === "object" && item !== null) {
-    const obj = item;
-    if (Array.isArray(obj.cols)) {
-      return {
-        ...obj,
-        cols: obj.cols.map((col) => resolvePatternAlias(col, patterns))
-      };
-    }
-  }
-  return item;
-}
-function buildEssence(options, archetypeData) {
-  let structure = [
-    { id: "home", shell: options.shell, layout: ["hero"] }
-  ];
-  let features = options.features;
-  if (archetypeData?.pages) {
-    structure = archetypeData.pages.map((p) => {
-      const resolvedLayout = (p.default_layout?.length ? p.default_layout : ["hero"]).map((item) => resolvePatternAlias(item, p.patterns));
-      return {
-        id: p.id,
-        shell: p.shell || options.shell,
-        layout: resolvedLayout
-      };
-    });
-  }
-  if (archetypeData?.features) {
-    features = [.../* @__PURE__ */ new Set([...features, ...archetypeData.features])];
-  }
-  const contentGapMap = {
-    compact: "_gap2",
-    comfortable: "_gap4",
-    spacious: "_gap6"
-  };
-  const archetype = options.archetype || "custom";
-  const essence = {
-    version: "2.0.0",
-    archetype,
-    theme: {
-      style: options.theme,
-      mode: options.mode,
-      recipe: options.theme,
-      // Recipe defaults to theme
-      shape: options.shape
-    },
-    personality: options.personality,
-    platform: {
-      type: "spa",
-      routing: "hash"
-    },
-    structure,
-    features,
-    guard: {
-      enforce_style: true,
-      enforce_recipe: true,
-      mode: options.guard
-    },
-    density: {
-      level: options.density,
-      content_gap: contentGapMap[options.density] || "_gap4"
-    },
-    target: options.target
-  };
-  if (options.accessibility) {
-    essence.accessibility = options.accessibility;
-  }
-  return essence;
-}
-function generateAccessibilitySection(essence, themeData) {
-  const accessibility = essence.accessibility;
-  if (!accessibility?.wcag_level || accessibility.wcag_level === "none") {
-    return "";
-  }
-  const wcagLevel = accessibility.wcag_level;
-  const cvdPreference = accessibility.cvd_preference || "none";
-  const cvdSupport = themeData?.cvd_support || [];
-  let section = `---
-
-## Accessibility
-
-**WCAG Level:** ${wcagLevel}
-`;
-  if (cvdSupport.length > 0) {
-    section += `**CVD Support:** Theme supports ${cvdSupport.join(", ")}
-**CVD Preference:** ${cvdPreference}
-`;
-  }
-  section += `
-### What This Means
-
-This project requires WCAG 2.1 Level ${wcagLevel} compliance. You already know these rules \u2014 apply them:
-
-- Semantic HTML structure
-- Sufficient color contrast (4.5:1 for normal text, 3:1 for large text)
-- Keyboard navigability for all interactive elements
-- Visible focus indicators
-- Meaningful alt text for images
-- Proper heading hierarchy
-`;
-  if (cvdSupport.length > 0) {
-    section += `
-### CVD Implementation
-
-The theme provides these data attributes:
-
-\`\`\`html
-<html data-theme="${essence.theme.style}" data-mode="${essence.theme.mode}" data-cvd="none">
-\`\`\`
-
-Valid \`data-cvd\` values for this theme: \`none\`, ${cvdSupport.map((m) => `\`${m}\``).join(", ")}
-`;
-    if (cvdPreference === "auto") {
-      section += `
-Detect user preference via \`prefers-contrast\` or user settings and apply accordingly.
-`;
-    }
-  }
-  section += `
----
-`;
-  return section;
-}
-function generateSeoSection(essence, archetypeData) {
-  const seoHints = archetypeData?.seo_hints;
-  if (!seoHints) {
-    return "";
-  }
-  const schemaOrg = seoHints.schema_org || [];
-  const metaPriorities = seoHints.meta_priorities || [];
-  if (schemaOrg.length === 0 && metaPriorities.length === 0) {
-    return "";
-  }
-  let section = `---
-
-## SEO Guidance
-
-This archetype (\`${essence.archetype}\`) typically benefits from:
-
-`;
-  if (schemaOrg.length > 0) {
-    section += `- **Schema.org:** ${schemaOrg.join(", ")}
-`;
-  }
-  if (metaPriorities.length > 0) {
-    section += `- **Meta priorities:** ${metaPriorities.join(", ")}
-`;
-  }
-  section += `
-These are suggestions, not requirements. Apply where appropriate for the page content.
-
----
-`;
-  return section;
-}
-function generateDecantrMd(essence, detected, themeData, recipeData, archetypeData) {
-  const template = loadTemplate("DECANTR.md.template");
-  const pagesTable = essence.structure.map((p) => {
-    const layoutStr = p.layout.map(serializeLayoutItem).join(", ") || "none";
-    return `| ${p.id} | ${p.shell} | ${layoutStr} |`;
-  }).join("\n");
-  const allPatternNames = [...new Set(essence.structure.flatMap((p) => p.layout.flatMap(extractPatternNames)))];
-  const patternsList = allPatternNames.length > 0 ? allPatternNames.map((p) => `- \`${p}\``).join("\n") : "- No patterns specified yet";
-  const projectSummary = [
-    `**Archetype:** ${essence.archetype || "custom"}`,
-    `**Target:** ${essence.target}`,
-    `**Theme:** ${essence.theme.style} (${essence.theme.mode} mode)`,
-    `**Guard Mode:** ${essence.guard.mode}`,
-    `**Pages:** ${essence.structure.map((s) => s.id).join(", ")}`
-  ].join("\n");
-  const shellStructures = {
-    "sidebar-main": "nav (left) | header (top) | body (scrollable)",
-    "top-nav-main": "header (full width) | body (scrollable)",
-    "centered": "body (centered card)",
-    "full-bleed": "header (floating) | body (full page sections)",
-    "minimal-header": "header (slim) | body (centered)"
-  };
-  const defaultShell = essence.structure[0]?.shell || "sidebar-main";
-  const shellStructure = shellStructures[defaultShell] || "Custom shell layout";
-  let themeQuickRef = "";
-  if (themeData?.seed) {
-    const colors = Object.entries(themeData.seed).map(([name, hex]) => `- **${name}:** \`${hex}\``).join("\n");
-    themeQuickRef = `**Seed Colors:**
-${colors}`;
-  }
-  if (recipeData?.decorators) {
-    const decorators = Object.entries(recipeData.decorators).slice(0, 5).map(([name, desc]) => `- \`${name}\` \u2014 ${desc}`).join("\n");
-    if (themeQuickRef) {
-      themeQuickRef += `
-
-**Key Decorators:**
-${decorators}`;
-    } else {
-      themeQuickRef = `**Key Decorators:**
-${decorators}`;
-    }
-  }
-  if (!themeQuickRef) {
-    themeQuickRef = `See \`decantr get theme ${essence.theme.style}\` for details.`;
-  }
-  const accessibilitySection = generateAccessibilitySection(essence, themeData);
-  const seoSection = generateSeoSection(essence, archetypeData);
-  const vars = {
-    GUARD_MODE: essence.guard.mode,
-    PROJECT_SUMMARY: projectSummary,
-    THEME_STYLE: essence.theme.style,
-    THEME_MODE: essence.theme.mode,
-    THEME_RECIPE: essence.theme.recipe,
-    TARGET: essence.target,
-    PAGES_TABLE: `| Page | Shell | Layout |
-|------|-------|--------|
-${pagesTable}`,
-    PATTERNS_LIST: patternsList,
-    DEFAULT_SHELL: defaultShell,
-    SHELL_STRUCTURE: shellStructure,
-    PERSONALITY: essence.personality.join(", "),
-    DENSITY: essence.density.level,
-    AVAILABLE_PATTERNS: "(See registry or .decantr/cache/patterns/)",
-    AVAILABLE_THEMES: "(See registry or .decantr/cache/themes/)",
-    AVAILABLE_SHELLS: "sidebar-main, top-nav-main, centered, full-bleed, minimal-header",
-    VERSION: CLI_VERSION,
-    THEME_QUICK_REFERENCE: themeQuickRef,
-    ACCESSIBILITY_SECTION: accessibilitySection,
-    SEO_SECTION: seoSection
-  };
-  return renderTemplate(template, vars);
-}
-function generateProjectJson(detected, options, registrySource) {
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const data = {
-    detected: {
-      framework: detected.framework,
-      version: detected.version || null,
-      packageManager: detected.packageManager,
-      hasTypeScript: detected.hasTypeScript,
-      hasTailwind: detected.hasTailwind,
-      existingRuleFiles: detected.existingRuleFiles
-    },
-    overrides: {
-      framework: options.target !== detected.framework ? options.target : null
-    },
-    sync: {
-      status: registrySource === "api" ? "synced" : "needs-sync",
-      lastSync: now,
-      registrySource,
-      cachedContent: {
-        archetypes: [],
-        patterns: [],
-        themes: [],
-        recipes: []
-      }
-    },
-    initialized: {
-      at: now,
-      via: "cli",
-      version: CLI_VERSION,
-      flags: buildFlagsString(options)
-    }
-  };
-  return JSON.stringify(data, null, 2);
-}
-function buildFlagsString(options) {
-  const flags = [];
-  if (options.blueprint) flags.push(`--blueprint=${options.blueprint}`);
-  if (options.theme) flags.push(`--theme=${options.theme}`);
-  if (options.mode) flags.push(`--mode=${options.mode}`);
-  if (options.guard) flags.push(`--guard=${options.guard}`);
-  return flags.join(" ");
-}
-function generateTaskContext(templateName, essence) {
-  const template = loadTemplate(templateName);
-  const defaultShell = essence.structure[0]?.shell || "sidebar-main";
-  const layout = essence.structure[0]?.layout.map(serializeLayoutItem).join(", ") || "none";
-  const scaffoldStructure = essence.structure.map((p) => {
-    const patterns = p.layout.length > 0 ? `
-  - Patterns: ${p.layout.map(serializeLayoutItem).join(", ")}` : "";
-    return `- **${p.id}** (${p.shell})${patterns}`;
-  }).join("\n");
-  const vars = {
-    TARGET: essence.target,
-    THEME_STYLE: essence.theme.style,
-    THEME_MODE: essence.theme.mode,
-    THEME_RECIPE: essence.theme.recipe,
-    DEFAULT_SHELL: defaultShell,
-    GUARD_MODE: essence.guard.mode,
-    LAYOUT: layout,
-    DENSITY: essence.density.level,
-    CONTENT_GAP: essence.density.content_gap,
-    SCAFFOLD_STRUCTURE: scaffoldStructure
-  };
-  return renderTemplate(template, vars);
-}
-function generateEssenceSummary(essence) {
-  const template = loadTemplate("essence-summary.md.template");
-  const pagesTable = `| Page | Shell | Layout |
-|------|-------|--------|
-${essence.structure.map((p) => `| ${p.id} | ${p.shell} | ${p.layout.map(serializeLayoutItem).join(", ") || "none"} |`).join("\n")}`;
-  const featuresList = essence.features.length > 0 ? essence.features.map((f) => `- ${f}`).join("\n") : "- No features specified";
-  const vars = {
-    ARCHETYPE: essence.archetype || "custom",
-    BLUEPRINT: essence.blueprint || "none",
-    PERSONALITY: essence.personality.join(", "),
-    TARGET: essence.target,
-    THEME_STYLE: essence.theme.style,
-    THEME_MODE: essence.theme.mode,
-    THEME_RECIPE: essence.theme.recipe,
-    SHAPE: essence.theme.shape,
-    PAGES_TABLE: pagesTable,
-    FEATURES_LIST: featuresList,
-    GUARD_MODE: essence.guard.mode,
-    ENFORCE_STYLE: String(essence.guard.enforce_style),
-    ENFORCE_RECIPE: String(essence.guard.enforce_recipe),
-    DENSITY: essence.density.level,
-    CONTENT_GAP: essence.density.content_gap,
-    LAST_UPDATED: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  return renderTemplate(template, vars);
-}
-function updateGitignore(projectRoot) {
-  const gitignorePath = join2(projectRoot, ".gitignore");
-  const cacheEntry = ".decantr/cache/";
-  if (existsSync2(gitignorePath)) {
-    const content = readFileSync2(gitignorePath, "utf-8");
-    if (!content.includes(cacheEntry)) {
-      appendFileSync(gitignorePath, `
-# Decantr cache
-${cacheEntry}
-`);
-      return true;
-    }
-    return false;
-  } else {
-    writeFileSync(gitignorePath, `# Decantr cache
-${cacheEntry}
-`);
-    return true;
-  }
-}
-function scaffoldProject(projectRoot, options, detected, archetypeData, registrySource = "bundled", themeData, recipeData) {
-  const essence = buildEssence(options, archetypeData);
-  const decantrDir = join2(projectRoot, ".decantr");
-  const contextDir = join2(decantrDir, "context");
-  const cacheDir = join2(decantrDir, "cache");
-  mkdirSync(contextDir, { recursive: true });
-  mkdirSync(cacheDir, { recursive: true });
-  const essencePath = join2(projectRoot, "decantr.essence.json");
-  writeFileSync(essencePath, JSON.stringify(essence, null, 2) + "\n");
-  const decantrMdPath = join2(projectRoot, "DECANTR.md");
-  writeFileSync(decantrMdPath, generateDecantrMd(essence, detected, themeData, recipeData, archetypeData));
-  const projectJsonPath = join2(decantrDir, "project.json");
-  writeFileSync(projectJsonPath, generateProjectJson(detected, options, registrySource));
-  const contextFiles = [];
-  const scaffoldPath = join2(contextDir, "task-scaffold.md");
-  writeFileSync(scaffoldPath, generateTaskContext("task-scaffold.md.template", essence));
-  contextFiles.push(scaffoldPath);
-  const addPagePath = join2(contextDir, "task-add-page.md");
-  writeFileSync(addPagePath, generateTaskContext("task-add-page.md.template", essence));
-  contextFiles.push(addPagePath);
-  const modifyPath = join2(contextDir, "task-modify.md");
-  writeFileSync(modifyPath, generateTaskContext("task-modify.md.template", essence));
-  contextFiles.push(modifyPath);
-  const summaryPath = join2(contextDir, "essence-summary.md");
-  writeFileSync(summaryPath, generateEssenceSummary(essence));
-  contextFiles.push(summaryPath);
-  const gitignoreUpdated = updateGitignore(projectRoot);
-  return {
-    essencePath,
-    decantrMdPath,
-    projectJsonPath,
-    contextFiles,
-    gitignoreUpdated
-  };
-}
-
-// src/theme-commands.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2, readdirSync, rmSync } from "fs";
-import { join as join3 } from "path";
-
-// src/theme-templates.ts
-function getThemeSkeleton(id, name) {
-  return {
-    $schema: "https://decantr.ai/schemas/style-metadata.v1.json",
-    id,
-    name,
-    description: "",
-    tags: [],
-    seed: {
-      primary: "#6366F1",
-      secondary: "#8B5CF6",
-      accent: "#EC4899",
-      background: "#0F172A"
-    },
-    palette: {},
-    modes: ["dark"],
-    shapes: ["rounded"],
-    decantr_compat: ">=1.0.0",
-    source: "custom"
-  };
-}
-function getHowToThemeDoc() {
-  return `# Custom Themes
-
-Create custom themes for your Decantr project.
-
-## Quick Start
-
-\`\`\`bash
-decantr theme create mytheme
-\`\`\`
-
-## Theme Structure
-
-| Field | Required | Description |
-|-------|----------|-------------|
-| id | Yes | Unique identifier (matches filename) |
-| name | Yes | Display name |
-| description | No | Brief description |
-| tags | No | Searchable tags |
-| seed | Yes | Core colors: primary, secondary, accent, background |
-| palette | No | Extended color palette |
-| modes | Yes | Supported modes: ["light"], ["dark"], or both |
-| shapes | Yes | Supported shapes: sharp, rounded, pill |
-| decantr_compat | Yes | Version compatibility (e.g., ">=1.0.0") |
-| source | Yes | Must be "custom" |
-
-## Using Your Theme
-
-In \`decantr.essence.json\`:
-
-\`\`\`json
-{
-  "theme": {
-    "style": "custom:mytheme",
-    "mode": "dark"
-  }
-}
-\`\`\`
-
-## Validation
-
-\`\`\`bash
-decantr theme validate mytheme
-\`\`\`
-
-## Reference
-
-See registry themes for examples:
-
-\`\`\`bash
-decantr get theme auradecantism
-\`\`\`
-`;
-}
-
-// src/theme-commands.ts
-var REQUIRED_FIELDS = ["id", "name", "seed", "modes", "shapes", "decantr_compat", "source"];
-var REQUIRED_SEED = ["primary", "secondary", "accent", "background"];
-var VALID_MODES = ["light", "dark"];
-var VALID_SHAPES = ["sharp", "rounded", "pill"];
-function validateCustomTheme(theme) {
-  const errors = [];
-  for (const field of REQUIRED_FIELDS) {
-    if (!(field in theme)) {
-      errors.push(`Missing required field: ${field}`);
-    }
-  }
-  if (theme.seed && typeof theme.seed === "object") {
-    const seed = theme.seed;
-    for (const color of REQUIRED_SEED) {
-      if (!(color in seed)) {
-        errors.push(`Missing seed color: ${color}`);
-      }
-    }
-  }
-  if (Array.isArray(theme.modes)) {
-    for (const mode of theme.modes) {
-      if (!VALID_MODES.includes(mode)) {
-        errors.push(`Invalid mode "${mode}" - must be "light" or "dark"`);
-      }
-    }
-  }
-  if (Array.isArray(theme.shapes)) {
-    for (const shape of theme.shapes) {
-      if (!VALID_SHAPES.includes(shape)) {
-        errors.push(`Invalid shape "${shape}" - use: sharp, rounded, pill`);
-      }
-    }
-  }
-  return {
-    valid: errors.length === 0,
-    errors
-  };
-}
-function createTheme(projectRoot, id, name) {
-  const customThemesDir = join3(projectRoot, ".decantr", "custom", "themes");
-  const themePath = join3(customThemesDir, `${id}.json`);
-  const howToPath = join3(customThemesDir, "how-to-theme.md");
-  mkdirSync2(customThemesDir, { recursive: true });
-  if (existsSync3(themePath)) {
-    return {
-      success: false,
-      error: `Theme "${id}" already exists at ${themePath}`
-    };
-  }
-  const skeleton = getThemeSkeleton(id, name);
-  writeFileSync2(themePath, JSON.stringify(skeleton, null, 2));
-  if (!existsSync3(howToPath)) {
-    writeFileSync2(howToPath, getHowToThemeDoc());
-  }
-  return {
-    success: true,
-    path: themePath
-  };
-}
-function listCustomThemes(projectRoot) {
-  const customThemesDir = join3(projectRoot, ".decantr", "custom", "themes");
-  if (!existsSync3(customThemesDir)) {
-    return [];
-  }
-  const themes = [];
-  try {
-    const files = readdirSync(customThemesDir).filter((f) => f.endsWith(".json"));
-    for (const file of files) {
-      const filePath = join3(customThemesDir, file);
-      try {
-        const data = JSON.parse(readFileSync3(filePath, "utf-8"));
-        themes.push({
-          id: data.id || file.replace(".json", ""),
-          name: data.name || data.id,
-          description: data.description,
-          path: filePath
-        });
-      } catch {
-      }
-    }
-  } catch {
-  }
-  return themes;
-}
-function deleteTheme(projectRoot, id) {
-  const themePath = join3(projectRoot, ".decantr", "custom", "themes", `${id}.json`);
-  if (!existsSync3(themePath)) {
-    return {
-      success: false,
-      error: `Theme "${id}" not found at ${themePath}`
-    };
-  }
-  try {
-    rmSync(themePath);
-    return { success: true };
-  } catch (e) {
-    return {
-      success: false,
-      error: `Failed to delete: ${e.message}`
-    };
-  }
-}
-function importTheme(projectRoot, sourcePath) {
-  if (!existsSync3(sourcePath)) {
-    return {
-      success: false,
-      errors: [`Source file not found: ${sourcePath}`]
-    };
-  }
-  let theme;
-  try {
-    theme = JSON.parse(readFileSync3(sourcePath, "utf-8"));
-  } catch (e) {
-    return {
-      success: false,
-      errors: [`Invalid JSON: ${e.message}`]
-    };
-  }
-  const validation = validateCustomTheme(theme);
-  if (!validation.valid) {
-    return {
-      success: false,
-      errors: validation.errors
-    };
-  }
-  theme.source = "custom";
-  const id = theme.id;
-  const customThemesDir = join3(projectRoot, ".decantr", "custom", "themes");
-  const destPath = join3(customThemesDir, `${id}.json`);
-  mkdirSync2(customThemesDir, { recursive: true });
-  const howToPath = join3(customThemesDir, "how-to-theme.md");
-  if (!existsSync3(howToPath)) {
-    writeFileSync2(howToPath, getHowToThemeDoc());
-  }
-  writeFileSync2(destPath, JSON.stringify(theme, null, 2));
-  return {
-    success: true,
-    path: destPath
-  };
-}
-
-// src/index.ts
-var BOLD2 = "\x1B[1m";
-var DIM2 = "\x1B[2m";
-var RESET2 = "\x1B[0m";
-var RED = "\x1B[31m";
-var GREEN2 = "\x1B[32m";
-var CYAN2 = "\x1B[36m";
-var YELLOW2 = "\x1B[33m";
-function heading(text) {
-  return `
-${BOLD2}${text}${RESET2}
-`;
-}
-function success(text) {
-  return `${GREEN2}${text}${RESET2}`;
-}
-function error(text) {
-  return `${RED}${text}${RESET2}`;
-}
-function dim(text) {
-  return `${DIM2}${text}${RESET2}`;
-}
-function cyan(text) {
-  return `${CYAN2}${text}${RESET2}`;
-}
-function extractPatternName(item) {
-  if (typeof item === "string") return item;
-  if (typeof item === "object" && item !== null) {
-    const obj = item;
-    if (typeof obj.pattern === "string") return obj.pattern;
-    if (Array.isArray(obj.cols)) {
-      return obj.cols.map(extractPatternName).join(" | ");
-    }
-  }
-  return "custom";
-}
-function generateCuratedPrompt(ctx) {
-  const lines = [];
-  lines.push(`I'm building a ${ctx.archetype} application using ${ctx.target}.`);
-  lines.push("");
-  if (ctx.blueprint) {
-    lines.push(`Blueprint: ${ctx.blueprint}`);
-  }
-  lines.push(`Theme: ${ctx.theme} (${ctx.mode} mode)`);
-  lines.push(`Personality: ${ctx.personality.join(", ")}`);
-  lines.push(`Guard mode: ${ctx.guard}`);
-  lines.push("");
-  lines.push("Pages to build:");
-  for (const page of ctx.pages) {
-    const patternNames = page.layout.map(extractPatternName);
-    const patterns = patternNames.length > 0 ? patternNames.join(", ") : "custom";
-    lines.push(`  - ${page.id}: ${page.shell} shell with ${patterns}`);
-  }
-  if (ctx.features.length > 0) {
-    lines.push("");
-    lines.push(`Features: ${ctx.features.join(", ")}`);
-  }
-  lines.push("");
-  lines.push("Please read DECANTR.md for the full design spec and methodology.");
-  lines.push("Follow the guard rules and use the patterns from decantr.essence.json.");
-  return lines.join("\n");
-}
-function boxedPrompt(content, title) {
-  const lines = content.split("\n");
-  const maxLen = Math.max(...lines.map((l) => l.length), title.length + 4);
-  const width = maxLen + 4;
-  const top = `\u250C${"\u2500".repeat(width - 2)}\u2510`;
-  const titleLine = `\u2502 ${BOLD2}${title}${RESET2}${" ".repeat(width - title.length - 4)} \u2502`;
-  const sep = `\u251C${"\u2500".repeat(width - 2)}\u2524`;
-  const bottom = `\u2514${"\u2500".repeat(width - 2)}\u2518`;
-  const body = lines.map((line) => {
-    const padding = " ".repeat(width - line.length - 4);
-    return `\u2502 ${line}${padding} \u2502`;
-  }).join("\n");
-  return `${top}
-${titleLine}
-${sep}
-${body}
-${bottom}`;
-}
-function getContentRoot() {
-  const bundled = join4(import.meta.dirname, "..", "..", "..", "content");
-  return process.env.DECANTR_CONTENT_ROOT || bundled;
-}
-function getResolver() {
-  return createResolver({ contentRoot: getContentRoot() });
-}
-async function cmdSearch(query, type) {
-  const client = createRegistryClient();
-  const results = await client.search(query, type);
-  if (results.length === 0) {
-    console.log(dim(`No results for "${query}"`));
-    return;
-  }
-  console.log(heading(`${results.length} result(s) for "${query}"`));
-  for (const r of results) {
-    console.log(`  ${cyan(r.type.padEnd(12))} ${BOLD2}${r.id}${RESET2}`);
-    console.log(`  ${dim(r.description || "")}`);
-    console.log("");
-  }
-}
-async function cmdSuggest(query, type) {
-  const client = createRegistryClient();
-  const searchType = type || "pattern";
-  const results = await client.search(query, searchType);
-  if (results.length === 0) {
-    console.log(dim(`No suggestions for "${query}"`));
-    console.log("");
-    console.log("Try:");
-    console.log(`  ${cyan("decantr list patterns")} - see all patterns`);
-    console.log(`  ${cyan("decantr search <broader-term>")} - broaden your search`);
-    return;
-  }
-  console.log(heading(`Suggestions for "${query}"`));
-  const queryLower = query.toLowerCase();
-  const exact = results.filter((r) => r.id.toLowerCase().includes(queryLower));
-  const related = results.filter((r) => !r.id.toLowerCase().includes(queryLower));
-  if (exact.length > 0) {
-    console.log(`${BOLD2}Direct matches:${RESET2}`);
-    for (const r of exact.slice(0, 3)) {
-      console.log(`  ${cyan(r.id)} - ${r.description || ""}`);
-    }
-    console.log("");
-  }
-  if (related.length > 0) {
-    console.log(`${BOLD2}Related:${RESET2}`);
-    for (const r of related.slice(0, 5)) {
-      console.log(`  ${cyan(r.id)} - ${r.description || ""}`);
-    }
-    console.log("");
-  }
-  console.log(dim(`Use "decantr get pattern <id>" for full details`));
-}
-async function cmdGet(type, id) {
-  const validTypes = ["pattern", "archetype", "recipe", "theme", "blueprint", "shell"];
-  if (!validTypes.includes(type)) {
-    console.error(error(`Invalid type "${type}". Must be one of: ${validTypes.join(", ")}`));
-    process.exitCode = 1;
-    return;
-  }
-  if (type === "shell") {
-    const registryClient = new RegistryClient({
-      cacheDir: join4(process.cwd(), ".decantr", "cache")
-    });
-    const shellResult = await registryClient.fetchShell(id);
-    if (shellResult) {
-      console.log(JSON.stringify(shellResult.data, null, 2));
-      return;
-    }
-    console.error(error(`shell "${id}" not found.`));
-    process.exitCode = 1;
-    return;
-  }
-  const resolver = getResolver();
-  let result = await resolver.resolve(type, id);
-  if (!result) {
-    const apiType = type === "blueprint" ? "blueprints" : `${type}s`;
-    try {
-      const res = await fetch(`https://decantr-registry.fly.dev/v1/${apiType}/${id}`);
-      if (res.ok) {
-        const item = await res.json();
-        if (!item.error) {
-          console.log(JSON.stringify(item, null, 2));
-          return;
-        }
-      }
-    } catch {
-    }
-    console.error(error(`${type} "${id}" not found.`));
-    process.exitCode = 1;
-    return;
-  }
-  console.log(JSON.stringify(result.item, null, 2));
-}
-function buildRegistryContext() {
-  const { readdirSync: readdirSync2 } = __require("fs");
-  const themeRegistry = /* @__PURE__ */ new Map();
-  const patternRegistry = /* @__PURE__ */ new Map();
-  const contentRoot = getContentRoot();
-  const themeDirs = [join4(contentRoot, "themes"), join4(contentRoot, "core", "themes")];
-  for (const dir of themeDirs) {
-    try {
-      if (existsSync4(dir)) {
-        for (const f of readdirSync2(dir).filter((f2) => f2.endsWith(".json"))) {
-          const data = JSON.parse(readFileSync4(join4(dir, f), "utf-8"));
-          if (data.id && !themeRegistry.has(data.id)) {
-            themeRegistry.set(data.id, { modes: data.modes || ["light", "dark"] });
-          }
-        }
-      }
-    } catch {
-    }
-  }
-  const customThemesDir = join4(process.cwd(), ".decantr", "custom", "themes");
-  try {
-    if (existsSync4(customThemesDir)) {
-      for (const f of readdirSync2(customThemesDir).filter((f2) => f2.endsWith(".json"))) {
-        const data = JSON.parse(readFileSync4(join4(customThemesDir, f), "utf-8"));
-        if (data.id) {
-          themeRegistry.set(`custom:${data.id}`, { modes: data.modes || ["light", "dark"] });
-        }
-      }
-    }
-  } catch {
-  }
-  const patternDirs = [join4(contentRoot, "patterns"), join4(contentRoot, "core", "patterns")];
-  for (const dir of patternDirs) {
-    try {
-      if (existsSync4(dir)) {
-        for (const f of readdirSync2(dir).filter((f2) => f2.endsWith(".json"))) {
-          const data = JSON.parse(readFileSync4(join4(dir, f), "utf-8"));
-          if (data.id && !patternRegistry.has(data.id)) {
-            patternRegistry.set(data.id, data);
-          }
-        }
-      }
-    } catch {
-    }
-  }
-  return { themeRegistry, patternRegistry };
-}
-async function cmdValidate(path) {
-  const essencePath = path || join4(process.cwd(), "decantr.essence.json");
-  let raw;
-  try {
-    raw = readFileSync4(essencePath, "utf-8");
-  } catch {
-    console.error(error(`Could not read ${essencePath}`));
-    process.exitCode = 1;
-    return;
-  }
-  let essence;
-  try {
-    essence = JSON.parse(raw);
-  } catch (e) {
-    console.error(error(`Invalid JSON: ${e.message}`));
-    process.exitCode = 1;
-    return;
-  }
-  const result = validateEssence(essence);
-  if (result.valid) {
-    console.log(success("Essence is valid."));
-  } else {
-    console.error(error("Validation failed:"));
-    for (const err of result.errors) {
-      console.error(`  ${RED}${err}${RESET2}`);
-    }
-    process.exitCode = 1;
-  }
-  try {
-    const { themeRegistry, patternRegistry } = buildRegistryContext();
-    const violations = evaluateGuard(essence, { themeRegistry, patternRegistry });
-    if (violations.length > 0) {
-      console.log(heading("Guard violations:"));
-      for (const v of violations) {
-        const vr = v;
-        console.log(`  ${YELLOW2}[${vr.rule}]${RESET2} ${vr.message}`);
-        if (vr.suggestion) {
-          console.log(`    ${DIM2}Suggestion: ${vr.suggestion}${RESET2}`);
-        }
-      }
-    } else if (result.valid) {
-      console.log(success("No guard violations."));
-    }
-  } catch {
-  }
-}
-async function cmdList(type) {
-  const validTypes = ["patterns", "archetypes", "recipes", "themes", "blueprints", "shells"];
-  if (!validTypes.includes(type)) {
-    console.error(error(`Invalid type "${type}". Must be one of: ${validTypes.join(", ")}`));
-    process.exitCode = 1;
-    return;
-  }
-  if (type === "shells") {
-    const registryClient = new RegistryClient({
-      cacheDir: join4(process.cwd(), ".decantr", "cache")
-    });
-    const shellsResult = await registryClient.fetchShells();
-    for (const item of shellsResult.data.items) {
-      console.log(`  ${item.id}${item.description ? ` \u2014 ${item.description}` : ""}`);
-    }
-    console.log(`
-${shellsResult.data.total} shells found`);
-    return;
-  }
-  const { readdirSync: readdirSync2, existsSync: existsSync5 } = await import("fs");
-  const contentRoot = getContentRoot();
-  const mainDir = join4(contentRoot, type);
-  const coreDir = join4(contentRoot, "core", type);
-  const items = [];
-  try {
-    if (existsSync5(mainDir)) {
-      const files = readdirSync2(mainDir).filter((f) => f.endsWith(".json"));
-      for (const f of files) {
-        const data = JSON.parse(readFileSync4(join4(mainDir, f), "utf-8"));
-        items.push({ id: data.id || f.replace(".json", ""), description: data.description, name: data.name });
-      }
-    }
-  } catch {
-  }
-  try {
-    if (existsSync5(coreDir)) {
-      const files = readdirSync2(coreDir).filter((f) => f.endsWith(".json"));
-      const existingIds = new Set(items.map((i) => i.id));
-      for (const f of files) {
-        const data = JSON.parse(readFileSync4(join4(coreDir, f), "utf-8"));
-        const itemId = data.id || f.replace(".json", "");
-        if (!existingIds.has(itemId)) {
-          items.push({ id: itemId, description: data.description, name: data.name });
-        }
-      }
-    }
-  } catch {
-  }
-  const customItems = [];
-  if (type === "themes") {
-    try {
-      const custom = listCustomThemes(process.cwd());
-      for (const theme of custom) {
-        customItems.push({
-          id: `custom:${theme.id}`,
-          description: theme.description,
-          name: theme.name,
-          source: "custom"
-        });
-      }
-    } catch {
-    }
-  }
-  if (items.length > 0 || customItems.length > 0) {
-    if (type === "themes") {
-      console.log(heading(`Registry themes (${items.length}):`));
-      for (const item of items) {
-        console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-      }
-      if (customItems.length > 0) {
-        console.log("");
-        console.log(heading(`Custom themes (${customItems.length}):`));
-        for (const item of customItems) {
-          console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-        }
-      } else {
-        console.log("");
-        console.log(dim("Custom themes (0):"));
-        console.log(dim('  Run "decantr theme create <name>" to create a custom theme.'));
-      }
-    } else {
-      console.log(heading(`${items.length} ${type}`));
-      for (const item of items) {
-        console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-      }
-    }
-    return;
-  }
-  try {
-    const res = await fetch(`https://decantr-registry.fly.dev/v1/${type}`);
-    if (res.ok) {
-      const data = await res.json();
-      if (type === "themes") {
-        console.log(heading(`Registry themes (${data.total}):`));
-        for (const item of data.items) {
-          console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-        }
-        console.log("");
-        console.log(dim("Custom themes (0):"));
-        console.log(dim('  Run "decantr theme create <name>" to create a custom theme.'));
-      } else {
-        console.log(heading(`${data.total} ${type}`));
-        for (const item of data.items) {
-          console.log(`  ${cyan(item.id)}  ${dim(item.description || item.name || "")}`);
-        }
-      }
-      return;
-    }
-  } catch {
-  }
-  console.log(dim(`No ${type} found.`));
-}
-async function cmdInit(args) {
-  const projectRoot = process.cwd();
-  console.log(heading("Decantr Project Setup"));
-  const detected = detectProject(projectRoot);
-  if (detected.existingEssence && !args.existing) {
-    console.log(`${YELLOW2}Warning: decantr.essence.json already exists.${RESET2}`);
-    const overwrite = await confirm("Overwrite existing configuration?", false);
-    if (!overwrite) {
-      console.log(dim("Cancelled."));
-      return;
-    }
-  }
-  const registryClient = new RegistryClient({
-    cacheDir: join4(projectRoot, ".decantr", "cache"),
-    apiUrl: args.registry,
-    offline: args.offline
-  });
-  const apiAvailable = await registryClient.checkApiAvailability();
-  let selectedBlueprint = "default";
-  let registrySource = "bundled";
-  if (args.yes) {
-    selectedBlueprint = args.blueprint || "default";
-  } else if (!apiAvailable) {
-    console.log(`
-${YELLOW2}You're offline. Scaffolding Decantr default.${RESET2}`);
-    console.log(dim("Run `decantr upgrade` when online, or visit decantr.ai/registry\n"));
-    selectedBlueprint = "default";
-  } else {
-    console.log(dim("Fetching registry content..."));
-    const blueprintsResult2 = await registryClient.fetchBlueprints();
-    registrySource = blueprintsResult2.source.type === "api" ? "api" : "bundled";
-    const { selectedBlueprint: selected } = await runSimplifiedInit(
-      blueprintsResult2.data.items
-    );
-    selectedBlueprint = selected || "default";
-  }
-  const [archetypesResult, blueprintsResult, themesResult] = await Promise.all([
-    registryClient.fetchArchetypes(),
-    registryClient.fetchBlueprints(),
-    registryClient.fetchThemes()
-  ]);
-  if (archetypesResult.source.type === "api") {
-    registrySource = "api";
-  }
-  const archetypes = archetypesResult.data.items;
-  const blueprints = blueprintsResult.data.items;
-  const themes = themesResult.data.items;
-  let options;
-  if (args.yes || selectedBlueprint !== "default") {
-    const flags = parseFlags(args, detected);
-    flags.blueprint = selectedBlueprint !== "default" ? selectedBlueprint : flags.blueprint;
-    options = mergeWithDefaults(flags, detected);
-  } else {
-    options = await runInteractivePrompts(detected, archetypes, blueprints, themes);
-  }
-  let archetypeData;
-  if (options.blueprint) {
-    const blueprintResult = await registryClient.fetchBlueprint(options.blueprint);
-    if (blueprintResult) {
-      const blueprint = blueprintResult.data;
-      const primaryArchetype = blueprint.compose?.[0];
-      if (primaryArchetype) {
-        const archetypeResult = await registryClient.fetchArchetype(primaryArchetype);
-        if (archetypeResult) {
-          archetypeData = archetypeResult.data;
-          options.archetype = primaryArchetype;
-        }
-      }
-    }
-  } else if (options.archetype) {
-    const archetypeResult = await registryClient.fetchArchetype(options.archetype);
-    if (archetypeResult) {
-      archetypeData = archetypeResult.data;
-    }
-  }
-  let themeData;
-  let recipeData;
-  if (options.theme) {
-    const themeResult = await registryClient.fetchTheme(options.theme);
-    if (themeResult) {
-      const theme = themeResult.data;
-      if (theme.seed) {
-        themeData = { seed: theme.seed };
-      }
-    }
-  }
-  console.log(heading("Scaffolding project..."));
-  const result = scaffoldProject(
-    projectRoot,
-    options,
-    detected,
-    archetypeData,
-    registrySource,
-    themeData,
-    recipeData
-  );
-  console.log(success("\nProject scaffolded!\n"));
-  console.log("  Files created:");
-  console.log(`    ${cyan("decantr.essence.json")}    Design specification`);
-  console.log(`    ${cyan("DECANTR.md")}              LLM instructions`);
-  console.log(`    ${cyan(".decantr/")}               Project state & cache`);
-  if (result.gitignoreUpdated) {
-    console.log(`    ${dim(".gitignore updated")}`);
-  }
-  console.log("");
-  console.log("  Next steps:");
-  console.log("    1. Review DECANTR.md for methodology");
-  console.log("    2. Explore more at decantr.ai/registry");
-  console.log("");
-  console.log("  Commands:");
-  console.log(`    ${cyan("decantr status")}     Project health`);
-  console.log(`    ${cyan("decantr search")}     Search registry`);
-  console.log(`    ${cyan("decantr get")}        Fetch content details`);
-  console.log(`    ${cyan("decantr validate")}   Check essence file`);
-  console.log(`    ${cyan("decantr upgrade")}    Update to latest patterns`);
-  console.log(`    ${cyan("decantr heal")}       Fix drift issues`);
-  const essenceContent = readFileSync4(result.essencePath, "utf-8");
-  const essence = JSON.parse(essenceContent);
-  const validation = validateEssence(essence);
-  if (!validation.valid) {
-    console.log(error(`
-Validation warnings: ${validation.errors.join(", ")}`));
-  }
-  console.log("");
-  const promptCtx = {
-    archetype: options.archetype || "custom",
-    blueprint: options.blueprint,
-    theme: options.theme,
-    mode: options.mode,
-    target: options.target,
-    pages: essence.structure || [{ id: "home", shell: options.shell, layout: ["hero"] }],
-    personality: options.personality,
-    features: options.features,
-    guard: options.guard
-  };
-  const curatedPrompt = generateCuratedPrompt(promptCtx);
-  console.log(boxedPrompt(curatedPrompt, "Copy this prompt for your AI assistant"));
-  console.log("");
-  if (registrySource === "bundled") {
-    console.log(dim('Run "decantr sync" when online to get the latest registry content.'));
-  }
-}
-async function cmdStatus() {
-  const projectRoot = process.cwd();
-  const essencePath = join4(projectRoot, "decantr.essence.json");
-  const projectJsonPath = join4(projectRoot, ".decantr", "project.json");
-  console.log(heading("Decantr Project Status"));
-  if (!existsSync4(essencePath)) {
-    console.log(`${RED}No decantr.essence.json found.${RESET2}`);
-    console.log(dim('Run "decantr init" to create one.'));
-    return;
-  }
-  try {
-    const essence = JSON.parse(readFileSync4(essencePath, "utf-8"));
-    const validation = validateEssence(essence);
-    console.log(`${BOLD2}Essence:${RESET2}`);
-    if (validation.valid) {
-      console.log(`  ${GREEN2}Valid${RESET2}`);
-    } else {
-      console.log(`  ${RED}Invalid: ${validation.errors.join(", ")}${RESET2}`);
-    }
-    console.log(`  Theme: ${essence.theme?.style || "unknown"} (${essence.theme?.mode || "unknown"})`);
-    console.log(`  Guard: ${essence.guard?.mode || "unknown"}`);
-    console.log(`  Pages: ${(essence.structure || []).length}`);
-  } catch (e) {
-    console.log(`  ${RED}Error reading essence: ${e.message}${RESET2}`);
-  }
-  console.log("");
-  console.log(`${BOLD2}Sync Status:${RESET2}`);
-  if (existsSync4(projectJsonPath)) {
-    try {
-      const projectJson = JSON.parse(readFileSync4(projectJsonPath, "utf-8"));
-      const syncStatus = projectJson.sync?.status || "unknown";
-      const lastSync = projectJson.sync?.lastSync || "never";
-      const source = projectJson.sync?.registrySource || "unknown";
-      const statusColor = syncStatus === "synced" ? GREEN2 : YELLOW2;
-      console.log(`  Status: ${statusColor}${syncStatus}${RESET2}`);
-      console.log(`  Last sync: ${dim(lastSync)}`);
-      console.log(`  Source: ${dim(source)}`);
-    } catch {
-      console.log(`  ${YELLOW2}Could not read project.json${RESET2}`);
-    }
-  } else {
-    console.log(`  ${YELLOW2}No .decantr/project.json found${RESET2}`);
-    console.log(dim('  Run "decantr init" to create project files.'));
-  }
-}
-async function cmdSync() {
-  const projectRoot = process.cwd();
-  const cacheDir = join4(projectRoot, ".decantr", "cache");
-  console.log(heading("Syncing registry content..."));
-  const result = await syncRegistry(cacheDir);
-  if (result.source === "api") {
-    console.log(success("Sync completed successfully."));
-    if (result.synced.length > 0) {
-      console.log(`  Synced: ${result.synced.join(", ")}`);
-    }
-    if (result.failed.length > 0) {
-      console.log(`  ${YELLOW2}Failed: ${result.failed.join(", ")}${RESET2}`);
-    }
-  } else {
-    console.log(`${YELLOW2}Could not sync: API unavailable${RESET2}`);
-    console.log(dim("Using bundled content."));
-  }
-}
-async function cmdAudit() {
-  const projectRoot = process.cwd();
-  const essencePath = join4(projectRoot, "decantr.essence.json");
-  console.log(heading("Auditing project..."));
-  if (!existsSync4(essencePath)) {
-    console.log(`${RED}No decantr.essence.json found.${RESET2}`);
-    process.exitCode = 1;
-    return;
-  }
-  try {
-    const essence = JSON.parse(readFileSync4(essencePath, "utf-8"));
-    const validation = validateEssence(essence);
-    if (!validation.valid) {
-      console.log(`${RED}Essence validation failed:${RESET2}`);
-      for (const err of validation.errors) {
-        console.log(`  ${RED}${err}${RESET2}`);
-      }
-      process.exitCode = 1;
-      return;
-    }
-    console.log(success("Essence is valid."));
-    const { themeRegistry, patternRegistry } = buildRegistryContext();
-    const violations = evaluateGuard(essence, { themeRegistry, patternRegistry });
-    if (violations.length > 0) {
-      console.log("");
-      console.log(`${YELLOW2}Guard violations:${RESET2}`);
-      for (const v of violations) {
-        const vr = v;
-        console.log(`  ${YELLOW2}[${vr.rule}]${RESET2} ${vr.message}`);
-        if (vr.suggestion) {
-          console.log(`    ${DIM2}Suggestion: ${vr.suggestion}${RESET2}`);
-        }
-      }
-    } else {
-      console.log(success("No guard violations."));
-    }
-    console.log("");
-    console.log(`${BOLD2}Summary:${RESET2}`);
-    console.log(`  Pages defined: ${essence.structure.length}`);
-    console.log(`  Guard mode: ${essence.guard.mode}`);
-    console.log(`  Theme: ${essence.theme.style}`);
-  } catch (e) {
-    console.log(`${RED}Error: ${e.message}${RESET2}`);
-    process.exitCode = 1;
-  }
-}
-async function cmdTheme(args) {
-  const subcommand = args[0];
-  const projectRoot = process.cwd();
-  if (!subcommand || subcommand === "help") {
-    console.log(`
-${BOLD2}decantr theme${RESET2} \u2014 Manage custom themes
-
-${BOLD2}Commands:${RESET2}
-  ${cyan("create")} <name>        Create a new custom theme
-  ${cyan("create")} <name> --guided   Interactive theme creation
-  ${cyan("list")}                 List custom themes
-  ${cyan("validate")} <name>      Validate a custom theme
-  ${cyan("delete")} <name>        Delete a custom theme
-  ${cyan("import")} <path>        Import theme from JSON file
-
-${BOLD2}Examples:${RESET2}
-  decantr theme create mytheme
-  decantr theme list
-  decantr theme validate mytheme
-  decantr theme import ./external-theme.json
-`);
-    return;
-  }
-  switch (subcommand) {
-    case "create": {
-      const name = args[1];
-      if (!name) {
-        console.error(error("Usage: decantr theme create <name>"));
-        process.exitCode = 1;
-        return;
-      }
-      const displayName = name.charAt(0).toUpperCase() + name.slice(1).replace(/-/g, " ");
-      const result = createTheme(projectRoot, name, displayName);
-      if (result.success) {
-        console.log(success(`Created custom theme "${name}"`));
-        console.log(dim(`  Path: ${result.path}`));
-        console.log("");
-        console.log(`Use in essence: ${cyan(`"style": "custom:${name}"`)}`);
-      } else {
-        console.error(error(result.error || "Failed to create theme"));
-        process.exitCode = 1;
-      }
-      break;
-    }
-    case "list": {
-      const themes = listCustomThemes(projectRoot);
-      if (themes.length === 0) {
-        console.log(dim("No custom themes found."));
-        console.log(dim('Run "decantr theme create <name>" to create one.'));
-      } else {
-        console.log(heading(`${themes.length} custom theme(s)`));
-        for (const theme of themes) {
-          console.log(`  ${cyan(`custom:${theme.id}`)}  ${dim(theme.description || theme.name)}`);
-        }
-      }
-      break;
-    }
-    case "validate": {
-      const name = args[1];
-      if (!name) {
-        console.error(error("Usage: decantr theme validate <name>"));
-        process.exitCode = 1;
-        return;
-      }
-      const themePath = join4(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
-      if (!existsSync4(themePath)) {
-        console.error(error(`Theme "${name}" not found at ${themePath}`));
-        process.exitCode = 1;
-        return;
-      }
-      try {
-        const theme = JSON.parse(readFileSync4(themePath, "utf-8"));
-        const result = validateCustomTheme(theme);
-        if (result.valid) {
-          console.log(success(`Custom theme "${name}" is valid`));
-        } else {
-          console.error(error("Validation failed:"));
-          for (const err of result.errors) {
-            console.error(`  ${RED}${err}${RESET2}`);
-          }
-          process.exitCode = 1;
-        }
-      } catch (e) {
-        console.error(error(`Invalid JSON: ${e.message}`));
-        process.exitCode = 1;
-      }
-      break;
-    }
-    case "delete": {
-      const name = args[1];
-      if (!name) {
-        console.error(error("Usage: decantr theme delete <name>"));
-        process.exitCode = 1;
-        return;
-      }
-      const result = deleteTheme(projectRoot, name);
-      if (result.success) {
-        console.log(success(`Deleted custom theme "${name}"`));
-      } else {
-        console.error(error(result.error || "Failed to delete theme"));
-        process.exitCode = 1;
-      }
-      break;
-    }
-    case "import": {
-      const sourcePath = args[1];
-      if (!sourcePath) {
-        console.error(error("Usage: decantr theme import <path>"));
-        process.exitCode = 1;
-        return;
-      }
-      const result = importTheme(projectRoot, sourcePath);
-      if (result.success) {
-        console.log(success("Theme imported successfully"));
-        console.log(dim(`  Path: ${result.path}`));
-      } else {
-        console.error(error("Import failed:"));
-        for (const err of result.errors || []) {
-          console.error(`  ${RED}${err}${RESET2}`);
-        }
-        process.exitCode = 1;
-      }
-      break;
-    }
-    default:
-      console.error(error(`Unknown theme command: ${subcommand}`));
-      process.exitCode = 1;
-  }
-}
-function cmdHelp() {
-  console.log(`
-${BOLD2}decantr${RESET2} \u2014 Design intelligence for AI-generated UI
-
-${BOLD2}Usage:${RESET2}
-  decantr init [options]
-  decantr status
-  decantr sync
-  decantr audit
-  decantr search <query> [--type <type>]
-  decantr suggest <query> [--type <type>]
-  decantr get <type> <id>
-  decantr list <type>
-  decantr validate [path]
-  decantr theme <subcommand>
-  decantr help
-
-${BOLD2}Init Options:${RESET2}
-  --blueprint, -b    Blueprint ID
-  --theme            Theme ID
-  --mode             Color mode: dark | light | auto
-  --shape            Border shape: pill | rounded | sharp
-  --target           Framework: react | vue | svelte | nextjs | html
-  --guard            Guard mode: creative | guided | strict
-  --density          Spacing: compact | comfortable | spacious
-  --shell            Default shell layout
-  --existing         Initialize in existing project
-  --offline          Force offline mode
-  --yes, -y          Accept defaults, skip confirmations
-  --registry         Custom registry URL
-
-${BOLD2}Commands:${RESET2}
-  ${cyan("init")}      Initialize a new Decantr project with full scaffolding
-  ${cyan("status")}    Show project status and sync state
-  ${cyan("sync")}      Sync registry content from API
-  ${cyan("audit")}     Validate essence and check for drift
-  ${cyan("search")}    Search the registry
-  ${cyan("suggest")}   Suggest patterns or alternatives for a query
-  ${cyan("get")}       Get full details of a registry item
-  ${cyan("list")}      List items by type
-  ${cyan("validate")}  Validate essence file
-  ${cyan("theme")}     Manage custom themes (create, list, validate, delete, import)
-  ${cyan("help")}      Show this help
-
-${BOLD2}Examples:${RESET2}
-  decantr init
-  decantr init --blueprint=saas-dashboard --theme=luminarum --yes
-  decantr status
-  decantr sync
-  decantr audit
-  decantr search dashboard
-  decantr suggest leaderboard
-  decantr suggest ranking --type pattern
-  decantr list patterns
-`);
-}
-async function main() {
-  const args = process.argv.slice(2);
-  const command = args[0];
-  if (!command || command === "help" || command === "--help" || command === "-h") {
-    cmdHelp();
-    return;
-  }
-  switch (command) {
-    case "init": {
-      const initArgs = {};
-      for (let i = 1; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === "--yes" || arg === "-y") {
-          initArgs.yes = true;
-        } else if (arg === "--offline") {
-          initArgs.offline = true;
-        } else if (arg === "--existing") {
-          initArgs.existing = true;
-        } else if (arg.startsWith("--")) {
-          const [key, value] = arg.slice(2).split("=");
-          if (value) {
-            initArgs[key] = value;
-          } else if (args[i + 1] && !args[i + 1].startsWith("-")) {
-            initArgs[key] = args[++i];
-          }
-        } else if (arg.startsWith("-")) {
-          const key = arg.slice(1);
-          if (key === "b" && args[i + 1]) initArgs.blueprint = args[++i];
-          if (key === "y") initArgs.yes = true;
-        }
-      }
-      await cmdInit(initArgs);
-      break;
-    }
-    case "status": {
-      await cmdStatus();
-      break;
-    }
-    case "sync": {
-      await cmdSync();
-      break;
-    }
-    case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-FWICWIQW.js");
-      await cmdUpgrade(process.cwd());
-      break;
-    }
-    case "heal": {
-      const { cmdHeal } = await import("./heal-2OPN63OT.js");
-      await cmdHeal(process.cwd());
-      break;
-    }
-    case "audit": {
-      await cmdAudit();
-      break;
-    }
-    case "search": {
-      const query = args[1];
-      if (!query) {
-        console.error(error("Usage: decantr search <query> [--type <type>]"));
-        process.exitCode = 1;
-        return;
-      }
-      const typeIdx = args.indexOf("--type");
-      const type = typeIdx !== -1 ? args[typeIdx + 1] : void 0;
-      await cmdSearch(query, type);
-      break;
-    }
-    case "suggest": {
-      const query = args[1];
-      if (!query) {
-        console.error(error("Usage: decantr suggest <query> [--type <type>]"));
-        process.exitCode = 1;
-        return;
-      }
-      const typeIdx = args.indexOf("--type");
-      const type = typeIdx !== -1 ? args[typeIdx + 1] : void 0;
-      await cmdSuggest(query, type);
-      break;
-    }
-    case "get": {
-      const type = args[1];
-      const id = args[2];
-      if (!type || !id) {
-        console.error(error("Usage: decantr get <type> <id>"));
-        process.exitCode = 1;
-        return;
-      }
-      await cmdGet(type, id);
-      break;
-    }
-    case "list": {
-      const type = args[1];
-      if (!type) {
-        console.error(error("Usage: decantr list <type>"));
-        process.exitCode = 1;
-        return;
-      }
-      await cmdList(type);
-      break;
-    }
-    case "validate": {
-      await cmdValidate(args[1]);
-      break;
-    }
-    case "theme": {
-      await cmdTheme(args.slice(1));
-      break;
-    }
-    default:
-      console.error(error(`Unknown command: ${command}`));
-      cmdHelp();
-      process.exitCode = 1;
-  }
-}
-main().catch((e) => {
-  console.error(error(e.message));
-  process.exitCode = 1;
-});
+import "./chunk-LXOY447U.js";
+import "./chunk-CT5XHG6I.js";
+import "./chunk-3RG5ZIWI.js";