@decantr/cli 2.1.0 → 2.1.1

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-5QM6XDZU.js";
+import "./chunk-GOX5EJ56.js";
 import "./chunk-WDA4SHIQ.js";
-import "./chunk-ZUUJ24YU.js";
+import "./chunk-JYEEXSUX.js";

package/dist/{chunk-KGEEYXSU.js → chunk-DPFORHLL.js}

@@ -1,11 +1,11 @@
 import {
   collectCheckIssues
-} from "./chunk-X2HIXQAY.js";
+} from "./chunk-LLQCXOHK.js";
 import {
   sendProjectHealthCiFailedTelemetry,
   sendProjectHealthPromptTelemetry,
   sendProjectHealthReportTelemetry
-} from "./chunk-ZUUJ24YU.js";
+} from "./chunk-JYEEXSUX.js";
 
 // src/commands/health.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-5QM6XDZU.js → chunk-GOX5EJ56.js}

@@ -26,7 +26,7 @@ import {
   sendCliCommandTelemetry,
   sendNewProjectCompletedTelemetry,
   writeDoctrineMap
-} from "./chunk-ZUUJ24YU.js";
+} from "./chunk-JYEEXSUX.js";
 
 // src/index.ts
 import { existsSync as existsSync26, mkdirSync as mkdirSync12, readdirSync as readdirSync6, readFileSync as readFileSync19, writeFileSync as writeFileSync15 } from "fs";
@@ -7074,8 +7074,10 @@ ${BOLD6}Usage:${RESET13}
   decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context]
   decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>]
   decantr registry audit-project [--namespace <namespace>] [--json] [--essence <path>] [--dist <path>] [--sources <dir>]
+  decantr health [--format text|json|markdown] [--ci] [--fail-on error|warn|none]
   decantr health init-ci [--force] [--project <path>] [--fail-on <error|warn|none>] [--cli-version <version|latest>]
   decantr content-health [--json] [--markdown] [--ci]
+  decantr studio [--port 4319] [--host 127.0.0.1]
   decantr rules preview [--project=<path>]
   decantr rules apply [--project=<path>]
   decantr validate [path]
