@decantr/cli 2.9.2 → 2.9.3

package/dist/{chunk-DX2UDORT.js → chunk-XZFKK6V7.js}

@@ -10,7 +10,7 @@ import { execFileSync } from "child_process";
 import { createHash } from "crypto";
 import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { createRequire } from "module";
-import { dirname as dirname2, isAbsolute, join as join2, relative, resolve as resolve2 } from "path";
+import { dirname as dirname2, isAbsolute as isAbsolute2, join as join2, relative, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 import {
   auditProject,
@@ -20,7 +20,7 @@ import {
 
 // src/workspace.ts
 import { existsSync, readdirSync, readFileSync } from "fs";
-import { dirname, join, resolve } from "path";
+import { dirname, isAbsolute, join, resolve } from "path";
 function readPackageJson(dir) {
   const path = join(dir, "package.json");
   if (!existsSync(path)) return null;
@@ -92,7 +92,7 @@ function listWorkspaceAppCandidates(workspaceRoot) {
 function resolveWorkspaceInfo(cwd, projectArg) {
   const absoluteCwd = resolve(cwd);
   const workspaceRoot = findWorkspaceRoot(absoluteCwd) ?? absoluteCwd;
-  const appRoot = projectArg ? resolve(absoluteCwd, projectArg) : absoluteCwd;
+  const appRoot = projectArg ? resolve(isAbsolute(projectArg) ? "/" : workspaceRoot, 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;
@@ -333,6 +333,9 @@ function contractAssertionApplies(assertion, metadata) {
   if (assertion.rule === "tokens-file-present" && metadata.adoptionMode === "contract-only") {
     return false;
   }
+  if (metadata.adoptionMode === "contract-only" && (assertion.rule === "pack-manifest-present" || assertion.rule === "review-pack-present")) {
+    return false;
+  }
   return true;
 }
 function slugify(value) {
@@ -382,15 +385,19 @@ function commandsForFinding(source) {
 }
 function commandContextForProject(projectRoot) {
   const workspaceInfo = resolveWorkspaceInfo(projectRoot);
-  const relativeProjectPath = relative(workspaceInfo.workspaceRoot, projectRoot).replace(/\\/g, "/");
-  const projectPath = relativeProjectPath && !relativeProjectPath.startsWith("..") && !isAbsolute(relativeProjectPath) ? relativeProjectPath : null;
+  const relativeProjectPath = relative(workspaceInfo.workspaceRoot, projectRoot).replace(
+    /\\/g,
+    "/"
+  );
+  const projectPath = relativeProjectPath && !relativeProjectPath.startsWith("..") && !isAbsolute2(relativeProjectPath) ? relativeProjectPath : null;
   const projectFlag = projectPath ? ` --project ${projectPath}` : "";
   const essencePath = projectPath ? `${projectPath}/decantr.essence.json` : "decantr.essence.json";
   return {
     projectPath,
     compilePacksCommand: `decantr registry compile-packs ${essencePath} --write-context`,
     verifyCommand: `decantr verify${projectFlag}`,
-    ciCommand: `decantr ci${projectFlag} --fail-on error`
+    ciCommand: `decantr ci${projectFlag} --fail-on error`,
+    promptCommand: (id) => `decantr health${projectFlag} --prompt ${id}`
   };
 }
 function rewriteHealthCommand(command, context) {
@@ -403,8 +410,14 @@ function rewriteHealthCommand(command, context) {
     /^decantr init --existing\b/,
     `decantr init --project ${context.projectPath} --existing`
   );
-  rewritten = rewritten.replace(/^decantr analyze\b/, `decantr analyze --project ${context.projectPath}`);
-  rewritten = rewritten.replace(/^decantr check\b/, `decantr check --project ${context.projectPath}`);
+  rewritten = rewritten.replace(
+    /^decantr analyze\b/,
+    `decantr analyze --project ${context.projectPath}`
+  );
+  rewritten = rewritten.replace(
+    /^decantr check\b/,
+    `decantr check --project ${context.projectPath}`
+  );
   rewritten = rewritten.replace(/^decantr audit\b/, context.verifyCommand);
   rewritten = rewritten.replace(/^decantr health\b/, context.verifyCommand);
   return rewritten;
@@ -509,6 +522,69 @@ function createHealthFinding(input) {
     remediation
   };
 }
+function collectContractPackConsistencyFindings(projectRoot, essence, manifest) {
+  if (!essence || typeof essence !== "object") return [];
+  const record = essence;
+  const blueprint = record.blueprint;
+  if (!blueprint || typeof blueprint !== "object") return [];
+  const bp = blueprint;
+  const routes = bp.routes && typeof bp.routes === "object" && !Array.isArray(bp.routes) ? bp.routes : {};
+  const routeTargets = new Set(
+    Object.values(routes).filter(
+      (entry) => Boolean(entry) && typeof entry === "object"
+    ).map((entry) => `${String(entry.section ?? "")}/${String(entry.page ?? "")}`)
+  );
+  const pages = [];
+  for (const section of Array.isArray(bp.sections) ? bp.sections : []) {
+    if (!section || typeof section !== "object") continue;
+    const sectionRecord = section;
+    const sectionId = typeof sectionRecord.id === "string" ? sectionRecord.id : "unknown";
+    for (const page of Array.isArray(sectionRecord.pages) ? sectionRecord.pages : []) {
+      if (!page || typeof page !== "object") continue;
+      const pageRecord = page;
+      const pageId = typeof pageRecord.id === "string" ? pageRecord.id : "unknown";
+      const route = typeof pageRecord.route === "string" ? pageRecord.route : null;
+      pages.push({ section: sectionId, page: pageId, route });
+    }
+  }
+  const findings = [];
+  const routeLess = pages.filter(
+    (page) => !page.route && !routeTargets.has(`${page.section}/${page.page}`)
+  );
+  if (routeLess.length > 0) {
+    findings.push(
+      createHealthFinding({
+        source: "assertion",
+        category: "Contract Route Topology",
+        severity: "error",
+        message: "One or more blueprint pages have no route and cannot be addressed by task-time context.",
+        evidence: routeLess.slice(0, 8).map(
+          (page) => `${page.section}/${page.page} has no page.route or blueprint.routes entry`
+        ),
+        rule: "page-route-required",
+        suggestedFix: "Add a route for each page or rerun the add-page flow with a route-aware Decantr CLI.",
+        baseId: "page-route-required"
+      })
+    );
+  }
+  const pagePackCount = manifest && "pages" in manifest && Array.isArray(manifest.pages) ? manifest.pages.length : 0;
+  if (manifest && pages.length !== pagePackCount) {
+    const context = commandContextForProject(projectRoot);
+    findings.push(
+      createHealthFinding({
+        source: "pack",
+        category: "Generated Artifacts",
+        severity: "warn",
+        message: `Compiled page pack count (${pagePackCount}) does not match the contract page count (${pages.length}).`,
+        evidence: ["Page packs should be regenerated after adding, removing, or re-routing pages."],
+        rule: "page-pack-count-mismatch",
+        suggestedFix: context.compilePacksCommand,
+        baseId: "page-pack-count-mismatch"
+      })
+    );
+  }
+  return findings;
+}
 function countFindings(findings) {
   return {
     errorCount: findings.filter((finding) => finding.severity === "error").length,
@@ -541,7 +617,7 @@ function isDuplicateFinding(existing, finding) {
 }
 function resolveOptionalPath(projectRoot, path) {
   if (!path) return void 0;
-  return isAbsolute(path) ? path : resolve2(projectRoot, path);
+  return isAbsolute2(path) ? path : resolve2(projectRoot, path);
 }
 function hasProjectPlaywright(projectRoot) {
   try {
@@ -758,7 +834,7 @@ function parseDecantrCssTokenNames(projectRoot) {
 function collectDesignTokenEvidence(projectRoot, designTokensPath) {
   const resolved = resolveOptionalPath(projectRoot, designTokensPath);
   if (!resolved) return void 0;
-  const sourceLabel = isAbsolute(designTokensPath ?? "") ? "<design-tokens>" : designTokensPath ?? "<design-tokens>";
+  const sourceLabel = isAbsolute2(designTokensPath ?? "") ? "<design-tokens>" : designTokensPath ?? "<design-tokens>";
   if (!existsSync2(resolved)) {
     return {
       source: sourceLabel,
@@ -1033,6 +1109,13 @@ async function createProjectHealthReport(projectRoot = process.cwd(), options =
   }
   const declaredRoutes = collectDeclaredRoutes(audit.essence);
   const manifest = audit.packManifest;
+  for (const consistencyFinding of collectContractPackConsistencyFindings(
+    projectRoot,
+    audit.essence,
+    manifest
+  )) {
+    if (!isDuplicateFinding(seen, consistencyFinding)) findings.push(consistencyFinding);
+  }
   const browserVerification = await collectBrowserVerification(
     projectRoot,
     options,
@@ -1092,6 +1175,7 @@ function colorForStatus(status) {
 }
 function formatProjectHealthText(report) {
   const color = colorForStatus(report.status);
+  const commandContext = commandContextForProject(report.projectRoot);
   const lines = [
     `${BOLD}Decantr Project Health${RESET}`,
     "",
@@ -1121,7 +1205,7 @@ function formatProjectHealthText(report) {
       if (finding.suggestedFix) {
         lines.push(`    ${DIM}Fix: ${finding.suggestedFix}${RESET}`);
       }
-      lines.push(`    ${DIM}Prompt: decantr health --prompt ${finding.id}${RESET}`);
+      lines.push(`    ${DIM}Prompt: ${commandContext.promptCommand(finding.id)}${RESET}`);
     }
   }
   lines.push("");
@@ -1130,6 +1214,7 @@ function formatProjectHealthText(report) {
 `;
 }
 function formatProjectHealthMarkdown(report) {
+  const commandContext = commandContextForProject(report.projectRoot);
   const lines = [
     "# Decantr Project Health",
     "",
@@ -1158,7 +1243,7 @@ function formatProjectHealthMarkdown(report) {
         lines.push("- Evidence:");
         for (const evidence of finding.evidence) lines.push(`  - ${evidence}`);
       }
-      lines.push(`- Prompt: \`decantr health --prompt ${finding.id}\``);
+      lines.push(`- Prompt: \`${commandContext.promptCommand(finding.id)}\``);
       lines.push("");
     }
   }
@@ -1252,17 +1337,25 @@ async function cmdHealth(projectRoot = process.cwd(), options = {}) {
   }
   const format = resolveFormat(options);
   const failOn = options.failOn ?? "error";
-  const basePayload = options.evidence ? `${JSON.stringify(await createProjectEvidenceBundle(projectRoot, report, reportOptions), null, 2)}
+  const evidenceBundle = options.evidence ? await createProjectEvidenceBundle(projectRoot, report, reportOptions) : null;
+  const basePayload = options.evidence ? `${JSON.stringify(evidenceBundle, null, 2)}
 ` : format === "json" ? formatProjectHealthJson(report) : format === "markdown" ? formatProjectHealthMarkdown(report) : formatProjectHealthText(report);
   const payload = baselineComparison && !options.evidence && format === "text" ? `${basePayload}${formatBaselineComparisonText(baselineComparison)}` : basePayload;
   if (options.output) {
-    const outputPath = isAbsolute(options.output) ? options.output : join2(projectRoot, options.output);
+    const outputPath = isAbsolute2(options.output) ? options.output : join2(projectRoot, options.output);
     mkdirSync(dirname2(outputPath), { recursive: true });
     writeFileSync(outputPath, payload, "utf-8");
     if (!options.ci) {
       console.log(
         `${GREEN}Wrote Decantr ${options.evidence ? "evidence bundle" : "health report"}:${RESET} ${options.output}`
       );
+      if (options.browser && evidenceBundle?.browser?.status === "unavailable") {
+        const reason = evidenceBundle.browser.findings[0] ?? "Playwright is not available to Decantr in this project.";
+        console.log(`${YELLOW}Browser evidence unavailable:${RESET} ${reason}`);
+        console.log(
+          `${DIM}Static evidence was still written. Install Playwright or rerun without --browser if screenshots are not needed.${RESET}`
+        );
+      }
     }
   } else {
     process.stdout.write(payload);

package/dist/{health-LTDSTNOV.js → health-MB63O56B.js}

@@ -10,7 +10,7 @@ import {
   renderProjectHealthCiWorkflow,
   shouldFailHealth,
   writeProjectHealthCiWorkflow
-} from "./chunk-DX2UDORT.js";
+} from "./chunk-XZFKK6V7.js";
 import "./chunk-34TZXWIF.js";
 export {
   cmdHealth,

package/dist/index.js

@@ -1,5 +1,5 @@
-import "./chunk-AXMGQ5IB.js";
+import "./chunk-VMNUJOEH.js";
 import "./chunk-RXF7ZYGK.js";
-import "./chunk-R57DMFLF.js";
-import "./chunk-DX2UDORT.js";
+import "./chunk-ARR3EPS2.js";
+import "./chunk-XZFKK6V7.js";
 import "./chunk-34TZXWIF.js";

package/dist/{studio-7E2LJS3A.js → studio-6QGXJBVH.js}

@@ -1,9 +1,9 @@
 import {
   createWorkspaceHealthReport
-} from "./chunk-R57DMFLF.js";
+} from "./chunk-ARR3EPS2.js";
 import {
   createProjectHealthReport
-} from "./chunk-DX2UDORT.js";
+} from "./chunk-XZFKK6V7.js";
 import {
   sendStudioHealthRefreshedTelemetry,
   sendStudioStartedTelemetry

package/dist/{workspace-53EIHUXB.js → workspace-OGFYJA4N.js}

@@ -7,8 +7,8 @@ import {
   listWorkspaceProjects,
   parseWorkspaceArgs,
   shouldFailWorkspaceHealth
-} from "./chunk-R57DMFLF.js";
-import "./chunk-DX2UDORT.js";
+} from "./chunk-ARR3EPS2.js";
+import "./chunk-XZFKK6V7.js";
 import "./chunk-34TZXWIF.js";
 export {
   cmdWorkspace,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "2.9.2",
+  "version": "2.9.3",
   "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/essence-spec": "2.0.1",
     "@decantr/registry": "2.2.0",
+    "@decantr/verifier": "2.3.3",
     "@decantr/telemetry": "2.2.1",
-    "@decantr/verifier": "2.3.2"
+    "@decantr/core": "2.1.0"
   },
   "scripts": {
     "build": "tsup",