supercov 0.0.11 → 0.0.13

package/dist/waivers.d.ts

@@ -1,52 +0,0 @@
-import type { McdcDecisionResult } from "./types.ts";
-export declare const WAIVERS_FILE = "supercov.waivers.json";
-export declare const WAIVERS_SCHEMA_VERSION = 1;
-/**
- * A reviewed statement that one MC/DC condition has no satisfiable
- * independence pair. Waivers never change measured coverage: waived
- * conditions stay uncovered in every raw total and are reported as a
- * separate category alongside them.
- */
-export interface CoverageWaiver {
-    file: string;
-    /** Decision ID or the decision's exact source text (whitespace-insensitive). */
-    decision?: string;
-    /** Disambiguates identical decision sources at different locations. */
-    line?: number;
-    /** Condition source text (whitespace-insensitive), or "C<n>" with a decision. */
-    condition: string;
-    reason: string;
-}
-export interface CoverageWaiverMatch {
-    waiver: CoverageWaiver;
-    decisionId: string;
-    file: string;
-    line: number;
-    conditionIndex: number;
-    conditionSource: string;
-    /** A waiver on a condition that is actually covered contradicts the review. */
-    covered: boolean;
-}
-export interface CoverageWaiverEvaluation {
-    path: string;
-    waivers: CoverageWaiver[];
-    /** Uncovered conditions excused by a reviewed waiver. */
-    applied: CoverageWaiverMatch[];
-    /** Waivers whose condition the run proves covered. */
-    contradicted: CoverageWaiverMatch[];
-    /** Waivers that match no decision condition in this run. */
-    unmatched: CoverageWaiver[];
-    /** decision ID -> condition index -> waiver, for annotating views. */
-    waivedByDecision: Map<string, Map<number, CoverageWaiver>>;
-    /** file -> count of applied waivers, for per-file gap views. */
-    appliedByFile: Map<string, number>;
-}
-export declare function readCoverageWaivers(root: string): {
-    path: string;
-    waivers: CoverageWaiver[];
-} | undefined;
-export declare function evaluateCoverageWaivers(decisions: McdcDecisionResult[], source: {
-    path: string;
-    waivers: CoverageWaiver[];
-}): CoverageWaiverEvaluation;
-//# sourceMappingURL=waivers.d.ts.map

package/dist/waivers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"waivers.d.ts","sourceRoot":"","sources":["../src/waivers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,YAAY,0BAA0B,CAAC;AACpD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,yDAAyD;IACzD,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,sDAAsD;IACtD,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,4DAA4D;IAC5D,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,sEAAsE;IACtE,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC3D,gEAAgE;IAChE,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAcD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,GAAG,SAAS,CAuDzD;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,kBAAkB,EAAE,EAC/B,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,GAClD,wBAAwB,CAmE1B"}

package/dist/waivers.js

