@decantr/cli 2.10.0 → 2.11.0

package/README.md

@@ -80,7 +80,7 @@ pnpm exec decantr ci init --project apps/web
 
 Assistant rule integration is preview-first: `--assistant-bridge=preview` writes `.decantr/context/assistant-bridge.md`, `decantr rules preview` prints the bridge, and `--assistant-bridge=apply` or `decantr rules apply` mutates supported rule files with idempotent marked blocks.
 
-Brownfield analysis also writes `.decantr/doctrine-map.json`, a ranked source-precedence map across security/data, architecture, design-system, workflow/CI, feature/business, assistant-specific, stale, and unsafe-to-cite evidence. It also writes `.decantr/brownfield-intelligence.json`, `.decantr/theme-inventory.json`, and `.decantr/enrichment-backlog.md`. The proposal groups routes into observed semantic domains such as auth, RBAC, billing, reporting, facilities, settings, and public surfaces across Next App/Pages Router, React Router, Angular Router, SvelteKit, Vue Router, and Nuxt file routes. Existing styling systems such as Tailwind, Bootstrap, MUI, Chakra, plain CSS, and Decantr CSS are observed as evidence instead of replaced. Theme variants are observed in the theme inventory without changing Essence V4. `decantr codify --from-audit` proposes `.decantr/local-patterns.proposal.json` and `.decantr/rules.proposal.json` with Hybrid authority guidance; after review, `decantr codify --accept` promotes `.decantr/local-patterns.json` and `.decantr/rules.json`. `decantr doctor` reports whether the app is contract-only, Hybrid local law, style bridge, Decantr CSS, or Hybrid composition. `decantr task` prints that authority block and warns before mixing runtimes or adding Decantr CSS to a non-Decantr-CSS app. `decantr verify --brownfield --local-patterns` uses the Brownfield guard layer plus accepted local law to flag actionable missing doctrine coverage, unsafe context, missing assistant bridges, style drift, raw local-rule violations, and unsafe defaults without treating current database migrations as stale docs.
+Brownfield analysis also writes `.decantr/doctrine-map.json`, a ranked source-precedence map across security/data, architecture, design-system, workflow/CI, feature/business, assistant-specific, stale, and unsafe-to-cite evidence. It also writes `.decantr/brownfield-intelligence.json`, `.decantr/theme-inventory.json`, and `.decantr/enrichment-backlog.md`. The proposal groups routes into observed semantic domains such as auth, RBAC, billing, reporting, facilities, settings, and public surfaces across Next App/Pages Router, React Router, Angular Router, SvelteKit, Vue Router, and Nuxt file routes. Existing styling systems such as Tailwind, Bootstrap, MUI, Chakra, plain CSS, and Decantr CSS are observed as evidence instead of replaced. Theme variants are observed in the theme inventory without changing Essence V4. `decantr codify --from-audit` proposes `.decantr/local-patterns.proposal.json` and `.decantr/rules.proposal.json` with Hybrid authority guidance and source-derived button/card class hints; after review, `decantr codify --accept` promotes `.decantr/local-patterns.json` and `.decantr/rules.json`. `decantr doctor` reports whether the app is contract-only, Hybrid local law, style bridge, Decantr CSS, or Hybrid composition. `decantr task` prints that authority block and warns before mixing runtimes or adding Decantr CSS to a non-Decantr-CSS app. `decantr suggest --from-code` surfaces accepted local patterns from the app root or selected `--project`, and `decantr ci` prints accepted local-rule findings with file/line evidence. `decantr verify --brownfield --local-patterns` uses the Brownfield guard layer plus accepted local law to flag actionable missing doctrine coverage, unsafe context, missing assistant bridges, style drift, raw local-rule violations, and unsafe defaults without treating current database migrations as stale docs.
 
 ## What It Does
 
@@ -117,6 +117,7 @@ decantr task /feed "add saved recipe actions"
 decantr verify --brownfield --local-patterns
 decantr verify --base-url http://localhost:3000 --evidence
 decantr ci --project apps/web
+decantr ci --project apps/web --fail-on warn
 decantr ci --workspace --changed --since origin/main
 decantr ci init --project apps/web
 decantr init --existing --blueprint=esports-hq

package/dist/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import "./chunk-HQUTNZKF.js";
+import "./chunk-ET4BG746.js";
 import "./chunk-IQZCIMQJ.js";
