moflo 4.0.5 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (422) hide show
  1. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  2. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  3. package/.claude/agents/analysis/code-analyzer.md +209 -209
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/base-template-generator.md +42 -42
  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 +265 -265
  15. package/.claude/agents/core/planner.md +167 -167
  16. package/.claude/agents/core/researcher.md +189 -189
  17. package/.claude/agents/core/reviewer.md +325 -325
  18. package/.claude/agents/core/tester.md +318 -318
  19. package/.claude/agents/custom/test-long-runner.md +44 -44
  20. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  21. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  22. package/.claude/agents/development/dev-backend-api.md +344 -344
  23. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  24. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  25. package/.claude/agents/dual-mode/codex-coordinator.md +224 -224
  26. package/.claude/agents/dual-mode/codex-worker.md +211 -211
  27. package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
  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 +537 -537
  38. package/.claude/agents/github/github-modes.md +172 -172
  39. package/.claude/agents/github/issue-tracker.md +318 -318
  40. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  41. package/.claude/agents/github/pr-manager.md +190 -190
  42. package/.claude/agents/github/project-board-sync.md +508 -508
  43. package/.claude/agents/github/release-manager.md +366 -366
  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 +634 -634
  50. package/.claude/agents/goal/agent.md +815 -815
  51. package/.claude/agents/goal/code-goal-planner.md +445 -445
  52. package/.claude/agents/goal/goal-planner.md +167 -167
  53. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  54. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  55. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  56. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  57. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  58. package/.claude/agents/neural/safla-neural.md +73 -73
  59. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  60. package/.claude/agents/optimization/load-balancer.md +430 -430
  61. package/.claude/agents/optimization/performance-monitor.md +671 -671
  62. package/.claude/agents/optimization/resource-allocator.md +673 -673
  63. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  64. package/.claude/agents/payments/agentic-payments.md +126 -126
  65. package/.claude/agents/reasoning/agent.md +815 -815
  66. package/.claude/agents/reasoning/goal-planner.md +72 -72
  67. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  68. package/.claude/agents/sparc/architecture.md +471 -471
  69. package/.claude/agents/sparc/pseudocode.md +317 -317
  70. package/.claude/agents/sparc/refinement.md +524 -524
  71. package/.claude/agents/sparc/specification.md +275 -275
  72. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  73. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  74. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  75. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  76. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  77. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  78. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  79. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  80. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  81. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  82. package/.claude/agents/templates/coordinator-swarm-init.md +104 -104
  83. package/.claude/agents/templates/github-pr-manager.md +176 -176
  84. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  85. package/.claude/agents/templates/memory-coordinator.md +186 -186
  86. package/.claude/agents/templates/migration-plan.md +745 -745
  87. package/.claude/agents/templates/orchestrator-task.md +138 -138
  88. package/.claude/agents/templates/performance-analyzer.md +198 -198
  89. package/.claude/agents/templates/sparc-coordinator.md +182 -182
  90. package/.claude/agents/testing/production-validator.md +394 -394
  91. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  92. package/.claude/agents/testing/unit/tdd-london-swarm.md +243 -243
  93. package/.claude/agents/testing/validation/production-validator.md +394 -394
  94. package/.claude/agents/v3/v3-integration-architect.md +345 -345
  95. package/.claude/agents/v3/v3-memory-specialist.md +317 -317
  96. package/.claude/agents/v3/v3-performance-engineer.md +396 -396
  97. package/.claude/agents/v3/v3-queen-coordinator.md +97 -97
  98. package/.claude/agents/v3/v3-security-architect.md +173 -173
  99. package/.claude/commands/agents/README.md +10 -10
  100. package/.claude/commands/agents/agent-capabilities.md +21 -21
  101. package/.claude/commands/agents/agent-coordination.md +28 -28
  102. package/.claude/commands/agents/agent-spawning.md +28 -28
  103. package/.claude/commands/agents/agent-types.md +26 -26
  104. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  105. package/.claude/commands/analysis/README.md +9 -9
  106. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  107. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  108. package/.claude/commands/analysis/performance-report.md +25 -25
  109. package/.claude/commands/analysis/token-efficiency.md +44 -44
  110. package/.claude/commands/analysis/token-usage.md +25 -25
  111. package/.claude/commands/automation/README.md +9 -9
  112. package/.claude/commands/automation/auto-agent.md +122 -122
  113. package/.claude/commands/automation/self-healing.md +105 -105
  114. package/.claude/commands/automation/session-memory.md +89 -89
  115. package/.claude/commands/automation/smart-agents.md +72 -72
  116. package/.claude/commands/automation/smart-spawn.md +25 -25
  117. package/.claude/commands/automation/workflow-select.md +25 -25
  118. package/.claude/commands/claude-flow-help.md +103 -103
  119. package/.claude/commands/claude-flow-memory.md +107 -107
  120. package/.claude/commands/claude-flow-swarm.md +205 -205
  121. package/.claude/commands/coordination/README.md +9 -9
  122. package/.claude/commands/coordination/agent-spawn.md +25 -25
  123. package/.claude/commands/coordination/init.md +44 -44
  124. package/.claude/commands/coordination/orchestrate.md +43 -43
  125. package/.claude/commands/coordination/spawn.md +45 -45
  126. package/.claude/commands/coordination/swarm-init.md +85 -85
  127. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  128. package/.claude/commands/flow-nexus/app-store.md +123 -123
  129. package/.claude/commands/flow-nexus/challenges.md +119 -119
  130. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  131. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  132. package/.claude/commands/flow-nexus/payments.md +115 -115
  133. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  134. package/.claude/commands/flow-nexus/swarm.md +86 -86
  135. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  136. package/.claude/commands/flow-nexus/workflow.md +114 -114
  137. package/.claude/commands/github/README.md +11 -11
  138. package/.claude/commands/github/code-review-swarm.md +513 -513
  139. package/.claude/commands/github/code-review.md +25 -25
  140. package/.claude/commands/github/github-modes.md +146 -146
  141. package/.claude/commands/github/github-swarm.md +121 -121
  142. package/.claude/commands/github/issue-tracker.md +291 -291
  143. package/.claude/commands/github/issue-triage.md +25 -25
  144. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  145. package/.claude/commands/github/pr-enhance.md +26 -26
  146. package/.claude/commands/github/pr-manager.md +169 -169
  147. package/.claude/commands/github/project-board-sync.md +470 -470
  148. package/.claude/commands/github/release-manager.md +337 -337
  149. package/.claude/commands/github/release-swarm.md +543 -543
  150. package/.claude/commands/github/repo-analyze.md +25 -25
  151. package/.claude/commands/github/repo-architect.md +366 -366
  152. package/.claude/commands/github/swarm-issue.md +481 -481
  153. package/.claude/commands/github/swarm-pr.md +284 -284
  154. package/.claude/commands/github/sync-coordinator.md +300 -300
  155. package/.claude/commands/github/workflow-automation.md +441 -441
  156. package/.claude/commands/hive-mind/README.md +17 -17
  157. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  159. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  160. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  161. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  162. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  163. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  164. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  165. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  166. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  167. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  168. package/.claude/commands/hooks/README.md +11 -11
  169. package/.claude/commands/hooks/overview.md +57 -57
  170. package/.claude/commands/hooks/post-edit.md +117 -117
  171. package/.claude/commands/hooks/post-task.md +112 -112
  172. package/.claude/commands/hooks/pre-edit.md +113 -113
  173. package/.claude/commands/hooks/pre-task.md +111 -111
  174. package/.claude/commands/hooks/session-end.md +118 -118
  175. package/.claude/commands/hooks/setup.md +102 -102
  176. package/.claude/commands/memory/README.md +9 -9
  177. package/.claude/commands/memory/memory-persist.md +25 -25
  178. package/.claude/commands/memory/memory-search.md +25 -25
  179. package/.claude/commands/memory/memory-usage.md +25 -25
  180. package/.claude/commands/memory/neural.md +47 -47
  181. package/.claude/commands/monitoring/README.md +9 -9
  182. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  183. package/.claude/commands/monitoring/agents.md +44 -44
  184. package/.claude/commands/monitoring/real-time-view.md +25 -25
  185. package/.claude/commands/monitoring/status.md +46 -46
  186. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  187. package/.claude/commands/optimization/README.md +9 -9
  188. package/.claude/commands/optimization/auto-topology.md +61 -61
  189. package/.claude/commands/optimization/cache-manage.md +25 -25
  190. package/.claude/commands/optimization/parallel-execute.md +25 -25
  191. package/.claude/commands/optimization/parallel-execution.md +49 -49
  192. package/.claude/commands/optimization/topology-optimize.md +25 -25
  193. package/.claude/commands/pair/README.md +260 -260
  194. package/.claude/commands/pair/commands.md +545 -545
  195. package/.claude/commands/pair/config.md +509 -509
  196. package/.claude/commands/pair/examples.md +511 -511
  197. package/.claude/commands/pair/modes.md +347 -347
  198. package/.claude/commands/pair/session.md +406 -406
  199. package/.claude/commands/pair/start.md +208 -208
  200. package/.claude/commands/sparc/analyzer.md +51 -51
  201. package/.claude/commands/sparc/architect.md +53 -53
  202. package/.claude/commands/sparc/ask.md +97 -97
  203. package/.claude/commands/sparc/batch-executor.md +54 -54
  204. package/.claude/commands/sparc/code.md +89 -89
  205. package/.claude/commands/sparc/coder.md +54 -54
  206. package/.claude/commands/sparc/debug.md +83 -83
  207. package/.claude/commands/sparc/debugger.md +54 -54
  208. package/.claude/commands/sparc/designer.md +53 -53
  209. package/.claude/commands/sparc/devops.md +109 -109
  210. package/.claude/commands/sparc/docs-writer.md +80 -80
  211. package/.claude/commands/sparc/documenter.md +54 -54
  212. package/.claude/commands/sparc/innovator.md +54 -54
  213. package/.claude/commands/sparc/integration.md +83 -83
  214. package/.claude/commands/sparc/mcp.md +117 -117
  215. package/.claude/commands/sparc/memory-manager.md +54 -54
  216. package/.claude/commands/sparc/optimizer.md +54 -54
  217. package/.claude/commands/sparc/orchestrator.md +131 -131
  218. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  219. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  220. package/.claude/commands/sparc/researcher.md +54 -54
  221. package/.claude/commands/sparc/reviewer.md +54 -54
  222. package/.claude/commands/sparc/security-review.md +80 -80
  223. package/.claude/commands/sparc/sparc-modes.md +174 -174
  224. package/.claude/commands/sparc/sparc.md +111 -111
  225. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  226. package/.claude/commands/sparc/supabase-admin.md +348 -348
  227. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  228. package/.claude/commands/sparc/tdd.md +54 -54
  229. package/.claude/commands/sparc/tester.md +54 -54
  230. package/.claude/commands/sparc/tutorial.md +79 -79
  231. package/.claude/commands/sparc/workflow-manager.md +54 -54
  232. package/.claude/commands/sparc.md +166 -166
  233. package/.claude/commands/stream-chain/pipeline.md +120 -120
  234. package/.claude/commands/stream-chain/run.md +69 -69
  235. package/.claude/commands/swarm/README.md +15 -15
  236. package/.claude/commands/swarm/analysis.md +95 -95
  237. package/.claude/commands/swarm/development.md +96 -96
  238. package/.claude/commands/swarm/examples.md +168 -168
  239. package/.claude/commands/swarm/maintenance.md +102 -102
  240. package/.claude/commands/swarm/optimization.md +117 -117
  241. package/.claude/commands/swarm/research.md +136 -136
  242. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  243. package/.claude/commands/swarm/swarm-background.md +8 -8
  244. package/.claude/commands/swarm/swarm-init.md +19 -19
  245. package/.claude/commands/swarm/swarm-modes.md +8 -8
  246. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  247. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  248. package/.claude/commands/swarm/swarm-status.md +8 -8
  249. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  250. package/.claude/commands/swarm/swarm.md +27 -27
  251. package/.claude/commands/swarm/testing.md +131 -131
  252. package/.claude/commands/training/README.md +9 -9
  253. package/.claude/commands/training/model-update.md +25 -25
  254. package/.claude/commands/training/neural-patterns.md +73 -73
  255. package/.claude/commands/training/neural-train.md +25 -25
  256. package/.claude/commands/training/pattern-learn.md +25 -25
  257. package/.claude/commands/training/specialization.md +62 -62
  258. package/.claude/commands/truth/start.md +142 -142
  259. package/.claude/commands/verify/check.md +49 -49
  260. package/.claude/commands/verify/start.md +127 -127
  261. package/.claude/commands/workflows/README.md +9 -9
  262. package/.claude/commands/workflows/development.md +77 -77
  263. package/.claude/commands/workflows/research.md +62 -62
  264. package/.claude/commands/workflows/workflow-create.md +25 -25
  265. package/.claude/commands/workflows/workflow-execute.md +25 -25
  266. package/.claude/commands/workflows/workflow-export.md +25 -25
  267. package/.claude/config/v3-dependency-optimization.json +265 -265
  268. package/.claude/config/v3-performance-targets.json +250 -250
  269. package/.claude/helpers/README.md +96 -96
  270. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  271. package/.claude/helpers/auto-memory-hook.mjs +363 -363
  272. package/.claude/helpers/context-persistence-hook.mjs +1979 -1979
  273. package/.claude/helpers/github-safe.js +106 -106
  274. package/.claude/helpers/learning-service.mjs +1144 -1144
  275. package/.claude/helpers/metrics-db.mjs +488 -488
  276. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  277. package/.claude/mcp.json +12 -12
  278. package/.claude/settings.json +2 -2
  279. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  280. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  281. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  282. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  283. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  284. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  285. package/.claude/skills/dual-mode/README.md +71 -71
  286. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  287. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  288. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  289. package/.claude/skills/flow-nexus-neural/SKILL.md +738 -738
  290. package/.claude/skills/flow-nexus-platform/SKILL.md +1157 -1157
  291. package/.claude/skills/flow-nexus-swarm/SKILL.md +610 -610
  292. package/.claude/skills/github-code-review/SKILL.md +1 -1
  293. package/.claude/skills/github-multi-repo/SKILL.md +2 -2
  294. package/.claude/skills/github-project-management/SKILL.md +1 -1
  295. package/.claude/skills/github-release-management/SKILL.md +2 -2
  296. package/.claude/skills/github-workflow-automation/SKILL.md +1 -1
  297. package/.claude/skills/hive-mind-advanced/SKILL.md +4 -4
  298. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  299. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  300. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  301. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  302. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  303. package/.claude/skills/skill-builder/SKILL.md +910 -910
  304. package/.claude/skills/sparc-methodology/SKILL.md +2 -2
  305. package/.claude/skills/stream-chain/SKILL.md +563 -563
  306. package/.claude/skills/swarm-advanced/SKILL.md +4 -4
  307. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  308. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  309. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  310. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  311. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  312. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  313. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  314. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  315. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  316. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  317. package/.claude/skills/verification-quality/SKILL.md +649 -649
  318. package/.claude/skills/worker-benchmarks/skill.md +135 -135
  319. package/.claude/skills/worker-integration/skill.md +154 -154
  320. package/.claude/statusline.mjs +109 -109
  321. package/.claude-plugin/README.md +6 -6
  322. package/.claude-plugin/docs/INSTALLATION.md +4 -4
  323. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +5 -5
  324. package/.claude-plugin/docs/QUICKSTART.md +1 -1
  325. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  326. package/.claude-plugin/hooks/hooks.json +74 -74
  327. package/.claude-plugin/marketplace.json +5 -5
  328. package/.claude-plugin/plugin.json +4 -4
  329. package/README.md +148 -148
  330. package/bin/cli.js +12 -12
  331. package/bin/npx-repair.js +7 -7
  332. package/bin/npx-safe-launch.js +9 -9
  333. package/package.json +115 -114
  334. package/v3/@claude-flow/cli/README.md +5 -5
  335. package/v3/@claude-flow/cli/bin/cli.js +156 -156
  336. package/v3/@claude-flow/cli/bin/mcp-server.js +189 -189
  337. package/v3/@claude-flow/cli/dist/src/commands/analyze.d.ts +1 -1
  338. package/v3/@claude-flow/cli/dist/src/commands/analyze.js +1 -1
  339. package/v3/@claude-flow/cli/dist/src/commands/claims.d.ts +1 -1
  340. package/v3/@claude-flow/cli/dist/src/commands/claims.js +2 -2
  341. package/v3/@claude-flow/cli/dist/src/commands/completions.d.ts +1 -1
  342. package/v3/@claude-flow/cli/dist/src/commands/completions.js +1 -1
  343. package/v3/@claude-flow/cli/dist/src/commands/config.js +36 -2
  344. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +54 -7
  345. package/v3/@claude-flow/cli/dist/src/commands/deployment.d.ts +1 -1
  346. package/v3/@claude-flow/cli/dist/src/commands/deployment.js +2 -2
  347. package/v3/@claude-flow/cli/dist/src/commands/doctor.d.ts +1 -1
  348. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +1 -1
  349. package/v3/@claude-flow/cli/dist/src/commands/embeddings.d.ts +1 -1
  350. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +2 -2
  351. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  352. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +56 -20
  353. package/v3/@claude-flow/cli/dist/src/commands/init.js +6 -1
  354. package/v3/@claude-flow/cli/dist/src/commands/memory.js +30 -30
  355. package/v3/@claude-flow/cli/dist/src/commands/neural.d.ts +1 -1
  356. package/v3/@claude-flow/cli/dist/src/commands/neural.js +2 -2
  357. package/v3/@claude-flow/cli/dist/src/commands/orc.js +1 -0
  358. package/v3/@claude-flow/cli/dist/src/commands/performance.d.ts +1 -1
  359. package/v3/@claude-flow/cli/dist/src/commands/performance.js +2 -2
  360. package/v3/@claude-flow/cli/dist/src/commands/plugins.d.ts +1 -1
  361. package/v3/@claude-flow/cli/dist/src/commands/plugins.js +2 -2
  362. package/v3/@claude-flow/cli/dist/src/commands/providers.d.ts +1 -1
  363. package/v3/@claude-flow/cli/dist/src/commands/providers.js +2 -2
  364. package/v3/@claude-flow/cli/dist/src/commands/route.d.ts +1 -1
  365. package/v3/@claude-flow/cli/dist/src/commands/route.js +1 -1
  366. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  367. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +29 -29
  368. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.d.ts +1 -1
  369. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +1 -1
  370. package/v3/@claude-flow/cli/dist/src/commands/ruvector/index.d.ts +1 -1
  371. package/v3/@claude-flow/cli/dist/src/commands/ruvector/index.js +1 -1
  372. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +113 -113
  373. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +97 -97
  374. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  375. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.d.ts +1 -1
  376. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +2 -2
  377. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +36 -36
  378. package/v3/@claude-flow/cli/dist/src/commands/security.d.ts +1 -1
  379. package/v3/@claude-flow/cli/dist/src/commands/security.js +2 -2
  380. package/v3/@claude-flow/cli/dist/src/config/moflo-config.d.ts +13 -1
  381. package/v3/@claude-flow/cli/dist/src/config/moflo-config.js +93 -41
  382. package/v3/@claude-flow/cli/dist/src/index.d.ts +1 -1
  383. package/v3/@claude-flow/cli/dist/src/index.js +2 -2
  384. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +2 -2
  385. package/v3/@claude-flow/cli/dist/src/init/executor.js +3 -3
  386. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +640 -640
  387. package/v3/@claude-flow/cli/dist/src/init/moflo-init.d.ts +10 -0
  388. package/v3/@claude-flow/cli/dist/src/init/moflo-init.js +101 -20
  389. package/v3/@claude-flow/cli/dist/src/init/settings-generator.js +2 -2
  390. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +783 -783
  391. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +30 -13
  392. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.d.ts +1 -1
  393. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.js +1 -1
  394. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +61 -61
  395. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +2212 -2263
  396. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  397. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.d.ts +1 -1
  398. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.js +1 -1
  399. package/v3/@claude-flow/cli/dist/src/ruvector/vector-db.d.ts +1 -1
  400. package/v3/@claude-flow/cli/dist/src/ruvector/vector-db.js +1 -1
  401. package/v3/@claude-flow/cli/dist/src/services/agent-router.d.ts +14 -0
  402. package/v3/@claude-flow/cli/dist/src/services/agent-router.js +86 -7
  403. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  404. package/v3/@claude-flow/cli/dist/src/services/index.d.ts +1 -3
  405. package/v3/@claude-flow/cli/dist/src/services/index.js +1 -2
  406. package/v3/@claude-flow/cli/dist/src/services/learning-service.js +54 -54
  407. package/v3/@claude-flow/cli/dist/src/services/ruvector-training.d.ts +1 -1
  408. package/v3/@claude-flow/cli/dist/src/services/ruvector-training.js +1 -1
  409. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.d.ts +24 -3
  410. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +123 -12
  411. package/v3/@claude-flow/cli/dist/src/services/workflow-gate.d.ts +1 -0
  412. package/v3/@claude-flow/cli/dist/src/services/workflow-gate.js +20 -5
  413. package/v3/@claude-flow/cli/dist/src/suggest.d.ts +1 -1
  414. package/v3/@claude-flow/cli/dist/src/suggest.js +1 -1
  415. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  416. package/v3/@claude-flow/cli/package.json +6 -6
  417. package/v3/@claude-flow/guidance/README.md +6 -6
  418. package/v3/@claude-flow/guidance/package.json +1 -1
  419. package/v3/@claude-flow/memory/README.md +1 -1
  420. package/v3/@claude-flow/shared/README.md +1 -1
  421. package/v3/@claude-flow/shared/package.json +42 -42
  422. package/v3/README.md +3 -3
@@ -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)