memento-mcp-server 1.16.1-a → 1.16.2-a

package/dist/infrastructure/database/factories/core-memory-repository.factory.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Core Memory Repository Factory
+ * 환경 변수에 따라 적절한 구현체를 생성
+ */
+import Database from 'better-sqlite3';
+import type { CoreMemoryRepository } from '../../../domains/memory/repositories/core-memory-repository.interface.js';
+/**
+ * Core Memory Repository Factory 함수
+ *
+ * @param db - better-sqlite3 Database 객체
+ * @returns CoreMemoryRepository 인터페이스를 구현한 인스턴스
+ *
+ * @throws {Error} 지원되지 않는 데이터베이스 타입인 경우
+ * @throws {Error} PostgreSQL이 요청되었지만 아직 구현되지 않은 경우
+ */
+export declare function createCoreMemoryRepository(db: Database.Database): CoreMemoryRepository;
+//# sourceMappingURL=core-memory-repository.factory.d.ts.map

package/dist/infrastructure/database/factories/core-memory-repository.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-memory-repository.factory.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/database/factories/core-memory-repository.factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0EAA0E,CAAC;AAgBrH;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,oBAAoB,CAqBtF"}

package/dist/infrastructure/database/factories/core-memory-repository.factory.js

@@ -0,0 +1,43 @@
+/**
+ * Core Memory Repository Factory
+ * 환경 변수에 따라 적절한 구현체를 생성
+ */
+import Database from 'better-sqlite3';
+import { SqliteCoreMemoryAdapter } from '../adapters/sqlite-core-memory-adapter.js';
+import { CoreMemoryRepositorySqliteImpl } from '../repositories/core-memory-repository-sqlite.impl.js';
+/**
+ * 에러 메시지 상수
+ */
+const ERROR_MESSAGES = {
+    POSTGRES_NOT_AVAILABLE: 'PostgreSQL implementation is not yet available',
+    UNSUPPORTED_TYPE: (dbType) => `Unsupported database type: ${dbType}. Supported types: 'sqlite', 'postgres'`
+};
+/**
+ * Core Memory Repository Factory 함수
+ *
+ * @param db - better-sqlite3 Database 객체
+ * @returns CoreMemoryRepository 인터페이스를 구현한 인스턴스
+ *
+ * @throws {Error} 지원되지 않는 데이터베이스 타입인 경우
+ * @throws {Error} PostgreSQL이 요청되었지만 아직 구현되지 않은 경우
+ */
+export function createCoreMemoryRepository(db) {
+    // 환경 변수에서 DB_TYPE 읽기 (기본값: 'sqlite')
+    const dbType = (process.env.DB_TYPE || 'sqlite');
+    switch (dbType) {
+        case 'sqlite': {
+            // SQLite 구현체 생성
+            const adapter = new SqliteCoreMemoryAdapter(db);
+            return new CoreMemoryRepositorySqliteImpl(adapter);
+        }
+        case 'postgres': {
+            // PostgreSQL은 아직 구현되지 않음
+            throw new Error(ERROR_MESSAGES.POSTGRES_NOT_AVAILABLE);
+        }
+        default: {
+            // 지원되지 않는 데이터베이스 타입
+            throw new Error(ERROR_MESSAGES.UNSUPPORTED_TYPE(dbType));
+        }
+    }
+}
+//# sourceMappingURL=core-memory-repository.factory.js.map

