@decantr/cli 1.10.0 → 2.1.0

package/dist/{chunk-USOO77A5.js → chunk-WDA4SHIQ.js}

@@ -958,7 +958,9 @@ ${themeBody}
   lines.push('  .d-shell[data-layout="copilot-overlay"] .d-shell-copilot {');
   lines.push("    display: none;");
   lines.push("  }");
-  lines.push('  .d-shell[data-layout="copilot-overlay"] .d-shell-copilot[data-mobile-open="true"] {');
+  lines.push(
+    '  .d-shell[data-layout="copilot-overlay"] .d-shell-copilot[data-mobile-open="true"] {'
+  );
   lines.push("    display: flex;");
   lines.push("    position: fixed;");
   lines.push("    inset: 0 0 0 auto;");
@@ -1354,7 +1356,10 @@ ${themeBody}
     ["border-bottom", "1px solid var(--d-border)"],
     ["background", "color-mix(in srgb, var(--d-surface) 82%, transparent)"],
     ["color", "var(--d-text-muted)"],
-    ["transition", "background var(--d-motion-fast, 150ms) ease, box-shadow var(--d-motion-fast, 150ms) ease, color var(--d-motion-fast, 150ms) ease"]
+    [
+      "transition",
+      "background var(--d-motion-fast, 150ms) ease, box-shadow var(--d-motion-fast, 150ms) ease, color var(--d-motion-fast, 150ms) ease"
+    ]
   ]);
   emitRule(".d-palette-search:focus-within", [
     ["background", "var(--d-surface)"],
@@ -1471,10 +1476,7 @@ ${themeBody}
     ["animation", "d-pulse-ring 1.5s var(--d-motion-ease-out, cubic-bezier(0,0,0.2,1)) infinite"]
   ]);
   emitRule(".d-shimmer", [
-    [
-      "background",
-      "linear-gradient(90deg, transparent, var(--d-surface-raised) 50%, transparent)"
-    ],
+    ["background", "linear-gradient(90deg, transparent, var(--d-surface-raised) 50%, transparent)"],
     ["background-size", "200% 100%"],
     ["animation", "d-shimmer 1.5s linear infinite"]
   ]);
@@ -1521,10 +1523,7 @@ ${themeBody}
     ["background", "radial-gradient(circle, currentColor 10%, transparent 10.01%)"],
     ["opacity", "0"],
     ["transform", "scale(0)"],
