@c9up/helix 0.1.3 → 0.1.5

package/dist/cli/coverage/diff/overlay.js

@@ -0,0 +1,58 @@
+/**
+ * Overlay the diff map onto a `CoverageSummary` to compute per-file
+ * "added vs covered" totals.
+ *
+ * For each file in the diff:
+ *   - find the matching coverage entry by absolute path
+ *   - intersect the added line numbers with `lineHits` (count > 0 means
+ *     covered)
+ *   - emit a `DiffFileSummary`
+ *
+ * Files in the diff with no coverage entry are still reported (added
+ * lines, 0 covered) so a freshly-added module without any tests shows
+ * up red. Files in coverage but not in the diff are skipped (the PR
+ * didn't touch them, so they don't move the diff-coverage needle).
+ */
+function pct(covered, added) {
+    if (added === 0)
+        return 100;
+    return Math.round((covered / added) * 10000) / 100;
+}
+export function overlay(coverage, diff) {
+    const coverageByFile = new Map(coverage.files.map((f) => [f.file, f]));
+    const files = [];
+    let totalAdded = 0;
+    let totalCovered = 0;
+    for (const [file, addedLines] of diff) {
+        if (addedLines.size === 0)
+            continue;
+        const cov = coverageByFile.get(file);
+        const hitsByLine = cov
+            ? new Map(cov.lineHits.map((h) => [h.line, h.count]))
+            : undefined;
+        const sortedAdded = [...addedLines].sort((a, b) => a - b);
+        const lineHits = sortedAdded.map((line) => {
+            const count = hitsByLine?.get(line);
+            return { line, covered: typeof count === "number" && count > 0 };
+        });
+        const covered = lineHits.filter((h) => h.covered).length;
+        files.push({
+            file,
+            added: addedLines.size,
+            covered,
+            lineHits,
+        });
+        totalAdded += addedLines.size;
+        totalCovered += covered;
+    }
+    files.sort((a, b) => a.file.localeCompare(b.file));
+    return {
+        files,
+        total: {
+            added: totalAdded,
+            covered: totalCovered,
+            pct: pct(totalCovered, totalAdded),
+        },
+    };
+}
+//# sourceMappingURL=overlay.js.map

package/dist/cli/coverage/diff/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../../../src/cli/coverage/diff/overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,SAAS,GAAG,CAAC,OAAe,EAAE,KAAa;IAC1C,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,QAAyB,EAAE,IAAa;IAC/D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,UAAU,GAAG,GAAG;YACrB,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACrD,CAAC,CAAC,SAAS,CAAC;QACb,MAAM,WAAW,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAgC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACtE,MAAM,KAAK,GAAG,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAClE,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,KAAK,EAAE,UAAU,CAAC,IAAI;YACtB,OAAO;YACP,QAAQ;SACR,CAAC,CAAC;QACH,UAAU,IAAI,UAAU,CAAC,IAAI,CAAC;QAC9B,YAAY,IAAI,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,OAAO;QACN,KAAK;QACL,KAAK,EAAE;YACN,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,YAAY;YACrB,GAAG,EAAE,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC;SAClC;KACD,CAAC;AACH,CAAC"}

package/dist/cli/coverage/diff/parse.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Parse `git diff --unified=0 --no-color <base>...HEAD` output into a
+ * `DiffMap`. Why three-dot: it computes the diff at the merge-base, so
+ * commits made on `base` AFTER our branch diverged are excluded. That's
+ * the "what this PR contributes" semantic users expect.
+ *
+ * We force `--src-prefix=a/ --dst-prefix=b/` and `core.quotepath=false`
+ * so the parser doesn't have to guess at user-side `diff.noprefix` or
+ * non-ASCII path quoting.
+ *
+ * Renames produce `+++ b/<new path>` so they're picked up at the new
+ * location. Deletes produce `+++ /dev/null` and are skipped. Binary
+ * files produce no `+` lines so they contribute nothing.
+ */
+import type { DiffMap } from "./types.js";
+export interface ParseOptions {
+    cwd: string;
+    base: string;
+}
+export declare function parseDiff(opts: ParseOptions): DiffMap;
+/**
+ * Pure parser — exposed separately so tests can feed canned diff
+ * strings without spawning git. Keys are canonicalised via realpath so
+ * they line up with V8 coverage paths (which `filter.ts` realpaths).
+ */
+export declare function parseDiffString(diff: string, cwd: string): DiffMap;
+//# sourceMappingURL=parse.d.ts.map

