@codyswann/lisa 4.28.5 → 4.29.1

package/all/copy-overwrite/scripts/lisa-gates.mjs

@@ -1523,7 +1523,8 @@ const QUALITY_FALLBACKS = Object.freeze({
     ],
   },
   test_node_suites: {
-    command: "node <lisa>/scripts/lisa-test-node.mjs",
+    command:
+      "lisa-test-run --profile <stack-or-node> --adapter direct -- node <lisa>/scripts/lisa-test-node.mjs",
     seedRun: ["test:node"],
     steps: ["🧪 Run .mjs suites (lisa-test-node)"],
   },

package/all/copy-overwrite/scripts/lisa-hooks/sonar-secrets.sh

@@ -137,10 +137,11 @@ is_inactive() {
 # The FIFO is a rendezvous, not storage: a named pipe holds no data at rest, so
 # the value still never lands on disk (CWE-922) and a kill at any point leaves an
 # empty pipe behind rather than a readable token. The directory is `mktemp -d`,
-# which is 0700.
+# which is 0700. Its explicit Lisa prefix makes an interrupted resolver
+# attributable to the owning scratch lifecycle instead of anonymous `tmp.*`.
 resolve_secret() {
   local resolver="$1" name="$2" value="" child="" dir="" fifo=""
-  dir="$(mktemp -d)" || return 0
+  dir="$(mktemp -d "${TMPDIR:-/tmp}/lisa-sonar-resolver.XXXXXXXX")" || return 0
   fifo="$dir/resolver"
   if ! mkfifo -m 600 "$fifo" 2>/dev/null; then
     rm -rf "$dir"

package/cdk/create-only/vitest.config.local.ts

@@ -28,7 +28,11 @@
 import type { ViteUserConfig } from "vitest/config";
 
 const config: ViteUserConfig = {
-  // Add project-specific settings here
+  test: {
+    // Scratch redirection must install before the leak guard, and the guard's
+    // afterAll must run after project hooks so cleanup is attributed correctly.
+    sequence: { setupFiles: "list", hooks: "stack" },
+  },
 };
 
 export default config;

package/cdk/package-lisa/package.lisa.json

@@ -6,15 +6,16 @@
       "cdk": "cdk",
       "build": "tsc --noEmit",
       "prepare": "husky install || true",
-      "test": "vitest run",
-      "test:unit": "vitest run --exclude='**/integration/**'",
-      "test:integration:lisa": "vitest run '.integration.' 'integration/'",
-      "test:cov": "vitest run --coverage",
-      "test:mutation": "node scripts/lisa-mutation.mjs",
-      "test:watch": "vitest",
+      "test": "lisa-test-run --profile cdk --adapter vitest -- vitest run",
+      "test:unit": "lisa-test-run --profile cdk --adapter vitest -- vitest run --exclude='**/integration/**'",
+      "test:integration:lisa": "lisa-test-run --profile cdk --adapter vitest -- vitest run '.integration.' 'integration/'",
+      "test:cov": "lisa-test-run --profile cdk --adapter vitest -- vitest run --coverage",
+      "test:cov:unit": "LISA_COVERAGE_SCOPE=unit lisa-test-run --profile cdk --adapter vitest -- vitest run --coverage --exclude='**/integration/**'",
+      "test:mutation": "LISA_TEST_SCRATCH_PREFIXES='[\"lisa-mutation-\",\"worker-\"]' lisa-test-run --profile cdk --adapter direct -- node scripts/lisa-mutation.mjs",
+      "test:watch": "lisa-test-run --profile cdk --adapter vitest -- vitest",
       "lint:lisa": "oxlint && eslint . --quiet",
       "lint:fix": "oxlint --fix && eslint . --fix",
-      "test:node": "node scripts/lisa-test-node.mjs"
+      "test:node": "LISA_TEST_SCRATCH_PREFIXES='[\"node-\"]' lisa-test-run --profile cdk --adapter direct -- node scripts/lisa-test-node.mjs"
     },
     "dependencies": {
       "aws-cdk-github-oidc": "^2.4.1",
@@ -68,6 +69,12 @@
   "adopt": {
     "scripts": {
       "test:integration": [
+        "lisa-test-run --profile cdk --adapter vitest -- vitest run '.integration.' 'integration/' --passWithNoTests",
+        "lisa-test-run --profile cdk --adapter vitest -- vitest run '.integration.' 'integration/'",
+        "lisa-test-run --profile cdk -- vitest run '.integration.' 'integration/' --passWithNoTests",
+        "lisa-test-run --profile cdk -- vitest run '.integration.' 'integration/'",
+        "lisa-test-run -- vitest run '.integration.' 'integration/' --passWithNoTests",
+        "lisa-test-run -- vitest run '.integration.' 'integration/'",
         "vitest run '.integration.' 'integration/' --passWithNoTests",
         "vitest run '.integration.' 'integration/'",
         "vitest run tests/integration",

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

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

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

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

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

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+/** Inert process-group leader that gates a supervised test payload on GO. */
+import { spawn } from "node:child_process";
+import { env } from "node:process";
+import { parseScratchProtocolMessage } from "../configs/vitest/scratch-supervision.js";
+/** Private deterministic IPC-close seam, never inherited by the payload. */
+const TEST_FAULT_ENV = "LISA_TEST_RUN_TEST_FAULT";
+/** Signals the foreground supervisor owns and the group leader must survive. */
+const SUPERVISED_SIGNALS = [
+    "SIGINT",
+    "SIGTERM",
+    "SIGHUP",
+];
+/**
+ * Parse the exact bounded inert command envelope.
+ * @param value - Parsed IPC command body
+ * @returns Validated command
+ */
+function validateCommand(value) {
+    const candidate = value;
+    if (typeof value !== "object" ||
+        value === null ||
+        candidate.schema !== 1 ||
+        !Array.isArray(candidate.argv) ||
+        candidate.argv.length === 0 ||
+        !candidate.argv.every(argument => typeof argument === "string") ||
+        typeof candidate.env !== "object" ||
+        candidate.env === null ||
+        !Object.values(candidate.env).every(entry => typeof entry === "string")) {
+        throw new Error("Invalid lisa-test-run bootstrap command schema");
+    }
+    return candidate;
+}
+/**
+ * Forward one signal to the payload when it is still present.
+ * @param payload - Current payload process
+ * @param signal - Signal to deliver
+ */
+function signalPayload(payload, signal) {
+    try {
+        payload?.kill(signal);
+    }
+    catch {
+        // A concurrently exiting payload is already drained.
+    }
+}
+/**
+ * Kill the payload and mark operational failure after channel loss.
+ * @param state - Bootstrap lifecycle state
+ */
+function failClosed(state) {
+    if (state.failingClosed)
+        return;
+    // eslint-disable-next-line functional/immutable-data -- one-process protocol state transition
+    state.failingClosed = true;
+    if (!state.payloadExited)
+        signalPayload(state.payload, "SIGKILL");
+    process.exitCode = 1;
+    if (process.connected)
+        process.disconnect();
+}
+/**
+ * Send one exact response with callback-safe channel settlement.
+ * @param state - Bootstrap lifecycle state
+ * @param message - Exact protocol response
+ */
+function sendResponse(state, message) {
+    const type = message["type"];
+    const fault = env[TEST_FAULT_ENV];
+    const closeForFault = (fault === "bootstrap-close-command-ready" && type === "COMMAND_READY") ||
+        (fault === "bootstrap-close-payload-exit" && type === "PAYLOAD_EXIT");
+    if (closeForFault && process.connected)
+        process.disconnect();
+    if (!process.connected || process.send === undefined) {
+        failClosed(state);
+        return;
+    }
+    try {
+        process.send(message, error => {
+            if (error !== null)
+                failClosed(state);
+        });
+    }
+    catch {
+        failClosed(state);
+    }
+}
+/**
+ * Start one payload only after the ordered COMMAND/GO handshake.
+ * @param state - Bootstrap lifecycle state
+ * @param command - Immutable payload command
+ */
+function startPayload(state, command) {
+    // eslint-disable-next-line functional/immutable-data -- ordered protocol transition before spawn
+    state.phase = "running";
+    const payload = spawn(command.argv[0], command.argv.slice(1), {
+        cwd: process.cwd(),
+        env: command.env,
+        detached: false,
+        shell: false,
+        stdio: "inherit",
+    });
+    // eslint-disable-next-line functional/immutable-data -- single owned payload handle
+    state.payload = payload;
+    payload.once("error", error => {
+        sendResponse(state, {
+            schema: 1,
+            type: "PAYLOAD_ERROR",
+            message: error.message,
+        });
+    });
+    payload.once("exit", (code, signal) => {
+        // eslint-disable-next-line functional/immutable-data -- terminal payload state
+        state.payloadExited = true;
+        // eslint-disable-next-line functional/immutable-data -- terminal payload state
+        state.phase = "payload-exited";
+        sendResponse(state, { schema: 1, type: "PAYLOAD_EXIT", code, signal });
+    });
+}
+/**
+ * Deliver a forwarded signal, treating one outside `running` as the race it is.
+ *
+ * Two windows produce a legitimate out-of-phase SIGNAL: the supervisor arms its
+ * handlers before it sends GO, so a signal there arrives in `await-go`; and the
+ * payload's own exit records `payload-exited` before PAYLOAD_EXIT reaches the
+ * supervisor, so a signal forwarded in that gap arrives after there is anything
+ * left to signal. Refusing either would fail this process closed -- exit 1 and
+ * an abrupt disconnect -- reporting an ordinary signal-terminated run as a
+ * protocol refusal plus an unexpected channel loss.
+ * @param state - Bootstrap lifecycle state
+ * @param signal - Signal the supervisor forwarded
+ */
+function forwardSignal(state, signal) {
+    if (state.phase !== "running")
+        return;
+    signalPayload(state.payload, signal);
+}
+/**
+ * Apply one already-validated message to the exact protocol phase.
+ * @param state - Bootstrap lifecycle state
+ * @param message - Untrusted IPC message
+ */
+function handleMessage(state, message) {
+    const protocol = parseScratchProtocolMessage(message);
+    const type = protocol.type;
+    if (state.phase === "await-command" && type === "COMMAND") {
+        // eslint-disable-next-line functional/immutable-data -- command becomes immutable after the one accepted transition
+        state.command = validateCommand(protocol["command"]);
+        // eslint-disable-next-line functional/immutable-data -- ordered protocol transition
+        state.phase = "await-go";
+        sendResponse(state, { schema: 1, type: "COMMAND_READY" });
+        return;
+    }
+    if (state.phase === "await-go" && type === "GO" && state.command) {
+        startPayload(state, state.command);
+        return;
+    }
+    if (type === "SIGNAL") {
+        forwardSignal(state, protocol["signal"]);
+        return;
+    }
+    if (type === "STOP" && state.phase !== "stopping") {
+        // eslint-disable-next-line functional/immutable-data -- terminal protocol transition
+        state.phase = "stopping";
+        if (!state.payloadExited)
+            signalPayload(state.payload, "SIGKILL");
+        process.disconnect();
+        process.exit(0);
+    }
+    throw new Error(`Unexpected ${type} in bootstrap state ${state.phase}`);
+}
+/** Run the process-group leader protocol. */
+function main() {
+    const state = {
+        payloadExited: false,
+        failingClosed: false,
+        phase: "await-command",
+    };
+    for (const signal of SUPERVISED_SIGNALS) {
+        process.on(signal, () => undefined);
+    }
+    sendResponse(state, { schema: 1, type: "BOOTSTRAP_READY", pid: process.pid });
+    process.on("message", message => {
+        try {
+            handleMessage(state, message);
+        }
+        catch (error) {
+            process.stderr.write(`lisa-test-run bootstrap refused protocol: ${error instanceof Error ? error.message : String(error)}\n`);
+            failClosed(state);
+        }
+    });
+    process.on("disconnect", () => failClosed(state));
+}
+try {
+    main();
+}
+catch (error) {
+    process.stderr.write(`lisa-test-run bootstrap failed: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=lisa-test-run-bootstrap.js.map

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

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

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

@@ -0,0 +1,42 @@
+/** Exact, bounded parent-side IPC operations for lisa-test-run companions. */
+import type { ChildProcess } from "node:child_process";
+import { type ScratchProtocolMessageV1 } from "../configs/vitest/scratch-supervision.js";
+/** Child outcome retained until cleanup and disarm are proven. */
+export interface PayloadOutcome {
+    readonly code: number | null;
+    readonly signal: NodeJS.Signals | null;
+}
+/**
+ * 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 declare function waitForMessage(child: ChildProcess, expected: string, correlation?: string): Promise<ScratchProtocolMessageV1>;
+/**
+ * Wait until a protocol companion is absent from the process table.
+ * @param child - Protocol companion
+ * @returns Promise settled after exit
+ */
+export declare function waitForExit(child: ChildProcess): Promise<void>;
+/**
+ * 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 declare function sendMessage(child: ChildProcess, message: Readonly<Record<string, unknown>>): Promise<void>;
+/**
+ * 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 declare function waitForPayload(bootstrap: ChildProcess, signalEscalating?: () => boolean): Promise<PayloadOutcome>;
+/**
+ * Stop the inert leader and wait for it to leave the target group.
+ * @param bootstrap - Inert bootstrap leader
+ */
+export declare function stopBootstrap(bootstrap: ChildProcess): Promise<void>;
+//# sourceMappingURL=lisa-test-run-ipc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-test-run-ipc.d.ts","sourceRoot":"","sources":["../../src/cli/lisa-test-run-ipc.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,0CAA0C,CAAC;AAgDlD,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CACxC;AAOD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAsCnC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAYD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,YAAY,EACvB,gBAAgB,GAAE,MAAM,OAAqB,GAC5C,OAAO,CAAC,cAAc,CAAC,CAkCzB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1E"}

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