@hongmaple0820/scale-engine 0.10.1 → 0.11.1

package/dist/workflow/evolution/LessonExtractor.js

@@ -0,0 +1,317 @@
+// SCALE Engine — Lesson Extractor
+// 从会话 Defect 事件提取可复用的 Lessons
+// 设计参考：docs/03-CORE-MODULES.md §3.6 + L6 Evolution
+/**
+ * Lesson Extractor
+ *
+ * 从会话历史中提取可复用的 Lessons：
+ * 1. 查询 defect.opened 事件
+ * 2. 分析修复过程和根因
+ * 3. 提取 pattern-solution 对
+ * 4. 聚合高频模式
+ * 5. 生成 Lesson Candidates
+ */
+export class LessonExtractor {
+    constructor(eventBus, minOccurrences = 2) {
+        this.minOccurrences = 2; // 成为 Lesson 的最小出现次数
+        this.eventBus = eventBus;
+        this.minOccurrences = minOccurrences;
+    }
+    /**
+     * 从会话提取 Lessons
+     */
+    async extractFromSession(sessionId) {
+        this.eventBus.emit('lesson.extract.start', { sessionId });
+        // 1. 查询 defect 相关事件
+        const defectEvents = await this.eventBus.query({
+            sessionId,
+            types: ['defect.opened', 'defect.resolved'],
+            limit: 50
+        });
+        if (defectEvents.length === 0) {
+            this.eventBus.emit('lesson.extract.empty', { sessionId });
+            return [];
+        }
+        // 2. 分析每个 Defect
+        const analyses = [];
+        for (const defectEvent of defectEvents.filter(e => e.type === 'defect.opened')) {
+            const analysis = await this.analyzeDefect(sessionId, defectEvent);
+            if (analysis) {
+                analyses.push(analysis);
+            }
+        }
+        // 3. 提取 Patterns
+        const patterns = this.identifyPatterns(analyses);
+        // 4. 聚合为 Lesson Candidates
+        const candidates = this.aggregateToLessons(patterns, analyses);
+        this.eventBus.emit('lesson.extract.end', {
+            sessionId,
+            defectsAnalyzed: analyses.length,
+            candidatesGenerated: candidates.length
+        });
+        return candidates;
+    }
+    /**
+     * 分析单个 Defect
+     */
+    async analyzeDefect(sessionId, defectEvent) {
+        const defect = defectEvent.payload;
+        if (!defect?.id)
+            return null;
+        // 查询该 defect 的修复过程
+        const fixEvents = await this.eventBus.query({
+            sessionId,
+            types: ['tool.completed', 'tool.failed'],
+            filter: (e) => {
+                const p = e.payload;
+                // 查找与缺陷修复相关的工具调用
+                return ['Edit', 'Write', 'Bash'].includes(p.tool);
+            },
+            limit: 20
+        });
+        // 计算修复时间和尝试次数
+        const openedAt = defect.createdAt ?? Date.now();
+        const resolvedEvents = await this.eventBus.query({
+            sessionId,
+            types: ['defect.resolved'],
+            filter: (e) => {
+                const p = e.payload;
+                return p.defectId === defect.id;
+            },
+            limit: 1
+        });
+        const resolvedAt = resolvedEvents[0]?.timestamp ?? Date.now();
+        const timeToFix = resolvedAt - openedAt;
+        // 分析根因
+        const rootCause = this.inferRootCause(defect, fixEvents);
+        const resolutionSteps = this.extractResolutionSteps(fixEvents);
+        // 识别模式
+        const patternsIdentified = this.extractPatternsFromFix(rootCause, resolutionSteps);
+        return {
+            defectId: defect.id,
+            rootCause,
+            resolutionSteps,
+            timeToFix,
+            attempts: fixEvents.filter(e => e.type === 'tool.failed').length + 1,
+            patternsIdentified
+        };
+    }
+    /**
+     * 推断根因
+     */
+    inferRootCause(defect, fixEvents) {
+        // 从缺陷 payload 和修复历史推断根因
+        const payload = defect.payload;
+        const symptom = payload?.symptom ?? '';
+        const title = defect.title ?? '';
+        // 常见根因模式
+        if (symptom.includes('undefined') || symptom.includes('null')) {
+            return 'Missing null check or initialization';
+        }
+        if (symptom.includes('type') || symptom.includes('TypeScript')) {
+            return 'Type mismatch or incorrect type definition';
+        }
+        if (symptom.includes('async') || symptom.includes('await')) {
+            return 'Async/await handling issue';
+        }
+        if (symptom.includes('import') || symptom.includes('module')) {
+            return 'Missing or incorrect import';
+        }
+        if (symptom.includes('test') && fixEvents.some(e => {
+            const p = e.payload;
+            return p.args?.command?.includes('test');
+        })) {
+            return 'Test assertion failure or test setup issue';
+        }
+        // 默认：从标题推断
+        return title ?? 'Unknown root cause';
+    }
+    /**
+     * 提取修复步骤
+     */
+    extractResolutionSteps(fixEvents) {
+        const steps = [];
+        for (const event of fixEvents) {
+            const p = event.payload;
+            if (p.tool === 'Edit' && p.args?.file_path) {
+                steps.push(`Edit ${p.args.file_path}`);
+            }
+            if (p.tool === 'Write' && p.args?.file_path) {
+                steps.push(`Write ${p.args.file_path}`);
+            }
+            if (p.tool === 'Bash' && p.args?.command) {
+                steps.push(`Run: ${p.args.command}`);
+            }
+        }
+        return steps;
+    }
+    /**
+     * 从修复过程提取模式
+     */
+    extractPatternsFromFix(rootCause, steps) {
+        const patterns = [];
+        // 根因到模式的映射
+        const rootCausePatterns = {
+            'Missing null check or initialization': 'Always check for null/undefined before accessing properties',
+            'Type mismatch or incorrect type definition': 'Use strict type checking and avoid type assertions',
+            'Async/await handling issue': 'Always await async operations and handle promise errors',
+            'Missing or incorrect import': 'Verify imports before using; check module exports',
+            'Test assertion failure or test setup issue': 'Ensure test data and mocks are properly initialized'
+        };
+        if (rootCausePatterns[rootCause]) {
+            patterns.push(rootCausePatterns[rootCause]);
+        }
+        // 从修复步骤提取模式
+        for (const step of steps) {
+            if (step.includes('Edit') && patterns.length === 0) {
+                patterns.push(`Fix involved: ${step}`);
+            }
+        }
+        return patterns;
+    }
+    /**
+     * 识别重复模式
+     */
+    identifyPatterns(analyses) {
+        const patternMap = new Map();
+        for (const analysis of analyses) {
+            for (const pattern of analysis.patternsIdentified) {
+                const existing = patternMap.get(pattern) ?? [];
+                existing.push(analysis);
+                patternMap.set(pattern, existing);
+            }
+        }
+        return patternMap;
+    }
+    /**
+     * 聚合为 Lesson Candidates
+     */
+    aggregateToLessons(patternMap, analyses) {
+        const candidates = [];
+        for (const [pattern, relatedAnalyses] of patternMap.entries()) {
+            // 只有高频模式才成为 Lesson
+            if (relatedAnalyses.length < this.minOccurrences)
+                continue;
+            // 生成解决方案
+            const solutions = relatedAnalyses.map(a => a.resolutionSteps.join(' → '));
+            const commonSolution = this.findCommonSolution(solutions);
+            // 计算优先级
+            const avgTimeToFix = relatedAnalyses.reduce((sum, a) => sum + a.timeToFix, 0) / relatedAnalyses.length;
+            const totalAttempts = relatedAnalyses.reduce((sum, a) => sum + a.attempts, 0);
+            const priority = avgTimeToFix > 300000 || totalAttempts > 5 ? 'HIGH'
+                : avgTimeToFix > 60000 || totalAttempts > 2 ? 'MEDIUM'
+                    : 'LOW';
+            candidates.push({
+                pattern,
+                solution: commonSolution,
+                context: this.generateContext(pattern, relatedAnalyses),
+                defectIds: relatedAnalyses.map(a => a.defectId),
+                frequency: relatedAnalyses.length,
+                verified: false, // 需要后续验证
+                priority
+            });
+        }
+        // 按频率和优先级排序
+        return candidates.sort((a, b) => {
+            if (a.priority !== b.priority) {
+                return a.priority === 'HIGH' ? -1 : 1;
+            }
+            return b.frequency - a.frequency;
+        });
+    }
+    /**
+     * 找到共同解决方案
+     */
+    findCommonSolution(solutions) {
+        if (solutions.length === 0)
+            return 'No solution found';
+        if (solutions.length === 1)
+            return solutions[0];
+        // 找出最短的共同路径
+        const steps = solutions[0].split(' → ');
+        const commonSteps = [];
+        for (const step of steps) {
+            if (solutions.every(s => s.includes(step))) {
+                commonSteps.push(step);
+            }
+        }
+        return commonSteps.length > 0 ? commonSteps.join(' → ') : solutions[0];
+    }
+    /**
+     * 生成上下文描述
+     */
+    generateContext(pattern, analyses) {
+        const avgFixTime = Math.round(analyses.reduce((s, a) => s + a.timeToFix, 0) / analyses.length / 1000);
+        return `This pattern occurred ${analyses.length} times with average fix time of ${avgFixTime}s. ` +
+            `Apply when: ${pattern}`;
+    }
+    /**
+     * 转换为 Lesson Artifact
+     */
+    toLessonArtifact(candidate) {
+        const lessonPayload = {
+            type: 'lesson',
+        };
+        return {
+            id: `lesson-${Date.now()}-${candidate.defectIds[0]}`,
+            type: 'Lesson',
+            version: 1,
+            title: candidate.pattern,
+            status: candidate.verified ? 'VERIFIED' : 'DRAFT',
+            statusHistory: [],
+            parents: [],
+            children: [],
+            contentRef: '',
+            payload: lessonPayload,
+            gates: [],
+            createdBy: { kind: 'system', component: 'LessonExtractor' },
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+            tags: [`priority:${candidate.priority}`, `frequency:${candidate.frequency}`],
+            labels: {},
+        };
+    }
+    /**
+     * 批量转换
+     */
+    toLessonArtifacts(candidates) {
+        return candidates.map(c => this.toLessonArtifact(c));
+    }
+}
+/**
+ * 从多个会话聚合 Lessons
+ */
+export async function aggregateLessonsFromSessions(eventBus, sessionIds) {
+    const extractor = new LessonExtractor(eventBus);
+    const allCandidates = [];
+    for (const sessionId of sessionIds) {
+        const candidates = await extractor.extractFromSession(sessionId);
+        allCandidates.push(...candidates);
+    }
+    // 聚合相同模式的候选
+    const patternCounts = new Map();
+    for (const candidate of allCandidates) {
+        const existing = patternCounts.get(candidate.pattern) ?? [];
+        existing.push(candidate);
+        patternCounts.set(candidate.pattern, existing);
+    }
+    // 合并高频模式
+    const merged = [];
+    for (const [pattern, candidates] of patternCounts.entries()) {
+        const totalFrequency = candidates.reduce((s, c) => s + c.frequency, 0);
+        const allDefectIds = candidates.flatMap(c => c.defectIds);
+        merged.push({
+            pattern,
+            solution: candidates[0].solution,
+            context: candidates[0].context,
+            defectIds: allDefectIds,
+            frequency: totalFrequency,
+            verified: candidates.some(c => c.verified),
+            priority: candidates.some(c => c.priority === 'HIGH') ? 'HIGH'
+                : candidates.some(c => c.priority === 'MEDIUM') ? 'MEDIUM'
+                    : 'LOW'
+        });
+    }
+    return merged.sort((a, b) => b.frequency - a.frequency);
+}
+//# sourceMappingURL=LessonExtractor.js.map

