memento-mcp-server 0.1.0 → 1.7.1

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

@@ -0,0 +1,360 @@
+import { migrationMonitorService } from './migration-monitor-service.js';
+import { migrationHistoryService } from './migration-history-service.js';
+import { vectorCompatibilityService } from './vector-compatibility-service.js';
+const DEFAULT_BATCH_SIZE = 500;
+const DEFAULT_CREATED_BY = 'embedding_migration_service';
+/**
+ * 임베딩 마이그레이션 서비스
+ * - 기존 임베딩 벡터를 목표 제공자의 차원에 맞게 재투영
+ * - 마이그레이션 플랜/실행/진행 상태 관리
+ */
+export class EmbeddingMigrationService {
+    createSnapshot(progress) {
+        return {
+            ...progress,
+            stepHistory: progress.stepHistory.map(step => ({ ...step })),
+            currentStep: progress.currentStep ? { ...progress.currentStep } : undefined
+        };
+    }
+    resolveRunStatus(progress) {
+        const finished = !progress.currentStep && (progress.total === 0 || progress.processed >= progress.total);
+        if (finished) {
+            return progress.failed > 0 ? 'failed' : 'completed';
+        }
+        return 'running';
+    }
+    notifyProgress(progress, monitor) {
+        if (!monitor.onProgress && !(monitor.reporter && monitor.runId)) {
+            return;
+        }
+        const snapshot = Object.freeze(this.createSnapshot(progress));
+        if (monitor.onProgress) {
+            monitor.onProgress(snapshot);
+        }
+        if (monitor.reporter && monitor.runId) {
+            monitor.reporter.publish({
+                runId: monitor.runId,
+                progress: snapshot,
+                status: this.resolveRunStatus(progress),
+                timestamp: new Date()
+            });
+        }
+    }
+    beginStep(progress, description) {
+        const step = {
+            id: `step-${progress.stepHistory.length + 1}`,
+            description,
+            status: 'running',
+            startedAt: new Date()
+        };
+        progress.currentStep = step;
+        progress.stepHistory.push(step);
+        return step;
+    }
+    completeStep(progress, step, status, error) {
+        step.status = status;
+        step.completedAt = new Date();
+        if (error) {
+            step.error = error;
+        }
+        progress.currentStep = undefined;
+    }
+    createPlan(sourceProvider, targetProvider, overrides = {}) {
+        const { sourceProvider: _ignoredSource, targetProvider: _ignoredTarget, targetDimensions: overrideDimensions, projectionType: overrideProjection, normalization: overrideNormalization, batchSize: overrideBatch, dryRun, resumeFromId, targetModel, createdBy, autoRollbackOnFailure } = overrides;
+        const targetDimensions = overrideDimensions ?? vectorCompatibilityService.getNativeDimensions(targetProvider);
+        return {
+            sourceProvider,
+            targetProvider,
+            targetDimensions,
+            projectionType: overrideProjection ?? 'native',
+            normalization: overrideNormalization ?? 'none',
+            targetModel: targetModel ?? `compat-${targetProvider}`,
+            createdBy: createdBy ?? DEFAULT_CREATED_BY,
+            batchSize: overrideBatch ?? DEFAULT_BATCH_SIZE,
+            dryRun: dryRun ?? false,
+            resumeFromId,
+            autoRollbackOnFailure: autoRollbackOnFailure ?? true
+        };
+    }
+    listTargets(db, plan, limit) {
+        const effectiveLimit = limit ?? plan.batchSize ?? DEFAULT_BATCH_SIZE;
+        const resumeKey = plan.resumeFromId ?? null;
+        const rows = db
+            .prepare(`
+        SELECT memory_id, embedding_provider, projection_type, dimensions, model
+        FROM memory_embedding
+        WHERE embedding_provider = ?
+          AND (? IS NULL OR memory_id > ?)
+        ORDER BY memory_id
+        LIMIT ?
+      `)
+            .all(plan.sourceProvider, resumeKey, resumeKey, effectiveLimit);
+        return rows.map(row => ({
+            memoryId: row.memory_id,
+            currentProvider: row.embedding_provider,
+            currentProjection: (row.projection_type ?? 'native'),
+            currentDimensions: row.dimensions ?? 0,
+            currentModel: row.model,
+            targetProvider: plan.targetProvider,
+            targetProjection: plan.projectionType,
+            targetDimensions: plan.targetDimensions,
+            needsReprojection: (row.dimensions ?? 0) !== plan.targetDimensions || row.projection_type !== plan.projectionType,
+            needsProviderSwitch: row.embedding_provider !== plan.targetProvider
+        }));
+    }
+    initializeProgress(total, resumeFromId) {
+        const now = new Date();
+        return {
+            total,
+            processed: 0,
+            succeeded: 0,
+            failed: 0,
+            startedAt: now,
+            updatedAt: now,
+            lastMemoryId: resumeFromId,
+            stepHistory: []
+        };
+    }
+    async execute(db, plan, monitor = {}) {
+        const effectiveMonitor = monitor.runId && !monitor.reporter
+            ? { ...monitor, reporter: migrationMonitorService }
+            : monitor;
+        const totalRow = db
+            .prepare('SELECT COUNT(*) AS count FROM memory_embedding WHERE embedding_provider = ?')
+            .get(plan.sourceProvider);
+        const total = totalRow?.count ?? 0;
+        const progress = this.initializeProgress(total, plan.resumeFromId);
+        const errors = [];
+        const rollbackEntries = [];
+        const reportEvery = effectiveMonitor.reportEvery && effectiveMonitor.reportEvery > 0
+            ? effectiveMonitor.reportEvery
+            : Math.max(1, Math.floor((plan.batchSize ?? DEFAULT_BATCH_SIZE) / 2));
+        const step = this.beginStep(progress, effectiveMonitor.stepDescription ?? 'Embedding vector migration');
+        this.notifyProgress(progress, effectiveMonitor);
+        if (total === 0) {
+            const now = new Date();
+            this.completeStep(progress, step, 'completed');
+            this.notifyProgress(progress, effectiveMonitor);
+            return {
+                success: true,
+                processed: 0,
+                succeeded: 0,
+                failed: 0,
+                startTime: now,
+                endTime: now,
+                nextResumeFromId: plan.resumeFromId ?? undefined,
+                rollbackEntries: [],
+                rolledBack: false
+            };
+        }
+        let lastProcessedId = plan.resumeFromId ?? null;
+        const selectStatement = db.prepare(`
+      SELECT memory_id, embedding, model, embedding_provider, projection_type, dim, dimensions, created_at
+      FROM memory_embedding
+      WHERE embedding_provider = ?
+        AND (? IS NULL OR memory_id > ?)
+      ORDER BY memory_id
+      LIMIT ?
+    `);
+        const upsertStatement = db.prepare(`
+      INSERT INTO memory_embedding (
+        memory_id,
+        embedding_provider,
+        projection_type,
+        embedding,
+        dim,
+        model,
+        dimensions,
+        precision,
+        normalized,
+        version,
+        created_by,
+        created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, CURRENT_TIMESTAMP)
+      ON CONFLICT(memory_id, embedding_provider, projection_type) DO UPDATE SET
+        embedding = excluded.embedding,
+        dim = excluded.dim,
+        model = excluded.model,
+        dimensions = excluded.dimensions,
+        precision = excluded.precision,
+        normalized = excluded.normalized,
+        version = excluded.version,
+        created_by = excluded.created_by,
+        created_at = CURRENT_TIMESTAMP
+    `);
+        const normalizationMode = plan.normalization ?? 'none';
+        const existingStatement = db.prepare(`
+      SELECT embedding, dim, model, dimensions, precision, normalized, version, created_by, created_at
+      FROM memory_embedding
+      WHERE memory_id = ? AND embedding_provider = ? AND projection_type = ?
+    `);
+        const processBatch = (batch) => {
+            for (const row of batch) {
+                progress.processed += 1;
+                progress.lastMemoryId = row.memory_id;
+                try {
+                    const parsed = this.safeParseEmbedding(row.embedding);
+                    const assessment = vectorCompatibilityService.assessProviderCompatibility(parsed, plan.targetProvider, {
+                        targetDimensions: plan.targetDimensions,
+                        normalization: normalizationMode
+                    });
+                    const storedVector = assessment.projection.vector;
+                    const serialized = JSON.stringify(storedVector);
+                    const projectionType = assessment.projection.projectionType;
+                    const normalizedFlag = assessment.projection.normalized ? 1 : 0;
+                    const targetModel = plan.targetModel ?? row.model ?? `compat-${plan.targetProvider}`;
+                    const createdBy = plan.createdBy ?? DEFAULT_CREATED_BY;
+                    if (!plan.dryRun) {
+                        const existing = existingStatement.get(row.memory_id, plan.targetProvider, projectionType);
+                        upsertStatement.run(row.memory_id, plan.targetProvider, projectionType, serialized, plan.targetDimensions, targetModel, plan.targetDimensions, 32, normalizedFlag, 1, createdBy);
+                        if (existing) {
+                            rollbackEntries.push({
+                                memoryId: row.memory_id,
+                                provider: plan.targetProvider,
+                                projectionType,
+                                operation: 'restore',
+                                embedding: existing.embedding,
+                                dim: existing.dim,
+                                dimensions: existing.dimensions,
+                                model: existing.model,
+                                precision: existing.precision,
+                                normalized: existing.normalized,
+                                version: existing.version,
+                                createdBy: existing.created_by,
+                                createdAt: existing.created_at ?? undefined
+                            });
+                        }
+                        else {
+                            rollbackEntries.push({
+                                memoryId: row.memory_id,
+                                provider: plan.targetProvider,
+                                projectionType,
+                                operation: 'delete'
+                            });
+                        }
+                    }
+                    progress.succeeded += 1;
+                }
+                catch (error) {
+                    progress.failed += 1;
+                    errors.push({
+                        memoryId: row.memory_id,
+                        provider: plan.targetProvider,
+                        message: error instanceof Error ? error.message : 'Unknown error'
+                    });
+                }
+                finally {
+                    progress.updatedAt = new Date();
+                    if (reportEvery > 0 && progress.processed % reportEvery === 0) {
+                        this.notifyProgress(progress, effectiveMonitor);
+                    }
+                }
+            }
+        };
+        while (true) {
+            const batch = selectStatement.all(plan.sourceProvider, lastProcessedId, lastProcessedId, plan.batchSize ?? DEFAULT_BATCH_SIZE);
+            if (!batch.length) {
+                break;
+            }
+            processBatch(batch);
+            lastProcessedId = batch[batch.length - 1]?.memory_id ?? lastProcessedId;
+            this.notifyProgress(progress, effectiveMonitor);
+        }
+        const endTime = new Date();
+        const success = progress.failed === 0;
+        let rolledBack = false;
+        this.completeStep(progress, step, success ? 'completed' : 'failed', success ? undefined : 'One or more records failed');
+        this.notifyProgress(progress, effectiveMonitor);
+        const shouldRollback = !success && !plan.dryRun && (plan.autoRollbackOnFailure ?? true);
+        if (shouldRollback) {
+            try {
+                this.rollback(db, rollbackEntries);
+                rolledBack = true;
+            }
+            catch (error) {
+                const message = error instanceof Error ? `자동 롤백 실패: ${error.message}` : '자동 롤백 중 알 수 없는 오류가 발생했습니다';
+                errors.push({
+                    memoryId: '*',
+                    provider: plan.targetProvider,
+                    message
+                });
+            }
+        }
+        const result = {
+            success,
+            processed: progress.processed,
+            succeeded: progress.succeeded,
+            failed: progress.failed,
+            startTime: progress.startedAt,
+            endTime,
+            nextResumeFromId: progress.lastMemoryId,
+            errors: errors.length > 0 ? errors : undefined,
+            rollbackEntries,
+            rolledBack
+        };
+        if (!plan.dryRun) {
+            migrationHistoryService.recordHistory(db, plan, result);
+        }
+        return result;
+    }
+    safeParseEmbedding(raw) {
+        try {
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed)) {
+                throw new Error('임베딩 데이터가 배열 형식이 아닙니다');
+            }
+            return parsed.map(value => (Number.isFinite(value) ? value : 0));
+        }
+        catch (error) {
+            throw new Error(error instanceof Error ? `임베딩 벡터 파싱 실패: ${error.message}` : '임베딩 벡터 파싱 실패');
+        }
+    }
+    rollback(db, entries) {
+        if (!entries.length) {
+            return;
+        }
+        const deleteStatement = db.prepare(`DELETE FROM memory_embedding WHERE memory_id = ? AND embedding_provider = ? AND projection_type = ?`);
+        const restoreStatement = db.prepare(`
+      INSERT INTO memory_embedding (
+        memory_id,
+        embedding_provider,
+        projection_type,
+        embedding,
+        dim,
+        model,
+        dimensions,
+        precision,
+        normalized,
+        version,
+        created_by,
+        created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(memory_id, embedding_provider, projection_type) DO UPDATE SET
+        embedding = excluded.embedding,
+        dim = excluded.dim,
+        model = excluded.model,
+        dimensions = excluded.dimensions,
+        precision = excluded.precision,
+        normalized = excluded.normalized,
+        version = excluded.version,
+        created_by = excluded.created_by,
+        created_at = excluded.created_at
+    `);
+        for (const entry of [...entries].reverse()) {
+            if (entry.operation === 'delete') {
+                deleteStatement.run(entry.memoryId, entry.provider, entry.projectionType);
+            }
+            else {
+                if (!entry.embedding) {
+                    throw new Error(`Rollback 데이터가 누락되었습니다: ${entry.memoryId}`);
+                }
+                restoreStatement.run(entry.memoryId, entry.provider, entry.projectionType, entry.embedding, entry.dim ?? entry.dimensions ?? 0, entry.model ?? null, entry.dimensions ?? entry.dim ?? 0, entry.precision ?? 32, entry.normalized ?? 0, entry.version ?? 1, entry.createdBy ?? DEFAULT_CREATED_BY, entry.createdAt ?? new Date().toISOString());
+            }
+        }
+    }
+    listHistory(db, limit = 20) {
+        return migrationHistoryService.listHistory(db, { limit });
+    }
+}
+export const embeddingMigrationService = new EmbeddingMigrationService();
+//# sourceMappingURL=embedding-migration-service.js.map

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

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

