a2a-memory 0.1.2 → 0.5.0

package/dist/hooks/session-start.js

@@ -2,45 +2,173 @@
  * SessionStart Hook
  *
  * Claude Code 세션 시작 시 실행됩니다.
- * 현재 프로젝트에 관련된 메모리를 검색하여 stdout으로 출력합니다.
- * Claude Code는 stdout 출력을 컨텍스트에 주입합니다.
+ * Progressive Disclosure: compact 인덱스 모드로 출력합니다.
+ * 상세 내용은 CLI `a2a-memory search`로 확인 가능.
  */
-import { MemoryDatabase } from '../db/database.js';
+import { basename } from 'node:path';
+import { getSharedDb, closeSharedDb } from './shared.js';
 import { ConfigManager } from '../config/manager.js';
+import { A2AClient } from '../sync/client.js';
+import { MemorySynchronizer } from '../sync/synchronizer.js';
+import { deduplicateByEmbedding } from '../extraction/similarity.js';
+import { HybridRanker } from '../search/ranker.js';
+/**
+ * 프로젝트 경로에서 검색 쿼리 생성
+ */
+function buildSearchQuery(projectPath) {
+    const name = basename(projectPath);
+    // 하이픈/언더스코어로 분리하여 키워드 생성
+    const keywords = name.split(/[-_.]/).filter((k) => k.length > 1);
+    return keywords.join(' ');
+}
+/**
+ * 메모리 content의 첫 줄 요약 (최대 80자)
+ */
+function summarize(content, maxLen = 80) {
+    const firstLine = content.split('\n')[0].trim();
+    if (firstLine.length <= maxLen)
+        return firstLine;
+    return firstLine.slice(0, maxLen - 1) + '…';
+}
 export async function handleSessionStart(context) {
     const config = new ConfigManager().load();
     if (!config.autoInject.enabled) {
         return '';
     }
-    const db = new MemoryDatabase(config.db.path);
+    const db = getSharedDb(config.db.path);
     try {
-        db.initialize();
-        const results = db.search({
-            query: context.projectPath,
-            limit: config.autoInject.maxMemories,
-        });
+        // 백그라운드 pull (fire-and-forget)
+        if (config.autoSync.enabled && config.autoSync.pullOnSessionStart && config.server.apiKey) {
+            const client = new A2AClient({
+                baseUrl: config.server.url,
+                apiKey: config.server.apiKey,
+                timeout: config.autoSync.timeoutMs,
+            });
+            if (config.mode === 'team' && config.team) {
+                // 팀 모드: TeamSynchronizer로 pull
+                try {
+                    const { TeamSynchronizer } = await import('../sync/team-synchronizer.js');
+                    const teamSync = new TeamSynchronizer(db, client, config.team.teamPath, config.team.nodeId);
+                    teamSync.pullFromTeam().catch(() => {
+                        // 팀 pull 실패 무시
+                    });
+                }
+                catch {
+                    // TeamSynchronizer 미설치 시 무시
+                }
+            }
+            else {
+                const synchronizer = new MemorySynchronizer(db, client);
+                synchronizer.pull().catch(() => {
+                    // 백그라운드 pull 실패 무시 — 로컬 캐시로 서비스
+                });
+            }
+        }
+        const limit = config.autoInject.maxMemories;
+        let results = [];
+        // 1차: FTS 검색 (프로젝트명 기반)
+        const query = buildSearchQuery(context.projectPath);
+        const ftsResults = query ? db.search({ query, limit }) : [];
+        // 2차: 임베딩 활성 시 하이브리드 검색
+        if (config.embedding?.enabled) {
+            try {
+                const { createEmbeddingProvider } = await import('../embedding/index.js');
+                const provider = createEmbeddingProvider(config.embedding, config.llm);
+                // 쿼리 임베딩 생성 (동기/비동기 대응)
+                const queryText = query || basename(context.projectPath);
+                const queryEmbedding = await Promise.resolve(provider.embed(queryText));
+                // 벡터 검색
+                const vectorResults = db.searchByVector(queryEmbedding, limit);
+                // 최근 메모리
+                const recentMemories = db.listMemories({ limit, projectPath: context.projectPath });
+                // HybridRanker로 통합
+                const ranker = new HybridRanker();
+                const ranked = ranker.rank(ftsResults, vectorResults, recentMemories);
+                results = ranked.slice(0, limit).map(r => ({
+                    memory: r.memory,
+                    score: r.score,
+                    matchType: 'hybrid',
+                }));
+            }
+            catch {
+                // 임베딩 실패 시 FTS 결과만 사용
+                results = ftsResults;
+            }
+        }
+        else {
+            // 임베딩 비활성 시: 기존 FTS 검색 + 벡터 폴백 유지 (하위호환)
+            results = ftsResults;
+            // FTS 결과 부족 시 벡터 검색 폴백
+            if (results.length < limit) {
+                try {
+                    // 최근 메모리에서 임베딩 기반 보충
+                    const allMemories = db.listMemories({ limit: limit * 2, projectPath: context.projectPath });
+                    const withEmbedding = allMemories.filter((m) => m.embedding && m.embedding.length > 0);
+                    if (withEmbedding.length > 0) {
+                        // 이미 결과에 있는 ID 제외
+                        const existingIds = new Set(results.map((r) => r.memory.id));
+                        const additional = withEmbedding
+                            .filter((m) => !existingIds.has(m.id))
+                            .slice(0, limit - results.length)
+                            .map((m) => ({
+                            memory: m,
+                            score: 0.5, // 벡터 폴백 기본 점수
+                            matchType: 'vector',
+                        }));
+                        results.push(...additional);
+                    }
+                }
+                catch {
+                    // 벡터 검색 실패 무시
+                }
+            }
+        }
         if (results.length === 0) {
             return '';
         }
+        // 코사인 중복 제거 (임베딩 있을 때)
+        const memories = results.map((r) => r.memory);
+        const deduped = deduplicateByEmbedding(memories);
+        const dedupedIds = new Set(deduped.map((m) => m.id));
+        const dedupedResults = results.filter((r) => dedupedIds.has(r.memory.id));
+        // 점수 내림차순 정렬
+        dedupedResults.sort((a, b) => b.score - a.score);
+        // Compact 인덱스 모드 출력
         const lines = [
             '<!-- A2A Memory Context -->',
-            `<!-- ${results.length} relevant memories for ${context.projectPath} -->`,
+            `<!-- ${dedupedResults.length} relevant memories for ${context.projectPath} -->`,
+            '',
         ];
-        let totalTokens = 0;
-        for (const result of results) {
-            const estimatedTokens = Math.ceil(result.memory.content.length / 4);
-            if (totalTokens + estimatedTokens > config.autoInject.maxTokens)
-                break;
-            lines.push('');
-            lines.push(`### [${result.memory.category}] (score: ${result.score.toFixed(2)})`);
-            lines.push(result.memory.content);
-            totalTokens += estimatedTokens;
+        for (let i = 0; i < Math.min(dedupedResults.length, limit); i++) {
+            const { memory, score } = dedupedResults[i];
+            lines.push(`${i + 1}. [${memory.category}] (${score.toFixed(2)}) ${summarize(memory.content)}`);
         }
+        // 팀 메모리 검색 (team 모드)
+        if (config.mode === 'team' && config.team && config.server.apiKey) {
+            try {
+                const teamClient = new A2AClient({
+                    baseUrl: config.server.url,
+                    apiKey: config.server.apiKey,
+                    timeout: config.autoSync.timeoutMs,
+                });
+                const teamMemories = await teamClient.searchTeamMemories(config.team.teamPath, query, { limit: Math.min(3, limit) });
+                for (let i = 0; i < teamMemories.length; i++) {
+                    const tm = teamMemories[i];
+                    lines.push(`${dedupedResults.length + i + 1}. [Team][${tm.category}] ${summarize(tm.content)}`);
+                }
+            }
+            catch {
+                // 팀 검색 실패 무시
+            }
+        }
+        lines.push('');
+        lines.push('💡 Use `a2a-memory search <query>` for full details.');
+        lines.push('');
         lines.push('<!-- /A2A Memory Context -->');
         return lines.join('\n');
     }
     finally {
-        db.close();
+        // DB는 싱글톤으로 관리 — close하지 않음
     }
 }
 /**
@@ -54,6 +182,7 @@ export async function main() {
     }
     const input = Buffer.concat(chunks).toString('utf-8').trim();
     if (!input) {
+        closeSharedDb();
         process.exit(0);
     }
     try {
@@ -63,10 +192,13 @@ export async function main() {
             process.stdout.write(output);
         }
     }
-    catch {
-        // 에러 시 조용히 종료 (Claude Code 세션 차단 방지)
+    catch (err) {
+        console.error('[a2a] SessionStart error:', err instanceof Error ? err.message : err);
         process.exit(0);
     }
+    finally {
+        closeSharedDb();
+    }
 }
 // 직접 실행 시에만 main() 호출
 const isMainModule = process.argv[1]?.endsWith('session-start.js') ||

package/dist/hooks/session-start.js.map

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

package/dist/hooks/shared.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Hook 공유 유틸리티
+ * 프로세스 내 DB 싱글톤으로 중복 초기화 방지
+ */
+import { MemoryDatabase } from '../db/database.js';
+/**
+ * 프로세스 내 DB 싱글톤 조회/생성
+ */
+export declare function getSharedDb(dbPath: string): MemoryDatabase;
+/**
+ * DB 종료 (프로세스 종료 시 호출)
+ */
+export declare function closeSharedDb(): void;
+/**
+ * 테스트용 리셋
+ */
+export declare function resetSharedDb(): void;
+//# sourceMappingURL=shared.d.ts.map

package/dist/hooks/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/hooks/shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKnD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAW1D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}

