@decantr/cli 3.4.2 → 3.5.0

package/dist/{chunk-32WTNJQU.js → chunk-LTNGAAV4.js}

@@ -22,7 +22,7 @@ import {
   listWorkspaceCandidates,
   listWorkspaceProjects,
   shouldFailWorkspaceHealth
-} from "./chunk-BDA6TWV3.js";
+} from "./chunk-RJ6PT7WP.js";
 import {
   acceptBrownfieldLocalLaw,
   acceptStyleBridge,
@@ -52,7 +52,7 @@ import {
   writeBrownfieldCodifyProposal,
   writeHostedPatternMappingProposal,
   writeStyleBridgeProposal
-} from "./chunk-PQKTJGYL.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";
 
@@ -3392,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 {
@@ -3691,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"}`,
     "",
@@ -3710,6 +3715,7 @@ function formatWorkspaceCiMarkdown(report) {
     "- Mode: **workspace**",
     `- Status: **${report.status}**`,
     `- Fail on: \`${report.failOn}\``,
+    `- Loop: **${report.loop.state}**`,
     "",
     formatWorkspaceHealthMarkdown(report.workspace)
   ];
@@ -3866,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)}
@@ -3904,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
@@ -6675,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}` };
@@ -6756,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" };
   }
@@ -6775,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}` };
@@ -6784,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";
@@ -6813,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
@@ -6835,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
     );
   }
 }
@@ -6908,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)) {
@@ -6968,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) {
@@ -7012,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;
@@ -7068,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;
@@ -7089,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);
@@ -7104,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));
@@ -7161,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}`);
@@ -7174,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) {
@@ -7255,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(
@@ -7380,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");
@@ -7412,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",
@@ -7473,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,
@@ -7494,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,
@@ -7519,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}`
@@ -7537,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}`]
@@ -7545,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,
@@ -7561,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
@@ -7576,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) {
@@ -8102,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();
@@ -8115,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 {
@@ -8141,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 = {};
@@ -8157,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);
@@ -8349,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;
@@ -8358,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.");
   }
@@ -8390,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,
@@ -8408,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) {
@@ -8443,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) {
@@ -8477,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);
@@ -8493,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 {
@@ -8503,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,
@@ -8523,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 {
@@ -8540,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,
@@ -8574,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(
@@ -8596,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"}`
@@ -8625,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(
@@ -8638,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.`
     );
   }
 }
@@ -8660,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) {
@@ -8718,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 {
@@ -8818,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"));
@@ -8854,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)}` : ""}`);
@@ -8862,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."));
@@ -8907,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) {
@@ -8924,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;
@@ -8942,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;
@@ -8970,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");
@@ -8994,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,
@@ -9071,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 {
     }
@@ -9091,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: {
@@ -9144,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);
@@ -9160,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) {
@@ -9175,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(
@@ -9195,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;
@@ -9212,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
   });
@@ -9309,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."));
@@ -9393,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
@@ -9413,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")
       );
@@ -9462,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) {
@@ -9644,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) {
@@ -9659,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}`
       );
     }
   }
@@ -9676,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}`
       );
     }
   }
@@ -9725,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.`)
@@ -9736,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) {
@@ -9776,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) {
@@ -9819,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);
@@ -9831,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;
@@ -9855,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`
@@ -9867,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}`);
     }
   }
 }
@@ -9930,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}`);
     }
   }
 }
@@ -9946,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"}`);
@@ -9978,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) {
@@ -10035,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;
   }
 }
@@ -10043,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
@@ -10053,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
@@ -10102,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;
         }
@@ -10156,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;
       }
@@ -10241,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;
@@ -10249,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, "/");
   }
@@ -10265,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}`;
@@ -10319,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:");
@@ -10339,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) {
@@ -10354,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`
     );
@@ -10388,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`
   );
@@ -10399,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`)}`
   );
@@ -10407,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;
@@ -10457,7 +10613,7 @@ function studioCommandForProject(projectArg) {
 }
 function formatWhichCommandFirst(projectArg) {
   return [
-    `${BOLD9}Which command first?${RESET16}`,
+    `${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`,
@@ -10467,19 +10623,19 @@ function formatWhichCommandFirst(projectArg) {
 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");
 }
@@ -10561,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) {
@@ -10603,7 +10759,7 @@ 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}`
   );
@@ -10614,7 +10770,7 @@ function printScanReport(report, projectArg) {
     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}` : ""}`
   );
@@ -10624,7 +10780,7 @@ function printScanReport(report, projectArg) {
   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)}`);
@@ -10640,7 +10796,7 @@ function printScanReport(report, projectArg) {
   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"}`
     );
@@ -10649,7 +10805,7 @@ function printScanReport(report, projectArg) {
     }
     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}`);
     }
@@ -10658,14 +10814,14 @@ function printScanReport(report, projectArg) {
     }
     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)}`);
   }
