@prestyj/cli 5.28.0 → 5.29.0

package/dist/core/persistent-shell.js

@@ -6,14 +6,89 @@
  * per call vs ~6.4ms for spawn-per-call (see bash-spawn-benchmark.ts), and —
  * the real win — cd/env/shell state survive across calls.
  *
- * POSIX-only (needs a real bash). Callers must fall back to spawn-per-call
- * when bash is unavailable (Windows cmd.exe fallback path).
+ * Losing that state silently is the failure mode this file guards against:
+ *
+ * - Timeout / abort stops only the running command: the shell gets SIGUSR1
+ *   (its trap breaks out of the wrapper loop, so the rest of the command list
+ *   is skipped) and every descendant of the shell is SIGTERM'd, then
+ *   SIGKILL'd. The shell itself survives with its cwd/env. Only if it still
+ *   has not printed the sentinel after a grace period (a builtin busy loop, a
+ *   user trap) is the whole shell killed.
+ * - After every command the sentinel line snapshots the physical cwd and
+ *   `export -p` to a private temp file (builtins + one redirect, no fork).
+ * - When the shell dies (`exit`, `kill -9 $$`, OOM, or the fallback kill
+ *   above) a fresh shell is started at once and restored from that snapshot,
+ *   and the result carries a one-line note saying so. The command that killed
+ *   it is never re-run.
+ *
+ * Callers must fall back to spawn-per-call when bash is unavailable (Windows
+ * cmd.exe fallback path). On Windows (Git Bash) a command cannot be stopped
+ * without the shell — MSYS pids are not native pids and there are no POSIX
+ * signals — so timeout/abort still kills the shell tree, but the restart
+ * restores cwd/env the same way.
  */
 import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
 import { sliceHead } from "@prestyj/ai";
 import { resolveShell } from "./shell.js";
