memento-mcp-server 0.1.0

package/dist/algorithms/search-ranking.js

@@ -0,0 +1,311 @@
+/**
+ * 검색 랭킹 알고리즘 구현
+ * Memento-Goals.md의 검색 랭킹 공식 구현
+ */
+export class SearchRanking {
+    weights;
+    constructor(weights) {
+        this.weights = {
+            relevance: 0.50,
+            recency: 0.20,
+            importance: 0.20,
+            usage: 0.10,
+            duplication_penalty: 0.15,
+            ...weights
+        };
+    }
+    /**
+     * 최종 검색 점수 계산
+     * S = α * relevance + β * recency + γ * importance + δ * usage - ε * duplication_penalty
+     */
+    calculateFinalScore(features) {
+        return this.weights.relevance * features.relevance +
+            this.weights.recency * features.recency +
+            this.weights.importance * features.importance +
+            this.weights.usage * features.usage -
+            this.weights.duplication_penalty * features.duplication_penalty;
+    }
+    /**
+     * 관련성 점수 계산 (실제 구현)
+     * 임베딩 유사도(60%) + BM25(30%) + 태그 매칭(5%) + 타이틀 히트(5%)
+     */
+    calculateRelevance(input) {
+        const { query, content, title, tags, embeddingSimilarity, bm25Result } = input;
+        // 입력 검증
+        if (!query || !content)
+            return 0;
+        // 1. 임베딩 유사도 (60% 가중치)
+        const embeddingScore = embeddingSimilarity
+            ? this.calculateEmbeddingSimilarity(embeddingSimilarity.queryEmbedding, embeddingSimilarity.docEmbedding)
+            : 0;
+        // 2. BM25 점수 (30% 가중치)
+        const bm25Score = bm25Result
+            ? this.normalizeBM25(bm25Result.score)
+            : this.calculateSimpleBM25(query, content);
+        // 3. 태그 매칭 (5% 가중치)
+        const tagScore = this.calculateTagMatch(query, tags);
+        // 4. 타이틀 히트 (5% 가중치)
+        const titleScore = title ? this.calculateTitleHit(query, title) : 0;
+        // 가중치 적용
+        return 0.60 * embeddingScore +
+            0.30 * bm25Score +
+            0.05 * tagScore +
+            0.05 * titleScore;
+    }
+    /**
+     * 임베딩 유사도 계산 (코사인 유사도)
+     */
+    calculateEmbeddingSimilarity(queryEmbedding, docEmbedding) {
+        if (queryEmbedding.length !== docEmbedding.length)
+            return 0;
+        const dotProduct = this.dotProduct(queryEmbedding, docEmbedding);
+        const magnitudeA = this.magnitude(queryEmbedding);
+        const magnitudeB = this.magnitude(docEmbedding);
+        if (magnitudeA === 0 || magnitudeB === 0)
+            return 0;
+        const cosine = dotProduct / (magnitudeA * magnitudeB);
+        return Math.max(0, cosine); // 음수 방지
+    }
+    /**
+     * BM25 점수 정규화
+     */
+    normalizeBM25(bm25Score, kNorm = 2.0) {
+        return bm25Score / (bm25Score + kNorm);
+    }
+    /**
+     * 간단한 BM25 구현 (실제 BM25가 없는 경우)
+     */
+    calculateSimpleBM25(query, content) {
+        // 입력 검증
+        if (!query || !content)
+            return 0;
+        const queryTerms = query.toLowerCase().split(/\s+/);
+        const contentTerms = content.toLowerCase().split(/\s+/);
+        const termFreq = new Map();
+        // 용어 빈도 계산
+        for (const term of contentTerms) {
+            termFreq.set(term, (termFreq.get(term) || 0) + 1);
+        }
+        let score = 0;
+        const k1 = 1.2;
+        const b = 0.75;
+        const docLength = contentTerms.length;
+        const avgDocLength = 100; // 평균 문서 길이 (추정값)
+        for (const term of queryTerms) {
+            const tf = termFreq.get(term) || 0;
+            if (tf > 0) {
+                const idf = Math.log(2); // 간단한 IDF (실제로는 전체 문서 수 필요)
+                const normalizedTf = (tf * (k1 + 1)) / (tf + k1 * (1 - b + b * (docLength / avgDocLength)));
+                score += idf * normalizedTf;
+            }
+        }
+        return Math.min(1.0, score / 10); // 정규화
+    }
+    /**
+     * 태그 매칭 (자카드 유사도)
+     */
+    calculateTagMatch(query, tags) {
+        if (tags.length === 0)
+            return 0;
+        const queryTerms = new Set(query.toLowerCase().split(/\s+/));
+        const tagTerms = new Set(tags.map(tag => tag.toLowerCase()));
+        const intersection = new Set([...queryTerms].filter(x => tagTerms.has(x)));
+        const union = new Set([...queryTerms, ...tagTerms]);
+        return union.size > 0 ? intersection.size / union.size : 0;
+    }
+    /**
+     * 타이틀 히트 계산
+     */
+    calculateTitleHit(query, title) {
+        const queryLower = query.toLowerCase();
+        const titleLower = title.toLowerCase();
+        let score = 0;
+        // 정확 매치
+        if (titleLower === queryLower)
+            score += 1.0;
+        // 접두 매치
+        else if (titleLower.startsWith(queryLower))
+            score += 0.5;
+        // N-gram 매치
+        else if (this.hasNgramMatch(queryLower, titleLower))
+            score += 0.2;
+        return Math.min(1.0, score);
+    }
+    /**
+     * N-gram 매치 확인
+     */
+    hasNgramMatch(query, text, n = 3) {
+        if (query.length < n || text.length < n)
+            return false;
+        const queryNgrams = this.generateNgrams(query, n);
+        const textNgrams = this.generateNgrams(text, n);
+        for (const ngram of queryNgrams) {
+            if (textNgrams.has(ngram))
+                return true;
+        }
+        return false;
+    }
+    /**
+     * N-gram 생성
+     */
+    generateNgrams(text, n) {
+        const ngrams = new Set();
+        for (let i = 0; i <= text.length - n; i++) {
+            ngrams.add(text.substring(i, i + n));
+        }
+        return ngrams;
+    }
+    /**
+     * 벡터 내적 계산
+     */
+    dotProduct(a, b) {
+        return a.reduce((sum, val, i) => sum + val * (b[i] || 0), 0);
+    }
+    /**
+     * 벡터 크기 계산
+     */
+    magnitude(vector) {
+        return Math.sqrt(vector.reduce((sum, val) => sum + val * val, 0));
+    }
+    /**
+     * 최근성 점수 계산
+     * 반감기 기반 지수 감쇠
+     */
+    calculateRecency(createdAt, type) {
+        const ageDays = this.getAgeInDays(createdAt);
+        const halfLife = this.getHalfLife(type);
+        return Math.exp(-Math.log(2) * ageDays / halfLife);
+    }
+    /**
+     * 중요도 점수 계산
+     */
+    calculateImportance(userImportance, isPinned, type) {
+        const pinnedBoost = isPinned ? 0.2 : 0;
+        const typeBoost = this.getTypeBoost(type);
+        return Math.max(0, Math.min(1, userImportance + pinnedBoost + typeBoost));
+    }
+    /**
+     * 사용성 점수 계산 (실제 구현)
+     * viewCount + citeCount(2배) + editCount(0.5배) 로그 스케일 집계
+     */
+    calculateUsage(metrics, batchMin, batchMax) {
+        // 입력 검증
+        if (!metrics)
+            return 0;
+        const { viewCount, citeCount, editCount } = metrics;
+        // 로그 스케일 집계
+        const rawUsage = Math.log(1 + viewCount) +
+            2 * Math.log(1 + citeCount) +
+            0.5 * Math.log(1 + editCount);
+        // 모든 값이 0인 경우 기본값 제공
+        if (rawUsage === 0) {
+            return 0.1; // 기본 사용성 점수
+        }
+        // 배치 정규화 (전체 배치에서 정규화)
+        if (batchMin !== undefined && batchMax !== undefined) {
+            return this.normalize(rawUsage, batchMin, batchMax);
+        }
+        // 개별 정규화 (기본값)
+        return Math.min(1.0, rawUsage / 10);
+    }
+    /**
+     * 배치 사용성 점수 계산 (여러 메모리에 대해)
+     */
+    calculateBatchUsage(metricsList) {
+        const rawUsages = metricsList.map(metrics => {
+            const { viewCount, citeCount, editCount } = metrics;
+            return Math.log(1 + viewCount) +
+                2 * Math.log(1 + citeCount) +
+                0.5 * Math.log(1 + editCount);
+        });
+        const min = Math.min(...rawUsages);
+        const max = Math.max(...rawUsages);
+        const normalized = rawUsages.map(usage => this.normalize(usage, min, max));
+        return { normalized, min, max };
+    }
+    /**
+     * 정규화 함수
+     */
+    normalize(value, min, max, epsilon = 1e-6) {
+        if (max === min)
+            return 0.5; // 모든 값이 같을 때
+        return (value - min) / (max - min + epsilon);
+    }
+    /**
+     * 중복 패널티 계산 (MMR 구현)
+     */
+    calculateDuplicationPenalty(candidateContent, selectedContents) {
+        if (selectedContents.length === 0)
+            return 0;
+        let maxSimilarity = 0;
+        for (const selectedContent of selectedContents) {
+            const similarity = this.calculateTextSimilarity(candidateContent, selectedContent);
+            maxSimilarity = Math.max(maxSimilarity, similarity);
+        }
+        return maxSimilarity;
+    }
+    /**
+     * 텍스트 유사도 계산 (자카드 유사도)
+     */
+    calculateTextSimilarity(text1, text2) {
+        const words1 = new Set(text1.toLowerCase().split(/\s+/));
+        const words2 = new Set(text2.toLowerCase().split(/\s+/));
+        const intersection = new Set([...words1].filter(x => words2.has(x)));
+        const union = new Set([...words1, ...words2]);
+        return union.size > 0 ? intersection.size / union.size : 0;
+    }
+    /**
+     * 하위 호환성을 위한 간단한 관련성 계산 (기존 API)
+     */
+    calculateRelevanceSimple(query, content, tags = []) {
+        return this.calculateRelevance({
+            query,
+            content,
+            tags,
+            embeddingSimilarity: undefined,
+            bm25Result: undefined
+        });
+    }
+    /**
+     * 하위 호환성을 위한 간단한 사용성 계산 (기존 API)
+     */
+    calculateUsageSimple(lastAccessed) {
+        if (!lastAccessed)
+            return 0.1;
+        const daysSinceAccess = this.getAgeInDays(lastAccessed);
+        return Math.exp(-daysSinceAccess / 30);
+    }
+    /**
+     * 나이 계산 (일 단위)
+     */
+    getAgeInDays(date) {
+        const now = new Date();
+        const diffTime = now.getTime() - date.getTime();
+        return diffTime / (1000 * 60 * 60 * 24);
+    }
+    /**
+     * 타입별 반감기 (일 단위)
+     */
+    getHalfLife(type) {
+        switch (type) {
+            case 'working': return 2;
+            case 'episodic': return 30;
+            case 'semantic': return 180;
+            case 'procedural': return 90;
+            default: return 30;
+        }
+    }
+    /**
+     * 타입별 부스트 점수
+     */
+    getTypeBoost(type) {
+        switch (type) {
+            case 'semantic': return 0.1;
+            case 'episodic': return 0.0;
+            case 'working': return -0.05;
+            case 'procedural': return 0.05;
+            default: return 0.0;
+        }
+    }
+}
+//# sourceMappingURL=search-ranking.js.map