@@ -7208,6 +7210,88 @@ ${BOLD6}Examples:${RESET13}
   decantr rules apply --project=apps/web
 `);
 }
+function isCommandHelpRequest(args) {
+  return args[1] === "help" || args.slice(1).some((arg) => arg === "--help" || arg === "-h");
+}
+function cmdHealthHelp() {
+  console.log(`
+${BOLD6}decantr health${RESET13} \u2014 Generate a local Project Health report
+
+${BOLD6}Usage:${RESET13}
+  decantr health [--format text|json|markdown] [--output <file>]
+  decantr health --json
+  decantr health --markdown
+  decantr health --ci [--fail-on error|warn|none]
+  decantr health --prompt <finding-id>
+  decantr health init-ci [--force] [--project <path>] [--fail-on error|warn|none] [--cli-version <version|latest>]
+
+${BOLD6}Options:${RESET13}
+  --format      Output format: text, json, or markdown
+  --json        Emit JSON report
+  --markdown    Emit markdown report
+  --output      Write the selected report format to a file
+  --ci          Enable CI exit-code behavior
+  --fail-on     CI threshold: error, warn, or none
+  --prompt      Print an AI-ready remediation prompt for a finding
+
+${BOLD6}Examples:${RESET13}
+  decantr health
+  decantr health --json
+  decantr health --markdown --output decantr-health.md
+  decantr health --ci --fail-on error
+  decantr health --prompt audit-essence-missing
+  decantr health init-ci --project apps/web
+`);
+}
+function cmdContentHealthHelp() {
+  console.log(`
+${BOLD6}decantr content-health${RESET13} \u2014 Generate a local registry content health report
+
+${BOLD6}Usage:${RESET13}
+  decantr content-health [--format text|json|markdown] [--output <file>]
+  decantr content-health --json
+  decantr content-health --markdown
+  decantr content-health --ci [--fail-on error|warn|none]
+  decantr content-health --prompt <finding-id>
+
+${BOLD6}Options:${RESET13}
+  --format      Output format: text, json, or markdown
+  --json        Emit JSON report
+  --markdown    Emit markdown report
+  --output      Write the selected report format to a file
+  --ci          Enable CI exit-code behavior
+  --fail-on     CI threshold: error, warn, or none
+  --prompt      Print an AI-ready remediation prompt for a finding
+
+${BOLD6}Examples:${RESET13}
+  decantr content-health
+  decantr content-health --json
+  decantr content-health --markdown --output content-health.md
+  decantr content-health --ci --fail-on error
+`);
+}
+function cmdStudioHelp() {
+  console.log(`
+${BOLD6}decantr studio${RESET13} \u2014 Run a local Project Health dashboard
+
+${BOLD6}Usage:${RESET13}
+  decantr studio [--port 4319] [--host 127.0.0.1]
+
+${BOLD6}Options:${RESET13}
+  --port        Local port to bind; defaults to 4319
+  --host        Local host to bind; defaults to 127.0.0.1
+
+${BOLD6}Endpoints:${RESET13}
+  GET  /
+  GET  /api/health
+  POST /api/refresh
+
+${BOLD6}Examples:${RESET13}
+  decantr studio
+  decantr studio --port 4320
+  decantr studio --host 127.0.0.1 --port 4319
+`);
+}
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
@@ -7333,7 +7417,7 @@ async function main() {
           `${YELLOW9}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET13}`
         );
       }
-      const { cmdHeal } = await import("./heal-MQ56WYX4.js");
+      const { cmdHeal } = await import("./heal-NWQNJ6PU.js");
       const telemetryFlag = args.includes("--telemetry");
       const brownfieldFlag = args.includes("--brownfield");
       await cmdHeal(process.cwd(), { telemetry: telemetryFlag, brownfield: brownfieldFlag });
@@ -7341,7 +7425,11 @@ async function main() {
     }
     case "health": {
       try {
-        const { cmdHealth, parseHealthArgs } = await import("./health-DCT625XN.js");
+        if (isCommandHelpRequest(args)) {
+          cmdHealthHelp();
+          break;
+        }
+        const { cmdHealth, parseHealthArgs } = await import("./health-WJJ55W3H.js");
         await cmdHealth(process.cwd(), parseHealthArgs(args));
       } catch (e) {
         console.error(error3(e.message));
@@ -7351,6 +7439,10 @@ async function main() {
     }
     case "content-health": {
       try {
+        if (isCommandHelpRequest(args)) {
+          cmdContentHealthHelp();
+          break;
+        }
         const { cmdContentHealth, parseContentHealthArgs } = await import("./content-health-QQHBR6XG.js");
         await cmdContentHealth(process.cwd(), parseContentHealthArgs(args));
       } catch (e) {
@@ -7361,7 +7453,11 @@ async function main() {
     }
     case "studio": {
       try {
-        const { cmdStudio, parseStudioArgs } = await import("./studio-CI7OOGHV.js");
+        if (isCommandHelpRequest(args)) {
+          cmdStudioHelp();
+          break;
+        }
+        const { cmdStudio, parseStudioArgs } = await import("./studio-FJNGWWRM.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error3(e.message));

package/dist/{chunk-ZUUJ24YU.js → chunk-JYEEXSUX.js}

@@ -90,7 +90,7 @@ async function captureCliTelemetryEvent(input) {
 async function sendCliCommandTelemetry(input) {
   const projectRoot = resolveCliTelemetryProjectRoot(input.projectRoot ?? process.cwd(), input.args);
   const command = normalizeCommand(input.args[0]);
-  if (!isOptedIn(projectRoot) || !command || command === "help" || command === "version") {
+  if (!isOptedIn(projectRoot) || !command || command === "help" || command === "version" || isHelpOrVersionProbe(input.args)) {
     return;
   }
   const properties = buildCliLifecycleProperties({
@@ -395,6 +395,11 @@ function normalizeCommand(command) {
   if (command === "--version" || command === "-v") return "version";
   return command;
 }
+function isHelpOrVersionProbe(args) {
+  if (args.some((arg) => arg === "--help" || arg === "-h")) return true;
+  if (args[1] === "help") return true;
+  return false;
+}
 function inferFlagValue(args, flag) {
   const equalsPrefix = `${flag}=`;
   const inline = args.find((arg) => arg.startsWith(equalsPrefix));

package/dist/{chunk-X2HIXQAY.js → chunk-LLQCXOHK.js}

@@ -10,7 +10,7 @@ import {
   scanRoutes,
   scanStyling,
   sendGuardMetrics
-} from "./chunk-ZUUJ24YU.js";
+} from "./chunk-JYEEXSUX.js";
 
 // src/commands/heal.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";

package/dist/{heal-MQ56WYX4.js → heal-NWQNJ6PU.js}

@@ -1,8 +1,8 @@
 import {
   cmdHeal,
   collectCheckIssues
-} from "./chunk-X2HIXQAY.js";
-import "./chunk-ZUUJ24YU.js";
+} from "./chunk-LLQCXOHK.js";
+import "./chunk-JYEEXSUX.js";
 export {
   cmdHeal,
   collectCheckIssues

package/dist/{health-DCT625XN.js → health-WJJ55W3H.js}

@@ -8,9 +8,9 @@ import {
   renderProjectHealthCiWorkflow,
   shouldFailHealth,
   writeProjectHealthCiWorkflow
-} from "./chunk-KGEEYXSU.js";
-import "./chunk-X2HIXQAY.js";
-import "./chunk-ZUUJ24YU.js";
+} from "./chunk-DPFORHLL.js";
+import "./chunk-LLQCXOHK.js";
+import "./chunk-JYEEXSUX.js";
 export {
   cmdHealth,
   createProjectHealthReport,

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-5QM6XDZU.js";
+import "./chunk-GOX5EJ56.js";
 import "./chunk-WDA4SHIQ.js";
-import "./chunk-ZUUJ24YU.js";
+import "./chunk-JYEEXSUX.js";

package/dist/{studio-CI7OOGHV.js → studio-FJNGWWRM.js}

@@ -1,11 +1,11 @@
 import {
   createProjectHealthReport
-} from "./chunk-KGEEYXSU.js";
-import "./chunk-X2HIXQAY.js";
+} from "./chunk-DPFORHLL.js";
+import "./chunk-LLQCXOHK.js";
 import {
   sendStudioHealthRefreshedTelemetry,
   sendStudioStartedTelemetry
-} from "./chunk-ZUUJ24YU.js";
+} from "./chunk-JYEEXSUX.js";
 
 // src/commands/studio.ts
 import { createServer } from "http";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Decantr CLI - scaffold, audit, inspect Project Health, and maintain Decantr projects from the terminal",
   "author": "Decantr AI",
   "license": "MIT",
@@ -32,10 +32,10 @@
   "dependencies": {
     "ajv": "^8.20.0",
     "@decantr/core": "2.0.0",
-    "@decantr/essence-spec": "2.0.1",
+    "@decantr/telemetry": "2.1.0",
     "@decantr/registry": "2.0.0",
     "@decantr/verifier": "2.0.0",
-    "@decantr/telemetry": "2.1.0"
+    "@decantr/essence-spec": "2.0.1"
   },
   "scripts": {
     "build": "tsup",