@winspan/claude-forge 8.34.0 → 8.36.0

package/dist/capability/execution-manager.js

@@ -1,260 +0,0 @@
-/**
- * ExecutionManager — daemon 进程内单例，统筹所有 methodology_executions 的后台执行。
- *
- * 职责：
- *  1. 提供 `start({session_id, plan, mode})` 入口：为前台/后台两种模式分别使用合适的 executor
- *  2. 跟踪活跃的 orchestrator，让 cancel() 能真正 kill 子进程
- *  3. 在 daemon 启动时扫一遍 listRunningBackgroundExecutions() —— 对应 worker
- *     已不在了（孤儿 execution），标记为 failed（"crashed")
- *
- * 不负责：路由决策 / planner / UI。
- */
-import { ForegroundExecutor } from './executor/foreground-executor.js';
-import { BackgroundExecutor } from './executor/background-executor.js';
-import { Orchestrator } from './executor/orchestrator.js';
-import { probeWorkerAuth, WorkerAuthError } from './executor/worker-auth-probe.js';
-import { logger } from '../core/utils/logger.js';
-export class ExecutionManager {
-    storage;
-    registry;
-    foregroundExecutor;
-    backgroundExecutor;
-    activeOrchestrators = new Map();
-    listeners = new Set();
-    reconcileTimer = null;
-    staleThresholdMs;
-    constructor(storage, registry, options = {}) {
-        this.storage = storage;
-        this.registry = registry;
-        this.foregroundExecutor = new ForegroundExecutor(storage, registry);
-        this.backgroundExecutor = new BackgroundExecutor(storage, registry, options.background);
-        this.staleThresholdMs = options.staleThresholdMs ?? 30 * 60 * 1000;
-        // Relay executor events to external subscribers (SSE, metrics, ...)
-        const relay = (ev) => {
-            for (const l of this.listeners) {
-                try {
-                    l(ev);
-                }
-                catch (err) {
-                    logger.debug(`[ExecutionManager] relay failed: ${err}`);
-                }
-            }
-        };
-        this.foregroundExecutor.subscribe(relay);
-        this.backgroundExecutor.subscribe(relay);
-    }
-    /**
-     * Create the execution row + kick off orchestrator.
-     * Returns the newly created execution id.
-     */
-    start(input) {
-        // 后台模式：前置认证探测，给调用方明确错误而不是等 worker 起来后才报错
-        if (input.mode === 'background') {
-            const probe = probeWorkerAuth();
-            if (!probe.available) {
-                throw new WorkerAuthError(probe);
-            }
-        }
-        const executionId = this.storage.createMethodologyExecution({
-            session_id: input.session_id,
-            methodology_id: input.methodology_id,
-            plan_json: JSON.stringify(input.plan),
-            mode: input.mode,
-            trigger_type: input.trigger_type ?? 'manual',
-        });
-        // Seed the first phase_executions row so listings show immediately
-        if (input.plan.phases[0]) {
-            const p0 = input.plan.phases[0];
-            this.storage.createPhaseExecution({
-                methodology_execution_id: executionId,
-                phase_id: p0.id,
-                phase_index: 0,
-                agent_name: p0.agent,
-                prompt: p0.prompt,
-            });
-        }
-        const executor = input.mode === 'background' ? this.backgroundExecutor : this.foregroundExecutor;
-        const orch = new Orchestrator(this.storage, executor);
-        this.activeOrchestrators.set(executionId, orch);
-        // Fire-and-forget; errors are logged but don't crash the daemon.
-        orch.run(executionId)
-            .catch(err => {
-            logger.warn(`[ExecutionManager] orchestrator for ${executionId} threw: ${err}`);
-            try {
-                this.storage.updateMethodologyExecution(executionId, {
-                    status: 'failed',
-                    completed_at: Date.now(),
-                    worker_pid: null,
-                });
-            }
-            catch { /* swallow */ }
-        })
-            .finally(() => {
-            this.activeOrchestrators.delete(executionId);
-        });
-        return executionId;
-    }
-    async cancel(execution_id) {
-        const exec = this.storage.getMethodologyExecution(execution_id);
-        if (!exec)
-            throw new Error(`execution ${execution_id} not found`);
-        const executor = exec.mode === 'background'
-            ? this.backgroundExecutor
-            : this.foregroundExecutor;
-        await executor.cancel(execution_id);
-    }
-    /**
-     * Subscribe to all executor events. Returns an unsubscribe function.
-     */
-    subscribe(listener) {
-        this.listeners.add(listener);
-        return () => { this.listeners.delete(listener); };
-    }
-    /**
-     * At daemon startup: find background executions whose worker_pid is no longer
-     * alive. Mark them failed so the UI shows a definitive state.
-     */
-    reconcileOrphansOnStartup() {
-        const rows = this.storage.listRunningBackgroundExecutions();
-        for (const row of rows) {
-            const pid = row.worker_pid;
-            const alive = pid ? this.isPidAlive(pid) : false;
-            if (!alive) {
-                logger.warn(`[ExecutionManager] execution=${row.id} has stale worker_pid=${pid}; marking failed`);
-                this.storage.updateMethodologyExecution(row.id, {
-                    status: 'failed',
-                    completed_at: Date.now(),
-                    worker_pid: null,
-                });
-            }
-        }
-    }
-    /**
-     * Cross-session residue sweep: find `mode='foreground' AND status='running'`
-     * executions whose `started_at` is older than `maxAgeMs`, and mark them
-     * `cancelled`. Foreground executions are driven by Claude Code sessions — if
-     * the originating session ended without the Stop hook firing (crash, kill,
-     * detach, pre-guard legacy data), the row can stay `running` forever and
-     * blocks the session-level exclusivity check at UserPromptSubmit.
-     *
-     * Complements:
-     *  - `reconcileOrphansOnStartup()` handles background workers (pid-based).
-     *  - `sweepStaleMethodologies()` is the softer no-progress sweep (30min → `stale`).
-     *
-     * @param maxAgeMs absolute age since started_at. Default 4h.
-     * @returns list of execution ids that were cancelled.
-     */
-    cancelStaleForegroundExecutions(maxAgeMs = 4 * 60 * 60 * 1000) {
-        const now = Date.now();
-        const rows = this.storage.listRunningForegroundExecutions();
-        const cancelled = [];
-        for (const row of rows) {
-            const startedAt = row.started_at ?? 0;
-            const age = now - startedAt;
-            if (age < maxAgeMs)
-                continue;
-            try {
-                this.storage.updateMethodologyExecution(row.id, {
-                    status: 'cancelled',
-                    completed_at: now,
-                });
-                cancelled.push(row.id);
-                logger.warn(`[ExecutionManager] execution=${row.id} session=${row.session_id} ` +
-                    `foreground residue age=${Math.round(age / 60000)}min > ${Math.round(maxAgeMs / 60000)}min — marked cancelled`);
-            }
-            catch (err) {
-                logger.warn(`[ExecutionManager] cross-session cancel failed for execution=${row.id}: ${err}`);
-            }
-        }
-        return cancelled;
-    }
-    isPidAlive(pid) {
-        try {
-            process.kill(pid, 0);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Sweep methodology_executions that are still `running` but haven't made any
-     * progress for longer than `staleThresholdMs`. Mark them `stale` so the UI
-     * (and downstream schedulers) stop treating them as active.
-     *
-     * 判定依据：`now - (last_progress_at || started_at) > staleThresholdMs`
-     * 非 running 的 execution 一律忽略。
-     *
-     * 返回被标记为 stale 的 execution id 列表，便于测试 / 观测。
-     */
-    sweepStaleMethodologies(now = Date.now()) {
-        const rows = this.storage.getDatabase().prepare(`SELECT id, status, started_at, last_progress_at
-       FROM methodology_executions
-       WHERE status = 'running'`).all();
-        const marked = [];
-        for (const row of rows) {
-            const reference = row.last_progress_at ?? row.started_at;
-            if (reference == null)
-                continue;
-            if (now - reference <= this.staleThresholdMs)
-                continue;
-            try {
-                this.storage.updateMethodologyExecution(row.id, {
-                    status: 'stale',
-                    completed_at: now,
-                });
-                marked.push(row.id);
-                logger.warn(`[ExecutionManager] execution=${row.id} marked stale (no progress for ${Math.round((now - reference) / 60_000)}min)`);
-            }
-            catch (err) {
-                logger.warn(`[ExecutionManager] failed to mark execution=${row.id} stale: ${err}`);
-            }
-        }
-        return marked;
-    }
-    /**
-     * Start a periodic reconcile loop — picks up workers killed while daemon
-     * was running (e.g. user kill -9'd the pid). Safe to call once at startup.
-     * Returns a stop function.
-     *
-     * @param intervalMs reconcile interval in milliseconds
-     * @param idleTriggerCallback optional callback to trigger idle methodologies
-     */
-    startReconcileLoop(intervalMs = 60_000, idleTriggerCallback) {
-        if (this.reconcileTimer)
-            clearInterval(this.reconcileTimer);
-        this.reconcileTimer = setInterval(() => {
-            try {
-                this.reconcileOrphansOnStartup();
-            }
-            catch (err) {
-                logger.debug(`[ExecutionManager] periodic reconcile failed: ${err}`);
-            }
-            try {
-                this.sweepStaleMethodologies();
-            }
-            catch (err) {
-                logger.debug(`[ExecutionManager] periodic stale sweep failed: ${err}`);
-            }
-            // Trigger idle methodologies if callback provided
-            if (idleTriggerCallback) {
-                idleTriggerCallback().catch(err => {
-                    logger.debug(`[ExecutionManager] idle trigger callback failed: ${err}`);
-                });
-            }
-        }, intervalMs);
-        // Don't keep the event loop alive just for this.
-        this.reconcileTimer.unref?.();
-        return () => {
-            if (this.reconcileTimer)
-                clearInterval(this.reconcileTimer);
-            this.reconcileTimer = null;
-        };
-    }
-    stopReconcileLoop() {
-        if (this.reconcileTimer)
-            clearInterval(this.reconcileTimer);
-        this.reconcileTimer = null;
-    }
-}
-//# sourceMappingURL=execution-manager.js.map

package/dist/capability/execution-manager.js.map

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

package/dist/capability/executor/background-executor.d.ts

@@ -1,58 +0,0 @@
-/**
- * BackgroundExecutor —— spawn `claude -p` 子进程独立执行一个 phase。
- *
- * 与 ForegroundExecutor 的差异：
- *  - 真正调用 CLI 并等待结束，所以 `executePhase` 返回的是最终 status
- *    ('completed' | 'failed'), 不是 'injected'
- *  - 不会改 pending queue —— 后台执行路径跟 Claude 主会话完全隔离
- *  - 进度通过 subscribe() 的 ExecutorEvent 对外暴露（SSE 可订阅）
- */
-import type { MethodologyExecution, PlannedPhase } from '../types.js';
-import type { SQLiteStorage } from '../../core/storage/sqlite.js';
-import type { MethodologyRegistry } from '../methodology-registry.js';
-import type { ExecutorEventListener, PhaseExecutionResult, PhaseExecutor } from './types.js';
-export interface BackgroundExecutorOptions {
-    /** claude CLI 可执行文件路径（默认走 PATH） */
-    claudeBin?: string;
-    /** 子进程 cwd；默认为当前项目目录 */
-    cwd?: string;
-    /** 项目根目录，作为 --add-dir 的参数；默认走 cwd */
-    projectRoot?: string;
-    /** 每个 phase 的最大预算美元（默认 2） */
-    maxBudgetUsdPerPhase?: number;
-    /** 权限模式（默认 bypassPermissions） */
-    permissionMode?: 'acceptEdits' | 'bypassPermissions' | 'default' | 'dontAsk' | 'plan';
-    /** 默认禁用的工具（逗号分隔） */
-    disallowedTools?: string;
-    /** phase 级 wall-clock 超时（ms），默认 30 分钟 */
-    phaseTimeoutMs?: number;
-    /** stream-json 日志根目录 */
-    logDir?: string;
-    /**
-     * worker 专用 settings.json 路径。若未提供，会懒生成到
-     * `$HOME/.claude-forge/worker-settings.json`，内容为 `{"hooks": {}}`。
-     * 目的：让 worker 子进程跳过 daemon hooks，避免递归触发。
-     */
-    settingsPath?: string;
-}
-export declare class BackgroundExecutor implements PhaseExecutor {
-    private storage;
-    private registry;
-    readonly mode: "background";
-    private listeners;
-    private running;
-    private cancelRequested;
-    private readonly opts;
-    constructor(storage: SQLiteStorage, registry: MethodologyRegistry, options?: BackgroundExecutorOptions);
-    executePhase(execution: MethodologyExecution, phase: PlannedPhase, phaseIndex: number): Promise<PhaseExecutionResult>;
-    cancel(execution_id: number): Promise<void>;
-    subscribe(listener: ExecutorEventListener): () => void;
-    private emit;
-    /**
-     * @internal test-only: 构建 spawn 参数。生产代码请走 `executePhase`。
-     */
-    buildArgs(): string[];
-    /** @internal test-only */
-    getSettingsPath(): string;
-}
-//# sourceMappingURL=background-executor.d.ts.map

package/dist/capability/executor/background-executor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"background-executor.d.ts","sourceRoot":"","sources":["../../../src/capability/executor/background-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAEV,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACd,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,yBAAyB;IACxC,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iCAAiC;IACjC,cAAc,CAAC,EAAE,aAAa,GAAG,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACtF,oBAAoB;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAcD,qBAAa,kBAAmB,YAAW,aAAa;IAQpD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IARlB,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IACtC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,OAAO,CAAqD;IACpE,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsF;gBAGjG,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,mBAAmB,EACrC,OAAO,GAAE,yBAA8B;IAiBnC,YAAY,CAChB,SAAS,EAAE,oBAAoB,EAC/B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC;IAoO1B,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjD,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAKtD,OAAO,CAAC,IAAI;IAMZ;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAoBrB,0BAA0B;IAC1B,eAAe,IAAI,MAAM;CAG1B"}

package/dist/capability/executor/background-executor.js

@@ -1,322 +0,0 @@
-/**
- * BackgroundExecutor —— spawn `claude -p` 子进程独立执行一个 phase。
- *
- * 与 ForegroundExecutor 的差异：
- *  - 真正调用 CLI 并等待结束，所以 `executePhase` 返回的是最终 status
- *    ('completed' | 'failed'), 不是 'injected'
- *  - 不会改 pending queue —— 后台执行路径跟 Claude 主会话完全隔离
- *  - 进度通过 subscribe() 的 ExecutorEvent 对外暴露（SSE 可订阅）
- */
-import { spawn } from 'node:child_process';
-import { mkdirSync, existsSync, createWriteStream, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import path from 'node:path';
-import { formatMethodologyPhaseDirectiveForWorker } from '../../daemon/handlers/methodology-formatter.js';
-import { parseStreamLine, extractResultText, extractToolUses, isTerminal, } from './stream-parser.js';
-import { logger } from '../../core/utils/logger.js';
-const DEFAULT_LOG_DIR = path.join(homedir(), '.claude-forge', 'logs');
-const DEFAULT_WORKER_SETTINGS_PATH = path.join(homedir(), '.claude-forge', 'worker-settings.json');
-/**
- * 确保 worker settings 文件存在。已存在则复用（不覆写），不存在则以 `{"hooks": {}}` 创建。
- */
-function ensureWorkerSettingsFile(target) {
-    if (existsSync(target))
-        return;
-    mkdirSync(path.dirname(target), { recursive: true });
-    writeFileSync(target, JSON.stringify({ hooks: {} }, null, 2), 'utf-8');
-}
-export class BackgroundExecutor {
-    storage;
-    registry;
-    mode = 'background';
-    listeners = new Set();
-    running = new Map();
-    cancelRequested = new Set();
-    opts;
-    constructor(storage, registry, options = {}) {
-        this.storage = storage;
-        this.registry = registry;
-        const settingsPath = options.settingsPath ?? DEFAULT_WORKER_SETTINGS_PATH;
-        ensureWorkerSettingsFile(settingsPath);
-        this.opts = {
-            claudeBin: options.claudeBin ?? 'claude',
-            cwd: options.cwd ?? process.cwd(),
-            projectRoot: options.projectRoot,
-            maxBudgetUsdPerPhase: options.maxBudgetUsdPerPhase ?? 2,
-            permissionMode: options.permissionMode ?? 'bypassPermissions',
-            disallowedTools: options.disallowedTools ?? 'WebFetch,WebSearch',
-            phaseTimeoutMs: options.phaseTimeoutMs ?? 30 * 60 * 1000,
-            logDir: options.logDir ?? DEFAULT_LOG_DIR,
-            settingsPath,
-        };
-    }
-    async executePhase(execution, phase, phaseIndex) {
-        const methodology = this.registry.get(execution.methodology_id);
-        if (!methodology) {
-            return {
-                status: 'failed',
-                phase_index: phaseIndex,
-                phase_id: phase.id,
-                error: `methodology ${execution.methodology_id} not found`,
-            };
-        }
-        const plan = JSON.parse(execution.plan_json);
-        const directive = formatMethodologyPhaseDirectiveForWorker(methodology, plan, phase, phaseIndex, execution.id);
-        // Find or create the phase_executions row for this phase
-        const existing = this.storage.getPhaseExecutions(execution.id).find(p => p.phase_index === phaseIndex);
-        const phaseExecId = existing?.id ?? this.storage.createPhaseExecution({
-            methodology_execution_id: execution.id,
-            phase_id: phase.id,
-            phase_index: phaseIndex,
-            agent_name: phase.agent,
-            prompt: phase.prompt,
-        });
-        if (!existsSync(this.opts.logDir))
-            mkdirSync(this.opts.logDir, { recursive: true });
-        const logPath = path.join(this.opts.logDir, `execution-${execution.id}-phase-${phaseIndex}.jsonl`);
-        this.storage.updatePhaseExecution(phaseExecId, { stream_log_path: logPath });
-        this.emit({
-            type: 'phase-start',
-            execution_id: execution.id,
-            phase_index: phaseIndex,
-            phase_id: phase.id,
-            timestamp: Date.now(),
-            payload: { mode: 'background', agent: phase.agent, logPath },
-        });
-        const startedAt = Date.now();
-        const args = this.buildArgs();
-        logger.info(`[BackgroundExecutor] spawn claude -p for execution=${execution.id} phase=${phaseIndex} (${phase.id})`);
-        let stdoutBuf = '';
-        let finalText = null;
-        let capturedSessionId = null;
-        let capturedErrorMessage = null;
-        let exitReason = 'completed';
-        const child = spawn(this.opts.claudeBin, args, {
-            cwd: this.opts.cwd,
-            env: { ...process.env, CLAUDE_FORGE_WORKER: '1' },
-            stdio: ['pipe', 'pipe', 'pipe'],
-        });
-        this.running.set(execution.id, child);
-        this.storage.updateMethodologyExecution(execution.id, {
-            worker_pid: child.pid ?? null,
-            last_progress_at: Date.now(),
-        });
-        const logStream = createWriteStream(logPath, { flags: 'a' });
-        const handleStreamEvent = (event) => {
-            // Capture session id from init event
-            if (event.type === 'system' && 'session_id' in event && typeof event.session_id === 'string') {
-                capturedSessionId = event.session_id;
-                this.storage.updateMethodologyExecution(execution.id, {
-                    worker_session_id: event.session_id,
-                    last_progress_at: Date.now(),
-                });
-            }
-            // Tool uses — emit as phase-log for observability
-            const tools = extractToolUses(event);
-            for (const t of tools) {
-                this.emit({
-                    type: 'phase-log',
-                    execution_id: execution.id,
-                    phase_index: phaseIndex,
-                    phase_id: phase.id,
-                    timestamp: Date.now(),
-                    payload: { kind: 'tool_use', tool: t.name, input: t.input },
-                });
-            }
-            // Result event — terminal
-            if (event.type === 'result') {
-                const txt = extractResultText(event);
-                if (txt)
-                    finalText = txt;
-                if ('is_error' in event && event.is_error) {
-                    exitReason = 'failed';
-                    capturedErrorMessage = typeof event.result === 'string' ? event.result : 'claude -p reported error';
-                }
-            }
-        };
-        const waitForExit = new Promise((resolve) => {
-            let timer = setTimeout(() => {
-                logger.warn(`[BackgroundExecutor] phase ${phaseIndex} timed out`);
-                exitReason = 'timeout';
-                capturedErrorMessage = `phase exceeded ${this.opts.phaseTimeoutMs}ms wall-clock timeout`;
-                child.kill('SIGTERM');
-            }, this.opts.phaseTimeoutMs);
-            child.stdout.on('data', (chunk) => {
-                const text = chunk.toString('utf-8');
-                stdoutBuf += text;
-                logStream.write(text);
-                let newlineIdx;
-                while ((newlineIdx = stdoutBuf.indexOf('\n')) >= 0) {
-                    const line = stdoutBuf.slice(0, newlineIdx);
-                    stdoutBuf = stdoutBuf.slice(newlineIdx + 1);
-                    const parsed = parseStreamLine(line);
-                    if (parsed.event) {
-                        handleStreamEvent(parsed.event);
-                        if (isTerminal(parsed.event)) {
-                            // result event — child should exit on its own shortly
-                        }
-                    }
-                }
-            });
-            child.stderr.on('data', (chunk) => {
-                const text = chunk.toString('utf-8');
-                logStream.write(`[stderr] ${text}`);
-                logger.debug(`[BackgroundExecutor][stderr] ${text.slice(0, 200)}`);
-            });
-            child.on('error', (err) => {
-                logger.warn(`[BackgroundExecutor] spawn error: ${err.message}`);
-                exitReason = 'failed';
-                capturedErrorMessage = `spawn failed: ${err.message}`;
-                if (timer) {
-                    clearTimeout(timer);
-                    timer = null;
-                }
-                resolve();
-            });
-            child.on('exit', (code, signal) => {
-                if (timer) {
-                    clearTimeout(timer);
-                    timer = null;
-                }
-                logger.info(`[BackgroundExecutor] phase ${phaseIndex} child exit code=${code} signal=${signal}`);
-                if (exitReason === 'timeout') {
-                    // already set
-                }
-                else if (this.cancelRequested.has(execution.id) ||
-                    signal === 'SIGKILL' ||
-                    signal === 'SIGTERM' ||
-                    // macOS 下 SIGTERM 杀掉的 child，Node 会报 code=143 (128+SIGTERM) / signal=null，
-                    // SIGKILL 对应 code=137。无论 signal 字段形状如何，都认定为 cancelled。
-                    code === 143 ||
-                    code === 137) {
-                    // manual cancel takes priority over natural completion semantics
-                    if (exitReason === 'completed')
-                        exitReason = 'cancelled';
-                }
-                else if (code !== 0 && exitReason === 'completed') {
-                    exitReason = 'failed';
-                    capturedErrorMessage = capturedErrorMessage ?? `claude -p exited with code ${code}`;
-                }
-                resolve();
-            });
-        });
-        child.stdin.end(directive);
-        await waitForExit;
-        this.running.delete(execution.id);
-        this.cancelRequested.delete(execution.id);
-        logStream.end();
-        const durationMs = Date.now() - startedAt;
-        // exitReason 的三路映射：
-        //   completed  -> 'completed'
-        //   cancelled  -> 'cancelled'（需要 schema 支持，见 runMigrations）
-        //   failed/timeout -> 'failed'
-        const phaseStatus = exitReason === 'completed'
-            ? 'completed'
-            : exitReason === 'cancelled'
-                ? 'cancelled'
-                : 'failed';
-        this.storage.updatePhaseExecution(phaseExecId, {
-            status: phaseStatus,
-            completed_at: Date.now(),
-            output_text: finalText ?? null,
-            error_message: capturedErrorMessage,
-        });
-        this.emit({
-            type: 'phase-finish',
-            execution_id: execution.id,
-            phase_index: phaseIndex,
-            phase_id: phase.id,
-            timestamp: Date.now(),
-            payload: { status: phaseStatus, duration_ms: durationMs, session_id: capturedSessionId },
-        });
-        if (exitReason === 'completed') {
-            return {
-                status: 'completed',
-                phase_index: phaseIndex,
-                phase_id: phase.id,
-                output_text: finalText ?? undefined,
-                duration_ms: durationMs,
-            };
-        }
-        if (exitReason === 'cancelled') {
-            return {
-                status: 'cancelled',
-                phase_index: phaseIndex,
-                phase_id: phase.id,
-                error: capturedErrorMessage ?? 'cancelled',
-                duration_ms: durationMs,
-            };
-        }
-        return {
-            status: 'failed',
-            phase_index: phaseIndex,
-            phase_id: phase.id,
-            error: capturedErrorMessage ?? 'unknown failure',
-            duration_ms: durationMs,
-        };
-    }
-    async cancel(execution_id) {
-        this.cancelRequested.add(execution_id);
-        const child = this.running.get(execution_id);
-        if (child) {
-            logger.info(`[BackgroundExecutor] kill worker pid=${child.pid} for execution=${execution_id}`);
-            child.kill('SIGTERM');
-            setTimeout(() => {
-                if (!child.killed)
-                    child.kill('SIGKILL');
-            }, 5000);
-        }
-        this.storage.updateMethodologyExecution(execution_id, {
-            status: 'cancelled',
-            completed_at: Date.now(),
-            worker_pid: null,
-        });
-        this.emit({
-            type: 'done',
-            execution_id,
-            timestamp: Date.now(),
-            payload: { reason: 'cancelled' },
-        });
-    }
-    subscribe(listener) {
-        this.listeners.add(listener);
-        return () => { this.listeners.delete(listener); };
-    }
-    emit(event) {
-        for (const l of this.listeners) {
-            try {
-                l(event);
-            }
-            catch (err) {
-                logger.debug(`[BackgroundExecutor] listener failed: ${err}`);
-            }
-        }
-    }
-    /**
-     * @internal test-only: 构建 spawn 参数。生产代码请走 `executePhase`。
-     */
-    buildArgs() {
-        const args = [
-            '-p',
-            '--output-format', 'stream-json',
-            '--verbose', // required for stream-json with -p
-            '--include-hook-events',
-            '--permission-mode', this.opts.permissionMode,
-            '--max-budget-usd', String(this.opts.maxBudgetUsdPerPhase),
-            '--no-session-persistence',
-            '--settings', this.opts.settingsPath, // worker 用空 hooks settings，避免再触发 daemon hook
-        ];
-        if (this.opts.disallowedTools) {
-            args.push('--disallowed-tools', this.opts.disallowedTools);
-        }
-        if (this.opts.projectRoot) {
-            args.push('--add-dir', this.opts.projectRoot);
-        }
-        return args;
-    }
-    /** @internal test-only */
-    getSettingsPath() {
-        return this.opts.settingsPath;
-    }
-}
-//# sourceMappingURL=background-executor.js.map