@winspan/claude-forge 0.3.7 → 0.4.0

package/dist/retrospective/metrics-extractor.js

@@ -0,0 +1,71 @@
+/**
+ * 质量指标提取器 — 纯函数，无副作用
+ *
+ * 从事件流中提取客观的任务执行质量指标
+ * 不依赖 AI 自评，基于行为数据计算
+ */
+/**
+ * 从事件流提取任务质量指标
+ *
+ * @param events 本次会话的所有事件（按时间排序）
+ * @param qualityPassCount 质量门禁通过次数（从 QualityGateEngine 在 reset 前捕获）
+ * @param qualityFailCount 质量门禁失败次数
+ * @param phases 阶段快照（从 PhaseManager 获取）
+ * @param completed 会话是否正常完成
+ */
+export function extractMetrics(events, qualityPassCount, qualityFailCount, phases, completed) {
+    const userPromptEvents = events.filter(e => e.hook_type === 'UserPromptSubmit');
+    const toolUseEvents = events.filter(e => e.hook_type === 'PostToolUse');
+    const writeEditEvents = toolUseEvents.filter(e => e.tool_name === 'Write' || e.tool_name === 'Edit');
+    // 修复尝试：从阶段快照汇总
+    const fixAttemptCount = phases.reduce((sum, p) => sum + p.fix_attempt_count, 0);
+    // 持续时长：最后事件时间 - 第一个事件时间
+    let durationMs = 0;
+    if (events.length >= 2) {
+        const first = new Date(events[0].timestamp).getTime();
+        const last = new Date(events[events.length - 1].timestamp).getTime();
+        if (!isNaN(first) && !isNaN(last) && last > first) {
+            durationMs = last - first;
+        }
+    }
+    return {
+        total_rounds: userPromptEvents.length,
+        total_tool_calls: toolUseEvents.length,
+        write_edit_count: writeEditEvents.length,
+        fix_attempt_count: fixAttemptCount,
+        quality_pass_count: qualityPassCount,
+        quality_fail_count: qualityFailCount,
+        phase_distribution: phases,
+        duration_ms: durationMs,
+        completed,
+    };
+}
+/**
+ * 根据需求文本推断任务类型
+ */
+export function classifyTaskType(requirement) {
+    const lower = requirement.toLowerCase();
+    if (/重构|refactor|优化|cleanup|clean up/.test(lower))
+        return 'refactor';
+    if (/修复|fix|bug|错误|异常|报错/.test(lower))
+        return 'bugfix';
+    if (/审查|review|检查|check|评审/.test(lower))
+        return 'review';
+    if (/设计|design|架构|architecture|方案/.test(lower))
+        return 'design';
+    if (/新增|添加|实现|feature|功能|开发/.test(lower))
+        return 'feature';
+    return 'other';
+}
+/**
+ * 根据指标评估任务复杂度
+ */
+export function assessComplexity(metrics) {
+    const { total_tool_calls, write_edit_count, total_rounds } = metrics;
+    if (total_tool_calls > 50 || write_edit_count > 15 || total_rounds > 10)
+        return 'complex';
+    if (total_tool_calls > 15 || write_edit_count > 5 || total_rounds > 4)
+        return 'moderate';
+    return 'simple';
+}
+//# sourceMappingURL=metrics-extractor.js.map

package/dist/retrospective/metrics-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-extractor.js","sourceRoot":"","sources":["../../src/retrospective/metrics-extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAoB,EACpB,gBAAwB,EACxB,gBAAwB,EACxB,MAAuB,EACvB,SAAkB;IAElB,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,kBAAkB,CAAC,CAAC;IAChF,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC,CAAC;IACxE,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM,CACvD,CAAC;IAEF,eAAe;IACf,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IAEhF,wBAAwB;IACxB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACrE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YAClD,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO;QACL,YAAY,EAAE,gBAAgB,CAAC,MAAM;QACrC,gBAAgB,EAAE,aAAa,CAAC,MAAM;QACtC,gBAAgB,EAAE,eAAe,CAAC,MAAM;QACxC,iBAAiB,EAAE,eAAe;QAClC,kBAAkB,EAAE,gBAAgB;QACpC,kBAAkB,EAAE,gBAAgB;QACpC,kBAAkB,EAAE,MAAM;QAC1B,WAAW,EAAE,UAAU;QACvB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAExC,IAAI,iCAAiC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IACrE,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvD,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzD,IAAI,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChE,IAAI,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA2B;IAC1D,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAErE,IAAI,gBAAgB,GAAG,EAAE,IAAI,gBAAgB,GAAG,EAAE,IAAI,YAAY,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IAC1F,IAAI,gBAAgB,GAAG,EAAE,IAAI,gBAAgB,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IACzF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/retrospective/pattern-learner.d.ts

