@codyswann/lisa 4.28.4 → 4.29.0

package/dist/cli/lisa-test-run-runtime.js

@@ -0,0 +1,123 @@
+/** Runtime-only companion, environment, and signal escalation primitives. */
+import { fork } from "node:child_process";
+import { env } from "node:process";
+import { fileURLToPath } from "node:url";
+import * as path from "node:path";
+import { SCRATCH_PREFIXES_ENV, SCRATCH_SUITE_ENV, } from "../configs/vitest/scratch-route-profile.js";
+import { SCRATCH_SUPERVISION_LEASE_ENV } from "../configs/vitest/scratch-supervision.js";
+import { drainTestRunTarget, } from "./lisa-test-run-process-group.js";
+/** Grace period for a payload to honor a forwarded catchable signal. */
+const FORWARDED_SIGNAL_GRACE_MS = 1_000;
+/** Private deterministic protocol-fault seam. */
+const TEST_FAULT_ENV = "LISA_TEST_RUN_TEST_FAULT";
+/** Catchable signals forwarded to the target process group. */
+export const FORWARDED_SIGNALS = [
+    "SIGINT",
+    "SIGTERM",
+    "SIGHUP",
+];
+/**
+ * Start one source-or-built sibling as a detached IPC child.
+ * @param name - Sibling module basename
+ * @returns Detached protocol companion
+ */
+export function forkDetachedSibling(name) {
+    const self = fileURLToPath(import.meta.url);
+    const modulePath = path.join(path.dirname(self), `${name}${path.extname(self)}`);
+    return fork(modulePath, [], {
+        cwd: process.cwd(),
+        detached: true,
+        execArgv: process.execArgv,
+        stdio: ["ignore", "inherit", "inherit", "ipc"],
+    });
+}
+/**
+ * Convert inherited values plus the frozen lease to the spawn contract.
+ * @param lease - Serialized exact suite lease
+ * @param profile - Frozen wrapper route profile
+ * @param directScratchRoot - Direct-adapter platform temp root, when applicable
+ * @returns String-only payload environment
+ */
+export function payloadEnvironment(lease, profile, directScratchRoot) {
+    return Object.fromEntries(Object.entries({
+        ...env,
+        [SCRATCH_SUPERVISION_LEASE_ENV]: lease,
+        [SCRATCH_SUITE_ENV]: profile.suiteLabel,
+        [SCRATCH_PREFIXES_ENV]: JSON.stringify(profile.registeredPrefixes),
+        ...(directScratchRoot === undefined
+            ? {}
+            : {
+                TMPDIR: directScratchRoot,
+                TMP: directScratchRoot,
+                TEMP: directScratchRoot,
+            }),
+    }).filter((entry) => entry[0] !== TEST_FAULT_ENV && entry[1] !== undefined));
+}
+/**
+ * Reject if the detached cleanup authority exits during the payload.
+ * @param reaper - Armed detached reaper
+ * @returns Promise that only rejects on exit
+ */
+export function rejectOnReaperExit(reaper) {
+    return new Promise((_, reject) => {
+        const onExit = () => {
+            reaper.off("exit", onExit);
+            reject(new Error("Detached reaper exited while the payload was active"));
+        };
+        reaper.once("exit", onExit);
+        if (reaper.exitCode !== null || reaper.signalCode !== null)
+            onExit();
+    });
+}
+/**
+ * Drain with deterministic birth-probe failures only in dedicated controls.
+ * @param target - Armed target authority
+ * @returns Bounded drain promise
+ */
+export function drainSupervisedTarget(target) {
+    const fault = env[TEST_FAULT_ENV];
+    if (fault === "stop-send-closed" || fault === "stop-send-rejected") {
+        return Promise.resolve();
+    }
+    if (fault === "birth-unavailable-on-drain") {
+        return drainTestRunTarget(target, {
+            probes: { processBirthFingerprint: () => undefined },
+        });
+    }
+    if (fault === "birth-mismatch-on-drain") {
+        return drainTestRunTarget(target, {
+            probes: { processBirthFingerprint: () => "mismatched-birth-control" },
+        });
+    }
+    return drainTestRunTarget(target);
+}
+/**
+ * Build one cancellable TERM-to-KILL escalation.
+ * @param target - Armed birth-bound target
+ * @returns Cancellable escalation
+ */
+export function createSignalEscalation(target) {
+    const state = { started: false };
+    const promise = new Promise((resolve, reject) => {
+        // eslint-disable-next-line functional/immutable-data -- one promise settlement handle
+        state.settle = { resolve, reject };
+    });
+    return {
+        promise,
+        begin: signal => {
+            if (state.started)
+                return;
+            // eslint-disable-next-line functional/immutable-data -- first forwarded signal wins
+            state.started = true;
+            // eslint-disable-next-line functional/immutable-data -- cancellable bounded timer
+            state.timer = setTimeout(() => {
+                void drainSupervisedTarget(target).then(() => state.settle?.resolve({ code: null, signal }), error => state.settle?.reject(error));
+            }, FORWARDED_SIGNAL_GRACE_MS);
+        },
+        cancel: () => {
+            if (state.timer !== undefined)
+                clearTimeout(state.timer);
+        },
+    };
+}
+//# sourceMappingURL=lisa-test-run-runtime.js.map

