cursor-recursive-rag 0.2.0-alpha.2 → 0.2.0

package/dist/services/decayCalculator.js

@@ -0,0 +1,182 @@
+export const DEFAULT_DECAY_CALCULATOR_CONFIG = {
+    halfLifeDays: 60,
+    expectedAccessesPerMonth: 5,
+    recencyBoostDays: 7,
+    recencyBoostMultiplier: 1.5,
+    weights: {
+        age: 0.3,
+        access: 0.3,
+        importance: 0.4,
+    },
+    archivalThreshold: 0.2,
+};
+/**
+ * Calculates decay scores for chunks based on multiple factors
+ *
+ * Formula: decayScore = (ageFactor * weightAge) + (accessFactor * weightAccess) + (importanceFactor * weightImportance)
+ *
+ * Where:
+ * - ageFactor = 1.0 / (1.0 + (ageDays / halfLifeDays))
+ * - accessFactor = min(1.0, accessCount / expectedAccesses) * recencyBoost
+ * - importanceFactor = chunk.importance
+ */
+export class DecayCalculator {
+    config;
+    constructor(config) {
+        this.config = {
+            ...DEFAULT_DECAY_CALCULATOR_CONFIG,
+            ...config,
+            weights: {
+                ...DEFAULT_DECAY_CALCULATOR_CONFIG.weights,
+                ...config?.weights,
+            },
+        };
+    }
+    /**
+     * Calculate decay score for a single chunk
+     */
+    calculateDecayScore(chunk, now = new Date()) {
+        const ageFactor = this.calculateAgeFactor(chunk.createdAt, now);
+        const accessFactor = this.calculateAccessFactor(chunk, now);
+        const importanceFactor = chunk.importance;
+        const score = ageFactor * this.config.weights.age +
+            accessFactor * this.config.weights.access +
+            importanceFactor * this.config.weights.importance;
+        // Clamp to 0-1 range
+        return Math.max(0, Math.min(1, score));
+    }
+    /**
+     * Calculate age factor using exponential decay
+     * Returns 1.0 for new chunks, approaches 0 for very old chunks
+     */
+    calculateAgeFactor(createdAt, now) {
+        const createdDate = new Date(createdAt);
+        const ageDays = (now.getTime() - createdDate.getTime()) / (1000 * 60 * 60 * 24);
+        // Exponential decay: 1 / (1 + (age / halfLife))
+        // At halfLife days, factor = 0.5
+        return 1.0 / (1.0 + ageDays / this.config.halfLifeDays);
+    }
+    /**
+     * Calculate access factor based on access count and recency
+     */
+    calculateAccessFactor(chunk, now) {
+        // Base score from access count
+        const baseAccessScore = Math.min(1.0, chunk.accessCount / this.config.expectedAccessesPerMonth);
+        // Apply recency boost if accessed recently
+        if (chunk.lastAccessedAt) {
+            const lastAccessDate = new Date(chunk.lastAccessedAt);
+            const daysSinceAccess = (now.getTime() - lastAccessDate.getTime()) / (1000 * 60 * 60 * 24);
+            if (daysSinceAccess <= this.config.recencyBoostDays) {
+                // Linear decay of boost based on days since access
+                const boostFactor = 1 - daysSinceAccess / this.config.recencyBoostDays;
+                const boost = 1 + (this.config.recencyBoostMultiplier - 1) * boostFactor;
+                return Math.min(1.0, baseAccessScore * boost);
+            }
+        }
+        return baseAccessScore;
+    }
+    /**
+     * Calculate decay scores for multiple chunks
+     */
+    calculateBatchDecayScores(chunks, now = new Date()) {
+        return chunks.map(chunk => ({
+            chunkId: chunk.chunkId,
+            decayScore: this.calculateDecayScore(chunk, now),
+        }));
+    }
+    /**
+     * Update all decay scores in the metadata store
+     */
+    updateAllDecayScores(store, autoArchive = false) {
+        const startTime = Date.now();
+        const now = new Date();
+        // Get all non-archived chunks
+        const chunks = store.getAllChunkMetadata({ includeArchived: false });
+        // Calculate new decay scores
+        const updates = this.calculateBatchDecayScores(chunks, now);
+        // Batch update scores
+        store.bulkUpdateDecayScores(updates);
+        // Optionally archive chunks below threshold
+        let archived = 0;
+        if (autoArchive) {
+            const archivedIds = store.archiveStaleChunks(this.config.archivalThreshold);
+            archived = archivedIds.length;
+        }
+        return {
+            updated: updates.length,
+            archived,
+            duration: Date.now() - startTime,
+        };
+    }
+    /**
+     * Get chunks that are candidates for archival
+     */
+    getArchivalCandidates(chunks, threshold) {
+        const archiveThreshold = threshold ?? this.config.archivalThreshold;
+        return chunks.filter(chunk => chunk.decayScore < archiveThreshold && !chunk.isArchived);
+    }
+    /**
+     * Simulate decay over time for testing/visualization
+     */
+    simulateDecay(initialImportance, accessPattern, daysToSimulate) {
+        const results = [];
+        const baseDate = new Date();
+        // Create a mock chunk
+        const mockChunk = {
+            chunkId: 'simulation',
+            createdAt: baseDate.toISOString(),
+            updatedAt: baseDate.toISOString(),
+            lastAccessedAt: null,
+            accessCount: 0,
+            importance: initialImportance,
+            decayScore: 1.0,
+            isArchived: false,
+            chunkType: 'documentation',
+            sourceConversationId: null,
+            sourceMessageIndex: null,
+        };
+        for (let day = 0; day <= daysToSimulate; day++) {
+            const simulationDate = new Date(baseDate.getTime() + day * 24 * 60 * 60 * 1000);
+            // Apply any accesses for this day
+            const todayAccesses = accessPattern.filter(a => a.dayOffset === day);
+            for (const _ of todayAccesses) {
+                mockChunk.accessCount++;
+                mockChunk.lastAccessedAt = simulationDate.toISOString();
+            }
+            const score = this.calculateDecayScore(mockChunk, simulationDate);
+            results.push({ day, decayScore: score });
+        }
+        return results;
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = {
+            ...this.config,
+            ...config,
+            weights: {
+                ...this.config.weights,
+                ...config?.weights,
+            },
+        };
+    }
+}
+// Default instance
+let instance = null;
+export function getDecayCalculator(config) {
+    if (!instance) {
+        instance = new DecayCalculator(config);
+    }
+    return instance;
+}
+export function resetDecayCalculator() {
+    instance = null;
+}
+//# sourceMappingURL=decayCalculator.js.map

