@xioflow/kernel 0.3.0 → 0.5.0

package/dist/supervisor/drainer.js

@@ -0,0 +1,200 @@
+import * as crypto from 'node:crypto';
+import fs from 'node:fs';
+export function trimToValidUtf8(buf) {
+    const len = buf.length;
+    for (let i = 1; i <= Math.min(3, len); i++) {
+        const b = buf[len - i];
+        if ((b & 0xc0) === 0xc0) {
+            const needed = (b & 0xe0) === 0xc0 ? 2 : (b & 0xf0) === 0xe0 ? 3 : (b & 0xf8) === 0xf0 ? 4 : 1;
+            if (i < needed) {
+                return Buffer.from(buf.subarray(0, len - i));
+            }
+            break;
+        }
+        else if ((b & 0x80) === 0) {
+            break;
+        }
+    }
+    return buf;
+}
+export function trimStartToValidUtf8(buf) {
+    let start = 0;
+    while (start < buf.length && (buf[start] & 0xc0) === 0x80) {
+        start++;
+    }
+    return Buffer.from(buf.subarray(start));
+}
+export function setupStreamDrainer(stream, maxBytes, spillFilePath, onChunk, onData, spillInitError) {
+    const overhead = maxBytes >= 80 ? Math.min(64, Math.floor(maxBytes / 4)) : 0;
+    const effectiveMax = maxBytes - overhead;
+    const headMaxBytes = overhead > 0 ? Math.floor(effectiveMax * 0.75) : maxBytes;
+    const tailMaxBytes = overhead > 0 ? Math.max(0, effectiveMax - headMaxBytes) : 0;
+    const headChunks = [];
+    let headBytes = 0;
+    let bytesSeen = 0;
+    let isTruncated = false;
+    let spillFd = null;
+    let spillError = spillInitError;
+    const hash = crypto.createHash('sha256');
+    let isFinalized = false;
+    let outputHash = undefined;
+    const tailRing = tailMaxBytes > 0 ? Buffer.alloc(tailMaxBytes) : null;
+    let tailHead = 0;
+    let tailCount = 0;
+    if (spillFilePath && !spillError) {
+        try {
+            spillFd = fs.openSync(spillFilePath, 'w');
+        }
+        catch (openErr) {
+            spillError = openErr.message || String(openErr);
+            spillFd = null;
+        }
+    }
+    const doFinalize = () => {
+        if (isFinalized)
+            return;
+        isFinalized = true;
+        if (spillFd !== null) {
+            try {
+                fs.fsyncSync(spillFd);
+                fs.closeSync(spillFd);
+            }
+            catch (syncErr) {
+                spillError = spillError || syncErr.message || String(syncErr);
+            }
+            spillFd = null;
+        }
+        if (!spillError) {
+            try {
+                outputHash = hash.digest('hex');
+            }
+            catch { }
+        }
+        else {
+            outputHash = undefined;
+        }
+    };
+    const finishPromise = new Promise((resolve) => {
+        const finalize = () => {
+            doFinalize();
+            resolve();
+        };
+        stream.on('data', (chunk) => {
+            if (isFinalized) {
+                // finalize 之后，流继续读走数据避免堵塞或 SIGPIPE，但跳过 hash、落盘和转发
+                return;
+            }
+            const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            bytesSeen += buf.length;
+            if (onChunk) {
+                try {
+                    onChunk(buf.length);
+                }
+                catch { }
+            }
+            // 持续落盘转储全部流与写盘同链哈希 (P0-9)
+            if (spillFd !== null) {
+                try {
+                    fs.writeSync(spillFd, buf);
+                    hash.update(buf);
+                }
+                catch (writeErr) {
+                    spillError = spillError || writeErr.message || String(writeErr);
+                    try {
+                        fs.closeSync(spillFd);
+                    }
+                    catch { }
+                    spillFd = null;
+                }
+            }
+            else if (!spillFilePath && !spillError) {
+                try {
+                    hash.update(buf);
+                }
+                catch { }
+            }
+            if (onData) {
+                onData(buf);
+            }
+            // Head 内存有界保留
+            if (headBytes < headMaxBytes) {
+                if (headBytes + buf.length <= headMaxBytes) {
+                    headChunks.push(buf);
+                    headBytes += buf.length;
+                }
+                else {
+                    const remaining = headMaxBytes - headBytes;
+                    if (remaining > 0) {
+                        headChunks.push(buf.subarray(0, remaining));
+                        headBytes += remaining;
+                    }
+                    isTruncated = true;
+                }
+            }
+            else {
+                isTruncated = true;
+            }
+            if (bytesSeen > maxBytes) {
+                isTruncated = true;
+            }
+            // Tail 环形缓冲保留
+            if (tailRing !== null && tailMaxBytes > 0) {
+                if (buf.length >= tailMaxBytes) {
+                    buf.copy(tailRing, 0, buf.length - tailMaxBytes);
+                    tailHead = 0;
+                    tailCount = tailMaxBytes;
+                }
+                else {
+                    for (let i = 0; i < buf.length; i++) {
+                        tailRing[tailHead] = buf[i];
+                        tailHead = (tailHead + 1) % tailMaxBytes;
+                    }
+                    tailCount = Math.min(tailMaxBytes, tailCount + buf.length);
+                }
+            }
+        });
+        stream.on('end', finalize);
+        stream.on('close', finalize);
+        stream.on('error', finalize);
+    });
+    return {
+        getResult: () => {
+            doFinalize();
+            let content;
+            if (bytesSeen <= maxBytes) {
+                content = Buffer.concat(headChunks).toString('utf8');
+            }
+            else {
+                const rawHead = trimToValidUtf8(Buffer.concat(headChunks));
+                let cleanTail = Buffer.alloc(0);
+                if (tailRing !== null && tailCount > 0) {
+                    const rawTail = Buffer.alloc(tailCount);
+                    if (tailCount < tailMaxBytes) {
+                        tailRing.copy(rawTail, 0, 0, tailCount);
+                    }
+                    else {
+                        const part1 = tailRing.subarray(tailHead, tailMaxBytes);
+                        const part2 = tailRing.subarray(0, tailHead);
+                        part1.copy(rawTail, 0);
+                        part2.copy(rawTail, part1.length);
+                    }
+                    cleanTail = trimStartToValidUtf8(rawTail);
+                }
+                const truncatedBytes = Math.max(0, bytesSeen - rawHead.length - cleanTail.length);
+                const marker = `\n[... truncated ${truncatedBytes} bytes ...]\n`;
+                content = rawHead.toString('utf8') + marker + cleanTail.toString('utf8');
+            }
+            return {
+                content,
+                isTruncated,
+                outputRef: isTruncated && spillFilePath && !spillError ? spillFilePath : undefined,
+                outputHash: !spillError ? outputHash : undefined,
+                bytesSeen,
+                spillError,
+            };
+        },
+        finishPromise,
+        forceFinalize: doFinalize,
+    };
+}
+//# sourceMappingURL=drainer.js.map

