@decantr/cli 2.1.1 → 2.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -97,12 +97,13 @@ decantr health --markdown --output health.md
97
97
  decantr health --ci --fail-on error
98
98
  decantr health --ci --fail-on warn
99
99
  decantr health --prompt <finding-id>
100
+ decantr health --json --output decantr-health.json
100
101
  decantr health init-ci
101
102
  decantr health init-ci --fail-on warn --cli-version latest --force
102
103
  decantr health init-ci --project apps/registry
103
104
  ```
104
105
 
105
- 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.
106
+ 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.
106
107
 
107
108
  `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.
108
109
 
@@ -111,9 +112,17 @@ Use `--json` for machines and schema validation, `--markdown` for CI summaries,
111
112
  ```bash
112
113
  decantr studio
113
114
  decantr studio --port 4319 --host 127.0.0.1
115
+ decantr studio --report decantr-health.json
114
116
  ```
115
117
 
116
- 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.
118
+ 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.
119
+
120
+ Use report mode for customer-controlled reporting from CI artifacts:
121
+
122
+ ```bash
123
+ decantr health --json --output decantr-health.json
124
+ decantr studio --report decantr-health.json
125
+ ```
117
126
 
118
127
  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.
119
128
 
package/dist/bin.js CHANGED
@@ -1,4 +1,4 @@
1
1
  #!/usr/bin/env node
2
- import "./chunk-GOX5EJ56.js";
2
+ import "./chunk-3SULF2JT.js";
3
3
  import "./chunk-WDA4SHIQ.js";
4
4
  import "./chunk-JYEEXSUX.js";
@@ -7077,7 +7077,7 @@ ${BOLD6}Usage:${RESET13}
7077
7077
  decantr health [--format text|json|markdown] [--ci] [--fail-on error|warn|none]
7078
7078
  decantr health init-ci [--force] [--project <path>] [--fail-on <error|warn|none>] [--cli-version <version|latest>]
7079
7079
  decantr content-health [--json] [--markdown] [--ci]
7080
- decantr studio [--port 4319] [--host 127.0.0.1]
7080
+ decantr studio [--port 4319] [--host 127.0.0.1] [--report decantr-health.json]
7081
7081
  decantr rules preview [--project=<path>]
7082
7082
  decantr rules apply [--project=<path>]
7083
7083
  decantr validate [path]
@@ -7161,6 +7161,7 @@ ${BOLD6}Examples:${RESET13}
7161
7161
  decantr health --ci --fail-on error
7162
7162
  decantr content-health --ci --fail-on error
7163
7163
  decantr studio
7164
+ decantr studio --report decantr-health.json
7164
7165
  decantr audit
7165
7166
  decantr audit src/pages/HomePage.tsx
7166
7167
  decantr migrate --to v4
@@ -7275,11 +7276,12 @@ function cmdStudioHelp() {
7275
7276
  ${BOLD6}decantr studio${RESET13} \u2014 Run a local Project Health dashboard
7276
7277
 
7277
7278
  ${BOLD6}Usage:${RESET13}
7278
- decantr studio [--port 4319] [--host 127.0.0.1]
7279
+ decantr studio [--port 4319] [--host 127.0.0.1] [--report decantr-health.json]
7279
7280
 
7280
7281
  ${BOLD6}Options:${RESET13}
7281
7282
  --port Local port to bind; defaults to 4319
7282
7283
  --host Local host to bind; defaults to 127.0.0.1
7284
+ --report Serve a read-only Project Health JSON artifact instead of scanning the current project
7283
7285
 
7284
7286
  ${BOLD6}Endpoints:${RESET13}
7285
7287
  GET /
@@ -7290,6 +7292,8 @@ ${BOLD6}Examples:${RESET13}
7290
7292
  decantr studio
7291
7293
  decantr studio --port 4320
7292
7294
  decantr studio --host 127.0.0.1 --port 4319
7295
+ decantr health --json --output decantr-health.json
7296
+ decantr studio --report decantr-health.json
7293
7297
  `);
7294
7298
  }
7295
7299
  async function main() {
@@ -7457,7 +7461,7 @@ async function main() {
7457
7461
  cmdStudioHelp();
7458
7462
  break;
7459
7463
  }
7460
- const { cmdStudio, parseStudioArgs } = await import("./studio-FJNGWWRM.js");
7464
+ const { cmdStudio, parseStudioArgs } = await import("./studio-7XAXWRVN.js");
7461
7465
  await cmdStudio(process.cwd(), parseStudioArgs(args));
7462
7466
  } catch (e) {
7463
7467
  console.error(error3(e.message));
package/dist/index.js CHANGED
@@ -1,3 +1,3 @@
1
- import "./chunk-GOX5EJ56.js";
1
+ import "./chunk-3SULF2JT.js";
2
2
  import "./chunk-WDA4SHIQ.js";
3
3
  import "./chunk-JYEEXSUX.js";