claude-flow 3.28.0 → 3.29.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 (679) hide show
  1. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  2. package/.claude/agents/analysis/analyze-code-quality.md +57 -57
  3. package/.claude/agents/analysis/code-analyzer.md +188 -188
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
  6. package/.claude/agents/base-template-generator.md +41 -41
  7. package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
  8. package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
  9. package/.claude/agents/consensus/gossip-coordinator.md +42 -42
  10. package/.claude/agents/consensus/performance-benchmarker.md +830 -830
  11. package/.claude/agents/consensus/quorum-manager.md +802 -802
  12. package/.claude/agents/consensus/raft-manager.md +42 -42
  13. package/.claude/agents/consensus/security-manager.md +601 -601
  14. package/.claude/agents/core/coder.md +254 -254
  15. package/.claude/agents/core/planner.md +151 -151
  16. package/.claude/agents/core/researcher.md +173 -173
  17. package/.claude/agents/core/reviewer.md +308 -308
  18. package/.claude/agents/core/tester.md +299 -299
  19. package/.claude/agents/custom/test-long-runner.md +43 -43
  20. package/.claude/agents/data/ml/data-ml-model.md +75 -75
  21. package/.claude/agents/database-specialist.md +9 -9
  22. package/.claude/agents/development/backend/dev-backend-api.md +28 -28
  23. package/.claude/agents/development/dev-backend-api.md +177 -177
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
  25. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
  26. package/.claude/agents/dual-mode/codex-coordinator.md +206 -206
  27. package/.claude/agents/dual-mode/codex-worker.md +190 -190
  28. package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
  29. package/.claude/agents/flow-nexus/app-store.md +87 -87
  30. package/.claude/agents/flow-nexus/authentication.md +68 -68
  31. package/.claude/agents/flow-nexus/challenges.md +80 -80
  32. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  33. package/.claude/agents/flow-nexus/payments.md +82 -82
  34. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  35. package/.claude/agents/flow-nexus/swarm.md +75 -75
  36. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  37. package/.claude/agents/flow-nexus/workflow.md +83 -83
  38. package/.claude/agents/github/code-review-swarm.md +520 -520
  39. package/.claude/agents/github/github-modes.md +153 -153
  40. package/.claude/agents/github/issue-tracker.md +298 -298
  41. package/.claude/agents/github/multi-repo-swarm.md +524 -524
  42. package/.claude/agents/github/pr-manager.md +162 -162
  43. package/.claude/agents/github/project-board-sync.md +477 -477
  44. package/.claude/agents/github/release-manager.md +337 -337
  45. package/.claude/agents/github/release-swarm.md +550 -550
  46. package/.claude/agents/github/repo-architect.md +364 -364
  47. package/.claude/agents/github/swarm-issue.md +550 -550
  48. package/.claude/agents/github/swarm-pr.md +401 -401
  49. package/.claude/agents/github/sync-coordinator.md +424 -424
  50. package/.claude/agents/github/workflow-automation.md +604 -604
  51. package/.claude/agents/goal/agent.md +816 -816
  52. package/.claude/agents/goal/code-goal-planner.md +444 -444
  53. package/.claude/agents/goal/goal-planner.md +167 -167
  54. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
  55. package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
  56. package/.claude/agents/hive-mind/scout-explorer.md +240 -240
  57. package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
  58. package/.claude/agents/hive-mind/worker-specialist.md +215 -215
  59. package/.claude/agents/neural/safla-neural.md +73 -73
  60. package/.claude/agents/optimization/benchmark-suite.md +662 -662
  61. package/.claude/agents/optimization/load-balancer.md +428 -428
  62. package/.claude/agents/optimization/performance-monitor.md +669 -669
  63. package/.claude/agents/optimization/resource-allocator.md +671 -671
  64. package/.claude/agents/optimization/topology-optimizer.md +805 -805
  65. package/.claude/agents/payments/agentic-payments.md +126 -126
  66. package/.claude/agents/project-coordinator.md +8 -8
  67. package/.claude/agents/python-specialist.md +9 -9
  68. package/.claude/agents/reasoning/agent.md +816 -816
  69. package/.claude/agents/reasoning/goal-planner.md +72 -72
  70. package/.claude/agents/security-auditor.md +9 -9
  71. package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
  72. package/.claude/agents/sparc/architecture.md +452 -452
  73. package/.claude/agents/sparc/pseudocode.md +298 -298
  74. package/.claude/agents/sparc/refinement.md +503 -503
  75. package/.claude/agents/sparc/specification.md +257 -257
  76. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
  77. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  78. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  79. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  80. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  81. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  82. package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
  83. package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
  84. package/.claude/agents/swarm/mesh-coordinator.md +362 -362
  85. package/.claude/agents/templates/automation-smart-agent.md +184 -184
  86. package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
  87. package/.claude/agents/templates/github-pr-manager.md +154 -154
  88. package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
  89. package/.claude/agents/templates/memory-coordinator.md +162 -162
  90. package/.claude/agents/templates/migration-plan.md +723 -723
  91. package/.claude/agents/templates/orchestrator-task.md +119 -119
  92. package/.claude/agents/templates/performance-analyzer.md +178 -178
  93. package/.claude/agents/templates/sparc-coordinator.md +162 -162
  94. package/.claude/agents/testing/production-validator.md +372 -372
  95. package/.claude/agents/testing/tdd-london-swarm.md +221 -221
  96. package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
  97. package/.claude/agents/testing/validation/production-validator.md +372 -372
  98. package/.claude/agents/typescript-specialist.md +9 -9
  99. package/.claude/agents/v3/database-specialist.md +9 -9
  100. package/.claude/agents/v3/project-coordinator.md +8 -8
  101. package/.claude/agents/v3/python-specialist.md +9 -9
  102. package/.claude/agents/v3/test-architect.md +9 -9
  103. package/.claude/agents/v3/typescript-specialist.md +9 -9
  104. package/.claude/agents/v3/v3-integration-architect.md +311 -311
  105. package/.claude/agents/v3/v3-memory-specialist.md +280 -280
  106. package/.claude/agents/v3/v3-performance-engineer.md +362 -362
  107. package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
  108. package/.claude/agents/v3/v3-security-architect.md +139 -139
  109. package/.claude/checkpoints/1767754460.json +8 -8
  110. package/.claude/commands/agents/README.md +10 -10
  111. package/.claude/commands/agents/agent-capabilities.md +21 -21
  112. package/.claude/commands/agents/agent-coordination.md +28 -28
  113. package/.claude/commands/agents/agent-spawning.md +28 -28
  114. package/.claude/commands/agents/agent-types.md +26 -26
  115. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  116. package/.claude/commands/analysis/README.md +9 -9
  117. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  118. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  119. package/.claude/commands/analysis/performance-report.md +25 -25
  120. package/.claude/commands/analysis/token-efficiency.md +44 -44
  121. package/.claude/commands/analysis/token-usage.md +25 -25
  122. package/.claude/commands/automation/README.md +9 -9
  123. package/.claude/commands/automation/auto-agent.md +122 -122
  124. package/.claude/commands/automation/self-healing.md +105 -105
  125. package/.claude/commands/automation/session-memory.md +89 -89
  126. package/.claude/commands/automation/smart-agents.md +72 -72
  127. package/.claude/commands/automation/smart-spawn.md +25 -25
  128. package/.claude/commands/automation/workflow-select.md +25 -25
  129. package/.claude/commands/claude-flow-help.md +103 -103
  130. package/.claude/commands/claude-flow-memory.md +107 -107
  131. package/.claude/commands/claude-flow-swarm.md +205 -205
  132. package/.claude/commands/coordination/README.md +9 -9
  133. package/.claude/commands/coordination/agent-spawn.md +25 -25
  134. package/.claude/commands/coordination/init.md +44 -44
  135. package/.claude/commands/coordination/orchestrate.md +43 -43
  136. package/.claude/commands/coordination/spawn.md +45 -45
  137. package/.claude/commands/coordination/swarm-init.md +85 -85
  138. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  139. package/.claude/commands/flow-nexus/app-store.md +123 -123
  140. package/.claude/commands/flow-nexus/challenges.md +119 -119
  141. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  142. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  143. package/.claude/commands/flow-nexus/payments.md +115 -115
  144. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  145. package/.claude/commands/flow-nexus/swarm.md +86 -86
  146. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  147. package/.claude/commands/flow-nexus/workflow.md +114 -114
  148. package/.claude/commands/github/README.md +11 -11
  149. package/.claude/commands/github/code-review-swarm.md +513 -513
  150. package/.claude/commands/github/code-review.md +25 -25
  151. package/.claude/commands/github/github-modes.md +146 -146
  152. package/.claude/commands/github/github-swarm.md +121 -121
  153. package/.claude/commands/github/issue-tracker.md +291 -291
  154. package/.claude/commands/github/issue-triage.md +25 -25
  155. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  156. package/.claude/commands/github/pr-enhance.md +26 -26
  157. package/.claude/commands/github/pr-manager.md +169 -169
  158. package/.claude/commands/github/project-board-sync.md +470 -470
  159. package/.claude/commands/github/release-manager.md +337 -337
  160. package/.claude/commands/github/release-swarm.md +543 -543
  161. package/.claude/commands/github/repo-analyze.md +25 -25
  162. package/.claude/commands/github/repo-architect.md +366 -366
  163. package/.claude/commands/github/swarm-issue.md +481 -481
  164. package/.claude/commands/github/swarm-pr.md +284 -284
  165. package/.claude/commands/github/sync-coordinator.md +300 -300
  166. package/.claude/commands/github/workflow-automation.md +441 -441
  167. package/.claude/commands/hive-mind/README.md +17 -17
  168. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  170. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  173. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  175. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  177. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  178. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  179. package/.claude/commands/hooks/README.md +11 -11
  180. package/.claude/commands/hooks/overview.md +57 -57
  181. package/.claude/commands/hooks/post-edit.md +117 -117
  182. package/.claude/commands/hooks/post-task.md +112 -112
  183. package/.claude/commands/hooks/pre-edit.md +113 -113
  184. package/.claude/commands/hooks/pre-task.md +111 -111
  185. package/.claude/commands/hooks/session-end.md +118 -118
  186. package/.claude/commands/hooks/setup.md +102 -102
  187. package/.claude/commands/memory/README.md +9 -9
  188. package/.claude/commands/memory/memory-persist.md +25 -25
  189. package/.claude/commands/memory/memory-search.md +25 -25
  190. package/.claude/commands/memory/memory-usage.md +25 -25
  191. package/.claude/commands/memory/neural.md +47 -47
  192. package/.claude/commands/monitoring/README.md +9 -9
  193. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  194. package/.claude/commands/monitoring/agents.md +44 -44
  195. package/.claude/commands/monitoring/real-time-view.md +25 -25
  196. package/.claude/commands/monitoring/status.md +46 -46
  197. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  198. package/.claude/commands/optimization/README.md +9 -9
  199. package/.claude/commands/optimization/auto-topology.md +61 -61
  200. package/.claude/commands/optimization/cache-manage.md +25 -25
  201. package/.claude/commands/optimization/parallel-execute.md +25 -25
  202. package/.claude/commands/optimization/parallel-execution.md +49 -49
  203. package/.claude/commands/optimization/topology-optimize.md +25 -25
  204. package/.claude/commands/pair/README.md +260 -260
  205. package/.claude/commands/pair/commands.md +545 -545
  206. package/.claude/commands/pair/config.md +509 -509
  207. package/.claude/commands/pair/examples.md +511 -511
  208. package/.claude/commands/pair/modes.md +347 -347
  209. package/.claude/commands/pair/session.md +406 -406
  210. package/.claude/commands/pair/start.md +208 -208
  211. package/.claude/commands/sparc/analyzer.md +51 -51
  212. package/.claude/commands/sparc/architect.md +53 -53
  213. package/.claude/commands/sparc/ask.md +97 -97
  214. package/.claude/commands/sparc/batch-executor.md +54 -54
  215. package/.claude/commands/sparc/code.md +89 -89
  216. package/.claude/commands/sparc/coder.md +54 -54
  217. package/.claude/commands/sparc/debug.md +83 -83
  218. package/.claude/commands/sparc/debugger.md +54 -54
  219. package/.claude/commands/sparc/designer.md +53 -53
  220. package/.claude/commands/sparc/devops.md +109 -109
  221. package/.claude/commands/sparc/docs-writer.md +80 -80
  222. package/.claude/commands/sparc/documenter.md +54 -54
  223. package/.claude/commands/sparc/innovator.md +54 -54
  224. package/.claude/commands/sparc/integration.md +83 -83
  225. package/.claude/commands/sparc/mcp.md +117 -117
  226. package/.claude/commands/sparc/memory-manager.md +54 -54
  227. package/.claude/commands/sparc/optimizer.md +54 -54
  228. package/.claude/commands/sparc/orchestrator.md +131 -131
  229. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  230. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  231. package/.claude/commands/sparc/researcher.md +54 -54
  232. package/.claude/commands/sparc/reviewer.md +54 -54
  233. package/.claude/commands/sparc/security-review.md +80 -80
  234. package/.claude/commands/sparc/sparc-modes.md +174 -174
  235. package/.claude/commands/sparc/sparc.md +111 -111
  236. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  237. package/.claude/commands/sparc/supabase-admin.md +348 -348
  238. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  239. package/.claude/commands/sparc/tdd.md +54 -54
  240. package/.claude/commands/sparc/tester.md +54 -54
  241. package/.claude/commands/sparc/tutorial.md +79 -79
  242. package/.claude/commands/sparc/workflow-manager.md +54 -54
  243. package/.claude/commands/sparc.md +166 -166
  244. package/.claude/commands/stream-chain/pipeline.md +120 -120
  245. package/.claude/commands/stream-chain/run.md +69 -69
  246. package/.claude/commands/swarm/README.md +15 -15
  247. package/.claude/commands/swarm/analysis.md +95 -95
  248. package/.claude/commands/swarm/development.md +96 -96
  249. package/.claude/commands/swarm/examples.md +168 -168
  250. package/.claude/commands/swarm/maintenance.md +102 -102
  251. package/.claude/commands/swarm/optimization.md +117 -117
  252. package/.claude/commands/swarm/research.md +136 -136
  253. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  254. package/.claude/commands/swarm/swarm-background.md +8 -8
  255. package/.claude/commands/swarm/swarm-init.md +19 -19
  256. package/.claude/commands/swarm/swarm-modes.md +8 -8
  257. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  258. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  259. package/.claude/commands/swarm/swarm-status.md +8 -8
  260. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  261. package/.claude/commands/swarm/swarm.md +27 -27
  262. package/.claude/commands/swarm/testing.md +131 -131
  263. package/.claude/commands/training/README.md +9 -9
  264. package/.claude/commands/training/model-update.md +25 -25
  265. package/.claude/commands/training/neural-patterns.md +73 -73
  266. package/.claude/commands/training/neural-train.md +25 -25
  267. package/.claude/commands/training/pattern-learn.md +25 -25
  268. package/.claude/commands/training/specialization.md +62 -62
  269. package/.claude/commands/truth/start.md +142 -142
  270. package/.claude/commands/verify/check.md +49 -49
  271. package/.claude/commands/verify/start.md +127 -127
  272. package/.claude/commands/workflows/README.md +9 -9
  273. package/.claude/commands/workflows/development.md +77 -77
  274. package/.claude/commands/workflows/research.md +62 -62
  275. package/.claude/commands/workflows/workflow-create.md +25 -25
  276. package/.claude/commands/workflows/workflow-execute.md +25 -25
  277. package/.claude/commands/workflows/workflow-export.md +25 -25
  278. package/.claude/config/v3-dependency-optimization.json +265 -265
  279. package/.claude/config/v3-performance-targets.json +250 -250
  280. package/.claude/helpers/.helpers-version +1 -1
  281. package/.claude/helpers/README.md +96 -96
  282. package/.claude/helpers/adr-compliance.sh +186 -186
  283. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  284. package/.claude/helpers/auto-commit.sh +178 -178
  285. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  286. package/.claude/helpers/checkpoint-manager.sh +251 -251
  287. package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
  288. package/.claude/helpers/daemon-manager.sh +252 -252
  289. package/.claude/helpers/ddd-tracker.sh +144 -144
  290. package/.claude/helpers/github-safe.js +156 -156
  291. package/.claude/helpers/github-setup.sh +45 -45
  292. package/.claude/helpers/guidance-hook.sh +13 -13
  293. package/.claude/helpers/guidance-hooks.sh +102 -102
  294. package/.claude/helpers/health-monitor.sh +108 -108
  295. package/.claude/helpers/helpers.manifest.json +6 -5
  296. package/.claude/helpers/hook-handler.cjs +460 -460
  297. package/.claude/helpers/intelligence.cjs +1058 -1058
  298. package/.claude/helpers/learning-hooks.sh +329 -329
  299. package/.claude/helpers/learning-optimizer.sh +127 -127
  300. package/.claude/helpers/learning-service.mjs +1144 -1144
  301. package/.claude/helpers/memory.cjs +84 -84
  302. package/.claude/helpers/metrics-db.mjs +503 -503
  303. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  304. package/.claude/helpers/pattern-consolidator.sh +86 -86
  305. package/.claude/helpers/perf-worker.sh +160 -160
  306. package/.claude/helpers/quick-start.sh +19 -19
  307. package/.claude/helpers/router.cjs +62 -62
  308. package/.claude/helpers/security-scanner.sh +127 -127
  309. package/.claude/helpers/session.cjs +125 -125
  310. package/.claude/helpers/setup-mcp.sh +18 -18
  311. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  312. package/.claude/helpers/statusline.cjs +925 -925
  313. package/.claude/helpers/swarm-comms.sh +353 -353
  314. package/.claude/helpers/swarm-hooks.sh +761 -761
  315. package/.claude/helpers/swarm-monitor.sh +210 -210
  316. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  317. package/.claude/helpers/update-v3-progress.sh +165 -165
  318. package/.claude/helpers/v3-quick-status.sh +57 -57
  319. package/.claude/helpers/v3.sh +110 -110
  320. package/.claude/helpers/validate-v3-config.sh +215 -215
  321. package/.claude/helpers/worker-manager.sh +170 -170
  322. package/.claude/mcp.json +12 -12
  323. package/.claude/proven-config.json +1 -1
  324. package/.claude/settings.json +285 -285
  325. package/.claude/settings.json.bak +526 -526
  326. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  327. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  328. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  329. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  330. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  331. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  332. package/.claude/skills/browser/SKILL.md +204 -204
  333. package/.claude/skills/dual-mode/README.md +71 -71
  334. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  335. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  336. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  337. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  338. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  339. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  340. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  341. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  342. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  343. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  344. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  345. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  346. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  347. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  348. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  349. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  350. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  351. package/.claude/skills/skill-builder/SKILL.md +910 -910
  352. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  353. package/.claude/skills/stream-chain/SKILL.md +560 -560
  354. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  355. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  356. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  357. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  358. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  359. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  360. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  361. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  362. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  363. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  364. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  365. package/.claude/skills/verification-quality/SKILL.md +691 -691
  366. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  367. package/.claude/skills/worker-integration/SKILL.md +147 -147
  368. package/.claude/statusline-command.sh +176 -176
  369. package/.claude/statusline.mjs +109 -109
  370. package/.claude/statusline.sh +431 -431
  371. package/.claude/workflows/full-system-test.js +65 -65
  372. package/.claude/workflows/intelligence-system-hardening.js +120 -120
  373. package/.claude/workflows/plugin-contract-audit.js +91 -91
  374. package/.claude-plugin/README.md +720 -720
  375. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  376. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  377. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  378. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  379. package/.claude-plugin/hooks/hooks.json +77 -77
  380. package/.claude-plugin/marketplace.json +185 -185
  381. package/.claude-plugin/plugin.json +71 -71
  382. package/.claude-plugin/scripts/install.sh +234 -234
  383. package/.claude-plugin/scripts/ruflo-hook.cjs +166 -166
  384. package/.claude-plugin/scripts/ruflo-hook.sh +37 -37
  385. package/.claude-plugin/scripts/uninstall.sh +36 -36
  386. package/.claude-plugin/scripts/verify.sh +108 -108
  387. package/LICENSE +21 -21
  388. package/README.md +419 -419
  389. package/bin/cli.js +11 -11
  390. package/bin/npx-repair.js +7 -7
  391. package/bin/npx-safe-launch.js +9 -9
  392. package/package.json +185 -185
  393. package/v3/@claude-flow/cli/README.md +419 -419
  394. package/v3/@claude-flow/cli/bin/cli.js +314 -314
  395. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  396. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  397. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  398. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
  399. package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  400. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  401. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
  402. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  403. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +2 -0
  404. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +110 -2
  405. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  406. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  407. package/v3/@claude-flow/cli/dist/src/commands/init.js +94 -38
  408. package/v3/@claude-flow/cli/dist/src/commands/memory.js +85 -1
  409. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  410. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  411. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  412. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  413. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  414. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  415. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  416. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  417. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  418. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +1 -0
  419. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +12 -0
  420. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +1 -1
  421. package/v3/@claude-flow/cli/dist/src/funnel/index.js +1 -1
  422. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
  423. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  424. package/v3/@claude-flow/cli/dist/src/init/helper-signing.d.ts +8 -1
  425. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +9 -2
  426. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
  427. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +949 -949
  428. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  429. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  430. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +22 -22
  431. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.d.ts +10 -0
  432. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +139 -88
  433. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +18 -0
  434. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +539 -407
  435. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  436. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  437. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.d.ts +195 -0
  438. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.js +643 -0
  439. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.d.ts +206 -0
  440. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.js +626 -0
  441. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  442. package/v3/@claude-flow/cli/dist/src/services/event-stream.d.ts +25 -0
  443. package/v3/@claude-flow/cli/dist/src/services/event-stream.js +27 -0
  444. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  445. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.d.ts +16 -0
  446. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.js +34 -0
  447. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
  448. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.d.ts +22 -0
  449. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.js +45 -0
  450. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  451. package/v3/@claude-flow/cli/package.json +134 -133
  452. package/v3/@claude-flow/guidance/README.md +1195 -1195
  453. package/v3/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
  454. package/v3/@claude-flow/guidance/dist/adversarial.js +572 -0
  455. package/v3/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
  456. package/v3/@claude-flow/guidance/dist/analyzer.js +2587 -0
  457. package/v3/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
  458. package/v3/@claude-flow/guidance/dist/artifacts.js +356 -0
  459. package/v3/@claude-flow/guidance/dist/authority.d.ts +290 -0
  460. package/v3/@claude-flow/guidance/dist/authority.js +558 -0
  461. package/v3/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
  462. package/v3/@claude-flow/guidance/dist/capabilities.js +485 -0
  463. package/v3/@claude-flow/guidance/dist/coherence.d.ts +233 -0
  464. package/v3/@claude-flow/guidance/dist/coherence.js +372 -0
  465. package/v3/@claude-flow/guidance/dist/compiler.d.ts +87 -0
  466. package/v3/@claude-flow/guidance/dist/compiler.js +410 -0
  467. package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
  468. package/v3/@claude-flow/guidance/dist/conformance-kit.js +629 -0
  469. package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
  470. package/v3/@claude-flow/guidance/dist/continue-gate.js +353 -0
  471. package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
  472. package/v3/@claude-flow/guidance/dist/crypto-utils.js +24 -0
  473. package/v3/@claude-flow/guidance/dist/evolution.d.ts +282 -0
  474. package/v3/@claude-flow/guidance/dist/evolution.js +500 -0
  475. package/v3/@claude-flow/guidance/dist/gates.d.ts +79 -0
  476. package/v3/@claude-flow/guidance/dist/gates.js +302 -0
  477. package/v3/@claude-flow/guidance/dist/gateway.d.ts +206 -0
  478. package/v3/@claude-flow/guidance/dist/gateway.js +452 -0
  479. package/v3/@claude-flow/guidance/dist/generators.d.ts +153 -0
  480. package/v3/@claude-flow/guidance/dist/generators.js +682 -0
  481. package/v3/@claude-flow/guidance/dist/headless.d.ts +177 -0
  482. package/v3/@claude-flow/guidance/dist/headless.js +342 -0
  483. package/v3/@claude-flow/guidance/dist/hooks.d.ts +109 -0
  484. package/v3/@claude-flow/guidance/dist/hooks.js +347 -0
  485. package/v3/@claude-flow/guidance/dist/index.d.ts +205 -0
  486. package/v3/@claude-flow/guidance/dist/index.js +321 -0
  487. package/v3/@claude-flow/guidance/dist/ledger.d.ts +162 -0
  488. package/v3/@claude-flow/guidance/dist/ledger.js +375 -0
  489. package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
  490. package/v3/@claude-flow/guidance/dist/manifest-validator.js +838 -0
  491. package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
  492. package/v3/@claude-flow/guidance/dist/memory-gate.js +382 -0
  493. package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
  494. package/v3/@claude-flow/guidance/dist/meta-governance.js +348 -0
  495. package/v3/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
  496. package/v3/@claude-flow/guidance/dist/optimizer.js +329 -0
  497. package/v3/@claude-flow/guidance/dist/persistence.d.ts +189 -0
  498. package/v3/@claude-flow/guidance/dist/persistence.js +464 -0
  499. package/v3/@claude-flow/guidance/dist/proof.d.ts +185 -0
  500. package/v3/@claude-flow/guidance/dist/proof.js +238 -0
  501. package/v3/@claude-flow/guidance/dist/retriever.d.ts +172 -0
  502. package/v3/@claude-flow/guidance/dist/retriever.js +596 -0
  503. package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
  504. package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
  505. package/v3/@claude-flow/guidance/dist/temporal.d.ts +426 -0
  506. package/v3/@claude-flow/guidance/dist/temporal.js +658 -0
  507. package/v3/@claude-flow/guidance/dist/trust.d.ts +283 -0
  508. package/v3/@claude-flow/guidance/dist/trust.js +473 -0
  509. package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
  510. package/v3/@claude-flow/guidance/dist/truth-anchors.js +488 -0
  511. package/v3/@claude-flow/guidance/dist/types.d.ts +378 -0
  512. package/v3/@claude-flow/guidance/dist/types.js +10 -0
  513. package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
  514. package/v3/@claude-flow/guidance/dist/uncertainty.js +619 -0
  515. package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
  516. package/v3/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
  517. package/v3/@claude-flow/guidance/package.json +198 -198
  518. package/v3/@claude-flow/shared/README.md +323 -323
  519. package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +41 -0
  520. package/v3/@claude-flow/shared/dist/core/config/defaults.js +186 -0
  521. package/v3/@claude-flow/shared/dist/core/config/index.d.ts +8 -0
  522. package/v3/@claude-flow/shared/dist/core/config/index.js +12 -0
  523. package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +45 -0
  524. package/v3/@claude-flow/shared/dist/core/config/loader.js +238 -0
  525. package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +1728 -0
  526. package/v3/@claude-flow/shared/dist/core/config/schema.js +160 -0
  527. package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +92 -0
  528. package/v3/@claude-flow/shared/dist/core/config/validator.js +147 -0
  529. package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +31 -0
  530. package/v3/@claude-flow/shared/dist/core/event-bus.js +197 -0
  531. package/v3/@claude-flow/shared/dist/core/index.d.ts +15 -0
  532. package/v3/@claude-flow/shared/dist/core/index.js +19 -0
  533. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +200 -0
  534. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +6 -0
  535. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +310 -0
  536. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +7 -0
  537. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +224 -0
  538. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +46 -0
  539. package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +10 -0
  540. package/v3/@claude-flow/shared/dist/core/interfaces/index.js +15 -0
  541. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +298 -0
  542. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +7 -0
  543. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +185 -0
  544. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +6 -0
  545. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +35 -0
  546. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +101 -0
  547. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +60 -0
  548. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +166 -0
  549. package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +46 -0
  550. package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +64 -0
  551. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
  552. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +195 -0
  553. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +83 -0
  554. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +193 -0
  555. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +49 -0
  556. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +253 -0
  557. package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +282 -0
  558. package/v3/@claude-flow/shared/dist/events/domain-events.js +165 -0
  559. package/v3/@claude-flow/shared/dist/events/event-store.d.ts +126 -0
  560. package/v3/@claude-flow/shared/dist/events/event-store.js +427 -0
  561. package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +8 -0
  562. package/v3/@claude-flow/shared/dist/events/event-store.test.js +293 -0
  563. package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +10 -0
  564. package/v3/@claude-flow/shared/dist/events/example-usage.js +193 -0
  565. package/v3/@claude-flow/shared/dist/events/index.d.ts +21 -0
  566. package/v3/@claude-flow/shared/dist/events/index.js +22 -0
  567. package/v3/@claude-flow/shared/dist/events/projections.d.ts +177 -0
  568. package/v3/@claude-flow/shared/dist/events/projections.js +421 -0
  569. package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +82 -0
  570. package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +340 -0
  571. package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +101 -0
  572. package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +263 -0
  573. package/v3/@claude-flow/shared/dist/events.d.ts +80 -0
  574. package/v3/@claude-flow/shared/dist/events.js +249 -0
  575. package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +42 -0
  576. package/v3/@claude-flow/shared/dist/hooks/example-usage.js +351 -0
  577. package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +100 -0
  578. package/v3/@claude-flow/shared/dist/hooks/executor.js +267 -0
  579. package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +9 -0
  580. package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +322 -0
  581. package/v3/@claude-flow/shared/dist/hooks/index.d.ts +52 -0
  582. package/v3/@claude-flow/shared/dist/hooks/index.js +51 -0
  583. package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +133 -0
  584. package/v3/@claude-flow/shared/dist/hooks/registry.js +277 -0
  585. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +105 -0
  586. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +481 -0
  587. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +144 -0
  588. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +328 -0
  589. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +158 -0
  590. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +450 -0
  591. package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +17 -0
  592. package/v3/@claude-flow/shared/dist/hooks/safety/index.js +17 -0
  593. package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +234 -0
  594. package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +334 -0
  595. package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +163 -0
  596. package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +326 -0
  597. package/v3/@claude-flow/shared/dist/hooks/types.d.ts +267 -0
  598. package/v3/@claude-flow/shared/dist/hooks/types.js +62 -0
  599. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +9 -0
  600. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +93 -0
  601. package/v3/@claude-flow/shared/dist/index.d.ts +20 -0
  602. package/v3/@claude-flow/shared/dist/index.js +50 -0
  603. package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +98 -0
  604. package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +364 -0
  605. package/v3/@claude-flow/shared/dist/mcp/index.d.ts +69 -0
  606. package/v3/@claude-flow/shared/dist/mcp/index.js +84 -0
  607. package/v3/@claude-flow/shared/dist/mcp/server.d.ts +166 -0
  608. package/v3/@claude-flow/shared/dist/mcp/server.js +590 -0
  609. package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +136 -0
  610. package/v3/@claude-flow/shared/dist/mcp/session-manager.js +335 -0
  611. package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +178 -0
  612. package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +439 -0
  613. package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +104 -0
  614. package/v3/@claude-flow/shared/dist/mcp/transport/http.js +476 -0
  615. package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +102 -0
  616. package/v3/@claude-flow/shared/dist/mcp/transport/index.js +238 -0
  617. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +104 -0
  618. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +263 -0
  619. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +133 -0
  620. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +396 -0
  621. package/v3/@claude-flow/shared/dist/mcp/types.d.ts +436 -0
  622. package/v3/@claude-flow/shared/dist/mcp/types.js +54 -0
  623. package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +544 -0
  624. package/v3/@claude-flow/shared/dist/plugin-interface.js +23 -0
  625. package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +139 -0
  626. package/v3/@claude-flow/shared/dist/plugin-loader.js +434 -0
  627. package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +183 -0
  628. package/v3/@claude-flow/shared/dist/plugin-registry.js +457 -0
  629. package/v3/@claude-flow/shared/dist/plugins/index.d.ts +10 -0
  630. package/v3/@claude-flow/shared/dist/plugins/index.js +10 -0
  631. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
  632. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +241 -0
  633. package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +10 -0
  634. package/v3/@claude-flow/shared/dist/plugins/official/index.js +10 -0
  635. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +121 -0
  636. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +355 -0
  637. package/v3/@claude-flow/shared/dist/plugins/types.d.ts +93 -0
  638. package/v3/@claude-flow/shared/dist/plugins/types.js +9 -0
  639. package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +105 -0
  640. package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +206 -0
  641. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +132 -0
  642. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +233 -0
  643. package/v3/@claude-flow/shared/dist/resilience/index.d.ts +19 -0
  644. package/v3/@claude-flow/shared/dist/resilience/index.js +19 -0
  645. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +168 -0
  646. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +314 -0
  647. package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +91 -0
  648. package/v3/@claude-flow/shared/dist/resilience/retry.js +159 -0
  649. package/v3/@claude-flow/shared/dist/security/index.d.ts +10 -0
  650. package/v3/@claude-flow/shared/dist/security/index.js +12 -0
  651. package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +73 -0
  652. package/v3/@claude-flow/shared/dist/security/input-validation.js +201 -0
  653. package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +92 -0
  654. package/v3/@claude-flow/shared/dist/security/secure-random.js +142 -0
  655. package/v3/@claude-flow/shared/dist/services/index.d.ts +7 -0
  656. package/v3/@claude-flow/shared/dist/services/index.js +7 -0
  657. package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +124 -0
  658. package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +402 -0
  659. package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +137 -0
  660. package/v3/@claude-flow/shared/dist/types/agent.types.js +6 -0
  661. package/v3/@claude-flow/shared/dist/types/index.d.ts +11 -0
  662. package/v3/@claude-flow/shared/dist/types/index.js +17 -0
  663. package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +266 -0
  664. package/v3/@claude-flow/shared/dist/types/mcp.types.js +7 -0
  665. package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +236 -0
  666. package/v3/@claude-flow/shared/dist/types/memory.types.js +7 -0
  667. package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +186 -0
  668. package/v3/@claude-flow/shared/dist/types/swarm.types.js +65 -0
  669. package/v3/@claude-flow/shared/dist/types/task.types.d.ts +178 -0
  670. package/v3/@claude-flow/shared/dist/types/task.types.js +32 -0
  671. package/v3/@claude-flow/shared/dist/types.d.ts +197 -0
  672. package/v3/@claude-flow/shared/dist/types.js +21 -0
  673. package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +69 -0
  674. package/v3/@claude-flow/shared/dist/utils/secure-logger.js +208 -0
  675. package/v3/@claude-flow/shared/package.json +43 -43
  676. package/v3/README.md +493 -493
  677. package/.claude/security-scans/scan-all-standard.json +0 -321
  678. package/.claude/security-scans/scan-code-deep.json +0 -1209
  679. package/.claude/security-scans/scan-deps-full.json +0 -14
@@ -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@v4
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@v4
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)