package/dist/supervisor/drainer.js.map

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

package/dist/supervisor/finalize.d.ts

@@ -0,0 +1,21 @@
+import { ExecutionDomain } from '../domain.js';
+import { IndeterminateResult, OperationResult, ProcessOperationResult } from '../types.js';
+export declare const RESIDUAL_PID_GUIDANCE = "Residual PID detected. Inspect system processes manually before releasing resources.";
+export declare function indeterminateResult(options: {
+    reason: string;
+    startTime: number;
+    capabilityId?: string;
+    recoveryGuidance?: string;
+}): IndeterminateResult;
+export interface FinalizeOptions {
+    requiredResources?: string[];
+    /** false 表示保留租约（indeterminate 永远保留，与此无关）。 */
+    releaseResourceLock?: boolean;
+    artifactsDir?: string;
+}
+/**
+ * 操作结果的唯一写入口（Single Writer）：写事实、清理未引用的溢出文件、按结果处理租约。
+ * indeterminate 结果不释放租约并把 Run 置为 indeterminate；对已 done 的操作重复终结直接抛错。
+ */
+export declare function finalizeOperation(domain: ExecutionDomain, opId: string, result: OperationResult, options?: FinalizeOptions): ProcessOperationResult;
+//# sourceMappingURL=finalize.d.ts.map

