@claude-flow/memory 3.0.0-alpha.1 → 3.0.0-alpha.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (156) hide show
  1. package/README.md +356 -18
  2. package/dist/agent-memory-scope.d.ts +131 -0
  3. package/dist/agent-memory-scope.d.ts.map +1 -0
  4. package/dist/agent-memory-scope.js +215 -0
  5. package/dist/agent-memory-scope.js.map +1 -0
  6. package/dist/agent-memory-scope.test.d.ts +8 -0
  7. package/dist/agent-memory-scope.test.d.ts.map +1 -0
  8. package/dist/agent-memory-scope.test.js +463 -0
  9. package/dist/agent-memory-scope.test.js.map +1 -0
  10. package/dist/agentdb-adapter.d.ts +22 -3
  11. package/dist/agentdb-adapter.d.ts.map +1 -1
  12. package/dist/agentdb-adapter.js +135 -8
  13. package/dist/agentdb-adapter.js.map +1 -1
  14. package/dist/auto-memory-bridge.d.ts +226 -0
  15. package/dist/auto-memory-bridge.d.ts.map +1 -0
  16. package/dist/auto-memory-bridge.js +709 -0
  17. package/dist/auto-memory-bridge.js.map +1 -0
  18. package/dist/auto-memory-bridge.test.d.ts +8 -0
  19. package/dist/auto-memory-bridge.test.d.ts.map +1 -0
  20. package/dist/auto-memory-bridge.test.js +754 -0
  21. package/dist/auto-memory-bridge.test.js.map +1 -0
  22. package/dist/benchmark.test.d.ts +2 -0
  23. package/dist/benchmark.test.d.ts.map +1 -0
  24. package/dist/benchmark.test.js +277 -0
  25. package/dist/benchmark.test.js.map +1 -0
  26. package/dist/index.d.ts +8 -0
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +8 -0
  29. package/dist/index.js.map +1 -1
  30. package/dist/learning-bridge.d.ts +137 -0
  31. package/dist/learning-bridge.d.ts.map +1 -0
  32. package/dist/learning-bridge.js +335 -0
  33. package/dist/learning-bridge.js.map +1 -0
  34. package/dist/learning-bridge.test.d.ts +8 -0
  35. package/dist/learning-bridge.test.d.ts.map +1 -0
  36. package/dist/learning-bridge.test.js +578 -0
  37. package/dist/learning-bridge.test.js.map +1 -0
  38. package/dist/memory-graph.d.ts +100 -0
  39. package/dist/memory-graph.d.ts.map +1 -0
  40. package/dist/memory-graph.js +333 -0
  41. package/dist/memory-graph.js.map +1 -0
  42. package/dist/memory-graph.test.d.ts +8 -0
  43. package/dist/memory-graph.test.d.ts.map +1 -0
  44. package/dist/memory-graph.test.js +609 -0
  45. package/dist/memory-graph.test.js.map +1 -0
  46. package/dist/types.d.ts +3 -0
  47. package/dist/types.d.ts.map +1 -1
  48. package/package.json +19 -4
  49. package/.agentic-flow/intelligence.json +0 -16
  50. package/__tests__/coverage/base.css +0 -224
  51. package/__tests__/coverage/block-navigation.js +0 -87
  52. package/__tests__/coverage/coverage-final.json +0 -19
  53. package/__tests__/coverage/favicon.png +0 -0
  54. package/__tests__/coverage/index.html +0 -206
  55. package/__tests__/coverage/lcov-report/base.css +0 -224
  56. package/__tests__/coverage/lcov-report/block-navigation.js +0 -87
  57. package/__tests__/coverage/lcov-report/favicon.png +0 -0
  58. package/__tests__/coverage/lcov-report/index.html +0 -206
  59. package/__tests__/coverage/lcov-report/prettify.css +0 -1
  60. package/__tests__/coverage/lcov-report/prettify.js +0 -2
  61. package/__tests__/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  62. package/__tests__/coverage/lcov-report/sorter.js +0 -210
  63. package/__tests__/coverage/lcov-report/src/agentdb-adapter.ts.html +0 -2737
  64. package/__tests__/coverage/lcov-report/src/agentdb-backend.ts.html +0 -3130
  65. package/__tests__/coverage/lcov-report/src/application/commands/delete-memory.command.ts.html +0 -601
  66. package/__tests__/coverage/lcov-report/src/application/commands/index.html +0 -131
  67. package/__tests__/coverage/lcov-report/src/application/commands/store-memory.command.ts.html +0 -394
  68. package/__tests__/coverage/lcov-report/src/application/queries/index.html +0 -116
  69. package/__tests__/coverage/lcov-report/src/application/queries/search-memory.query.ts.html +0 -796
  70. package/__tests__/coverage/lcov-report/src/application/services/index.html +0 -116
  71. package/__tests__/coverage/lcov-report/src/application/services/memory-application-service.ts.html +0 -793
  72. package/__tests__/coverage/lcov-report/src/cache-manager.ts.html +0 -1633
  73. package/__tests__/coverage/lcov-report/src/database-provider.ts.html +0 -1618
  74. package/__tests__/coverage/lcov-report/src/domain/entities/index.html +0 -116
  75. package/__tests__/coverage/lcov-report/src/domain/entities/memory-entry.ts.html +0 -952
  76. package/__tests__/coverage/lcov-report/src/domain/services/index.html +0 -116
  77. package/__tests__/coverage/lcov-report/src/domain/services/memory-domain-service.ts.html +0 -1294
  78. package/__tests__/coverage/lcov-report/src/hnsw-index.ts.html +0 -3124
  79. package/__tests__/coverage/lcov-report/src/hybrid-backend.ts.html +0 -2167
  80. package/__tests__/coverage/lcov-report/src/index.html +0 -266
  81. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/hybrid-memory-repository.ts.html +0 -1633
  82. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/index.html +0 -116
  83. package/__tests__/coverage/lcov-report/src/migration.ts.html +0 -2092
  84. package/__tests__/coverage/lcov-report/src/query-builder.ts.html +0 -1711
  85. package/__tests__/coverage/lcov-report/src/sqlite-backend.ts.html +0 -2281
  86. package/__tests__/coverage/lcov-report/src/sqljs-backend.ts.html +0 -2374
  87. package/__tests__/coverage/lcov-report/src/types.ts.html +0 -2266
  88. package/__tests__/coverage/lcov.info +0 -10238
  89. package/__tests__/coverage/prettify.css +0 -1
  90. package/__tests__/coverage/prettify.js +0 -2
  91. package/__tests__/coverage/sort-arrow-sprite.png +0 -0
  92. package/__tests__/coverage/sorter.js +0 -210
  93. package/__tests__/coverage/src/agentdb-adapter.ts.html +0 -2737
  94. package/__tests__/coverage/src/agentdb-backend.ts.html +0 -3130
  95. package/__tests__/coverage/src/application/commands/delete-memory.command.ts.html +0 -601
  96. package/__tests__/coverage/src/application/commands/index.html +0 -131
  97. package/__tests__/coverage/src/application/commands/store-memory.command.ts.html +0 -394
  98. package/__tests__/coverage/src/application/queries/index.html +0 -116
  99. package/__tests__/coverage/src/application/queries/search-memory.query.ts.html +0 -796
  100. package/__tests__/coverage/src/application/services/index.html +0 -116
  101. package/__tests__/coverage/src/application/services/memory-application-service.ts.html +0 -793
  102. package/__tests__/coverage/src/cache-manager.ts.html +0 -1633
  103. package/__tests__/coverage/src/database-provider.ts.html +0 -1618
  104. package/__tests__/coverage/src/domain/entities/index.html +0 -116
  105. package/__tests__/coverage/src/domain/entities/memory-entry.ts.html +0 -952
  106. package/__tests__/coverage/src/domain/services/index.html +0 -116
  107. package/__tests__/coverage/src/domain/services/memory-domain-service.ts.html +0 -1294
  108. package/__tests__/coverage/src/hnsw-index.ts.html +0 -3124
  109. package/__tests__/coverage/src/hybrid-backend.ts.html +0 -2167
  110. package/__tests__/coverage/src/index.html +0 -266
  111. package/__tests__/coverage/src/infrastructure/repositories/hybrid-memory-repository.ts.html +0 -1633
  112. package/__tests__/coverage/src/infrastructure/repositories/index.html +0 -116
  113. package/__tests__/coverage/src/migration.ts.html +0 -2092
  114. package/__tests__/coverage/src/query-builder.ts.html +0 -1711
  115. package/__tests__/coverage/src/sqlite-backend.ts.html +0 -2281
  116. package/__tests__/coverage/src/sqljs-backend.ts.html +0 -2374
  117. package/__tests__/coverage/src/types.ts.html +0 -2266
  118. package/benchmarks/cache-hit-rate.bench.ts +0 -535
  119. package/benchmarks/hnsw-indexing.bench.ts +0 -552
  120. package/benchmarks/memory-write.bench.ts +0 -469
  121. package/benchmarks/vector-search.bench.ts +0 -449
  122. package/docs/AGENTDB-INTEGRATION.md +0 -388
  123. package/docs/CROSS_PLATFORM.md +0 -505
  124. package/docs/WINDOWS_SUPPORT.md +0 -422
  125. package/examples/agentdb-example.ts +0 -345
  126. package/examples/cross-platform-usage.ts +0 -326
  127. package/framework/benchmark.ts +0 -112
  128. package/src/agentdb-adapter.ts +0 -884
  129. package/src/agentdb-backend.test.ts +0 -339
  130. package/src/agentdb-backend.ts +0 -1016
  131. package/src/application/commands/delete-memory.command.ts +0 -172
  132. package/src/application/commands/store-memory.command.ts +0 -103
  133. package/src/application/index.ts +0 -36
  134. package/src/application/queries/search-memory.query.ts +0 -237
  135. package/src/application/services/memory-application-service.ts +0 -236
  136. package/src/cache-manager.ts +0 -516
  137. package/src/database-provider.test.ts +0 -364
  138. package/src/database-provider.ts +0 -511
  139. package/src/domain/entities/memory-entry.ts +0 -289
  140. package/src/domain/index.ts +0 -35
  141. package/src/domain/repositories/memory-repository.interface.ts +0 -120
  142. package/src/domain/services/memory-domain-service.ts +0 -403
  143. package/src/hnsw-index.ts +0 -1013
  144. package/src/hybrid-backend.test.ts +0 -399
  145. package/src/hybrid-backend.ts +0 -694
  146. package/src/index.ts +0 -515
  147. package/src/infrastructure/index.ts +0 -23
  148. package/src/infrastructure/repositories/hybrid-memory-repository.ts +0 -516
  149. package/src/migration.ts +0 -669
  150. package/src/query-builder.ts +0 -542
  151. package/src/sqlite-backend.ts +0 -732
  152. package/src/sqljs-backend.ts +0 -763
  153. package/src/types.ts +0 -727
  154. package/tsconfig.json +0 -9
  155. package/tsconfig.tsbuildinfo +0 -1
  156. package/verify-cross-platform.ts +0 -170
