@ninebix/nmt-system 1.0.2 → 1.0.4

package/dist/services/adaptive-fallback.d.ts

@@ -1,140 +0,0 @@
-/**
- * Adaptive Fallback Service
- * 검색 품질 저하 시 자동 복구 로직
- *
- * 설계 문서: NMT_Updated.md 3.3절
- * - 검색 품질이 낮거나 컨텍스트 부족 시:
- *   1) Top-K 증가 (k↑)
- *   2) efSearch 조정 (리콜↑)
- *   3) 임베딩 모델 교체/업그레이드
- *   4) 상위 모델로 업그레이드 라우팅
- *
- * @module services/adaptive-fallback
- */
-import type { ComplexityLevel } from './llm-router.js';
-/**
- * 품질 평가 결과
- */
-export interface QualityAssessment {
-    score: number;
-    searchQuality: number;
-    contextQuality: number;
-    coverageRatio: number;
-    issues: QualityIssue[];
-    needsFallback: boolean;
-    suggestedAction: FallbackAction | null;
-}
-/**
- * 품질 이슈 유형
- */
-export type QualityIssue = 'low_search_score' | 'few_results' | 'low_diversity' | 'context_too_short' | 'low_relevance' | 'query_mismatch';
-/**
- * Fallback 액션 유형
- */
-export type FallbackAction = {
-    type: 'increase_k';
-    newK: number;
-} | {
-    type: 'increase_ef';
-    newEf: number;
-} | {
-    type: 'retry_with_expanded_query';
-    expandedQuery: string;
-} | {
-    type: 'upgrade_model';
-    newLevel: ComplexityLevel;
-} | {
-    type: 'use_alternative_embedding';
-} | {
-    type: 'request_more_context';
-} | {
-    type: 'abstain';
-    reason: string;
-};
-/**
- * Fallback 설정
- */
-export interface FallbackConfig {
-    minSearchScore: number;
-    minResultCount: number;
-    minContextTokens: number;
-    minCoverageRatio: number;
-    maxKIncrease: number;
-    maxEfIncrease: number;
-    maxRetries: number;
-    autoUpgradeModel: boolean;
-    upgradeOnLowQuality: boolean;
-}
-/**
- * Fallback 실행 결과
- */
-export interface FallbackResult<T> {
-    success: boolean;
-    finalResult: T | null;
-    attemptsCount: number;
-    actionsApplied: FallbackAction[];
-    qualityHistory: QualityAssessment[];
-    totalTimeMs: number;
-}
-/**
- * 검색 결과 인터페이스
- */
-export interface SearchResultLike {
-    id: string;
-    score: number;
-    content?: string;
-}
-/**
- * Adaptive Fallback Manager
- */
-export declare class AdaptiveFallbackManager {
-    private config;
-    private stats;
-    constructor(config?: Partial<FallbackConfig>);
-    /**
-     * 품질 평가
-     */
-    assessQuality(query: string, results: SearchResultLike[], contexts: string[]): QualityAssessment;
-    /**
-     * Fallback 액션 결정
-     */
-    private determineFallbackAction;
-    /**
-     * 액션 기록
-     */
-    private recordAction;
-    /**
-     * Fallback 실행 (재시도 루프)
-     */
-    executeWithFallback<T>(initialParams: {
-        k: number;
-        efSearch: number;
-        modelLevel: ComplexityLevel;
-    }, searchFn: (params: {
-        k: number;
-        efSearch: number;
-    }) => Promise<SearchResultLike[]>, processFn: (results: SearchResultLike[], modelLevel: ComplexityLevel) => Promise<T>, query: string): Promise<FallbackResult<T>>;
-    /**
-     * 분산 계산
-     */
-    private calculateVariance;
-    /**
-     * 설정 업데이트
-     */
-    updateConfig(config: Partial<FallbackConfig>): void;
-    /**
-     * 통계 조회
-     */
-    getStats(): {
-        totalAssessments: number;
-        fallbackRate: number;
-        recoveryRate: number;
-        actionDistribution: Record<string, number>;
-    };
-    /**
-     * 통계 초기화
-     */
-    resetStats(): void;
-}
-export declare const adaptiveFallback: AdaptiveFallbackManager;
-//# sourceMappingURL=adaptive-fallback.d.ts.map

package/dist/services/adaptive-fallback.d.ts.map

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

package/dist/services/adaptive-fallback.js

