driftdetect-cortex 0.9.41

package/dist/orchestrators/learning-orchestrator.js

@@ -0,0 +1,346 @@
+/**
+ * Learning Orchestrator
+ *
+ * Orchestrates learning from feedback and corrections.
+ * Coordinates analysis, calibration, and memory creation.
+ *
+ * @module orchestrators/learning-orchestrator
+ */
+import { randomUUID } from 'crypto';
+/**
+ * Learning Orchestrator
+ *
+ * Coordinates the learning system components:
+ * - Correction analysis and categorization
+ * - Principle extraction
+ * - Confidence calibration
+ * - Memory creation
+ * - Causal inference
+ */
+export class LearningOrchestrator {
+    storage;
+    calibrator;
+    decayIntegrator;
+    activeLoop;
+    memoryFactory;
+    causalInference;
+    causalStorage;
+    constructor(storage, options) {
+        this.storage = storage;
+        this.calibrator = options?.calibrator ?? null;
+        this.decayIntegrator = options?.decayIntegrator ?? null;
+        this.activeLoop = options?.activeLoop ?? null;
+        this.memoryFactory = options?.memoryFactory ?? null;
+        this.causalInference = options?.causalInference ?? null;
+        this.causalStorage = options?.causalStorage ?? null;
+    }
+    /**
+     * Learn from a correction
+     */
+    async learnFromCorrection(original, feedback, correctedCode, context) {
+        // Step 1: Analyze the correction
+        const analysis = this.analyzeCorrection(original, feedback, correctedCode);
+        // Step 2: Create memories from the correction
+        const createdMemories = await this.createMemoriesFromCorrection(analysis, context);
+        // Step 3: Infer causal relationships
+        const causalEdges = await this.inferCausalRelationships(createdMemories, context?.relatedMemoryIds);
+        return {
+            success: true,
+            createdMemories,
+            principles: [analysis.principle],
+            category: analysis.category,
+            causalEdges,
+            analysis,
+        };
+    }
+    /**
+     * Process feedback on a memory
+     */
+    async processFeedback(memoryId, feedback, _details) {
+        // Get the memory
+        const memory = await this.storage.read(memoryId);
+        if (!memory) {
+            return {
+                success: false,
+                newConfidence: 0,
+                previousConfidence: 0,
+                memoryUpdated: false,
+            };
+        }
+        const previousConfidence = memory.confidence;
+        // Calculate new confidence based on feedback
+        let newConfidence;
+        if (this.calibrator) {
+            const metrics = {
+                baseConfidence: memory.confidence,
+                supportingEvidenceCount: memory.accessCount + 1,
+                contradictingEvidenceCount: feedback === 'rejected' ? 1 : 0,
+                successfulUses: feedback === 'confirmed' ? 1 : 0,
+                rejectedUses: feedback === 'rejected' ? 1 : 0,
+                ageInDays: this.calculateAgeInDays(memory.createdAt),
+                userConfirmations: feedback === 'confirmed' ? 1 : 0,
+                userRejections: feedback === 'rejected' ? 1 : 0,
+            };
+            const result = this.calibrator.calculate(metrics);
+            newConfidence = result.confidence;
+        }
+        else {
+            // Simple confidence adjustment
+            switch (feedback) {
+                case 'confirmed':
+                    newConfidence = Math.min(1.0, previousConfidence + 0.1);
+                    break;
+                case 'rejected':
+                    newConfidence = Math.max(0.1, previousConfidence - 0.2);
+                    break;
+                case 'modified':
+                    newConfidence = Math.max(0.3, previousConfidence - 0.1);
+                    break;
+                default:
+                    newConfidence = previousConfidence;
+            }
+        }
+        // Update the memory
+        await this.storage.update(memoryId, {
+            confidence: newConfidence,
+            lastAccessed: new Date().toISOString(),
+            accessCount: memory.accessCount + 1,
+        });
+        return {
+            success: true,
+            newConfidence,
+            previousConfidence,
+            memoryUpdated: true,
+        };
+    }
+    /**
+     * Get memories that need validation
+     */
+    async getValidationCandidates(limit = 10) {
+        if (this.activeLoop) {
+            return this.activeLoop.identifyValidationCandidates(limit);
+        }
+        // Fallback: find low-confidence memories
+        const allMemories = await this.storage.search({ limit: 100 });
+        const candidates = [];
+        for (const memory of allMemories) {
+            if (memory.confidence < 0.5) {
+                candidates.push({
+                    memoryId: memory.id,
+                    memoryType: memory.type,
+                    summary: memory.summary,
+                    currentConfidence: memory.confidence,
+                    reason: 'low_confidence',
+                    priority: 1 - memory.confidence,
+                    suggestedPrompt: `Is this still accurate? "${memory.summary}"`,
+                });
+            }
+        }
+        return candidates
+            .sort((a, b) => b.priority - a.priority)
+            .slice(0, limit);
+    }
+    /**
+     * Apply decay to all memories
+     */
+    async applyDecay() {
+        if (!this.decayIntegrator) {
+            return { updated: 0, decayed: 0 };
+        }
+        const allMemories = await this.storage.search({ limit: 1000 });
+        let updated = 0;
+        let decayed = 0;
+        for (const memory of allMemories) {
+            const newConfidence = this.decayIntegrator.calculateDecayedConfidence(memory);
+            if (newConfidence !== memory.confidence) {
+                await this.storage.update(memory.id, { confidence: newConfidence });
+                updated++;
+                if (newConfidence < memory.confidence) {
+                    decayed++;
+                }
+            }
+        }
+        return { updated, decayed };
+    }
+    // Private helper methods
+    analyzeCorrection(original, feedback, correctedCode) {
+        const category = this.inferCategory(feedback);
+        const principle = this.extractPrinciple(feedback, category);
+        const result = {
+            id: randomUUID(),
+            original,
+            feedback,
+            category,
+            categoryConfidence: 0.7,
+            principle,
+            suggestedMemoryType: this.categoryToMemoryType(category),
+            relatedMemories: [],
+            analyzedAt: new Date().toISOString(),
+        };
+        if (correctedCode !== undefined) {
+            result.correctedCode = correctedCode;
+        }
+        return result;
+    }
+    extractPrinciple(feedback, category) {
+        return {
+            statement: `Avoid: ${feedback.slice(0, 100)}`,
+            explanation: feedback,
+            scope: { projectWide: true },
+            confidence: 0.7,
+            keywords: this.extractKeywords(feedback),
+            isHardRule: category === 'security_issue',
+        };
+    }
+    extractKeywords(text) {
+        return text
+            .toLowerCase()
+            .split(/\s+/)
+            .filter(word => word.length > 3)
+            .slice(0, 5);
+    }
+    async createMemoriesFromCorrection(analysis, context) {
+        const createdIds = [];
+        if (this.memoryFactory) {
+            const memories = await this.memoryFactory.createFromCorrection(analysis);
+            for (const memory of memories) {
+                const id = await this.storage.create(memory);
+                createdIds.push(id);
+                // Link to file if provided
+                if (context?.activeFile) {
+                    await this.storage.linkToFile(id, context.activeFile);
+                }
+            }
+        }
+        else {
+            // Fallback: create a tribal memory
+            const memoryType = analysis.suggestedMemoryType;
+            const memory = {
+                type: memoryType,
+                summary: `Learned: ${analysis.feedback.slice(0, 100)}`,
+                confidence: analysis.categoryConfidence,
+                importance: this.categoryToImportance(analysis.category),
+                tags: [analysis.category, 'learned'],
+            };
+            const id = await this.storage.create(memory);
+            createdIds.push(id);
+            if (context?.activeFile) {
+                await this.storage.linkToFile(id, context.activeFile);
+            }
+        }
+        return createdIds;
+    }
+    async inferCausalRelationships(createdMemoryIds, relatedMemoryIds) {
+        if (!this.causalInference || !this.causalStorage) {
+            return [];
+        }
+        const edgeIds = [];
+        for (const memoryId of createdMemoryIds) {
+            const memory = await this.storage.read(memoryId);
+            if (!memory)
+                continue;
+            // Infer causes from related memories
+            if (relatedMemoryIds) {
+                for (const relatedId of relatedMemoryIds) {
+                    const edgeRequest = {
+                        sourceId: relatedId,
+                        targetId: memoryId,
+                        relation: 'triggered_by',
+                        strength: 0.7,
+                        evidence: [{
+                                type: 'explicit',
+                                description: 'Correction context',
+                                confidence: 0.7,
+                                gatheredAt: new Date().toISOString(),
+                            }],
+                        createdBy: 'learning_orchestrator',
+                    };
+                    const edgeId = await this.causalStorage.createEdge(edgeRequest);
+                    edgeIds.push(edgeId);
+                }
+            }
+            // Use inference engine for additional relationships
+            const inferenceResult = await this.causalInference.inferCauses(memory);
+            for (const edge of inferenceResult.inferredEdges) {
+                const edgeRequest = {
+                    sourceId: edge.sourceId,
+                    targetId: edge.targetId,
+                    relation: edge.relation,
+                    strength: edge.strength,
+                    evidence: edge.evidence,
+                    inferred: true,
+                    createdBy: 'causal_inference',
+                };
+                const edgeId = await this.causalStorage.createEdge(edgeRequest);
+                edgeIds.push(edgeId);
+            }
+        }
+        return edgeIds;
+    }
+    inferCategory(feedback) {
+        const lower = feedback.toLowerCase();
+        if (lower.includes('style') || lower.includes('format')) {
+            return 'style_preference';
+        }
+        if (lower.includes('pattern') || lower.includes('convention')) {
+            return 'pattern_violation';
+        }
+        if (lower.includes('security') || lower.includes('vulnerability')) {
+            return 'security_issue';
+        }
+        if (lower.includes('performance') || lower.includes('slow')) {
+            return 'performance_issue';
+        }
+        if (lower.includes('api') || lower.includes('deprecated')) {
+            return 'api_misuse';
+        }
+        if (lower.includes('naming') || lower.includes('name')) {
+            return 'naming_convention';
+        }
+        if (lower.includes('architecture') || lower.includes('structure')) {
+            return 'architecture_mismatch';
+        }
+        if (lower.includes('tribal') || lower.includes('team')) {
+            return 'tribal_miss';
+        }
+        if (lower.includes('constraint')) {
+            return 'constraint_violation';
+        }
+        return 'other';
+    }
+    categoryToMemoryType(category) {
+        switch (category) {
+            case 'pattern_violation':
+                return 'pattern_rationale';
+            case 'security_issue':
+            case 'performance_issue':
+            case 'api_misuse':
+                return 'code_smell';
+            case 'constraint_violation':
+                return 'constraint_override';
+            default:
+                return 'tribal';
+        }
+    }
+    categoryToImportance(category) {
+        switch (category) {
+            case 'security_issue':
+                return 'critical';
+            case 'pattern_violation':
+            case 'architecture_mismatch':
+                return 'high';
+            case 'performance_issue':
+            case 'api_misuse':
+                return 'normal';
+            default:
+                return 'low';
+        }
+    }
+    calculateAgeInDays(createdAt) {
+        const created = new Date(createdAt);
+        const now = new Date();
+        const diffMs = now.getTime() - created.getTime();
+        return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    }
+}
+//# sourceMappingURL=learning-orchestrator.js.map

