memento-mcp-server 1.8.0 → 1.9.0

package/dist/database/migration/dependency-validator.js

@@ -0,0 +1,260 @@
+/**
+ * 데이터베이스 의존성 검증 유틸리티
+ * 마이그레이션 후 기존 의존성(외래키, 트리거 등)이 정상적으로 작동하는지 검증
+ */
+/**
+ * 데이터베이스 의존성 검증기
+ */
+export class DependencyValidator {
+    /**
+     * 모든 의존성 검증 수행
+     */
+    static async validateAll(db) {
+        const results = [];
+        // 1. memory_embedding 외래키 검증
+        results.push(await this.validateMemoryEmbeddingForeignKey(db));
+        // 2. FTS5 트리거 검증
+        results.push(await this.validateFTS5Triggers(db));
+        // 3. VEC 트리거 검증
+        results.push(await this.validateVECTriggers(db));
+        const failureCount = results.filter(r => !r.success).length;
+        return {
+            success: failureCount === 0,
+            results,
+            failureCount
+        };
+    }
+    /**
+     * memory_embedding 테이블의 외래키 검증
+     */
+    static async validateMemoryEmbeddingForeignKey(db) {
+        try {
+            // memory_embedding 테이블 존재 확인
+            const tableExists = db.prepare(`
+        SELECT name FROM sqlite_master 
+        WHERE type='table' AND name='memory_embedding'
+      `).get();
+            if (!tableExists) {
+                return {
+                    name: 'memory_embedding_foreign_key',
+                    success: false,
+                    error: 'memory_embedding table does not exist'
+                };
+            }
+            // 외래키 제약 조건 확인
+            const fkInfo = db.prepare(`
+        SELECT * FROM pragma_foreign_key_list('memory_embedding')
+        WHERE "table" = 'memory_item'
+      `).all();
+            if (fkInfo.length === 0) {
+                return {
+                    name: 'memory_embedding_foreign_key',
+                    success: false,
+                    error: 'Foreign key constraint from memory_embedding.memory_id to memory_item.id is missing'
+                };
+            }
+            const fk = fkInfo[0];
+            if (!fk) {
+                return {
+                    name: 'memory_embedding_foreign_key',
+                    success: false,
+                    error: 'Foreign key constraint information is missing'
+                };
+            }
+            if (fk.from !== 'memory_id' || fk.to !== 'id') {
+                return {
+                    name: 'memory_embedding_foreign_key',
+                    success: false,
+                    error: `Foreign key constraint mismatch: expected memory_id -> id, got ${fk.from} -> ${fk.to}`
+                };
+            }
+            if (fk.on_delete !== 'CASCADE') {
+                return {
+                    name: 'memory_embedding_foreign_key',
+                    success: false,
+                    error: `Foreign key on_delete action should be CASCADE, got ${fk.on_delete}`
+                };
+            }
+            return {
+                name: 'memory_embedding_foreign_key',
+                success: true,
+                details: {
+                    from: fk.from,
+                    to: fk.to,
+                    on_delete: fk.on_delete,
+                    on_update: fk.on_update
+                }
+            };
+        }
+        catch (error) {
+            return {
+                name: 'memory_embedding_foreign_key',
+                success: false,
+                error: error.message || 'Unknown error during foreign key validation'
+            };
+        }
+    }
+    /**
+     * FTS5 트리거 검증
+     */
+    static async validateFTS5Triggers(db) {
+        try {
+            const requiredTriggers = [
+                'memory_item_fts_insert',
+                'memory_item_fts_update',
+                'memory_item_fts_delete'
+            ];
+            const missingTriggers = [];
+            const foundTriggers = [];
+            for (const triggerName of requiredTriggers) {
+                const trigger = db.prepare(`
+          SELECT name, sql FROM sqlite_master 
+          WHERE type='trigger' AND name=?
+        `).get(triggerName);
+                if (!trigger) {
+                    missingTriggers.push(triggerName);
+                }
+                else {
+                    foundTriggers.push(triggerName);
+                }
+            }
+            if (missingTriggers.length > 0) {
+                return {
+                    name: 'fts5_triggers',
+                    success: false,
+                    error: `Missing FTS5 triggers: ${missingTriggers.join(', ')}`,
+                    details: {
+                        found: foundTriggers,
+                        missing: missingTriggers
+                    }
+                };
+            }
+            // FTS5 가상 테이블 존재 확인
+            const ftsTable = db.prepare(`
+        SELECT name FROM sqlite_master 
+        WHERE type='table' AND name='memory_item_fts'
+      `).get();
+            if (!ftsTable) {
+                return {
+                    name: 'fts5_triggers',
+                    success: false,
+                    error: 'FTS5 virtual table memory_item_fts does not exist'
+                };
+            }
+            return {
+                name: 'fts5_triggers',
+                success: true,
+                details: {
+                    triggers: foundTriggers,
+                    fts_table_exists: true
+                }
+            };
+        }
+        catch (error) {
+            return {
+                name: 'fts5_triggers',
+                success: false,
+                error: error.message || 'Unknown error during FTS5 trigger validation'
+            };
+        }
+    }
+    /**
+     * VEC 트리거 검증
+     */
+    static async validateVECTriggers(db) {
+        try {
+            const requiredTriggers = [
+                'memory_embedding_vec_insert',
+                'memory_embedding_vec_update',
+                'memory_embedding_vec_delete'
+            ];
+            const missingTriggers = [];
+            const foundTriggers = [];
+            for (const triggerName of requiredTriggers) {
+                const trigger = db.prepare(`
+          SELECT name, sql FROM sqlite_master 
+          WHERE type='trigger' AND name=?
+        `).get(triggerName);
+                if (!trigger) {
+                    missingTriggers.push(triggerName);
+                }
+                else {
+                    foundTriggers.push(triggerName);
+                }
+            }
+            if (missingTriggers.length > 0) {
+                return {
+                    name: 'vec_triggers',
+                    success: false,
+                    error: `Missing VEC triggers: ${missingTriggers.join(', ')}`,
+                    details: {
+                        found: foundTriggers,
+                        missing: missingTriggers
+                    }
+                };
+            }
+            // VEC 가상 테이블 존재 확인 (선택적, sqlite-vec 확장이 설치되어 있을 때만)
+            const vecTables = [
+                'memory_item_vec',
+                'memory_item_vec_tfidf',
+                'memory_item_vec_minilm',
+                'memory_item_vec_openai',
+                'memory_item_vec_gemini'
+            ];
+            const existingVecTables = [];
+            const missingVecTables = [];
+            for (const tableName of vecTables) {
+                try {
+                    const table = db.prepare(`
+            SELECT name FROM sqlite_master 
+            WHERE type='table' AND name=?
+          `).get(tableName);
+                    if (table) {
+                        existingVecTables.push(tableName);
+                    }
+                    else {
+                        missingVecTables.push(tableName);
+                    }
+                }
+                catch {
+                    // sqlite-vec 확장이 없을 수 있으므로 에러는 무시
+                    missingVecTables.push(tableName);
+                }
+            }
+            // VEC 테이블이 하나도 없으면 경고 (sqlite-vec 확장이 설치되지 않았을 수 있음)
+            if (existingVecTables.length === 0) {
+                return {
+                    name: 'vec_triggers',
+                    success: true, // 트리거는 존재하므로 성공으로 처리
+                    details: {
+                        triggers: foundTriggers,
+                        vec_tables: {
+                            existing: existingVecTables,
+                            missing: missingVecTables,
+                            note: 'sqlite-vec extension may not be installed'
+                        }
+                    }
+                };
+            }
+            return {
+                name: 'vec_triggers',
+                success: true,
+                details: {
+                    triggers: foundTriggers,
+                    vec_tables: {
+                        existing: existingVecTables,
+                        missing: missingVecTables
+                    }
+                }
+            };
+        }
+        catch (error) {
+            return {
+                name: 'vec_triggers',
+                success: false,
+                error: error.message || 'Unknown error during VEC trigger validation'
+            };
+        }
+    }
+}
+//# sourceMappingURL=dependency-validator.js.map