package/dist/cli/coverage/diff/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/cli/coverage/diff/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK1C,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACb;AAUD,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAqCrD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAwClE"}

package/dist/cli/coverage/diff/parse.js

@@ -0,0 +1,105 @@
+/**
+ * Parse `git diff --unified=0 --no-color <base>...HEAD` output into a
+ * `DiffMap`. Why three-dot: it computes the diff at the merge-base, so
+ * commits made on `base` AFTER our branch diverged are excluded. That's
+ * the "what this PR contributes" semantic users expect.
+ *
+ * We force `--src-prefix=a/ --dst-prefix=b/` and `core.quotepath=false`
+ * so the parser doesn't have to guess at user-side `diff.noprefix` or
+ * non-ASCII path quoting.
+ *
+ * Renames produce `+++ b/<new path>` so they're picked up at the new
+ * location. Deletes produce `+++ /dev/null` and are skipped. Binary
+ * files produce no `+` lines so they contribute nothing.
+ */
+import { spawnSync } from "node:child_process";
+import { realpathSync } from "node:fs";
+import path from "node:path";
+const HUNK_HEADER = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/;
+const FILE_HEADER_PLUS = /^\+\+\+ (?:b\/(.*)|\/dev\/null)$/;
+function tryRealpath(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
+export function parseDiff(opts) {
+    const result = spawnSync("git", [
+        "-c",
+        "core.quotepath=false",
+        "diff",
+        "--unified=0",
+        "--no-color",
+        "--src-prefix=a/",
+        "--dst-prefix=b/",
+        `${opts.base}...HEAD`,
+    ], {
+        cwd: opts.cwd,
+        encoding: "utf8",
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    if (result.error) {
+        const err = result.error;
+        if (err.code === "ENOENT") {
+            throw new Error("git binary not found on PATH");
+        }
+        if (err.code === "ENOBUFS") {
+            throw new Error("diff output exceeded 64 MB — branch is too divergent to overlay");
+        }
+        throw new Error(`git diff failed: ${err.message}`);
+    }
+    if (result.status !== 0) {
+        throw new Error(`git diff exited ${result.status}: ${result.stderr?.trim() || "(no stderr — likely shallow clone or pruned ref)"}`);
+    }
+    return parseDiffString(result.stdout, opts.cwd);
+}
+/**
+ * Pure parser — exposed separately so tests can feed canned diff
+ * strings without spawning git. Keys are canonicalised via realpath so
+ * they line up with V8 coverage paths (which `filter.ts` realpaths).
+ */
+export function parseDiffString(diff, cwd) {
+    const map = new Map();
+    let currentFile;
+    let nextAddedLine = 0;
+    const lines = diff.split(/\r?\n/);
+    for (const line of lines) {
+        const fileMatch = line.match(FILE_HEADER_PLUS);
+        if (fileMatch) {
+            const newPath = fileMatch[1];
+            if (!newPath) {
+                currentFile = undefined;
+                nextAddedLine = 0;
+                continue;
+            }
+            currentFile = tryRealpath(path.resolve(cwd, newPath));
+            nextAddedLine = 0;
+            continue;
+        }
+        if (!currentFile)
+            continue;
+        const hunkMatch = line.match(HUNK_HEADER);
+        if (hunkMatch) {
+            nextAddedLine = Number.parseInt(hunkMatch[1], 10);
+            continue;
+        }
+        if (line.startsWith("+") && !line.startsWith("+++")) {
+            if (nextAddedLine < 1) {
+                // `+0,0` deletion-only hunks set nextAddedLine = 0; ignore stray
+                // `+` lines rather than emit invalid line numbers.
+                continue;
+            }
+            let set = map.get(currentFile);
+            if (!set) {
+                set = new Set();
+                map.set(currentFile, set);
+            }
+            set.add(nextAddedLine);
+            nextAddedLine += 1;
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=parse.js.map

package/dist/cli/coverage/diff/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../src/cli/coverage/diff/parse.ts"],"names":[],"mappings":"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"}

package/dist/cli/coverage/diff/reporters.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Diff-coverage reporters: text summary + JSON.
+ *
+ * The text reporter mirrors the full-tree text format so users can read
+ * both side-by-side. JSON is namespaced under `files` to avoid
+ * collisions with the literal `total` key (in case a file is named
+ * `total`).
+ */
+import type { DiffSummary } from "./types.js";
+export declare function diffTextSummary(summary: DiffSummary, root: string): string;
+export declare function diffJson(summary: DiffSummary, root: string): string;
+//# sourceMappingURL=reporters.d.ts.map

package/dist/cli/coverage/diff/reporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporters.d.ts","sourceRoot":"","sources":["../../../../src/cli/coverage/diff/reporters.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,YAAY,CAAC;AAiB/D,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2B1E;AAaD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAcnE"}

package/dist/cli/coverage/diff/reporters.js

@@ -0,0 +1,59 @@
+/**
+ * Diff-coverage reporters: text summary + JSON.
+ *
+ * The text reporter mirrors the full-tree text format so users can read
+ * both side-by-side. JSON is namespaced under `files` to avoid
+ * collisions with the literal `total` key (in case a file is named
+ * `total`).
+ */
+import path from "node:path";
+function rel(file, root) {
+    const r = path.relative(root, file).split(path.sep).join("/");
+    return r.length > 0 && !r.startsWith("..") ? r : file;
+}
+function padRight(s, w) {
+    if (s.length === w)
+        return s;
+    if (s.length > w)
+        return `…${s.slice(s.length - w + 1)}`;
+    return s + " ".repeat(w - s.length);
+}
+function fmtPct(n) {
+    return `${n.toFixed(2).padStart(6)}%`;
+}
+export function diffTextSummary(summary, root) {
+    const lines = [];
+    lines.push("");
+    lines.push("── Diff coverage ───────────────────────────────────────────");
+    if (summary.files.length === 0) {
+        lines.push("  No instrumented files were touched by the diff.");
+        lines.push(`  ${summary.total.covered}/${summary.total.added} lines covered`);
+        return `${lines.join("\n")}\n`;
+    }
+    lines.push(`${padRight("File", 50)}  ${"Covered".padStart(10)}  ${"%".padStart(8)}`);
+    lines.push("─".repeat(72));
+    for (const f of summary.files) {
+        const ratio = `${f.covered}/${f.added}`;
+        const pct = f.added > 0 ? (f.covered / f.added) * 100 : 100;
+        lines.push(`${padRight(rel(f.file, root), 50)}  ${ratio.padStart(10)}  ${fmtPct(pct)}`);
+    }
+    lines.push("─".repeat(72));
+    lines.push(`${padRight("Total", 50)}  ${`${summary.total.covered}/${summary.total.added}`.padStart(10)}  ${fmtPct(summary.total.pct)}`);
+    return `${lines.join("\n")}\n`;
+}
+export function diffJson(summary, root) {
+    const filesOut = Object.create(null);
+    for (const f of summary.files) {
+        filesOut[rel(f.file, root)] = {
+            added: f.added,
+            covered: f.covered,
+            lineHits: f.lineHits,
+        };
+    }
+    const out = {
+        total: summary.total,
+        files: filesOut,
+    };
+    return `${JSON.stringify(out, null, 2)}\n`;
+}
+//# sourceMappingURL=reporters.js.map

package/dist/cli/coverage/diff/reporters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporters.js","sourceRoot":"","sources":["../../../../src/cli/coverage/diff/reporters.ts"],"names":[],"mappings":"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"}

package/dist/cli/coverage/diff/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Types for the diff-coverage pipeline.
+ *
+ * `DiffMap` is the output of `parse.ts` — for every file changed in
+ * `<base>...HEAD`, the set of 1-based line numbers added or modified
+ * (i.e. lines starting with `+` in unified diff, excluding the `+++`
+ * header). Deleted lines aren't relevant: we only care whether NEW
+ * code is covered.
+ *
+ * `DiffFileSummary` and `DiffSummary` mirror the shape of the full-tree
+ * `FileSummary` / `CoverageSummary` so the existing threshold
+ * enforcement machinery applies unchanged.
+ */
+export type DiffMap = Map<string, Set<number>>;
+export interface DiffFileSummary {
+    file: string;
+    /** Lines added by the PR (1-based). */
+    added: number;
+    /** Subset of `added` that have a hit count > 0 in the coverage summary. */
+    covered: number;
+    /** Per-line breakdown for reporters. */
+    lineHits: Array<{
+        line: number;
+        covered: boolean;
+    }>;
+}
+export interface DiffSummary {
+    files: DiffFileSummary[];
+    total: {
+        added: number;
+        covered: number;
+        pct: number;
+    };
+}
+export interface DiffOptions {
+    enabled: boolean;
+    /** Git revision to diff against. Default: resolved by `base.ts`. */
+    base?: string;
+    /** Inline thresholds. Reuses the full-tree shape. */
+    thresholds?: import("../types.js").Thresholds;
+    /** Output dir for `coverage-diff.json`. Defaults to coverage outputDir. */
+    outputDir?: string;
+    /** Where to spawn `git diff`. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/coverage/diff/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/coverage/diff/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,KAAK,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACZ,CAAC;CACF;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,aAAa,EAAE,UAAU,CAAC;IAC9C,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;CACb"}

package/dist/cli/coverage/diff/types.js

@@ -0,0 +1,15 @@
+/**
+ * Types for the diff-coverage pipeline.
+ *
+ * `DiffMap` is the output of `parse.ts` — for every file changed in
+ * `<base>...HEAD`, the set of 1-based line numbers added or modified
+ * (i.e. lines starting with `+` in unified diff, excluding the `+++`
+ * header). Deleted lines aren't relevant: we only care whether NEW
+ * code is covered.
+ *
+ * `DiffFileSummary` and `DiffSummary` mirror the shape of the full-tree
+ * `FileSummary` / `CoverageSummary` so the existing threshold
+ * enforcement machinery applies unchanged.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/coverage/diff/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cli/coverage/diff/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/cli/coverage/filter.d.ts

@@ -0,0 +1,13 @@
+import { globToRegex } from "./glob.js";
+import type { RawFileCoverage } from "./types.js";
+export interface FilterConfig {
+    root: string;
+    include?: string[];
+    exclude?: string[];
+}
+export declare function filter(raw: RawFileCoverage[], config: FilterConfig): RawFileCoverage[];
+/** Exposed for tests. */
+export declare const __test__: {
+    globToRegex: typeof globToRegex;
+};
+//# sourceMappingURL=filter.d.ts.map

package/dist/cli/coverage/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/cli/coverage/filter.ts"],"names":[],"mappings":"AAUA,OAAO,EAAgB,WAAW,EAAkB,MAAM,WAAW,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkBlD,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAeD,wBAAgB,MAAM,CACrB,GAAG,EAAE,eAAe,EAAE,EACtB,MAAM,EAAE,YAAY,GAClB,eAAe,EAAE,CAgBnB;AAED,yBAAyB;AACzB,eAAO,MAAM,QAAQ;;CAAkB,CAAC"}

package/dist/cli/coverage/filter.js

@@ -0,0 +1,60 @@
+// Include / exclude filter for coverage files. Glob subset is
+// implemented in `./glob.ts` (shared with the watch-mode filter).
+//
+// Symlinks are NOT followed: `path.realpath` is used to verify the file
+// actually lives under `root`. Anything pointing outside (off-tree
+// symlinks) is dropped — defence in depth against a malicious source
+// tree dragging unrelated files into the coverage report.
+import { realpathSync } from "node:fs";
+import path from "node:path";
+import { compileGlobs, globToRegex, matchesAnyGlob } from "./glob.js";
+const DEFAULT_INCLUDE = ["src/**/*.{ts,tsx,js,mjs,cjs}"];
+const DEFAULT_EXCLUDE = [
+    "node_modules/**",
+    "dist/**",
+    "build/**",
+    "coverage/**",
+    ".git/**",
+    ".wolf/**",
+    "target/**",
+    ".next/**",
+    "tests/**",
+    "test/**",
+    "**/*.test.*",
+    "**/*.spec.*",
+];
+/**
+ * Resolve a path's real (canonical) absolute location. Falls back to
+ * the lexical path if the file no longer exists (already deleted by the
+ * worker exit). Symlinks point at the target's real path.
+ */
+function tryRealpath(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
+export function filter(raw, config) {
+    const include = compileGlobs(config.include ?? DEFAULT_INCLUDE);
+    const exclude = compileGlobs(config.exclude ?? DEFAULT_EXCLUDE);
+    const root = tryRealpath(path.resolve(config.root));
+    const out = [];
+    for (const entry of raw) {
+        const real = tryRealpath(entry.file);
+        const rel = path.relative(root, real).split(path.sep).join("/");
+        if (rel.length === 0 || rel.startsWith("..") || path.isAbsolute(rel)) {
+            continue;
+        }
+        if (!matchesAnyGlob(include, rel))
+            continue;
+        if (matchesAnyGlob(exclude, rel))
+            continue;
+        out.push({ ...entry, file: real });
+    }
+    return out;
+}
+/** Exposed for tests. */
+export const __test__ = { globToRegex };
+//# sourceMappingURL=filter.js.map

package/dist/cli/coverage/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/cli/coverage/filter.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,kEAAkE;AAClE,EAAE;AACF,wEAAwE;AACxE,mEAAmE;AACnE,qEAAqE;AACrE,0DAA0D;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGtE,MAAM,eAAe,GAAG,CAAC,8BAA8B,CAAC,CAAC;AACzD,MAAM,eAAe,GAAG;IACvB,iBAAiB;IACjB,SAAS;IACT,UAAU;IACV,aAAa;IACb,SAAS;IACT,UAAU;IACV,WAAW;IACX,UAAU;IACV,UAAU;IACV,SAAS;IACT,aAAa;IACb,aAAa;CACb,CAAC;AAQF;;;;GAIG;AACH,SAAS,WAAW,CAAC,CAAS;IAC7B,IAAI,CAAC;QACJ,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,CAAC,CAAC;IACV,CAAC;AACF,CAAC;AAED,MAAM,UAAU,MAAM,CACrB,GAAsB,EACtB,MAAoB;IAEpB,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtE,SAAS;QACV,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC;YAAE,SAAS;QAC5C,IAAI,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC;YAAE,SAAS;QAC3C,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,WAAW,EAAE,CAAC"}

package/dist/cli/coverage/glob.d.ts

@@ -0,0 +1,4 @@
+export declare function globToRegex(glob: string): RegExp;
+export declare function compileGlobs(patterns: string[]): RegExp[];
+export declare function matchesAnyGlob(regexes: RegExp[], rel: string): boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/cli/coverage/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/cli/coverage/glob.ts"],"names":[],"mappings":"AAyBA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6ChD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEzD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtE"}

package/dist/cli/coverage/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../../src/cli/coverage/glob.ts"],"names":[],"mappings":"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"}

package/dist/cli/coverage/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Coverage facade — wires collect → filter → aggregate → reporters →
+ * thresholds. Called by `run.ts` after the worker pool finishes.
+ */
+import type { CoverageOptions, CoverageSummary, ThresholdViolation } from "./types.js";
+export { textSummary } from "./reporters/text.js";
+export { enforce, violationSummary } from "./thresholds.js";
+export type { CoverageOptions, CoverageSummary, ThresholdViolation, } from "./types.js";
+export interface CoverageSession {
+    /** Temp dir passed as `NODE_V8_COVERAGE` to every worker. */
+    envDir: string;
+    /** Inject into the child environment. */
+    env: NodeJS.ProcessEnv;
+}
+/**
+ * Create a unique temp directory for a run. The orchestrator passes its
+ * path via `NODE_V8_COVERAGE`; every spawned worker writes its own
+ * `coverage-*.json` on exit. Returns an env bag the pool forwards.
+ */
+export declare function openSession(baseDir?: string): Promise<CoverageSession>;
+export interface FinaliseOptions extends CoverageOptions {
+    root: string;
+    session: CoverageSession;
+}
+export interface FinaliseResult {
+    summary: CoverageSummary;
+    violations: ThresholdViolation[];
+    textReport: string;
+    /** Absolute paths of written report files (lcov + json-summary). */
+    reportFiles: string[];
+}
+/**
+ * After all workers have exited, read the raw v8 output, aggregate, emit
+ * reporters + enforce thresholds.
+ *
+ * The temp dir is removed in `finally` so a write/aggregate failure
+ * doesn't leak gigabytes of raw V8 JSON under `.helix-coverage/`.
+ */
+export declare function finalise(opts: FinaliseOptions): Promise<FinaliseResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/coverage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/coverage/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EACX,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EACX,eAAe,EACf,eAAe,EACf,kBAAkB,GAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC/B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAW5E;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAID;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAkD7E"}

package/dist/cli/coverage/index.js

@@ -0,0 +1,85 @@
+/**
+ * Coverage facade — wires collect → filter → aggregate → reporters →
+ * thresholds. Called by `run.ts` after the worker pool finishes.
+ */
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { aggregate } from "./aggregate.js";
+import { collect } from "./collect.js";
+import { filter } from "./filter.js";
+import { jsonSummary } from "./reporters/json.js";
+import { lcov } from "./reporters/lcov.js";
+import { textSummary } from "./reporters/text.js";
+import { enforce } from "./thresholds.js";
+export { textSummary } from "./reporters/text.js";
+export { enforce, violationSummary } from "./thresholds.js";
+/**
+ * Create a unique temp directory for a run. The orchestrator passes its
+ * path via `NODE_V8_COVERAGE`; every spawned worker writes its own
+ * `coverage-*.json` on exit. Returns an env bag the pool forwards.
+ */
+export async function openSession(baseDir) {
+    const root = baseDir ?? path.join(process.cwd(), ".helix-coverage");
+    const unique = `run-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const envDir = path.join(root, unique);
+    await mkdir(envDir, { recursive: true });
+    return {
+        envDir,
+        env: {
+            NODE_V8_COVERAGE: envDir,
+        },
+    };
+}
+const KNOWN_REPORTERS = new Set(["text-summary", "lcov", "json-summary"]);
+/**
+ * After all workers have exited, read the raw v8 output, aggregate, emit
+ * reporters + enforce thresholds.
+ *
+ * The temp dir is removed in `finally` so a write/aggregate failure
+ * doesn't leak gigabytes of raw V8 JSON under `.helix-coverage/`.
+ */
+export async function finalise(opts) {
+    try {
+        const raw = await collect(opts.session.envDir);
+        const filtered = filter(raw, {
+            root: opts.root,
+            include: opts.include,
+            exclude: opts.exclude,
+        });
+        const summary = aggregate(filtered);
+        // Treat empty array as "use defaults" — same as undefined.
+        const requested = opts.reporters && opts.reporters.length > 0
+            ? opts.reporters
+            : ["text-summary", "lcov"];
+        // Warn on unknown reporter names so typos surface (instead of the
+        // reporter silently being skipped).
+        for (const r of requested) {
+            if (!KNOWN_REPORTERS.has(r)) {
+                process.stderr.write(`helix-coverage: unknown reporter "${r}" — known: ${[...KNOWN_REPORTERS].join(", ")}\n`);
+            }
+        }
+        const outputDir = opts.outputDir ?? path.join(opts.root, "coverage");
+        await mkdir(outputDir, { recursive: true });
+        const reportFiles = [];
+        if (requested.includes("lcov")) {
+            const file = path.join(outputDir, "lcov.info");
+            await writeFile(file, lcov(summary, opts.root), "utf8");
+            reportFiles.push(file);
+        }
+        if (requested.includes("json-summary")) {
+            const file = path.join(outputDir, "coverage-summary.json");
+            await writeFile(file, jsonSummary(summary, opts.root), "utf8");
+            reportFiles.push(file);
+        }
+        const textReport = requested.includes("text-summary")
+            ? textSummary(summary, opts.root)
+            : "";
+        const violations = opts.thresholds ? enforce(summary, opts.thresholds) : [];
+        return { summary, violations, textReport, reportFiles };
+    }
+    finally {
+        // Always tidy the temp dir — even on aggregate / writeFile failure.
+        await rm(opts.session.envDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/coverage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/coverage/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/coverage/reporters/json.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `coverage-summary.json` — Istanbul-compatible shape consumed by CI
+ * tooling (lcov-reporter-action, Codecov uploaders that prefer JSON).
+ *
+ * File keys are emitted as paths RELATIVE to `root` so the artifact is
+ * portable across machines. The reserved `total` key holds the
+ * aggregate; if a real file path collides with it (extraordinarily
+ * unlikely after relativisation), we keep the totals row and skip the
+ * collision rather than overwrite — protecting the consumer's invariant.
+ */
+import type { CoverageSummary } from "../types.js";
+export declare function jsonSummary(summary: CoverageSummary, root: string): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/cli/coverage/reporters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/cli/coverage/reporters/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAOnD,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB1E"}