@@ -0,0 +1,29 @@
+/**
+ * PatternLearner — AI 驱动的失败模式提炼器
+ *
+ * 从 task_sessions + failure_signals 历史数据中提炼同类任务的共同失败模式，
+ * 并将结论写入 task_patterns 表供 StrategyAdvisor 使用。
+ *
+ * 触发条件：每 10 次 Stop，或同类型任务新增 >= 5 条时
+ */
+import type { AIProvider } from '../ai-provider/types.js';
+import type { StorageEngine } from '../storage/index.js';
+import type { TaskType } from './types.js';
+export declare class PatternLearner {
+    private storage;
+    private api;
+    constructor(storage: StorageEngine, api: AIProvider);
+    /**
+     * 对指定任务类型执行模式提炼。
+     * 若历史不足 MIN_SAMPLES 条则跳过。
+     */
+    learnPatterns(taskType: TaskType): Promise<number>;
+    /**
+     * 对所有任务类型批量执行模式学习（每 10 次 Stop 触发）。
+     * 返回总写入模式数。
+     */
+    learnAll(): Promise<number>;
+    private buildPrompt;
+    private parsePatterns;
+}
+//# sourceMappingURL=pattern-learner.d.ts.map

package/dist/retrospective/pattern-learner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-learner.d.ts","sourceRoot":"","sources":["../../src/retrospective/pattern-learner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,YAAY,CAAC;AAYxD,qBAAa,cAAc;IAEvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,GAAG;gBADH,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,UAAU;IAGzB;;;OAGG;IACG,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAkExD;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAcjC,OAAO,CAAC,WAAW;IAsCnB,OAAO,CAAC,aAAa;CAmCtB"}

package/dist/retrospective/pattern-learner.js

