@winspan/claude-forge 4.1.0 → 6.0.0

package/dist/resume/index.js

@@ -1,114 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { SessionStateMachine } from './state-machine.js';
-import { TIME } from '../constants.js';
-import { ResumeContextGenerator } from './context-gen.js';
-import { logger } from '../utils/logger.js';
-import { buildForgeResumeEnvelope, hasForgeResumeBlock, stripForgeResumeBlocks, } from '../utils/forge-resume-block.js';
-export class ResumeEngine {
-    storage;
-    stateMachine;
-    contextGen;
-    maxAgeDays;
-    lastSaveTime = new Map(); // projectPath → timestamp
-    saveCooldownMs = TIME.THREE_MINUTES; // 3 分钟冷却
-    claudeMdWriter;
-    constructor(storage, api, claudeMdWriter, timeoutMinutes = 10, maxAgeDays = 7) {
-        this.storage = storage;
-        this.stateMachine = new SessionStateMachine(storage, timeoutMinutes);
-        this.contextGen = new ResumeContextGenerator(storage, api);
-        this.maxAgeDays = maxAgeDays;
-        this.claudeMdWriter = claudeMdWriter;
-    }
-    /**
-     * 会话结束时调用：立即生成续接摘要并保存，下次进来直接可用
-     */
-    async saveOnStop(sessionId, projectPath) {
-        const session = this.storage.getSession(sessionId, projectPath);
-        if (!session || session.event_count < 3) {
-            return;
-        }
-        logger.info(`正在为会话 ${sessionId} 生成续接快照`);
-        const context = await this.contextGen.generate(session);
-        await this.injectToClaudeMd(projectPath, context);
-        this.lastSaveTime.set(projectPath, Date.now());
-        logger.info(`续接快照已保存：${projectPath}`);
-    }
-    /**
-     * 中途实时更新：蒸馏完成后自动刷新 resume 块
-     * 带冷却控制，避免频繁调用 API
-     */
-    async saveIncremental(sessionId, projectPath) {
-        // 冷却检查
-        const lastSave = this.lastSaveTime.get(projectPath) || 0;
-        if (Date.now() - lastSave < this.saveCooldownMs) {
-            logger.info(`[续接] ${projectPath} 处于冷却中，跳过`);
-            return;
-        }
-        const session = this.storage.getSession(sessionId, projectPath);
-        if (!session || session.event_count < 5) {
-            return;
-        }
-        logger.info(`[续接] 增量更新：${projectPath}`);
-        const context = await this.contextGen.generate(session);
-        await this.injectToClaudeMd(projectPath, context);
-        this.lastSaveTime.set(projectPath, Date.now());
-    }
-    /**
-     * 新会话开始时调用：检查是否有上次的续接上下文
-     * 如果已经由 saveOnStop 预生成了，直接展示（不需要再调 API）
-     */
-    async checkAndInject(projectPath) {
-        // 检查根目录 CLAUDE.md 是否已有 resume 区块（由 saveOnStop 生成）
-        const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
-        if (fs.existsSync(claudeMdPath)) {
-            const content = fs.readFileSync(claudeMdPath, 'utf-8');
-            if (hasForgeResumeBlock(content)) {
-                logger.info('续接上下文已存在（来自 saveOnStop）');
-                return true;
-            }
-        }
-        // 否则检查是否有中断会话，实时生成
-        const interrupted = this.stateMachine.checkInterrupted(projectPath);
-        if (!interrupted) {
-            return false;
-        }
-        if (this.stateMachine.isExpired(interrupted, this.maxAgeDays)) {
-            logger.info(`中断会话 ${interrupted.session_id} 已过期（> ${this.maxAgeDays} 天），跳过`);
-            this.stateMachine.markAbandoned(interrupted.session_id);
-            return false;
-        }
-        logger.info(`正在为中断会话 ${interrupted.session_id} 生成续接上下文`);
-        const context = await this.contextGen.generate(interrupted);
-        await this.injectToClaudeMd(projectPath, context);
-        this.stateMachine.markResumed(interrupted.session_id);
-        logger.info('续接上下文已注入 CLAUDE.md');
-        return true;
-    }
-    /**
-     * 清除根目录 CLAUDE.md 中的所有 resume 区块
-     */
-    async clearResumeBlock(projectPath) {
-        await this.claudeMdWriter.atomicWrite(projectPath, (content) => {
-            const hadBlock = hasForgeResumeBlock(content);
-            const cleaned = stripForgeResumeBlocks(content) + '\n';
-            if (hadBlock) {
-                logger.info('CLAUDE.md 中的续接区块已清除');
-            }
-            return cleaned;
-        });
-    }
-    async injectToClaudeMd(projectPath, context) {
-        if (!context.trim()) {
-            logger.info('[Resume] 内容为空，跳过注入');
-            return;
-        }
-        const innerMd = `## 上次工作续接\n\n${context.trim()}`;
-        const resumeBlock = buildForgeResumeEnvelope(innerMd);
-        await this.claudeMdWriter.atomicWrite(projectPath, (content) => {
-            const base = stripForgeResumeBlocks(content);
-            return base + '\n\n' + resumeBlock + '\n';
-        });
-    }
-}
-//# sourceMappingURL=index.js.map

