@claude-flow/cli 3.0.0-alpha.13 → 3.0.0-alpha.14

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 (102) hide show
  1. package/package.json +12 -4
  2. package/.agentic-flow/intelligence.json +0 -17
  3. package/.claude-flow/agents/store.json +0 -16
  4. package/.claude-flow/daemon-state.json +0 -123
  5. package/.claude-flow/daemon-test.log +0 -0
  6. package/.claude-flow/daemon.log +0 -0
  7. package/.claude-flow/daemon2.log +0 -0
  8. package/.claude-flow/daemon3.log +0 -0
  9. package/.claude-flow/hive-mind/state.json +0 -51
  10. package/.claude-flow/metrics/agent-metrics.json +0 -1
  11. package/.claude-flow/metrics/codebase-map.json +0 -11
  12. package/.claude-flow/metrics/consolidation.json +0 -6
  13. package/.claude-flow/metrics/performance.json +0 -87
  14. package/.claude-flow/metrics/security-audit.json +0 -10
  15. package/.claude-flow/metrics/task-metrics.json +0 -10
  16. package/.claude-flow/metrics/test-gaps.json +0 -6
  17. package/__tests__/README.md +0 -140
  18. package/__tests__/TEST_SUMMARY.md +0 -144
  19. package/__tests__/cli.test.ts +0 -558
  20. package/__tests__/commands.test.ts +0 -726
  21. package/__tests__/config-adapter.test.ts +0 -362
  22. package/__tests__/config-loading.test.ts +0 -106
  23. package/__tests__/coverage/.tmp/coverage-0.json +0 -1
  24. package/__tests__/coverage/.tmp/coverage-1.json +0 -1
  25. package/__tests__/coverage/.tmp/coverage-2.json +0 -1
  26. package/__tests__/coverage/.tmp/coverage-3.json +0 -1
  27. package/__tests__/coverage/.tmp/coverage-4.json +0 -1
  28. package/__tests__/coverage/.tmp/coverage-5.json +0 -1
  29. package/__tests__/mcp-client.test.ts +0 -480
  30. package/__tests__/p1-commands.test.ts +0 -1064
  31. package/agents/architect.yaml +0 -11
  32. package/agents/coder.yaml +0 -11
  33. package/agents/reviewer.yaml +0 -10
  34. package/agents/security-architect.yaml +0 -10
  35. package/agents/tester.yaml +0 -10
  36. package/docs/CONFIG_LOADING.md +0 -236
  37. package/docs/IMPLEMENTATION_COMPLETE.md +0 -421
  38. package/docs/MCP_CLIENT_GUIDE.md +0 -620
  39. package/docs/REFACTORING_SUMMARY.md +0 -247
  40. package/scripts/publish.sh +0 -46
  41. package/src/commands/agent.ts +0 -955
  42. package/src/commands/claims.ts +0 -317
  43. package/src/commands/completions.ts +0 -558
  44. package/src/commands/config.ts +0 -452
  45. package/src/commands/daemon.ts +0 -621
  46. package/src/commands/deployment.ts +0 -323
  47. package/src/commands/doctor.ts +0 -382
  48. package/src/commands/embeddings.ts +0 -686
  49. package/src/commands/hive-mind.ts +0 -928
  50. package/src/commands/hooks.ts +0 -2603
  51. package/src/commands/index.ts +0 -154
  52. package/src/commands/init.ts +0 -597
  53. package/src/commands/mcp.ts +0 -753
  54. package/src/commands/memory.ts +0 -1161
  55. package/src/commands/migrate.ts +0 -447
  56. package/src/commands/neural.ts +0 -253
  57. package/src/commands/performance.ts +0 -292
  58. package/src/commands/plugins.ts +0 -316
  59. package/src/commands/process.ts +0 -695
  60. package/src/commands/providers.ts +0 -259
  61. package/src/commands/security.ts +0 -288
  62. package/src/commands/session.ts +0 -891
  63. package/src/commands/start.ts +0 -457
  64. package/src/commands/status.ts +0 -736
  65. package/src/commands/swarm.ts +0 -648
  66. package/src/commands/task.ts +0 -792
  67. package/src/commands/workflow.ts +0 -742
  68. package/src/config-adapter.ts +0 -210
  69. package/src/index.ts +0 -443
  70. package/src/infrastructure/in-memory-repositories.ts +0 -310
  71. package/src/init/claudemd-generator.ts +0 -631
  72. package/src/init/executor.ts +0 -762
  73. package/src/init/helpers-generator.ts +0 -628
  74. package/src/init/index.ts +0 -60
  75. package/src/init/mcp-generator.ts +0 -83
  76. package/src/init/settings-generator.ts +0 -284
  77. package/src/init/statusline-generator.ts +0 -211
  78. package/src/init/types.ts +0 -447
  79. package/src/mcp-client.ts +0 -241
  80. package/src/mcp-server.ts +0 -577
  81. package/src/mcp-tools/agent-tools.ts +0 -466
  82. package/src/mcp-tools/config-tools.ts +0 -370
  83. package/src/mcp-tools/hive-mind-tools.ts +0 -521
  84. package/src/mcp-tools/hooks-tools.ts +0 -1888
  85. package/src/mcp-tools/index.ts +0 -16
  86. package/src/mcp-tools/memory-tools.ts +0 -270
  87. package/src/mcp-tools/session-tools.ts +0 -359
  88. package/src/mcp-tools/swarm-tools.ts +0 -105
  89. package/src/mcp-tools/task-tools.ts +0 -347
  90. package/src/mcp-tools/types.ts +0 -33
  91. package/src/mcp-tools/workflow-tools.ts +0 -573
  92. package/src/output.ts +0 -639
  93. package/src/parser.ts +0 -417
  94. package/src/prompt.ts +0 -619
  95. package/src/services/index.ts +0 -15
  96. package/src/services/worker-daemon.ts +0 -726
  97. package/src/suggest.ts +0 -245
  98. package/src/types.ts +0 -287
  99. package/tmp.json +0 -0
  100. package/tsconfig.json +0 -16
  101. package/tsconfig.tsbuildinfo +0 -1
  102. package/vitest.config.ts +0 -13
