@decantr/cli 2.4.0 → 2.5.0

package/README.md

@@ -14,7 +14,7 @@ npm install -D @decantr/cli
 Or run it without installing:
 
 ```bash
-npx @decantr/cli new my-app --blueprint=agent-marketplace
+npx @decantr/cli new my-app --blueprint=esports-hq
 ```
 
 Use `decantr new` for a greenfield workspace in a fresh directory. With a blueprint/archetype it uses the runnable adapter and Decantr CSS; without registry content it creates a contract-only workspace unless you explicitly pass `--adoption=decantr-css`.
@@ -68,17 +68,18 @@ Brownfield analysis also writes `.decantr/doctrine-map.json`, a ranked source-pr
 - produces local Project Health reports, Evidence Bundles, workspace health, and a localhost Studio dashboard for end-user drift triage
 - audits local registry content repositories with Content Health reports for schema, reference, and quality coverage
 - searches the registry and showcase benchmark corpus
+- filters blueprints through public portfolio sets: `All`, `Featured`, `Certified`, and opt-in `Labs`
 - syncs paginated hosted registry content into a full slug-keyed local cache for offline guards and context generation
 - validates, refreshes, and maintains `decantr.essence.json`
 
 ## Common Commands
 
 ```bash
-decantr new my-app --blueprint=agent-marketplace
+decantr new my-app --blueprint=esports-hq
 decantr analyze
 decantr init --existing --accept-proposal
 decantr check --brownfield
-decantr init --existing --blueprint=agent-marketplace
+decantr init --existing --blueprint=esports-hq
 decantr init --workflow=greenfield --adoption=contract-only
 decantr rules preview
 decantr rules apply
@@ -92,6 +93,9 @@ decantr telemetry explain
 decantr telemetry link --enable --org <org-slug>
 decantr content-health --ci --fail-on error
 decantr registry summary --namespace @official --json
+decantr list blueprints --blueprint-set featured
+decantr list blueprints --blueprint-set certified
+decantr search dashboard --type blueprint --blueprint-set labs
 decantr showcase verification --json
 ```
 
@@ -210,7 +214,7 @@ pnpm --filter @decantr/cli certify:blueprints -- --blueprints=portfolio,legal-re
 Offline blueprint scaffolding expects a real local content source:
 
 ```bash
-DECANTR_CONTENT_DIR=/path/to/decantr-content decantr new my-app --blueprint=agent-marketplace --offline
+DECANTR_CONTENT_DIR=/path/to/decantr-content decantr new my-app --blueprint=esports-hq --offline
 ```
 
 If a requested offline blueprint, archetype, or theme cannot be resolved from local cache/custom content or `DECANTR_CONTENT_DIR`, the CLI now stops explicitly instead of silently falling back to the default scaffold.

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-H6TIXG5K.js";
-import "./chunk-PEGMSXDJ.js";
+import "./chunk-HO3OLDPQ.js";
+import "./chunk-V3XAQWKD.js";
 import "./chunk-IEW2QFYI.js";

package/dist/{chunk-H6TIXG5K.js → chunk-HO3OLDPQ.js}

