@claude-flow/cli 3.7.0-alpha.1 → 3.7.0-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (476) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  2. package/.claude/agents/analysis/code-analyzer.md +209 -209
  3. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  4. package/.claude/agents/architecture/arch-system-design.md +156 -156
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/browser/browser-agent.yaml +182 -182
  7. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  8. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  9. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  10. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  11. package/.claude/agents/consensus/quorum-manager.md +822 -822
  12. package/.claude/agents/consensus/raft-manager.md +62 -62
  13. package/.claude/agents/consensus/security-manager.md +621 -621
  14. package/.claude/agents/core/coder.md +452 -452
  15. package/.claude/agents/core/planner.md +374 -374
  16. package/.claude/agents/core/researcher.md +368 -368
  17. package/.claude/agents/core/reviewer.md +519 -519
  18. package/.claude/agents/core/tester.md +511 -511
  19. package/.claude/agents/custom/test-long-runner.md +44 -44
  20. package/.claude/agents/data/data-ml-model.md +444 -444
  21. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  22. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  23. package/.claude/agents/development/dev-backend-api.md +344 -344
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  25. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  26. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  27. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  28. package/.claude/agents/flow-nexus/app-store.md +87 -87
  29. package/.claude/agents/flow-nexus/authentication.md +68 -68
  30. package/.claude/agents/flow-nexus/challenges.md +80 -80
  31. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  32. package/.claude/agents/flow-nexus/payments.md +82 -82
  33. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  34. package/.claude/agents/flow-nexus/swarm.md +75 -75
  35. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  36. package/.claude/agents/flow-nexus/workflow.md +83 -83
  37. package/.claude/agents/github/code-review-swarm.md +377 -377
  38. package/.claude/agents/github/github-modes.md +172 -172
  39. package/.claude/agents/github/issue-tracker.md +575 -575
  40. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  41. package/.claude/agents/github/pr-manager.md +437 -437
  42. package/.claude/agents/github/project-board-sync.md +508 -508
  43. package/.claude/agents/github/release-manager.md +604 -604
  44. package/.claude/agents/github/release-swarm.md +582 -582
  45. package/.claude/agents/github/repo-architect.md +397 -397
  46. package/.claude/agents/github/swarm-issue.md +572 -572
  47. package/.claude/agents/github/swarm-pr.md +427 -427
  48. package/.claude/agents/github/sync-coordinator.md +451 -451
  49. package/.claude/agents/github/workflow-automation.md +902 -902
  50. package/.claude/agents/goal/agent.md +815 -815
  51. package/.claude/agents/goal/goal-planner.md +72 -72
  52. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  53. package/.claude/agents/optimization/load-balancer.md +430 -430
  54. package/.claude/agents/optimization/performance-monitor.md +671 -671
  55. package/.claude/agents/optimization/resource-allocator.md +673 -673
  56. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  57. package/.claude/agents/payments/agentic-payments.md +126 -126
  58. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  59. package/.claude/agents/sparc/architecture.md +698 -698
  60. package/.claude/agents/sparc/pseudocode.md +519 -519
  61. package/.claude/agents/sparc/refinement.md +801 -801
  62. package/.claude/agents/sparc/specification.md +477 -477
  63. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  64. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  65. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  66. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  67. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  68. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  69. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  70. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  71. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  72. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  73. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  74. package/.claude/agents/templates/base-template-generator.md +289 -289
  75. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  76. package/.claude/agents/templates/github-pr-manager.md +176 -176
  77. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  78. package/.claude/agents/templates/memory-coordinator.md +186 -186
  79. package/.claude/agents/templates/orchestrator-task.md +138 -138
  80. package/.claude/agents/templates/performance-analyzer.md +198 -198
  81. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  82. package/.claude/agents/testing/production-validator.md +394 -394
  83. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  84. package/.claude/agents/v3/adr-architect.md +184 -184
  85. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  86. package/.claude/agents/v3/claims-authorizer.md +208 -208
  87. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  88. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  89. package/.claude/agents/v3/injection-analyst.md +236 -236
  90. package/.claude/agents/v3/memory-specialist.md +995 -995
  91. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  92. package/.claude/agents/v3/pii-detector.md +151 -151
  93. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  94. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  95. package/.claude/agents/v3/security-architect.md +867 -867
  96. package/.claude/agents/v3/security-auditor.md +771 -771
  97. package/.claude/agents/v3/sparc-orchestrator.md +182 -182
  98. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  99. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  100. package/.claude/commands/agents/README.md +50 -50
  101. package/.claude/commands/agents/agent-capabilities.md +140 -140
  102. package/.claude/commands/agents/agent-coordination.md +28 -28
  103. package/.claude/commands/agents/agent-spawning.md +28 -28
  104. package/.claude/commands/agents/agent-types.md +216 -216
  105. package/.claude/commands/agents/health.md +139 -139
  106. package/.claude/commands/agents/list.md +100 -100
  107. package/.claude/commands/agents/logs.md +130 -130
  108. package/.claude/commands/agents/metrics.md +122 -122
  109. package/.claude/commands/agents/pool.md +127 -127
  110. package/.claude/commands/agents/spawn.md +140 -140
  111. package/.claude/commands/agents/status.md +115 -115
  112. package/.claude/commands/agents/stop.md +102 -102
  113. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  114. package/.claude/commands/analysis/README.md +9 -9
  115. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  116. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  117. package/.claude/commands/analysis/performance-report.md +25 -25
  118. package/.claude/commands/analysis/token-efficiency.md +44 -44
  119. package/.claude/commands/analysis/token-usage.md +25 -25
  120. package/.claude/commands/automation/README.md +9 -9
  121. package/.claude/commands/automation/auto-agent.md +122 -122
  122. package/.claude/commands/automation/self-healing.md +105 -105
  123. package/.claude/commands/automation/session-memory.md +89 -89
  124. package/.claude/commands/automation/smart-agents.md +72 -72
  125. package/.claude/commands/automation/smart-spawn.md +25 -25
  126. package/.claude/commands/automation/workflow-select.md +25 -25
  127. package/.claude/commands/claude-flow-help.md +103 -103
  128. package/.claude/commands/claude-flow-memory.md +107 -107
  129. package/.claude/commands/claude-flow-swarm.md +205 -205
  130. package/.claude/commands/coordination/README.md +9 -9
  131. package/.claude/commands/coordination/agent-spawn.md +25 -25
  132. package/.claude/commands/coordination/init.md +44 -44
  133. package/.claude/commands/coordination/orchestrate.md +43 -43
  134. package/.claude/commands/coordination/spawn.md +45 -45
  135. package/.claude/commands/coordination/swarm-init.md +85 -85
  136. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  137. package/.claude/commands/flow-nexus/app-store.md +123 -123
  138. package/.claude/commands/flow-nexus/challenges.md +119 -119
  139. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  140. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  141. package/.claude/commands/flow-nexus/payments.md +115 -115
  142. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  143. package/.claude/commands/flow-nexus/swarm.md +86 -86
  144. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  145. package/.claude/commands/flow-nexus/workflow.md +114 -114
  146. package/.claude/commands/github/README.md +11 -11
  147. package/.claude/commands/github/code-review-swarm.md +513 -513
  148. package/.claude/commands/github/code-review.md +25 -25
  149. package/.claude/commands/github/github-modes.md +146 -146
  150. package/.claude/commands/github/github-swarm.md +121 -121
  151. package/.claude/commands/github/issue-tracker.md +291 -291
  152. package/.claude/commands/github/issue-triage.md +25 -25
  153. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  154. package/.claude/commands/github/pr-enhance.md +26 -26
  155. package/.claude/commands/github/pr-manager.md +169 -169
  156. package/.claude/commands/github/project-board-sync.md +470 -470
  157. package/.claude/commands/github/release-manager.md +337 -337
  158. package/.claude/commands/github/release-swarm.md +543 -543
  159. package/.claude/commands/github/repo-analyze.md +25 -25
  160. package/.claude/commands/github/repo-architect.md +366 -366
  161. package/.claude/commands/github/swarm-issue.md +481 -481
  162. package/.claude/commands/github/swarm-pr.md +284 -284
  163. package/.claude/commands/github/sync-coordinator.md +300 -300
  164. package/.claude/commands/github/workflow-automation.md +441 -441
  165. package/.claude/commands/hive-mind/README.md +17 -17
  166. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  167. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  168. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  170. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  173. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  175. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  177. package/.claude/commands/hooks/README.md +11 -11
  178. package/.claude/commands/hooks/overview.md +57 -57
  179. package/.claude/commands/hooks/post-edit.md +117 -117
  180. package/.claude/commands/hooks/post-task.md +112 -112
  181. package/.claude/commands/hooks/pre-edit.md +113 -113
  182. package/.claude/commands/hooks/pre-task.md +111 -111
  183. package/.claude/commands/hooks/session-end.md +118 -118
  184. package/.claude/commands/hooks/setup.md +102 -102
  185. package/.claude/commands/memory/README.md +9 -9
  186. package/.claude/commands/memory/memory-persist.md +25 -25
  187. package/.claude/commands/memory/memory-search.md +25 -25
  188. package/.claude/commands/memory/memory-usage.md +25 -25
  189. package/.claude/commands/memory/neural.md +47 -47
  190. package/.claude/commands/monitoring/README.md +9 -9
  191. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  192. package/.claude/commands/monitoring/agents.md +44 -44
  193. package/.claude/commands/monitoring/real-time-view.md +25 -25
  194. package/.claude/commands/monitoring/status.md +46 -46
  195. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  196. package/.claude/commands/optimization/README.md +9 -9
  197. package/.claude/commands/optimization/auto-topology.md +61 -61
  198. package/.claude/commands/optimization/cache-manage.md +25 -25
  199. package/.claude/commands/optimization/parallel-execute.md +25 -25
  200. package/.claude/commands/optimization/parallel-execution.md +49 -49
  201. package/.claude/commands/optimization/topology-optimize.md +25 -25
  202. package/.claude/commands/pair/README.md +260 -260
  203. package/.claude/commands/pair/commands.md +545 -545
  204. package/.claude/commands/pair/config.md +509 -509
  205. package/.claude/commands/pair/examples.md +511 -511
  206. package/.claude/commands/pair/modes.md +347 -347
  207. package/.claude/commands/pair/session.md +406 -406
  208. package/.claude/commands/pair/start.md +208 -208
  209. package/.claude/commands/sparc/analyzer.md +51 -51
  210. package/.claude/commands/sparc/architect.md +53 -53
  211. package/.claude/commands/sparc/ask.md +97 -97
  212. package/.claude/commands/sparc/batch-executor.md +54 -54
  213. package/.claude/commands/sparc/code.md +89 -89
  214. package/.claude/commands/sparc/coder.md +54 -54
  215. package/.claude/commands/sparc/debug.md +83 -83
  216. package/.claude/commands/sparc/debugger.md +54 -54
  217. package/.claude/commands/sparc/designer.md +53 -53
  218. package/.claude/commands/sparc/devops.md +109 -109
  219. package/.claude/commands/sparc/docs-writer.md +80 -80
  220. package/.claude/commands/sparc/documenter.md +54 -54
  221. package/.claude/commands/sparc/innovator.md +54 -54
  222. package/.claude/commands/sparc/integration.md +83 -83
  223. package/.claude/commands/sparc/mcp.md +117 -117
  224. package/.claude/commands/sparc/memory-manager.md +54 -54
  225. package/.claude/commands/sparc/optimizer.md +54 -54
  226. package/.claude/commands/sparc/orchestrator.md +131 -131
  227. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  228. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  229. package/.claude/commands/sparc/researcher.md +54 -54
  230. package/.claude/commands/sparc/reviewer.md +54 -54
  231. package/.claude/commands/sparc/security-review.md +80 -80
  232. package/.claude/commands/sparc/sparc-modes.md +174 -174
  233. package/.claude/commands/sparc/sparc.md +111 -111
  234. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  235. package/.claude/commands/sparc/supabase-admin.md +348 -348
  236. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  237. package/.claude/commands/sparc/tdd.md +54 -54
  238. package/.claude/commands/sparc/tester.md +54 -54
  239. package/.claude/commands/sparc/tutorial.md +79 -79
  240. package/.claude/commands/sparc/workflow-manager.md +54 -54
  241. package/.claude/commands/sparc.md +166 -166
  242. package/.claude/commands/stream-chain/pipeline.md +120 -120
  243. package/.claude/commands/stream-chain/run.md +69 -69
  244. package/.claude/commands/swarm/README.md +15 -15
  245. package/.claude/commands/swarm/analysis.md +95 -95
  246. package/.claude/commands/swarm/development.md +96 -96
  247. package/.claude/commands/swarm/examples.md +168 -168
  248. package/.claude/commands/swarm/maintenance.md +102 -102
  249. package/.claude/commands/swarm/optimization.md +117 -117
  250. package/.claude/commands/swarm/research.md +136 -136
  251. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  252. package/.claude/commands/swarm/swarm-background.md +8 -8
  253. package/.claude/commands/swarm/swarm-init.md +19 -19
  254. package/.claude/commands/swarm/swarm-modes.md +8 -8
  255. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  256. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  257. package/.claude/commands/swarm/swarm-status.md +8 -8
  258. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  259. package/.claude/commands/swarm/swarm.md +87 -87
  260. package/.claude/commands/swarm/testing.md +131 -131
  261. package/.claude/commands/training/README.md +9 -9
  262. package/.claude/commands/training/model-update.md +25 -25
  263. package/.claude/commands/training/neural-patterns.md +107 -107
  264. package/.claude/commands/training/neural-train.md +75 -75
  265. package/.claude/commands/training/pattern-learn.md +25 -25
  266. package/.claude/commands/training/specialization.md +62 -62
  267. package/.claude/commands/truth/start.md +142 -142
  268. package/.claude/commands/verify/check.md +49 -49
  269. package/.claude/commands/verify/start.md +127 -127
  270. package/.claude/commands/workflows/README.md +9 -9
  271. package/.claude/commands/workflows/development.md +77 -77
  272. package/.claude/commands/workflows/research.md +62 -62
  273. package/.claude/commands/workflows/workflow-create.md +25 -25
  274. package/.claude/commands/workflows/workflow-execute.md +25 -25
  275. package/.claude/commands/workflows/workflow-export.md +25 -25
  276. package/.claude/helpers/README.md +96 -96
  277. package/.claude/helpers/adr-compliance.sh +186 -186
  278. package/.claude/helpers/auto-commit.sh +178 -178
  279. package/.claude/helpers/auto-memory-hook.mjs +368 -368
  280. package/.claude/helpers/checkpoint-manager.sh +251 -251
  281. package/.claude/helpers/daemon-manager.sh +252 -252
  282. package/.claude/helpers/ddd-tracker.sh +144 -144
  283. package/.claude/helpers/github-safe.js +121 -121
  284. package/.claude/helpers/github-setup.sh +28 -28
  285. package/.claude/helpers/guidance-hook.sh +13 -13
  286. package/.claude/helpers/guidance-hooks.sh +102 -102
  287. package/.claude/helpers/health-monitor.sh +108 -108
  288. package/.claude/helpers/hook-handler.cjs +278 -278
  289. package/.claude/helpers/intelligence.cjs +1031 -1031
  290. package/.claude/helpers/learning-hooks.sh +329 -329
  291. package/.claude/helpers/learning-optimizer.sh +127 -127
  292. package/.claude/helpers/learning-service.mjs +1144 -1144
  293. package/.claude/helpers/memory.js +83 -83
  294. package/.claude/helpers/metrics-db.mjs +488 -488
  295. package/.claude/helpers/pattern-consolidator.sh +86 -86
  296. package/.claude/helpers/perf-worker.sh +160 -160
  297. package/.claude/helpers/post-commit +16 -16
  298. package/.claude/helpers/pre-commit +26 -26
  299. package/.claude/helpers/quick-start.sh +19 -19
  300. package/.claude/helpers/router.js +66 -66
  301. package/.claude/helpers/security-scanner.sh +127 -127
  302. package/.claude/helpers/session.js +135 -135
  303. package/.claude/helpers/setup-mcp.sh +18 -18
  304. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  305. package/.claude/helpers/statusline-hook.sh +21 -21
  306. package/.claude/helpers/statusline.cjs +575 -575
  307. package/.claude/helpers/statusline.js +321 -321
  308. package/.claude/helpers/swarm-comms.sh +353 -353
  309. package/.claude/helpers/swarm-hooks.sh +761 -761
  310. package/.claude/helpers/swarm-monitor.sh +210 -210
  311. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  312. package/.claude/helpers/update-v3-progress.sh +165 -165
  313. package/.claude/helpers/v3-quick-status.sh +57 -57
  314. package/.claude/helpers/v3.sh +110 -110
  315. package/.claude/helpers/validate-v3-config.sh +215 -215
  316. package/.claude/helpers/worker-manager.sh +170 -170
  317. package/.claude/settings.json +182 -182
  318. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  319. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  320. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  321. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  322. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  323. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  324. package/.claude/skills/aidefence-scan.md +151 -151
  325. package/.claude/skills/aidefence.yaml +297 -297
  326. package/.claude/skills/browser/SKILL.md +204 -204
  327. package/.claude/skills/flow-nexus-neural/SKILL.md +738 -738
  328. package/.claude/skills/flow-nexus-platform/SKILL.md +1157 -1157
  329. package/.claude/skills/flow-nexus-swarm/SKILL.md +610 -610
  330. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  331. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  332. package/.claude/skills/github-project-management/SKILL.md +1290 -1277
  333. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  334. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  335. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  336. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  337. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  338. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  339. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  340. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  341. package/.claude/skills/secure-review.md +181 -181
  342. package/.claude/skills/skill-builder/SKILL.md +910 -910
  343. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  344. package/.claude/skills/stream-chain/SKILL.md +563 -563
  345. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  346. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  347. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  348. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  349. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  350. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  351. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  352. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  353. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  354. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  355. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  356. package/.claude/skills/verification-quality/SKILL.md +649 -649
  357. package/.claude/skills/worker-benchmarks/skill.md +135 -135
  358. package/.claude/skills/worker-integration/skill.md +154 -154
  359. package/README.md +393 -391
  360. package/bin/cli.js +220 -220
  361. package/bin/mcp-server.js +224 -224
  362. package/bin/preinstall.cjs +2 -2
  363. package/dist/src/commands/agent-wasm.js +2 -2
  364. package/dist/src/commands/agent-wasm.js.map +1 -1
  365. package/dist/src/commands/completions.js +409 -409
  366. package/dist/src/commands/daemon.d.ts.map +1 -1
  367. package/dist/src/commands/daemon.js +19 -3
  368. package/dist/src/commands/daemon.js.map +1 -1
  369. package/dist/src/commands/doctor.d.ts.map +1 -1
  370. package/dist/src/commands/doctor.js +105 -23
  371. package/dist/src/commands/doctor.js.map +1 -1
  372. package/dist/src/commands/embeddings.js +26 -26
  373. package/dist/src/commands/hive-mind.d.ts.map +1 -1
  374. package/dist/src/commands/hive-mind.js +122 -104
  375. package/dist/src/commands/hive-mind.js.map +1 -1
  376. package/dist/src/commands/hooks.d.ts.map +1 -1
  377. package/dist/src/commands/hooks.js +34 -21
  378. package/dist/src/commands/hooks.js.map +1 -1
  379. package/dist/src/commands/memory.d.ts.map +1 -1
  380. package/dist/src/commands/memory.js +68 -0
  381. package/dist/src/commands/memory.js.map +1 -1
  382. package/dist/src/commands/ruvector/backup.js +23 -23
  383. package/dist/src/commands/ruvector/benchmark.js +31 -31
  384. package/dist/src/commands/ruvector/import.js +14 -14
  385. package/dist/src/commands/ruvector/init.js +115 -115
  386. package/dist/src/commands/ruvector/migrate.js +99 -99
  387. package/dist/src/commands/ruvector/optimize.js +51 -51
  388. package/dist/src/commands/ruvector/setup.js +624 -624
  389. package/dist/src/commands/ruvector/status.js +38 -38
  390. package/dist/src/index.d.ts +5 -1
  391. package/dist/src/index.d.ts.map +1 -1
  392. package/dist/src/index.js +59 -18
  393. package/dist/src/index.js.map +1 -1
  394. package/dist/src/init/claudemd-generator.js +226 -226
  395. package/dist/src/init/executor.d.ts.map +1 -1
  396. package/dist/src/init/executor.js +511 -453
  397. package/dist/src/init/executor.js.map +1 -1
  398. package/dist/src/init/helpers-generator.js +645 -645
  399. package/dist/src/init/settings-generator.d.ts.map +1 -1
  400. package/dist/src/init/settings-generator.js +11 -5
  401. package/dist/src/init/settings-generator.js.map +1 -1
  402. package/dist/src/init/statusline-generator.js +858 -858
  403. package/dist/src/init/types.d.ts +7 -0
  404. package/dist/src/init/types.d.ts.map +1 -1
  405. package/dist/src/init/types.js.map +1 -1
  406. package/dist/src/mcp-tools/agentdb-tools.d.ts +3 -0
  407. package/dist/src/mcp-tools/agentdb-tools.d.ts.map +1 -1
  408. package/dist/src/mcp-tools/agentdb-tools.js +108 -0
  409. package/dist/src/mcp-tools/agentdb-tools.js.map +1 -1
  410. package/dist/src/mcp-tools/hooks-tools.d.ts.map +1 -1
  411. package/dist/src/mcp-tools/hooks-tools.js +4 -2
  412. package/dist/src/mcp-tools/hooks-tools.js.map +1 -1
  413. package/dist/src/mcp-tools/memory-tools.d.ts.map +1 -1
  414. package/dist/src/mcp-tools/memory-tools.js +19 -0
  415. package/dist/src/mcp-tools/memory-tools.js.map +1 -1
  416. package/dist/src/mcp-tools/neural-tools.d.ts.map +1 -1
  417. package/dist/src/mcp-tools/neural-tools.js +14 -1
  418. package/dist/src/mcp-tools/neural-tools.js.map +1 -1
  419. package/dist/src/mcp-tools/security-tools.d.ts.map +1 -1
  420. package/dist/src/mcp-tools/security-tools.js +28 -3
  421. package/dist/src/mcp-tools/security-tools.js.map +1 -1
  422. package/dist/src/mcp-tools/swarm-tools.d.ts.map +1 -1
  423. package/dist/src/mcp-tools/swarm-tools.js +72 -3
  424. package/dist/src/mcp-tools/swarm-tools.js.map +1 -1
  425. package/dist/src/mcp-tools/wasm-agent-tools.js +1 -1
  426. package/dist/src/mcp-tools/wasm-agent-tools.js.map +1 -1
  427. package/dist/src/memory/intelligence.d.ts.map +1 -1
  428. package/dist/src/memory/intelligence.js +28 -3
  429. package/dist/src/memory/intelligence.js.map +1 -1
  430. package/dist/src/memory/memory-bridge.d.ts +69 -0
  431. package/dist/src/memory/memory-bridge.d.ts.map +1 -1
  432. package/dist/src/memory/memory-bridge.js +319 -66
  433. package/dist/src/memory/memory-bridge.js.map +1 -1
  434. package/dist/src/memory/memory-initializer.d.ts +5 -0
  435. package/dist/src/memory/memory-initializer.d.ts.map +1 -1
  436. package/dist/src/memory/memory-initializer.js +369 -363
  437. package/dist/src/memory/memory-initializer.js.map +1 -1
  438. package/dist/src/memory/neural-package-bridge.d.ts +48 -0
  439. package/dist/src/memory/neural-package-bridge.d.ts.map +1 -0
  440. package/dist/src/memory/neural-package-bridge.js +87 -0
  441. package/dist/src/memory/neural-package-bridge.js.map +1 -0
  442. package/dist/src/memory/rabitq-index.js +5 -5
  443. package/dist/src/memory/sona-optimizer.d.ts.map +1 -1
  444. package/dist/src/memory/sona-optimizer.js +1 -0
  445. package/dist/src/memory/sona-optimizer.js.map +1 -1
  446. package/dist/src/parser.d.ts +9 -0
  447. package/dist/src/parser.d.ts.map +1 -1
  448. package/dist/src/parser.js +11 -0
  449. package/dist/src/parser.js.map +1 -1
  450. package/dist/src/runtime/headless.js +28 -28
  451. package/dist/src/ruvector/agent-wasm.d.ts.map +1 -1
  452. package/dist/src/ruvector/agent-wasm.js +4 -1
  453. package/dist/src/ruvector/agent-wasm.js.map +1 -1
  454. package/dist/src/ruvector/index.d.ts +0 -2
  455. package/dist/src/ruvector/index.d.ts.map +1 -1
  456. package/dist/src/ruvector/index.js +8 -2
  457. package/dist/src/ruvector/index.js.map +1 -1
  458. package/dist/src/ruvector/model-router.d.ts +22 -1
  459. package/dist/src/ruvector/model-router.d.ts.map +1 -1
  460. package/dist/src/ruvector/model-router.js +125 -5
  461. package/dist/src/ruvector/model-router.js.map +1 -1
  462. package/dist/src/services/headless-worker-executor.js +84 -84
  463. package/dist/src/transfer/deploy-seraphine.js +23 -23
  464. package/dist/tsconfig.tsbuildinfo +1 -1
  465. package/package.json +5 -4
  466. package/scripts/deploy-ipfs-node.sh +153 -153
  467. package/scripts/postinstall.cjs +153 -153
  468. package/scripts/publish-registry.ts +345 -345
  469. package/scripts/publish.sh +57 -57
  470. package/scripts/setup-ipfs-registry.md +366 -366
  471. package/dist/src/services/event-stream.d.ts.map +0 -1
  472. package/dist/src/services/event-stream.js.map +0 -1
  473. package/dist/src/services/loop-worker-runner.d.ts.map +0 -1
  474. package/dist/src/services/loop-worker-runner.js.map +0 -1
  475. package/dist/src/services/runtime-capabilities.d.ts.map +0 -1
  476. package/dist/src/services/runtime-capabilities.js.map +0 -1
