@decantr/cli 2.9.8 → 2.11.0

package/README.md

@@ -20,7 +20,7 @@ npx @decantr/cli new my-app --blueprint=esports-hq
 Use `decantr setup` when you are unsure which path applies. It detects whether the repo is empty, already attached, or a Brownfield app and recommends the right entry path.
 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`.
 Use `decantr adopt` when you already have an app and want Decantr governance without adopting a blueprint. Brownfield attach is proposal-driven: Decantr inventories the app, writes an observed essence proposal, hydrates hosted execution packs when online, and only applies the contract when you explicitly accept or merge it.
-Use `decantr doctor` when the next step is unclear, `decantr task` before asking an LLM to modify a route, `decantr verify` after the edit, and `decantr ci` in required automation. Use `decantr codify --from-audit` when you want project-owned UI patterns and local rules such as button/card/shell/theme standards to appear in future task context and verification.
+Use `decantr doctor` when the next step is unclear, `decantr task` before asking an LLM to modify a route, `decantr verify` after the edit, and `decantr ci` in required automation. Use `decantr codify --from-audit` when you want project-owned UI patterns and local rules such as button/card/shell/theme standards to appear in future task context and verification. Once accepted, that local law is the first Hybrid lane: the app still owns source and styling, but Decantr treats accepted local patterns and rules as project authority.
 In monorepos, app-scoped commands accept `--project <app-path>`. `setup` shows attach guidance before adoption and the day-two loop after adoption. Hosted pack hydration also follows the essence path: `decantr registry compile-packs apps/web/decantr.essence.json --write-context` writes into `apps/web/.decantr/context`. In contract-only/offline Brownfield, deferred hosted packs are optional context unless a present manifest references missing files.
 Use `decantr init`, `decantr analyze`, `decantr check`, and `decantr health` as advanced primitives when you need direct control over one step.
 
@@ -80,13 +80,13 @@ 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`; after review, `decantr codify --accept` promotes `.decantr/local-patterns.json` and `.decantr/rules.json`. `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
 
 - scaffolds Decantr projects from blueprints, archetypes, or prompts
 - guides users through human workflow commands: setup, adopt, doctor, task, verify, ci, and codify
-- supports explicit workflow lanes: greenfield blueprint, greenfield contract-only, brownfield adoption, and hybrid composition
+- supports explicit workflow lanes: greenfield blueprint, greenfield contract-only, brownfield adoption, Hybrid local law, Hybrid style bridge, Hybrid Decantr CSS, and hybrid composition
 - generates execution-pack context files for AI coding assistants
 - audits projects against Decantr contracts
 - produces local Project Health reports, Evidence Bundles, workspace health, and a localhost Studio dashboard for end-user drift triage
@@ -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
@@ -148,7 +149,7 @@ decantr showcase verification --json
 
 `decantr verify` is the workflow command most users should run locally after edits. It delegates to Project Health, can add Brownfield guard validation with `--brownfield`, requires an accepted local pattern pack with `--local-patterns`, scans `.decantr/rules.json` when present, supports workspace mode, and writes evidence to `.decantr/evidence/latest.json` by default when `--evidence` is used.
 
-`decantr doctor` explains project/workspace state, adoption mode, generated artifacts, local law, visual evidence, design authority signals, CI wiring, and an ordered next-step queue. It is the command to reach for when an app is in a monorepo, has stale Decantr files, or someone is not sure what Decantr expects next.
+`decantr doctor` explains project/workspace state, adoption mode, adoption lane, generated artifacts, local law, visual evidence, design authority signals, CI wiring, and an ordered next-step queue. It is the command to reach for when an app is in a monorepo, has stale Decantr files, or someone is not sure what Decantr expects next.
 
 `decantr setup` is non-mutating orientation. In an attached Brownfield app it reflects whether local law is already accepted, so the recommended verify command includes `--local-patterns` only when the project has that layer.
 

package/dist/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import "./chunk-JSILTE5V.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-JSILTE5V.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: {
@@ -3284,7 +3300,17 @@ function createBrownfieldCodifyProposal(input) {
       ruleFiles: input.detected.existingRuleFiles,
       routeCount: routes.length
     },
-    purpose: "Project-owned Brownfield UI law. Review and edit before accepting; Decantr treats this as authoritative only after it is copied to .decantr/local-patterns.json.",
+    purpose: "Project-owned Brownfield/Hybrid UI law. Review and edit before accepting; Decantr treats this as authoritative only after it is copied to .decantr/local-patterns.json.",
+    hybrid: {
+      intent: "This local pattern pack is the first Hybrid authority layer: it maps Decantr concepts onto project-owned components, tokens, classes, and rules without replacing the app runtime.",
+      authorityPrecedence: [
+        "existing production source",
+        "accepted local patterns and rules",
+        "Decantr Essence V4 contract",
+        "hosted registry patterns and execution packs as optional guidance"
+      ],
+      hostedPatternMapping: "Use hosted patterns as vocabulary and review guidance. Before enforcing one, map it to a project-owned component path, class recipe, token recipe, or explicit exception here."
+    },
     patterns: [
       {
         id: "button",
@@ -3299,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."]
@@ -3359,13 +3386,15 @@ function createBrownfieldCodifyProposal(input) {
       "Avoid raw hex/rgb values in component templates unless documented as dynamic data.",
       "Avoid static inline styles for reusable visual treatment.",
       "When adding a new route, map it to an existing local pattern before inventing a new visual variant.",
-      "When adding a theme variant, update .decantr/theme-inventory.json and this local pattern pack."
+      "When adding a theme variant, update .decantr/theme-inventory.json and this local pattern pack.",
+      "Map hosted Decantr patterns into project-owned local law before making them enforceable."
     ],
     nextSteps: [
       "Edit this proposal with real component paths and token/class recipes.",
       "Run decantr codify --accept after review.",
       "Use decantr task <route> before LLM edits so local law appears in task context.",
       "Run decantr verify --brownfield --local-patterns after edits.",
+      "For Hybrid adoption, start with warn-level local rules and raise severities only after the team agrees the law is stable.",
       "Wire deterministic project rules into ESLint, Biome, Storybook, visual tests, or CI where Decantr should not guess."
     ]
   };
@@ -3374,7 +3403,7 @@ function createBrownfieldCodifyProposal(input) {
     status: "proposal",
     generatedAt,
     source: input.fromAudit ? "decantr codify --from-audit" : "decantr codify",
-    purpose: "Mechanical Brownfield checks owned by this project. These rules are intentionally local and stack-agnostic; edit before accepting.",
+    purpose: "Mechanical Brownfield/Hybrid checks owned by this project. These rules are intentionally local and stack-agnostic; edit before accepting.",
     enforcement: {
       defaultSeverity: "warn",
       mode: "warn",
@@ -3623,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");
@@ -3635,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);
     }
   }
@@ -3833,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
   };
@@ -3842,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",
@@ -3852,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")}
 `;
