@decantr/cli 2.8.0 → 2.8.1

package/dist/{chunk-QTPNV5WU.js → chunk-RKZMHS2K.js}

@@ -15,6 +15,9 @@ import {
   syncRegistry,
   writeExecutionPackBundleArtifacts
 } from "./chunk-V3XAQWKD.js";
+import {
+  resolveWorkspaceInfo
+} from "./chunk-VE6N3XWG.js";
 import {
   buildGuardRegistryContext,
   createDoctrineMap,
@@ -34,8 +37,8 @@ import {
 } from "./chunk-KT2ROK2D.js";
 
 // src/index.ts
-import { existsSync as existsSync28, mkdirSync as mkdirSync14, readdirSync as readdirSync8, readFileSync as readFileSync21, writeFileSync as writeFileSync17 } from "fs";
-import { basename as basename3, dirname as dirname4, isAbsolute, join as join29, resolve as resolve4 } from "path";
+import { existsSync as existsSync27, mkdirSync as mkdirSync14, readdirSync as readdirSync7, readFileSync as readFileSync20, writeFileSync as writeFileSync17 } from "fs";
+import { basename as basename3, dirname as dirname3, isAbsolute, join as join28, resolve as resolve3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { evaluateGuard, isV4 as isV48, validateEssence as validateEssence2 } from "@decantr/essence-spec";
 import {
@@ -5764,10 +5767,10 @@ var CYAN7 = "\x1B[36m";
 function ask(question, defaultValue) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const prompt = defaultValue ? `${question} ${DIM13}(${defaultValue})${RESET13}: ` : `${question}: `;
-  return new Promise((resolve5) => {
+  return new Promise((resolve4) => {
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve5(answer.trim() || defaultValue || "");
+      resolve4(answer.trim() || defaultValue || "");
     });
   });
 }
@@ -6018,7 +6021,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((resolve4) => rl.question(q, resolve4));
   console.log("\n? What blueprint would you like to scaffold?\n");
   console.log("  1. Decantr default (recommended)");
   console.log("  2. Search registry...\n");
@@ -6213,76 +6216,6 @@ function importTheme(projectRoot, sourcePath) {
   };
 }
 
-// src/workspace.ts
-import { existsSync as existsSync27, readdirSync as readdirSync7, readFileSync as readFileSync20 } from "fs";
-import { dirname as dirname3, join as join28, resolve as resolve3 } from "path";
-function readPackageJson(dir) {
-  const path = join28(dir, "package.json");
-  if (!existsSync27(path)) return null;
-  try {
-    return JSON.parse(readFileSync20(path, "utf-8"));
-  } catch {
-    return null;
-  }
-}
-function hasWorkspaceMarker(dir) {
-  if (existsSync27(join28(dir, "pnpm-workspace.yaml")) || existsSync27(join28(dir, "turbo.json")) || existsSync27(join28(dir, "nx.json"))) {
-    return true;
-  }
-  const pkg = readPackageJson(dir);
-  return Boolean(pkg?.workspaces);
-}
-function findWorkspaceRoot(startDir) {
-  let current = resolve3(startDir);
-  while (true) {
-    if (hasWorkspaceMarker(current)) return current;
-    const parent = dirname3(current);
-    if (parent === current) return null;
-    current = parent;
-  }
-}
-function looksLikeApp(dir) {
-  if (existsSync27(join28(dir, "next.config.js")) || existsSync27(join28(dir, "next.config.ts")) || existsSync27(join28(dir, "next.config.mjs")) || existsSync27(join28(dir, "vite.config.ts")) || existsSync27(join28(dir, "vite.config.js")) || existsSync27(join28(dir, "angular.json")) || existsSync27(join28(dir, "svelte.config.js")) || existsSync27(join28(dir, "svelte.config.ts")) || existsSync27(join28(dir, "astro.config.mjs")) || existsSync27(join28(dir, "src")) || existsSync27(join28(dir, "app")) || existsSync27(join28(dir, "pages"))) {
-    return true;
-  }
-  const pkg = readPackageJson(dir);
-  const deps = { ...pkg?.dependencies, ...pkg?.devDependencies };
-  return Boolean(
-    deps.react || deps.next || deps.vue || deps.svelte || deps["@angular/core"] || deps.astro || deps.nuxt
-  );
-}
-function listWorkspaceApps(workspaceRoot) {
-  const candidates = [];
-  for (const base of ["apps", "packages"]) {
-    const baseDir = join28(workspaceRoot, base);
-    if (!existsSync27(baseDir)) continue;
-    for (const entry of readdirSync7(baseDir, { withFileTypes: true })) {
-      if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
-      const candidate = join28(baseDir, entry.name);
-      if (looksLikeApp(candidate)) {
-        candidates.push(`${base}/${entry.name}`);
-      }
-    }
-  }
-  return candidates.sort();
-}
-function resolveWorkspaceInfo(cwd, projectArg) {
-  const absoluteCwd = resolve3(cwd);
-  const workspaceRoot = findWorkspaceRoot(absoluteCwd) ?? absoluteCwd;
-  const appRoot = projectArg ? resolve3(absoluteCwd, projectArg) : absoluteCwd;
-  const appCandidates = listWorkspaceApps(workspaceRoot);
-  const projectScope = workspaceRoot !== appRoot || appCandidates.length > 0 ? "workspace-app" : "single-app";
-  const requiresProjectSelection = !projectArg && workspaceRoot === absoluteCwd && appCandidates.length > 1;
-  return {
-    cwd: absoluteCwd,
-    workspaceRoot,
-    appRoot,
-    projectScope,
-    appCandidates,
-    requiresProjectSelection
-  };
-}
-
 // src/index.ts
 var BOLD7 = "\x1B[1m";
 var DIM14 = "\x1B[2m";
@@ -6810,7 +6743,7 @@ function getPublicAPIClient() {
   });
 }
 function resolveUserPath(inputPath, cwd = process.cwd()) {
-  return isAbsolute(inputPath) ? inputPath : resolve4(cwd, inputPath);
+  return isAbsolute(inputPath) ? inputPath : resolve3(cwd, inputPath);
 }
 function extractHostedAssetPaths(indexHtml) {
   const assetPaths = /* @__PURE__ */ new Set();
@@ -6823,18 +6756,18 @@ function extractHostedAssetPaths(indexHtml) {
   return [...assetPaths];
 }
 function readHostedDistSnapshot(distPath) {
-  const resolvedDistPath = distPath ? resolveUserPath(distPath) : join29(process.cwd(), "dist");
-  const indexPath = join29(resolvedDistPath, "index.html");
-  if (!existsSync28(indexPath)) {
+  const resolvedDistPath = distPath ? resolveUserPath(distPath) : join28(process.cwd(), "dist");
+  const indexPath = join28(resolvedDistPath, "index.html");
+  if (!existsSync27(indexPath)) {
     return void 0;
   }
-  const indexHtml = readFileSync21(indexPath, "utf-8");
+  const indexHtml = readFileSync20(indexPath, "utf-8");
   const assetPaths = extractHostedAssetPaths(indexHtml);
   const assets = {};
   for (const assetPath of assetPaths) {
-    const assetFilePath = join29(resolvedDistPath, assetPath.replace(/^[/\\]+/, ""));
-    if (existsSync28(assetFilePath)) {
-      assets[assetPath] = readFileSync21(assetFilePath, "utf-8");
+    const assetFilePath = join28(resolvedDistPath, assetPath.replace(/^[/\\]+/, ""));
+    if (existsSync27(assetFilePath)) {
+      assets[assetPath] = readFileSync20(assetFilePath, "utf-8");
     }
   }
   return {
@@ -6849,7 +6782,7 @@ function isHostedSourceSnapshotFile(path) {
 function readHostedSourceSnapshot(sourcePath) {
   if (!sourcePath) return void 0;
   const resolvedSourcePath = resolveUserPath(sourcePath);
-  if (!existsSync28(resolvedSourcePath)) {
+  if (!existsSync27(resolvedSourcePath)) {
     return void 0;
   }
   const files = {};
@@ -6863,17 +6796,17 @@ function readHostedSourceSnapshot(sourcePath) {
   ]);
   const rootPrefix = basename3(resolvedSourcePath);
   const walk = (absoluteDir, relativeDir) => {
-    for (const entry of readdirSync8(absoluteDir, { withFileTypes: true })) {
+    for (const entry of readdirSync7(absoluteDir, { withFileTypes: true })) {
       if (ignoredDirNames.has(entry.name)) continue;
-      const absolutePath = join29(absoluteDir, entry.name);
-      const relativePath = join29(relativeDir, entry.name).replace(/\\/g, "/");
+      const absolutePath = join28(absoluteDir, entry.name);
+      const relativePath = join28(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] = readFileSync20(absolutePath, "utf-8");
     }
   };
   walk(resolvedSourcePath, rootPrefix);
@@ -7024,15 +6957,15 @@ async function printRegistryIntelligenceSummary(namespace, jsonOutput = false) {
 }
 async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput = false, writeContext = false) {
   const client = getPublicAPIClient();
-  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join29(process.cwd(), "decantr.essence.json");
-  if (!existsSync28(resolvedPath)) {
+  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join28(process.cwd(), "decantr.essence.json");
+  if (!existsSync27(resolvedPath)) {
     throw new Error(`Essence file not found at ${resolvedPath}`);
   }
-  const essence = JSON.parse(readFileSync21(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync20(resolvedPath, "utf-8"));
   const bundle = await client.compileExecutionPacks(essence, namespace ? { namespace } : void 0);
   let writtenContextPaths = [];
   if (writeContext) {
-    const contextDir = join29(process.cwd(), ".decantr", "context");
+    const contextDir = join28(process.cwd(), ".decantr", "context");
     mkdirSync14(contextDir, { recursive: true });
     const written = writeExecutionPackBundleArtifacts(
       contextDir,
@@ -7058,7 +6991,7 @@ async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput
   console.log(`  Sections: ${typedBundle.sections.length}`);
   console.log(`  Mutations: ${typedBundle.mutations.length}`);
   if (writeContext) {
-    console.log(`  Context bundle: ${join29(process.cwd(), ".decantr", "context")}`);
+    console.log(`  Context bundle: ${join28(process.cwd(), ".decantr", "context")}`);
     console.log(`  Files written: ${writtenContextPaths.length}`);
   }
   console.log("");
@@ -7070,10 +7003,10 @@ async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput
   }
 }
 function resolvePagePackIdForRoute(essencePath, route) {
-  if (!existsSync28(essencePath)) {
+  if (!existsSync27(essencePath)) {
     throw new Error(`Essence file not found at ${essencePath}`);
   }
-  const essence = JSON.parse(readFileSync21(essencePath, "utf-8"));
+  const essence = JSON.parse(readFileSync20(essencePath, "utf-8"));
   if (!isV48(essence)) {
     throw new Error("Route-based pack resolution requires Essence v4.0.0.");
   }
@@ -7088,14 +7021,14 @@ function resolvePagePackIdForRoute(essencePath, route) {
 }
 async function printHostedSelectedExecutionPack(packType, id, essencePath, namespace, jsonOutput = false, writeContext = false) {
   const client = getPublicAPIClient();
-  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join29(process.cwd(), "decantr.essence.json");
-  if (!existsSync28(resolvedPath)) {
+  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join28(process.cwd(), "decantr.essence.json");
+  if (!existsSync27(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(readFileSync20(resolvedPath, "utf-8"));
   const selected = await client.selectExecutionPack(
     {
       essence,
@@ -7106,17 +7039,17 @@ async function printHostedSelectedExecutionPack(packType, id, essencePath, names
   );
   let writtenContextDir = null;
   if (writeContext) {
-    const contextDir = join29(process.cwd(), ".decantr", "context");
+    const contextDir = join28(process.cwd(), ".decantr", "context");
     mkdirSync14(contextDir, { recursive: true });
     writeFileSync17(
-      join29(contextDir, "pack-manifest.json"),
+      join28(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`;
-    writeFileSync17(join29(contextDir, markdownFile), selected.pack.renderedMarkdown);
-    writeFileSync17(join29(contextDir, jsonFile), JSON.stringify(selected.pack, null, 2) + "\n");
+    writeFileSync17(join28(contextDir, markdownFile), selected.pack.renderedMarkdown);
+    writeFileSync17(join28(contextDir, jsonFile), JSON.stringify(selected.pack, null, 2) + "\n");
     writtenContextDir = contextDir;
   }
   if (jsonOutput) {
@@ -7141,20 +7074,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) : join29(process.cwd(), "decantr.essence.json");
-  if (!existsSync28(resolvedPath)) {
+  const resolvedPath = essencePath ? resolveUserPath(essencePath) : join28(process.cwd(), "decantr.essence.json");
+  if (!existsSync27(resolvedPath)) {
     throw new Error(`Essence file not found at ${resolvedPath}`);
   }
-  const essence = JSON.parse(readFileSync21(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync20(resolvedPath, "utf-8"));
   const manifest = await client.getExecutionPackManifest(
     essence,
     namespace ? { namespace } : void 0
   );
   let writtenContextDir = null;
   if (writeContext) {
-    const contextDir = join29(process.cwd(), ".decantr", "context");
+    const contextDir = join28(process.cwd(), ".decantr", "context");
     mkdirSync14(contextDir, { recursive: true });
-    writeFileSync17(join29(contextDir, "pack-manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
+    writeFileSync17(join28(contextDir, "pack-manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
     writtenContextDir = contextDir;
   }
   if (jsonOutput) {
@@ -7175,14 +7108,14 @@ async function printHostedExecutionPackManifest(essencePath, namespace, jsonOutp
   }
 }
 async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@official") {
-  const contextDir = join29(projectRoot, ".decantr", "context");
-  const reviewPackPath = join29(contextDir, "review-pack.json");
-  const manifestPath = join29(contextDir, "pack-manifest.json");
-  if (existsSync28(reviewPackPath) && existsSync28(manifestPath)) {
+  const contextDir = join28(projectRoot, ".decantr", "context");
+  const reviewPackPath = join28(contextDir, "review-pack.json");
+  const manifestPath = join28(contextDir, "pack-manifest.json");
+  if (existsSync27(reviewPackPath) && existsSync27(manifestPath)) {
     return { attempted: false, hydrated: false };
   }
-  const essencePath = join29(projectRoot, "decantr.essence.json");
-  if (!existsSync28(essencePath)) {
+  const essencePath = join28(projectRoot, "decantr.essence.json");
+  if (!existsSync27(essencePath)) {
     return { attempted: false, hydrated: false };
   }
   const reviewHydration = await hydrateHostedReviewPackIfMissing(projectRoot, namespace);
@@ -7191,7 +7124,7 @@ async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@o
   }
   try {
     const client = getPublicAPIClient();
-    const essence = JSON.parse(readFileSync21(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync20(essencePath, "utf-8"));
     const bundle = await client.compileExecutionPacks(essence, { namespace });
     mkdirSync14(contextDir, { recursive: true });
     writeExecutionPackBundleArtifacts(contextDir, bundle);
@@ -7201,19 +7134,19 @@ async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@o
   }
 }
 async function hydrateHostedReviewPackIfMissing(projectRoot, namespace = "@official") {
-  const contextDir = join29(projectRoot, ".decantr", "context");
-  const reviewPackPath = join29(contextDir, "review-pack.json");
-  const manifestPath = join29(contextDir, "pack-manifest.json");
-  if (existsSync28(reviewPackPath) && existsSync28(manifestPath)) {
+  const contextDir = join28(projectRoot, ".decantr", "context");
+  const reviewPackPath = join28(contextDir, "review-pack.json");
+  const manifestPath = join28(contextDir, "pack-manifest.json");
+  if (existsSync27(reviewPackPath) && existsSync27(manifestPath)) {
     return { attempted: false, hydrated: false };
   }
-  const essencePath = join29(projectRoot, "decantr.essence.json");
-  if (!existsSync28(essencePath)) {
+  const essencePath = join28(projectRoot, "decantr.essence.json");
+  if (!existsSync27(essencePath)) {
     return { attempted: false, hydrated: false };
   }
   try {
     const client = getPublicAPIClient();
-    const essence = JSON.parse(readFileSync21(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync20(essencePath, "utf-8"));
     const selected = await client.selectExecutionPack(
       {
         essence,
@@ -7222,12 +7155,12 @@ async function hydrateHostedReviewPackIfMissing(projectRoot, namespace = "@offic
       { namespace }
     );
     mkdirSync14(contextDir, { recursive: true });
-    writeFileSync17(join29(contextDir, "review-pack.md"), selected.pack.renderedMarkdown);
+    writeFileSync17(join28(contextDir, "review-pack.md"), selected.pack.renderedMarkdown);
     writeFileSync17(
-      join29(contextDir, "review-pack.json"),
+      join28(contextDir, "review-pack.json"),
       JSON.stringify(selected.pack, null, 2) + "\n"
     );
-    if (!existsSync28(manifestPath)) {
+    if (!existsSync27(manifestPath)) {
       writeFileSync17(manifestPath, JSON.stringify(selected.manifest, null, 2) + "\n");
     }
     return { attempted: true, hydrated: true, scope: "review" };
@@ -7238,17 +7171,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) : join29(process.cwd(), "decantr.essence.json");
-  const resolvedTreatmentsPath = treatmentsPath ? resolveUserPath(treatmentsPath) : join29(process.cwd(), "src", "styles", "treatments.css");
-  if (!existsSync28(resolvedSourcePath)) {
+  const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join28(process.cwd(), "decantr.essence.json");
+  const resolvedTreatmentsPath = treatmentsPath ? resolveUserPath(treatmentsPath) : join28(process.cwd(), "src", "styles", "treatments.css");
+  if (!existsSync27(resolvedSourcePath)) {
     throw new Error(`Source file not found at ${resolvedSourcePath}`);
   }
-  if (!existsSync28(resolvedEssencePath)) {
+  if (!existsSync27(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 = readFileSync20(resolvedSourcePath, "utf-8");
+  const essence = JSON.parse(readFileSync20(resolvedEssencePath, "utf-8"));
+  const treatmentsCss = existsSync27(resolvedTreatmentsPath) ? readFileSync20(resolvedTreatmentsPath, "utf-8") : void 0;
   const report = await client.critiqueFile(
     {
       essence,
@@ -7272,11 +7205,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) : join29(process.cwd(), "decantr.essence.json");
-  if (!existsSync28(resolvedEssencePath)) {
+  const resolvedEssencePath = essencePath ? resolveUserPath(essencePath) : join28(process.cwd(), "decantr.essence.json");
+  if (!existsSync27(resolvedEssencePath)) {
     throw new Error(`Essence file not found at ${resolvedEssencePath}`);
   }
-  const essence = JSON.parse(readFileSync21(resolvedEssencePath, "utf-8"));
+  const essence = JSON.parse(readFileSync20(resolvedEssencePath, "utf-8"));
   const dist = readHostedDistSnapshot(distPath);
   const sources = readHostedSourceSnapshot(sourcesPath);
   const report = await client.auditProject(
@@ -7294,7 +7227,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) : join29(process.cwd(), "dist") : "none"}`
+    `  Dist snapshot: ${dist ? distPath ? resolveUserPath(distPath) : join28(process.cwd(), "dist") : "none"}`
   );
   console.log(
     `  Source snapshot: ${sources && sourcesPath ? resolveUserPath(sourcesPath) : "none"}`
@@ -7397,21 +7330,21 @@ function patternCandidateFromRegistryItem(item, source) {
 function readSuggestCodeContext(route, file) {
   const pieces = [];
   if (file) {
-    const resolved = isAbsolute(file) ? file : join29(process.cwd(), file);
-    if (existsSync28(resolved)) {
-      pieces.push(readFileSync21(resolved, "utf-8"));
+    const resolved = isAbsolute(file) ? file : join28(process.cwd(), file);
+    if (existsSync27(resolved)) {
+      pieces.push(readFileSync20(resolved, "utf-8"));
     }
   }
   if (route) {
-    const analysisPath = join29(process.cwd(), ".decantr", "analysis.json");
-    if (existsSync28(analysisPath)) {
+    const analysisPath = join28(process.cwd(), ".decantr", "analysis.json");
+    if (existsSync27(analysisPath)) {
       try {
-        const analysis = JSON.parse(readFileSync21(analysisPath, "utf-8"));
+        const analysis = JSON.parse(readFileSync20(analysisPath, "utf-8"));
         const routeEntry = analysis.routes?.routes?.find((entry) => entry.path === route);
         if (routeEntry?.file) {
-          const resolved = join29(process.cwd(), routeEntry.file);
-          if (existsSync28(resolved)) {
-            pieces.push(readFileSync21(resolved, "utf-8"));
+          const resolved = join28(process.cwd(), routeEntry.file);
+          if (existsSync27(resolved)) {
+            pieces.push(readFileSync20(resolved, "utf-8"));
           }
         }
       } catch {
@@ -7468,7 +7401,7 @@ async function cmdSuggest(query, options = {}) {
     }
   }
   const registryClient = new RegistryClient({
-    cacheDir: join29(process.cwd(), ".decantr", "cache")
+    cacheDir: join28(process.cwd(), ".decantr", "cache")
   });
   const code = options.fromCode || options.file ? readSuggestCodeContext(options.route, options.file) : "";
   const candidates = await loadPatternDiscoveryCandidates(registryClient);
@@ -7530,7 +7463,7 @@ async function cmdGet(type, id) {
   }
   const apiType = CONTENT_TYPE_TO_API_CONTENT_TYPE3[type];
   const registryClient = new RegistryClient({
-    cacheDir: join29(process.cwd(), ".decantr", "cache")
+    cacheDir: join28(process.cwd(), ".decantr", "cache")
   });
   const result = await registryClient.fetchContentItem(apiType, id);
   if (result) {
@@ -7547,10 +7480,10 @@ async function cmdGet(type, id) {
   return;
 }
 async function cmdValidate(path) {
-  const essencePath = path || join29(process.cwd(), "decantr.essence.json");
+  const essencePath = path || join28(process.cwd(), "decantr.essence.json");
   let raw;
   try {
-    raw = readFileSync21(essencePath, "utf-8");
+    raw = readFileSync20(essencePath, "utf-8");
   } catch {
     console.error(error3(`Could not read ${essencePath}`));
     process.exitCode = 1;
@@ -7617,7 +7550,7 @@ async function cmdList(type, sort, recommended, intelligenceSource, blueprintSet
     return;
   }
   const registryClient = new RegistryClient({
-    cacheDir: join29(process.cwd(), ".decantr", "cache")
+    cacheDir: join28(process.cwd(), ".decantr", "cache")
   });
   const result = await registryClient.fetchContentList(
     type,
@@ -7699,11 +7632,11 @@ ${CYAN8}Telemetry enabled.${RESET14} Decantr will send privacy-filtered CLI prod
   console.log(`${DIM14}Set "telemetry": false in .decantr/project.json to opt out.${RESET14}`);
 }
 function readCliPackageVersion() {
-  const here = dirname4(fileURLToPath2(import.meta.url));
-  const candidates = [join29(here, "..", "package.json"), join29(here, "..", "..", "package.json")];
+  const here = dirname3(fileURLToPath2(import.meta.url));
+  const candidates = [join28(here, "..", "package.json"), join28(here, "..", "..", "package.json")];
   for (const candidate of candidates) {
     try {
-      const pkg = JSON.parse(readFileSync21(candidate, "utf-8"));
+      const pkg = JSON.parse(readFileSync20(candidate, "utf-8"));
       if (pkg.version) return pkg.version;
     } catch {
     }
@@ -7714,19 +7647,19 @@ function timestampForFile() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
 }
 function backupExistingEssence(projectRoot, label) {
-  const essencePath = join29(projectRoot, "decantr.essence.json");
-  if (!existsSync28(essencePath)) return null;
-  const backupPath = join29(
+  const essencePath = join28(projectRoot, "decantr.essence.json");
+  if (!existsSync27(essencePath)) return null;
+  const backupPath = join28(
     projectRoot,
     `decantr.essence.${label}.${timestampForFile()}.backup.json`
   );
-  writeFileSync17(backupPath, readFileSync21(essencePath, "utf-8"), "utf-8");
+  writeFileSync17(backupPath, readFileSync20(essencePath, "utf-8"), "utf-8");
   return backupPath;
 }
 function writeBrownfieldProjectJson(input) {
-  const decantrDir = join29(input.projectRoot, ".decantr");
-  mkdirSync14(join29(decantrDir, "context"), { recursive: true });
-  mkdirSync14(join29(decantrDir, "cache"), { recursive: true });
+  const decantrDir = join28(input.projectRoot, ".decantr");
+  mkdirSync14(join28(decantrDir, "context"), { recursive: true });
+  mkdirSync14(join28(decantrDir, "cache"), { recursive: true });
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const projectJson = {
     detected: {
@@ -7767,7 +7700,7 @@ function writeBrownfieldProjectJson(input) {
       }
     }
   };
-  writeFileSync17(join29(decantrDir, "project.json"), JSON.stringify(projectJson, null, 2) + "\n");
+  writeFileSync17(join28(decantrDir, "project.json"), JSON.stringify(projectJson, null, 2) + "\n");
 }
 async function applyAcceptedBrownfieldProposal(input) {
   const proposal = readBrownfieldProposal(input.projectRoot);
@@ -7783,8 +7716,8 @@ async function applyAcceptedBrownfieldProposal(input) {
     process.exitCode = 1;
     return;
   }
-  const essencePath = join29(input.projectRoot, "decantr.essence.json");
-  const hasEssence = existsSync28(essencePath);
+  const essencePath = join28(input.projectRoot, "decantr.essence.json");
+  const hasEssence = existsSync27(essencePath);
   let essence;
   let backupPath = null;
   if (input.mode === "accept" && hasEssence) {
@@ -7798,7 +7731,7 @@ async function applyAcceptedBrownfieldProposal(input) {
     return;
   }
   if (input.mode === "merge" && hasEssence) {
-    const existing = JSON.parse(readFileSync21(essencePath, "utf-8"));
+    const existing = JSON.parse(readFileSync20(essencePath, "utf-8"));
     if (!isV48(existing)) {
       console.log(
         error3(
@@ -7837,7 +7770,7 @@ async function applyAcceptedBrownfieldProposal(input) {
   });
   writeFileSync17(essencePath, JSON.stringify(essence, null, 2) + "\n", "utf-8");
   const registryClient = new RegistryClient({
-    cacheDir: join29(input.projectRoot, ".decantr", "cache"),
+    cacheDir: join28(input.projectRoot, ".decantr", "cache"),
     offline: true,
     projectRoot: input.projectRoot
   });
@@ -7896,8 +7829,7 @@ async function applyAcceptedBrownfieldProposal(input) {
 async function cmdInit(args) {
   const workspaceInfo = resolveWorkspaceInfo(process.cwd(), args.project);
   if (args.yes && workspaceInfo.requiresProjectSelection) {
-    console.log(error3("This looks like a workspace root with multiple app candidates."));
-    console.log(dim3(`Use --project=<path>. Candidates: ${workspaceInfo.appCandidates.join(", ")}`));
+    printWorkspaceProjectSelection(workspaceInfo, "init");
     process.exitCode = 1;
     return;
   }
@@ -7991,7 +7923,7 @@ async function cmdInit(args) {
     }
   }
   const registryClient = new RegistryClient({
-    cacheDir: join29(projectRoot, ".decantr", "cache"),
+    cacheDir: join28(projectRoot, ".decantr", "cache"),
     apiUrl: args.registry,
     offline: args.offline,
     projectRoot
@@ -8321,7 +8253,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET14}`);
   if (appliedRuleFiles.length > 0) {
     console.log(`    ${dim3(`Rule bridge applied: ${appliedRuleFiles.join(", ")}`)}`);
   }
-  if (!existsSync28(join29(projectRoot, "package.json"))) {
+  if (!existsSync27(join28(projectRoot, "package.json"))) {
     console.log("");
     console.log(
       dim3(`  Note: ${cyan3("decantr init")} created Decantr contract/context files only.`)
@@ -8332,7 +8264,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET14}`);
       )
     );
   }
-  const hasCompiledPacks = existsSync28(join29(projectRoot, ".decantr", "context", "scaffold-pack.md"));
+  const hasCompiledPacks = existsSync27(join28(projectRoot, ".decantr", "context", "scaffold-pack.md"));
   console.log("");
   console.log("  Next steps:");
   if (hasCompiledPacks) {
@@ -8372,7 +8304,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET14}`);
   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 = readFileSync20(result.essencePath, "utf-8");
   const essence = JSON.parse(essenceContent);
   const validation = validateEssence2(essence);
   if (!validation.valid) {
@@ -8428,16 +8360,16 @@ Validation warnings: ${validation.errors.join(", ")}`));
 }
 async function cmdStatus() {
   const projectRoot = process.cwd();
-  const essencePath = join29(projectRoot, "decantr.essence.json");
-  const projectJsonPath = join29(projectRoot, ".decantr", "project.json");
+  const essencePath = join28(projectRoot, "decantr.essence.json");
+  const projectJsonPath = join28(projectRoot, ".decantr", "project.json");
   console.log(heading2("Decantr Project Status"));
-  if (!existsSync28(essencePath)) {
+  if (!existsSync27(essencePath)) {
     console.log(`${RED11}No decantr.essence.json found.${RESET14}`);
     console.log(dim3('Run "decantr init" to create one.'));
     return;
   }
   try {
-    const essence = JSON.parse(readFileSync21(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync20(essencePath, "utf-8"));
     const validation = validateEssence2(essence);
     const essenceVersion = isV48(essence) ? "v4" : "legacy";
     console.log(`${BOLD7}Essence:${RESET14}`);
@@ -8485,9 +8417,9 @@ async function cmdStatus() {
   }
   console.log("");
   console.log(`${BOLD7}Sync Status:${RESET14}`);
-  if (existsSync28(projectJsonPath)) {
+  if (existsSync27(projectJsonPath)) {
     try {
-      const projectJson = JSON.parse(readFileSync21(projectJsonPath, "utf-8"));
+      const projectJson = JSON.parse(readFileSync20(projectJsonPath, "utf-8"));
       const syncStatus = projectJson.sync?.status || "unknown";
       const lastSync = projectJson.sync?.lastSync || "never";
       const source = projectJson.sync?.registrySource || "unknown";
@@ -8505,7 +8437,7 @@ async function cmdStatus() {
 }
 async function cmdSync() {
   const projectRoot = process.cwd();
-  const cacheDir = join29(projectRoot, ".decantr", "cache");
+  const cacheDir = join28(projectRoot, ".decantr", "cache");
   console.log(heading2("Syncing registry content..."));
   const result = await syncRegistry(cacheDir);
   if (result.synced.length > 0) {
@@ -8700,14 +8632,14 @@ ${BOLD7}Examples:${RESET14}
         process.exitCode = 1;
         return;
       }
-      const themePath = join29(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
-      if (!existsSync28(themePath)) {
+      const themePath = join28(projectRoot, ".decantr", "custom", "themes", `${name}.json`);
+      if (!existsSync27(themePath)) {
         console.error(error3(`Theme "${name}" not found at ${themePath}`));
         process.exitCode = 1;
         return;
       }
       try {
-        const theme = JSON.parse(readFileSync21(themePath, "utf-8"));
+        const theme = JSON.parse(readFileSync20(themePath, "utf-8"));
         const result = validateCustomTheme(theme);
         if (result.valid) {
           console.log(success3(`Custom theme "${name}" is valid`));
@@ -8835,12 +8767,69 @@ function withoutWorkflowOnlyFlags(args) {
   }
   return stripped;
 }
-function resolveWorkflowProject(flags) {
+function withProject(command, projectArg) {
+  return projectArg ? `${command} --project ${projectArg}` : command;
+}
+function firstWorkspaceCandidate(workspaceInfo) {
+  return workspaceInfo.appCandidates[0] ?? "apps/web";
+}
+function printWorkspaceProjectSelection(workspaceInfo, commandName = "command") {
+  const candidate = firstWorkspaceCandidate(workspaceInfo);
+  const noun = commandName === "adopt" ? "Brownfield adoption" : `decantr ${commandName}`;
+  console.log(error3(`${noun} needs an app path.`));
+  console.log("");
+  console.log(`${BOLD7}This looks like a monorepo.${RESET14}`);
+  console.log("Install Decantr at the workspace root, then attach it to one app with --project.");
+  console.log("");
+  console.log("App candidates:");
+  for (const appCandidate of workspaceInfo.appCandidates) {
+    console.log(`  ${appCandidate}`);
+  }
+  console.log("");
+  console.log("Start by attaching one app:");
+  console.log(`  ${cyan3(`decantr adopt --project ${candidate} --yes`)}`);
+  console.log("");
+  console.log("Optional visual evidence after the app is running:");
+  console.log(
+    `  ${cyan3(`decantr verify --project ${candidate} --base-url http://localhost:3000 --evidence`)}`
+  );
+}
+function printMonorepoSetupGuidance(workspaceInfo) {
+  const candidate = firstWorkspaceCandidate(workspaceInfo);
+  console.log(heading2("Decantr Setup"));
+  console.log(`${BOLD7}This looks like a monorepo.${RESET14}`);
+  console.log(`  Workspace root: ${workspaceInfo.workspaceRoot}`);
+  console.log("");
+  console.log(
+    "Install Decantr at the workspace root, then attach it to the app you want Decantr to govern."
+  );
+  console.log("");
+  console.log("App candidates:");
+  for (const appCandidate of workspaceInfo.appCandidates) {
+    console.log(`  ${appCandidate}`);
+  }
+  console.log("");
+  console.log(`${BOLD7}Start here:${RESET14}`);
+  console.log(
+    `  ${cyan3("decantr workspace list")}                         Show attached projects and app candidates`
+  );
+  console.log(
+    `  ${cyan3(`decantr adopt --project ${candidate} --yes`)}          Attach Decantr to one app`
+  );
+  console.log(
+    `  ${cyan3(`decantr codify --from-audit --project ${candidate}`)}  Propose project-owned UI law`
+  );
+  console.log("");
+  console.log(`${BOLD7}Optional visual evidence:${RESET14}`);
+  console.log(
+    `  ${cyan3(`decantr verify --project ${candidate} --base-url http://localhost:3000 --evidence`)}`
+  );
+}
+function resolveWorkflowProject(flags, commandName = "command") {
   const projectArg = flagString(flags, "project");
   const workspaceInfo = resolveWorkspaceInfo(process.cwd(), projectArg);
   if (workspaceInfo.requiresProjectSelection) {
-    console.log(error3("This looks like a workspace root with multiple app candidates."));
-    console.log(dim3(`Use --project=<path>. Candidates: ${workspaceInfo.appCandidates.join(", ")}`));
+    printWorkspaceProjectSelection(workspaceInfo, commandName);
     process.exitCode = 1;
     return null;
   }
@@ -8856,8 +8845,17 @@ function printWorkflowPlan(title, steps) {
 }
 async function cmdSetupWorkflow(args) {
   const { flags } = parseLooseArgs(args);
-  const workspaceInfo = resolveWorkflowProject(flags);
-  if (!workspaceInfo) return;
+  const projectArg = flagString(flags, "project");
+  const workspaceInfo = resolveWorkspaceInfo(process.cwd(), projectArg);
+  if (!projectArg && workspaceInfo.workspaceRoot === workspaceInfo.cwd && workspaceInfo.appCandidates.length > 0) {
+    printMonorepoSetupGuidance(workspaceInfo);
+    return;
+  }
+  if (workspaceInfo.requiresProjectSelection) {
+    printWorkspaceProjectSelection(workspaceInfo, "setup");
+    process.exitCode = 1;
+    return;
+  }
   const detected = detectProject(workspaceInfo.appRoot);
   const hasFootprint = detected.framework !== "unknown" || detected.packageManager !== "unknown" || detected.hasTypeScript || detected.hasTailwind || detected.existingRuleFiles.length > 0;
   console.log(heading2("Decantr Setup"));
@@ -8866,18 +8864,30 @@ async function cmdSetupWorkflow(args) {
   console.log("");
   if (detected.existingEssence) {
     console.log(`${BOLD7}Recommended path:${RESET14} maintain an attached Decantr project`);
-    console.log(`  ${cyan3('decantr task <route> "<change>"')}  Prepare LLM context before edits`);
-    console.log(`  ${cyan3("decantr verify --brownfield")}     Run local health and drift checks`);
-    console.log(`  ${cyan3("decantr codify --from-audit")}     Propose project-owned local law`);
+    console.log(
+      `  ${cyan3(withProject('decantr task <route> "<change>"', projectArg))}  Prepare LLM context before edits`
+    );
+    console.log(
+      `  ${cyan3(withProject("decantr verify --brownfield", projectArg))}     Run local health and drift checks`
+    );
+    console.log(
+      `  ${cyan3(withProject("decantr codify --from-audit", projectArg))}     Propose project-owned local law`
+    );
     return;
   }
   if (hasFootprint) {
     console.log(`${BOLD7}Recommended path:${RESET14} brownfield adoption`);
-    console.log(`  ${cyan3("decantr adopt --yes")}                       Analyze, attach, and verify`);
     console.log(
-      `  ${cyan3("decantr adopt --base-url http://localhost:3000 --evidence --yes")}  Include visual evidence`
+      `  ${cyan3(withProject("decantr adopt --yes", projectArg))}                       Analyze, attach, and verify`
+    );
+    console.log(
+      `  ${cyan3(withProject("decantr codify --from-audit", projectArg))}               Propose local UI law`
+    );
+    console.log("");
+    console.log(`${BOLD7}Optional visual evidence after the app is running:${RESET14}`);
+    console.log(
+      `  ${cyan3(withProject("decantr verify --base-url http://localhost:3000 --evidence", projectArg))}`
     );
-    console.log(`  ${cyan3("decantr codify --from-audit")}               Propose local UI law`);
     return;
   }
   console.log(`${BOLD7}Recommended path:${RESET14} greenfield start`);
@@ -8886,9 +8896,10 @@ async function cmdSetupWorkflow(args) {
 }
 async function cmdAdoptWorkflow(args) {
   const { flags } = parseLooseArgs(args);
-  const workspaceInfo = resolveWorkflowProject(flags);
+  const workspaceInfo = resolveWorkflowProject(flags, "adopt");
   if (!workspaceInfo) return;
   const projectRoot = workspaceInfo.appRoot;
+  const projectArg = flagString(flags, "project");
   const dryRun = flagBoolean(flags, "dry-run");
   const yes = flagBoolean(flags, "yes") || flagBoolean(flags, "y");
   const baseUrl = flagString(flags, "base-url");
@@ -8898,7 +8909,7 @@ async function cmdAdoptWorkflow(args) {
   const saveBaseline = flagBoolean(flags, "baseline", true) || flagBoolean(flags, "save-baseline");
   const initCi = flagBoolean(flags, "ci") || flagBoolean(flags, "init-ci");
   const assistantBridge = flagString(flags, "assistant-bridge");
-  const hasEssence = existsSync28(join29(projectRoot, "decantr.essence.json"));
+  const hasEssence = existsSync27(join28(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",
@@ -8959,11 +8970,21 @@ async function cmdAdoptWorkflow(args) {
   }
   console.log("");
   console.log(`${BOLD7}Brownfield operating loop:${RESET14}`);
-  console.log(`  ${cyan3("decantr codify --from-audit")}          Discover and propose project-owned UI law`);
-  console.log(`  ${cyan3("decantr codify --accept")}              Accept reviewed local patterns and rules`);
-  console.log(`  ${cyan3('decantr task <route> "<change>"')}      Give your LLM route-specific context before edits`);
-  console.log(`  ${cyan3("decantr verify --brownfield --local-patterns")}  Check contract, health, and local law after edits`);
-  console.log(`  ${cyan3("decantr verify --since-baseline")}      Compare future work against this baseline`);
+  console.log(
+    `  ${cyan3(withProject("decantr codify --from-audit", projectArg))}          Discover and propose project-owned UI law`
+  );
+  console.log(
+    `  ${cyan3(withProject("decantr codify --accept", projectArg))}              Accept reviewed local patterns and rules`
+  );
+  console.log(
+    `  ${cyan3(withProject('decantr task <route> "<change>"', projectArg))}      Give your LLM route-specific context before edits`
+  );
+  console.log(
+    `  ${cyan3(withProject("decantr verify --brownfield --local-patterns", projectArg))}  Check contract, health, and local law after edits`
+  );
+  console.log(
+    `  ${cyan3(withProject("decantr verify --since-baseline", projectArg))}      Compare future work against this baseline`
+  );
 }
 async function cmdVerifyWorkflow(args) {
   const { flags } = parseLooseArgs(args);
@@ -8974,11 +8995,11 @@ async function cmdVerifyWorkflow(args) {
     return;
   }
   if (workspaceMode) {
-    const { cmdWorkspace } = await import("./workspace-KSFWRZEX.js");
+    const { cmdWorkspace } = await import("./workspace-U7J3CJY3.js");
     await cmdWorkspace(process.cwd(), ["workspace", "health", ...withoutWorkflowOnlyFlags(args)]);
     return;
   }
-  const workspaceInfo = resolveWorkflowProject(flags);
+  const workspaceInfo = resolveWorkflowProject(flags, "verify");
   if (!workspaceInfo) return;
   const brownfield = flagBoolean(flags, "brownfield");
   const localPatterns = flagBoolean(flags, "local-patterns");
@@ -9072,29 +9093,35 @@ async function cmdVerifyWorkflow(args) {
   }
 }
 function readJsonIfPresent(path) {
-  if (!existsSync28(path)) return null;
+  if (!existsSync27(path)) return null;
   try {
-    return JSON.parse(readFileSync21(path, "utf-8"));
+    return JSON.parse(readFileSync20(path, "utf-8"));
   } catch {
     return null;
   }
 }
 async function cmdTaskWorkflow(args) {
   const { flags, positional } = parseLooseArgs(args);
-  const workspaceInfo = resolveWorkflowProject(flags);
+  const workspaceInfo = resolveWorkflowProject(flags, "task");
   if (!workspaceInfo) return;
   const routeInput = positional[0];
   if (!routeInput) {
-    console.error(error3('Usage: decantr task <route> ["task summary"] [--project <path>] [--since origin/main] [--json]'));
+    console.error(
+      error3(
+        'Usage: decantr task <route> ["task summary"] [--project <path>] [--since origin/main] [--json]'
+      )
+    );
     process.exitCode = 1;
     return;
   }
   const route = routeInput.startsWith("/") ? routeInput : `/${routeInput}`;
   const taskSummary = positional.slice(1).join(" ").trim();
-  const essencePath = join29(workspaceInfo.appRoot, "decantr.essence.json");
+  const essencePath = join28(workspaceInfo.appRoot, "decantr.essence.json");
   const essence = readJsonIfPresent(essencePath);
   if (!essence) {
-    console.error(error3("No decantr.essence.json found. Run `decantr adopt` or `decantr init` first."));
+    console.error(
+      error3("No decantr.essence.json found. Run `decantr adopt` or `decantr init` first.")
+    );
     process.exitCode = 1;
     return;
   }
@@ -9113,11 +9140,11 @@ 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 = join29(workspaceInfo.appRoot, ".decantr", "context");
-  const manifest = readJsonIfPresent(join29(contextDir, "pack-manifest.json"));
+  const contextDir = join28(workspaceInfo.appRoot, ".decantr", "context");
+  const manifest = readJsonIfPresent(join28(contextDir, "pack-manifest.json"));
   const pagePack = manifest?.pages?.find((entry) => entry.id === target.page);
   const sectionPack = manifest?.sections?.find((entry) => entry.id === target.section);
-  const visualManifest = readJsonIfPresent(join29(workspaceInfo.appRoot, ".decantr", "evidence", "visual-manifest.json"));
+  const visualManifest = readJsonIfPresent(join28(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);
@@ -9133,13 +9160,13 @@ async function cmdTaskWorkflow(args) {
     shell: page?.shell ?? section?.shell ?? null,
     patterns: page?.layout?.map(extractPatternName) ?? [],
     read: [
-      pagePack ? join29(".decantr/context", pagePack.markdown) : null,
-      sectionPack ? join29(".decantr/context", sectionPack.markdown) : null,
-      manifest?.scaffold?.markdown ? join29(".decantr/context", manifest.scaffold.markdown) : null,
+      pagePack ? join28(".decantr/context", pagePack.markdown) : null,
+      sectionPack ? join28(".decantr/context", sectionPack.markdown) : null,
+      manifest?.scaffold?.markdown ? join28(".decantr/context", manifest.scaffold.markdown) : null,
       ".decantr/context/scaffold.md",
       "DECANTR.md",
-      existsSync28(localPatternPackPath) ? ".decantr/local-patterns.json" : null,
-      existsSync28(localRuleManifestPath) ? ".decantr/rules.json" : null
+      existsSync27(localPatternPackPath) ? ".decantr/local-patterns.json" : null,
+      existsSync27(localRuleManifestPath) ? ".decantr/rules.json" : null
     ].filter(Boolean),
     screenshot: screenshot ?? null,
     localLaw,
@@ -9171,7 +9198,9 @@ async function cmdTaskWorkflow(args) {
     console.log("");
     console.log(`${BOLD7}Project-owned local law:${RESET14}`);
     if (context.localLaw.patternsPath) {
-      console.log(`  Patterns: ${cyan3(context.localLaw.patternsPath)} (${context.localLaw.patternCount})`);
+      console.log(
+        `  Patterns: ${cyan3(context.localLaw.patternsPath)} (${context.localLaw.patternCount})`
+      );
     }
     if (context.localLaw.rulesPath) {
       console.log(`  Rules: ${cyan3(context.localLaw.rulesPath)} (${context.localLaw.ruleCount})`);
@@ -9183,7 +9212,9 @@ async function cmdTaskWorkflow(args) {
   } else {
     console.log("");
     console.log(`${BOLD7}Project-owned local law:${RESET14}`);
-    console.log(`  ${YELLOW9}Not codified yet.${RESET14} Run ${cyan3("decantr codify --from-audit")} after adoption.`);
+    console.log(
+      `  ${YELLOW9}Not codified yet.${RESET14} Run ${cyan3("decantr codify --from-audit")} after adoption.`
+    );
   }
   if (context.changedFiles.length > 0) {
     console.log("");
@@ -9207,12 +9238,14 @@ async function cmdTaskWorkflow(args) {
 }
 async function cmdCodifyWorkflow(args) {
   const { flags } = parseLooseArgs(args);
-  const workspaceInfo = resolveWorkflowProject(flags);
+  const workspaceInfo = resolveWorkflowProject(flags, "codify");
   if (!workspaceInfo) return;
   if (flagBoolean(flags, "accept")) {
-    if (!existsSync28(localPatternsProposalPath(workspaceInfo.appRoot)) && !existsSync28(localRulesProposalPath(workspaceInfo.appRoot))) {
+    if (!existsSync27(localPatternsProposalPath(workspaceInfo.appRoot)) && !existsSync27(localRulesProposalPath(workspaceInfo.appRoot))) {
       console.error(
-        error3("No local law proposal found. Run `decantr codify --from-audit` or `decantr codify` first.")
+        error3(
+          "No local law proposal found. Run `decantr codify --from-audit` or `decantr codify` first."
+        )
       );
       process.exitCode = 1;
       return;
@@ -9228,7 +9261,9 @@ async function cmdCodifyWorkflow(args) {
     return;
   }
   const detected = detectProject(workspaceInfo.appRoot);
-  const essence = readJsonIfPresent(join29(workspaceInfo.appRoot, "decantr.essence.json"));
+  const essence = readJsonIfPresent(
+    join28(workspaceInfo.appRoot, "decantr.essence.json")
+  );
   const fromAudit = flagBoolean(flags, "from-audit") || flagBoolean(flags, "discover-local-patterns") || flagBoolean(flags, "codify-local-patterns");
   const proposal = createBrownfieldCodifyProposal({
     projectRoot: workspaceInfo.appRoot,
@@ -9240,15 +9275,24 @@ async function cmdCodifyWorkflow(args) {
   console.log(success3(`Wrote local pattern proposal: ${result.patternPath}`));
   console.log(success3(`Wrote local rule proposal: ${result.rulesPath}`));
   if (fromAudit) {
-    console.log(dim3("Proposal includes source-derived component candidates and starter mechanical rules."));
+    console.log(
+      dim3("Proposal includes source-derived component candidates and starter mechanical rules.")
+    );
   }
-  console.log(dim3("Review both files, add real component paths/token recipes, then run `decantr codify --accept`."));
+  console.log(
+    dim3(
+      "Review both files, add real component paths/token recipes, then run `decantr codify --accept`."
+    )
+  );
 }
 async function cmdContentWorkflow(args) {
   const subcommand = args[1] ?? "check";
   if (subcommand === "check" || subcommand === "health") {
     const { cmdContentHealth, parseContentHealthArgs } = await import("./content-health-QQHBR6XG.js");
-    await cmdContentHealth(process.cwd(), parseContentHealthArgs(["content-health", ...args.slice(2)]));
+    await cmdContentHealth(
+      process.cwd(),
+      parseContentHealthArgs(["content-health", ...args.slice(2)])
+    );
     return;
   }
   if (subcommand === "create") {
@@ -9397,9 +9441,11 @@ ${BOLD7}Advanced commands:${RESET14}
 ${BOLD7}Examples:${RESET14}
   decantr setup
   decantr new my-app --blueprint=carbon-ai-portal
-  decantr adopt --base-url http://localhost:3000 --evidence --yes
+  decantr adopt --yes
+  decantr adopt --project apps/web --yes
   decantr task /feed "add saved recipe actions"
   decantr verify --brownfield --local-patterns
+  decantr verify --base-url http://localhost:3000 --evidence
   decantr verify --since-baseline
   decantr codify --from-audit
   decantr codify --accept
@@ -9451,7 +9497,8 @@ ${BOLD7}Examples:${RESET14}
 ${BOLD7}Workflow Model:${RESET14}
   ${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 --base-url <url> --evidence --yes
+  ${cyan3("Brownfield adoption")}    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("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
@@ -9526,7 +9573,7 @@ ${BOLD7}Examples:${RESET14}
 }
 function cmdWorkspaceHelp() {
   console.log(`
-${BOLD7}decantr workspace${RESET14} \u2014 Inspect Decantr projects across a monorepo
+${BOLD7}decantr workspace${RESET14} \u2014 Inspect Decantr projects and app candidates across a monorepo
 
 ${BOLD7}Usage:${RESET14}
   decantr workspace list [--json]
@@ -9535,6 +9582,7 @@ ${BOLD7}Usage:${RESET14}
 
 ${BOLD7}Examples:${RESET14}
   decantr workspace list
+  decantr adopt --project apps/web --yes
   decantr workspace health
   decantr workspace health --json --output .decantr/workspace-health.json
   decantr workspace health --changed --since origin/main
@@ -9638,7 +9686,7 @@ ${BOLD7}decantr adopt${RESET14} \u2014 Brownfield one-liner: analyze, attach, ve
 
 ${BOLD7}Usage:${RESET14}
   decantr adopt [--project <path>] [--yes] [--dry-run]
-  decantr adopt --base-url <url> [--evidence] [--ci] [--yes]
+  decantr adopt [--project <path>] --base-url <url> [--evidence] [--ci] [--yes]
 
 ${BOLD7}Options:${RESET14}
   --project           App path inside a workspace/monorepo
@@ -9656,9 +9704,10 @@ ${BOLD7}Options:${RESET14}
 
 ${BOLD7}Examples:${RESET14}
   decantr adopt --yes
-  decantr adopt --base-url http://localhost:3000 --evidence --yes
+  decantr adopt --project apps/web --yes
+  decantr adopt --project apps/web --base-url http://localhost:3000 --evidence --yes
   decantr adopt --project apps/web --ci --yes
-  decantr codify --from-audit
+  decantr codify --from-audit --project apps/web
 `);
 }
 function cmdVerifyHelp() {
@@ -9675,6 +9724,7 @@ ${BOLD7}Usage:${RESET14}
 ${BOLD7}Examples:${RESET14}
   decantr verify
   decantr verify --brownfield --local-patterns
+  decantr verify --brownfield --local-patterns --project apps/web
   decantr verify --brownfield --local-patterns --fail-on warn
   decantr verify --base-url http://localhost:3000 --evidence
   decantr verify --workspace --changed --since origin/main
@@ -9780,11 +9830,11 @@ async function main() {
   }
   if (command === "--version" || command === "-v" || command === "version") {
     try {
-      const here = dirname4(fileURLToPath2(import.meta.url));
-      const candidates = [join29(here, "..", "package.json"), join29(here, "..", "..", "package.json")];
+      const here = dirname3(fileURLToPath2(import.meta.url));
+      const candidates = [join28(here, "..", "package.json"), join28(here, "..", "..", "package.json")];
       for (const candidate of candidates) {
-        if (existsSync28(candidate)) {
-          const pkg = JSON.parse(readFileSync21(candidate, "utf-8"));
+        if (existsSync27(candidate)) {
+          const pkg = JSON.parse(readFileSync20(candidate, "utf-8"));
           if (pkg.version) {
             console.log(pkg.version);
             return;
@@ -9963,7 +10013,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-MKLBUC3A.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-G3YOU5YF.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error3(e.message));
@@ -9977,7 +10027,7 @@ async function main() {
           cmdWorkspaceHelp();
           break;
         }
-        const { cmdWorkspace } = await import("./workspace-KSFWRZEX.js");
+        const { cmdWorkspace } = await import("./workspace-U7J3CJY3.js");
         await cmdWorkspace(process.cwd(), args);
       } catch (e) {
         console.error(error3(e.message));
@@ -10257,7 +10307,7 @@ async function main() {
           break;
         }
         if (packType === "page" && route && !id) {
-          const resolvedPath = essencePath ? resolveUserPath(essencePath) : join29(process.cwd(), "decantr.essence.json");
+          const resolvedPath = essencePath ? resolveUserPath(essencePath) : join28(process.cwd(), "decantr.essence.json");
           id = resolvePagePackIdForRoute(resolvedPath, route);
         }
         await printHostedSelectedExecutionPack(
@@ -10413,10 +10463,7 @@ async function main() {
       }
       const workspaceInfo = resolveWorkspaceInfo(process.cwd(), projectArg);
       if (workspaceInfo.requiresProjectSelection) {
-        console.log(error3("This looks like a workspace root with multiple app candidates."));
-        console.log(
-          dim3(`Use --project=<path>. Candidates: ${workspaceInfo.appCandidates.join(", ")}`)
-        );
+        printWorkspaceProjectSelection(workspaceInfo, "analyze");
         process.exitCode = 1;
         break;
       }
@@ -10443,6 +10490,11 @@ async function main() {
         }
       }
       const workspaceInfo = resolveWorkspaceInfo(process.cwd(), projectArg);
+      if (workspaceInfo.requiresProjectSelection) {
+        printWorkspaceProjectSelection(workspaceInfo, "rules");
+        process.exitCode = 1;
+        break;
+      }
       const detected = detectProject(workspaceInfo.appRoot);
       if (subcommand === "preview") {
         console.log(