@hongmaple0820/scale-engine 0.10.1 → 0.11.0

package/dist/workflow/evolution/SelfImproveEngine.js

@@ -0,0 +1,361 @@
+// SCALE Engine — Self-Improve Engine
+// Defect → Lesson → Rule → Hook 自改进闭环
+// 设计参考：docs/03-CORE-MODULES.md §3.6 + L6 Evolution
+import { LessonExtractor } from './LessonExtractor.js';
+/**
+ * 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 class SelfImproveEngine {
+    constructor(eventBus, thresholds) {
+        // 存储候选
+        this.lessonCandidates = new Map();
+        this.ruleCandidates = new Map();
+        this.generatedHooks = [];
+        this.eventBus = eventBus;
+        this.thresholds = {
+            lessonVerificationThreshold: 3,
+            ruleActivationThreshold: 10,
+            hookGenerationThreshold: 20,
+            maxHooks: 10,
+            ...thresholds
+        };
+        this.lessonExtractor = new LessonExtractor(eventBus, 2);
+        this.state = {
+            lessonsExtracted: 0,
+            lessonsVerified: 0,
+            rulesCreated: 0,
+            rulesActive: 0,
+            hooksGenerated: 0,
+            lastRunAt: 0
+        };
+    }
+    /**
+     * 运行自改进闭环
+     */
+    async run(sessionId) {
+        this.eventBus.emit('self-improve.start', { sessionId, thresholds: this.thresholds });
+        const startTime = Date.now();
+        // Phase 1: Extract Lessons from Defects
+        const lessons = await this.extractLessons(sessionId);
+        // Phase 2: Verify and Promote Lessons to Rules
+        const rules = await this.verifyAndPromoteLessons(lessons);
+        // Phase 3: Activate Rules and Track Hits
+        const activeRules = await this.activateRules(rules);
+        // Phase 4: Generate Hooks from High-Frequency Rules
+        const hooks = await this.generateHooksFromRules(activeRules);
+        // 更新状态
+        this.state = {
+            lessonsExtracted: lessons.length,
+            lessonsVerified: this.lessonCandidates.size,
+            rulesCreated: rules.length,
+            rulesActive: activeRules.length,
+            hooksGenerated: hooks.length,
+            lastRunAt: startTime
+        };
+        this.eventBus.emit('self-improve.end', {
+            sessionId,
+            state: this.state,
+            durationMs: Date.now() - startTime
+        });
+        return this.state;
+    }
+    /**
+     * Phase 1: 从会话提取 Lessons
+     */
+    async extractLessons(sessionId) {
+        this.eventBus.emit('self-improve.phase.extract', { sessionId });
+        const candidates = await this.lessonExtractor.extractFromSession(sessionId);
+        // 存储候选
+        for (const candidate of candidates) {
+            const existing = this.lessonCandidates.get(candidate.pattern) ?? candidate;
+            existing.frequency += candidate.frequency;
+            existing.defectIds.push(...candidate.defectIds);
+            this.lessonCandidates.set(candidate.pattern, existing);
+        }
+        return candidates;
+    }
+    /**
+     * Phase 2: 验证并晋升 Lessons 为 Rules
+     */
+    async verifyAndPromoteLessons(candidates) {
+        this.eventBus.emit('self-improve.phase.verify', { candidatesCount: candidates.length });
+        const rules = [];
+        for (const [pattern, candidate] of this.lessonCandidates.entries()) {
+            // 检查是否达到验证阈值
+            if (candidate.frequency >= this.thresholds.lessonVerificationThreshold) {
+                candidate.verified = true;
+                // 创建 Rule Candidate
+                const ruleCandidate = this.createRuleCandidate(candidate);
+                this.ruleCandidates.set(ruleCandidate.id, ruleCandidate);
+                rules.push(ruleCandidate);
+                this.eventBus.emit('self-improve.lesson.promoted', {
+                    pattern,
+                    ruleId: ruleCandidate.id
+                });
+            }
+        }
+        return rules;
+    }
+    /**
+     * 创建 Rule Candidate
+     */
+    createRuleCandidate(lesson) {
+        return {
+            id: `rule-${Date.now()}-${lesson.defectIds[0]}`,
+            name: lesson.pattern.slice(0, 50).replace(/\s+/g, '-').toLowerCase(),
+            pattern: this.patternToRegExp(lesson.pattern),
+            severity: lesson.priority === 'HIGH' ? 'block' : lesson.priority === 'MEDIUM' ? 'warn' : 'info',
+            description: lesson.pattern,
+            remediation: lesson.solution,
+            lessonId: lesson.defectIds[0],
+            hitCount: 0,
+            lastHitAt: 0,
+            active: false
+        };
+    }
+    /**
+     * 将模式字符串转换为 RegExp
+     */
+    patternToRegExp(pattern) {
+        // 常见模式的 RegExp 转换
+        const patternMappings = {
+            'Missing null check': /\?\s*\.\s*\w+|undefined\s*\.\s*\w+/,
+            'Async/await handling': /async\s+\w+\s*\([^)]*\)\s*\{[^}]*\breturn\b[^}]*\}/,
+            'Type mismatch': /as\s+any|:\s*any\b|@ts-ignore/,
+            'Missing import': /import\s+.*from\s+['"]undefined['"]|^.*\b\w+\b.*\n.*\b\w+\s*\(/,
+        };
+        // 尝试匹配已知模式
+        for (const [key, regex] of Object.entries(patternMappings)) {
+            if (pattern.includes(key)) {
+                return regex;
+            }
+        }
+        // 默认：创建简单文本匹配
+        const safePattern = pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').slice(0, 30);
+        return new RegExp(safePattern, 'i');
+    }
+    /**
+     * Phase 3: 激活 Rules 并跟踪触发次数
+     */
+    async activateRules(rules) {
+        this.eventBus.emit('self-improve.phase.activate', { rulesCount: rules.length });
+        const activeRules = [];
+        // 检查现有规则的触发历史
+        for (const [id, rule] of this.ruleCandidates.entries()) {
+            // 查询历史触发次数（通过 eventBus）
+            const hits = await this.eventBus.query({
+                types: ['rule.hit'],
+                filter: (e) => {
+                    const p = e.payload;
+                    return p.ruleId === id;
+                },
+                limit: 100
+            });
+            rule.hitCount = hits.length;
+            rule.lastHitAt = hits[0]?.timestamp ?? 0;
+            // 达到阈值则激活
+            if (rule.hitCount >= this.thresholds.ruleActivationThreshold) {
+                rule.active = true;
+                activeRules.push(rule);
+                this.eventBus.emit('self-improve.rule.activated', {
+                    ruleId: id,
+                    hitCount: rule.hitCount
+                });
+            }
+        }
+        return activeRules;
+    }
+    /**
+     * Phase 4: 从高频 Rules 生成 Hooks
+     */
+    async generateHooksFromRules(rules) {
+        this.eventBus.emit('self-improve.phase.hooks', { activeRulesCount: rules.length });
+        const hooks = [];
+        for (const rule of rules) {
+            // 检查是否达到 Hook 生成阈值
+            if (rule.hitCount >= this.thresholds.hookGenerationThreshold && this.generatedHooks.length < this.thresholds.maxHooks) {
+                const hook = this.generateHookFromRule(rule);
+                hooks.push(hook);
+                this.generatedHooks.push(hook);
+                this.eventBus.emit('self-improve.hook.generated', {
+                    hookType: hook.hookType,
+                    ruleId: rule.id,
+                    matcher: hook.matcher
+                });
+            }
+        }
+        return hooks;
+    }
+    /**
+     * 从 Rule 生成 Hook 配置
+     */
+    generateHookFromRule(rule) {
+        // 确定 Hook 类型
+        const hookType = rule.severity === 'block' ? 'PreToolUse' : 'PostToolUse';
+        // 确定 Matcher
+        const matcher = rule.severity === 'block' ? 'Write|Edit|MultiEdit' : 'Write|Edit';
+        // 生成检查命令
+        const command = this.generateHookCommand(rule);
+        return {
+            hookType,
+            matcher,
+            command,
+            description: `Auto-generated from rule: ${rule.name}`,
+            ruleId: rule.id
+        };
+    }
+    /**
+     * 生成 Hook 检查命令
+     */
+    generateHookCommand(rule) {
+        // 生成 Node.js 检查脚本
+        const script = `
+const pattern = ${rule.pattern.toString()};
+const content = process.argv[2] || '';
+const matches = content.match(pattern);
+if (matches) {
+  console.error('[RULE: ${rule.name}] ${rule.description}');
+  console.error('Remediation: ${rule.remediation}');
+  process.exit(${rule.severity === 'block' ? '1' : '0'});
+}
+process.exit(0);
+`;
+        return `node -e "${script.replace(/\n/g, ' ').replace(/"/g, '\\"')}" "$CONTENT"`;
+    }
+    /**
+     * 获取生成的 Hooks 配置（用于注册到 settings.json）
+     */
+    getGeneratedHooksConfig() {
+        const hooks = {
+            PreToolUse: [],
+            PostToolUse: [],
+            Stop: []
+        };
+        for (const hook of this.generatedHooks) {
+            hooks[hook.hookType].push({
+                matcher: hook.matcher,
+                command: hook.command,
+                description: hook.description,
+                timeout: 5000
+            });
+        }
+        return hooks;
+    }
+    /**
+     * 记录 Rule 触发（用于跟踪）
+     */
+    recordRuleHit(ruleId) {
+        const rule = this.ruleCandidates.get(ruleId);
+        if (rule) {
+            rule.hitCount++;
+            rule.lastHitAt = Date.now();
+            this.eventBus.emit('rule.hit', { ruleId, hitCount: rule.hitCount });
+        }
+    }
+    /**
+     * 获取当前状态
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * 获取所有 Lesson Candidates
+     */
+    getLessonCandidates() {
+        return Array.from(this.lessonCandidates.values());
+    }
+    /**
+     * 获取所有 Rule Candidates
+     */
+    getRuleCandidates() {
+        return Array.from(this.ruleCandidates.values());
+    }
+    /**
+     * 获取所有生成的 Hooks
+     */
+    getGeneratedHooks() {
+        return this.generatedHooks;
+    }
+    /**
+     * 生成自改进报告
+     */
+    generateReport() {
+        const lines = [
+            '=== Self-Improve Engine Report ===',
+            '',
+            '[STATE]',
+            `  Lessons Extracted: ${this.state.lessonsExtracted}`,
+            `  Lessons Verified: ${this.state.lessonsVerified}`,
+            `  Rules Created: ${this.state.rulesCreated}`,
+            `  Rules Active: ${this.state.rulesActive}`,
+            `  Hooks Generated: ${this.state.hooksGenerated}`,
+            '',
+            '[TOP LESSONS]',
+            ...this.getLessonCandidates().slice(0, 5).map(l => `  - ${l.pattern} (${l.frequency} occurrences, ${l.priority})`),
+            '',
+            '[ACTIVE RULES]',
+            ...this.getRuleCandidates().filter(r => r.active).map(r => `  - ${r.name} (${r.hitCount} hits)`),
+            '',
+            '[GENERATED HOOKS]',
+            ...this.generatedHooks.map(h => `  - ${h.hookType}: ${h.matcher} (${h.description})`),
+            ''
+        ];
+        return lines.join('\n');
+    }
+    /**
+     * 重置引擎状态
+     */
+    reset() {
+        this.lessonCandidates.clear();
+        this.ruleCandidates.clear();
+        this.generatedHooks = [];
+        this.state = {
+            lessonsExtracted: 0,
+            lessonsVerified: 0,
+            rulesCreated: 0,
+            rulesActive: 0,
+            hooksGenerated: 0,
+            lastRunAt: 0
+        };
+        this.eventBus.emit('self-improve.reset', {});
+    }
+}
+/**
+ * 手动验证 Lesson（用于外部确认）
+ */
+export async function verifyLesson(engine, pattern) {
+    const candidates = engine.getLessonCandidates();
+    const candidate = candidates.find(c => c.pattern === pattern);
+    if (candidate) {
+        candidate.verified = true;
+        candidate.frequency += 1;
+        // 检查是否达到阈值晋升
+        if (candidate.frequency >= engine.getState().lessonsVerified) {
+            // 触发晋升流程
+            engine.recordRuleHit(`lesson-${pattern}`);
+        }
+    }
+}
+/**
+ * 从多个会话运行自改进
+ */
+export async function runSelfImproveFromSessions(eventBus, sessionIds) {
+    const engine = new SelfImproveEngine(eventBus);
+    const states = [];
+    for (const sessionId of sessionIds) {
+        const state = await engine.run(sessionId);
+        states.push(state);
+    }
+    return states;
+}
+//# sourceMappingURL=SelfImproveEngine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelfImproveEngine.js","sourceRoot":"","sources":["../../../src/workflow/evolution/SelfImproveEngine.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,sCAAsC;AACtC,mDAAmD;AAInD,OAAO,EAAE,eAAe,EAAwB,MAAM,sBAAsB,CAAA;AAiE5E;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,iBAAiB;IAW5B,YACE,QAAmB,EACnB,UAA2C;QAP7C,OAAO;QACC,qBAAgB,GAAiC,IAAI,GAAG,EAAE,CAAA;QAC1D,mBAAc,GAA+B,IAAI,GAAG,EAAE,CAAA;QACtD,mBAAc,GAA2B,EAAE,CAAA;QAMjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,UAAU,GAAG;YAChB,2BAA2B,EAAE,CAAC;YAC9B,uBAAuB,EAAE,EAAE;YAC3B,uBAAuB,EAAE,EAAE;YAC3B,QAAQ,EAAE,EAAE;YACZ,GAAG,UAAU;SACd,CAAA;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;QACvD,IAAI,CAAC,KAAK,GAAG;YACX,gBAAgB,EAAE,CAAC;YACnB,eAAe,EAAE,CAAC;YAClB,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,CAAC;YACd,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,CAAC;SACb,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAA;QACpF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE5B,wCAAwC;QACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;QAEpD,+CAA+C;QAC/C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAA;QAEzD,yCAAyC;QACzC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAEnD,oDAAoD;QACpD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAA;QAE5D,OAAO;QACP,IAAI,CAAC,KAAK,GAAG;YACX,gBAAgB,EAAE,OAAO,CAAC,MAAM;YAChC,eAAe,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI;YAC3C,YAAY,EAAE,KAAK,CAAC,MAAM;YAC1B,WAAW,EAAE,WAAW,CAAC,MAAM;YAC/B,cAAc,EAAE,KAAK,CAAC,MAAM;YAC5B,SAAS,EAAE,SAAS;SACrB,CAAA;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE;YACrC,SAAS;YACT,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACnC,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,SAAiB;QAC5C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;QAE/D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAE3E,OAAO;QACP,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAA;YAC1E,QAAQ,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,CAAA;YACzC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;YAC/C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QACxD,CAAC;QAED,OAAO,UAAU,CAAA;IACnB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,uBAAuB,CAAC,UAA6B;QACjE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,eAAe,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QAEvF,MAAM,KAAK,GAAoB,EAAE,CAAA;QAEjC,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC;YACnE,aAAa;YACb,IAAI,SAAS,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,2BAA2B,EAAE,CAAC;gBACvE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAA;gBAEzB,oBAAoB;gBACpB,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAA;gBACzD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC,CAAA;gBACxD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;gBAEzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,8BAA8B,EAAE;oBACjD,OAAO;oBACP,MAAM,EAAE,aAAa,CAAC,EAAE;iBACzB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,MAAuB;QACjD,OAAO;YACL,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;YAC/C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE;YACpE,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC;YAC7C,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAC/F,WAAW,EAAE,MAAM,CAAC,OAAO;YAC3B,WAAW,EAAE,MAAM,CAAC,QAAQ;YAC5B,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7B,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK;SACd,CAAA;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAe;QACrC,kBAAkB;QAClB,MAAM,eAAe,GAA2B;YAC9C,oBAAoB,EAAE,oCAAoC;YAC1D,sBAAsB,EAAE,oDAAoD;YAC5E,eAAe,EAAE,+BAA+B;YAChD,gBAAgB,EAAE,gEAAgE;SACnF,CAAA;QAED,WAAW;QACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YAC3D,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,cAAc;QACd,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC/E,OAAO,IAAI,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,KAAsB;QAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QAE/E,MAAM,WAAW,GAAoB,EAAE,CAAA;QAEvC,cAAc;QACd,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,wBAAwB;YACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACrC,KAAK,EAAE,CAAC,UAAU,CAAC;gBACnB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;oBACZ,MAAM,CAAC,GAAG,CAAC,CAAC,OAA8B,CAAA;oBAC1C,OAAO,CAAC,CAAC,MAAM,KAAK,EAAE,CAAA;gBACxB,CAAC;gBACD,KAAK,EAAE,GAAG;aACX,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAA;YAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,CAAC,CAAA;YAExC,UAAU;YACV,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC;gBAC7D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;gBAClB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAEtB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,6BAA6B,EAAE;oBAChD,MAAM,EAAE,EAAE;oBACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;iBACxB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAA;IACpB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,sBAAsB,CAAC,KAAsB;QACzD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,gBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QAElF,MAAM,KAAK,GAA2B,EAAE,CAAA;QAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,mBAAmB;YACnB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,uBAAuB,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACtH,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAA;gBAC5C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAChB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAE9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,6BAA6B,EAAE;oBAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,IAAmB;QAC9C,aAAa;QACb,MAAM,QAAQ,GAA0C,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAA;QAEhH,aAAa;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,YAAY,CAAA;QAEjF,SAAS;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAE9C,OAAO;YACL,QAAQ;YACR,OAAO;YACP,OAAO;YACP,WAAW,EAAE,6BAA6B,IAAI,CAAC,IAAI,EAAE;YACrD,MAAM,EAAE,IAAI,CAAC,EAAE;SAChB,CAAA;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,IAAmB;QAC7C,kBAAkB;QAClB,MAAM,MAAM,GAAG;kBACD,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;;;;0BAIf,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW;gCACxB,IAAI,CAAC,WAAW;iBAC/B,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;;;CAGrD,CAAA;QAEG,OAAO,YAAY,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAA;IAClF,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,MAAM,KAAK,GAAiC;YAC1C,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,EAAE;YACf,IAAI,EAAE,EAAE;SACT,CAAA;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;gBACxB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,OAAO,EAAE,IAAI;aACd,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,MAAc;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,QAAQ,EAAE,CAAA;YACf,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAA;IACnD,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAA;IACjD,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,MAAM,KAAK,GAAa;YACtB,oCAAoC;YACpC,EAAE;YACF,SAAS;YACT,wBAAwB,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE;YACrD,uBAAuB,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE;YACnD,oBAAoB,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE;YAC7C,mBAAmB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAC3C,sBAAsB,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;YACjD,EAAE;YACF,eAAe;YACf,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAChD,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,QAAQ,GAAG,CAC/D;YACD,EAAE;YACF,gBAAgB;YAChB,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACxD,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,QAAQ,CACrC;YACD,EAAE;YACF,mBAAmB;YACnB,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAC7B,OAAO,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,WAAW,GAAG,CACrD;YACD,EAAE;SACH,CAAA;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAA;QAC7B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;QAC3B,IAAI,CAAC,cAAc,GAAG,EAAE,CAAA;QACxB,IAAI,CAAC,KAAK,GAAG;YACX,gBAAgB,EAAE,CAAC;YACnB,eAAe,EAAE,CAAC;YAClB,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,CAAC;YACd,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,CAAC;SACb,CAAA;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;IAC9C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAyB,EACzB,OAAe;IAEf,MAAM,UAAU,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAA;IAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;IAE7D,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAA;QACzB,SAAS,CAAC,SAAS,IAAI,CAAC,CAAA;QAExB,aAAa;QACb,IAAI,SAAS,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,eAAe,EAAE,CAAC;YAC7D,SAAS;YACT,MAAM,CAAC,aAAa,CAAC,UAAU,OAAO,EAAE,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,QAAmB,EACnB,UAAoB;IAEpB,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAuB,EAAE,CAAA;IAErC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/workflow/qa/E2ETestRunner.d.ts