@@ -1,514 +1,514 @@
1
- # Code Review Swarm - Automated Code Review with AI Agents
2
-
3
- ## Overview
4
- Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis.
5
-
6
- ## Core Features
7
-
8
- ### 1. Multi-Agent Review System
9
- ```bash
10
- # Initialize code review swarm with gh CLI
11
- # Get PR details
12
- PR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)
13
- PR_DIFF=$(gh pr diff 123)
14
-
15
- # Initialize swarm with PR context
16
- npx ruv-swarm github review-init \
17
- --pr 123 \
18
- --pr-data "$PR_DATA" \
19
- --diff "$PR_DIFF" \
20
- --agents "security,performance,style,architecture,accessibility" \
21
- --depth comprehensive
22
-
23
- # Post initial review status
24
- gh pr comment 123 --body "🔍 Multi-agent code review initiated"
25
- ```
26
-
27
- ### 2. Specialized Review Agents
28
-
29
- #### Security Agent
30
- ```bash
31
- # Security-focused review with gh CLI
32
- # Get changed files
33
- CHANGED_FILES=$(gh pr view 123 --json files --jq '.files[].path')
34
-
35
- # Run security review
36
- SECURITY_RESULTS=$(npx ruv-swarm github review-security \
37
- --pr 123 \
38
- --files "$CHANGED_FILES" \
39
- --check "owasp,cve,secrets,permissions" \
40
- --suggest-fixes)
41
-
42
- # Post security findings
43
- if echo "$SECURITY_RESULTS" | grep -q "critical"; then
44
- # Request changes for critical issues
45
- gh pr review 123 --request-changes --body "$SECURITY_RESULTS"
46
- # Add security label
47
- gh pr edit 123 --add-label "security-review-required"
48
- else
49
- # Post as comment for non-critical issues
50
- gh pr comment 123 --body "$SECURITY_RESULTS"
51
- fi
52
- ```
53
-
54
- #### Performance Agent
55
- ```bash
56
- # Performance analysis
57
- npx ruv-swarm github review-performance \
58
- --pr 123 \
59
- --profile "cpu,memory,io" \
60
- --benchmark-against main \
61
- --suggest-optimizations
62
- ```
63
-
64
- #### Architecture Agent
65
- ```bash
66
- # Architecture review
67
- npx ruv-swarm github review-architecture \
68
- --pr 123 \
69
- --check "patterns,coupling,cohesion,solid" \
70
- --visualize-impact \
71
- --suggest-refactoring
72
- ```
73
-
74
- ### 3. Review Configuration
75
- ```yaml
76
- # .github/review-swarm.yml
77
- version: 1
78
- review:
79
- auto-trigger: true
80
- required-agents:
81
- - security
82
- - performance
83
- - style
84
- optional-agents:
85
- - architecture
86
- - accessibility
87
- - i18n
88
-
89
- thresholds:
90
- security: block
91
- performance: warn
92
- style: suggest
93
-
94
- rules:
95
- security:
96
- - no-eval
97
- - no-hardcoded-secrets
98
- - proper-auth-checks
99
- performance:
100
- - no-n-plus-one
101
- - efficient-queries
102
- - proper-caching
103
- architecture:
104
- - max-coupling: 5
105
- - min-cohesion: 0.7
106
- - follow-patterns
107
- ```
108
-
109
- ## Review Agents
110
-
111
- ### Security Review Agent
112
- ```javascript
113
- // Security checks performed
114
- {
115
- "checks": [
116
- "SQL injection vulnerabilities",
117
- "XSS attack vectors",
118
- "Authentication bypasses",
119
- "Authorization flaws",
120
- "Cryptographic weaknesses",
121
- "Dependency vulnerabilities",
122
- "Secret exposure",
123
- "CORS misconfigurations"
124
- ],
125
- "actions": [
126
- "Block PR on critical issues",
127
- "Suggest secure alternatives",
128
- "Add security test cases",
129
- "Update security documentation"
130
- ]
131
- }
132
- ```
133
-
134
- ### Performance Review Agent
135
- ```javascript
136
- // Performance analysis
137
- {
138
- "metrics": [
139
- "Algorithm complexity",
140
- "Database query efficiency",
141
- "Memory allocation patterns",
142
- "Cache utilization",
143
- "Network request optimization",
144
- "Bundle size impact",
145
- "Render performance"
146
- ],
147
- "benchmarks": [
148
- "Compare with baseline",
149
- "Load test simulations",
150
- "Memory leak detection",
151
- "Bottleneck identification"
152
- ]
153
- }
154
- ```
155
-
156
- ### Style & Convention Agent
157
- ```javascript
158
- // Style enforcement
159
- {
160
- "checks": [
161
- "Code formatting",
162
- "Naming conventions",
163
- "Documentation standards",
164
- "Comment quality",
165
- "Test coverage",
166
- "Error handling patterns",
167
- "Logging standards"
168
- ],
169
- "auto-fix": [
170
- "Formatting issues",
171
- "Import organization",
172
- "Trailing whitespace",
173
- "Simple naming issues"
174
- ]
175
- }
176
- ```
177
-
178
- ### Architecture Review Agent
179
- ```javascript
180
- // Architecture analysis
181
- {
182
- "patterns": [
183
- "Design pattern adherence",
184
- "SOLID principles",
185
- "DRY violations",
186
- "Separation of concerns",
187
- "Dependency injection",
188
- "Layer violations",
189
- "Circular dependencies"
190
- ],
191
- "metrics": [
192
- "Coupling metrics",
193
- "Cohesion scores",
194
- "Complexity measures",
195
- "Maintainability index"
196
- ]
197
- }
198
- ```
199
-
200
- ## Advanced Review Features
201
-
202
- ### 1. Context-Aware Reviews
203
- ```bash
204
- # Review with full context
205
- npx ruv-swarm github review-context \
206
- --pr 123 \
207
- --load-related-prs \
208
- --analyze-impact \
209
- --check-breaking-changes
210
- ```
211
-
212
- ### 2. Learning from History
213
- ```bash
214
- # Learn from past reviews
215
- npx ruv-swarm github review-learn \
216
- --analyze-past-reviews \
217
- --identify-patterns \
218
- --improve-suggestions \
219
- --reduce-false-positives
220
- ```
221
-
222
- ### 3. Cross-PR Analysis
223
- ```bash
224
- # Analyze related PRs together
225
- npx ruv-swarm github review-batch \
226
- --prs "123,124,125" \
227
- --check-consistency \
228
- --verify-integration \
229
- --combined-impact
230
- ```
231
-
232
- ## Review Automation
233
-
234
- ### Auto-Review on Push
235
- ```yaml
236
- # .github/workflows/auto-review.yml
237
- name: Automated Code Review
238
- on:
239
- pull_request:
240
- types: [opened, synchronize]
241
-
242
- jobs:
243
- swarm-review:
244
- runs-on: ubuntu-latest
245
- steps:
246
- - uses: actions/checkout@v3
247
- with:
248
- fetch-depth: 0
249
-
250
- - name: Setup GitHub CLI
251
- run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
252
-
253
- - name: Run Review Swarm
254
- run: |
255
- # Get PR context with gh CLI
256
- PR_NUM=${{ github.event.pull_request.number }}
257
- PR_DATA=$(gh pr view $PR_NUM --json files,title,body,labels)
258
-
259
- # Run swarm review
260
- REVIEW_OUTPUT=$(npx ruv-swarm github review-all \
261
- --pr $PR_NUM \
262
- --pr-data "$PR_DATA" \
263
- --agents "security,performance,style,architecture")
264
-
265
- # Post review results
266
- echo "$REVIEW_OUTPUT" | gh pr review $PR_NUM --comment -F -
267
-
268
- # Update PR status
269
- if echo "$REVIEW_OUTPUT" | grep -q "approved"; then
270
- gh pr review $PR_NUM --approve
271
- elif echo "$REVIEW_OUTPUT" | grep -q "changes-requested"; then
272
- gh pr review $PR_NUM --request-changes -b "See review comments above"
273
- fi
274
- ```
275
-
276
- ### Review Triggers
277
- ```javascript
278
- // Custom review triggers
279
- {
280
- "triggers": {
281
- "high-risk-files": {
282
- "paths": ["**/auth/**", "**/payment/**"],
283
- "agents": ["security", "architecture"],
284
- "depth": "comprehensive"
285
- },
286
- "performance-critical": {
287
- "paths": ["**/api/**", "**/database/**"],
288
- "agents": ["performance", "database"],
289
- "benchmarks": true
290
- },
291
- "ui-changes": {
292
- "paths": ["**/components/**", "**/styles/**"],
293
- "agents": ["accessibility", "style", "i18n"],
294
- "visual-tests": true
295
- }
296
- }
297
- }
298
- ```
299
-
300
- ## Review Comments
301
-
302
- ### Intelligent Comment Generation
303
- ```bash
304
- # Generate contextual review comments with gh CLI
305
- # Get PR diff with context
306
- PR_DIFF=$(gh pr diff 123 --color never)
307
- PR_FILES=$(gh pr view 123 --json files)
308
-
309
- # Generate review comments
310
- COMMENTS=$(npx ruv-swarm github review-comment \
311
- --pr 123 \
312
- --diff "$PR_DIFF" \
313
- --files "$PR_FILES" \
314
- --style "constructive" \
315
- --include-examples \
316
- --suggest-fixes)
317
-
318
- # Post comments using gh CLI
319
- echo "$COMMENTS" | jq -c '.[]' | while read -r comment; do
320
- FILE=$(echo "$comment" | jq -r '.path')
321
- LINE=$(echo "$comment" | jq -r '.line')
322
- BODY=$(echo "$comment" | jq -r '.body')
323
-
324
- # Create review with inline comments
325
- gh api \
326
- --method POST \
327
- /repos/:owner/:repo/pulls/123/comments \
328
- -f path="$FILE" \
329
- -f line="$LINE" \
330
- -f body="$BODY" \
331
- -f commit_id="$(gh pr view 123 --json headRefOid -q .headRefOid)"
332
- done
333
- ```
334
-
335
- ### Comment Templates
336
- ```markdown
337
- <!-- Security Issue Template -->
338
- 🔒 **Security Issue: [Type]**
339
-
340
- **Severity**: 🔴 Critical / 🟡 High / 🟢 Low
341
-
342
- **Description**:
343
- [Clear explanation of the security issue]
344
-
345
- **Impact**:
346
- [Potential consequences if not addressed]
347
-
348
- **Suggested Fix**:
349
- ```language
350
- [Code example of the fix]
351
- ```
352
-
353
- **References**:
354
- - [OWASP Guide](link)
355
- - [Security Best Practices](link)
356
- ```
357
-
358
- ### Batch Comment Management
359
- ```bash
360
- # Manage review comments efficiently
361
- npx ruv-swarm github review-comments \
362
- --pr 123 \
363
- --group-by "agent,severity" \
364
- --summarize \
365
- --resolve-outdated
366
- ```
367
-
368
- ## Integration with CI/CD
369
-
370
- ### Status Checks
371
- ```yaml
372
- # Required status checks
373
- protection_rules:
374
- required_status_checks:
375
- contexts:
376
- - "review-swarm/security"
377
- - "review-swarm/performance"
378
- - "review-swarm/architecture"
379
- ```
380
-
381
- ### Quality Gates
382
- ```bash
383
- # Define quality gates
384
- npx ruv-swarm github quality-gates \
385
- --define '{
386
- "security": {"threshold": "no-critical"},
387
- "performance": {"regression": "<5%"},
388
- "coverage": {"minimum": "80%"},
389
- "architecture": {"complexity": "<10"}
390
- }'
391
- ```
392
-
393
- ### Review Metrics
394
- ```bash
395
- # Track review effectiveness
396
- npx ruv-swarm github review-metrics \
397
- --period 30d \
398
- --metrics "issues-found,false-positives,fix-rate" \
399
- --export-dashboard
400
- ```
401
-
402
- ## Best Practices
403
-
404
- ### 1. Review Configuration
405
- - Define clear review criteria
406
- - Set appropriate thresholds
407
- - Configure agent specializations
408
- - Establish override procedures
409
-
410
- ### 2. Comment Quality
411
- - Provide actionable feedback
412
- - Include code examples
413
- - Reference documentation
414
- - Maintain respectful tone
415
-
416
- ### 3. Performance
417
- - Cache analysis results
418
- - Incremental reviews for large PRs
419
- - Parallel agent execution
420
- - Smart comment batching
421
-
422
- ## Advanced Features
423
-
424
- ### 1. AI Learning
425
- ```bash
426
- # Train on your codebase
427
- npx ruv-swarm github review-train \
428
- --learn-patterns \
429
- --adapt-to-style \
430
- --improve-accuracy
431
- ```
432
-
433
- ### 2. Custom Review Agents
434
- ```javascript
435
- // Create custom review agent
436
- class CustomReviewAgent {
437
- async review(pr) {
438
- const issues = [];
439
-
440
- // Custom logic here
441
- if (await this.checkCustomRule(pr)) {
442
- issues.push({
443
- severity: 'warning',
444
- message: 'Custom rule violation',
445
- suggestion: 'Fix suggestion'
446
- });
447
- }
448
-
449
- return issues;
450
- }
451
- }
452
- ```
453
-
454
- ### 3. Review Orchestration
455
- ```bash
456
- # Orchestrate complex reviews
457
- npx ruv-swarm github review-orchestrate \
458
- --strategy "risk-based" \
459
- --allocate-time-budget \
460
- --prioritize-critical
461
- ```
462
-
463
- ## Examples
464
-
465
- ### Security-Critical PR
466
- ```bash
467
- # Auth system changes
468
- npx ruv-swarm github review-init \
469
- --pr 456 \
470
- --agents "security,authentication,audit" \
471
- --depth "maximum" \
472
- --require-security-approval
473
- ```
474
-
475
- ### Performance-Sensitive PR
476
- ```bash
477
- # Database optimization
478
- npx ruv-swarm github review-init \
479
- --pr 789 \
480
- --agents "performance,database,caching" \
481
- --benchmark \
482
- --profile
483
- ```
484
-
485
- ### UI Component PR
486
- ```bash
487
- # New component library
488
- npx ruv-swarm github review-init \
489
- --pr 321 \
490
- --agents "accessibility,style,i18n,docs" \
491
- --visual-regression \
492
- --component-tests
493
- ```
494
-
495
- ## Monitoring & Analytics
496
-
497
- ### Review Dashboard
498
- ```bash
499
- # Launch review dashboard
500
- npx ruv-swarm github review-dashboard \
501
- --real-time \
502
- --show "agent-activity,issue-trends,fix-rates"
503
- ```
504
-
505
- ### Review Reports
506
- ```bash
507
- # Generate review reports
508
- npx ruv-swarm github review-report \
509
- --format "markdown" \
510
- --include "summary,details,trends" \
511
- --email-stakeholders
512
- ```
513
-
1
+ # Code Review Swarm - Automated Code Review with AI Agents
2
+
3
+ ## Overview
4
+ Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis.
5
+
6
+ ## Core Features
7
+
8
+ ### 1. Multi-Agent Review System
9
+ ```bash
10
+ # Initialize code review swarm with gh CLI
11
+ # Get PR details
12
+ PR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)
13
+ PR_DIFF=$(gh pr diff 123)
14
+
15
+ # Initialize swarm with PR context
16
+ npx ruv-swarm github review-init \
17
+ --pr 123 \
18
+ --pr-data "$PR_DATA" \
19
+ --diff "$PR_DIFF" \
20
+ --agents "security,performance,style,architecture,accessibility" \
21
+ --depth comprehensive
22
+
23
+ # Post initial review status
24
+ gh pr comment 123 --body "🔍 Multi-agent code review initiated"
25
+ ```
26
+
27
+ ### 2. Specialized Review Agents
28
+
29
+ #### Security Agent
30
+ ```bash
31
+ # Security-focused review with gh CLI
32
+ # Get changed files
33
+ CHANGED_FILES=$(gh pr view 123 --json files --jq '.files[].path')
34
+
35
+ # Run security review
36
+ SECURITY_RESULTS=$(npx ruv-swarm github review-security \
37
+ --pr 123 \
38
+ --files "$CHANGED_FILES" \
39
+ --check "owasp,cve,secrets,permissions" \
40
+ --suggest-fixes)
41
+
42
+ # Post security findings
43
+ if echo "$SECURITY_RESULTS" | grep -q "critical"; then
44
+ # Request changes for critical issues
45
+ gh pr review 123 --request-changes --body "$SECURITY_RESULTS"
46
+ # Add security label
47
+ gh pr edit 123 --add-label "security-review-required"
48
+ else
49
+ # Post as comment for non-critical issues
50
+ gh pr comment 123 --body "$SECURITY_RESULTS"
51
+ fi
52
+ ```
53
+
54
+ #### Performance Agent
55
+ ```bash
56
+ # Performance analysis
57
+ npx ruv-swarm github review-performance \
58
+ --pr 123 \
59
+ --profile "cpu,memory,io" \
60
+ --benchmark-against main \
61
+ --suggest-optimizations
62
+ ```
63
+
64
+ #### Architecture Agent
65
+ ```bash
66
+ # Architecture review
67
+ npx ruv-swarm github review-architecture \
68
+ --pr 123 \
69
+ --check "patterns,coupling,cohesion,solid" \
70
+ --visualize-impact \
71
+ --suggest-refactoring
72
+ ```
73
+
74
+ ### 3. Review Configuration
75
+ ```yaml
76
+ # .github/review-swarm.yml
77
+ version: 1
78
+ review:
79
+ auto-trigger: true
80
+ required-agents:
81
+ - security
82
+ - performance
83
+ - style
84
+ optional-agents:
85
+ - architecture
86
+ - accessibility
87
+ - i18n
88
+
89
+ thresholds:
90
+ security: block
91
+ performance: warn
92
+ style: suggest
93
+
94
+ rules:
95
+ security:
96
+ - no-eval
97
+ - no-hardcoded-secrets
98
+ - proper-auth-checks
99
+ performance:
100
+ - no-n-plus-one
101
+ - efficient-queries
102
+ - proper-caching
103
+ architecture:
104
+ - max-coupling: 5
105
+ - min-cohesion: 0.7
106
+ - follow-patterns
107
+ ```
108
+
109
+ ## Review Agents
110
+
111
+ ### Security Review Agent
112
+ ```javascript
113
+ // Security checks performed
114
+ {
115
+ "checks": [
116
+ "SQL injection vulnerabilities",
117
+ "XSS attack vectors",
118
+ "Authentication bypasses",
119
+ "Authorization flaws",
120
+ "Cryptographic weaknesses",
121
+ "Dependency vulnerabilities",
122
+ "Secret exposure",
123
+ "CORS misconfigurations"
124
+ ],
125
+ "actions": [
126
+ "Block PR on critical issues",
127
+ "Suggest secure alternatives",
128
+ "Add security test cases",
129
+ "Update security documentation"
130
+ ]
131
+ }
132
+ ```
133
+
134
+ ### Performance Review Agent
135
+ ```javascript
136
+ // Performance analysis
137
+ {
138
+ "metrics": [
139
+ "Algorithm complexity",
140
+ "Database query efficiency",
141
+ "Memory allocation patterns",
142
+ "Cache utilization",
143
+ "Network request optimization",
144
+ "Bundle size impact",
145
+ "Render performance"
146
+ ],
147
+ "benchmarks": [
148
+ "Compare with baseline",
149
+ "Load test simulations",
150
+ "Memory leak detection",
151
+ "Bottleneck identification"
152
+ ]
153
+ }
154
+ ```
155
+
156
+ ### Style & Convention Agent
157
+ ```javascript
158
+ // Style enforcement
159
+ {
160
+ "checks": [
161
+ "Code formatting",
162
+ "Naming conventions",
163
+ "Documentation standards",
164
+ "Comment quality",
165
+ "Test coverage",
166
+ "Error handling patterns",
167
+ "Logging standards"
168
+ ],
169
+ "auto-fix": [
170
+ "Formatting issues",
171
+ "Import organization",
172
+ "Trailing whitespace",
173
+ "Simple naming issues"
174
+ ]
175
+ }
176
+ ```
177
+
178
+ ### Architecture Review Agent
179
+ ```javascript
180
+ // Architecture analysis
181
+ {
182
+ "patterns": [
183
+ "Design pattern adherence",
184
+ "SOLID principles",
185
+ "DRY violations",
186
+ "Separation of concerns",
187
+ "Dependency injection",
188
+ "Layer violations",
189
+ "Circular dependencies"
190
+ ],
191
+ "metrics": [
192
+ "Coupling metrics",
193
+ "Cohesion scores",
194
+ "Complexity measures",
195
+ "Maintainability index"
196
+ ]
197
+ }
198
+ ```
199
+
200
+ ## Advanced Review Features
201
+
202
+ ### 1. Context-Aware Reviews
203
+ ```bash
204
+ # Review with full context
205
+ npx ruv-swarm github review-context \
206
+ --pr 123 \
207
+ --load-related-prs \
208
+ --analyze-impact \
209
+ --check-breaking-changes
210
+ ```
211
+
212
+ ### 2. Learning from History
213
+ ```bash
214
+ # Learn from past reviews
215
+ npx ruv-swarm github review-learn \
216
+ --analyze-past-reviews \
217
+ --identify-patterns \
218
+ --improve-suggestions \
219
+ --reduce-false-positives
220
+ ```
221
+
222
+ ### 3. Cross-PR Analysis
223
+ ```bash
224
+ # Analyze related PRs together
225
+ npx ruv-swarm github review-batch \
226
+ --prs "123,124,125" \
227
+ --check-consistency \
228
+ --verify-integration \
229
+ --combined-impact
230
+ ```
231
+
232
+ ## Review Automation
233
+
234
+ ### Auto-Review on Push
235
+ ```yaml
236
+ # .github/workflows/auto-review.yml
237
+ name: Automated Code Review
238
+ on:
239
+ pull_request:
240
+ types: [opened, synchronize]
241
+
242
+ jobs:
243
+ swarm-review:
244
+ runs-on: ubuntu-latest
245
+ steps:
246
+ - uses: actions/checkout@v3
247
+ with:
248
+ fetch-depth: 0
249
+
250
+ - name: Setup GitHub CLI
251
+ run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
252
+
253
+ - name: Run Review Swarm
254
+ run: |
255
+ # Get PR context with gh CLI
256
+ PR_NUM=${{ github.event.pull_request.number }}
257
+ PR_DATA=$(gh pr view $PR_NUM --json files,title,body,labels)
258
+
259
+ # Run swarm review
260
+ REVIEW_OUTPUT=$(npx ruv-swarm github review-all \
261
+ --pr $PR_NUM \
262
+ --pr-data "$PR_DATA" \
263
+ --agents "security,performance,style,architecture")
264
+
265
+ # Post review results
266
+ echo "$REVIEW_OUTPUT" | gh pr review $PR_NUM --comment -F -
267
+
268
+ # Update PR status
269
+ if echo "$REVIEW_OUTPUT" | grep -q "approved"; then
270
+ gh pr review $PR_NUM --approve
271
+ elif echo "$REVIEW_OUTPUT" | grep -q "changes-requested"; then
272
+ gh pr review $PR_NUM --request-changes -b "See review comments above"
273
+ fi
274
+ ```
275
+
276
+ ### Review Triggers
277
+ ```javascript
278
+ // Custom review triggers
279
+ {
280
+ "triggers": {
281
+ "high-risk-files": {
282
+ "paths": ["**/auth/**", "**/payment/**"],
283
+ "agents": ["security", "architecture"],
284
+ "depth": "comprehensive"
285
+ },
286
+ "performance-critical": {
287
+ "paths": ["**/api/**", "**/database/**"],
288
+ "agents": ["performance", "database"],
289
+ "benchmarks": true
290
+ },
291
+ "ui-changes": {
292
+ "paths": ["**/components/**", "**/styles/**"],
293
+ "agents": ["accessibility", "style", "i18n"],
294
+ "visual-tests": true
295
+ }
296
+ }
297
+ }
298
+ ```
299
+
300
+ ## Review Comments
301
+
302
+ ### Intelligent Comment Generation
303
+ ```bash
304
+ # Generate contextual review comments with gh CLI
305
+ # Get PR diff with context
306
+ PR_DIFF=$(gh pr diff 123 --color never)
307
+ PR_FILES=$(gh pr view 123 --json files)
308
+
309
+ # Generate review comments
310
+ COMMENTS=$(npx ruv-swarm github review-comment \
311
+ --pr 123 \
312
+ --diff "$PR_DIFF" \
313
+ --files "$PR_FILES" \
314
+ --style "constructive" \
315
+ --include-examples \
316
+ --suggest-fixes)
317
+
318
+ # Post comments using gh CLI
319
+ echo "$COMMENTS" | jq -c '.[]' | while read -r comment; do
320
+ FILE=$(echo "$comment" | jq -r '.path')
321
+ LINE=$(echo "$comment" | jq -r '.line')
322
+ BODY=$(echo "$comment" | jq -r '.body')
323
+
324
+ # Create review with inline comments
325
+ gh api \
326
+ --method POST \
327
+ /repos/:owner/:repo/pulls/123/comments \
328
+ -f path="$FILE" \
329
+ -f line="$LINE" \
330
+ -f body="$BODY" \
331
+ -f commit_id="$(gh pr view 123 --json headRefOid -q .headRefOid)"
332
+ done
333
+ ```
334
+
335
+ ### Comment Templates
336
+ ```markdown
337
+ <!-- Security Issue Template -->
338
+ 🔒 **Security Issue: [Type]**
339
+
340
+ **Severity**: 🔴 Critical / 🟡 High / 🟢 Low
341
+
342
+ **Description**:
343
+ [Clear explanation of the security issue]
344
+
345
+ **Impact**:
346
+ [Potential consequences if not addressed]
347
+
348
+ **Suggested Fix**:
349
+ ```language
350
+ [Code example of the fix]
351
+ ```
352
+
353
+ **References**:
354
+ - [OWASP Guide](link)
355
+ - [Security Best Practices](link)
356
+ ```
357
+
358
+ ### Batch Comment Management
359
+ ```bash
360
+ # Manage review comments efficiently
361
+ npx ruv-swarm github review-comments \
362
+ --pr 123 \
363
+ --group-by "agent,severity" \
364
+ --summarize \
365
+ --resolve-outdated
366
+ ```
367
+
368
+ ## Integration with CI/CD
369
+
370
+ ### Status Checks
371
+ ```yaml
372
+ # Required status checks
373
+ protection_rules:
374
+ required_status_checks:
375
+ contexts:
376
+ - "review-swarm/security"
377
+ - "review-swarm/performance"
378
+ - "review-swarm/architecture"
379
+ ```
380
+
381
+ ### Quality Gates
382
+ ```bash
383
+ # Define quality gates
384
+ npx ruv-swarm github quality-gates \
385
+ --define '{
386
+ "security": {"threshold": "no-critical"},
387
+ "performance": {"regression": "<5%"},
388
+ "coverage": {"minimum": "80%"},
389
+ "architecture": {"complexity": "<10"}
390
+ }'
391
+ ```
392
+
393
+ ### Review Metrics
394
+ ```bash
395
+ # Track review effectiveness
396
+ npx ruv-swarm github review-metrics \
397
+ --period 30d \
398
+ --metrics "issues-found,false-positives,fix-rate" \
399
+ --export-dashboard
400
+ ```
401
+
402
+ ## Best Practices
403
+
404
+ ### 1. Review Configuration
405
+ - Define clear review criteria
406
+ - Set appropriate thresholds
407
+ - Configure agent specializations
408
+ - Establish override procedures
409
+
410
+ ### 2. Comment Quality
411
+ - Provide actionable feedback
412
+ - Include code examples
413
+ - Reference documentation
414
+ - Maintain respectful tone
415
+
416
+ ### 3. Performance
417
+ - Cache analysis results
418
+ - Incremental reviews for large PRs
419
+ - Parallel agent execution
420
+ - Smart comment batching
421
+
422
+ ## Advanced Features
423
+
424
+ ### 1. AI Learning
425
+ ```bash
426
+ # Train on your codebase
427
+ npx ruv-swarm github review-train \
428
+ --learn-patterns \
429
+ --adapt-to-style \
430
+ --improve-accuracy
431
+ ```
432
+
433
+ ### 2. Custom Review Agents
434
+ ```javascript
435
+ // Create custom review agent
436
+ class CustomReviewAgent {
437
+ async review(pr) {
438
+ const issues = [];
439
+
440
+ // Custom logic here
441
+ if (await this.checkCustomRule(pr)) {
442
+ issues.push({
443
+ severity: 'warning',
444
+ message: 'Custom rule violation',
445
+ suggestion: 'Fix suggestion'
446
+ });
447
+ }
448
+
449
+ return issues;
450
+ }
451
+ }
452
+ ```
453
+
454
+ ### 3. Review Orchestration
455
+ ```bash
456
+ # Orchestrate complex reviews
457
+ npx ruv-swarm github review-orchestrate \
458
+ --strategy "risk-based" \
459
+ --allocate-time-budget \
460
+ --prioritize-critical
461
+ ```
462
+
463
+ ## Examples
464
+
465
+ ### Security-Critical PR
466
+ ```bash
467
+ # Auth system changes
468
+ npx ruv-swarm github review-init \
469
+ --pr 456 \
470
+ --agents "security,authentication,audit" \
471
+ --depth "maximum" \
472
+ --require-security-approval
473
+ ```
474
+
475
+ ### Performance-Sensitive PR
476
+ ```bash
477
+ # Database optimization
478
+ npx ruv-swarm github review-init \
479
+ --pr 789 \
480
+ --agents "performance,database,caching" \
481
+ --benchmark \
482
+ --profile
483
+ ```
484
+
485
+ ### UI Component PR
486
+ ```bash
487
+ # New component library
488
+ npx ruv-swarm github review-init \
489
+ --pr 321 \
490
+ --agents "accessibility,style,i18n,docs" \
491
+ --visual-regression \
492
+ --component-tests
493
+ ```
494
+
495
+ ## Monitoring & Analytics
496
+
497
+ ### Review Dashboard
498
+ ```bash
499
+ # Launch review dashboard
500
+ npx ruv-swarm github review-dashboard \
501
+ --real-time \
502
+ --show "agent-activity,issue-trends,fix-rates"
503
+ ```
504
+
505
+ ### Review Reports
506
+ ```bash
507
+ # Generate review reports
508
+ npx ruv-swarm github review-report \
509
+ --format "markdown" \
510
+ --include "summary,details,trends" \
511
+ --email-stakeholders
512
+ ```
513
+
514
514
  See also: [swarm-pr.md](./swarm-pr.md), [workflow-automation.md](./workflow-automation.md)