a2a-memory 0.5.0 → 0.7.0

package/README.md

@@ -1,15 +1,37 @@
-# a2a-memory
+# @a2a/memory - Persistent AI Memory for Claude Code
+
+> v0.6.0 — Local-first memory system with server sync, team collaboration, and intelligent search
 
 Persistent AI memory for Claude Code. Automatically captures, stores, and retrieves knowledge across coding sessions.
 
 ## Features
 
-- **Session Extraction** - Extract memories from existing Claude Code sessions (JSONL)
-- **Local-First DB** - SQLite-based offline storage with FTS5 full-text search
+### Core Capabilities
+- **Session Extraction** - Extract memories from Claude Code sessions (JSONL parsing)
+- **Local-First DB** - SQLite with FTS5 full-text search + vector similarity
 - **Auto-Capture Hooks** - Claude Code hooks for automatic memory capture
-- **Context Injection** - Automatically inject relevant memories at session start
-- **Server Sync** - Optional synchronization with A2A server for team sharing
-- **Sensitive Info Filter** - Automatic redaction of API keys, passwords, tokens
+- **Context Injection** - Inject relevant memories at session start (hybrid search)
+- **Hybrid Search** - FTS + Vector + Recency ranking (Reciprocal Rank Fusion)
+- **Lifecycle Management** - Quality scoring, TTL-based cleanup, memory tiering (Hot/Warm/Cold)
+
+### AI & Embeddings
+- **LLM Integration** - AI-powered extraction and classification (OpenAI, Anthropic)
+- **Embeddings** - Local TF-IDF (64D) or OpenAI (1536D) embeddings
+- **Vector Quantization** - Float32 and Int8 scalar quantization for compression
+
+### Team & Sync
+- **Server Sync** - Synchronize with A2A server via REST API
+- **Team Collaboration** - Share memories across team members (CRDT vector clocks)
+- **E2E Encryption** - AES-256-GCM encryption for sensitive content
+- **Scheduled Sync** - Automatic periodic sync with configurable interval
+- **OS Keychain** - Secure API key storage (macOS/Linux/Windows)
+
+### Developer Experience
+- **CLAUDE.md Sync** - Sync CLAUDE.md sections to memory DB
+- **CLI (16 commands)** - Full command-line interface for all operations
+- **Logging** - JSON Lines hook logs with rotation and level filtering
+- **i18n** - Internationalization support (Korean, English)
+- **Sensitive Info Filter** - Auto-redaction of API keys, passwords, tokens (21 patterns)
 
 ## Quick Start
 
@@ -28,44 +50,77 @@ a2a-memory status
 
 # Search memories
 a2a-memory search "authentication error"
