@codyswann/lisa 4.28.4 → 4.29.0

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

@@ -0,0 +1,200 @@
+import { once } from "node:events";
+import { env } from "node:process";
+import { parseScratchProtocolMessage, } from "../configs/vitest/scratch-supervision.js";
+/** Protocol timeout for one inert local acknowledgement. */
+const ACK_TIMEOUT_MS = 10_000;
+/** Private deterministic protocol-fault seam. */
+const TEST_FAULT_ENV = "LISA_TEST_RUN_TEST_FAULT";
+/**
+ * Whether one companion has already reached a terminal child-process state.
+ * @param child - Protocol companion
+ * @returns Whether Node has recorded an exit code or terminal signal
+ */
+function companionExited(child) {
+    return child.exitCode !== null || child.signalCode !== null;
+}
+/**
+ * Arm one listener-first, cancellable, bounded companion-exit wait.
+ * @param child - Protocol companion
+ * @returns Exit promise and listener/timer cancellation
+ */
+function boundedExitWait(child) {
+    const controller = new AbortController();
+    const exitEvent = once(child, "exit", { signal: controller.signal }).then(() => undefined);
+    const observedExit = companionExited(child) ? Promise.resolve() : exitEvent;
+    const timeout = new Promise((_resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error("Timed out waiting for bootstrap shutdown")), ACK_TIMEOUT_MS);
+        controller.signal.addEventListener("abort", () => clearTimeout(timer), {
+            once: true,
+        });
+    });
+    return {
+        promise: Promise.race([observedExit, timeout]).finally(() => controller.abort()),
+        cancel: () => controller.abort(),
+    };
+}
+/** Deterministic test-only representation of a closed IPC transport. */
+class ClosedIpcChannelError extends Error {
+    code = "ERR_IPC_CHANNEL_CLOSED";
+}
+/**
+ * Wait for one exact child acknowledgement or fail closed.
+ * @param child - Protocol companion
+ * @param expected - Exact expected type
+ * @param correlation - Optional exact root token
+ * @returns Promise settled by the exact validated acknowledgement
+ */
+export function waitForMessage(child, expected, correlation) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            cleanup();
+            reject(new Error(`Timed out waiting for ${expected}`));
+        }, ACK_TIMEOUT_MS);
+        const onMessage = (message) => {
+            try {
+                const value = parseScratchProtocolMessage(message);
+                if (value.type !== expected ||
+                    (correlation !== undefined && value["correlation"] !== correlation) ||
+                    (correlation === undefined && Object.hasOwn(value, "correlation"))) {
+                    throw new Error(`Unexpected ${value.type} while waiting for ${expected}`);
+                }
+                cleanup();
+                resolve(value);
+            }
+            catch (error) {
+                cleanup();
+                reject(error);
+            }
+        };
+        const onExit = () => {
+            cleanup();
+            reject(new Error(`Protocol process exited before ${expected}`));
+        };
+        const cleanup = () => {
+            clearTimeout(timer);
+            child.off("message", onMessage);
+            child.off("exit", onExit);
+        };
+        child.on("message", onMessage);
+        child.once("exit", onExit);
+        if (companionExited(child))
+            onExit();
+    });
+}
+/**
+ * Wait until a protocol companion is absent from the process table.
+ * @param child - Protocol companion
+ * @returns Promise settled after exit
+ */
+export function waitForExit(child) {
+    if (child.exitCode !== null || child.signalCode !== null) {
+        return Promise.resolve();
+    }
+    return new Promise(resolve => child.once("exit", () => resolve()));
+}
+/**
+ * Send one versioned message or reject a closed IPC channel.
+ * @param child - Protocol companion
+ * @param message - Exact message body without schema
+ * @returns Callback-settled send promise
+ */
+export function sendMessage(child, message) {
+    if (env[TEST_FAULT_ENV] === "signal-send-rejected" &&
+        message["type"] === "SIGNAL") {
+        return Promise.reject(new Error("deterministic signal-send rejection"));
+    }
+    if (env[TEST_FAULT_ENV] === "stop-send-rejected" &&
+        message["type"] === "STOP") {
+        return Promise.reject(new Error("deterministic STOP send rejection"));
+    }
+    if (env[TEST_FAULT_ENV] === "stop-send-closed" &&
+        message["type"] === "STOP") {
+        return new Promise((_resolve, reject) => {
+            child.send({ schema: 1, ...message }, () => {
+                reject(new ClosedIpcChannelError("deterministic closed STOP channel"));
+            });
+        });
+    }
+    return new Promise((resolve, reject) => {
+        child.send({ schema: 1, ...message }, error => {
+            if (error === null)
+                resolve();
+            else
+                reject(error);
+        });
+    });
+}
+/**
+ * Whether an IPC send failure proves the channel is already unusable.
+ * @param error - IPC callback or synchronous error
+ * @returns Whether the channel is conclusively closed
+ */
+function isClosedIpcError(error) {
+    const code = error.code;
+    return code === "ERR_IPC_CHANNEL_CLOSED" || code === "ERR_IPC_DISCONNECTED";
+}
+/**
+ * Wait for the payload result and reject every other message.
+ * @param bootstrap - Inert bootstrap leader
+ * @param signalEscalating - Whether parent signal escalation owns its exit
+ * @returns Exact payload result
+ */
+export function waitForPayload(bootstrap, signalEscalating = () => false) {
+    return new Promise((resolve, reject) => {
+        const onMessage = (message) => {
+            try {
+                const value = parseScratchProtocolMessage(message);
+                if (value.type === "PAYLOAD_ERROR") {
+                    throw new Error(value["message"]);
+                }
+                if (value.type !== "PAYLOAD_EXIT") {
+                    throw new Error(`Unexpected ${value.type} during payload execution`);
+                }
+                cleanup();
+                resolve({
+                    code: value["code"],
+                    signal: value["signal"],
+                });
+            }
+            catch (error) {
+                cleanup();
+                reject(error);
+            }
+        };
+        const onExit = () => {
+            cleanup();
+            if (signalEscalating())
+                return;
+            reject(new Error("Bootstrap exited before reporting payload result"));
+        };
+        const cleanup = () => {
+            bootstrap.off("message", onMessage);
+            bootstrap.off("exit", onExit);
+        };
+        bootstrap.on("message", onMessage);
+        bootstrap.once("exit", onExit);
+        if (companionExited(bootstrap))
+            onExit();
+    });
+}
+/**
+ * Stop the inert leader and wait for it to leave the target group.
+ * @param bootstrap - Inert bootstrap leader
+ */
+export async function stopBootstrap(bootstrap) {
+    if (companionExited(bootstrap))
+        return;
+    const exitWait = boundedExitWait(bootstrap);
+    try {
+        await sendMessage(bootstrap, { type: "STOP" });
+    }
+    catch (error) {
+        if (!companionExited(bootstrap) && !isClosedIpcError(error)) {
+            exitWait.cancel();
+            await exitWait.promise.catch(() => undefined);
+            throw error;
+        }
+    }
+    await exitWait.promise;
+}
+//# sourceMappingURL=lisa-test-run-ipc.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * Reject unsupported platforms before any scratch root or companion exists.
+ * @param platform - Runtime platform
+ */
+export declare function assertTestRunPlatform(platform?: NodeJS.Platform): void;
+/** Armed bootstrap leader and process-group identity. */
+export interface TestRunTargetIntent {
+    readonly pid: number;
+    readonly pgid: number;
+    readonly processBirthFingerprint: string;
+}
+/** Injectable probes used to deterministically prove fail-closed authority. */
+export interface TestRunProcessGroupProbes {
+    readonly isProcessAlive: (pid: number) => boolean;
+    readonly processBirthFingerprint: (pid: number) => string | undefined;
+    readonly processGroupAlive: (pgid: number) => boolean;
+    readonly signalGroup: (pgid: number, signal: NodeJS.Signals) => void;
+    readonly delay: (milliseconds: number) => Promise<void>;
+}
+/** Optional probe overrides for one drain attempt. */
+export interface DrainTestRunTargetOptions {
+    readonly probes?: Partial<TestRunProcessGroupProbes>;
+}
+/**
+ * Drain only the group whose leader still has its armed process birth.
+ * @param target - Armed leader and group identity
+ * @param options - Optional deterministic probe overrides
+ */
+export declare function drainTestRunTarget(target: TestRunTargetIntent | undefined, options?: DrainTestRunTargetOptions): Promise<void>;
+//# sourceMappingURL=lisa-test-run-process-group.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-test-run-process-group.d.ts","sourceRoot":"","sources":["../../src/cli/lisa-test-run-process-group.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,IAAI,CAMN;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C;AAED,+EAA+E;AAC/E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAClD,QAAQ,CAAC,uBAAuB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,sDAAsD;AACtD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACtD;AAqFD;;;;GAIG;AAEH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,IAAI,CAAC,CAkCf"}

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