package/dist/hooks/shared.js

@@ -0,0 +1,46 @@
+/**
+ * Hook 공유 유틸리티
+ * 프로세스 내 DB 싱글톤으로 중복 초기화 방지
+ */
+import { MemoryDatabase } from '../db/database.js';
+let _sharedDb = null;
+let _sharedDbPath = null;
+/**
+ * 프로세스 내 DB 싱글톤 조회/생성
+ */
+export function getSharedDb(dbPath) {
+    if (_sharedDb && _sharedDbPath === dbPath) {
+        return _sharedDb;
+    }
+    if (_sharedDb) {
+        try {
+            _sharedDb.close();
+        }
+        catch { /* ignore */ }
+    }
+    _sharedDb = new MemoryDatabase(dbPath);
+    _sharedDbPath = dbPath;
+    _sharedDb.initialize();
+    return _sharedDb;
+}
+/**
+ * DB 종료 (프로세스 종료 시 호출)
+ */
+export function closeSharedDb() {
+    if (_sharedDb) {
+        try {
+            _sharedDb.close();
+        }
+        catch { /* ignore */ }
+        _sharedDb = null;
+        _sharedDbPath = null;
+    }
+}
+/**
+ * 테스트용 리셋
+ */
+export function resetSharedDb() {
+    _sharedDb = null;
+    _sharedDbPath = null;
+}
+//# sourceMappingURL=shared.js.map

