@hongmaple0820/med-scale-research-os 0.43.0

package/dist/evolution/LessonValidator.js

@@ -0,0 +1,132 @@
+// SCALE Engine — Lesson Validator (v0.7.0)
+// Lesson 提取验证：Googleability、Context-Specific、Non-Duplicate
+import { logger } from '../core/logger.js';
+export class LessonValidator {
+    constructor(eventBus, kb, opts = {}) {
+        this.eventBus = eventBus;
+        this.kb = kb ?? null;
+        this.minGoogleabilityScore = opts.minGoogleabilityScore ?? 0.3;
+        this.maxDuplicateSimilarity = opts.maxDuplicateSimilarity ?? 0.8;
+    }
+    async validate(entry) {
+        const gateResults = [];
+        // Gate 1: Trigger Check (already done by LessonExtractor)
+        const triggerGate = {
+            gateName: 'trigger',
+            passed: true,
+            score: 1.0,
+            details: 'Defect passed trigger conditions',
+        };
+        gateResults.push(triggerGate);
+        // Gate 2: Googleability (not easily searchable)
+        const googleabilityGate = await this.checkGoogleability(entry.title);
+        gateResults.push(googleabilityGate);
+        // Gate 3: Context-Specific (references specific artifacts)
+        const contextGate = await this.checkContextSpecific(entry);
+        gateResults.push(contextGate);
+        // Gate 4: Deduplication
+        const duplicateGate = await this.checkDuplicate(entry.title, entry.contentRef);
+        gateResults.push(duplicateGate);
+        // Calculate overall score
+        const totalScore = gateResults.reduce((sum, g) => sum + g.score, 0) / gateResults.length;
+        const allPassed = gateResults.every(g => g.passed);
+        const result = {
+            valid: allPassed,
+            gateResults,
+            overallScore: totalScore,
+            reason: allPassed ? undefined : 'Failed gates: ' + gateResults.filter(g => !g.passed).map(g => g.gateName).join(', '),
+        };
+        this.eventBus.emit('lesson.validated', {
+            title: entry.title,
+            valid: result.valid,
+            score: result.overallScore,
+            gates: gateResults,
+        });
+        logger.info({ title: entry.title, valid: result.valid, score: totalScore }, 'Lesson validated');
+        return result;
+    }
+    async checkGoogleability(title) {
+        // Simulate googleability check (in production, would call actual search API)
+        // High googleability = easily found on Google = not unique enough
+        // We want lessons that are NOT easily googleable (context-specific)
+        // Placeholder implementation: check for generic terms
+        const genericTerms = [
+            'error', 'bug', 'fix', 'issue', 'how to', 'tutorial',
+            'guide', 'documentation', 'reference', 'api', 'example',
+        ];
+        const titleLower = title.toLowerCase();
+        const hasGenericTerm = genericTerms.some(t => titleLower.includes(t));
+        // If title has many generic terms, it's probably googleable (bad)
+        // We want titles that are specific enough that you can't just Google them
+        const score = hasGenericTerm ? 0.2 : 0.8;
+        const passed = score >= this.minGoogleabilityScore;
+        return {
+            gateName: 'googleability',
+            passed,
+            score,
+            details: passed
+                ? 'Title is context-specific, not easily googleable'
+                : 'Title contains generic terms, likely googleable',
+        };
+    }
+    async checkContextSpecific(entry) {
+        // Check if lesson references specific context (artifact, project, specific code)
+        const hasSourceArtifact = entry.sourceArtifact !== undefined;
+        const hasTags = entry.tags.length > 0;
+        // Check content for context markers
+        const contentRef = entry.contentRef.toLowerCase();
+        const hasContextMarkers = /art-|spec-|plan-|task-|defect-/.test(contentRef);
+        const score = (hasSourceArtifact ? 0.4 : 0) + (hasTags ? 0.3 : 0) + (hasContextMarkers ? 0.3 : 0);
+        const passed = score >= 0.5;
+        return {
+            gateName: 'context_specific',
+            passed,
+            score,
+            details: passed
+                ? 'Lesson has context markers (artifact refs, tags)'
+                : 'Lesson lacks specific context references',
+        };
+    }
+    async checkDuplicate(title, _contentRef) {
+        if (!this.kb) {
+            return {
+                gateName: 'deduplication',
+                passed: true,
+                score: 1.0,
+                details: 'No KB available for deduplication check',
+            };
+        }
+        // Check for similar lessons in KB
+        const existing = await this.kb.recall({
+            tags: [],
+            limit: 100,
+        });
+        // Simple title similarity check
+        const titleLower = title.toLowerCase();
+        let maxSimilarity = 0;
+        for (const entry of existing) {
+            const existingTitle = entry.title.toLowerCase();
+            const similarity = this.calculateSimilarity(titleLower, existingTitle);
+            maxSimilarity = Math.max(maxSimilarity, similarity);
+        }
+        const passed = maxSimilarity < this.maxDuplicateSimilarity;
+        const score = 1 - maxSimilarity;
+        return {
+            gateName: 'deduplication',
+            passed,
+            score,
+            details: passed
+                ? 'No similar lesson found (max similarity: ' + maxSimilarity.toFixed(2) + ')'
+                : 'Similar lesson exists (similarity: ' + maxSimilarity.toFixed(2) + ')',
+        };
+    }
+    calculateSimilarity(a, b) {
+        // Simple word overlap similarity
+        const wordsA = a.split(/\s+/);
+        const wordsB = b.split(/\s+/);
+        const intersection = wordsA.filter(w => wordsB.includes(w));
+        const union = [...new Set([...wordsA, ...wordsB])];
+        return intersection.length / union.length;
+    }
+}
+//# sourceMappingURL=LessonValidator.js.map

