claude-flow 3.71.3 → 3.72.0

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 (86) hide show
  1. package/.claude/helpers/auto-memory-hook.mjs +17 -0
  2. package/.claude/helpers/hook-handler.cjs +23 -10
  3. package/.claude/helpers/intelligence.cjs +23 -1
  4. package/.claude/helpers/statusline.cjs +29 -14
  5. package/.claude/proven-config.json +1 -1
  6. package/README.md +18 -3
  7. package/README.zh-CN.md +16 -3
  8. package/package.json +1 -1
  9. package/v3/@claude-flow/cli/README.md +18 -3
  10. package/v3/@claude-flow/cli/bin/cli.js +13 -18
  11. package/v3/@claude-flow/cli/bin/mcp-server.js +13 -18
  12. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  13. package/v3/@claude-flow/cli/dist/src/appliance/rvfa-distribution.js +2 -2
  14. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.d.ts +1 -7
  15. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +1 -7
  16. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-decomposer.d.ts +1 -8
  17. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-decomposer.js +1 -8
  18. package/v3/@claude-flow/cli/dist/src/commands/agent-wasm.js +2 -2
  19. package/v3/@claude-flow/cli/dist/src/commands/analyze.js +1 -1
  20. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +1 -1
  21. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +3 -2
  22. package/v3/@claude-flow/cli/dist/src/commands/guidance.js +9 -9
  23. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +13 -8
  24. package/v3/@claude-flow/cli/dist/src/commands/init.js +14 -16
  25. package/v3/@claude-flow/cli/dist/src/commands/memory.js +4 -3
  26. package/v3/@claude-flow/cli/dist/src/commands/neural.js +8 -6
  27. package/v3/@claude-flow/cli/dist/src/commands/route.js +1 -1
  28. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +7 -5
  29. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +6 -1
  30. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +19 -5
  31. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +1 -1
  32. package/v3/@claude-flow/cli/dist/src/commands/start.js +1 -1
  33. package/v3/@claude-flow/cli/dist/src/commands/status.js +1 -1
  34. package/v3/@claude-flow/cli/dist/src/commands/task.js +18 -1
  35. package/v3/@claude-flow/cli/dist/src/commands/update.js +1 -1
  36. package/v3/@claude-flow/cli/dist/src/funnel/local-signals.js +7 -2
  37. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +16 -1
  38. package/v3/@claude-flow/cli/dist/src/mcp-protocol.d.ts +90 -0
  39. package/v3/@claude-flow/cli/dist/src/mcp-protocol.js +179 -0
  40. package/v3/@claude-flow/cli/dist/src/mcp-server.d.ts +1 -0
  41. package/v3/@claude-flow/cli/dist/src/mcp-server.js +20 -22
  42. package/v3/@claude-flow/cli/dist/src/mcp-tools/agent-execute-core.js +9 -1
  43. package/v3/@claude-flow/cli/dist/src/mcp-tools/agent-tools.d.ts +13 -0
  44. package/v3/@claude-flow/cli/dist/src/mcp-tools/agent-tools.js +63 -12
  45. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentbbs-federation.d.ts +18 -1
  46. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentbbs-federation.js +23 -7
  47. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-argv.d.ts +27 -0
  48. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-argv.js +92 -0
  49. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-session-tools.js +4 -0
  50. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-tools.d.ts +1 -1
  51. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-tools.js +25 -8
  52. package/v3/@claude-flow/cli/dist/src/mcp-tools/coordination-tools.js +5 -4
  53. package/v3/@claude-flow/cli/dist/src/mcp-tools/embeddings-tools.js +12 -4
  54. package/v3/@claude-flow/cli/dist/src/mcp-tools/glob-exclusions.d.ts +6 -0
  55. package/v3/@claude-flow/cli/dist/src/mcp-tools/glob-exclusions.js +81 -0
  56. package/v3/@claude-flow/cli/dist/src/mcp-tools/hive-mind-tools.js +104 -35
  57. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +12 -5
  58. package/v3/@claude-flow/cli/dist/src/mcp-tools/import-limits.d.ts +4 -0
  59. package/v3/@claude-flow/cli/dist/src/mcp-tools/import-limits.js +28 -0
  60. package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +68 -72
  61. package/v3/@claude-flow/cli/dist/src/mcp-tools/neural-tools.js +8 -2
  62. package/v3/@claude-flow/cli/dist/src/mcp-tools/path-containment.d.ts +34 -0
  63. package/v3/@claude-flow/cli/dist/src/mcp-tools/path-containment.js +133 -0
  64. package/v3/@claude-flow/cli/dist/src/mcp-tools/performance-tools.js +7 -2
  65. package/v3/@claude-flow/cli/dist/src/mcp-tools/record-store.d.ts +15 -0
  66. package/v3/@claude-flow/cli/dist/src/mcp-tools/record-store.js +117 -3
  67. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.d.ts +9 -0
  68. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.js +39 -3
  69. package/v3/@claude-flow/cli/dist/src/mcp-tools/session-tools.js +9 -41
  70. package/v3/@claude-flow/cli/dist/src/mcp-tools/swarm-tools.js +36 -14
  71. package/v3/@claude-flow/cli/dist/src/mcp-tools/task-tools.js +68 -5
  72. package/v3/@claude-flow/cli/dist/src/mcp-tools/terminal-tools.js +16 -2
  73. package/v3/@claude-flow/cli/dist/src/mcp-tools/validate-input.d.ts +2 -0
  74. package/v3/@claude-flow/cli/dist/src/mcp-tools/validate-input.js +14 -0
  75. package/v3/@claude-flow/cli/dist/src/mcp-tools/workflow-tools.js +13 -12
  76. package/v3/@claude-flow/cli/dist/src/mcp-tools/x-federation-join.js +55 -14
  77. package/v3/@claude-flow/cli/dist/src/memory/intelligence.d.ts +11 -0
  78. package/v3/@claude-flow/cli/dist/src/memory/intelligence.js +84 -6
  79. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +6 -2
  80. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +15 -6
  81. package/v3/@claude-flow/cli/dist/src/ruvector/model-router.d.ts +6 -1
  82. package/v3/@claude-flow/cli/dist/src/ruvector/model-router.js +16 -4
  83. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +30 -12
  84. package/v3/@claude-flow/cli/dist/src/transfer/storage/gcs.js +3 -2
  85. package/v3/@claude-flow/cli/package.json +1 -1
  86. package/.claude/security-scans/scan-all-quick.json +0 -201
