memento-mcp-server 0.1.0 → 1.7.1

package/dist/services/openai-embedding-service.d.ts

@@ -0,0 +1,36 @@
+/**
+ * OpenAI 임베딩 서비스
+ * text-embedding-3 시리즈를 활용해 고차원 임베딩 제공
+ */
+import type { EmbeddingServiceInterface, EmbeddingResult, SimilarityResult, EmbeddingData } from '../types/embedding.types.js';
+export declare class OpenAIEmbeddingService implements EmbeddingServiceInterface {
+    private client;
+    private readonly model;
+    private readonly dimensions;
+    private readonly maxTokens;
+    private readonly cache;
+    private readonly fallbackService;
+    constructor();
+    /**
+     * OpenAI 클라이언트를 초기화
+     */
+    private initializeClient;
+    isAvailable(): boolean;
+    getModelInfo(): {
+        model: string;
+        dimensions: number;
+        maxTokens: number;
+    };
+    generateEmbedding(text: string): Promise<EmbeddingResult | null>;
+    searchSimilar(query: string, embeddings: EmbeddingData[], limit?: number, threshold?: number): Promise<SimilarityResult[]>;
+    private generateOpenAIEmbedding;
+    private generateFallbackEmbedding;
+    private validateInput;
+    private truncateText;
+    private estimateTokens;
+    private cosineSimilarity;
+    private generateCacheKey;
+    private hashText;
+    private cleanupCache;
+}
+//# sourceMappingURL=openai-embedding-service.d.ts.map

package/dist/services/openai-embedding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-embedding-service.d.ts","sourceRoot":"","sources":["../../src/services/openai-embedding-service.ts"],"names":[],"mappings":"AACA;;;GAGG;AAIH,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,6BAA6B,CAAC;AAGrC,qBAAa,sBAAuB,YAAW,yBAAyB;IACtE,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;;IAWrE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAQlE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA0BhE,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,GAAE,MAAW,EAClB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAsBhB,uBAAuB;YA2BvB,yBAAyB;IAmBvC,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,YAAY;CAYrB"}

package/dist/services/openai-embedding-service.js

