@decantr/cli 1.4.0 → 1.5.0

package/dist/bin.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import "./chunk-OTVIAUQG.js";
-import "./chunk-ZQ5FTYKG.js";
+import "./chunk-SUNMRG3P.js";
+import "./chunk-6K6ZPDT4.js";

package/dist/{chunk-ZQ5FTYKG.js → chunk-6K6ZPDT4.js}

@@ -120,6 +120,12 @@ function composeSections(composeEntries, archetypeResults, overrides) {
       }
     }
   }
+  const primaryShell = sections.find((s) => s.role === "primary")?.shell || defaultShell;
+  for (const section of sections) {
+    if (section.shell === "inherit") {
+      section.shell = primaryShell;
+    }
+  }
   let features = [...new Set(allFeatures)];
   if (overrides?.features_add) {
     for (const f of overrides.features_add) {
@@ -351,17 +357,57 @@ function generateDecoratorsCSS(recipeData, themeName) {
 `);
   return css.join("\n");
 }
+function generateDecoratorsContext(recipeData, recipeName) {
+  const lines = [];
+  lines.push(`# Recipe Decorators: ${recipeName}`);
+  lines.push("");
+  lines.push("## Available Classes");
+  lines.push("");
+  if (recipeData?.decorators && Object.keys(recipeData.decorators).length > 0) {
+    lines.push("| Decorator | Description |");
+    lines.push("|-----------|-------------|");
+    for (const [name, description] of Object.entries(recipeData.decorators)) {
+      lines.push(`| ${name} | ${description} |`);
+    }
+  } else {
+    lines.push("No decorators defined.");
+  }
+  lines.push("");
+  lines.push("## Usage");
+  lines.push("");
+  lines.push("Decorators are plain CSS class names from `src/styles/decorators.css`. Combine with atoms:");
+  lines.push("");
+  lines.push("```tsx");
+  lines.push("<div className={css('_flex _col _gap4') + ' " + recipeName + "-card'}>");
+  lines.push("  <pre className={css('_p3') + ' " + recipeName + "-code'}>{code}</pre>");
+  lines.push("</div>");
+  lines.push("```");
+  lines.push("");
+  lines.push("Atoms use `css()` function. Decorators are plain class strings. Combined via string concatenation.");
+  lines.push("");
+  return lines.join("\n");
+}
 function generateDecoratorRule(name, description) {
   const rules = [];
   const descLower = description.toLowerCase();
-  if (descLower.includes("surface background") || descLower.includes("surface elevation")) {
+  if (descLower.includes("monospace") || descLower.includes("mono font")) {
+    rules.push("font-family: ui-monospace, 'Cascadia Code', 'Source Code Pro', Menlo, Consolas, 'DejaVu Sans Mono', monospace");
+  }
+  if (descLower.includes("surface-raised") || descLower.includes("surface raised")) {
+    rules.push("background: var(--d-surface-raised)");
+  } else 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")) {
+  const leftBorderMatch = descLower.match(/(\d+)px\s+left\s+border/);
+  if (leftBorderMatch) {
+    rules.push(`border-left: ${leftBorderMatch[1]}px solid var(--d-primary)`);
+  } else if (descLower.includes("left border")) {
+    rules.push("border-left: 3px solid var(--d-primary)");
+  } else 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)");
@@ -397,6 +443,15 @@ function generateDecoratorRule(name, description) {
     rules.push("border-radius: var(--d-radius-lg)");
     rules.push("max-width: 80%");
   }
+  if (descLower.includes("monospace") || descLower.includes("code")) {
+    if (!rules.some((r) => r.startsWith("padding"))) {
+      rules.push("padding: 0.75rem 1rem");
+    }
+    if (!rules.some((r) => r.startsWith("border-radius"))) {
+      rules.push("border-radius: var(--d-radius-sm)");
+    }
+    rules.push("overflow-x: auto");
+  }
   if (rules.length === 0) {
     return `/* .${name}: ${description} */`;
   }
@@ -833,6 +888,32 @@ The \`css()\` function processes atom strings and injects CSS at runtime:
 | \`_trans\` | \`transition:all 0.15s ease\` |
 | \`_visible\`, \`_invisible\` | visibility |
 
+### Using Recipe Decorators
+
+Recipe decorators (from \`src/styles/decorators.css\`) are regular CSS class names, NOT atoms. They are applied directly as class names and combined with atoms using string concatenation:
+
+\`\`\`tsx
+// Atoms use css() function, decorators are plain class names
+<div className={css('_flex _col _gap4') + ' carbon-card'}>
+  <div className={css('_p4') + ' carbon-glass'}>
+    <pre className={css('_p3') + ' carbon-code'}>{code}</pre>
+  </div>
+</div>
+\`\`\`
+
+**Key difference:**
+- Atoms: \`css('_flex _col _gap4')\` \u2014 processed by @decantr/css runtime
+- Decorators: \`'carbon-card'\`, \`'carbon-glass'\` \u2014 plain CSS classes from decorators.css
+- Combined: \`css('_flex _col') + ' carbon-card'\`
+
+### Routing
+
+Check \`decantr.essence.json\` \u2192 \`meta.platform.routing\` for the routing strategy:
+- \`"hash"\` \u2192 use \`HashRouter\` (e.g., for static hosting, GitHub Pages)
+- \`"history"\` \u2192 use \`BrowserRouter\` (e.g., for server-rendered apps)
+
+Routes are defined in \`decantr.essence.json\` \u2192 \`blueprint.routes\` and listed in \`.decantr/context/scaffold.md\`.
+
 ### CSS Architecture
 
 The CSS is organized into two parts:
@@ -1065,7 +1146,7 @@ async function scaffoldProject(projectRoot, options, detected, registry, archety
     }
     writeFileSync(essencePath, JSON.stringify(essenceV3, null, 2) + "\n");
   }
-  const refreshResult = await refreshDerivedFiles(projectRoot, essenceV3, registry);
+  const refreshResult = await refreshDerivedFiles(projectRoot, essenceV3, registry, themeData, recipeData);
   contextFiles.push(...refreshResult.contextFiles);
   const gitignoreUpdated = updateGitignore(projectRoot);
   return {
@@ -1267,7 +1348,7 @@ When available, use these tools:
     gitignoreUpdated
   };
 }
-async function refreshDerivedFiles(projectRoot, essence, registry) {
+async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThemeData, prefetchedRecipeData) {
   const decantrDir = join(projectRoot, ".decantr");
   const contextDir = join(decantrDir, "context");
   mkdirSync(contextDir, { recursive: true });
@@ -1281,12 +1362,13 @@ async function refreshDerivedFiles(projectRoot, essence, registry) {
     blueprint_enforcement: essence.meta.guard.blueprint_enforcement || "warn"
   };
   const personality = essence.dna.personality || [];
-  let themeData;
-  let recipeData;
-  try {
+  let themeData = prefetchedThemeData;
+  let recipeData = prefetchedRecipeData;
+  if (!themeData) try {
     const themeResult = await registry.fetchTheme(themeName);
     if (themeResult?.data) {
-      const t = themeResult.data;
+      const raw = themeResult.data;
+      const t = raw.data ?? raw;
       themeData = {
         seed: t.seed,
         palette: t.palette,
@@ -1298,18 +1380,66 @@ async function refreshDerivedFiles(projectRoot, essence, registry) {
     }
   } catch {
   }
-  try {
+  if (!recipeData) try {
     const recipeResult = await registry.fetchRecipe(recipeName);
     if (recipeResult?.data) {
-      const r = 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
       };
+      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
+          };
+        }
+      }
+    } catch {
+    }
+  }
+  if (!themeData?.seed?.primary) {
+    try {
+      const apiUrl = registry.apiUrl || "https://api.decantr.ai/v1";
+      const resp = await fetch(`${apiUrl}/themes/@official/${themeName}`);
+      if (resp.ok) {
+        const apiData = await resp.json();
+        const inner = apiData.data ?? apiData;
+        if (inner.seed) {
+          themeData = {
+            seed: inner.seed,
+            palette: inner.palette,
+            cvd_support: inner.cvd_support,
+            tokens: inner.tokens,
+            typography_hints: inner.typography_hints,
+            motion_hints: inner.motion_hints
+          };
+        }
+      }
+    } catch {
+    }
+  }
   const stylesDir = join(projectRoot, "src", "styles");
   mkdirSync(stylesDir, { recursive: true });
   const tokensPath = join(stylesDir, "tokens.css");
@@ -1323,14 +1453,22 @@ async function refreshDerivedFiles(projectRoot, essence, registry) {
     writeFileSync(decoratorsPath, generateDecoratorsCSS(recipeData, themeName));
   }
   const cssFiles = [tokensPath, decoratorsPath];
+  const decoratorsMdPath = join(contextDir, "decorators.md");
+  writeFileSync(decoratorsMdPath, generateDecoratorsContext(recipeData, recipeName));
   const decantrMdPath = join(projectRoot, "DECANTR.md");
   writeFileSync(decantrMdPath, generateDecantrMdV31(guardMode, CSS_APPROACH_CONTENT));
   const summaryPath = join(contextDir, "essence-summary.md");
   writeFileSync(summaryPath, generateEssenceSummaryV3(essence));
-  const contextFiles = [summaryPath];
+  const contextFiles = [decoratorsMdPath, summaryPath];
   const blueprint = essence.blueprint;
   const sections = blueprint.sections && blueprint.sections.length > 0 ? blueprint.sections : [];
   if (sections.length > 0) {
+    const primarySectionShell = sections.find((s) => s.role === "primary")?.shell || "sidebar-main";
+    for (const section of sections) {
+      if (section.shell === "inherit") {
+        section.shell = primarySectionShell;
+      }
+    }
     const patternSpecs = {};
     const seenPatterns = /* @__PURE__ */ new Set();
     for (const section of sections) {
@@ -1347,13 +1485,29 @@ async function refreshDerivedFiles(projectRoot, essence, registry) {
                   const inner = raw.data ?? raw;
                   const defaultPreset = inner.default_preset || "standard";
                   const preset = inner.presets?.[defaultPreset];
+                  let slots = preset?.layout?.slots || {};
+                  if (Object.keys(slots).length === 0) {
+                    const synthetic = generateSyntheticSlots(name, inner.description || "");
+                    if (Object.keys(synthetic).length > 0) {
+                      slots = synthetic;
+                    }
+                  }
                   patternSpecs[name] = {
                     description: inner.description || "",
                     components: inner.components || [],
-                    slots: preset?.layout?.slots || {}
+                    slots
                   };
+                } else {
+                  const synthetic = generateSyntheticSlots(name, "");
+                  if (Object.keys(synthetic).length > 0) {
+                    patternSpecs[name] = { description: "", components: [], slots: synthetic };
+                  }
                 }
               } catch {
+                const synthetic = generateSyntheticSlots(name, "");
+                if (Object.keys(synthetic).length > 0) {
+                  patternSpecs[name] = { description: "", components: [], slots: synthetic };
+                }
               }
             }
           }
@@ -1423,8 +1577,17 @@ async function refreshDerivedFiles(projectRoot, essence, registry) {
       }
     }
     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 zoneLabel = section.role === "primary" || section.role === "auxiliary" ? "App" : section.role === "gateway" ? "Gateway" : "Public";
+      let zoneContext = `**Zone:** ${zoneLabel} (${section.role}) \u2014 ${section.shell} shell`;
+      if (section.role === "gateway") {
+        zoneContext += "\nAuth success \u2192 enters App zone. Sign out returns here.";
+      } else if (section.role === "primary") {
+        zoneContext += "\nAuthenticated users land here. Sign out \u2192 Gateway (/login).";
+      } else if (section.role === "public") {
+        zoneContext += "\nAnonymous visitors. CTAs lead to Gateway (/login, /register).";
+      } else if (section.role === "auxiliary") {
+        zoneContext += "\nSupporting section within App zone. Shares navigation with primary.";
+      }
       const sectionPatterns = {};
       for (const page of section.pages) {
         for (const item of page.layout) {
@@ -1496,13 +1659,29 @@ async function refreshDerivedFiles(projectRoot, essence, registry) {
                 const inner = raw.data ?? raw;
                 const defaultPreset = inner.default_preset || "standard";
                 const preset = inner.presets?.[defaultPreset];
+                let slots = preset?.layout?.slots || {};
+                if (Object.keys(slots).length === 0) {
+                  const synthetic = generateSyntheticSlots(name, inner.description || "");
+                  if (Object.keys(synthetic).length > 0) {
+                    slots = synthetic;
+                  }
+                }
                 patternSpecs[name] = {
                   description: inner.description || "",
                   components: inner.components || [],
-                  slots: preset?.layout?.slots || {}
+                  slots
                 };
+              } else {
+                const synthetic = generateSyntheticSlots(name, "");
+                if (Object.keys(synthetic).length > 0) {
+                  patternSpecs[name] = { description: "", components: [], slots: synthetic };
+                }
               }
             } catch {
+              const synthetic = generateSyntheticSlots(name, "");
+              if (Object.keys(synthetic).length > 0) {
+                patternSpecs[name] = { description: "", components: [], slots: synthetic };
+              }
             }
           }
         }
@@ -1565,8 +1744,74 @@ async function refreshDerivedFiles(projectRoot, essence, registry) {
     cssFiles
   };
 }
+function generateSyntheticSlots(patternId, description) {
+  const desc = description.toLowerCase();
+  const syntheticSlots = {};
+  if (patternId.includes("feature") || desc.includes("feature")) {
+    syntheticSlots["grid"] = "Grid of feature cards (icon + title + description)";
+    syntheticSlots["feature-card"] = "Individual feature with icon, heading, and description text";
+  }
+  if (patternId.includes("pricing") || desc.includes("pricing")) {
+    syntheticSlots["tiers"] = "Pricing tier cards (name, price, features list, CTA button)";
+    syntheticSlots["toggle"] = "Monthly/annual billing toggle (optional)";
+  }
+  if (patternId.includes("testimonial") || desc.includes("testimonial")) {
+    syntheticSlots["quotes"] = "Testimonial cards (quote text, author name, role, avatar)";
+  }
+  if (patternId.includes("cta") || desc.includes("call-to-action") || desc.includes("call to action")) {
+    syntheticSlots["headline"] = "CTA headline text";
+    syntheticSlots["description"] = "Supporting description text";
+    syntheticSlots["actions"] = "CTA button(s)";
+  }
+  if (patternId.includes("how-it-works") || desc.includes("how it works") || desc.includes("timeline") || desc.includes("steps")) {
+    syntheticSlots["steps"] = "Numbered steps (step number, title, description)";
+  }
+  if (patternId.includes("team") || desc.includes("team")) {
+    syntheticSlots["members"] = "Team member cards (avatar, name, role)";
+  }
+  if (patternId.includes("story") || desc.includes("story") || desc.includes("about")) {
+    syntheticSlots["content"] = "Story/about narrative text content";
+  }
+  if (patternId.includes("values") || desc.includes("values")) {
+    syntheticSlots["values"] = "Value cards (icon/emoji, title, description)";
+  }
+  if (patternId.includes("form") || desc.includes("form") || desc.includes("contact")) {
+    syntheticSlots["fields"] = "Form fields (name, email, message, etc.)";
+    syntheticSlots["submit"] = "Submit button";
+  }
+  if (patternId.includes("content") || desc.includes("legal") || desc.includes("privacy") || desc.includes("policy")) {
+    syntheticSlots["body"] = "Long-form text content with headings and paragraphs";
+    syntheticSlots["toc"] = "Table of contents sidebar (optional)";
+  }
+  if (patternId.includes("settings") || desc.includes("settings") || desc.includes("preferences")) {
+    syntheticSlots["sections"] = "Settings sections (label, description, input/toggle)";
+  }
+  if (patternId.includes("security") || desc.includes("security") || desc.includes("password")) {
+    syntheticSlots["sections"] = "Security sections (password change, MFA toggle, session list)";
+  }
+  if (patternId.includes("session") || desc.includes("session")) {
+    syntheticSlots["list"] = "Active sessions list (device, location, last active, revoke button)";
+  }
+  if (patternId.includes("message") || desc.includes("message") || desc.includes("chat")) {
+    syntheticSlots["messages"] = "Message bubbles (user/assistant, content, timestamp)";
+  }
+  if (patternId.includes("input") && desc.includes("chat")) {
+    syntheticSlots["textarea"] = "Auto-expanding message input";
+    syntheticSlots["actions"] = "Attach file button, send button";
+  }
+  if (patternId.includes("empty") || desc.includes("empty")) {
+    syntheticSlots["illustration"] = "Empty state illustration or icon";
+    syntheticSlots["message"] = "Welcome/empty state message";
+    syntheticSlots["suggestions"] = "Suggested actions or prompts";
+  }
+  if (patternId.includes("header") && desc.includes("chat")) {
+    syntheticSlots["title"] = "Conversation title or model name";
+    syntheticSlots["actions"] = "Header action buttons (new chat, settings)";
+  }
+  return syntheticSlots;
+}
 function generateSectionContext(input) {
-  const { section, themeTokens, decorators, guardConfig, personality, themeName, recipeName, zoneContext, patternSpecs, recipeHints, constraints, shellInfo } = input;
+  const { section, decorators, guardConfig, personality, themeName, recipeName, zoneContext, patternSpecs, recipeHints, constraints, shellInfo } = input;
   const lines = [];
   lines.push(`# Section: ${section.id}`);
   lines.push("");
@@ -1587,40 +1832,15 @@ function generateSectionContext(input) {
   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(`**Guard:** ${guardConfig.mode} mode | DNA violations = ${guardConfig.dna_enforcement} | Blueprint violations = ${guardConfig.blueprint_enforcement}`);
   lines.push("");
-  lines.push(`## Decorators (${recipeName} recipe)`);
+  lines.push(`**Theme tokens:** see \`src/styles/tokens.css\` \u2014 use \`var(--d-primary)\`, \`var(--d-bg)\`, etc.`);
   lines.push("");
   if (decorators.length > 0) {
-    lines.push("| Decorator | Description |");
-    lines.push("|-----------|-------------|");
-    for (const dec of decorators) {
-      lines.push(`| ${dec.name} | ${dec.description} |`);
-    }
+    const names = decorators.map((d) => d.name).join(", ");
+    lines.push(`**Decorators:** see \`src/styles/decorators.css\` \u2014 available classes: ${names}`);
   } else {
-    lines.push("No decorators defined.");
+    lines.push("**Decorators:** none defined.");
   }
   lines.push("");
   if (recipeHints) {
@@ -1638,11 +1858,8 @@ function generateSectionContext(input) {
   lines.push("---");
   lines.push("");
   if (zoneContext) {
-    lines.push("## Zone Context");
-    lines.push("");
     lines.push(zoneContext);
-    lines.push("");
-    lines.push("---");
+    lines.push("For full app topology, see `.decantr/context/scaffold.md`");
     lines.push("");
   }
   if (section.features.length > 0) {
@@ -1925,12 +2142,22 @@ var RegistryClient = class {
     if (customResult) return customResult;
     if (id.startsWith("custom:")) return null;
     if (!this.offline) {
-      try {
-        const data = await this.apiClient.getContent(contentType, namespace, id);
-        saveToCache(this.cacheDir, contentType, id, data, namespace);
-        return { data, source: { type: "api", url: this.apiUrl } };
-      } catch {
+      for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+          const data = await this.apiClient.getContent(contentType, namespace, id);
+          saveToCache(this.cacheDir, contentType, id, data, namespace);
+          return { data, source: { type: "api", url: this.apiUrl } };
+        } catch (e) {
+          if (process.env.DECANTR_DEBUG) {
+            console.error(`  [debug] API fetch ${attempt === 0 ? "failed" : "retry failed"} for ${contentType}/${namespace}/${id}: ${e.message}`);
+          }
+          if (attempt === 0) {
+            await new Promise((r) => setTimeout(r, 500));
+          }
+        }
       }
+    } else if (process.env.DECANTR_DEBUG) {
+      console.error(`  [debug] Skipping API (offline mode) for ${contentType}/${namespace}/${id}`);
     }
     return loadFromCache(this.cacheDir, contentType, id, namespace);
   }
@@ -1992,9 +2219,12 @@ async function syncRegistry(cacheDir, apiUrl = DEFAULT_API_URL) {
       const result = await apiClient.listContent(type, { namespace: "@official" });
       saveToCache(cacheDir, type, null, result, "@official");
       for (const item of result.items) {
-        const id = item.id || item.slug;
-        if (id) {
-          saveToCache(cacheDir, type, id, item, "@official");
+        const slug = item.slug;
+        const data = item.data;
+        const innerSlug = data?.id || data?.slug;
+        const cacheKey = slug || innerSlug || item.id;
+        if (cacheKey) {
+          saveToCache(cacheDir, type, cacheKey, item, "@official");
         }
       }
       synced.push(type);

package/dist/{chunk-OTVIAUQG.js → chunk-SUNMRG3P.js}

@@ -9,7 +9,7 @@ import {
   scaffoldMinimal,
   scaffoldProject,
   syncRegistry
-} from "./chunk-ZQ5FTYKG.js";
+} from "./chunk-6K6ZPDT4.js";
 
 // src/index.ts
 import { readFileSync as readFileSync14, existsSync as existsSync19, readdirSync as readdirSync6 } from "fs";
@@ -2578,11 +2578,9 @@ ${YELLOW6}You're offline. Scaffolding Decantr default.${RESET9}`);
     );
     selectedBlueprint = selected || "default";
   }
-  const [archetypesResult, blueprintsResult, themesResult] = await Promise.all([
-    registryClient.fetchArchetypes(),
-    registryClient.fetchBlueprints(),
-    registryClient.fetchThemes()
-  ]);
+  const archetypesResult = await registryClient.fetchArchetypes();
+  const blueprintsResult = await registryClient.fetchBlueprints();
+  const themesResult = await registryClient.fetchThemes();
   if (archetypesResult.source.type === "api") {
     registrySource = "api";
   }
@@ -2626,15 +2624,14 @@ ${YELLOW6}You're offline. Scaffolding Decantr default.${RESET9}`);
       blueprintRecipeName = blueprint.theme?.recipe;
       if (blueprint.compose && blueprint.compose.length > 0) {
         const entries = blueprint.compose;
-        const fetchPromises = entries.map((entry) => {
+        const results = [];
+        for (const entry of entries) {
           const id = typeof entry === "string" ? entry : entry.archetype;
-          return registryClient.fetchArchetype(id).then((r) => {
-            const raw = r?.data;
-            const inner = raw?.data ?? raw;
-            return [id, inner];
-          });
-        });
-        const results = await Promise.all(fetchPromises);
+          const r = await registryClient.fetchArchetype(id);
+          const raw = r?.data;
+          const inner = raw?.data ?? raw;
+          results.push([id, inner]);
+        }
         const archetypeMap = new Map(results.map(([id, data]) => [id, data || null]));
         const composed = composeArchetypes(entries, archetypeMap);
         const primaryId = typeof entries[0] === "string" ? entries[0] : entries[0].archetype;
@@ -2677,8 +2674,7 @@ ${YELLOW6}You're offline. Scaffolding Decantr default.${RESET9}`);
         }
         patternSpecs = {};
         if (allPatternIds.size > 0) {
-          const pSpecs = patternSpecs;
-          const fetches = [...allPatternIds].map(async (pid) => {
+          for (const pid of allPatternIds) {
             try {
               const result2 = await registryClient.fetchPattern(pid);
               if (result2) {
@@ -2686,17 +2682,15 @@ ${YELLOW6}You're offline. Scaffolding Decantr default.${RESET9}`);
                 const inner = raw.data ?? raw;
                 const defaultPreset = inner.default_preset || "standard";
                 const preset = inner.presets?.[defaultPreset];
-                pSpecs[pid] = {
+                patternSpecs[pid] = {
                   description: inner.description || "",
                   components: inner.components || [],
-                  slots: preset?.layout?.slots || {},
-                  code: preset?.code?.example || inner.code?.example || ""
+                  slots: preset?.layout?.slots || {}
                 };
               }
             } catch {
             }
-          });
-          await Promise.all(fetches);
+          }
         }
         const zoneInputs = [];
         for (const entry of entries) {
@@ -2766,6 +2760,10 @@ ${YELLOW6}You're offline. Scaffolding Decantr default.${RESET9}`);
     }
     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;
@@ -2816,18 +2814,21 @@ ${YELLOW6}You're offline. Scaffolding Decantr default.${RESET9}`);
   console.log(`    ${cyan("decantr migrate")}    Migrate v2 essence to v3`);
   const essenceContent = readFileSync14(result.essencePath, "utf-8");
   const essence = JSON.parse(essenceContent);
-  const validation = validateEssence2(essence);
-  if (!validation.valid) {
-    console.log(error(`
+  if (essence.version !== "3.1.0") {
+    const validation = validateEssence2(essence);
+    if (!validation.valid) {
+      console.log(error(`
 Validation warnings: ${validation.errors.join(", ")}`));
+    }
   }
   console.log("");
   let promptPages;
   if (isV36(essence)) {
-    promptPages = essence.blueprint.pages.map((p) => ({
+    const allPages = essence.blueprint.sections ? essence.blueprint.sections.flatMap((s) => s.pages.map((p) => ({ ...p, _shell: s.shell }))) : essence.blueprint.pages || [];
+    promptPages = allPages.map((p) => ({
       id: p.id,
-      shell: p.shell_override ?? essence.blueprint.shell,
-      layout: p.layout.map((item) => typeof item === "string" ? item : extractPatternName(item))
+      shell: p.shell_override ?? p._shell ?? essence.blueprint.shell,
+      layout: (p.layout || []).map((item) => typeof item === "string" ? item : extractPatternName(item))
     }));
   } else {
     promptPages = essence.structure || [{ id: "home", shell: options.shell, layout: ["hero"] }];
@@ -3241,7 +3242,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-EHMDEZGC.js");
+      const { cmdUpgrade } = await import("./upgrade-I2RUTNAT.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;
@@ -3496,5 +3497,6 @@ async function main() {
 }
 main().catch((e) => {
   console.error(error(e.message));
+  if (e.stack) console.error(e.stack);
   process.exitCode = 1;
 });

package/dist/index.js

@@ -1,2 +1,2 @@
-import "./chunk-OTVIAUQG.js";
-import "./chunk-ZQ5FTYKG.js";
+import "./chunk-SUNMRG3P.js";
+import "./chunk-6K6ZPDT4.js";

package/dist/{upgrade-EHMDEZGC.js → upgrade-I2RUTNAT.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Decantr CLI — search the registry, validate essence files, and access design intelligence from the terminal",
   "license": "MIT",
   "repository": {
@@ -23,8 +23,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@decantr/essence-spec": "1.0.0-beta.7",
-    "@decantr/registry": "1.0.0-beta.7"
+    "@decantr/essence-spec": "1.0.0-beta.8",
+    "@decantr/registry": "1.0.0-beta.8"
   },
   "scripts": {
     "build": "tsup",