@@ -1,121 +0,0 @@
-import { readFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { SupercovError } from "./agentJson.js";
-export const WAIVERS_FILE = "supercov.waivers.json";
-export const WAIVERS_SCHEMA_VERSION = 1;
-function normalizedSource(source) {
-    return source.replace(/\s+/g, " ").trim();
-}
-function invalidWaiver(index, problem) {
-    return new SupercovError("INVALID_ARGUMENT", `${WAIVERS_FILE} waiver ${index + 1} ${problem}`, { details: { file: WAIVERS_FILE, waiver: index + 1 } });
-}
-export function readCoverageWaivers(root) {
-    const path = resolve(root, WAIVERS_FILE);
-    let raw;
-    try {
-        raw = readFileSync(path, "utf8");
-    }
-    catch {
-        return undefined;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch (error) {
-        throw new SupercovError("INVALID_ARGUMENT", `${WAIVERS_FILE} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`, { details: { file: WAIVERS_FILE } });
-    }
-    const record = parsed;
-    if (record?.version !== WAIVERS_SCHEMA_VERSION || !Array.isArray(record.waivers)) {
-        throw new SupercovError("INVALID_ARGUMENT", `${WAIVERS_FILE} must be {"version": 1, "waivers": [...]}`, { details: { file: WAIVERS_FILE } });
-    }
-    const waivers = record.waivers.map((entry, index) => {
-        const waiver = entry;
-        if (typeof waiver?.file !== "string" || waiver.file.length === 0)
-            throw invalidWaiver(index, "requires a non-empty file");
-        if (typeof waiver.condition !== "string" || waiver.condition.length === 0)
-            throw invalidWaiver(index, "requires a non-empty condition");
-        if (typeof waiver.reason !== "string" || waiver.reason.trim().length === 0)
-            throw invalidWaiver(index, "requires a non-empty reason");
-        if (waiver.decision !== undefined && typeof waiver.decision !== "string")
-            throw invalidWaiver(index, "has a non-string decision");
-        if (waiver.line !== undefined &&
-            (!Number.isSafeInteger(waiver.line) || waiver.line < 1))
-            throw invalidWaiver(index, "has a non-positive line");
-        if (/^C\d+$/.test(waiver.condition) && !waiver.decision)
-            throw invalidWaiver(index, `uses the positional condition ${waiver.condition} without a decision`);
-        return {
-            file: waiver.file,
-            ...(waiver.decision !== undefined ? { decision: waiver.decision } : {}),
-            ...(waiver.line !== undefined ? { line: waiver.line } : {}),
-            condition: waiver.condition,
-            reason: waiver.reason,
-        };
-    });
-    return { path, waivers };
-}
-export function evaluateCoverageWaivers(decisions, source) {
-    const applied = [];
-    const contradicted = [];
-    const unmatched = [];
-    const waivedByDecision = new Map();
-    const appliedByFile = new Map();
-    for (const waiver of source.waivers) {
-        const matches = [];
-        for (const decision of decisions) {
-            if (decision.meta.file !== waiver.file)
-                continue;
-            if (waiver.line !== undefined && decision.meta.line !== waiver.line)
-                continue;
-            if (waiver.decision !== undefined &&
-                decision.meta.id !== waiver.decision &&
-                normalizedSource(decision.meta.source) !==
-                    normalizedSource(waiver.decision))
-                continue;
-            for (const condition of decision.conditions) {
-                const positional = `C${condition.index + 1}`;
-                if (waiver.condition !== positional &&
-                    normalizedSource(condition.source) !==
-                        normalizedSource(waiver.condition))
-                    continue;
-                matches.push({
-                    waiver,
-                    decisionId: decision.meta.id,
-                    file: decision.meta.file,
-                    line: decision.meta.line,
-                    conditionIndex: condition.index,
-                    conditionSource: condition.source,
-                    covered: condition.covered,
-                });
-            }
-        }
-        if (matches.length === 0) {
-            unmatched.push(waiver);
-            continue;
-        }
-        for (const match of matches) {
-            if (match.covered) {
-                contradicted.push(match);
-                continue;
-            }
-            const byCondition = waivedByDecision.get(match.decisionId) ??
-                new Map();
-            if (byCondition.has(match.conditionIndex))
-                continue;
-            applied.push(match);
-            byCondition.set(match.conditionIndex, match.waiver);
-            waivedByDecision.set(match.decisionId, byCondition);
-            appliedByFile.set(match.file, (appliedByFile.get(match.file) ?? 0) + 1);
-        }
-    }
-    return {
-        path: source.path,
-        waivers: source.waivers,
-        applied,
-        contradicted,
-        unmatched,
-        waivedByDecision,
-        appliedByFile,
-    };
-}
-//# sourceMappingURL=waivers.js.map

package/dist/waivers.js.map

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

package/dist/workspace.d.ts

@@ -1,117 +0,0 @@
-export declare const RUN_STORE_CONTRACT_VERSION = 1;
-export type RunStateStatus = "preparing" | "building" | "testing" | "publishing" | "complete" | "failed" | "interrupted" | "abandoned";
-export interface RunState {
-    id: string;
-    pid: number;
-    root: string;
-    workspace: string;
-    startedAt: string;
-    updatedAt: string;
-    status: RunStateStatus;
-    signal?: NodeJS.Signals;
-    error?: string;
-}
-/**
- * Unlinking a large tree (workspace copies, per-attempt evidence) can take
- * minutes of uninterruptible I/O — observed at 26+ minutes on a real project.
- * Removal must never block the command: rename the tree into the store's
- * trash (atomic on the same filesystem, so the path disappears instantly) and
- * let a detached deleter unlink it after this process has already returned.
- * A crash between rename and unlink just leaves the entry in the trash, and
- * every later invocation sweeps whatever it finds there.
- */
-export declare function removeStoredTreeDeferred(root: string, target: string): string | undefined;
-/** The detached deleter's whole program; also executed verbatim by tests. */
-export declare const TRASH_DELETER_SCRIPT: string;
-/** Unlink everything in the trash without making anyone wait for it. */
-export declare function spawnTrashDeleter(root: string): void;
-/**
- * The instrumented workspace deliberately lives outside the dotted store.
- * Widely used libraries treat *any* dot-prefixed path segment as a hidden
- * dotfile — `send` (and therefore `express.static`, `serve-static` and
- * `res.sendFile`) answers 404 for them by default — so an application under
- * test cannot serve its own files from a dotted workspace. Copied test files
- * are kept out of the user's ordinary runner discovery by
- * `pruneCachedWorkspaceSources` at run end, not by hiding the path.
- */
-export declare function workspaceContainerPath(root: string): string;
-export declare function isolatedWorkspacePath(root: string, runId: string): string;
-/**
- * Stable isolated namespace used as a live mount by VM/container runners.
- * Its path must remain stable so providers whose snapshot key includes mount
- * paths can reuse an instrumented snapshot across equivalent coverage runs.
- * The project lock makes refreshes single-writer.
- */
-export declare function cachedWorkspacePath(root: string): string;
-/**
- * Remove the copied source and test files from the stable cached workspace
- * once a run ends. Between runs those copies are pure liability: the next
- * refresh re-copies them anyway, but an ordinary test runner invoked at the
- * project root (whose default discovery does not exclude dot-directories —
- * Vitest 4 excludes only node_modules and .git) would find the copied test
- * files and silently double-count the user's suite. Keep only what the next
- * run genuinely reuses: dependency symlinks, the generated adapter directory,
- * and the instrumented build artifacts the build cache declares.
- */
-export declare function pruneCachedWorkspaceSources(root: string): string[];
-export interface CacheRecoveryResult {
-    restoredPrevious: boolean;
-    removedStaging: number;
-    removedPrevious: number;
-}
-/**
- * Recover the stable cache at transaction boundaries that SIGKILL or a host
- * crash can interrupt. A staging tree is never live. A previous tree is
- * restored only when the stable name is absent; otherwise it is obsolete.
- */
-export declare function recoverCachedWorkspace(root: string): CacheRecoveryResult;
-export declare function writeRunState(root: string, runId: string, state: Omit<RunState, "updatedAt">): RunState;
-export declare function updateRunState(root: string, runId: string, update: Partial<Omit<RunState, "id" | "root" | "workspace" | "startedAt">>): RunState;
-/**
- * A published run is self-contained only once its raw-evidence archive exists.
- * At that point loose evidence and per-run state are transactional leftovers,
- * not user history. Derive every deletion target from root + run ID.
- */
-export declare function finalizePublishedRunStorage(root: string, runId: string): boolean;
-/** Recover dead runs and finish any publication whose atomic rename landed. */
-export declare function recoverAbandonedRuns(root: string): string[];
-export interface ProjectLock {
-    path: string;
-    release: () => void;
-}
-export declare function acquireProjectLock(root: string, runId: string): ProjectLock;
-/** Create a copy-on-write project snapshot whose build outputs are disposable. */
-export declare function prepareIsolatedWorkspace(root: string, runId: string): string;
-interface CachePreparationHooks {
-    /** Internal fault-injection seam used by the crash-boundary regression. */
-    beforePublish?: (staging: string) => void;
-    /** Internal fault-injection seam used by the crash-boundary regression. */
-    afterPreviousMoved?: (previous: string) => void;
-    /** Internal fault-injection seam used by the crash-boundary regression. */
-    afterPublished?: (workspace: string) => void;
-    /** Internal fault-injection seam for copy fallback and ENOSPC tests. */
-    copyFile?: (source: string, destination: string) => void;
-    /** Exact-fingerprint build artifacts carried into the refreshed snapshot. */
-    reusePaths?: string[];
-    /** Internal seam for simulating platform rename failures. */
-    rename?: (source: string, destination: string) => void;
-}
-/** Refresh the stable, disposable instrumented-build namespace. */
-export declare function prepareCachedWorkspace(root: string, hooks?: CachePreparationHooks): string;
-export declare function removeIsolatedWorkspace(root: string, runId: string): void;
-export interface CleanupOptions {
-    keep: number;
-    dryRun: boolean;
-}
-export interface CleanupResult {
-    removedRuns: string[];
-    removedWorkspaces: string[];
-    removedEvidence: string[];
-    removedBuildCache: boolean;
-}
-/** Cleanup is itself a project-wide transaction, so it cannot race a run. */
-export declare function cleanCoverageStorage(root: string, options: CleanupOptions): CleanupResult;
-/** Explicit history retention that deliberately preserves the shared cache. */
-export declare function pruneCoverageStorage(root: string, options: CleanupOptions): CleanupResult;
-export {};
-//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

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