@tested/cli 0.1.8 → 0.1.10

package/README.md

@@ -25,7 +25,7 @@ CI uses the composite Action (`tested-hq/cli/action@main`). It installs `@tested
 ```yaml
 - uses: tested-hq/cli/action@main
   with:
-    version: 0.1.8
+    version: 0.1.10
     token: ${{ secrets.TESTED_TOKEN }}
 ```
 
@@ -132,7 +132,7 @@ If `thresholds` is missing from `.tested.yaml`, `tested check` prints a notice o
 
 ### Flags (per package)
 
-Independent floors so a monorepo total cannot hide one package. Each flag is graded from **this run's** coverage files — no carryforward.
+Independent floors so a monorepo total cannot hide one package. Each flag is graded from **this run's** coverage files.
 
 ```yaml
 flags:
@@ -144,11 +144,11 @@ flags:
     paths: ["apps/api/**"]
 ```
 
-`tested check` applies global `thresholds` plus each flag whose paths appear in the merged coverage. Per-flag patch is new executable lines in those paths. A flag with no files this run is **missing** (fail / pending) — never last week's numbers.
+`tested check` applies global `thresholds` plus each flag whose paths appear in the merged coverage. Per-flag patch is new executable lines in those paths. A flag with no files this run is **skipped** (not 0%) — an affected-graph or scoped job that did not collect that package is not a fail.
 
-A job already scoped to one package: `tested check --flag frontend` (Action `flag:`). That coverage file **is** the flag.
+A job already scoped to one package: `tested check --flag frontend` (Action `flag:`). That coverage file **is** the flag. Other packages are omitted from this upload.
 
-`--json` lists per-flag results (`flags.frontend.patchCheck` → `tested.dev / patch / frontend`). `tested push` sends that same `flags` map on ingest so the app can post those GitHub checks. `tested diff --json` includes it too.
+`--json` lists per-flag results (`flags.frontend.patchCheck` → `tested.dev / patch / frontend`). Skipped flags have `status: missing` and `skipped: true` with no `executable` / `pct`. `tested push` omits skipped flags from ingest so the last successful upload for that package still stands. `tested diff --json` includes the same map as check.
 
 ## Coverage formats
 
@@ -195,7 +195,7 @@ Or pass `--file` repeatedly / Action `files`. A CI matrix must not conclude the
 ```yaml
 - uses: tested-hq/cli/action@main
   with:
-    version: 0.1.8
+    version: 0.1.10
     push: true
     pr-number: ${{ github.event.pull_request.number }}
     token: ${{ secrets.TESTED_TOKEN }}

package/dist/td.js

@@ -1106,6 +1106,9 @@ var FlagConfigSchema = z2.object({
   paths: z2.array(z2.string().min(1)).min(1),
   thresholds: FlagThresholdsSchema.optional()
 });
