@hongmaple0820/med-scale-research-os 0.43.0

package/dist/evolution/EvolutionEngine.js

@@ -0,0 +1,326 @@
+// SCALE Engine — Evolution Layer (W7)
+// 4 级自进化：Defect → Lesson → Rule → Hook
+// 设计参考：docs/01-ARCHITECTURE.md §二 L6
+import { logger } from '../core/logger.js';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { approveRuleMaturity, createShadowRuleMaturity } from './RuleMaturity.js';
+export class LessonExtractor {
+    constructor(store, kb, eventBus) {
+        this.store = store;
+        this.kb = kb;
+        this.eventBus = eventBus;
+    }
+    /**
+     * 从已关闭的 Defect 中提取 Lesson
+     * Gate 1: Defect 必须在 DIAGNOSED/FIXED/CLOSED 状态
+     * Gate 2: 必须有 rootCauseCategory
+     * Gate 3: 不重复（标题相似度检查）
+     */
+    async extract(defectId) {
+        const defect = await this.store.get(defectId);
+        if (!defect)
+            return null;
+        // Gate 1: 状态检查
+        if (!['DIAGNOSED', 'FIXED', 'CLOSED'].includes(defect.status)) {
+            logger.debug({ defectId, status: defect.status }, 'Defect not ready for lesson extraction');
+            return null;
+        }
+        // Gate 2: 根因检查
+        const payload = defect.payload;
+        const rootCause = payload.rootCauseCategory;
+        if (!rootCause || rootCause === 'unknown') {
+            logger.debug({ defectId }, 'Defect has no root cause');
+            return null;
+        }
+        // Gate 3: 去重
+        const title = `[${rootCause}] ${defect.title}`;
+        const existing = await this.kb.recall({ tags: [rootCause] });
+        const isDupe = existing.some((e) => this.similarity(e.title, title) > 0.85);
+        if (isDupe) {
+            logger.debug({ defectId, title }, 'Similar lesson already exists — skipping');
+            return null;
+        }
+        // 创建 Lesson
+        const entry = await this.kb.add({
+            type: 'lesson',
+            title,
+            tags: [rootCause, defect.type, ...(payload.tags ?? [])],
+            contentRef: `lessons/${defectId}.md`,
+            verified: false,
+            sourceArtifact: defectId,
+        });
+        this.eventBus.emit('lesson.proposed', {
+            lessonId: entry.id,
+            defectId,
+            rootCause,
+            title,
+        });
+        logger.info({ lessonId: entry.id, defectId }, 'Lesson extracted from defect');
+        return entry;
+    }
+    /**
+     * 扫描所有已关闭的 Defect，批量提取 lessons
+     */
+    async scanForPatterns() {
+        const defects = await this.store.query({ type: 'Defect' });
+        const closedDefects = defects.filter((d) => ['DIAGNOSED', 'FIXED', 'CLOSED'].includes(d.status));
+        const extracted = [];
+        for (const defect of closedDefects) {
+            const lesson = await this.extract(defect.id);
+            if (lesson)
+                extracted.push(lesson);
+        }
+        // 检测重复模式：同类根因出现 ≥3 次 → 标记为高优先
+        const causeCount = new Map();
+        for (const d of closedDefects) {
+            const cause = d.payload.rootCauseCategory;
+            if (cause)
+                causeCount.set(cause, (causeCount.get(cause) ?? 0) + 1);
+        }
+        for (const [cause, count] of causeCount) {
+            if (count >= 3) {
+                logger.warn({ cause, count }, 'Recurring defect pattern detected — consider promoting to Rule');
+            }
+        }
+        return extracted;
+    }
+    similarity(a, b) {
+        const setA = new Set(a.toLowerCase().split(/\s+/));
+        const setB = new Set(b.toLowerCase().split(/\s+/));
+        const intersection = [...setA].filter((w) => setB.has(w));
+        return intersection.length / Math.max(setA.size, setB.size);
+    }
+}
+export class RuleProposer {
+    constructor(kb, eventBus) {
+        this.kb = kb;
+        this.eventBus = eventBus;
+        this.rules = new Map();
+        this.seq = 0;
+    }
+    async proposeFromLesson(lessonId) {
+        const lessons = await this.kb.recall({});
+        const lesson = lessons.find((l) => l.id === lessonId);
+        if (!lesson)
+            return null;
+        // 只对 verified + active 的 lesson 提议
+        if (!lesson.verified) {
+            logger.debug({ lessonId }, 'Lesson not verified — cannot propose rule');
+            return null;
+        }
+        const ruleId = `RULE-${Date.now()}-${(++this.seq).toString().padStart(3, '0')}`;
+        const rule = {
+            id: ruleId,
+            title: `Rule: ${lesson.title}`,
+            description: `Auto-proposed from lesson ${lessonId}. Tags: ${lesson.tags.join(', ')}`,
+            sourceLesson: lessonId,
+            pattern: lesson.tags[0] ?? 'general',
+            enforcement: lesson.accessCount >= 5 ? 'hook' : 'prompt',
+            createdAt: Date.now(),
+            approved: false,
+            maturity: createShadowRuleMaturity({
+                ruleId,
+                rollback: 'Remove the generated hook and keep the rule as prompt-only guidance.',
+                defectEvidenceIds: lesson.sourceArtifact ? [lesson.sourceArtifact] : [],
+            }),
+        };
+        this.rules.set(rule.id, rule);
+        this.eventBus.emit('rule.proposed', {
+            ruleId: rule.id,
+            lessonId,
+            enforcement: rule.enforcement,
+        });
+        logger.info({ ruleId: rule.id, lessonId }, 'Rule proposed from lesson');
+        return rule;
+    }
+    async scanAndPropose() {
+        const lessons = await this.kb.recall({ verifiedOnly: true });
+        const proposed = [];
+        for (const lesson of lessons) {
+            // 只对 relevance ≥ 0.6 且 accessCount ≥ 3 的 lesson 自动提议
+            if (lesson.relevance >= 0.6 && lesson.accessCount >= 3) {
+                const existing = [...this.rules.values()].find((r) => r.sourceLesson === lesson.id);
+                if (!existing) {
+                    const rule = await this.proposeFromLesson(lesson.id);
+                    if (rule)
+                        proposed.push(rule);
+                }
+            }
+        }
+        return proposed;
+    }
+    async approve(ruleId, approvedBy) {
+        const rule = this.rules.get(ruleId);
+        if (!rule)
+            throw new Error(`Rule not found: ${ruleId}`);
+        const approvedMaturity = approveRuleMaturity(rule.maturity, approvedBy);
+        rule.approved = true;
+        rule.approvedBy = approvedBy;
+        rule.maturity = approvedMaturity;
+        this.eventBus.emit('rule.enforced', { ruleId, approvedBy });
+        logger.info({ ruleId, approvedBy }, 'Rule approved');
+        return rule;
+    }
+    getProposedRules() {
+        return [...this.rules.values()];
+    }
+    writeRuleFile(rule, rulesDir) {
+        mkdirSync(rulesDir, { recursive: true });
+        const filename = `${rule.id}.md`;
+        const path = join(rulesDir, filename);
+        const content = `# ${rule.title}
+
+> Source: ${rule.sourceLesson}
+> Enforcement: ${rule.enforcement}
+> Approved: ${rule.approved ? `Yes (by ${rule.approvedBy})` : 'Pending'}
+> Created: ${new Date(rule.createdAt).toISOString()}
+
+## Description
+
+${rule.description}
+
+## Pattern
+
+\`${rule.pattern}\`
+`;
+        writeFileSync(path, content, 'utf-8');
+        return path;
+    }
+}
+export class HookGenerator {
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+        this.hooks = [];
+    }
+    generate(rule, hooksDir) {
+        if (!rule.approved) {
+            logger.debug({ ruleId: rule.id }, 'Rule not approved — cannot generate hook');
+            return null;
+        }
+        if (rule.maturity && rule.maturity.stage !== 'approved-blocking') {
+            logger.debug({ ruleId: rule.id, stage: rule.maturity.stage }, 'Rule is not approved for blocking hook generation');
+            return null;
+        }
+        if (rule.enforcement !== 'hook') {
+            logger.debug({ ruleId: rule.id }, 'Rule enforcement is prompt, not hook — skipping');
+            return null;
+        }
+        mkdirSync(hooksDir, { recursive: true });
+        const hookType = this.inferHookType(rule.pattern);
+        const matcher = this.inferMatcher(rule.pattern);
+        const scriptName = `${rule.id}.sh`;
+        const scriptPath = join(hooksDir, scriptName);
+        // Generate shell script
+        const script = `#!/bin/bash
+# Auto-generated hook from Rule: ${rule.id}
+# Source lesson: ${rule.sourceLesson}
+# Pattern: ${rule.pattern}
+# Hook type: ${hookType} | Matcher: ${matcher}
+#
+# This hook was automatically promoted from a recurring lesson.
+# Edit with caution — it enforces a hard constraint.
+
+# Read tool input from stdin
+INPUT=$(cat)
+
+# Check condition
+# TODO: Implement specific check for pattern "${rule.pattern}"
+# For now, this is a placeholder that always passes.
+echo "Hook ${rule.id} checked (pattern: ${rule.pattern})" >&2
+exit 0
+`;
+        writeFileSync(scriptPath, script, 'utf-8');
+        const hook = {
+            id: `HOOK-${Date.now()}`,
+            ruleId: rule.id,
+            hookType,
+            matcher,
+            scriptPath,
+            createdAt: Date.now(),
+        };
+        this.hooks.push(hook);
+        this.eventBus.emit('hook.generated', {
+            hookId: hook.id,
+            ruleId: rule.id,
+            hookType,
+            matcher,
+            scriptPath,
+        });
+        logger.info({ hookId: hook.id, ruleId: rule.id, hookType }, 'Hook generated from rule');
+        return hook;
+    }
+    getGeneratedHooks() {
+        return [...this.hooks];
+    }
+    inferHookType(pattern) {
+        if (/test|verify|lint|build/i.test(pattern))
+            return 'Stop';
+        if (/edit|write|delete/i.test(pattern))
+            return 'PreToolUse';
+        return 'PostToolUse';
+    }
+    inferMatcher(pattern) {
+        if (/bash|command|shell/i.test(pattern))
+            return 'Bash';
+        if (/edit|write/i.test(pattern))
+            return 'Edit|Write|MultiEdit';
+        return '';
+    }
+}
+// ============================================================================
+// EvolutionEngine — 编排 4 级进化
+// ============================================================================
+export class EvolutionEngine {
+    constructor(extractor, proposer, generator, eventBus, scaleDir = '.scale') {
+        this.extractor = extractor;
+        this.proposer = proposer;
+        this.generator = generator;
+        this.scaleDir = scaleDir;
+        this.eventBus = eventBus;
+    }
+    /**
+     * 完整进化周期：
+     * 1. 扫描 Defects → 提取 Lessons
+     * 2. 扫描 Lessons → 提议 Rules
+     * 3. (人审后) 已批准 Rules → 生成 Hooks
+     */
+    async runCycle() {
+        const stats = {
+            lessonsExtracted: 0,
+            rulesProposed: 0,
+            shadowRules: 0,
+            rulesApproved: 0,
+            hooksGenerated: 0,
+        };
+        // Step 1: Extract lessons
+        const lessons = await this.extractor.scanForPatterns();
+        stats.lessonsExtracted = lessons.length;
+        // Step 2: Propose rules
+        const rules = await this.proposer.scanAndPropose();
+        stats.rulesProposed = rules.length;
+        stats.shadowRules = this.proposer.getProposedRules().filter((r) => r.maturity.stage === 'shadow').length;
+        // Step 3: Generate hooks for approved rules
+        const approvedRules = this.proposer.getProposedRules().filter((r) => r.approved && r.enforcement === 'hook' && r.maturity.stage === 'approved-blocking');
+        stats.rulesApproved = approvedRules.length;
+        const hooksDir = join(this.scaleDir, 'hooks');
+        for (const rule of approvedRules) {
+            const hook = this.generator.generate(rule, hooksDir);
+            if (hook)
+                stats.hooksGenerated++;
+        }
+        logger.info(stats, 'Evolution cycle completed');
+        this.eventBus.emit('evolution.cycle_completed', stats);
+        return stats;
+    }
+    getStats() {
+        return {
+            lessonsExtracted: 0, // Would need persistence
+            rulesProposed: this.proposer.getProposedRules().length,
+            shadowRules: this.proposer.getProposedRules().filter((r) => r.maturity.stage === 'shadow').length,
+            rulesApproved: this.proposer.getProposedRules().filter((r) => r.approved).length,
+            hooksGenerated: this.generator.getGeneratedHooks().length,
+        };
+    }
+}
+//# sourceMappingURL=EvolutionEngine.js.map

