@c9up/helix 0.1.3 → 0.1.5

package/dist/cli/native.js

@@ -0,0 +1,64 @@
+/**
+ * Loads the native `ream-test-napi` binary built by `scripts/copy-napi.mjs`
+ * and exposes the Rust orchestrator `run(config)` to the TS CLI.
+ *
+ * Per the orchestrator design (42-N-orchestrator), the Rust NAPI engine is the
+ * canonical discovery + worker-pool + reporter + summary path; the TS `runOnce`
+ * delegates to it whenever no TS-only layer (coverage / diff-cov / watch / a
+ * pluggable reporter instance) is in play. There is NO JS fallback for a failed
+ * load — the caller gets a typed error pointing at `build:napi`.
+ *
+ * Field names are camelCase: napi-rs converts the Rust struct's snake_case
+ * fields automatically (`timeout_ms` → `timeoutMs`, etc.).
+ */
+import { createRequire } from "node:module";
+import { arch, platform } from "node:process";
+import { fileURLToPath } from "node:url";
+const SUFFIX_MAP = {
+    "linux-x64": "linux-x64-gnu",
+    "linux-arm64": "linux-arm64-gnu",
+    "darwin-x64": "darwin-x64",
+    "darwin-arm64": "darwin-arm64",
+    "win32-x64": "win32-x64-msvc",
+};
+function platformSuffix() {
+    const key = `${platform}-${arch}`;
+    const suffix = SUFFIX_MAP[key];
+    if (typeof suffix !== "string") {
+        throw new Error(`Unsupported platform/arch '${key}' for @c9up/helix native binary. Supported: ${Object.keys(SUFFIX_MAP).join(", ")}.`);
+    }
+    return suffix;
+}
+function isNativeExports(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    return typeof Reflect.get(value, "run") === "function";
+}
+let cachedNative;
+export function getNative() {
+    if (cachedNative !== undefined)
+        return cachedNative;
+    const require = createRequire(import.meta.url);
+    const here = fileURLToPath(import.meta.url);
+    // `here` is `…/packages/helix/{src,dist}/cli/native.ts|js`. The `.node` lives
+    // two levels up at `…/packages/helix/index.<suffix>.node`.
+    const suffix = platformSuffix();
+    const candidate = `../../index.${suffix}.node`;
+    let loaded;
+    try {
+        loaded = require(candidate);
+    }
+    catch (err) {
+        const cause = err instanceof Error ? err.message : String(err);
+        const muslHint = suffix.endsWith("-gnu")
+            ? " If you are on Alpine/musl, note the prebuilt binaries target glibc (musl is not a supported target)."
+            : "";
+        throw new Error(`@c9up/helix native binary 'index.${suffix}.node' not found or failed to load near ${here} — run 'pnpm --filter @c9up/helix build:napi' to build it.${muslHint} Cause: ${cause}`, { cause: err });
+    }
+    if (!isNativeExports(loaded)) {
+        throw new Error("@c9up/helix native binary loaded but missing the expected 'run' export. Rebuild with 'pnpm --filter @c9up/helix build:napi'.");
+    }
+    cachedNative = loaded;
+    return cachedNative;
+}
+//# sourceMappingURL=native.js.map

package/dist/cli/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/cli/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAqC;IACpD,WAAW,EAAE,eAAe;IAC5B,aAAa,EAAE,iBAAiB;IAChC,YAAY,EAAE,YAAY;IAC1B,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,gBAAgB;CAC7B,CAAC;AAEF,SAAS,cAAc;IACtB,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACd,8BAA8B,GAAG,+CAA+C,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAgCD,SAAS,eAAe,CAAC,KAAc;IACtC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,UAAU,CAAC;AACxD,CAAC;AAED,IAAI,YAAuC,CAAC;AAE5C,MAAM,UAAU,SAAS;IACxB,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,8EAA8E;IAC9E,2DAA2D;IAC3D,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,eAAe,MAAM,OAAO,CAAC;IAC/C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvC,CAAC,CAAC,uGAAuG;YACzG,CAAC,CAAC,EAAE,CAAC;QACN,MAAM,IAAI,KAAK,CACd,oCAAoC,MAAM,2CAA2C,IAAI,6DAA6D,QAAQ,WAAW,KAAK,EAAE,EAChL,EAAE,KAAK,EAAE,GAAG,EAAE,CACd,CAAC;IACH,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACd,8HAA8H,CAC9H,CAAC;IACH,CAAC;IACD,YAAY,GAAG,MAAM,CAAC;IACtB,OAAO,YAAY,CAAC;AACrB,CAAC"}

