supercov 0.0.8 → 0.0.11

package/dist/waivers.js

@@ -0,0 +1,121 @@
+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

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

package/dist/workspace.d.ts

@@ -1,3 +1,4 @@
+export declare const RUN_STORE_CONTRACT_VERSION = 1;
 export type RunStateStatus = "preparing" | "building" | "testing" | "publishing" | "complete" | "failed" | "interrupted" | "abandoned";
 export interface RunState {
     id: string;
@@ -10,6 +11,30 @@ export interface RunState {
     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.
@@ -18,6 +43,17 @@ export declare function isolatedWorkspacePath(root: string, runId: string): stri
  * 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;

package/dist/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,UAAU,GACV,SAAS,GACT,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6CD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAoBD,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAwCxE;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,GACjC,QAAQ,CAOV;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,GACzE,QAAQ,CAaV;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAkBT;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA6C3D;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CA0C3E;AA6FD,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA8B5E;AAED,UAAU,qBAAqB;IAC7B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,2EAA2E;IAC3E,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,wEAAwE;IACxE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,qBAA0B,GAChC,MAAM,CAkFR;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOzE;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAsED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,aAAa,CAUf;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,aAAa,CAUf"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"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"}

package/dist/workspace.js

@@ -1,7 +1,10 @@
-import { copyFileSync, constants, existsSync, lstatSync, mkdirSync, openSync, closeSync, fsyncSync, readFileSync, readdirSync, readlinkSync, realpathSync, rmSync, symlinkSync, statSync, writeFileSync, } from "node:fs";
+import { copyFileSync, constants, existsSync, lstatSync, mkdirSync, openSync, closeSync, fsyncSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, symlinkSync, statSync, writeFileSync, } from "node:fs";
+import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
+import { tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import { atomicRenameSync, atomicWriteFileSync } from "./atomic.js";
+export const RUN_STORE_CONTRACT_VERSION = 1;
 const TERMINAL = new Set([
     "complete",
     "failed",
@@ -9,6 +12,7 @@ const TERMINAL = new Set([
     "abandoned",
 ]);
 const ROOT_EXCLUSIONS = new Set([
+    ".cache",
     ".git",
     ".supercov",
     ".mcdc-pool",
@@ -22,6 +26,122 @@ const ROOT_EXCLUSIONS = new Set([
     "playwright-report",
     "test-results",
 ]);
+const NESTED_SUPERCOV_EXCLUSIONS = new Set([".supercov", ".mcdc-pool"]);
+const TRASH_DIRECTORY = ".supercov/.trash";
+/**
+ * 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 function removeStoredTreeDeferred(root, target) {
+    const resolvedRoot = resolve(root);
+    const resolvedTarget = resolve(target);
+    if (!existsSync(resolvedTarget))
+        return undefined;
+    const trash = resolve(root, TRASH_DIRECTORY);
+    const store = resolve(resolvedRoot, ".supercov");
+    const container = workspaceContainerPath(resolvedRoot);
+    const inStore = resolvedTarget !== store &&
+        inside(store, resolvedTarget) &&
+        !inside(trash, resolvedTarget);
+    const inWorkspaceContainer = isWorkspaceContainer(container) && inside(container, resolvedTarget);
+    if (!inStore && !inWorkspaceContainer)
+        throw new Error(`Refusing to defer removal outside Supercov-owned storage: ${resolvedTarget}`);
+    mkdirSync(trash, { recursive: true });
+    const destination = resolve(trash, `${process.pid}-${randomUUID()}`);
+    try {
+        renameSync(resolvedTarget, destination);
+    }
+    catch (error) {
+        const code = error.code ?? "unknown";
+        throw new Error(`Could not move Supercov data into deferred trash (${code}): ${resolvedTarget}`, { cause: error });
+    }
+    return destination;
+}
+/** The detached deleter's whole program; also executed verbatim by tests. */
+export const TRASH_DELETER_SCRIPT = [
+    `const { closeSync, openSync, readFileSync, readdirSync, rmSync, unlinkSync, writeFileSync } = require("node:fs");`,
+    `const { resolve } = require("node:path");`,
+    `const trash = process.argv[1];`,
+    `const lock = resolve(trash, ".deleter.lock");`,
+    `const alive = (pid) => { try { process.kill(pid, 0); return true; } catch { return false; } };`,
+    `try {`,
+    `  const existing = Number(readFileSync(lock, "utf8"));`,
+    `  if (Number.isSafeInteger(existing) && existing > 0 && alive(existing)) process.exit(0);`,
+    `  try { unlinkSync(lock); } catch {}`,
+    `} catch {}`,
+    `let descriptor;`,
+    `try { descriptor = openSync(lock, "wx"); writeFileSync(descriptor, String(process.pid)); closeSync(descriptor); } catch { process.exit(0); }`,
+    `let entries = [];`,
+    `try { entries = readdirSync(trash); } catch {}`,
+    `for (const entry of entries) {`,
+    `  if (entry === ".deleter.lock") continue;`,
+    `  try { rmSync(resolve(trash, entry), { recursive: true, force: true, maxRetries: 3 }); } catch {}`,
+    `}`,
+    `try { unlinkSync(lock); } catch {}`,
+].join("\n");
+/** Unlink everything in the trash without making anyone wait for it. */
+export function spawnTrashDeleter(root) {
+    const trash = resolve(root, TRASH_DIRECTORY);
+    try {
+        if (readdirSync(trash).length === 0)
+            return;
+    }
+    catch {
+        return;
+    }
+    try {
+        spawn(process.execPath, ["-e", TRASH_DELETER_SCRIPT, trash], {
+            // A detached process must never inherit a project-owned directory as
+            // its cwd. Windows keeps that directory open and rejects the final
+            // recursive removal with EPERM until the deleter exits.
+            cwd: tmpdir(),
+            detached: true,
+            stdio: "ignore",
+        }).unref();
+    }
+    catch {
+        // Spawning is best-effort; the next invocation sweeps the same trash.
+    }
+}
+/** Marks `supercov/` as ours, so a project may own a directory by that name. */
+const WORKSPACE_CONTAINER_MARKER = ".supercov-workspace-store";
+/**
+ * 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 function workspaceContainerPath(root) {
+    return resolve(root, "supercov");
+}
+/** True only for a `supercov/` directory this tool created. */
+function isWorkspaceContainer(path) {
+    return (basename(path) === "supercov" &&
+        existsSync(resolve(path, WORKSPACE_CONTAINER_MARKER)));
+}
+function ensureWorkspaceContainer(root) {
+    const container = workspaceContainerPath(root);
+    mkdirSync(container, { recursive: true });
+    // Self-ignoring, so the directory never reaches the user's diff, and marked
+    // so source copying can distinguish it from a project's own `supercov/`.
+    for (const [file, contents] of [
+        [".gitignore", "*\n"],
+        [WORKSPACE_CONTAINER_MARKER, "Supercov instrumented workspace. Safe to delete.\n"],
+    ]) {
+        const path = resolve(container, file);
+        if (!existsSync(path))
+            atomicWriteFileSync(path, contents);
+    }
+    return container;
+}
 function processExists(pid) {
     if (!Number.isSafeInteger(pid) || pid <= 0)
         return false;
@@ -54,7 +174,39 @@ export function isolatedWorkspacePath(root, runId) {
  * The project lock makes refreshes single-writer.
  */
 export function cachedWorkspacePath(root) {
-    return resolve(root, ".supercov/cache/instrumented-workspace", basename(root));
+    return resolve(workspaceContainerPath(root), "workspace", basename(root));
+}
+/**
+ * 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 function pruneCachedWorkspaceSources(root) {
+    const workspace = cachedWorkspacePath(root);
+    if (!existsSync(workspace))
+        return [];
+    const metadata = readJson(resolve(workspace, ".supercov/build-cache.json"));
+    const keepRoots = new Set(["node_modules", ".supercov"]);
+    for (const artifact of metadata?.artifactPaths ?? []) {
+        const top = artifact.split(/[\\/]/)[0];
+        if (top)
+            keepRoots.add(top);
+    }
+    const removed = [];
+    for (const entry of readdirSync(workspace, { withFileTypes: true })) {
+        if (keepRoots.has(entry.name))
+            continue;
+        removeStoredTreeDeferred(root, resolve(workspace, entry.name));
+        removed.push(entry.name);
+    }
+    if (removed.length > 0)
+        spawnTrashDeleter(root);
+    return removed.sort();
 }
 function cacheTransactionPrefix(root, kind) {
     return `.${basename(root)}.${kind}-`;
@@ -93,11 +245,13 @@ export function recoverCachedWorkspace(root) {
         restoredPrevious = true;
     }
     for (const path of staging)
-        rmSync(path, { recursive: true, force: true });
+        removeStoredTreeDeferred(root, path);
     for (const path of previous)
-        rmSync(path, { recursive: true, force: true });
+        removeStoredTreeDeferred(root, path);
     for (const path of invalidPrevious)
-        rmSync(path, { recursive: true, force: true });
+        removeStoredTreeDeferred(root, path);
+    if (staging.length + previous.length + invalidPrevious.length > 0)
+        spawnTrashDeleter(root);
     return {
         restoredPrevious,
         removedStaging: staging.length,
@@ -133,18 +287,16 @@ export function finalizePublishedRunStorage(root, runId) {
         !existsSync(resolve(runDirectory, "evidence.raw.gz"))) {
         return false;
     }
-    rmSync(resolve(root, ".supercov/evidence", runId), {
-        recursive: true,
-        force: true,
-    });
-    rmSync(resolve(root, ".supercov/work", runId), {
-        recursive: true,
-        force: true,
-    });
+    removeStoredTreeDeferred(root, resolve(root, ".supercov/evidence", runId));
+    removeStoredTreeDeferred(root, resolve(root, ".supercov/work", runId));
+    spawnTrashDeleter(root);
     return true;
 }
 /** Recover dead runs and finish any publication whose atomic rename landed. */
 export function recoverAbandonedRuns(root) {
+    // A prior detached deleter may have been killed with the host. Sweep its
+    // durable trash before inspecting current run state.
+    spawnTrashDeleter(root);
     const workRoot = resolve(root, ".supercov/work");
     if (!existsSync(workRoot))
         return [];
@@ -165,14 +317,8 @@ export function recoverAbandonedRuns(root) {
         // Never trust a persisted path as a deletion target. A partially written
         // or manually edited state file cannot widen cleanup beyond this run's
         // deterministic workspace namespace.
-        rmSync(isolatedWorkspacePath(root, entry.name), {
-            recursive: true,
-            force: true,
-        });
-        rmSync(resolve(root, ".supercov/work", entry.name, "run-publication"), {
-            recursive: true,
-            force: true,
-        });
+        removeStoredTreeDeferred(root, isolatedWorkspacePath(root, entry.name));
+        removeStoredTreeDeferred(root, resolve(root, ".supercov/work", entry.name, "run-publication"));
         if (finalizePublishedRunStorage(root, entry.name)) {
             // The run directory is published by one atomic rename before the run
             // state flips terminal. Its run.json is the durable terminal record, so
@@ -182,10 +328,7 @@ export function recoverAbandonedRuns(root) {
             // Evidence moved out of the disposable workspace before run
             // generation is not a visible run. Remove that orphan on recovery so a
             // hard kill cannot accumulate partial run data indefinitely.
-            rmSync(resolve(root, ".supercov/evidence", entry.name), {
-                recursive: true,
-                force: true,
-            });
+            removeStoredTreeDeferred(root, resolve(root, ".supercov/evidence", entry.name));
             updateRunState(root, entry.name, {
                 status: "abandoned",
                 error: `Recovered after process ${state.pid} exited without cleanup`,
@@ -193,6 +336,8 @@ export function recoverAbandonedRuns(root) {
         }
         recovered.push(entry.name);
     }
+    if (recovered.length > 0)
+        spawnTrashDeleter(root);
     return recovered.sort();
 }
 export function acquireProjectLock(root, runId) {
@@ -248,9 +393,14 @@ function inside(root, path) {
 function copyTree(source, destination, root = false, sourceRoot = source, destinationRoot = destination, hooks = {}, finalDestinationRoot = destinationRoot) {
     mkdirSync(destination, { recursive: true });
     for (const entry of readdirSync(source, { withFileTypes: true })) {
-        if (root && ROOT_EXCLUSIONS.has(entry.name))
+        if ((root && ROOT_EXCLUSIONS.has(entry.name)) ||
+            NESTED_SUPERCOV_EXCLUSIONS.has(entry.name))
             continue;
         const from = resolve(source, entry.name);
+        // Never copy our own workspace into itself. Matched by marker rather than
+        // by name so a project may legitimately own a `supercov/` directory.
+        if (entry.isDirectory() && isWorkspaceContainer(from))
+            continue;
         const to = resolve(destination, entry.name);
         const stat = lstatSync(from);
         if (stat.isDirectory())
@@ -301,7 +451,8 @@ function copyTree(source, destination, root = false, sourceRoot = source, destin
 /** Create a copy-on-write project snapshot whose build outputs are disposable. */
 export function prepareIsolatedWorkspace(root, runId) {
     const workspace = isolatedWorkspacePath(root, runId);
-    rmSync(workspace, { recursive: true, force: true });
+    if (removeStoredTreeDeferred(root, workspace))
+        spawnTrashDeleter(root);
     copyTree(root, workspace, true);
     const nodeModules = resolve(root, "node_modules");
     if (existsSync(nodeModules)) {
@@ -329,6 +480,7 @@ export function prepareIsolatedWorkspace(root, runId) {
 /** Refresh the stable, disposable instrumented-build namespace. */
 export function prepareCachedWorkspace(root, hooks = {}) {
     const workspace = cachedWorkspacePath(root);
+    ensureWorkspaceContainer(root);
     recoverCachedWorkspace(root);
     const staging = cacheTransactionPath(root, "staging");
     const previous = cacheTransactionPath(root, "previous");
@@ -396,13 +548,15 @@ export function prepareCachedWorkspace(root, hooks = {}) {
         throw error;
     }
     finally {
-        rmSync(staging, { recursive: true, force: true });
+        if (removeStoredTreeDeferred(root, staging))
+            spawnTrashDeleter(root);
     }
     // Failure to remove an obsolete previous generation must not invalidate the
     // newly published cache. The next invocation and `supercov clean` both
     // remove it deterministically.
     try {
-        rmSync(previous, { recursive: true, force: true });
+        if (removeStoredTreeDeferred(root, previous))
+            spawnTrashDeleter(root);
     }
     catch {
         // Deliberately retained for recoverCachedWorkspace().
@@ -415,7 +569,8 @@ export function removeIsolatedWorkspace(root, runId) {
     if (relativePath.startsWith("..") || relativePath.split(sep).length < 2) {
         throw new Error(`Refusing to remove unexpected workspace path: ${workspace}`);
     }
-    rmSync(workspace, { recursive: true, force: true });
+    if (removeStoredTreeDeferred(root, workspace))
+        spawnTrashDeleter(root);
 }
 /** Deterministic retention: IDs sort newest-first because run IDs are UTC. */
 function cleanCoverageStorageLocked(root, options, removeBuildCache) {
@@ -458,24 +613,48 @@ function cleanCoverageStorageLocked(root, options, removeBuildCache) {
         if (removeTransientWork) {
             removedWorkspaces.push(id);
             if (!options.dryRun)
-                rmSync(work, { recursive: true, force: true });
+                removeStoredTreeDeferred(root, work);
         }
         const hasLooseEvidence = existsSync(resolve(evidenceRoot, id));
         if (hasLooseEvidence && (!hasPublishedRun || removeHistory)) {
             removedEvidence.push(id);
             if (!options.dryRun)
-                rmSync(resolve(evidenceRoot, id), { recursive: true, force: true });
+                removeStoredTreeDeferred(root, resolve(evidenceRoot, id));
         }
         if (removeHistory) {
             removedRuns.push(id);
             if (!options.dryRun)
-                rmSync(resolve(runsRoot, id), { recursive: true, force: true });
+                removeStoredTreeDeferred(root, resolve(runsRoot, id));
         }
     }
-    const buildCache = resolve(root, ".supercov/cache/instrumented-workspace");
-    const removedBuildCache = removeBuildCache && active.size === 0 && existsSync(buildCache);
-    if (removedBuildCache && !options.dryRun)
-        rmSync(buildCache, { recursive: true, force: true });
+    const buildCache = workspaceContainerPath(root);
+    // Releases before the workspace was moved out of the dotted store used
+    // both of these names. `clean` is the explicit destructive command, so it
+    // must migrate them too; otherwise a project can retain millions of files
+    // in a layout the current engine will never reuse. `prune` deliberately
+    // preserves every cache generation.
+    const legacyBuildCaches = [
+        resolve(root, ".supercov/.cache"),
+        resolve(root, ".supercov/cache"),
+    ];
+    const removableBuildCaches = removeBuildCache && active.size === 0
+        ? [
+            ...(existsSync(buildCache) && isWorkspaceContainer(buildCache)
+                ? [buildCache]
+                : []),
+            ...legacyBuildCaches.filter((path) => existsSync(path)),
+        ]
+        : [];
+    const removedBuildCache = removableBuildCaches.length > 0;
+    if (!options.dryRun)
+        for (const path of removableBuildCaches)
+            removeStoredTreeDeferred(root, path);
+    if (!options.dryRun &&
+        (removedRuns.length > 0 ||
+            removedWorkspaces.length > 0 ||
+            removedEvidence.length > 0 ||
+            removedBuildCache))
+        spawnTrashDeleter(root);
     return { removedRuns, removedWorkspaces, removedEvidence, removedBuildCache };
 }
 /** Cleanup is itself a project-wide transaction, so it cannot race a run. */