@winspan/claude-forge 8.28.2 → 8.33.0

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,58 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,322 @@
+/**
+ * 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

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * ForegroundExecutor —— 把 Phase A 的 pending-queue 逻辑收敛成 PhaseExecutor 实现。
+ *
+ * 重要约束：daemon 不能主动 push 到 Claude 主对话，所以 `executePhase` 只是
+ * 把本阶段的 directive 放入 pending queue。真正的"Claude 执行"发生在下一次
+ * UserPromptSubmit 被消费时，以及由 PostToolUse 推进阶段。
+ *
+ * 这让 Orchestrator 的逻辑在两种模式下形状一致：executePhase → wait → next。
+ * 前台的 "wait" 实际上立即返回 'injected'，由外部 hook 路径驱动后续。
+ */
+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 declare class ForegroundExecutor implements PhaseExecutor {
+    private storage;
+    private registry;
+    readonly mode: "foreground";
+    private listeners;
+    constructor(storage: SQLiteStorage, registry: MethodologyRegistry);
+    executePhase(execution: MethodologyExecution, phase: PlannedPhase, phaseIndex: number): Promise<PhaseExecutionResult>;
+    cancel(execution_id: number): Promise<void>;
+    subscribe(listener: ExecutorEventListener): () => void;
+    private emit;
+}
+//# sourceMappingURL=foreground-executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"foreground-executor.d.ts","sourceRoot":"","sources":["../../../src/capability/executor/foreground-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAiB,oBAAoB,EAAE,YAAY,EAAE,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;AAKpB,qBAAa,kBAAmB,YAAW,aAAa;IAKpD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IALlB,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IACtC,OAAO,CAAC,SAAS,CAAoC;gBAG3C,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,mBAAmB;IAGjC,YAAY,CAChB,SAAS,EAAE,oBAAoB,EAC/B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC;IA4C1B,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjD,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAKtD,OAAO,CAAC,IAAI;CAKb"}

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

@@ -0,0 +1,82 @@
+/**
+ * ForegroundExecutor —— 把 Phase A 的 pending-queue 逻辑收敛成 PhaseExecutor 实现。
+ *
+ * 重要约束：daemon 不能主动 push 到 Claude 主对话，所以 `executePhase` 只是
+ * 把本阶段的 directive 放入 pending queue。真正的"Claude 执行"发生在下一次
+ * UserPromptSubmit 被消费时，以及由 PostToolUse 推进阶段。
+ *
+ * 这让 Orchestrator 的逻辑在两种模式下形状一致：executePhase → wait → next。
+ * 前台的 "wait" 实际上立即返回 'injected'，由外部 hook 路径驱动后续。
+ */
+import { formatMethodologyPhaseDirective } from '../../daemon/handlers/methodology-formatter.js';
+import { getMethodologyPendingQueue } from '../../daemon/methodology-pending-queue.js';
+import { logger } from '../../core/utils/logger.js';
+export class ForegroundExecutor {
+    storage;
+    registry;
+    mode = 'foreground';
+    listeners = new Set();
+    constructor(storage, registry) {
+        this.storage = storage;
+        this.registry = registry;
+    }
+    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 = formatMethodologyPhaseDirective(methodology, plan, phase, phaseIndex, execution.id);
+        getMethodologyPendingQueue().enqueue({
+            session_id: execution.session_id,
+            execution_id: execution.id,
+            phase_index: phaseIndex,
+            directive,
+            enqueued_at: Date.now(),
+            reason: 'cold-restart',
+        });
+        this.emit({
+            type: 'phase-start',
+            execution_id: execution.id,
+            phase_index: phaseIndex,
+            phase_id: phase.id,
+            timestamp: Date.now(),
+            payload: { mode: 'foreground', agent: phase.agent },
+        });
+        logger.info(`[ForegroundExecutor] Injected directive for execution=${execution.id} phase=${phaseIndex}`);
+        return { status: 'injected', phase_index: phaseIndex, phase_id: phase.id };
+    }
+    async cancel(execution_id) {
+        getMethodologyPendingQueue().purgeByExecutionId(execution_id);
+        this.storage.updateMethodologyExecution(execution_id, {
+            status: 'cancelled',
+            completed_at: Date.now(),
+        });
+        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(`[ForegroundExecutor] listener failed: ${err}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=foreground-executor.js.map

package/dist/capability/executor/foreground-executor.js.map

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

package/dist/capability/executor/orchestrator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Orchestrator — 驱动一个 execution 的所有 phase 串行执行。
+ *
+ * 职责：
+ *  1. 从 storage 读取 execution 和 plan
+ *  2. 对每个 phase 调用 executor.executePhase()
+ *  3. 根据结果更新 methodology_executions 状态
+ *  4. 其中任一 phase 失败 → 尝试 replan（如果启用）
+ *  5. 如果 replan 失败或取消 → 整个 execution 标 failed/cancelled 并停止
+ *
+ * 前台模式下，executePhase 只是入队 directive（返回 'injected'）。此时
+ * orchestrator 不推进下一 phase —— 推进由 PostToolUse handler 基于实际
+ * 执行结果来做（已有机制）。所以前台模式下 orchestrator 只驱动 phase 0，
+ * 其余阶段由 daemon 既有路径推进。
+ *
+ * 后台模式下，executePhase 阻塞直到 phase 真正完成，orchestrator 再推进。
+ */
+import type { SQLiteStorage } from '../../core/storage/sqlite.js';
+import type { PhaseExecutor } from './types.js';
+import type { MethodologyPlanner } from '../methodology-planner.js';
+export declare class Orchestrator {
+    private storage;
+    private executor;
+    private planner?;
+    private readonly enableReplan;
+    private readonly maxRetry;
+    constructor(storage: SQLiteStorage, executor: PhaseExecutor, planner?: MethodologyPlanner | undefined, options?: {
+        enableReplan?: boolean;
+        maxRetry?: number;
+    });
+    run(execution_id: number): Promise<void>;
+    /**
+     * 尝试重新规划（失败反馈环）
+     * @returns true 如果 replan 成功并更新了 plan，false 否则
+     */
+    private attemptReplan;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/capability/executor/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/capability/executor/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,qBAAa,YAAY;IAKrB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO,CAAC;IANlB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGxB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,kBAAkB,YAAA,EACpC,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAMG,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiF9C;;;OAGG;YACW,aAAa;CAkE5B"}