package/dist/cli/pool.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Worker pool — spawns a Node child process per file and collects the
+ * framed result from the worker's stderr.
+ *
+ * Robustness features (2026-04-24 review pass):
+ *   - UTF-8 safe chunking via `node:string_decoder`
+ *   - Drains stdout so chatty `console.log` can't fill the pipe buffer
+ *   - SIGTERM → SIGKILL escalation after a grace window
+ *   - Process groups (`detached: true`) so grand-children die with the parent
+ *   - SIGINT handler that kills every in-flight worker cleanly
+ *   - Nonce in the frame instruction prevents a test file from spoofing results
+ *   - Reporter callbacks wrapped in try/catch so a buggy reporter can't crash the run
+ *   - Argv / config validation (threads, timeout) happens upstream; pool normalises
+ */
+import type { FileResult } from "../runtime/run.js";
+import type { Reporter } from "./reporter.js";
+export interface PoolConfig {
+    /** Absolute path to the CLI worker entry (cli-worker.ts). */
+    workerEntry: string;
+    /** Node executable to spawn. Default: `process.execPath`. */
+    nodeBin?: string;
+    /** Extra args before the worker entry, e.g. `["--import", "<tsx-loader>"]`. */
+    nodeArgs?: string[];
+    /** Concurrent workers. Default: `os.cpus().length`. */
+    threads?: number;
+    /** Per-file timeout (ms). Default 60 000. */
+    timeoutMs?: number;
+    /**
+     * Grace period (ms) between SIGTERM and SIGKILL when killing a hanging
+     * worker. Default 2 000.
+     */
+    killGraceMs?: number;
+    /**
+     * Extra environment variables merged into every spawned worker's env.
+     * Used by coverage to forward `NODE_V8_COVERAGE=<tmp-dir>`.
+     */
+    extraEnv?: NodeJS.ProcessEnv;
+}
+export interface WorkerErrorMessage {
+    file: string | undefined;
+    message: string;
+    stack?: string;
+}
+export type FileOutcome = {
+    kind: "result";
+    result: FileResult;
+} | {
+    kind: "error";
+    error: WorkerErrorMessage;
+};
+export declare function runPool(files: string[], cfg: PoolConfig, reporter: Reporter): Promise<{
+    results: FileResult[];
+    errors: WorkerErrorMessage[];
+}>;
+//# sourceMappingURL=pool.d.ts.map

package/dist/cli/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/cli/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,UAAU;IAC1B,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAwHhD,wBAAsB,OAAO,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,QAAQ,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CAmClE"}

package/dist/cli/pool.js

