moflo 4.8.16 → 4.8.19

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 (468) hide show
  1. package/.claude/agents/browser/browser-agent.yaml +182 -182
  2. package/.claude/agents/core/coder.md +265 -265
  3. package/.claude/agents/core/planner.md +167 -167
  4. package/.claude/agents/core/researcher.md +189 -189
  5. package/.claude/agents/core/reviewer.md +325 -325
  6. package/.claude/agents/core/tester.md +318 -318
  7. package/.claude/agents/database-specialist.yaml +21 -21
  8. package/.claude/agents/dual-mode/codex-coordinator.md +224 -224
  9. package/.claude/agents/dual-mode/codex-worker.md +211 -211
  10. package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
  11. package/.claude/agents/github/code-review-swarm.md +537 -537
  12. package/.claude/agents/github/github-modes.md +172 -172
  13. package/.claude/agents/github/issue-tracker.md +318 -318
  14. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  15. package/.claude/agents/github/pr-manager.md +190 -190
  16. package/.claude/agents/github/project-board-sync.md +508 -508
  17. package/.claude/agents/github/release-manager.md +366 -366
  18. package/.claude/agents/github/release-swarm.md +582 -582
  19. package/.claude/agents/github/repo-architect.md +397 -397
  20. package/.claude/agents/github/swarm-issue.md +572 -572
  21. package/.claude/agents/github/swarm-pr.md +427 -427
  22. package/.claude/agents/github/sync-coordinator.md +451 -451
  23. package/.claude/agents/github/workflow-automation.md +634 -634
  24. package/.claude/agents/goal/code-goal-planner.md +445 -445
  25. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  26. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  27. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  28. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  29. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  30. package/.claude/agents/index.yaml +17 -17
  31. package/.claude/agents/neural/safla-neural.md +73 -73
  32. package/.claude/agents/project-coordinator.yaml +15 -15
  33. package/.claude/agents/python-specialist.yaml +21 -21
  34. package/.claude/agents/reasoning/goal-planner.md +72 -72
  35. package/.claude/agents/security-auditor.yaml +20 -20
  36. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  37. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  38. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  39. package/.claude/agents/templates/migration-plan.md +745 -745
  40. package/.claude/agents/typescript-specialist.yaml +21 -21
  41. package/.claude/checkpoints/1767754460.json +8 -8
  42. package/.claude/commands/agents/agent-spawning.md +28 -28
  43. package/.claude/commands/github/github-modes.md +146 -146
  44. package/.claude/commands/github/github-swarm.md +121 -121
  45. package/.claude/commands/github/issue-tracker.md +291 -291
  46. package/.claude/commands/github/pr-manager.md +169 -169
  47. package/.claude/commands/github/release-manager.md +337 -337
  48. package/.claude/commands/github/repo-architect.md +366 -366
  49. package/.claude/commands/github/sync-coordinator.md +300 -300
  50. package/.claude/commands/memory/neural.md +47 -47
  51. package/.claude/commands/sparc/analyzer.md +51 -51
  52. package/.claude/commands/sparc/architect.md +53 -53
  53. package/.claude/commands/sparc/ask.md +97 -97
  54. package/.claude/commands/sparc/batch-executor.md +54 -54
  55. package/.claude/commands/sparc/code.md +89 -89
  56. package/.claude/commands/sparc/coder.md +54 -54
  57. package/.claude/commands/sparc/debug.md +83 -83
  58. package/.claude/commands/sparc/debugger.md +54 -54
  59. package/.claude/commands/sparc/designer.md +53 -53
  60. package/.claude/commands/sparc/devops.md +109 -109
  61. package/.claude/commands/sparc/docs-writer.md +80 -80
  62. package/.claude/commands/sparc/documenter.md +54 -54
  63. package/.claude/commands/sparc/innovator.md +54 -54
  64. package/.claude/commands/sparc/integration.md +83 -83
  65. package/.claude/commands/sparc/mcp.md +117 -117
  66. package/.claude/commands/sparc/memory-manager.md +54 -54
  67. package/.claude/commands/sparc/optimizer.md +54 -54
  68. package/.claude/commands/sparc/orchestrator.md +131 -131
  69. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  70. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  71. package/.claude/commands/sparc/researcher.md +54 -54
  72. package/.claude/commands/sparc/reviewer.md +54 -54
  73. package/.claude/commands/sparc/security-review.md +80 -80
  74. package/.claude/commands/sparc/sparc-modes.md +174 -174
  75. package/.claude/commands/sparc/sparc.md +111 -111
  76. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  77. package/.claude/commands/sparc/supabase-admin.md +348 -348
  78. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  79. package/.claude/commands/sparc/tdd.md +54 -54
  80. package/.claude/commands/sparc/tester.md +54 -54
  81. package/.claude/commands/sparc/tutorial.md +79 -79
  82. package/.claude/commands/sparc/workflow-manager.md +54 -54
  83. package/.claude/commands/sparc.md +166 -166
  84. package/.claude/commands/swarm/analysis.md +95 -95
  85. package/.claude/commands/swarm/development.md +96 -96
  86. package/.claude/commands/swarm/examples.md +168 -168
  87. package/.claude/commands/swarm/maintenance.md +102 -102
  88. package/.claude/commands/swarm/optimization.md +117 -117
  89. package/.claude/commands/swarm/research.md +136 -136
  90. package/.claude/commands/swarm/testing.md +131 -131
  91. package/.claude/commands/workflows/development.md +77 -77
  92. package/.claude/commands/workflows/research.md +62 -62
  93. package/.claude/guidance/moflo-bootstrap.md +126 -126
  94. package/.claude/guidance/shipped/agent-bootstrap.md +126 -126
  95. package/.claude/guidance/shipped/guidance-memory-strategy.md +262 -262
  96. package/.claude/guidance/shipped/memory-strategy.md +204 -204
  97. package/.claude/guidance/shipped/moflo.md +608 -608
  98. package/.claude/guidance/shipped/task-swarm-integration.md +441 -441
  99. package/.claude/helpers/intelligence.cjs +207 -207
  100. package/.claude/helpers/statusline.cjs +851 -851
  101. package/.claude/skills/fl/SKILL.md +583 -583
  102. package/.claude/skills/flo/SKILL.md +583 -583
  103. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  104. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  105. package/.claude/skills/github-project-management/SKILL.md +1277 -1277
  106. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  107. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  108. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  109. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  110. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  111. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  112. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  113. package/LICENSE +21 -21
  114. package/README.md +685 -685
  115. package/bin/cli.js +0 -0
  116. package/bin/gate-hook.mjs +50 -50
  117. package/bin/gate.cjs +138 -138
  118. package/bin/generate-code-map.mjs +91 -12
  119. package/bin/hook-handler.cjs +83 -83
  120. package/bin/hooks.mjs +656 -656
  121. package/bin/index-guidance.mjs +892 -892
  122. package/bin/index-tests.mjs +709 -709
  123. package/bin/lib/process-manager.mjs +243 -243
  124. package/bin/lib/registry-cleanup.cjs +41 -41
  125. package/bin/prompt-hook.mjs +72 -72
  126. package/bin/semantic-search.mjs +472 -472
  127. package/bin/session-start-launcher.mjs +238 -226
  128. package/bin/setup-project.mjs +250 -250
  129. package/package.json +123 -121
  130. package/src/@claude-flow/cli/README.md +452 -452
  131. package/src/@claude-flow/cli/bin/cli.js +180 -175
  132. package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
  133. package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  134. package/src/@claude-flow/cli/dist/src/commands/doctor.js +1091 -1091
  135. package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
  136. package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
  137. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  138. package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  139. package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  140. package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  141. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +91 -91
  142. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
  143. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +43 -43
  144. package/src/@claude-flow/cli/dist/src/init/executor.js +485 -453
  145. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
  146. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
  147. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +848 -839
  148. package/src/@claude-flow/cli/dist/src/init/settings-generator.js +6 -2
  149. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +786 -786
  150. package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
  151. package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  152. package/src/@claude-flow/cli/dist/src/services/agentic-flow-bridge.js +6 -0
  153. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  154. package/src/@claude-flow/cli/package.json +1 -1
  155. package/src/@claude-flow/guidance/README.md +1195 -1195
  156. package/src/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
  157. package/src/@claude-flow/guidance/dist/adversarial.js +572 -0
  158. package/src/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
  159. package/src/@claude-flow/guidance/dist/analyzer.js +2518 -0
  160. package/src/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
  161. package/src/@claude-flow/guidance/dist/artifacts.js +356 -0
  162. package/src/@claude-flow/guidance/dist/authority.d.ts +290 -0
  163. package/src/@claude-flow/guidance/dist/authority.js +558 -0
  164. package/src/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
  165. package/src/@claude-flow/guidance/dist/capabilities.js +485 -0
  166. package/src/@claude-flow/guidance/dist/coherence.d.ts +233 -0
  167. package/src/@claude-flow/guidance/dist/coherence.js +372 -0
  168. package/src/@claude-flow/guidance/dist/compiler.d.ts +87 -0
  169. package/src/@claude-flow/guidance/dist/compiler.js +419 -0
  170. package/src/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
  171. package/src/@claude-flow/guidance/dist/conformance-kit.js +629 -0
  172. package/src/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
  173. package/src/@claude-flow/guidance/dist/continue-gate.js +353 -0
  174. package/src/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
  175. package/src/@claude-flow/guidance/dist/crypto-utils.js +24 -0
  176. package/src/@claude-flow/guidance/dist/evolution.d.ts +282 -0
  177. package/src/@claude-flow/guidance/dist/evolution.js +500 -0
  178. package/src/@claude-flow/guidance/dist/gates.d.ts +79 -0
  179. package/src/@claude-flow/guidance/dist/gates.js +302 -0
  180. package/src/@claude-flow/guidance/dist/gateway.d.ts +206 -0
  181. package/src/@claude-flow/guidance/dist/gateway.js +452 -0
  182. package/src/@claude-flow/guidance/dist/generators.d.ts +153 -0
  183. package/src/@claude-flow/guidance/dist/generators.js +682 -0
  184. package/src/@claude-flow/guidance/dist/headless.d.ts +177 -0
  185. package/src/@claude-flow/guidance/dist/headless.js +342 -0
  186. package/src/@claude-flow/guidance/dist/hooks.d.ts +109 -0
  187. package/src/@claude-flow/guidance/dist/hooks.js +347 -0
  188. package/src/@claude-flow/guidance/dist/index.d.ts +205 -0
  189. package/src/@claude-flow/guidance/dist/index.js +321 -0
  190. package/src/@claude-flow/guidance/dist/ledger.d.ts +162 -0
  191. package/src/@claude-flow/guidance/dist/ledger.js +375 -0
  192. package/src/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
  193. package/src/@claude-flow/guidance/dist/manifest-validator.js +838 -0
  194. package/src/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
  195. package/src/@claude-flow/guidance/dist/memory-gate.js +382 -0
  196. package/src/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
  197. package/src/@claude-flow/guidance/dist/meta-governance.js +348 -0
  198. package/src/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
  199. package/src/@claude-flow/guidance/dist/optimizer.js +329 -0
  200. package/src/@claude-flow/guidance/dist/persistence.d.ts +189 -0
  201. package/src/@claude-flow/guidance/dist/persistence.js +464 -0
  202. package/src/@claude-flow/guidance/dist/proof.d.ts +185 -0
  203. package/src/@claude-flow/guidance/dist/proof.js +238 -0
  204. package/src/@claude-flow/guidance/dist/retriever.d.ts +116 -0
  205. package/src/@claude-flow/guidance/dist/retriever.js +394 -0
  206. package/src/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
  207. package/src/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
  208. package/src/@claude-flow/guidance/dist/temporal.d.ts +426 -0
  209. package/src/@claude-flow/guidance/dist/temporal.js +658 -0
  210. package/src/@claude-flow/guidance/dist/trust.d.ts +283 -0
  211. package/src/@claude-flow/guidance/dist/trust.js +473 -0
  212. package/src/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
  213. package/src/@claude-flow/guidance/dist/truth-anchors.js +488 -0
  214. package/src/@claude-flow/guidance/dist/types.d.ts +378 -0
  215. package/src/@claude-flow/guidance/dist/types.js +10 -0
  216. package/src/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
  217. package/src/@claude-flow/guidance/dist/uncertainty.js +619 -0
  218. package/src/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
  219. package/src/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
  220. package/src/@claude-flow/guidance/package.json +198 -198
  221. package/src/@claude-flow/memory/README.md +587 -587
  222. package/src/@claude-flow/memory/package.json +44 -44
  223. package/src/@claude-flow/shared/README.md +323 -323
  224. package/src/README.md +493 -493
  225. package/.claude/settings.local.json +0 -18
  226. package/.claude/workflow-state.json +0 -9
  227. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +0 -197
  228. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +0 -584
  229. package/src/@claude-flow/memory/dist/agent-memory-scope.d.ts +0 -131
  230. package/src/@claude-flow/memory/dist/agent-memory-scope.js +0 -223
  231. package/src/@claude-flow/memory/dist/agent-memory-scope.test.d.ts +0 -8
  232. package/src/@claude-flow/memory/dist/agent-memory-scope.test.js +0 -463
  233. package/src/@claude-flow/memory/dist/agentdb-adapter.d.ts +0 -165
  234. package/src/@claude-flow/memory/dist/agentdb-adapter.js +0 -806
  235. package/src/@claude-flow/memory/dist/agentdb-backend.d.ts +0 -214
  236. package/src/@claude-flow/memory/dist/agentdb-backend.js +0 -844
  237. package/src/@claude-flow/memory/dist/agentdb-backend.test.d.ts +0 -7
  238. package/src/@claude-flow/memory/dist/agentdb-backend.test.js +0 -258
  239. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.d.ts +0 -65
  240. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.js +0 -129
  241. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.d.ts +0 -48
  242. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.js +0 -72
  243. package/src/@claude-flow/memory/dist/application/index.d.ts +0 -12
  244. package/src/@claude-flow/memory/dist/application/index.js +0 -15
  245. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.d.ts +0 -72
  246. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.js +0 -143
  247. package/src/@claude-flow/memory/dist/application/services/memory-application-service.d.ts +0 -121
  248. package/src/@claude-flow/memory/dist/application/services/memory-application-service.js +0 -190
  249. package/src/@claude-flow/memory/dist/auto-memory-bridge.d.ts +0 -226
  250. package/src/@claude-flow/memory/dist/auto-memory-bridge.js +0 -709
  251. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.d.ts +0 -8
  252. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +0 -754
  253. package/src/@claude-flow/memory/dist/benchmark.test.d.ts +0 -2
  254. package/src/@claude-flow/memory/dist/benchmark.test.js +0 -277
  255. package/src/@claude-flow/memory/dist/cache-manager.d.ts +0 -134
  256. package/src/@claude-flow/memory/dist/cache-manager.js +0 -407
  257. package/src/@claude-flow/memory/dist/controller-registry.d.ts +0 -216
  258. package/src/@claude-flow/memory/dist/controller-registry.js +0 -893
  259. package/src/@claude-flow/memory/dist/controller-registry.test.d.ts +0 -14
  260. package/src/@claude-flow/memory/dist/controller-registry.test.js +0 -636
  261. package/src/@claude-flow/memory/dist/database-provider.d.ts +0 -87
  262. package/src/@claude-flow/memory/dist/database-provider.js +0 -375
  263. package/src/@claude-flow/memory/dist/database-provider.test.d.ts +0 -7
  264. package/src/@claude-flow/memory/dist/database-provider.test.js +0 -285
  265. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.d.ts +0 -143
  266. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.js +0 -226
  267. package/src/@claude-flow/memory/dist/domain/index.d.ts +0 -11
  268. package/src/@claude-flow/memory/dist/domain/index.js +0 -12
  269. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.d.ts +0 -102
  270. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.js +0 -11
  271. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.d.ts +0 -105
  272. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.js +0 -297
  273. package/src/@claude-flow/memory/dist/hnsw-index.d.ts +0 -111
  274. package/src/@claude-flow/memory/dist/hnsw-index.js +0 -781
  275. package/src/@claude-flow/memory/dist/hnsw-lite.d.ts +0 -23
  276. package/src/@claude-flow/memory/dist/hnsw-lite.js +0 -168
  277. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +0 -245
  278. package/src/@claude-flow/memory/dist/hybrid-backend.js +0 -569
  279. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +0 -8
  280. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +0 -320
  281. package/src/@claude-flow/memory/dist/index.d.ts +0 -207
  282. package/src/@claude-flow/memory/dist/index.js +0 -361
  283. package/src/@claude-flow/memory/dist/infrastructure/index.d.ts +0 -17
  284. package/src/@claude-flow/memory/dist/infrastructure/index.js +0 -16
  285. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.d.ts +0 -66
  286. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.js +0 -409
  287. package/src/@claude-flow/memory/dist/learning-bridge.d.ts +0 -137
  288. package/src/@claude-flow/memory/dist/learning-bridge.js +0 -335
  289. package/src/@claude-flow/memory/dist/learning-bridge.test.d.ts +0 -8
  290. package/src/@claude-flow/memory/dist/learning-bridge.test.js +0 -578
  291. package/src/@claude-flow/memory/dist/memory-graph.d.ts +0 -100
  292. package/src/@claude-flow/memory/dist/memory-graph.js +0 -333
  293. package/src/@claude-flow/memory/dist/memory-graph.test.d.ts +0 -8
  294. package/src/@claude-flow/memory/dist/memory-graph.test.js +0 -609
  295. package/src/@claude-flow/memory/dist/migration.d.ts +0 -68
  296. package/src/@claude-flow/memory/dist/migration.js +0 -513
  297. package/src/@claude-flow/memory/dist/persistent-sona.d.ts +0 -144
  298. package/src/@claude-flow/memory/dist/persistent-sona.js +0 -332
  299. package/src/@claude-flow/memory/dist/query-builder.d.ts +0 -211
  300. package/src/@claude-flow/memory/dist/query-builder.js +0 -438
  301. package/src/@claude-flow/memory/dist/rvf-backend.d.ts +0 -51
  302. package/src/@claude-flow/memory/dist/rvf-backend.js +0 -481
  303. package/src/@claude-flow/memory/dist/rvf-learning-store.d.ts +0 -139
  304. package/src/@claude-flow/memory/dist/rvf-learning-store.js +0 -295
  305. package/src/@claude-flow/memory/dist/rvf-migration.d.ts +0 -45
  306. package/src/@claude-flow/memory/dist/rvf-migration.js +0 -234
  307. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +0 -121
  308. package/src/@claude-flow/memory/dist/sqlite-backend.js +0 -572
  309. package/src/@claude-flow/memory/dist/sqljs-backend.d.ts +0 -128
  310. package/src/@claude-flow/memory/dist/sqljs-backend.js +0 -601
  311. package/src/@claude-flow/memory/dist/types.d.ts +0 -484
  312. package/src/@claude-flow/memory/dist/types.js +0 -58
  313. package/src/@claude-flow/shared/dist/core/config/defaults.d.ts +0 -41
  314. package/src/@claude-flow/shared/dist/core/config/defaults.js +0 -186
  315. package/src/@claude-flow/shared/dist/core/config/index.d.ts +0 -8
  316. package/src/@claude-flow/shared/dist/core/config/index.js +0 -12
  317. package/src/@claude-flow/shared/dist/core/config/loader.d.ts +0 -45
  318. package/src/@claude-flow/shared/dist/core/config/loader.js +0 -222
  319. package/src/@claude-flow/shared/dist/core/config/schema.d.ts +0 -1134
  320. package/src/@claude-flow/shared/dist/core/config/schema.js +0 -158
  321. package/src/@claude-flow/shared/dist/core/config/validator.d.ts +0 -92
  322. package/src/@claude-flow/shared/dist/core/config/validator.js +0 -147
  323. package/src/@claude-flow/shared/dist/core/event-bus.d.ts +0 -31
  324. package/src/@claude-flow/shared/dist/core/event-bus.js +0 -197
  325. package/src/@claude-flow/shared/dist/core/index.d.ts +0 -15
  326. package/src/@claude-flow/shared/dist/core/index.js +0 -19
  327. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +0 -200
  328. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.js +0 -6
  329. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +0 -310
  330. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +0 -7
  331. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +0 -224
  332. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.js +0 -46
  333. package/src/@claude-flow/shared/dist/core/interfaces/index.d.ts +0 -10
  334. package/src/@claude-flow/shared/dist/core/interfaces/index.js +0 -15
  335. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +0 -298
  336. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.js +0 -7
  337. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +0 -185
  338. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.js +0 -6
  339. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +0 -35
  340. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +0 -101
  341. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +0 -60
  342. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +0 -166
  343. package/src/@claude-flow/shared/dist/core/orchestrator/index.d.ts +0 -46
  344. package/src/@claude-flow/shared/dist/core/orchestrator/index.js +0 -64
  345. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +0 -56
  346. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +0 -195
  347. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +0 -83
  348. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.js +0 -193
  349. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +0 -49
  350. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.js +0 -253
  351. package/src/@claude-flow/shared/dist/events/domain-events.d.ts +0 -282
  352. package/src/@claude-flow/shared/dist/events/domain-events.js +0 -165
  353. package/src/@claude-flow/shared/dist/events/event-store.d.ts +0 -126
  354. package/src/@claude-flow/shared/dist/events/event-store.js +0 -416
  355. package/src/@claude-flow/shared/dist/events/event-store.test.d.ts +0 -8
  356. package/src/@claude-flow/shared/dist/events/event-store.test.js +0 -293
  357. package/src/@claude-flow/shared/dist/events/example-usage.d.ts +0 -10
  358. package/src/@claude-flow/shared/dist/events/example-usage.js +0 -193
  359. package/src/@claude-flow/shared/dist/events/index.d.ts +0 -21
  360. package/src/@claude-flow/shared/dist/events/index.js +0 -22
  361. package/src/@claude-flow/shared/dist/events/projections.d.ts +0 -177
  362. package/src/@claude-flow/shared/dist/events/projections.js +0 -421
  363. package/src/@claude-flow/shared/dist/events/rvf-event-log.d.ts +0 -82
  364. package/src/@claude-flow/shared/dist/events/rvf-event-log.js +0 -340
  365. package/src/@claude-flow/shared/dist/events/state-reconstructor.d.ts +0 -101
  366. package/src/@claude-flow/shared/dist/events/state-reconstructor.js +0 -263
  367. package/src/@claude-flow/shared/dist/events.d.ts +0 -80
  368. package/src/@claude-flow/shared/dist/events.js +0 -249
  369. package/src/@claude-flow/shared/dist/hooks/example-usage.d.ts +0 -42
  370. package/src/@claude-flow/shared/dist/hooks/example-usage.js +0 -351
  371. package/src/@claude-flow/shared/dist/hooks/executor.d.ts +0 -100
  372. package/src/@claude-flow/shared/dist/hooks/executor.js +0 -264
  373. package/src/@claude-flow/shared/dist/hooks/hooks.test.d.ts +0 -9
  374. package/src/@claude-flow/shared/dist/hooks/hooks.test.js +0 -322
  375. package/src/@claude-flow/shared/dist/hooks/index.d.ts +0 -52
  376. package/src/@claude-flow/shared/dist/hooks/index.js +0 -51
  377. package/src/@claude-flow/shared/dist/hooks/registry.d.ts +0 -133
  378. package/src/@claude-flow/shared/dist/hooks/registry.js +0 -277
  379. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +0 -105
  380. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.js +0 -481
  381. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +0 -144
  382. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.js +0 -328
  383. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +0 -158
  384. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.js +0 -450
  385. package/src/@claude-flow/shared/dist/hooks/safety/index.d.ts +0 -17
  386. package/src/@claude-flow/shared/dist/hooks/safety/index.js +0 -17
  387. package/src/@claude-flow/shared/dist/hooks/session-hooks.d.ts +0 -234
  388. package/src/@claude-flow/shared/dist/hooks/session-hooks.js +0 -334
  389. package/src/@claude-flow/shared/dist/hooks/task-hooks.d.ts +0 -163
  390. package/src/@claude-flow/shared/dist/hooks/task-hooks.js +0 -326
  391. package/src/@claude-flow/shared/dist/hooks/types.d.ts +0 -267
  392. package/src/@claude-flow/shared/dist/hooks/types.js +0 -62
  393. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +0 -9
  394. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.js +0 -93
  395. package/src/@claude-flow/shared/dist/index.d.ts +0 -20
  396. package/src/@claude-flow/shared/dist/index.js +0 -50
  397. package/src/@claude-flow/shared/dist/mcp/connection-pool.d.ts +0 -98
  398. package/src/@claude-flow/shared/dist/mcp/connection-pool.js +0 -364
  399. package/src/@claude-flow/shared/dist/mcp/index.d.ts +0 -69
  400. package/src/@claude-flow/shared/dist/mcp/index.js +0 -84
  401. package/src/@claude-flow/shared/dist/mcp/server.d.ts +0 -166
  402. package/src/@claude-flow/shared/dist/mcp/server.js +0 -593
  403. package/src/@claude-flow/shared/dist/mcp/session-manager.d.ts +0 -136
  404. package/src/@claude-flow/shared/dist/mcp/session-manager.js +0 -335
  405. package/src/@claude-flow/shared/dist/mcp/tool-registry.d.ts +0 -178
  406. package/src/@claude-flow/shared/dist/mcp/tool-registry.js +0 -439
  407. package/src/@claude-flow/shared/dist/mcp/transport/http.d.ts +0 -104
  408. package/src/@claude-flow/shared/dist/mcp/transport/http.js +0 -476
  409. package/src/@claude-flow/shared/dist/mcp/transport/index.d.ts +0 -102
  410. package/src/@claude-flow/shared/dist/mcp/transport/index.js +0 -238
  411. package/src/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +0 -104
  412. package/src/@claude-flow/shared/dist/mcp/transport/stdio.js +0 -263
  413. package/src/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +0 -133
  414. package/src/@claude-flow/shared/dist/mcp/transport/websocket.js +0 -396
  415. package/src/@claude-flow/shared/dist/mcp/types.d.ts +0 -438
  416. package/src/@claude-flow/shared/dist/mcp/types.js +0 -54
  417. package/src/@claude-flow/shared/dist/plugin-interface.d.ts +0 -544
  418. package/src/@claude-flow/shared/dist/plugin-interface.js +0 -23
  419. package/src/@claude-flow/shared/dist/plugin-loader.d.ts +0 -139
  420. package/src/@claude-flow/shared/dist/plugin-loader.js +0 -434
  421. package/src/@claude-flow/shared/dist/plugin-registry.d.ts +0 -183
  422. package/src/@claude-flow/shared/dist/plugin-registry.js +0 -457
  423. package/src/@claude-flow/shared/dist/plugins/index.d.ts +0 -10
  424. package/src/@claude-flow/shared/dist/plugins/index.js +0 -10
  425. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +0 -106
  426. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +0 -241
  427. package/src/@claude-flow/shared/dist/plugins/official/index.d.ts +0 -10
  428. package/src/@claude-flow/shared/dist/plugins/official/index.js +0 -10
  429. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +0 -121
  430. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +0 -355
  431. package/src/@claude-flow/shared/dist/plugins/types.d.ts +0 -93
  432. package/src/@claude-flow/shared/dist/plugins/types.js +0 -9
  433. package/src/@claude-flow/shared/dist/resilience/bulkhead.d.ts +0 -105
  434. package/src/@claude-flow/shared/dist/resilience/bulkhead.js +0 -206
  435. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +0 -132
  436. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.js +0 -233
  437. package/src/@claude-flow/shared/dist/resilience/index.d.ts +0 -19
  438. package/src/@claude-flow/shared/dist/resilience/index.js +0 -19
  439. package/src/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +0 -168
  440. package/src/@claude-flow/shared/dist/resilience/rate-limiter.js +0 -314
  441. package/src/@claude-flow/shared/dist/resilience/retry.d.ts +0 -91
  442. package/src/@claude-flow/shared/dist/resilience/retry.js +0 -159
  443. package/src/@claude-flow/shared/dist/security/index.d.ts +0 -10
  444. package/src/@claude-flow/shared/dist/security/index.js +0 -12
  445. package/src/@claude-flow/shared/dist/security/input-validation.d.ts +0 -73
  446. package/src/@claude-flow/shared/dist/security/input-validation.js +0 -201
  447. package/src/@claude-flow/shared/dist/security/secure-random.d.ts +0 -92
  448. package/src/@claude-flow/shared/dist/security/secure-random.js +0 -142
  449. package/src/@claude-flow/shared/dist/services/index.d.ts +0 -7
  450. package/src/@claude-flow/shared/dist/services/index.js +0 -7
  451. package/src/@claude-flow/shared/dist/services/v3-progress.service.d.ts +0 -124
  452. package/src/@claude-flow/shared/dist/services/v3-progress.service.js +0 -402
  453. package/src/@claude-flow/shared/dist/types/agent.types.d.ts +0 -137
  454. package/src/@claude-flow/shared/dist/types/agent.types.js +0 -6
  455. package/src/@claude-flow/shared/dist/types/index.d.ts +0 -11
  456. package/src/@claude-flow/shared/dist/types/index.js +0 -17
  457. package/src/@claude-flow/shared/dist/types/mcp.types.d.ts +0 -266
  458. package/src/@claude-flow/shared/dist/types/mcp.types.js +0 -7
  459. package/src/@claude-flow/shared/dist/types/memory.types.d.ts +0 -236
  460. package/src/@claude-flow/shared/dist/types/memory.types.js +0 -7
  461. package/src/@claude-flow/shared/dist/types/swarm.types.d.ts +0 -186
  462. package/src/@claude-flow/shared/dist/types/swarm.types.js +0 -65
  463. package/src/@claude-flow/shared/dist/types/task.types.d.ts +0 -178
  464. package/src/@claude-flow/shared/dist/types/task.types.js +0 -32
  465. package/src/@claude-flow/shared/dist/types.d.ts +0 -197
  466. package/src/@claude-flow/shared/dist/types.js +0 -21
  467. package/src/@claude-flow/shared/dist/utils/secure-logger.d.ts +0 -69
  468. package/src/@claude-flow/shared/dist/utils/secure-logger.js +0 -208
