@claudexor/core 1.0.0

package/dist/proc.js

@@ -0,0 +1,283 @@
+import { spawn } from "node:child_process";
+import { registerChildProcess, unregisterChildProcess } from "./process-registry.js";
+import { createInterface } from "node:readline";
+import { composeBaseEnv } from "./env-scope.js";
+/**
+ * Spawn a process and stream stdout/stderr lines as they arrive, ending with an
+ * `exit` event. Throws (rejects the iterator) if the binary cannot be spawned
+ * (e.g. ENOENT) so callers can detect an unavailable harness.
+ */
+export async function* spawnProcess(cmd, args, opts = {}) {
+    const env = composeBaseEnv(opts.inheritEnv ?? "mirror_native");
+    for (const [key, value] of Object.entries(opts.env ?? {})) {
+        if (value === undefined || value === null)
+            delete env[key];
+        else
+            env[key] = value;
+    }
+    const child = spawn(cmd, args, {
+        cwd: opts.cwd,
+        env,
+        stdio: ["pipe", "pipe", "pipe"],
+        // Put the child in its own process group so we can signal the WHOLE tree.
+        // Harnesses spawn grandchildren (shell tools, MCP servers); without this a
+        // cancel/timeout signals only the direct child and grandchildren leak,
+        // keep writing to the worktree, or hang the run forever.
+        detached: true,
+    });
+    if (typeof child.pid === "number")
+        registerChildProcess(child.pid, cmd);
+    // Signal the child's process GROUP (negative pid) so grandchildren die too;
+    // fall back to the direct child if the group is already gone.
+    const killTree = (signal) => {
+        try {
+            if (typeof child.pid === "number")
+                process.kill(-child.pid, signal);
+            else
+                child.kill(signal);
+        }
+        catch {
+            try {
+                child.kill(signal);
+            }
+            catch {
+                /* already gone */
+            }
+        }
+    };
+    // A child can exit before/while stdin is written (e.g. a failing `git apply`).
+    // Without a handler the resulting EPIPE becomes an unhandled 'error' event and
+    // can crash the host process; the exit event already carries the real outcome.
+    child.stdin.on("error", () => { });
+    if (opts.input !== undefined) {
+        child.stdin.write(opts.input);
+    }
+    if (opts.keepStdinOpen) {
+        opts.onSpawn?.({
+            write: (data) => {
+                try {
+                    child.stdin.write(data);
+                }
+                catch {
+                    /* child already gone; exit event carries the outcome */
+                }
+            },
+            end: () => {
+                try {
+                    child.stdin.end();
+                }
+                catch {
+                    /* already closed */
+                }
+            },
+        });
+    }
+    else {
+        child.stdin.end();
+    }
+    const queue = [];
+    let wake = null;
+    let finished = false;
+    let spawnError = null;
+    const push = (e) => {
+        queue.push(e);
+        if (wake) {
+            wake();
+            wake = null;
+        }
+    };
+    const rlOut = createInterface({ input: child.stdout });
+    const rlErr = createInterface({ input: child.stderr });
+    rlOut.on("line", (line) => push({ type: "stdout", line }));
+    rlErr.on("line", (line) => push({ type: "stderr", line }));
+    child.on("error", (err) => {
+        if (typeof child.pid === "number")
+            unregisterChildProcess(child.pid);
+        spawnError = err;
+        finished = true;
+        if (wake) {
+            wake();
+            wake = null;
+        }
+    });
+    child.on("close", (code, signal) => {
+        if (typeof child.pid === "number")
+            unregisterChildProcess(child.pid);
+        push({ type: "exit", code, signal });
+        finished = true;
+        if (wake) {
+            wake();
+            wake = null;
+        }
+    });
+    let timer;
+    if (opts.timeoutMs && opts.timeoutMs > 0) {
+        timer = setTimeout(() => killTree("SIGKILL"), opts.timeoutMs);
+    }
+    let killTimer;
+    const requestCancel = () => {
+        if (finished)
+            return;
+        killTree(opts.cancelSignal ?? "SIGINT");
+        const killDelay = opts.cancelKillDelayMs ?? 1_000;
+        if (killDelay >= 0 && !killTimer) {
+            // Escalate to SIGKILL of the whole group if the cooperative signal is
+            // ignored. NOT unref'd: the escalation must actually fire (a prior
+            // unref let an ignoring child outlive the parent). It is cleared on a
+            // clean finish below.
+            killTimer = setTimeout(() => {
+                if (!finished)
+                    killTree("SIGKILL");
+            }, killDelay);
+        }
+    };
+    const abortSignal = opts.abortSignal;
+    if (abortSignal) {
+        if (abortSignal.aborted)
+            requestCancel();
+        else
+            abortSignal.addEventListener("abort", requestCancel, { once: true });
+    }
+    try {
+        for (;;) {
+            if (queue.length > 0) {
+                yield queue.shift();
+                continue;
+            }
+            if (spawnError)
+                throw spawnError;
+            if (finished)
+                return;
+            await new Promise((resolve) => {
+                wake = resolve;
+            });
+        }
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+        abortSignal?.removeEventListener("abort", requestCancel);
+        if (!finished) {
+            requestCancel();
+        }
+        if (finished && killTimer)
+            clearTimeout(killTimer);
+        rlOut.close();
+        rlErr.close();
+    }
+}
+/** Run a process to completion, capturing stdout/stderr. Throws on spawn error. */
+export async function runCapture(cmd, args, opts = {}) {
+    let stdout = "";
+    let stderr = "";
+    let code = null;
+    let signal = null;
+    for await (const ev of spawnProcess(cmd, args, opts)) {
+        if (ev.type === "stdout")
+            stdout += ev.line + "\n";
+        else if (ev.type === "stderr")
+            stderr += ev.line + "\n";
+        else {
+            code = ev.code;
+            signal = ev.signal;
+        }
+    }
+    return { code, signal, stdout, stderr };
+}
+/**
+ * BYTE-FAITHFUL capture: `runCapture` rides readline, which splits
+ * on lone `\r` too and rejoins with `\n` — destroying CR bytes in CRLF file
+ * content and fabricating trailing newlines. Diff-carrying git output MUST
+ * come through here, or `final/patch.diff` is corrupted at the source and
+ * fails `git apply` downstream. Raw buffers, no line splitting, no
+ * fabrication; the same spawn machinery (process group, abort, timeout).
+ */
+export async function runCaptureRaw(cmd, args, opts = {}) {
+    const env = composeBaseEnv(opts.inheritEnv ?? "mirror_native");
+    for (const [key, value] of Object.entries(opts.env ?? {})) {
+        if (value === undefined || value === null)
+            delete env[key];
+        else
+            env[key] = value;
+    }
+    const child = spawn(cmd, args, {
+        cwd: opts.cwd,
+        env,
+        stdio: ["pipe", "pipe", "pipe"],
+        detached: true,
+    });
+    if (typeof child.pid === "number")
+        registerChildProcess(child.pid, cmd);
+    const killTree = (signal) => {
+        try {
+            if (typeof child.pid === "number")
+                process.kill(-child.pid, signal);
+            else
+                child.kill(signal);
+        }
+        catch {
+            try {
+                child.kill(signal);
+            }
+            catch {
+                /* already gone */
+            }
+        }
+    };
+    child.stdin.on("error", () => { });
+    if (opts.input !== undefined)
+        child.stdin.write(opts.input);
+    child.stdin.end();
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    child.stdout.on("data", (c) => stdoutChunks.push(c));
+    child.stderr.on("data", (c) => stderrChunks.push(c));
+    let killTimer;
+    const requestCancel = () => {
+        killTree(opts.cancelSignal ?? "SIGINT");
+        const killDelay = opts.cancelKillDelayMs ?? 1_000;
+        if (killDelay >= 0 && !killTimer) {
+            killTimer = setTimeout(() => killTree("SIGKILL"), killDelay);
+            killTimer.unref?.();
+        }
+    };
+    let timer;
+    if (opts.timeoutMs && opts.timeoutMs > 0) {
+        timer = setTimeout(() => killTree("SIGKILL"), opts.timeoutMs);
+    }
+    const abortSignal = opts.abortSignal;
+    if (abortSignal) {
+        if (abortSignal.aborted)
+            requestCancel();
+        else
+            abortSignal.addEventListener("abort", requestCancel, { once: true });
+    }
+    try {
+        const [code, signal] = await new Promise((resolve, reject) => {
+            child.on("error", (err) => {
+                if (typeof child.pid === "number")
+                    unregisterChildProcess(child.pid);
+                reject(err);
+            });
+            child.on("close", (c, s) => {
+                if (typeof child.pid === "number")
+                    unregisterChildProcess(child.pid);
+                resolve([c, s]);
+            });
+        });
+        return {
+            code,
+            signal,
+            stdout: Buffer.concat(stdoutChunks).toString("utf8"),
+            stderr: Buffer.concat(stderrChunks).toString("utf8"),
+        };
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+        if (killTimer)
+            clearTimeout(killTimer);
+        abortSignal?.removeEventListener("abort", requestCancel);
+    }
+}
+//# sourceMappingURL=proc.js.map