package/dist/algorithms/search-ranking.js.map

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

package/dist/algorithms/spaced-repetition.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 간격 반복 알고리즘 구현
+ * Memento-Goals.md의 간격 반복 공식 구현
+ */
+export interface SpacedRepetitionFeatures {
+    importance: number;
+    usage: number;
+    helpful_feedback: number;
+    bad_feedback: number;
+}
+export interface SpacedRepetitionWeights {
+    importance: number;
+    usage: number;
+    helpful_feedback: number;
+    bad_feedback: number;
+}
+export interface ReviewSchedule {
+    memory_id: string;
+    current_interval: number;
+    next_review: Date;
+    recall_probability: number;
+    needs_review: boolean;
+    multiplier: number;
+}
+export declare class SpacedRepetitionAlgorithm {
+    private readonly weights;
+    private readonly recallThreshold;
+    constructor(weights?: Partial<SpacedRepetitionWeights>);
+    /**
+     * 다음 리뷰 간격 계산
+     * interval = current_interval * (1 + A1*importance + A2*usage + A3*helpful - A4*bad)
+     */
+    calculateNextInterval(currentInterval: number, features: SpacedRepetitionFeatures): number;
+    /**
+     * 리콜 확률 계산
+     * P = exp(-time_since_last_review / interval)
+     */
+    calculateRecallProbability(timeSinceLastReview: number, // 일 단위
+    interval: number): number;
+    /**
+     * 리뷰 필요 여부 판단
+     */
+    needsReview(timeSinceLastReview: number, interval: number, threshold?: number): boolean;
+    /**
+     * 리뷰 스케줄 생성
+     */
+    createReviewSchedule(memoryId: string, currentInterval: number, lastReviewDate: Date, features: SpacedRepetitionFeatures): ReviewSchedule;
+    /**
+     * 배치 리뷰 스케줄 생성
+     */
+    createBatchReviewSchedules(memories: Array<{
+        id: string;
+        current_interval: number;
+        last_review: Date;
+        importance: number;
+        usage: number;
+        helpful_feedback: number;
+        bad_feedback: number;
+    }>): ReviewSchedule[];
+    /**
+     * 리뷰 우선순위 계산
+     */
+    calculateReviewPriority(schedule: ReviewSchedule): number;
+    /**
+     * 리뷰 성과 분석
+     */
+    analyzeReviewPerformance(schedules: ReviewSchedule[], actualRecall: Map<string, boolean>): {
+        totalMemories: number;
+        reviewedMemories: number;
+        averageRecallRate: number;
+        performanceByInterval: Map<number, number>;
+    };
+    /**
+     * 최적 간격 추천
+     */
+    recommendOptimalInterval(currentInterval: number, recallHistory: boolean[], // 최근 리콜 성공/실패 기록
+    features: SpacedRepetitionFeatures): number;
+    /**
+     * 일수 계산
+     */
+    private getDaysSince;
+}
+//# sourceMappingURL=spaced-repetition.d.ts.map

