driftdetect-cortex 0.9.41

package/dist/learning/active/candidate-selector.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Validation Candidate Selector
+ *
+ * Selects memories that need user validation based on
+ * confidence, importance, age, and usage patterns.
+ *
+ * @module learning/active/candidate-selector
+ */
+import type { Memory, Importance } from '../../types/memory.js';
+import type { IMemoryStorage } from '../../storage/interface.js';
+import type { ValidationCandidate, ValidationReason } from '../../types/learning.js';
+/**
+ * Selection options
+ */
+export interface SelectionOptions {
+    /** Maximum candidates to return */
+    limit?: number;
+    /** Minimum confidence to consider */
+    minConfidence?: number;
+    /** Maximum confidence to consider */
+    maxConfidence?: number;
+    /** Filter by importance levels */
+    importanceLevels?: Importance[];
+    /** Filter by memory types */
+    memoryTypes?: string[];
+    /** Minimum age in days */
+    minAgeDays?: number;
+    /** Maximum age in days */
+    maxAgeDays?: number;
+    /** Include only unvalidated memories */
+    unvalidatedOnly?: boolean;
+}
+/**
+ * Validation Candidate Selector
+ *
+ * Identifies memories that would benefit from user validation.
+ */
+export declare class ValidationCandidateSelector {
+    private storage;
+    private metricsCalculator;
+    private calibrator;
+    constructor(storage: IMemoryStorage);
+    /**
+     * Select validation candidates
+     */
+    selectCandidates(options?: SelectionOptions): Promise<ValidationCandidate[]>;
+    /**
+     * Filter memories by confidence range
+     */
+    filterByConfidenceRange(memories: Memory[], options: SelectionOptions): Memory[];
+    /**
+     * Filter memories by importance
+     */
+    filterByImportance(memories: Memory[], options: SelectionOptions): Memory[];
+    /**
+     * Filter memories by age
+     */
+    filterByAge(memories: Memory[], minDays?: number, maxDays?: number): Memory[];
+    /**
+     * Prioritize candidates by various factors
+     */
+    prioritize(candidates: ValidationCandidate[]): ValidationCandidate[];
+    /**
+     * Score candidates and create ValidationCandidate objects
+     */
+    private scoreCandidates;
+    /**
+     * Calculate priority score for a candidate
+     */
+    private calculatePriority;
+    /**
+     * Generate a suggested prompt for validation
+     */
+    private generateSuggestedPrompt;
+    /**
+     * Get candidates by specific reason
+     */
+    getCandidatesByReason(reason: ValidationReason, limit?: number): Promise<ValidationCandidate[]>;
+    /**
+     * Get high-priority candidates only
+     */
+    getHighPriorityCandidates(limit?: number): Promise<ValidationCandidate[]>;
+}
+//# sourceMappingURL=candidate-selector.d.ts.map

package/dist/learning/active/candidate-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-selector.d.ts","sourceRoot":"","sources":["../../../src/learning/active/candidate-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIrF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,UAAU,EAAE,CAAC;IAChC,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAYD;;;;GAIG;AACH,qBAAa,2BAA2B;IAI1B,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,UAAU,CAAuB;gBAErB,OAAO,EAAE,cAAc;IAK3C;;OAEG;IACG,gBAAgB,CACpB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4DjC;;OAEG;IACH,uBAAuB,CACrB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,gBAAgB,GACxB,MAAM,EAAE;IAYX;;OAEG;IACH,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,gBAAgB,GACxB,MAAM,EAAE;IAUX;;OAEG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,EAAE;IAmBX;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE;IAKpE;;OAEG;YACW,eAAe;IAgC7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;OAEG;IACG,qBAAqB,CACzB,MAAM,EAAE,gBAAgB,EACxB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOjC;;OAEG;IACG,yBAAyB,CAAC,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAUnF"}

package/dist/learning/active/candidate-selector.js

