@tested/cli 0.1.0 → 0.1.2

package/README.md

@@ -2,29 +2,33 @@
 
 Coverage your agent can use. CLI for patch + project coverage with agent-readable JSON output.
 
-**→ [Getting started (simple path)](docs/GETTING-STARTED.md)**  
-**→ [GitHub Action](action/README.md)** (`action/action.yml` composite)
+Docs: https://tested.dev/docs
 
 ## Install
 
-Node >= 20.19.
+Node 24+.
 
 ```bash
 pnpm add -D @tested/cli
 # or
-npx @tested/cli
+npx @tested/cli          # runs `tested` (`td` is the same CLI after install)
 ```
 
-CI uses the composite Action (`tested-hq/cli/action@main`). The Action clones this repo and builds the CLI.
+```bash
+npx @tested/cli --version
+# after a local install, pnpm swallows --version unless you use exec:
+pnpm exec -- tested --version
+```
+
+CI uses the composite Action (`tested-hq/cli/action@main`). It installs `@tested/cli` from npm.
 
 ```yaml
 - uses: tested-hq/cli/action@main
   with:
+    version: 0.1.2
     token: ${{ secrets.TESTED_TOKEN }}
 ```
 
-Pin `cli-ref` to a SHA in production. See [action/README.md](action/README.md).
-
 ## First 10 minutes
 
 ```
@@ -85,7 +89,7 @@ The hook runs `tested run && tested diff` against the upstream branch (or `HEAD~
 ```yaml
 thresholds:
   patch: 80     # % of newly-added lines that must be covered
-  project: 60   # % of the whole project that must be covered
+  project: 90   # % of the whole project that must be covered
 ```
 
 ```
@@ -93,7 +97,7 @@ $ tested check
 tested.dev — coverage gate  [PASS]
 
   Patch     87.3%  (threshold 80)  [PASS]
-  Project   64.1%  (threshold 60)  [PASS]
+  Project   92.1%  (threshold 90)  [PASS]
 
 thresholds met
 $ echo $?
@@ -103,13 +107,25 @@ $ tested check
 tested.dev — coverage gate  [FAIL]
 
   Patch     42.7%  (threshold 80)  [FAIL]
-  Project   64.1%  (threshold 60)  [PASS]
+  Project   92.1%  (threshold 90)  [PASS]
 
 → add tests for uncovered ranges: tested diff
 $ echo $?
 1
 ```
 
+If the patch has no executable lines in scope (tests-only, comments-only, docs-only, or ignored files), the patch gate is **skipped** — not reported as 0% coverage. Project still applies.
+
+```
+$ tested check
+tested.dev — coverage gate  [PASS]
+
+  Patch     -  no executable lines in the patch  [SKIP]
+  Project   92.1%  (threshold 90)  [PASS]
+
+No executable lines in the patch — patch gate skipped. Project threshold met.
+```
+
 If `thresholds` is missing from `.tested.yaml`, `tested check` prints a notice on stderr and exits 0 — configs that haven't opted in stay green.
 
 ### GitHub Actions
@@ -117,6 +133,7 @@ If `thresholds` is missing from `.tested.yaml`, `tested check` prints a notice o
 ```yaml
 - uses: tested-hq/cli/action@main
   with:
+    version: 0.1.2
     push: true
     pr-number: ${{ github.event.pull_request.number }}
     token: ${{ secrets.TESTED_TOKEN }}
@@ -128,7 +145,7 @@ For programmatic consumers:
 
 ```
 $ tested check --json
