memento-mcp-server 1.13.1-a2 → 1.13.1-a4

package/dist/algorithms/hybrid-search-engine.js

@@ -1,1042 +0,0 @@
-/**
- * 텍스트 검색과 벡터 검색을 결합하여 검색 정확도와 포괄성을 동시에 확보합니다.
- * FTS5 전문 검색과 벡터 유사도 검색을 병렬로 수행하여 각각의 장점을 활용합니다.
- */
-import { SearchEngine } from './search-engine.js';
-import { MemoryEmbeddingService } from '../services/memory-embedding-service.js';
-import { UnifiedEmbeddingService } from '../services/unified-embedding-service.js';
-import { getVectorSearchEngine } from './vector-search-engine.js';
-import Database from 'better-sqlite3';
-import { SearchRanking } from './search-ranking.js';
-import { mementoConfig } from '../config/index.js';
-import { RelationGraph } from '../services/relation-graph.js';
-import { getRankingWeights } from '../config/ranking-weights-loader.js';
-// 검색 관련 상수
-/**
- * 개별 provider의 검색 작업이 지연되어 전체 검색 성능에 영향을 주지 않도록 제한합니다.
- * 각 provider별 검색 작업이 이 시간 내에 완료되지 않으면 타임아웃 처리하여 응답성을 보장합니다.
- */
-const PROVIDER_SEARCH_TIMEOUT_MS = 2000;
-/**
- * 전체 검색 프로세스가 무한정 대기하지 않도록 최대 대기 시간을 설정합니다.
- * 모든 provider 검색이 이 시간 내에 완료되지 않으면 현재까지 완료된 결과만 반환하여 사용자 경험을 보장합니다.
- * 개별 provider 타임아웃보다 충분히 길게 설정하여 병렬 실행의 이점을 활용합니다.
- */
-const OVERALL_SEARCH_TIMEOUT_MS = 5000;
-/**
- * 중복 제거 과정에서 일부 결과가 제외될 수 있으므로 충분한 후보를 확보합니다.
- * 더 많은 결과를 가져와서 최종 결과의 품질과 다양성을 보장합니다.
- */
-const VECTOR_SEARCH_LIMIT_MULTIPLIER = 2;
-/**
- * 관련성이 낮은 벡터 검색 결과는 사용자에게 유용하지 않으므로 필터링하여 검색 품질을 향상시킵니다.
- * 이 값보다 낮은 similarity를 가진 결과는 노이즈에 가까우므로 제외하여 검색 정확도를 높입니다.
- */
-const VECTOR_SEARCH_THRESHOLD = 0.5;
-// 검색 과정에서 발생할 수 있는 다양한 오류를 분류하여 정확한 오류 처리를 수행합니다.
-export var SearchErrorType;
-(function (SearchErrorType) {
-    SearchErrorType["EMBEDDING_GENERATION_FAILED"] = "EMBEDDING_GENERATION_FAILED";
-    SearchErrorType["VECTOR_SEARCH_FAILED"] = "VECTOR_SEARCH_FAILED";
-    SearchErrorType["TEXT_SEARCH_FAILED"] = "TEXT_SEARCH_FAILED";
-    SearchErrorType["RESULT_COMBINATION_FAILED"] = "RESULT_COMBINATION_FAILED";
-    SearchErrorType["DATABASE_CONNECTION_FAILED"] = "DATABASE_CONNECTION_FAILED";
-    SearchErrorType["INVALID_QUERY"] = "INVALID_QUERY";
-    SearchErrorType["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
-})(SearchErrorType || (SearchErrorType = {}));
-export class SearchError extends Error {
-    type;
-    originalError;
-    context;
-    constructor(type, message, originalError, context) {
-        super(message);
-        this.type = type;
-        this.originalError = originalError;
-        this.context = context;
-        this.name = 'SearchError';
-    }
-}
-// 단일 책임 원칙을 준수하여 각 기능을 독립적인 클래스로 분리하여 유지보수성을 향상시키기 위해
-export class SearchResultCombiner {
-    combine(textResults, vectorResults, textWeight, vectorWeight) {
-        const resultMap = new Map();
-        // 텍스트 검색 결과를 먼저 추가하여 기본 점수를 설정합니다.
-        textResults.forEach(result => {
-            const textScore = typeof result.score === 'number' ? result.score : 0;
-            resultMap.set(result.id, {
-                id: result.id,
-                content: result.content,
-                type: result.type,
-                importance: result.importance,
-                created_at: result.created_at,
-                last_accessed: result.last_accessed,
-                pinned: result.pinned,
-                tags: result.tags,
-                textScore: textScore,
-                vectorScore: 0,
-                finalScore: textScore * textWeight,
-                recall_reason: result.recall_reason || '텍스트 검색 결과',
-            });
-        });
-        // 벡터 검색 결과를 추가하거나 기존 텍스트 결과와 결합하여 하이브리드 점수를 계산합니다.
-        vectorResults.forEach(result => {
-            const existing = resultMap.get(result.id);
-            if (existing) {
-                // 텍스트와 벡터 검색 모두에서 발견된 결과를 업데이트하여 종합 점수를 계산합니다.
-                existing.vectorScore = result.similarity;
-                existing.finalScore = (existing.textScore * textWeight) + (result.similarity * vectorWeight);
-                existing.recall_reason = this.generateHybridReason(existing.textScore, result.similarity);
-            }
-            else {
-                // 벡터 검색에서만 발견된 결과를 추가하여 검색 포괄성을 확보합니다.
-                resultMap.set(result.id, {
-                    id: result.id,
-                    content: result.content,
-                    type: result.type,
-                    importance: result.importance,
-                    created_at: result.created_at,
-                    last_accessed: result.last_accessed,
-                    pinned: result.pinned,
-                    tags: result.tags,
-                    textScore: 0,
-                    vectorScore: result.similarity,
-                    finalScore: result.similarity * vectorWeight,
-                    recall_reason: `벡터 유사도: ${result.similarity.toFixed(3)}`,
-                });
-            }
-        });
-        return Array.from(resultMap.values());
-    }
-    generateHybridReason(textScore, vectorScore) {
-        const reasons = [];
-        if (textScore > 0.7) {
-            reasons.push('텍스트 매칭 우수');
-        }
-        if (vectorScore > 0.8) {
-            reasons.push('의미적 유사도 높음');
-        }
-        if (textScore > 0.5 && vectorScore > 0.5) {
-            reasons.push('텍스트+벡터 결합');
-        }
-        return reasons.length > 0 ? reasons.join(', ') : '하이브리드 검색';
-    }
-}
-export class AdaptiveWeightCalculator {
-    adaptiveWeights = new Map();
-    calculateWeights(query, vectorWeight, textWeight) {
-        const queryKey = this.normalizeQuery(query);
-        // 이전에 계산된 가중치를 재사용하여 일관성 있는 검색 결과를 제공하고 성능을 최적화합니다.
-        if (this.adaptiveWeights.has(queryKey)) {
-            return this.adaptiveWeights.get(queryKey);
-        }
-        // 쿼리의 특성을 분석하여 최적의 가중치를 결정합니다.
-        const queryAnalysis = this.analyzeQuery(query);
-        // 쿼리 특성에 따라 벡터 검색과 텍스트 검색의 가중치를 동적으로 조정하여 검색 정확도를 향상시키기 위해
-        let adjustedVectorWeight = vectorWeight;
-        let adjustedTextWeight = textWeight;
-        if (queryAnalysis.isTechnicalTerm) {
-            // 기술 용어는 의미적 유사성이 중요하므로 벡터 검색에 더 높은 가중치를 부여합니다.
-            adjustedVectorWeight = Math.min(0.8, vectorWeight + 0.2);
-            adjustedTextWeight = Math.max(0.2, textWeight - 0.2);
-        }
-        else if (queryAnalysis.isPhrase) {
-            // 구문 검색은 정확한 단어 매칭이 중요하므로 텍스트 검색에 더 높은 가중치를 부여합니다.
-            adjustedVectorWeight = Math.max(0.2, vectorWeight - 0.2);
-            adjustedTextWeight = Math.min(0.8, textWeight + 0.2);
-        }
-        else if (queryAnalysis.isShortQuery) {
-            // 짧은 쿼리는 키워드 매칭이 제한적이므로 의미적 유사성을 활용하는 벡터 검색에 더 의존합니다.
-            adjustedVectorWeight = Math.min(0.7, vectorWeight + 0.1);
-            adjustedTextWeight = Math.max(0.3, textWeight - 0.1);
-        }
-        // 가중치의 합이 1이 되도록 정규화하여 일관된 점수 범위를 유지합니다.
-        const totalWeight = adjustedVectorWeight + adjustedTextWeight;
-        const normalizedVectorWeight = adjustedVectorWeight / totalWeight;
-        const normalizedTextWeight = adjustedTextWeight / totalWeight;
-        const weights = { vectorWeight: normalizedVectorWeight, textWeight: normalizedTextWeight };
-        this.adaptiveWeights.set(queryKey, weights);
-        return weights;
-    }
-    analyzeQuery(query) {
-        const normalizedQuery = query.toLowerCase().trim();
-        return {
-            isTechnicalTerm: /^(api|sql|http|json|xml|css|html|js|ts|react|vue|angular|node|python|java|c\+\+|go|rust|docker|kubernetes|aws|azure|gcp)$/i.test(normalizedQuery),
-            isPhrase: normalizedQuery.includes(' ') && normalizedQuery.split(' ').length >= 3,
-            isShortQuery: normalizedQuery.length <= 10
-        };
-    }
-    normalizeQuery(query) {
-        return query.toLowerCase().trim().replace(/\s+/g, ' ');
-    }
-}
-export class SearchLogger {
-    logSearchStart(searchId, query) {
-        // console.log(`🔍 [${searchId}] 하이브리드 검색 시작`, {
-        //   query: query.query,
-        //   limit: query.limit,
-        //   vectorWeight: query.vectorWeight,
-        //   textWeight: query.textWeight,
-        //   filters: query.filters,
-        //   experiment_id: query.experiment_id
-        // });
-    }
-    logSearchStep(searchId, step, data) {
-        console.log(`🔍 [${searchId}] ${step}`, data);
-    }
-    logSearchComplete(searchId, result, queryTime) {
-        // console.log(`✅ [${searchId}] 하이브리드 검색 완료`, {
-        //   resultCount: result.items.length,
-        //   totalCount: result.total_count,
-        //   queryTime: `${queryTime.toFixed(2)}ms`,
-        //   searchType: 'hybrid',
-        //   experiment_id: (result as any).experiment_id
-        // });
-    }
-    logSearchError(searchId, error, query) {
-        // console.error(`❌ [${searchId}] 하이브리드 검색 에러`, {
-        //   error: error instanceof Error ? error.message : String(error),
-        //   stack: error instanceof Error ? error.stack : undefined,
-        //   query: query.query,
-        //   limit: query.limit,
-        //   experiment_id: query.experiment_id
-        // });
-    }
-    /**
-     * A/B 테스트를 통해 검색 알고리즘의 효과를 측정하고 개선합니다.
-     * 실험 ID와 변이 파라미터를 로깅하여 데이터 기반 의사결정을 지원합니다.
-     */
-    logExperiment(searchId, experimentId, variant) {
-        // console.log(`🧪 [${searchId}] 실험 로그`, {
-        //   experiment_id: experimentId,
-        //   variant,
-        //   timestamp: new Date().toISOString()
-        // });
-    }
-}
-export class HybridSearchEngine {
-    textSearchEngine;
-    embeddingService;
-    vectorSearchEngine;
-    resultCombiner;
-    weightCalculator;
-    logger;
-    queryEmbeddingService;
-    defaultVectorWeight = 0.6; // 의미적 유사성을 더 중요하게 평가하여 검색 정확도를 향상시키기 위해
-    defaultTextWeight = 0.4; // 정확한 키워드 매칭도 일정 비율로 반영하여 검색 포괄성을 확보합니다.
-    searchStats = new Map();
-    ranking;
-    relationGraph = null;
-    constructor(textSearchEngine, embeddingService, vectorSearchEngine, resultCombiner, weightCalculator, logger, queryEmbeddingService = new UnifiedEmbeddingService(), relationGraph) {
-        this.textSearchEngine = textSearchEngine;
-        this.embeddingService = embeddingService;
-        this.vectorSearchEngine = vectorSearchEngine;
-        this.resultCombiner = resultCombiner;
-        this.weightCalculator = weightCalculator;
-        this.logger = logger;
-        this.queryEmbeddingService = queryEmbeddingService;
-        // 외부 설정 파일에서 가중치를 로드하여 런타임에 조정 가능하도록 합니다.
-        const config = getRankingWeights();
-        this.ranking = new SearchRanking({
-            relevance: config.ranking_weights.alpha,
-            recency: config.ranking_weights.beta,
-            importance: config.ranking_weights.gamma,
-            usage: config.ranking_weights.delta,
-            relation_weight: config.ranking_weights.zeta,
-            duplication_penalty: config.ranking_weights.epsilon
-        });
-        this.relationGraph = relationGraph || null;
-    }
-    /**
-     * 관계 그래프를 주입하여 관계 기반 검색 기능을 활성화합니다.
-     * 선택적으로 설정하여 관계 그래프가 없는 환경에서도 동작하도록 합니다.
-     */
-    setRelationGraph(relationGraph) {
-        this.relationGraph = relationGraph;
-    }
-    /**
-     * 텍스트 검색과 벡터 검색을 병렬로 실행하고 결과를 결합하여 최적의 검색 결과를 제공합니다.
-     * 쿼리 특성에 따라 적응형 가중치를 적용하여 검색 정확도를 향상시키기 위해
-     */
-    async search(db, query) {
-        const searchId = this.generateSearchId();
-        const startTime = process.hrtime.bigint();
-        try {
-            this.logger.logSearchStart(searchId, query);
-            // 쿼리 특성에 따라 최적의 가중치를 계산하여 검색 정확도를 향상시키기 위해
-            const weights = this.calculateAdaptiveWeights(query);
-            this.logger.logSearchStep(searchId, '적응형 가중치 계산 완료', weights);
-            // A/B 테스트를 위한 실험 파라미터를 로깅하여 데이터 기반 개선을 지원합니다.
-            if (query.experiment_id) {
-                const config = getRankingWeights();
-                const variant = {
-                    ranking_weights: {
-                        alpha: config.ranking_weights.alpha,
-                        beta: config.ranking_weights.beta,
-                        gamma: config.ranking_weights.gamma,
-                        delta: config.ranking_weights.delta,
-                        zeta: config.ranking_weights.zeta,
-                        epsilon: config.ranking_weights.epsilon
-                    },
-                    adaptive_weights: {
-                        vectorWeight: weights.vectorWeight,
-                        textWeight: weights.textWeight
-                    },
-                    relation_weights: {
-                        max_relations: config.relation_weights.max_relations
-                    }
-                };
-                if (this.logger.logExperiment) {
-                    this.logger.logExperiment(searchId, query.experiment_id, variant);
-                }
-                else {
-                    // logExperiment 메서드가 없는 경우 일반 로그로 대체하여 호환성을 유지합니다.
-                    this.logger.logSearchStep(searchId, '실험 파라미터', {
-                        experiment_id: query.experiment_id,
-                        variant
-                    });
-                }
-            }
-            // FTS5 전문 검색을 실행하여 정확한 키워드 매칭 결과를 획득합니다.
-            const textResults = await this.executeTextSearch(db, query, searchId);
-            // 벡터 유사도 검색을 실행하여 의미적으로 관련된 결과를 획득합니다.
-            const vectorResults = await this.executeVectorSearch(db, query, searchId);
-            // 텍스트와 벡터 검색 결과를 결합하고 통합 점수와 관계 가중치를 조회하여 최종 정렬합니다.
-            const finalResults = await this.combineAndSortResults(textResults, vectorResults, weights, query.limit || 10, db, query.includeRelations || false);
-            // 검색 통계를 업데이트하여 향후 가중치 조정에 활용합니다.
-            this.updateSearchStats(query.query, textResults.length, vectorResults.length);
-            const queryTime = this.calculateQueryTime(startTime);
-            // A/B 테스트 추적을 위해 검색 완료 로그에 실험 ID를 포함합니다.
-            const logData = {
-                items: finalResults,
-                total_count: finalResults.length
-            };
-            if (query.experiment_id) {
-                logData.experiment_id = query.experiment_id;
-            }
-            this.logger.logSearchComplete(searchId, logData, queryTime);
-            return {
-                items: finalResults,
-                total_count: finalResults.length,
-                query_time: queryTime
-            };
-        }
-        catch (error) {
-            this.logger.logSearchError(searchId, error, query);
-            throw error;
-        }
-    }
-    generateSearchId() {
-        return `search_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-    }
-    calculateAdaptiveWeights(query) {
-        const vectorWeight = query.vectorWeight ?? this.defaultVectorWeight;
-        const textWeight = query.textWeight ?? this.defaultTextWeight;
-        const adaptiveWeights = this.weightCalculator.calculateWeights(query.query, vectorWeight, textWeight);
-        return {
-            vectorWeight: adaptiveWeights.vectorWeight,
-            textWeight: adaptiveWeights.textWeight,
-            originalVector: vectorWeight,
-            originalText: textWeight
-        };
-    }
-    async executeTextSearch(db, query, searchId) {
-        try {
-            const textSearchStart = process.hrtime.bigint();
-            this.logger.logSearchStep(searchId, '텍스트 검색 시작', { query: query.query });
-            const textSearchResult = await this.textSearchEngine.search(db, {
-                query: query.query,
-                filters: query.filters,
-                limit: (query.limit || 10) * 2,
-            });
-            const textSearchTime = Number(process.hrtime.bigint() - textSearchStart) / 1_000_000;
-            this.logger.logSearchStep(searchId, '텍스트 검색 완료', {
-                resultCount: textSearchResult.items.length,
-                searchTime: `${textSearchTime.toFixed(2)}ms`
-            });
-            return textSearchResult.items;
-        }
-        catch (error) {
-            throw new SearchError(SearchErrorType.TEXT_SEARCH_FAILED, '텍스트 검색 실행 중 오류가 발생했습니다', error instanceof Error ? error : new Error(String(error)), { query: query.query, searchId });
-        }
-    }
-    async executeVectorSearch(db, query, searchId) {
-        const vectorSearchStart = process.hrtime.bigint();
-        this.logger.logSearchStep(searchId, '벡터 검색 시작', {
-            query: query.query,
-            embeddingAvailable: this.embeddingService.isAvailable()
-        });
-        this.vectorSearchEngine.initialize(db);
-        if (this.vectorSearchEngine.getIndexStatus().available) {
-            return await this.executeVecSearch(db, query, searchId, vectorSearchStart);
-        }
-        else {
-            return await this.executeFallbackSearch(db, query, searchId, vectorSearchStart);
-        }
-    }
-    /**
-     * 벡터 검색 실행 (다중 provider 지원)
-     *
-     * @param db - 데이터베이스 연결
-     * @param query - 하이브리드 검색 쿼리
-     * @param searchId - 검색 ID (로깅용)
-     * @param startTime - 시작 시간 (성능 측정용)
-     * @returns 벡터 검색 결과 배열
-     */
-    async executeVecSearch(db, query, searchId, startTime) {
-        try {
-            // 데이터베이스에 저장된 모든 임베딩 provider를 감지하여 사용 가능한 검색 방법을 파악합니다.
-            const detectedProviders = await this.detectAllStoredEmbeddingProviders(db);
-            // provider 필터링
-            const providersToSearch = this.filterProvidersToSearch(detectedProviders, query.provider_filter, searchId);
-            if (providersToSearch.length === 0) {
-                return [];
-            }
-            // 여러 provider를 병렬로 검색하여 검색 속도를 향상시키고 포괄성을 확보합니다.
-            const searchOptions = {
-                limit: (query.limit || 10) * VECTOR_SEARCH_LIMIT_MULTIPLIER,
-                threshold: VECTOR_SEARCH_THRESHOLD,
-                types: query.filters?.type,
-                includeContent: true
-            };
-            // 각 provider에 대해 독립적인 검색 작업을 생성하여 병렬 실행을 준비합니다.
-            const searchPromises = providersToSearch.map(provider => this.createProviderSearchTask(provider, query.query, searchOptions, searchId));
-            // 모든 provider 검색을 실행하고 타임아웃을 관리하여 안정적인 결과 수집을 보장합니다.
-            const { allResults, providerStats, overallTimeoutOccurred } = await this.executeProviderSearchesWithTimeout(searchPromises, providersToSearch, searchId);
-            // 여러 provider의 결과를 정규화하고 중복을 제거하여 일관된 결과를 제공합니다.
-            const vectorResults = this.normalizeAndDeduplicateResults(allResults);
-            const totalTime = Number(process.hrtime.bigint() - startTime) / 1_000_000;
-            this.logger.logSearchStep(searchId, 'VEC 벡터 검색 완료', {
-                resultCount: vectorResults.length,
-                totalVectorTime: `${totalTime.toFixed(2)}ms`,
-                providerStats,
-                searchedProviders: providersToSearch.length,
-                successfulProviders: providerStats.filter(s => s.success).length,
-                overallTimeoutOccurred
-            });
-            return vectorResults;
-        }
-        catch (error) {
-            this.logger.logSearchStep(searchId, 'VEC 벡터 검색 실패, fallback 사용', {
-                error: error instanceof Error ? error.message : String(error)
-            });
-            return await this.executeFallbackSearch(db, query, searchId, startTime);
-        }
-    }
-    /**
-     * Provider 필터링
-     *
-     * @param detectedProviders - 감지된 모든 provider 목록
-     * @param providerFilter - 필터링할 provider 목록 (선택적, 빈 배열이면 undefined로 처리되어 모든 provider 검색)
-     * @param searchId - 검색 ID (로깅용)
-     * @returns 필터링된 provider 목록
-     */
-    filterProvidersToSearch(detectedProviders, providerFilter, searchId) {
-        let providersToSearch = detectedProviders.map(p => p.provider);
-        // 사용자가 특정 provider만 검색하도록 요청한 경우에만 필터링합니다.
-        // 빈 배열은 모든 provider를 검색하도록 처리하여 유연성을 제공합니다.
-        if (providerFilter && providerFilter.length > 0) {
-            providersToSearch = providersToSearch.filter(p => providerFilter.includes(p));
-        }
-        // 검색할 provider가 없는 경우를 로깅하여 문제를 진단할 수 있도록 합니다.
-        if (providersToSearch.length === 0) {
-            this.logger.logSearchStep(searchId, 'VEC 벡터 검색 - 검색할 provider 없음', {
-                detectedProviders: detectedProviders.map(p => p.provider),
-                providerFilter: providerFilter || []
-            });
-        }
-        return providersToSearch;
-    }
-    /**
-     * 단일 provider 검색 작업 생성 (타임아웃 포함)
-     *
-     * @param provider - 검색할 provider
-     * @param query - 검색 쿼리 문자열
-     * @param searchOptions - 검색 옵션
-     * @param searchId - 검색 ID (로깅용)
-     * @returns 검색 결과 Promise (타임아웃 포함)
-     */
-    createProviderSearchTask(provider, query, searchOptions, searchId) {
-        const providerStartTime = process.hrtime.bigint();
-        // 타임아웃 Promise 생성
-        const timeoutPromise = new Promise((resolve) => {
-            setTimeout(() => {
-                const providerTime = Number(process.hrtime.bigint() - providerStartTime) / 1_000_000;
-                resolve({
-                    provider,
-                    results: [],
-                    success: false,
-                    timeMs: providerTime,
-                    error: `Provider 검색 타임아웃 (${PROVIDER_SEARCH_TIMEOUT_MS}ms 초과)`
-                });
-            }, PROVIDER_SEARCH_TIMEOUT_MS);
-        });
-        // 실제 검색 작업 Promise
-        const searchTask = (async () => {
-            try {
-                // 각 provider에 맞는 쿼리 임베딩 생성
-                const queryVector = await this.generateQueryVector(query, searchId, provider);
-                // 벡터 검색 실행
-                const vecResults = await this.vectorSearchEngine.search(queryVector, searchOptions, provider);
-                const providerTime = Number(process.hrtime.bigint() - providerStartTime) / 1_000_000;
-                return {
-                    provider,
-                    results: vecResults.map(result => ({
-                        id: result.memory_id,
-                        content: result.content,
-                        type: result.type,
-                        importance: result.importance,
-                        created_at: result.created_at,
-                        pinned: false,
-                        score: result.similarity,
-                        similarity: result.similarity,
-                        provider // provider 정보 추가
-                    })),
-                    success: true,
-                    timeMs: providerTime,
-                    error: null
-                };
-            }
-            catch (error) {
-                const providerTime = Number(process.hrtime.bigint() - providerStartTime) / 1_000_000;
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                this.logger.logSearchStep(searchId, `VEC 벡터 검색 실패 - ${provider}`, {
-                    provider,
-                    error: errorMessage,
-                    timeMs: providerTime
-                });
-                return {
-                    provider,
-                    results: [],
-                    success: false,
-                    timeMs: providerTime,
-                    error: errorMessage
-                };
-            }
-        })();
-        // Promise.race로 타임아웃과 검색 작업 중 먼저 완료되는 것 반환
-        return Promise.race([searchTask, timeoutPromise]);
-    }
-    /**
-     * 모든 provider 검색 실행 및 결과 수집 (전체 타임아웃 포함)
-     *
-     * @param searchPromises - 각 provider별 검색 Promise 배열
-     * @param providersToSearch - 검색할 provider 목록
-     * @param searchId - 검색 ID (로깅용)
-     * @returns 검색 결과 및 통계
-     */
-    async executeProviderSearchesWithTimeout(searchPromises, providersToSearch, searchId) {
-        // 전체 검색 프로세스의 최대 타임아웃을 설정하여 무한 대기를 방지합니다.
-        // 모든 provider가 타임아웃되어도 부분 결과라도 반환하여 사용자 경험을 보장합니다.
-        // 개별 provider 타임아웃보다 충분히 길게 설정하여 병렬 실행의 이점을 활용합니다.
-        let overallTimeoutOccurred = false;
-        let overallTimeoutHandle = null;
-        const overallTimeoutPromise = new Promise((resolve) => {
-            overallTimeoutHandle = setTimeout(() => {
-                overallTimeoutOccurred = true;
-                this.logger.logSearchStep(searchId, 'VEC 벡터 검색 전체 타임아웃', {
-                    timeoutMs: OVERALL_SEARCH_TIMEOUT_MS,
-                    message: '전체 검색 프로세스 타임아웃 발생 - 현재까지 완료된 결과만 반환'
-                });
-                resolve();
-            }, OVERALL_SEARCH_TIMEOUT_MS);
-        });
-        // 타임아웃 타이머를 정리하여 메모리 누수를 방지합니다.
-        const cleanupTimeout = () => {
-            if (overallTimeoutHandle !== null) {
-                clearTimeout(overallTimeoutHandle);
-                overallTimeoutHandle = null;
-            }
-        };
-        try {
-            // Promise.allSettled()를 사용하여 일부 provider가 실패해도 나머지 검색이 계속 진행되도록 합니다.
-            // 전체 타임아웃과 병렬 검색 중 먼저 완료되는 것을 사용하여 응답성을 보장합니다.
-            const searchResults = await Promise.race([
-                Promise.allSettled(searchPromises).then(results => {
-                    cleanupTimeout();
-                    return results;
-                }),
-                overallTimeoutPromise.then(() => {
-                    // 타임아웃 발생 시 현재까지 완료된 Promise만 수집하여 부분 결과라도 반환합니다.
-                    // Promise.allSettled는 이미 실행 중이므로 결과를 기다림
-                    return Promise.allSettled(searchPromises);
-                })
-            ]);
-            // 성공한 검색 결과만 수집하여 신뢰할 수 있는 결과만 반환합니다.
-            const allResults = [];
-            const providerStats = [];
-            searchResults.forEach((result, index) => {
-                if (result.status === 'fulfilled') {
-                    const providerResult = result.value;
-                    providerStats.push({
-                        provider: providerResult.provider,
-                        resultCount: providerResult.results.length,
-                        success: providerResult.success,
-                        timeMs: providerResult.timeMs,
-                        error: providerResult.error || undefined
-                    });
-                    // 타임아웃 또는 실패 시 상세 로깅하여 문제 진단과 모니터링을 지원합니다.
-                    if (!providerResult.success) {
-                        const isTimeout = providerResult.error?.includes('타임아웃');
-                        this.logger.logSearchStep(searchId, `VEC 벡터 검색 실패 - ${providerResult.provider}`, {
-                            provider: providerResult.provider,
-                            error: providerResult.error,
-                            timeMs: providerResult.timeMs,
-                            isTimeout,
-                            resultCount: providerResult.results.length
-                        });
-                    }
-                    if (providerResult.success) {
-                        allResults.push(...providerResult.results);
-                    }
-                }
-                else {
-                    // Promise 자체가 실패한 예외적인 경우를 처리하여 시스템 안정성을 보장합니다.
-                    const provider = providersToSearch[index];
-                    if (!provider) {
-                        // provider가 없는 예외적인 경우를 스킵하여 오류를 방지합니다.
-                        return;
-                    }
-                    const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);
-                    providerStats.push({
-                        provider,
-                        resultCount: 0,
-                        success: false,
-                        timeMs: 0,
-                        error: errorMessage
-                    });
-                    this.logger.logSearchStep(searchId, `VEC 벡터 검색 Promise 실패 - ${provider}`, {
-                        provider,
-                        error: errorMessage,
-                        isTimeout: false
-                    });
-                }
-            });
-            return { allResults, providerStats, overallTimeoutOccurred };
-        }
-        finally {
-            // 예외 발생 시에도 타임아웃 타이머를 정리하여 메모리 누수를 방지합니다.
-            cleanupTimeout();
-        }
-    }
-    /**
-     * 결과 정규화 및 중복 제거
-     * Provider별로 Min-Max 정규화를 수행하고, 중복된 memory_id는 최고 점수만 유지
-     *
-     * @param allResults - 모든 provider의 검색 결과
-     * @returns 정규화 및 중복 제거된 결과 배열
-     */
-    normalizeAndDeduplicateResults(allResults) {
-        const resultsByProvider = this.groupResultsByProvider(allResults);
-        const normalizedResults = this.normalizeResultsByProvider(resultsByProvider);
-        const deduplicatedResults = this.deduplicateResults(normalizedResults);
-        return this.rankResults(deduplicatedResults);
-    }
-    /**
-     * Provider별로 결과 그룹화
-     */
-    groupResultsByProvider(allResults) {
-        const resultsByProvider = new Map();
-        allResults.forEach(result => {
-            const provider = result.provider;
-            if (!resultsByProvider.has(provider)) {
-                resultsByProvider.set(provider, []);
-            }
-            const providerResults = resultsByProvider.get(provider);
-            if (providerResults) {
-                providerResults.push(result);
-            }
-        });
-        return resultsByProvider;
-    }
-    /**
-     * Provider별로 Min-Max 정규화 수행
-     */
-    normalizeResultsByProvider(resultsByProvider) {
-        const normalizedResults = [];
-        resultsByProvider.forEach((results) => {
-            if (results.length === 0) {
-                return;
-            }
-            const scores = results.map(r => r.similarity);
-            const minScore = Math.min(...scores);
-            const maxScore = Math.max(...scores);
-            // 모든 점수가 동일한 경우 원본 점수 유지, 그 외에는 Min-Max 정규화
-            if (maxScore === minScore) {
-                results.forEach(result => {
-                    normalizedResults.push({
-                        ...result,
-                        normalizedScore: result.similarity
-                    });
-                });
-            }
-            else {
-                results.forEach(result => {
-                    const normalizedScore = (result.similarity - minScore) / (maxScore - minScore);
-                    normalizedResults.push({
-                        ...result,
-                        normalizedScore
-                    });
-                });
-            }
-        });
-        return normalizedResults;
-    }
-    /**
-     * 중복 제거 (memory_id 기준, 정규화된 점수 중 최고 점수만 유지)
-     */
-    deduplicateResults(normalizedResults) {
-        const resultMap = new Map();
-        normalizedResults.forEach(result => {
-            const existing = resultMap.get(result.id);
-            if (!existing || result.normalizedScore > existing.normalizedScore) {
-                resultMap.set(result.id, result);
-            }
-        });
-        return Array.from(resultMap.values());
-    }
-    /**
-     * 정규화된 점수로 재랭킹
-     */
-    rankResults(deduplicatedResults) {
-        return deduplicatedResults
-            .map(({ provider, normalizedScore, ...result }) => ({
-            ...result,
-            similarity: normalizedScore
-        }))
-            .sort((a, b) => b.similarity - a.similarity);
-    }
-    /**
-     * Fallback 벡터 검색 실행
-     * 벡터 인덱스가 사용 불가능한 경우 임베딩 서비스를 직접 사용하여 검색
-     *
-     * @param db - 데이터베이스 연결
-     * @param query - 하이브리드 검색 쿼리
-     * @param searchId - 검색 ID (로깅용)
-     * @param startTime - 시작 시간 (성능 측정용, 현재는 사용하지 않음)
-     * @returns 벡터 검색 결과 배열
-     */
-    async executeFallbackSearch(db, query, searchId, startTime) {
-        if (!this.embeddingService.isAvailable()) {
-            this.logger.logSearchStep(searchId, '임베딩 서비스 사용 불가', {});
-            return [];
-        }
-        const fallbackStart = process.hrtime.bigint();
-        const vectorResults = await this.embeddingService.searchBySimilarity(db, query.query, {
-            type: query.filters?.type,
-            limit: (query.limit || 10) * VECTOR_SEARCH_LIMIT_MULTIPLIER,
-            threshold: VECTOR_SEARCH_THRESHOLD,
-        });
-        const fallbackTime = Number(process.hrtime.bigint() - fallbackStart) / 1_000_000;
-        this.logger.logSearchStep(searchId, 'Fallback 벡터 검색 완료', {
-            resultCount: vectorResults.length,
-            fallbackTime: `${fallbackTime.toFixed(2)}ms`
-        });
-        return vectorResults;
-    }
-    /**
-     * Provider 목록 캐시 (메모리 캐시)
-     * Provider 목록은 자주 변경되지 않으므로 캐싱하여 성능 개선
-     */
-    providerCache = null;
-    /**
-     * Provider 캐시 TTL (밀리초)
-     * 5분간 캐시 유지
-     */
-    static PROVIDER_CACHE_TTL_MS = 5 * 60 * 1000;
-    /**
-     * 데이터베이스에 저장된 모든 임베딩 provider를 감지하여 사용 가능한 검색 방법을 파악합니다.
-     * 모든 provider 목록을 반환하고 count 내림차순으로 정렬하여 주요 provider를 우선 확인합니다.
-     * 캐싱을 사용하여 반복적인 데이터베이스 조회를 줄이고 성능을 개선합니다.
-     */
-    async detectAllStoredEmbeddingProviders(db) {
-        // 캐시된 provider 정보를 확인하여 불필요한 데이터베이스 조회를 방지합니다.
-        const now = Date.now();
-        if (this.providerCache && (now - this.providerCache.timestamp) < HybridSearchEngine.PROVIDER_CACHE_TTL_MS) {
-            return this.providerCache.stats;
-        }
-        try {
-            const providerStatsList = db.prepare(`
-        SELECT 
-          LOWER(embedding_provider) as provider,
-          COUNT(*) as count,
-          AVG(dimensions) as avg_dimensions
-        FROM memory_embedding
-        WHERE embedding_provider IS NOT NULL
-          AND embedding_provider != ''
-          AND dimensions IS NOT NULL
-        GROUP BY LOWER(embedding_provider)
-        ORDER BY count DESC
-      `).all();
-            if (providerStatsList && providerStatsList.length > 0) {
-                const normalizedStats = providerStatsList
-                    .filter(stat => {
-                    // 알려진 EmbeddingProvider인지 확인하여 잘못된 데이터를 필터링합니다.
-                    const validProviders = ['tfidf', 'lightweight', 'minilm', 'openai', 'gemini'];
-                    return validProviders.includes(stat.provider);
-                })
-                    .map(stat => ({
-                    provider: stat.provider,
-                    count: stat.count,
-                    avg_dimensions: Math.round(stat.avg_dimensions || 0)
-                }));
-                // 새로 조회한 provider 정보를 캐시에 저장하여 향후 조회 성능을 향상시키기 위해
-                this.providerCache = {
-                    stats: normalizedStats,
-                    timestamp: now
-                };
-                this.logger.logSearchStep('', '저장된 임베딩 provider 감지', {
-                    providers: normalizedStats.map(s => s.provider),
-                    total_providers: normalizedStats.length
-                });
-                return normalizedStats;
-            }
-        }
-        catch (error) {
-            console.warn('⚠️ 저장된 임베딩 provider 감지 실패:', error);
-        }
-        // provider가 없는 경우 빈 배열을 반환하여 안정적인 동작을 보장합니다.
-        const emptyStats = [];
-        this.providerCache = {
-            stats: emptyStats,
-            timestamp: now
-        };
-        return emptyStats;
-    }
-    /**
-     * 쿼리 임베딩 벡터 생성
-     * preferredProvider가 지정된 경우 해당 provider로만 임베딩 생성
-     * 각 provider는 서로 다른 차원의 임베딩을 사용할 수 있으므로 fallback을 사용하지 않음
-     *
-     * @param query - 검색 쿼리 문자열
-     * @param searchId - 검색 ID (로깅용)
-     * @param preferredProvider - 선호하는 임베딩 provider (필수, 각 provider별로 다른 차원의 임베딩 필요)
-     * @returns 임베딩 벡터 배열
-     * @throws SearchError - 임베딩 생성 실패 시
-     */
-    async generateQueryVector(query, searchId, preferredProvider) {
-        try {
-            const embeddingStart = process.hrtime.bigint();
-            // 각 provider는 서로 다른 차원의 임베딩을 사용하므로 차원 불일치를 방지합니다.
-            // preferredProvider로만 임베딩을 생성하고 fallback을 사용하지 않아 일관성을 보장합니다.
-            const embeddingResult = await this.queryEmbeddingService.generateEmbedding(query, preferredProvider);
-            if (!embeddingResult) {
-                throw new SearchError(SearchErrorType.EMBEDDING_GENERATION_FAILED, '임베딩 생성에 실패했습니다', undefined, { query, searchId, preferredProvider });
-            }
-            const embeddingTime = Number(process.hrtime.bigint() - embeddingStart) / 1_000_000;
-            this.logger.logSearchStep(searchId, '임베딩 생성 완료', {
-                embeddingTime: `${embeddingTime.toFixed(2)}ms`,
-                vectorLength: embeddingResult.embedding.length,
-                provider: embeddingResult.provider || preferredProvider
-            });
-            return embeddingResult.embedding;
-        }
-        catch (error) {
-            if (error instanceof SearchError) {
-                throw error;
-            }
-            throw new SearchError(SearchErrorType.EMBEDDING_GENERATION_FAILED, `임베딩 생성 중 오류가 발생했습니다 (provider: ${preferredProvider})`, error instanceof Error ? error : new Error(String(error)), { query, searchId, preferredProvider });
-        }
-    }
-    async combineAndSortResults(textResults, vectorResults, weights, limit, db, includeRelations = false) {
-        try {
-            const combinedResults = this.resultCombiner.combine(textResults, vectorResults, weights.textWeight, weights.vectorWeight);
-            // 관계 그래프와 통합 점수를 활용하여 더 정교한 관련성 평가를 수행합니다.
-            if (db) {
-                const memoryIds = combinedResults.map(r => r.id);
-                if (memoryIds.length > 0) {
-                    // 관계 그래프를 기반으로 관계 가중치와 관계 정보를 계산하여 관련성 점수에 반영합니다.
-                    const relationData = await this.fetchRelationWeights(db, memoryIds);
-                    const relationWeights = relationData.weights;
-                    const relationInfo = relationData.relations;
-                    // 통합 점수 기능이 활성화된 경우 추가적인 관련성 지표를 조회합니다.
-                    let consolidationScores = new Map();
-                    if (mementoConfig.consolidationScoreEnabled) {
-                        consolidationScores = this.fetchConsolidationScores(db, memoryIds);
-                    }
-                    // 관계 가중치와 통합 점수를 반영하여 각 결과의 최종 점수를 재계산합니다.
-                    combinedResults.forEach(result => {
-                        const relationWeight = relationWeights.get(result.id);
-                        // relationGraph가 있고 실제 관계가 존재하는 경우에만 관계 가중치를 설정하여 정확성을 보장합니다.
-                        if (relationWeight !== undefined && relationWeight > 0) {
-                            result.relation_weight = relationWeight;
-                        }
-                        // 사용자가 요청한 경우에만 관계 정보를 포함하여 상세한 분석을 지원합니다.
-                        if (includeRelations) {
-                            const relations = relationInfo.get(result.id);
-                            if (relations && relations.length > 0) {
-                                result.relations = relations.map(r => ({
-                                    target_id: r.target_id,
-                                    relation_type: r.relation_type,
-                                    confidence: r.confidence
-                                }));
-                            }
-                        }
-                        const consolidationScore = consolidationScores.get(result.id);
-                        if (consolidationScore !== undefined) {
-                            // 통합 점수가 있는 경우 더 정교한 점수 계산 방식을 사용하여 검색 품질을 향상시키기 위해
-                            result.consolidation_score = consolidationScore;
-                            const vectorSimilarity = result.vectorScore;
-                            result.finalScore = this.ranking.calculateFinalScoreWithConsolidation(vectorSimilarity, consolidationScore, 'balanced');
-                        }
-                        else {
-                            // 관계 가중치를 포함한 finalScore 재계산
-                            // SearchFeatures 구성
-                            const features = {
-                                relevance: result.vectorScore || result.textScore || 0,
-                                recency: this.calculateRecency(result.created_at),
-                                importance: result.importance || 0.5,
-                                usage: this.calculateUsage(result.last_accessed),
-                                relation_weight: relationWeight || 0, // relationWeight가 undefined면 0 사용
-                                duplication_penalty: 0 // 중복 패널티는 이미 결과 결합 시 처리됨
-                            };
-                            result.finalScore = this.ranking.calculateFinalScore(features);
-                        }
-                    });
-                }
-            }
-            return combinedResults
-                .sort((a, b) => b.finalScore - a.finalScore)
-                .slice(0, limit);
-        }
-        catch (error) {
-            throw new SearchError(SearchErrorType.RESULT_COMBINATION_FAILED, '결과 결합 중 오류가 발생했습니다', error instanceof Error ? error : new Error(String(error)), { textResultsCount: textResults.length, vectorResultsCount: vectorResults.length, weights });
-        }
-    }
-    /**
-     * 데이터베이스에서 consolidation_score 조회
-     */
-    fetchConsolidationScores(db, memoryIds) {
-        const scores = new Map();
-        if (memoryIds.length === 0) {
-            return scores;
-        }
-        try {
-            const placeholders = memoryIds.map(() => '?').join(',');
-            const sql = `SELECT id, consolidation_score FROM memory_item WHERE id IN (${placeholders})`;
-            const results = db.prepare(sql).all(...memoryIds);
-            results.forEach(row => {
-                if (row.consolidation_score !== null && row.consolidation_score !== undefined) {
-                    scores.set(row.id, Number(row.consolidation_score));
-                }
-            });
-        }
-        catch (error) {
-            // 에러 발생 시 빈 Map 반환 (기존 finalScore 유지)
-            console.warn('⚠️ Consolidation Score 조회 실패:', error);
-        }
-        return scores;
-    }
-    /**
-     * 관계 가중치 계산 및 조회
-     * 관계 정보도 함께 반환 (선택적)
-     */
-    async fetchRelationWeights(db, memoryIds) {
-        const weights = new Map();
-        const relations = new Map();
-        if (memoryIds.length === 0 || !this.relationGraph) {
-            return { weights, relations };
-        }
-        try {
-            const config = getRankingWeights();
-            const maxRelations = config.relation_weights.max_relations;
-            // 각 메모리에 대해 관계 조회 및 가중치 계산
-            for (const memoryId of memoryIds) {
-                const memoryRelations = await this.relationGraph.getRelations(memoryId, {
-                    direction: 'both',
-                    minConfidence: 0.5 // 최소 신뢰도 필터
-                });
-                if (memoryRelations.length > 0) {
-                    // 관계 가중치 계산
-                    const relationData = memoryRelations.map(r => ({
-                        confidence: r.confidence,
-                        relation_type: r.relation_type
-                    }));
-                    const relationWeight = this.ranking.calculateRelationWeight(relationData, maxRelations);
-                    weights.set(memoryId, relationWeight);
-                    // 관계 정보 저장 (간단한 형태로 변환)
-                    const simplifiedRelations = memoryRelations.map(r => ({
-                        target_id: r.source_id === memoryId ? r.target_id : r.source_id,
-                        relation_type: r.relation_type,
-                        confidence: r.confidence
-                    }));
-                    relations.set(memoryId, simplifiedRelations);
-                }
-            }
-        }
-        catch (error) {
-            // 에러 발생 시 빈 Map 반환 (관계 가중치 없이 진행)
-            console.warn('⚠️ 관계 가중치 계산 실패:', error);
-        }
-        return { weights, relations };
-    }
-    /**
-     * 최근성 점수 계산 (간단한 구현)
-     */
-    calculateRecency(createdAt) {
-        if (!createdAt)
-            return 0.5;
-        const created = typeof createdAt === 'string' ? new Date(createdAt) : createdAt;
-        const ageDays = (Date.now() - created.getTime()) / (1000 * 60 * 60 * 24);
-        // 30일 반감기
-        return Math.exp(-Math.log(2) * ageDays / 30);
-    }
-    /**
-     * 사용성 점수 계산 (간단한 구현)
-     */
-    calculateUsage(lastAccessed) {
-        if (!lastAccessed)
-            return 0.1;
-        const accessed = typeof lastAccessed === 'string' ? new Date(lastAccessed) : lastAccessed;
-        const daysSinceAccess = (Date.now() - accessed.getTime()) / (1000 * 60 * 60 * 24);
-        return Math.exp(-daysSinceAccess / 30);
-    }
-    calculateQueryTime(startTime) {
-        const endTime = process.hrtime.bigint();
-        return Number(endTime - startTime) / 1_000_000;
-    }
-    /**
-     * 검색 통계 업데이트
-     */
-    updateSearchStats(query, textHits, vectorHits) {
-        const queryKey = this.normalizeQuery(query);
-        const stats = this.searchStats.get(queryKey) || { textHits: 0, vectorHits: 0, totalSearches: 0 };
-        stats.textHits += textHits;
-        stats.vectorHits += vectorHits;
-        stats.totalSearches += 1;
-        this.searchStats.set(queryKey, stats);
-    }
-    normalizeQuery(query) {
-        return query.toLowerCase().trim().replace(/\s+/g, ' ');
-    }
-    /**
-     * 검색 통계 정보
-     */
-    async getSearchStats(db) {
-        const embeddingStats = await this.embeddingService.getEmbeddingStats(db);
-        return {
-            textSearchAvailable: true,
-            vectorSearchAvailable: this.embeddingService.isAvailable(),
-            embeddingStats,
-            searchStats: this.searchStats,
-        };
-    }
-    /**
-     * 임베딩 서비스 사용 가능 여부 확인
-     */
-    isEmbeddingAvailable() {
-        return this.embeddingService.isAvailable();
-    }
-}
-// 팩토리 함수들
-export function createHybridSearchEngine(textSearchEngine, embeddingService, vectorSearchEngine, resultCombiner, weightCalculator, logger) {
-    return new HybridSearchEngine(textSearchEngine ?? new SearchEngine(), embeddingService ?? new MemoryEmbeddingService(), vectorSearchEngine ?? getVectorSearchEngine(), resultCombiner ?? new SearchResultCombiner(), weightCalculator ?? new AdaptiveWeightCalculator(), logger ?? new SearchLogger());
-}
-// 기존 호환성을 위한 싱글톤 (deprecated)
-let hybridSearchEngineInstance = null;
-export function getHybridSearchEngine() {
-    if (!hybridSearchEngineInstance) {
-        hybridSearchEngineInstance = createHybridSearchEngine();
-    }
-    return hybridSearchEngineInstance;
-}
-//# sourceMappingURL=hybrid-search-engine.js.map