@@ -0,0 +1,215 @@
+/**
+ * Validation Candidate Selector
+ *
+ * Selects memories that need user validation based on
+ * confidence, importance, age, and usage patterns.
+ *
+ * @module learning/active/candidate-selector
+ */
+import { MetricsCalculator } from '../confidence/metrics.js';
+import { ConfidenceCalibrator } from '../confidence/calibrator.js';
+/**
+ * Default selection options
+ */
+const DEFAULT_OPTIONS = {
+    limit: 10,
+    minConfidence: 0,
+    maxConfidence: 0.7,
+    unvalidatedOnly: false,
+};
+/**
+ * Validation Candidate Selector
+ *
+ * Identifies memories that would benefit from user validation.
+ */
+export class ValidationCandidateSelector {
+    storage;
+    metricsCalculator;
+    calibrator;
+    constructor(storage) {
+        this.storage = storage;
+        this.metricsCalculator = new MetricsCalculator(storage);
+        this.calibrator = new ConfidenceCalibrator();
+    }
+    /**
+     * Select validation candidates
+     */
+    async selectCandidates(options = {}) {
+        const opts = { ...DEFAULT_OPTIONS, ...options };
+        // Build query, only including defined properties
+        const query = {
+            includeArchived: false,
+            limit: 1000,
+        };
+        if (opts.memoryTypes) {
+            query.types = opts.memoryTypes;
+        }
+        if (opts.importanceLevels) {
+            query.importance = opts.importanceLevels;
+        }
+        if (opts.minConfidence !== undefined) {
+            query.minConfidence = opts.minConfidence;
+        }
+        if (opts.maxConfidence !== undefined) {
+            query.maxConfidence = opts.maxConfidence;
+        }
+        // Get all non-archived memories
+        const memories = await this.storage.search(query);
+        // Filter by criteria
+        let filtered = memories;
+        // Filter by age
+        if (opts.minAgeDays !== undefined || opts.maxAgeDays !== undefined) {
+            filtered = this.filterByAge(filtered, opts.minAgeDays, opts.maxAgeDays);
+        }
+        // Filter by validation status
+        if (opts.unvalidatedOnly) {
+            filtered = filtered.filter(m => !m.lastValidated);
+        }
+        // Filter by confidence range
+        filtered = this.filterByConfidenceRange(filtered, opts);
+        // Filter by importance
+        filtered = this.filterByImportance(filtered, opts);
+        // Score and prioritize candidates
+        const candidates = await this.scoreCandidates(filtered);
+        // Sort by priority and return top candidates
+        candidates.sort((a, b) => b.priority - a.priority);
+        return candidates.slice(0, opts.limit);
+    }
+    /**
+     * Filter memories by confidence range
+     */
+    filterByConfidenceRange(memories, options) {
+        return memories.filter(m => {
+            if (options.minConfidence !== undefined && m.confidence < options.minConfidence) {
+                return false;
+            }
+            if (options.maxConfidence !== undefined && m.confidence > options.maxConfidence) {
+                return false;
+            }
+            return true;
+        });
+    }
+    /**
+     * Filter memories by importance
+     */
+    filterByImportance(memories, options) {
+        if (!options.importanceLevels || options.importanceLevels.length === 0) {
+            return memories;
+        }
+        return memories.filter(m => options.importanceLevels.includes(m.importance));
+    }
+    /**
+     * Filter memories by age
+     */
+    filterByAge(memories, minDays, maxDays) {
+        const now = new Date();
+        return memories.filter(m => {
+            const created = new Date(m.createdAt);
+            const ageInDays = Math.floor((now.getTime() - created.getTime()) / (1000 * 60 * 60 * 24));
+            if (minDays !== undefined && ageInDays < minDays) {
+                return false;
+            }
+            if (maxDays !== undefined && ageInDays > maxDays) {
+                return false;
+            }
+            return true;
+        });
+    }
+    /**
+     * Prioritize candidates by various factors
+     */
+    prioritize(candidates) {
+        // Already sorted by priority in selectCandidates
+        return candidates;
+    }
+    /**
+     * Score candidates and create ValidationCandidate objects
+     */
+    async scoreCandidates(memories) {
+        const candidates = [];
+        for (const memory of memories) {
+            try {
+                const metrics = await this.metricsCalculator.getMetrics(memory.id);
+                const calculated = this.calibrator.calculate(memory, metrics);
+                if (calculated.needsValidation) {
+                    const priority = this.calculatePriority(memory, calculated.confidence);
+                    const reason = calculated.validationReason || 'low_confidence';
+                    candidates.push({
+                        memoryId: memory.id,
+                        memoryType: memory.type,
+                        summary: memory.summary,
+                        currentConfidence: calculated.confidence,
+                        reason: reason,
+                        priority,
+                        suggestedPrompt: this.generateSuggestedPrompt(memory, reason),
+                    });
+                }
+            }
+            catch {
+                // Skip memories that can't be processed
+            }
+        }
+        return candidates;
+    }
+    /**
+     * Calculate priority score for a candidate
+     */
+    calculatePriority(memory, confidence) {
+        let priority = 0;
+        // Lower confidence = higher priority
+        priority += (1 - confidence) * 0.4;
+        // Higher importance = higher priority
+        const importanceScores = {
+            critical: 1.0,
+            high: 0.75,
+            normal: 0.5,
+            low: 0.25,
+        };
+        priority += importanceScores[memory.importance] * 0.3;
+        // More access = higher priority (more impactful)
+        const accessScore = Math.min(memory.accessCount / 100, 1);
+        priority += accessScore * 0.2;
+        // Never validated = higher priority
+        if (!memory.lastValidated) {
+            priority += 0.1;
+        }
+        return Math.min(priority, 1.0);
+    }
+    /**
+     * Generate a suggested prompt for validation
+     */
+    generateSuggestedPrompt(memory, reason) {
+        const reasonMessages = {
+            low_confidence: 'This memory has low confidence.',
+            conflicting_evidence: 'There is conflicting evidence about this memory.',
+            stale: 'This memory is old and may be outdated.',
+            never_validated: 'This memory has never been validated.',
+            high_importance_low_confidence: 'This is an important memory with low confidence.',
+            frequent_rejection: 'This memory has been frequently rejected.',
+        };
+        const reasonMessage = reasonMessages[reason] || 'This memory needs validation.';
+        return `${reasonMessage} Is this still accurate?\n\n"${memory.summary}"`;
+    }
+    /**
+     * Get candidates by specific reason
+     */
+    async getCandidatesByReason(reason, limit = 10) {
+        const allCandidates = await this.selectCandidates({ limit: 100 });
+        return allCandidates
+            .filter(c => c.reason === reason)
+            .slice(0, limit);
+    }
+    /**
+     * Get high-priority candidates only
+     */
+    async getHighPriorityCandidates(limit = 5) {
+        const candidates = await this.selectCandidates({
+            limit: 50,
+            importanceLevels: ['critical', 'high'],
+        });
+        return candidates
+            .filter(c => c.priority > 0.7)
+            .slice(0, limit);
+    }
+}
+//# sourceMappingURL=candidate-selector.js.map

