@descryy/runtime-test-runner 0.4.11 → 0.4.13

package/dist/bounded-file.d.ts

@@ -0,0 +1,18 @@
+export type BoundedFileRead = {
+    readonly ok: true;
+    readonly text: string;
+} | {
+    readonly ok: false;
+    readonly reason: "missing" | "not-a-regular-file" | "too-large" | "unreadable";
+    readonly detail: string;
+};
+export declare function readBoundedRegularFile(path: string, maxBytes: number): BoundedFileRead;
+export declare const MAX_COVERAGE_DUMP_FILES = 2000;
+export declare const MAX_COVERAGE_DUMP_BYTES: number;
+export declare const MAX_COVERAGE_TOTAL_BYTES: number;
+export interface CoverageDumpSkips {
+    readonly skipped: readonly string[];
+}
+export declare function forEachCoverageDump(directory: string, names: readonly string[], visit: (name: string, text: string) => void): CoverageDumpSkips;
+export declare function describeSkippedDumps(skipped: readonly string[]): string | null;
+//# sourceMappingURL=bounded-file.d.ts.map

package/dist/bounded-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-file.d.ts","sourceRoot":"","sources":["../src/bounded-file.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,oBAAoB,GAAG,WAAW,GAAG,YAAY,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAQpI,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CA2BtF;AAED,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AACxD,eAAO,MAAM,wBAAwB,QAAoB,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,iBAAiB,CAuB/I;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAI9E"}

package/dist/bounded-file.js

@@ -0,0 +1,77 @@
+import { closeSync, constants, fstatSync, openSync, readSync } from "node:fs";
+import { join } from "node:path";
+const OPEN_FLAGS = constants.O_RDONLY | (constants.O_NONBLOCK ?? 0);
+function errnoCode(error) {
+    return typeof error === "object" && error !== null ? error.code : undefined;
+}
+export function readBoundedRegularFile(path, maxBytes) {
+    let descriptor;
+    try {
+        descriptor = openSync(path, OPEN_FLAGS);
+    }
+    catch (error) {
+        const code = errnoCode(error);
+        if (code === "ENOENT" || code === "ENOTDIR")
+            return { ok: false, reason: "missing", detail: `${path} does not exist` };
+        return { ok: false, reason: "unreadable", detail: `${path} could not be opened (${code ?? String(error)})` };
+    }
+    try {
+        const stats = fstatSync(descriptor);
+        if (!stats.isFile())
+            return { ok: false, reason: "not-a-regular-file", detail: `${path} is not a regular file` };
+        if (stats.size > maxBytes)
+            return { ok: false, reason: "too-large", detail: `${path} is ${String(stats.size)} bytes, over the ${String(maxBytes)} byte limit` };
+        const buffer = Buffer.allocUnsafe(Math.min(stats.size, maxBytes) + 1);
+        let filled = 0;
+        while (filled < buffer.length) {
+            const read = readSync(descriptor, buffer, filled, buffer.length - filled, null);
+            if (read === 0)
+                break;
+            filled += read;
+        }
+        if (filled > maxBytes)
+            return { ok: false, reason: "too-large", detail: `${path} grew past the ${String(maxBytes)} byte limit while being read` };
+        return { ok: true, text: buffer.subarray(0, filled).toString("utf8") };
+    }
+    catch (error) {
+        return { ok: false, reason: "unreadable", detail: `${path} could not be read (${errnoCode(error) ?? String(error)})` };
+    }
+    finally {
+        closeSync(descriptor);
+    }
+}
+export const MAX_COVERAGE_DUMP_FILES = 2_000;
+export const MAX_COVERAGE_DUMP_BYTES = 64 * 1024 * 1024;
+export const MAX_COVERAGE_TOTAL_BYTES = 512 * 1024 * 1024;
+export function forEachCoverageDump(directory, names, visit) {
+    const skipped = [];
+    const considered = names.slice(0, MAX_COVERAGE_DUMP_FILES);
+    if (names.length > considered.length) {
+        skipped.push(`${String(names.length - considered.length)} coverage file(s) beyond the first ${String(MAX_COVERAGE_DUMP_FILES)} were not read`);
+    }
+    let totalBytes = 0;
+    let overBudget = 0;
+    for (const name of considered) {
+        if (totalBytes >= MAX_COVERAGE_TOTAL_BYTES) {
+            overBudget += 1;
+            continue;
+        }
+        const read = readBoundedRegularFile(join(directory, name), MAX_COVERAGE_DUMP_BYTES);
+        if (!read.ok) {
+            skipped.push(read.detail);
+            continue;
+        }
+        totalBytes += read.text.length;
+        visit(name, read.text);
+    }
+    if (overBudget > 0)
+        skipped.push(`${String(overBudget)} coverage file(s) were not read because the ${String(MAX_COVERAGE_TOTAL_BYTES)} byte total budget was used up`);
+    return { skipped };
+}
+export function describeSkippedDumps(skipped) {
+    if (skipped.length === 0)
+        return null;
+    const shown = skipped.slice(0, 3).join("; ");
+    return `${String(skipped.length)} coverage file problem(s) were skipped and their data is missing from this result: ${shown}${skipped.length > 3 ? "; ..." : ""}`;
+}
+//# sourceMappingURL=bounded-file.js.map