package/dist/proc.js.map

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

package/dist/process-registry.d.ts

@@ -0,0 +1,8 @@
+export declare function registerChildProcess(pid: number, cmd: string): void;
+export declare function unregisterChildProcess(pid: number): void;
+/** Snapshot of currently-live child process groups: pid + command name. */
+export declare function liveChildProcesses(): {
+    pid: number;
+    cmd: string;
+}[];
+//# sourceMappingURL=process-registry.d.ts.map

package/dist/process-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-registry.d.ts","sourceRoot":"","sources":["../src/process-registry.ts"],"names":[],"mappings":"AAUA,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAEnE"}

package/dist/process-registry.js

@@ -0,0 +1,20 @@
+/**
+ * Passive registry of live harness child process groups. Every
+ * `spawnProcess` child registers on spawn and unregisters on close; the
+ * daemon snapshots the registry into a pids file so a crashed/killed daemon
+ * can REAP surviving orphans on the next start (children live in their own
+ * process groups by design, so they outlive the daemon). Purely
+ * observational: adapters gain no orchestration behavior.
+ */
+const live = new Map();
+export function registerChildProcess(pid, cmd) {
+    live.set(pid, cmd);
+}
+export function unregisterChildProcess(pid) {
+    live.delete(pid);
+}
+/** Snapshot of currently-live child process groups: pid + command name. */
+export function liveChildProcesses() {
+    return [...live.entries()].map(([pid, cmd]) => ({ pid, cmd }));
+}
+//# sourceMappingURL=process-registry.js.map