package/dist/learning/active/candidate-selector.js.map

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

package/dist/learning/active/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Active Learning Submodule
+ *
+ * Implements active learning to improve memory quality:
+ * - Identifies memories needing validation
+ * - Generates validation prompts
+ * - Processes user feedback
+ *
+ * @module learning/active
+ */
+export * from './candidate-selector.js';
+export * from './prompt-generator.js';
+export * from './loop.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/learning/active/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/learning/active/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC"}

package/dist/learning/active/index.js

@@ -0,0 +1,14 @@
+/**
+ * Active Learning Submodule
+ *
+ * Implements active learning to improve memory quality:
+ * - Identifies memories needing validation
+ * - Generates validation prompts
+ * - Processes user feedback
+ *
+ * @module learning/active
+ */
+export * from './candidate-selector.js';
+export * from './prompt-generator.js';
+export * from './loop.js';
+//# sourceMappingURL=index.js.map

package/dist/learning/active/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/learning/active/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC"}

package/dist/learning/active/loop.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Active Learning Loop
+ *
+ * Orchestrates the active learning cycle:
+ * - Identifies memories needing validation
+ * - Generates validation prompts
+ * - Processes user feedback
+ * - Updates memory confidence
+ *
+ * @module learning/active/loop
+ */
+import type { Memory } from '../../types/memory.js';
+import type { IMemoryStorage } from '../../storage/interface.js';
+import type { ValidationPrompt, LearningOutcome } from '../../types/learning.js';
+import { ValidationCandidateSelector } from './candidate-selector.js';
+import { ValidationPromptGenerator } from './prompt-generator.js';
+import { ConfidenceCalibrator } from '../confidence/calibrator.js';
+import { MetricsCalculator } from '../confidence/metrics.js';
+/**
+ * Active learning configuration
+ */
+export interface ActiveLearningConfig {
+    /** Maximum candidates to consider per cycle */
+    maxCandidatesPerCycle: number;
+    /** Minimum time between validations for same memory (hours) */
+    minValidationIntervalHours: number;
+    /** Enable automatic candidate selection */
+    autoSelectCandidates: boolean;
+    /** Confidence boost on confirmation */
+    confirmationBoost: number;
+    /** Confidence reduction on rejection */
+    rejectionPenalty: number;
+}
+/**
+ * Active Learning Loop
+ *
+ * Manages the continuous improvement of memory quality through
+ * user validation and feedback.
+ */
+export declare class ActiveLearningLoop {
+    private storage;
+    private config;
+    private candidateSelector;
+    private promptGenerator;
+    private _calibrator;
+    private _metricsCalculator;
+    /** Queue of pending validations */
+    private validationQueue;
+    /** Recently validated memory IDs with timestamps */
+    private recentlyValidated;
+    constructor(storage: IMemoryStorage, candidateSelector?: ValidationCandidateSelector, promptGenerator?: ValidationPromptGenerator, calibrator?: ConfidenceCalibrator, config?: Partial<ActiveLearningConfig>);
+    /**
+     * Get the calibrator instance
+     */
+    get calibrator(): ConfidenceCalibrator;
+    /**
+     * Get the metrics calculator instance
+     */
+    get metricsCalculator(): MetricsCalculator;
+    /**
+     * Process user feedback for a memory
+     */
+    processFeedback(memoryId: string, feedback: 'confirm' | 'reject' | 'modify', modification?: string): Promise<LearningOutcome>;
+    /**
+     * Identify memories needing validation
+     */
+    identifyValidationCandidates(): Promise<Memory[]>;
+    /**
+     * Get the next validation prompt
+     */
+    getNextValidationPrompt(): Promise<ValidationPrompt | null>;
+    /**
+     * Get multiple validation prompts
+     */
+    getValidationPrompts(count: number): Promise<ValidationPrompt[]>;
+    /**
+     * Get current queue status
+     */
+    getQueueStatus(): {
+        queueLength: number;
+        recentlyValidatedCount: number;
+    };
+    /**
+     * Clear the validation queue
+     */
+    clearQueue(): void;
+    /**
+     * Handle confirmation feedback
+     */
+    private handleConfirmation;
+    /**
+     * Handle rejection feedback
+     */
+    private handleRejection;
+    /**
+     * Handle modification feedback
+     */
+    private handleModification;
+    /**
+     * Check if memory was recently validated
+     */
+    private wasRecentlyValidated;
+    /**
+     * Store validation feedback in history
+     */
+    private storeValidationFeedback;
+    /**
+     * Run a full validation cycle
+     */
+    runValidationCycle(): Promise<{
+        candidatesFound: number;
+        promptsGenerated: number;
+    }>;
+    /**
+     * Create loop with default dependencies
+     */
+    static create(storage: IMemoryStorage, config?: Partial<ActiveLearningConfig>): ActiveLearningLoop;
+}
+//# sourceMappingURL=loop.d.ts.map