+
+# Health check
+a2a-memory health
 ```
 
-## Commands
+## CLI Commands
 
-| Command | Description |
-|---------|-------------|
-| `a2a-memory setup` | Initialize plugin, create DB, register Claude Code hooks |
-| `a2a-memory status` | Show memory count, DB size, category breakdown |
-| `a2a-memory extract` | Extract memories from Claude Code session files |
-| `a2a-memory search <query>` | Full-text search across all memories |
-| `a2a-memory list` | List stored memories with filters |
-| `a2a-memory config` | View and modify configuration |
-| `a2a-memory sync` | Synchronize with A2A server (team mode) |
+| Command | Description | Options |
+|---------|-------------|---------|
+| `a2a-memory setup` | Initialize plugin, create DB, register hooks | - |
+| `a2a-memory status` | Show memory count, DB size, category breakdown | - |
+| `a2a-memory extract` | Extract memories from session files | `--limit <n>`, `--project <path>` |
+| `a2a-memory search <query>` | Hybrid search across all memories | `--limit <n>`, `--category <cat>` |
+| `a2a-memory list` | List memories with category/tier filters | `--category`, `--tier`, `--limit` |
+| `a2a-memory add` | Manually add a memory (interactive) | - |
+| `a2a-memory edit <id>` | Edit an existing memory (interactive) | - |
+| `a2a-memory rm <id>` | Delete a memory | - |
+| `a2a-memory config` | View and modify configuration | `get <key>`, `set <key> <value>` |
+| `a2a-memory sync` | Synchronize with A2A server | `--push`, `--pull`, `--watch`, `--interval <ms>` |
+| `a2a-memory team` | Team memory management | `join <teamId>`, `sync`, `members` |
+| `a2a-memory embed` | Manage embeddings | `generate`, `stats` |
+| `a2a-memory cleanup` | Remove low-quality/expired memories | `--dry-run` |
+| `a2a-memory health` | System health check (DB, config, logs) | `--verbose` |
+| `a2a-memory claude-sync` | Sync CLAUDE.md to memory DB | `--dry-run`, `--force` |
 
-## How It Works
+## Architecture
 
-### 1. Session Extraction
-Parses `~/.claude/projects/<project>/<session>.jsonl` files and extracts:
-- **Error Solutions** - Error + resolution pairs
-- **Code Patterns** - Repeated tool usage patterns
-- **Decisions** - Architectural decisions with reasoning
-- **Context** - Project background and rules
-- **Preferences** - Development style and conventions
+### 1. Claude Code Hooks
 
-### 2. Claude Code Hooks
 After `a2a-memory setup`, three hooks are registered:
 
-| Hook | Trigger | Action |
-|------|---------|--------|
-| **SessionStart** | Session begins | Injects relevant memories into context |
-| **PostToolUse** | After Write/Edit/Bash | Auto-captures significant actions |
-| **SessionEnd** | Session ends | Extracts and stores session summary |
+| Hook | Trigger | Action | Features |
+|------|---------|--------|----------|
+| **SessionStart** | Session begins | Injects relevant memories via hybrid search | Team memory pull, context injection |
+| **PostToolUse** | After Write/Edit/Bash | Auto-captures significant actions | Significance scoring, sensitive info filtering |
+| **SessionEnd** | Session ends | Extracts memories + optional team sync | Session summarization, team push, scheduled sync |
+
+### 2. Memory Extraction
+
+Parses `~/.claude/projects/<project>/<session>.jsonl` files and extracts:
+
+| Category | Examples |
+|----------|---------|
+| `error_solution` | Error + resolution pairs |
+| `code_pattern` | Repeated tool usage patterns |
+| `decision` | Architectural decisions with reasoning |
+| `project_knowledge` | Project context and rules |
+| `convention` | Development conventions and preferences |
+
+### 3. Hybrid Search
+
+Three-signal Reciprocal Rank Fusion (RRF):
+
+```
+Score = w1 * FTS_rank + w2 * Vector_similarity + w3 * Recency_score
+```
+
+- **FTS**: SQLite FTS5 full-text search
+- **Vector**: TF-IDF (local, 64D) or OpenAI (1536D) embeddings
+- **Recency**: Time decay scoring
+
+### 4. Storage & Indexing
 
-### 3. Local Storage
-- SQLite database at `~/.a2a/memory.db`
-- FTS5 full-text search
-- WAL mode for concurrent access
-- Automatic sensitive info filtering
+- **SQLite database** at `~/.a2a/memory.db`
+  - FTS5 full-text search index
+  - Vector embeddings table (with quantization support)
+  - WAL mode for concurrent access
+  - Sync status tracking with CRDT vector clocks
+- **Memory Tiering**: Hot (0-7 days), Warm (8-30 days), Cold (30+ days)
+- **Vector Quantization**: Float32 (50% reduction), Int8 (75% reduction)
+- **E2E Encryption**: AES-256-GCM with PBKDF2 key derivation
 
 ## Configuration
 
@@ -84,31 +139,193 @@ Config file: `~/.a2a/config.json`
     "maxMemories": 5,
     "maxTokens": 2000
   },
+  "autoSync": {
+    "enabled": false,
+    "pushOnSessionEnd": true,
+    "pullOnSessionStart": true,
+    "timeoutMs": 10000,
+    "intervalMs": 1800000
+  },
   "db": {
     "path": "~/.a2a/memory.db",
     "maxSizeMB": 100
+  },
+  "embedding": {
+    "provider": "local",
+    "dimensions": 64
+  },
+  "lifecycle": {
+    "enabled": true,
+    "maxMemories": 10000,
+    "ttlDays": { "working": 7, "episodic": 90 },
+    "minQualityScore": 0.3
+  },
+  "logging": {
+    "enabled": false,
+    "level": "info",
+    "outputDir": "~/.a2a/logs",
+    "maxFileSizeMB": 10,
+    "maxFiles": 3
   }
 }
 ```
 
-### Enable Auto-Capture
-```bash
-a2a-memory config set autoCapture.enabled true
-```
+### Server Sync
 
