memento-mcp-server 1.13.1-a0 → 1.13.1-a3

package/dist/domains/memory/services/memory-embedding-service.js

@@ -0,0 +1,341 @@
+/**
+ * 메모리 임베딩 저장 및 검색 서비스
+ * 데이터베이스와 임베딩 서비스를 연동
+ */
+import { UnifiedEmbeddingService } from '../../embedding/services/unified-embedding-service.js';
+import { vectorCompatibilityService } from '../../embedding/services/vector-compatibility-service.js';
+import { DatabaseUtils } from '../../../shared/utils/database.js';
+export class MemoryEmbeddingService {
+    embeddingService;
+    defaultProvider = 'tfidf';
+    createdByTag = 'memory_embedding_service';
+    constructor() {
+        this.embeddingService = new UnifiedEmbeddingService();
+    }
+    /**
+     * sqlite-vec 확장 로드
+     * init.ts와 동일한 방식으로 sqlite-vec 패키지의 getLoadablePath() 사용
+     */
+    async loadVecExtension(db) {
+        try {
+            // sqlite-vec 패키지에서 올바른 경로 가져오기
+            const { getLoadablePath } = await import('sqlite-vec');
+            const extensionPath = getLoadablePath();
+            db.loadExtension(extensionPath);
+            // 성공 시 로그는 출력하지 않음 (너무 많은 로그 방지)
+        }
+        catch (error) {
+            // 실패해도 치명적이지 않음 (TF-IDF fallback 사용)
+            // 로그는 한 번만 출력하도록 조건부 처리
+            if (!global.__vecExtensionLoadWarningShown) {
+                console.warn('⚠️ sqlite-vec 확장 로드 실패 (TF-IDF fallback 사용):', error.message);
+                global.__vecExtensionLoadWarningShown = true;
+            }
+        }
+    }
+    /**
+     * 메모리에 임베딩 생성 및 저장
+     */
+    async createAndStoreEmbedding(db, memoryId, content, type) {
+        if (!this.embeddingService.isAvailable()) {
+            console.warn('⚠️ 임베딩 서비스가 사용 불가능합니다. 임베딩을 건너뜁니다.');
+            return null;
+        }
+        try {
+            // sqlite-vec 확장 로드 (비동기)
+            await this.loadVecExtension(db);
+            // 임베딩 생성
+            const embeddingResult = await this.embeddingService.generateEmbedding(content);
+            if (!embeddingResult) {
+                return null;
+            }
+            const embeddingVector = Array.isArray(embeddingResult.embedding) ? embeddingResult.embedding : [];
+            if (embeddingVector.length === 0) {
+                console.warn(`⚠️ 임베딩 결과가 비어 있어 저장을 건너뜁니다. memoryId=${memoryId}`);
+                return null;
+            }
+            const provider = this.normalizeProvider(embeddingResult.provider || this.embeddingService.getCurrentProviderName());
+            const compatibility = vectorCompatibilityService.assessProviderCompatibility(embeddingVector, provider);
+            const blockingIssues = compatibility.issues.filter(issue => issue.severity === 'error' && issue.code !== 'dimension_mismatch');
+            if (blockingIssues.length > 0) {
+                console.error('❌ 임베딩 벡터 검증 실패:', blockingIssues.map(issue => issue.message));
+                return null;
+            }
+            const projection = compatibility.projection;
+            const storedVector = projection.vector;
+            const serializedEmbedding = JSON.stringify(storedVector);
+            const sourceDimensions = projection.sourceDimensions;
+            const storedDimensions = projection.targetDimensions;
+            const projectionType = projection.projectionType;
+            const normalized = projection.normalized ? 1 : 0;
+            if (compatibility.needsProjection) {
+                const dimensionIssue = compatibility.issues.find(issue => issue.code === 'dimension_mismatch');
+                if (dimensionIssue) {
+                    console.warn(`⚠️ ${dimensionIssue.message}`);
+                }
+                console.log(`🔄 벡터 차원 조정: ${sourceDimensions} → ${storedDimensions} (${projectionType})`);
+            }
+            compatibility.issues
+                .filter(issue => issue.severity === 'warning')
+                .forEach(issue => console.warn(`⚠️ 임베딩 경고: ${issue.message}`));
+            // metadata 보정 (기존 레거시 행 대비)
+            await this.ensureMetadataDefaults(db);
+            // memory_embedding 테이블에 저장 (트리거가 자동으로 vec0 테이블에 저장)
+            await DatabaseUtils.run(db, `
+        INSERT OR REPLACE INTO memory_embedding (
+          memory_id,
+          embedding_provider,
+          projection_type,
+          embedding,
+          dim,
+          model,
+          dimensions,
+          precision,
+          normalized,
+          version,
+          created_by,
+          created_at
+        )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, CURRENT_TIMESTAMP)
+      `, [
+                memoryId,
+                provider,
+                projectionType,
+                serializedEmbedding,
+                sourceDimensions,
+                embeddingResult.model,
+                storedDimensions,
+                32,
+                normalized,
+                1,
+                this.createdByTag
+            ]);
+            console.log(`✅ 임베딩 저장 완료: ${memoryId} (${storedDimensions}차원, ${provider})`);
+            return {
+                ...embeddingResult,
+                provider,
+                embedding: storedVector
+            };
+        }
+        catch (error) {
+            console.error(`❌ 임베딩 저장 실패 (${memoryId}):`, error);
+            return null;
+        }
+    }
+    /**
+     * 제공자별 vec0 테이블명 반환
+     */
+    getVectorTableName(provider) {
+        switch (provider) {
+            case 'tfidf':
+                return 'memory_item_vec_tfidf';
+            case 'minilm':
+                return 'memory_item_vec_minilm';
+            case 'openai':
+                return 'memory_item_vec_openai';
+            case 'gemini':
+                return 'memory_item_vec_gemini';
+            default:
+                return 'memory_item_vec_tfidf'; // 기본값
+        }
+    }
+    /**
+     * 벡터 유사도 검색
+     */
+    async searchBySimilarity(db, query, filters) {
+        if (!this.embeddingService.isAvailable()) {
+            console.warn('⚠️ 임베딩 서비스가 사용 불가능합니다.');
+            return [];
+        }
+        try {
+            // 레거시 데이터에 대해 메타데이터 보정
+            await this.ensureMetadataDefaults(db);
+            // 쿼리 임베딩 생성
+            const queryEmbedding = await this.embeddingService.generateEmbedding(query);
+            if (!queryEmbedding) {
+                return [];
+            }
+            // 제공자별 테이블에서 검색
+            const provider = this.normalizeProvider(queryEmbedding.provider);
+            const tableName = this.getVectorTableName(provider);
+            // vec0 테이블에서 유사도 검색
+            const similarities = await DatabaseUtils.all(db, `
+        SELECT 
+          m.id,
+          m.content,
+          m.type,
+          m.importance,
+          m.created_at,
+          m.last_accessed,
+          m.pinned,
+          m.tags,
+          v.distance as similarity,
+          (1 - v.distance) as score
+        FROM memory_item m
+        JOIN memory_embedding me ON m.id = me.memory_id
+        JOIN ${tableName} v ON me.id = v.rowid
+        WHERE me.embedding_provider = ?
+        ${filters?.type ? `AND m.type IN (${filters.type.map(() => '?').join(',')})` : ''}
+        ORDER BY v.distance ASC
+        LIMIT ?
+      `, [
+                provider,
+                ...(filters?.type || []),
+                filters?.limit || 10
+            ]);
+            // 결과를 VectorSearchResult 형태로 변환
+            const results = similarities.map((row) => ({
+                id: row.id,
+                content: row.content,
+                type: row.type,
+                importance: row.importance,
+                created_at: row.created_at,
+                last_accessed: row.last_accessed,
+                pinned: Boolean(row.pinned),
+                tags: this.safeParseTags(row.tags),
+                similarity: row.similarity,
+                score: row.score,
+            }));
+            return results;
+        }
+        catch (error) {
+            console.error('❌ 벡터 검색 실패:', error);
+            return [];
+        }
+    }
+    /**
+     * 임베딩 삭제
+     */
+    async deleteEmbedding(db, memoryId) {
+        try {
+            // memory_embedding 테이블에서 삭제 (트리거가 자동으로 vec0 테이블에서도 삭제)
+            await DatabaseUtils.run(db, 'DELETE FROM memory_embedding WHERE memory_id = ?', [memoryId]);
+            console.log(`✅ 임베딩 삭제 완료: ${memoryId}`);
+        }
+        catch (error) {
+            console.error(`❌ 임베딩 삭제 실패 (${memoryId}):`, error);
+        }
+    }
+    safeParseTags(rawTags) {
+        if (!rawTags) {
+            return [];
+        }
+        try {
+            const parsed = JSON.parse(rawTags);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch (error) {
+            console.warn('⚠️ 태그 JSON 파싱 실패, 빈 배열로 대체합니다.', error);
+            return [];
+        }
+    }
+    /**
+     * 임베딩 서비스 사용 가능 여부 확인
+     */
+    isAvailable() {
+        return this.embeddingService.isAvailable();
+    }
+    /**
+     * 임베딩 통계 정보
+     */
+    async getEmbeddingStats(db) {
+        try {
+            await this.ensureMetadataDefaults(db);
+            // 전체 통계
+            const stats = await DatabaseUtils.all(db, `
+        SELECT 
+          COUNT(*) as total_embeddings,
+          AVG(dimensions) as avg_dimensions
+        FROM memory_embedding
+      `);
+            // 제공자별 통계
+            const providerStats = await DatabaseUtils.all(db, `
+        SELECT 
+          embedding_provider as provider,
+          COUNT(*) as count,
+          AVG(dimensions) as dimensions
+        FROM memory_embedding
+        GROUP BY embedding_provider
+        ORDER BY count DESC
+      `);
+            const stat = stats[0];
+            return {
+                totalEmbeddings: stat.total_embeddings || 0,
+                averageDimensions: stat.avg_dimensions || 0,
+                model: this.embeddingService.getModelInfo().model,
+                providerStats: providerStats.map((row) => ({
+                    provider: this.normalizeProvider(row.provider),
+                    count: row.count,
+                    dimensions: Math.round(row.dimensions || 0),
+                })),
+            };
+        }
+        catch (error) {
+            console.error('❌ 임베딩 통계 조회 실패:', error);
+            return {
+                totalEmbeddings: 0,
+                averageDimensions: 0,
+                model: 'unknown',
+                providerStats: [],
+            };
+        }
+    }
+    normalizeProvider(provider) {
+        const normalized = (provider || '').toLowerCase();
+        switch (normalized) {
+            case 'tfidf':
+            case 'minilm':
+            case 'openai':
+            case 'gemini':
+                return normalized;
+            default:
+                return this.defaultProvider;
+        }
+    }
+    async ensureMetadataDefaults(db) {
+        try {
+            await DatabaseUtils.run(db, `
+        UPDATE memory_embedding
+        SET embedding_provider = COALESCE(
+          NULLIF(embedding_provider, ''),
+          CASE
+            WHEN model IN ('lightweight-hybrid', 'tfidf') THEN 'tfidf'
+            WHEN model LIKE '%minilm%' THEN 'minilm'
+            WHEN model LIKE '%openai%' THEN 'openai'
+            WHEN model LIKE '%gemini%' THEN 'gemini'
+            ELSE ?
+          END
+        ),
+        projection_type = COALESCE(NULLIF(projection_type, ''), 'native'),
+        precision = COALESCE(precision, 32),
+        normalized = COALESCE(normalized, 0),
+        version = COALESCE(version, 1),
+        dim = CASE
+          WHEN dim IS NULL OR dim = 0 THEN json_array_length(embedding)
+          ELSE dim
+        END,
+        dimensions = CASE
+          WHEN dimensions IS NULL OR dimensions = 0 THEN json_array_length(embedding)
+          ELSE dimensions
+        END,
+        created_by = COALESCE(created_by, 'legacy')
+        WHERE embedding_provider IS NULL
+           OR embedding_provider = ''
+           OR dimensions IS NULL
+           OR dimensions = 0
+           OR projection_type IS NULL
+           OR projection_type = ''
+           OR precision IS NULL
+           OR precision = 0
+           OR normalized IS NULL
+           OR version IS NULL
+           OR version = 0
+           OR created_by IS NULL
+      `, [this.defaultProvider]);
+        }
+        catch (error) {
+            console.warn('⚠️ 임베딩 메타데이터 보정 실패:', error);
+        }
+    }
+}
+//# sourceMappingURL=memory-embedding-service.js.map

package/dist/domains/memory/services/memory-embedding-service.js.map

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

package/dist/domains/memory/services/memory-neighbor-service.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Memory Neighbor Service
+ * 벡터 유사도를 기반으로 특정 기억의 이웃 기억을 조회하는 서비스
+ */
+import type { VectorSearchEngine } from '../../search/algorithms/vector-search-engine.js';
+import type { MemoryEmbeddingService } from './memory-embedding-service.js';
+import Database from 'better-sqlite3';
+/**
+ * 이웃 기억 조회 결과
+ */
+export interface NeighborMemory {
+    id: string;
+    content: string;
+    type: string;
+    similarity: number;
+    importance?: number;
+    created_at?: string;
+    tags?: string[];
+}
+/**
+ * 이웃 기억 조회 응답
+ */
+export interface NeighborSearchResult {
+    memory_id: string;
+    neighbors: NeighborMemory[];
+    total_count: number;
+    query_time: number;
+}
+/**
+ * 이웃 기억 조회 옵션
+ */
+export interface NeighborSearchOptions {
+    limit?: number;
+    similarity_threshold?: number;
+}
+/**
+ * 메모리를 찾을 수 없을 때 발생하는 에러
+ */
+export declare class MemoryNotFoundError extends Error {
+    constructor(memoryId: string);
+}
+/**
+ * Memory Neighbor Service
+ * 벡터 유사도를 기반으로 기억의 이웃을 찾는 서비스
+ */
+export declare class MemoryNeighborService {
+    private readonly vectorSearchEngine;
+    private readonly embeddingService;
+    private db;
+    /**
+     * 생성자
+     * @param vectorSearchEngine - 벡터 검색 엔진 인스턴스
+     * @param embeddingService - 메모리 임베딩 서비스 인스턴스
+     */
+    constructor(vectorSearchEngine: VectorSearchEngine, embeddingService: MemoryEmbeddingService);
+    /**
+     * 데이터베이스 설정
+     * VectorSearchEngine에도 데이터베이스를 설정합니다.
+     * @param db - 데이터베이스 인스턴스
+     */
+    setDatabase(db: Database.Database): void;
+    /**
+     * 특정 기억의 이웃 기억을 조회
+     * @param memoryId - 조회할 기억의 ID
+     * @param options - 조회 옵션 (limit, similarity_threshold)
+     * @returns 이웃 기억 조회 결과
+     * @throws {MemoryNotFoundError} 메모리를 찾을 수 없는 경우
+     * @throws {Error} 데이터베이스 오류, 벡터 검색 오류 등
+     */
+    getNeighbors(memoryId: string, options?: NeighborSearchOptions): Promise<NeighborSearchResult>;
+    /**
+     * 새로 저장된 기억에 대한 인접 기억 목록 갱신
+     * PRD 3.1-3.3 요구사항: 새 기억 저장 시 기존 기억들과의 유사도 계산 및 인접 기억 식별
+     *
+     * @param newMemoryId - 새로 저장된 기억의 ID
+     * @param similarityThreshold - 유사도 임계값 (기본값: 0.8)
+     * @returns 인접 기억 ID 목록 (유사도가 임계값 이상인 기억들)
+     */
+    updateNeighborsForNewMemory(newMemoryId: string, similarityThreshold?: number): Promise<string[]>;
+}
+//# sourceMappingURL=memory-neighbor-service.d.ts.map

package/dist/domains/memory/services/memory-neighbor-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-neighbor-service.d.ts","sourceRoot":"","sources":["../../../../src/domains/memory/services/memory-neighbor-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,QAAQ,EAAE,MAAM;CAI7B;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,EAAE,CAAkC;IAE5C;;;;OAIG;gBAED,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,sBAAsB;IAa1C;;;;OAIG;IACH,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAWxC;;;;;;;OAOG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAqLhC;;;;;;;OAOG;IACG,2BAA2B,CAC/B,WAAW,EAAE,MAAM,EACnB,mBAAmB,GAAE,MAAY,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC;CAuFrB"}