@xioflow/kernel 0.4.0 → 0.5.0

package/dist/driver/reaper-driver.js

@@ -0,0 +1,371 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { NodePlatformDriver } from './node-driver.js';
+import { readStartTime } from './process-facts.js';
+import { computeCommandFingerprint, resolveExecutable } from './spawn-support.js';
+const HELPER_NAME = 'xioflow-reaper';
+/**
+ * 解析当前平台的 reaper helper：`XIOFLOW_REAPER_PATH` 优先，否则取包内
+ * `dist/native/<platform>-<arch>/xioflow-reaper`。找不到或不可执行时返回 null。
+ */
+export function locateReaperHelper() {
+    const candidates = [
+        process.env.XIOFLOW_REAPER_PATH,
+        path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../native', `${process.platform}-${process.arch}`, HELPER_NAME),
+    ];
+    for (const candidate of candidates) {
+        if (!candidate)
+            continue;
+        try {
+            fs.accessSync(candidate, fs.constants.X_OK);
+            return candidate;
+        }
+        catch { }
+    }
+    return null;
+}
+/**
+ * 以原生 helper 持有进程树的平台驱动（Linux / macOS）。
+ *
+ * - Linux：helper 是子收割者，孤儿（setsid、双 fork）必然回到它名下；停止经 pidfd 发信号，
+ *   以 waitpid ECHILD 证明整棵树已空（scope `subreaper_tree`）。
+ * - macOS：没有子收割者，helper 用 kqueue NOTE_FORK + 会话成员跟踪后代（scope `tracked_tree`）；
+ *   已脱离会话又失去父链的逃逸者仍可能漏掉，输出管道持有检测继续兜底。
+ * - 监督进程消失（控制通道 EOF）时 helper 停掉整棵树，不留无人监督的进程。
+ *
+ * 崩溃恢复所需的身份核验、进程组清场与指标采样沿用操作系统事实（与 NodePlatformDriver 同源），
+ * 因此两种驱动写下的身份可以互相裁决。
+ */
+export class ReaperPlatformDriver {
+    name = 'reaper';
+    capabilities;
+    helperPath;
+    stopReplyMarginMs;
+    facts = new NodePlatformDriver();
+    sessions = new Map();
+    static isAvailable() {
+        return (process.platform === 'linux' || process.platform === 'darwin') && locateReaperHelper() !== null;
+    }
+    constructor(options = {}) {
+        if (process.platform !== 'linux' && process.platform !== 'darwin') {
+            throw new Error(`ReaperPlatformDriver supports Linux and macOS only (got ${process.platform})`);
+        }
+        const helperPath = options.helperPath ?? locateReaperHelper();
+        if (!helperPath) {
+            throw new Error(`${HELPER_NAME} is not available for ${process.platform}-${process.arch}; ` +
+                'build it with `node scripts/build-native.mjs` or set XIOFLOW_REAPER_PATH');
+        }
+        this.helperPath = helperPath;
+        this.stopReplyMarginMs = options.stopReplyMarginMs ?? 2000;
+        this.capabilities = {
+            ...this.facts.capabilities,
+            processGroupKill: true,
+            gatedSpawn: true,
+            descendantEnumeration: process.platform === 'linux' ? 'subreaper' : 'full',
+        };
+    }
+    async readBootId() {
+        return this.facts.readBootId();
+    }
+    async getGroupEvidence(pgid) {
+        return this.facts.getGroupEvidence(pgid);
+    }
+    async terminateGroup(pgid, graceMs = 2000) {
+        return this.facts.terminateGroup(pgid, graceMs);
+    }
+    async sampleMetrics(identity) {
+        return this.facts.sampleMetrics(identity);
+    }
+    async spawn(command) {
+        const childEnv = command.envWhiteList
+            ? { ...command.envWhiteList }
+            : command.inheritEnv === false
+                ? {}
+                : process.env;
+        // 与 NodePlatformDriver 相同：启动前确认可执行文件存在，缺失即显式失败（契约 #1）
+        if (!resolveExecutable(command.execPath, childEnv.PATH)) {
+            const err = new Error(`spawn ${command.execPath} ENOENT`);
+            Object.assign(err, { code: 'ENOENT', syscall: `spawn ${command.execPath}`, path: command.execPath });
+            throw err;
+        }
+        const stdinPayload = command.stdin === undefined
+            ? undefined
+            : typeof command.stdin === 'string'
+                ? Buffer.from(command.stdin, 'utf8')
+                : Buffer.from(command.stdin);
+        const isStreamStdin = command.stdinMode === 'stream';
+        const helper = spawn(this.helperPath, [command.execPath, ...command.args], {
+            cwd: command.cwd,
+            env: childEnv,
+            detached: true,
+            stdio: [isStreamStdin || stdinPayload !== undefined ? 'pipe' : 'ignore', 'pipe', 'pipe', 'pipe'],
+        });
+        const rootPid = await this.awaitSpawned(helper);
+        const session = this.openSession(helper, rootPid);
+        const bootId = await this.facts.readBootId();
+        // root 此刻阻塞在门上，exec 不改变创建时间：读到的就是目标程序的 OS 创建时间
+        const osStartTimeMs = await readStartTime(rootPid);
+        const identity = {
+            pid: rootPid,
+            pgid: rootPid,
+            startTimeMonotonic: Number(process.hrtime.bigint() / 1000n),
+            spawnTime: new Date().toISOString(),
+            osStartTime: osStartTimeMs !== null ? new Date(osStartTimeMs).toISOString() : undefined,
+            commandFingerprint: computeCommandFingerprint(command.execPath, command.args),
+            bootId: bootId ?? undefined,
+        };
+        this.writeStdin(helper, isStreamStdin, stdinPayload);
+        let gateSettled = false;
+        const sendGate = (line) => {
+            if (gateSettled)
+                return;
+            gateSettled = true;
+            this.send(session, line);
+        };
+        return {
+            identity,
+            stdin: isStreamStdin ? (helper.stdin ?? undefined) : undefined,
+            stdout: helper.stdout,
+            stderr: helper.stderr,
+            onRootExit: this.rootExitPromise(session),
+            onExit: new Promise((resolve) => {
+                // close：helper 退出且目标继承的输出管道全部关闭（与 NodePlatformDriver 的 close 语义一致）
+                helper.on('close', () => resolve(session.rootExit ?? { exitCode: null, signal: null }));
+            }),
+            rawProcess: {
+                pid: rootPid,
+                helperPid: helper.pid,
+                // root 未被 helper 回收前 pid 不会被复用，由 helper 代发信号
+                kill: (signal = 'SIGTERM') => {
+                    const signo = typeof signal === 'number' ? signal : os.constants.signals[signal];
+                    this.send(session, `signal ${signo}`);
+                    return true;
+                },
+            },
+            releaseGate: () => sendGate('go'),
+            destroyGate: () => sendGate('abort'),
+        };
+    }
+    async verifyIdentity(identity) {
+        const session = this.sessions.get(identity.pid);
+        if (session && !session.helperLost) {
+            // helper 是 root 的父进程：未回收之前 pid 不可能被复用，内存事实即可判定
+            return session.rootExit ? 'not_original_process' : 'is_original_process';
+        }
+        return this.facts.verifyIdentity(identity);
+    }
+    async terminate(identity, graceMs = 2000) {
+        const session = this.sessions.get(identity.pid);
+        if (!session || session.helperLost) {
+            // 不是本驱动持有的树（例如恢复期接手旧进程）或 helper 已丢失：只能退回操作系统事实
+            return this.facts.terminate(identity, graceMs);
+        }
+        if (session.treeEmpty) {
+            return { stopped: 'confirmed_stopped', scope: this.treeScope() };
+        }
+        session.stopPromise ??= this.requestStop(session, graceMs);
+        return session.stopPromise;
+    }
+    treeScope() {
+        return process.platform === 'linux' ? 'subreaper_tree' : 'tracked_tree';
+    }
+    async requestStop(session, graceMs) {
+        const reply = this.awaitStopReply(session, graceMs + 3000 + this.stopReplyMarginMs);
+        this.send(session, `stop ${Math.max(0, Math.floor(graceMs))}`);
+        const line = await reply;
+        session.stopPromise = undefined;
+        if (line === 'stopped') {
+            session.treeEmpty = true;
+            return { stopped: 'confirmed_stopped', scope: this.treeScope() };
+        }
+        if (line?.startsWith('residual ')) {
+            const residualPids = line
+                .slice('residual '.length)
+                .split(',')
+                .map(Number)
+                .filter((pid) => Number.isInteger(pid) && pid > 0);
+            return {
+                stopped: 'cannot_determine',
+                scope: 'unknown',
+                residualPids,
+                errorDetails: `${HELPER_NAME} could not empty the process tree; still alive: ${residualPids.join(', ')}`,
+            };
+        }
+        return {
+            stopped: 'cannot_determine',
+            scope: 'unknown',
+            errorDetails: session.helperLost
+                ? `${HELPER_NAME} exited before confirming the stop${session.lastError ? `: ${session.lastError}` : ''}`
+                : `${HELPER_NAME} did not answer the stop request in time`,
+        };
+    }
+    /** 等待第一条 `spawned <pid>`；helper 启动失败或先报错都显式拒绝。 */
+    awaitSpawned(helper) {
+        return new Promise((resolve, reject) => {
+            const ctl = helper.stdio[3];
+            let buffered = '';
+            const fail = (err) => {
+                cleanup();
+                reject(err);
+            };
+            const onData = (chunk) => {
+                buffered += chunk.toString('utf8');
+                const nl = buffered.indexOf('\n');
+                if (nl < 0)
+                    return;
+                const line = buffered.slice(0, nl);
+                cleanup();
+                const match = /^spawned (\d+)$/.exec(line);
+                if (!match) {
+                    helper.kill('SIGKILL');
+                    reject(new Error(`${HELPER_NAME} failed to start the process: ${line}`));
+                    return;
+                }
+                // 首行之后的内容交给会话解析
+                if (buffered.length > nl + 1)
+                    ctl.unshift(Buffer.from(buffered.slice(nl + 1)));
+                resolve(Number(match[1]));
+            };
+            const onError = (err) => fail(err);
+            const onExit = (code, signal) => fail(new Error(`${HELPER_NAME} exited before spawning (code=${code}, signal=${signal})`));
+            const cleanup = () => {
+                ctl.off('data', onData);
+                helper.off('error', onError);
+                helper.off('exit', onExit);
+            };
+            ctl.on('data', onData);
+            helper.once('error', onError);
+            helper.once('exit', onExit);
+        });
+    }
+    openSession(helper, rootPid) {
+        const session = {
+            helper,
+            ctl: helper.stdio[3],
+            rootPid,
+            rootExitListeners: [],
+            treeEmpty: false,
+            helperLost: false,
+        };
+        this.sessions.set(rootPid, session);
+        let buffered = '';
+        session.ctl.on('data', (chunk) => {
+            buffered += chunk.toString('utf8');
+            let nl;
+            while ((nl = buffered.indexOf('\n')) >= 0) {
+                const line = buffered.slice(0, nl);
+                buffered = buffered.slice(nl + 1);
+                this.onLine(session, line);
+            }
+        });
+        session.ctl.on('error', () => { });
+        // 以通道关闭为准而不是 helper 的 exit 事件：close 之前通道里的应答已全部读完
+        session.ctl.on('close', () => {
+            if (!session.treeEmpty)
+                session.helperLost = true;
+            session.onStopReply?.(null);
+            if (session.treeEmpty)
+                this.sessions.delete(rootPid);
+            if (!session.rootExit)
+                this.watchOrphanedRoot(session);
+        });
+        return session;
+    }
+    onLine(session, line) {
+        const exit = /^exit (-|\d+) (-|\d+)$/.exec(line);
+        if (exit) {
+            const facts = {
+                exitCode: exit[1] === '-' ? null : Number(exit[1]),
+                signal: exit[2] === '-' ? null : signalName(Number(exit[2])),
+            };
+            session.rootExit = facts;
+            for (const listener of session.rootExitListeners.splice(0))
+                listener(facts);
+            // root 已结束：剩余后代由 helper 继续持有，不再阻止宿主进程退出（宿主退出即 EOF，helper 清场）
+            session.helper.unref();
+            session.ctl.unref();
+        }
+        else if (line === 'empty') {
+            session.treeEmpty = true;
+        }
+        else if (line === 'stopped' || line.startsWith('residual ')) {
+            session.onStopReply?.(line);
+        }
+        else if (line.startsWith('error ')) {
+            session.lastError = line.slice('error '.length);
+        }
+    }
+    rootExitPromise(session) {
+        return new Promise((resolve) => {
+            if (session.rootExit)
+                resolve(session.rootExit);
+            else
+                session.rootExitListeners.push(resolve);
+        });
+    }
+    /** helper 丢失而 root 退出事实未知：不编造退出码，只观察 root 何时不再存活。 */
+    watchOrphanedRoot(session) {
+        const timer = setInterval(() => {
+            if (isPidAlive(session.rootPid))
+                return;
+            clearInterval(timer);
+            const facts = { exitCode: null, signal: null };
+            for (const listener of session.rootExitListeners.splice(0))
+                listener(facts);
+        }, 100);
+        timer.unref();
+    }
+    awaitStopReply(session, timeoutMs) {
+        return new Promise((resolve) => {
+            if (session.helperLost) {
+                resolve(null);
+                return;
+            }
+            const timer = setTimeout(() => settle(null), timeoutMs);
+            const settle = (line) => {
+                clearTimeout(timer);
+                session.onStopReply = undefined;
+                resolve(line);
+            };
+            session.onStopReply = settle;
+        });
+    }
+    send(session, line) {
+        if (session.ctl.destroyed)
+            return;
+        try {
+            session.ctl.write(`${line}\n`);
+        }
+        catch { }
+    }
+    writeStdin(helper, isStream, payload) {
+        if (!helper.stdin)
+            return;
+        helper.stdin.on('error', () => { });
+        if (isStream) {
+            if (payload !== undefined)
+                helper.stdin.write(payload);
+        }
+        else if (payload !== undefined) {
+            // 一次性 stdin：写入后关闭。子进程不读就退出的 EPIPE 不是启动失败，由退出码体现。
+            helper.stdin.end(payload);
+        }
+    }
+}
+function signalName(signo) {
+    const signals = os.constants.signals;
+    return Object.keys(signals).find((name) => signals[name] === signo) ?? null;
+}
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === 'EPERM';
+    }
+}
+//# sourceMappingURL=reaper-driver.js.map

