@claude-flow/memory 3.0.0-alpha.1

package/dist/infrastructure/repositories/hybrid-memory-repository.js

@@ -0,0 +1,409 @@
+/**
+ * Hybrid Memory Repository - Infrastructure Layer
+ *
+ * Implements IMemoryRepository using SQLite + AgentDB hybrid backend.
+ * Per ADR-009, this is the default memory backend.
+ *
+ * @module v3/memory/infrastructure/repositories
+ */
+/**
+ * Hybrid Memory Repository
+ *
+ * Uses SQLite for metadata and AgentDB for vectors.
+ * Implements hot caching for frequently accessed entries.
+ */
+export class HybridMemoryRepository {
+    config;
+    entries = new Map();
+    namespaceIndex = new Map();
+    vectorIndex = new Map();
+    cache = new Map();
+    initialized = false;
+    constructor(config) {
+        this.config = config;
+    }
+    // ============================================================================
+    // Lifecycle
+    // ============================================================================
+    async initialize() {
+        if (this.initialized)
+            return;
+        // In production, would initialize SQLite and AgentDB connections
+        // For now, using in-memory implementation
+        this.entries = new Map();
+        this.namespaceIndex = new Map();
+        this.vectorIndex = new Map();
+        this.cache = new Map();
+        this.initialized = true;
+    }
+    async shutdown() {
+        // Clear all data
+        this.cache.clear();
+        this.initialized = false;
+    }
+    async clear() {
+        this.entries.clear();
+        this.namespaceIndex.clear();
+        this.vectorIndex.clear();
+        this.cache.clear();
+    }
+    // ============================================================================
+    // Basic CRUD
+    // ============================================================================
+    async save(entry) {
+        this.ensureInitialized();
+        // Store entry
+        this.entries.set(entry.id, entry);
+        // Update namespace index
+        if (!this.namespaceIndex.has(entry.namespace)) {
+            this.namespaceIndex.set(entry.namespace, new Set());
+        }
+        this.namespaceIndex.get(entry.namespace).add(entry.id);
+        // Store vector if present
+        if (entry.vector) {
+            this.vectorIndex.set(entry.id, entry.vector);
+        }
+        // Update cache
+        this.updateCache(entry);
+    }
+    async findById(id) {
+        this.ensureInitialized();
+        // Check cache first
+        const cached = this.cache.get(id);
+        if (cached) {
+            return cached.entry;
+        }
+        return this.entries.get(id) ?? null;
+    }
+    async findByKey(namespace, key) {
+        this.ensureInitialized();
+        for (const entry of this.entries.values()) {
+            if (entry.namespace === namespace && entry.key === key) {
+                return entry;
+            }
+        }
+        return null;
+    }
+    async findByCompositeKey(compositeKey) {
+        const [namespace, key] = compositeKey.split(':');
+        return this.findByKey(namespace, key);
+    }
+    async delete(id) {
+        this.ensureInitialized();
+        const entry = this.entries.get(id);
+        if (!entry)
+            return false;
+        // Remove from all indexes
+        this.entries.delete(id);
+        this.namespaceIndex.get(entry.namespace)?.delete(id);
+        this.vectorIndex.delete(id);
+        this.cache.delete(id);
+        return true;
+    }
+    async exists(id) {
+        return this.entries.has(id);
+    }
+    // ============================================================================
+    // Bulk Operations
+    // ============================================================================
+    async saveMany(entries) {
+        const errors = [];
+        let success = 0;
+        for (const entry of entries) {
+            try {
+                await this.save(entry);
+                success++;
+            }
+            catch (error) {
+                errors.push({
+                    id: entry.id,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+            }
+        }
+        return {
+            success,
+            failed: errors.length,
+            errors,
+        };
+    }
+    async findByIds(ids) {
+        return ids
+            .map((id) => this.entries.get(id))
+            .filter((e) => e !== undefined);
+    }
+    async deleteMany(ids) {
+        const errors = [];
+        let success = 0;
+        for (const id of ids) {
+            try {
+                if (await this.delete(id)) {
+                    success++;
+                }
+                else {
+                    errors.push({ id, error: 'Entry not found' });
+                }
+            }
+            catch (error) {
+                errors.push({
+                    id,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+            }
+        }
+        return {
+            success,
+            failed: errors.length,
+            errors,
+        };
+    }
+    // ============================================================================
+    // Query Operations
+    // ============================================================================
+    async findAll(options) {
+        this.ensureInitialized();
+        let results = Array.from(this.entries.values());
+        // Apply filters
+        if (options?.namespace) {
+            results = results.filter((e) => e.namespace === options.namespace);
+        }
+        if (options?.type) {
+            results = results.filter((e) => e.type === options.type);
+        }
+        if (options?.status) {
+            results = results.filter((e) => e.status === options.status);
+        }
+        // Apply sorting
+        const orderBy = options?.orderBy ?? 'createdAt';
+        const orderDir = options?.orderDirection ?? 'desc';
+        results.sort((a, b) => {
+            let aVal, bVal;
+            switch (orderBy) {
+                case 'accessCount':
+                    aVal = a.accessCount;
+                    bVal = b.accessCount;
+                    break;
+                case 'lastAccessedAt':
+                    aVal = a.lastAccessedAt.getTime();
+                    bVal = b.lastAccessedAt.getTime();
+                    break;
+                case 'updatedAt':
+                    aVal = a.updatedAt.getTime();
+                    bVal = b.updatedAt.getTime();
+                    break;
+                default:
+                    aVal = a.createdAt.getTime();
+                    bVal = b.createdAt.getTime();
+            }
+            return orderDir === 'asc' ? aVal - bVal : bVal - aVal;
+        });
+        // Apply pagination
+        if (options?.offset) {
+            results = results.slice(options.offset);
+        }
+        if (options?.limit) {
+            results = results.slice(0, options.limit);
+        }
+        return results;
+    }
+    async findByNamespace(namespace, options) {
+        return this.findAll({ ...options, namespace });
+    }
+    async findByType(type, options) {
+        return this.findAll({ ...options, type });
+    }
+    async findByStatus(status, options) {
+        return this.findAll({ ...options, status });
+    }
+    // ============================================================================
+    // Vector Search
+    // ============================================================================
+    async searchByVector(options) {
+        this.ensureInitialized();
+        const results = [];
+        for (const [id, vector] of this.vectorIndex) {
+            const entry = this.entries.get(id);
+            if (!entry)
+                continue;
+            if (options.namespace && entry.namespace !== options.namespace)
+                continue;
+            if (options.type && entry.type !== options.type)
+                continue;
+            const similarity = this.cosineSimilarity(options.vector, vector);
+            const threshold = options.threshold ?? 0.5;
+            if (similarity >= threshold) {
+                results.push({
+                    entry,
+                    similarity,
+                    distance: 1 - similarity,
+                });
+            }
+        }
+        // Sort by similarity descending
+        results.sort((a, b) => b.similarity - a.similarity);
+        // Limit results
+        return results.slice(0, options.limit ?? 10);
+    }
+    async findSimilar(entryId, limit = 10) {
+        const entry = this.entries.get(entryId);
+        if (!entry || !entry.vector)
+            return [];
+        return this.searchByVector({
+            vector: entry.vector,
+            namespace: entry.namespace,
+            limit: limit + 1, // Include self
+        }).then((results) => results.filter((r) => r.entry.id !== entryId).slice(0, limit));
+    }
+    // ============================================================================
+    // Maintenance Operations
+    // ============================================================================
+    async findExpired() {
+        return Array.from(this.entries.values()).filter((e) => e.isExpired());
+    }
+    async deleteExpired() {
+        const expired = await this.findExpired();
+        for (const entry of expired) {
+            await this.delete(entry.id);
+        }
+        return expired.length;
+    }
+    async findCold(milliseconds) {
+        return Array.from(this.entries.values()).filter((e) => e.isCold(milliseconds));
+    }
+    async archiveCold(milliseconds) {
+        const cold = await this.findCold(milliseconds);
+        for (const entry of cold) {
+            entry.archive();
+            await this.save(entry);
+        }
+        return cold.length;
+    }
+    // ============================================================================
+    // Statistics
+    // ============================================================================
+    async getStatistics() {
+        const entries = Array.from(this.entries.values());
+        const entriesByNamespace = {};
+        const entriesByType = {
+            semantic: 0,
+            episodic: 0,
+            procedural: 0,
+            working: 0,
+        };
+        let totalAccessCount = 0;
+        let totalSize = 0;
+        let activeCount = 0;
+        let archivedCount = 0;
+        let deletedCount = 0;
+        for (const entry of entries) {
+            // Count by namespace
+            entriesByNamespace[entry.namespace] = (entriesByNamespace[entry.namespace] ?? 0) + 1;
+            // Count by type
+            entriesByType[entry.type]++;
+            // Accumulate stats
+            totalAccessCount += entry.accessCount;
+            totalSize += JSON.stringify(entry.value).length;
+            // Count by status
+            switch (entry.status) {
+                case 'active':
+                    activeCount++;
+                    break;
+                case 'archived':
+                    archivedCount++;
+                    break;
+                case 'deleted':
+                    deletedCount++;
+                    break;
+            }
+        }
+        // Find hottest and coldest
+        const sorted = [...entries].sort((a, b) => b.accessCount - a.accessCount);
+        const hottestEntries = sorted.slice(0, 5).map((e) => e.id);
+        const coldestEntries = sorted.slice(-5).reverse().map((e) => e.id);
+        return {
+            totalEntries: entries.length,
+            activeEntries: activeCount,
+            archivedEntries: archivedCount,
+            deletedEntries: deletedCount,
+            totalSize,
+            entriesByNamespace,
+            entriesByType,
+            averageAccessCount: entries.length > 0 ? totalAccessCount / entries.length : 0,
+            hottestEntries,
+            coldestEntries,
+        };
+    }
+    async count(options) {
+        const entries = await this.findAll(options);
+        return entries.length;
+    }
+    // ============================================================================
+    // Namespace Operations
+    // ============================================================================
+    async listNamespaces() {
+        return Array.from(this.namespaceIndex.keys());
+    }
+    async deleteNamespace(namespace) {
+        const ids = this.namespaceIndex.get(namespace);
+        if (!ids)
+            return 0;
+        const count = ids.size;
+        for (const id of ids) {
+            await this.delete(id);
+        }
+        this.namespaceIndex.delete(namespace);
+        return count;
+    }
+    async getNamespaceSize(namespace) {
+        const ids = this.namespaceIndex.get(namespace);
+        if (!ids)
+            return 0;
+        let size = 0;
+        for (const id of ids) {
+            const entry = this.entries.get(id);
+            if (entry) {
+                size += JSON.stringify(entry.value).length;
+            }
+        }
+        return size;
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('Repository not initialized. Call initialize() first.');
+        }
+    }
+    updateCache(entry) {
+        const maxCacheSize = this.config.cacheSize ?? 100;
+        // Evict oldest entries if cache is full
+        if (this.cache.size >= maxCacheSize) {
+            const oldest = Array.from(this.cache.entries())
+                .sort(([, a], [, b]) => a.timestamp - b.timestamp)
+                .slice(0, Math.floor(maxCacheSize * 0.2));
+            for (const [id] of oldest) {
+                this.cache.delete(id);
+            }
+        }
+        this.cache.set(entry.id, {
+            entry,
+            timestamp: Date.now(),
+        });
+    }
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length)
+            return 0;
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dotProduct += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+        return denominator === 0 ? 0 : dotProduct / denominator;
+    }
+}
+//# sourceMappingURL=hybrid-memory-repository.js.map

package/dist/infrastructure/repositories/hybrid-memory-repository.js.map

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

package/dist/migration.d.ts

@@ -0,0 +1,68 @@
+/**
+ * V3 Memory Migration Utility
+ *
+ * Migrates data from legacy memory systems (SQLite, Markdown, JSON, etc.)
+ * to the unified AgentDB-backed memory system with HNSW indexing.
+ *
+ * @module v3/memory/migration
+ */
+import { EventEmitter } from 'node:events';
+import { MigrationConfig, MigrationProgress, MigrationResult, MigrationSource, EmbeddingGenerator } from './types.js';
+import { AgentDBAdapter } from './agentdb-adapter.js';
+/**
+ * Memory Migration Manager
+ *
+ * Handles migration from:
+ * - SQLite backends (.db files)
+ * - Markdown backends (.md files)
+ * - JSON memory stores (.json files)
+ * - MemoryManager instances
+ * - SwarmMemory instances
+ * - DistributedMemory instances
+ */
+export declare class MemoryMigrator extends EventEmitter {
+    private config;
+    private target;
+    private embeddingGenerator?;
+    private progress;
+    constructor(target: AgentDBAdapter, config: Partial<MigrationConfig>, embeddingGenerator?: EmbeddingGenerator);
+    /**
+     * Run the migration
+     */
+    migrate(): Promise<MigrationResult>;
+    /**
+     * Get current migration progress
+     */
+    getProgress(): MigrationProgress;
+    private loadFromSource;
+    private loadFromSQLite;
+    private loadFromMarkdown;
+    private loadFromJSON;
+    private loadFromMemoryManager;
+    private loadFromSwarmMemory;
+    private loadFromDistributedMemory;
+    private processBatch;
+    private transformEntry;
+    private initializeProgress;
+    private validateEntry;
+    private addError;
+    private parseTimestamp;
+    private isValidMemoryType;
+    private estimateTimeRemaining;
+    private generateSummary;
+    private walkDirectory;
+    private parseMarkdownEntry;
+}
+/**
+ * Convenience function to create a migrator
+ */
+export declare function createMigrator(target: AgentDBAdapter, source: MigrationSource, sourcePath: string, options?: Partial<MigrationConfig>, embeddingGenerator?: EmbeddingGenerator): MemoryMigrator;
+/**
+ * Migrate from multiple sources
+ */
+export declare function migrateMultipleSources(target: AgentDBAdapter, sources: Array<{
+    source: MigrationSource;
+    path: string;
+}>, options?: Partial<MigrationConfig>, embeddingGenerator?: EmbeddingGenerator): Promise<MigrationResult[]>;
+export default MemoryMigrator;
+//# sourceMappingURL=migration.d.ts.map

package/dist/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EAEf,eAAe,EAIf,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA6BtD;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAoB;gBAGlC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,kBAAkB,CAAC,EAAE,kBAAkB;IASzC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IA2DzC;;OAEG;IACH,WAAW,IAAI,iBAAiB;YAMlB,cAAc;YAmBd,cAAc;YA+Bd,gBAAgB;YAyBhB,YAAY;YA+BZ,qBAAqB;YAsBrB,mBAAmB;YAmCnB,yBAAyB;YAOzB,YAAY;YA4CZ,cAAc;IAmE5B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,eAAe;YA6BT,aAAa;IAuB3B,OAAO,CAAC,kBAAkB;CA6D3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,EACtC,kBAAkB,CAAC,EAAE,kBAAkB,GACtC,cAAc,CAMhB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACzD,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,EACtC,kBAAkB,CAAC,EAAE,kBAAkB,GACtC,OAAO,CAAC,eAAe,EAAE,CAAC,CAgB5B;AAED,eAAe,cAAc,CAAC"}