@decantr/cli 2.9.0 → 2.9.1

package/README.md

@@ -21,6 +21,7 @@ Use `decantr setup` when you are unsure which path applies. It detects whether t
 Use `decantr new` for a greenfield workspace in a fresh directory. With a blueprint/archetype it uses the runnable adapter and Decantr CSS; without registry content it creates a contract-only workspace unless you explicitly pass `--adoption=decantr-css`.
 Use `decantr adopt` when you already have an app and want Decantr governance without adopting a blueprint. Brownfield attach is proposal-driven: Decantr inventories the app, writes an observed essence proposal, and only applies it when you explicitly accept or merge it.
 Use `decantr doctor` when the next step is unclear, `decantr task` before asking an LLM to modify a route, `decantr verify` after the edit, and `decantr ci` in required automation. Use `decantr codify --from-audit` when you want project-owned UI patterns and local rules such as button/card/shell/theme standards to appear in future task context and verification.
+In monorepos, app-scoped commands accept `--project <app-path>`. Hosted pack hydration also follows the essence path: `decantr registry compile-packs apps/web/decantr.essence.json --write-context` writes into `apps/web/.decantr/context`.
 Use `decantr init`, `decantr analyze`, `decantr check`, and `decantr health` as advanced primitives when you need direct control over one step.
 
 Current starter adapter availability:

package/dist/bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import "./chunk-N7A3WUZ2.js";
-import "./chunk-V3XAQWKD.js";
-import "./chunk-T5INVSOP.js";
+import "./chunk-6UDJDQPT.js";
+import "./chunk-RXF7ZYGK.js";
+import "./chunk-FKM4OQDF.js";
 import "./chunk-TMOCTDYY.js";
 import "./chunk-34TZXWIF.js";

package/dist/{chunk-N7A3WUZ2.js → chunk-6UDJDQPT.js}

