driftdetect-cortex 0.9.41

package/dist/orchestrators/cortex-v2.js

@@ -0,0 +1,395 @@
+/**
+ * Cortex V2 - Main Orchestrator
+ *
+ * Top-level orchestrator that coordinates all Cortex v2 subsystems:
+ * - Retrieval with compression and session tracking
+ * - Learning from feedback and corrections
+ * - Generation context building
+ * - Prediction and caching
+ * - Health monitoring
+ *
+ * @module orchestrators/cortex-v2
+ */
+import { RetrievalOrchestrator } from './retrieval-orchestrator.js';
+import { LearningOrchestrator } from './learning-orchestrator.js';
+import { GenerationOrchestrator } from './generation-orchestrator.js';
+/**
+ * Cortex V2 - Main Entry Point
+ *
+ * Coordinates all Cortex v2 subsystems for a unified API.
+ */
+export class CortexV2 {
+    storage;
+    causalStorage;
+    sessionManager;
+    predictionCache;
+    budgetManager;
+    compressor;
+    causalInference;
+    causalTraverser;
+    narrativeGenerator;
+    retrievalOrchestrator;
+    learningOrchestrator;
+    generationOrchestrator;
+    constructor(storage, options) {
+        this.storage = storage;
+        this.causalStorage = options?.causalStorage ?? null;
+        this.sessionManager = options?.sessionManager ?? null;
+        this.predictionCache = options?.predictionCache ?? null;
+        this.budgetManager = options?.budgetManager ?? null;
+        this.compressor = options?.compressor ?? null;
+        this.causalInference = options?.causalInference ?? null;
+        this.causalTraverser = options?.causalTraverser ?? null;
+        this.narrativeGenerator = options?.narrativeGenerator ?? null;
+        // Initialize sub-orchestrators
+        if (options?.retrievalOrchestrator) {
+            this.retrievalOrchestrator = options.retrievalOrchestrator;
+        }
+        else {
+            const retrievalOpts = {};
+            if (this.compressor)
+                retrievalOpts.compressor = this.compressor;
+            if (this.budgetManager)
+                retrievalOpts.budgetManager = this.budgetManager;
+            if (this.sessionManager)
+                retrievalOpts.sessionManager = this.sessionManager;
+            if (this.predictionCache)
+                retrievalOpts.predictionCache = this.predictionCache;
+            this.retrievalOrchestrator = new RetrievalOrchestrator(storage, retrievalOpts);
+        }
+        if (options?.learningOrchestrator) {
+            this.learningOrchestrator = options.learningOrchestrator;
+        }
+        else {
+            const learningOpts = {};
+            if (this.causalInference)
+                learningOpts.causalInference = this.causalInference;
+            if (this.causalStorage)
+                learningOpts.causalStorage = this.causalStorage;
+            this.learningOrchestrator = new LearningOrchestrator(storage, learningOpts);
+        }
+        if (options?.generationOrchestrator) {
+            this.generationOrchestrator = options.generationOrchestrator;
+        }
+        else {
+            const generationOpts = {};
+            if (this.budgetManager)
+                generationOpts.budgetManager = this.budgetManager;
+            if (this.sessionManager)
+                generationOpts.sessionManager = this.sessionManager;
+            this.generationOrchestrator = new GenerationOrchestrator(storage, generationOpts);
+        }
+    }
+    // ==================== RETRIEVAL ====================
+    /**
+     * Get context for a given intent and focus
+     */
+    async getContext(intent, focus, options) {
+        const context = {
+            intent,
+            focus,
+            activeFile: focus,
+            maxTokens: options?.maxTokens ?? 2000,
+        };
+        const result = await this.retrievalOrchestrator.retrieve(context);
+        return {
+            memories: result.memories,
+            tokensUsed: result.tokensUsed,
+            session: result.session,
+            retrievalTimeMs: result.retrievalTime,
+        };
+    }
+    /**
+     * Get causal "why" narrative for a focus area
+     */
+    async getWhy(_intent, focus) {
+        if (!this.causalTraverser || !this.narrativeGenerator) {
+            return {
+                narrative: 'Causal analysis not available',
+                causalChain: [],
+                sources: [],
+                confidence: 0,
+            };
+        }
+        // Find relevant memories
+        const memories = await this.storage.findByFile(focus);
+        if (memories.length === 0) {
+            return {
+                narrative: `No memories found for ${focus}`,
+                causalChain: [],
+                sources: [],
+                confidence: 0,
+            };
+        }
+        // Get causal chain for the first relevant memory
+        const rootMemory = memories[0];
+        if (!rootMemory) {
+            return {
+                narrative: `No memories found for ${focus}`,
+                causalChain: [],
+                sources: [],
+                confidence: 0,
+            };
+        }
+        const chain = await this.causalTraverser.traceOrigins(rootMemory.id, { maxDepth: 5 });
+        // Generate narrative
+        const narrative = this.narrativeGenerator.generateNarrative(chain);
+        return {
+            narrative: narrative.text,
+            causalChain: chain.nodes.map((node) => ({
+                node,
+                relationship: 'caused_by',
+                confidence: chain.chainConfidence,
+            })),
+            sources: chain.nodes.map((n) => n.memoryId),
+            confidence: narrative.confidence,
+        };
+    }
+    // ==================== LEARNING ====================
+    /**
+     * Learn from a correction
+     */
+    async learn(original, feedback, correctedCode, context) {
+        return this.learningOrchestrator.learnFromCorrection(original, feedback, correctedCode, context);
+    }
+    /**
+     * Process feedback on a memory
+     */
+    async processFeedback(memoryId, feedback, details) {
+        return this.learningOrchestrator.processFeedback(memoryId, feedback, details);
+    }
+    /**
+     * Get memories that need validation
+     */
+    async getValidationCandidates(limit = 10) {
+        const candidates = await this.learningOrchestrator.getValidationCandidates(limit);
+        return candidates.map(c => ({
+            memoryId: c.memoryId,
+            reason: c.reason,
+            priority: c.priority,
+            suggestedPrompt: c.suggestedPrompt,
+        }));
+    }
+    // ==================== GENERATION ====================
+    /**
+     * Build generation context
+     */
+    async buildGenerationContext(intent, target, query, options) {
+        const result = await this.generationOrchestrator.buildContext(intent, target, query, options);
+        return result.context;
+    }
+    /**
+     * Track generation outcome
+     */
+    async trackGenerationOutcome(generation, outcome, feedback) {
+        return this.generationOrchestrator.trackOutcome(generation, outcome, feedback);
+    }
+    // ==================== PREDICTION ====================
+    /**
+     * Get predicted memories for a file
+     */
+    async predict(activeFile) {
+        if (!this.predictionCache) {
+            return [];
+        }
+        const cached = await this.predictionCache.getForFile(activeFile);
+        return cached ?? [];
+    }
+    // ==================== HEALTH ====================
+    /**
+     * Get comprehensive health report
+     */
+    async getHealth() {
+        // Get all memories using search
+        const memories = await this.storage.search({ limit: 1000 });
+        // Calculate memory stats
+        const byType = {};
+        let confidenceSum = 0;
+        let lowConfidenceCount = 0;
+        for (const memory of memories) {
+            byType[memory.type] = (byType[memory.type] ?? 0) + 1;
+            confidenceSum += memory.confidence;
+            if (memory.confidence < 0.5) {
+                lowConfidenceCount++;
+            }
+        }
+        const avgConfidence = memories.length > 0 ? confidenceSum / memories.length : 0;
+        // Get session stats
+        const activeSession = await this.sessionManager?.getActiveSession();
+        const sessionStats = {
+            activeSessions: activeSession ? 1 : 0,
+            totalTokensSent: activeSession?.tokensSent ?? 0,
+        };
+        // Get prediction stats
+        const predictionStats = this.predictionCache?.getStats();
+        const cacheHitRate = predictionStats?.hitRate ?? 0;
+        // Identify issues
+        const issues = [];
+        const recommendations = [];
+        if (avgConfidence < 0.5) {
+            issues.push({
+                severity: 'high',
+                message: 'Average memory confidence is low',
+                recommendation: 'Run validation to confirm or remove low-confidence memories',
+            });
+            recommendations.push('Consider running drift_memory_validate to clean up low-confidence memories');
+        }
+        if (lowConfidenceCount > memories.length * 0.3) {
+            issues.push({
+                severity: 'medium',
+                message: `${lowConfidenceCount} memories have low confidence`,
+                recommendation: 'Review and validate these memories',
+            });
+        }
+        if (memories.length > 500) {
+            recommendations.push('Consider running consolidation to merge similar memories');
+        }
+        // Calculate overall score
+        let overallScore = 100;
+        for (const issue of issues) {
+            switch (issue.severity) {
+                case 'critical':
+                    overallScore -= 30;
+                    break;
+                case 'high':
+                    overallScore -= 20;
+                    break;
+                case 'medium':
+                    overallScore -= 10;
+                    break;
+                case 'low':
+                    overallScore -= 5;
+                    break;
+            }
+        }
+        return {
+            overallScore: Math.max(0, overallScore),
+            memoryStats: {
+                total: memories.length,
+                byType,
+                avgConfidence,
+                lowConfidenceCount,
+            },
+            sessionStats,
+            predictionStats: {
+                cacheHitRate,
+                totalPredictions: 0,
+            },
+            issues,
+            recommendations,
+        };
+    }
+    /**
+     * Consolidate memories
+     */
+    async consolidate(options) {
+        const minConfidence = options?.minConfidence ?? 0.2;
+        const maxAgeDays = options?.maxAgeDays ?? 365;
+        const memories = await this.storage.search({ limit: 1000 });
+        let removed = 0;
+        let merged = 0;
+        let updated = 0;
+        let spaceSaved = 0;
+        const now = new Date();
+        for (const memory of memories) {
+            // Remove low confidence memories
+            if (memory.confidence < minConfidence) {
+                await this.storage.delete(memory.id);
+                removed++;
+                spaceSaved += this.estimateTokens(memory);
+                continue;
+            }
+            // Remove old memories
+            const createdAt = new Date(memory.createdAt);
+            const ageInDays = (now.getTime() - createdAt.getTime()) / (1000 * 60 * 60 * 24);
+            if (ageInDays > maxAgeDays && memory.accessCount < 5) {
+                await this.storage.delete(memory.id);
+                removed++;
+                spaceSaved += this.estimateTokens(memory);
+                continue;
+            }
+        }
+        return {
+            removed,
+            merged,
+            updated,
+            spaceSaved,
+        };
+    }
+    /**
+     * Validate memories
+     */
+    async validate(options) {
+        const memories = await this.storage.search({ limit: 1000 });
+        const issues = [];
+        let totalValidated = 0;
+        for (const memory of memories) {
+            // Skip if type filter is set and doesn't match
+            if (options?.types && !options.types.includes(memory.type)) {
+                continue;
+            }
+            totalValidated++;
+            // Check for missing required fields
+            if (!memory.summary || memory.summary.trim() === '') {
+                const fixed = options?.autoFix ?? false;
+                if (fixed) {
+                    await this.storage.update(memory.id, { summary: `Memory ${memory.id}` });
+                }
+                issues.push({
+                    memoryId: memory.id,
+                    issue: 'Missing summary',
+                    fixed,
+                });
+            }
+            // Check for invalid confidence
+            if (memory.confidence < 0 || memory.confidence > 1) {
+                const fixed = options?.autoFix ?? false;
+                if (fixed) {
+                    await this.storage.update(memory.id, {
+                        confidence: Math.max(0, Math.min(1, memory.confidence)),
+                    });
+                }
+                issues.push({
+                    memoryId: memory.id,
+                    issue: 'Invalid confidence value',
+                    fixed,
+                });
+            }
+        }
+        return {
+            valid: issues.length === 0,
+            issues,
+            totalValidated,
+        };
+    }
+    // ==================== UTILITIES ====================
+    /**
+     * Get the underlying storage
+     */
+    getStorage() {
+        return this.storage;
+    }
+    /**
+     * Get the retrieval orchestrator
+     */
+    getRetrievalOrchestrator() {
+        return this.retrievalOrchestrator;
+    }
+    /**
+     * Get the learning orchestrator
+     */
+    getLearningOrchestrator() {
+        return this.learningOrchestrator;
+    }
+    /**
+     * Get the generation orchestrator
+     */
+    getGenerationOrchestrator() {
+        return this.generationOrchestrator;
+    }
+    estimateTokens(memory) {
+        const json = JSON.stringify(memory);
+        return Math.ceil(json.length / 4);
+    }
+}
+//# sourceMappingURL=cortex-v2.js.map