package/dist/learning/active/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/learning/active/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EACV,gBAAgB,EAGhB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,0BAA0B,EAAE,MAAM,CAAC;IACnC,2CAA2C;IAC3C,oBAAoB,EAAE,OAAO,CAAC;IAC9B,uCAAuC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAaD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAc3B,OAAO,CAAC,OAAO;IAbjB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,kBAAkB,CAAoB;IAE9C,mCAAmC;IACnC,OAAO,CAAC,eAAe,CAA6B;IAEpD,oDAAoD;IACpD,OAAO,CAAC,iBAAiB,CAAgC;gBAG/C,OAAO,EAAE,cAAc,EAC/B,iBAAiB,CAAC,EAAE,2BAA2B,EAC/C,eAAe,CAAC,EAAE,yBAAyB,EAC3C,UAAU,CAAC,EAAE,oBAAoB,EACjC,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAS5C;;OAEG;IACH,IAAI,UAAU,IAAI,oBAAoB,CAErC;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,iBAAiB,CAEzC;IAED;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,EACzC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,CAAC;IA4E3B;;OAEG;IACG,4BAA4B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBvD;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAuBjE;;OAEG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAYtE;;OAEG;IACH,cAAc,IAAI;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,sBAAsB,EAAE,MAAM,CAAC;KAChC;IAOD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;YACW,kBAAkB;IAahC;;OAEG;YACW,eAAe;IAqB7B;;OAEG;YACW,kBAAkB;IAehC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;YACW,uBAAuB;IAQrC;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC;QAClC,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IASF;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,kBAAkB;CAGtB"}