package/dist/process-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-registry.js","sourceRoot":"","sources":["../src/process-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEvC,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,GAAW;IAC3D,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/dist/runloop.d.ts

@@ -0,0 +1,35 @@
+import type { HarnessEvent, HarnessRunSpec } from "@claudexor/schema";
+import { type ChildStdin } from "./proc.js";
+export declare function abortSignalFromSpec(spec: HarnessRunSpec): AbortSignal | undefined;
+export interface CliRunLoopOptions {
+    bin: string;
+    args: string[];
+    spec: HarnessRunSpec;
+    /**
+     * Translate one parsed JSON stdout object into normalized events.
+     * Return `null` for UNRECOGNIZED shapes (counted as dropped) and `[]` for
+     * recognized-but-intentionally-skipped events (progress ticks etc.).
+     */
+    parseEvent: (obj: unknown, sessionId: string) => HarnessEvent[] | null;
+    env?: Record<string, string | null | undefined>;
+    /** Label used in synthesized error messages; defaults to `bin`. */
+    label?: string;
+    /** Redactor applied to stderr detail before it is surfaced. */
+    redact?: (text: string) => string;
+    /**
+     * Bidirectional session support (e.g. Claude's stream-json control
+     * protocol). When set, stdin stays open, `initialStdin` is written at spawn,
+     * frames matching `matches` are routed to `handle` (an async generator that
+     * may yield normalized events and write control responses via the stdin
+     * handle), and stdin is closed when `closeStdinOn` matches a frame —
+     * the cooperative end of a streaming session.
+     */
+    session?: {
+        initialStdin?: string;
+        matches: (obj: unknown) => boolean;
+        handle: (obj: unknown, io: ChildStdin) => AsyncGenerator<HarnessEvent>;
+        closeStdinOn?: (obj: unknown) => boolean;
+    };
+}
+export declare function runCliHarness(opts: CliRunLoopOptions): AsyncGenerator<HarnessEvent>;
+//# sourceMappingURL=runloop.d.ts.map

