@decantr/cli 2.1.0 → 2.1.2

package/README.md

@@ -97,12 +97,13 @@ decantr health --markdown --output health.md
 decantr health --ci --fail-on error
 decantr health --ci --fail-on warn
 decantr health --prompt <finding-id>
+decantr health --json --output decantr-health.json
 decantr health init-ci
 decantr health init-ci --fail-on warn --cli-version latest --force
 decantr health init-ci --project apps/registry
 ```
 
-Use `--json` for machines and schema validation, `--markdown` for CI summaries, and `--prompt <finding-id>` when you want a scoped remediation prompt for an AI assistant. `--ci --fail-on error` fails only when blocking errors exist; `--ci --fail-on warn` also fails on warnings.
+Use `--json` for machines and schema validation, `--markdown` for CI summaries, and `--prompt <finding-id>` when you want a scoped remediation prompt for an AI assistant. The prompt command prints instructions only; it does not modify source files. `--ci --fail-on error` fails only when blocking errors exist; `--ci --fail-on warn` also fails on warnings.
 
 `decantr health init-ci` installs `.github/workflows/decantr-health.yml` for GitHub Actions. The generated workflow installs project dependencies, writes `decantr-health.json`, gates with `decantr health --ci --fail-on error --markdown --output decantr-health.md`, appends the markdown report to the GitHub step summary, and uploads both files as artifacts. Use `--force` to replace an existing workflow, `--fail-on warn` for stricter repositories, or `--cli-version <version|latest>` to pin the package used by CI. In monorepos, add `--project <path>` from the repository root; dependency install stays at the root while health runs inside the app contract and uploads artifacts from that project path.
 
@@ -111,9 +112,17 @@ Use `--json` for machines and schema validation, `--markdown` for CI summaries,
 ```bash
 decantr studio
 decantr studio --port 4319 --host 127.0.0.1
+decantr studio --report decantr-health.json
 ```
 
-Studio is for local triage, not Decantr admin telemetry. The tabs cover Overview, Routes, Drift, Findings, Remediation, CI, and Packs without uploading source code, prompts, file paths, or project data.
+Studio is for local triage, not Decantr admin telemetry. The Overview keeps the first decision simple: pick the issue to fix first, review the full AI repair prompt before copying it, switch to manual guidance or commands, and expand project details when route/runtime/pack evidence matters. The tabs cover Overview, Routes, Drift, Findings, Remediation, CI, and Packs without uploading source code, prompts, file paths, or project data.
+
+Use report mode for customer-controlled reporting from CI artifacts:
+
+```bash
+decantr health --json --output decantr-health.json
+decantr studio --report decantr-health.json
+```
 
 If the project has explicitly enabled Decantr CLI telemetry, `new --telemetry`, `init --telemetry`, `check --telemetry`, `health`, and `studio` emit only aggregate product-activation metadata such as lifecycle command outcome, status, score, finding counts, CI failure outcome, Studio usage, and remediation prompt requests. They never upload the health report, finding evidence, local paths, route names, source code, or prompt text.
 

package/dist/bin.js

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

package/dist/{chunk-5QM6XDZU.js → chunk-3SULF2JT.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] [--report decantr-health.json]
   decantr rules preview [--project=<path>]
   decantr rules apply [--project=<path>]
   decantr validate [path]
@@ -7159,6 +7161,7 @@ ${BOLD6}Examples:${RESET13}
   decantr health --ci --fail-on error
   decantr content-health --ci --fail-on error
   decantr studio
+  decantr studio --report decantr-health.json
   decantr audit
   decantr audit src/pages/HomePage.tsx
   decantr migrate --to v4
@@ -7208,6 +7211,91 @@ ${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] [--report decantr-health.json]
+
+${BOLD6}Options:${RESET13}
+  --port        Local port to bind; defaults to 4319
+  --host        Local host to bind; defaults to 127.0.0.1
+  --report      Serve a read-only Project Health JSON artifact instead of scanning the current project
+
+${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
+  decantr health --json --output decantr-health.json
+  decantr studio --report decantr-health.json
+`);
+}
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
@@ -7333,7 +7421,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 +7429,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 +7443,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 +7457,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-7XAXWRVN.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error3(e.message));

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-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-3SULF2JT.js";
 import "./chunk-WDA4SHIQ.js";
-import "./chunk-ZUUJ24YU.js";
+import "./chunk-JYEEXSUX.js";