memento-mcp-server 0.1.0 → 1.7.1

package/dist/services/vector-search/vector-performance-tester.js

@@ -0,0 +1,87 @@
+/**
+ * 벡터 성능 테스트 서비스
+ * 단일 책임 원칙(SRP) 적용 - 성능 테스트만 담당
+ */
+import { VECTOR_SEARCH_DEFAULTS } from '../../config/vector-search.config';
+export class VectorPerformanceTester {
+    repository;
+    constructor(repository) {
+        this.repository = repository;
+    }
+    /**
+     * 성능 테스트 실행
+     */
+    async runPerformanceTest(queryVector, iterations = VECTOR_SEARCH_DEFAULTS.PERFORMANCE_ITERATIONS) {
+        this.validateTestParameters(queryVector, iterations);
+        try {
+            return await this.repository.runPerformanceTest(queryVector, iterations);
+        }
+        catch (error) {
+            console.error('성능 테스트 실패:', error);
+            return {
+                averageTime: 0,
+                minTime: 0,
+                maxTime: 0,
+                results: 0,
+                successRate: 0
+            };
+        }
+    }
+    /**
+     * 벡터 차원 검증
+     */
+    validateTestParameters(queryVector, iterations) {
+        if (!queryVector || queryVector.length !== VECTOR_SEARCH_DEFAULTS.DIMENSIONS) {
+            throw new Error(`벡터 차원 불일치: 예상 ${VECTOR_SEARCH_DEFAULTS.DIMENSIONS}, 실제 ${queryVector?.length || 0}`);
+        }
+        if (iterations < 1 || iterations > 100) {
+            throw new Error('반복 횟수는 1-100 사이여야 합니다');
+        }
+    }
+    /**
+     * 성능 테스트 결과 분석
+     */
+    analyzeResults(result) {
+        const recommendations = [];
+        let performance = 'good';
+        if (result.averageTime < 10) {
+            performance = 'excellent';
+        }
+        else if (result.averageTime < 50) {
+            performance = 'good';
+        }
+        else if (result.averageTime < 100) {
+            performance = 'fair';
+            recommendations.push('인덱스 최적화를 고려하세요');
+        }
+        else {
+            performance = 'poor';
+            recommendations.push('인덱스 재구성이 필요합니다');
+            recommendations.push('데이터베이스 성능 튜닝을 고려하세요');
+        }
+        if (result.successRate < 0.9) {
+            recommendations.push('시스템 안정성 검토가 필요합니다');
+        }
+        return { performance, recommendations };
+    }
+    /**
+     * 성능 테스트 리포트 생성
+     */
+    generateReport(result) {
+        const analysis = this.analyzeResults(result);
+        return `
+벡터 검색 성능 테스트 리포트
+============================
+평균 응답 시간: ${result.averageTime.toFixed(2)}ms
+최소 응답 시간: ${result.minTime}ms
+최대 응답 시간: ${result.maxTime}ms
+검색 결과 수: ${result.results}개
+성공률: ${(result.successRate * 100).toFixed(1)}%
+성능 등급: ${analysis.performance.toUpperCase()}
+
+권장사항:
+${analysis.recommendations.map(rec => `- ${rec}`).join('\n')}
+    `.trim();
+    }
+}
+//# sourceMappingURL=vector-performance-tester.js.map

package/dist/services/vector-search/vector-performance-tester.js.map

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

