@codyswann/lisa 4.28.5 → 4.29.1

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":"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"}

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"}

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":"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"}

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"}