@@ -0,0 +1,192 @@
+/**
+ * OpenAI 임베딩 서비스
+ * text-embedding-3 시리즈를 활용해 고차원 임베딩 제공
+ */
+import OpenAI from 'openai';
+import { mementoConfig } from '../config/index.js';
+import { LightweightEmbeddingService } from './lightweight-embedding-service.js';
+export class OpenAIEmbeddingService {
+    client = null;
+    model;
+    dimensions;
+    maxTokens;
+    cache = new Map();
+    fallbackService = new LightweightEmbeddingService();
+    constructor() {
+        this.model = mementoConfig.openaiModel || 'text-embedding-3-small';
+        // text-embedding-3-small = 1536, text-embedding-3-large = 3072
+        this.dimensions = mementoConfig.embeddingDimensions || 1536;
+        this.maxTokens = 8191; // OpenAI 공식 문서 기준
+        this.initializeClient();
+    }
+    /**
+     * OpenAI 클라이언트를 초기화
+     */
+    initializeClient() {
+        if (!mementoConfig.openaiApiKey) {
+            console.warn('⚠️ OPENAI_API_KEY가 설정되지 않아 OpenAI 임베딩이 비활성화됩니다. ' +
+                '고품질 임베딩이 필요하면 키를 설정하거나 EMBEDDING_PROVIDER를 minilm으로 변경하세요.');
+            this.client = null;
+            return;
+        }
+        try {
+            this.client = new OpenAI({ apiKey: mementoConfig.openaiApiKey });
+            console.log('✅ OpenAI 임베딩 서비스 초기화 완료');
+        }
+        catch (error) {
+            console.error('❌ OpenAI 초기화 실패. OPENAI_API_KEY 값과 네트워크 접근 권한을 확인하거나 MiniLM/TFiDF 모델로 폴백하세요:', error);
+            this.client = null;
+        }
+    }
+    isAvailable() {
+        return this.client !== null;
+    }
+    getModelInfo() {
+        return {
+            model: this.model,
+            dimensions: this.dimensions,
+            maxTokens: this.maxTokens
+        };
+    }
+    async generateEmbedding(text) {
+        this.validateInput(text);
+        const cacheKey = this.generateCacheKey(text);
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        try {
+            if (!this.client && mementoConfig.openaiApiKey) {
+                this.initializeClient();
+            }
+            const result = await this.generateOpenAIEmbedding(text);
+            if (result) {
+                this.cache.set(cacheKey, result);
+                this.cleanupCache();
+            }
+            return result;
+        }
+        catch (error) {
+            console.warn('⚠️ OpenAI 임베딩 생성 실패, 경량 서비스로 fallback:', error);
+            return this.generateFallbackEmbedding(text, cacheKey);
+        }
+    }
+    async searchSimilar(query, embeddings, limit = 10, threshold = 0.7) {
+        if (embeddings.length === 0) {
+            return [];
+        }
+        const queryEmbedding = await this.generateEmbedding(query);
+        if (!queryEmbedding) {
+            return [];
+        }
+        return embeddings
+            .map(item => ({
+            id: item.id,
+            content: item.content,
+            similarity: this.cosineSimilarity(queryEmbedding.embedding, item.embedding),
+            score: this.cosineSimilarity(queryEmbedding.embedding, item.embedding)
+        }))
+            .filter(item => item.similarity >= threshold)
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, limit);
+    }
+    async generateOpenAIEmbedding(text) {
+        if (!this.client) {
+            throw new Error('OpenAI 클라이언트가 초기화되지 않았습니다.');
+        }
+        const truncatedText = this.truncateText(text);
+        const response = await this.client.embeddings.create({
+            model: this.model,
+            input: truncatedText
+        });
+        const embedding = response.data?.[0]?.embedding ?? [];
+        if (embedding.length === 0) {
+            throw new Error('OpenAI 임베딩 응답이 비어 있습니다.');
+        }
+        return {
+            embedding,
+            model: this.model,
+            provider: 'openai',
+            usage: {
+                prompt_tokens: response.usage?.prompt_tokens ?? this.estimateTokens(truncatedText),
+                total_tokens: response.usage?.total_tokens ?? this.estimateTokens(truncatedText)
+            }
+        };
+    }
+    async generateFallbackEmbedding(text, cacheKey) {
+        try {
+            const fallbackResult = await this.fallbackService.generateEmbedding(text);
+            if (fallbackResult) {
+                const patchedResult = {
+                    ...fallbackResult,
+                    provider: fallbackResult.provider ?? 'tfidf'
+                };
+                this.cache.set(cacheKey, patchedResult);
+                this.cleanupCache();
+                return patchedResult;
+            }
+            return null;
+        }
+        catch (fallbackError) {
+            console.error('❌ 경량 임베딩 fallback도 실패했습니다:', fallbackError);
+            return null;
+        }
+    }
+    validateInput(text) {
+        if (!text || text.trim().length === 0) {
+            throw new Error('텍스트가 비어 있습니다');
+        }
+    }
+    truncateText(text) {
+        const estimatedTokens = this.estimateTokens(text);
+        if (estimatedTokens <= this.maxTokens) {
+            return text;
+        }
+        const maxChars = this.maxTokens * 4;
+        return text.substring(0, maxChars);
+    }
+    estimateTokens(text) {
+        return Math.ceil(text.length / 4);
+    }
+    cosineSimilarity(vecA, vecB) {
+        if (vecA.length !== vecB.length) {
+            throw new Error('벡터 차원이 일치하지 않습니다');
+        }
+        let dot = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < vecA.length; i++) {
+            const a = vecA[i] ?? 0;
+            const b = vecB[i] ?? 0;
+            dot += a * b;
+            normA += a * a;
+            normB += b * b;
+        }
+        const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+        return denominator === 0 ? 0 : dot / denominator;
+    }
+    generateCacheKey(text) {
+        return `openai:${this.hashText(text)}`;
+    }
+    hashText(text) {
+        let hash = 0;
+        for (let i = 0; i < text.length; i++) {
+            const char = text.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash |= 0; // 32bit 변환
+        }
+        return hash.toString(36);
+    }
+    cleanupCache() {
+        const MAX_CACHE_SIZE = 1000;
+        if (this.cache.size <= MAX_CACHE_SIZE) {
+            return;
+        }
+        const entries = Array.from(this.cache.entries());
+        this.cache.clear();
+        entries.slice(-MAX_CACHE_SIZE / 2).forEach(([key, value]) => {
+            this.cache.set(key, value);
+        });
+    }
+}
+//# sourceMappingURL=openai-embedding-service.js.map

package/dist/services/openai-embedding-service.js.map

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

package/dist/services/performance-monitor.d.ts