+var PathThresholdSchema = FlagThresholdsSchema.extend({
+  glob: z2.string().min(1)
+});
 var TestedConfigSchema = z2.object({
   ignores: z2.array(z2.string()).default([]),
   coverage: z2.object({
@@ -1125,11 +1128,16 @@ var TestedConfigSchema = z2.object({
   // doesn't silently drop the field.
   thresholds: z2.object({
     patch: z2.number().min(0).max(100),
-    project: z2.number().min(0).max(100)
+    project: z2.number().min(0).max(100),
+    /**
+     * Per-path glob floors. Graded from this run's matched files only.
+     * A glob with no files this run is skipped (not 0%). Not flags.
+     */
+    paths: z2.array(PathThresholdSchema).optional()
   }).optional(),
   /**
    * Per-package gates. Each flag is graded from this run's coverage files
-   * only — a missing path is missing (pending/fail), never last week's totals.
+   * only — a missing path is skipped (not 0%), never another flag's totals.
    */
   flags: z2.record(FlagNameSchema, FlagConfigSchema).optional()
 });
@@ -1164,17 +1172,21 @@ var DiffOutputSchema = z2.object({
   ignored: z2.array(z2.string())
 });
 var FlagMetricJsonSchema = z2.object({
-  pct: z2.number().min(0).max(100),
+  /** Omitted when this flag had no files this run (`skipped: true`). */
+  pct: z2.number().min(0).max(100).optional(),
   threshold: z2.number().min(0).max(100),
-  pass: z2.boolean(),
-  executable: z2.number().int().nonnegative(),
-  covered: z2.number().int().nonnegative(),
+  /** Omitted when skipped — a missing flag is not a 0% fail. */
+  pass: z2.boolean().optional(),
+  executable: z2.number().int().nonnegative().optional(),
+  covered: z2.number().int().nonnegative().optional(),
   skipped: z2.literal(true).optional(),
   reason: z2.string().optional()
 });
 var FlagResultJsonSchema = z2.object({
   status: z2.enum(["pass", "fail", "missing"]),
   present: z2.boolean(),
+  /** True when this flag had no coverage files this run (not a 0% result). */
+  skipped: z2.literal(true).optional(),
   reason: z2.string().optional(),
   patchCheck: z2.string(),
   projectCheck: z2.string(),
@@ -1182,6 +1194,16 @@ var FlagResultJsonSchema = z2.object({
   project: FlagMetricJsonSchema
 });
 var FlagsJsonMapSchema = z2.record(FlagNameSchema, FlagResultJsonSchema);
+var PathResultJsonSchema = z2.object({
+  glob: z2.string().min(1),
+  status: z2.enum(["pass", "fail", "missing"]),
+  present: z2.boolean(),
+  skipped: z2.literal(true).optional(),
+  reason: z2.string().optional(),
+  patch: FlagMetricJsonSchema,
+  project: FlagMetricJsonSchema
+});
+var PathsJsonSchema = z2.array(PathResultJsonSchema);
 
 // src/config.ts
 var DEFAULT_IGNORES = [
@@ -1696,19 +1718,28 @@ async function computeDiffContext(opts) {
   return { diff, files, addedByFile };
 }
 
-// src/core/flags.ts
+// src/core/globs.ts
 import { minimatch as minimatch2 } from "minimatch";
-var MISSING_FLAG_REASON = "no coverage files matched this flag in this run";
-var SCOPED_MISSING_FLAG_REASON = "no coverage files in this run for this flag";
 var MATCH_OPTS = { dot: true, matchBase: true };
-function pathMatchesFlag(filePath, patterns) {
-  const normalized = filePath.replace(/\\/g, "/");
-  return patterns.some(
-    (p) => minimatch2(normalized, p, MATCH_OPTS) || minimatch2(normalized, `**/${p}`, MATCH_OPTS)
-  );
+function normalizeRepoPath(filePath) {
+  return filePath.replace(/\\/g, "/");
+}
+function pathMatchesGlob(filePath, pattern) {
+  const normalized = normalizeRepoPath(filePath);
+  return minimatch2(normalized, pattern, MATCH_OPTS) || minimatch2(normalized, `**/${pattern}`, MATCH_OPTS);
+}
+function pathMatchesAnyGlob(filePath, patterns) {
+  return patterns.some((p) => pathMatchesGlob(filePath, p));
 }
+function filterFilesByGlobs(files, patterns) {
+  return files.filter((f) => pathMatchesAnyGlob(f.path, patterns));
+}
+
+// src/core/flags.ts
+var MISSING_FLAG_REASON = "no coverage files matched this flag in this run";
+var SCOPED_MISSING_FLAG_REASON = "no coverage files in this run for this flag";
 function filterFilesByFlag(files, patterns) {
-  return files.filter((f) => pathMatchesFlag(f.path, patterns));
+  return filterFilesByGlobs(files, patterns);
 }
 function resolveFlagThresholds(flag, global) {
   return {
@@ -1742,13 +1773,11 @@ function totalsToMetric(totals, threshold, kind) {
     covered: totals.covered
   };
 }
-function missingMetric(threshold) {
+function missingMetric(threshold, reason) {
   return {
-    pct: 0,
     threshold,
-    pass: false,
-    executable: 0,
-    covered: 0
+    skipped: true,
+    reason
   };
 }
 function checkSlug(kind, name) {
@@ -1778,8 +1807,8 @@ function missingFlag(name, thresholds, reason) {
     reason,
     patchCheck: checkSlug("patch", name),
     projectCheck: checkSlug("project", name),
-    patch: missingMetric(thresholds.patch),
-    project: missingMetric(thresholds.project)
+    patch: missingMetric(thresholds.patch, reason),
+    project: missingMetric(thresholds.project, reason)
   };
 }
 function evaluateFlags(input) {
@@ -1810,7 +1839,7 @@ function evaluateFlags(input) {
   return results;
 }
 function flagsPass(results) {
-  return results.every((f) => f.status === "pass");
+  return results.every((f) => f.status !== "fail");
 }
 function flagsToJson(results) {
   const out = {};
@@ -1818,19 +1847,44 @@ function flagsToJson(results) {
     out[flag.name] = {
       status: flag.status,
       present: flag.present,
+      ...flag.status === "missing" ? { skipped: true } : {},
       ...flag.reason ? { reason: flag.reason } : {},
       patchCheck: flag.patchCheck,
       projectCheck: flag.projectCheck,
-      patch: flag.patch,
-      project: flag.project
+      patch: metricToJson(flag.patch),
+      project: metricToJson(flag.project)
     };
   }
   return out;
 }
+function metricToJson(metric) {
+  if (metric.skipped) {
+    return {
+      threshold: metric.threshold,
+      skipped: true,
+      ...metric.reason ? { reason: metric.reason } : {}
+    };
+  }
+  return {
+    pct: metric.pct ?? 0,
+    threshold: metric.threshold,
+    pass: metric.pass ?? false,
+    executable: metric.executable ?? 0,
+    covered: metric.covered ?? 0,
+    ...metric.reason ? { reason: metric.reason } : {}
+  };
+}
+function flagsToIngestJson(results) {
+  const present = results.filter((f) => f.present);
+  return present.length > 0 ? flagsToJson(present) : void 0;
+}
 function resolveFlagsJson(input) {
   const results = evaluateFlags(input);
   return results.length > 0 ? flagsToJson(results) : void 0;
 }
+function resolveIngestFlagsJson(input) {
+  return flagsToIngestJson(evaluateFlags(input));
+}
 
 // src/core/coverage-merge.ts
 function emptyToUndef(value) {
@@ -2553,7 +2607,7 @@ async function executePush(cli, deps) {
   let flags;
   if (!handshakeOnly && !computeDiffFn) {
     try {
-      flags = resolveFlagsJson({
+      flags = resolveIngestFlagsJson({
         config,
         files,
         addedByFile,
@@ -3072,7 +3126,7 @@ import pc3 from "picocolors";
 // package.json
 var package_default = {
   name: "@tested/cli",
-  version: "0.1.8",
+  version: "0.1.10",
   description: "Coverage your agent can use. CLI for patch + project coverage with agent-readable JSON output.",
   license: "MIT",
   homepage: "https://tested.dev",
@@ -3482,6 +3536,116 @@ function registerRunCommand(program2) {
 // src/commands/diff.ts
 import "commander";
 
+// src/core/path-thresholds.ts
+var MISSING_PATH_REASON = "no coverage files matched this path glob in this run";
+function resolvePathThresholds(entry, global) {
+  return {
+    patch: entry.patch ?? global.patch,
+    project: entry.project ?? global.project
+  };
+}
+function totalsToMetric2(totals, threshold, kind) {
+  const empty = isEmptyPatch(totals);
+  if (kind === "patch" && empty) {
+    return {
+      pct: totals.pct,
+      threshold,
+      pass: true,
+      executable: totals.executable,
+      covered: totals.covered,
+      skipped: true,
+      reason: EMPTY_PATCH_REASON
+    };
+  }
+  const pass = totals.pct >= threshold;
+  return {
+    pct: totals.pct,
+    threshold,
+    pass,
+    executable: totals.executable,
+    covered: totals.covered
+  };
+}
+function missingMetric2(threshold, reason) {
+  return {
+    threshold,
+    skipped: true,
+    reason
+  };
+}
+function evaluatePresentPath(glob, files, addedByFile, thresholds) {
+  const patch = computePatchCoverage(files, addedByFile);
+  const project = computeProjectCoverage(files);
+  const patchMetric = totalsToMetric2(patch.totals, thresholds.patch, "patch");
+  const projectMetric = totalsToMetric2(project.totals, thresholds.project, "project");
+  const status = patchMetric.pass && projectMetric.pass ? "pass" : "fail";
+  return {
+    glob,
+    present: true,
+    status,
+    patch: patchMetric,
+    project: projectMetric
+  };
+}
+function missingPath(glob, thresholds, reason) {
+  return {
+    glob,
+    present: false,
+    status: "missing",
+    reason,
+    patch: missingMetric2(thresholds.patch, reason),
+    project: missingMetric2(thresholds.project, reason)
+  };
+}
+function evaluatePathThresholds(input) {
+  const global = input.config.thresholds;
+  const entries = global?.paths;
+  if (!global || !entries || entries.length === 0) return [];
+  return entries.map((entry) => {
+    const thresholds = resolvePathThresholds(entry, global);
+    const matched = filterFilesByGlobs(input.files, [entry.glob]);
+    if (matched.length === 0) {
+      return missingPath(entry.glob, thresholds, MISSING_PATH_REASON);
+    }
+    return evaluatePresentPath(entry.glob, matched, input.addedByFile, thresholds);
+  });
+}
+function pathThresholdsPass(results) {
+  return results.every((p) => p.status !== "fail");
+}
+function pathThresholdsToJson(results) {
+  return results.map((path) => ({
+    glob: path.glob,
+    status: path.status,
+    present: path.present,
+    ...path.status === "missing" ? { skipped: true } : {},
+    ...path.reason ? { reason: path.reason } : {},
+    patch: metricToJson2(path.patch),
+    project: metricToJson2(path.project)
+  }));
+}
+function metricToJson2(metric) {
+  if (metric.skipped) {
+    return {
+      threshold: metric.threshold,
+      skipped: true,
+      ...metric.reason ? { reason: metric.reason } : {}
+    };
+  }
+  return {
+    pct: metric.pct ?? 0,
+    threshold: metric.threshold,
+    pass: metric.pass ?? false,
+    executable: metric.executable ?? 0,
+    covered: metric.covered ?? 0,
+    ...metric.reason ? { reason: metric.reason } : {}
+  };
+}
+function resolvePathThresholdsJson(input) {
+  const results = evaluatePathThresholds(input);
+  return results.length > 0 ? pathThresholdsToJson(results) : void 0;
+}
+
 // src/output/human.ts
 function formatRange(r) {
   return r.start === r.end ? `${r.start}` : `${r.start}-${r.end}`;
@@ -3629,7 +3793,12 @@ function registerDiffCommand(program2) {
       });
       if (opts.json) {
         const flags = resolveFlagsJson({ config, files, addedByFile });
-        const payload = flags ? { ...diff, flags } : diff;
+        const paths = resolvePathThresholdsJson({ config, files, addedByFile });
+        const payload = {
+          ...diff,
+          ...flags ? { flags } : {},
+          ...paths ? { paths } : {}
+        };
         process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
       } else {
         process.stdout.write(
@@ -3659,6 +3828,7 @@ function formatIncompleteCheck(state, json) {
       projectPass: true,
       overall: "pass",
       flagResults: [],
+      pathResults: [],
       stdout: JSON.stringify({
         overall: "pending",
         complete: false,
@@ -3676,6 +3846,7 @@ function formatIncompleteCheck(state, json) {
     projectPass: true,
     overall: "pass",
     flagResults: [],
+    pathResults: [],
     stdout: "",
     stderr: `${dim("tested.dev \u2014 coverage gate")}  ${badge("info")}
 
@@ -3694,6 +3865,7 @@ function formatCompleteHandshakeCheck(json) {
       projectPass: true,
       overall: "pass",
       flagResults: [],
+      pathResults: [],
       stdout: JSON.stringify({ overall: "pending", complete: true, note }) + "\n",
       stderr: "",
       exitCode: 0
@@ -3705,6 +3877,7 @@ function formatCompleteHandshakeCheck(json) {
     projectPass: true,
     overall: "pass",
     flagResults: [],
+    pathResults: [],
     stdout: "",
     stderr: `${dim("tested.dev \u2014 coverage gate")}  ${badge("info")}
 
@@ -3718,6 +3891,12 @@ function formatMetricLine(label, pct3, threshold, pass, indent = "  ") {
   const status = pass ? badge("pass") : badge("fail");
   return `${indent}${label.padEnd(8)}  ${pctStr}%  (threshold ${threshold})  ${status}`;
 }
+function presentPct(metric) {
+  if (metric.pct === void 0 || metric.pass === void 0) {
+    throw new Error("present metric missing pct/pass");
+  }
+  return { pct: metric.pct, pass: metric.pass };
+}
 function formatFlagLines(results) {
   if (results.length === 0) return [];
   const lines = [""];
@@ -3734,16 +3913,52 @@ function formatFlagLines(results) {
         `    ${"Patch".padEnd(8)}  ${dim("-")}  ${EMPTY_PATCH_REASON}  ${badge("skip")}`
       );
     } else {
+      const patch = presentPct(flag.patch);
       lines.push(
-        formatMetricLine("Patch", flag.patch.pct, flag.patch.threshold, flag.patch.pass, "    ")
+        formatMetricLine("Patch", patch.pct, flag.patch.threshold, patch.pass, "    ")
       );
     }
+    const project = presentPct(flag.project);
     lines.push(
       formatMetricLine(
         "Project",
-        flag.project.pct,
+        project.pct,
         flag.project.threshold,
-        flag.project.pass,
+        project.pass,
+        "    "
+      )
+    );
+  }
+  return lines;
+}
+function formatPathLines(results) {
+  if (results.length === 0) return [];
+  const lines = [""];
+  for (const path of results) {
+    if (path.status === "missing") {
+      lines.push(
+        `  ${path.glob}  ${dim(path.reason ?? "missing this run")}  ${badge("missing")}`
+      );
+      continue;
+    }
+    lines.push(`  ${path.glob}  ${path.status === "pass" ? badge("pass") : badge("fail")}`);
+    if (path.patch.skipped) {
+      lines.push(
+        `    ${"Patch".padEnd(8)}  ${dim("-")}  ${EMPTY_PATCH_REASON}  ${badge("skip")}`
+      );
+    } else {
+      const patch = presentPct(path.patch);
+      lines.push(
+        formatMetricLine("Patch", patch.pct, path.patch.threshold, patch.pass, "    ")
+      );
+    }
+    const project = presentPct(path.project);
+    lines.push(
+      formatMetricLine(
+        "Project",
+        project.pct,
+        path.project.threshold,
+        project.pass,
         "    "
       )
     );
@@ -3759,6 +3974,7 @@ function runCheck(input) {
       projectPass: true,
       overall: "pass",
       flagResults: [],
+      pathResults: [],
       stdout: "",
       stderr: `${dim("tested.dev \u2014 coverage gate")}  ${badge("info")}
 
@@ -3781,8 +3997,14 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
     addedByFile: input.addedByFile ?? /* @__PURE__ */ new Map(),
     ...input.onlyFlag !== void 0 ? { onlyFlag: input.onlyFlag } : {}
   });
+  const pathResults = evaluatePathThresholds({
+    config,
+    files: input.files ?? [],
+    addedByFile: input.addedByFile ?? /* @__PURE__ */ new Map()
+  });
   const flagsOk = flagsPass(flagResults);
-  const overall = patchPass && projectPass && flagsOk ? "pass" : "fail";
+  const pathsOk = pathThresholdsPass(pathResults);
+  const overall = patchPass && projectPass && flagsOk && pathsOk ? "pass" : "fail";
   const exitCode = overall === "pass" ? 0 : 1;
   if (json) {
     const payload = {
@@ -3794,6 +4016,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
       },
       project: { pct: projectPct, threshold: projectThreshold, pass: projectPass },
       ...flagResults.length > 0 ? { flags: flagsToJson(flagResults) } : {},
+      ...pathResults.length > 0 ? { paths: pathThresholdsToJson(pathResults) } : {},
       overall,
       ...patchSkipped ? { note: EMPTY_PATCH_REASON } : {}
     };
@@ -3803,6 +4026,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
       projectPass,
       overall,
       flagResults,
+      pathResults,
       stdout: JSON.stringify(payload) + "\n",
       stderr: "",
       exitCode
@@ -3822,6 +4046,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
   }
   lines.push(formatMetricLine("Project", projectPct, projectThreshold, projectPass));
   lines.push(...formatFlagLines(flagResults));
+  lines.push(...formatPathLines(pathResults));
   if (overall === "fail") {
     lines.push("");
     if (patchSkipped) {
@@ -3831,10 +4056,16 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
     if (missing.length > 0) {
       lines.push(
         dim(
-          "Missing flags fail this run (no carryforward). Collect that package's coverage or scope the job with --flag."
+          "Flags with no files this run are skipped (not 0%). Scope the job with --flag when this coverage file is one package."
         )
       );
     }
+    const missingPaths = pathResults.filter((p) => p.status === "missing");
+    if (missingPaths.length > 0) {
+      lines.push(
+        dim("Path globs with no files this run are skipped (not 0%).")
+      );
+    }
     lines.push(tip("add tests for uncovered ranges: tested diff"));
   } else {
     lines.push("");
@@ -3851,6 +4082,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
     projectPass,
     overall,
     flagResults,
+    pathResults,
     stdout: lines.join("\n"),
     stderr: "",
     exitCode
@@ -3858,7 +4090,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
 }
 function registerCheckCommand(program2) {
   program2.command("check").description(
-    "Exit non-zero if patch or project coverage falls below configured thresholds."
+    "Exit non-zero if patch, project, or path coverage falls below configured thresholds."
   ).option("--json", "Emit machine-readable JSON to stdout (exit code unchanged).", false).option("--base <ref>", "Git base ref to diff against", void 0).option(
     "--file <path>",
     "Coverage file to merge (repeatable). Overrides coverage.path.",

package/dist/tested.js

@@ -1106,6 +1106,9 @@ var FlagConfigSchema = z2.object({
   paths: z2.array(z2.string().min(1)).min(1),
   thresholds: FlagThresholdsSchema.optional()
 });
+var PathThresholdSchema = FlagThresholdsSchema.extend({
+  glob: z2.string().min(1)
+});
 var TestedConfigSchema = z2.object({
   ignores: z2.array(z2.string()).default([]),
   coverage: z2.object({
@@ -1125,11 +1128,16 @@ var TestedConfigSchema = z2.object({
   // doesn't silently drop the field.
   thresholds: z2.object({
     patch: z2.number().min(0).max(100),
-    project: z2.number().min(0).max(100)
+    project: z2.number().min(0).max(100),
+    /**
+     * Per-path glob floors. Graded from this run's matched files only.
+     * A glob with no files this run is skipped (not 0%). Not flags.
+     */
+    paths: z2.array(PathThresholdSchema).optional()
   }).optional(),
   /**
    * Per-package gates. Each flag is graded from this run's coverage files
-   * only — a missing path is missing (pending/fail), never last week's totals.
+   * only — a missing path is skipped (not 0%), never another flag's totals.
    */
   flags: z2.record(FlagNameSchema, FlagConfigSchema).optional()
 });
@@ -1164,17 +1172,21 @@ var DiffOutputSchema = z2.object({
   ignored: z2.array(z2.string())
 });
 var FlagMetricJsonSchema = z2.object({
-  pct: z2.number().min(0).max(100),
+  /** Omitted when this flag had no files this run (`skipped: true`). */
+  pct: z2.number().min(0).max(100).optional(),
   threshold: z2.number().min(0).max(100),
-  pass: z2.boolean(),
-  executable: z2.number().int().nonnegative(),
-  covered: z2.number().int().nonnegative(),
+  /** Omitted when skipped — a missing flag is not a 0% fail. */
+  pass: z2.boolean().optional(),
+  executable: z2.number().int().nonnegative().optional(),
+  covered: z2.number().int().nonnegative().optional(),
   skipped: z2.literal(true).optional(),
   reason: z2.string().optional()
 });
 var FlagResultJsonSchema = z2.object({
   status: z2.enum(["pass", "fail", "missing"]),
   present: z2.boolean(),
+  /** True when this flag had no coverage files this run (not a 0% result). */
+  skipped: z2.literal(true).optional(),
   reason: z2.string().optional(),
   patchCheck: z2.string(),
   projectCheck: z2.string(),
@@ -1182,6 +1194,16 @@ var FlagResultJsonSchema = z2.object({
   project: FlagMetricJsonSchema
 });
 var FlagsJsonMapSchema = z2.record(FlagNameSchema, FlagResultJsonSchema);
+var PathResultJsonSchema = z2.object({
+  glob: z2.string().min(1),
+  status: z2.enum(["pass", "fail", "missing"]),
+  present: z2.boolean(),
+  skipped: z2.literal(true).optional(),
+  reason: z2.string().optional(),
+  patch: FlagMetricJsonSchema,
+  project: FlagMetricJsonSchema
+});
+var PathsJsonSchema = z2.array(PathResultJsonSchema);
 
 // src/config.ts
 var DEFAULT_IGNORES = [
@@ -1696,19 +1718,28 @@ async function computeDiffContext(opts) {
   return { diff, files, addedByFile };
 }
 
-// src/core/flags.ts
+// src/core/globs.ts
 import { minimatch as minimatch2 } from "minimatch";
-var MISSING_FLAG_REASON = "no coverage files matched this flag in this run";
-var SCOPED_MISSING_FLAG_REASON = "no coverage files in this run for this flag";
 var MATCH_OPTS = { dot: true, matchBase: true };
-function pathMatchesFlag(filePath, patterns) {
-  const normalized = filePath.replace(/\\/g, "/");
-  return patterns.some(
-    (p) => minimatch2(normalized, p, MATCH_OPTS) || minimatch2(normalized, `**/${p}`, MATCH_OPTS)
-  );
+function normalizeRepoPath(filePath) {
+  return filePath.replace(/\\/g, "/");
+}
+function pathMatchesGlob(filePath, pattern) {
+  const normalized = normalizeRepoPath(filePath);
+  return minimatch2(normalized, pattern, MATCH_OPTS) || minimatch2(normalized, `**/${pattern}`, MATCH_OPTS);
+}
+function pathMatchesAnyGlob(filePath, patterns) {
+  return patterns.some((p) => pathMatchesGlob(filePath, p));
 }
+function filterFilesByGlobs(files, patterns) {
+  return files.filter((f) => pathMatchesAnyGlob(f.path, patterns));
+}
+
+// src/core/flags.ts
+var MISSING_FLAG_REASON = "no coverage files matched this flag in this run";
+var SCOPED_MISSING_FLAG_REASON = "no coverage files in this run for this flag";
 function filterFilesByFlag(files, patterns) {
-  return files.filter((f) => pathMatchesFlag(f.path, patterns));
+  return filterFilesByGlobs(files, patterns);
 }
 function resolveFlagThresholds(flag, global) {
   return {
@@ -1742,13 +1773,11 @@ function totalsToMetric(totals, threshold, kind) {
     covered: totals.covered
   };
 }
-function missingMetric(threshold) {
+function missingMetric(threshold, reason) {
   return {
-    pct: 0,
     threshold,
-    pass: false,
-    executable: 0,
-    covered: 0
+    skipped: true,
+    reason
   };
 }
 function checkSlug(kind, name) {
@@ -1778,8 +1807,8 @@ function missingFlag(name, thresholds, reason) {
     reason,
     patchCheck: checkSlug("patch", name),
     projectCheck: checkSlug("project", name),
-    patch: missingMetric(thresholds.patch),
-    project: missingMetric(thresholds.project)
+    patch: missingMetric(thresholds.patch, reason),
+    project: missingMetric(thresholds.project, reason)
   };
 }
 function evaluateFlags(input) {
@@ -1810,7 +1839,7 @@ function evaluateFlags(input) {
   return results;
 }
 function flagsPass(results) {
-  return results.every((f) => f.status === "pass");
+  return results.every((f) => f.status !== "fail");
 }
 function flagsToJson(results) {
   const out = {};
@@ -1818,19 +1847,44 @@ function flagsToJson(results) {
     out[flag.name] = {
       status: flag.status,
       present: flag.present,
+      ...flag.status === "missing" ? { skipped: true } : {},
       ...flag.reason ? { reason: flag.reason } : {},
       patchCheck: flag.patchCheck,
       projectCheck: flag.projectCheck,
-      patch: flag.patch,
-      project: flag.project
+      patch: metricToJson(flag.patch),
+      project: metricToJson(flag.project)
     };
   }
   return out;
 }
+function metricToJson(metric) {
+  if (metric.skipped) {
+    return {
+      threshold: metric.threshold,
+      skipped: true,
+      ...metric.reason ? { reason: metric.reason } : {}
+    };
+  }
+  return {
+    pct: metric.pct ?? 0,
+    threshold: metric.threshold,
+    pass: metric.pass ?? false,
+    executable: metric.executable ?? 0,
+    covered: metric.covered ?? 0,
+    ...metric.reason ? { reason: metric.reason } : {}
+  };
+}
+function flagsToIngestJson(results) {
+  const present = results.filter((f) => f.present);
+  return present.length > 0 ? flagsToJson(present) : void 0;
+}
 function resolveFlagsJson(input) {
   const results = evaluateFlags(input);
   return results.length > 0 ? flagsToJson(results) : void 0;
 }
+function resolveIngestFlagsJson(input) {
+  return flagsToIngestJson(evaluateFlags(input));
+}
 
 // src/core/coverage-merge.ts
 function emptyToUndef(value) {
@@ -2553,7 +2607,7 @@ async function executePush(cli, deps) {
   let flags;
   if (!handshakeOnly && !computeDiffFn) {
     try {
-      flags = resolveFlagsJson({
+      flags = resolveIngestFlagsJson({
         config,
         files,
         addedByFile,
@@ -3072,7 +3126,7 @@ import pc3 from "picocolors";
 // package.json
 var package_default = {
   name: "@tested/cli",
-  version: "0.1.8",
+  version: "0.1.10",
   description: "Coverage your agent can use. CLI for patch + project coverage with agent-readable JSON output.",
   license: "MIT",
   homepage: "https://tested.dev",
@@ -3482,6 +3536,116 @@ function registerRunCommand(program2) {
 // src/commands/diff.ts
 import "commander";
 
+// src/core/path-thresholds.ts
+var MISSING_PATH_REASON = "no coverage files matched this path glob in this run";
+function resolvePathThresholds(entry, global) {
+  return {
+    patch: entry.patch ?? global.patch,
+    project: entry.project ?? global.project
+  };
+}
+function totalsToMetric2(totals, threshold, kind) {
+  const empty = isEmptyPatch(totals);
+  if (kind === "patch" && empty) {
+    return {
+      pct: totals.pct,
+      threshold,
+      pass: true,
+      executable: totals.executable,
+      covered: totals.covered,
+      skipped: true,
+      reason: EMPTY_PATCH_REASON
+    };
+  }
+  const pass = totals.pct >= threshold;
+  return {
+    pct: totals.pct,
+    threshold,
+    pass,
+    executable: totals.executable,
+    covered: totals.covered
+  };
+}
+function missingMetric2(threshold, reason) {
+  return {
+    threshold,
+    skipped: true,
+    reason
+  };
+}
+function evaluatePresentPath(glob, files, addedByFile, thresholds) {
+  const patch = computePatchCoverage(files, addedByFile);
+  const project = computeProjectCoverage(files);
+  const patchMetric = totalsToMetric2(patch.totals, thresholds.patch, "patch");
+  const projectMetric = totalsToMetric2(project.totals, thresholds.project, "project");
+  const status = patchMetric.pass && projectMetric.pass ? "pass" : "fail";
+  return {
+    glob,
+    present: true,
+    status,
+    patch: patchMetric,
+    project: projectMetric
+  };
+}
+function missingPath(glob, thresholds, reason) {
+  return {
+    glob,
+    present: false,
+    status: "missing",
+    reason,
+    patch: missingMetric2(thresholds.patch, reason),
+    project: missingMetric2(thresholds.project, reason)
+  };
+}
+function evaluatePathThresholds(input) {
+  const global = input.config.thresholds;
+  const entries = global?.paths;
+  if (!global || !entries || entries.length === 0) return [];
+  return entries.map((entry) => {
+    const thresholds = resolvePathThresholds(entry, global);
+    const matched = filterFilesByGlobs(input.files, [entry.glob]);
+    if (matched.length === 0) {
+      return missingPath(entry.glob, thresholds, MISSING_PATH_REASON);
+    }
+    return evaluatePresentPath(entry.glob, matched, input.addedByFile, thresholds);
+  });
+}
+function pathThresholdsPass(results) {
+  return results.every((p) => p.status !== "fail");
+}
+function pathThresholdsToJson(results) {
+  return results.map((path) => ({
+    glob: path.glob,
+    status: path.status,
+    present: path.present,
+    ...path.status === "missing" ? { skipped: true } : {},
+    ...path.reason ? { reason: path.reason } : {},
+    patch: metricToJson2(path.patch),
+    project: metricToJson2(path.project)
+  }));
+}
+function metricToJson2(metric) {
+  if (metric.skipped) {
+    return {
+      threshold: metric.threshold,
+      skipped: true,
+      ...metric.reason ? { reason: metric.reason } : {}
+    };
+  }
+  return {
+    pct: metric.pct ?? 0,
+    threshold: metric.threshold,
+    pass: metric.pass ?? false,
+    executable: metric.executable ?? 0,
+    covered: metric.covered ?? 0,
+    ...metric.reason ? { reason: metric.reason } : {}
+  };
+}
+function resolvePathThresholdsJson(input) {
+  const results = evaluatePathThresholds(input);
+  return results.length > 0 ? pathThresholdsToJson(results) : void 0;
+}
+
 // src/output/human.ts
 function formatRange(r) {
   return r.start === r.end ? `${r.start}` : `${r.start}-${r.end}`;
@@ -3629,7 +3793,12 @@ function registerDiffCommand(program2) {
       });
       if (opts.json) {
         const flags = resolveFlagsJson({ config, files, addedByFile });
-        const payload = flags ? { ...diff, flags } : diff;
+        const paths = resolvePathThresholdsJson({ config, files, addedByFile });
+        const payload = {
+          ...diff,
+          ...flags ? { flags } : {},
+          ...paths ? { paths } : {}
+        };
         process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
       } else {
         process.stdout.write(
@@ -3659,6 +3828,7 @@ function formatIncompleteCheck(state, json) {
       projectPass: true,
       overall: "pass",
       flagResults: [],
+      pathResults: [],
       stdout: JSON.stringify({
         overall: "pending",
         complete: false,
@@ -3676,6 +3846,7 @@ function formatIncompleteCheck(state, json) {
     projectPass: true,
     overall: "pass",
     flagResults: [],
+    pathResults: [],
     stdout: "",
     stderr: `${dim("tested.dev \u2014 coverage gate")}  ${badge("info")}
 
@@ -3694,6 +3865,7 @@ function formatCompleteHandshakeCheck(json) {
       projectPass: true,
       overall: "pass",
       flagResults: [],
+      pathResults: [],
       stdout: JSON.stringify({ overall: "pending", complete: true, note }) + "\n",
       stderr: "",
       exitCode: 0
@@ -3705,6 +3877,7 @@ function formatCompleteHandshakeCheck(json) {
     projectPass: true,
     overall: "pass",
     flagResults: [],
+    pathResults: [],
     stdout: "",
     stderr: `${dim("tested.dev \u2014 coverage gate")}  ${badge("info")}
 
@@ -3718,6 +3891,12 @@ function formatMetricLine(label, pct3, threshold, pass, indent = "  ") {
   const status = pass ? badge("pass") : badge("fail");
   return `${indent}${label.padEnd(8)}  ${pctStr}%  (threshold ${threshold})  ${status}`;
 }
+function presentPct(metric) {
+  if (metric.pct === void 0 || metric.pass === void 0) {
+    throw new Error("present metric missing pct/pass");
+  }
+  return { pct: metric.pct, pass: metric.pass };
+}
 function formatFlagLines(results) {
   if (results.length === 0) return [];
   const lines = [""];
@@ -3734,16 +3913,52 @@ function formatFlagLines(results) {
         `    ${"Patch".padEnd(8)}  ${dim("-")}  ${EMPTY_PATCH_REASON}  ${badge("skip")}`
       );
     } else {
+      const patch = presentPct(flag.patch);
       lines.push(
-        formatMetricLine("Patch", flag.patch.pct, flag.patch.threshold, flag.patch.pass, "    ")
+        formatMetricLine("Patch", patch.pct, flag.patch.threshold, patch.pass, "    ")
       );
     }
+    const project = presentPct(flag.project);
     lines.push(
       formatMetricLine(
         "Project",
-        flag.project.pct,
+        project.pct,
         flag.project.threshold,
-        flag.project.pass,
+        project.pass,
+        "    "
+      )
+    );
+  }
+  return lines;
+}
+function formatPathLines(results) {
+  if (results.length === 0) return [];
+  const lines = [""];
+  for (const path of results) {
+    if (path.status === "missing") {
+      lines.push(
+        `  ${path.glob}  ${dim(path.reason ?? "missing this run")}  ${badge("missing")}`
+      );
+      continue;
+    }
+    lines.push(`  ${path.glob}  ${path.status === "pass" ? badge("pass") : badge("fail")}`);
+    if (path.patch.skipped) {
+      lines.push(
+        `    ${"Patch".padEnd(8)}  ${dim("-")}  ${EMPTY_PATCH_REASON}  ${badge("skip")}`
+      );
+    } else {
+      const patch = presentPct(path.patch);
+      lines.push(
+        formatMetricLine("Patch", patch.pct, path.patch.threshold, patch.pass, "    ")
+      );
+    }
+    const project = presentPct(path.project);
+    lines.push(
+      formatMetricLine(
+        "Project",
+        project.pct,
+        path.project.threshold,
+        project.pass,
         "    "
       )
     );
@@ -3759,6 +3974,7 @@ function runCheck(input) {
       projectPass: true,
       overall: "pass",
       flagResults: [],
+      pathResults: [],
       stdout: "",
       stderr: `${dim("tested.dev \u2014 coverage gate")}  ${badge("info")}
 
@@ -3781,8 +3997,14 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
     addedByFile: input.addedByFile ?? /* @__PURE__ */ new Map(),
     ...input.onlyFlag !== void 0 ? { onlyFlag: input.onlyFlag } : {}
   });
+  const pathResults = evaluatePathThresholds({
+    config,
+    files: input.files ?? [],
+    addedByFile: input.addedByFile ?? /* @__PURE__ */ new Map()
+  });
   const flagsOk = flagsPass(flagResults);
-  const overall = patchPass && projectPass && flagsOk ? "pass" : "fail";
+  const pathsOk = pathThresholdsPass(pathResults);
+  const overall = patchPass && projectPass && flagsOk && pathsOk ? "pass" : "fail";
   const exitCode = overall === "pass" ? 0 : 1;
   if (json) {
     const payload = {
@@ -3794,6 +4016,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
       },
       project: { pct: projectPct, threshold: projectThreshold, pass: projectPass },
       ...flagResults.length > 0 ? { flags: flagsToJson(flagResults) } : {},
+      ...pathResults.length > 0 ? { paths: pathThresholdsToJson(pathResults) } : {},
       overall,
       ...patchSkipped ? { note: EMPTY_PATCH_REASON } : {}
     };
@@ -3803,6 +4026,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
       projectPass,
       overall,
       flagResults,
+      pathResults,
       stdout: JSON.stringify(payload) + "\n",
       stderr: "",
       exitCode
@@ -3822,6 +4046,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
   }
   lines.push(formatMetricLine("Project", projectPct, projectThreshold, projectPass));
   lines.push(...formatFlagLines(flagResults));
+  lines.push(...formatPathLines(pathResults));
   if (overall === "fail") {
     lines.push("");
     if (patchSkipped) {
@@ -3831,10 +4056,16 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
     if (missing.length > 0) {
       lines.push(
         dim(
-          "Missing flags fail this run (no carryforward). Collect that package's coverage or scope the job with --flag."
+          "Flags with no files this run are skipped (not 0%). Scope the job with --flag when this coverage file is one package."
         )
       );
     }
+    const missingPaths = pathResults.filter((p) => p.status === "missing");
+    if (missingPaths.length > 0) {
+      lines.push(
+        dim("Path globs with no files this run are skipped (not 0%).")
+      );
+    }
     lines.push(tip("add tests for uncovered ranges: tested diff"));
   } else {
     lines.push("");
@@ -3851,6 +4082,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
     projectPass,
     overall,
     flagResults,
+    pathResults,
     stdout: lines.join("\n"),
     stderr: "",
     exitCode
@@ -3858,7 +4090,7 @@ ${tip("add thresholds.patch / thresholds.project to enforce")}
 }
 function registerCheckCommand(program2) {
   program2.command("check").description(
-    "Exit non-zero if patch or project coverage falls below configured thresholds."
+    "Exit non-zero if patch, project, or path coverage falls below configured thresholds."
   ).option("--json", "Emit machine-readable JSON to stdout (exit code unchanged).", false).option("--base <ref>", "Git base ref to diff against", void 0).option(
     "--file <path>",
     "Coverage file to merge (repeatable). Overrides coverage.path.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tested/cli",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Coverage your agent can use. CLI for patch + project coverage with agent-readable JSON output.",
   "license": "MIT",
   "homepage": "https://tested.dev",