package/dist/services/embedding-provider-factory.d.ts

@@ -8,6 +8,7 @@
  * - 개방-폐쇄: 새로운 제공자 추가 용이
  */
 import type { EmbeddingServiceInterface, EmbeddingProvider, ProviderInfo } from '../types/embedding.types.js';
+import type { ProviderFallbackDecision } from '../types/embedding-provider-monitoring.types.js';
 /**
  * 임베딩 제공자 팩토리
  * 순환 의존성을 방지하기 위해 팩토리 패턴 사용
@@ -15,6 +16,7 @@ import type { EmbeddingServiceInterface, EmbeddingProvider, ProviderInfo } from
 export declare class EmbeddingProviderFactory {
     private static instance;
     private providers;
+    private readonly availabilityService;
     private constructor();
     /**
      * 싱글톤 인스턴스 반환
@@ -40,11 +42,10 @@ export declare class EmbeddingProviderFactory {
      * TDD: 사용 가능한 제공자 중 우선순위가 높은 것 선택
      */
     selectProvider(preferredProvider?: EmbeddingProvider): EmbeddingServiceInterface | null;
-    /**
-     * OpenAI 사용 가능 여부 확인
-     * 클린코드: 단일 책임 원칙 - OpenAI 상태 확인만 담당
-     */
-    private isOpenAIAvailable;
+    selectProviderWithHealthCheck(preferredProvider?: EmbeddingProvider): Promise<{
+        service: EmbeddingServiceInterface | null;
+        decision: ProviderFallbackDecision;
+    }>;
     /**
      * 제공자 등록 (확장성)
      * 클린코드: 개방-폐쇄 원칙 - 확장에는 열려있음
@@ -54,9 +55,15 @@ export declare class EmbeddingProviderFactory {
      * 제공자 제거
      */
     unregisterProvider(provider: EmbeddingProvider): boolean;