package/dist/supervisor/finalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../src/supervisor/finalize.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,sBAAsB,EAAqB,MAAM,aAAa,CAAC;AAE9G,eAAO,MAAM,qBAAqB,yFACsD,CAAC;AAEzF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,mBAAmB,CAUtB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,eAAoB,GAC5B,sBAAsB,CAiCxB"}

package/dist/supervisor/finalize.js

@@ -0,0 +1,66 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export const RESIDUAL_PID_GUIDANCE = 'Residual PID detected. Inspect system processes manually before releasing resources.';
+export function indeterminateResult(options) {
+    return {
+        kind: 'indeterminate',
+        status: 'indeterminate',
+        reason: options.reason,
+        recoveryGuidance: options.recoveryGuidance ?? RESIDUAL_PID_GUIDANCE,
+        ...(options.capabilityId !== undefined ? { capabilityId: options.capabilityId } : {}),
+        durationMs: Date.now() - options.startTime,
+        completedAt: new Date().toISOString(),
+    };
+}
+/**
+ * 操作结果的唯一写入口（Single Writer）：写事实、清理未引用的溢出文件、按结果处理租约。
+ * indeterminate 结果不释放租约并把 Run 置为 indeterminate；对已 done 的操作重复终结直接抛错。
+ */
+export function finalizeOperation(domain, opId, result, options = {}) {
+    const store = domain.getStore();
+    const existing = store.getOperation(opId);
+    if (existing && existing.status === 'done') {
+        throw new Error(`Cannot finalize operation "${opId}": operation is already finalized with status "${existing.status}"`);
+    }
+    if (existing) {
+        result.runId = existing.runId;
+        if (existing.capabilityId && !result.capabilityId) {
+            result.capabilityId = existing.capabilityId;
+        }
+    }
+    if (result.kind === 'process') {
+        removeUnreferencedSpills(result, opId, options.artifactsDir || path.join(domain.domainPath, 'artifacts'));
+    }
+    if (result.status === 'indeterminate') {
+        store.recordOperationResult(opId, result, false);
+        const op = store.getOperation(opId);
+        if (op) {
+            const termReason = result.terminationReason;
+            store.updateRunStatus(op.runId, 'indeterminate', termReason);
+        }
+    }
+    else {
+        store.recordOperationResult(opId, result, true);
+        if (options.releaseResourceLock ?? true) {
+            domain.internalReleaseResources(opId, options.requiredResources);
+        }
+    }
+    return result;
+}
+function removeUnreferencedSpills(procRes, opId, targetDir) {
+    const spills = [
+        [procRes.stdoutRef, path.join(targetDir, `${opId}-stdout.log`)],
+        [procRes.stderrRef, path.join(targetDir, `${opId}-stderr.log`)],
+    ];
+    for (const [ref, spillPath] of spills) {
+        if (ref || !fs.existsSync(spillPath))
+            continue;
+        try {
+            fs.unlinkSync(spillPath);
+        }
+        catch (unlinkErr) {
+            procRes.spillError = procRes.spillError || unlinkErr.message || String(unlinkErr);
+        }
+    }
+}
+//# sourceMappingURL=finalize.js.map

package/dist/supervisor/finalize.js.map

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

package/dist/supervisor/fingerprint.d.ts

@@ -0,0 +1,8 @@
+import { ExecuteProcessOptions } from './types.js';
+export declare function normalizeResourceName(res: string): string;
+/**
+ * 规范化计算完整输入的 SHA-256 指纹 (ARCHITECTURE §2 / P0-12)
+ * 覆盖 execPath, args, cwd, 键排序的 envWhiteList, inheritEnv, sha256(stdin), 排序后的 requiredResources, timeoutMs, resourceBudget.
+ */
+export declare function computeInputFingerprint(options: ExecuteProcessOptions): string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/supervisor/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/supervisor/fingerprint.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAoC9E"}