package/dist/infrastructure/database/factories/core-memory-repository.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-memory-repository.factory.js","sourceRoot":"","sources":["../../../../src/infrastructure/database/factories/core-memory-repository.factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,8BAA8B,EAAE,MAAM,uDAAuD,CAAC;AAQvG;;GAEG;AACH,MAAM,cAAc,GAAG;IACrB,sBAAsB,EAAE,gDAAgD;IACxE,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE,CACnC,8BAA8B,MAAM,yCAAyC;CACvE,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,EAAqB;IAC9D,qCAAqC;IACrC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,QAAQ,CAAiB,CAAC;IAEjE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,gBAAgB;YAChB,MAAM,OAAO,GAAG,IAAI,uBAAuB,CAAC,EAAE,CAAC,CAAC;YAChD,OAAO,IAAI,8BAA8B,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,yBAAyB;YACzB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACR,oBAAoB;YACpB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/infrastructure/database/repositories/core-memory-repository-sqlite.impl.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Core Memory Repository SQLite 구현체
+ * CoreMemoryDatabaseConnection 인터페이스를 사용하여 구현
+ */
+import type { CoreMemoryRepository } from '../../../domains/memory/repositories/core-memory-repository.interface.js';
+import type { CoreMemoryRecord, CreateCoreMemoryInput, UpdateCoreMemoryInput } from '../../../domains/memory/repositories/core-memory-repository.interface.js';
+import type { CoreMemoryDatabaseConnection } from '../../../domains/memory/repositories/core-memory-database.interface.js';
+/**
+ * Core Memory Repository SQLite 구현체
+ */
+export declare class CoreMemoryRepositorySqliteImpl implements CoreMemoryRepository {
+    private db;
+    constructor(db: CoreMemoryDatabaseConnection);
+    /**
+     * Core Memory 생성
+     */
+    create(input: CreateCoreMemoryInput): Promise<CoreMemoryRecord>;
+    /**
+     * ID로 Core Memory 조회
+     */
+    findById(core_id: string): Promise<CoreMemoryRecord | null>;
+    /**
+     * agent_id와 key로 Core Memory 조회
+     */
+    findByKey(agent_id: string, key: string): Promise<CoreMemoryRecord | null>;
+    /**
+     * agent_id로 모든 Core Memory 조회
+     */
+    findByAgentId(agent_id: string): Promise<CoreMemoryRecord[]>;
+    /**
+     * always_load=true인 Core Memory 조회
+     */
+    findAlwaysLoad(agent_id?: string): Promise<CoreMemoryRecord[]>;
+    /**
+     * Core Memory 업데이트
+     */
+    update(core_id: string, input: UpdateCoreMemoryInput): Promise<CoreMemoryRecord | null>;
+    /**
+     * agent_id와 key로 Core Memory 업데이트
+     */
+    updateByKey(agent_id: string, key: string, input: UpdateCoreMemoryInput): Promise<CoreMemoryRecord | null>;
+    /**
+     * Core Memory 삭제
+     */
+    delete(core_id: string): Promise<boolean>;
+    /**
+     * agent_id와 key로 Core Memory 삭제
+     */
+    deleteByKey(agent_id: string, key: string): Promise<boolean>;
+    /**
+     * agent_id로 모든 Core Memory 삭제
+     */
+    deleteByAgentId(agent_id: string): Promise<number>;
+    /**
+     * 모든 Core Memory 조회 (관리용)
+     */
+    findAll(): Promise<CoreMemoryRecord[]>;
+    /**
+     * Core Memory 개수 조회
+     */
+    count(agent_id?: string): Promise<number>;
+}
+//# sourceMappingURL=core-memory-repository-sqlite.impl.d.ts.map

package/dist/infrastructure/database/repositories/core-memory-repository-sqlite.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-memory-repository-sqlite.impl.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/database/repositories/core-memory-repository-sqlite.impl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0EAA0E,CAAC;AACrH,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,0EAA0E,CAAC;AAClF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wEAAwE,CAAC;AAY3H;;GAEG;AACH,qBAAa,8BAA+B,YAAW,oBAAoB;IACzE,OAAO,CAAC,EAAE,CAA+B;gBAE7B,EAAE,EAAE,4BAA4B;IAI5C;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuBrE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAwBjE;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAwBhF;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAqBlE;;OAEG;IACG,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAyCpE;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAqC7F;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAqCnC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/C;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlE;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAoB5C;;OAEG;IACG,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAYhD"}

package/dist/infrastructure/database/repositories/core-memory-repository-sqlite.impl.js

