@ninebix/nmt-system 1.0.1 → 1.0.3

package/dist/services/query-normalize.js

@@ -1,366 +0,0 @@
-/**
- * Query Normalize Service
- * 쿼리 정제 및 형식 요구 추출
- *
- * 설계 문서: NMT_Updated.md Step 0 (3.2절)
- * - 불필요한 수식어/잡담 제거
- * - 형식 요구(표/코드/단계) 추출
- * - LLM 없이 룰/정규식/간단 추출로 처리
- *
- * 목적: 검색 정밀도↑ → 필요한 컨텍스트↓ → 비용↓
- *
- * @module services/query-normalize
- */
-/**
- * 한국어 필러 단어 패턴
- */
-const KOREAN_FILLER_PATTERNS = [
-    // 문장 시작 필러 (음, 어, 저기, 그 등)
-    /^(음+|어+|저기+|그+|뭐랄까|있잖아|그러니까)\s*/gi,
-    // 중간에 나오는 필러도 제거
-    /\s+(음+|어+|저기+|그+|뭐랄까|있잖아|그러니까)\s+/gi,
-    // 문장 끝 어미
-    /\s*(입니다|이에요|인가요|할까요|일까요|겠죠|네요|군요)\s*$/gi,
-    // 강조/수식어
-    /\s*(좀|약간|조금|한번|혹시|그냥|진짜|정말|매우|아주|되게)\s+/gi,
-    // 인사말
-    /^(안녕하세요|안녕|반갑습니다|감사합니다|고마워요|부탁드립니다)[,.\s]*/gi,
-    // 요청 어미
-    /\s*(해주세요|해줘|알려줘|알려주세요|설명해줘|설명해주세요)\s*$/gi,
-];
-/**
- * 영어 필러 단어 패턴
- */
-const ENGLISH_FILLER_PATTERNS = [
-    /^(um+|uh+|well|so|like|you know|i mean)\s*/gi,
-    /\s*(please|thanks|thank you|kindly)\s*$/gi,
-    /^(hi|hello|hey|greetings)[,.\s]*/gi,
-    /\s*(could you|can you|would you|i want to|i need to|i'd like to)\s+/gi,
-];
-/**
- * 형식 요구 패턴
- */
-const FORMAT_PATTERNS = [
-    // 표
-    { pattern: /표로|표 형식|테이블|table/gi, type: 'table', confidence: 0.9 },
-    // 코드
-    { pattern: /코드로|코드 예시|코드를|소스코드|code|example code/gi, type: 'code', confidence: 0.9 },
-    // 목록
-    { pattern: /목록|리스트|나열|list|enumerate/gi, type: 'list', confidence: 0.85 },
-    // 단계
-    { pattern: /단계별|순서대로|step by step|steps|절차/gi, type: 'steps', confidence: 0.9 },
-    // 비교
-    { pattern: /비교|차이점|vs|versus|대비/gi, type: 'comparison', confidence: 0.85 },
-    // 요약
-    { pattern: /요약|간단히|짧게|briefly|summarize|summary/gi, type: 'summary', confidence: 0.8 },
-    // 예시
-    { pattern: /예시|예를 들어|example|for instance/gi, type: 'example', confidence: 0.8 },
-    // JSON
-    { pattern: /json 형식|json으로|as json/gi, type: 'json', confidence: 0.95 },
-    // 마크다운
-    { pattern: /마크다운|markdown|md 형식/gi, type: 'markdown', confidence: 0.9 },
-];
-/**
- * 의도 패턴
- */
-const INTENT_PATTERNS = [
-    // 정의
-    { pattern: /(이란|란|가 뭐|뭔가요|what is|define|definition)/gi, intent: 'definition' },
-    // 방법
-    { pattern: /(어떻게|방법|하려면|how to|how do|how can)/gi, intent: 'howto' },
-    // 이유
-    { pattern: /(왜|이유|원인|why|reason)/gi, intent: 'why' },
-    // 비교
-    { pattern: /(비교|차이|vs|versus|differ)/gi, intent: 'comparison' },
-    // 목록
-    { pattern: /(종류|목록|어떤 것들|what are|list of|types of)/gi, intent: 'list' },
-    // 문제 해결
-    { pattern: /(오류|에러|안 됨|문제|해결|fix|error|problem|issue|troubleshoot)/gi, intent: 'troubleshoot' },
-];
-/**
- * Query Normalizer 클래스
- */
-export class QueryNormalizer {
-    // 통계
-    stats = {
-        totalQueries: 0,
-        totalFillerRemoved: 0,
-        totalReduction: 0,
-        intentDistribution: new Map()
-    };
-    /**
-     * 쿼리 정규화
-     */
-    normalize(query) {
-        this.stats.totalQueries++;
-        const original = query;
-        const originalLength = query.length;
-        // 1. 언어 감지
-        const language = this.detectLanguage(query);
-        // 2. 기본 정리
-        let normalized = query.trim();
-        normalized = normalized.replace(/\s+/g, ' ');
-        // 3. 필러 단어 제거
-        let fillerWordsRemoved = 0;
-        const patterns = language === 'ko'
-            ? KOREAN_FILLER_PATTERNS
-            : language === 'en'
-                ? ENGLISH_FILLER_PATTERNS
-                : [...KOREAN_FILLER_PATTERNS, ...ENGLISH_FILLER_PATTERNS];
-        for (const pattern of patterns) {
-            const before = normalized;
-            normalized = normalized.replace(pattern, ' ');
-            if (before !== normalized)
-                fillerWordsRemoved++;
-        }
-        normalized = normalized.replace(/\s+/g, ' ').trim();
-        // 4. 형식 요구사항 추출
-        const formatRequirements = this.extractFormatRequirements(original);
-        // 5. 의도 분석
-        const intent = this.detectIntent(original);
-        this.stats.intentDistribution.set(intent, (this.stats.intentDistribution.get(intent) ?? 0) + 1);
-        // 6. 핵심 질문 추출
-        const coreQuery = this.extractCoreQuery(normalized, intent);
-        // 7. 통계 업데이트
-        const normalizedLength = normalized.length;
-        const reductionRatio = originalLength > 0
-            ? (originalLength - normalizedLength) / originalLength
-            : 0;
-        this.stats.totalFillerRemoved += fillerWordsRemoved;
-        this.stats.totalReduction += reductionRatio;
-        return {
-            original,
-            normalized,
-            coreQuery,
-            formatRequirements,
-            intent,
-            language,
-            stats: {
-                originalLength,
-                normalizedLength,
-                reductionRatio,
-                fillerWordsRemoved
-            }
-        };
-    }
-    /**
-     * 언어 감지
-     */
-    detectLanguage(text) {
-        const koreanChars = (text.match(/[가-힣]/g) || []).length;
-        const englishChars = (text.match(/[a-zA-Z]/g) || []).length;
-        const total = koreanChars + englishChars;
-        if (total === 0)
-            return 'mixed';
-        const koreanRatio = koreanChars / total;
-        if (koreanRatio > 0.7)
-            return 'ko';
-        if (koreanRatio < 0.3)
-            return 'en';
-        return 'mixed';
-    }
-    /**
-     * 형식 요구사항 추출
-     */
-    extractFormatRequirements(query) {
-        const requirements = [];
-        for (const { pattern, type, confidence } of FORMAT_PATTERNS) {
-            const match = query.match(pattern);
-            if (match) {
-                requirements.push({
-                    type,
-                    detail: match[0],
-                    confidence
-                });
-            }
-        }
-        // 중복 제거 (타입 기준)
-        const seen = new Set();
-        return requirements.filter(r => {
-            if (seen.has(r.type))
-                return false;
-            seen.add(r.type);
-            return true;
-        });
-    }
-    /**
-     * 의도 감지
-     */
-    detectIntent(query) {
-        for (const { pattern, intent } of INTENT_PATTERNS) {
-            if (pattern.test(query)) {
-                return intent;
-            }
-        }
-        return 'general';
-    }
-    /**
-     * 핵심 질문 추출
-     */
-    extractCoreQuery(normalized, intent) {
-        let core = normalized;
-        // 의도별 불필요한 패턴 제거
-        switch (intent) {
-            case 'definition':
-                // "X란 무엇인가요" → "X"
-                core = core.replace(/(이란|란)\s*(무엇|뭐)(인가요|입니까|야)?/gi, '');
-                core = core.replace(/what is\s*/gi, '');
-                break;
-            case 'howto':
-                // "어떻게 하면 X" → "X"
-                core = core.replace(/어떻게\s*(하면|해야|할 수 있나요|하나요)?/gi, '');
-                core = core.replace(/how (to|do|can|should)\s*(i|we|you)?\s*/gi, '');
-                break;
-            case 'why':
-                // "왜 X인가요" → "X"
-                core = core.replace(/왜\s*/gi, '');
-                core = core.replace(/why (is|does|do|are)\s*/gi, '');
-                break;
-            case 'comparison':
-                // 비교 구조 유지
-                break;
-            case 'list':
-                core = core.replace(/(어떤|무슨)\s*(종류|것들)(이|가)\s*(있나요|있어요|있을까요)?/gi, '');
-                break;
-        }
-        // 물음표 제거 및 정리
-        core = core.replace(/\?+/g, '').trim();
-        return core || normalized;
-    }
-    /**
-     * 검색용 키워드 추출
-     */
-    extractKeywords(query) {
-        const normalized = this.normalize(query);
-        const words = normalized.coreQuery
-            .split(/\s+/)
-            .filter(w => w.length > 1);
-        // 불용어 제거
-        const stopwords = new Set([
-            // 한국어 불용어
-            '의', '가', '이', '은', '들', '는', '좀', '잘', '걍', '과', '도', '를', '으로',
-            '자', '에', '와', '한', '하다', '있다', '되다', '수', '것', '등', '그', '및',
-            // 영어 불용어
-            'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
-            'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
-            'should', 'may', 'might', 'must', 'can', 'this', 'that', 'these', 'those'
-        ]);
-        return words.filter(w => !stopwords.has(w.toLowerCase()));
-    }
-    /**
-     * 쿼리 확장 (동의어/관련어)
-     */
-    expandQuery(query) {
-        const normalized = this.normalize(query);
-        const keywords = this.extractKeywords(query);
-        const expanded = [normalized.coreQuery];
-        // 간단한 동의어 매핑
-        const synonyms = {
-            // 한국어
-            '만들다': ['생성', '작성', '제작'],
-            '삭제': ['제거', '지우다', '없애다'],
-            '수정': ['변경', '편집', '업데이트'],
-            '찾다': ['검색', '탐색', '조회'],
-            '사용': ['이용', '활용'],
-            // 영어
-            'create': ['make', 'generate', 'build'],
-            'delete': ['remove', 'destroy', 'drop'],
-            'update': ['modify', 'change', 'edit'],
-            'find': ['search', 'query', 'lookup'],
-            'use': ['utilize', 'employ'],
-        };
-        for (const keyword of keywords) {
-            const syns = synonyms[keyword.toLowerCase()];
-            if (syns) {
-                for (const syn of syns) {
-                    const expandedQuery = normalized.coreQuery.replace(new RegExp(keyword, 'gi'), syn);
-                    if (!expanded.includes(expandedQuery)) {
-                        expanded.push(expandedQuery);
-                    }
-                }
-            }
-        }
-        return expanded;
-    }
-    /**
-     * 형식 지시문 생성
-     */
-    generateFormatInstruction(requirements) {
-        if (requirements.length === 0)
-            return '';
-        const instructions = [];
-        for (const req of requirements) {
-            switch (req.type) {
-                case 'table':
-                    instructions.push('표 형식으로 정리해주세요.');
-                    break;
-                case 'code':
-                    instructions.push('코드 예시를 포함해주세요.');
-                    break;
-                case 'list':
-                    instructions.push('목록/리스트 형식으로 나열해주세요.');
-                    break;
-                case 'steps':
-                    instructions.push('단계별로 설명해주세요.');
-                    break;
-                case 'comparison':
-                    instructions.push('비교표나 차이점을 명확히 정리해주세요.');
-                    break;
-                case 'summary':
-                    instructions.push('간결하게 요약해주세요.');
-                    break;
-                case 'example':
-                    instructions.push('구체적인 예시를 포함해주세요.');
-                    break;
-                case 'json':
-                    instructions.push('JSON 형식으로 출력해주세요.');
-                    break;
-                case 'markdown':
-                    instructions.push('마크다운 형식으로 작성해주세요.');
-                    break;
-            }
-        }
-        return instructions.join(' ');
-    }
-    /**
-     * 통계 조회
-     */
-    getStats() {
-        return {
-            totalQueries: this.stats.totalQueries,
-            avgFillerRemoved: this.stats.totalQueries > 0
-                ? this.stats.totalFillerRemoved / this.stats.totalQueries
-                : 0,
-            avgReductionRatio: this.stats.totalQueries > 0
-                ? this.stats.totalReduction / this.stats.totalQueries
-                : 0,
-            intentDistribution: Object.fromEntries(this.stats.intentDistribution)
-        };
-    }
-    /**
-     * 통계 초기화
-     */
-    resetStats() {
-        this.stats = {
-            totalQueries: 0,
-            totalFillerRemoved: 0,
-            totalReduction: 0,
-            intentDistribution: new Map()
-        };
-    }
-}
-// 싱글톤 인스턴스
-export const queryNormalizer = new QueryNormalizer();
-/**
- * 빠른 정규화 함수
- */
-export function normalizeQuery(query) {
-    return queryNormalizer.normalize(query).normalized;
-}
-/**
- * 핵심 쿼리 추출 함수
- */
-export function extractCoreQuery(query) {
-    return queryNormalizer.normalize(query).coreQuery;
-}
-//# sourceMappingURL=query-normalize.js.map

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

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

package/dist/services/query.d.ts

@@ -1,102 +0,0 @@
-/**
- * Query Service - Semantic search and retrieval
- * @module services/query
- */
-import type { UUID, Embedding384, NeuronNode, MerkleProof, IChunkStore, INeuronStore } from '../types/index.js';
-import { NeuronGraphManager } from '../core/neuron-graph.js';
-import { MerkleEngine } from '../core/merkle-engine.js';
-/**
- * Query result with neuron and metadata
- */
-export interface QueryResult {
-    neuron: NeuronNode;
-    score: number;
-    content?: string;
-    proof?: MerkleProof;
-}
-/**
- * Search options
- */
-export interface SearchOptions {
-    k?: number;
-    ef?: number;
-    threshold?: number;
-    includeContent?: boolean;
-    includeProof?: boolean;
-    tags?: string[];
-    sourceType?: string;
-}
-/**
- * Embedding provider interface
- */
-export interface QueryEmbeddingProvider {
-    embed(text: string): Promise<Embedding384>;
-}
-/**
- * Query Service for semantic search
- */
-export declare class QueryService {
-    private graphManager;
-    private merkleEngine;
-    private chunkStore;
-    private neuronStore;
-    private embeddingProvider;
-    constructor(graphManager: NeuronGraphManager, merkleEngine: MerkleEngine, chunkStore: IChunkStore, neuronStore: INeuronStore, embeddingProvider?: QueryEmbeddingProvider);
-    /**
-     * Search by text query
-     */
-    search(query: string, options?: SearchOptions): Promise<QueryResult[]>;
-    /**
-     * Search by embedding vector
-     */
-    searchByEmbedding(embedding: Embedding384, options?: SearchOptions): Promise<QueryResult[]>;
-    /**
-     * Search by neuron ID (find similar)
-     */
-    searchSimilarTo(neuronId: UUID, options?: SearchOptions): Promise<QueryResult[]>;
-    /**
-     * Get neuron by ID
-     */
-    getNeuron(id: UUID): Promise<NeuronNode | null>;
-    /**
-     * Get neuron by Merkle root
-     */
-    getNeuronByMerkleRoot(merkleRoot: string): Promise<NeuronNode | null>;
-    /**
-     * Get neuron content
-     */
-    getContent(neuron: NeuronNode): Promise<string>;
-    /**
-     * Generate Merkle proof for a chunk
-     */
-    generateProof(neuron: NeuronNode, chunkIndex: number): Promise<MerkleProof | null>;
-    /**
-     * Compute similarity between two neurons
-     */
-    computeSimilarity(neuronId1: UUID, neuronId2: UUID): Promise<number | null>;
-    /**
-     * Get neurons by tags
-     */
-    getNeuronsByTags(tags: string[]): Promise<NeuronNode[]>;
-    /**
-     * Get neurons by source type
-     */
-    getNeuronsBySourceType(sourceType: string): Promise<NeuronNode[]>;
-    /**
-     * Get recently accessed neurons
-     */
-    getRecentlyAccessed(limit?: number): Promise<NeuronNode[]>;
-    /**
-     * Get most accessed neurons
-     */
-    getMostAccessed(limit?: number): Promise<NeuronNode[]>;
-    /**
-     * Set embedding provider
-     */
-    setEmbeddingProvider(provider: QueryEmbeddingProvider): void;
-}
-/**
- * Create a QueryService instance
- */
-export declare function createQueryService(graphManager: NeuronGraphManager, merkleEngine: MerkleEngine, chunkStore: IChunkStore, neuronStore: INeuronStore, embeddingProvider?: QueryEmbeddingProvider): QueryService;
-//# sourceMappingURL=query.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/services/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,IAAI,EACJ,YAAY,EACZ,UAAU,EAGV,WAAW,EACX,WAAW,EACX,YAAY,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5C;AAiCD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,iBAAiB,CAAyB;gBAGhD,YAAY,EAAE,kBAAkB,EAChC,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,WAAW,EACvB,WAAW,EAAE,YAAY,EACzB,iBAAiB,CAAC,EAAE,sBAAsB;IAS5C;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKhF;;OAEG;IACG,iBAAiB,CACrB,SAAS,EAAE,YAAY,EACvB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC;IA+CzB;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,IAAI,EACd,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC;IAUzB;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIrD;;OAEG;IACG,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI3E;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBrD;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAY9B;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASjF;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAc7D;;OAEG;IACG,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAcvE;;OAEG;IACG,mBAAmB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkBpE;;OAEG;IACG,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAehE;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;CAG7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,kBAAkB,EAChC,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,WAAW,EACvB,WAAW,EAAE,YAAY,EACzB,iBAAiB,CAAC,EAAE,sBAAsB,GACzC,YAAY,CAQd"}