@ninebix/nmt-system 1.0.0

package/dist/services/query-normalize.js

@@ -0,0 +1,366 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,102 @@
+/**
+ * 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

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