@@ -0,0 +1,102 @@
+import type { IEventBus } from '../../core/eventBus.js';
+import type { VerificationResult } from '../types.js';
+import { BrowserQACapability, type UserFlow, type QAResult } from '../../capabilities/BrowserQACapability.js';
+/**
+ * E2E 测试配置
+ */
+export interface E2ETestConfig {
+    baseUrl: string;
+    flows: UserFlow[];
+    timeoutMs: number;
+    retryCount: number;
+    screenshotDir: string;
+    accessibilityCheck: boolean;
+    performanceCheck: boolean;
+}
+/**
+ * E2E 测试结果
+ */
+export interface E2ETestResult {
+    passed: boolean;
+    totalFlows: number;
+    passedFlows: number;
+    failedFlows: number;
+    results: QAResult[];
+    accessibilityIssues: number;
+    performanceMetrics?: {
+        avgLoadTimeMs: number;
+        maxLoadTimeMs: number;
+    };
+    report: string;
+}
+/**
+ * E2E Test Runner
+ *
+ * 运行 E2E 测试并生成验证结果：
+ * 1. 执行用户流程测试
+ * 2. 检查 Console 错误
+ * 3. Accessibility 检查（可选）
+ * 4. 性能检查（可选）
+ * 5. 生成 Honest Delivery 报告
+ */
+export declare class E2ETestRunner {
+    private eventBus;
+    private browserQA;
+    private config;
+    constructor(eventBus: IEventBus, config: E2ETestConfig);
+    /**
+     * 运行完整 E2E 测试
+     */
+    run(): Promise<E2ETestResult>;
+    /**
+     * 转换为 VerificationResult（用于 WorkflowEngine G8 门控）
+     */
+    toVerificationResult(result: E2ETestResult): VerificationResult[];
+    /**
+     * 运行并生成 VerificationResult（用于 G8 门控）
+     */
+    runForVerification(): Promise<VerificationResult[]>;
+    /**
+     * 添加自定义流程
+     */
+    addFlow(flow: UserFlow): void;
+    /**
+     * 获取 MCP 工具调用序列（用于 Claude Code 实际执行）
+     */
+    getMCPExecutionPlan(): {
+        flow: UserFlow;
+        calls: ReturnType<BrowserQACapability['getMCPCallSequence']>;
+    }[];
+    /**
+     * 快速验证（仅检查关键流程）
+     */
+    quickVerify(): Promise<boolean>;
+    private sleep;
+}
+/**
+ * E2E 测试配置预设
+ */
+export declare const E2EPresets: {
+    /**
+     * 快速测试（仅关键流程，无重试）
+     */
+    quick: (baseUrl: string, flows: UserFlow[]) => E2ETestConfig;
+    /**
+     * 标准测试（完整流程，2次重试）
+     */
+    standard: (baseUrl: string, flows: UserFlow[]) => E2ETestConfig;
+    /**
+     * 完整测试（所有检查，3次重试）
+     */
+    full: (baseUrl: string, flows: UserFlow[]) => E2ETestConfig;
+};
+/**
+ * G8 浏览器门控检查
+ *
+ * 用于 WorkflowEngine 的第 8 个门控（浏览器 QA）
+ */
+export declare function browserGateCheck(eventBus: IEventBus, baseUrl: string, flows: UserFlow[]): Promise<{
+    passed: boolean;
+    verifications: VerificationResult[];
+    report: string;
+}>;