@claude-flow/cli 3.42.3 → 3.42.5

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 (460) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  2. package/.claude/agents/analysis/code-analyzer.md +209 -209
  3. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  4. package/.claude/agents/architecture/arch-system-design.md +156 -156
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/browser/browser-agent.yaml +182 -182
  7. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  8. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  9. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  10. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  11. package/.claude/agents/consensus/quorum-manager.md +822 -822
  12. package/.claude/agents/consensus/raft-manager.md +62 -62
  13. package/.claude/agents/consensus/security-manager.md +621 -621
  14. package/.claude/agents/core/planner.md +374 -374
  15. package/.claude/agents/custom/test-long-runner.md +44 -44
  16. package/.claude/agents/data/data-ml-model.md +444 -444
  17. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  18. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  19. package/.claude/agents/development/dev-backend-api.md +344 -344
  20. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  21. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  22. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  23. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  24. package/.claude/agents/flow-nexus/app-store.md +87 -87
  25. package/.claude/agents/flow-nexus/authentication.md +68 -68
  26. package/.claude/agents/flow-nexus/challenges.md +80 -80
  27. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  28. package/.claude/agents/flow-nexus/payments.md +82 -82
  29. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  30. package/.claude/agents/flow-nexus/swarm.md +75 -75
  31. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  32. package/.claude/agents/flow-nexus/workflow.md +83 -83
  33. package/.claude/agents/github/code-review-swarm.md +377 -377
  34. package/.claude/agents/github/github-modes.md +172 -172
  35. package/.claude/agents/github/issue-tracker.md +575 -575
  36. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  37. package/.claude/agents/github/pr-manager.md +437 -437
  38. package/.claude/agents/github/project-board-sync.md +508 -508
  39. package/.claude/agents/github/release-manager.md +604 -604
  40. package/.claude/agents/github/release-swarm.md +582 -582
  41. package/.claude/agents/github/repo-architect.md +397 -397
  42. package/.claude/agents/github/swarm-issue.md +572 -572
  43. package/.claude/agents/github/swarm-pr.md +427 -427
  44. package/.claude/agents/github/sync-coordinator.md +451 -451
  45. package/.claude/agents/github/workflow-automation.md +902 -902
  46. package/.claude/agents/goal/agent.md +815 -815
  47. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  48. package/.claude/agents/optimization/load-balancer.md +430 -430
  49. package/.claude/agents/optimization/performance-monitor.md +671 -671
  50. package/.claude/agents/optimization/resource-allocator.md +673 -673
  51. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  52. package/.claude/agents/payments/agentic-payments.md +126 -126
  53. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  54. package/.claude/agents/sparc/architecture.md +698 -698
  55. package/.claude/agents/sparc/pseudocode.md +519 -519
  56. package/.claude/agents/sparc/refinement.md +801 -801
  57. package/.claude/agents/sparc/specification.md +477 -477
  58. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  59. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  60. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  61. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  62. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  63. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  64. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  65. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  66. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  67. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  68. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  69. package/.claude/agents/templates/base-template-generator.md +289 -289
  70. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  71. package/.claude/agents/templates/github-pr-manager.md +176 -176
  72. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  73. package/.claude/agents/templates/memory-coordinator.md +186 -186
  74. package/.claude/agents/templates/orchestrator-task.md +138 -138
  75. package/.claude/agents/templates/performance-analyzer.md +198 -198
  76. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  77. package/.claude/agents/testing/production-validator.md +394 -394
  78. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  79. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  80. package/.claude/agents/v3/claims-authorizer.md +208 -208
  81. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  82. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  83. package/.claude/agents/v3/injection-analyst.md +236 -236
  84. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  85. package/.claude/agents/v3/pii-detector.md +151 -151
  86. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  87. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  88. package/.claude/agents/v3/security-architect.md +867 -867
  89. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  90. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  91. package/.claude/commands/agents/README.md +50 -50
  92. package/.claude/commands/agents/agent-capabilities.md +140 -140
  93. package/.claude/commands/agents/agent-coordination.md +28 -28
  94. package/.claude/commands/agents/agent-spawning.md +28 -28
  95. package/.claude/commands/agents/agent-types.md +216 -216
  96. package/.claude/commands/agents/health.md +139 -139
  97. package/.claude/commands/agents/list.md +100 -100
  98. package/.claude/commands/agents/logs.md +130 -130
  99. package/.claude/commands/agents/metrics.md +122 -122
  100. package/.claude/commands/agents/pool.md +127 -127
  101. package/.claude/commands/agents/spawn.md +140 -140
  102. package/.claude/commands/agents/status.md +115 -115
  103. package/.claude/commands/agents/stop.md +102 -102
  104. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  105. package/.claude/commands/analysis/README.md +9 -9
  106. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  107. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  108. package/.claude/commands/analysis/performance-report.md +25 -25
  109. package/.claude/commands/analysis/token-efficiency.md +44 -44
  110. package/.claude/commands/analysis/token-usage.md +25 -25
  111. package/.claude/commands/automation/README.md +9 -9
  112. package/.claude/commands/automation/auto-agent.md +122 -122
  113. package/.claude/commands/automation/self-healing.md +105 -105
  114. package/.claude/commands/automation/session-memory.md +89 -89
  115. package/.claude/commands/automation/smart-agents.md +72 -72
  116. package/.claude/commands/automation/smart-spawn.md +25 -25
  117. package/.claude/commands/automation/workflow-select.md +25 -25
  118. package/.claude/commands/claude-flow-help.md +103 -103
  119. package/.claude/commands/claude-flow-memory.md +107 -107
  120. package/.claude/commands/claude-flow-swarm.md +205 -205
  121. package/.claude/commands/coordination/README.md +9 -9
  122. package/.claude/commands/coordination/agent-spawn.md +25 -25
  123. package/.claude/commands/coordination/init.md +44 -44
  124. package/.claude/commands/coordination/orchestrate.md +43 -43
  125. package/.claude/commands/coordination/spawn.md +45 -45
  126. package/.claude/commands/coordination/swarm-init.md +85 -85
  127. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  128. package/.claude/commands/github/README.md +11 -11
  129. package/.claude/commands/github/code-review-swarm.md +513 -513
  130. package/.claude/commands/github/code-review.md +25 -25
  131. package/.claude/commands/github/github-modes.md +146 -146
  132. package/.claude/commands/github/github-swarm.md +121 -121
  133. package/.claude/commands/github/issue-tracker.md +291 -291
  134. package/.claude/commands/github/issue-triage.md +25 -25
  135. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  136. package/.claude/commands/github/pr-enhance.md +26 -26
  137. package/.claude/commands/github/pr-manager.md +169 -169
  138. package/.claude/commands/github/project-board-sync.md +470 -470
  139. package/.claude/commands/github/release-manager.md +339 -339
  140. package/.claude/commands/github/release-swarm.md +543 -543
  141. package/.claude/commands/github/repo-analyze.md +25 -25
  142. package/.claude/commands/github/repo-architect.md +366 -366
  143. package/.claude/commands/github/swarm-issue.md +484 -484
  144. package/.claude/commands/github/swarm-pr.md +287 -287
  145. package/.claude/commands/github/sync-coordinator.md +302 -302
  146. package/.claude/commands/github/workflow-automation.md +441 -441
  147. package/.claude/commands/hive-mind/README.md +17 -17
  148. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  149. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  150. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  151. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  152. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  153. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  154. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  155. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  156. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  157. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  159. package/.claude/commands/hooks/README.md +11 -11
  160. package/.claude/commands/hooks/overview.md +57 -57
  161. package/.claude/commands/hooks/post-edit.md +117 -117
  162. package/.claude/commands/hooks/post-task.md +112 -112
  163. package/.claude/commands/hooks/pre-edit.md +113 -113
  164. package/.claude/commands/hooks/pre-task.md +111 -111
  165. package/.claude/commands/hooks/session-end.md +118 -118
  166. package/.claude/commands/hooks/setup.md +102 -102
  167. package/.claude/commands/memory/README.md +9 -9
  168. package/.claude/commands/memory/memory-persist.md +25 -25
  169. package/.claude/commands/memory/memory-search.md +25 -25
  170. package/.claude/commands/memory/memory-usage.md +25 -25
  171. package/.claude/commands/memory/neural.md +47 -47
  172. package/.claude/commands/monitoring/README.md +9 -9
  173. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  174. package/.claude/commands/monitoring/agents.md +44 -44
  175. package/.claude/commands/monitoring/real-time-view.md +25 -25
  176. package/.claude/commands/monitoring/status.md +46 -46
  177. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  178. package/.claude/commands/optimization/README.md +9 -9
  179. package/.claude/commands/optimization/auto-topology.md +61 -61
  180. package/.claude/commands/optimization/cache-manage.md +25 -25
  181. package/.claude/commands/optimization/parallel-execute.md +25 -25
  182. package/.claude/commands/optimization/parallel-execution.md +49 -49
  183. package/.claude/commands/optimization/topology-optimize.md +25 -25
  184. package/.claude/commands/pair/README.md +260 -260
  185. package/.claude/commands/pair/commands.md +545 -545
  186. package/.claude/commands/pair/config.md +509 -509
  187. package/.claude/commands/pair/examples.md +511 -511
  188. package/.claude/commands/pair/modes.md +347 -347
  189. package/.claude/commands/pair/session.md +406 -406
  190. package/.claude/commands/pair/start.md +208 -208
  191. package/.claude/commands/sparc/analyzer.md +51 -51
  192. package/.claude/commands/sparc/architect.md +53 -53
  193. package/.claude/commands/sparc/ask.md +97 -97
  194. package/.claude/commands/sparc/batch-executor.md +54 -54
  195. package/.claude/commands/sparc/code.md +89 -89
  196. package/.claude/commands/sparc/coder.md +54 -54
  197. package/.claude/commands/sparc/debug.md +83 -83
  198. package/.claude/commands/sparc/debugger.md +54 -54
  199. package/.claude/commands/sparc/designer.md +53 -53
  200. package/.claude/commands/sparc/devops.md +109 -109
  201. package/.claude/commands/sparc/docs-writer.md +80 -80
  202. package/.claude/commands/sparc/documenter.md +54 -54
  203. package/.claude/commands/sparc/innovator.md +54 -54
  204. package/.claude/commands/sparc/integration.md +83 -83
  205. package/.claude/commands/sparc/mcp.md +117 -117
  206. package/.claude/commands/sparc/memory-manager.md +54 -54
  207. package/.claude/commands/sparc/optimizer.md +54 -54
  208. package/.claude/commands/sparc/orchestrator.md +131 -131
  209. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  210. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  211. package/.claude/commands/sparc/researcher.md +54 -54
  212. package/.claude/commands/sparc/reviewer.md +54 -54
  213. package/.claude/commands/sparc/security-review.md +80 -80
  214. package/.claude/commands/sparc/sparc-modes.md +174 -174
  215. package/.claude/commands/sparc/sparc.md +111 -111
  216. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  217. package/.claude/commands/sparc/supabase-admin.md +348 -348
  218. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  219. package/.claude/commands/sparc/tdd.md +54 -54
  220. package/.claude/commands/sparc/tester.md +54 -54
  221. package/.claude/commands/sparc/tutorial.md +79 -79
  222. package/.claude/commands/sparc/workflow-manager.md +54 -54
  223. package/.claude/commands/sparc.md +166 -166
  224. package/.claude/commands/stream-chain/pipeline.md +120 -120
  225. package/.claude/commands/stream-chain/run.md +69 -69
  226. package/.claude/commands/swarm/README.md +15 -15
  227. package/.claude/commands/swarm/analysis.md +95 -95
  228. package/.claude/commands/swarm/development.md +96 -96
  229. package/.claude/commands/swarm/examples.md +168 -168
  230. package/.claude/commands/swarm/maintenance.md +102 -102
  231. package/.claude/commands/swarm/optimization.md +117 -117
  232. package/.claude/commands/swarm/research.md +136 -136
  233. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  234. package/.claude/commands/swarm/swarm-background.md +8 -8
  235. package/.claude/commands/swarm/swarm-init.md +19 -19
  236. package/.claude/commands/swarm/swarm-modes.md +8 -8
  237. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  238. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  239. package/.claude/commands/swarm/swarm-status.md +8 -8
  240. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  241. package/.claude/commands/swarm/swarm.md +87 -87
  242. package/.claude/commands/swarm/testing.md +131 -131
  243. package/.claude/commands/training/README.md +9 -9
  244. package/.claude/commands/training/model-update.md +25 -25
  245. package/.claude/commands/training/neural-patterns.md +107 -107
  246. package/.claude/commands/training/neural-train.md +75 -75
  247. package/.claude/commands/training/pattern-learn.md +25 -25
  248. package/.claude/commands/training/specialization.md +62 -62
  249. package/.claude/commands/truth/start.md +142 -142
  250. package/.claude/commands/verify/check.md +49 -49
  251. package/.claude/commands/verify/start.md +127 -127
  252. package/.claude/commands/workflows/README.md +9 -9
  253. package/.claude/commands/workflows/development.md +77 -77
  254. package/.claude/commands/workflows/research.md +62 -62
  255. package/.claude/commands/workflows/workflow-create.md +25 -25
  256. package/.claude/commands/workflows/workflow-execute.md +25 -25
  257. package/.claude/commands/workflows/workflow-export.md +25 -25
  258. package/.claude/eval/human-relevance-frozen-v1.json +17 -17
  259. package/.claude/evolve-proof/generation-0.json +211 -211
  260. package/.claude/evolve-proof/real-generation-0.json +406 -406
  261. package/.claude/evolve-proof/real-generation-1.json +406 -406
  262. package/.claude/helpers/README.md +96 -96
  263. package/.claude/helpers/adr-compliance.sh +186 -186
  264. package/.claude/helpers/auto-commit.sh +178 -178
  265. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  266. package/.claude/helpers/checkpoint-manager.sh +251 -251
  267. package/.claude/helpers/daemon-manager.sh +252 -252
  268. package/.claude/helpers/ddd-tracker.sh +144 -144
  269. package/.claude/helpers/github-safe.js +156 -156
  270. package/.claude/helpers/github-setup.sh +45 -45
  271. package/.claude/helpers/guidance-hook.sh +13 -13
  272. package/.claude/helpers/guidance-hooks.sh +102 -102
  273. package/.claude/helpers/health-monitor.sh +108 -108
  274. package/.claude/helpers/helpers.manifest.json +6 -6
  275. package/.claude/helpers/hook-handler.cjs +606 -606
  276. package/.claude/helpers/intelligence.cjs +1169 -1169
  277. package/.claude/helpers/learning-hooks.sh +329 -329
  278. package/.claude/helpers/learning-optimizer.sh +127 -127
  279. package/.claude/helpers/learning-service.mjs +1144 -1144
  280. package/.claude/helpers/memory.js +83 -83
  281. package/.claude/helpers/metrics-db.mjs +503 -503
  282. package/.claude/helpers/pattern-consolidator.sh +86 -86
  283. package/.claude/helpers/perf-worker.sh +160 -160
  284. package/.claude/helpers/post-commit +16 -16
  285. package/.claude/helpers/pre-commit +26 -26
  286. package/.claude/helpers/quick-start.sh +19 -19
  287. package/.claude/helpers/router.js +105 -105
  288. package/.claude/helpers/security-scanner.sh +127 -127
  289. package/.claude/helpers/session.js +157 -157
  290. package/.claude/helpers/setup-mcp.sh +18 -18
  291. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  292. package/.claude/helpers/statusline-hook.sh +21 -21
  293. package/.claude/helpers/statusline.cjs +1290 -1290
  294. package/.claude/helpers/statusline.js +340 -340
  295. package/.claude/helpers/swarm-comms.sh +353 -353
  296. package/.claude/helpers/swarm-hooks.sh +761 -761
  297. package/.claude/helpers/swarm-monitor.sh +210 -210
  298. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  299. package/.claude/helpers/update-v3-progress.sh +165 -165
  300. package/.claude/helpers/v3-quick-status.sh +57 -57
  301. package/.claude/helpers/v3.sh +110 -110
  302. package/.claude/helpers/validate-v3-config.sh +215 -215
  303. package/.claude/helpers/worker-manager.sh +170 -170
  304. package/.claude/proven-config.json +41 -41
  305. package/.claude/proven-config.manifest.json +37 -37
  306. package/.claude/proven-config.signed.json +41 -41
  307. package/.claude/settings.json +182 -182
  308. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  309. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  310. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  311. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  312. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  313. package/.claude/skills/browser/SKILL.md +204 -204
  314. package/.claude/skills/dual-mode/README.md +71 -71
  315. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  316. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  317. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  318. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  319. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  320. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  321. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  322. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  323. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  324. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  325. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  326. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  327. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  328. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  329. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  330. package/.claude/skills/skill-builder/SKILL.md +910 -910
  331. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  332. package/.claude/skills/stream-chain/SKILL.md +560 -560
  333. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  334. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  335. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  336. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  337. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  338. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  339. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  340. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  341. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  342. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  343. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  344. package/.claude/skills/verification-quality/SKILL.md +691 -691
  345. package/README.md +422 -422
  346. package/bin/cli.js +338 -338
  347. package/bin/mcp-server.js +224 -224
  348. package/bin/preinstall.cjs +2 -2
  349. package/catalog-manifest.json +2 -2
  350. package/dist/src/benchmarks/gaia-critic.js +24 -24
  351. package/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  352. package/dist/src/commands/completions.js +409 -409
  353. package/dist/src/commands/daemon.js +44 -44
  354. package/dist/src/commands/doctor.js +4 -4
  355. package/dist/src/commands/embeddings.js +26 -26
  356. package/dist/src/commands/hive-mind.js +97 -97
  357. package/dist/src/commands/hooks.js +9 -9
  358. package/dist/src/commands/init.js +75 -75
  359. package/dist/src/commands/ruvector/backup.js +23 -23
  360. package/dist/src/commands/ruvector/benchmark.js +31 -31
  361. package/dist/src/commands/ruvector/import.js +14 -14
  362. package/dist/src/commands/ruvector/init.js +115 -115
  363. package/dist/src/commands/ruvector/migrate.js +99 -99
  364. package/dist/src/commands/ruvector/optimize.js +51 -51
  365. package/dist/src/commands/ruvector/setup.js +624 -624
  366. package/dist/src/commands/ruvector/status.js +38 -38
  367. package/dist/src/config/proven-config.js +2 -2
  368. package/dist/src/init/claudemd-generator.js +273 -273
  369. package/dist/src/init/executor.js +453 -453
  370. package/dist/src/init/helper-signing.js +2 -2
  371. package/dist/src/init/helpers-generator.js +917 -917
  372. package/dist/src/init/statusline-generator.js +24 -24
  373. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  374. package/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  375. package/dist/src/mcp-tools/memory-tools.js +6 -4
  376. package/dist/src/mcp-tools/seraphina-tools.js +4 -4
  377. package/dist/src/memory/graph-edge-writer.js +22 -22
  378. package/dist/src/memory/memory-bridge.js +161 -127
  379. package/dist/src/memory/memory-initializer.js +416 -416
  380. package/dist/src/memory/rabitq-index.js +5 -5
  381. package/dist/src/proxy/verify.js +2 -2
  382. package/dist/src/runtime/headless.js +28 -28
  383. package/dist/src/services/distill-tuning.js +7 -7
  384. package/dist/src/services/headless-worker-executor.js +84 -84
  385. package/dist/src/services/memory-distillation.js +18 -18
  386. package/dist/src/transfer/deploy-seraphine.js +23 -23
  387. package/node_modules/@claude-flow/codex/.agents/skills/github-automation/SKILL.md +32 -32
  388. package/node_modules/@claude-flow/codex/.agents/skills/memory-management/SKILL.md +45 -45
  389. package/node_modules/@claude-flow/codex/.agents/skills/performance-analysis/SKILL.md +32 -32
  390. package/node_modules/@claude-flow/codex/.agents/skills/security-audit/SKILL.md +46 -46
  391. package/node_modules/@claude-flow/codex/.agents/skills/sparc-methodology/SKILL.md +46 -46
  392. package/node_modules/@claude-flow/codex/.agents/skills/swarm-orchestration/SKILL.md +53 -53
  393. package/node_modules/@claude-flow/codex/README.md +1044 -1044
  394. package/node_modules/@claude-flow/codex/dist/cli.js +0 -0
  395. package/node_modules/@claude-flow/codex/dist/dual-mode/orchestrator.js +13 -13
  396. package/node_modules/@claude-flow/codex/dist/generators/agents-md.js +664 -664
  397. package/node_modules/@claude-flow/codex/dist/generators/config-toml.js +455 -455
  398. package/node_modules/@claude-flow/codex/dist/generators/skill-md.js +45 -45
  399. package/node_modules/@claude-flow/codex/dist/initializer.js +167 -167
  400. package/node_modules/@claude-flow/codex/dist/templates/index.js +15 -15
  401. package/node_modules/@claude-flow/mcp/README.md +429 -429
  402. package/node_modules/@claude-flow/plugin-agent-federation/README.md +49 -49
  403. package/node_modules/@claude-flow/plugin-agent-federation/dist/bin.js +0 -0
  404. package/node_modules/@claude-flow/security/README.md +292 -292
  405. package/node_modules/@claude-flow/security/dist/credential-generator.js +9 -9
  406. package/node_modules/@claude-flow/security/dist/oauth/callback-server.js +9 -9
  407. package/package.json +181 -181
  408. package/plugins/ruflo-metaharness/.claude-plugin/plugin.json +32 -32
  409. package/plugins/ruflo-metaharness/README.md +72 -72
  410. package/plugins/ruflo-metaharness/agents/metaharness-architect.md +58 -58
  411. package/plugins/ruflo-metaharness/commands/ruflo-metaharness.md +50 -50
  412. package/plugins/ruflo-metaharness/scripts/_darwin.mjs +210 -210
  413. package/plugins/ruflo-metaharness/scripts/_harness.mjs +334 -334
  414. package/plugins/ruflo-metaharness/scripts/_invoke.mjs +230 -230
  415. package/plugins/ruflo-metaharness/scripts/_redblue.mjs +143 -143
  416. package/plugins/ruflo-metaharness/scripts/_similarity.mjs +161 -161
  417. package/plugins/ruflo-metaharness/scripts/_spike-similarity.mjs +223 -223
  418. package/plugins/ruflo-metaharness/scripts/audit-list.mjs +158 -158
  419. package/plugins/ruflo-metaharness/scripts/audit-trend.mjs +272 -272
  420. package/plugins/ruflo-metaharness/scripts/bench-parse-mcp-scan.mjs +146 -146
  421. package/plugins/ruflo-metaharness/scripts/bench-recordpair-overhead.mjs +186 -186
  422. package/plugins/ruflo-metaharness/scripts/bench-similarity.mjs +177 -177
  423. package/plugins/ruflo-metaharness/scripts/bench.mjs +95 -95
  424. package/plugins/ruflo-metaharness/scripts/drift-from-history.mjs +363 -363
  425. package/plugins/ruflo-metaharness/scripts/evolve.mjs +404 -404
  426. package/plugins/ruflo-metaharness/scripts/genome.mjs +105 -105
  427. package/plugins/ruflo-metaharness/scripts/gepa.mjs +153 -153
  428. package/plugins/ruflo-metaharness/scripts/learn.mjs +127 -127
  429. package/plugins/ruflo-metaharness/scripts/mcp-scan.mjs +110 -110
  430. package/plugins/ruflo-metaharness/scripts/mint.mjs +126 -126
  431. package/plugins/ruflo-metaharness/scripts/oia-audit.mjs +228 -228
  432. package/plugins/ruflo-metaharness/scripts/redblue.mjs +286 -286
  433. package/plugins/ruflo-metaharness/scripts/router-parallel-analyze.mjs +250 -250
  434. package/plugins/ruflo-metaharness/scripts/score.mjs +92 -92
  435. package/plugins/ruflo-metaharness/scripts/security-bench.mjs +174 -174
  436. package/plugins/ruflo-metaharness/scripts/similarity.mjs +158 -158
  437. package/plugins/ruflo-metaharness/scripts/smoke.sh +2422 -2422
  438. package/plugins/ruflo-metaharness/scripts/test-graceful-degradation.mjs +165 -165
  439. package/plugins/ruflo-metaharness/scripts/test-mcp-tools.mjs +498 -498
  440. package/plugins/ruflo-metaharness/scripts/test-parallel-pipeline.mjs +204 -204
  441. package/plugins/ruflo-metaharness/scripts/test-pipeline-roundtrip.mjs +586 -586
  442. package/plugins/ruflo-metaharness/scripts/test-similarity.mjs +372 -372
  443. package/plugins/ruflo-metaharness/scripts/test-with-openrouter.mjs +229 -229
  444. package/plugins/ruflo-metaharness/scripts/threat-model.mjs +62 -62
  445. package/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md +64 -64
  446. package/plugins/ruflo-metaharness/skills/harness-drift-from-history/SKILL.md +65 -65
  447. package/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md +131 -131
  448. package/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md +57 -57
  449. package/plugins/ruflo-metaharness/skills/harness-gepa/SKILL.md +65 -65
  450. package/plugins/ruflo-metaharness/skills/harness-learn/SKILL.md +65 -65
  451. package/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md +49 -49
  452. package/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md +72 -72
  453. package/plugins/ruflo-metaharness/skills/harness-oia-audit/SKILL.md +79 -79
  454. package/plugins/ruflo-metaharness/skills/harness-score/SKILL.md +66 -66
  455. package/plugins/ruflo-metaharness/skills/harness-security-bench/SKILL.md +101 -101
  456. package/plugins/ruflo-metaharness/skills/harness-similarity/SKILL.md +67 -67
  457. package/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md +41 -41
  458. package/scripts/postinstall.cjs +153 -153
  459. package/dist/src/ruvector/diskann-backend.d.ts +0 -78
  460. package/dist/src/ruvector/diskann-backend.js +0 -310
