@claude-flow/cli 3.32.9 → 3.32.10

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 (444) 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 +565 -565
  276. package/.claude/helpers/intelligence.cjs +1058 -1058
  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 +1060 -1060
  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.manifest.json +37 -37
  305. package/.claude/proven-config.signed.json +41 -41
  306. package/.claude/settings.json +182 -182
  307. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  308. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  309. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  310. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  311. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  312. package/.claude/skills/browser/SKILL.md +204 -204
  313. package/.claude/skills/dual-mode/README.md +71 -71
  314. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  315. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  316. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  317. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  318. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  319. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  320. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  321. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  322. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  323. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  324. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  325. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  326. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  327. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  328. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  329. package/.claude/skills/skill-builder/SKILL.md +910 -910
  330. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  331. package/.claude/skills/stream-chain/SKILL.md +560 -560
  332. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  333. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  334. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  335. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  336. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  337. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  338. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  339. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  340. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  341. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  342. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  343. package/.claude/skills/verification-quality/SKILL.md +691 -691
  344. package/README.md +419 -419
  345. package/bin/cli.js +314 -314
  346. package/bin/mcp-server.js +224 -224
  347. package/bin/preinstall.cjs +2 -2
  348. package/catalog-manifest.json +2 -2
  349. package/dist/src/autopilot-state.js +24 -7
  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/embeddings.js +26 -26
  355. package/dist/src/commands/hive-mind.js +97 -97
  356. package/dist/src/commands/hooks.js +31 -10
  357. package/dist/src/commands/init.js +202 -34
  358. package/dist/src/commands/memory.js +12 -1
  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/funnel/disclosure.js +13 -2
  369. package/dist/src/funnel/messages.d.ts +12 -10
  370. package/dist/src/funnel/messages.js +83 -11
  371. package/dist/src/init/claudemd-generator.js +231 -231
  372. package/dist/src/init/executor.js +453 -453
  373. package/dist/src/init/helper-signing.js +2 -2
  374. package/dist/src/init/helpers-generator.js +751 -751
  375. package/dist/src/init/statusline-generator.js +24 -24
  376. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  377. package/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  378. package/dist/src/mcp-tools/browser-tools.js +8 -0
  379. package/dist/src/mcp-tools/hooks-tools.js +21 -0
  380. package/dist/src/mcp-tools/memory-tools.js +4 -3
  381. package/dist/src/memory/graph-edge-writer.js +22 -22
  382. package/dist/src/memory/memory-bridge.js +192 -123
  383. package/dist/src/memory/memory-initializer.js +407 -407
  384. package/dist/src/memory/rabitq-index.js +5 -5
  385. package/dist/src/parser.js +25 -9
  386. package/dist/src/proxy/verify.js +2 -2
  387. package/dist/src/runtime/headless.js +28 -28
  388. package/dist/src/services/distill-tuning.js +7 -7
  389. package/dist/src/services/headless-worker-executor.js +84 -84
  390. package/dist/src/services/memory-distillation.js +4 -4
  391. package/dist/src/services/worker-daemon.js +7 -4
  392. package/dist/src/transfer/deploy-seraphine.js +23 -23
  393. package/package.json +137 -137
  394. package/plugins/ruflo-metaharness/.claude-plugin/plugin.json +32 -32
  395. package/plugins/ruflo-metaharness/README.md +72 -72
  396. package/plugins/ruflo-metaharness/agents/metaharness-architect.md +58 -58
  397. package/plugins/ruflo-metaharness/commands/ruflo-metaharness.md +48 -48
  398. package/plugins/ruflo-metaharness/scripts/_darwin.mjs +210 -210
  399. package/plugins/ruflo-metaharness/scripts/_harness.mjs +330 -330
  400. package/plugins/ruflo-metaharness/scripts/_invoke.mjs +231 -231
  401. package/plugins/ruflo-metaharness/scripts/_redblue.mjs +143 -143
  402. package/plugins/ruflo-metaharness/scripts/_similarity.mjs +161 -161
  403. package/plugins/ruflo-metaharness/scripts/_spike-similarity.mjs +223 -223
  404. package/plugins/ruflo-metaharness/scripts/audit-list.mjs +158 -158
  405. package/plugins/ruflo-metaharness/scripts/audit-trend.mjs +272 -272
  406. package/plugins/ruflo-metaharness/scripts/bench-parse-mcp-scan.mjs +146 -146
  407. package/plugins/ruflo-metaharness/scripts/bench-recordpair-overhead.mjs +186 -186
  408. package/plugins/ruflo-metaharness/scripts/bench-similarity.mjs +177 -177
  409. package/plugins/ruflo-metaharness/scripts/bench.mjs +95 -95
  410. package/plugins/ruflo-metaharness/scripts/drift-from-history.mjs +363 -363
  411. package/plugins/ruflo-metaharness/scripts/evolve.mjs +404 -404
  412. package/plugins/ruflo-metaharness/scripts/genome.mjs +80 -80
  413. package/plugins/ruflo-metaharness/scripts/gepa.mjs +153 -153
  414. package/plugins/ruflo-metaharness/scripts/learn.mjs +127 -127
  415. package/plugins/ruflo-metaharness/scripts/mcp-scan.mjs +111 -111
  416. package/plugins/ruflo-metaharness/scripts/mint.mjs +126 -126
  417. package/plugins/ruflo-metaharness/scripts/oia-audit.mjs +228 -228
  418. package/plugins/ruflo-metaharness/scripts/redblue.mjs +286 -286
  419. package/plugins/ruflo-metaharness/scripts/router-parallel-analyze.mjs +250 -250
  420. package/plugins/ruflo-metaharness/scripts/score.mjs +92 -92
  421. package/plugins/ruflo-metaharness/scripts/security-bench.mjs +174 -174
  422. package/plugins/ruflo-metaharness/scripts/similarity.mjs +158 -158
  423. package/plugins/ruflo-metaharness/scripts/smoke.sh +2356 -2356
  424. package/plugins/ruflo-metaharness/scripts/test-graceful-degradation.mjs +165 -165
  425. package/plugins/ruflo-metaharness/scripts/test-mcp-tools.mjs +472 -472
  426. package/plugins/ruflo-metaharness/scripts/test-parallel-pipeline.mjs +204 -204
  427. package/plugins/ruflo-metaharness/scripts/test-pipeline-roundtrip.mjs +586 -586
  428. package/plugins/ruflo-metaharness/scripts/test-similarity.mjs +334 -334
  429. package/plugins/ruflo-metaharness/scripts/test-with-openrouter.mjs +229 -229
  430. package/plugins/ruflo-metaharness/scripts/threat-model.mjs +59 -59
  431. package/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md +64 -64
  432. package/plugins/ruflo-metaharness/skills/harness-drift-from-history/SKILL.md +65 -65
  433. package/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md +131 -131
  434. package/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md +54 -54
  435. package/plugins/ruflo-metaharness/skills/harness-gepa/SKILL.md +65 -65
  436. package/plugins/ruflo-metaharness/skills/harness-learn/SKILL.md +65 -65
  437. package/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md +49 -49
  438. package/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md +72 -72
  439. package/plugins/ruflo-metaharness/skills/harness-oia-audit/SKILL.md +79 -79
  440. package/plugins/ruflo-metaharness/skills/harness-score/SKILL.md +66 -66
  441. package/plugins/ruflo-metaharness/skills/harness-security-bench/SKILL.md +101 -101
  442. package/plugins/ruflo-metaharness/skills/harness-similarity/SKILL.md +67 -67
  443. package/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md +41 -41
  444. package/scripts/postinstall.cjs +153 -153