+    private resolveAvailability;
     /**
      * 모든 제공자 초기화
      */
     reset(): void;
+    private normalizeProviderName;
+    private getPriorityProviders;
+    handleProviderFailure(provider: EmbeddingProvider): void;
+    getProviderName(service: EmbeddingServiceInterface | null): EmbeddingProvider | null;
+    private createService;
 }
 //# sourceMappingURL=embedding-provider-factory.d.ts.map

package/dist/services/embedding-provider-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding-provider-factory.d.ts","sourceRoot":"","sources":["../../src/services/embedding-provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAM9G;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,SAAS,CAAgE;IAEjF,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,wBAAwB;IAO9C;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,IAAI;IAI1E;;;OAGG;IACH,qBAAqB,IAAI,YAAY,EAAE;IA6CvC;;;OAGG;IACH,cAAc,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,IAAI;IA+BvF;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI;IAIvF;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IAIxD;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"embedding-provider-factory.d.ts","sourceRoot":"","sources":["../../src/services/embedding-provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC9G,OAAO,KAAK,EAAE,wBAAwB,EAAwB,MAAM,iDAAiD,CAAC;AAQtH;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,SAAS,CAAgE;IACjF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA2B;IAE/D,OAAO;IAQP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,wBAAwB;IAO9C;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,IAAI;IAQ1E;;;OAGG;IACH,qBAAqB,IAAI,YAAY,EAAE;IAiDvC;;;OAGG;IACH,cAAc,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,IAAI;IAoCjF,6BAA6B,CACjC,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC;QAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,wBAAwB,CAAA;KAAE,CAAC;IAM7F;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI;IAQvF;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IAKxD,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,qBAAqB;IAqB7B,OAAO,CAAC,oBAAoB;IAI5B,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IASxD,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,iBAAiB,GAAG,IAAI;IAYpF,OAAO,CAAC,aAAa;CActB"}

