a2a-memory 0.1.2 → 0.6.0

package/dist/sync/encryption.js

@@ -0,0 +1,203 @@
+/**
+ * E2E Encryption Module
+ *
+ * AES-256-GCM 대칭 암호화를 사용하여 메모리 content/embedding 보호
+ * Node.js 내장 crypto 모듈만 사용 (외부 의존성 없음)
+ */
+import { randomBytes, createCipheriv, createDecipheriv, pbkdf2Sync } from 'node:crypto';
+// ============================================================
+// Constants
+// ============================================================
+const ALGORITHM = 'aes-256-gcm';
+const KEY_LENGTH = 32; // 256 bits
+const IV_LENGTH = 12; // GCM recommended IV length
+const TAG_LENGTH = 16; // GCM auth tag length
+const SALT_LENGTH = 16;
+const PBKDF2_ITERATIONS = 100000;
+const PBKDF2_DIGEST = 'sha512';
+// ============================================================
+// Key Management
+// ============================================================
+/**
+ * 랜덤 암호화 키 생성 (32 bytes)
+ */
+export function generateEncryptionKey() {
+    return randomBytes(KEY_LENGTH);
+}
+/**
+ * PBKDF2로 사용자 비밀번호에서 키 유도
+ * @param password - 사용자 입력 비밀번호
+ * @param salt - 선택적 salt (재현성 필요 시 제공)
+ * @returns 키와 salt
+ */
+export function deriveKey(password, salt) {
+    const actualSalt = salt ?? randomBytes(SALT_LENGTH);
+    const key = pbkdf2Sync(password, actualSalt, PBKDF2_ITERATIONS, KEY_LENGTH, PBKDF2_DIGEST);
+    return {
+        key,
+        salt: actualSalt,
+    };
+}
+// ============================================================
+// Content Encryption
+// ============================================================
+/**
+ * 텍스트 암호화 (AES-256-GCM)
+ * @param plaintext - 원본 텍스트
+ * @param key - 32 bytes 암호화 키
+ * @returns 암호화된 페이로드
+ */
+export function encryptContent(plaintext, key) {
+    if (key.length !== KEY_LENGTH) {
+        throw new Error(`암호화 키는 ${KEY_LENGTH} bytes여야 합니다 (현재: ${key.length})`);
+    }
+    const iv = randomBytes(IV_LENGTH);
+    const cipher = createCipheriv(ALGORITHM, key, iv);
+    const plaintextBuffer = Buffer.from(plaintext, 'utf-8');
+    const encrypted = Buffer.concat([
+        cipher.update(plaintextBuffer),
+        cipher.final(),
+    ]);
+    const tag = cipher.getAuthTag();
+    return {
+        ciphertext: encrypted.toString('base64'),
+        iv: iv.toString('base64'),
+        tag: tag.toString('base64'),
+    };
+}
+/**
+ * 텍스트 복호화 (AES-256-GCM)
+ * @param encrypted - 암호화된 페이로드
+ * @param key - 32 bytes 암호화 키
+ * @returns 원본 텍스트
+ * @throws 키가 잘못되었거나 데이터가 변조된 경우
+ */
+export function decryptContent(encrypted, key) {
+    if (key.length !== KEY_LENGTH) {
+        throw new Error(`암호화 키는 ${KEY_LENGTH} bytes여야 합니다 (현재: ${key.length})`);
+    }
+    const iv = Buffer.from(encrypted.iv, 'base64');
+    const ciphertext = Buffer.from(encrypted.ciphertext, 'base64');
+    const tag = Buffer.from(encrypted.tag, 'base64');
+    const decipher = createDecipheriv(ALGORITHM, key, iv);
+    decipher.setAuthTag(tag);
+    try {
+        const decrypted = Buffer.concat([
+            decipher.update(ciphertext),
+            decipher.final(),
+        ]);
+        return decrypted.toString('utf-8');
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`복호화 실패: ${error.message} (잘못된 키 또는 데이터 변조)`);
+        }
+        throw error;
+    }
+}
+// ============================================================
+// Embedding Encryption
+// ============================================================
+/**
+ * 임베딩 벡터 암호화
+ * @param embedding - number[] 벡터
+ * @param key - 32 bytes 암호화 키
+ * @returns base64 암호화된 문자열
+ */
+export function encryptEmbedding(embedding, key) {
+    // Float64Array로 변환하여 바이너리 직렬화
+    const float64Array = new Float64Array(embedding);
+    const buffer = Buffer.from(float64Array.buffer);
+    const iv = randomBytes(IV_LENGTH);
+    const cipher = createCipheriv(ALGORITHM, key, iv);
+    const encrypted = Buffer.concat([
+        cipher.update(buffer),
+        cipher.final(),
+    ]);
+    const tag = cipher.getAuthTag();
+    // iv + tag + ciphertext를 하나의 버퍼로 결합
+    const combined = Buffer.concat([iv, tag, encrypted]);
+    return combined.toString('base64');
+}
+/**
+ * 임베딩 벡터 복호화
+ * @param encrypted - base64 암호화된 문자열
+ * @param key - 32 bytes 암호화 키
+ * @returns number[] 벡터
+ */
+export function decryptEmbedding(encrypted, key) {
+    const combined = Buffer.from(encrypted, 'base64');
+    // iv (12) + tag (16) + ciphertext
+    if (combined.length < IV_LENGTH + TAG_LENGTH) {
+        throw new Error('암호화된 임베딩 데이터가 너무 짧습니다');
+    }
+    const iv = combined.subarray(0, IV_LENGTH);
+    const tag = combined.subarray(IV_LENGTH, IV_LENGTH + TAG_LENGTH);
+    const ciphertext = combined.subarray(IV_LENGTH + TAG_LENGTH);
+    const decipher = createDecipheriv(ALGORITHM, key, iv);
+    decipher.setAuthTag(tag);
+    try {
+        const decrypted = Buffer.concat([
+            decipher.update(ciphertext),
+            decipher.final(),
+        ]);
+        // Buffer를 Float64Array로 변환
+        const float64Array = new Float64Array(decrypted.buffer, decrypted.byteOffset, decrypted.byteLength / Float64Array.BYTES_PER_ELEMENT);
+        return Array.from(float64Array);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`임베딩 복호화 실패: ${error.message}`);
+        }
+        throw error;
+    }
+}
+// ============================================================
+// Utilities
+// ============================================================
+/**
+ * EncryptedPayload 검증
+ */
+export function isValidEncryptedPayload(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const payload = obj;
+    return (typeof payload.ciphertext === 'string' &&
+        typeof payload.iv === 'string' &&
+        typeof payload.tag === 'string');
+}
+/**
+ * 암호화된 컨텐츠를 JSON으로 래핑
+ */
+export function wrapEncryptedContent(encrypted) {
+    return JSON.stringify({
+        encrypted: true,
+        data: encrypted.ciphertext,
+        iv: encrypted.iv,
+        tag: encrypted.tag,
+    });
+}
+/**
+ * JSON에서 암호화된 컨텐츠 추출
+ */
+export function unwrapEncryptedContent(wrapped) {
+    try {
+        const parsed = JSON.parse(wrapped);
+        if (parsed.encrypted !== true)
+            return null;
+        if (typeof parsed.data !== 'string' ||
+            typeof parsed.iv !== 'string' ||
+            typeof parsed.tag !== 'string') {
+            return null;
+        }
+        return {
+            ciphertext: parsed.data,
+            iv: parsed.iv,
+            tag: parsed.tag,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=encryption.js.map

package/dist/sync/encryption.js.map

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

package/dist/sync/index.d.ts

@@ -5,4 +5,13 @@ export { A2AClient } from './client.js';
 export type { A2AClientConfig, RemoteMemory } from './client.js';
 export { MemorySynchronizer } from './synchronizer.js';
 export type { SyncResult } from './synchronizer.js';
+export { SyncQueue, mapCategory, mapTier } from './queue.js';
+export type { QueueFlushResult, FlushOptions } from './queue.js';
+export { LocalVectorClock } from './vector-clock.js';
+export { TeamSynchronizer } from './team-synchronizer.js';
+export type { TeamSyncResult, TeamSyncStatus } from './team-synchronizer.js';
+export { SyncScheduler } from './scheduler.js';
+export type { SyncSchedulerOptions, SyncSchedulerStatus } from './scheduler.js';
+export { encryptContent, decryptContent, encryptEmbedding, decryptEmbedding, deriveKey, generateEncryptionKey, wrapEncryptedContent, unwrapEncryptedContent, isValidEncryptedPayload, } from './encryption.js';
+export type { EncryptedPayload, EncryptionConfig, KeyDerivationResult, } from './encryption.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/sync/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGhF,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/sync/index.js

@@ -3,4 +3,10 @@
  */
 export { A2AClient } from './client.js';
 export { MemorySynchronizer } from './synchronizer.js';
+export { SyncQueue, mapCategory, mapTier } from './queue.js';
+export { LocalVectorClock } from './vector-clock.js';
+export { TeamSynchronizer } from './team-synchronizer.js';
+export { SyncScheduler } from './scheduler.js';
+// Encryption
+export { encryptContent, decryptContent, encryptEmbedding, decryptEmbedding, deriveKey, generateEncryptionKey, wrapEncryptedContent, unwrapEncryptedContent, isValidEncryptedPayload, } from './encryption.js';
 //# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,aAAa;AACb,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}

package/dist/sync/queue.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Write-Behind Sync Queue
+ *
+ * 로컬 DB에 저장된 메모리를 원격 서버로 일괄 push합니다.
+ * 로컬 DB = 캐시, 원격 서버 = Single Source of Truth.
+ */
+import type { MemoryDatabase } from '../db/database.js';
+import type { A2AClient } from './client.js';
+import type { MemoryCategory, MemoryTier } from '../types/index.js';
+export interface QueueFlushResult {
+    pushed: number;
+    failed: number;
+    errors: string[];
+    duration: number;
+}
+export interface FlushOptions {
+    timeoutMs?: number;
+    maxRetries?: number;
+}
+/**
+ * 로컬 category를 서버 호환 category로 변환
+ */
+export declare function mapCategory(category: string): MemoryCategory;
+/**
+ * 로컬 tier를 서버 호환 tier로 변환
+ */
+export declare function mapTier(tier: string): MemoryTier;
+export declare class SyncQueue {
+    private db;
+    private client;
+    constructor(db: MemoryDatabase, client: A2AClient);
+    /**
+     * 메모리를 sync 대기 상태로 설정 (~1ms)
+     */
+    enqueue(memoryId: string): void;
+    /**
+     * pending 메모리를 일괄 push
+     */
+    flush(options?: FlushOptions): Promise<QueueFlushResult>;
+    /**
+     * 대기 중인 메모리 수
+     */
+    getPendingCount(): number;
+    /**
+     * 재시도 포함 push (exponential backoff)
+     */
+    private retryPush;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/sync/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/sync/queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAU,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAE5D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEhD;AAED,qBAAa,SAAS;IAElB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,MAAM;gBADN,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,SAAS;IAG3B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0C9D;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;YACW,SAAS;CAuBxB"}

package/dist/sync/queue.js

@@ -0,0 +1,112 @@
+/**
+ * Write-Behind Sync Queue
+ *
+ * 로컬 DB에 저장된 메모리를 원격 서버로 일괄 push합니다.
+ * 로컬 DB = 캐시, 원격 서버 = Single Source of Truth.
+ */
+// ============================================================
+// Category/Tier 매핑 (로컬 레거시 → 서버 호환)
+// ============================================================
+const CATEGORY_MAP = {
+    preference: 'convention',
+};
+const TIER_MAP = {
+    procedural: 'semantic',
+};
+/**
+ * 로컬 category를 서버 호환 category로 변환
+ */
+export function mapCategory(category) {
+    return (CATEGORY_MAP[category] ?? category);
+}
+/**
+ * 로컬 tier를 서버 호환 tier로 변환
+ */
+export function mapTier(tier) {
+    return (TIER_MAP[tier] ?? tier);
+}
+export class SyncQueue {
+    db;
+    client;
+    constructor(db, client) {
+        this.db = db;
+        this.client = client;
+    }
+    /**
+     * 메모리를 sync 대기 상태로 설정 (~1ms)
+     */
+    enqueue(memoryId) {
+        this.db.setSyncStatus(memoryId, null, 'pending');
+    }
+    /**
+     * pending 메모리를 일괄 push
+     */
+    async flush(options) {
+        const startTime = Date.now();
+        const timeoutMs = options?.timeoutMs ?? 5000;
+        const maxRetries = options?.maxRetries ?? 3;
+        const result = {
+            pushed: 0,
+            failed: 0,
+            errors: [],
+            duration: 0,
+        };
+        const pending = this.db.getPendingSyncMemories();
+        if (pending.length === 0) {
+            result.duration = Date.now() - startTime;
+            return result;
+        }
+        for (const memory of pending) {
+            // 타임아웃 체크
+            if (Date.now() - startTime > timeoutMs) {
+                result.errors.push(`타임아웃: ${result.pushed}/${pending.length} 처리 완료`);
+                result.failed += pending.length - result.pushed - result.failed;
+                break;
+            }
+            try {
+                const remoteMemory = await this.retryPush(memory, maxRetries);
+                this.db.setSyncStatus(memory.id, remoteMemory.id, 'synced');
+                result.pushed++;
+            }
+            catch (error) {
+                result.failed++;
+                if (error instanceof Error) {
+                    result.errors.push(`메모리 ${memory.id} push 실패: ${error.message}`);
+                }
+            }
+        }
+        result.duration = Date.now() - startTime;
+        return result;
+    }
+    /**
+     * 대기 중인 메모리 수
+     */
+    getPendingCount() {
+        return this.db.getPendingSyncMemories().length;
+    }
+    /**
+     * 재시도 포함 push (exponential backoff)
+     */
+    async retryPush(memory, maxRetries = 3) {
+        let lastError = null;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                return await this.client.createMemory({
+                    content: memory.content,
+                    category: mapCategory(memory.category),
+                    tier: mapTier(memory.tier),
+                    tags: memory.tags,
+                });
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt < maxRetries - 1) {
+                    const delay = Math.min(1000 * Math.pow(2, attempt), 30000);
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                }
+            }
+        }
+        throw lastError;
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/sync/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/sync/queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,+DAA+D;AAC/D,oCAAoC;AACpC,+DAA+D;AAE/D,MAAM,YAAY,GAAmC;IACnD,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF,MAAM,QAAQ,GAA+B;IAC3C,UAAU,EAAE,UAAU;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAmB,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAe,CAAC;AAChD,CAAC;AAED,MAAM,OAAO,SAAS;IAEV;IACA;IAFV,YACU,EAAkB,EAClB,MAAiB;QADjB,OAAE,GAAF,EAAE,CAAgB;QAClB,WAAM,GAAN,MAAM,CAAW;IACxB,CAAC;IAEJ;;OAEG;IACH,OAAO,CAAC,QAAgB;QACtB,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,OAAsB;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;QAC7C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAqB;YAC/B,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,CAAC;SACZ,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACzC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,UAAU;YACV,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;gBACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC;gBACrE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gBAChE,MAAM;YACR,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAE9D,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;gBAC5D,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;oBAC3B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,EAAE,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC,MAAM,CAAC;IACjD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,SAAS,CACrB,MAAc,EACd,aAAqB,CAAC;QAEtB,IAAI,SAAS,GAAiB,IAAI,CAAC;QACnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;oBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;oBACtC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;oBAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtE,IAAI,OAAO,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;oBAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;oBAC3D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,SAAU,CAAC;IACnB,CAAC;CACF"}

package/dist/sync/scheduler.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Sync Scheduler
+ *
+ * 주기적으로 MemorySynchronizer.sync()를 실행하는 스케줄러.
+ * CLI `sync --watch` 또는 라이브러리로 사용 가능.
+ */
+import type { MemorySynchronizer, SyncResult } from './synchronizer.js';
+import type { HookLogger } from '../utils/logger.js';
+export interface SyncSchedulerOptions {
+    /** 동기화 주기 (ms). 기본: 1800000 (30분). 0이면 비활성 */
+    intervalMs: number;
+    /** 시작 시 즉시 sync 실행 여부. 기본: true */
+    syncOnStart?: boolean;
+    /** sync 완료 콜백 */
+    onSync?: (result: SyncResult) => void;
+    /** 에러 콜백 */
+    onError?: (error: Error) => void;
+}
+export interface SyncSchedulerStatus {
+    running: boolean;
+    syncing: boolean;
+    syncCount: number;
+    lastSyncAt: string | null;
+    lastResult: SyncResult | null;
+    intervalMs: number;
+    nextSyncAt: string | null;
+}
+export declare class SyncScheduler {
+    private synchronizer;
+    private options;
+    private logger?;
+    private timer;
+    private running;
+    private syncing;
+    private syncCount;
+    private lastSyncAt;
+    private lastResult;
+    private startedAt;
+    constructor(synchronizer: MemorySynchronizer, options: SyncSchedulerOptions, logger?: HookLogger | undefined);
+    /**
+     * 스케줄러 시작
+     */
+    start(): Promise<void>;
+    /**
+     * 스케줄러 중지
+     */
+    stop(): void;
+    /**
+     * 실행 중 여부
+     */
+    isRunning(): boolean;
+    /**
+     * 현재 sync 중 여부
+     */
+    isSyncing(): boolean;
+    /**
+     * 스케줄러 상태
+     */
+    getStatus(): SyncSchedulerStatus;
+    /**
+     * 수동으로 즉시 sync 실행 (스케줄러 타이머와 무관)
+     */
+    syncNow(): Promise<SyncResult | null>;
+    /**
+     * 한 번의 sync 사이클
+     */
+    private tick;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/sync/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/sync/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB;IACjB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,YAAY;IACZ,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,qBAAa,aAAa;IAUtB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM,CAAC;IAXjB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,SAAS,CAAqB;gBAG5B,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,CAAC,EAAE,UAAU,YAAA;IAG7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAYZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,SAAS,IAAI,mBAAmB;IAqBhC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI3C;;OAEG;YACW,IAAI;CAgCnB"}

package/dist/sync/scheduler.js

@@ -0,0 +1,140 @@
+/**
+ * Sync Scheduler
+ *
+ * 주기적으로 MemorySynchronizer.sync()를 실행하는 스케줄러.
+ * CLI `sync --watch` 또는 라이브러리로 사용 가능.
+ */
+export class SyncScheduler {
+    synchronizer;
+    options;
+    logger;
+    timer = null;
+    running = false;
+    syncing = false;
+    syncCount = 0;
+    lastSyncAt = null;
+    lastResult = null;
+    startedAt = null;
+    constructor(synchronizer, options, logger) {
+        this.synchronizer = synchronizer;
+        this.options = options;
+        this.logger = logger;
+    }
+    /**
+     * 스케줄러 시작
+     */
+    async start() {
+        if (this.running) {
+            this.logger?.warn('Scheduler already running');
+            return;
+        }
+        if (this.options.intervalMs <= 0) {
+            this.logger?.warn('Scheduler disabled (intervalMs <= 0)');
+            return;
+        }
+        this.running = true;
+        this.startedAt = new Date();
+        this.logger?.info('Scheduler started', { intervalMs: this.options.intervalMs });
+        // 시작 시 즉시 sync (기본 동작)
+        if (this.options.syncOnStart !== false) {
+            await this.tick();
+        }
+        this.timer = setInterval(() => {
+            this.tick().catch((err) => {
+                this.logger?.error('Scheduler tick error', err instanceof Error ? err : new Error(String(err)));
+            });
+        }, this.options.intervalMs);
+        // unref: Node.js 프로세스가 타이머 때문에 종료되지 않는 것을 방지
+        if (this.timer && typeof this.timer === 'object' && 'unref' in this.timer) {
+            this.timer.unref();
+        }
+    }
+    /**
+     * 스케줄러 중지
+     */
+    stop() {
+        if (!this.running)
+            return;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.running = false;
+        this.logger?.info('Scheduler stopped', { syncCount: this.syncCount });
+    }
+    /**
+     * 실행 중 여부
+     */
+    isRunning() {
+        return this.running;
+    }
+    /**
+     * 현재 sync 중 여부
+     */
+    isSyncing() {
+        return this.syncing;
+    }
+    /**
+     * 스케줄러 상태
+     */
+    getStatus() {
+        let nextSyncAt = null;
+        if (this.running && this.lastSyncAt) {
+            const next = new Date(this.lastSyncAt.getTime() + this.options.intervalMs);
+            nextSyncAt = next.toISOString();
+        }
+        else if (this.running && this.startedAt) {
+            const next = new Date(this.startedAt.getTime() + this.options.intervalMs);
+            nextSyncAt = next.toISOString();
+        }
+        return {
+            running: this.running,
+            syncing: this.syncing,
+            syncCount: this.syncCount,
+            lastSyncAt: this.lastSyncAt?.toISOString() ?? null,
+            lastResult: this.lastResult,
+            intervalMs: this.options.intervalMs,
+            nextSyncAt,
+        };
+    }
+    /**
+     * 수동으로 즉시 sync 실행 (스케줄러 타이머와 무관)
+     */
+    async syncNow() {
+        return this.tick();
+    }
+    /**
+     * 한 번의 sync 사이클
+     */
+    async tick() {
+        if (this.syncing) {
+            this.logger?.debug('Sync already in progress, skipping');
+            return null;
+        }
+        this.syncing = true;
+        try {
+            const result = await this.synchronizer.sync();
+            this.syncCount++;
+            this.lastSyncAt = new Date();
+            this.lastResult = result;
+            this.logger?.info('Sync completed', {
+                pushed: result.pushed,
+                pulled: result.pulled,
+                errors: result.errors.length,
+                duration: result.duration,
+            });
+            this.options.onSync?.(result);
+            return result;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.logger?.error('Sync failed', err);
+            this.options.onError?.(err);
+            return null;
+        }
+        finally {
+            this.syncing = false;
+        }
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/sync/scheduler.js.map

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