@decantr/cli 1.5.3 → 1.5.5

package/dist/{chunk-B5OX2EXL.js → chunk-MU3657R7.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("");
@@ -93,6 +93,9 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, recipeDecorator
     ["box-shadow", "var(--d-shadow-lg)"],
     ["z-index", "50"]
   ]);
+  emitRule(".d-surface[data-interactive]", [
+    ["cursor", "pointer"]
+  ]);
   emitRule(".d-surface[data-interactive]:hover", [
     ["border-color", "var(--d-primary-hover, var(--d-border))"],
     ["box-shadow", "var(--d-shadow-md)"],
@@ -154,7 +157,13 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, recipeDecorator
     ["padding", "var(--d-section-py) 0"]
   ]);
   lines.push(".d-section + .d-section {");
-  lines.push("  border-top: 1px solid var(--d-border);");
+  lines.push("  border-top: 1px solid transparent;");
+  lines.push("  border-image: linear-gradient(to right, transparent, var(--d-border), transparent) 1;");
+  lines.push("  margin-top: var(--d-gap-2);");
+  lines.push("}");
+  lines.push("");
+  lines.push('.d-section[data-density="compact"] {');
+  lines.push("  padding: calc(var(--d-section-py) * 0.5) 0;");
   lines.push("}");
   lines.push("");
   emitRule(".d-annotation", [
@@ -185,11 +194,19 @@ 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 */`);
+  emitRule(".d-label", [
+    ["font-size", "0.7rem"],
+    ["font-weight", "600"],
+    ["text-transform", "uppercase"],
+    ["letter-spacing", "0.08em"],
+    ["color", "var(--d-text-muted)"],
+    ["font-family", "var(--d-font-mono, ui-monospace, monospace)"]
+  ]);
+  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("");
@@ -208,6 +225,35 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, recipeDecorator
   lines.push("}");
   return lines.join("\n");
 }
+function generatePersonalityCSS(personality, themeData) {
+  const text = personality.join(" ").toLowerCase();
+  const rules = [];
+  if (text.includes("neon") || text.includes("glow")) {
+    const glowColor = "var(--d-accent-glow, rgba(0, 212, 255, 0.3))";
+    rules.push(`.neon-glow { box-shadow: 0 0 20px ${glowColor}; }`);
+    rules.push(`.neon-glow-hover:hover { box-shadow: 0 0 24px ${glowColor}; transition: box-shadow var(--d-duration-hover, 0.15s) var(--d-easing, ease); }`);
+    rules.push(`.neon-text-glow { text-shadow: 0 0 12px ${glowColor}; }`);
+    rules.push(`.neon-border-glow { border-color: var(--d-accent); box-shadow: 0 0 8px ${glowColor}; }`);
+  }
+  if (text.includes("monospace") || text.includes("mono")) {
+    rules.push(`.mono-data { font-family: var(--d-font-mono, ui-monospace, monospace); font-variant-numeric: tabular-nums; }`);
+  }
+  if (text.includes("pulse") || text.includes("ring") || text.includes("status")) {
+    rules.push(`.status-ring { width: 48px; height: 48px; border-radius: 50%; border: 2px solid var(--d-border); display: flex; align-items: center; justify-content: center; position: relative; transition: border-color 0.2s ease, box-shadow 0.2s ease; }`);
+    rules.push(`.status-ring[data-status="active"] { border-color: var(--d-success); }`);
+    rules.push(`.status-ring[data-status="error"] { border-color: var(--d-error); box-shadow: 0 0 12px color-mix(in srgb, var(--d-error) 25%, transparent); }`);
+    rules.push(`.status-ring[data-status="warning"] { border-color: var(--d-warning); }`);
+    rules.push(`.status-ring[data-status="idle"] { border-color: var(--d-text-muted); }`);
+    rules.push(`@keyframes pulse-ring { 0% { opacity: 0.6; transform: scale(1); } 100% { opacity: 0; transform: scale(1.3); } }`);
+    rules.push(`.status-ring[data-status="active"]::after { content: ''; position: absolute; inset: -4px; border-radius: 50%; border: 2px solid var(--d-success); opacity: 0; animation: pulse-ring 2s ease-out infinite; }`);
+  }
+  if (themeData.motion?.entrance) {
+    rules.push(`.entrance-fade { animation: decantr-entrance var(--d-duration-entrance, 0.2s) var(--d-easing, ease-out); }`);
+    rules.push(`@keyframes decantr-entrance { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }`);
+  }
+  if (rules.length === 0) return "";
+  return "\n/* \u2500\u2500 Personality-Derived Utilities \u2500\u2500 */\n\n" + rules.join("\n\n") + "\n";
+}
 
 // src/scaffold.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
@@ -520,6 +566,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,35 +673,6 @@ input, button, textarea, select {
 }
 `;
 }
-function generateTreatmentsContext(recipeData, recipeName) {
-  const lines = [];
-  lines.push(`# Visual Treatments: ${recipeName}`);
-  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)`);
-    lines.push("");
-    lines.push("| Class | Use for |");
-    lines.push("|-------|---------|");
-    for (const [name, description] of Object.entries(recipeData.decorators)) {
-      const useFor = description.split(".")[0].trim();
-      lines.push(`| ${name} | ${useFor} |`);
-    }
-    lines.push("");
-  }
-  lines.push("## Composition");
-  lines.push("");
-  lines.push("Atoms + treatment + recipe 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.");
-  return lines.join("\n");
-}
 function generateDecoratorRule(name, description) {
   const rules = [];
   const descLower = description.toLowerCase();
@@ -876,7 +908,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 +921,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 +935,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 +972,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 +983,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 +993,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 +1035,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 +1068,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,37 +1078,60 @@ 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
 
 | Category | Examples | Purpose |
-|----------|----------|---------|
+|----------|---------|---------|
 | Layout | \`_flex\`, \`_col\`, \`_row\`, \`_wrap\`, \`_grid\` | Flex/grid containers |
 | Spacing | \`_gap4\`, \`_p4\`, \`_px4\`, \`_py2\`, \`_m0\` | Gaps, padding, margin |
-| Sizing | \`_w100\`, \`_h100\`, \`_minw0\`, \`_maxwfull\` | Width, height |
-| Text | \`_textlg\`, \`_text2xl\`, \`_fontbold\`, \`_textc\` | Typography |
+| Sizing | \`_w100\`, \`_h100\`, \`_mw640\`, \`_mw480\` | Width, height, max-width |
+| Text | \`_textlg\`, \`_text2xl\`, \`_fontbold\`, \`_fontmono\` | Typography |
+| Color | \`_fgaccent\`, \`_fgmuted\`, \`_fgsuccess\`, \`_bgsurf\` | Foreground/background |
 | Alignment | \`_aic\`, \`_jcc\`, \`_jcsb\`, \`_pic\` | Flex/grid alignment |
 | Position | \`_rel\`, \`_abs\`, \`_sticky\`, \`_z10\` | Positioning |
 | Visual | \`_rounded\`, \`_shadow\`, \`_trans\`, \`_op50\` | Decoration |
-| Color | \`_bgprimary\`, \`_fgtext\`, \`_fgmuted\`, \`_bcborder\` | Theme colors |
 | Responsive | \`_md:gc2\`, \`_lg:gc4\`, \`_sm:flex\` | Breakpoint prefixes |
+| Cursor | \`_pointer\` | Interaction hints |
 
 Scale: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24. Example: \`_gap4\` = \`gap:1rem\`.
 
+### Section Labels
+
+Use the d-label class for uppercase section headings.
+Anchor with a left accent border: \`border-left: 2px solid var(--d-accent); padding-left: 0.5rem\`.
+
+### Empty States
+
+Every data-driven section should handle zero-data gracefully.
+Pattern: centered 48px muted icon + descriptive message + optional CTA button.
+
+### Page Transitions
+
+If the theme provides motion tokens, apply the \`entrance-fade\` class to page content containers for smooth page-to-page transitions.
+
+### Navigation Shortcuts
+
+If the essence defines hotkeys or command_palette, implement as keyboard event listeners (useEffect + keydown) \u2014 not as visible UI text.
+
 ### 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 +1168,7 @@ function generateProjectJson(detected, options, registrySource) {
       cachedContent: {
         archetypes: [],
         patterns: [],
-        themes: [],
-        recipes: []
+        themes: []
       }
     },
     initialized: {
@@ -1147,7 +1201,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 +1225,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 +1264,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 +1301,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 +1338,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 +1353,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 +1361,8 @@ function scaffoldMinimal(projectRoot) {
     version: "3.0.0",
     dna: {
       theme: {
-        style: "default",
+        id: "default",
         mode: "dark",
-        recipe: "default",
         shape: "rounded"
       },
       spacing: {
@@ -1391,8 +1444,7 @@ function scaffoldMinimal(projectRoot) {
       cachedContent: {
         archetypes: [],
         patterns: [],
-        themes: [],
-        recipes: []
+        themes: []
       }
     },
     initialized: {
@@ -1486,12 +1538,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 +1552,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 +1562,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
-      };
-    }
-  } 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
+        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
       };
-      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 +1589,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 +1608,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;
@@ -1594,23 +1619,24 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
     writeFileSync(tokensPath, generateTokensCSS(themeData, mode, spatialTokens));
   }
   const treatmentsPath = join(stylesDir, "treatments.css");
-  writeFileSync(treatmentsPath, generateTreatmentCSS(
+  let treatmentCSS = generateTreatmentCSS(
     spatialTokens,
-    recipeData?.treatment_overrides,
-    recipeData?.decorators,
+    themeData?.treatments,
+    themeData?.decorators,
     themeName
-  ));
+  );
+  const personalityCSS = generatePersonalityCSS(personality || [], themeData || {});
+  treatmentCSS += personalityCSS;
+  writeFileSync(treatmentsPath, treatmentCSS);
   const globalPath = join(stylesDir, "global.css");
   if (!existsSync(globalPath)) {
     writeFileSync(globalPath, generateGlobalCSS(personality));
   }
   const cssFiles = [tokensPath, treatmentsPath, globalPath];
-  const treatmentsMdPath = join(contextDir, "treatments.md");
-  writeFileSync(treatmentsMdPath, generateTreatmentsContext(recipeData, recipeName));
   const decantrMdPath = join(projectRoot, "DECANTR.md");
   writeFileSync(decantrMdPath, generateDecantrMdV31(guardMode, CSS_APPROACH_CONTENT));
   const hasSections = essence.blueprint.sections && essence.blueprint.sections.length > 0;
-  const contextFiles = [treatmentsMdPath];
+  const contextFiles = [];
   if (!hasSections) {
     const summaryPath = join(contextDir, "essence-summary.md");
     writeFileSync(summaryPath, generateEssenceSummaryV3(essence));
@@ -1708,8 +1734,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)) {
@@ -1740,7 +1766,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
             shellInfoCache[shellId] = {
               description: inner.description || "",
               regions: inner.config?.regions || [],
-              layout: inner.layout || void 0
+              layout: inner.layout || void 0,
+              guidance: inner.guidance || void 0
             };
           }
         } catch {
@@ -1777,7 +1804,6 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
         guardConfig,
         personality,
         themeName,
-        recipeName,
         zoneContext,
         patternSpecs: sectionPatterns,
         constraints: essence.dna.constraints,
@@ -1792,7 +1818,6 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
       appName: essence.meta.archetype || "Application",
       blueprintId: "",
       themeName,
-      recipeName,
       personality,
       topologyMarkdown,
       sections,
@@ -1867,8 +1892,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)) {
@@ -1894,7 +1919,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
         v30ShellInfo = {
           description: inner.description || "",
           regions: inner.config?.regions || [],
-          layout: inner.layout || void 0
+          layout: inner.layout || void 0,
+          guidance: inner.guidance || void 0
         };
       }
     } catch {
@@ -1906,7 +1932,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 +2035,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("");
@@ -2029,6 +2054,15 @@ function generateSectionContext(input) {
     }
   }
   lines.push("");
+  if (shellInfo?.guidance && Object.keys(shellInfo.guidance).length > 0) {
+    lines.push(`## Shell Notes (${section.shell})`);
+    lines.push("");
+    for (const [key, value] of Object.entries(shellInfo.guidance)) {
+      const label = key.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+      lines.push(`- **${label}:** ${value}`);
+    }
+    lines.push("");
+  }
   lines.push("---");
   lines.push("");
   lines.push(`**Guard:** ${guardConfig.mode} mode | DNA violations = ${guardConfig.dna_enforcement} | Blueprint violations = ${guardConfig.blueprint_enforcement}`);
@@ -2038,18 +2072,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 +2168,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 +2268,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 +2432,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.
    */