@decantr/cli 1.7.7 → 1.7.8

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-OHQXL7EJ.js";
-import "./chunk-4D5V6GQU.js";
+import "./chunk-ODJQZXHQ.js";
+import "./chunk-74G2RQDO.js";
 import "./chunk-KUDAVJOR.js";

package/dist/{chunk-4D5V6GQU.js → chunk-74G2RQDO.js}

@@ -1375,7 +1375,23 @@ function generateDecantrMdV31(params) {
   const template = loadTemplate("DECANTR.md.template");
   const body = renderTemplate(template, {
     GUARD_MODE: params.guardMode,
-    CSS_APPROACH: params.cssApproach
+    CSS_APPROACH: params.cssApproach,
+    WORKFLOW_MODE: params.workflowMode === "brownfield-attach" ? "brownfield attach" : "greenfield scaffold",
+    WORKFLOW_GUIDANCE: params.workflowMode === "brownfield-attach" ? `This project is using Decantr in **brownfield attach** mode.
+
+Read \`.decantr/analysis.json\` first for the detected framework, routes, styling, layout, and dependency facts.
+Then read \`.decantr/init-seed.json\` for the recommended attach defaults.
+Then read \`.decantr/context/scaffold-pack.md\` and \`.decantr/context/scaffold.md\` to understand the Decantr contract you are layering onto the existing app.
+
+Preserve the current framework, package manager, router, and working runtime structure unless the contract gives you a reviewed reason to change them. Map existing routes and components onto the declared Decantr sections/pages before creating new files. Registry content is optional in this workflow unless the task explicitly asks for it.` : `This project is using Decantr in **greenfield scaffold** mode.
+
+Treat the compiled execution-pack files as the primary source of truth.
+Use narrative docs only as secondary explanation when the compiled packs are not enough.
+Use only files present in this workspace as the source of truth. If local scaffold files disagree, stop and report the mismatch instead of relying on external Decantr assumptions or prior examples.
+
+Read \`.decantr/context/scaffold-pack.md\` first for the compact compiled shell, theme, feature, and route contract.
+Then read \`.decantr/context/scaffold.md\` for the fuller app overview, topology, route map, and voice guidance.
+Start implementation from the shell layouts and shared route structure before filling in section pages.`
   });
   const briefLines = [];
   briefLines.push("## Project Brief");
@@ -1383,6 +1399,7 @@ function generateDecantrMdV31(params) {
   briefLines.push(`- **Blueprint:** ${params.blueprintId || "custom"}`);
   const themeDesc = `${params.themeName || "default"} (${params.themeMode || "dark"} mode${params.themeShape ? `, ${params.themeShape} shape` : ""})`;
   briefLines.push(`- **Theme:** ${themeDesc}`);
+  briefLines.push(`- **Workflow:** ${params.workflowMode === "brownfield-attach" ? "brownfield attach" : "greenfield scaffold"}`);
   if (params.personality && params.personality.length > 0) {
     briefLines.push(`- **Personality:** ${params.personality.join(". ")}`);
   }
@@ -1469,7 +1486,8 @@ function generateProjectJson(detected, options, registrySource) {
       at: now,
       via: "cli",
       version: CLI_VERSION,
-      flags: buildFlagsString(options)
+      flags: buildFlagsString(options),
+      workflowMode: options.workflowMode || "greenfield-scaffold"
     }
   };
   if (options.blueprint) {
@@ -1909,7 +1927,8 @@ function scaffoldMinimal(projectRoot) {
       at: now,
       via: "cli",
       version: CLI_VERSION,
-      flags: "--offline --minimal"
+      flags: "--offline --minimal",
+      workflowMode: "greenfield-scaffold"
     }
   };
   const projectJsonPath = join(decantrDir, "project.json");
@@ -2109,6 +2128,7 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
   mkdirSync(contextDir, { recursive: true });
   let storedBlueprintId;
   let storedVoice;
+  let storedWorkflowMode;
   const projectJsonFilePath = join(decantrDir, "project.json");
   let projectJsonData = {};
   if (existsSync(projectJsonFilePath)) {
@@ -2116,6 +2136,7 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
       projectJsonData = JSON.parse(readFileSync(projectJsonFilePath, "utf-8"));
       if (projectJsonData.blueprintId) storedBlueprintId = projectJsonData.blueprintId;
       if (projectJsonData.voice) storedVoice = projectJsonData.voice;
+      if (projectJsonData.initialized?.workflowMode) storedWorkflowMode = projectJsonData.initialized.workflowMode;
     } catch {
     }
   }
