claude-flow 3.28.0 → 3.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (690) hide show
  1. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  2. package/.claude/agents/analysis/analyze-code-quality.md +57 -57
  3. package/.claude/agents/analysis/code-analyzer.md +188 -188
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
  6. package/.claude/agents/base-template-generator.md +41 -41
  7. package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
  8. package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
  9. package/.claude/agents/consensus/gossip-coordinator.md +42 -42
  10. package/.claude/agents/consensus/performance-benchmarker.md +830 -830
  11. package/.claude/agents/consensus/quorum-manager.md +802 -802
  12. package/.claude/agents/consensus/raft-manager.md +42 -42
  13. package/.claude/agents/consensus/security-manager.md +601 -601
  14. package/.claude/agents/core/coder.md +254 -254
  15. package/.claude/agents/core/planner.md +151 -151
  16. package/.claude/agents/core/researcher.md +173 -173
  17. package/.claude/agents/core/reviewer.md +308 -308
  18. package/.claude/agents/core/tester.md +299 -299
  19. package/.claude/agents/custom/test-long-runner.md +43 -43
  20. package/.claude/agents/data/ml/data-ml-model.md +75 -75
  21. package/.claude/agents/database-specialist.md +9 -9
  22. package/.claude/agents/development/backend/dev-backend-api.md +28 -28
  23. package/.claude/agents/development/dev-backend-api.md +177 -177
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
  25. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
  26. package/.claude/agents/dual-mode/codex-coordinator.md +206 -206
  27. package/.claude/agents/dual-mode/codex-worker.md +190 -190
  28. package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
  29. package/.claude/agents/flow-nexus/app-store.md +87 -87
  30. package/.claude/agents/flow-nexus/authentication.md +68 -68
  31. package/.claude/agents/flow-nexus/challenges.md +80 -80
  32. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  33. package/.claude/agents/flow-nexus/payments.md +82 -82
  34. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  35. package/.claude/agents/flow-nexus/swarm.md +75 -75
  36. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  37. package/.claude/agents/flow-nexus/workflow.md +83 -83
  38. package/.claude/agents/github/code-review-swarm.md +520 -520
  39. package/.claude/agents/github/github-modes.md +153 -153
  40. package/.claude/agents/github/issue-tracker.md +298 -298
  41. package/.claude/agents/github/multi-repo-swarm.md +524 -524
  42. package/.claude/agents/github/pr-manager.md +162 -162
  43. package/.claude/agents/github/project-board-sync.md +477 -477
  44. package/.claude/agents/github/release-manager.md +337 -337
  45. package/.claude/agents/github/release-swarm.md +550 -550
  46. package/.claude/agents/github/repo-architect.md +364 -364
  47. package/.claude/agents/github/swarm-issue.md +550 -550
  48. package/.claude/agents/github/swarm-pr.md +401 -401
  49. package/.claude/agents/github/sync-coordinator.md +424 -424
  50. package/.claude/agents/github/workflow-automation.md +604 -604
  51. package/.claude/agents/goal/agent.md +816 -816
  52. package/.claude/agents/goal/code-goal-planner.md +444 -444
  53. package/.claude/agents/goal/goal-planner.md +167 -167
  54. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
  55. package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
  56. package/.claude/agents/hive-mind/scout-explorer.md +240 -240
  57. package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
  58. package/.claude/agents/hive-mind/worker-specialist.md +215 -215
  59. package/.claude/agents/neural/safla-neural.md +73 -73
  60. package/.claude/agents/optimization/benchmark-suite.md +662 -662
  61. package/.claude/agents/optimization/load-balancer.md +428 -428
  62. package/.claude/agents/optimization/performance-monitor.md +669 -669
  63. package/.claude/agents/optimization/resource-allocator.md +671 -671
  64. package/.claude/agents/optimization/topology-optimizer.md +805 -805
  65. package/.claude/agents/payments/agentic-payments.md +126 -126
  66. package/.claude/agents/project-coordinator.md +8 -8
  67. package/.claude/agents/python-specialist.md +9 -9
  68. package/.claude/agents/reasoning/agent.md +816 -816
  69. package/.claude/agents/reasoning/goal-planner.md +72 -72
  70. package/.claude/agents/security-auditor.md +9 -9
  71. package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
  72. package/.claude/agents/sparc/architecture.md +452 -452
  73. package/.claude/agents/sparc/pseudocode.md +298 -298
  74. package/.claude/agents/sparc/refinement.md +503 -503
  75. package/.claude/agents/sparc/specification.md +257 -257
  76. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
  77. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  78. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  79. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  80. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  81. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  82. package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
  83. package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
  84. package/.claude/agents/swarm/mesh-coordinator.md +362 -362
  85. package/.claude/agents/templates/automation-smart-agent.md +184 -184
  86. package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
  87. package/.claude/agents/templates/github-pr-manager.md +154 -154
  88. package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
  89. package/.claude/agents/templates/memory-coordinator.md +162 -162
  90. package/.claude/agents/templates/migration-plan.md +723 -723
  91. package/.claude/agents/templates/orchestrator-task.md +119 -119
  92. package/.claude/agents/templates/performance-analyzer.md +178 -178
  93. package/.claude/agents/templates/sparc-coordinator.md +162 -162
  94. package/.claude/agents/testing/production-validator.md +372 -372
  95. package/.claude/agents/testing/tdd-london-swarm.md +221 -221
  96. package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
  97. package/.claude/agents/testing/validation/production-validator.md +372 -372
  98. package/.claude/agents/typescript-specialist.md +9 -9
  99. package/.claude/agents/v3/database-specialist.md +9 -9
  100. package/.claude/agents/v3/project-coordinator.md +8 -8
  101. package/.claude/agents/v3/python-specialist.md +9 -9
  102. package/.claude/agents/v3/test-architect.md +9 -9
  103. package/.claude/agents/v3/typescript-specialist.md +9 -9
  104. package/.claude/agents/v3/v3-integration-architect.md +311 -311
  105. package/.claude/agents/v3/v3-memory-specialist.md +280 -280
  106. package/.claude/agents/v3/v3-performance-engineer.md +362 -362
  107. package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
  108. package/.claude/agents/v3/v3-security-architect.md +139 -139
  109. package/.claude/checkpoints/1767754460.json +8 -8
  110. package/.claude/commands/agents/README.md +10 -10
  111. package/.claude/commands/agents/agent-capabilities.md +21 -21
  112. package/.claude/commands/agents/agent-coordination.md +28 -28
  113. package/.claude/commands/agents/agent-spawning.md +28 -28
  114. package/.claude/commands/agents/agent-types.md +26 -26
  115. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  116. package/.claude/commands/analysis/README.md +9 -9
  117. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  118. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  119. package/.claude/commands/analysis/performance-report.md +25 -25
  120. package/.claude/commands/analysis/token-efficiency.md +44 -44
  121. package/.claude/commands/analysis/token-usage.md +25 -25
  122. package/.claude/commands/automation/README.md +9 -9
  123. package/.claude/commands/automation/auto-agent.md +122 -122
  124. package/.claude/commands/automation/self-healing.md +105 -105
  125. package/.claude/commands/automation/session-memory.md +89 -89
  126. package/.claude/commands/automation/smart-agents.md +72 -72
  127. package/.claude/commands/automation/smart-spawn.md +25 -25
  128. package/.claude/commands/automation/workflow-select.md +25 -25
  129. package/.claude/commands/claude-flow-help.md +103 -103
  130. package/.claude/commands/claude-flow-memory.md +107 -107
  131. package/.claude/commands/claude-flow-swarm.md +205 -205
  132. package/.claude/commands/coordination/README.md +9 -9
  133. package/.claude/commands/coordination/agent-spawn.md +25 -25
  134. package/.claude/commands/coordination/init.md +44 -44
  135. package/.claude/commands/coordination/orchestrate.md +43 -43
  136. package/.claude/commands/coordination/spawn.md +45 -45
  137. package/.claude/commands/coordination/swarm-init.md +85 -85
  138. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  139. package/.claude/commands/flow-nexus/app-store.md +123 -123
  140. package/.claude/commands/flow-nexus/challenges.md +119 -119
  141. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  142. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  143. package/.claude/commands/flow-nexus/payments.md +115 -115
  144. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  145. package/.claude/commands/flow-nexus/swarm.md +86 -86
  146. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  147. package/.claude/commands/flow-nexus/workflow.md +114 -114
  148. package/.claude/commands/github/README.md +11 -11
  149. package/.claude/commands/github/code-review-swarm.md +513 -513
  150. package/.claude/commands/github/code-review.md +25 -25
  151. package/.claude/commands/github/github-modes.md +146 -146
  152. package/.claude/commands/github/github-swarm.md +121 -121
  153. package/.claude/commands/github/issue-tracker.md +291 -291
  154. package/.claude/commands/github/issue-triage.md +25 -25
  155. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  156. package/.claude/commands/github/pr-enhance.md +26 -26
  157. package/.claude/commands/github/pr-manager.md +169 -169
  158. package/.claude/commands/github/project-board-sync.md +470 -470
  159. package/.claude/commands/github/release-manager.md +337 -337
  160. package/.claude/commands/github/release-swarm.md +543 -543
  161. package/.claude/commands/github/repo-analyze.md +25 -25
  162. package/.claude/commands/github/repo-architect.md +366 -366
  163. package/.claude/commands/github/swarm-issue.md +481 -481
  164. package/.claude/commands/github/swarm-pr.md +284 -284
  165. package/.claude/commands/github/sync-coordinator.md +300 -300
  166. package/.claude/commands/github/workflow-automation.md +441 -441
  167. package/.claude/commands/hive-mind/README.md +17 -17
  168. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  170. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  173. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  175. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  177. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  178. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  179. package/.claude/commands/hooks/README.md +11 -11
  180. package/.claude/commands/hooks/overview.md +57 -57
  181. package/.claude/commands/hooks/post-edit.md +117 -117
  182. package/.claude/commands/hooks/post-task.md +112 -112
  183. package/.claude/commands/hooks/pre-edit.md +113 -113
  184. package/.claude/commands/hooks/pre-task.md +111 -111
  185. package/.claude/commands/hooks/session-end.md +118 -118
  186. package/.claude/commands/hooks/setup.md +102 -102
  187. package/.claude/commands/memory/README.md +9 -9
  188. package/.claude/commands/memory/memory-persist.md +25 -25
  189. package/.claude/commands/memory/memory-search.md +25 -25
  190. package/.claude/commands/memory/memory-usage.md +25 -25
  191. package/.claude/commands/memory/neural.md +47 -47
  192. package/.claude/commands/monitoring/README.md +9 -9
  193. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  194. package/.claude/commands/monitoring/agents.md +44 -44
  195. package/.claude/commands/monitoring/real-time-view.md +25 -25
  196. package/.claude/commands/monitoring/status.md +46 -46
  197. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  198. package/.claude/commands/optimization/README.md +9 -9
  199. package/.claude/commands/optimization/auto-topology.md +61 -61
  200. package/.claude/commands/optimization/cache-manage.md +25 -25
  201. package/.claude/commands/optimization/parallel-execute.md +25 -25
  202. package/.claude/commands/optimization/parallel-execution.md +49 -49
  203. package/.claude/commands/optimization/topology-optimize.md +25 -25
  204. package/.claude/commands/pair/README.md +260 -260
  205. package/.claude/commands/pair/commands.md +545 -545
  206. package/.claude/commands/pair/config.md +509 -509
  207. package/.claude/commands/pair/examples.md +511 -511
  208. package/.claude/commands/pair/modes.md +347 -347
  209. package/.claude/commands/pair/session.md +406 -406
  210. package/.claude/commands/pair/start.md +208 -208
  211. package/.claude/commands/sparc/analyzer.md +51 -51
  212. package/.claude/commands/sparc/architect.md +53 -53
  213. package/.claude/commands/sparc/ask.md +97 -97
  214. package/.claude/commands/sparc/batch-executor.md +54 -54
  215. package/.claude/commands/sparc/code.md +89 -89
  216. package/.claude/commands/sparc/coder.md +54 -54
  217. package/.claude/commands/sparc/debug.md +83 -83
  218. package/.claude/commands/sparc/debugger.md +54 -54
  219. package/.claude/commands/sparc/designer.md +53 -53
  220. package/.claude/commands/sparc/devops.md +109 -109
  221. package/.claude/commands/sparc/docs-writer.md +80 -80
  222. package/.claude/commands/sparc/documenter.md +54 -54
  223. package/.claude/commands/sparc/innovator.md +54 -54
  224. package/.claude/commands/sparc/integration.md +83 -83
  225. package/.claude/commands/sparc/mcp.md +117 -117
  226. package/.claude/commands/sparc/memory-manager.md +54 -54
  227. package/.claude/commands/sparc/optimizer.md +54 -54
  228. package/.claude/commands/sparc/orchestrator.md +131 -131
  229. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  230. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  231. package/.claude/commands/sparc/researcher.md +54 -54
  232. package/.claude/commands/sparc/reviewer.md +54 -54
  233. package/.claude/commands/sparc/security-review.md +80 -80
  234. package/.claude/commands/sparc/sparc-modes.md +174 -174
  235. package/.claude/commands/sparc/sparc.md +111 -111
  236. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  237. package/.claude/commands/sparc/supabase-admin.md +348 -348
  238. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  239. package/.claude/commands/sparc/tdd.md +54 -54
  240. package/.claude/commands/sparc/tester.md +54 -54
  241. package/.claude/commands/sparc/tutorial.md +79 -79
  242. package/.claude/commands/sparc/workflow-manager.md +54 -54
  243. package/.claude/commands/sparc.md +166 -166
  244. package/.claude/commands/stream-chain/pipeline.md +120 -120
  245. package/.claude/commands/stream-chain/run.md +69 -69
  246. package/.claude/commands/swarm/README.md +15 -15
  247. package/.claude/commands/swarm/analysis.md +95 -95
  248. package/.claude/commands/swarm/development.md +96 -96
  249. package/.claude/commands/swarm/examples.md +168 -168
  250. package/.claude/commands/swarm/maintenance.md +102 -102
  251. package/.claude/commands/swarm/optimization.md +117 -117
  252. package/.claude/commands/swarm/research.md +136 -136
  253. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  254. package/.claude/commands/swarm/swarm-background.md +8 -8
  255. package/.claude/commands/swarm/swarm-init.md +19 -19
  256. package/.claude/commands/swarm/swarm-modes.md +8 -8
  257. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  258. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  259. package/.claude/commands/swarm/swarm-status.md +8 -8
  260. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  261. package/.claude/commands/swarm/swarm.md +27 -27
  262. package/.claude/commands/swarm/testing.md +131 -131
  263. package/.claude/commands/training/README.md +9 -9
  264. package/.claude/commands/training/model-update.md +25 -25
  265. package/.claude/commands/training/neural-patterns.md +73 -73
  266. package/.claude/commands/training/neural-train.md +25 -25
  267. package/.claude/commands/training/pattern-learn.md +25 -25
  268. package/.claude/commands/training/specialization.md +62 -62
  269. package/.claude/commands/truth/start.md +142 -142
  270. package/.claude/commands/verify/check.md +49 -49
  271. package/.claude/commands/verify/start.md +127 -127
  272. package/.claude/commands/workflows/README.md +9 -9
  273. package/.claude/commands/workflows/development.md +77 -77
  274. package/.claude/commands/workflows/research.md +62 -62
  275. package/.claude/commands/workflows/workflow-create.md +25 -25
  276. package/.claude/commands/workflows/workflow-execute.md +25 -25
  277. package/.claude/commands/workflows/workflow-export.md +25 -25
  278. package/.claude/config/v3-dependency-optimization.json +265 -265
  279. package/.claude/config/v3-performance-targets.json +250 -250
  280. package/.claude/helpers/.LOCKED +2 -0
  281. package/.claude/helpers/.helpers-version +1 -1
  282. package/.claude/helpers/README.md +96 -96
  283. package/.claude/helpers/adr-compliance.sh +186 -186
  284. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  285. package/.claude/helpers/auto-commit.sh +178 -178
  286. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  287. package/.claude/helpers/checkpoint-manager.sh +251 -251
  288. package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
  289. package/.claude/helpers/daemon-manager.sh +252 -252
  290. package/.claude/helpers/ddd-tracker.sh +144 -144
  291. package/.claude/helpers/github-safe.js +156 -156
  292. package/.claude/helpers/github-setup.sh +45 -45
  293. package/.claude/helpers/guidance-hook.sh +13 -13
  294. package/.claude/helpers/guidance-hooks.sh +102 -102
  295. package/.claude/helpers/health-monitor.sh +108 -108
  296. package/.claude/helpers/helpers.manifest.json +6 -5
  297. package/.claude/helpers/hook-handler.cjs +564 -460
  298. package/.claude/helpers/intelligence.cjs +1058 -1058
  299. package/.claude/helpers/learning-hooks.sh +329 -329
  300. package/.claude/helpers/learning-optimizer.sh +127 -127
  301. package/.claude/helpers/learning-service.mjs +1144 -1144
  302. package/.claude/helpers/memory.cjs +84 -84
  303. package/.claude/helpers/metrics-db.mjs +503 -503
  304. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  305. package/.claude/helpers/pattern-consolidator.sh +86 -86
  306. package/.claude/helpers/perf-worker.sh +160 -160
  307. package/.claude/helpers/quick-start.sh +19 -19
  308. package/.claude/helpers/router.cjs +62 -62
  309. package/.claude/helpers/security-scanner.sh +127 -127
  310. package/.claude/helpers/session.cjs +125 -125
  311. package/.claude/helpers/setup-mcp.sh +18 -18
  312. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  313. package/.claude/helpers/statusline.cjs +999 -925
  314. package/.claude/helpers/swarm-comms.sh +353 -353
  315. package/.claude/helpers/swarm-hooks.sh +761 -761
  316. package/.claude/helpers/swarm-monitor.sh +210 -210
  317. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  318. package/.claude/helpers/update-v3-progress.sh +165 -165
  319. package/.claude/helpers/v3-quick-status.sh +57 -57
  320. package/.claude/helpers/v3.sh +110 -110
  321. package/.claude/helpers/validate-v3-config.sh +215 -215
  322. package/.claude/helpers/worker-manager.sh +170 -170
  323. package/.claude/mcp.json +12 -12
  324. package/.claude/proven-config.json +1 -1
  325. package/.claude/settings.json +285 -285
  326. package/.claude/settings.json.bak +526 -526
  327. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  328. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  329. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  330. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  331. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  332. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  333. package/.claude/skills/browser/SKILL.md +204 -204
  334. package/.claude/skills/dual-mode/README.md +71 -71
  335. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  336. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  337. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  338. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  339. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  340. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  341. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  342. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  343. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  344. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  345. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  346. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  347. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  348. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  349. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  350. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  351. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  352. package/.claude/skills/skill-builder/SKILL.md +910 -910
  353. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  354. package/.claude/skills/stream-chain/SKILL.md +560 -560
  355. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  356. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  357. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  358. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  359. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  360. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  361. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  362. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  363. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  364. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  365. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  366. package/.claude/skills/verification-quality/SKILL.md +691 -691
  367. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  368. package/.claude/skills/worker-integration/SKILL.md +147 -147
  369. package/.claude/statusline-command.sh +176 -176
  370. package/.claude/statusline.mjs +109 -109
  371. package/.claude/statusline.sh +431 -431
  372. package/.claude/workflows/full-system-test.js +65 -65
  373. package/.claude/workflows/intelligence-system-hardening.js +120 -120
  374. package/.claude/workflows/plugin-contract-audit.js +91 -91
  375. package/.claude-plugin/README.md +720 -720
  376. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  377. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  378. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  379. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  380. package/.claude-plugin/hooks/hooks.json +77 -77
  381. package/.claude-plugin/marketplace.json +185 -185
  382. package/.claude-plugin/plugin.json +71 -71
  383. package/.claude-plugin/scripts/install.sh +234 -234
  384. package/.claude-plugin/scripts/ruflo-hook.cjs +166 -166
  385. package/.claude-plugin/scripts/ruflo-hook.sh +37 -37
  386. package/.claude-plugin/scripts/uninstall.sh +36 -36
  387. package/.claude-plugin/scripts/verify.sh +108 -108
  388. package/LICENSE +21 -21
  389. package/README.md +419 -419
  390. package/bin/cli.js +11 -11
  391. package/bin/npx-repair.js +7 -7
  392. package/bin/npx-safe-launch.js +9 -9
  393. package/package.json +185 -185
  394. package/v3/@claude-flow/cli/README.md +419 -419
  395. package/v3/@claude-flow/cli/bin/cli.js +314 -314
  396. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  397. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  398. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  399. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
  400. package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  401. package/v3/@claude-flow/cli/dist/src/commands/announcements.d.ts +17 -0
  402. package/v3/@claude-flow/cli/dist/src/commands/announcements.js +0 -0
  403. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  404. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
  405. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  406. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +10 -5
  407. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +206 -7
  408. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  409. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  410. package/v3/@claude-flow/cli/dist/src/commands/index.js +4 -0
  411. package/v3/@claude-flow/cli/dist/src/commands/init.js +94 -38
  412. package/v3/@claude-flow/cli/dist/src/commands/memory.js +85 -1
  413. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  414. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  415. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  416. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  417. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  418. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  419. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  420. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  421. package/v3/@claude-flow/cli/dist/src/commands/spinner.d.ts +16 -0
  422. package/v3/@claude-flow/cli/dist/src/commands/spinner.js +329 -0
  423. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  424. package/v3/@claude-flow/cli/dist/src/funnel/consent.js +3 -0
  425. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +1 -0
  426. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +12 -0
  427. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +2 -1
  428. package/v3/@claude-flow/cli/dist/src/funnel/index.js +2 -1
  429. package/v3/@claude-flow/cli/dist/src/funnel/payout.d.ts +40 -0
  430. package/v3/@claude-flow/cli/dist/src/funnel/payout.js +60 -0
  431. package/v3/@claude-flow/cli/dist/src/funnel/types.d.ts +13 -1
  432. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
  433. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  434. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.js +17 -0
  435. package/v3/@claude-flow/cli/dist/src/init/helper-signing.d.ts +8 -1
  436. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +9 -2
  437. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
  438. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +955 -949
  439. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  440. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  441. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +22 -22
  442. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.d.ts +10 -0
  443. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +139 -88
  444. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +18 -0
  445. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +539 -407
  446. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  447. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  448. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.d.ts +195 -0
  449. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.js +643 -0
  450. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.d.ts +206 -0
  451. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.js +626 -0
  452. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  453. package/v3/@claude-flow/cli/dist/src/services/event-stream.d.ts +25 -0
  454. package/v3/@claude-flow/cli/dist/src/services/event-stream.js +27 -0
  455. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  456. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.d.ts +16 -0
  457. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.js +34 -0
  458. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
  459. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.d.ts +22 -0
  460. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.js +45 -0
  461. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  462. package/v3/@claude-flow/cli/package.json +134 -133
  463. package/v3/@claude-flow/guidance/README.md +1195 -1195
  464. package/v3/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
  465. package/v3/@claude-flow/guidance/dist/adversarial.js +572 -0
  466. package/v3/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
  467. package/v3/@claude-flow/guidance/dist/analyzer.js +2587 -0
  468. package/v3/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
  469. package/v3/@claude-flow/guidance/dist/artifacts.js +356 -0
  470. package/v3/@claude-flow/guidance/dist/authority.d.ts +290 -0
  471. package/v3/@claude-flow/guidance/dist/authority.js +558 -0
  472. package/v3/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
  473. package/v3/@claude-flow/guidance/dist/capabilities.js +485 -0
  474. package/v3/@claude-flow/guidance/dist/coherence.d.ts +233 -0
  475. package/v3/@claude-flow/guidance/dist/coherence.js +372 -0
  476. package/v3/@claude-flow/guidance/dist/compiler.d.ts +87 -0
  477. package/v3/@claude-flow/guidance/dist/compiler.js +410 -0
  478. package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
  479. package/v3/@claude-flow/guidance/dist/conformance-kit.js +629 -0
  480. package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
  481. package/v3/@claude-flow/guidance/dist/continue-gate.js +353 -0
  482. package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
  483. package/v3/@claude-flow/guidance/dist/crypto-utils.js +24 -0
  484. package/v3/@claude-flow/guidance/dist/evolution.d.ts +282 -0
  485. package/v3/@claude-flow/guidance/dist/evolution.js +500 -0
  486. package/v3/@claude-flow/guidance/dist/gates.d.ts +79 -0
  487. package/v3/@claude-flow/guidance/dist/gates.js +302 -0
  488. package/v3/@claude-flow/guidance/dist/gateway.d.ts +206 -0
  489. package/v3/@claude-flow/guidance/dist/gateway.js +452 -0
  490. package/v3/@claude-flow/guidance/dist/generators.d.ts +153 -0
  491. package/v3/@claude-flow/guidance/dist/generators.js +682 -0
  492. package/v3/@claude-flow/guidance/dist/headless.d.ts +177 -0
  493. package/v3/@claude-flow/guidance/dist/headless.js +342 -0
  494. package/v3/@claude-flow/guidance/dist/hooks.d.ts +109 -0
  495. package/v3/@claude-flow/guidance/dist/hooks.js +347 -0
  496. package/v3/@claude-flow/guidance/dist/index.d.ts +205 -0
  497. package/v3/@claude-flow/guidance/dist/index.js +321 -0
  498. package/v3/@claude-flow/guidance/dist/ledger.d.ts +162 -0
  499. package/v3/@claude-flow/guidance/dist/ledger.js +375 -0
  500. package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
  501. package/v3/@claude-flow/guidance/dist/manifest-validator.js +838 -0
  502. package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
  503. package/v3/@claude-flow/guidance/dist/memory-gate.js +382 -0
  504. package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
  505. package/v3/@claude-flow/guidance/dist/meta-governance.js +348 -0
  506. package/v3/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
  507. package/v3/@claude-flow/guidance/dist/optimizer.js +329 -0
  508. package/v3/@claude-flow/guidance/dist/persistence.d.ts +189 -0
  509. package/v3/@claude-flow/guidance/dist/persistence.js +464 -0
  510. package/v3/@claude-flow/guidance/dist/proof.d.ts +185 -0
  511. package/v3/@claude-flow/guidance/dist/proof.js +238 -0
  512. package/v3/@claude-flow/guidance/dist/retriever.d.ts +172 -0
  513. package/v3/@claude-flow/guidance/dist/retriever.js +596 -0
  514. package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
  515. package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
  516. package/v3/@claude-flow/guidance/dist/temporal.d.ts +426 -0
  517. package/v3/@claude-flow/guidance/dist/temporal.js +658 -0
  518. package/v3/@claude-flow/guidance/dist/trust.d.ts +283 -0
  519. package/v3/@claude-flow/guidance/dist/trust.js +473 -0
  520. package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
  521. package/v3/@claude-flow/guidance/dist/truth-anchors.js +488 -0
  522. package/v3/@claude-flow/guidance/dist/types.d.ts +378 -0
  523. package/v3/@claude-flow/guidance/dist/types.js +10 -0
  524. package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
  525. package/v3/@claude-flow/guidance/dist/uncertainty.js +619 -0
  526. package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
  527. package/v3/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
  528. package/v3/@claude-flow/guidance/package.json +198 -198
  529. package/v3/@claude-flow/shared/README.md +323 -323
  530. package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +41 -0
  531. package/v3/@claude-flow/shared/dist/core/config/defaults.js +186 -0
  532. package/v3/@claude-flow/shared/dist/core/config/index.d.ts +8 -0
  533. package/v3/@claude-flow/shared/dist/core/config/index.js +12 -0
  534. package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +45 -0
  535. package/v3/@claude-flow/shared/dist/core/config/loader.js +238 -0
  536. package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +1728 -0
  537. package/v3/@claude-flow/shared/dist/core/config/schema.js +160 -0
  538. package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +92 -0
  539. package/v3/@claude-flow/shared/dist/core/config/validator.js +147 -0
  540. package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +31 -0
  541. package/v3/@claude-flow/shared/dist/core/event-bus.js +197 -0
  542. package/v3/@claude-flow/shared/dist/core/index.d.ts +15 -0
  543. package/v3/@claude-flow/shared/dist/core/index.js +19 -0
  544. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +200 -0
  545. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +6 -0
  546. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +310 -0
  547. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +7 -0
  548. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +224 -0
  549. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +46 -0
  550. package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +10 -0
  551. package/v3/@claude-flow/shared/dist/core/interfaces/index.js +15 -0
  552. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +298 -0
  553. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +7 -0
  554. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +185 -0
  555. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +6 -0
  556. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +35 -0
  557. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +101 -0
  558. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +60 -0
  559. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +166 -0
  560. package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +46 -0
  561. package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +64 -0
  562. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
  563. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +195 -0
  564. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +83 -0
  565. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +193 -0
  566. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +49 -0
  567. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +253 -0
  568. package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +282 -0
  569. package/v3/@claude-flow/shared/dist/events/domain-events.js +165 -0
  570. package/v3/@claude-flow/shared/dist/events/event-store.d.ts +126 -0
  571. package/v3/@claude-flow/shared/dist/events/event-store.js +427 -0
  572. package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +8 -0
  573. package/v3/@claude-flow/shared/dist/events/event-store.test.js +293 -0
  574. package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +10 -0
  575. package/v3/@claude-flow/shared/dist/events/example-usage.js +193 -0
  576. package/v3/@claude-flow/shared/dist/events/index.d.ts +21 -0
  577. package/v3/@claude-flow/shared/dist/events/index.js +22 -0
  578. package/v3/@claude-flow/shared/dist/events/projections.d.ts +177 -0
  579. package/v3/@claude-flow/shared/dist/events/projections.js +421 -0
  580. package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +82 -0
  581. package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +340 -0
  582. package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +101 -0
  583. package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +263 -0
  584. package/v3/@claude-flow/shared/dist/events.d.ts +80 -0
  585. package/v3/@claude-flow/shared/dist/events.js +249 -0
  586. package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +42 -0
  587. package/v3/@claude-flow/shared/dist/hooks/example-usage.js +351 -0
  588. package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +100 -0
  589. package/v3/@claude-flow/shared/dist/hooks/executor.js +267 -0
  590. package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +9 -0
  591. package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +322 -0
  592. package/v3/@claude-flow/shared/dist/hooks/index.d.ts +52 -0
  593. package/v3/@claude-flow/shared/dist/hooks/index.js +51 -0
  594. package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +133 -0
  595. package/v3/@claude-flow/shared/dist/hooks/registry.js +277 -0
  596. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +105 -0
  597. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +481 -0
  598. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +144 -0
  599. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +328 -0
  600. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +158 -0
  601. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +450 -0
  602. package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +17 -0
  603. package/v3/@claude-flow/shared/dist/hooks/safety/index.js +17 -0
  604. package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +234 -0
  605. package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +334 -0
  606. package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +163 -0
  607. package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +326 -0
  608. package/v3/@claude-flow/shared/dist/hooks/types.d.ts +267 -0
  609. package/v3/@claude-flow/shared/dist/hooks/types.js +62 -0
  610. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +9 -0
  611. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +93 -0
  612. package/v3/@claude-flow/shared/dist/index.d.ts +20 -0
  613. package/v3/@claude-flow/shared/dist/index.js +50 -0
  614. package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +98 -0
  615. package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +364 -0
  616. package/v3/@claude-flow/shared/dist/mcp/index.d.ts +69 -0
  617. package/v3/@claude-flow/shared/dist/mcp/index.js +84 -0
  618. package/v3/@claude-flow/shared/dist/mcp/server.d.ts +166 -0
  619. package/v3/@claude-flow/shared/dist/mcp/server.js +590 -0
  620. package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +136 -0
  621. package/v3/@claude-flow/shared/dist/mcp/session-manager.js +335 -0
  622. package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +178 -0
  623. package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +439 -0
  624. package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +104 -0
  625. package/v3/@claude-flow/shared/dist/mcp/transport/http.js +476 -0
  626. package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +102 -0
  627. package/v3/@claude-flow/shared/dist/mcp/transport/index.js +238 -0
  628. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +104 -0
  629. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +263 -0
  630. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +133 -0
  631. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +396 -0
  632. package/v3/@claude-flow/shared/dist/mcp/types.d.ts +436 -0
  633. package/v3/@claude-flow/shared/dist/mcp/types.js +54 -0
  634. package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +544 -0
  635. package/v3/@claude-flow/shared/dist/plugin-interface.js +23 -0
  636. package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +139 -0
  637. package/v3/@claude-flow/shared/dist/plugin-loader.js +434 -0
  638. package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +183 -0
  639. package/v3/@claude-flow/shared/dist/plugin-registry.js +457 -0
  640. package/v3/@claude-flow/shared/dist/plugins/index.d.ts +10 -0
  641. package/v3/@claude-flow/shared/dist/plugins/index.js +10 -0
  642. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
  643. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +241 -0
  644. package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +10 -0
  645. package/v3/@claude-flow/shared/dist/plugins/official/index.js +10 -0
  646. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +121 -0
  647. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +355 -0
  648. package/v3/@claude-flow/shared/dist/plugins/types.d.ts +93 -0
  649. package/v3/@claude-flow/shared/dist/plugins/types.js +9 -0
  650. package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +105 -0
  651. package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +206 -0
  652. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +132 -0
  653. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +233 -0
  654. package/v3/@claude-flow/shared/dist/resilience/index.d.ts +19 -0
  655. package/v3/@claude-flow/shared/dist/resilience/index.js +19 -0
  656. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +168 -0
  657. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +314 -0
  658. package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +91 -0
  659. package/v3/@claude-flow/shared/dist/resilience/retry.js +159 -0
  660. package/v3/@claude-flow/shared/dist/security/index.d.ts +10 -0
  661. package/v3/@claude-flow/shared/dist/security/index.js +12 -0
  662. package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +73 -0
  663. package/v3/@claude-flow/shared/dist/security/input-validation.js +201 -0
  664. package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +92 -0
  665. package/v3/@claude-flow/shared/dist/security/secure-random.js +142 -0
  666. package/v3/@claude-flow/shared/dist/services/index.d.ts +7 -0
  667. package/v3/@claude-flow/shared/dist/services/index.js +7 -0
  668. package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +124 -0
  669. package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +402 -0
  670. package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +137 -0
  671. package/v3/@claude-flow/shared/dist/types/agent.types.js +6 -0
  672. package/v3/@claude-flow/shared/dist/types/index.d.ts +11 -0
  673. package/v3/@claude-flow/shared/dist/types/index.js +17 -0
  674. package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +266 -0
  675. package/v3/@claude-flow/shared/dist/types/mcp.types.js +7 -0
  676. package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +236 -0
  677. package/v3/@claude-flow/shared/dist/types/memory.types.js +7 -0
  678. package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +186 -0
  679. package/v3/@claude-flow/shared/dist/types/swarm.types.js +65 -0
  680. package/v3/@claude-flow/shared/dist/types/task.types.d.ts +178 -0
  681. package/v3/@claude-flow/shared/dist/types/task.types.js +32 -0
  682. package/v3/@claude-flow/shared/dist/types.d.ts +197 -0
  683. package/v3/@claude-flow/shared/dist/types.js +21 -0
  684. package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +69 -0
  685. package/v3/@claude-flow/shared/dist/utils/secure-logger.js +208 -0
  686. package/v3/@claude-flow/shared/package.json +43 -43
  687. package/v3/README.md +493 -493
  688. package/.claude/security-scans/scan-all-standard.json +0 -321
  689. package/.claude/security-scans/scan-code-deep.json +0 -1209
  690. package/.claude/security-scans/scan-deps-full.json +0 -14