@@ -14,7 +14,7 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-V3XAQWKD.js";
+} from "./chunk-RXF7ZYGK.js";
 import {
   createWorkspaceHealthReport,
   formatWorkspaceHealthMarkdown,
@@ -23,7 +23,7 @@ import {
   listWorkspaceProjects,
   resolveWorkspaceInfo,
   shouldFailWorkspaceHealth
-} from "./chunk-T5INVSOP.js";
+} from "./chunk-FKM4OQDF.js";
 import {
   createProjectHealthReport,
   formatProjectHealthMarkdown,
@@ -4194,6 +4194,7 @@ import { existsSync as existsSync16, readdirSync as readdirSync6, readFileSync a
 import { dirname as dirname3, join as join18, relative as relative4 } from "path";
 import { fileURLToPath } from "url";
 import { isV4 as isV44 } from "@decantr/essence-spec";
+import { collectMissingPackManifestFiles } from "@decantr/verifier";
 var BOLD3 = "\x1B[1m";
 var DIM4 = "\x1B[2m";
 var GREEN4 = "\x1B[32m";
@@ -4339,6 +4340,19 @@ function buildDoctorReport(root, args) {
   const ciFiles = findCiFiles(workspaceRoot);
   const workflowMode = projectJson?.initialized?.workflowMode ?? null;
   const adoptionMode = projectJson?.initialized?.adoptionMode ?? null;
+  const missingPackReferences = workspaceMode ? projects.flatMap(
+    (project) => collectMissingPackManifestFiles(join18(workspaceRoot, project.path)).map(
+      (missing) => `${project.path}/${missing.relativePath}`
+    )
+  ) : collectMissingPackManifestFiles(appRoot).map((missing) => missing.relativePath);
+  const workspaceProjectsMissingManifest = workspaceMode ? projects.map((project) => project.path).filter((projectPath2) => {
+    const projectContextDir = join18(workspaceRoot, projectPath2, ".decantr", "context");
+    return !existsSync16(join18(projectContextDir, "pack-manifest.json"));
+  }) : [];
+  const workspaceProjectsMissingReviewPack = workspaceMode ? projects.map((project) => project.path).filter((projectPath2) => {
+    const projectContextDir = join18(workspaceRoot, projectPath2, ".decantr", "context");
+    return !existsSync16(join18(projectContextDir, "review-pack.json"));
+  }) : [];
   const issues = [];
   if (!essenceVersion && !workspaceMode && !workspaceInfo.requiresProjectSelection) {
     issues.push({
@@ -4384,7 +4398,23 @@ function buildDoctorReport(root, args) {
       category: "generated-artifact",
       severity: "warn",
       message: "Generated context packs are missing or incomplete.",
-      nextCommand: projectPath ? `decantr refresh --project ${projectPath}` : "decantr refresh"
+      nextCommand: projectPath ? `decantr registry compile-packs ${projectPath}/decantr.essence.json --write-context` : "decantr registry compile-packs decantr.essence.json --write-context"
+    });
+  }
+  if (essenceVersion === "4.0.0" && missingPackReferences.length > 0) {
+    issues.push({
+      category: "generated-artifact",
+      severity: "warn",
+      message: `Generated pack manifest references ${missingPackReferences.length} missing file(s).`,
+      nextCommand: projectPath ? `decantr registry compile-packs ${projectPath}/decantr.essence.json --write-context` : "decantr registry compile-packs decantr.essence.json --write-context"
+    });
+  }
+  if (workspaceMode && (workspaceProjectsMissingManifest.length > 0 || workspaceProjectsMissingReviewPack.length > 0 || missingPackReferences.length > 0)) {
+    issues.push({
+      category: "generated-artifact",
+      severity: "warn",
+      message: "One or more attached workspace projects have missing or incomplete generated context packs.",
+      nextCommand: "decantr registry compile-packs <app-path>/decantr.essence.json --write-context"
     });
   }
   if (workflowMode === "brownfield-attach" && !existsSync16(localPatternsPath(appRoot))) {
@@ -4439,9 +4469,12 @@ function buildDoctorReport(root, args) {
       appCandidates: candidates
     },
     generatedArtifacts: {
-      contextDirPresent: existsSync16(contextDir),
-      packManifestPresent,
-      reviewPackPresent
+      contextDirPresent: workspaceMode ? projects.some(
+        (project) => existsSync16(join18(workspaceRoot, project.path, ".decantr", "context"))
+      ) : existsSync16(contextDir),
+      packManifestPresent: workspaceMode ? projects.length > 0 && workspaceProjectsMissingManifest.length === 0 : packManifestPresent,
+      reviewPackPresent: workspaceMode ? projects.length > 0 && workspaceProjectsMissingReviewPack.length === 0 : reviewPackPresent,
+      missingReferencedFiles: missingPackReferences.slice(0, 25)
     },
     localLaw: {
       patternsPresent: existsSync16(localPatternsPath(appRoot)),
@@ -4481,6 +4514,7 @@ function formatDoctorText(report) {
     `  Context directory: ${report.generatedArtifacts.contextDirPresent ? "present" : "missing"}`,
     `  Pack manifest: ${report.generatedArtifacts.packManifestPresent ? "present" : "missing"}`,
     `  Review pack: ${report.generatedArtifacts.reviewPackPresent ? "present" : "missing"}`,
+    `  Manifest references: ${report.generatedArtifacts.missingReferencedFiles.length === 0 ? "complete" : `${report.generatedArtifacts.missingReferencedFiles.length} missing`}`,
     `  Artifact guide: ${report.project.artifactReadmePresent ? "present" : "missing"}`,
     "",
     `${BOLD3}Local Law:${RESET4}`,
@@ -5829,6 +5863,7 @@ async function cmdPublish(type, name, projectRoot = process.cwd()) {
 import { createHash } from "crypto";
 import { existsSync as existsSync23, readdirSync as readdirSync7, readFileSync as readFileSync17, statSync as statSync6 } from "fs";
 import { join as join25 } from "path";
+import { collectMissingPackManifestFiles as collectMissingPackManifestFiles2 } from "@decantr/verifier";
 import { isV4 as isV46 } from "@decantr/essence-spec";
 var GREEN9 = "\x1B[32m";
 var RED8 = "\x1B[31m";
@@ -5891,6 +5926,16 @@ function checkRefreshFreshness(projectRoot) {
   if (!existsSync23(join25(contextDir, "scaffold.md"))) {
     reasons.push(".decantr/context/scaffold.md is missing.");
   }
+  if (!existsSync23(join25(contextDir, "pack-manifest.json"))) {
+    reasons.push(".decantr/context/pack-manifest.json is missing.");
+  } else {
+    const missingPackFiles = collectMissingPackManifestFiles2(projectRoot);
+    if (missingPackFiles.length > 0) {
+      reasons.push(
+        `pack-manifest.json references missing files: ${missingPackFiles.slice(0, 5).map((missing) => missing.relativePath).join(", ")}${missingPackFiles.length > 5 ? "..." : ""}`
+      );
+    }
+  }
   const newestInput = newestInputMtime(projectRoot);
   const staleFiles = generated.filter((path) => fileMtimeMs(path) > 0 && fileMtimeMs(path) < newestInput).map((path) => path.replace(`${projectRoot}/`, ""));
   if (staleFiles.length > 0) {
@@ -7906,9 +7951,9 @@ async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput
   }
   const essence = JSON.parse(readFileSync22(resolvedPath, "utf-8"));
   const bundle = await client.compileExecutionPacks(essence, namespace ? { namespace } : void 0);
+  const contextDir = join31(dirname5(resolvedPath), ".decantr", "context");
   let writtenContextPaths = [];
   if (writeContext) {
-    const contextDir = join31(process.cwd(), ".decantr", "context");
     mkdirSync16(contextDir, { recursive: true });
     const written = writeExecutionPackBundleArtifacts(
       contextDir,
@@ -7934,7 +7979,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: ${join31(process.cwd(), ".decantr", "context")}`);
+    console.log(`  Context bundle: ${contextDir}`);
     console.log(`  Files written: ${writtenContextPaths.length}`);
   }
   console.log("");
@@ -7982,7 +8027,7 @@ async function printHostedSelectedExecutionPack(packType, id, essencePath, names
   );
   let writtenContextDir = null;
   if (writeContext) {
-    const contextDir = join31(process.cwd(), ".decantr", "context");
+    const contextDir = join31(dirname5(resolvedPath), ".decantr", "context");
     mkdirSync16(contextDir, { recursive: true });
     writeFileSync19(
       join31(contextDir, "pack-manifest.json"),
@@ -8028,7 +8073,7 @@ async function printHostedExecutionPackManifest(essencePath, namespace, jsonOutp
   );
   let writtenContextDir = null;
   if (writeContext) {
-    const contextDir = join31(process.cwd(), ".decantr", "context");
+    const contextDir = join31(dirname5(resolvedPath), ".decantr", "context");
     mkdirSync16(contextDir, { recursive: true });
     writeFileSync19(join31(contextDir, "pack-manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
     writtenContextDir = contextDir;
@@ -9936,7 +9981,7 @@ async function cmdVerifyWorkflow(args) {
     return;
   }
   if (workspaceMode) {
-    const { cmdWorkspace } = await import("./workspace-H5QQJCCI.js");
+    const { cmdWorkspace } = await import("./workspace-JA2RZI6V.js");
     await cmdWorkspace(process.cwd(), ["workspace", "health", ...withoutWorkflowOnlyFlags(args)]);
     return;
   }
@@ -10921,7 +10966,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-U2BTWJJJ.js");
+      const { cmdUpgrade } = await import("./upgrade-VON7Y3LG.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;
@@ -10934,9 +10979,12 @@ async function main() {
         );
       }
       const { cmdHeal } = await import("./heal-2BDT7TR5.js");
+      const { flags } = parseLooseArgs(args);
+      const workspaceInfo = resolveWorkflowProject(flags, "check");
+      if (!workspaceInfo) break;
       const telemetryFlag = args.includes("--telemetry");
       const brownfieldFlag = args.includes("--brownfield");
-      await cmdHeal(process.cwd(), { telemetry: telemetryFlag, brownfield: brownfieldFlag });
+      await cmdHeal(workspaceInfo.appRoot, { telemetry: telemetryFlag, brownfield: brownfieldFlag });
       break;
     }
     case "health": {
@@ -10973,7 +11021,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-B2Y4TKZ5.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-EDQMI6JE.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error3(e.message));
@@ -10987,7 +11035,7 @@ async function main() {
           cmdWorkspaceHelp();
           break;
         }
-        const { cmdWorkspace } = await import("./workspace-H5QQJCCI.js");
+        const { cmdWorkspace } = await import("./workspace-JA2RZI6V.js");
         await cmdWorkspace(process.cwd(), args);
       } catch (e) {
         console.error(error3(e.message));

package/dist/{chunk-T5INVSOP.js → chunk-FKM4OQDF.js}

@@ -37,14 +37,25 @@ function findWorkspaceRoot(startDir) {
 }
 function looksLikeApp(dir, options = {}) {
   const allowSourceDirs = options.allowSourceDirs ?? true;
-  if (existsSync(join(dir, "next.config.js")) || existsSync(join(dir, "next.config.ts")) || existsSync(join(dir, "next.config.mjs")) || existsSync(join(dir, "vite.config.ts")) || existsSync(join(dir, "vite.config.js")) || existsSync(join(dir, "angular.json")) || existsSync(join(dir, "svelte.config.js")) || existsSync(join(dir, "svelte.config.ts")) || existsSync(join(dir, "astro.config.mjs")) || allowSourceDirs && (existsSync(join(dir, "src")) || existsSync(join(dir, "app")) || existsSync(join(dir, "pages")))) {
-    return true;
-  }
+  const allowPackageDeps = options.allowPackageDeps ?? 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
+  const hasFrontendDependency = Boolean(
+    deps.react || deps["react-dom"] || deps.next || deps.vue || deps.svelte || deps["@angular/core"] || deps.astro || deps.nuxt
   );
+  const hasServerOnlyDependency = Boolean(
+    deps.hono || deps.express || deps.fastify || deps.koa || deps["@hapi/hapi"]
+  );
+  if (existsSync(join(dir, "next.config.js")) || existsSync(join(dir, "next.config.ts")) || existsSync(join(dir, "next.config.mjs")) || existsSync(join(dir, "vite.config.ts")) || existsSync(join(dir, "vite.config.js")) || existsSync(join(dir, "angular.json")) || existsSync(join(dir, "svelte.config.js")) || existsSync(join(dir, "svelte.config.ts")) || existsSync(join(dir, "astro.config.mjs"))) {
+    return true;
+  }
+  if (allowSourceDirs && (existsSync(join(dir, "src")) || existsSync(join(dir, "app")) || existsSync(join(dir, "pages")))) {
+    if (hasFrontendDependency) return true;
+    if (hasServerOnlyDependency) return false;
+    return true;
+  }
+  if (!allowPackageDeps) return false;
+  return hasFrontendDependency;
 }
 function listWorkspaceApps(workspaceRoot) {
   const candidates = [];
@@ -54,7 +65,10 @@ function listWorkspaceApps(workspaceRoot) {
     for (const entry of readdirSync(baseDir, { withFileTypes: true })) {
       if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
       const candidate = join(baseDir, entry.name);
-      if (looksLikeApp(candidate, { allowSourceDirs: base === "apps" })) {
+      if (looksLikeApp(candidate, {
+        allowSourceDirs: base === "apps",
+        allowPackageDeps: base === "apps"
+      })) {
         candidates.push(`${base}/${entry.name}`);
       }
     }

package/dist/{chunk-V3XAQWKD.js → chunk-RXF7ZYGK.js}

@@ -4989,7 +4989,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
       themeData,
       themeMode: mode,
       voiceTone: storedVoice?.tone ? storedVoice.tone.split(".")[0] + "." : void 0,
-      spatialHints: sectionSpatialHints
+      spatialHints: sectionSpatialHints,
+      adoptionMode: effectiveAdoptionMode
     });
     const sectionContextPath = join2(contextDir, `section-${section.id}.md`);
     writeFileSync2(sectionContextPath, contextContent);
@@ -5345,7 +5346,8 @@ function generateSectionContext(input) {
     themeHints,
     constraints,
     shellInfo,
-    spatialHints
+    spatialHints,
+    adoptionMode
   } = input;
   const lines = [];
   lines.push(`# Section: ${section.id}`);
@@ -5429,9 +5431,15 @@ function generateSectionContext(input) {
   const decoratorDefs = input.themeData?.decorator_definitions;
   const totalDecoratorCount = decoratorDefs && Object.keys(decoratorDefs).length || decorators.length;
   if (totalDecoratorCount > 0) {
-    lines.push(
-      `**Theme decorators:** ${totalDecoratorCount} \`${themeName}-*\` classes \u2014 full Class/Intent/Apply-to table in \`section-${section.id}-pack.md\` (preferred) and DECANTR.md "Decorator Quick Reference". MUST apply.`
-    );
+    if (adoptionMode === "contract-only") {
+      lines.push(
+        `**Theme intent:** ${totalDecoratorCount} \`${themeName}-*\` decorator reference(s) exist, but this project is contract-only. Translate the intent into the app's current styling system instead of applying Decantr decorator classes directly.`
+      );
+    } else {
+      lines.push(
+        `**Theme decorators:** ${totalDecoratorCount} \`${themeName}-*\` classes \u2014 full Class/Intent/Apply-to table in \`section-${section.id}-pack.md\` (preferred) and DECANTR.md "Decorator Quick Reference". MUST apply.`
+      );
+    }
     lines.push("");
   }
   if (themeHints) {
@@ -5454,9 +5462,15 @@ function generateSectionContext(input) {
   }
   const themePrefix = themeName.split("-")[0] || themeName;
   lines.push("");
-  lines.push(
-    `Usage: \`className={css('_flex _col _gap4') + ' d-surface ${themePrefix}-glass'}\` \u2014 atoms via css(), treatments and theme decorators as plain class strings.`
-  );
+  if (adoptionMode === "contract-only") {
+    lines.push(
+      "Usage: implement this section through the app's existing styling authority (design-system components, Tailwind/Sass/theme tokens, CVA variants, or accepted local rules). Do not add `@decantr/css`, `css(...)`, `d-*` treatments, or Decantr token CSS unless adoption mode changes."
+    );
+  } else {
+    lines.push(
+      `Usage: \`className={css('_flex _col _gap4') + ' d-surface ${themePrefix}-glass'}\` \u2014 atoms via css(), treatments and theme decorators as plain class strings.`
+    );
+  }
   lines.push("");
   lines.push("---");
   lines.push("");

package/dist/index.js

@@ -1,5 +1,5 @@
-import "./chunk-N7A3WUZ2.js";
-import "./chunk-V3XAQWKD.js";
-import "./chunk-T5INVSOP.js";
+import "./chunk-6UDJDQPT.js";
+import "./chunk-RXF7ZYGK.js";
+import "./chunk-FKM4OQDF.js";
 import "./chunk-TMOCTDYY.js";
 import "./chunk-34TZXWIF.js";

package/dist/{studio-B2Y4TKZ5.js → studio-EDQMI6JE.js}

@@ -1,6 +1,6 @@
 import {
   createWorkspaceHealthReport
-} from "./chunk-T5INVSOP.js";
+} from "./chunk-FKM4OQDF.js";
 import {
   createProjectHealthReport
 } from "./chunk-TMOCTDYY.js";

package/dist/{upgrade-U2BTWJJJ.js → upgrade-VON7Y3LG.js}

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

package/dist/{workspace-H5QQJCCI.js → workspace-JA2RZI6V.js}

@@ -7,7 +7,7 @@ import {
   listWorkspaceProjects,
   parseWorkspaceArgs,
   shouldFailWorkspaceHealth
-} from "./chunk-T5INVSOP.js";
+} from "./chunk-FKM4OQDF.js";
 import "./chunk-TMOCTDYY.js";
 import "./chunk-34TZXWIF.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "2.9.0",
+  "version": "2.9.1",
   "description": "Decantr CLI - scaffold, audit, inspect Project Health, and maintain Decantr projects from the terminal",
   "keywords": [
     "decantr",
@@ -48,11 +48,11 @@
   },
   "dependencies": {
     "ajv": "^8.20.0",
-    "@decantr/core": "2.1.0",
-    "@decantr/registry": "2.2.0",
     "@decantr/essence-spec": "2.0.1",
     "@decantr/telemetry": "2.2.1",
-    "@decantr/verifier": "2.3.0"
+    "@decantr/registry": "2.2.0",
+    "@decantr/core": "2.1.0",
+    "@decantr/verifier": "2.3.1"
   },
   "scripts": {
     "build": "tsup",