package/dist/bounded-file.js.map

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

package/dist/child-environment.d.ts

@@ -0,0 +1,12 @@
+export interface ChildEnvironmentOptions {
+    readonly source?: NodeJS.ProcessEnv;
+    readonly inheritHostEnvironment?: boolean;
+    readonly passthroughNames?: readonly string[];
+}
+export interface ChildEnvironment {
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly droppedNames: readonly string[];
+    readonly disclosure: string | null;
+}
+export declare function buildChildEnvironment(options?: ChildEnvironmentOptions): ChildEnvironment;
+//# sourceMappingURL=child-environment.d.ts.map

package/dist/child-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-environment.d.ts","sourceRoot":"","sources":["../src/child-environment.ts"],"names":[],"mappings":"AAkFA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACpC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AASD,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,uBAA4B,GAAG,gBAAgB,CAmC7F"}

package/dist/child-environment.js

@@ -0,0 +1,124 @@
+const ALLOWED_NAMES = new Set([
+    "PATH",
+    "HOME",
+    "USER",
+    "LOGNAME",
+    "SHELL",
+    "LANG",
+    "LANGUAGE",
+    "TZ",
+    "TERM",
+    "COLORTERM",
+    "NO_COLOR",
+    "FORCE_COLOR",
+    "CI",
+    "TMPDIR",
+    "TEMP",
+    "TMP",
+    "SYSTEMROOT",
+    "SYSTEMDRIVE",
+    "WINDIR",
+    "COMSPEC",
+    "PATHEXT",
+    "USERPROFILE",
+    "APPDATA",
+    "LOCALAPPDATA",
+    "PROGRAMFILES",
+    "PROGRAMFILES(X86)",
+    "PROGRAMDATA",
+    "XDG_CACHE_HOME",
+    "XDG_CONFIG_HOME",
+    "XDG_DATA_HOME",
+    "XDG_RUNTIME_DIR",
+    "NODE_PATH",
+    "NODE_OPTIONS",
+    "NODE_ENV",
+    "NODE_EXTRA_CA_CERTS",
+    "COREPACK_HOME",
+    "PNPM_HOME",
+    "PYTHONPATH",
+    "PYTHONHOME",
+    "PYTHONUTF8",
+    "PYTHONIOENCODING",
+    "VIRTUAL_ENV",
+    "UV_PROJECT_ENVIRONMENT",
+    "POETRY_HOME",
+    "JAVA_HOME",
+    "MAVEN_HOME",
+    "M2_HOME",
+    "MAVEN_REPO_LOCAL",
+    "GRADLE_USER_HOME",
+    "GOROOT",
+    "GOPATH",
+    "GOCACHE",
+    "GOMODCACHE",
+    "GOENV",
+    "GOFLAGS",
+    "GOPROXY",
+    "GOSUMDB",
+    "GOTOOLCHAIN",
+    "CGO_ENABLED",
+    "DOTNET_ROOT",
+    "DOTNET_CLI_HOME",
+    "NUGET_PACKAGES",
+    "CARGO_HOME",
+    "RUSTUP_HOME",
+    "RUSTUP_TOOLCHAIN",
+    "GEM_HOME",
+    "GEM_PATH",
+    "BUNDLE_PATH",
+    "COMPOSER_HOME",
+    "PHPRC",
+    "DEVELOPER_DIR",
+    "SDKROOT",
+    "DESCRY_JUNIT_CONSOLE_JAR",
+]);
+const ALLOWED_PREFIXES = ["LC_", "XDG_", "PYTHON", "PYTEST_", "DOTNET_", "JAVA_", "GRADLE_", "MAVEN_", "CARGO_", "RUSTUP_", "PNPM_", "PYENV_", "CONDA_", "NVM_", "VOLTA_", "FNM_", "ASDF_", "MISE_", "RBENV_", "SDKMAN_"];
+const CREDENTIAL_LOOKING_NAME = /(KEY|TOKEN|SECRET|PASSWORD|PASSWD|CREDENTIAL|AUTH)/i;
+const LISTED_DROPPED_NAMES = 20;
+function isAllowedName(name, passthrough) {
+    const upper = name.toUpperCase();
+    if (passthrough.has(upper))
+        return true;
+    if (CREDENTIAL_LOOKING_NAME.test(name))
+        return false;
+    return ALLOWED_NAMES.has(upper) || ALLOWED_PREFIXES.some((prefix) => upper.startsWith(prefix));
+}
+export function buildChildEnvironment(options = {}) {
+    const source = options.source ?? process.env;
+    if (options.inheritHostEnvironment === true) {
+        const credentialLooking = Object.keys(source).filter((name) => source[name] !== undefined && CREDENTIAL_LOOKING_NAME.test(name)).length;
+        return {
+            env: {},
+            droppedNames: [],
+            disclosure: "the host process environment was passed to the test process whole, at the caller's explicit request" +
+                (credentialLooking > 0 ? `, including ${String(credentialLooking)} variable${credentialLooking === 1 ? "" : "s"} whose names look like credentials` : "") +
+                "; code under test can read all of it.",
+        };
+    }
+    const passthrough = new Set((options.passthroughNames ?? []).map((name) => name.toUpperCase()));
+    const env = {};
+    const dropped = [];
+    for (const [name, value] of Object.entries(source)) {
+        if (value === undefined)
+            continue;
+        if (isAllowedName(name, passthrough))
+            env[name] = value;
+        else {
+            env[name] = undefined;
+            dropped.push(name);
+        }
+    }
+    dropped.sort();
+    if (dropped.length === 0)
+        return { env, droppedNames: dropped, disclosure: null };
+    const listed = dropped.slice(0, LISTED_DROPPED_NAMES).join(", ");
+    const rest = dropped.length > LISTED_DROPPED_NAMES ? ` and ${String(dropped.length - LISTED_DROPPED_NAMES)} more` : "";
+    return {
+        env,
+        droppedNames: dropped,
+        disclosure: `the test process received an allowlisted subset of Descry's environment; ${String(dropped.length)} inherited variable${dropped.length === 1 ? " was" : "s were"} ` +
+            `not passed (${listed}${rest}). Variables the command or profile sets itself are unaffected.`,
+    };
+}
+//# sourceMappingURL=child-environment.js.map