package/dist/hooks/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/hooks/shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,IAAI,SAAS,GAA0B,IAAI,CAAC;AAC5C,IAAI,aAAa,GAAkB,IAAI,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,IAAI,SAAS,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IACD,SAAS,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,aAAa,GAAG,MAAM,CAAC;IACvB,SAAS,CAAC,UAAU,EAAE,CAAC;IACvB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACjD,SAAS,GAAG,IAAI,CAAC;QACjB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,SAAS,GAAG,IAAI,CAAC;IACjB,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -1,17 +1,26 @@
 /**
  * A2A Memory Plugin - Public API
  */
-export type { Memory, MemoryCreateInput, MemorySearchOptions, MemorySearchResult, MemoryCategory, MemoryTier, SessionMessage, SessionContentBlock, SessionInfo, ExtractionResult, A2AConfig, HookContext, SessionStartContext, PostToolUseContext, SessionEndContext, SignificanceSignal, SignificanceResult, } from './types/index.js';
+export type { Memory, MemoryCreateInput, MemorySearchOptions, MemorySearchResult, MemoryCategory, MemoryTier, SessionMessage, SessionContentBlock, SessionInfo, ExtractionResult, A2AConfig, TeamConfig, LLMConfig, EmbeddingConfig, LifecycleConfig, MemoryQuality, VectorClockState, HookContext, SessionStartContext, PostToolUseContext, SessionEndContext, SignificanceSignal, SignificanceResult, } from './types/index.js';
 export { DEFAULT_CONFIG, SENSITIVE_PATTERNS } from './types/index.js';
 export { MemoryDatabase } from './db/database.js';
