@winspan/claude-forge 8.28.2 → 8.33.0

package/dist/capability/executor/orchestrator.js

@@ -0,0 +1,158 @@
+/**
+ * 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 { logger } from '../../core/utils/logger.js';
+export class Orchestrator {
+    storage;
+    executor;
+    planner;
+    enableReplan;
+    maxRetry;
+    constructor(storage, executor, planner, options) {
+        this.storage = storage;
+        this.executor = executor;
+        this.planner = planner;
+        this.enableReplan = options?.enableReplan ?? (process.env.ENABLE_METHODOLOGY_REPLAN !== 'false');
+        this.maxRetry = options?.maxRetry ?? parseInt(process.env.MAX_METHODOLOGY_RETRY || '2', 10);
+    }
+    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,
+                last_progress_at: Date.now(),
+            });
+            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') {
+                // 尝试失败反馈环
+                const replanSucceeded = await this.attemptReplan(execution_id, i, result.error || 'unknown error', plan);
+                if (replanSucceeded) {
+                    // Replan 成功，继续执行（从下一个 phase 开始，因为 plan 已更新）
+                    logger.info(`[Orchestrator] replan succeeded, continuing execution from phase ${i + 1}`);
+                    // 重新加载更新后的 plan
+                    const updatedExecution = this.storage.getMethodologyExecution(execution_id);
+                    const updatedPlan = JSON.parse(updatedExecution.plan_json);
+                    // 递归调用 run 以继续执行更新后的计划
+                    return this.run(execution_id);
+                }
+                // Replan 失败或未启用，标记 execution 为 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`);
+    }
+    /**
+     * 尝试重新规划（失败反馈环）
+     * @returns true 如果 replan 成功并更新了 plan，false 否则
+     */
+    async attemptReplan(execution_id, failedPhaseIndex, failureReason, currentPlan) {
+        // 检查是否启用 replan
+        if (!this.enableReplan) {
+            logger.info('[Orchestrator] replan disabled by configuration');
+            return false;
+        }
+        // 检查是否有 planner
+        if (!this.planner) {
+            logger.info('[Orchestrator] no planner available for replan');
+            return false;
+        }
+        // 检查 retry_count 是否达到上限
+        const execution = this.storage.getMethodologyExecution(execution_id);
+        const retryCount = execution.retry_count ?? 0;
+        if (retryCount >= this.maxRetry) {
+            logger.info(`[Orchestrator] retry_count=${retryCount} reached max=${this.maxRetry}, not replanning`);
+            return false;
+        }
+        logger.info(`[Orchestrator] attempting replan for execution=${execution_id}, phase=${failedPhaseIndex}, retry=${retryCount + 1}/${this.maxRetry}`);
+        // 获取原始计划
+        const originalPlan = execution.original_plan_json
+            ? JSON.parse(execution.original_plan_json)
+            : currentPlan;
+        // 获取已完成的 phases
+        const completedPhases = currentPlan.phases.slice(0, failedPhaseIndex);
+        try {
+            // 调用 planner.replan()
+            const newPlan = await this.planner.replan({
+                executionId: execution_id,
+                failedPhaseIndex,
+                failureReason,
+                originalPlan,
+                completedPhases,
+            });
+            if (!newPlan) {
+                logger.info('[Orchestrator] planner determined recovery not possible');
+                return false;
+            }
+            // 更新 execution 的 plan 和 retry_count
+            this.storage.updateMethodologyExecution(execution_id, {
+                plan_json: JSON.stringify(newPlan),
+                retry_count: retryCount + 1,
+                current_phase_index: failedPhaseIndex, // 从失败的 phase 重新开始
+                last_progress_at: Date.now(),
+            });
+            logger.info(`[Orchestrator] replan successful, updated plan with ${newPlan.phases.length} phases`);
+            return true;
+        }
+        catch (err) {
+            logger.warn(`[Orchestrator] replan failed with error: ${err}`);
+            return false;
+        }
+    }
+}
+//# 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"}

package/dist/capability/executor/stream-parser.js

