@ninebix/nmt-system 1.0.0

package/dist/services/metrics-dashboard.js

@@ -0,0 +1,417 @@
+/**
+ * NMT Metrics Dashboard
+ * KPI 메트릭 통합 대시보드
+ *
+ * 설계 문서: NMT_Updated.md 5절
+ *
+ * 비용 절감 KPI:
+ * - LLM_call_rate: 전체 요청 대비 LLM 호출 비율
+ * - prompt_tokens p50/p95
+ * - cost_per_request avg
+ * - cache_hit_rate
+ * - model_mix_ratio
+ *
+ * 품질 KPI:
+ * - grounded_rate: sources 포함 응답 비율
+ * - accuracy / human eval
+ * - abstain_rate: 근거 부족 시 "모름/부족" 반환 비율
+ *
+ * 성능 KPI:
+ * - latency p50/p95
+ * - retrieve/verify/compose 단계별 latency
+ *
+ * @module services/metrics-dashboard
+ */
+/**
+ * Metrics Collector
+ */
+export class MetricsCollector {
+    dataPoints = new Map();
+    maxDataPoints = 10000;
+    retentionMs = 24 * 60 * 60 * 1000; // 24시간
+    /**
+     * 메트릭 기록
+     */
+    record(metricName, value, metadata) {
+        if (!this.dataPoints.has(metricName)) {
+            this.dataPoints.set(metricName, []);
+        }
+        const points = this.dataPoints.get(metricName);
+        points.push({
+            timestamp: Date.now(),
+            value,
+            metadata
+        });
+        // 오래된 데이터 정리
+        this.pruneOldData(metricName);
+    }
+    /**
+     * 오래된 데이터 제거
+     */
+    pruneOldData(metricName) {
+        const points = this.dataPoints.get(metricName);
+        if (!points)
+            return;
+        const cutoff = Date.now() - this.retentionMs;
+        // 시간 기반 정리
+        const validPoints = points.filter(p => p.timestamp > cutoff);
+        // 개수 기반 정리
+        if (validPoints.length > this.maxDataPoints) {
+            validPoints.splice(0, validPoints.length - this.maxDataPoints);
+        }
+        this.dataPoints.set(metricName, validPoints);
+    }
+    /**
+     * 백분위 계산
+     */
+    calculatePercentiles(metricName, periodMs) {
+        const points = this.dataPoints.get(metricName) || [];
+        const cutoff = periodMs ? Date.now() - periodMs : 0;
+        const values = points
+            .filter(p => p.timestamp > cutoff)
+            .map(p => p.value)
+            .sort((a, b) => a - b);
+        if (values.length === 0) {
+            return {
+                min: 0, max: 0, avg: 0,
+                p50: 0, p75: 0, p95: 0, p99: 0,
+                count: 0
+            };
+        }
+        const percentile = (arr, p) => {
+            const idx = Math.ceil(arr.length * p / 100) - 1;
+            return arr[Math.max(0, idx)];
+        };
+        return {
+            min: values[0],
+            max: values[values.length - 1],
+            avg: values.reduce((a, b) => a + b, 0) / values.length,
+            p50: percentile(values, 50),
+            p75: percentile(values, 75),
+            p95: percentile(values, 95),
+            p99: percentile(values, 99),
+            count: values.length
+        };
+    }
+    /**
+     * 비율 계산
+     */
+    calculateRate(successMetric, totalMetric, periodMs) {
+        const successPoints = this.dataPoints.get(successMetric) || [];
+        const totalPoints = this.dataPoints.get(totalMetric) || [];
+        const cutoff = periodMs ? Date.now() - periodMs : 0;
+        const successCount = successPoints.filter(p => p.timestamp > cutoff).length;
+        const totalCount = totalPoints.filter(p => p.timestamp > cutoff).length;
+        return totalCount > 0 ? successCount / totalCount : 0;
+    }
+    /**
+     * 합계 계산
+     */
+    calculateSum(metricName, periodMs) {
+        const points = this.dataPoints.get(metricName) || [];
+        const cutoff = periodMs ? Date.now() - periodMs : 0;
+        return points
+            .filter(p => p.timestamp > cutoff)
+            .reduce((sum, p) => sum + p.value, 0);
+    }
+    /**
+     * 카운트 계산
+     */
+    getCount(metricName, periodMs) {
+        const points = this.dataPoints.get(metricName) || [];
+        const cutoff = periodMs ? Date.now() - periodMs : 0;
+        return points.filter(p => p.timestamp > cutoff).length;
+    }
+    /**
+     * 메트릭 초기화
+     */
+    clear(metricName) {
+        if (metricName) {
+            this.dataPoints.delete(metricName);
+        }
+        else {
+            this.dataPoints.clear();
+        }
+    }
+    /**
+     * 모든 메트릭 이름 조회
+     */
+    getMetricNames() {
+        return Array.from(this.dataPoints.keys());
+    }
+}
+/**
+ * NMT Metrics Dashboard
+ */
+export class NMTMetricsDashboard {
+    collector;
+    alertThresholds;
+    alerts = [];
+    // 외부 통계 제공자 (옵션)
+    externalProviders = new Map();
+    constructor(thresholds) {
+        this.collector = new MetricsCollector();
+        this.alertThresholds = {
+            maxCostPerRequest: thresholds?.maxCostPerRequest ?? 0.05,
+            minCacheHitRate: thresholds?.minCacheHitRate ?? 0.2,
+            maxLLMCallRate: thresholds?.maxLLMCallRate ?? 0.8,
+            minGroundedRate: thresholds?.minGroundedRate ?? 0.7,
+            maxAbstainRate: thresholds?.maxAbstainRate ?? 0.3,
+            maxLatencyP95: thresholds?.maxLatencyP95 ?? 5000,
+            minThroughput: thresholds?.minThroughput ?? 1,
+            maxTransientRatio: thresholds?.maxTransientRatio ?? 0.4
+        };
+    }
+    /**
+     * 외부 통계 제공자 등록
+     */
+    registerProvider(name, provider) {
+        this.externalProviders.set(name, provider);
+    }
+    // ============== 메트릭 기록 메서드 ==============
+    /**
+     * 요청 기록
+     */
+    recordRequest(metrics) {
+        this.collector.record('request.total', 1);
+        if (metrics.cacheHit) {
+            this.collector.record('request.cache_hit', 1);
+        }
+        if (metrics.llmCalled) {
+            this.collector.record('request.llm_called', 1);
+        }
+        if (metrics.promptTokens !== undefined) {
+            this.collector.record('tokens.prompt', metrics.promptTokens);
+        }
+        if (metrics.costUSD !== undefined) {
+            this.collector.record('cost.per_request', metrics.costUSD);
+            this.collector.record('cost.total', metrics.costUSD);
+        }
+        if (metrics.modelLevel) {
+            this.collector.record(`model.${metrics.modelLevel}`, 1);
+        }
+        this.collector.record('latency.total', metrics.totalLatencyMs);
+        if (metrics.searchLatencyMs !== undefined) {
+            this.collector.record('latency.search', metrics.searchLatencyMs);
+        }
+        if (metrics.verifyLatencyMs !== undefined) {
+            this.collector.record('latency.verify', metrics.verifyLatencyMs);
+        }
+        if (metrics.compressLatencyMs !== undefined) {
+            this.collector.record('latency.compress', metrics.compressLatencyMs);
+        }
+        if (metrics.llmLatencyMs !== undefined) {
+            this.collector.record('latency.llm', metrics.llmLatencyMs);
+        }
+    }
+    /**
+     * 품질 메트릭 기록
+     */
+    recordQuality(metrics) {
+        this.collector.record('quality.total', 1);
+        if (metrics.grounded) {
+            this.collector.record('quality.grounded', 1);
+        }
+        if (metrics.abstained) {
+            this.collector.record('quality.abstained', 1);
+        }
+        if (metrics.verificationSuccess) {
+            this.collector.record('quality.verified', 1);
+        }
+        this.collector.record('quality.grounding_score', metrics.groundingScore);
+        this.collector.record('quality.sources_count', metrics.sourcesCount);
+    }
+    /**
+     * 리소스 메트릭 기록
+     */
+    recordResource(metrics) {
+        this.collector.record('resource.fact_neurons', metrics.factNeurons);
+        this.collector.record('resource.transient_neurons', metrics.transientNeurons);
+        this.collector.record('resource.index_size', metrics.indexSize);
+        this.collector.record('resource.cache_size', metrics.cacheSize);
+    }
+    // ============== KPI 계산 메서드 ==============
+    /**
+     * 비용 KPI 계산
+     */
+    getCostKPIs(periodMs = 3600000) {
+        const totalRequests = this.collector.getCount('request.total', periodMs);
+        const llmCalls = this.collector.getCount('request.llm_called', periodMs);
+        const cacheHits = this.collector.getCount('request.cache_hit', periodMs);
+        const simpleCount = this.collector.getCount('model.simple', periodMs);
+        const mediumCount = this.collector.getCount('model.medium', periodMs);
+        const complexCount = this.collector.getCount('model.complex', periodMs);
+        const modelTotal = simpleCount + mediumCount + complexCount;
+        return {
+            llmCallRate: totalRequests > 0 ? llmCalls / totalRequests : 0,
+            promptTokens: this.collector.calculatePercentiles('tokens.prompt', periodMs),
+            costPerRequest: this.collector.calculatePercentiles('cost.per_request', periodMs),
+            cacheHitRate: totalRequests > 0 ? cacheHits / totalRequests : 0,
+            modelMixRatio: {
+                simple: modelTotal > 0 ? simpleCount / modelTotal : 0,
+                medium: modelTotal > 0 ? mediumCount / modelTotal : 0,
+                complex: modelTotal > 0 ? complexCount / modelTotal : 0
+            },
+            totalCostUSD: this.collector.calculateSum('cost.total', periodMs),
+            savedCostUSD: this.collector.calculateSum('cost.saved', periodMs),
+            savingsRate: 0 // 외부에서 계산 필요
+        };
+    }
+    /**
+     * 품질 KPI 계산
+     */
+    getQualityKPIs(periodMs = 3600000) {
+        const totalQuality = this.collector.getCount('quality.total', periodMs);
+        const groundedCount = this.collector.getCount('quality.grounded', periodMs);
+        const abstainedCount = this.collector.getCount('quality.abstained', periodMs);
+        const verifiedCount = this.collector.getCount('quality.verified', periodMs);
+        const groundingScores = this.collector.calculatePercentiles('quality.grounding_score', periodMs);
+        const sourcesStats = this.collector.calculatePercentiles('quality.sources_count', periodMs);
+        return {
+            groundedRate: totalQuality > 0 ? groundedCount / totalQuality : 0,
+            abstainRate: totalQuality > 0 ? abstainedCount / totalQuality : 0,
+            avgGroundingScore: groundingScores.avg,
+            verificationSuccessRate: totalQuality > 0 ? verifiedCount / totalQuality : 0,
+            avgSourcesPerResponse: sourcesStats.avg
+        };
+    }
+    /**
+     * 성능 KPI 계산
+     */
+    getPerformanceKPIs(periodMs = 3600000) {
+        const totalRequests = this.collector.getCount('request.total', periodMs);
+        const periodSeconds = periodMs / 1000;
+        return {
+            totalLatency: this.collector.calculatePercentiles('latency.total', periodMs),
+            searchLatency: this.collector.calculatePercentiles('latency.search', periodMs),
+            verifyLatency: this.collector.calculatePercentiles('latency.verify', periodMs),
+            compressLatency: this.collector.calculatePercentiles('latency.compress', periodMs),
+            llmLatency: this.collector.calculatePercentiles('latency.llm', periodMs),
+            throughput: totalRequests / periodSeconds
+        };
+    }
+    /**
+     * 리소스 KPI 계산
+     */
+    getResourceKPIs() {
+        // 최신 값 가져오기
+        const factNeurons = this.collector.calculatePercentiles('resource.fact_neurons').avg;
+        const transientNeurons = this.collector.calculatePercentiles('resource.transient_neurons').avg;
+        const total = factNeurons + transientNeurons;
+        return {
+            totalNeurons: total,
+            factNeurons,
+            transientNeurons,
+            factRatio: total > 0 ? factNeurons / total : 0,
+            indexSize: this.collector.calculatePercentiles('resource.index_size').avg,
+            cacheSize: this.collector.calculatePercentiles('resource.cache_size').avg,
+            gcStats: {
+                runs: this.collector.getCount('gc.runs'),
+                expired: this.collector.calculateSum('gc.expired'),
+                promoted: this.collector.calculateSum('gc.promoted'),
+                demoted: this.collector.calculateSum('gc.demoted')
+            }
+        };
+    }
+    // ============== 대시보드 생성 ==============
+    /**
+     * 전체 대시보드 생성
+     */
+    getDashboard(periodMs = 3600000) {
+        const dashboard = {
+            timestamp: new Date().toISOString(),
+            period: `${Math.round(periodMs / 60000)} minutes`,
+            cost: this.getCostKPIs(periodMs),
+            quality: this.getQualityKPIs(periodMs),
+            performance: this.getPerformanceKPIs(periodMs),
+            resources: this.getResourceKPIs(),
+            alerts: []
+        };
+        // 알림 체크
+        dashboard.alerts = this.checkAlerts(dashboard);
+        return dashboard;
+    }
+    /**
+     * 알림 체크
+     */
+    checkAlerts(dashboard) {
+        const alerts = [];
+        const now = Date.now();
+        // 비용 알림
+        if (dashboard.cost.costPerRequest.avg > this.alertThresholds.maxCostPerRequest) {
+            alerts.push({
+                level: 'warning',
+                metric: 'cost.per_request',
+                message: `요청당 비용이 임계값 초과: $${dashboard.cost.costPerRequest.avg.toFixed(4)}`,
+                value: dashboard.cost.costPerRequest.avg,
+                threshold: this.alertThresholds.maxCostPerRequest,
+                timestamp: now
+            });
+        }
+        if (dashboard.cost.cacheHitRate < this.alertThresholds.minCacheHitRate) {
+            alerts.push({
+                level: 'warning',
+                metric: 'cache.hit_rate',
+                message: `캐시 히트율 저조: ${(dashboard.cost.cacheHitRate * 100).toFixed(1)}%`,
+                value: dashboard.cost.cacheHitRate,
+                threshold: this.alertThresholds.minCacheHitRate,
+                timestamp: now
+            });
+        }
+        // 품질 알림
+        if (dashboard.quality.groundedRate < this.alertThresholds.minGroundedRate) {
+            alerts.push({
+                level: 'critical',
+                metric: 'quality.grounded_rate',
+                message: `근거 기반 응답 비율 저조: ${(dashboard.quality.groundedRate * 100).toFixed(1)}%`,
+                value: dashboard.quality.groundedRate,
+                threshold: this.alertThresholds.minGroundedRate,
+                timestamp: now
+            });
+        }
+        if (dashboard.quality.abstainRate > this.alertThresholds.maxAbstainRate) {
+            alerts.push({
+                level: 'warning',
+                metric: 'quality.abstain_rate',
+                message: `답변 거부 비율 과다: ${(dashboard.quality.abstainRate * 100).toFixed(1)}%`,
+                value: dashboard.quality.abstainRate,
+                threshold: this.alertThresholds.maxAbstainRate,
+                timestamp: now
+            });
+        }
+        // 성능 알림
+        if (dashboard.performance.totalLatency.p95 > this.alertThresholds.maxLatencyP95) {
+            alerts.push({
+                level: 'warning',
+                metric: 'latency.p95',
+                message: `P95 지연 시간 초과: ${dashboard.performance.totalLatency.p95.toFixed(0)}ms`,
+                value: dashboard.performance.totalLatency.p95,
+                threshold: this.alertThresholds.maxLatencyP95,
+                timestamp: now
+            });
+        }
+        return alerts;
+    }
+    /**
+     * 알림 임계값 업데이트
+     */
+    updateThresholds(thresholds) {
+        this.alertThresholds = { ...this.alertThresholds, ...thresholds };
+    }
+    /**
+     * 메트릭 초기화
+     */
+    reset() {
+        this.collector.clear();
+        this.alerts = [];
+    }
+    /**
+     * 대시보드 JSON 내보내기
+     */
+    exportJSON(periodMs) {
+        return JSON.stringify(this.getDashboard(periodMs), null, 2);
+    }
+}
+// 싱글톤 인스턴스
+export const metricsDashboard = new NMTMetricsDashboard();
+//# sourceMappingURL=metrics-dashboard.js.map

