memento-mcp-server 1.12.0 → 1.13.0-b

package/dist/database/migration/migrations/006-fts5-reflection-notes.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Migration: 006 - FTS5 Reflection Notes Column
+ * Description: Create new FTS5 table (memory_item_fts_new) with reflection_notes column for Zero-Downtime migration
+ * Version: 6.0
+ * Date: 2025-01-XX
+ *
+ * This migration implements Step 1 of the Zero-Downtime migration strategy:
+ * - Creates memory_item_fts_new table with reflection_notes column
+ * - Does NOT re-index existing data (handled in Step 2)
+ * - Does NOT create triggers (handled in Step 3)
+ * - Does NOT replace tables (handled in Step 4)
+ *
+ * See docs/architecture/zero-downtime-fts5-migration.md for full migration strategy.
+ */
+import type Database from 'better-sqlite3';
+import type { Migration } from '../types.js';
+/**
+ * FTS5 Reflection Notes Migration (Step 1: New Table Creation)
+ *
+ * This migration:
+ * 1. Creates memory_item_fts_new virtual table with reflection_notes column
+ * 2. Validates table creation
+ * 3. Does NOT re-index existing data (handled separately)
+ * 4. Does NOT create triggers (handled separately)
+ */
+export declare class FTS5ReflectionNotesMigration implements Migration {
+    version: string;
+    name: string;
+    description: string;
+    /**
+     * Load SQL file content
+     */
+    private loadSQLFile;
+    /**
+     * Execute SQL script
+     * Removes transaction commands (BEGIN TRANSACTION, COMMIT) as MigrationRunner manages transactions
+     */
+    private executeSQL;
+    /**
+     * Check if virtual table exists
+     */
+    private virtualTableExists;
+    /**
+     * Validate before migration
+     */
+    validateBefore(db: Database.Database): Promise<void>;
+    /**
+     * Re-index existing data from memory_item to memory_item_fts_new
+     *
+     * This implements Step 2 of the Zero-Downtime migration strategy:
+     * - Processes data in batches (1000 records per batch)
+     * - Normalizes reflection_notes using normalizeReflectionNotes utility
+     * - Commits each batch separately for performance and safety
+     * - Logs progress every 10%
+     */
+    private reindexExistingData;
+    /**
+     * Create temporary dual triggers for synchronizing new writes during migration
+     *
+     * This implements Step 3 of the Zero-Downtime migration strategy:
+     * - Creates temporary triggers that insert into memory_item_fts_new
+     * - Existing triggers continue to insert into memory_item_fts
+     * - Both tables are kept in sync during migration
+     *
+     * Duplicate Insert Prevention:
+     * - FTS5 automatically handles duplicate rowid inserts (updates existing record)
+     * - Triggers fire only once per INSERT/UPDATE/DELETE event, so duplicates are unlikely
+     * - Transaction-level duplicate prevention is handled at application level
+     *
+     * Note: reflection_notes normalization is applied using normalize_reflection_notes function.
+     */
+    private createDualTriggers;
+    /**
+     * Drop temporary dual triggers
+     * Used for rollback or cleanup
+     */
+    private dropDualTriggers;
+    /**
+     * Check if trigger exists
+     */
+    private triggerExists;
+    /**
+     * Register normalize_reflection_notes user-defined function
+     * This function must be registered before triggers that use it
+     */
+    private registerNormalizeFunction;
+    /**
+     * Perform atomic table replacement
+     *
+     * This implements Step 4 of the Zero-Downtime migration strategy:
+     * - Drops existing triggers
+     * - Drops temporary dual triggers
+     * - Drops existing FTS5 table
+     * - Renames new table to original name
+     * - Creates new triggers with reflection_notes support and normalization
+     *
+     * All operations are performed in a single transaction for atomicity.
+     */
+    private performAtomicTableReplacement;
+    /**
+     * Execute migration (Up)
+     */
+    up(db: Database.Database): Promise<void>;
+    /**
+     * Rollback migration (Down)
+     */
+    down(db: Database.Database): Promise<void>;
+    /**
+     * Validate after migration
+     */
+    validateAfter(db: Database.Database): Promise<void>;
+}
+//# sourceMappingURL=006-fts5-reflection-notes.d.ts.map