package/dist/workflow/evolution/LessonExtractor.js.map

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

package/dist/workflow/evolution/SelfImproveEngine.d.ts

@@ -0,0 +1,156 @@
+import type { IEventBus } from '../../core/eventBus.js';
+import { type LessonCandidate } from './LessonExtractor.js';
+/**
+ * Hook 配置格式（用于 settings.json）
+ */
+interface HookConfig {
+    matcher: string;
+    command: string;
+    description?: string;
+    timeout?: number;
+}
+/**
+ * 自改进闭环状态
+ */
+export interface SelfImproveState {
+    lessonsExtracted: number;
+    lessonsVerified: number;
+    rulesCreated: number;
+    rulesActive: number;
+    hooksGenerated: number;
+    lastRunAt: number;
+}
+/**
+ * Rule 候选
+ */
+export interface RuleCandidate {
+    id: string;
+    name: string;
+    pattern: RegExp | string;
+    severity: 'block' | 'warn' | 'info';
+    description: string;
+    remediation: string;
+    lessonId: string;
+    hitCount: number;
+    lastHitAt: number;
+    active: boolean;
+}
+/**
+ * Hook 生成结果
+ */
+export interface HookGenerationResult {
+    hookType: 'PreToolUse' | 'PostToolUse' | 'Stop';
+    matcher: string;
+    command: string;
+    description: string;
+    ruleId: string;
+}
+/**
+ * 自改进阈值配置
+ */
+export interface SelfImproveThresholds {
+    lessonVerificationThreshold: number;
+    ruleActivationThreshold: number;
+    hookGenerationThreshold: number;
+    maxHooks: number;
+}
+/**
+ * Self-Improve Engine
+ *
+ * 实现自改进闭环：
+ * 1. Defect → Lesson: 从缺陷提取可复用教训
+ * 2. Lesson → Rule: 经过验证的教训转化为规则
+ * 3. Rule → Hook: 高频规则转化为自动化 Hook
+ *
+ * 闭环流程：
+ * - Lesson 需要 verified 3 次才能晋升为 Rule Candidate
+ * - Rule 需要 hit 10 换才能晋升为 Hook Candidate
+ * - Hook 生成后自动注册到 Gateway
+ */
+export declare class SelfImproveEngine {
+    private eventBus;
+    private lessonExtractor;
+    private thresholds;
+    private state;
+    private lessonCandidates;
+    private ruleCandidates;
+    private generatedHooks;
+    constructor(eventBus: IEventBus, thresholds?: Partial<SelfImproveThresholds>);
+    /**
+     * 运行自改进闭环
+     */
+    run(sessionId: string): Promise<SelfImproveState>;
+    /**
+     * Phase 1: 从会话提取 Lessons
+     */
+    private extractLessons;
+    /**
+     * Phase 2: 验证并晋升 Lessons 为 Rules
+     */
+    private verifyAndPromoteLessons;
+    /**
+     * 创建 Rule Candidate
+     */
+    private createRuleCandidate;
+    /**
+     * 将模式字符串转换为 RegExp
+     */
+    private patternToRegExp;
+    /**
+     * Phase 3: 激活 Rules 并跟踪触发次数
+     */
+    private activateRules;
+    /**
+     * Phase 4: 从高频 Rules 生成 Hooks
+     */
+    private generateHooksFromRules;
+    /**
+     * 从 Rule 生成 Hook 配置
+     */
+    private generateHookFromRule;
+    /**
+     * 生成 Hook 检查命令
+     */
+    private generateHookCommand;
+    /**
+     * 获取生成的 Hooks 配置（用于注册到 settings.json）
+     */
+    getGeneratedHooksConfig(): Record<string, HookConfig[]>;
+    /**
+     * 记录 Rule 触发（用于跟踪）
+     */
+    recordRuleHit(ruleId: string): void;
+    /**
+     * 获取当前状态
+     */
+    getState(): SelfImproveState;
+    /**
+     * 获取所有 Lesson Candidates
+     */
+    getLessonCandidates(): LessonCandidate[];
+    /**
+     * 获取所有 Rule Candidates
+     */
+    getRuleCandidates(): RuleCandidate[];
+    /**
+     * 获取所有生成的 Hooks
+     */
+    getGeneratedHooks(): HookGenerationResult[];
+    /**
+     * 生成自改进报告
+     */
+    generateReport(): string;
+    /**
+     * 重置引擎状态
+     */
+    reset(): void;
+}
+/**
+ * 手动验证 Lesson（用于外部确认）
+ */
+export declare function verifyLesson(engine: SelfImproveEngine, pattern: string): Promise<void>;
+/**
+ * 从多个会话运行自改进
+ */
+export declare function runSelfImproveFromSessions(eventBus: IEventBus, sessionIds: string[]): Promise<SelfImproveState[]>;
+export {};