@@ -33,8 +33,11 @@ import {
33
33
  loadMcpPolicy,
34
34
  evaluateToolCall,
35
35
  } from '../dist/src/mcp-tools/policy-enforcer.js';
36
+ // ADR-524: shared MCP revision handling (2026-07-28 + legacy initialize).
37
+ import * as mcpProtocol from '../dist/src/mcp-protocol.js';
36
38
 
37
- const VERSION = '3.0.0';
39
+ const MCP_CAPABILITIES = { tools: { listChanged: true }, resources: {} };
40
+ const VERSION = mcpProtocol.defaultServerIdentity().version;
38
41
  const sessionId = `mcp-${Date.now()}-${randomUUID().slice(0, 8)}`;
39
42
 
40
43
  // Log to stderr (doesn't corrupt stdout for MCP protocol)
@@ -132,27 +135,19 @@ async function handleMessage(message) {
132
135
  error: { code: -32600, message: 'Invalid Request: missing method' },
133
136
  };
134
137
  }
138
+ const preflight = mcpProtocol.protocolPreflight(message, MCP_CAPABILITIES);
139
+ if (preflight.response) return preflight.response;
140
+ const response = await dispatchMessage(message, preflight.context);
141
+ return mcpProtocol.finalizeResponse(response, message.method, preflight.context);
142
+ }
135
143
 
