@claude-flow/memory 3.0.0-alpha.1

package/dist/database-provider.test.js

@@ -0,0 +1,285 @@
+/**
+ * Database Provider Tests - Cross-Platform Compatibility
+ *
+ * Tests for platform-aware database selection and fallback mechanisms
+ */
+import { describe, it, expect, afterEach } from 'vitest';
+import { createDatabase, getPlatformInfo, getAvailableProviders } from './database-provider.js';
+import { createDefaultEntry } from './types.js';
+import { unlinkSync, existsSync } from 'node:fs';
+describe('DatabaseProvider', () => {
+    const testDbPath = './test-database-provider.db';
+    afterEach(() => {
+        // Cleanup test database
+        if (existsSync(testDbPath)) {
+            try {
+                unlinkSync(testDbPath);
+            }
+            catch (error) {
+                // Ignore cleanup errors
+            }
+        }
+    });
+    describe('Platform Detection', () => {
+        it('should detect platform information', () => {
+            const info = getPlatformInfo();
+            expect(info).toHaveProperty('os');
+            expect(info).toHaveProperty('isWindows');
+            expect(info).toHaveProperty('isMacOS');
+            expect(info).toHaveProperty('isLinux');
+            expect(info).toHaveProperty('recommendedProvider');
+            // Should recommend sql.js on Windows, better-sqlite3 on Unix
+            if (info.isWindows) {
+                expect(info.recommendedProvider).toBe('sql.js');
+            }
+            else {
+                expect(info.recommendedProvider).toBe('better-sqlite3');
+            }
+        });
+    });
+    describe('Provider Availability', () => {
+        it('should check available providers', async () => {
+            const available = await getAvailableProviders();
+            expect(available).toHaveProperty('betterSqlite3');
+            expect(available).toHaveProperty('sqlJs');
+            expect(available).toHaveProperty('json');
+            // JSON backend should always be available
+            expect(available.json).toBe(true);
+        });
+    });
+    describe('Automatic Provider Selection', () => {
+        it('should create database with auto provider selection', async () => {
+            const db = await createDatabase(':memory:');
+            expect(db).toBeDefined();
+            await expect(db.count()).resolves.toBe(0);
+            await db.shutdown();
+        });
+        it('should create persistent database with auto provider', async () => {
+            const db = await createDatabase(testDbPath);
+            expect(db).toBeDefined();
+            // Store test entry
+            const entry = createDefaultEntry({
+                key: 'test-key',
+                content: 'test content',
+                namespace: 'test',
+            });
+            await db.store(entry);
+            await expect(db.count()).resolves.toBe(1);
+            await db.shutdown();
+        });
+    });
+    describe('Explicit Provider Selection', () => {
+        it('should create database with sql.js provider', async () => {
+            const available = await getAvailableProviders();
+            if (!available.sqlJs) {
+                console.log('sql.js not available, skipping test');
+                return;
+            }
+            const db = await createDatabase(':memory:', {
+                provider: 'sql.js',
+                verbose: false,
+            });
+            expect(db).toBeDefined();
+            // Test basic operations
+            const entry = createDefaultEntry({
+                key: 'sqljs-test',
+                content: 'testing sql.js backend',
+                namespace: 'test',
+            });
+            await db.store(entry);
+            await expect(db.count()).resolves.toBe(1);
+            const retrieved = await db.get(entry.id);
+            expect(retrieved).toBeDefined();
+            expect(retrieved?.key).toBe('sqljs-test');
+            await db.shutdown();
+        });
+        it('should create database with better-sqlite3 provider', async () => {
+            const available = await getAvailableProviders();
+            if (!available.betterSqlite3) {
+                console.log('better-sqlite3 not available, skipping test');
+                return;
+            }
+            const db = await createDatabase(':memory:', {
+                provider: 'better-sqlite3',
+                verbose: false,
+            });
+            expect(db).toBeDefined();
+            // Test basic operations
+            const entry = createDefaultEntry({
+                key: 'sqlite-test',
+                content: 'testing better-sqlite3 backend',
+                namespace: 'test',
+            });
+            await db.store(entry);
+            await expect(db.count()).resolves.toBe(1);
+            const retrieved = await db.get(entry.id);
+            expect(retrieved).toBeDefined();
+            expect(retrieved?.key).toBe('sqlite-test');
+            await db.shutdown();
+        });
+        it('should create database with JSON provider', async () => {
+            const db = await createDatabase(testDbPath, {
+                provider: 'json',
+                verbose: false,
+            });
+            expect(db).toBeDefined();
+            // Test basic operations
+            const entry = createDefaultEntry({
+                key: 'json-test',
+                content: 'testing JSON backend',
+                namespace: 'test',
+            });
+            await db.store(entry);
+            await expect(db.count()).resolves.toBe(1);
+            const retrieved = await db.get(entry.id);
+            expect(retrieved).toBeDefined();
+            expect(retrieved?.key).toBe('json-test');
+            await db.shutdown();
+        });
+    });
+    describe('Cross-Platform Functionality', () => {
+        it('should handle CRUD operations consistently across providers', async () => {
+            const available = await getAvailableProviders();
+            const providers = [];
+            if (available.betterSqlite3)
+                providers.push('better-sqlite3');
+            if (available.sqlJs)
+                providers.push('sql.js');
+            providers.push('json'); // Always available
+            for (const provider of providers) {
+                const db = await createDatabase(':memory:', { provider });
+                // Create
+                const entry = createDefaultEntry({
+                    key: `test-${provider}`,
+                    content: `testing ${provider}`,
+                    namespace: 'cross-platform',
+                    tags: ['test', provider],
+                });
+                await db.store(entry);
+                // Read
+                const retrieved = await db.get(entry.id);
+                expect(retrieved).toBeDefined();
+                expect(retrieved?.key).toBe(`test-${provider}`);
+                expect(retrieved?.tags).toContain(provider);
+                // Update
+                const updated = await db.update(entry.id, {
+                    content: `updated ${provider}`,
+                });
+                expect(updated).toBeDefined();
+                expect(updated?.content).toBe(`updated ${provider}`);
+                // Query
+                const results = await db.query({
+                    type: 'hybrid',
+                    namespace: 'cross-platform',
+                    limit: 10,
+                });
+                expect(results.length).toBe(1);
+                expect(results[0].key).toBe(`test-${provider}`);
+                // Delete
+                const deleted = await db.delete(entry.id);
+                expect(deleted).toBe(true);
+                await expect(db.count()).resolves.toBe(0);
+                await db.shutdown();
+            }
+        });
+        it('should handle namespace operations across providers', async () => {
+            const db = await createDatabase(':memory:');
+            // Create entries in different namespaces
+            const entries = [
+                createDefaultEntry({ key: 'entry1', content: 'content1', namespace: 'ns1' }),
+                createDefaultEntry({ key: 'entry2', content: 'content2', namespace: 'ns1' }),
+                createDefaultEntry({ key: 'entry3', content: 'content3', namespace: 'ns2' }),
+            ];
+            for (const entry of entries) {
+                await db.store(entry);
+            }
+            // List namespaces
+            const namespaces = await db.listNamespaces();
+            expect(namespaces).toContain('ns1');
+            expect(namespaces).toContain('ns2');
+            // Count by namespace
+            await expect(db.count('ns1')).resolves.toBe(2);
+            await expect(db.count('ns2')).resolves.toBe(1);
+            // Clear namespace
+            const cleared = await db.clearNamespace('ns1');
+            expect(cleared).toBe(2);
+            await expect(db.count('ns1')).resolves.toBe(0);
+            await expect(db.count('ns2')).resolves.toBe(1);
+            await db.shutdown();
+        });
+        it('should handle bulk operations across providers', async () => {
+            const db = await createDatabase(':memory:');
+            // Bulk insert
+            const entries = Array.from({ length: 10 }, (_, i) => createDefaultEntry({
+                key: `bulk-${i}`,
+                content: `content ${i}`,
+                namespace: 'bulk-test',
+            }));
+            await db.bulkInsert(entries);
+            await expect(db.count('bulk-test')).resolves.toBe(10);
+            // Bulk delete
+            const idsToDelete = entries.slice(0, 5).map((e) => e.id);
+            const deletedCount = await db.bulkDelete(idsToDelete);
+            expect(deletedCount).toBe(5);
+            await expect(db.count('bulk-test')).resolves.toBe(5);
+            await db.shutdown();
+        });
+    });
+    describe('Health Check', () => {
+        it('should perform health check', async () => {
+            const db = await createDatabase(':memory:');
+            const health = await db.healthCheck();
+            expect(health).toHaveProperty('status');
+            expect(health).toHaveProperty('components');
+            expect(health).toHaveProperty('timestamp');
+            expect(health).toHaveProperty('issues');
+            expect(health).toHaveProperty('recommendations');
+            expect(health.components).toHaveProperty('storage');
+            expect(health.components).toHaveProperty('index');
+            expect(health.components).toHaveProperty('cache');
+            await db.shutdown();
+        });
+    });
+    describe('Statistics', () => {
+        it('should provide backend statistics', async () => {
+            const db = await createDatabase(':memory:');
+            // Add some test data
+            const entries = [
+                createDefaultEntry({ key: 'stat1', content: 'content1', namespace: 'stats', type: 'semantic' }),
+                createDefaultEntry({ key: 'stat2', content: 'content2', namespace: 'stats', type: 'episodic' }),
+                createDefaultEntry({ key: 'stat3', content: 'content3', namespace: 'stats', type: 'semantic' }),
+            ];
+            for (const entry of entries) {
+                await db.store(entry);
+            }
+            const stats = await db.getStats();
+            expect(stats).toHaveProperty('totalEntries');
+            expect(stats).toHaveProperty('entriesByNamespace');
+            expect(stats).toHaveProperty('entriesByType');
+            expect(stats).toHaveProperty('memoryUsage');
+            expect(stats).toHaveProperty('avgQueryTime');
+            expect(stats.totalEntries).toBe(3);
+            await db.shutdown();
+        });
+    });
+    describe('Error Handling', () => {
+        it('should handle missing entries gracefully', async () => {
+            const db = await createDatabase(':memory:');
+            const entry = await db.get('non-existent-id');
+            expect(entry).toBeNull();
+            const byKey = await db.getByKey('non-existent-ns', 'non-existent-key');
+            expect(byKey).toBeNull();
+            await db.shutdown();
+        });
+        it('should handle empty queries', async () => {
+            const db = await createDatabase(':memory:');
+            const results = await db.query({
+                type: 'hybrid',
+                limit: 10,
+            });
+            expect(results).toEqual([]);
+            await db.shutdown();
+        });
+    });
+});
+//# sourceMappingURL=database-provider.test.js.map