package/dist/orchestrators/cortex-v2.js.map

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

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

@@ -0,0 +1,108 @@
+/**
+ * Generation Orchestrator
+ *
+ * Orchestrates code generation context building,
+ * validation, and feedback processing.
+ *
+ * @module orchestrators/generation-orchestrator
+ */
+import type { IMemoryStorage } from '../storage/interface.js';
+import type { Intent } from '../retrieval/engine.js';
+import type { GenerationContext, GenerationTarget, GeneratedCode, GenerationOutcome } from '../types/generation-context.js';
+import type { PatternContextGatherer } from '../generation/context/pattern-gatherer.js';
+import type { TribalContextGatherer } from '../generation/context/tribal-gatherer.js';
+import type { ConstraintContextGatherer } from '../generation/context/constraint-gatherer.js';
+import type { AntiPatternGatherer } from '../generation/context/antipattern-gatherer.js';
+import type { GeneratedCodeValidator, ValidationResult } from '../generation/validation/validator.js';
+import type { ProvenanceTracker } from '../generation/provenance/tracker.js';
+import type { GenerationFeedbackLoop } from '../generation/feedback/loop.js';
+import type { TokenBudgetManagerV2 } from '../compression/budget/manager-v2.js';
+import type { SessionContextManager } from '../session/context/manager.js';
+/**
+ * Context build result
+ */
+export interface ContextBuildResult {
+    /** The generation context */
+    context: GenerationContext;
+    /** Build time in ms */
+    buildTimeMs: number;
+    /** Memories considered */
+    memoriesConsidered: number;
+    /** Memories included */
+    memoriesIncluded: number;
+}
+/**
+ * Outcome tracking result
+ */
+export interface OutcomeTrackResult {
+    /** Whether tracking was successful */
+    success: boolean;
+    /** Memories updated */
+    memoriesUpdated: number;
+    /** Learning triggered */
+    learningTriggered: boolean;
+}
+/**
+ * Generation Orchestrator
+ *
+ * Coordinates context building, validation, and feedback
+ * for code generation.
+ */
+export declare class GenerationOrchestrator {
+    private storage;
+    private patternGatherer;
+    private tribalGatherer;
+    private constraintGatherer;
+    private antiPatternGatherer;
+    private validator;
+    private feedbackLoop;
+    private sessionManager;
+    constructor(storage: IMemoryStorage, options?: {
+        patternGatherer?: PatternContextGatherer;
+        tribalGatherer?: TribalContextGatherer;
+        constraintGatherer?: ConstraintContextGatherer;
+        antiPatternGatherer?: AntiPatternGatherer;
+        validator?: GeneratedCodeValidator;
+        feedbackLoop?: GenerationFeedbackLoop;
+        budgetManager?: TokenBudgetManagerV2;
+        sessionManager?: SessionContextManager;
+    });
+    /**
+     * Build generation context
+     */
+    buildContext(intent: Intent, target: GenerationTarget, query: string, options?: {
+        maxTokens?: number;
+        includeExamples?: boolean;
+    }): Promise<ContextBuildResult>;
+    /**
+     * Validate generated code against context
+     */
+    validateGenerated(code: string, context: GenerationContext): Promise<ValidationResult>;
+    /**
+     * Track generation outcome
+     */
+    trackOutcome(generation: GeneratedCode, outcome: GenerationOutcome, feedback?: string): Promise<OutcomeTrackResult>;
+    /**
+     * Create provenance tracker for a generation
+     */
+    createProvenanceTracker(context: GenerationContext): ProvenanceTracker;
+    /**
+     * Get feedback statistics
+     */
+    getFeedbackStats(): {
+        acceptanceRate: number;
+        total: number;
+    } | null;
+    private allocateBudget;
+    private gatherPatterns;
+    private gatherTribal;
+    private gatherConstraints;
+    private gatherAntiPatterns;
+    private gatherRelated;
+    private estimateTokens;
+    private trimToBudget;
+    private calculateTokenBudget;
+    private intentToGenerationIntent;
+    private getConfidenceAdjustment;
+}
+//# sourceMappingURL=generation-orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generation-orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrators/generation-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EASlB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACtG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,cAAc,CAA+B;gBAGnD,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,sBAAsB,CAAC;QACzC,cAAc,CAAC,EAAE,qBAAqB,CAAC;QACvC,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;QAC/C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;QAC1C,SAAS,CAAC,EAAE,sBAAsB,CAAC;QACnC,YAAY,CAAC,EAAE,sBAAsB,CAAC;QACtC,aAAa,CAAC,EAAE,oBAAoB,CAAC;QACrC,cAAc,CAAC,EAAE,qBAAqB,CAAC;KACxC;IAYH;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,GACA,OAAO,CAAC,kBAAkB,CAAC;IAoF9B;;OAEG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC;IAiB5B;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC;IAoC9B;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB;IAStE;;OAEG;IACH,gBAAgB,IAAI;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAcpE,OAAO,CAAC,cAAc;YAiBR,cAAc;YAqBd,YAAY;YAqBZ,iBAAiB;YAoBjB,kBAAkB;YAqBlB,aAAa;IA6B3B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,wBAAwB;IAmBhC,OAAO,CAAC,uBAAuB;CAIhC"}