144
+ async function dispatchMessage(message, protocol) {
136
145
  const params = message.params || {};
137
146
 
138
147
  try {
139
148
  switch (message.method) {
140
- case 'initialize':
141
- return {
142
- jsonrpc: '2.0',
143
- id: message.id,
144
- result: {
145
- protocolVersion: '2024-11-05',
146
- serverInfo: { name: 'ruflo', version: VERSION },
147
- capabilities: {
148
- tools: { listChanged: true },
149
- resources: {},
150
- },
151
- },
152
- };
153
-
154
149
  case 'tools/list': {
155
- const tools = listMCPTools();
150
+ const tools = mcpProtocol.sortToolsDeterministically(listMCPTools());
156
151
  return {
157
152
  jsonrpc: '2.0',
158
153
  id: message.id,
@@ -190,7 +185,7 @@ async function handleMessage(message) {
190
185
  }
191
186
 
192
187
  try {
193
- const result = await callMCPTool(toolName, toolParams, { sessionId, transport: 'stdio' });
188
+ const result = await callMCPTool(toolName, toolParams, { sessionId, transport: 'stdio', ...mcpProtocol.traceContextFields(protocol) });
194
189
  return {
195
190
  jsonrpc: '2.0',
196
191
  id: message.id,
@@ -216,7 +211,7 @@ async function handleMessage(message) {
216
211
  return { jsonrpc: '2.0', id: message.id, result: { resourceTemplates: [] } };
217
212
 
218
213
  case 'resources/read':
219
- return { jsonrpc: '2.0', id: message.id, error: { code: -32002, message: 'Resource not found' } };
214
+ return { jsonrpc: '2.0', id: message.id, error: { code: mcpProtocol.resourceNotFoundCode(protocol), message: 'Resource not found' } };
220
215
 
221
216
  case 'notifications/initialized':
222
217
  console.error(`[${new Date().toISOString()}] INFO [claude-flow-mcp] Client initialized`);
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "generation": 7,
4
- "generatedAt": "2026-11-05T00:20:52.796Z",
5
- "gitSha": "9045ab84",
4
+ "generatedAt": "2026-11-06T01:04:54.071Z",
5
+ "gitSha": "c6061039",
6
6
  "catalog": {
7
7
  "agents": 177,
8
8
  "tools": 450,
@@ -9,7 +9,7 @@
9
9
  */
10
10
  import { createHash, sign, verify as edVerify } from 'node:crypto';
11
11
  import { readFile, writeFile, rename, unlink, copyFile, mkdir } from 'node:fs/promises';
12
- import { dirname } from 'node:path';
12
+ import { basename, dirname } from 'node:path';
13
13
  import { request as httpsRequest } from 'node:https';
14
14
  import { gzipSync, gunzipSync } from 'node:zlib';
15
15
  import { RvfaReader, RvfaWriter } from './rvfa-format.js';
@@ -324,7 +324,7 @@ export class RvfaPublisher {
324
324
  }
325
325
  async publish(rvfaPath, meta) {
326
326
  const data = await readFile(rvfaPath);
327
- const name = meta?.name || rvfaPath.split('/').pop() || 'appliance.rvf';
327
+ const name = meta?.name || basename(rvfaPath) || 'appliance.rvf';
328
328
  return this.upload(name, data, {
329
329
  type: 'rvfa-appliance', version: meta?.version || '',
330
330
  profile: meta?.profile || '', description: meta?.description || '',
@@ -10,8 +10,7 @@
10
10
  * without requiring better search backends. Expected L1 lift: +3-5pp.
11
11
  *
12
12
  * Design:
13
- * - NEW file only; NOT wired into gaia-bench.ts yet to avoid merge conflicts
14
- * with in-flight iter 29/31/34 branches. Wiring is a small follow-up PR.
13
+ * - gaia-bench.ts loads the wrapper when critic review is enabled.
15
14
  * - `criticReview()` — single Sonnet call, returns structured verdict.
16
15
  * - `runGaiaAgentWithCritic()` — orchestration wrapper: runs agent, calls
17
16
  * critic, retries once on "fail". "uncertain" is treated as "pass" (don't
@@ -25,11 +24,6 @@
25
24
  * - One critic call + one optional retry = max 2 extra Sonnet calls per Q.
26
25
  * - Approximate extra cost per question: ~$0.003-0.005 (well within budget).
27
26
  *
28
- * Plugin sync TODO (follow-up PR after gaia-bench wiring):
29
- * - Update plugins/ruflo-workflows/commands/gaia-run.md with --enable-critic flag.
30
- * - Update plugins/ruflo-workflows/skills/gaia-debugging/SKILL.md: add critic
31
- * as a recommended diagnostic step for wrong-answer analysis.
32
- *
33
27
  * Refs: ADR-135, ADR-133, iter 29 finding, #2156
34
28
  */
35
29
  import { GaiaQuestion } from './gaia-loader.js';
@@ -10,8 +10,7 @@
10
10
  * without requiring better search backends. Expected L1 lift: +3-5pp.
11
11
  *
12
12
  * Design:
13
- * - NEW file only; NOT wired into gaia-bench.ts yet to avoid merge conflicts
14
- * with in-flight iter 29/31/34 branches. Wiring is a small follow-up PR.
13
+ * - gaia-bench.ts loads the wrapper when critic review is enabled.
15
14
  * - `criticReview()` — single Sonnet call, returns structured verdict.
16
15
  * - `runGaiaAgentWithCritic()` — orchestration wrapper: runs agent, calls
17
16
  * critic, retries once on "fail". "uncertain" is treated as "pass" (don't
@@ -25,11 +24,6 @@
25
24
  * - One critic call + one optional retry = max 2 extra Sonnet calls per Q.
26
25
  * - Approximate extra cost per question: ~$0.003-0.005 (well within budget).
27
26
  *
28
- * Plugin sync TODO (follow-up PR after gaia-bench wiring):
29
- * - Update plugins/ruflo-workflows/commands/gaia-run.md with --enable-critic flag.
30
- * - Update plugins/ruflo-workflows/skills/gaia-debugging/SKILL.md: add critic
31
- * as a recommended diagnostic step for wrong-answer analysis.
32
- *
33
27
  * Refs: ADR-135, ADR-133, iter 29 finding, #2156
34
28
  */
35
29
  import { execSync } from 'node:child_process';
@@ -11,9 +11,7 @@
11
11
  * Expected L1 lift: +5-10pp on multi-step questions (~30-40% of L1 set).
12
12
  *
13
13
  * Design:
14
- * - NEW standalone file only; NOT wired into gaia-bench.ts to avoid merge
15
- * conflicts with in-flight iter 29/31/34/35/36 branches.
16
- * Wiring is a small follow-up PR.
14
+ * - gaia-bench.ts loads the decomposer when decomposition is enabled.
17
15
  * - `decomposeQuestion()` — Haiku-cheap classification + decomposition
18
16
  * (~$0.0003 per question).
19
17
  * - `synthesizeFromSubAnswers()` — Sonnet synthesis from sub-answers
@@ -26,11 +24,6 @@
26
24
  * - Synthesis uses claude-sonnet-4-6 (~$0.002/question).
27
25
  * - Total overhead per question (when decomposed): ~$0.002-0.003.
28
26
  *
29
- * Plugin sync TODO (follow-up PR after gaia-bench wiring):
30
- * - Update plugins/ruflo-workflows/commands/gaia-run.md with --decompose flag.
31
- * - Update plugins/ruflo-workflows/skills/gaia-debugging/SKILL.md: add
32
- * decomposition as a recommended strategy for multi-step failures.
33
- *
34
27
  * Refs: ADR-135, ADR-133, iter 29 finding, #2156
35
28
  */
36
29
  export interface DecomposedQuestion {
@@ -11,9 +11,7 @@
11
11
  * Expected L1 lift: +5-10pp on multi-step questions (~30-40% of L1 set).
12
12
  *
13
13
  * Design:
14
- * - NEW standalone file only; NOT wired into gaia-bench.ts to avoid merge
15
- * conflicts with in-flight iter 29/31/34/35/36 branches.
16
- * Wiring is a small follow-up PR.
14
+ * - gaia-bench.ts loads the decomposer when decomposition is enabled.
17
15
  * - `decomposeQuestion()` — Haiku-cheap classification + decomposition
18
16
  * (~$0.0003 per question).
19
17
  * - `synthesizeFromSubAnswers()` — Sonnet synthesis from sub-answers
@@ -26,11 +24,6 @@
26
24
  * - Synthesis uses claude-sonnet-4-6 (~$0.002/question).
27
25
  * - Total overhead per question (when decomposed): ~$0.002-0.003.
28
26
  *
29
- * Plugin sync TODO (follow-up PR after gaia-bench wiring):
30
- * - Update plugins/ruflo-workflows/commands/gaia-run.md with --decompose flag.
31
- * - Update plugins/ruflo-workflows/skills/gaia-debugging/SKILL.md: add
32
- * decomposition as a recommended strategy for multi-step failures.
33
- *
34
27
  * Refs: ADR-135, ADR-133, iter 29 finding, #2156
35
28
  */
36
29
  import { execSync } from 'node:child_process';
@@ -146,7 +146,7 @@ export const wasmCreateCommand = {
146
146
  info = await wasm.createWasmAgent({
147
147
  model: ctx.flags.model,
148
148
  instructions: ctx.flags.instructions,
149
- maxTurns: ctx.flags['max-turns'],
149
+ maxTurns: ctx.flags.maxTurns,
150
150
  });
151
151
  }
152
152
  if (ctx.flags.format === 'json') {
@@ -201,7 +201,7 @@ export const wasmPromptCommand = {
201
201
  { command: 'claude-flow agent wasm-prompt -a wasm-agent-1-abc -i "Write a hello world"', description: 'Send prompt to WASM agent' },
202
202
  ],
203
203
  action: async (ctx) => {
204
- const agentId = ctx.flags['agent-id'] || ctx.args[0];
204
+ const agentId = ctx.flags.agentId || ctx.args[0];
205
205
  const promptInput = ctx.flags.input || ctx.args[1];
206
206
  if (!agentId) {
207
207
  output.printError('Agent ID is required. Use --agent-id or -a');
@@ -1556,7 +1556,7 @@ const modulesCommand = {
1556
1556
  const targetDir = ctx.args[0] || ctx.cwd;
1557
1557
  const outputFile = ctx.flags.output;
1558
1558
  const format = ctx.flags.format || 'text';
1559
- const minSize = ctx.flags['min-size'] || 2;
1559
+ const minSize = ctx.flags.minSize || 2;
1560
1560
  output.printInfo(`Detecting module communities in: ${output.highlight(targetDir)}`);
1561
1561
  output.writeln();
1562
1562
  const spinner = output.createSpinner({ text: 'Building dependency graph...', spinner: 'dots' });
@@ -1247,7 +1247,7 @@ const statusCommand = {
1247
1247
  ],
1248
1248
  action: async (ctx) => {
1249
1249
  const verbose = ctx.flags.verbose;
1250
- const showModes = ctx.flags['show-modes'];
1250
+ const showModes = ctx.flags.showModes;
1251
1251
  // #2356: global view across every workspace, not just cwd.
1252
1252
  if (ctx.flags.all) {
1253
1253
  return renderAllDaemonsStatus();
@@ -7,6 +7,7 @@
7
7
  import { output } from '../output.js';
8
8
  import { existsSync, readFileSync, statSync, openSync, readSync, closeSync } from 'fs';
9
9
  import { join, dirname } from 'path';
10
+ import { homedir } from 'node:os';
10
11
  import { fileURLToPath, pathToFileURL } from 'url';
11
12
  import { createHash } from 'crypto';
12
13
  import { ownInstallAncestors } from '../plugins/own-install.js';
@@ -182,7 +183,7 @@ async function checkStaleSettingsNpx() {
182
183
  // Look in both project-local and home-dir settings.
183
184
  const candidates = [
184
185
  join(process.cwd(), '.claude', 'settings.json'),
185
- join(process.env.HOME ?? '', '.claude', 'settings.json'),
186
+ join(homedir(), '.claude', 'settings.json'),
186
187
  ].filter((p, i, a) => p && a.indexOf(p) === i);
187
188
  const offenders = [];
188
189
  for (const settingsPath of candidates) {
@@ -248,7 +249,7 @@ export async function checkHelperIntegrity(opts = {}) {
248
249
  const { verifyInstalledCriticalHelpers } = await import('../init/helper-integrity.js');
249
250
  const { CRITICAL_HELPERS, findPackageHelpersDir } = await import('../init/helper-refresh.js');
250
251
  const envLocked = /^(1|true|on|yes)$/i.test(String(process.env.RUFLO_HELPERS_LOCKED || ''));
251
- const home = opts.homeDir ?? process.env.HOME ?? '';
252
+ const home = opts.homeDir ?? homedir();
252
253
  const dirs = [
253
254
  join(opts.cwd ?? process.cwd(), '.claude', 'helpers'),
254
255
  ...(home ? [join(home, '.claude', 'helpers')] : []),
@@ -34,7 +34,7 @@ const compileCommand = {
34
34
  output.writeln(output.error(`Root guidance file not found: ${rootPath}`));
35
35
  return { success: false, message: `File not found: ${rootPath}` };
36
36
  }
37
- const modExport = ctx.flags['mod-projection'] === true;
37
+ const modExport = (ctx.flags.modProjection ?? ctx.flags['mod-projection']) === true;
38
38
  const checked = modExport ? await (await import('../guidance/mod-sources.js')).readModGuidanceSources({
39
39
  rootPath, localPath, revision: String(ctx.flags.revision || ''),
40
40
  }) : undefined;
@@ -112,7 +112,7 @@ const retrieveCommand = {
112
112
  const task = ctx.flags.task;
113
113
  const rootPath = ctx.flags.root || './CLAUDE.md';
114
114
  const localPath = ctx.flags.local;
115
- const maxShards = parseInt(ctx.flags['max-shards'] || '5', 10);
115
+ const maxShards = parseInt(String(ctx.flags.maxShards ?? ctx.flags['max-shards'] ?? 5), 10);
116
116
  const intentOverride = ctx.flags.intent;
117
117
  const jsonOutput = ctx.flags.json === true;
118
118
  if (!task) {
@@ -338,9 +338,9 @@ const optimizeCommand = {
338
338
  const rootPath = ctx.flags.root || './CLAUDE.md';
339
339
  const localPath = ctx.flags.local;
340
340
  const applyChanges = ctx.flags.apply === true;
341
- const contextSize = (ctx.flags['context-size'] || 'standard');
342
- const targetScore = parseInt(ctx.flags['target-score'] || '90', 10);
343
- const maxIterations = parseInt(ctx.flags['max-iterations'] || '5', 10);
341
+ const contextSize = (ctx.flags.contextSize ?? ctx.flags['context-size'] ?? 'standard');
342
+ const targetScore = parseInt(String(ctx.flags.targetScore ?? ctx.flags['target-score'] ?? 90), 10);
343
+ const maxIterations = parseInt(String(ctx.flags.maxIterations ?? ctx.flags['max-iterations'] ?? 5), 10);
344
344
  const jsonOutput = ctx.flags.json === true;
345
345
  output.writeln();
346
346
  output.writeln(output.bold('Guidance Optimizer'));
@@ -437,10 +437,10 @@ const abTestCommand = {
437
437
  { command: 'claude-flow guidance ab-test --json', description: 'Output full report as JSON' },
438
438
  ],
439
439
  action: async (ctx) => {
440
- const configAPath = ctx.flags['config-a'];
441
- const configBPath = ctx.flags['config-b'] || './CLAUDE.md';
440
+ const configAPath = (ctx.flags.configA ?? ctx.flags['config-a']);
441
+ const configBPath = (ctx.flags.configB ?? ctx.flags['config-b'] ?? './CLAUDE.md');
442
442
  const tasksPath = ctx.flags.tasks;
443
- const workDir = ctx.flags['work-dir'];
443
+ const workDir = (ctx.flags.workDir ?? ctx.flags['work-dir']);
444
444
  const jsonOutput = ctx.flags.json === true;
445
445
  output.writeln();
446
446
  output.writeln(output.bold('A/B Behavioral Benchmark'));
@@ -541,7 +541,7 @@ const modCandidatesCommand = {
541
541
  action: async (ctx) => {
542
542
  try {
543
543
  const { collectModCandidates } = await import('../guidance/mod-projection.js');
544
- const data = await collectModCandidates(String(ctx.flags.directory || '.claude-flow/mods/guidance/observations'), ctx.flags['bundle-id']);
544
+ const data = await collectModCandidates(String(ctx.flags.directory || '.claude-flow/mods/guidance/observations'), (ctx.flags.bundleId ?? ctx.flags['bundle-id']));
545
545
  output.writeln(JSON.stringify(data, null, ctx.flags.json === true ? undefined : 2));
546
546
  return { success: true, data };
547
547
  }
@@ -2529,8 +2529,8 @@ const workerDetectCommand = {
2529
2529
  ],
2530
2530
  action: async (ctx) => {
2531
2531
  const prompt = ctx.flags['prompt'];
2532
- const autoDispatch = ctx.flags['auto-dispatch'];
2533
- const minConfidence = parseFloat(ctx.flags['min-confidence'] || '0.5');
2532
+ const autoDispatch = (ctx.flags.autoDispatch ?? ctx.flags['auto-dispatch']);
2533
+ const minConfidence = parseFloat(String(ctx.flags.minConfidence ?? ctx.flags['min-confidence'] ?? 0.5) || '0.5');
2534
2534
  if (!prompt) {
2535
2535
  output.printError('--prompt is required');
2536
2536
  return { success: false, exitCode: 1 };
@@ -2570,7 +2570,12 @@ const workerDetectCommand = {
2570
2570
  }
2571
2571
  if (result.autoDispatched && result.workerIds) {
2572
2572
  output.writeln();
2573
- output.writeln(output.success('Workers auto-dispatched:'));
2573
+ if (result.autoDispatchStatus === 'synthetic-completed') {
2574
+ output.printWarning(result.note ?? 'No executor ran. Worker records are synthetic placeholders.');
2575
+ }
2576
+ else {
2577
+ output.writeln(output.success('Workers auto-dispatched:'));
2578
+ }
2574
2579
  result.workerIds.forEach(id => {
2575
2580
  output.writeln(` - ${id}`);
2576
2581
  });
@@ -3079,8 +3084,8 @@ const coverageGapsCommand = {
3079
3084
  ],
3080
3085
  action: async (ctx) => {
3081
3086
  const threshold = ctx.flags.threshold ?? 80;
3082
- const groupByAgent = ctx.flags['group-by-agent'] !== false;
3083
- const criticalOnly = ctx.flags['critical-only'] || false;
3087
+ const groupByAgent = (ctx.flags.groupByAgent ?? ctx.flags['group-by-agent']) !== false;
3088
+ const criticalOnly = (ctx.flags.criticalOnly ?? ctx.flags['critical-only']) === true;
3084
3089
  const spinner = output.createSpinner({ text: 'Analyzing project coverage gaps...' });
3085
3090
  spinner.start();
3086
3091
  // Try reading coverage from disk first
@@ -4161,7 +4166,7 @@ const modelRouteCommand = {
4161
4166
  { name: 'task', short: 't', type: 'string', description: 'Task description to route', required: true },
4162
4167
  { name: 'context', short: 'c', type: 'string', description: 'Additional context' },
4163
4168
  { name: 'prefer-cost', type: 'boolean', description: 'Prefer lower cost models' },
4164
- { name: 'prefer-quality', type: 'boolean', description: 'Prefer higher quality models' },
4169
+ { name: 'prefer-speed', type: 'boolean', description: 'Prefer faster models when possible' },
4165
4170
  ],
4166
4171
  examples: [
4167
4172
  { command: 'claude-flow hooks model-route -t "fix typo"', description: 'Route simple task (likely haiku)' },
@@ -4178,8 +4183,8 @@ const modelRouteCommand = {
4178
4183
  const result = await callMCPTool('hooks_model-route', {
4179
4184
  task,
4180
4185
  context: ctx.flags.context,
4181
- preferCost: ctx.flags['prefer-cost'],
4182
- preferQuality: ctx.flags['prefer-quality'],
4186
+ preferCost: ctx.flags.preferCost,
4187
+ preferSpeed: ctx.flags.preferSpeed,
4183
4188
  });
4184
4189
  if (ctx.flags.format === 'json') {
4185
4190
  output.printJson(result);
@@ -816,16 +816,22 @@ const initClaudeAction = async (ctx) => {
816
816
  if (startDaemon || startAll) {
817
817
  output.writeln();
818
818
  output.printInfo('Starting services...');
819
- const { execSync } = await import('child_process');
819
+ const { execFileSync } = await import('child_process');
820
+ // #4770: drop stderr via stdio, not a shell redirect (breaks on cmd.exe).
821
+ // shell on win32 so npx.cmd resolves (#2770); args are fixed literals.
822
+ const runCli = (args) => {
823
+ execFileSync('npx', ['@claude-flow/cli@latest', ...args], {
824
+ stdio: ['ignore', 'pipe', 'ignore'],
825
+ cwd: ctx.cwd,
826
+ timeout: 30000,
827
+ shell: process.platform === 'win32',
828
+ });
829
+ };
820
830
  // Initialize memory database
821
831
  if (startAll) {
822
832
  try {
823
833
  output.writeln(output.dim(' Initializing memory database...'));
824
- execSync('npx @claude-flow/cli@latest memory init 2>/dev/null', {
825
- stdio: 'pipe',
826
- cwd: ctx.cwd,
827
- timeout: 30000
828
- });
834
+ runCli(['memory', 'init']);
829
835
  output.writeln(output.success(' ✓ Memory initialized'));
830
836
  }
831
837
  catch {
@@ -854,11 +860,7 @@ const initClaudeAction = async (ctx) => {
854
860
  if (startDaemon) {
855
861
  try {
856
862
  output.writeln(output.dim(' Starting daemon...'));
857
- execSync('npx @claude-flow/cli@latest daemon start 2>/dev/null', {
858
- stdio: 'pipe',
859
- cwd: ctx.cwd,
860
- timeout: 30000
861
- });
863
+ runCli(['daemon', 'start']);
862
864
  output.writeln(output.success(' ✓ Daemon started'));
863
865
  }
864
866
  catch {
@@ -872,11 +874,7 @@ const initClaudeAction = async (ctx) => {
872
874
  if (startAll) {
873
875
  try {
874
876
  output.writeln(output.dim(' Initializing swarm...'));
875
- execSync('npx @claude-flow/cli@latest swarm init --topology hierarchical 2>/dev/null', {
876
- stdio: 'pipe',
877
- cwd: ctx.cwd,
878
- timeout: 30000
879
- });
877
+ runCli(['swarm', 'init', '--topology', 'hierarchical']);
880
878
  output.writeln(output.success(' ✓ Swarm initialized'));
881
879
  }
882
880
  catch {
@@ -7,6 +7,7 @@ import { DEFAULT_SEARCH_THRESHOLD, nearMisses } from '../memory/search-defaults.
7
7
  import { output } from '../output.js';
8
8
  import { select, confirm, input } from '../prompt.js';
9
9
  import { callMCPTool, MCPClientError } from '../mcp-client.js';
10
+ import { localCliContext } from '../mcp-tools/path-containment.js';
10
11
  import { distillCommand } from './memory-distill.js';
11
12
  import { backupCommand } from './memory-backup.js';
12
13
  import { countSiblingStoreRows } from '../memory/sibling-store.js';
@@ -1086,7 +1087,7 @@ const statsCommand = {
1086
1087
  // Call MCP memory/stats tool for real statistics
1087
1088
  try {
1088
1089
  const dbPath = resolveDbPath(ctx.flags.path);
1089
- const statsResult = await callMCPTool('memory_stats', { dbPath });
1090
+ const statsResult = await callMCPTool('memory_stats', { dbPath }, localCliContext());
1090
1091
  if (statsResult.available === false) {
1091
1092
  output.printError(`Failed to get stats: ${statsResult.error || 'Store unavailable'}`);
1092
1093
  return { success: false, exitCode: 1 };
@@ -1650,7 +1651,7 @@ const exportCommand = {
1650
1651
  namespace: ctx.flags.namespace,
1651
1652
  includeVectors: ctx.flags.includeVectors ?? true,
1652
1653
  dbPath: resolveDbPath(ctx.flags.path),
1653
- });
1654
+ }, localCliContext());
1654
1655
  // memory_export reports failure as { error } rather than throwing; without
1655
1656
  // this check the command printed "Exported to undefined" and then crashed
1656
1657
  // reading result.exported.entries (#4204).
@@ -1722,7 +1723,7 @@ const importCommand = {
1722
1723
  merge: ctx.flags.merge ?? true,
1723
1724
  namespace: ctx.flags.namespace,
1724
1725
  dbPath: resolveDbPath(ctx.flags.path),
1725
- });
1726
+ }, localCliContext());
1726
1727
  // memory_import reports a bad file as { error } rather than throwing, and
1727
1728
  // a partial write as { success: false, error, imported }. Without this the
1728
1729
  // command printed "Imported from undefined" and crashed on result.imported,
@@ -35,8 +35,8 @@ const trainCommand = {
35
35
  action: async (ctx) => {
36
36
  const patternType = (ctx.flags.pattern || ctx.flags.patternType || ctx.flags['pattern-type']) || 'coordination';
37
37
  const epochs = parseInt(ctx.flags.epochs || '50', 10);
38
- const learningRate = parseFloat(ctx.flags['learning-rate'] || '0.01');
39
- const batchSize = parseInt(ctx.flags['batch-size'] || '32', 10);
38
+ const learningRate = parseFloat((ctx.flags.learningRate ?? ctx.flags['learning-rate']) || '0.01');
39
+ const batchSize = parseInt((ctx.flags.batchSize ?? ctx.flags['batch-size']) || '32', 10);
40
40
  const dim = Math.min(parseInt(ctx.flags.dim || '256', 10), 256);
41
41
  // #2549 follow-up — backend routing: 'native' = @ruvector/ruvllm
42
42
  // TrainingPipeline (real epochs/early-stopping/disk checkpoints),
@@ -44,7 +44,7 @@ const trainCommand = {
44
44
  // 'auto' = native when the module resolves, else wasm.
45
45
  const backendFlag = String(ctx.flags.backend || 'auto');
46
46
  // Feature: validation split + resume (native TrainingPipeline leg).
47
- const valSplitRaw = parseFloat(ctx.flags['val-split'] ?? '0.1');
47
+ const valSplitRaw = parseFloat((ctx.flags.valSplit ?? ctx.flags['val-split']) ?? '0.1');
48
48
  const valSplit = Number.isFinite(valSplitRaw) ? Math.max(0, Math.min(1, valSplitRaw)) : 0.1;
49
49
  const resumePath = ctx.flags.resume ? String(ctx.flags.resume) : undefined;
50
50
  // --resume is a native-only capability; refuse the WASM combination up
@@ -1023,7 +1023,7 @@ const exportCommand = {
1023
1023
  const outputFile = ctx.flags.output;
1024
1024
  const pinToIpfs = ctx.flags.ipfs;
1025
1025
  const signExport = ctx.flags.sign !== false;
1026
- const stripPii = ctx.flags['strip-pii'] !== false;
1026
+ const stripPii = (ctx.flags.stripPii ?? ctx.flags['strip-pii']) !== false;
1027
1027
  const customName = ctx.flags.name;
1028
1028
  output.writeln();
1029
1029
  output.writeln(output.bold('Secure Model Export'));
@@ -1703,7 +1703,8 @@ const routerTrainCommand = {
1703
1703
  action: async (ctx) => {
1704
1704
  const corpusPath = ctx.flags.corpus;
1705
1705
  const outPath = ctx.flags.out || './router.krr.json';
1706
- const qualityBar = parseFloat(ctx.flags['quality-bar'] || '0.8') || 0.8;
1706
+ const requestedQualityBar = parseFloat(String(ctx.flags.qualityBar ?? ctx.flags['quality-bar'] ?? 0.8));
1707
+ const qualityBar = Number.isNaN(requestedQualityBar) ? 0.8 : requestedQualityBar;
1707
1708
  // Indirect the optional-dep specifier through a string variable so tsc
1708
1709
  // doesn't statically resolve `@metaharness/router` at build time (TS2307
1709
1710
  // when it isn't installed — #2586 pattern). The dep is optional at
@@ -3464,7 +3465,8 @@ const routerBanditStateCommand = {
3464
3465
  const statePath = ctx.flags.path
3465
3466
  ?? path.resolve(process.cwd(), '.swarm', 'model-router-state.json');
3466
3467
  const fmt = ctx.flags.format || 'table';
3467
- const coldThreshold = parseInt(ctx.flags['cold-threshold'] || '4', 10) || 4;
3468
+ const requestedColdThreshold = parseInt(String(ctx.flags.coldThreshold ?? ctx.flags['cold-threshold'] ?? 4), 10);
3469
+ const coldThreshold = Number.isNaN(requestedColdThreshold) ? 4 : requestedColdThreshold;
3468
3470
  if (!fs.existsSync(statePath)) {
3469
3471
  const msg = `Bandit state file not found at ${statePath}`;
3470
3472
  if (fmt === 'json')
@@ -367,7 +367,7 @@ const feedbackCommand = {
367
367
  const taskDescription = ctx.flags.task;
368
368
  const agentId = ctx.flags.agent;
369
369
  const reward = ctx.flags.reward;
370
- const nextTask = ctx.flags['next-task'];
370
+ const nextTask = ctx.flags.nextTask;
371
371
  if (!taskDescription || !agentId) {
372
372
  output.printError('Task description and agent are required');
373
373
  return { success: false, exitCode: 1 };
@@ -53,10 +53,10 @@ const backupSubcommand = {
53
53
  {
54
54
  name: 'format',
55
55
  short: 'f',
56
- description: 'Output format',
56
+ description: 'Output format (defaults to SQL)',
57
57
  type: 'string',
58
- default: 'sql',
59
- choices: ['sql', 'json', 'csv'],
58
+ default: 'text',
59
+ choices: ['text', 'sql', 'json', 'csv'],
60
60
  },
61
61
  {
62
62
  name: 'compress',
@@ -125,9 +125,11 @@ const backupSubcommand = {
125
125
  const config = getConnectionConfig(ctx);
126
126
  let outputPath = ctx.flags.output;
127
127
  const tablesFilter = ctx.flags.tables;
128
- const format = ctx.flags.format || 'sql';
128
+ // The CLI validates the shared --format flag against its global choices.
129
+ const requestedFormat = ctx.flags.format;
130
+ const format = !requestedFormat || requestedFormat === 'text' ? 'sql' : requestedFormat;
129
131
  const compress = ctx.flags.compress;
130
- const includeIndexes = ctx.flags['include-indexes'] !== false;
132
+ const includeIndexes = (ctx.flags.includeIndexes ?? ctx.flags['include-indexes']) !== false;
131
133
  output.writeln();
132
134
  output.writeln(output.bold('RuVector Backup'));
133
135
  output.writeln(output.dim('='.repeat(60)));
@@ -158,7 +158,8 @@ export const benchmarkCommand = {
158
158
  const topK = parseInt(ctx.flags.k || '10', 10);
159
159
  const metric = ctx.flags.metric || 'cosine';
160
160
  const indexType = ctx.flags.index || 'hnsw';
161
- const batchSize = parseInt(ctx.flags['batch-size'] || '1000', 10);
161
+ const batchSizeFlag = ctx.flags.batchSize ?? ctx.flags['batch-size'] ?? 1000;
162
+ const batchSize = typeof batchSizeFlag === 'string' ? Number(batchSizeFlag) : batchSizeFlag;
162
163
  const cleanup = ctx.flags.cleanup !== false;
163
164
  output.writeln();
164
165
  output.writeln(output.bold('RuVector Performance Benchmark'));
@@ -168,6 +169,10 @@ export const benchmarkCommand = {
168
169
  output.printError('Database name is required. Use --database or -d flag, or set PGDATABASE env.');
169
170
  return { success: false, exitCode: 1 };
170
171
  }
172
+ if (typeof batchSize !== 'number' || !Number.isSafeInteger(batchSize) || batchSize < 1) {
173
+ output.printError('--batch-size must be a positive integer');
174
+ return { success: false, exitCode: 1 };
175
+ }
171
176
  // Show benchmark configuration
172
177
  output.writeln(output.highlight('Benchmark Configuration:'));
173
178
  output.printTable({
@@ -166,15 +166,21 @@ export const importCommand = {
166
166
  ],
167
167
  action: async (ctx) => {
168
168
  const inputFile = ctx.flags.input;
169
- const fromMemory = ctx.flags['from-memory'];
169
+ const fromMemory = (ctx.flags.fromMemory ?? ctx.flags['from-memory']);
170
170
  const outputFile = ctx.flags.output;
171
- const batchSize = ctx.flags['batch-size'] || 100;
171
+ const batchSizeFlag = ctx.flags.batchSize ?? ctx.flags['batch-size'] ?? 100;
172
+ const batchSize = typeof batchSizeFlag === 'string' ? Number(batchSizeFlag) : batchSizeFlag;
172
173
  const containerName = ctx.flags.container || 'ruvector-postgres';
173
174
  const verbose = ctx.flags.verbose;
174
175
  output.writeln();
175
176
  output.writeln(output.bold('RuVector PostgreSQL Import'));
176
177
  output.writeln(output.dim('='.repeat(50)));
177
178
  output.writeln();
179
+ if (typeof batchSize !== 'number' || !Number.isSafeInteger(batchSize) || batchSize < 1) {
180
+ const message = '--batch-size must be a positive integer';
181
+ output.printError(message);
182
+ return { success: false, message };
183
+ }
178
184
  // Validate input
179
185
  if (!inputFile && !fromMemory) {
180
186
  output.printError('Either --input <file> or --from-memory is required');
@@ -248,6 +254,7 @@ export const importCommand = {
248
254
  sqlStatements.push('');
249
255
  sqlStatements.push('BEGIN;');
250
256
  sqlStatements.push('');
257
+ const inserts = [];
251
258
  for (const entry of entries) {
252
259
  try {
253
260
  // Track statistics
@@ -256,9 +263,7 @@ export const importCommand = {
256
263
  if (entry.embedding && entry.embedding.length > 0) {
257
264
  stats.withEmbeddings++;
258
265
  }
259
- const sql = generateInsertSQL(entry);
260
- sqlStatements.push(sql);
261
- sqlStatements.push('');
266
+ inserts.push(generateInsertSQL(entry));
262
267
  stats.imported++;
263
268
  if (verbose) {
264
269
  output.writeln(output.dim(` Processed: ${entry.key} (${ns})`));
@@ -270,6 +275,15 @@ export const importCommand = {
270
275
  output.printWarning(`Skipped entry "${entry.key}": ${errorMessage}`);
271
276
  }
272
277
  }
278
+ // Send each batch as one statement while keeping ordered upserts in the same transaction.
279
+ for (let offset = 0; offset < inserts.length; offset += batchSize) {
280
+ const batch = inserts.slice(offset, offset + batchSize).join('\n\n');
281
+ let tag = 'ruvector_batch';
282
+ // A value containing the delimiter must stay inside the block.
283
+ while (batch.includes(`$${tag}$`))
284
+ tag += '_';
285
+ sqlStatements.push(`DO $${tag}$\nBEGIN\n${batch}\nEND;\n$${tag}$;`, '');
286
+ }
273
287
  sqlStatements.push('COMMIT;');
274
288
  sqlStatements.push('');
275
289
  sqlStatements.push(`-- Import complete: ${stats.imported} entries`);
@@ -145,7 +145,7 @@ export const initCommand = {
145
145
  }
146
146
  const force = ctx.flags.force;
147
147
  const dimensions = parseInt(ctx.flags.dimensions || '1536', 10);
148
- const indexType = ctx.flags['index-type'] || 'hnsw';
148
+ const indexType = (ctx.flags.indexType ?? ctx.flags['index-type']) || 'hnsw';
149
149
  // Show configuration
150
150
  output.writeln(output.highlight('Connection Configuration:'));
151
151
  output.printTable({