driftdetect-cortex 0.9.41

package/dist/prediction/predictor/temporal-predictor.js

@@ -0,0 +1,282 @@
+/**
+ * Temporal Predictor
+ *
+ * Predicts memories based on time patterns.
+ * Uses time of day, day of week, and session
+ * duration to predict relevant memories.
+ *
+ * @module prediction/predictor/temporal-predictor
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    maxPredictions: 10,
+    timeOfDayConfidence: 0.5,
+    dayOfWeekConfidence: 0.4,
+    sessionConfidence: 0.6,
+    newSessionConfidence: 0.7,
+};
+/**
+ * Temporal Predictor
+ *
+ * Predicts memories based on time patterns.
+ */
+export class TemporalPredictor {
+    config;
+    storage;
+    usageRecords = new Map();
+    constructor(storage, config) {
+        this.storage = storage;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Predict memories based on temporal signals
+     */
+    async predict(signals) {
+        const predictions = [];
+        // If new session, get commonly used memories
+        if (signals.isNewSession) {
+            const newSessionMemories = await this.getNewSessionMemories();
+            for (const memory of newSessionMemories) {
+                predictions.push(this.createPrediction(memory, this.config.newSessionConfidence, 'temporal', 'Commonly used at session start', ['isNewSession']));
+            }
+        }
+        // Get time-of-day specific memories
+        const timeOfDayMemories = await this.getTimeOfDayMemories(signals.timeOfDay);
+        for (const memory of timeOfDayMemories) {
+            // Skip if already predicted
+            if (predictions.some(p => p.memoryId === memory.id))
+                continue;
+            predictions.push(this.createPrediction(memory, this.config.timeOfDayConfidence, 'temporal', `Often used in the ${signals.timeOfDay}`, ['timeOfDay']));
+        }
+        // Get day-of-week specific memories
+        const dayOfWeekMemories = await this.getDayOfWeekMemories(signals.dayOfWeek);
+        for (const memory of dayOfWeekMemories) {
+            // Skip if already predicted
+            if (predictions.some(p => p.memoryId === memory.id))
+                continue;
+            predictions.push(this.createPrediction(memory, this.config.dayOfWeekConfidence, 'temporal', `Often used on ${signals.dayOfWeek}`, ['dayOfWeek']));
+        }
+        // Get session-duration based memories
+        if (signals.sessionDuration > 0) {
+            const sessionMemories = await this.getSessionDurationMemories(signals.sessionDuration);
+            for (const memory of sessionMemories) {
+                // Skip if already predicted
+                if (predictions.some(p => p.memoryId === memory.id))
+                    continue;
+                predictions.push(this.createPrediction(memory, this.config.sessionConfidence, 'temporal', `Relevant at ${signals.sessionDuration} minutes into session`, ['sessionDuration']));
+            }
+        }
+        // Sort by confidence and limit
+        predictions.sort((a, b) => b.confidence - a.confidence);
+        return predictions.slice(0, this.config.maxPredictions);
+    }
+    /**
+     * Record memory usage for temporal tracking
+     */
+    recordUsage(memoryId, timeOfDay, dayOfWeek) {
+        let record = this.usageRecords.get(memoryId);
+        if (!record) {
+            record = {
+                memoryId,
+                timeOfDay: new Map(),
+                dayOfWeek: new Map(),
+                totalUsage: 0,
+            };
+            this.usageRecords.set(memoryId, record);
+        }
+        // Update time of day count
+        const todCount = record.timeOfDay.get(timeOfDay) ?? 0;
+        record.timeOfDay.set(timeOfDay, todCount + 1);
+        // Update day of week count
+        const dowCount = record.dayOfWeek.get(dayOfWeek) ?? 0;
+        record.dayOfWeek.set(dayOfWeek, dowCount + 1);
+        record.totalUsage++;
+    }
+    /**
+     * Get memories commonly used at session start
+     */
+    async getNewSessionMemories() {
+        // Get most frequently used memories overall
+        const sortedRecords = Array.from(this.usageRecords.values())
+            .sort((a, b) => b.totalUsage - a.totalUsage)
+            .slice(0, 10);
+        const memories = [];
+        for (const record of sortedRecords) {
+            try {
+                const memory = await this.storage.read(record.memoryId);
+                if (memory) {
+                    memories.push(memory);
+                }
+            }
+            catch {
+                // Continue with other memories
+            }
+        }
+        return memories;
+    }
+    /**
+     * Get memories commonly used at a specific time of day
+     */
+    async getTimeOfDayMemories(timeOfDay) {
+        // Find memories with high usage at this time of day
+        const candidates = [];
+        for (const record of this.usageRecords.values()) {
+            const todCount = record.timeOfDay.get(timeOfDay) ?? 0;
+            if (todCount > 0) {
+                // Score based on proportion of usage at this time
+                const score = todCount / record.totalUsage;
+                candidates.push({ memoryId: record.memoryId, score });
+            }
+        }
+        // Sort by score and get top memories
+        candidates.sort((a, b) => b.score - a.score);
+        const memories = [];
+        for (const candidate of candidates.slice(0, 5)) {
+            try {
+                const memory = await this.storage.read(candidate.memoryId);
+                if (memory) {
+                    memories.push(memory);
+                }
+            }
+            catch {
+                // Continue with other memories
+            }
+        }
+        return memories;
+    }
+    /**
+     * Get memories commonly used on a specific day of week
+     */
+    async getDayOfWeekMemories(dayOfWeek) {
+        // Find memories with high usage on this day
+        const candidates = [];
+        for (const record of this.usageRecords.values()) {
+            const dowCount = record.dayOfWeek.get(dayOfWeek) ?? 0;
+            if (dowCount > 0) {
+                // Score based on proportion of usage on this day
+                const score = dowCount / record.totalUsage;
+                candidates.push({ memoryId: record.memoryId, score });
+            }
+        }
+        // Sort by score and get top memories
+        candidates.sort((a, b) => b.score - a.score);
+        const memories = [];
+        for (const candidate of candidates.slice(0, 5)) {
+            try {
+                const memory = await this.storage.read(candidate.memoryId);
+                if (memory) {
+                    memories.push(memory);
+                }
+            }
+            catch {
+                // Continue with other memories
+            }
+        }
+        return memories;
+    }
+    /**
+     * Get memories relevant to session duration
+     */
+    async getSessionDurationMemories(duration) {
+        // Early session (< 10 min): Get quick reference memories
+        // Mid session (10-60 min): Get detailed memories
+        // Long session (> 60 min): Get comprehensive memories
+        let types;
+        if (duration < 10) {
+            types = ['tribal', 'pattern_rationale'];
+        }
+        else if (duration < 60) {
+            types = ['tribal', 'pattern_rationale', 'decision_context'];
+        }
+        else {
+            types = ['tribal', 'pattern_rationale', 'decision_context', 'code_smell'];
+        }
+        try {
+            const results = await this.storage.search({
+                types,
+                limit: 5,
+            });
+            return results;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Create a prediction from a memory
+     */
+    createPrediction(memory, confidence, strategy, reason, contributingSignals) {
+        const source = {
+            strategy,
+            reason,
+            contributingSignals,
+            confidenceBreakdown: {
+                base: confidence,
+                usageBoost: this.getUsageBoost(memory.id),
+            },
+        };
+        // Calculate final confidence with boosts
+        const finalConfidence = Math.min(confidence + source.confidenceBreakdown['usageBoost'], 1.0);
+        return {
+            memoryId: memory.id,
+            memoryType: memory.type,
+            summary: memory.summary.substring(0, 100),
+            confidence: finalConfidence,
+            source,
+            relevanceScore: finalConfidence,
+            embeddingPreloaded: false,
+        };
+    }
+    /**
+     * Get usage boost for a memory
+     */
+    getUsageBoost(memoryId) {
+        const record = this.usageRecords.get(memoryId);
+        if (!record)
+            return 0;
+        if (record.totalUsage > 20)
+            return 0.15;
+        if (record.totalUsage > 10)
+            return 0.1;
+        if (record.totalUsage > 5)
+            return 0.05;
+        return 0;
+    }
+    /**
+     * Clear usage records
+     */
+    clear() {
+        this.usageRecords.clear();
+    }
+    /**
+     * Export state for persistence
+     */
+    export() {
+        return Array.from(this.usageRecords.entries()).map(([id, record]) => [
+            id,
+            {
+                memoryId: record.memoryId,
+                timeOfDay: Array.from(record.timeOfDay.entries()),
+                dayOfWeek: Array.from(record.dayOfWeek.entries()),
+                totalUsage: record.totalUsage,
+            },
+        ]);
+    }
+    /**
+     * Import state from persistence
+     */
+    import(state) {
+        this.usageRecords.clear();
+        for (const [id, data] of state) {
+            this.usageRecords.set(id, {
+                memoryId: data.memoryId,
+                timeOfDay: new Map(data.timeOfDay),
+                dayOfWeek: new Map(data.dayOfWeek),
+                totalUsage: data.totalUsage,
+            });
+        }
+    }
+}
+//# sourceMappingURL=temporal-predictor.js.map

package/dist/prediction/predictor/temporal-predictor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-predictor.js","sourceRoot":"","sources":["../../../src/prediction/predictor/temporal-predictor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH;;GAEG;AACH,MAAM,cAAc,GAA4B;IAC9C,cAAc,EAAE,EAAE;IAClB,mBAAmB,EAAE,GAAG;IACxB,mBAAmB,EAAE,GAAG;IACxB,iBAAiB,EAAE,GAAG;IACtB,oBAAoB,EAAE,GAAG;CAC1B,CAAC;AAYF;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAA0B;IAChC,OAAO,CAAiB;IACxB,YAAY,GAAqC,IAAI,GAAG,EAAE,CAAC;IAEnE,YAAY,OAAuB,EAAE,MAAyC;QAC5E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAwB;QACpC,MAAM,WAAW,GAAsB,EAAE,CAAC;QAE1C,6CAA6C;QAC7C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC9D,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;gBACxC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CACpC,MAAM,EACN,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAChC,UAAU,EACV,gCAAgC,EAChC,CAAC,cAAc,CAAC,CACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7E,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;YACvC,4BAA4B;YAC5B,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,CAAC;gBAAE,SAAS;YAE9D,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CACpC,MAAM,EACN,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAC/B,UAAU,EACV,qBAAqB,OAAO,CAAC,SAAS,EAAE,EACxC,CAAC,WAAW,CAAC,CACd,CAAC,CAAC;QACL,CAAC;QAED,oCAAoC;QACpC,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7E,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;YACvC,4BAA4B;YAC5B,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,CAAC;gBAAE,SAAS;YAE9D,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CACpC,MAAM,EACN,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAC/B,UAAU,EACV,iBAAiB,OAAO,CAAC,SAAS,EAAE,EACpC,CAAC,WAAW,CAAC,CACd,CAAC,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,IAAI,OAAO,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YACvF,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;gBACrC,4BAA4B;gBAC5B,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,CAAC;oBAAE,SAAS;gBAE9D,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CACpC,MAAM,EACN,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAC7B,UAAU,EACV,eAAe,OAAO,CAAC,eAAe,uBAAuB,EAC7D,CAAC,iBAAiB,CAAC,CACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QACxD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,WAAW,CACT,QAAgB,EAChB,SAAiB,EACjB,SAAiB;QAEjB,IAAI,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG;gBACP,QAAQ;gBACR,SAAS,EAAE,IAAI,GAAG,EAAE;gBACpB,SAAS,EAAE,IAAI,GAAG,EAAE;gBACpB,UAAU,EAAE,CAAC;aACd,CAAC;YACF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAED,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;QAE9C,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;QAE9C,MAAM,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB;QACjC,4CAA4C;QAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;aACzD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;aAC3C,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACxD,IAAI,MAAM,EAAE,CAAC;oBACX,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAChC,SAAwD;QAExD,oDAAoD;QACpD,MAAM,UAAU,GAA+C,EAAE,CAAC;QAElE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACtD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,kDAAkD;gBAClD,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC;gBAC3C,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAE7C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC3D,IAAI,MAAM,EAAE,CAAC;oBACX,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAAC,SAAiB;QAClD,4CAA4C;QAC5C,MAAM,UAAU,GAA+C,EAAE,CAAC;QAElE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACtD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,iDAAiD;gBACjD,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC;gBAC3C,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAE7C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC3D,IAAI,MAAM,EAAE,CAAC;oBACX,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,0BAA0B,CAAC,QAAgB;QACvD,yDAAyD;QACzD,iDAAiD;QACjD,sDAAsD;QAEtD,IAAI,KAAkD,CAAC;QACvD,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;YAClB,KAAK,GAAG,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;YACzB,KAAK,GAAG,CAAC,QAAQ,EAAE,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,CAAC,QAAQ,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;gBACxC,KAAK;gBACL,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,MAAc,EACd,UAAkB,EAClB,QAAoB,EACpB,MAAc,EACd,mBAA6B;QAE7B,MAAM,MAAM,GAAqB;YAC/B,QAAQ;YACR,MAAM;YACN,mBAAmB;YACnB,mBAAmB,EAAE;gBACnB,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;aAC1C;SACF,CAAC;QAEF,yCAAyC;QACzC,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAC9B,UAAU,GAAG,MAAM,CAAC,mBAAmB,CAAC,YAAY,CAAE,EACtD,GAAG,CACJ,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;YACzC,UAAU,EAAE,eAAe;YAC3B,MAAM;YACN,cAAc,EAAE,eAAe;YAC/B,kBAAkB,EAAE,KAAK;SAC1B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,QAAgB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC;QAEtB,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE;YAAE,OAAO,IAAI,CAAC;QACxC,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE;YAAE,OAAO,GAAG,CAAC;QACvC,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,MAAM;QAMJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;YACnE,EAAE;YACF;gBACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACjD,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACjD,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B;SACF,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAKJ;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE;gBACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBAClC,SAAS,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBAClC,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/prediction/signals/behavioral-signals.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Behavioral Signal Extractor
+ *
+ * Extracts user behavior signals for prediction.
+ * Analyzes query patterns, intents, and usage
+ * to predict which memories will be relevant.
+ *
+ * @module prediction/signals/behavioral-signals
+ */
+import type { BehavioralSignals, Intent, UserPattern } from '../types.js';
+/**
+ * Configuration for behavioral signal extraction
+ */
+export interface BehavioralSignalExtractorConfig {
+    /** Maximum recent queries to track */
+    maxRecentQueries: number;
+    /** Maximum recent intents to track */
+    maxRecentIntents: number;
+    /** Maximum frequent memories to track */
+    maxFrequentMemories: number;
+    /** Maximum user patterns to detect */
+    maxUserPatterns: number;
+    /** Minimum occurrences for a pattern */
+    minPatternOccurrences: number;
+}
+/**
+ * Query record for tracking
+ */
+interface QueryRecord {
+    query: string;
+    intent: Intent;
+    timestamp: Date;
+    file?: string;
+    memoriesUsed: string[];
+}
+/**
+ * Memory usage record
+ */
+interface MemoryUsageRecord {
+    memoryId: string;
+    usageCount: number;
+    lastUsed: Date;
+    contexts: string[];
+}
+/**
+ * Behavioral Signal Extractor
+ *
+ * Extracts user behavior signals for prediction.
+ */
+export declare class BehavioralSignalExtractor {
+    private config;
+    private queryHistory;
+    private memoryUsage;
+    private currentTask;
+    private detectedPatterns;
+    constructor(config?: Partial<BehavioralSignalExtractorConfig>);
+    /**
+     * Extract behavioral signals
+     */
+    extract(): BehavioralSignals;
+    /**
+     * Record a query
+     */
+    recordQuery(query: string, intent: Intent, file?: string, memoriesUsed?: string[]): void;
+    /**
+     * Record memory usage
+     */
+    recordMemoryUsage(memoryId: string, context: string): void;
+    /**
+     * Set current task context
+     */
+    setCurrentTask(task: string | undefined): void;
+    /**
+     * Get recent queries
+     */
+    private getRecentQueries;
+    /**
+     * Get recent intents
+     */
+    private getRecentIntents;
+    /**
+     * Get frequently used memories
+     */
+    private getFrequentMemories;
+    /**
+     * Detect user patterns from history
+     */
+    private detectUserPatterns;
+    /**
+     * Get detected patterns (for external access)
+     */
+    getDetectedPatterns(): UserPattern[];
+    /**
+     * Detect file sequence patterns
+     */
+    private detectFileSequencePattern;
+    /**
+     * Detect query sequence patterns
+     */
+    private detectQuerySequencePattern;
+    /**
+     * Detect time-based patterns
+     */
+    private detectTimeBasedPattern;
+    /**
+     * Detect task-based patterns
+     */
+    private detectTaskBasedPattern;
+    /**
+     * Get memories associated with files
+     */
+    private getMemoriesForFiles;
+    /**
+     * Get memories associated with intents
+     */
+    private getMemoriesForIntents;
+    /**
+     * Clear all behavioral data
+     */
+    clear(): void;
+    /**
+     * Export state for persistence
+     */
+    export(): {
+        queryHistory: QueryRecord[];
+        memoryUsage: [string, MemoryUsageRecord][];
+        currentTask?: string;
+    };
+    /**
+     * Import state from persistence
+     */
+    import(state: {
+        queryHistory?: QueryRecord[];
+        memoryUsage?: [string, MemoryUsageRecord][];
+        currentTask?: string;
+    }): void;
+}
+export {};
+//# sourceMappingURL=behavioral-signals.d.ts.map

package/dist/prediction/signals/behavioral-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavioral-signals.d.ts","sourceRoot":"","sources":["../../../src/prediction/signals/behavioral-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAaD;;GAEG;AACH,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,gBAAgB,CAAqB;gBAEjC,MAAM,CAAC,EAAE,OAAO,CAAC,+BAA+B,CAAC;IAI7D;;OAEG;IACH,OAAO,IAAI,iBAAiB;IAqB5B;;OAEG;IACH,WAAW,CACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,YAAY,GAAE,MAAM,EAAO,GAC1B,IAAI;IA6BP;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAsB1D;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI9C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;OAEG;IACH,mBAAmB,IAAI,WAAW,EAAE;IAIpC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA+CjC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA8ClC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkD9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,MAAM,IAAI;QACR,YAAY,EAAE,WAAW,EAAE,CAAC;QAC5B,WAAW,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IAiBD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE;QACZ,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;QAC7B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,IAAI;CAYT"}