@claude-flow/cli 3.10.35 → 3.10.37

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 (515) 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/helpers/README.md +96 -96
  259. package/.claude/helpers/adr-compliance.sh +186 -186
  260. package/.claude/helpers/auto-commit.sh +178 -178
  261. package/.claude/helpers/auto-memory-hook.mjs +368 -368
  262. package/.claude/helpers/checkpoint-manager.sh +251 -251
  263. package/.claude/helpers/daemon-manager.sh +252 -252
  264. package/.claude/helpers/ddd-tracker.sh +144 -144
  265. package/.claude/helpers/github-safe.js +156 -156
  266. package/.claude/helpers/github-setup.sh +45 -45
  267. package/.claude/helpers/guidance-hook.sh +13 -13
  268. package/.claude/helpers/guidance-hooks.sh +102 -102
  269. package/.claude/helpers/health-monitor.sh +108 -108
  270. package/.claude/helpers/hook-handler.cjs +286 -286
  271. package/.claude/helpers/intelligence.cjs +1031 -1031
  272. package/.claude/helpers/learning-hooks.sh +329 -329
  273. package/.claude/helpers/learning-optimizer.sh +127 -127
  274. package/.claude/helpers/learning-service.mjs +1144 -1144
  275. package/.claude/helpers/memory.js +83 -83
  276. package/.claude/helpers/metrics-db.mjs +488 -488
  277. package/.claude/helpers/pattern-consolidator.sh +86 -86
  278. package/.claude/helpers/perf-worker.sh +160 -160
  279. package/.claude/helpers/post-commit +16 -16
  280. package/.claude/helpers/pre-commit +26 -26
  281. package/.claude/helpers/quick-start.sh +19 -19
  282. package/.claude/helpers/router.js +105 -105
  283. package/.claude/helpers/security-scanner.sh +127 -127
  284. package/.claude/helpers/session.js +135 -135
  285. package/.claude/helpers/setup-mcp.sh +18 -18
  286. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  287. package/.claude/helpers/statusline-hook.sh +21 -21
  288. package/.claude/helpers/statusline.cjs +604 -604
  289. package/.claude/helpers/statusline.js +352 -352
  290. package/.claude/helpers/swarm-comms.sh +353 -353
  291. package/.claude/helpers/swarm-hooks.sh +761 -761
  292. package/.claude/helpers/swarm-monitor.sh +210 -210
  293. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  294. package/.claude/helpers/update-v3-progress.sh +165 -165
  295. package/.claude/helpers/v3-quick-status.sh +57 -57
  296. package/.claude/helpers/v3.sh +110 -110
  297. package/.claude/helpers/validate-v3-config.sh +215 -215
  298. package/.claude/helpers/worker-manager.sh +170 -170
  299. package/.claude/settings.json +182 -182
  300. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  301. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  302. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  303. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  304. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  305. package/.claude/skills/browser/SKILL.md +204 -204
  306. package/.claude/skills/dual-mode/README.md +71 -71
  307. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  308. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  309. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  310. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  311. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  312. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  313. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  314. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  315. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  316. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  317. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  318. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  319. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  320. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  321. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  322. package/.claude/skills/skill-builder/SKILL.md +910 -910
  323. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  324. package/.claude/skills/stream-chain/SKILL.md +560 -560
  325. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  326. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  327. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  328. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  329. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  330. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  331. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  332. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  333. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  334. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  335. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  336. package/.claude/skills/verification-quality/SKILL.md +691 -691
  337. package/README.md +416 -416
  338. package/bin/cli.js +314 -286
  339. package/bin/mcp-server.js +224 -224
  340. package/bin/preinstall.cjs +2 -2
  341. package/dist/src/benchmarks/gaia-critic.js +24 -24
  342. package/dist/src/commands/completions.js +409 -409
  343. package/dist/src/commands/daemon.js +44 -44
  344. package/dist/src/commands/embeddings.js +29 -29
  345. package/dist/src/commands/embeddings.js.map +1 -1
  346. package/dist/src/commands/hive-mind.js +97 -97
  347. package/dist/src/commands/hooks.js +9 -9
  348. package/dist/src/commands/ruvector/backup.js +23 -23
  349. package/dist/src/commands/ruvector/benchmark.js +31 -31
  350. package/dist/src/commands/ruvector/import.js +14 -14
  351. package/dist/src/commands/ruvector/init.js +115 -115
  352. package/dist/src/commands/ruvector/migrate.js +99 -99
  353. package/dist/src/commands/ruvector/optimize.js +51 -51
  354. package/dist/src/commands/ruvector/setup.js +624 -624
  355. package/dist/src/commands/ruvector/status.js +38 -38
  356. package/dist/src/init/claudemd-generator.js +227 -227
  357. package/dist/src/init/executor.js +453 -453
  358. package/dist/src/init/helpers-generator.js +727 -727
  359. package/dist/src/init/statusline-generator.js +570 -570
  360. package/dist/src/log-filters.d.ts +21 -8
  361. package/dist/src/log-filters.d.ts.map +1 -1
  362. package/dist/src/log-filters.js +45 -8
  363. package/dist/src/log-filters.js.map +1 -1
  364. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  365. package/dist/src/memory/graph-edge-writer.js +18 -18
  366. package/dist/src/memory/memory-bridge.js +84 -84
  367. package/dist/src/memory/memory-initializer.js +393 -393
  368. package/dist/src/memory/rabitq-index.js +5 -5
  369. package/dist/src/runtime/headless.js +28 -28
  370. package/dist/src/ruvector/flash-attention.d.ts +195 -0
  371. package/dist/src/ruvector/flash-attention.d.ts.map +1 -0
  372. package/dist/src/ruvector/flash-attention.js +643 -0
  373. package/dist/src/ruvector/flash-attention.js.map +1 -0
  374. package/dist/src/ruvector/moe-router.d.ts +206 -0
  375. package/dist/src/ruvector/moe-router.d.ts.map +1 -0
  376. package/dist/src/ruvector/moe-router.js +626 -0
  377. package/dist/src/ruvector/moe-router.js.map +1 -0
  378. package/dist/src/services/event-stream.d.ts +25 -0
  379. package/dist/src/services/event-stream.js +27 -0
  380. package/dist/src/services/headless-worker-executor.js +84 -84
  381. package/dist/src/services/loop-worker-runner.d.ts +16 -0
  382. package/dist/src/services/loop-worker-runner.js +34 -0
  383. package/dist/src/services/runtime-capabilities.d.ts +22 -0
  384. package/dist/src/services/runtime-capabilities.js +45 -0
  385. package/dist/src/transfer/deploy-seraphine.js +23 -23
  386. package/dist/tsconfig.tsbuildinfo +1 -1
  387. package/package.json +134 -134
  388. package/scripts/beir-bootstrap-significance.mjs +162 -162
  389. package/scripts/bench-rvagent.mjs +312 -312
  390. package/scripts/benchmark-codemods.mjs +127 -127
  391. package/scripts/benchmark-cross-repo.mjs +206 -206
  392. package/scripts/benchmark-pretrained-retrieval.mjs +305 -305
  393. package/scripts/benchmark-self-learning.mjs +241 -241
  394. package/scripts/benchmark-trajectory-mrr.mjs +191 -191
  395. package/scripts/deploy-ipfs-node.sh +153 -153
  396. package/scripts/grid-search-retrieval.mjs +216 -216
  397. package/scripts/postinstall.cjs +153 -153
  398. package/scripts/pretrain-from-github.mjs +358 -358
  399. package/scripts/publish-registry.ts +345 -345
  400. package/scripts/publish.sh +57 -57
  401. package/scripts/run-beir-bge.mjs +324 -336
  402. package/scripts/run-beir-hybrid.mjs +261 -263
  403. package/scripts/run-beir-lucene-bm25.mjs +154 -154
  404. package/scripts/run-beir-nfcorpus.mjs +231 -231
  405. package/scripts/run-beir-rrf-ablation.mjs +221 -221
  406. package/scripts/setup-ipfs-registry.md +366 -366
  407. package/dist/src/benchmarks/capability-tasks.d.ts +0 -126
  408. package/dist/src/benchmarks/capability-tasks.d.ts.map +0 -1
  409. package/dist/src/benchmarks/capability-tasks.js +0 -147
  410. package/dist/src/benchmarks/capability-tasks.js.map +0 -1
  411. package/dist/src/benchmarks/gaia-agent-contrastive.d.ts +0 -53
  412. package/dist/src/benchmarks/gaia-agent-contrastive.d.ts.map +0 -1
  413. package/dist/src/benchmarks/gaia-agent-contrastive.js +0 -177
  414. package/dist/src/benchmarks/gaia-agent-contrastive.js.map +0 -1
  415. package/dist/src/benchmarks/gaia-agent-gemini.d.ts +0 -51
  416. package/dist/src/benchmarks/gaia-agent-gemini.d.ts.map +0 -1
  417. package/dist/src/benchmarks/gaia-agent-gemini.js +0 -352
  418. package/dist/src/benchmarks/gaia-agent-gemini.js.map +0 -1
  419. package/dist/src/benchmarks/gaia-claude-p.d.ts +0 -105
  420. package/dist/src/benchmarks/gaia-claude-p.d.ts.map +0 -1
  421. package/dist/src/benchmarks/gaia-claude-p.js +0 -269
  422. package/dist/src/benchmarks/gaia-claude-p.js.map +0 -1
  423. package/dist/src/benchmarks/gaia-claude-p.smoke.d.ts +0 -20
  424. package/dist/src/benchmarks/gaia-claude-p.smoke.d.ts.map +0 -1
  425. package/dist/src/benchmarks/gaia-claude-p.smoke.js +0 -168
  426. package/dist/src/benchmarks/gaia-claude-p.smoke.js.map +0 -1
  427. package/dist/src/benchmarks/gaia-codeagent-runner.py +0 -556
  428. package/dist/src/benchmarks/gaia-codeagent.d.ts +0 -129
  429. package/dist/src/benchmarks/gaia-codeagent.d.ts.map +0 -1
  430. package/dist/src/benchmarks/gaia-codeagent.js +0 -590
  431. package/dist/src/benchmarks/gaia-codeagent.js.map +0 -1
  432. package/dist/src/benchmarks/gaia-codeagent.smoke.d.ts +0 -33
  433. package/dist/src/benchmarks/gaia-codeagent.smoke.d.ts.map +0 -1
  434. package/dist/src/benchmarks/gaia-codeagent.smoke.js +0 -241
  435. package/dist/src/benchmarks/gaia-codeagent.smoke.js.map +0 -1
  436. package/dist/src/benchmarks/gaia-dag-pilot.d.ts +0 -22
  437. package/dist/src/benchmarks/gaia-dag-pilot.d.ts.map +0 -1
  438. package/dist/src/benchmarks/gaia-dag-pilot.js +0 -158
  439. package/dist/src/benchmarks/gaia-dag-pilot.js.map +0 -1
  440. package/dist/src/benchmarks/gaia-dag.d.ts +0 -110
  441. package/dist/src/benchmarks/gaia-dag.d.ts.map +0 -1
  442. package/dist/src/benchmarks/gaia-dag.js +0 -658
  443. package/dist/src/benchmarks/gaia-dag.js.map +0 -1
  444. package/dist/src/benchmarks/gaia-dag.smoke.d.ts +0 -21
  445. package/dist/src/benchmarks/gaia-dag.smoke.d.ts.map +0 -1
  446. package/dist/src/benchmarks/gaia-dag.smoke.js +0 -290
  447. package/dist/src/benchmarks/gaia-dag.smoke.js.map +0 -1
  448. package/dist/src/benchmarks/gaia-ensemble-pilot.d.ts +0 -17
  449. package/dist/src/benchmarks/gaia-ensemble-pilot.d.ts.map +0 -1
  450. package/dist/src/benchmarks/gaia-ensemble-pilot.js +0 -106
  451. package/dist/src/benchmarks/gaia-ensemble-pilot.js.map +0 -1
  452. package/dist/src/benchmarks/gaia-ensemble.d.ts +0 -103
  453. package/dist/src/benchmarks/gaia-ensemble.d.ts.map +0 -1
  454. package/dist/src/benchmarks/gaia-ensemble.js +0 -462
  455. package/dist/src/benchmarks/gaia-ensemble.js.map +0 -1
  456. package/dist/src/benchmarks/gaia-gemini-pilot.d.ts +0 -17
  457. package/dist/src/benchmarks/gaia-gemini-pilot.d.ts.map +0 -1
  458. package/dist/src/benchmarks/gaia-gemini-pilot.js +0 -168
  459. package/dist/src/benchmarks/gaia-gemini-pilot.js.map +0 -1
  460. package/dist/src/benchmarks/gaia-mode-router.d.ts +0 -67
  461. package/dist/src/benchmarks/gaia-mode-router.d.ts.map +0 -1
  462. package/dist/src/benchmarks/gaia-mode-router.js +0 -126
  463. package/dist/src/benchmarks/gaia-mode-router.js.map +0 -1
  464. package/dist/src/benchmarks/gaia-mode-router.smoke.d.ts +0 -15
  465. package/dist/src/benchmarks/gaia-mode-router.smoke.d.ts.map +0 -1
  466. package/dist/src/benchmarks/gaia-mode-router.smoke.js +0 -131
  467. package/dist/src/benchmarks/gaia-mode-router.smoke.js.map +0 -1
  468. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.d.ts +0 -24
  469. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.d.ts.map +0 -1
  470. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.js +0 -276
  471. package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.js.map +0 -1
  472. package/dist/src/benchmarks/gaia-tools/image_describe.d.ts +0 -45
  473. package/dist/src/benchmarks/gaia-tools/image_describe.d.ts.map +0 -1
  474. package/dist/src/benchmarks/gaia-tools/image_describe.js +0 -222
  475. package/dist/src/benchmarks/gaia-tools/image_describe.js.map +0 -1
  476. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.d.ts +0 -24
  477. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.d.ts.map +0 -1
  478. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.js +0 -169
  479. package/dist/src/benchmarks/gaia-tools/image_describe.smoke.js.map +0 -1
  480. package/dist/src/benchmarks/gaia-tools/pdf_read.d.ts +0 -27
  481. package/dist/src/benchmarks/gaia-tools/pdf_read.d.ts.map +0 -1
  482. package/dist/src/benchmarks/gaia-tools/pdf_read.js +0 -226
  483. package/dist/src/benchmarks/gaia-tools/pdf_read.js.map +0 -1
  484. package/dist/src/benchmarks/gaia-tools/python_exec.d.ts +0 -31
  485. package/dist/src/benchmarks/gaia-tools/python_exec.d.ts.map +0 -1
  486. package/dist/src/benchmarks/gaia-tools/python_exec.js +0 -94
  487. package/dist/src/benchmarks/gaia-tools/python_exec.js.map +0 -1
  488. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.d.ts +0 -13
  489. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.d.ts.map +0 -1
  490. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.js +0 -98
  491. package/dist/src/benchmarks/gaia-tools/python_exec.smoke.js.map +0 -1
  492. package/dist/src/benchmarks/gaia-tools/visit_webpage.d.ts +0 -52
  493. package/dist/src/benchmarks/gaia-tools/visit_webpage.d.ts.map +0 -1
  494. package/dist/src/benchmarks/gaia-tools/visit_webpage.js +0 -304
  495. package/dist/src/benchmarks/gaia-tools/visit_webpage.js.map +0 -1
  496. package/dist/src/benchmarks/gaia-tools/web_browse.d.ts +0 -61
  497. package/dist/src/benchmarks/gaia-tools/web_browse.d.ts.map +0 -1
  498. package/dist/src/benchmarks/gaia-tools/web_browse.js +0 -217
  499. package/dist/src/benchmarks/gaia-tools/web_browse.js.map +0 -1
  500. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.d.ts +0 -26
  501. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.d.ts.map +0 -1
  502. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.js +0 -152
  503. package/dist/src/benchmarks/gaia-tools/web_browse.smoke.js.map +0 -1
  504. package/dist/src/benchmarks/gaia-tools/web_search.smoke.d.ts +0 -24
  505. package/dist/src/benchmarks/gaia-tools/web_search.smoke.d.ts.map +0 -1
  506. package/dist/src/benchmarks/gaia-tools/web_search.smoke.js +0 -311
  507. package/dist/src/benchmarks/gaia-tools/web_search.smoke.js.map +0 -1
  508. package/dist/src/benchmarks/gaia-visit-webpage.smoke.d.ts +0 -25
  509. package/dist/src/benchmarks/gaia-visit-webpage.smoke.d.ts.map +0 -1
  510. package/dist/src/benchmarks/gaia-visit-webpage.smoke.js +0 -304
  511. package/dist/src/benchmarks/gaia-visit-webpage.smoke.js.map +0 -1
  512. package/dist/src/commands/performance-capability.d.ts +0 -30
  513. package/dist/src/commands/performance-capability.d.ts.map +0 -1
  514. package/dist/src/commands/performance-capability.js +0 -349
  515. package/dist/src/commands/performance-capability.js.map +0 -1
