@decantr/cli 2.9.4 → 2.9.5

package/README.md

@@ -189,6 +189,8 @@ decantr workspace health --json --output .decantr/workspace-health.json
 decantr verify --workspace --changed --since origin/main
 ```
 
+In observed Brownfield projects, common section shorthands are accepted for page additions when they resolve unambiguously. For example, `decantr add page app/settings --route /settings --project apps/web` resolves `app` to the single primary section, such as `observed-primary`, so docs and LLM prompts do not have to guess generated section IDs first.
+
 `decantr studio` starts a local-only dashboard powered by the same report. It uses Node built-ins only and serves `GET /`, `GET /api/health`, and `POST /api/refresh`.
 
 ```bash

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "./chunk-GDGZFGMK.js";
+import "./chunk-3KJ46XY7.js";
 import "./chunk-RXF7ZYGK.js";
 import "./chunk-VCUFZB45.js";
 import "./chunk-FACL3NXU.js";

package/dist/{chunk-GDGZFGMK.js → chunk-3KJ46XY7.js}

@@ -1743,6 +1743,7 @@ import { join as join6 } from "path";
 import { isV4 as isV42 } from "@decantr/essence-spec";
 var GREEN = "\x1B[32m";
 var RED = "\x1B[31m";
+var YELLOW = "\x1B[33m";
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
 function readV4Essence(projectRoot) {
@@ -1786,6 +1787,36 @@ function normalizeRoute(route) {
   if (!trimmed || trimmed === "/") return "/";
   return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
 }
+function resolveSectionForPage(sections, requestedSectionId) {
+  const exact = sections.find((section) => section.id === requestedSectionId);
+  if (exact) return { section: exact, resolvedFromAlias: false };
+  const lower = requestedSectionId.toLowerCase();
+  const roleByAlias = {
+    app: "primary",
+    main: "primary",
+    primary: "primary",
+    public: "public",
+    marketing: "public",
+    auth: "gateway",
+    gateway: "gateway",
+    auxiliary: "auxiliary"
+  };
+  const desiredRole = roleByAlias[lower];
+  if (!desiredRole) return null;
+  const roleMatches = sections.filter((section) => section.role === desiredRole);
+  if (roleMatches.length === 1) return { section: roleMatches[0], resolvedFromAlias: true };
+  if (roleMatches.length > 1) return null;
+  const observedMatch = sections.find((section) => section.id === `observed-${desiredRole}`);
+  return observedMatch ? { section: observedMatch, resolvedFromAlias: true } : null;
+}
+function printSectionNotFound(sectionId, sections, pageId) {
+  console.error(`${RED}Section "${sectionId}" not found.${RESET}`);
+  console.error(`${DIM}Available sections: ${sections.map((s) => s.id).join(", ")}${RESET}`);
+  if (pageId && sections.length > 0) {
+    const primary = sections.find((section) => section.role === "primary") ?? sections[0];
+    console.error(`${DIM}Try: decantr add page ${primary.id}/${pageId}${RESET}`);
+  }
+}
 async function cmdAddSection(archetypeId, args, projectRoot = process.cwd()) {
   if (!archetypeId) {
     console.error(`${RED}Usage: decantr add section <archetypeId>${RESET}`);
@@ -1849,15 +1880,18 @@ async function cmdAddPage(path, args, projectRoot = process.cwd()) {
   if (!loaded) return;
   const { essence, essencePath } = loaded;
   const sections = essence.blueprint.sections;
-  const section = sections.find((s) => s.id === sectionId);
-  if (!section) {
-    console.error(`${RED}Section "${sectionId}" not found.${RESET}`);
-    console.error(`${DIM}Available sections: ${sections.map((s) => s.id).join(", ")}${RESET}`);
+  const resolved = resolveSectionForPage(sections, sectionId);
+  if (!resolved) {
+    printSectionNotFound(sectionId, sections, pageId);
     process.exitCode = 1;
     return;
   }
+  const { section } = resolved;
+  const resolvedSectionId = section.id;
   if (section.pages.find((p) => p.id === pageId)) {
-    console.error(`${RED}Page "${pageId}" already exists in section "${sectionId}".${RESET}`);
+    console.error(
+      `${RED}Page "${pageId}" already exists in section "${resolvedSectionId}".${RESET}`
+    );
     process.exitCode = 1;
     return;
   }
@@ -1877,10 +1911,15 @@ async function cmdAddPage(path, args, projectRoot = process.cwd()) {
     route,
     layout: ["hero"]
   });
-  routes[route] = { section: sectionId, page: pageId };
+  routes[route] = { section: resolvedSectionId, page: pageId };
   writeEssence(essencePath, essence);
+  if (resolved.resolvedFromAlias) {
+    console.log(
+      `${YELLOW}Resolved section alias "${sectionId}" to "${resolvedSectionId}".${RESET}`
+    );
+  }
   console.log(
-    `${GREEN}Added page "${pageId}" to section "${sectionId}" at route "${route}".${RESET}`
+    `${GREEN}Added page "${pageId}" to section "${resolvedSectionId}" at route "${route}".${RESET}`
   );
   const registryClient = new RegistryClient({
     cacheDir: join6(projectRoot, ".decantr", "cache")
@@ -2958,7 +2997,7 @@ var DIM2 = "\x1B[2m";
 var RESET2 = "\x1B[0m";
 var GREEN2 = "\x1B[32m";
 var CYAN = "\x1B[36m";
-var YELLOW = "\x1B[33m";
+var YELLOW2 = "\x1B[33m";
 async function cmdAnalyze(projectRoot = process.cwd(), workspace) {
   const startedAt = Date.now();
   console.log(`
@@ -3126,7 +3165,7 @@ ${DIM2}Written to:${RESET2} ${outputPath}`);
   console.log(`${DIM2}Enrichment backlog:${RESET2} ${intelligenceArtifacts.backlogPath}`);
   console.log(
     `
-${YELLOW}Next step:${RESET2} Review ${BOLD}${reportDisplayPath}${RESET2}, then run ${BOLD}${recommendedAttachCommand}${RESET2} to attach Decantr using the observed proposal.
+${YELLOW2}Next step:${RESET2} Review ${BOLD}${reportDisplayPath}${RESET2}, then run ${BOLD}${recommendedAttachCommand}${RESET2} to attach Decantr using the observed proposal.
 `
   );
   await sendAnalyzeCompletedTelemetry({
@@ -4257,7 +4296,7 @@ var BOLD3 = "\x1B[1m";
 var DIM4 = "\x1B[2m";
 var GREEN4 = "\x1B[32m";
 var RED3 = "\x1B[31m";
-var YELLOW2 = "\x1B[33m";
+var YELLOW3 = "\x1B[33m";
 var CYAN2 = "\x1B[36m";
 var RESET4 = "\x1B[0m";
 function readJson2(path) {
@@ -4596,7 +4635,7 @@ function buildDoctorReport(root, args) {
 function colorForStatus(status) {
   if (status === "healthy") return GREEN4;
   if (status === "needs-setup" || status === "needs-migration") return RED3;
-  return YELLOW2;
+  return YELLOW3;
 }
 function formatDoctorText(report) {
   const lines = [
@@ -4640,7 +4679,7 @@ function formatDoctorText(report) {
     lines.push(`  ${GREEN4}No doctor findings.${RESET4}`);
   } else {
     for (const issue of report.issues) {
-      const color = issue.severity === "error" ? RED3 : issue.severity === "warn" ? YELLOW2 : CYAN2;
+      const color = issue.severity === "error" ? RED3 : issue.severity === "warn" ? YELLOW3 : CYAN2;
       lines.push(
         `  ${color}[${issue.severity.toUpperCase()}]${RESET4} ${issue.category}: ${issue.message}`
       );
@@ -4946,7 +4985,7 @@ var DIM6 = "\x1B[2m";
 var RESET6 = "\x1B[0m";
 var GREEN6 = "\x1B[32m";
 var CYAN3 = "\x1B[36m";
-var YELLOW3 = "\x1B[33m";
+var YELLOW4 = "\x1B[33m";
 var MAGENTA = "\x1B[35m";
 function success(text) {
   return `${GREEN6}${text}${RESET6}`;
@@ -5167,7 +5206,7 @@ async function cmdMagic(prompt, projectRoot, options) {
   const essencePath = join20(projectRoot, "decantr.essence.json");
   if (existsSync18(essencePath)) {
     const projectFlag = options.projectLabel ? ` --project ${options.projectLabel}` : "";
-    console.log(`${YELLOW3} Decantr is already attached to this project.${RESET6}`);
+    console.log(`${YELLOW4} Decantr is already attached to this project.${RESET6}`);
     console.log(
       dim(" decantr magic is greenfield-first; use task-time context for existing apps.")
     );
@@ -5180,7 +5219,7 @@ async function cmdMagic(prompt, projectRoot, options) {
   }
   const detected = detectProject(projectRoot);
   if (hasExistingProjectFootprint(detected)) {
-    console.log(`${YELLOW3} Existing project detected.${RESET6}`);
+    console.log(`${YELLOW4} Existing project detected.${RESET6}`);
     console.log(
       dim(
         " decantr magic stays greenfield-first and will not silently bootstrap over an existing app."
@@ -5490,7 +5529,7 @@ ${GREEN6}${BOLD4}Quality summary:${RESET6}`);
   );
   console.log(`  CSS:             tokens.css + treatments.css + global.css`);
   console.log(
-    `  @layer cascade:  ${hasLayers ? GREEN6 + "yes" + RESET6 : YELLOW3 + "missing" + RESET6}`
+    `  @layer cascade:  ${hasLayers ? GREEN6 + "yes" + RESET6 : YELLOW4 + "missing" + RESET6}`
   );
   console.log("");
   console.log(`${BOLD4} Ready!${RESET6} Next steps:`);
@@ -5519,7 +5558,7 @@ import {
 } from "@decantr/essence-spec";
 var GREEN7 = "\x1B[32m";
 var RED5 = "\x1B[31m";
-var YELLOW4 = "\x1B[33m";
+var YELLOW5 = "\x1B[33m";
 var RESET7 = "\x1B[0m";
 var DIM7 = "\x1B[2m";
 function migrateEssenceFile(essencePath) {
@@ -5619,7 +5658,7 @@ async function cmdMigrate(projectRoot = process.cwd(), args = []) {
     console.log(`${GREEN7}Derived context and execution packs refreshed.${RESET7}`);
   }
   console.log("");
-  console.log(`${YELLOW4}Review the migrated file and run \`decantr check\` to verify.${RESET7}`);
+  console.log(`${YELLOW5}Review the migrated file and run \`decantr check\` to verify.${RESET7}`);
 }
 
 // src/commands/new-project.ts
@@ -5686,7 +5725,7 @@ var RESET8 = "\x1B[0m";
 var RED6 = "\x1B[31m";
 var GREEN8 = "\x1B[32m";
 var CYAN4 = "\x1B[36m";
-var YELLOW5 = "\x1B[33m";
+var YELLOW6 = "\x1B[33m";
 function heading(text) {
   return `
 ${BOLD5}${text}${RESET8}
@@ -5836,7 +5875,7 @@ async function cmdNewProject(projectName, options) {
     );
   } else {
     console.log(
-      `${YELLOW5}  No greenfield bootstrap adapter is available yet for target "${bootstrapTarget.target}" (${bootstrapTarget.packAdapter}).${RESET8}`
+      `${YELLOW6}  No greenfield bootstrap adapter is available yet for target "${bootstrapTarget.target}" (${bootstrapTarget.packAdapter}).${RESET8}`
     );
     console.log(
       dim2(
@@ -5852,7 +5891,7 @@ async function cmdNewProject(projectName, options) {
     } catch {
       console.log(
         `
-${YELLOW5}Dependency install failed. Run \`${packageManager} install\` manually.${RESET8}`
+${YELLOW6}Dependency install failed. Run \`${packageManager} install\` manually.${RESET8}`
       );
     }
   }
@@ -5864,7 +5903,7 @@ ${YELLOW5}Dependency install failed. Run \`${packageManager} install\` manually.
     console.log(dim2(`  Seeded offline registry content from ${seeded.strategy}.`));
   } else if (requiresOfflineContent) {
     console.log(
-      `${YELLOW5}  Offline blueprint/archetype resolution requires local registry content.${RESET8}`
+      `${YELLOW6}  Offline blueprint/archetype resolution requires local registry content.${RESET8}`
     );
     console.log(
       dim2(
@@ -5894,7 +5933,7 @@ ${YELLOW5}Dependency install failed. Run \`${packageManager} install\` manually.
   } catch {
     console.log(
       `
-${YELLOW5}Decantr init encountered issues. Run \`decantr init\` manually inside ${projectName}/.${RESET8}`
+${YELLOW6}Decantr init encountered issues. Run \`decantr init\` manually inside ${projectName}/.${RESET8}`
     );
   }
   console.log(success2(`
@@ -6237,7 +6276,7 @@ var GREEN10 = "\x1B[32m";
 var RED8 = "\x1B[31m";
 var DIM10 = "\x1B[2m";
 var CYAN5 = "\x1B[36m";
-var YELLOW6 = "\x1B[33m";
+var YELLOW7 = "\x1B[33m";
 var RESET10 = "\x1B[0m";
 var ALL_CONTENT_TYPES = [...API_CONTENT_TYPES];
 async function cmdRegistryMirror(projectRoot, options = {}) {
@@ -6301,7 +6340,7 @@ Mirroring registry content to ${DIM10}.decantr/cache/${RESET10}
   const totalItems = Object.values(counts).reduce((a, b) => a + b, 0);
   console.log("");
   if (failed.length > 0) {
-    console.log(`${YELLOW6}Mirrored ${totalItems} items (${failed.length} type(s) failed)${RESET10}`);
+    console.log(`${YELLOW7}Mirrored ${totalItems} items (${failed.length} type(s) failed)${RESET10}`);
   } else {
     console.log(
       `${GREEN10}Mirrored ${totalItems} items across ${Object.keys(counts).length} types${RESET10}`
@@ -6489,7 +6528,7 @@ import { existsSync as existsSync26, readFileSync as readFileSync19, writeFileSy
 import { join as join28 } from "path";
 var GREEN12 = "\x1B[32m";
 var RED10 = "\x1B[31m";
-var YELLOW7 = "\x1B[33m";
+var YELLOW8 = "\x1B[33m";
 var RESET12 = "\x1B[0m";
 var DIM12 = "\x1B[2m";
 var BOLD6 = "\x1B[1m";
@@ -6530,7 +6569,7 @@ ${BOLD6}Unresolved Drift Entries (${unresolved.length})${RESET12}
 `);
   for (let i = 0; i < unresolved.length; i++) {
     const entry = unresolved[i];
-    const severityColor = entry.severity === "error" ? RED10 : YELLOW7;
+    const severityColor = entry.severity === "error" ? RED10 : YELLOW8;
     const icon = entry.severity === "error" ? "x" : "!";
     console.log(
       `  ${severityColor}${icon}${RESET12} ${BOLD6}#${i + 1}${RESET12} [${entry.rule}] ${entry.message}`
@@ -6814,7 +6853,7 @@ import { join as join29 } from "path";
 import { isV4 as isV48 } from "@decantr/essence-spec";
 var GREEN14 = "\x1B[32m";
 var RED11 = "\x1B[31m";
-var YELLOW8 = "\x1B[33m";
+var YELLOW9 = "\x1B[33m";
 var DIM14 = "\x1B[2m";
 var RESET14 = "\x1B[0m";
 var VALID_THEME_SHAPES = ["sharp", "rounded", "pill"];
@@ -6909,7 +6948,7 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   console.log(
     `${GREEN14}Derived files refreshed (tokens.css, treatments.css, all contexts).${RESET14}`
   );
-  console.log(`${YELLOW8}Guard will flag code using old tokens. Run \`decantr check\`.${RESET14}`);
+  console.log(`${YELLOW9}Guard will flag code using old tokens. Run \`decantr check\`.${RESET14}`);
 }
 
 // src/prompts.ts
@@ -6918,7 +6957,7 @@ var BOLD8 = "\x1B[1m";
 var DIM15 = "\x1B[2m";
 var RESET15 = "\x1B[0m";
 var GREEN15 = "\x1B[32m";
-var YELLOW9 = "\x1B[33m";
+var YELLOW10 = "\x1B[33m";
 var CYAN8 = "\x1B[36m";
 function ask(question, defaultValue) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -6958,7 +6997,7 @@ async function confirm(question, defaultYes = true) {
 }
 function warn(message) {
   console.log(`
-${YELLOW9}  Warning: ${message}${RESET15}`);
+${YELLOW10}  Warning: ${message}${RESET15}`);
 }
 function showDetection(detected) {
   console.log(`
@@ -6977,7 +7016,7 @@ ${CYAN8}Detected project configuration:${RESET15}`);
     console.log(`  Tailwind CSS: ${GREEN15}yes${RESET15}`);
   }
   if (detected.existingEssence) {
-    console.log(`  Existing essence: ${YELLOW9}yes${RESET15}`);
+    console.log(`  Existing essence: ${YELLOW10}yes${RESET15}`);
   }
 }
 async function runInteractivePrompts(detected, archetypes, blueprints, themes, workflowSeed) {
@@ -7379,7 +7418,7 @@ var RESET16 = "\x1B[0m";
 var RED12 = "\x1B[31m";
 var GREEN16 = "\x1B[32m";
 var CYAN9 = "\x1B[36m";
-var YELLOW10 = "\x1B[33m";
+var YELLOW11 = "\x1B[33m";
 function heading2(text) {
   return `
 ${BOLD9}${text}${RESET16}
@@ -8422,7 +8461,7 @@ function printBlueprintPortfolioNotice(blueprint) {
   if (!portfolio) return;
   if (portfolio.visibility === "hidden" || portfolio.maturity === "fold-candidate") {
     console.log(
-      `${YELLOW10}  Warning:${RESET16} blueprint "${blueprint.id}" is folded out of public browsing.`
+      `${YELLOW11}  Warning:${RESET16} blueprint "${blueprint.id}" is folded out of public browsing.`
     );
     if (portfolio.recommended_alternative) {
       console.log(
@@ -8435,7 +8474,7 @@ function printBlueprintPortfolioNotice(blueprint) {
   }
   if (portfolio.visibility === "labs") {
     console.log(
-      `${YELLOW10}  Note:${RESET16} blueprint "${blueprint.id}" is a Labs blueprint; direct scaffolding is supported, but it is not a default recommendation yet.`
+      `${YELLOW11}  Note:${RESET16} blueprint "${blueprint.id}" is a Labs blueprint; direct scaffolding is supported, but it is not a default recommendation yet.`
     );
   }
 }
@@ -8724,7 +8763,7 @@ async function cmdValidate(path) {
       console.log(heading2("Guard violations:"));
       for (const v of violations) {
         const vr = v;
-        console.log(`  ${YELLOW10}[${vr.rule}]${RESET16} ${vr.message}`);
+        console.log(`  ${YELLOW11}[${vr.rule}]${RESET16} ${vr.message}`);
         if (vr.suggestion) {
           console.log(`    ${DIM16}Suggestion: ${vr.suggestion}${RESET16}`);
         }
@@ -9058,7 +9097,7 @@ async function cmdInit(args) {
     console.log(dim3("  Found .decantr/init-seed.json brownfield guidance."));
   }
   if (detected.existingEssence && !args.existing) {
-    console.log(`${YELLOW10}Warning: decantr.essence.json already exists.${RESET16}`);
+    console.log(`${YELLOW11}Warning: decantr.essence.json already exists.${RESET16}`);
     const overwrite = await confirm("Overwrite existing configuration?", false);
     if (!overwrite) {
       console.log(dim3("Cancelled."));
@@ -9161,7 +9200,7 @@ async function cmdInit(args) {
   } else if (shouldUseRegistry && !apiAvailable) {
     if (!args.blueprint) {
       console.log(`
-${YELLOW10}You're offline. Scaffolding minimal Decantr project.${RESET16}`);
+${YELLOW11}You're offline. Scaffolding minimal Decantr project.${RESET16}`);
       console.log(
         dim3("Run `decantr sync` or `decantr upgrade` when online to pull full registry content.\n")
       );
@@ -9210,7 +9249,7 @@ ${YELLOW10}You're offline. Scaffolding minimal Decantr project.${RESET16}`);
       return;
     }
     console.log(`
-${YELLOW10}You're offline. Scaffolding Decantr default.${RESET16}`);
+${YELLOW11}You're offline. Scaffolding Decantr default.${RESET16}`);
     console.log(dim3("Run `decantr upgrade` when online, or visit decantr.ai/registry\n"));
     selectedBlueprint = "default";
   } else if (shouldUseRegistry) {
@@ -9392,7 +9431,7 @@ ${YELLOW10}You're offline. Scaffolding Decantr default.${RESET16}`);
         return;
       }
       console.log(
-        `${YELLOW10}  Warning: Could not fetch blueprint "${options.blueprint}". Using defaults.${RESET16}`
+        `${YELLOW11}  Warning: Could not fetch blueprint "${options.blueprint}". Using defaults.${RESET16}`
       );
     }
   } else if (shouldUseRegistry && options.archetype) {
@@ -9407,7 +9446,7 @@ ${YELLOW10}You're offline. Scaffolding Decantr default.${RESET16}`);
         return;
       }
       console.log(
-        `${YELLOW10}  Warning: Could not fetch archetype "${options.archetype}". Using defaults.${RESET16}`
+        `${YELLOW11}  Warning: Could not fetch archetype "${options.archetype}". Using defaults.${RESET16}`
       );
     }
   }
@@ -9424,7 +9463,7 @@ ${YELLOW10}You're offline. Scaffolding Decantr default.${RESET16}`);
         return;
       }
       console.log(
-        `${YELLOW10}  Warning: Could not fetch theme "${options.theme}". Using defaults.${RESET16}`
+        `${YELLOW11}  Warning: Could not fetch theme "${options.theme}". Using defaults.${RESET16}`
       );
     }
   }
@@ -9629,7 +9668,7 @@ async function cmdStatus(projectRoot = process.cwd()) {
         `    Guard: ${v4.meta.guard.mode} (DNA: ${v4.meta.guard.dna_enforcement}, Blueprint: ${v4.meta.guard.blueprint_enforcement})`
       );
     } else {
-      console.log(`  ${YELLOW10}Run \`decantr migrate --to v4\` to upgrade this project.${RESET16}`);
+      console.log(`  ${YELLOW11}Run \`decantr migrate --to v4\` to upgrade this project.${RESET16}`);
     }
   } catch (e) {
     console.log(`  ${RED12}Error reading essence: ${e.message}${RESET16}`);
@@ -9642,15 +9681,15 @@ async function cmdStatus(projectRoot = process.cwd()) {
       const syncStatus = projectJson.sync?.status || "unknown";
       const lastSync = projectJson.sync?.lastSync || "never";
       const source = projectJson.sync?.registrySource || "unknown";
-      const statusColor = syncStatus === "synced" ? GREEN16 : YELLOW10;
+      const statusColor = syncStatus === "synced" ? GREEN16 : YELLOW11;
       console.log(`  Status: ${statusColor}${syncStatus}${RESET16}`);
       console.log(`  Last sync: ${dim3(lastSync)}`);
       console.log(`  Source: ${dim3(source)}`);
     } catch {
-      console.log(`  ${YELLOW10}Could not read project.json${RESET16}`);
+      console.log(`  ${YELLOW11}Could not read project.json${RESET16}`);
     }
   } else {
-    console.log(`  ${YELLOW10}No .decantr/project.json found${RESET16}`);
+    console.log(`  ${YELLOW11}No .decantr/project.json found${RESET16}`);
     console.log(dim3('  Run "decantr init" to create project files.'));
   }
 }
@@ -9663,12 +9702,12 @@ async function cmdSync() {
     console.log(success3("Sync completed successfully."));
     console.log(`  Synced: ${result.synced.join(", ")}`);
     if (result.failed.length > 0) {
-      console.log(`  ${YELLOW10}Failed: ${result.failed.join(", ")}${RESET16}`);
+      console.log(`  ${YELLOW11}Failed: ${result.failed.join(", ")}${RESET16}`);
     }
   } else {
-    console.log(`${YELLOW10}Could not sync: API unavailable${RESET16}`);
+    console.log(`${YELLOW11}Could not sync: API unavailable${RESET16}`);
     if (result.failed.length > 0) {
-      console.log(`  ${YELLOW10}Failed: ${result.failed.join(", ")}${RESET16}`);
+      console.log(`  ${YELLOW11}Failed: ${result.failed.join(", ")}${RESET16}`);
     }
   }
 }
@@ -9678,7 +9717,7 @@ function printVerificationFindings(findings) {
     return;
   }
   for (const finding of findings) {
-    const color = finding.severity === "error" ? RED12 : finding.severity === "warn" ? YELLOW10 : CYAN9;
+    const color = finding.severity === "error" ? RED12 : finding.severity === "warn" ? YELLOW11 : CYAN9;
     console.log(
       `  ${color}[${finding.severity.toUpperCase()}]${RESET16} ${finding.category}: ${finding.message}`
     );
@@ -10319,7 +10358,7 @@ async function cmdAdoptWorkflow(args) {
         )
       );
     } catch (e) {
-      console.log(`${YELLOW10}Pack hydration skipped:${RESET16} ${e.message}`);
+      console.log(`${YELLOW11}Pack hydration skipped:${RESET16} ${e.message}`);
       console.log(
         dim3(
           `Run ${compilePacksCommandForProject(projectArg)} after adoption if you want hosted page/review packs.`
@@ -10452,7 +10491,7 @@ async function cmdVerifyWorkflow(args) {
       if (!quietOutput) {
         console.log("");
         console.log(
-          `${YELLOW10}Local pattern pack missing.${RESET16} Run ${cyan3(withProject("decantr codify --from-audit", projectArg))}, review the proposal, then run ${cyan3(withProject("decantr codify --accept", projectArg))}.`
+          `${YELLOW11}Local pattern pack missing.${RESET16} Run ${cyan3(withProject("decantr codify --from-audit", projectArg))}, review the proposal, then run ${cyan3(withProject("decantr codify --accept", projectArg))}.`
         );
       }
       process.exitCode = process.exitCode || 1;
@@ -10468,11 +10507,11 @@ async function cmdVerifyWorkflow(args) {
           console.log(`${GREEN16}Local rule manifest found:${RESET16} ${validation.rulesPath}`);
         } else {
           console.log(
-            `${YELLOW10}Local rule manifest missing.${RESET16} Run ${cyan3("decantr codify --from-audit")} to propose .decantr/rules.json.`
+            `${YELLOW11}Local rule manifest missing.${RESET16} Run ${cyan3("decantr codify --from-audit")} to propose .decantr/rules.json.`
           );
         }
         for (const warning of validation.warnings.slice(0, 8)) {
-          console.log(`${YELLOW10}warn${RESET16} ${warning}`);
+          console.log(`${YELLOW11}warn${RESET16} ${warning}`);
         }
         if (validation.findings.length > 0) {
           console.log("");
@@ -10625,7 +10664,7 @@ async function cmdTaskWorkflow(args) {
     console.log("");
     console.log(`${BOLD9}Project-owned local law:${RESET16}`);
     console.log(
-      `  ${YELLOW10}Not codified yet.${RESET16} Run ${cyan3(withProject("decantr codify --from-audit", projectArg))} after adoption.`
+      `  ${YELLOW11}Not codified yet.${RESET16} Run ${cyan3(withProject("decantr codify --from-audit", projectArg))} after adoption.`
     );
   }
   if (context.changedFiles.length > 0) {
@@ -11424,7 +11463,7 @@ async function main() {
     case "heal": {
       if (command === "heal") {
         console.log(
-          `${YELLOW10}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET16}`
+          `${YELLOW11}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET16}`
         );
       }
       const { cmdHeal } = await import("./heal-ZQHEHBUJ.js");

package/dist/index.js

@@ -1,4 +1,4 @@
-import "./chunk-GDGZFGMK.js";
+import "./chunk-3KJ46XY7.js";
 import "./chunk-RXF7ZYGK.js";
 import "./chunk-VCUFZB45.js";
 import "./chunk-FACL3NXU.js";

package/package.json

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