@@ -0,0 +1,281 @@
+/**
+ * Core Memory Repository SQLite 구현체
+ * CoreMemoryDatabaseConnection 인터페이스를 사용하여 구현
+ */
+/**
+ * always_load 불리언 변환 헬퍼 함수
+ */
+function convertAlwaysLoad(record) {
+    return {
+        ...record,
+        always_load: Boolean(record.always_load)
+    };
+}
+/**
+ * Core Memory Repository SQLite 구현체
+ */
+export class CoreMemoryRepositorySqliteImpl {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Core Memory 생성
+     */
+    async create(input) {
+        const { core_id, agent_id = 'default', key, value, always_load = false, origin_source = null } = input;
+        const stmt = await this.db.prepare(`
+      INSERT INTO core_memory (core_id, agent_id, key, value, always_load, origin_source, version)
+      VALUES (?, ?, ?, ?, ?, ?, 1)
+    `);
+        await stmt.run(core_id, agent_id, key, value, always_load ? 1 : 0, origin_source);
+        const result = await this.findById(core_id);
+        if (!result) {
+            throw new Error(`Failed to create core memory with id: ${core_id}`);
+        }
+        return result;
+    }
+    /**
+     * ID로 Core Memory 조회
+     */
+    async findById(core_id) {
+        const stmt = await this.db.prepare(`
+      SELECT 
+        core_id,
+        agent_id,
+        key,
+        value,
+        always_load,
+        origin_source,
+        version,
+        created_at,
+        updated_at
+      FROM core_memory
+      WHERE core_id = ?
+    `);
+        const result = await stmt.get(core_id);
+        if (!result) {
+            return null;
+        }
+        return convertAlwaysLoad(result);
+    }
+    /**
+     * agent_id와 key로 Core Memory 조회
+     */
+    async findByKey(agent_id, key) {
+        const stmt = await this.db.prepare(`
+      SELECT 
+        core_id,
+        agent_id,
+        key,
+        value,
+        always_load,
+        origin_source,
+        version,
+        created_at,
+        updated_at
+      FROM core_memory
+      WHERE agent_id = ? AND key = ?
+    `);
+        const result = await stmt.get(agent_id, key);
+        if (!result) {
+            return null;
+        }
+        return convertAlwaysLoad(result);
+    }
+    /**
+     * agent_id로 모든 Core Memory 조회
+     */
+    async findByAgentId(agent_id) {
+        const stmt = await this.db.prepare(`
+      SELECT 
+        core_id,
+        agent_id,
+        key,
+        value,
+        always_load,
+        origin_source,
+        version,
+        created_at,
+        updated_at
+      FROM core_memory
+      WHERE agent_id = ?
+      ORDER BY created_at ASC
+    `);
+        const results = await stmt.all(agent_id);
+        return results.map(convertAlwaysLoad);
+    }
+    /**
+     * always_load=true인 Core Memory 조회
+     */
+    async findAlwaysLoad(agent_id) {
+        const query = agent_id
+            ? `
+        SELECT 
+          core_id,
+          agent_id,
+          key,
+          value,
+          always_load,
+          origin_source,
+          version,
+          created_at,
+          updated_at
+        FROM core_memory
+        WHERE always_load = 1 AND agent_id = ?
+        ORDER BY created_at ASC
+      `
+            : `
+        SELECT 
+          core_id,
+          agent_id,
+          key,
+          value,
+          always_load,
+          origin_source,
+          version,
+          created_at,
+          updated_at
+        FROM core_memory
+        WHERE always_load = 1
+        ORDER BY created_at ASC
+      `;
+        const stmt = await this.db.prepare(query);
+        const results = agent_id
+            ? await stmt.all(agent_id)
+            : await stmt.all();
+        return results.map(convertAlwaysLoad);
+    }
+    /**
+     * Core Memory 업데이트
+     */
+    async update(core_id, input) {
+        const updates = [];
+        const values = [];
+        if (input.value !== undefined) {
+            updates.push('value = ?');
+            values.push(input.value);
+        }
+        if (input.always_load !== undefined) {
+            updates.push('always_load = ?');
+            values.push(input.always_load ? 1 : 0);
+        }
+        if (input.origin_source !== undefined) {
+            updates.push('origin_source = ?');
+            values.push(input.origin_source);
+        }
+        if (updates.length === 0) {
+            return this.findById(core_id);
+        }
+        // version = version + 1 추가 (항상 증가)
+        updates.push('version = version + 1');
+        values.push(core_id);
+        const stmt = await this.db.prepare(`
+      UPDATE core_memory
+      SET ${updates.join(', ')}
+      WHERE core_id = ?
+    `);
+        await stmt.run(...values);
+        return this.findById(core_id);
+    }
+    /**
+     * agent_id와 key로 Core Memory 업데이트
+     */
+    async updateByKey(agent_id, key, input) {
+        const updates = [];
+        const values = [];
+        if (input.value !== undefined) {
+            updates.push('value = ?');
+            values.push(input.value);
+        }
+        if (input.always_load !== undefined) {
+            updates.push('always_load = ?');
+            values.push(input.always_load ? 1 : 0);
+        }
+        if (input.origin_source !== undefined) {
+            updates.push('origin_source = ?');
+            values.push(input.origin_source);
+        }
+        if (updates.length === 0) {
+            return this.findByKey(agent_id, key);
+        }
+        // version = version + 1 추가 (항상 증가)
+        updates.push('version = version + 1');
+        values.push(agent_id, key);
+        const stmt = await this.db.prepare(`
+      UPDATE core_memory
+      SET ${updates.join(', ')}
+      WHERE agent_id = ? AND key = ?
+    `);
+        await stmt.run(...values);
+        return this.findByKey(agent_id, key);
+    }
+    /**
+     * Core Memory 삭제
+     */
+    async delete(core_id) {
+        const stmt = await this.db.prepare(`
+      DELETE FROM core_memory
+      WHERE core_id = ?
+    `);
+        const result = await stmt.run(core_id);
+        return result.changes > 0;
+    }
+    /**
+     * agent_id와 key로 Core Memory 삭제
+     */
+    async deleteByKey(agent_id, key) {
+        const stmt = await this.db.prepare(`
+      DELETE FROM core_memory
+      WHERE agent_id = ? AND key = ?
+    `);
+        const result = await stmt.run(agent_id, key);
+        return result.changes > 0;
+    }
+    /**
+     * agent_id로 모든 Core Memory 삭제
+     */
+    async deleteByAgentId(agent_id) {
+        const stmt = await this.db.prepare(`
+      DELETE FROM core_memory
+      WHERE agent_id = ?
+    `);
+        const result = await stmt.run(agent_id);
+        return result.changes;
+    }
+    /**
+     * 모든 Core Memory 조회 (관리용)
+     */
+    async findAll() {
+        const stmt = await this.db.prepare(`
+      SELECT 
+        core_id,
+        agent_id,
+        key,
+        value,
+        always_load,
+        origin_source,
+        version,
+        created_at,
+        updated_at
+      FROM core_memory
+      ORDER BY agent_id, created_at ASC
+    `);
+        const results = await stmt.all();
+        return results.map(convertAlwaysLoad);
+    }
+    /**
+     * Core Memory 개수 조회
+     */
+    async count(agent_id) {
+        const query = agent_id
+            ? 'SELECT COUNT(*) as count FROM core_memory WHERE agent_id = ?'
+            : 'SELECT COUNT(*) as count FROM core_memory';
+        const stmt = await this.db.prepare(query);
+        const result = agent_id
+            ? await stmt.get(agent_id)
+            : await stmt.get();
+        return result.count;
+    }
+}
+//# sourceMappingURL=core-memory-repository-sqlite.impl.js.map