package/dist/driver/reaper-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reaper-driver.js","sourceRoot":"","sources":["../../src/driver/reaper-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAUzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIlF,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,GAAG,CAAC,mBAAmB;QAC/B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC;KAC5H,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AA2BD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oBAAoB;IACf,IAAI,GAAG,QAAQ,CAAC;IAChB,YAAY,CAAuB;IAClC,UAAU,CAAS;IACnB,iBAAiB,CAAS;IAC1B,KAAK,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACjC,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEtD,MAAM,CAAC,WAAW;QACvB,OAAO,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,kBAAkB,EAAE,KAAK,IAAI,CAAC;IAC1G,CAAC;IAED,YAAY,OAAO,GAAwB,EAAE;QAC3C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,2DAA2D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClG,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,EAAE,CAAC;QAC9D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,GAAG,WAAW,yBAAyB,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,IAAI;gBACzE,0EAA0E,CAC7E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;QAC3D,IAAI,CAAC,YAAY,GAAG;YAClB,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY;YAC1B,gBAAgB,EAAE,IAAI;YACtB,UAAU,EAAE,IAAI;YAChB,qBAAqB,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;SAC3E,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,IAAY;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,OAAO,GAAW,IAAI;QAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,QAAyB;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,OAA0B;QAC3C,MAAM,QAAQ,GAAsB,OAAO,CAAC,YAAY;YACtD,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE;YAC7B,CAAC,CAAC,OAAO,CAAC,UAAU,KAAK,KAAK;gBAC5B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QAClB,sDAAsD;QACtD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,SAAS,OAAO,CAAC,QAAQ,SAAS,CAAC,CAAC;YAC1D,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACrG,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,YAAY,GAChB,OAAO,CAAC,KAAK,KAAK,SAAS;YACzB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;gBACjC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;gBACpC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC;QACrD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE;YACzE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,aAAa,IAAI,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SACjG,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAC7C,+CAA+C;QAC/C,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAoB;YAChC,GAAG,EAAE,OAAO;YACZ,IAAI,EAAE,OAAO;YACb,kBAAkB,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC;YAC3D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW,EAAE,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;YACvF,kBAAkB,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC;YAC7E,MAAM,EAAE,MAAM,IAAI,SAAS;SAC5B,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;QACrD,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE;YAChC,IAAI,WAAW;gBAAE,OAAO;YACxB,WAAW,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC;QAEF,OAAO;YACL,QAAQ;YACR,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YAC9D,MAAM,EAAE,MAAM,CAAC,MAAO;YACtB,MAAM,EAAE,MAAM,CAAC,MAAO;YACtB,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;YACzC,MAAM,EAAE,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;gBACzC,mEAAmE;gBACnE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1F,CAAC,CAAC;YACF,UAAU,EAAE;gBACV,GAAG,EAAE,OAAO;gBACZ,SAAS,EAAE,MAAM,CAAC,GAAG;gBACrB,6CAA6C;gBAC7C,IAAI,EAAE,CAAC,MAAM,GAA4B,SAAS,EAAE,EAAE;oBACpD,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;oBACjF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;oBACtC,OAAO,IAAI,CAAC;gBACd,CAAC;aACF;YACD,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjC,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;SACrC,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,QAAyB;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACnC,+CAA+C;YAC/C,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,qBAAqB,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,QAAyB,EAAE,OAAO,GAAW,IAAI;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACnC,+CAA+C;YAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,CAAC,WAAW,KAAK,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,OAAO,CAAC,WAAW,CAAC;IAC7B,CAAC;IAEO,SAAS;QACf,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,OAAsB,EAAE,OAAe;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC;QACzB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,MAAM,YAAY,GAAG,IAAI;iBACtB,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC;iBACzB,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,MAAM,CAAC;iBACX,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;YACrD,OAAO;gBACL,OAAO,EAAE,kBAAkB;gBAC3B,KAAK,EAAE,SAAS;gBAChB,YAAY;gBACZ,YAAY,EAAE,GAAG,WAAW,mDAAmD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACzG,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,OAAO,CAAC,UAAU;gBAC9B,CAAC,CAAC,GAAG,WAAW,qCAAqC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;gBACxG,CAAC,CAAC,GAAG,WAAW,0CAA0C;SAC7D,CAAC;IACJ,CAAC;IAED,kDAAkD;IAC1C,YAAY,CAAC,MAAoB;QACvC,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAA0B,CAAC;YACrD,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,CAAC,GAAU,EAAE,EAAE;gBAC1B,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC;YACF,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;gBAC/B,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,EAAE,GAAG,CAAC;oBAAE,OAAO;gBACnB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnC,OAAO,EAAE,CAAC;gBACV,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACvB,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,WAAW,iCAAiC,IAAI,EAAE,CAAC,CAAC,CAAC;oBACzE,OAAO;gBACT,CAAC;gBACD,gBAAgB;gBAChB,IAAI,QAAQ,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC;oBAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,CAAC,GAAU,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,CAAC,IAAmB,EAAE,MAA6B,EAAE,EAAE,CACpE,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,WAAW,iCAAiC,IAAI,YAAY,MAAM,GAAG,CAAC,CAAC,CAAC;YAC5F,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACxB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7B,CAAC,CAAC;YACF,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,MAAoB,EAAE,OAAe;QACvD,MAAM,OAAO,GAAkB;YAC7B,MAAM;YACN,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAsB;YACzC,OAAO;YACP,iBAAiB,EAAE,EAAE;YACrB,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,KAAK;SAClB,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEpC,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACvC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,EAAU,CAAC;YACf,OAAO,CAAC,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClC,kDAAkD;QAClD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,OAAO,CAAC,SAAS;gBAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;YAClD,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,OAAO,CAAC,SAAS;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAAE,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,MAAM,CAAC,OAAsB,EAAE,IAAY;QACjD,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,KAAK,GAAc;gBACvB,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClD,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;aAC7D,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;YACzB,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;gBAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC5E,6DAA6D;YAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;QAC3B,CAAC;aAAM,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9D,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,OAAsB;QAC5C,OAAO,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;YACxC,IAAI,OAAO,CAAC,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;;gBAC3C,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qDAAqD;IAC7C,iBAAiB,CAAC,OAAsB;QAC9C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,IAAI,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,OAAO;YACxC,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,MAAM,KAAK,GAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YAC1D,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;gBAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9E,CAAC,EAAE,GAAG,CAAC,CAAC;QACR,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAEO,cAAc,CAAC,OAAsB,EAAE,SAAiB;QAC9D,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;YAC5C,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,CAAC,IAAmB,EAAE,EAAE;gBACrC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC;YACF,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,IAAI,CAAC,OAAsB,EAAE,IAAY;QAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS;YAAE,OAAO;QAClC,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAEO,UAAU,CAAC,MAAoB,EAAE,QAAiB,EAAE,OAA2B;QACrF,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO;QAC1B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,iDAAiD;YACjD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,OAAiC,CAAC;IAC/D,OAAQ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAgC,IAAI,IAAI,CAAC;AAC9G,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/driver/spawn-support.d.ts

