@decantr/cli 1.2.0 → 1.4.0

package/dist/{chunk-2F6Q5S5W.js → chunk-OTVIAUQG.js}

@@ -1,12 +1,20 @@
 import {
   RegistryClient,
+  composeArchetypes,
+  composeSections,
+  deriveTransitions,
+  deriveZones,
+  generateTopologySection,
+  refreshDerivedFiles,
+  scaffoldMinimal,
+  scaffoldProject,
   syncRegistry
-} from "./chunk-CT5XHG6I.js";
+} from "./chunk-ZQ5FTYKG.js";
 
 // src/index.ts
-import { readFileSync as readFileSync15, existsSync as existsSync20, readdirSync as readdirSync6 } from "fs";
-import { join as join20, dirname as dirname2 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { readFileSync as readFileSync14, existsSync as existsSync19, readdirSync as readdirSync6 } from "fs";
+import { join as join19, dirname } from "path";
+import { fileURLToPath } from "url";
 import { validateEssence as validateEssence2, evaluateGuard, isV3 as isV36 } from "@decantr/essence-spec";
 import { RegistryAPIClient as RegistryAPIClient2 } from "@decantr/registry";
 
@@ -384,1801 +392,9 @@ async function runSimplifiedInit(blueprints) {
   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));
-function composeArchetypes(composeEntries, archetypeResults) {
-  if (composeEntries.length === 0) {
-    return {
-      pages: [{ id: "home", layout: ["hero"] }],
-      features: [],
-      defaultShell: "sidebar-main"
-    };
-  }
-  const allPages = [];
-  const allFeatures = [];
-  let defaultShell = "sidebar-main";
-  for (let i = 0; i < composeEntries.length; i++) {
-    const entry = composeEntries[i];
-    const archetypeId = typeof entry === "string" ? entry : entry.archetype;
-    const data = archetypeResults.get(archetypeId);
-    if (!data?.pages) continue;
-    const isPrimary = i === 0;
-    if (isPrimary) {
-      defaultShell = data.pages[0]?.shell || defaultShell;
-      for (const page of data.pages) {
-        allPages.push({
-          id: page.id,
-          layout: page.default_layout?.length ? page.default_layout : ["hero"],
-          ...page.shell !== defaultShell ? { shell_override: page.shell } : {}
-        });
-      }
-    } else {
-      const prefix = typeof entry === "string" ? entry : entry.prefix;
-      for (const page of data.pages) {
-        allPages.push({
-          id: `${prefix}-${page.id}`,
-          layout: page.default_layout?.length ? page.default_layout : ["hero"],
-          ...page.shell !== defaultShell ? { shell_override: page.shell } : {}
-        });
-      }
-    }
-    if (data.features) {
-      allFeatures.push(...data.features);
-    }
-  }
-  if (allPages.length === 0) {
-    allPages.push({ id: "home", layout: ["hero"] });
-  }
-  return {
-    pages: allPages,
-    features: [...new Set(allFeatures)],
-    defaultShell
-  };
-}
-function composeSections(composeEntries, archetypeResults, overrides) {
-  if (composeEntries.length === 0) {
-    return {
-      sections: [{
-        id: "default",
-        role: "primary",
-        shell: "sidebar-main",
-        features: [],
-        description: "Default section",
-        pages: [{ id: "home", layout: ["hero"] }]
-      }],
-      features: [],
-      defaultShell: "sidebar-main"
-    };
-  }
-  const sections = [];
-  const allFeatures = [];
-  let defaultShell = "sidebar-main";
-  const pagesRemoveSet = new Set(overrides?.pages_remove ?? []);
-  for (let i = 0; i < composeEntries.length; i++) {
-    const entry = composeEntries[i];
-    const archetypeId = typeof entry === "string" ? entry : entry.archetype;
-    const data = archetypeResults.get(archetypeId);
-    if (!data?.pages) continue;
-    const isPrimary = i === 0;
-    if (isPrimary) {
-      defaultShell = data.pages[0]?.shell || defaultShell;
-    }
-    const pages = [];
-    for (const page of data.pages) {
-      if (pagesRemoveSet.has(page.id)) continue;
-      const overriddenPage = overrides?.pages?.[page.id];
-      pages.push({
-        id: page.id,
-        layout: page.default_layout?.length ? page.default_layout : ["hero"],
-        ...overriddenPage
-      });
-    }
-    sections.push({
-      id: archetypeId,
-      role: data.role ?? "primary",
-      shell: data.pages[0]?.shell || "sidebar-main",
-      features: data.features ?? [],
-      description: data.description ?? "",
-      pages
-    });
-    if (data.features) {
-      allFeatures.push(...data.features);
-    }
-  }
-  if (sections.length === 0) {
-    sections.push({
-      id: "default",
-      role: "primary",
-      shell: "sidebar-main",
-      features: [],
-      description: "Default section",
-      pages: [{ id: "home", layout: ["hero"] }]
-    });
-  }
-  let features = [...new Set(allFeatures)];
-  if (overrides?.features_add) {
-    for (const f of overrides.features_add) {
-      if (!features.includes(f)) features.push(f);
-    }
-  }
-  if (overrides?.features_remove) {
-    const removeSet = new Set(overrides.features_remove);
-    features = features.filter((f) => !removeSet.has(f));
-  }
-  return { sections, features, defaultShell };
-}
-var ZONE_ORDER = ["public", "gateway", "primary", "auxiliary"];
-function deriveZones(inputs) {
-  const zoneMap = /* @__PURE__ */ new Map();
-  for (const input of inputs) {
-    const existing = zoneMap.get(input.role);
-    if (existing) {
-      existing.archetypes.push(input.archetypeId);
-      existing.features.push(...input.features);
-      existing.descriptions.push(input.description);
-    } else {
-      zoneMap.set(input.role, {
-        role: input.role,
-        archetypes: [input.archetypeId],
-        shell: input.shell,
-        features: [...input.features],
-        descriptions: [input.description]
-      });
-    }
-  }
-  for (const zone of zoneMap.values()) {
-    zone.features = [...new Set(zone.features)];
-  }
-  return ZONE_ORDER.filter((role) => zoneMap.has(role)).map((role) => zoneMap.get(role));
-}
-var GATEWAY_TRIGGER_MAP = {
-  auth: "authentication",
-  login: "authentication",
-  mfa: "authentication",
-  payment: "payment",
-  subscription: "payment",
-  checkout: "payment",
-  onboarding: "onboarding",
-  "setup-wizard": "onboarding",
-  welcome: "onboarding",
-  invite: "invitation",
-  "access-code": "invitation"
-};
-function resolveGatewayTrigger(features) {
-  for (const feature of features) {
-    const trigger = GATEWAY_TRIGGER_MAP[feature];
-    if (trigger) return trigger;
-  }
-  return "authentication";
-}
-function deriveTransitions(zones) {
-  const transitions = [];
-  const roles = new Set(zones.map((z) => z.role));
-  const gateway = zones.find((z) => z.role === "gateway");
-  const gatewayTrigger = gateway ? resolveGatewayTrigger(gateway.features) : "authentication";
-  const hasApp = roles.has("primary") || roles.has("auxiliary");
-  const hasGateway = roles.has("gateway");
-  const hasPublic = roles.has("public");
-  if (hasPublic && hasGateway) {
-    transitions.push({ from: "public", to: "gateway", type: "conversion", trigger: gatewayTrigger });
-  }
-  if (hasPublic && hasApp && !hasGateway) {
-    transitions.push({ from: "public", to: "app", type: "conversion", trigger: "navigation" });
-  }
-  if (hasGateway && hasApp) {
-    transitions.push({ from: "gateway", to: "app", type: "gate-pass", trigger: gatewayTrigger });
-    transitions.push({ from: "app", to: "gateway", type: "gate-return", trigger: gatewayTrigger });
-  }
-  if (hasApp && hasPublic) {
-    transitions.push({ from: "app", to: "public", type: "navigation", trigger: "external" });
-  }
-  return transitions;
-}
-var ZONE_LABELS = {
-  public: "Public",
-  gateway: "Gateway",
-  primary: "App",
-  auxiliary: "App (auxiliary)"
-};
-function generateTopologySection(data, personality) {
-  const lines = [];
-  lines.push("## Composition Topology");
-  lines.push("");
-  lines.push(`**Intent:** ${data.intent}`);
-  lines.push("");
-  lines.push("### Zones");
-  lines.push("");
-  for (const zone of data.zones) {
-    const label = ZONE_LABELS[zone.role] || zone.role;
-    lines.push(`**${label}** \u2014 ${zone.shell} shell`);
-    lines.push(`  Archetypes: ${zone.archetypes.join(", ")}`);
-    lines.push(`  Purpose: ${zone.descriptions.join(" ")}`);
-    if (personality.length > 0) {
-      lines.push(`  Tone: ${personality.join(", ")}`);
-    }
-    if (zone.features.length > 0) {
-      lines.push(`  Features: ${zone.features.join(", ")}`);
-    }
-    lines.push("");
-  }
-  if (data.transitions.length > 0) {
-    lines.push("### Zone Transitions");
-    lines.push("");
-    for (const t of data.transitions) {
-      const fromLabel = t.from.charAt(0).toUpperCase() + t.from.slice(1);
-      const toLabel = t.to.charAt(0).toUpperCase() + t.to.slice(1);
-      lines.push(`  ${fromLabel} \u2192 ${toLabel}: ${t.type} (${t.trigger})`);
-    }
-    lines.push("");
-  }
-  lines.push("### Default Entry Points");
-  lines.push("");
-  lines.push(`  Anonymous users enter: ${data.entryPoints.anonymous}`);
-  lines.push(`  Authenticated users enter: ${data.entryPoints.authenticated}`);
-  lines.push(`  Auth redirect target: ${data.entryPoints.authenticated}`);
-  lines.push("");
-  return lines.join("\n");
-}
-var CLI_VERSION = "1.0.0";
-function generateTokensCSS(themeData, mode) {
-  if (!themeData) {
-    return `/* No theme data available */
-:root {
-  --d-primary: #6366f1;
-  --d-secondary: #a1a1aa;
-  --d-accent: #f59e0b;
-  --d-bg: #18181b;
-  --d-surface: #1f1f23;
-  --d-surface-raised: #27272a;
-  --d-border: #3f3f46;
-  --d-text: #fafafa;
-  --d-text-muted: #a1a1aa;
-}
-`;
-  }
-  const seed = themeData.seed || {};
-  const palette = themeData.palette || {};
-  const resolvedMode = mode === "auto" ? "dark" : mode;
-  function buildTokens(tokenMode) {
-    return {
-      // Seed colors
-      "--d-primary": seed.primary || "#6366f1",
-      "--d-secondary": seed.secondary || "#a1a1aa",
-      "--d-accent": seed.accent || "#f59e0b",
-      // Palette colors (mode-aware)
-      "--d-bg": palette.background?.[tokenMode] || "#18181b",
-      "--d-surface": palette.surface?.[tokenMode] || "#1f1f23",
-      "--d-surface-raised": palette["surface-raised"]?.[tokenMode] || "#27272a",
-      "--d-border": palette.border?.[tokenMode] || "#3f3f46",
-      "--d-text": palette.text?.[tokenMode] || "#fafafa",
-      "--d-text-muted": palette["text-muted"]?.[tokenMode] || "#a1a1aa",
-      "--d-primary-hover": palette["primary-hover"]?.[tokenMode] || seed.primary || "#6366f1",
-      // Spacing scale
-      "--d-gap-1": "0.25rem",
-      "--d-gap-2": "0.5rem",
-      "--d-gap-3": "0.75rem",
-      "--d-gap-4": "1rem",
-      "--d-gap-6": "1.5rem",
-      "--d-gap-8": "2rem",
-      "--d-gap-12": "3rem",
-      // Radii
-      "--d-radius": "0.5rem",
-      "--d-radius-sm": "0.25rem",
-      "--d-radius-lg": "0.75rem",
-      "--d-radius-xl": "1rem",
-      "--d-radius-full": "9999px",
-      // Shadows
-      "--d-shadow-sm": "0 1px 2px rgba(0,0,0,0.05)",
-      "--d-shadow": "0 1px 3px rgba(0,0,0,0.1)",
-      "--d-shadow-md": "0 4px 6px rgba(0,0,0,0.1)",
-      "--d-shadow-lg": "0 10px 15px rgba(0,0,0,0.1)",
-      // Status colors
-      "--d-success": themeData.tokens?.base?.success || "#22c55e",
-      "--d-error": themeData.tokens?.base?.danger || "#ef4444",
-      "--d-warning": themeData.tokens?.base?.warning || "#f59e0b",
-      "--d-info": "#3b82f6"
-    };
-  }
-  const tokens = buildTokens(resolvedMode);
-  const lines = Object.entries(tokens).map(([key, value]) => `  ${key}: ${value};`).join("\n");
-  let css = `/* Generated by @decantr/cli */
-:root {
-${lines}
-}
-`;
-  if (mode === "auto") {
-    const lightTokens = buildTokens("light");
-    const paletteKeys = ["--d-bg", "--d-surface", "--d-surface-raised", "--d-border", "--d-text", "--d-text-muted", "--d-primary-hover"];
-    const lightLines = Object.entries(lightTokens).filter(([key]) => paletteKeys.includes(key)).map(([key, value]) => `    ${key}: ${value};`).join("\n");
-    css += `
-@media (prefers-color-scheme: light) {
-  :root {
-${lightLines}
-  }
-}
-`;
-  }
-  return css;
-}
-function generateDecoratorsCSS(recipeData, themeName) {
-  if (!recipeData?.decorators) {
-    return `/* No recipe decorators available */`;
-  }
-  const decorators = recipeData.decorators;
-  const css = [
-    `/* Generated by @decantr/cli from recipe: ${themeName} */`,
-    ""
-  ];
-  for (const [name, description] of Object.entries(decorators)) {
-    css.push(generateDecoratorRule(name, description));
-    css.push("");
-  }
-  css.push(`/* Animation keyframes */
-@keyframes decantr-fade-in {
-  from { opacity: 0; transform: translateY(8px); }
-  to { opacity: 1; transform: translateY(0); }
-}
-
-@keyframes decantr-pulse {
-  0%, 100% { opacity: 1; }
-  50% { opacity: 0.5; }
-}
-`);
-  return css.join("\n");
-}
-function generateDecoratorRule(name, description) {
-  const rules = [];
-  const descLower = description.toLowerCase();
-  if (descLower.includes("surface background") || descLower.includes("surface elevation")) {
-    rules.push("background: var(--d-surface)");
-  } else if (descLower.includes("background") && descLower.includes("theme")) {
-    rules.push("background: var(--d-bg)");
-  } else if (descLower.includes("primary-tinted") || descLower.includes("primary background")) {
-    rules.push("background: color-mix(in srgb, var(--d-primary) 15%, var(--d-surface))");
-  }
-  if (descLower.includes("1px border") || descLower.includes("subtle border")) {
-    rules.push("border: 1px solid var(--d-border)");
-  } else if (descLower.includes("border") && !descLower.includes("radius")) {
-    rules.push("border: 1px solid var(--d-border)");
-  }
-  const radiusMatch = descLower.match(/(\d+)px radius/);
-  if (radiusMatch) {
-    rules.push(`border-radius: ${radiusMatch[1]}px`);
-  } else if (descLower.includes("radius") || descLower.includes("rounded")) {
-    rules.push("border-radius: var(--d-radius)");
-  }
-  if (descLower.includes("hover shadow") || descLower.includes("shadow transition")) {
-    rules.push("transition: box-shadow 0.15s ease");
-  }
-  if (descLower.includes("elevation") || descLower.includes("shadow")) {
-    rules.push("box-shadow: var(--d-shadow)");
-  }
-  if (descLower.includes("entrance animation") || descLower.includes("fade")) {
-    rules.push("animation: decantr-fade-in 0.2s ease-out");
-  }
-  if (descLower.includes("pulse animation") || descLower.includes("skeleton")) {
-    rules.push("animation: decantr-pulse 1.5s ease-in-out infinite");
-  }
-  if (descLower.includes("blur") || descLower.includes("glass")) {
-    rules.push("backdrop-filter: blur(8px)");
-  }
-  if (descLower.includes("right-aligned")) {
-    rules.push("margin-left: auto");
-  } else if (descLower.includes("left-aligned")) {
-    rules.push("margin-right: auto");
-  }
-  if (descLower.includes("message bubble") || descLower.includes("bubble")) {
-    rules.push("padding: var(--d-gap-3) var(--d-gap-4)");
-    rules.push("border-radius: var(--d-radius-lg)");
-    rules.push("max-width: 80%");
-  }
-  if (rules.length === 0) {
-    return `/* .${name}: ${description} */`;
-  }
-  return `.${name} {
-  ${rules.join(";\n  ")};
-}`;
-}
-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 buildEssenceV3(options, archetypeData, themeHints, recipeHints) {
-  let pages = [
-    { id: "home", layout: ["hero"] }
-  ];
-  let features = options.features;
-  let defaultShell = options.shell || "sidebar-main";
-  if (archetypeData?.pages) {
-    defaultShell = archetypeData.pages[0]?.shell || defaultShell;
-    pages = archetypeData.pages.map((p) => {
-      const resolvedLayout = (p.default_layout?.length ? p.default_layout : ["hero"]).map((item) => resolvePatternAlias(item, p.patterns));
-      return {
-        id: p.id,
-        ...p.shell !== defaultShell ? { shell_override: p.shell } : {},
-        layout: resolvedLayout
-      };
-    });
-  }
-  if (archetypeData?.features) {
-    features = [.../* @__PURE__ */ new Set([...features, ...archetypeData.features])];
-  }
-  const densityLevelMap = {
-    compact: "_gap2",
-    comfortable: "_gap4",
-    spacious: "_gap6"
-  };
-  const shapeRadiusMap = {
-    pill: 12,
-    rounded: 8,
-    sharp: 2
-  };
-  const guardModeMap = {
-    strict: { mode: "strict", dna_enforcement: "error", blueprint_enforcement: "warn" },
-    guided: { mode: "guided", dna_enforcement: "error", blueprint_enforcement: "off" },
-    creative: { mode: "creative", dna_enforcement: "off", blueprint_enforcement: "off" }
-  };
-  const dna = {
-    theme: {
-      style: options.theme,
-      mode: options.mode,
-      recipe: options.theme,
-      shape: options.shape
-    },
-    spacing: {
-      base_unit: 4,
-      scale: "linear",
-      density: options.density,
-      content_gap: densityLevelMap[options.density] || "_gap4"
-    },
-    typography: {
-      scale: themeHints?.typography_hints?.scale || "modular",
-      heading_weight: themeHints?.typography_hints?.heading_weight || 600,
-      body_weight: themeHints?.typography_hints?.body_weight || 400
-    },
-    color: {
-      palette: "semantic",
-      accent_count: 1,
-      cvd_preference: options.accessibility?.cvd_preference || "auto"
-    },
-    radius: {
-      philosophy: recipeHints?.radius_hints?.philosophy || options.shape,
-      base: recipeHints?.radius_hints?.base || shapeRadiusMap[options.shape] || 8
-    },
-    elevation: {
-      system: "layered",
-      max_levels: 3
-    },
-    motion: {
-      preference: recipeHints?.animation?.preference || themeHints?.motion_hints?.preference || "subtle",
-      duration_scale: 1,
-      reduce_motion: themeHints?.motion_hints?.reduce_motion_default ?? true
-    },
-    accessibility: {
-      wcag_level: options.accessibility?.wcag_level || "AA",
-      focus_visible: true,
-      skip_nav: true
-    },
-    personality: options.personality
-  };
-  const blueprint = {
-    shell: defaultShell,
-    pages,
-    features
-  };
-  const meta = {
-    archetype: options.archetype || "custom",
-    target: options.target,
-    platform: {
-      type: "spa",
-      routing: "hash"
-    },
-    guard: guardModeMap[options.guard] || guardModeMap.guided
-  };
-  return {
-    version: "3.0.0",
-    dna,
-    blueprint,
-    meta
-  };
-}
-var CSS_APPROACH_CONTENT = `## CSS Implementation
-
-This project uses **@decantr/css** for layout atoms and the generated CSS files for theme tokens and recipe decorators.
-
-### Setup
-
-\`\`\`javascript
-// 1. Import the atoms runtime
-import { css } from '@decantr/css';
-
-// 2. Import generated CSS files (created by decantr init)
-import './styles/tokens.css';      // Theme tokens (--d-primary, --d-surface, etc.)
-import './styles/decorators.css';  // Recipe decorators
-\`\`\`
-
-### Using Atoms
-
-The \`css()\` function processes atom strings and injects CSS at runtime:
-
-\`\`\`jsx
-// Layout atoms
-<div className={css('_flex _col _gap4 _p4')}>
-  <h1 className={css('_heading1')}>Title</h1>
-  <p className={css('_textsm _fgmuted')}>Description</p>
-</div>
-
-// Responsive prefixes (mobile-first)
-<div className={css('_gc1 _sm:gc2 _lg:gc4')}>
-  {/* 1 col -> 2 cols at 640px -> 4 cols at 1024px */}
-</div>
-\`\`\`
-
-### Atom Reference
-
-#### Display
-| Atom | CSS |
-|------|-----|
-| \`_flex\` | \`display:flex\` |
-| \`_grid\` | \`display:grid\` |
-| \`_block\` | \`display:block\` |
-| \`_inline\` | \`display:inline\` |
-| \`_inlineflex\` | \`display:inline-flex\` |
-| \`_none\` | \`display:none\` |
-| \`_contents\` | \`display:contents\` |
-
-#### Flexbox
-| Atom | CSS |
-|------|-----|
-| \`_col\` | \`flex-direction:column\` |
-| \`_row\` | \`flex-direction:row\` |
-| \`_colrev\` | \`flex-direction:column-reverse\` |
-| \`_wrap\` | \`flex-wrap:wrap\` |
-| \`_nowrap\` | \`flex-wrap:nowrap\` |
-| \`_flex1\` | \`flex:1\` |
-| \`_flex0\` | \`flex:none\` |
-| \`_flexauto\` | \`flex:auto\` |
-| \`_grow\` | \`flex-grow:1\` |
-| \`_grow0\` | \`flex-grow:0\` |
-| \`_shrink0\` | \`flex-shrink:0\` |
-
-#### Alignment
-| Atom | CSS |
-|------|-----|
-| \`_aic\` | \`align-items:center\` |
-| \`_aifs\` | \`align-items:flex-start\` |
-| \`_aife\` | \`align-items:flex-end\` |
-| \`_aist\` | \`align-items:stretch\` |
-| \`_aibl\` | \`align-items:baseline\` |
-| \`_jcc\` | \`justify-content:center\` |
-| \`_jcfs\` | \`justify-content:flex-start\` |
-| \`_jcfe\` | \`justify-content:flex-end\` |
-| \`_jcsb\` | \`justify-content:space-between\` |
-| \`_jcsa\` | \`justify-content:space-around\` |
-| \`_jcse\` | \`justify-content:space-evenly\` |
-| \`_pic\` | \`place-items:center\` |
-| \`_pcc\` | \`place-content:center\` |
-
-#### Spacing (scale: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24, ...)
-| Atom | CSS | Notes |
-|------|-----|-------|
-| \`_gap{n}\` | \`gap:{scale}\` | e.g. \`_gap4\` = \`gap:1rem\` |
-| \`_gx{n}\` | \`column-gap:{scale}\` | horizontal gap |
-| \`_gy{n}\` | \`row-gap:{scale}\` | vertical gap |
-| \`_p{n}\` | \`padding:{scale}\` | all sides |
-| \`_pt{n}\`, \`_pr{n}\`, \`_pb{n}\`, \`_pl{n}\` | directional padding | top/right/bottom/left |
-| \`_px{n}\` | \`padding-inline:{scale}\` | horizontal |
-| \`_py{n}\` | \`padding-block:{scale}\` | vertical |
-| \`_m{n}\` | \`margin:{scale}\` | same as padding variants |
-| \`_mx{n}\`, \`_my{n}\` | inline/block margin | horizontal/vertical |
-
-#### Sizing
-| Atom | CSS |
-|------|-----|
-| \`_wfull\` / \`_w100\` | \`width:100%\` |
-| \`_hfull\` / \`_h100\` | \`height:100%\` |
-| \`_wscreen\` | \`width:100vw\` |
-| \`_hscreen\` | \`height:100vh\` |
-| \`_wfit\` | \`width:fit-content\` |
-| \`_hfit\` | \`height:fit-content\` |
-| \`_wauto\` | \`width:auto\` |
-| \`_minw0\` | \`min-width:0\` |
-| \`_minh0\` | \`min-height:0\` |
-| \`_w{n}\`, \`_h{n}\` | width/height from spacing scale |
-| \`_minw{n}\`, \`_maxw{n}\` | min/max width from scale |
-
-#### Text Size
-| Atom | Size | Line-height |
-|------|------|-------------|
-| \`_textxs\` | 0.75rem | 1rem |
-| \`_textsm\` | 0.875rem | 1.25rem |
-| \`_textbase\` | 1rem | 1.5rem |
-| \`_textlg\` | 1.125rem | 1.75rem |
-| \`_textxl\` | 1.25rem | 1.75rem |
-| \`_text2xl\` | 1.5rem | 2rem |
-| \`_text3xl\` | 1.875rem | 2.25rem |
-| \`_heading1\`-\`_heading6\` | Heading presets (size + weight) |
-
-#### Text Style
-| Atom | CSS |
-|------|-----|
-| \`_fontbold\` | \`font-weight:700\` |
-| \`_fontsemi\` | \`font-weight:600\` |
-| \`_fontmedium\` | \`font-weight:500\` |
-| \`_fontlight\` | \`font-weight:300\` |
-| \`_italic\` | \`font-style:italic\` |
-| \`_underline\` | \`text-decoration:underline\` |
-| \`_uppercase\` | \`text-transform:uppercase\` |
-| \`_truncate\` | overflow ellipsis + nowrap |
-| \`_textl\`, \`_textc\`, \`_textr\` | text-align left/center/right |
-
-#### Color (theme variable based)
-| Atom | CSS |
-|------|-----|
-| \`_bgprimary\` | \`background:var(--d-primary)\` |
-| \`_bgsurface\` | \`background:var(--d-surface)\` |
-| \`_bgsurface0\`-\`_bgsurface2\` | surface elevation layers |
-| \`_bgmuted\` | \`background:var(--d-muted)\` |
-| \`_bgbg\` | \`background:var(--d-bg)\` |
-| \`_bgsuccess\`, \`_bgerror\`, \`_bgwarning\`, \`_bginfo\` | status backgrounds |
-| \`_fgprimary\` | \`color:var(--d-primary)\` |
-| \`_fgtext\` | \`color:var(--d-text)\` |
-| \`_fgmuted\` | \`color:var(--d-text-muted)\` |
-| \`_fgsuccess\`, \`_fgerror\`, \`_fgwarning\`, \`_fginfo\` | status text |
-| \`_bcborder\` | \`border-color:var(--d-border)\` |
-
-#### Overflow & Whitespace
-| Atom | CSS |
-|------|-----|
-| \`_overhidden\` | \`overflow:hidden\` |
-| \`_overauto\` | \`overflow:auto\` |
-| \`_overscroll\` | \`overflow:scroll\` |
-| \`_overxauto\`, \`_overyauto\` | axis-specific overflow |
-| \`_nowraptext\` | \`white-space:nowrap\` |
-| \`_prewrap\` | \`white-space:pre-wrap\` |
-| \`_breakword\` | \`overflow-wrap:break-word\` |
-
-#### Cursor & Interaction
-| Atom | CSS |
-|------|-----|
-| \`_pointer\` | \`cursor:pointer\` |
-| \`_cursordefault\` | \`cursor:default\` |
-| \`_notallowed\` | \`cursor:not-allowed\` |
-| \`_grab\` | \`cursor:grab\` |
-| \`_selectnone\` | \`user-select:none\` |
-| \`_ptrnone\` | \`pointer-events:none\` |
-
-#### Position & Layout
-| Atom | CSS |
-|------|-----|
-| \`_rel\` | \`position:relative\` |
-| \`_abs\` | \`position:absolute\` |
-| \`_fixed\` | \`position:fixed\` |
-| \`_sticky\` | \`position:sticky\` |
-| \`_inset0\` | \`inset:0\` |
-| \`_top0\`, \`_right0\`, \`_bottom0\`, \`_left0\` | edge positioning |
-| \`_z10\`-\`_z50\` | z-index scale |
-
-#### Grid
-| Atom | CSS |
-|------|-----|
-| \`_gc1\`-\`_gc12\` | \`grid-template-columns:repeat(N,...)\` |
-| \`_gr1\`-\`_gr6\` | \`grid-template-rows:repeat(N,...)\` |
-| \`_span1\`-\`_span12\`, \`_spanfull\` | column span |
-| \`_rowspan1\`-\`_rowspan6\` | row span |
-
-#### Visual
-| Atom | CSS |
-|------|-----|
-| \`_rounded\` | \`border-radius:var(--d-radius)\` |
-| \`_roundedfull\` | \`border-radius:9999px\` |
-| \`_roundedsm\`, \`_roundedlg\`, \`_roundedxl\` | radius variants |
-| \`_shadow\`, \`_shadowmd\`, \`_shadowlg\` | box-shadow presets |
-| \`_bordernone\` | \`border:none\` |
-| \`_bw{n}\` | \`border-width:{n}px\` |
-| \`_op0\`-\`_op100\` | opacity (0, 25, 50, 75, 100) |
-| \`_trans\` | \`transition:all 0.15s ease\` |
-| \`_visible\`, \`_invisible\` | visibility |
-
-### CSS Architecture
-
-The CSS is organized into two parts:
-
-1. **Atoms (@decantr/css)** - Layout utilities injected at runtime into \`@layer d.atoms\`
-2. **Generated CSS files** - Theme tokens and recipe decorators created during scaffold
-
-\`\`\`
-src/styles/
-  tokens.css      # :root { --d-primary: #...; --d-surface: #...; }
-  decorators.css  # .recipe-card { ... }
-\`\`\`
-
-### Variable Naming Convention
-
-| Prefix | Purpose | Example |
-|--------|---------|---------|
-| \`--d-\` | Core Decantr tokens | \`--d-primary\`, \`--d-bg\` |
-| \`--d-gap-{n}\` | Spacing tokens | \`--d-gap-4\`, \`--d-gap-8\` |
-| \`--d-radius\` | Border radius | \`--d-radius\`, \`--d-radius-lg\` |`;
-function generateDecantrMdV31(guardMode, cssApproach) {
-  const template = loadTemplate("DECANTR.md.template");
-  return renderTemplate(template, {
-    GUARD_MODE: guardMode,
-    CSS_APPROACH: cssApproach
-  });
-}
-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 dnaEnforcement = essence.guard.enforce_style ? "error" : "off";
-  const blueprintEnforcement = essence.guard.enforce_recipe ? "warn" : "off";
-  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),
-    DNA_ENFORCEMENT: dnaEnforcement,
-    BLUEPRINT_ENFORCEMENT: blueprintEnforcement,
-    DENSITY: essence.density.level,
-    CONTENT_GAP: essence.density.content_gap,
-    LAST_UPDATED: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  return renderTemplate(template, vars);
-}
-function generateEssenceSummaryV3(essence) {
-  const template = loadTemplate("essence-summary.md.template");
-  const blueprint = essence.blueprint;
-  const sections = blueprint.sections || [];
-  const flatPages = blueprint.pages || [];
-  let pagesTable;
-  if (sections.length > 0) {
-    const rows = sections.flatMap(
-      (s) => s.pages.map((p) => `| ${p.id} | ${s.shell} | ${p.layout.map(serializeLayoutItem).join(", ") || "none"} |`)
-    );
-    pagesTable = `| Page | Shell | Layout |
-|------|-------|--------|
-${rows.join("\n")}`;
-  } else {
-    const shell = blueprint.shell ?? "sidebar-main";
-    const rows = flatPages.map((p) => `| ${p.id} | ${shell} | ${p.layout.map(serializeLayoutItem).join(", ") || "none"} |`);
-    pagesTable = `| Page | Shell | Layout |
-|------|-------|--------|
-${rows.join("\n")}`;
-  }
-  const features = blueprint.features || [];
-  const featuresList = features.length > 0 ? features.map((f) => `- ${f}`).join("\n") : "- No features specified";
-  const vars = {
-    ARCHETYPE: essence.meta.archetype || "custom",
-    BLUEPRINT: "",
-    PERSONALITY: (essence.dna.personality || []).join(", "),
-    TARGET: essence.meta.target ?? "",
-    THEME_STYLE: essence.dna.theme.style,
-    THEME_MODE: essence.dna.theme.mode,
-    THEME_RECIPE: essence.dna.theme.recipe ?? "",
-    SHAPE: essence.dna.theme.shape ?? "",
-    PAGES_TABLE: pagesTable,
-    FEATURES_LIST: featuresList,
-    GUARD_MODE: essence.meta.guard.mode,
-    ENFORCE_STYLE: essence.meta.guard.dna_enforcement || "error",
-    ENFORCE_RECIPE: essence.meta.guard.blueprint_enforcement || "warn",
-    DNA_ENFORCEMENT: essence.meta.guard.dna_enforcement || "error",
-    BLUEPRINT_ENFORCEMENT: essence.meta.guard.blueprint_enforcement || "warn",
-    DENSITY: essence.dna.spacing?.density || "comfortable",
-    CONTENT_GAP: essence.dna.spacing?.content_gap || "_gap4",
-    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;
-  }
-}
-async function scaffoldProject(projectRoot, options, detected, registry, archetypeData, registrySource = "cache", themeData, recipeData, topologyMarkdown, composedSections, routeMap, patternSpecs, blueprintData) {
-  const essenceV3 = buildEssenceV3(options, archetypeData, 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(essenceV3, null, 2) + "\n");
-  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);
-  if (composedSections) {
-    essenceV3.version = "3.1.0";
-    essenceV3.blueprint = {
-      sections: composedSections.sections,
-      features: composedSections.features,
-      routes: routeMap || {}
-    };
-    if (blueprintData?.personality?.length) {
-      essenceV3.dna.personality = blueprintData.personality;
-    }
-    if (blueprintData?.design_constraints) {
-      essenceV3.dna.constraints = blueprintData.design_constraints;
-    }
-    if (blueprintData?.seo_hints) {
-      essenceV3.meta.seo = blueprintData.seo_hints;
-    }
-    if (blueprintData?.navigation) {
-      essenceV3.meta.navigation = blueprintData.navigation;
-    }
-    writeFileSync(essencePath, JSON.stringify(essenceV3, null, 2) + "\n");
-  }
-  const refreshResult = await refreshDerivedFiles(projectRoot, essenceV3, registry);
-  contextFiles.push(...refreshResult.contextFiles);
-  const gitignoreUpdated = updateGitignore(projectRoot);
-  return {
-    essencePath,
-    decantrMdPath: refreshResult.decantrMdPath,
-    projectJsonPath,
-    contextFiles,
-    cssFiles: refreshResult.cssFiles,
-    gitignoreUpdated
-  };
-}
-function scaffoldMinimal(projectRoot) {
-  const decantrDir = join2(projectRoot, ".decantr");
-  const customDir = join2(decantrDir, "custom");
-  const contentTypes = ["patterns", "recipes", "themes", "blueprints", "archetypes", "shells"];
-  for (const type of contentTypes) {
-    mkdirSync(join2(customDir, type), { recursive: true });
-  }
-  const essence = {
-    version: "3.0.0",
-    dna: {
-      theme: {
-        style: "default",
-        mode: "dark",
-        recipe: "default",
-        shape: "rounded"
-      },
-      spacing: {
-        base_unit: 4,
-        scale: "linear",
-        density: "comfortable",
-        content_gap: "_gap4"
-      },
-      typography: {
-        scale: "modular",
-        heading_weight: 600,
-        body_weight: 400
-      },
-      color: {
-        palette: "semantic",
-        accent_count: 1,
-        cvd_preference: "auto"
-      },
-      radius: {
-        philosophy: "rounded",
-        base: 8
-      },
-      elevation: {
-        system: "layered",
-        max_levels: 3
-      },
-      motion: {
-        preference: "subtle",
-        duration_scale: 1,
-        reduce_motion: true
-      },
-      accessibility: {
-        wcag_level: "AA",
-        focus_visible: true,
-        skip_nav: true
-      },
-      personality: ["clean", "modern"]
-    },
-    blueprint: {
-      shell: "sidebar-main",
-      pages: [
-        { id: "home", layout: ["hero"] }
-      ],
-      features: []
-    },
-    meta: {
-      archetype: "custom",
-      target: "react",
-      platform: {
-        type: "spa",
-        routing: "hash"
-      },
-      guard: {
-        mode: "guided",
-        dna_enforcement: "error",
-        blueprint_enforcement: "off"
-      }
-    }
-  };
-  const essencePath = join2(projectRoot, "decantr.essence.json");
-  writeFileSync(essencePath, JSON.stringify(essence, null, 2) + "\n");
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  const projectJson = {
-    detected: {
-      framework: "unknown",
-      version: null,
-      packageManager: "npm",
-      hasTypeScript: false,
-      hasTailwind: false,
-      existingRuleFiles: []
-    },
-    overrides: {
-      framework: null
-    },
-    sync: {
-      status: "needs-sync",
-      lastSync: now,
-      registrySource: "cache",
-      cachedContent: {
-        archetypes: [],
-        patterns: [],
-        themes: [],
-        recipes: []
-      }
-    },
-    initialized: {
-      at: now,
-      via: "cli",
-      version: CLI_VERSION,
-      flags: "--offline --minimal"
-    }
-  };
-  const projectJsonPath = join2(decantrDir, "project.json");
-  writeFileSync(projectJsonPath, JSON.stringify(projectJson, null, 2));
-  const decantrMdPath = join2(projectRoot, "DECANTR.md");
-  const decantrMdContent = `# DECANTR.md
-
-> This file was generated by \`decantr init\` in offline/minimal mode.
-> Run \`decantr upgrade\` when online to pull full registry content.
-
-## Two-Layer Model
-
-This project uses the v3 Essence format with two layers:
-
-### DNA (Immutable Design Axioms)
-DNA defines the foundational design rules that must never be violated. DNA violations are **errors**.
-
-- **Theme:** default (dark mode)
-- **Spacing:** comfortable density, _gap4
-- **Radius:** rounded (8px base)
-- **Accessibility:** WCAG AA
-- **Personality:** clean, modern
-
-### Blueprint (Structural Layout)
-Blueprint defines pages, shells, and patterns. Blueprint deviations are **warnings**.
-
-| Page | Shell | Layout |
-|------|-------|--------|
-| home | sidebar-main | hero |
-
-## Guard Mode: guided
-
-- **DNA enforcement:** error (violations block generation)
-- **Blueprint enforcement:** off (deviations are advisory)
-
-## MCP Tools
-
-When available, use these tools:
-- \`decantr_read_essence\` \u2014 Read the current essence
-- \`decantr_check_drift\` \u2014 Check for guard violations
-- \`decantr_accept_drift\` \u2014 Accept a detected drift as intentional
-- \`decantr_update_essence\` \u2014 Update the essence spec
-
-## Quick Start
-
-1. Edit \`decantr.essence.json\` to define your project structure.
-2. Run \`decantr sync\` when online to fetch registry content.
-3. Use \`decantr create <type> <name>\` to create custom content.
-4. Use \`decantr validate\` to check your essence file.
-
-## Commands
-
-- \`decantr init\` \u2014 Initialize a new Decantr project
-- \`decantr status\` \u2014 Project health and DNA/Blueprint overview
-- \`decantr sync\` \u2014 Sync registry content
-- \`decantr audit\` \u2014 Audit project for issues
-- \`decantr migrate\` \u2014 Migrate v2 essence to v3
-- \`decantr check\` \u2014 Detect drift issues
-- \`decantr sync-drift\` \u2014 Review and resolve drift entries
-- \`decantr validate\` \u2014 Validate essence file
-- \`decantr search\` \u2014 Search the registry
-- \`decantr suggest\` \u2014 Suggest patterns or alternatives
-- \`decantr get\` \u2014 Get full details of a registry item
-- \`decantr list\` \u2014 List items by type
-- \`decantr theme\` \u2014 Manage custom themes
-- \`decantr create\` \u2014 Create custom content items
-- \`decantr publish\` \u2014 Publish custom content to registry
-- \`decantr login\` \u2014 Authenticate with registry
-- \`decantr logout\` \u2014 Remove stored credentials
-- \`decantr upgrade\` \u2014 Check for content updates
-
----
-
-*Generated by @decantr/cli v${CLI_VERSION}*
-`;
-  writeFileSync(decantrMdPath, decantrMdContent);
-  const gitignoreUpdated = updateGitignore(projectRoot);
-  return {
-    essencePath,
-    decantrMdPath,
-    projectJsonPath,
-    contextFiles: [],
-    cssFiles: [],
-    gitignoreUpdated
-  };
-}
-async function refreshDerivedFiles(projectRoot, essence, registry) {
-  const decantrDir = join2(projectRoot, ".decantr");
-  const contextDir = join2(decantrDir, "context");
-  mkdirSync(contextDir, { recursive: true });
-  const themeName = essence.dna.theme.style;
-  const recipeName = essence.dna.theme.recipe ?? themeName;
-  const mode = essence.dna.theme.mode;
-  const guardMode = essence.meta.guard.mode;
-  const guardConfig = {
-    mode: guardMode,
-    dna_enforcement: essence.meta.guard.dna_enforcement || "error",
-    blueprint_enforcement: essence.meta.guard.blueprint_enforcement || "warn"
-  };
-  const personality = essence.dna.personality || [];
-  let themeData;
-  let recipeData;
-  try {
-    const themeResult = await registry.fetchTheme(themeName);
-    if (themeResult?.data) {
-      const t = themeResult.data;
-      themeData = {
-        seed: t.seed,
-        palette: t.palette,
-        cvd_support: t.cvd_support,
-        tokens: t.tokens,
-        typography_hints: t.typography_hints,
-        motion_hints: t.motion_hints
-      };
-    }
-  } catch {
-  }
-  try {
-    const recipeResult = await registry.fetchRecipe(recipeName);
-    if (recipeResult?.data) {
-      const r = recipeResult.data;
-      recipeData = {
-        decorators: r.decorators,
-        spatial_hints: r.spatial_hints,
-        radius_hints: r.radius_hints
-      };
-    }
-  } catch {
-  }
-  const stylesDir = join2(projectRoot, "src", "styles");
-  mkdirSync(stylesDir, { recursive: true });
-  const tokensPath = join2(stylesDir, "tokens.css");
-  const hasRealThemeData = themeData?.seed?.primary || themeData?.palette?.background;
-  if (hasRealThemeData || !existsSync2(tokensPath)) {
-    writeFileSync(tokensPath, generateTokensCSS(themeData, mode));
-  }
-  const decoratorsPath = join2(stylesDir, "decorators.css");
-  const hasRealRecipeData = recipeData?.decorators && Object.keys(recipeData.decorators).length > 0;
-  if (hasRealRecipeData || !existsSync2(decoratorsPath)) {
-    writeFileSync(decoratorsPath, generateDecoratorsCSS(recipeData, themeName));
-  }
-  const cssFiles = [tokensPath, decoratorsPath];
-  const decantrMdPath = join2(projectRoot, "DECANTR.md");
-  writeFileSync(decantrMdPath, generateDecantrMdV31(guardMode, CSS_APPROACH_CONTENT));
-  const summaryPath = join2(contextDir, "essence-summary.md");
-  writeFileSync(summaryPath, generateEssenceSummaryV3(essence));
-  const contextFiles = [summaryPath];
-  const blueprint = essence.blueprint;
-  const sections = blueprint.sections && blueprint.sections.length > 0 ? blueprint.sections : [];
-  if (sections.length > 0) {
-    const patternSpecs = {};
-    const seenPatterns = /* @__PURE__ */ new Set();
-    for (const section of sections) {
-      for (const page of section.pages) {
-        for (const item of page.layout) {
-          const names = extractPatternNames(item);
-          for (const name of names) {
-            if (!seenPatterns.has(name)) {
-              seenPatterns.add(name);
-              try {
-                const patResult = await registry.fetchPattern(name);
-                if (patResult?.data) {
-                  const raw = patResult.data;
-                  const inner = raw.data ?? raw;
-                  const defaultPreset = inner.default_preset || "standard";
-                  const preset = inner.presets?.[defaultPreset];
-                  patternSpecs[name] = {
-                    description: inner.description || "",
-                    components: inner.components || [],
-                    slots: preset?.layout?.slots || {}
-                  };
-                }
-              } catch {
-              }
-            }
-          }
-        }
-      }
-    }
-    const zoneInputs = sections.map((s) => ({
-      archetypeId: s.id,
-      role: s.role,
-      shell: s.shell,
-      features: s.features,
-      description: s.description
-    }));
-    const zones = deriveZones(zoneInputs);
-    const transitions = deriveTransitions(zones);
-    const hasPublic = zones.some((z) => z.role === "public");
-    const hasPrimary = zones.some((z) => z.role === "primary");
-    const topologyData = {
-      intent: sections.map((s) => s.id).join(" + "),
-      zones,
-      transitions,
-      entryPoints: {
-        anonymous: hasPublic ? "public zone" : "gateway",
-        authenticated: hasPrimary ? "primary zone" : "first section"
-      }
-    };
-    const topologyMarkdown = generateTopologySection(topologyData, personality);
-    const themeTokensCss = existsSync2(tokensPath) ? readFileSync2(tokensPath, "utf-8") : "";
-    const decoratorList = [];
-    if (recipeData?.decorators) {
-      for (const [name, desc] of Object.entries(recipeData.decorators)) {
-        decoratorList.push({ name, description: desc });
-      }
-    } else if (existsSync2(decoratorsPath)) {
-      const decoratorsCss = readFileSync2(decoratorsPath, "utf-8");
-      const classRegex = /\/\*\s*(.+?)\s*\*\/\s*\n\s*\.([\w-]+)\s*\{/g;
-      let match;
-      while ((match = classRegex.exec(decoratorsCss)) !== null) {
-        decoratorList.push({ name: match[2], description: match[1] });
-      }
-      if (decoratorList.length === 0) {
-        const simpleClassRegex = /^\.([\w-]+)\s*\{/gm;
-        while ((match = simpleClassRegex.exec(decoratorsCss)) !== null) {
-          decoratorList.push({ name: match[1], description: "" });
-        }
-      }
-    }
-    const shellInfoCache = {};
-    const seenShells = /* @__PURE__ */ new Set();
-    for (const section of sections) {
-      const shellId = section.shell;
-      if (!seenShells.has(shellId)) {
-        seenShells.add(shellId);
-        try {
-          const shellResult = await registry.fetchShell(shellId);
-          if (shellResult?.data) {
-            const raw = shellResult.data;
-            const inner = raw.data ?? raw;
-            shellInfoCache[shellId] = {
-              description: inner.description || "",
-              regions: inner.config?.regions || [],
-              layout: inner.layout || void 0
-            };
-          }
-        } catch {
-        }
-      }
-    }
-    for (const section of sections) {
-      const zoneLabel = section.role === "primary" || section.role === "auxiliary" ? "App" : section.role.charAt(0).toUpperCase() + section.role.slice(1);
-      const zoneContext = `This section is in the **${zoneLabel}** zone (${section.shell} shell).` + (topologyMarkdown ? "\n\n" + topologyMarkdown : "");
-      const sectionPatterns = {};
-      for (const page of section.pages) {
-        for (const item of page.layout) {
-          const names = extractPatternNames(item);
-          for (const name of names) {
-            if (patternSpecs[name]) {
-              sectionPatterns[name] = patternSpecs[name];
-            }
-          }
-        }
-      }
-      const contextContent = generateSectionContext({
-        section,
-        themeTokens: themeTokensCss,
-        decorators: decoratorList,
-        guardConfig,
-        personality,
-        themeName,
-        recipeName,
-        zoneContext,
-        patternSpecs: sectionPatterns,
-        constraints: essence.dna.constraints,
-        shellInfo: shellInfoCache[section.shell]
-      });
-      const sectionContextPath = join2(contextDir, `section-${section.id}.md`);
-      writeFileSync(sectionContextPath, contextContent);
-      contextFiles.push(sectionContextPath);
-    }
-    const routes = blueprint.routes || {};
-    const scaffoldContent = generateScaffoldContext({
-      appName: essence.meta.archetype || "Application",
-      blueprintId: "",
-      themeName,
-      recipeName,
-      personality,
-      topologyMarkdown,
-      sections,
-      routes,
-      constraints: essence.dna.constraints,
-      seo: essence.meta.seo,
-      navigation: essence.meta.navigation
-    });
-    const scaffoldMdPath = join2(contextDir, "scaffold.md");
-    writeFileSync(scaffoldMdPath, scaffoldContent);
-    contextFiles.push(scaffoldMdPath);
-  } else {
-    const pages = blueprint.pages || [{ id: "home", layout: ["hero"] }];
-    const shell = blueprint.shell ?? "sidebar-main";
-    const syntheticSection = {
-      id: essence.meta.archetype || "default",
-      role: "primary",
-      shell,
-      features: blueprint.features || [],
-      description: `${essence.meta.archetype || "Application"} section`,
-      pages
-    };
-    const patternSpecs = {};
-    const seenPatterns = /* @__PURE__ */ new Set();
-    for (const page of pages) {
-      for (const item of page.layout) {
-        const names = extractPatternNames(item);
-        for (const name of names) {
-          if (!seenPatterns.has(name)) {
-            seenPatterns.add(name);
-            try {
-              const patResult = await registry.fetchPattern(name);
-              if (patResult?.data) {
-                const raw = patResult.data;
-                const inner = raw.data ?? raw;
-                const defaultPreset = inner.default_preset || "standard";
-                const preset = inner.presets?.[defaultPreset];
-                patternSpecs[name] = {
-                  description: inner.description || "",
-                  components: inner.components || [],
-                  slots: preset?.layout?.slots || {}
-                };
-              }
-            } catch {
-            }
-          }
-        }
-      }
-    }
-    const themeTokensCss = existsSync2(tokensPath) ? readFileSync2(tokensPath, "utf-8") : "";
-    const decoratorList = [];
-    if (recipeData?.decorators) {
-      for (const [name, desc] of Object.entries(recipeData.decorators)) {
-        decoratorList.push({ name, description: desc });
-      }
-    } else if (existsSync2(decoratorsPath)) {
-      const decoratorsCss = readFileSync2(decoratorsPath, "utf-8");
-      const classRegex = /\/\*\s*(.+?)\s*\*\/\s*\n\s*\.([\w-]+)\s*\{/g;
-      let match;
-      while ((match = classRegex.exec(decoratorsCss)) !== null) {
-        decoratorList.push({ name: match[2], description: match[1] });
-      }
-      if (decoratorList.length === 0) {
-        const simpleClassRegex = /^\.([\w-]+)\s*\{/gm;
-        while ((match = simpleClassRegex.exec(decoratorsCss)) !== null) {
-          decoratorList.push({ name: match[1], description: "" });
-        }
-      }
-    }
-    let v30ShellInfo;
-    try {
-      const shellResult = await registry.fetchShell(shell);
-      if (shellResult?.data) {
-        const raw = shellResult.data;
-        const inner = raw.data ?? raw;
-        v30ShellInfo = {
-          description: inner.description || "",
-          regions: inner.config?.regions || [],
-          layout: inner.layout || void 0
-        };
-      }
-    } catch {
-    }
-    const contextContent = generateSectionContext({
-      section: syntheticSection,
-      themeTokens: themeTokensCss,
-      decorators: decoratorList,
-      guardConfig,
-      personality,
-      themeName,
-      recipeName,
-      zoneContext: `This is the primary section (${shell} shell).`,
-      patternSpecs,
-      constraints: essence.dna.constraints,
-      shellInfo: v30ShellInfo
-    });
-    const sectionContextPath = join2(contextDir, `section-${syntheticSection.id}.md`);
-    writeFileSync(sectionContextPath, contextContent);
-    contextFiles.push(sectionContextPath);
-  }
-  return {
-    decantrMdPath,
-    contextFiles,
-    cssFiles
-  };
-}
-function generateSectionContext(input) {
-  const { section, themeTokens, decorators, guardConfig, personality, themeName, recipeName, zoneContext, patternSpecs, recipeHints, constraints, shellInfo } = input;
-  const lines = [];
-  lines.push(`# Section: ${section.id}`);
-  lines.push("");
-  lines.push(`**Role:** ${section.role} | **Shell:** ${section.shell} | **Archetype:** ${section.id}`);
-  lines.push(`**Description:** ${section.description}`);
-  if (shellInfo) {
-    lines.push(`**Shell structure:** ${shellInfo.description}`);
-    lines.push(`**Regions:** ${shellInfo.regions.join(", ")}`);
-  }
-  lines.push("");
-  lines.push("---");
-  lines.push("");
-  lines.push("## Guard Rules");
-  lines.push("");
-  lines.push(`| Rule | Scope | Severity | Description |`);
-  lines.push(`|------|-------|----------|-------------|`);
-  lines.push(`| Style guard | DNA | ${guardConfig.dna_enforcement} | Code must use the ${themeName} theme |`);
-  lines.push(`| Recipe guard | DNA | ${guardConfig.dna_enforcement} | Visual recipe must match ${recipeName} |`);
-  lines.push(`| Density guard | DNA | ${guardConfig.dna_enforcement} | Content gap must match essence density |`);
-  lines.push(`| Accessibility guard | DNA | ${guardConfig.dna_enforcement} | Must meet WCAG level from essence |`);
-  lines.push(`| Structure guard | Blueprint | ${guardConfig.blueprint_enforcement} | Pages must exist in essence structure |`);
-  lines.push(`| Layout guard | Blueprint | ${guardConfig.blueprint_enforcement} | Pattern order must match essence layout |`);
-  lines.push(`| Pattern existence | Blueprint | ${guardConfig.blueprint_enforcement} | All patterns must exist in registry |`);
-  lines.push("");
-  lines.push(`**Guard mode:** ${guardConfig.mode}`);
-  lines.push("");
-  lines.push("---");
-  lines.push("");
-  lines.push(`## Theme: ${themeName}`);
-  lines.push("");
-  lines.push("```css");
-  lines.push(themeTokens);
-  lines.push("```");
-  lines.push("");
-  lines.push("---");
-  lines.push("");
-  lines.push(`## Decorators (${recipeName} recipe)`);
-  lines.push("");
-  if (decorators.length > 0) {
-    lines.push("| Decorator | Description |");
-    lines.push("|-----------|-------------|");
-    for (const dec of decorators) {
-      lines.push(`| ${dec.name} | ${dec.description} |`);
-    }
-  } else {
-    lines.push("No decorators defined.");
-  }
-  lines.push("");
-  if (recipeHints) {
-    if (recipeHints.preferred && recipeHints.preferred.length > 0) {
-      lines.push(`**Preferred:** ${recipeHints.preferred.join(", ")}`);
-    }
-    if (recipeHints.compositions) {
-      lines.push(`**Compositions:** ${recipeHints.compositions}`);
-    }
-    if (recipeHints.spatialHints) {
-      lines.push(`**Spatial hints:** ${recipeHints.spatialHints}`);
-    }
-    lines.push("");
-  }
-  lines.push("---");
-  lines.push("");
-  if (zoneContext) {
-    lines.push("## Zone Context");
-    lines.push("");
-    lines.push(zoneContext);
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-  }
-  if (section.features.length > 0) {
-    lines.push("## Features");
-    lines.push("");
-    lines.push(section.features.join(", "));
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-  }
-  if (personality.length > 0) {
-    lines.push("## Personality");
-    lines.push("");
-    lines.push(personality.join(", "));
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-  }
-  if (constraints && Object.keys(constraints).length > 0) {
-    lines.push("## Constraints");
-    lines.push("");
-    for (const [key, value] of Object.entries(constraints)) {
-      lines.push(`- **${key}:** ${typeof value === "object" && value !== null ? JSON.stringify(value) : value}`);
-    }
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-  }
-  lines.push("## Pages");
-  lines.push("");
-  for (const page of section.pages) {
-    const route = page.route || `/${section.id}/${page.id}`;
-    const layoutStr = page.layout.map(serializeLayoutItem).join(" \u2192 ");
-    lines.push(`### ${page.id} (${route})`);
-    lines.push("");
-    lines.push(`Layout: ${layoutStr}`);
-    lines.push("");
-    if (page.patterns && page.patterns.length > 0) {
-      lines.push("**Pattern mapping:**");
-      lines.push("| Alias | Pattern | Preset |");
-      lines.push("|-------|---------|--------|");
-      for (const ref of page.patterns) {
-        const alias = ref.as || ref.pattern;
-        const preset = ref.preset || "standard";
-        lines.push(`| ${alias} | ${ref.pattern} | ${preset} |`);
-      }
-      lines.push("");
-    }
-    const patternNames = page.layout.flatMap(extractPatternNames);
-    for (const patternName of patternNames) {
-      const spec = patternSpecs[patternName];
-      if (!spec) continue;
-      lines.push(`#### Pattern: ${patternName}`);
-      lines.push("");
-      lines.push(spec.description);
-      lines.push("");
-      lines.push(`**Components:** ${spec.components.join(", ")}`);
-      lines.push("");
-      lines.push("**Layout slots:**");
-      for (const [slot, desc] of Object.entries(spec.slots)) {
-        lines.push(`- \`${slot}\`: ${desc}`);
-      }
-      lines.push("");
-    }
-  }
-  return lines.join("\n");
-}
-function generateScaffoldContext(input) {
-  const { appName, blueprintId, themeName, recipeName, personality, topologyMarkdown, sections, routes, constraints, seo, navigation } = input;
-  const lines = [];
-  lines.push(`# Scaffold: ${appName}`);
-  lines.push("");
-  lines.push(`**Blueprint:** ${blueprintId}`);
-  lines.push(`**Theme:** ${themeName} | **Recipe:** ${recipeName}`);
-  lines.push(`**Personality:** ${personality.join(", ")}`);
-  lines.push("**Guard mode:** creative (no enforcement during initial scaffolding)");
-  lines.push("");
-  lines.push("## App Topology");
-  lines.push("");
-  lines.push(topologyMarkdown);
-  lines.push("");
-  lines.push("## Sections Overview");
-  lines.push("");
-  lines.push("| Section | Role | Shell | Pages | Features |");
-  lines.push("|---------|------|-------|-------|----------|");
-  for (const section of sections) {
-    const pageIds = section.pages.map((p) => p.id).join(", ");
-    const feats = section.features.join(", ") || "none";
-    lines.push(`| ${section.id} | ${section.role} | ${section.shell} | ${pageIds} | ${feats} |`);
-  }
-  lines.push("");
-  lines.push("## Route Map");
-  lines.push("");
-  lines.push("| Route | Section | Page |");
-  lines.push("|-------|---------|------|");
-  for (const [route, entry] of Object.entries(routes)) {
-    lines.push(`| ${route} | ${entry.section} | ${entry.page} |`);
-  }
-  lines.push("");
-  lines.push("## Section Contexts");
-  lines.push("");
-  lines.push("For detailed pattern specs per section, read:");
-  for (const section of sections) {
-    lines.push(`- .decantr/context/section-${section.id}.md`);
-  }
-  lines.push("");
-  const patternUsage = {};
-  for (const section of sections) {
-    for (const page of section.pages) {
-      const names = page.layout.flatMap(extractPatternNames);
-      for (const name of names) {
-        if (!patternUsage[name]) patternUsage[name] = [];
-        const pageLabel = sections.length > 1 ? `${section.id}/${page.id}` : page.id;
-        patternUsage[name].push(pageLabel);
-      }
-    }
-  }
-  const sharedPatterns = Object.entries(patternUsage).filter(([, pages]) => pages.length >= 2);
-  if (sharedPatterns.length > 0) {
-    lines.push("## Shared Components");
-    lines.push("");
-    lines.push("These patterns appear on multiple pages. Consider creating shared components:");
-    lines.push("");
-    lines.push("| Pattern | Used by |");
-    lines.push("|---------|---------|");
-    for (const [pattern, pages] of sharedPatterns) {
-      lines.push(`| ${pattern} | ${pages.join(", ")} |`);
-    }
-    lines.push("");
-  }
-  if (constraints && Object.keys(constraints).length > 0) {
-    lines.push("## Design Constraints");
-    lines.push("");
-    for (const [key, value] of Object.entries(constraints)) {
-      lines.push(`- **${key}:** ${typeof value === "object" && value !== null ? JSON.stringify(value) : value}`);
-    }
-    lines.push("");
-  }
-  if (seo && (seo.schema_org?.length || seo.meta_priorities?.length)) {
-    lines.push("## SEO Hints");
-    lines.push("");
-    if (seo.schema_org && seo.schema_org.length > 0) {
-      lines.push(`**Schema.org types:** ${seo.schema_org.join(", ")}`);
-    }
-    if (seo.meta_priorities && seo.meta_priorities.length > 0) {
-      lines.push(`**Meta priorities:** ${seo.meta_priorities.join(", ")}`);
-    }
-    lines.push("");
-  }
-  if (navigation && (navigation.hotkeys?.length || navigation.command_palette)) {
-    lines.push("## Navigation");
-    lines.push("");
-    if (navigation.command_palette) {
-      lines.push("- Command palette: enabled");
-    }
-    if (navigation.hotkeys && navigation.hotkeys.length > 0) {
-      lines.push(`- Hotkeys: ${navigation.hotkeys.length} configured`);
-    }
-    lines.push("");
-  }
-  return lines.join("\n");
-}
-
 // 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";
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync, readdirSync, rmSync } from "fs";
+import { join as join2 } from "path";
 
 // src/theme-templates.ts
 function getThemeSkeleton(id, name) {
@@ -2296,20 +512,20 @@ function validateCustomTheme(theme) {
   };
 }
 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)) {
+  const customThemesDir = join2(projectRoot, ".decantr", "custom", "themes");
+  const themePath = join2(customThemesDir, `${id}.json`);
+  const howToPath = join2(customThemesDir, "how-to-theme.md");
+  mkdirSync(customThemesDir, { recursive: true });
+  if (existsSync2(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());
+  writeFileSync(themePath, JSON.stringify(skeleton, null, 2));
+  if (!existsSync2(howToPath)) {
+    writeFileSync(howToPath, getHowToThemeDoc());
   }
   return {
     success: true,
@@ -2317,17 +533,17 @@ function createTheme(projectRoot, id, name) {
   };
 }
 function listCustomThemes(projectRoot) {
-  const customThemesDir = join3(projectRoot, ".decantr", "custom", "themes");
-  if (!existsSync3(customThemesDir)) {
+  const customThemesDir = join2(projectRoot, ".decantr", "custom", "themes");
+  if (!existsSync2(customThemesDir)) {
     return [];
   }
   const themes = [];
   try {
     const files = readdirSync(customThemesDir).filter((f) => f.endsWith(".json"));
     for (const file of files) {
-      const filePath = join3(customThemesDir, file);
+      const filePath = join2(customThemesDir, file);
       try {
-        const data = JSON.parse(readFileSync3(filePath, "utf-8"));
+        const data = JSON.parse(readFileSync2(filePath, "utf-8"));
         themes.push({
           id: data.id || file.replace(".json", ""),
           name: data.name || data.id,
@@ -2342,8 +558,8 @@ function listCustomThemes(projectRoot) {
   return themes;
 }
 function deleteTheme(projectRoot, id) {
-  const themePath = join3(projectRoot, ".decantr", "custom", "themes", `${id}.json`);
-  if (!existsSync3(themePath)) {
+  const themePath = join2(projectRoot, ".decantr", "custom", "themes", `${id}.json`);
+  if (!existsSync2(themePath)) {
     return {
       success: false,
       error: `Theme "${id}" not found at ${themePath}`
@@ -2360,7 +576,7 @@ function deleteTheme(projectRoot, id) {
   }
 }
 function importTheme(projectRoot, sourcePath) {
-  if (!existsSync3(sourcePath)) {
+  if (!existsSync2(sourcePath)) {
     return {
       success: false,
       errors: [`Source file not found: ${sourcePath}`]
@@ -2368,7 +584,7 @@ function importTheme(projectRoot, sourcePath) {
   }
   let theme;
   try {
-    theme = JSON.parse(readFileSync3(sourcePath, "utf-8"));
+    theme = JSON.parse(readFileSync2(sourcePath, "utf-8"));
   } catch (e) {
     return {
       success: false,
@@ -2384,14 +600,14 @@ function importTheme(projectRoot, sourcePath) {
   }
   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));
+  const customThemesDir = join2(projectRoot, ".decantr", "custom", "themes");
+  const destPath = join2(customThemesDir, `${id}.json`);
+  mkdirSync(customThemesDir, { recursive: true });
+  const howToPath = join2(customThemesDir, "how-to-theme.md");
+  if (!existsSync2(howToPath)) {
+    writeFileSync(howToPath, getHowToThemeDoc());
+  }
+  writeFileSync(destPath, JSON.stringify(theme, null, 2));
   return {
     success: true,
     path: destPath
@@ -2399,25 +615,25 @@ function importTheme(projectRoot, sourcePath) {
 }
 
 // src/auth.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3, rmSync as rmSync2 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2, rmSync as rmSync2 } from "fs";
+import { join as join3 } from "path";
 import { homedir } from "os";
-var CONFIG_DIR = join4(homedir(), ".config", "decantr");
-var AUTH_FILE = join4(CONFIG_DIR, "auth.json");
+var CONFIG_DIR = join3(homedir(), ".config", "decantr");
+var AUTH_FILE = join3(CONFIG_DIR, "auth.json");
 function getCredentials() {
-  if (!existsSync4(AUTH_FILE)) return null;
+  if (!existsSync3(AUTH_FILE)) return null;
   try {
-    return JSON.parse(readFileSync4(AUTH_FILE, "utf-8"));
+    return JSON.parse(readFileSync3(AUTH_FILE, "utf-8"));
   } catch {
     return null;
   }
 }
 function saveCredentials(creds) {
-  mkdirSync3(CONFIG_DIR, { recursive: true });
-  writeFileSync3(AUTH_FILE, JSON.stringify(creds, null, 2));
+  mkdirSync2(CONFIG_DIR, { recursive: true });
+  writeFileSync2(AUTH_FILE, JSON.stringify(creds, null, 2));
 }
 function clearCredentials() {
-  if (existsSync4(AUTH_FILE)) {
+  if (existsSync3(AUTH_FILE)) {
     rmSync2(AUTH_FILE);
   }
 }
@@ -2428,8 +644,8 @@ function getApiKeyOrToken() {
 }
 
 // src/commands/publish.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
-import { join as join5 } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
+import { join as join4 } from "path";
 import { RegistryAPIClient } from "@decantr/registry";
 var PLURAL_TO_SINGULAR = {
   patterns: "pattern",
@@ -2456,8 +672,8 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
   }
   const singularType = PLURAL_TO_SINGULAR[type] || type;
   const pluralType = SINGULAR_TO_PLURAL[type] || SINGULAR_TO_PLURAL[singularType] || `${type}s`;
-  const customPath = join5(projectRoot, ".decantr", "custom", pluralType, `${name}.json`);
-  if (!existsSync5(customPath)) {
+  const customPath = join4(projectRoot, ".decantr", "custom", pluralType, `${name}.json`);
+  if (!existsSync4(customPath)) {
     console.error(`Custom ${singularType} "${name}" not found at ${customPath}`);
     console.error(`Create one first: decantr create ${singularType} ${name}`);
     process.exitCode = 1;
@@ -2465,7 +681,7 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
   }
   let data;
   try {
-    data = JSON.parse(readFileSync5(customPath, "utf-8"));
+    data = JSON.parse(readFileSync4(customPath, "utf-8"));
   } catch {
     console.error(`Failed to parse ${customPath}`);
     process.exitCode = 1;
@@ -2492,8 +708,8 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
 }
 
 // src/commands/create.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
+import { join as join5 } from "path";
 var CONTENT_TYPES = ["pattern", "recipe", "theme", "blueprint", "archetype", "shell"];
 var PLURAL = {
   pattern: "patterns",
@@ -2533,23 +749,23 @@ function cmdCreate(type, name, projectRoot = process.cwd()) {
     return;
   }
   const plural = PLURAL[type];
-  const customDir = join6(projectRoot, ".decantr", "custom", plural);
-  const filePath = join6(customDir, `${name}.json`);
-  if (existsSync6(filePath)) {
+  const customDir = join5(projectRoot, ".decantr", "custom", plural);
+  const filePath = join5(customDir, `${name}.json`);
+  if (existsSync5(filePath)) {
     console.error(`${type} "${name}" already exists at ${filePath}`);
     process.exitCode = 1;
     return;
   }
-  mkdirSync4(customDir, { recursive: true });
+  mkdirSync3(customDir, { recursive: true });
   const skeleton = getSkeleton(type, name, name.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()));
-  writeFileSync4(filePath, JSON.stringify(skeleton, null, 2));
+  writeFileSync3(filePath, JSON.stringify(skeleton, null, 2));
   console.log(`Created ${type} "${name}" at ${filePath}`);
   console.log(`Edit it, then publish with: decantr publish ${type} ${name}`);
 }
 
 // src/commands/migrate.ts
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync5, existsSync as existsSync7, copyFileSync } from "fs";
-import { join as join7 } from "path";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync4, existsSync as existsSync6, copyFileSync } from "fs";
+import { join as join6 } from "path";
 import { validateEssence, migrateV2ToV3, isV3 } from "@decantr/essence-spec";
 var GREEN2 = "\x1B[32m";
 var RED = "\x1B[31m";
@@ -2557,12 +773,12 @@ var YELLOW2 = "\x1B[33m";
 var RESET2 = "\x1B[0m";
 var DIM2 = "\x1B[2m";
 function migrateEssenceFile(essencePath) {
-  if (!existsSync7(essencePath)) {
+  if (!existsSync6(essencePath)) {
     return { success: false, error: `File not found: ${essencePath}` };
   }
   let raw;
   try {
-    raw = readFileSync6(essencePath, "utf-8");
+    raw = readFileSync5(essencePath, "utf-8");
   } catch (e) {
     return { success: false, error: `Could not read ${essencePath}: ${e.message}` };
   }
@@ -2603,15 +819,15 @@ function migrateEssenceFile(essencePath) {
     };
   }
   try {
-    writeFileSync5(essencePath, JSON.stringify(v3, null, 2) + "\n");
+    writeFileSync4(essencePath, JSON.stringify(v3, null, 2) + "\n");
   } catch (e) {
     return { success: false, backupPath, error: `Could not write migrated file: ${e.message}` };
   }
   return { success: true, backupPath };
 }
 async function cmdMigrate(projectRoot = process.cwd()) {
-  const essencePath = join7(projectRoot, "decantr.essence.json");
-  if (!existsSync7(essencePath)) {
+  const essencePath = join6(projectRoot, "decantr.essence.json");
+  if (!existsSync6(essencePath)) {
     console.error(`${RED}No decantr.essence.json found. Run \`decantr init\` first.${RESET2}`);
     process.exitCode = 1;
     return;
@@ -2636,8 +852,8 @@ async function cmdMigrate(projectRoot = process.cwd()) {
 }
 
 // src/commands/sync-drift.ts
-import { readFileSync as readFileSync7, writeFileSync as writeFileSync6, existsSync as existsSync8 } from "fs";
-import { join as join8 } from "path";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync5, existsSync as existsSync7 } from "fs";
+import { join as join7 } from "path";
 var GREEN3 = "\x1B[32m";
 var RED2 = "\x1B[31m";
 var YELLOW3 = "\x1B[33m";
@@ -2646,15 +862,15 @@ var DIM3 = "\x1B[2m";
 var BOLD2 = "\x1B[1m";
 var CYAN2 = "\x1B[36m";
 async function cmdSyncDrift(projectRoot = process.cwd()) {
-  const driftLogPath = join8(projectRoot, ".decantr", "drift-log.json");
-  if (!existsSync8(driftLogPath)) {
+  const driftLogPath = join7(projectRoot, ".decantr", "drift-log.json");
+  if (!existsSync7(driftLogPath)) {
     console.log(`${GREEN3}No drift log found \u2014 no drift recorded.${RESET3}`);
     console.log(`${DIM3}Drift is logged when guard violations are detected during development.${RESET3}`);
     return;
   }
   let entries;
   try {
-    entries = JSON.parse(readFileSync7(driftLogPath, "utf-8"));
+    entries = JSON.parse(readFileSync6(driftLogPath, "utf-8"));
   } catch {
     console.error(`${RED2}Could not parse drift-log.json${RESET3}`);
     process.exitCode = 1;
@@ -2698,13 +914,13 @@ ${BOLD2}Unresolved Drift Entries (${unresolved.length})${RESET3}
   console.log("");
 }
 function resolveDriftEntries(projectRoot, options) {
-  const driftLogPath = join8(projectRoot, ".decantr", "drift-log.json");
-  if (!existsSync8(driftLogPath)) {
+  const driftLogPath = join7(projectRoot, ".decantr", "drift-log.json");
+  if (!existsSync7(driftLogPath)) {
     return { success: true };
   }
   if (options.clear) {
     try {
-      writeFileSync6(driftLogPath, "[]");
+      writeFileSync5(driftLogPath, "[]");
       return { success: true };
     } catch (e) {
       return { success: false, error: `Could not clear drift log: ${e.message}` };
@@ -2712,7 +928,7 @@ function resolveDriftEntries(projectRoot, options) {
   }
   let entries;
   try {
-    entries = JSON.parse(readFileSync7(driftLogPath, "utf-8"));
+    entries = JSON.parse(readFileSync6(driftLogPath, "utf-8"));
   } catch {
     return { success: false, error: "Could not parse drift-log.json" };
   }
@@ -2731,7 +947,7 @@ function resolveDriftEntries(projectRoot, options) {
     }
   }
   try {
-    writeFileSync6(driftLogPath, JSON.stringify(entries, null, 2));
+    writeFileSync5(driftLogPath, JSON.stringify(entries, null, 2));
     return { success: true };
   } catch (e) {
     return { success: false, error: `Could not write drift log: ${e.message}` };
@@ -2739,23 +955,23 @@ function resolveDriftEntries(projectRoot, options) {
 }
 
 // src/commands/refresh.ts
-import { readFileSync as readFileSync8, existsSync as existsSync9 } from "fs";
-import { join as join9 } from "path";
+import { readFileSync as readFileSync7, existsSync as existsSync8 } from "fs";
+import { join as join8 } from "path";
 import { isV3 as isV32 } from "@decantr/essence-spec";
 var GREEN4 = "\x1B[32m";
 var RED3 = "\x1B[31m";
 var DIM4 = "\x1B[2m";
 var RESET4 = "\x1B[0m";
 async function cmdRefresh(projectRoot = process.cwd()) {
-  const essencePath = join9(projectRoot, "decantr.essence.json");
-  if (!existsSync9(essencePath)) {
+  const essencePath = join8(projectRoot, "decantr.essence.json");
+  if (!existsSync8(essencePath)) {
     console.error(`${RED3}No decantr.essence.json found. Run \`decantr init\` first.${RESET4}`);
     process.exitCode = 1;
     return;
   }
   let essence;
   try {
-    const raw = readFileSync8(essencePath, "utf-8");
+    const raw = readFileSync7(essencePath, "utf-8");
     const parsed = JSON.parse(raw);
     if (!isV32(parsed)) {
       console.error(`${RED3}Essence is not v3. Run \`decantr migrate\` first.${RESET4}`);
@@ -2769,7 +985,7 @@ async function cmdRefresh(projectRoot = process.cwd()) {
     return;
   }
   const registryClient = new RegistryClient({
-    cacheDir: join9(projectRoot, ".decantr", "cache")
+    cacheDir: join8(projectRoot, ".decantr", "cache")
   });
   console.log("Regenerating derived files...\n");
   const result = await refreshDerivedFiles(projectRoot, essence, registryClient);
@@ -2788,23 +1004,23 @@ async function cmdRefresh(projectRoot = process.cwd()) {
 }
 
 // src/commands/add.ts
-import { readFileSync as readFileSync9, writeFileSync as writeFileSync7, existsSync as existsSync10 } from "fs";
-import { join as join10 } from "path";
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, existsSync as existsSync9 } from "fs";
+import { join as join9 } from "path";
 import { isV3 as isV33, migrateV30ToV31 } from "@decantr/essence-spec";
 var GREEN5 = "\x1B[32m";
 var RED4 = "\x1B[31m";
 var DIM5 = "\x1B[2m";
 var RESET5 = "\x1B[0m";
 function readAndMigrate(projectRoot) {
-  const essencePath = join10(projectRoot, "decantr.essence.json");
-  if (!existsSync10(essencePath)) {
+  const essencePath = join9(projectRoot, "decantr.essence.json");
+  if (!existsSync9(essencePath)) {
     console.error(`${RED4}No decantr.essence.json found. Run \`decantr init\` first.${RESET5}`);
     process.exitCode = 1;
     return null;
   }
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync9(essencePath, "utf-8"));
+    parsed = JSON.parse(readFileSync8(essencePath, "utf-8"));
   } catch (e) {
     console.error(`${RED4}Could not read essence: ${e.message}${RESET5}`);
     process.exitCode = 1;
@@ -2819,7 +1035,7 @@ function readAndMigrate(projectRoot) {
   return { essence, essencePath };
 }
 function writeEssence(essencePath, essence) {
-  writeFileSync7(essencePath, JSON.stringify(essence, null, 2) + "\n");
+  writeFileSync6(essencePath, JSON.stringify(essence, null, 2) + "\n");
 }
 async function cmdAddSection(archetypeId, args, projectRoot = process.cwd()) {
   if (!archetypeId) {
@@ -2838,7 +1054,7 @@ async function cmdAddSection(archetypeId, args, projectRoot = process.cwd()) {
     return;
   }
   const registryClient = new RegistryClient({
-    cacheDir: join10(projectRoot, ".decantr", "cache")
+    cacheDir: join9(projectRoot, ".decantr", "cache")
   });
   const result = await registryClient.fetchArchetype(archetypeId);
   if (!result) {
@@ -2902,7 +1118,7 @@ async function cmdAddPage(path, args, projectRoot = process.cwd()) {
   writeEssence(essencePath, essence);
   console.log(`${GREEN5}Added page "${pageId}" to section "${sectionId}".${RESET5}`);
   const registryClient = new RegistryClient({
-    cacheDir: join10(projectRoot, ".decantr", "cache")
+    cacheDir: join9(projectRoot, ".decantr", "cache")
   });
   await refreshDerivedFiles(projectRoot, essence, registryClient);
   console.log(`${GREEN5}Derived files refreshed.${RESET5}`);
@@ -2941,30 +1157,30 @@ async function cmdAddFeature(feature, args, projectRoot = process.cwd()) {
   const target = sectionId ? `section "${sectionId}" and global` : "global";
   console.log(`${GREEN5}Added feature "${feature}" to ${target} features.${RESET5}`);
   const registryClient = new RegistryClient({
-    cacheDir: join10(projectRoot, ".decantr", "cache")
+    cacheDir: join9(projectRoot, ".decantr", "cache")
   });
   await refreshDerivedFiles(projectRoot, essence, registryClient);
   console.log(`${GREEN5}Derived files refreshed.${RESET5}`);
 }
 
 // src/commands/remove.ts
-import { readFileSync as readFileSync10, writeFileSync as writeFileSync8, existsSync as existsSync11, rmSync as rmSync3 } from "fs";
-import { join as join11 } from "path";
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync7, existsSync as existsSync10, rmSync as rmSync3 } from "fs";
+import { join as join10 } from "path";
 import { isV3 as isV34, migrateV30ToV31 as migrateV30ToV312 } from "@decantr/essence-spec";
 var GREEN6 = "\x1B[32m";
 var RED5 = "\x1B[31m";
 var DIM6 = "\x1B[2m";
 var RESET6 = "\x1B[0m";
 function readAndMigrate2(projectRoot) {
-  const essencePath = join11(projectRoot, "decantr.essence.json");
-  if (!existsSync11(essencePath)) {
+  const essencePath = join10(projectRoot, "decantr.essence.json");
+  if (!existsSync10(essencePath)) {
     console.error(`${RED5}No decantr.essence.json found. Run \`decantr init\` first.${RESET6}`);
     process.exitCode = 1;
     return null;
   }
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync10(essencePath, "utf-8"));
+    parsed = JSON.parse(readFileSync9(essencePath, "utf-8"));
   } catch (e) {
     console.error(`${RED5}Could not read essence: ${e.message}${RESET6}`);
     process.exitCode = 1;
@@ -2979,7 +1195,7 @@ function readAndMigrate2(projectRoot) {
   return { essence, essencePath };
 }
 function writeEssence2(essencePath, essence) {
-  writeFileSync8(essencePath, JSON.stringify(essence, null, 2) + "\n");
+  writeFileSync7(essencePath, JSON.stringify(essence, null, 2) + "\n");
 }
 function recomputeGlobalFeatures(essence) {
   const all = /* @__PURE__ */ new Set();
@@ -3021,14 +1237,14 @@ async function cmdRemoveSection(sectionId, args, projectRoot = process.cwd()) {
   sections.splice(idx, 1);
   recomputeGlobalFeatures(essence);
   removeRoutes(essence, sectionId);
-  const contextFile = join11(projectRoot, ".decantr", "context", `${sectionId}.md`);
-  if (existsSync11(contextFile)) {
+  const contextFile = join10(projectRoot, ".decantr", "context", `${sectionId}.md`);
+  if (existsSync10(contextFile)) {
     rmSync3(contextFile);
   }
   writeEssence2(essencePath, essence);
   console.log(`${GREEN6}Removed section "${sectionId}".${RESET6}`);
   const registryClient = new RegistryClient({
-    cacheDir: join11(projectRoot, ".decantr", "cache")
+    cacheDir: join10(projectRoot, ".decantr", "cache")
   });
   await refreshDerivedFiles(projectRoot, essence, registryClient);
   console.log(`${GREEN6}Derived files refreshed.${RESET6}`);
@@ -3064,7 +1280,7 @@ async function cmdRemovePage(path, args, projectRoot = process.cwd()) {
   writeEssence2(essencePath, essence);
   console.log(`${GREEN6}Removed page "${pageId}" from section "${sectionId}".${RESET6}`);
   const registryClient = new RegistryClient({
-    cacheDir: join11(projectRoot, ".decantr", "cache")
+    cacheDir: join10(projectRoot, ".decantr", "cache")
   });
   await refreshDerivedFiles(projectRoot, essence, registryClient);
   console.log(`${GREEN6}Derived files refreshed.${RESET6}`);
@@ -3105,15 +1321,15 @@ async function cmdRemoveFeature(feature, args, projectRoot = process.cwd()) {
   const target = sectionId ? `section "${sectionId}" and global` : "global";
   console.log(`${GREEN6}Removed feature "${feature}" from ${target} features.${RESET6}`);
   const registryClient = new RegistryClient({
-    cacheDir: join11(projectRoot, ".decantr", "cache")
+    cacheDir: join10(projectRoot, ".decantr", "cache")
   });
   await refreshDerivedFiles(projectRoot, essence, registryClient);
   console.log(`${GREEN6}Derived files refreshed.${RESET6}`);
 }
 
 // src/commands/theme-switch.ts
-import { readFileSync as readFileSync11, writeFileSync as writeFileSync9, existsSync as existsSync12 } from "fs";
-import { join as join12 } from "path";
+import { readFileSync as readFileSync10, writeFileSync as writeFileSync8, existsSync as existsSync11 } from "fs";
+import { join as join11 } from "path";
 import { isV3 as isV35, migrateV30ToV31 as migrateV30ToV313 } from "@decantr/essence-spec";
 var GREEN7 = "\x1B[32m";
 var RED6 = "\x1B[31m";
@@ -3126,15 +1342,15 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
     process.exitCode = 1;
     return;
   }
-  const essencePath = join12(projectRoot, "decantr.essence.json");
-  if (!existsSync12(essencePath)) {
+  const essencePath = join11(projectRoot, "decantr.essence.json");
+  if (!existsSync11(essencePath)) {
     console.error(`${RED6}No decantr.essence.json found. Run \`decantr init\` first.${RESET7}`);
     process.exitCode = 1;
     return;
   }
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync11(essencePath, "utf-8"));
+    parsed = JSON.parse(readFileSync10(essencePath, "utf-8"));
   } catch (e) {
     console.error(`${RED6}Could not read essence: ${e.message}${RESET7}`);
     process.exitCode = 1;
@@ -3179,7 +1395,7 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
     essence.dna.theme.mode = mode;
   }
   const registryClient = new RegistryClient({
-    cacheDir: join12(projectRoot, ".decantr", "cache")
+    cacheDir: join11(projectRoot, ".decantr", "cache")
   });
   const recipeName = essence.dna.theme.recipe;
   try {
@@ -3197,7 +1413,7 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
     }
   } catch {
   }
-  writeFileSync9(essencePath, JSON.stringify(essence, null, 2) + "\n");
+  writeFileSync8(essencePath, JSON.stringify(essence, null, 2) + "\n");
   console.log(`${GREEN7}Switched theme: ${oldStyle} \u2192 ${themeName}${RESET7}`);
   if (recipe) console.log(`  ${DIM7}Recipe: ${recipe}${RESET7}`);
   if (shape) console.log(`  ${DIM7}Shape: ${shape}${RESET7}`);
@@ -3208,12 +1424,12 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
 }
 
 // src/commands/analyze.ts
-import { existsSync as existsSync19, mkdirSync as mkdirSync5, writeFileSync as writeFileSync10 } from "fs";
-import { join as join19 } from "path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync4, writeFileSync as writeFileSync9 } from "fs";
+import { join as join18 } from "path";
 
 // src/analyzers/routes.ts
-import { existsSync as existsSync13, readdirSync as readdirSync2, statSync } from "fs";
-import { join as join13, relative } from "path";
+import { existsSync as existsSync12, readdirSync as readdirSync2, statSync } from "fs";
+import { join as join12, relative } from "path";
 var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".next", ".git", "api", "_app", "_document"]);
 function shouldSkipDir(name) {
   return name.startsWith("_") || name.startsWith(".") || SKIP_DIRS.has(name);
@@ -3249,13 +1465,13 @@ function walkAppDir(dir, baseDir, segments) {
     const pageFile = entries.find((e) => e.startsWith("page."));
     routes.push({
       path: routePath || "/",
-      file: relative(baseDir, join13(dir, pageFile)),
+      file: relative(baseDir, join12(dir, pageFile)),
       hasLayout
     });
   }
   for (const entry of entries) {
     if (shouldSkipDir(entry)) continue;
-    const fullPath = join13(dir, entry);
+    const fullPath = join12(dir, entry);
     try {
       if (!statSync(fullPath).isDirectory()) continue;
     } catch {
@@ -3277,7 +1493,7 @@ function walkPagesDir(dir, baseDir, segments) {
   }
   for (const entry of entries) {
     if (shouldSkipDir(entry)) continue;
-    const fullPath = join13(dir, entry);
+    const fullPath = join12(dir, entry);
     try {
       const stat = statSync(fullPath);
       if (stat.isDirectory()) {
@@ -3305,11 +1521,11 @@ function walkPagesDir(dir, baseDir, segments) {
 }
 function scanRoutes(projectRoot) {
   const appDirs = [
-    join13(projectRoot, "src", "app"),
-    join13(projectRoot, "app")
+    join12(projectRoot, "src", "app"),
+    join12(projectRoot, "app")
   ];
   for (const appDir of appDirs) {
-    if (existsSync13(appDir)) {
+    if (existsSync12(appDir)) {
       const routes = walkAppDir(appDir, projectRoot, []);
       if (routes.length > 0) {
         return { strategy: "app-router", routes };
@@ -3317,11 +1533,11 @@ function scanRoutes(projectRoot) {
     }
   }
   const pagesDirs = [
-    join13(projectRoot, "src", "pages"),
-    join13(projectRoot, "pages")
+    join12(projectRoot, "src", "pages"),
+    join12(projectRoot, "pages")
   ];
   for (const pagesDir of pagesDirs) {
-    if (existsSync13(pagesDir)) {
+    if (existsSync12(pagesDir)) {
       const routes = walkPagesDir(pagesDir, projectRoot, []);
       if (routes.length > 0) {
         return { strategy: "pages-router", routes };
@@ -3332,8 +1548,8 @@ function scanRoutes(projectRoot) {
 }
 
 // src/analyzers/components.ts
-import { existsSync as existsSync14, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
-import { join as join14 } from "path";
+import { existsSync as existsSync13, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
+import { join as join13 } from "path";
 var PAGE_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".ts", ".jsx", ".js"]);
 function countFilesRecursive(dir, extensions) {
   let count = 0;
@@ -3345,7 +1561,7 @@ function countFilesRecursive(dir, extensions) {
   }
   for (const entry of entries) {
     if (entry.startsWith(".") || entry === "node_modules") continue;
-    const fullPath = join14(dir, entry);
+    const fullPath = join13(dir, entry);
     try {
       const stat = statSync2(fullPath);
       if (stat.isDirectory()) {
@@ -3372,7 +1588,7 @@ function countPageFiles(dir) {
   }
   for (const entry of entries) {
     if (entry.startsWith(".") || entry === "node_modules") continue;
-    const fullPath = join14(dir, entry);
+    const fullPath = join13(dir, entry);
     try {
       const stat = statSync2(fullPath);
       if (stat.isDirectory()) {
@@ -3392,32 +1608,32 @@ function scanComponents(projectRoot) {
   let pageCount = 0;
   const componentDirs = [];
   const appDirs = [
-    join14(projectRoot, "src", "app"),
-    join14(projectRoot, "app")
+    join13(projectRoot, "src", "app"),
+    join13(projectRoot, "app")
   ];
   for (const dir of appDirs) {
-    if (existsSync14(dir)) {
+    if (existsSync13(dir)) {
       pageCount += countPageFiles(dir);
     }
   }
   const pagesDirs = [
-    join14(projectRoot, "src", "pages"),
-    join14(projectRoot, "pages")
+    join13(projectRoot, "src", "pages"),
+    join13(projectRoot, "pages")
   ];
   for (const dir of pagesDirs) {
-    if (existsSync14(dir)) {
+    if (existsSync13(dir)) {
       pageCount += countFilesRecursive(dir, PAGE_EXTENSIONS);
     }
   }
   let componentCount = 0;
   const componentPaths = [
-    join14(projectRoot, "src", "components"),
-    join14(projectRoot, "components"),
-    join14(projectRoot, "src", "ui"),
-    join14(projectRoot, "ui")
+    join13(projectRoot, "src", "components"),
+    join13(projectRoot, "components"),
+    join13(projectRoot, "src", "ui"),
+    join13(projectRoot, "ui")
   ];
   for (const dir of componentPaths) {
-    if (existsSync14(dir)) {
+    if (existsSync13(dir)) {
       const count = countFilesRecursive(dir, PAGE_EXTENSIONS);
       if (count > 0) {
         componentCount += count;
@@ -3434,8 +1650,8 @@ function scanComponents(projectRoot) {
 }
 
 // src/analyzers/styling.ts
-import { existsSync as existsSync15, readFileSync as readFileSync12 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync11 } from "fs";
+import { join as join14 } from "path";
 var TAILWIND_CONFIGS = [
   "tailwind.config.js",
   "tailwind.config.ts",
@@ -3479,10 +1695,10 @@ function detectDarkMode(projectRoot, cssContent) {
     "app/layout.jsx"
   ];
   for (const rel of layoutPaths) {
-    const fullPath = join15(projectRoot, rel);
-    if (existsSync15(fullPath)) {
+    const fullPath = join14(projectRoot, rel);
+    if (existsSync14(fullPath)) {
       try {
-        const layoutContent = readFileSync12(fullPath, "utf-8");
+        const layoutContent = readFileSync11(fullPath, "utf-8");
         if (layoutContent.includes('className="dark"') || layoutContent.includes("className='dark'") || layoutContent.includes('class="dark"')) {
           return true;
         }
@@ -3490,10 +1706,10 @@ function detectDarkMode(projectRoot, cssContent) {
       }
     }
   }
-  const pkgPath = join15(projectRoot, "package.json");
-  if (existsSync15(pkgPath)) {
+  const pkgPath = join14(projectRoot, "package.json");
+  if (existsSync14(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
       const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
       if (allDeps["next-themes"] || allDeps["theme-toggle"] || allDeps["use-dark-mode"]) {
         return true;
@@ -3507,17 +1723,17 @@ function scanStyling(projectRoot) {
   let approach = "unknown";
   let configFile;
   for (const cfg of TAILWIND_CONFIGS) {
-    if (existsSync15(join15(projectRoot, cfg))) {
+    if (existsSync14(join14(projectRoot, cfg))) {
       approach = "tailwind";
       configFile = cfg;
       break;
     }
   }
   if (approach === "unknown") {
-    const pkgPath = join15(projectRoot, "package.json");
-    if (existsSync15(pkgPath)) {
+    const pkgPath = join14(projectRoot, "package.json");
+    if (existsSync14(pkgPath)) {
       try {
-        const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+        const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
         const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
         if (allDeps.tailwindcss || allDeps["@tailwindcss/postcss"] || allDeps["@tailwindcss/vite"]) {
           approach = "tailwind";
@@ -3528,10 +1744,10 @@ function scanStyling(projectRoot) {
   }
   let cssContent = null;
   for (const rel of GLOBALS_CSS_PATHS) {
-    const fullPath = join15(projectRoot, rel);
-    if (existsSync15(fullPath)) {
+    const fullPath = join14(projectRoot, rel);
+    if (existsSync14(fullPath)) {
       try {
-        cssContent = readFileSync12(fullPath, "utf-8");
+        cssContent = readFileSync11(fullPath, "utf-8");
       } catch {
       }
       break;
@@ -3555,8 +1771,8 @@ function scanStyling(projectRoot) {
 }
 
 // src/analyzers/layout.ts
-import { existsSync as existsSync16, readFileSync as readFileSync13, readdirSync as readdirSync4 } from "fs";
-import { join as join16 } from "path";
+import { existsSync as existsSync15, readFileSync as readFileSync12, readdirSync as readdirSync4 } from "fs";
+import { join as join15 } from "path";
 var SIDEBAR_PATTERNS = ["sidebar", "side-bar", "sidenav", "side-nav", "drawer", "aside"];
 var NAV_PATTERNS = ["nav", "navbar", "header", "top-bar", "topbar", "app-bar", "appbar"];
 var FOOTER_PATTERNS = ["footer", "bottom-bar", "bottombar"];
@@ -3567,12 +1783,12 @@ function containsPattern(text, patterns) {
 function checkComponentDirs(projectRoot) {
   const result = { sidebar: false, nav: false, footer: false };
   const componentDirs = [
-    join16(projectRoot, "src", "components"),
-    join16(projectRoot, "components"),
-    join16(projectRoot, "src", "ui")
+    join15(projectRoot, "src", "components"),
+    join15(projectRoot, "components"),
+    join15(projectRoot, "src", "ui")
   ];
   for (const dir of componentDirs) {
-    if (!existsSync16(dir)) continue;
+    if (!existsSync15(dir)) continue;
     let entries;
     try {
       entries = readdirSync4(dir);
@@ -3591,16 +1807,16 @@ function checkComponentDirs(projectRoot) {
 function checkLayoutFiles(projectRoot) {
   const result = { sidebar: false, nav: false, footer: false };
   const layoutPaths = [
-    join16(projectRoot, "src", "app", "layout.tsx"),
-    join16(projectRoot, "src", "app", "layout.jsx"),
-    join16(projectRoot, "app", "layout.tsx"),
-    join16(projectRoot, "app", "layout.jsx")
+    join15(projectRoot, "src", "app", "layout.tsx"),
+    join15(projectRoot, "src", "app", "layout.jsx"),
+    join15(projectRoot, "app", "layout.tsx"),
+    join15(projectRoot, "app", "layout.jsx")
   ];
   for (const layoutPath of layoutPaths) {
-    if (!existsSync16(layoutPath)) continue;
+    if (!existsSync15(layoutPath)) continue;
     let content;
     try {
-      content = readFileSync13(layoutPath, "utf-8");
+      content = readFileSync12(layoutPath, "utf-8");
     } catch {
       continue;
     }
@@ -3611,16 +1827,16 @@ function checkLayoutFiles(projectRoot) {
   const subLayoutDirs = ["dashboard", "admin", "app"];
   for (const sub of subLayoutDirs) {
     const paths = [
-      join16(projectRoot, "src", "app", sub, "layout.tsx"),
-      join16(projectRoot, "src", "app", sub, "layout.jsx"),
-      join16(projectRoot, "app", sub, "layout.tsx"),
-      join16(projectRoot, "app", sub, "layout.jsx")
+      join15(projectRoot, "src", "app", sub, "layout.tsx"),
+      join15(projectRoot, "src", "app", sub, "layout.jsx"),
+      join15(projectRoot, "app", sub, "layout.tsx"),
+      join15(projectRoot, "app", sub, "layout.jsx")
     ];
     for (const layoutPath of paths) {
-      if (!existsSync16(layoutPath)) continue;
+      if (!existsSync15(layoutPath)) continue;
       let content;
       try {
-        content = readFileSync13(layoutPath, "utf-8");
+        content = readFileSync12(layoutPath, "utf-8");
       } catch {
         continue;
       }
@@ -3656,8 +1872,8 @@ function scanLayout(projectRoot) {
 }
 
 // src/analyzers/features.ts
-import { existsSync as existsSync17, readdirSync as readdirSync5, statSync as statSync3 } from "fs";
-import { join as join17 } from "path";
+import { existsSync as existsSync16, readdirSync as readdirSync5, statSync as statSync3 } from "fs";
+import { join as join16 } from "path";
 var FEATURE_PATTERNS = {
   auth: ["login", "signin", "sign-in", "signup", "sign-up", "register", "auth", "callback", "signout", "sign-out", "logout", "forgot-password", "reset-password", "verify-email"],
   dashboard: ["dashboard", "overview", "analytics", "metrics", "stats"],
@@ -3685,7 +1901,7 @@ function collectPaths(dir, baseDir, depth = 0) {
   }
   for (const entry of entries) {
     if (entry.startsWith(".") || entry.startsWith("_") || entry === "node_modules" || entry === "api") continue;
-    const fullPath = join17(dir, entry);
+    const fullPath = join16(dir, entry);
     const relPath = fullPath.slice(baseDir.length + 1);
     paths.push(relPath);
     try {
@@ -3702,16 +1918,16 @@ function scanFeatures(projectRoot) {
   const detected = [];
   const evidence = {};
   const scanDirs = [
-    join17(projectRoot, "src", "app"),
-    join17(projectRoot, "app"),
-    join17(projectRoot, "src", "pages"),
-    join17(projectRoot, "pages"),
-    join17(projectRoot, "src", "components"),
-    join17(projectRoot, "components")
+    join16(projectRoot, "src", "app"),
+    join16(projectRoot, "app"),
+    join16(projectRoot, "src", "pages"),
+    join16(projectRoot, "pages"),
+    join16(projectRoot, "src", "components"),
+    join16(projectRoot, "components")
   ];
   const allPaths = [];
   for (const dir of scanDirs) {
-    if (existsSync17(dir)) {
+    if (existsSync16(dir)) {
       allPaths.push(...collectPaths(dir, projectRoot));
     }
   }
@@ -3735,8 +1951,8 @@ function scanFeatures(projectRoot) {
 }
 
 // src/analyzers/dependencies.ts
-import { existsSync as existsSync18, readFileSync as readFileSync14 } from "fs";
-import { join as join18 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync13 } from "fs";
+import { join as join17 } from "path";
 var CATEGORIES = {
   ui: [
     "react",
@@ -3884,11 +2100,11 @@ function scanDependencies(projectRoot) {
     styling: [],
     other: []
   };
-  const pkgPath = join18(projectRoot, "package.json");
-  if (!existsSync18(pkgPath)) return result;
+  const pkgPath = join17(projectRoot, "package.json");
+  if (!existsSync17(pkgPath)) return result;
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync14(pkgPath, "utf-8"));
+    pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
   } catch {
     return result;
   }
@@ -3949,12 +2165,12 @@ ${BOLD3}Analyzing project...${RESET8}
     features,
     dependencies
   };
-  const decantrDir = join19(projectRoot, ".decantr");
-  if (!existsSync19(decantrDir)) {
-    mkdirSync5(decantrDir, { recursive: true });
+  const decantrDir = join18(projectRoot, ".decantr");
+  if (!existsSync18(decantrDir)) {
+    mkdirSync4(decantrDir, { recursive: true });
   }
-  const outputPath = join19(decantrDir, "analysis.json");
-  writeFileSync10(outputPath, JSON.stringify(analysis, null, 2) + "\n", "utf-8");
+  const outputPath = join18(decantrDir, "analysis.json");
+  writeFileSync9(outputPath, JSON.stringify(analysis, null, 2) + "\n", "utf-8");
   console.log(`
 ${GREEN8}Analysis complete.${RESET8}
 `);
@@ -4143,25 +2359,25 @@ async function cmdGet(type, id) {
   };
   const apiType = typeMap[type];
   const registryClient = new RegistryClient({
-    cacheDir: join20(process.cwd(), ".decantr", "cache")
+    cacheDir: join19(process.cwd(), ".decantr", "cache")
   });
   const result = await registryClient.fetchContentItem(apiType, id);
   if (result) {
     console.log(JSON.stringify(result.data, null, 2));
     return;
   }
-  const currentDir = dirname2(fileURLToPath2(import.meta.url));
+  const currentDir = dirname(fileURLToPath(import.meta.url));
   const bundledCandidates = [
-    join20(currentDir, "bundled", apiType, `${id}.json`),
+    join19(currentDir, "bundled", apiType, `${id}.json`),
     // Running from src/
-    join20(currentDir, "..", "src", "bundled", apiType, `${id}.json`),
+    join19(currentDir, "..", "src", "bundled", apiType, `${id}.json`),
     // Running from dist/
-    join20(currentDir, "..", "bundled", apiType, `${id}.json`)
+    join19(currentDir, "..", "bundled", apiType, `${id}.json`)
     // Alternative dist layout
   ];
-  const bundledPath = bundledCandidates.find((p) => existsSync20(p)) || null;
+  const bundledPath = bundledCandidates.find((p) => existsSync19(p)) || null;
   if (bundledPath) {
-    const data = JSON.parse(readFileSync15(bundledPath, "utf-8"));
+    const data = JSON.parse(readFileSync14(bundledPath, "utf-8"));
     console.log(JSON.stringify(data, null, 2));
     return;
   }
@@ -4173,13 +2389,13 @@ function buildRegistryContext() {
   const themeRegistry = /* @__PURE__ */ new Map();
   const patternRegistry = /* @__PURE__ */ new Map();
   const projectRoot = process.cwd();
-  const cacheDir = join20(projectRoot, ".decantr", "cache");
-  const customDir = join20(projectRoot, ".decantr", "custom");
-  const cachedThemesDir = join20(cacheDir, "@official", "themes");
+  const cacheDir = join19(projectRoot, ".decantr", "cache");
+  const customDir = join19(projectRoot, ".decantr", "custom");
+  const cachedThemesDir = join19(cacheDir, "@official", "themes");
   try {
-    if (existsSync20(cachedThemesDir)) {
+    if (existsSync19(cachedThemesDir)) {
       for (const f of readdirSync6(cachedThemesDir).filter((f2) => f2.endsWith(".json") && f2 !== "index.json")) {
-        const data = JSON.parse(readFileSync15(join20(cachedThemesDir, f), "utf-8"));
+        const data = JSON.parse(readFileSync14(join19(cachedThemesDir, f), "utf-8"));
         if (data.id && !themeRegistry.has(data.id)) {
           themeRegistry.set(data.id, { modes: data.modes || ["light", "dark"] });
         }
@@ -4187,11 +2403,11 @@ function buildRegistryContext() {
     }
   } catch {
   }
-  const customThemesDir = join20(customDir, "themes");
+  const customThemesDir = join19(customDir, "themes");
   try {
-    if (existsSync20(customThemesDir)) {
+    if (existsSync19(customThemesDir)) {
       for (const f of readdirSync6(customThemesDir).filter((f2) => f2.endsWith(".json"))) {
-        const data = JSON.parse(readFileSync15(join20(customThemesDir, f), "utf-8"));
+        const data = JSON.parse(readFileSync14(join19(customThemesDir, f), "utf-8"));
         if (data.id) {
           themeRegistry.set(`custom:${data.id}`, { modes: data.modes || ["light", "dark"] });
         }
@@ -4199,11 +2415,11 @@ function buildRegistryContext() {
     }
   } catch {
   }
-  const cachedPatternsDir = join20(cacheDir, "@official", "patterns");
+  const cachedPatternsDir = join19(cacheDir, "@official", "patterns");
   try {
-    if (existsSync20(cachedPatternsDir)) {
+    if (existsSync19(cachedPatternsDir)) {
       for (const f of readdirSync6(cachedPatternsDir).filter((f2) => f2.endsWith(".json") && f2 !== "index.json")) {
-        const data = JSON.parse(readFileSync15(join20(cachedPatternsDir, f), "utf-8"));
+        const data = JSON.parse(readFileSync14(join19(cachedPatternsDir, f), "utf-8"));
         if (data.id && !patternRegistry.has(data.id)) {
           patternRegistry.set(data.id, data);
         }
@@ -4214,10 +2430,10 @@ function buildRegistryContext() {
   return { themeRegistry, patternRegistry };
 }
 async function cmdValidate(path) {
-  const essencePath = path || join20(process.cwd(), "decantr.essence.json");
+  const essencePath = path || join19(process.cwd(), "decantr.essence.json");
   let raw;
   try {
-    raw = readFileSync15(essencePath, "utf-8");
+    raw = readFileSync14(essencePath, "utf-8");
   } catch {
     console.error(error(`Could not read ${essencePath}`));
     process.exitCode = 1;
@@ -4272,7 +2488,7 @@ async function cmdList(type) {
     return;
   }
   const registryClient = new RegistryClient({
-    cacheDir: join20(process.cwd(), ".decantr", "cache")
+    cacheDir: join19(process.cwd(), ".decantr", "cache")
   });
   const result = await registryClient.fetchContentList(type);
   const items = result.data.items;
@@ -4319,7 +2535,7 @@ async function cmdInit(args) {
     }
   }
   const registryClient = new RegistryClient({
-    cacheDir: join20(projectRoot, ".decantr", "cache"),
+    cacheDir: join19(projectRoot, ".decantr", "cache"),
     apiUrl: args.registry,
     offline: args.offline
   });
@@ -4598,7 +2814,7 @@ ${YELLOW6}You're offline. Scaffolding Decantr default.${RESET9}`);
   console.log(`    ${cyan("decantr upgrade")}    Update to latest patterns`);
   console.log(`    ${cyan("decantr check")}      Detect drift issues`);
   console.log(`    ${cyan("decantr migrate")}    Migrate v2 essence to v3`);
-  const essenceContent = readFileSync15(result.essencePath, "utf-8");
+  const essenceContent = readFileSync14(result.essencePath, "utf-8");
   const essence = JSON.parse(essenceContent);
   const validation = validateEssence2(essence);
   if (!validation.valid) {
@@ -4636,16 +2852,16 @@ Validation warnings: ${validation.errors.join(", ")}`));
 }
 async function cmdStatus() {
   const projectRoot = process.cwd();
-  const essencePath = join20(projectRoot, "decantr.essence.json");
-  const projectJsonPath = join20(projectRoot, ".decantr", "project.json");
+  const essencePath = join19(projectRoot, "decantr.essence.json");
+  const projectJsonPath = join19(projectRoot, ".decantr", "project.json");
   console.log(heading("Decantr Project Status"));
-  if (!existsSync20(essencePath)) {
+  if (!existsSync19(essencePath)) {
     console.log(`${RED7}No decantr.essence.json found.${RESET9}`);
     console.log(dim('Run "decantr init" to create one.'));
     return;
   }
   try {
-    const essence = JSON.parse(readFileSync15(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync14(essencePath, "utf-8"));
     const validation = validateEssence2(essence);
     const essenceVersion = isV36(essence) ? "v3" : "v2";
     console.log(`${BOLD4}Essence:${RESET9}`);
@@ -4687,9 +2903,9 @@ async function cmdStatus() {
   }
   console.log("");
   console.log(`${BOLD4}Sync Status:${RESET9}`);
-  if (existsSync20(projectJsonPath)) {
+  if (existsSync19(projectJsonPath)) {
     try {
-      const projectJson = JSON.parse(readFileSync15(projectJsonPath, "utf-8"));
+      const projectJson = JSON.parse(readFileSync14(projectJsonPath, "utf-8"));
       const syncStatus = projectJson.sync?.status || "unknown";
       const lastSync = projectJson.sync?.lastSync || "never";
       const source = projectJson.sync?.registrySource || "unknown";
@@ -4707,7 +2923,7 @@ async function cmdStatus() {
 }
 async function cmdSync() {
   const projectRoot = process.cwd();
-  const cacheDir = join20(projectRoot, ".decantr", "cache");
+  const cacheDir = join19(projectRoot, ".decantr", "cache");
   console.log(heading("Syncing registry content..."));
   const result = await syncRegistry(cacheDir);
   if (result.synced.length > 0) {
@@ -4725,15 +2941,15 @@ async function cmdSync() {
 }
 async function cmdAudit() {
   const projectRoot = process.cwd();
-  const essencePath = join20(projectRoot, "decantr.essence.json");
+  const essencePath = join19(projectRoot, "decantr.essence.json");
   console.log(heading("Auditing project..."));
-  if (!existsSync20(essencePath)) {
+  if (!existsSync19(essencePath)) {
     console.log(`${RED7}No decantr.essence.json found.${RESET9}`);
     process.exitCode = 1;
     return;
   }
   try {
-    const essence = JSON.parse(readFileSync15(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync14(essencePath, "utf-8"));
     const validation = validateEssence2(essence);
     if (!validation.valid) {
       console.log(`${RED7}Essence validation failed:${RESET9}`);
@@ -4833,14 +3049,14 @@ ${BOLD4}Examples:${RESET9}
         process.exitCode = 1;
         return;
       }
-      const themePath = join20(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
-      if (!existsSync20(themePath)) {
+      const themePath = join19(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
+      if (!existsSync19(themePath)) {
         console.error(error(`Theme "${name}" not found at ${themePath}`));
         process.exitCode = 1;
         return;
       }
       try {
-        const theme = JSON.parse(readFileSync15(themePath, "utf-8"));
+        const theme = JSON.parse(readFileSync14(themePath, "utf-8"));
         const result = validateCustomTheme(theme);
         if (result.valid) {
           console.log(success(`Custom theme "${name}" is valid`));
@@ -5025,8 +3241,9 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-ZSLT32KN.js");
-      await cmdUpgrade(process.cwd());
+      const { cmdUpgrade } = await import("./upgrade-EHMDEZGC.js");
+      const applyFlag = args.includes("--apply");
+      await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;
     }
     case "check":