-### Server Sync (Team Mode)
 ```bash
 # Configure server
 a2a-memory config set server.url https://your-a2a-server.com
 a2a-memory config set server.apiKey your-api-key
 
-# Sync
-a2a-memory sync           # bidirectional
-a2a-memory sync --push    # local → remote
-a2a-memory sync --pull    # remote → local
-a2a-memory sync --status  # check sync status
+# One-time sync
+a2a-memory sync --push    # local -> remote
+a2a-memory sync --pull    # remote -> local
+
+# Continuous sync (every 30 min)
+a2a-memory sync --watch
+a2a-memory sync --watch --interval 60000  # every 60s
+```
+
+### Team Mode
+
+```bash
+# Join a team
+a2a-memory team join my-team
+
+# Sync team memories
+a2a-memory team sync
+
+# List team members
+a2a-memory team members
+```
+
+### CLAUDE.md Sync
+
+```bash
+# Sync CLAUDE.md sections to memory DB
+a2a-memory claude-sync
+
+# Preview without writing
+a2a-memory claude-sync --dry-run
+
+# Force re-sync
+a2a-memory claude-sync --force
+```
+
+## Programmatic API
+
+```typescript
+import {
+  // Core
+  MemoryDatabase,
+  ConfigManager,
+  extractMemories,
+
+  // Search
+  HybridRanker,
+  createEmbeddingProvider,
+
+  // Sync
+  A2AClient,
+  MemorySynchronizer,
+  TeamSynchronizer,
+  SyncScheduler,
+
+  // Lifecycle
+  cleanupMemories,
+  rebalanceTiers,
+
+  // Encryption
+  encryptContent,
+  decryptContent,
+
+  // Claude.md
+  syncClaudeMd,
+} from 'a2a-memory';
+
+// Database operations
+const db = new MemoryDatabase('~/.a2a/memory.db');
+db.initialize();
+
+db.createMemory({
+  content: 'JWT tokens expire after 30 minutes',
+  category: 'convention',
+  tier: 'semantic',
+  tags: ['auth', 'jwt'],
+});
+
+// Hybrid search with embeddings
+const provider = createEmbeddingProvider({ provider: 'local', dimensions: 64 });
+const ranker = new HybridRanker(db, provider);
+const ranked = await ranker.search('auth error', { limit: 5 });
+
+// Server sync
+const client = new A2AClient({
+  serverUrl: 'https://a2a-api-production-8d17.up.railway.app',
+  apiKey: 'your-api-key',
+});
+const sync = new MemorySynchronizer(db, client);
+await sync.push();
+await sync.pull();
+
+// Scheduled sync
+const scheduler = new SyncScheduler(sync, { intervalMs: 1800000 });
+scheduler.start();
+
+// Team collaboration
+const teamSync = new TeamSynchronizer(db, client, 'team-id');
+await teamSync.pushTeamMemories();
+await teamSync.pullTeamMemories();
+
+// Lifecycle management
+await cleanupMemories(db, { ttlDays: 90, minQualityScore: 0.3 });
+await rebalanceTiers(db);
+
+// Anthropic Memory API adapter (for future integration)
+import { toAnthropicFormat, fromAnthropicFormat } from 'a2a-memory';
+
+const memory = db.getMemory('mem_123');
+const anthropicFormat = toAnthropicFormat(memory);
+// → { id, content, type: 'user_preference' | 'learned_info' | 'conversation_context', ... }
+
+const anthropicMemory = { id: '...', content: '...', type: 'learned_info', ... };
+const a2aInput = fromAnthropicFormat(anthropicMemory);
+db.createMemory(a2aInput);
 ```
 
+## Security
+
+### Sensitive Information Protection
+
+Automatically filters 21 patterns including:
+- Cloud provider keys (AWS, Google, Azure)
+- API keys and secrets (OpenAI, Stripe, GitHub)
+- Database connection strings
+- Private keys and certificates (RSA, EC, DSA)
+- JWT tokens and session cookies
+- Personal identifiable information (Korean SSN, Business registration)
+
+### Encryption
+
+**E2E Encryption** (opt-in via config):
+```bash
+a2a-memory config set autoSync.encryption.enabled true
+```
+
+- Algorithm: AES-256-GCM
+- Key derivation: PBKDF2-HMAC-SHA256 (600,000 iterations)
+- Storage: OS keychain integration (macOS, Linux, Windows)
+- Scope: Content + embeddings encrypted before transmission
+
+### API Key Storage
+
+Uses OS-native secure storage:
+- **macOS**: Keychain (`security` command)
+- **Linux**: Secret Service API (`secret-tool`)
+- **Windows**: Credential Manager (via `node-keytar`)
+
+Fallback: Encrypted file storage at `~/.a2a/credentials.enc`
+
 ## Requirements
 
 - Node.js >= 18.0.0