package/dist/algorithms/spaced-repetition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaced-repetition.d.ts","sourceRoot":"","sources":["../../src/algorithms/spaced-repetition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,IAAI,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;gBAEnC,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAUtD;;;OAGG;IACH,qBAAqB,CACnB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,wBAAwB,GACjC,MAAM;IAYT;;;OAGG;IACH,0BAA0B,CACxB,mBAAmB,EAAE,MAAM,EAAE,OAAO;IACpC,QAAQ,EAAE,MAAM,GACf,MAAM;IAIT;;OAEG;IACH,WAAW,CACT,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAA6B,GACvC,OAAO;IAKV;;OAEG;IACH,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,IAAI,EACpB,QAAQ,EAAE,wBAAwB,GACjC,cAAc;IAkBjB;;OAEG;IACH,0BAA0B,CACxB,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,IAAI,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,GACD,cAAc,EAAE;IAkBnB;;OAEG;IACH,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM;IAQzD;;OAEG;IACH,wBAAwB,CACtB,SAAS,EAAE,cAAc,EAAE,EAC3B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC;QACD,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC5C;IAsCD;;OAEG;IACH,wBAAwB,CACtB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,OAAO,EAAE,EAAE,iBAAiB;IAC3C,QAAQ,EAAE,wBAAwB,GACjC,MAAM;IAqBT;;OAEG;IACH,OAAO,CAAC,YAAY;CAKrB"}