package/dist/services/vector-search/vector-search-container.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 벡터 검색 컨테이너
+ * 의존성 주입 컨테이너 역할
+ */
+import Database from 'better-sqlite3';
+import { VectorSearchFacade } from './vector-search-facade';
+export declare class VectorSearchContainer {
+    private static instance;
+    private facade;
+    private db;
+    private constructor();
+    /**
+     * 싱글톤 인스턴스 반환
+     */
+    static getInstance(): VectorSearchContainer;
+    /**
+     * 데이터베이스 연결 설정
+     */
+    setDatabase(db: Database.Database): void;
+    /**
+     * 벡터 검색 파사드 반환
+     */
+    getFacade(): VectorSearchFacade;
+    /**
+     * 파사드 생성
+     */
+    private createFacade;
+    /**
+     * 컨테이너 초기화
+     */
+    reset(): void;
+    /**
+     * 데이터베이스 연결 상태 확인
+     */
+    isConnected(): boolean;
+    /**
+     * 파사드 상태 확인
+     */
+    isFacadeReady(): boolean;
+}
+//# sourceMappingURL=vector-search-container.d.ts.map

package/dist/services/vector-search/vector-search-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search-container.d.ts","sourceRoot":"","sources":["../../../src/services/vector-search/vector-search-container.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAK5D,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsC;IAC7D,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,EAAE,CAAkC;IAE5C,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,qBAAqB;IAO3C;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAKxC;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAU/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB"}

package/dist/services/vector-search/vector-search-container.js

@@ -0,0 +1,74 @@
+/**
+ * 벡터 검색 컨테이너
+ * 의존성 주입 컨테이너 역할
+ */
+import Database from 'better-sqlite3';
+import { VectorSearchFacade } from './vector-search-facade';
+import { VectorSearchRepositoryImpl } from '../../repositories/vector-search.repository';
+import { VectorPerformanceRepositoryImpl } from '../../repositories/vector-performance.repository';
+export class VectorSearchContainer {
+    static instance = null;
+    facade = null;
+    db = null;
+    constructor() { }
+    /**
+     * 싱글톤 인스턴스 반환
+     */
+    static getInstance() {
+        if (!VectorSearchContainer.instance) {
+            VectorSearchContainer.instance = new VectorSearchContainer();
+        }
+        return VectorSearchContainer.instance;
+    }
+    /**
+     * 데이터베이스 연결 설정
+     */
+    setDatabase(db) {
+        this.db = db;
+        this.facade = null; // 기존 파사드 무효화
+    }
+    /**
+     * 벡터 검색 파사드 반환
+     */
+    getFacade() {
+        if (!this.facade) {
+            if (!this.db) {
+                throw new Error('데이터베이스가 설정되지 않았습니다');
+            }
+            this.facade = this.createFacade();
+        }
+        return this.facade;
+    }
+    /**
+     * 파사드 생성
+     */
+    createFacade() {
+        if (!this.db) {
+            throw new Error('데이터베이스가 설정되지 않았습니다');
+        }
+        const searchRepository = new VectorSearchRepositoryImpl(this.db);
+        const performanceRepository = new VectorPerformanceRepositoryImpl(this.db);
+        return new VectorSearchFacade(searchRepository, searchRepository, // 인덱스 리포지토리로 재사용
+        performanceRepository);
+    }
+    /**
+     * 컨테이너 초기화
+     */
+    reset() {
+        this.facade = null;
+        this.db = null;
+    }
+    /**
+     * 데이터베이스 연결 상태 확인
+     */
+    isConnected() {
+        return this.db !== null;
+    }
+    /**
+     * 파사드 상태 확인
+     */
+    isFacadeReady() {
+        return this.facade !== null;
+    }
+}
+//# sourceMappingURL=vector-search-container.js.map

package/dist/services/vector-search/vector-search-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search-container.js","sourceRoot":"","sources":["../../../src/services/vector-search/vector-search-container.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,+BAA+B,EAAE,MAAM,kDAAkD,CAAC;AAGnG,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAAC,QAAQ,GAAiC,IAAI,CAAC;IACrD,MAAM,GAA8B,IAAI,CAAC;IACzC,EAAE,GAA6B,IAAI,CAAC;IAE5C,gBAAuB,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,CAAC;YACpC,qBAAqB,CAAC,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,qBAAqB,CAAC,QAAQ,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,EAAqB;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,aAAa;IACnC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,YAAY;QAClB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjE,MAAM,qBAAqB,GAAG,IAAI,+BAA+B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE3E,OAAO,IAAI,kBAAkB,CAC3B,gBAAgB,EAChB,gBAAgB,EAAE,iBAAiB;QACnC,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC"}