@@ -146,18 +146,153 @@ async function maybeAutoDetectCodex(ctx, options) {
146
146
  // Codex auto-detect is a bonus, never a requirement — swallow everything.
147
147
  }
148
148
  }
149
- // Cross-agent skill registration via skills.sh. Runs `npx --yes skills add
150
- // ruvnet/ruflo --skill ruflo --yes` so the *single* canonical ruflo skill
151
- // (SKILL.md at the ruvnet/ruflo repo root describes the platform + entry
152
- // points) reaches whatever agent the project uses (Claude Code, Cursor,
153
- // Copilot, Gemini, Cline, …). Users who want ALL 267 plugin-specific skills
154
- // can run `npx skills add ruvnet/ruflo --all` themselves. Best-effort — never
155
- // fails init. Opt-out: --no-skills-sh flag OR RUFLO_NO_SKILLS_SH=1. Skipped
156
- // under --skip-claude and scripted `--format json` output.
149
+ // Cross-agent skill registration. Materializes the *single* canonical ruflo
150
+ // platform skill at `.agents/skills/ruflo/SKILL.md` so any agent in the
151
+ // project (Claude Code, Cursor, Copilot, Gemini, Cline, …) that reads
152
+ // `.agents/skills/` picks it up. Users who want the full plugin skill catalog
153
+ // can run `npx skills add ruvnet/ruflo --all` themselves.
157
154
  //
