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

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

@@ -0,0 +1,264 @@
+/**
+ * 경량 하이브리드 임베딩 서비스
+ * TF-IDF + 키워드 매칭 기반 벡터화
+ * OpenAI가 없을 때 사용하는 fallback 솔루션
+ */
+import { getStopWords } from '../../../shared/utils/stopwords.js';
+export class LightweightEmbeddingService {
+    model = 'lightweight-hybrid';
+    dimensions = 512; // 고정 차원
+    vocabulary = new Map();
+    documentFrequencies = new Map();
+    totalDocuments = 0;
+    stopWords;
+    constructor() {
+        this.stopWords = getStopWords();
+        // stderr로 로그 출력 (MCP 프로토콜 준수)
+        process.stderr.write('✅ 경량 하이브리드 임베딩 서비스 초기화 완료\n');
+    }
+    /**
+     * 텍스트를 경량 임베딩으로 변환
+     */
+    async generateEmbedding(text) {
+        if (!text || text.trim().length === 0) {
+            throw new Error('텍스트가 비어있습니다');
+        }
+        try {
+            // 1. 텍스트 전처리
+            const processedText = this.preprocessText(text);
+            // 2. TF-IDF 벡터 생성
+            const tfidfVector = this.createTFIDFVector(processedText);
+            // 3. 키워드 가중치 적용
+            const weightedVector = this.applyKeywordWeights(tfidfVector, processedText);
+            // 4. 벡터 정규화
+            const normalizedVector = this.normalizeVector(weightedVector);
+            // 5. 차원 맞추기 (패딩 또는 자르기)
+            const finalVector = this.adjustDimensions(normalizedVector);
+            return {
+                embedding: finalVector,
+                model: this.model,
+                provider: 'tfidf',
+                usage: {
+                    prompt_tokens: this.estimateTokens(text),
+                    total_tokens: this.estimateTokens(text),
+                },
+            };
+        }
+        catch (error) {
+            console.error('❌ 경량 임베딩 생성 실패:', error);
+            throw new Error(`경량 임베딩 생성 실패: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * 쿼리와 유사한 임베딩 검색
+     */
+    async searchSimilar(query, embeddings, limit = 10, threshold = 0.7) {
+        // 쿼리 임베딩 생성
+        const queryEmbedding = await this.generateEmbedding(query);
+        if (!queryEmbedding) {
+            return [];
+        }
+        // 코사인 유사도 계산
+        const similarities = embeddings.map(item => {
+            const similarity = this.cosineSimilarity(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);
+    }
+    /**
+     * 텍스트 전처리
+     */
+    preprocessText(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s가-힣]/g, ' ') // 특수문자 제거, 한글 유지
+            .split(/\s+/)
+            .filter(word => word.length > 1 && !this.stopWords.has(word))
+            .filter(word => word.trim().length > 0);
+    }
+    /**
+     * TF-IDF 벡터 생성
+     */
+    createTFIDFVector(words) {
+        const vector = new Array(this.dimensions).fill(0);
+        const wordCounts = new Map();
+        // 단어 빈도 계산
+        for (const word of words) {
+            wordCounts.set(word, (wordCounts.get(word) || 0) + 1);
+        }
+        // TF-IDF 계산
+        for (const [word, count] of wordCounts) {
+            const tf = count / words.length; // Term Frequency
+            const idf = this.calculateIDF(word); // Inverse Document Frequency
+            const tfidf = tf * idf;
+            // 해시 기반 인덱스 생성
+            const index = this.hashToIndex(word);
+            vector[index] += tfidf;
+        }
+        return vector;
+    }
+    /**
+     * IDF 계산 (간단한 휴리스틱)
+     */
+    calculateIDF(word) {
+        // 실제로는 문서 컬렉션에서 계산해야 하지만, 
+        // 여기서는 단어 길이와 복잡성을 기반으로 휴리스틱 사용
+        const wordLength = word.length;
+        const hasNumbers = /\d/.test(word);
+        const hasSpecialChars = /[^a-zA-Z가-힣]/.test(word);
+        let idf = 1.0;
+        // 긴 단어일수록 높은 IDF
+        if (wordLength > 5)
+            idf += 0.5;
+        if (wordLength > 8)
+            idf += 0.3;
+        // 숫자가 포함된 단어는 낮은 IDF (일반적으로 덜 중요)
+        if (hasNumbers)
+            idf -= 0.2;
+        // 특수문자가 포함된 단어는 높은 IDF (고유할 가능성)
+        if (hasSpecialChars)
+            idf += 0.3;
+        return Math.max(0.1, idf);
+    }
+    /**
+     * 키워드 가중치 적용
+     */
+    applyKeywordWeights(vector, words) {
+        const weightedVector = [...vector];
+        // 중요한 키워드 패턴에 가중치 적용
+        for (const word of words) {
+            if (!word || word.trim().length === 0)
+                continue; // undefined 및 빈 문자열 체크
+            const index = this.hashToIndex(word);
+            // 배열 범위 체크
+            if (index < 0 || index >= weightedVector.length)
+                continue;
+            // 안전한 배열 접근을 위한 체크
+            const currentValue = weightedVector[index];
+            if (currentValue === undefined)
+                continue;
+            // 기술 용어 가중치
+            if (this.isTechnicalTerm(word)) {
+                weightedVector[index] = currentValue * 1.5;
+            }
+            // 고유명사 가중치 (대문자로 시작하는 단어)
+            if (word.length > 2 && word[0] && word[0] === word[0].toUpperCase()) {
+                weightedVector[index] = currentValue * 1.3;
+            }
+            // 반복되는 단어 가중치 감소
+            const wordFrequency = words.filter(w => w === word).length;
+            if (wordFrequency > 3) {
+                weightedVector[index] = currentValue * 0.8;
+            }
+        }
+        return weightedVector;
+    }
+    /**
+     * 기술 용어 판별
+     */
+    isTechnicalTerm(word) {
+        const technicalPatterns = [
+            /^[a-z]+[A-Z]/, // camelCase
+            /^[A-Z][a-z]+[A-Z]/, // PascalCase
+            /^[a-z]+_[a-z]+/, // snake_case
+            /^[a-z]+-[a-z]+/, // kebab-case
+            /api|sdk|http|json|xml|sql|db|ui|ux|ai|ml|nlp/i, // 기술 용어
+            /react|vue|angular|node|python|java|typescript/i, // 프레임워크/언어
+        ];
+        return technicalPatterns.some(pattern => pattern.test(word));
+    }
+    /**
+     * 벡터 정규화
+     */
+    normalizeVector(vector) {
+        const magnitude = Math.sqrt(vector.reduce((sum, val) => sum + val * val, 0));
+        if (magnitude === 0)
+            return vector;
+        return vector.map(val => val / magnitude);
+    }
+    /**
+     * 차원 조정
+     */
+    adjustDimensions(vector) {
+        if (vector.length === this.dimensions) {
+            return vector;
+        }
+        else if (vector.length < this.dimensions) {
+            // 패딩
+            return [...vector, ...new Array(this.dimensions - vector.length).fill(0)];
+        }
+        else {
+            // 자르기
+            return vector.slice(0, this.dimensions);
+        }
+    }
+    /**
+     * 해시 기반 인덱스 생성
+     */
+    hashToIndex(word) {
+        let hash = 0;
+        for (let i = 0; i < word.length; i++) {
+            const char = word.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // 32비트 정수로 변환
+        }
+        return Math.abs(hash) % this.dimensions;
+    }
+    /**
+     * 코사인 유사도 계산
+     */
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length) {
+            throw new Error('벡터 차원이 일치하지 않습니다');
+        }
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            const aVal = a[i] || 0;
+            const bVal = b[i] || 0;
+            dotProduct += aVal * bVal;
+            normA += aVal * aVal;
+            normB += bVal * bVal;
+        }
+        normA = Math.sqrt(normA);
+        normB = Math.sqrt(normB);
+        if (normA === 0 || normB === 0) {
+            return 0;
+        }
+        return dotProduct / (normA * normB);
+    }
+    /**
+     * 토큰 수 추정
+     */
+    estimateTokens(text) {
+        // 간단한 추정: 1 토큰 ≈ 4 문자
+        return Math.ceil(text.length / 4);
+    }
+    /**
+     * 서비스 사용 가능 여부 확인
+     */
+    isAvailable() {
+        return true; // 항상 사용 가능
+    }
+    /**
+     * 모델 정보 반환
+     */
+    getModelInfo() {
+        return {
+            model: this.model,
+            dimensions: this.dimensions,
+            maxTokens: 8191, // OpenAI와 동일한 제한
+        };
+    }
+}
+//# sourceMappingURL=lightweight-embedding-service.js.map

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

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

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

@@ -0,0 +1,93 @@
+/**
+ * MiniLM 임베딩 서비스
+ * all-MiniLM-L6-v2 모델을 사용한 경량 임베딩 서비스
+ *
+ * 클린코드 원칙:
+ * - 단일 책임 원칙: 임베딩 생성만 담당
+ * - 의존성 역전: 인터페이스에 의존
+ * - 개방-폐쇄: 확장에는 열려있고 수정에는 닫혀있음
+ */
+import type { EmbeddingServiceInterface, EmbeddingResult, SimilarityResult, EmbeddingData } from '../../../shared/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;
+    /**
+     * 실제 모델 로딩
+     * Node.js 환경에서 Worker 스레드 문제를 방지하기 위해 옵션 설정
+     */
+    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/domains/embedding/services/minilm-embedding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minilm-embedding-service.d.ts","sourceRoot":"","sources":["../../../../src/domains/embedding/services/minilm-embedding-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,0CAA0C,CAAC;AAsBlD,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;;IAO5D;;;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;;;OAGG;YACW,SAAS;IAqCvB;;;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/domains/embedding/services/minilm-embedding-service.js.map

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

package/dist/domains/embedding/services/openai-embedding-service.d.ts

@@ -0,0 +1,36 @@
+/**
+ * OpenAI 임베딩 서비스
+ * text-embedding-3 시리즈를 활용해 고차원 임베딩 제공
+ */
+import type { EmbeddingServiceInterface, EmbeddingResult, SimilarityResult, EmbeddingData } from '../../../shared/types/embedding.types.js';
+export declare class OpenAIEmbeddingService implements EmbeddingServiceInterface {
+    private client;
+    private readonly model;
+    private readonly dimensions;
+    private readonly maxTokens;
+    private readonly cache;
+    private readonly fallbackService;
+    constructor();
+    /**
+     * OpenAI 클라이언트를 초기화
+     */
+    private initializeClient;
+    isAvailable(): boolean;
+    getModelInfo(): {
+        model: string;
+        dimensions: number;
+        maxTokens: number;
+    };
+    generateEmbedding(text: string): Promise<EmbeddingResult | null>;
+    searchSimilar(query: string, embeddings: EmbeddingData[], limit?: number, threshold?: number): Promise<SimilarityResult[]>;
+    private generateOpenAIEmbedding;
+    private generateFallbackEmbedding;
+    private validateInput;
+    private truncateText;
+    private estimateTokens;
+    private cosineSimilarity;
+    private generateCacheKey;
+    private hashText;
+    private cleanupCache;
+}
+//# sourceMappingURL=openai-embedding-service.d.ts.map

package/dist/domains/embedding/services/openai-embedding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-embedding-service.d.ts","sourceRoot":"","sources":["../../../../src/domains/embedding/services/openai-embedding-service.ts"],"names":[],"mappings":"AACA;;;GAGG;AAIH,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,0CAA0C,CAAC;AAGlD,qBAAa,sBAAuB,YAAW,yBAAyB;IACtE,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;;IAWrE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAQlE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA0BhE,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,GAAE,MAAW,EAClB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAsBhB,uBAAuB;YA2BvB,yBAAyB;IAmBvC,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,YAAY;CAYrB"}

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

@@ -0,0 +1,192 @@
+/**
+ * OpenAI 임베딩 서비스
+ * text-embedding-3 시리즈를 활용해 고차원 임베딩 제공
+ */
+import OpenAI from 'openai';
+import { mementoConfig } from '../../../shared/config/index.js';
+import { LightweightEmbeddingService } from './lightweight-embedding-service.js';
+export class OpenAIEmbeddingService {
+    client = null;
+    model;
+    dimensions;
+    maxTokens;
+    cache = new Map();
+    fallbackService = new LightweightEmbeddingService();
+    constructor() {
+        this.model = mementoConfig.openaiModel || 'text-embedding-3-small';
+        // text-embedding-3-small = 1536, text-embedding-3-large = 3072
+        this.dimensions = mementoConfig.embeddingDimensions || 1536;
+        this.maxTokens = 8191; // OpenAI 공식 문서 기준
+        this.initializeClient();
+    }
+    /**
+     * OpenAI 클라이언트를 초기화
+     */
+    initializeClient() {
+        if (!mementoConfig.openaiApiKey) {
+            console.warn('⚠️ OPENAI_API_KEY가 설정되지 않아 OpenAI 임베딩이 비활성화됩니다. ' +
+                '고품질 임베딩이 필요하면 키를 설정하거나 EMBEDDING_PROVIDER를 minilm으로 변경하세요.');
+            this.client = null;
+            return;
+        }
+        try {
+            this.client = new OpenAI({ apiKey: mementoConfig.openaiApiKey });
+            console.log('✅ OpenAI 임베딩 서비스 초기화 완료');
+        }
+        catch (error) {
+            console.error('❌ OpenAI 초기화 실패. OPENAI_API_KEY 값과 네트워크 접근 권한을 확인하거나 MiniLM/TFiDF 모델로 폴백하세요:', error);
+            this.client = null;
+        }
+    }
+    isAvailable() {
+        return this.client !== null;
+    }
+    getModelInfo() {
+        return {
+            model: this.model,
+            dimensions: this.dimensions,
+            maxTokens: this.maxTokens
+        };
+    }
+    async generateEmbedding(text) {
+        this.validateInput(text);
+        const cacheKey = this.generateCacheKey(text);
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        try {
+            if (!this.client && mementoConfig.openaiApiKey) {
+                this.initializeClient();
+            }
+            const result = await this.generateOpenAIEmbedding(text);
+            if (result) {
+                this.cache.set(cacheKey, result);
+                this.cleanupCache();
+            }
+            return result;
+        }
+        catch (error) {
+            console.warn('⚠️ OpenAI 임베딩 생성 실패, 경량 서비스로 fallback:', error);
+            return this.generateFallbackEmbedding(text, cacheKey);
+        }
+    }
+    async searchSimilar(query, embeddings, limit = 10, threshold = 0.7) {
+        if (embeddings.length === 0) {
+            return [];
+        }
+        const queryEmbedding = await this.generateEmbedding(query);
+        if (!queryEmbedding) {
+            return [];
+        }
+        return embeddings
+            .map(item => ({
+            id: item.id,
+            content: item.content,
+            similarity: this.cosineSimilarity(queryEmbedding.embedding, item.embedding),
+            score: this.cosineSimilarity(queryEmbedding.embedding, item.embedding)
+        }))
+            .filter(item => item.similarity >= threshold)
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, limit);
+    }
+    async generateOpenAIEmbedding(text) {
+        if (!this.client) {
+            throw new Error('OpenAI 클라이언트가 초기화되지 않았습니다.');
+        }
+        const truncatedText = this.truncateText(text);
+        const response = await this.client.embeddings.create({
+            model: this.model,
+            input: truncatedText
+        });
+        const embedding = response.data?.[0]?.embedding ?? [];
+        if (embedding.length === 0) {
+            throw new Error('OpenAI 임베딩 응답이 비어 있습니다.');
+        }
+        return {
+            embedding,
+            model: this.model,
+            provider: 'openai',
+            usage: {
+                prompt_tokens: response.usage?.prompt_tokens ?? this.estimateTokens(truncatedText),
+                total_tokens: response.usage?.total_tokens ?? this.estimateTokens(truncatedText)
+            }
+        };
+    }
+    async generateFallbackEmbedding(text, cacheKey) {
+        try {
+            const fallbackResult = await this.fallbackService.generateEmbedding(text);
+            if (fallbackResult) {
+                const patchedResult = {
+                    ...fallbackResult,
+                    provider: fallbackResult.provider ?? 'tfidf'
+                };
+                this.cache.set(cacheKey, patchedResult);
+                this.cleanupCache();
+                return patchedResult;
+            }
+            return null;
+        }
+        catch (fallbackError) {
+            console.error('❌ 경량 임베딩 fallback도 실패했습니다:', fallbackError);
+            return null;
+        }
+    }
+    validateInput(text) {
+        if (!text || text.trim().length === 0) {
+            throw new Error('텍스트가 비어 있습니다');
+        }
+    }
+    truncateText(text) {
+        const estimatedTokens = this.estimateTokens(text);
+        if (estimatedTokens <= this.maxTokens) {
+            return text;
+        }
+        const maxChars = this.maxTokens * 4;
+        return text.substring(0, maxChars);
+    }
+    estimateTokens(text) {
+        return Math.ceil(text.length / 4);
+    }
+    cosineSimilarity(vecA, vecB) {
+        if (vecA.length !== vecB.length) {
+            throw new Error('벡터 차원이 일치하지 않습니다');
+        }
+        let dot = 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;
+            dot += a * b;
+            normA += a * a;
+            normB += b * b;
+        }
+        const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+        return denominator === 0 ? 0 : dot / denominator;
+    }
+    generateCacheKey(text) {
+        return `openai:${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 |= 0; // 32bit 변환
+        }
+        return hash.toString(36);
+    }
+    cleanupCache() {
+        const MAX_CACHE_SIZE = 1000;
+        if (this.cache.size <= MAX_CACHE_SIZE) {
+            return;
+        }
+        const entries = Array.from(this.cache.entries());
+        this.cache.clear();
+        entries.slice(-MAX_CACHE_SIZE / 2).forEach(([key, value]) => {
+            this.cache.set(key, value);
+        });
+    }
+}
+//# sourceMappingURL=openai-embedding-service.js.map

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

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