-export { ConfigManager } from './config/manager.js';
+export { ConfigManager, generateNodeId, getConfigManager, resetConfigManager } from './config/manager.js';
 export { parseSessionFile, findSessionFiles, getSessionMessages } from './session/parser.js';
-export { extractMemories } from './extraction/extractor.js';
+export { extractMemories, extractMemoriesWithLLM, summarizeSession } from './extraction/extractor.js';
 export { scoreSignificance } from './extraction/scorer.js';
 export { filterSensitiveInfo, isSensitivePath } from './extraction/filter.js';
 export { handleSessionStart } from './hooks/session-start.js';
 export { handlePostToolUse } from './hooks/post-tool-use.js';
 export { handleSessionEnd } from './hooks/session-end.js';
-export { A2AClient, MemorySynchronizer } from './sync/index.js';
-export type { A2AClientConfig, RemoteMemory, SyncResult } from './sync/index.js';
+export { getSharedDb, closeSharedDb, resetSharedDb } from './hooks/shared.js';
+export { A2AClient, MemorySynchronizer, SyncQueue, LocalVectorClock, TeamSynchronizer, mapCategory, mapTier, } from './sync/index.js';
+export type { A2AClientConfig, RemoteMemory, SyncResult, QueueFlushResult, FlushOptions, TeamSyncResult, TeamSyncStatus, } from './sync/index.js';
+export { createLLMClient, OpenAILLMClient, AnthropicLLMClient, NoOpLLMClient } from './llm/index.js';
+export type { LLMClient } from './llm/index.js';
+export { createEmbeddingProvider, LocalEmbeddingProvider, OpenAIEmbeddingProvider } from './embedding/index.js';
+export type { EmbeddingProvider } from './embedding/index.js';
+export { HybridRanker } from './search/index.js';
+export type { RankedResult } from './search/index.js';
+export { scoreQuality, cleanupMemories } from './lifecycle/index.js';
+export type { CleanupResult } from './lifecycle/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,MAAM,EACN,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,MAAM,EACN,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC1G,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG9E,OAAO,EACL,SAAS,EAAE,kBAAkB,EAAE,SAAS,EACxC,gBAAgB,EAAE,gBAAgB,EAClC,WAAW,EAAE,OAAO,GACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,eAAe,EAAE,YAAY,EAAE,UAAU,EACzC,gBAAgB,EAAE,YAAY,EAC9B,cAAc,EAAE,cAAc,GAC/B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrG,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAChH,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -4,15 +4,24 @@
 export { DEFAULT_CONFIG, SENSITIVE_PATTERNS } from './types/index.js';
 // Core modules
 export { MemoryDatabase } from './db/database.js';
-export { ConfigManager } from './config/manager.js';
+export { ConfigManager, generateNodeId, getConfigManager, resetConfigManager } from './config/manager.js';
 export { parseSessionFile, findSessionFiles, getSessionMessages } from './session/parser.js';
