memento-mcp-server 1.12.0 → 1.13.0-a

package/dist/utils/fts5-migration-status.js

@@ -0,0 +1,304 @@
+/**
+ * FTS5 Migration Status 유틸리티
+ *
+ * FTS5 reflection_notes 마이그레이션 상태를 관리하는 유틸리티 함수를 제공합니다.
+ * Fallback 전략을 위해 마이그레이션 상태를 추적하고 관리합니다.
+ */
+import { DatabaseUtils } from './database.js';
+import { mementoConfig } from '../config/index.js';
+const MIGRATION_KEY = 'fts5-reflection-notes';
+/**
+ * 마이그레이션 상태 테이블 초기화
+ * 테이블이 없으면 생성하고, 초기 상태 'pending' 삽입
+ */
+export function initializeMigrationStatusTable(db) {
+    try {
+        // 테이블 생성
+        DatabaseUtils.run(db, `
+      CREATE TABLE IF NOT EXISTS fts5_migration_status (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        migration_key TEXT NOT NULL UNIQUE DEFAULT 'fts5-reflection-notes',
+        status TEXT NOT NULL CHECK (status IN ('pending', 'in_progress', 'completed', 'failed')) DEFAULT 'pending',
+        started_at TIMESTAMP,
+        completed_at TIMESTAMP,
+        failed_at TIMESTAMP,
+        error_message TEXT,
+        retry_count INTEGER DEFAULT 0,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      )
+    `);
+        // 인덱스 생성
+        DatabaseUtils.run(db, `
+      CREATE INDEX IF NOT EXISTS idx_fts5_migration_status_key ON fts5_migration_status(migration_key)
+    `);
+        DatabaseUtils.run(db, `
+      CREATE INDEX IF NOT EXISTS idx_fts5_migration_status_status ON fts5_migration_status(status)
+    `);
+        // 초기 상태 삽입 (없는 경우)
+        DatabaseUtils.run(db, `
+      INSERT OR IGNORE INTO fts5_migration_status (migration_key, status)
+      VALUES (?, 'pending')
+    `, [MIGRATION_KEY]);
+    }
+    catch (error) {
+        throw new Error(`마이그레이션 상태 테이블 초기화 실패: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * 마이그레이션 상태 조회
+ *
+ * @param db - 데이터베이스 인스턴스
+ * @returns 마이그레이션 상태
+ */
+export function getMigrationStatus(db) {
+    try {
+        // 먼저 테이블이 존재하는지 확인
+        const tableExists = DatabaseUtils.get(db, `
+      SELECT name FROM sqlite_master 
+      WHERE type='table' AND name='fts5_migration_status'
+    `);
+        if (!tableExists) {
+            // 테이블이 없으면 초기화 후 'pending' 반환
+            initializeMigrationStatusTable(db);
+            return 'pending';
+        }
+        // 테이블이 있으면 상태 조회
+        const result = DatabaseUtils.get(db, `
+      SELECT status FROM fts5_migration_status
+      WHERE migration_key = ?
+    `, [MIGRATION_KEY]);
+        if (!result) {
+            // 상태가 없으면 초기화 후 'pending' 반환
+            initializeMigrationStatusTable(db);
+            return 'pending';
+        }
+        return result.status;
+    }
+    catch (error) {
+        // 조회 실패 시 테이블 초기화 시도
+        try {
+            initializeMigrationStatusTable(db);
+            return 'pending';
+        }
+        catch (initError) {
+            // 초기화도 실패하면 기본값 반환
+            console.warn('마이그레이션 상태 조회 및 초기화 실패:', error, initError);
+            return 'pending';
+        }
+    }
+}
+/**
+ * 마이그레이션 상태 업데이트
+ *
+ * @param db - 데이터베이스 인스턴스
+ * @param status - 새로운 상태
+ * @param errorMessage - 에러 메시지 (실패 시)
+ * @throws Error - 상태 전이 검증 실패 시
+ */
+export function setMigrationStatus(db, status, errorMessage) {
+    try {
+        // 현재 상태 조회
+        const currentStatus = getMigrationStatus(db);
+        // 상태 전이 검증
+        if (!isValidStatusTransition(currentStatus, status)) {
+            throw new Error(`유효하지 않은 상태 전이: ${currentStatus} → ${status}`);
+        }
+        // 상태 업데이트
+        const now = new Date().toISOString();
+        let updateSql = '';
+        let params = [];
+        if (status === 'in_progress') {
+            updateSql = `
+        UPDATE fts5_migration_status
+        SET status = ?, started_at = ?, updated_at = ?
+        WHERE migration_key = ?
+      `;
+            params = [status, now, now, MIGRATION_KEY];
+        }
+        else if (status === 'completed') {
+            updateSql = `
+        UPDATE fts5_migration_status
+        SET status = ?, completed_at = ?, updated_at = ?
+        WHERE migration_key = ?
+      `;
+            params = [status, now, now, MIGRATION_KEY];
+        }
+        else if (status === 'failed') {
+            updateSql = `
+        UPDATE fts5_migration_status
+        SET status = ?, failed_at = ?, error_message = ?, retry_count = retry_count + 1, updated_at = ?
+        WHERE migration_key = ?
+      `;
+            params = [status, now, errorMessage || null, now, MIGRATION_KEY];
+        }
+        else if (status === 'pending') {
+            // 재시도 시 pending으로 되돌림
+            updateSql = `
+        UPDATE fts5_migration_status
+        SET status = ?, started_at = NULL, completed_at = NULL, failed_at = NULL, error_message = NULL, updated_at = ?
+        WHERE migration_key = ?
+      `;
+            params = [status, now, MIGRATION_KEY];
+        }
+        if (updateSql) {
+            DatabaseUtils.run(db, updateSql, params);
+        }
+        // Config 캐시 업데이트
+        mementoConfig.fts5MigrationStatus = status;
+    }
+    catch (error) {
+        throw new Error(`마이그레이션 상태 업데이트 실패: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * 상태 전이 검증
+ *
+ * 유효한 상태 전이:
+ * - pending → in_progress
+ * - in_progress → completed
+ * - in_progress → failed
+ * - failed → pending (재시도)
+ * - completed → (변경 불가)
+ *
+ * @param currentStatus - 현재 상태
+ * @param newStatus - 새로운 상태
+ * @returns 유효한 전이인지 여부
+ */
+function isValidStatusTransition(currentStatus, newStatus) {
+    // 동일한 상태로 변경은 허용 (에러 메시지 업데이트 등)
+    if (currentStatus === newStatus) {
+        return true;
+    }
+    // 상태 전이 규칙
+    const validTransitions = {
+        pending: ['in_progress'],
+        in_progress: ['completed', 'failed'],
+        completed: [], // completed는 변경 불가
+        failed: ['pending'] // 재시도를 위해 pending으로 되돌릴 수 있음
+    };
+    return validTransitions[currentStatus].includes(newStatus);
+}
+/**
+ * 마이그레이션 상태를 config에 로드 및 캐시
+ *
+ * @param db - 데이터베이스 인스턴스
+ */
+export function loadMigrationStatusToConfig(db) {
+    try {
+        const status = getMigrationStatus(db);
+        mementoConfig.fts5MigrationStatus = status;
+    }
+    catch (error) {
+        // 로드 실패 시 기본값 설정
+        console.warn('마이그레이션 상태 로드 실패, 기본값 사용:', error);
+        mementoConfig.fts5MigrationStatus = 'pending';
+    }
+}
+/**
+ * 마이그레이션 상태가 완료되었는지 확인
+ *
+ * @param db - 데이터베이스 인스턴스 (선택적, 없으면 config 캐시 사용)
+ * @returns 완료 여부
+ */
+export function isMigrationCompleted(db) {
+    if (db) {
+        const status = getMigrationStatus(db);
+        return status === 'completed';
+    }
+    return mementoConfig.fts5MigrationStatus === 'completed';
+}
+/**
+ * 마이그레이션 상태가 실패했는지 확인
+ *
+ * @param db - 데이터베이스 인스턴스 (선택적, 없으면 config 캐시 사용)
+ * @returns 실패 여부
+ */
+export function isMigrationFailed(db) {
+    if (db) {
+        const status = getMigrationStatus(db);
+        return status === 'failed';
+    }
+    return mementoConfig.fts5MigrationStatus === 'failed';
+}
+/**
+ * Fallback이 필요한지 확인 (마이그레이션 실패 또는 대기 중)
+ *
+ * @param db - 데이터베이스 인스턴스 (선택적, 없으면 config 캐시 사용)
+ * @returns Fallback 필요 여부
+ */
+export function shouldUseFallback(db) {
+    // 환경 변수로 강제 Fallback 활성화 확인
+    if (process.env.MEMENTO_FTS5_FALLBACK_ENABLED === 'true') {
+        return true;
+    }
+    if (db) {
+        const status = getMigrationStatus(db);
+        return status === 'failed' || status === 'pending';
+    }
+    const status = mementoConfig.fts5MigrationStatus;
+    return status === 'failed' || status === 'pending';
+}
+/**
+ * 마이그레이션 재시도 준비
+ * 실패한 마이그레이션을 재시도하기 위해 상태를 'pending'으로 되돌립니다.
+ *
+ * @param db - 데이터베이스 인스턴스
+ */
+export function prepareMigrationRetry(db) {
+    const currentStatus = getMigrationStatus(db);
+    if (currentStatus !== 'failed') {
+        throw new Error(`마이그레이션 재시도는 'failed' 상태에서만 가능합니다. 현재 상태: ${currentStatus}`);
+    }
+    setMigrationStatus(db, 'pending');
+}
+/**
+ * 마이그레이션 상태를 강제로 업데이트 (관리자용)
+ *
+ * @param db - 데이터베이스 인스턴스
+ * @param status - 새로운 상태
+ * @param errorMessage - 에러 메시지 (선택적)
+ */
+export function forceSetMigrationStatus(db, status, errorMessage) {
+    // 상태 전이 검증 없이 강제 업데이트
+    const now = new Date().toISOString();
+    let updateSql = '';
+    let params = [];
+    if (status === 'in_progress') {
+        updateSql = `
+      UPDATE fts5_migration_status
+      SET status = ?, started_at = ?, updated_at = ?
+      WHERE migration_key = ?
+    `;
+        params = [status, now, now, MIGRATION_KEY];
+    }
+    else if (status === 'completed') {
+        updateSql = `
+      UPDATE fts5_migration_status
+      SET status = ?, completed_at = ?, updated_at = ?
+      WHERE migration_key = ?
+    `;
+        params = [status, now, now, MIGRATION_KEY];
+    }
+    else if (status === 'failed') {
+        updateSql = `
+      UPDATE fts5_migration_status
+      SET status = ?, failed_at = ?, error_message = ?, retry_count = retry_count + 1, updated_at = ?
+      WHERE migration_key = ?
+    `;
+        params = [status, now, errorMessage || null, now, MIGRATION_KEY];
+    }
+    else if (status === 'pending') {
+        updateSql = `
+      UPDATE fts5_migration_status
+      SET status = ?, started_at = NULL, completed_at = NULL, failed_at = NULL, error_message = NULL, updated_at = ?
+      WHERE migration_key = ?
+    `;
+        params = [status, now, MIGRATION_KEY];
+    }
+    if (updateSql) {
+        DatabaseUtils.run(db, updateSql, params);
+        mementoConfig.fts5MigrationStatus = status;
+    }
+}
+//# sourceMappingURL=fts5-migration-status.js.map

package/dist/utils/fts5-migration-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts5-migration-status.js","sourceRoot":"","sources":["../../src/utils/fts5-migration-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,EAAqB;IAClE,IAAI,CAAC;QACH,SAAS;QACT,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;;;;;;;;;;;;;KAarB,CAAC,CAAC;QAEH,SAAS;QACT,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;;KAErB,CAAC,CAAC;QACH,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;;KAErB,CAAC,CAAC;QAEH,mBAAmB;QACnB,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;;;KAGrB,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAqB;IACtD,IAAI,CAAC;QACH,mBAAmB;QACnB,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;;;KAGzC,CAAiC,CAAC;QAEnC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,8BAA8B;YAC9B,8BAA8B,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,iBAAiB;QACjB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE;;;KAGpC,EAAE,CAAC,aAAa,CAAC,CAAmC,CAAC;QAEtD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,6BAA6B;YAC7B,8BAA8B,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,CAAC,MAA6B,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qBAAqB;QACrB,IAAI,CAAC;YACH,8BAA8B,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,mBAAmB;YACnB,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;YACzD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAqB,EACrB,MAA2B,EAC3B,YAAqB;IAErB,IAAI,CAAC;QACH,WAAW;QACX,MAAM,aAAa,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAE7C,WAAW;QACX,IAAI,CAAC,uBAAuB,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,kBAAkB,aAAa,MAAM,MAAM,EAAE,CAC9C,CAAC;QACJ,CAAC;QAED,UAAU;QACV,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,MAAM,GAAU,EAAE,CAAC;QAEvB,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;YAC7B,SAAS,GAAG;;;;OAIX,CAAC;YACF,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,SAAS,GAAG;;;;OAIX,CAAC;YACF,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,SAAS,GAAG;;;;OAIX,CAAC;YACF,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,IAAI,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,sBAAsB;YACtB,SAAS,GAAG;;;;OAIX,CAAC;YACF,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,iBAAiB;QAChB,aAAqB,CAAC,mBAAmB,GAAG,MAAM,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/E,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,uBAAuB,CAC9B,aAAkC,EAClC,SAA8B;IAE9B,iCAAiC;IACjC,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW;IACX,MAAM,gBAAgB,GAAuD;QAC3E,OAAO,EAAE,CAAC,aAAa,CAAC;QACxB,WAAW,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;QACpC,SAAS,EAAE,EAAE,EAAE,mBAAmB;QAClC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,6BAA6B;KAClD,CAAC;IAEF,OAAO,gBAAgB,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,EAAqB;IAC/D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACrC,aAAqB,CAAC,mBAAmB,GAAG,MAAM,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iBAAiB;QACjB,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QAC/C,aAAqB,CAAC,mBAAmB,GAAG,SAAS,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAsB;IACzD,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACtC,OAAO,MAAM,KAAK,WAAW,CAAC;IAChC,CAAC;IACD,OAAO,aAAa,CAAC,mBAAmB,KAAK,WAAW,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAsB;IACtD,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACtC,OAAO,MAAM,KAAK,QAAQ,CAAC;IAC7B,CAAC;IACD,OAAO,aAAa,CAAC,mBAAmB,KAAK,QAAQ,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAsB;IACtD,4BAA4B;IAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,MAAM,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACtC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,CAAC;IACrD,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,mBAAmB,CAAC;IACjD,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAqB;IACzD,MAAM,aAAa,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAE7C,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,4CAA4C,aAAa,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,kBAAkB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,EAAqB,EACrB,MAA2B,EAC3B,YAAqB;IAErB,sBAAsB;IACtB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,MAAM,GAAU,EAAE,CAAC;IAEvB,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,SAAS,GAAG;;;;KAIX,CAAC;QACF,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IAC7C,CAAC;SAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,SAAS,GAAG;;;;KAIX,CAAC;QACF,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IAC7C,CAAC;SAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,SAAS,GAAG;;;;KAIX,CAAC;QACF,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,IAAI,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC;SAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,SAAS,GAAG;;;;KAIX,CAAC;QACF,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACxC,aAAqB,CAAC,mBAAmB,GAAG,MAAM,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/utils/reflection-notes-merge.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Reflection Notes 병합 및 배열 크기 제한 유틸리티
+ *
+ * reflection_notes 필드의 병합 로직과 크기 제한을 처리하는 공통 유틸리티 함수를 제공합니다.
+ * remember Tool과 Reflexion Worker에서 공통으로 사용됩니다.
+ */
+/**
+ * 병합 결과 타입
+ */
+export interface MergeResult {
+    merged: any[];
+    removedCount: number;
+    warnings: string[];
+}
+/**
+ * 기존 reflection_notes 타입
+ */
+export type ExistingReflectionNotes = {
+    type: 'null';
+    value: null;
+} | {
+    type: 'object';
+    value: any;
+} | {
+    type: 'array';
+    value: any[];
+};
+/**
+ * 새로 추가할 reflection_notes 타입
+ */
+export type NewReflectionNotes = string | any | any[];
+/**
+ * reflection_notes 병합 및 배열 크기 제한
+ *
+ * 병합 로직:
+ * - NULL → 새로 저장
+ * - 단일 객체 → 배열 변환 후 추가
+ * - 배열 → 배열에 추가
+ *
+ * 크기 제한:
+ * - 배열 크기: 최대 100개, 초과 시 FIFO로 가장 오래된 항목 제거
+ * - 단일 객체: 최대 10KB, 초과 시 에러 반환
+ * - 전체 필드: 최대 1MB, 초과 시 자동 정리 (가장 오래된 항목부터 제거)
+ *
+ * @param existing - 기존 reflection_notes (조회 결과)
+ * @param newNotes - 새로 추가할 reflection_notes (문자열, 객체, 또는 배열)
+ * @returns 병합 결과
+ * @throws Error - 단일 객체 크기 초과 시
+ */
+export declare function mergeReflectionNotes(existing: ExistingReflectionNotes, newNotes: NewReflectionNotes): MergeResult;
+/**
+ * 병합된 reflection_notes를 JSON 문자열로 변환
+ *
+ * @param merged - 병합된 배열
+ * @returns JSON 문자열
+ */
+export declare function serializeReflectionNotes(merged: any[]): string;
+//# sourceMappingURL=reflection-notes-merge.d.ts.map

package/dist/utils/reflection-notes-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-notes-merge.d.ts","sourceRoot":"","sources":["../../src/utils/reflection-notes-merge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;AA4JtD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,uBAAuB,EACjC,QAAQ,EAAE,kBAAkB,GAC3B,WAAW,CA2Db;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAQ9D"}

package/dist/utils/reflection-notes-merge.js

@@ -0,0 +1,227 @@
+/**
+ * Reflection Notes 병합 및 배열 크기 제한 유틸리티
+ *
+ * reflection_notes 필드의 병합 로직과 크기 제한을 처리하는 공통 유틸리티 함수를 제공합니다.
+ * remember Tool과 Reflexion Worker에서 공통으로 사용됩니다.
+ */
+import { logger } from './logger.js';
+import { validateReflectionNotes } from './reflection-notes-schema.js';
+/**
+ * 단일 객체 최대 크기 (10KB)
+ */
+const MAX_SINGLE_OBJECT_SIZE = 10 * 1024; // 10KB
+/**
+ * 전체 필드 최대 크기 (1MB)
+ */
+const MAX_TOTAL_FIELD_SIZE = 1024 * 1024; // 1MB
+/**
+ * 배열 최대 크기 (100개)
+ */
+const MAX_ARRAY_SIZE = 100;
+/**
+ * 단일 객체 크기 검증
+ *
+ * @param obj - 검증할 객체
+ * @returns 객체 크기 (바이트)
+ */
+function getObjectSize(obj) {
+    try {
+        return new TextEncoder().encode(JSON.stringify(obj)).length;
+    }
+    catch (error) {
+        // JSON 직렬화 실패 시 안전하게 처리
+        return 0;
+    }
+}
+/**
+ * 단일 객체 최대 크기 검증
+ *
+ * @param obj - 검증할 객체
+ * @throws Error - 10KB 초과 시
+ */
+function validateSingleObjectSize(obj) {
+    const size = getObjectSize(obj);
+    if (size > MAX_SINGLE_OBJECT_SIZE) {
+        throw new Error(`단일 reflection_notes 객체는 최대 ${MAX_SINGLE_OBJECT_SIZE}바이트(10KB)를 초과할 수 없습니다. 현재 크기: ${size}바이트`);
+    }
+}
+/**
+ * 배열 크기 제한 적용 (FIFO 방식)
+ *
+ * @param array - 제한을 적용할 배열
+ * @returns 제한이 적용된 배열과 제거된 항목 수
+ */
+function limitArraySize(array) {
+    if (array.length <= MAX_ARRAY_SIZE) {
+        return { limited: array, removedCount: 0 };
+    }
+    const removedCount = array.length - MAX_ARRAY_SIZE;
+    const limited = array.slice(-MAX_ARRAY_SIZE); // 가장 최근 항목 유지 (FIFO)
+    logger.warn('reflection_notes 배열 크기 제한 초과', {
+        originalSize: array.length,
+        maxSize: MAX_ARRAY_SIZE,
+        removedCount,
+        message: `배열 크기가 ${MAX_ARRAY_SIZE}개를 초과하여 가장 오래된 ${removedCount}개 항목이 제거되었습니다`
+    });
+    return { limited, removedCount };
+}
+/**
+ * 전체 필드 크기 검증 및 자동 정리
+ *
+ * @param array - 검증할 배열
+ * @returns 정리된 배열과 제거된 항목 수
+ */
+function validateAndCleanupTotalSize(array) {
+    const totalSize = getObjectSize(array);
+    if (totalSize <= MAX_TOTAL_FIELD_SIZE) {
+        return { cleaned: array, removedCount: 0 };
+    }
+    // 가장 오래된 항목부터 제거 (timestamp 기준으로 정렬)
+    const sorted = [...array].sort((a, b) => {
+        const timestampA = a.timestamp ? new Date(a.timestamp).getTime() : 0;
+        const timestampB = b.timestamp ? new Date(b.timestamp).getTime() : 0;
+        return timestampA - timestampB; // 오래된 것부터
+    });
+    let cleaned = [...array];
+    let removedCount = 0;
+    // 전체 크기가 1MB 이하가 될 때까지 가장 오래된 항목 제거
+    while (getObjectSize(cleaned) > MAX_TOTAL_FIELD_SIZE && cleaned.length > 0) {
+        // 가장 오래된 항목 찾기
+        const oldestIndex = cleaned.findIndex((item, idx) => {
+            const itemTimestamp = item.timestamp ? new Date(item.timestamp).getTime() : 0;
+            const oldestTimestamp = sorted[removedCount]?.timestamp
+                ? new Date(sorted[removedCount].timestamp).getTime()
+                : 0;
+            return itemTimestamp === oldestTimestamp;
+        });
+        if (oldestIndex !== -1) {
+            cleaned.splice(oldestIndex, 1);
+            removedCount++;
+        }
+        else {
+            // timestamp가 없는 경우 첫 번째 항목 제거
+            cleaned.shift();
+            removedCount++;
+        }
+    }
+    if (removedCount > 0) {
+        logger.warn('reflection_notes 전체 필드 크기 제한 초과', {
+            originalSize: totalSize,
+            maxSize: MAX_TOTAL_FIELD_SIZE,
+            removedCount,
+            remainingSize: getObjectSize(cleaned),
+            message: `전체 필드 크기가 ${MAX_TOTAL_FIELD_SIZE}바이트(1MB)를 초과하여 가장 오래된 ${removedCount}개 항목이 자동으로 제거되었습니다`
+        });
+    }
+    return { cleaned, removedCount };
+}
+/**
+ * 새로 추가할 reflection_notes를 배열로 변환
+ *
+ * @param newNotes - 새로 추가할 reflection_notes (문자열, 객체, 또는 배열)
+ * @returns 배열로 변환된 reflection_notes
+ */
+function normalizeNewReflectionNotes(newNotes) {
+    // 문자열인 경우 JSON 파싱
+    if (typeof newNotes === 'string') {
+        try {
+            const parsed = JSON.parse(newNotes);
+            return Array.isArray(parsed) ? parsed : [parsed];
+        }
+        catch (error) {
+            throw new Error(`reflection_notes JSON 파싱 실패: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // 이미 배열인 경우
+    if (Array.isArray(newNotes)) {
+        return newNotes;
+    }
+    // 단일 객체인 경우
+    return [newNotes];
+}
+/**
+ * reflection_notes 병합 및 배열 크기 제한
+ *
+ * 병합 로직:
+ * - NULL → 새로 저장
+ * - 단일 객체 → 배열 변환 후 추가
+ * - 배열 → 배열에 추가
+ *
+ * 크기 제한:
+ * - 배열 크기: 최대 100개, 초과 시 FIFO로 가장 오래된 항목 제거
+ * - 단일 객체: 최대 10KB, 초과 시 에러 반환
+ * - 전체 필드: 최대 1MB, 초과 시 자동 정리 (가장 오래된 항목부터 제거)
+ *
+ * @param existing - 기존 reflection_notes (조회 결과)
+ * @param newNotes - 새로 추가할 reflection_notes (문자열, 객체, 또는 배열)
+ * @returns 병합 결과
+ * @throws Error - 단일 객체 크기 초과 시
+ */
+export function mergeReflectionNotes(existing, newNotes) {
+    const warnings = [];
+    let removedCount = 0;
+    // 새로 추가할 reflection_notes를 배열로 변환
+    const newNotesArray = normalizeNewReflectionNotes(newNotes);
+    // 각 새 항목의 크기 검증
+    for (const item of newNotesArray) {
+        try {
+            validateSingleObjectSize(item);
+        }
+        catch (error) {
+            throw error; // 단일 객체 크기 초과는 즉시 에러 반환
+        }
+    }
+    // 기존 reflection_notes 처리
+    let merged;
+    if (existing.type === 'null') {
+        // NULL → 새로 저장
+        merged = newNotesArray;
+    }
+    else if (existing.type === 'object') {
+        // 단일 객체 → 배열 변환 후 추가
+        merged = [existing.value, ...newNotesArray];
+    }
+    else if (existing.type === 'array') {
+        // 배열 → 배열에 추가
+        merged = [...existing.value, ...newNotesArray];
+    }
+    else {
+        // 예상치 못한 타입
+        merged = newNotesArray;
+        warnings.push(`예상치 못한 기존 reflection_notes 타입: ${existing.type}`);
+    }
+    // 배열 크기 제한 적용
+    const sizeLimitResult = limitArraySize(merged);
+    merged = sizeLimitResult.limited;
+    removedCount += sizeLimitResult.removedCount;
+    if (sizeLimitResult.removedCount > 0) {
+        warnings.push(`배열 크기 제한: ${sizeLimitResult.removedCount}개 항목 제거됨 (최대 ${MAX_ARRAY_SIZE}개)`);
+    }
+    // 전체 필드 크기 검증 및 자동 정리
+    const sizeCleanupResult = validateAndCleanupTotalSize(merged);
+    merged = sizeCleanupResult.cleaned;
+    removedCount += sizeCleanupResult.removedCount;
+    if (sizeCleanupResult.removedCount > 0) {
+        warnings.push(`전체 필드 크기 제한: ${sizeCleanupResult.removedCount}개 항목 제거됨 (최대 ${MAX_TOTAL_FIELD_SIZE}바이트)`);
+    }
+    return {
+        merged,
+        removedCount,
+        warnings
+    };
+}
+/**
+ * 병합된 reflection_notes를 JSON 문자열로 변환
+ *
+ * @param merged - 병합된 배열
+ * @returns JSON 문자열
+ */
+export function serializeReflectionNotes(merged) {
+    // 배열이 1개인 경우 단일 객체로 저장 (Phase 1 호환성)
+    if (merged.length === 1) {
+        return JSON.stringify(merged[0]);
+    }
+    // 배열인 경우 배열로 저장
+    return JSON.stringify(merged);
+}
+//# sourceMappingURL=reflection-notes-merge.js.map

package/dist/utils/reflection-notes-merge.js.map

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

package/dist/utils/reflection-notes-normalize.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Reflection Notes JSON 정규화 유틸리티
+ *
+ * reflection_notes 필드를 FTS5 인덱싱을 위해 텍스트로 정규화하는 유틸리티 함수를 제공합니다.
+ * 트리거에서 사용되며, JSON 형식(단일 객체 또는 배열)을 FTS5 검색 가능한 텍스트로 변환합니다.
+ */
+/**
+ * reflection_notes JSON을 FTS5 인덱싱을 위해 텍스트로 정규화
+ *
+ * 정규화 규칙:
+ * - 단일 객체: 모든 값 필드를 추출하여 공백으로 구분된 단일 문자열로 병합
+ * - 배열: 각 요소의 모든 값 필드를 추출하여 공백으로 구분된 단일 문자열로 병합
+ * - 키 토큰 포함: failure_type, phase는 "key:value" 형식으로 포함
+ * - 제외 필드: timestamp는 제외
+ *
+ * 예시:
+ * - `{"failure_type": "tool_error", "failure_description": "API timeout"}`
+ *   → "type:tool_error API timeout"
+ * - `[{"failure_description": "API timeout"}, {"lessons_learned": "retry needed"}]`
+ *   → "API timeout retry needed"
+ *
+ * @param reflectionNotes - 정규화할 reflection_notes (JSON 문자열, 객체, 또는 배열)
+ * @returns 정규화된 텍스트 문자열 (FTS5 인덱싱용)
+ */
+export declare function normalizeReflectionNotes(reflectionNotes: string | null | undefined | any): string;
+/**
+ * 정규화된 텍스트에서 키 토큰 추출 (검색 쿼리 빌더용)
+ *
+ * @param normalizedText - 정규화된 텍스트
+ * @returns 키 토큰 배열 (예: ["type:tool_error", "phase:manual"])
+ */
+export declare function extractKeyTokens(normalizedText: string): string[];
+/**
+ * 검색 쿼리 예시 생성 (문서화용)
+ *
+ * @returns 검색 쿼리 예시 객체
+ */
+export declare function getSearchQueryExamples(): {
+    description: string;
+    query: string;
+    explanation: string;
+}[];
+//# sourceMappingURL=reflection-notes-normalize.d.ts.map

package/dist/utils/reflection-notes-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-notes-normalize.d.ts","sourceRoot":"","sources":["../../src/utils/reflection-notes-normalize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,GAAG,MAAM,CAmCjG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAUjE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,EAAE,CAuBF"}