package/dist/services/vector-search/vector-search-facade.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 벡터 검색 파사드
+ * 의존성 주입을 통한 통합 인터페이스 제공
+ */
+import type { VectorSearchQuery, VectorSearchResult, VectorIndexStatus, PerformanceTestResult, ProviderHybridQuery, ProviderHybridResult, UnifiedSearchResponse } from '../../types/vector-search.types';
+import type { VectorSearchRepository, VectorIndexRepository, VectorPerformanceRepository } from '../../interfaces/database.interface';
+import { UnifiedEmbeddingService } from '../unified-embedding-service.js';
+export declare class VectorSearchFacade {
+    private searchService;
+    private indexManager;
+    private performanceTester;
+    constructor(searchRepository: VectorSearchRepository, indexRepository: VectorIndexRepository, performanceRepository: VectorPerformanceRepository);
+    /**
+     * 벡터 검색 실행
+     */
+    search(query: VectorSearchQuery): Promise<VectorSearchResult[]>;
+    /**
+     * 하이브리드 검색 실행
+     */
+    hybridSearch(query: VectorSearchQuery): Promise<VectorSearchResult[]>;
+    providerHybridSearch(query: ProviderHybridQuery, embeddingService: UnifiedEmbeddingService): Promise<ProviderHybridResult[]>;
+    unifiedSearch(query: ProviderHybridQuery, embeddingService: UnifiedEmbeddingService): Promise<UnifiedSearchResponse>;
+    /**
+     * 인덱스 상태 확인
+     */
+    getIndexStatus(): VectorIndexStatus;
+    /**
+     * 인덱스 재구성
+     */
+    rebuildIndex(): Promise<boolean>;
+    /**
+     * VEC 사용 가능 여부 확인
+     */
+    isAvailable(): boolean;
+    /**
+     * 성능 테스트 실행
+     */
+    runPerformanceTest(queryVector: number[], iterations?: number): Promise<PerformanceTestResult>;
+    /**
+     * 성능 테스트 결과 분석
+     */
+    analyzePerformance(result: PerformanceTestResult): {
+        performance: 'excellent' | 'good' | 'fair' | 'poor';
+        recommendations: string[];
+    };
+    /**
+     * 성능 테스트 리포트 생성
+     */
+    generatePerformanceReport(result: PerformanceTestResult): string;
+    /**
+     * 인덱스 상태 요약
+     */
+    getStatusSummary(): string;
+    /**
+     * 전체 시스템 상태 확인
+     */
+    getSystemStatus(): {
+        available: boolean;
+        indexStatus: VectorIndexStatus;
+        summary: string;
+    };
+}
+//# sourceMappingURL=vector-search-facade.d.ts.map

package/dist/services/vector-search/vector-search-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search-facade.d.ts","sourceRoot":"","sources":["../../../src/services/vector-search/vector-search-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,iBAAiB,CAA0B;gBAGjD,gBAAgB,EAAE,sBAAsB,EACxC,eAAe,EAAE,qBAAqB,EACtC,qBAAqB,EAAE,2BAA2B;IAOpD;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIrE;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIrE,oBAAoB,CACxB,KAAK,EAAE,mBAAmB,EAC1B,gBAAgB,EAAE,uBAAuB,GACxC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAI5B,aAAa,CACjB,KAAK,EAAE,mBAAmB,EAC1B,gBAAgB,EAAE,uBAAuB,GACxC,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;OAEG;IACH,cAAc,IAAI,iBAAiB;IAInC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAItC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG;QACjD,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;QACpD,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B;IAID;;OAEG;IACH,yBAAyB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM;IAIhE;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,eAAe,IAAI;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,EAAE,iBAAiB,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;KACjB;CAUF"}