-import { killProcessTree } from "../utils/process.js";
+import { killProcessTree, listDescendantPids, signalDescendants } from "../utils/process.js";
+/** How long a stopped command's shell gets to print its sentinel before it is killed. */
+const INTERRUPT_GRACE_MS = 2_000;
+/** Re-sweep for descendants the command forked after the first signal. */
+const INTERRUPT_SWEEP_MS = 200;
+/** Startup handshake / state restore of a freshly spawned shell. */
+const SETUP_TIMEOUT_MS = 10_000;
+/** Interrupt trap: `break` out of every loop, including the per-command wrapper loop. */
+const SETUP_SCRIPT = "trap 'break 1000 2>/dev/null' USR1";
+const stateDirs = new Set();
+let exitHookInstalled = false;
+function trackStateDir(dir) {
+    stateDirs.add(dir);
+    if (exitHookInstalled)
+        return;
+    exitHookInstalled = true;
+    process.once("exit", () => {
+        for (const d of stateDirs)
+            rmSync(d, { recursive: true, force: true });
+    });
+}
+/** Single-quote for bash. */
+export function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+/**
+ * Split a state file (`pwd -P` line, then `export -p`) into cwd + env script.
+ * Variables the new shell must own (PWD, OLDPWD, SHLVL) are dropped.
+ */
+export function parseStateSnapshot(text) {
+    if (!text.trim())
+        return null;
+    // The cwd may in theory contain a newline, so split at the first export line.
+    const m = /\n(?=declare -|export )/.exec(text);
+    const cwd = (m ? text.slice(0, m.index) : text.replace(/\n$/, "")) || null;
+    const env = m
+        ? text
+            .slice(m.index + 1)
+            .split("\n")
+            .filter((line) => !/^(declare -\S+|export) (PWD|OLDPWD|SHLVL)(=|$)/.test(line))
+            .join("\n")
+        : "";
+    return { cwd, env };
+}
+/** Restore script: env first (its PWD is filtered), then cd, then report where we landed. */
+export function buildRestoreScript(snapshot) {
+    const env = snapshot.env.trim() ? `{ ${snapshot.env}\n} >/dev/null 2>&1\n` : "";
+    const cd = snapshot.cwd ? `builtin cd -- ${shellQuote(snapshot.cwd)} >/dev/null 2>&1\n` : "";
+    return `${env}${cd}builtin pwd -P`;
+}
+function describeExit(code, signal) {
+    if (signal)
+        return `killed by ${signal}`;
+    return code === null ? "exited" : `exited with code ${code}`;
+}
 export class PersistentShell {
     cwd;
     env;
@@ -21,8 +96,17 @@ export class PersistentShell {
     shellOpts;
     launch;
     child = null;
-    buffer = "";
+    /** The shell's own `$$`, used to stop just its command. */
+    shellPid = null;
     busy = false;
+    stateDir = null;
+    /**
+     * One-line notes about restarts, kept until `takeRestartNote()` so a helper
+     * run (e.g. a guard's `pwd`) cannot swallow the note meant for the model.
+     */
+    pendingNotes = [];
+    /** Bumped by kill(): a run cut short by an explicit kill must not restart the shell. */
+    generation = 0;
     constructor(cwd, env, maxOutputBytes, shellOpts, launch) {
         this.cwd = cwd;
         this.env = env;
@@ -30,14 +114,45 @@ export class PersistentShell {
         this.shellOpts = shellOpts;
         this.launch = launch;
     }
+    /**
+     * Consume the note(s) for the model about shell restarts since the last
+     * call, e.g. `[Shell exited with code 3, so it was restarted; restored
+     * working directory /x and exported environment variables. …]`.
+     */
+    takeRestartNote() {
+        const note = this.pendingNotes.join("\n") || undefined;
+        this.pendingNotes = [];
+        return note;
+    }
     /** True while a previous persistent command is still running. */
     get isBusy() {
         return this.busy;
     }
-    ensureChild() {
-        if (this.child && this.child.exitCode === null && !this.child.killed) {
-            return this.child;
+    /** Private 0700 temp dir holding the state snapshot; null if unavailable. */
+    get statePath() {
+        if (!this.stateDir) {
+            try {
+                this.stateDir = mkdtempSync(path.join(os.tmpdir(), "ez-psh-"));
+                trackStateDir(this.stateDir);
+            }
+            catch {
+                return null;
+            }
+        }
+        return path.join(this.stateDir, "state.sh");
+    }
+    readSnapshot() {
+        const file = this.stateDir ? path.join(this.stateDir, "state.sh") : null;
+        if (!file)
+            return null;
+        try {
+            return parseStateSnapshot(readFileSync(file, "utf-8"));
         }
+        catch {
+            return null;
+        }
+    }
+    spawnChild() {
         // Fresh session: no rc files so startup is fast and deterministic.
         //
         // Spawn the SAME bash the one-shot path resolved, not a bare `bash`: on
@@ -56,36 +171,101 @@ export class PersistentShell {
             // past a parent crash instead of grouping it for a clean tree-kill.
             detached: process.platform !== "win32",
         });
+        // Writing to a shell that just died is EPIPE on stdin; the exit handler
+        // reports it, so don't let the stream error crash the process.
+        child.stdin?.on("error", () => { });
         // Don't let a lingering session shell keep the parent process alive.
         child.unref();
         this.child = child;
-        this.buffer = "";
+        this.shellPid = null;
         return child;
     }
+    /** Spawn a shell, install the interrupt trap and learn its pid. */
+    async startShell() {
+        const child = this.spawnChild();
+        const res = await this.send(child, `${SETUP_SCRIPT}; builtin echo "$$"`, SETUP_TIMEOUT_MS);
+        if (res.kind !== "done") {
+            this.hardKill(child);
+            return false;
+        }
+        const pid = parseInt(res.output.trim().split("\n").pop() ?? "", 10);
+        this.shellPid = Number.isNaN(pid) ? null : pid;
+        return true;
+    }
     /**
-     * Run one command in the session shell. Serialized by the tool's sequential
-     * execution mode; a concurrent call while busy is rejected defensively.
-     * On timeout or abort the whole session is killed (state is gone — the next
-     * call starts a fresh shell) because a wedged command cannot be safely
-     * skipped within the same shell.
+     * Replace a dead (or killed) shell with a fresh one restored from the
+     * snapshot taken after the last completed command. Returns the one-line
+     * note for the tool result: `[Shell <how>, so it was restarted; <restored>.
+     * <lost> <tail>]`.
      */
-    run(command, timeoutMs, signal, onChunk) {
-        if (this.busy) {
-            return Promise.resolve({
-                exitCode: 1,
-                output: "persistent shell is busy with a previous command",
-            });
+    async restart(how, tail) {
+        const snapshot = this.readSnapshot();
+        const lost = "Shell functions, aliases, unexported variables and background jobs are gone.";
+        const started = await this.startShell().catch(() => false);
+        if (!started || !this.child) {
+            this.child = null;
+            return `[Shell ${how}, and starting a new shell failed; the next command starts a fresh shell in ${this.cwd} without the previous cwd/env. ${tail}]`;
         }
-        this.busy = true;
-        const child = this.ensureChild();
+        if (!snapshot) {
+            return `[Shell ${how}, so it was restarted in ${this.cwd}; there was no saved state, so earlier cd/exported variables are gone. ${tail}]`;
+        }
+        const res = await this.send(this.child, buildRestoreScript(snapshot), SETUP_TIMEOUT_MS);
+        if (res.kind !== "done") {
+            this.hardKill(this.child);
+            return `[Shell ${how}, and restoring its state failed; the next command starts a fresh shell in ${this.cwd} without the previous cwd/env. ${tail}]`;
+        }
+        const landed = res.output.trim().split("\n").pop() || this.cwd;
+        const restored = snapshot.cwd && landed === snapshot.cwd
+            ? `restored working directory ${landed} and exported environment variables`
+            : `restored exported environment variables; the previous working directory ${snapshot.cwd ?? "(unknown)"} no longer exists, so it is ${landed}`;
+        return `[Shell ${how}, so it was restarted; ${restored}. ${lost} ${tail}]`;
+    }
+    /**
+     * The shell's own pid, if it is a real descendant of the spawned process
+     * (inside a Linux sandbox's pid namespace `$$` is not a host pid). Never on
+     * Windows, where MSYS pids are not native pids.
+     */
+    verifiedShellPid(child) {
+        const pid = this.shellPid;
+        if (process.platform === "win32" || !pid || !child.pid)
+            return null;
+        if (pid === child.pid)
+            return pid;
+        return listDescendantPids(child.pid).includes(pid) ? pid : null;
+    }
+    hardKill(child) {
+        if (child.pid)
+            killProcessTree(child.pid);
+        if (this.child === child) {
+            this.child = null;
+            this.shellPid = null;
+        }
+    }
+    /**
+     * Write one script and wait for its sentinel. `run()` passes a signal and
+     * gets the stop-the-command-not-the-shell interrupt; setup scripts don't.
+     */
+    send(child, script, timeoutMs, signal, onChunk) {
         const sentinel = `__EZ_PSH_${randomUUID()}__`;
-        // `</dev/null` keeps stdin-reading commands (cat, read) from eating the
-        // next sentinel line instead of hanging the session.
-        const wrapped = `{ ${command}\n} </dev/null; echo "${sentinel}$?"\n`;
+        const statePath = this.statePath;
+        // Snapshot cwd + exported env before the sentinel, so a shell that dies
+        // in the next command can be restored to exactly this point. Builtins and
+        // one redirect only — no fork. On Windows Git Bash accepts `C:/…` paths.
+        const snapshot = statePath
+            ? `{ builtin pwd -P; builtin export -p; } >${shellQuote(statePath.replace(/\\/g, "/"))} 2>/dev/null; `
+            : "";
+        // The one-iteration loop is what the USR1 trap breaks out of, skipping the
+        // rest of an interrupted command list. `</dev/null` keeps stdin-reading
+        // commands (cat, read) from eating the next sentinel line.
+        const wrapped = `for __ez_psh_once in 1; do { ${script}\n} </dev/null; done; ` +
+            `__ez_psh_rc=$?; ${snapshot}builtin echo "${sentinel}$__ez_psh_rc"\n`;
         return new Promise((resolve) => {
             let out = "";
             let capped = false;
             let done = false;
+            let interrupted = null;
+            let sweep;
+            let grace;
             const finish = (result) => {
                 if (done)
                     return;
@@ -95,10 +275,12 @@ export class PersistentShell {
                 child.off("exit", onExit);
                 child.off("error", onError);
                 clearTimeout(timer);
-                signal.removeEventListener("abort", onAbort);
-                this.busy = false;
+                clearInterval(sweep);
+                clearTimeout(grace);
+                signal?.removeEventListener("abort", onAbort);
                 resolve(result);
             };
+            const capNote = () => `\n[Output capped at ${this.maxOutputBytes} bytes]`;
             // When output is capped we stop growing `out` but MUST keep scanning for
             // the sentinel — otherwise an over-cap command hangs until timeout and
             // needlessly destroys the session. `scanTail` keeps a small rolling
@@ -109,12 +291,13 @@ export class PersistentShell {
                 if (idx === -1)
                     return;
                 const code = parseInt(scan.slice(idx + sentinel.length), 10);
-                const body = fromCapped ? out : scan.slice(0, idx);
-                finish({
-                    exitCode: Number.isNaN(code) ? 1 : code,
-                    output: body.replace(/\n$/, "") +
-                        (fromCapped ? `\n[Output capped at ${this.maxOutputBytes} bytes]` : ""),
-                });
+                const body = (fromCapped ? out : scan.slice(0, idx)).replace(/\n$/, "");
+                const output = body + (fromCapped ? capNote() : "");
+                if (interrupted) {
+                    finish({ kind: interrupted, shellKept: true, output });
+                    return;
+                }
+                finish({ kind: "done", code: Number.isNaN(code) ? 1 : code, output });
             };
             const onData = (d) => {
                 const text = d.toString("utf-8");
@@ -134,36 +317,135 @@ export class PersistentShell {
                 onChunk?.(text);
                 checkSentinel(capped ? scanTail : out, capped);
             };
-            const timer = setTimeout(() => {
-                this.kill();
-                finish({ exitCode: "TIMEOUT", output: out });
-            }, timeoutMs);
-            const onAbort = () => {
-                this.kill();
-                finish({ exitCode: 1, output: out });
+            const giveUp = (kind, stuck = false) => {
+                this.hardKill(child);
+                finish({ kind, shellKept: false, stuck, output: out + (capped ? capNote() : "") });
+            };
+            const interrupt = (kind) => {
+                if (done || interrupted)
+                    return;
+                interrupted = kind;
+                if (!signal) {
+                    // Setup scripts: nothing worth preserving yet.
+                    giveUp(kind);
+                    return;
+                }
+                const pid = this.verifiedShellPid(child);
+                if (pid === null) {
+                    giveUp(kind);
+                    return;
+                }
+                // Order matters: the trap is deferred until the foreground child dies,
+                // so it must be pending before the children are killed.
+                try {
+                    process.kill(pid, "SIGUSR1");
+                }
+                catch {
+                    giveUp(kind);
+                    return;
+                }
+                signalDescendants(pid, "SIGTERM");
+                // Anything that ignored SIGTERM, or was forked since, gets SIGKILL.
+                sweep = setInterval(() => signalDescendants(pid, "SIGKILL"), INTERRUPT_SWEEP_MS);
+                grace = setTimeout(() => giveUp(kind, true), INTERRUPT_GRACE_MS);
             };
-            signal.addEventListener("abort", onAbort, { once: true });
+            const timer = setTimeout(() => interrupt("timeout"), timeoutMs);
+            const onAbort = () => interrupt("abort");
+            signal?.addEventListener("abort", onAbort, { once: true });
             // `exit N` (or a crash) ends the session shell itself — the sentinel
-            // never prints, so settle from the shell's own exit code. The next run()
-            // starts a fresh session.
-            const onExit = (code) => {
-                this.child = null;
-                finish({ exitCode: code ?? 1, output: out.replace(/\n$/, "") });
+            // never prints, so settle from the shell's own exit status.
+            const onExit = (code, sig) => {
+                if (this.child === child) {
+                    this.child = null;
+                    this.shellPid = null;
+                }
+                const output = out.replace(/\n$/, "") + (capped ? capNote() : "");
+                if (interrupted)
+                    finish({ kind: interrupted, shellKept: false, output });
+                else
+                    finish({ kind: "exited", code, signal: sig, output });
             };
             child.on("exit", onExit);
-            const onError = () => finish({ exitCode: 1, output: "failed to spawn session bash" });
+            const onError = () => finish({ kind: "error", output: "failed to spawn session bash" });
             child.on("error", onError);
             child.stdout?.on("data", onData);
             child.stderr?.on("data", onData);
             child.stdin?.write(wrapped);
         });
     }
-    /** Kill the session shell; the next run() starts a fresh one. */
+    /**
+     * Run one command in the session shell. Serialized by the tool's sequential
+     * execution mode; a concurrent call while busy is rejected defensively.
+     */
+    async run(command, timeoutMs, signal, onChunk) {
+        if (this.busy) {
+            return { exitCode: 1, output: "persistent shell is busy with a previous command" };
+        }
+        this.busy = true;
+        try {
+            const notes = this.pendingNotes;
+            const current = this.child;
+            if (current && (current.exitCode !== null || current.signalCode !== null)) {
+                // Died between commands (external kill, OOM). Nothing has been sent,
+                // so restarting here cannot double-execute anything.
+                this.child = null;
+                notes.push(await this.restart(`had ${describeExit(current.exitCode, current.signalCode)} since the last command`, "This command ran in the new shell."));
+            }
+            if (!this.child && !(await this.startShell().catch(() => false))) {
+                this.child = null;
+                return { exitCode: 1, output: "failed to spawn session bash" };
+            }
+            const child = this.child;
+            const generation = this.generation;
+            const res = await this.send(child, command, timeoutMs, signal, onChunk);
+            if (generation !== this.generation) {
+                return { exitCode: res.kind === "done" ? res.code : 1, output: res.output };
+            }
+            switch (res.kind) {
+                case "done":
+                    return { exitCode: res.code, output: res.output };
+                case "error":
+                    this.hardKill(child);
+                    return { exitCode: 1, output: res.output };
+                case "exited": {
+                    notes.push(await this.restart(describeExit(res.code, res.signal), "The command was not re-run."));
+                    // A signal death has no code; report it the way bash would (128+n).
+                    const code = res.code ?? (res.signal ? 128 + (os.constants.signals[res.signal] ?? 0) : 1);
+                    return { exitCode: code, output: res.output };
+                }
+                case "timeout":
+                case "abort": {
+                    const exitCode = res.kind === "timeout" ? "TIMEOUT" : 1;
+                    if (res.shellKept) {
+                        return { exitCode, output: res.output, shellKept: true };
+                    }
+                    const event = res.kind === "timeout" ? "timed out" : "was aborted";
+                    const how = res.stuck
+                        ? `did not stop when the command ${event}, so it was killed`
+                        : `was killed to stop the command that ${event}`;
+                    notes.push(await this.restart(how, "The command was not re-run."));
+                    return { exitCode, output: res.output, shellKept: false };
+                }
+            }
+        }
+        finally {
+            this.busy = false;
+        }
+    }
+    /** Kill the session shell and drop its saved state; the next run() starts fresh. */
     kill() {
-        if (this.child?.pid)
-            killProcessTree(this.child.pid);
+        this.generation++;
+        if (this.child)
+            this.hardKill(this.child);
         this.child = null;
+        this.shellPid = null;
         this.busy = false;
+        this.pendingNotes = [];
+        if (this.stateDir) {
+            rmSync(this.stateDir, { recursive: true, force: true });
+            stateDirs.delete(this.stateDir);
+            this.stateDir = null;
+        }
     }
 }
 //# sourceMappingURL=persistent-shell.js.map

package/dist/core/persistent-shell.js.map

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

package/dist/core/process-manager.d.ts

@@ -1,4 +1,5 @@
 import type { spawnSync } from "node:child_process";
+import { type ChildProcess } from "node:child_process";
 import { type ShellResolution } from "./shell.js";
 import type { AgentNotificationQueue } from "./agent-notifications.js";
 export interface BackgroundProcess {
@@ -108,6 +109,19 @@ export declare class ProcessManager {
      */
     private pruneOldLogs;
     start(command: string, cwd: string, launch?: ShellResolution, wake?: WakeRules): Promise<StartResult>;
+    /**
+     * Take over a foreground command that is still running, so the caller can
+     * return without killing it. Output captured so far seeds the log (its last
+     * {@link ADOPTED_PRIOR_OUTPUT_BYTES} only); later stdout/stderr is appended
+     * as it arrives. The process keeps its cwd and environment because it is the
+     * same process. Its stdin was never a pipe, so `sendInput` reports it closed.
+     *
+     * Synchronous on purpose: the caller hands over a live child whose 'close'
+     * has not fired yet, and an `await` here could let it fire unobserved.
+     */
+    adopt(child: ChildProcess, command: string, startedAt: number, priorOutput: Buffer): StartResult;
+    /** Register a running child and arm its exit bookkeeping and watchers. */
+    private track;
     /**
      * Arm a backing-off, budgeted progress watcher for one background process.
      * Emits at most one latest-only checkpoint per interval, only when the log

package/dist/core/process-manager.js

@@ -58,6 +58,9 @@ const CHECKPOINT_TAIL_CHARS = 320;
 /** Ceiling on a single blocking `waitForExitOrWake`, so one wedged process cannot
  *  hold the agent loop indefinitely; callers re-wait if they still want to. */
 export const MAX_PROCESS_WAIT_MS = 600_000;
+/** Output a foreground command produced before {@link ProcessManager.adopt} that
+ *  is kept in its log; the rest was already shown to nobody and only costs disk. */
+const ADOPTED_PRIOR_OUTPUT_BYTES = 1024 * 1024;
 /** Chars of the matched log line carried in a pattern-wake notification. */
 const WAKE_LINE_CHARS = 200;
 /** One log line, whitespace-collapsed and tail-bounded — never the raw log. */
@@ -179,6 +182,64 @@ export class ProcessManager {
             lastReadOffset: 0,
             logSize: 0,
         };
+        return this.track(child, proc, wake);
+    }
+    /**
+     * Take over a foreground command that is still running, so the caller can
+     * return without killing it. Output captured so far seeds the log (its last
+     * {@link ADOPTED_PRIOR_OUTPUT_BYTES} only); later stdout/stderr is appended
+     * as it arrives. The process keeps its cwd and environment because it is the
+     * same process. Its stdin was never a pipe, so `sendInput` reports it closed.
+     *
+     * Synchronous on purpose: the caller hands over a live child whose 'close'
+     * has not fired yet, and an `await` here could let it fire unobserved.
+     */
+    adopt(child, command, startedAt, priorOutput) {
+        fs.mkdirSync(this.bgDir, { recursive: true });
+        void this.pruneOldLogs();
+        const id = crypto.randomUUID().slice(0, 8);
+        const logFile = path.join(this.bgDir, `${id}.log`);
+        const prior = priorOutput.length > ADOPTED_PRIOR_OUTPUT_BYTES
+            ? Buffer.concat([
+                Buffer.from(`[earlier output dropped; last ${ADOPTED_PRIOR_OUTPUT_BYTES / 1024 / 1024} MiB kept]\n`),
+                priorOutput.subarray(priorOutput.length - ADOPTED_PRIOR_OUTPUT_BYTES),
+            ])
+            : priorOutput;
+        const fd = fs.openSync(logFile, "w");
+        fs.writeSync(fd, prior);
+        // Synchronous appends keep the log ordered and complete by the time
+        // 'close' fires, which the exit bookkeeping and waiters rely on.
+        const append = (data) => {
+            try {
+                fs.writeSync(fd, data);
+            }
+            catch {
+                // Disk full or log removed: drop output rather than crash the host.
+            }
+        };
+        child.stdout?.on("data", append);
+        child.stderr?.on("data", append);
+        child.once("close", () => fs.closeSync(fd));
+        // Never hold the host's event loop open for a process it no longer awaits.
+        child.unref();
+        for (const stream of [child.stdout, child.stderr]) {
+            stream?.unref?.();
+        }
+        const proc = {
+            id,
+            pid: child.pid ?? 0,
+            command,
+            logFile,
+            startedAt,
+            exitCode: null,
+            lastReadOffset: 0,
+            logSize: prior.length,
+        };
+        return this.track(child, proc);
+    }
+    /** Register a running child and arm its exit bookkeeping and watchers. */
+    track(child, proc, wake) {
+        const { id, pid, logFile } = proc;
         this.processes.set(id, proc);
         this.children.set(id, child);
         // A child that fails to spawn emits 'error', and an 'error' with no listener