package/dist/evolution/EvolutionEngine.js.map

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

package/dist/evolution/EvolutionEvaluator.d.ts

@@ -0,0 +1,61 @@
+import type { IEventBus } from '../core/eventBus.js';
+import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
+import type { DetectorStatisticsTracker } from '../guardrails/DetectorEnhanced.js';
+export interface EvolutionMetrics {
+    lessonsProposed: number;
+    lessonsValidated: number;
+    lessonsApproved: number;
+    lessonsRejected: number;
+    lessonQualityScore: number;
+    rulesProposed: number;
+    rulesApproved: number;
+    rulesEnforced: number;
+    ruleEffectivenessScore: number;
+    hooksGenerated: number;
+    hooksDeployed: number;
+    hooksTriggered: number;
+    hookBlockingRate: number;
+    detectorTriggers: number;
+    detectorBlocks: number;
+    detectorWarnings: number;
+    detectorEffectivenessScore: number;
+    overallScore: number;
+    trend: 'improving' | 'stable' | 'declining';
+}
+export interface EvolutionSnapshot {
+    timestamp: number;
+    metrics: EvolutionMetrics;
+}
+export interface IEvolutionEvaluator {
+    evaluate(): Promise<EvolutionMetrics>;
+    getHistory(): EvolutionSnapshot[];
+    compareWithBaseline(baseline: EvolutionMetrics): Promise<{
+        improved: boolean;
+        delta: Partial<EvolutionMetrics>;
+    }>;
+    getRecommendations(): Promise<string[]>;
+}
+export declare class EvolutionEvaluator implements IEvolutionEvaluator {
+    private eventBus;
+    private stats?;
+    private history;
+    private maxHistory;
+    private lastSnapshotTimestamp;
+    constructor(eventBus: IEventBus, _kb?: IKnowledgeBase, stats?: DetectorStatisticsTracker | undefined, opts?: {
+        maxHistory?: number;
+    });
+    evaluate(): Promise<EvolutionMetrics>;
+    getHistory(): EvolutionSnapshot[];
+    compareWithBaseline(baseline: EvolutionMetrics): Promise<{
+        improved: boolean;
+        delta: Partial<EvolutionMetrics>;
+    }>;
+    getRecommendations(): Promise<string[]>;
+    private countEvents;
+    private nextSnapshotTimestamp;
+    private calculateLessonQuality;
+    private calculateRuleEffectiveness;
+    private calculateDetectorEffectiveness;
+    private calculateOverallScore;
+    private determineTrend;
+}