package/bin/cli.js CHANGED
@@ -1,338 +1,338 @@
1
- #!/usr/bin/env node
2
- /**
3
- * @claude-flow/cli - CLI Entry Point
4
- *
5
- * Claude Flow V3 Command Line Interface
6
- *
7
- * Auto-detects MCP mode when stdin is piped and no args provided.
8
- * This allows: echo '{"jsonrpc":"2.0",...}' | npx @claude-flow/cli
9
- */
10
-
11
- import { randomUUID } from 'crypto';
12
- import { readFileSync } from 'fs';
13
- import { fileURLToPath } from 'url';
14
- import { dirname, join } from 'path';
15
-
16
- // #2253 / #2256: Console filter installed BEFORE any other import. Two jobs:
17
- //
18
- // 1. Suppress the cosmetic "[AgentDB Patch] Controller index not found"
19
- // warning from agentic-flow (it expects agentdb v1.x but we use v3).
20
- // Tight match — must include BOTH the prefix AND the specific text;
21
- // other [AgentDB Patch] messages flow through. Audit log
22
- // audit_1776483149979 flagged a broader filter as too aggressive.
23
- //
24
- // 2. Redirect noisy stdout writes from upstream embedder libraries
25
- // (ruvector ONNX loader, ruvector-onnx-embeddings-wasm parallel
26
- // embedder) to stderr. Those libraries use console.log for progress
27
- // messages — "Loading model:", " Downloading: …", "🚀 Initializing N
28
- // workers" — which corrupts MCP JSON-RPC stdio (#2253) and is noise
29
- // on stdout. stderr is the right channel for progress to a TTY user,
30
- // and the MCP stdio framer reads stdout only.
31
- //
32
- // This MUST be installed before `import('../dist/src/index.js')` so the
33
- // patch is in place before agentic-flow / ruvector load transitively.
34
- const _origWarn = console.warn;
35
- const _origLog = console.log;
36
- const _origError = console.error;
37
-
38
- // #2726 — Some MCP clients place every advertised schema in every model
39
- // request. Keep "all" as the backwards-compatible default, but honor the
40
- // same category/namespace/exact-name selector as `mcp start --tools`.
41
- function _filterAdvertisedMcpTools(tools) {
42
- const argv = process.argv.slice(2);
43
- const toolsIndex = argv.findIndex((arg) => arg === '--tools');
44
- const inlineTools = argv.find((arg) => arg.startsWith('--tools='));
45
- const configured = process.env.CLAUDE_FLOW_MCP_TOOLS
46
- || (toolsIndex >= 0 ? argv[toolsIndex + 1] : undefined)
47
- || (inlineTools ? inlineTools.slice('--tools='.length) : undefined);
48
- if (!configured || configured.trim().toLowerCase() === 'all') return tools;
49
- const selectors = new Set(
50
- configured.split(',').map((item) => item.trim().toLowerCase()).filter(Boolean),
51
- );
52
- if (selectors.size === 0) return tools;
53
- return tools.filter((tool) => {
54
- const name = tool.name.toLowerCase();
55
- const category = typeof tool.category === 'string' ? tool.category.toLowerCase() : '';
56
- return selectors.has(name)
57
- || selectors.has(category)
58
- || Array.from(selectors).some((selector) => name.startsWith(`${selector}_`));
59
- });
60
- }
61
- const _isCosmeticAgentdbPatchNoise = (msg) =>
62
- msg.includes('[AgentDB Patch]') && msg.includes('Controller index not found');
63
- const _STDERR_REDIRECT_PREFIXES = [
64
- 'Loading model: ',
65
- ' Downloading: ',
66
- ' Cache hit: ',
67
- ' Disk cache hit: ',
68
- 'Model cache cleared',
69
- '🚀 Initializing ',
70
- '✅ ',
71
- ];
72
- // agentdb's EmbeddingService.initialize() prints this cluster when
73
- // `@xenova/transformers` fails to load (commonly: macOS arm64 without
74
- // `brew install vips` — sharp can't resolve libvips). The warnings claim
75
- // agentdb is "falling back to mock embeddings", but memory-bridge.ts's
76
- // rescueAgentdbEmbedder swaps the embedder over to ruvector ONNX in
77
- // that exact case, so the user is NOT on mocks. The warnings are stale
78
- // and misleading; drop them. Match anchored to exact upstream prefixes
79
- // (agentdb/dist/controllers/EmbeddingService.js:48–56) so unrelated
80
- // warnings always flow through.
81
- const _AGENTDB_MOCK_FALLBACK_DROP_PREFIXES = [
82
- 'Transformers.js initialization failed:',
83
- ' Falling back to mock embeddings for testing',
84
- ' This is normal if:',
85
- ' - Running offline/without internet access',
86
- ' - Model not yet downloaded',
87
- ' - Network connectivity issues',
88
- ' To use real embeddings:',
89
- ' - Ensure internet connectivity for first',
90
- ' - Or pre-download: npx agentdb',
91
- ];
92
- const _shouldRedirectToStderr = (msg) => {
93
- for (const prefix of _STDERR_REDIRECT_PREFIXES) {
94
- if (msg.startsWith(prefix)) return true;
95
- }
96
- return false;
97
- };
98
- const _isAgentdbMockFallbackNoise = (msg) => {
99
- for (const prefix of _AGENTDB_MOCK_FALLBACK_DROP_PREFIXES) {
100
- if (msg.startsWith(prefix)) return true;
101
- }
102
- return false;
103
- };
104
- console.warn = (...args) => {
105
- const head = String(args[0] ?? '');
106
- if (_isCosmeticAgentdbPatchNoise(head)) return;
107
- if (_isAgentdbMockFallbackNoise(head)) return;
108
- _origWarn.apply(console, args);
109
- };
110
- console.log = (...args) => {
111
- const head = String(args[0] ?? '');
112
- if (_isCosmeticAgentdbPatchNoise(head)) return;
113
- if (_shouldRedirectToStderr(head)) {
114
- _origError.apply(console, args);
115
- return;
116
- }
117
- _origLog.apply(console, args);
118
- };
119
-
120
- // #2256 fast path: --version / -V / --help / -h must NOT trigger heavy
121
- // imports (agentic-flow, ruvector ONNX, etc.) — those eagerly download a
122
- // 23 MB ONNX model on cold cache, blocking 60+ s and causing SIGTERM
123
- // under common timeout windows (npx default, MCP stdio 30 s). Resolve
124
- // version directly from package.json and exit before any heavy import.
125
- {
126
- const _argv = process.argv.slice(2);
127
- if (_argv.length === 1 && (_argv[0] === '--version' || _argv[0] === '-V')) {
128
- try {
129
- const __dirname = dirname(fileURLToPath(import.meta.url));
130
- const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
131
- process.stdout.write(`ruflo v${pkg.version || '0.0.0'}\n`);
132
- } catch {
133
- process.stdout.write('ruflo v0.0.0\n');
134
- }
135
- process.exit(0);
136
- }
137
- // --help / -h with no other args also stays lightweight — fall through
138
- // to the existing fast help path inside index.ts; we don't short-circuit
139
- // here because some users pass `<command> --help` which needs lazy command
140
- // loading. The version short-circuit is the only one safe to inline.
141
- }
142
-
143
- // Check if we should run in MCP server mode
144
- // Conditions:
145
- // 1. stdin is being piped AND no CLI arguments provided (auto-detect)
146
- // 2. stdin is being piped AND args are "mcp start" (explicit, e.g. npx claude-flow@alpha mcp start)
147
- // 3. EXCEPT — if the user explicitly passed --transport <non-stdio>
148
- // (e.g. -t http), defer to the parser. Without this, every smoke
149
- // test or non-TTY caller of `mcp start -t http` got force-routed
150
- // into stdio mode and never hit the HTTP server (#1874 follow-up).
151
- const cliArgs = process.argv.slice(2);
152
- const isExplicitMCP = cliArgs.length >= 1 && cliArgs[0] === 'mcp' && (cliArgs.length === 1 || cliArgs[1] === 'start');
153
- const explicitNonStdioTransport = cliArgs.some((a, i) => {
154
- // -t <value> | --transport <value>
155
- if ((a === '-t' || a === '--transport') && cliArgs[i + 1] && cliArgs[i + 1] !== 'stdio') return true;
156
- // --transport=<value>
157
- if (/^--transport=/.test(a) && !/^--transport=stdio$/.test(a)) return true;
158
- return false;
159
- });
160
- const isMCPMode = !process.stdin.isTTY
161
- && !explicitNonStdioTransport
162
- && (process.argv.length === 2 || isExplicitMCP);
163
-
164
- if (isMCPMode) {
165
- // Run MCP server mode
166
- const { listMCPTools, callMCPTool, hasTool } = await import('../dist/src/mcp-client.js');
167
-
168
- const VERSION = '3.0.0';
169
- const sessionId = `mcp-${Date.now()}-${randomUUID().slice(0, 8)}`;
170
-
171
- console.error(
172
- `[${new Date().toISOString()}] INFO [claude-flow-mcp] (${sessionId}) Starting in stdio mode`
173
- );
174
-
175
- // Audit-flagged DoS protection (audit_1776483149979): cap the
176
- // newline-buffered stdin parser so a malicious client cannot pipe
177
- // gigabytes of un-newlined data and exhaust memory before
178
- // JSON.parse runs. 10MB is far above any legitimate MCP message
179
- // (the protocol's largest realistic payloads — tool descriptions,
180
- // batch search results — top out at ~1MB).
181
- const MCP_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
182
- let buffer = '';
183
- process.stdin.setEncoding('utf8');
184
- process.stdin.on('data', async (chunk) => {
185
- buffer += chunk;
186
- if (buffer.length > MCP_MAX_BUFFER_BYTES) {
187
- // Drop the buffer + emit a protocol-level error so the client
188
- // sees the rejection rather than a silent OOM.
189
- console.log(JSON.stringify({
190
- jsonrpc: '2.0',
191
- id: null,
192
- error: {
193
- code: -32700,
194
- message: `Buffered stdin exceeds ${MCP_MAX_BUFFER_BYTES} bytes without newline; resetting`,
195
- },
196
- }));
197
- buffer = '';
198
- return;
199
- }
200
- let lines = buffer.split('\n');
201
- buffer = lines.pop() || '';
202
-
203
- for (const line of lines) {
204
- if (line.trim()) {
205
- let message;
206
- try {
207
- message = JSON.parse(line);
208
- } catch {
209
- console.log(JSON.stringify({
210
- jsonrpc: '2.0',
211
- id: null,
212
- error: { code: -32700, message: 'Parse error' },
213
- }));
214
- continue;
215
- }
216
- try {
217
- const response = await handleMessage(message);
218
- if (response) {
219
- console.log(JSON.stringify(response));
220
- }
221
- } catch (error) {
222
- // #1606: Return proper internal error instead of parse error
223
- console.log(JSON.stringify({
224
- jsonrpc: '2.0',
225
- id: message.id ?? null,
226
- error: { code: -32603, message: error instanceof Error ? error.message : 'Internal error' },
227
- }));
228
- }
229
- }
230
- }
231
- });
232
-
233
- process.stdin.on('end', () => {
234
- process.exit(0);
235
- });
236
-
237
- async function handleMessage(message) {
238
- if (!message.method) {
239
- return {
240
- jsonrpc: '2.0',
241
- id: message.id,
242
- error: { code: -32600, message: 'Invalid Request: missing method' },
243
- };
244
- }
245
-
246
- const params = message.params || {};
247
-
248
- switch (message.method) {
249
- case 'initialize':
250
- return {
251
- jsonrpc: '2.0',
252
- id: message.id,
253
- result: {
254
- protocolVersion: '2024-11-05',
255
- serverInfo: { name: 'ruflo', version: VERSION },
256
- capabilities: {
257
- tools: { listChanged: true },
258
- resources: { subscribe: true, listChanged: true },
259
- },
260
- },
261
- };
262
-
263
- case 'tools/list': {
264
- const tools = _filterAdvertisedMcpTools(listMCPTools());
265
- return {
266
- jsonrpc: '2.0',
267
- id: message.id,
268
- result: {
269
- tools: tools.map(tool => ({
270
- name: tool.name,
271
- description: tool.description,
272
- inputSchema: tool.inputSchema,
273
- })),
274
- },
275
- };
276
- }
277
-
278
- case 'tools/call': {
279
- const toolName = params.name;
280
- const toolParams = params.arguments || {};
281
-
282
- if (!hasTool(toolName)) {
283
- return {
284
- jsonrpc: '2.0',
285
- id: message.id,
286
- error: { code: -32601, message: `Tool not found: ${toolName}` },
287
- };
288
- }
289
-
290
- try {
291
- const result = await callMCPTool(toolName, toolParams, { sessionId });
292
- return {
293
- jsonrpc: '2.0',
294
- id: message.id,
295
- result: { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] },
296
- };
297
- } catch (error) {
298
- return {
299
- jsonrpc: '2.0',
300
- id: message.id,
301
- error: {
302
- code: -32603,
303
- message: error instanceof Error ? error.message : 'Tool execution failed',
304
- },
305
- };
306
- }
307
- }
308
-
309
- case 'notifications/initialized':
310
- return null;
311
-
312
- case 'ping':
313
- return { jsonrpc: '2.0', id: message.id, result: {} };
314
-
315
- default:
316
- return {
317
- jsonrpc: '2.0',
318
- id: message.id,
319
- error: { code: -32601, message: `Method not found: ${message.method}` },
320
- };
321
- }
322
- }
323
- } else {
324
- // Run normal CLI mode
325
- const { CLI } = await import('../dist/src/index.js');
326
- const cli = new CLI();
327
- cli.run()
328
- .then(() => {
329
- // #1552: Exit cleanly after one-shot commands.
330
- // Long-running commands (daemon foreground, mcp, status --watch) never resolve,
331
- // so this only fires for normal CLI commands.
332
- process.exit(0);
333
- })
334
- .catch((error) => {
335
- console.error('Fatal error:', error.message);
336
- process.exit(1);
337
- });
338
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * @claude-flow/cli - CLI Entry Point
4
+ *
5
+ * Claude Flow V3 Command Line Interface
6
+ *
7
+ * Auto-detects MCP mode when stdin is piped and no args provided.
8
+ * This allows: echo '{"jsonrpc":"2.0",...}' | npx @claude-flow/cli
9
+ */
10
+
11
+ import { randomUUID } from 'crypto';
12
+ import { readFileSync } from 'fs';
13
+ import { fileURLToPath } from 'url';
14
+ import { dirname, join } from 'path';
15
+
16
+ // #2253 / #2256: Console filter installed BEFORE any other import. Two jobs:
17
+ //
18
+ // 1. Suppress the cosmetic "[AgentDB Patch] Controller index not found"
19
+ // warning from agentic-flow (it expects agentdb v1.x but we use v3).
20
+ // Tight match — must include BOTH the prefix AND the specific text;
21
+ // other [AgentDB Patch] messages flow through. Audit log
22
+ // audit_1776483149979 flagged a broader filter as too aggressive.
23
+ //
24
+ // 2. Redirect noisy stdout writes from upstream embedder libraries
25
+ // (ruvector ONNX loader, ruvector-onnx-embeddings-wasm parallel
26
+ // embedder) to stderr. Those libraries use console.log for progress
27
+ // messages — "Loading model:", " Downloading: …", "🚀 Initializing N
28
+ // workers" — which corrupts MCP JSON-RPC stdio (#2253) and is noise
29
+ // on stdout. stderr is the right channel for progress to a TTY user,
30
+ // and the MCP stdio framer reads stdout only.
31
+ //
32
+ // This MUST be installed before `import('../dist/src/index.js')` so the
33
+ // patch is in place before agentic-flow / ruvector load transitively.
34
+ const _origWarn = console.warn;
35
+ const _origLog = console.log;
36
+ const _origError = console.error;
37
+
38
+ // #2726 — Some MCP clients place every advertised schema in every model
39
+ // request. Keep "all" as the backwards-compatible default, but honor the
40
+ // same category/namespace/exact-name selector as `mcp start --tools`.
41
+ function _filterAdvertisedMcpTools(tools) {
42
+ const argv = process.argv.slice(2);
43
+ const toolsIndex = argv.findIndex((arg) => arg === '--tools');
44
+ const inlineTools = argv.find((arg) => arg.startsWith('--tools='));
45
+ const configured = process.env.CLAUDE_FLOW_MCP_TOOLS
46
+ || (toolsIndex >= 0 ? argv[toolsIndex + 1] : undefined)
47
+ || (inlineTools ? inlineTools.slice('--tools='.length) : undefined);
48
+ if (!configured || configured.trim().toLowerCase() === 'all') return tools;
49
+ const selectors = new Set(
50
+ configured.split(',').map((item) => item.trim().toLowerCase()).filter(Boolean),
51
+ );
52
+ if (selectors.size === 0) return tools;
53
+ return tools.filter((tool) => {
54
+ const name = tool.name.toLowerCase();
55
+ const category = typeof tool.category === 'string' ? tool.category.toLowerCase() : '';
56
+ return selectors.has(name)
57
+ || selectors.has(category)
58
+ || Array.from(selectors).some((selector) => name.startsWith(`${selector}_`));
59
+ });
60
+ }
61
+ const _isCosmeticAgentdbPatchNoise = (msg) =>
62
+ msg.includes('[AgentDB Patch]') && msg.includes('Controller index not found');
63
+ const _STDERR_REDIRECT_PREFIXES = [
64
+ 'Loading model: ',
65
+ ' Downloading: ',
66
+ ' Cache hit: ',
67
+ ' Disk cache hit: ',
68
+ 'Model cache cleared',
69
+ '🚀 Initializing ',
70
+ '✅ ',
71
+ ];
72
+ // agentdb's EmbeddingService.initialize() prints this cluster when
73
+ // `@xenova/transformers` fails to load (commonly: macOS arm64 without
74
+ // `brew install vips` — sharp can't resolve libvips). The warnings claim
75
+ // agentdb is "falling back to mock embeddings", but memory-bridge.ts's
76
+ // rescueAgentdbEmbedder swaps the embedder over to ruvector ONNX in
77
+ // that exact case, so the user is NOT on mocks. The warnings are stale
78
+ // and misleading; drop them. Match anchored to exact upstream prefixes
79
+ // (agentdb/dist/controllers/EmbeddingService.js:48–56) so unrelated
80
+ // warnings always flow through.
81
+ const _AGENTDB_MOCK_FALLBACK_DROP_PREFIXES = [
82
+ 'Transformers.js initialization failed:',
83
+ ' Falling back to mock embeddings for testing',
84
+ ' This is normal if:',
85
+ ' - Running offline/without internet access',
86
+ ' - Model not yet downloaded',
87
+ ' - Network connectivity issues',
88
+ ' To use real embeddings:',
89
+ ' - Ensure internet connectivity for first',
90
+ ' - Or pre-download: npx agentdb',
91
+ ];
92
+ const _shouldRedirectToStderr = (msg) => {
93
+ for (const prefix of _STDERR_REDIRECT_PREFIXES) {
94
+ if (msg.startsWith(prefix)) return true;
95
+ }
96
+ return false;
97
+ };
98
+ const _isAgentdbMockFallbackNoise = (msg) => {
99
+ for (const prefix of _AGENTDB_MOCK_FALLBACK_DROP_PREFIXES) {
100
+ if (msg.startsWith(prefix)) return true;
101
+ }
102
+ return false;
103
+ };
104
+ console.warn = (...args) => {
105
+ const head = String(args[0] ?? '');
106
+ if (_isCosmeticAgentdbPatchNoise(head)) return;
107
+ if (_isAgentdbMockFallbackNoise(head)) return;
108
+ _origWarn.apply(console, args);
109
+ };
110
+ console.log = (...args) => {
111
+ const head = String(args[0] ?? '');
112
+ if (_isCosmeticAgentdbPatchNoise(head)) return;
113
+ if (_shouldRedirectToStderr(head)) {
114
+ _origError.apply(console, args);
115
+ return;
116
+ }
117
+ _origLog.apply(console, args);
118
+ };
119
+
120
+ // #2256 fast path: --version / -V / --help / -h must NOT trigger heavy
121
+ // imports (agentic-flow, ruvector ONNX, etc.) — those eagerly download a
122
+ // 23 MB ONNX model on cold cache, blocking 60+ s and causing SIGTERM
123
+ // under common timeout windows (npx default, MCP stdio 30 s). Resolve
124
+ // version directly from package.json and exit before any heavy import.
125
+ {
126
+ const _argv = process.argv.slice(2);
127
+ if (_argv.length === 1 && (_argv[0] === '--version' || _argv[0] === '-V')) {
128
+ try {
129
+ const __dirname = dirname(fileURLToPath(import.meta.url));
130
+ const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
131
+ process.stdout.write(`ruflo v${pkg.version || '0.0.0'}\n`);
132
+ } catch {
133
+ process.stdout.write('ruflo v0.0.0\n');
134
+ }
135
+ process.exit(0);
136
+ }
137
+ // --help / -h with no other args also stays lightweight — fall through
138
+ // to the existing fast help path inside index.ts; we don't short-circuit
139
+ // here because some users pass `<command> --help` which needs lazy command
140
+ // loading. The version short-circuit is the only one safe to inline.
141
+ }
142
+
143
+ // Check if we should run in MCP server mode
144
+ // Conditions:
145
+ // 1. stdin is being piped AND no CLI arguments provided (auto-detect)
146
+ // 2. stdin is being piped AND args are "mcp start" (explicit, e.g. npx claude-flow@alpha mcp start)
147
+ // 3. EXCEPT — if the user explicitly passed --transport <non-stdio>
148
+ // (e.g. -t http), defer to the parser. Without this, every smoke
149
+ // test or non-TTY caller of `mcp start -t http` got force-routed
150
+ // into stdio mode and never hit the HTTP server (#1874 follow-up).
151
+ const cliArgs = process.argv.slice(2);
152
+ const isExplicitMCP = cliArgs.length >= 1 && cliArgs[0] === 'mcp' && (cliArgs.length === 1 || cliArgs[1] === 'start');
153
+ const explicitNonStdioTransport = cliArgs.some((a, i) => {
154
+ // -t <value> | --transport <value>
155
+ if ((a === '-t' || a === '--transport') && cliArgs[i + 1] && cliArgs[i + 1] !== 'stdio') return true;
156
+ // --transport=<value>
157
+ if (/^--transport=/.test(a) && !/^--transport=stdio$/.test(a)) return true;
158
+ return false;
159
+ });
160
+ const isMCPMode = !process.stdin.isTTY
161
+ && !explicitNonStdioTransport
162
+ && (process.argv.length === 2 || isExplicitMCP);
163
+
164
+ if (isMCPMode) {
165
+ // Run MCP server mode
166
+ const { listMCPTools, callMCPTool, hasTool } = await import('../dist/src/mcp-client.js');
167
+
168
+ const VERSION = '3.0.0';
169
+ const sessionId = `mcp-${Date.now()}-${randomUUID().slice(0, 8)}`;
170
+
171
+ console.error(
172
+ `[${new Date().toISOString()}] INFO [claude-flow-mcp] (${sessionId}) Starting in stdio mode`
173
+ );
174
+
175
+ // Audit-flagged DoS protection (audit_1776483149979): cap the
176
+ // newline-buffered stdin parser so a malicious client cannot pipe
177
+ // gigabytes of un-newlined data and exhaust memory before
178
+ // JSON.parse runs. 10MB is far above any legitimate MCP message
179
+ // (the protocol's largest realistic payloads — tool descriptions,
180
+ // batch search results — top out at ~1MB).
181
+ const MCP_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
182
+ let buffer = '';
183
+ process.stdin.setEncoding('utf8');
184
+ process.stdin.on('data', async (chunk) => {
185
+ buffer += chunk;
186
+ if (buffer.length > MCP_MAX_BUFFER_BYTES) {
187
+ // Drop the buffer + emit a protocol-level error so the client
188
+ // sees the rejection rather than a silent OOM.
189
+ console.log(JSON.stringify({
190
+ jsonrpc: '2.0',
191
+ id: null,
192
+ error: {
193
+ code: -32700,
194
+ message: `Buffered stdin exceeds ${MCP_MAX_BUFFER_BYTES} bytes without newline; resetting`,
195
+ },
196
+ }));
197
+ buffer = '';
198
+ return;
199
+ }
200
+ let lines = buffer.split('\n');
201
+ buffer = lines.pop() || '';
202
+
203
+ for (const line of lines) {
204
+ if (line.trim()) {
205
+ let message;
206
+ try {
207
+ message = JSON.parse(line);
208
+ } catch {
209
+ console.log(JSON.stringify({
210
+ jsonrpc: '2.0',
211
+ id: null,
212
+ error: { code: -32700, message: 'Parse error' },
213
+ }));
214
+ continue;
215
+ }
216
+ try {
217
+ const response = await handleMessage(message);
218
+ if (response) {
219
+ console.log(JSON.stringify(response));
220
+ }
221
+ } catch (error) {
222
+ // #1606: Return proper internal error instead of parse error
223
+ console.log(JSON.stringify({
224
+ jsonrpc: '2.0',
225
+ id: message.id ?? null,
226
+ error: { code: -32603, message: error instanceof Error ? error.message : 'Internal error' },
227
+ }));
228
+ }
229
+ }
230
+ }
231
+ });
232
+
233
+ process.stdin.on('end', () => {
234
+ process.exit(0);
235
+ });
236
+
237
+ async function handleMessage(message) {
238
+ if (!message.method) {
239
+ return {
240
+ jsonrpc: '2.0',
241
+ id: message.id,
242
+ error: { code: -32600, message: 'Invalid Request: missing method' },
243
+ };
244
+ }
245
+
246
+ const params = message.params || {};
247
+
248
+ switch (message.method) {
249
+ case 'initialize':
250
+ return {
251
+ jsonrpc: '2.0',
252
+ id: message.id,
253
+ result: {
254
+ protocolVersion: '2024-11-05',
255
+ serverInfo: { name: 'ruflo', version: VERSION },
256
+ capabilities: {
257
+ tools: { listChanged: true },
258
+ resources: { subscribe: true, listChanged: true },
259
+ },
260
+ },
261
+ };
262
+
263
+ case 'tools/list': {
264
+ const tools = _filterAdvertisedMcpTools(listMCPTools());
265
+ return {
266
+ jsonrpc: '2.0',
267
+ id: message.id,
268
+ result: {
269
+ tools: tools.map(tool => ({
270
+ name: tool.name,
271
+ description: tool.description,
272
+ inputSchema: tool.inputSchema,
273
+ })),
274
+ },
275
+ };
276
+ }
277
+
278
+ case 'tools/call': {
279
+ const toolName = params.name;
280
+ const toolParams = params.arguments || {};
281
+
282
+ if (!hasTool(toolName)) {
283
+ return {
284
+ jsonrpc: '2.0',
285
+ id: message.id,
286
+ error: { code: -32601, message: `Tool not found: ${toolName}` },
287
+ };
288
+ }
289
+
290
+ try {
291
+ const result = await callMCPTool(toolName, toolParams, { sessionId });
292
+ return {
293
+ jsonrpc: '2.0',
294
+ id: message.id,
295
+ result: { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] },
296
+ };
297
+ } catch (error) {
298
+ return {
299
+ jsonrpc: '2.0',
300
+ id: message.id,
301
+ error: {
302
+ code: -32603,
303
+ message: error instanceof Error ? error.message : 'Tool execution failed',
304
+ },
305
+ };
306
+ }
307
+ }
308
+
309
+ case 'notifications/initialized':
310
+ return null;
311
+
312
+ case 'ping':
313
+ return { jsonrpc: '2.0', id: message.id, result: {} };
314
+
315
+ default:
316
+ return {
317
+ jsonrpc: '2.0',
318
+ id: message.id,
319
+ error: { code: -32601, message: `Method not found: ${message.method}` },
320
+ };
321
+ }
322
+ }
323
+ } else {
324
+ // Run normal CLI mode
325
+ const { CLI } = await import('../dist/src/index.js');
326
+ const cli = new CLI();
327
+ cli.run()
328
+ .then(() => {
329
+ // #1552: Exit cleanly after one-shot commands.
330
+ // Long-running commands (daemon foreground, mcp, status --watch) never resolve,
331
+ // so this only fires for normal CLI commands.
332
+ process.exit(0);
333
+ })
334
+ .catch((error) => {
335
+ console.error('Fatal error:', error.message);
336
+ process.exit(1);
337
+ });
338
+ }