package/dist/services/vector-search/vector-search-facade.js

@@ -0,0 +1,91 @@
+/**
+ * 벡터 검색 파사드
+ * 의존성 주입을 통한 통합 인터페이스 제공
+ */
+import { VectorSearchService } from './vector-search.service';
+import { VectorIndexManager } from './vector-index-manager';
+import { VectorPerformanceTester } from './vector-performance-tester';
+import { UnifiedEmbeddingService } from '../unified-embedding-service.js';
+export class VectorSearchFacade {
+    searchService;
+    indexManager;
+    performanceTester;
+    constructor(searchRepository, indexRepository, performanceRepository) {
+        this.searchService = new VectorSearchService(searchRepository);
+        this.indexManager = new VectorIndexManager(indexRepository);
+        this.performanceTester = new VectorPerformanceTester(performanceRepository);
+    }
+    /**
+     * 벡터 검색 실행
+     */
+    async search(query) {
+        return await this.searchService.search(query);
+    }
+    /**
+     * 하이브리드 검색 실행
+     */
+    async hybridSearch(query) {
+        return await this.searchService.hybridSearch(query);
+    }
+    async providerHybridSearch(query, embeddingService) {
+        return await this.searchService.providerHybridSearch(embeddingService, query);
+    }
+    async unifiedSearch(query, embeddingService) {
+        return await this.searchService.unifiedSearch(embeddingService, query);
+    }
+    /**
+     * 인덱스 상태 확인
+     */
+    getIndexStatus() {
+        return this.indexManager.getIndexStatus();
+    }
+    /**
+     * 인덱스 재구성
+     */
+    async rebuildIndex() {
+        return await this.indexManager.rebuildIndex();
+    }
+    /**
+     * VEC 사용 가능 여부 확인
+     */
+    isAvailable() {
+        return this.indexManager.isAvailable();
+    }
+    /**
+     * 성능 테스트 실행
+     */
+    async runPerformanceTest(queryVector, iterations = 10) {
+        return await this.performanceTester.runPerformanceTest(queryVector, iterations);
+    }
+    /**
+     * 성능 테스트 결과 분석
+     */
+    analyzePerformance(result) {
+        return this.performanceTester.analyzeResults(result);
+    }
+    /**
+     * 성능 테스트 리포트 생성
+     */
+    generatePerformanceReport(result) {
+        return this.performanceTester.generateReport(result);
+    }
+    /**
+     * 인덱스 상태 요약
+     */
+    getStatusSummary() {
+        return this.indexManager.getStatusSummary();
+    }
+    /**
+     * 전체 시스템 상태 확인
+     */
+    getSystemStatus() {
+        const indexStatus = this.getIndexStatus();
+        const available = this.isAvailable();
+        return {
+            available,
+            indexStatus,
+            summary: this.getStatusSummary()
+        };
+    }
+}
+//# sourceMappingURL=vector-search-facade.js.map

package/dist/services/vector-search/vector-search-facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search-facade.js","sourceRoot":"","sources":["../../../src/services/vector-search/vector-search-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAMtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,OAAO,kBAAkB;IACrB,aAAa,CAAsB;IACnC,YAAY,CAAqB;IACjC,iBAAiB,CAA0B;IAEnD,YACE,gBAAwC,EACxC,eAAsC,EACtC,qBAAkD;QAElD,IAAI,CAAC,aAAa,GAAG,IAAI,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;QAC/D,IAAI,CAAC,YAAY,GAAG,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC;QAC5D,IAAI,CAAC,iBAAiB,GAAG,IAAI,uBAAuB,CAAC,qBAAqB,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAwB;QACnC,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,KAAwB;QACzC,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,KAA0B,EAC1B,gBAAyC;QAEzC,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,KAA0B,EAC1B,gBAAyC;QAEzC,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,WAAqB,EACrB,aAAqB,EAAE;QAEvB,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAClF,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAA6B;QAI9C,OAAO,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,yBAAyB,CAAC,MAA6B;QACrD,OAAO,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,eAAe;QAKb,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAErC,OAAO;YACL,SAAS;YACT,WAAW;YACX,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE;SACjC,CAAC;IACJ,CAAC;CACF"}