-import "./chunk-QDMXZSVK.js";
-import "./chunk-WPP3JEMC.js";
+import "./chunk-NUNUW5IS.js";
+import "./chunk-5WPRTVNA.js";
 import "./chunk-4SZ4SEKT.js";

package/dist/{chunk-WPP3JEMC.js → chunk-5WPRTVNA.js}

@@ -713,7 +713,7 @@ async function collectBrowserVerification(projectRoot, options, declaredRoutes)
       message: "Browser verification was requested, but Playwright is not installed in this project.",
       evidence: ["Expected dependency: playwright or @playwright/test"],
       rule: "browser-playwright-missing",
-      suggestedFix: "Install Playwright in the project or rerun without `--browser` for static-only evidence.",
+      suggestedFix: "Install Playwright in the project or omit browser/base-url evidence for static-only health checks.",
       baseId: "playwright-missing"
     });
     return {
@@ -1404,7 +1404,7 @@ async function cmdHealth(projectRoot = process.cwd(), options = {}) {
         const reason = evidenceBundle.browser.findings[0] ?? "Playwright is not available to Decantr in this project.";
         console.log(`${YELLOW}Browser evidence unavailable:${RESET} ${reason}`);
         console.log(
-          `${DIM}Static evidence was still written. Install Playwright or rerun without --browser if screenshots are not needed.${RESET}`
+          `${DIM}Static evidence was still written. Install Playwright or omit --browser/--base-url evidence if screenshots are not needed.${RESET}`
         );
       }
     }

package/dist/{chunk-HQUTNZKF.js → chunk-ET4BG746.js}