package/dist/resume/index.js.map

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

package/dist/resume/state-machine.d.ts

@@ -1,21 +0,0 @@
-import type { StorageEngine } from '../storage/index.js';
-import type { Session } from '../types/session.js';
-export declare class SessionStateMachine {
-    private storage;
-    private timeoutMinutes;
-    constructor(storage: StorageEngine, timeoutMinutes?: number);
-    /**
-     * 检查项目下是否有被中断的会话
-     */
-    checkInterrupted(projectPath: string): Session | null;
-    /**
-     * 标记会话状态转换
-     */
-    markResumed(sessionId: string): void;
-    markAbandoned(sessionId: string): void;
-    /**
-     * 检查中断会话是否已过期（超过 maxAgeDays 天）
-     */
-    isExpired(session: Session, maxAgeDays?: number): boolean;
-}
-//# sourceMappingURL=state-machine.d.ts.map

package/dist/resume/state-machine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/resume/state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,qBAAqB,CAAC;AAGlE,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,cAAc;gBADd,OAAO,EAAE,aAAa,EACtB,cAAc,GAAE,MAAW;IAGrC;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAkCrD;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO;CAM7D"}

package/dist/resume/state-machine.js

@@ -1,58 +0,0 @@
-import { logger } from '../utils/logger.js';
-export class SessionStateMachine {
-    storage;
-    timeoutMinutes;
-    constructor(storage, timeoutMinutes = 10) {
-        this.storage = storage;
-        this.timeoutMinutes = timeoutMinutes;
-    }
-    /**
-     * 检查项目下是否有被中断的会话
-     */
-    checkInterrupted(projectPath) {
-        // 1. 检查 active 会话是否已超时
-        const activeSessions = this.storage.querySessions({
-            project_path: projectPath,
-            status: 'active',
-        });
-        const now = Date.now();
-        for (const session of activeSessions) {
-            if (session.last_event_time) {
-                const lastTime = new Date(session.last_event_time).getTime();
-                const minutesSince = (now - lastTime) / 1000 / 60;
-                if (minutesSince > this.timeoutMinutes) {
-                    // 超时 → 标记为 interrupted
-                    this.storage.updateSessionStatus(session.session_id, 'interrupted');
-                    logger.info(`会话 ${session.session_id} 已标记为中断（${minutesSince.toFixed(0)} 分钟无活动）`);
-                    return { ...session, status: 'interrupted' };
-                }
-            }
-        }
-        // 2. 查找已标记为 interrupted 的会话（取最近一个）
-        const interrupted = this.storage.querySessions({
-            project_path: projectPath,
-            status: 'interrupted',
-        });
-        return interrupted.length > 0 ? interrupted[0] : null;
-    }
-    /**
-     * 标记会话状态转换
-     */
-    markResumed(sessionId) {
-        this.storage.updateSessionStatus(sessionId, 'resumed');
-        logger.info(`会话 ${sessionId} 已标记为已续接`);
-    }
-    markAbandoned(sessionId) {
-        this.storage.updateSessionStatus(sessionId, 'abandoned');
-        logger.info(`会话 ${sessionId} 已标记为已放弃`);
-    }
-    /**
-     * 检查中断会话是否已过期（超过 maxAgeDays 天）
-     */
-    isExpired(session, maxAgeDays = 7) {
-        const lastTime = session.last_event_time || session.start_time;
-        const daysSince = (Date.now() - new Date(lastTime).getTime()) / 1000 / 60 / 60 / 24;
-        return daysSince > maxAgeDays;
-    }
-}
-//# sourceMappingURL=state-machine.js.map