package/dist/database/migration/migrations/006-fts5-reflection-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"006-fts5-reflection-notes.d.ts","sourceRoot":"","sources":["../../../../src/database/migration/migrations/006-fts5-reflection-notes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAY7C;;;;;;;;GAQG;AACH,qBAAa,4BAA6B,YAAW,SAAS;IAC5D,OAAO,SAAS;IAChB,IAAI,SAA2B;IAC/B,WAAW,SAA0G;IAErH;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC1D;;;;;;;;OAQG;YACW,mBAAmB;IAgGjC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IASjC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,6BAA6B;IAqDrC;;OAEG;IACG,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC9C;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhD;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA0E1D"}

package/dist/database/migration/migrations/006-fts5-reflection-notes.js

@@ -0,0 +1,441 @@
+/**
+ * Migration: 006 - FTS5 Reflection Notes Column
+ * Description: Create new FTS5 table (memory_item_fts_new) with reflection_notes column for Zero-Downtime migration
+ * Version: 6.0
+ * Date: 2025-01-XX
+ *
+ * This migration implements Step 1 of the Zero-Downtime migration strategy:
+ * - Creates memory_item_fts_new table with reflection_notes column
+ * - Does NOT re-index existing data (handled in Step 2)
+ * - Does NOT create triggers (handled in Step 3)
+ * - Does NOT replace tables (handled in Step 4)
+ *
+ * See docs/architecture/zero-downtime-fts5-migration.md for full migration strategy.
+ */
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { DependencyValidator } from '../dependency-validator.js';
+import { normalizeReflectionNotes } from '../../../utils/reflection-notes-normalize.js';
+import { initializeMigrationStatusTable, setMigrationStatus, getMigrationStatus } from '../../../utils/fts5-migration-status.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * FTS5 Reflection Notes Migration (Step 1: New Table Creation)
+ *
+ * This migration:
+ * 1. Creates memory_item_fts_new virtual table with reflection_notes column
+ * 2. Validates table creation
+ * 3. Does NOT re-index existing data (handled separately)
+ * 4. Does NOT create triggers (handled separately)
+ */
+export class FTS5ReflectionNotesMigration {
+    version = '6.0';
+    name = 'fts5-reflection-notes';
+    description = 'Create new FTS5 table (memory_item_fts_new) with reflection_notes column for Zero-Downtime migration';
+    /**
+     * Load SQL file content
+     */
+    loadSQLFile(filename) {
+        const filePath = join(__dirname, filename);
+        return readFileSync(filePath, 'utf-8');
+    }
+    /**
+     * Execute SQL script
+     * Removes transaction commands (BEGIN TRANSACTION, COMMIT) as MigrationRunner manages transactions
+     */
+    executeSQL(db, sql) {
+        // MigrationRunner가 트랜잭션을 관리하므로 SQL에서 트랜잭션 명령 제거
+        let cleanedSQL = sql
+            // BEGIN TRANSACTION 제거
+            .replace(/BEGIN\s+TRANSACTION\s*;/gi, '')
+            // COMMIT 제거
+            .replace(/COMMIT\s*;/gi, '')
+            // PRAGMA foreign_keys 명령은 유지 (트랜잭션 외부에서도 작동)
+            .trim();
+        // 빈 줄 제거 및 정리
+        cleanedSQL = cleanedSQL
+            .split('\n')
+            .map(line => line.trim())
+            .filter(line => line.length > 0)
+            .join('\n');
+        if (cleanedSQL.length > 0) {
+            db.exec(cleanedSQL);
+        }
+    }
+    /**
+     * Check if virtual table exists
+     */
+    virtualTableExists(db, tableName) {
+        const result = db.prepare(`
+      SELECT name FROM sqlite_master 
+      WHERE type='table' AND name=?
+    `).get(tableName);
+        return !!result;
+    }
+    /**
+     * Validate before migration
+     */
+    async validateBefore(db) {
+        // Check if memory_item table exists (required for content table reference)
+        const memoryItemExists = db.prepare(`
+      SELECT name FROM sqlite_master 
+      WHERE type='table' AND name=?
+    `).get('memory_item');
+        if (!memoryItemExists) {
+            throw new Error('memory_item table does not exist. Cannot proceed with migration.');
+        }
+        // Check if migration has already been applied
+        if (this.virtualTableExists(db, 'memento_schema_version')) {
+            const version = db.prepare(`
+        SELECT version FROM memento_schema_version WHERE version = ?
+      `).get('6.0');
+            if (version) {
+                throw new Error('Migration 006 has already been applied. Current schema version: 6.0');
+            }
+        }
+        // Check if memory_item_fts_new table already exists (should not exist)
+        if (this.virtualTableExists(db, 'memory_item_fts_new')) {
+            throw new Error('memory_item_fts_new table already exists. Migration may have been partially applied.');
+        }
+        // Check if FTS5 is available
+        try {
+            db.exec('CREATE VIRTUAL TABLE IF NOT EXISTS test_fts5 USING fts5(content)');
+            db.exec('DROP TABLE IF EXISTS test_fts5');
+        }
+        catch (error) {
+            throw new Error('FTS5 is not available. Cannot proceed with migration.');
+        }
+    }
+    /**
+     * Re-index existing data from memory_item to memory_item_fts_new
+     *
+     * This implements Step 2 of the Zero-Downtime migration strategy:
+     * - Processes data in batches (1000 records per batch)
+     * - Normalizes reflection_notes using normalizeReflectionNotes utility
+     * - Commits each batch separately for performance and safety
+     * - Logs progress every 10%
+     */
+    async reindexExistingData(db) {
+        const BATCH_SIZE = 1000;
+        const BATCH_DELAY_MS = 10;
+        // Get total record count
+        const totalCount = db.prepare(`
+      SELECT COUNT(*) as count FROM memory_item
+    `).get();
+        const totalRecords = totalCount.count;
+        if (totalRecords === 0) {
+            // stderr로 로그 출력 (MCP 프로토콜 준수)
+            process.stderr.write('[Migration 006] No records to re-index\n');
+            return;
+        }
+        // stderr로 로그 출력 (MCP 프로토콜 준수)
+        process.stderr.write(`[Migration 006] Starting re-indexing: ${totalRecords} records\n`);
+        let processedCount = 0;
+        let offset = 0;
+        let lastLoggedPercent = -1;
+        // Prepare statements
+        const selectStmt = db.prepare(`
+      SELECT rowid, content, tags, source, reflection_notes
+      FROM memory_item
+      ORDER BY rowid
+      LIMIT ? OFFSET ?
+    `);
+        const insertStmt = db.prepare(`
+      INSERT INTO memory_item_fts_new(rowid, content, tags, source, reflection_notes)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        // Process in batches
+        // Note: MigrationRunner가 이미 트랜잭션을 관리하므로 중첩 트랜잭션을 사용하지 않음
+        // 모든 배치 처리는 MigrationRunner의 단일 트랜잭션 내에서 실행됨
+        while (offset < totalRecords) {
+            try {
+                // Fetch batch
+                const batch = selectStmt.all(BATCH_SIZE, offset);
+                if (batch.length === 0) {
+                    break;
+                }
+                // Insert each record with normalized reflection_notes
+                for (const record of batch) {
+                    // Normalize reflection_notes for FTS5 indexing
+                    const normalizedReflectionNotes = normalizeReflectionNotes(record.reflection_notes);
+                    insertStmt.run(record.rowid, record.content, record.tags, record.source, normalizedReflectionNotes || null // Empty string becomes null
+                    );
+                }
+                processedCount += batch.length;
+                offset += BATCH_SIZE;
+                // Log progress every 10%
+                const currentPercent = Math.floor((processedCount / totalRecords) * 100);
+                if (currentPercent >= lastLoggedPercent + 10 || processedCount === totalRecords) {
+                    // stderr로 로그 출력 (MCP 프로토콜 준수)
+                    process.stderr.write(`[Migration 006] Re-indexing progress: ${processedCount}/${totalRecords} (${currentPercent}%)\n`);
+                    lastLoggedPercent = currentPercent;
+                }
+                // Delay between batches to minimize impact on other operations
+                if (offset < totalRecords) {
+                    await new Promise(resolve => setTimeout(resolve, BATCH_DELAY_MS));
+                }
+            }
+            catch (error) {
+                // MigrationRunner가 트랜잭션을 관리하므로 여기서는 에러만 전파
+                throw new Error(`Re-indexing failed at batch starting at offset ${offset}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // stderr로 로그 출력 (MCP 프로토콜 준수)
+        process.stderr.write(`[Migration 006] Re-indexing completed: ${processedCount} records\n`);
+    }
+    /**
+     * Create temporary dual triggers for synchronizing new writes during migration
+     *
+     * This implements Step 3 of the Zero-Downtime migration strategy:
+     * - Creates temporary triggers that insert into memory_item_fts_new
+     * - Existing triggers continue to insert into memory_item_fts
+     * - Both tables are kept in sync during migration
+     *
+     * Duplicate Insert Prevention:
+     * - FTS5 automatically handles duplicate rowid inserts (updates existing record)
+     * - Triggers fire only once per INSERT/UPDATE/DELETE event, so duplicates are unlikely
+     * - Transaction-level duplicate prevention is handled at application level
+     *
+     * Note: reflection_notes normalization is applied using normalize_reflection_notes function.
+     */
+    createDualTriggers(db) {
+        // stderr로 로그 출력 (MCP 프로토콜 준수)
+        process.stderr.write('[Migration 006] Creating temporary dual triggers...\n');
+        // Register normalize_reflection_notes function before creating triggers
+        this.registerNormalizeFunction(db);
+        // INSERT trigger: Insert new records into memory_item_fts_new with normalization
+        // FTS5 automatically handles duplicate rowid: if rowid exists, it updates the record
+        db.exec(`
+      CREATE TRIGGER IF NOT EXISTS memory_item_fts_insert_new AFTER INSERT ON memory_item BEGIN
+        INSERT INTO memory_item_fts_new(rowid, content, tags, source, reflection_notes)
+        VALUES (new.rowid, new.content, new.tags, new.source, normalize_reflection_notes(new.reflection_notes));
+      END
+    `);
+        // UPDATE trigger: Update records in memory_item_fts_new with normalization
+        // Delete old record first, then insert new record
+        db.exec(`
+      CREATE TRIGGER IF NOT EXISTS memory_item_fts_update_new AFTER UPDATE ON memory_item BEGIN
+        -- Delete old record
+        INSERT INTO memory_item_fts_new(memory_item_fts_new, rowid, content, tags, source, reflection_notes)
+        VALUES('delete', old.rowid, old.content, old.tags, old.source, normalize_reflection_notes(old.reflection_notes));
+        -- Insert new record
+        INSERT INTO memory_item_fts_new(rowid, content, tags, source, reflection_notes)
+        VALUES (new.rowid, new.content, new.tags, new.source, normalize_reflection_notes(new.reflection_notes));
+      END
+    `);
+        // DELETE trigger: Delete records from memory_item_fts_new with normalization
+        db.exec(`
+      CREATE TRIGGER IF NOT EXISTS memory_item_fts_delete_new AFTER DELETE ON memory_item BEGIN
+        INSERT INTO memory_item_fts_new(memory_item_fts_new, rowid, content, tags, source, reflection_notes)
+        VALUES('delete', old.rowid, old.content, old.tags, old.source, normalize_reflection_notes(old.reflection_notes));
+      END
+    `);
+        // stderr로 로그 출력 (MCP 프로토콜 준수)
+        process.stderr.write('[Migration 006] Temporary dual triggers created\n');
+    }
+    /**
+     * Drop temporary dual triggers
+     * Used for rollback or cleanup
+     */
+    dropDualTriggers(db) {
+        db.exec('DROP TRIGGER IF EXISTS memory_item_fts_insert_new');
+        db.exec('DROP TRIGGER IF EXISTS memory_item_fts_update_new');
+        db.exec('DROP TRIGGER IF EXISTS memory_item_fts_delete_new');
+    }
+    /**
+     * Check if trigger exists
+     */
+    triggerExists(db, triggerName) {
+        const result = db.prepare(`
+      SELECT name FROM sqlite_master 
+      WHERE type='trigger' AND name=?
+    `).get(triggerName);
+        return !!result;
+    }
+    /**
+     * Register normalize_reflection_notes user-defined function
+     * This function must be registered before triggers that use it
+     */
+    registerNormalizeFunction(db) {
+        db.function('normalize_reflection_notes', {
+            deterministic: true,
+            varargs: false
+        }, (reflectionNotes) => {
+            return normalizeReflectionNotes(reflectionNotes);
+        });
+    }
+    /**
+     * Perform atomic table replacement
+     *
+     * This implements Step 4 of the Zero-Downtime migration strategy:
+     * - Drops existing triggers
+     * - Drops temporary dual triggers
+     * - Drops existing FTS5 table
+     * - Renames new table to original name
+     * - Creates new triggers with reflection_notes support and normalization
+     *
+     * All operations are performed in a single transaction for atomicity.
+     */
+    performAtomicTableReplacement(db) {
+        // stderr로 로그 출력 (MCP 프로토콜 준수)
+        process.stderr.write('[Migration 006] Performing atomic table replacement...\n');
+        // Register normalize_reflection_notes function before creating triggers
+        this.registerNormalizeFunction(db);
+        // MigrationRunner가 트랜잭션을 관리하므로 여기서는 트랜잭션을 시작하지 않음
+        // All operations are performed within the existing transaction managed by MigrationRunner
+        // 1. Drop existing triggers
+        db.exec('DROP TRIGGER IF EXISTS memory_item_fts_insert');
+        db.exec('DROP TRIGGER IF EXISTS memory_item_fts_update');
+        db.exec('DROP TRIGGER IF EXISTS memory_item_fts_delete');
+        // 2. Drop temporary dual triggers
+        this.dropDualTriggers(db);
+        // 3. Drop existing FTS5 table
+        db.exec('DROP TABLE IF EXISTS memory_item_fts');
+        // 4. Rename new table to original name
+        db.exec('ALTER TABLE memory_item_fts_new RENAME TO memory_item_fts');
+        // 5. Create new triggers with reflection_notes support and normalization
+        // Note: normalize_reflection_notes function must be registered before this migration
+        db.exec(`
+      CREATE TRIGGER memory_item_fts_insert AFTER INSERT ON memory_item BEGIN
+        INSERT INTO memory_item_fts(rowid, content, tags, source, reflection_notes)
+        VALUES (new.rowid, new.content, new.tags, new.source, normalize_reflection_notes(new.reflection_notes));
+      END
+    `);
+        db.exec(`
+      CREATE TRIGGER memory_item_fts_update AFTER UPDATE ON memory_item BEGIN
+        INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source, reflection_notes)
+        VALUES('delete', old.rowid, old.content, old.tags, old.source, normalize_reflection_notes(old.reflection_notes));
+        INSERT INTO memory_item_fts(rowid, content, tags, source, reflection_notes)
+        VALUES (new.rowid, new.content, new.tags, new.source, normalize_reflection_notes(new.reflection_notes));
+      END
+    `);
+        db.exec(`
+      CREATE TRIGGER memory_item_fts_delete AFTER DELETE ON memory_item BEGIN
+        INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source, reflection_notes)
+        VALUES('delete', old.rowid, old.content, old.tags, old.source, normalize_reflection_notes(old.reflection_notes));
+      END
+    `);
+        // stderr로 로그 출력 (MCP 프로토콜 준수)
+        process.stderr.write('[Migration 006] Atomic table replacement completed\n');
+    }
+    /**
+     * Execute migration (Up)
+     */
+    async up(db) {
+        // Initialize migration status table
+        initializeMigrationStatusTable(db);
+        // Update status to 'in_progress'
+        setMigrationStatus(db, 'in_progress');
+        try {
+            // Step 1: Load and execute SQL script (create new table)
+            const sqlScript = this.loadSQLFile('006-fts5-reflection-notes.sql');
+            this.executeSQL(db, sqlScript);
+            // Step 2: Re-index existing data
+            await this.reindexExistingData(db);
+            // Step 3: Create temporary dual triggers
+            this.createDualTriggers(db);
+            // Step 4: Perform atomic table replacement
+            this.performAtomicTableReplacement(db);
+            // Update status to 'completed'
+            setMigrationStatus(db, 'completed');
+            // Note: Schema version is recorded by MigrationRunner, not here
+            // MigrationRunner.recordVersion() will be called after successful migration
+            // 
+            // Note: This migration implements Steps 1, 2, 3, and 4 of the Zero-Downtime migration strategy.
+            // Trigger update with reflection_notes normalization (Step 3.8) is handled separately.
+        }
+        catch (error) {
+            // Update status to 'failed' on error
+            setMigrationStatus(db, 'failed', error instanceof Error ? error.message : String(error));
+            throw error; // Re-throw to trigger rollback
+        }
+    }
+    /**
+     * Rollback migration (Down)
+     */
+    async down(db) {
+        // Drop temporary dual triggers
+        this.dropDualTriggers(db);
+        // Drop the new FTS5 table
+        db.exec('DROP TABLE IF EXISTS memory_item_fts_new');
+        // Update status to 'pending' (재시도 가능하도록)
+        try {
+            setMigrationStatus(db, 'pending');
+        }
+        catch (error) {
+            // 상태 업데이트 실패는 무시 (롤백은 계속 진행)
+            // stderr로 로그 출력 (MCP 프로토콜 준수)
+            process.stderr.write(`⚠️ 마이그레이션 상태 롤백 실패: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+        // Remove schema version record
+        db.prepare('DELETE FROM memento_schema_version WHERE version = ?').run('6.0');
+    }
+    /**
+     * Validate after migration
+     */
+    async validateAfter(db) {
+        // After atomic table replacement, memory_item_fts_new should not exist
+        // and memory_item_fts should exist with reflection_notes column
+        // Verify memory_item_fts table exists (renamed from memory_item_fts_new)
+        if (!this.virtualTableExists(db, 'memory_item_fts')) {
+            throw new Error('memory_item_fts table was not created or renamed');
+        }
+        // Verify memory_item_fts_new table does not exist (should be renamed)
+        if (this.virtualTableExists(db, 'memory_item_fts_new')) {
+            throw new Error('memory_item_fts_new table still exists (should be renamed to memory_item_fts)');
+        }
+        // Verify table structure by checking if it's a virtual table
+        const tableInfo = db.prepare(`
+      SELECT sql FROM sqlite_master 
+      WHERE type='table' AND name='memory_item_fts'
+    `).get();
+        if (!tableInfo) {
+            throw new Error('memory_item_fts table information not found');
+        }
+        // Verify reflection_notes column is included in the table definition
+        if (!tableInfo.sql.includes('reflection_notes')) {
+            throw new Error('reflection_notes column was not included in memory_item_fts table');
+        }
+        // Verify content table reference
+        if (!tableInfo.sql.includes("content='memory_item'")) {
+            throw new Error("content table reference 'memory_item' was not found in memory_item_fts table");
+        }
+        // Verify content_rowid reference
+        if (!tableInfo.sql.includes("content_rowid='rowid'")) {
+            throw new Error("content_rowid='rowid' was not found in memory_item_fts table");
+        }
+        // Verify new triggers were created (temporary dual triggers should be removed)
+        const requiredTriggers = [
+            'memory_item_fts_insert',
+            'memory_item_fts_update',
+            'memory_item_fts_delete'
+        ];
+        for (const triggerName of requiredTriggers) {
+            if (!this.triggerExists(db, triggerName)) {
+                throw new Error(`New trigger ${triggerName} was not created`);
+            }
+        }
+        // Verify temporary dual triggers were removed
+        const temporaryTriggers = [
+            'memory_item_fts_insert_new',
+            'memory_item_fts_update_new',
+            'memory_item_fts_delete_new'
+        ];
+        for (const triggerName of temporaryTriggers) {
+            if (this.triggerExists(db, triggerName)) {
+                throw new Error(`Temporary dual trigger ${triggerName} still exists (should be removed)`);
+            }
+        }
+        // Verify existing dependencies are intact using DependencyValidator
+        const dependencyReport = await DependencyValidator.validateAll(db);
+        if (!dependencyReport.success) {
+            const errors = dependencyReport.results
+                .filter(r => !r.success)
+                .map(r => `${r.name}: ${r.error}`)
+                .join('; ');
+            throw new Error(`Dependency validation failed: ${errors}`);
+        }
+    }
+}
+//# sourceMappingURL=006-fts5-reflection-notes.js.map

package/dist/database/migration/migrations/006-fts5-reflection-notes.js.map

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

package/dist/database/migration/migrations/006-fts5-reflection-notes.sql

@@ -0,0 +1,26 @@
+-- Migration: 006 - FTS5 Reflection Notes Column
+-- Description: Create new FTS5 table (memory_item_fts_new) with reflection_notes column for Zero-Downtime migration
+-- Version: 6.0
+-- Date: 2025-01-XX
+--
+-- This is Step 1 of the Zero-Downtime migration strategy:
+-- 1. Create new FTS5 table with reflection_notes column
+-- 2. Re-index existing data (Step 2, handled separately)
+-- 3. Create temporary dual triggers (Step 3, handled separately)
+-- 4. Atomic table replacement (Step 4, handled separately)
+-- 5. Activate new triggers (Step 5, handled separately)
+
+-- Create new FTS5 virtual table with reflection_notes column
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_fts_new USING fts5(
+  content,
+  tags,
+  source,
+  reflection_notes,  -- New column for reflection notes search
+  content='memory_item',
+  content_rowid='rowid'
+);
+
+-- Note: This migration only creates the new table.
+-- Data re-indexing, trigger creation, and table replacement are handled in subsequent steps
+-- to ensure Zero-Downtime migration.
+

package/dist/database/schema.sql

@@ -98,26 +98,28 @@ CREATE VIRTUAL TABLE IF NOT EXISTS memory_item_fts USING fts5(
   content,
   tags,
   source,
+  reflection_notes,
   content='memory_item',
   content_rowid='rowid'
 );
 
--- FTS5 트리거 (자동 동기화)
+-- FTS5 트리거 (자동 동기화, reflection_notes 정규화 포함)
+-- Note: normalize_reflection_notes 함수는 데이터베이스 초기화 시 등록되어야 함
 CREATE TRIGGER IF NOT EXISTS memory_item_fts_insert AFTER INSERT ON memory_item BEGIN
-  INSERT INTO memory_item_fts(rowid, content, tags, source)
-  VALUES (new.rowid, new.content, new.tags, new.source);
+  INSERT INTO memory_item_fts(rowid, content, tags, source, reflection_notes)
+  VALUES (new.rowid, new.content, new.tags, new.source, normalize_reflection_notes(new.reflection_notes));
 END;
 
 CREATE TRIGGER IF NOT EXISTS memory_item_fts_delete AFTER DELETE ON memory_item BEGIN
-  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source)
-  VALUES('delete', old.rowid, old.content, old.tags, old.source);
+  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source, reflection_notes)
+  VALUES('delete', old.rowid, old.content, old.tags, old.source, normalize_reflection_notes(old.reflection_notes));
 END;
 
 CREATE TRIGGER IF NOT EXISTS memory_item_fts_update AFTER UPDATE ON memory_item BEGIN
-  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source)
-  VALUES('delete', old.rowid, old.content, old.tags, old.source);
-  INSERT INTO memory_item_fts(rowid, content, tags, source)
-  VALUES (new.rowid, new.content, new.tags, new.source);
+  INSERT INTO memory_item_fts(memory_item_fts, rowid, content, tags, source, reflection_notes)
+  VALUES('delete', old.rowid, old.content, old.tags, old.source, normalize_reflection_notes(old.reflection_notes));
+  INSERT INTO memory_item_fts(rowid, content, tags, source, reflection_notes)
+  VALUES (new.rowid, new.content, new.tags, new.source, normalize_reflection_notes(new.reflection_notes));
 END;
 
 -- 임베딩 저장 테이블 (다중 제공자/차원 지원)

package/dist/server/bootstrap.d.ts

@@ -14,6 +14,8 @@ import { PerformanceAlertService } from '../services/performance-alert-service.j
 import { ConsolidationScoreService } from '../services/consolidation-score-service.js';
 import { WriteCoalescingManager } from '../utils/write-coalescing.js';
 import { AnchorManager } from '../services/anchor-manager.js';
+import { FailureDetector } from '../services/failure-detector.js';
+import { ReflexionWorker } from '../services/reflexion-worker.js';
 /**
  * 서버 서비스 집합 인터페이스
  *
@@ -43,6 +45,8 @@ export interface ServerServices {
     consolidationScoreService?: ConsolidationScoreService;
     writeCoalescingManager?: WriteCoalescingManager;
     anchorManager: AnchorManager;
+    failureDetector: FailureDetector;
+    reflexionWorker?: ReflexionWorker;
 }
 /**
  * 모든 서비스를 초기화하는 공용 부트스트랩 함수