-{"patch":{"pct":87.3,"threshold":80,"pass":true},"project":{"pct":64.1,"threshold":60,"pass":true},"overall":"pass"}
+{"patch":{"pct":87.3,"threshold":80,"pass":true},"project":{"pct":92.1,"threshold":90,"pass":true},"overall":"pass"}
 ```
 
 `--json` suppresses the human layout; the exit code is unchanged.

package/dist/td.js

@@ -44,6 +44,8 @@ function badge(kind) {
       return pc.yellow("[WARN]");
     case "info":
       return pc.cyan("[INFO]");
+    case "skip":
+      return pc.cyan("[SKIP]");
   }
 }
 function metricBar(pct3, width = 10) {
@@ -130,6 +132,10 @@ function formatCliError(message) {
 
 // src/commands/init.ts
 import pc2 from "picocolors";
+var DEFAULT_INIT_THRESHOLDS = {
+  patch: 80,
+  project: 90
+};
 var INIT_YAML_HEADER = "# Config schema \u2014 see https://tested.dev/docs/config\n";
 var DEFAULT_INIT_IGNORES = [
   "**/*.test.ts",
@@ -179,9 +185,11 @@ function buildInitYaml(args) {
   if (args.testRunner) {
     lines.push(`testRunner: ${args.testRunner}`);
   }
+  lines.push("# Patch gate is skipped when the diff has no executable lines");
+  lines.push("# (tests-only, comments-only, docs-only, or ignored files).");
   lines.push("thresholds:");
-  lines.push("  patch: 80");
-  lines.push("  project: 60");
+  lines.push(`  patch: ${DEFAULT_INIT_THRESHOLDS.patch}`);
+  lines.push(`  project: ${DEFAULT_INIT_THRESHOLDS.project}`);
   lines.push("ignores:");
   for (const pattern of DEFAULT_INIT_IGNORES) {
     lines.push(`  - "${pattern}"`);
@@ -545,7 +553,9 @@ var FileCoverageSchema = z2.object({
 var CoverageTotalsSchema = z2.object({
   executable: z2.number().int().nonnegative(),
   covered: z2.number().int().nonnegative(),
-  pct: z2.number().min(0).max(100)
+  pct: z2.number().min(0).max(100),
+  /** Present when executable === 0 — not a 0% coverage result. */
+  empty: z2.literal(true).optional()
 });
 var ProjectTotalsSchema = CoverageTotalsSchema.extend({
   delta: z2.number().nullable()
@@ -614,7 +624,14 @@ async function headSha(ctx) {
   return (await ctx.git.revparse(["HEAD"])).trim();
 }
 async function unifiedDiff(ctx, base) {
-  return ctx.git.diff([`${base}...HEAD`]);
+  try {
+    const mergeBase = (await ctx.git.raw(["merge-base", base, "HEAD"])).trim();
+    if (mergeBase) {
+      return ctx.git.diff([`${base}...HEAD`]);
+    }
+  } catch {
+  }
+  return ctx.git.diff([base, "HEAD"]);
 }
 async function remoteUrl(ctx, remote = "origin") {
   return (await ctx.git.raw(["remote", "get-url", remote])).trim();
@@ -763,6 +780,10 @@ function assertWithinRoot(root, resolvedPath) {
 }
 
 // src/core/patch.ts
+var EMPTY_PATCH_REASON = "no executable lines in the patch";
+function isEmptyPatch(totals) {
+  return totals.executable === 0;
+}
 function pct(covered, executable) {
   if (executable === 0) return 0;
   return Math.round(covered / executable * 1e3) / 10;
@@ -862,10 +883,10 @@ function uncoveredRanges(file) {
 function buildDiffOutput(args) {
   const patch = computePatchCoverage(args.files, args.addedByFile);
   const project = computeProjectCoverage(args.files);
-  const fileNames = /* @__PURE__ */ new Set([
-    ...patch.byFile.keys(),
-    ...project.byFile.keys()
-  ]);
+  const emptyPatch = isEmptyPatch(patch.totals);
+  const fileNames = new Set(
+    emptyPatch ? [] : [...patch.byFile.keys(), ...project.byFile.keys()]
+  );
   const files = [];
   for (const name of fileNames) {
     const file = args.files.find((f) => f.path === name);
@@ -882,7 +903,7 @@ function buildDiffOutput(args) {
     schemaVersion: 1,
     base: args.base,
     head: args.head,
-    patch: patch.totals,
+    patch: emptyPatch ? { ...patch.totals, empty: true } : patch.totals,
     project: { ...project.totals, delta: args.projectDelta ?? null },
     files,
     ignored: [...args.ignored]
@@ -1508,6 +1529,7 @@ function registerPushCommand(program2) {
 
 // src/commands/doctor.ts
 var TESTED_BIN_BASENAME_RE = /^tested(\.js)?$/;
+var MIN_NODE_MAJOR = 24;
 function statusBadge(status) {
   const kind = status === "pass" ? "pass" : status === "fail" ? "fail" : status === "warn" ? "warn" : "info";
   return badge(kind);
@@ -1574,20 +1596,19 @@ async function runDoctor(deps) {
   const checks = [];
   const major = parseNodeMajor(nodeVersion);
   const nodeDisplay = nodeVersion.replace(/^v/, "v");
-  if (major !== null && major >= 22) {
+  if (major !== null && major >= MIN_NODE_MAJOR) {
     checks.push({
       id: "node",
       label: "Node.js",
       status: "pass",
-      detail: `${nodeDisplay} (>= 20.19; 22+ recommended)`
+      detail: `${nodeDisplay} (>= ${MIN_NODE_MAJOR})`
     });
   } else {
     checks.push({
       id: "node",
       label: "Node.js",
-      status: "warn",
-      detail: `${nodeDisplay} runs this CLI. Node >= 22 recommended.`,
-      optional: true
+      status: "fail",
+      detail: `${nodeDisplay} is below ${MIN_NODE_MAJOR}. Node >= ${MIN_NODE_MAJOR} required.`
     });
   }
   let isRepo = false;
@@ -1809,7 +1830,7 @@ async function runDoctor(deps) {
       optional: true
     });
   }
-  const hardFailIds = /* @__PURE__ */ new Set(["git", "config", "origin"]);
+  const hardFailIds = /* @__PURE__ */ new Set(["node", "git", "config", "origin"]);
   const safetyFailIds = /* @__PURE__ */ new Set(["api_url", "tested_bin", "token"]);
   const hasHardFail = checks.some(
     (c) => c.status === "fail" && hardFailIds.has(c.id)
@@ -1854,6 +1875,73 @@ function registerDoctorCommand(program2) {
 
 // src/commands/setup.ts
 import pc3 from "picocolors";
+
+// package.json
+var package_default = {
+  name: "@tested/cli",
+  version: "0.1.2",
+  description: "Coverage your agent can use. CLI for patch + project coverage with agent-readable JSON output.",
+  license: "MIT",
+  homepage: "https://tested.dev",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/tested-hq/cli.git"
+  },
+  bugs: {
+    url: "https://github.com/tested-hq/cli/issues"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  type: "module",
+  packageManager: "pnpm@11.3.0",
+  bin: {
+    tested: "./dist/tested.js",
+    td: "./dist/tested.js"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    build: "tsup",
+    dev: "tsx bin/tested.ts",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    typecheck: "tsc --noEmit",
+    prepare: "node ./scripts/prepare.mjs",
+    prepublishOnly: "pnpm run build"
+  },
+  engines: {
+    node: ">=24"
+  },
+  dependencies: {
+    commander: "14.0.3",
+    minimatch: "10.2.5",
+    picocolors: "1.1.1",
+    "simple-git": "3.36.0",
+    yaml: "2.9.0",
+    zod: "4.4.3"
+  },
+  devDependencies: {
+    "@types/node": "25.9.1",
+    "@vitest/coverage-v8": "4.1.7",
+    husky: "9.1.7",
+    "is-ci": "3.0.1",
+    tsup: "8.5.1",
+    tsx: "4.22.3",
+    typescript: "6.0.3",
+    vite: "8.0.14",
+    vitest: "4.1.7"
+  }
+};
+
+// src/version.ts
+var CLI_VERSION = package_default.version;
+
+// src/commands/setup.ts
 var PINNED_CLI = "@tested/cli";
 function buildCiSnippet() {
   return [
@@ -1865,12 +1953,9 @@ function buildCiSnippet() {
     "    runs-on: ubuntu-latest",
     "    steps:",
     "      - uses: actions/checkout@v4",
-    "        with:",
-    "          fetch-depth: 0",
     "      - uses: tested-hq/cli/action@main",
     "        with:",
-    "          # pin ref for reproducible installs (do not use floating tags in prod)",
-    "          cli-ref: main",
+    `          version: ${CLI_VERSION}`,
     "          push: true",
     "          pr-number: ${{ github.event.pull_request.number }}",
     "          token: ${{ secrets.TESTED_TOKEN }}"
@@ -1887,6 +1972,7 @@ function buildTokenInstructions() {
 function buildInstallInstructions() {
   return [
     "Install CLI:",
+    "  Node 24+",
     `  pnpm add -D ${PINNED_CLI}`,
     `  # or: npx ${PINNED_CLI}`,
     "",