@@ -10724,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`
     );
@@ -10750,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`
     );
@@ -10758,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")}`);
 }
@@ -10814,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",
@@ -10863,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,
@@ -10875,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.`
@@ -10888,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-U7O6PCLZ.js");
+    const { cmdHealth } = await import("./health-RKUKPG72.js");
     await cmdHealth(projectRoot, {
       browser: runBrowser,
       browserBaseUrl: baseUrl,
@@ -10904,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`
   );
@@ -10962,7 +11118,7 @@ async function cmdVerifyWorkflow(args) {
     return;
   }
   if (workspaceMode) {
-    const { cmdWorkspace } = await import("./workspace-NE232D4K.js");
+    const { cmdWorkspace } = await import("./workspace-RJCFPVBL.js");
     await cmdWorkspace(process.cwd(), ["workspace", "health", ...withoutWorkflowOnlyFlags(args)]);
     return;
   }
@@ -10995,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;
@@ -11005,7 +11161,7 @@ async function cmdVerifyWorkflow(args) {
       process.exitCode = void 0;
     }
   }
-  const { cmdHealth, parseHealthArgs } = await import("./health-U7O6PCLZ.js");
+  const { cmdHealth, parseHealthArgs } = await import("./health-RKUKPG72.js");
   await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(healthArgs));
   if (localPatterns) {
     const validation = validateLocalLaw(workspaceInfo.appRoot);
@@ -11013,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;
@@ -11024,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}`
@@ -11050,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) {
@@ -11061,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)) {
@@ -11074,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;
   }
@@ -11228,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(
@@ -11252,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 });
@@ -11307,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,
@@ -11320,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"),
@@ -11374,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")) {
@@ -11387,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) {
@@ -11446,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})`
@@ -11479,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(", ");
@@ -11496,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)`
     );
@@ -11520,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}`);
     }
@@ -11532,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."
   );
@@ -11560,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."
@@ -11594,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);
@@ -11725,15 +11962,16 @@ 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]
@@ -11742,7 +11980,7 @@ ${BOLD9}Usage:${RESET16}
 
 ${formatWhichCommandFirst()}
 
-${BOLD9}Advanced primitives:${RESET16}
+${BOLD10}Advanced primitives:${RESET17}
   decantr init [options]
   decantr analyze
   decantr magic <prompt> [--dry-run]
@@ -11753,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]
@@ -11787,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
@@ -11809,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
@@ -11823,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
@@ -11835,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
@@ -11855,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
@@ -11864,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
@@ -11919,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
@@ -11955,23 +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.
 
 ${formatWhichCommandFirst()}
 
-${BOLD9}Examples:${RESET16}
+${BOLD10}Examples:${RESET17}
   decantr scan
   decantr scan --project apps/web
   decantr scan --json
@@ -11982,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
@@ -11997,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
@@ -12013,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
@@ -12027,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
@@ -12044,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
@@ -12062,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
@@ -12071,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
@@ -12098,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]
@@ -12111,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
@@ -12124,27 +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>]
 
 ${formatWhichCommandFirst()}
 
-${BOLD9}Examples:${RESET16}
+${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
@@ -12159,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
@@ -12169,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
@@ -12190,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
@@ -12227,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
@@ -12267,6 +12538,9 @@ function printCommandHelp(command, args) {
     case "task":
       cmdTaskHelp();
       return true;
+    case "resolve":
+      cmdResolveHelp();
+      return true;
     case "codify":
       cmdCodifyHelp();
       return true;
@@ -12308,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;
@@ -12351,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(
@@ -12511,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;
@@ -12539,7 +12823,7 @@ async function main() {
         const { flags } = parseLooseArgs(args);
         const workspaceInfo = resolveWorkflowProject(flags, "health");
         if (!workspaceInfo) break;
-        const { cmdHealth, parseHealthArgs } = await import("./health-U7O6PCLZ.js");
+        const { cmdHealth, parseHealthArgs } = await import("./health-RKUKPG72.js");
         await cmdHealth(workspaceInfo.appRoot, parseHealthArgs(stripProjectArgs(args)));
       } catch (e) {
         console.error(error2(e.message));
@@ -12567,7 +12851,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-X565XJKV.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-C2F72QL6.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error2(e.message));
@@ -12581,7 +12865,7 @@ async function main() {
           cmdWorkspaceHelp();
           break;
         }
-        const { cmdWorkspace } = await import("./workspace-NE232D4K.js");
+        const { cmdWorkspace } = await import("./workspace-RJCFPVBL.js");
         await cmdWorkspace(process.cwd(), args);
       } catch (e) {
         console.error(error2(e.message));
@@ -12890,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;
@@ -12900,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(
@@ -12922,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;
@@ -12947,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;
       }
@@ -13119,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;