package/dist/adapters/anthropic.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Anthropic Memory API Adapter
+ *
+ * A2A 메모리를 Anthropic의 Claude Memory API 형식으로 변환합니다.
+ * Anthropic Memory API가 공개되면 실제 연동으로 전환 가능합니다.
+ *
+ * @see https://www.anthropic.com/news/contextual-retrieval
+ */
+import type { Memory, MemoryCreateInput, MemoryCategory } from '../types/index.js';
+/**
+ * Anthropic Memory API 형식의 메모리 타입
+ */
+export interface AnthropicMemory {
+    id: string;
+    content: string;
+    type: 'user_preference' | 'learned_info' | 'conversation_context';
+    source: 'user' | 'assistant' | 'system';
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Anthropic Memory API 응답 형식 (페이지네이션)
+ */
+export interface AnthropicMemoryListResponse {
+    data: AnthropicMemory[];
+    has_more: boolean;
+    first_id?: string;
+    last_id?: string;
+}
+/**
+ * A2A 메모리를 Anthropic 형식으로 변환
+ */
+export declare function toAnthropicFormat(memory: Memory): AnthropicMemory;
+/**
+ * Anthropic 형식을 A2A 메모리 생성 입력으로 변환
+ */
+export declare function fromAnthropicFormat(anthropic: AnthropicMemory): MemoryCreateInput;
+/**
+ * A2A 카테고리 → Anthropic 타입 매핑
+ *
+ * A2A 카테고리:
+ * - error_solution: 에러와 해결책
+ * - code_pattern: 코드 패턴
+ * - decision: 아키텍처 결정
+ * - context: 대화 컨텍스트
+ * - project_knowledge: 프로젝트 지식
+ * - convention: 규칙/컨벤션
+ * - learning: 학습 내용
+ *
+ * Anthropic 타입:
+ * - user_preference: 사용자 선호도
+ * - learned_info: 학습된 정보
+ * - conversation_context: 대화 컨텍스트
+ */
+export declare function mapCategoryToAnthropicType(category: MemoryCategory): AnthropicMemory['type'];
+/**
+ * Anthropic 타입 → A2A 카테고리 매핑
+ */
+export declare function mapAnthropicTypeToCategory(type: AnthropicMemory['type']): MemoryCategory;
+/**
+ * A2A 메모리 배열을 Anthropic 응답 형식으로 변환
+ */
+export declare function toAnthropicBatch(memories: Memory[]): AnthropicMemoryListResponse;
+/**
+ * Anthropic 응답 형식을 A2A 메모리 생성 입력 배열로 변환
+ */
+export declare function fromAnthropicBatch(response: AnthropicMemoryListResponse): MemoryCreateInput[];
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/adapters/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,iBAAiB,GAAG,cAAc,GAAG,sBAAsB,CAAC;IAClE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAkBjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,eAAe,GAAG,iBAAiB,CAiBjF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC,CAe5F;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,cAAc,CAWxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,2BAA2B,CAShF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,2BAA2B,GAAG,iBAAiB,EAAE,CAE7F"}

package/dist/adapters/anthropic.js

@@ -0,0 +1,116 @@
+/**
+ * Anthropic Memory API Adapter
+ *
+ * A2A 메모리를 Anthropic의 Claude Memory API 형식으로 변환합니다.
+ * Anthropic Memory API가 공개되면 실제 연동으로 전환 가능합니다.
+ *
+ * @see https://www.anthropic.com/news/contextual-retrieval
+ */
+/**
+ * A2A 메모리를 Anthropic 형식으로 변환
+ */
+export function toAnthropicFormat(memory) {
+    return {
+        id: memory.id,
+        content: memory.content,
+        type: mapCategoryToAnthropicType(memory.category),
+        source: 'assistant', // A2A는 AI가 추출한 메모리
+        created_at: memory.createdAt,
+        updated_at: memory.updatedAt,
+        metadata: {
+            category: memory.category,
+            tier: memory.tier,
+            tags: memory.tags,
+            projectPath: memory.projectPath,
+            sessionId: memory.sessionId,
+            accessCount: memory.accessCount,
+            lastAccessedAt: memory.lastAccessedAt,
+        },
+    };
+}
+/**
+ * Anthropic 형식을 A2A 메모리 생성 입력으로 변환
+ */
+export function fromAnthropicFormat(anthropic) {
+    const metadata = anthropic.metadata || {};
+    // tier 타입 검증 및 fallback
+    const validTiers = ['working', 'episodic', 'semantic'];
+    const tier = typeof metadata.tier === 'string' && validTiers.includes(metadata.tier)
+        ? metadata.tier
+        : 'episodic';
+    return {
+        content: anthropic.content,
+        category: mapAnthropicTypeToCategory(anthropic.type),
+        tier,
+        tags: Array.isArray(metadata.tags) ? metadata.tags : [],
+        projectPath: typeof metadata.projectPath === 'string' ? metadata.projectPath : undefined,
+        sessionId: typeof metadata.sessionId === 'string' ? metadata.sessionId : undefined,
+    };
+}
+/**
+ * A2A 카테고리 → Anthropic 타입 매핑
+ *
+ * A2A 카테고리:
+ * - error_solution: 에러와 해결책
+ * - code_pattern: 코드 패턴
+ * - decision: 아키텍처 결정
+ * - context: 대화 컨텍스트
+ * - project_knowledge: 프로젝트 지식
+ * - convention: 규칙/컨벤션
+ * - learning: 학습 내용
+ *
+ * Anthropic 타입:
+ * - user_preference: 사용자 선호도
+ * - learned_info: 학습된 정보
+ * - conversation_context: 대화 컨텍스트
+ */
+export function mapCategoryToAnthropicType(category) {
+    switch (category) {
+        case 'convention':
+            return 'user_preference';
+        case 'context':
+            return 'conversation_context';
+        case 'error_solution':
+        case 'code_pattern':
+        case 'decision':
+        case 'project_knowledge':
+        case 'learning':
+            return 'learned_info';
+        default:
+            return 'learned_info';
+    }
+}
+/**
+ * Anthropic 타입 → A2A 카테고리 매핑
+ */
+export function mapAnthropicTypeToCategory(type) {
+    switch (type) {
+        case 'user_preference':
+            return 'convention';
+        case 'conversation_context':
+            return 'context';
+        case 'learned_info':
+            return 'project_knowledge';
+        default:
+            return 'project_knowledge';
+    }
+}
+/**
+ * A2A 메모리 배열을 Anthropic 응답 형식으로 변환
+ */
+export function toAnthropicBatch(memories) {
+    const data = memories.map(toAnthropicFormat);
+    return {
+        data,
+        has_more: false, // 단일 배치 변환이므로 항상 false
+        first_id: data.length > 0 ? data[0].id : undefined,
+        last_id: data.length > 0 ? data[data.length - 1].id : undefined,
+    };
+}
+/**
+ * Anthropic 응답 형식을 A2A 메모리 생성 입력 배열로 변환
+ */
+export function fromAnthropicBatch(response) {
+    return response.data.map(fromAnthropicFormat);
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/adapters/anthropic.js.map

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

package/dist/claude/sync.d.ts

@@ -0,0 +1,57 @@
+/**
+ * CLAUDE.md Sync
+ *
+ * CLAUDE.md 파일을 파싱하여 섹션별 메모리를 생성/업데이트합니다.
+ *
+ * 동작:
+ * 1. CLAUDE.md 파일 탐색 (프로젝트 루트, .claude/ 등)
+ * 2. 마크다운 헤딩(##) 기준으로 섹션 분리
+ * 3. 각 섹션을 convention/context 카테고리 메모리로 저장
+ * 4. content hash로 중복/변경 감지
+ */
+import type { MemoryDatabase } from '../db/database.js';
+import type { MemoryCategory } from '../types/index.js';
+export interface ClaudeSyncOptions {
+    /** CLAUDE.md 경로 (없으면 자동 탐색) */
+    claudeMdPath?: string;
+    /** dry-run 모드 */
+    dryRun?: boolean;
+    /** 변경 없어도 강제 동기화 */
+    force?: boolean;
+    /** 프로젝트 경로 (없으면 cwd) */
+    projectPath?: string;
+}
+export interface ClaudeSyncResult {
+    found: boolean;
+    filePath: string;
+    totalSections: number;
+    created: number;
+    updated: number;
+    skipped: number;
+    sections: SectionResult[];
+}
+export interface SectionResult {
+    title: string;
+    category: MemoryCategory;
+    action: 'created' | 'updated' | 'skipped';
+}
+interface ParsedSection {
+    title: string;
+    content: string;
+    level: number;
+    hash: string;
+}
+/**
+ * CLAUDE.md 파일 동기화
+ */
+export declare function syncClaudeMd(db: MemoryDatabase, options?: ClaudeSyncOptions): Promise<ClaudeSyncResult>;
+/**
+ * CLAUDE.md 파일 탐색 (우선순위)
+ */
+export declare function findClaudeMd(projectPath?: string): string | null;
+/**
+ * CLAUDE.md를 섹션으로 파싱
+ */
+export declare function parseClaudeMd(content: string): ParsedSection[];
+export {};
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/claude/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC3C;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;GAEG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA4E3B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAchE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CA8C9D"}