package/dist/infrastructure/database/repositories/core-memory-repository-sqlite.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-memory-repository-sqlite.impl.js","sourceRoot":"","sources":["../../../../src/infrastructure/database/repositories/core-memory-repository-sqlite.impl.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/database/wal-checkpoint-scheduler.d.ts

@@ -0,0 +1,166 @@
+/**
+ * WAL Checkpoint Scheduler
+ * SQLite WAL 파일의 주기적 체크포인트를 관리하는 스케줄러
+ *
+ * 클린코드 원칙:
+ * - 단일 책임 원칙: WAL 체크포인트 스케줄링만 담당
+ * - 명확한 인터페이스: CheckpointMode enum과 CheckpointResult interface로 명확한 타입 정의
+ */
+/**
+ * 체크포인트 모드
+ * - PASSIVE: 다른 연결이 읽기 중이면 체크포인트를 건너뜀 (성능 영향 최소화)
+ * - TRUNCATE: WAL 파일을 완전히 제거 (디스크 공간 절약)
+ * - FULL: 모든 페이지를 메인 DB로 이동 후 WAL 파일 제거 (장기 트랜잭션이 없을 때만 사용)
+ */
+export declare enum CheckpointMode {
+    PASSIVE = "PASSIVE",
+    TRUNCATE = "TRUNCATE",
+    FULL = "FULL"
+}
+/**
+ * 체크포인트 실행 결과
+ */
+export interface CheckpointResult {
+    /**
+     * 체크포인트 모드
+     */
+    mode: CheckpointMode;
+    /**
+     * 성공 여부
+     */
+    success: boolean;
+    /**
+     * WAL 파일의 페이지 수
+     */
+    log: number;
+    /**
+     * 체크포인트된 페이지 수
+     */
+    checkpointed: number;
+    /**
+     * 락 상태 (1: 락, 0: 정상)
+     */
+    busy: number;
+    /**
+     * 에러 (실패 시)
+     */
+    error?: Error;
+}
+/**
+ * WAL 체크포인트 스케줄러 설정
+ */
+export interface WalCheckpointSchedulerConfig {
+    /**
+     * 체크포인트 실행 주기 (밀리초)
+     * 기본값: 5분 (300000ms)
+     */
+    intervalMs: number;
+    /**
+     * WAL 파일 크기 경고 임계값 (바이트)
+     * 기본값: 16MB (16777216 bytes)
+     */
+    walSizeWarningThreshold: number;
+    /**
+     * WAL 파일 크기 위험 임계값 (바이트)
+     * 기본값: 24MB (25165824 bytes)
+     */
+    walSizeDangerThreshold: number;
+    /**
+     * 전용 커넥션 사용 여부
+     * 기본값: true
+     * true인 경우 체크포인트 전용 연결을 생성하여 메인 연결과 분리
+     */
+    useDedicatedConnection: boolean;
+    /**
+     * 최대 재시도 횟수
+     * 기본값: 3
+     */
+    maxRetries: number;
+    /**
+     * 재시도 백오프 시간 (밀리초)
+     * 기본값: 1000ms
+     * 지수 백오프의 기본 단위로 사용됨 (1초, 2초, 4초)
+     */
+    retryBackoffMs: number;
+}
+/**
+ * Logger 인터페이스
+ */
+export interface Logger {
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * PerformanceMonitor 인터페이스
+ */
+export interface PerformanceMonitor {
+    recordMetric(name: string, value: number): void;
+    incrementCounter(name: string): void;
+}
+import Database from 'better-sqlite3';
+/**
+ * WAL 체크포인트 스케줄러 클래스
+ * SQLite WAL 파일의 주기적 체크포인트를 관리
+ */
+export declare class WalCheckpointScheduler {
+    private mainDb;
+    private config;
+    private logger?;
+    private performanceMonitor?;
+    private intervalId;
+    private isRunning;
+    private dedicatedConnection;
+    private checkpointInProgress;
+    constructor(mainDb: Database.Database, config: WalCheckpointSchedulerConfig, logger?: Logger | undefined, performanceMonitor?: PerformanceMonitor | undefined);
+    /**
+     * 스케줄러 시작 (idempotent)
+     */
+    start(): void;
+    /**
+     * 스케줄러 중지 (idempotent, 비동기)
+     */
+    stop(): Promise<void>;
+    /**
+     * 즉시 체크포인트 실행
+     * @param mode 체크포인트 모드 (기본값: TRUNCATE)
+     * @returns 체크포인트 실행 결과
+     */
+    checkpointNow(mode?: CheckpointMode): Promise<CheckpointResult>;
+    /**
+     * 체크포인트 실행 (재시도 로직 포함)
+     * busy=1인 경우 실패로 간주하여 재시도 수행
+     * 동시 실행 방지: checkpointInProgress 플래그로 중첩 실행 방지
+     *
+     * @param mode 체크포인트 모드
+     * @returns 체크포인트 실행 결과
+     */
+    private checkpoint;
+    /**
+     * 주기적 체크포인트 스케줄링
+     * 동시 실행 방지: checkpointInProgress 플래그로 중첩 실행 방지
+     */
+    private scheduleCheckpoint;
+    /**
+     * 대기 함수 (지수 백오프용)
+     * @param ms 대기 시간 (밀리초)
+     */
+    private sleep;
+    /**
+     * 체크포인트 실행 (실제 SQL 실행)
+     * better-sqlite3의 pragma는 기본적으로 배열을 반환함
+     *
+     * @param db 데이터베이스 연결
+     * @param mode 체크포인트 모드
+     * @returns 체크포인트 실행 결과
+     */
+    private executeCheckpoint;
+    /**
+     * WAL 파일 크기 조회
+     * 파일 시스템 API를 통한 크기 조회 (읽기 전용, 락 유발 없음)
+     *
+     * @returns WAL 파일 크기 (바이트), 파일이 없거나 에러 발생 시 0 반환
+     */
+    private getWalFileSize;
+}
+//# sourceMappingURL=wal-checkpoint-scheduler.d.ts.map

package/dist/infrastructure/database/wal-checkpoint-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wal-checkpoint-scheduler.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/database/wal-checkpoint-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;GAGG;AACH,qBAAa,sBAAsB;IAO/B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,kBAAkB,CAAC;IAT7B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,oBAAoB,CAAkB;gBAGpC,MAAM,EAAE,QAAQ,CAAC,QAAQ,EACzB,MAAM,EAAE,4BAA4B,EACpC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,kBAAkB,CAAC,EAAE,kBAAkB,YAAA;IAGjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAuBb;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B;;;;OAIG;IACG,aAAa,CAAC,IAAI,GAAE,cAAwC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9F;;;;;;;OAOG;YACW,UAAU;IA0GxB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;OAGG;IACH,OAAO,CAAC,KAAK;IAIb;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;;;;OAKG;YACW,cAAc;CAY7B"}