package/dist/cli/lisa-test-run-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-test-run-runtime.js","sourceRoot":"","sources":["../../src/cli/lisa-test-run-runtime.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EAAE,IAAI,EAAqB,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AAEzF,OAAO,EACL,kBAAkB,GAEnB,MAAM,kCAAkC,CAAC;AAE1C,wEAAwE;AACxE,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAExC,iDAAiD;AACjD,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAElD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAA8B;IAC1D,QAAQ;IACR,SAAS;IACT,QAAQ;CACT,CAAC;AASF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAClB,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAC/B,CAAC;IACF,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,OAA4B,EAC5B,iBAA0B;IAE1B,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC;QACb,GAAG,GAAG;QACN,CAAC,6BAA6B,CAAC,EAAE,KAAK;QACtC,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC,UAAU;QACvC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC;QAClE,GAAG,CAAC,iBAAiB,KAAK,SAAS;YACjC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,MAAM,EAAE,iBAAiB;gBACzB,GAAG,EAAE,iBAAiB;gBACtB,IAAI,EAAE,iBAAiB;aACxB,CAAC;KACP,CAAC,CAAC,MAAM,CACP,CAAC,KAAK,EAA6B,EAAE,CACnC,KAAK,CAAC,CAAC,CAAC,KAAK,cAAc,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CACxD,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC,CAAC;QAC3E,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;YAAE,MAAM,EAAE,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAuC;IAEvC,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,kBAAkB,IAAI,KAAK,KAAK,oBAAoB,EAAE,CAAC;QACnE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,KAAK,KAAK,4BAA4B,EAAE,CAAC;QAC3C,OAAO,kBAAkB,CAAC,MAAM,EAAE;YAChC,MAAM,EAAE,EAAE,uBAAuB,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE;SACrD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,KAAK,yBAAyB,EAAE,CAAC;QACxC,OAAO,kBAAkB,CAAC,MAAM,EAAE;YAChC,MAAM,EAAE,EAAE,uBAAuB,EAAE,GAAG,EAAE,CAAC,0BAA0B,EAAE;SACtE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA2B;IAE3B,MAAM,KAAK,GAOP,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9D,sFAAsF;QACtF,KAAK,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,OAAO;QACL,OAAO;QACP,KAAK,EAAE,MAAM,CAAC,EAAE;YACd,IAAI,KAAK,CAAC,OAAO;gBAAE,OAAO;YAC1B,oFAAoF;YACpF,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,kFAAkF;YAClF,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,KAAK,qBAAqB,CAAC,MAAM,CAAC,CAAC,IAAI,CACrC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EACnD,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CACrC,CAAC;YACJ,CAAC,EAAE,yBAAyB,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,EAAE,GAAG,EAAE;YACX,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/lisa-test-run-supervisor.d.ts