@@ -0,0 +1,4 @@
+/** execPath + args 的 sha256；JSON 编码保证参数边界（空格、冒号）不会造成碰撞。 */
+export declare function computeCommandFingerprint(execPath: string, args: string[]): string;
+export declare function resolveExecutable(bin: string, envPath?: string): string | null;
+//# sourceMappingURL=spawn-support.d.ts.map

package/dist/driver/spawn-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-support.d.ts","sourceRoot":"","sources":["../../src/driver/spawn-support.ts"],"names":[],"mappings":"AAIA,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAElF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB9E"}

package/dist/driver/spawn-support.js

@@ -0,0 +1,31 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+/** execPath + args 的 sha256；JSON 编码保证参数边界（空格、冒号）不会造成碰撞。 */
+export function computeCommandFingerprint(execPath, args) {
+    return createHash('sha256').update(JSON.stringify([execPath, ...args])).digest('hex');
+}
+export function resolveExecutable(bin, envPath) {
+    if (bin.includes(path.sep)) {
+        try {
+            fs.accessSync(bin, fs.constants.X_OK);
+            return bin;
+        }
+        catch {
+            return null;
+        }
+    }
+    const dirs = (envPath || process.env.PATH || '').split(path.delimiter);
+    for (const dir of dirs) {
+        if (!dir)
+            continue;
+        const full = path.join(dir, bin);
+        try {
+            fs.accessSync(full, fs.constants.X_OK);
+            return full;
+        }
+        catch { }
+    }
+    return null;
+}
+//# sourceMappingURL=spawn-support.js.map

