@getcodesentinel/codesentinel 1.9.0 → 1.9.2

package/README.md

@@ -61,18 +61,28 @@ Or in package scripts:
 }
 ```
 
-Example CI policy:
-
-```bash
-codesentinel ci --baseline-ref auto \
-  --max-repo-score 55 \
-  --max-repo-delta 0.03 \
-  --no-new-cycles \
-  --no-new-high-risk-deps \
-  --max-new-hotspots 2 \
-  --fail-on error
+CI example:
+
+```yaml
+- uses: actions/checkout@v4
+  with:
+    fetch-depth: 0
+    filter: blob:none
+    ref: ${{ github.event.pull_request.head.sha || github.sha }}
+- name: Ensure git history for CodeSentinel
+  run: |
+    set -euo pipefail
+    git fetch --prune --unshallow || true
+    BASE_REF="${GITHUB_BASE_REF:-main}"
+    git fetch origin "+refs/heads/${BASE_REF}:refs/remotes/origin/${BASE_REF}"
+- name: Run CodeSentinel
+  run: npx codesentinel ci --baseline-ref auto --max-repo-score 55 --max-repo-delta 0.03 --no-new-cycles --no-new-high-risk-deps --max-new-hotspots 2 --fail-on error
 ```
 
+`--baseline-ref auto` requires enough git history to resolve a baseline deterministically. In GitHub Actions, use `fetch-depth: 0` and ensure the CI base branch ref is fetched.
+
+A full workflow template is available at `examples/github-actions/codesentinel-ci.yml`.
+
 ## Vision
 
 CodeSentinel combines three signals into a single, explainable risk profile:
@@ -276,6 +286,23 @@ Baseline input modes:
     - otherwise: `merge-base(HEAD, origin/main)` then `origin/master`, `main`, `master`
 - `--main-branch <name>` (repeatable) or `--main-branches "main,master,trunk"` customize default branch candidates used by `--baseline-ref auto`.
 
+GitHub Actions recommendation for deterministic CI with `--baseline-ref auto`:
+
+```yaml
+- uses: actions/checkout@v4
+  with:
+    fetch-depth: 0
+    filter: blob:none
+    ref: ${{ github.event.pull_request.head.sha || github.sha }}
+
+- name: Ensure git history for CodeSentinel
+  run: |
+    set -euo pipefail
+    git fetch --prune --unshallow || true
+    BASE_REF="${GITHUB_BASE_REF:-main}"
+    git fetch origin "+refs/heads/${BASE_REF}:refs/remotes/origin/${BASE_REF}"
+```
+
 Exit codes:
 
 - `0`: no failing violations

package/dist/index.js

@@ -5580,10 +5580,6 @@ program.command("ci").argument("[path]", "path to the project to analyze").addOp
       );
       if (options.report === void 0) {
         process.stdout.write(`${result.markdownSummary}
-`);
-      }
-      if (options.jsonOutput === void 0) {
-        process.stdout.write(`${JSON.stringify(result.machineReadable, null, 2)}
 `);
       }
       process.exitCode = result.gateResult.exitCode;