@@ -0,0 +1,13 @@
+import type { ScratchRouteProfile } from "../configs/vitest/scratch-route-profile.js";
+import { type PayloadOutcome } from "./lisa-test-run-ipc.js";
+/** Explicit scratch delivery selected by each generated route. */
+export type TestRunAdapter = "vitest" | "direct";
+/**
+ * Arm and execute one supervised command.
+ * @param argv - Exact payload argv
+ * @param profile - Frozen wrapper route profile
+ * @param adapter - Explicit payload delivery adapter
+ * @returns Payload outcome after proven cleanup
+ */
+export declare function superviseTestRun(argv: readonly [string, ...string[]], profile: ScratchRouteProfile, adapter: TestRunAdapter): Promise<PayloadOutcome>;
+//# sourceMappingURL=lisa-test-run-supervisor.d.ts.map

package/dist/cli/lisa-test-run-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-test-run-supervisor.d.ts","sourceRoot":"","sources":["../../src/cli/lisa-test-run-supervisor.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAKtF,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAgBhC,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAmSjD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACpC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,CAsBzB"}

package/dist/cli/lisa-test-run-supervisor.js

@@ -0,0 +1,268 @@
+import { env } from "node:process";
+import { openOwnedScratchRunRoot, prepareOwnedScratchRunRoot, removeOwnedScratchRunRoot, } from "../configs/vitest/scratch.js";
+import { readBoundedScratchNames, removeAuthorizedScratchChildren, } from "../configs/vitest/scratch-authority.js";
+import { SCRATCH_OWNER_FILE } from "../configs/vitest/scratch-owner.js";
+import { processBirthFingerprint } from "../configs/vitest/scratch-owner.js";
+import { SCRATCH_SUPERVISION_LEASE_ENV, createScratchSupervisionLease, } from "../configs/vitest/scratch-supervision.js";
+import { sendMessage, stopBootstrap, waitForExit, waitForMessage, waitForPayload, } from "./lisa-test-run-ipc.js";
+import { assertTestRunPlatform } from "./lisa-test-run-process-group.js";
+import { FORWARDED_SIGNALS, createSignalEscalation, drainSupervisedTarget, forkDetachedSibling, payloadEnvironment, rejectOnReaperExit, } from "./lisa-test-run-runtime.js";
+/** Private deterministic protocol-fault seam, never inherited by the payload. */
+const TEST_FAULT_ENV = "LISA_TEST_RUN_TEST_FAULT";
+/**
+ * Prepare the immutable root intent before starting protocol companions.
+ * @param profile - Frozen wrapper route profile
+ * @returns Immutable root intent
+ */
+function prepareIntent(profile) {
+    return prepareOwnedScratchRunRoot(env[TEST_FAULT_ENV] === "birth-unavailable-on-prepare"
+        ? {
+            platform: process.platform,
+            processBirthFingerprint: () => undefined,
+            suiteLabel: profile.suiteLabel,
+            registeredPrefixes: profile.registeredPrefixes,
+        }
+        : {
+            suiteLabel: profile.suiteLabel,
+            registeredPrefixes: profile.registeredPrefixes,
+        });
+}
+/**
+ * Arm both companions and materialize only after root/target acknowledgements.
+ * @param state - One foreground supervision state
+ */
+async function armAuthorities(state) {
+    await waitForMessage(state.reaper, "REAPER_READY");
+    const bootstrap = forkDetachedSibling("lisa-test-run-bootstrap");
+    // eslint-disable-next-line functional/immutable-data -- companion handle captured once
+    state.bootstrap = bootstrap;
+    await waitForMessage(bootstrap, "BOOTSTRAP_READY");
+    const birth = processBirthFingerprint(bootstrap.pid ?? 0);
+    if (bootstrap.pid === undefined || birth === undefined) {
+        throw new Error("Could not bind bootstrap process birth");
+    }
+    const target = {
+        pid: bootstrap.pid,
+        pgid: bootstrap.pid,
+        processBirthFingerprint: birth,
+    };
+    // eslint-disable-next-line functional/immutable-data -- target authority captured once
+    state.target = target;
+    const rootAck = waitForMessage(state.reaper, "ROOT_INTENT_ARMED", state.intent.token);
+    await sendMessage(state.reaper, {
+        type: "ROOT_INTENT",
+        correlation: state.intent.token,
+        intent: state.intent,
+    });
+    await rootAck;
+    const targetAck = waitForMessage(state.reaper, "TARGET_ARMED", state.intent.token);
+    await sendMessage(state.reaper, {
+        type: "TARGET_INTENT",
+        correlation: state.intent.token,
+        target,
+    });
+    await targetAck;
+    const rootArmed = waitForMessage(state.reaper, "ROOT_ARMED", state.intent.token);
+    await sendMessage(state.reaper, {
+        type: "MATERIALIZE_ROOT",
+        correlation: state.intent.token,
+    });
+    const acknowledgement = await rootArmed;
+    const opened = openOwnedScratchRunRoot(state.intent);
+    const acknowledgedRoot = acknowledgement["root"];
+    if (opened === undefined ||
+        acknowledgedRoot?.canonicalPath !== opened.owner.root.canonicalPath ||
+        acknowledgedRoot.dev !== opened.owner.root.dev ||
+        acknowledgedRoot.ino !== opened.owner.root.ino) {
+        throw new Error("Detached reaper acknowledged a different scratch root identity");
+    }
+    // eslint-disable-next-line functional/immutable-data -- exact materialization acknowledgement transition
+    state.rootMaterialized = true;
+    if (env[TEST_FAULT_ENV] === "kill-reaper-after-root") {
+        state.reaper.kill("SIGKILL");
+        await waitForExit(state.reaper);
+        throw new Error("Detached reaper exited after root materialization");
+    }
+}
+/**
+ * Send one immutable command after root and target authority are armed.
+ * @param state - One foreground supervision state
+ * @param argv - Exact payload argv
+ * @param profile - Frozen wrapper route profile
+ * @param adapter - Explicit payload delivery adapter
+ */
+async function configurePayload(state, argv, profile, adapter) {
+    if (state.bootstrap === undefined)
+        throw new Error("Bootstrap is not armed");
+    const lease = createScratchSupervisionLease(state.intent, {
+        suiteLabel: state.intent.suiteLabel,
+        registeredPrefixes: state.intent.registeredPrefixes,
+    });
+    const command = {
+        schema: 1,
+        argv,
+        env: payloadEnvironment(JSON.stringify(lease), profile, adapter === "direct" ? state.intent.rootPath : undefined),
+    };
+    if (adapter === "direct") {
+        // eslint-disable-next-line functional/immutable-data -- immutable invocation snapshot captured once
+        state.directBaseline = new Set(readBoundedScratchNames(state.intent.rootPath));
+    }
+    const commandReady = waitForMessage(state.bootstrap, "COMMAND_READY");
+    await sendMessage(state.bootstrap, { type: "COMMAND", command });
+    await commandReady;
+}
+/**
+ * Attribute and remove direct-adapter scratch additions after the payload drains.
+ * @param state - One foreground supervision state
+ */
+function auditDirectScratch(state) {
+    if (state.directBaseline === undefined)
+        return;
+    const opened = openOwnedScratchRunRoot(state.intent);
+    if (opened === undefined) {
+        throw new Error("Direct scratch root disappeared before invocation audit");
+    }
+    const additions = readBoundedScratchNames(opened.path).filter(name => name !== SCRATCH_OWNER_FILE && !state.directBaseline?.has(name));
+    const unregistered = additions.filter(name => !opened.owner.registeredPrefixes.some(prefix => name.startsWith(prefix)));
+    removeAuthorizedScratchChildren({
+        parent: opened.owner.root,
+        basenames: additions,
+    });
+    if (unregistered.length > 0) {
+        const names = [...unregistered].sort((left, right) => left === right ? 0 : left < right ? -1 : 1);
+        throw new Error(`Suite ${opened.owner.suiteLabel} leaked ${String(names.length)} unregistered direct scratch fixture(s): ${names.join(", ")}`);
+    }
+}
+/**
+ * Report a cleanup verdict without replacing an already-failing payload.
+ * @param error - Secondary direct-audit failure
+ */
+function reportPreservedAuditFailure(error) {
+    process.stderr.write(`lisa-test-run direct scratch audit also failed: ${error instanceof Error ? error.message : String(error)}\n`);
+}
+/**
+ * Execute the armed payload while retaining the first forwarded signal.
+ * @param state - One foreground supervision state
+ * @returns Exact payload outcome
+ */
+async function executePayload(state) {
+    const bootstrap = state.bootstrap;
+    const target = state.target;
+    if (bootstrap === undefined || target === undefined) {
+        throw new Error("Payload authority is not fully armed");
+    }
+    const escalation = createSignalEscalation(target);
+    // eslint-disable-next-line functional/immutable-data -- cancellable handle scoped to this run
+    state.signalEscalation = escalation;
+    for (const signal of FORWARDED_SIGNALS) {
+        // Persistent, not `once`. A one-shot listener is removed the first time it
+        // fires, and Node restores that signal's DEFAULT disposition the moment its
+        // last listener goes. A second delivery of the same signal during the grace
+        // window then kills this process outright — skipping the scratch removal
+        // this supervisor exists to guarantee. Ctrl-C pressed twice, or a scheduler
+        // that re-sends SIGTERM, is the ordinary case. The `finally` in
+        // superviseTestRun removes every one of these before the outcome is
+        // re-raised, so staying armed costs nothing.
+        process.on(signal, () => {
+            if (state.forwardedSignal !== undefined)
+                return;
+            // eslint-disable-next-line functional/immutable-data -- first observed terminal signal is preserved
+            state.forwardedSignal = signal;
+            void sendMessage(bootstrap, { type: "SIGNAL", signal }).catch(() => undefined);
+            escalation.begin(signal);
+        });
+    }
+    const outcomePromise = waitForPayload(bootstrap, () => state.forwardedSignal !== undefined);
+    await sendMessage(bootstrap, { type: "GO" });
+    if (env[TEST_FAULT_ENV] === "kill-reaper-after-go") {
+        state.reaper.kill("SIGKILL");
+    }
+    return await Promise.race([
+        outcomePromise,
+        rejectOnReaperExit(state.reaper),
+        escalation.promise,
+    ]);
+}
+/**
+ * Drain, clean, and disarm after one payload result.
+ * @param state - One foreground supervision state
+ * @param outcome - Exact payload outcome
+ * @returns Outcome after cleanup and disarm
+ */
+async function finishSuccess(state, outcome) {
+    state.signalEscalation?.cancel();
+    await drainSupervisedTarget(state.target);
+    if (state.bootstrap !== undefined)
+        await stopBootstrap(state.bootstrap);
+    try {
+        auditDirectScratch(state);
+    }
+    catch (error) {
+        if (outcome.code === 0 && outcome.signal === null)
+            throw error;
+        reportPreservedAuditFailure(error);
+    }
+    removeOwnedScratchRunRoot(state.intent);
+    // eslint-disable-next-line code-organization/enforce-statement-order -- disarm is meaningful only after foreground removal
+    const disarmedAck = waitForMessage(state.reaper, "DISARMED");
+    await sendMessage(state.reaper, { type: "CLEANED" });
+    await disarmedAck;
+    await waitForExit(state.reaper);
+    // eslint-disable-next-line functional/immutable-data -- terminal verified state
+    state.disarmed = true;
+    return state.forwardedSignal === undefined
+        ? outcome
+        : { code: null, signal: state.forwardedSignal };
+}
+/**
+ * Best-effort foreground cleanup that never hides a drain authority failure.
+ * @param state - One foreground supervision state
+ */
+async function cleanupFailure(state) {
+    await drainSupervisedTarget(state.target);
+    if (state.bootstrap !== undefined) {
+        try {
+            await stopBootstrap(state.bootstrap);
+        }
+        catch {
+            state.bootstrap.kill("SIGKILL");
+        }
+    }
+    if (state.rootMaterialized)
+        removeOwnedScratchRunRoot(state.intent);
+}
+/**
+ * Arm and execute one supervised command.
+ * @param argv - Exact payload argv
+ * @param profile - Frozen wrapper route profile
+ * @param adapter - Explicit payload delivery adapter
+ * @returns Payload outcome after proven cleanup
+ */
+export async function superviseTestRun(argv, profile, adapter) {
+    assertTestRunPlatform();
+    delete env[SCRATCH_SUPERVISION_LEASE_ENV];
+    // eslint-disable-next-line code-organization/enforce-statement-order -- inherited authority must be cleared before intent preparation
+    const state = {
+        intent: prepareIntent(profile),
+        reaper: forkDetachedSibling("lisa-test-run-reaper"),
+        rootMaterialized: false,
+        disarmed: false,
+    };
+    try {
+        await armAuthorities(state);
+        await configurePayload(state, argv, profile, adapter);
+        return await finishSuccess(state, await executePayload(state));
+    }
+    catch (error) {
+        await cleanupFailure(state);
+        throw error;
+    }
+    finally {
+        for (const signal of FORWARDED_SIGNALS)
+            process.removeAllListeners(signal);
+        state.signalEscalation?.cancel();
+        if (!state.disarmed && state.reaper.connected)
+            state.reaper.disconnect();
+    }
+}
+//# sourceMappingURL=lisa-test-run-supervisor.js.map