-    [
-      "transition",
-      "transform var(--d-motion-slow, 400ms), opacity var(--d-motion-slow, 400ms)"
-    ],
+    ["transition", "transform var(--d-motion-slow, 400ms), opacity var(--d-motion-slow, 400ms)"],
     ["pointer-events", "none"]
   ]);
   emitRule(".d-ripple:active::after", [
@@ -1891,9 +1890,7 @@ ${themeBody}
   lines.push("}");
   lines.push("");
   lines.push("@keyframes d-pulse-ring {");
-  lines.push(
-    "  0% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--d-primary) 40%, transparent); }"
-  );
+  lines.push("  0% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--d-primary) 40%, transparent); }");
   lines.push("  100% { box-shadow: 0 0 0 12px transparent; }");
   lines.push("}");
   lines.push("");
@@ -1909,9 +1906,7 @@ ${themeBody}
   lines.push("");
   lines.push("/* Respect user motion preferences \u2014 disable all declarative motion */");
   lines.push("@media (prefers-reduced-motion: reduce) {");
-  lines.push(
-    "  .d-enter-fade, .d-enter-slide-up, .d-enter-scale, .d-stagger-children > *,"
-  );
+  lines.push("  .d-enter-fade, .d-enter-slide-up, .d-enter-scale, .d-stagger-children > *,");
   lines.push("  .d-pulse, .d-pulse-ring, .d-shimmer, .d-float {");
   lines.push("    animation: none !important;");
   lines.push("  }");
@@ -2363,7 +2358,10 @@ function generateTopologySection(data, personality) {
   return lines.join("\n");
 }
 function readCliVersion() {
-  for (const candidate of [join2(__dirname, "..", "package.json"), join2(__dirname, "..", "..", "package.json")]) {
+  for (const candidate of [
+    join2(__dirname, "..", "package.json"),
+    join2(__dirname, "..", "..", "package.json")
+  ]) {
     try {
       const pkg = JSON.parse(readFileSync2(candidate, "utf-8"));
       if (pkg.version) return pkg.version;
@@ -2456,7 +2454,9 @@ function generateTokensCSS(themeData, mode, spatialTokens, options) {
       return entry?.[tokenMode] || entry?.[tokenModeKey] || entry?.dark || entry?.light;
     };
     const extendedPaletteTokens = Object.fromEntries(
-      Object.keys(palette).filter((key) => !CORE_PALETTE_KEYS.has(key)).map((key) => [`--d-${key.replace(/[^a-zA-Z0-9-]/g, "-")}`, pickPalette(key)]).filter((entry) => typeof entry[1] === "string" && entry[1].length > 0)
+      Object.keys(palette).filter((key) => !CORE_PALETTE_KEYS.has(key)).map((key) => [`--d-${key.replace(/[^a-zA-Z0-9-]/g, "-")}`, pickPalette(key)]).filter(
+        (entry) => typeof entry[1] === "string" && entry[1].length > 0
+      )
     );
     return {
       // Seed colors
@@ -2503,7 +2503,7 @@ function generateTokensCSS(themeData, mode, spatialTokens, options) {
       "--d-shadow": tokenMode === "light" ? "0 1px 3px rgba(0,0,0,0.1)" : "0 1px 3px rgba(0,0,0,0.25)",
       "--d-shadow-md": tokenMode === "light" ? "0 4px 6px rgba(0,0,0,0.1)" : "0 4px 6px rgba(0,0,0,0.3)",
       "--d-shadow-lg": tokenMode === "light" ? "0 10px 15px rgba(0,0,0,0.1)" : "0 10px 15px rgba(0,0,0,0.4)",
-      // Elevation scale (v2.1 Tier B3). Formal cross-theme depth system.
+      // Formal cross-theme depth system.
       // .d-elevate[data-level="N"] reads these. Dark themes need stronger
       // alpha to register on dark backgrounds.
       "--d-elevation-0": "none",
@@ -2519,7 +2519,7 @@ function generateTokensCSS(themeData, mode, spatialTokens, options) {
       "--d-info": "#3b82f6",
       "--d-danger": "var(--d-error)",
       "--d-destructive": "var(--d-error)",
-      // Motion scale (v2.1 Tier B1). Canonical durations + easings.
+      // Canonical motion durations + easings.
       // d-enter-fade, d-pulse, d-glow-hover, etc. all read these.
       // Themes can override via theme.motion.* and this picks them up
       // below. Defaults here ensure treatments work even without theme.
@@ -2537,7 +2537,7 @@ function generateTokensCSS(themeData, mode, spatialTokens, options) {
       "--d-duration-entrance": "var(--d-motion-base)",
       "--d-easing": "var(--d-motion-ease-out)",
       "--d-accent-glow": "color-mix(in srgb, var(--d-accent) 24%, transparent)",
-      // Typography scale (v2.1 Tier B2). Canonical sizes + weights +
+      // Canonical typography sizes + weights +
       // tracking + leading. d-display, d-headline, d-title, d-prose,
       // d-caption, d-eyebrow read these. Themes override via
       // theme.typography.* below.
@@ -2864,7 +2864,7 @@ function resolvePatternAlias(item, patterns) {
   }
   return item;
 }
-function buildEssenceV3(options, archetypeData, themeHints) {
+function buildEssenceV4(options, archetypeData, themeHints) {
   const isBrownfieldAttach = options.workflowMode === "brownfield-attach";
   let pages = isBrownfieldAttach ? [{ id: "observed-app", layout: ["existing-surface"] }] : [{ id: "home", layout: ["hero"] }];
   let features = options.features;
@@ -2926,7 +2926,7 @@ function buildEssenceV3(options, archetypeData, themeHints) {
     },
     typography: {
       // Coerce: 5 historical themes stored typography.scale as a numeric
-      // ratio (e.g., 1.15) instead of a string enum, which fails the v3
+      // ratio (e.g., 1.15) instead of a string enum, which fails the v4
       // essence schema (`/dna/typography/scale: must be string`). Treat
       // any non-string as missing and fall back to the canonical 'modular'.
       scale: typeof themeHints?.typography?.scale === "string" ? themeHints.typography.scale : "modular",
@@ -2958,10 +2958,32 @@ function buildEssenceV3(options, archetypeData, themeHints) {
     },
     personality: options.personality
   };
+  const sectionId = options.archetype || archetypeData?.id || "custom";
+  const sectionPages = pages.map((page, index) => ({
+    ...page,
+    route: page.route ?? (page.id === "home" || index === 0 ? "/" : `/${page.id}`)
+  }));
+  const section = {
+    id: sectionId,
+    role: archetypeData?.role || "primary",
+    shell: defaultShell,
+    features,
+    description: archetypeData?.description || `${sectionId} primary section`,
+    pages: sectionPages,
+    ...archetypeData?.navigation_items?.length ? { navigation_items: archetypeData.navigation_items } : {},
+    ...archetypeData?.directives?.length ? { directives: archetypeData.directives } : {}
+  };
+  const routes = {};
+  for (const page of sectionPages) {
+    if (page.route) {
+      routes[page.route] = { section: section.id, page: page.id };
+    }
+  }
   const blueprint = {
     shell: defaultShell,
-    pages,
-    features
+    sections: [section],
+    features,
+    routes
   };
   const meta = {
     archetype: options.archetype || "custom",
@@ -2970,7 +2992,7 @@ function buildEssenceV3(options, archetypeData, themeHints) {
     guard: guardModeMap[options.guard] || guardModeMap.guided
   };
   return {
-    version: "3.0.0",
+    version: "4.0.0",
     dna,
     blueprint,
     meta
@@ -3702,7 +3724,7 @@ function getCssApproachContent(adoptionMode) {
   if (adoptionMode === "style-bridge") return STYLE_BRIDGE_CSS_APPROACH;
   return CSS_APPROACH_CONTENT;
 }
-function generateDecantrMdV31(params) {
+function generateDecantrMdV4(params) {
   const template = loadTemplate("DECANTR.md.template");
   const body = renderTemplate(template, {
     GUARD_MODE: params.guardMode,
@@ -3740,9 +3762,7 @@ Start implementation from the shell layouts and shared route structure before fi
   briefLines.push(`- **Blueprint:** ${params.blueprintId || "custom"}`);
   const themeDesc = `${params.themeName || "default"} (${params.themeMode || "dark"} mode${params.themeShape ? `, ${params.themeShape} shape` : ""})`;
   briefLines.push(`- **Theme:** ${themeDesc}`);
-  briefLines.push(
-    `- **Workflow:** ${params.workflowMode || "greenfield-scaffold"}`
-  );
+  briefLines.push(`- **Workflow:** ${params.workflowMode || "greenfield-scaffold"}`);
   briefLines.push(`- **Adoption mode:** ${params.adoptionMode || "decantr-css"}`);
   if (params.personality && params.personality.length > 0) {
     briefLines.push(`- **Personality:** ${params.personality.join(". ")}`);
@@ -3890,10 +3910,10 @@ function buildFlagsString(options) {
   }
   return flags.join(" ");
 }
-function generateTaskContextV3(templateName, essence) {
+function generateTaskContextV4(templateName, essence) {
   const template = loadTemplate(templateName);
-  const sections = essence.blueprint.sections && essence.blueprint.sections.length > 0 ? essence.blueprint.sections : [];
-  const pages = sections.length > 0 ? sections.flatMap((s) => s.pages) : essence.blueprint.pages || [];
+  const sections = essence.blueprint.sections;
+  const pages = sections.flatMap((s) => s.pages);
   const defaultShell = sections[0]?.shell || essence.blueprint.shell || "sidebar-main";
   const layout = pages[0]?.layout?.map(serializeLayoutItem).join(", ") || "none";
   const pageShellMap = /* @__PURE__ */ new Map();
@@ -3940,7 +3960,7 @@ ${entries.map((entry) => `- ${entry}`).join("\n")}`;
 }
 function generateScaffoldTaskContext(essence, scaffoldPack, manifest) {
   if (!scaffoldPack) {
-    return generateTaskContextV3("task-scaffold.md.template", essence);
+    return generateTaskContextV4("task-scaffold.md.template", essence);
   }
   const themeShape = scaffoldPack.data.theme.shape || "default";
   const features = scaffoldPack.data.features.length > 0 ? scaffoldPack.data.features.join(", ") : "none";
@@ -3999,7 +4019,7 @@ Post-scaffold enforcement mode: **${essence.meta.guard.mode.toUpperCase()}**.
 }
 function generateAddPageTaskContext(essence, scaffoldPack, manifest) {
   if (!scaffoldPack) {
-    return generateTaskContextV3("task-add-page.md.template", essence);
+    return generateTaskContextV4("task-add-page.md.template", essence);
   }
   const routePlan = scaffoldPack.data.routes.length > 0 ? scaffoldPack.data.routes.map((route) => {
     const patternSummary = route.patternIds.length > 0 ? route.patternIds.join(", ") : "none";
@@ -4056,7 +4076,7 @@ ${renderPackReferenceList("Page Packs", pageRefs, "No page packs were generated
 }
 function generateModifyTaskContext(essence, scaffoldPack, manifest) {
   if (!scaffoldPack) {
-    return generateTaskContextV3("task-modify.md.template", essence);
+    return generateTaskContextV4("task-modify.md.template", essence);
   }
   const routePlan = scaffoldPack.data.routes.length > 0 ? scaffoldPack.data.routes.map((route) => {
     const patternSummary = route.patternIds.length > 0 ? route.patternIds.join(", ") : "none";
@@ -4100,53 +4120,6 @@ ${successChecks}
 
 *Task context generated from Decantr execution packs*`;
 }
-function generateEssenceSummaryV3(essence) {
-  const template = loadTemplate("essence-summary.md.template");
-  const blueprint = essence.blueprint;
-  const sections = blueprint.sections || [];
-  const flatPages = blueprint.pages || [];
-  let pagesTable;
-  if (sections.length > 0) {
-    const rows = sections.flatMap(
-      (s) => s.pages.map(
-        (p) => `| ${p.id} | ${s.shell} | ${p.layout.map(serializeLayoutItem).join(", ") || "none"} |`
-      )
-    );
-    pagesTable = `| Page | Shell | Layout |
-|------|-------|--------|
-${rows.join("\n")}`;
-  } else {
-    const shell = blueprint.shell ?? "sidebar-main";
-    const rows = flatPages.map(
-      (p) => `| ${p.id} | ${shell} | ${p.layout.map(serializeLayoutItem).join(", ") || "none"} |`
-    );
-    pagesTable = `| Page | Shell | Layout |
-|------|-------|--------|
-${rows.join("\n")}`;
-  }
-  const features = blueprint.features || [];
-  const featuresList = features.length > 0 ? features.map((f) => `- ${f}`).join("\n") : "- No features specified";
-  const vars = {
-    ARCHETYPE: essence.meta.archetype || "custom",
-    BLUEPRINT: "",
-    PERSONALITY: (essence.dna.personality || []).join(", "),
-    TARGET: essence.meta.target ?? "",
-    THEME_ID: essence.dna.theme.id ?? "",
-    THEME_MODE: essence.dna.theme.mode,
-    SHAPE: essence.dna.theme.shape ?? "",
-    PAGES_TABLE: pagesTable,
-    FEATURES_LIST: featuresList,
-    GUARD_MODE: essence.meta.guard.mode,
-    ENFORCE_STYLE: essence.meta.guard.dna_enforcement || "error",
-    ENFORCE_RECIPE: essence.meta.guard.blueprint_enforcement || "warn",
-    DNA_ENFORCEMENT: essence.meta.guard.dna_enforcement || "error",
-    BLUEPRINT_ENFORCEMENT: essence.meta.guard.blueprint_enforcement || "warn",
-    DENSITY: essence.dna.spacing?.density || "comfortable",
-    CONTENT_GAP: essence.dna.spacing?.content_gap || "_gap4",
-    LAST_UPDATED: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  return renderTemplate(template, vars);
-}
 function updateGitignore(projectRoot) {
   const gitignorePath = join2(projectRoot, ".gitignore");
   const cacheEntry = ".decantr/cache/";
@@ -4168,14 +4141,14 @@ ${cacheEntry}
   }
 }
 async function scaffoldProject(projectRoot, options, detected, registry, archetypeData, registrySource = "cache", themeData, topologyMarkdown, composedSections, routeMap, patternSpecs, blueprintData) {
-  const essenceV3 = buildEssenceV3(options, archetypeData, themeData);
+  const essenceV4 = buildEssenceV4(options, archetypeData, themeData);
   const decantrDir = join2(projectRoot, ".decantr");
   const contextDir = join2(decantrDir, "context");
   const cacheDir = join2(decantrDir, "cache");
   mkdirSync2(contextDir, { recursive: true });
   mkdirSync2(cacheDir, { recursive: true });
   const essencePath = join2(projectRoot, "decantr.essence.json");
-  writeFileSync2(essencePath, JSON.stringify(essenceV3, null, 2) + "\n");
+  writeFileSync2(essencePath, JSON.stringify(essenceV4, null, 2) + "\n");
   const projectJsonPath = join2(decantrDir, "project.json");
   const projectJsonStr = generateProjectJson(detected, options, registrySource);
   const projectJsonObj = JSON.parse(projectJsonStr);
@@ -4185,27 +4158,27 @@ async function scaffoldProject(projectRoot, options, detected, registry, archety
   writeFileSync2(projectJsonPath, JSON.stringify(projectJsonObj, null, 2));
   const contextFiles = [];
   if (composedSections) {
-    essenceV3.version = "3.1.0";
-    essenceV3.blueprint = {
+    essenceV4.version = "4.0.0";
+    essenceV4.blueprint = {
       sections: composedSections.sections,
       features: composedSections.features,
       routes: routeMap || {}
     };
     if (blueprintData?.personality?.length) {
-      essenceV3.dna.personality = typeof blueprintData.personality === "string" ? [blueprintData.personality] : blueprintData.personality;
+      essenceV4.dna.personality = typeof blueprintData.personality === "string" ? [blueprintData.personality] : blueprintData.personality;
     }
     if (blueprintData?.design_constraints) {
-      essenceV3.dna.constraints = blueprintData.design_constraints;
+      essenceV4.dna.constraints = blueprintData.design_constraints;
     }
     if (blueprintData?.seo_hints) {
-      essenceV3.meta.seo = blueprintData.seo_hints;
+      essenceV4.meta.seo = blueprintData.seo_hints;
     }
     if (blueprintData?.navigation) {
-      essenceV3.meta.navigation = blueprintData.navigation;
+      essenceV4.meta.navigation = blueprintData.navigation;
     }
-    writeFileSync2(essencePath, JSON.stringify(essenceV3, null, 2) + "\n");
+    writeFileSync2(essencePath, JSON.stringify(essenceV4, null, 2) + "\n");
   }
-  const refreshResult = await refreshDerivedFiles(projectRoot, essenceV3, registry, themeData, {
+  const refreshResult = await refreshDerivedFiles(projectRoot, essenceV4, registry, themeData, {
     isInitialScaffold: true,
     patternSpecs,
     workflowMode: options.workflowMode,
@@ -4231,7 +4204,7 @@ function scaffoldMinimal(projectRoot, options = {}) {
     mkdirSync2(join2(customDir, type), { recursive: true });
   }
   const essence = {
-    version: "3.0.0",
+    version: "4.0.0",
     dna: {
       theme: {
         id: "default",
@@ -4276,8 +4249,18 @@ function scaffoldMinimal(projectRoot, options = {}) {
     },
     blueprint: {
       shell: "sidebar-main",
-      pages: [{ id: "home", layout: ["hero"] }],
-      features: []
+      sections: [
+        {
+          id: "custom",
+          role: "primary",
+          shell: "sidebar-main",
+          features: [],
+          description: "custom primary section",
+          pages: [{ id: "home", route: "/", layout: ["hero"] }]
+        }
+      ],
+      features: [],
+      routes: { "/": { section: "custom", page: "home" } }
     },
     meta: {
       archetype: "custom",
@@ -4338,7 +4321,7 @@ function scaffoldMinimal(projectRoot, options = {}) {
 
 ## Two-Layer Model
 
-This project uses the v3 Essence format with two layers:
+This project uses the Essence v4 format with two layers:
 
 ### DNA (Immutable Design Axioms)
 DNA defines the foundational design rules that must never be violated. DNA violations are **errors**.
@@ -4382,7 +4365,7 @@ When available, use these tools:
 - \`decantr status\` \u2014 Project health and DNA/Blueprint overview
 - \`decantr sync\` \u2014 Sync registry content
 - \`decantr audit\` \u2014 Audit project for issues
-- \`decantr migrate\` \u2014 Migrate v2 essence to v3
+- \`decantr migrate --to v4\` \u2014 Migrate older essence files to v4
 - \`decantr check\` \u2014 Detect drift issues
 - \`decantr sync-drift\` \u2014 Review and resolve drift entries
 - \`decantr validate\` \u2014 Validate essence file
@@ -4442,10 +4425,7 @@ function writeExecutionPackBundleArtifacts(contextDir, bundle) {
   for (const [index, pagePack] of bundle.pages.entries()) {
     const manifestPage = bundle.manifest.pages[index];
     const pageBaseName = manifestPage?.markdown?.endsWith(".md") ? manifestPage.markdown.slice(0, -".md".length) : `page-${pagePack.data.pageId}-pack`;
-    const pagePackPath = writeExecutionPackArtifacts(
-      join2(contextDir, pageBaseName),
-      pagePack
-    );
+    const pagePackPath = writeExecutionPackArtifacts(join2(contextDir, pageBaseName), pagePack);
     outputPaths.push(pagePackPath);
   }
   for (const mutationPack of bundle.mutations) {
@@ -4688,7 +4668,10 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
     }
     const features = essence.blueprint?.features ?? [];
     const hasThemeToggle = features.includes("theme-toggle") || features.includes("theme_toggle");
-    writeFileSync2(tokensPath, generateTokensCSS(themeData, mode, spatialTokens, { hasThemeToggle }));
+    writeFileSync2(
+      tokensPath,
+      generateTokensCSS(themeData, mode, spatialTokens, { hasThemeToggle })
+    );
   }
   const treatmentsPath = join2(stylesDir, "treatments.css");
   if (effectiveAdoptionMode === "decantr-css") {
@@ -4744,7 +4727,7 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
   const decantrMdPath = join2(projectRoot, "DECANTR.md");
   writeFileSync2(
     decantrMdPath,
-    generateDecantrMdV31({
+    generateDecantrMdV4({
       guardMode,
       cssApproach: getCssApproachContent(effectiveAdoptionMode),
       workflowMode: effectiveWorkflowMode,
@@ -4761,13 +4744,7 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
       decoratorDefinitions: themeData?.decorator_definitions
     })
   );
-  const hasSections = essence.blueprint.sections && essence.blueprint.sections.length > 0;
   const contextFiles = [];
-  if (!hasSections) {
-    const summaryPath = join2(contextDir, "essence-summary.md");
-    writeFileSync2(summaryPath, generateEssenceSummaryV3(essence));
-    contextFiles.push(summaryPath);
-  }
   const packContexts = await generatePackContexts(projectRoot, contextDir, essence);
   const scaffoldTaskPath = join2(contextDir, "task-scaffold.md");
   writeFileSync2(
@@ -4790,217 +4767,149 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
     contextFiles.push(modifyPath);
   }
   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 sections = blueprint.sections;
+  if (sections.length === 0) {
+    throw new Error(
+      "Essence v4 requires blueprint.sections. Run `decantr migrate --to v4` for older essence files."
+    );
+  }
+  const primarySectionShell = sections.find((s) => s.role === "primary")?.shell || "sidebar-main";
+  for (const section of sections) {
+    if (section.shell === "inherit") {
+      section.shell = primarySectionShell;
     }
-    const prefetchedSpecs = options?.patternSpecs;
-    const patternSpecs = {};
-    const seenPatterns = /* @__PURE__ */ new Set();
-    for (const section of sections) {
-      for (const page of section.pages) {
-        for (const item of page.layout) {
-          const names = extractPatternNames(item);
-          for (const name of names) {
-            if (!seenPatterns.has(name)) {
-              seenPatterns.add(name);
-              const spec = await resolvePatternSpec(name, registry, prefetchedSpecs?.[name], true);
-              if (spec) patternSpecs[name] = spec;
-            }
+  }
+  const prefetchedSpecs = options?.patternSpecs;
+  const patternSpecs = {};
+  const seenPatterns = /* @__PURE__ */ new Set();
+  for (const section of sections) {
+    for (const page of section.pages) {
+      for (const item of page.layout) {
+        const names = extractPatternNames(item);
+        for (const name of names) {
+          if (!seenPatterns.has(name)) {
+            seenPatterns.add(name);
+            const spec = await resolvePatternSpec(name, registry, prefetchedSpecs?.[name], true);
+            if (spec) patternSpecs[name] = spec;
           }
         }
       }
     }
-    const zoneInputs = sections.map((s) => ({
-      archetypeId: s.id,
-      role: s.role,
-      shell: s.shell,
-      features: s.features,
-      description: s.description
-    }));
-    const zones = deriveZones(zoneInputs);
-    const transitions = deriveTransitions(zones);
-    const hasPublic = zones.some((z) => z.role === "public");
-    const hasPrimary = zones.some((z) => z.role === "primary");
-    const topologyData = {
-      intent: sections.map((s) => s.id).join(" + "),
-      zones,
-      transitions,
-      entryPoints: {
-        anonymous: hasPublic ? "public zone" : "gateway",
-        authenticated: hasPrimary ? "primary zone" : "first section"
-      }
-    };
-    const topologyMarkdown = generateTopologySection(topologyData, personality);
-    const themeTokensCss = existsSync2(tokensPath) ? readFileSync2(tokensPath, "utf-8") : "";
-    const decoratorList = [];
-    if (themeData?.decorators) {
-      for (const [name, desc] of Object.entries(themeData.decorators)) {
-        decoratorList.push({ name, description: desc });
-      }
+  }
+  const zoneInputs = sections.map((s) => ({
+    archetypeId: s.id,
+    role: s.role,
+    shell: s.shell,
+    features: s.features,
+    description: s.description
+  }));
+  const zones = deriveZones(zoneInputs);
+  const transitions = deriveTransitions(zones);
+  const hasPublic = zones.some((z) => z.role === "public");
+  const hasPrimary = zones.some((z) => z.role === "primary");
+  const topologyData = {
+    intent: sections.map((s) => s.id).join(" + "),
+    zones,
+    transitions,
+    entryPoints: {
+      anonymous: hasPublic ? "public zone" : "gateway",
+      authenticated: hasPrimary ? "primary zone" : "first section"
     }
-    const shellInfoCache = {};
-    const seenShells = /* @__PURE__ */ new Set();
-    for (const section of sections) {
-      const shellId = section.shell;
-      if (!seenShells.has(shellId)) {
-        seenShells.add(shellId);
-        try {
-          const shellResult = await registry.fetchShell(shellId);
-          if (shellResult?.data) {
-            shellInfoCache[shellId] = mapRegistryShellToShellInfo(shellResult.data);
-          }
-        } catch {
-        }
-      }
+  };
+  const topologyMarkdown = generateTopologySection(topologyData, personality);
+  const themeTokensCss = existsSync2(tokensPath) ? readFileSync2(tokensPath, "utf-8") : "";
+  const decoratorList = [];
+  if (themeData?.decorators) {
+    for (const [name, desc] of Object.entries(themeData.decorators)) {
+      decoratorList.push({ name, description: desc });
     }
-    for (const section of sections) {
-      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) {
-          const names = extractPatternNames(item);
-          for (const name of names) {
-            if (patternSpecs[name]) {
-              sectionPatterns[name] = patternSpecs[name];
-            }
-          }
+  }
+  const shellInfoCache = {};
+  const seenShells = /* @__PURE__ */ new Set();
+  for (const section of sections) {
+    const shellId = section.shell;
+    if (!seenShells.has(shellId)) {
+      seenShells.add(shellId);
+      try {
+        const shellResult = await registry.fetchShell(shellId);
+        if (shellResult?.data) {
+          shellInfoCache[shellId] = mapRegistryShellToShellInfo(shellResult.data);
         }
+      } catch {
       }
-      const sectionSpatialHints = 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,
-        label_content_gap: themeData.spatial.label_content_gap ?? void 0
-      } : void 0;
-      const contextContent = generateSectionContext({
-        section,
-        themeTokens: themeTokensCss,
-        decorators: decoratorList,
-        guardConfig,
-        personality,
-        themeName,
-        zoneContext,
-        patternSpecs: sectionPatterns,
-        themeHints: themeData ? {
-          preferred: themeData.pattern_preferences?.prefer,
-          compositions: themeData.compositions ? Object.entries(themeData.compositions).map(([k, v]) => `**${k}:** ${v.description || v}`).join("\n") : void 0,
-          spatialHints: themeData.spatial ? `Density bias: ${themeData.spatial.density_bias || "none"}. Section padding: ${themeData.spatial.section_padding || "default"}. Card wrapping: ${themeData.spatial.card_wrapping || "default"}.` : void 0
-        } : void 0,
-        constraints: essence.dna.constraints,
-        shellInfo: shellInfoCache[section.shell],
-        themeData,
-        themeMode: mode,
-        voiceTone: storedVoice?.tone ? storedVoice.tone.split(".")[0] + "." : void 0,
-        spatialHints: sectionSpatialHints
-      });
-      const sectionContextPath = join2(contextDir, `section-${section.id}.md`);
-      writeFileSync2(sectionContextPath, contextContent);
-      contextFiles.push(sectionContextPath);
     }
-    const routes = blueprint.routes || {};
-    const scaffoldContent = generateScaffoldContext({
-      appName: essence.meta.archetype || "Application",
-      blueprintId: storedBlueprintId || getLegacyBlueprintId(essence.meta) || "",
-      themeName,
-      personality,
-      topologyMarkdown,
-      sections,
-      routes,
-      constraints: essence.dna.constraints,
-      seo: essence.meta.seo,
-      navigation: essence.meta.navigation,
-      voice: storedVoice
-    });
-    const scaffoldMdPath = join2(contextDir, "scaffold.md");
-    writeFileSync2(scaffoldMdPath, scaffoldContent);
-    contextFiles.push(scaffoldMdPath);
-  } else {
-    const pages = blueprint.pages || [{ id: "home", layout: ["hero"] }];
-    const shell = blueprint.shell ?? "sidebar-main";
-    const syntheticSection = {
-      id: essence.meta.archetype || "default",
-      role: "primary",
-      shell,
-      features: blueprint.features || [],
-      description: `${essence.meta.archetype || "Application"} section`,
-      pages
-    };
-    const prefetchedSpecs = options?.patternSpecs;
-    const patternSpecs = {};
-    const seenPatterns = /* @__PURE__ */ new Set();
-    for (const page of pages) {
+  }
+  for (const section of sections) {
+    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) {
         const names = extractPatternNames(item);
         for (const name of names) {
-          if (!seenPatterns.has(name)) {
-            seenPatterns.add(name);
-            const spec = await resolvePatternSpec(name, registry, prefetchedSpecs?.[name], false);
-            if (spec) patternSpecs[name] = spec;
+          if (patternSpecs[name]) {
+            sectionPatterns[name] = patternSpecs[name];
           }
         }
       }
     }
-    const themeTokensCss = existsSync2(tokensPath) ? readFileSync2(tokensPath, "utf-8") : "";
-    const decoratorList = [];
-    if (themeData?.decorators) {
-      for (const [name, desc] of Object.entries(themeData.decorators)) {
-        decoratorList.push({ name, description: desc });
-      }
-    }
-    let v30ShellInfo;
-    try {
-      const shellResult = await registry.fetchShell(shell);
-      if (shellResult?.data) {
-        v30ShellInfo = mapRegistryShellToShellInfo(shellResult.data);
-      }
-    } catch {
-    }
-    const v30SpatialHints = themeData?.spatial ? {
+    const sectionSpatialHints = 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,
       label_content_gap: themeData.spatial.label_content_gap ?? void 0
     } : void 0;
     const contextContent = generateSectionContext({
-      section: syntheticSection,
+      section,
       themeTokens: themeTokensCss,
       decorators: decoratorList,
       guardConfig,
       personality,
       themeName,
-      zoneContext: `This is the primary section (${shell} shell).`,
-      patternSpecs,
+      zoneContext,
+      patternSpecs: sectionPatterns,
       themeHints: themeData ? {
         preferred: themeData.pattern_preferences?.prefer,
         compositions: themeData.compositions ? Object.entries(themeData.compositions).map(([k, v]) => `**${k}:** ${v.description || v}`).join("\n") : void 0,
         spatialHints: themeData.spatial ? `Density bias: ${themeData.spatial.density_bias || "none"}. Section padding: ${themeData.spatial.section_padding || "default"}. Card wrapping: ${themeData.spatial.card_wrapping || "default"}.` : void 0
       } : void 0,
       constraints: essence.dna.constraints,
-      shellInfo: v30ShellInfo,
+      shellInfo: shellInfoCache[section.shell],
       themeData,
       themeMode: mode,
       voiceTone: storedVoice?.tone ? storedVoice.tone.split(".")[0] + "." : void 0,
-      spatialHints: v30SpatialHints
+      spatialHints: sectionSpatialHints
     });
-    const sectionContextPath = join2(contextDir, `section-${syntheticSection.id}.md`);
+    const sectionContextPath = join2(contextDir, `section-${section.id}.md`);
     writeFileSync2(sectionContextPath, contextContent);
     contextFiles.push(sectionContextPath);
   }
+  const routes = blueprint.routes || {};
+  const scaffoldContent = generateScaffoldContext({
+    appName: essence.meta.archetype || "Application",
+    blueprintId: storedBlueprintId || getLegacyBlueprintId(essence.meta) || "",
+    themeName,
+    personality,
+    topologyMarkdown,
+    sections,
+    routes,
+    constraints: essence.dna.constraints,
+    seo: essence.meta.seo,
+    navigation: essence.meta.navigation,
+    voice: storedVoice
+  });
+  const scaffoldMdPath = join2(contextDir, "scaffold.md");
+  writeFileSync2(scaffoldMdPath, scaffoldContent);
+  contextFiles.push(scaffoldMdPath);
   if (packContexts.paths.length > 0) {
     contextFiles.push(...packContexts.paths);
   }
@@ -5265,9 +5174,7 @@ function generateQuickStart(input) {
   if (pLower.includes("neon") || pLower.includes("glow")) personalityUtils.push("neon-glow");
   if (pLower.includes("mono") || pLower.includes("monospace")) personalityUtils.push("mono-data");
   if (personalityUtils.length > 0) {
-    lines.push(
-      `**Personality utilities:** ${personalityUtils.map((c) => `\`.${c}\``).join(", ")}`
-    );
+    lines.push(`**Personality utilities:** ${personalityUtils.map((c) => `\`.${c}\``).join(", ")}`);
   }
   const density = section.dna_overrides?.density || "comfortable";
   lines.push(`**Density:** ${density}`);