@decantr/cli 3.4.1 → 3.5.0

package/dist/{chunk-33IZQXZH.js → chunk-LTNGAAV4.js}

@@ -22,7 +22,7 @@ import {
   listWorkspaceCandidates,
   listWorkspaceProjects,
   shouldFailWorkspaceHealth
-} from "./chunk-UGRAHWCG.js";
+} from "./chunk-RJ6PT7WP.js";
 import {
   acceptBrownfieldLocalLaw,
   acceptStyleBridge,
@@ -52,7 +52,7 @@ import {
   writeBrownfieldCodifyProposal,
   writeHostedPatternMappingProposal,
   writeStyleBridgeProposal
-} from "./chunk-BDVI3SSP.js";
+} from "./chunk-T45GFC6F.js";
 import {
   buildGuardRegistryContext,
   createDoctrineMap,
@@ -69,11 +69,11 @@ import {
   sendCliCommandTelemetry,
   sendNewProjectCompletedTelemetry,
   writeDoctrineMap
-} from "./chunk-2GCVVEQC.js";
+} from "./chunk-PM7DKABI.js";
 
 // src/index.ts
-import { existsSync as existsSync28, mkdirSync as mkdirSync15, readdirSync as readdirSync8, readFileSync as readFileSync21, writeFileSync as writeFileSync18 } from "fs";
-import { basename as basename2, dirname as dirname6, isAbsolute as isAbsolute3, join as join30, relative as relative6, resolve as resolve4 } from "path";
+import { existsSync as existsSync29, mkdirSync as mkdirSync16, readdirSync as readdirSync8, readFileSync as readFileSync22, writeFileSync as writeFileSync19 } from "fs";
+import { basename as basename2, dirname as dirname7, isAbsolute as isAbsolute3, join as join31, relative as relative6, resolve as resolve5 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import {
   buildGraphImpactContext,
@@ -98,6 +98,7 @@ import {
 import {
   auditProject,
   critiqueFile as critiqueProjectFile,
+  LOOP_READINESS_V2_SCHEMA_URL,
   scanProject as scanProjectReadOnly
 } from "@decantr/verifier";
 
@@ -188,11 +189,14 @@ function buildAssistantBridgeContent(input) {
   lines.push("## Suggested Rule Block");
   lines.push("");
   lines.push(START);
+  lines.push(
+    'Before editing any route, run `decantr task <route> "<intent>"` and use the printed authority block, read targets, local law, evidence, and verify command as the working contract.'
+  );
   lines.push(
     "Before implementing Decantr-scoped work, read `decantr.essence.json`, `.decantr/brownfield-report.md`, `.decantr/doctrine-map.json`, `.decantr/ambient-context.json`, and the compiled packs in `.decantr/context/`."
   );
   lines.push(
-    "Treat Decantr as the reconciled contract layer and the original project docs/rules as cited evidence; if they conflict, stop and report the conflict instead of guessing."
+    "Treat Decantr as the reconciled contract layer and the original project docs/rules as cited evidence; if runtime source and Decantr context conflict, stop and report the drift instead of guessing which side wins."
   );
   lines.push(
     "For brownfield adoption, preserve existing framework, routing, styling, package manager, data boundaries, and build conventions unless the Decantr contract explicitly records a reviewed change."
@@ -215,8 +219,9 @@ function writeAssistantBridgePreview(input) {
 function bridgeBlock() {
   return [
     START,
+    'Before editing any route, run `decantr task <route> "<intent>"` and use the printed authority block, read targets, local law, evidence, and verify command as the working contract.',
     "Before implementing Decantr-scoped work, read `decantr.essence.json`, `.decantr/brownfield-report.md`, `.decantr/doctrine-map.json`, `.decantr/ambient-context.json`, and `.decantr/context/scaffold-pack.md` first.",
-    "Treat Decantr as the reconciled contract layer and the original project docs/rules as cited evidence; if they conflict, stop and report the conflict instead of guessing.",
+    "Treat Decantr as the reconciled contract layer and the original project docs/rules as cited evidence; if runtime source and Decantr context conflict, stop and report the drift instead of guessing which side wins.",
     "For brownfield adoption, preserve existing framework, routing, styling, package manager, data boundaries, and build conventions unless the Decantr contract explicitly records a reviewed change.",
     "Do not install `@decantr/css` or rewrite styling unless the project adoption mode says `decantr-css` or the task explicitly asks for it.",
     END,
@@ -3388,12 +3393,13 @@ ${YELLOW2}Next step:${RESET2} Review ${BOLD}${reportDisplayPath}${RESET2}, then
 // src/commands/ci.ts
 import { existsSync as existsSync13, mkdirSync as mkdirSync8, readFileSync as readFileSync11, writeFileSync as writeFileSync9 } from "fs";
 import { dirname as dirname3, join as join15, relative as relative3, resolve } from "path";
+import { DECANTR_CI_REPORT_V2_SCHEMA_URL } from "@decantr/verifier";
 var BOLD2 = "\x1B[1m";
 var DIM3 = "\x1B[2m";
 var GREEN3 = "\x1B[32m";
 var RED2 = "\x1B[31m";
 var RESET3 = "\x1B[0m";
-var CI_SCHEMA = "https://decantr.ai/schemas/decantr-ci-report.v1.json";
+var CI_SCHEMA = DECANTR_CI_REPORT_V2_SCHEMA_URL;
 function readJson(path) {
   if (!existsSync13(path)) return null;
   try {
@@ -3585,7 +3591,7 @@ function formatLocalLawText(summary, health) {
     lines.push(`  ${DIM3}[WARN] ${warning}${RESET3}`);
   }
   for (const finding of summary.findings.slice(0, 8)) {
-    const label = finding.severity.toUpperCase();
+    const label = finding.severity === "error" ? "Local law error" : finding.severity === "warn" ? "Local law warning" : "Local law info";
     lines.push(
       `  [${label}] ${finding.ruleId} ${finding.file}:${finding.line}:${finding.column} ${finding.message}`
     );
@@ -3687,6 +3693,9 @@ function formatProjectCiMarkdown(report) {
     `- Project: \`${report.projectPath ?? "."}\``,
     `- Status: **${report.status}**`,
     `- Fail on: \`${report.failOn}\``,
+    `- Loop: **${report.loop.state}**`,
+    `- Evidence tier: **${report.evidenceTier.stage}** / ${report.evidenceTier.confidence.level}`,
+    `- Authority: **${report.authority.activeLane}**`,
     `- Local law: ${report.localLaw.checked ? `${report.localLaw.errorCount} error(s), ${report.localLaw.warnCount} warning(s)` : "not accepted yet"}`,
     `- Style bridge: ${report.styleBridge.checked ? `${report.styleBridge.mappingCount} mapping(s)` : "not active"}`,
     "",
@@ -3706,6 +3715,7 @@ function formatWorkspaceCiMarkdown(report) {
     "- Mode: **workspace**",
     `- Status: **${report.status}**`,
     `- Fail on: \`${report.failOn}\``,
+    `- Loop: **${report.loop.state}**`,
     "",
     formatWorkspaceHealthMarkdown(report.workspace)
   ];
@@ -3862,6 +3872,7 @@ async function runWorkspaceCi(root, options) {
     mode: "workspace",
     failOn,
     status: workspaceStatus(workspace),
+    loop: workspace.loop,
     workspace
   };
   const json = `${JSON.stringify(report, null, 2)}
@@ -3900,6 +3911,9 @@ async function runProjectCi(root, options) {
     projectPath,
     failOn,
     status: projectCiStatus(health, localLaw, styleBridge),
+    loop: health.loop,
+    authority: health.authority,
+    evidenceTier: health.evidenceTier,
     health,
     localLaw,
     styleBridge
@@ -6671,80 +6685,226 @@ async function cmdRemoveFeature(feature, args, projectRoot = process.cwd()) {
   console.log(`${GREEN11}Derived files refreshed.${RESET11}`);
 }
 
-// src/commands/sync-drift.ts
-import { existsSync as existsSync25, readFileSync as readFileSync18, writeFileSync as writeFileSync15 } from "fs";
-import { join as join27 } from "path";
+// src/commands/resolve.ts
+import { existsSync as existsSync25, mkdirSync as mkdirSync14, readFileSync as readFileSync18, writeFileSync as writeFileSync15 } from "fs";
+import { dirname as dirname6, join as join27, resolve as resolve4 } from "path";
+var BOLD6 = "\x1B[1m";
+var DIM12 = "\x1B[2m";
 var GREEN12 = "\x1B[32m";
 var RED10 = "\x1B[31m";
 var YELLOW9 = "\x1B[33m";
 var RESET12 = "\x1B[0m";
-var DIM12 = "\x1B[2m";
-var BOLD6 = "\x1B[1m";
+function driftLogPath(projectRoot) {
+  return join27(projectRoot, ".decantr", "drift-log.json");
+}
+function readDriftLog(projectRoot) {
+  const path = driftLogPath(projectRoot);
+  if (!existsSync25(path)) return { version: 1, entries: [] };
+  try {
+    const parsed = JSON.parse(readFileSync18(path, "utf-8"));
+    return {
+      version: 1,
+      entries: Array.isArray(parsed.entries) ? parsed.entries : []
+    };
+  } catch {
+    return { version: 1, entries: [] };
+  }
+}
+function writeDriftLog(projectRoot, log) {
+  const path = driftLogPath(projectRoot);
+  mkdirSync14(dirname6(path), { recursive: true });
+  writeFileSync15(path, `${JSON.stringify(log, null, 2)}
+`, "utf-8");
+}
+function actionLabel(action) {
+  return `${action.kind}${action.command ? ` -> ${action.command}` : ""}`;
+}
+function appendDriftAction(projectRoot, conflict, action) {
+  const log = readDriftLog(projectRoot);
+  const status = action === "mark_advisory" ? "advisory" : "deferred";
+  const entry = {
+    id: `${action}:${conflict.id}:${Date.now()}`,
+    findingId: conflict.id,
+    action,
+    status,
+    message: conflict.message,
+    source: conflict.source,
+    severity: conflict.severity,
+    recordedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  log.entries = log.entries.filter(
+    (candidate) => !(candidate.findingId === conflict.id && candidate.action === action)
+  );
+  log.entries.push(entry);
+  writeDriftLog(projectRoot, log);
+  return driftLogPath(projectRoot);
+}
+function parseResolveArgs(args) {
+  const options = {};
+  for (let index = 1; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--json") options.json = true;
+    else if (arg === "--defer" && args[index + 1]) options.defer = args[++index];
+    else if (arg.startsWith("--defer=")) options.defer = arg.split("=")[1];
+    else if (arg === "--mark-advisory" && args[index + 1]) options.markAdvisory = args[++index];
+    else if (arg.startsWith("--mark-advisory=")) options.markAdvisory = arg.split("=")[1];
+  }
+  return options;
+}
+function groupConflicts(conflicts) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const conflict of conflicts) {
+    const key = conflict.lane;
+    grouped.set(key, [...grouped.get(key) ?? [], conflict]);
+  }
+  return grouped;
+}
+function formatAuthorityResolutionText(projectRoot, conflicts, summary, stopRule) {
+  const lines = [
+    `${BOLD6}Decantr Authority Resolver${RESET12}`,
+    "",
+    `${DIM12}${resolve4(projectRoot)}${RESET12}`,
+    `Authority: ${summary}`,
+    `Stop rule: ${stopRule}`,
+    ""
+  ];
+  if (conflicts.length === 0) {
+    lines.push(`${GREEN12}No authority conflicts found.${RESET12}`);
+    lines.push("");
+    lines.push(`Next: ${DIM12}Run decantr task <route> "<intent>" before editing.${RESET12}`);
+    return `${lines.join("\n")}
+`;
+  }
+  for (const [lane, laneConflicts] of groupConflicts(conflicts)) {
+    lines.push(`${BOLD6}${lane}:${RESET12}`);
+    for (const conflict of laneConflicts) {
+      const color = conflict.status === "blocking" ? RED10 : conflict.status === "repairable" ? YELLOW9 : DIM12;
+      lines.push(`  ${color}[${conflict.status}]${RESET12} ${conflict.id}: ${conflict.message}`);
+      lines.push(
+        `    ${DIM12}${conflict.source} / ${conflict.category} / ${conflict.severity}${RESET12}`
+      );
+      for (const action of conflict.recommendedActions.slice(0, 4)) {
+        lines.push(`    - ${actionLabel(action)}`);
+      }
+    }
+    lines.push("");
+  }
+  lines.push(`${BOLD6}Read-only by default:${RESET12}`);
+  lines.push(
+    "  Use --defer <finding-id> or --mark-advisory <finding-id> to write only .decantr/drift-log.json."
+  );
+  return `${lines.join("\n")}
+`;
+}
+async function cmdResolve(projectRoot = process.cwd(), args = ["resolve"]) {
+  const options = parseResolveArgs(args);
+  const report = await createProjectHealthReport(projectRoot);
+  const resolution = report.authority;
+  if (options.defer || options.markAdvisory) {
+    const findingId = options.defer ?? options.markAdvisory;
+    const conflict = resolution.conflicts.find((entry) => entry.id === findingId);
+    if (!conflict) {
+      console.error(`${RED10}No authority conflict found for finding: ${findingId}${RESET12}`);
+      process.exitCode = 1;
+      return;
+    }
+    const path = appendDriftAction(
+      projectRoot,
+      conflict,
+      options.defer ? "defer_to_drift_log" : "mark_advisory"
+    );
+    console.log(`${GREEN12}Updated drift log:${RESET12} ${path}`);
+    return;
+  }
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(resolution, null, 2)}
+`);
+    return;
+  }
+  process.stdout.write(
+    formatAuthorityResolutionText(
+      projectRoot,
+      resolution.conflicts,
+      resolution.summary,
+      resolution.stopRule
+    )
+  );
+}
+
+// src/commands/sync-drift.ts
+import { existsSync as existsSync26, readFileSync as readFileSync19, writeFileSync as writeFileSync16 } from "fs";
+import { join as join28 } from "path";
+var GREEN13 = "\x1B[32m";
+var RED11 = "\x1B[31m";
+var YELLOW10 = "\x1B[33m";
+var RESET13 = "\x1B[0m";
+var DIM13 = "\x1B[2m";
+var BOLD7 = "\x1B[1m";
 var CYAN6 = "\x1B[36m";
 async function cmdSyncDrift(projectRoot = process.cwd()) {
-  const driftLogPath = join27(projectRoot, ".decantr", "drift-log.json");
-  if (!existsSync25(driftLogPath)) {
-    console.log(`${GREEN12}No drift log found \u2014 no drift recorded.${RESET12}`);
+  const driftLogPath2 = join28(projectRoot, ".decantr", "drift-log.json");
+  if (!existsSync26(driftLogPath2)) {
+    console.log(`${GREEN13}No drift log found \u2014 no drift recorded.${RESET13}`);
     console.log(
-      `${DIM12}Drift is logged when guard violations are detected during development.${RESET12}`
+      `${DIM13}Drift is logged when guard violations are detected during development.${RESET13}`
     );
     return;
   }
   let entries;
   try {
-    entries = JSON.parse(readFileSync18(driftLogPath, "utf-8"));
+    entries = JSON.parse(readFileSync19(driftLogPath2, "utf-8"));
   } catch {
-    console.error(`${RED10}Could not parse drift-log.json${RESET12}`);
+    console.error(`${RED11}Could not parse drift-log.json${RESET13}`);
     process.exitCode = 1;
     return;
   }
   if (!Array.isArray(entries)) {
-    console.error(`${RED10}drift-log.json is not an array${RESET12}`);
+    console.error(`${RED11}drift-log.json is not an array${RESET13}`);
     process.exitCode = 1;
     return;
   }
   const unresolved = entries.filter((e) => !e.resolved);
   const resolved = entries.filter((e) => e.resolved);
   if (unresolved.length === 0) {
-    console.log(`${GREEN12}No unresolved drift entries.${RESET12}`);
+    console.log(`${GREEN13}No unresolved drift entries.${RESET13}`);
     if (resolved.length > 0) {
-      console.log(`${DIM12}${resolved.length} previously resolved entries in the log.${RESET12}`);
+      console.log(`${DIM13}${resolved.length} previously resolved entries in the log.${RESET13}`);
     }
     return;
   }
   console.log(`
-${BOLD6}Unresolved Drift Entries (${unresolved.length})${RESET12}
+${BOLD7}Unresolved Drift Entries (${unresolved.length})${RESET13}
 `);
   for (let i = 0; i < unresolved.length; i++) {
     const entry = unresolved[i];
-    const severityColor = entry.severity === "error" ? RED10 : YELLOW9;
+    const severityColor = entry.severity === "error" ? RED11 : YELLOW10;
     const icon = entry.severity === "error" ? "x" : "!";
     console.log(
-      `  ${severityColor}${icon}${RESET12} ${BOLD6}#${i + 1}${RESET12} [${entry.rule}] ${entry.message}`
+      `  ${severityColor}${icon}${RESET13} ${BOLD7}#${i + 1}${RESET13} [${entry.rule}] ${entry.message}`
     );
     if (entry.page) {
-      console.log(`    ${DIM12}Page: ${entry.page}${RESET12}`);
+      console.log(`    ${DIM13}Page: ${entry.page}${RESET13}`);
     }
     if (entry.suggestion) {
-      console.log(`    ${CYAN6}Suggestion: ${entry.suggestion}${RESET12}`);
+      console.log(`    ${CYAN6}Suggestion: ${entry.suggestion}${RESET13}`);
     }
-    console.log(`    ${DIM12}${entry.timestamp}${RESET12}`);
+    console.log(`    ${DIM13}${entry.timestamp}${RESET13}`);
     console.log("");
   }
-  console.log(`${BOLD6}Actions:${RESET12}`);
-  console.log(`  ${CYAN6}decantr sync-drift --resolve-all${RESET12}   Mark all entries as resolved`);
-  console.log(`  ${CYAN6}decantr sync-drift --resolve <n>${RESET12}   Mark entry #n as resolved`);
-  console.log(`  ${CYAN6}decantr sync-drift --clear${RESET12}         Clear the entire drift log`);
+  console.log(`${BOLD7}Actions:${RESET13}`);
+  console.log(`  ${CYAN6}decantr sync-drift --resolve-all${RESET13}   Mark all entries as resolved`);
+  console.log(`  ${CYAN6}decantr sync-drift --resolve <n>${RESET13}   Mark entry #n as resolved`);
+  console.log(`  ${CYAN6}decantr sync-drift --clear${RESET13}         Clear the entire drift log`);
   console.log("");
 }
 function resolveDriftEntries(projectRoot, options) {
-  const driftLogPath = join27(projectRoot, ".decantr", "drift-log.json");
-  if (!existsSync25(driftLogPath)) {
+  const driftLogPath2 = join28(projectRoot, ".decantr", "drift-log.json");
+  if (!existsSync26(driftLogPath2)) {
     return { success: true };
   }
   if (options.clear) {
     try {
-      writeFileSync15(driftLogPath, "[]");
+      writeFileSync16(driftLogPath2, "[]");
       return { success: true };
     } catch (e) {
       return { success: false, error: `Could not clear drift log: ${e.message}` };
@@ -6752,7 +6912,7 @@ function resolveDriftEntries(projectRoot, options) {
   }
   let entries;
   try {
-    entries = JSON.parse(readFileSync18(driftLogPath, "utf-8"));
+    entries = JSON.parse(readFileSync19(driftLogPath2, "utf-8"));
   } catch {
     return { success: false, error: "Could not parse drift-log.json" };
   }
@@ -6771,7 +6931,7 @@ function resolveDriftEntries(projectRoot, options) {
     }
   }
   try {
-    writeFileSync15(driftLogPath, JSON.stringify(entries, null, 2));
+    writeFileSync16(driftLogPath2, JSON.stringify(entries, null, 2));
     return { success: true };
   } catch (e) {
     return { success: false, error: `Could not write drift log: ${e.message}` };
@@ -6780,11 +6940,11 @@ function resolveDriftEntries(projectRoot, options) {
 
 // src/commands/telemetry.ts
 import { DECANTR_TELEMETRY_EVENT_CATALOG } from "@decantr/telemetry";
-var BOLD7 = "\x1B[1m";
+var BOLD8 = "\x1B[1m";
 var CYAN7 = "\x1B[36m";
-var DIM13 = "\x1B[2m";
-var GREEN13 = "\x1B[32m";
-var RESET13 = "\x1B[0m";
+var DIM14 = "\x1B[2m";
+var GREEN14 = "\x1B[32m";
+var RESET14 = "\x1B[0m";
 var DEFAULT_API_URL = "https://api.decantr.ai/v1";
 async function cmdTelemetry(args, projectRoot = process.cwd()) {
   const subcommand = args[0] ?? "status";
@@ -6809,14 +6969,14 @@ async function cmdTelemetry(args, projectRoot = process.cwd()) {
 }
 function printTelemetryHelp() {
   console.log(`
-${BOLD7}decantr telemetry${RESET13} \u2014 Inspect and link privacy-filtered CLI telemetry identity
+${BOLD8}decantr telemetry${RESET14} \u2014 Inspect and link privacy-filtered CLI telemetry identity
 
-${BOLD7}Usage:${RESET13}
+${BOLD8}Usage:${RESET14}
   decantr telemetry status [--json]
   decantr telemetry explain [--json]
   decantr telemetry link [--enable] [--org <slug>] [--label <label>] [--api-key <key>] [--api-url <url>]
 
-${BOLD7}Examples:${RESET13}
+${BOLD8}Examples:${RESET14}
   decantr init --telemetry
   decantr telemetry status
   decantr telemetry explain
@@ -6831,18 +6991,18 @@ function printTelemetryStatus(projectRoot, options) {
     return;
   }
   console.log(`
-${BOLD7}Decantr telemetry${RESET13}`);
-  console.log(`  Enabled:    ${status.enabled ? `${GREEN13}yes${RESET13}` : "no"}`);
+${BOLD8}Decantr telemetry${RESET14}`);
+  console.log(`  Enabled:    ${status.enabled ? `${GREEN14}yes${RESET14}` : "no"}`);
   console.log(`  Project:    ${status.hasProjectConfig ? status.projectRoot : "not initialized"}`);
-  console.log(`  Install ID: ${status.installId ?? `${DIM13}not created yet${RESET13}`}`);
-  console.log(`  Project ID: ${status.projectId ?? `${DIM13}not created yet${RESET13}`}`);
+  console.log(`  Install ID: ${status.installId ?? `${DIM14}not created yet${RESET14}`}`);
+  console.log(`  Project ID: ${status.projectId ?? `${DIM14}not created yet${RESET14}`}`);
   if (status.enabled) {
     console.log(
-      DIM13 + "Run `decantr telemetry link` after login to attach these opaque IDs to your Decantr account/org." + RESET13
+      DIM14 + "Run `decantr telemetry link` after login to attach these opaque IDs to your Decantr account/org." + RESET14
     );
   } else {
     console.log(
-      DIM13 + "Run `decantr init --telemetry` or `decantr telemetry link --enable` to opt in." + RESET13
+      DIM14 + "Run `decantr init --telemetry` or `decantr telemetry link --enable` to opt in." + RESET14
     );
   }
 }
@@ -6904,25 +7064,25 @@ function printTelemetryExplain(projectRoot, options) {
     return;
   }
   console.log(`
-${BOLD7}Decantr telemetry explanation${RESET13}`);
+${BOLD8}Decantr telemetry explanation${RESET14}`);
   console.log(`  Source:     cli`);
-  console.log(`  Enabled:    ${status.enabled ? `${GREEN13}yes${RESET13}` : "no"}`);
-  console.log(`  Install ID: ${status.installId ?? `${DIM13}not created yet${RESET13}`}`);
-  console.log(`  Project ID: ${status.projectId ?? `${DIM13}not created yet${RESET13}`}`);
+  console.log(`  Enabled:    ${status.enabled ? `${GREEN14}yes${RESET14}` : "no"}`);
+  console.log(`  Install ID: ${status.installId ?? `${DIM14}not created yet${RESET14}`}`);
+  console.log(`  Project ID: ${status.projectId ?? `${DIM14}not created yet${RESET14}`}`);
   console.log(`  Events:     ${cliEvents.length} CLI event types in the public catalog`);
   console.log(`
-${BOLD7}Aggregate fields${RESET13}`);
+${BOLD8}Aggregate fields${RESET14}`);
   for (const field of report.aggregateFields) {
     console.log(`  - ${field}`);
   }
   console.log(`
-${BOLD7}Never collected${RESET13}`);
+${BOLD8}Never collected${RESET14}`);
   for (const field of report.neverCollected) {
     console.log(`  - ${field}`);
   }
   console.log(`
-${DIM13}${report.controls.optOut}${RESET13}`);
-  console.log(`${DIM13}${report.controls.link}${RESET13}`);
+${DIM14}${report.controls.optOut}${RESET14}`);
+  console.log(`${DIM14}${report.controls.link}${RESET14}`);
 }
 async function linkTelemetryIdentity(projectRoot, options) {
   if (options.enable && !isOptedIn(projectRoot)) {
@@ -6964,13 +7124,13 @@ async function linkTelemetryIdentity(projectRoot, options) {
     throw new Error(body2?.error ?? `Telemetry link failed with HTTP ${response.status}.`);
   }
   const body = await response.json().catch(() => ({ linked: 0 }));
-  console.log(`${GREEN13}Telemetry identity linked.${RESET13}`);
+  console.log(`${GREEN14}Telemetry identity linked.${RESET14}`);
   console.log(`  Linked:     ${body.linked ?? 0}`);
-  console.log(`  Install ID: ${identity.installId ?? `${DIM13}none${RESET13}`}`);
-  console.log(`  Project ID: ${identity.projectId ?? `${DIM13}none${RESET13}`}`);
-  if (options.org) console.log(`  Org:        ${CYAN7}${options.org}${RESET13}`);
+  console.log(`  Install ID: ${identity.installId ?? `${DIM14}none${RESET14}`}`);
+  console.log(`  Project ID: ${identity.projectId ?? `${DIM14}none${RESET14}`}`);
+  if (options.org) console.log(`  Org:        ${CYAN7}${options.org}${RESET14}`);
   console.log(
-    DIM13 + "These opaque IDs now attribute opted-in CLI usage to your Decantr account/org." + RESET13
+    DIM14 + "These opaque IDs now attribute opted-in CLI usage to your Decantr account/org." + RESET14
   );
 }
 function parseTelemetryOptions(args) {
@@ -7008,41 +7168,41 @@ function trimTrailingSlashes(value) {
 }
 
 // src/commands/theme-switch.ts
-import { existsSync as existsSync26, readFileSync as readFileSync19, writeFileSync as writeFileSync16 } from "fs";
-import { join as join28 } from "path";
+import { existsSync as existsSync27, readFileSync as readFileSync20, writeFileSync as writeFileSync17 } from "fs";
+import { join as join29 } from "path";
 import { isV4 as isV47 } from "@decantr/essence-spec";
-var GREEN14 = "\x1B[32m";
-var RED11 = "\x1B[31m";
-var YELLOW10 = "\x1B[33m";
-var DIM14 = "\x1B[2m";
-var RESET14 = "\x1B[0m";
+var GREEN15 = "\x1B[32m";
+var RED12 = "\x1B[31m";
+var YELLOW11 = "\x1B[33m";
+var DIM15 = "\x1B[2m";
+var RESET15 = "\x1B[0m";
 var VALID_THEME_SHAPES = ["sharp", "rounded", "pill"];
 var VALID_THEME_MODES = ["light", "dark", "auto"];
 async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   if (!themeName) {
     console.error(
-      `${RED11}Usage: decantr theme switch <themeName> [--shape <s>] [--mode <m>]${RESET14}`
+      `${RED12}Usage: decantr theme switch <themeName> [--shape <s>] [--mode <m>]${RESET15}`
     );
     process.exitCode = 1;
     return;
   }
-  const essencePath = join28(projectRoot, "decantr.essence.json");
-  if (!existsSync26(essencePath)) {
-    console.error(`${RED11}No decantr.essence.json found. Run \`decantr init\` first.${RESET14}`);
+  const essencePath = join29(projectRoot, "decantr.essence.json");
+  if (!existsSync27(essencePath)) {
+    console.error(`${RED12}No decantr.essence.json found. Run \`decantr init\` first.${RESET15}`);
     process.exitCode = 1;
     return;
   }
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync19(essencePath, "utf-8"));
+    parsed = JSON.parse(readFileSync20(essencePath, "utf-8"));
   } catch (e) {
-    console.error(`${RED11}Could not read essence: ${e.message}${RESET14}`);
+    console.error(`${RED12}Could not read essence: ${e.message}${RESET15}`);
     process.exitCode = 1;
     return;
   }
   if (!isV47(parsed)) {
     console.error(
-      `${RED11}Active workflows require Essence v4.0.0. Run \`decantr migrate --to v4\` first.${RESET14}`
+      `${RED12}Active workflows require Essence v4.0.0. Run \`decantr migrate --to v4\` first.${RESET15}`
     );
     process.exitCode = 1;
     return;
@@ -7064,14 +7224,14 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   }
   if (shape && !VALID_THEME_SHAPES.includes(shape)) {
     console.error(
-      `${RED11}Invalid shape "${shape}". Must be one of: ${VALID_THEME_SHAPES.join(", ")}.${RESET14}`
+      `${RED12}Invalid shape "${shape}". Must be one of: ${VALID_THEME_SHAPES.join(", ")}.${RESET15}`
     );
     process.exitCode = 1;
     return;
   }
   if (mode && !VALID_THEME_MODES.includes(mode)) {
     console.error(
-      `${RED11}Invalid mode "${mode}". Must be one of: ${VALID_THEME_MODES.join(", ")}.${RESET14}`
+      `${RED12}Invalid mode "${mode}". Must be one of: ${VALID_THEME_MODES.join(", ")}.${RESET15}`
     );
     process.exitCode = 1;
     return;
@@ -7085,7 +7245,7 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
     essence.dna.theme.mode = mode;
   }
   const registryClient = new RegistryClient({
-    cacheDir: join28(projectRoot, ".decantr", "cache")
+    cacheDir: join29(projectRoot, ".decantr", "cache")
   });
   try {
     const themeResult = await registryClient.fetchTheme(themeName);
@@ -7100,45 +7260,45 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
     }
   } catch {
   }
-  writeFileSync16(essencePath, JSON.stringify(essence, null, 2) + "\n");
-  console.log(`${GREEN14}Switched theme: ${oldThemeId} \u2192 ${themeName}${RESET14}`);
-  if (shape) console.log(`  ${DIM14}Shape: ${shape}${RESET14}`);
-  if (mode) console.log(`  ${DIM14}Mode: ${mode}${RESET14}`);
+  writeFileSync17(essencePath, JSON.stringify(essence, null, 2) + "\n");
+  console.log(`${GREEN15}Switched theme: ${oldThemeId} \u2192 ${themeName}${RESET15}`);
+  if (shape) console.log(`  ${DIM15}Shape: ${shape}${RESET15}`);
+  if (mode) console.log(`  ${DIM15}Mode: ${mode}${RESET15}`);
   await refreshDerivedFiles(projectRoot, essence, registryClient);
   console.log(
-    `${GREEN14}Derived files refreshed (tokens.css, treatments.css, all contexts).${RESET14}`
+    `${GREEN15}Derived files refreshed (tokens.css, treatments.css, all contexts).${RESET15}`
   );
-  console.log(`${YELLOW10}Guard will flag code using old tokens. Run \`decantr check\`.${RESET14}`);
+  console.log(`${YELLOW11}Guard will flag code using old tokens. Run \`decantr check\`.${RESET15}`);
 }
 
 // src/prompts.ts
 import { createInterface } from "readline";
-var BOLD8 = "\x1B[1m";
-var DIM15 = "\x1B[2m";
-var RESET15 = "\x1B[0m";
-var GREEN15 = "\x1B[32m";
-var YELLOW11 = "\x1B[33m";
+var BOLD9 = "\x1B[1m";
+var DIM16 = "\x1B[2m";
+var RESET16 = "\x1B[0m";
+var GREEN16 = "\x1B[32m";
+var YELLOW12 = "\x1B[33m";
 var CYAN8 = "\x1B[36m";
 function ask(question, defaultValue) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const prompt = defaultValue ? `${question} ${DIM15}(${defaultValue})${RESET15}: ` : `${question}: `;
-  return new Promise((resolve5) => {
+  const prompt = defaultValue ? `${question} ${DIM16}(${defaultValue})${RESET16}: ` : `${question}: `;
+  return new Promise((resolve6) => {
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve5(answer.trim() || defaultValue || "");
+      resolve6(answer.trim() || defaultValue || "");
     });
   });
 }
 async function select(question, options, defaultIdx = 0, allowOther = false) {
   console.log(`
-${BOLD8}${question}${RESET15}`);
+${BOLD9}${question}${RESET16}`);
   for (let i = 0; i < options.length; i++) {
-    const marker = i === defaultIdx ? `${GREEN15}>${RESET15}` : " ";
-    const desc = options[i].description ? ` ${DIM15}\u2014 ${options[i].description}${RESET15}` : "";
+    const marker = i === defaultIdx ? `${GREEN16}>${RESET16}` : " ";
+    const desc = options[i].description ? ` ${DIM16}\u2014 ${options[i].description}${RESET16}` : "";
     console.log(`  ${marker} ${i + 1}. ${options[i].label}${desc}`);
   }
   if (allowOther) {
-    console.log(`    ${options.length + 1}. ${DIM15}other (enter custom value)${RESET15}`);
+    console.log(`    ${options.length + 1}. ${DIM16}other (enter custom value)${RESET16}`);
   }
   const maxIdx = allowOther ? options.length + 1 : options.length;
   const answer = await ask(`Choose (1-${maxIdx})`, String(defaultIdx + 1));
@@ -7157,11 +7317,11 @@ async function confirm(question, defaultYes = true) {
 }
 function warn(message) {
   console.log(`
-${YELLOW11}  Warning: ${message}${RESET15}`);
+${YELLOW12}  Warning: ${message}${RESET16}`);
 }
 function showDetection(detected) {
   console.log(`
-${CYAN8}Detected project configuration:${RESET15}`);
+${CYAN8}Detected project configuration:${RESET16}`);
   if (detected.framework !== "unknown") {
     const version = detected.version ? ` ${detected.version}` : "";
     console.log(`  Framework: ${detected.framework}${version}`);
@@ -7170,13 +7330,13 @@ ${CYAN8}Detected project configuration:${RESET15}`);
     console.log(`  Package manager: ${detected.packageManager}`);
   }
   if (detected.hasTypeScript) {
-    console.log(`  TypeScript: ${GREEN15}yes${RESET15}`);
+    console.log(`  TypeScript: ${GREEN16}yes${RESET16}`);
   }
   if (detected.hasTailwind) {
-    console.log(`  Tailwind CSS: ${GREEN15}yes${RESET15}`);
+    console.log(`  Tailwind CSS: ${GREEN16}yes${RESET16}`);
   }
   if (detected.existingEssence) {
-    console.log(`  Existing essence: ${YELLOW11}yes${RESET15}`);
+    console.log(`  Existing essence: ${YELLOW12}yes${RESET16}`);
   }
 }
 async function runInteractivePrompts(detected, archetypes, blueprints, themes, workflowSeed) {
@@ -7251,7 +7411,7 @@ async function runInteractivePrompts(detected, archetypes, blueprints, themes, w
     warn(`This project appears to be ${detected.framework} but you selected ${target}.`);
     const proceed = await confirm("Continue anyway?", false);
     if (!proceed) {
-      console.log(`${DIM15}Using detected framework: ${detected.framework}${RESET15}`);
+      console.log(`${DIM16}Using detected framework: ${detected.framework}${RESET16}`);
     }
   }
   const guardMode = await select(
@@ -7376,7 +7536,7 @@ function mergeWithDefaults(flags, detected, workflowSeed) {
 }
 async function runSimplifiedInit(blueprints) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const question = (q) => new Promise((resolve5) => rl.question(q, resolve5));
+  const question = (q) => new Promise((resolve6) => rl.question(q, resolve6));
   console.log("\n? What blueprint would you like to scaffold?\n");
   console.log("  1. Decantr default (recommended)");
   console.log("  2. Search registry...\n");
@@ -7408,8 +7568,8 @@ async function runSimplifiedInit(blueprints) {
 }
 
 // src/theme-commands.ts
-import { existsSync as existsSync27, mkdirSync as mkdirSync14, readdirSync as readdirSync7, readFileSync as readFileSync20, rmSync as rmSync3, writeFileSync as writeFileSync17 } from "fs";
-import { join as join29 } from "path";
+import { existsSync as existsSync28, mkdirSync as mkdirSync15, readdirSync as readdirSync7, readFileSync as readFileSync21, rmSync as rmSync3, writeFileSync as writeFileSync18 } from "fs";
+import { join as join30 } from "path";
 var REQUIRED_FIELDS = [
   "$schema",
   "id",
@@ -7469,20 +7629,20 @@ function validateCustomTheme(theme) {
   };
 }
 function createTheme(projectRoot, id, name) {
-  const customThemesDir = join29(projectRoot, ".decantr", "custom", "themes");
-  const themePath = join29(customThemesDir, `${id}.json`);
-  const howToPath = join29(customThemesDir, "how-to-theme.md");
-  mkdirSync14(customThemesDir, { recursive: true });
-  if (existsSync27(themePath)) {
+  const customThemesDir = join30(projectRoot, ".decantr", "custom", "themes");
+  const themePath = join30(customThemesDir, `${id}.json`);
+  const howToPath = join30(customThemesDir, "how-to-theme.md");
+  mkdirSync15(customThemesDir, { recursive: true });
+  if (existsSync28(themePath)) {
     return {
       success: false,
       error: `Theme "${id}" already exists at ${themePath}`
     };
   }
   const skeleton = getThemeSkeleton(id, name);
-  writeFileSync17(themePath, JSON.stringify(skeleton, null, 2));
-  if (!existsSync27(howToPath)) {
-    writeFileSync17(howToPath, getHowToThemeDoc());
+  writeFileSync18(themePath, JSON.stringify(skeleton, null, 2));
+  if (!existsSync28(howToPath)) {
+    writeFileSync18(howToPath, getHowToThemeDoc());
   }
   return {
     success: true,
@@ -7490,17 +7650,17 @@ function createTheme(projectRoot, id, name) {
   };
 }
 function listCustomThemes(projectRoot) {
-  const customThemesDir = join29(projectRoot, ".decantr", "custom", "themes");
-  if (!existsSync27(customThemesDir)) {
+  const customThemesDir = join30(projectRoot, ".decantr", "custom", "themes");
+  if (!existsSync28(customThemesDir)) {
     return [];
   }
   const themes = [];
   try {
     const files = readdirSync7(customThemesDir).filter((f) => f.endsWith(".json"));
     for (const file of files) {
-      const filePath = join29(customThemesDir, file);
+      const filePath = join30(customThemesDir, file);
       try {
-        const data = JSON.parse(readFileSync20(filePath, "utf-8"));
+        const data = JSON.parse(readFileSync21(filePath, "utf-8"));
         themes.push({
           id: data.id || file.replace(".json", ""),
           name: data.name || data.id,
@@ -7515,8 +7675,8 @@ function listCustomThemes(projectRoot) {
   return themes;
 }
 function deleteTheme(projectRoot, id) {
-  const themePath = join29(projectRoot, ".decantr", "custom", "themes", `${id}.json`);
-  if (!existsSync27(themePath)) {
+  const themePath = join30(projectRoot, ".decantr", "custom", "themes", `${id}.json`);
+  if (!existsSync28(themePath)) {
     return {
       success: false,
       error: `Theme "${id}" not found at ${themePath}`
@@ -7533,7 +7693,7 @@ function deleteTheme(projectRoot, id) {
   }
 }
 function importTheme(projectRoot, sourcePath) {
-  if (!existsSync27(sourcePath)) {
+  if (!existsSync28(sourcePath)) {
     return {
       success: false,
       errors: [`Source file not found: ${sourcePath}`]
@@ -7541,7 +7701,7 @@ function importTheme(projectRoot, sourcePath) {
   }
   let theme;
   try {
-    theme = JSON.parse(readFileSync20(sourcePath, "utf-8"));
+    theme = JSON.parse(readFileSync21(sourcePath, "utf-8"));
   } catch (e) {
     return {
       success: false,
@@ -7557,14 +7717,14 @@ function importTheme(projectRoot, sourcePath) {
   }
   theme.source = "custom";
   const id = theme.id;
-  const customThemesDir = join29(projectRoot, ".decantr", "custom", "themes");
-  const destPath = join29(customThemesDir, `${id}.json`);
-  mkdirSync14(customThemesDir, { recursive: true });
-  const howToPath = join29(customThemesDir, "how-to-theme.md");
-  if (!existsSync27(howToPath)) {
-    writeFileSync17(howToPath, getHowToThemeDoc());
-  }
-  writeFileSync17(destPath, JSON.stringify(theme, null, 2));
+  const customThemesDir = join30(projectRoot, ".decantr", "custom", "themes");
+  const destPath = join30(customThemesDir, `${id}.json`);
+  mkdirSync15(customThemesDir, { recursive: true });
+  const howToPath = join30(customThemesDir, "how-to-theme.md");
+  if (!existsSync28(howToPath)) {
+    writeFileSync18(howToPath, getHowToThemeDoc());
+  }
+  writeFileSync18(destPath, JSON.stringify(theme, null, 2));
   return {
     success: true,
     path: destPath
@@ -7572,29 +7732,29 @@ function importTheme(projectRoot, sourcePath) {
 }
 
 // src/index.ts
-var BOLD9 = "\x1B[1m";
-var DIM16 = "\x1B[2m";
-var RESET16 = "\x1B[0m";
-var RED12 = "\x1B[31m";
-var GREEN16 = "\x1B[32m";
+var BOLD10 = "\x1B[1m";
+var DIM17 = "\x1B[2m";
+var RESET17 = "\x1B[0m";
+var RED13 = "\x1B[31m";
+var GREEN17 = "\x1B[32m";
 var CYAN9 = "\x1B[36m";
-var YELLOW12 = "\x1B[33m";
+var YELLOW13 = "\x1B[33m";
 function heading2(text) {
   return `
-${BOLD9}${text}${RESET16}
+${BOLD10}${text}${RESET17}
 `;
 }
 function success3(text) {
-  return `${GREEN16}${text}${RESET16}`;
+  return `${GREEN17}${text}${RESET17}`;
 }
 function error2(text) {
-  return `${RED12}${text}${RESET16}`;
+  return `${RED13}${text}${RESET17}`;
 }
 function dim3(text) {
-  return `${DIM16}${text}${RESET16}`;
+  return `${DIM17}${text}${RESET17}`;
 }
 function cyan3(text) {
-  return `${CYAN9}${text}${RESET16}`;
+  return `${CYAN9}${text}${RESET17}`;
 }
 function formatIntelligenceSummary(intelligence) {
   if (!intelligence) {
@@ -8098,7 +8258,7 @@ function getPublicAPIClient() {
   });
 }
 function resolveUserPath(inputPath, cwd = process.cwd()) {
-  return isAbsolute3(inputPath) ? inputPath : resolve4(cwd, inputPath);
+  return isAbsolute3(inputPath) ? inputPath : resolve5(cwd, inputPath);
 }
 function extractHostedAssetPaths(indexHtml) {
   const assetPaths = /* @__PURE__ */ new Set();
@@ -8111,18 +8271,18 @@ function extractHostedAssetPaths(indexHtml) {
   return [...assetPaths];
 }
 function readHostedDistSnapshot(distPath) {
-  const resolvedDistPath = distPath ? resolveUserPath(distPath) : join30(process.cwd(), "dist");
-  const indexPath = join30(resolvedDistPath, "index.html");
-  if (!existsSync28(indexPath)) {
+  const resolvedDistPath = distPath ? resolveUserPath(distPath) : join31(process.cwd(), "dist");
+  const indexPath = join31(resolvedDistPath, "index.html");
+  if (!existsSync29(indexPath)) {
     return void 0;
   }
-  const indexHtml = readFileSync21(indexPath, "utf-8");
+  const indexHtml = readFileSync22(indexPath, "utf-8");
   const assetPaths = extractHostedAssetPaths(indexHtml);
   const assets = {};
   for (const assetPath of assetPaths) {
-    const assetFilePath = join30(resolvedDistPath, assetPath.replace(/^[/\\]+/, ""));
-    if (existsSync28(assetFilePath)) {
-      assets[assetPath] = readFileSync21(assetFilePath, "utf-8");
+    const assetFilePath = join31(resolvedDistPath, assetPath.replace(/^[/\\]+/, ""));
+    if (existsSync29(assetFilePath)) {
+      assets[assetPath] = readFileSync22(assetFilePath, "utf-8");
     }
   }
   return {
@@ -8137,7 +8297,7 @@ function isHostedSourceSnapshotFile(path) {
 function readHostedSourceSnapshot(sourcePath) {
   if (!sourcePath) return void 0;
   const resolvedSourcePath = resolveUserPath(sourcePath);
-  if (!existsSync28(resolvedSourcePath)) {
+  if (!existsSync29(resolvedSourcePath)) {
     return void 0;
   }
   const files = {};
@@ -8153,15 +8313,15 @@ function readHostedSourceSnapshot(sourcePath) {
   const walk = (absoluteDir, relativeDir) => {
     for (const entry of readdirSync8(absoluteDir, { withFileTypes: true })) {
       if (ignoredDirNames.has(entry.name)) continue;
-      const absolutePath = join30(absoluteDir, entry.name);
-      const relativePath = join30(relativeDir, entry.name).replace(/\\/g, "/");
+      const absolutePath = join31(absoluteDir, entry.name);
+      const relativePath = join31(relativeDir, entry.name).replace(/\\/g, "/");
       if (entry.isDirectory()) {
         walk(absolutePath, relativePath);
         continue;
       }
       if (!entry.isFile()) continue;
       if (!isHostedSourceSnapshotFile(relativePath)) continue;
-      files[relativePath] = readFileSync21(absolutePath, "utf-8");
+      files[relativePath] = readFileSync22(absolutePath, "utf-8");
     }
   };
   walk(resolvedSourcePath, rootPrefix);
@@ -8345,7 +8505,7 @@ async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput
     console.log(`  Files written: ${writtenContextPaths.length}`);
   }
   console.log("");
-  console.log(`${BOLD9}Route Plan:${RESET16}`);
+  console.log(`${BOLD10}Route Plan:${RESET17}`);
   for (const route of typedBundle.scaffold.data.routes) {
     const patterns = route.patternIds.length > 0 ? route.patternIds.join(", ") : "none";
     const pageLabel = route.sectionId ? `${route.sectionId}/${route.pageId}` : route.pageId;
@@ -8354,24 +8514,24 @@ async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput
 }
 async function compileHostedExecutionPackBundle(essencePath, namespace) {
   const client = getPublicAPIClient();
-  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join30(process.cwd(), "decantr.essence.json");
-  if (!existsSync28(resolvedPath)) {
+  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join31(process.cwd(), "decantr.essence.json");
+  if (!existsSync29(resolvedPath)) {
     throw new Error(`Essence file not found at ${resolvedPath}`);
   }
-  const essence = JSON.parse(readFileSync21(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync22(resolvedPath, "utf-8"));
   const bundle = await client.compileExecutionPacks(essence, namespace ? { namespace } : void 0);
-  const contextDir = join30(dirname6(resolvedPath), ".decantr", "context");
+  const contextDir = join31(dirname7(resolvedPath), ".decantr", "context");
   return { resolvedPath, bundle, contextDir };
 }
 function writeHostedExecutionPackContextArtifacts(contextDir, bundle) {
-  mkdirSync15(contextDir, { recursive: true });
+  mkdirSync16(contextDir, { recursive: true });
   return writeExecutionPackBundleArtifacts(contextDir, bundle);
 }
 function resolvePagePackIdForRoute(essencePath, route) {
-  if (!existsSync28(essencePath)) {
+  if (!existsSync29(essencePath)) {
     throw new Error(`Essence file not found at ${essencePath}`);
   }
-  const essence = JSON.parse(readFileSync21(essencePath, "utf-8"));
+  const essence = JSON.parse(readFileSync22(essencePath, "utf-8"));
   if (!isV48(essence)) {
     throw new Error("Route-based pack resolution requires Essence v4.0.0.");
   }
@@ -8386,14 +8546,14 @@ function resolvePagePackIdForRoute(essencePath, route) {
 }
 async function printHostedSelectedExecutionPack(packType, id, essencePath, namespace, jsonOutput = false, writeContext = false) {
   const client = getPublicAPIClient();
-  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join30(process.cwd(), "decantr.essence.json");
-  if (!existsSync28(resolvedPath)) {
+  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join31(process.cwd(), "decantr.essence.json");
+  if (!existsSync29(resolvedPath)) {
     throw new Error(`Essence file not found at ${resolvedPath}`);
   }
   if ((packType === "section" || packType === "page" || packType === "mutation") && !id) {
     throw new Error(`Pack type "${packType}" requires an id.`);
   }
-  const essence = JSON.parse(readFileSync21(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync22(resolvedPath, "utf-8"));
   const selected = await client.selectExecutionPack(
     {
       essence,
@@ -8404,17 +8564,17 @@ async function printHostedSelectedExecutionPack(packType, id, essencePath, names
   );
   let writtenContextDir = null;
   if (writeContext) {
-    const contextDir = join30(dirname6(resolvedPath), ".decantr", "context");
-    mkdirSync15(contextDir, { recursive: true });
-    writeFileSync18(
-      join30(contextDir, "pack-manifest.json"),
+    const contextDir = join31(dirname7(resolvedPath), ".decantr", "context");
+    mkdirSync16(contextDir, { recursive: true });
+    writeFileSync19(
+      join31(contextDir, "pack-manifest.json"),
       JSON.stringify(selected.manifest, null, 2) + "\n"
     );
     const manifestEntry = selected.selector.packType === "scaffold" ? selected.manifest.scaffold : selected.selector.packType === "review" ? selected.manifest.review : selected.selector.packType === "section" ? selected.manifest.sections.find((entry) => entry.id === selected.selector.id) : selected.selector.packType === "page" ? selected.manifest.pages.find((entry) => entry.id === selected.selector.id) : selected.manifest.mutations.find((entry) => entry.id === selected.selector.id);
     const markdownFile = manifestEntry?.markdown ?? `${selected.selector.packType}${selected.selector.id ? `-${selected.selector.id}` : ""}-pack.md`;
     const jsonFile = manifestEntry?.json ?? `${selected.selector.packType}${selected.selector.id ? `-${selected.selector.id}` : ""}-pack.json`;
-    writeFileSync18(join30(contextDir, markdownFile), selected.pack.renderedMarkdown);
-    writeFileSync18(join30(contextDir, jsonFile), JSON.stringify(selected.pack, null, 2) + "\n");
+    writeFileSync19(join31(contextDir, markdownFile), selected.pack.renderedMarkdown);
+    writeFileSync19(join31(contextDir, jsonFile), JSON.stringify(selected.pack, null, 2) + "\n");
     writtenContextDir = contextDir;
   }
   if (jsonOutput) {
@@ -8439,20 +8599,20 @@ async function printHostedSelectedExecutionPack(packType, id, essencePath, names
 }
 async function printHostedExecutionPackManifest(essencePath, namespace, jsonOutput = false, writeContext = false) {
   const client = getPublicAPIClient();
-  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join30(process.cwd(), "decantr.essence.json");
-  if (!existsSync28(resolvedPath)) {
+  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join31(process.cwd(), "decantr.essence.json");
+  if (!existsSync29(resolvedPath)) {
     throw new Error(`Essence file not found at ${resolvedPath}`);
   }
-  const essence = JSON.parse(readFileSync21(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync22(resolvedPath, "utf-8"));
   const manifest = await client.getExecutionPackManifest(
     essence,
     namespace ? { namespace } : void 0
   );
   let writtenContextDir = null;
   if (writeContext) {
-    const contextDir = join30(dirname6(resolvedPath), ".decantr", "context");
-    mkdirSync15(contextDir, { recursive: true });
-    writeFileSync18(join30(contextDir, "pack-manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
+    const contextDir = join31(dirname7(resolvedPath), ".decantr", "context");
+    mkdirSync16(contextDir, { recursive: true });
+    writeFileSync19(join31(contextDir, "pack-manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
     writtenContextDir = contextDir;
   }
   if (jsonOutput) {
@@ -8473,14 +8633,14 @@ async function printHostedExecutionPackManifest(essencePath, namespace, jsonOutp
   }
 }
 async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@official") {
-  const contextDir = join30(projectRoot, ".decantr", "context");
-  const reviewPackPath = join30(contextDir, "review-pack.json");
-  const manifestPath = join30(contextDir, "pack-manifest.json");
-  if (existsSync28(reviewPackPath) && existsSync28(manifestPath)) {
+  const contextDir = join31(projectRoot, ".decantr", "context");
+  const reviewPackPath = join31(contextDir, "review-pack.json");
+  const manifestPath = join31(contextDir, "pack-manifest.json");
+  if (existsSync29(reviewPackPath) && existsSync29(manifestPath)) {
     return { attempted: false, hydrated: false };
   }
-  const essencePath = join30(projectRoot, "decantr.essence.json");
-  if (!existsSync28(essencePath)) {
+  const essencePath = join31(projectRoot, "decantr.essence.json");
+  if (!existsSync29(essencePath)) {
     return { attempted: false, hydrated: false };
   }
   const reviewHydration = await hydrateHostedReviewPackIfMissing(projectRoot, namespace);
@@ -8489,9 +8649,9 @@ async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@o
   }
   try {
     const client = getPublicAPIClient();
-    const essence = JSON.parse(readFileSync21(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync22(essencePath, "utf-8"));
     const bundle = await client.compileExecutionPacks(essence, { namespace });
-    mkdirSync15(contextDir, { recursive: true });
+    mkdirSync16(contextDir, { recursive: true });
     writeExecutionPackBundleArtifacts(contextDir, bundle);
     return { attempted: true, hydrated: true, scope: "bundle" };
   } catch {
@@ -8499,19 +8659,19 @@ async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@o
   }
 }
 async function hydrateHostedReviewPackIfMissing(projectRoot, namespace = "@official") {
-  const contextDir = join30(projectRoot, ".decantr", "context");
-  const reviewPackPath = join30(contextDir, "review-pack.json");
-  const manifestPath = join30(contextDir, "pack-manifest.json");
-  if (existsSync28(reviewPackPath) && existsSync28(manifestPath)) {
+  const contextDir = join31(projectRoot, ".decantr", "context");
+  const reviewPackPath = join31(contextDir, "review-pack.json");
+  const manifestPath = join31(contextDir, "pack-manifest.json");
+  if (existsSync29(reviewPackPath) && existsSync29(manifestPath)) {
     return { attempted: false, hydrated: false };
   }
-  const essencePath = join30(projectRoot, "decantr.essence.json");
-  if (!existsSync28(essencePath)) {
+  const essencePath = join31(projectRoot, "decantr.essence.json");
+  if (!existsSync29(essencePath)) {
     return { attempted: false, hydrated: false };
   }
   try {
     const client = getPublicAPIClient();
-    const essence = JSON.parse(readFileSync21(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync22(essencePath, "utf-8"));
     const selected = await client.selectExecutionPack(
       {
         essence,
@@ -8519,14 +8679,14 @@ async function hydrateHostedReviewPackIfMissing(projectRoot, namespace = "@offic
       },
       { namespace }
     );
-    mkdirSync15(contextDir, { recursive: true });
-    writeFileSync18(join30(contextDir, "review-pack.md"), selected.pack.renderedMarkdown);
-    writeFileSync18(
-      join30(contextDir, "review-pack.json"),
+    mkdirSync16(contextDir, { recursive: true });
+    writeFileSync19(join31(contextDir, "review-pack.md"), selected.pack.renderedMarkdown);
+    writeFileSync19(
+      join31(contextDir, "review-pack.json"),
       JSON.stringify(selected.pack, null, 2) + "\n"
     );
-    if (!existsSync28(manifestPath)) {
-      writeFileSync18(manifestPath, JSON.stringify(selected.manifest, null, 2) + "\n");
+    if (!existsSync29(manifestPath)) {
+      writeFileSync19(manifestPath, JSON.stringify(selected.manifest, null, 2) + "\n");
     }
     return { attempted: true, hydrated: true, scope: "review" };
   } catch {
@@ -8536,17 +8696,17 @@ async function hydrateHostedReviewPackIfMissing(projectRoot, namespace = "@offic
 async function printHostedFileCritique(sourcePath, namespace, jsonOutput = false, essencePath, treatmentsPath) {
   const client = getPublicAPIClient();
   const resolvedSourcePath = resolveUserPath(sourcePath);
-  const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join30(process.cwd(), "decantr.essence.json");
-  const resolvedTreatmentsPath = treatmentsPath ? resolveUserPath(treatmentsPath) : join30(process.cwd(), "src", "styles", "treatments.css");
-  if (!existsSync28(resolvedSourcePath)) {
+  const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join31(process.cwd(), "decantr.essence.json");
+  const resolvedTreatmentsPath = treatmentsPath ? resolveUserPath(treatmentsPath) : join31(process.cwd(), "src", "styles", "treatments.css");
+  if (!existsSync29(resolvedSourcePath)) {
     throw new Error(`Source file not found at ${resolvedSourcePath}`);
   }
-  if (!existsSync28(resolvedEssencePath)) {
+  if (!existsSync29(resolvedEssencePath)) {
     throw new Error(`Essence file not found at ${resolvedEssencePath}`);
   }
-  const code = readFileSync21(resolvedSourcePath, "utf-8");
-  const essence = JSON.parse(readFileSync21(resolvedEssencePath, "utf-8"));
-  const treatmentsCss = existsSync28(resolvedTreatmentsPath) ? readFileSync21(resolvedTreatmentsPath, "utf-8") : void 0;
+  const code = readFileSync22(resolvedSourcePath, "utf-8");
+  const essence = JSON.parse(readFileSync22(resolvedEssencePath, "utf-8"));
+  const treatmentsCss = existsSync29(resolvedTreatmentsPath) ? readFileSync22(resolvedTreatmentsPath, "utf-8") : void 0;
   const report = await client.critiqueFile(
     {
       essence,
@@ -8570,11 +8730,11 @@ async function printHostedFileCritique(sourcePath, namespace, jsonOutput = false
 }
 async function printHostedProjectAudit(namespace, jsonOutput = false, essencePath, distPath, sourcesPath) {
   const client = getPublicAPIClient();
-  const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join30(process.cwd(), "decantr.essence.json");
-  if (!existsSync28(resolvedEssencePath)) {
+  const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join31(process.cwd(), "decantr.essence.json");
+  if (!existsSync29(resolvedEssencePath)) {
     throw new Error(`Essence file not found at ${resolvedEssencePath}`);
   }
-  const essence = JSON.parse(readFileSync21(resolvedEssencePath, "utf-8"));
+  const essence = JSON.parse(readFileSync22(resolvedEssencePath, "utf-8"));
   const dist = readHostedDistSnapshot(distPath);
   const sources = readHostedSourceSnapshot(sourcesPath);
   const report = await client.auditProject(
@@ -8592,7 +8752,7 @@ async function printHostedProjectAudit(namespace, jsonOutput = false, essencePat
   console.log(heading2("Hosted Project Audit"));
   console.log(`  Essence: ${resolvedEssencePath}`);
   console.log(
-    `  Dist snapshot: ${dist ? distPath ? resolveUserPath(distPath) : join30(process.cwd(), "dist") : "none"}`
+    `  Dist snapshot: ${dist ? distPath ? resolveUserPath(distPath) : join31(process.cwd(), "dist") : "none"}`
   );
   console.log(
     `  Source snapshot: ${sources && sourcesPath ? resolveUserPath(sourcesPath) : "none"}`
@@ -8621,7 +8781,7 @@ function printBlueprintPortfolioNotice(blueprint) {
   if (!portfolio) return;
   if (portfolio.visibility === "hidden" || portfolio.maturity === "fold-candidate") {
     console.log(
-      `${YELLOW12}  Warning:${RESET16} blueprint "${blueprint.id}" is folded out of public browsing.`
+      `${YELLOW13}  Warning:${RESET17} blueprint "${blueprint.id}" is folded out of public browsing.`
     );
     if (portfolio.recommended_alternative) {
       console.log(
@@ -8634,7 +8794,7 @@ function printBlueprintPortfolioNotice(blueprint) {
   }
   if (portfolio.visibility === "labs") {
     console.log(
-      `${YELLOW12}  Note:${RESET16} blueprint "${blueprint.id}" is a Labs blueprint; direct scaffolding is supported, but it is not a default recommendation yet.`
+      `${YELLOW13}  Note:${RESET17} blueprint "${blueprint.id}" is a Labs blueprint; direct scaffolding is supported, but it is not a default recommendation yet.`
     );
   }
 }
@@ -8656,7 +8816,7 @@ async function cmdSearch(query, type, sort, recommended, intelligenceSource, blu
     }
     console.log(heading2(`${results.length} result(s) for "${query}"`));
     for (const r of results) {
-      console.log(`  ${cyan3(r.type.padEnd(12))} ${BOLD9}${r.slug}${RESET16}`);
+      console.log(`  ${cyan3(r.type.padEnd(12))} ${BOLD10}${r.slug}${RESET17}`);
       console.log(`  ${dim3(r.description || "")}`);
       const intelligenceSummary = formatIntelligenceSummary(r.intelligence);
       if (intelligenceSummary) {
@@ -8714,21 +8874,21 @@ function findPatternCandidateBySlug(candidates, slug) {
 function readSuggestCodeContext(projectRoot, route, file) {
   const pieces = [];
   if (file) {
-    const resolved = isAbsolute3(file) ? file : join30(projectRoot, file);
-    if (existsSync28(resolved)) {
-      pieces.push(readFileSync21(resolved, "utf-8"));
+    const resolved = isAbsolute3(file) ? file : join31(projectRoot, file);
+    if (existsSync29(resolved)) {
+      pieces.push(readFileSync22(resolved, "utf-8"));
     }
   }
   if (route) {
-    const analysisPath = join30(projectRoot, ".decantr", "analysis.json");
-    if (existsSync28(analysisPath)) {
+    const analysisPath = join31(projectRoot, ".decantr", "analysis.json");
+    if (existsSync29(analysisPath)) {
       try {
-        const analysis = JSON.parse(readFileSync21(analysisPath, "utf-8"));
+        const analysis = JSON.parse(readFileSync22(analysisPath, "utf-8"));
         const routeEntry = analysis.routes?.routes?.find((entry) => entry.path === route);
         if (routeEntry?.file) {
-          const resolved = join30(projectRoot, routeEntry.file);
-          if (existsSync28(resolved)) {
-            pieces.push(readFileSync21(resolved, "utf-8"));
+          const resolved = join31(projectRoot, routeEntry.file);
+          if (existsSync29(resolved)) {
+            pieces.push(readFileSync22(resolved, "utf-8"));
           }
         }
       } catch {
@@ -8814,7 +8974,7 @@ async function cmdSuggest(query, options = {}) {
     }
   }
   const registryClient = new RegistryClient({
-    cacheDir: join30(projectRoot, ".decantr", "cache")
+    cacheDir: join31(projectRoot, ".decantr", "cache")
   });
   const code = options.fromCode || options.file ? readSuggestCodeContext(projectRoot, options.route, options.file) : "";
   const localMatches = localPatternMatches(projectRoot, [query, code].filter(Boolean).join("\n"));
@@ -8850,7 +9010,7 @@ async function cmdSuggest(query, options = {}) {
     )
   );
   if (bridgeMatches.length > 0) {
-    console.log(`${BOLD9}Project-owned style bridge:${RESET16}`);
+    console.log(`${BOLD10}Project-owned style bridge:${RESET17}`);
     for (const match of bridgeMatches) {
       const hints = [...match.tokenHints, ...match.classHints].slice(0, 3).join(", ");
       console.log(`  ${cyan3(match.id)}  ${match.label}${hints ? `  ${dim3(hints)}` : ""}`);
@@ -8858,13 +9018,13 @@ async function cmdSuggest(query, options = {}) {
     console.log("");
   }
   if (localMatches.length > 0) {
-    console.log(`${BOLD9}Project-owned local law:${RESET16}`);
+    console.log(`${BOLD10}Project-owned local law:${RESET17}`);
     for (const match of localMatches) {
       const details = [match.label, match.role].filter(Boolean).join(" | ");
       console.log(`  ${cyan3(match.id)}${details ? `  ${dim3(details)}` : ""}`);
     }
     console.log("");
-    console.log(`${BOLD9}Registry patterns:${RESET16}`);
+    console.log(`${BOLD10}Registry patterns:${RESET17}`);
   }
   if (matches.length === 0) {
     console.log(dim3("No hosted/bundled registry patterns matched this query."));
@@ -8903,7 +9063,7 @@ async function cmdGet(type, id) {
   }
   const apiType = CONTENT_TYPE_TO_API_CONTENT_TYPE3[type];
   const registryClient = new RegistryClient({
-    cacheDir: join30(process.cwd(), ".decantr", "cache")
+    cacheDir: join31(process.cwd(), ".decantr", "cache")
   });
   const result = await registryClient.fetchContentItem(apiType, id);
   if (result) {
@@ -8920,10 +9080,10 @@ async function cmdGet(type, id) {
   return;
 }
 async function cmdValidate(path) {
-  const essencePath = path || join30(process.cwd(), "decantr.essence.json");
+  const essencePath = path || join31(process.cwd(), "decantr.essence.json");
   let raw;
   try {
-    raw = readFileSync21(essencePath, "utf-8");
+    raw = readFileSync22(essencePath, "utf-8");
   } catch {
     console.error(error2(`Could not read ${essencePath}`));
     process.exitCode = 1;
@@ -8938,14 +9098,14 @@ async function cmdValidate(path) {
     return;
   }
   const detectedVersion = isV48(essence) ? "v4" : "legacy";
-  console.log(`${DIM16}Detected essence version: ${detectedVersion}${RESET16}`);
+  console.log(`${DIM17}Detected essence version: ${detectedVersion}${RESET17}`);
   const result = validateEssence2(essence);
   if (result.valid) {
     console.log(success3(`Essence is valid (${detectedVersion}).`));
   } else {
     console.error(error2("Validation failed:"));
     for (const err of result.errors) {
-      console.error(`  ${RED12}${err}${RESET16}`);
+      console.error(`  ${RED13}${err}${RESET17}`);
     }
     process.exitCode = 1;
     return;
@@ -8966,9 +9126,9 @@ async function cmdValidate(path) {
       console.log(heading2("Guard violations:"));
       for (const v of violations) {
         const vr = v;
-        console.log(`  ${YELLOW12}[${vr.rule}]${RESET16} ${vr.message}`);
+        console.log(`  ${YELLOW13}[${vr.rule}]${RESET17} ${vr.message}`);
         if (vr.suggestion) {
-          console.log(`    ${DIM16}Suggestion: ${vr.suggestion}${RESET16}`);
+          console.log(`    ${DIM17}Suggestion: ${vr.suggestion}${RESET17}`);
         }
       }
       const hasError = violations.some((v) => v.severity === "error");
@@ -8990,7 +9150,7 @@ async function cmdList(type, sort, recommended, intelligenceSource, blueprintSet
     return;
   }
   const registryClient = new RegistryClient({
-    cacheDir: join30(process.cwd(), ".decantr", "cache")
+    cacheDir: join31(process.cwd(), ".decantr", "cache")
   });
   const result = await registryClient.fetchContentList(
     type,
@@ -9067,16 +9227,16 @@ function enableCliTelemetry(projectRoot) {
   optIn(projectRoot);
   console.log(
     `
-${CYAN9}Telemetry enabled.${RESET16} Decantr will send privacy-filtered CLI product telemetry for this project.`
+${CYAN9}Telemetry enabled.${RESET17} Decantr will send privacy-filtered CLI product telemetry for this project.`
   );
-  console.log(`${DIM16}Set "telemetry": false in .decantr/project.json to opt out.${RESET16}`);
+  console.log(`${DIM17}Set "telemetry": false in .decantr/project.json to opt out.${RESET17}`);
 }
 function readCliPackageVersion2() {
-  const here = dirname6(fileURLToPath3(import.meta.url));
-  const candidates = [join30(here, "..", "package.json"), join30(here, "..", "..", "package.json")];
+  const here = dirname7(fileURLToPath3(import.meta.url));
+  const candidates = [join31(here, "..", "package.json"), join31(here, "..", "..", "package.json")];
   for (const candidate of candidates) {
     try {
-      const pkg = JSON.parse(readFileSync21(candidate, "utf-8"));
+      const pkg = JSON.parse(readFileSync22(candidate, "utf-8"));
       if (pkg.version) return pkg.version;
     } catch {
     }
@@ -9087,19 +9247,19 @@ function timestampForFile() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
 }
 function backupExistingEssence(projectRoot, label) {
-  const essencePath = join30(projectRoot, "decantr.essence.json");
-  if (!existsSync28(essencePath)) return null;
-  const backupPath = join30(
+  const essencePath = join31(projectRoot, "decantr.essence.json");
+  if (!existsSync29(essencePath)) return null;
+  const backupPath = join31(
     projectRoot,
     `decantr.essence.${label}.${timestampForFile()}.backup.json`
   );
-  writeFileSync18(backupPath, readFileSync21(essencePath, "utf-8"), "utf-8");
+  writeFileSync19(backupPath, readFileSync22(essencePath, "utf-8"), "utf-8");
   return backupPath;
 }
 function writeBrownfieldProjectJson(input) {
-  const decantrDir = join30(input.projectRoot, ".decantr");
-  mkdirSync15(join30(decantrDir, "context"), { recursive: true });
-  mkdirSync15(join30(decantrDir, "cache"), { recursive: true });
+  const decantrDir = join31(input.projectRoot, ".decantr");
+  mkdirSync16(join31(decantrDir, "context"), { recursive: true });
+  mkdirSync16(join31(decantrDir, "cache"), { recursive: true });
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const projectJson = {
     detected: {
@@ -9140,7 +9300,7 @@ function writeBrownfieldProjectJson(input) {
       }
     }
   };
-  writeFileSync18(join30(decantrDir, "project.json"), JSON.stringify(projectJson, null, 2) + "\n");
+  writeFileSync19(join31(decantrDir, "project.json"), JSON.stringify(projectJson, null, 2) + "\n");
 }
 async function applyAcceptedBrownfieldProposal(input) {
   const proposal = readBrownfieldProposal(input.projectRoot);
@@ -9156,8 +9316,8 @@ async function applyAcceptedBrownfieldProposal(input) {
     process.exitCode = 1;
     return;
   }
-  const essencePath = join30(input.projectRoot, "decantr.essence.json");
-  const hasEssence = existsSync28(essencePath);
+  const essencePath = join31(input.projectRoot, "decantr.essence.json");
+  const hasEssence = existsSync29(essencePath);
   let essence;
   let backupPath = null;
   if (input.mode === "accept" && hasEssence) {
@@ -9171,7 +9331,7 @@ async function applyAcceptedBrownfieldProposal(input) {
     return;
   }
   if (input.mode === "merge" && hasEssence) {
-    const existing = JSON.parse(readFileSync21(essencePath, "utf-8"));
+    const existing = JSON.parse(readFileSync22(essencePath, "utf-8"));
     if (!isV48(existing)) {
       console.log(
         error2(
@@ -9191,7 +9351,7 @@ async function applyAcceptedBrownfieldProposal(input) {
       error2("Brownfield proposal produced an invalid Decantr essence. No files were changed.")
     );
     for (const validationError of validation.errors) {
-      console.log(`  ${RED12}${validationError}${RESET16}`);
+      console.log(`  ${RED13}${validationError}${RESET17}`);
     }
     process.exitCode = 1;
     return;
@@ -9208,9 +9368,9 @@ async function applyAcceptedBrownfieldProposal(input) {
     assistantBridge: input.assistantBridge,
     mode: input.mode
   });
-  writeFileSync18(essencePath, JSON.stringify(essence, null, 2) + "\n", "utf-8");
+  writeFileSync19(essencePath, JSON.stringify(essence, null, 2) + "\n", "utf-8");
   const registryClient = new RegistryClient({
-    cacheDir: join30(input.projectRoot, ".decantr", "cache"),
+    cacheDir: join31(input.projectRoot, ".decantr", "cache"),
     offline: true,
     projectRoot: input.projectRoot
   });
@@ -9305,7 +9465,7 @@ async function cmdInit(args) {
     console.log(dim3("  Found .decantr/init-seed.json brownfield guidance."));
   }
   if (detected.existingEssence && !args.existing) {
-    console.log(`${YELLOW12}Warning: decantr.essence.json already exists.${RESET16}`);
+    console.log(`${YELLOW13}Warning: decantr.essence.json already exists.${RESET17}`);
     const overwrite = await confirm("Overwrite existing configuration?", false);
     if (!overwrite) {
       console.log(dim3("Cancelled."));
@@ -9389,7 +9549,7 @@ async function cmdInit(args) {
     }
   }
   const registryClient = new RegistryClient({
-    cacheDir: join30(projectRoot, ".decantr", "cache"),
+    cacheDir: join31(projectRoot, ".decantr", "cache"),
     apiUrl: args.registry,
     offline: args.offline,
     projectRoot
@@ -9409,7 +9569,7 @@ async function cmdInit(args) {
   } else if (shouldUseRegistry && !apiAvailable) {
     if (!args.blueprint) {
       console.log(`
-${YELLOW12}You're offline. Scaffolding minimal Decantr project.${RESET16}`);
+${YELLOW13}You're offline. Scaffolding minimal Decantr project.${RESET17}`);
       console.log(
         dim3("Run `decantr sync` or `decantr upgrade` when online to pull full registry content.\n")
       );
@@ -9458,7 +9618,7 @@ ${YELLOW12}You're offline. Scaffolding minimal Decantr project.${RESET16}`);
       return;
     }
     console.log(`
-${YELLOW12}You're offline. Scaffolding Decantr default.${RESET16}`);
+${YELLOW13}You're offline. Scaffolding Decantr default.${RESET17}`);
     console.log(dim3("Run `decantr upgrade` when online, or visit decantr.ai/registry\n"));
     selectedBlueprint = "default";
   } else if (shouldUseRegistry) {
@@ -9640,7 +9800,7 @@ ${YELLOW12}You're offline. Scaffolding Decantr default.${RESET16}`);
         return;
       }
       console.log(
-        `${YELLOW12}  Warning: Could not fetch blueprint "${options.blueprint}". Using defaults.${RESET16}`
+        `${YELLOW13}  Warning: Could not fetch blueprint "${options.blueprint}". Using defaults.${RESET17}`
       );
     }
   } else if (shouldUseRegistry && options.archetype) {
@@ -9655,7 +9815,7 @@ ${YELLOW12}You're offline. Scaffolding Decantr default.${RESET16}`);
         return;
       }
       console.log(
-        `${YELLOW12}  Warning: Could not fetch archetype "${options.archetype}". Using defaults.${RESET16}`
+        `${YELLOW13}  Warning: Could not fetch archetype "${options.archetype}". Using defaults.${RESET17}`
       );
     }
   }
@@ -9672,7 +9832,7 @@ ${YELLOW12}You're offline. Scaffolding Decantr default.${RESET16}`);
         return;
       }
       console.log(
-        `${YELLOW12}  Warning: Could not fetch theme "${options.theme}". Using defaults.${RESET16}`
+        `${YELLOW13}  Warning: Could not fetch theme "${options.theme}". Using defaults.${RESET17}`
       );
     }
   }
@@ -9721,7 +9881,7 @@ ${YELLOW12}You're offline. Scaffolding Decantr default.${RESET16}`);
   if (appliedRuleFiles.length > 0) {
     console.log(`    ${dim3(`Rule bridge applied: ${appliedRuleFiles.join(", ")}`)}`);
   }
-  if (!existsSync28(join30(projectRoot, "package.json"))) {
+  if (!existsSync29(join31(projectRoot, "package.json"))) {
     console.log("");
     console.log(
       dim3(`  Note: ${cyan3("decantr init")} created Decantr contract/context files only.`)
@@ -9732,7 +9892,7 @@ ${YELLOW12}You're offline. Scaffolding Decantr default.${RESET16}`);
       )
     );
   }
-  const hasCompiledPacks = existsSync28(join30(projectRoot, ".decantr", "context", "scaffold-pack.md"));
+  const hasCompiledPacks = existsSync29(join31(projectRoot, ".decantr", "context", "scaffold-pack.md"));
   console.log("");
   console.log("  Next steps:");
   if (hasCompiledPacks) {
@@ -9772,7 +9932,7 @@ ${YELLOW12}You're offline. Scaffolding Decantr default.${RESET16}`);
   console.log(`    ${cyan3("decantr upgrade")}    Update to latest patterns`);
   console.log(`    ${cyan3("decantr check")}      Detect drift issues`);
   console.log(`    ${cyan3("decantr migrate --to v4")} Migrate older essence files to v4`);
-  const essenceContent = readFileSync21(result.essencePath, "utf-8");
+  const essenceContent = readFileSync22(result.essencePath, "utf-8");
   const essence = JSON.parse(essenceContent);
   const validation = validateEssence2(essence);
   if (!validation.valid) {
@@ -9815,7 +9975,7 @@ Validation warnings: ${validation.errors.join(", ")}`));
   };
   const curatedPrompt = generateCuratedPrompt(promptCtx);
   console.log("");
-  console.log(`${BOLD9}Prompt for your AI assistant:${RESET16}`);
+  console.log(`${BOLD10}Prompt for your AI assistant:${RESET17}`);
   console.log(dim3("\u2500".repeat(50)));
   console.log("");
   console.log(curatedPrompt);
@@ -9827,23 +9987,23 @@ Validation warnings: ${validation.errors.join(", ")}`));
   }
 }
 async function cmdStatus(projectRoot = process.cwd()) {
-  const essencePath = join30(projectRoot, "decantr.essence.json");
-  const projectJsonPath = join30(projectRoot, ".decantr", "project.json");
+  const essencePath = join31(projectRoot, "decantr.essence.json");
+  const projectJsonPath = join31(projectRoot, ".decantr", "project.json");
   console.log(heading2("Decantr Project Status"));
-  if (!existsSync28(essencePath)) {
-    console.log(`${RED12}No decantr.essence.json found.${RESET16}`);
+  if (!existsSync29(essencePath)) {
+    console.log(`${RED13}No decantr.essence.json found.${RESET17}`);
     console.log(dim3('Run "decantr init" to create one.'));
     return;
   }
   try {
-    const essence = JSON.parse(readFileSync21(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync22(essencePath, "utf-8"));
     const validation = validateEssence2(essence);
     const essenceVersion = isV48(essence) ? "v4" : "legacy";
-    console.log(`${BOLD9}Essence:${RESET16}`);
+    console.log(`${BOLD10}Essence:${RESET17}`);
     if (validation.valid) {
-      console.log(`  ${GREEN16}Valid${RESET16} (${essenceVersion})`);
+      console.log(`  ${GREEN17}Valid${RESET17} (${essenceVersion})`);
     } else {
-      console.log(`  ${RED12}Invalid: ${validation.errors.join(", ")}${RESET16}`);
+      console.log(`  ${RED13}Invalid: ${validation.errors.join(", ")}${RESET17}`);
     }
     if (isV48(essence)) {
       const v4 = essence;
@@ -9851,7 +10011,7 @@ async function cmdStatus(projectRoot = process.cwd()) {
       const flatPages = sections.flatMap((section) => section.pages ?? []);
       const resolvedShell = sections.find((section) => section.role === "primary")?.shell || sections[0]?.shell || v4.blueprint.shell || "unknown";
       const resolvedFeatures = v4.blueprint.features ?? [];
-      console.log(`  ${BOLD9}DNA:${RESET16}`);
+      console.log(`  ${BOLD10}DNA:${RESET17}`);
       console.log(`    Theme: ${v4.dna.theme.id} (${v4.dna.theme.mode})`);
       console.log(
         `    Spacing: ${v4.dna.spacing.density} density, ${v4.dna.spacing.content_gap} gap`
@@ -9863,60 +10023,60 @@ async function cmdStatus(projectRoot = process.cwd()) {
       );
       console.log(`    Accessibility: WCAG ${v4.dna.accessibility.wcag_level}`);
       console.log(`    Personality: ${v4.dna.personality.join(", ")}`);
-      console.log(`  ${BOLD9}Blueprint:${RESET16}`);
+      console.log(`  ${BOLD10}Blueprint:${RESET17}`);
       console.log(`    Shell: ${resolvedShell}`);
       console.log(`    Pages: ${flatPages.length}`);
       console.log(`    Sections: ${sections.length}`);
       console.log(
         `    Features: ${resolvedFeatures.length > 0 ? resolvedFeatures.join(", ") : "none"}`
       );
-      console.log(`  ${BOLD9}Meta:${RESET16}`);
+      console.log(`  ${BOLD10}Meta:${RESET17}`);
       console.log(`    Archetype: ${v4.meta.archetype}`);
       console.log(`    Target: ${v4.meta.target}`);
       console.log(
         `    Guard: ${v4.meta.guard.mode} (DNA: ${v4.meta.guard.dna_enforcement}, Blueprint: ${v4.meta.guard.blueprint_enforcement})`
       );
     } else {
-      console.log(`  ${YELLOW12}Run \`decantr migrate --to v4\` to upgrade this project.${RESET16}`);
+      console.log(`  ${YELLOW13}Run \`decantr migrate --to v4\` to upgrade this project.${RESET17}`);
     }
   } catch (e) {
-    console.log(`  ${RED12}Error reading essence: ${e.message}${RESET16}`);
+    console.log(`  ${RED13}Error reading essence: ${e.message}${RESET17}`);
   }
   console.log("");
-  console.log(`${BOLD9}Sync Status:${RESET16}`);
-  if (existsSync28(projectJsonPath)) {
+  console.log(`${BOLD10}Sync Status:${RESET17}`);
+  if (existsSync29(projectJsonPath)) {
     try {
-      const projectJson = JSON.parse(readFileSync21(projectJsonPath, "utf-8"));
+      const projectJson = JSON.parse(readFileSync22(projectJsonPath, "utf-8"));
       const syncStatus = projectJson.sync?.status || "unknown";
       const lastSync = projectJson.sync?.lastSync || "never";
       const source = projectJson.sync?.registrySource || "unknown";
-      const statusColor = syncStatus === "synced" ? GREEN16 : YELLOW12;
-      console.log(`  Status: ${statusColor}${syncStatus}${RESET16}`);
+      const statusColor = syncStatus === "synced" ? GREEN17 : YELLOW13;
+      console.log(`  Status: ${statusColor}${syncStatus}${RESET17}`);
       console.log(`  Last sync: ${dim3(lastSync)}`);
       console.log(`  Source: ${dim3(source)}`);
     } catch {
-      console.log(`  ${YELLOW12}Could not read project.json${RESET16}`);
+      console.log(`  ${YELLOW13}Could not read project.json${RESET17}`);
     }
   } else {
-    console.log(`  ${YELLOW12}No .decantr/project.json found${RESET16}`);
+    console.log(`  ${YELLOW13}No .decantr/project.json found${RESET17}`);
     console.log(dim3('  Run "decantr init" to create project files.'));
   }
 }
 async function cmdSync() {
   const projectRoot = process.cwd();
-  const cacheDir = join30(projectRoot, ".decantr", "cache");
+  const cacheDir = join31(projectRoot, ".decantr", "cache");
   console.log(heading2("Syncing registry content..."));
   const result = await syncRegistry(cacheDir);
   if (result.synced.length > 0) {
     console.log(success3("Sync completed successfully."));
     console.log(`  Synced: ${result.synced.join(", ")}`);
     if (result.failed.length > 0) {
-      console.log(`  ${YELLOW12}Failed: ${result.failed.join(", ")}${RESET16}`);
+      console.log(`  ${YELLOW13}Failed: ${result.failed.join(", ")}${RESET17}`);
     }
   } else {
-    console.log(`${YELLOW12}Could not sync: API unavailable${RESET16}`);
+    console.log(`${YELLOW13}Could not sync: API unavailable${RESET17}`);
     if (result.failed.length > 0) {
-      console.log(`  ${YELLOW12}Failed: ${result.failed.join(", ")}${RESET16}`);
+      console.log(`  ${YELLOW13}Failed: ${result.failed.join(", ")}${RESET17}`);
     }
   }
 }
@@ -9926,15 +10086,15 @@ function printVerificationFindings(findings) {
     return;
   }
   for (const finding of findings) {
-    const color = finding.severity === "error" ? RED12 : finding.severity === "warn" ? YELLOW12 : CYAN9;
+    const color = finding.severity === "error" ? RED13 : finding.severity === "warn" ? YELLOW13 : CYAN9;
     console.log(
-      `  ${color}[${finding.severity.toUpperCase()}]${RESET16} ${finding.category}: ${finding.message}`
+      `  ${color}[${finding.severity.toUpperCase()}]${RESET17} ${finding.category}: ${finding.message}`
     );
     for (const evidence of finding.evidence) {
-      console.log(`    ${DIM16}${evidence}${RESET16}`);
+      console.log(`    ${DIM17}${evidence}${RESET17}`);
     }
     if (finding.suggestedFix) {
-      console.log(`    ${DIM16}Fix: ${finding.suggestedFix}${RESET16}`);
+      console.log(`    ${DIM17}Fix: ${finding.suggestedFix}${RESET17}`);
     }
   }
 }
@@ -9942,10 +10102,10 @@ function printProjectAuditReport(report) {
   if (report.valid) {
     console.log(success3("Project contract is valid."));
   } else {
-    console.log(`${RED12}Project audit found blocking issues.${RESET16}`);
+    console.log(`${RED13}Project audit found blocking issues.${RESET17}`);
   }
   console.log("");
-  console.log(`${BOLD9}Summary:${RESET16}`);
+  console.log(`${BOLD10}Summary:${RESET17}`);
   console.log(`  Essence version: ${report.summary.essenceVersion ?? "missing"}`);
   console.log(`  Pages defined: ${report.summary.pageCount}`);
   console.log(`  Pack manifest: ${report.summary.packManifestPresent ? "present" : "missing"}`);
@@ -9974,23 +10134,23 @@ function printProjectAuditReport(report) {
     `  Findings: ${report.summary.errorCount} error(s), ${report.summary.warnCount} warn(s), ${report.summary.infoCount} info`
   );
   console.log("");
-  console.log(`${BOLD9}Findings:${RESET16}`);
+  console.log(`${BOLD10}Findings:${RESET17}`);
   printVerificationFindings(report.findings);
 }
 function printFileCritiqueReport(report) {
   console.log(success3(`Critiqued ${report.file}`));
   console.log("");
-  console.log(`${BOLD9}Summary:${RESET16}`);
+  console.log(`${BOLD10}Summary:${RESET17}`);
   console.log(`  Overall score: ${report.overall}/5`);
   console.log(`  Focus areas: ${report.focusAreas.join(", ")}`);
   console.log(`  Review pack: ${report.reviewPack ? "present" : "missing"}`);
   console.log("");
-  console.log(`${BOLD9}Scores:${RESET16}`);
+  console.log(`${BOLD10}Scores:${RESET17}`);
   for (const score of report.scores) {
     console.log(`  ${cyan3(score.category.padEnd(20))} ${score.score}/5  ${dim3(score.details)}`);
   }
   console.log("");
-  console.log(`${BOLD9}Findings:${RESET16}`);
+  console.log(`${BOLD10}Findings:${RESET17}`);
   printVerificationFindings(report.findings);
 }
 async function cmdAudit(filePath) {
@@ -10031,7 +10191,7 @@ async function cmdAudit(filePath) {
       console.log(dim3("Project audit completed with advisory findings."));
     }
   } catch (e) {
-    console.log(`${RED12}Error: ${e.message}${RESET16}`);
+    console.log(`${RED13}Error: ${e.message}${RESET17}`);
     process.exitCode = 1;
   }
 }
@@ -10039,9 +10199,9 @@ async function cmdTheme(args, projectRoot = process.cwd()) {
   const subcommand = args[0];
   if (!subcommand || subcommand === "help") {
     console.log(`
-${BOLD9}decantr theme${RESET16} \u2014 Manage custom themes
+${BOLD10}decantr theme${RESET17} \u2014 Manage custom themes
 
-${BOLD9}Commands:${RESET16}
+${BOLD10}Commands:${RESET17}
   ${cyan3("create")} <name>        Create a new custom theme
   ${cyan3("create")} <name> --guided   Interactive theme creation
   ${cyan3("list")}                 List custom themes
@@ -10049,7 +10209,7 @@ ${BOLD9}Commands:${RESET16}
   ${cyan3("delete")} <name>        Delete a custom theme
   ${cyan3("import")} <path>        Import theme from JSON file
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr theme create mytheme
   decantr theme list
   decantr theme validate mytheme
@@ -10098,21 +10258,21 @@ ${BOLD9}Examples:${RESET16}
         process.exitCode = 1;
         return;
       }
-      const themePath = join30(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
-      if (!existsSync28(themePath)) {
+      const themePath = join31(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
+      if (!existsSync29(themePath)) {
         console.error(error2(`Theme "${name}" not found at ${themePath}`));
         process.exitCode = 1;
         return;
       }
       try {
-        const theme = JSON.parse(readFileSync21(themePath, "utf-8"));
+        const theme = JSON.parse(readFileSync22(themePath, "utf-8"));
         const result = validateCustomTheme(theme);
         if (result.valid) {
           console.log(success3(`Custom theme "${name}" is valid`));
         } else {
           console.error(error2("Validation failed:"));
           for (const err of result.errors) {
-            console.error(`  ${RED12}${err}${RESET16}`);
+            console.error(`  ${RED13}${err}${RESET17}`);
           }
           process.exitCode = 1;
         }
@@ -10152,7 +10312,7 @@ ${BOLD9}Examples:${RESET16}
       } else {
         console.error(error2("Import failed:"));
         for (const err of result.errors || []) {
-          console.error(`  ${RED12}${err}${RESET16}`);
+          console.error(`  ${RED13}${err}${RESET17}`);
         }
         process.exitCode = 1;
       }
@@ -10237,7 +10397,7 @@ function withProject(command, projectArg) {
   return projectArg ? `${command} --project ${projectArg}` : command;
 }
 function displayProjectPath(workspaceInfo, projectPath) {
-  const absolutePath = join30(workspaceInfo.appRoot, projectPath);
+  const absolutePath = join31(workspaceInfo.appRoot, projectPath);
   const relativePath = relative6(workspaceInfo.cwd, absolutePath).replace(/\\/g, "/");
   if (relativePath && !relativePath.startsWith("..") && !isAbsolute3(relativePath)) {
     return relativePath;
@@ -10245,7 +10405,7 @@ function displayProjectPath(workspaceInfo, projectPath) {
   return absolutePath;
 }
 function projectRelativeGraphPath(projectRoot, filePath) {
-  const relativePath = relative6(projectRoot, isAbsolute3(filePath) ? filePath : resolve4(filePath));
+  const relativePath = relative6(projectRoot, isAbsolute3(filePath) ? filePath : resolve5(filePath));
   if (relativePath && !relativePath.startsWith("..") && !isAbsolute3(relativePath)) {
     return relativePath.replace(/\\/g, "/");
   }
@@ -10261,7 +10421,7 @@ function graphSourceNodeIdForTaskFile(projectRoot, snapshot, filePath) {
   candidates.add(trimmed.replace(/\\/g, "/").replace(/^\.\//, ""));
   const cwdRelative = projectRelativeGraphPath(projectRoot, trimmed);
   if (cwdRelative) candidates.add(cwdRelative);
-  const projectRelative = projectRelativeGraphPath(projectRoot, join30(projectRoot, trimmed));
+  const projectRelative = projectRelativeGraphPath(projectRoot, join31(projectRoot, trimmed));
   if (projectRelative) candidates.add(projectRelative);
   for (const candidate of candidates) {
     const nodeId = `src:${candidate}`;
@@ -10315,7 +10475,7 @@ function printWorkspaceProjectSelection(workspaceInfo, commandName = "command")
   const noun = commandName === "adopt" ? "Brownfield adoption" : `decantr ${commandName}`;
   console.log(error2(`${noun} needs an app path.`));
   console.log("");
-  console.log(`${BOLD9}This looks like a monorepo.${RESET16}`);
+  console.log(`${BOLD10}This looks like a monorepo.${RESET17}`);
   console.log("Install Decantr at the workspace root, then attach it to one app with --project.");
   console.log("");
   console.log("App candidates:");
@@ -10335,11 +10495,11 @@ function printWorkspaceProjectSelection(workspaceInfo, commandName = "command")
 function printMonorepoSetupGuidance(workspaceInfo) {
   const candidate = firstWorkspaceCandidate(workspaceInfo);
   const attachedProjects = workspaceInfo.appCandidates.filter(
-    (appCandidate) => existsSync28(join30(workspaceInfo.workspaceRoot, appCandidate, "decantr.essence.json"))
+    (appCandidate) => existsSync29(join31(workspaceInfo.workspaceRoot, appCandidate, "decantr.essence.json"))
   );
   const firstAttached = attachedProjects[0];
   console.log(heading2("Decantr Setup"));
-  console.log(`${BOLD9}This looks like a monorepo.${RESET16}`);
+  console.log(`${BOLD10}This looks like a monorepo.${RESET17}`);
   console.log(`  Workspace root: ${workspaceInfo.workspaceRoot}`);
   console.log("");
   if (firstAttached) {
@@ -10350,7 +10510,7 @@ function printMonorepoSetupGuidance(workspaceInfo) {
       console.log(`  ${project}`);
     }
     console.log("");
-    console.log(`${BOLD9}Next:${RESET16}`);
+    console.log(`${BOLD10}Next:${RESET17}`);
     console.log(
       `  ${cyan3(`decantr doctor --project ${firstAttached}`)}                    Explain current state and next command`
     );
@@ -10384,7 +10544,7 @@ function printMonorepoSetupGuidance(workspaceInfo) {
     console.log(`  ${appCandidate}`);
   }
   console.log("");
-  console.log(`${BOLD9}Start here:${RESET16}`);
+  console.log(`${BOLD10}Start here:${RESET17}`);
   console.log(
     `  ${cyan3("decantr workspace list")}                         Show attached projects and app candidates`
   );
@@ -10395,7 +10555,7 @@ function printMonorepoSetupGuidance(workspaceInfo) {
     `  ${cyan3(`decantr codify --from-audit --style-bridge --project ${candidate}`)}  Propose project-owned UI law and style bridge`
   );
   console.log("");
-  console.log(`${BOLD9}Optional visual evidence:${RESET16}`);
+  console.log(`${BOLD10}Optional visual evidence:${RESET17}`);
   console.log(
     `  ${cyan3(`decantr verify --project ${candidate} --base-url http://localhost:3000 --evidence`)}`
   );
@@ -10403,7 +10563,7 @@ function printMonorepoSetupGuidance(workspaceInfo) {
 function resolveWorkflowProject(flags, commandName = "command", options = {}) {
   const projectArg = flagString(flags, "project");
   const workspaceInfo = resolveWorkspaceInfo(process.cwd(), projectArg);
-  if (projectArg && options.requireExisting !== false && !existsSync28(workspaceInfo.appRoot)) {
+  if (projectArg && options.requireExisting !== false && !existsSync29(workspaceInfo.appRoot)) {
     printProjectNotFound(projectArg, commandName);
     process.exitCode = 1;
     return null;
@@ -10448,22 +10608,34 @@ function printWorkflowPlan(title, steps) {
   }
   console.log("");
 }
+function studioCommandForProject(projectArg) {
+  return projectArg ? `cd ${projectArg} && decantr studio` : "decantr studio";
+}
+function formatWhichCommandFirst(projectArg) {
+  return [
+    `${BOLD10}Which command first?${RESET17}`,
+    `  ${cyan3(withProject("decantr scan", projectArg))}          Existing app, read-only preview`,
+    `  ${cyan3(withProject("decantr adopt --yes", projectArg))}   Existing app, attach Decantr`,
+    `  ${cyan3("decantr new my-app --blueprint=<slug>")}  New runnable app`,
+    `  ${cyan3(withProject("decantr init --existing", projectArg))}  Advanced attach primitive`
+  ].join("\n");
+}
 function scanSeverityColor(finding) {
   if (finding.severity === "success") return success3("ok");
   if (finding.severity === "error") return error2("error");
-  if (finding.severity === "warn") return `${YELLOW12}warn${RESET16}`;
+  if (finding.severity === "warn") return `${YELLOW13}warn${RESET17}`;
   return cyan3("info");
 }
 function formatScanApplicability(status) {
   if (status === "strong_fit") return success3("strong fit");
-  if (status === "partial_fit") return `${YELLOW12}partial fit${RESET16}`;
+  if (status === "partial_fit") return `${YELLOW13}partial fit${RESET17}`;
   if (status === "not_applicable") return dim3("not applicable");
   return dim3("unknown");
 }
 function formatScanGraphPreviewStatus(status) {
   if (status === "current") return success3("current");
-  if (status === "stale") return `${YELLOW12}stale or missing${RESET16}`;
-  if (status === "needs_migration") return `${YELLOW12}needs migration${RESET16}`;
+  if (status === "stale") return `${YELLOW13}stale or missing${RESET17}`;
+  if (status === "needs_migration") return `${YELLOW13}needs migration${RESET17}`;
   if (status === "not_attached") return dim3("not attached");
   return dim3("unavailable");
 }
@@ -10545,7 +10717,7 @@ function buildScanGraphPreview(workspaceInfo, projectArg) {
 }
 function printScanGraphPreview(preview) {
   if (!preview) return;
-  console.log(`${BOLD9}Typed Contract Graph${RESET16}`);
+  console.log(`${BOLD10}Typed Contract Graph${RESET17}`);
   console.log(`  Status:         ${formatScanGraphPreviewStatus(preview.status)}`);
   console.log(`  Read-only:      ${preview.readOnly ? "yes" : "no"}`);
   if (preview.snapshot && preview.capsule) {
@@ -10583,11 +10755,11 @@ function printScanGraphPreview(preview) {
   }
   console.log("");
 }
-function printScanReport(report) {
+function printScanReport(report, projectArg) {
   console.log(heading2("Decantr Scan"));
   console.log(dim3("Read-only Brownfield reconnaissance. No files were written."));
   console.log("");
-  console.log(`${BOLD9}Verdict${RESET16}`);
+  console.log(`${BOLD10}Verdict${RESET17}`);
   console.log(
     `  ${formatScanApplicability(report.applicability.status)}  ${report.applicability.label}`
   );
@@ -10598,7 +10770,7 @@ function printScanReport(report) {
     console.log(`  ${dim3("-")} ${reason}`);
   }
   console.log("");
-  console.log(`${BOLD9}Project${RESET16}`);
+  console.log(`${BOLD10}Project${RESET17}`);
   console.log(
     `  Framework:      ${cyan3(report.project.framework)}${report.project.frameworkVersion ? ` ${report.project.frameworkVersion}` : ""}`
   );
@@ -10608,7 +10780,7 @@ function printScanReport(report) {
   console.log(`  Decantr:        ${report.project.hasDecantr ? "present" : "not attached"}`);
   console.log("");
   printScanGraphPreview(report.graphPreview);
-  console.log(`${BOLD9}Routes And Styling${RESET16}`);
+  console.log(`${BOLD10}Routes And Styling${RESET17}`);
   console.log(`  Routes:         ${report.routes.count} (${report.routes.strategy})`);
   for (const route of report.routes.items.slice(0, 8)) {
     console.log(`    ${cyan3(route.path.padEnd(18))} ${dim3(route.file)}`);
@@ -10624,7 +10796,7 @@ function printScanReport(report) {
   console.log(`  Dark mode:      ${report.styling.darkMode ? "yes" : "no"}`);
   console.log("");
   if (report.staticHosting.githubPagesLikely || report.pagesProbe) {
-    console.log(`${BOLD9}Published Surface${RESET16}`);
+    console.log(`${BOLD10}Published Surface${RESET17}`);
     console.log(
       `  GitHub Pages:   ${report.staticHosting.githubPagesLikely ? "likely" : "not detected"}`
     );
@@ -10633,7 +10805,7 @@ function printScanReport(report) {
     }
     if (report.pagesProbe?.checked) {
       console.log(
-        `  HTTP probe:     ${report.pagesProbe.reachable ? success3("reachable") : `${YELLOW12}unreachable${RESET16}`} ${report.pagesProbe.status ?? ""}`
+        `  HTTP probe:     ${report.pagesProbe.reachable ? success3("reachable") : `${YELLOW13}unreachable${RESET17}`} ${report.pagesProbe.status ?? ""}`
       );
       if (report.pagesProbe.title) console.log(`  Title:          ${report.pagesProbe.title}`);
     }
@@ -10642,19 +10814,32 @@ function printScanReport(report) {
     }
     console.log("");
   }
-  console.log(`${BOLD9}Findings${RESET16}`);
+  console.log(`${BOLD10}Findings${RESET17}`);
   for (const finding of report.findings.slice(0, 8)) {
     console.log(`  [${scanSeverityColor(finding)}] ${finding.title}`);
     console.log(`      ${finding.message}`);
     if (finding.recommendation) console.log(`      ${dim3(finding.recommendation)}`);
   }
   console.log("");
-  console.log(`${BOLD9}Next Commands${RESET16}`);
+  console.log(`${BOLD10}Next Commands${RESET17}`);
   for (const command of report.recommendedCommands) {
     console.log(`  ${cyan3(command)}`);
   }
   console.log("");
   console.log(dim3(report.privacy.notes[0] ?? "Scan completed without writing files."));
+  console.log(
+    dim3(
+      "This scan was read-only: no Decantr files, dependencies, scripts, uploads, or reports were created."
+    )
+  );
+  if (report.applicability.status !== "not_applicable") {
+    console.log(
+      `When ready to attach Decantr, run ${cyan3(withProject("decantr adopt --yes", projectArg))}.`
+    );
+    console.log(
+      `After adoption, inspect what Decantr found with ${cyan3(studioCommandForProject(projectArg))}.`
+    );
+  }
 }
 async function cmdScanWorkflow(args) {
   const { flags } = parseLooseArgs(args);
@@ -10673,7 +10858,7 @@ async function cmdScanWorkflow(args) {
     console.log(JSON.stringify(reportWithGraph, null, 2));
     return;
   }
-  printScanReport(reportWithGraph);
+  printScanReport(reportWithGraph, projectArg);
 }
 async function cmdSetupWorkflow(args) {
   const { flags } = parseLooseArgs(args);
@@ -10695,11 +10880,11 @@ async function cmdSetupWorkflow(args) {
   console.log(`  Detected: ${formatDetection(detected)}`);
   console.log("");
   if (detected.existingEssence) {
-    const hasLocalPatterns = existsSync28(localPatternsPath(workspaceInfo.appRoot));
-    const hasLocalRules = existsSync28(localRulesPath(workspaceInfo.appRoot));
-    const hasStyleBridge = existsSync28(styleBridgePath(workspaceInfo.appRoot));
+    const hasLocalPatterns = existsSync29(localPatternsPath(workspaceInfo.appRoot));
+    const hasLocalRules = existsSync29(localRulesPath(workspaceInfo.appRoot));
+    const hasStyleBridge = existsSync29(styleBridgePath(workspaceInfo.appRoot));
     const verifyCommand = hasLocalPatterns || hasLocalRules ? "decantr verify --brownfield --local-patterns" : "decantr verify --brownfield";
-    console.log(`${BOLD9}Recommended path:${RESET16} maintain an attached Decantr project`);
+    console.log(`${BOLD10}Recommended path:${RESET17} maintain an attached Decantr project`);
     console.log(
       `  ${cyan3(withProject("decantr doctor", projectArg))}                   Explain current state and next command`
     );
@@ -10721,7 +10906,7 @@ async function cmdSetupWorkflow(args) {
     return;
   }
   if (hasFootprint) {
-    console.log(`${BOLD9}Recommended path:${RESET16} brownfield adoption`);
+    console.log(`${BOLD10}Recommended path:${RESET17} brownfield adoption`);
     console.log(
       `  ${cyan3(withProject("decantr adopt --yes", projectArg))}                       Analyze, attach, and verify`
     );
@@ -10729,13 +10914,13 @@ async function cmdSetupWorkflow(args) {
       `  ${cyan3(withProject("decantr codify --from-audit --style-bridge", projectArg))}               Propose local UI law and style bridge`
     );
     console.log("");
-    console.log(`${BOLD9}Optional visual evidence after the app is running:${RESET16}`);
+    console.log(`${BOLD10}Optional visual evidence after the app is running:${RESET17}`);
     console.log(
       `  ${cyan3(withProject("decantr verify --base-url http://localhost:3000 --evidence", projectArg))}`
     );
     return;
   }
-  console.log(`${BOLD9}Recommended path:${RESET16} greenfield start`);
+  console.log(`${BOLD10}Recommended path:${RESET17} greenfield start`);
   console.log(`  ${cyan3("decantr new my-app --blueprint=<slug>")}`);
   console.log(`  ${cyan3("decantr init --workflow=greenfield --adoption=contract-only")}`);
 }
@@ -10785,7 +10970,7 @@ async function cmdAdoptWorkflow(args) {
   const hydratePacks = flagBoolean(flags, "packs", true) && !flagBoolean(flags, "skip-packs") && !flagBoolean(flags, "offline") && process.env.DECANTR_OFFLINE !== "true";
   const initCi = flagBoolean(flags, "ci") || flagBoolean(flags, "init-ci");
   const assistantBridge = flagString(flags, "assistant-bridge");
-  const hasEssence = existsSync28(join30(projectRoot, "decantr.essence.json"));
+  const hasEssence = existsSync29(join31(projectRoot, "decantr.essence.json"));
   const proposalFlag = flagBoolean(flags, "replace-essence") ? "--replace-essence" : flagBoolean(flags, "merge-proposal") || hasEssence ? "--merge-proposal" : "--accept-proposal";
   const steps = [
     "analyze current app and write .decantr/brownfield intelligence",
@@ -10834,7 +11019,7 @@ async function cmdAdoptWorkflow(args) {
   if (hydratePacks) {
     try {
       const { bundle, contextDir } = await compileHostedExecutionPackBundle(
-        join30(projectRoot, "decantr.essence.json")
+        join31(projectRoot, "decantr.essence.json")
       );
       const written = writeHostedExecutionPackContextArtifacts(
         contextDir,
@@ -10846,7 +11031,7 @@ async function cmdAdoptWorkflow(args) {
         )
       );
     } catch (e) {
-      console.log(`${YELLOW12}Pack hydration skipped:${RESET16} ${e.message}`);
+      console.log(`${YELLOW13}Pack hydration skipped:${RESET17} ${e.message}`);
       console.log(
         dim3(
           `Run ${compilePacksCommandForProject(projectArg)} after adoption if you want hosted page/review packs.`
@@ -10859,7 +11044,7 @@ async function cmdAdoptWorkflow(args) {
   await cmdGraph(projectRoot, { displayRoot: process.cwd() });
   if (process.exitCode && process.exitCode !== 0) return;
   if (runVerify) {
-    const { cmdHealth } = await import("./health-G7HQCDXX.js");
+    const { cmdHealth } = await import("./health-RKUKPG72.js");
     await cmdHealth(projectRoot, {
       browser: runBrowser,
       browserBaseUrl: baseUrl,
@@ -10875,7 +11060,7 @@ async function cmdAdoptWorkflow(args) {
     await cmdCi(ciArgs, process.cwd());
   }
   console.log("");
-  console.log(`${BOLD9}Brownfield operating loop:${RESET16}`);
+  console.log(`${BOLD10}Brownfield operating loop:${RESET17}`);
   console.log(
     `  ${cyan3(withProject("decantr codify --from-audit --style-bridge", projectArg))}  Propose project-owned UI law and style bridge`
   );
@@ -10888,6 +11073,9 @@ async function cmdAdoptWorkflow(args) {
   console.log(
     `  ${cyan3(withProject("decantr verify --brownfield --local-patterns", projectArg))}  Check contract, health, and local law after edits`
   );
+  console.log(
+    `  ${cyan3(studioCommandForProject(projectArg))}                      Inspect routes, findings, and attention areas visually`
+  );
   console.log(
     `  ${cyan3(withProject("decantr verify --since-baseline", projectArg))}      Compare future work against this baseline`
   );
@@ -10930,7 +11118,7 @@ async function cmdVerifyWorkflow(args) {
     return;
   }
   if (workspaceMode) {
-    const { cmdWorkspace } = await import("./workspace-3AJEXXUL.js");
+    const { cmdWorkspace } = await import("./workspace-RJCFPVBL.js");
     await cmdWorkspace(process.cwd(), ["workspace", "health", ...withoutWorkflowOnlyFlags(args)]);
     return;
   }
@@ -10963,7 +11151,7 @@ async function cmdVerifyWorkflow(args) {
   }
   let guardExitCode;
   if (brownfield) {
-    const { cmdHeal, collectCheckIssues } = await import("./heal-OKZ5QZN7.js");
+    const { cmdHeal, collectCheckIssues } = await import("./heal-YXWB6LTI.js");
     if (quietOutput) {
       const result = collectCheckIssues(workspaceInfo.appRoot, { brownfield: true });
       guardExitCode = result.issues.some((issue) => issue.type === "error") ? 1 : void 0;
@@ -10973,7 +11161,7 @@ async function cmdVerifyWorkflow(args) {
       process.exitCode = void 0;
     }
   }
-  const { cmdHealth, parseHealthArgs } = await import("./health-G7HQCDXX.js");
+  const { cmdHealth, parseHealthArgs } = await import("./health-RKUKPG72.js");
   await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(healthArgs));
   if (localPatterns) {
     const validation = validateLocalLaw(workspaceInfo.appRoot);
@@ -10981,7 +11169,7 @@ async function cmdVerifyWorkflow(args) {
       if (!quietOutput) {
         console.log("");
         console.log(
-          `${YELLOW12}Local pattern pack missing.${RESET16} Run ${cyan3(withProject("decantr codify --from-audit", projectArg))}, review the proposal, then run ${cyan3(withProject("decantr codify --accept", projectArg))}.`
+          `${YELLOW13}Local pattern pack missing.${RESET17} Run ${cyan3(withProject("decantr codify --from-audit", projectArg))}, review the proposal, then run ${cyan3(withProject("decantr codify --accept", projectArg))}.`
         );
       }
       process.exitCode = process.exitCode || 1;
@@ -10992,23 +11180,23 @@ async function cmdVerifyWorkflow(args) {
       const blockingWarnings = failOn === "warn" ? validation.warnings : [];
       if (!quietOutput) {
         console.log("");
-        console.log(`${GREEN16}Local pattern pack found:${RESET16} ${validation.patternsPath}`);
+        console.log(`${GREEN17}Local pattern pack found:${RESET17} ${validation.patternsPath}`);
         if (validation.ruleManifestPresent) {
-          console.log(`${GREEN16}Local rule manifest found:${RESET16} ${validation.rulesPath}`);
+          console.log(`${GREEN17}Local rule manifest found:${RESET17} ${validation.rulesPath}`);
           console.log(
-            `${DIM16}Enforcement: accepted .decantr/rules.json is the Decantr-scanned layer; --fail-on controls whether findings block.${RESET16}`
+            `${DIM17}Enforcement: accepted .decantr/rules.json is the Decantr-scanned layer; --fail-on controls whether findings block.${RESET17}`
           );
         } else {
           console.log(
-            `${YELLOW12}Local rule manifest missing.${RESET16} Run ${cyan3("decantr codify --from-audit")} to propose .decantr/rules.json.`
+            `${YELLOW13}Local rule manifest missing.${RESET17} Run ${cyan3("decantr codify --from-audit")} to propose .decantr/rules.json.`
           );
         }
         for (const warning of validation.warnings.slice(0, 8)) {
-          console.log(`${YELLOW12}warn${RESET16} ${warning}`);
+          console.log(`${YELLOW13}warn${RESET17} ${warning}`);
         }
         if (validation.findings.length > 0) {
           console.log("");
-          console.log(`${BOLD9}Local law findings:${RESET16}`);
+          console.log(`${BOLD10}Local law findings:${RESET17}`);
           for (const finding of validation.findings.slice(0, 20)) {
             console.log(
               `  ${finding.severity.toUpperCase()} ${finding.ruleId} ${finding.file}:${finding.line}:${finding.column} ${finding.message}`
@@ -11018,7 +11206,7 @@ async function cmdVerifyWorkflow(args) {
             console.log(dim3(`  ...${validation.findings.length - 20} more finding(s)`));
           }
         } else if (validation.ruleManifestPresent) {
-          console.log(`${GREEN16}Local rule checks passed.${RESET16}`);
+          console.log(`${GREEN17}Local rule checks passed.${RESET17}`);
         }
       }
       if (blockingFindings.length > 0 || blockingWarnings.length > 0) {
@@ -11029,12 +11217,12 @@ async function cmdVerifyWorkflow(args) {
   const styleBridge = createStyleBridgeTaskSummary(workspaceInfo.appRoot);
   if (!quietOutput && styleBridge.path) {
     console.log("");
-    console.log(`${GREEN16}Style bridge found:${RESET16} ${styleBridge.path}`);
+    console.log(`${GREEN17}Style bridge found:${RESET17} ${styleBridge.path}`);
     console.log(
-      `${DIM16}${styleBridge.mappingCount} mapping(s), ${styleBridge.stylingApproach ?? "unknown"} styling${styleBridge.themeModes.length > 0 ? `, themes: ${styleBridge.themeModes.join(", ")}` : ""}${RESET16}`
+      `${DIM17}${styleBridge.mappingCount} mapping(s), ${styleBridge.stylingApproach ?? "unknown"} styling${styleBridge.themeModes.length > 0 ? `, themes: ${styleBridge.themeModes.join(", ")}` : ""}${RESET17}`
     );
     console.log(
-      `${DIM16}Enforcement: advisory style-intent mapping; pair with accepted local rules, lint, tests, or visual regression when it should block.${RESET16}`
+      `${DIM17}Enforcement: advisory style-intent mapping; pair with accepted local rules, lint, tests, or visual regression when it should block.${RESET17}`
     );
   }
   if (guardExitCode && guardExitCode !== 0 && (!process.exitCode || process.exitCode === 0)) {
@@ -11042,9 +11230,9 @@ async function cmdVerifyWorkflow(args) {
   }
 }
 function readJsonIfPresent(path) {
-  if (!existsSync28(path)) return null;
+  if (!existsSync29(path)) return null;
   try {
-    return JSON.parse(readFileSync21(path, "utf-8"));
+    return JSON.parse(readFileSync22(path, "utf-8"));
   } catch {
     return null;
   }
@@ -11196,7 +11384,7 @@ async function cmdTaskWorkflow(args) {
   }
   const route = routeInput.startsWith("/") ? routeInput : `/${routeInput}`;
   const taskSummary = positional.slice(1).join(" ").trim();
-  const essencePath = join30(workspaceInfo.appRoot, "decantr.essence.json");
+  const essencePath = join31(workspaceInfo.appRoot, "decantr.essence.json");
   const essence = readJsonIfPresent(essencePath);
   if (!essence) {
     console.error(
@@ -11220,19 +11408,19 @@ async function cmdTaskWorkflow(args) {
   }
   const section = essence.blueprint.sections.find((entry) => entry.id === target.section);
   const page = section?.pages.find((entry) => entry.id === target.page);
-  const contextDir = join30(workspaceInfo.appRoot, ".decantr", "context");
-  const manifest = readJsonIfPresent(join30(contextDir, "pack-manifest.json"));
-  const projectJson = readJsonIfPresent(join30(workspaceInfo.appRoot, ".decantr", "project.json"));
+  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(join30(workspaceInfo.appRoot, ".decantr", "evidence", "visual-manifest.json"));
+  const visualManifest = readJsonIfPresent(join31(workspaceInfo.appRoot, ".decantr", "evidence", "visual-manifest.json"));
   const screenshot = visualManifest?.routes?.find((entry) => entry.route === route)?.screenshot;
   const localPatternPackPath = localPatternsPath(workspaceInfo.appRoot);
   const localRuleManifestPath = localRulesPath(workspaceInfo.appRoot);
   const acceptedStyleBridgePath = styleBridgePath(workspaceInfo.appRoot);
-  const graphDir = join30(workspaceInfo.appRoot, ".decantr", "graph");
-  const contractCapsulePath = join30(graphDir, "contract-capsule.json");
-  const graphSnapshotPath = join30(graphDir, "graph.snapshot.json");
+  const graphDir = join31(workspaceInfo.appRoot, ".decantr", "graph");
+  const contractCapsulePath = join31(graphDir, "contract-capsule.json");
+  const graphSnapshotPath = join31(graphDir, "graph.snapshot.json");
   const contractCapsule = readJsonIfPresent(contractCapsulePath);
   const graphSnapshot = readJsonIfPresent(graphSnapshotPath);
   const routeGraphContext = buildGraphRouteContext(graphSnapshot, route, { task: taskSummary });
@@ -11275,12 +11463,96 @@ async function cmdTaskWorkflow(args) {
     projectRoot: workspaceInfo.appRoot,
     workflowMode: projectJson?.initialized?.workflowMode ?? null,
     adoptionMode: projectJson?.initialized?.adoptionMode ?? null,
-    hasLocalPatterns: existsSync28(localPatternPackPath),
-    hasLocalRules: existsSync28(localRuleManifestPath),
+    hasLocalPatterns: existsSync29(localPatternPackPath),
+    hasLocalRules: existsSync29(localRuleManifestPath),
     hasPackManifest: Boolean(manifest),
     taskSummary,
-    hasStyleBridge: existsSync28(acceptedStyleBridgePath)
+    hasStyleBridge: existsSync29(acceptedStyleBridgePath)
   });
+  const readTargets = [
+    pagePack ? displayProjectPath(workspaceInfo, join31(".decantr/context", pagePack.markdown)) : null,
+    sectionPack ? displayProjectPath(workspaceInfo, join31(".decantr/context", sectionPack.markdown)) : null,
+    manifest?.scaffold?.markdown ? displayProjectPath(workspaceInfo, join31(".decantr/context", manifest.scaffold.markdown)) : null,
+    displayProjectPath(workspaceInfo, ".decantr/context/scaffold.md"),
+    displayProjectPath(workspaceInfo, "DECANTR.md"),
+    existsSync29(localPatternPackPath) ? displayProjectPath(workspaceInfo, ".decantr/local-patterns.json") : null,
+    existsSync29(localRuleManifestPath) ? displayProjectPath(workspaceInfo, ".decantr/rules.json") : null,
+    existsSync29(acceptedStyleBridgePath) ? displayProjectPath(workspaceInfo, ".decantr/style-bridge.json") : null,
+    contractCapsule ? displayProjectPath(workspaceInfo, ".decantr/graph/contract-capsule.json") : null,
+    routeGraphContext && !contractCapsule ? displayProjectPath(workspaceInfo, ".decantr/graph/graph.snapshot.json") : null
+  ].filter((value) => Boolean(value));
+  const taskLoopState = readTargets.length === 0 ? "blocked_missing_context" : !routeGraphContext ? "blocked_missing_graph" : "ready_to_edit";
+  const taskLoop = {
+    $schema: LOOP_READINESS_V2_SCHEMA_URL,
+    schemaVersion: 2,
+    state: taskLoopState,
+    status: taskLoopState === "ready_to_edit" ? "healthy" : "blocked",
+    verdict: taskLoopState === "ready_to_edit" ? "Task context is ready for an agent edit." : "Task context is missing required context or graph evidence.",
+    summary: `${route} task context with ${readTargets.length} read target(s), ${routeGraphContext ? routeGraphContext.summary.nodes : 0} graph node(s), and ${changedRoutes.length} changed-route hint(s).`,
+    authority: {
+      activeLane: projectJson?.initialized?.workflowMode === "brownfield-attach" ? "production-source" : "essence-contract",
+      summary: `${authority.lane}: ${authority.sourceAuthority}`,
+      stopRule: "If runtime source and Decantr context disagree, stop and report drift instead of guessing."
+    },
+    evidenceTier: {
+      schemaVersion: 2,
+      stage: routeGraphContext ? "graph" : "static",
+      status: taskLoopState === "ready_to_edit" ? "healthy" : "incomplete",
+      capabilities: routeGraphContext ? ["static-audit", "project-health", "typed-graph"] : ["static-audit", "project-health"],
+      coverage: {
+        declaredRoutes: 1,
+        runtimeRoutesChecked: 0,
+        findingsAnchored: routeGraphContext?.summary.openFindings ?? 0,
+        findingsWithRepairPlan: 0,
+        runtimeProbeCount: 0,
+        visualArtifactCount: screenshot ? 1 : 0
+      },
+      confidence: {
+        level: routeGraphContext ? "moderate" : "low",
+        score: routeGraphContext ? 0.64 : 0.32,
+        reasons: [
+          routeGraphContext ? "route graph context is present" : "route graph context is missing",
+          screenshot ? "visual evidence reference is available" : "no visual evidence reference was found"
+        ]
+      }
+    },
+    blockingReasons: taskLoopState === "ready_to_edit" ? [] : [
+      taskLoopState === "blocked_missing_graph" ? "Route graph context is missing or stale." : "Route context read targets are missing."
+    ],
+    nextActions: taskLoopState === "ready_to_edit" ? ["Edit only after reading the listed context, then run the verify command."] : [
+      taskLoopState === "blocked_missing_graph" ? "Run `decantr graph`, then rerun `decantr task`." : "Run `decantr refresh`, then rerun `decantr task`."
+    ],
+    maker: {
+      title: "Maker instructions",
+      instructions: [
+        "Read the listed route, section, scaffold, DECANTR, local-law, and graph targets before editing.",
+        "Preserve the active authority lane and existing production behavior outside this task.",
+        "Stop and report drift if source, graph, and contract context disagree."
+      ]
+    },
+    checker: {
+      title: "Checker instructions",
+      instructions: [
+        "Rerun the verify command after edits.",
+        "Use changed-file graph impact and route findings to decide whether more routes need review.",
+        "Do not treat advisory critique as blocking without T1/T2 evidence."
+      ]
+    },
+    readTargets,
+    graphImpact: {
+      status: routeGraphContext ? "ready" : graphSnapshot ? "stale" : "missing",
+      snapshotId: routeGraphContext?.snapshotId ?? graphSnapshot?.id ?? null,
+      sourceHash: routeGraphContext?.sourceHash ?? graphSnapshot?.source_hash ?? null,
+      sourceArtifactCount: routeGraphContext?.summary.sourceArtifacts ?? 0,
+      staleArtifacts: []
+    },
+    stopConditions: [
+      "Runtime source and Decantr context disagree.",
+      "The route graph cannot resolve a source file affected by the edit.",
+      "A fix requires contract/source/local-law mutation outside the explicit workflow."
+    ],
+    verifyCommand: withProject("decantr verify --brownfield --local-patterns", projectArg)
+  };
   const context = {
     route,
     task: taskSummary || null,
@@ -11288,18 +11560,7 @@ async function cmdTaskWorkflow(args) {
     page: target.page,
     shell: page?.shell ?? section?.shell ?? null,
     patterns: routePatterns,
-    read: [
-      pagePack ? displayProjectPath(workspaceInfo, join30(".decantr/context", pagePack.markdown)) : null,
-      sectionPack ? displayProjectPath(workspaceInfo, join30(".decantr/context", sectionPack.markdown)) : null,
-      manifest?.scaffold?.markdown ? displayProjectPath(workspaceInfo, join30(".decantr/context", manifest.scaffold.markdown)) : null,
-      displayProjectPath(workspaceInfo, ".decantr/context/scaffold.md"),
-      displayProjectPath(workspaceInfo, "DECANTR.md"),
-      existsSync28(localPatternPackPath) ? displayProjectPath(workspaceInfo, ".decantr/local-patterns.json") : null,
-      existsSync28(localRuleManifestPath) ? displayProjectPath(workspaceInfo, ".decantr/rules.json") : null,
-      existsSync28(acceptedStyleBridgePath) ? displayProjectPath(workspaceInfo, ".decantr/style-bridge.json") : null,
-      contractCapsule ? displayProjectPath(workspaceInfo, ".decantr/graph/contract-capsule.json") : null,
-      routeGraphContext && !contractCapsule ? displayProjectPath(workspaceInfo, ".decantr/graph/graph.snapshot.json") : null
-    ].filter(Boolean),
+    read: readTargets,
     graph: contractCapsule || graphSnapshot ? {
       capsule: contractCapsule ? {
         path: displayProjectPath(workspaceInfo, ".decantr/graph/contract-capsule.json"),
@@ -11342,6 +11603,7 @@ async function cmdTaskWorkflow(args) {
     styleBridge: displayedStyleBridge,
     changedFiles: currentChangedFiles,
     changedRoutes,
+    loop: taskLoop,
     verifyCommand: withProject("decantr verify --brownfield --local-patterns", projectArg)
   };
   if (flagBoolean(flags, "json")) {
@@ -11355,18 +11617,18 @@ async function cmdTaskWorkflow(args) {
   if (context.patterns.length > 0) console.log(`  Patterns: ${context.patterns.join(", ")}`);
   if (taskSummary) console.log(`  Task: ${taskSummary}`);
   console.log("");
-  console.log(`${BOLD9}Read before editing:${RESET16}`);
+  console.log(`${BOLD10}Read before editing:${RESET17}`);
   for (const path of context.read) {
     console.log(`  ${cyan3(path)}`);
   }
   if (context.screenshot) {
     console.log("");
-    console.log(`${BOLD9}Visual evidence:${RESET16}`);
+    console.log(`${BOLD10}Visual evidence:${RESET17}`);
     console.log(`  ${cyan3(context.screenshot)}`);
   }
   if (context.graph?.capsule || context.graph?.snapshot) {
     console.log("");
-    console.log(`${BOLD9}Typed contract graph:${RESET16}`);
+    console.log(`${BOLD10}Typed contract graph:${RESET17}`);
     if (context.graph.capsule) {
       console.log(`  Capsule: ${cyan3(context.graph.capsule.path)}`);
       if (context.graph.capsule.cacheKey) {
@@ -11414,18 +11676,18 @@ async function cmdTaskWorkflow(args) {
     }
   }
   console.log("");
-  console.log(`${BOLD9}Authority for this task:${RESET16}`);
+  console.log(`${BOLD10}Authority for this task:${RESET17}`);
   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}`);
+    console.log(`  ${YELLOW13}Boundary:${RESET17} ${warning}`);
   }
   if (context.localLaw.patternCount > 0 || context.localLaw.ruleCount > 0) {
     console.log("");
-    console.log(`${BOLD9}Project-owned local law:${RESET16}`);
+    console.log(`${BOLD10}Project-owned local law:${RESET17}`);
     if (context.localLaw.patternsPath) {
       console.log(
         `  Patterns: ${cyan3(context.localLaw.patternsPath)} (${context.localLaw.patternCount})`
@@ -11447,7 +11709,7 @@ async function cmdTaskWorkflow(args) {
     }
     if (context.localLaw.behaviorObligations.length > 0) {
       console.log("");
-      console.log(`${BOLD9}Behavior obligations:${RESET16}`);
+      console.log(`${BOLD10}Behavior obligations:${RESET17}`);
       for (const behavior of context.localLaw.behaviorObligations.slice(0, 3)) {
         const obligations = behavior.obligations.slice(0, 3).map((obligation) => obligation.label).join("; ");
         const reasons = behavior.relevance.reasons.slice(0, 3).join(", ");
@@ -11464,14 +11726,14 @@ async function cmdTaskWorkflow(args) {
     }
   } else {
     console.log("");
-    console.log(`${BOLD9}Project-owned local law:${RESET16}`);
+    console.log(`${BOLD10}Project-owned local law:${RESET17}`);
     console.log(
-      `  ${YELLOW12}Not codified yet.${RESET16} Run ${cyan3(withProject("decantr codify --from-audit", projectArg))} after adoption.`
+      `  ${YELLOW13}Not codified yet.${RESET17} Run ${cyan3(withProject("decantr codify --from-audit", projectArg))} after adoption.`
     );
   }
   if (context.styleBridge.path) {
     console.log("");
-    console.log(`${BOLD9}Project-owned style bridge:${RESET16}`);
+    console.log(`${BOLD10}Project-owned style bridge:${RESET17}`);
     console.log(
       `  Bridge: ${cyan3(context.styleBridge.path)} (${context.styleBridge.mappingCount} mappings, ${context.styleBridge.stylingApproach ?? "unknown"} styling)`
     );
@@ -11488,7 +11750,7 @@ async function cmdTaskWorkflow(args) {
   }
   if (context.changedFiles.length > 0) {
     console.log("");
-    console.log(`${BOLD9}Changed-file context:${RESET16}`);
+    console.log(`${BOLD10}Changed-file context:${RESET17}`);
     for (const file of context.changedFiles.slice(0, 8)) {
       console.log(`  ${file}`);
     }
@@ -11500,7 +11762,14 @@ async function cmdTaskWorkflow(args) {
     }
   }
   console.log("");
-  console.log(`${BOLD9}LLM instruction:${RESET16}`);
+  console.log(`${BOLD10}Control loop:${RESET17}`);
+  console.log(
+    `  State: ${context.loop.state} | evidence ${context.loop.evidenceTier.confidence.level}`
+  );
+  console.log(`  Next: ${context.loop.nextActions[0]}`);
+  console.log(`  Stop: ${context.loop.stopConditions[0]}`);
+  console.log("");
+  console.log(`${BOLD10}LLM instruction:${RESET17}`);
   console.log(
     "  Preserve the active authority above. Use the route pack, section context, typed route graph, local laws, changed-file impact, and visual evidence as the task contract before changing code."
   );
@@ -11528,7 +11797,7 @@ async function cmdCodifyWorkflow(args) {
   const workspaceInfo = resolveWorkflowProject(flags, "codify");
   if (!workspaceInfo) return;
   if (flagBoolean(flags, "accept")) {
-    if (!existsSync28(localPatternsProposalPath(workspaceInfo.appRoot)) && !existsSync28(localRulesProposalPath(workspaceInfo.appRoot)) && !existsSync28(styleBridgeProposalPath(workspaceInfo.appRoot))) {
+    if (!existsSync29(localPatternsProposalPath(workspaceInfo.appRoot)) && !existsSync29(localRulesProposalPath(workspaceInfo.appRoot)) && !existsSync29(styleBridgeProposalPath(workspaceInfo.appRoot))) {
       console.error(
         error2(
           "No codify proposal found. Run `decantr codify --from-audit`, `decantr codify --style-bridge`, or `decantr codify` first."
@@ -11562,14 +11831,14 @@ async function cmdCodifyWorkflow(args) {
   }
   const detected = detectProject(workspaceInfo.appRoot);
   const essence = readJsonIfPresent(
-    join30(workspaceInfo.appRoot, "decantr.essence.json")
+    join31(workspaceInfo.appRoot, "decantr.essence.json")
   );
   const fromAudit = flagBoolean(flags, "from-audit") || flagBoolean(flags, "discover-local-patterns") || flagBoolean(flags, "codify-local-patterns");
   const wantsStyleBridge = flagBoolean(flags, "style-bridge");
   const mapPatternSlug = flagString(flags, "map-pattern") ?? flagString(flags, "hosted-pattern");
   if (mapPatternSlug) {
     const registryClient = new RegistryClient({
-      cacheDir: join30(workspaceInfo.appRoot, ".decantr", "cache")
+      cacheDir: join31(workspaceInfo.appRoot, ".decantr", "cache")
     });
     const candidates = await loadPatternDiscoveryCandidates(registryClient);
     const candidate = findPatternCandidateBySlug(candidates, mapPatternSlug);
@@ -11693,22 +11962,25 @@ async function cmdContentWorkflow(args) {
 }
 function cmdHelp() {
   console.log(`
-${BOLD9}decantr${RESET16} \u2014 AI Frontend Governance for codebases touched by AI agents
+${BOLD10}decantr${RESET17} \u2014 AI Frontend Governance for codebases touched by AI agents
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr setup [--project <path>]
   decantr scan [--project <path>] [--json]
   decantr new <name> [--blueprint=X] [--archetype=X] [--theme=X] [--workflow=greenfield] [--adoption=decantr-css] [--telemetry]
   decantr adopt [--project <path>] [--base-url <url>] [--evidence] [--ci] [--no-packs] [--yes]
   decantr task <route> ["task summary"] [--project <path>] [--since origin/main] [--json]
   decantr verify [--project <path>] [--brownfield] [--local-patterns] [health options]
+  decantr resolve [--project <path>] [--json] [--defer <finding-id>] [--mark-advisory <finding-id>]
   decantr graph [--project <path>] [--route <route>] [--node <id>] [--file <path>] [--task <text>] [--snapshot-id <id>] [--compare-to <id>] [--capsule-source-limit <count>] [--check] [--json]
   decantr ci [--project <path>] [--workspace] [--fail-on error|warn|none]
   decantr doctor [--project <path>] [--workspace] [--json]
   decantr codify [--from-audit] [--style-bridge] [--map-pattern <slug>] [--accept] [--project <path>]
   decantr studio [--port 4319] [--host 127.0.0.1] [--report decantr-health.json] [--workspace]
 
-${BOLD9}Advanced primitives:${RESET16}
+${formatWhichCommandFirst()}
+
+${BOLD10}Advanced primitives:${RESET17}
   decantr init [options]
   decantr analyze
   decantr magic <prompt> [--dry-run]
@@ -11719,6 +11991,7 @@ ${BOLD9}Advanced primitives:${RESET16}
   decantr check
   decantr check --brownfield
   decantr sync-drift
+  decantr resolve [--json]
   decantr graph [--project <path>] [--route <route>] [--node <id>] [--file <path>] [--task <text>] [--snapshot-id <id>] [--compare-to <id>] [--capsule-source-limit <count>] [--check] [--json]
   decantr search <query> [--type <type>] [--sort <recommended|recent|name>] [--recommended] [--source <authored|benchmark|hybrid>]
   decantr suggest <query> [--type <type>] [--route <route>] [--file <path>] [--from-code]
@@ -11753,7 +12026,7 @@ ${BOLD9}Advanced primitives:${RESET16}
   decantr logout
   decantr help
 
-${BOLD9}Init Options:${RESET16}
+${BOLD10}Init Options:${RESET17}
   --blueprint, -b    Blueprint ID
   --theme            Theme ID
   --mode             Color mode: dark | light | auto
@@ -11775,13 +12048,14 @@ ${BOLD9}Init Options:${RESET16}
   --registry         Custom registry URL
   --telemetry        Opt this project into privacy-filtered CLI product telemetry
 
-${BOLD9}Commands:${RESET16}
+${BOLD10}Commands:${RESET17}
   ${cyan3("setup")}       Detect project state and recommend the right Decantr workflow
   ${cyan3("scan")}        Read-only Brownfield reconnaissance; no files written
   ${cyan3("new")}         Create a new greenfield workspace and bootstrap the available starter adapter
   ${cyan3("adopt")}       Brownfield one-liner: analyze, attach, verify, and show next steps
   ${cyan3("task")}        Prepare route/task context, local law, behavior obligations, evidence, and changed-file impact for an AI coding assistant
   ${cyan3("verify")}      One reliability gate over Project Health, Brownfield checks, baselines, and evidence
+  ${cyan3("resolve")}     Read authority conflicts and explicitly defer/advisory-mark drift
   ${cyan3("graph")}       Build typed Contract graph artifacts and the agent cache capsule
   ${cyan3("ci")}          Non-mutating CI gate and CI integration generator
   ${cyan3("doctor")}      Explain Decantr state, artifact ownership, and the next command
@@ -11789,7 +12063,7 @@ ${BOLD9}Commands:${RESET16}
   ${cyan3("studio")}      Open a local Project Health dashboard backed by the same report
   ${cyan3("content")}     Content-author namespace: check, create, publish
 
-${BOLD9}Advanced commands:${RESET16}
+${BOLD10}Advanced commands:${RESET17}
   ${cyan3("magic")}       Greenfield-first intent flow; steers existing apps into analyze + init
   ${cyan3("init")}        Attach Decantr contract/context files to an existing project or empty workspace
   ${cyan3("status")}      Show project status, DNA axioms, and blueprint info
@@ -11801,6 +12075,7 @@ ${BOLD9}Advanced commands:${RESET16}
   ${cyan3("migrate")}     Migrate older essence files to v4 format (with .pre-v4.backup.json backup)
   ${cyan3("check")}       Detect drift issues (validate + guard rules) [--telemetry] [--brownfield]
   ${cyan3("sync-drift")}  Review and resolve drift log entries
+  ${cyan3("resolve")}     Group source-vs-contract conflicts and print exact resolution actions
   ${cyan3("graph")}       Generate .decantr/graph snapshot, history, manifest, diff, and contract capsule
   ${cyan3("search")}      Search official/community vocabulary
   ${cyan3("suggest")}     Suggest patterns or alternatives for a query
@@ -11821,7 +12096,7 @@ ${BOLD9}Advanced commands:${RESET16}
   ${cyan3("upgrade")}     Check for content updates from registry
   ${cyan3("help")}        Show this help
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr setup
   decantr scan
   decantr scan --json
@@ -11830,6 +12105,7 @@ ${BOLD9}Examples:${RESET16}
   decantr adopt --project apps/web --yes
   decantr task /feed "add saved recipe actions"
   decantr verify --brownfield --local-patterns
+  decantr resolve
   decantr graph --project apps/web
   decantr graph --project apps/web --route /feed --task "improve loading" --json
   decantr graph --project apps/web --file src/app/page.tsx --impact --json
@@ -11885,35 +12161,36 @@ ${BOLD9}Examples:${RESET16}
   decantr registry audit-project --namespace @official --dist dist --sources src
   decantr create pattern my-card
 
-${BOLD9}Workflow Model:${RESET16}
+${BOLD10}Workflow Model:${RESET17}
   ${cyan3("Greenfield blueprint")}   decantr new my-app --blueprint=X --workflow=greenfield --adoption=decantr-css
   ${cyan3("Greenfield contract")}    decantr init --workflow=greenfield --adoption=contract-only
   ${cyan3("Brownfield adoption")}    decantr adopt --yes
   ${cyan3("Brownfield preview")}     decantr scan -> decantr adopt --yes
   ${cyan3("Brownfield monorepo")}    decantr adopt --project apps/web --yes
   ${cyan3("Daily LLM work")}          decantr task <route> "<change>" -> decantr verify --brownfield --local-patterns
+  ${cyan3("Drift resolution")}        decantr resolve -> codify/init/graph/repair source explicitly
   ${cyan3("Typed contract graph")}    decantr graph -> agent session loads .decantr/graph/contract-capsule.json
   ${cyan3("Project-owned law")}       decantr codify --from-audit -> edit proposal -> decantr codify --accept
   ${cyan3("Hybrid composition")}     decantr add/remove, decantr theme switch, decantr registry, decantr upgrade
 
-${BOLD9}Bootstrap adapters:${RESET16}
+${BOLD10}Bootstrap adapters:${RESET17}
   Runnable starter adapters: ${cyan3("react-vite")}, ${cyan3("next-app")}, ${cyan3("vanilla-vite")}, ${cyan3("vue-vite")}, ${cyan3("sveltekit")}, ${cyan3("angular")}, ${cyan3("solid-vite")}
   Unsupported targets resolve through ${cyan3("generic-web")} contract-only mode until their starter adapters land.
 `);
 }
 function cmdRulesHelp() {
   console.log(`
-${BOLD9}decantr rules${RESET16} \u2014 Preview or apply assistant bridge snippets
+${BOLD10}decantr rules${RESET17} \u2014 Preview or apply assistant bridge snippets
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr rules preview [--project=<path>]
   decantr rules apply [--project=<path>]
 
-${BOLD9}Subcommands:${RESET16}
+${BOLD10}Subcommands:${RESET17}
   ${cyan3("preview")}  Print target-specific Decantr bridge guidance without mutating rule files
   ${cyan3("apply")}    Idempotently write Decantr bridge blocks to supported assistant rule files
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr rules preview
   decantr rules preview --project=apps/web
   decantr rules apply --project=apps/web
@@ -11921,21 +12198,23 @@ ${BOLD9}Examples:${RESET16}
 }
 function cmdScanHelp() {
   console.log(`
-${BOLD9}decantr scan${RESET16} \u2014 Read-only Brownfield reconnaissance
+${BOLD10}decantr scan${RESET17} \u2014 Read-only Brownfield reconnaissance
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr scan [--project <path>] [--json]
 
-${BOLD9}Options:${RESET16}
+${BOLD10}Options:${RESET17}
   --project   App path inside a workspace/monorepo
   --json      Emit the ScanReportV1 JSON to stdout
 
-${BOLD9}Behavior:${RESET16}
+${BOLD10}Behavior:${RESET17}
   Reads local project files, detects frontend framework/routes/styling/static-hosting signals,
   and prints a terminal report. It does not write .decantr files, install dependencies,
   build the app, execute scripts, upload source, or open pull requests.
 
-${BOLD9}Examples:${RESET16}
+${formatWhichCommandFirst()}
+
+${BOLD10}Examples:${RESET17}
   decantr scan
   decantr scan --project apps/web
   decantr scan --json
@@ -11946,9 +12225,9 @@ function isCommandHelpRequest(args) {
 }
 function cmdHealthHelp() {
   console.log(`
-${BOLD9}decantr health${RESET16} \u2014 Generate a local Project Health report
+${BOLD10}decantr health${RESET17} \u2014 Generate a local Project Health report
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr health [--format text|json|markdown] [--output <file>]
   decantr health --json
   decantr health --markdown
@@ -11961,7 +12240,7 @@ ${BOLD9}Usage:${RESET16}
   decantr health --since-baseline
   decantr health init-ci [legacy alias for decantr ci init]
 
-${BOLD9}Options:${RESET16}
+${BOLD10}Options:${RESET17}
   --format      Output format: text, json, or markdown
   --json        Emit JSON report
   --markdown    Emit markdown report
@@ -11977,7 +12256,7 @@ ${BOLD9}Options:${RESET16}
   --since-baseline Compare this run to .decantr/health-baseline.json
   --design-tokens Compare against a Figma/Tokens Studio JSON export
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr health
   decantr health --json
   decantr health --markdown --output decantr-health.md
@@ -11991,14 +12270,14 @@ ${BOLD9}Examples:${RESET16}
 }
 function cmdWorkspaceHelp() {
   console.log(`
-${BOLD9}decantr workspace${RESET16} \u2014 Inspect Decantr projects and app candidates across a monorepo
+${BOLD10}decantr workspace${RESET17} \u2014 Inspect Decantr projects and app candidates across a monorepo
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr workspace list [--json]
   decantr workspace health [--json|--markdown] [--output <file>]
   decantr workspace health --changed --since origin/main
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr workspace list
   decantr adopt --project apps/web --yes
   decantr workspace health
@@ -12008,16 +12287,16 @@ ${BOLD9}Examples:${RESET16}
 }
 function cmdContentHealthHelp() {
   console.log(`
-${BOLD9}decantr content-health${RESET16} \u2014 Generate a local official-vocabulary health report
+${BOLD10}decantr content-health${RESET17} \u2014 Generate a local official-vocabulary health report
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr content-health [--format text|json|markdown] [--output <file>]
   decantr content-health --json
   decantr content-health --markdown
   decantr content-health --ci [--fail-on error|warn|none]
   decantr content-health --prompt <finding-id>
 
-${BOLD9}Options:${RESET16}
+${BOLD10}Options:${RESET17}
   --format      Output format: text, json, or markdown
   --json        Emit JSON report
   --markdown    Emit markdown report
@@ -12026,7 +12305,7 @@ ${BOLD9}Options:${RESET16}
   --fail-on     CI threshold: error, warn, or none
   --prompt      Print an AI-ready remediation prompt for a finding
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr content-health
   decantr content-health --json
   decantr content-health --markdown --output content-health.md
@@ -12035,23 +12314,29 @@ ${BOLD9}Examples:${RESET16}
 }
 function cmdStudioHelp() {
   console.log(`
-${BOLD9}decantr studio${RESET16} \u2014 Run a local Project Health dashboard
+${BOLD10}decantr studio${RESET17} \u2014 Run a local Project Health dashboard
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr studio [--port 4319] [--host 127.0.0.1] [--report decantr-health.json]
 
-${BOLD9}Options:${RESET16}
+${BOLD10}Options:${RESET17}
   --port        Local port to bind; defaults to 4319
   --host        Local host to bind; defaults to 127.0.0.1
   --report      Serve a read-only Project Health JSON artifact instead of scanning the current project
   --workspace   Serve a monorepo workspace health dashboard
 
-${BOLD9}Endpoints:${RESET16}
+${BOLD10}Endpoints:${RESET17}
   GET  /
   GET  /api/health
+  GET  /api/control-room
+  GET  /api/resolve
+  GET  /api/evidence
+  GET  /api/graph-impact
+  GET  /api/task-preview
+  GET  /api/proof
   POST /api/refresh
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr studio
   decantr studio --port 4320
   decantr studio --host 127.0.0.1 --port 4319
@@ -12062,9 +12347,9 @@ ${BOLD9}Examples:${RESET16}
 }
 function cmdRegistryHelp() {
   console.log(`
-${BOLD9}decantr registry${RESET16} \u2014 Read hosted execution packs and registry intelligence
+${BOLD10}decantr registry${RESET17} \u2014 Read hosted execution packs and registry intelligence
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr registry summary [--namespace <namespace>] [--json]
   decantr registry compile-packs [path] [--namespace <namespace>] [--json] [--write-context]
   decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context]
@@ -12075,9 +12360,9 @@ ${BOLD9}Usage:${RESET16}
 }
 function cmdThemeHelp() {
   console.log(`
-${BOLD9}decantr theme${RESET16} \u2014 Manage custom themes
+${BOLD10}decantr theme${RESET17} \u2014 Manage custom themes
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr theme create <name>
   decantr theme create <name> --guided
   decantr theme list
@@ -12088,25 +12373,27 @@ ${BOLD9}Usage:${RESET16}
 }
 function cmdSetupHelp() {
   console.log(`
-${BOLD9}decantr setup${RESET16} \u2014 Detect the project state and recommend the right Decantr path
+${BOLD10}decantr setup${RESET17} \u2014 Detect the project state and recommend the right Decantr path
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr setup [--project <path>]
 
-${BOLD9}Examples:${RESET16}
+${formatWhichCommandFirst()}
+
+${BOLD10}Examples:${RESET17}
   decantr setup
   decantr setup --project apps/web
 `);
 }
 function cmdAdoptHelp() {
   console.log(`
-${BOLD9}decantr adopt${RESET16} \u2014 Brownfield one-liner: analyze, attach, hydrate packs, verify, and show the operating loop
+${BOLD10}decantr adopt${RESET17} \u2014 Brownfield one-liner: analyze, attach, hydrate packs, verify, and show the operating loop
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr adopt [--project <path>] [--yes] [--dry-run] [--no-packs]
   decantr adopt [--project <path>] --base-url <url> [--evidence] [--ci] [--yes] [--no-packs]
 
-${BOLD9}Options:${RESET16}
+${BOLD10}Options:${RESET17}
   --project           App path inside a workspace/monorepo
   --yes, -y           Run without confirmation
   --dry-run           Show the workflow without writing files
@@ -12121,7 +12408,7 @@ ${BOLD9}Options:${RESET16}
   --merge-proposal    Merge the observed proposal into an existing essence
   --replace-essence   Replace an existing essence with backup
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr adopt --yes
   decantr adopt --project apps/web --yes
   decantr adopt --project apps/web --base-url http://localhost:3000 --evidence --yes
@@ -12131,16 +12418,16 @@ ${BOLD9}Examples:${RESET16}
 }
 function cmdVerifyHelp() {
   console.log(`
-${BOLD9}decantr verify${RESET16} \u2014 One reliability command for local work and LLM agent loops
+${BOLD10}decantr verify${RESET17} \u2014 One reliability command for local work and LLM agent loops
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr verify [--project <path>] [--brownfield] [--local-patterns]
   decantr verify --base-url <url> --evidence
   decantr verify --since-baseline
   decantr verify --workspace [--changed --since origin/main]
   decantr verify init-ci [legacy alias for decantr ci init]
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr verify
   decantr verify --brownfield --local-patterns
   decantr verify --brownfield --local-patterns --project apps/web
@@ -12152,32 +12439,54 @@ ${BOLD9}Examples:${RESET16}
 }
 function cmdTaskHelp() {
   console.log(`
-${BOLD9}decantr task${RESET16} \u2014 Prepare compact route/task context for an AI coding assistant
+${BOLD10}decantr task${RESET17} \u2014 Prepare compact route/task context for an AI coding assistant
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr task <route> ["task summary"] [--project <path>] [--since origin/main] [--json]
 
-${BOLD9}Behavior:${RESET16}
+${BOLD10}Behavior:${RESET17}
   Includes accepted local law and behavior obligations, plus the typed contract capsule path when
   .decantr/graph exists. Run decantr graph first when you want graph-backed agent context in
   CLI-only workflows.
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr task /feed "add saved recipe actions"
   decantr task /feed "add saved recipe actions" --since origin/main
   decantr task /profile --json
 `);
 }
+function cmdResolveHelp() {
+  console.log(`
+${BOLD10}decantr resolve${RESET17} \u2014 Explain source-vs-contract authority conflicts
+
+${BOLD10}Usage:${RESET17}
+  decantr resolve [--project <path>] [--json]
+  decantr resolve --defer <finding-id>
+  decantr resolve --mark-advisory <finding-id>
+
+${BOLD10}Behavior:${RESET17}
+  Read-only by default. Writes are limited to .decantr/drift-log.json and require
+  --defer or --mark-advisory. Contract, source, local-law, and style-bridge changes
+  still go through explicit commands such as codify, init --existing --merge-proposal,
+  graph, or contract_write over MCP.
+
+${BOLD10}Examples:${RESET17}
+  decantr resolve
+  decantr resolve --json
+  decantr resolve --project apps/web
+  decantr resolve --defer brownfield-route-drift
+`);
+}
 function cmdCodifyHelp() {
   console.log(`
-${BOLD9}decantr codify${RESET16} \u2014 Propose or accept project-owned Brownfield UI law, behavior obligations, and style bridges
+${BOLD10}decantr codify${RESET17} \u2014 Propose or accept project-owned Brownfield UI law, behavior obligations, and style bridges
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr codify [--from-audit] [--style-bridge] [--project <path>]
   decantr codify --map-pattern <registry-pattern-slug> [--project <path>]
   decantr codify --accept [--project <path>]
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr codify
   decantr codify --from-audit
   decantr codify --style-bridge
@@ -12189,14 +12498,14 @@ ${BOLD9}Examples:${RESET16}
 }
 function cmdContentHelp() {
   console.log(`
-${BOLD9}decantr content${RESET16} \u2014 Content-author namespace for official-vocabulary repositories
+${BOLD10}decantr content${RESET17} \u2014 Content-author namespace for official-vocabulary repositories
 
-${BOLD9}Usage:${RESET16}
+${BOLD10}Usage:${RESET17}
   decantr content check [content-health options]
   decantr content create <type> <name>
   decantr content publish <type> <name>
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr content check --ci --fail-on error
   decantr content create pattern my-card
   decantr content publish pattern my-card
@@ -12229,6 +12538,9 @@ function printCommandHelp(command, args) {
     case "task":
       cmdTaskHelp();
       return true;
+    case "resolve":
+      cmdResolveHelp();
+      return true;
     case "codify":
       cmdCodifyHelp();
       return true;
@@ -12270,11 +12582,11 @@ async function main() {
   }
   if (command === "--version" || command === "-v" || command === "version") {
     try {
-      const here = dirname6(fileURLToPath3(import.meta.url));
-      const candidates = [join30(here, "..", "package.json"), join30(here, "..", "..", "package.json")];
+      const here = dirname7(fileURLToPath3(import.meta.url));
+      const candidates = [join31(here, "..", "package.json"), join31(here, "..", "..", "package.json")];
       for (const candidate of candidates) {
-        if (existsSync28(candidate)) {
-          const pkg = JSON.parse(readFileSync21(candidate, "utf-8"));
+        if (existsSync29(candidate)) {
+          const pkg = JSON.parse(readFileSync22(candidate, "utf-8"));
           if (pkg.version) {
             console.log(pkg.version);
             return;
@@ -12313,6 +12625,16 @@ async function main() {
       await cmdVerifyWorkflow(args);
       break;
     }
+    case "resolve": {
+      const { flags } = parseLooseArgs(args);
+      if (!ensureAllowedFlags(flags, ["project", "json", "defer", "mark-advisory"], "resolve")) {
+        break;
+      }
+      const workspaceInfo = resolveWorkflowProject(flags, "resolve");
+      if (!workspaceInfo) break;
+      await cmdResolve(workspaceInfo.appRoot, args);
+      break;
+    }
     case "graph": {
       const { flags } = parseLooseArgs(args);
       if (!ensureAllowedFlags(
@@ -12473,10 +12795,10 @@ async function main() {
     case "heal": {
       if (command === "heal") {
         console.log(
-          `${YELLOW12}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET16}`
+          `${YELLOW13}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET17}`
         );
       }
-      const { cmdHeal } = await import("./heal-OKZ5QZN7.js");
+      const { cmdHeal } = await import("./heal-YXWB6LTI.js");
       const { flags } = parseLooseArgs(args);
       const workspaceInfo = resolveWorkflowProject(flags, "check");
       if (!workspaceInfo) break;
@@ -12501,7 +12823,7 @@ async function main() {
         const { flags } = parseLooseArgs(args);
         const workspaceInfo = resolveWorkflowProject(flags, "health");
         if (!workspaceInfo) break;
-        const { cmdHealth, parseHealthArgs } = await import("./health-G7HQCDXX.js");
+        const { cmdHealth, parseHealthArgs } = await import("./health-RKUKPG72.js");
         await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(stripProjectArgs(args)));
       } catch (e) {
         console.error(error2(e.message));
@@ -12529,7 +12851,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-T73T4Q2V.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-C2F72QL6.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error2(e.message));
@@ -12543,7 +12865,7 @@ async function main() {
           cmdWorkspaceHelp();
           break;
         }
-        const { cmdWorkspace } = await import("./workspace-3AJEXXUL.js");
+        const { cmdWorkspace } = await import("./workspace-RJCFPVBL.js");
         await cmdWorkspace(process.cwd(), args);
       } catch (e) {
         console.error(error2(e.message));
@@ -12852,7 +13174,7 @@ async function main() {
         let id = args[3] && !args[3].startsWith("--") ? args[3] : void 0;
         if (!packType || !["manifest", "scaffold", "review", "section", "page", "mutation"].includes(packType)) {
           console.error(
-            `${RED12}Usage: decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context]${RESET16}`
+            `${RED13}Usage: decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context]${RESET17}`
           );
           process.exitCode = 1;
           break;
@@ -12862,7 +13184,7 @@ async function main() {
           break;
         }
         if (packType === "page" && route && !id) {
-          const resolvedPath = essencePath ? resolveUserPath(essencePath) : join30(process.cwd(), "decantr.essence.json");
+          const resolvedPath = essencePath ? resolveUserPath(essencePath) : join31(process.cwd(), "decantr.essence.json");
           id = resolvePagePackIdForRoute(resolvedPath, route);
         }
         await printHostedSelectedExecutionPack(
@@ -12884,7 +13206,7 @@ async function main() {
         const sourcePath = args[2] && !args[2].startsWith("--") ? args[2] : void 0;
         if (!sourcePath) {
           console.error(
-            `${RED12}Usage: decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>]${RESET16}`
+            `${RED13}Usage: decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>]${RESET17}`
           );
           process.exitCode = 1;
           break;
@@ -12909,7 +13231,7 @@ async function main() {
         await printHostedProjectAudit(namespace, jsonOutput, essencePath, distPath, sourcesPath);
       } else {
         console.error(
-          `${RED12}Usage: decantr registry mirror [--type <type>] | decantr registry summary [--namespace <namespace>] [--json] | decantr registry compile-packs [path] [--namespace <namespace>] [--json] [--write-context] | decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context] | decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>] | decantr registry audit-project [--namespace <namespace>] [--json] [--essence <path>] [--dist <path>] [--sources <dir>]${RESET16}`
+          `${RED13}Usage: decantr registry mirror [--type <type>] | decantr registry summary [--namespace <namespace>] [--json] | decantr registry compile-packs [path] [--namespace <namespace>] [--json] [--write-context] | decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context] | decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>] | decantr registry audit-project [--namespace <namespace>] [--json] [--essence <path>] [--dist <path>] [--sources <dir>]${RESET17}`
         );
         process.exitCode = 1;
       }
@@ -13081,7 +13403,7 @@ async function main() {
         console.error("");
         console.error("  Example:");
         console.error(
-          `    ${CYAN9}decantr magic "AI agent dashboard \u2014 dark, neon, confident"${RESET16}`
+          `    ${CYAN9}decantr magic "AI agent dashboard \u2014 dark, neon, confident"${RESET17}`
         );
         process.exitCode = 1;
         break;