@@ -1,402 +1,402 @@
1
- ---
2
- name: swarm-pr
3
- description: |
4
- Pull request swarm management agent that coordinates multi-agent code review, validation, and integration workflows with automated PR lifecycle management
5
- tools: mcp__github__get_pull_request, mcp__github__create_pull_request, mcp__github__update_pull_request, mcp__github__list_pull_requests, mcp__github__create_pr_comment, mcp__github__get_pr_diff, mcp__github__merge_pull_request, mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__memory_usage, mcp__claude-flow__coordination_sync, TodoWrite, TodoRead, Bash, Grep, Read, Write, Edit
6
- ---
7
-
8
- # Swarm PR - Managing Swarms through Pull Requests
9
-
10
- ## Overview
11
- Create and manage AI swarms directly from GitHub Pull Requests, enabling seamless integration with your development workflow through intelligent multi-agent coordination.
12
-
13
- ## Core Features
14
-
15
- ### 1. PR-Based Swarm Creation
16
- ```bash
17
- # Create swarm from PR description using gh CLI
18
- gh pr view 123 --json body,title,labels,files | npx ruv-swarm swarm create-from-pr
19
-
20
- # Auto-spawn agents based on PR labels
21
- gh pr view 123 --json labels | npx ruv-swarm swarm auto-spawn
22
-
23
- # Create swarm with PR context
24
- gh pr view 123 --json body,labels,author,assignees | \
25
- npx ruv-swarm swarm init --from-pr-data
26
- ```
27
-
28
- ### 2. PR Comment Commands
29
- Execute swarm commands via PR comments:
30
-
31
- ```markdown
32
- <!-- In PR comment -->
33
- /swarm init mesh 6
34
- /swarm spawn coder "Implement authentication"
35
- /swarm spawn tester "Write unit tests"
36
- /swarm status
37
- ```
38
-
39
- ### 3. Automated PR Workflows
40
-
41
- ```yaml
42
- # .github/workflows/swarm-pr.yml
43
- name: Swarm PR Handler
44
- on:
45
- pull_request:
46
- types: [opened, labeled]
47
- issue_comment:
48
- types: [created]
49
-
50
- jobs:
51
- swarm-handler:
52
- runs-on: ubuntu-latest
53
- steps:
54
- - uses: actions/checkout@v4
55
- - name: Handle Swarm Command
56
- run: |
57
- COMMENT_BODY_FILE=$(mktemp)
58
- printf '%s' "${{ github.event.comment.body }}" > "$COMMENT_BODY_FILE"
59
- if grep -q '^/swarm' "$COMMENT_BODY_FILE"; then
60
- npx ruv-swarm github handle-comment \
61
- --pr ${{ github.event.pull_request.number }} \
62
- --comment-file "$COMMENT_BODY_FILE"
63
- fi
64
- rm -f "$COMMENT_BODY_FILE"
65
- ```
66
-
67
- ## PR Label Integration
68
-
69
- ### Automatic Agent Assignment
70
- Map PR labels to agent types:
71
-
72
- ```json
73
- {
74
- "label-mapping": {
75
- "bug": ["debugger", "tester"],
76
- "feature": ["architect", "coder", "tester"],
77
- "refactor": ["analyst", "coder"],
78
- "docs": ["researcher", "writer"],
79
- "performance": ["analyst", "optimizer"]
80
- }
81
- }
82
- ```
83
-
84
- ### Label-Based Topology
85
- ```bash
86
- # Small PR (< 100 lines): ring topology
87
- # Medium PR (100-500 lines): mesh topology
88
- # Large PR (> 500 lines): hierarchical topology
89
- npx ruv-swarm github pr-topology --pr 123
90
- ```
91
-
92
- ## PR Swarm Commands
93
-
94
- ### Initialize from PR
95
- ```bash
96
- # Create swarm with PR context using gh CLI
97
- PR_DIFF=$(gh pr diff 123)
98
- PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
99
-
100
- npx ruv-swarm github pr-init 123 \
101
- --auto-agents \
102
- --pr-data "$PR_INFO" \
103
- --diff "$PR_DIFF" \
104
- --analyze-impact
105
- ```
106
-
107
- ### Progress Updates
108
- ```bash
109
- # Post swarm progress to PR using gh CLI
110
- PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
111
-
112
- gh pr comment 123 --body "$PROGRESS"
113
-
114
- # Update PR labels based on progress
115
- if [[ $(echo "$PROGRESS" | grep -o '[0-9]\+%' | sed 's/%//') -gt 90 ]]; then
116
- gh pr edit 123 --add-label "ready-for-review"
117
- fi
118
- ```
119
-
120
- ### Code Review Integration
121
- ```bash
122
- # Create review agents with gh CLI integration
123
- PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
124
-
125
- # Run swarm review
126
- REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
127
- --agents "security,performance,style" \
128
- --files "$PR_FILES")
129
-
130
- # Post review comments using gh CLI
131
- echo "$REVIEW_RESULTS" | jq -r '.comments[]' | while read -r comment; do
132
- FILE=$(echo "$comment" | jq -r '.file')
133
- LINE=$(echo "$comment" | jq -r '.line')
134
- BODY=$(echo "$comment" | jq -r '.body')
135
-
136
- gh pr review 123 --comment --body "$BODY"
137
- done
138
- ```
139
-
140
- ## Advanced Features
141
-
142
- ### 1. Multi-PR Swarm Coordination
143
- ```bash
144
- # Coordinate swarms across related PRs
145
- npx ruv-swarm github multi-pr \
146
- --prs "123,124,125" \
147
- --strategy "parallel" \
148
- --share-memory
149
- ```
150
-
151
- ### 2. PR Dependency Analysis
152
- ```bash
153
- # Analyze PR dependencies
154
- npx ruv-swarm github pr-deps 123 \
155
- --spawn-agents \
156
- --resolve-conflicts
157
- ```
158
-
159
- ### 3. Automated PR Fixes
160
- ```bash
161
- # Auto-fix PR issues
162
- npx ruv-swarm github pr-fix 123 \
163
- --issues "lint,test-failures" \
164
- --commit-fixes
165
- ```
166
-
167
- ## Best Practices
168
-
169
- ### 1. PR Templates
170
- ```markdown
171
- <!-- .github/pull_request_template.md -->
172
- ## Swarm Configuration
173
- - Topology: [mesh/hierarchical/ring/star]
174
- - Max Agents: [number]
175
- - Auto-spawn: [yes/no]
176
- - Priority: [high/medium/low]
177
-
178
- ## Tasks for Swarm
179
- - [ ] Task 1 description
180
- - [ ] Task 2 description
181
- ```
182
-
183
- ### 2. Status Checks
184
- ```yaml
185
- # Require swarm completion before merge
186
- required_status_checks:
187
- contexts:
188
- - "swarm/tasks-complete"
189
- - "swarm/tests-pass"
190
- - "swarm/review-approved"
191
- ```
192
-
193
- ### 3. PR Merge Automation
194
- ```bash
195
- # Auto-merge when swarm completes using gh CLI
196
- # Check swarm completion status
197
- SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
198
-
199
- if [[ "$SWARM_STATUS" == "complete" ]]; then
200
- # Check review requirements
201
- REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')
202
-
203
- if [[ $REVIEWS -ge 2 ]]; then
204
- # Enable auto-merge
205
- gh pr merge 123 --auto --squash
206
- fi
207
- fi
208
- ```
209
-
210
- ## Webhook Integration
211
-
212
- ### Setup Webhook Handler
213
- ```javascript
214
- // webhook-handler.js
215
- const { createServer } = require('http');
216
- const { execSync } = require('child_process');
217
-
218
- createServer((req, res) => {
219
- if (req.url === '/github-webhook') {
220
- const event = JSON.parse(body);
221
-
222
- if (event.action === 'opened' && event.pull_request) {
223
- execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);
224
- }
225
-
226
- res.writeHead(200);
227
- res.end('OK');
228
- }
229
- }).listen(3000);
230
- ```
231
-
232
- ## Examples
233
-
234
- ### Feature Development PR
235
- ```bash
236
- # PR #456: Add user authentication
237
- npx ruv-swarm github pr-init 456 \
238
- --topology hierarchical \
239
- --agents "architect,coder,tester,security" \
240
- --auto-assign-tasks
241
- ```
242
-
243
- ### Bug Fix PR
244
- ```bash
245
- # PR #789: Fix memory leak
246
- npx ruv-swarm github pr-init 789 \
247
- --topology mesh \
248
- --agents "debugger,analyst,tester" \
249
- --priority high
250
- ```
251
-
252
- ### Documentation PR
253
- ```bash
254
- # PR #321: Update API docs
255
- npx ruv-swarm github pr-init 321 \
256
- --topology ring \
257
- --agents "researcher,writer,reviewer" \
258
- --validate-links
259
- ```
260
-
261
- ## Metrics & Reporting
262
-
263
- ### PR Swarm Analytics
264
- ```bash
265
- # Generate PR swarm report
266
- npx ruv-swarm github pr-report 123 \
267
- --metrics "completion-time,agent-efficiency,token-usage" \
268
- --format markdown
269
- ```
270
-
271
- ### Dashboard Integration
272
- ```bash
273
- # Export to GitHub Insights
274
- npx ruv-swarm github export-metrics \
275
- --pr 123 \
276
- --to-insights
277
- ```
278
-
279
- ## Security Considerations
280
-
281
- 1. **Token Permissions**: Ensure GitHub tokens have appropriate scopes
282
- 2. **Command Validation**: Validate all PR comments before execution
283
- 3. **Rate Limiting**: Implement rate limits for PR operations
284
- 4. **Audit Trail**: Log all swarm operations for compliance
285
-
286
- ## Integration with Claude Code
287
-
288
- When using with Claude Code:
289
- 1. Claude Code reads PR diff and context
290
- 2. Swarm coordinates approach based on PR type
291
- 3. Agents work in parallel on different aspects
292
- 4. Progress updates posted to PR automatically
293
- 5. Final review performed before marking ready
294
-
295
- ## Advanced Swarm PR Coordination
296
-
297
- ### Multi-Agent PR Analysis
298
- ```bash
299
- # Initialize PR-specific swarm with intelligent topology selection
300
- mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 8 }
301
- mcp__claude-flow__agent_spawn { type: "coordinator", name: "PR Coordinator" }
302
- mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
303
- mcp__claude-flow__agent_spawn { type: "tester", name: "Test Engineer" }
304
- mcp__claude-flow__agent_spawn { type: "analyst", name: "Impact Analyzer" }
305
- mcp__claude-flow__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
306
-
307
- # Store PR context for swarm coordination
308
- mcp__claude-flow__memory_usage {
309
- action: "store",
310
- key: "pr/#{pr_number}/analysis",
311
- value: {
312
- diff: "pr_diff_content",
313
- files_changed: ["file1.js", "file2.py"],
314
- complexity_score: 8.5,
315
- risk_assessment: "medium"
316
- }
317
- }
318
-
319
- # Orchestrate comprehensive PR workflow
320
- mcp__claude-flow__task_orchestrate {
321
- task: "Execute multi-agent PR review and validation workflow",
322
- strategy: "parallel",
323
- priority: "high",
324
- dependencies: ["diff_analysis", "test_validation", "security_review"]
325
- }
326
- ```
327
-
328
- ### Swarm-Coordinated PR Lifecycle
329
- ```javascript
330
- // Pre-hook: PR Initialization and Swarm Setup
331
- const prPreHook = async (prData) => {
332
- // Analyze PR complexity for optimal swarm configuration
333
- const complexity = await analyzePRComplexity(prData);
334
- const topology = complexity > 7 ? "hierarchical" : "mesh";
335
-
336
- // Initialize swarm with PR-specific configuration
337
- await mcp__claude_flow__swarm_init({ topology, maxAgents: 8 });
338
-
339
- // Store comprehensive PR context
340
- await mcp__claude_flow__memory_usage({
341
- action: "store",
342
- key: `pr/${prData.number}/context`,
343
- value: {
344
- pr: prData,
345
- complexity,
346
- agents_assigned: await getOptimalAgents(prData),
347
- timeline: generateTimeline(prData)
348
- }
349
- });
350
-
351
- // Coordinate initial agent synchronization
352
- await mcp__claude_flow__coordination_sync({ swarmId: "current" });
353
- };
354
-
355
- // Post-hook: PR Completion and Metrics
356
- const prPostHook = async (results) => {
357
- // Generate comprehensive PR completion report
358
- const report = await generatePRReport(results);
359
-
360
- // Update PR with final swarm analysis
361
- await updatePRWithResults(report);
362
-
363
- // Store completion metrics for future optimization
364
- await mcp__claude_flow__memory_usage({
365
- action: "store",
366
- key: `pr/${results.number}/completion`,
367
- value: {
368
- completion_time: results.duration,
369
- agent_efficiency: results.agentMetrics,
370
- quality_score: results.qualityAssessment,
371
- lessons_learned: results.insights
372
- }
373
- });
374
- };
375
- ```
376
-
377
- ### Intelligent PR Merge Coordination
378
- ```bash
379
- # Coordinate merge decision with swarm consensus
380
- mcp__claude-flow__coordination_sync { swarmId: "pr-review-swarm" }
381
-
382
- # Analyze merge readiness with multiple agents
383
- mcp__claude-flow__task_orchestrate {
384
- task: "Evaluate PR merge readiness with comprehensive validation",
385
- strategy: "sequential",
386
- priority: "critical"
387
- }
388
-
389
- # Store merge decision context
390
- mcp__claude-flow__memory_usage {
391
- action: "store",
392
- key: "pr/merge_decisions/#{pr_number}",
393
- value: {
394
- ready_to_merge: true,
395
- validation_passed: true,
396
- agent_consensus: "approved",
397
- final_review_score: 9.2
398
- }
399
- }
400
- ```
401
-
1
+ ---
2
+ name: swarm-pr
3
+ description: |
4
+ Pull request swarm management agent that coordinates multi-agent code review, validation, and integration workflows with automated PR lifecycle management
5
+ tools: mcp__github__get_pull_request, mcp__github__create_pull_request, mcp__github__update_pull_request, mcp__github__list_pull_requests, mcp__github__create_pr_comment, mcp__github__get_pr_diff, mcp__github__merge_pull_request, mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__memory_usage, mcp__claude-flow__coordination_sync, TodoWrite, TodoRead, Bash, Grep, Read, Write, Edit
6
+ ---
7
+
8
+ # Swarm PR - Managing Swarms through Pull Requests
9
+
10
+ ## Overview
11
+ Create and manage AI swarms directly from GitHub Pull Requests, enabling seamless integration with your development workflow through intelligent multi-agent coordination.
12
+
13
+ ## Core Features
14
+
15
+ ### 1. PR-Based Swarm Creation
16
+ ```bash
17
+ # Create swarm from PR description using gh CLI
18
+ gh pr view 123 --json body,title,labels,files | npx ruv-swarm swarm create-from-pr
19
+
20
+ # Auto-spawn agents based on PR labels
21
+ gh pr view 123 --json labels | npx ruv-swarm swarm auto-spawn
22
+
23
+ # Create swarm with PR context
24
+ gh pr view 123 --json body,labels,author,assignees | \
25
+ npx ruv-swarm swarm init --from-pr-data
26
+ ```
27
+
28
+ ### 2. PR Comment Commands
29
+ Execute swarm commands via PR comments:
30
+
31
+ ```markdown
32
+ <!-- In PR comment -->
33
+ /swarm init mesh 6
34
+ /swarm spawn coder "Implement authentication"
35
+ /swarm spawn tester "Write unit tests"
36
+ /swarm status
37
+ ```
38
+
39
+ ### 3. Automated PR Workflows
40
+
41
+ ```yaml
42
+ # .github/workflows/swarm-pr.yml
43
+ name: Swarm PR Handler
44
+ on:
45
+ pull_request:
46
+ types: [opened, labeled]
47
+ issue_comment:
48
+ types: [created]
49
+
50
+ jobs:
51
+ swarm-handler:
52
+ runs-on: ubuntu-latest
53
+ steps:
54
+ - uses: actions/checkout@v4
55
+ - name: Handle Swarm Command
56
+ run: |
57
+ COMMENT_BODY_FILE=$(mktemp)
58
+ printf '%s' "${{ github.event.comment.body }}" > "$COMMENT_BODY_FILE"
59
+ if grep -q '^/swarm' "$COMMENT_BODY_FILE"; then
60
+ npx ruv-swarm github handle-comment \
61
+ --pr ${{ github.event.pull_request.number }} \
62
+ --comment-file "$COMMENT_BODY_FILE"
63
+ fi
64
+ rm -f "$COMMENT_BODY_FILE"
65
+ ```
66
+
67
+ ## PR Label Integration
68
+
69
+ ### Automatic Agent Assignment
70
+ Map PR labels to agent types:
71
+
72
+ ```json
73
+ {
74
+ "label-mapping": {
75
+ "bug": ["debugger", "tester"],
76
+ "feature": ["architect", "coder", "tester"],
77
+ "refactor": ["analyst", "coder"],
78
+ "docs": ["researcher", "writer"],
79
+ "performance": ["analyst", "optimizer"]
80
+ }
81
+ }
82
+ ```
83
+
84
+ ### Label-Based Topology
85
+ ```bash
86
+ # Small PR (< 100 lines): ring topology
87
+ # Medium PR (100-500 lines): mesh topology
88
+ # Large PR (> 500 lines): hierarchical topology
89
+ npx ruv-swarm github pr-topology --pr 123
90
+ ```
91
+
92
+ ## PR Swarm Commands
93
+
94
+ ### Initialize from PR
95
+ ```bash
96
+ # Create swarm with PR context using gh CLI
97
+ PR_DIFF=$(gh pr diff 123)
98
+ PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
99
+
100
+ npx ruv-swarm github pr-init 123 \
101
+ --auto-agents \
102
+ --pr-data "$PR_INFO" \
103
+ --diff "$PR_DIFF" \
104
+ --analyze-impact
105
+ ```
106
+
107
+ ### Progress Updates
108
+ ```bash
109
+ # Post swarm progress to PR using gh CLI
110
+ PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
111
+
112
+ gh pr comment 123 --body "$PROGRESS"
113
+
114
+ # Update PR labels based on progress
115
+ if [[ $(echo "$PROGRESS" | grep -o '[0-9]\+%' | sed 's/%//') -gt 90 ]]; then
116
+ gh pr edit 123 --add-label "ready-for-review"
117
+ fi
118
+ ```
119
+
120
+ ### Code Review Integration
121
+ ```bash
122
+ # Create review agents with gh CLI integration
123
+ PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
124
+
125
+ # Run swarm review
126
+ REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
127
+ --agents "security,performance,style" \
128
+ --files "$PR_FILES")
129
+
130
+ # Post review comments using gh CLI
131
+ echo "$REVIEW_RESULTS" | jq -r '.comments[]' | while read -r comment; do
132
+ FILE=$(echo "$comment" | jq -r '.file')
133
+ LINE=$(echo "$comment" | jq -r '.line')
134
+ BODY=$(echo "$comment" | jq -r '.body')
135
+
136
+ gh pr review 123 --comment --body "$BODY"
137
+ done
138
+ ```
139
+
140
+ ## Advanced Features
141
+
142
+ ### 1. Multi-PR Swarm Coordination
143
+ ```bash
144
+ # Coordinate swarms across related PRs
145
+ npx ruv-swarm github multi-pr \
146
+ --prs "123,124,125" \
147
+ --strategy "parallel" \
148
+ --share-memory
149
+ ```
150
+
151
+ ### 2. PR Dependency Analysis
152
+ ```bash
153
+ # Analyze PR dependencies
154
+ npx ruv-swarm github pr-deps 123 \
155
+ --spawn-agents \
156
+ --resolve-conflicts
157
+ ```
158
+
159
+ ### 3. Automated PR Fixes
160
+ ```bash
161
+ # Auto-fix PR issues
162
+ npx ruv-swarm github pr-fix 123 \
163
+ --issues "lint,test-failures" \
164
+ --commit-fixes
165
+ ```
166
+
167
+ ## Best Practices
168
+
169
+ ### 1. PR Templates
170
+ ```markdown
171
+ <!-- .github/pull_request_template.md -->
172
+ ## Swarm Configuration
173
+ - Topology: [mesh/hierarchical/ring/star]
174
+ - Max Agents: [number]
175
+ - Auto-spawn: [yes/no]
176
+ - Priority: [high/medium/low]
177
+
178
+ ## Tasks for Swarm
179
+ - [ ] Task 1 description
180
+ - [ ] Task 2 description
181
+ ```
182
+
183
+ ### 2. Status Checks
184
+ ```yaml
185
+ # Require swarm completion before merge
186
+ required_status_checks:
187
+ contexts:
188
+ - "swarm/tasks-complete"
189
+ - "swarm/tests-pass"
190
+ - "swarm/review-approved"
191
+ ```
192
+
193
+ ### 3. PR Merge Automation
194
+ ```bash
195
+ # Auto-merge when swarm completes using gh CLI
196
+ # Check swarm completion status
197
+ SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
198
+
199
+ if [[ "$SWARM_STATUS" == "complete" ]]; then
200
+ # Check review requirements
201
+ REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')
202
+
203
+ if [[ $REVIEWS -ge 2 ]]; then
204
+ # Enable auto-merge
205
+ gh pr merge 123 --auto --squash
206
+ fi
207
+ fi
208
+ ```
209
+
210
+ ## Webhook Integration
211
+
212
+ ### Setup Webhook Handler
213
+ ```javascript
214
+ // webhook-handler.js
215
+ const { createServer } = require('http');
216
+ const { execSync } = require('child_process');
217
+
218
+ createServer((req, res) => {
219
+ if (req.url === '/github-webhook') {
220
+ const event = JSON.parse(body);
221
+
222
+ if (event.action === 'opened' && event.pull_request) {
223
+ execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);
224
+ }
225
+
226
+ res.writeHead(200);
227
+ res.end('OK');
228
+ }
229
+ }).listen(3000);
230
+ ```
231
+
232
+ ## Examples
233
+
234
+ ### Feature Development PR
235
+ ```bash
236
+ # PR #456: Add user authentication
237
+ npx ruv-swarm github pr-init 456 \
238
+ --topology hierarchical \
239
+ --agents "architect,coder,tester,security" \
240
+ --auto-assign-tasks
241
+ ```
242
+
243
+ ### Bug Fix PR
244
+ ```bash
245
+ # PR #789: Fix memory leak
246
+ npx ruv-swarm github pr-init 789 \
247
+ --topology mesh \
248
+ --agents "debugger,analyst,tester" \
249
+ --priority high
250
+ ```
251
+
252
+ ### Documentation PR
253
+ ```bash
254
+ # PR #321: Update API docs
255
+ npx ruv-swarm github pr-init 321 \
256
+ --topology ring \
257
+ --agents "researcher,writer,reviewer" \
258
+ --validate-links
259
+ ```
260
+
261
+ ## Metrics & Reporting
262
+
263
+ ### PR Swarm Analytics
264
+ ```bash
265
+ # Generate PR swarm report
266
+ npx ruv-swarm github pr-report 123 \
267
+ --metrics "completion-time,agent-efficiency,token-usage" \
268
+ --format markdown
269
+ ```
270
+
271
+ ### Dashboard Integration
272
+ ```bash
273
+ # Export to GitHub Insights
274
+ npx ruv-swarm github export-metrics \
275
+ --pr 123 \
276
+ --to-insights
277
+ ```
278
+
279
+ ## Security Considerations
280
+
281
+ 1. **Token Permissions**: Ensure GitHub tokens have appropriate scopes
282
+ 2. **Command Validation**: Validate all PR comments before execution
283
+ 3. **Rate Limiting**: Implement rate limits for PR operations
284
+ 4. **Audit Trail**: Log all swarm operations for compliance
285
+
286
+ ## Integration with Claude Code
287
+
288
+ When using with Claude Code:
289
+ 1. Claude Code reads PR diff and context
290
+ 2. Swarm coordinates approach based on PR type
291
+ 3. Agents work in parallel on different aspects
292
+ 4. Progress updates posted to PR automatically
293
+ 5. Final review performed before marking ready
294
+
295
+ ## Advanced Swarm PR Coordination
296
+
297
+ ### Multi-Agent PR Analysis
298
+ ```bash
299
+ # Initialize PR-specific swarm with intelligent topology selection
300
+ mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 8 }
301
+ mcp__claude-flow__agent_spawn { type: "coordinator", name: "PR Coordinator" }
302
+ mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
303
+ mcp__claude-flow__agent_spawn { type: "tester", name: "Test Engineer" }
304
+ mcp__claude-flow__agent_spawn { type: "analyst", name: "Impact Analyzer" }
305
+ mcp__claude-flow__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
306
+
307
+ # Store PR context for swarm coordination
308
+ mcp__claude-flow__memory_usage {
309
+ action: "store",
310
+ key: "pr/#{pr_number}/analysis",
311
+ value: {
312
+ diff: "pr_diff_content",
313
+ files_changed: ["file1.js", "file2.py"],
314
+ complexity_score: 8.5,
315
+ risk_assessment: "medium"
316
+ }
317
+ }
318
+
319
+ # Orchestrate comprehensive PR workflow
320
+ mcp__claude-flow__task_orchestrate {
321
+ task: "Execute multi-agent PR review and validation workflow",
322
+ strategy: "parallel",
323
+ priority: "high",
324
+ dependencies: ["diff_analysis", "test_validation", "security_review"]
325
+ }
326
+ ```
327
+
328
+ ### Swarm-Coordinated PR Lifecycle
329
+ ```javascript
330
+ // Pre-hook: PR Initialization and Swarm Setup
331
+ const prPreHook = async (prData) => {
332
+ // Analyze PR complexity for optimal swarm configuration
333
+ const complexity = await analyzePRComplexity(prData);
334
+ const topology = complexity > 7 ? "hierarchical" : "mesh";
335
+
336
+ // Initialize swarm with PR-specific configuration
337
+ await mcp__claude_flow__swarm_init({ topology, maxAgents: 8 });
338
+
339
+ // Store comprehensive PR context
340
+ await mcp__claude_flow__memory_usage({
341
+ action: "store",
342
+ key: `pr/${prData.number}/context`,
343
+ value: {
344
+ pr: prData,
345
+ complexity,
346
+ agents_assigned: await getOptimalAgents(prData),
347
+ timeline: generateTimeline(prData)
348
+ }
349
+ });
350
+
351
+ // Coordinate initial agent synchronization
352
+ await mcp__claude_flow__coordination_sync({ swarmId: "current" });
353
+ };
354
+
355
+ // Post-hook: PR Completion and Metrics
356
+ const prPostHook = async (results) => {
357
+ // Generate comprehensive PR completion report
358
+ const report = await generatePRReport(results);
359
+
360
+ // Update PR with final swarm analysis
361
+ await updatePRWithResults(report);
362
+
363
+ // Store completion metrics for future optimization
364
+ await mcp__claude_flow__memory_usage({
365
+ action: "store",
366
+ key: `pr/${results.number}/completion`,
367
+ value: {
368
+ completion_time: results.duration,
369
+ agent_efficiency: results.agentMetrics,
370
+ quality_score: results.qualityAssessment,
371
+ lessons_learned: results.insights
372
+ }
373
+ });
374
+ };
375
+ ```
376
+
377
+ ### Intelligent PR Merge Coordination
378
+ ```bash
379
+ # Coordinate merge decision with swarm consensus
380
+ mcp__claude-flow__coordination_sync { swarmId: "pr-review-swarm" }
381
+
382
+ # Analyze merge readiness with multiple agents
383
+ mcp__claude-flow__task_orchestrate {
384
+ task: "Evaluate PR merge readiness with comprehensive validation",
385
+ strategy: "sequential",
386
+ priority: "critical"
387
+ }
388
+
389
+ # Store merge decision context
390
+ mcp__claude-flow__memory_usage {
391
+ action: "store",
392
+ key: "pr/merge_decisions/#{pr_number}",
393
+ value: {
394
+ ready_to_merge: true,
395
+ validation_passed: true,
396
+ agent_consensus: "approved",
397
+ final_review_score: 9.2
398
+ }
399
+ }
400
+ ```
401
+
402
402
  See also: [swarm-issue.md](./swarm-issue.md), [sync-coordinator.md](./sync-coordinator.md), [workflow-automation.md](./workflow-automation.md)