package/dist/evolution/LessonValidator.js.map

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

package/dist/evolution/PatternExtractor.d.ts

@@ -0,0 +1,40 @@
+import type { IArtifactStore } from '../artifact/store.js';
+import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
+import type { IEventBus } from '../core/eventBus.js';
+import type { ArtifactId } from '../artifact/types.js';
+export interface Pattern {
+    id: string;
+    name: string;
+    description: string;
+    contexts: string[];
+    steps: PatternStep[];
+    successRate: number;
+    extractedFrom: ArtifactId[];
+    createdAt: number;
+    verified: boolean;
+}
+export interface PatternStep {
+    order: number;
+    action: string;
+    expectedOutcome: string;
+    toolsUsed: string[];
+}
+export interface IPatternExtractor {
+    extractFromArtifact(artifactId: ArtifactId): Promise<Pattern | null>;
+    extractFromSession(sessionId: string): Promise<Pattern[]>;
+    validatePattern(pattern: Pattern): Promise<boolean>;
+    getPatterns(): Pattern[];
+}
+export declare class PatternExtractor implements IPatternExtractor {
+    private store;
+    private kb;
+    private eventBus;
+    private patterns;
+    private seq;
+    constructor(store: IArtifactStore, kb: IKnowledgeBase, eventBus: IEventBus);
+    extractFromArtifact(artifactId: ArtifactId): Promise<Pattern | null>;
+    extractFromSession(sessionId: string): Promise<Pattern[]>;
+    validatePattern(pattern: Pattern): Promise<boolean>;
+    getPatterns(): Pattern[];
+    private buildPattern;
+}

package/dist/evolution/PatternExtractor.js