package/dist/evolution/EvolutionEvaluator.js

@@ -0,0 +1,118 @@
+// SCALE Engine — Evolution Evaluator (v0.7.0)
+// Self-evolution 循环效果评估
+import { logger } from '../core/logger.js';
+export class EvolutionEvaluator {
+    constructor(eventBus, 
+    // kb is reserved for future use with KB-based metrics
+    _kb, stats, opts = {}) {
+        this.eventBus = eventBus;
+        this.stats = stats;
+        this.history = [];
+        this.lastSnapshotTimestamp = 0;
+        this.maxHistory = opts.maxHistory ?? 30;
+    }
+    async evaluate() {
+        const metrics = {
+            lessonsProposed: await this.countEvents('lesson.proposed'),
+            lessonsValidated: await this.countEvents('lesson.validated'),
+            lessonsApproved: await this.countEvents('lesson.approved'),
+            lessonsRejected: await this.countEvents('lesson.rejected'),
+            lessonQualityScore: 0,
+            rulesProposed: await this.countEvents('rule.proposed'),
+            rulesApproved: await this.countEvents('rule.approved'),
+            rulesEnforced: await this.countEvents('rule.enforced'),
+            ruleEffectivenessScore: 0,
+            hooksGenerated: await this.countEvents('hook.generated'),
+            hooksDeployed: await this.countEvents('hook.deployed'),
+            hooksTriggered: await this.countEvents('tool.blocked'),
+            hookBlockingRate: 0,
+            detectorTriggers: this.stats ? this.stats.getRecentTriggers(100).length : 0,
+            detectorBlocks: this.stats ? this.stats.getRecentTriggers(100).filter(t => t.severity === 'block' || t.severity === 'deny').length : 0,
+            detectorWarnings: this.stats ? this.stats.getRecentTriggers(100).filter(t => t.severity === 'warn').length : 0,
+            detectorEffectivenessScore: 0,
+            overallScore: 0,
+            trend: 'stable',
+        };
+        metrics.lessonQualityScore = this.calculateLessonQuality(metrics);
+        metrics.ruleEffectivenessScore = this.calculateRuleEffectiveness(metrics);
+        metrics.hookBlockingRate = metrics.hooksTriggered > 0 ? metrics.detectorBlocks / metrics.hooksTriggered : 0;
+        metrics.detectorEffectivenessScore = this.calculateDetectorEffectiveness(metrics);
+        metrics.overallScore = this.calculateOverallScore(metrics);
+        metrics.trend = this.determineTrend(metrics);
+        this.history.push({ timestamp: this.nextSnapshotTimestamp(), metrics });
+        if (this.history.length > this.maxHistory)
+            this.history.shift();
+        this.eventBus.emit('evolution.evaluated', { score: metrics.overallScore, trend: metrics.trend });
+        logger.info({ score: metrics.overallScore, trend: metrics.trend }, 'Evolution evaluated');
+        return metrics;
+    }
+    getHistory() { return [...this.history]; }
+    async compareWithBaseline(baseline) {
+        const current = await this.evaluate();
+        const delta = {};
+        const keys = ['overallScore', 'lessonQualityScore', 'ruleEffectivenessScore', 'detectorEffectivenessScore'];
+        for (const key of keys) {
+            const currentVal = current[key];
+            const baselineVal = baseline[key];
+            const diff = currentVal - baselineVal;
+            // @ts-expect-error: Assigning number to optional field is intentional for delta calculation
+            delta[key] = diff;
+        }
+        const improved = delta.overallScore !== undefined && delta.overallScore > 0;
+        return { improved, delta };
+    }
+    async getRecommendations() {
+        const metrics = await this.evaluate();
+        const recommendations = [];
+        if (metrics.lessonQualityScore < 0.5)
+            recommendations.push('Lesson quality low. Focus on context-specific lessons.');
+        if (metrics.lessonsRejected > metrics.lessonsApproved)
+            recommendations.push('High rejection rate. Review validation criteria.');
+        if (metrics.rulesProposed > 0 && metrics.rulesApproved === 0)
+            recommendations.push('Rules proposed but none approved.');
+        if (metrics.hooksGenerated > metrics.hooksDeployed)
+            recommendations.push('Hooks not deployed. Run deployment.');
+        if (metrics.detectorWarnings > metrics.detectorBlocks * 3)
+            recommendations.push('Too many warnings. Consider stricter enforcement.');
+        return recommendations;
+    }
+    async countEvents(type) {
+        const events = await this.eventBus.query({ types: [type], limit: 1000 });
+        return events.length;
+    }
+    nextSnapshotTimestamp() {
+        const now = Date.now();
+        this.lastSnapshotTimestamp = Math.max(now, this.lastSnapshotTimestamp + 1);
+        return this.lastSnapshotTimestamp;
+    }
+    calculateLessonQuality(m) {
+        if (m.lessonsProposed === 0)
+            return 0;
+        return (m.lessonsApproved / m.lessonsProposed) * 0.6 + (m.lessonsValidated / m.lessonsProposed) * 0.4;
+    }
+    calculateRuleEffectiveness(m) {
+        if (m.rulesApproved === 0)
+            return 0;
+        return Math.min(1, m.rulesEnforced / m.rulesApproved);
+    }
+    calculateDetectorEffectiveness(m) {
+        if (m.detectorTriggers === 0)
+            return 0;
+        return Math.min(1, (m.detectorBlocks / m.detectorTriggers) * 2);
+    }
+    calculateOverallScore(m) {
+        return m.lessonQualityScore * 0.3 + m.ruleEffectivenessScore * 0.25 + m.detectorEffectivenessScore * 0.25 + (m.hookBlockingRate > 0 ? 0.2 : 0);
+    }
+    determineTrend(m) {
+        if (this.history.length < 2)
+            return 'stable';
+        const prev = this.history[this.history.length - 2].metrics.overallScore;
+        const delta = m.overallScore - prev;
+        if (delta > 0.05)
+            return 'improving';
+        if (delta < -0.05)
+            return 'declining';
+        return 'stable';
+    }
+}
+//# sourceMappingURL=EvolutionEvaluator.js.map

