memento-mcp-server 1.16.3-a → 1.16.3-b

package/scripts/simple-update.js

@@ -1,123 +1,161 @@
 #!/usr/bin/env node
 
-import Database from 'better-sqlite3';
+/**
+ * 간단한 데이터 업데이트 스크립트
+ * 임베딩 메타데이터 업데이트
+ * 
+ * 리팩토링: 공통 모듈(initializeDatabase)을 사용하여 일관된 DB 초기화 보장
+ * 
+ * 사용법: 
+ *   - 개발 환경: npx tsx scripts/simple-update.js
+ *   - 프로덕션: npm run build && node dist/scripts/simple-update.js
+ */
+
+// TypeScript 소스를 직접 import (tsx로 실행 시)
+// 빌드된 파일을 사용하려면 '../dist/infrastructure/database/database/init.js'로 변경
+import { initializeDatabase, closeDatabase } from '../src/infrastructure/database/database/init.js';
 import { join } from 'path';
 import { existsSync, copyFileSync } from 'fs';
 
-const dbPath = join(process.cwd(), 'data', 'memory.db');
-
-console.log('🔧 간단한 데이터 업데이트 시작...');
-
-try {
-  // 1. 백업 생성
-  const backupPath = join(process.cwd(), 'data', `memory-backup-${Date.now()}.db`);
-  copyFileSync(dbPath, backupPath);
-  console.log(`✅ 백업 생성: ${backupPath}`);
-  
-  // 2. 데이터베이스 연결 (sqlite-vec 없이)
-  const db = new Database(dbPath);
+async function updateEmbeddings() {
+  console.log('🔧 간단한 데이터 업데이트 시작...');
   
-  // 3. 현재 상태 확인
-  console.log('📊 현재 상태 확인...');
-  const currentSchema = db.prepare("PRAGMA table_info(memory_embedding)").all();
-  console.log('현재 테이블 구조:');
-  console.table(currentSchema);
-  
-  // 4. 컬럼 추가 (이미 있는 경우 무시)
-  console.log('📝 컬럼 추가 중...');
+  let db = null;
   
   try {
-    db.exec('ALTER TABLE memory_embedding ADD COLUMN embedding_provider TEXT');
-    console.log('✅ embedding_provider 컬럼 추가');
-  } catch (error) {
-    if (error.message.includes('duplicate column name')) {
-      console.log('ℹ️ embedding_provider 컬럼이 이미 존재합니다');
-    } else {
-      console.warn('⚠️ embedding_provider 컬럼 추가 실패:', error.message);
+    // 공통 모듈을 사용하여 데이터베이스 초기화
+    // initializeDatabase는 DB 파일이 없으면 자동으로 생성하고 초기화함
+    db = await initializeDatabase();
+    
+    // 1. 백업 생성
+    const dbPath = process.env.DB_PATH || join(process.cwd(), 'data', 'memory.db');
+    const backupPath = join(process.cwd(), 'data', `memory-backup-${Date.now()}.db`);
+    
+    if (existsSync(dbPath)) {
+      copyFileSync(dbPath, backupPath);
+      console.log(`✅ 백업 생성: ${backupPath}`);
     }
-  }
-  
-  try {
-    db.exec('ALTER TABLE memory_embedding ADD COLUMN dimensions INTEGER');
-    console.log('✅ dimensions 컬럼 추가');
-  } catch (error) {
-    if (error.message.includes('duplicate column name')) {
-      console.log('ℹ️ dimensions 컬럼이 이미 존재합니다');
-    } else {
-      console.warn('⚠️ dimensions 컬럼 추가 실패:', error.message);
+    
+    // 2. 현재 상태 확인
+    console.log('📊 현재 상태 확인...');
+    const currentSchema = db.prepare("PRAGMA table_info(memory_embedding)").all();
+    console.log('현재 테이블 구조:');
+    console.table(currentSchema);
+    
+    // 3. 컬럼 추가 (이미 있는 경우 무시)
+    console.log('📝 컬럼 추가 중...');
+    
+    try {
+      db.exec('ALTER TABLE memory_embedding ADD COLUMN embedding_provider TEXT');
+      console.log('✅ embedding_provider 컬럼 추가');
+    } catch (error) {
+      if (error.message.includes('duplicate column name')) {
+        console.log('ℹ️ embedding_provider 컬럼이 이미 존재합니다');
+      } else {
+        console.warn('⚠️ embedding_provider 컬럼 추가 실패:', error.message);
+      }
     }
-  }
-  
-  try {
-    db.exec('ALTER TABLE memory_embedding ADD COLUMN created_by TEXT DEFAULT "migration"');
-    console.log('✅ created_by 컬럼 추가');
+    
+    try {
+      db.exec('ALTER TABLE memory_embedding ADD COLUMN dimensions INTEGER');
+      console.log('✅ dimensions 컬럼 추가');
+    } catch (error) {
+      if (error.message.includes('duplicate column name')) {
+        console.log('ℹ️ dimensions 컬럼이 이미 존재합니다');
+      } else {
+        console.warn('⚠️ dimensions 컬럼 추가 실패:', error.message);
+      }
+    }
+    
+    try {
+      db.exec('ALTER TABLE memory_embedding ADD COLUMN created_by TEXT DEFAULT "migration"');
+      console.log('✅ created_by 컬럼 추가');
+    } catch (error) {
+      if (error.message.includes('duplicate column name')) {
+        console.log('ℹ️ created_by 컬럼이 이미 존재합니다');
+      } else {
+        console.warn('⚠️ created_by 컬럼 추가 실패:', error.message);
+      }
+    }
+    
+    // 4. 데이터 업데이트
+    console.log('🔄 데이터 업데이트 중...');
+    
+    const updateResult = db.prepare(`
+      UPDATE memory_embedding 
+      SET 
+        embedding_provider = CASE 
+          WHEN model = 'lightweight-hybrid' THEN 'tfidf'
+          WHEN model IS NULL OR model = '' THEN 'tfidf'
+          ELSE 'unknown'
+        END,
+        dimensions = dim,
+        created_by = 'legacy'
+      WHERE embedding_provider IS NULL
+    `).run();
+    
+    console.log(`✅ ${updateResult.changes}개 레코드 업데이트 완료`);
+    
+    // 5. 인덱스 추가
+    console.log('📝 인덱스 추가 중...');
+    db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_provider ON memory_embedding(embedding_provider)');
+    db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_dimensions ON memory_embedding(dimensions)');
+    db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_created_by ON memory_embedding(created_by)');
+    console.log('✅ 인덱스 추가 완료');
+    
+    // 6. 검증
+    console.log('🔍 검증 중...');
+    const validation = db.prepare(`
+      SELECT 
+        COUNT(*) as total,
+        COUNT(CASE WHEN embedding_provider IS NOT NULL THEN 1 END) as with_provider,
+        COUNT(CASE WHEN dimensions IS NOT NULL THEN 1 END) as with_dimensions,
+        COUNT(CASE WHEN created_by IS NOT NULL THEN 1 END) as with_created_by
+      FROM memory_embedding
+    `).get();
+    
+    console.log('📊 검증 결과:');
+    console.table(validation);
+    
+    const finalAnalysis = db.prepare(`
+      SELECT 
+        embedding_provider,
+        dimensions,
+        COUNT(*) as count
+      FROM memory_embedding 
+      GROUP BY embedding_provider, dimensions
+      ORDER BY count DESC
+    `).all();
+    
+    console.log('\n📊 최종 데이터 분포:');
+    console.table(finalAnalysis);
+    
+    console.log('\n🎉 업데이트 완료!');
+    if (existsSync(backupPath)) {
+      console.log(`💾 백업 파일: ${backupPath}`);
+      console.log('🔄 롤백이 필요한 경우: cp ' + backupPath + ' ' + dbPath);
+    }
+    
   } catch (error) {
-    if (error.message.includes('duplicate column name')) {
-      console.log('ℹ️ created_by 컬럼이 이미 존재합니다');
-    } else {
-      console.warn('⚠️ created_by 컬럼 추가 실패:', error.message);
+    console.error('❌ 업데이트 실패:', error.message);
+    if (error.stack) {
+      console.error('   스택 트레이스:', error.stack);
+    }
+    process.exit(1);
+  } finally {
+    // 데이터베이스 연결 종료
+    if (db) {
+      closeDatabase(db);
     }
   }
-  
-  // 5. 데이터 업데이트
-  console.log('🔄 데이터 업데이트 중...');
-  
-  const updateResult = db.prepare(`
-    UPDATE memory_embedding 
-    SET 
-      embedding_provider = CASE 
-        WHEN model = 'lightweight-hybrid' THEN 'tfidf'
-        WHEN model IS NULL OR model = '' THEN 'tfidf'
-        ELSE 'unknown'
-      END,
-      dimensions = dim,
-      created_by = 'legacy'
-    WHERE embedding_provider IS NULL
-  `).run();
-  
-  console.log(`✅ ${updateResult.changes}개 레코드 업데이트 완료`);
-  
-  // 6. 인덱스 추가
-  console.log('📝 인덱스 추가 중...');
-  db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_provider ON memory_embedding(embedding_provider)');
-  db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_dimensions ON memory_embedding(dimensions)');
-  db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_created_by ON memory_embedding(created_by)');
-  console.log('✅ 인덱스 추가 완료');
-  
-  // 7. 검증
-  console.log('🔍 검증 중...');
-  const validation = db.prepare(`
-    SELECT 
-      COUNT(*) as total,
-      COUNT(CASE WHEN embedding_provider IS NOT NULL THEN 1 END) as with_provider,
-      COUNT(CASE WHEN dimensions IS NOT NULL THEN 1 END) as with_dimensions,
-      COUNT(CASE WHEN created_by IS NOT NULL THEN 1 END) as with_created_by
-    FROM memory_embedding
-  `).get();
-  
-  console.log('📊 검증 결과:');
-  console.table(validation);
-  
-  const finalAnalysis = db.prepare(`
-    SELECT 
-      embedding_provider,
-      dimensions,
-      COUNT(*) as count
-    FROM memory_embedding 
-    GROUP BY embedding_provider, dimensions
-    ORDER BY count DESC
-  `).all();
-  
-  console.log('\n📊 최종 데이터 분포:');
-  console.table(finalAnalysis);
-  
-  db.close();
-  
-  console.log('\n🎉 업데이트 완료!');
-  console.log(`💾 백업 파일: ${backupPath}`);
-  console.log('🔄 롤백이 필요한 경우: cp ' + backupPath + ' ' + dbPath);
-  
-} catch (error) {
-  console.error('❌ 업데이트 실패:', error.message);
-  process.exit(1);
 }
+
+// 스크립트 실행
+if (import.meta.url === `file://${process.argv[1]}` || import.meta.url.endsWith(process.argv[1])) {
+  updateEmbeddings().catch((error) => {
+    console.error('❌ 스크립트 실행 중 오류 발생:', error);
+    process.exit(1);
+  });
+}
+
+export { updateEmbeddings };

package/dist/domains/search/algorithms/vector-search-engine-refactored.d.ts

@@ -1,56 +0,0 @@
-/**
- * 유지보수성과 테스트 가능성을 향상시키기 위해 클린코드 원칙을 적용합니다.
- * 기존 VectorSearchEngine의 대체품으로 점진적 마이그레이션을 지원합니다.
- */
-import Database from 'better-sqlite3';
-import type { VectorSearchResult, VectorIndexStatus, PerformanceTestResult } from '../../../shared/types/vector-search.types';
-/**
- * 리팩토링된 벡터 검색 엔진으로 기존 코드와의 호환성을 유지하면서 개선된 구조를 제공합니다.
- * 기존 VectorSearchEngine과 동일한 인터페이스를 제공하여 기존 코드 수정 없이 사용 가능하도록 합니다.
- */
-export declare class VectorSearchEngineRefactored {
-    private container;
-    constructor();
-    /**
-     * 벡터 검색 기능이 없으면 검색이 실패할 수 있으므로, 데이터베이스 연결을 설정하고 벡터 검색 기능의 사용 가능 여부를 확인합니다.
-     */
-    initialize(db: Database.Database): void;
-    /**
-     * 쿼리 벡터와 유사한 메모리를 검색하여 의미적으로 관련된 결과를 제공합니다.
-     * 리팩토링된 서비스를 통해 개선된 검색 기능을 제공합니다.
-     */
-    search(queryVector: number[], options?: any, provider?: string): Promise<VectorSearchResult[]>;
-    /**
-     * 하이브리드 검색 실행
-     */
-    hybridSearch(queryVector: number[], textQuery: string, options?: any, provider?: string): Promise<VectorSearchResult[]>;
-    /**
-     * 벡터 인덱스 상태 확인
-     */
-    getIndexStatus(): VectorIndexStatus;
-    /**
-     * 벡터 인덱스 재구성
-     */
-    rebuildIndex(): Promise<boolean>;
-    /**
-     * 벡터 검색 성능 테스트
-     */
-    performanceTest(queryVector: number[], iterations?: number): Promise<PerformanceTestResult>;
-    /**
-     * 벡터 차원 확인
-     */
-    getDimensions(): number;
-    /**
-     * VEC 사용 가능 여부 확인
-     */
-    isAvailable(): boolean;
-    /**
-     * 데이터베이스 연결 상태 확인
-     */
-    isConnected(): boolean;
-}
-export declare function getVectorSearchEngine(): VectorSearchEngineRefactored;
-export declare function createVectorSearchEngine(): VectorSearchEngineRefactored;
-export declare function resetVectorSearchEngine(): void;
-export type { VectorSearchResult, VectorSearchOptions, VectorIndexStatus, PerformanceTestResult } from '../../../shared/types/vector-search.types';
-//# sourceMappingURL=vector-search-engine-refactored.d.ts.map

package/dist/domains/search/algorithms/vector-search-engine-refactored.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vector-search-engine-refactored.d.ts","sourceRoot":"","sources":["../../../../src/domains/search/algorithms/vector-search-engine-refactored.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,KAAK,EAEV,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,2CAA2C,CAAC;AAEnD;;;GAGG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,SAAS,CAAwB;;IAMzC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAIvC;;;OAGG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,GAAQ,EACjB,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAWhC;;OAEG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,GAAQ,EACjB,QAAQ,GAAE,MAAgB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAYhC;;OAEG;IACH,cAAc,IAAI,iBAAiB;IAKnC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAKtC;;OAEG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,qBAAqB,CAAC;IAKjC;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,WAAW,IAAI,OAAO;IAKtB;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB;AAGD,wBAAgB,qBAAqB,IAAI,4BAA4B,CAEpE;AAED,wBAAgB,wBAAwB,IAAI,4BAA4B,CAEvE;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAGD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,2CAA2C,CAAC"}

package/dist/domains/search/algorithms/vector-search-engine-refactored.js

@@ -1,101 +0,0 @@
-/**
- * 유지보수성과 테스트 가능성을 향상시키기 위해 클린코드 원칙을 적용합니다.
- * 기존 VectorSearchEngine의 대체품으로 점진적 마이그레이션을 지원합니다.
- */
-import Database from 'better-sqlite3';
-import { VectorSearchContainer } from '../services/vector-search/vector-search-container';
-import { VectorSearchFactory } from '../factories/vector-search.factory';
-/**
- * 리팩토링된 벡터 검색 엔진으로 기존 코드와의 호환성을 유지하면서 개선된 구조를 제공합니다.
- * 기존 VectorSearchEngine과 동일한 인터페이스를 제공하여 기존 코드 수정 없이 사용 가능하도록 합니다.
- */
-export class VectorSearchEngineRefactored {
-    container;
-    constructor() {
-        this.container = VectorSearchContainer.getInstance();
-    }
-    /**
-     * 벡터 검색 기능이 없으면 검색이 실패할 수 있으므로, 데이터베이스 연결을 설정하고 벡터 검색 기능의 사용 가능 여부를 확인합니다.
-     */
-    initialize(db) {
-        this.container.setDatabase(db);
-    }
-    /**
-     * 쿼리 벡터와 유사한 메모리를 검색하여 의미적으로 관련된 결과를 제공합니다.
-     * 리팩토링된 서비스를 통해 개선된 검색 기능을 제공합니다.
-     */
-    async search(queryVector, options = {}, provider = 'tfidf') {
-        const query = {
-            queryVector,
-            options,
-            provider
-        };
-        const facade = this.container.getFacade();
-        return await facade.search(query);
-    }
-    /**
-     * 하이브리드 검색 실행
-     */
-    async hybridSearch(queryVector, textQuery, options = {}, provider = 'tfidf') {
-        const query = {
-            queryVector,
-            textQuery,
-            options,
-            provider
-        };
-        const facade = this.container.getFacade();
-        return await facade.hybridSearch(query);
-    }
-    /**
-     * 벡터 인덱스 상태 확인
-     */
-    getIndexStatus() {
-        const facade = this.container.getFacade();
-        return facade.getIndexStatus();
-    }
-    /**
-     * 벡터 인덱스 재구성
-     */
-    async rebuildIndex() {
-        const facade = this.container.getFacade();
-        return await facade.rebuildIndex();
-    }
-    /**
-     * 벡터 검색 성능 테스트
-     */
-    async performanceTest(queryVector, iterations = 10) {
-        const facade = this.container.getFacade();
-        return await facade.runPerformanceTest(queryVector, iterations);
-    }
-    /**
-     * 벡터 차원 확인
-     */
-    getDimensions() {
-        return 384; // 기본 차원
-    }
-    /**
-     * VEC 사용 가능 여부 확인
-     */
-    isAvailable() {
-        const facade = this.container.getFacade();
-        return facade.isAvailable();
-    }
-    /**
-     * 데이터베이스 연결 상태 확인
-     */
-    isConnected() {
-        return this.container.isConnected();
-    }
-}
-// 기존 인터페이스와 호환성을 위한 팩토리 함수들
-export function getVectorSearchEngine() {
-    return new VectorSearchEngineRefactored();
-}
-export function createVectorSearchEngine() {
-    return new VectorSearchEngineRefactored();
-}
-export function resetVectorSearchEngine() {
-    const container = VectorSearchContainer.getInstance();
-    container.reset();
-}
-//# sourceMappingURL=vector-search-engine-refactored.js.map

package/dist/domains/search/algorithms/vector-search-engine-refactored.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"vector-search-engine-refactored.js","sourceRoot":"","sources":["../../../../src/domains/search/algorithms/vector-search-engine-refactored.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAQzE;;;GAGG;AACH,MAAM,OAAO,4BAA4B;IAC/B,SAAS,CAAwB;IAEzC;QACE,IAAI,CAAC,SAAS,GAAG,qBAAqB,CAAC,WAAW,EAAE,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,EAAqB;QAC9B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,WAAqB,EACrB,UAAe,EAAE,EACjB,WAAmB,OAAO;QAE1B,MAAM,KAAK,GAAsB;YAC/B,WAAW;YACX,OAAO;YACP,QAAQ;SACT,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAChB,WAAqB,EACrB,SAAiB,EACjB,UAAe,EAAE,EACjB,WAAmB,OAAO;QAE1B,MAAM,KAAK,GAAsB;YAC/B,WAAW;YACX,SAAS;YACT,OAAO;YACP,QAAQ;SACT,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,cAAc,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CACnB,WAAqB,EACrB,aAAqB,EAAE;QAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,GAAG,CAAC,CAAC,QAAQ;IACtB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,4BAA4B,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,4BAA4B,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,SAAS,GAAG,qBAAqB,CAAC,WAAW,EAAE,CAAC;IACtD,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}