-export { extractMemories } from './extraction/extractor.js';
+export { extractMemories, extractMemoriesWithLLM, summarizeSession } from './extraction/extractor.js';
 export { scoreSignificance } from './extraction/scorer.js';
 export { filterSensitiveInfo, isSensitivePath } from './extraction/filter.js';
 // Hooks
 export { handleSessionStart } from './hooks/session-start.js';
 export { handlePostToolUse } from './hooks/post-tool-use.js';
 export { handleSessionEnd } from './hooks/session-end.js';
+export { getSharedDb, closeSharedDb, resetSharedDb } from './hooks/shared.js';
 // Sync
-export { A2AClient, MemorySynchronizer } from './sync/index.js';
+export { A2AClient, MemorySynchronizer, SyncQueue, LocalVectorClock, TeamSynchronizer, mapCategory, mapTier, } from './sync/index.js';
+// LLM
+export { createLLMClient, OpenAILLMClient, AnthropicLLMClient, NoOpLLMClient } from './llm/index.js';
+// Embedding
+export { createEmbeddingProvider, LocalEmbeddingProvider, OpenAIEmbeddingProvider } from './embedding/index.js';
+// Search
+export { HybridRanker } from './search/index.js';
+// Lifecycle
+export { scoreQuality, cleanupMemories } from './lifecycle/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtE,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9E,QAAQ;AACR,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO;AACP,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6BH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtE,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC1G,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9E,QAAQ;AACR,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO;AACP,OAAO,EACL,SAAS,EAAE,kBAAkB,EAAE,SAAS,EACxC,gBAAgB,EAAE,gBAAgB,EAClC,WAAW,EAAE,OAAO,GACrB,MAAM,iBAAiB,CAAC;AAOzB,MAAM;AACN,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGrG,YAAY;AACZ,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAGhH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/lifecycle/cleanup.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Memory Cleanup
+ *
+ * TTL 및 품질 기반 메모리 정리를 수행합니다.
+ */
+import type { LifecycleConfig } from '../types/index.js';
+import type { MemoryDatabase } from '../db/database.js';
+export interface CleanupResult {
+    expired: number;
+    lowQuality: number;
+    total: number;
+}
+/**
+ * TTL 및 품질 기반 메모리 정리를 수행합니다.
+ *
+ * 정리 순서:
+ * 1. TTL 초과 메모리 삭제 (ttlDays > 0인 경우)
+ * 2. 메모리 개수 초과 시 품질 미달 메모리 삭제
+ *
+ * @param db - 메모리 데이터베이스
+ * @param config - 라이프사이클 설정
+ * @returns 정리 결과
+ */
+export declare function cleanupMemories(db: MemoryDatabase, config: LifecycleConfig): CleanupResult;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/lifecycle/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/lifecycle/cleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,eAAe,GACtB,aAAa,CAsCf"}

package/dist/lifecycle/cleanup.js