package/dist/services/vector-search/vector-search-result-normalizer.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderHybridResult, UnifiedSearchHit } from '../../types/vector-search.types.js';
+export declare class VectorSearchResultNormalizer {
+    normalize(providerResults: ProviderHybridResult[]): UnifiedSearchHit[];
+}
+export declare const vectorSearchResultNormalizer: VectorSearchResultNormalizer;
+//# sourceMappingURL=vector-search-result-normalizer.d.ts.map

package/dist/services/vector-search/vector-search-result-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search-result-normalizer.d.ts","sourceRoot":"","sources":["../../../src/services/vector-search/vector-search-result-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAiC5C,qBAAa,4BAA4B;IACvC,SAAS,CAAC,eAAe,EAAE,oBAAoB,EAAE,GAAG,gBAAgB,EAAE;CA+CvE;AAED,eAAO,MAAM,4BAA4B,8BAAqC,CAAC"}

package/dist/services/vector-search/vector-search-result-normalizer.js

@@ -0,0 +1,65 @@
+function selectScore(result, hybridResult) {
+    if (hybridResult) {
+        return {
+            score: hybridResult.similarity,
+            source: 'hybrid',
+            hybridSimilarity: hybridResult.similarity
+        };
+    }
+    return {
+        score: result.similarity,
+        source: 'vector'
+    };
+}
+function computeNormalizationRange(scores) {
+    if (scores.length === 0) {
+        return { min: 0, max: 1, denom: 1 };
+    }
+    const min = Math.min(...scores);
+    const max = Math.max(...scores);
+    const denom = max - min === 0 ? 1 : max - min;
+    return { min, max, denom };
+}
+export class VectorSearchResultNormalizer {
+    normalize(providerResults) {
+        const unifiedMap = new Map();
+        for (const providerResult of providerResults) {
+            const vectorResults = providerResult.vectorResults ?? [];
+            const hybridResults = providerResult.hybridResults ?? [];
+            const hybridById = new Map();
+            for (const hybrid of hybridResults) {
+                hybridById.set(hybrid.memory_id, hybrid);
+            }
+            const scores = vectorResults.map(result => {
+                const hybrid = hybridById.get(result.memory_id);
+                return selectScore(result, hybrid).score;
+            });
+            const { min, denom } = computeNormalizationRange(scores);
+            for (const vectorResult of vectorResults) {
+                const hybrid = hybridById.get(vectorResult.memory_id);
+                const scoreInfo = selectScore(vectorResult, hybrid);
+                const normalizedScore = (scoreInfo.score - min) / denom;
+                const key = `${vectorResult.memory_id}:${providerResult.provider}`;
+                const existing = unifiedMap.get(key);
+                if (!existing || normalizedScore > existing.normalizedScore) {
+                    unifiedMap.set(key, {
+                        memoryId: vectorResult.memory_id,
+                        provider: providerResult.provider,
+                        normalizedScore,
+                        vectorSimilarity: vectorResult.similarity,
+                        hybridSimilarity: scoreInfo.hybridSimilarity,
+                        content: vectorResult.content,
+                        type: vectorResult.type,
+                        importance: vectorResult.importance,
+                        createdAt: vectorResult.created_at,
+                        tags: vectorResult.tags,
+                        source: scoreInfo.source
+                    });
+                }
+            }
+        }
+        return Array.from(unifiedMap.values()).sort((a, b) => b.normalizedScore - a.normalizedScore);
+    }
+}
+export const vectorSearchResultNormalizer = new VectorSearchResultNormalizer();
+//# sourceMappingURL=vector-search-result-normalizer.js.map