package/dist/runloop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runloop.d.ts","sourceRoot":"","sources":["../src/runloop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAwB1D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,GAAG,SAAS,CAOjF;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB;;;;OAIG;IACH,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,YAAY,EAAE,GAAG,IAAI,CAAC;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAChD,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;QACnC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,KAAK,cAAc,CAAC,YAAY,CAAC,CAAC;QACvE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;KAC1C,CAAC;CACH;AAED,wBAAuB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAAC,YAAY,CAAC,CAqH1F"}

package/dist/runloop.js

@@ -0,0 +1,156 @@
+import { spawnProcess } from "./proc.js";
+/**
+ * Shared CLI adapter run loop.
+ *
+ * Every local-CLI adapter (claude/codex/cursor/opencode) streams NDJSON from a
+ * spawned binary and translates lines into normalized HarnessEvents. This loop
+ * owns the parts that previously drifted between four copy-pasted variants:
+ *
+ * - stderr is captured (bounded ring buffer) and surfaced on failure instead of
+ *   being silently dropped;
+ * - unparseable stdout lines and recognized-but-unmapped native events are
+ *   COUNTED and reported on the terminal `completed` event payload
+ *   (`dropped_unparsed_lines` / `dropped_unrecognized_events`), never silently
+ *   discarded;
+ * - a terminal `completed` event is guaranteed exactly once on every path
+ *   (clean exit, nonzero exit, spawn failure, abort);
+ * - abort is honored via the duck-typed AbortSignal smuggled in `spec.extra`
+ *   (instanceof checks break across module realms).
+ */
+const STDERR_RING_MAX = 40;
+const STDERR_DETAIL_MAX = 1000;
+export function abortSignalFromSpec(spec) {
+    const signal = spec.extra?.["abortSignal"];
+    if (!signal || typeof signal !== "object")
+        return undefined;
+    const candidate = signal;
+    return typeof candidate.aborted === "boolean" && typeof candidate.addEventListener === "function"
+        ? signal
+        : undefined;
+}
+export async function* runCliHarness(opts) {
+    const { spec } = opts;
+    const label = opts.label ?? opts.bin;
+    const redact = opts.redact ?? ((text) => text);
+    const ts = () => new Date().toISOString();
+    const stderrRing = [];
+    let droppedUnparsedLines = 0;
+    let droppedUnrecognizedEvents = 0;
+    let sawError = false;
+    let exitCode = null;
+    let exitSignal = null;
+    const abortSignal = abortSignalFromSpec(spec);
+    const stderrTail = () => redact(stderrRing.join("\n")).slice(-STDERR_DETAIL_MAX).trim();
+    // Box the stdin handle: it is assigned inside the onSpawn callback, which
+    // TypeScript's control-flow narrowing cannot see through a plain let.
+    const session = { io: null };
+    try {
+        for await (const ev of spawnProcess(opts.bin, opts.args, {
+            cwd: spec.cwd,
+            env: opts.env,
+            inheritEnv: spec.env_inheritance,
+            abortSignal,
+            ...(opts.session
+                ? {
+                    keepStdinOpen: true,
+                    onSpawn: (io) => {
+                        session.io = io;
+                        if (opts.session?.initialStdin)
+                            io.write(opts.session.initialStdin);
+                    },
+                }
+                : {}),
+        })) {
+            if (ev.type === "stderr") {
+                stderrRing.push(ev.line);
+                if (stderrRing.length > STDERR_RING_MAX)
+                    stderrRing.shift();
+                continue;
+            }
+            if (ev.type === "exit") {
+                exitCode = ev.code;
+                exitSignal = ev.signal;
+                continue;
+            }
+            let obj;
+            try {
+                obj = JSON.parse(ev.line);
+            }
+            catch {
+                droppedUnparsedLines += 1;
+                continue;
+            }
+            if (opts.session && session.io && opts.session.matches(obj)) {
+                for await (const out of opts.session.handle(obj, session.io)) {
+                    if (out.type === "error")
+                        sawError = true;
+                    yield out;
+                }
+                continue;
+            }
+            const events = opts.parseEvent(obj, spec.session_id);
+            if (opts.session && session.io && opts.session.closeStdinOn?.(obj)) {
+                // The native terminal frame arrived; close stdin so the streaming
+                // session ends cooperatively instead of waiting for more input.
+                session.io.end();
+                session.io = null;
+            }
+            if (events === null) {
+                droppedUnrecognizedEvents += 1;
+                continue;
+            }
+            for (const out of events) {
+                if (out.type === "error")
+                    sawError = true;
+                yield out;
+            }
+        }
+    }
+    catch (err) {
+        sawError = true;
+        yield {
+            type: "error",
+            session_id: spec.session_id,
+            ts: ts(),
+            error: `${label} failed to start: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    finally {
+        session.io?.end();
+        session.io = null;
+    }
+    const aborted = abortSignal?.aborted === true;
+    if (!sawError && !aborted && exitCode !== null && exitCode !== 0) {
+        const tail = stderrTail();
+        yield {
+            type: "error",
+            session_id: spec.session_id,
+            ts: ts(),
+            error: `${label} exited with code ${exitCode}${tail ? `: ${tail}` : ""}`,
+        };
+    }
+    else if (!sawError && !aborted && exitCode === null && exitSignal) {
+        yield {
+            type: "error",
+            session_id: spec.session_id,
+            ts: ts(),
+            error: `${label} was killed by signal ${exitSignal}`,
+        };
+    }
+    const payload = {};
+    if (droppedUnparsedLines > 0)
+        payload["dropped_unparsed_lines"] = droppedUnparsedLines;
+    if (droppedUnrecognizedEvents > 0)
+        payload["dropped_unrecognized_events"] = droppedUnrecognizedEvents;
+    if (aborted)
+        payload["aborted"] = true;
+    if (exitCode !== null)
+        payload["exit_code"] = exitCode;
+    yield {
+        type: "completed",
+        session_id: spec.session_id,
+        ts: ts(),
+        ...(Object.keys(payload).length > 0 ? { payload } : {}),
+    };
+}
+//# sourceMappingURL=runloop.js.map

package/dist/runloop.js.map

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

package/dist/runtime-env.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Single producer for the PATH every local harness discovery/run surface should
+ * use. Surfaces may still inherit other env vars, but binary resolution must not
+ * depend on whether the daemon was launched from a GUI app, login shell, or CLI.
+ */
+export declare function normalizedHarnessPath(source?: NodeJS.ProcessEnv): string;
+export declare function harnessRuntimeEnv(source?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/**
+ * Advisory when the Node binary running Claudexor is one macOS's code-signing
+ * monitor is known to SIGKILL (Homebrew's adhoc-signed node). The daemon spawns
+ * its harness children with this same execPath, so a GUI/launchd-launched daemon
+ * on at-risk node can die mid-run. Returns null when not applicable. Diagnostic
+ * only (doctor surfaces it); never gates a run.
+ */
+export declare function atRiskNodeAdvisory(execPath?: string, platform?: NodeJS.Platform): string | null;
+//# sourceMappingURL=runtime-env.d.ts.map

package/dist/runtime-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-env.d.ts","sourceRoot":"","sources":["../src/runtime-env.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAuBrF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,CAE5F;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,MAAyB,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,GAAG,IAAI,CAKnI"}

package/dist/runtime-env.js

@@ -0,0 +1,51 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Single producer for the PATH every local harness discovery/run surface should
+ * use. Surfaces may still inherit other env vars, but binary resolution must not
+ * depend on whether the daemon was launched from a GUI app, login shell, or CLI.
+ */
+export function normalizedHarnessPath(source = process.env) {
+    const home = source.HOME || homedir();
+    const preferred = [
+        join(home, ".claudexor", "node", "bin"),
+        join(home, ".local", "bin"),
+        join(home, ".npm-global", "bin"),
+        join(home, ".bun", "bin"),
+        "/opt/homebrew/bin",
+        "/usr/local/bin",
+        "/usr/bin",
+        "/bin",
+        "/usr/sbin",
+        "/sbin",
+    ];
+    const inherited = (source.PATH ?? "").split(":").filter(Boolean);
+    const seen = new Set();
+    return [...preferred, ...inherited]
+        .filter((entry) => {
+        if (!entry || seen.has(entry))
+            return false;
+        seen.add(entry);
+        return true;
+    })
+        .join(":");
+}
+export function harnessRuntimeEnv(source = process.env) {
+    return { ...source, PATH: normalizedHarnessPath(source) };
+}
+/**
+ * Advisory when the Node binary running Claudexor is one macOS's code-signing
+ * monitor is known to SIGKILL (Homebrew's adhoc-signed node). The daemon spawns
+ * its harness children with this same execPath, so a GUI/launchd-launched daemon
+ * on at-risk node can die mid-run. Returns null when not applicable. Diagnostic
+ * only (doctor surfaces it); never gates a run.
+ */
+export function atRiskNodeAdvisory(execPath = process.execPath, platform = process.platform) {
+    if (platform !== "darwin")
+        return null;
+    const atRisk = execPath.includes("/Cellar/node") || execPath.startsWith("/opt/homebrew/") || execPath.startsWith("/usr/local/Cellar/");
+    if (!atRisk)
+        return null;
+    return `node at ${execPath} is Homebrew-signed and may be SIGKILLed by macOS; install a notarized Node (e.g. under ~/.claudexor/node/bin) and put it first on PATH`;
+}
+//# sourceMappingURL=runtime-env.js.map

package/dist/runtime-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-env.js","sourceRoot":"","sources":["../src/runtime-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAA4B,OAAO,CAAC,GAAG;IAC3E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG;QAChB,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC;QACzB,mBAAmB;QACnB,gBAAgB;QAChB,UAAU;QACV,MAAM;QACN,WAAW;QACX,OAAO;KACR,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC;SAChC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAA4B,OAAO,CAAC,GAAG;IACvE,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,OAAO,CAAC,QAAQ,EAAE,WAA4B,OAAO,CAAC,QAAQ;IAClH,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACvI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,WAAW,QAAQ,yIAAyI,CAAC;AACtK,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@claudexor/core",
+  "version": "1.0.0",
+  "license": "MIT",
+  "description": "HarnessAdapter contract, process helpers, typed errors, and low-level execution utilities.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@claudexor/schema": "1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/razzant/claudexor.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/razzant/claudexor#readme",
+  "bugs": {
+    "url": "https://github.com/razzant/claudexor/issues"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}