@@ -4056,7 +4182,7 @@ async function runProjectCi(root, options) {
     mode: "project",
     projectPath,
     failOn,
-    status: health.status,
+    status: projectCiStatus(health, localLaw),
     health,
     localLaw
   };
@@ -4068,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;
 }
@@ -4469,6 +4596,107 @@ function appendUnique(commands, command) {
   if (!command) return;
   if (!commands.includes(command)) commands.push(command);
 }
+function deriveAdoptionLane(input) {
+  if (input.workspaceMode) {
+    return {
+      id: "workspace",
+      label: "Workspace overview",
+      sourceAuthority: "Each attached app keeps its own Decantr contract and source authority.",
+      styleAuthority: "Per-app adoption mode",
+      activeAuthorities: ["workspace project list", "attached app contracts"],
+      nextChoice: "Pick an app with --project when you want route-level or source-level guidance."
+    };
+  }
+  if (!input.essenceVersion) {
+    return {
+      id: "unattached",
+      label: "Unattached app",
+      sourceAuthority: "Existing app only",
+      styleAuthority: "Existing app styling system",
+      activeAuthorities: ["source tree"],
+      nextChoice: "Run decantr adopt to attach an observed contract before choosing Brownfield or Hybrid law."
+    };
+  }
+  const hasLocalLaw = input.localPatternsPresent || input.localRulesPresent;
+  if (input.workflowMode === "hybrid-compose") {
+    return {
+      id: "hybrid-compose",
+      label: "Hybrid composition",
+      sourceAuthority: "Existing app plus selected Decantr/local law",
+      styleAuthority: input.adoptionMode === "decantr-css" ? "Decantr CSS runtime is active where adopted" : input.adoptionMode === "style-bridge" ? "Style bridge maps Decantr intent into the app styling system" : "Existing app styling system remains primary",
+      activeAuthorities: [
+        "existing source",
+        "Essence V4 contract",
+        hasLocalLaw ? "accepted local law" : "reviewed Hybrid choices",
+        input.packManifestPresent ? "hosted execution packs" : "optional hosted packs"
+      ],
+      nextChoice: "Use task/verify for daily work and keep any hosted pattern adoption mapped into project-owned law."
+    };
+  }
+  if (input.workflowMode === "brownfield-attach") {
+    if (input.adoptionMode === "decantr-css") {
+      return {
+        id: "hybrid-decantr-css",
+        label: "Hybrid with Decantr CSS",
+        sourceAuthority: "Existing app plus explicitly adopted Decantr CSS runtime",
+        styleAuthority: "Decantr CSS runtime is active where adopted",
+        activeAuthorities: ["existing source", "Essence V4 contract", "Decantr CSS runtime"],
+        nextChoice: "Keep Decantr CSS usage explicit and validate route changes with task and verify."
+      };
+    }
+    if (input.adoptionMode === "style-bridge") {
+      return {
+        id: "hybrid-style-bridge",
+        label: "Hybrid style bridge",
+        sourceAuthority: "Existing app plus Decantr intent mapped through a style bridge",
+        styleAuthority: "Style bridge over the existing app styling system",
+        activeAuthorities: ["existing source", "Essence V4 contract", "style bridge"],
+        nextChoice: "Use local law to decide which component families the bridge governs before making it strict."
+      };
+    }
+    if (hasLocalLaw) {
+      return {
+        id: "hybrid-local-law",
+        label: "Hybrid local law",
+        sourceAuthority: "Existing app plus accepted project-owned UI law",
+        styleAuthority: input.designAuthority.length > 0 ? "Existing design authority plus accepted local rules" : "Accepted local rules over the current app styling system",
+        activeAuthorities: [
+          "existing source",
+          "Essence V4 contract",
+          "accepted local patterns/rules",
+          input.packManifestPresent ? "hosted execution packs as guidance" : "optional hosted packs"
+        ],
+        nextChoice: "Use task before edits and verify --local-patterns after edits; map hosted patterns into local law before enforcing them."
+      };
+    }
+    return {
+      id: "brownfield-contract-only",
+      label: "Brownfield contract-only",
+      sourceAuthority: "Existing app is authoritative",
+      styleAuthority: "Existing app styling system",
+      activeAuthorities: ["existing source", "Essence V4 contract"],
+      nextChoice: "Stay contract-only for context, or codify local patterns/rules when you want Hybrid drift control."
+    };
+  }
+  if (input.workflowMode === "greenfield-contract-only") {
+    return {
+      id: "greenfield-contract-only",
+      label: "Greenfield contract-only",
+      sourceAuthority: "Essence V4 contract",
+      styleAuthority: "Project-chosen styling system",
+      activeAuthorities: ["Essence V4 contract", "generated context"],
+      nextChoice: "Add local rules or a style bridge only after the runtime conventions are clear."
+    };
+  }
+  return {
+    id: "greenfield-scaffold",
+    label: "Greenfield scaffold",
+    sourceAuthority: "Decantr contract and certified adapter output",
+    styleAuthority: input.adoptionMode === "contract-only" ? "Project-chosen styling system" : "Decantr CSS",
+    activeAuthorities: ["Essence V4 contract", "adapter output", "execution packs"],
+    nextChoice: "Use task and verify to keep generated routes aligned with the compiled contract."
+  };
+}
 function buildDoctorReport(root, args) {
   let projectArg;
   for (let index = 1; index < args.length; index += 1) {
@@ -4624,6 +4852,16 @@ function buildDoctorReport(root, args) {
     issues,
     workspaceMode || workspaceInfo.requiresProjectSelection ? "4.0.0" : essenceVersion
   );
+  const lane = deriveAdoptionLane({
+    workspaceMode: workspaceMode || workspaceInfo.requiresProjectSelection,
+    essenceVersion,
+    workflowMode,
+    adoptionMode,
+    localPatternsPresent,
+    localRulesPresent,
+    designAuthority,
+    packManifestPresent
+  });
   const projectFlag = projectPath ? ` --project ${projectPath}` : "";
   const verifyCommand = workflowMode === "brownfield-attach" ? `decantr verify --brownfield --local-patterns${projectFlag}` : workspaceMode ? "decantr ci --workspace" : `decantr verify${projectFlag}`;
   const ciCommand = workspaceMode ? "decantr ci --workspace --fail-on error" : `decantr ci${projectFlag} --fail-on error`;
@@ -4694,6 +4932,7 @@ function buildDoctorReport(root, args) {
     visualEvidence: {
       manifestPresent: existsSync16(join18(appRoot, ".decantr", "evidence", "visual-manifest.json"))
     },
+    lane,
     designAuthority,
     status,
     issues,
@@ -4722,6 +4961,13 @@ function formatDoctorText(report) {
     `  Workflow: ${report.project.workflowMode ?? "unknown"} | adoption ${report.project.adoptionMode ?? "unknown"}`,
     `  Sync state: ${report.project.syncStatus ?? "unknown"} ${DIM4}(registry/cache state, not generated context freshness)${RESET4}`,
     "",
+    `${BOLD3}Adoption Lane:${RESET4}`,
+    `  ${report.lane.label}`,
+    `  Source authority: ${report.lane.sourceAuthority}`,
+    `  Style authority: ${report.lane.styleAuthority}`,
+    `  Active: ${report.lane.activeAuthorities.join(", ")}`,
+    `  Choice: ${report.lane.nextChoice}`,
+    "",
     `${BOLD3}Generated Artifacts:${RESET4}`,
     `  Context directory: ${report.generatedArtifacts.contextDirPresent ? "present" : "missing"}`,
     `  Pack manifest: ${report.generatedArtifacts.packManifestPresent ? "present" : "missing"}`,
@@ -8672,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";
@@ -8684,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 };
@@ -8718,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 {
@@ -8738,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(
     {
@@ -8751,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:");
@@ -8771,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) {
@@ -8784,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;
@@ -9182,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);
@@ -9241,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);
@@ -10460,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) {
@@ -10489,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,
@@ -10560,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;
   }
@@ -10603,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);
@@ -10665,6 +10926,81 @@ function readJsonIfPresent(path) {
     return null;
   }
 }
+function mentionsWord(text, term) {
+  const escaped = term.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`\\b${escaped}\\b`, "i").test(text);
+}
+function createTaskAuthoritySummary(input) {
+  const detected = detectProject(input.projectRoot);
+  const hasLocalLaw = input.hasLocalPatterns || input.hasLocalRules;
+  let lane = "Brownfield contract-only";
+  let sourceAuthority = "Existing app is authoritative; Decantr supplies contract context.";
+  let styleAuthority = "Use the existing styling system.";
+  const activeAuthorities = ["existing source", "Essence V4 contract"];
+  if (input.workflowMode === "hybrid-compose") {
+    lane = "Hybrid composition";
+    sourceAuthority = "Existing app plus selected Decantr/local law are authoritative.";
+  } else if (input.workflowMode === "brownfield-attach" && input.adoptionMode === "decantr-css") {
+    lane = "Hybrid with Decantr CSS";
+    sourceAuthority = "Existing app remains authoritative except where Decantr CSS is explicitly adopted.";
+    styleAuthority = "Decantr CSS runtime is active where adopted.";
+    activeAuthorities.push("Decantr CSS runtime");
+  } else if (input.workflowMode === "brownfield-attach" && input.adoptionMode === "style-bridge") {
+    lane = "Hybrid style bridge";
+    sourceAuthority = "Existing app remains authoritative; Decantr intent maps through the style bridge.";
+    styleAuthority = "Use bridge tokens/classes as a mapping layer onto the app styling system.";
+    activeAuthorities.push("style bridge");
+  } else if (input.workflowMode === "brownfield-attach" && hasLocalLaw) {
+    lane = "Hybrid local law";
+    sourceAuthority = "Existing app plus accepted project-owned UI law are authoritative.";
+    styleAuthority = "Use project-owned components, tokens, classes, and accepted local rules.";
+  } else if (input.workflowMode?.startsWith("greenfield")) {
+    lane = input.workflowMode === "greenfield-contract-only" ? "Greenfield contract-only" : "Greenfield scaffold";
+    sourceAuthority = "Essence V4 and generated context are authoritative.";
+    styleAuthority = input.adoptionMode === "contract-only" ? "Use the project-chosen styling system." : "Use Decantr CSS where generated by the adapter.";
+  }
+  if (hasLocalLaw) activeAuthorities.push("accepted local patterns/rules");
+  if (input.hasPackManifest) activeAuthorities.push("hosted execution packs as guidance");
+  const framework = detected.framework ?? "unknown";
+  const runtimeBoundary = `Detected ${framework}; do not introduce another frontend runtime inside this route unless the task is explicitly a reviewed migration or isolated integration plan.`;
+  const warnings = [];
+  const task = input.taskSummary;
+  const runtimeTerms = [
+    "angular",
+    "vue",
+    "svelte",
+    "solid",
+    "nextjs",
+    "next.js",
+    "react",
+    "bootstrap",
+    "shadcn"
+  ];
+  const compatibleMentions = /* @__PURE__ */ new Set();
+  if (framework === "nextjs") compatibleMentions.add("react");
+  if (framework === "react") compatibleMentions.add("react");
+  if (framework === "vue" || framework === "nuxt") compatibleMentions.add("vue");
+  for (const term of runtimeTerms) {
+    if (!mentionsWord(task, term)) continue;
+    if (term === framework || compatibleMentions.has(term)) continue;
+    if ((term === "nextjs" || term === "next.js") && framework === "nextjs") continue;
+    if (term === "shadcn" || term === "bootstrap") {
+      warnings.push(
+        `Requested ${term} should be treated as optional Hybrid guidance unless this project already owns that library or the task explicitly adopts it.`
+      );
+      continue;
+    }
+    warnings.push(
+      `Task mentions ${term}, but the detected runtime is ${framework}. Prefer a dry-run plan or local pattern mapping before adding cross-runtime code.`
+    );
+  }
+  if (input.adoptionMode !== "decantr-css" && (/@decantr\/css/i.test(task) || /\bdecantr css\b/i.test(task) || /\bd-[a-z0-9-]+/i.test(task))) {
+    warnings.push(
+      "This project is not in decantr-css adoption mode. Do not add @decantr/css or d-* classes unless the user explicitly changes adoption mode."
+    );
+  }
+  return { lane, sourceAuthority, styleAuthority, activeAuthorities, runtimeBoundary, warnings };
+}
 async function cmdTaskWorkflow(args) {
   const { flags, positional } = parseLooseArgs(args);
   const workspaceInfo = resolveWorkflowProject(flags, "task");
@@ -10708,6 +11044,7 @@ async function cmdTaskWorkflow(args) {
   const page = section?.pages.find((entry) => entry.id === target.page);
   const contextDir = join31(workspaceInfo.appRoot, ".decantr", "context");
   const manifest = readJsonIfPresent(join31(contextDir, "pack-manifest.json"));
+  const projectJson = readJsonIfPresent(join31(workspaceInfo.appRoot, ".decantr", "project.json"));
   const pagePack = manifest?.pages?.find((entry) => entry.id === target.page);
   const sectionPack = manifest?.sections?.find((entry) => entry.id === target.section);
   const visualManifest = readJsonIfPresent(join31(workspaceInfo.appRoot, ".decantr", "evidence", "visual-manifest.json"));
@@ -10723,6 +11060,15 @@ async function cmdTaskWorkflow(args) {
   const changedSince = flagString(flags, "since");
   const currentChangedFiles = changedFiles(workspaceInfo.appRoot, changedSince);
   const changedRoutes = routeImpacts(workspaceInfo.appRoot, currentChangedFiles);
+  const authority = createTaskAuthoritySummary({
+    projectRoot: workspaceInfo.appRoot,
+    workflowMode: projectJson?.initialized?.workflowMode ?? null,
+    adoptionMode: projectJson?.initialized?.adoptionMode ?? null,
+    hasLocalPatterns: existsSync29(localPatternPackPath),
+    hasLocalRules: existsSync29(localRuleManifestPath),
+    hasPackManifest: Boolean(manifest),
+    taskSummary
+  });
   const context = {
     route,
     task: taskSummary || null,
@@ -10740,6 +11086,7 @@ async function cmdTaskWorkflow(args) {
       existsSync29(localRuleManifestPath) ? displayProjectPath(workspaceInfo, ".decantr/rules.json") : null
     ].filter(Boolean),
     screenshot: screenshot?.startsWith(".decantr/") ? displayProjectPath(workspaceInfo, screenshot) : screenshot ?? null,
+    authority,
     localLaw: displayedLocalLaw,
     changedFiles: currentChangedFiles,
     changedRoutes,
@@ -10765,6 +11112,16 @@ async function cmdTaskWorkflow(args) {
     console.log(`${BOLD9}Visual evidence:${RESET16}`);
     console.log(`  ${cyan3(context.screenshot)}`);
   }
+  console.log("");
+  console.log(`${BOLD9}Authority for this task:${RESET16}`);
+  console.log(`  Lane: ${context.authority.lane}`);
+  console.log(`  Source: ${context.authority.sourceAuthority}`);
+  console.log(`  Style: ${context.authority.styleAuthority}`);
+  console.log(`  Active: ${context.authority.activeAuthorities.join(", ")}`);
+  console.log(`  Runtime: ${context.authority.runtimeBoundary}`);
+  for (const warning of context.authority.warnings) {
+    console.log(`  ${YELLOW12}Boundary:${RESET16} ${warning}`);
+  }
   if (context.localLaw.patternCount > 0 || context.localLaw.ruleCount > 0) {
     console.log("");
     console.log(`${BOLD9}Project-owned local law:${RESET16}`);
@@ -10803,7 +11160,7 @@ async function cmdTaskWorkflow(args) {
   console.log("");
   console.log(`${BOLD9}LLM instruction:${RESET16}`);
   console.log(
-    "  Preserve the existing runtime and styling system. Use the route pack, section context, local laws, changed-file impact, and visual evidence above as the task contract before changing code."
+    "  Preserve the active authority above. Use the route pack, section context, local laws, changed-file impact, and visual evidence as the task contract before changing code."
   );
   console.log(`  After editing, run ${cyan3(context.verifyCommand)}.`);
 }
@@ -10836,6 +11193,11 @@ async function cmdCodifyWorkflow(args) {
     if (result2.rulesAcceptedPath) {
       console.log(success3(`Accepted local rule manifest: ${result2.rulesAcceptedPath}`));
     }
+    console.log(
+      dim3(
+        "Hybrid local law is now active: Decantr will treat accepted local patterns and rules as project-owned authority in task and verify flows."
+      )
+    );
     console.log(
       dim3(
         `Run \`${withProject("decantr verify --brownfield --local-patterns", projectArg)}\` after project edits.`
@@ -10859,12 +11221,14 @@ async function cmdCodifyWorkflow(args) {
   console.log(success3(`Wrote local rule proposal: ${result.rulesPath}`));
   if (fromAudit) {
     console.log(
-      dim3("Proposal includes source-derived component candidates and starter mechanical rules.")
+      dim3(
+        "Proposal includes source-derived component candidates, starter mechanical rules, and Hybrid authority guidance."
+      )
     );
   }
   console.log(
     dim3(
-      `Review both files, add real component paths/token recipes, then run \`${withProject("decantr codify --accept", projectArg)}\`.`
+      `Review both files, add real component paths/token recipes, map hosted pattern ideas into project-owned law, then run \`${withProject("decantr codify --accept", projectArg)}\`.`
     )
   );
 }
@@ -11611,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));
@@ -11639,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));
@@ -11653,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));
@@ -11770,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-JSILTE5V.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.9.8",
+  "version": "2.11.0",
   "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/verifier": "2.3.3",
     "@decantr/telemetry": "2.2.1",
     "@decantr/essence-spec": "2.0.1",
+    "@decantr/verifier": "2.4.0",
     "@decantr/registry": "2.2.0"
   },
   "scripts": {