package/dist/child-environment.js.map

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

package/dist/coverage-capture.d.ts

@@ -0,0 +1,23 @@
+import { type ExecutedCoverage } from "./executed-coverage.ts";
+import type { RunnerKind } from "./test-runner-collector.ts";
+export declare const PYTHON_COVERAGE_DIRECTORY_VARIABLE = "DESCRY_COVERAGE_DIR";
+export declare const PYTHON_COVERAGE_ROOT_VARIABLE = "DESCRY_COVERAGE_ROOT";
+export declare const V8_COVERAGE_VARIABLE = "NODE_V8_COVERAGE";
+export interface CoverageCapture {
+    readonly directory: string;
+    readonly environment: Readonly<Record<string, string>>;
+    observeTestFile(rawPath: string): void;
+    collect(): ExecutedCoverage;
+    dispose(): void;
+}
+export type CoverageCaptureBegin = {
+    readonly ok: true;
+    readonly capture: CoverageCapture;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+export declare function coverageUnavailableReason(kind: RunnerKind): string | null;
+export declare function readPythonCoverageDirectory(directory: string, excludedPaths?: ReadonlySet<string>): ExecutedCoverage;
+export declare function beginCoverageCapture(kind: RunnerKind, cwd: string): CoverageCaptureBegin;
+//# sourceMappingURL=coverage-capture.d.ts.map

package/dist/coverage-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-capture.d.ts","sourceRoot":"","sources":["../src/coverage-capture.ts"],"names":[],"mappings":"AAKA,OAAO,EASL,KAAK,gBAAgB,EAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,eAAO,MAAM,kCAAkC,wBAAwB,CAAC;AACxE,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AACpE,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,OAAO,IAAI,gBAAgB,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAcpD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAEzE;AAyBD,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,gBAAgB,CAmD/H;AAsBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAsCxF"}

package/dist/coverage-capture.js

@@ -0,0 +1,165 @@
+import { existsSync, readdirSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describeSkippedDumps, forEachCoverageDump } from "./bounded-file.js";
+import { CoverageAccumulator, NoteLog, createCoverageTempDirectory, isRepositoryRelativePosixPath, removeCoverageTempDirectory, repositoryRelativePath, resolveRepositoryRoot, unavailableCoverage, } from "./executed-coverage.js";
+import { readV8CoverageDirectory } from "./v8-coverage.js";
+export const PYTHON_COVERAGE_DIRECTORY_VARIABLE = "DESCRY_COVERAGE_DIR";
+export const PYTHON_COVERAGE_ROOT_VARIABLE = "DESCRY_COVERAGE_ROOT";
+export const V8_COVERAGE_VARIABLE = "NODE_V8_COVERAGE";
+const UNAVAILABLE_REASONS = {
+    jest: "jest: coverage needs the framework's own coverage provider; not collected",
+    vitest: "vitest: coverage needs the framework's own coverage provider; not collected",
+    playwright: "playwright: coverage needs the framework's own coverage provider; not collected",
+    junit: "junit: executed lines on the JVM need a coverage agent such as JaCoCo attached to the test JVM, which is not a dependency-free hook; not collected",
+    xunit: "xunit: executed lines on .NET need a coverage collector package such as coverlet referenced by the test project, which is not a dependency-free hook; not collected",
+    rspec: "rspec: executed lines need Ruby's Coverage module started before the code under test loads or SimpleCov in the project, neither of which is a dependency-free hook; not collected",
+    phpunit: "phpunit: executed lines need Xdebug or PCOV loaded into PHP, which is not a dependency-free hook; not collected",
+    minitest: "minitest: executed lines need Ruby's Coverage module started before the code under test loads or SimpleCov in the project, neither of which is a dependency-free hook; not collected",
+    unittest: "unittest: plain `python -m unittest` has no plugin mechanism to load a line recorder into the run (only pytest's plugin is injected); not collected",
+};
+export function coverageUnavailableReason(kind) {
+    return UNAVAILABLE_REASONS[kind] ?? null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parsePythonRecording(parsed) {
+    if (!isRecord(parsed))
+        return null;
+    if (typeof parsed["unavailable"] === "string")
+        return { unavailable: parsed["unavailable"] };
+    const tool = parsed["tool"];
+    if ((tool !== "monitoring" && tool !== "settrace") || !isRecord(parsed["files"]))
+        return null;
+    const files = {};
+    for (const [path, lines] of Object.entries(parsed["files"])) {
+        if (Array.isArray(lines))
+            files[path] = lines.filter((line) => typeof line === "number");
+    }
+    const notes = Array.isArray(parsed["notes"]) ? parsed["notes"].filter((note) => typeof note === "string") : [];
+    return { tool, notes, files };
+}
+export function readPythonCoverageDirectory(directory, excludedPaths = new Set()) {
+    if (!existsSync(directory))
+        return unavailableCoverage("the Python coverage directory does not exist");
+    const dumps = readdirSync(directory)
+        .filter((name) => /^coverage-.*\.json$/.test(name))
+        .sort();
+    if (dumps.length === 0) {
+        return unavailableCoverage("the pytest plugin wrote no coverage: the run ended before pytest finished, or the plugin could not record");
+    }
+    const accumulator = new CoverageAccumulator();
+    const notes = new NoteLog();
+    const tools = new Set();
+    const unavailableReasons = new Set();
+    let malformed = 0;
+    const { skipped: skippedDumps } = forEachCoverageDump(directory, dumps, (_name, text) => {
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            malformed += 1;
+            return;
+        }
+        const recording = parsePythonRecording(parsed);
+        if (recording === null) {
+            malformed += 1;
+            return;
+        }
+        if ("unavailable" in recording) {
+            unavailableReasons.add(recording.unavailable);
+            return;
+        }
+        tools.add(recording.tool);
+        for (const note of recording.notes)
+            notes.add(note);
+        for (const [path, lines] of Object.entries(recording.files)) {
+            if (!isRepositoryRelativePosixPath(path) || excludedPaths.has(path))
+                continue;
+            accumulator.addFile(path, lines, null);
+        }
+    });
+    const skippedDumpNote = describeSkippedDumps(skippedDumps);
+    if (tools.size === 0) {
+        const reasons = [...unavailableReasons];
+        if (reasons.length > 0)
+            return unavailableCoverage(`the pytest plugin could not record: ${reasons.join("; ")}`);
+        return unavailableCoverage("every coverage file the pytest plugin wrote was unreadable");
+    }
+    if (skippedDumpNote !== null)
+        notes.add(skippedDumpNote);
+    if (malformed > 0)
+        notes.add(`${malformed} coverage file(s) written by the pytest plugin could not be parsed and were ignored`);
+    for (const reason of unavailableReasons)
+        notes.add(`a pytest process could not record: ${reason}`);
+    const tool = tools.has("settrace") ? "python-settrace" : "python-monitoring";
+    if (tools.size > 1)
+        notes.add("pytest processes recorded with different mechanisms; the result reports the slower sys.settrace one");
+    return accumulator.build(tool, notes);
+}
+function toAbsoluteTestPath(rawPath, repositoryRoot) {
+    if (rawPath === "")
+        return null;
+    if (rawPath.startsWith("file:")) {
+        try {
+            return fileURLToPath(rawPath);
+        }
+        catch {
+            return null;
+        }
+    }
+    return isAbsolute(rawPath) ? rawPath : resolve(repositoryRoot, rawPath);
+}
+function beginDirectory() {
+    try {
+        return { ok: true, directory: createCoverageTempDirectory() };
+    }
+    catch (error) {
+        return { ok: false, reason: `could not create a temporary directory for coverage data: ${error instanceof Error ? error.message : String(error)}` };
+    }
+}
+export function beginCoverageCapture(kind, cwd) {
+    const unavailable = coverageUnavailableReason(kind);
+    if (unavailable !== null)
+        return { ok: false, reason: unavailable };
+    if (kind !== "pytest" && kind !== "node:test")
+        return { ok: false, reason: `${kind}: no executed-line coverage hook is defined; not collected` };
+    const repositoryRoot = resolveRepositoryRoot(cwd);
+    const begun = beginDirectory();
+    if (!begun.ok)
+        return begun;
+    const { directory } = begun;
+    const observedTestFiles = new Set();
+    if (kind === "pytest") {
+        return {
+            ok: true,
+            capture: {
+                directory,
+                environment: { [PYTHON_COVERAGE_DIRECTORY_VARIABLE]: directory, [PYTHON_COVERAGE_ROOT_VARIABLE]: repositoryRoot },
+                observeTestFile: () => undefined,
+                collect: () => readPythonCoverageDirectory(directory),
+                dispose: () => removeCoverageTempDirectory(directory),
+            },
+        };
+    }
+    return {
+        ok: true,
+        capture: {
+            directory,
+            environment: { [V8_COVERAGE_VARIABLE]: directory },
+            observeTestFile(rawPath) {
+                const absolute = toAbsoluteTestPath(rawPath, repositoryRoot);
+                if (absolute === null)
+                    return;
+                const path = repositoryRelativePath(repositoryRoot, absolute);
+                if (path !== null)
+                    observedTestFiles.add(path);
+            },
+            collect: () => readV8CoverageDirectory({ directory, repositoryRoot, excludedPaths: observedTestFiles }),
+            dispose: () => removeCoverageTempDirectory(directory),
+        },
+    };
+}
+//# sourceMappingURL=coverage-capture.js.map

package/dist/coverage-capture.js.map

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

package/dist/executed-coverage.d.ts

@@ -0,0 +1,45 @@
+export type ExecutedCoverageTool = "python-monitoring" | "python-settrace" | "v8" | "go-cover";
+export interface ExecutedCoverageFile {
+    readonly path: string;
+    readonly executedLines: readonly number[];
+    readonly measuredLines: readonly number[] | null;
+}
+export type ExecutedCoverage = {
+    readonly available: true;
+    readonly tool: ExecutedCoverageTool;
+    readonly scope: "run";
+    readonly files: readonly ExecutedCoverageFile[];
+    readonly truncated: boolean;
+    readonly notes: readonly string[];
+} | {
+    readonly available: false;
+    readonly reason: string;
+};
+export declare const MAX_COVERAGE_FILES = 20000;
+export declare const MAX_COVERAGE_LINES = 2000000;
+export declare const MAX_COVERAGE_NOTES = 25;
+export declare const EXCLUDED_DIRECTORY_NAMES: ReadonlySet<string>;
+export declare function unavailableCoverage(reason: string): ExecutedCoverage;
+export declare function resolveRepositoryRoot(directory: string): string;
+export declare function hasExcludedSegment(posixRelativePath: string): boolean;
+export declare function repositoryRelativePath(repositoryRoot: string, absolutePath: string): string | null;
+export declare function isRepositoryRelativePosixPath(candidate: string): boolean;
+export declare function createCoverageTempDirectory(): string;
+export declare function removeCoverageTempDirectory(directory: string): void;
+export declare function withCoverageDirectoryAllowed<T extends {
+    readonly allowedRoots: readonly string[];
+}>(policy: T, directory: string): T;
+export declare class NoteLog {
+    private readonly seen;
+    private overflow;
+    add(note: string): void;
+    toArray(): readonly string[];
+}
+export declare class CoverageAccumulator {
+    private readonly files;
+    addFile(path: string, executedLines: Iterable<number>, measuredLines: Iterable<number> | null): void;
+    paths(): string[];
+    get fileCount(): number;
+    build(tool: ExecutedCoverageTool, notes: NoteLog): ExecutedCoverage;
+}
+//# sourceMappingURL=executed-coverage.d.ts.map

package/dist/executed-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executed-coverage.d.ts","sourceRoot":"","sources":["../src/executed-coverage.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,IAAI,GAAG,UAAU,CAAC;AAE/F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,GACD;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,kBAAkB,UAAY,CAAC;AAC5C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAUvD,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAEpE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED,wBAAgB,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAErE;AAED,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWlG;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAIxE;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMnE;AAED,wBAAgB,4BAA4B,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAEpI;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAK;IAErB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASvB,OAAO,IAAI,SAAS,MAAM,EAAE;CAI7B;AAWD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI;IAepG,KAAK,IAAI,MAAM,EAAE;IAIjB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,KAAK,CAAC,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB;CA6BpE"}