package/dist/database/migration/dependency-validator.js.map

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

package/dist/database/migration/migration-detector.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 마이그레이션 자동 감지 시스템
+ *
+ * migrations/ 디렉토리에서 마이그레이션 스크립트를 자동으로 감지하고,
+ * 현재 스키마 버전과 비교하여 실행해야 할 마이그레이션을 찾습니다.
+ */
+import type Database from 'better-sqlite3';
+import type { Migration } from './types.js';
+/**
+ * 마이그레이션 감지 결과
+ */
+export interface DetectedMigration {
+    /**
+     * 마이그레이션 인스턴스
+     */
+    migration: Migration;
+    /**
+     * 마이그레이션 파일 경로
+     */
+    filePath: string;
+    /**
+     * 마이그레이션 버전 번호 (숫자)
+     */
+    versionNumber: number;
+}
+/**
+ * 마이그레이션 감지 결과
+ */
+export interface MigrationDetectionResult {
+    /**
+     * 실행해야 할 마이그레이션 목록 (버전 순서대로 정렬됨)
+     */
+    pendingMigrations: DetectedMigration[];
+    /**
+     * 이미 실행된 마이그레이션 목록
+     */
+    appliedMigrations: DetectedMigration[];
+    /**
+     * 현재 스키마 버전
+     */
+    currentVersion: string | null;
+}
+/**
+ * 마이그레이션 자동 감지기
+ */
+export declare class MigrationDetector {
+    private migrationsDir;
+    constructor(migrationsDir?: string);
+    /**
+     * 모든 마이그레이션 파일 감지
+     */
+    detectAllMigrations(): Promise<DetectedMigration[]>;
+    /**
+     * 실행해야 할 마이그레이션 감지
+     */
+    detectPendingMigrations(db: Database.Database): Promise<MigrationDetectionResult>;
+    /**
+     * 버전 문자열을 숫자로 변환
+     * 예: "002" -> 2, "001" -> 1
+     */
+    private parseVersionNumber;
+    /**
+     * 특정 버전의 마이그레이션 찾기
+     */
+    findMigrationByVersion(version: string | undefined): Promise<DetectedMigration | null>;
+}
+//# sourceMappingURL=migration-detector.d.ts.map