package/dist/supervisor/fingerprint.js

@@ -0,0 +1,54 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+export function normalizeResourceName(res) {
+    if (res.startsWith('workspace:write:')) {
+        const raw = res.slice('workspace:write:'.length);
+        try {
+            return `workspace:write:${fs.realpathSync(raw)}`;
+        }
+        catch {
+            return `workspace:write:${path.resolve(raw)}`;
+        }
+    }
+    return res;
+}
+/**
+ * 规范化计算完整输入的 SHA-256 指纹 (ARCHITECTURE §2 / P0-12)
+ * 覆盖 execPath, args, cwd, 键排序的 envWhiteList, inheritEnv, sha256(stdin), 排序后的 requiredResources, timeoutMs, resourceBudget.
+ */
+export function computeInputFingerprint(options) {
+    const cmd = options.command;
+    let stdinHash = null;
+    if (cmd.stdin !== undefined && cmd.stdin !== null) {
+        stdinHash = crypto.createHash('sha256').update(cmd.stdin).digest('hex');
+    }
+    let envSorted = null;
+    if (cmd.envWhiteList) {
+        const keys = Object.keys(cmd.envWhiteList).sort();
+        envSorted = keys.map((k) => [k, cmd.envWhiteList[k]]);
+    }
+    const canonical = {
+        args: cmd.args || [],
+        cwd: cmd.cwd || '',
+        envWhiteList: envSorted,
+        execPath: cmd.execPath || '',
+        inheritEnv: cmd.inheritEnv ?? null,
+        requiredResources: [...(options.requiredResources || [])].sort(),
+        resourceBudget: options.resourceBudget
+            ? {
+                enforcement: options.resourceBudget.enforcement ?? null,
+                maxCpuTimeMs: options.resourceBudget.maxCpuTimeMs ?? null,
+                maxMemoryBytes: options.resourceBudget.maxMemoryBytes ?? null,
+                maxOutputBytes: options.resourceBudget.maxOutputBytes ?? null,
+                maxPids: options.resourceBudget.maxPids ?? null,
+            }
+            : null,
+        stdinHash,
+        timeoutMs: options.timeoutMs ?? null,
+        capabilityId: options.capabilityId ?? null,
+    };
+    const canonicalJson = JSON.stringify(canonical);
+    return crypto.createHash('sha256').update(canonicalJson).digest('hex');
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/supervisor/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../src/supervisor/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,OAAO,mBAAmB,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,mBAAmB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA8B;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAC5B,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAClD,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,SAAS,GAA8B,IAAI,CAAC;IAChD,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,YAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,SAAS,GAAG;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;QACpB,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE;QAClB,YAAY,EAAE,SAAS;QACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;QAC5B,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;QAClC,iBAAiB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;QAChE,cAAc,EAAE,OAAO,CAAC,cAAc;YACpC,CAAC,CAAC;gBACE,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,WAAW,IAAI,IAAI;gBACvD,YAAY,EAAE,OAAO,CAAC,cAAc,CAAC,YAAY,IAAI,IAAI;gBACzD,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,cAAc,IAAI,IAAI;gBAC7D,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,cAAc,IAAI,IAAI;gBAC7D,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,OAAO,IAAI,IAAI;aAChD;YACH,CAAC,CAAC,IAAI;QACR,SAAS;QACT,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;KAC3C,CAAC;IAEF,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC"}

package/dist/supervisor/process-monitor.d.ts

@@ -0,0 +1,9 @@
+import { ManagedProcessHandle } from '../driver/types.js';
+import { ProcessOperationResult } from '../types.js';
+import type { ProcessRunContext, ProcessRunPlan } from './process-run.js';
+/**
+ * 已 active 的进程：监督运行、有界排空与流式转储、身份核验、结果落盘。
+ * 需要在调用方 finally 中执行的清理（排空器、定时器）登记到 cleanups。
+ */
+export declare function superviseActive(ctx: ProcessRunContext, plan: ProcessRunPlan, handle: ManagedProcessHandle, cleanups: Array<() => void>): Promise<ProcessOperationResult>;
+//# sourceMappingURL=process-monitor.d.ts.map

package/dist/supervisor/process-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-monitor.d.ts","sourceRoot":"","sources":["../../src/supervisor/process-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAqB,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAO1E;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAyDjC"}

package/dist/supervisor/process-monitor.js

@@ -0,0 +1,230 @@
+import { finalizeOperation, indeterminateResult } from './finalize.js';
+import { buildProcessResult, openOutputCapture } from './process-output.js';
+import { crashpoint } from '../fault/crashpoint.js';
+const ROOT_EXIT_WAIT_MS = 1000;
+/**
+ * 已 active 的进程：监督运行、有界排空与流式转储、身份核验、结果落盘。
+ * 需要在调用方 finally 中执行的清理（排空器、定时器）登记到 cleanups。
+ */
+export async function superviseActive(ctx, plan, handle, cleanups) {
+    const { options, opState } = plan;
+    // 崩溃点：进程已放行运行、结果尚未落盘
+    crashpoint('supervisor:process-running');
+    const capture = openOutputCapture(ctx, plan, handle);
+    cleanups.push(() => capture.stdout.forceFinalize(), () => capture.stderr.forceFinalize());
+    // 检查在 spawn 途中是否已被请求取消：若已请求取消，立即触发停止流水线向底层发送终止信号
+    if (opState.cancelRequested) {
+        ctx.stop(options.opId, 'user_cancelled', opState.cancelGraceMs ?? 2000).catch(() => { });
+    }
+    let timeoutTimer = null;
+    const timeoutPromise = options.timeoutMs && options.timeoutMs > 0
+        ? new Promise((resolve) => {
+            timeoutTimer = setTimeout(() => resolve('timeout'), options.timeoutMs);
+        })
+        : new Promise(() => { });
+    const clearTimer = () => {
+        if (timeoutTimer)
+            clearTimeout(timeoutTimer);
+    };
+    const sampler = startBudgetSampler(ctx, plan, handle);
+    cleanups.push(clearTimer, sampler.stop);
+    const outcome = await raceRootOutcome(plan, handle, timeoutPromise);
+    clearTimer();
+    sampler.stop();
+    const settled = await settleRootOutcome(ctx, plan, handle, outcome);
+    if ('final' in settled)
+        return settled.final;
+    const drained = await drainOrReap(ctx, plan, handle, capture, {
+        exit: settled.exit,
+        exitedNaturally: outcome.type === 'exit',
+    });
+    if ('final' in drained)
+        return drained.final;
+    const result = buildProcessResult(plan, capture, {
+        exit: settled.exit,
+        residualProcessesReaped: drained.residualProcessesReaped,
+        peaks: sampler.peaks(),
+        identityVerification: await ctx.driver.verifyIdentity(handle.identity),
+    });
+    if (opState.stopPromise) {
+        const stopRes = await opState.stopPromise;
+        if (stopRes.stopped !== 'confirmed_stopped') {
+            return recordUnconfirmedStop(ctx, plan, handle, stopRes, true);
+        }
+    }
+    // 6. [事务提交结果与释放资源 - Single Writer]
+    return finalizeOperation(ctx.domain, options.opId, result, {
+        requiredResources: options.requiredResources,
+        artifactsDir: capture.artifactsDir,
+    });
+}
+/** Soft / Observe 模式资源采样治理：记录峰值，soft 超限时走停止流水线。 */
+function startBudgetSampler(ctx, plan, handle) {
+    const { options, opState } = plan;
+    const budget = options.resourceBudget;
+    let peakMemoryBytes = 0;
+    let peakCpuTimeMs = 0;
+    let samplingInterval = null;
+    const stop = () => {
+        if (samplingInterval)
+            clearInterval(samplingInterval);
+    };
+    const peaks = () => ({ peakMemoryBytes, peakCpuTimeMs });
+    if (!ctx.driver.sampleMetrics || !budget || (budget.enforcement !== 'soft' && budget.enforcement !== 'observe')) {
+        return { stop, peaks };
+    }
+    const stopFor = async (reason) => {
+        opState.terminationReason = reason;
+        stop();
+        await ctx.stop(options.opId, reason, 1000);
+    };
+    samplingInterval = setInterval(async () => {
+        try {
+            const metrics = await ctx.driver.sampleMetrics(handle.identity);
+            peakMemoryBytes = Math.max(peakMemoryBytes, metrics.rssBytes);
+            peakCpuTimeMs = Math.max(peakCpuTimeMs, metrics.cpuTimeMs);
+            if (budget.enforcement !== 'soft')
+                return;
+            if (budget.maxMemoryBytes && metrics.rssBytes > budget.maxMemoryBytes) {
+                await stopFor('memory_exceeded');
+            }
+            else if (budget.maxCpuTimeMs && metrics.cpuTimeMs > budget.maxCpuTimeMs) {
+                await stopFor('cpu_exceeded');
+            }
+            else if (budget.maxPids && metrics.pidsCount > budget.maxPids) {
+                await stopFor('pids_exceeded');
+            }
+        }
+        catch { }
+    }, 100);
+    return { stop, peaks };
+}
+/** 等待根进程退出、超时触发、或外部停止完成（三者取先）。 */
+async function raceRootOutcome(plan, handle, timeoutPromise) {
+    const { opState } = plan;
+    let notifyStop;
+    const stopTriggerPromise = new Promise((resolve) => {
+        notifyStop = resolve;
+    });
+    const previousResolve = opState.stopResolve;
+    opState.stopResolve = (res) => {
+        previousResolve?.(res);
+        notifyStop?.(res);
+    };
+    const rootExitPromise = handle.onRootExit ?? handle.onExit;
+    const stopCandidate = opState.stopPromise ? opState.stopPromise : stopTriggerPromise;
+    return Promise.race([
+        rootExitPromise.then((res) => ({ type: 'exit', res })),
+        timeoutPromise.then(() => ({ type: 'timeout' })),
+        stopCandidate.then((stopRes) => ({ type: 'stop', stopRes })),
+    ]);
+}
+function waitRootExit(handle) {
+    return Promise.race([
+        (handle.onRootExit ?? handle.onExit).then((res) => ({ exited: true, res })),
+        new Promise((resolve) => setTimeout(() => resolve({ exited: false }), ROOT_EXIT_WAIT_MS)),
+    ]);
+}
+async function settleRootOutcome(ctx, plan, handle, outcome) {
+    const { options, opState } = plan;
+    if (outcome.type === 'exit') {
+        return { exit: outcome.res };
+    }
+    if (outcome.type === 'stop') {
+        if (outcome.stopRes.stopped !== 'confirmed_stopped') {
+            if (handle.rawProcess && typeof handle.rawProcess.kill === 'function') {
+                try {
+                    handle.rawProcess.kill('SIGKILL');
+                }
+                catch { }
+            }
+            try {
+                handle.stdout.destroy?.();
+                handle.stderr.destroy?.();
+            }
+            catch { }
+            return { final: recordUnconfirmedStop(ctx, plan, handle, outcome.stopRes, false) };
+        }
+        const rootExit = await waitRootExit(handle);
+        return { exit: rootExit.exited ? rootExit.res : { exitCode: null, signal: 'SIGKILL' } };
+    }
+    opState.timedOut = true;
+    opState.terminationReason = 'timed_out';
+    const stopRes = await ctx.stop(options.opId, 'timed_out', 1500);
+    // 超时路径：根进程已由停止流水线终止，等待根进程退出事实（避免被持有管道的逃逸后代挂死）。
+    // 有界上限内未确认停止或根进程仍未退出，转入 indeterminate
+    const rootExit = await waitRootExit(handle);
+    if (stopRes.stopped === 'confirmed_stopped' && rootExit.exited) {
+        return { exit: rootExit.res };
+    }
+    const stored = ctx.domain.getStore().getOperation(options.opId);
+    if (stored && stored.status === 'done' && stored.result?.status === 'indeterminate') {
+        return { final: stored.result };
+    }
+    const indet = indeterminateResult({
+        reason: `Process ${handle.identity.pid} timed out and root process could not be confirmed exited within ${ROOT_EXIT_WAIT_MS}ms bound: ${stopRes.errorDetails || 'root process still alive'}`,
+        startTime: opState.startTime,
+    });
+    return { final: holdLeases(ctx, plan, indet) };
+}
+/** 停止未被确认：若停止流水线已写下结果则沿用，否则记为 indeterminate 并保留租约。 */
+function recordUnconfirmedStop(ctx, plan, handle, stopRes, withCapability) {
+    const stored = ctx.domain.getStore().getOperation(plan.options.opId);
+    if (stored && stored.status === 'done') {
+        return (stored.result ?? null);
+    }
+    const indet = indeterminateResult({
+        reason: `Process ${handle.identity.pid} was cancelled or stopped but could not be confirmed: ${stopRes.errorDetails || 'residual processes still alive'}`,
+        startTime: plan.opState.startTime,
+        capabilityId: withCapability ? plan.options.capabilityId : undefined,
+    });
+    return holdLeases(ctx, plan, indet);
+}
+function holdLeases(ctx, plan, indet) {
+    return finalizeOperation(ctx.domain, plan.options.opId, indet, {
+        requiredResources: plan.options.requiredResources,
+        releaseResourceLock: false,
+    });
+}
+/**
+ * 有界等待流排空。排空超时说明根进程已退出但仍有后代持有管道：回收整个进程组，
+ * 否则操作会一直挂到超时，且 root 的真实退出事实会被超时掩盖。
+ */
+async function drainOrReap(ctx, plan, handle, capture, facts) {
+    const { options, opState } = plan;
+    const drainTimeoutMs = options.drainTimeoutMs ?? 2000;
+    const drainPromise = Promise.all([capture.stdout.finishPromise, capture.stderr.finishPromise]);
+    const drainedWithin = (ms) => Promise.race([drainPromise.then(() => true), new Promise((resolve) => setTimeout(() => resolve(false), ms))]);
+    let drained = await drainedWithin(drainTimeoutMs);
+    let residualProcessesReaped = false;
+    if (!drained && facts.exitedNaturally) {
+        const reapResult = await ctx.driver.terminate(handle.identity, 1500);
+        if (reapResult.stopped !== 'confirmed_stopped') {
+            const indet = indeterminateResult({
+                reason: `Process ${handle.identity.pid} exited but residual descendants could not be confirmed stopped: ${reapResult.errorDetails}`,
+                startTime: opState.startTime,
+            });
+            return { final: holdLeases(ctx, plan, indet) };
+        }
+        residualProcessesReaped = true;
+        // 被杀死的后代释放管道后，给排空最后一次机会
+        drained = await drainedWithin(250);
+    }
+    if (drained) {
+        return { residualProcessesReaped };
+    }
+    // 排空超时路径强制调用 fsyncSync + closeSync 结清刷盘
+    capture.stdout.forceFinalize();
+    capture.stderr.forceFinalize();
+    // 走到这里时进程组已被确认停止，管道写端却仍被持有：
+    // 必然存在一个驱动未观测到的逃逸进程（例如 setsid 后被 init 收养、采样器没来得及记录）。
+    // 无法确认隔离，不能报告 succeeded / residualProcessesReaped，必须如实判 indeterminate 并保留租约。
+    const indet = indeterminateResult({
+        reason: `Process ${handle.identity.pid} exited (exitCode=${facts.exit.exitCode}, signal=${facts.exit.signal}) and its process group was confirmed stopped, but stdout/stderr pipes are still held by an unobserved escaped process`,
+        recoveryGuidance: 'An escaped process outside the observed process tree still holds the output pipes. Inspect system processes manually before adjudicating and releasing resources.',
+        capabilityId: options.capabilityId,
+        startTime: opState.startTime,
+    });
+    return { final: holdLeases(ctx, plan, indet) };
+}
+//# sourceMappingURL=process-monitor.js.map

package/dist/supervisor/process-monitor.js.map

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