@@ -0,0 +1,404 @@
+/**
+ * Worker pool — spawns a Node child process per file and collects the
+ * framed result from the worker's stderr.
+ *
+ * Robustness features (2026-04-24 review pass):
+ *   - UTF-8 safe chunking via `node:string_decoder`
+ *   - Drains stdout so chatty `console.log` can't fill the pipe buffer
+ *   - SIGTERM → SIGKILL escalation after a grace window
+ *   - Process groups (`detached: true`) so grand-children die with the parent
+ *   - SIGINT handler that kills every in-flight worker cleanly
+ *   - Nonce in the frame instruction prevents a test file from spoofing results
+ *   - Reporter callbacks wrapped in try/catch so a buggy reporter can't crash the run
+ *   - Argv / config validation (threads, timeout) happens upstream; pool normalises
+ */
+import { spawn } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+import { StringDecoder } from "node:string_decoder";
+const FRAME_PREFIX = "__HELIX_RESULT__";
+/** Maximum stderr buffering before we give up and mark the file errored. */
+const MAX_STDERR_BUFFER_BYTES = 4 * 1024 * 1024; // 4 MiB
+/**
+ * Magic nonce the worker uses for errors it emits BEFORE receiving the
+ * instruction (so before it knows the real nonce). Accepted by the parent
+ * only for `type === "error"` frames so a fixture can't spoof results.
+ */
+const PRE_HANDSHAKE_NONCE = "__helix_pre_handshake__";
+/** Tracks every spawned worker so SIGINT can tear them all down. */
+const activeChildren = new Set();
+let sigintInstalled = false;
+function installSigintHandlerOnce() {
+    if (sigintInstalled)
+        return;
+    sigintInstalled = true;
+    const tearDown = (signal) => {
+        for (const child of activeChildren) {
+            try {
+                child.kill();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        process.off(signal, tearDown);
+        process.kill(process.pid, signal);
+    };
+    process.once("SIGINT", tearDown);
+    process.once("SIGTERM", tearDown);
+}
+/**
+ * FIFO counting semaphore. Waiters resolve in the order they called
+ * `acquire()` when a permit is released.
+ */
+class Semaphore {
+    #permits;
+    #waiters = [];
+    constructor(initial) {
+        if (!Number.isFinite(initial) || initial < 1) {
+            throw new Error(`Semaphore: initial permits must be a finite number >= 1, got ${initial}`);
+        }
+        this.#permits = Math.floor(initial);
+    }
+    async acquire() {
+        if (this.#permits > 0) {
+            this.#permits -= 1;
+            return this.#makeRelease();
+        }
+        return new Promise((resolve) => {
+            this.#waiters.push(() => resolve(this.#makeRelease()));
+        });
+    }
+    #makeRelease() {
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            const next = this.#waiters.shift();
+            if (next) {
+                next();
+            }
+            else {
+                this.#permits += 1;
+            }
+        };
+    }
+}
+function safeCall(fn, context) {
+    try {
+        return fn();
+    }
+    catch (err) {
+        process.stderr.write(`helix: reporter.${context} threw — ${err instanceof Error ? err.message : String(err)}\n`);
+        return undefined;
+    }
+}
+const LOADER_FLAG_PREFIXES = [
+    "--import",
+    "--loader",
+    "--experimental-loader",
+    "--experimental-vm-modules",
+    "--experimental-specifier-resolution",
+    "--conditions",
+];
+function inheritedLoaderArgs() {
+    const out = [];
+    const argv = process.execArgv;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        const prefix = LOADER_FLAG_PREFIXES.find((p) => arg === p || arg.startsWith(`${p}=`));
+        if (prefix === undefined)
+            continue;
+        out.push(arg);
+        // Flags written as `--import tsx` (space-separated) consume the next argv entry.
+        if (arg === prefix) {
+            const next = argv[i + 1];
+            if (next !== undefined) {
+                out.push(next);
+                i += 1;
+            }
+        }
+    }
+    return out;
+}
+export async function runPool(files, cfg, reporter) {
+    installSigintHandlerOnce();
+    const effectiveThreads = Math.max(1, Math.min(cfg.threads ?? os.cpus().length, files.length > 0 ? files.length : 1));
+    const sem = new Semaphore(effectiveThreads);
+    const results = [];
+    const errors = [];
+    await Promise.all(files.map(async (file) => {
+        const absFile = path.isAbsolute(file) ? file : path.resolve(file);
+        const release = await sem.acquire();
+        try {
+            safeCall(() => reporter.onFileStart(absFile), "onFileStart");
+            const outcome = await runOne(absFile, cfg);
+            if (outcome.kind === "result") {
+                safeCall(() => reporter.onFileResult(outcome.result), "onFileResult");
+                results.push(outcome.result);
+            }
+            else {
+                safeCall(() => reporter.onFileError(outcome.error), "onFileError");
+                errors.push(outcome.error);
+            }
+        }
+        finally {
+            release();
+        }
+    }));
+    return { results, errors };
+}
+function runOne(file, cfg) {
+    return new Promise((resolve) => {
+        const nodeBin = cfg.nodeBin ?? process.execPath;
+        // Inherit the parent process's --import / --loader / --experimental-*
+        // flags by default. This is what keeps the spawned worker able to
+        // execute the .ts worker entry when the parent runs under a TS loader
+        // (@swc-node/register, tsx, ts-node/esm, …). Callers that want the
+        // child to run with a clean argv pass `nodeArgs: []` explicitly.
+        const nodeArgs = cfg.nodeArgs ?? inheritedLoaderArgs();
+        const timeoutMs = Number.isFinite(cfg.timeoutMs) && (cfg.timeoutMs ?? 0) > 0
+            ? Math.floor(cfg.timeoutMs)
+            : 60_000;
+        const killGraceMs = Number.isFinite(cfg.killGraceMs) && (cfg.killGraceMs ?? 0) > 0
+            ? Math.floor(cfg.killGraceMs)
+            : 2_000;
+        // Per-invocation nonce — the worker echoes it inside every frame so
+        // malicious or confused test code can't spoof a `__HELIX_RESULT__` line.
+        const nonce = `${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        const child = spawn(nodeBin, [...nodeArgs, cfg.workerEntry], {
+            stdio: ["pipe", "pipe", "pipe"],
+            // `detached: true` on POSIX creates a new process group. On
+            // termination we kill the whole group so grand-children die too.
+            detached: process.platform !== "win32",
+            env: cfg.extraEnv ? { ...process.env, ...cfg.extraEnv } : process.env,
+        });
+        const registration = {
+            kill: () => killChild(child, killGraceMs),
+        };
+        activeChildren.add(registration);
+        let settled = false;
+        let pendingOutcome;
+        const settle = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(watchdog);
+            activeChildren.delete(registration);
+            resolve(outcome);
+        };
+        /**
+         * Schedule resolution. On a `result` or `error` frame from the
+         * worker (`forceKill = false`) we wait for `child.on("exit")` so
+         * `atExit` hooks (e.g. V8 coverage writer) finish flushing before
+         * we let downstream code read the coverage dir. On a timeout or
+         * spawn error (`forceKill = true`) we kill it now and resolve
+         * immediately — there's no useful flush to wait for.
+         */
+        const finish = (outcome, forceKill = false) => {
+            if (settled)
+                return;
+            if (forceKill) {
+                killChild(child, killGraceMs);
+                settle(outcome);
+                return;
+            }
+            // Defer resolution until exit — but if the child has already
+            // exited (race), settle now.
+            if (child.exitCode !== null || child.signalCode !== null) {
+                settle(outcome);
+                return;
+            }
+            pendingOutcome = outcome;
+        };
+        const watchdog = setTimeout(() => {
+            finish({
+                kind: "error",
+                error: {
+                    file,
+                    message: `worker timed out after ${timeoutMs}ms`,
+                },
+            }, true);
+        }, timeoutMs + killGraceMs);
+        watchdog.unref?.();
+        // UTF-8-safe accumulator for stderr frame parsing.
+        const decoder = new StringDecoder("utf8");
+        let stderrBuffer = "";
+        const processLine = (line) => {
+            if (!line.startsWith(FRAME_PREFIX)) {
+                if (process.env.HELIX_DEBUG_POOL) {
+                    process.stderr.write(`[helix-debug] worker stderr: ${line}\n`);
+                }
+                return;
+            }
+            const payload = line.slice(FRAME_PREFIX.length);
+            let msg;
+            try {
+                msg = JSON.parse(payload);
+            }
+            catch {
+                return;
+            }
+            if (!msg || typeof msg !== "object")
+                return;
+            const m = msg;
+            // Reject frames without the matching nonce — prevents a fixture
+            // that writes `__HELIX_RESULT__...` on stderr from spoofing.
+            // Exception: pre-handshake error frames (worker couldn't parse
+            // its own instruction and doesn't know the real nonce yet) are
+            // accepted only for `type === "error"` so a fixture still can't
+            // claim a fake success.
+            const nonceOk = m.nonce === nonce ||
+                (m.nonce === PRE_HANDSHAKE_NONCE && m.type === "error");
+            if (!nonceOk)
+                return;
+            if (m.type === "result" && m.result) {
+                finish({ kind: "result", result: m.result });
+            }
+            else if (m.type === "error") {
+                finish({
+                    kind: "error",
+                    error: {
+                        file: m.file ?? file,
+                        message: m.message ?? "unknown worker error",
+                        stack: m.stack,
+                    },
+                });
+            }
+        };
+        child.stderr?.on("data", (chunk) => {
+            const text = decoder.write(chunk);
+            stderrBuffer += text;
+            if (stderrBuffer.length > MAX_STDERR_BUFFER_BYTES) {
+                finish({
+                    kind: "error",
+                    error: {
+                        file,
+                        message: `worker stderr exceeded ${MAX_STDERR_BUFFER_BYTES} bytes without emitting a frame`,
+                    },
+                }, true);
+                return;
+            }
+            let nl = stderrBuffer.indexOf("\n");
+            while (nl >= 0 && !settled) {
+                const line = stderrBuffer.slice(0, nl);
+                stderrBuffer = stderrBuffer.slice(nl + 1);
+                processLine(line);
+                nl = stderrBuffer.indexOf("\n");
+            }
+        });
+        // Drain stdout so a chatty `console.log` can't fill the 64 KB pipe
+        // buffer and deadlock the worker. We don't currently surface it to
+        // the reporter (Phase 2 feature).
+        child.stdout?.on("data", () => { });
+        child.on("error", (err) => {
+            finish({
+                kind: "error",
+                error: { file, message: `spawn failed: ${err.message}` },
+            }, true);
+        });
+        child.on("exit", () => {
+            // If we already have an outcome waiting on the natural exit,
+            // resolve it now — coverage hooks have flushed.
+            if (pendingOutcome) {
+                settle(pendingOutcome);
+                return;
+            }
+            if (settled)
+                return;
+            // Flush any partial trailing line from the decoder before giving up.
+            const trailing = decoder.end();
+            if (trailing) {
+                stderrBuffer += trailing;
+                const nl = stderrBuffer.indexOf("\n");
+                if (nl >= 0)
+                    processLine(stderrBuffer.slice(0, nl));
+            }
+            if (pendingOutcome) {
+                settle(pendingOutcome);
+                return;
+            }
+            if (settled)
+                return;
+            settle({
+                kind: "error",
+                error: {
+                    file,
+                    message: "worker exited without emitting a framed result",
+                },
+            });
+        });
+        // Instruction line.
+        const instr = JSON.stringify({
+            type: "run",
+            file,
+            timeoutMs,
+            nonce,
+        });
+        // `child.stdin` may be closed by the time we get here (rare spawn race).
+        // Attach an error listener so an EPIPE doesn't crash the parent.
+        child.stdin?.on("error", (err) => {
+            finish({
+                kind: "error",
+                error: { file, message: `stdin write failed: ${err.message}` },
+            }, true);
+        });
+        child.stdin?.write(`${instr}\n`, () => {
+            child.stdin?.end();
+        });
+    });
+}
+/**
+ * Kill `child` with SIGTERM, escalate to SIGKILL after `graceMs`. On POSIX
+ * we target the process group (negative pid) so grand-children die too.
+ *
+ * Idempotent: further calls after the first are no-ops. If the child has
+ * already exited (cleanly or via an earlier kill), no signals are sent and
+ * no escalation timer is armed — which matters for large suites where a
+ * per-file 2s timer retains the `child` closure and creates GC pressure,
+ * and for Linux systems where pid reuse could deliver SIGKILL to the wrong
+ * process.
+ */
+const killedChildren = new WeakSet();
+function killChild(child, graceMs) {
+    if (killedChildren.has(child))
+        return;
+    killedChildren.add(child);
+    // If the child already exited on its own, nothing to do — no SIGTERM,
+    // no escalation timer.
+    if (child.killed || child.exitCode !== null || child.signalCode !== null) {
+        return;
+    }
+    const pid = child.pid;
+    const posix = process.platform !== "win32";
+    const trySignal = (signal) => {
+        // Re-check exit status on each signal to avoid pid-reuse races: the
+        // child may have exited between our initial check and this send.
+        if (child.exitCode !== null || child.signalCode !== null)
+            return;
+        try {
+            if (posix && typeof pid === "number") {
+                process.kill(-pid, signal);
+            }
+            else {
+                child.kill(signal);
+            }
+        }
+        catch {
+            /* already dead, permission denied, or process-group invalid */
+        }
+    };
+    trySignal("SIGTERM");
+    // Escalate after the grace window if the child is still alive. Cleared
+    // by `child.on("exit")` so a clean exit drops the timer immediately.
+    const escalation = setTimeout(() => {
+        trySignal("SIGKILL");
+    }, graceMs);
+    escalation.unref?.();
+    child.once("exit", () => clearTimeout(escalation));
+}
+//# sourceMappingURL=pool.js.map

package/dist/cli/pool.js.map

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

package/dist/cli/reporter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Reporters — receive lifecycle callbacks as each file completes, write
+ * incremental output to the given sink. Three built-ins matching the
+ * Rust-side reporter trait:
+ *   - Dot: one char per test
+ *   - Spec: nested tree with colours + diff lines on failure
+ *   - Json: NDJSON to stdout, machine-readable
+ */
+import type { FileResult } from "../runtime/run.js";
+import type { WorkerErrorMessage } from "./pool.js";
+import type { Summary } from "./summary.js";
+export interface Reporter {
+    onFileStart(file: string): void;
+    onFileResult(result: FileResult): void;
+    onFileError(error: WorkerErrorMessage): void;
+    onSummary(summary: Summary): void;
+}
+type Sink = {
+    write(chunk: string): void;
+    writeLine(chunk: string): void;
+};
+export declare function stdoutSink(): Sink;
+export declare class DotReporter implements Reporter {
+    private readonly sink;
+    constructor(sink?: Sink);
+    onFileStart(_file: string): void;
+    onFileResult(result: FileResult): void;
+    onFileError(_error: WorkerErrorMessage): void;
+    onSummary(summary: Summary): void;
+}
+export declare class SpecReporter implements Reporter {
+    private readonly sink;
+    private readonly useColors;
+    constructor(sink?: Sink, useColors?: boolean);
+    onFileStart(file: string): void;
+    onFileResult(result: FileResult): void;
+    onFileError(error: WorkerErrorMessage): void;
+    onSummary(summary: Summary): void;
+}
+export declare class JsonReporter implements Reporter {
+    private readonly sink;
+    constructor(sink?: Sink);
+    onFileStart(file: string): void;
+    onFileResult(result: FileResult): void;
+    onFileError(error: WorkerErrorMessage): void;
+    onSummary(summary: Summary): void;
+}
+/** Factory from a CLI-style name. */
+export declare function makeReporter(name: string | undefined, useColors: boolean): Reporter;
+export {};
+//# sourceMappingURL=reporter.d.ts.map

package/dist/cli/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/cli/reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,QAAQ;IACxB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC7C,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAED,KAAK,IAAI,GAAG;IACX,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,wBAAgB,UAAU,IAAI,IAAI,CASjC;AASD,qBAAa,WAAY,YAAW,QAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,IAAmB;IACtD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAChC,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAatC,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAG7C,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAIjC;AAED,qBAAa,YAAa,YAAW,QAAQ;IAE3C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,IAAI,GAAE,IAAmB,EACzB,SAAS,UAAO;IAElC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IA0BtC,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAM5C,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAIjC;AAED,qBAAa,YAAa,YAAW,QAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,IAAmB;IACtD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAG/B,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAGtC,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAG5C,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAGjC;AAWD,qCAAqC;AACrC,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,SAAS,EAAE,OAAO,GAChB,QAAQ,CASV"}