@@ -0,0 +1,159 @@
+/**
+ * PatternLearner — AI 驱动的失败模式提炼器
+ *
+ * 从 task_sessions + failure_signals 历史数据中提炼同类任务的共同失败模式，
+ * 并将结论写入 task_patterns 表供 StrategyAdvisor 使用。
+ *
+ * 触发条件：每 10 次 Stop，或同类型任务新增 >= 5 条时
+ */
+import { randomUUID } from 'node:crypto';
+import { logger } from '../utils/logger.js';
+/** 最少需要多少条任务历史才触发模式提炼 */
+const MIN_SAMPLES = 5;
+/** 每种任务类型最多分析的历史条数 */
+const MAX_HISTORY_PER_TYPE = 30;
+/** 模式置信度阈值：低于此值视为噪音，不写入 */
+const MIN_CONFIDENCE = 0.4;
+const ALL_TASK_TYPES = ['refactor', 'feature', 'bugfix', 'review', 'design', 'other'];
+export class PatternLearner {
+    storage;
+    api;
+    constructor(storage, api) {
+        this.storage = storage;
+        this.api = api;
+    }
+    /**
+     * 对指定任务类型执行模式提炼。
+     * 若历史不足 MIN_SAMPLES 条则跳过。
+     */
+    async learnPatterns(taskType) {
+        const sessions = this.storage.getTaskSessionsByType(taskType, MAX_HISTORY_PER_TYPE);
+        if (sessions.length < MIN_SAMPLES) {
+            logger.info(`[Forge:模式学习] ${taskType} 历史不足 ${MIN_SAMPLES} 条（当前 ${sessions.length}），跳过`);
+            return 0;
+        }
+        logger.info(`[Forge:模式学习] 开始提炼 ${taskType}（${sessions.length} 条历史）`);
+        // 收集所有失败信号
+        const failureSummaries = [];
+        for (const session of sessions) {
+            const sessionId = String(session['session_id'] ?? '');
+            const projectPath = String(session['project_path'] ?? '');
+            const signals = this.storage.getFailureSignals({ session_id: sessionId, project_path: projectPath });
+            if (signals.length > 0) {
+                const signalTexts = signals.map(s => `  - [${String(s['signal_type'] ?? '')}] "${String(s['raw_prompt'] ?? '')}" (阶段=${String(s['context_phase'] ?? '未知')}, 前置工具调用=${Number(s['preceding_tool_count'] ?? 0)})`).join('\n');
+                failureSummaries.push(`会话 ${sessionId.slice(0, 8)}... | 结果=${String(session['outcome'] ?? '')} | 轮次=${Number(session['total_rounds'] ?? 0)} | 工具调用=${Number(session['total_tool_calls'] ?? 0)}\n` +
+                    `失败信号：\n${signalTexts}`);
+            }
+        }
+        if (failureSummaries.length === 0) {
+            logger.info(`[Forge:模式学习] ${taskType} 无失败信号记录，跳过模式提炼`);
+            return 0;
+        }
+        // 构建 AI prompt
+        const prompt = this.buildPrompt(taskType, sessions, failureSummaries);
+        let response;
+        try {
+            response = await this.api.complete(prompt, '模式学习', { timeoutMs: 60_000, maxTokens: 1000 });
+        }
+        catch (err) {
+            logger.warn(`[Forge:模式学习] AI 调用失败：${err}`);
+            return 0;
+        }
+        // 解析 AI 返回的模式列表
+        const patterns = this.parsePatterns(response, taskType);
+        if (patterns.length === 0) {
+            logger.info(`[Forge:模式学习] AI 未提炼出有效模式`);
+            return 0;
+        }
+        // 写入 task_patterns 表
+        for (const pattern of patterns) {
+            this.storage.upsertTaskPattern({
+                id: randomUUID(),
+                task_type: pattern.task_type,
+                failure_pattern: pattern.failure_pattern,
+                prevention_strategy: pattern.prevention_strategy,
+                confidence_score: pattern.confidence_score,
+                sample_count: sessions.length,
+                last_updated: new Date().toISOString(),
+            });
+        }
+        logger.info(`[Forge:模式学习] ${taskType} 提炼完成，写入 ${patterns.length} 个模式`);
+        return patterns.length;
+    }
+    /**
+     * 对所有任务类型批量执行模式学习（每 10 次 Stop 触发）。
+     * 返回总写入模式数。
+     */
+    async learnAll() {
+        let total = 0;
+        for (const taskType of ALL_TASK_TYPES) {
+            try {
+                total += await this.learnPatterns(taskType);
+            }
+            catch (err) {
+                logger.warn(`[Forge:模式学习] ${taskType} 提炼失败：${err}`);
+            }
+        }
+        return total;
+    }
+    // ── 私有方法 ────────────────────────────────────────────────────────────────
+    buildPrompt(taskType, sessions, failureSummaries) {
+        const totalSessions = sessions.length;
+        const failedCount = sessions.filter(s => {
+            const outcome = s['outcome'];
+            const failureCount = typeof s['failure_signal_count'] === 'number' ? s['failure_signal_count'] : 0;
+            return outcome === 'partial' || failureCount > 0;
+        }).length;
+        return `你是一位软件工程质量分析师。以下是 ${totalSessions} 条"${taskType}"类型任务的执行历史，其中 ${failedCount} 条含失败信号。
+
+请分析这些失败信号，提炼出 1-3 个最常见的失败模式，以及对应的预防策略。
+
+## 失败信号记录
+
+${failureSummaries.join('\n\n---\n\n')}
+
+## 输出格式
+
+请严格按以下 JSON 数组格式输出，不要包含任何其他文本：
+
+[
+  {
+    "failure_pattern": "简短描述失败模式（20字以内）",
+    "prevention_strategy": "具体的预防策略（50字以内）",
+    "confidence": 0.7
+  }
+]
+
+要求：
+- confidence 范围 0.0-1.0，表示这个模式在样本中的普遍性
+- confidence < ${MIN_CONFIDENCE} 的模式请直接省略不输出
+- 只输出 JSON 数组，不要 markdown 代码块，不要解释文字`;
+    }
+    parsePatterns(response, taskType) {
+        try {
+            // 提取 JSON 数组（兼容 AI 可能包裹了 markdown 代码块的情况）
+            const jsonMatch = response.match(/\[[\s\S]*\]/);
+            if (!jsonMatch)
+                return [];
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (!Array.isArray(parsed))
+                return [];
+            return parsed
+                .filter(p => typeof p.failure_pattern === 'string' && p.failure_pattern.trim() &&
+                typeof p.prevention_strategy === 'string' && p.prevention_strategy.trim() &&
+                typeof p.confidence === 'number' && p.confidence >= MIN_CONFIDENCE)
+                .slice(0, 3) // 最多保留 3 个
+                .map(p => ({
+                task_type: taskType,
+                failure_pattern: p.failure_pattern.trim(),
+                prevention_strategy: p.prevention_strategy.trim(),
+                confidence_score: Math.min(1.0, Math.max(0.0, p.confidence)),
+            }));
+        }
+        catch (err) {
+            logger.warn(`[Forge:模式学习] 解析 AI 响应失败：${err}`);
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=pattern-learner.js.map

package/dist/retrospective/pattern-learner.js.map

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

package/dist/retrospective/report-writer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 复盘报告写入器
+ *
+ * 生成 .claude-forge/retrospective.md，自动轮换归档
+ */
+import type { TaskSession } from './types.js';
+export declare class RetrospectiveReportWriter {
+    private projectPath;
+    private reportPath;
+    private archivePath;
+    constructor(projectPath: string);
+    /**
+     * 写入任务复盘条目
+     */
+    write(session: TaskSession): void;
+    /**
+     * 格式化单条复盘记录
+     */
+    private formatEntry;
+    /**
+     * 归档旧条目
+     */
+    private rotateArchive;
+    /**
+     * 从需求文本提取简短标题
+     */
+    private extractTitle;
+    /**
+     * 获取结果标签
+     */
+    private getOutcomeLabel;
+}
+//# sourceMappingURL=report-writer.d.ts.map

package/dist/retrospective/report-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-writer.d.ts","sourceRoot":"","sources":["../../src/retrospective/report-writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAK7D,qBAAa,yBAAyB;IAIxB,OAAO,CAAC,WAAW;IAH/B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAER,WAAW,EAAE,MAAM;IAWvC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAuCjC;;OAEG;IACH,OAAO,CAAC,WAAW;IAgDnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,eAAe;CASxB"}

package/dist/retrospective/report-writer.js

@@ -0,0 +1,173 @@
+/**
+ * 复盘报告写入器
+ *
+ * 生成 .claude-forge/retrospective.md，自动轮换归档
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+const MAX_ENTRIES = 20;
+const ARCHIVE_FILENAME = 'retrospective-archive.md';
+export class RetrospectiveReportWriter {
+    projectPath;
+    reportPath;
+    archivePath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        const forgeDir = path.join(projectPath, '.claude-forge');
+        this.reportPath = path.join(forgeDir, 'retrospective.md');
+        this.archivePath = path.join(forgeDir, ARCHIVE_FILENAME);
+        // 确保目录存在
+        if (!fs.existsSync(forgeDir)) {
+            fs.mkdirSync(forgeDir, { recursive: true });
+        }
+    }
+    /**
+     * 写入任务复盘条目
+     */
+    write(session) {
+        const entry = this.formatEntry(session);
+        // 读取现有内容
+        let content = '';
+        if (fs.existsSync(this.reportPath)) {
+            content = fs.readFileSync(this.reportPath, 'utf-8');
+        }
+        else {
+            content = '# 任务复盘日志\n\n';
+        }
+        // 插入新条目（在标题后的第一个分隔符之后）
+        const lines = content.split('\n');
+        const headerEndIndex = lines.findIndex((line, i) => i > 0 && line.startsWith('---'));
+        if (headerEndIndex > 0) {
+            // 在分隔符后插入（即第一条记录之前）
+            lines.splice(headerEndIndex + 1, 0, entry);
+        }
+        else {
+            // 若无分隔符，在标题后插入
+            const titleIndex = lines.findIndex(l => l.startsWith('# '));
+            if (titleIndex >= 0) {
+                lines.splice(titleIndex + 2, 0, entry); // 标题后空一行
+            }
+            else {
+                lines.push(entry);
+            }
+        }
+        content = lines.join('\n');
+        // 检查条目数量，超过阈值则归档
+        const entryCount = (content.match(/^## \d{4}-\d{2}-\d{2}/gm) || []).length;
+        if (entryCount > MAX_ENTRIES) {
+            this.rotateArchive(content);
+        }
+        else {
+            fs.writeFileSync(this.reportPath, content, 'utf-8');
+        }
+    }
+    /**
+     * 格式化单条复盘记录
+     */
+    formatEntry(session) {
+        const { metrics, failure_signals } = session;
+        const date = session.started_at.split('T')[0];
+        const title = this.extractTitle(session.requirement);
+        const outcomeLabel = this.getOutcomeLabel(session.outcome);
+        const durationMin = Math.round(metrics.duration_ms / 60000);
+        let entry = `---\n## ${date} | ${title} | 类型: ${session.task_type} | 结果: ${outcomeLabel}\n\n`;
+        // 执行指标
+        entry += '**执行指标**\n';
+        entry += `- 总轮次: ${metrics.total_rounds} | 工具调用: ${metrics.total_tool_calls} | 修复尝试: ${metrics.fix_attempt_count} | 耗时: ${durationMin}min\n`;
+        entry += `- 质量门禁: 通过 ${metrics.quality_pass_count} 次 / 失败 ${metrics.quality_fail_count} 次\n`;
+        // 失败信号
+        if (failure_signals.length > 0) {
+            const dissatisfied = failure_signals.filter(s => s.signal_type === 'dissatisfied').length;
+            const iteration = failure_signals.filter(s => s.signal_type === 'iteration').length;
+            entry += `- 失败信号: ${failure_signals.length} 次`;
+            if (dissatisfied > 0)
+                entry += `（不满意 ${dissatisfied} 次`;
+            if (iteration > 0)
+                entry += `${dissatisfied > 0 ? '，' : '（'}迭代 ${iteration} 次`;
+            entry += '）\n';
+            // 详细信号列表
+            const firstSignal = failure_signals[0];
+            if (firstSignal) {
+                entry += `  - 首次信号: "${firstSignal.matched_pattern}"`;
+                if (firstSignal.context_phase)
+                    entry += ` 发生在 ${firstSignal.context_phase} 阶段`;
+                entry += '\n';
+            }
+        }
+        else {
+            entry += '- 失败信号: 无\n';
+        }
+        // 阶段分布
+        if (metrics.phase_distribution.length > 0) {
+            entry += '\n**阶段分布**\n';
+            for (const phase of metrics.phase_distribution) {
+                entry += `- ${phase.phase}: ${phase.tool_call_count} 次工具调用`;
+                if (phase.fix_attempt_count > 0)
+                    entry += `（修复 ${phase.fix_attempt_count} 次）`;
+                entry += '\n';
+            }
+        }
+        entry += '\n';
+        return entry;
+    }
+    /**
+     * 归档旧条目
+     */
+    rotateArchive(content) {
+        const lines = content.split('\n');
+        const entries = [];
+        let currentEntry = [];
+        for (const line of lines) {
+            if (line.startsWith('## ') && currentEntry.length > 0) {
+                entries.push(currentEntry.join('\n'));
+                currentEntry = [line];
+            }
+            else {
+                currentEntry.push(line);
+            }
+        }
+        if (currentEntry.length > 0) {
+            entries.push(currentEntry.join('\n'));
+        }
+        // 保留最新的 MAX_ENTRIES 条
+        const keep = entries.slice(0, MAX_ENTRIES);
+        const archive = entries.slice(MAX_ENTRIES);
+        // 写入主文件
+        const newContent = '# 任务复盘日志\n\n' + keep.join('\n---\n');
+        fs.writeFileSync(this.reportPath, newContent, 'utf-8');
+        // 追加到归档文件
+        if (archive.length > 0) {
+            let archiveContent = '';
+            if (fs.existsSync(this.archivePath)) {
+                archiveContent = fs.readFileSync(this.archivePath, 'utf-8');
+            }
+            else {
+                archiveContent = '# 任务复盘归档\n\n';
+            }
+            archiveContent += archive.join('\n---\n') + '\n';
+            fs.writeFileSync(this.archivePath, archiveContent, 'utf-8');
+        }
+    }
+    /**
+     * 从需求文本提取简短标题
+     */
+    extractTitle(requirement) {
+        // 取第一句话或前 30 个字符
+        const firstLine = requirement.split('\n')[0];
+        const title = firstLine.length > 30 ? firstLine.slice(0, 30) + '...' : firstLine;
+        return title.trim();
+    }
+    /**
+     * 获取结果标签
+     */
+    getOutcomeLabel(outcome) {
+        const labels = {
+            success: '成功',
+            partial: '部分完成',
+            abandoned: '中止',
+            in_progress: '进行中',
+        };
+        return labels[outcome] || outcome;
+    }
+}
+//# sourceMappingURL=report-writer.js.map

package/dist/retrospective/report-writer.js.map

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

package/dist/retrospective/strategy-advisor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * StrategyAdvisor — 预防策略推荐器
+ *
+ * 读取 task_patterns 表中已学习的失败模式，
+ * 在 UserPromptHandler 检测到同类任务时注入预防建议。
+ */
+import type { StorageEngine } from '../storage/index.js';
+export declare class StrategyAdvisor {
+    private storage;
+    constructor(storage: StorageEngine);
+    /**
+     * 根据用户需求文本，查找相关历史失败模式并返回预防建议。
+     * 无相关模式时返回 null。
+     */
+    getRelevantStrategies(requirement: string): string | null;
+    /**
+     * 加载指定任务类型的高置信度模式，按置信度降序排列。
+     */
+    private loadPatterns;
+}
+//# sourceMappingURL=strategy-advisor.d.ts.map

package/dist/retrospective/strategy-advisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-advisor.d.ts","sourceRoot":"","sources":["../../src/retrospective/strategy-advisor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUzD,qBAAa,eAAe;IACd,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE1C;;;OAGG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmBzD;;OAEG;IACH,OAAO,CAAC,YAAY;CAqBrB"}

package/dist/retrospective/strategy-advisor.js

@@ -0,0 +1,63 @@
+/**
+ * StrategyAdvisor — 预防策略推荐器
+ *
+ * 读取 task_patterns 表中已学习的失败模式，
+ * 在 UserPromptHandler 检测到同类任务时注入预防建议。
+ */
+import { classifyTaskType } from './metrics-extractor.js';
+import { logger } from '../utils/logger.js';
+/** 注入建议的最低置信度阈值 */
+const MIN_INJECT_CONFIDENCE = 0.5;
+/** 每次最多注入的建议条数 */
+const MAX_STRATEGIES = 2;
+export class StrategyAdvisor {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * 根据用户需求文本，查找相关历史失败模式并返回预防建议。
+     * 无相关模式时返回 null。
+     */
+    getRelevantStrategies(requirement) {
+        const taskType = classifyTaskType(requirement);
+        const patterns = this.loadPatterns(taskType);
+        if (patterns.length === 0)
+            return null;
+        const lines = [
+            `[Forge 历史经验] 检测到 ${taskType} 类型任务，以下是历史失败模式和预防建议：`,
+        ];
+        for (const p of patterns) {
+            lines.push(`- ⚠️ 常见问题：${p.failure_pattern}`);
+            lines.push(`  建议：${p.prevention_strategy}`);
+        }
+        logger.info(`[Forge:策略建议] 注入 ${patterns.length} 条 ${taskType} 类型预防建议`);
+        return lines.join('\n');
+    }
+    /**
+     * 加载指定任务类型的高置信度模式，按置信度降序排列。
+     */
+    loadPatterns(taskType) {
+        try {
+            const raw = this.storage.getTaskPatterns(taskType);
+            return raw
+                .map(r => ({
+                id: String(r['id'] ?? ''),
+                task_type: String(r['task_type'] ?? ''),
+                failure_pattern: String(r['failure_pattern'] ?? ''),
+                prevention_strategy: String(r['prevention_strategy'] ?? ''),
+                confidence_score: Number(r['confidence_score'] ?? 0),
+                sample_count: Number(r['sample_count'] ?? 0),
+                last_updated: String(r['last_updated'] ?? ''),
+            }))
+                .filter(p => p.confidence_score >= MIN_INJECT_CONFIDENCE)
+                .sort((a, b) => b.confidence_score - a.confidence_score)
+                .slice(0, MAX_STRATEGIES);
+        }
+        catch (err) {
+            logger.warn(`[Forge:策略建议] 加载模式失败：${err}`);
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=strategy-advisor.js.map

package/dist/retrospective/strategy-advisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-advisor.js","sourceRoot":"","sources":["../../src/retrospective/strategy-advisor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,mBAAmB;AACnB,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,kBAAkB;AAClB,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;IAAG,CAAC;IAE9C;;;OAGG;IACH,qBAAqB,CAAC,WAAmB;QACvC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAE7C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEvC,MAAM,KAAK,GAAa;YACtB,oBAAoB,QAAQ,uBAAuB;SACpD,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,MAAM,MAAM,QAAQ,SAAS,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,QAAkB;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YACnD,OAAO,GAAG;iBACP,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACT,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACzB,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAa;gBACnD,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;gBACnD,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;gBAC3D,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACpD,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBAC5C,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;aAC9C,CAAC,CAAC;iBACF,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,IAAI,qBAAqB,CAAC;iBACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC;iBACvD,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}