@@ -1931,6 +2017,12 @@ function formatSetupHuman(opts) {
     ])
   );
   lines.push("");
+  lines.push(
+    dim(
+      "Patch gate is skipped when the diff has no executable lines (tests-only, docs, comments)."
+    )
+  );
+  lines.push("");
   lines.push(tip("re-check anytime: tested doctor"));
   lines.push("");
   return lines.join("\n");
@@ -2196,8 +2288,8 @@ function coloredPctCell(pct3, width = 6) {
 function formatMetricRow(label, pct3, covered, executable, emptyNote) {
   const labelPad = label.padEnd(8);
   if (executable === 0) {
-    const note = emptyNote ?? "no executable lines";
-    return `  ${labelPad}  ${dim("-".padEnd(6))}  ${dim(note)}`;
+    const note = emptyNote ?? EMPTY_PATCH_REASON;
+    return `  ${labelPad}  ${dim("-".padEnd(6))}  ${note}`;
   }
   const pctStr = coloredPctCell(pct3);
   const bar = metricBar(pct3);
@@ -2216,7 +2308,7 @@ function formatHuman(out, opts = {}) {
       out.patch.pct,
       out.patch.covered,
       out.patch.executable,
-      "no executable lines in patch"
+      EMPTY_PATCH_REASON
     )
   );
   const projectRow = formatMetricRow(
@@ -2229,7 +2321,7 @@ function formatHuman(out, opts = {}) {
   if (opts.thresholds) {
     const patchPass = out.patch.pct >= opts.thresholds.patch;
     const projectPass = out.project.pct >= opts.thresholds.project;
-    const patchOk = out.patch.executable === 0 ? true : patchPass;
+    const patchOk = isEmptyPatch(out.patch) ? true : patchPass;
     const overall = patchOk && projectPass;
     const details = [];
     if (!patchOk) {
@@ -2240,7 +2332,7 @@ function formatHuman(out, opts = {}) {
         `project ${out.project.pct.toFixed(1)}% < ${opts.thresholds.project}%`
       );
     }
-    const detail = details.length > 0 ? dim(`  ${details.join("; ")}`) : "";
+    const detail = details.length > 0 ? dim(`  ${details.join("; ")}`) : isEmptyPatch(out.patch) ? dim(`  ${EMPTY_PATCH_REASON}`) : "";
     lines.push(
       `  ${"Gate".padEnd(8)}  ${overall ? badge("pass") : badge("fail")}${detail}`
     );
@@ -2253,12 +2345,15 @@ function formatHuman(out, opts = {}) {
       );
     }
   }
-  if (out.files.length > 0) {
+  if (isEmptyPatch(out.patch)) {
+    lines.push("");
+    lines.push(dim("No executable lines in the patch \u2014 patch gate does not apply."));
+  } else if (out.files.length > 0) {
     lines.push("");
     lines.push(heading("Files in diff:"));
     const anyPatch = out.files.some((f) => f.patchCoverage !== null);
     if (!anyPatch) {
-      lines.push(dim("  (project coverage \u2014 no executable lines in patch)"));
+      lines.push(dim(`  (project coverage \u2014 ${EMPTY_PATCH_REASON})`));
     }
     for (const f of out.files) {
       const hasPatch = f.patchCoverage !== null;
@@ -2344,7 +2439,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
   const projectPct = diff.project.pct;
   const patchThreshold = config.thresholds.patch;
   const projectThreshold = config.thresholds.project;
-  const patchSkipped = diff.patch.executable === 0;
+  const patchSkipped = isEmptyPatch(diff.patch);
   const patchPass = patchSkipped ? true : patchPct >= patchThreshold;
   const projectPass = projectPct >= projectThreshold;
   const overall = patchPass && projectPass ? "pass" : "fail";
@@ -2355,10 +2450,11 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
         pct: patchPct,
         threshold: patchThreshold,
         pass: patchPass,
-        ...patchSkipped ? { skipped: true } : {}
+        ...patchSkipped ? { skipped: true, reason: EMPTY_PATCH_REASON } : {}
       },
       project: { pct: projectPct, threshold: projectThreshold, pass: projectPass },
-      overall
+      overall,
+      ...patchSkipped ? { note: EMPTY_PATCH_REASON } : {}
     };
     return {
       skipped: false,
@@ -2377,7 +2473,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
   lines.push("");
   if (patchSkipped) {
     lines.push(
-      `  ${"Patch".padEnd(8)}  ${dim("-")}  ${dim("(no executable lines \u2014 skipped)")}  ${badge("info")}`
+      `  ${"Patch".padEnd(8)}  ${dim("-")}  ${EMPTY_PATCH_REASON}  ${badge("skip")}`
     );
   } else {
     lines.push(formatMetricLine("Patch", patchPct, patchThreshold, patchPass));
@@ -2385,10 +2481,17 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
   lines.push(formatMetricLine("Project", projectPct, projectThreshold, projectPass));
   if (overall === "fail") {
     lines.push("");
+    if (patchSkipped) {
+      lines.push(dim("No executable lines in the patch \u2014 patch gate skipped."));
+    }
     lines.push(tip("add tests for uncovered ranges: tested diff"));
   } else {
     lines.push("");
-    lines.push(dim(patchSkipped ? "project thresholds met (patch skipped)" : "thresholds met"));
+    lines.push(
+      dim(
+        patchSkipped ? "No executable lines in the patch \u2014 patch gate skipped. Project threshold met." : "thresholds met"
+      )
+    );
   }
   lines.push("");
   return {
@@ -2561,7 +2664,7 @@ function createProgram() {
       "Agent loop:",
       "  tested setup \u2192 tested run \u2192 tested diff \u2192 tested check \u2192 tested push --pr <n>"
     ].join("\n")
-  ).version("0.1.0");
+  ).version(CLI_VERSION);
   registerSetupCommand(program2);
   registerDoctorCommand(program2);
   registerInitCommand(program2);

package/dist/tested.js

@@ -44,6 +44,8 @@ function badge(kind) {
       return pc.yellow("[WARN]");
     case "info":
       return pc.cyan("[INFO]");
+    case "skip":
+      return pc.cyan("[SKIP]");
   }
 }
 function metricBar(pct3, width = 10) {
@@ -130,6 +132,10 @@ function formatCliError(message) {
 
 // src/commands/init.ts
 import pc2 from "picocolors";
+var DEFAULT_INIT_THRESHOLDS = {
+  patch: 80,
+  project: 90
+};
 var INIT_YAML_HEADER = "# Config schema \u2014 see https://tested.dev/docs/config\n";
 var DEFAULT_INIT_IGNORES = [
   "**/*.test.ts",
@@ -179,9 +185,11 @@ function buildInitYaml(args) {
   if (args.testRunner) {
     lines.push(`testRunner: ${args.testRunner}`);
   }
+  lines.push("# Patch gate is skipped when the diff has no executable lines");
+  lines.push("# (tests-only, comments-only, docs-only, or ignored files).");
   lines.push("thresholds:");
-  lines.push("  patch: 80");
-  lines.push("  project: 60");
+  lines.push(`  patch: ${DEFAULT_INIT_THRESHOLDS.patch}`);
+  lines.push(`  project: ${DEFAULT_INIT_THRESHOLDS.project}`);
   lines.push("ignores:");
   for (const pattern of DEFAULT_INIT_IGNORES) {
     lines.push(`  - "${pattern}"`);
@@ -545,7 +553,9 @@ var FileCoverageSchema = z2.object({
 var CoverageTotalsSchema = z2.object({
   executable: z2.number().int().nonnegative(),
   covered: z2.number().int().nonnegative(),
-  pct: z2.number().min(0).max(100)
+  pct: z2.number().min(0).max(100),
+  /** Present when executable === 0 — not a 0% coverage result. */
+  empty: z2.literal(true).optional()
 });
 var ProjectTotalsSchema = CoverageTotalsSchema.extend({
   delta: z2.number().nullable()
@@ -614,7 +624,14 @@ async function headSha(ctx) {
   return (await ctx.git.revparse(["HEAD"])).trim();
 }
 async function unifiedDiff(ctx, base) {
-  return ctx.git.diff([`${base}...HEAD`]);
+  try {
+    const mergeBase = (await ctx.git.raw(["merge-base", base, "HEAD"])).trim();
+    if (mergeBase) {
+      return ctx.git.diff([`${base}...HEAD`]);
+    }
+  } catch {
+  }
+  return ctx.git.diff([base, "HEAD"]);
 }
 async function remoteUrl(ctx, remote = "origin") {
   return (await ctx.git.raw(["remote", "get-url", remote])).trim();
@@ -763,6 +780,10 @@ function assertWithinRoot(root, resolvedPath) {
 }
 
 // src/core/patch.ts
+var EMPTY_PATCH_REASON = "no executable lines in the patch";
+function isEmptyPatch(totals) {
+  return totals.executable === 0;
+}
 function pct(covered, executable) {
   if (executable === 0) return 0;
   return Math.round(covered / executable * 1e3) / 10;
@@ -862,10 +883,10 @@ function uncoveredRanges(file) {
 function buildDiffOutput(args) {
   const patch = computePatchCoverage(args.files, args.addedByFile);
   const project = computeProjectCoverage(args.files);
-  const fileNames = /* @__PURE__ */ new Set([
-    ...patch.byFile.keys(),
-    ...project.byFile.keys()
-  ]);
+  const emptyPatch = isEmptyPatch(patch.totals);
+  const fileNames = new Set(
+    emptyPatch ? [] : [...patch.byFile.keys(), ...project.byFile.keys()]
+  );
   const files = [];
   for (const name of fileNames) {
     const file = args.files.find((f) => f.path === name);
@@ -882,7 +903,7 @@ function buildDiffOutput(args) {
     schemaVersion: 1,
     base: args.base,
     head: args.head,
-    patch: patch.totals,
+    patch: emptyPatch ? { ...patch.totals, empty: true } : patch.totals,
     project: { ...project.totals, delta: args.projectDelta ?? null },
     files,
     ignored: [...args.ignored]
@@ -1508,6 +1529,7 @@ function registerPushCommand(program2) {
 
 // src/commands/doctor.ts
 var TESTED_BIN_BASENAME_RE = /^tested(\.js)?$/;
+var MIN_NODE_MAJOR = 24;
 function statusBadge(status) {
   const kind = status === "pass" ? "pass" : status === "fail" ? "fail" : status === "warn" ? "warn" : "info";
   return badge(kind);
@@ -1574,20 +1596,19 @@ async function runDoctor(deps) {
   const checks = [];
   const major = parseNodeMajor(nodeVersion);
   const nodeDisplay = nodeVersion.replace(/^v/, "v");
-  if (major !== null && major >= 22) {
+  if (major !== null && major >= MIN_NODE_MAJOR) {
     checks.push({
       id: "node",
       label: "Node.js",
       status: "pass",
-      detail: `${nodeDisplay} (>= 20.19; 22+ recommended)`
+      detail: `${nodeDisplay} (>= ${MIN_NODE_MAJOR})`
     });
   } else {
     checks.push({
       id: "node",
       label: "Node.js",
-      status: "warn",
-      detail: `${nodeDisplay} runs this CLI. Node >= 22 recommended.`,
-      optional: true
+      status: "fail",
+      detail: `${nodeDisplay} is below ${MIN_NODE_MAJOR}. Node >= ${MIN_NODE_MAJOR} required.`
     });
   }
   let isRepo = false;
@@ -1809,7 +1830,7 @@ async function runDoctor(deps) {
       optional: true
     });
   }
-  const hardFailIds = /* @__PURE__ */ new Set(["git", "config", "origin"]);
+  const hardFailIds = /* @__PURE__ */ new Set(["node", "git", "config", "origin"]);
   const safetyFailIds = /* @__PURE__ */ new Set(["api_url", "tested_bin", "token"]);
   const hasHardFail = checks.some(
     (c) => c.status === "fail" && hardFailIds.has(c.id)
@@ -1854,6 +1875,73 @@ function registerDoctorCommand(program2) {
 
 // src/commands/setup.ts
 import pc3 from "picocolors";
+
+// package.json
+var package_default = {
+  name: "@tested/cli",
+  version: "0.1.2",
+  description: "Coverage your agent can use. CLI for patch + project coverage with agent-readable JSON output.",
+  license: "MIT",
+  homepage: "https://tested.dev",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/tested-hq/cli.git"
+  },
+  bugs: {
+    url: "https://github.com/tested-hq/cli/issues"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  type: "module",
+  packageManager: "pnpm@11.3.0",
+  bin: {
+    tested: "./dist/tested.js",
+    td: "./dist/tested.js"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    build: "tsup",
+    dev: "tsx bin/tested.ts",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    typecheck: "tsc --noEmit",
+    prepare: "node ./scripts/prepare.mjs",
+    prepublishOnly: "pnpm run build"
+  },
+  engines: {
+    node: ">=24"
+  },
+  dependencies: {
+    commander: "14.0.3",
+    minimatch: "10.2.5",
+    picocolors: "1.1.1",
+    "simple-git": "3.36.0",
+    yaml: "2.9.0",
+    zod: "4.4.3"
+  },
+  devDependencies: {
+    "@types/node": "25.9.1",
+    "@vitest/coverage-v8": "4.1.7",
+    husky: "9.1.7",
+    "is-ci": "3.0.1",
+    tsup: "8.5.1",
+    tsx: "4.22.3",
+    typescript: "6.0.3",
+    vite: "8.0.14",
+    vitest: "4.1.7"
+  }
+};
+
+// src/version.ts
+var CLI_VERSION = package_default.version;
+
+// src/commands/setup.ts
 var PINNED_CLI = "@tested/cli";
 function buildCiSnippet() {
   return [
@@ -1865,12 +1953,9 @@ function buildCiSnippet() {
     "    runs-on: ubuntu-latest",
     "    steps:",
     "      - uses: actions/checkout@v4",
-    "        with:",
-    "          fetch-depth: 0",
     "      - uses: tested-hq/cli/action@main",
     "        with:",
-    "          # pin ref for reproducible installs (do not use floating tags in prod)",
-    "          cli-ref: main",
+    `          version: ${CLI_VERSION}`,
     "          push: true",
     "          pr-number: ${{ github.event.pull_request.number }}",
     "          token: ${{ secrets.TESTED_TOKEN }}"
@@ -1887,6 +1972,7 @@ function buildTokenInstructions() {
 function buildInstallInstructions() {
   return [
     "Install CLI:",
+    "  Node 24+",
     `  pnpm add -D ${PINNED_CLI}`,
     `  # or: npx ${PINNED_CLI}`,
     "",
@@ -1931,6 +2017,12 @@ function formatSetupHuman(opts) {
     ])
   );
   lines.push("");
+  lines.push(
+    dim(
+      "Patch gate is skipped when the diff has no executable lines (tests-only, docs, comments)."
+    )
+  );
+  lines.push("");
   lines.push(tip("re-check anytime: tested doctor"));
   lines.push("");
   return lines.join("\n");
@@ -2196,8 +2288,8 @@ function coloredPctCell(pct3, width = 6) {
 function formatMetricRow(label, pct3, covered, executable, emptyNote) {
   const labelPad = label.padEnd(8);
   if (executable === 0) {
-    const note = emptyNote ?? "no executable lines";
-    return `  ${labelPad}  ${dim("-".padEnd(6))}  ${dim(note)}`;
+    const note = emptyNote ?? EMPTY_PATCH_REASON;
+    return `  ${labelPad}  ${dim("-".padEnd(6))}  ${note}`;
   }
   const pctStr = coloredPctCell(pct3);
   const bar = metricBar(pct3);
@@ -2216,7 +2308,7 @@ function formatHuman(out, opts = {}) {
       out.patch.pct,
       out.patch.covered,
       out.patch.executable,
-      "no executable lines in patch"
+      EMPTY_PATCH_REASON
     )
   );
   const projectRow = formatMetricRow(
@@ -2229,7 +2321,7 @@ function formatHuman(out, opts = {}) {
   if (opts.thresholds) {
     const patchPass = out.patch.pct >= opts.thresholds.patch;
     const projectPass = out.project.pct >= opts.thresholds.project;
-    const patchOk = out.patch.executable === 0 ? true : patchPass;
+    const patchOk = isEmptyPatch(out.patch) ? true : patchPass;
     const overall = patchOk && projectPass;
     const details = [];
     if (!patchOk) {
@@ -2240,7 +2332,7 @@ function formatHuman(out, opts = {}) {
         `project ${out.project.pct.toFixed(1)}% < ${opts.thresholds.project}%`
       );
     }
-    const detail = details.length > 0 ? dim(`  ${details.join("; ")}`) : "";
+    const detail = details.length > 0 ? dim(`  ${details.join("; ")}`) : isEmptyPatch(out.patch) ? dim(`  ${EMPTY_PATCH_REASON}`) : "";
     lines.push(
       `  ${"Gate".padEnd(8)}  ${overall ? badge("pass") : badge("fail")}${detail}`
     );
@@ -2253,12 +2345,15 @@ function formatHuman(out, opts = {}) {
       );
     }
   }
-  if (out.files.length > 0) {
+  if (isEmptyPatch(out.patch)) {
+    lines.push("");
+    lines.push(dim("No executable lines in the patch \u2014 patch gate does not apply."));
+  } else if (out.files.length > 0) {
     lines.push("");
     lines.push(heading("Files in diff:"));
     const anyPatch = out.files.some((f) => f.patchCoverage !== null);
     if (!anyPatch) {
-      lines.push(dim("  (project coverage \u2014 no executable lines in patch)"));
+      lines.push(dim(`  (project coverage \u2014 ${EMPTY_PATCH_REASON})`));
     }
     for (const f of out.files) {
       const hasPatch = f.patchCoverage !== null;
@@ -2344,7 +2439,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
   const projectPct = diff.project.pct;
   const patchThreshold = config.thresholds.patch;
   const projectThreshold = config.thresholds.project;
-  const patchSkipped = diff.patch.executable === 0;
+  const patchSkipped = isEmptyPatch(diff.patch);
   const patchPass = patchSkipped ? true : patchPct >= patchThreshold;
   const projectPass = projectPct >= projectThreshold;
   const overall = patchPass && projectPass ? "pass" : "fail";
@@ -2355,10 +2450,11 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
         pct: patchPct,
         threshold: patchThreshold,
         pass: patchPass,
-        ...patchSkipped ? { skipped: true } : {}
+        ...patchSkipped ? { skipped: true, reason: EMPTY_PATCH_REASON } : {}
       },
       project: { pct: projectPct, threshold: projectThreshold, pass: projectPass },
-      overall
+      overall,
+      ...patchSkipped ? { note: EMPTY_PATCH_REASON } : {}
     };
     return {
       skipped: false,
@@ -2377,7 +2473,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
   lines.push("");
   if (patchSkipped) {
     lines.push(
-      `  ${"Patch".padEnd(8)}  ${dim("-")}  ${dim("(no executable lines \u2014 skipped)")}  ${badge("info")}`
+      `  ${"Patch".padEnd(8)}  ${dim("-")}  ${EMPTY_PATCH_REASON}  ${badge("skip")}`
     );
   } else {
     lines.push(formatMetricLine("Patch", patchPct, patchThreshold, patchPass));
@@ -2385,10 +2481,17 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
   lines.push(formatMetricLine("Project", projectPct, projectThreshold, projectPass));
   if (overall === "fail") {
     lines.push("");
+    if (patchSkipped) {
+      lines.push(dim("No executable lines in the patch \u2014 patch gate skipped."));
+    }
     lines.push(tip("add tests for uncovered ranges: tested diff"));
   } else {
     lines.push("");
-    lines.push(dim(patchSkipped ? "project thresholds met (patch skipped)" : "thresholds met"));
+    lines.push(
+      dim(
+        patchSkipped ? "No executable lines in the patch \u2014 patch gate skipped. Project threshold met." : "thresholds met"
+      )
+    );
   }
   lines.push("");
   return {
@@ -2561,7 +2664,7 @@ function createProgram() {
       "Agent loop:",
       "  tested setup \u2192 tested run \u2192 tested diff \u2192 tested check \u2192 tested push --pr <n>"
     ].join("\n")
-  ).version("0.1.0");
+  ).version(CLI_VERSION);
   registerSetupCommand(program2);
   registerDoctorCommand(program2);
   registerInitCommand(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tested/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Coverage your agent can use. CLI for patch + project coverage with agent-readable JSON output.",
   "license": "MIT",
   "homepage": "https://tested.dev",
@@ -18,7 +18,7 @@
   "packageManager": "pnpm@11.3.0",
   "bin": {
     "tested": "./dist/tested.js",
-    "td": "./dist/td.js"
+    "td": "./dist/tested.js"
   },
   "files": [
     "dist",
@@ -36,7 +36,7 @@
     "prepublishOnly": "pnpm run build"
   },
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=24"
   },
   "dependencies": {
     "commander": "14.0.3",