supercov 0.0.2 → 0.0.4

package/dist/workspace.js

@@ -0,0 +1,501 @@
+import { copyFileSync, constants, existsSync, lstatSync, mkdirSync, openSync, closeSync, fsyncSync, readFileSync, readdirSync, readlinkSync, realpathSync, rmSync, symlinkSync, statSync, writeFileSync, } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { atomicRenameSync, atomicWriteFileSync } from "./atomic.js";
+const TERMINAL = new Set([
+    "complete",
+    "failed",
+    "interrupted",
+    "abandoned",
+]);
+const ROOT_EXCLUSIONS = new Set([
+    ".git",
+    ".supercov",
+    ".mcdc-pool",
+    "node_modules",
+    "build",
+    "dist",
+    ".next",
+    ".nuxt",
+    ".output",
+    "coverage",
+    "playwright-report",
+    "test-results",
+]);
+function processExists(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function statePath(root, runId) {
+    return resolve(root, ".supercov/work", runId, "state.json");
+}
+export function isolatedWorkspacePath(root, runId) {
+    return resolve(root, ".supercov/work", runId, basename(root));
+}
+/**
+ * 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 function cachedWorkspacePath(root) {
+    return resolve(root, ".supercov/cache/instrumented-workspace", basename(root));
+}
+function cacheTransactionPrefix(root, kind) {
+    return `.${basename(root)}.${kind}-`;
+}
+function cacheTransactionPath(root, kind) {
+    const workspace = cachedWorkspacePath(root);
+    return resolve(dirname(workspace), `${cacheTransactionPrefix(root, kind)}${process.pid}-${randomUUID()}`);
+}
+/**
+ * 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 function recoverCachedWorkspace(root) {
+    const workspace = cachedWorkspacePath(root);
+    const parent = dirname(workspace);
+    if (!existsSync(parent))
+        return { restoredPrevious: false, removedStaging: 0, removedPrevious: 0 };
+    const entries = readdirSync(parent, { withFileTypes: true });
+    const stagingPrefix = cacheTransactionPrefix(root, "staging");
+    const previousPrefix = cacheTransactionPrefix(root, "previous");
+    const staging = entries
+        .filter((entry) => entry.name.startsWith(stagingPrefix))
+        .map((entry) => resolve(parent, entry.name));
+    const previous = entries
+        .filter((entry) => entry.name.startsWith(previousPrefix) && entry.isDirectory())
+        .map((entry) => resolve(parent, entry.name))
+        .sort((left, right) => lstatSync(right).mtimeMs - lstatSync(left).mtimeMs);
+    const invalidPrevious = entries
+        .filter((entry) => entry.name.startsWith(previousPrefix) && !entry.isDirectory())
+        .map((entry) => resolve(parent, entry.name));
+    let restoredPrevious = false;
+    if (!existsSync(workspace) && previous[0]) {
+        atomicRenameSync(previous[0], workspace);
+        previous.shift();
+        restoredPrevious = true;
+    }
+    for (const path of staging)
+        rmSync(path, { recursive: true, force: true });
+    for (const path of previous)
+        rmSync(path, { recursive: true, force: true });
+    for (const path of invalidPrevious)
+        rmSync(path, { recursive: true, force: true });
+    return {
+        restoredPrevious,
+        removedStaging: staging.length,
+        removedPrevious: previous.length + invalidPrevious.length,
+    };
+}
+export function writeRunState(root, runId, state) {
+    const complete = { ...state, updatedAt: new Date().toISOString() };
+    atomicWriteFileSync(statePath(root, runId), `${JSON.stringify(complete, null, 2)}\n`);
+    return complete;
+}
+export function updateRunState(root, runId, update) {
+    const current = readJson(statePath(root, runId));
+    if (!current)
+        throw new Error(`Run state is missing for ${runId}`);
+    const next = {
+        ...current,
+        ...update,
+        updatedAt: new Date().toISOString(),
+    };
+    atomicWriteFileSync(statePath(root, runId), `${JSON.stringify(next, null, 2)}\n`);
+    return next;
+}
+/**
+ * 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 function finalizePublishedRunStorage(root, runId) {
+    const runDirectory = resolve(root, ".supercov/runs", runId);
+    const publishedRun = readJson(resolve(runDirectory, "run.json"));
+    if (publishedRun?.id !== 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,
+    });
+    return true;
+}
+/** Recover dead runs and finish any publication whose atomic rename landed. */
+export function recoverAbandonedRuns(root) {
+    const workRoot = resolve(root, ".supercov/work");
+    if (!existsSync(workRoot))
+        return [];
+    const recovered = [];
+    for (const entry of readdirSync(workRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const path = statePath(root, entry.name);
+        const state = readJson(path);
+        if (!state)
+            continue;
+        if (TERMINAL.has(state.status)) {
+            finalizePublishedRunStorage(root, entry.name);
+            continue;
+        }
+        if (processExists(state.pid))
+            continue;
+        // 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,
+        });
+        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
+            // recovery completes cleanup without recreating disposable state.
+        }
+        else {
+            // 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,
+            });
+            updateRunState(root, entry.name, {
+                status: "abandoned",
+                error: `Recovered after process ${state.pid} exited without cleanup`,
+            });
+        }
+        recovered.push(entry.name);
+    }
+    return recovered.sort();
+}
+export function acquireProjectLock(root, runId) {
+    const lockPath = resolve(root, ".supercov/locks/active.json");
+    mkdirSync(dirname(lockPath), { recursive: true });
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        let descriptor;
+        try {
+            descriptor = openSync(lockPath, "wx", 0o600);
+            const payload = `${JSON.stringify({ runId, pid: process.pid, startedAt: new Date().toISOString() }, null, 2)}\n`;
+            writeFileSync(descriptor, payload);
+            fsyncSync(descriptor);
+            closeSync(descriptor);
+            descriptor = undefined;
+            let released = false;
+            return {
+                path: lockPath,
+                release() {
+                    if (released)
+                        return;
+                    released = true;
+                    const owner = readJson(lockPath);
+                    if (owner?.runId === runId && owner.pid === process.pid)
+                        rmSync(lockPath, { force: true });
+                },
+            };
+        }
+        catch (error) {
+            if (descriptor !== undefined)
+                closeSync(descriptor);
+            const failure = error;
+            if (failure.code !== "EEXIST")
+                throw error;
+            const owner = readJson(lockPath);
+            if (owner?.pid && processExists(owner.pid)) {
+                throw new Error(`Coverage run ${owner.runId ?? "unknown"} is already active in this project (pid ${owner.pid})`);
+            }
+            if (!owner) {
+                const ageMs = Date.now() - statSync(lockPath).mtimeMs;
+                if (ageMs < 30_000)
+                    throw new Error("A coverage run is currently acquiring the project lock");
+            }
+            rmSync(lockPath, { force: true });
+        }
+    }
+    throw new Error("Could not acquire the Supercov project lock");
+}
+function inside(root, path) {
+    const local = relative(root, path);
+    return (local === "" ||
+        (!local.startsWith(`..${sep}`) && local !== ".." && !isAbsolute(local)));
+}
+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))
+            continue;
+        const from = resolve(source, entry.name);
+        const to = resolve(destination, entry.name);
+        const stat = lstatSync(from);
+        if (stat.isDirectory())
+            copyTree(from, to, false, sourceRoot, destinationRoot, hooks, finalDestinationRoot);
+        else if (stat.isSymbolicLink()) {
+            const link = readlinkSync(from);
+            const lexicalTarget = isAbsolute(link)
+                ? resolve(link)
+                : resolve(dirname(from), link);
+            let finalTarget;
+            try {
+                finalTarget = realpathSync(from);
+            }
+            catch (error) {
+                if (error.code !== "ENOENT")
+                    throw error;
+            }
+            if (!inside(sourceRoot, lexicalTarget) ||
+                (finalTarget && !inside(realpathSync(sourceRoot), finalTarget))) {
+                throw new Error(`Refusing to preserve symlink outside the isolated project: ${relative(sourceRoot, from)} -> ${link}`);
+            }
+            const targetIsDirectory = statSync(from).isDirectory();
+            const relocatedAbsoluteTarget = resolve(destinationRoot, relative(sourceRoot, lexicalTarget));
+            // Windows junctions are absolute. Point them at the stable name that the
+            // staging tree will have after publication, not the staging name that is
+            // about to disappear. POSIX links remain relative and survive rename.
+            const isolatedLink = process.platform === "win32" && targetIsDirectory
+                ? resolve(finalDestinationRoot, relative(sourceRoot, lexicalTarget))
+                : isAbsolute(link)
+                    ? relative(dirname(to), relocatedAbsoluteTarget)
+                    : link;
+            symlinkSync(isolatedLink, to, process.platform === "win32"
+                ? targetIsDirectory
+                    ? "junction"
+                    : "file"
+                : undefined);
+        }
+        else if (stat.isFile()) {
+            if (hooks.copyFile)
+                hooks.copyFile(from, to);
+            else
+                copyFileSync(from, to, constants.COPYFILE_FICLONE);
+        }
+        else
+            throw new Error(`Unsupported filesystem entry in isolated project: ${relative(sourceRoot, from)}`);
+    }
+}
+/** 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 });
+    copyTree(root, workspace, true);
+    const nodeModules = resolve(root, "node_modules");
+    if (existsSync(nodeModules)) {
+        // Keep the node_modules mount point itself as a real directory. VM-based
+        // runners commonly layer a Linux dependency cache onto the mounted
+        // workspace's node_modules path;
+        // making the mount point an external symlink causes virtio-fs's safe
+        // `opaque` policy to reject LOOKUP with EACCES before the nested mount can
+        // be attached. Per-entry links still give host-side builds zero-copy
+        // access to the user's installed dependencies and are hidden by the VM's
+        // nested mount.
+        const isolatedNodeModules = resolve(workspace, "node_modules");
+        mkdirSync(isolatedNodeModules, { recursive: true });
+        for (const entry of readdirSync(nodeModules, { withFileTypes: true })) {
+            const target = resolve(nodeModules, entry.name);
+            symlinkSync(target, resolve(isolatedNodeModules, entry.name), process.platform === "win32"
+                ? entry.isDirectory()
+                    ? "junction"
+                    : "file"
+                : undefined);
+        }
+    }
+    return workspace;
+}
+/** Refresh the stable, disposable instrumented-build namespace. */
+export function prepareCachedWorkspace(root, hooks = {}) {
+    const workspace = cachedWorkspacePath(root);
+    recoverCachedWorkspace(root);
+    const staging = cacheTransactionPath(root, "staging");
+    const previous = cacheTransactionPath(root, "previous");
+    let movedPrevious = false;
+    try {
+        copyTree(root, staging, true, root, staging, hooks, workspace);
+        const nodeModules = resolve(root, "node_modules");
+        if (existsSync(nodeModules)) {
+            const isolatedNodeModules = resolve(staging, "node_modules");
+            mkdirSync(isolatedNodeModules, { recursive: true });
+            for (const entry of readdirSync(nodeModules, { withFileTypes: true })) {
+                symlinkSync(resolve(nodeModules, entry.name), resolve(isolatedNodeModules, entry.name), process.platform === "win32"
+                    ? entry.isDirectory()
+                        ? "junction"
+                        : "file"
+                    : undefined);
+            }
+        }
+        for (const requested of hooks.reusePaths ?? []) {
+            const from = resolve(workspace, requested);
+            const to = resolve(staging, requested);
+            if (!inside(workspace, from) ||
+                from === workspace ||
+                !inside(staging, to) ||
+                to === staging ||
+                !existsSync(from)) {
+                throw new Error(`Refusing to reuse unexpected build path: ${requested}`);
+            }
+            const stat = lstatSync(from);
+            if (stat.isDirectory())
+                copyTree(from, to, false, workspace, staging, hooks, workspace);
+            else if (stat.isFile()) {
+                mkdirSync(dirname(to), { recursive: true });
+                if (hooks.copyFile)
+                    hooks.copyFile(from, to);
+                else
+                    copyFileSync(from, to, constants.COPYFILE_FICLONE);
+            }
+            else {
+                throw new Error(`Unsupported reusable build entry: ${requested}`);
+            }
+        }
+        hooks.beforePublish?.(staging);
+        // Keep the last complete cache available for the whole refresh. These two
+        // same-filesystem renames are the only publication boundary. Recovery
+        // restores `previous` if the process is killed in the narrow gap.
+        const publishRename = hooks.rename ?? atomicRenameSync;
+        if (existsSync(workspace)) {
+            publishRename(workspace, previous);
+            movedPrevious = true;
+            hooks.afterPreviousMoved?.(previous);
+        }
+        publishRename(staging, workspace);
+        hooks.afterPublished?.(workspace);
+    }
+    catch (error) {
+        if (movedPrevious && !existsSync(workspace) && existsSync(previous)) {
+            try {
+                atomicRenameSync(previous, workspace);
+            }
+            catch {
+                // Leave the previous tree for deterministic recovery next invocation.
+            }
+        }
+        throw error;
+    }
+    finally {
+        rmSync(staging, { recursive: true, force: true });
+    }
+    // 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 });
+    }
+    catch {
+        // Deliberately retained for recoverCachedWorkspace().
+    }
+    return workspace;
+}
+export function removeIsolatedWorkspace(root, runId) {
+    const workspace = isolatedWorkspacePath(root, runId);
+    const relativePath = relative(resolve(root, ".supercov/work"), workspace);
+    if (relativePath.startsWith("..") || relativePath.split(sep).length < 2) {
+        throw new Error(`Refusing to remove unexpected workspace path: ${workspace}`);
+    }
+    rmSync(workspace, { recursive: true, force: true });
+}
+/** Deterministic retention: IDs sort newest-first because run IDs are UTC. */
+function cleanCoverageStorageLocked(root, options, removeBuildCache) {
+    recoverAbandonedRuns(root);
+    const runsRoot = resolve(root, ".supercov/runs");
+    const workRoot = resolve(root, ".supercov/work");
+    const evidenceRoot = resolve(root, ".supercov/evidence");
+    const bases = [runsRoot, workRoot, evidenceRoot];
+    const ids = new Set();
+    for (const base of bases) {
+        if (!existsSync(base))
+            continue;
+        for (const entry of readdirSync(base, { withFileTypes: true }))
+            if (entry.isDirectory())
+                ids.add(entry.name);
+    }
+    const ordered = [...ids].sort((left, right) => right.localeCompare(left));
+    const active = new Set(ordered.filter((id) => {
+        const state = readJson(resolve(root, ".supercov/work", id, "state.json"));
+        return Boolean(state && !TERMINAL.has(state.status));
+    }));
+    const published = existsSync(runsRoot)
+        ? readdirSync(runsRoot, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort((left, right) => right.localeCompare(left))
+        : [];
+    const retained = new Set(published.filter((id) => !active.has(id)).slice(0, Math.max(0, options.keep)));
+    const removedRuns = [];
+    const removedWorkspaces = [];
+    const removedEvidence = [];
+    for (const id of ordered) {
+        const work = resolve(root, ".supercov/work", id);
+        const state = readJson(resolve(work, "state.json"));
+        if (active.has(id))
+            continue;
+        const hasPublishedRun = existsSync(resolve(runsRoot, id));
+        const removeHistory = hasPublishedRun && !retained.has(id);
+        const removeTransientWork = existsSync(work) && (!state || TERMINAL.has(state.status));
+        if (removeTransientWork) {
+            removedWorkspaces.push(id);
+            if (!options.dryRun)
+                rmSync(work, { recursive: true, force: true });
+        }
+        const hasLooseEvidence = existsSync(resolve(evidenceRoot, id));
+        if (hasLooseEvidence && (!hasPublishedRun || removeHistory)) {
+            removedEvidence.push(id);
+            if (!options.dryRun)
+                rmSync(resolve(evidenceRoot, id), { recursive: true, force: true });
+        }
+        if (removeHistory) {
+            removedRuns.push(id);
+            if (!options.dryRun)
+                rmSync(resolve(runsRoot, id), { recursive: true, force: true });
+        }
+    }
+    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 });
+    return { removedRuns, removedWorkspaces, removedEvidence, removedBuildCache };
+}
+/** Cleanup is itself a project-wide transaction, so it cannot race a run. */
+export function cleanCoverageStorage(root, options) {
+    const lock = acquireProjectLock(root, `clean-${process.pid}-${randomUUID()}`);
+    try {
+        return cleanCoverageStorageLocked(root, options, true);
+    }
+    finally {
+        lock.release();
+    }
+}
+/** Explicit history retention that deliberately preserves the shared cache. */
+export function pruneCoverageStorage(root, options) {
+    const lock = acquireProjectLock(root, `prune-${process.pid}-${randomUUID()}`);
+    try {
+        return cleanCoverageStorageLocked(root, options, false);
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,WAAW,EACX,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAwBpE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAiB;IACvC,UAAU;IACV,QAAQ;IACR,aAAa;IACb,WAAW;CACZ,CAAC,CAAC;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,MAAM;IACN,WAAW;IACX,YAAY;IACZ,cAAc;IACd,OAAO;IACP,MAAM;IACN,OAAO;IACP,OAAO;IACP,SAAS;IACT,UAAU;IACV,mBAAmB;IACnB,cAAc;CACf,CAAC,CAAC;AAEH,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAI,IAAY;IAC/B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa;IAC5C,OAAO,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,KAAa;IAC/D,OAAO,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,OAAO,CAAC,IAAI,EAAE,wCAAwC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAAY,EACZ,IAA4B;IAE5B,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;AACvC,CAAC;AAED,SAAS,oBAAoB,CAC3B,IAAY,EACZ,IAA4B;IAE5B,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,OAAO,CACZ,OAAO,CAAC,SAAS,CAAC,EAClB,GAAG,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,EAAE,CACtE,CAAC;AACJ,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAE5E,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,OAAO;SACpB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;SACvD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO;SACrB,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CACxE;SACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;SAC3C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7E,MAAM,eAAe,GAAG,OAAO;SAC5B,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CACzE;SACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/C,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACzC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,gBAAgB,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,KAAK,MAAM,IAAI,IAAI,eAAe;QAChC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO;QACL,gBAAgB;QAChB,cAAc,EAAE,OAAO,CAAC,MAAM;QAC9B,eAAe,EAAE,QAAQ,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,KAAa,EACb,KAAkC;IAElC,MAAM,QAAQ,GAAG,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IACnE,mBAAmB,CACjB,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EACtB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACzC,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,KAAa,EACb,MAA0E;IAE1E,MAAM,OAAO,GAAG,QAAQ,CAAW,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;IACnE,MAAM,IAAI,GAAa;QACrB,GAAG,OAAO;QACV,GAAG,MAAM;QACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IACF,mBAAmB,CACjB,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EACtB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACrC,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,KAAa;IAEb,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,QAAQ,CAAkB,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAClF,IACE,YAAY,EAAE,EAAE,KAAK,KAAK;QAC1B,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC,EACrD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,oBAAoB,EAAE,KAAK,CAAC,EAAE;QACjD,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE;QAC7C,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,SAAS;QACX,CAAC;QACD,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,SAAS;QACvC,yEAAyE;QACzE,uEAAuE;QACvE,qCAAqC;QACrC,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YAC9C,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE;YACrE,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,IAAI,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,qEAAqE;YACrE,wEAAwE;YACxE,kEAAkE;QACpE,CAAC;aAAM,CAAC;YACN,4DAA4D;YAC5D,uEAAuE;YACvE,6DAA6D;YAC7D,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,oBAAoB,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;gBACtD,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YACH,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;gBAC/B,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,2BAA2B,KAAK,CAAC,GAAG,yBAAyB;aACrE,CAAC,CAAC;QACL,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAOD,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,KAAa;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC;IAC9D,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,UAA8B,CAAC;QACnC,IAAI,CAAC;YACH,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;YACjH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACnC,SAAS,CAAC,UAAU,CAAC,CAAC;YACtB,SAAS,CAAC,UAAU,CAAC,CAAC;YACtB,UAAU,GAAG,SAAS,CAAC;YACvB,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO;oBACL,IAAI,QAAQ;wBAAE,OAAO;oBACrB,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM,KAAK,GAAG,QAAQ,CAAmC,QAAQ,CAAC,CAAC;oBACnE,IAAI,KAAK,EAAE,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG;wBACrD,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtC,CAAC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,KAAK,SAAS;gBAAE,SAAS,CAAC,UAAU,CAAC,CAAC;YACpD,MAAM,OAAO,GAAG,KAA8B,CAAC;YAC/C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAC3C,MAAM,KAAK,GAAG,QAAQ,CAAmC,QAAQ,CAAC,CAAC;YACnE,IAAI,KAAK,EAAE,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,CAAC,KAAK,IAAI,SAAS,2CAA2C,KAAK,CAAC,GAAG,GAAG,CAChG,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;gBACtD,IAAI,KAAK,GAAG,MAAM;oBAChB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,IAAY;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,OAAO,CACL,KAAK,KAAK,EAAE;QACZ,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CACxE,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CACf,MAAc,EACd,WAAmB,EACnB,IAAI,GAAG,KAAK,EACZ,UAAU,GAAG,MAAM,EACnB,eAAe,GAAG,WAAW,EAC7B,KAAK,GAA0B,EAAE,EACjC,oBAAoB,GAAG,eAAe;IAEtC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,IAAI,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QACtD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,WAAW,EAAE;YACpB,QAAQ,CACN,IAAI,EACJ,EAAE,EACF,KAAK,EACL,UAAU,EACV,eAAe,EACf,KAAK,EACL,oBAAoB,CACrB,CAAC;aACC,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC;gBACpC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;gBACf,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YACjC,IAAI,WAA+B,CAAC;YACpC,IAAI,CAAC;gBACH,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAC;YACtE,CAAC;YACD,IACE,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC;gBAClC,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,CAAC,EAC/D,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,8DAA8D,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,CACtG,CAAC;YACJ,CAAC;YACD,MAAM,iBAAiB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACvD,MAAM,uBAAuB,GAAG,OAAO,CACrC,eAAe,EACf,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,CACpC,CAAC;YACF,yEAAyE;YACzE,yEAAyE;YACzE,sEAAsE;YACtE,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,iBAAiB;gBACpE,CAAC,CAAC,OAAO,CACL,oBAAoB,EACpB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,CACpC;gBACH,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;oBAClB,CAAC,CAAC,QAAQ,CACN,OAAO,CAAC,EAAE,CAAC,EACX,uBAAuB,CACxB;oBACH,CAAC,CAAC,IAAI,CAAC;YACT,WAAW,CACT,YAAY,EACZ,EAAE,EACF,OAAO,CAAC,QAAQ,KAAK,OAAO;gBAC1B,CAAC,CAAC,iBAAiB;oBACjB,CAAC,CAAC,UAAU;oBACZ,CAAC,CAAC,MAAM;gBACV,CAAC,CAAC,SAAS,CACd,CAAC;QACJ,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,QAAQ;gBAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;;gBACxC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC1D,CAAC;;YAEC,MAAM,IAAI,KAAK,CACb,qDAAqD,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAClF,CAAC;IACN,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,KAAa;IAClE,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAChC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,yEAAyE;QACzE,mEAAmE;QACnE,iCAAiC;QACjC,qEAAqE;QACrE,2EAA2E;QAC3E,qEAAqE;QACrE,yEAAyE;QACzE,gBAAgB;QAChB,MAAM,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC/D,SAAS,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACtE,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChD,WAAW,CACT,MAAM,EACN,OAAO,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,EACxC,OAAO,CAAC,QAAQ,KAAK,OAAO;gBAC1B,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE;oBACnB,CAAC,CAAC,UAAU;oBACZ,CAAC,CAAC,MAAM;gBACV,CAAC,CAAC,SAAS,CACd,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAiBD,mEAAmE;AACnE,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,KAAK,GAA0B,EAAE;IAEjC,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5C,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxD,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,CAAC;QACH,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAClD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAC7D,SAAS,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACtE,WAAW,CACT,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,EAChC,OAAO,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,EACxC,OAAO,CAAC,QAAQ,KAAK,OAAO;oBAC1B,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE;wBACnB,CAAC,CAAC,UAAU;wBACZ,CAAC,CAAC,MAAM;oBACV,CAAC,CAAC,SAAS,CACd,CAAC;YACJ,CAAC;QACH,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC3C,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACvC,IACE,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC;gBACxB,IAAI,KAAK,SAAS;gBAClB,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;gBACpB,EAAE,KAAK,OAAO;gBACd,CAAC,UAAU,CAAC,IAAI,CAAC,EACjB,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,4CAA4C,SAAS,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,WAAW,EAAE;gBACpB,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;iBAC7D,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACvB,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5C,IAAI,KAAK,CAAC,QAAQ;oBAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;;oBACxC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QACD,KAAK,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,CAAC;QAE/B,0EAA0E;QAC1E,sEAAsE;QACtE,kEAAkE;QAClE,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,IAAI,gBAAgB,CAAC;QACvD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACnC,aAAa,GAAG,IAAI,CAAC;YACrB,KAAK,CAAC,kBAAkB,EAAE,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QACD,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAClC,KAAK,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,aAAa,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpE,IAAI,CAAC;gBACH,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,sEAAsE;YACxE,CAAC;QACH,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,4EAA4E;IAC5E,uEAAuE;IACvE,+BAA+B;IAC/B,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,KAAa;IACjE,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,SAAS,CAAC,CAAC;IAC1E,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,iDAAiD,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAcD,8EAA8E;AAC9E,SAAS,0BAA0B,CACjC,IAAY,EACZ,OAAuB,EACvB,gBAAyB;IAEzB,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YAC5D,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,QAAQ,CAAW,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QACpF,OAAO,OAAO,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CACH,CAAC;IACF,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC3C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;aACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAC9E,CAAC;IACF,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,QAAQ,CAAW,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC7B,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,MAAM,aAAa,GAAG,eAAe,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3D,MAAM,mBAAmB,GACvB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,IAAI,mBAAmB,EAAE,CAAC;YACxB,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/D,IAAI,gBAAgB,IAAI,CAAC,CAAC,eAAe,IAAI,aAAa,CAAC,EAAE,CAAC;YAC5D,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,MAAM;gBACjB,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,MAAM;gBACjB,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,wCAAwC,CAAC,CAAC;IAC3E,MAAM,iBAAiB,GACrB,gBAAgB,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IAClE,IAAI,iBAAiB,IAAI,CAAC,OAAO,CAAC,MAAM;QACtC,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC;AAChF,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,OAAuB;IAEvB,MAAM,IAAI,GAAG,kBAAkB,CAC7B,IAAI,EACJ,SAAS,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,EAAE,CACvC,CAAC;IACF,IAAI,CAAC;QACH,OAAO,0BAA0B,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,OAAuB;IAEvB,MAAM,IAAI,GAAG,kBAAkB,CAC7B,IAAI,EACJ,SAAS,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,EAAE,CACvC,CAAC;IACF,IAAI,CAAC;QACH,OAAO,0BAA0B,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/docs/performance.md

@@ -0,0 +1,107 @@
+# Performance and storage
+
+Supercov separates timings that it can measure safely from overhead that
+requires an explicit control run. It never runs a user's command a second time
+automatically: an arbitrary test command can write data, call paid services, or
+be intentionally non-repeatable.
+
+## Per-run measurements
+
+Every coverage run prints and stores monotonic durations for:
+
+| Phase | Includes |
+| --- | --- |
+| `initializationMs` | recovery, locking, project discovery, and integrity fingerprints |
+| `workspacePreparationMs` | transactional refresh of the isolated namespace |
+| `adapterSetupMs` | generated adapters, configs, manifests, and runtime files |
+| `instrumentedBuildMs` | the coverage-aware build/direct pass, or near-zero when an exact-fingerprint build is reused |
+| `testCommandMs` | the user's unchanged command, including any runner or remote infrastructure latency |
+| `evidencePublicationMs` | evidence collection, validation/summary analysis, lossless archive generation, and atomic run staging |
+
+The fields are stored in `.supercov/runs/<run-id>/run.json` and returned by
+`supercov runs --json`. Total duration is stored separately as `durationMs`.
+
+The non-test phases are not automatically labelled “overhead.” For example, a
+test script that ordinarily performs its own build may overlap work with the
+instrumented-build phase. True end-to-end overhead must compare equivalent
+cold runs or equivalent warm runs of the same command.
+
+## Reproducible comparison
+
+Run the command without and with Supercov under the same cache state. Use at
+least three alternating pairs and report the medians. Never compare a cold VM,
+browser, package-manager, or build-cache run with a warm one.
+
+```sh
+/usr/bin/time -p npm test
+/usr/bin/time -p npx supercov -- npm test
+```
+
+Package acquisition is a separate user-interface cost. A cold `npx` download
+depends on the registry and network; a cached `npx` resolution should be
+reported separately from Supercov's recorded phases.
+
+## Reference measurement, not a guarantee
+
+On 2026-08-24, the 29-test Essential SEO offline suite on the development Mac
+produced this warm pair:
+
+| Measurement | Duration |
+| --- | ---: |
+| unchanged command | 39.57 s |
+| Supercov total | 45.38 s |
+| end-to-end difference | +5.81 s (+14.7%) |
+| initialization | 0.06 s |
+| workspace preparation | 0.35 s |
+| adapter setup | 0.05 s |
+| instrumented build | 4.87 s |
+| test command inside Supercov | 39.60 s |
+| evidence/report preparation (historical format) | 0.40 s |
+
+The test-command durations were effectively identical in this pair. The extra
+instrumented build accounted for about 84% of the measured difference. A
+seven-sample isolated workspace refresh had a 270 ms median and 447 ms maximum.
+The built output grew from 2,781,273 to 3,094,366 logical bytes (+11.3%). A
+cached `npx supercov help` added a 686 ms median over direct CLI startup; the
+first observed `npx` resolution took 2.22 s.
+
+Cold VM-image runs were 170.34 s without Supercov and 175.44 s with Supercov in
+the same session, but a single cold pair is too noisy for a general percentage.
+Both spent approximately 124 seconds preparing their VM image.
+
+Before raw-evidence-only storage, the reference run retained 4.5 MB of reports
+and 1.7 MB across 178 loose evidence files. Its canonical compressed JSON was
+0.9 MB. The execution evidence alone packed to about 121 KiB; current archives
+also embed the exact denominator manifest and are the sole coverage artifact.
+Every CLI query derives its view from the archive on demand without writing a
+cache.
+These numbers are application- and filesystem-specific optimization baselines.
+An exact matching Vite build is also reused across runs, removing the measured
+4.87-second repeated build; any source/configuration/toolchain-key change falls
+back to a fresh isolated build.
+
+The evidence-only Essential SEO validation packed the exact manifest plus 178
+execution-evidence files (2.66 MB uncompressed) into a 248 KiB archive. With
+the 4 KiB `run.json`, the complete immutable run occupies 252 KiB and contains
+no derived report. Its identical warm 29-test run recorded 0 ms for the build
+phase and 40.49 seconds total: 0.07 seconds initialization, 0.36 seconds
+workspace refresh, 0.05 seconds adapter setup, 39.84 seconds in the unchanged
+test command, and 0.12 seconds evidence validation/archive publication. Fresh
+process queries for summary, files, and gaps each took 0.16–0.20 seconds on
+this run while writing no cache. Test execution is still the dominant and
+naturally variable part of the total.
+
+## Isolation strategy trade-offs
+
+| Strategy | Arbitrary-runner compatibility | Failure isolation | Startup/storage |
+| --- | --- | --- | --- |
+| Transactional physical namespace | Highest; ordinary filesystem consumers and opaque mounts see real files | Strong when staging, publication, recovery, locking, and same-filesystem renames are enforced | Recreates directory entries and may copy bytes when reflinks are unavailable |
+| Node loader/Vite plugins | High for observed Node and bundler graphs, incomplete for native readers and hidden remote mounts | Strong because transformed source need not be persisted | Lowest retained storage and usually fastest |
+| FUSE/OS overlay | Potentially broad local read interception, but not portable or zero-install | Adds mount, privilege, kernel/extension, and teardown failure boundaries | Low duplicated storage but operationally expensive |
+| Adaptive hybrid | Fast path where capability is proven; transactional namespace otherwise | Inherits the physical fallback's guarantees when detection is conservative | Best practical balance; more implementation paths must be tested |
+
+The safe default remains the transactional physical namespace. The intended
+optimization is an adaptive hybrid that selects a proven loader/plugin path
+and lazily materializes the same transactional fallback whenever an opaque
+runner needs real files. FUSE is not an appropriate portable default for a
+zero-install `npx` tool.