@decantr/cli 3.6.2 → 3.7.0

package/dist/{chunk-4HFBFQNN.js → chunk-O7N4CCWS.js}

@@ -14,7 +14,7 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-SIDKK73N.js";
+} from "./chunk-NDH3BDXY.js";
 import {
   createWorkspaceHealthReport,
   formatWorkspaceHealthMarkdown,
@@ -72,8 +72,8 @@ import {
 } from "./chunk-24JR4ZNG.js";
 
 // src/index.ts
-import { existsSync as existsSync30, mkdirSync as mkdirSync17, readdirSync as readdirSync8, readFileSync as readFileSync23, writeFileSync as writeFileSync20 } from "fs";
-import { basename as basename2, dirname as dirname8, isAbsolute as isAbsolute4, join as join32, relative as relative7, resolve as resolve5 } from "path";
+import { existsSync as existsSync29, mkdirSync as mkdirSync17, readdirSync as readdirSync8, readFileSync as readFileSync22, writeFileSync as writeFileSync20 } from "fs";
+import { basename as basename2, dirname as dirname7, isAbsolute as isAbsolute4, join as join32, relative as relative7, resolve as resolve5 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import {
   buildGraphImpactContext,
@@ -2027,7 +2027,7 @@ async function cmdAddSection(archetypeId, args, projectRoot = process.cwd()) {
   console.log(`${GREEN}Derived files refreshed.${RESET}`);
 }
 async function cmdAddPage(path, args, projectRoot = process.cwd()) {
-  if (!path || !path.includes("/")) {
+  if (!path?.includes("/")) {
     console.error(`${RED}Usage: decantr add page <section>/<page>${RESET}`);
     console.error(`${DIM}Example: decantr add page settings/notifications${RESET}`);
     process.exitCode = 1;
@@ -2054,7 +2054,8 @@ async function cmdAddPage(path, args, projectRoot = process.cwd()) {
     return;
   }
   const route = normalizeRoute(readFlagValue(args, "route") ?? pageId);
-  const routes = essence.blueprint.routes ??= {};
+  essence.blueprint.routes ??= {};
+  const routes = essence.blueprint.routes;
   const existingRoute = routes[route];
   if (existingRoute) {
     console.error(
@@ -2927,157 +2928,21 @@ function writeBrownfieldIntelligenceArtifacts(input) {
 }
 
 // src/detect.ts
-import { existsSync as existsSync10, readFileSync as readFileSync9 } from "fs";
-import { dirname as dirname2, join as join12 } from "path";
-var RULE_FILES = [
-  "CLAUDE.md",
-  ".claude/rules",
-  ".cursorrules",
-  ".cursor/rules",
-  "AGENTS.md",
-  "GEMINI.md",
-  "copilot-instructions.md",
-  ".github/copilot-instructions.md",
-  ".windsurfrules"
-];
-var STATIC_HTML_ENTRY_FILES = [
-  "index.html",
-  "docs/index.html",
-  "src/index.html",
-  "public/index.html",
-  "dist/index.html"
-];
-var STATIC_HTML_ROUTE_DIRS = ["demos", "examples"];
-function hasAnyFile(projectRoot, relPaths) {
-  return relPaths.some((relPath) => existsSync10(join12(projectRoot, relPath)));
-}
-function hasStaticHtmlSurface(projectRoot) {
-  if (hasAnyFile(projectRoot, STATIC_HTML_ENTRY_FILES)) return true;
-  return STATIC_HTML_ROUTE_DIRS.some((dir) => existsSync10(join12(projectRoot, dir, "index.html")));
-}
-function readPackageJson(dir) {
-  const path = join12(dir, "package.json");
-  if (!existsSync10(path)) return null;
-  try {
-    return JSON.parse(readFileSync9(path, "utf-8"));
-  } catch {
-    return null;
-  }
-}
-function packageManagerFromName(name) {
-  if (name === "pnpm" || name === "yarn" || name === "bun" || name === "npm") return name;
-  return "unknown";
-}
-function detectPackageManager(projectRoot) {
-  let current = projectRoot;
-  while (true) {
-    const pkg = readPackageJson(current);
-    const declared = packageManagerFromName(pkg?.packageManager?.split("@")[0]);
-    if (declared !== "unknown") return declared;
-    if (existsSync10(join12(current, "pnpm-lock.yaml"))) return "pnpm";
-    if (existsSync10(join12(current, "yarn.lock"))) return "yarn";
-    if (existsSync10(join12(current, "bun.lockb"))) return "bun";
-    if (existsSync10(join12(current, "package-lock.json"))) return "npm";
-    const parent = dirname2(current);
-    if (parent === current) return "unknown";
-    current = parent;
-  }
-}
+import { existsSync as existsSync10 } from "fs";
+import { join as join12 } from "path";
+import { discoverProject } from "@decantr/verifier";
 function detectProject(projectRoot = process.cwd()) {
-  const result = {
-    framework: "unknown",
-    packageManager: "unknown",
-    hasTypeScript: false,
-    hasTailwind: false,
-    existingRuleFiles: [],
-    existingEssence: false,
+  const discovery = discoverProject(projectRoot);
+  return {
+    framework: discovery.project.framework,
+    version: discovery.project.frameworkVersion ?? void 0,
+    packageManager: discovery.project.packageManager,
+    hasTypeScript: discovery.project.hasTypeScript,
+    hasTailwind: discovery.project.hasTailwind,
+    existingRuleFiles: discovery.assistant.ruleFiles,
+    existingEssence: existsSync10(join12(projectRoot, "decantr.essence.json")),
     projectRoot
   };
-  result.existingEssence = existsSync10(join12(projectRoot, "decantr.essence.json"));
-  for (const ruleFile of RULE_FILES) {
-    if (existsSync10(join12(projectRoot, ruleFile))) {
-      result.existingRuleFiles.push(ruleFile);
-    }
-  }
-  result.packageManager = detectPackageManager(projectRoot);
-  result.hasTypeScript = existsSync10(join12(projectRoot, "tsconfig.json"));
-  result.hasTailwind = existsSync10(join12(projectRoot, "tailwind.config.js")) || existsSync10(join12(projectRoot, "tailwind.config.ts")) || existsSync10(join12(projectRoot, "tailwind.config.mjs")) || existsSync10(join12(projectRoot, "tailwind.config.cjs"));
-  if (existsSync10(join12(projectRoot, "next.config.js")) || existsSync10(join12(projectRoot, "next.config.ts")) || existsSync10(join12(projectRoot, "next.config.mjs"))) {
-    result.framework = "nextjs";
-    result.version = getPackageVersion(projectRoot, "next");
-    return result;
-  }
-  if (existsSync10(join12(projectRoot, "nuxt.config.js")) || existsSync10(join12(projectRoot, "nuxt.config.ts"))) {
-    result.framework = "nuxt";
-    result.version = getPackageVersion(projectRoot, "nuxt");
-    return result;
-  }
-  if (existsSync10(join12(projectRoot, "astro.config.mjs")) || existsSync10(join12(projectRoot, "astro.config.ts"))) {
-    result.framework = "astro";
-    result.version = getPackageVersion(projectRoot, "astro");
-    return result;
-  }
-  if (existsSync10(join12(projectRoot, "svelte.config.js")) || existsSync10(join12(projectRoot, "svelte.config.ts"))) {
-    result.framework = "svelte";
-    result.version = getPackageVersion(projectRoot, "svelte");
-    return result;
-  }
-  if (existsSync10(join12(projectRoot, "angular.json"))) {
-    result.framework = "angular";
-    result.version = getPackageVersion(projectRoot, "@angular/core");
-    return result;
-  }
-  const packageJsonPath = join12(projectRoot, "package.json");
-  if (existsSync10(packageJsonPath)) {
-    try {
-      const packageJson = JSON.parse(readFileSync9(packageJsonPath, "utf-8"));
-      const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
-      if (deps.next) {
-        result.framework = "nextjs";
-        result.version = deps.next.replace(/^\^|~/, "");
-      } else if (deps.nuxt) {
-        result.framework = "nuxt";
-        result.version = deps.nuxt.replace(/^\^|~/, "");
-      } else if (deps.astro) {
-        result.framework = "astro";
-        result.version = deps.astro.replace(/^\^|~/, "");
-      } else if (deps.svelte) {
-        result.framework = "svelte";
-        result.version = deps.svelte.replace(/^\^|~/, "");
-      } else if (deps["@angular/core"]) {
-        result.framework = "angular";
-        result.version = deps["@angular/core"].replace(/^\^|~/, "");
-      } else if (deps["solid-js"]) {
-        result.framework = "solid";
-        result.version = deps["solid-js"].replace(/^\^|~/, "");
-      } else if (deps.vue) {
-        result.framework = "vue";
-        result.version = deps.vue.replace(/^\^|~/, "");
-      } else if (deps.react) {
-        result.framework = "react";
-        result.version = deps.react.replace(/^\^|~/, "");
-      }
-    } catch {
-    }
-  }
-  if (result.framework === "unknown") {
-    if (hasStaticHtmlSurface(projectRoot)) {
-      result.framework = "html";
-    }
-  }
-  return result;
-}
-function getPackageVersion(projectRoot, packageName) {
-  const packageJsonPath = join12(projectRoot, "package.json");
-  if (!existsSync10(packageJsonPath)) return void 0;
-  try {
-    const packageJson = JSON.parse(readFileSync9(packageJsonPath, "utf-8"));
-    const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
-    const version = deps[packageName];
-    return version?.replace(/^\^|~/, "");
-  } catch {
-    return void 0;
-  }
 }
 function formatDetection(detected) {
   const lines = [];
@@ -3104,7 +2969,7 @@ function formatDetection(detected) {
 }
 
 // src/workflow-model.ts
-import { existsSync as existsSync11, readFileSync as readFileSync10 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync9 } from "fs";
 import { join as join13 } from "path";
 function inferSuggestedShell(layout) {
   if (layout.hasSidebar) return "sidebar-main";
@@ -3197,7 +3062,7 @@ function readBrownfieldInitSeed(projectRoot) {
     return null;
   }
   try {
-    const parsed = JSON.parse(readFileSync10(seedPath, "utf-8"));
+    const parsed = JSON.parse(readFileSync9(seedPath, "utf-8"));
     if (parsed.workflow !== "brownfield-adoption") {
       return null;
     }
@@ -3406,8 +3271,8 @@ ${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 { existsSync as existsSync13, mkdirSync as mkdirSync8, readFileSync as readFileSync10, writeFileSync as writeFileSync9 } from "fs";
+import { dirname as dirname2, 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";
@@ -3418,7 +3283,7 @@ var CI_SCHEMA = DECANTR_CI_REPORT_V2_SCHEMA_URL;
 function readJson(path) {
   if (!existsSync13(path)) return null;
   try {
-    return JSON.parse(readFileSync11(path, "utf-8"));
+    return JSON.parse(readFileSync10(path, "utf-8"));
   } catch {
     return null;
   }
@@ -3461,7 +3326,7 @@ function parseProvider(value) {
   if (value === "github" || value === "generic") return value;
   throw new Error("Invalid --provider value. Use github or generic.");
 }
-function detectPackageManager2(root) {
+function detectPackageManager(root) {
   const pkg = readJson(join15(root, "package.json"));
   const declared = pkg?.packageManager?.split("@")[0];
   if (declared === "pnpm" || declared === "npm" || declared === "yarn" || declared === "bun") {
@@ -3530,7 +3395,7 @@ function projectSlug(projectPath) {
 }
 function writeOutput(root, path, content) {
   const absolute = resolve(root, path);
-  mkdirSync8(dirname3(absolute), { recursive: true });
+  mkdirSync8(dirname2(absolute), { recursive: true });
   writeFileSync9(absolute, content, "utf-8");
 }
 function summarizeLocalLaw(projectRoot) {
@@ -3821,7 +3686,7 @@ function writeCiInit(root, options) {
   }
   const outputRoot = workspaceInfo.workspaceRoot;
   const projectPath = options.project ?? (options.workspace || workspaceInfo.appRoot === workspaceInfo.workspaceRoot ? void 0 : relative3(workspaceInfo.workspaceRoot, workspaceInfo.appRoot).replace(/\\/g, "/"));
-  const packageManager = detectPackageManager2(outputRoot);
+  const packageManager = detectPackageManager(outputRoot);
   const command = decantrCommand(packageManager);
   const failOn = options.failOn ?? "error";
   const provider = options.provider ?? "github";
@@ -3981,8 +3846,8 @@ async function cmdCi(args = ["ci"], root = process.cwd()) {
 }
 
 // src/commands/connect.ts
-import { existsSync as existsSync14, mkdirSync as mkdirSync9, readFileSync as readFileSync12, writeFileSync as writeFileSync10 } from "fs";
-import { dirname as dirname4, isAbsolute, join as join16, relative as relative4 } from "path";
+import { existsSync as existsSync14, mkdirSync as mkdirSync9, readFileSync as readFileSync11, writeFileSync as writeFileSync10 } from "fs";
+import { dirname as dirname3, isAbsolute, join as join16, relative as relative4 } from "path";
 var GREEN4 = "\x1B[32m";
 var CYAN2 = "\x1B[36m";
 var DIM4 = "\x1B[2m";
@@ -4018,7 +3883,7 @@ function projectPathForConnection(input) {
 }
 function readCursorMcpConfig(path) {
   if (!existsSync14(path)) return {};
-  const parsed = JSON.parse(readFileSync12(path, "utf-8"));
+  const parsed = JSON.parse(readFileSync11(path, "utf-8"));
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new Error(`${path} must contain a JSON object.`);
   }
@@ -4067,8 +3932,8 @@ Preserve the detected framework (${input.detected.framework}), package manager (
 }
 function writeTextIfChanged(path, content, preview) {
   if (preview) return { path, action: "preview" };
-  mkdirSync9(dirname4(path), { recursive: true });
-  if (existsSync14(path) && readFileSync12(path, "utf-8") === content) {
+  mkdirSync9(dirname3(path), { recursive: true });
+  if (existsSync14(path) && readFileSync11(path, "utf-8") === content) {
     return { path, action: "unchanged" };
   }
   writeFileSync10(path, content, "utf-8");
@@ -4378,8 +4243,8 @@ function cmdCreate(type, name, projectRoot = process.cwd()) {
 }
 
 // src/commands/doctor.ts
-import { existsSync as existsSync16, readdirSync as readdirSync5, readFileSync as readFileSync13, statSync as statSync5 } from "fs";
-import { dirname as dirname5, join as join18, relative as relative5 } from "path";
+import { existsSync as existsSync16, readdirSync as readdirSync5, readFileSync as readFileSync12, statSync as statSync5 } from "fs";
+import { dirname as dirname4, join as join18, relative as relative5 } from "path";
 import { fileURLToPath } from "url";
 import { isV4 as isV43 } from "@decantr/essence-spec";
 import { collectMissingPackManifestFiles } from "@decantr/verifier";
@@ -4393,7 +4258,7 @@ var RESET5 = "\x1B[0m";
 function readJson2(path) {
   if (!existsSync16(path)) return null;
   try {
-    return JSON.parse(readFileSync13(path, "utf-8"));
+    return JSON.parse(readFileSync12(path, "utf-8"));
   } catch {
     return null;
   }
@@ -4403,16 +4268,16 @@ function isContractOnlyProject(projectRoot) {
   return projectJson?.initialized?.adoptionMode === "contract-only" || projectJson?.initialized?.adoptionMode === "style-bridge";
 }
 function readCliPackageVersion() {
-  const packagePath = join18(dirname5(fileURLToPath(import.meta.url)), "..", "..", "package.json");
-  const srcPackagePath = join18(dirname5(fileURLToPath(import.meta.url)), "..", "package.json");
+  const packagePath = join18(dirname4(fileURLToPath(import.meta.url)), "..", "..", "package.json");
+  const srcPackagePath = join18(dirname4(fileURLToPath(import.meta.url)), "..", "package.json");
   const pkg = readJson2(packagePath) ?? readJson2(srcPackagePath);
   return pkg?.version ?? "unknown";
 }
-function readPackageJson2(dir) {
+function readPackageJson(dir) {
   return readJson2(join18(dir, "package.json"));
 }
-function detectPackageManager3(root) {
-  const pkg = readPackageJson2(root);
+function detectPackageManager2(root) {
+  const pkg = readPackageJson(root);
   const declared = pkg?.packageManager?.split("@")[0];
   if (declared === "pnpm" || declared === "npm" || declared === "yarn" || declared === "bun") {
     return declared;
@@ -4424,11 +4289,11 @@ function detectPackageManager3(root) {
   return "unknown";
 }
 function localCliDependency(root) {
-  const pkg = readPackageJson2(root);
+  const pkg = readPackageJson(root);
   return pkg?.devDependencies?.["@decantr/cli"] ?? pkg?.dependencies?.["@decantr/cli"] ?? null;
 }
 function hasWorkspaceMarker2(root) {
-  const pkg = readPackageJson2(root);
+  const pkg = readPackageJson(root);
   return Boolean(
     existsSync16(join18(root, "pnpm-workspace.yaml")) || existsSync16(join18(root, "turbo.json")) || existsSync16(join18(root, "nx.json")) || pkg?.workspaces
   );
@@ -4451,7 +4316,7 @@ function rel(root, path) {
   const value = relative5(root, path).replace(/\\/g, "/");
   return value || ".";
 }
-function hasAnyFile2(dir, names) {
+function hasAnyFile(dir, names) {
   for (const name of names) {
     const path = join18(dir, name);
     if (existsSync16(path)) return name;
@@ -4459,7 +4324,7 @@ function hasAnyFile2(dir, names) {
   return null;
 }
 function packageHasDependency(dir, names) {
-  const pkg = readPackageJson2(dir);
+  const pkg = readPackageJson(dir);
   const deps = { ...pkg?.dependencies, ...pkg?.devDependencies };
   return names.some((name) => Boolean(deps[name]));
 }
@@ -4480,7 +4345,7 @@ function detectDesignAuthority(workspaceRoot, appRoot) {
   }
   for (const root of [appRoot, workspaceRoot]) {
     const label = root === appRoot ? "app" : "workspace";
-    const tailwind = hasAnyFile2(root, [
+    const tailwind = hasAnyFile(root, [
       "tailwind.config.js",
       "tailwind.config.ts",
       "tailwind.config.mjs",
@@ -4506,13 +4371,13 @@ function findCiFiles(root) {
     for (const entry of readdirSync5(workflows, { withFileTypes: true })) {
       if (!entry.isFile()) continue;
       const path = join18(workflows, entry.name);
-      const text = readFileSync13(path, "utf-8");
+      const text = readFileSync12(path, "utf-8");
       if (text.includes("decantr")) files.push(rel(root, path));
     }
   }
   for (const candidate of ["Jenkinsfile", ".gitlab-ci.yml", "azure-pipelines.yml", "BUILD"]) {
     const path = join18(root, candidate);
-    if (pathIsFile(path) && readFileSync13(path, "utf-8").includes("decantr")) {
+    if (pathIsFile(path) && readFileSync12(path, "utf-8").includes("decantr")) {
       files.push(candidate);
     }
   }
@@ -4690,7 +4555,7 @@ function buildDoctorReport(root, args) {
   const appRoot = workspaceMode ? workspaceRoot : workspaceInfo.appRoot;
   const projectMissing = Boolean(projectArg && !existsSync16(appRoot));
   const projectPath = appRoot === workspaceRoot ? null : rel(workspaceRoot, appRoot);
-  const packageManager = detectPackageManager3(workspaceRoot);
+  const packageManager = detectPackageManager2(workspaceRoot);
   const cliDependency = localCliDependency(workspaceRoot);
   const detected = detectProject(appRoot);
   const projectJson = readJson2(join18(appRoot, ".decantr", "project.json"));
@@ -5069,8 +4934,8 @@ async function cmdDoctor(args = ["doctor"], root = process.cwd()) {
 }
 
 // src/commands/export.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync11, readFileSync as readFileSync14, writeFileSync as writeFileSync12 } from "fs";
-import { dirname as dirname6, isAbsolute as isAbsolute2, join as join19 } from "path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync11, readFileSync as readFileSync13, writeFileSync as writeFileSync12 } from "fs";
+import { dirname as dirname5, isAbsolute as isAbsolute2, join as join19 } from "path";
 var GREEN6 = "\x1B[32m";
 var RED4 = "\x1B[31m";
 var DIM6 = "\x1B[2m";
@@ -5079,7 +4944,7 @@ function readAdoptionMode(projectRoot) {
   const projectJsonPath = join19(projectRoot, ".decantr", "project.json");
   if (!existsSync17(projectJsonPath)) return null;
   try {
-    const parsed = JSON.parse(readFileSync14(projectJsonPath, "utf-8"));
+    const parsed = JSON.parse(readFileSync13(projectJsonPath, "utf-8"));
     return typeof parsed.initialized?.adoptionMode === "string" ? parsed.initialized.adoptionMode : null;
   } catch {
     return null;
@@ -5120,9 +4985,10 @@ var TAILWIND_COLOR_MAP = {
 function parseTokensCSS(css) {
   const tokens = /* @__PURE__ */ new Map();
   const re = /(--d-[\w-]+)\s*:\s*([^;]+);/g;
-  let match;
-  while ((match = re.exec(css)) !== null) {
+  let match = re.exec(css);
+  while (match !== null) {
     tokens.set(match[1], match[2].trim());
+    match = re.exec(css);
   }
   return tokens;
 }
@@ -5262,7 +5128,7 @@ async function cmdExport(target, projectRoot, options = {}) {
     process.exitCode = 1;
     return;
   }
-  const tokensCSS = readFileSync14(tokensPath, "utf-8");
+  const tokensCSS = readFileSync13(tokensPath, "utf-8");
   const tokens = parseTokensCSS(tokensCSS);
   if (tokens.size === 0) {
     console.error(`${RED4}No --d-* tokens found in tokens.css.${RESET6}`);
@@ -5324,7 +5190,7 @@ async function cmdExport(target, projectRoot, options = {}) {
   }
 }
 function ensureDir(filePath) {
-  const dir = dirname6(filePath);
+  const dir = dirname5(filePath);
   if (!existsSync17(dir)) {
     mkdirSync11(dir, { recursive: true });
   }
@@ -5902,7 +5768,7 @@ ${GREEN7}${BOLD5}Quality summary:${RESET7}`);
 }
 
 // src/commands/migrate.ts
-import { copyFileSync, existsSync as existsSync19, readFileSync as readFileSync15, writeFileSync as writeFileSync13 } from "fs";
+import { copyFileSync, existsSync as existsSync19, readFileSync as readFileSync14, writeFileSync as writeFileSync13 } from "fs";
 import { join as join21 } from "path";
 import {
   isV4 as isV44,
@@ -5921,7 +5787,7 @@ function migrateEssenceFile(essencePath) {
   }
   let raw;
   try {
-    raw = readFileSync15(essencePath, "utf-8");
+    raw = readFileSync14(essencePath, "utf-8");
   } catch (e) {
     return { success: false, error: `Could not read ${essencePath}: ${e.message}` };
   }
@@ -6240,7 +6106,7 @@ async function cmdNewProject(projectName, options) {
       )
     );
   }
-  const packageManager = detectPackageManager4();
+  const packageManager = detectPackageManager3();
   if (shouldBootstrapRuntime) {
     console.log(heading("Installing dependencies..."));
     try {
@@ -6316,7 +6182,7 @@ ${YELLOW6}Decantr init encountered issues. Run \`decantr init\` manually inside
     });
   }
 }
-function detectPackageManager4() {
+function detectPackageManager3() {
   if (existsSync21(join23(process.cwd(), "pnpm-lock.yaml")) || existsSync21(join23(process.cwd(), "pnpm-workspace.yaml"))) {
     return "pnpm";
   }
@@ -6330,7 +6196,7 @@ function detectPackageManager4() {
 }
 
 // src/commands/publish.ts
-import { existsSync as existsSync22, readFileSync as readFileSync16 } from "fs";
+import { existsSync as existsSync22, readFileSync as readFileSync15 } from "fs";
 import { join as join24 } from "path";
 import {
   API_CONTENT_TYPE_TO_CONTENT_TYPE,
@@ -6356,7 +6222,7 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
   }
   let data;
   try {
-    data = JSON.parse(readFileSync16(customPath, "utf-8"));
+    data = JSON.parse(readFileSync15(customPath, "utf-8"));
   } catch {
     console.error(`Failed to parse ${customPath}`);
     process.exitCode = 1;
@@ -6395,7 +6261,7 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
 
 // src/commands/refresh.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync23, readdirSync as readdirSync6, readFileSync as readFileSync17, statSync as statSync6 } from "fs";
+import { existsSync as existsSync23, readdirSync as readdirSync6, readFileSync as readFileSync16, statSync as statSync6 } from "fs";
 import { isAbsolute as isAbsolute3, join as join25, relative as relative6 } from "path";
 import { isV4 as isV45 } from "@decantr/essence-spec";
 import { collectMissingPackManifestFiles as collectMissingPackManifestFiles2 } from "@decantr/verifier";
@@ -6404,7 +6270,7 @@ var RED7 = "\x1B[31m";
 var DIM10 = "\x1B[2m";
 var RESET10 = "\x1B[0m";
 function hashFile(path) {
-  return createHash("sha256").update(readFileSync17(path)).digest("hex");
+  return createHash("sha256").update(readFileSync16(path)).digest("hex");
 }
 function walkFiles(dir) {
   if (!existsSync23(dir)) return [];
@@ -6460,7 +6326,7 @@ function isContractOnlyProject2(projectRoot) {
   const projectJsonPath = join25(projectRoot, ".decantr", "project.json");
   if (!existsSync23(projectJsonPath)) return false;
   try {
-    const projectJson = JSON.parse(readFileSync17(projectJsonPath, "utf-8"));
+    const projectJson = JSON.parse(readFileSync16(projectJsonPath, "utf-8"));
     return projectJson.initialized?.adoptionMode === "contract-only";
   } catch {
     return false;
@@ -6574,7 +6440,7 @@ async function cmdRefresh(projectRoot = process.cwd(), options = {}) {
   }
   let essence;
   try {
-    const raw = readFileSync17(essencePath, "utf-8");
+    const raw = readFileSync16(essencePath, "utf-8");
     const parsed = JSON.parse(raw);
     if (!isV45(parsed)) {
       console.error(
@@ -6715,7 +6581,7 @@ Mirroring registry content to ${DIM11}.decantr/cache/${RESET11}
 }
 
 // src/commands/remove.ts
-import { existsSync as existsSync25, readFileSync as readFileSync18, rmSync as rmSync2, writeFileSync as writeFileSync15 } from "fs";
+import { existsSync as existsSync24, readFileSync as readFileSync17, rmSync as rmSync2, writeFileSync as writeFileSync15 } from "fs";
 import { join as join27 } from "path";
 import { isV4 as isV46 } from "@decantr/essence-spec";
 var GREEN12 = "\x1B[32m";
@@ -6725,14 +6591,14 @@ var DIM12 = "\x1B[2m";
 var RESET12 = "\x1B[0m";
 function readV4Essence2(projectRoot) {
   const essencePath = join27(projectRoot, "decantr.essence.json");
-  if (!existsSync25(essencePath)) {
+  if (!existsSync24(essencePath)) {
     console.error(`${RED9}No decantr.essence.json found. Run \`decantr init\` first.${RESET12}`);
     process.exitCode = 1;
     return null;
   }
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync18(essencePath, "utf-8"));
+    parsed = JSON.parse(readFileSync17(essencePath, "utf-8"));
   } catch (e) {
     console.error(`${RED9}Could not read essence: ${e.message}${RESET12}`);
     process.exitCode = 1;
@@ -6821,7 +6687,7 @@ async function cmdRemoveSection(sectionId, args, projectRoot = process.cwd()) {
   recomputeGlobalFeatures(essence);
   removeRoutes(essence, sectionId);
   const contextFile = join27(projectRoot, ".decantr", "context", `${sectionId}.md`);
-  if (existsSync25(contextFile)) {
+  if (existsSync24(contextFile)) {
     rmSync2(contextFile);
   }
   writeEssence2(essencePath, essence);
@@ -6833,7 +6699,7 @@ async function cmdRemoveSection(sectionId, args, projectRoot = process.cwd()) {
   console.log(`${GREEN12}Derived files refreshed.${RESET12}`);
 }
 async function cmdRemovePage(path, args, projectRoot = process.cwd()) {
-  if (!path || !path.includes("/")) {
+  if (!path?.includes("/")) {
     console.error(`${RED9}Usage: decantr remove page <section>/<page>${RESET12}`);
     console.error(`${DIM12}Example: decantr remove page settings/notifications${RESET12}`);
     process.exitCode = 1;
@@ -6920,8 +6786,8 @@ async function cmdRemoveFeature(feature, args, projectRoot = process.cwd()) {
 }
 
 // src/commands/resolve.ts
-import { existsSync as existsSync26, mkdirSync as mkdirSync15, readFileSync as readFileSync19, writeFileSync as writeFileSync16 } from "fs";
-import { dirname as dirname7, join as join28, resolve as resolve4 } from "path";
+import { existsSync as existsSync25, mkdirSync as mkdirSync15, readFileSync as readFileSync18, writeFileSync as writeFileSync16 } from "fs";
+import { dirname as dirname6, join as join28, resolve as resolve4 } from "path";
 var BOLD7 = "\x1B[1m";
 var DIM13 = "\x1B[2m";
 var GREEN13 = "\x1B[32m";
@@ -6933,9 +6799,9 @@ function driftLogPath(projectRoot) {
 }
 function readDriftLog(projectRoot) {
   const path = driftLogPath(projectRoot);
-  if (!existsSync26(path)) return { version: 1, entries: [] };
+  if (!existsSync25(path)) return { version: 1, entries: [] };
   try {
-    const parsed = JSON.parse(readFileSync19(path, "utf-8"));
+    const parsed = JSON.parse(readFileSync18(path, "utf-8"));
     return {
       version: 1,
       entries: Array.isArray(parsed.entries) ? parsed.entries : []
@@ -6946,7 +6812,7 @@ function readDriftLog(projectRoot) {
 }
 function writeDriftLog(projectRoot, log) {
   const path = driftLogPath(projectRoot);
-  mkdirSync15(dirname7(path), { recursive: true });
+  mkdirSync15(dirname6(path), { recursive: true });
   writeFileSync16(path, `${JSON.stringify(log, null, 2)}
 `, "utf-8");
 }
@@ -7066,7 +6932,7 @@ async function cmdResolve(projectRoot = process.cwd(), args = ["resolve"]) {
 }
 
 // src/commands/sync-drift.ts
-import { existsSync as existsSync27, readFileSync as readFileSync20, writeFileSync as writeFileSync17 } from "fs";
+import { existsSync as existsSync26, readFileSync as readFileSync19, writeFileSync as writeFileSync17 } from "fs";
 import { join as join29 } from "path";
 var GREEN14 = "\x1B[32m";
 var RED11 = "\x1B[31m";
@@ -7077,7 +6943,7 @@ var BOLD8 = "\x1B[1m";
 var CYAN7 = "\x1B[36m";
 async function cmdSyncDrift(projectRoot = process.cwd()) {
   const driftLogPath2 = join29(projectRoot, ".decantr", "drift-log.json");
-  if (!existsSync27(driftLogPath2)) {
+  if (!existsSync26(driftLogPath2)) {
     console.log(`${GREEN14}No drift log found \u2014 no drift recorded.${RESET14}`);
     console.log(
       `${DIM14}Drift is logged when guard violations are detected during development.${RESET14}`
@@ -7086,7 +6952,7 @@ async function cmdSyncDrift(projectRoot = process.cwd()) {
   }
   let entries;
   try {
-    entries = JSON.parse(readFileSync20(driftLogPath2, "utf-8"));
+    entries = JSON.parse(readFileSync19(driftLogPath2, "utf-8"));
   } catch {
     console.error(`${RED11}Could not parse drift-log.json${RESET14}`);
     process.exitCode = 1;
@@ -7133,7 +6999,7 @@ ${BOLD8}Unresolved Drift Entries (${unresolved.length})${RESET14}
 }
 function resolveDriftEntries(projectRoot, options) {
   const driftLogPath2 = join29(projectRoot, ".decantr", "drift-log.json");
-  if (!existsSync27(driftLogPath2)) {
+  if (!existsSync26(driftLogPath2)) {
     return { success: true };
   }
   if (options.clear) {
@@ -7146,7 +7012,7 @@ function resolveDriftEntries(projectRoot, options) {
   }
   let entries;
   try {
-    entries = JSON.parse(readFileSync20(driftLogPath2, "utf-8"));
+    entries = JSON.parse(readFileSync19(driftLogPath2, "utf-8"));
   } catch {
     return { success: false, error: "Could not parse drift-log.json" };
   }
@@ -7402,7 +7268,7 @@ function trimTrailingSlashes(value) {
 }
 
 // src/commands/theme-switch.ts
-import { existsSync as existsSync28, readFileSync as readFileSync21, writeFileSync as writeFileSync18 } from "fs";
+import { existsSync as existsSync27, readFileSync as readFileSync20, writeFileSync as writeFileSync18 } from "fs";
 import { join as join30 } from "path";
 import { isV4 as isV47 } from "@decantr/essence-spec";
 var GREEN16 = "\x1B[32m";
@@ -7421,14 +7287,14 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
     return;
   }
   const essencePath = join30(projectRoot, "decantr.essence.json");
-  if (!existsSync28(essencePath)) {
+  if (!existsSync27(essencePath)) {
     console.error(`${RED12}No decantr.essence.json found. Run \`decantr init\` first.${RESET16}`);
     process.exitCode = 1;
     return;
   }
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync21(essencePath, "utf-8"));
+    parsed = JSON.parse(readFileSync20(essencePath, "utf-8"));
   } catch (e) {
     console.error(`${RED12}Could not read essence: ${e.message}${RESET16}`);
     process.exitCode = 1;
@@ -7802,7 +7668,7 @@ async function runSimplifiedInit(blueprints) {
 }
 
 // src/theme-commands.ts
-import { existsSync as existsSync29, mkdirSync as mkdirSync16, readdirSync as readdirSync7, readFileSync as readFileSync22, rmSync as rmSync3, writeFileSync as writeFileSync19 } from "fs";
+import { existsSync as existsSync28, mkdirSync as mkdirSync16, readdirSync as readdirSync7, readFileSync as readFileSync21, rmSync as rmSync3, writeFileSync as writeFileSync19 } from "fs";
 import { join as join31 } from "path";
 var REQUIRED_FIELDS = [
   "$schema",
@@ -7867,7 +7733,7 @@ function createTheme(projectRoot, id, name) {
   const themePath = join31(customThemesDir, `${id}.json`);
   const howToPath = join31(customThemesDir, "how-to-theme.md");
   mkdirSync16(customThemesDir, { recursive: true });
-  if (existsSync29(themePath)) {
+  if (existsSync28(themePath)) {
     return {
       success: false,
       error: `Theme "${id}" already exists at ${themePath}`
@@ -7875,7 +7741,7 @@ function createTheme(projectRoot, id, name) {
   }
   const skeleton = getThemeSkeleton(id, name);
   writeFileSync19(themePath, JSON.stringify(skeleton, null, 2));
-  if (!existsSync29(howToPath)) {
+  if (!existsSync28(howToPath)) {
     writeFileSync19(howToPath, getHowToThemeDoc());
   }
   return {
@@ -7885,7 +7751,7 @@ function createTheme(projectRoot, id, name) {
 }
 function listCustomThemes(projectRoot) {
   const customThemesDir = join31(projectRoot, ".decantr", "custom", "themes");
-  if (!existsSync29(customThemesDir)) {
+  if (!existsSync28(customThemesDir)) {
     return [];
   }
   const themes = [];
@@ -7894,7 +7760,7 @@ function listCustomThemes(projectRoot) {
     for (const file of files) {
       const filePath = join31(customThemesDir, file);
       try {
-        const data = JSON.parse(readFileSync22(filePath, "utf-8"));
+        const data = JSON.parse(readFileSync21(filePath, "utf-8"));
         themes.push({
           id: data.id || file.replace(".json", ""),
           name: data.name || data.id,
@@ -7910,7 +7776,7 @@ function listCustomThemes(projectRoot) {
 }
 function deleteTheme(projectRoot, id) {
   const themePath = join31(projectRoot, ".decantr", "custom", "themes", `${id}.json`);
-  if (!existsSync29(themePath)) {
+  if (!existsSync28(themePath)) {
     return {
       success: false,
       error: `Theme "${id}" not found at ${themePath}`
@@ -7927,7 +7793,7 @@ function deleteTheme(projectRoot, id) {
   }
 }
 function importTheme(projectRoot, sourcePath) {
-  if (!existsSync29(sourcePath)) {
+  if (!existsSync28(sourcePath)) {
     return {
       success: false,
       errors: [`Source file not found: ${sourcePath}`]
@@ -7935,7 +7801,7 @@ function importTheme(projectRoot, sourcePath) {
   }
   let theme;
   try {
-    theme = JSON.parse(readFileSync22(sourcePath, "utf-8"));
+    theme = JSON.parse(readFileSync21(sourcePath, "utf-8"));
   } catch (e) {
     return {
       success: false,
@@ -7955,7 +7821,7 @@ function importTheme(projectRoot, sourcePath) {
   const destPath = join31(customThemesDir, `${id}.json`);
   mkdirSync16(customThemesDir, { recursive: true });
   const howToPath = join31(customThemesDir, "how-to-theme.md");
-  if (!existsSync29(howToPath)) {
+  if (!existsSync28(howToPath)) {
     writeFileSync19(howToPath, getHowToThemeDoc());
   }
   writeFileSync19(destPath, JSON.stringify(theme, null, 2));
@@ -8507,16 +8373,16 @@ function extractHostedAssetPaths(indexHtml) {
 function readHostedDistSnapshot(distPath) {
   const resolvedDistPath = distPath ? resolveUserPath(distPath) : join32(process.cwd(), "dist");
   const indexPath = join32(resolvedDistPath, "index.html");
-  if (!existsSync30(indexPath)) {
+  if (!existsSync29(indexPath)) {
     return void 0;
   }
-  const indexHtml = readFileSync23(indexPath, "utf-8");
+  const indexHtml = readFileSync22(indexPath, "utf-8");
   const assetPaths = extractHostedAssetPaths(indexHtml);
   const assets = {};
   for (const assetPath of assetPaths) {
     const assetFilePath = join32(resolvedDistPath, assetPath.replace(/^[/\\]+/, ""));
-    if (existsSync30(assetFilePath)) {
-      assets[assetPath] = readFileSync23(assetFilePath, "utf-8");
+    if (existsSync29(assetFilePath)) {
+      assets[assetPath] = readFileSync22(assetFilePath, "utf-8");
     }
   }
   return {
@@ -8531,7 +8397,7 @@ function isHostedSourceSnapshotFile(path) {
 function readHostedSourceSnapshot(sourcePath) {
   if (!sourcePath) return void 0;
   const resolvedSourcePath = resolveUserPath(sourcePath);
-  if (!existsSync30(resolvedSourcePath)) {
+  if (!existsSync29(resolvedSourcePath)) {
     return void 0;
   }
   const files = {};
@@ -8555,7 +8421,7 @@ function readHostedSourceSnapshot(sourcePath) {
       }
       if (!entry.isFile()) continue;
       if (!isHostedSourceSnapshotFile(relativePath)) continue;
-      files[relativePath] = readFileSync23(absolutePath, "utf-8");
+      files[relativePath] = readFileSync22(absolutePath, "utf-8");
     }
   };
   walk(resolvedSourcePath, rootPrefix);
@@ -8749,12 +8615,12 @@ async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput
 async function compileHostedExecutionPackBundle(essencePath, namespace) {
   const client = getPublicAPIClient();
   const resolvedPath = essencePath ? resolveUserPath(essencePath) : join32(process.cwd(), "decantr.essence.json");
-  if (!existsSync30(resolvedPath)) {
+  if (!existsSync29(resolvedPath)) {
     throw new Error(`Essence file not found at ${resolvedPath}`);
   }
-  const essence = JSON.parse(readFileSync23(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync22(resolvedPath, "utf-8"));
   const bundle = await client.compileExecutionPacks(essence, namespace ? { namespace } : void 0);
-  const contextDir = join32(dirname8(resolvedPath), ".decantr", "context");
+  const contextDir = join32(dirname7(resolvedPath), ".decantr", "context");
   return { resolvedPath, bundle, contextDir };
 }
 function writeHostedExecutionPackContextArtifacts(contextDir, bundle) {
@@ -8762,10 +8628,10 @@ function writeHostedExecutionPackContextArtifacts(contextDir, bundle) {
   return writeExecutionPackBundleArtifacts(contextDir, bundle);
 }
 function resolvePagePackIdForRoute(essencePath, route) {
-  if (!existsSync30(essencePath)) {
+  if (!existsSync29(essencePath)) {
     throw new Error(`Essence file not found at ${essencePath}`);
   }
-  const essence = JSON.parse(readFileSync23(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.");
   }
@@ -8781,13 +8647,13 @@ function resolvePagePackIdForRoute(essencePath, route) {
 async function printHostedSelectedExecutionPack(packType, id, essencePath, namespace, jsonOutput = false, writeContext = false) {
   const client = getPublicAPIClient();
   const resolvedPath = essencePath ? resolveUserPath(essencePath) : join32(process.cwd(), "decantr.essence.json");
-  if (!existsSync30(resolvedPath)) {
+  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(readFileSync23(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync22(resolvedPath, "utf-8"));
   const selected = await client.selectExecutionPack(
     {
       essence,
@@ -8798,7 +8664,7 @@ async function printHostedSelectedExecutionPack(packType, id, essencePath, names
   );
   let writtenContextDir = null;
   if (writeContext) {
-    const contextDir = join32(dirname8(resolvedPath), ".decantr", "context");
+    const contextDir = join32(dirname7(resolvedPath), ".decantr", "context");
     mkdirSync17(contextDir, { recursive: true });
     writeFileSync20(
       join32(contextDir, "pack-manifest.json"),
@@ -8834,17 +8700,17 @@ async function printHostedSelectedExecutionPack(packType, id, essencePath, names
 async function printHostedExecutionPackManifest(essencePath, namespace, jsonOutput = false, writeContext = false) {
   const client = getPublicAPIClient();
   const resolvedPath = essencePath ? resolveUserPath(essencePath) : join32(process.cwd(), "decantr.essence.json");
-  if (!existsSync30(resolvedPath)) {
+  if (!existsSync29(resolvedPath)) {
     throw new Error(`Essence file not found at ${resolvedPath}`);
   }
-  const essence = JSON.parse(readFileSync23(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 = join32(dirname8(resolvedPath), ".decantr", "context");
+    const contextDir = join32(dirname7(resolvedPath), ".decantr", "context");
     mkdirSync17(contextDir, { recursive: true });
     writeFileSync20(join32(contextDir, "pack-manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
     writtenContextDir = contextDir;
@@ -8870,11 +8736,11 @@ async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@o
   const contextDir = join32(projectRoot, ".decantr", "context");
   const reviewPackPath = join32(contextDir, "review-pack.json");
   const manifestPath = join32(contextDir, "pack-manifest.json");
-  if (existsSync30(reviewPackPath) && existsSync30(manifestPath)) {
+  if (existsSync29(reviewPackPath) && existsSync29(manifestPath)) {
     return { attempted: false, hydrated: false };
   }
   const essencePath = join32(projectRoot, "decantr.essence.json");
-  if (!existsSync30(essencePath)) {
+  if (!existsSync29(essencePath)) {
     return { attempted: false, hydrated: false };
   }
   const reviewHydration = await hydrateHostedReviewPackIfMissing(projectRoot, namespace);
@@ -8883,7 +8749,7 @@ async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@o
   }
   try {
     const client = getPublicAPIClient();
-    const essence = JSON.parse(readFileSync23(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync22(essencePath, "utf-8"));
     const bundle = await client.compileExecutionPacks(essence, { namespace });
     mkdirSync17(contextDir, { recursive: true });
     writeExecutionPackBundleArtifacts(contextDir, bundle);
@@ -8896,16 +8762,16 @@ async function hydrateHostedReviewPackIfMissing(projectRoot, namespace = "@offic
   const contextDir = join32(projectRoot, ".decantr", "context");
   const reviewPackPath = join32(contextDir, "review-pack.json");
   const manifestPath = join32(contextDir, "pack-manifest.json");
-  if (existsSync30(reviewPackPath) && existsSync30(manifestPath)) {
+  if (existsSync29(reviewPackPath) && existsSync29(manifestPath)) {
     return { attempted: false, hydrated: false };
   }
   const essencePath = join32(projectRoot, "decantr.essence.json");
-  if (!existsSync30(essencePath)) {
+  if (!existsSync29(essencePath)) {
     return { attempted: false, hydrated: false };
   }
   try {
     const client = getPublicAPIClient();
-    const essence = JSON.parse(readFileSync23(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync22(essencePath, "utf-8"));
     const selected = await client.selectExecutionPack(
       {
         essence,
@@ -8919,7 +8785,7 @@ async function hydrateHostedReviewPackIfMissing(projectRoot, namespace = "@offic
       join32(contextDir, "review-pack.json"),
       JSON.stringify(selected.pack, null, 2) + "\n"
     );
-    if (!existsSync30(manifestPath)) {
+    if (!existsSync29(manifestPath)) {
       writeFileSync20(manifestPath, JSON.stringify(selected.manifest, null, 2) + "\n");
     }
     return { attempted: true, hydrated: true, scope: "review" };
@@ -8932,15 +8798,15 @@ async function printHostedFileCritique(sourcePath, namespace, jsonOutput = false
   const resolvedSourcePath = resolveUserPath(sourcePath);
   const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join32(process.cwd(), "decantr.essence.json");
   const resolvedTreatmentsPath = treatmentsPath ? resolveUserPath(treatmentsPath) : join32(process.cwd(), "src", "styles", "treatments.css");
-  if (!existsSync30(resolvedSourcePath)) {
+  if (!existsSync29(resolvedSourcePath)) {
     throw new Error(`Source file not found at ${resolvedSourcePath}`);
   }
-  if (!existsSync30(resolvedEssencePath)) {
+  if (!existsSync29(resolvedEssencePath)) {
     throw new Error(`Essence file not found at ${resolvedEssencePath}`);
   }
-  const code = readFileSync23(resolvedSourcePath, "utf-8");
-  const essence = JSON.parse(readFileSync23(resolvedEssencePath, "utf-8"));
-  const treatmentsCss = existsSync30(resolvedTreatmentsPath) ? readFileSync23(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,
@@ -8965,10 +8831,10 @@ async function printHostedFileCritique(sourcePath, namespace, jsonOutput = false
 async function printHostedProjectAudit(namespace, jsonOutput = false, essencePath, distPath, sourcesPath) {
   const client = getPublicAPIClient();
   const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join32(process.cwd(), "decantr.essence.json");
-  if (!existsSync30(resolvedEssencePath)) {
+  if (!existsSync29(resolvedEssencePath)) {
     throw new Error(`Essence file not found at ${resolvedEssencePath}`);
   }
-  const essence = JSON.parse(readFileSync23(resolvedEssencePath, "utf-8"));
+  const essence = JSON.parse(readFileSync22(resolvedEssencePath, "utf-8"));
   const dist = readHostedDistSnapshot(distPath);
   const sources = readHostedSourceSnapshot(sourcesPath);
   const report = await client.auditProject(
@@ -9109,20 +8975,20 @@ function readSuggestCodeContext(projectRoot, route, file) {
   const pieces = [];
   if (file) {
     const resolved = isAbsolute4(file) ? file : join32(projectRoot, file);
-    if (existsSync30(resolved)) {
-      pieces.push(readFileSync23(resolved, "utf-8"));
+    if (existsSync29(resolved)) {
+      pieces.push(readFileSync22(resolved, "utf-8"));
     }
   }
   if (route) {
     const analysisPath = join32(projectRoot, ".decantr", "analysis.json");
-    if (existsSync30(analysisPath)) {
+    if (existsSync29(analysisPath)) {
       try {
-        const analysis = JSON.parse(readFileSync23(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 = join32(projectRoot, routeEntry.file);
-          if (existsSync30(resolved)) {
-            pieces.push(readFileSync23(resolved, "utf-8"));
+          if (existsSync29(resolved)) {
+            pieces.push(readFileSync22(resolved, "utf-8"));
           }
         }
       } catch {
@@ -9317,7 +9183,7 @@ async function cmdValidate(path) {
   const essencePath = path || join32(process.cwd(), "decantr.essence.json");
   let raw;
   try {
-    raw = readFileSync23(essencePath, "utf-8");
+    raw = readFileSync22(essencePath, "utf-8");
   } catch {
     console.error(error2(`Could not read ${essencePath}`));
     process.exitCode = 1;
@@ -9466,11 +9332,11 @@ ${CYAN10}Telemetry enabled.${RESET18} Decantr will send privacy-filtered CLI pro
   console.log(`${DIM18}Set "telemetry": false in .decantr/project.json to opt out.${RESET18}`);
 }
 function readCliPackageVersion2() {
-  const here = dirname8(fileURLToPath3(import.meta.url));
+  const here = dirname7(fileURLToPath3(import.meta.url));
   const candidates = [join32(here, "..", "package.json"), join32(here, "..", "..", "package.json")];
   for (const candidate of candidates) {
     try {
-      const pkg = JSON.parse(readFileSync23(candidate, "utf-8"));
+      const pkg = JSON.parse(readFileSync22(candidate, "utf-8"));
       if (pkg.version) return pkg.version;
     } catch {
     }
@@ -9482,12 +9348,12 @@ function timestampForFile() {
 }
 function backupExistingEssence(projectRoot, label) {
   const essencePath = join32(projectRoot, "decantr.essence.json");
-  if (!existsSync30(essencePath)) return null;
+  if (!existsSync29(essencePath)) return null;
   const backupPath = join32(
     projectRoot,
     `decantr.essence.${label}.${timestampForFile()}.backup.json`
   );
-  writeFileSync20(backupPath, readFileSync23(essencePath, "utf-8"), "utf-8");
+  writeFileSync20(backupPath, readFileSync22(essencePath, "utf-8"), "utf-8");
   return backupPath;
 }
 function writeBrownfieldProjectJson(input) {
@@ -9551,7 +9417,7 @@ async function applyAcceptedBrownfieldProposal(input) {
     return;
   }
   const essencePath = join32(input.projectRoot, "decantr.essence.json");
-  const hasEssence = existsSync30(essencePath);
+  const hasEssence = existsSync29(essencePath);
   let essence;
   let backupPath = null;
   if (input.mode === "accept" && hasEssence) {
@@ -9565,7 +9431,7 @@ async function applyAcceptedBrownfieldProposal(input) {
     return;
   }
   if (input.mode === "merge" && hasEssence) {
-    const existing = JSON.parse(readFileSync23(essencePath, "utf-8"));
+    const existing = JSON.parse(readFileSync22(essencePath, "utf-8"));
     if (!isV48(existing)) {
       console.log(
         error2(
@@ -10115,7 +9981,7 @@ ${YELLOW13}You're offline. Scaffolding Decantr default.${RESET18}`);
   if (appliedRuleFiles.length > 0) {
     console.log(`    ${dim4(`Rule bridge applied: ${appliedRuleFiles.join(", ")}`)}`);
   }
-  if (!existsSync30(join32(projectRoot, "package.json"))) {
+  if (!existsSync29(join32(projectRoot, "package.json"))) {
     console.log("");
     console.log(
       dim4(`  Note: ${cyan4("decantr init")} created Decantr contract/context files only.`)
@@ -10126,7 +9992,7 @@ ${YELLOW13}You're offline. Scaffolding Decantr default.${RESET18}`);
       )
     );
   }
-  const hasCompiledPacks = existsSync30(join32(projectRoot, ".decantr", "context", "scaffold-pack.md"));
+  const hasCompiledPacks = existsSync29(join32(projectRoot, ".decantr", "context", "scaffold-pack.md"));
   console.log("");
   console.log("  Next steps:");
   if (hasCompiledPacks) {
@@ -10166,7 +10032,7 @@ ${YELLOW13}You're offline. Scaffolding Decantr default.${RESET18}`);
   console.log(`    ${cyan4("decantr upgrade")}    Update to latest patterns`);
   console.log(`    ${cyan4("decantr check")}      Detect drift issues`);
   console.log(`    ${cyan4("decantr migrate --to v4")} Migrate older essence files to v4`);
-  const essenceContent = readFileSync23(result.essencePath, "utf-8");
+  const essenceContent = readFileSync22(result.essencePath, "utf-8");
   const essence = JSON.parse(essenceContent);
   const validation = validateEssence2(essence);
   if (!validation.valid) {
@@ -10224,13 +10090,13 @@ async function cmdStatus(projectRoot = process.cwd()) {
   const essencePath = join32(projectRoot, "decantr.essence.json");
   const projectJsonPath = join32(projectRoot, ".decantr", "project.json");
   console.log(heading2("Decantr Project Status"));
-  if (!existsSync30(essencePath)) {
+  if (!existsSync29(essencePath)) {
     console.log(`${RED13}No decantr.essence.json found.${RESET18}`);
     console.log(dim4('Run "decantr init" to create one.'));
     return;
   }
   try {
-    const essence = JSON.parse(readFileSync23(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync22(essencePath, "utf-8"));
     const validation = validateEssence2(essence);
     const essenceVersion = isV48(essence) ? "v4" : "legacy";
     console.log(`${BOLD11}Essence:${RESET18}`);
@@ -10278,9 +10144,9 @@ async function cmdStatus(projectRoot = process.cwd()) {
   }
   console.log("");
   console.log(`${BOLD11}Sync Status:${RESET18}`);
-  if (existsSync30(projectJsonPath)) {
+  if (existsSync29(projectJsonPath)) {
     try {
-      const projectJson = JSON.parse(readFileSync23(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";
@@ -10493,13 +10359,13 @@ ${BOLD11}Examples:${RESET18}
         return;
       }
       const themePath = join32(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
-      if (!existsSync30(themePath)) {
+      if (!existsSync29(themePath)) {
         console.error(error2(`Theme "${name}" not found at ${themePath}`));
         process.exitCode = 1;
         return;
       }
       try {
-        const theme = JSON.parse(readFileSync23(themePath, "utf-8"));
+        const theme = JSON.parse(readFileSync22(themePath, "utf-8"));
         const result = validateCustomTheme(theme);
         if (result.valid) {
           console.log(success4(`Custom theme "${name}" is valid`));
@@ -10729,7 +10595,7 @@ function printWorkspaceProjectSelection(workspaceInfo, commandName = "command")
 function printMonorepoSetupGuidance(workspaceInfo) {
   const candidate = firstWorkspaceCandidate(workspaceInfo);
   const attachedProjects = workspaceInfo.appCandidates.filter(
-    (appCandidate) => existsSync30(join32(workspaceInfo.workspaceRoot, appCandidate, "decantr.essence.json"))
+    (appCandidate) => existsSync29(join32(workspaceInfo.workspaceRoot, appCandidate, "decantr.essence.json"))
   );
   const firstAttached = attachedProjects[0];
   console.log(heading2("Decantr Setup"));
@@ -10797,7 +10663,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 && !existsSync30(workspaceInfo.appRoot)) {
+  if (projectArg && options.requireExisting !== false && !existsSync29(workspaceInfo.appRoot)) {
     printProjectNotFound(projectArg, commandName);
     process.exitCode = 1;
     return null;
@@ -11019,14 +10885,23 @@ function printScanReport(report, projectArg) {
   console.log("");
   printScanGraphPreview(report.graphPreview);
   console.log(`${BOLD11}Routes And Styling${RESET18}`);
-  console.log(`  Routes:         ${report.routes.count} (${report.routes.strategy})`);
+  const routeSignalCount = report.routes.routeSignalCount ?? report.routes.count;
+  const taskableRouteCount = report.routes.taskableRouteCount ?? report.routes.count;
+  console.log(
+    `  Routes:         ${taskableRouteCount} taskable / ${routeSignalCount} signal(s) (${report.routes.strategy}, ${report.routes.confidence})`
+  );
   for (const route of report.routes.items.slice(0, 8)) {
     console.log(`    ${cyan4(route.path.padEnd(18))} ${dim4(route.file)}`);
   }
   if (report.routes.items.length > 8) {
     console.log(`    ${dim4(`...${report.routes.items.length - 8} more route(s)`)}`);
   }
-  console.log(`  Components:     ${report.components.componentCount}`);
+  console.log(
+    `  Components:     ${report.components.componentCount} discovered (${report.components.confidence} confidence)`
+  );
+  if (report.components.limitations?.[0]) {
+    console.log(`                  ${dim4(report.components.limitations[0])}`);
+  }
   console.log(
     `  Styling:        ${report.styling.approach}${report.styling.configFile ? ` (${report.styling.configFile})` : ""}`
   );
@@ -11128,9 +11003,9 @@ async function cmdSetupWorkflow(args) {
   console.log(`  Detected: ${formatDetection(detected)}`);
   console.log("");
   if (detected.existingEssence) {
-    const hasLocalPatterns = existsSync30(localPatternsPath(workspaceInfo.appRoot));
-    const hasLocalRules = existsSync30(localRulesPath(workspaceInfo.appRoot));
-    const hasStyleBridge = existsSync30(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(`${BOLD11}Recommended path:${RESET18} maintain an attached Decantr project`);
     console.log(
@@ -11218,7 +11093,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 = existsSync30(join32(projectRoot, "decantr.essence.json"));
+  const hasEssence = existsSync29(join32(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",
@@ -11478,9 +11353,9 @@ async function cmdVerifyWorkflow(args) {
   }
 }
 function readJsonIfPresent(path) {
-  if (!existsSync30(path)) return null;
+  if (!existsSync29(path)) return null;
   try {
-    return JSON.parse(readFileSync23(path, "utf-8"));
+    return JSON.parse(readFileSync22(path, "utf-8"));
   } catch {
     return null;
   }
@@ -11711,11 +11586,11 @@ async function cmdTaskWorkflow(args) {
     projectRoot: workspaceInfo.appRoot,
     workflowMode: projectJson?.initialized?.workflowMode ?? null,
     adoptionMode: projectJson?.initialized?.adoptionMode ?? null,
-    hasLocalPatterns: existsSync30(localPatternPackPath),
-    hasLocalRules: existsSync30(localRuleManifestPath),
+    hasLocalPatterns: existsSync29(localPatternPackPath),
+    hasLocalRules: existsSync29(localRuleManifestPath),
     hasPackManifest: Boolean(manifest),
     taskSummary,
-    hasStyleBridge: existsSync30(acceptedStyleBridgePath)
+    hasStyleBridge: existsSync29(acceptedStyleBridgePath)
   });
   const readTargets = [
     pagePack ? displayProjectPath(workspaceInfo, join32(".decantr/context", pagePack.markdown)) : null,
@@ -11723,9 +11598,9 @@ async function cmdTaskWorkflow(args) {
     manifest?.scaffold?.markdown ? displayProjectPath(workspaceInfo, join32(".decantr/context", manifest.scaffold.markdown)) : null,
     displayProjectPath(workspaceInfo, ".decantr/context/scaffold.md"),
     displayProjectPath(workspaceInfo, "DECANTR.md"),
-    existsSync30(localPatternPackPath) ? displayProjectPath(workspaceInfo, ".decantr/local-patterns.json") : null,
-    existsSync30(localRuleManifestPath) ? displayProjectPath(workspaceInfo, ".decantr/rules.json") : null,
-    existsSync30(acceptedStyleBridgePath) ? displayProjectPath(workspaceInfo, ".decantr/style-bridge.json") : null,
+    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));
@@ -12045,7 +11920,7 @@ async function cmdCodifyWorkflow(args) {
   const workspaceInfo = resolveWorkflowProject(flags, "codify");
   if (!workspaceInfo) return;
   if (flagBoolean(flags, "accept")) {
-    if (!existsSync30(localPatternsProposalPath(workspaceInfo.appRoot)) && !existsSync30(localRulesProposalPath(workspaceInfo.appRoot)) && !existsSync30(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."
@@ -12460,7 +12335,7 @@ ${BOLD11}Usage:${RESET18}
 
 ${BOLD11}Options:${RESET18}
   --project   App path inside a workspace/monorepo
-  --json      Emit the ScanReportV1 JSON to stdout
+  --json      Emit the ScanReportV2 JSON to stdout
 
 ${BOLD11}Behavior:${RESET18}
   Reads local project files, detects frontend framework/routes/styling/static-hosting signals,
@@ -12840,11 +12715,11 @@ async function main() {
   }
   if (command === "--version" || command === "-v" || command === "version") {
     try {
-      const here = dirname8(fileURLToPath3(import.meta.url));
+      const here = dirname7(fileURLToPath3(import.meta.url));
       const candidates = [join32(here, "..", "package.json"), join32(here, "..", "..", "package.json")];
       for (const candidate of candidates) {
-        if (existsSync30(candidate)) {
-          const pkg = JSON.parse(readFileSync23(candidate, "utf-8"));
+        if (existsSync29(candidate)) {
+          const pkg = JSON.parse(readFileSync22(candidate, "utf-8"));
           if (pkg.version) {
             console.log(pkg.version);
             return;
@@ -13041,7 +12916,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-WBFE6EN7.js");
+      const { cmdUpgrade } = await import("./upgrade-4BUQAYBU.js");
       const { flags } = parseLooseArgs(args);
       const workspaceInfo = resolveWorkflowProject(flags, "upgrade");
       if (!workspaceInfo) break;
@@ -13299,7 +13174,7 @@ async function main() {
       const requestedView = args[1];
       const view = requestedView === "manifest" || requestedView === "shortlist" || requestedView === "verification" ? requestedView : "shortlist";
       const jsonOutput = args.includes("--json");
-      if (requestedView && requestedView.startsWith("--")) {
+      if (requestedView?.startsWith("--")) {
         await printShowcaseBenchmarks("shortlist", jsonOutput);
         break;
       }
@@ -13324,7 +13199,7 @@ async function main() {
     }
     case "login": {
       const apiKeyArg = args[1];
-      if (apiKeyArg && apiKeyArg.startsWith("--api-key=")) {
+      if (apiKeyArg?.startsWith("--api-key=")) {
         const key = apiKeyArg.split("=")[1];
         saveCredentials({ access_token: key, api_key: key });
         console.log(success4("API key saved."));
@@ -13640,7 +13515,7 @@ async function main() {
         mcpOnly: flagBoolean(flags, "mcp-only"),
         rulesOnly: flagBoolean(flags, "rules-only"),
         routeHint,
-        attached: existsSync30(join32(workspaceInfo.appRoot, "decantr.essence.json"))
+        attached: existsSync29(join32(workspaceInfo.appRoot, "decantr.essence.json"))
       });
       break;
     }