package/dist/database-provider.test.js.map

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

package/dist/domain/entities/memory-entry.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Memory Entry Entity - Domain Layer
+ *
+ * Core domain entity representing a stored memory item.
+ * Implements DDD principles with encapsulated business logic.
+ *
+ * @module v3/memory/domain/entities
+ */
+/**
+ * Memory entry types
+ */
+export type MemoryType = 'semantic' | 'episodic' | 'procedural' | 'working';
+/**
+ * Memory entry status
+ */
+export type MemoryStatus = 'active' | 'archived' | 'deleted';
+/**
+ * Memory entry properties
+ */
+export interface MemoryEntryProps {
+    id?: string;
+    namespace: string;
+    key: string;
+    value: unknown;
+    type: MemoryType;
+    vector?: Float32Array;
+    metadata?: Record<string, unknown>;
+    accessCount?: number;
+    lastAccessedAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    status?: MemoryStatus;
+    ttl?: number;
+}
+/**
+ * Memory Entry - Aggregate Root
+ *
+ * Represents a single memory entry with business logic
+ * for access tracking, expiration, and state management.
+ */
+export declare class MemoryEntry {
+    private _id;
+    private _namespace;
+    private _key;
+    private _value;
+    private _type;
+    private _vector?;
+    private _metadata;
+    private _accessCount;
+    private _lastAccessedAt;
+    private _createdAt;
+    private _updatedAt;
+    private _status;
+    private _ttl?;
+    private constructor();
+    /**
+     * Factory method - Create new memory entry
+     */
+    static create(props: MemoryEntryProps): MemoryEntry;
+    /**
+     * Factory method - Reconstruct from persistence
+     */
+    static fromPersistence(props: MemoryEntryProps): MemoryEntry;
+    get id(): string;
+    get namespace(): string;
+    get key(): string;
+    get value(): unknown;
+    get type(): MemoryType;
+    get vector(): Float32Array | undefined;
+    get metadata(): Record<string, unknown>;
+    get accessCount(): number;
+    get lastAccessedAt(): Date;
+    get createdAt(): Date;
+    get updatedAt(): Date;
+    get status(): MemoryStatus;
+    get ttl(): number | undefined;
+    get compositeKey(): string;
+    /**
+     * Record an access to this memory entry
+     */
+    recordAccess(): void;
+    /**
+     * Update the value of this memory entry
+     */
+    updateValue(value: unknown): void;
+    /**
+     * Update the vector embedding
+     */
+    updateVector(vector: Float32Array): void;
+    /**
+     * Add or update metadata
+     */
+    setMetadata(key: string, value: unknown): void;
+    /**
+     * Remove metadata key
+     */
+    removeMetadata(key: string): void;
+    /**
+     * Archive this memory entry
+     */
+    archive(): void;
+    /**
+     * Restore archived memory entry
+     */
+    restore(): void;
+    /**
+     * Mark as deleted (soft delete)
+     */
+    delete(): void;
+    /**
+     * Check if memory has expired based on TTL
+     */
+    isExpired(): boolean;
+    /**
+     * Check if memory is accessible (active and not expired)
+     */
+    isAccessible(): boolean;
+    /**
+     * Calculate age in milliseconds
+     */
+    getAge(): number;
+    /**
+     * Calculate time since last access in milliseconds
+     */
+    getTimeSinceLastAccess(): number;
+    /**
+     * Check if memory is considered "hot" (frequently accessed)
+     */
+    isHot(threshold?: number): boolean;
+    /**
+     * Check if memory is considered "cold" (not accessed recently)
+     */
+    isCold(milliseconds?: number): boolean;
+    /**
+     * Convert to plain object for persistence
+     */
+    toPersistence(): Record<string, unknown>;
+    /**
+     * Convert to JSON-serializable object
+     */
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=memory-entry.d.ts.map

package/dist/domain/entities/memory-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-entry.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/memory-entry.ts"],"names":[],"mappings":"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"}

package/dist/domain/entities/memory-entry.js

@@ -0,0 +1,226 @@
+/**
+ * Memory Entry Entity - Domain Layer
+ *
+ * Core domain entity representing a stored memory item.
+ * Implements DDD principles with encapsulated business logic.
+ *
+ * @module v3/memory/domain/entities
+ */
+import { randomUUID } from 'crypto';
+/**
+ * Memory Entry - Aggregate Root
+ *
+ * Represents a single memory entry with business logic
+ * for access tracking, expiration, and state management.
+ */
+export class MemoryEntry {
+    _id;
+    _namespace;
+    _key;
+    _value;
+    _type;
+    _vector;
+    _metadata;
+    _accessCount;
+    _lastAccessedAt;
+    _createdAt;
+    _updatedAt;
+    _status;
+    _ttl;
+    constructor(props) {
+        const now = new Date();
+        this._id = props.id ?? randomUUID();
+        this._namespace = props.namespace;
+        this._key = props.key;
+        this._value = props.value;
+        this._type = props.type;
+        this._vector = props.vector;
+        this._metadata = props.metadata ?? {};
+        this._accessCount = props.accessCount ?? 0;
+        this._lastAccessedAt = props.lastAccessedAt ?? now;
+        this._createdAt = props.createdAt ?? now;
+        this._updatedAt = props.updatedAt ?? now;
+        this._status = props.status ?? 'active';
+        this._ttl = props.ttl;
+    }
+    /**
+     * Factory method - Create new memory entry
+     */
+    static create(props) {
+        return new MemoryEntry(props);
+    }
+    /**
+     * Factory method - Reconstruct from persistence
+     */
+    static fromPersistence(props) {
+        return new MemoryEntry(props);
+    }
+    // Getters
+    get id() {
+        return this._id;
+    }
+    get namespace() {
+        return this._namespace;
+    }
+    get key() {
+        return this._key;
+    }
+    get value() {
+        return this._value;
+    }
+    get type() {
+        return this._type;
+    }
+    get vector() {
+        return this._vector;
+    }
+    get metadata() {
+        return { ...this._metadata };
+    }
+    get accessCount() {
+        return this._accessCount;
+    }
+    get lastAccessedAt() {
+        return new Date(this._lastAccessedAt);
+    }
+    get createdAt() {
+        return new Date(this._createdAt);
+    }
+    get updatedAt() {
+        return new Date(this._updatedAt);
+    }
+    get status() {
+        return this._status;
+    }
+    get ttl() {
+        return this._ttl;
+    }
+    get compositeKey() {
+        return `${this._namespace}:${this._key}`;
+    }
+    // Business Logic Methods
+    /**
+     * Record an access to this memory entry
+     */
+    recordAccess() {
+        this._accessCount++;
+        this._lastAccessedAt = new Date();
+    }
+    /**
+     * Update the value of this memory entry
+     */
+    updateValue(value) {
+        this._value = value;
+        this._updatedAt = new Date();
+    }
+    /**
+     * Update the vector embedding
+     */
+    updateVector(vector) {
+        this._vector = vector;
+        this._updatedAt = new Date();
+    }
+    /**
+     * Add or update metadata
+     */
+    setMetadata(key, value) {
+        this._metadata[key] = value;
+        this._updatedAt = new Date();
+    }
+    /**
+     * Remove metadata key
+     */
+    removeMetadata(key) {
+        delete this._metadata[key];
+        this._updatedAt = new Date();
+    }
+    /**
+     * Archive this memory entry
+     */
+    archive() {
+        this._status = 'archived';
+        this._updatedAt = new Date();
+    }
+    /**
+     * Restore archived memory entry
+     */
+    restore() {
+        if (this._status === 'archived') {
+            this._status = 'active';
+            this._updatedAt = new Date();
+        }
+    }
+    /**
+     * Mark as deleted (soft delete)
+     */
+    delete() {
+        this._status = 'deleted';
+        this._updatedAt = new Date();
+    }
+    /**
+     * Check if memory has expired based on TTL
+     */
+    isExpired() {
+        if (!this._ttl)
+            return false;
+        const expiresAt = this._createdAt.getTime() + this._ttl;
+        return Date.now() > expiresAt;
+    }
+    /**
+     * Check if memory is accessible (active and not expired)
+     */
+    isAccessible() {
+        return this._status === 'active' && !this.isExpired();
+    }
+    /**
+     * Calculate age in milliseconds
+     */
+    getAge() {
+        return Date.now() - this._createdAt.getTime();
+    }
+    /**
+     * Calculate time since last access in milliseconds
+     */
+    getTimeSinceLastAccess() {
+        return Date.now() - this._lastAccessedAt.getTime();
+    }
+    /**
+     * Check if memory is considered "hot" (frequently accessed)
+     */
+    isHot(threshold = 10) {
+        return this._accessCount >= threshold;
+    }
+    /**
+     * Check if memory is considered "cold" (not accessed recently)
+     */
+    isCold(milliseconds = 3600000) {
+        return this.getTimeSinceLastAccess() > milliseconds;
+    }
+    /**
+     * Convert to plain object for persistence
+     */
+    toPersistence() {
+        return {
+            id: this._id,
+            namespace: this._namespace,
+            key: this._key,
+            value: this._value,
+            type: this._type,
+            vector: this._vector ? Array.from(this._vector) : undefined,
+            metadata: this._metadata,
+            accessCount: this._accessCount,
+            lastAccessedAt: this._lastAccessedAt.toISOString(),
+            createdAt: this._createdAt.toISOString(),
+            updatedAt: this._updatedAt.toISOString(),
+            status: this._status,
+            ttl: this._ttl,
+        };
+    }
+    /**
+     * Convert to JSON-serializable object
+     */
+    toJSON() {
+        return this.toPersistence();
+    }
+}
+//# sourceMappingURL=memory-entry.js.map