package/dist/orchestrators/learning-orchestrator.js.map

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

package/dist/orchestrators/retrieval-orchestrator.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Retrieval Orchestrator
+ *
+ * Orchestrates memory retrieval with compression, session
+ * deduplication, and prediction caching.
+ *
+ * @module orchestrators/retrieval-orchestrator
+ */
+import type { IMemoryStorage } from '../storage/interface.js';
+import type { RetrievalContext } from '../retrieval/engine.js';
+import type { SessionContextManager } from '../session/context/manager.js';
+import type { PredictionCache } from '../prediction/cache/prediction-cache.js';
+import type { TokenBudgetManagerV2 } from '../compression/budget/manager-v2.js';
+import type { HierarchicalCompressorV2 } from '../compression/compressor/hierarchical.js';
+import type { CompressedMemory as CompressedMemoryV2 } from '../types/compressed-memory.js';
+/**
+ * Retrieval result memory with relevance info
+ */
+export interface RetrievalMemory {
+    /** The compressed memory */
+    compressed: CompressedMemoryV2;
+    /** Relevance score */
+    relevanceScore: number;
+    /** Why this memory is relevant */
+    relevanceReason: string;
+}
+/**
+ * Retrieval result with session tracking
+ */
+export interface RetrievalResultV2 {
+    /** Retrieved memories */
+    memories: RetrievalMemory[];
+    /** Total candidates considered */
+    totalCandidates: number;
+    /** Tokens used */
+    tokensUsed: number;
+    /** Retrieval time in ms */
+    retrievalTime: number;
+    /** Session tracking info */
+    session: {
+        /** Memories deduplicated from session */
+        deduplicatedCount: number;
+        /** Session ID */
+        sessionId: string;
+        /** Total tokens sent this session */
+        totalTokensSent: number;
+    };
+    /** Prediction info */
+    prediction: {
+        /** Whether predictions were used */
+        usedPredictions: boolean;
+        /** Prediction cache hit rate */
+        cacheHitRate: number;
+    };
+}
+/**
+ * Retrieval Orchestrator
+ *
+ * Coordinates retrieval, compression, session tracking,
+ * and prediction caching.
+ */
+export declare class RetrievalOrchestrator {
+    private storage;
+    private compressor;
+    private budgetManager;
+    private sessionManager;
+    private predictionCache;
+    constructor(storage: IMemoryStorage, options?: {
+        compressor?: HierarchicalCompressorV2;
+        budgetManager?: TokenBudgetManagerV2;
+        sessionManager?: SessionContextManager;
+        predictionCache?: PredictionCache;
+    });
+    /**
+     * Retrieve memories with full orchestration
+     */
+    retrieve(context: RetrievalContext): Promise<RetrievalResultV2>;
+    /**
+     * Get the budget manager (for external use)
+     */
+    getBudgetManager(): TokenBudgetManagerV2 | null;
+    /**
+     * Gather candidate memories
+     */
+    private gatherCandidates;
+    /**
+     * Score and rank candidates
+     */
+    private scoreAndRank;
+    /**
+     * Calculate relevance score for a memory
+     */
+    private calculateScore;
+    /**
+     * Get relevance reason for a memory
+     */
+    private getRelevanceReason;
+    /**
+     * Compress and fit memories to budget
+     */
+    private compressAndFit;
+    /**
+     * Deduplicate with session context
+     */
+    private deduplicateWithSession;
+    /**
+     * Get memory types relevant for an intent
+     */
+    private getTypesForIntent;
+    /**
+     * Estimate tokens for memories
+     */
+    private estimateTokens;
+    /**
+     * Estimate tokens for a single memory
+     */
+    private estimateMemoryTokens;
+    /**
+     * Calculate prediction statistics
+     */
+    private calculatePredictionStats;
+}
+//# sourceMappingURL=retrieval-orchestrator.d.ts.map

package/dist/orchestrators/retrieval-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrators/retrieval-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EAAU,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,KAAK,EAAE,gBAAgB,IAAI,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,OAAO,EAAE;QACP,yCAAyC;QACzC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,qCAAqC;QACrC,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,sBAAsB;IACtB,UAAU,EAAE;QACV,oCAAoC;QACpC,eAAe,EAAE,OAAO,CAAC;QACzB,gCAAgC;QAChC,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAWD;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAAyB;gBAG9C,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,wBAAwB,CAAC;QACtC,aAAa,CAAC,EAAE,oBAAoB,CAAC;QACrC,cAAc,CAAC,EAAE,qBAAqB,CAAC;QACvC,eAAe,CAAC,EAAE,eAAe,CAAC;KACnC;IASH;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+CrE;;OAEG;IACH,gBAAgB,IAAI,oBAAoB,GAAG,IAAI;IAI/C;;OAEG;YACW,gBAAgB;IAyD9B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;YACW,cAAc;IAyD5B;;OAEG;YACW,sBAAsB;IA2BpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAWjC"}