driftdetect-cortex 0.9.41

package/dist/causal/inference/semantic.js

@@ -0,0 +1,213 @@
+/**
+ * Semantic Similarity Inference Strategy
+ *
+ * Infers causal relationships based on semantic similarity
+ * of memory content. Memories with similar topics, knowledge,
+ * or context are more likely to be related.
+ *
+ * @module causal/inference/semantic
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    minSimilarity: 0.3,
+    topicWeight: 0.4,
+    tagWeight: 0.3,
+    entityWeight: 0.3,
+};
+/**
+ * Semantic similarity inference strategy
+ *
+ * Uses text similarity and shared attributes to infer
+ * causal relationships.
+ */
+export class SemanticInferenceStrategy {
+    name = 'semantic_similarity';
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Infer causal edges based on semantic similarity
+     */
+    async infer(memory, candidates) {
+        const edges = [];
+        for (const candidate of candidates) {
+            const similarity = this.calculateSimilarity(memory, candidate);
+            if (similarity < this.config.minSimilarity) {
+                continue;
+            }
+            const relation = this.determineRelation(memory, candidate, similarity);
+            edges.push({
+                sourceId: candidate.id,
+                targetId: memory.id,
+                relation,
+                confidence: similarity,
+                evidence: this.createEvidence(memory, candidate, similarity),
+            });
+        }
+        return edges;
+    }
+    /**
+     * Calculate semantic similarity between two memories
+     */
+    calculateSimilarity(memory, candidate) {
+        let totalScore = 0;
+        let totalWeight = 0;
+        // Topic similarity (for memories with topics)
+        const topicSimilarity = this.calculateTopicSimilarity(memory, candidate);
+        if (topicSimilarity !== null) {
+            totalScore += topicSimilarity * this.config.topicWeight;
+            totalWeight += this.config.topicWeight;
+        }
+        // Tag overlap
+        const tagSimilarity = this.calculateTagSimilarity(memory, candidate);
+        totalScore += tagSimilarity * this.config.tagWeight;
+        totalWeight += this.config.tagWeight;
+        // Linked entity overlap
+        const entitySimilarity = this.calculateEntitySimilarity(memory, candidate);
+        totalScore += entitySimilarity * this.config.entityWeight;
+        totalWeight += this.config.entityWeight;
+        return totalWeight > 0 ? totalScore / totalWeight : 0;
+    }
+    /**
+     * Calculate topic similarity
+     */
+    calculateTopicSimilarity(memory, candidate) {
+        const memoryTopic = this.extractTopic(memory);
+        const candidateTopic = this.extractTopic(candidate);
+        if (!memoryTopic || !candidateTopic) {
+            return null;
+        }
+        // Exact match
+        if (memoryTopic.toLowerCase() === candidateTopic.toLowerCase()) {
+            return 1.0;
+        }
+        // Partial match (one contains the other)
+        const memLower = memoryTopic.toLowerCase();
+        const candLower = candidateTopic.toLowerCase();
+        if (memLower.includes(candLower) || candLower.includes(memLower)) {
+            return 0.7;
+        }
+        // Word overlap
+        const memWords = new Set(memLower.split(/\s+/));
+        const candWords = new Set(candLower.split(/\s+/));
+        const intersection = [...memWords].filter(w => candWords.has(w));
+        if (intersection.length > 0) {
+            return intersection.length / Math.max(memWords.size, candWords.size);
+        }
+        return 0;
+    }
+    /**
+     * Calculate tag similarity using Jaccard index
+     */
+    calculateTagSimilarity(memory, candidate) {
+        const memoryTags = new Set(memory.tags || []);
+        const candidateTags = new Set(candidate.tags || []);
+        if (memoryTags.size === 0 && candidateTags.size === 0) {
+            return 0;
+        }
+        const intersection = [...memoryTags].filter(t => candidateTags.has(t));
+        const union = new Set([...memoryTags, ...candidateTags]);
+        return intersection.length / union.size;
+    }
+    /**
+     * Calculate linked entity similarity
+     */
+    calculateEntitySimilarity(memory, candidate) {
+        const memoryEntities = this.extractLinkedEntities(memory);
+        const candidateEntities = this.extractLinkedEntities(candidate);
+        if (memoryEntities.size === 0 && candidateEntities.size === 0) {
+            return 0;
+        }
+        const intersection = [...memoryEntities].filter(e => candidateEntities.has(e));
+        const union = new Set([...memoryEntities, ...candidateEntities]);
+        return intersection.length / union.size;
+    }
+    /**
+     * Extract topic from memory
+     */
+    extractTopic(memory) {
+        // Type-specific topic extraction
+        if ('topic' in memory && typeof memory.topic === 'string') {
+            return memory.topic;
+        }
+        if ('patternName' in memory && typeof memory.patternName === 'string') {
+            return memory.patternName;
+        }
+        if ('constraintName' in memory && typeof memory.constraintName === 'string') {
+            return memory.constraintName;
+        }
+        if ('name' in memory && typeof memory.name === 'string') {
+            return memory.name;
+        }
+        return null;
+    }
+    /**
+     * Extract all linked entities from a memory
+     */
+    extractLinkedEntities(memory) {
+        const entities = new Set();
+        if (memory.linkedPatterns) {
+            memory.linkedPatterns.forEach(p => entities.add(`pattern:${p}`));
+        }
+        if (memory.linkedConstraints) {
+            memory.linkedConstraints.forEach(c => entities.add(`constraint:${c}`));
+        }
+        if (memory.linkedFiles) {
+            memory.linkedFiles.forEach(f => entities.add(`file:${f}`));
+        }
+        if (memory.linkedFunctions) {
+            memory.linkedFunctions.forEach(f => entities.add(`function:${f}`));
+        }
+        return entities;
+    }
+    /**
+     * Determine the causal relation type
+     */
+    determineRelation(memory, candidate, similarity) {
+        // High similarity suggests derivation or support
+        if (similarity > 0.8) {
+            return 'derived_from';
+        }
+        // Same type often means support
+        if (memory.type === candidate.type) {
+            return 'supports';
+        }
+        // Different types with moderate similarity
+        if (candidate.type === 'tribal' || candidate.type === 'semantic') {
+            return 'enabled';
+        }
+        return 'supports';
+    }
+    /**
+     * Create evidence for the inference
+     */
+    createEvidence(memory, candidate, similarity) {
+        const reasons = [];
+        // Check what contributed to similarity
+        const topicSim = this.calculateTopicSimilarity(memory, candidate);
+        if (topicSim && topicSim > 0.5) {
+            reasons.push('similar topics');
+        }
+        const tagSim = this.calculateTagSimilarity(memory, candidate);
+        if (tagSim > 0.3) {
+            reasons.push('shared tags');
+        }
+        const entitySim = this.calculateEntitySimilarity(memory, candidate);
+        if (entitySim > 0.3) {
+            reasons.push('linked to same entities');
+        }
+        const description = reasons.length > 0
+            ? `Semantic similarity (${Math.round(similarity * 100)}%): ${reasons.join(', ')}`
+            : `Semantic similarity: ${Math.round(similarity * 100)}%`;
+        return {
+            type: 'semantic',
+            description,
+            confidence: similarity,
+            gatheredAt: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=semantic.js.map

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

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

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

@@ -0,0 +1,50 @@
+/**
+ * Temporal Proximity Inference Strategy
+ *
+ * Infers causal relationships based on temporal proximity.
+ * Memories created close together in time are more likely
+ * to be causally related.
+ *
+ * @module causal/inference/temporal
+ */
+import type { Memory } from '../../types/memory.js';
+import type { IInferenceStrategy, InferredEdge } from './engine.js';
+/**
+ * Temporal inference configuration
+ */
+export interface TemporalInferenceConfig {
+    /** Maximum time difference in milliseconds */
+    maxTimeDifferenceMs: number;
+    /** Time window for high confidence (ms) */
+    highConfidenceWindowMs: number;
+    /** Base confidence for temporal proximity */
+    baseConfidence: number;
+}
+/**
+ * Temporal proximity inference strategy
+ *
+ * Infers that memories created close together in time
+ * may have a causal relationship.
+ */
+export declare class TemporalInferenceStrategy implements IInferenceStrategy {
+    readonly name: "temporal_proximity";
+    private config;
+    constructor(config?: Partial<TemporalInferenceConfig>);
+    /**
+     * Infer causal edges based on temporal proximity
+     */
+    infer(memory: Memory, candidates: Memory[]): Promise<InferredEdge[]>;
+    /**
+     * Calculate confidence based on time difference
+     */
+    private calculateConfidence;
+    /**
+     * Determine the causal relation type
+     */
+    private determineRelation;
+    /**
+     * Create evidence for the inference
+     */
+    private createEvidence;
+}
+//# sourceMappingURL=temporal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../../src/causal/inference/temporal.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,uBAAuB;IACtC,8CAA8C;IAC9C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;CACxB;AAWD;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;IAC9C,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAIrD;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmC1E;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAevB"}

package/dist/causal/inference/temporal.js

@@ -0,0 +1,104 @@
+/**
+ * Temporal Proximity Inference Strategy
+ *
+ * Infers causal relationships based on temporal proximity.
+ * Memories created close together in time are more likely
+ * to be causally related.
+ *
+ * @module causal/inference/temporal
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    maxTimeDifferenceMs: 24 * 60 * 60 * 1000, // 24 hours
+    highConfidenceWindowMs: 60 * 60 * 1000, // 1 hour
+    baseConfidence: 0.4,
+};
+/**
+ * Temporal proximity inference strategy
+ *
+ * Infers that memories created close together in time
+ * may have a causal relationship.
+ */
+export class TemporalInferenceStrategy {
+    name = 'temporal_proximity';
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Infer causal edges based on temporal proximity
+     */
+    async infer(memory, candidates) {
+        const edges = [];
+        const memoryTime = new Date(memory.createdAt).getTime();
+        for (const candidate of candidates) {
+            const candidateTime = new Date(candidate.createdAt).getTime();
+            const timeDiff = Math.abs(memoryTime - candidateTime);
+            // Skip if too far apart
+            if (timeDiff > this.config.maxTimeDifferenceMs) {
+                continue;
+            }
+            // Calculate confidence based on time proximity
+            const confidence = this.calculateConfidence(timeDiff);
+            if (confidence < 0.2) {
+                continue;
+            }
+            // Determine relation based on temporal order and types
+            const relation = this.determineRelation(memory, candidate, candidateTime < memoryTime);
+            edges.push({
+                sourceId: candidate.id,
+                targetId: memory.id,
+                relation,
+                confidence,
+                evidence: this.createEvidence(timeDiff, confidence),
+            });
+        }
+        return edges;
+    }
+    /**
+     * Calculate confidence based on time difference
+     */
+    calculateConfidence(timeDiffMs) {
+        // Exponential decay based on time difference
+        const decayFactor = Math.exp(-timeDiffMs / this.config.highConfidenceWindowMs);
+        return this.config.baseConfidence * decayFactor;
+    }
+    /**
+     * Determine the causal relation type
+     */
+    determineRelation(memory, candidate, candidateIsBefore) {
+        // If same type, likely derived_from or supports
+        if (memory.type === candidate.type) {
+            return candidateIsBefore ? 'derived_from' : 'supports';
+        }
+        // Episodic memories often trigger other memories
+        if (candidate.type === 'episodic') {
+            return 'triggered_by';
+        }
+        // Pattern rationale often enables other decisions
+        if (candidate.type === 'pattern_rationale') {
+            return 'enabled';
+        }
+        // Default to general causation
+        return candidateIsBefore ? 'caused' : 'supports';
+    }
+    /**
+     * Create evidence for the inference
+     */
+    createEvidence(timeDiffMs, confidence) {
+        const timeDiffHours = Math.round(timeDiffMs / (60 * 60 * 1000) * 10) / 10;
+        const timeDiffMinutes = Math.round(timeDiffMs / (60 * 1000));
+        const timeDescription = timeDiffHours >= 1
+            ? `${timeDiffHours} hours`
+            : `${timeDiffMinutes} minutes`;
+        return {
+            type: 'temporal',
+            description: `Created within ${timeDescription} of each other`,
+            confidence,
+            gatheredAt: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=temporal.js.map

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

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

package/dist/causal/narrative/generator.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Narrative Generator
+ *
+ * Generates human-readable narratives from causal chains,
+ * explaining "why" something is the way it is.
+ *
+ * @module causal/narrative/generator
+ */
+import type { CausalChain, CausalRelation } from '../../types/causal.js';
+/**
+ * Narrative output format
+ */
+export interface Narrative {
+    /** Plain text narrative */
+    text: string;
+    /** Markdown formatted narrative */
+    markdown: string;
+    /** Structured sections */
+    sections: NarrativeSection[];
+    /** Summary (one paragraph) */
+    summary: string;
+    /** Key points */
+    keyPoints: string[];
+    /** Confidence in the narrative */
+    confidence: number;
+}
+/**
+ * A section of the narrative
+ */
+export interface NarrativeSection {
+    /** Section title */
+    title: string;
+    /** Section content */
+    content: string;
+    /** Items in this section */
+    items: NarrativeItem[];
+}
+/**
+ * An item in a narrative section
+ */
+export interface NarrativeItem {
+    /** Memory ID */
+    memoryId: string;
+    /** Memory type */
+    memoryType: string;
+    /** Memory summary */
+    summary: string;
+    /** Relation to the root */
+    relation?: CausalRelation | undefined;
+    /** Strength of connection */
+    strength?: number | undefined;
+    /** Depth in chain */
+    depth: number;
+}
+/**
+ * MCP-formatted output
+ */
+export interface MCPNarrativeOutput {
+    /** Root memory ID */
+    rootId: string;
+    /** Direction of analysis */
+    direction: string;
+    /** Human-readable narrative */
+    narrative: string;
+    /** Summary */
+    summary: string;
+    /** Key points */
+    keyPoints: string[];
+    /** Chain statistics */
+    stats: {
+        totalMemories: number;
+        maxDepth: number;
+        chainConfidence: number;
+        relationCounts: Record<string, number>;
+    };
+    /** Detailed chain (optional) */
+    chain?: {
+        nodes: Array<{
+            id: string;
+            type: string;
+            summary: string;
+            depth: number;
+        }>;
+        edges: Array<{
+            from: string;
+            to: string;
+            relation: string;
+            strength: number;
+        }>;
+    };
+}
+/**
+ * Narrative generator
+ *
+ * Converts causal chains into human-readable narratives.
+ */
+export declare class NarrativeGenerator {
+    /**
+     * Generate a full narrative from a causal chain
+     */
+    generateNarrative(chain: CausalChain): Narrative;
+    /**
+     * Generate a short summary
+     */
+    generateSummary(chain: CausalChain): string;
+    /**
+     * Format for MCP tool output
+     */
+    formatForMCP(chain: CausalChain, includeChain?: boolean): MCPNarrativeOutput;
+    private generateSections;
+    private createSection;
+    private formatItem;
+    private extractKeyPoints;
+    private generatePlainText;
+    private generateMarkdown;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/causal/narrative/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/causal/narrative/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EAEX,cAAc,EACf,MAAM,uBAAuB,CAAC;AAQ/B;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uBAAuB;IACvB,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,CAAC;IACF,gCAAgC;IAChC,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,KAAK,CAAC;YACX,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;QACH,KAAK,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC,CAAC;KACJ,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS;IAiBhD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IA2B3C;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,UAAQ,GAAG,kBAAkB;IA6C1E,OAAO,CAAC,gBAAgB;IA+DxB,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,gBAAgB;IAgCxB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,gBAAgB;CAiCzB"}