@@ -0,0 +1,56 @@
+/**
+ * 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 function parseStreamLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return { event: null };
+    try {
+        const obj = JSON.parse(trimmed);
+        if (obj && typeof obj === 'object' && 'type' in obj) {
+            return { event: obj };
+        }
+        return { event: null, error: 'not a stream-json event (missing type)' };
+    }
+    catch (err) {
+        return { event: null, error: `JSON parse failed: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+/**
+ * Extract final assistant text from a result event (success subtype has `result` field).
+ */
+export function extractResultText(event) {
+    if (event.type === 'result' && 'result' in event && typeof event.result === 'string') {
+        return event.result;
+    }
+    return null;
+}
+/**
+ * Extract tool_use blocks from an assistant message event (for observability / agent detection).
+ */
+export function extractToolUses(event) {
+    if (event.type !== 'assistant')
+        return [];
+    const blocks = event.message?.content ?? [];
+    const out = [];
+    for (const b of blocks) {
+        if (b.type === 'tool_use')
+            out.push({ id: b.id, name: b.name, input: b.input });
+    }
+    return out;
+}
+/**
+ * Does this event signal the end of the turn? Result events mark completion.
+ */
+export function isTerminal(event) {
+    return event.type === 'result';
+}
+//# sourceMappingURL=stream-parser.js.map

