@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.
- package/package.json +12 -4
- package/.agentic-flow/intelligence.json +0 -17
- package/.claude-flow/agents/store.json +0 -16
- package/.claude-flow/daemon-state.json +0 -123
- package/.claude-flow/daemon-test.log +0 -0
- package/.claude-flow/daemon.log +0 -0
- package/.claude-flow/daemon2.log +0 -0
- package/.claude-flow/daemon3.log +0 -0
- package/.claude-flow/hive-mind/state.json +0 -51
- package/.claude-flow/metrics/agent-metrics.json +0 -1
- package/.claude-flow/metrics/codebase-map.json +0 -11
- package/.claude-flow/metrics/consolidation.json +0 -6
- package/.claude-flow/metrics/performance.json +0 -87
- package/.claude-flow/metrics/security-audit.json +0 -10
- package/.claude-flow/metrics/task-metrics.json +0 -10
- package/.claude-flow/metrics/test-gaps.json +0 -6
- package/__tests__/README.md +0 -140
- package/__tests__/TEST_SUMMARY.md +0 -144
- package/__tests__/cli.test.ts +0 -558
- package/__tests__/commands.test.ts +0 -726
- package/__tests__/config-adapter.test.ts +0 -362
- package/__tests__/config-loading.test.ts +0 -106
- package/__tests__/coverage/.tmp/coverage-0.json +0 -1
- package/__tests__/coverage/.tmp/coverage-1.json +0 -1
- package/__tests__/coverage/.tmp/coverage-2.json +0 -1
- package/__tests__/coverage/.tmp/coverage-3.json +0 -1
- package/__tests__/coverage/.tmp/coverage-4.json +0 -1
- package/__tests__/coverage/.tmp/coverage-5.json +0 -1
- package/__tests__/mcp-client.test.ts +0 -480
- package/__tests__/p1-commands.test.ts +0 -1064
- package/agents/architect.yaml +0 -11
- package/agents/coder.yaml +0 -11
- package/agents/reviewer.yaml +0 -10
- package/agents/security-architect.yaml +0 -10
- package/agents/tester.yaml +0 -10
- package/docs/CONFIG_LOADING.md +0 -236
- package/docs/IMPLEMENTATION_COMPLETE.md +0 -421
- package/docs/MCP_CLIENT_GUIDE.md +0 -620
- package/docs/REFACTORING_SUMMARY.md +0 -247
- package/scripts/publish.sh +0 -46
- package/src/commands/agent.ts +0 -955
- package/src/commands/claims.ts +0 -317
- package/src/commands/completions.ts +0 -558
- package/src/commands/config.ts +0 -452
- package/src/commands/daemon.ts +0 -621
- package/src/commands/deployment.ts +0 -323
- package/src/commands/doctor.ts +0 -382
- package/src/commands/embeddings.ts +0 -686
- package/src/commands/hive-mind.ts +0 -928
- package/src/commands/hooks.ts +0 -2603
- package/src/commands/index.ts +0 -154
- package/src/commands/init.ts +0 -597
- package/src/commands/mcp.ts +0 -753
- package/src/commands/memory.ts +0 -1161
- package/src/commands/migrate.ts +0 -447
- package/src/commands/neural.ts +0 -253
- package/src/commands/performance.ts +0 -292
- package/src/commands/plugins.ts +0 -316
- package/src/commands/process.ts +0 -695
- package/src/commands/providers.ts +0 -259
- package/src/commands/security.ts +0 -288
- package/src/commands/session.ts +0 -891
- package/src/commands/start.ts +0 -457
- package/src/commands/status.ts +0 -736
- package/src/commands/swarm.ts +0 -648
- package/src/commands/task.ts +0 -792
- package/src/commands/workflow.ts +0 -742
- package/src/config-adapter.ts +0 -210
- package/src/index.ts +0 -443
- package/src/infrastructure/in-memory-repositories.ts +0 -310
- package/src/init/claudemd-generator.ts +0 -631
- package/src/init/executor.ts +0 -762
- package/src/init/helpers-generator.ts +0 -628
- package/src/init/index.ts +0 -60
- package/src/init/mcp-generator.ts +0 -83
- package/src/init/settings-generator.ts +0 -284
- package/src/init/statusline-generator.ts +0 -211
- package/src/init/types.ts +0 -447
- package/src/mcp-client.ts +0 -241
- package/src/mcp-server.ts +0 -577
- package/src/mcp-tools/agent-tools.ts +0 -466
- package/src/mcp-tools/config-tools.ts +0 -370
- package/src/mcp-tools/hive-mind-tools.ts +0 -521
- package/src/mcp-tools/hooks-tools.ts +0 -1888
- package/src/mcp-tools/index.ts +0 -16
- package/src/mcp-tools/memory-tools.ts +0 -270
- package/src/mcp-tools/session-tools.ts +0 -359
- package/src/mcp-tools/swarm-tools.ts +0 -105
- package/src/mcp-tools/task-tools.ts +0 -347
- package/src/mcp-tools/types.ts +0 -33
- package/src/mcp-tools/workflow-tools.ts +0 -573
- package/src/output.ts +0 -639
- package/src/parser.ts +0 -417
- package/src/prompt.ts +0 -619
- package/src/services/index.ts +0 -15
- package/src/services/worker-daemon.ts +0 -726
- package/src/suggest.ts +0 -245
- package/src/types.ts +0 -287
- package/tmp.json +0 -0
- package/tsconfig.json +0 -16
- package/tsconfig.tsbuildinfo +0 -1
- package/vitest.config.ts +0 -13
package/src/commands/memory.ts
DELETED
|
@@ -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;
|