@@ -14,7 +14,7 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-PEGMSXDJ.js";
+} from "./chunk-V3XAQWKD.js";
 import {
   buildGuardRegistryContext,
   createDoctrineMap,
@@ -39,9 +39,11 @@ import { evaluateGuard, isV4 as isV47, validateEssence as validateEssence2 } fro
 import {
   CONTENT_TYPE_TO_API_CONTENT_TYPE as CONTENT_TYPE_TO_API_CONTENT_TYPE3,
   CONTENT_TYPES as GET_CONTENT_TYPES,
+  getBlueprintPortfolioMetadata,
   isApiContentType,
   isContentIntelligenceSource,
   isContentType as isGetContentType,
+  isPublicBlueprintSet,
   API_CONTENT_TYPES as LIST_CONTENT_TYPES,
   RegistryAPIClient as RegistryAPIClient3
 } from "@decantr/registry";
@@ -5624,6 +5626,7 @@ function extractPatternName(item) {
 function generateGreenfieldPrompt(ctx) {
   const lines = [];
   const usesDecantrCss = ctx.adoptionMode === "decantr-css" || !ctx.adoptionMode;
+  const hasCompiledPacks = ctx.hasCompiledPacks ?? true;
   lines.push("Build this greenfield application using the Decantr design system.");
   lines.push("");
   if (ctx.blueprint) lines.push(`Blueprint: ${ctx.blueprint}`);
@@ -5640,44 +5643,66 @@ function generateGreenfieldPrompt(ctx) {
     "This workspace is a new Decantr scaffold. Use the contract to create or extend the runtime deliberately, not to reverse-engineer a hidden starter."
   );
   lines.push("");
-  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."
-  );
+  if (hasCompiledPacks) {
+    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."
+    );
+  } else {
+    lines.push(
+      "Compiled execution-pack files are not present in this scaffold. Treat narrative Decantr context as the temporary source of truth and run `decantr refresh` after fixing the reported validation issue."
+    );
+  }
   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/context/scaffold-pack.md \u2014 the canonical compiled contract. Contains route plan, shell layouts, navigation, Required Theme Decorators, and project-wide execution rules."
-  );
-  lines.push(
-    "2. Before section work, read the matching .decantr/context/section-*-pack.md first, then .decantr/context/section-*.md only for extra slot/layout detail."
-  );
-  lines.push(
-    "3. Before route work, read the matching .decantr/context/page-*-pack.md file. Its pattern layout and interaction checklists are contract."
-  );
-  lines.push(
-    "4. .decantr/context/scaffold.md for broader topology, route map, and voice guidance after the compact packs are understood."
-  );
-  lines.push(
-    "5. DECANTR.md as a lookup reference for atoms, treatments, decorators, interaction implementations, and guard rules. Do not let narrative docs override compiled packs."
-  );
-  lines.push("");
-  lines.push("\u2550\u2550\u2550 INTERACTIONS ARE CONTRACT, NOT GUIDANCE \u2550\u2550\u2550");
-  lines.push("");
-  lines.push(
-    'Each page pack lists "Interactions (MUST implement each)" per pattern. Implement the actual behavior, not visible text saying it exists. Use DECANTR.md only to look up the canonical implementation shape when needed.'
-  );
-  lines.push(
-    "Examples: pointer handlers for dragging/panning, onWheel for zoom, onKeyDown + tabIndex for keyboard navigation, IntersectionObserver for scroll reveal, state updates for real-time indicators, and d-* motion classes where the contract calls for animation."
-  );
-  lines.push("");
-  lines.push(
-    "`decantr check --strict` fails when a declared interaction has no matching implementation."
-  );
-  lines.push("");
+  if (hasCompiledPacks) {
+    lines.push(
+      "1. .decantr/context/scaffold-pack.md \u2014 the canonical compiled contract. Contains route plan, shell layouts, navigation, Required Theme Decorators, and project-wide execution rules."
+    );
+    lines.push(
+      "2. Before section work, read the matching .decantr/context/section-*-pack.md first, then .decantr/context/section-*.md only for extra slot/layout detail."
+    );
+    lines.push(
+      "3. Before route work, read the matching .decantr/context/page-*-pack.md file. Its pattern layout and interaction checklists are contract."
+    );
+    lines.push(
+      "4. .decantr/context/scaffold.md for broader topology, route map, and voice guidance after the compact packs are understood."
+    );
+    lines.push(
+      "5. DECANTR.md as a lookup reference for atoms, treatments, decorators, interaction implementations, and guard rules. Do not let narrative docs override compiled packs."
+    );
+    lines.push("");
+    lines.push("\u2550\u2550\u2550 INTERACTIONS ARE CONTRACT, NOT GUIDANCE \u2550\u2550\u2550");
+    lines.push("");
+    lines.push(
+      'Each page pack lists "Interactions (MUST implement each)" per pattern. Implement the actual behavior, not visible text saying it exists. Use DECANTR.md only to look up the canonical implementation shape when needed.'
+    );
+    lines.push(
+      "Examples: pointer handlers for dragging/panning, onWheel for zoom, onKeyDown + tabIndex for keyboard navigation, IntersectionObserver for scroll reveal, state updates for real-time indicators, and d-* motion classes where the contract calls for animation."
+    );
+    lines.push("");
+    lines.push(
+      "`decantr check --strict` fails when a declared interaction has no matching implementation."
+    );
+    lines.push("");
+  } else {
+    lines.push(
+      "1. .decantr/context/scaffold.md for topology, route map, voice, and section inventory."
+    );
+    lines.push(
+      "2. The matching .decantr/context/section-*.md file before implementing each section."
+    );
+    lines.push(
+      "3. DECANTR.md for atoms, treatments, decorators, interaction shapes, and guard rules."
+    );
+    lines.push(
+      "4. Run `decantr refresh` and switch to compiled pack files once validation passes."
+    );
+    lines.push("");
+  }
   lines.push("\u2550\u2550\u2550 STYLING ADOPTION \u2550\u2550\u2550");
   lines.push("");
   if (ctx.adoptionMode === "contract-only") {
@@ -5764,12 +5789,18 @@ function generateGreenfieldPrompt(ctx) {
   lines.push("");
   lines.push("\u2550\u2550\u2550 THEME DECORATOR CONTRACT \u2014 APPLY OR THE THEME DOES NOT LAND \u2550\u2550\u2550");
   lines.push("");
-  lines.push(
-    'Each theme ships namespaced decorator classes (`clean-card`, `lum-glass`, `carbon-canvas`, `paper-card`, etc.). Apply the scaffold-pack.md "Required Theme Decorators" as additive classes alongside d-* treatments so the theme lands as more than token colors.'
-  );
-  lines.push(
-    "Section packs may point back to the scaffold-pack table; scaffold-pack.md is authoritative."
-  );
+  if (hasCompiledPacks) {
+    lines.push(
+      'Each theme ships namespaced decorator classes (`clean-card`, `lum-glass`, `carbon-canvas`, `paper-card`, etc.). Apply the scaffold-pack.md "Required Theme Decorators" as additive classes alongside d-* treatments so the theme lands as more than token colors.'
+    );
+    lines.push(
+      "Section packs may point back to the scaffold-pack table; scaffold-pack.md is authoritative."
+    );
+  } else {
+    lines.push(
+      "Each theme ships namespaced decorator classes (`clean-card`, `lum-glass`, `carbon-canvas`, `paper-card`, etc.). Use DECANTR.md and section context to apply the theme, then rerun `decantr refresh` to restore the authoritative decorator table."
+    );
+  }
   lines.push("");
   lines.push("\u2550\u2550\u2550 HARD RULES (NON-NEGOTIABLE) \u2550\u2550\u2550");
   lines.push("");
@@ -5790,7 +5821,7 @@ function generateGreenfieldPrompt(ctx) {
     "- Use lucide-react for ALL iconography (already in package.json). Pick semantic icons (Bot, Activity, Database, Search) over generic ones. Do NOT inline SVGs for icons that have Lucide equivalents."
   );
   lines.push(
-    "- Section Directives in section packs are execution rules for layout proportions, treatment stacks, copy conventions, and pattern fitness."
+    hasCompiledPacks ? "- Section Directives in section packs are execution rules for layout proportions, treatment stacks, copy conventions, and pattern fitness." : "- Section context files are execution rules for layout proportions, treatment stacks, copy conventions, and pattern fitness until compiled packs are restored."
   );
   lines.push(
     "- Filter chip rows / tab strips use `d-step-chip[data-step-state]`, not bare `d-interactive` buttons."
@@ -5804,9 +5835,11 @@ function generateGreenfieldPrompt(ctx) {
   lines.push("");
   lines.push("\u2550\u2550\u2550 IMPLEMENTATION RULES \u2550\u2550\u2550");
   lines.push(
-    "- Do not invent routes, sections, shells, themes, or features beyond the compiled packs."
+    hasCompiledPacks ? "- Do not invent routes, sections, shells, themes, or features beyond the compiled packs." : "- Do not invent routes, sections, shells, themes, or features beyond decantr.essence.json and generated narrative context."
+  );
+  lines.push(
+    hasCompiledPacks ? "- Prefer scaffold-pack, section-pack, and page-pack guidance over narrative docs." : "- Prefer decantr.essence.json and generated section context over assumptions from prior examples."
   );
-  lines.push("- Prefer scaffold-pack, section-pack, and page-pack guidance over narrative docs.");
   lines.push(
     "- Start with the shell layouts and route structure first, then build section pages route by route."
   );
@@ -5850,7 +5883,9 @@ function generateGreenfieldPrompt(ctx) {
   lines.push("");
   lines.push("\u2550\u2550\u2550 EXECUTION FLOW \u2550\u2550\u2550");
   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(
+    hasCompiledPacks ? "- Then implement each section's pages using the matching section and page packs." : "- Then implement each section's pages using decantr.essence.json and the matching section context."
+  );
   lines.push(
     "- After implementation, run `decantr check` (primary gate) and `decantr audit` (supplementary diagnostics)."
   );
@@ -6495,7 +6530,41 @@ async function printHostedProjectAudit(namespace, jsonOutput = false, essencePat
   );
   printProjectAuditReport(report);
 }
-async function cmdSearch(query, type, sort, recommended, intelligenceSource) {
+function formatBlueprintPortfolioSummary(value) {
+  const portfolio = getBlueprintPortfolioMetadata(value);
+  if (!portfolio) return null;
+  const labels = [];
+  if (portfolio.artifact.status === "certified") labels.push("Certified");
+  if (portfolio.visibility === "featured") labels.push("Featured");
+  if (portfolio.visibility === "labs") labels.push("Labs");
+  if (portfolio.visibility === "hidden") labels.push("Folded");
+  if (labels.length === 0) labels.push("All");
+  const alternative = portfolio.recommended_alternative ? `; recommended alternative: ${portfolio.recommended_alternative}` : "";
+  return `Blueprint set: ${labels.join(" + ")}${alternative}`;
+}
+function printBlueprintPortfolioNotice(blueprint) {
+  const portfolio = getBlueprintPortfolioMetadata(blueprint);
+  if (!portfolio) return;
+  if (portfolio.visibility === "hidden" || portfolio.maturity === "fold-candidate") {
+    console.log(
+      `${YELLOW9}  Warning:${RESET14} blueprint "${blueprint.id}" is folded out of public browsing.`
+    );
+    if (portfolio.recommended_alternative) {
+      console.log(
+        dim3(
+          `  Recommended public alternative: decantr new <name> --blueprint=${portfolio.recommended_alternative}`
+        )
+      );
+    }
+    return;
+  }
+  if (portfolio.visibility === "labs") {
+    console.log(
+      `${YELLOW9}  Note:${RESET14} blueprint "${blueprint.id}" is a Labs blueprint; direct scaffolding is supported, but it is not a default recommendation yet.`
+    );
+  }
+}
+async function cmdSearch(query, type, sort, recommended, intelligenceSource, blueprintSet) {
   const apiClient = getAPIClient();
   try {
     const response = await apiClient.search({
@@ -6503,7 +6572,8 @@ async function cmdSearch(query, type, sort, recommended, intelligenceSource) {
       type,
       sort,
       recommended,
-      intelligenceSource
+      intelligenceSource,
+      blueprintSet
     });
     const results = response.results;
     if (results.length === 0) {
@@ -6518,6 +6588,12 @@ async function cmdSearch(query, type, sort, recommended, intelligenceSource) {
       if (intelligenceSummary) {
         console.log(`  ${dim3(intelligenceSummary)}`);
       }
+      const portfolioSummary = formatBlueprintPortfolioSummary(
+        r.blueprint_portfolio
+      );
+      if (portfolioSummary) {
+        console.log(`  ${dim3(portfolioSummary)}`);
+      }
       console.log("");
     }
   } catch {
@@ -6657,7 +6733,7 @@ async function cmdValidate(path) {
   } catch {
   }
 }
-async function cmdList(type, sort, recommended, intelligenceSource) {
+async function cmdList(type, sort, recommended, intelligenceSource, blueprintSet) {
   if (!isApiContentType(type)) {
     console.error(
       error3(`Invalid type "${type}". Must be one of: ${LIST_CONTENT_TYPES.join(", ")}`)
@@ -6673,7 +6749,8 @@ async function cmdList(type, sort, recommended, intelligenceSource) {
     void 0,
     sort,
     recommended,
-    intelligenceSource
+    intelligenceSource,
+    blueprintSet
   );
   const items = result.data.items;
   if (items.length === 0) {
@@ -6709,6 +6786,12 @@ async function cmdList(type, sort, recommended, intelligenceSource) {
       if (intelligenceSummary) {
         console.log(`  ${dim3(intelligenceSummary)}`);
       }
+      const portfolioSummary = formatBlueprintPortfolioSummary(
+        item.blueprint_portfolio ?? item
+      );
+      if (portfolioSummary) {
+        console.log(`  ${dim3(portfolioSummary)}`);
+      }
     }
   }
 }
@@ -7146,6 +7229,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET14}`);
     const blueprintResult = await registryClient.fetchBlueprint(options.blueprint);
     if (blueprintResult) {
       const blueprint = blueprintResult.data;
+      printBlueprintPortfolioNotice(blueprint);
       if (blueprint.theme) {
         if (!userExplicit.theme && blueprint.theme.id) {
           options.theme = blueprint.theme.id;
@@ -7353,19 +7437,34 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET14}`);
       )
     );
   }
+  const hasCompiledPacks = existsSync26(join27(projectRoot, ".decantr", "context", "scaffold-pack.md"));
   console.log("");
   console.log("  Next steps:");
-  console.log(
-    "    1. Read .decantr/context/scaffold-pack.md first as the primary compiled contract"
-  );
-  console.log(
-    "    2. Read .decantr/context/scaffold.md for broader topology, route map, and voice guidance"
-  );
-  console.log("    3. Read the matching section and page packs before implementing each route");
-  console.log("    4. Use DECANTR.md as a lookup reference for atoms, treatments, and guard rules");
-  console.log("    5. Build the shell and route structure first, then implement the pages");
-  console.log("    6. Run decantr check and decantr audit after implementation");
-  console.log("    7. Explore more at decantr.ai/registry");
+  if (hasCompiledPacks) {
+    console.log(
+      "    1. Read .decantr/context/scaffold-pack.md first as the primary compiled contract"
+    );
+    console.log(
+      "    2. Read .decantr/context/scaffold.md for broader topology, route map, and voice guidance"
+    );
+    console.log("    3. Read the matching section and page packs before implementing each route");
+    console.log(
+      "    4. Use DECANTR.md as a lookup reference for atoms, treatments, and guard rules"
+    );
+    console.log("    5. Build the shell and route structure first, then implement the pages");
+    console.log("    6. Run decantr check and decantr audit after implementation");
+    console.log("    7. Explore more at decantr.ai/registry");
+  } else {
+    console.log("    1. Fix the validation issue reported above");
+    console.log("    2. Run decantr refresh to restore compiled execution packs");
+    console.log(
+      "    3. Until packs exist, read .decantr/context/scaffold.md and section context files"
+    );
+    console.log(
+      "    4. Use DECANTR.md as a lookup reference for atoms, treatments, and guard rules"
+    );
+    console.log("    5. Run decantr check and decantr audit after implementation");
+  }
   console.log("");
   console.log("  Commands:");
   console.log(`    ${cyan3("decantr status")}     Project health`);
@@ -7416,7 +7515,8 @@ Validation warnings: ${validation.errors.join(", ")}`));
     pages: promptPages,
     personality: options.personality,
     features: options.features,
-    guard: options.guard
+    guard: options.guard,
+    hasCompiledPacks
   };
   const curatedPrompt = generateCuratedPrompt(promptCtx);
   console.log("");
@@ -8178,7 +8278,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-XTTGHFG7.js");
+      const { cmdUpgrade } = await import("./upgrade-U2BTWJJJ.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;
@@ -8287,7 +8387,7 @@ async function main() {
       if (!query) {
         console.error(
           error3(
-            "Usage: decantr search <query> [--type <type>] [--sort <recommended|recent|name>] [--source <authored|benchmark|hybrid>]"
+            "Usage: decantr search <query> [--type <type>] [--sort <recommended|recent|name>] [--source <authored|benchmark|hybrid>] [--blueprint-set <all|featured|certified|labs>]"
           )
         );
         process.exitCode = 1;
@@ -8299,6 +8399,18 @@ async function main() {
       const sort = sortIdx !== -1 ? args[sortIdx + 1] : void 0;
       const sourceIdx = args.indexOf("--source");
       const intelligenceSource = sourceIdx !== -1 ? args[sourceIdx + 1] : void 0;
+      const blueprintSetIdx = args.indexOf("--blueprint-set");
+      const rawBlueprintSet = args.includes("--labs") ? "labs" : blueprintSetIdx !== -1 ? args[blueprintSetIdx + 1] : void 0;
+      const blueprintSet = rawBlueprintSet && isPublicBlueprintSet(rawBlueprintSet) ? rawBlueprintSet : void 0;
+      if (rawBlueprintSet && !blueprintSet) {
+        console.error(
+          error3(
+            `Invalid blueprint set "${rawBlueprintSet}". Must be one of: all, featured, certified, labs.`
+          )
+        );
+        process.exitCode = 1;
+        return;
+      }
       if (intelligenceSource && !isContentIntelligenceSource(intelligenceSource)) {
         console.error(
           error3(
@@ -8309,7 +8421,7 @@ async function main() {
         return;
       }
       const recommended = args.includes("--recommended");
-      await cmdSearch(query, type, sort, recommended, intelligenceSource);
+      await cmdSearch(query, type, sort, recommended, intelligenceSource, blueprintSet);
       break;
     }
     case "suggest": {
@@ -8340,7 +8452,7 @@ async function main() {
       if (!type) {
         console.error(
           error3(
-            "Usage: decantr list <type> [--sort <recommended|recent|name>] [--source <authored|benchmark|hybrid>]"
+            "Usage: decantr list <type> [--sort <recommended|recent|name>] [--source <authored|benchmark|hybrid>] [--blueprint-set <all|featured|certified|labs>]"
           )
         );
         process.exitCode = 1;
@@ -8350,6 +8462,18 @@ async function main() {
       const sort = sortIdx !== -1 ? args[sortIdx + 1] : void 0;
       const sourceIdx = args.indexOf("--source");
       const intelligenceSource = sourceIdx !== -1 ? args[sourceIdx + 1] : void 0;
+      const blueprintSetIdx = args.indexOf("--blueprint-set");
+      const rawBlueprintSet = args.includes("--labs") ? "labs" : blueprintSetIdx !== -1 ? args[blueprintSetIdx + 1] : void 0;
+      const blueprintSet = rawBlueprintSet && isPublicBlueprintSet(rawBlueprintSet) ? rawBlueprintSet : void 0;
+      if (rawBlueprintSet && !blueprintSet) {
+        console.error(
+          error3(
+            `Invalid blueprint set "${rawBlueprintSet}". Must be one of: all, featured, certified, labs.`
+          )
+        );
+        process.exitCode = 1;
+        return;
+      }
       if (intelligenceSource && !isContentIntelligenceSource(intelligenceSource)) {
         console.error(
           error3(
@@ -8360,7 +8484,7 @@ async function main() {
         return;
       }
       const recommended = args.includes("--recommended");
-      await cmdList(type, sort, recommended, intelligenceSource);
+      await cmdList(type, sort, recommended, intelligenceSource, blueprintSet);
       break;
     }
     case "showcase": {

package/dist/{chunk-PEGMSXDJ.js → chunk-V3XAQWKD.js}

@@ -133,7 +133,7 @@ var RegistryClient = class {
    * Unified fetch for a content list.
    * Resolution: API -> Cache. Custom items are merged into the list.
    */
-  async fetchContentList(contentType, namespace, sort, recommended, intelligenceSource) {
+  async fetchContentList(contentType, namespace, sort, recommended, intelligenceSource, blueprintSet, labs) {
     let apiItems = [];
     let source = { type: "cache" };
     if (!this.offline) {
@@ -142,7 +142,9 @@ var RegistryClient = class {
           namespace,
           sort,
           recommended,
-          intelligenceSource
+          intelligenceSource,
+          blueprintSet,
+          labs
         });
         apiItems = apiResult.items;
         source = { type: "api", url: this.apiUrl };
@@ -3969,6 +3971,44 @@ function buildFlagsString(options) {
   }
   return flags.join(" ");
 }
+function serializeConstraintValue(value) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function normalizeBlueprintDesignConstraints(designConstraints) {
+  if (!designConstraints || typeof designConstraints !== "object" || Array.isArray(designConstraints)) {
+    return void 0;
+  }
+  const constraints = {};
+  const effects = {};
+  for (const [key, value] of Object.entries(designConstraints)) {
+    if (key === "effects" && value && typeof value === "object" && !Array.isArray(value)) {
+      for (const [effectKey, effectValue] of Object.entries(value)) {
+        const serialized2 = serializeConstraintValue(effectValue);
+        if (serialized2) effects[effectKey] = serialized2;
+      }
+      continue;
+    }
+    const serialized = serializeConstraintValue(value);
+    if (!serialized) continue;
+    if (key === "mode" && typeof value === "string") constraints.mode = value;
+    else if (key === "typography" && typeof value === "string") constraints.typography = value;
+    else if (key === "borders" && typeof value === "string") constraints.borders = value;
+    else if (key === "corners" && typeof value === "string") constraints.corners = value;
+    else if (key === "shadows" && typeof value === "string") constraints.shadows = value;
+    else effects[key] = serialized;
+  }
+  if (Object.keys(effects).length > 0) {
+    constraints.effects = effects;
+  }
+  return Object.keys(constraints).length > 0 ? constraints : void 0;
+}
 function generateTaskContextV4(templateName, essence) {
   const template = loadTemplate(templateName);
   const sections = essence.blueprint.sections;
@@ -4226,8 +4266,11 @@ async function scaffoldProject(projectRoot, options, detected, registry, archety
     if (blueprintData?.personality?.length) {
       essenceV4.dna.personality = typeof blueprintData.personality === "string" ? [blueprintData.personality] : blueprintData.personality;
     }
-    if (blueprintData?.design_constraints) {
-      essenceV4.dna.constraints = blueprintData.design_constraints;
+    const normalizedDesignConstraints = normalizeBlueprintDesignConstraints(
+      blueprintData?.design_constraints
+    );
+    if (normalizedDesignConstraints) {
+      essenceV4.dna.constraints = normalizedDesignConstraints;
     }
     if (blueprintData?.seo_hints) {
       essenceV4.meta.seo = blueprintData.seo_hints;

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-H6TIXG5K.js";
-import "./chunk-PEGMSXDJ.js";
+import "./chunk-HO3OLDPQ.js";
+import "./chunk-V3XAQWKD.js";
 import "./chunk-IEW2QFYI.js";

package/dist/{upgrade-XTTGHFG7.js → upgrade-U2BTWJJJ.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Decantr CLI - scaffold, audit, inspect Project Health, and maintain Decantr projects from the terminal",
   "keywords": [
     "decantr",
@@ -48,10 +48,10 @@
   },
   "dependencies": {
     "ajv": "^8.20.0",
-    "@decantr/registry": "2.0.0",
     "@decantr/essence-spec": "2.0.1",
     "@decantr/core": "2.1.0",
     "@decantr/telemetry": "2.2.1",
+    "@decantr/registry": "2.1.0",
     "@decantr/verifier": "2.1.0"
   },
   "scripts": {