package/dist/algorithms/spaced-repetition.js

@@ -0,0 +1,153 @@
+/**
+ * 간격 반복 알고리즘 구현
+ * Memento-Goals.md의 간격 반복 공식 구현
+ */
+export class SpacedRepetitionAlgorithm {
+    weights;
+    recallThreshold = 0.7; // 리콜 임계값
+    constructor(weights) {
+        this.weights = {
+            importance: 0.6, // A1: 중요도 가중치
+            usage: 0.4, // A2: 사용성 가중치
+            helpful_feedback: 0.5, // A3: 도움됨 피드백 가중치
+            bad_feedback: 0.7, // A4: 나쁨 피드백 가중치
+            ...weights
+        };
+    }
+    /**
+     * 다음 리뷰 간격 계산
+     * interval = current_interval * (1 + A1*importance + A2*usage + A3*helpful - A4*bad)
+     */
+    calculateNextInterval(currentInterval, features) {
+        const { importance, usage, helpful_feedback, bad_feedback } = features;
+        const multiplier = 1 +
+            this.weights.importance * importance +
+            this.weights.usage * usage +
+            this.weights.helpful_feedback * helpful_feedback -
+            this.weights.bad_feedback * bad_feedback;
+        return Math.ceil(currentInterval * multiplier);
+    }
+    /**
+     * 리콜 확률 계산
+     * P = exp(-time_since_last_review / interval)
+     */
+    calculateRecallProbability(timeSinceLastReview, // 일 단위
+    interval) {
+        return Math.exp(-timeSinceLastReview / interval);
+    }
+    /**
+     * 리뷰 필요 여부 판단
+     */
+    needsReview(timeSinceLastReview, interval, threshold = this.recallThreshold) {
+        const recallProb = this.calculateRecallProbability(timeSinceLastReview, interval);
+        return recallProb <= threshold;
+    }
+    /**
+     * 리뷰 스케줄 생성
+     */
+    createReviewSchedule(memoryId, currentInterval, lastReviewDate, features) {
+        const nextInterval = this.calculateNextInterval(currentInterval, features);
+        const nextReview = new Date(lastReviewDate.getTime() + nextInterval * 24 * 60 * 60 * 1000);
+        const timeSinceLastReview = this.getDaysSince(lastReviewDate);
+        const recallProb = this.calculateRecallProbability(timeSinceLastReview, nextInterval);
+        const needsReview = this.needsReview(timeSinceLastReview, nextInterval);
+        return {
+            memory_id: memoryId,
+            current_interval: nextInterval,
+            next_review: nextReview,
+            recall_probability: recallProb,
+            needs_review: needsReview,
+            multiplier: nextInterval / currentInterval
+        };
+    }
+    /**
+     * 배치 리뷰 스케줄 생성
+     */
+    createBatchReviewSchedules(memories) {
+        return memories.map(memory => {
+            const features = {
+                importance: memory.importance,
+                usage: memory.usage,
+                helpful_feedback: memory.helpful_feedback,
+                bad_feedback: memory.bad_feedback
+            };
+            return this.createReviewSchedule(memory.id, memory.current_interval, memory.last_review, features);
+        });
+    }
+    /**
+     * 리뷰 우선순위 계산
+     */
+    calculateReviewPriority(schedule) {
+        // 리콜 확률이 낮을수록, 간격이 길수록 우선순위 높음
+        const urgencyScore = 1 - schedule.recall_probability;
+        const intervalScore = Math.log(schedule.current_interval + 1) / 10; // 정규화
+        return urgencyScore + intervalScore;
+    }
+    /**
+     * 리뷰 성과 분석
+     */
+    analyzeReviewPerformance(schedules, actualRecall // memory_id -> recall_success
+    ) {
+        const totalMemories = schedules.length;
+        const reviewedMemories = schedules.filter(s => s.needs_review).length;
+        let totalRecallRate = 0;
+        let recallCount = 0;
+        const performanceByInterval = new Map();
+        for (const schedule of schedules) {
+            if (actualRecall.has(schedule.memory_id)) {
+                const recalled = actualRecall.get(schedule.memory_id);
+                totalRecallRate += recalled ? 1 : 0;
+                recallCount++;
+                const interval = Math.floor(schedule.current_interval / 7) * 7; // 주 단위로 그룹화
+                const current = performanceByInterval.get(interval) || { total: 0, successful: 0 };
+                current.total++;
+                if (recalled)
+                    current.successful++;
+                performanceByInterval.set(interval, current);
+            }
+        }
+        const averageRecallRate = recallCount > 0 ? totalRecallRate / recallCount : 0;
+        // 간격별 성과 계산
+        const performanceByIntervalRate = new Map();
+        for (const [interval, stats] of performanceByInterval) {
+            performanceByIntervalRate.set(interval, stats.successful / stats.total);
+        }
+        return {
+            totalMemories,
+            reviewedMemories,
+            averageRecallRate,
+            performanceByInterval: performanceByIntervalRate
+        };
+    }
+    /**
+     * 최적 간격 추천
+     */
+    recommendOptimalInterval(currentInterval, recallHistory, // 최근 리콜 성공/실패 기록
+    features) {
+        if (recallHistory.length === 0) {
+            return currentInterval;
+        }
+        // 최근 성과 기반 조정
+        const recentPerformance = recallHistory.slice(-5); // 최근 5회
+        const successRate = recentPerformance.filter(success => success).length / recentPerformance.length;
+        // 성과에 따른 조정 계수
+        let adjustmentFactor = 1.0;
+        if (successRate > 0.8) {
+            adjustmentFactor = 1.2; // 성과 좋으면 간격 늘림
+        }
+        else if (successRate < 0.6) {
+            adjustmentFactor = 0.8; // 성과 나쁘면 간격 줄임
+        }
+        const baseInterval = this.calculateNextInterval(currentInterval, features);
+        return Math.ceil(baseInterval * adjustmentFactor);
+    }
+    /**
+     * 일수 계산
+     */
+    getDaysSince(date) {
+        const now = new Date();
+        const diffTime = now.getTime() - date.getTime();
+        return diffTime / (1000 * 60 * 60 * 24);
+    }
+}
+//# sourceMappingURL=spaced-repetition.js.map