@@ -0,0 +1,123 @@
+/** Birth-bound process-group draining shared by the supervisor and reaper. */
+import { isProcessAlive } from "../configs/vitest/scratch.js";
+import { processBirthFingerprint } from "../configs/vitest/scratch-owner.js";
+/**
+ * Reject unsupported platforms before any scratch root or companion exists.
+ * @param platform - Runtime platform
+ */
+export function assertTestRunPlatform(platform = process.platform) {
+    if (platform !== "darwin" && platform !== "linux") {
+        throw new Error(`lisa-test-run requires Darwin or Linux process-group authority; received ${platform}`);
+    }
+}
+/** Time allowed for each process-group drain phase. */
+const DRAIN_GRACE_MS = 2_000;
+/** Poll interval for bounded group drain. */
+const DRAIN_POLL_MS = 25;
+/** Attempts allowed when a live process has no readable birth fingerprint. */
+const BIRTH_PROBE_ATTEMPTS = 4;
+/**
+ * Whether any member still occupies a process group.
+ * @param pgid - Armed process-group identifier
+ * @returns Whether the group still resolves
+ */
+function processGroupAlive(pgid) {
+    try {
+        process.kill(-pgid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+/**
+ * Signal a group without turning an already-absent group into a failure.
+ * @param pgid - Armed process-group identifier
+ * @param signal - Signal to deliver
+ */
+function signalGroup(pgid, signal) {
+    try {
+        process.kill(-pgid, signal);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code !== "ESRCH" && code !== "EPERM")
+            throw error;
+    }
+}
+/**
+ * Wait without leaving a permanent timer handle.
+ * @param milliseconds - Bounded poll delay
+ * @returns Promise settled after the delay
+ */
+const delay = async (milliseconds) => await new Promise(resolve => setTimeout(resolve, milliseconds));
+/** Real operating-system probes used outside deterministic unit controls. */
+const DEFAULT_PROBES = {
+    isProcessAlive,
+    processBirthFingerprint,
+    processGroupAlive,
+    signalGroup,
+    delay,
+};
+/**
+ * Establish that a live leader is still the exact process originally armed.
+ * @param target - Armed leader identity
+ * @param probes - Operating-system probes
+ * @param attempt - Current bounded unavailable-probe attempt
+ * @returns Whether the armed leader remains present with birth authority
+ */
+async function assertTargetBirthAuthority(target, probes, attempt = 0) {
+    if (!probes.isProcessAlive(target.pid))
+        return false;
+    const observed = probes.processBirthFingerprint(target.pid);
+    if (observed === target.processBirthFingerprint)
+        return true;
+    if (observed !== undefined) {
+        throw new Error("target leader process-birth fingerprint changed; refusing group signal");
+    }
+    if (attempt + 1 < BIRTH_PROBE_ATTEMPTS) {
+        await probes.delay(DRAIN_POLL_MS);
+        return await assertTargetBirthAuthority(target, probes, attempt + 1);
+    }
+    throw new Error("target leader process-birth fingerprint remained unavailable");
+}
+/**
+ * Drain only the group whose leader still has its armed process birth.
+ * @param target - Armed leader and group identity
+ * @param options - Optional deterministic probe overrides
+ */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- fail-closed birth and two-phase signal authority are one bounded decision
+export async function drainTestRunTarget(target, options = {}) {
+    if (target === undefined)
+        return;
+    const probes = { ...DEFAULT_PROBES, ...options.probes };
+    const targetPresent = await assertTargetBirthAuthority(target, probes);
+    const groupPresent = probes.processGroupAlive(target.pgid);
+    if (!targetPresent) {
+        if (groupPresent) {
+            throw new Error("target leader is absent while its process group is live; refusing group signal");
+        }
+        return;
+    }
+    if (!groupPresent)
+        return;
+    const deadline = Date.now() + DRAIN_GRACE_MS;
+    probes.signalGroup(target.pgid, "SIGTERM");
+    while (probes.processGroupAlive(target.pgid) && Date.now() < deadline) {
+        await probes.delay(DRAIN_POLL_MS);
+    }
+    if (probes.processGroupAlive(target.pgid)) {
+        if (!(await assertTargetBirthAuthority(target, probes))) {
+            throw new Error("target leader is absent while its process group is live; refusing group signal");
+        }
+        const killDeadline = Date.now() + DRAIN_GRACE_MS;
+        probes.signalGroup(target.pgid, "SIGKILL");
+        while (probes.processGroupAlive(target.pgid) && Date.now() < killDeadline) {
+            await probes.delay(DRAIN_POLL_MS);
+        }
+    }
+    if (probes.processGroupAlive(target.pgid)) {
+        throw new Error("target process group survived bounded drain");
+    }
+}
+//# sourceMappingURL=lisa-test-run-process-group.js.map

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

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

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=lisa-test-run-reaper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-test-run-reaper.d.ts","sourceRoot":"","sources":["../../src/cli/lisa-test-run-reaper.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+/** Detached one-run reaper for supervisor death and scratch cleanup. */
+import { env } from "node:process";
+import { materializeOwnedScratchRunRoot, openOwnedScratchRunRoot, removeOwnedScratchRunRoot, } from "../configs/vitest/scratch.js";
+import { processBirthFingerprint, writeScratchOwnerRecord, } from "../configs/vitest/scratch-owner.js";
+import { parseScratchProtocolMessage, validateScratchRunRootIntent, } from "../configs/vitest/scratch-supervision.js";
+import { drainTestRunTarget, } from "./lisa-test-run-process-group.js";
+/** Private deterministic fault seam, stripped before payload execution. */
+const TEST_FAULT_ENV = "LISA_TEST_RUN_TEST_FAULT";
+/**
+ * Validate and arm one pre-materialization root intent.
+ * @param value - Exact root-intent message
+ * @returns Immutable root intent
+ */
+function armRootIntent(value) {
+    const candidate = validateScratchRunRootIntent(value["intent"]);
+    if (value["correlation"] !== candidate.token ||
+        openOwnedScratchRunRoot(candidate) !== undefined ||
+        env[TEST_FAULT_ENV] === "reaper-refuse-root-intent") {
+        throw new Error("Scratch root intent was not conclusively absent");
+    }
+    return candidate;
+}
+/**
+ * Materialize the exact armed intent inside the detached authority.
+ * @param value - Exact correlated materialization request
+ * @param intent - Previously armed root intent
+ * @returns Newly persisted root identity
+ */
+function materializeArmedRoot(value, intent) {
+    if (intent === undefined ||
+        value["correlation"] !== intent.token ||
+        openOwnedScratchRunRoot(intent) !== undefined) {
+        throw new Error("Scratch root materialization does not match armed intent");
+    }
+    const owned = materializeOwnedScratchRunRoot(intent, {
+        writeOwnerRecord: (root, owner) => {
+            if (env[TEST_FAULT_ENV] === "pause-before-owner-marker") {
+                process.kill(process.pid, "SIGSTOP");
+            }
+            writeScratchOwnerRecord(root, owner);
+        },
+    });
+    return owned.owner.root;
+}
+/**
+ * Validate and arm one birth-bound target before root materialization.
+ * @param value - Exact target-intent message
+ * @param intent - Previously armed root intent
+ * @returns Immutable target authority
+ */
+function armTargetIntent(value, intent) {
+    const candidate = value["target"];
+    if (intent === undefined ||
+        value["correlation"] !== intent.token ||
+        openOwnedScratchRunRoot(intent) !== undefined ||
+        processBirthFingerprint(candidate.pid) !==
+            candidate.processBirthFingerprint ||
+        env[TEST_FAULT_ENV] === "reaper-refuse-target-intent") {
+        throw new Error("Target intent does not match the armed root correlation");
+    }
+    return candidate;
+}
+/**
+ * Run detached recovery once, then exit with no permanent companion.
+ * @param state - Reaper lifecycle state
+ */
+async function recover(state) {
+    if (state.recovering || state.disarmed)
+        return;
+    // eslint-disable-next-line functional/immutable-data -- exactly-once recovery transition
+    state.recovering = true;
+    try {
+        if (env[TEST_FAULT_ENV] === "pause-recovery-before-drain") {
+            process.kill(process.pid, "SIGSTOP");
+        }
+        await drainTestRunTarget(state.target);
+        if (state.intent !== undefined)
+            removeOwnedScratchRunRoot(state.intent);
+        process.exit(0);
+    }
+    catch (error) {
+        process.stderr.write(`lisa-test-run reaper failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exit(1);
+    }
+}
+/**
+ * Send one exact acknowledgement or enter detached recovery.
+ * @param state - Reaper lifecycle state
+ * @param type - Exact acknowledgement type
+ * @param correlation - Optional root token correlation
+ * @param body - Exact type-specific acknowledgement fields
+ * @param onSent - Optional terminal action after the IPC callback flushes
+ */
+function sendAcknowledgement(state, type, correlation, body = {}, onSent) {
+    if (env[TEST_FAULT_ENV] === "reaper-close-root-armed" &&
+        type === "ROOT_ARMED" &&
+        process.connected) {
+        process.disconnect();
+    }
+    if (!process.connected || process.send === undefined) {
+        void recover(state);
+        return;
+    }
+    try {
+        process.send({
+            schema: 1,
+            type,
+            ...(correlation === undefined ? {} : { correlation }),
+            ...body,
+        }, error => {
+            if (error !== null)
+                void recover(state);
+            else
+                onSent?.();
+        });
+    }
+    catch {
+        void recover(state);
+    }
+}
+/**
+ * Apply one exact message to the current reaper phase.
+ * @param state - Reaper lifecycle state
+ * @param message - Untrusted IPC message
+ */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- four explicit protocol phases are kept visibly fail-closed
+function handleMessage(state, message) {
+    const value = parseScratchProtocolMessage(message);
+    if (state.phase === "await-root-intent" && value.type === "ROOT_INTENT") {
+        const intent = armRootIntent(value);
+        // eslint-disable-next-line functional/immutable-data -- immutable authority captured once
+        state.intent = intent;
+        // eslint-disable-next-line functional/immutable-data -- ordered protocol transition
+        state.phase = "await-target-intent";
+        sendAcknowledgement(state, "ROOT_INTENT_ARMED", intent.token);
+        return;
+    }
+    if (state.phase === "await-target-intent" && value.type === "TARGET_INTENT") {
+        const target = armTargetIntent(value, state.intent);
+        // eslint-disable-next-line functional/immutable-data -- immutable target captured once
+        state.target = target;
+        // eslint-disable-next-line functional/immutable-data -- ordered protocol transition
+        state.phase = "await-materialization";
+        sendAcknowledgement(state, "TARGET_ARMED", state.intent?.token);
+        return;
+    }
+    if (state.phase === "await-materialization" &&
+        value.type === "MATERIALIZE_ROOT") {
+        const root = materializeArmedRoot(value, state.intent);
+        // eslint-disable-next-line functional/immutable-data -- ordered protocol transition
+        state.phase = "armed";
+        sendAcknowledgement(state, "ROOT_ARMED", state.intent?.token, { root });
+        return;
+    }
+    if (state.phase === "armed" && value.type === "CLEANED") {
+        if (state.intent !== undefined &&
+            openOwnedScratchRunRoot(state.intent) !== undefined) {
+            throw new Error("Foreground cleanup did not remove the armed root");
+        }
+        // eslint-disable-next-line functional/immutable-data -- terminal disarm transition
+        state.disarmed = true;
+        // eslint-disable-next-line functional/immutable-data -- terminal disarm transition
+        state.phase = "disarmed";
+        sendAcknowledgement(state, "DISARMED", undefined, {}, () => {
+            process.disconnect();
+            process.exit(0);
+        });
+        return;
+    }
+    throw new Error(`Unexpected ${value.type} in reaper state ${state.phase}`);
+}
+/** Start the one-shot detached recovery protocol. */
+function main() {
+    const state = {
+        disarmed: false,
+        recovering: false,
+        phase: "await-root-intent",
+    };
+    process.on("message", message => {
+        try {
+            handleMessage(state, message);
+        }
+        catch (error) {
+            process.stderr.write(`lisa-test-run reaper refused protocol: ${error instanceof Error ? error.message : String(error)}\n`);
+            void recover(state);
+        }
+    });
+    process.once("disconnect", () => void recover(state));
+    sendAcknowledgement(state, "REAPER_READY");
+}
+if (env[TEST_FAULT_ENV] === "reaper-startup")
+    process.exit(77);
+main();
+//# sourceMappingURL=lisa-test-run-reaper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-test-run-reaper.js","sourceRoot":"","sources":["../../src/cli/lisa-test-run-reaper.ts"],"names":[],"mappings":";AACA,wEAAwE;AACxE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,GAE1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GAExB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,GAE7B,MAAM,0CAA0C,CAAC;AAElD,OAAO,EACL,kBAAkB,GAEnB,MAAM,kCAAkC,CAAC;AAE1C,2EAA2E;AAC3E,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAgBlD;;;;GAIG;AACH,SAAS,aAAa,CACpB,KAA+B;IAE/B,MAAM,SAAS,GAAG,4BAA4B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChE,IACE,KAAK,CAAC,aAAa,CAAC,KAAK,SAAS,CAAC,KAAK;QACxC,uBAAuB,CAAC,SAAS,CAAC,KAAK,SAAS;QAChD,GAAG,CAAC,cAAc,CAAC,KAAK,2BAA2B,EACnD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAC3B,KAA+B,EAC/B,MAA0C;IAE1C,IACE,MAAM,KAAK,SAAS;QACpB,KAAK,CAAC,aAAa,CAAC,KAAK,MAAM,CAAC,KAAK;QACrC,uBAAuB,CAAC,MAAM,CAAC,KAAK,SAAS,EAC7C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAG,8BAA8B,CAAC,MAAM,EAAE;QACnD,gBAAgB,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAChC,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,2BAA2B,EAAE,CAAC;gBACxD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACvC,CAAC;YACD,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;KACF,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CACtB,KAA+B,EAC/B,MAA0C;IAE1C,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAwB,CAAC;IACzD,IACE,MAAM,KAAK,SAAS;QACpB,KAAK,CAAC,aAAa,CAAC,KAAK,MAAM,CAAC,KAAK;QACrC,uBAAuB,CAAC,MAAM,CAAC,KAAK,SAAS;QAC7C,uBAAuB,CAAC,SAAS,CAAC,GAAG,CAAC;YACpC,SAAS,CAAC,uBAAuB;QACnC,GAAG,CAAC,cAAc,CAAC,KAAK,6BAA6B,EACrD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,OAAO,CAAC,KAAkB;IACvC,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO;IAC/C,yFAAyF;IACzF,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,6BAA6B,EAAE,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAC3F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAC1B,KAAkB,EAClB,IAAY,EACZ,WAAoB,EACpB,OAA0C,EAAE,EAC5C,MAAmB;IAEnB,IACE,GAAG,CAAC,cAAc,CAAC,KAAK,yBAAyB;QACjD,IAAI,KAAK,YAAY;QACrB,OAAO,CAAC,SAAS,EACjB,CAAC;QACD,OAAO,CAAC,UAAU,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACrD,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CACV;YACE,MAAM,EAAE,CAAC;YACT,IAAI;YACJ,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;YACrD,GAAG,IAAI;SACR,EACD,KAAK,CAAC,EAAE;YACN,IAAI,KAAK,KAAK,IAAI;gBAAE,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;;gBACnC,MAAM,EAAE,EAAE,CAAC;QAClB,CAAC,CACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,sHAAsH;AACtH,SAAS,aAAa,CAAC,KAAkB,EAAE,OAAgB;IACzD,MAAM,KAAK,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,KAAK,KAAK,mBAAmB,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,0FAA0F;QAC1F,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACtB,oFAAoF;QACpF,KAAK,CAAC,KAAK,GAAG,qBAAqB,CAAC;QACpC,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,qBAAqB,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACpD,uFAAuF;QACvF,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACtB,oFAAoF;QACpF,KAAK,CAAC,KAAK,GAAG,uBAAuB,CAAC;QACtC,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IACD,IACE,KAAK,CAAC,KAAK,KAAK,uBAAuB;QACvC,KAAK,CAAC,IAAI,KAAK,kBAAkB,EACjC,CAAC;QACD,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACvD,oFAAoF;QACpF,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;QACtB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACxD,IACE,KAAK,CAAC,MAAM,KAAK,SAAS;YAC1B,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,SAAS,EACnD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,mFAAmF;QACnF,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACtB,mFAAmF;QACnF,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC;QACzB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE;YACzD,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,CAAC,IAAI,oBAAoB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,qDAAqD;AACrD,SAAS,IAAI;IACX,MAAM,KAAK,GAAgB;QACzB,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,mBAAmB;KAC3B,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE;QAC9B,IAAI,CAAC;YACH,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0CAA0C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CACrG,CAAC;YACF,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,mBAAmB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAC7C,CAAC;AAED,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,gBAAgB;IAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/D,IAAI,EAAE,CAAC"}

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

@@ -0,0 +1,46 @@
+/** Runtime-only companion, environment, and signal escalation primitives. */
+import { type ChildProcess } from "node:child_process";
+import { type ScratchRouteProfile } from "../configs/vitest/scratch-route-profile.js";
+import type { PayloadOutcome } from "./lisa-test-run-ipc.js";
+import { type TestRunTargetIntent } from "./lisa-test-run-process-group.js";
+/** Catchable signals forwarded to the target process group. */
+export declare const FORWARDED_SIGNALS: readonly NodeJS.Signals[];
+/** Cancellable escalation armed by the first forwarded catchable signal. */
+export interface SignalEscalation {
+    readonly promise: Promise<PayloadOutcome>;
+    readonly begin: (signal: NodeJS.Signals) => void;
+    readonly cancel: () => void;
+}
+/**
+ * Start one source-or-built sibling as a detached IPC child.
+ * @param name - Sibling module basename
+ * @returns Detached protocol companion
+ */
+export declare function forkDetachedSibling(name: string): ChildProcess;
+/**
+ * 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 declare function payloadEnvironment(lease: string, profile: ScratchRouteProfile, directScratchRoot?: string): Record<string, string>;
+/**
+ * Reject if the detached cleanup authority exits during the payload.
+ * @param reaper - Armed detached reaper
+ * @returns Promise that only rejects on exit
+ */
+export declare function rejectOnReaperExit(reaper: ChildProcess): Promise<never>;
+/**
+ * Drain with deterministic birth-probe failures only in dedicated controls.
+ * @param target - Armed target authority
+ * @returns Bounded drain promise
+ */
+export declare function drainSupervisedTarget(target: TestRunTargetIntent | undefined): Promise<void>;
+/**
+ * Build one cancellable TERM-to-KILL escalation.
+ * @param target - Armed birth-bound target
+ * @returns Cancellable escalation
+ */
+export declare function createSignalEscalation(target: TestRunTargetIntent): SignalEscalation;
+//# sourceMappingURL=lisa-test-run-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-test-run-runtime.d.ts","sourceRoot":"","sources":["../../src/cli/lisa-test-run-runtime.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EAAQ,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK7D,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AAQ1C,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,CAAC,OAAO,EAItD,CAAC;AAEF,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAY9D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,EAC5B,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBxB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CASvE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,GAAG,SAAS,GACtC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,GAC1B,gBAAgB,CA+BlB"}