package/dist/driver/spawn-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-support.js","sourceRoot":"","sources":["../../src/driver/spawn-support.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,2DAA2D;AAC3D,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,IAAc;IACxE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,OAAgB;IAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/driver/types.d.ts

@@ -41,7 +41,11 @@ export interface ProcessIdentity {
 export type StopProcessStatus = 'confirmed_stopped' | 'not_stopped' | 'cannot_determine';
 export interface StopProcessResult {
     stopped: StopProcessStatus;
-    scope: 'direct_child' | 'process_group' | 'containment_cgroup' | 'unknown';
+    /**
+     * 确认停止的范围。`subreaper_tree`：Linux 子收割者下整棵子树（含 setsid / 双 fork 逃逸者）已空，
+     * 由 waitpid ECHILD 证明；`tracked_tree`：macOS 上所有被跟踪到的后代（后代链、会话成员）均已消失。
+     */
+    scope: 'direct_child' | 'process_group' | 'containment_cgroup' | 'subreaper_tree' | 'tracked_tree' | 'unknown';
     residualPids?: number[];
     errorDetails?: string;
 }
@@ -76,7 +80,7 @@ export interface PlatformCapabilities {
     memoryHardLimit: boolean;
     pidsLimit: boolean;
     cpuLimit: boolean;
-    descendantEnumeration: 'full' | 'cgroup' | 'none';
+    descendantEnumeration: 'full' | 'cgroup' | 'subreaper' | 'none';
     gatedSpawn?: boolean;
     confinement?: string[];
 }

package/dist/driver/types.d.ts.map

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

package/dist/fault/crashpoint.d.ts

@@ -0,0 +1,8 @@
+export declare const crashpointsEnabled: boolean;
+export declare function crashpoint(label: string): void;
+/**
+ * 以调用栈里开启事务的函数名作为崩溃点标签（仅在启用时解析调用栈）。
+ * 例如 `SqliteStore.recordOperationResult`、`captureSnapshot`。
+ */
+export declare function callerLabel(depth: number): string;
+//# sourceMappingURL=crashpoint.d.ts.map

package/dist/fault/crashpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crashpoint.d.ts","sourceRoot":"","sources":["../../src/fault/crashpoint.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,kBAAkB,SAA+B,CAAC;AAE/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAO9C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/fault/crashpoint.js

@@ -0,0 +1,37 @@
+import fs from 'node:fs';
+/**
+ * 崩溃点故障注入（测试专用）。
+ *
+ * 只在设置了以下环境变量之一时生效，否则 crashpoint() 是一次布尔判断：
+ * - XIOFLOW_TEST_CRASHPOINT_TRACE=<file>：把经过的每个崩溃点 id 逐行追加到文件（发现阶段）；
+ * - XIOFLOW_TEST_CRASHPOINT=<id>：到达该 id 时向自身发送 SIGKILL（注入阶段）。
+ *
+ * id 形如 `<label>#<第几次到达>`。SIGKILL 不执行任何 finally / exit 钩子，与真实崩溃等价；
+ * 故障注入矩阵见 tests/fault/crash-matrix.test.ts。
+ */
+const target = process.env.XIOFLOW_TEST_CRASHPOINT;
+const tracePath = process.env.XIOFLOW_TEST_CRASHPOINT_TRACE;
+const seen = new Map();
+export const crashpointsEnabled = Boolean(target || tracePath);
+export function crashpoint(label) {
+    if (!crashpointsEnabled)
+        return;
+    const n = (seen.get(label) ?? 0) + 1;
+    seen.set(label, n);
+    const id = `${label}#${n}`;
+    if (tracePath)
+        fs.appendFileSync(tracePath, `${id}\n`);
+    if (id === target)
+        process.kill(process.pid, 'SIGKILL');
+}
+/**
+ * 以调用栈里开启事务的函数名作为崩溃点标签（仅在启用时解析调用栈）。
+ * 例如 `SqliteStore.recordOperationResult`、`captureSnapshot`。
+ */
+export function callerLabel(depth) {
+    const frames = (new Error().stack ?? '').split('\n').slice(1);
+    const frame = frames[depth] ?? '';
+    const match = /at (?:async )?([^\s(]+)/.exec(frame);
+    return match ? match[1] : 'unknown';
+}
+//# sourceMappingURL=crashpoint.js.map

package/dist/fault/crashpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crashpoint.js","sourceRoot":"","sources":["../../src/fault/crashpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;;;;;;;GASG;AACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;AACnD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC;AAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;AAE/D,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,CAAC,kBAAkB;QAAE,OAAO;IAChC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC;IAC3B,IAAI,SAAS;QAAE,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,MAAM,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC"}

package/dist/index.d.ts

@@ -4,10 +4,16 @@ export * from './store/schema.js';
 export * from './store/sqlite.js';
 export * from './driver/types.js';
 export * from './driver/node-driver.js';
+export * from './driver/reaper-driver.js';
 export * from './supervisor/supervisor.js';
 export * from './recovery/engine.js';
 export * from './quick-run.js';
 export * from './snapshot/git-shadow.js';
+export type { CommitResult, TransactionConflict, TransactionEffects, WorkspaceTransaction, WriteEntry, } from './workspace/transactions.js';
+export type { ReadTracking } from './workspace/read-tracking.js';
 export * from './capability/index.js';
 export * from './confinement/index.js';
+export * from './otel/otlp.js';
+export { KernelMcpServer, SUPPORTED_PROTOCOL_VERSIONS } from './mcp/server.js';
+export type { KernelMcpServerOptions } from './mcp/server.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,GACX,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -4,10 +4,13 @@ export * from './store/schema.js';
 export * from './store/sqlite.js';
 export * from './driver/types.js';
 export * from './driver/node-driver.js';
+export * from './driver/reaper-driver.js';
 export * from './supervisor/supervisor.js';
 export * from './recovery/engine.js';
 export * from './quick-run.js';
 export * from './snapshot/git-shadow.js';
 export * from './capability/index.js';
 export * from './confinement/index.js';
+export * from './otel/otlp.js';
+export { KernelMcpServer, SUPPORTED_PROTOCOL_VERSIONS } from './mcp/server.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AASzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,49 @@
+/**
+ * MCP server（stdio，JSON-RPC 2.0，每行一条消息），零依赖。
+ *
+ * 启动顺序遵循「先恢复、再执行」（ARCHITECTURE §3.2）：获取域、运行恢复引擎，然后才响应请求。
+ * stdout 只写协议消息；日志写 stderr。支持 progress 通知（请求带 progressToken 时转发输出块）
+ * 与 notifications/cancelled（取消对应的 run_command 操作，走标准停止流水线）。
+ */
+export declare const SUPPORTED_PROTOCOL_VERSIONS: string[];
+export interface KernelMcpServerOptions {
+    domainPath: string;
+    domainId?: string;
+    /** 'auto'：helper 可用时用 ReaperPlatformDriver，否则 NodePlatformDriver；实际选择写进 instructions 与每个结果。 */
+    driver?: 'auto' | 'node' | 'reaper';
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+    log?: (message: string) => void;
+    /** 工具结果中保留的 stdout / stderr 尾部字符数（完整输出见 stdoutRef / stderrRef）。 */
+    maxOutputChars?: number;
+    /** 周期性把 journal 导出为 OTLP traces；失败写日志且游标不前进，下个周期重试。 */
+    otlp?: {
+        endpoint: string;
+        headers?: Record<string, string>;
+        intervalMs?: number;
+        serviceName?: string;
+    };
+}
+export declare class KernelMcpServer {
+    private readonly options;
+    private readonly log;
+    private readonly output;
+    private domain?;
+    private supervisor?;
+    private driver?;
+    private instructions;
+    private readonly sessionTaskId;
+    /** requestId → 该请求启动的操作，用于 notifications/cancelled */
+    private readonly inFlight;
+    private readonly pending;
+    constructor(options: KernelMcpServerOptions);
+    /** 获取域并完成恢复后开始服务；输入流结束时等待在途请求、关闭域后返回。 */
+    serve(): Promise<void>;
+    /** 启动周期导出，返回「停止并最后导出一次」的函数；未配置时为空操作。 */
+    private startOtlpExport;
+    private handleLine;
+    private dispatch;
+    private callTool;
+    private send;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AAEH,eAAO,MAAM,2BAA2B,UAA2D,CAAC;AAEpG,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1G;AAkCD,qBAAa,eAAe;IAYd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAXpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,YAA6B,OAAO,EAAE,sBAAsB,EAG3D;IAED,yCAAyC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA2BlC;IAED,wCAAwC;IACxC,OAAO,CAAC,eAAe;YAuBT,UAAU;YA0BV,QAAQ;YAwCR,QAAQ;IA0CtB,OAAO,CAAC,IAAI;CAGb"}