package/dist/services/embedding-provider-factory.js

@@ -11,6 +11,8 @@ import { mementoConfig } from '../config/index.js';
 import { MiniLMEmbeddingService } from './minilm-embedding-service.js';
 import { LightweightEmbeddingService } from './lightweight-embedding-service.js';
 import { GeminiEmbeddingService } from './gemini-embedding-service.js';
+import { OpenAIEmbeddingService } from './openai-embedding-service.js';
+import { ModelAvailabilityService } from './model-availability-service.js';
 /**
  * 임베딩 제공자 팩토리
  * 순환 의존성을 방지하기 위해 팩토리 패턴 사용
@@ -18,8 +20,10 @@ import { GeminiEmbeddingService } from './gemini-embedding-service.js';
 export class EmbeddingProviderFactory {
     static instance;
     providers = new Map();
+    availabilityService;
     constructor() {
         this.initializeProviders();
+        this.availabilityService = new ModelAvailabilityService(provider => this.providers.get(provider) ?? null, () => this.getPriorityProviders());
     }
     /**
      * 싱글톤 인스턴스 반환
@@ -35,17 +39,21 @@ export class EmbeddingProviderFactory {
      * 클린코드: 단일 책임 원칙 - 초기화만 담당
      */
     initializeProviders() {
-        this.providers.set('minilm', new MiniLMEmbeddingService());
-        this.providers.set('tfidf', new LightweightEmbeddingService());
-        this.providers.set('gemini', new GeminiEmbeddingService());
-        // OpenAI는 설정에 따라 동적 생성
+        this.providers.set('minilm', this.createService('minilm'));
+        this.providers.set('tfidf', this.createService('tfidf'));
+        this.providers.set('gemini', this.createService('gemini'));
+        this.providers.set('openai', this.createService('openai'));
     }
     /**
      * 제공자 반환
      * 클린코드: 단일 책임 원칙 - 제공자 반환만 담당
      */
     getProvider(provider) {
-        return this.providers.get(provider) || null;
+        const normalized = this.normalizeProviderName(provider);
+        if (!normalized) {
+            return null;
+        }
+        return this.providers.get(normalized) || null;
     }
     /**
      * 사용 가능한 제공자 목록 반환
@@ -55,10 +63,11 @@ export class EmbeddingProviderFactory {
         const providerInfos = [];
         // MiniLM
         const minilm = this.providers.get('minilm');
+        const minilmStatus = this.availabilityService.getLastStatus('minilm');
         providerInfos.push({
             name: 'minilm',
-            available: minilm?.isAvailable() || false,
-            priority: 1,
+            available: this.resolveAvailability('minilm', minilm, minilmStatus),
+            priority: 3,
             cost: 'free',
             performance: 'high'
         });
@@ -66,25 +75,28 @@ export class EmbeddingProviderFactory {
         const tfidf = this.providers.get('tfidf');
         providerInfos.push({
             name: 'tfidf',
-            available: tfidf?.isAvailable() || false,
+            available: this.resolveAvailability('tfidf', tfidf, this.availabilityService.getLastStatus('tfidf')),
             priority: 4,
             cost: 'free',
             performance: 'low'
         });
         // Gemini
         const gemini = this.providers.get('gemini');
+        const geminiStatus = this.availabilityService.getLastStatus('gemini');
         providerInfos.push({
             name: 'gemini',
-            available: gemini?.isAvailable() || false,
+            available: this.resolveAvailability('gemini', gemini, geminiStatus),
             priority: 2,
             cost: 'paid',
             performance: 'high'
         });
-        // OpenAI (동적 생성)
+        // OpenAI
+        const openai = this.providers.get('openai');
+        const openaiStatus = this.availabilityService.getLastStatus('openai');
         providerInfos.push({
             name: 'openai',
-            available: this.isOpenAIAvailable(),
-            priority: 3,
+            available: this.resolveAvailability('openai', openai, openaiStatus),
+            priority: 1,
             cost: 'paid',
             performance: 'high'
         });
@@ -98,17 +110,22 @@ export class EmbeddingProviderFactory {
         const availableProviders = this.getAvailableProviders();
         // 1. 명시적으로 요청된 제공자 우선
         if (preferredProvider) {
-            const preferred = availableProviders.find(p => p.name === preferredProvider && p.available);
+            const normalizedPreferred = this.normalizeProviderName(preferredProvider);
+            const preferred = normalizedPreferred
+                ? availableProviders.find(p => p.name === normalizedPreferred && p.available)
+                : undefined;
             if (preferred) {
-                console.log(`🎯 요청된 제공자 사용: ${preferredProvider}`);
+                console.log(`🎯 요청된 제공자 사용: ${preferred.name}`);
                 return this.getProvider(preferred.name);
             }
         }
         // 2. 설정에서 기본 제공자 사용
-        const defaultProvider = mementoConfig.embeddingProvider;
-        const defaultAvailable = availableProviders.find(p => p.name === defaultProvider && p.available);
+        const defaultProvider = this.normalizeProviderName(mementoConfig.embeddingProvider);
+        const defaultAvailable = defaultProvider
+            ? availableProviders.find(p => p.name === defaultProvider && p.available)
+            : undefined;
         if (defaultAvailable) {
-            console.log(`⚙️ 설정된 기본 제공자 사용: ${defaultProvider}`);
+            console.log(`⚙️ 설정된 기본 제공자 사용: ${defaultAvailable.name}`);
             return this.getProvider(defaultAvailable.name);
         }
         // 3. 사용 가능한 첫 번째 제공자 반환
@@ -120,26 +137,34 @@ export class EmbeddingProviderFactory {
         console.log('❌ 사용 가능한 제공자가 없습니다');
         return null;
     }
-    /**
-     * OpenAI 사용 가능 여부 확인
-     * 클린코드: 단일 책임 원칙 - OpenAI 상태 확인만 담당
-     */
-    isOpenAIAvailable() {
-        // 환경 변수나 설정 확인
-        return process.env.OPENAI_API_KEY !== undefined;
+    async selectProviderWithHealthCheck(preferredProvider) {
+        const decision = await this.availabilityService.selectBestProvider(preferredProvider);
+        const service = this.getProvider(decision.selectedProvider);
+        return { service, decision };
     }
     /**
      * 제공자 등록 (확장성)
      * 클린코드: 개방-폐쇄 원칙 - 확장에는 열려있음
      */
     registerProvider(provider, service) {
-        this.providers.set(provider, service);
+        const normalized = this.normalizeProviderName(provider);
+        if (!normalized) {
+            return;
+        }
+        this.providers.set(normalized, service);
     }
     /**
      * 제공자 제거
      */
     unregisterProvider(provider) {
-        return this.providers.delete(provider);
+        const normalized = this.normalizeProviderName(provider);
+        return normalized ? this.providers.delete(normalized) : false;
+    }
+    resolveAvailability(provider, service, status) {
+        if (status) {
+            return status.state === 'available';
+        }
+        return service?.isAvailable() ?? false;
     }
     /**
      * 모든 제공자 초기화
@@ -148,5 +173,61 @@ export class EmbeddingProviderFactory {
         this.providers.clear();
         this.initializeProviders();
     }
+    normalizeProviderName(provider) {
+        if (!provider) {
+            return null;
+        }
+        const normalized = provider.toLowerCase();
+        switch (normalized) {
+            case 'tfidf':
+                return 'tfidf';
+            case 'minilm':
+                return 'minilm';
+            case 'openai':
+                return 'openai';
+            case 'gemini':
+                return 'gemini';
+            case 'lightweight':
+                return 'tfidf';
+            default:
+                return null;
+        }
+    }
+    getPriorityProviders() {
+        return Array.from(this.providers.keys());
+    }
+    handleProviderFailure(provider) {
+        const normalized = this.normalizeProviderName(provider);
+        if (!normalized) {
+            return;
+        }
+        console.warn(`⚠️ ${normalized} 제공자 재초기화 시도`);
+        this.providers.set(normalized, this.createService(normalized));
+    }
+    getProviderName(service) {
+        if (!service) {
+            return null;
+        }
+        for (const [name, instance] of this.providers.entries()) {
+            if (instance === service) {
+                return name;
+            }
+        }
+        return null;
+    }
+    createService(provider) {
+        switch (provider) {
+            case 'minilm':
+                return new MiniLMEmbeddingService();
+            case 'tfidf':
+                return new LightweightEmbeddingService();
+            case 'gemini':
+                return new GeminiEmbeddingService();
+            case 'openai':
+                return new OpenAIEmbeddingService();
+            default:
+                return new LightweightEmbeddingService();
+        }
+    }
 }
 //# sourceMappingURL=embedding-provider-factory.js.map