package/dist/resume/state-machine.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/resume/state-machine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,mBAAmB;IAEpB;IACA;IAFV,YACU,OAAsB,EACtB,iBAAyB,EAAE;QAD3B,YAAO,GAAP,OAAO,CAAe;QACtB,mBAAc,GAAd,cAAc,CAAa;IAClC,CAAC;IAEJ;;OAEG;IACH,gBAAgB,CAAC,WAAmB;QAClC,uBAAuB;QACvB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;YAChD,YAAY,EAAE,WAAW;YACzB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC7D,MAAM,YAAY,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;gBAElD,IAAI,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;oBACvC,uBAAuB;oBACvB,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;oBACpE,MAAM,CAAC,IAAI,CACT,MAAM,OAAO,CAAC,UAAU,WAAW,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACpE,CAAC;oBACF,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;YAC7C,YAAY,EAAE,WAAW;YACzB,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAAiB;QAC3B,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,MAAM,SAAS,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,MAAM,SAAS,UAAU,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAgB,EAAE,aAAqB,CAAC;QAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC;QAC/D,MAAM,SAAS,GACb,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACpE,OAAO,SAAS,GAAG,UAAU,CAAC;IAChC,CAAC;CACF"}

package/dist/retrospective/failure-detector.d.ts

@@ -1,17 +0,0 @@
-/**
- * 失败信号检测器 — 纯函数，无副作用
- *
- * 保守策略：只标记明确的不满意信号，避免误报
- * - DISSATISFIED: 用户明确表示不满意，需要重做
- * - ITERATION: 用户在大量工具调用后追加需求（可能是方向偏差）
- */
-import type { DetectedSignal, FailureDetectionContext } from './types.js';
-/**
- * 检测用户输入中的失败信号
- *
- * @param userPrompt 用户输入文本
- * @param context 检测上下文（工具调用数、当前阶段、时间戳）
- * @returns 检测到的信号，或 null（无信号）
- */
-export declare function detectFailureSignal(userPrompt: string, context: FailureDetectionContext): DetectedSignal | null;
-//# sourceMappingURL=failure-detector.d.ts.map

package/dist/retrospective/failure-detector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"failure-detector.d.ts","sourceRoot":"","sources":["../../src/retrospective/failure-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA4B1E;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,GAAG,IAAI,CA8BvB"}

package/dist/retrospective/failure-detector.js

@@ -1,67 +0,0 @@
-/**
- * 失败信号检测器 — 纯函数，无副作用
- *
- * 保守策略：只标记明确的不满意信号，避免误报
- * - DISSATISFIED: 用户明确表示不满意，需要重做
- * - ITERATION: 用户在大量工具调用后追加需求（可能是方向偏差）
- */
-/**
- * 明确不满意信号：用户要求重做或表示理解错误
- */
-const DISSATISFIED_PATTERNS = [
-    /重来|重新来|从头开始/,
-    /不对[，,。！!]|错了[，,。！!]/,
-    /你理解错了|理解有误|完全不对/,
-    /不是这个意思|不是我要的|不是我想要的/,
-    /全部删掉|全删了|推倒重来/,
-];
-/**
- * 迭代信号：用户追加需求（需结合工具调用数量判断）
- */
-const ITERATION_PATTERNS = [
-    /再加一个|另外还要|还需要/,
-    /改一下|调整一下|修改一下/,
-    /另外[，,]|还有[，,]|顺便/,
-];
-/**
- * 触发迭代信号的最小工具调用数阈值
- * 低于此值的追加需求视为正常对话，不记录为失败信号
- */
-const TOOL_COUNT_THRESHOLD = 5;
-/**
- * 检测用户输入中的失败信号
- *
- * @param userPrompt 用户输入文本
- * @param context 检测上下文（工具调用数、当前阶段、时间戳）
- * @returns 检测到的信号，或 null（无信号）
- */
-export function detectFailureSignal(userPrompt, context) {
-    // 优先检测明确不满意信号
-    for (const pattern of DISSATISFIED_PATTERNS) {
-        const match = userPrompt.match(pattern);
-        if (match) {
-            return {
-                signal_type: 'dissatisfied',
-                matched_text: match[0],
-                matched_pattern: pattern.source,
-                is_iteration: 0,
-            };
-        }
-    }
-    // 迭代信号：需要工具调用数超过阈值才记录
-    if (context.preceding_tool_count >= TOOL_COUNT_THRESHOLD) {
-        for (const pattern of ITERATION_PATTERNS) {
-            const match = userPrompt.match(pattern);
-            if (match) {
-                return {
-                    signal_type: 'iteration',
-                    matched_text: match[0],
-                    matched_pattern: pattern.source,
-                    is_iteration: 1,
-                };
-            }
-        }
-    }
-    return null;
-}
-//# sourceMappingURL=failure-detector.js.map