@@ -0,0 +1,52 @@
+/**
+ * Memory Cleanup
+ *
+ * TTL 및 품질 기반 메모리 정리를 수행합니다.
+ */
+import { scoreQuality } from './quality-scorer.js';
+/**
+ * TTL 및 품질 기반 메모리 정리를 수행합니다.
+ *
+ * 정리 순서:
+ * 1. TTL 초과 메모리 삭제 (ttlDays > 0인 경우)
+ * 2. 메모리 개수 초과 시 품질 미달 메모리 삭제
+ *
+ * @param db - 메모리 데이터베이스
+ * @param config - 라이프사이클 설정
+ * @returns 정리 결과
+ */
+export function cleanupMemories(db, config) {
+    let expired = 0;
+    let lowQuality = 0;
+    // 1. TTL 초과 메모리 삭제
+    if (config.ttlDays > 0) {
+        const oldMemories = db.getMemoriesOlderThan(config.ttlDays);
+        if (oldMemories.length > 0) {
+            const ids = oldMemories.map((m) => m.id);
+            expired = db.deleteMemories(ids);
+        }
+    }
+    // 2. 메모리 개수 초과 시 품질 미달 메모리 삭제
+    const currentCount = db.getMemoryCount();
+    if (currentCount > config.maxMemories) {
+        // 모든 메모리의 품질 점수 계산
+        const allMemories = db.listMemories({ limit: currentCount });
+        const scoredMemories = allMemories.map((memory) => ({
+            memory,
+            quality: scoreQuality(memory, config),
+        }));
+        // 품질 미달 메모리 필터링
+        const toDelete = scoredMemories
+            .filter((item) => item.quality.overall < config.qualityThreshold)
+            .map((item) => item.memory.id);
+        if (toDelete.length > 0) {
+            lowQuality = db.deleteMemories(toDelete);
+        }
+    }
+    return {
+        expired,
+        lowQuality,
+        total: expired + lowQuality,
+    };
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/lifecycle/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/lifecycle/cleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQnD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAkB,EAClB,MAAuB;IAEvB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,mBAAmB;IACnB,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzC,OAAO,GAAG,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,YAAY,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;IACzC,IAAI,YAAY,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACtC,mBAAmB;QACnB,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QAC7D,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClD,MAAM;YACN,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC;SACtC,CAAC,CAAC,CAAC;QAEJ,gBAAgB;QAChB,MAAM,QAAQ,GAAG,cAAc;aAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC;aAChE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEjC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,UAAU,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,UAAU;QACV,KAAK,EAAE,OAAO,GAAG,UAAU;KAC5B,CAAC;AACJ,CAAC"}

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Lifecycle Module
+ *
+ * 메모리 라이프사이클 관리:
+ * - 품질 점수 계산
+ * - TTL 및 품질 기반 정리
+ */
+export { scoreQuality } from './quality-scorer.js';
+export type { MemoryQuality } from '../types/index.js';
+export { cleanupMemories } from './cleanup.js';
+export type { CleanupResult } from './cleanup.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/lifecycle/index.js

@@ -0,0 +1,10 @@
+/**
+ * Lifecycle Module
+ *
+ * 메모리 라이프사이클 관리:
+ * - 품질 점수 계산
+ * - TTL 및 품질 기반 정리
+ */
+export { scoreQuality } from './quality-scorer.js';
+export { cleanupMemories } from './cleanup.js';
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/lifecycle/quality-scorer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Memory Quality Scorer
+ *
+ * 메모리 품질 점수를 계산합니다.
+ * - relevance: 검색 빈도 기반 (access_count)
+ * - freshness: 시간 기반 감쇠 (exponential decay)
+ * - usage: 접근 횟수 정규화
+ * - overall: 가중 평균 (0.4 * relevance + 0.3 * freshness + 0.3 * usage)
+ */
+import type { Memory, MemoryQuality, LifecycleConfig } from '../types/index.js';
+/**
+ * 메모리의 품질 점수를 계산합니다.
+ *
+ * @param memory - 평가할 메모리
+ * @param _config - 라이프사이클 설정 (현재는 미사용, 향후 확장용)
+ * @returns 품질 점수 객체 (0~1 범위)
+ */
+export declare function scoreQuality(memory: Memory, _config: LifecycleConfig): MemoryQuality;
+//# sourceMappingURL=quality-scorer.d.ts.map

package/dist/lifecycle/quality-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-scorer.d.ts","sourceRoot":"","sources":["../../src/lifecycle/quality-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,aAAa,CA0BpF"}

package/dist/lifecycle/quality-scorer.js

@@ -0,0 +1,40 @@
+/**
+ * Memory Quality Scorer
+ *
+ * 메모리 품질 점수를 계산합니다.
+ * - relevance: 검색 빈도 기반 (access_count)
+ * - freshness: 시간 기반 감쇠 (exponential decay)
+ * - usage: 접근 횟수 정규화
+ * - overall: 가중 평균 (0.4 * relevance + 0.3 * freshness + 0.3 * usage)
+ */
+/**
+ * 메모리의 품질 점수를 계산합니다.
+ *
+ * @param memory - 평가할 메모리
+ * @param _config - 라이프사이클 설정 (현재는 미사용, 향후 확장용)
+ * @returns 품질 점수 객체 (0~1 범위)
+ */
+export function scoreQuality(memory, _config) {
+    // 1. Relevance: 검색 빈도 기반 (access_count / 10으로 정규화, 최대 1.0)
+    const relevance = Math.min(1.0, memory.accessCount / 10);
+    // 2. Freshness: 시간 기반 감쇠 (exponential decay)
+    // freshness = exp(-lambda * daysSinceUpdate)
+    // lambda = 0.01 (100일 후 약 0.37)
+    const lambda = 0.01;
+    const updatedAt = new Date(memory.updatedAt);
+    const now = new Date();
+    const daysSinceUpdate = (now.getTime() - updatedAt.getTime()) / (1000 * 60 * 60 * 24);
+    const freshness = Math.exp(-lambda * daysSinceUpdate);
+    // 3. Usage: access_count를 정규화 (relevance와 동일 로직)
+    const usage = Math.min(1.0, memory.accessCount / 10);
+    // 4. Overall: 가중 평균
+    // 40% relevance + 30% freshness + 30% usage
+    const overall = 0.4 * relevance + 0.3 * freshness + 0.3 * usage;
+    return {
+        relevance,
+        freshness,
+        usage,
+        overall,
+    };
+}
+//# sourceMappingURL=quality-scorer.js.map

package/dist/lifecycle/quality-scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-scorer.js","sourceRoot":"","sources":["../../src/lifecycle/quality-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAAwB;IACnE,2DAA2D;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;IAEzD,6CAA6C;IAC7C,6CAA6C;IAC7C,gCAAgC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IAEtD,iDAAiD;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;IAErD,oBAAoB;IACpB,4CAA4C;IAC5C,MAAM,OAAO,GAAG,GAAG,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS,GAAG,GAAG,GAAG,KAAK,CAAC;IAEhE,OAAO;QACL,SAAS;QACT,SAAS;QACT,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/llm/client.d.ts

@@ -0,0 +1,37 @@
+/**
+ * LLM Client — AI 기반 분류/요약
+ * npm 의존성 없음, native fetch 사용
+ */
+import type { LLMConfig } from '../types/index.js';
+export interface LLMClient {
+    complete(prompt: string, systemPrompt?: string): Promise<string>;
+    summarize(contents: string[]): Promise<string>;
+    classify(content: string, categories: string[]): Promise<string>;
+}
+export declare class OpenAILLMClient implements LLMClient {
+    private apiKey;
+    private model;
+    private maxTokens;
+    private timeout;
+    constructor(config: LLMConfig);
+    complete(prompt: string, systemPrompt?: string): Promise<string>;
+    summarize(contents: string[]): Promise<string>;
+    classify(content: string, categories: string[]): Promise<string>;
+}
+export declare class AnthropicLLMClient implements LLMClient {
+    private apiKey;
+    private model;
+    private maxTokens;
+    private timeout;
+    constructor(config: LLMConfig);
+    complete(prompt: string, systemPrompt?: string): Promise<string>;
+    summarize(contents: string[]): Promise<string>;
+    classify(content: string, categories: string[]): Promise<string>;
+}
+export declare class NoOpLLMClient implements LLMClient {
+    complete(): Promise<string>;
+    summarize(): Promise<string>;
+    classify(_content: string, categories: string[]): Promise<string>;
+}
+export declare function createLLMClient(config?: LLMConfig): LLMClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/llm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/llm/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClE;AAED,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,SAAS;IAQvB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6ChE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAUvE;AAED,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,SAAS;IAQvB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA4ChE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAUvE;AAED,qBAAa,aAAc,YAAW,SAAS;IACvC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAG3B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAG5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAGxE;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAa7D"}