@@ -1,428 +1,428 @@
1
- ---
2
- name: swarm-pr
3
- description: Pull request swarm management agent that coordinates multi-agent code review, validation, and integration workflows with automated PR lifecycle management
4
- type: development
5
- color: "#4ECDC4"
6
- tools:
7
- - mcp__github__get_pull_request
8
- - mcp__github__create_pull_request
9
- - mcp__github__update_pull_request
10
- - mcp__github__list_pull_requests
11
- - mcp__github__create_pr_comment
12
- - mcp__github__get_pr_diff
13
- - mcp__github__merge_pull_request
14
- - mcp__moflo__swarm_init
15
- - mcp__moflo__agent_spawn
16
- - mcp__moflo__task_orchestrate
17
- - mcp__moflo__memory_usage
18
- - mcp__moflo__coordination_sync
19
- - TodoWrite
20
- - TodoRead
21
- - Bash
22
- - Grep
23
- - Read
24
- - Write
25
- - Edit
26
- hooks:
27
- pre:
28
- - "Initialize PR-specific swarm with diff analysis and impact assessment"
29
- - "Analyze PR complexity and assign optimal agent topology"
30
- - "Store PR metadata and diff context in swarm memory"
31
- post:
32
- - "Update PR with comprehensive swarm review results"
33
- - "Coordinate merge decisions based on swarm analysis"
34
- - "Generate PR completion metrics and learnings"
35
- ---
36
-
37
- # Swarm PR - Managing Swarms through Pull Requests
38
-
39
- ## Overview
40
- Create and manage AI swarms directly from GitHub Pull Requests, enabling seamless integration with your development workflow through intelligent multi-agent coordination.
41
-
42
- ## Core Features
43
-
44
- ### 1. PR-Based Swarm Creation
45
- ```bash
46
- # Create swarm from PR description using gh CLI
47
- gh pr view 123 --json body,title,labels,files | npx ruv-swarm swarm create-from-pr
48
-
49
- # Auto-spawn agents based on PR labels
50
- gh pr view 123 --json labels | npx ruv-swarm swarm auto-spawn
51
-
52
- # Create swarm with PR context
53
- gh pr view 123 --json body,labels,author,assignees | \
54
- npx ruv-swarm swarm init --from-pr-data
55
- ```
56
-
57
- ### 2. PR Comment Commands
58
- Execute swarm commands via PR comments:
59
-
60
- ```markdown
61
- <!-- In PR comment -->
62
- /swarm init mesh 6
63
- /swarm spawn coder "Implement authentication"
64
- /swarm spawn tester "Write unit tests"
65
- /swarm status
66
- ```
67
-
68
- ### 3. Automated PR Workflows
69
-
70
- ```yaml
71
- # .github/workflows/swarm-pr.yml
72
- name: Swarm PR Handler
73
- on:
74
- pull_request:
75
- types: [opened, labeled]
76
- issue_comment:
77
- types: [created]
78
-
79
- jobs:
80
- swarm-handler:
81
- runs-on: ubuntu-latest
82
- steps:
83
- - uses: actions/checkout@v3
84
- - name: Handle Swarm Command
85
- run: |
86
- if [[ "${{ github.event.comment.body }}" == /swarm* ]]; then
87
- npx ruv-swarm github handle-comment \
88
- --pr ${{ github.event.pull_request.number }} \
89
- --comment "${{ github.event.comment.body }}"
90
- fi
91
- ```
92
-
93
- ## PR Label Integration
94
-
95
- ### Automatic Agent Assignment
96
- Map PR labels to agent types:
97
-
98
- ```json
99
- {
100
- "label-mapping": {
101
- "bug": ["debugger", "tester"],
102
- "feature": ["architect", "coder", "tester"],
103
- "refactor": ["analyst", "coder"],
104
- "docs": ["researcher", "writer"],
105
- "performance": ["analyst", "optimizer"]
106
- }
107
- }
108
- ```
109
-
110
- ### Label-Based Topology
111
- ```bash
112
- # Small PR (< 100 lines): ring topology
113
- # Medium PR (100-500 lines): mesh topology
114
- # Large PR (> 500 lines): hierarchical topology
115
- npx ruv-swarm github pr-topology --pr 123
116
- ```
117
-
118
- ## PR Swarm Commands
119
-
120
- ### Initialize from PR
121
- ```bash
122
- # Create swarm with PR context using gh CLI
123
- PR_DIFF=$(gh pr diff 123)
124
- PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
125
-
126
- npx ruv-swarm github pr-init 123 \
127
- --auto-agents \
128
- --pr-data "$PR_INFO" \
129
- --diff "$PR_DIFF" \
130
- --analyze-impact
131
- ```
132
-
133
- ### Progress Updates
134
- ```bash
135
- # Post swarm progress to PR using gh CLI
136
- PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
137
-
138
- gh pr comment 123 --body "$PROGRESS"
139
-
140
- # Update PR labels based on progress
141
- if [[ $(echo "$PROGRESS" | grep -o '[0-9]\+%' | sed 's/%//') -gt 90 ]]; then
142
- gh pr edit 123 --add-label "ready-for-review"
143
- fi
144
- ```
145
-
146
- ### Code Review Integration
147
- ```bash
148
- # Create review agents with gh CLI integration
149
- PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
150
-
151
- # Run swarm review
152
- REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
153
- --agents "security,performance,style" \
154
- --files "$PR_FILES")
155
-
156
- # Post review comments using gh CLI
157
- echo "$REVIEW_RESULTS" | jq -r '.comments[]' | while read -r comment; do
158
- FILE=$(echo "$comment" | jq -r '.file')
159
- LINE=$(echo "$comment" | jq -r '.line')
160
- BODY=$(echo "$comment" | jq -r '.body')
161
-
162
- gh pr review 123 --comment --body "$BODY"
163
- done
164
- ```
165
-
166
- ## Advanced Features
167
-
168
- ### 1. Multi-PR Swarm Coordination
169
- ```bash
170
- # Coordinate swarms across related PRs
171
- npx ruv-swarm github multi-pr \
172
- --prs "123,124,125" \
173
- --strategy "parallel" \
174
- --share-memory
175
- ```
176
-
177
- ### 2. PR Dependency Analysis
178
- ```bash
179
- # Analyze PR dependencies
180
- npx ruv-swarm github pr-deps 123 \
181
- --spawn-agents \
182
- --resolve-conflicts
183
- ```
184
-
185
- ### 3. Automated PR Fixes
186
- ```bash
187
- # Auto-fix PR issues
188
- npx ruv-swarm github pr-fix 123 \
189
- --issues "lint,test-failures" \
190
- --commit-fixes
191
- ```
192
-
193
- ## Best Practices
194
-
195
- ### 1. PR Templates
196
- ```markdown
197
- <!-- .github/pull_request_template.md -->
198
- ## Swarm Configuration
199
- - Topology: [mesh/hierarchical/ring/star]
200
- - Max Agents: [number]
201
- - Auto-spawn: [yes/no]
202
- - Priority: [high/medium/low]
203
-
204
- ## Tasks for Swarm
205
- - [ ] Task 1 description
206
- - [ ] Task 2 description
207
- ```
208
-
209
- ### 2. Status Checks
210
- ```yaml
211
- # Require swarm completion before merge
212
- required_status_checks:
213
- contexts:
214
- - "swarm/tasks-complete"
215
- - "swarm/tests-pass"
216
- - "swarm/review-approved"
217
- ```
218
-
219
- ### 3. PR Merge Automation
220
- ```bash
221
- # Auto-merge when swarm completes using gh CLI
222
- # Check swarm completion status
223
- SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
224
-
225
- if [[ "$SWARM_STATUS" == "complete" ]]; then
226
- # Check review requirements
227
- REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')
228
-
229
- if [[ $REVIEWS -ge 2 ]]; then
230
- # Enable auto-merge
231
- gh pr merge 123 --auto --squash
232
- fi
233
- fi
234
- ```
235
-
236
- ## Webhook Integration
237
-
238
- ### Setup Webhook Handler
239
- ```javascript
240
- // webhook-handler.js
241
- const { createServer } = require('http');
242
- const { execSync } = require('child_process');
243
-
244
- createServer((req, res) => {
245
- if (req.url === '/github-webhook') {
246
- const event = JSON.parse(body);
247
-
248
- if (event.action === 'opened' && event.pull_request) {
249
- execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);
250
- }
251
-
252
- res.writeHead(200);
253
- res.end('OK');
254
- }
255
- }).listen(3000);
256
- ```
257
-
258
- ## Examples
259
-
260
- ### Feature Development PR
261
- ```bash
262
- # PR #456: Add user authentication
263
- npx ruv-swarm github pr-init 456 \
264
- --topology hierarchical \
265
- --agents "architect,coder,tester,security" \
266
- --auto-assign-tasks
267
- ```
268
-
269
- ### Bug Fix PR
270
- ```bash
271
- # PR #789: Fix memory leak
272
- npx ruv-swarm github pr-init 789 \
273
- --topology mesh \
274
- --agents "debugger,analyst,tester" \
275
- --priority high
276
- ```
277
-
278
- ### Documentation PR
279
- ```bash
280
- # PR #321: Update API docs
281
- npx ruv-swarm github pr-init 321 \
282
- --topology ring \
283
- --agents "researcher,writer,reviewer" \
284
- --validate-links
285
- ```
286
-
287
- ## Metrics & Reporting
288
-
289
- ### PR Swarm Analytics
290
- ```bash
291
- # Generate PR swarm report
292
- npx ruv-swarm github pr-report 123 \
293
- --metrics "completion-time,agent-efficiency,token-usage" \
294
- --format markdown
295
- ```
296
-
297
- ### Dashboard Integration
298
- ```bash
299
- # Export to GitHub Insights
300
- npx ruv-swarm github export-metrics \
301
- --pr 123 \
302
- --to-insights
303
- ```
304
-
305
- ## Security Considerations
306
-
307
- 1. **Token Permissions**: Ensure GitHub tokens have appropriate scopes
308
- 2. **Command Validation**: Validate all PR comments before execution
309
- 3. **Rate Limiting**: Implement rate limits for PR operations
310
- 4. **Audit Trail**: Log all swarm operations for compliance
311
-
312
- ## Integration with Claude Code
313
-
314
- When using with Claude Code:
315
- 1. Claude Code reads PR diff and context
316
- 2. Swarm coordinates approach based on PR type
317
- 3. Agents work in parallel on different aspects
318
- 4. Progress updates posted to PR automatically
319
- 5. Final review performed before marking ready
320
-
321
- ## Advanced Swarm PR Coordination
322
-
323
- ### Multi-Agent PR Analysis
324
- ```bash
325
- # Initialize PR-specific swarm with intelligent topology selection
326
- mcp__moflo__swarm_init { topology: "mesh", maxAgents: 8 }
327
- mcp__moflo__agent_spawn { type: "coordinator", name: "PR Coordinator" }
328
- mcp__moflo__agent_spawn { type: "reviewer", name: "Code Reviewer" }
329
- mcp__moflo__agent_spawn { type: "tester", name: "Test Engineer" }
330
- mcp__moflo__agent_spawn { type: "analyst", name: "Impact Analyzer" }
331
- mcp__moflo__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
332
-
333
- # Store PR context for swarm coordination
334
- mcp__moflo__memory_usage {
335
- action: "store",
336
- key: "pr/#{pr_number}/analysis",
337
- value: {
338
- diff: "pr_diff_content",
339
- files_changed: ["file1.js", "file2.py"],
340
- complexity_score: 8.5,
341
- risk_assessment: "medium"
342
- }
343
- }
344
-
345
- # Orchestrate comprehensive PR workflow
346
- mcp__moflo__task_orchestrate {
347
- task: "Execute multi-agent PR review and validation workflow",
348
- strategy: "parallel",
349
- priority: "high",
350
- dependencies: ["diff_analysis", "test_validation", "security_review"]
351
- }
352
- ```
353
-
354
- ### Swarm-Coordinated PR Lifecycle
355
- ```javascript
356
- // Pre-hook: PR Initialization and Swarm Setup
357
- const prPreHook = async (prData) => {
358
- // Analyze PR complexity for optimal swarm configuration
359
- const complexity = await analyzePRComplexity(prData);
360
- const topology = complexity > 7 ? "hierarchical" : "mesh";
361
-
362
- // Initialize swarm with PR-specific configuration
363
- await mcp__claude_flow__swarm_init({ topology, maxAgents: 8 });
364
-
365
- // Store comprehensive PR context
366
- await mcp__claude_flow__memory_usage({
367
- action: "store",
368
- key: `pr/${prData.number}/context`,
369
- value: {
370
- pr: prData,
371
- complexity,
372
- agents_assigned: await getOptimalAgents(prData),
373
- timeline: generateTimeline(prData)
374
- }
375
- });
376
-
377
- // Coordinate initial agent synchronization
378
- await mcp__claude_flow__coordination_sync({ swarmId: "current" });
379
- };
380
-
381
- // Post-hook: PR Completion and Metrics
382
- const prPostHook = async (results) => {
383
- // Generate comprehensive PR completion report
384
- const report = await generatePRReport(results);
385
-
386
- // Update PR with final swarm analysis
387
- await updatePRWithResults(report);
388
-
389
- // Store completion metrics for future optimization
390
- await mcp__claude_flow__memory_usage({
391
- action: "store",
392
- key: `pr/${results.number}/completion`,
393
- value: {
394
- completion_time: results.duration,
395
- agent_efficiency: results.agentMetrics,
396
- quality_score: results.qualityAssessment,
397
- lessons_learned: results.insights
398
- }
399
- });
400
- };
401
- ```
402
-
403
- ### Intelligent PR Merge Coordination
404
- ```bash
405
- # Coordinate merge decision with swarm consensus
406
- mcp__moflo__coordination_sync { swarmId: "pr-review-swarm" }
407
-
408
- # Analyze merge readiness with multiple agents
409
- mcp__moflo__task_orchestrate {
410
- task: "Evaluate PR merge readiness with comprehensive validation",
411
- strategy: "sequential",
412
- priority: "critical"
413
- }
414
-
415
- # Store merge decision context
416
- mcp__moflo__memory_usage {
417
- action: "store",
418
- key: "pr/merge_decisions/#{pr_number}",
419
- value: {
420
- ready_to_merge: true,
421
- validation_passed: true,
422
- agent_consensus: "approved",
423
- final_review_score: 9.2
424
- }
425
- }
426
- ```
427
-
1
+ ---
2
+ name: swarm-pr
3
+ description: Pull request swarm management agent that coordinates multi-agent code review, validation, and integration workflows with automated PR lifecycle management
4
+ type: development
5
+ color: "#4ECDC4"
6
+ tools:
7
+ - mcp__github__get_pull_request
8
+ - mcp__github__create_pull_request
9
+ - mcp__github__update_pull_request
10
+ - mcp__github__list_pull_requests
11
+ - mcp__github__create_pr_comment
12
+ - mcp__github__get_pr_diff
13
+ - mcp__github__merge_pull_request
14
+ - mcp__moflo__swarm_init
15
+ - mcp__moflo__agent_spawn
16
+ - mcp__moflo__task_orchestrate
17
+ - mcp__moflo__memory_usage
18
+ - mcp__moflo__coordination_sync
19
+ - TodoWrite
20
+ - TodoRead
21
+ - Bash
22
+ - Grep
23
+ - Read
24
+ - Write
25
+ - Edit
26
+ hooks:
27
+ pre:
28
+ - "Initialize PR-specific swarm with diff analysis and impact assessment"
29
+ - "Analyze PR complexity and assign optimal agent topology"
30
+ - "Store PR metadata and diff context in swarm memory"
31
+ post:
32
+ - "Update PR with comprehensive swarm review results"
33
+ - "Coordinate merge decisions based on swarm analysis"
34
+ - "Generate PR completion metrics and learnings"
35
+ ---
36
+
37
+ # Swarm PR - Managing Swarms through Pull Requests
38
+
39
+ ## Overview
40
+ Create and manage AI swarms directly from GitHub Pull Requests, enabling seamless integration with your development workflow through intelligent multi-agent coordination.
41
+
42
+ ## Core Features
43
+
44
+ ### 1. PR-Based Swarm Creation
45
+ ```bash
46
+ # Create swarm from PR description using gh CLI
47
+ gh pr view 123 --json body,title,labels,files | npx ruv-swarm swarm create-from-pr
48
+
49
+ # Auto-spawn agents based on PR labels
50
+ gh pr view 123 --json labels | npx ruv-swarm swarm auto-spawn
51
+
52
+ # Create swarm with PR context
53
+ gh pr view 123 --json body,labels,author,assignees | \
54
+ npx ruv-swarm swarm init --from-pr-data
55
+ ```
56
+
57
+ ### 2. PR Comment Commands
58
+ Execute swarm commands via PR comments:
59
+
60
+ ```markdown
61
+ <!-- In PR comment -->
62
+ /swarm init mesh 6
63
+ /swarm spawn coder "Implement authentication"
64
+ /swarm spawn tester "Write unit tests"
65
+ /swarm status
66
+ ```
67
+
68
+ ### 3. Automated PR Workflows
69
+
70
+ ```yaml
71
+ # .github/workflows/swarm-pr.yml
72
+ name: Swarm PR Handler
73
+ on:
74
+ pull_request:
75
+ types: [opened, labeled]
76
+ issue_comment:
77
+ types: [created]
78
+
79
+ jobs:
80
+ swarm-handler:
81
+ runs-on: ubuntu-latest
82
+ steps:
83
+ - uses: actions/checkout@v3
84
+ - name: Handle Swarm Command
85
+ run: |
86
+ if [[ "${{ github.event.comment.body }}" == /swarm* ]]; then
87
+ npx ruv-swarm github handle-comment \
88
+ --pr ${{ github.event.pull_request.number }} \
89
+ --comment "${{ github.event.comment.body }}"
90
+ fi
91
+ ```
92
+
93
+ ## PR Label Integration
94
+
95
+ ### Automatic Agent Assignment
96
+ Map PR labels to agent types:
97
+
98
+ ```json
99
+ {
100
+ "label-mapping": {
101
+ "bug": ["debugger", "tester"],
102
+ "feature": ["architect", "coder", "tester"],
103
+ "refactor": ["analyst", "coder"],
104
+ "docs": ["researcher", "writer"],
105
+ "performance": ["analyst", "optimizer"]
106
+ }
107
+ }
108
+ ```
109
+
110
+ ### Label-Based Topology
111
+ ```bash
112
+ # Small PR (< 100 lines): ring topology
113
+ # Medium PR (100-500 lines): mesh topology
114
+ # Large PR (> 500 lines): hierarchical topology
115
+ npx ruv-swarm github pr-topology --pr 123
116
+ ```
117
+
118
+ ## PR Swarm Commands
119
+
120
+ ### Initialize from PR
121
+ ```bash
122
+ # Create swarm with PR context using gh CLI
123
+ PR_DIFF=$(gh pr diff 123)
124
+ PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
125
+
126
+ npx ruv-swarm github pr-init 123 \
127
+ --auto-agents \
128
+ --pr-data "$PR_INFO" \
129
+ --diff "$PR_DIFF" \
130
+ --analyze-impact
131
+ ```
132
+
133
+ ### Progress Updates
134
+ ```bash
135
+ # Post swarm progress to PR using gh CLI
136
+ PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
137
+
138
+ gh pr comment 123 --body "$PROGRESS"
139
+
140
+ # Update PR labels based on progress
141
+ if [[ $(echo "$PROGRESS" | grep -o '[0-9]\+%' | sed 's/%//') -gt 90 ]]; then
142
+ gh pr edit 123 --add-label "ready-for-review"
143
+ fi
144
+ ```
145
+
146
+ ### Code Review Integration
147
+ ```bash
148
+ # Create review agents with gh CLI integration
149
+ PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
150
+
151
+ # Run swarm review
152
+ REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
153
+ --agents "security,performance,style" \
154
+ --files "$PR_FILES")
155
+
156
+ # Post review comments using gh CLI
157
+ echo "$REVIEW_RESULTS" | jq -r '.comments[]' | while read -r comment; do
158
+ FILE=$(echo "$comment" | jq -r '.file')
159
+ LINE=$(echo "$comment" | jq -r '.line')
160
+ BODY=$(echo "$comment" | jq -r '.body')
161
+
162
+ gh pr review 123 --comment --body "$BODY"
163
+ done
164
+ ```
165
+
166
+ ## Advanced Features
167
+
168
+ ### 1. Multi-PR Swarm Coordination
169
+ ```bash
170
+ # Coordinate swarms across related PRs
171
+ npx ruv-swarm github multi-pr \
172
+ --prs "123,124,125" \
173
+ --strategy "parallel" \
174
+ --share-memory
175
+ ```
176
+
177
+ ### 2. PR Dependency Analysis
178
+ ```bash
179
+ # Analyze PR dependencies
180
+ npx ruv-swarm github pr-deps 123 \
181
+ --spawn-agents \
182
+ --resolve-conflicts
183
+ ```
184
+
185
+ ### 3. Automated PR Fixes
186
+ ```bash
187
+ # Auto-fix PR issues
188
+ npx ruv-swarm github pr-fix 123 \
189
+ --issues "lint,test-failures" \
190
+ --commit-fixes
191
+ ```
192
+
193
+ ## Best Practices
194
+
195
+ ### 1. PR Templates
196
+ ```markdown
197
+ <!-- .github/pull_request_template.md -->
198
+ ## Swarm Configuration
199
+ - Topology: [mesh/hierarchical/ring/star]
200
+ - Max Agents: [number]
201
+ - Auto-spawn: [yes/no]
202
+ - Priority: [high/medium/low]
203
+
204
+ ## Tasks for Swarm
205
+ - [ ] Task 1 description
206
+ - [ ] Task 2 description
207
+ ```
208
+
209
+ ### 2. Status Checks
210
+ ```yaml
211
+ # Require swarm completion before merge
212
+ required_status_checks:
213
+ contexts:
214
+ - "swarm/tasks-complete"
215
+ - "swarm/tests-pass"
216
+ - "swarm/review-approved"
217
+ ```
218
+
219
+ ### 3. PR Merge Automation
220
+ ```bash
221
+ # Auto-merge when swarm completes using gh CLI
222
+ # Check swarm completion status
223
+ SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
224
+
225
+ if [[ "$SWARM_STATUS" == "complete" ]]; then
226
+ # Check review requirements
227
+ REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')
228
+
229
+ if [[ $REVIEWS -ge 2 ]]; then
230
+ # Enable auto-merge
231
+ gh pr merge 123 --auto --squash
232
+ fi
233
+ fi
234
+ ```
235
+
236
+ ## Webhook Integration
237
+
238
+ ### Setup Webhook Handler
239
+ ```javascript
240
+ // webhook-handler.js
241
+ const { createServer } = require('http');
242
+ const { execSync } = require('child_process');
243
+
244
+ createServer((req, res) => {
245
+ if (req.url === '/github-webhook') {
246
+ const event = JSON.parse(body);
247
+
248
+ if (event.action === 'opened' && event.pull_request) {
249
+ execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);
250
+ }
251
+
252
+ res.writeHead(200);
253
+ res.end('OK');
254
+ }
255
+ }).listen(3000);
256
+ ```
257
+
258
+ ## Examples
259
+
260
+ ### Feature Development PR
261
+ ```bash
262
+ # PR #456: Add user authentication
263
+ npx ruv-swarm github pr-init 456 \
264
+ --topology hierarchical \
265
+ --agents "architect,coder,tester,security" \
266
+ --auto-assign-tasks
267
+ ```
268
+
269
+ ### Bug Fix PR
270
+ ```bash
271
+ # PR #789: Fix memory leak
272
+ npx ruv-swarm github pr-init 789 \
273
+ --topology mesh \
274
+ --agents "debugger,analyst,tester" \
275
+ --priority high
276
+ ```
277
+
278
+ ### Documentation PR
279
+ ```bash
280
+ # PR #321: Update API docs
281
+ npx ruv-swarm github pr-init 321 \
282
+ --topology ring \
283
+ --agents "researcher,writer,reviewer" \
284
+ --validate-links
285
+ ```
286
+
287
+ ## Metrics & Reporting
288
+
289
+ ### PR Swarm Analytics
290
+ ```bash
291
+ # Generate PR swarm report
292
+ npx ruv-swarm github pr-report 123 \
293
+ --metrics "completion-time,agent-efficiency,token-usage" \
294
+ --format markdown
295
+ ```
296
+
297
+ ### Dashboard Integration
298
+ ```bash
299
+ # Export to GitHub Insights
300
+ npx ruv-swarm github export-metrics \
301
+ --pr 123 \
302
+ --to-insights
303
+ ```
304
+
305
+ ## Security Considerations
306
+
307
+ 1. **Token Permissions**: Ensure GitHub tokens have appropriate scopes
308
+ 2. **Command Validation**: Validate all PR comments before execution
309
+ 3. **Rate Limiting**: Implement rate limits for PR operations
310
+ 4. **Audit Trail**: Log all swarm operations for compliance
311
+
312
+ ## Integration with Claude Code
313
+
314
+ When using with Claude Code:
315
+ 1. Claude Code reads PR diff and context
316
+ 2. Swarm coordinates approach based on PR type
317
+ 3. Agents work in parallel on different aspects
318
+ 4. Progress updates posted to PR automatically
319
+ 5. Final review performed before marking ready
320
+
321
+ ## Advanced Swarm PR Coordination
322
+
323
+ ### Multi-Agent PR Analysis
324
+ ```bash
325
+ # Initialize PR-specific swarm with intelligent topology selection
326
+ mcp__moflo__swarm_init { topology: "mesh", maxAgents: 8 }
327
+ mcp__moflo__agent_spawn { type: "coordinator", name: "PR Coordinator" }
328
+ mcp__moflo__agent_spawn { type: "reviewer", name: "Code Reviewer" }
329
+ mcp__moflo__agent_spawn { type: "tester", name: "Test Engineer" }
330
+ mcp__moflo__agent_spawn { type: "analyst", name: "Impact Analyzer" }
331
+ mcp__moflo__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
332
+
333
+ # Store PR context for swarm coordination
334
+ mcp__moflo__memory_usage {
335
+ action: "store",
336
+ key: "pr/#{pr_number}/analysis",
337
+ value: {
338
+ diff: "pr_diff_content",
339
+ files_changed: ["file1.js", "file2.py"],
340
+ complexity_score: 8.5,
341
+ risk_assessment: "medium"
342
+ }
343
+ }
344
+
345
+ # Orchestrate comprehensive PR workflow
346
+ mcp__moflo__task_orchestrate {
347
+ task: "Execute multi-agent PR review and validation workflow",
348
+ strategy: "parallel",
349
+ priority: "high",
350
+ dependencies: ["diff_analysis", "test_validation", "security_review"]
351
+ }
352
+ ```
353
+
354
+ ### Swarm-Coordinated PR Lifecycle
355
+ ```javascript
356
+ // Pre-hook: PR Initialization and Swarm Setup
357
+ const prPreHook = async (prData) => {
358
+ // Analyze PR complexity for optimal swarm configuration
359
+ const complexity = await analyzePRComplexity(prData);
360
+ const topology = complexity > 7 ? "hierarchical" : "mesh";
361
+
362
+ // Initialize swarm with PR-specific configuration
363
+ await mcp__claude_flow__swarm_init({ topology, maxAgents: 8 });
364
+
365
+ // Store comprehensive PR context
366
+ await mcp__claude_flow__memory_usage({
367
+ action: "store",
368
+ key: `pr/${prData.number}/context`,
369
+ value: {
370
+ pr: prData,
371
+ complexity,
372
+ agents_assigned: await getOptimalAgents(prData),
373
+ timeline: generateTimeline(prData)
374
+ }
375
+ });
376
+
377
+ // Coordinate initial agent synchronization
378
+ await mcp__claude_flow__coordination_sync({ swarmId: "current" });
379
+ };
380
+
381
+ // Post-hook: PR Completion and Metrics
382
+ const prPostHook = async (results) => {
383
+ // Generate comprehensive PR completion report
384
+ const report = await generatePRReport(results);
385
+
386
+ // Update PR with final swarm analysis
387
+ await updatePRWithResults(report);
388
+
389
+ // Store completion metrics for future optimization
390
+ await mcp__claude_flow__memory_usage({
391
+ action: "store",
392
+ key: `pr/${results.number}/completion`,
393
+ value: {
394
+ completion_time: results.duration,
395
+ agent_efficiency: results.agentMetrics,
396
+ quality_score: results.qualityAssessment,
397
+ lessons_learned: results.insights
398
+ }
399
+ });
400
+ };
401
+ ```
402
+
403
+ ### Intelligent PR Merge Coordination
404
+ ```bash
405
+ # Coordinate merge decision with swarm consensus
406
+ mcp__moflo__coordination_sync { swarmId: "pr-review-swarm" }
407
+
408
+ # Analyze merge readiness with multiple agents
409
+ mcp__moflo__task_orchestrate {
410
+ task: "Evaluate PR merge readiness with comprehensive validation",
411
+ strategy: "sequential",
412
+ priority: "critical"
413
+ }
414
+
415
+ # Store merge decision context
416
+ mcp__moflo__memory_usage {
417
+ action: "store",
418
+ key: "pr/merge_decisions/#{pr_number}",
419
+ value: {
420
+ ready_to_merge: true,
421
+ validation_passed: true,
422
+ agent_consensus: "approved",
423
+ final_review_score: 9.2
424
+ }
425
+ }
426
+ ```
427
+
428
428
  See also: [swarm-issue.md](./swarm-issue.md), [sync-coordinator.md](./sync-coordinator.md), [workflow-automation.md](./workflow-automation.md)