@@ -0,0 +1,83 @@
+// SCALE Engine — Pattern Extractor (Positive Learning)
+// Purpose: Extract successful patterns from completed artifacts
+import { logger } from '../core/logger.js';
+export class PatternExtractor {
+    constructor(store, kb, eventBus) {
+        this.store = store;
+        this.kb = kb;
+        this.eventBus = eventBus;
+        this.patterns = new Map();
+        this.seq = 0;
+    }
+    async extractFromArtifact(artifactId) {
+        const artifact = await this.store.get(artifactId);
+        if (!artifact)
+            return null;
+        if (artifact.status !== 'DONE') {
+            logger.debug({ artifactId, status: artifact.status }, 'Artifact not DONE');
+            return null;
+        }
+        const payload = artifact.payload;
+        const transitions = payload.transitions;
+        if (!transitions || transitions.length < 2)
+            return null;
+        const retries = payload.transitionRetries;
+        if (retries && retries > 0)
+            return null;
+        const pattern = this.buildPattern(artifact, transitions);
+        this.patterns.set(pattern.id, pattern);
+        await this.kb.add({
+            type: 'pattern',
+            title: pattern.name,
+            tags: [...pattern.contexts, 'positive-learning'],
+            contentRef: 'patterns/' + pattern.id + '.md',
+            verified: false,
+            sourceArtifact: artifactId,
+        });
+        this.eventBus.emit('pattern.extracted', { patternId: pattern.id, artifactId });
+        logger.info({ patternId: pattern.id, artifactId }, 'Pattern extracted');
+        return pattern;
+    }
+    async extractFromSession(sessionId) {
+        const artifacts = await this.store.query({});
+        const sessionArtifacts = artifacts.filter(a => a.payload.sessionId === sessionId);
+        const patterns = [];
+        for (const a of sessionArtifacts.filter(a => a.status === 'DONE')) {
+            const p = await this.extractFromArtifact(a.id);
+            if (p)
+                patterns.push(p);
+        }
+        return patterns;
+    }
+    async validatePattern(pattern) {
+        const artifacts = await this.store.query({});
+        const similar = artifacts.filter(a => a.status === 'DONE' && a.type === pattern.contexts[0]);
+        pattern.successRate = similar.length > 0 ? similar.length / artifacts.length : 0;
+        pattern.verified = pattern.successRate >= 0.7;
+        if (pattern.verified) {
+            this.eventBus.emit('pattern.verified', { patternId: pattern.id, successRate: pattern.successRate });
+        }
+        return pattern.verified;
+    }
+    getPatterns() { return Array.from(this.patterns.values()); }
+    buildPattern(artifact, transitions) {
+        const steps = transitions.map((t, i) => ({
+            order: i + 1,
+            action: t.action,
+            expectedOutcome: 'Transition ' + t.from + ' to ' + t.to,
+            toolsUsed: [],
+        }));
+        return {
+            id: 'PATTERN-' + Date.now() + '-' + (++this.seq).toString().padStart(3, '0'),
+            name: artifact.type + ' Workflow',
+            description: 'Extracted from: ' + artifact.title,
+            contexts: [artifact.type],
+            steps,
+            successRate: 1.0,
+            extractedFrom: [artifact.id],
+            createdAt: Date.now(),
+            verified: false,
+        };
+    }
+}
+//# sourceMappingURL=PatternExtractor.js.map

package/dist/evolution/PatternExtractor.js.map

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

package/dist/evolution/RuleMaturity.d.ts