package/dist/algorithms/spaced-repetition.js.map

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

package/dist/algorithms/vector-search-engine.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 벡터 검색 엔진
+ * sqlite-vec를 사용한 벡터 유사도 검색
+ * Memento MCP Server의 핵심 벡터 검색 컴포넌트
+ */
+import Database from 'better-sqlite3';
+export interface VectorSearchResult {
+    memory_id: string;
+    similarity: number;
+    content: string;
+    type: string;
+    importance: number;
+    created_at: string;
+    last_accessed?: string;
+    pinned: boolean;
+    tags?: string[];
+}
+export interface VectorSearchOptions {
+    limit?: number;
+    threshold?: number;
+    type?: string;
+    includeContent?: boolean;
+    includeMetadata?: boolean;
+}
+export interface VectorIndexStatus {
+    available: boolean;
+    tableExists: boolean;
+    recordCount: number;
+    dimensions: number;
+    vecExtensionLoaded: boolean;
+}
+export declare class VectorSearchEngine {
+    private db;
+    private isVecAvailable;
+    private vecExtensionLoaded;
+    private readonly defaultDimensions;
+    private readonly defaultThreshold;
+    private readonly defaultLimit;
+    constructor();
+    /**
+     * 제공자별 vec0 테이블명 반환
+     */
+    private getVectorTableName;
+    /**
+     * 데이터베이스 초기화
+     */
+    initialize(db: Database.Database): void;
+    /**
+     * VEC 사용 가능 여부 확인
+     * sqlite-vec 확장 로드 여부와 테이블 존재를 모두 확인
+     */
+    private checkVecAvailability;
+    /**
+     * 벡터 검색 실행
+     */
+    search(queryVector: number[], options?: VectorSearchOptions, provider?: string): Promise<VectorSearchResult[]>;
+    /**
+     * 하이브리드 검색 (벡터 + 메타데이터)
+     * SQLite 호환성을 위해 LEFT JOIN 사용
+     */
+    hybridSearch(queryVector: number[], textQuery: string, options?: VectorSearchOptions, provider?: string): Promise<VectorSearchResult[]>;
+    /**
+     * 벡터 인덱스 상태 확인
+     */
+    getIndexStatus(): VectorIndexStatus;
+    /**
+     * 벡터 인덱스 재구성
+     */
+    rebuildIndex(): Promise<boolean>;
+    /**
+     * 벡터 검색 성능 테스트
+     */
+    performanceTest(queryVector: number[], iterations?: number): Promise<{
+        averageTime: number;
+        minTime: number;
+        maxTime: number;
+        results: number;
+        successRate: number;
+    }>;
+    /**
+     * 벡터 차원 확인
+     */
+    getDimensions(): number;
+    /**
+     * VEC 사용 가능 여부 확인
+     */
+    isAvailable(): boolean;
+    /**
+     * 데이터베이스 연결 상태 확인
+     */
+    isConnected(): boolean;
+}
+export declare function getVectorSearchEngine(): VectorSearchEngine;
+export declare function createVectorSearchEngine(): VectorSearchEngine;
+export declare function resetVectorSearchEngine(): void;
+//# sourceMappingURL=vector-search-engine.d.ts.map