package/dist/services/vector-search/vector-search-result-normalizer.js.map

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

package/dist/services/vector-search/vector-search.service.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 벡터 검색 서비스
+ * 단일 책임 원칙(SRP) 적용 - 검색 기능만 담당
+ */
+import type { VectorSearchQuery, VectorSearchResult, VectorSearchOptions, ProviderHybridQuery, ProviderHybridResult, UnifiedSearchResponse } from '../../types/vector-search.types';
+import type { VectorSearchRepository } from '../../interfaces/database.interface';
+import { UnifiedEmbeddingService } from '../unified-embedding-service.js';
+export declare class VectorSearchService {
+    private repository;
+    private config;
+    constructor(repository: VectorSearchRepository, config?: import("../../types/vector-search.types").VectorSearchConfig);
+    /**
+     * 벡터 검색 실행
+     */
+    search(query: VectorSearchQuery): Promise<VectorSearchResult[]>;
+    /**
+     * 하이브리드 검색 실행
+     */
+    hybridSearch(query: VectorSearchQuery): Promise<VectorSearchResult[]>;
+    providerHybridSearch(embeddingService: UnifiedEmbeddingService, baseQuery: ProviderHybridQuery): Promise<ProviderHybridResult[]>;
+    unifiedSearch(embeddingService: UnifiedEmbeddingService, baseQuery: ProviderHybridQuery): Promise<UnifiedSearchResponse>;
+    /**
+     * 검색 쿼리 유효성 검증
+     */
+    private validateQuery;
+    private validateProviderHybridQuery;
+    private getExpectedDimensions;
+    /**
+     * 기본 옵션 적용
+     */
+    applyDefaultOptions(options: VectorSearchOptions): VectorSearchOptions;
+}
+//# sourceMappingURL=vector-search.service.d.ts.map

package/dist/services/vector-search/vector-search.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search.service.d.ts","sourceRoot":"","sources":["../../../src/services/vector-search/vector-search.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAElF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAI1E,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;gBADN,UAAU,EAAE,sBAAsB,EAClC,MAAM,+DAAuB;IAGvC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAUrE;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAUrE,oBAAoB,CACxB,gBAAgB,EAAE,uBAAuB,EACzC,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA4E5B,aAAa,CACjB,gBAAgB,EAAE,uBAAuB,EACzC,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAAC,qBAAqB,CAAC;IASjC;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,2BAA2B;IAOnC,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB;CASvE"}

package/dist/services/vector-search/vector-search.service.js

