@decantr/cli 1.7.4 → 1.7.6

package/dist/{chunk-Y5C2O7Z7.js → chunk-KAEQTVAM.js}

@@ -1,22 +1,38 @@
 import {
   RegistryClient,
+  collectPatternIdsFromItems,
   composeArchetypes,
   composeSections,
   deriveTransitions,
   deriveZones,
   generateTopologySection,
+  mapRegistryArchetypeToArchetypeData,
+  mapRegistryPatternToPatternSpecSummary,
+  mapRegistryThemeToThemeData,
   refreshDerivedFiles,
   scaffoldMinimal,
   scaffoldProject,
-  syncRegistry
-} from "./chunk-XKXUVNUQ.js";
+  syncRegistry,
+  writeExecutionPackBundleArtifacts
+} from "./chunk-H4H3IQJK.js";
+import {
+  buildGuardRegistryContext
+} from "./chunk-KUDAVJOR.js";
 
 // src/index.ts
-import { readFileSync as readFileSync15, existsSync as existsSync23, readdirSync as readdirSync6 } from "fs";
-import { join as join23, dirname as dirname2 } from "path";
-import { fileURLToPath } from "url";
+import { mkdirSync as mkdirSync9, readFileSync as readFileSync16, writeFileSync as writeFileSync13, existsSync as existsSync24, readdirSync as readdirSync6 } from "fs";
+import { basename, join as join24, dirname as dirname2, isAbsolute, resolve as resolve3 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { validateEssence as validateEssence2, evaluateGuard, isV3 as isV36 } from "@decantr/essence-spec";
-import { RegistryAPIClient as RegistryAPIClient3 } from "@decantr/registry";
+import {
+  RegistryAPIClient as RegistryAPIClient3,
+  CONTENT_TYPES as GET_CONTENT_TYPES,
+  API_CONTENT_TYPES as LIST_CONTENT_TYPES,
+  CONTENT_TYPE_TO_API_CONTENT_TYPE as CONTENT_TYPE_TO_API_CONTENT_TYPE3,
+  isContentType as isGetContentType,
+  isApiContentType,
+  isContentIntelligenceSource
+} from "@decantr/registry";
 
 // src/detect.ts
 import { existsSync, readFileSync } from "fs";
@@ -165,10 +181,10 @@ var CYAN = "\x1B[36m";
 function ask(question, defaultValue) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const prompt = defaultValue ? `${question} ${DIM}(${defaultValue})${RESET}: ` : `${question}: `;
-  return new Promise((resolve2) => {
+  return new Promise((resolve4) => {
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve2(answer.trim() || defaultValue || "");
+      resolve4(answer.trim() || defaultValue || "");
     });
   });
 }
@@ -361,7 +377,7 @@ function mergeWithDefaults(flags, detected) {
 }
 async function runSimplifiedInit(blueprints) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const question = (q) => new Promise((resolve2) => rl.question(q, resolve2));
+  const question = (q) => new Promise((resolve4) => rl.question(q, resolve4));
   console.log("\n? What blueprint would you like to scaffold?\n");
   console.log("  1. Decantr default (recommended)");
   console.log("  2. Search registry...\n");