@@ -0,0 +1,39 @@
+export type RuleMaturityStage = 'shadow' | 'candidate-hook' | 'approved-blocking';
+export interface RuleMaturityRecord {
+    ruleId: string;
+    stage: RuleMaturityStage;
+    shadowHits: number;
+    defectEvidenceIds: string[];
+    falsePositiveCount: number;
+    rollback: string;
+    evidenceIds: string[];
+    approvedBy?: string;
+    approvedAt?: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface CreateShadowRuleMaturityInput {
+    ruleId: string;
+    rollback: string;
+    defectEvidenceIds?: string[];
+    now?: number;
+}
+export interface RecordShadowHitInput {
+    evidenceId?: string;
+    falsePositive?: boolean;
+    now?: number;
+}
+export interface RulePromotionThresholds {
+    minShadowHits?: number;
+    minDefectEvidence?: number;
+    maxFalsePositiveRate?: number;
+}
+export interface RulePromotionDecision {
+    eligible: boolean;
+    nextStage: RuleMaturityStage;
+    blockers: string[];
+}
+export declare function createShadowRuleMaturity(input: CreateShadowRuleMaturityInput): RuleMaturityRecord;
+export declare function recordShadowHit(record: RuleMaturityRecord, input?: RecordShadowHitInput): RuleMaturityRecord;
+export declare function evaluateRulePromotion(record: RuleMaturityRecord, thresholds?: RulePromotionThresholds): RulePromotionDecision;
+export declare function approveRuleMaturity(record: RuleMaturityRecord, approvedBy: string, now?: number): RuleMaturityRecord;

package/dist/evolution/RuleMaturity.js

@@ -0,0 +1,70 @@
+const DEFAULT_THRESHOLDS = {
+    minShadowHits: 10,
+    minDefectEvidence: 1,
+    maxFalsePositiveRate: 0.2,
+};
+export function createShadowRuleMaturity(input) {
+    const now = input.now ?? Date.now();
+    return {
+        ruleId: input.ruleId,
+        stage: 'shadow',
+        shadowHits: 0,
+        defectEvidenceIds: unique(input.defectEvidenceIds ?? []),
+        falsePositiveCount: 0,
+        rollback: input.rollback,
+        evidenceIds: [],
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function recordShadowHit(record, input = {}) {
+    return {
+        ...record,
+        shadowHits: record.shadowHits + 1,
+        falsePositiveCount: record.falsePositiveCount + (input.falsePositive ? 1 : 0),
+        evidenceIds: unique([
+            ...record.evidenceIds,
+            ...(input.evidenceId ? [input.evidenceId] : []),
+        ]),
+        updatedAt: input.now ?? Date.now(),
+    };
+}
+export function evaluateRulePromotion(record, thresholds = {}) {
+    const resolved = { ...DEFAULT_THRESHOLDS, ...thresholds };
+    const blockers = [];
+    if (record.shadowHits < resolved.minShadowHits) {
+        blockers.push(`shadow hits ${record.shadowHits}/${resolved.minShadowHits}`);
+    }
+    if (record.defectEvidenceIds.length < resolved.minDefectEvidence) {
+        blockers.push(`defect evidence ${record.defectEvidenceIds.length}/${resolved.minDefectEvidence}`);
+    }
+    if (!record.rollback.trim()) {
+        blockers.push('rollback method is required');
+    }
+    const falsePositiveRate = record.shadowHits === 0 ? 0 : record.falsePositiveCount / record.shadowHits;
+    if (falsePositiveRate > resolved.maxFalsePositiveRate) {
+        blockers.push(`false positive rate ${falsePositiveRate.toFixed(2)} exceeds ${resolved.maxFalsePositiveRate}`);
+    }
+    return {
+        eligible: blockers.length === 0,
+        nextStage: blockers.length === 0 ? 'candidate-hook' : record.stage,
+        blockers,
+    };
+}
+export function approveRuleMaturity(record, approvedBy, now = Date.now()) {
+    const decision = evaluateRulePromotion(record);
+    if (!decision.eligible) {
+        throw new Error(`Rule ${record.ruleId} is not eligible for blocking approval: ${decision.blockers.join('; ')}`);
+    }
+    return {
+        ...record,
+        stage: 'approved-blocking',
+        approvedBy,
+        approvedAt: now,
+        updatedAt: now,
+    };
+}
+function unique(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+//# sourceMappingURL=RuleMaturity.js.map

package/dist/evolution/RuleMaturity.js.map

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

package/dist/evolution/SessionLearnings.d.ts

@@ -0,0 +1,70 @@
+export type LearningCategory = 'failure' | 'pattern' | 'preference' | 'environment';
+export interface LearningEntry {
+    id: string;
+    ts: string;
+    projectSlug: string;
+    category: LearningCategory;
+    title: string;
+    detail: string;
+    evidenceIds: string[];
+    tags: string[];
+    relevanceDecay?: number;
+}
+export interface LearningSearchQuery {
+    tags?: string[];
+    category?: LearningCategory;
+    limit?: number;
+    projectSlug?: string;
+}
+export interface LearningStore {
+    append(entry: LearningEntry): void;
+    search(query: LearningSearchQuery): LearningEntry[];
+    prune(opts: {
+        olderThanDays?: number;
+        minRelevance?: number;
+    }): number;
+    count(): number;
+    exportJsonl(): string;
+}
+export declare function createLearningStore(opts: {
+    storePath?: string;
+}): LearningStore;
+interface RunReportForLearning {
+    status: string;
+    mode: string;
+    plan: {
+        task: string;
+        level?: string;
+        governance?: {
+            mode?: string;
+        };
+    };
+    failureLearning: {
+        status: string;
+        candidates: Array<{
+            id: string;
+            source: string;
+            title: string;
+            summary: string;
+            evidenceRefs: string[];
+            promotable: boolean;
+        }>;
+    };
+    verification: {
+        allPassed: boolean;
+        commands: Array<{
+            command: string;
+            status: string;
+            exitCode: number;
+        }>;
+    };
+}
+export declare function autoLearnFromRunReport(report: RunReportForLearning): LearningEntry[];
+export declare function loadRelevantLearnings(opts: {
+    projectDir?: string;
+    scaleDir?: string;
+    task?: string;
+    tags?: string[];
+    limit?: number;
+}): LearningEntry[];
+export {};