@@ -1,273 +0,0 @@
-/**
- * Adaptive Fallback Service
- * 검색 품질 저하 시 자동 복구 로직
- *
- * 설계 문서: NMT_Updated.md 3.3절
- * - 검색 품질이 낮거나 컨텍스트 부족 시:
- *   1) Top-K 증가 (k↑)
- *   2) efSearch 조정 (리콜↑)
- *   3) 임베딩 모델 교체/업그레이드
- *   4) 상위 모델로 업그레이드 라우팅
- *
- * @module services/adaptive-fallback
- */
-/**
- * Adaptive Fallback Manager
- */
-export class AdaptiveFallbackManager {
-    config;
-    // 통계
-    stats = {
-        totalAssessments: 0,
-        fallbackTriggered: 0,
-        successfulRecoveries: 0,
-        failedRecoveries: 0,
-        actionCounts: new Map()
-    };
-    constructor(config = {}) {
-        this.config = {
-            minSearchScore: config.minSearchScore ?? 0.5,
-            minResultCount: config.minResultCount ?? 3,
-            minContextTokens: config.minContextTokens ?? 100,
-            minCoverageRatio: config.minCoverageRatio ?? 0.4,
-            maxKIncrease: config.maxKIncrease ?? 3,
-            maxEfIncrease: config.maxEfIncrease ?? 200,
-            maxRetries: config.maxRetries ?? 2,
-            autoUpgradeModel: config.autoUpgradeModel ?? true,
-            upgradeOnLowQuality: config.upgradeOnLowQuality ?? true
-        };
-    }
-    /**
-     * 품질 평가
-     */
-    assessQuality(query, results, contexts) {
-        this.stats.totalAssessments++;
-        const issues = [];
-        // 1. 검색 점수 평가
-        const avgScore = results.length > 0
-            ? results.reduce((sum, r) => sum + r.score, 0) / results.length
-            : 0;
-        const maxScore = results.length > 0
-            ? Math.max(...results.map(r => r.score))
-            : 0;
-        const searchQuality = (avgScore + maxScore) / 2;
-        if (maxScore < this.config.minSearchScore) {
-            issues.push('low_search_score');
-        }
-        // 2. 결과 수 평가
-        if (results.length < this.config.minResultCount) {
-            issues.push('few_results');
-        }
-        // 3. 컨텍스트 평가
-        const totalContextLength = contexts.join(' ').length;
-        const estimatedTokens = Math.ceil(totalContextLength / 4);
-        const contextQuality = Math.min(1, estimatedTokens / this.config.minContextTokens);
-        if (estimatedTokens < this.config.minContextTokens) {
-            issues.push('context_too_short');
-        }
-        // 4. 커버리지 평가 (쿼리 키워드가 컨텍스트에 있는 비율)
-        const queryWords = query.toLowerCase().split(/\s+/).filter(w => w.length > 2);
-        const contextLower = contexts.join(' ').toLowerCase();
-        const matchedWords = queryWords.filter(w => contextLower.includes(w));
-        const coverageRatio = queryWords.length > 0
-            ? matchedWords.length / queryWords.length
-            : 0;
-        if (coverageRatio < this.config.minCoverageRatio) {
-            issues.push('query_mismatch');
-        }
-        // 5. 다양성 평가
-        if (results.length >= 3) {
-            const scoreVariance = this.calculateVariance(results.map(r => r.score));
-            if (scoreVariance < 0.01) {
-                issues.push('low_diversity');
-            }
-        }
-        // 6. 종합 점수 계산
-        const score = (searchQuality * 0.4 + contextQuality * 0.3 + coverageRatio * 0.3);
-        // 7. Fallback 필요 여부 결정
-        const needsFallback = issues.length > 0 && score < 0.6;
-        // 8. 제안 액션 결정
-        let suggestedAction = null;
-        if (needsFallback) {
-            suggestedAction = this.determineFallbackAction(issues, results.length);
-            this.stats.fallbackTriggered++;
-        }
-        return {
-            score,
-            searchQuality,
-            contextQuality,
-            coverageRatio,
-            issues,
-            needsFallback,
-            suggestedAction
-        };
-    }
-    /**
-     * Fallback 액션 결정
-     */
-    determineFallbackAction(issues, currentResultCount) {
-        // 우선순위에 따라 액션 결정
-        // 1. 결과가 너무 적으면 k 증가
-        if (issues.includes('few_results')) {
-            const newK = Math.min(currentResultCount * 2, currentResultCount * this.config.maxKIncrease);
-            this.recordAction('increase_k');
-            return { type: 'increase_k', newK };
-        }
-        // 2. 검색 점수가 낮으면 efSearch 증가
-        if (issues.includes('low_search_score')) {
-            this.recordAction('increase_ef');
-            return { type: 'increase_ef', newEf: this.config.maxEfIncrease };
-        }
-        // 3. 쿼리 불일치면 쿼리 확장
-        if (issues.includes('query_mismatch')) {
-            this.recordAction('retry_with_expanded_query');
-            return { type: 'retry_with_expanded_query', expandedQuery: '' }; // 외부에서 확장
-        }
-        // 4. 컨텍스트 부족이면 더 많은 컨텍스트 요청
-        if (issues.includes('context_too_short')) {
-            this.recordAction('request_more_context');
-            return { type: 'request_more_context' };
-        }
-        // 5. 기타 문제는 모델 업그레이드
-        if (this.config.autoUpgradeModel) {
-            this.recordAction('upgrade_model');
-            return { type: 'upgrade_model', newLevel: 'complex' };
-        }
-        // 6. 최후 수단: 답변 거부
-        this.recordAction('abstain');
-        return { type: 'abstain', reason: '충분한 정보를 찾을 수 없습니다.' };
-    }
-    /**
-     * 액션 기록
-     */
-    recordAction(actionType) {
-        this.stats.actionCounts.set(actionType, (this.stats.actionCounts.get(actionType) ?? 0) + 1);
-    }
-    /**
-     * Fallback 실행 (재시도 루프)
-     */
-    async executeWithFallback(initialParams, searchFn, processFn, query) {
-        const startTime = Date.now();
-        const actionsApplied = [];
-        const qualityHistory = [];
-        let currentParams = { ...initialParams };
-        let attempts = 0;
-        while (attempts <= this.config.maxRetries) {
-            attempts++;
-            try {
-                // 1. 검색 실행
-                const results = await searchFn({
-                    k: currentParams.k,
-                    efSearch: currentParams.efSearch
-                });
-                const contexts = results
-                    .filter(r => r.content)
-                    .map(r => r.content);
-                // 2. 품질 평가
-                const assessment = this.assessQuality(query, results, contexts);
-                qualityHistory.push(assessment);
-                // 3. 품질이 충분하면 처리 진행
-                if (!assessment.needsFallback || attempts > this.config.maxRetries) {
-                    const finalResult = await processFn(results, currentParams.modelLevel);
-                    if (attempts > 1) {
-                        this.stats.successfulRecoveries++;
-                    }
-                    return {
-                        success: true,
-                        finalResult,
-                        attemptsCount: attempts,
-                        actionsApplied,
-                        qualityHistory,
-                        totalTimeMs: Date.now() - startTime
-                    };
-                }
-                // 4. Fallback 액션 적용
-                const action = assessment.suggestedAction;
-                actionsApplied.push(action);
-                switch (action.type) {
-                    case 'increase_k':
-                        currentParams.k = action.newK;
-                        break;
-                    case 'increase_ef':
-                        currentParams.efSearch = action.newEf;
-                        break;
-                    case 'upgrade_model':
-                        currentParams.modelLevel = action.newLevel;
-                        break;
-                    case 'abstain':
-                        // 답변 거부 - 루프 종료
-                        this.stats.failedRecoveries++;
-                        return {
-                            success: false,
-                            finalResult: null,
-                            attemptsCount: attempts,
-                            actionsApplied,
-                            qualityHistory,
-                            totalTimeMs: Date.now() - startTime
-                        };
-                }
-            }
-            catch (error) {
-                console.error(`[AdaptiveFallback] Attempt ${attempts} failed:`, error);
-            }
-        }
-        // 최대 재시도 초과
-        this.stats.failedRecoveries++;
-        return {
-            success: false,
-            finalResult: null,
-            attemptsCount: attempts,
-            actionsApplied,
-            qualityHistory,
-            totalTimeMs: Date.now() - startTime
-        };
-    }
-    /**
-     * 분산 계산
-     */
-    calculateVariance(values) {
-        if (values.length === 0)
-            return 0;
-        const mean = values.reduce((a, b) => a + b, 0) / values.length;
-        const squaredDiffs = values.map(v => Math.pow(v - mean, 2));
-        return squaredDiffs.reduce((a, b) => a + b, 0) / values.length;
-    }
-    /**
-     * 설정 업데이트
-     */
-    updateConfig(config) {
-        this.config = { ...this.config, ...config };
-    }
-    /**
-     * 통계 조회
-     */
-    getStats() {
-        const total = this.stats.fallbackTriggered;
-        const recovered = this.stats.successfulRecoveries;
-        return {
-            totalAssessments: this.stats.totalAssessments,
-            fallbackRate: this.stats.totalAssessments > 0
-                ? this.stats.fallbackTriggered / this.stats.totalAssessments
-                : 0,
-            recoveryRate: total > 0
-                ? recovered / total
-                : 0,
-            actionDistribution: Object.fromEntries(this.stats.actionCounts)
-        };
-    }
-    /**
-     * 통계 초기화
-     */
-    resetStats() {
-        this.stats = {
-            totalAssessments: 0,
-            fallbackTriggered: 0,
-            successfulRecoveries: 0,
-            failedRecoveries: 0,
-            actionCounts: new Map()
-        };
-    }
-}
-// 싱글톤 인스턴스
-export const adaptiveFallback = new AdaptiveFallbackManager();
-//# sourceMappingURL=adaptive-fallback.js.map