@@ -177,8 +177,8 @@ export const statusCommand = {
177
177
  spinner.setText('Checking vector extension...');
178
178
  spinner.start();
179
179
  // Check for ruvector first
180
- const ruvectorResult = await client.query(`
181
- SELECT extname, extversion FROM pg_extension WHERE extname = 'ruvector'
180
+ const ruvectorResult = await client.query(`
181
+ SELECT extname, extversion FROM pg_extension WHERE extname = 'ruvector'
182
182
  `);
183
183
  if (ruvectorResult.rows.length > 0) {
184
184
  statusData.pgvector = {
@@ -192,8 +192,8 @@ export const statusCommand = {
192
192
  }
193
193
  else {
194
194
  // Fall back to pgvector
195
- const pgvectorResult = await client.query(`
196
- SELECT extname, extversion FROM pg_extension WHERE extname = 'vector'
195
+ const pgvectorResult = await client.query(`
196
+ SELECT extname, extversion FROM pg_extension WHERE extname = 'vector'
197
197
  `);
198
198
  if (pgvectorResult.rows.length > 0) {
199
199
  statusData.pgvector = {
@@ -216,8 +216,8 @@ export const statusCommand = {
216
216
  if (!jsonOutput)
217
217
  spinner.setText(`Checking schema "${config.schema}"...`);
218
218
  spinner.start();
219
- const schemaResult = await client.query(`
220
- SELECT schema_name FROM information_schema.schemata WHERE schema_name = $1
219
+ const schemaResult = await client.query(`
220
+ SELECT schema_name FROM information_schema.schemata WHERE schema_name = $1
221
221
  `, [config.schema]);
222
222
  if (schemaResult.rows.length === 0) {
223
223
  statusData.ruvector = { initialized: false };
@@ -238,8 +238,8 @@ export const statusCommand = {
238
238
  spinner.setText('Loading RuVector metadata...');
239
239
  spinner.start();
240
240
  try {
241
- const metadataResult = await client.query(`
242
- SELECT key, value FROM ${config.schema}.metadata
241
+ const metadataResult = await client.query(`
242
+ SELECT key, value FROM ${config.schema}.metadata
243
243
  `);
244
244
  const metadata = {};
245
245
  for (const row of metadataResult.rows) {
@@ -263,23 +263,23 @@ export const statusCommand = {
263
263
  if (!jsonOutput)
264
264
  spinner.setText('Gathering table statistics...');
265
265
  spinner.start();
266
- const tablesResult = await client.query(`
267
- SELECT
268
- t.table_name,
269
- pg_relation_size(quote_ident(t.table_schema) || '.' || quote_ident(t.table_name)) as table_size,
270
- pg_total_relation_size(quote_ident(t.table_schema) || '.' || quote_ident(t.table_name)) as total_size,
271
- (SELECT count(*) FROM ${config.schema}.embeddings) as row_count
272
- FROM information_schema.tables t
273
- WHERE t.table_schema = $1
274
- ORDER BY t.table_name
266
+ const tablesResult = await client.query(`
267
+ SELECT
268
+ t.table_name,
269
+ pg_relation_size(quote_ident(t.table_schema) || '.' || quote_ident(t.table_name)) as table_size,
270
+ pg_total_relation_size(quote_ident(t.table_schema) || '.' || quote_ident(t.table_name)) as total_size,
271
+ (SELECT count(*) FROM ${config.schema}.embeddings) as row_count
272
+ FROM information_schema.tables t
273
+ WHERE t.table_schema = $1
274
+ ORDER BY t.table_name
275
275
  `, [config.schema]);
276
276
  const tableStats = [];
277
277
  for (const row of tablesResult.rows) {
278
278
  // Get row count for each table
279
279
  let rowCount = 0;
280
280
  try {
281
- const countResult = await client.query(`
282
- SELECT count(*) as cnt FROM ${config.schema}.${row.table_name}
281
+ const countResult = await client.query(`
282
+ SELECT count(*) as cnt FROM ${config.schema}.${row.table_name}
283
283
  `);
284
284
  rowCount = parseInt(countResult.rows[0].cnt, 10);
285
285
  }
@@ -301,21 +301,21 @@ export const statusCommand = {
301
301
  if (!jsonOutput)
302
302
  spinner.setText('Gathering index information...');
303
303
  spinner.start();
304
- const indexResult = await client.query(`
305
- SELECT
306
- i.relname as index_name,
307
- t.relname as table_name,
308
- am.amname as index_type,
309
- pg_relation_size(i.oid) as index_size,
310
- idx.indisvalid as is_valid,
311
- idx.indisunique as is_unique
312
- FROM pg_index idx
313
- JOIN pg_class i ON i.oid = idx.indexrelid
314
- JOIN pg_class t ON t.oid = idx.indrelid
315
- JOIN pg_namespace n ON n.oid = t.relnamespace
316
- JOIN pg_am am ON am.oid = i.relam
317
- WHERE n.nspname = $1
318
- ORDER BY t.relname, i.relname
304
+ const indexResult = await client.query(`
305
+ SELECT
306
+ i.relname as index_name,
307
+ t.relname as table_name,
308
+ am.amname as index_type,
309
+ pg_relation_size(i.oid) as index_size,
310
+ idx.indisvalid as is_valid,
311
+ idx.indisunique as is_unique
312
+ FROM pg_index idx
313
+ JOIN pg_class i ON i.oid = idx.indexrelid
314
+ JOIN pg_class t ON t.oid = idx.indrelid
315
+ JOIN pg_namespace n ON n.oid = t.relnamespace
316
+ JOIN pg_am am ON am.oid = i.relam
317
+ WHERE n.nspname = $1
318
+ ORDER BY t.relname, i.relname
319
319
  `, [config.schema]);
320
320
  statusData.indexes = indexResult.rows.map(row => ({
321
321
  name: row.index_name,
@@ -333,10 +333,10 @@ export const statusCommand = {
333
333
  spinner.setText('Checking migration status...');
334
334
  spinner.start();
335
335
  try {
336
- const migrationsResult = await client.query(`
337
- SELECT version, name, applied_at
338
- FROM ${config.schema}.migrations
339
- ORDER BY version ASC
336
+ const migrationsResult = await client.query(`
337
+ SELECT version, name, applied_at
338
+ FROM ${config.schema}.migrations
339
+ ORDER BY version ASC
340
340
  `);
341
341
  statusData.migrations = migrationsResult.rows.map(row => ({
342
342
  version: row.version,
@@ -7,272 +7,272 @@
7
7
  */
8
8
  // --- Section Generators ---
9
9
  function behavioralRules() {
10
- return `## Rules
11
-
12
- - Do what has been asked; nothing more, nothing less
13
- - NEVER create files unless absolutely necessary — prefer editing existing files
14
- - NEVER create documentation files unless explicitly requested
15
- - NEVER save working files or tests to root — use \`/src\`, \`/tests\`, \`/docs\`, \`/config\`, \`/scripts\`
16
- - ALWAYS read a file before editing it
17
- - NEVER commit secrets, credentials, or .env files
18
- - NEVER add a \`Co-Authored-By\` trailer to user commits unless this project's \`.claude/settings.json\` has \`attribution.commit\` set (#2078). The Claude Code Bash tool may suggest one in its default commit-message template — ignore it. \`Co-Authored-By\` is semantic authorship attribution under git/GitHub convention; the tool is the facilitator, not a co-author.
19
- - Keep files under 500 lines
10
+ return `## Rules
11
+
12
+ - Do what has been asked; nothing more, nothing less
13
+ - NEVER create files unless absolutely necessary — prefer editing existing files
14
+ - NEVER create documentation files unless explicitly requested
15
+ - NEVER save working files or tests to root — use \`/src\`, \`/tests\`, \`/docs\`, \`/config\`, \`/scripts\`
16
+ - ALWAYS read a file before editing it
17
+ - NEVER commit secrets, credentials, or .env files
18
+ - NEVER add a \`Co-Authored-By\` trailer to user commits unless this project's \`.claude/settings.json\` has \`attribution.commit\` set (#2078). The Claude Code Bash tool may suggest one in its default commit-message template — ignore it. \`Co-Authored-By\` is semantic authorship attribution under git/GitHub convention; the tool is the facilitator, not a co-author.
19
+ - Keep files under 500 lines
20
20
  - Validate input at system boundaries`;
21
21
  }
22
22
  function agentComms() {
23
- return `## Agent Comms (SendMessage-First Coordination)
24
-
25
- Named agents coordinate via \`SendMessage\`, not polling or shared state.
26
-
27
- \`\`\`
28
- Lead (you) ←→ architect ←→ developer ←→ tester ←→ reviewer
29
- (named agents message each other directly)
30
- \`\`\`
31
-
32
- ### Spawning a Coordinated Team
33
-
34
- \`\`\`javascript
35
- // ALL agents in ONE message, each knows WHO to message next
36
- Agent({ prompt: "Research the codebase. SendMessage findings to 'architect'.",
37
- subagent_type: "researcher", name: "researcher", run_in_background: true })
38
- Agent({ prompt: "Wait for 'researcher'. Design solution. SendMessage to 'coder'.",
39
- subagent_type: "system-architect", name: "architect", run_in_background: true })
40
- Agent({ prompt: "Wait for 'architect'. Implement it. SendMessage to 'tester'.",
41
- subagent_type: "coder", name: "coder", run_in_background: true })
42
- Agent({ prompt: "Wait for 'coder'. Write tests. SendMessage results to 'reviewer'.",
43
- subagent_type: "tester", name: "tester", run_in_background: true })
44
- Agent({ prompt: "Wait for 'tester'. Review code quality and security.",
45
- subagent_type: "reviewer", name: "reviewer", run_in_background: true })
46
-
47
- // Kick off the pipeline
48
- SendMessage({ to: "researcher", summary: "Start", message: "[task context]" })
49
- \`\`\`
50
-
51
- ### Patterns
52
-
53
- | Pattern | Flow | Use When |
54
- |---------|------|----------|
55
- | **Pipeline** | A → B → C → D | Sequential dependencies (feature dev) |
56
- | **Fan-out** | Lead → A, B, C → Lead | Independent parallel work (research) |
57
- | **Supervisor** | Lead ↔ workers | Ongoing coordination (complex refactor) |
58
-
59
- ### Rules
60
-
61
- - ALWAYS name agents — \`name: "role"\` makes them addressable
62
- - ALWAYS include comms instructions in prompts — who to message, what to send
63
- - Spawn ALL agents in ONE message with \`run_in_background: true\`
64
- - After spawning: STOP, tell user what's running, wait for results
23
+ return `## Agent Comms (SendMessage-First Coordination)
24
+
25
+ Named agents coordinate via \`SendMessage\`, not polling or shared state.
26
+
27
+ \`\`\`
28
+ Lead (you) ←→ architect ←→ developer ←→ tester ←→ reviewer
29
+ (named agents message each other directly)
30
+ \`\`\`
31
+
32
+ ### Spawning a Coordinated Team
33
+
34
+ \`\`\`javascript
35
+ // ALL agents in ONE message, each knows WHO to message next
36
+ Agent({ prompt: "Research the codebase. SendMessage findings to 'architect'.",
37
+ subagent_type: "researcher", name: "researcher", run_in_background: true })
38
+ Agent({ prompt: "Wait for 'researcher'. Design solution. SendMessage to 'coder'.",
39
+ subagent_type: "system-architect", name: "architect", run_in_background: true })
40
+ Agent({ prompt: "Wait for 'architect'. Implement it. SendMessage to 'tester'.",
41
+ subagent_type: "coder", name: "coder", run_in_background: true })
42
+ Agent({ prompt: "Wait for 'coder'. Write tests. SendMessage results to 'reviewer'.",
43
+ subagent_type: "tester", name: "tester", run_in_background: true })
44
+ Agent({ prompt: "Wait for 'tester'. Review code quality and security.",
45
+ subagent_type: "reviewer", name: "reviewer", run_in_background: true })
46
+
47
+ // Kick off the pipeline
48
+ SendMessage({ to: "researcher", summary: "Start", message: "[task context]" })
49
+ \`\`\`
50
+
51
+ ### Patterns
52
+
53
+ | Pattern | Flow | Use When |
54
+ |---------|------|----------|
55
+ | **Pipeline** | A → B → C → D | Sequential dependencies (feature dev) |
56
+ | **Fan-out** | Lead → A, B, C → Lead | Independent parallel work (research) |
57
+ | **Supervisor** | Lead ↔ workers | Ongoing coordination (complex refactor) |
58
+
59
+ ### Rules
60
+
61
+ - ALWAYS name agents — \`name: "role"\` makes them addressable
62
+ - ALWAYS include comms instructions in prompts — who to message, what to send
63
+ - Spawn ALL agents in ONE message with \`run_in_background: true\`
64
+ - After spawning: STOP, tell user what's running, wait for results
65
65
  - NEVER poll status — agents message back or complete automatically`;
66
66
  }
67
67
  function swarmConfig(options) {
68
- return `## Swarm & Routing
69
-
70
- ### Config
71
- - **Topology**: ${options.runtime.topology} (anti-drift)
72
- - **Max Agents**: ${options.runtime.maxAgents}
73
- - **Memory**: ${options.runtime.memoryBackend}
74
- - **HNSW**: ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'}
75
- - **Neural**: ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'}
76
-
77
- \`\`\`bash
78
- npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized
79
- \`\`\`
80
-
81
- ### Agent Routing
82
-
83
- | Task | Agents | Topology |
84
- |------|--------|----------|
85
- | Bug Fix | researcher, coder, tester | hierarchical |
86
- | Feature | architect, coder, tester, reviewer | hierarchical |
87
- | Refactor | architect, coder, reviewer | hierarchical |
88
- | Performance | perf-engineer, coder | hierarchical |
89
- | Security | security-architect, auditor | hierarchical |
90
-
91
- ### When to Swarm
92
- - **YES**: 3+ files, new features, cross-module refactoring, API changes, security, performance
93
- - **NO**: single file edits, 1-2 line fixes, docs updates, config changes, questions
94
-
95
- ### 3-Tier Model Routing
96
-
97
- | Tier | Handler | Use Cases |
98
- |------|---------|-----------|
99
- | 1 | Agent Booster (WASM) | Simple transforms — skip LLM, use Edit directly |
100
- | 2 | Haiku | Simple tasks, low complexity |
68
+ return `## Swarm & Routing
69
+
70
+ ### Config
71
+ - **Topology**: ${options.runtime.topology} (anti-drift)
72
+ - **Max Agents**: ${options.runtime.maxAgents}
73
+ - **Memory**: ${options.runtime.memoryBackend}
74
+ - **HNSW**: ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'}
75
+ - **Neural**: ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'}
76
+
77
+ \`\`\`bash
78
+ npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized
79
+ \`\`\`
80
+
81
+ ### Agent Routing
82
+
83
+ | Task | Agents | Topology |
84
+ |------|--------|----------|
85
+ | Bug Fix | researcher, coder, tester | hierarchical |
86
+ | Feature | architect, coder, tester, reviewer | hierarchical |
87
+ | Refactor | architect, coder, reviewer | hierarchical |
88
+ | Performance | perf-engineer, coder | hierarchical |
89
+ | Security | security-architect, auditor | hierarchical |
90
+
91
+ ### When to Swarm
92
+ - **YES**: 3+ files, new features, cross-module refactoring, API changes, security, performance
93
+ - **NO**: single file edits, 1-2 line fixes, docs updates, config changes, questions
94
+
95
+ ### 3-Tier Model Routing
96
+
97
+ | Tier | Handler | Use Cases |
98
+ |------|---------|-----------|
99
+ | 1 | Agent Booster (WASM) | Simple transforms — skip LLM, use Edit directly |
100
+ | 2 | Haiku | Simple tasks, low complexity |
101
101
  | 3 | Sonnet/Opus | Architecture, security, complex reasoning |`;
102
102
  }
103
103
  function memoryAndLearning() {
104
- return `## Memory & Learning
105
-
106
- ### Before Any Task
107
- \`\`\`bash
108
- npx @claude-flow/cli@latest memory search --query "[task keywords]" --namespace patterns
109
- npx @claude-flow/cli@latest hooks route --task "[task description]"
110
- \`\`\`
111
-
112
- ### After Success
113
- \`\`\`bash
114
- npx @claude-flow/cli@latest memory store --namespace patterns --key "[name]" --value "[what worked]"
115
- npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true --store-results true
116
- \`\`\`
117
-
118
- ### MCP Tools (use \`ToolSearch("keyword")\` to discover)
119
-
120
- | Category | Key Tools |
121
- |----------|-----------|
122
- | **Memory** | \`memory_store\`, \`memory_search\`, \`memory_search_unified\` |
123
- | **Bridge** | \`memory_import_claude\`, \`memory_bridge_status\` |
124
- | **Swarm** | \`swarm_init\`, \`swarm_status\`, \`swarm_health\` |
125
- | **Agents** | \`agent_spawn\`, \`agent_list\`, \`agent_status\` |
126
- | **Hooks** | \`hooks_route\`, \`hooks_post-task\`, \`hooks_worker-dispatch\` |
127
- | **Security** | \`aidefence_scan\`, \`aidefence_is_safe\`, \`aidefence_has_pii\` |
128
- | **Hive-Mind** | \`hive-mind_init\`, \`hive-mind_consensus\`, \`hive-mind_spawn\` |
129
-
130
- ### Background Workers
131
-
132
- | Worker | When |
133
- |--------|------|
134
- | \`audit\` | After security changes |
135
- | \`optimize\` | After performance work |
136
- | \`testgaps\` | After adding features |
137
- | \`map\` | Every 5+ file changes |
138
- | \`document\` | After API changes |
139
-
140
- \`\`\`bash
141
- npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
104
+ return `## Memory & Learning
105
+
106
+ ### Before Any Task
107
+ \`\`\`bash
108
+ npx @claude-flow/cli@latest memory search --query "[task keywords]" --namespace patterns
109
+ npx @claude-flow/cli@latest hooks route --task "[task description]"
110
+ \`\`\`
111
+
112
+ ### After Success
113
+ \`\`\`bash
114
+ npx @claude-flow/cli@latest memory store --namespace patterns --key "[name]" --value "[what worked]"
115
+ npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true --store-results true
116
+ \`\`\`
117
+
118
+ ### MCP Tools (use \`ToolSearch("keyword")\` to discover)
119
+
120
+ | Category | Key Tools |
121
+ |----------|-----------|
122
+ | **Memory** | \`memory_store\`, \`memory_search\`, \`memory_search_unified\` |
123
+ | **Bridge** | \`memory_import_claude\`, \`memory_bridge_status\` |
124
+ | **Swarm** | \`swarm_init\`, \`swarm_status\`, \`swarm_health\` |
125
+ | **Agents** | \`agent_spawn\`, \`agent_list\`, \`agent_status\` |
126
+ | **Hooks** | \`hooks_route\`, \`hooks_post-task\`, \`hooks_worker-dispatch\` |
127
+ | **Security** | \`aidefence_scan\`, \`aidefence_is_safe\`, \`aidefence_has_pii\` |
128
+ | **Hive-Mind** | \`hive-mind_init\`, \`hive-mind_consensus\`, \`hive-mind_spawn\` |
129
+
130
+ ### Background Workers
131
+
132
+ | Worker | When |
133
+ |--------|------|
134
+ | \`audit\` | After security changes |
135
+ | \`optimize\` | After performance work |
136
+ | \`testgaps\` | After adding features |
137
+ | \`map\` | Every 5+ file changes |
138
+ | \`document\` | After API changes |
139
+
140
+ \`\`\`bash
141
+ npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
142
142
  \`\`\``;
143
143
  }
144
144
  function agentTypes() {
145
- return `## Agents
146
-
147
- **Core**: \`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
148
- **Architecture**: \`system-architect\`, \`backend-dev\`, \`mobile-dev\`
149
- **Security**: \`security-architect\`, \`security-auditor\`
150
- **Performance**: \`performance-engineer\`, \`perf-analyzer\`
151
- **Coordination**: \`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`
152
- **GitHub**: \`pr-manager\`, \`code-review-swarm\`, \`issue-tracker\`, \`release-manager\`
153
-
145
+ return `## Agents
146
+
147
+ **Core**: \`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
148
+ **Architecture**: \`system-architect\`, \`backend-dev\`, \`mobile-dev\`
149
+ **Security**: \`security-architect\`, \`security-auditor\`
150
+ **Performance**: \`performance-engineer\`, \`perf-analyzer\`
151
+ **Coordination**: \`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`
152
+ **GitHub**: \`pr-manager\`, \`code-review-swarm\`, \`issue-tracker\`, \`release-manager\`
153
+
154
154
  Any string works as a custom agent type.`;
155
155
  }
156
156
  function cliQuickRef() {
157
- return `## CLI Quick Reference
158
-
159
- \`\`\`bash
160
- npx @claude-flow/cli@latest init --wizard # Setup
161
- npx @claude-flow/cli@latest swarm init --v3-mode # Start swarm
162
- npx @claude-flow/cli@latest memory search --query "" # Vector search
163
- npx @claude-flow/cli@latest hooks route --task "" # Route to agent
164
- npx @claude-flow/cli@latest doctor --fix # Diagnostics
165
- npx @claude-flow/cli@latest security scan # Security scan
166
- npx @claude-flow/cli@latest performance benchmark # Benchmarks
167
- \`\`\`
168
-
157
+ return `## CLI Quick Reference
158
+
159
+ \`\`\`bash
160
+ npx @claude-flow/cli@latest init --wizard # Setup
161
+ npx @claude-flow/cli@latest swarm init --v3-mode # Start swarm
162
+ npx @claude-flow/cli@latest memory search --query "" # Vector search
163
+ npx @claude-flow/cli@latest hooks route --task "" # Route to agent
164
+ npx @claude-flow/cli@latest doctor --fix # Diagnostics
165
+ npx @claude-flow/cli@latest security scan # Security scan
166
+ npx @claude-flow/cli@latest performance benchmark # Benchmarks
167
+ \`\`\`
168
+
169
169
  26 commands, 140+ subcommands. Use \`--help\` on any command for details.`;
170
170
  }
171
171
  function setupAndBoundary() {
172
- return `## Setup
173
-
174
- \`\`\`bash
175
- claude mcp add claude-flow -- npx -y @claude-flow/cli@latest
176
- npx @claude-flow/cli@latest daemon start
177
- npx @claude-flow/cli@latest doctor --fix
178
- \`\`\`
179
-
172
+ return `## Setup
173
+
174
+ \`\`\`bash
175
+ claude mcp add claude-flow -- npx -y @claude-flow/cli@latest
176
+ npx @claude-flow/cli@latest daemon start
177
+ npx @claude-flow/cli@latest doctor --fix
178
+ \`\`\`
179
+
180
180
  **Agent tool** handles execution (agents, files, code, git). **MCP tools** handle coordination (swarm, memory, hooks). **CLI** is the same via Bash.`;
181
181
  }
182
182
  function buildAndTest() {
183
- return `## Build & Test
184
-
185
- - ALWAYS run tests after code changes
186
- - ALWAYS verify build succeeds before committing
187
-
188
- \`\`\`bash
189
- npm run build && npm test
183
+ return `## Build & Test
184
+
185
+ - ALWAYS run tests after code changes
186
+ - ALWAYS verify build succeeds before committing
187
+
188
+ \`\`\`bash
189
+ npm run build && npm test
190
190
  \`\`\``;
191
191
  }
192
192
  function securitySection() {
193
- return `## Security
194
-
195
- - NEVER hardcode secrets in source — use environment variables
196
- - Always validate input at boundaries (Zod schemas)
197
- - Always sanitize file paths (prevent traversal)
198
- - Always use parameterized queries (prevent injection)
199
-
200
- \`\`\`bash
201
- npx @claude-flow/cli@latest security scan --depth full
202
- npx @claude-flow/cli@latest security audit --report
203
- \`\`\`
204
-
193
+ return `## Security
194
+
195
+ - NEVER hardcode secrets in source — use environment variables
196
+ - Always validate input at boundaries (Zod schemas)
197
+ - Always sanitize file paths (prevent traversal)
198
+ - Always use parameterized queries (prevent injection)
199
+
200
+ \`\`\`bash
201
+ npx @claude-flow/cli@latest security scan --depth full
202
+ npx @claude-flow/cli@latest security audit --report
203
+ \`\`\`
204
+
205
205
  Agents: \`security-architect\` (threat modeling), \`security-auditor\` (vulnerability detection)`;
206
206
  }
207
207
  function performanceSection() {
208
- return `## Performance
209
-
210
- - Always benchmark before AND after optimization
211
- - Always profile before optimizing — never guess bottlenecks
212
- - Use HNSW/DiskANN for vector search, Int8 quantization for memory reduction
213
-
214
- \`\`\`bash
215
- npx @claude-flow/cli@latest performance benchmark --suite all
216
- npx @claude-flow/cli@latest performance profile --target "[component]"
217
- \`\`\`
218
-
208
+ return `## Performance
209
+
210
+ - Always benchmark before AND after optimization
211
+ - Always profile before optimizing — never guess bottlenecks
212
+ - Use HNSW/DiskANN for vector search, Int8 quantization for memory reduction
213
+
214
+ \`\`\`bash
215
+ npx @claude-flow/cli@latest performance benchmark --suite all
216
+ npx @claude-flow/cli@latest performance profile --target "[component]"
217
+ \`\`\`
218
+
219
219
  Agents: \`performance-engineer\` (profiling), \`perf-analyzer\` (bottleneck detection)`;
220
220
  }
221
221
  function hooksRef() {
222
- return `## Hooks
223
-
224
- | Hook | Purpose |
225
- |------|---------|
226
- | \`pre-task\` / \`post-task\` | Task lifecycle + learning |
227
- | \`pre-edit\` / \`post-edit\` | File editing + neural training |
228
- | \`session-start\` / \`session-end\` | Session persistence |
229
- | \`route\` | Route to optimal agent |
230
- | \`intelligence\` | Pattern learning (SONA) |
231
- | \`worker\` | Background worker dispatch |
232
-
233
- \`\`\`bash
234
- npx @claude-flow/cli@latest hooks pre-task --description "[task]"
235
- npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true
236
- npx @claude-flow/cli@latest hooks session-start --session-id "[id]"
237
- npx @claude-flow/cli@latest hooks route --task "[task]"
238
- npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
222
+ return `## Hooks
223
+
224
+ | Hook | Purpose |
225
+ |------|---------|
226
+ | \`pre-task\` / \`post-task\` | Task lifecycle + learning |
227
+ | \`pre-edit\` / \`post-edit\` | File editing + neural training |
228
+ | \`session-start\` / \`session-end\` | Session persistence |
229
+ | \`route\` | Route to optimal agent |
230
+ | \`intelligence\` | Pattern learning (SONA) |
231
+ | \`worker\` | Background worker dispatch |
232
+
233
+ \`\`\`bash
234
+ npx @claude-flow/cli@latest hooks pre-task --description "[task]"
235
+ npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true
236
+ npx @claude-flow/cli@latest hooks session-start --session-id "[id]"
237
+ npx @claude-flow/cli@latest hooks route --task "[task]"
238
+ npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
239
239
  \`\`\``;
240
240
  }
241
241
  function intelligenceSystem() {
242
- return `## Intelligence (SONA + HNSW)
243
-
244
- Pipeline: **RETRIEVE** (vector search) → **JUDGE** (success/failure) → **DISTILL** (extract patterns) → **CONSOLIDATE** (persist)
245
-
246
- - **ONNX Embeddings**: all-MiniLM-L6-v2, 384-dim
247
- - **HNSW/DiskANN**: 150x-12,500x faster search
248
- - **SONA**: Sub-millisecond pattern adaptation
242
+ return `## Intelligence (SONA + HNSW)
243
+
244
+ Pipeline: **RETRIEVE** (vector search) → **JUDGE** (success/failure) → **DISTILL** (extract patterns) → **CONSOLIDATE** (persist)
245
+
246
+ - **ONNX Embeddings**: all-MiniLM-L6-v2, 384-dim
247
+ - **HNSW/DiskANN**: 150x-12,500x faster search
248
+ - **SONA**: Sub-millisecond pattern adaptation
249
249
  - **Claude Bridge**: Auto-imports \`~/.claude/projects/*/memory/*.md\` into AgentDB`;
250
250
  }
251
251
  function federationRef() {
252
- return `## Federation
253
-
254
- Cross-installation agent collaboration with zero-trust security.
255
-
256
- \`\`\`bash
257
- npx @claude-flow/cli@latest federation init
258
- npx @claude-flow/cli@latest federation join wss://peer:8443
259
- npx @claude-flow/cli@latest federation send --to peer --type task-request --message "..."
260
- npx @claude-flow/cli@latest federation status
261
- \`\`\`
262
-
263
- - 5-tier trust: UNTRUSTED → VERIFIED → ATTESTED → TRUSTED → PRIVILEGED
264
- - PII pipeline: 14 types auto-stripped before data leaves your node
265
- - mTLS + ed25519 handshake, HMAC-signed envelopes
252
+ return `## Federation
253
+
254
+ Cross-installation agent collaboration with zero-trust security.
255
+
256
+ \`\`\`bash
257
+ npx @claude-flow/cli@latest federation init
258
+ npx @claude-flow/cli@latest federation join wss://peer:8443
259
+ npx @claude-flow/cli@latest federation send --to peer --type task-request --message "..."
260
+ npx @claude-flow/cli@latest federation status
261
+ \`\`\`
262
+
263
+ - 5-tier trust: UNTRUSTED → VERIFIED → ATTESTED → TRUSTED → PRIVILEGED
264
+ - PII pipeline: 14 types auto-stripped before data leaves your node
265
+ - mTLS + ed25519 handshake, HMAC-signed envelopes
266
266
  - Compliance: HIPAA, SOC2, GDPR audit modes`;
267
267
  }
268
268
  function envVars() {
269
- return `## Environment
270
-
271
- \`\`\`bash
272
- CLAUDE_FLOW_CONFIG=./claude-flow.config.json
273
- CLAUDE_FLOW_LOG_LEVEL=info
274
- CLAUDE_FLOW_MEMORY_BACKEND=hybrid
275
- CLAUDE_FLOW_MEMORY_PATH=./data/memory
269
+ return `## Environment
270
+
271
+ \`\`\`bash
272
+ CLAUDE_FLOW_CONFIG=./claude-flow.config.json
273
+ CLAUDE_FLOW_LOG_LEVEL=info
274
+ CLAUDE_FLOW_MEMORY_BACKEND=hybrid
275
+ CLAUDE_FLOW_MEMORY_PATH=./data/memory
276
276
  \`\`\``;
277
277
  }
278
278
  // --- Template Composers ---