package/dist/database/migration/migration-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-detector.d.ts","sourceRoot":"","sources":["../../../src/database/migration/migration-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;IAEvC;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;IAEvC;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAS;gBAElB,aAAa,CAAC,EAAE,MAAM;IAIlC;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAmEzD;;OAEG;IACG,uBAAuB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA2BvF;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACG,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAO7F"}

package/dist/database/migration/migration-detector.js

@@ -0,0 +1,129 @@
+/**
+ * 마이그레이션 자동 감지 시스템
+ *
+ * migrations/ 디렉토리에서 마이그레이션 스크립트를 자동으로 감지하고,
+ * 현재 스키마 버전과 비교하여 실행해야 할 마이그레이션을 찾습니다.
+ */
+import { readdir } from 'fs/promises';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { SchemaVersionManager } from './schema-version-manager.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * 마이그레이션 자동 감지기
+ */
+export class MigrationDetector {
+    migrationsDir;
+    constructor(migrationsDir) {
+        this.migrationsDir = migrationsDir || join(__dirname, 'migrations');
+    }
+    /**
+     * 모든 마이그레이션 파일 감지
+     */
+    async detectAllMigrations() {
+        const files = await readdir(this.migrationsDir);
+        const migrationFiles = files.filter(file => file.endsWith('.ts') &&
+            !file.endsWith('.spec.ts') &&
+            /^\d{3}-/.test(file));
+        const migrations = [];
+        for (const file of migrationFiles) {
+            try {
+                const filePath = join(this.migrationsDir, file);
+                const module = await import(`file://${filePath}`);
+                // default export 또는 named export 찾기
+                let MigrationClass = module.default;
+                // named export에서 Migration 클래스 찾기
+                if (!MigrationClass || typeof MigrationClass !== 'function') {
+                    const exportedKeys = Object.keys(module);
+                    for (const key of exportedKeys) {
+                        const exported = module[key];
+                        // 클래스이고 version, name, up 메서드를 가진 경우
+                        if (typeof exported === 'function' && exported.prototype &&
+                            (exported.prototype.version || exported.prototype.name)) {
+                            MigrationClass = exported;
+                            break;
+                        }
+                    }
+                }
+                if (!MigrationClass || typeof MigrationClass !== 'function') {
+                    console.warn(`⚠️  마이그레이션 파일 ${file}에서 유효한 마이그레이션 클래스를 찾을 수 없습니다.`);
+                    continue;
+                }
+                // 클래스 인스턴스 생성
+                const migration = new MigrationClass();
+                if (!migration || !migration.version || !migration.up) {
+                    console.warn(`⚠️  마이그레이션 파일 ${file}에서 유효한 마이그레이션 인스턴스를 생성할 수 없습니다.`);
+                    continue;
+                }
+                const versionNumber = this.parseVersionNumber(migration.version);
+                if (versionNumber === null) {
+                    console.warn(`⚠️  마이그레이션 ${file}의 버전 형식이 올바르지 않습니다: ${migration.version}`);
+                    continue;
+                }
+                migrations.push({
+                    migration,
+                    filePath,
+                    versionNumber
+                });
+            }
+            catch (error) {
+                console.error(`❌ 마이그레이션 파일 ${file} 로드 실패:`, error);
+            }
+        }
+        // 버전 번호로 정렬
+        migrations.sort((a, b) => a.versionNumber - b.versionNumber);
+        return migrations;
+    }
+    /**
+     * 실행해야 할 마이그레이션 감지
+     */
+    async detectPendingMigrations(db) {
+        const allMigrations = await this.detectAllMigrations();
+        const versionManager = new SchemaVersionManager(db);
+        const currentVersion = await versionManager.getCurrentVersion();
+        const appliedVersions = currentVersion !== null
+            ? await versionManager.getAppliedVersions()
+            : [];
+        const pendingMigrations = [];
+        const appliedMigrations = [];
+        for (const detected of allMigrations) {
+            if (appliedVersions.includes(detected.migration.version)) {
+                appliedMigrations.push(detected);
+            }
+            else {
+                pendingMigrations.push(detected);
+            }
+        }
+        return {
+            pendingMigrations,
+            appliedMigrations,
+            currentVersion
+        };
+    }
+    /**
+     * 버전 문자열을 숫자로 변환
+     * 예: "002" -> 2, "001" -> 1
+     */
+    parseVersionNumber(version) {
+        if (!version) {
+            return null;
+        }
+        const match = version.match(/^(\d+)/);
+        if (!match || !match[1]) {
+            return null;
+        }
+        return parseInt(match[1], 10);
+    }
+    /**
+     * 특정 버전의 마이그레이션 찾기
+     */
+    async findMigrationByVersion(version) {
+        if (!version) {
+            return null;
+        }
+        const allMigrations = await this.detectAllMigrations();
+        return allMigrations.find(m => m.migration.version === version) || null;
+    }
+}
+//# sourceMappingURL=migration-detector.js.map

