memento-mcp-server 0.1.0

package/dist/services/lightweight-embedding-service.js.map

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

package/dist/services/memory-embedding-service.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 메모리 임베딩 저장 및 검색 서비스
+ * 데이터베이스와 임베딩 서비스를 연동
+ */
+import type { EmbeddingResult } from '../types/embedding.types.js';
+import type { MemoryType } from '../types/index.js';
+export interface MemoryEmbedding {
+    memory_id: string;
+    embedding: number[];
+    created_at: string;
+}
+export interface VectorSearchResult {
+    id: string;
+    content: string;
+    type: string;
+    importance: number;
+    created_at: string;
+    last_accessed?: string;
+    pinned: boolean;
+    tags?: string[];
+    similarity: number;
+    score: number;
+}
+export declare class MemoryEmbeddingService {
+    private embeddingService;
+    constructor();
+    /**
+     * sqlite-vec 확장 로드
+     */
+    private loadVecExtension;
+    /**
+     * 메모리에 임베딩 생성 및 저장
+     */
+    createAndStoreEmbedding(db: any, memoryId: string, content: string, type: MemoryType): Promise<EmbeddingResult | null>;
+    /**
+     * 제공자별 vec0 테이블명 반환
+     */
+    private getVectorTableName;
+    /**
+     * 벡터 유사도 검색
+     */
+    searchBySimilarity(db: any, query: string, filters?: {
+        type?: MemoryType[];
+        limit?: number;
+        threshold?: number;
+    }): Promise<VectorSearchResult[]>;
+    /**
+     * 임베딩 삭제
+     */
+    deleteEmbedding(db: any, memoryId: string): Promise<void>;
+    /**
+     * 임베딩 서비스 사용 가능 여부 확인
+     */
+    isAvailable(): boolean;
+    /**
+     * 임베딩 통계 정보
+     */
+    getEmbeddingStats(db: any): Promise<{
+        totalEmbeddings: number;
+        averageDimensions: number;
+        model: string;
+        providerStats: Array<{
+            provider: string;
+            count: number;
+            dimensions: number;
+        }>;
+    }>;
+}
+//# sourceMappingURL=memory-embedding-service.d.ts.map

package/dist/services/memory-embedding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-embedding-service.d.ts","sourceRoot":"","sources":["../../src/services/memory-embedding-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,gBAAgB,CAA0B;;IAMlD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACG,uBAAuB,CAC3B,EAAE,EAAE,GAAG,EACP,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAkDlC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACG,kBAAkB,CACtB,EAAE,EAAE,GAAG,EACP,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAiEhC;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB/D;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,iBAAiB,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC;QACxC,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,KAAK,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC;CA2CH"}

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