package/dist/capability/executor/stream-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-parser.js","sourceRoot":"","sources":["../../../src/capability/executor/stream-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA2BH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;QAC/C,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YACpD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;IAC1E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IAC1G,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACrF,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAwD,EAAE,CAAC;IACpE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACjC,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Methodology Phase Executor — 接口 & 公共类型
+ *
+ * 两种执行模式复用同一份 plan 数据：
+ *  - foreground：走 hook 注入，Claude 主会话执行（现有机制 + Phase A 兜底）
+ *  - background：spawn `claude -p` 子进程独立驱动（Phase C）
+ */
+import type { MethodologyExecution, PlannedPhase } from '../types.js';
+export type ExecutorMode = 'foreground' | 'background';
+export interface PhaseExecutionResult {
+    /** 'injected' — foreground 已把指令注入；实际执行由 hook 链路完成 */
+    /** 'completed' — background 子进程跑完并标记 phase 完成 */
+    /** 'failed' — 执行失败（error 字段说明原因） */
+    /** 'cancelled' — 被手动取消 */
+    status: 'injected' | 'completed' | 'failed' | 'cancelled';
+    phase_index: number;
+    phase_id: string;
+    output_text?: string;
+    error?: string;
+    duration_ms?: number;
+}
+export interface ExecutorEvent {
+    type: 'phase-start' | 'phase-log' | 'phase-finish' | 'done' | 'error';
+    execution_id: number;
+    phase_index?: number;
+    phase_id?: string;
+    payload?: unknown;
+    timestamp: number;
+}
+export type ExecutorEventListener = (event: ExecutorEvent) => void;
+export interface PhaseExecutor {
+    readonly mode: ExecutorMode;
+    /**
+     * 执行一个 phase。各模式的语义：
+     *  - foreground：把 directive 放入 pending queue，立即返回 status='injected'
+     *  - background：spawn claude -p 并等待返回，更新 phase_executions 表
+     */
+    executePhase(execution: MethodologyExecution, phase: PlannedPhase, phaseIndex: number): Promise<PhaseExecutionResult>;
+    /** 取消正在运行的 execution（background 会 kill 子进程；foreground 清队列） */
+    cancel(execution_id: number): Promise<void>;
+    /** 监听执行过程事件（用于 SSE / UI 实时展示） */
+    subscribe(listener: ExecutorEventListener): () => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/capability/executor/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,iDAAiD;IACjD,oCAAoC;IACpC,0BAA0B;IAC1B,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EACA,aAAa,GACb,WAAW,GACX,cAAc,GACd,MAAM,GACN,OAAO,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B;;;;OAIG;IACH,YAAY,CACV,SAAS,EAAE,oBAAoB,EAC/B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC,8DAA8D;IAC9D,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,iCAAiC;IACjC,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAC;CACxD"}

package/dist/capability/executor/types.js

@@ -0,0 +1,9 @@
+/**
+ * Methodology Phase Executor — 接口 & 公共类型
+ *
+ * 两种执行模式复用同一份 plan 数据：
+ *  - foreground：走 hook 注入，Claude 主会话执行（现有机制 + Phase A 兜底）
+ *  - background：spawn `claude -p` 子进程独立驱动（Phase C）
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/capability/executor/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/capability/executor/worker-auth-probe.d.ts

@@ -0,0 +1,30 @@
+/**
+ * worker-auth-probe —— 轻量探测 claude CLI 是否拥有可用认证。
+ *
+ * 设计原则：
+ *  - 不启动子进程、不做网络调用，只看 env / 磁盘文件
+ *  - 宁可 false-negative（判 available=true 实际失败后由 worker 报错），
+ *    也不 false-positive 阻断能跑的场景
+ *  - 只检查 env `ANTHROPIC_API_KEY` 和 `~/.claude/.credentials.json`，
+ *    不探测 macOS keychain（平台相关，成本高于收益）
+ */
+export type WorkerAuthMethod = 'api-key-env' | 'oauth-token' | 'keychain' | 'unknown' | 'none';
+export interface WorkerAuthProbe {
+    available: boolean;
+    method: WorkerAuthMethod;
+    message: string;
+}
+/**
+ * 后台 worker 认证缺失错误，带 `code` 便于上层（Web API）分流返回 503。
+ */
+export declare class WorkerAuthError extends Error {
+    readonly code: "AUTH_REQUIRED";
+    readonly probe: WorkerAuthProbe;
+    constructor(probe: WorkerAuthProbe);
+}
+export interface ProbeOptions {
+    /** 覆盖凭据文件路径，便于测试 */
+    credentialsPath?: string;
+}
+export declare function probeWorkerAuth(options?: ProbeOptions): WorkerAuthProbe;
+//# sourceMappingURL=worker-auth-probe.d.ts.map

package/dist/capability/executor/worker-auth-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-auth-probe.d.ts","sourceRoot":"","sources":["../../../src/capability/executor/worker-auth-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,aAAa,GACb,UAAU,GACV,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAU;IACzC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;gBAEpB,KAAK,EAAE,eAAe;CAQnC;AAoCD,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,YAAiB,GAAG,eAAe,CA8C3E"}

package/dist/capability/executor/worker-auth-probe.js

@@ -0,0 +1,108 @@
+/**
+ * worker-auth-probe —— 轻量探测 claude CLI 是否拥有可用认证。
+ *
+ * 设计原则：
+ *  - 不启动子进程、不做网络调用，只看 env / 磁盘文件
+ *  - 宁可 false-negative（判 available=true 实际失败后由 worker 报错），
+ *    也不 false-positive 阻断能跑的场景
+ *  - 只检查 env `ANTHROPIC_API_KEY` 和 `~/.claude/.credentials.json`，
+ *    不探测 macOS keychain（平台相关，成本高于收益）
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+/**
+ * 后台 worker 认证缺失错误，带 `code` 便于上层（Web API）分流返回 503。
+ */
+export class WorkerAuthError extends Error {
+    code = 'AUTH_REQUIRED';
+    probe;
+    constructor(probe) {
+        super(`Background mode requires Claude authentication: ${probe.message}. ` +
+            'Set ANTHROPIC_API_KEY (or ANTHROPIC_AUTH_TOKEN for third-party proxies), or run `claude login` first.');
+        this.name = 'WorkerAuthError';
+        this.probe = probe;
+    }
+}
+/**
+ * 默认 OAuth 凭据文件路径：`~/.claude/.credentials.json`
+ * 官方 claude-code 在首次登录后写到这里。
+ */
+function defaultCredentialsPath() {
+    return path.join(homedir(), '.claude', '.credentials.json');
+}
+function isNonEmptyString(v) {
+    return typeof v === 'string' && v.trim().length > 0;
+}
+/**
+ * 粗判 credentials.json 是否"像"一份合法的 OAuth 凭据。
+ * 只要能 parse 出对象且含任何 token 形字段就算通过——实际有效性交给 worker 验证。
+ */
+function looksLikeOAuthCredentials(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object')
+            return false;
+        const obj = parsed;
+        // 常见字段：claudeAiOauth.accessToken / accessToken / oauth / tokens 等
+        // 宽松识别即可：有对象内容就认为配过
+        if (isNonEmptyString(obj.accessToken))
+            return true;
+        if (obj.claudeAiOauth && typeof obj.claudeAiOauth === 'object')
+            return true;
+        if (obj.oauth && typeof obj.oauth === 'object')
+            return true;
+        if (obj.tokens && typeof obj.tokens === 'object')
+            return true;
+        // 兜底：只要 JSON 不是空对象就当有配置
+        return Object.keys(obj).length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export function probeWorkerAuth(options = {}) {
+    // 1) env 优先
+    const envKey = process.env.ANTHROPIC_API_KEY;
+    if (isNonEmptyString(envKey)) {
+        return {
+            available: true,
+            method: 'api-key-env',
+            message: 'ANTHROPIC_API_KEY env is set',
+        };
+    }
+    // 1b) 第三方代理（如 iFlytek / OneHub）使用 ANTHROPIC_AUTH_TOKEN
+    const envToken = process.env.ANTHROPIC_AUTH_TOKEN;
+    if (isNonEmptyString(envToken)) {
+        return {
+            available: true,
+            method: 'api-key-env',
+            message: 'ANTHROPIC_AUTH_TOKEN env is set',
+        };
+    }
+    // 2) OAuth credentials 文件
+    const credPath = options.credentialsPath ?? defaultCredentialsPath();
+    if (existsSync(credPath)) {
+        try {
+            const raw = readFileSync(credPath, 'utf-8');
+            if (looksLikeOAuthCredentials(raw)) {
+                return {
+                    available: true,
+                    method: 'oauth-token',
+                    message: `OAuth credentials found at ${credPath}`,
+                };
+            }
+        }
+        catch {
+            // ignore — 读失败当作不可用
+        }
+    }
+    // 3) 都没有
+    return {
+        available: false,
+        method: 'none',
+        message: 'no ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN env and no OAuth credentials on disk ' +
+            `(expected ${credPath})`,
+    };
+}
+//# sourceMappingURL=worker-auth-probe.js.map

package/dist/capability/executor/worker-auth-probe.js.map

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

package/dist/capability/methodologies/bmad.yaml

@@ -10,11 +10,23 @@ trigger:
   complexity:
     - moderate
     - complex
+  # keywords 命中才触发，避免 taskType + complexity 导致的误触发
+  # BMad 是四角色敏捷方法论，面向 story/sprint 级别的完整功能开发
   keywords:
-    - feature
-    - implement
-    - develop
-    - build
+    - 敏捷
+    - agile
+    - story
+    - 用户故事
+    - user story
+    - sprint
+    - 迭代
+    - 需求分析
+    - 产品需求
+    - 完整功能
+    - 端到端
+    - end-to-end
+    - 四角色
+    - bmad
 
 # 阶段模板库
 phase_templates:
@@ -28,7 +40,7 @@ phase_templates:
         required: true
 
   design:
-    agent: architect
+    agent: planner
     prompt_template: "As Architect: Design technical solution for {target}. Based on requirements document. Output: architecture design, module structure, interfaces, data flow. Document to docs/{target}-design.md"
     description: "Architect designs technical solution"
     artifacts:

package/dist/capability/methodologies/code-quality-audit.yaml

@@ -0,0 +1,26 @@
+id: code-quality-audit
+name: "代码质量审计"
+description: "Automated code quality audit during idle time"
+
+# Idle 触发配置
+idle_trigger:
+  enabled: true
+  interval: 7200000  # 2 小时（毫秒）
+  priority: low
+
+# 不设置 trigger，因为这是 idle 专用方法论
+trigger:
+  taskType: []
+  complexity: []
+  keywords: []
+
+# 单阶段审计任务
+phase_templates:
+  audit:
+    agent: reviewer
+    prompt_template: "Audit code quality: check for code smells, security issues, performance bottlenecks. Output report to docs/code-quality-audit.md"
+    description: "Audit code quality"
+    artifacts:
+      - type: file
+        pattern: "docs/**/*audit*.md"
+        required: false

package/dist/capability/methodologies/harness-engineering.yaml

@@ -10,12 +10,18 @@ trigger:
   complexity:
     - moderate
     - complex
-  # keywords 是可选的，如果不定义则不检查
-  # keywords:
-  #   - refactor
-  #   - migrate
-  #   - legacy
-  #   - technical debt
+  # keywords 命中才触发，避免 taskType + complexity 导致的误触发
+  keywords:
+    - 重构
+    - refactor
+    - 迁移
+    - migrate
+    - 遗留代码
+    - legacy
+    - 技术债
+    - technical debt
+    - 改写
+    - rewrite
 
 # 阶段模板库（供 AI Planner 选择）
 phase_templates:

package/dist/capability/methodologies/test-coverage-scan.yaml

@@ -0,0 +1,26 @@
+id: test-coverage-scan
+name: "测试覆盖率扫描"
+description: "Automated test coverage analysis during idle time"
+
+# Idle 触发配置
+idle_trigger:
+  enabled: true
+  interval: 3600000  # 1 小时（毫秒）
+  priority: low
+
+# 不设置 trigger，因为这是 idle 专用方法论
+trigger:
+  taskType: []
+  complexity: []
+  keywords: []
+
+# 单阶段扫描任务
+phase_templates:
+  scan:
+    agent: researcher
+    prompt_template: "Analyze test coverage for the project. Identify untested modules and critical paths. Output report to docs/test-coverage-report.md"
+    description: "Scan test coverage"
+    artifacts:
+      - type: test_coverage
+        min: 0
+        required: false