@@ -399,11 +415,12 @@ import { join as join2 } from "path";
 // src/theme-templates.ts
 function getThemeSkeleton(id, name) {
   return {
-    $schema: "https://decantr.ai/schemas/style-metadata.v1.json",
+    $schema: "https://decantr.ai/schemas/theme.v1.json",
     id,
     name,
-    description: "",
+    description: `Custom theme starter for ${name}. Replace the seed palette, personality, and treatments before publishing.`,
     tags: [],
+    personality: "",
     seed: {
       primary: "#6366F1",
       secondary: "#8B5CF6",
@@ -432,10 +449,12 @@ decantr theme create mytheme
 
 | Field | Required | Description |
 |-------|----------|-------------|
+| $schema | Yes | Must be \`https://decantr.ai/schemas/theme.v1.json\` |
 | id | Yes | Unique identifier (matches filename) |
 | name | Yes | Display name |
-| description | No | Brief description |
+| description | Yes | Brief description for humans and LLMs |
 | tags | No | Searchable tags |
+| personality | No | Short visual summary for LLMs |
 | seed | Yes | Core colors: primary, secondary, accent, background |
 | palette | No | Extended color palette |
 | modes | Yes | Supported modes: ["light"], ["dark"], or both |
@@ -450,7 +469,7 @@ In \`decantr.essence.json\`:
 \`\`\`json
 {
   "theme": {
-    "style": "custom:mytheme",
+    "id": "custom:mytheme",
     "mode": "dark"
   }
 }
@@ -473,10 +492,11 @@ decantr get theme auradecantism
 }
 
 // src/theme-commands.ts
-var REQUIRED_FIELDS = ["id", "name", "seed", "modes", "shapes", "decantr_compat", "source"];
+var REQUIRED_FIELDS = ["$schema", "id", "name", "description", "seed", "modes", "shapes", "decantr_compat", "source"];
 var REQUIRED_SEED = ["primary", "secondary", "accent", "background"];
 var VALID_MODES = ["light", "dark"];
 var VALID_SHAPES = ["sharp", "rounded", "pill"];
+var THEME_SCHEMA_URL = "https://decantr.ai/schemas/theme.v1.json";
 function validateCustomTheme(theme) {
   const errors = [];
   for (const field of REQUIRED_FIELDS) {
@@ -484,6 +504,15 @@ function validateCustomTheme(theme) {
       errors.push(`Missing required field: ${field}`);
     }
   }
+  for (const field of ["id", "name", "description"]) {
+    const value = theme[field];
+    if (value !== void 0 && (typeof value !== "string" || value.trim().length === 0)) {
+      errors.push(`Field "${field}" must be a non-empty string`);
+    }
+  }
+  if ("$schema" in theme && theme.$schema !== THEME_SCHEMA_URL) {
+    errors.push(`Invalid $schema "${String(theme.$schema)}" - must be "${THEME_SCHEMA_URL}"`);
+  }
   if (theme.seed && typeof theme.seed === "object") {
     const seed = theme.seed;
     for (const color of REQUIRED_SEED) {
@@ -643,24 +672,21 @@ function getApiKeyOrToken() {
   return creds.api_key || creds.access_token || null;
 }
 
+// src/index.ts
+import {
+  auditProject,
+  critiqueFile as critiqueProjectFile
+} from "@decantr/verifier";
+
 // src/commands/publish.ts
 import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
 import { join as join4 } from "path";
-import { RegistryAPIClient } from "@decantr/registry";
-var PLURAL_TO_SINGULAR = {
-  patterns: "pattern",
-  themes: "theme",
-  blueprints: "blueprint",
-  archetypes: "archetype",
-  shells: "shell"
-};
-var SINGULAR_TO_PLURAL = {
-  pattern: "patterns",
-  theme: "themes",
-  blueprint: "blueprints",
-  archetype: "archetypes",
-  shell: "shells"
-};
+import {
+  RegistryAPIClient,
+  RegistryAPIError,
+  API_CONTENT_TYPE_TO_CONTENT_TYPE,
+  CONTENT_TYPE_TO_API_CONTENT_TYPE
+} from "@decantr/registry";
 async function cmdPublish(type, name, projectRoot = process.cwd()) {
   const token = getApiKeyOrToken();
   if (!token) {
@@ -668,8 +694,8 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
     process.exitCode = 1;
     return;
   }
-  const singularType = PLURAL_TO_SINGULAR[type] || type;
-  const pluralType = SINGULAR_TO_PLURAL[type] || SINGULAR_TO_PLURAL[singularType] || `${type}s`;
+  const singularType = API_CONTENT_TYPE_TO_CONTENT_TYPE[type] || type;
+  const pluralType = CONTENT_TYPE_TO_API_CONTENT_TYPE[type] || CONTENT_TYPE_TO_API_CONTENT_TYPE[singularType] || `${type}s`;
   const customPath = join4(projectRoot, ".decantr", "custom", pluralType, `${name}.json`);
   if (!existsSync4(customPath)) {
     console.error(`Custom ${singularType} "${name}" not found at ${customPath}`);
@@ -700,7 +726,18 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
     console.log(`Published ${singularType}/${name} to @community`);
     console.log(`Status: ${result.status}`);
   } catch (err) {
-    console.error(`Failed to publish: ${err.message}`);
+    if (err instanceof RegistryAPIError) {
+      console.error(`Failed to publish: ${err.message}`);
+      const details = err.details;
+      if (Array.isArray(details?.validationErrors) && details.validationErrors.length > 0) {
+        console.error("Validation errors:");
+        for (const validationError of details.validationErrors) {
+          console.error(`  - ${String(validationError)}`);
+        }
+      }
+    } else {
+      console.error(`Failed to publish: ${err.message}`);
+    }
     process.exitCode = 1;
   }
 }
@@ -708,33 +745,110 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
 // src/commands/create.ts
 import { existsSync as existsSync5, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
 import { join as join5 } from "path";
-var CONTENT_TYPES = ["pattern", "theme", "blueprint", "archetype", "shell"];
-var PLURAL = {
-  pattern: "patterns",
-  theme: "themes",
-  blueprint: "blueprints",
-  archetype: "archetypes",
-  shell: "shells"
+import {
+  CONTENT_TYPES,
+  CONTENT_TYPE_TO_API_CONTENT_TYPE as CONTENT_TYPE_TO_API_CONTENT_TYPE2
+} from "@decantr/registry";
+var PLURAL = CONTENT_TYPE_TO_API_CONTENT_TYPE2;
+var SCHEMA_URLS = {
+  pattern: "https://decantr.ai/schemas/pattern.v2.json",
+  theme: "https://decantr.ai/schemas/theme.v1.json",
+  blueprint: "https://decantr.ai/schemas/blueprint.v1.json",
+  archetype: "https://decantr.ai/schemas/archetype.v2.json",
+  shell: "https://decantr.ai/schemas/shell.v1.json"
 };
+function humanizeId(id) {
+  return id.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
 function getSkeleton(type, id, name) {
   const base = {
+    $schema: SCHEMA_URLS[type],
     id,
     name,
-    description: "",
-    version: "1.0.0",
-    source: "custom"
+    version: "1.0.0"
   };
   switch (type) {
     case "pattern":
-      return { ...base, components: [], presets: {}, layout: {} };
+      return {
+        ...base,
+        description: `Starter pattern for ${name}. Replace the preset layout, slots, and code examples before publishing.`,
+        tags: [],
+        components: [],
+        default_preset: "standard",
+        presets: {
+          standard: {
+            description: "Default starter preset. Replace the layout atoms and slots with the real structure for this pattern.",
+            layout: {
+              layout: "stack",
+              atoms: "_flex _col _gap4"
+            }
+          }
+        }
+      };
     case "theme":
-      return { ...base, seed: { primary: "#6500C6", secondary: "#0AF3EB", accent: "#F58882", background: "#0D0D1A" }, modes: ["dark"], shapes: ["rounded"] };
+      return getThemeSkeleton(id, name);
     case "blueprint":
-      return { ...base, compose: [], theme: {}, personality: [] };
+      return {
+        ...base,
+        description: `Starter blueprint for ${name}. Replace the theme, routes, and composed archetypes before publishing.`,
+        tags: [],
+        compose: ["starter-home"],
+        theme: {
+          id: "carbon",
+          mode: "dark",
+          shape: "rounded"
+        },
+        personality: "Calm, production-ready starter blueprint. Tailor the voice, routes, and composed archetypes to your product.",
+        routes: {
+          "/": {
+            page: "home",
+            shell: "top-nav-main",
+            archetype: "starter-home"
+          }
+        },
+        overrides: {
+          features_add: [],
+          features_remove: [],
+          pages: {},
+          pages_remove: []
+        }
+      };
     case "archetype":
-      return { ...base, pages: [], features: [], suggested_theme: "" };
+      return {
+        ...base,
+        role: "primary",
+        description: `Starter archetype for ${name}. Replace the sample page, pattern layout, and features before publishing.`,
+        tags: ["starter"],
+        pages: [
+          {
+            id: "home",
+            description: "Starter page for your primary flow.",
+            shell: "top-nav-main",
+            patterns: [],
+            default_layout: []
+          }
+        ],
+        features: [],
+        suggested_theme: {
+          ids: ["carbon"],
+          modes: ["dark"],
+          shapes: ["rounded"]
+        }
+      };
     case "shell":
-      return { ...base, regions: [], layout: "sidebar-main" };
+      return {
+        ...base,
+        description: `Starter shell for ${name}. Replace the regions, layout guidance, and internal structure before publishing.`,
+        layout: "stack",
+        atoms: "_flex _col _h[100vh]",
+        config: {
+          regions: ["header", "body"]
+        },
+        guidance: {
+          section_label_treatment: "d-label",
+          section_density: "comfortable"
+        }
+      };
   }
 }
 function cmdCreate(type, name, projectRoot = process.cwd()) {
@@ -743,7 +857,8 @@ function cmdCreate(type, name, projectRoot = process.cwd()) {
     process.exitCode = 1;
     return;
   }
-  const plural = PLURAL[type];
+  const contentType = type;
+  const plural = PLURAL[contentType];
   const customDir = join5(projectRoot, ".decantr", "custom", plural);
   const filePath = join5(customDir, `${name}.json`);
   if (existsSync5(filePath)) {
@@ -752,7 +867,7 @@ function cmdCreate(type, name, projectRoot = process.cwd()) {
     return;
   }
   mkdirSync3(customDir, { recursive: true });
-  const skeleton = getSkeleton(type, name, name.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()));
+  const skeleton = getSkeleton(contentType, name, humanizeId(name));
   writeFileSync3(filePath, JSON.stringify(skeleton, null, 2));
   console.log(`Created ${type} "${name}" at ${filePath}`);
   console.log(`Edit it, then publish with: decantr publish ${type} ${name}`);
@@ -1059,15 +1174,14 @@ async function cmdAddSection(archetypeId, args, projectRoot = process.cwd()) {
     process.exitCode = 1;
     return;
   }
-  const raw = result.data;
-  const inner = raw.data ?? raw;
+  const archetype = result.data;
   const newSection = {
-    id: inner.id || archetypeId,
-    role: inner.role || "auxiliary",
-    shell: inner.pages?.[0]?.shell || essence.blueprint.shell || "top-nav-main",
-    features: inner.features || [],
-    description: inner.description || "",
-    pages: (inner.pages || []).map((p) => ({
+    id: archetype.id || archetypeId,
+    role: archetype.role || "auxiliary",
+    shell: archetype.pages?.[0]?.shell || essence.blueprint.shell || "top-nav-main",
+    features: archetype.features || [],
+    description: archetype.description || "",
+    pages: (archetype.pages || []).map((p) => ({
       id: p.id,
       layout: p.default_layout?.length ? p.default_layout : ["hero"]
     }))
@@ -1332,6 +1446,8 @@ var RED6 = "\x1B[31m";
 var YELLOW4 = "\x1B[33m";
 var DIM7 = "\x1B[2m";
 var RESET7 = "\x1B[0m";
+var VALID_THEME_SHAPES = ["sharp", "rounded", "pill"];
+var VALID_THEME_MODES = ["light", "dark", "auto"];
 async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   if (!themeName) {
     console.error(`${RED6}Usage: decantr theme switch <themeName> [--shape <s>] [--mode <m>]${RESET7}`);
@@ -1372,10 +1488,18 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
       mode = args[++i];
     }
   }
-  const oldThemeId = essence.dna.theme.id || essence.dna.theme.style;
+  if (shape && !VALID_THEME_SHAPES.includes(shape)) {
+    console.error(`${RED6}Invalid shape "${shape}". Must be one of: ${VALID_THEME_SHAPES.join(", ")}.${RESET7}`);
+    process.exitCode = 1;
+    return;
+  }
+  if (mode && !VALID_THEME_MODES.includes(mode)) {
+    console.error(`${RED6}Invalid mode "${mode}". Must be one of: ${VALID_THEME_MODES.join(", ")}.${RESET7}`);
+    process.exitCode = 1;
+    return;
+  }
+  const oldThemeId = essence.dna.theme.id;
   essence.dna.theme.id = themeName;
-  delete essence.dna.theme.style;
-  delete essence.dna.theme.recipe;
   if (shape) {
     essence.dna.theme.shape = shape;
   }
@@ -1388,13 +1512,11 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   try {
     const themeResult = await registryClient.fetchTheme(themeName);
     if (themeResult?.data) {
-      const raw = themeResult.data;
-      const inner = raw.data ?? raw;
-      if (inner.radius) {
+      if (themeResult.data.radius) {
         essence.dna.radius = {
           ...essence.dna.radius,
-          philosophy: inner.radius.philosophy || essence.dna.radius.philosophy,
-          base: inner.radius.base ?? essence.dna.radius.base
+          philosophy: themeResult.data.radius.philosophy || essence.dna.radius.philosophy,
+          base: themeResult.data.radius.base ?? essence.dna.radius.base
         };
       }
     }
@@ -2357,7 +2479,7 @@ async function resolveTheme(intent, registryClient) {
         }).sort((a, b) => b.score - a.score);
         if (scored[0] && scored[0].score > 0) {
           const mode2 = intent.themeHints.includes("light") ? "light" : intent.themeHints.includes("dark") ? "dark" : scored[0].modes?.includes("dark") ? "dark" : "light";
-          return { style: scored[0].id, mode: mode2 };
+          return { id: scored[0].id, mode: mode2 };
         }
       }
     } catch {
@@ -2365,14 +2487,14 @@ async function resolveTheme(intent, registryClient) {
   }
   let mode = "dark";
   if (hints.includes("light")) mode = "light";
-  if (hints.includes("neon") || hints.includes("glass")) return { style: "obsidianite", mode };
-  if (hints.includes("warm") || hints.includes("elegant")) return { style: "aurealis", mode };
-  if (hints.includes("cool") || hints.includes("minimal")) return { style: "glacialis", mode };
-  if (hints.includes("brutalist")) return { style: "ferrocrete", mode };
-  if (hints.includes("corporate")) return { style: "luminarum", mode };
-  if (hints.includes("playful")) return { style: "solstice", mode };
-  if (hints.includes("retro")) return { style: "oxidian", mode };
-  return { style: "luminarum", mode };
+  if (hints.includes("neon") || hints.includes("glass")) return { id: "obsidianite", mode };
+  if (hints.includes("warm") || hints.includes("elegant")) return { id: "aurealis", mode };
+  if (hints.includes("cool") || hints.includes("minimal")) return { id: "glacialis", mode };
+  if (hints.includes("brutalist")) return { id: "ferrocrete", mode };
+  if (hints.includes("corporate")) return { id: "luminarum", mode };
+  if (hints.includes("playful")) return { id: "solstice", mode };
+  if (hints.includes("retro")) return { id: "oxidian", mode };
+  return { id: "luminarum", mode };
 }
 function buildPersonality(intent) {
   if (intent.personalityHints.length > 0) {
@@ -2464,8 +2586,7 @@ async function cmdMagic(prompt, projectRoot, options) {
       }
       const bpResult = await registryClient.fetchBlueprint(best.id);
       if (bpResult) {
-        const rawBp = bpResult.data;
-        blueprintData = rawBp.data ?? rawBp;
+        blueprintData = bpResult.data;
       }
     } else {
       console.log(dim("  No strong blueprint match found. Using archetype-based scaffold."));
@@ -2478,7 +2599,7 @@ async function cmdMagic(prompt, projectRoot, options) {
   const initOptions = {
     blueprint: matchedBlueprint,
     archetype: intent.archetype || blueprintData?.compose?.[0]?.archetype || blueprintData?.compose?.[0] || "dashboard-analytics",
-    theme: themeResolved.style,
+    theme: themeResolved.id,
     mode: themeResolved.mode,
     shape: "rounded",
     target: "react",
@@ -2490,7 +2611,7 @@ async function cmdMagic(prompt, projectRoot, options) {
     existing: false
   };
   if (blueprintData) {
-    if (blueprintData.theme?.id || blueprintData.theme?.style) initOptions.theme = blueprintData.theme.id || blueprintData.theme.style;
+    if (blueprintData.theme?.id) initOptions.theme = blueprintData.theme.id;
     if (blueprintData.theme?.mode) initOptions.mode = blueprintData.theme.mode;
     if (blueprintData.theme?.shape) initOptions.shape = blueprintData.theme.shape;
     if (blueprintData.personality) {
@@ -2541,8 +2662,7 @@ async function cmdMagic(prompt, projectRoot, options) {
       const id = typeof entry === "string" ? entry : entry.archetype;
       const result2 = await registryClient.fetchArchetype(id);
       if (result2) {
-        const raw = result2.data;
-        archetypeMap.set(id, raw.data ?? raw);
+        archetypeMap.set(id, mapRegistryArchetypeToArchetypeData(result2.data));
       } else {
         archetypeMap.set(id, null);
       }
@@ -2582,9 +2702,7 @@ async function cmdMagic(prompt, projectRoot, options) {
         if (page.patterns) {
           for (const ref of page.patterns) allPatternIds.add(ref.pattern);
         }
-        for (const item of page.layout) {
-          if (typeof item === "string") allPatternIds.add(item);
-        }
+        for (const patternId of collectPatternIdsFromItems(page.layout)) allPatternIds.add(patternId);
       }
     }
     patternSpecs = {};
@@ -2592,15 +2710,7 @@ async function cmdMagic(prompt, projectRoot, options) {
       try {
         const result2 = await registryClient.fetchPattern(pid);
         if (result2) {
-          const raw = result2.data;
-          const inner = raw.data ?? raw;
-          const defaultPreset = inner.default_preset || "standard";
-          const preset = inner.presets?.[defaultPreset];
-          patternSpecs[pid] = {
-            description: inner.description || "",
-            components: inner.components || [],
-            slots: preset?.layout?.slots || {}
-          };
+          patternSpecs[pid] = mapRegistryPatternToPatternSpecSummary(result2.data, void 0, false);
         }
       } catch {
       }
@@ -2610,7 +2720,7 @@ async function cmdMagic(prompt, projectRoot, options) {
       const arcId = typeof entry === "string" ? entry : entry.archetype;
       const archData = archetypeMap.get(arcId);
       if (archData) {
-        const explicitRole = typeof entry === "object" && "role" in entry ? entry.role : void 0;
+        const explicitRole = typeof entry === "string" ? void 0 : entry.role;
         zoneInputs.push({
           archetypeId: arcId,
           role: explicitRole || archData.role || "auxiliary",
@@ -2647,31 +2757,13 @@ async function cmdMagic(prompt, projectRoot, options) {
   } else if (intent.archetype && apiAvailable) {
     const archResult = await registryClient.fetchArchetype(initOptions.archetype);
     if (archResult) {
-      const raw = archResult.data;
-      archetypeData = raw.data ?? raw;
+      archetypeData = mapRegistryArchetypeToArchetypeData(archResult.data);
     }
   }
   if (apiAvailable && initOptions.theme) {
     const themeResult = await registryClient.fetchTheme(initOptions.theme);
     if (themeResult) {
-      const rawTheme = themeResult.data;
-      const theme = rawTheme.data ?? rawTheme;
-      themeData = {
-        seed: theme.seed,
-        palette: theme.palette,
-        tokens: theme.tokens,
-        cvd_support: theme.cvd_support,
-        typography: theme.typography,
-        motion: theme.motion,
-        decorators: theme.decorators,
-        treatments: theme.treatments,
-        spatial: theme.spatial,
-        radius: theme.radius,
-        shell: theme.shell,
-        effects: theme.effects,
-        compositions: theme.compositions,
-        pattern_preferences: theme.pattern_preferences
-      };
+      themeData = mapRegistryThemeToThemeData(themeResult.data);
     }
   }
   const richPersonality = buildRichPersonality(intent, blueprintData, themeData);
@@ -2733,14 +2825,18 @@ async function cmdMagic(prompt, projectRoot, options) {
   }
   console.log(`
 ${GREEN9}${BOLD4}Quality summary:${RESET9}`);
-  console.log(`  Context files:   ${sectionCount} sections + scaffold.md + DECANTR.md`);
+  console.log(`  Context files:   ${sectionCount} sections + page packs + section packs + scaffold-pack.md + scaffold.md + DECANTR.md`);
   console.log(`  CSS:             tokens.css + treatments.css + global.css`);
   console.log(`  @layer cascade:  ${hasLayers ? GREEN9 + "yes" + RESET9 : YELLOW6 + "missing" + RESET9}`);
   console.log("");
   console.log(`${BOLD4} Ready!${RESET9} Next steps:`);
-  console.log(`   1. Read ${cyan("DECANTR.md")} to understand the design system`);
-  console.log(`   2. Read ${cyan(".decantr/context/scaffold.md")} for the full app overview`);
-  console.log(`   3. Start building pages from the route map`);
+  console.log(`   1. Read ${cyan("DECANTR.md")} for guard rules, CSS approach, and workflow`);
+  console.log(`   2. Read ${cyan(".decantr/context/scaffold-pack.md")} first as the primary compiled contract`);
+  console.log(`   3. Read ${cyan(".decantr/context/scaffold.md")} second for broader topology and voice guidance`);
+  console.log(`   4. Read the matching ${cyan(".decantr/context/section-*-pack.md")} and ${cyan(".decantr/context/section-*.md")} files before section work`);
+  console.log(`   5. Read the matching ${cyan(".decantr/context/page-*-pack.md")} file before route work`);
+  console.log(`   6. Build the shell and route structure first, then implement each page`);
+  console.log(`   7. Run ${cyan("decantr check")} and ${cyan("decantr audit")} before you ship`);
   console.log("");
 }
 
@@ -2951,20 +3047,14 @@ function ensureDir(filePath) {
 // src/commands/registry-mirror.ts
 import { mkdirSync as mkdirSync6, writeFileSync as writeFileSync11 } from "fs";
 import { join as join21 } from "path";
-import { RegistryAPIClient as RegistryAPIClient2 } from "@decantr/registry";
+import { RegistryAPIClient as RegistryAPIClient2, API_CONTENT_TYPES } from "@decantr/registry";
 var GREEN11 = "\x1B[32m";
 var RED9 = "\x1B[31m";
 var DIM11 = "\x1B[2m";
 var CYAN5 = "\x1B[36m";
 var YELLOW7 = "\x1B[33m";
 var RESET11 = "\x1B[0m";
-var ALL_CONTENT_TYPES = [
-  "patterns",
-  "archetypes",
-  "themes",
-  "blueprints",
-  "shells"
-];
+var ALL_CONTENT_TYPES = [...API_CONTENT_TYPES];
 async function cmdRegistryMirror(projectRoot, options = {}) {
   const apiUrl = process.env.DECANTR_API_URL || "https://api.decantr.ai/v1";
   const apiClient = new RegistryAPIClient2({
@@ -3035,9 +3125,58 @@ Mirroring registry content to ${DIM11}.decantr/cache/${RESET11}
 }
 
 // src/commands/new-project.ts
-import { existsSync as existsSync22, mkdirSync as mkdirSync7, writeFileSync as writeFileSync12 } from "fs";
-import { join as join22, resolve } from "path";
+import { existsSync as existsSync23, mkdirSync as mkdirSync8, readFileSync as readFileSync15, writeFileSync as writeFileSync12 } from "fs";
+import { join as join23, resolve as resolve2 } from "path";
 import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+
+// src/offline-content.ts
+import { cpSync, existsSync as existsSync22, mkdirSync as mkdirSync7 } from "fs";
+import { join as join22, resolve } from "path";
+var CONTENT_TYPES2 = ["archetypes", "blueprints", "patterns", "themes", "shells"];
+function copyIfExists(source, target) {
+  if (!existsSync22(source)) return false;
+  if (resolve(source) === resolve(target)) return true;
+  cpSync(source, target, { recursive: true });
+  return true;
+}
+function hydrateContentRoot(projectDir, contentRoot) {
+  if (!existsSync22(contentRoot)) return false;
+  const customRoot = join22(projectDir, ".decantr", "custom");
+  const cacheRoot = join22(projectDir, ".decantr", "cache", "@official");
+  mkdirSync7(customRoot, { recursive: true });
+  mkdirSync7(cacheRoot, { recursive: true });
+  let copiedAny = false;
+  for (const type of CONTENT_TYPES2) {
+    const sourceDir = join22(contentRoot, type);
+    if (!existsSync22(sourceDir)) continue;
+    cpSync(sourceDir, join22(customRoot, type), { recursive: true });
+    cpSync(sourceDir, join22(cacheRoot, type), { recursive: true });
+    copiedAny = true;
+  }
+  return copiedAny;
+}
+function seedOfflineRegistry(projectDir, workspaceRoot) {
+  const projectDecantrRoot = join22(projectDir, ".decantr");
+  mkdirSync7(projectDecantrRoot, { recursive: true });
+  const copiedCache = copyIfExists(join22(workspaceRoot, ".decantr", "cache"), join22(projectDecantrRoot, "cache"));
+  const copiedCustom = copyIfExists(join22(workspaceRoot, ".decantr", "custom"), join22(projectDecantrRoot, "custom"));
+  if (copiedCache || copiedCustom) {
+    return { seeded: true, strategy: "workspace-cache" };
+  }
+  const configuredContentRoot = process.env.DECANTR_CONTENT_DIR ? resolve(process.env.DECANTR_CONTENT_DIR) : null;
+  const siblingContentRoot = resolve(workspaceRoot, "..", "decantr-content");
+  const contentRoot = configuredContentRoot && existsSync22(configuredContentRoot) ? configuredContentRoot : siblingContentRoot;
+  if (hydrateContentRoot(projectDir, contentRoot)) {
+    return {
+      seeded: true,
+      strategy: configuredContentRoot && existsSync22(configuredContentRoot) ? "configured-content-root" : "sibling-content-root"
+    };
+  }
+  return { seeded: false, strategy: null };
+}
+
+// src/commands/new-project.ts
 var BOLD5 = "\x1B[1m";
 var DIM12 = "\x1B[2m";
 var RESET12 = "\x1B[0m";
@@ -3062,20 +3201,92 @@ function dim2(text) {
 function cyan2(text) {
   return `${CYAN6}${text}${RESET12}`;
 }
+function detectRoutingMode(projectDir) {
+  try {
+    const essence = JSON.parse(readFileSync15(join23(projectDir, "decantr.essence.json"), "utf-8"));
+    const routing = essence.meta?.platform?.routing;
+    if (routing === "history" || routing === "pathname") {
+      return routing;
+    }
+    return "hash";
+  } catch {
+    return "hash";
+  }
+}
+function writeStarterRuntimeFiles(projectDir, title, routingMode) {
+  const srcDir = join23(projectDir, "src");
+  const routerImport = routingMode === "hash" ? "HashRouter" : "BrowserRouter";
+  const mainTsx = `import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import { ${routerImport} } from 'react-router-dom';
+import { App } from './App';
+import './styles/global.css';
+import './styles/tokens.css';
+import './styles/treatments.css';
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <${routerImport}>
+      <App />
+    </${routerImport}>
+  </StrictMode>,
+);
+`;
+  writeFileSync12(join23(srcDir, "main.tsx"), mainTsx);
+  const appTsx = `import { css } from '@decantr/css';
+import { Routes, Route } from 'react-router-dom';
+
+function WelcomePage() {
+  return (
+    <>
+      <a href="#main-content" className="skip-link">Skip to content</a>
+      <main id="main-content" className={css('_minh[100vh] _flex _col _aic _jcc _p6 _gap4')}>
+        <section className={css('_wfull _mw[42rem]') + ' d-section'} data-density="comfortable">
+          <div className={css('_flex _col _aic _gap4 _textc') + ' d-surface'} data-elevation="raised">
+            <p className="d-label" data-anchor>Decantr starter</p>
+            <h1 className={css('_heading2')}>${title}</h1>
+            <p className={css('_textsm _fgmuted _mw[32rem]')}>
+              Scaffolded with Decantr. Read DECANTR.md and the compiled packs in .decantr/context before building routes.
+            </p>
+            <div className={css('_flex _gap3 _wrap _jcc')}>
+              <span className="d-annotation" data-status="info">Runtime: @decantr/css</span>
+              <span className="d-annotation" data-status="success">Routing: ${routingMode}</span>
+            </div>
+          </div>
+        </section>
+      </main>
+    </>
+  );
+}
+
+export function App() {
+  return (
+    <Routes>
+      <Route path="/" element={<WelcomePage />} />
+    </Routes>
+  );
+}
+`;
+  writeFileSync12(join23(srcDir, "App.tsx"), appTsx);
+}
+function getTargetRoutingMode(target) {
+  return (target || "react").toLowerCase() === "nextjs" ? "pathname" : "hash";
+}
 async function cmdNewProject(projectName, options) {
-  const projectDir = resolve(process.cwd(), projectName);
+  const workspaceRoot = process.cwd();
+  const projectDir = resolve2(workspaceRoot, projectName);
   if (!/^[a-z0-9][a-z0-9._-]*$/i.test(projectName)) {
     console.error(error2("Invalid project name. Use alphanumeric characters, hyphens, dots, or underscores."));
     process.exitCode = 1;
     return;
   }
-  if (existsSync22(projectDir)) {
+  if (existsSync23(projectDir)) {
     console.error(error2(`Directory "${projectName}" already exists.`));
     process.exitCode = 1;
     return;
   }
   console.log(heading(`Creating ${projectName}...`));
-  mkdirSync7(projectDir, { recursive: true });
+  mkdirSync8(projectDir, { recursive: true });
   console.log(dim2(`  Created ${projectName}/`));
   const packageJson = {
     name: projectName,
@@ -3101,7 +3312,7 @@ async function cmdNewProject(projectName, options) {
       "vite": "^6.0.0"
     }
   };
-  writeFileSync12(join22(projectDir, "package.json"), JSON.stringify(packageJson, null, 2) + "\n");
+  writeFileSync12(join23(projectDir, "package.json"), JSON.stringify(packageJson, null, 2) + "\n");
   console.log(dim2("  Created package.json"));
   const viteConfig = `import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
@@ -3110,7 +3321,7 @@ export default defineConfig({
   plugins: [react()],
 });
 `;
-  writeFileSync12(join22(projectDir, "vite.config.ts"), viteConfig);
+  writeFileSync12(join23(projectDir, "vite.config.ts"), viteConfig);
   console.log(dim2("  Created vite.config.ts"));
   const tsconfig = {
     compilerOptions: {
@@ -3133,7 +3344,7 @@ export default defineConfig({
     },
     include: ["src"]
   };
-  writeFileSync12(join22(projectDir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2) + "\n");
+  writeFileSync12(join23(projectDir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2) + "\n");
   const tsconfigApp = {
     compilerOptions: {
       tsBuildInfoFile: "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
@@ -3156,7 +3367,7 @@ export default defineConfig({
     },
     include: ["src"]
   };
-  writeFileSync12(join22(projectDir, "tsconfig.app.json"), JSON.stringify(tsconfigApp, null, 2) + "\n");
+  writeFileSync12(join23(projectDir, "tsconfig.app.json"), JSON.stringify(tsconfigApp, null, 2) + "\n");
   console.log(dim2("  Created tsconfig.json"));
   const title = projectName.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
   const indexHtml = `<!doctype html>
@@ -3172,49 +3383,13 @@ export default defineConfig({
   </body>
 </html>
 `;
-  writeFileSync12(join22(projectDir, "index.html"), indexHtml);
+  writeFileSync12(join23(projectDir, "index.html"), indexHtml);
   console.log(dim2("  Created index.html"));
-  const srcDir = join22(projectDir, "src");
-  mkdirSync7(srcDir, { recursive: true });
-  const mainTsx = `import { StrictMode } from 'react';
-import { createRoot } from 'react-dom/client';
-import { BrowserRouter } from 'react-router-dom';
-import { App } from './App';
-import './styles/tokens.css';
-import './styles/treatments.css';
-import './styles/global.css';
-
-createRoot(document.getElementById('root')!).render(
-  <StrictMode>
-    <BrowserRouter>
-      <App />
-    </BrowserRouter>
-  </StrictMode>,
-);
-`;
-  writeFileSync12(join22(srcDir, "main.tsx"), mainTsx);
-  const appTsx = `import { Routes, Route } from 'react-router-dom';
-
-function WelcomePage() {
-  return (
-    <div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center', minHeight: '100vh', gap: '1rem' }}>
-      <h1>${title}</h1>
-      <p style={{ opacity: 0.6 }}>Scaffolded with Decantr. Run <code>decantr status</code> to check project health.</p>
-    </div>
-  );
-}
-
-export function App() {
-  return (
-    <Routes>
-      <Route path="/" element={<WelcomePage />} />
-    </Routes>
-  );
-}
-`;
-  writeFileSync12(join22(srcDir, "App.tsx"), appTsx);
-  writeFileSync12(join22(srcDir, "vite-env.d.ts"), '/// <reference types="vite/client" />\n');
-  mkdirSync7(join22(srcDir, "styles"), { recursive: true });
+  const srcDir = join23(projectDir, "src");
+  mkdirSync8(srcDir, { recursive: true });
+  writeStarterRuntimeFiles(projectDir, title, getTargetRoutingMode(options.target));
+  writeFileSync12(join23(srcDir, "vite-env.d.ts"), '/// <reference types="vite/client" />\n');
+  mkdirSync8(join23(srcDir, "styles"), { recursive: true });
   console.log(dim2("  Created src/"));
   console.log(heading("Installing dependencies..."));
   const packageManager = detectPackageManager();
@@ -3224,6 +3399,24 @@ export function App() {
     console.log(`
 ${YELLOW8}Dependency install failed. Run \`${packageManager} install\` manually.${RESET12}`);
   }
+  const requiresOfflineContent = Boolean(options.offline && (options.blueprint || options.archetype));
+  const seeded = options.offline ? seedOfflineRegistry(projectDir, workspaceRoot) : { seeded: false, strategy: null };
+  if (seeded.seeded) {
+    console.log(dim2(`  Seeded offline registry content from ${seeded.strategy}.`));
+  } else if (requiresOfflineContent) {
+    console.log(`${YELLOW8}  Offline blueprint/archetype resolution requires local registry content.${RESET12}`);
+    console.log(dim2("  No parent workspace cache/custom content or configured decantr-content source was found."));
+    console.log("");
+    console.log(success2(`
+\u2713 Project "${projectName}" created!
+`));
+    console.log(`  ${cyan2("cd " + projectName)}`);
+    console.log(`  ${cyan2(packageManager + " run dev")}`);
+    console.log(`  ${cyan2("decantr sync")}  ${dim2("# when online, then rerun decantr init")}`);
+    console.log(`  ${cyan2("DECANTR_CONTENT_DIR=/path/to/decantr-content decantr init --existing --offline")}  ${dim2("# or seed a local content source")}`);
+    console.log("");
+    return;
+  }
   console.log(heading("Initializing Decantr..."));
   const initFlags = ["--yes", "--existing"];
   if (options.blueprint) initFlags.push(`--blueprint=${options.blueprint}`);
@@ -3231,12 +3424,15 @@ ${YELLOW8}Dependency install failed. Run \`${packageManager} install\` manually.
   if (options.theme) initFlags.push(`--theme=${options.theme}`);
   if (options.mode) initFlags.push(`--mode=${options.mode}`);
   if (options.shape) initFlags.push(`--shape=${options.shape}`);
+  if (options.target) initFlags.push(`--target=${options.target}`);
   if (options.offline) initFlags.push("--offline");
   if (options.registry) initFlags.push(`--registry=${options.registry}`);
   try {
-    const cliBin = join22(__dirname, "..", "bin", "decantr.js");
-    const cliPath = existsSync22(cliBin) ? `node ${cliBin}` : "npx decantr";
+    const bundledCliEntrypoint = fileURLToPath(new URL("./bin.js", import.meta.url));
+    const cliEntrypoint = existsSync23(bundledCliEntrypoint) ? bundledCliEntrypoint : process.argv[1] && existsSync23(process.argv[1]) ? process.argv[1] : null;
+    const cliPath = cliEntrypoint ? `"${process.execPath}" "${cliEntrypoint}"` : "npx decantr";
     execSync(`${cliPath} init ${initFlags.join(" ")}`, { cwd: projectDir, stdio: "inherit" });
+    writeStarterRuntimeFiles(projectDir, title, detectRoutingMode(projectDir));
   } catch {
     console.log(`
 ${YELLOW8}Decantr init encountered issues. Run \`decantr init\` manually inside ${projectName}/.${RESET12}`);
@@ -3249,13 +3445,13 @@ ${YELLOW8}Decantr init encountered issues. Run \`decantr init\` manually inside
   console.log("");
 }
 function detectPackageManager() {
-  if (existsSync22(join22(process.cwd(), "pnpm-lock.yaml")) || existsSync22(join22(process.cwd(), "pnpm-workspace.yaml"))) {
+  if (existsSync23(join23(process.cwd(), "pnpm-lock.yaml")) || existsSync23(join23(process.cwd(), "pnpm-workspace.yaml"))) {
     return "pnpm";
   }
-  if (existsSync22(join22(process.cwd(), "yarn.lock"))) {
+  if (existsSync23(join23(process.cwd(), "yarn.lock"))) {
     return "yarn";
   }
-  if (existsSync22(join22(process.cwd(), "bun.lockb")) || existsSync22(join22(process.cwd(), "bun.lock"))) {
+  if (existsSync23(join23(process.cwd(), "bun.lockb")) || existsSync23(join23(process.cwd(), "bun.lock"))) {
     return "bun";
   }
   return "npm";
@@ -3286,6 +3482,64 @@ function dim3(text) {
 function cyan3(text) {
   return `${CYAN7}${text}${RESET13}`;
 }
+function formatIntelligenceSummary(intelligence) {
+  if (!intelligence) {
+    return null;
+  }
+  const parts = [];
+  const recommendationReasons = intelligence.recommendation_reasons ?? [];
+  const recommendationBlockers = intelligence.recommendation_blockers ?? [];
+  if (intelligence.recommended) {
+    parts.push("recommended");
+  }
+  switch (intelligence.source) {
+    case "authored":
+      parts.push("authored intelligence");
+      break;
+    case "hybrid":
+      parts.push("hybrid intelligence");
+      break;
+    case "benchmark":
+      parts.push("benchmark-backed");
+      break;
+    default:
+      break;
+  }
+  switch (intelligence.verification_status) {
+    case "smoke-green":
+      parts.push("smoke verified");
+      break;
+    case "build-green":
+      parts.push("build verified");
+      break;
+    case "smoke-red":
+      parts.push("smoke failed");
+      break;
+    case "build-red":
+      parts.push("build failed");
+      break;
+    default:
+      break;
+  }
+  if (intelligence.confidence_tier === "verified") {
+    parts.push("verified confidence");
+  } else if (intelligence.confidence_tier === "high") {
+    parts.push("high confidence");
+  } else if (intelligence.confidence_tier === "medium") {
+    parts.push("medium confidence");
+  } else if (intelligence.benchmark_confidence !== "none") {
+    parts.push(`${intelligence.benchmark_confidence} confidence`);
+  }
+  if (intelligence.quality_score != null) {
+    parts.push(`quality ${intelligence.quality_score}`);
+  }
+  if (intelligence.recommended && recommendationReasons.length > 0) {
+    parts.push(`because ${recommendationReasons[0]}`);
+  } else if (!intelligence.recommended && recommendationBlockers.length > 0) {
+    parts.push(`held back by ${recommendationBlockers[0]}`);
+  }
+  return parts.length > 0 ? parts.join(" | ") : null;
+}
 function extractPatternName(item) {
   if (typeof item === "string") return item;
   if (typeof item === "object" && item !== null) {
@@ -3301,12 +3555,30 @@ function generateCuratedPrompt(ctx) {
   const lines = [];
   lines.push("Build this application using the Decantr design system.");
   lines.push("");
-  lines.push("Read DECANTR.md for the design spec, CSS approach, and guard rules.");
-  lines.push("Read .decantr/context/scaffold.md for the app overview, topology, routes, and voice guidance.");
-  lines.push("Read each .decantr/context/section-*.md file before building that section's pages.");
-  lines.push("Import src/styles/global.css, src/styles/tokens.css, and src/styles/treatments.css.");
+  lines.push("Treat the compiled execution-pack files as the primary source of truth.");
+  lines.push("Use narrative docs only as secondary explanation when the compiled packs are not enough.");
+  lines.push("Use only files present in this workspace as the source of truth. If local scaffold files disagree, stop and report the mismatch instead of relying on external Decantr assumptions or prior examples.");
+  lines.push("");
+  lines.push("Read in this order:");
+  lines.push("1. DECANTR.md for the design spec, CSS approach, and guard rules.");
+  lines.push("2. .decantr/context/scaffold-pack.md for the compact compiled shell, theme, feature, and route contract.");
+  lines.push("3. .decantr/context/scaffold.md for the broader app overview, topology, route map, and voice guidance.");
+  lines.push("4. Before working on any section, read its matching .decantr/context/section-*-pack.md and then .decantr/context/section-*.md files.");
+  lines.push("5. Before working on any route/page, read its matching .decantr/context/page-*-pack.md file.");
   lines.push("");
-  lines.push("Start with the shell layouts, then build each section's pages.");
+  lines.push("Implementation rules:");
+  lines.push("- Do not invent routes, sections, shells, themes, or features that are not present in the compiled packs.");
+  lines.push("- Prefer scaffold-pack, section-pack, and page-pack guidance over broader narrative docs when they differ.");
+  lines.push("- Start with the shell layouts and route structure first, then build section pages route by route.");
+  lines.push("- Import src/styles/global.css, src/styles/tokens.css, and src/styles/treatments.css.");
+  lines.push("- Use the existing Decantr tokens, treatments, and decorators instead of inventing a new visual system.");
+  lines.push("- Do not modify generated context files unless the task is explicitly to regenerate or refresh Decantr context.");
+  lines.push("");
+  lines.push("Execution flow:");
+  lines.push("- Build the shell and shared layout first.");
+  lines.push("- Then implement each section's pages using the matching section and page packs.");
+  lines.push("- After implementation, run decantr check and decantr audit and fix any contract or drift issues.");
+  lines.push("- If a required context file is missing or inconsistent, stop and report exactly which file is missing before continuing.");
   return lines.join("\n");
 }
 function getAPIClient() {
@@ -3315,10 +3587,448 @@ function getAPIClient() {
     apiKey: process.env.DECANTR_API_KEY || void 0
   });
 }
-async function cmdSearch(query, type) {
+function getPublicAPIClient() {
+  return new RegistryAPIClient3({
+    baseUrl: process.env.DECANTR_API_URL || void 0
+  });
+}
+function resolveUserPath(inputPath, cwd = process.cwd()) {
+  return isAbsolute(inputPath) ? inputPath : resolve3(cwd, inputPath);
+}
+function extractHostedAssetPaths(indexHtml) {
+  const assetPaths = /* @__PURE__ */ new Set();
+  for (const match of indexHtml.matchAll(/<(?:script|link)[^>]+(?:src|href)="([^"]+)"/g)) {
+    const assetPath = match[1];
+    const assetsIndex = assetPath.indexOf("/assets/");
+    if (assetsIndex === -1) continue;
+    assetPaths.add(assetPath.slice(assetsIndex));
+  }
+  return [...assetPaths];
+}
+function readHostedDistSnapshot(distPath) {
+  const resolvedDistPath = distPath ? resolveUserPath(distPath) : join24(process.cwd(), "dist");
+  const indexPath = join24(resolvedDistPath, "index.html");
+  if (!existsSync24(indexPath)) {
+    return void 0;
+  }
+  const indexHtml = readFileSync16(indexPath, "utf-8");
+  const assetPaths = extractHostedAssetPaths(indexHtml);
+  const assets = {};
+  for (const assetPath of assetPaths) {
+    const assetFilePath = join24(resolvedDistPath, assetPath.replace(/^[/\\]+/, ""));
+    if (existsSync24(assetFilePath)) {
+      assets[assetPath] = readFileSync16(assetFilePath, "utf-8");
+    }
+  }
+  return {
+    indexHtml,
+    assets
+  };
+}
+function isHostedSourceSnapshotFile(path) {
+  if (/\.d\.ts$/i.test(path)) return false;
+  return /\.(?:[cm]?[jt]sx?)$/i.test(path);
+}
+function readHostedSourceSnapshot(sourcePath) {
+  if (!sourcePath) return void 0;
+  const resolvedSourcePath = resolveUserPath(sourcePath);
+  if (!existsSync24(resolvedSourcePath)) {
+    return void 0;
+  }
+  const files = {};
+  const ignoredDirNames = /* @__PURE__ */ new Set(["node_modules", ".git", ".decantr", "dist", "build", "coverage"]);
+  const rootPrefix = basename(resolvedSourcePath);
+  const walk = (absoluteDir, relativeDir) => {
+    for (const entry of readdirSync6(absoluteDir, { withFileTypes: true })) {
+      if (ignoredDirNames.has(entry.name)) continue;
+      const absolutePath = join24(absoluteDir, entry.name);
+      const relativePath = join24(relativeDir, entry.name).replace(/\\/g, "/");
+      if (entry.isDirectory()) {
+        walk(absolutePath, relativePath);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      if (!isHostedSourceSnapshotFile(relativePath)) continue;
+      files[relativePath] = readFileSync16(absolutePath, "utf-8");
+    }
+  };
+  walk(resolvedSourcePath, rootPrefix);
+  return Object.keys(files).length > 0 ? { files } : void 0;
+}
+async function getShowcaseBenchmarkView(view = "shortlist") {
+  const client = getPublicAPIClient();
+  if (view === "manifest") {
+    return client.getShowcaseManifest();
+  }
+  if (view === "verification") {
+    return client.getShowcaseShortlistVerification();
+  }
+  return client.getShowcaseShortlist();
+}
+async function printShowcaseBenchmarks(view, jsonOutput) {
+  const fmtBytes = (bytes) => bytes >= 1e6 ? `${(bytes / 1e6).toFixed(2)} MB` : `${Math.round(bytes / 1e3)} KB`;
+  const data = await getShowcaseBenchmarkView(view);
+  if (jsonOutput) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  if (view === "manifest") {
+    const manifest = data;
+    console.log(heading2("Showcase Corpus"));
+    console.log(`  Active apps: ${manifest.total}`);
+    console.log(`  Shortlisted apps: ${manifest.shortlisted}`);
+    console.log("");
+    for (const entry of manifest.apps) {
+      const verification = entry.verification;
+      const verificationSummary = verification ? ` | ${verification.verificationStatus} | drift ${verification.drift.signal}` : "";
+      console.log(`  ${cyan3(entry.slug)}  class ${entry.classification}${verificationSummary}`);
+    }
+    return;
+  }
+  if (view === "verification") {
+    const report = data;
+    console.log(heading2("Showcase Verification"));
+    if (report.generatedAt) {
+      console.log(`  Generated: ${report.generatedAt}`);
+    }
+    if (report.summary) {
+      console.log(`  Passed builds: ${report.summary.passedBuilds}/${report.summary.appCount}`);
+      console.log(`  Avg build: ${report.summary.averageDurationMs} ms`);
+      console.log(`  Passed smokes: ${report.summary.passedSmokes}/${report.summary.appCount}`);
+      console.log(`  Avg smoke: ${report.summary.averageSmokeDurationMs} ms`);
+      console.log(`  Title checks: ${report.summary.appsWithTitleOkCount}/${report.summary.appCount}`);
+      console.log(`  Lang checks: ${report.summary.appsWithLangOkCount}/${report.summary.appCount}`);
+      console.log(`  Viewport checks: ${report.summary.appsWithViewportOkCount}/${report.summary.appCount}`);
+      console.log(`  Charset checks: ${report.summary.appsWithCharsetOkCount}/${report.summary.appCount}`);
+      console.log(`  No inline scripts: ${report.summary.appsWithoutInlineScriptsCount}/${report.summary.appCount}`);
+      console.log(`  CSP signals: ${report.summary.appsWithCspSignalCount}/${report.summary.appCount}`);
+      console.log(`  External script integrity ok: ${report.summary.appsWithExternalScriptIntegrityCount}/${report.summary.appCount}`);
+      console.log(`  External stylesheet integrity ok: ${report.summary.appsWithExternalStylesheetIntegrityCount}/${report.summary.appCount}`);
+      console.log(`  Route coverage: ${report.summary.appsWithRouteCoverageCount}/${report.summary.appCount}`);
+      console.log(`  Full route coverage: ${report.summary.appsWithFullRouteCoverageCount}/${report.summary.appCount}`);
+      console.log(`  Avg assets: total ${fmtBytes(report.summary.averageTotalAssetBytes)} | js ${fmtBytes(report.summary.averageJsAssetBytes)} | css ${fmtBytes(report.summary.averageCssAssetBytes)}`);
+      console.log(`  Drift: lower ${report.summary.lowerDriftCount}, moderate ${report.summary.moderateDriftCount}, elevated ${report.summary.elevatedDriftCount}`);
+      console.log(`  Pack manifests: ${report.summary.withPackManifestCount}/${report.summary.appCount}`);
+      console.log("");
+    }
+    for (const entry of report.results) {
+      console.log(`  ${cyan3(entry.slug)}  ${entry.verificationStatus} | smoke ${entry.smoke.passed ? "green" : entry.build.passed ? "red" : "pending"} | routes ${entry.smoke.routeDocumentsPassed}/${entry.smoke.routeDocumentsChecked}${entry.smoke.fullRouteCoverageOk ? " full" : " partial"} | js ${fmtBytes(entry.smoke.jsAssetBytes)} | drift ${entry.drift.signal} | build ${entry.build.durationMs} ms | smoke ${entry.smoke.durationMs} ms`);
+    }
+    return;
+  }
+  const shortlist = data;
+  console.log(heading2("Showcase Shortlist"));
+  if (shortlist.generatedAt) {
+    console.log(`  Generated: ${shortlist.generatedAt}`);
+  }
+  if (shortlist.summary) {
+    console.log(`  Passed builds: ${shortlist.summary.passedBuilds}/${shortlist.summary.appCount}`);
+    console.log(`  Passed smokes: ${shortlist.summary.passedSmokes}/${shortlist.summary.appCount}`);
+    console.log(`  Route coverage: ${shortlist.summary.appsWithRouteCoverageCount}/${shortlist.summary.appCount}`);
+    console.log(`  Full route coverage: ${shortlist.summary.appsWithFullRouteCoverageCount}/${shortlist.summary.appCount}`);
+    console.log(`  Drift mix: lower ${shortlist.summary.lowerDriftCount}, moderate ${shortlist.summary.moderateDriftCount}, elevated ${shortlist.summary.elevatedDriftCount}`);
+    console.log("");
+  }
+  for (const entry of shortlist.apps) {
+    const verification = entry.verification;
+    const verificationSummary = verification ? `${verification.verificationStatus} | smoke ${verification.smoke.passed ? "green" : verification.build.passed ? "red" : "pending"} | drift ${verification.drift.signal}` : "verification pending";
+    console.log(`  ${cyan3(entry.slug)}  class ${entry.classification} | ${verificationSummary}`);
+  }
+}
+async function printRegistryIntelligenceSummary(namespace, jsonOutput = false) {
+  const client = getPublicAPIClient();
+  const summary = await client.getRegistryIntelligenceSummary(
+    namespace ? { namespace } : void 0
+  );
+  if (jsonOutput) {
+    console.log(JSON.stringify(summary, null, 2));
+    return;
+  }
+  const typedSummary = summary;
+  console.log(heading2("Registry Intelligence Summary"));
+  console.log(`  Namespace: ${typedSummary.namespace ?? "all public content"}`);
+  console.log(`  Generated: ${typedSummary.generated_at}`);
+  console.log(`  Public items: ${typedSummary.totals.total_public_items}`);
+  console.log(`  With intelligence: ${typedSummary.totals.with_intelligence}`);
+  console.log(`  Recommended: ${typedSummary.totals.recommended}`);
+  console.log(
+    `  Sources: authored ${typedSummary.totals.authored}, benchmark ${typedSummary.totals.benchmark}, hybrid ${typedSummary.totals.hybrid}, missing ${typedSummary.totals.missing_source}`
+  );
+  console.log(
+    `  Verification: smoke green ${typedSummary.totals.smoke_green}, build green ${typedSummary.totals.build_green}, high confidence ${typedSummary.totals.high_confidence}, verified ${typedSummary.totals.verified_confidence}`
+  );
+  console.log("");
+  for (const [type, bucket] of Object.entries(typedSummary.by_type)) {
+    console.log(
+      `  ${cyan3(type.padEnd(10))} total ${bucket.total_public_items} | intelligence ${bucket.with_intelligence} | recommended ${bucket.recommended} | authored ${bucket.authored} | benchmark ${bucket.benchmark} | hybrid ${bucket.hybrid}`
+    );
+  }
+}
+async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput = false, writeContext = false) {
+  const client = getPublicAPIClient();
+  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join24(process.cwd(), "decantr.essence.json");
+  if (!existsSync24(resolvedPath)) {
+    throw new Error(`Essence file not found at ${resolvedPath}`);
+  }
+  const essence = JSON.parse(readFileSync16(resolvedPath, "utf-8"));
+  const bundle = await client.compileExecutionPacks(
+    essence,
+    namespace ? { namespace } : void 0
+  );
+  let writtenContextPaths = [];
+  if (writeContext) {
+    const contextDir = join24(process.cwd(), ".decantr", "context");
+    mkdirSync9(contextDir, { recursive: true });
+    const written = writeExecutionPackBundleArtifacts(
+      contextDir,
+      bundle
+    );
+    writtenContextPaths = written.paths;
+  }
+  if (jsonOutput) {
+    console.log(JSON.stringify(bundle, null, 2));
+    return;
+  }
+  const typedBundle = bundle;
+  console.log(heading2("Hosted Execution Packs"));
+  console.log(`  Source essence: ${resolvedPath}`);
+  console.log(`  Essence version: ${typedBundle.sourceEssenceVersion}`);
+  console.log(`  Generated: ${typedBundle.generatedAt}`);
+  console.log(`  Adapter: ${typedBundle.scaffold.target.adapter}`);
+  console.log(`  Shell: ${typedBundle.scaffold.data.shell}`);
+  console.log(`  Theme: ${typedBundle.scaffold.data.theme.id} (${typedBundle.scaffold.data.theme.mode})`);
+  console.log(`  Pages: ${typedBundle.pages.length}`);
+  console.log(`  Sections: ${typedBundle.sections.length}`);
+  console.log(`  Mutations: ${typedBundle.mutations.length}`);
+  if (writeContext) {
+    console.log(`  Context bundle: ${join24(process.cwd(), ".decantr", "context")}`);
+    console.log(`  Files written: ${writtenContextPaths.length}`);
+  }
+  console.log("");
+  console.log(`${BOLD6}Route Plan:${RESET13}`);
+  for (const route of typedBundle.scaffold.data.routes) {
+    const patterns = route.patternIds.length > 0 ? route.patternIds.join(", ") : "none";
+    console.log(`  ${cyan3(route.path)} -> ${route.pageId} [${patterns}]`);
+  }
+}
+async function printHostedSelectedExecutionPack(packType, id, essencePath, namespace, jsonOutput = false, writeContext = false) {
+  const client = getPublicAPIClient();
+  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join24(process.cwd(), "decantr.essence.json");
+  if (!existsSync24(resolvedPath)) {
+    throw new Error(`Essence file not found at ${resolvedPath}`);
+  }
+  if ((packType === "section" || packType === "page" || packType === "mutation") && !id) {
+    throw new Error(`Pack type "${packType}" requires an id.`);
+  }
+  const essence = JSON.parse(readFileSync16(resolvedPath, "utf-8"));
+  const selected = await client.selectExecutionPack(
+    {
+      essence,
+      pack_type: packType,
+      ...id ? { id } : {}
+    },
+    namespace ? { namespace } : void 0
+  );
+  let writtenContextDir = null;
+  if (writeContext) {
+    const contextDir = join24(process.cwd(), ".decantr", "context");
+    mkdirSync9(contextDir, { recursive: true });
+    writeFileSync13(join24(contextDir, "pack-manifest.json"), JSON.stringify(selected.manifest, null, 2) + "\n");
+    const manifestEntry = selected.selector.packType === "scaffold" ? selected.manifest.scaffold : selected.selector.packType === "review" ? selected.manifest.review : selected.selector.packType === "section" ? selected.manifest.sections.find((entry) => entry.id === selected.selector.id) : selected.selector.packType === "page" ? selected.manifest.pages.find((entry) => entry.id === selected.selector.id) : selected.manifest.mutations.find((entry) => entry.id === selected.selector.id);
+    const markdownFile = manifestEntry?.markdown ?? `${selected.selector.packType}${selected.selector.id ? `-${selected.selector.id}` : ""}-pack.md`;
+    const jsonFile = manifestEntry?.json ?? `${selected.selector.packType}${selected.selector.id ? `-${selected.selector.id}` : ""}-pack.json`;
+    writeFileSync13(join24(contextDir, markdownFile), selected.pack.renderedMarkdown);
+    writeFileSync13(join24(contextDir, jsonFile), JSON.stringify(selected.pack, null, 2) + "\n");
+    writtenContextDir = contextDir;
+  }
+  if (jsonOutput) {
+    console.log(JSON.stringify(selected, null, 2));
+    return;
+  }
+  const typedSelected = selected;
+  console.log(heading2("Hosted Execution Pack"));
+  console.log(`  Source essence: ${resolvedPath}`);
+  console.log(`  Generated: ${typedSelected.generatedAt}`);
+  console.log(`  Pack type: ${typedSelected.selector.packType}`);
+  if (typedSelected.selector.id) {
+    console.log(`  Pack id: ${typedSelected.selector.id}`);
+  }
+  console.log(`  Adapter: ${typedSelected.pack.target.adapter}`);
+  console.log(`  Objective: ${typedSelected.pack.objective}`);
+  if (writtenContextDir) {
+    console.log(`  Context artifact: ${writtenContextDir}`);
+  }
+  console.log("");
+  process.stdout.write(typedSelected.pack.renderedMarkdown);
+}
+async function printHostedExecutionPackManifest(essencePath, namespace, jsonOutput = false, writeContext = false) {
+  const client = getPublicAPIClient();
+  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join24(process.cwd(), "decantr.essence.json");
+  if (!existsSync24(resolvedPath)) {
+    throw new Error(`Essence file not found at ${resolvedPath}`);
+  }
+  const essence = JSON.parse(readFileSync16(resolvedPath, "utf-8"));
+  const manifest = await client.getExecutionPackManifest(
+    essence,
+    namespace ? { namespace } : void 0
+  );
+  let writtenContextDir = null;
+  if (writeContext) {
+    const contextDir = join24(process.cwd(), ".decantr", "context");
+    mkdirSync9(contextDir, { recursive: true });
+    writeFileSync13(join24(contextDir, "pack-manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
+    writtenContextDir = contextDir;
+  }
+  if (jsonOutput) {
+    console.log(JSON.stringify(manifest, null, 2));
+    return;
+  }
+  console.log(heading2("Hosted Pack Manifest"));
+  console.log(`  Source essence: ${resolvedPath}`);
+  console.log(`  Generated: ${manifest.generatedAt}`);
+  console.log(`  Version: ${manifest.version}`);
+  console.log(`  Scaffold: ${manifest.scaffold ? "present" : "missing"}`);
+  console.log(`  Review: ${manifest.review ? "present" : "missing"}`);
+  console.log(`  Sections: ${manifest.sections.length}`);
+  console.log(`  Pages: ${manifest.pages.length}`);
+  console.log(`  Mutations: ${manifest.mutations.length}`);
+  if (writtenContextDir) {
+    console.log(`  Context artifact: ${writtenContextDir}`);
+  }
+}
+async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@official") {
+  const contextDir = join24(projectRoot, ".decantr", "context");
+  const reviewPackPath = join24(contextDir, "review-pack.json");
+  const manifestPath = join24(contextDir, "pack-manifest.json");
+  if (existsSync24(reviewPackPath) && existsSync24(manifestPath)) {
+    return { attempted: false, hydrated: false };
+  }
+  const essencePath = join24(projectRoot, "decantr.essence.json");
+  if (!existsSync24(essencePath)) {
+    return { attempted: false, hydrated: false };
+  }
+  const reviewHydration = await hydrateHostedReviewPackIfMissing(projectRoot, namespace);
+  if (reviewHydration.hydrated || !reviewHydration.attempted) {
+    return reviewHydration;
+  }
+  try {
+    const client = getPublicAPIClient();
+    const essence = JSON.parse(readFileSync16(essencePath, "utf-8"));
+    const bundle = await client.compileExecutionPacks(essence, { namespace });
+    mkdirSync9(contextDir, { recursive: true });
+    writeExecutionPackBundleArtifacts(
+      contextDir,
+      bundle
+    );
+    return { attempted: true, hydrated: true, scope: "bundle" };
+  } catch {
+    return { attempted: true, hydrated: false };
+  }
+}
+async function hydrateHostedReviewPackIfMissing(projectRoot, namespace = "@official") {
+  const contextDir = join24(projectRoot, ".decantr", "context");
+  const reviewPackPath = join24(contextDir, "review-pack.json");
+  const manifestPath = join24(contextDir, "pack-manifest.json");
+  if (existsSync24(reviewPackPath) && existsSync24(manifestPath)) {
+    return { attempted: false, hydrated: false };
+  }
+  const essencePath = join24(projectRoot, "decantr.essence.json");
+  if (!existsSync24(essencePath)) {
+    return { attempted: false, hydrated: false };
+  }
+  try {
+    const client = getPublicAPIClient();
+    const essence = JSON.parse(readFileSync16(essencePath, "utf-8"));
+    const selected = await client.selectExecutionPack(
+      {
+        essence,
+        pack_type: "review"
+      },
+      { namespace }
+    );
+    mkdirSync9(contextDir, { recursive: true });
+    writeFileSync13(join24(contextDir, "review-pack.md"), selected.pack.renderedMarkdown);
+    writeFileSync13(join24(contextDir, "review-pack.json"), JSON.stringify(selected.pack, null, 2) + "\n");
+    if (!existsSync24(manifestPath)) {
+      writeFileSync13(manifestPath, JSON.stringify(selected.manifest, null, 2) + "\n");
+    }
+    return { attempted: true, hydrated: true, scope: "review" };
+  } catch {
+    return { attempted: true, hydrated: false };
+  }
+}
+async function printHostedFileCritique(sourcePath, namespace, jsonOutput = false, essencePath, treatmentsPath) {
+  const client = getPublicAPIClient();
+  const resolvedSourcePath = resolveUserPath(sourcePath);
+  const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join24(process.cwd(), "decantr.essence.json");
+  const resolvedTreatmentsPath = treatmentsPath ? resolveUserPath(treatmentsPath) : join24(process.cwd(), "src", "styles", "treatments.css");
+  if (!existsSync24(resolvedSourcePath)) {
+    throw new Error(`Source file not found at ${resolvedSourcePath}`);
+  }
+  if (!existsSync24(resolvedEssencePath)) {
+    throw new Error(`Essence file not found at ${resolvedEssencePath}`);
+  }
+  const code = readFileSync16(resolvedSourcePath, "utf-8");
+  const essence = JSON.parse(readFileSync16(resolvedEssencePath, "utf-8"));
+  const treatmentsCss = existsSync24(resolvedTreatmentsPath) ? readFileSync16(resolvedTreatmentsPath, "utf-8") : void 0;
+  const report = await client.critiqueFile(
+    {
+      essence,
+      filePath: sourcePath,
+      code,
+      treatmentsCss
+    },
+    namespace ? { namespace } : void 0
+  );
+  if (jsonOutput) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  console.log(heading2("Hosted File Critique"));
+  console.log(`  Source file: ${resolvedSourcePath}`);
+  console.log(`  Essence: ${resolvedEssencePath}`);
+  if (treatmentsCss) {
+    console.log(`  Treatments: ${resolvedTreatmentsPath}`);
+  }
+  printFileCritiqueReport(report);
+}
+async function printHostedProjectAudit(namespace, jsonOutput = false, essencePath, distPath, sourcesPath) {
+  const client = getPublicAPIClient();
+  const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join24(process.cwd(), "decantr.essence.json");
+  if (!existsSync24(resolvedEssencePath)) {
+    throw new Error(`Essence file not found at ${resolvedEssencePath}`);
+  }
+  const essence = JSON.parse(readFileSync16(resolvedEssencePath, "utf-8"));
+  const dist = readHostedDistSnapshot(distPath);
+  const sources = readHostedSourceSnapshot(sourcesPath);
+  const report = await client.auditProject(
+    {
+      essence,
+      dist,
+      sources
+    },
+    namespace ? { namespace } : void 0
+  );
+  if (jsonOutput) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  console.log(heading2("Hosted Project Audit"));
+  console.log(`  Essence: ${resolvedEssencePath}`);
+  console.log(`  Dist snapshot: ${dist ? distPath ? resolveUserPath(distPath) : join24(process.cwd(), "dist") : "none"}`);
+  console.log(`  Source snapshot: ${sources && sourcesPath ? resolveUserPath(sourcesPath) : "none"}`);
+  printProjectAuditReport(report);
+}
+async function cmdSearch(query, type, sort, recommended, intelligenceSource) {
   const apiClient = getAPIClient();
   try {
-    const response = await apiClient.search({ q: query, type });
+    const response = await apiClient.search({
+      q: query,
+      type,
+      sort,
+      recommended,
+      intelligenceSource
+    });
     const results = response.results;
     if (results.length === 0) {
       console.log(dim3(`No results for "${query}"`));
@@ -3328,6 +4038,10 @@ async function cmdSearch(query, type) {
     for (const r of results) {
       console.log(`  ${cyan3(r.type.padEnd(12))} ${BOLD6}${r.slug}${RESET13}`);
       console.log(`  ${dim3(r.description || "")}`);
+      const intelligenceSummary = formatIntelligenceSummary(r.intelligence);
+      if (intelligenceSummary) {
+        console.log(`  ${dim3(intelligenceSummary)}`);
+      }
       console.log("");
     }
   } catch {
@@ -3372,40 +4086,32 @@ async function cmdSuggest(query, type) {
   }
 }
 async function cmdGet(type, id) {
-  const validTypes = ["pattern", "archetype", "theme", "blueprint", "shell"];
-  if (!validTypes.includes(type)) {
-    console.error(error3(`Invalid type "${type}". Must be one of: ${validTypes.join(", ")}`));
+  if (!isGetContentType(type)) {
+    console.error(error3(`Invalid type "${type}". Must be one of: ${GET_CONTENT_TYPES.join(", ")}`));
     process.exitCode = 1;
     return;
   }
-  const typeMap = {
-    pattern: "patterns",
-    archetype: "archetypes",
-    theme: "themes",
-    blueprint: "blueprints",
-    shell: "shells"
-  };
-  const apiType = typeMap[type];
+  const apiType = CONTENT_TYPE_TO_API_CONTENT_TYPE3[type];
   const registryClient = new RegistryClient({
-    cacheDir: join23(process.cwd(), ".decantr", "cache")
+    cacheDir: join24(process.cwd(), ".decantr", "cache")
   });
   const result = await registryClient.fetchContentItem(apiType, id);
   if (result) {
     console.log(JSON.stringify(result.data, null, 2));
     return;
   }
-  const currentDir = dirname2(fileURLToPath(import.meta.url));
+  const currentDir = dirname2(fileURLToPath2(import.meta.url));
   const bundledCandidates = [
-    join23(currentDir, "bundled", apiType, `${id}.json`),
+    join24(currentDir, "bundled", apiType, `${id}.json`),
     // Running from src/
-    join23(currentDir, "..", "src", "bundled", apiType, `${id}.json`),
+    join24(currentDir, "..", "src", "bundled", apiType, `${id}.json`),
     // Running from dist/
-    join23(currentDir, "..", "bundled", apiType, `${id}.json`)
+    join24(currentDir, "..", "bundled", apiType, `${id}.json`)
     // Alternative dist layout
   ];
-  const bundledPath = bundledCandidates.find((p) => existsSync23(p)) || null;
+  const bundledPath = bundledCandidates.find((p) => existsSync24(p)) || null;
   if (bundledPath) {
-    const data = JSON.parse(readFileSync15(bundledPath, "utf-8"));
+    const data = JSON.parse(readFileSync16(bundledPath, "utf-8"));
     console.log(JSON.stringify(data, null, 2));
     return;
   }
@@ -3413,55 +4119,11 @@ async function cmdGet(type, id) {
   process.exitCode = 1;
   return;
 }
-function buildRegistryContext() {
-  const themeRegistry = /* @__PURE__ */ new Map();
-  const patternRegistry = /* @__PURE__ */ new Map();
-  const projectRoot = process.cwd();
-  const cacheDir = join23(projectRoot, ".decantr", "cache");
-  const customDir = join23(projectRoot, ".decantr", "custom");
-  const cachedThemesDir = join23(cacheDir, "@official", "themes");
-  try {
-    if (existsSync23(cachedThemesDir)) {
-      for (const f of readdirSync6(cachedThemesDir).filter((f2) => f2.endsWith(".json") && f2 !== "index.json")) {
-        const data = JSON.parse(readFileSync15(join23(cachedThemesDir, f), "utf-8"));
-        if (data.id && !themeRegistry.has(data.id)) {
-          themeRegistry.set(data.id, { modes: data.modes || ["light", "dark"] });
-        }
-      }
-    }
-  } catch {
-  }
-  const customThemesDir = join23(customDir, "themes");
-  try {
-    if (existsSync23(customThemesDir)) {
-      for (const f of readdirSync6(customThemesDir).filter((f2) => f2.endsWith(".json"))) {
-        const data = JSON.parse(readFileSync15(join23(customThemesDir, f), "utf-8"));
-        if (data.id) {
-          themeRegistry.set(`custom:${data.id}`, { modes: data.modes || ["light", "dark"] });
-        }
-      }
-    }
-  } catch {
-  }
-  const cachedPatternsDir = join23(cacheDir, "@official", "patterns");
-  try {
-    if (existsSync23(cachedPatternsDir)) {
-      for (const f of readdirSync6(cachedPatternsDir).filter((f2) => f2.endsWith(".json") && f2 !== "index.json")) {
-        const data = JSON.parse(readFileSync15(join23(cachedPatternsDir, f), "utf-8"));
-        if (data.id && !patternRegistry.has(data.id)) {
-          patternRegistry.set(data.id, data);
-        }
-      }
-    }
-  } catch {
-  }
-  return { themeRegistry, patternRegistry };
-}
 async function cmdValidate(path) {
-  const essencePath = path || join23(process.cwd(), "decantr.essence.json");
+  const essencePath = path || join24(process.cwd(), "decantr.essence.json");
   let raw;
   try {
-    raw = readFileSync15(essencePath, "utf-8");
+    raw = readFileSync16(essencePath, "utf-8");
   } catch {
     console.error(error3(`Could not read ${essencePath}`));
     process.exitCode = 1;
@@ -3491,7 +4153,7 @@ async function cmdValidate(path) {
     console.log(`${YELLOW9}Tip: Run \`decantr migrate\` to upgrade to v3 format.${RESET13}`);
   }
   try {
-    const { themeRegistry, patternRegistry } = buildRegistryContext();
+    const { themeRegistry, patternRegistry } = buildGuardRegistryContext(process.cwd());
     const violations = evaluateGuard(essence, { themeRegistry, patternRegistry });
     if (violations.length > 0) {
       console.log(heading2("Guard violations:"));
@@ -3508,17 +4170,22 @@ async function cmdValidate(path) {
   } catch {
   }
 }
-async function cmdList(type) {
-  const validTypes = ["patterns", "archetypes", "themes", "blueprints", "shells"];
-  if (!validTypes.includes(type)) {
-    console.error(error3(`Invalid type "${type}". Must be one of: ${validTypes.join(", ")}`));
+async function cmdList(type, sort, recommended, intelligenceSource) {
+  if (!isApiContentType(type)) {
+    console.error(error3(`Invalid type "${type}". Must be one of: ${LIST_CONTENT_TYPES.join(", ")}`));
     process.exitCode = 1;
     return;
   }
   const registryClient = new RegistryClient({
-    cacheDir: join23(process.cwd(), ".decantr", "cache")
+    cacheDir: join24(process.cwd(), ".decantr", "cache")
   });
-  const result = await registryClient.fetchContentList(type);
+  const result = await registryClient.fetchContentList(
+    type,
+    void 0,
+    sort,
+    recommended,
+    intelligenceSource
+  );
   const items = result.data.items;
   if (items.length === 0) {
     console.log(dim3(`No ${type} found.`));
@@ -3547,6 +4214,12 @@ async function cmdList(type) {
     console.log(heading2(`${items.length} ${type} found`));
     for (const item of items) {
       console.log(`  ${cyan3(item.id)}  ${dim3(item.description || item.name || "")}`);
+      const intelligenceSummary = formatIntelligenceSummary(
+        item.intelligence
+      );
+      if (intelligenceSummary) {
+        console.log(`  ${dim3(intelligenceSummary)}`);
+      }
     }
   }
 }
@@ -3562,12 +4235,34 @@ async function cmdInit(args) {
       return;
     }
   }
+  const requestedBlueprint = Boolean(args.blueprint);
+  const requestedArchetype = Boolean(args.archetype);
+  const requestedTheme = Boolean(args.theme);
+  let offlineSeed = { seeded: false, strategy: null };
+  if (args.offline) {
+    offlineSeed = seedOfflineRegistry(projectRoot, projectRoot);
+    if (offlineSeed.seeded) {
+      console.log(dim3(`  Seeded offline registry content from ${offlineSeed.strategy}.`));
+    } else if (requestedBlueprint || requestedArchetype) {
+      console.log(error3("\nOffline blueprint/archetype scaffolding requires a local Decantr content source."));
+      console.log(dim3("Set DECANTR_CONTENT_DIR, seed .decantr/cache or .decantr/custom, or run without --offline."));
+      process.exitCode = 1;
+      return;
+    }
+  }
   const registryClient = new RegistryClient({
-    cacheDir: join23(projectRoot, ".decantr", "cache"),
+    cacheDir: join24(projectRoot, ".decantr", "cache"),
     apiUrl: args.registry,
     offline: args.offline
   });
   const apiAvailable = await registryClient.checkApiAvailability();
+  if (!apiAvailable && !args.offline && (requestedBlueprint || requestedArchetype)) {
+    const fallbackSeed = seedOfflineRegistry(projectRoot, projectRoot);
+    if (fallbackSeed.seeded) {
+      offlineSeed = fallbackSeed;
+      console.log(dim3(`  Seeded local registry fallback from ${fallbackSeed.strategy}.`));
+    }
+  }
   let selectedBlueprint = "default";
   let registrySource = "cache";
   if (args.yes) {
@@ -3589,8 +4284,15 @@ ${YELLOW9}You're offline. Scaffolding minimal Decantr project.${RESET13}`);
       console.log("");
       console.log("  Next steps:");
       console.log(`    1. Run ${cyan3("decantr sync")} when online`);
-      console.log(`    2. Use ${cyan3("decantr create <type> <name>")} to create custom content`);
-      console.log(`    3. Review DECANTR.md for methodology`);
+      console.log(`    2. Run ${cyan3("decantr refresh")} after syncing to generate scaffold, section, and page packs`);
+      console.log(`    3. Read ${cyan3("DECANTR.md")} and the generated ${cyan3(".decantr/context/*")} files before implementation`);
+      console.log(`    4. Use ${cyan3("decantr create <type> <name>")} to create custom content if needed`);
+      return;
+    }
+    if (requestedBlueprint || requestedArchetype) {
+      console.log(error3("\nThe requested blueprint/archetype could not be resolved from the hosted registry or local cache."));
+      console.log(dim3("Run `decantr sync`, set DECANTR_CONTENT_DIR, or retry when the registry is reachable."));
+      process.exitCode = 1;
       return;
     }
     console.log(`
@@ -3644,8 +4346,8 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
     if (blueprintResult) {
       const blueprint = blueprintResult.data;
       if (blueprint.theme) {
-        if (!userExplicit.theme && (blueprint.theme.id || blueprint.theme.style)) {
-          options.theme = blueprint.theme.id || blueprint.theme.style;
+        if (!userExplicit.theme && blueprint.theme.id) {
+          options.theme = blueprint.theme.id;
         }
         if (!userExplicit.mode && blueprint.theme.mode) {
           options.mode = blueprint.theme.mode;
@@ -3663,9 +4365,9 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
         for (const entry of entries) {
           const id = typeof entry === "string" ? entry : entry.archetype;
           const r = await registryClient.fetchArchetype(id);
-          results.push([id, r?.data ?? null]);
+          results.push([id, r?.data ? mapRegistryArchetypeToArchetypeData(r.data) : null]);
         }
-        const archetypeMap = new Map(results.map(([id, data]) => [id, data || null]));
+        const archetypeMap = new Map(results);
         const composed = composeArchetypes(entries, archetypeMap);
         const primaryId = typeof entries[0] === "string" ? entries[0] : entries[0].archetype;
         archetypeData = {
@@ -3700,9 +4402,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
             if (page.patterns) {
               for (const ref of page.patterns) allPatternIds.add(ref.pattern);
             }
-            for (const item of page.layout) {
-              if (typeof item === "string") allPatternIds.add(item);
-            }
+            for (const patternId of collectPatternIdsFromItems(page.layout)) allPatternIds.add(patternId);
           }
         }
         patternSpecs = {};
@@ -3711,14 +4411,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
             try {
               const result2 = await registryClient.fetchPattern(pid);
               if (result2) {
-                const inner = result2.data;
-                const defaultPreset = inner.default_preset || "standard";
-                const preset = inner.presets?.[defaultPreset];
-                patternSpecs[pid] = {
-                  description: inner.description || "",
-                  components: inner.components || [],
-                  slots: preset?.layout?.slots || {}
-                };
+                patternSpecs[pid] = mapRegistryPatternToPatternSpecSummary(result2.data, void 0, false);
               }
             } catch {
             }
@@ -3727,7 +4420,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
         const zoneInputs = [];
         for (const entry of entries) {
           const arcId = typeof entry === "string" ? entry : entry.archetype;
-          const explicitRole = typeof entry === "object" && "role" in entry ? entry.role : void 0;
+          const explicitRole = typeof entry === "string" ? void 0 : entry.role;
           const archData = archetypeMap.get(arcId);
           if (archData) {
             zoneInputs.push({
@@ -3758,13 +4451,25 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
         ) : "";
       }
     } else {
+      if (requestedBlueprint) {
+        console.log(error3(`  Error: Could not fetch blueprint "${options.blueprint}".`));
+        console.log(dim3("Resolve local registry content or retry against the hosted registry."));
+        process.exitCode = 1;
+        return;
+      }
       console.log(`${YELLOW9}  Warning: Could not fetch blueprint "${options.blueprint}". Using defaults.${RESET13}`);
     }
   } else if (options.archetype) {
     const archetypeResult = await registryClient.fetchArchetype(options.archetype);
     if (archetypeResult) {
-      archetypeData = archetypeResult.data;
+      archetypeData = mapRegistryArchetypeToArchetypeData(archetypeResult.data);
     } else {
+      if (requestedArchetype) {
+        console.log(error3(`  Error: Could not fetch archetype "${options.archetype}".`));
+        console.log(dim3("Resolve local registry content or retry against the hosted registry."));
+        process.exitCode = 1;
+        return;
+      }
       console.log(`${YELLOW9}  Warning: Could not fetch archetype "${options.archetype}". Using defaults.${RESET13}`);
     }
   }
@@ -3772,24 +4477,14 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
   if (options.theme) {
     const themeResult = await registryClient.fetchTheme(options.theme);
     if (themeResult) {
-      const theme = themeResult.data;
-      themeData = {
-        seed: theme.seed,
-        palette: theme.palette,
-        tokens: theme.tokens,
-        cvd_support: theme.cvd_support,
-        typography: theme.typography,
-        motion: theme.motion,
-        decorators: theme.decorators,
-        treatments: theme.treatments,
-        spatial: theme.spatial,
-        radius: theme.radius,
-        shell: theme.shell,
-        effects: theme.effects,
-        compositions: theme.compositions,
-        pattern_preferences: theme.pattern_preferences
-      };
+      themeData = mapRegistryThemeToThemeData(themeResult.data);
     } else {
+      if (requestedTheme) {
+        console.log(error3(`  Error: Could not fetch theme "${options.theme}".`));
+        console.log(dim3("Resolve local registry content or retry against the hosted registry."));
+        process.exitCode = 1;
+        return;
+      }
       console.log(`${YELLOW9}  Warning: Could not fetch theme "${options.theme}". Using defaults.${RESET13}`);
     }
   }
@@ -3819,8 +4514,12 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
   }
   console.log("");
   console.log("  Next steps:");
-  console.log("    1. Review DECANTR.md for methodology");
-  console.log("    2. Explore more at decantr.ai/registry");
+  console.log("    1. Read DECANTR.md for methodology, CSS approach, and guard rules");
+  console.log("    2. Read .decantr/context/scaffold-pack.md first, then .decantr/context/scaffold.md");
+  console.log("    3. Read the matching section and page packs before implementing each route");
+  console.log("    4. Build the shell and route structure first, then implement the pages");
+  console.log("    5. Run decantr check and decantr audit after implementation");
+  console.log("    6. Explore more at decantr.ai/registry");
   console.log("");
   console.log("  Commands:");
   console.log(`    ${cyan3("decantr status")}     Project health`);
@@ -3830,7 +4529,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
   console.log(`    ${cyan3("decantr upgrade")}    Update to latest patterns`);
   console.log(`    ${cyan3("decantr check")}      Detect drift issues`);
   console.log(`    ${cyan3("decantr migrate")}    Migrate v2 essence to v3`);
-  const essenceContent = readFileSync15(result.essencePath, "utf-8");
+  const essenceContent = readFileSync16(result.essencePath, "utf-8");
   const essence = JSON.parse(essenceContent);
   if (essence.version !== "3.1.0") {
     const validation = validateEssence2(essence);
@@ -3877,16 +4576,16 @@ Validation warnings: ${validation.errors.join(", ")}`));
 }
 async function cmdStatus() {
   const projectRoot = process.cwd();
-  const essencePath = join23(projectRoot, "decantr.essence.json");
-  const projectJsonPath = join23(projectRoot, ".decantr", "project.json");
+  const essencePath = join24(projectRoot, "decantr.essence.json");
+  const projectJsonPath = join24(projectRoot, ".decantr", "project.json");
   console.log(heading2("Decantr Project Status"));
-  if (!existsSync23(essencePath)) {
+  if (!existsSync24(essencePath)) {
     console.log(`${RED11}No decantr.essence.json found.${RESET13}`);
     console.log(dim3('Run "decantr init" to create one.'));
     return;
   }
   try {
-    const essence = JSON.parse(readFileSync15(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync16(essencePath, "utf-8"));
     const validation = validateEssence2(essence);
     const essenceVersion = isV36(essence) ? "v3" : "v2";
     console.log(`${BOLD6}Essence:${RESET13}`);
@@ -3897,8 +4596,12 @@ async function cmdStatus() {
     }
     if (isV36(essence)) {
       const v3 = essence;
+      const sections = v3.blueprint.sections ?? [];
+      const flatPages = sections.length > 0 ? sections.flatMap((section) => section.pages ?? []) : v3.blueprint.pages ?? [];
+      const resolvedShell = sections.find((section) => section.role === "primary")?.shell || sections[0]?.shell || v3.blueprint.shell || "unknown";
+      const resolvedFeatures = v3.blueprint.features ?? [];
       console.log(`  ${BOLD6}DNA:${RESET13}`);
-      console.log(`    Theme: ${v3.dna.theme.style} (${v3.dna.theme.mode})`);
+      console.log(`    Theme: ${v3.dna.theme.id} (${v3.dna.theme.mode})`);
       console.log(`    Spacing: ${v3.dna.spacing.density} density, ${v3.dna.spacing.content_gap} gap`);
       console.log(`    Typography: ${v3.dna.typography.scale} scale`);
       console.log(`    Radius: ${v3.dna.radius.philosophy} (base ${v3.dna.radius.base}px)`);
@@ -3906,9 +4609,12 @@ async function cmdStatus() {
       console.log(`    Accessibility: WCAG ${v3.dna.accessibility.wcag_level}`);
       console.log(`    Personality: ${v3.dna.personality.join(", ")}`);
       console.log(`  ${BOLD6}Blueprint:${RESET13}`);
-      console.log(`    Shell: ${v3.blueprint.shell}`);
-      console.log(`    Pages: ${v3.blueprint.pages.length}`);
-      console.log(`    Features: ${v3.blueprint.features.length > 0 ? v3.blueprint.features.join(", ") : "none"}`);
+      console.log(`    Shell: ${resolvedShell}`);
+      console.log(`    Pages: ${flatPages.length}`);
+      if (sections.length > 0) {
+        console.log(`    Sections: ${sections.length}`);
+      }
+      console.log(`    Features: ${resolvedFeatures.length > 0 ? resolvedFeatures.join(", ") : "none"}`);
       console.log(`  ${BOLD6}Meta:${RESET13}`);
       console.log(`    Archetype: ${v3.meta.archetype}`);
       console.log(`    Target: ${v3.meta.target}`);
@@ -3918,7 +4624,7 @@ async function cmdStatus() {
       const theme = e.theme;
       const guard = e.guard;
       const structure = e.structure;
-      console.log(`  Theme: ${theme?.style || "unknown"} (${theme?.mode || "unknown"})`);
+      console.log(`  Theme: ${theme?.id || "unknown"} (${theme?.mode || "unknown"})`);
       console.log(`  Guard: ${guard?.mode || "unknown"}`);
       console.log(`  Pages: ${(structure || []).length}`);
       console.log(`  ${YELLOW9}Tip: Run \`decantr migrate\` to upgrade to v3.${RESET13}`);
@@ -3928,9 +4634,9 @@ async function cmdStatus() {
   }
   console.log("");
   console.log(`${BOLD6}Sync Status:${RESET13}`);
-  if (existsSync23(projectJsonPath)) {
+  if (existsSync24(projectJsonPath)) {
     try {
-      const projectJson = JSON.parse(readFileSync15(projectJsonPath, "utf-8"));
+      const projectJson = JSON.parse(readFileSync16(projectJsonPath, "utf-8"));
       const syncStatus = projectJson.sync?.status || "unknown";
       const lastSync = projectJson.sync?.lastSync || "never";
       const source = projectJson.sync?.registrySource || "unknown";
@@ -3948,7 +4654,7 @@ async function cmdStatus() {
 }
 async function cmdSync() {
   const projectRoot = process.cwd();
-  const cacheDir = join23(projectRoot, ".decantr", "cache");
+  const cacheDir = join24(projectRoot, ".decantr", "cache");
   console.log(heading2("Syncing registry content..."));
   const result = await syncRegistry(cacheDir);
   if (result.synced.length > 0) {
@@ -3964,47 +4670,110 @@ async function cmdSync() {
     }
   }
 }
-async function cmdAudit() {
-  const projectRoot = process.cwd();
-  const essencePath = join23(projectRoot, "decantr.essence.json");
-  console.log(heading2("Auditing project..."));
-  if (!existsSync23(essencePath)) {
-    console.log(`${RED11}No decantr.essence.json found.${RESET13}`);
-    process.exitCode = 1;
+function printVerificationFindings(findings) {
+  if (findings.length === 0) {
+    console.log(success3("No findings."));
     return;
   }
+  for (const finding of findings) {
+    const color = finding.severity === "error" ? RED11 : finding.severity === "warn" ? YELLOW9 : CYAN7;
+    console.log(`  ${color}[${finding.severity.toUpperCase()}]${RESET13} ${finding.category}: ${finding.message}`);
+    for (const evidence of finding.evidence) {
+      console.log(`    ${DIM13}${evidence}${RESET13}`);
+    }
+    if (finding.suggestedFix) {
+      console.log(`    ${DIM13}Fix: ${finding.suggestedFix}${RESET13}`);
+    }
+  }
+}
+function printProjectAuditReport(report) {
+  if (report.valid) {
+    console.log(success3("Project contract is valid."));
+  } else {
+    console.log(`${RED11}Project audit found blocking issues.${RESET13}`);
+  }
+  console.log("");
+  console.log(`${BOLD6}Summary:${RESET13}`);
+  console.log(`  Essence version: ${report.summary.essenceVersion ?? "missing"}`);
+  console.log(`  Pages defined: ${report.summary.pageCount}`);
+  console.log(`  Pack manifest: ${report.summary.packManifestPresent ? "present" : "missing"}`);
+  console.log(`  Review pack: ${report.summary.reviewPackPresent ? "present" : "missing"}`);
+  const runtimeStatus = report.summary.runtimeAuditChecked ? report.summary.runtimePassed ? "passed" : "failed" : report.runtimeAudit.distPresent ? "incomplete" : "pending (no dist/)";
+  console.log(`  Runtime audit: ${runtimeStatus}`);
+  if (report.summary.runtimeAuditChecked && report.runtimeAudit.assetCount > 0) {
+    const fmt = (bytes) => bytes >= 1e6 ? `${(bytes / 1e6).toFixed(2)} MB` : `${Math.round(bytes / 1e3)} KB`;
+    console.log(
+      `  Built assets: total ${fmt(report.runtimeAudit.totalAssetBytes)} | js ${fmt(report.runtimeAudit.jsAssetBytes)} | css ${fmt(report.runtimeAudit.cssAssetBytes)}`
+    );
+    console.log(
+      `  Document hardening: lang ${report.runtimeAudit.langOk ? "ok" : "missing"} | viewport ${report.runtimeAudit.viewportOk ? "ok" : "missing"} | charset ${report.runtimeAudit.charsetOk ? "ok" : "missing"} | csp ${report.runtimeAudit.cspSignalOk ? "present" : "missing"}`
+    );
+    console.log(
+      `  Route document shell: root docs ${report.runtimeAudit.routeDocumentsPassed}/${report.runtimeAudit.routeDocumentsChecked} | hardened docs ${report.runtimeAudit.routeDocumentsHardenedCount}/${report.runtimeAudit.routeDocumentsChecked}`
+    );
+    console.log(
+      `  Script hygiene: inline scripts ${report.runtimeAudit.inlineScriptCount} | inline event handlers ${report.runtimeAudit.inlineEventHandlerCount} | scripts without integrity ${report.runtimeAudit.externalScriptsWithoutIntegrityCount} | scripts missing crossorigin ${report.runtimeAudit.externalScriptsWithIntegrityMissingCrossoriginCount} | stylesheets without integrity ${report.runtimeAudit.externalStylesheetsWithoutIntegrityCount} | stylesheets missing crossorigin ${report.runtimeAudit.externalStylesheetsWithIntegrityMissingCrossoriginCount} | insecure external scripts ${report.runtimeAudit.externalScriptsWithInsecureTransportCount} | insecure external stylesheets ${report.runtimeAudit.externalStylesheetsWithInsecureTransportCount} | insecure external media ${report.runtimeAudit.externalMediaSourcesWithInsecureTransportCount} | external blank links missing rel ${report.runtimeAudit.externalBlankLinksWithoutRelCount} | external iframes missing sandbox ${report.runtimeAudit.externalIframesWithoutSandboxCount} | insecure external iframes ${report.runtimeAudit.externalIframesWithInsecureTransportCount}`
+    );
+    console.log(
+      `  JS risk signals: dynamic code ${report.runtimeAudit.jsEvalSignalCount} | html injection ${report.runtimeAudit.jsHtmlInjectionSignalCount} | insecure/dev transport ${report.runtimeAudit.jsInsecureTransportSignalCount} | secret markers ${report.runtimeAudit.jsSecretSignalCount}`
+    );
+  }
+  console.log(`  Findings: ${report.summary.errorCount} error(s), ${report.summary.warnCount} warn(s), ${report.summary.infoCount} info`);
+  console.log("");
+  console.log(`${BOLD6}Findings:${RESET13}`);
+  printVerificationFindings(report.findings);
+}
+function printFileCritiqueReport(report) {
+  console.log(success3(`Critiqued ${report.file}`));
+  console.log("");
+  console.log(`${BOLD6}Summary:${RESET13}`);
+  console.log(`  Overall score: ${report.overall}/5`);
+  console.log(`  Focus areas: ${report.focusAreas.join(", ")}`);
+  console.log(`  Review pack: ${report.reviewPack ? "present" : "missing"}`);
+  console.log("");
+  console.log(`${BOLD6}Scores:${RESET13}`);
+  for (const score of report.scores) {
+    console.log(`  ${cyan3(score.category.padEnd(20))} ${score.score}/5  ${dim3(score.details)}`);
+  }
+  console.log("");
+  console.log(`${BOLD6}Findings:${RESET13}`);
+  printVerificationFindings(report.findings);
+}
+async function cmdAudit(filePath) {
+  const projectRoot = process.cwd();
   try {
-    const essence = JSON.parse(readFileSync15(essencePath, "utf-8"));
-    const validation = validateEssence2(essence);
-    if (!validation.valid) {
-      console.log(`${RED11}Essence validation failed:${RESET13}`);
-      for (const err of validation.errors) {
-        console.log(`  ${RED11}${err}${RESET13}`);
+    if (filePath) {
+      const hydration2 = await hydrateHostedReviewPackIfMissing(projectRoot);
+      console.log(heading2(`Critiquing ${filePath}...`));
+      if (hydration2.hydrated) {
+        console.log(dim3("Hydrated missing review pack from hosted registry."));
+        console.log("");
       }
+      const report2 = await critiqueProjectFile(filePath, projectRoot);
+      printFileCritiqueReport(report2);
+      if (report2.findings.some((finding) => finding.severity === "error")) {
+        process.exitCode = 1;
+      }
+      return;
+    }
+    const hydration = await hydrateHostedExecutionPacksIfMissing(projectRoot);
+    console.log(heading2("Auditing project..."));
+    if (hydration.hydrated) {
+      console.log(dim3(
+        hydration.scope === "bundle" ? "Hydrated missing execution packs from hosted registry." : "Hydrated missing review pack and manifest from hosted registry."
+      ));
+      console.log("");
+    }
+    const report = await auditProject(projectRoot);
+    printProjectAuditReport(report);
+    if (!report.valid) {
       process.exitCode = 1;
       return;
     }
-    console.log(success3("Essence is valid."));
-    const { themeRegistry, patternRegistry } = buildRegistryContext();
-    const violations = evaluateGuard(essence, { themeRegistry, patternRegistry });
-    if (violations.length > 0) {
+    if (report.findings.length > 0) {
       console.log("");
-      console.log(`${YELLOW9}Guard violations:${RESET13}`);
-      for (const v of violations) {
-        const vr = v;
-        console.log(`  ${YELLOW9}[${vr.rule}]${RESET13} ${vr.message}`);
-        if (vr.suggestion) {
-          console.log(`    ${DIM13}Suggestion: ${vr.suggestion}${RESET13}`);
-        }
-      }
-    } else {
-      console.log(success3("No guard violations."));
+      console.log(dim3("Project audit completed with advisory findings."));
     }
-    console.log("");
-    console.log(`${BOLD6}Summary:${RESET13}`);
-    console.log(`  Pages defined: ${essence.structure.length}`);
-    console.log(`  Guard mode: ${essence.guard.mode}`);
-    console.log(`  Theme: ${essence.theme.style}`);
   } catch (e) {
     console.log(`${RED11}Error: ${e.message}${RESET13}`);
     process.exitCode = 1;
@@ -4047,7 +4816,7 @@ ${BOLD6}Examples:${RESET13}
         console.log(success3(`Created custom theme "${name}"`));
         console.log(dim3(`  Path: ${result.path}`));
         console.log("");
-        console.log(`Use in essence: ${cyan3(`"style": "custom:${name}"`)}`);
+        console.log(`Use in essence: ${cyan3(`"id": "custom:${name}"`)}`);
       } else {
         console.error(error3(result.error || "Failed to create theme"));
         process.exitCode = 1;
@@ -4074,14 +4843,14 @@ ${BOLD6}Examples:${RESET13}
         process.exitCode = 1;
         return;
       }
-      const themePath = join23(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
-      if (!existsSync23(themePath)) {
+      const themePath = join24(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
+      if (!existsSync24(themePath)) {
         console.error(error3(`Theme "${name}" not found at ${themePath}`));
         process.exitCode = 1;
         return;
       }
       try {
-        const theme = JSON.parse(readFileSync15(themePath, "utf-8"));
+        const theme = JSON.parse(readFileSync16(themePath, "utf-8"));
         const result = validateCustomTheme(theme);
         if (result.valid) {
           console.log(success3(`Custom theme "${name}" is valid`));
@@ -4159,14 +4928,20 @@ ${BOLD6}Usage:${RESET13}
   decantr init [options]
   decantr status
   decantr sync
-  decantr audit
+  decantr audit [file]
   decantr migrate
   decantr check
   decantr sync-drift
-  decantr search <query> [--type <type>]
+  decantr search <query> [--type <type>] [--sort <recommended|recent|name>] [--recommended] [--source <authored|benchmark|hybrid>]
   decantr suggest <query> [--type <type>]
   decantr get <type> <id>
-  decantr list <type>
+  decantr list <type> [--sort <recommended|recent|name>] [--recommended] [--source <authored|benchmark|hybrid>]
+  decantr showcase [manifest|shortlist|verification] [--json]
+  decantr registry summary [--namespace <namespace>] [--json]
+  decantr registry compile-packs [path] [--namespace <namespace>] [--json] [--write-context]
+  decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context]
+  decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>]
+  decantr registry audit-project [--namespace <namespace>] [--json] [--essence <path>] [--dist <path>] [--sources <dir>]
   decantr validate [path]
   decantr theme <subcommand>
   decantr create <type> <name>
@@ -4196,7 +4971,7 @@ ${BOLD6}Commands:${RESET13}
   ${cyan3("init")}        Initialize Decantr in an existing project (v3 essence by default)
   ${cyan3("status")}      Show project status, DNA axioms, and blueprint info
   ${cyan3("sync")}        Sync registry content from API
-  ${cyan3("audit")}       Validate essence and check for drift
+  ${cyan3("audit")}       Audit the project or critique a specific file against compiled packs
   ${cyan3("migrate")}     Migrate v2 essence to v3 format (with .v2.backup.json backup)
   ${cyan3("check")}       Detect drift issues (validate + guard rules) [--telemetry]
   ${cyan3("sync-drift")}  Review and resolve drift log entries
@@ -4204,6 +4979,7 @@ ${BOLD6}Commands:${RESET13}
   ${cyan3("suggest")}     Suggest patterns or alternatives for a query
   ${cyan3("get")}         Get full details of a registry item
   ${cyan3("list")}        List items by type
+  ${cyan3("showcase")}    Inspect audited showcase benchmark metadata
   ${cyan3("validate")}    Validate essence file (v2 and v3)
   ${cyan3("theme")}       Manage custom themes (create, list, validate, delete, import)
   ${cyan3("create")}      Create a custom content item (pattern, theme, blueprint, etc.)
@@ -4212,7 +4988,7 @@ ${BOLD6}Commands:${RESET13}
   ${cyan3("logout")}      Remove stored credentials
   ${cyan3("analyze")}     Scan existing project and produce analysis report
   ${cyan3("export")}      Export design tokens to framework format (shadcn, tailwind, css-vars)
-  ${cyan3("registry")}    Registry management (mirror)
+  ${cyan3("registry")}    Registry management and intelligence summary
   ${cyan3("upgrade")}     Check for content updates from registry
   ${cyan3("help")}        Show this help
 
@@ -4222,12 +4998,24 @@ ${BOLD6}Examples:${RESET13}
   decantr init
   decantr init --blueprint=saas-dashboard --theme=luminarum --yes
   decantr status
+  decantr audit
+  decantr audit src/pages/HomePage.tsx
   decantr migrate
   decantr check
   decantr sync-drift
   decantr search dashboard
   decantr suggest leaderboard
   decantr list patterns
+  decantr showcase shortlist
+  decantr showcase verification --json
+  decantr registry summary --namespace @official
+  decantr registry compile-packs decantr.essence.json --json
+  decantr registry compile-packs decantr.essence.json --write-context
+  decantr registry get-pack manifest --namespace @official --json
+  decantr registry get-pack review --namespace @official --write-context
+  decantr registry critique-file src/pages/Home.tsx --namespace @official --json
+  decantr registry audit-project --namespace @official --json
+  decantr registry audit-project --namespace @official --dist dist --sources src
   decantr create pattern my-card
 `);
 }
@@ -4266,6 +5054,7 @@ async function main() {
         theme: newOpts.theme,
         mode: newOpts.mode,
         shape: newOpts.shape,
+        target: newOpts.target,
         offline: newOpts.offline === true,
         registry: newOpts.registry
       });
@@ -4306,7 +5095,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-GTUGOUSD.js");
+      const { cmdUpgrade } = await import("./upgrade-XNUAON3G.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;
@@ -4316,7 +5105,7 @@ async function main() {
       if (command === "heal") {
         console.log(`${YELLOW9}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET13}`);
       }
-      const { cmdHeal } = await import("./heal-VYEGIUAS.js");
+      const { cmdHeal } = await import("./heal-MURR3RVQ.js");
       const telemetryFlag = args.includes("--telemetry");
       await cmdHeal(process.cwd(), { telemetry: telemetryFlag });
       break;
@@ -4348,19 +5137,29 @@ async function main() {
       break;
     }
     case "audit": {
-      await cmdAudit();
+      await cmdAudit(args[1]);
       break;
     }
     case "search": {
       const query = args[1];
       if (!query) {
-        console.error(error3("Usage: decantr search <query> [--type <type>]"));
+        console.error(error3("Usage: decantr search <query> [--type <type>] [--sort <recommended|recent|name>] [--source <authored|benchmark|hybrid>]"));
         process.exitCode = 1;
         return;
       }
       const typeIdx = args.indexOf("--type");
       const type = typeIdx !== -1 ? args[typeIdx + 1] : void 0;
-      await cmdSearch(query, type);
+      const sortIdx = args.indexOf("--sort");
+      const sort = sortIdx !== -1 ? args[sortIdx + 1] : void 0;
+      const sourceIdx = args.indexOf("--source");
+      const intelligenceSource = sourceIdx !== -1 ? args[sourceIdx + 1] : void 0;
+      if (intelligenceSource && !isContentIntelligenceSource(intelligenceSource)) {
+        console.error(error3(`Invalid source "${intelligenceSource}". Must be one of: authored, benchmark, hybrid.`));
+        process.exitCode = 1;
+        return;
+      }
+      const recommended = args.includes("--recommended");
+      await cmdSearch(query, type, sort, recommended, intelligenceSource);
       break;
     }
     case "suggest": {
@@ -4389,11 +5188,37 @@ async function main() {
     case "list": {
       const type = args[1];
       if (!type) {
-        console.error(error3("Usage: decantr list <type>"));
+        console.error(error3("Usage: decantr list <type> [--sort <recommended|recent|name>] [--source <authored|benchmark|hybrid>]"));
         process.exitCode = 1;
         return;
       }
-      await cmdList(type);
+      const sortIdx = args.indexOf("--sort");
+      const sort = sortIdx !== -1 ? args[sortIdx + 1] : void 0;
+      const sourceIdx = args.indexOf("--source");
+      const intelligenceSource = sourceIdx !== -1 ? args[sourceIdx + 1] : void 0;
+      if (intelligenceSource && !isContentIntelligenceSource(intelligenceSource)) {
+        console.error(error3(`Invalid source "${intelligenceSource}". Must be one of: authored, benchmark, hybrid.`));
+        process.exitCode = 1;
+        return;
+      }
+      const recommended = args.includes("--recommended");
+      await cmdList(type, sort, recommended, intelligenceSource);
+      break;
+    }
+    case "showcase": {
+      const requestedView = args[1];
+      const view = requestedView === "manifest" || requestedView === "shortlist" || requestedView === "verification" ? requestedView : "shortlist";
+      const jsonOutput = args.includes("--json");
+      if (requestedView && requestedView.startsWith("--")) {
+        await printShowcaseBenchmarks("shortlist", jsonOutput);
+        break;
+      }
+      if (requestedView && !["manifest", "shortlist", "verification"].includes(requestedView)) {
+        console.error(error3("Usage: decantr showcase [manifest|shortlist|verification] [--json]"));
+        process.exitCode = 1;
+        break;
+      }
+      await printShowcaseBenchmarks(view, jsonOutput);
       break;
     }
     case "validate": {
@@ -4469,8 +5294,72 @@ async function main() {
         const typeIdx = args.indexOf("--type");
         const mirrorType = typeIdx !== -1 ? args[typeIdx + 1] : void 0;
         await cmdRegistryMirror(process.cwd(), { type: mirrorType });
+      } else if (subcommand === "summary") {
+        const namespaceIdx = args.indexOf("--namespace");
+        const namespace = namespaceIdx !== -1 ? args[namespaceIdx + 1] : void 0;
+        const jsonOutput = args.includes("--json");
+        await printRegistryIntelligenceSummary(namespace, jsonOutput);
+      } else if (subcommand === "compile-packs") {
+        const namespaceIdx = args.indexOf("--namespace");
+        const namespace = namespaceIdx !== -1 ? args[namespaceIdx + 1] : void 0;
+        const jsonOutput = args.includes("--json");
+        const writeContext = args.includes("--write-context");
+        const essencePath = args[2] && !args[2].startsWith("--") ? args[2] : void 0;
+        await printHostedExecutionPackBundle(essencePath, namespace, jsonOutput, writeContext);
+      } else if (subcommand === "get-pack") {
+        const namespaceIdx = args.indexOf("--namespace");
+        const namespace = namespaceIdx !== -1 ? args[namespaceIdx + 1] : void 0;
+        const jsonOutput = args.includes("--json");
+        const writeContext = args.includes("--write-context");
+        const essenceIdx = args.indexOf("--essence");
+        const essencePath = essenceIdx !== -1 ? args[essenceIdx + 1] : void 0;
+        const packType = args[2] && !args[2].startsWith("--") ? args[2] : void 0;
+        const id = args[3] && !args[3].startsWith("--") ? args[3] : void 0;
+        if (!packType || !["manifest", "scaffold", "review", "section", "page", "mutation"].includes(packType)) {
+          console.error(`${RED11}Usage: decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context]${RESET13}`);
+          process.exitCode = 1;
+          break;
+        }
+        if (packType === "manifest") {
+          await printHostedExecutionPackManifest(essencePath, namespace, jsonOutput, writeContext);
+          break;
+        }
+        await printHostedSelectedExecutionPack(
+          packType,
+          id,
+          essencePath,
+          namespace,
+          jsonOutput,
+          writeContext
+        );
+      } else if (subcommand === "critique-file") {
+        const namespaceIdx = args.indexOf("--namespace");
+        const namespace = namespaceIdx !== -1 ? args[namespaceIdx + 1] : void 0;
+        const jsonOutput = args.includes("--json");
+        const essenceIdx = args.indexOf("--essence");
+        const essencePath = essenceIdx !== -1 ? args[essenceIdx + 1] : void 0;
+        const treatmentsIdx = args.indexOf("--treatments");
+        const treatmentsPath = treatmentsIdx !== -1 ? args[treatmentsIdx + 1] : void 0;
+        const sourcePath = args[2] && !args[2].startsWith("--") ? args[2] : void 0;
+        if (!sourcePath) {
+          console.error(`${RED11}Usage: decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>]${RESET13}`);
+          process.exitCode = 1;
+          break;
+        }
+        await printHostedFileCritique(sourcePath, namespace, jsonOutput, essencePath, treatmentsPath);
+      } else if (subcommand === "audit-project") {
+        const namespaceIdx = args.indexOf("--namespace");
+        const namespace = namespaceIdx !== -1 ? args[namespaceIdx + 1] : void 0;
+        const jsonOutput = args.includes("--json");
+        const essenceIdx = args.indexOf("--essence");
+        const essencePath = essenceIdx !== -1 ? args[essenceIdx + 1] : void 0;
+        const distIdx = args.indexOf("--dist");
+        const distPath = distIdx !== -1 ? args[distIdx + 1] : void 0;
+        const sourcesIdx = args.indexOf("--sources");
+        const sourcesPath = sourcesIdx !== -1 ? args[sourcesIdx + 1] : void 0;
+        await printHostedProjectAudit(namespace, jsonOutput, essencePath, distPath, sourcesPath);
       } else {
-        console.error(`${RED11}Usage: decantr registry mirror [--type <type>]${RESET13}`);
+        console.error(`${RED11}Usage: decantr registry mirror [--type <type>] | decantr registry summary [--namespace <namespace>] [--json] | decantr registry compile-packs [path] [--namespace <namespace>] [--json] [--write-context] | decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context] | decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>] | decantr registry audit-project [--namespace <namespace>] [--json] [--essence <path>] [--dist <path>] [--sources <dir>]${RESET13}`);
         process.exitCode = 1;
       }
       break;