package/dist/cli/lisa-test-run-supervisor.js.map

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

package/dist/cli/lisa-test-run.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export { assertTestRunPlatform } from "./lisa-test-run-process-group.js";
+//# sourceMappingURL=lisa-test-run.d.ts.map

package/dist/cli/lisa-test-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-test-run.d.ts","sourceRoot":"","sources":["../../src/cli/lisa-test-run.ts"],"names":[],"mappings":";AAcA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/cli/lisa-test-run.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/** Public entrypoint for birth-bound test supervision and scratch cleanup. */
+// @ts-expect-error -- the shipped JavaScript helper carries the same checked JSDoc signature
+import { invokedAsScript } from "../../scripts/lib/invoked-as-script.mjs";
+import { resolveScratchRouteProfile, } from "../configs/vitest/scratch-route-profile.js";
+import { superviseTestRun, } from "./lisa-test-run-supervisor.js";
+export { assertTestRunPlatform } from "./lisa-test-run-process-group.js";
+/** Dedicated operational-failure exit status. */
+const OPERATIONAL_FAILURE_EXIT = 1;
+/**
+ * Parse the exact public `--profile <route> --adapter <kind> -- <command>` syntax.
+ * @param argv - Public CLI arguments
+ * @returns Validated route profile and payload argv
+ */
+function commandArgv(argv) {
+    if (argv[0] !== "--profile" ||
+        argv[1] === undefined ||
+        argv[2] !== "--adapter" ||
+        (argv[3] !== "vitest" && argv[3] !== "direct") ||
+        argv[4] !== "--" ||
+        argv.length < 6 ||
+        argv[5] === undefined) {
+        throw new Error("Usage: lisa-test-run --profile <route> --adapter vitest|direct -- <executable> [args...]");
+    }
+    return {
+        profile: resolveScratchRouteProfile(argv[1]),
+        adapter: argv[3],
+        argv: argv.slice(5),
+    };
+}
+/**
+ * Parse public input or emit the usage verdict without starting companions.
+ * @returns Validated invocation or undefined after a usage verdict
+ */
+function invocationOrExit() {
+    try {
+        return commandArgv(process.argv.slice(2));
+    }
+    catch (error) {
+        process.stderr.write(`${error.message}\n`);
+        process.exitCode = 2;
+        return undefined;
+    }
+}
+/** Run the public CLI and preserve the child result only after cleanup. */
+async function main() {
+    const invocation = invocationOrExit();
+    if (invocation === undefined)
+        return;
+    try {
+        const outcome = await superviseTestRun(invocation.argv, invocation.profile, invocation.adapter);
+        if (outcome.signal !== null) {
+            process.removeAllListeners(outcome.signal);
+            process.kill(process.pid, outcome.signal);
+            return;
+        }
+        process.exit(outcome.code ?? OPERATIONAL_FAILURE_EXIT);
+    }
+    catch (error) {
+        process.stderr.write(`lisa-test-run failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exit(OPERATIONAL_FAILURE_EXIT);
+    }
+}
+if (invokedAsScript(import.meta.url))
+    void main();
+//# sourceMappingURL=lisa-test-run.js.map

package/dist/cli/lisa-test-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-test-run.js","sourceRoot":"","sources":["../../src/cli/lisa-test-run.ts"],"names":[],"mappings":";AACA,8EAA8E;AAC9E,6FAA6F;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1E,OAAO,EACL,0BAA0B,GAE3B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,gBAAgB,GAEjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,iDAAiD;AACjD,MAAM,wBAAwB,GAAG,CAAC,CAAC;AASnC;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAuB;IAC1C,IACE,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW;QACvB,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;QACrB,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW;QACvB,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;QAC9C,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;QAChB,IAAI,CAAC,MAAM,GAAG,CAAC;QACf,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EACrB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAChB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAA0B;KAC7C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAI,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC;QACtD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO;IACrC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,gBAAgB,CACpC,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,OAAO,EAClB,UAAU,CAAC,OAAO,CACnB,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC5B,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,wBAAwB,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CACpF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,IAAI,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IAAE,KAAK,IAAI,EAAE,CAAC"}

package/dist/cli/shared-options.d.ts

@@ -12,11 +12,18 @@ export interface CLIOptions {
     validate?: boolean;
     skipGitCheck?: boolean;
     /**
-     * Run the FULL apply even with `--skip-git-check`.
+     * Declare this apply a package-manager install lifecycle.
      *
-     * The escape hatch from the conflation in CodySwannGT/lisa#3066: waiving the
-     * dirty-tree check otherwise selects the reduced `postinstall-safe` subset as
-     * a side effect, with no way to decline.
+     * The only thing that selects the reduced `postinstall-safe` subset. Every
+     * Lisa-written postinstall invocation carries it, in this spelling or as
+     * `LISA_POSTINSTALL=1` (CodySwannGT/lisa#3066).
+     */
+    postinstallSafe?: boolean;
+    /**
+     * Run the FULL apply even inside a declared postinstall.
+     *
+     * The override of last resort, for an operator forcing the complete apply
+     * from inside a lifecycle script.
      */
     fullApply?: boolean;
     /** Bare `--refresh-templates` yields true; with a value, the raw path list. */

package/dist/cli/shared-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-options.d.ts","sourceRoot":"","sources":["../../src/cli/shared-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAwB,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAClC,gBAAgB,GAAG,SAAS,CAW9B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAStD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAoC1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,GACpB,gBAAgB,CAYlB"}
+{"version":3,"file":"shared-options.d.ts","sourceRoot":"","sources":["../../src/cli/shared-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAwB,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAClC,gBAAgB,GAAG,SAAS,CAW9B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAStD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAuC1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,GACpB,gBAAgB,CAYlB"}

package/dist/cli/shared-options.js

@@ -52,14 +52,14 @@ export function addSharedOptions(command) {
         .option("-n, --dry-run", "Show what would be done without making changes")
         .option("-y, --yes", "Non-interactive mode (auto-accept defaults, overwrite on conflict)")
         .option("-v, --validate", "Validate project compatibility without applying changes")
-        .option("--skip-git-check", "Skip dirty git working directory check (for postinstall use). " +
-        "NOTE: on its own this also selects the reduced postinstall-safe apply, " +
-        "which skips every agent emit and the Sonar integration. Add --full-apply " +
-        "to waive the check without reducing the apply.")
-        .option("--full-apply", "Run the FULL apply even with --skip-git-check. Without this, waiving the " +
-        "dirty-tree check also selects the reduced postinstall-safe subset, so an " +
-        "automated caller that only needed a dirty tree silently gets no agent " +
-        "emits (CodySwannGT/lisa#3066).")
+        .option("--skip-git-check", "Skip the dirty git working directory check. Means only that: the apply " +
+        "still runs in full, including every agent emit (CodySwannGT/lisa#3066).")
+        .option("--postinstall-safe", "Declare this apply a package-manager install lifecycle, which runs the " +
+        "reduced postinstall-safe subset: no agent emit (Codex, Claude, agy, " +
+        "Copilot, OpenCode) and no Sonar integration, so an install never " +
+        "regenerates committed agent trees. Equivalent to LISA_POSTINSTALL=1.")
+        .option("--full-apply", "Run the FULL apply even inside a declared postinstall. Overrides " +
+        "--postinstall-safe and LISA_POSTINSTALL=1.")
         .option("--refresh-templates [paths]", "Let a non-interactive apply replace managed files it would otherwise report as out of date. " +
         "Optionally scope to a comma-separated list of repo-relative paths " +
         "(e.g. --refresh-templates=scripts/lisa-hooks). Backs up before replacing.")

package/dist/cli/shared-options.js.map

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

package/dist/configs/vitest/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/configs/vitest/base.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,8DAA8D;AAC9D,KAAK,UAAU,GAAG,cAAc,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAO/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAatD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAGlD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAItD;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAErD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GACxB,YAAY,kBAAkB,KAC7B,gBAaD,CAAC;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,kBAAkB,EAC5B,WAAW,kBAAkB,KAC5B,kBAiBF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,SAAS,UAAU,EAAE,KAAG,UA4C7D,CAAC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/configs/vitest/base.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,8DAA8D;AAC9D,KAAK,UAAU,GAAG,cAAc,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAO/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAatD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAGlD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAItD;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAKrD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GACxB,YAAY,kBAAkB,KAC7B,gBAaD,CAAC;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,kBAAkB,EAC5B,WAAW,kBAAkB,KAC5B,kBAiBF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,SAAS,UAAU,EAAE,KAAG,UA4C7D,CAAC"}

package/dist/configs/vitest/base.js

@@ -5,7 +5,7 @@
  * project-specific vitest.config.ts files. Reduces duplication between
  * typescript, nestjs, and other project type configurations.
  *
- * Published as part of the @codyswann/lisa npm package so downstream
+ * Published as part of the `@codyswann/lisa` npm package so downstream
  * projects can import these utilities directly from the package.
  * @see https://vitest.dev/config/
  * @module configs/vitest/base
@@ -112,7 +112,10 @@ const resolveScratchModule = (basename) => {
  * @see {@link module:configs/vitest/scratch} for the measurements behind this
  */
 export function scratchSetupFiles() {
-    return [resolveScratchModule("scratch-setup")];
+    return [
+        resolveScratchModule("scratch-setup"),
+        resolveScratchModule("scratch-leak-setup"),
+    ];
 }
 /**
  * Global setup that reclaims residue before a run and audits the namespace after it.