@@ -0,0 +1,223 @@
+/**
+ * 메모리 임베딩 저장 및 검색 서비스
+ * 데이터베이스와 임베딩 서비스를 연동
+ */
+import { UnifiedEmbeddingService } from './unified-embedding-service.js';
+import { DatabaseUtils } from '../utils/database.js';
+export class MemoryEmbeddingService {
+    embeddingService;
+    constructor() {
+        this.embeddingService = new UnifiedEmbeddingService();
+    }
+    /**
+     * sqlite-vec 확장 로드
+     */
+    loadVecExtension(db) {
+        try {
+            db.loadExtension('/usr/lib/vec0');
+        }
+        catch (error) {
+            console.warn('⚠️ sqlite-vec 확장 로드 실패:', error);
+        }
+    }
+    /**
+     * 메모리에 임베딩 생성 및 저장
+     */
+    async createAndStoreEmbedding(db, memoryId, content, type) {
+        if (!this.embeddingService.isAvailable()) {
+            console.warn('⚠️ 임베딩 서비스가 사용 불가능합니다. 임베딩을 건너뜁니다.');
+            return null;
+        }
+        try {
+            // sqlite-vec 확장 로드
+            this.loadVecExtension(db);
+            // 임베딩 생성
+            const embeddingResult = await this.embeddingService.generateEmbedding(content);
+            if (!embeddingResult) {
+                return null;
+            }
+            // 제공자별 테이블명 결정
+            const tableName = this.getVectorTableName(embeddingResult.provider || 'tfidf');
+            // memory_embedding 테이블에 저장
+            await DatabaseUtils.run(db, `
+        INSERT OR REPLACE INTO memory_embedding (memory_id, embedding, dim, model, embedding_provider, dimensions, created_at)
+        VALUES (?, ?, ?, ?, ?, ?, CURRENT_TIMESTAMP)
+      `, [
+                memoryId,
+                JSON.stringify(embeddingResult.embedding),
+                embeddingResult.embedding.length,
+                embeddingResult.model,
+                embeddingResult.provider,
+                embeddingResult.embedding.length,
+            ]);
+            // vec0 테이블에 저장
+            await DatabaseUtils.run(db, `
+        INSERT OR REPLACE INTO ${tableName} (rowid, embedding)
+        VALUES ((SELECT rowid FROM memory_embedding WHERE memory_id = ?), ?)
+      `, [
+                memoryId,
+                JSON.stringify(embeddingResult.embedding)
+            ]);
+            console.log(`✅ 임베딩 저장 완료: ${memoryId} (${embeddingResult.embedding.length}차원, ${embeddingResult.provider})`);
+            return embeddingResult;
+        }
+        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 {
+            // 쿼리 임베딩 생성
+            const queryEmbedding = await this.embeddingService.generateEmbedding(query);
+            if (!queryEmbedding) {
+                return [];
+            }
+            // 제공자별 테이블에서 검색
+            const tableName = this.getVectorTableName(queryEmbedding.provider || 'tfidf');
+            // 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.rowid = v.rowid
+        WHERE me.embedding_provider = ?
+        ${filters?.type ? `AND m.type IN (${filters.type.map(() => '?').join(',')})` : ''}
+        ORDER BY v.distance ASC
+        LIMIT ?
+      `, [
+                queryEmbedding.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: row.pinned,
+                tags: row.tags ? JSON.parse(row.tags) : [],
+                similarity: row.similarity,
+                score: row.score,
+            }));
+            return results;
+        }
+        catch (error) {
+            console.error('❌ 벡터 검색 실패:', error);
+            return [];
+        }
+    }
+    /**
+     * 임베딩 삭제
+     */
+    async deleteEmbedding(db, memoryId) {
+        try {
+            // 제공자 정보 가져오기
+            const embeddingInfo = await DatabaseUtils.get(db, `
+        SELECT embedding_provider FROM memory_embedding WHERE memory_id = ?
+      `, [memoryId]);
+            if (embeddingInfo) {
+                // 해당 제공자의 vec0 테이블에서 삭제
+                const tableName = this.getVectorTableName(embeddingInfo.embedding_provider);
+                await DatabaseUtils.run(db, `
+          DELETE FROM ${tableName} 
+          WHERE rowid = (SELECT rowid FROM memory_embedding WHERE memory_id = ?)
+        `, [memoryId]);
+            }
+            // memory_embedding 테이블에서 삭제
+            await DatabaseUtils.run(db, 'DELETE FROM memory_embedding WHERE memory_id = ?', [memoryId]);
+            console.log(`✅ 임베딩 삭제 완료: ${memoryId}`);
+        }
+        catch (error) {
+            console.error(`❌ 임베딩 삭제 실패 (${memoryId}):`, error);
+        }
+    }
+    /**
+     * 임베딩 서비스 사용 가능 여부 확인
+     */
+    isAvailable() {
+        return this.embeddingService.isAvailable();
+    }
+    /**
+     * 임베딩 통계 정보
+     */
+    async getEmbeddingStats(db) {
+        try {
+            // 전체 통계
+            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: row.provider,
+                    count: row.count,
+                    dimensions: Math.round(row.dimensions),
+                })),
+            };
+        }
+        catch (error) {
+            console.error('❌ 임베딩 통계 조회 실패:', error);
+            return {
+                totalEmbeddings: 0,
+                averageDimensions: 0,
+                model: 'unknown',
+                providerStats: [],
+            };
+        }
+    }
+}
+//# sourceMappingURL=memory-embedding-service.js.map

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

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

package/dist/services/minilm-embedding-service.d.ts

@@ -0,0 +1,92 @@
+/**
+ * MiniLM 임베딩 서비스
+ * all-MiniLM-L6-v2 모델을 사용한 경량 임베딩 서비스
+ *
+ * 클린코드 원칙:
+ * - 단일 책임 원칙: 임베딩 생성만 담당
+ * - 의존성 역전: 인터페이스에 의존
+ * - 개방-폐쇄: 확장에는 열려있고 수정에는 닫혀있음
+ */
+import type { EmbeddingServiceInterface, EmbeddingResult, SimilarityResult, EmbeddingData } from '../types/embedding.types.js';
+export declare class MiniLMEmbeddingService implements EmbeddingServiceInterface {
+    private static readonly MODEL_NAME;
+    private static readonly DIMENSIONS;
+    private static readonly MAX_TOKENS;
+    private static readonly CACHE_TTL;
+    private readonly modelName;
+    private readonly dimensions;
+    private readonly maxTokens;
+    private model;
+    private loadingPromise;
+    private readonly cache;
+    constructor();
+    /**
+     * 텍스트를 임베딩 벡터로 변환
+     * TDD: 빈 텍스트 검증, 모델 로딩, 캐싱 적용
+     */
+    generateEmbedding(text: string): Promise<EmbeddingResult | null>;
+    /**
+     * 쿼리와 유사한 임베딩 검색
+     * TDD: 빈 배열 처리, 임계값 적용, 개수 제한
+     */
+    searchSimilar(query: string, embeddings: EmbeddingData[], limit?: number, threshold?: number): Promise<SimilarityResult[]>;
+    /**
+     * 서비스 사용 가능 여부 확인
+     * TDD: 모델 로딩 상태 확인
+     */
+    isAvailable(): boolean;
+    /**
+     * 모델 정보 반환
+     * TDD: 올바른 정보 반환
+     */
+    getModelInfo(): {
+        model: string;
+        dimensions: number;
+        maxTokens: number;
+    };
+    /**
+     * 입력 검증
+     * 클린코드: 단일 책임 원칙 - 검증만 담당
+     */
+    private validateInput;
+    /**
+     * 모델 로딩 (지연 로딩)
+     * 클린코드: 단일 책임 원칙 - 모델 로딩만 담당
+     */
+    private getModel;
+    /**
+     * 실제 모델 로딩
+     */
+    private loadModel;
+    /**
+     * 텍스트 전처리
+     * 클린코드: 단일 책임 원칙 - 전처리만 담당
+     */
+    private preprocessText;
+    /**
+     * 캐시 키 생성
+     */
+    private generateCacheKey;
+    /**
+     * 텍스트 해시 생성
+     */
+    private hashText;
+    /**
+     * 토큰 수 추정
+     */
+    private estimateTokens;
+    /**
+     * 코사인 유사도 계산
+     * 클린코드: 단일 책임 원칙 - 수학 계산만 담당
+     */
+    private calculateCosineSimilarity;
+    /**
+     * 캐시 정리
+     */
+    clearCache(): void;
+    /**
+     * 메모리 사용량 확인
+     */
+    getCacheSize(): number;
+}
+//# sourceMappingURL=minilm-embedding-service.d.ts.map

package/dist/services/minilm-embedding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minilm-embedding-service.d.ts","sourceRoot":"","sources":["../../src/services/minilm-embedding-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,6BAA6B,CAAC;AAErC,qBAAa,sBAAuB,YAAW,yBAAyB;IAEtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAO;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAO;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAExD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;;IAM5D;;;OAGG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAsCtE;;;OAGG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,GAAE,MAAW,EAClB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA6B9B;;;OAGG;IACH,WAAW,IAAI,OAAO;IAMtB;;;OAGG;IACH,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAQxE;;;OAGG;IACH,OAAO,CAAC,aAAa;IAMrB;;;OAGG;YACW,QAAQ;IActB;;OAEG;YACW,SAAS;IAcvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAUhB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB"}

package/dist/services/minilm-embedding-service.js

@@ -0,0 +1,216 @@
+/**
+ * MiniLM 임베딩 서비스
+ * all-MiniLM-L6-v2 모델을 사용한 경량 임베딩 서비스
+ *
+ * 클린코드 원칙:
+ * - 단일 책임 원칙: 임베딩 생성만 담당
+ * - 의존성 역전: 인터페이스에 의존
+ * - 개방-폐쇄: 확장에는 열려있고 수정에는 닫혀있음
+ */
+import { pipeline } from '@xenova/transformers';
+export class MiniLMEmbeddingService {
+    // 상수 정의
+    static MODEL_NAME = 'all-MiniLM-L6-v2';
+    static DIMENSIONS = 384;
+    static MAX_TOKENS = 256;
+    static CACHE_TTL = 24 * 60 * 60 * 1000; // 24시간
+    modelName = MiniLMEmbeddingService.MODEL_NAME;
+    dimensions = MiniLMEmbeddingService.DIMENSIONS;
+    maxTokens = MiniLMEmbeddingService.MAX_TOKENS;
+    model = null;
+    loadingPromise = null;
+    cache = new Map();
+    constructor() {
+        console.log('✅ MiniLM 임베딩 서비스 초기화 완료');
+    }
+    /**
+     * 텍스트를 임베딩 벡터로 변환
+     * TDD: 빈 텍스트 검증, 모델 로딩, 캐싱 적용
+     */
+    async generateEmbedding(text) {
+        this.validateInput(text);
+        const cacheKey = this.generateCacheKey(text);
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        try {
+            const model = await this.getModel();
+            const processedText = this.preprocessText(text);
+            const result = await model(processedText, {
+                pooling: 'mean',
+                normalize: true
+            });
+            // result가 이미 배열이거나 data 속성을 가진 객체일 수 있음
+            const embedding = Array.isArray(result) ? result : Array.from(result.data || result);
+            const embeddingResult = {
+                embedding,
+                model: this.modelName,
+                usage: {
+                    prompt_tokens: this.estimateTokens(text),
+                    total_tokens: this.estimateTokens(text)
+                }
+            };
+            this.cache.set(cacheKey, embeddingResult);
+            return embeddingResult;
+        }
+        catch (error) {
+            console.error('❌ MiniLM 임베딩 생성 실패:', error);
+            throw new Error(`MiniLM 임베딩 생성 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * 쿼리와 유사한 임베딩 검색
+     * TDD: 빈 배열 처리, 임계값 적용, 개수 제한
+     */
+    async searchSimilar(query, embeddings, limit = 10, threshold = 0.7) {
+        if (embeddings.length === 0) {
+            return [];
+        }
+        const queryEmbedding = await this.generateEmbedding(query);
+        if (!queryEmbedding) {
+            return [];
+        }
+        const similarities = embeddings.map(item => {
+            const similarity = this.calculateCosineSimilarity(queryEmbedding.embedding, item.embedding);
+            return {
+                id: item.id,
+                content: item.content,
+                similarity,
+                score: similarity
+            };
+        });
+        return similarities
+            .filter(item => item.similarity >= threshold)
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, limit);
+    }
+    /**
+     * 서비스 사용 가능 여부 확인
+     * TDD: 모델 로딩 상태 확인
+     */
+    isAvailable() {
+        // MiniLM은 항상 사용 가능 (모델이 로드되지 않아도 사용 가능)
+        // 실제 모델 로딩은 generateEmbedding 호출 시 lazy loading
+        return true;
+    }
+    /**
+     * 모델 정보 반환
+     * TDD: 올바른 정보 반환
+     */
+    getModelInfo() {
+        return {
+            model: this.modelName,
+            dimensions: this.dimensions,
+            maxTokens: this.maxTokens
+        };
+    }
+    /**
+     * 입력 검증
+     * 클린코드: 단일 책임 원칙 - 검증만 담당
+     */
+    validateInput(text) {
+        if (!text || text.trim().length === 0) {
+            throw new Error('텍스트가 비어있습니다');
+        }
+    }
+    /**
+     * 모델 로딩 (지연 로딩)
+     * 클린코드: 단일 책임 원칙 - 모델 로딩만 담당
+     */
+    async getModel() {
+        if (this.model) {
+            return this.model;
+        }
+        if (this.loadingPromise) {
+            return await this.loadingPromise;
+        }
+        this.loadingPromise = this.loadModel();
+        this.model = await this.loadingPromise;
+        return this.model;
+    }
+    /**
+     * 실제 모델 로딩
+     */
+    async loadModel() {
+        try {
+            const model = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2');
+            console.log('✅ MiniLM 모델 로딩 완료');
+            return model;
+        }
+        catch (error) {
+            console.error('❌ MiniLM 모델 로딩 실패:', error);
+            throw new Error(`모델 로딩 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * 텍스트 전처리
+     * 클린코드: 단일 책임 원칙 - 전처리만 담당
+     */
+    preprocessText(text) {
+        return text
+            .trim()
+            .toLowerCase()
+            .replace(/\s+/g, ' ')
+            .substring(0, this.maxTokens * 4); // 토큰 수 제한
+    }
+    /**
+     * 캐시 키 생성
+     */
+    generateCacheKey(text) {
+        return `minilm:${this.hashText(text)}`;
+    }
+    /**
+     * 텍스트 해시 생성
+     */
+    hashText(text) {
+        let hash = 0;
+        for (let i = 0; i < text.length; i++) {
+            const char = text.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // 32bit 정수로 변환
+        }
+        return hash.toString(36);
+    }
+    /**
+     * 토큰 수 추정
+     */
+    estimateTokens(text) {
+        // 간단한 토큰 추정 (실제로는 더 정교한 방법 필요)
+        return Math.ceil(text.length / 4);
+    }
+    /**
+     * 코사인 유사도 계산
+     * 클린코드: 단일 책임 원칙 - 수학 계산만 담당
+     */
+    calculateCosineSimilarity(vecA, vecB) {
+        if (vecA.length !== vecB.length) {
+            throw new Error('벡터 차원이 일치하지 않습니다');
+        }
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < vecA.length; i++) {
+            const a = vecA[i] ?? 0;
+            const b = vecB[i] ?? 0;
+            dotProduct += a * b;
+            normA += a * a;
+            normB += b * b;
+        }
+        const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+        return magnitude === 0 ? 0 : dotProduct / magnitude;
+    }
+    /**
+     * 캐시 정리
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * 메모리 사용량 확인
+     */
+    getCacheSize() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=minilm-embedding-service.js.map

package/dist/services/minilm-embedding-service.js.map

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