package/dist/services/decayCalculator.js.map

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

package/dist/services/enhancedVectorStore.d.ts

@@ -0,0 +1,102 @@
+import type { VectorStore, VectorDocument, SearchResult, SearchOptions } from '../types/index.js';
+import type { ChunkMetadata, EnhancedSearchResult, EnhancedSearchOptions } from '../types/memory.js';
+import { MemoryMetadataStore } from './memoryMetadataStore.js';
+import { type DecayCalculatorConfig } from './decayCalculator.js';
+/**
+ * Score weights for hybrid ranking
+ */
+export interface ScoreWeights {
+    similarity: number;
+    decay: number;
+    importance: number;
+}
+export declare const DEFAULT_SCORE_WEIGHTS: ScoreWeights;
+/**
+ * Enhanced vector store that wraps existing implementation with memory capabilities
+ *
+ * This wrapper:
+ * 1. Maintains temporal metadata (creation time, access patterns)
+ * 2. Calculates decay scores for all chunks
+ * 3. Re-ranks search results using hybrid scoring (similarity + decay + importance)
+ * 4. Records access patterns for future decay calculations
+ */
+export declare class EnhancedVectorStore implements VectorStore {
+    private vectorStore;
+    private metadataStore;
+    private decayCalculator;
+    private scoreWeights;
+    constructor(vectorStore: VectorStore, options?: {
+        metadataStore?: MemoryMetadataStore;
+        decayConfig?: Partial<DecayCalculatorConfig>;
+        scoreWeights?: Partial<ScoreWeights>;
+    });
+    /**
+     * Add documents to both vector store and metadata store
+     */
+    add(docs: VectorDocument[]): Promise<void>;
+    /**
+     * Search with hybrid scoring (similarity + decay + importance)
+     */
+    search(embedding: number[], options: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Enhanced search with full options
+     */
+    enhancedSearch(embedding: number[], options: EnhancedSearchOptions): Promise<EnhancedSearchResult[]>;
+    /**
+     * Delete documents from both stores
+     */
+    delete(ids: string[]): Promise<void>;
+    /**
+     * Count documents in vector store
+     */
+    count(): Promise<number>;
+    /**
+     * Get memory statistics
+     */
+    getMemoryStats(): import("../types/memory.js").MemoryStats;
+    /**
+     * Update decay scores for all chunks
+     */
+    updateDecayScores(autoArchive?: boolean): import("./decayCalculator.js").UpdateResult;
+    /**
+     * Get chunk metadata
+     */
+    getChunkMetadata(chunkId: string): ChunkMetadata | null;
+    /**
+     * Update chunk importance
+     */
+    updateImportance(chunkId: string, importance: number): void;
+    /**
+     * Get the underlying vector store (for direct access if needed)
+     */
+    getUnderlyingStore(): VectorStore;
+    /**
+     * Get the metadata store (for advanced operations)
+     */
+    getMetadataStore(): MemoryMetadataStore;
+    /**
+     * Enrich search results with metadata
+     */
+    private enrichWithMetadata;
+    /**
+     * Re-rank results using hybrid scoring
+     */
+    private rerank;
+    /**
+     * Calculate final score using weighted combination
+     */
+    private calculateFinalScore;
+    /**
+     * Record access for results
+     */
+    private recordAccess;
+}
+/**
+ * Create an enhanced vector store from an existing vector store
+ */
+export declare function createEnhancedVectorStore(vectorStore: VectorStore, options?: {
+    metadataDbPath?: string;
+    decayConfig?: Partial<DecayCalculatorConfig>;
+    scoreWeights?: Partial<ScoreWeights>;
+}): EnhancedVectorStore;
+//# sourceMappingURL=enhancedVectorStore.d.ts.map

package/dist/services/enhancedVectorStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancedVectorStore.d.ts","sourceRoot":"","sources":["../../src/services/enhancedVectorStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,KAAK,EAEV,aAAa,EAEb,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAA0B,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAuC,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEvG;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAe;gBAGjC,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,mBAAmB,CAAC;QACpC,WAAW,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAC7C,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;KACtC;IAaH;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAehD;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkClF;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA2ClC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B;;OAEG;IACH,cAAc;IAId;;OAEG;IACH,iBAAiB,CAAC,WAAW,GAAE,OAAe;IAI9C;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIvD;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAI3D;;OAEG;IACH,kBAAkB,IAAI,WAAW;IAIjC;;OAEG;IACH,gBAAgB,IAAI,mBAAmB;IAIvC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoC1B;;OAEG;IACH,OAAO,CAAC,MAAM;IASd;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,YAAY;CAKrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACtC,GACA,mBAAmB,CAUrB"}

package/dist/services/enhancedVectorStore.js

@@ -0,0 +1,245 @@
+import { MemoryMetadataStore, getMemoryMetadataStore } from './memoryMetadataStore.js';
+import { DecayCalculator, getDecayCalculator } from './decayCalculator.js';
+export const DEFAULT_SCORE_WEIGHTS = {
+    similarity: 0.5,
+    decay: 0.3,
+    importance: 0.2,
+};
+/**
+ * Enhanced vector store that wraps existing implementation with memory capabilities
+ *
+ * This wrapper:
+ * 1. Maintains temporal metadata (creation time, access patterns)
+ * 2. Calculates decay scores for all chunks
+ * 3. Re-ranks search results using hybrid scoring (similarity + decay + importance)
+ * 4. Records access patterns for future decay calculations
+ */
+export class EnhancedVectorStore {
+    vectorStore;
+    metadataStore;
+    decayCalculator;
+    scoreWeights;
+    constructor(vectorStore, options) {
+        this.vectorStore = vectorStore;
+        this.metadataStore = options?.metadataStore || getMemoryMetadataStore();
+        this.decayCalculator = options?.decayConfig
+            ? new DecayCalculator(options.decayConfig)
+            : getDecayCalculator();
+        this.scoreWeights = {
+            ...DEFAULT_SCORE_WEIGHTS,
+            ...options?.scoreWeights,
+        };
+    }
+    /**
+     * Add documents to both vector store and metadata store
+     */
+    async add(docs) {
+        // Add to vector store
+        await this.vectorStore.add(docs);
+        // Add metadata for each document
+        for (const doc of docs) {
+            this.metadataStore.upsertChunkMetadata({
+                chunkId: doc.id,
+                source: doc.metadata?.source || 'unknown',
+                chunkType: doc.metadata?.chunkType || 'documentation',
+                importance: typeof doc.metadata?.importance === 'number' ? doc.metadata.importance : 0.5,
+            });
+        }
+    }
+    /**
+     * Search with hybrid scoring (similarity + decay + importance)
+     */
+    async search(embedding, options) {
+        // Over-fetch to allow for re-ranking
+        const overFetchMultiplier = 2;
+        const overFetchOptions = {
+            ...options,
+            topK: options.topK * overFetchMultiplier,
+        };
+        // Get candidates from vector store
+        const candidates = await this.vectorStore.search(embedding, overFetchOptions);
+        // Enrich with metadata and calculate final scores
+        const enriched = this.enrichWithMetadata(candidates);
+        // Re-rank by final score
+        const reranked = this.rerank(enriched);
+        // Record access for top results
+        const topResults = reranked.slice(0, options.topK);
+        this.recordAccess(topResults);
+        // Return SearchResult format (compatible with existing interface)
+        return topResults.map(r => ({
+            id: r.id,
+            content: r.content,
+            metadata: {
+                ...r.metadata,
+                decayScore: r.decayAdjustedScore,
+                finalScore: r.finalScore,
+            },
+            score: r.finalScore,
+        }));
+    }
+    /**
+     * Enhanced search with full options
+     */
+    async enhancedSearch(embedding, options) {
+        // Over-fetch to allow for re-ranking and filtering
+        const overFetchMultiplier = 3;
+        const baseOptions = {
+            topK: options.topK * overFetchMultiplier,
+            filter: options.filter,
+        };
+        // Get candidates from vector store
+        const candidates = await this.vectorStore.search(embedding, baseOptions);
+        // Enrich with metadata
+        let enriched = this.enrichWithMetadata(candidates);
+        // Apply filters
+        if (options.minDecayScore !== undefined) {
+            enriched = enriched.filter(r => r.decayAdjustedScore >= options.minDecayScore);
+        }
+        if (options.chunkTypes && options.chunkTypes.length > 0) {
+            enriched = enriched.filter(r => {
+                const metadata = this.metadataStore.getChunkMetadata(r.id);
+                return metadata && options.chunkTypes.includes(metadata.chunkType);
+            });
+        }
+        if (!options.includeArchived) {
+            enriched = enriched.filter(r => {
+                const metadata = this.metadataStore.getChunkMetadata(r.id);
+                return metadata && !metadata.isArchived;
+            });
+        }
+        // Re-rank
+        const reranked = this.rerank(enriched);
+        // Record access for top results
+        const topResults = reranked.slice(0, options.topK);
+        this.recordAccess(topResults);
+        return topResults;
+    }
+    /**
+     * Delete documents from both stores
+     */
+    async delete(ids) {
+        await this.vectorStore.delete(ids);
+        for (const id of ids) {
+            this.metadataStore.deleteChunkMetadata(id);
+        }
+    }
+    /**
+     * Count documents in vector store
+     */
+    async count() {
+        return this.vectorStore.count();
+    }
+    /**
+     * Get memory statistics
+     */
+    getMemoryStats() {
+        return this.metadataStore.getMemoryStats();
+    }
+    /**
+     * Update decay scores for all chunks
+     */
+    updateDecayScores(autoArchive = false) {
+        return this.decayCalculator.updateAllDecayScores(this.metadataStore, autoArchive);
+    }
+    /**
+     * Get chunk metadata
+     */
+    getChunkMetadata(chunkId) {
+        return this.metadataStore.getChunkMetadata(chunkId);
+    }
+    /**
+     * Update chunk importance
+     */
+    updateImportance(chunkId, importance) {
+        this.metadataStore.upsertChunkMetadata({ chunkId, importance });
+    }
+    /**
+     * Get the underlying vector store (for direct access if needed)
+     */
+    getUnderlyingStore() {
+        return this.vectorStore;
+    }
+    /**
+     * Get the metadata store (for advanced operations)
+     */
+    getMetadataStore() {
+        return this.metadataStore;
+    }
+    /**
+     * Enrich search results with metadata
+     */
+    enrichWithMetadata(results) {
+        return results.map(result => {
+            const metadata = this.metadataStore.getChunkMetadata(result.id);
+            const decayScore = metadata?.decayScore ?? 1.0;
+            const importance = metadata?.importance ?? 0.5;
+            return {
+                chunk: {
+                    id: result.id,
+                    content: result.content,
+                    embedding: [],
+                    source: result.metadata?.source || 'unknown',
+                    metadata: result.metadata,
+                    createdAt: metadata ? new Date(metadata.createdAt) : new Date(),
+                    updatedAt: metadata ? new Date(metadata.updatedAt) : new Date(),
+                    lastAccessedAt: metadata?.lastAccessedAt ? new Date(metadata.lastAccessedAt) : null,
+                    accessCount: metadata?.accessCount ?? 0,
+                    importance,
+                    decayScore,
+                    isArchived: metadata?.isArchived ?? false,
+                    chunkType: metadata?.chunkType || 'documentation',
+                    relatedChunkIds: [],
+                    entities: [],
+                },
+                similarityScore: result.score,
+                decayAdjustedScore: decayScore,
+                finalScore: 0, // Will be calculated in rerank
+                id: result.id,
+                content: result.content,
+                metadata: result.metadata,
+                score: result.score,
+            };
+        });
+    }
+    /**
+     * Re-rank results using hybrid scoring
+     */
+    rerank(results) {
+        return results
+            .map(r => ({
+            ...r,
+            finalScore: this.calculateFinalScore(r),
+        }))
+            .sort((a, b) => b.finalScore - a.finalScore);
+    }
+    /**
+     * Calculate final score using weighted combination
+     */
+    calculateFinalScore(result) {
+        return (result.similarityScore * this.scoreWeights.similarity +
+            result.decayAdjustedScore * this.scoreWeights.decay +
+            result.chunk.importance * this.scoreWeights.importance);
+    }
+    /**
+     * Record access for results
+     */
+    recordAccess(results) {
+        for (let i = 0; i < results.length; i++) {
+            this.metadataStore.recordAccess(results[i].id, undefined, i + 1);
+        }
+    }
+}
+/**
+ * Create an enhanced vector store from an existing vector store
+ */
+export function createEnhancedVectorStore(vectorStore, options) {
+    const metadataStore = options?.metadataDbPath
+        ? new MemoryMetadataStore(options.metadataDbPath)
+        : getMemoryMetadataStore();
+    return new EnhancedVectorStore(vectorStore, {
+        metadataStore,
+        decayConfig: options?.decayConfig,
+        scoreWeights: options?.scoreWeights,
+    });
+}
+//# sourceMappingURL=enhancedVectorStore.js.map

package/dist/services/enhancedVectorStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancedVectorStore.js","sourceRoot":"","sources":["../../src/services/enhancedVectorStore.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAA8B,MAAM,sBAAsB,CAAC;AAWvG,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,GAAG;IACV,UAAU,EAAE,GAAG;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IACtB,WAAW,CAAc;IACzB,aAAa,CAAsB;IACnC,eAAe,CAAkB;IACjC,YAAY,CAAe;IAEnC,YACE,WAAwB,EACxB,OAIC;QAED,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,sBAAsB,EAAE,CAAC;QACxE,IAAI,CAAC,eAAe,GAAG,OAAO,EAAE,WAAW;YACzC,CAAC,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC;YAC1C,CAAC,CAAC,kBAAkB,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG;YAClB,GAAG,qBAAqB;YACxB,GAAG,OAAO,EAAE,YAAY;SACzB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,IAAsB;QAC9B,sBAAsB;QACtB,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEjC,iCAAiC;QACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC;gBACrC,OAAO,EAAE,GAAG,CAAC,EAAE;gBACf,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,SAAS;gBACzC,SAAS,EAAG,GAAG,CAAC,QAAQ,EAAE,SAAuB,IAAI,eAAe;gBACpE,UAAU,EAAE,OAAO,GAAG,CAAC,QAAQ,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;aACzF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,SAAmB,EAAE,OAAsB;QACtD,qCAAqC;QACrC,MAAM,mBAAmB,GAAG,CAAC,CAAC;QAC9B,MAAM,gBAAgB,GAAG;YACvB,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG,mBAAmB;SACzC,CAAC;QAEF,mCAAmC;QACnC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAE9E,kDAAkD;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAErD,yBAAyB;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEvC,gCAAgC;QAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAE9B,kEAAkE;QAClE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE;gBACR,GAAG,CAAC,CAAC,QAAQ;gBACb,UAAU,EAAE,CAAC,CAAC,kBAAkB;gBAChC,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB;YACD,KAAK,EAAE,CAAC,CAAC,UAAU;SACpB,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,SAAmB,EACnB,OAA8B;QAE9B,mDAAmD;QACnD,MAAM,mBAAmB,GAAG,CAAC,CAAC;QAC9B,MAAM,WAAW,GAAkB;YACjC,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG,mBAAmB;YACxC,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC;QAEF,mCAAmC;QACnC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAEzE,uBAAuB;QACvB,IAAI,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAEnD,gBAAgB;QAChB,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACxC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,IAAI,OAAO,CAAC,aAAc,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC3D,OAAO,QAAQ,IAAI,OAAO,CAAC,UAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC7B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC3D,OAAO,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC1C,CAAC,CAAC,CAAC;QACL,CAAC;QAED,UAAU;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEvC,gCAAgC;QAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAE9B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,GAAa;QACxB,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEnC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,cAAuB,KAAK;QAC5C,OAAO,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAAe;QAC9B,OAAO,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAAe,EAAE,UAAkB;QAClD,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,OAAuB;QAChD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAEhE,MAAM,UAAU,GAAG,QAAQ,EAAE,UAAU,IAAI,GAAG,CAAC;YAC/C,MAAM,UAAU,GAAG,QAAQ,EAAE,UAAU,IAAI,GAAG,CAAC;YAE/C,OAAO;gBACL,KAAK,EAAE;oBACL,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,SAAS,EAAE,EAAE;oBACb,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,SAAS;oBAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE;oBAC/D,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE;oBAC/D,cAAc,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI;oBACnF,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,CAAC;oBACvC,UAAU;oBACV,UAAU;oBACV,UAAU,EAAE,QAAQ,EAAE,UAAU,IAAI,KAAK;oBACzC,SAAS,EAAG,QAAQ,EAAE,SAAuB,IAAI,eAAe;oBAChE,eAAe,EAAE,EAAE;oBACnB,QAAQ,EAAE,EAAE;iBACI;gBAClB,eAAe,EAAE,MAAM,CAAC,KAAK;gBAC7B,kBAAkB,EAAE,UAAU;gBAC9B,UAAU,EAAE,CAAC,EAAE,+BAA+B;gBAC9C,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,OAA+B;QAC5C,OAAO,OAAO;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACT,GAAG,CAAC;YACJ,UAAU,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;SACxC,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,MAA4B;QACtD,OAAO,CACL,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU;YACrD,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK;YACnD,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CACvD,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,OAA+B;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAAwB,EACxB,OAIC;IAED,MAAM,aAAa,GAAG,OAAO,EAAE,cAAc;QAC3C,CAAC,CAAC,IAAI,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC;QACjD,CAAC,CAAC,sBAAsB,EAAE,CAAC;IAE7B,OAAO,IAAI,mBAAmB,CAAC,WAAW,EAAE;QAC1C,aAAa;QACb,WAAW,EAAE,OAAO,EAAE,WAAW;QACjC,YAAY,EAAE,OAAO,EAAE,YAAY;KACpC,CAAC,CAAC;AACL,CAAC"}

package/dist/services/hybridScorer.d.ts

@@ -0,0 +1,120 @@
+import type { EnhancedChunk, ChunkType } from '../types/memory.js';
+import { RelationshipGraph } from './relationshipGraph.js';
+import { CategoryManager } from './categoryManager.js';
+import { MemoryMetadataStore } from './memoryMetadataStore.js';
+export interface ScoreWeights {
+    similarity: number;
+    decay: number;
+    importance: number;
+    recency: number;
+    graphBoost: number;
+    typeBoost: number;
+}
+export declare const DEFAULT_SCORE_WEIGHTS: ScoreWeights;
+export interface TypeBoosts {
+    [key: string]: number;
+}
+export declare const DEFAULT_TYPE_BOOSTS: TypeBoosts;
+export interface ScoringConfig {
+    weights: ScoreWeights;
+    typeBoosts: TypeBoosts;
+    recencyHalfLifeDays: number;
+    graphTraversalDepth: number;
+    graphMinStrength: number;
+}
+export declare const DEFAULT_SCORING_CONFIG: ScoringConfig;
+export interface ScoringContext {
+    seedChunkIds?: string[];
+    preferredTypes?: ChunkType[];
+    project?: string;
+    boostCategories?: string[];
+}
+export interface ScoreComponents {
+    similarity: number;
+    decay: number;
+    importance: number;
+    recency: number;
+    graphBoost: number;
+    typeBoost: number;
+}
+export interface ScoredResult {
+    id: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    scores: ScoreComponents;
+    finalScore: number;
+    chunk?: EnhancedChunk;
+}
+export interface CategorySummary {
+    category: string;
+    summary: string;
+    itemCount: number;
+}
+export interface TieredResult {
+    tier: 'summary' | 'item' | 'both';
+    results: ScoredResult[];
+    categorySummaries?: CategorySummary[];
+    message: string;
+    totalFound: number;
+}
+export interface SearchResultInput {
+    id: string;
+    content: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Hybrid scoring system that combines multiple signals for final ranking
+ *
+ * Signals combined:
+ * - Vector similarity (base retrieval score)
+ * - Temporal decay (age-based relevance)
+ * - Importance (user-defined or inferred)
+ * - Recency (recently accessed items)
+ * - Graph boost (related to known-relevant items)
+ * - Type boost (favor solutions/patterns over raw docs)
+ */
+export declare class HybridScorer {
+    private config;
+    private graph;
+    private metadataStore;
+    private categoryManager;
+    constructor(graph?: RelationshipGraph, metadataStore?: MemoryMetadataStore, categoryManager?: CategoryManager, config?: Partial<ScoringConfig>);
+    /**
+     * Score and rank search results using hybrid scoring
+     */
+    scoreResults(results: SearchResultInput[], query: string, context?: ScoringContext): Promise<ScoredResult[]>;
+    /**
+     * Tiered retrieval: try category summaries first, then drill down
+     */
+    tieredRetrieval(query: string, searchResults: SearchResultInput[], options?: {
+        maxSummaries?: number;
+        maxItems?: number;
+        requireSpecificItems?: boolean;
+    }): Promise<TieredResult>;
+    /**
+     * Score a single result (useful for on-the-fly scoring)
+     */
+    scoreOne(result: SearchResultInput, context?: ScoringContext): ScoredResult;
+    /**
+     * Re-rank existing scored results with updated context
+     */
+    rerankWithContext(results: ScoredResult[], context: ScoringContext): Promise<ScoredResult[]>;
+    /**
+     * Get score breakdown for debugging/transparency
+     */
+    explainScore(result: ScoredResult): string;
+    /**
+     * Update scoring configuration
+     */
+    updateConfig(config: Partial<ScoringConfig>): void;
+    getConfig(): ScoringConfig;
+    private calculateFinalScore;
+    private calculateRecencyScore;
+    private getTypeBoost;
+    private getGraphContext;
+    private checkSufficiency;
+}
+export declare function getHybridScorer(config?: Partial<ScoringConfig>): HybridScorer;
+export declare function resetHybridScorer(): void;
+//# sourceMappingURL=hybridScorer.d.ts.map