driftdetect-cortex 0.9.41

package/dist/causal/inference/engine.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Causal Inference Engine
+ *
+ * Orchestrates multiple inference strategies to automatically
+ * discover causal relationships between memories.
+ *
+ * @module causal/inference/engine
+ */
+import type { CausalEdge, CausalInferenceResult, CausalInferenceStrategy, CausalEvidence } from '../../types/causal.js';
+import type { Memory } from '../../types/memory.js';
+import type { ICausalStorage } from '../storage/interface.js';
+import type { IMemoryStorage } from '../../storage/interface.js';
+/**
+ * Inference engine configuration
+ */
+export interface InferenceEngineConfig {
+    /** Minimum confidence to create an edge */
+    minConfidence: number;
+    /** Maximum edges to infer per memory */
+    maxEdgesPerMemory: number;
+    /** Strategies to use */
+    strategies: CausalInferenceStrategy[];
+    /** Whether to validate inferences before storing */
+    validateBeforeStore: boolean;
+    /** Weight for each strategy */
+    strategyWeights: Partial<Record<CausalInferenceStrategy, number>>;
+}
+/**
+ * Inference strategy interface
+ */
+export interface IInferenceStrategy {
+    /** Strategy name */
+    readonly name: CausalInferenceStrategy;
+    /** Infer potential causal edges for a memory */
+    infer(memory: Memory, candidates: Memory[]): Promise<InferredEdge[]>;
+}
+/**
+ * An inferred edge before validation
+ */
+export interface InferredEdge {
+    sourceId: string;
+    targetId: string;
+    relation: CausalEdge['relation'];
+    confidence: number;
+    evidence: CausalEvidence;
+}
+/**
+ * Causal inference engine
+ *
+ * Coordinates multiple inference strategies to discover
+ * causal relationships between memories.
+ */
+export declare class CausalInferenceEngine {
+    private causalStorage;
+    private memoryStorage;
+    private config;
+    private strategies;
+    constructor(causalStorage: ICausalStorage, memoryStorage: IMemoryStorage, config?: Partial<InferenceEngineConfig>);
+    /**
+     * Infer causal relationships for a memory
+     *
+     * Analyzes the memory and finds potential causes
+     * (memories that may have led to this one).
+     */
+    inferCauses(memory: Memory): Promise<CausalInferenceResult>;
+    /**
+     * Infer causal relationships from a memory
+     *
+     * Analyzes the memory and finds potential effects
+     * (memories that may have been influenced by this one).
+     */
+    inferEffects(memory: Memory): Promise<CausalInferenceResult>;
+    /**
+     * Validate an existing edge
+     */
+    validateInference(edge: CausalEdge): Promise<boolean>;
+    /**
+     * Store inferred edges
+     */
+    storeInferences(result: CausalInferenceResult): Promise<string[]>;
+    private initializeStrategies;
+    private getCandidates;
+    private runStrategies;
+    private rankAndDeduplicate;
+    private validateInferences;
+    private createEdges;
+    private computeOverallConfidence;
+    private getUsedStrategies;
+    private createEmptyResult;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/causal/inference/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/causal/inference/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAMjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,UAAU,EAAE,uBAAuB,EAAE,CAAC;IACtC,oDAAoD;IACpD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,+BAA+B;IAC/B,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC,CAAC;CACnE;AAoBD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,gDAAgD;IAChD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB;IAK9B,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,aAAa;IALvB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,UAAU,CAAmD;gBAG3D,aAAa,EAAE,cAAc,EAC7B,aAAa,EAAE,cAAc,EACrC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IASzC;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAyCjE;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAyClE;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B3D;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoCvE,OAAO,CAAC,oBAAoB;YAed,aAAa;YAwBb,aAAa;IA8B3B,OAAO,CAAC,kBAAkB;YAiDZ,kBAAkB;YAuClB,WAAW;IAoBzB,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,iBAAiB;CAS1B"}

package/dist/causal/inference/engine.js

@@ -0,0 +1,329 @@
+/**
+ * Causal Inference Engine
+ *
+ * Orchestrates multiple inference strategies to automatically
+ * discover causal relationships between memories.
+ *
+ * @module causal/inference/engine
+ */
+import { TemporalInferenceStrategy } from './temporal.js';
+import { SemanticInferenceStrategy } from './semantic.js';
+import { EntityInferenceStrategy } from './entity.js';
+import { ExplicitInferenceStrategy } from './explicit.js';
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    minConfidence: 0.5,
+    maxEdgesPerMemory: 10,
+    strategies: ['temporal_proximity', 'semantic_similarity', 'entity_overlap', 'explicit_reference'],
+    validateBeforeStore: true,
+    strategyWeights: {
+        temporal_proximity: 0.2,
+        semantic_similarity: 0.3,
+        entity_overlap: 0.25,
+        explicit_reference: 0.4,
+        pattern_matching: 0.15,
+        file_co_occurrence: 0.1,
+    },
+};
+/**
+ * Causal inference engine
+ *
+ * Coordinates multiple inference strategies to discover
+ * causal relationships between memories.
+ */
+export class CausalInferenceEngine {
+    causalStorage;
+    memoryStorage;
+    config;
+    strategies;
+    constructor(causalStorage, memoryStorage, config) {
+        this.causalStorage = causalStorage;
+        this.memoryStorage = memoryStorage;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.strategies = new Map();
+        // Initialize strategies
+        this.initializeStrategies();
+    }
+    /**
+     * Infer causal relationships for a memory
+     *
+     * Analyzes the memory and finds potential causes
+     * (memories that may have led to this one).
+     */
+    async inferCauses(memory) {
+        const startTime = Date.now();
+        const warnings = [];
+        // Get candidate memories (created before this one)
+        const candidates = await this.getCandidates(memory, 'before');
+        if (candidates.length === 0) {
+            return this.createEmptyResult(memory.id, startTime);
+        }
+        // Run inference strategies
+        const allInferred = await this.runStrategies(memory, candidates, 'causes');
+        // Deduplicate and rank
+        const ranked = this.rankAndDeduplicate(allInferred);
+        // Filter by confidence
+        const filtered = ranked.filter(e => e.confidence >= this.config.minConfidence);
+        // Limit results
+        const limited = filtered.slice(0, this.config.maxEdgesPerMemory);
+        // Validate if configured
+        const validated = this.config.validateBeforeStore
+            ? await this.validateInferences(limited, warnings)
+            : limited;
+        // Convert to edges
+        const inferredEdges = await this.createEdges(validated);
+        return {
+            memoryId: memory.id,
+            inferredEdges,
+            confidence: this.computeOverallConfidence(inferredEdges),
+            strategiesUsed: this.getUsedStrategies(allInferred),
+            inferenceTimeMs: Date.now() - startTime,
+            warnings: warnings.length > 0 ? warnings : undefined,
+        };
+    }
+    /**
+     * Infer causal relationships from a memory
+     *
+     * Analyzes the memory and finds potential effects
+     * (memories that may have been influenced by this one).
+     */
+    async inferEffects(memory) {
+        const startTime = Date.now();
+        const warnings = [];
+        // Get candidate memories (created after this one)
+        const candidates = await this.getCandidates(memory, 'after');
+        if (candidates.length === 0) {
+            return this.createEmptyResult(memory.id, startTime);
+        }
+        // Run inference strategies
+        const allInferred = await this.runStrategies(memory, candidates, 'effects');
+        // Deduplicate and rank
+        const ranked = this.rankAndDeduplicate(allInferred);
+        // Filter by confidence
+        const filtered = ranked.filter(e => e.confidence >= this.config.minConfidence);
+        // Limit results
+        const limited = filtered.slice(0, this.config.maxEdgesPerMemory);
+        // Validate if configured
+        const validated = this.config.validateBeforeStore
+            ? await this.validateInferences(limited, warnings)
+            : limited;
+        // Convert to edges
+        const inferredEdges = await this.createEdges(validated);
+        return {
+            memoryId: memory.id,
+            inferredEdges,
+            confidence: this.computeOverallConfidence(inferredEdges),
+            strategiesUsed: this.getUsedStrategies(allInferred),
+            inferenceTimeMs: Date.now() - startTime,
+            warnings: warnings.length > 0 ? warnings : undefined,
+        };
+    }
+    /**
+     * Validate an existing edge
+     */
+    async validateInference(edge) {
+        // Check if both memories still exist
+        const source = await this.memoryStorage.read(edge.sourceId);
+        const target = await this.memoryStorage.read(edge.targetId);
+        if (!source || !target) {
+            return false;
+        }
+        // Check temporal ordering (source should be before target for most relations)
+        if (edge.relation !== 'contradicts' && edge.relation !== 'supports') {
+            const sourceTime = new Date(source.createdAt).getTime();
+            const targetTime = new Date(target.createdAt).getTime();
+            if (sourceTime > targetTime) {
+                return false;
+            }
+        }
+        // Check if edge strength is still reasonable
+        if (edge.strength < 0.1) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Store inferred edges
+     */
+    async storeInferences(result) {
+        const ids = [];
+        for (const edge of result.inferredEdges) {
+            // Check if edge already exists
+            const existing = await this.causalStorage.getEdgeBetween(edge.sourceId, edge.targetId, edge.relation);
+            if (existing) {
+                // Update strength if new inference is stronger
+                if (edge.strength > existing.strength) {
+                    await this.causalStorage.updateStrength(existing.id, edge.strength);
+                }
+                ids.push(existing.id);
+            }
+            else {
+                // Create new edge
+                const id = await this.causalStorage.createEdge({
+                    sourceId: edge.sourceId,
+                    targetId: edge.targetId,
+                    relation: edge.relation,
+                    strength: edge.strength,
+                    evidence: edge.evidence,
+                    inferred: true,
+                });
+                ids.push(id);
+            }
+        }
+        return ids;
+    }
+    // Private methods
+    initializeStrategies() {
+        if (this.config.strategies.includes('temporal_proximity')) {
+            this.strategies.set('temporal_proximity', new TemporalInferenceStrategy());
+        }
+        if (this.config.strategies.includes('semantic_similarity')) {
+            this.strategies.set('semantic_similarity', new SemanticInferenceStrategy());
+        }
+        if (this.config.strategies.includes('entity_overlap')) {
+            this.strategies.set('entity_overlap', new EntityInferenceStrategy());
+        }
+        if (this.config.strategies.includes('explicit_reference')) {
+            this.strategies.set('explicit_reference', new ExplicitInferenceStrategy());
+        }
+    }
+    async getCandidates(memory, direction) {
+        const memoryTime = memory.createdAt;
+        const query = {
+            limit: 100,
+            orderBy: 'createdAt',
+            orderDir: direction === 'before' ? 'desc' : 'asc',
+        };
+        if (direction === 'before') {
+            query.maxDate = memoryTime;
+        }
+        else {
+            query.minDate = memoryTime;
+        }
+        const candidates = await this.memoryStorage.search(query);
+        // Filter out the memory itself
+        return candidates.filter(c => c.id !== memory.id);
+    }
+    async runStrategies(memory, candidates, direction) {
+        const results = [];
+        for (const [strategyName, strategy] of this.strategies) {
+            try {
+                const inferred = await strategy.infer(memory, candidates);
+                for (const edge of inferred) {
+                    // Adjust source/target based on direction
+                    const adjustedEdge = direction === 'causes'
+                        ? edge // candidate -> memory
+                        : { ...edge, sourceId: memory.id, targetId: edge.sourceId }; // memory -> candidate
+                    results.push({
+                        ...adjustedEdge,
+                        strategy: strategyName,
+                    });
+                }
+            }
+            catch (err) {
+                console.warn(`Strategy ${strategyName} failed:`, err.message);
+            }
+        }
+        return results;
+    }
+    rankAndDeduplicate(inferred) {
+        // Group by source-target-relation
+        const groups = new Map();
+        for (const edge of inferred) {
+            const key = `${edge.sourceId}:${edge.targetId}:${edge.relation}`;
+            const group = groups.get(key) || [];
+            group.push(edge);
+            groups.set(key, group);
+        }
+        // Merge groups
+        const merged = [];
+        for (const group of groups.values()) {
+            if (group.length === 0)
+                continue;
+            // Combine confidences using weighted average
+            let totalWeight = 0;
+            let weightedConfidence = 0;
+            const evidences = [];
+            for (const edge of group) {
+                const weight = this.config.strategyWeights[edge.strategy] ?? 0.1;
+                totalWeight += weight;
+                weightedConfidence += edge.confidence * weight;
+                evidences.push(edge.evidence);
+            }
+            const first = group[0];
+            if (first) {
+                merged.push({
+                    sourceId: first.sourceId,
+                    targetId: first.targetId,
+                    relation: first.relation,
+                    confidence: totalWeight > 0 ? weightedConfidence / totalWeight : first.confidence,
+                    evidence: evidences[0] ?? first.evidence,
+                });
+            }
+        }
+        // Sort by confidence
+        merged.sort((a, b) => b.confidence - a.confidence);
+        return merged;
+    }
+    async validateInferences(inferred, warnings) {
+        const validated = [];
+        for (const edge of inferred) {
+            // Check if both memories exist
+            const source = await this.memoryStorage.read(edge.sourceId);
+            const target = await this.memoryStorage.read(edge.targetId);
+            if (!source) {
+                warnings.push(`Source memory not found: ${edge.sourceId}`);
+                continue;
+            }
+            if (!target) {
+                warnings.push(`Target memory not found: ${edge.targetId}`);
+                continue;
+            }
+            // Check for existing contradicting edge
+            const existing = await this.causalStorage.getEdgeBetween(edge.targetId, edge.sourceId, edge.relation);
+            if (existing && existing.strength > edge.confidence) {
+                warnings.push(`Contradicting edge exists with higher strength`);
+                continue;
+            }
+            validated.push(edge);
+        }
+        return validated;
+    }
+    async createEdges(inferred) {
+        const edges = [];
+        const now = new Date().toISOString();
+        for (const inf of inferred) {
+            edges.push({
+                id: '', // Will be assigned on storage
+                sourceId: inf.sourceId,
+                targetId: inf.targetId,
+                relation: inf.relation,
+                strength: inf.confidence,
+                evidence: [inf.evidence],
+                inferred: true,
+                createdAt: now,
+            });
+        }
+        return edges;
+    }
+    computeOverallConfidence(edges) {
+        if (edges.length === 0)
+            return 0;
+        return edges.reduce((sum, e) => sum + e.strength, 0) / edges.length;
+    }
+    getUsedStrategies(inferred) {
+        return [...new Set(inferred.map(e => e.strategy))];
+    }
+    createEmptyResult(memoryId, startTime) {
+        return {
+            memoryId,
+            inferredEdges: [],
+            confidence: 0,
+            strategiesUsed: [],
+            inferenceTimeMs: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/causal/inference/engine.js.map

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

package/dist/causal/inference/entity.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Entity Overlap Inference Strategy
+ *
+ * Infers causal relationships based on shared entities
+ * (files, functions, patterns, constraints). Memories
+ * linked to the same code entities are likely related.
+ *
+ * @module causal/inference/entity
+ */
+import type { Memory } from '../../types/memory.js';
+import type { IInferenceStrategy, InferredEdge } from './engine.js';
+/**
+ * Entity inference configuration
+ */
+export interface EntityInferenceConfig {
+    /** Minimum overlap ratio to consider */
+    minOverlapRatio: number;
+    /** Weight for file overlap */
+    fileWeight: number;
+    /** Weight for function overlap */
+    functionWeight: number;
+    /** Weight for pattern overlap */
+    patternWeight: number;
+    /** Weight for constraint overlap */
+    constraintWeight: number;
+}
+/**
+ * Entity overlap inference strategy
+ *
+ * Memories that reference the same code entities
+ * (files, functions, patterns) are likely causally related.
+ */
+export declare class EntityInferenceStrategy implements IInferenceStrategy {
+    readonly name: "entity_overlap";
+    private config;
+    constructor(config?: Partial<EntityInferenceConfig>);
+    /**
+     * Infer causal edges based on entity overlap
+     */
+    infer(memory: Memory, candidates: Memory[]): Promise<InferredEdge[]>;
+    /**
+     * Extract all entities from a memory
+     */
+    private extractEntities;
+    /**
+     * Count total entities
+     */
+    private countEntities;
+    /**
+     * Calculate overlap between two entity sets
+     */
+    private calculateOverlap;
+    /**
+     * Calculate overlap between two sets
+     */
+    private setOverlap;
+    /**
+     * Determine the causal relation type
+     */
+    private determineRelation;
+    /**
+     * Create evidence for the inference
+     */
+    private createEvidence;
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/causal/inference/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/causal/inference/entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAaD;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,kBAAkB;IAChE,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IAC1C,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAInD;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqC1E;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyCxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;OAEG;IACH,OAAO,CAAC,cAAc;CA8BvB"}