package/dist/retrospective/failure-detector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"failure-detector.js","sourceRoot":"","sources":["../../src/retrospective/failure-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,qBAAqB,GAAG;IAC5B,aAAa;IACb,qBAAqB;IACrB,iBAAiB;IACjB,qBAAqB;IACrB,eAAe;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,kBAAkB,GAAG;IACzB,eAAe;IACf,eAAe;IACf,kBAAkB;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,OAAgC;IAEhC,cAAc;IACd,KAAK,MAAM,OAAO,IAAI,qBAAqB,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,WAAW,EAAE,cAAc;gBAC3B,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;gBACtB,eAAe,EAAE,OAAO,CAAC,MAAM;gBAC/B,YAAY,EAAE,CAAC;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,OAAO,CAAC,oBAAoB,IAAI,oBAAoB,EAAE,CAAC;QACzD,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO;oBACL,WAAW,EAAE,WAAW;oBACxB,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;oBACtB,eAAe,EAAE,OAAO,CAAC,MAAM;oBAC/B,YAAY,EAAE,CAAC;iBAChB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/retrospective/index.d.ts

@@ -1,77 +0,0 @@
-/**
- * RetrospectiveEngine — 任务复盘分析器主类
- *
- * 组装 failure-detector、metrics-extractor、report-writer，
- * 对外暴露统一接口供 StopHandler 和 UserPromptHandler 调用
- */
-import type { ForgeEvent } from '../types/index.js';
-import type { StorageEngine } from '../storage/index.js';
-import type { AIProvider } from '../ai/types.js';
-import type { PhaseSnapshot, FailureSignal } from './types.js';
-import { KnowledgeGraph } from '../knowledge/graph.js';
-export type { TaskSession, FailureSignal, PhaseSnapshot } from './types.js';
-export interface RecordSignalInput {
-    session_id: string;
-    project_path: string;
-    task_session_id?: string;
-    signal_type: FailureSignal['signal_type'];
-    raw_prompt: string;
-    matched_pattern: string;
-    context_phase?: string;
-    is_iteration: 0 | 1;
-    preceding_tool_count: number;
-    timestamp: string;
-}
-export declare class RetrospectiveEngine {
-    private storage;
-    private patternLearner;
-    private strategyAdvisor;
-    private satisfactionInferrer;
-    private knowledgeGraph;
-    constructor(storage: StorageEngine, api?: AIProvider);
-    /**
-     * 获取知识图谱实例（供外部模块使用图遍历能力）
-     */
-    getKnowledgeGraph(): KnowledgeGraph;
-    /**
-     * 检测用户输入中的失败信号
-     * 返回检测到的信号（已写入 DB），或 null
-     */
-    detectFailureSignal(userPrompt: string, context: {
-        preceding_tool_count: number;
-        current_phase?: string;
-        timestamp: string;
-    }): RecordSignalInput | null;
-    /**
-     * 异步写入失败信号到 SQLite
-     */
-    recordFailureSignal(signal: RecordSignalInput): Promise<void>;
-    /**
-     * 执行完整复盘分析（在 Stop 事件后调用）
-     *
-     * @param event Stop 事件
-     * @param events 本次会话所有事件
-     * @param qualityPassCount 质量门禁通过次数（reset 前捕获）
-     * @param qualityFailCount 质量门禁失败次数
-     * @param phases 阶段快照（从 执行器 获取）
-     * @param requirement 任务需求描述（从 Pipeline 获取，可为空）
-     * @param pipelineId Pipeline ID（可选）
-     */
-    analyzeSession(event: ForgeEvent, events: ForgeEvent[], qualityPassCount: number, qualityFailCount: number, phases: PhaseSnapshot[], requirement: string, pipelineId?: string): Promise<void>;
-    /**
-     * 根据指标和失败信号判断任务结果
-     */
-    private determineOutcome;
-    /**
-     * 执行模式学习（每 10 次 Stop 触发）
-     * 返回提炼的模式总数
-     */
-    learnPatterns(): Promise<number>;
-    /**
-     * 获取任务类型相关的预防策略建议
-     * 供 UserPromptHandler 在检测到同类任务时注入
-     * @param taskType 可选，由上层意图分析传入，避免 StrategyAdvisor 重复分类导致误判
-     */
-    getStrategies(requirement: string, taskType?: import('./types.js').TaskType): string | null;
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/retrospective/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrospective/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAA0D,MAAM,YAAY,CAAC;AAOvH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,mBAAmB;IAMlB,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,cAAc,CAAiB;gBAEnB,OAAO,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,UAAU;IAS5D;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAInC;;;OAGG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACnF,iBAAiB,GAAG,IAAI;IAiB3B;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnE;;;;;;;;;;OAUG;IACG,cAAc,CAClB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,UAAU,EAAE,EACpB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,aAAa,EAAE,EACvB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAuIhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAwBtC;;;;OAIG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,YAAY,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;CAG5F"}

package/dist/retrospective/index.js

@@ -1,255 +0,0 @@
-/**
- * RetrospectiveEngine — 任务复盘分析器主类
- *
- * 组装 failure-detector、metrics-extractor、report-writer，
- * 对外暴露统一接口供 StopHandler 和 UserPromptHandler 调用
- */
-import { randomUUID } from 'node:crypto';
-import { detectFailureSignal } from './failure-detector.js';
-import { extractMetrics, classifyTaskType, assessComplexity } from './metrics-extractor.js';
-import { RetrospectiveReportWriter } from './report-writer.js';
-import { PatternLearner } from './pattern-learner.js';
-import { StrategyAdvisor } from './strategy-advisor.js';
-import { SatisfactionInferrer } from './satisfaction-inferrer.js';
-import { KnowledgeGraph } from '../knowledge/graph.js';
-import { DistillWriter } from '../distill/writer.js';
-import { logger } from '../utils/logger.js';
-export class RetrospectiveEngine {
-    storage;
-    patternLearner = null;
-    strategyAdvisor;
-    satisfactionInferrer;
-    knowledgeGraph;
-    constructor(storage, api) {
-        this.storage = storage;
-        this.strategyAdvisor = new StrategyAdvisor(storage);
-        this.satisfactionInferrer = new SatisfactionInferrer(storage);
-        this.knowledgeGraph = new KnowledgeGraph(storage);
-        if (api) {
-            this.patternLearner = new PatternLearner(storage, api);
-        }
-    }
-    /**
-     * 获取知识图谱实例（供外部模块使用图遍历能力）
-     */
-    getKnowledgeGraph() {
-        return this.knowledgeGraph;
-    }
-    /**
-     * 检测用户输入中的失败信号
-     * 返回检测到的信号（已写入 DB），或 null
-     */
-    detectFailureSignal(userPrompt, context) {
-        const detected = detectFailureSignal(userPrompt, context);
-        if (!detected)
-            return null;
-        return {
-            session_id: '', // 由调用方填充
-            project_path: '',
-            signal_type: detected.signal_type,
-            raw_prompt: userPrompt,
-            matched_pattern: detected.matched_pattern,
-            context_phase: context.current_phase,
-            is_iteration: detected.is_iteration,
-            preceding_tool_count: context.preceding_tool_count,
-            timestamp: context.timestamp,
-        };
-    }
-    /**
-     * 异步写入失败信号到 SQLite
-     */
-    async recordFailureSignal(signal) {
-        try {
-            this.storage.insertFailureSignal({
-                id: randomUUID(),
-                session_id: signal.session_id,
-                project_path: signal.project_path,
-                task_session_id: signal.task_session_id,
-                signal_type: signal.signal_type,
-                raw_prompt: signal.raw_prompt.slice(0, 500), // 截断防止过长
-                matched_pattern: signal.matched_pattern,
-                context_phase: signal.context_phase,
-                is_iteration: signal.is_iteration,
-                preceding_tool_count: signal.preceding_tool_count,
-                timestamp: signal.timestamp,
-            });
-            logger.debug(`[Forge:任务复盘] 记录失败信号：${signal.signal_type} — "${signal.matched_pattern}"`);
-        }
-        catch (err) {
-            logger.warn(`[Forge:任务复盘] 写入失败信号失败：${err}`);
-        }
-    }
-    /**
-     * 执行完整复盘分析（在 Stop 事件后调用）
-     *
-     * @param event Stop 事件
-     * @param events 本次会话所有事件
-     * @param qualityPassCount 质量门禁通过次数（reset 前捕获）
-     * @param qualityFailCount 质量门禁失败次数
-     * @param phases 阶段快照（从 执行器 获取）
-     * @param requirement 任务需求描述（从 Pipeline 获取，可为空）
-     * @param pipelineId Pipeline ID（可选）
-     */
-    async analyzeSession(event, events, qualityPassCount, qualityFailCount, phases, requirement, pipelineId) {
-        const { session_id, project_path } = event;
-        try {
-            // 查询本 session 失败信号
-            const rawSignals = this.storage.getFailureSignals({ session_id, project_path });
-            const failureSignals = rawSignals.map(r => ({
-                id: String(r['id'] ?? ''),
-                session_id: String(r['session_id'] ?? ''),
-                project_path: String(r['project_path'] ?? ''),
-                task_session_id: r['task_session_id'] ? String(r['task_session_id']) : undefined,
-                signal_type: String(r['signal_type'] ?? ''),
-                raw_prompt: String(r['raw_prompt'] ?? ''),
-                matched_pattern: String(r['matched_pattern'] ?? ''),
-                context_phase: r['context_phase'] ? String(r['context_phase']) : undefined,
-                is_iteration: (Number(r['is_iteration'] ?? 0)),
-                preceding_tool_count: Number(r['preceding_tool_count'] ?? 0),
-                timestamp: String(r['timestamp'] ?? ''),
-            }));
-            // 提取质量指标
-            const metrics = extractMetrics(events, qualityPassCount, qualityFailCount, phases, true // Stop 事件触发 = 正常完成
-            );
-            // 分类任务类型和复杂度
-            const taskType = classifyTaskType(requirement);
-            const complexity = assessComplexity(metrics);
-            // 判断任务结果
-            const outcome = this.determineOutcome(metrics, failureSignals);
-            // 构建 TaskSession
-            const taskSessionId = randomUUID();
-            const taskSession = {
-                id: taskSessionId,
-                session_id,
-                project_path,
-                pipeline_id: pipelineId,
-                requirement: requirement || '（未记录需求）',
-                task_type: taskType,
-                complexity,
-                outcome,
-                metrics,
-                failure_signals: failureSignals,
-                started_at: events[0]?.timestamp ?? event.timestamp ?? new Date().toISOString(),
-                ended_at: event.timestamp ?? new Date().toISOString(),
-            };
-            // 写入 SQLite
-            this.storage.insertTaskSession({
-                id: taskSessionId,
-                session_id,
-                project_path,
-                pipeline_id: pipelineId,
-                requirement: taskSession.requirement,
-                task_type: taskType,
-                complexity,
-                total_rounds: metrics.total_rounds,
-                total_tool_calls: metrics.total_tool_calls,
-                write_edit_count: metrics.write_edit_count,
-                fix_attempt_count: metrics.fix_attempt_count,
-                quality_fail_count: qualityFailCount,
-                quality_pass_count: qualityPassCount,
-                failure_signal_count: failureSignals.length,
-                phase_distribution: Object.fromEntries(phases.map(p => [p.phase, p.tool_call_count])),
-                outcome,
-                duration_ms: metrics.duration_ms,
-                started_at: taskSession.started_at,
-                ended_at: taskSession.ended_at,
-            });
-            // 计算并写入满意度评分（使用 SatisfactionInferrer 多信号推断）
-            const satisfactionResult = this.satisfactionInferrer.infer(metrics, outcome, complexity, failureSignals.length, session_id, project_path, taskSessionId);
-            this.storage.updateTaskSessionSatisfaction(taskSessionId, satisfactionResult.score);
-            logger.info(`[Forge:任务复盘] 满意度评分：${satisfactionResult.score.toFixed(2)}（置信度=${satisfactionResult.confidence.toFixed(2)}）`);
-            // 知识图谱：记录 requirement → outcome 因果链（异步，不阻塞）
-            // 从 decisions.md 读取最近的决策条目填入因果链
-            const recentDecisions = (() => {
-                try {
-                    const raw = new DistillWriter().readLastDecisions(project_path, 50);
-                    if (!raw)
-                        return [];
-                    // 按 ## 章节拆分，每个章节作为一条决策
-                    return raw.split(/\n(?=##\s)/)
-                        .map(s => s.trim())
-                        .filter(s => s.length > 10)
-                        .slice(-5); // 最近 5 条
-                }
-                catch {
-                    return [];
-                }
-            })();
-            setImmediate(() => {
-                this.knowledgeGraph.recordTaskCausalChain(project_path, requirement || '（未记录需求）', recentDecisions, outcome, taskSessionId).catch(err => logger.debug(`[知识图谱] 记录因果链失败：${err}`));
-            });
-            // v5 新增：回写 outcome 到本 session 的 pattern_executions
-            try {
-                const executions = this.storage.queryPatternExecutionsBySession(session_id, project_path);
-                for (const exec of executions) {
-                    this.storage.updatePatternExecutionOutcome(exec.id, outcome, taskSessionId);
-                }
-                if (executions.length > 0) {
-                    logger.info(`[Forge:任务复盘] 已回写 outcome(${outcome}) 到 ${executions.length} 条 pattern_executions`);
-                }
-            }
-            catch (err) {
-                logger.warn(`[Forge:任务复盘] 回写 pattern_executions outcome 失败：${err}`);
-            }
-            // 生成 retrospective.md
-            const writer = new RetrospectiveReportWriter(project_path);
-            writer.write(taskSession);
-            logger.info(`[Forge:任务复盘] 分析完成 — 类型: ${taskType}, 结果: ${outcome}, ` +
-                `工具调用: ${metrics.total_tool_calls}, 失败信号: ${failureSignals.length}`);
-        }
-        catch (err) {
-            logger.warn(`[Forge:任务复盘] 分析失败：${err}`);
-        }
-    }
-    /**
-     * 根据指标和失败信号判断任务结果
-     */
-    determineOutcome(metrics, failureSignals) {
-        const dissatisfiedCount = failureSignals.filter(s => s.signal_type === 'dissatisfied').length;
-        // 有明确不满意信号且质量门禁失败次数多 → 部分完成
-        if (dissatisfiedCount > 0 && metrics.quality_fail_count > metrics.quality_pass_count) {
-            return 'partial';
-        }
-        // 有明确不满意信号但最终通过 → 成功（经过修正）
-        if (dissatisfiedCount > 0) {
-            return 'success';
-        }
-        // 无失败信号 → 成功
-        return 'success';
-    }
-    /**
-     * 执行模式学习（每 10 次 Stop 触发）
-     * 返回提炼的模式总数
-     */
-    async learnPatterns() {
-        if (!this.patternLearner) {
-            logger.info('[Forge:模式学习] 跳过：未配置 AIProvider');
-            return 0;
-        }
-        const count = await this.patternLearner.learnAll();
-        // v5 重构：基于 pattern_executions 的真实成功率更新 effectiveness_score
-        try {
-            const successRates = this.storage.getPatternSuccessRates();
-            for (const { pattern_id, success_rate, total_count } of successRates) {
-                this.storage.updatePatternEffectivenessScore(pattern_id, success_rate);
-                logger.debug(`[Forge:模式学习] ${pattern_id} 效果评分更新（样本=${total_count}, 成功率=${(success_rate * 100).toFixed(0)}%）`);
-            }
-            if (successRates.length > 0) {
-                logger.info(`[Forge:模式学习] 已更新 ${successRates.length} 个 Pattern 的效果评分`);
-            }
-        }
-        catch (err) {
-            logger.warn(`[Forge:模式学习] 效果评分更新失败：${err}`);
-        }
-        return count;
-    }
-    /**
-     * 获取任务类型相关的预防策略建议
-     * 供 UserPromptHandler 在检测到同类任务时注入
-     * @param taskType 可选，由上层意图分析传入，避免 StrategyAdvisor 重复分类导致误判
-     */
-    getStrategies(requirement, taskType) {
-        return this.strategyAdvisor.getRelevantStrategies(requirement, taskType);
-    }
-}
-//# sourceMappingURL=index.js.map