@@ -0,0 +1,149 @@
+/**
+ * 벡터 검색 서비스
+ * 단일 책임 원칙(SRP) 적용 - 검색 기능만 담당
+ */
+import { VECTOR_SEARCH_CONFIG } from '../../config/vector-search.config';
+import { UnifiedEmbeddingService } from '../unified-embedding-service.js';
+import { vectorSearchResultNormalizer } from './vector-search-result-normalizer.js';
+export class VectorSearchService {
+    repository;
+    config;
+    constructor(repository, config = VECTOR_SEARCH_CONFIG) {
+        this.repository = repository;
+        this.config = config;
+    }
+    /**
+     * 벡터 검색 실행
+     */
+    async search(query) {
+        this.validateQuery(query);
+        try {
+            return await this.repository.search(query);
+        }
+        catch (error) {
+            throw new Error(`벡터 검색 실패: ${error}`);
+        }
+    }
+    /**
+     * 하이브리드 검색 실행
+     */
+    async hybridSearch(query) {
+        this.validateQuery(query);
+        try {
+            return await this.repository.hybridSearch(query);
+        }
+        catch (error) {
+            throw new Error(`하이브리드 검색 실패: ${error}`);
+        }
+    }
+    async providerHybridSearch(embeddingService, baseQuery) {
+        this.validateProviderHybridQuery(baseQuery);
+        const providers = new Set();
+        if (baseQuery.overrideProviders && baseQuery.overrideProviders.length > 0) {
+            baseQuery.overrideProviders.forEach(provider => providers.add(provider));
+        }
+        else if (baseQuery.useAvailableProviders) {
+            embeddingService.getAvailableProviders().forEach(provider => providers.add(provider));
+        }
+        else if (baseQuery.query.provider) {
+            providers.add(baseQuery.query.provider);
+        }
+        if (providers.size === 0) {
+            providers.add('minilm');
+        }
+        const results = [];
+        for (const provider of providers) {
+            let providerVector = baseQuery.query.queryVector;
+            if (baseQuery.text) {
+                const embedding = await embeddingService.generateEmbedding(baseQuery.text, provider);
+                if (!embedding || !embedding.embedding) {
+                    continue;
+                }
+                providerVector = embedding.embedding;
+            }
+            if (!providerVector || providerVector.length === 0) {
+                continue;
+            }
+            const expectedDimensions = this.getExpectedDimensions(provider);
+            if (providerVector.length !== expectedDimensions) {
+                continue;
+            }
+            const providerOptions = {
+                ...baseQuery.query.options,
+                limit: baseQuery.query.options.limit ?? this.config.defaultLimit,
+                threshold: baseQuery.query.options.threshold ?? this.config.defaultThreshold
+            };
+            const providerQuery = {
+                ...baseQuery.query,
+                provider,
+                queryVector: providerVector,
+                options: providerOptions
+            };
+            const vectorStart = Date.now();
+            const vectorResults = await this.repository.search(providerQuery);
+            const vectorLatency = Date.now() - vectorStart;
+            const vectorLimit = baseQuery.vectorLimit ?? providerOptions.limit ?? this.config.defaultLimit;
+            const topVector = vectorResults.slice(0, vectorLimit);
+            let hybridResults = [];
+            let hybridLatency;
+            if (baseQuery.useHybrid === true) {
+                const hybridStart = Date.now();
+                hybridResults = await this.repository.hybridSearch(providerQuery);
+                hybridLatency = Date.now() - hybridStart;
+            }
+            results.push({
+                provider,
+                vectorResults: topVector,
+                hybridResults,
+                vectorLatencyMs: vectorLatency,
+                hybridLatencyMs: hybridLatency
+            });
+        }
+        return results;
+    }
+    async unifiedSearch(embeddingService, baseQuery) {
+        const providerResults = await this.providerHybridSearch(embeddingService, baseQuery);
+        const unified = vectorSearchResultNormalizer.normalize(providerResults);
+        return {
+            providers: providerResults,
+            unified
+        };
+    }
+    /**
+     * 검색 쿼리 유효성 검증
+     */
+    validateQuery(query) {
+        const expectedDimensions = this.getExpectedDimensions(query.provider);
+        if (!query.queryVector || query.queryVector.length !== expectedDimensions) {
+            throw new Error(`벡터 차원 불일치: 예상 ${expectedDimensions}, 실제 ${query.queryVector?.length || 0}`);
+        }
+        if (query.options.limit && (query.options.limit < 1 || query.options.limit > 100)) {
+            throw new Error('검색 제한은 1-100 사이여야 합니다');
+        }
+    }
+    validateProviderHybridQuery(query) {
+        if (!query.query) {
+            throw new Error('ProviderHybridQuery.query가 필요합니다');
+        }
+        this.validateQuery(query.query);
+    }
+    getExpectedDimensions(provider) {
+        if (!provider) {
+            return this.config.defaultDimensions;
+        }
+        return this.config.providerDimensions[provider] ?? this.config.defaultDimensions;
+    }
+    /**
+     * 기본 옵션 적용
+     */
+    applyDefaultOptions(options) {
+        return {
+            limit: this.config.defaultLimit,
+            threshold: this.config.defaultThreshold,
+            includeContent: true,
+            includeMetadata: false,
+            ...options
+        };
+    }
+}
+//# sourceMappingURL=vector-search.service.js.map