@@ -1,364 +0,0 @@
1
- /**
2
- * Database Provider Tests - Cross-Platform Compatibility
3
- *
4
- * Tests for platform-aware database selection and fallback mechanisms
5
- */
6
-
7
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
8
- import { createDatabase, getPlatformInfo, getAvailableProviders } from './database-provider.js';
9
- import { generateMemoryId, createDefaultEntry } from './types.js';
10
- import { unlinkSync, existsSync } from 'node:fs';
11
-
12
- describe('DatabaseProvider', () => {
13
- const testDbPath = './test-database-provider.db';
14
-
15
- afterEach(() => {
16
- // Cleanup test database
17
- if (existsSync(testDbPath)) {
18
- try {
19
- unlinkSync(testDbPath);
20
- } catch (error) {
21
- // Ignore cleanup errors
22
- }
23
- }
24
- });
25
-
26
- describe('Platform Detection', () => {
27
- it('should detect platform information', () => {
28
- const info = getPlatformInfo();
29
-
30
- expect(info).toHaveProperty('os');
31
- expect(info).toHaveProperty('isWindows');
32
- expect(info).toHaveProperty('isMacOS');
33
- expect(info).toHaveProperty('isLinux');
34
- expect(info).toHaveProperty('recommendedProvider');
35
-
36
- // Should recommend sql.js on Windows, better-sqlite3 on Unix
37
- if (info.isWindows) {
38
- expect(info.recommendedProvider).toBe('sql.js');
39
- } else {
40
- expect(info.recommendedProvider).toBe('better-sqlite3');
41
- }
42
- });
43
- });
44
-
45
- describe('Provider Availability', () => {
46
- it('should check available providers', async () => {
47
- const available = await getAvailableProviders();
48
-
49
- expect(available).toHaveProperty('betterSqlite3');
50
- expect(available).toHaveProperty('sqlJs');
51
- expect(available).toHaveProperty('json');
52
-
53
- // JSON backend should always be available
54
- expect(available.json).toBe(true);
55
- });
56
- });
57
-
58
- describe('Automatic Provider Selection', () => {
59
- it('should create database with auto provider selection', async () => {
60
- const db = await createDatabase(':memory:');
61
-
62
- expect(db).toBeDefined();
63
- await expect(db.count()).resolves.toBe(0);
64
-
65
- await db.shutdown();
66
- });
67
-
68
- it('should create persistent database with auto provider', async () => {
69
- const db = await createDatabase(testDbPath);
70
-
71
- expect(db).toBeDefined();
72
-
73
- // Store test entry
74
- const entry = createDefaultEntry({
75
- key: 'test-key',
76
- content: 'test content',
77
- namespace: 'test',
78
- });
79
-
80
- await db.store(entry);
81
- await expect(db.count()).resolves.toBe(1);
82
-
83
- await db.shutdown();
84
- });
85
- });
86
-
87
- describe('Explicit Provider Selection', () => {
88
- it('should create database with sql.js provider', async () => {
89
- const available = await getAvailableProviders();
90
-
91
- if (!available.sqlJs) {
92
- console.log('sql.js not available, skipping test');
93
- return;
94
- }
95
-
96
- const db = await createDatabase(':memory:', {
97
- provider: 'sql.js',
98
- verbose: false,
99
- });
100
-
101
- expect(db).toBeDefined();
102
-
103
- // Test basic operations
104
- const entry = createDefaultEntry({
105
- key: 'sqljs-test',
106
- content: 'testing sql.js backend',
107
- namespace: 'test',
108
- });
109
-
110
- await db.store(entry);
111
- await expect(db.count()).resolves.toBe(1);
112
-
113
- const retrieved = await db.get(entry.id);
114
- expect(retrieved).toBeDefined();
115
- expect(retrieved?.key).toBe('sqljs-test');
116
-
117
- await db.shutdown();
118
- });
119
-
120
- it('should create database with better-sqlite3 provider', async () => {
121
- const available = await getAvailableProviders();
122
-
123
- if (!available.betterSqlite3) {
124
- console.log('better-sqlite3 not available, skipping test');
125
- return;
126
- }
127
-
128
- const db = await createDatabase(':memory:', {
129
- provider: 'better-sqlite3',
130
- verbose: false,
131
- });
132
-
133
- expect(db).toBeDefined();
134
-
135
- // Test basic operations
136
- const entry = createDefaultEntry({
137
- key: 'sqlite-test',
138
- content: 'testing better-sqlite3 backend',
139
- namespace: 'test',
140
- });
141
-
142
- await db.store(entry);
143
- await expect(db.count()).resolves.toBe(1);
144
-
145
- const retrieved = await db.get(entry.id);
146
- expect(retrieved).toBeDefined();
147
- expect(retrieved?.key).toBe('sqlite-test');
148
-
149
- await db.shutdown();
150
- });
151
-
152
- it('should create database with JSON provider', async () => {
153
- const db = await createDatabase(testDbPath, {
154
- provider: 'json',
155
- verbose: false,
156
- });
157
-
158
- expect(db).toBeDefined();
159
-
160
- // Test basic operations
161
- const entry = createDefaultEntry({
162
- key: 'json-test',
163
- content: 'testing JSON backend',
164
- namespace: 'test',
165
- });
166
-
167
- await db.store(entry);
168
- await expect(db.count()).resolves.toBe(1);
169
-
170
- const retrieved = await db.get(entry.id);
171
- expect(retrieved).toBeDefined();
172
- expect(retrieved?.key).toBe('json-test');
173
-
174
- await db.shutdown();
175
- });
176
- });
177
-
178
- describe('Cross-Platform Functionality', () => {
179
- it('should handle CRUD operations consistently across providers', async () => {
180
- const available = await getAvailableProviders();
181
- const providers: Array<'better-sqlite3' | 'sql.js' | 'json'> = [];
182
-
183
- if (available.betterSqlite3) providers.push('better-sqlite3');
184
- if (available.sqlJs) providers.push('sql.js');
185
- providers.push('json'); // Always available
186
-
187
- for (const provider of providers) {
188
- const db = await createDatabase(':memory:', { provider });
189
-
190
- // Create
191
- const entry = createDefaultEntry({
192
- key: `test-${provider}`,
193
- content: `testing ${provider}`,
194
- namespace: 'cross-platform',
195
- tags: ['test', provider],
196
- });
197
-
198
- await db.store(entry);
199
-
200
- // Read
201
- const retrieved = await db.get(entry.id);
202
- expect(retrieved).toBeDefined();
203
- expect(retrieved?.key).toBe(`test-${provider}`);
204
- expect(retrieved?.tags).toContain(provider);
205
-
206
- // Update
207
- const updated = await db.update(entry.id, {
208
- content: `updated ${provider}`,
209
- });
210
- expect(updated).toBeDefined();
211
- expect(updated?.content).toBe(`updated ${provider}`);
212
-
213
- // Query
214
- const results = await db.query({
215
- type: 'hybrid',
216
- namespace: 'cross-platform',
217
- limit: 10,
218
- });
219
- expect(results.length).toBe(1);
220
- expect(results[0].key).toBe(`test-${provider}`);
221
-
222
- // Delete
223
- const deleted = await db.delete(entry.id);
224
- expect(deleted).toBe(true);
225
-
226
- await expect(db.count()).resolves.toBe(0);
227
-
228
- await db.shutdown();
229
- }
230
- });
231
-
232
- it('should handle namespace operations across providers', async () => {
233
- const db = await createDatabase(':memory:');
234
-
235
- // Create entries in different namespaces
236
- const entries = [
237
- createDefaultEntry({ key: 'entry1', content: 'content1', namespace: 'ns1' }),
238
- createDefaultEntry({ key: 'entry2', content: 'content2', namespace: 'ns1' }),
239
- createDefaultEntry({ key: 'entry3', content: 'content3', namespace: 'ns2' }),
240
- ];
241
-
242
- for (const entry of entries) {
243
- await db.store(entry);
244
- }
245
-
246
- // List namespaces
247
- const namespaces = await db.listNamespaces();
248
- expect(namespaces).toContain('ns1');
249
- expect(namespaces).toContain('ns2');
250
-
251
- // Count by namespace
252
- await expect(db.count('ns1')).resolves.toBe(2);
253
- await expect(db.count('ns2')).resolves.toBe(1);
254
-
255
- // Clear namespace
256
- const cleared = await db.clearNamespace('ns1');
257
- expect(cleared).toBe(2);
258
- await expect(db.count('ns1')).resolves.toBe(0);
259
- await expect(db.count('ns2')).resolves.toBe(1);
260
-
261
- await db.shutdown();
262
- });
263
-
264
- it('should handle bulk operations across providers', async () => {
265
- const db = await createDatabase(':memory:');
266
-
267
- // Bulk insert
268
- const entries = Array.from({ length: 10 }, (_, i) =>
269
- createDefaultEntry({
270
- key: `bulk-${i}`,
271
- content: `content ${i}`,
272
- namespace: 'bulk-test',
273
- })
274
- );
275
-
276
- await db.bulkInsert(entries);
277
- await expect(db.count('bulk-test')).resolves.toBe(10);
278
-
279
- // Bulk delete
280
- const idsToDelete = entries.slice(0, 5).map((e) => e.id);
281
- const deletedCount = await db.bulkDelete(idsToDelete);
282
- expect(deletedCount).toBe(5);
283
- await expect(db.count('bulk-test')).resolves.toBe(5);
284
-
285
- await db.shutdown();
286
- });
287
- });
288
-
289
- describe('Health Check', () => {
290
- it('should perform health check', async () => {
291
- const db = await createDatabase(':memory:');
292
-
293
- const health = await db.healthCheck();
294
-
295
- expect(health).toHaveProperty('status');
296
- expect(health).toHaveProperty('components');
297
- expect(health).toHaveProperty('timestamp');
298
- expect(health).toHaveProperty('issues');
299
- expect(health).toHaveProperty('recommendations');
300
-
301
- expect(health.components).toHaveProperty('storage');
302
- expect(health.components).toHaveProperty('index');
303
- expect(health.components).toHaveProperty('cache');
304
-
305
- await db.shutdown();
306
- });
307
- });
308
-
309
- describe('Statistics', () => {
310
- it('should provide backend statistics', async () => {
311
- const db = await createDatabase(':memory:');
312
-
313
- // Add some test data
314
- const entries = [
315
- createDefaultEntry({ key: 'stat1', content: 'content1', namespace: 'stats', type: 'semantic' }),
316
- createDefaultEntry({ key: 'stat2', content: 'content2', namespace: 'stats', type: 'episodic' }),
317
- createDefaultEntry({ key: 'stat3', content: 'content3', namespace: 'stats', type: 'semantic' }),
318
- ];
319
-
320
- for (const entry of entries) {
321
- await db.store(entry);
322
- }
323
-
324
- const stats = await db.getStats();
325
-
326
- expect(stats).toHaveProperty('totalEntries');
327
- expect(stats).toHaveProperty('entriesByNamespace');
328
- expect(stats).toHaveProperty('entriesByType');
329
- expect(stats).toHaveProperty('memoryUsage');
330
- expect(stats).toHaveProperty('avgQueryTime');
331
-
332
- expect(stats.totalEntries).toBe(3);
333
-
334
- await db.shutdown();
335
- });
336
- });
337
-
338
- describe('Error Handling', () => {
339
- it('should handle missing entries gracefully', async () => {
340
- const db = await createDatabase(':memory:');
341
-
342
- const entry = await db.get('non-existent-id');
343
- expect(entry).toBeNull();
344
-
345
- const byKey = await db.getByKey('non-existent-ns', 'non-existent-key');
346
- expect(byKey).toBeNull();
347
-
348
- await db.shutdown();
349
- });
350
-
351
- it('should handle empty queries', async () => {
352
- const db = await createDatabase(':memory:');
353
-
354
- const results = await db.query({
355
- type: 'hybrid',
356
- limit: 10,
357
- });
358
-
359
- expect(results).toEqual([]);
360
-
361
- await db.shutdown();
362
- });
363
- });
364
- });