package/dist/services/adaptive-fallback.js.map

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

package/dist/services/answer-gate.d.ts

@@ -1,112 +0,0 @@
-/**
- * Answer Gate Service
- * 근거 기반 응답 강제 및 할루시네이션 억제
- *
- * 설계 문서: NMT_Updated.md Step 6 (3.2절)
- * - 근거 chunk에서만 답변
- * - 근거가 부족하면 "정보 부족"으로 답변
- * - 결과에 sources(neuronId/score/snippet) 첨부
- *
- * @module services/answer-gate
- */
-/**
- * 출처 참조
- */
-export interface SourceReference {
-    id: string;
-    content: string;
-    score: number;
-    snippet?: string;
-    verified?: boolean;
-}
-/**
- * 근거 기반 응답
- */
-export interface GroundedAnswer {
-    answer: string;
-    grounded: boolean;
-    groundingScore: number;
-    sources: SourceReference[];
-    abstained: boolean;
-    confidence: number;
-    warnings: string[];
-}
-/**
- * Answer Gate 설정
- */
-export interface AnswerGateConfig {
-    minSources: number;
-    minSourceScore: number;
-    minGroundingScore: number;
-    enforceSourceCitation: boolean;
-    abstainOnLowConfidence: boolean;
-    confidenceThreshold: number;
-}
-/**
- * 근거 기반 시스템 프롬프트 생성
- */
-export declare function createGroundingSystemPrompt(config?: Partial<AnswerGateConfig>): string;
-/**
- * 간단한 근거 기반 프롬프트 (토큰 절약용)
- */
-export declare function createCompactGroundingPrompt(): string;
-/**
- * Answer Gate 클래스
- */
-export declare class AnswerGate {
-    private config;
-    private stats;
-    constructor(config?: Partial<AnswerGateConfig>);
-    /**
-     * 시스템 프롬프트 생성
-     */
-    getSystemPrompt(compact?: boolean): string;
-    /**
-     * 응답 검증 및 후처리
-     */
-    validateAndProcess(rawAnswer: string, sources: SourceReference[]): GroundedAnswer;
-    /**
-     * 근거 점수 계산
-     */
-    private calculateGroundingScore;
-    /**
-     * 출처 인용 확인
-     */
-    private checkCitations;
-    /**
-     * 신뢰도 계산
-     */
-    private calculateConfidence;
-    /**
-     * 답변 거부 여부 결정
-     */
-    private shouldAbstain;
-    /**
-     * 답변 거부 응답 생성
-     */
-    private generateAbstainResponse;
-    /**
-     * 출처 섹션 추가
-     */
-    private appendSourceSection;
-    /**
-     * 통계 조회
-     */
-    getStats(): {
-        totalResponses: number;
-        groundedRate: number;
-        abstainRate: number;
-        avgSourcesPerResponse: number;
-        avgGroundingScore: number;
-    };
-    /**
-     * 통계 초기화
-     */
-    resetStats(): void;
-    /**
-     * 설정 변경
-     */
-    updateConfig(config: Partial<AnswerGateConfig>): void;
-}
-export declare const answerGate: AnswerGate;
-//# sourceMappingURL=answer-gate.d.ts.map

package/dist/services/answer-gate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"answer-gate.d.ts","sourceRoot":"","sources":["../../src/services/answer-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,sBAAsB,EAAE,OAAO,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CA2CtF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA6B;IAG3C,OAAO,CAAC,KAAK,CAMX;gBAEU,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAWlD;;OAEG;IACH,eAAe,CAAC,OAAO,GAAE,OAAe,GAAG,MAAM;IAMjD;;OAEG;IACH,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,EAAE,GACzB,cAAc;IAqDjB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,QAAQ,IAAI;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,iBAAiB,EAAE,MAAM,CAAC;KAC3B;IAgBD;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;CAGtD;AAGD,eAAO,MAAM,UAAU,YAAmB,CAAC"}