@ninebix/nmt-system 1.0.0

package/dist/services/query-cache.js

@@ -0,0 +1,255 @@
+/**
+ * Query Cache Service
+ * 유사 쿼리 캐싱으로 LLM 호출 절감
+ *
+ * @module services/query-cache
+ */
+import { sha3_256 } from 'js-sha3';
+import { cosineSimilarity } from '../utils/similarity.js';
+/**
+ * Query Cache 클래스
+ */
+export class QueryCache {
+    cache = new Map();
+    embeddingIndex = new Map();
+    config;
+    // 통계
+    stats = {
+        hits: 0,
+        misses: 0,
+        savedTokens: 0
+    };
+    constructor(config = {}) {
+        this.config = {
+            maxEntries: config.maxEntries ?? 10000,
+            ttlMs: config.ttlMs ?? 3600000, // 1시간
+            semanticThreshold: config.semanticThreshold ?? 0.92,
+            enableSemanticMatch: config.enableSemanticMatch ?? true,
+            costPerToken: config.costPerToken ?? 0.00003 // GPT-4 기준
+        };
+        // 주기적 정리
+        setInterval(() => this.cleanup(), 60000);
+    }
+    /**
+     * 쿼리 해시 생성
+     */
+    hashQuery(query) {
+        const normalized = query.toLowerCase().trim().replace(/\s+/g, ' ');
+        return sha3_256(normalized);
+    }
+    /**
+     * 캐시 조회
+     */
+    get(query, queryEmbedding) {
+        const hash = this.hashQuery(query);
+        // 1. 정확히 일치하는 캐시 확인
+        if (this.cache.has(hash)) {
+            const entry = this.cache.get(hash);
+            // TTL 확인
+            if (Date.now() - entry.timestamp < this.config.ttlMs) {
+                entry.hitCount++;
+                this.stats.hits++;
+                this.stats.savedTokens += (entry.tokenUsage?.prompt ?? 0) + (entry.tokenUsage?.completion ?? 0);
+                return {
+                    hit: true,
+                    entry,
+                    similarity: 1.0,
+                    type: 'exact'
+                };
+            }
+            else {
+                // 만료됨
+                this.cache.delete(hash);
+                this.embeddingIndex.delete(hash);
+            }
+        }
+        // 2. 시맨틱 유사도 기반 매칭
+        if (this.config.enableSemanticMatch && queryEmbedding) {
+            const bestMatch = this.findSemanticMatch(queryEmbedding);
+            if (bestMatch) {
+                bestMatch.entry.hitCount++;
+                this.stats.hits++;
+                this.stats.savedTokens += (bestMatch.entry.tokenUsage?.prompt ?? 0) + (bestMatch.entry.tokenUsage?.completion ?? 0);
+                return {
+                    hit: true,
+                    entry: bestMatch.entry,
+                    similarity: bestMatch.similarity,
+                    type: 'semantic'
+                };
+            }
+        }
+        this.stats.misses++;
+        return { hit: false };
+    }
+    /**
+     * 시맨틱 매칭
+     */
+    findSemanticMatch(queryEmbedding) {
+        let bestEntry = null;
+        let bestSimilarity = 0;
+        for (const [hash, embedding] of this.embeddingIndex) {
+            const similarity = cosineSimilarity(queryEmbedding, embedding);
+            if (similarity > this.config.semanticThreshold && similarity > bestSimilarity) {
+                const entry = this.cache.get(hash);
+                if (entry && Date.now() - entry.timestamp < this.config.ttlMs) {
+                    bestSimilarity = similarity;
+                    bestEntry = entry;
+                }
+            }
+        }
+        return bestEntry ? { entry: bestEntry, similarity: bestSimilarity } : null;
+    }
+    /**
+     * 캐시 저장
+     */
+    set(query, response, contexts, options) {
+        const hash = this.hashQuery(query);
+        // 용량 확인
+        if (this.cache.size >= this.config.maxEntries) {
+            this.evictOldest();
+        }
+        const entry = {
+            queryHash: hash,
+            query,
+            queryEmbedding: options.queryEmbedding,
+            response,
+            contexts,
+            timestamp: Date.now(),
+            hitCount: 0,
+            llmModel: options.llmModel,
+            processingTime: options.processingTime,
+            tokenUsage: options.tokenUsage
+        };
+        this.cache.set(hash, entry);
+        if (options.queryEmbedding) {
+            this.embeddingIndex.set(hash, options.queryEmbedding);
+        }
+    }
+    /**
+     * 가장 오래된 항목 제거
+     */
+    evictOldest() {
+        let oldestHash = null;
+        let oldestTime = Infinity;
+        for (const [hash, entry] of this.cache) {
+            // LRU: 마지막 접근 시간 기준
+            const lastAccess = entry.timestamp + entry.hitCount * 60000;
+            if (lastAccess < oldestTime) {
+                oldestTime = lastAccess;
+                oldestHash = hash;
+            }
+        }
+        if (oldestHash) {
+            this.cache.delete(oldestHash);
+            this.embeddingIndex.delete(oldestHash);
+        }
+    }
+    /**
+     * 만료된 항목 정리
+     */
+    cleanup() {
+        const now = Date.now();
+        const toDelete = [];
+        for (const [hash, entry] of this.cache) {
+            if (now - entry.timestamp > this.config.ttlMs) {
+                toDelete.push(hash);
+            }
+        }
+        for (const hash of toDelete) {
+            this.cache.delete(hash);
+            this.embeddingIndex.delete(hash);
+        }
+    }
+    /**
+     * 캐시 무효화 (특정 쿼리)
+     */
+    invalidate(query) {
+        const hash = this.hashQuery(query);
+        const deleted = this.cache.delete(hash);
+        this.embeddingIndex.delete(hash);
+        return deleted;
+    }
+    /**
+     * 패턴 기반 무효화
+     */
+    invalidatePattern(pattern) {
+        let count = 0;
+        for (const [hash, entry] of this.cache) {
+            if (pattern.test(entry.query)) {
+                this.cache.delete(hash);
+                this.embeddingIndex.delete(hash);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * 전체 캐시 클리어
+     */
+    clear() {
+        this.cache.clear();
+        this.embeddingIndex.clear();
+        this.stats = { hits: 0, misses: 0, savedTokens: 0 };
+    }
+    /**
+     * 통계 조회
+     */
+    getStats() {
+        let memorySizeKB = 0;
+        for (const entry of this.cache.values()) {
+            memorySizeKB += entry.query.length / 1024;
+            memorySizeKB += entry.response.length / 1024;
+            memorySizeKB += entry.contexts.join('').length / 1024;
+            if (entry.queryEmbedding) {
+                memorySizeKB += entry.queryEmbedding.byteLength / 1024;
+            }
+        }
+        const total = this.stats.hits + this.stats.misses;
+        return {
+            totalEntries: this.cache.size,
+            totalHits: this.stats.hits,
+            totalMisses: this.stats.misses,
+            hitRate: total > 0 ? this.stats.hits / total : 0,
+            memorySizeKB: Math.round(memorySizeKB * 100) / 100,
+            savedTokens: this.stats.savedTokens,
+            savedCost: Math.round(this.stats.savedTokens * this.config.costPerToken * 1000) / 1000
+        };
+    }
+    /**
+     * 자주 조회되는 쿼리
+     */
+    getTopQueries(limit = 10) {
+        return Array.from(this.cache.values())
+            .sort((a, b) => b.hitCount - a.hitCount)
+            .slice(0, limit)
+            .map(e => ({ query: e.query, hitCount: e.hitCount }));
+    }
+    /**
+     * 캐시 워밍 (자주 사용되는 쿼리 미리 로드)
+     */
+    async warmup(queries, generateResponse) {
+        let warmedUp = 0;
+        for (const query of queries) {
+            const hash = this.hashQuery(query);
+            if (!this.cache.has(hash)) {
+                try {
+                    const result = await generateResponse(query);
+                    this.set(query, result.response, result.contexts, {
+                        queryEmbedding: result.embedding,
+                        llmModel: result.model,
+                        processingTime: result.time,
+                        tokenUsage: result.tokens
+                    });
+                    warmedUp++;
+                }
+                catch (error) {
+                    console.error(`Failed to warm up query: ${query}`, error);
+                }
+            }
+        }
+        return warmedUp;
+    }
+}
+// 싱글톤 인스턴스
+export const queryCache = new QueryCache();
+//# sourceMappingURL=query-cache.js.map

package/dist/services/query-cache.js.map

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

package/dist/services/query-normalize.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Query Normalize Service
+ * 쿼리 정제 및 형식 요구 추출
+ *
+ * 설계 문서: NMT_Updated.md Step 0 (3.2절)
+ * - 불필요한 수식어/잡담 제거
+ * - 형식 요구(표/코드/단계) 추출
+ * - LLM 없이 룰/정규식/간단 추출로 처리
+ *
+ * 목적: 검색 정밀도↑ → 필요한 컨텍스트↓ → 비용↓
+ *
+ * @module services/query-normalize
+ */
+/**
+ * 정규화된 쿼리 결과
+ */
+export interface NormalizedQuery {
+    original: string;
+    normalized: string;
+    coreQuery: string;
+    formatRequirements: FormatRequirement[];
+    intent: QueryIntent;
+    language: 'ko' | 'en' | 'mixed';
+    stats: {
+        originalLength: number;
+        normalizedLength: number;
+        reductionRatio: number;
+        fillerWordsRemoved: number;
+    };
+}
+/**
+ * 형식 요구사항
+ */
+export interface FormatRequirement {
+    type: FormatType;
+    detail?: string;
+    confidence: number;
+}
+/**
+ * 형식 타입
+ */
+export type FormatType = 'table' | 'code' | 'list' | 'steps' | 'comparison' | 'summary' | 'example' | 'diagram' | 'json' | 'markdown';
+/**
+ * 쿼리 의도
+ */
+export type QueryIntent = 'definition' | 'howto' | 'why' | 'comparison' | 'list' | 'troubleshoot' | 'factual' | 'general';
+/**
+ * Query Normalizer 클래스
+ */
+export declare class QueryNormalizer {
+    private stats;
+    /**
+     * 쿼리 정규화
+     */
+    normalize(query: string): NormalizedQuery;
+    /**
+     * 언어 감지
+     */
+    private detectLanguage;
+    /**
+     * 형식 요구사항 추출
+     */
+    private extractFormatRequirements;
+    /**
+     * 의도 감지
+     */
+    private detectIntent;
+    /**
+     * 핵심 질문 추출
+     */
+    private extractCoreQuery;
+    /**
+     * 검색용 키워드 추출
+     */
+    extractKeywords(query: string): string[];
+    /**
+     * 쿼리 확장 (동의어/관련어)
+     */
+    expandQuery(query: string): string[];
+    /**
+     * 형식 지시문 생성
+     */
+    generateFormatInstruction(requirements: FormatRequirement[]): string;
+    /**
+     * 통계 조회
+     */
+    getStats(): {
+        totalQueries: number;
+        avgFillerRemoved: number;
+        avgReductionRatio: number;
+        intentDistribution: Record<string, number>;
+    };
+    /**
+     * 통계 초기화
+     */
+    resetStats(): void;
+}
+export declare const queryNormalizer: QueryNormalizer;
+/**
+ * 빠른 정규화 함수
+ */
+export declare function normalizeQuery(query: string): string;
+/**
+ * 핵심 쿼리 추출 함수
+ */
+export declare function extractCoreQuery(query: string): string;
+//# sourceMappingURL=query-normalize.d.ts.map

package/dist/services/query-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-normalize.d.ts","sourceRoot":"","sources":["../../src/services/query-normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC;IAChC,KAAK,EAAE;QACL,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,YAAY,GACZ,SAAS,GACT,SAAS,GACT,SAAS,GACT,MAAM,GACN,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,OAAO,GACP,KAAK,GACL,YAAY,GACZ,MAAM,GACN,cAAc,GACd,SAAS,GACT,SAAS,CAAC;AAwEd;;GAEG;AACH,qBAAa,eAAe;IAE1B,OAAO,CAAC,KAAK,CAKX;IAEF;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAkEzC;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAuBjC;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAoBxC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAuCpC;;OAEG;IACH,yBAAyB,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM;IAwCpE;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC5C;IAaD;;OAEG;IACH,UAAU,IAAI,IAAI;CAQnB;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC;AAErD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD"}