@decantr/cli 2.8.1 → 2.9.0

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

@@ -1,14 +1,87 @@
-import {
-  listWorkspaceAppCandidates
-} from "./chunk-VE6N3XWG.js";
 import {
   createProjectHealthReport
-} from "./chunk-PAF4PBD3.js";
+} from "./chunk-TMOCTDYY.js";
 
 // src/commands/workspace.ts
 import { execFileSync } from "child_process";
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join, relative, resolve } from "path";
+import { existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { dirname as dirname2, join as join2, relative, resolve as resolve2 } from "path";
+
+// src/workspace.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { dirname, join, resolve } from "path";
+function readPackageJson(dir) {
+  const path = join(dir, "package.json");
+  if (!existsSync(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function hasWorkspaceMarker(dir) {
+  if (existsSync(join(dir, "pnpm-workspace.yaml")) || existsSync(join(dir, "turbo.json")) || existsSync(join(dir, "nx.json"))) {
+    return true;
+  }
+  const pkg = readPackageJson(dir);
+  return Boolean(pkg?.workspaces);
+}
+function findWorkspaceRoot(startDir) {
+  let current = resolve(startDir);
+  while (true) {
+    if (hasWorkspaceMarker(current)) return current;
+    const parent = dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
+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 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 = join(workspaceRoot, base);
+    if (!existsSync(baseDir)) continue;
+    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" })) {
+        candidates.push(`${base}/${entry.name}`);
+      }
+    }
+  }
+  return candidates.sort();
+}
+function listWorkspaceAppCandidates(workspaceRoot) {
+  return listWorkspaceApps(resolve(workspaceRoot));
+}
+function resolveWorkspaceInfo(cwd, projectArg) {
+  const absoluteCwd = resolve(cwd);
+  const workspaceRoot = findWorkspaceRoot(absoluteCwd) ?? absoluteCwd;
+  const appRoot = projectArg ? resolve(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 > 0;
+  return {
+    cwd: absoluteCwd,
+    workspaceRoot,
+    appRoot,
+    projectScope,
+    appCandidates,
+    requiresProjectSelection
+  };
+}
+
+// src/commands/workspace.ts
 var BOLD = "\x1B[1m";
 var DIM = "\x1B[2m";
 var GREEN = "\x1B[32m";
@@ -27,12 +100,12 @@ var DEFAULT_IGNORES = /* @__PURE__ */ new Set([
   "playwright-report"
 ]);
 function workspaceConfigPath(root) {
-  return join(root, ".decantr", "workspace.json");
+  return join2(root, ".decantr", "workspace.json");
 }
 function readWorkspaceConfig(root) {
   const path = workspaceConfigPath(root);
-  if (!existsSync(path)) return null;
-  return JSON.parse(readFileSync(path, "utf-8"));
+  if (!existsSync2(path)) return null;
+  return JSON.parse(readFileSync2(path, "utf-8"));
 }
 function normalizeProjectPath(raw) {
   const normalized = raw.replace(/^\.\/+/, "").replace(/\/+$/, "");
@@ -51,21 +124,21 @@ function discoverProjectPaths(root, config) {
     if (depth > 6) return;
     const rel = relative(root, dir).replace(/\\/g, "/");
     if (rel && [...ignored].some((entry) => rel === entry || rel.startsWith(`${entry}/`))) return;
-    if (existsSync(join(dir, "decantr.essence.json"))) {
+    if (existsSync2(join2(dir, "decantr.essence.json"))) {
       results.add(rel || ".");
       return;
     }
-    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    for (const entry of readdirSync2(dir, { withFileTypes: true })) {
       if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
       if (ignored.has(entry.name)) continue;
-      walk(join(dir, entry.name), depth + 1);
+      walk(join2(dir, entry.name), depth + 1);
     }
   }
   walk(root, 0);
   return [...results].sort();
 }
 function listWorkspaceProjects(root = process.cwd()) {
-  const workspaceRoot = resolve(root);
+  const workspaceRoot = resolve2(root);
   const config = readWorkspaceConfig(workspaceRoot);
   const byPath = /* @__PURE__ */ new Map();
   for (const project of config?.projects ?? []) {
@@ -73,7 +146,7 @@ function listWorkspaceProjects(root = process.cwd()) {
     byPath.set(path, {
       id: project.id ?? projectIdFromPath(path),
       path,
-      absolutePath: resolve(workspaceRoot, path),
+      absolutePath: resolve2(workspaceRoot, path),
       owner: project.owner ?? null,
       tags: project.tags ?? [],
       criticality: project.criticality ?? "normal",
@@ -86,7 +159,7 @@ function listWorkspaceProjects(root = process.cwd()) {
     byPath.set(path, {
       id: projectIdFromPath(path),
       path,
-      absolutePath: resolve(workspaceRoot, path),
+      absolutePath: resolve2(workspaceRoot, path),
       owner: null,
       tags: [],
       criticality: "normal",
@@ -153,7 +226,7 @@ async function mapLimited(items, concurrency, fn) {
   return results;
 }
 async function createWorkspaceHealthReport(root = process.cwd(), options = {}) {
-  const workspaceRoot = resolve(root);
+  const workspaceRoot = resolve2(root);
   const config = readWorkspaceConfig(workspaceRoot);
   const since = options.since ?? "origin/main";
   const changed = options.changedOnly ? changedPaths(workspaceRoot, since) : /* @__PURE__ */ new Set();
@@ -333,8 +406,8 @@ async function cmdWorkspace(workspaceRoot = process.cwd(), args = ["workspace"])
   const payload = options.json ? `${JSON.stringify(report, null, 2)}
 ` : options.markdown ? formatWorkspaceHealthMarkdown(report) : formatWorkspaceHealthText(report);
   if (options.output) {
-    mkdirSync(dirname(resolve(workspaceRoot, options.output)), { recursive: true });
-    writeFileSync(resolve(workspaceRoot, options.output), payload, "utf-8");
+    mkdirSync(dirname2(resolve2(workspaceRoot, options.output)), { recursive: true });
+    writeFileSync(resolve2(workspaceRoot, options.output), payload, "utf-8");
     if (!options.ci)
       console.log(`${GREEN}Wrote Decantr workspace health:${RESET} ${options.output}`);
   } else {
@@ -346,6 +419,7 @@ async function cmdWorkspace(workspaceRoot = process.cwd(), args = ["workspace"])
 }
 
 export {
+  resolveWorkspaceInfo,
   listWorkspaceProjects,
   listWorkspaceCandidates,
   createWorkspaceHealthReport,

package/dist/{chunk-PAF4PBD3.js → chunk-TMOCTDYY.js}

@@ -1,11 +1,9 @@
 import {
-  collectCheckIssues
-} from "./chunk-3TH5PLFO.js";
-import {
+  collectCheckIssues,
   sendProjectHealthCiFailedTelemetry,
   sendProjectHealthPromptTelemetry,
   sendProjectHealthReportTelemetry
-} from "./chunk-KT2ROK2D.js";
+} from "./chunk-34TZXWIF.js";
 
 // src/commands/health.ts
 import { execFileSync } from "child_process";
@@ -227,6 +225,26 @@ function sourceFromCheckIssue(issue) {
   if (issue.rule.includes("interaction")) return "interaction";
   return "check";
 }
+function normalizeHealthCategory(category, source) {
+  const lower = category.toLowerCase();
+  if (source === "pack" || lower.includes("execution pack") || lower.includes("review contract") || lower.includes("context")) {
+    return "Generated Artifact";
+  }
+  if (source === "brownfield") return "Brownfield Contract";
+  if (source === "design-token" || lower.includes("design-token")) return "Design Token";
+  if (lower.includes("accessibility")) return "Accessibility";
+  if (source === "runtime") return "Runtime";
+  if (source === "browser") return "Visual Evidence";
+  if (source === "interaction") return "Interaction";
+  if (source === "assertion") return `Contract ${category}`;
+  return category;
+}
+function contractAssertionApplies(assertion, metadata) {
+  if (assertion.rule === "tokens-file-present" && metadata.adoptionMode === "contract-only") {
+    return false;
+  }
+  return true;
+}
 function slugify(value) {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
 }
@@ -298,13 +316,14 @@ function createHealthFinding(input) {
   const idBase = input.baseId || input.rule || `${input.category}-${input.message}`;
   const id = `${input.source}-${slugify(idBase)}`;
   const commands = commandsForFinding(input.source);
+  const category = normalizeHealthCategory(input.category, input.source);
   const remediation = {
-    summary: input.suggestedFix || `Resolve ${input.category.toLowerCase()} finding.`,
+    summary: input.suggestedFix || `Resolve ${category.toLowerCase()} finding.`,
     commands,
     prompt: buildRemediationPrompt({
       id,
       source: input.source,
-      category: input.category,
+      category,
       severity: input.severity,
       message: input.message,
       evidence: input.evidence ?? [],
@@ -315,7 +334,7 @@ function createHealthFinding(input) {
   return {
     id,
     source: input.source,
-    category: input.category,
+    category,
     severity: input.severity,
     message: input.message,
     evidence: input.evidence ?? [],
@@ -787,6 +806,7 @@ async function createProjectHealthReport(projectRoot = process.cwd(), options =
     if (!isDuplicateFinding(seen, healthFinding)) findings.push(healthFinding);
   }
   for (const contractAssertion of createContractAssertions(projectRoot, audit)) {
+    if (!contractAssertionApplies(contractAssertion, metadata)) continue;
     if (contractAssertion.status !== "failed") continue;
     const healthFinding = createHealthFinding({
       source: "assertion",
@@ -893,7 +913,7 @@ async function createProjectHealthReport(projectRoot = process.cwd(), options =
       generatedAt: typeof manifest?.generatedAt === "string" ? manifest.generatedAt : null
     },
     ci: {
-      recommendedCommand: "decantr health --ci --fail-on error",
+      recommendedCommand: "decantr ci --fail-on error",
       failOn: "error"
     },
     findings

package/dist/{content-health-QQHBR6XG.js → content-health-4KP2EGTI.js}

@@ -172,7 +172,9 @@ function statusFromCounts(counts) {
 function scoreFromCounts(counts) {
   const warningPenalty = Math.min(counts.warnCount * 2, 75);
   const infoPenalty = Math.min(counts.infoCount * 0.5, 10);
-  return Math.round(Math.max(0, Math.min(100, 100 - counts.errorCount * 15 - warningPenalty - infoPenalty)));
+  return Math.round(
+    Math.max(0, Math.min(100, 100 - counts.errorCount * 15 - warningPenalty - infoPenalty))
+  );
 }
 function percentage(count, total) {
   if (total === 0) return 1;
@@ -728,7 +730,9 @@ async function createContentHealthReport(contentRoot = process.cwd(), options =
         category: "Content Root",
         severity: "error",
         message: "No Decantr registry content was found in this directory.",
-        evidence: ["Expected one or more of patterns/, themes/, blueprints/, archetypes/, shells/."],
+        evidence: [
+          "Expected one or more of patterns/, themes/, blueprints/, archetypes/, shells/."
+        ],
         rule: "content-root-empty",
         suggestedFix: "Run this command from a decantr-content style repository.",
         baseId: "content-root-empty"
@@ -828,11 +832,15 @@ async function createContentHealthReport(contentRoot = process.cwd(), options =
         patterns.length
       ),
       patternInteractionCoverage: percentage(
-        patterns.filter((item) => Array.isArray(item.data.interactions) && item.data.interactions.length > 0).length,
+        patterns.filter(
+          (item) => Array.isArray(item.data.interactions) && item.data.interactions.length > 0
+        ).length,
         patterns.length
       ),
       themeDecoratorCoverage: percentage(
-        themes.filter((item) => isRecord(item.data.decorators) && Object.keys(item.data.decorators).length > 0).length,
+        themes.filter(
+          (item) => isRecord(item.data.decorators) && Object.keys(item.data.decorators).length > 0
+        ).length,
         themes.length
       ),
       blueprintPersonalityCoverage: percentage(
@@ -842,7 +850,10 @@ async function createContentHealthReport(contentRoot = process.cwd(), options =
         }).length,
         blueprints.length
       ),
-      blueprintVoiceCoverage: percentage(blueprints.filter((item) => isRecord(item.data.voice)).length, blueprints.length),
+      blueprintVoiceCoverage: percentage(
+        blueprints.filter((item) => isRecord(item.data.voice)).length,
+        blueprints.length
+      ),
       archetypePageBriefCoverage: percentage(
         archetypes.filter((item) => isRecord(item.data.page_briefs)).length,
         archetypes.length
@@ -896,10 +907,12 @@ function formatContentHealthText(report) {
       );
       if (finding.file) lines.push(`    ${DIM}${finding.file}${RESET}`);
       if (finding.suggestedFix) lines.push(`    ${DIM}Fix: ${finding.suggestedFix}${RESET}`);
-      lines.push(`    ${DIM}Prompt: decantr content-health --prompt ${finding.id}${RESET}`);
+      lines.push(`    ${DIM}Prompt: decantr content check --prompt ${finding.id}${RESET}`);
     }
     if (report.findings.length > 40) {
-      lines.push(`  ${DIM}Showing first 40 of ${report.findings.length} findings. Use --json for the full report.${RESET}`);
+      lines.push(
+        `  ${DIM}Showing first 40 of ${report.findings.length} findings. Use --json for the full report.${RESET}`
+      );
     }
   }
   lines.push("");
@@ -931,10 +944,14 @@ function formatContentHealthMarkdown(report) {
   lines.push("");
   lines.push("## Quality Coverage");
   lines.push("");
-  lines.push(`- Pattern visual guidance: ${percentLabel(report.quality.patternVisualBriefCoverage)}`);
+  lines.push(
+    `- Pattern visual guidance: ${percentLabel(report.quality.patternVisualBriefCoverage)}`
+  );
   lines.push(`- Pattern interactions: ${percentLabel(report.quality.patternInteractionCoverage)}`);
   lines.push(`- Theme decorators: ${percentLabel(report.quality.themeDecoratorCoverage)}`);
-  lines.push(`- Blueprint personality: ${percentLabel(report.quality.blueprintPersonalityCoverage)}`);
+  lines.push(
+    `- Blueprint personality: ${percentLabel(report.quality.blueprintPersonalityCoverage)}`
+  );
   lines.push(`- Blueprint voice: ${percentLabel(report.quality.blueprintVoiceCoverage)}`);
   lines.push(`- Archetype page briefs: ${percentLabel(report.quality.archetypePageBriefCoverage)}`);
   lines.push("");
@@ -958,7 +975,7 @@ function formatContentHealthMarkdown(report) {
         lines.push("- Evidence:");
         for (const evidence of finding.evidence) lines.push(`  - ${evidence}`);
       }
-      lines.push(`- Prompt: \`decantr content-health --prompt ${finding.id}\``);
+      lines.push(`- Prompt: \`decantr content check --prompt ${finding.id}\``);
       lines.push("");
     }
   }

package/dist/{heal-ZYD6NVGE.js → heal-2BDT7TR5.js}

@@ -1,8 +1,7 @@
 import {
   cmdHeal,
   collectCheckIssues
-} from "./chunk-3TH5PLFO.js";
-import "./chunk-KT2ROK2D.js";
+} from "./chunk-34TZXWIF.js";
 export {
   cmdHeal,
   collectCheckIssues

package/dist/{health-ETZXWGTW.js → health-Q7XF3I5Z.js}

@@ -10,9 +10,8 @@ import {
   renderProjectHealthCiWorkflow,
   shouldFailHealth,
   writeProjectHealthCiWorkflow
-} from "./chunk-PAF4PBD3.js";
-import "./chunk-3TH5PLFO.js";
-import "./chunk-KT2ROK2D.js";
+} from "./chunk-TMOCTDYY.js";
+import "./chunk-34TZXWIF.js";
 export {
   cmdHealth,
   collectDesignTokenEvidence,

package/dist/index.js

@@ -1,4 +1,5 @@
-import "./chunk-RKZMHS2K.js";
+import "./chunk-N7A3WUZ2.js";
 import "./chunk-V3XAQWKD.js";
-import "./chunk-VE6N3XWG.js";
-import "./chunk-KT2ROK2D.js";
+import "./chunk-T5INVSOP.js";
+import "./chunk-TMOCTDYY.js";
+import "./chunk-34TZXWIF.js";

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

@@ -1,15 +1,13 @@
 import {
   createWorkspaceHealthReport
-} from "./chunk-FV6DGYD7.js";
-import "./chunk-VE6N3XWG.js";
+} from "./chunk-T5INVSOP.js";
 import {
   createProjectHealthReport
-} from "./chunk-PAF4PBD3.js";
-import "./chunk-3TH5PLFO.js";
+} from "./chunk-TMOCTDYY.js";
 import {
   sendStudioHealthRefreshedTelemetry,
   sendStudioStartedTelemetry
-} from "./chunk-KT2ROK2D.js";
+} from "./chunk-34TZXWIF.js";
 
 // src/commands/studio.ts
 import { readFileSync } from "fs";

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

@@ -7,11 +7,9 @@ import {
   listWorkspaceProjects,
   parseWorkspaceArgs,
   shouldFailWorkspaceHealth
-} from "./chunk-FV6DGYD7.js";
-import "./chunk-VE6N3XWG.js";
-import "./chunk-PAF4PBD3.js";
-import "./chunk-3TH5PLFO.js";
-import "./chunk-KT2ROK2D.js";
+} from "./chunk-T5INVSOP.js";
+import "./chunk-TMOCTDYY.js";
+import "./chunk-34TZXWIF.js";
 export {
   cmdWorkspace,
   createWorkspaceHealthReport,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "2.8.1",
+  "version": "2.9.0",
   "description": "Decantr CLI - scaffold, audit, inspect Project Health, and maintain Decantr projects from the terminal",
   "keywords": [
     "decantr",
@@ -49,10 +49,10 @@
   "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.2.0",
-    "@decantr/registry": "2.2.0"
+    "@decantr/verifier": "2.3.0"
   },
   "scripts": {
     "build": "tsup",