@winspan/claude-forge 8.28.1 → 8.30.0

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

@@ -0,0 +1,299 @@
+/**
+ * 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();
+    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 });
+        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 });
+            }
+            // 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 (signal === 'SIGKILL' || signal === 'SIGTERM') {
+                    // 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);
+        logStream.end();
+        const durationMs = Date.now() - startedAt;
+        const phaseStatus = exitReason === 'completed' ? 'completed' : '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) {
+        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,25 @@
+/**
+ * Orchestrator — 驱动一个 execution 的所有 phase 串行执行。
+ *
+ * 职责：
+ *  1. 从 storage 读取 execution 和 plan
+ *  2. 对每个 phase 调用 executor.executePhase()
+ *  3. 根据结果更新 methodology_executions 状态
+ *  4. 其中任一 phase 失败 / 取消 → 整个 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';
+export declare class Orchestrator {
+    private storage;
+    private executor;
+    constructor(storage: SQLiteStorage, executor: PhaseExecutor);
+    run(execution_id: number): Promise<void>;
+}
+//# 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;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,qBAAa,YAAY;IAErB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;gBADR,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa;IAG3B,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgE/C"}

package/dist/capability/executor/orchestrator.js

@@ -0,0 +1,79 @@
+/**
+ * Orchestrator — 驱动一个 execution 的所有 phase 串行执行。
+ *
+ * 职责：
+ *  1. 从 storage 读取 execution 和 plan
+ *  2. 对每个 phase 调用 executor.executePhase()
+ *  3. 根据结果更新 methodology_executions 状态
+ *  4. 其中任一 phase 失败 / 取消 → 整个 execution 标 failed/cancelled 并停止
+ *
+ * 前台模式下，executePhase 只是入队 directive（返回 'injected'）。此时
+ * orchestrator 不推进下一 phase —— 推进由 PostToolUse handler 基于实际
+ * 执行结果来做（已有机制）。所以前台模式下 orchestrator 只驱动 phase 0，
+ * 其余阶段由 daemon 既有路径推进。
+ *
+ * 后台模式下，executePhase 阻塞直到 phase 真正完成，orchestrator 再推进。
+ */
+import { logger } from '../../core/utils/logger.js';
+export class Orchestrator {
+    storage;
+    executor;
+    constructor(storage, executor) {
+        this.storage = storage;
+        this.executor = executor;
+    }
+    async run(execution_id) {
+        const execution = this.storage.getMethodologyExecution(execution_id);
+        if (!execution)
+            throw new Error(`execution ${execution_id} not found`);
+        if (execution.status !== 'running') {
+            logger.info(`[Orchestrator] execution ${execution_id} status=${execution.status}, nothing to do`);
+            return;
+        }
+        const plan = JSON.parse(execution.plan_json);
+        const startFrom = execution.current_phase_index ?? 0;
+        for (let i = startFrom; i < plan.phases.length; i++) {
+            const phase = plan.phases[i];
+            logger.info(`[Orchestrator] execution=${execution_id} phase=${i + 1}/${plan.phases.length} (${phase.id} → ${phase.agent})`);
+            const fresh = this.storage.getMethodologyExecution(execution_id);
+            if (fresh.status !== 'running') {
+                logger.info(`[Orchestrator] execution=${execution_id} status changed to ${fresh.status}, stopping`);
+                return;
+            }
+            this.storage.updateMethodologyExecution(execution_id, { current_phase_index: i });
+            const result = await this.executor.executePhase(fresh, phase, i);
+            if (this.executor.mode === 'foreground') {
+                // Foreground 模式：只入队第一阶段，后续由 PostToolUse 推进。
+                logger.info(`[Orchestrator] foreground injected phase ${i}, handing off to hook pipeline`);
+                return;
+            }
+            // Background 模式：result 指示 phase 的真实状态
+            if (result.status === 'failed') {
+                this.storage.updateMethodologyExecution(execution_id, {
+                    status: 'failed',
+                    completed_at: Date.now(),
+                    worker_pid: null,
+                });
+                logger.warn(`[Orchestrator] execution=${execution_id} failed at phase ${i}: ${result.error}`);
+                return;
+            }
+            if (result.status === 'cancelled') {
+                this.storage.updateMethodologyExecution(execution_id, {
+                    status: 'cancelled',
+                    completed_at: Date.now(),
+                    worker_pid: null,
+                });
+                logger.info(`[Orchestrator] execution=${execution_id} cancelled at phase ${i}`);
+                return;
+            }
+        }
+        // 所有 phase 完成
+        this.storage.updateMethodologyExecution(execution_id, {
+            status: 'completed',
+            completed_at: Date.now(),
+            worker_pid: null,
+        });
+        logger.info(`[Orchestrator] execution=${execution_id} completed all ${plan.phases.length} phases`);
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/capability/executor/orchestrator.js.map

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

package/dist/capability/executor/stream-parser.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Parse Claude CLI --output-format stream-json lines.
+ *
+ * 实际观测到的事件形状（claude 2.1.119）：
+ *  - {"type":"system","subtype":"init", session_id, tools, model, ...}
+ *  - {"type":"assistant","message":{"content":[{"type":"text","text":"..."} | {"type":"tool_use", name, input, id}]}, session_id, uuid}
+ *  - {"type":"user","message":{"content":[{"type":"tool_result", tool_use_id, content}]}, session_id}
+ *  - {"type":"result","subtype":"success"|"error", is_error, result, total_cost_usd, duration_ms, session_id, ...}
+ *
+ * 本模块只做轻量抽取，不把所有字段建模 —— 用 as StreamEvent 读取关心的几个。
+ */
+export type StreamEvent = {
+    type: 'system';
+    subtype?: string;
+    session_id?: string;
+    [k: string]: unknown;
+} | {
+    type: 'assistant';
+    message: {
+        content: Array<ContentBlock>;
+    };
+    session_id?: string;
+} | {
+    type: 'user';
+    message: {
+        content: Array<ContentBlock>;
+    };
+    session_id?: string;
+} | {
+    type: 'result';
+    subtype?: 'success' | 'error';
+    is_error?: boolean;
+    result?: string;
+    total_cost_usd?: number;
+    duration_ms?: number;
+    session_id?: string;
+    stop_reason?: string;
+};
+export type ContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: unknown;
+};
+export interface ParseResult {
+    event: StreamEvent | null;
+    error?: string;
+}
+export declare function parseStreamLine(line: string): ParseResult;
+/**
+ * Extract final assistant text from a result event (success subtype has `result` field).
+ */
+export declare function extractResultText(event: StreamEvent): string | null;
+/**
+ * Extract tool_use blocks from an assistant message event (for observability / agent detection).
+ */
+export declare function extractToolUses(event: StreamEvent): Array<{
+    id: string;
+    name: string;
+    input: unknown;
+}>;
+/**
+ * Does this event signal the end of the turn? Result events mark completion.
+ */
+export declare function isTerminal(event: StreamEvent): boolean;
+//# sourceMappingURL=stream-parser.d.ts.map

package/dist/capability/executor/stream-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-parser.d.ts","sourceRoot":"","sources":["../../../src/capability/executor/stream-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE;QAAE,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAYzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAKnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAQvG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEtD"}