@ninebix/nmt-system 1.0.0

package/dist/services/nmt-pipeline.js

@@ -0,0 +1,449 @@
+/**
+ * NMT Complete Pipeline
+ * 설계 문서(NMT_Updated.md) 기반 완전한 파이프라인
+ *
+ * 파이프라인 단계:
+ * Step 0: Query Normalize (저비용 정제)
+ * Step 1: Semantic Cache Check (LLM 호출 0회 기회)
+ * Step 2: Retrieve Top-K (NMT 영속 메모리에서 검색)
+ * Step 3: Verification Gate (머클 기반 무결성/근거 필터)
+ * Step 4: Context Compression (토큰 상한 고정)
+ * Step 5: LLM Routing (cheap-first)
+ * Step 6: Answer Gate (근거 기반 응답 강제)
+ *
+ * 추가 기능:
+ * - Adaptive Fallback (품질 저하 시 자동 복구)
+ * - KPI 메트릭 수집
+ *
+ * @module services/nmt-pipeline
+ */
+import { QueryCache } from './query-cache.js';
+import { QueryNormalizer } from './query-normalize.js';
+import { VerificationGate } from './verification-gate.js';
+import { ContextCompressor } from './context-compressor.js';
+import { LLMRouter } from './llm-router.js';
+import { AnswerGate } from './answer-gate.js';
+import { AdaptiveFallbackManager } from './adaptive-fallback.js';
+import { NMTMetricsDashboard } from './metrics-dashboard.js';
+/**
+ * NMT Complete Pipeline 클래스
+ */
+export class NMTPipeline {
+    queryService;
+    queryNormalizer;
+    queryCache;
+    verificationGate;
+    contextCompressor;
+    llmRouter;
+    answerGate;
+    fallbackManager;
+    metricsDashboard;
+    config;
+    // 임베딩 함수 (외부 주입)
+    embedFn = null;
+    constructor(queryService, config = {}) {
+        this.queryService = queryService;
+        // 컴포넌트 초기화
+        this.queryNormalizer = new QueryNormalizer();
+        this.queryCache = new QueryCache();
+        this.verificationGate = new VerificationGate();
+        this.contextCompressor = new ContextCompressor();
+        this.llmRouter = new LLMRouter();
+        this.answerGate = new AnswerGate();
+        this.fallbackManager = new AdaptiveFallbackManager();
+        this.metricsDashboard = new NMTMetricsDashboard();
+        // 설정
+        this.config = {
+            enableCache: config.enableCache ?? true,
+            enableNormalization: config.enableNormalization ?? true,
+            enableVerification: config.enableVerification ?? true,
+            enableCompression: config.enableCompression ?? true,
+            enableSmartRouting: config.enableSmartRouting ?? true,
+            enableAnswerGate: config.enableAnswerGate ?? true,
+            enableFallback: config.enableFallback ?? true,
+            enableMetrics: config.enableMetrics ?? true,
+            defaultK: config.defaultK ?? 10,
+            defaultMaxTokens: config.defaultMaxTokens ?? 2000,
+            defaultEfSearch: config.defaultEfSearch ?? 50,
+            apiKeys: config.apiKeys ?? {},
+            enableDebug: config.enableDebug ?? false
+        };
+        // API 키 설정
+        for (const [provider, key] of Object.entries(this.config.apiKeys)) {
+            if (key) {
+                this.llmRouter.setApiKey(provider, key);
+            }
+        }
+    }
+    /**
+     * 임베딩 함수 설정
+     */
+    setEmbeddingFunction(fn) {
+        this.embedFn = fn;
+    }
+    /**
+     * API 키 설정
+     */
+    setApiKey(provider, apiKey) {
+        this.config.apiKeys[provider] = apiKey;
+        this.llmRouter.setApiKey(provider, apiKey);
+    }
+    /**
+     * 메인 파이프라인 실행
+     */
+    async query(request) {
+        const startTime = Date.now();
+        const debug = {
+            normalizedQuery: null,
+            searchResults: [],
+            verificationResults: [],
+            compressedChunks: 0,
+            routingDecision: null,
+            warnings: []
+        };
+        const metrics = {
+            normalizeTimeMs: 0,
+            cacheCheckTimeMs: 0,
+            searchTimeMs: 0,
+            verifyTimeMs: 0,
+            compressionTimeMs: 0,
+            llmTimeMs: 0,
+            answerGateTimeMs: 0,
+            totalTimeMs: 0,
+            cacheHit: false,
+            searchResultCount: 0,
+            verifiedResultCount: 0,
+            compressionRatio: 0,
+            tokensUsed: 0,
+            complexity: 'medium',
+            model: '',
+            estimatedCost: 0,
+            savedCost: 0,
+            groundingScore: 0,
+            abstained: false,
+            fallbackApplied: false,
+            fallbackAttempts: 0
+        };
+        const { query, options = {} } = request;
+        const { k = this.config.defaultK, maxTokens = this.config.defaultMaxTokens, forceComplexity, skipCache = false, skipVerification = false, includeProof = false, systemPrompt, tags, enableFallback = this.config.enableFallback } = options;
+        try {
+            // ========== Step 0: Query Normalize ==========
+            const normalizeStart = Date.now();
+            let normalizedQuery;
+            if (this.config.enableNormalization) {
+                normalizedQuery = this.queryNormalizer.normalize(query);
+            }
+            else {
+                normalizedQuery = {
+                    original: query,
+                    normalized: query,
+                    coreQuery: query,
+                    formatRequirements: [],
+                    intent: 'general',
+                    language: 'mixed',
+                    stats: { originalLength: query.length, normalizedLength: query.length, reductionRatio: 0, fillerWordsRemoved: 0 }
+                };
+            }
+            metrics.normalizeTimeMs = Date.now() - normalizeStart;
+            debug.normalizedQuery = normalizedQuery;
+            // 쿼리 임베딩 생성
+            let queryEmbedding;
+            if (this.embedFn) {
+                queryEmbedding = await this.embedFn(normalizedQuery.coreQuery);
+            }
+            // ========== Step 1: Semantic Cache Check ==========
+            const cacheStart = Date.now();
+            if (this.config.enableCache && !skipCache) {
+                const cacheResult = this.queryCache.get(normalizedQuery.normalized, queryEmbedding);
+                if (cacheResult.hit && cacheResult.entry) {
+                    metrics.cacheCheckTimeMs = Date.now() - cacheStart;
+                    metrics.cacheHit = true;
+                    metrics.cacheType = cacheResult.type;
+                    metrics.totalTimeMs = Date.now() - startTime;
+                    // 메트릭 기록
+                    if (this.config.enableMetrics) {
+                        this.metricsDashboard.recordRequest({
+                            cacheHit: true,
+                            llmCalled: false,
+                            totalLatencyMs: metrics.totalTimeMs
+                        });
+                    }
+                    return {
+                        answer: cacheResult.entry.response,
+                        grounded: true,
+                        sources: cacheResult.entry.contexts.map((c, i) => ({
+                            id: `cached-${i}`,
+                            content: c,
+                            score: 1.0
+                        })),
+                        metrics,
+                        debug: this.config.enableDebug ? debug : undefined
+                    };
+                }
+            }
+            metrics.cacheCheckTimeMs = Date.now() - cacheStart;
+            // ========== Step 2: Retrieve Top-K ==========
+            const searchStart = Date.now();
+            const searchOptions = {
+                k,
+                includeContent: true,
+                includeProof,
+                tags
+            };
+            let searchResults = await this.queryService.search(normalizedQuery.coreQuery, searchOptions);
+            metrics.searchTimeMs = Date.now() - searchStart;
+            metrics.searchResultCount = searchResults.length;
+            debug.searchResults = searchResults.map(r => ({ id: r.neuron.id, score: r.score }));
+            // ========== Step 3: Verification Gate ==========
+            const verifyStart = Date.now();
+            if (this.config.enableVerification && !skipVerification) {
+                const { verified, discarded, verificationResult } = await this.verificationGate.filterVerified(searchResults);
+                searchResults = verified;
+                metrics.verifiedResultCount = verified.length;
+                debug.verificationResults = []; // 상세 결과는 필요시 추가
+                if (discarded.length > 0) {
+                    debug.warnings.push(`${discarded.length}개 결과가 검증 실패로 제외됨`);
+                }
+            }
+            else {
+                metrics.verifiedResultCount = searchResults.length;
+            }
+            metrics.verifyTimeMs = Date.now() - verifyStart;
+            // ========== Fallback Check ==========
+            let qualityAssessment;
+            if (enableFallback) {
+                const contexts = searchResults
+                    .filter(r => r.content)
+                    .map(r => r.content);
+                qualityAssessment = this.fallbackManager.assessQuality(normalizedQuery.coreQuery, searchResults.map(r => ({ id: r.neuron.id, score: r.score, content: r.content })), contexts);
+                debug.qualityAssessment = qualityAssessment;
+                if (qualityAssessment.needsFallback && qualityAssessment.suggestedAction) {
+                    metrics.fallbackApplied = true;
+                    // TODO: 실제 fallback 액션 적용
+                }
+            }
+            // ========== Step 4: Context Compression ==========
+            const compressionStart = Date.now();
+            let compressedContext;
+            if (this.config.enableCompression) {
+                const chunks = searchResults.map(r => ({
+                    id: r.neuron.id,
+                    content: r.content || '',
+                    score: r.score,
+                    embedding: r.neuron.embedding
+                }));
+                compressedContext = this.contextCompressor.compress(chunks, queryEmbedding, {
+                    maxTokens,
+                    maxChunks: Math.min(k, 7),
+                    strategy: 'hybrid'
+                });
+            }
+            else {
+                compressedContext = {
+                    chunks: searchResults.slice(0, 5).map(r => ({
+                        id: r.neuron.id,
+                        content: r.content || '',
+                        score: r.score
+                    })),
+                    originalCount: searchResults.length,
+                    compressedCount: Math.min(5, searchResults.length),
+                    totalTokens: 0,
+                    savedTokens: 0,
+                    compressionRatio: 0
+                };
+            }
+            metrics.compressionTimeMs = Date.now() - compressionStart;
+            metrics.compressionRatio = compressedContext.compressionRatio;
+            debug.compressedChunks = compressedContext.compressedCount;
+            // ========== Step 5: LLM Routing ==========
+            const llmStart = Date.now();
+            const contexts = compressedContext.chunks.map(c => c.content);
+            // Answer Gate 시스템 프롬프트 포함
+            const groundingPrompt = this.config.enableAnswerGate
+                ? this.answerGate.getSystemPrompt(true) + '\n\n' + (systemPrompt || '')
+                : systemPrompt;
+            let routingResult;
+            if (this.config.enableSmartRouting) {
+                routingResult = await this.llmRouter.route(normalizedQuery.coreQuery, contexts, {
+                    systemPrompt: groundingPrompt,
+                    forceModel: forceComplexity,
+                    maxTokens: 1024
+                });
+            }
+            else {
+                routingResult = await this.llmRouter.route(normalizedQuery.coreQuery, contexts, {
+                    systemPrompt: groundingPrompt,
+                    forceModel: 'medium',
+                    maxTokens: 1024
+                });
+            }
+            metrics.llmTimeMs = Date.now() - llmStart;
+            metrics.complexity = routingResult.complexity.level;
+            metrics.model = routingResult.selectedModel.model;
+            metrics.tokensUsed = routingResult.response.usage?.totalTokens ?? routingResult.complexity.estimatedTokens;
+            metrics.estimatedCost = routingResult.actualCost;
+            metrics.savedCost = routingResult.savedCost;
+            debug.routingDecision = {
+                level: routingResult.complexity.level,
+                score: routingResult.complexity.score,
+                factors: routingResult.complexity.factors
+            };
+            // ========== Step 6: Answer Gate ==========
+            const answerGateStart = Date.now();
+            let groundedAnswer;
+            const sources = compressedContext.chunks.map(c => ({
+                id: c.id,
+                content: c.content,
+                score: c.score,
+                snippet: c.content.substring(0, 100) + '...',
+                verified: true
+            }));
+            if (this.config.enableAnswerGate) {
+                groundedAnswer = this.answerGate.validateAndProcess(routingResult.response.content, sources);
+            }
+            else {
+                groundedAnswer = {
+                    answer: routingResult.response.content,
+                    grounded: true,
+                    groundingScore: 1,
+                    sources,
+                    abstained: false,
+                    confidence: 1,
+                    warnings: []
+                };
+            }
+            metrics.answerGateTimeMs = Date.now() - answerGateStart;
+            metrics.groundingScore = groundedAnswer.groundingScore;
+            metrics.abstained = groundedAnswer.abstained;
+            if (groundedAnswer.warnings.length > 0) {
+                debug.warnings.push(...groundedAnswer.warnings);
+            }
+            // ========== 캐시 저장 ==========
+            if (this.config.enableCache && !skipCache && !groundedAnswer.abstained) {
+                this.queryCache.set(normalizedQuery.normalized, groundedAnswer.answer, contexts, {
+                    queryEmbedding,
+                    llmModel: routingResult.selectedModel.model,
+                    processingTime: metrics.llmTimeMs,
+                    tokenUsage: routingResult.response.usage ? {
+                        prompt: routingResult.response.usage.promptTokens,
+                        completion: routingResult.response.usage.completionTokens
+                    } : undefined
+                });
+            }
+            // ========== 메트릭 기록 ==========
+            metrics.totalTimeMs = Date.now() - startTime;
+            if (this.config.enableMetrics) {
+                this.metricsDashboard.recordRequest({
+                    cacheHit: false,
+                    llmCalled: true,
+                    promptTokens: routingResult.response.usage?.promptTokens,
+                    costUSD: routingResult.actualCost,
+                    modelLevel: routingResult.complexity.level,
+                    totalLatencyMs: metrics.totalTimeMs,
+                    searchLatencyMs: metrics.searchTimeMs,
+                    verifyLatencyMs: metrics.verifyTimeMs,
+                    compressLatencyMs: metrics.compressionTimeMs,
+                    llmLatencyMs: metrics.llmTimeMs
+                });
+                this.metricsDashboard.recordQuality({
+                    grounded: groundedAnswer.grounded,
+                    abstained: groundedAnswer.abstained,
+                    groundingScore: groundedAnswer.groundingScore,
+                    verificationSuccess: metrics.verifiedResultCount === metrics.searchResultCount,
+                    sourcesCount: groundedAnswer.sources.length
+                });
+            }
+            return {
+                answer: groundedAnswer.answer,
+                grounded: groundedAnswer.grounded,
+                sources: groundedAnswer.sources,
+                metrics,
+                debug: this.config.enableDebug ? debug : undefined
+            };
+        }
+        catch (error) {
+            metrics.totalTimeMs = Date.now() - startTime;
+            debug.warnings.push(`파이프라인 오류: ${error}`);
+            return {
+                answer: '요청을 처리하는 중 오류가 발생했습니다.',
+                grounded: false,
+                sources: [],
+                metrics,
+                debug: this.config.enableDebug ? debug : undefined
+            };
+        }
+    }
+    /**
+     * 빠른 쿼리 (캐시 우선)
+     */
+    async quickQuery(query) {
+        return this.query({
+            query,
+            options: {
+                k: 5,
+                maxTokens: 1000,
+                forceComplexity: 'simple'
+            }
+        });
+    }
+    /**
+     * 정밀 쿼리 (품질 우선)
+     */
+    async preciseQuery(query, tags) {
+        return this.query({
+            query,
+            options: {
+                k: 15,
+                maxTokens: 4000,
+                skipCache: true,
+                includeProof: true,
+                tags
+            }
+        });
+    }
+    /**
+     * 통계 조회
+     */
+    getStats() {
+        return {
+            dashboard: this.metricsDashboard.getDashboard(),
+            cache: this.queryCache.getStats(),
+            router: this.llmRouter.getStats(),
+            answerGate: this.answerGate.getStats(),
+            verification: this.verificationGate.getStats(),
+            fallback: this.fallbackManager.getStats(),
+            normalizer: this.queryNormalizer.getStats()
+        };
+    }
+    /**
+     * 캐시 클리어
+     */
+    clearCache() {
+        this.queryCache.clear();
+    }
+    /**
+     * 전체 초기화
+     */
+    reset() {
+        this.queryCache.clear();
+        this.verificationGate.invalidateCache();
+        this.metricsDashboard.reset();
+        this.answerGate.resetStats();
+        this.llmRouter.resetStats();
+        this.fallbackManager.resetStats();
+        this.queryNormalizer.resetStats();
+    }
+    /**
+     * 설정 업데이트
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+/**
+ * 파이프라인 팩토리 함수
+ */
+export function createNMTPipeline(queryService, config) {
+    return new NMTPipeline(queryService, config);
+}
+//# sourceMappingURL=nmt-pipeline.js.map

package/dist/services/nmt-pipeline.js.map

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

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

@@ -0,0 +1,136 @@
+/**
+ * Query Cache Service
+ * 유사 쿼리 캐싱으로 LLM 호출 절감
+ *
+ * @module services/query-cache
+ */
+/**
+ * 캐시 엔트리
+ */
+export interface CacheEntry {
+    queryHash: string;
+    query: string;
+    queryEmbedding?: Float32Array;
+    response: string;
+    contexts: string[];
+    timestamp: number;
+    hitCount: number;
+    llmModel: string;
+    processingTime: number;
+    tokenUsage?: {
+        prompt: number;
+        completion: number;
+    };
+}
+/**
+ * 캐시 히트 결과
+ */
+export interface CacheHitResult {
+    hit: boolean;
+    entry?: CacheEntry;
+    similarity?: number;
+    type?: 'exact' | 'semantic';
+}
+/**
+ * 캐시 통계
+ */
+export interface CacheStats {
+    totalEntries: number;
+    totalHits: number;
+    totalMisses: number;
+    hitRate: number;
+    memorySizeKB: number;
+    savedTokens: number;
+    savedCost: number;
+}
+/**
+ * 캐시 설정
+ */
+export interface CacheConfig {
+    maxEntries?: number;
+    ttlMs?: number;
+    semanticThreshold?: number;
+    enableSemanticMatch?: boolean;
+    costPerToken?: number;
+}
+/**
+ * Query Cache 클래스
+ */
+export declare class QueryCache {
+    private cache;
+    private embeddingIndex;
+    private config;
+    private stats;
+    constructor(config?: CacheConfig);
+    /**
+     * 쿼리 해시 생성
+     */
+    private hashQuery;
+    /**
+     * 캐시 조회
+     */
+    get(query: string, queryEmbedding?: Float32Array): CacheHitResult;
+    /**
+     * 시맨틱 매칭
+     */
+    private findSemanticMatch;
+    /**
+     * 캐시 저장
+     */
+    set(query: string, response: string, contexts: string[], options: {
+        queryEmbedding?: Float32Array;
+        llmModel: string;
+        processingTime: number;
+        tokenUsage?: {
+            prompt: number;
+            completion: number;
+        };
+    }): void;
+    /**
+     * 가장 오래된 항목 제거
+     */
+    private evictOldest;
+    /**
+     * 만료된 항목 정리
+     */
+    private cleanup;
+    /**
+     * 캐시 무효화 (특정 쿼리)
+     */
+    invalidate(query: string): boolean;
+    /**
+     * 패턴 기반 무효화
+     */
+    invalidatePattern(pattern: RegExp): number;
+    /**
+     * 전체 캐시 클리어
+     */
+    clear(): void;
+    /**
+     * 통계 조회
+     */
+    getStats(): CacheStats;
+    /**
+     * 자주 조회되는 쿼리
+     */
+    getTopQueries(limit?: number): Array<{
+        query: string;
+        hitCount: number;
+    }>;
+    /**
+     * 캐시 워밍 (자주 사용되는 쿼리 미리 로드)
+     */
+    warmup(queries: string[], generateResponse: (query: string) => Promise<{
+        response: string;
+        contexts: string[];
+        embedding?: Float32Array;
+        model: string;
+        time: number;
+        tokens?: {
+            prompt: number;
+            completion: number;
+        };
+    }>): Promise<number>;
+}
+export declare const queryCache: QueryCache;
+//# sourceMappingURL=query-cache.d.ts.map

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

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