package/dist/database/migration/migration-detector.js.map

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

package/dist/database/migration/migration-logger.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 마이그레이션 로깅 시스템
+ *
+ * 마이그레이션 실행 과정을 로그 파일에 기록합니다.
+ */
+import type { MigrationResult } from './types.js';
+/**
+ * 로그 레벨
+ */
+export declare enum LogLevel {
+    INFO = "INFO",
+    WARN = "WARN",
+    ERROR = "ERROR",
+    DEBUG = "DEBUG"
+}
+/**
+ * 로그 엔트리
+ */
+export interface LogEntry {
+    timestamp: Date;
+    level: LogLevel;
+    message: string;
+    data?: any;
+}
+/**
+ * 마이그레이션 로거
+ */
+export declare class MigrationLogger {
+    private logDir;
+    private logFile;
+    private entries;
+    constructor(logDir?: string);
+    /**
+     * 로그 디렉토리 생성
+     */
+    private ensureLogDirectory;
+    /**
+     * 로그 파일 초기화
+     */
+    initializeLogFile(migrationVersion: string): void;
+    /**
+     * 로그 기록
+     */
+    log(level: LogLevel, message: string, data?: any): void;
+    /**
+     * INFO 레벨 로그
+     */
+    info(message: string, data?: any): void;
+    /**
+     * WARN 레벨 로그
+     */
+    warn(message: string, data?: any): void;
+    /**
+     * ERROR 레벨 로그
+     */
+    error(message: string, data?: any): void;
+    /**
+     * DEBUG 레벨 로그
+     */
+    debug(message: string, data?: any): void;
+    /**
+     * 마이그레이션 결과 기록
+     */
+    logMigrationResult(result: MigrationResult): void;
+    /**
+     * 로그 파일에 쓰기
+     */
+    private writeToFile;
+    /**
+     * 로그 파일 경로 반환
+     */
+    getLogFile(): string | null;
+    /**
+     * 로그 엔트리 조회
+     */
+    getEntries(): LogEntry[];
+    /**
+     * 로그 디렉토리 경로 반환
+     */
+    getLogDirectory(): string;
+}
+//# sourceMappingURL=migration-logger.d.ts.map

package/dist/database/migration/migration-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-logger.d.ts","sourceRoot":"","sources":["../../../src/database/migration/migration-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAAkB;gBAErB,MAAM,CAAC,EAAE,MAAM;IAO3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAcjD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IA2BvD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAoBjD;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,IAAI;IAI3B;;OAEG;IACH,UAAU,IAAI,QAAQ,EAAE;IAIxB;;OAEG;IACH,eAAe,IAAI,MAAM;CAG1B"}