@@ -2234,6 +2255,7 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
   writeFileSync(decantrMdPath, generateDecantrMdV31({
     guardMode,
     cssApproach: CSS_APPROACH_CONTENT,
+    workflowMode: storedWorkflowMode,
     blueprintId: storedBlueprintId || getLegacyBlueprintId(essence.meta) || void 0,
     themeName,
     themeMode: mode,

package/dist/{chunk-OHQXL7EJ.js → chunk-ODJQZXHQ.js}

@@ -14,13 +14,13 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-4D5V6GQU.js";
+} from "./chunk-74G2RQDO.js";
 import {
   buildGuardRegistryContext
 } from "./chunk-KUDAVJOR.js";
 
 // src/index.ts
-import { mkdirSync as mkdirSync10, readFileSync as readFileSync17, writeFileSync as writeFileSync13, existsSync as existsSync25, readdirSync as readdirSync6 } from "fs";
+import { mkdirSync as mkdirSync10, readFileSync as readFileSync18, writeFileSync as writeFileSync13, existsSync as existsSync25, readdirSync as readdirSync6 } from "fs";
 import { basename as basename2, join as join26, dirname as dirname2, isAbsolute, resolve as resolve3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { validateEssence as validateEssence2, evaluateGuard, isV3 as isV36 } from "@decantr/essence-spec";
@@ -343,7 +343,8 @@ async function runInteractivePrompts(detected, archetypes, blueprints, themes, w
     shell,
     personality: ["professional"],
     features: [],
-    existing: workflowSeed?.existing || detected.existingEssence
+    existing: workflowSeed?.existing || detected.existingEssence,
+    workflowMode: workflowSeed?.workflowMode
   };
 }
 function parseFlags(args, detected) {
@@ -375,7 +376,8 @@ function mergeWithDefaults(flags, detected, workflowSeed) {
     shell: flags.shell || workflowSeed?.shell || "sidebar-main",
     personality: flags.personality || ["professional"],
     features: flags.features || [],
-    existing: flags.existing || workflowSeed?.existing || detected.existingEssence
+    existing: flags.existing || workflowSeed?.existing || detected.existingEssence,
+    workflowMode: flags.workflowMode || workflowSeed?.workflowMode
   };
 }
 async function runSimplifiedInit(blueprints) {
@@ -1539,7 +1541,7 @@ import { existsSync as existsSync19, mkdirSync as mkdirSync4, writeFileSync as w
 import { join as join19 } from "path";
 
 // src/analyzers/routes.ts
-import { existsSync as existsSync12, readdirSync as readdirSync2, statSync } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync11, readdirSync as readdirSync2, statSync } from "fs";
 import { join as join12, relative } from "path";
 var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".next", ".git", "api", "_app", "_document"]);
 function shouldSkipDir(name) {
@@ -1630,6 +1632,75 @@ function walkPagesDir(dir, baseDir, segments) {
   }
   return routes;
 }
+var ROUTER_FILE_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".ts", ".jsx", ".js"]);
+function collectRouteCandidateFiles(dir, files, depth = 0) {
+  if (depth > 5) return;
+  let entries;
+  try {
+    entries = readdirSync2(dir);
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (entry.startsWith(".") || entry === "node_modules") continue;
+    const fullPath = join12(dir, entry);
+    try {
+      const stat = statSync(fullPath);
+      if (stat.isDirectory()) {
+        collectRouteCandidateFiles(fullPath, files, depth + 1);
+      } else if (stat.isFile()) {
+        const ext = entry.slice(entry.lastIndexOf("."));
+        if (ROUTER_FILE_EXTENSIONS.has(ext)) {
+          files.push(fullPath);
+        }
+      }
+    } catch {
+      continue;
+    }
+  }
+}
+function scanReactRouter(projectRoot) {
+  const candidateDirs = [
+    join12(projectRoot, "src"),
+    projectRoot
+  ];
+  const candidateFiles = [];
+  for (const dir of candidateDirs) {
+    if (existsSync12(dir)) collectRouteCandidateFiles(dir, candidateFiles);
+  }
+  const routeMap = /* @__PURE__ */ new Map();
+  for (const absolutePath of candidateFiles) {
+    let content;
+    try {
+      content = readFileSync11(absolutePath, "utf-8");
+    } catch {
+      continue;
+    }
+    const isReactRouterFile = content.includes("react-router-dom") || content.includes("react-router") || content.includes("<Routes") || content.includes("createBrowserRouter") || content.includes("createHashRouter") || content.includes("RouterProvider") || content.includes("HashRouter") || content.includes("BrowserRouter");
+    if (!isReactRouterFile) continue;
+    const relativePath = relative(projectRoot, absolutePath);
+    const pathMatches = /* @__PURE__ */ new Set();
+    for (const match of content.matchAll(/<Route\b[^>]*\bpath=["'`]([^"'`]+)["'`]/g)) {
+      pathMatches.add(match[1]);
+    }
+    for (const match of content.matchAll(/\bpath\s*:\s*["'`]([^"'`]+)["'`]/g)) {
+      pathMatches.add(match[1]);
+    }
+    if (pathMatches.size === 0 && (content.includes("<Routes") || content.includes("RouterProvider"))) {
+      pathMatches.add("/");
+    }
+    for (const path of pathMatches) {
+      if (!routeMap.has(path)) {
+        routeMap.set(path, {
+          path,
+          file: relativePath,
+          hasLayout: false
+        });
+      }
+    }
+  }
+  return [...routeMap.values()];
+}
 function scanRoutes(projectRoot) {
   const appDirs = [
     join12(projectRoot, "src", "app"),
@@ -1655,6 +1726,10 @@ function scanRoutes(projectRoot) {
       }
     }
   }
+  const reactRouterRoutes = scanReactRouter(projectRoot);
+  if (reactRouterRoutes.length > 0) {
+    return { strategy: "react-router", routes: reactRouterRoutes };
+  }
   return { strategy: "none", routes: [] };
 }
 
@@ -1662,6 +1737,16 @@ function scanRoutes(projectRoot) {
 import { existsSync as existsSync13, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
 import { join as join13 } from "path";
 var PAGE_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".ts", ".jsx", ".js"]);
+var ROOT_COMPONENT_CANDIDATES = [
+  "src/App.tsx",
+  "src/App.ts",
+  "src/App.jsx",
+  "src/App.js",
+  "App.tsx",
+  "App.ts",
+  "App.jsx",
+  "App.js"
+];
 function countFilesRecursive(dir, extensions) {
   let count = 0;
   let entries;
@@ -1753,6 +1838,18 @@ function scanComponents(projectRoot) {
       }
     }
   }
+  const hasRootAppComponent = ROOT_COMPONENT_CANDIDATES.some(
+    (relativePath) => existsSync13(join13(projectRoot, relativePath))
+  );
+  if (pageCount === 0 && hasRootAppComponent) {
+    pageCount = 1;
+  }
+  if (componentCount === 0 && hasRootAppComponent) {
+    componentCount = 1;
+    if (!componentDirs.includes("src")) {
+      componentDirs.push("src");
+    }
+  }
   return {
     pageCount,
     componentCount,
@@ -1761,7 +1858,7 @@ function scanComponents(projectRoot) {
 }
 
 // src/analyzers/styling.ts
-import { existsSync as existsSync14, readFileSync as readFileSync11 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync12 } from "fs";
 import { join as join14 } from "path";
 var TAILWIND_CONFIGS = [
   "tailwind.config.js",
@@ -1772,11 +1869,17 @@ var TAILWIND_CONFIGS = [
 var GLOBALS_CSS_PATHS = [
   "src/app/globals.css",
   "app/globals.css",
+  "src/styles/global.css",
   "src/styles/globals.css",
   "styles/globals.css",
   "src/index.css",
   "src/global.css"
 ];
+var DECANTR_STYLE_PATHS = [
+  "src/styles/tokens.css",
+  "src/styles/treatments.css",
+  "src/styles/global.css"
+];
 function extractCSSVariables(content) {
   const colors = {};
   const variables = [];
@@ -1793,8 +1896,8 @@ function extractCSSVariables(content) {
   }
   return { colors, variables };
 }
-function detectDarkMode(projectRoot, cssContent) {
-  if (cssContent) {
+function detectDarkMode(projectRoot, cssContents) {
+  for (const cssContent of cssContents) {
     if (cssContent.includes(".dark") || cssContent.includes('[data-theme="dark"]') || cssContent.includes("prefers-color-scheme: dark") || cssContent.includes("color-scheme: dark")) {
       return true;
     }
@@ -1809,7 +1912,7 @@ function detectDarkMode(projectRoot, cssContent) {
     const fullPath = join14(projectRoot, rel);
     if (existsSync14(fullPath)) {
       try {
-        const layoutContent = readFileSync11(fullPath, "utf-8");
+        const layoutContent = readFileSync12(fullPath, "utf-8");
         if (layoutContent.includes('className="dark"') || layoutContent.includes("className='dark'") || layoutContent.includes('class="dark"')) {
           return true;
         }
@@ -1820,7 +1923,7 @@ function detectDarkMode(projectRoot, cssContent) {
   const pkgPath = join14(projectRoot, "package.json");
   if (existsSync14(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
       const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
       if (allDeps["next-themes"] || allDeps["theme-toggle"] || allDeps["use-dark-mode"]) {
         return true;
@@ -1828,6 +1931,17 @@ function detectDarkMode(projectRoot, cssContent) {
     } catch {
     }
   }
+  const essencePath = join14(projectRoot, "decantr.essence.json");
+  if (existsSync14(essencePath)) {
+    try {
+      const essence = JSON.parse(readFileSync12(essencePath, "utf-8"));
+      const mode = essence.dna?.theme?.mode;
+      if (mode === "dark" || mode === "auto") {
+        return true;
+      }
+    } catch {
+    }
+  }
   return false;
 }
 function scanStyling(projectRoot) {
@@ -1844,8 +1958,12 @@ function scanStyling(projectRoot) {
     const pkgPath = join14(projectRoot, "package.json");
     if (existsSync14(pkgPath)) {
       try {
-        const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
+        const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
         const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+        if (allDeps["@decantr/css"]) {
+          approach = "decantr-css";
+          configFile = "src/styles/tokens.css";
+        }
         if (allDeps.tailwindcss || allDeps["@tailwindcss/postcss"] || allDeps["@tailwindcss/vite"]) {
           approach = "tailwind";
         }
@@ -1853,25 +1971,44 @@ function scanStyling(projectRoot) {
       }
     }
   }
-  let cssContent = null;
+  const decantrStyleFiles = DECANTR_STYLE_PATHS.filter((rel) => existsSync14(join14(projectRoot, rel)));
+  if (decantrStyleFiles.length >= 2) {
+    approach = "decantr-css";
+    configFile = decantrStyleFiles.join(" + ");
+  }
+  const cssContents = [];
   for (const rel of GLOBALS_CSS_PATHS) {
     const fullPath = join14(projectRoot, rel);
     if (existsSync14(fullPath)) {
       try {
-        cssContent = readFileSync11(fullPath, "utf-8");
+        cssContents.push(readFileSync12(fullPath, "utf-8"));
+      } catch {
+      }
+    }
+  }
+  for (const rel of DECANTR_STYLE_PATHS) {
+    if (GLOBALS_CSS_PATHS.includes(rel)) continue;
+    const fullPath = join14(projectRoot, rel);
+    if (existsSync14(fullPath)) {
+      try {
+        cssContents.push(readFileSync12(fullPath, "utf-8"));
       } catch {
       }
-      break;
     }
   }
   let colors = {};
   let cssVariables = [];
-  if (cssContent) {
+  for (const cssContent of cssContents) {
     const extracted = extractCSSVariables(cssContent);
-    colors = extracted.colors;
-    cssVariables = extracted.variables;
+    colors = { ...colors, ...extracted.colors };
+    cssVariables.push(...extracted.variables);
+  }
+  cssVariables = [...new Set(cssVariables)];
+  const darkMode = detectDarkMode(projectRoot, cssContents);
+  if (approach === "unknown" && cssContents.length > 0) {
+    approach = "css";
+    configFile = GLOBALS_CSS_PATHS.find((rel) => existsSync14(join14(projectRoot, rel)));
   }
-  const darkMode = detectDarkMode(projectRoot, cssContent);
   return {
     approach,
     configFile,
@@ -1882,7 +2019,7 @@ function scanStyling(projectRoot) {
 }
 
 // src/analyzers/layout.ts
-import { existsSync as existsSync15, readFileSync as readFileSync12, readdirSync as readdirSync4 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync13, readdirSync as readdirSync4 } from "fs";
 import { join as join15 } from "path";
 var SIDEBAR_PATTERNS = ["sidebar", "side-bar", "sidenav", "side-nav", "drawer", "aside"];
 var NAV_PATTERNS = ["nav", "navbar", "header", "top-bar", "topbar", "app-bar", "appbar"];
@@ -1927,7 +2064,7 @@ function checkLayoutFiles(projectRoot) {
     if (!existsSync15(layoutPath)) continue;
     let content;
     try {
-      content = readFileSync12(layoutPath, "utf-8");
+      content = readFileSync13(layoutPath, "utf-8");
     } catch {
       continue;
     }
@@ -1947,7 +2084,7 @@ function checkLayoutFiles(projectRoot) {
       if (!existsSync15(layoutPath)) continue;
       let content;
       try {
-        content = readFileSync12(layoutPath, "utf-8");
+        content = readFileSync13(layoutPath, "utf-8");
       } catch {
         continue;
       }
@@ -1968,17 +2105,40 @@ function inferShellPattern(hasSidebar, hasTopNav, hasFooter) {
   if (hasFooter) return "main-footer";
   return "main-only";
 }
+function inferShellPatternFromDecantrContract(projectRoot) {
+  const essencePath = join15(projectRoot, "decantr.essence.json");
+  if (!existsSync15(essencePath)) return null;
+  try {
+    const essence = JSON.parse(readFileSync13(essencePath, "utf-8"));
+    const sectionShells = essence.blueprint?.sections?.map((section) => section.shell).filter((shell) => typeof shell === "string" && shell.length > 0) ?? [];
+    if (sectionShells.length === 0 && essence.blueprint?.shell) {
+      return `${essence.blueprint.shell} (contract)`;
+    }
+    const uniqueShells = [...new Set(sectionShells)];
+    if (uniqueShells.length === 0) return null;
+    if (uniqueShells.length === 1) return `${uniqueShells[0]} (contract)`;
+    const primarySection = essence.blueprint?.sections?.find((section) => section.role === "primary" && section.shell);
+    if (primarySection?.shell) {
+      return `${primarySection.shell} (primary contract)`;
+    }
+    return `${uniqueShells[0]} (+${uniqueShells.length - 1} shells, contract)`;
+  } catch {
+    return null;
+  }
+}
 function scanLayout(projectRoot) {
   const fromComponents = checkComponentDirs(projectRoot);
   const fromLayouts = checkLayoutFiles(projectRoot);
   const hasSidebar = fromComponents.sidebar || fromLayouts.sidebar;
   const hasTopNav = fromComponents.nav || fromLayouts.nav;
   const hasFooter = fromComponents.footer || fromLayouts.footer;
+  const runtimeShellPattern = inferShellPattern(hasSidebar, hasTopNav, hasFooter);
+  const contractShellPattern = inferShellPatternFromDecantrContract(projectRoot);
   return {
     hasSidebar,
     hasTopNav,
     hasFooter,
-    shellPattern: inferShellPattern(hasSidebar, hasTopNav, hasFooter)
+    shellPattern: runtimeShellPattern === "main-only" && contractShellPattern ? contractShellPattern : runtimeShellPattern
   };
 }
 
@@ -2062,12 +2222,14 @@ function scanFeatures(projectRoot) {
 }
 
 // src/analyzers/dependencies.ts
-import { existsSync as existsSync17, readFileSync as readFileSync13 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync14 } from "fs";
 import { join as join17 } from "path";
 var CATEGORIES = {
   ui: [
     "react",
     "react-dom",
+    "react-router",
+    "react-router-dom",
     "vue",
     "svelte",
     "@angular/core",
@@ -2215,7 +2377,7 @@ function scanDependencies(projectRoot) {
   if (!existsSync17(pkgPath)) return result;
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
+    pkg = JSON.parse(readFileSync14(pkgPath, "utf-8"));
   } catch {
     return result;
   }
@@ -2235,7 +2397,7 @@ function scanDependencies(projectRoot) {
 }
 
 // src/workflow-model.ts
-import { existsSync as existsSync18, readFileSync as readFileSync14 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync15 } from "fs";
 import { join as join18 } from "path";
 function inferSuggestedShell(layout) {
   if (layout.hasSidebar) return "sidebar-main";
@@ -2251,6 +2413,7 @@ function createBrownfieldInitSeed(detected, layout, styling) {
     workflow: "brownfield-adoption",
     contractOnly: true,
     registryOptional: true,
+    workflowMode: "brownfield-attach",
     target: detected.framework !== "unknown" ? detected.framework : "react",
     shell: inferSuggestedShell(layout),
     guard: "guided",
@@ -2271,7 +2434,7 @@ function readBrownfieldInitSeed(projectRoot) {
     return null;
   }
   try {
-    const parsed = JSON.parse(readFileSync14(seedPath, "utf-8"));
+    const parsed = JSON.parse(readFileSync15(seedPath, "utf-8"));
     if (parsed.workflow !== "brownfield-adoption") {
       return null;
     }
@@ -2917,7 +3080,7 @@ ${GREEN9}${BOLD4}Quality summary:${RESET9}`);
 }
 
 // src/commands/export.ts
-import { readFileSync as readFileSync15, writeFileSync as writeFileSync10, existsSync as existsSync21, mkdirSync as mkdirSync5 } from "fs";
+import { readFileSync as readFileSync16, writeFileSync as writeFileSync10, existsSync as existsSync21, mkdirSync as mkdirSync5 } from "fs";
 import { join as join21, dirname } from "path";
 var GREEN10 = "\x1B[32m";
 var RED8 = "\x1B[31m";
@@ -3076,7 +3239,7 @@ async function cmdExport(target, projectRoot, options = {}) {
     process.exitCode = 1;
     return;
   }
-  const tokensCSS = readFileSync15(tokensPath, "utf-8");
+  const tokensCSS = readFileSync16(tokensPath, "utf-8");
   const tokens = parseTokensCSS(tokensCSS);
   if (tokens.size === 0) {
     console.error(`${RED8}No --d-* tokens found in tokens.css.${RESET10}`);
@@ -3252,7 +3415,7 @@ function seedOfflineRegistry(projectDir, workspaceRoot) {
 }
 
 // src/bootstrap.ts
-import { mkdirSync as mkdirSync8, readFileSync as readFileSync16, writeFileSync as writeFileSync12 } from "fs";
+import { mkdirSync as mkdirSync8, readFileSync as readFileSync17, writeFileSync as writeFileSync12 } from "fs";
 import { basename, join as join24 } from "path";
 import { resolvePackAdapter } from "@decantr/core";
 var reactViteBootstrapAdapter = {
@@ -3432,7 +3595,7 @@ function getBootstrapAdapter(resolution) {
 }
 function detectRoutingMode(projectDir) {
   try {
-    const essence = JSON.parse(readFileSync16(join24(projectDir, "decantr.essence.json"), "utf-8"));
+    const essence = JSON.parse(readFileSync17(join24(projectDir, "decantr.essence.json"), "utf-8"));
     const routing = essence.meta?.platform?.routing;
     if (routing === "history" || routing === "pathname") {
       return routing;
@@ -3663,9 +3826,11 @@ function extractPatternName(item) {
   }
   return "custom";
 }
-function generateCuratedPrompt(ctx) {
+function generateGreenfieldPrompt(ctx) {
   const lines = [];
-  lines.push("Build this application using the Decantr design system.");
+  lines.push("Build this greenfield application using the Decantr design system.");
+  lines.push("");
+  lines.push("This workspace is a new Decantr scaffold. Use the contract to create or extend the runtime deliberately, not to reverse-engineer a hidden starter.");
   lines.push("");
   lines.push("Treat the compiled execution-pack files as the primary source of truth.");
   lines.push("Use narrative docs only as secondary explanation when the compiled packs are not enough.");
@@ -3699,6 +3864,50 @@ function generateCuratedPrompt(ctx) {
   lines.push("- If a required context file is missing or inconsistent, stop and report exactly which file is missing before continuing.");
   return lines.join("\n");
 }
+function generateBrownfieldPrompt(ctx) {
+  const lines = [];
+  lines.push("Attach Decantr to this existing application without rebuilding it from scratch.");
+  lines.push("");
+  lines.push("Preserve the current framework, package manager, router, build tooling, and working runtime structure unless the generated Decantr contract gives you a reviewed reason to change them.");
+  lines.push("");
+  lines.push("Treat .decantr/analysis.json as the factual inventory of the current app.");
+  lines.push("Treat .decantr/init-seed.json as the recommended Decantr attach defaults.");
+  lines.push("Treat the compiled execution-pack files as the Decantr contract you are layering onto the app.");
+  lines.push("Use only files present in this workspace as the source of truth. If the runtime and contract disagree, call out the drift explicitly instead of improvising a rewrite.");
+  lines.push("");
+  lines.push("Read in this order:");
+  lines.push("1. .decantr/analysis.json for the detected framework, routes, styling, layout, and dependencies.");
+  lines.push("2. .decantr/init-seed.json for the intended attach defaults and workflow lane.");
+  lines.push("3. DECANTR.md for guard rules, CSS expectations, and Decantr operating rules.");
+  lines.push("4. .decantr/context/scaffold-pack.md for the compact compiled shell, theme, feature, and route contract.");
+  lines.push("5. .decantr/context/scaffold.md for broader topology, route map, and voice guidance.");
+  lines.push("6. The matching section and page pack files only when you are working on those specific surfaces.");
+  lines.push("");
+  lines.push("Implementation rules:");
+  lines.push("- Preserve existing files and working flows whenever possible. Prefer incremental attachment over whole-app rewrites.");
+  lines.push("- Map existing routes and components onto the declared Decantr sections/pages before creating new files.");
+  lines.push("- If package.json, router files, or style files already exist, extend them deliberately instead of replacing them with a different starter shape.");
+  lines.push("- If Decantr style files are absent, add src/styles/global.css, src/styles/tokens.css, and src/styles/treatments.css in a way that fits the current app structure.");
+  lines.push("- Use the existing Decantr tokens, treatments, and decorators instead of inventing a parallel visual system.");
+  lines.push("- Registry content is optional in this workflow unless the task explicitly asks for blueprint/theme/pattern enrichment.");
+  lines.push("- Do not invent routes, sections, shells, themes, or features that are not present in the compiled packs.");
+  lines.push("- Do not use inline visual style values or component-scoped <style> tags as the primary styling path. Colors, spacing, borders, shadows, gradients, and transitions should come from atoms, treatments, decorators, or CSS variables.");
+  lines.push("- Let shells own spacing, centering, and scroll containers. Preserve app structure, but remove duplicated shell responsibilities when the contract makes them explicit.");
+  lines.push("- If command_palette or hotkeys are declared in the generated context, implement them as real features.");
+  lines.push("- If a required decorator class is referenced in the contract but missing from generated CSS, report the contract gap instead of inventing a parallel visual system.");
+  lines.push("- Do not modify generated context files unless the task is explicitly to regenerate or refresh Decantr context.");
+  lines.push("");
+  lines.push("Execution flow:");
+  lines.push("- Start by inventorying the current runtime and identifying the safest route/component anchors for attachment.");
+  lines.push("- Align the shared shell and route structure incrementally instead of replacing the app shell wholesale.");
+  lines.push("- Then attach or refine section pages using the matching section and page packs.");
+  lines.push("- After implementation, run decantr check and decantr audit and fix contract or drift issues.");
+  lines.push("- If a required context file or runtime anchor is missing, stop and report exactly what is missing before continuing.");
+  return lines.join("\n");
+}
+function generateCuratedPrompt(ctx) {
+  return ctx.workflow === "brownfield-attach" ? generateBrownfieldPrompt(ctx) : generateGreenfieldPrompt(ctx);
+}
 function getAPIClient() {
   return new RegistryAPIClient3({
     baseUrl: process.env.DECANTR_API_URL || void 0,
@@ -3729,13 +3938,13 @@ function readHostedDistSnapshot(distPath) {
   if (!existsSync25(indexPath)) {
     return void 0;
   }
-  const indexHtml = readFileSync17(indexPath, "utf-8");
+  const indexHtml = readFileSync18(indexPath, "utf-8");
   const assetPaths = extractHostedAssetPaths(indexHtml);
   const assets = {};
   for (const assetPath of assetPaths) {
     const assetFilePath = join26(resolvedDistPath, assetPath.replace(/^[/\\]+/, ""));
     if (existsSync25(assetFilePath)) {
-      assets[assetPath] = readFileSync17(assetFilePath, "utf-8");
+      assets[assetPath] = readFileSync18(assetFilePath, "utf-8");
     }
   }
   return {
@@ -3767,7 +3976,7 @@ function readHostedSourceSnapshot(sourcePath) {
       }
       if (!entry.isFile()) continue;
       if (!isHostedSourceSnapshotFile(relativePath)) continue;
-      files[relativePath] = readFileSync17(absolutePath, "utf-8");
+      files[relativePath] = readFileSync18(absolutePath, "utf-8");
     }
   };
   walk(resolvedSourcePath, rootPrefix);
@@ -3888,7 +4097,7 @@ async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput
   if (!existsSync25(resolvedPath)) {
     throw new Error(`Essence file not found at ${resolvedPath}`);
   }
-  const essence = JSON.parse(readFileSync17(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync18(resolvedPath, "utf-8"));
   const bundle = await client.compileExecutionPacks(
     essence,
     namespace ? { namespace } : void 0
@@ -3938,7 +4147,7 @@ async function printHostedSelectedExecutionPack(packType, id, essencePath, names
   if ((packType === "section" || packType === "page" || packType === "mutation") && !id) {
     throw new Error(`Pack type "${packType}" requires an id.`);
   }
-  const essence = JSON.parse(readFileSync17(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync18(resolvedPath, "utf-8"));
   const selected = await client.selectExecutionPack(
     {
       essence,
@@ -3985,7 +4194,7 @@ async function printHostedExecutionPackManifest(essencePath, namespace, jsonOutp
   if (!existsSync25(resolvedPath)) {
     throw new Error(`Essence file not found at ${resolvedPath}`);
   }
-  const essence = JSON.parse(readFileSync17(resolvedPath, "utf-8"));
+  const essence = JSON.parse(readFileSync18(resolvedPath, "utf-8"));
   const manifest = await client.getExecutionPackManifest(
     essence,
     namespace ? { namespace } : void 0
@@ -4031,7 +4240,7 @@ async function hydrateHostedExecutionPacksIfMissing(projectRoot, namespace = "@o
   }
   try {
     const client = getPublicAPIClient();
-    const essence = JSON.parse(readFileSync17(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync18(essencePath, "utf-8"));
     const bundle = await client.compileExecutionPacks(essence, { namespace });
     mkdirSync10(contextDir, { recursive: true });
     writeExecutionPackBundleArtifacts(
@@ -4056,7 +4265,7 @@ async function hydrateHostedReviewPackIfMissing(projectRoot, namespace = "@offic
   }
   try {
     const client = getPublicAPIClient();
-    const essence = JSON.parse(readFileSync17(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync18(essencePath, "utf-8"));
     const selected = await client.selectExecutionPack(
       {
         essence,
@@ -4086,9 +4295,9 @@ async function printHostedFileCritique(sourcePath, namespace, jsonOutput = false
   if (!existsSync25(resolvedEssencePath)) {
     throw new Error(`Essence file not found at ${resolvedEssencePath}`);
   }
-  const code = readFileSync17(resolvedSourcePath, "utf-8");
-  const essence = JSON.parse(readFileSync17(resolvedEssencePath, "utf-8"));
-  const treatmentsCss = existsSync25(resolvedTreatmentsPath) ? readFileSync17(resolvedTreatmentsPath, "utf-8") : void 0;
+  const code = readFileSync18(resolvedSourcePath, "utf-8");
+  const essence = JSON.parse(readFileSync18(resolvedEssencePath, "utf-8"));
+  const treatmentsCss = existsSync25(resolvedTreatmentsPath) ? readFileSync18(resolvedTreatmentsPath, "utf-8") : void 0;
   const report = await client.critiqueFile(
     {
       essence,
@@ -4116,7 +4325,7 @@ async function printHostedProjectAudit(namespace, jsonOutput = false, essencePat
   if (!existsSync25(resolvedEssencePath)) {
     throw new Error(`Essence file not found at ${resolvedEssencePath}`);
   }
-  const essence = JSON.parse(readFileSync17(resolvedEssencePath, "utf-8"));
+  const essence = JSON.parse(readFileSync18(resolvedEssencePath, "utf-8"));
   const dist = readHostedDistSnapshot(distPath);
   const sources = readHostedSourceSnapshot(sourcesPath);
   const report = await client.auditProject(
@@ -4229,7 +4438,7 @@ async function cmdGet(type, id) {
   ];
   const bundledPath = bundledCandidates.find((p) => existsSync25(p)) || null;
   if (bundledPath) {
-    const data = JSON.parse(readFileSync17(bundledPath, "utf-8"));
+    const data = JSON.parse(readFileSync18(bundledPath, "utf-8"));
     console.log(JSON.stringify(data, null, 2));
     return;
   }
@@ -4241,7 +4450,7 @@ async function cmdValidate(path) {
   const essencePath = path || join26(process.cwd(), "decantr.essence.json");
   let raw;
   try {
-    raw = readFileSync17(essencePath, "utf-8");
+    raw = readFileSync18(essencePath, "utf-8");
   } catch {
     console.error(error3(`Could not read ${essencePath}`));
     process.exitCode = 1;
@@ -4389,6 +4598,7 @@ async function cmdInit(args) {
   let selectedBlueprint = "default";
   let registrySource = "cache";
   const preferContractOnly = brownfieldAttach && !requestedBlueprint && !requestedArchetype;
+  const workflowMode = workflowSeed || brownfieldAttach && !requestedBlueprint && !requestedArchetype ? "brownfield-attach" : "greenfield-scaffold";
   if (args.yes) {
     selectedBlueprint = args.blueprint || "default";
   } else if (!apiAvailable) {
@@ -4459,6 +4669,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
     userExplicit.shape = true;
     userExplicit.personality = true;
   }
+  options.workflowMode = workflowMode;
   let topologyMarkdown = "";
   let archetypeData;
   let composedSections;
@@ -4658,7 +4869,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
   console.log(`    ${cyan3("decantr upgrade")}    Update to latest patterns`);
   console.log(`    ${cyan3("decantr check")}      Detect drift issues`);
   console.log(`    ${cyan3("decantr migrate")}    Migrate v2 essence to v3`);
-  const essenceContent = readFileSync17(result.essencePath, "utf-8");
+  const essenceContent = readFileSync18(result.essencePath, "utf-8");
   const essence = JSON.parse(essenceContent);
   if (essence.version !== "3.1.0") {
     const validation = validateEssence2(essence);
@@ -4680,6 +4891,7 @@ Validation warnings: ${validation.errors.join(", ")}`));
     promptPages = essence.structure || [{ id: "home", shell: options.shell, layout: ["hero"] }];
   }
   const promptCtx = {
+    workflow: options.workflowMode === "brownfield-attach" ? "brownfield-attach" : "greenfield-scaffold",
     archetype: options.archetype || "custom",
     blueprint: options.blueprint,
     theme: options.theme,
@@ -4714,7 +4926,7 @@ async function cmdStatus() {
     return;
   }
   try {
-    const essence = JSON.parse(readFileSync17(essencePath, "utf-8"));
+    const essence = JSON.parse(readFileSync18(essencePath, "utf-8"));
     const validation = validateEssence2(essence);
     const essenceVersion = isV36(essence) ? "v3" : "v2";
     console.log(`${BOLD6}Essence:${RESET13}`);
@@ -4765,7 +4977,7 @@ async function cmdStatus() {
   console.log(`${BOLD6}Sync Status:${RESET13}`);
   if (existsSync25(projectJsonPath)) {
     try {
-      const projectJson = JSON.parse(readFileSync17(projectJsonPath, "utf-8"));
+      const projectJson = JSON.parse(readFileSync18(projectJsonPath, "utf-8"));
       const syncStatus = projectJson.sync?.status || "unknown";
       const lastSync = projectJson.sync?.lastSync || "never";
       const source = projectJson.sync?.registrySource || "unknown";
@@ -4979,7 +5191,7 @@ ${BOLD6}Examples:${RESET13}
         return;
       }
       try {
-        const theme = JSON.parse(readFileSync17(themePath, "utf-8"));
+        const theme = JSON.parse(readFileSync18(themePath, "utf-8"));
         const result = validateCustomTheme(theme);
         if (result.valid) {
           console.log(success3(`Custom theme "${name}" is valid`));
@@ -5233,7 +5445,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-WE7Y7ZOE.js");
+      const { cmdUpgrade } = await import("./upgrade-UXY2WUJH.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-OHQXL7EJ.js";
-import "./chunk-4D5V6GQU.js";
+import "./chunk-ODJQZXHQ.js";
+import "./chunk-74G2RQDO.js";
 import "./chunk-KUDAVJOR.js";

package/dist/{upgrade-WE7Y7ZOE.js → upgrade-UXY2WUJH.js}

@@ -1,7 +1,7 @@
 import {
   RegistryClient,
   refreshDerivedFiles
-} from "./chunk-4D5V6GQU.js";
+} from "./chunk-74G2RQDO.js";
 
 // src/commands/upgrade.ts
 import { readFileSync, writeFileSync, existsSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.7.7",
+  "version": "1.7.8",
   "description": "Decantr CLI — scaffold, audit, and maintain Decantr projects from the terminal",
   "author": "Decantr AI",
   "license": "MIT",
@@ -27,8 +27,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@decantr/essence-spec": "1.0.1",
     "@decantr/core": "1.0.0",
+    "@decantr/essence-spec": "1.0.1",
     "@decantr/registry": "1.0.1",
     "@decantr/verifier": "1.0.1"
   },

package/src/templates/DECANTR.md.template

@@ -84,13 +84,9 @@ When a user request would violate guard rules:
 
 ### Initial scaffolding
 
-Treat the compiled execution-pack files as the primary source of truth.
-Use narrative docs only as secondary explanation when the compiled packs are not enough.
-Use only files present in this workspace as the source of truth. If local scaffold files disagree, stop and report the mismatch instead of relying on external Decantr assumptions or prior examples.
+This project is using Decantr in **{{WORKFLOW_MODE}}** mode.
 
-Read `.decantr/context/scaffold-pack.md` first for the compact compiled shell, theme, feature, and route contract.
-Then read `.decantr/context/scaffold.md` for the fuller app overview, topology, route map, and voice guidance.
-Start implementation from the shell layouts and shared route structure before filling in section pages.
+{{WORKFLOW_GUIDANCE}}
 
 ### Working on a section