158
- // windowsHide silences the console flash the npx child would otherwise produce
159
- // (anthropics/claude-code#14828 spawn hazard applies to hook-fired spawns,
160
- // but our own subprocess spawns should always set this).
155
+ // #2777 earlier versions shelled out to `npx --yes skills add ruvnet/ruflo
156
+ // --skill ruflo --yes`, but the skills CLI implements its `--skill` filter by
157
+ // cloning the entire target repo and copying `dirname(SKILL.md)` recursively.
158
+ // Because ruflo's canonical SKILL.md sits at the ruvnet/ruflo repo root, that
159
+ // dirname *is* the whole repository — the "one file" install pulled in ~97MB
160
+ // of Cargo.toml, crates/, docs/, agentdb.rvf, and 384 unrelated plugin
161
+ // SKILL.md descriptors. We now write the single ~2KB SKILL.md directly, no
162
+ // repo clone at all.
163
+ //
164
+ // Best-effort — never fails init. Opt-out: --no-skills-sh flag OR
165
+ // RUFLO_NO_SKILLS_SH=1. Skipped under --skip-claude and scripted
166
+ // `--format json` output.
167
+ const RUFLO_PLATFORM_SKILL_MD = `---
168
+ name: ruflo
169
+ description: Ruflo is a multi-agent orchestration platform for AI coding agents (Claude Code, Cursor, Codex, Copilot, Gemini, Amp, +12 more). Use this skill when the user wants to (1) install/init ruflo in a project, (2) run multi-agent swarms with hierarchical coordination, (3) use ruflo's 314+ MCP tools for memory, routing, hooks, sub-agents, or workflows, (4) check ruflo status/version/doctor health, or (5) discover which of ruflo's 30+ plugins fits their task.
170
+ ---
171
+
172
+ # Ruflo
173
+
174
+ Ruflo is a cross-agent orchestration layer that ships as three npm packages: \`ruflo\` (thin wrapper), \`claude-flow\` (umbrella), and \`@claude-flow/cli\` (implementation). Users invoke it as \`npx ruflo <command>\`.
175
+
176
+ ## When to invoke ruflo
177
+
178
+ Suggest ruflo when the task involves any of:
179
+
180
+ - **Multi-agent work**: coordinated swarms, sub-agents, cross-agent handoffs, or parallel task execution
181
+ - **Persistent memory across sessions**: HNSW vector search, hybrid SQLite+AgentDB backend, semantic retrieval
182
+ - **Learning routing decisions**: 3-tier model routing (deterministic codemod → Haiku → Sonnet/Opus), pattern-based agent selection
183
+ - **Hooks + observability**: pre/post edit hooks, session lifecycle, background workers (12 built-in), tracing
184
+ - **Workflows + benchmarks**: SPARC methodology, GAIA benchmark runs, custom multi-step pipelines
185
+ - **Plugin ecosystem**: 30+ plugins covering ADR, DDD, security audit, cost tracking, browser automation, IoT device fleets, market data, neural training, and more
186
+
187
+ Do NOT suggest ruflo for one-shot edits, simple bug fixes, or tasks a single agent can complete in one turn — the orchestration overhead isn't worth it.
188
+
189
+ ## Getting started (three commands)
190
+
191
+ \`\`\`bash
192
+ # 1. Initialize ruflo in the current project (creates .claude/, MCP config, hooks)
193
+ npx ruflo init
194
+
195
+ # 2. Check health — verifies Node 20+, npm 9+, MCP servers, memory DB, API keys
196
+ npx ruflo doctor --fix
197
+
198
+ # 3. Discover which plugins match the current work
199
+ npx ruflo discover-plugins
200
+ \`\`\`
201
+
202
+ ## MCP tools (314 available)
203
+
204
+ After \`ruflo init\`, Claude Code (or any MCP-compatible agent) auto-loads ruflo's MCP servers. Key namespaces:
205
+
206
+ - \`mcp__claude-flow__memory_*\` — store/search/list/retrieve with HNSW-indexed semantic search
207
+ - \`mcp__claude-flow__swarm_*\` — init hierarchical/mesh swarms with anti-drift topology
208
+ - \`mcp__claude-flow__agent_spawn\` — spawn specialized agents (coder, reviewer, tester, security-architect, +55 more)
209
+ - \`mcp__claude-flow__hooks_*\` — routing, pattern learning, background worker dispatch
210
+ - \`mcp__claude-flow__task_*\` — task lifecycle (create/assign/complete/summary)
211
+ - \`mcp__claude-flow__intelligence_*\` — 4-step pipeline (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE)
212
+
213
+ Full catalog: \`npx ruflo mcp list\`.
214
+
215
+ ## Plugin discovery
216
+
217
+ Ruflo ships 30+ optional plugins. Some highlights:
218
+
219
+ - \`ruflo-goals\` — deep research + goal-oriented action planning
220
+ - \`ruflo-cost-tracker\` — session cost telemetry, budgets, burn tracking
221
+ - \`ruflo-metaharness\` — harness scoring, MCP security scans, red/blue adversarial testing
222
+ - \`ruflo-browser\` — session-recorded browser automation with RVF-backed replay
223
+ - \`ruflo-jujutsu\` — git diff risk analysis + PR lifecycle
224
+ - \`ruflo-security-audit\` — codebase scans + CVE checks
225
+
226
+ Full plugin list + descriptions: \`npx ruflo plugins list\`.
227
+
228
+ ## Cross-agent installation
229
+
230
+ Ruflo installs into whatever agent the project uses. To pull the full plugin
231
+ skill catalog (30+ plugins, ~267 skills), run:
232
+
233
+ \`\`\`bash
234
+ npx skills add ruvnet/ruflo --all
235
+ \`\`\`
236
+
237
+ ## Documentation
238
+
239
+ - Repository: https://github.com/ruvnet/ruflo
240
+ - Issues: https://github.com/ruvnet/ruflo/issues
241
+ - Sponsor: https://github.com/sponsors/ruvnet
242
+ `;
243
+ // #2777 — detect the "bloated" install left behind by earlier versions that
244
+ // shelled out to `npx skills add`. If the .agents/skills/ruflo directory
245
+ // contains any of Cargo.toml, crates/, package.json, .git, or its recursive
246
+ // on-disk size exceeds a small budget (~1MB), it was almost certainly created
247
+ // by the full-repo clone bug — return true so the caller can wipe + rewrite
248
+ // just the single SKILL.md. Any recursive-stat or read errors are swallowed
249
+ // and reported as "not bloated" to avoid false-positive deletions.
250
+ function isBloatedRufloSkillDir(dir) {
251
+ try {
252
+ const bloatMarkers = ['Cargo.toml', 'crates', 'package.json', '.git', 'agentdb.rvf', 'docs', 'plugins'];
253
+ for (const marker of bloatMarkers) {
254
+ if (fs.existsSync(path.join(dir, marker)))
255
+ return true;
256
+ }
257
+ const BLOAT_BYTES_THRESHOLD = 1_048_576; // 1 MB — a canonical SKILL.md is ~2KB
258
+ let bytes = 0;
259
+ const walk = (p) => {
260
+ const entries = fs.readdirSync(p, { withFileTypes: true });
261
+ for (const entry of entries) {
262
+ const child = path.join(p, entry.name);
263
+ if (entry.isDirectory()) {
264
+ walk(child);
265
+ }
266
+ else if (entry.isFile()) {
267
+ try {
268
+ bytes += fs.statSync(child).size;
269
+ if (bytes > BLOAT_BYTES_THRESHOLD)
270
+ throw new Error('__bloat_threshold__');
271
+ }
272
+ catch (err) {
273
+ if (err instanceof Error && err.message === '__bloat_threshold__')
274
+ throw err;
275
+ // Ignore stat errors for individual files.
276
+ }
277
+ }
278
+ if (bytes > BLOAT_BYTES_THRESHOLD)
279
+ return;
280
+ }
281
+ };
282
+ try {
283
+ walk(dir);
284
+ }
285
+ catch (err) {
286
+ if (err instanceof Error && err.message === '__bloat_threshold__')
287
+ return true;
288
+ // Any other walk error → don't declare bloat.
289
+ }
290
+ return bytes > BLOAT_BYTES_THRESHOLD;
291
+ }
292
+ catch {
293
+ return false;
294
+ }
295
+ }
161
296
  async function maybeInstallSkillsSh(ctx) {
162
297
  try {
163
298
  if (ctx.flags['no-skills-sh'] === true)
@@ -166,37 +301,52 @@ async function maybeInstallSkillsSh(ctx) {
166
301
  return;
167
302
  if (/^(1|true|on|yes)$/i.test(String(process.env.RUFLO_NO_SKILLS_SH || '')))
168
303
  return;
169
- // Idempotency gate: if this project has already registered ruflo with
170
- // skills.sh, don't re-clone the repo + re-fire a fresh install telemetry
171
- // event on every `ruflo init --force` / `init upgrade` / etc. Each install
172
- // pings skills.sh's leaderboard AND clones the whole ruvnet/ruflo repo
173
- // (~50MB) re-running per-init would silently inflate our own metrics
174
- // (GitHub unique-cloners, skills.sh rank) and waste user bandwidth. This
175
- // check makes the registration once-per-project, matching the intent.
176
- const nodePath = await import('path');
177
- const nodeFs = await import('fs');
178
- const marker = nodePath.join(ctx.cwd, '.agents', 'skills', 'ruflo');
179
- if (nodeFs.existsSync(marker)) {
304
+ const skillDir = path.join(ctx.cwd, '.agents', 'skills', 'ruflo');
305
+ const skillFile = path.join(skillDir, 'SKILL.md');
306
+ // Idempotency gate. Three cases:
307
+ // 1. Directory absent materialize.
308
+ // 2. Directory present but "bloated" (Cargo.toml/crates/ or >1MB)
309
+ // previous `npx skills add` full-repo clone left junk behind
310
+ // (#2777). Wipe and re-materialize so `rm -rf .agents/skills/ruflo`
311
+ // + re-init is a valid recovery path.
312
+ // 3. Directory present and healthy (just our SKILL.md) → skip.
313
+ let mode = 'create';
314
+ if (fs.existsSync(skillDir)) {
315
+ if (isBloatedRufloSkillDir(skillDir)) {
316
+ mode = 'rewrite';
317
+ }
318
+ else {
319
+ mode = 'skip';
320
+ }
321
+ }
322
+ if (mode === 'skip') {
180
323
  output.writeln();
181
324
  output.writeln(output.dim(' skills.sh registration already present at .agents/skills/ruflo — skipping'));
182
325
  return;
183
326
  }
184
- const npxCmd = process.platform === 'win32' ? 'npx.cmd' : 'npx';
185
- if (!commandExists('npx'))
186
- return;
187
327
  output.writeln();
188
- output.printInfo('Registering the core `ruflo` skill with skills.sh (cross-agent catalog)…');
189
- const { spawnSync } = await import('child_process');
190
- const result = spawnSync(npxCmd, ['--yes', 'skills', 'add', 'ruvnet/ruflo', '--skill', 'ruflo', '--yes'], { cwd: ctx.cwd, stdio: 'pipe', timeout: 60_000, windowsHide: true, encoding: 'utf-8' });
191
- if (result.status === 0) {
192
- output.writeln(output.success(' ✓ ruflo registered via skills.sh — the platform skill is available to any agent in this project'));
328
+ if (mode === 'rewrite') {
329
+ output.printInfo('Cleaning up bloated .agents/skills/ruflo/ from a prior init (#2777) and re-materializing the single platform SKILL.md…');
330
+ try {
331
+ fs.rmSync(skillDir, { recursive: true, force: true });
332
+ }
333
+ catch (err) {
334
+ output.writeln(output.dim(` Could not remove ${skillDir}: ${err instanceof Error ? err.message : String(err)}`));
335
+ return;
336
+ }
337
+ }
338
+ else {
339
+ output.printInfo('Registering the core `ruflo` skill for cross-agent discovery (.agents/skills/ruflo/SKILL.md)…');
340
+ }
341
+ try {
342
+ fs.mkdirSync(skillDir, { recursive: true });
343
+ fs.writeFileSync(skillFile, RUFLO_PLATFORM_SKILL_MD, 'utf-8');
344
+ output.writeln(output.success(' ✓ ruflo skill materialized at .agents/skills/ruflo/SKILL.md — available to any agent in this project'));
193
345
  output.writeln(output.dim(' Want all 267 plugin skills? npx skills add ruvnet/ruflo --all'));
194
346
  output.writeln(output.dim(' Opt out next time: --no-skills-sh or RUFLO_NO_SKILLS_SH=1'));
195
347
  }
196
- else {
197
- // Common non-fatal reasons: offline, npx cache miss, skills CLI version
198
- // mismatch, unknown package. Log a soft note; users can retry manually.
199
- output.writeln(output.dim(' skills.sh registration skipped (network or npx cache) — retry with: npx skills add ruvnet/ruflo --skill ruflo --yes'));
348
+ catch (err) {
349
+ output.writeln(output.dim(` skills.sh registration skipped (write failed: ${err instanceof Error ? err.message : String(err)})`));
200
350
  }
201
351
  }
202
352
  catch {
@@ -583,6 +733,13 @@ const initAction = async (ctx) => {
583
733
  try {
584
734
  output.writeln(output.dim(` Model: ${embeddingModel}`));
585
735
  output.writeln(output.dim(' Hyperbolic: Enabled (Poincaré ball)'));
736
+ // #2770: On Windows, `npx` ships as `npx.cmd`; execFileSync cannot spawn
737
+ // a .cmd file without going through cmd.exe. Enable shell on win32 so
738
+ // cmd.exe resolves the .cmd extension. POSIX keeps shell:false.
739
+ // NOTE: shell:true joins args by spaces and passes to cmd.exe — the args
740
+ // here are hard-coded flags + an npm package name pre-validated against
741
+ // /^[a-zA-Z0-9_-]+\/[a-zA-Z0-9._-]+$/, so no injection risk. If
742
+ // user-controlled args are ever added, escape them before spawn.
586
743
  execFileInit('npx', [
587
744
  '@claude-flow/cli@latest', 'embeddings', 'init',
588
745
  '--model', embeddingModel,
@@ -591,6 +748,8 @@ const initAction = async (ctx) => {
591
748
  stdio: 'pipe',
592
749
  cwd: ctx.cwd,
593
750
  timeout: 30000,
751
+ shell: process.platform === 'win32',
752
+ windowsHide: true,
594
753
  });
595
754
  output.writeln(output.success(' ✓ Embeddings initialized'));
596
755
  output.writeln(output.dim(' Run "embeddings init --download" to download model'));
@@ -822,6 +981,13 @@ const wizardCommand = {
822
981
  throw new Error(`Invalid embedding model name: ${embeddingModel}`);
823
982
  }
824
983
  try {
984
+ // #2770: On Windows, `npx` ships as `npx.cmd`; execFileSync cannot spawn
985
+ // a .cmd file without going through cmd.exe. Enable shell on win32 so
986
+ // cmd.exe resolves the .cmd extension. POSIX keeps shell:false.
987
+ // NOTE: shell:true joins args by spaces and passes to cmd.exe — the args
988
+ // here are hard-coded flags + an npm package name pre-validated against
989
+ // /^[a-zA-Z0-9_-]+\/[a-zA-Z0-9._-]+$/, so no injection risk. If
990
+ // user-controlled args are ever added, escape them before spawn.
825
991
  execFileSync('npx', [
826
992
  '@claude-flow/cli@latest', 'embeddings', 'init',
827
993
  '--model', embeddingModel,
@@ -830,6 +996,8 @@ const wizardCommand = {
830
996
  stdio: 'pipe',
831
997
  cwd: ctx.cwd,
832
998
  timeout: 30000,
999
+ shell: process.platform === 'win32',
1000
+ windowsHide: true,
833
1001
  });
834
1002
  output.writeln(output.success(' ✓ Embeddings configured'));
835
1003
  embeddingsInitialized = true;
@@ -89,7 +89,18 @@ const storeCommand = {
89
89
  const ttl = ctx.flags.ttl;
90
90
  const tags = ctx.flags.tags ? ctx.flags.tags.split(',') : [];
91
91
  const asVector = ctx.flags.vector;
92
- const upsert = ctx.flags.upsert;
92
+ // #2775: the parser's `applyDefaults` only materializes global-option
93
+ // defaults, not per-subcommand ones — so despite the `default: true`
94
+ // above, `ctx.flags.upsert` arrives as `undefined` unless the user
95
+ // passes `--upsert` explicitly. That is exactly the trap #2594 tried
96
+ // to close: `store → delete → store` and even plain `store → store`
97
+ // (against an active row) both fall through to the bridge's strict
98
+ // insert, and before #2775's ON-CONFLICT-DO-UPDATE-WHERE-status-
99
+ // 'deleted' fix, both dead-ended with the misleading #2735 guard.
100
+ // Materialize the declared default locally so it takes effect
101
+ // regardless of the parser gap: only an explicit `--no-upsert` (which
102
+ // arrives as `false`) turns it off.
103
+ const upsert = ctx.flags.upsert !== false;
93
104
  if (!key) {
94
105
  output.printError('Key is required. Use --key or -k');
95
106
  return { success: false, exitCode: 1 };
@@ -182,10 +182,10 @@ const backupSubcommand = {
182
182
  tables = tablesFilter.split(',').map(t => t.trim());
183
183
  }
184
184
  else {
185
- const tablesResult = await client.query(`
186
- SELECT table_name FROM information_schema.tables
187
- WHERE table_schema = $1 AND table_type = 'BASE TABLE'
188
- ORDER BY table_name
185
+ const tablesResult = await client.query(`
186
+ SELECT table_name FROM information_schema.tables
187
+ WHERE table_schema = $1 AND table_type = 'BASE TABLE'
188
+ ORDER BY table_name
189
189
  `, [config.schema]);
190
190
  tables = tablesResult.rows.map(r => r.table_name);
191
191
  }
@@ -209,16 +209,16 @@ const backupSubcommand = {
209
209
  spinner.setText(`Exporting ${tableName}...`);
210
210
  spinner.start();
211
211
  // Get columns
212
- const columnsResult = await client.query(`
213
- SELECT column_name, data_type
214
- FROM information_schema.columns
215
- WHERE table_schema = $1 AND table_name = $2
216
- ORDER BY ordinal_position
212
+ const columnsResult = await client.query(`
213
+ SELECT column_name, data_type
214
+ FROM information_schema.columns
215
+ WHERE table_schema = $1 AND table_name = $2
216
+ ORDER BY ordinal_position
217
217
  `, [config.schema, tableName]);
218
218
  const columns = columnsResult.rows.map(r => r.column_name);
219
219
  // Get data
220
- const dataResult = await client.query(`
221
- SELECT * FROM ${config.schema}.${tableName}
220
+ const dataResult = await client.query(`
221
+ SELECT * FROM ${config.schema}.${tableName}
222
222
  `);
223
223
  backupData.tables.push({
224
224
  name: tableName,
@@ -233,14 +233,14 @@ const backupSubcommand = {
233
233
  if (includeIndexes) {
234
234
  spinner.setText('Exporting index definitions...');
235
235
  spinner.start();
236
- const indexResult = await client.query(`
237
- SELECT pg_get_indexdef(i.oid) as indexdef
238
- FROM pg_index idx
239
- JOIN pg_class i ON i.oid = idx.indexrelid
240
- JOIN pg_class t ON t.oid = idx.indrelid
241
- JOIN pg_namespace n ON n.oid = t.relnamespace
242
- WHERE n.nspname = $1
243
- AND NOT idx.indisprimary
236
+ const indexResult = await client.query(`
237
+ SELECT pg_get_indexdef(i.oid) as indexdef
238
+ FROM pg_index idx
239
+ JOIN pg_class i ON i.oid = idx.indexrelid
240
+ JOIN pg_class t ON t.oid = idx.indrelid
241
+ JOIN pg_namespace n ON n.oid = t.relnamespace
242
+ WHERE n.nspname = $1
243
+ AND NOT idx.indisprimary
244
244
  `, [config.schema]);
245
245
  backupData.indexes = indexResult.rows.map(r => r.indexdef);
246
246
  spinner.succeed(`Exported ${backupData.indexes.length} index definitions`);
@@ -566,10 +566,10 @@ const restoreSubcommand = {
566
566
  return typeof val === 'object' ? JSON.stringify(val) : val;
567
567
  });
568
568
  try {
569
- await client.query(`
570
- INSERT INTO ${config.schema}.${table.name} (${columns.join(', ')})
571
- VALUES (${values.join(', ')})
572
- ON CONFLICT DO NOTHING
569
+ await client.query(`
570
+ INSERT INTO ${config.schema}.${table.name} (${columns.join(', ')})
571
+ VALUES (${values.join(', ')})
572
+ ON CONFLICT DO NOTHING
573
573
  `, params);
574
574
  restoredRows++;
575
575
  }
@@ -228,8 +228,8 @@ export const benchmarkCommand = {
228
228
  spinner.succeed('Connected to PostgreSQL');
229
229
  // Detect vector extension type: prefer ruvector, fall back to pgvector
230
230
  let vectorTypeName = 'vector';
231
- const ruvectorCheck = await client.query(`
232
- SELECT extname FROM pg_extension WHERE extname = 'ruvector'
231
+ const ruvectorCheck = await client.query(`
232
+ SELECT extname FROM pg_extension WHERE extname = 'ruvector'
233
233
  `);
234
234
  if (ruvectorCheck.rows.length > 0) {
235
235
  vectorTypeName = 'ruvector';
@@ -238,12 +238,12 @@ export const benchmarkCommand = {
238
238
  const benchmarkTable = `${config.schema}.benchmark_${Date.now()}`;
239
239
  spinner.setText('Creating benchmark table...');
240
240
  spinner.start();
241
- await client.query(`
242
- CREATE TABLE ${benchmarkTable} (
243
- id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
244
- embedding ${vectorTypeName}(${dimensions}),
245
- created_at TIMESTAMPTZ DEFAULT NOW()
246
- )
241
+ await client.query(`
242
+ CREATE TABLE ${benchmarkTable} (
243
+ id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
244
+ embedding ${vectorTypeName}(${dimensions}),
245
+ created_at TIMESTAMPTZ DEFAULT NOW()
246
+ )
247
247
  `);
248
248
  spinner.succeed('Benchmark table created');
249
249
  // Insert vectors
@@ -259,9 +259,9 @@ export const benchmarkCommand = {
259
259
  const vector = generateRandomVector(dimensions);
260
260
  batchVectors.push(`('[${vector.join(',')}]')`);
261
261
  }
262
- await client.query(`
263
- INSERT INTO ${benchmarkTable} (embedding)
264
- VALUES ${batchVectors.join(',')}
262
+ await client.query(`
263
+ INSERT INTO ${benchmarkTable} (embedding)
264
+ VALUES ${batchVectors.join(',')}
265
265
  `);
266
266
  insertedCount = batchEnd;
267
267
  spinner.setText(`Inserting vectors... ${insertedCount.toLocaleString()}/${numVectors.toLocaleString()}`);
@@ -283,21 +283,21 @@ export const benchmarkCommand = {
283
283
  const metricOp = metric === 'cosine' ? `${opsPrefix}_cosine_ops` :
284
284
  metric === 'l2' ? `${opsPrefix}_l2_ops` : `${opsPrefix}_ip_ops`;
285
285
  if (indexType === 'hnsw') {
286
- await client.query(`
287
- CREATE INDEX idx_benchmark_hnsw
288
- ON ${benchmarkTable}
289
- USING hnsw (embedding ${metricOp})
290
- WITH (m = 16, ef_construction = 64)
286
+ await client.query(`
287
+ CREATE INDEX idx_benchmark_hnsw
288
+ ON ${benchmarkTable}
289
+ USING hnsw (embedding ${metricOp})
290
+ WITH (m = 16, ef_construction = 64)
291
291
  `);
292
292
  }
293
293
  else if (indexType === 'ivfflat') {
294
294
  // Need to train IVFFlat with existing data
295
295
  const lists = Math.max(100, Math.floor(numVectors / 1000));
296
- await client.query(`
297
- CREATE INDEX idx_benchmark_ivfflat
298
- ON ${benchmarkTable}
299
- USING ivfflat (embedding ${metricOp})
300
- WITH (lists = ${lists})
296
+ await client.query(`
297
+ CREATE INDEX idx_benchmark_ivfflat
298
+ ON ${benchmarkTable}
299
+ USING ivfflat (embedding ${metricOp})
300
+ WITH (lists = ${lists})
301
301
  `);
302
302
  }
303
303
  const indexDuration = Date.now() - indexStart;
@@ -320,11 +320,11 @@ export const benchmarkCommand = {
320
320
  for (let q = 0; q < numQueries; q++) {
321
321
  const queryVector = generateRandomVector(dimensions);
322
322
  const queryStart = Date.now();
323
- await client.query(`
324
- SELECT id, embedding ${distanceOp} '[${queryVector.join(',')}]' as distance
325
- FROM ${benchmarkTable}
326
- ORDER BY embedding ${distanceOp} '[${queryVector.join(',')}]'
327
- LIMIT ${topK}
323
+ await client.query(`
324
+ SELECT id, embedding ${distanceOp} '[${queryVector.join(',')}]' as distance
325
+ FROM ${benchmarkTable}
326
+ ORDER BY embedding ${distanceOp} '[${queryVector.join(',')}]'
327
+ LIMIT ${topK}
328
328
  `);
329
329
  queryLatencies.push(Date.now() - queryStart);
330
330
  if (q % 10 === 0) {
@@ -354,11 +354,11 @@ export const benchmarkCommand = {
354
354
  // Get memory usage
355
355
  spinner.setText('Analyzing memory usage...');
356
356
  spinner.start();
357
- const sizeResult = await client.query(`
358
- SELECT
359
- pg_relation_size('${benchmarkTable}') as table_size,
360
- pg_total_relation_size('${benchmarkTable}') as total_size,
361
- pg_indexes_size('${benchmarkTable}') as index_size
357
+ const sizeResult = await client.query(`
358
+ SELECT
359
+ pg_relation_size('${benchmarkTable}') as table_size,
360
+ pg_total_relation_size('${benchmarkTable}') as total_size,
361
+ pg_indexes_size('${benchmarkTable}') as index_size
362
362
  `);
363
363
  const tableSize = parseInt(sizeResult.rows[0].table_size, 10);
364
364
  const totalSize = parseInt(sizeResult.rows[0].total_size, 10);
@@ -61,20 +61,20 @@ function generateInsertSQL(entry) {
61
61
  const updatedAt = entry.updated_at
62
62
  ? `'${escapeString(validateTimestamp(String(entry.updated_at)))}'::timestamptz`
63
63
  : 'NOW()';
64
- return `INSERT INTO claude_flow.memory_entries (key, value, embedding, namespace, metadata, created_at, updated_at)
65
- VALUES (
66
- '${key}',
67
- '${value}',
68
- ${embeddingClause},
69
- '${namespace}',
70
- '${metadata}'::jsonb,
71
- ${createdAt},
72
- ${updatedAt}
73
- )
74
- ON CONFLICT (key, namespace) DO UPDATE SET
75
- value = EXCLUDED.value,
76
- embedding = COALESCE(EXCLUDED.embedding, claude_flow.memory_entries.embedding),
77
- metadata = EXCLUDED.metadata,
64
+ return `INSERT INTO claude_flow.memory_entries (key, value, embedding, namespace, metadata, created_at, updated_at)
65
+ VALUES (
66
+ '${key}',
67
+ '${value}',
68
+ ${embeddingClause},
69
+ '${namespace}',
70
+ '${metadata}'::jsonb,
71
+ ${createdAt},
72
+ ${updatedAt}
73
+ )
74
+ ON CONFLICT (key, namespace) DO UPDATE SET
75
+ value = EXCLUDED.value,
76
+ embedding = COALESCE(EXCLUDED.embedding, claude_flow.memory_entries.embedding),
77
+ metadata = EXCLUDED.metadata,
78
78
  updated_at = NOW();`;
79
79
  }
80
80
  /**