package/dist/services/metrics-dashboard.js.map

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

package/dist/services/neuron-lifecycle.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Neuron Lifecycle Service
+ * Fact vs Transient 분류 및 TTL 기반 생명주기 관리
+ *
+ * 설계 문서: NMT_Updated.md 4.1절
+ * - Fact Neuron: 장기 재사용 지식 (정책/스펙/규칙/검증된 해결책/템플릿)
+ * - Transient Neuron: 일회성 대화/시도 로그/잡담/임시 상태
+ * - Transient는 TTL(만료) 또는 저장 금지/요약 저장만 허용
+ *
+ * @module services/neuron-lifecycle
+ */
+import type { NeuronNode, NeuronType, UUID, NeuronMetadata } from '../types/index.js';
+/**
+ * 분류 결과
+ */
+export interface ClassificationResult {
+    type: NeuronType;
+    confidence: number;
+    reason: string;
+    suggestedTTL?: number;
+    suggestedImportance: number;
+}
+/**
+ * 생명주기 정책
+ */
+export interface LifecyclePolicy {
+    defaultTransientTTL: number;
+    minFactAccessCount: number;
+    inactivityThreshold: number;
+    autoPromoteAccessCount: number;
+    gcInterval: number;
+    maxTransientRatio: number;
+}
+/**
+ * GC 결과
+ */
+export interface GCResult {
+    scannedCount: number;
+    expiredCount: number;
+    promotedCount: number;
+    demotedCount: number;
+    freedBytes: number;
+    durationMs: number;
+}
+/**
+ * Neuron Lifecycle Manager
+ */
+export declare class NeuronLifecycleManager {
+    private policy;
+    private gcTimer;
+    private getNeuron;
+    private updateNeuron;
+    private deleteNeuron;
+    private getAllNeuronIds;
+    private stats;
+    constructor(policy?: Partial<LifecyclePolicy>);
+    /**
+     * 스토어 콜백 설정
+     */
+    setStoreCallbacks(callbacks: {
+        getNeuron: (id: UUID) => Promise<NeuronNode | null>;
+        updateNeuron: (id: UUID, updates: Partial<NeuronNode>) => Promise<void>;
+        deleteNeuron: (id: UUID) => Promise<void>;
+        getAllNeuronIds: () => Promise<UUID[]>;
+    }): void;
+    /**
+     * 콘텐츠 기반 자동 분류
+     */
+    classify(content: string, sourceType?: string, tags?: string[]): ClassificationResult;
+    /**
+     * 뉴런 메타데이터에 분류 적용
+     */
+    applyClassification(metadata: NeuronMetadata, classification: ClassificationResult): NeuronMetadata;
+    /**
+     * Transient → Fact 승격
+     */
+    promoteToFact(neuronId: UUID): Promise<boolean>;
+    /**
+     * Fact → Transient 강등
+     */
+    demoteToTransient(neuronId: UUID, ttl?: number): Promise<boolean>;
+    /**
+     * TTL 연장
+     */
+    extendTTL(neuronId: UUID, additionalTTL: number): Promise<boolean>;
+    /**
+     * 만료 확인
+     */
+    isExpired(neuron: NeuronNode): boolean;
+    /**
+     * 자동 승격 체크
+     */
+    shouldAutoPromote(neuron: NeuronNode): boolean;
+    /**
+     * 비활성 체크 (Fact 강등 후보)
+     */
+    isInactive(neuron: NeuronNode): boolean;
+    /**
+     * GC 실행
+     */
+    runGC(): Promise<GCResult>;
+    /**
+     * 뉴런 크기 추정
+     */
+    private estimateNeuronSize;
+    /**
+     * 자동 GC 시작
+     */
+    startAutoGC(): void;
+    /**
+     * 자동 GC 중지
+     */
+    stopAutoGC(): void;
+    /**
+     * 통계 조회
+     */
+    getStats(): {
+        totalClassifications: number;
+        factCount: number;
+        transientCount: number;
+        factRatio: number;
+        promotions: number;
+        demotions: number;
+        gcRuns: number;
+        totalExpired: number;
+    };
+    /**
+     * 통계 초기화
+     */
+    resetStats(): void;
+    /**
+     * 정책 업데이트
+     */
+    updatePolicy(policy: Partial<LifecyclePolicy>): void;
+}
+export declare const neuronLifecycle: NeuronLifecycleManager;
+//# sourceMappingURL=neuron-lifecycle.d.ts.map

package/dist/services/neuron-lifecycle.d.ts.map

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