@decantr/cli 2.4.1 → 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-6BRD6DTB.js";
-import "./chunk-P4NUDLWB.js";
+import "./chunk-HO3OLDPQ.js";
+import "./chunk-V3XAQWKD.js";
 import "./chunk-IEW2QFYI.js";

package/dist/{chunk-6BRD6DTB.js → chunk-HO3OLDPQ.js}

@@ -14,7 +14,7 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-P4NUDLWB.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";
@@ -6528,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({
@@ -6536,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) {
@@ -6551,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 {
@@ -6690,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(", ")}`)
@@ -6706,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) {
@@ -6742,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)}`);
+      }
     }
   }
 }
@@ -7179,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;
@@ -8227,7 +8278,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-HSPWYROM.js");
+      const { cmdUpgrade } = await import("./upgrade-U2BTWJJJ.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;
@@ -8336,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;
@@ -8348,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(
@@ -8358,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": {
@@ -8389,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;
@@ -8399,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(
@@ -8409,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-P4NUDLWB.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 };

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-6BRD6DTB.js";
-import "./chunk-P4NUDLWB.js";
+import "./chunk-HO3OLDPQ.js";
+import "./chunk-V3XAQWKD.js";
 import "./chunk-IEW2QFYI.js";

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

@@ -1,7 +1,7 @@
 import {
   RegistryClient,
   refreshDerivedFiles
-} from "./chunk-P4NUDLWB.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.1",
+  "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/core": "2.1.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": {