@decantr/cli 1.5.3 → 1.5.4

package/dist/bin.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import "./chunk-QZVA3PFR.js";
-import "./chunk-B5OX2EXL.js";
+import "./chunk-D3W3MYKT.js";
+import "./chunk-T7CQSJGV.js";

package/dist/{chunk-QZVA3PFR.js → chunk-D3W3MYKT.js}

@@ -9,7 +9,7 @@ import {
   scaffoldMinimal,
   scaffoldProject,
   syncRegistry
-} from "./chunk-B5OX2EXL.js";
+} from "./chunk-T7CQSJGV.js";
 
 // src/index.ts
 import { readFileSync as readFileSync15, existsSync as existsSync23, readdirSync as readdirSync6 } from "fs";
@@ -284,7 +284,7 @@ async function runInteractivePrompts(detected, archetypes, blueprints, themes) {
     "Guard enforcement level",
     [
       { value: "creative", label: "creative", description: "Advisory only (new projects)" },
-      { value: "guided", label: "guided", description: "Style, structure, recipe enforced" },
+      { value: "guided", label: "guided", description: "Style, structure, density enforced" },
       { value: "strict", label: "strict", description: "All 5 rules enforced exactly" }
     ],
     detected.existingEssence ? 1 : 2
@@ -649,7 +649,6 @@ import { join as join4 } from "path";
 import { RegistryAPIClient } from "@decantr/registry";
 var PLURAL_TO_SINGULAR = {
   patterns: "pattern",
-  recipes: "recipe",
   themes: "theme",
   blueprints: "blueprint",
   archetypes: "archetype",
@@ -657,7 +656,6 @@ var PLURAL_TO_SINGULAR = {
 };
 var SINGULAR_TO_PLURAL = {
   pattern: "patterns",
-  recipe: "recipes",
   theme: "themes",
   blueprint: "blueprints",
   archetype: "archetypes",
@@ -710,10 +708,9 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
 // src/commands/create.ts
 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 CONTENT_TYPES = ["pattern", "theme", "blueprint", "archetype", "shell"];
 var PLURAL = {
   pattern: "patterns",
-  recipe: "recipes",
   theme: "themes",
   blueprint: "blueprints",
   archetype: "archetypes",
@@ -730,8 +727,6 @@ function getSkeleton(type, id, name) {
   switch (type) {
     case "pattern":
       return { ...base, components: [], presets: {}, layout: {} };
-    case "recipe":
-      return { ...base, shell: {}, spatial: {}, effects: {} };
     case "theme":
       return { ...base, seed: { primary: "#6500C6", secondary: "#0AF3EB", accent: "#F58882", background: "#0D0D1A" }, modes: ["dark"], shapes: ["rounded"] };
     case "blueprint":
@@ -1339,7 +1334,7 @@ var DIM7 = "\x1B[2m";
 var RESET7 = "\x1B[0m";
 async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   if (!themeName) {
-    console.error(`${RED6}Usage: decantr theme switch <themeName> [--recipe <r>] [--shape <s>] [--mode <m>]${RESET7}`);
+    console.error(`${RED6}Usage: decantr theme switch <themeName> [--shape <s>] [--mode <m>]${RESET7}`);
     process.exitCode = 1;
     return;
   }
@@ -1363,16 +1358,11 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
     return;
   }
   const essence = migrateV30ToV313(parsed);
-  let recipe;
   let shape;
   let mode;
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
-    if (arg.startsWith("--recipe=")) {
-      recipe = arg.split("=")[1];
-    } else if (arg === "--recipe" && args[i + 1] && !args[i + 1].startsWith("-")) {
-      recipe = args[++i];
-    } else if (arg.startsWith("--shape=")) {
+    if (arg.startsWith("--shape=")) {
       shape = arg.split("=")[1];
     } else if (arg === "--shape" && args[i + 1] && !args[i + 1].startsWith("-")) {
       shape = args[++i];
@@ -1382,13 +1372,10 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
       mode = args[++i];
     }
   }
-  const oldStyle = essence.dna.theme.style;
-  essence.dna.theme.style = themeName;
-  if (recipe) {
-    essence.dna.theme.recipe = recipe;
-  } else {
-    essence.dna.theme.recipe = themeName;
-  }
+  const oldThemeId = essence.dna.theme.id || essence.dna.theme.style;
+  essence.dna.theme.id = themeName;
+  delete essence.dna.theme.style;
+  delete essence.dna.theme.recipe;
   if (shape) {
     essence.dna.theme.shape = shape;
   }
@@ -1398,29 +1385,27 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   const registryClient = new RegistryClient({
     cacheDir: join11(projectRoot, ".decantr", "cache")
   });
-  const recipeName = essence.dna.theme.recipe;
   try {
-    const recipeResult = await registryClient.fetchRecipe(recipeName);
-    if (recipeResult?.data) {
-      const raw = recipeResult.data;
+    const themeResult = await registryClient.fetchTheme(themeName);
+    if (themeResult?.data) {
+      const raw = themeResult.data;
       const inner = raw.data ?? raw;
-      if (inner.radius_hints) {
+      if (inner.radius) {
         essence.dna.radius = {
           ...essence.dna.radius,
-          philosophy: inner.radius_hints.philosophy || essence.dna.radius.philosophy,
-          base: inner.radius_hints.base ?? essence.dna.radius.base
+          philosophy: inner.radius.philosophy || essence.dna.radius.philosophy,
+          base: inner.radius.base ?? essence.dna.radius.base
         };
       }
     }
   } catch {
   }
   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}`);
+  console.log(`${GREEN7}Switched theme: ${oldThemeId} \u2192 ${themeName}${RESET7}`);
   if (shape) console.log(`  ${DIM7}Shape: ${shape}${RESET7}`);
   if (mode) console.log(`  ${DIM7}Mode: ${mode}${RESET7}`);
   await refreshDerivedFiles(projectRoot, essence, registryClient);
-  console.log(`${GREEN7}Derived files refreshed (tokens.css, decorators.css, all contexts).${RESET7}`);
+  console.log(`${GREEN7}Derived files refreshed (tokens.css, treatments.css, all contexts).${RESET7}`);
   console.log(`${YELLOW4}Guard will flag code using old tokens. Run \`decantr check\`.${RESET7}`);
 }
 
@@ -2467,7 +2452,7 @@ async function cmdMagic(prompt, projectRoot, options) {
     existing: false
   };
   if (blueprintData) {
-    if (blueprintData.theme?.style) initOptions.theme = blueprintData.theme.style;
+    if (blueprintData.theme?.id || blueprintData.theme?.style) initOptions.theme = blueprintData.theme.id || blueprintData.theme.style;
     if (blueprintData.theme?.mode) initOptions.mode = blueprintData.theme.mode;
     if (blueprintData.theme?.shape) initOptions.shape = blueprintData.theme.shape;
     if (blueprintData.personality) {
@@ -2499,8 +2484,6 @@ async function cmdMagic(prompt, projectRoot, options) {
   let patternSpecs;
   let topologyMarkdown = "";
   let themeData;
-  let recipeData;
-  let blueprintRecipeName;
   let registrySource = apiAvailable ? "api" : "cache";
   if (blueprintData?.compose && blueprintData.compose.length > 0) {
     const entries = blueprintData.compose;
@@ -2604,7 +2587,6 @@ async function cmdMagic(prompt, projectRoot, options) {
         initOptions.personality
       );
     }
-    blueprintRecipeName = blueprintData.theme?.recipe;
     console.log(`${BOLD4} Composition:${RESET9}`);
     console.log(`   Sections:  ${composedSections.sections.length} (${composedSections.sections.map((s) => s.id).join(", ")})`);
     const totalRoutes = Object.keys(routeMap).length;
@@ -2630,23 +2612,16 @@ async function cmdMagic(prompt, projectRoot, options) {
         palette: theme.palette,
         tokens: theme.tokens,
         cvd_support: theme.cvd_support,
-        typography_hints: theme.typography_hints,
-        motion_hints: theme.motion_hints
-      };
-      if (theme.decorators) {
-        recipeData = { decorators: theme.decorators };
-      }
-    }
-    const recipeName = blueprintRecipeName || initOptions.theme;
-    const recipeResult = await registryClient.fetchRecipe(recipeName);
-    if (recipeResult) {
-      const rawRecipe = recipeResult.data;
-      const recipe = rawRecipe.data ?? rawRecipe;
-      recipeData = {
-        decorators: recipe.decorators || recipeData?.decorators,
-        spatial_hints: recipe.spatial_hints,
-        radius_hints: recipe.radius_hints,
-        treatment_overrides: recipe.treatment_overrides
+        typography: theme.typography,
+        motion: theme.motion,
+        decorators: theme.decorators,
+        treatments: theme.treatments,
+        spatial: theme.spatial,
+        radius: theme.radius,
+        shell: theme.shell,
+        effects: theme.effects,
+        compositions: theme.compositions,
+        pattern_preferences: theme.pattern_preferences
       };
     }
   }
@@ -2659,7 +2634,6 @@ async function cmdMagic(prompt, projectRoot, options) {
     archetypeData,
     registrySource,
     themeData,
-    recipeData,
     topologyMarkdown,
     composedSections,
     routeMap,
@@ -2916,7 +2890,6 @@ var ALL_CONTENT_TYPES = [
   "patterns",
   "archetypes",
   "themes",
-  "recipes",
   "blueprints",
   "shells"
 ];
@@ -3359,7 +3332,7 @@ async function cmdSuggest(query, type) {
   }
 }
 async function cmdGet(type, id) {
-  const validTypes = ["pattern", "archetype", "recipe", "theme", "blueprint", "shell"];
+  const validTypes = ["pattern", "archetype", "theme", "blueprint", "shell"];
   if (!validTypes.includes(type)) {
     console.error(error3(`Invalid type "${type}". Must be one of: ${validTypes.join(", ")}`));
     process.exitCode = 1;
@@ -3368,7 +3341,6 @@ async function cmdGet(type, id) {
   const typeMap = {
     pattern: "patterns",
     archetype: "archetypes",
-    recipe: "recipes",
     theme: "themes",
     blueprint: "blueprints",
     shell: "shells"
@@ -3497,7 +3469,7 @@ async function cmdValidate(path) {
   }
 }
 async function cmdList(type) {
-  const validTypes = ["patterns", "archetypes", "recipes", "themes", "blueprints", "shells"];
+  const validTypes = ["patterns", "archetypes", "themes", "blueprints", "shells"];
   if (!validTypes.includes(type)) {
     console.error(error3(`Invalid type "${type}". Must be one of: ${validTypes.join(", ")}`));
     process.exitCode = 1;
@@ -3611,7 +3583,6 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
   } else {
     options = await runInteractivePrompts(detected, archetypes, blueprints, themes);
   }
-  let blueprintRecipeName;
   let topologyMarkdown = "";
   let archetypeData;
   let composedSections;
@@ -3624,8 +3595,8 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
       const rawBlueprint = blueprintResult.data;
       const blueprint = rawBlueprint.data ?? rawBlueprint;
       if (blueprint.theme) {
-        if (blueprint.theme.style && options.theme === "luminarum") {
-          options.theme = blueprint.theme.style;
+        if ((blueprint.theme.id || blueprint.theme.style) && options.theme === "luminarum") {
+          options.theme = blueprint.theme.id || blueprint.theme.style;
         }
         if (blueprint.theme.mode && options.mode === "dark") {
           options.mode = blueprint.theme.mode;
@@ -3637,7 +3608,6 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
       if (blueprint.personality && (!options.personality || options.personality.length === 0 || options.personality.length === 1 && options.personality[0] === "professional")) {
         options.personality = typeof blueprint.personality === "string" ? [blueprint.personality] : blueprint.personality;
       }
-      blueprintRecipeName = blueprint.theme?.recipe;
       if (blueprint.compose && blueprint.compose.length > 0) {
         const entries = blueprint.compose;
         const results = [];
@@ -3754,7 +3724,6 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
     }
   }
   let themeData;
-  let recipeData;
   if (options.theme) {
     const themeResult = await registryClient.fetchTheme(options.theme);
     if (themeResult) {
@@ -3765,31 +3734,20 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
         palette: theme.palette,
         tokens: theme.tokens,
         cvd_support: theme.cvd_support,
-        typography_hints: theme.typography_hints,
-        motion_hints: theme.motion_hints
+        typography: theme.typography,
+        motion: theme.motion,
+        decorators: theme.decorators,
+        treatments: theme.treatments,
+        spatial: theme.spatial,
+        radius: theme.radius,
+        shell: theme.shell,
+        effects: theme.effects,
+        compositions: theme.compositions,
+        pattern_preferences: theme.pattern_preferences
       };
-      if (theme.decorators) {
-        recipeData = { decorators: theme.decorators };
-      }
     } else {
       console.log(`${YELLOW9}  Warning: Could not fetch theme "${options.theme}". Using defaults.${RESET13}`);
     }
-    const recipeName = blueprintRecipeName || options.theme;
-    const recipeResult = await registryClient.fetchRecipe(recipeName);
-    if (process.env.DECANTR_DEBUG && recipeResult) {
-      const dbg = recipeResult.data;
-      console.error(`  [debug] recipe source: ${recipeResult.source.type}, keys: ${Object.keys(dbg).join(",")}, has .data: ${"data" in dbg}, has .decorators: ${"decorators" in dbg}, inner.decorators: ${!!dbg.data?.decorators}`);
-    }
-    if (recipeResult) {
-      const rawRecipe = recipeResult.data;
-      const recipe = rawRecipe.data ?? rawRecipe;
-      recipeData = {
-        decorators: recipe.decorators || recipeData?.decorators,
-        spatial_hints: recipe.spatial_hints,
-        radius_hints: recipe.radius_hints,
-        treatment_overrides: recipe.treatment_overrides
-      };
-    }
   }
   console.log(heading2("Scaffolding project..."));
   const result = await scaffoldProject(
@@ -3800,7 +3758,6 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
     archetypeData,
     registrySource,
     themeData,
-    recipeData,
     topologyMarkdown,
     // V3.1 composition data:
     composedSections,
@@ -4130,7 +4087,7 @@ ${BOLD6}Examples:${RESET13}
     case "switch": {
       const name = args[1];
       if (!name) {
-        console.error(error3("Usage: decantr theme switch <themeName> [--recipe <r>] [--shape <s>] [--mode <m>]"));
+        console.error(error3("Usage: decantr theme switch <themeName> [--shape <s>] [--mode <m>]"));
         process.exitCode = 1;
         return;
       }
@@ -4199,7 +4156,7 @@ ${BOLD6}Commands:${RESET13}
   ${cyan3("list")}        List items by type
   ${cyan3("validate")}    Validate essence file (v2 and v3)
   ${cyan3("theme")}       Manage custom themes (create, list, validate, delete, import)
-  ${cyan3("create")}      Create a custom content item (pattern, recipe, theme, etc.)
+  ${cyan3("create")}      Create a custom content item (pattern, theme, blueprint, etc.)
   ${cyan3("publish")}     Publish a custom content item to the community registry
   ${cyan3("login")}       Authenticate with the Decantr registry
   ${cyan3("logout")}      Remove stored credentials
@@ -4299,7 +4256,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-LTLUPBZQ.js");
+      const { cmdUpgrade } = await import("./upgrade-TXVD2WIN.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;
@@ -4309,7 +4266,7 @@ async function main() {
       if (command === "heal") {
         console.log(`${YELLOW9}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET13}`);
       }
-      const { cmdHeal } = await import("./heal-54MKDDSQ.js");
+      const { cmdHeal } = await import("./heal-VYEGIUAS.js");
       const telemetryFlag = args.includes("--telemetry");
       await cmdHeal(process.cwd(), { telemetry: telemetryFlag });
       break;
@@ -4432,7 +4389,7 @@ async function main() {
       const name = args[2];
       if (!type || !name) {
         console.error(error3("Usage: decantr create <type> <name>"));
-        console.error(dim3("Types: pattern, recipe, theme, blueprint, archetype, shell"));
+        console.error(dim3("Types: pattern, theme, blueprint, archetype, shell"));
         process.exitCode = 1;
         break;
       }
@@ -4444,7 +4401,7 @@ async function main() {
       const name = args[2];
       if (!type || !name) {
         console.error(error3("Usage: decantr publish <type> <name>"));
-        console.error(dim3("Types: pattern, recipe, theme, blueprint, archetype, shell"));
+        console.error(dim3("Types: pattern, theme, blueprint, archetype, shell"));
         process.exitCode = 1;
         break;
       }

package/dist/{chunk-B5OX2EXL.js → chunk-T7CQSJGV.js}

@@ -5,7 +5,7 @@ import { fileURLToPath } from "url";
 import { computeSpatialTokens } from "@decantr/essence-spec";
 
 // src/treatments.ts
-function generateTreatmentCSS(spatialTokens, treatmentOverrides, recipeDecorators, recipeName) {
+function generateTreatmentCSS(spatialTokens, treatmentOverrides, themeDecorators, themeName) {
   const lines = [];
   lines.push("/* Generated by @decantr/cli \u2014 Visual Treatment System */");
   lines.push("");
@@ -185,11 +185,11 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, recipeDecorator
     ["background", "color-mix(in srgb, var(--d-info) 15%, transparent)"],
     ["color", "var(--d-info)"]
   ]);
-  if (recipeDecorators && Object.keys(recipeDecorators).length > 0) {
-    const label = recipeName ? ` (${recipeName})` : "";
-    lines.push(`/* \u2500\u2500 Layer 3: Recipe Decorators${label} \u2500\u2500 */`);
+  if (themeDecorators && Object.keys(themeDecorators).length > 0) {
+    const label = themeName ? ` (${themeName})` : "";
+    lines.push(`/* \u2500\u2500 Layer 3: Theme Decorators${label} \u2500\u2500 */`);
     lines.push("");
-    for (const [name, description] of Object.entries(recipeDecorators)) {
+    for (const [name, description] of Object.entries(themeDecorators)) {
       const rule = generateDecoratorRule(name, description);
       lines.push(rule);
       lines.push("");
@@ -520,6 +520,21 @@ function generateTokensCSS(themeData, mode, spatialTokens) {
     };
   }
   const tokens = buildTokens(resolvedMode);
+  if (themeData?.typography?.mono) {
+    tokens["--d-font-mono"] = themeData.typography.mono;
+  }
+  if (themeData?.palette?.["accent-glow"]?.[resolvedMode]) {
+    tokens["--d-accent-glow"] = themeData.palette["accent-glow"][resolvedMode];
+  }
+  if (themeData?.motion?.durations?.hover) {
+    tokens["--d-duration-hover"] = themeData.motion.durations.hover;
+  }
+  if (themeData?.motion?.durations?.entrance) {
+    tokens["--d-duration-entrance"] = themeData.motion.durations.entrance;
+  }
+  if (themeData?.motion?.timing) {
+    tokens["--d-easing"] = themeData.motion.timing;
+  }
   const lines = Object.entries(tokens).map(([key, value]) => `  ${key}: ${value};`).join("\n");
   const spatialLines = spatialTokens ? "\n" + Object.entries(spatialTokens).map(([k, v]) => `  ${k}: ${v};`).join("\n") : "";
   let css = `/* Generated by @decantr/cli */
@@ -612,20 +627,20 @@ input, button, textarea, select {
 }
 `;
 }
-function generateTreatmentsContext(recipeData, recipeName) {
+function generateTreatmentsContext(themeData, themeName) {
   const lines = [];
-  lines.push(`# Visual Treatments: ${recipeName}`);
+  lines.push(`# Visual Treatments: ${themeName}`);
   lines.push("");
   lines.push("## Base Treatments");
   lines.push("");
   lines.push("d-interactive, d-surface, d-data, d-control, d-section, d-annotation \u2014 see DECANTR.md for usage.");
   lines.push("");
-  if (recipeData?.decorators && Object.keys(recipeData.decorators).length > 0) {
-    lines.push(`## Recipe Decorators (${recipeName}-specific)`);
+  if (themeData?.decorators && Object.keys(themeData.decorators).length > 0) {
+    lines.push(`## Theme Decorators (${themeName}-specific)`);
     lines.push("");
     lines.push("| Class | Use for |");
     lines.push("|-------|---------|");
-    for (const [name, description] of Object.entries(recipeData.decorators)) {
+    for (const [name, description] of Object.entries(themeData.decorators)) {
       const useFor = description.split(".")[0].trim();
       lines.push(`| ${name} | ${useFor} |`);
     }
@@ -633,12 +648,12 @@ function generateTreatmentsContext(recipeData, recipeName) {
   }
   lines.push("## Composition");
   lines.push("");
-  lines.push("Atoms + treatment + recipe decorator:");
+  lines.push("Atoms + treatment + theme decorator:");
   lines.push("```tsx");
   lines.push(`css('_flex _col _gap4') + ' d-surface'`);
   lines.push("```");
   lines.push("");
-  lines.push("Atoms use `css()` function. Treatments and recipe decorators are plain class strings.");
+  lines.push("Atoms use `css()` function. Treatments and theme decorators are plain class strings.");
   return lines.join("\n");
 }
 function generateDecoratorRule(name, description) {
@@ -876,7 +891,7 @@ function buildEssence(options, archetypeData) {
       style: options.theme,
       mode: options.mode,
       recipe: options.theme,
-      // Recipe defaults to theme
+      // Legacy v2 field — kept for backward compatibility
       shape: options.shape
     },
     personality: options.personality,
@@ -889,6 +904,7 @@ function buildEssence(options, archetypeData) {
     guard: {
       enforce_style: true,
       enforce_recipe: true,
+      // Legacy v2 field — kept for backward compatibility
       mode: options.guard
     },
     density: {
@@ -902,7 +918,7 @@ function buildEssence(options, archetypeData) {
   }
   return essence;
 }
-function buildEssenceV3(options, archetypeData, themeHints, recipeHints) {
+function buildEssenceV3(options, archetypeData, themeHints) {
   let pages = [
     { id: "home", layout: ["hero"] }
   ];
@@ -939,9 +955,8 @@ function buildEssenceV3(options, archetypeData, themeHints, recipeHints) {
   };
   const dna = {
     theme: {
-      style: options.theme,
+      id: options.theme,
       mode: options.mode,
-      recipe: options.theme,
       shape: options.shape
     },
     spacing: {
@@ -951,9 +966,9 @@ function buildEssenceV3(options, archetypeData, themeHints, recipeHints) {
       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
+      scale: themeHints?.typography?.scale || "modular",
+      heading_weight: themeHints?.typography?.heading_weight || 600,
+      body_weight: themeHints?.typography?.body_weight || 400
     },
     color: {
       palette: "semantic",
@@ -961,17 +976,17 @@ function buildEssenceV3(options, archetypeData, themeHints, recipeHints) {
       cvd_preference: options.accessibility?.cvd_preference || "auto"
     },
     radius: {
-      philosophy: recipeHints?.radius_hints?.philosophy || options.shape,
-      base: recipeHints?.radius_hints?.base || shapeRadiusMap[options.shape] || 8
+      philosophy: themeHints?.radius?.philosophy || options.shape,
+      base: themeHints?.radius?.base || shapeRadiusMap[options.shape] || 8
     },
     elevation: {
       system: "layered",
       max_levels: 3
     },
     motion: {
-      preference: recipeHints?.animation?.preference || themeHints?.motion_hints?.preference || "subtle",
+      preference: themeHints?.motion?.preference || "subtle",
       duration_scale: 1,
-      reduce_motion: themeHints?.motion_hints?.reduce_motion_default ?? true
+      reduce_motion: themeHints?.motion?.reduce_motion ?? true
     },
     accessibility: {
       wcag_level: options.accessibility?.wcag_level || "AA",
@@ -1003,21 +1018,21 @@ function buildEssenceV3(options, archetypeData, themeHints, recipeHints) {
 }
 var CSS_APPROACH_CONTENT = `## CSS Implementation
 
-This project uses **@decantr/css** for layout atoms, **visual treatments** for semantic styling, and **recipe decorators** for theme-specific decoration.
+This project uses **@decantr/css** for layout atoms, **visual treatments** for semantic styling, and **theme decorators** for theme-specific decoration.
 
 ### Three File Setup
 
 \`\`\`
 src/styles/
   tokens.css       # Design tokens: --d-primary, --d-surface, --d-bg, etc.
-  treatments.css   # Visual treatments (d-interactive, d-surface, ...) + recipe decorators
+  treatments.css   # Visual treatments (d-interactive, d-surface, ...) + theme decorators
   global.css       # Resets, base typography, sr-only
 \`\`\`
 
 \`\`\`javascript
 import { css } from '@decantr/css';         // Atoms runtime
 import './styles/tokens.css';                // Theme tokens
-import './styles/treatments.css';            // Treatments + recipe decorators
+import './styles/treatments.css';            // Treatments + theme decorators
 import './styles/global.css';                // Resets
 \`\`\`
 
@@ -1036,7 +1051,7 @@ Six base treatment classes provide semantic styling. Combine with atoms for layo
 
 ### Composition
 
-Atoms + treatment + recipe decorator:
+Atoms + treatment + theme decorator:
 
 \`\`\`tsx
 <button className={css('_px4 _py2') + ' d-interactive'} data-variant="primary">Deploy</button>
@@ -1046,7 +1061,7 @@ Atoms + treatment + recipe decorator:
 
 - **Atoms:** \`css('_flex _col _gap4')\` \u2014 processed by @decantr/css runtime
 - **Treatments:** \`d-interactive\`, \`d-surface\` \u2014 semantic base styles from treatments.css
-- **Recipe decorators:** \`carbon-glass\`, \`carbon-code\` \u2014 theme-specific decoration from treatments.css
+- **Theme decorators:** \`carbon-glass\`, \`carbon-code\` \u2014 theme-specific decoration from treatments.css
 - **Combined:** \`css('_flex _col') + ' d-surface carbon-card'\`
 
 ### Atoms Quick Reference
@@ -1067,16 +1082,20 @@ Scale: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24. Example: \`_gap4\` = \`gap:1r
 
 ### Design Tokens
 
-| Token | Purpose |
-|-------|---------|
-| \`--d-primary\` | Primary brand color |
-| \`--d-surface\`, \`--d-surface-raised\` | Surface backgrounds |
-| \`--d-bg\` | Page background |
-| \`--d-border\` | Border color |
-| \`--d-text\`, \`--d-text-muted\` | Text colors |
-| \`--d-success\`, \`--d-error\`, \`--d-warning\`, \`--d-info\` | Status colors |
-| \`--d-shadow\`, \`--d-shadow-lg\` | Elevation shadows |
-| \`--d-radius\`, \`--d-radius-lg\` | Border radii |
+| Token | Purpose | Use for |
+|-------|---------|---------|
+| \`--d-primary\` | Primary brand color | Buttons, links, focus rings |
+| \`--d-surface\`, \`--d-surface-raised\` | Surface backgrounds | Cards, panels |
+| \`--d-bg\` | Page background | Body, main container |
+| \`--d-border\` | Border color | Dividers, card borders |
+| \`--d-text\`, \`--d-text-muted\` | Text colors | Body text, secondary text |
+| \`--d-success\`, \`--d-error\`, \`--d-warning\`, \`--d-info\` | Status colors | Alerts, badges, toasts |
+| \`--d-shadow\`, \`--d-shadow-lg\` | Elevation shadows | Cards, overlays |
+| \`--d-radius\`, \`--d-radius-lg\` | Border radii | Buttons, cards |
+| \`--d-font-mono\` | Monospace font stack | Code, metrics, data |
+| \`--d-duration-hover\` | Hover transition | Interactive elements |
+| \`--d-easing\` | Animation easing | All transitions |
+| \`--d-accent-glow\` | Glow color | Hover effects, focus rings |
 
 ### Routing
 
@@ -1113,8 +1132,7 @@ function generateProjectJson(detected, options, registrySource) {
       cachedContent: {
         archetypes: [],
         patterns: [],
-        themes: [],
-        recipes: []
+        themes: []
       }
     },
     initialized: {
@@ -1147,7 +1165,7 @@ function generateTaskContext(templateName, essence) {
     TARGET: essence.target,
     THEME_STYLE: essence.theme.style,
     THEME_MODE: essence.theme.mode,
-    THEME_RECIPE: essence.theme.recipe,
+    THEME_RECIPE: essence.theme.style,
     DEFAULT_SHELL: defaultShell,
     GUARD_MODE: essence.guard.mode,
     LAYOUT: layout,
@@ -1171,9 +1189,9 @@ function generateTaskContextV3(templateName, essence) {
   const contentGap = essence.dna.spacing?.content_gap || "_gap4";
   const vars = {
     TARGET: essence.meta.target || "react",
-    THEME_STYLE: essence.dna.theme.style,
+    THEME_STYLE: essence.dna.theme.id || essence.dna.theme.style || "",
     THEME_MODE: essence.dna.theme.mode,
-    THEME_RECIPE: essence.dna.theme.recipe || essence.dna.theme.style,
+    THEME_RECIPE: essence.dna.theme.id || essence.dna.theme.style || "",
     DEFAULT_SHELL: defaultShell,
     GUARD_MODE: essence.meta.guard.mode,
     LAYOUT: layout,
@@ -1210,9 +1228,9 @@ ${rows.join("\n")}`;
     BLUEPRINT: "",
     PERSONALITY: (essence.dna.personality || []).join(", "),
     TARGET: essence.meta.target ?? "",
-    THEME_STYLE: essence.dna.theme.style,
+    THEME_STYLE: essence.dna.theme.id ?? essence.dna.theme.style ?? "",
     THEME_MODE: essence.dna.theme.mode,
-    THEME_RECIPE: essence.dna.theme.recipe ?? "",
+    THEME_RECIPE: essence.dna.theme.id ?? essence.dna.theme.style ?? "",
     SHAPE: essence.dna.theme.shape ?? "",
     PAGES_TABLE: pagesTable,
     FEATURES_LIST: featuresList,
@@ -1247,8 +1265,8 @@ ${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);
+async function scaffoldProject(projectRoot, options, detected, registry, archetypeData, registrySource = "cache", themeData, topologyMarkdown, composedSections, routeMap, patternSpecs, blueprintData) {
+  const essenceV3 = buildEssenceV3(options, archetypeData, themeData);
   const essence = buildEssence(options, archetypeData);
   const decantrDir = join(projectRoot, ".decantr");
   const contextDir = join(decantrDir, "context");
@@ -1284,7 +1302,7 @@ async function scaffoldProject(projectRoot, options, detected, registry, archety
     }
     writeFileSync(essencePath, JSON.stringify(essenceV3, null, 2) + "\n");
   }
-  const refreshResult = await refreshDerivedFiles(projectRoot, essenceV3, registry, themeData, recipeData, { isInitialScaffold: true });
+  const refreshResult = await refreshDerivedFiles(projectRoot, essenceV3, registry, themeData, { isInitialScaffold: true });
   contextFiles.push(...refreshResult.contextFiles);
   const gitignoreUpdated = updateGitignore(projectRoot);
   return {
@@ -1299,7 +1317,7 @@ async function scaffoldProject(projectRoot, options, detected, registry, archety
 function scaffoldMinimal(projectRoot) {
   const decantrDir = join(projectRoot, ".decantr");
   const customDir = join(decantrDir, "custom");
-  const contentTypes = ["patterns", "recipes", "themes", "blueprints", "archetypes", "shells"];
+  const contentTypes = ["patterns", "themes", "blueprints", "archetypes", "shells"];
   for (const type of contentTypes) {
     mkdirSync(join(customDir, type), { recursive: true });
   }
@@ -1307,9 +1325,8 @@ function scaffoldMinimal(projectRoot) {
     version: "3.0.0",
     dna: {
       theme: {
-        style: "default",
+        id: "default",
         mode: "dark",
-        recipe: "default",
         shape: "rounded"
       },
       spacing: {
@@ -1391,8 +1408,7 @@ function scaffoldMinimal(projectRoot) {
       cachedContent: {
         archetypes: [],
         patterns: [],
-        themes: [],
-        recipes: []
+        themes: []
       }
     },
     initialized: {
@@ -1486,12 +1502,11 @@ When available, use these tools:
     gitignoreUpdated
   };
 }
-async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThemeData, prefetchedRecipeData, options) {
+async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThemeData, options) {
   const decantrDir = join(projectRoot, ".decantr");
   const contextDir = join(decantrDir, "context");
   mkdirSync(contextDir, { recursive: true });
-  const themeName = essence.dna.theme.style;
-  const recipeName = essence.dna.theme.recipe ?? themeName;
+  const themeName = essence.dna.theme.id || essence.dna.theme.style || "default";
   const mode = essence.dna.theme.mode;
   const guardMode = essence.meta.guard.mode;
   const guardConfig = {
@@ -1501,7 +1516,6 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
   };
   const personality = essence.dna.personality || [];
   let themeData = prefetchedThemeData;
-  let recipeData = prefetchedRecipeData;
   if (!themeData) try {
     const themeResult = await registry.fetchTheme(themeName);
     if (themeResult?.data) {
@@ -1512,53 +1526,20 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
         palette: t.palette,
         cvd_support: t.cvd_support,
         tokens: t.tokens,
-        typography_hints: t.typography_hints,
-        motion_hints: t.motion_hints
+        typography: t.typography,
+        motion: t.motion,
+        decorators: t.decorators,
+        treatments: t.treatments,
+        spatial: t.spatial,
+        radius: t.radius,
+        shell: t.shell,
+        effects: t.effects,
+        compositions: t.compositions,
+        pattern_preferences: t.pattern_preferences
       };
     }
   } catch {
   }
-  if (!recipeData) try {
-    const recipeResult = await registry.fetchRecipe(recipeName);
-    if (recipeResult?.data) {
-      const raw = recipeResult.data;
-      const r = raw.data ?? raw;
-      recipeData = {
-        decorators: r.decorators,
-        spatial_hints: r.spatial_hints,
-        radius_hints: r.radius_hints,
-        treatment_overrides: r.treatment_overrides
-      };
-      if (!recipeData.decorators && raw.data) {
-        const inner = raw.data;
-        if (inner.decorators) {
-          recipeData.decorators = inner.decorators;
-          recipeData.spatial_hints = inner.spatial_hints;
-          recipeData.radius_hints = inner.radius_hints;
-        }
-      }
-    }
-  } catch {
-  }
-  if (!recipeData?.decorators || Object.keys(recipeData.decorators).length === 0) {
-    try {
-      const apiUrl = registry.apiUrl || "https://api.decantr.ai/v1";
-      const resp = await fetch(`${apiUrl}/recipes/@official/${recipeName}`);
-      if (resp.ok) {
-        const apiData = await resp.json();
-        const inner = apiData.data ?? apiData;
-        if (inner.decorators && Object.keys(inner.decorators).length > 0) {
-          recipeData = {
-            decorators: inner.decorators,
-            spatial_hints: inner.spatial_hints,
-            radius_hints: inner.radius_hints,
-            treatment_overrides: inner.treatment_overrides
-          };
-        }
-      }
-    } catch {
-    }
-  }
   if (!themeData?.seed?.primary) {
     try {
       const apiUrl = registry.apiUrl || "https://api.decantr.ai/v1";
@@ -1572,8 +1553,16 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
             palette: inner.palette,
             cvd_support: inner.cvd_support,
             tokens: inner.tokens,
-            typography_hints: inner.typography_hints,
-            motion_hints: inner.motion_hints
+            typography: inner.typography,
+            motion: inner.motion,
+            decorators: inner.decorators,
+            treatments: inner.treatments,
+            spatial: inner.spatial,
+            radius: inner.radius,
+            shell: inner.shell,
+            effects: inner.effects,
+            compositions: inner.compositions,
+            pattern_preferences: inner.pattern_preferences
           };
         }
       }
@@ -1583,10 +1572,10 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
   const stylesDir = join(projectRoot, "src", "styles");
   mkdirSync(stylesDir, { recursive: true });
   const densityLevel = options.density || "comfortable";
-  const spatialTokens = computeSpatialTokens(densityLevel, recipeData?.spatial_hints ? {
-    section_padding: recipeData.spatial_hints.section_padding ?? void 0,
-    density_bias: typeof recipeData.spatial_hints.density_bias === "number" ? recipeData.spatial_hints.density_bias : void 0,
-    content_gap_shift: recipeData.spatial_hints.content_gap_shift
+  const spatialTokens = computeSpatialTokens(densityLevel, themeData?.spatial ? {
+    section_padding: themeData.spatial.section_padding ?? void 0,
+    density_bias: typeof themeData.spatial.density_bias === "number" ? themeData.spatial.density_bias : void 0,
+    content_gap_shift: themeData.spatial.content_gap_shift
   } : void 0);
   const tokensPath = join(stylesDir, "tokens.css");
   const hasRealThemeData = themeData?.seed?.primary || themeData?.palette?.background;
@@ -1596,8 +1585,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
   const treatmentsPath = join(stylesDir, "treatments.css");
   writeFileSync(treatmentsPath, generateTreatmentCSS(
     spatialTokens,
-    recipeData?.treatment_overrides,
-    recipeData?.decorators,
+    themeData?.treatments,
+    themeData?.decorators,
     themeName
   ));
   const globalPath = join(stylesDir, "global.css");
@@ -1606,7 +1595,7 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
   }
   const cssFiles = [tokensPath, treatmentsPath, globalPath];
   const treatmentsMdPath = join(contextDir, "treatments.md");
-  writeFileSync(treatmentsMdPath, generateTreatmentsContext(recipeData, recipeName));
+  writeFileSync(treatmentsMdPath, generateTreatmentsContext(themeData, themeName));
   const decantrMdPath = join(projectRoot, "DECANTR.md");
   writeFileSync(decantrMdPath, generateDecantrMdV31(guardMode, CSS_APPROACH_CONTENT));
   const hasSections = essence.blueprint.sections && essence.blueprint.sections.length > 0;
@@ -1708,8 +1697,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
     const topologyMarkdown = generateTopologySection(topologyData, personality);
     const themeTokensCss = existsSync(tokensPath) ? readFileSync(tokensPath, "utf-8") : "";
     const decoratorList = [];
-    if (recipeData?.decorators) {
-      for (const [name, desc] of Object.entries(recipeData.decorators)) {
+    if (themeData?.decorators) {
+      for (const [name, desc] of Object.entries(themeData.decorators)) {
         decoratorList.push({ name, description: desc });
       }
     } else if (existsSync(decoratorsPath)) {
@@ -1777,7 +1766,6 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
         guardConfig,
         personality,
         themeName,
-        recipeName,
         zoneContext,
         patternSpecs: sectionPatterns,
         constraints: essence.dna.constraints,
@@ -1792,7 +1780,6 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
       appName: essence.meta.archetype || "Application",
       blueprintId: "",
       themeName,
-      recipeName,
       personality,
       topologyMarkdown,
       sections,
@@ -1867,8 +1854,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
     }
     const themeTokensCss = existsSync(tokensPath) ? readFileSync(tokensPath, "utf-8") : "";
     const decoratorList = [];
-    if (recipeData?.decorators) {
-      for (const [name, desc] of Object.entries(recipeData.decorators)) {
+    if (themeData?.decorators) {
+      for (const [name, desc] of Object.entries(themeData.decorators)) {
         decoratorList.push({ name, description: desc });
       }
     } else if (existsSync(decoratorsPath)) {
@@ -1906,7 +1893,6 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
       guardConfig,
       personality,
       themeName,
-      recipeName,
       zoneContext: `This is the primary section (${shell} shell).`,
       patternSpecs,
       constraints: essence.dna.constraints,
@@ -2010,7 +1996,7 @@ function generateSyntheticComponents(patternId, description) {
   return [...new Set(syntheticComponents)];
 }
 function generateSectionContext(input) {
-  const { section, decorators, guardConfig, personality, themeName, recipeName, zoneContext, patternSpecs, recipeHints, constraints, shellInfo } = input;
+  const { section, decorators, guardConfig, personality, themeName, zoneContext, patternSpecs, themeHints, constraints, shellInfo } = input;
   const lines = [];
   lines.push(`# Section: ${section.id}`);
   lines.push("");
@@ -2038,18 +2024,18 @@ function generateSectionContext(input) {
   lines.push("**Visual Treatments:** All 6 base treatments available (see DECANTR.md for usage).");
   if (decorators.length > 0) {
     const names = decorators.map((d) => d.name).join(", ");
-    lines.push(`**Recipe decorators:** ${names}`);
+    lines.push(`**Theme decorators:** ${names}`);
   }
   lines.push("");
-  if (recipeHints) {
-    if (recipeHints.preferred && recipeHints.preferred.length > 0) {
-      lines.push(`**Preferred:** ${recipeHints.preferred.join(", ")}`);
+  if (themeHints) {
+    if (themeHints.preferred && themeHints.preferred.length > 0) {
+      lines.push(`**Preferred:** ${themeHints.preferred.join(", ")}`);
     }
-    if (recipeHints.compositions) {
-      lines.push(`**Compositions:** ${recipeHints.compositions}`);
+    if (themeHints.compositions) {
+      lines.push(`**Compositions:** ${themeHints.compositions}`);
     }
-    if (recipeHints.spatialHints) {
-      lines.push(`**Spatial hints:** ${recipeHints.spatialHints}`);
+    if (themeHints.spatialHints) {
+      lines.push(`**Spatial hints:** ${themeHints.spatialHints}`);
     }
     lines.push("");
   }
@@ -2134,12 +2120,12 @@ function generateSectionContext(input) {
   return lines.join("\n");
 }
 function generateScaffoldContext(input) {
-  const { appName, blueprintId, themeName, recipeName, personality, topologyMarkdown, sections, routes, constraints, seo, navigation } = input;
+  const { appName, blueprintId, themeName, 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(`**Theme:** ${themeName}`);
   lines.push(`**Personality:** ${personality.join(", ")}`);
   lines.push("**Guard mode:** creative (no enforcement during initial scaffolding)");
   lines.push("");
@@ -2234,7 +2220,7 @@ import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as rea
 import { join as join2 } from "path";
 import { RegistryAPIClient } from "@decantr/registry";
 var DEFAULT_API_URL = "https://api.decantr.ai/v1";
-var ALL_CONTENT_TYPES = ["themes", "patterns", "recipes", "blueprints", "archetypes", "shells"];
+var ALL_CONTENT_TYPES = ["themes", "patterns", "blueprints", "archetypes", "shells"];
 function loadFromCache(cacheDir, contentType, id, namespace) {
   const nsDir = namespace ? join2(cacheDir, namespace) : cacheDir;
   const cachePath = id ? join2(nsDir, contentType, `${id}.json`) : join2(nsDir, contentType, "index.json");
@@ -2398,12 +2384,6 @@ var RegistryClient = class {
   async fetchShell(id) {
     return this.fetchContentItem("shells", id);
   }
-  async fetchRecipes() {
-    return this.fetchContentList("recipes");
-  }
-  async fetchRecipe(id) {
-    return this.fetchContentItem("recipes", id);
-  }
   /**
    * Check if API is available.
    */

package/dist/{heal-54MKDDSQ.js → heal-VYEGIUAS.js}

@@ -8,7 +8,7 @@ import { readFileSync, writeFileSync, existsSync } from "fs";
 import { join } from "path";
 var TELEMETRY_ENDPOINT = "https://api.decantr.ai/v1/telemetry/guard";
 var TELEMETRY_TIMEOUT_MS = 3e3;
-var DNA_RULES = /* @__PURE__ */ new Set(["style", "recipe", "density", "accessibility", "theme-mode"]);
+var DNA_RULES = /* @__PURE__ */ new Set(["style", "density", "accessibility", "theme-mode"]);
 async function sendGuardMetrics(metrics) {
   try {
     const controller = new AbortController();

package/dist/index.js

@@ -1,2 +1,2 @@
-import "./chunk-QZVA3PFR.js";
-import "./chunk-B5OX2EXL.js";
+import "./chunk-D3W3MYKT.js";
+import "./chunk-T7CQSJGV.js";

package/dist/{upgrade-LTLUPBZQ.js → upgrade-TXVD2WIN.js}

@@ -1,7 +1,7 @@
 import {
   RegistryClient,
   refreshDerivedFiles
-} from "./chunk-B5OX2EXL.js";
+} from "./chunk-T7CQSJGV.js";
 
 // src/commands/upgrade.ts
 import { readFileSync, writeFileSync, existsSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.5.3",
+  "version": "1.5.4",
   "description": "Decantr CLI — search the registry, validate essence files, and access design intelligence from the terminal",
   "license": "MIT",
   "repository": {

package/src/bundled/blueprints/default.json

@@ -8,9 +8,8 @@
   "tags": ["starter", "minimal", "offline"],
   "compose": [],
   "theme": {
-    "style": "default",
+    "id": "default",
     "mode": "system",
-    "recipe": null,
     "shape": "rounded"
   },
   "personality": ["clean", "minimal"],

package/src/templates/DECANTR.md.template

@@ -18,7 +18,7 @@ Decantr is a design intelligence layer that sits between you (the AI code genera
 
 DNA defines the foundational design rules. **DNA violations are errors** -- they must never happen without updating the essence first.
 
-DNA axioms include: Theme (style, mode, recipe, shape), Spacing (density, content gap), Typography (scale, weights), Color (palette, accent count), Radius (philosophy, base), Elevation (system, levels), Motion (preference, reduce-motion), Accessibility (WCAG level, focus-visible), and Personality traits.
+DNA axioms include: Theme (id, mode, shape), Spacing (density, content gap), Typography (scale, weights), Color (palette, accent count), Radius (philosophy, base), Elevation (system, levels), Motion (preference, reduce-motion), Accessibility (WCAG level, focus-visible), and Personality traits.
 
 ### Blueprint (Structural Layout)
 
@@ -33,13 +33,12 @@ Blueprint includes: Sections (grouped by archetype with role, shell, and scoped
 | # | Rule | Layer | What It Checks |
 |---|------|-------|----------------|
 | 1 | Style | DNA (error) | Code uses the theme specified in DNA |
-| 2 | Recipe | DNA (error) | Decorations match the DNA recipe |
-| 3 | Density | DNA (error) | Spacing follows the density profile |
-| 4 | Accessibility | DNA (error) | Code meets the WCAG level |
-| 5 | Theme-mode | DNA (error) | Theme/mode combination is valid |
-| 6 | Structure | Blueprint (warn) | Pages exist in the blueprint sections |
-| 7 | Layout | Blueprint (warn) | Pattern order matches the layout spec |
-| 8 | Pattern existence | Blueprint (warn) | Patterns referenced exist in the registry |
+| 2 | Density | DNA (error) | Spacing follows the density profile |
+| 3 | Accessibility | DNA (error) | Code meets the WCAG level |
+| 4 | Theme-mode | DNA (error) | Theme/mode combination is valid |
+| 5 | Structure | Blueprint (warn) | Pages exist in the blueprint sections |
+| 6 | Layout | Blueprint (warn) | Pattern order matches the layout spec |
+| 7 | Pattern existence | Blueprint (warn) | Patterns referenced exist in the registry |
 
 ### Enforcement Tiers
 
@@ -96,7 +95,7 @@ Run `decantr check` to validate code against the spec.
 decantr status          # Project health
 decantr check           # Detect drift violations
 decantr get pattern X   # Fetch a pattern spec from registry
-decantr get recipe X    # Fetch recipe decorators
+decantr get theme X     # Fetch theme details and decorators
 decantr search <query>  # Search the registry
 ```
 

package/src/templates/essence-summary.md.template

@@ -19,7 +19,7 @@ Auto-generated summary of `decantr.essence.json`.
 |----------|-------|
 | Theme | {{THEME_STYLE}} |
 | Mode | {{THEME_MODE}} |
-| Recipe | {{THEME_RECIPE}} |
+| Theme ID | {{THEME_RECIPE}} |
 | Shape | {{SHAPE}} |
 
 ## Structure

package/src/templates/project.json.template

@@ -17,8 +17,7 @@
     "cachedContent": {
       "archetypes": {{CACHED_ARCHETYPES}},
       "patterns": {{CACHED_PATTERNS}},
-      "themes": {{CACHED_THEMES}},
-      "recipes": {{CACHED_RECIPES}}
+      "themes": {{CACHED_THEMES}}
     }
   },
   "initialized": {

package/src/templates/task-add-page.md.template

@@ -11,12 +11,11 @@ You are adding new pages or features to an existing Decantr project. Guided mode
 | # | Layer | Rule | Enforcement | What It Means |
 |---|-------|------|-------------|---------------|
 | 1 | DNA | **Style** | ENFORCED | You MUST use theme `{{THEME_STYLE}}` |
-| 2 | DNA | **Recipe** | ENFORCED | You MUST use recipe `{{THEME_RECIPE}}` |
-| 3 | DNA | **Density** | ENFORCED | You MUST follow density `{{DENSITY}}` |
-| 4 | DNA | **Accessibility** | ENFORCED | You MUST meet WCAG level from essence |
-| 5 | DNA | **Theme-mode** | ENFORCED | Theme/mode combination must be compatible |
-| 6 | Blueprint | **Structure** | ENFORCED | Page MUST exist in essence before generating code |
-| 7 | Blueprint | Layout | advisory | Pattern order is flexible |
+| 2 | DNA | **Density** | ENFORCED | You MUST follow density `{{DENSITY}}` |
+| 3 | DNA | **Accessibility** | ENFORCED | You MUST meet WCAG level from essence |
+| 4 | DNA | **Theme-mode** | ENFORCED | Theme/mode combination must be compatible |
+| 5 | Blueprint | **Structure** | ENFORCED | Page MUST exist in essence before generating code |
+| 6 | Blueprint | Layout | advisory | Pattern order is flexible |
 | 8 | Blueprint | **Pattern-exists** | ENFORCED | All patterns must exist in the registry |
 
 ## Before You Start
@@ -64,7 +63,7 @@ Before adding a page:
 During code generation:
 
 - [ ] Use theme `{{THEME_STYLE}}` for all styling
-- [ ] Use recipe `{{THEME_RECIPE}}` for decorations
+- [ ] Use theme `{{THEME_RECIPE}}` decorators for decoration
 - [ ] Follow the shell structure ({{DEFAULT_SHELL}})
 - [ ] Include patterns from the layout array
 
@@ -72,7 +71,7 @@ After generation:
 
 - [ ] Run `npx @decantr/cli validate`
 - [ ] Verify the page matches the theme
-- [ ] Check that the recipe styles are applied
+- [ ] Check that the theme decorator styles are applied
 
 ## Violation Response
 

package/src/templates/task-modify.md.template

@@ -11,12 +11,11 @@ You are modifying existing code in a Decantr project. ALL 8 guard rules are enfo
 | # | Layer | Rule | Enforcement | Consequence of Violation |
 |---|-------|------|-------------|--------------------------|
 | 1 | DNA | **Style** | STRICT | ERROR — Code rejected |
-| 2 | DNA | **Recipe** | STRICT | ERROR — Code rejected |
-| 3 | DNA | **Density** | STRICT | WARNING — Flagged for review |
-| 4 | DNA | **Accessibility** | STRICT | ERROR — Code rejected |
-| 5 | DNA | **Theme-mode** | STRICT | ERROR — Code rejected |
-| 6 | Blueprint | **Structure** | STRICT | ERROR — Code rejected |
-| 7 | Blueprint | **Layout** | STRICT | ERROR — Pattern order must match exactly |
+| 2 | DNA | **Density** | STRICT | WARNING — Flagged for review |
+| 3 | DNA | **Accessibility** | STRICT | ERROR — Code rejected |
+| 4 | DNA | **Theme-mode** | STRICT | ERROR — Code rejected |
+| 5 | Blueprint | **Structure** | STRICT | ERROR — Code rejected |
+| 6 | Blueprint | **Layout** | STRICT | ERROR — Pattern order must match exactly |
 | 8 | Blueprint | **Pattern-exists** | STRICT | ERROR — Code rejected |
 
 ## Violation Response Protocol
@@ -75,7 +74,7 @@ For the page you're modifying, verify:
 - Shell matches the page's `shell` property
 - Patterns match the page's `layout[]` in order
 - Theme matches `theme.style`
-- Recipe matches `theme.recipe`
+- Theme decorators match `theme.id`
 
 ### 3. Plan Changes
 
@@ -93,7 +92,7 @@ Before modifying:
 - [ ] Page exists in essence structure
 - [ ] I know the exact layout order: `{{LAYOUT}}`
 - [ ] I will use theme: `{{THEME_STYLE}}`
-- [ ] I will use recipe: `{{THEME_RECIPE}}`
+- [ ] I will use theme: `{{THEME_RECIPE}}`
 - [ ] I will follow density: `{{DENSITY}}`
 
 During modification:
@@ -144,7 +143,7 @@ Swapping `chart-grid` and `data-table` is a Layout guard violation.
 | "Theme mismatch" | Used different theme | Revert to `{{THEME_STYLE}}` |
 | "Page undefined" | Edited undeclared page | Add page to essence first |
 | "Layout order wrong" | Patterns out of order | Match `layout[]` exactly |
-| "Recipe mismatch" | Wrong decoration style | Use `{{THEME_RECIPE}}` |
+| "Theme mismatch" | Wrong decoration style | Use `{{THEME_RECIPE}}` |
 | "Density drift" | Wrong spacing values | Use `{{CONTENT_GAP}}` tokens |
 
 ## Proposing Essence Changes

package/src/templates/task-scaffold.md.template

@@ -17,8 +17,7 @@ During scaffolding, the following rules are recommendations, not requirements:
 | # | Layer | Rule | Status | Guidance |
 |---|-------|------|--------|----------|
 | 1 | DNA | Style | Advisory | Use the theme from essence, but creative variations are acceptable |
-| 2 | DNA | Recipe | Advisory | Apply recipe styles where possible |
-| 3 | DNA | Density | Advisory | Follow spacing guidelines loosely |
+| 2 | DNA | Density | Advisory | Follow spacing guidelines loosely |
 | 4 | DNA | Accessibility | Advisory | Meet WCAG level from essence where possible |
 | 5 | DNA | Theme-mode | Advisory | Use the specified theme/mode combination |
 | 6 | Blueprint | Structure | Advisory | Follow the page structure, add placeholder content |