@@ -1,1161 +0,0 @@
1
- /**
2
- * V3 CLI Memory Command
3
- * Memory operations for AgentDB integration
4
- */
5
-
6
- import type { Command, CommandContext, CommandResult } from '../types.js';
7
- import { output } from '../output.js';
8
- import { select, confirm, input } from '../prompt.js';
9
- import { callMCPTool, MCPClientError } from '../mcp-client.js';
10
-
11
- // Memory backends
12
- const BACKENDS = [
13
- { value: 'agentdb', label: 'AgentDB', hint: 'Vector database with HNSW indexing (150x-12,500x faster)' },
14
- { value: 'sqlite', label: 'SQLite', hint: 'Lightweight local storage' },
15
- { value: 'hybrid', label: 'Hybrid', hint: 'SQLite + AgentDB (recommended)' },
16
- { value: 'memory', label: 'In-Memory', hint: 'Fast but non-persistent' }
17
- ];
18
-
19
- // Store command
20
- const storeCommand: Command = {
21
- name: 'store',
22
- description: 'Store data in memory',
23
- options: [
24
- {
25
- name: 'key',
26
- short: 'k',
27
- description: 'Storage key/namespace',
28
- type: 'string',
29
- required: true
30
- },
31
- {
32
- name: 'value',
33
- // Note: No short flag - global -v is reserved for verbose
34
- description: 'Value to store (use --value)',
35
- type: 'string'
36
- },
37
- {
38
- name: 'namespace',
39
- short: 'n',
40
- description: 'Memory namespace',
41
- type: 'string',
42
- default: 'default'
43
- },
44
- {
45
- name: 'ttl',
46
- description: 'Time to live in seconds',
47
- type: 'number'
48
- },
49
- {
50
- name: 'tags',
51
- description: 'Comma-separated tags',
52
- type: 'string'
53
- },
54
- {
55
- name: 'vector',
56
- description: 'Store as vector embedding',
57
- type: 'boolean',
58
- default: false
59
- }
60
- ],
61
- examples: [
62
- { command: 'claude-flow memory store -k "api/auth" -v "JWT implementation"', description: 'Store text' },
63
- { command: 'claude-flow memory store -k "pattern/singleton" --vector', description: 'Store vector' }
64
- ],
65
- action: async (ctx: CommandContext): Promise<CommandResult> => {
66
- const key = ctx.flags.key as string;
67
- let value = ctx.flags.value as string || ctx.args[0];
68
- const namespace = ctx.flags.namespace as string;
69
- const ttl = ctx.flags.ttl as number;
70
- const tags = ctx.flags.tags ? (ctx.flags.tags as string).split(',') : [];
71
- const asVector = ctx.flags.vector as boolean;
72
-
73
- if (!key) {
74
- output.printError('Key is required. Use --key or -k');
75
- return { success: false, exitCode: 1 };
76
- }
77
-
78
- if (!value && ctx.interactive) {
79
- value = await input({
80
- message: 'Enter value to store:',
81
- validate: (v) => v.length > 0 || 'Value is required'
82
- });
83
- }
84
-
85
- if (!value) {
86
- output.printError('Value is required. Use --value or -v');
87
- return { success: false, exitCode: 1 };
88
- }
89
-
90
- const storeData = {
91
- key,
92
- namespace,
93
- value,
94
- ttl,
95
- tags,
96
- asVector,
97
- storedAt: new Date().toISOString(),
98
- size: Buffer.byteLength(value, 'utf8')
99
- };
100
-
101
- output.printInfo(`Storing in ${namespace}/${key}...`);
102
-
103
- if (asVector) {
104
- output.writeln(output.dim(' Generating embedding vector...'));
105
- output.writeln(output.dim(' Indexing with HNSW (M=16, ef=200)...'));
106
- }
107
-
108
- // Call MCP memory/store tool for real persistence
109
- try {
110
- const result = await callMCPTool('memory/store', {
111
- key,
112
- value,
113
- metadata: { namespace, tags, ttl, asVector, size: storeData.size }
114
- });
115
-
116
- output.writeln();
117
- output.printTable({
118
- columns: [
119
- { key: 'property', header: 'Property', width: 15 },
120
- { key: 'val', header: 'Value', width: 40 }
121
- ],
122
- data: [
123
- { property: 'Key', val: key },
124
- { property: 'Namespace', val: namespace },
125
- { property: 'Size', val: `${storeData.size} bytes` },
126
- { property: 'TTL', val: ttl ? `${ttl}s` : 'None' },
127
- { property: 'Tags', val: tags.length > 0 ? tags.join(', ') : 'None' },
128
- { property: 'Vector', val: asVector ? 'Yes' : 'No' },
129
- { property: 'Total Entries', val: String((result as { totalEntries?: number }).totalEntries || 1) }
130
- ]
131
- });
132
-
133
- output.writeln();
134
- output.printSuccess('Data stored successfully');
135
-
136
- return { success: true, data: { ...storeData, ...(result as Record<string, unknown>) } };
137
- } catch (error) {
138
- output.printError(`Failed to store: ${error instanceof Error ? error.message : 'Unknown error'}`);
139
- return { success: false, exitCode: 1 };
140
- }
141
- }
142
- };
143
-
144
- // Retrieve command
145
- const retrieveCommand: Command = {
146
- name: 'retrieve',
147
- aliases: ['get'],
148
- description: 'Retrieve data from memory',
149
- options: [
150
- {
151
- name: 'key',
152
- short: 'k',
153
- description: 'Storage key',
154
- type: 'string'
155
- },
156
- {
157
- name: 'namespace',
158
- short: 'n',
159
- description: 'Memory namespace',
160
- type: 'string',
161
- default: 'default'
162
- }
163
- ],
164
- action: async (ctx: CommandContext): Promise<CommandResult> => {
165
- const key = ctx.flags.key as string || ctx.args[0];
166
- const namespace = ctx.flags.namespace as string;
167
-
168
- if (!key) {
169
- output.printError('Key is required');
170
- return { success: false, exitCode: 1 };
171
- }
172
-
173
- // Call MCP memory/retrieve tool for real data
174
- try {
175
- const result = await callMCPTool('memory/retrieve', { key }) as {
176
- key: string;
177
- value: unknown;
178
- metadata?: Record<string, unknown>;
179
- storedAt?: string;
180
- accessCount?: number;
181
- found: boolean;
182
- };
183
-
184
- if (!result.found) {
185
- output.printWarning(`Key not found: ${key}`);
186
- return { success: false, exitCode: 1, data: { key, found: false } };
187
- }
188
-
189
- const data = {
190
- key: result.key,
191
- namespace,
192
- value: result.value,
193
- metadata: {
194
- storedAt: result.storedAt || 'Unknown',
195
- accessCount: result.accessCount || 0,
196
- lastAccessed: new Date().toISOString(),
197
- ...(result.metadata || {})
198
- }
199
- };
200
-
201
- if (ctx.flags.format === 'json') {
202
- output.printJson(data);
203
- return { success: true, data };
204
- }
205
-
206
- const metaTags = (result.metadata?.tags as string[]) || [];
207
- const metaSize = (result.metadata?.size as number) || String(data.value).length;
208
-
209
- output.writeln();
210
- output.printBox(
211
- [
212
- `Namespace: ${namespace}`,
213
- `Key: ${data.key}`,
214
- `Size: ${metaSize} bytes`,
215
- `Access Count: ${data.metadata.accessCount}`,
216
- `Tags: ${metaTags.length > 0 ? metaTags.join(', ') : 'None'}`,
217
- '',
218
- output.bold('Value:'),
219
- typeof data.value === 'string' ? data.value : JSON.stringify(data.value, null, 2)
220
- ].join('\n'),
221
- 'Memory Entry'
222
- );
223
-
224
- return { success: true, data };
225
- } catch (error) {
226
- output.printError(`Failed to retrieve: ${error instanceof Error ? error.message : 'Unknown error'}`);
227
- return { success: false, exitCode: 1 };
228
- }
229
- }
230
- };
231
-
232
- // Search command
233
- const searchCommand: Command = {
234
- name: 'search',
235
- description: 'Search memory with semantic/vector search',
236
- options: [
237
- {
238
- name: 'query',
239
- short: 'q',
240
- description: 'Search query',
241
- type: 'string',
242
- required: true
243
- },
244
- {
245
- name: 'namespace',
246
- short: 'n',
247
- description: 'Memory namespace',
248
- type: 'string'
249
- },
250
- {
251
- name: 'limit',
252
- short: 'l',
253
- description: 'Maximum results',
254
- type: 'number',
255
- default: 10
256
- },
257
- {
258
- name: 'threshold',
259
- description: 'Similarity threshold (0-1)',
260
- type: 'number',
261
- default: 0.7
262
- },
263
- {
264
- name: 'type',
265
- short: 't',
266
- description: 'Search type (semantic, keyword, hybrid)',
267
- type: 'string',
268
- default: 'semantic',
269
- choices: ['semantic', 'keyword', 'hybrid']
270
- }
271
- ],
272
- examples: [
273
- { command: 'claude-flow memory search -q "authentication patterns"', description: 'Semantic search' },
274
- { command: 'claude-flow memory search -q "JWT" -t keyword', description: 'Keyword search' }
275
- ],
276
- action: async (ctx: CommandContext): Promise<CommandResult> => {
277
- const query = ctx.flags.query as string || ctx.args[0];
278
- const namespace = ctx.flags.namespace as string;
279
- const limit = ctx.flags.limit as number;
280
- const threshold = ctx.flags.threshold as number;
281
- const searchType = ctx.flags.type as string;
282
-
283
- if (!query) {
284
- output.printError('Query is required. Use --query or -q');
285
- return { success: false, exitCode: 1 };
286
- }
287
-
288
- output.printInfo(`Searching: "${query}" (${searchType})`);
289
- output.writeln();
290
-
291
- // Call MCP memory/search tool for real results
292
- try {
293
- const searchResult = await callMCPTool('memory/search', { query, limit }) as {
294
- query: string;
295
- results: Array<{ key: string; value: unknown; score: number; storedAt: string }>;
296
- total: number;
297
- searchTime: string;
298
- };
299
-
300
- const results = searchResult.results.map(r => ({
301
- key: r.key,
302
- score: r.score,
303
- namespace: namespace || 'default',
304
- preview: typeof r.value === 'string'
305
- ? r.value.substring(0, 40) + (r.value.length > 40 ? '...' : '')
306
- : JSON.stringify(r.value).substring(0, 40)
307
- }));
308
-
309
- if (ctx.flags.format === 'json') {
310
- output.printJson({ query, searchType, results, searchTime: searchResult.searchTime });
311
- return { success: true, data: results };
312
- }
313
-
314
- // Performance stats
315
- output.writeln(output.dim(` Search time: ${searchResult.searchTime}`));
316
- output.writeln();
317
-
318
- if (results.length === 0) {
319
- output.printWarning('No results found');
320
- return { success: true, data: [] };
321
- }
322
-
323
- output.printTable({
324
- columns: [
325
- { key: 'key', header: 'Key', width: 20 },
326
- { key: 'score', header: 'Score', width: 8, align: 'right', format: (v) => Number(v).toFixed(2) },
327
- { key: 'namespace', header: 'Namespace', width: 12 },
328
- { key: 'preview', header: 'Preview', width: 35 }
329
- ],
330
- data: results
331
- });
332
-
333
- output.writeln();
334
- output.printInfo(`Found ${results.length} results`);
335
-
336
- return { success: true, data: results };
337
- } catch (error) {
338
- output.printError(`Search failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
339
- return { success: false, exitCode: 1 };
340
- }
341
- }
342
- };
343
-
344
- // List command
345
- const listCommand: Command = {
346
- name: 'list',
347
- aliases: ['ls'],
348
- description: 'List memory entries',
349
- options: [
350
- {
351
- name: 'namespace',
352
- short: 'n',
353
- description: 'Filter by namespace',
354
- type: 'string'
355
- },
356
- {
357
- name: 'tags',
358
- short: 't',
359
- description: 'Filter by tags (comma-separated)',
360
- type: 'string'
361
- },
362
- {
363
- name: 'limit',
364
- short: 'l',
365
- description: 'Maximum entries',
366
- type: 'number',
367
- default: 20
368
- }
369
- ],
370
- action: async (ctx: CommandContext): Promise<CommandResult> => {
371
- const namespace = ctx.flags.namespace as string;
372
- const limit = ctx.flags.limit as number;
373
-
374
- // Call MCP memory/list tool for real entries
375
- try {
376
- const listResult = await callMCPTool('memory/list', { limit, offset: 0 }) as {
377
- entries: Array<{ key: string; storedAt: string; accessCount: number; preview: string }>;
378
- total: number;
379
- limit: number;
380
- offset: number;
381
- };
382
-
383
- // Format entries for display
384
- const entries = listResult.entries.map(e => ({
385
- key: e.key,
386
- namespace: namespace || 'default',
387
- size: e.preview.length + ' B',
388
- accessCount: e.accessCount,
389
- updated: formatRelativeTime(e.storedAt)
390
- }));
391
-
392
- if (ctx.flags.format === 'json') {
393
- output.printJson(entries);
394
- return { success: true, data: entries };
395
- }
396
-
397
- output.writeln();
398
- output.writeln(output.bold('Memory Entries'));
399
- output.writeln();
400
-
401
- if (entries.length === 0) {
402
- output.printWarning('No entries found');
403
- return { success: true, data: [] };
404
- }
405
-
406
- output.printTable({
407
- columns: [
408
- { key: 'key', header: 'Key', width: 25 },
409
- { key: 'namespace', header: 'Namespace', width: 12 },
410
- { key: 'size', header: 'Size', width: 10, align: 'right' },
411
- { key: 'accessCount', header: 'Accessed', width: 10, align: 'right' },
412
- { key: 'updated', header: 'Updated', width: 12 }
413
- ],
414
- data: entries
415
- });
416
-
417
- output.writeln();
418
- output.printInfo(`Showing ${entries.length} of ${listResult.total} entries`);
419
-
420
- return { success: true, data: entries };
421
- } catch (error) {
422
- output.printError(`Failed to list: ${error instanceof Error ? error.message : 'Unknown error'}`);
423
- return { success: false, exitCode: 1 };
424
- }
425
- }
426
- };
427
-
428
- // Helper function to format relative time
429
- function formatRelativeTime(isoDate: string): string {
430
- const now = Date.now();
431
- const date = new Date(isoDate).getTime();
432
- const diff = now - date;
433
-
434
- const seconds = Math.floor(diff / 1000);
435
- const minutes = Math.floor(seconds / 60);
436
- const hours = Math.floor(minutes / 60);
437
- const days = Math.floor(hours / 24);
438
-
439
- if (days > 0) return `${days}d ago`;
440
- if (hours > 0) return `${hours}h ago`;
441
- if (minutes > 0) return `${minutes}m ago`;
442
- return 'just now';
443
- }
444
-
445
- // Delete command
446
- const deleteCommand: Command = {
447
- name: 'delete',
448
- aliases: ['rm'],
449
- description: 'Delete memory entry',
450
- options: [
451
- {
452
- name: 'force',
453
- short: 'f',
454
- description: 'Skip confirmation',
455
- type: 'boolean',
456
- default: false
457
- }
458
- ],
459
- action: async (ctx: CommandContext): Promise<CommandResult> => {
460
- const key = ctx.args[0];
461
- const force = ctx.flags.force as boolean;
462
-
463
- if (!key) {
464
- output.printError('Key is required');
465
- return { success: false, exitCode: 1 };
466
- }
467
-
468
- if (!force && ctx.interactive) {
469
- const confirmed = await confirm({
470
- message: `Delete memory entry "${key}"?`,
471
- default: false
472
- });
473
-
474
- if (!confirmed) {
475
- output.printInfo('Operation cancelled');
476
- return { success: true };
477
- }
478
- }
479
-
480
- // Call MCP memory/delete tool
481
- try {
482
- const result = await callMCPTool('memory/delete', { key }) as {
483
- success: boolean;
484
- key: string;
485
- deleted: boolean;
486
- remainingEntries: number;
487
- };
488
-
489
- if (result.deleted) {
490
- output.printSuccess(`Deleted ${key}`);
491
- output.printInfo(`Remaining entries: ${result.remainingEntries}`);
492
- } else {
493
- output.printWarning(`Key not found: ${key}`);
494
- }
495
-
496
- return { success: result.deleted, data: result };
497
- } catch (error) {
498
- output.printError(`Failed to delete: ${error instanceof Error ? error.message : 'Unknown error'}`);
499
- return { success: false, exitCode: 1 };
500
- }
501
- }
502
- };
503
-
504
- // Stats command
505
- const statsCommand: Command = {
506
- name: 'stats',
507
- description: 'Show memory statistics',
508
- action: async (ctx: CommandContext): Promise<CommandResult> => {
509
- // Call MCP memory/stats tool for real statistics
510
- try {
511
- const statsResult = await callMCPTool('memory/stats', {}) as {
512
- totalEntries: number;
513
- totalSize: string;
514
- version: string;
515
- backend: string;
516
- location: string;
517
- oldestEntry: string | null;
518
- newestEntry: string | null;
519
- };
520
-
521
- const stats = {
522
- backend: statsResult.backend,
523
- entries: {
524
- total: statsResult.totalEntries,
525
- vectors: 0, // Would need vector backend support
526
- text: statsResult.totalEntries
527
- },
528
- storage: {
529
- total: statsResult.totalSize,
530
- location: statsResult.location
531
- },
532
- version: statsResult.version,
533
- oldestEntry: statsResult.oldestEntry,
534
- newestEntry: statsResult.newestEntry
535
- };
536
-
537
- if (ctx.flags.format === 'json') {
538
- output.printJson(stats);
539
- return { success: true, data: stats };
540
- }
541
-
542
- output.writeln();
543
- output.writeln(output.bold('Memory Statistics'));
544
- output.writeln();
545
-
546
- output.writeln(output.bold('Overview'));
547
- output.printTable({
548
- columns: [
549
- { key: 'metric', header: 'Metric', width: 20 },
550
- { key: 'value', header: 'Value', width: 30, align: 'right' }
551
- ],
552
- data: [
553
- { metric: 'Backend', value: stats.backend },
554
- { metric: 'Version', value: stats.version },
555
- { metric: 'Total Entries', value: stats.entries.total.toLocaleString() },
556
- { metric: 'Total Storage', value: stats.storage.total },
557
- { metric: 'Location', value: stats.storage.location }
558
- ]
559
- });
560
-
561
- output.writeln();
562
- output.writeln(output.bold('Timeline'));
563
- output.printTable({
564
- columns: [
565
- { key: 'metric', header: 'Metric', width: 20 },
566
- { key: 'value', header: 'Value', width: 30, align: 'right' }
567
- ],
568
- data: [
569
- { metric: 'Oldest Entry', value: stats.oldestEntry || 'N/A' },
570
- { metric: 'Newest Entry', value: stats.newestEntry || 'N/A' }
571
- ]
572
- });
573
-
574
- output.writeln();
575
- output.printInfo('V3 Performance: 150x-12,500x faster search with HNSW indexing');
576
-
577
- return { success: true, data: stats };
578
- } catch (error) {
579
- output.printError(`Failed to get stats: ${error instanceof Error ? error.message : 'Unknown error'}`);
580
- return { success: false, exitCode: 1 };
581
- }
582
- }
583
- };
584
-
585
- // Configure command
586
- const configureCommand: Command = {
587
- name: 'configure',
588
- aliases: ['config'],
589
- description: 'Configure memory backend',
590
- options: [
591
- {
592
- name: 'backend',
593
- short: 'b',
594
- description: 'Memory backend',
595
- type: 'string',
596
- choices: BACKENDS.map(b => b.value)
597
- },
598
- {
599
- name: 'path',
600
- description: 'Storage path',
601
- type: 'string'
602
- },
603
- {
604
- name: 'cache-size',
605
- description: 'Cache size in MB',
606
- type: 'number'
607
- },
608
- {
609
- name: 'hnsw-m',
610
- description: 'HNSW M parameter',
611
- type: 'number',
612
- default: 16
613
- },
614
- {
615
- name: 'hnsw-ef',
616
- description: 'HNSW ef parameter',
617
- type: 'number',
618
- default: 200
619
- }
620
- ],
621
- action: async (ctx: CommandContext): Promise<CommandResult> => {
622
- let backend = ctx.flags.backend as string;
623
-
624
- if (!backend && ctx.interactive) {
625
- backend = await select({
626
- message: 'Select memory backend:',
627
- options: BACKENDS,
628
- default: 'hybrid'
629
- });
630
- }
631
-
632
- const config = {
633
- backend: backend || 'hybrid',
634
- path: ctx.flags.path || './data/memory',
635
- cacheSize: ctx.flags.cacheSize || 256,
636
- hnsw: {
637
- m: ctx.flags.hnswM || 16,
638
- ef: ctx.flags.hnswEf || 200
639
- }
640
- };
641
-
642
- output.writeln();
643
- output.printInfo('Memory Configuration');
644
- output.writeln();
645
-
646
- output.printTable({
647
- columns: [
648
- { key: 'setting', header: 'Setting', width: 20 },
649
- { key: 'value', header: 'Value', width: 25 }
650
- ],
651
- data: [
652
- { setting: 'Backend', value: config.backend },
653
- { setting: 'Storage Path', value: config.path },
654
- { setting: 'Cache Size', value: `${config.cacheSize} MB` },
655
- { setting: 'HNSW M', value: config.hnsw.m },
656
- { setting: 'HNSW ef', value: config.hnsw.ef }
657
- ]
658
- });
659
-
660
- output.writeln();
661
- output.printSuccess('Memory configuration updated');
662
-
663
- return { success: true, data: config };
664
- }
665
- };
666
-
667
- // Cleanup command
668
- const cleanupCommand: Command = {
669
- name: 'cleanup',
670
- description: 'Clean up stale and expired memory entries',
671
- options: [
672
- {
673
- name: 'dry-run',
674
- short: 'd',
675
- description: 'Show what would be deleted',
676
- type: 'boolean',
677
- default: false
678
- },
679
- {
680
- name: 'older-than',
681
- short: 'o',
682
- description: 'Delete entries older than (e.g., "7d", "30d")',
683
- type: 'string'
684
- },
685
- {
686
- name: 'expired-only',
687
- short: 'e',
688
- description: 'Only delete expired TTL entries',
689
- type: 'boolean',
690
- default: false
691
- },
692
- {
693
- name: 'low-quality',
694
- short: 'l',
695
- description: 'Delete low quality patterns (threshold)',
696
- type: 'number'
697
- },
698
- {
699
- name: 'namespace',
700
- short: 'n',
701
- description: 'Clean specific namespace only',
702
- type: 'string'
703
- },
704
- {
705
- name: 'force',
706
- short: 'f',
707
- description: 'Skip confirmation',
708
- type: 'boolean',
709
- default: false
710
- }
711
- ],
712
- examples: [
713
- { command: 'claude-flow memory cleanup --dry-run', description: 'Preview cleanup' },
714
- { command: 'claude-flow memory cleanup --older-than 30d', description: 'Delete entries older than 30 days' },
715
- { command: 'claude-flow memory cleanup --expired-only', description: 'Clean expired entries' }
716
- ],
717
- action: async (ctx: CommandContext): Promise<CommandResult> => {
718
- const dryRun = ctx.flags.dryRun as boolean;
719
- const force = ctx.flags.force as boolean;
720
-
721
- if (dryRun) {
722
- output.writeln(output.warning('DRY RUN - No changes will be made'));
723
- }
724
-
725
- output.printInfo('Analyzing memory for cleanup...');
726
-
727
- try {
728
- const result = await callMCPTool<{
729
- dryRun: boolean;
730
- candidates: {
731
- expired: number;
732
- stale: number;
733
- lowQuality: number;
734
- total: number;
735
- };
736
- deleted: {
737
- entries: number;
738
- vectors: number;
739
- patterns: number;
740
- };
741
- freed: {
742
- bytes: number;
743
- formatted: string;
744
- };
745
- duration: number;
746
- }>('memory/cleanup', {
747
- dryRun,
748
- olderThan: ctx.flags.olderThan,
749
- expiredOnly: ctx.flags.expiredOnly,
750
- lowQualityThreshold: ctx.flags.lowQuality,
751
- namespace: ctx.flags.namespace,
752
- });
753
-
754
- if (ctx.flags.format === 'json') {
755
- output.printJson(result);
756
- return { success: true, data: result };
757
- }
758
-
759
- output.writeln();
760
- output.writeln(output.bold('Cleanup Analysis'));
761
- output.printTable({
762
- columns: [
763
- { key: 'category', header: 'Category', width: 20 },
764
- { key: 'count', header: 'Count', width: 15, align: 'right' }
765
- ],
766
- data: [
767
- { category: 'Expired (TTL)', count: result.candidates.expired },
768
- { category: 'Stale (unused)', count: result.candidates.stale },
769
- { category: 'Low Quality', count: result.candidates.lowQuality },
770
- { category: output.bold('Total'), count: output.bold(String(result.candidates.total)) }
771
- ]
772
- });
773
-
774
- if (!dryRun && result.candidates.total > 0 && !force) {
775
- const confirmed = await confirm({
776
- message: `Delete ${result.candidates.total} entries (${result.freed.formatted})?`,
777
- default: false
778
- });
779
-
780
- if (!confirmed) {
781
- output.printInfo('Cleanup cancelled');
782
- return { success: true, data: result };
783
- }
784
- }
785
-
786
- if (!dryRun) {
787
- output.writeln();
788
- output.printSuccess(`Cleaned ${result.deleted.entries} entries`);
789
- output.printList([
790
- `Vectors removed: ${result.deleted.vectors}`,
791
- `Patterns removed: ${result.deleted.patterns}`,
792
- `Space freed: ${result.freed.formatted}`,
793
- `Duration: ${result.duration}ms`
794
- ]);
795
- }
796
-
797
- return { success: true, data: result };
798
- } catch (error) {
799
- if (error instanceof MCPClientError) {
800
- output.printError(`Cleanup error: ${error.message}`);
801
- } else {
802
- output.printError(`Unexpected error: ${String(error)}`);
803
- }
804
- return { success: false, exitCode: 1 };
805
- }
806
- }
807
- };
808
-
809
- // Compress command
810
- const compressCommand: Command = {
811
- name: 'compress',
812
- description: 'Compress and optimize memory storage',
813
- options: [
814
- {
815
- name: 'level',
816
- short: 'l',
817
- description: 'Compression level (fast, balanced, max)',
818
- type: 'string',
819
- choices: ['fast', 'balanced', 'max'],
820
- default: 'balanced'
821
- },
822
- {
823
- name: 'target',
824
- short: 't',
825
- description: 'Target (vectors, text, patterns, all)',
826
- type: 'string',
827
- choices: ['vectors', 'text', 'patterns', 'all'],
828
- default: 'all'
829
- },
830
- {
831
- name: 'quantize',
832
- short: 'q',
833
- description: 'Enable vector quantization (reduces memory 4-32x)',
834
- type: 'boolean',
835
- default: false
836
- },
837
- {
838
- name: 'bits',
839
- description: 'Quantization bits (4, 8, 16)',
840
- type: 'number',
841
- default: 8
842
- },
843
- {
844
- name: 'rebuild-index',
845
- short: 'r',
846
- description: 'Rebuild HNSW index after compression',
847
- type: 'boolean',
848
- default: true
849
- }
850
- ],
851
- examples: [
852
- { command: 'claude-flow memory compress', description: 'Balanced compression' },
853
- { command: 'claude-flow memory compress --quantize --bits 4', description: '4-bit quantization (32x reduction)' },
854
- { command: 'claude-flow memory compress -l max -t vectors', description: 'Max compression on vectors' }
855
- ],
856
- action: async (ctx: CommandContext): Promise<CommandResult> => {
857
- const level = ctx.flags.level as string || 'balanced';
858
- const target = ctx.flags.target as string || 'all';
859
- const quantize = ctx.flags.quantize as boolean;
860
- const bits = ctx.flags.bits as number || 8;
861
- const rebuildIndex = ctx.flags.rebuildIndex as boolean ?? true;
862
-
863
- output.writeln();
864
- output.writeln(output.bold('Memory Compression'));
865
- output.writeln(output.dim(`Level: ${level}, Target: ${target}, Quantize: ${quantize ? `${bits}-bit` : 'no'}`));
866
- output.writeln();
867
-
868
- const spinner = output.createSpinner({ text: 'Analyzing current storage...', spinner: 'dots' });
869
- spinner.start();
870
-
871
- try {
872
- const result = await callMCPTool<{
873
- before: {
874
- totalSize: string;
875
- vectorsSize: string;
876
- textSize: string;
877
- patternsSize: string;
878
- indexSize: string;
879
- };
880
- after: {
881
- totalSize: string;
882
- vectorsSize: string;
883
- textSize: string;
884
- patternsSize: string;
885
- indexSize: string;
886
- };
887
- compression: {
888
- ratio: number;
889
- bytesSaved: number;
890
- formattedSaved: string;
891
- quantizationApplied: boolean;
892
- indexRebuilt: boolean;
893
- };
894
- performance: {
895
- searchLatencyBefore: number;
896
- searchLatencyAfter: number;
897
- searchSpeedup: string;
898
- };
899
- duration: number;
900
- }>('memory/compress', {
901
- level,
902
- target,
903
- quantize,
904
- bits,
905
- rebuildIndex,
906
- });
907
-
908
- spinner.succeed('Compression complete');
909
-
910
- if (ctx.flags.format === 'json') {
911
- output.printJson(result);
912
- return { success: true, data: result };
913
- }
914
-
915
- output.writeln();
916
- output.writeln(output.bold('Storage Comparison'));
917
- output.printTable({
918
- columns: [
919
- { key: 'category', header: 'Category', width: 15 },
920
- { key: 'before', header: 'Before', width: 12, align: 'right' },
921
- { key: 'after', header: 'After', width: 12, align: 'right' },
922
- { key: 'saved', header: 'Saved', width: 12, align: 'right' }
923
- ],
924
- data: [
925
- { category: 'Vectors', before: result.before.vectorsSize, after: result.after.vectorsSize, saved: '-' },
926
- { category: 'Text', before: result.before.textSize, after: result.after.textSize, saved: '-' },
927
- { category: 'Patterns', before: result.before.patternsSize, after: result.after.patternsSize, saved: '-' },
928
- { category: 'Index', before: result.before.indexSize, after: result.after.indexSize, saved: '-' },
929
- { category: output.bold('Total'), before: result.before.totalSize, after: result.after.totalSize, saved: output.success(result.compression.formattedSaved) }
930
- ]
931
- });
932
-
933
- output.writeln();
934
- output.printBox(
935
- [
936
- `Compression Ratio: ${result.compression.ratio.toFixed(2)}x`,
937
- `Space Saved: ${result.compression.formattedSaved}`,
938
- `Quantization: ${result.compression.quantizationApplied ? `Yes (${bits}-bit)` : 'No'}`,
939
- `Index Rebuilt: ${result.compression.indexRebuilt ? 'Yes' : 'No'}`,
940
- `Duration: ${(result.duration / 1000).toFixed(1)}s`
941
- ].join('\n'),
942
- 'Results'
943
- );
944
-
945
- if (result.performance) {
946
- output.writeln();
947
- output.writeln(output.bold('Performance Impact'));
948
- output.printList([
949
- `Search latency: ${result.performance.searchLatencyBefore.toFixed(2)}ms → ${result.performance.searchLatencyAfter.toFixed(2)}ms`,
950
- `Speedup: ${output.success(result.performance.searchSpeedup)}`
951
- ]);
952
- }
953
-
954
- return { success: true, data: result };
955
- } catch (error) {
956
- spinner.fail('Compression failed');
957
- if (error instanceof MCPClientError) {
958
- output.printError(`Compression error: ${error.message}`);
959
- } else {
960
- output.printError(`Unexpected error: ${String(error)}`);
961
- }
962
- return { success: false, exitCode: 1 };
963
- }
964
- }
965
- };
966
-
967
- // Export command
968
- const exportCommand: Command = {
969
- name: 'export',
970
- description: 'Export memory to file',
971
- options: [
972
- {
973
- name: 'output',
974
- short: 'o',
975
- description: 'Output file path',
976
- type: 'string',
977
- required: true
978
- },
979
- {
980
- name: 'format',
981
- short: 'f',
982
- description: 'Export format (json, csv, binary)',
983
- type: 'string',
984
- choices: ['json', 'csv', 'binary'],
985
- default: 'json'
986
- },
987
- {
988
- name: 'namespace',
989
- short: 'n',
990
- description: 'Export specific namespace',
991
- type: 'string'
992
- },
993
- {
994
- name: 'include-vectors',
995
- description: 'Include vector embeddings',
996
- type: 'boolean',
997
- default: true
998
- }
999
- ],
1000
- examples: [
1001
- { command: 'claude-flow memory export -o ./backup.json', description: 'Export all to JSON' },
1002
- { command: 'claude-flow memory export -o ./data.csv -f csv', description: 'Export to CSV' }
1003
- ],
1004
- action: async (ctx: CommandContext): Promise<CommandResult> => {
1005
- const outputPath = ctx.flags.output as string;
1006
- const format = ctx.flags.format as string || 'json';
1007
-
1008
- if (!outputPath) {
1009
- output.printError('Output path is required. Use --output or -o');
1010
- return { success: false, exitCode: 1 };
1011
- }
1012
-
1013
- output.printInfo(`Exporting memory to ${outputPath}...`);
1014
-
1015
- try {
1016
- const result = await callMCPTool<{
1017
- outputPath: string;
1018
- format: string;
1019
- exported: {
1020
- entries: number;
1021
- vectors: number;
1022
- patterns: number;
1023
- };
1024
- fileSize: string;
1025
- }>('memory/export', {
1026
- outputPath,
1027
- format,
1028
- namespace: ctx.flags.namespace,
1029
- includeVectors: ctx.flags.includeVectors ?? true,
1030
- });
1031
-
1032
- output.printSuccess(`Exported to ${result.outputPath}`);
1033
- output.printList([
1034
- `Entries: ${result.exported.entries}`,
1035
- `Vectors: ${result.exported.vectors}`,
1036
- `Patterns: ${result.exported.patterns}`,
1037
- `File size: ${result.fileSize}`
1038
- ]);
1039
-
1040
- return { success: true, data: result };
1041
- } catch (error) {
1042
- if (error instanceof MCPClientError) {
1043
- output.printError(`Export error: ${error.message}`);
1044
- } else {
1045
- output.printError(`Unexpected error: ${String(error)}`);
1046
- }
1047
- return { success: false, exitCode: 1 };
1048
- }
1049
- }
1050
- };
1051
-
1052
- // Import command
1053
- const importCommand: Command = {
1054
- name: 'import',
1055
- description: 'Import memory from file',
1056
- options: [
1057
- {
1058
- name: 'input',
1059
- short: 'i',
1060
- description: 'Input file path',
1061
- type: 'string',
1062
- required: true
1063
- },
1064
- {
1065
- name: 'merge',
1066
- short: 'm',
1067
- description: 'Merge with existing (skip duplicates)',
1068
- type: 'boolean',
1069
- default: true
1070
- },
1071
- {
1072
- name: 'namespace',
1073
- short: 'n',
1074
- description: 'Import into specific namespace',
1075
- type: 'string'
1076
- }
1077
- ],
1078
- examples: [
1079
- { command: 'claude-flow memory import -i ./backup.json', description: 'Import from file' },
1080
- { command: 'claude-flow memory import -i ./data.json -n archive', description: 'Import to namespace' }
1081
- ],
1082
- action: async (ctx: CommandContext): Promise<CommandResult> => {
1083
- const inputPath = ctx.flags.input as string || ctx.args[0];
1084
-
1085
- if (!inputPath) {
1086
- output.printError('Input path is required. Use --input or -i');
1087
- return { success: false, exitCode: 1 };
1088
- }
1089
-
1090
- output.printInfo(`Importing memory from ${inputPath}...`);
1091
-
1092
- try {
1093
- const result = await callMCPTool<{
1094
- inputPath: string;
1095
- imported: {
1096
- entries: number;
1097
- vectors: number;
1098
- patterns: number;
1099
- };
1100
- skipped: number;
1101
- duration: number;
1102
- }>('memory/import', {
1103
- inputPath,
1104
- merge: ctx.flags.merge ?? true,
1105
- namespace: ctx.flags.namespace,
1106
- });
1107
-
1108
- output.printSuccess(`Imported from ${result.inputPath}`);
1109
- output.printList([
1110
- `Entries: ${result.imported.entries}`,
1111
- `Vectors: ${result.imported.vectors}`,
1112
- `Patterns: ${result.imported.patterns}`,
1113
- `Skipped (duplicates): ${result.skipped}`,
1114
- `Duration: ${result.duration}ms`
1115
- ]);
1116
-
1117
- return { success: true, data: result };
1118
- } catch (error) {
1119
- if (error instanceof MCPClientError) {
1120
- output.printError(`Import error: ${error.message}`);
1121
- } else {
1122
- output.printError(`Unexpected error: ${String(error)}`);
1123
- }
1124
- return { success: false, exitCode: 1 };
1125
- }
1126
- }
1127
- };
1128
-
1129
- // Main memory command
1130
- export const memoryCommand: Command = {
1131
- name: 'memory',
1132
- description: 'Memory management commands',
1133
- subcommands: [storeCommand, retrieveCommand, searchCommand, listCommand, deleteCommand, statsCommand, configureCommand, cleanupCommand, compressCommand, exportCommand, importCommand],
1134
- options: [],
1135
- examples: [
1136
- { command: 'claude-flow memory store -k "key" -v "value"', description: 'Store data' },
1137
- { command: 'claude-flow memory search -q "auth patterns"', description: 'Search memory' },
1138
- { command: 'claude-flow memory stats', description: 'Show statistics' }
1139
- ],
1140
- action: async (ctx: CommandContext): Promise<CommandResult> => {
1141
- output.writeln();
1142
- output.writeln(output.bold('Memory Management Commands'));
1143
- output.writeln();
1144
- output.writeln('Usage: claude-flow memory <subcommand> [options]');
1145
- output.writeln();
1146
- output.writeln('Subcommands:');
1147
- output.printList([
1148
- `${output.highlight('store')} - Store data in memory`,
1149
- `${output.highlight('retrieve')} - Retrieve data from memory`,
1150
- `${output.highlight('search')} - Semantic/vector search`,
1151
- `${output.highlight('list')} - List memory entries`,
1152
- `${output.highlight('delete')} - Delete memory entry`,
1153
- `${output.highlight('stats')} - Show statistics`,
1154
- `${output.highlight('configure')} - Configure backend`
1155
- ]);
1156
-
1157
- return { success: true };
1158
- }
1159
- };
1160
-
1161
- export default memoryCommand;