@@ -22,14 +22,14 @@ import {
   listWorkspaceCandidates,
   listWorkspaceProjects,
   shouldFailWorkspaceHealth
-} from "./chunk-QDMXZSVK.js";
+} from "./chunk-NUNUW5IS.js";
 import {
   createProjectHealthReport,
   formatProjectHealthMarkdown,
   formatProjectHealthText,
   resolveWorkspaceInfo,
   shouldFailHealth
-} from "./chunk-WPP3JEMC.js";
+} from "./chunk-5WPRTVNA.js";
 import {
   buildGuardRegistryContext,
   createDoctrineMap,
@@ -2549,6 +2549,17 @@ function collectCssFiles(projectRoot) {
 function selectorFromMatch(raw) {
   return raw.replace(/\s+/g, " ").trim().slice(0, 120);
 }
+function isThemeVariantClass(id, selector) {
+  if (/^(switcher|toggle|selector|picker|menu|button|btn|control|provider|container|panel|card|icon|label|group|actions?)$/i.test(
+    id
+  )) {
+    return false;
+  }
+  const selectors = selector.split(",").map((entry) => entry.trim());
+  return selectors.some(
+    (entry) => /^(?::root|html|body)?(?:\.[\w-]+)*\.theme-[a-z0-9-]+(?:\s|$|:|\[|\.)/i.test(entry)
+  );
+}
 function createThemeInventory(projectRoot, styling) {
   const files = collectCssFiles(projectRoot);
   const variantMap = /* @__PURE__ */ new Map();
@@ -2582,8 +2593,12 @@ function createThemeInventory(projectRoot, styling) {
       const themeClass = selector.match(/\.theme-([a-z0-9-]+)/i);
       if (/dark/i.test(selector)) id = "dark";
       if (dataTheme?.[1]) id = dataTheme[1].toLowerCase();
-      if (themeClass?.[1]) id = themeClass[1].toLowerCase();
-      if (selector.includes(":root")) id = "base";
+      if (themeClass?.[1]) {
+        const classId = themeClass[1].toLowerCase();
+        if (!isThemeVariantClass(classId, selector)) continue;
+        id = classId;
+      }
+      if (/^:root(?:\s|$|,)/.test(selector)) id = "base";
       ensureVariant(id, selector, rel2);
     }
     for (const [id, entry] of variantMap) {
@@ -2617,6 +2632,7 @@ function createThemeInventory(projectRoot, styling) {
   }
   const variants = [...variantMap.values()].sort((a, b) => a.id.localeCompare(b.id));
   const modes = variants.map((variant) => variant.id);
+  const darkModeDetected = styling.darkMode || modes.includes("dark") || variants.some((variant) => /dark/i.test(variant.id));
   if (variants.length > 2) {
     notes.push(
       "Multiple theme variants were observed. Essence V4 remains unchanged; variants are reported here for task-time context."
@@ -2627,7 +2643,7 @@ function createThemeInventory(projectRoot, styling) {
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     localOnly: true,
     stylingApproach: styling.approach,
-    darkModeDetected: styling.darkMode,
+    darkModeDetected,
     modes,
     variants,
     tokens: {
@@ -3309,7 +3325,8 @@ function createBrownfieldCodifyProposal(input) {
         ],
         componentPaths: evidence.buttonComponents,
         decide: "Define primary, secondary, tertiary, destructive, icon-only, disabled, and loading button variants from this app.",
-        evidence: evidence.buttonComponents.length ? evidence.buttonComponents : [
+        classHints: evidence.buttonClassHints,
+        evidence: evidence.buttonComponents.length ? evidence.buttonComponents : evidence.buttonClassHints.length ? evidence.buttonClassHints : [
           "No obvious Button wrapper found yet. Add the project-owned wrapper path before strict enforcement."
         ],
         forbiddenAlternatives: ["New one-off button variants without updating this manifest."]
@@ -3635,11 +3652,27 @@ function summarizeSourceEvidence(projectRoot, files) {
     formComponents: byName(["input", "field", "form", "select", "textarea"]),
     shellComponents,
     themeComponents,
+    buttonClassHints: collectClassHints(projectRoot, files, [
+      "button",
+      "btn",
+      "action",
+      "primary",
+      "secondary",
+      "tertiary",
+      "ghost",
+      "link"
+    ]),
     cardClassHints: collectClassHints(projectRoot, files, ["card", "panel", "surface", "tile"])
   };
 }
 function collectClassHints(projectRoot, files, terms) {
   const hints = /* @__PURE__ */ new Map();
+  const wantsButton = terms.some(
+    (term) => /^(button|btn|action|primary|secondary|tertiary|ghost|link)$/i.test(term)
+  );
+  const wantsSurface = terms.some((term) => /^(card|panel|surface|tile)$/i.test(term));
+  const buttonSignal = /button|btn|action|primary|secondary|tertiary|ghost|link|destructive|icon/i;
+  const surfaceSignal = /card|panel|surface|tile|rounded|shadow|border|bg-|p-\d|px-|py-/i;
   for (const file of files) {
     if (!UI_TEMPLATE_EXTENSIONS.has(extname(file.absolute))) continue;
     const content = readFileSync11(join15(projectRoot, file.relative), "utf-8");
@@ -3647,7 +3680,8 @@ function collectClassHints(projectRoot, files, terms) {
     const matches = content.matchAll(/\bclass(?:Name)?\s*=\s*["'`]([^"'`]+)["'`]/g);
     for (const match of matches) {
       const value = match[1].trim();
-      if (!/(card|panel|surface|rounded|shadow|border|bg-|p-\d|px-|py-)/i.test(value)) continue;
+      const keep = wantsButton && buttonSignal.test(value) || wantsSurface && surfaceSignal.test(value) || !wantsButton && !wantsSurface && (buttonSignal.test(value) || surfaceSignal.test(value));
+      if (!keep) continue;
       hints.set(value, (hints.get(value) ?? 0) + 1);
     }
   }
@@ -3845,6 +3879,16 @@ function summarizeLocalLaw(projectRoot) {
     checked: validation.patternPackPresent || validation.ruleManifestPresent,
     patternsPresent: validation.patternPackPresent,
     rulesPresent: validation.ruleManifestPresent,
+    warnings: validation.warnings,
+    findings: validation.findings.map((finding) => ({
+      ruleId: finding.ruleId,
+      severity: finding.severity,
+      file: finding.file,
+      line: finding.line,
+      column: finding.column,
+      message: finding.message,
+      suggestedFix: finding.suggestedFix
+    })),
     errorCount: validation.findings.filter((finding) => finding.severity === "error").length,
     warnCount: validation.findings.filter((finding) => finding.severity === "warn").length + validation.warnings.length
   };
@@ -3854,6 +3898,74 @@ function localLawFails(summary, failOn) {
   if (summary.errorCount > 0) return true;
   return failOn === "warn" && summary.warnCount > 0;
 }
+function projectCiStatus(health, localLaw) {
+  if (health.status === "error" || localLaw.errorCount > 0) return "error";
+  if (health.status === "warning" || localLaw.warnCount > 0) return "warning";
+  return health.status;
+}
+function formatLocalLawText(summary, health) {
+  const lines = ["", `${BOLD2}Project-owned local law:${RESET3}`];
+  if (!summary.checked) {
+    const isBrownfield = health.summary.workflowMode === "brownfield-attach";
+    lines.push(
+      isBrownfield ? "  Not accepted yet. Run `decantr codify --from-audit`, review, then `decantr codify --accept`." : "  Not active for this project."
+    );
+    return `${lines.join("\n")}
+`;
+  }
+  lines.push(
+    `  Patterns: ${summary.patternsPresent ? "present" : "missing"} | Rules: ${summary.rulesPresent ? "present" : "missing"}`
+  );
+  lines.push(`  Findings: ${summary.errorCount} error(s), ${summary.warnCount} warning(s)`);
+  for (const warning of summary.warnings.slice(0, 5)) {
+    lines.push(`  ${DIM3}[WARN] ${warning}${RESET3}`);
+  }
+  for (const finding of summary.findings.slice(0, 8)) {
+    const label = finding.severity.toUpperCase();
+    lines.push(
+      `  [${label}] ${finding.ruleId} ${finding.file}:${finding.line}:${finding.column} ${finding.message}`
+    );
+    lines.push(`    ${DIM3}${finding.suggestedFix}${RESET3}`);
+  }
+  if (summary.findings.length > 8) {
+    lines.push(`  ${DIM3}...${summary.findings.length - 8} more local-law finding(s)${RESET3}`);
+  }
+  return `${lines.join("\n")}
+`;
+}
+function formatLocalLawMarkdown(summary, health) {
+  const lines = ["## Project-Owned Local Law", ""];
+  if (!summary.checked) {
+    if (health.summary.workflowMode !== "brownfield-attach") {
+      lines.push("Local law is not active for this project.");
+      return lines.join("\n");
+    }
+    lines.push(
+      "Local law has not been accepted yet. Run `decantr codify --from-audit`, review the proposal, then run `decantr codify --accept`."
+    );
+    return lines.join("\n");
+  }
+  lines.push(
+    `Patterns: **${summary.patternsPresent ? "present" : "missing"}** \xB7 Rules: **${summary.rulesPresent ? "present" : "missing"}**`
+  );
+  lines.push("");
+  lines.push(`Findings: **${summary.errorCount} error(s), ${summary.warnCount} warning(s)**`);
+  if (summary.warnings.length > 0) {
+    lines.push("");
+    for (const warning of summary.warnings.slice(0, 5)) {
+      lines.push(`- Warning: ${warning}`);
+    }
+  }
+  if (summary.findings.length > 0) {
+    lines.push("");
+    for (const finding of summary.findings.slice(0, 12)) {
+      lines.push(
+        `- \`${finding.severity}\` \`${finding.ruleId}\` at \`${finding.file}:${finding.line}:${finding.column}\`: ${finding.message}`
+      );
+    }
+  }
+  return lines.join("\n");
+}
 function formatProjectCiMarkdown(report) {
   const lines = [
     "# Decantr CI",
@@ -3864,7 +3976,9 @@ function formatProjectCiMarkdown(report) {
     `- Fail on: \`${report.failOn}\``,
     `- Local law: ${report.localLaw.checked ? `${report.localLaw.errorCount} error(s), ${report.localLaw.warnCount} warning(s)` : "not accepted yet"}`,
     "",
-    formatProjectHealthMarkdown(report.health)
+    formatProjectHealthMarkdown(report.health),
+    "",
+    formatLocalLawMarkdown(report.localLaw, report.health)
   ];
   return `${lines.join("\n")}
 `;
@@ -4068,7 +4182,7 @@ async function runProjectCi(root, options) {
     mode: "project",
     projectPath,
     failOn,
-    status: health.status,
+    status: projectCiStatus(health, localLaw),
     health,
     localLaw
   };
@@ -4080,7 +4194,8 @@ async function runProjectCi(root, options) {
   if (!options.output && !options.markdownOutput) {
     if (options.json) process.stdout.write(json);
     else if (options.markdown) process.stdout.write(markdown);
-    else process.stdout.write(formatProjectHealthText(health));
+    else
+      process.stdout.write(`${formatProjectHealthText(health)}${formatLocalLawText(localLaw, health)}`);
   }
   return shouldFailHealth(health, failOn) || localLawFails(localLaw, failOn) ? 1 : 0;
 }
@@ -8803,7 +8918,7 @@ function localPatternMatches(projectRoot, query) {
   if (!projectRoot) return [];
   const pack = readLocalPatternPack(projectRoot);
   const patterns = Array.isArray(pack?.patterns) ? pack.patterns : [];
-  const queryTerms = query.toLowerCase().split(/[^a-z0-9]+/).filter((term) => term.length > 1);
+  const queryTerms = query.toLowerCase().split(/[^a-z0-9]+/).filter((term) => term.length > 1).flatMap((term) => term.endsWith("s") && term.length > 3 ? [term, term.slice(0, -1)] : [term]);
   if (queryTerms.length === 0) return [];
   return patterns.map((pattern) => {
     const id = typeof pattern.id === "string" ? pattern.id : "local-pattern";
@@ -8815,7 +8930,11 @@ function localPatternMatches(projectRoot, query) {
       role,
       typeof pattern.decide === "string" ? pattern.decide : null,
       ...Array.isArray(pattern.appliesTo) ? pattern.appliesTo : [],
-      ...Array.isArray(pattern.componentPaths) ? pattern.componentPaths : []
+      ...Array.isArray(pattern.componentPaths) ? pattern.componentPaths : [],
+      ...Array.isArray(pattern.tokenHints) ? pattern.tokenHints : [],
+      ...Array.isArray(pattern.classHints) ? pattern.classHints : [],
+      ...Array.isArray(pattern.evidence) ? pattern.evidence : [],
+      ...Array.isArray(pattern.forbiddenAlternatives) ? pattern.forbiddenAlternatives : []
     ].filter((entry) => typeof entry === "string").join(" ").toLowerCase();
     const score = queryTerms.reduce((sum, term) => sum + (haystack.includes(term) ? 1 : 0), 0);
     return { id, label, role, score };
@@ -8849,6 +8968,7 @@ async function loadPatternDiscoveryCandidates(registryClient) {
 }
 async function cmdSuggest(query, options = {}) {
   const searchType = options.type || "pattern";
+  const projectRoot = options.projectRoot ?? process.cwd();
   if (searchType !== "pattern" && searchType !== "patterns") {
     const apiClient = getAPIClient();
     try {
@@ -8869,9 +8989,10 @@ async function cmdSuggest(query, options = {}) {
     }
   }
   const registryClient = new RegistryClient({
-    cacheDir: join31(options.projectRoot ?? process.cwd(), ".decantr", "cache")
+    cacheDir: join31(projectRoot, ".decantr", "cache")
   });
-  const code = options.fromCode || options.file ? readSuggestCodeContext(options.projectRoot ?? process.cwd(), options.route, options.file) : "";
+  const code = options.fromCode || options.file ? readSuggestCodeContext(projectRoot, options.route, options.file) : "";
+  const localMatches = localPatternMatches(projectRoot, [query, code].filter(Boolean).join("\n"));
   const candidates = await loadPatternDiscoveryCandidates(registryClient);
   const matches = rankPatternCandidates(
     {
@@ -8882,7 +9003,7 @@ async function cmdSuggest(query, options = {}) {
     },
     candidates
   );
-  if (matches.length === 0) {
+  if (matches.length === 0 && localMatches.length === 0) {
     console.log(dim3(`No pattern suggestions for "${query}"`));
     console.log("");
     console.log("Try:");
@@ -8902,10 +9023,6 @@ async function cmdSuggest(query, options = {}) {
       `Pattern suggestions for "${query}"${contextBits.length > 0 ? ` (${contextBits.join(", ")})` : ""}`
     )
   );
-  const localMatches = localPatternMatches(
-    options.projectRoot,
-    [query, code].filter(Boolean).join("\n")
-  );
   if (localMatches.length > 0) {
     console.log(`${BOLD9}Project-owned local law:${RESET16}`);
     for (const match of localMatches) {
@@ -8915,6 +9032,12 @@ async function cmdSuggest(query, options = {}) {
     console.log("");
     console.log(`${BOLD9}Registry patterns:${RESET16}`);
   }
+  if (matches.length === 0) {
+    console.log(dim3("No hosted/bundled registry patterns matched this query."));
+    console.log("");
+    console.log(dim3('Use local law first, or run "decantr list patterns" to browse registry options.'));
+    return;
+  }
   for (const match of matches.slice(0, 8)) {
     const candidate = match.candidate;
     const slug = candidate.slug || candidate.id;
@@ -9313,18 +9436,23 @@ async function applyAcceptedBrownfieldProposal(input) {
   if (refreshResult.contextFiles.length > 8) {
     console.log(`    ${dim3(`(+${refreshResult.contextFiles.length - 8} more)`)}`);
   }
-  console.log("");
-  console.log("  Next steps:");
-  console.log(
-    `    1. Run ${cyan3(withProject("decantr check --brownfield", projectLabel))} to verify contract coverage`
-  );
-  console.log(
-    `    2. Read ${cyan3(displayProjectPath(input.workspaceInfo, ".decantr/brownfield-report.md"))} for unresolved doctrine risks`
-  );
-  console.log(
-    `    3. Use ${cyan3(withProject("decantr rules preview", projectLabel))} before mutating assistant rule files`
-  );
-  console.log("");
+  if (!input.suppressNextSteps) {
+    console.log("");
+    console.log("  Next steps:");
+    console.log(
+      `    1. Run ${cyan3(withProject("decantr doctor", projectLabel))} to explain adoption state and the next command`
+    );
+    console.log(
+      `    2. Run ${cyan3(withProject("decantr codify --from-audit", projectLabel))} when you are ready to propose project-owned UI law`
+    );
+    console.log(
+      `    3. Use ${cyan3(withProject('decantr task / "change summary"', projectLabel))} before LLM edits`
+    );
+    console.log(
+      `    4. Run ${cyan3(withProject("decantr verify --brownfield", projectLabel))} after edits`
+    );
+    console.log("");
+  }
 }
 async function cmdInit(args) {
   const workspaceInfo = resolveWorkspaceInfo(process.cwd(), args.project);
@@ -9372,7 +9500,8 @@ async function cmdInit(args) {
       detected,
       workspaceInfo,
       mode: proposalMode,
-      assistantBridge: policy.assistantBridge
+      assistantBridge: policy.assistantBridge,
+      suppressNextSteps: args.internalSuppressNextSteps
     });
     if (args.telemetry) enableCliTelemetry(projectRoot);
     writeArtifactReadme(projectRoot);
@@ -10591,7 +10720,8 @@ async function cmdAdoptWorkflow(args) {
     "merge-proposal": proposalFlag === "--merge-proposal",
     "replace-essence": proposalFlag === "--replace-essence",
     "assistant-bridge": assistantBridge,
-    telemetry: flagBoolean(flags, "telemetry")
+    telemetry: flagBoolean(flags, "telemetry"),
+    internalSuppressNextSteps: true
   });
   if (process.exitCode && process.exitCode !== 0) return;
   if (hydratePacks) {
@@ -10620,7 +10750,7 @@ async function cmdAdoptWorkflow(args) {
     console.log(dim3("Skipping hosted pack hydration in offline mode."));
   }
   if (runVerify) {
-    const { cmdHealth } = await import("./health-VAYRQVTF.js");
+    const { cmdHealth } = await import("./health-ADHNLMX3.js");
     await cmdHealth(projectRoot, {
       browser: runBrowser,
       browserBaseUrl: baseUrl,
@@ -10691,7 +10821,7 @@ async function cmdVerifyWorkflow(args) {
     return;
   }
   if (workspaceMode) {
-    const { cmdWorkspace } = await import("./workspace-PBO3BJRL.js");
+    const { cmdWorkspace } = await import("./workspace-YYCRXJNB.js");
     await cmdWorkspace(process.cwd(), ["workspace", "health", ...withoutWorkflowOnlyFlags(args)]);
     return;
   }
@@ -10734,7 +10864,7 @@ async function cmdVerifyWorkflow(args) {
       process.exitCode = void 0;
     }
   }
-  const { cmdHealth, parseHealthArgs } = await import("./health-VAYRQVTF.js");
+  const { cmdHealth, parseHealthArgs } = await import("./health-ADHNLMX3.js");
   await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(healthArgs));
   if (localPatterns) {
     const validation = validateLocalLaw(workspaceInfo.appRoot);
@@ -11845,7 +11975,7 @@ async function main() {
         const { flags } = parseLooseArgs(args);
         const workspaceInfo = resolveWorkflowProject(flags, "health");
         if (!workspaceInfo) break;
-        const { cmdHealth, parseHealthArgs } = await import("./health-VAYRQVTF.js");
+        const { cmdHealth, parseHealthArgs } = await import("./health-ADHNLMX3.js");
         await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(stripProjectArgs(args)));
       } catch (e) {
         console.error(error2(e.message));
@@ -11873,7 +12003,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-WPETOZRW.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-GZFCCVSO.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error2(e.message));
@@ -11887,7 +12017,7 @@ async function main() {
           cmdWorkspaceHelp();
           break;
         }
-        const { cmdWorkspace } = await import("./workspace-PBO3BJRL.js");
+        const { cmdWorkspace } = await import("./workspace-YYCRXJNB.js");
         await cmdWorkspace(process.cwd(), args);
       } catch (e) {
         console.error(error2(e.message));
@@ -12004,7 +12134,7 @@ async function main() {
         route,
         file,
         fromCode,
-        projectRoot: workspaceInfo?.appRoot
+        projectRoot: workspaceInfo?.appRoot ?? process.cwd()
       });
       break;
     }

package/dist/{chunk-QDMXZSVK.js → chunk-NUNUW5IS.js}

@@ -1,7 +1,7 @@
 import {
   createProjectHealthReport,
   listWorkspaceAppCandidates
-} from "./chunk-WPP3JEMC.js";
+} from "./chunk-5WPRTVNA.js";
 
 // src/commands/workspace.ts
 import { execFileSync } from "child_process";

package/dist/{health-VAYRQVTF.js → health-ADHNLMX3.js}

@@ -10,7 +10,7 @@ import {
   renderProjectHealthCiWorkflow,
   shouldFailHealth,
   writeProjectHealthCiWorkflow
-} from "./chunk-WPP3JEMC.js";
+} from "./chunk-5WPRTVNA.js";
 import "./chunk-4SZ4SEKT.js";
 export {
   cmdHealth,

package/dist/index.js

@@ -1,5 +1,5 @@
-import "./chunk-HQUTNZKF.js";
+import "./chunk-ET4BG746.js";
 import "./chunk-IQZCIMQJ.js";
-import "./chunk-QDMXZSVK.js";
-import "./chunk-WPP3JEMC.js";
+import "./chunk-NUNUW5IS.js";
+import "./chunk-5WPRTVNA.js";
 import "./chunk-4SZ4SEKT.js";

package/dist/{studio-WPETOZRW.js → studio-GZFCCVSO.js}

@@ -1,9 +1,9 @@
 import {
   createWorkspaceHealthReport
-} from "./chunk-QDMXZSVK.js";
+} from "./chunk-NUNUW5IS.js";
 import {
   createProjectHealthReport
-} from "./chunk-WPP3JEMC.js";
+} from "./chunk-5WPRTVNA.js";
 import {
   sendStudioHealthRefreshedTelemetry,
   sendStudioStartedTelemetry

package/dist/{workspace-PBO3BJRL.js → workspace-YYCRXJNB.js}

@@ -7,8 +7,8 @@ import {
   listWorkspaceProjects,
   parseWorkspaceArgs,
   shouldFailWorkspaceHealth
-} from "./chunk-QDMXZSVK.js";
-import "./chunk-WPP3JEMC.js";
+} from "./chunk-NUNUW5IS.js";
+import "./chunk-5WPRTVNA.js";
 import "./chunk-4SZ4SEKT.js";
 export {
   cmdWorkspace,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "description": "Decantr CLI - scaffold, audit, inspect Project Health, and maintain Decantr projects from the terminal",
   "keywords": [
     "decantr",
@@ -49,10 +49,10 @@
   "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/verifier": "2.3.3"
+    "@decantr/essence-spec": "2.0.1",
+    "@decantr/verifier": "2.4.0",
+    "@decantr/registry": "2.2.0"
   },
   "scripts": {
     "build": "tsup",