package/dist/evolution/EvolutionEvaluator.js.map

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

package/dist/evolution/LessonValidator.d.ts

@@ -0,0 +1,36 @@
+import type { KnowledgeEntry } from '../artifact/types.js';
+import type { IEventBus } from '../core/eventBus.js';
+import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
+export interface ValidationResult {
+    valid: boolean;
+    gateResults: GateResult[];
+    overallScore: number;
+    reason?: string;
+}
+export interface GateResult {
+    gateName: string;
+    passed: boolean;
+    score: number;
+    details: string;
+}
+export interface ILessonValidator {
+    validate(entry: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<ValidationResult>;
+    checkGoogleability(title: string): Promise<GateResult>;
+    checkContextSpecific(entry: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<GateResult>;
+    checkDuplicate(title: string, contentRef: string): Promise<GateResult>;
+}
+export declare class LessonValidator implements ILessonValidator {
+    private eventBus;
+    private kb;
+    private minGoogleabilityScore;
+    private maxDuplicateSimilarity;
+    constructor(eventBus: IEventBus, kb?: IKnowledgeBase, opts?: {
+        minGoogleabilityScore?: number;
+        maxDuplicateSimilarity?: number;
+    });
+    validate(entry: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<ValidationResult>;
+    checkGoogleability(title: string): Promise<GateResult>;
+    checkContextSpecific(entry: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<GateResult>;
+    checkDuplicate(title: string, _contentRef: string): Promise<GateResult>;
+    private calculateSimilarity;
+}