@@ -10,10 +10,12 @@ export interface PerformanceMetrics {
         heapTotal: number;
         heapUsed: number;
         external: number;
+        usagePercent: number;
     };
     cpu: {
         user: number;
         system: number;
+        percent: number;
     };
     database: {
         size: number;
@@ -21,6 +23,17 @@ export interface PerformanceMetrics {
         queryTime: number;
     };
     uptime: number;
+    search?: {
+        total: number;
+        averageTime: number;
+        byType: {
+            text: number;
+            vector: number;
+            hybrid: number;
+        };
+        cacheHitRate: number;
+        embeddingSearchRate: number;
+    };
 }
 export interface AlertThresholds {
     memoryUsagePercent: number;
@@ -44,19 +57,20 @@ export declare class PerformanceMonitor {
     private alerts;
     private metricsHistory;
     private maxHistorySize;
+    private monitoringInterval;
     constructor(thresholds?: Partial<AlertThresholds>);
     /**
      * 모니터링 시작
      */
     initialize(db: Database.Database): void;
     /**
-     * 성능 지표 수집
+     * 데이터베이스 설정
      */
-    collectMetrics(): Promise<PerformanceMetrics>;
+    setDatabase(db: Database.Database | null): void;
     /**
-     * 데이터베이스 지표 수집
+     * 성능 지표 수집
      */
-    private getDatabaseMetrics;
+    collectMetrics(): Promise<any>;
     /**
      * 알림 검사
      */
@@ -65,22 +79,126 @@ export declare class PerformanceMonitor {
      * 지표 히스토리에 추가
      */
     private addToHistory;
+    /**
+     * 알림 해결
+     */
+    resolveAlert(alertId: string): boolean;
+    /**
+     * 현재 성능 지표 조회
+     */
+    getMetrics(): Promise<PerformanceMetrics>;
+    /**
+     * 성능 지표 히스토리 조회
+     */
+    getMetricsHistory(limit?: number): PerformanceMetrics[];
     /**
      * 활성 알림 조회
      */
+    getAlerts(): PerformanceAlert[];
     getActiveAlerts(): PerformanceAlert[];
+    getAllAlerts(): PerformanceAlert[];
     /**
-     * 모든 알림 조회
+     * 알림 초기화
      */
-    getAllAlerts(): PerformanceAlert[];
+    clearAlerts(): void;
     /**
-     * 알림 해결
+     * 성능 리포트 생성
      */
-    resolveAlert(alertId: string): boolean;
+    getPerformanceReport(): Promise<{
+        summary: {
+            current: PerformanceMetrics | null;
+            alerts: {
+                active: number;
+                total: number;
+            };
+            trends: {
+                memoryTrend: 'increasing' | 'decreasing' | 'stable';
+                dbSizeTrend: 'increasing' | 'decreasing' | 'stable';
+            };
+        };
+        metrics: PerformanceMetrics[];
+        alerts: PerformanceAlert[];
+        recommendations: string[];
+        analytics: ReturnType<PerformanceMonitor['getMetricsAnalytics']>;
+        timestamp: Date;
+    }>;
     /**
-     * 성능 지표 히스토리 조회
+     * 권장사항 생성
      */
-    getMetricsHistory(limit?: number): PerformanceMetrics[];
+    private generateRecommendations;
+    /**
+     * 모니터링 시작
+     */
+    startMonitoring(intervalMs?: number): void;
+    /**
+     * 모니터링 중지
+     */
+    stopMonitoring(): void;
+    /**
+     * 모니터링 상태 확인
+     */
+    isMonitoring(): boolean;
+    /**
+     * 검색 통계 기록
+     */
+    recordSearch(type: 'text' | 'vector' | 'hybrid', duration: number, cacheHit?: boolean): void;
+    /**
+     * 검색 메트릭 조회
+     */
+    getSearchMetrics(): {
+        totalSearches: number;
+        averageSearchTime: number;
+        searchByType: {
+            text: number;
+            vector: number;
+            hybrid: number;
+        };
+        cacheHitRate: number;
+        embeddingSearchRate: number;
+    };
+    /**
+     * 메모리 메트릭 조회
+     */
+    getMemoryMetrics(): {
+        heapUsed: number;
+        heapTotal: number;
+        rss: number;
+        external: number;
+        usagePercent: number;
+    };
+    /**
+     * 시스템 메트릭 조회
+     */
+    getSystemMetrics(): {
+        uptime: number;
+        cpuUsage: number;
+        loadAverage: number[];
+    };
+    /**
+     * 데이터베이스 메트릭 조회
+     */
+    getDatabaseMetrics(): Promise<{
+        totalMemories: number;
+        memoryByType: Record<string, number>;
+        averageMemorySize: number;
+        databaseSize: number;
+    }>;
+    /**
+     * 통계 초기화
+     */
+    resetStats(): void;
+    /**
+     * 시스템 건강 상태 확인
+     */
+    isHealthy(): Promise<boolean>;
+    /**
+     * 메트릭 내보내기
+     */
+    exportMetrics(): Promise<string>;
+    /**
+     * 메트릭 가져오기
+     */
+    importMetrics(json: string): Promise<void>;
     /**
      * 성능 통계 요약
      */
@@ -95,6 +213,32 @@ export declare class PerformanceMonitor {
             dbSizeTrend: 'increasing' | 'decreasing' | 'stable';
         };
     };
+    getMetricsAnalytics(limit?: number): {
+        memory: {
+            averageHeapUsedMB: number;
+            peakHeapUsedMB: number;
+            averageUsagePercent: number;
+            history: number[];
+        };
+        cpu: {
+            averagePercent: number;
+            peakPercent: number;
+            history: number[];
+        };
+        database: {
+            averageSizeMB: number;
+            lastSizeMB: number;
+            growthRate: number;
+        };
+        search: {
+            totalSearches: number;
+            averageSearchTime: number;
+            cacheHitRate: number;
+            textShare: number;
+            vectorShare: number;
+            hybridShare: number;
+        };
+    };
     /**
      * 트렌드 분석
      */

package/dist/services/performance-monitor.d.ts.map

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