claude-flow 3.32.8 → 3.32.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (455) hide show
  1. package/.claude/.proven-config-version +1 -0
  2. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  3. package/.claude/agents/analysis/analyze-code-quality.md +57 -57
  4. package/.claude/agents/analysis/code-analyzer.md +188 -188
  5. package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
  6. package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
  7. package/.claude/agents/base-template-generator.md +41 -41
  8. package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
  9. package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
  10. package/.claude/agents/consensus/gossip-coordinator.md +42 -42
  11. package/.claude/agents/consensus/performance-benchmarker.md +830 -830
  12. package/.claude/agents/consensus/quorum-manager.md +802 -802
  13. package/.claude/agents/consensus/raft-manager.md +42 -42
  14. package/.claude/agents/consensus/security-manager.md +601 -601
  15. package/.claude/agents/core/coder.md +254 -254
  16. package/.claude/agents/core/planner.md +151 -151
  17. package/.claude/agents/core/researcher.md +173 -173
  18. package/.claude/agents/core/reviewer.md +308 -308
  19. package/.claude/agents/core/tester.md +299 -299
  20. package/.claude/agents/custom/test-long-runner.md +43 -43
  21. package/.claude/agents/data/ml/data-ml-model.md +75 -75
  22. package/.claude/agents/database-specialist.md +9 -9
  23. package/.claude/agents/development/backend/dev-backend-api.md +28 -28
  24. package/.claude/agents/development/dev-backend-api.md +177 -177
  25. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
  26. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
  27. package/.claude/agents/dual-mode/codex-coordinator.md +206 -206
  28. package/.claude/agents/dual-mode/codex-worker.md +190 -190
  29. package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
  30. package/.claude/agents/flow-nexus/app-store.md +87 -87
  31. package/.claude/agents/flow-nexus/authentication.md +68 -68
  32. package/.claude/agents/flow-nexus/challenges.md +80 -80
  33. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  34. package/.claude/agents/flow-nexus/payments.md +82 -82
  35. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  36. package/.claude/agents/flow-nexus/swarm.md +75 -75
  37. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  38. package/.claude/agents/flow-nexus/workflow.md +83 -83
  39. package/.claude/agents/github/code-review-swarm.md +520 -520
  40. package/.claude/agents/github/github-modes.md +153 -153
  41. package/.claude/agents/github/issue-tracker.md +298 -298
  42. package/.claude/agents/github/multi-repo-swarm.md +524 -524
  43. package/.claude/agents/github/pr-manager.md +162 -162
  44. package/.claude/agents/github/project-board-sync.md +477 -477
  45. package/.claude/agents/github/release-manager.md +337 -337
  46. package/.claude/agents/github/release-swarm.md +550 -550
  47. package/.claude/agents/github/repo-architect.md +364 -364
  48. package/.claude/agents/github/swarm-issue.md +550 -550
  49. package/.claude/agents/github/swarm-pr.md +401 -401
  50. package/.claude/agents/github/sync-coordinator.md +424 -424
  51. package/.claude/agents/github/workflow-automation.md +604 -604
  52. package/.claude/agents/goal/agent.md +816 -816
  53. package/.claude/agents/goal/code-goal-planner.md +444 -444
  54. package/.claude/agents/goal/goal-planner.md +167 -167
  55. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
  56. package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
  57. package/.claude/agents/hive-mind/scout-explorer.md +240 -240
  58. package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
  59. package/.claude/agents/hive-mind/worker-specialist.md +215 -215
  60. package/.claude/agents/neural/safla-neural.md +73 -73
  61. package/.claude/agents/optimization/benchmark-suite.md +662 -662
  62. package/.claude/agents/optimization/load-balancer.md +428 -428
  63. package/.claude/agents/optimization/performance-monitor.md +669 -669
  64. package/.claude/agents/optimization/resource-allocator.md +671 -671
  65. package/.claude/agents/optimization/topology-optimizer.md +805 -805
  66. package/.claude/agents/payments/agentic-payments.md +126 -126
  67. package/.claude/agents/project-coordinator.md +8 -8
  68. package/.claude/agents/python-specialist.md +9 -9
  69. package/.claude/agents/reasoning/agent.md +816 -816
  70. package/.claude/agents/reasoning/goal-planner.md +72 -72
  71. package/.claude/agents/security-auditor.md +9 -9
  72. package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
  73. package/.claude/agents/sparc/architecture.md +452 -452
  74. package/.claude/agents/sparc/pseudocode.md +298 -298
  75. package/.claude/agents/sparc/refinement.md +503 -503
  76. package/.claude/agents/sparc/specification.md +257 -257
  77. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
  78. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  79. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  80. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  81. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  82. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  83. package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
  84. package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
  85. package/.claude/agents/swarm/mesh-coordinator.md +362 -362
  86. package/.claude/agents/templates/automation-smart-agent.md +184 -184
  87. package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
  88. package/.claude/agents/templates/github-pr-manager.md +154 -154
  89. package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
  90. package/.claude/agents/templates/memory-coordinator.md +162 -162
  91. package/.claude/agents/templates/migration-plan.md +723 -723
  92. package/.claude/agents/templates/orchestrator-task.md +119 -119
  93. package/.claude/agents/templates/performance-analyzer.md +178 -178
  94. package/.claude/agents/templates/sparc-coordinator.md +162 -162
  95. package/.claude/agents/testing/production-validator.md +372 -372
  96. package/.claude/agents/testing/tdd-london-swarm.md +221 -221
  97. package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
  98. package/.claude/agents/testing/validation/production-validator.md +372 -372
  99. package/.claude/agents/typescript-specialist.md +9 -9
  100. package/.claude/agents/v3/database-specialist.md +9 -9
  101. package/.claude/agents/v3/project-coordinator.md +8 -8
  102. package/.claude/agents/v3/python-specialist.md +9 -9
  103. package/.claude/agents/v3/test-architect.md +9 -9
  104. package/.claude/agents/v3/typescript-specialist.md +9 -9
  105. package/.claude/agents/v3/v3-integration-architect.md +311 -311
  106. package/.claude/agents/v3/v3-memory-specialist.md +280 -280
  107. package/.claude/agents/v3/v3-performance-engineer.md +362 -362
  108. package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
  109. package/.claude/agents/v3/v3-security-architect.md +139 -139
  110. package/.claude/checkpoints/1767754460.json +8 -8
  111. package/.claude/commands/agents/README.md +10 -10
  112. package/.claude/commands/agents/agent-capabilities.md +21 -21
  113. package/.claude/commands/agents/agent-coordination.md +28 -28
  114. package/.claude/commands/agents/agent-spawning.md +28 -28
  115. package/.claude/commands/agents/agent-types.md +26 -26
  116. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  117. package/.claude/commands/analysis/README.md +9 -9
  118. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  119. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  120. package/.claude/commands/analysis/performance-report.md +25 -25
  121. package/.claude/commands/analysis/token-efficiency.md +44 -44
  122. package/.claude/commands/analysis/token-usage.md +25 -25
  123. package/.claude/commands/automation/README.md +9 -9
  124. package/.claude/commands/automation/auto-agent.md +122 -122
  125. package/.claude/commands/automation/self-healing.md +105 -105
  126. package/.claude/commands/automation/session-memory.md +89 -89
  127. package/.claude/commands/automation/smart-agents.md +72 -72
  128. package/.claude/commands/automation/smart-spawn.md +25 -25
  129. package/.claude/commands/automation/workflow-select.md +25 -25
  130. package/.claude/commands/claude-flow-help.md +103 -103
  131. package/.claude/commands/claude-flow-memory.md +107 -107
  132. package/.claude/commands/claude-flow-swarm.md +205 -205
  133. package/.claude/commands/coordination/README.md +9 -9
  134. package/.claude/commands/coordination/agent-spawn.md +25 -25
  135. package/.claude/commands/coordination/init.md +44 -44
  136. package/.claude/commands/coordination/orchestrate.md +43 -43
  137. package/.claude/commands/coordination/spawn.md +45 -45
  138. package/.claude/commands/coordination/swarm-init.md +85 -85
  139. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  140. package/.claude/commands/flow-nexus/app-store.md +123 -123
  141. package/.claude/commands/flow-nexus/challenges.md +119 -119
  142. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  143. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  144. package/.claude/commands/flow-nexus/payments.md +115 -115
  145. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  146. package/.claude/commands/flow-nexus/swarm.md +86 -86
  147. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  148. package/.claude/commands/flow-nexus/workflow.md +114 -114
  149. package/.claude/commands/github/README.md +11 -11
  150. package/.claude/commands/github/code-review-swarm.md +513 -513
  151. package/.claude/commands/github/code-review.md +25 -25
  152. package/.claude/commands/github/github-modes.md +146 -146
  153. package/.claude/commands/github/github-swarm.md +121 -121
  154. package/.claude/commands/github/issue-tracker.md +291 -291
  155. package/.claude/commands/github/issue-triage.md +25 -25
  156. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  157. package/.claude/commands/github/pr-enhance.md +26 -26
  158. package/.claude/commands/github/pr-manager.md +169 -169
  159. package/.claude/commands/github/project-board-sync.md +470 -470
  160. package/.claude/commands/github/release-manager.md +337 -337
  161. package/.claude/commands/github/release-swarm.md +543 -543
  162. package/.claude/commands/github/repo-analyze.md +25 -25
  163. package/.claude/commands/github/repo-architect.md +366 -366
  164. package/.claude/commands/github/swarm-issue.md +481 -481
  165. package/.claude/commands/github/swarm-pr.md +284 -284
  166. package/.claude/commands/github/sync-coordinator.md +300 -300
  167. package/.claude/commands/github/workflow-automation.md +441 -441
  168. package/.claude/commands/hive-mind/README.md +17 -17
  169. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  170. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  171. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  173. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  175. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  176. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  177. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  178. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  179. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  180. package/.claude/commands/hooks/README.md +11 -11
  181. package/.claude/commands/hooks/overview.md +57 -57
  182. package/.claude/commands/hooks/post-edit.md +117 -117
  183. package/.claude/commands/hooks/post-task.md +112 -112
  184. package/.claude/commands/hooks/pre-edit.md +113 -113
  185. package/.claude/commands/hooks/pre-task.md +111 -111
  186. package/.claude/commands/hooks/session-end.md +118 -118
  187. package/.claude/commands/hooks/setup.md +102 -102
  188. package/.claude/commands/memory/README.md +9 -9
  189. package/.claude/commands/memory/memory-persist.md +25 -25
  190. package/.claude/commands/memory/memory-search.md +25 -25
  191. package/.claude/commands/memory/memory-usage.md +25 -25
  192. package/.claude/commands/memory/neural.md +47 -47
  193. package/.claude/commands/monitoring/README.md +9 -9
  194. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  195. package/.claude/commands/monitoring/agents.md +44 -44
  196. package/.claude/commands/monitoring/real-time-view.md +25 -25
  197. package/.claude/commands/monitoring/status.md +46 -46
  198. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  199. package/.claude/commands/optimization/README.md +9 -9
  200. package/.claude/commands/optimization/auto-topology.md +61 -61
  201. package/.claude/commands/optimization/cache-manage.md +25 -25
  202. package/.claude/commands/optimization/parallel-execute.md +25 -25
  203. package/.claude/commands/optimization/parallel-execution.md +49 -49
  204. package/.claude/commands/optimization/topology-optimize.md +25 -25
  205. package/.claude/commands/pair/README.md +260 -260
  206. package/.claude/commands/pair/commands.md +545 -545
  207. package/.claude/commands/pair/config.md +509 -509
  208. package/.claude/commands/pair/examples.md +511 -511
  209. package/.claude/commands/pair/modes.md +347 -347
  210. package/.claude/commands/pair/session.md +406 -406
  211. package/.claude/commands/pair/start.md +208 -208
  212. package/.claude/commands/sparc/analyzer.md +51 -51
  213. package/.claude/commands/sparc/architect.md +53 -53
  214. package/.claude/commands/sparc/ask.md +97 -97
  215. package/.claude/commands/sparc/batch-executor.md +54 -54
  216. package/.claude/commands/sparc/code.md +89 -89
  217. package/.claude/commands/sparc/coder.md +54 -54
  218. package/.claude/commands/sparc/debug.md +83 -83
  219. package/.claude/commands/sparc/debugger.md +54 -54
  220. package/.claude/commands/sparc/designer.md +53 -53
  221. package/.claude/commands/sparc/devops.md +109 -109
  222. package/.claude/commands/sparc/docs-writer.md +80 -80
  223. package/.claude/commands/sparc/documenter.md +54 -54
  224. package/.claude/commands/sparc/innovator.md +54 -54
  225. package/.claude/commands/sparc/integration.md +83 -83
  226. package/.claude/commands/sparc/mcp.md +117 -117
  227. package/.claude/commands/sparc/memory-manager.md +54 -54
  228. package/.claude/commands/sparc/optimizer.md +54 -54
  229. package/.claude/commands/sparc/orchestrator.md +131 -131
  230. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  231. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  232. package/.claude/commands/sparc/researcher.md +54 -54
  233. package/.claude/commands/sparc/reviewer.md +54 -54
  234. package/.claude/commands/sparc/security-review.md +80 -80
  235. package/.claude/commands/sparc/sparc-modes.md +174 -174
  236. package/.claude/commands/sparc/sparc.md +111 -111
  237. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  238. package/.claude/commands/sparc/supabase-admin.md +348 -348
  239. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  240. package/.claude/commands/sparc/tdd.md +54 -54
  241. package/.claude/commands/sparc/tester.md +54 -54
  242. package/.claude/commands/sparc/tutorial.md +79 -79
  243. package/.claude/commands/sparc/workflow-manager.md +54 -54
  244. package/.claude/commands/sparc.md +166 -166
  245. package/.claude/commands/stream-chain/pipeline.md +120 -120
  246. package/.claude/commands/stream-chain/run.md +69 -69
  247. package/.claude/commands/swarm/README.md +15 -15
  248. package/.claude/commands/swarm/analysis.md +95 -95
  249. package/.claude/commands/swarm/development.md +96 -96
  250. package/.claude/commands/swarm/examples.md +168 -168
  251. package/.claude/commands/swarm/maintenance.md +102 -102
  252. package/.claude/commands/swarm/optimization.md +117 -117
  253. package/.claude/commands/swarm/research.md +136 -136
  254. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  255. package/.claude/commands/swarm/swarm-background.md +8 -8
  256. package/.claude/commands/swarm/swarm-init.md +19 -19
  257. package/.claude/commands/swarm/swarm-modes.md +8 -8
  258. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  259. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  260. package/.claude/commands/swarm/swarm-status.md +8 -8
  261. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  262. package/.claude/commands/swarm/swarm.md +27 -27
  263. package/.claude/commands/swarm/testing.md +131 -131
  264. package/.claude/commands/training/README.md +9 -9
  265. package/.claude/commands/training/model-update.md +25 -25
  266. package/.claude/commands/training/neural-patterns.md +73 -73
  267. package/.claude/commands/training/neural-train.md +25 -25
  268. package/.claude/commands/training/pattern-learn.md +25 -25
  269. package/.claude/commands/training/specialization.md +62 -62
  270. package/.claude/commands/truth/start.md +142 -142
  271. package/.claude/commands/verify/check.md +49 -49
  272. package/.claude/commands/verify/start.md +127 -127
  273. package/.claude/commands/workflows/README.md +9 -9
  274. package/.claude/commands/workflows/development.md +77 -77
  275. package/.claude/commands/workflows/research.md +62 -62
  276. package/.claude/commands/workflows/workflow-create.md +25 -25
  277. package/.claude/commands/workflows/workflow-execute.md +25 -25
  278. package/.claude/commands/workflows/workflow-export.md +25 -25
  279. package/.claude/config/v3-dependency-optimization.json +265 -265
  280. package/.claude/config/v3-performance-targets.json +250 -250
  281. package/.claude/helpers/.LOCKED +2 -2
  282. package/.claude/helpers/.helpers-version +1 -0
  283. package/.claude/helpers/README.md +96 -96
  284. package/.claude/helpers/adr-compliance.sh +186 -186
  285. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  286. package/.claude/helpers/auto-commit.sh +178 -178
  287. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  288. package/.claude/helpers/checkpoint-manager.sh +251 -251
  289. package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
  290. package/.claude/helpers/daemon-manager.sh +252 -252
  291. package/.claude/helpers/ddd-tracker.sh +144 -144
  292. package/.claude/helpers/github-safe.js +156 -156
  293. package/.claude/helpers/github-setup.sh +45 -45
  294. package/.claude/helpers/guidance-hook.sh +13 -13
  295. package/.claude/helpers/guidance-hooks.sh +102 -102
  296. package/.claude/helpers/health-monitor.sh +108 -108
  297. package/.claude/helpers/helpers.manifest.json +13 -0
  298. package/.claude/helpers/hook-handler.cjs +464 -464
  299. package/.claude/helpers/intelligence.cjs +1058 -1058
  300. package/.claude/helpers/learning-hooks.sh +329 -329
  301. package/.claude/helpers/learning-optimizer.sh +127 -127
  302. package/.claude/helpers/learning-service.mjs +1144 -1144
  303. package/.claude/helpers/memory.cjs +84 -84
  304. package/.claude/helpers/metrics-db.mjs +503 -503
  305. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  306. package/.claude/helpers/pattern-consolidator.sh +86 -86
  307. package/.claude/helpers/perf-worker.sh +160 -160
  308. package/.claude/helpers/quick-start.sh +19 -19
  309. package/.claude/helpers/router.cjs +62 -62
  310. package/.claude/helpers/security-scanner.sh +127 -127
  311. package/.claude/helpers/session.cjs +125 -125
  312. package/.claude/helpers/setup-mcp.sh +18 -18
  313. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  314. package/.claude/helpers/statusline.cjs +211 -2
  315. package/.claude/helpers/swarm-comms.sh +353 -353
  316. package/.claude/helpers/swarm-hooks.sh +761 -761
  317. package/.claude/helpers/swarm-monitor.sh +210 -210
  318. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  319. package/.claude/helpers/update-v3-progress.sh +165 -165
  320. package/.claude/helpers/v3-quick-status.sh +57 -57
  321. package/.claude/helpers/v3.sh +110 -110
  322. package/.claude/helpers/validate-v3-config.sh +215 -215
  323. package/.claude/helpers/worker-manager.sh +170 -170
  324. package/.claude/mcp.json +12 -12
  325. package/.claude/proven-config.json +42 -0
  326. package/.claude/settings.json +284 -284
  327. package/.claude/settings.json.bak +526 -526
  328. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  329. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  330. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  331. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  332. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  333. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  334. package/.claude/skills/browser/SKILL.md +204 -204
  335. package/.claude/skills/dual-mode/README.md +71 -71
  336. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  337. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  338. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  339. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  340. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  341. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  342. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  343. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  344. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  345. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  346. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  347. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  348. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  349. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  350. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  351. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  352. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  353. package/.claude/skills/skill-builder/SKILL.md +910 -910
  354. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  355. package/.claude/skills/stream-chain/SKILL.md +560 -560
  356. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  357. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  358. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  359. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  360. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  361. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  362. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  363. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  364. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  365. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  366. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  367. package/.claude/skills/verification-quality/SKILL.md +691 -691
  368. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  369. package/.claude/skills/worker-integration/SKILL.md +147 -147
  370. package/.claude/statusline-command.sh +176 -176
  371. package/.claude/statusline.mjs +109 -109
  372. package/.claude/statusline.sh +431 -431
  373. package/.claude/workflows/full-system-test.js +65 -65
  374. package/.claude/workflows/intelligence-system-hardening.js +120 -120
  375. package/.claude/workflows/plugin-contract-audit.js +91 -91
  376. package/.claude-plugin/README.md +720 -720
  377. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  378. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  379. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  380. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  381. package/.claude-plugin/hooks/hooks.json +79 -77
  382. package/.claude-plugin/marketplace.json +185 -185
  383. package/.claude-plugin/plugin.json +71 -71
  384. package/.claude-plugin/scripts/install.sh +234 -234
  385. package/.claude-plugin/scripts/ruflo-hook.cjs +166 -166
  386. package/.claude-plugin/scripts/ruflo-hook.sh +52 -52
  387. package/.claude-plugin/scripts/uninstall.sh +36 -36
  388. package/.claude-plugin/scripts/verify.sh +108 -108
  389. package/LICENSE +21 -21
  390. package/README.md +419 -419
  391. package/bin/cli.js +11 -11
  392. package/bin/npx-repair.js +7 -7
  393. package/bin/npx-safe-launch.js +9 -9
  394. package/package.json +192 -186
  395. package/v3/@claude-flow/cli/README.md +419 -419
  396. package/v3/@claude-flow/cli/bin/cli.js +314 -314
  397. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  398. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  399. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  400. package/v3/@claude-flow/cli/dist/src/autopilot-state.js +24 -7
  401. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
  402. package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  403. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  404. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
  405. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +267 -20
  406. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  407. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  408. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +74 -11
  409. package/v3/@claude-flow/cli/dist/src/commands/init.js +202 -34
  410. package/v3/@claude-flow/cli/dist/src/commands/memory.js +12 -1
  411. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  412. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  413. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  414. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  415. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  416. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  417. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  418. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  419. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  420. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +13 -2
  421. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.d.ts +11 -4
  422. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.js +11 -4
  423. package/v3/@claude-flow/cli/dist/src/funnel/messages.d.ts +12 -10
  424. package/v3/@claude-flow/cli/dist/src/funnel/messages.js +83 -11
  425. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
  426. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  427. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +2 -2
  428. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
  429. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +24 -24
  430. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  431. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  432. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-tools.js +8 -0
  433. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +21 -0
  434. package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +4 -3
  435. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.d.ts +9 -0
  436. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +35 -22
  437. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +189 -93
  438. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +479 -407
  439. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  440. package/v3/@claude-flow/cli/dist/src/parser.js +25 -9
  441. package/v3/@claude-flow/cli/dist/src/proxy/verify.js +2 -2
  442. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  443. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  444. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  445. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
  446. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +7 -4
  447. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  448. package/v3/@claude-flow/cli/package.json +137 -135
  449. package/v3/@claude-flow/guidance/README.md +1195 -1195
  450. package/v3/@claude-flow/guidance/package.json +198 -198
  451. package/v3/@claude-flow/shared/README.md +323 -323
  452. package/v3/@claude-flow/shared/dist/events/event-store.js +31 -31
  453. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +3 -3
  454. package/v3/@claude-flow/shared/package.json +43 -43
  455. package/v3/README.md +493 -493
@@ -1,672 +1,672 @@
1
- ---
2
- name: Resource Allocator
3
- description: Adaptive resource allocation, predictive scaling and intelligent capacity planning
4
- ---
5
-
6
- # Resource Allocator Agent
7
-
8
- ## Agent Profile
9
- - **Name**: Resource Allocator
10
- - **Type**: Performance Optimization Agent
11
- - **Specialization**: Adaptive resource allocation and predictive scaling
12
- - **Performance Focus**: Intelligent resource management and capacity planning
13
-
14
- ## Core Capabilities
15
-
16
- ### 1. Adaptive Resource Allocation
17
- ```javascript
18
- // Advanced adaptive resource allocation system
19
- class AdaptiveResourceAllocator {
20
- constructor() {
21
- this.allocators = {
22
- cpu: new CPUAllocator(),
23
- memory: new MemoryAllocator(),
24
- storage: new StorageAllocator(),
25
- network: new NetworkAllocator(),
26
- agents: new AgentAllocator()
27
- };
28
-
29
- this.predictor = new ResourcePredictor();
30
- this.optimizer = new AllocationOptimizer();
31
- this.monitor = new ResourceMonitor();
32
- }
33
-
34
- // Dynamic resource allocation based on workload patterns
35
- async allocateResources(swarmId, workloadProfile, constraints = {}) {
36
- // Analyze current resource usage
37
- const currentUsage = await this.analyzeCurrentUsage(swarmId);
38
-
39
- // Predict future resource needs
40
- const predictions = await this.predictor.predict(workloadProfile, currentUsage);
41
-
42
- // Calculate optimal allocation
43
- const allocation = await this.optimizer.optimize(predictions, constraints);
44
-
45
- // Apply allocation with gradual rollout
46
- const rolloutPlan = await this.planGradualRollout(allocation, currentUsage);
47
-
48
- // Execute allocation
49
- const result = await this.executeAllocation(rolloutPlan);
50
-
51
- return {
52
- allocation,
53
- rolloutPlan,
54
- result,
55
- monitoring: await this.setupMonitoring(allocation)
56
- };
57
- }
58
-
59
- // Workload pattern analysis
60
- async analyzeWorkloadPatterns(historicalData, timeWindow = '7d') {
61
- const patterns = {
62
- // Temporal patterns
63
- temporal: {
64
- hourly: this.analyzeHourlyPatterns(historicalData),
65
- daily: this.analyzeDailyPatterns(historicalData),
66
- weekly: this.analyzeWeeklyPatterns(historicalData),
67
- seasonal: this.analyzeSeasonalPatterns(historicalData)
68
- },
69
-
70
- // Load patterns
71
- load: {
72
- baseline: this.calculateBaselineLoad(historicalData),
73
- peaks: this.identifyPeakPatterns(historicalData),
74
- valleys: this.identifyValleyPatterns(historicalData),
75
- spikes: this.detectAnomalousSpikes(historicalData)
76
- },
77
-
78
- // Resource correlation patterns
79
- correlations: {
80
- cpu_memory: this.analyzeCPUMemoryCorrelation(historicalData),
81
- network_load: this.analyzeNetworkLoadCorrelation(historicalData),
82
- agent_resource: this.analyzeAgentResourceCorrelation(historicalData)
83
- },
84
-
85
- // Predictive indicators
86
- indicators: {
87
- growth_rate: this.calculateGrowthRate(historicalData),
88
- volatility: this.calculateVolatility(historicalData),
89
- predictability: this.calculatePredictability(historicalData)
90
- }
91
- };
92
-
93
- return patterns;
94
- }
95
-
96
- // Multi-objective resource optimization
97
- async optimizeResourceAllocation(resources, demands, objectives) {
98
- const optimizationProblem = {
99
- variables: this.defineOptimizationVariables(resources),
100
- constraints: this.defineConstraints(resources, demands),
101
- objectives: this.defineObjectives(objectives)
102
- };
103
-
104
- // Use multi-objective genetic algorithm
105
- const solver = new MultiObjectiveGeneticSolver({
106
- populationSize: 100,
107
- generations: 200,
108
- mutationRate: 0.1,
109
- crossoverRate: 0.8
110
- });
111
-
112
- const solutions = await solver.solve(optimizationProblem);
113
-
114
- // Select solution from Pareto front
115
- const selectedSolution = this.selectFromParetoFront(solutions, objectives);
116
-
117
- return {
118
- optimalAllocation: selectedSolution.allocation,
119
- paretoFront: solutions.paretoFront,
120
- tradeoffs: solutions.tradeoffs,
121
- confidence: selectedSolution.confidence
122
- };
123
- }
124
- }
125
- ```
126
-
127
- ### 2. Predictive Scaling with Machine Learning
128
- ```javascript
129
- // ML-powered predictive scaling system
130
- class PredictiveScaler {
131
- constructor() {
132
- this.models = {
133
- time_series: new LSTMTimeSeriesModel(),
134
- regression: new RandomForestRegressor(),
135
- anomaly: new IsolationForestModel(),
136
- ensemble: new EnsemblePredictor()
137
- };
138
-
139
- this.featureEngineering = new FeatureEngineer();
140
- this.dataPreprocessor = new DataPreprocessor();
141
- }
142
-
143
- // Predict scaling requirements
144
- async predictScaling(swarmId, timeHorizon = 3600, confidence = 0.95) {
145
- // Collect training data
146
- const trainingData = await this.collectTrainingData(swarmId);
147
-
148
- // Engineer features
149
- const features = await this.featureEngineering.engineer(trainingData);
150
-
151
- // Train/update models
152
- await this.updateModels(features);
153
-
154
- // Generate predictions
155
- const predictions = await this.generatePredictions(timeHorizon, confidence);
156
-
157
- // Calculate scaling recommendations
158
- const scalingPlan = await this.calculateScalingPlan(predictions);
159
-
160
- return {
161
- predictions,
162
- scalingPlan,
163
- confidence: predictions.confidence,
164
- timeHorizon,
165
- features: features.summary
166
- };
167
- }
168
-
169
- // LSTM-based time series prediction
170
- async trainTimeSeriesModel(data, config = {}) {
171
- const model = await mcp.neural_train({
172
- pattern_type: 'prediction',
173
- training_data: JSON.stringify({
174
- sequences: data.sequences,
175
- targets: data.targets,
176
- features: data.features
177
- }),
178
- epochs: config.epochs || 100
179
- });
180
-
181
- // Validate model performance
182
- const validation = await this.validateModel(model, data.validation);
183
-
184
- if (validation.accuracy > 0.85) {
185
- await mcp.model_save({
186
- modelId: model.modelId,
187
- path: '/models/scaling_predictor.model'
188
- });
189
-
190
- return {
191
- model,
192
- validation,
193
- ready: true
194
- };
195
- }
196
-
197
- return {
198
- model: null,
199
- validation,
200
- ready: false,
201
- reason: 'Model accuracy below threshold'
202
- };
203
- }
204
-
205
- // Reinforcement learning for scaling decisions
206
- async trainScalingAgent(environment, episodes = 1000) {
207
- const agent = new DeepQNetworkAgent({
208
- stateSize: environment.stateSize,
209
- actionSize: environment.actionSize,
210
- learningRate: 0.001,
211
- epsilon: 1.0,
212
- epsilonDecay: 0.995,
213
- memorySize: 10000
214
- });
215
-
216
- const trainingHistory = [];
217
-
218
- for (let episode = 0; episode < episodes; episode++) {
219
- let state = environment.reset();
220
- let totalReward = 0;
221
- let done = false;
222
-
223
- while (!done) {
224
- // Agent selects action
225
- const action = agent.selectAction(state);
226
-
227
- // Environment responds
228
- const { nextState, reward, terminated } = environment.step(action);
229
-
230
- // Agent learns from experience
231
- agent.remember(state, action, reward, nextState, terminated);
232
-
233
- state = nextState;
234
- totalReward += reward;
235
- done = terminated;
236
-
237
- // Train agent periodically
238
- if (agent.memory.length > agent.batchSize) {
239
- await agent.train();
240
- }
241
- }
242
-
243
- trainingHistory.push({
244
- episode,
245
- reward: totalReward,
246
- epsilon: agent.epsilon
247
- });
248
-
249
- // Log progress
250
- if (episode % 100 === 0) {
251
- console.log(`Episode ${episode}: Reward ${totalReward}, Epsilon ${agent.epsilon}`);
252
- }
253
- }
254
-
255
- return {
256
- agent,
257
- trainingHistory,
258
- performance: this.evaluateAgentPerformance(trainingHistory)
259
- };
260
- }
261
- }
262
- ```
263
-
264
- ### 3. Circuit Breaker and Fault Tolerance
265
- ```javascript
266
- // Advanced circuit breaker with adaptive thresholds
267
- class AdaptiveCircuitBreaker {
268
- constructor(config = {}) {
269
- this.failureThreshold = config.failureThreshold || 5;
270
- this.recoveryTimeout = config.recoveryTimeout || 60000;
271
- this.successThreshold = config.successThreshold || 3;
272
-
273
- this.state = 'CLOSED'; // CLOSED, OPEN, HALF_OPEN
274
- this.failureCount = 0;
275
- this.successCount = 0;
276
- this.lastFailureTime = null;
277
-
278
- // Adaptive thresholds
279
- this.adaptiveThresholds = new AdaptiveThresholdManager();
280
- this.performanceHistory = new CircularBuffer(1000);
281
-
282
- // Metrics
283
- this.metrics = {
284
- totalRequests: 0,
285
- successfulRequests: 0,
286
- failedRequests: 0,
287
- circuitOpenEvents: 0,
288
- circuitHalfOpenEvents: 0,
289
- circuitClosedEvents: 0
290
- };
291
- }
292
-
293
- // Execute operation with circuit breaker protection
294
- async execute(operation, fallback = null) {
295
- this.metrics.totalRequests++;
296
-
297
- // Check circuit state
298
- if (this.state === 'OPEN') {
299
- if (this.shouldAttemptReset()) {
300
- this.state = 'HALF_OPEN';
301
- this.successCount = 0;
302
- this.metrics.circuitHalfOpenEvents++;
303
- } else {
304
- return await this.executeFallback(fallback);
305
- }
306
- }
307
-
308
- try {
309
- const startTime = performance.now();
310
- const result = await operation();
311
- const endTime = performance.now();
312
-
313
- // Record success
314
- this.onSuccess(endTime - startTime);
315
- return result;
316
-
317
- } catch (error) {
318
- // Record failure
319
- this.onFailure(error);
320
-
321
- // Execute fallback if available
322
- if (fallback) {
323
- return await this.executeFallback(fallback);
324
- }
325
-
326
- throw error;
327
- }
328
- }
329
-
330
- // Adaptive threshold adjustment
331
- adjustThresholds(performanceData) {
332
- const analysis = this.adaptiveThresholds.analyze(performanceData);
333
-
334
- if (analysis.recommendAdjustment) {
335
- this.failureThreshold = Math.max(
336
- 1,
337
- Math.round(this.failureThreshold * analysis.thresholdMultiplier)
338
- );
339
-
340
- this.recoveryTimeout = Math.max(
341
- 1000,
342
- Math.round(this.recoveryTimeout * analysis.timeoutMultiplier)
343
- );
344
- }
345
- }
346
-
347
- // Bulk head pattern for resource isolation
348
- createBulkhead(resourcePools) {
349
- return resourcePools.map(pool => ({
350
- name: pool.name,
351
- capacity: pool.capacity,
352
- queue: new PriorityQueue(),
353
- semaphore: new Semaphore(pool.capacity),
354
- circuitBreaker: new AdaptiveCircuitBreaker(pool.config),
355
- metrics: new BulkheadMetrics()
356
- }));
357
- }
358
- }
359
- ```
360
-
361
- ### 4. Performance Profiling and Optimization
362
- ```javascript
363
- // Comprehensive performance profiling system
364
- class PerformanceProfiler {
365
- constructor() {
366
- this.profilers = {
367
- cpu: new CPUProfiler(),
368
- memory: new MemoryProfiler(),
369
- io: new IOProfiler(),
370
- network: new NetworkProfiler(),
371
- application: new ApplicationProfiler()
372
- };
373
-
374
- this.analyzer = new ProfileAnalyzer();
375
- this.optimizer = new PerformanceOptimizer();
376
- }
377
-
378
- // Comprehensive performance profiling
379
- async profilePerformance(swarmId, duration = 60000) {
380
- const profilingSession = {
381
- swarmId,
382
- startTime: Date.now(),
383
- duration,
384
- profiles: new Map()
385
- };
386
-
387
- // Start all profilers concurrently
388
- const profilingTasks = Object.entries(this.profilers).map(
389
- async ([type, profiler]) => {
390
- const profile = await profiler.profile(duration);
391
- return [type, profile];
392
- }
393
- );
394
-
395
- const profiles = await Promise.all(profilingTasks);
396
-
397
- for (const [type, profile] of profiles) {
398
- profilingSession.profiles.set(type, profile);
399
- }
400
-
401
- // Analyze performance data
402
- const analysis = await this.analyzer.analyze(profilingSession);
403
-
404
- // Generate optimization recommendations
405
- const recommendations = await this.optimizer.recommend(analysis);
406
-
407
- return {
408
- session: profilingSession,
409
- analysis,
410
- recommendations,
411
- summary: this.generateSummary(analysis, recommendations)
412
- };
413
- }
414
-
415
- // CPU profiling with flame graphs
416
- async profileCPU(duration) {
417
- const cpuProfile = {
418
- samples: [],
419
- functions: new Map(),
420
- hotspots: [],
421
- flamegraph: null
422
- };
423
-
424
- // Sample CPU usage at high frequency
425
- const sampleInterval = 10; // 10ms
426
- const samples = duration / sampleInterval;
427
-
428
- for (let i = 0; i < samples; i++) {
429
- const sample = await this.sampleCPU();
430
- cpuProfile.samples.push(sample);
431
-
432
- // Update function statistics
433
- this.updateFunctionStats(cpuProfile.functions, sample);
434
-
435
- await this.sleep(sampleInterval);
436
- }
437
-
438
- // Generate flame graph
439
- cpuProfile.flamegraph = this.generateFlameGraph(cpuProfile.samples);
440
-
441
- // Identify hotspots
442
- cpuProfile.hotspots = this.identifyHotspots(cpuProfile.functions);
443
-
444
- return cpuProfile;
445
- }
446
-
447
- // Memory profiling with leak detection
448
- async profileMemory(duration) {
449
- const memoryProfile = {
450
- snapshots: [],
451
- allocations: [],
452
- deallocations: [],
453
- leaks: [],
454
- growth: []
455
- };
456
-
457
- // Take initial snapshot
458
- let previousSnapshot = await this.takeMemorySnapshot();
459
- memoryProfile.snapshots.push(previousSnapshot);
460
-
461
- const snapshotInterval = 5000; // 5 seconds
462
- const snapshots = duration / snapshotInterval;
463
-
464
- for (let i = 0; i < snapshots; i++) {
465
- await this.sleep(snapshotInterval);
466
-
467
- const snapshot = await this.takeMemorySnapshot();
468
- memoryProfile.snapshots.push(snapshot);
469
-
470
- // Analyze memory changes
471
- const changes = this.analyzeMemoryChanges(previousSnapshot, snapshot);
472
- memoryProfile.allocations.push(...changes.allocations);
473
- memoryProfile.deallocations.push(...changes.deallocations);
474
-
475
- // Detect potential leaks
476
- const leaks = this.detectMemoryLeaks(changes);
477
- memoryProfile.leaks.push(...leaks);
478
-
479
- previousSnapshot = snapshot;
480
- }
481
-
482
- // Analyze memory growth patterns
483
- memoryProfile.growth = this.analyzeMemoryGrowth(memoryProfile.snapshots);
484
-
485
- return memoryProfile;
486
- }
487
- }
488
- ```
489
-
490
- ## MCP Integration Hooks
491
-
492
- ### Resource Management Integration
493
- ```javascript
494
- // Comprehensive MCP resource management
495
- const resourceIntegration = {
496
- // Dynamic resource allocation
497
- async allocateResources(swarmId, requirements) {
498
- // Analyze current resource usage
499
- const currentUsage = await mcp.metrics_collect({
500
- components: ['cpu', 'memory', 'network', 'agents']
501
- });
502
-
503
- // Get performance metrics
504
- const performance = await mcp.performance_report({ format: 'detailed' });
505
-
506
- // Identify bottlenecks
507
- const bottlenecks = await mcp.bottleneck_analyze({});
508
-
509
- // Calculate optimal allocation
510
- const allocation = await this.calculateOptimalAllocation(
511
- currentUsage,
512
- performance,
513
- bottlenecks,
514
- requirements
515
- );
516
-
517
- // Apply resource allocation
518
- const result = await mcp.daa_resource_alloc({
519
- resources: allocation.resources,
520
- agents: allocation.agents
521
- });
522
-
523
- return {
524
- allocation,
525
- result,
526
- monitoring: await this.setupResourceMonitoring(allocation)
527
- };
528
- },
529
-
530
- // Predictive scaling
531
- async predictiveScale(swarmId, predictions) {
532
- // Get current swarm status
533
- const status = await mcp.swarm_status({ swarmId });
534
-
535
- // Calculate scaling requirements
536
- const scalingPlan = this.calculateScalingPlan(status, predictions);
537
-
538
- if (scalingPlan.scaleRequired) {
539
- // Execute scaling
540
- const scalingResult = await mcp.swarm_scale({
541
- swarmId,
542
- targetSize: scalingPlan.targetSize
543
- });
544
-
545
- // Optimize topology after scaling
546
- if (scalingResult.success) {
547
- await mcp.topology_optimize({ swarmId });
548
- }
549
-
550
- return {
551
- scaled: true,
552
- plan: scalingPlan,
553
- result: scalingResult
554
- };
555
- }
556
-
557
- return {
558
- scaled: false,
559
- reason: 'No scaling required',
560
- plan: scalingPlan
561
- };
562
- },
563
-
564
- // Performance optimization
565
- async optimizePerformance(swarmId) {
566
- // Collect comprehensive metrics
567
- const metrics = await Promise.all([
568
- mcp.performance_report({ format: 'json' }),
569
- mcp.bottleneck_analyze({}),
570
- mcp.agent_metrics({}),
571
- mcp.metrics_collect({ components: ['system', 'agents', 'coordination'] })
572
- ]);
573
-
574
- const [performance, bottlenecks, agentMetrics, systemMetrics] = metrics;
575
-
576
- // Generate optimization recommendations
577
- const optimizations = await this.generateOptimizations({
578
- performance,
579
- bottlenecks,
580
- agentMetrics,
581
- systemMetrics
582
- });
583
-
584
- // Apply optimizations
585
- const results = await this.applyOptimizations(swarmId, optimizations);
586
-
587
- return {
588
- optimizations,
589
- results,
590
- impact: await this.measureOptimizationImpact(swarmId, results)
591
- };
592
- }
593
- };
594
- ```
595
-
596
- ## Operational Commands
597
-
598
- ### Resource Management Commands
599
- ```bash
600
- # Analyze resource usage
601
- npx claude-flow metrics-collect --components ["cpu", "memory", "network"]
602
-
603
- # Optimize resource allocation
604
- npx claude-flow daa-resource-alloc --resources <resource-config>
605
-
606
- # Predictive scaling
607
- npx claude-flow swarm-scale --swarm-id <id> --target-size <size>
608
-
609
- # Performance profiling
610
- npx claude-flow performance-report --format detailed --timeframe 24h
611
-
612
- # Circuit breaker configuration
613
- npx claude-flow fault-tolerance --strategy circuit-breaker --config <config>
614
- ```
615
-
616
- ### Optimization Commands
617
- ```bash
618
- # Run performance optimization
619
- npx claude-flow optimize-performance --swarm-id <id> --strategy adaptive
620
-
621
- # Generate resource forecasts
622
- npx claude-flow forecast-resources --time-horizon 3600 --confidence 0.95
623
-
624
- # Profile system performance
625
- npx claude-flow profile-performance --duration 60000 --components all
626
-
627
- # Analyze bottlenecks
628
- npx claude-flow bottleneck-analyze --component swarm-coordination
629
- ```
630
-
631
- ## Integration Points
632
-
633
- ### With Other Optimization Agents
634
- - **Load Balancer**: Provides resource allocation data for load balancing decisions
635
- - **Performance Monitor**: Shares performance metrics and bottleneck analysis
636
- - **Topology Optimizer**: Coordinates resource allocation with topology changes
637
-
638
- ### With Swarm Infrastructure
639
- - **Task Orchestrator**: Allocates resources for task execution
640
- - **Agent Coordinator**: Manages agent resource requirements
641
- - **Memory System**: Stores resource allocation history and patterns
642
-
643
- ## Performance Metrics
644
-
645
- ### Resource Allocation KPIs
646
- ```javascript
647
- // Resource allocation performance metrics
648
- const allocationMetrics = {
649
- efficiency: {
650
- utilization_rate: this.calculateUtilizationRate(),
651
- waste_percentage: this.calculateWastePercentage(),
652
- allocation_accuracy: this.calculateAllocationAccuracy(),
653
- prediction_accuracy: this.calculatePredictionAccuracy()
654
- },
655
-
656
- performance: {
657
- allocation_latency: this.calculateAllocationLatency(),
658
- scaling_response_time: this.calculateScalingResponseTime(),
659
- optimization_impact: this.calculateOptimizationImpact(),
660
- cost_efficiency: this.calculateCostEfficiency()
661
- },
662
-
663
- reliability: {
664
- availability: this.calculateAvailability(),
665
- fault_tolerance: this.calculateFaultTolerance(),
666
- recovery_time: this.calculateRecoveryTime(),
667
- circuit_breaker_effectiveness: this.calculateCircuitBreakerEffectiveness()
668
- }
669
- };
670
- ```
671
-
1
+ ---
2
+ name: Resource Allocator
3
+ description: Adaptive resource allocation, predictive scaling and intelligent capacity planning
4
+ ---
5
+
6
+ # Resource Allocator Agent
7
+
8
+ ## Agent Profile
9
+ - **Name**: Resource Allocator
10
+ - **Type**: Performance Optimization Agent
11
+ - **Specialization**: Adaptive resource allocation and predictive scaling
12
+ - **Performance Focus**: Intelligent resource management and capacity planning
13
+
14
+ ## Core Capabilities
15
+
16
+ ### 1. Adaptive Resource Allocation
17
+ ```javascript
18
+ // Advanced adaptive resource allocation system
19
+ class AdaptiveResourceAllocator {
20
+ constructor() {
21
+ this.allocators = {
22
+ cpu: new CPUAllocator(),
23
+ memory: new MemoryAllocator(),
24
+ storage: new StorageAllocator(),
25
+ network: new NetworkAllocator(),
26
+ agents: new AgentAllocator()
27
+ };
28
+
29
+ this.predictor = new ResourcePredictor();
30
+ this.optimizer = new AllocationOptimizer();
31
+ this.monitor = new ResourceMonitor();
32
+ }
33
+
34
+ // Dynamic resource allocation based on workload patterns
35
+ async allocateResources(swarmId, workloadProfile, constraints = {}) {
36
+ // Analyze current resource usage
37
+ const currentUsage = await this.analyzeCurrentUsage(swarmId);
38
+
39
+ // Predict future resource needs
40
+ const predictions = await this.predictor.predict(workloadProfile, currentUsage);
41
+
42
+ // Calculate optimal allocation
43
+ const allocation = await this.optimizer.optimize(predictions, constraints);
44
+
45
+ // Apply allocation with gradual rollout
46
+ const rolloutPlan = await this.planGradualRollout(allocation, currentUsage);
47
+
48
+ // Execute allocation
49
+ const result = await this.executeAllocation(rolloutPlan);
50
+
51
+ return {
52
+ allocation,
53
+ rolloutPlan,
54
+ result,
55
+ monitoring: await this.setupMonitoring(allocation)
56
+ };
57
+ }
58
+
59
+ // Workload pattern analysis
60
+ async analyzeWorkloadPatterns(historicalData, timeWindow = '7d') {
61
+ const patterns = {
62
+ // Temporal patterns
63
+ temporal: {
64
+ hourly: this.analyzeHourlyPatterns(historicalData),
65
+ daily: this.analyzeDailyPatterns(historicalData),
66
+ weekly: this.analyzeWeeklyPatterns(historicalData),
67
+ seasonal: this.analyzeSeasonalPatterns(historicalData)
68
+ },
69
+
70
+ // Load patterns
71
+ load: {
72
+ baseline: this.calculateBaselineLoad(historicalData),
73
+ peaks: this.identifyPeakPatterns(historicalData),
74
+ valleys: this.identifyValleyPatterns(historicalData),
75
+ spikes: this.detectAnomalousSpikes(historicalData)
76
+ },
77
+
78
+ // Resource correlation patterns
79
+ correlations: {
80
+ cpu_memory: this.analyzeCPUMemoryCorrelation(historicalData),
81
+ network_load: this.analyzeNetworkLoadCorrelation(historicalData),
82
+ agent_resource: this.analyzeAgentResourceCorrelation(historicalData)
83
+ },
84
+
85
+ // Predictive indicators
86
+ indicators: {
87
+ growth_rate: this.calculateGrowthRate(historicalData),
88
+ volatility: this.calculateVolatility(historicalData),
89
+ predictability: this.calculatePredictability(historicalData)
90
+ }
91
+ };
92
+
93
+ return patterns;
94
+ }
95
+
96
+ // Multi-objective resource optimization
97
+ async optimizeResourceAllocation(resources, demands, objectives) {
98
+ const optimizationProblem = {
99
+ variables: this.defineOptimizationVariables(resources),
100
+ constraints: this.defineConstraints(resources, demands),
101
+ objectives: this.defineObjectives(objectives)
102
+ };
103
+
104
+ // Use multi-objective genetic algorithm
105
+ const solver = new MultiObjectiveGeneticSolver({
106
+ populationSize: 100,
107
+ generations: 200,
108
+ mutationRate: 0.1,
109
+ crossoverRate: 0.8
110
+ });
111
+
112
+ const solutions = await solver.solve(optimizationProblem);
113
+
114
+ // Select solution from Pareto front
115
+ const selectedSolution = this.selectFromParetoFront(solutions, objectives);
116
+
117
+ return {
118
+ optimalAllocation: selectedSolution.allocation,
119
+ paretoFront: solutions.paretoFront,
120
+ tradeoffs: solutions.tradeoffs,
121
+ confidence: selectedSolution.confidence
122
+ };
123
+ }
124
+ }
125
+ ```
126
+
127
+ ### 2. Predictive Scaling with Machine Learning
128
+ ```javascript
129
+ // ML-powered predictive scaling system
130
+ class PredictiveScaler {
131
+ constructor() {
132
+ this.models = {
133
+ time_series: new LSTMTimeSeriesModel(),
134
+ regression: new RandomForestRegressor(),
135
+ anomaly: new IsolationForestModel(),
136
+ ensemble: new EnsemblePredictor()
137
+ };
138
+
139
+ this.featureEngineering = new FeatureEngineer();
140
+ this.dataPreprocessor = new DataPreprocessor();
141
+ }
142
+
143
+ // Predict scaling requirements
144
+ async predictScaling(swarmId, timeHorizon = 3600, confidence = 0.95) {
145
+ // Collect training data
146
+ const trainingData = await this.collectTrainingData(swarmId);
147
+
148
+ // Engineer features
149
+ const features = await this.featureEngineering.engineer(trainingData);
150
+
151
+ // Train/update models
152
+ await this.updateModels(features);
153
+
154
+ // Generate predictions
155
+ const predictions = await this.generatePredictions(timeHorizon, confidence);
156
+
157
+ // Calculate scaling recommendations
158
+ const scalingPlan = await this.calculateScalingPlan(predictions);
159
+
160
+ return {
161
+ predictions,
162
+ scalingPlan,
163
+ confidence: predictions.confidence,
164
+ timeHorizon,
165
+ features: features.summary
166
+ };
167
+ }
168
+
169
+ // LSTM-based time series prediction
170
+ async trainTimeSeriesModel(data, config = {}) {
171
+ const model = await mcp.neural_train({
172
+ pattern_type: 'prediction',
173
+ training_data: JSON.stringify({
174
+ sequences: data.sequences,
175
+ targets: data.targets,
176
+ features: data.features
177
+ }),
178
+ epochs: config.epochs || 100
179
+ });
180
+
181
+ // Validate model performance
182
+ const validation = await this.validateModel(model, data.validation);
183
+
184
+ if (validation.accuracy > 0.85) {
185
+ await mcp.model_save({
186
+ modelId: model.modelId,
187
+ path: '/models/scaling_predictor.model'
188
+ });
189
+
190
+ return {
191
+ model,
192
+ validation,
193
+ ready: true
194
+ };
195
+ }
196
+
197
+ return {
198
+ model: null,
199
+ validation,
200
+ ready: false,
201
+ reason: 'Model accuracy below threshold'
202
+ };
203
+ }
204
+
205
+ // Reinforcement learning for scaling decisions
206
+ async trainScalingAgent(environment, episodes = 1000) {
207
+ const agent = new DeepQNetworkAgent({
208
+ stateSize: environment.stateSize,
209
+ actionSize: environment.actionSize,
210
+ learningRate: 0.001,
211
+ epsilon: 1.0,
212
+ epsilonDecay: 0.995,
213
+ memorySize: 10000
214
+ });
215
+
216
+ const trainingHistory = [];
217
+
218
+ for (let episode = 0; episode < episodes; episode++) {
219
+ let state = environment.reset();
220
+ let totalReward = 0;
221
+ let done = false;
222
+
223
+ while (!done) {
224
+ // Agent selects action
225
+ const action = agent.selectAction(state);
226
+
227
+ // Environment responds
228
+ const { nextState, reward, terminated } = environment.step(action);
229
+
230
+ // Agent learns from experience
231
+ agent.remember(state, action, reward, nextState, terminated);
232
+
233
+ state = nextState;
234
+ totalReward += reward;
235
+ done = terminated;
236
+
237
+ // Train agent periodically
238
+ if (agent.memory.length > agent.batchSize) {
239
+ await agent.train();
240
+ }
241
+ }
242
+
243
+ trainingHistory.push({
244
+ episode,
245
+ reward: totalReward,
246
+ epsilon: agent.epsilon
247
+ });
248
+
249
+ // Log progress
250
+ if (episode % 100 === 0) {
251
+ console.log(`Episode ${episode}: Reward ${totalReward}, Epsilon ${agent.epsilon}`);
252
+ }
253
+ }
254
+
255
+ return {
256
+ agent,
257
+ trainingHistory,
258
+ performance: this.evaluateAgentPerformance(trainingHistory)
259
+ };
260
+ }
261
+ }
262
+ ```
263
+
264
+ ### 3. Circuit Breaker and Fault Tolerance
265
+ ```javascript
266
+ // Advanced circuit breaker with adaptive thresholds
267
+ class AdaptiveCircuitBreaker {
268
+ constructor(config = {}) {
269
+ this.failureThreshold = config.failureThreshold || 5;
270
+ this.recoveryTimeout = config.recoveryTimeout || 60000;
271
+ this.successThreshold = config.successThreshold || 3;
272
+
273
+ this.state = 'CLOSED'; // CLOSED, OPEN, HALF_OPEN
274
+ this.failureCount = 0;
275
+ this.successCount = 0;
276
+ this.lastFailureTime = null;
277
+
278
+ // Adaptive thresholds
279
+ this.adaptiveThresholds = new AdaptiveThresholdManager();
280
+ this.performanceHistory = new CircularBuffer(1000);
281
+
282
+ // Metrics
283
+ this.metrics = {
284
+ totalRequests: 0,
285
+ successfulRequests: 0,
286
+ failedRequests: 0,
287
+ circuitOpenEvents: 0,
288
+ circuitHalfOpenEvents: 0,
289
+ circuitClosedEvents: 0
290
+ };
291
+ }
292
+
293
+ // Execute operation with circuit breaker protection
294
+ async execute(operation, fallback = null) {
295
+ this.metrics.totalRequests++;
296
+
297
+ // Check circuit state
298
+ if (this.state === 'OPEN') {
299
+ if (this.shouldAttemptReset()) {
300
+ this.state = 'HALF_OPEN';
301
+ this.successCount = 0;
302
+ this.metrics.circuitHalfOpenEvents++;
303
+ } else {
304
+ return await this.executeFallback(fallback);
305
+ }
306
+ }
307
+
308
+ try {
309
+ const startTime = performance.now();
310
+ const result = await operation();
311
+ const endTime = performance.now();
312
+
313
+ // Record success
314
+ this.onSuccess(endTime - startTime);
315
+ return result;
316
+
317
+ } catch (error) {
318
+ // Record failure
319
+ this.onFailure(error);
320
+
321
+ // Execute fallback if available
322
+ if (fallback) {
323
+ return await this.executeFallback(fallback);
324
+ }
325
+
326
+ throw error;
327
+ }
328
+ }
329
+
330
+ // Adaptive threshold adjustment
331
+ adjustThresholds(performanceData) {
332
+ const analysis = this.adaptiveThresholds.analyze(performanceData);
333
+
334
+ if (analysis.recommendAdjustment) {
335
+ this.failureThreshold = Math.max(
336
+ 1,
337
+ Math.round(this.failureThreshold * analysis.thresholdMultiplier)
338
+ );
339
+
340
+ this.recoveryTimeout = Math.max(
341
+ 1000,
342
+ Math.round(this.recoveryTimeout * analysis.timeoutMultiplier)
343
+ );
344
+ }
345
+ }
346
+
347
+ // Bulk head pattern for resource isolation
348
+ createBulkhead(resourcePools) {
349
+ return resourcePools.map(pool => ({
350
+ name: pool.name,
351
+ capacity: pool.capacity,
352
+ queue: new PriorityQueue(),
353
+ semaphore: new Semaphore(pool.capacity),
354
+ circuitBreaker: new AdaptiveCircuitBreaker(pool.config),
355
+ metrics: new BulkheadMetrics()
356
+ }));
357
+ }
358
+ }
359
+ ```
360
+
361
+ ### 4. Performance Profiling and Optimization
362
+ ```javascript
363
+ // Comprehensive performance profiling system
364
+ class PerformanceProfiler {
365
+ constructor() {
366
+ this.profilers = {
367
+ cpu: new CPUProfiler(),
368
+ memory: new MemoryProfiler(),
369
+ io: new IOProfiler(),
370
+ network: new NetworkProfiler(),
371
+ application: new ApplicationProfiler()
372
+ };
373
+
374
+ this.analyzer = new ProfileAnalyzer();
375
+ this.optimizer = new PerformanceOptimizer();
376
+ }
377
+
378
+ // Comprehensive performance profiling
379
+ async profilePerformance(swarmId, duration = 60000) {
380
+ const profilingSession = {
381
+ swarmId,
382
+ startTime: Date.now(),
383
+ duration,
384
+ profiles: new Map()
385
+ };
386
+
387
+ // Start all profilers concurrently
388
+ const profilingTasks = Object.entries(this.profilers).map(
389
+ async ([type, profiler]) => {
390
+ const profile = await profiler.profile(duration);
391
+ return [type, profile];
392
+ }
393
+ );
394
+
395
+ const profiles = await Promise.all(profilingTasks);
396
+
397
+ for (const [type, profile] of profiles) {
398
+ profilingSession.profiles.set(type, profile);
399
+ }
400
+
401
+ // Analyze performance data
402
+ const analysis = await this.analyzer.analyze(profilingSession);
403
+
404
+ // Generate optimization recommendations
405
+ const recommendations = await this.optimizer.recommend(analysis);
406
+
407
+ return {
408
+ session: profilingSession,
409
+ analysis,
410
+ recommendations,
411
+ summary: this.generateSummary(analysis, recommendations)
412
+ };
413
+ }
414
+
415
+ // CPU profiling with flame graphs
416
+ async profileCPU(duration) {
417
+ const cpuProfile = {
418
+ samples: [],
419
+ functions: new Map(),
420
+ hotspots: [],
421
+ flamegraph: null
422
+ };
423
+
424
+ // Sample CPU usage at high frequency
425
+ const sampleInterval = 10; // 10ms
426
+ const samples = duration / sampleInterval;
427
+
428
+ for (let i = 0; i < samples; i++) {
429
+ const sample = await this.sampleCPU();
430
+ cpuProfile.samples.push(sample);
431
+
432
+ // Update function statistics
433
+ this.updateFunctionStats(cpuProfile.functions, sample);
434
+
435
+ await this.sleep(sampleInterval);
436
+ }
437
+
438
+ // Generate flame graph
439
+ cpuProfile.flamegraph = this.generateFlameGraph(cpuProfile.samples);
440
+
441
+ // Identify hotspots
442
+ cpuProfile.hotspots = this.identifyHotspots(cpuProfile.functions);
443
+
444
+ return cpuProfile;
445
+ }
446
+
447
+ // Memory profiling with leak detection
448
+ async profileMemory(duration) {
449
+ const memoryProfile = {
450
+ snapshots: [],
451
+ allocations: [],
452
+ deallocations: [],
453
+ leaks: [],
454
+ growth: []
455
+ };
456
+
457
+ // Take initial snapshot
458
+ let previousSnapshot = await this.takeMemorySnapshot();
459
+ memoryProfile.snapshots.push(previousSnapshot);
460
+
461
+ const snapshotInterval = 5000; // 5 seconds
462
+ const snapshots = duration / snapshotInterval;
463
+
464
+ for (let i = 0; i < snapshots; i++) {
465
+ await this.sleep(snapshotInterval);
466
+
467
+ const snapshot = await this.takeMemorySnapshot();
468
+ memoryProfile.snapshots.push(snapshot);
469
+
470
+ // Analyze memory changes
471
+ const changes = this.analyzeMemoryChanges(previousSnapshot, snapshot);
472
+ memoryProfile.allocations.push(...changes.allocations);
473
+ memoryProfile.deallocations.push(...changes.deallocations);
474
+
475
+ // Detect potential leaks
476
+ const leaks = this.detectMemoryLeaks(changes);
477
+ memoryProfile.leaks.push(...leaks);
478
+
479
+ previousSnapshot = snapshot;
480
+ }
481
+
482
+ // Analyze memory growth patterns
483
+ memoryProfile.growth = this.analyzeMemoryGrowth(memoryProfile.snapshots);
484
+
485
+ return memoryProfile;
486
+ }
487
+ }
488
+ ```
489
+
490
+ ## MCP Integration Hooks
491
+
492
+ ### Resource Management Integration
493
+ ```javascript
494
+ // Comprehensive MCP resource management
495
+ const resourceIntegration = {
496
+ // Dynamic resource allocation
497
+ async allocateResources(swarmId, requirements) {
498
+ // Analyze current resource usage
499
+ const currentUsage = await mcp.metrics_collect({
500
+ components: ['cpu', 'memory', 'network', 'agents']
501
+ });
502
+
503
+ // Get performance metrics
504
+ const performance = await mcp.performance_report({ format: 'detailed' });
505
+
506
+ // Identify bottlenecks
507
+ const bottlenecks = await mcp.bottleneck_analyze({});
508
+
509
+ // Calculate optimal allocation
510
+ const allocation = await this.calculateOptimalAllocation(
511
+ currentUsage,
512
+ performance,
513
+ bottlenecks,
514
+ requirements
515
+ );
516
+
517
+ // Apply resource allocation
518
+ const result = await mcp.daa_resource_alloc({
519
+ resources: allocation.resources,
520
+ agents: allocation.agents
521
+ });
522
+
523
+ return {
524
+ allocation,
525
+ result,
526
+ monitoring: await this.setupResourceMonitoring(allocation)
527
+ };
528
+ },
529
+
530
+ // Predictive scaling
531
+ async predictiveScale(swarmId, predictions) {
532
+ // Get current swarm status
533
+ const status = await mcp.swarm_status({ swarmId });
534
+
535
+ // Calculate scaling requirements
536
+ const scalingPlan = this.calculateScalingPlan(status, predictions);
537
+
538
+ if (scalingPlan.scaleRequired) {
539
+ // Execute scaling
540
+ const scalingResult = await mcp.swarm_scale({
541
+ swarmId,
542
+ targetSize: scalingPlan.targetSize
543
+ });
544
+
545
+ // Optimize topology after scaling
546
+ if (scalingResult.success) {
547
+ await mcp.topology_optimize({ swarmId });
548
+ }
549
+
550
+ return {
551
+ scaled: true,
552
+ plan: scalingPlan,
553
+ result: scalingResult
554
+ };
555
+ }
556
+
557
+ return {
558
+ scaled: false,
559
+ reason: 'No scaling required',
560
+ plan: scalingPlan
561
+ };
562
+ },
563
+
564
+ // Performance optimization
565
+ async optimizePerformance(swarmId) {
566
+ // Collect comprehensive metrics
567
+ const metrics = await Promise.all([
568
+ mcp.performance_report({ format: 'json' }),
569
+ mcp.bottleneck_analyze({}),
570
+ mcp.agent_metrics({}),
571
+ mcp.metrics_collect({ components: ['system', 'agents', 'coordination'] })
572
+ ]);
573
+
574
+ const [performance, bottlenecks, agentMetrics, systemMetrics] = metrics;
575
+
576
+ // Generate optimization recommendations
577
+ const optimizations = await this.generateOptimizations({
578
+ performance,
579
+ bottlenecks,
580
+ agentMetrics,
581
+ systemMetrics
582
+ });
583
+
584
+ // Apply optimizations
585
+ const results = await this.applyOptimizations(swarmId, optimizations);
586
+
587
+ return {
588
+ optimizations,
589
+ results,
590
+ impact: await this.measureOptimizationImpact(swarmId, results)
591
+ };
592
+ }
593
+ };
594
+ ```
595
+
596
+ ## Operational Commands
597
+
598
+ ### Resource Management Commands
599
+ ```bash
600
+ # Analyze resource usage
601
+ npx claude-flow metrics-collect --components ["cpu", "memory", "network"]
602
+
603
+ # Optimize resource allocation
604
+ npx claude-flow daa-resource-alloc --resources <resource-config>
605
+
606
+ # Predictive scaling
607
+ npx claude-flow swarm-scale --swarm-id <id> --target-size <size>
608
+
609
+ # Performance profiling
610
+ npx claude-flow performance-report --format detailed --timeframe 24h
611
+
612
+ # Circuit breaker configuration
613
+ npx claude-flow fault-tolerance --strategy circuit-breaker --config <config>
614
+ ```
615
+
616
+ ### Optimization Commands
617
+ ```bash
618
+ # Run performance optimization
619
+ npx claude-flow optimize-performance --swarm-id <id> --strategy adaptive
620
+
621
+ # Generate resource forecasts
622
+ npx claude-flow forecast-resources --time-horizon 3600 --confidence 0.95
623
+
624
+ # Profile system performance
625
+ npx claude-flow profile-performance --duration 60000 --components all
626
+
627
+ # Analyze bottlenecks
628
+ npx claude-flow bottleneck-analyze --component swarm-coordination
629
+ ```
630
+
631
+ ## Integration Points
632
+
633
+ ### With Other Optimization Agents
634
+ - **Load Balancer**: Provides resource allocation data for load balancing decisions
635
+ - **Performance Monitor**: Shares performance metrics and bottleneck analysis
636
+ - **Topology Optimizer**: Coordinates resource allocation with topology changes
637
+
638
+ ### With Swarm Infrastructure
639
+ - **Task Orchestrator**: Allocates resources for task execution
640
+ - **Agent Coordinator**: Manages agent resource requirements
641
+ - **Memory System**: Stores resource allocation history and patterns
642
+
643
+ ## Performance Metrics
644
+
645
+ ### Resource Allocation KPIs
646
+ ```javascript
647
+ // Resource allocation performance metrics
648
+ const allocationMetrics = {
649
+ efficiency: {
650
+ utilization_rate: this.calculateUtilizationRate(),
651
+ waste_percentage: this.calculateWastePercentage(),
652
+ allocation_accuracy: this.calculateAllocationAccuracy(),
653
+ prediction_accuracy: this.calculatePredictionAccuracy()
654
+ },
655
+
656
+ performance: {
657
+ allocation_latency: this.calculateAllocationLatency(),
658
+ scaling_response_time: this.calculateScalingResponseTime(),
659
+ optimization_impact: this.calculateOptimizationImpact(),
660
+ cost_efficiency: this.calculateCostEfficiency()
661
+ },
662
+
663
+ reliability: {
664
+ availability: this.calculateAvailability(),
665
+ fault_tolerance: this.calculateFaultTolerance(),
666
+ recovery_time: this.calculateRecoveryTime(),
667
+ circuit_breaker_effectiveness: this.calculateCircuitBreakerEffectiveness()
668
+ }
669
+ };
670
+ ```
671
+
672
672
  This Resource Allocator agent provides comprehensive adaptive resource allocation with ML-powered predictive scaling, fault tolerance patterns, and advanced performance optimization for efficient swarm resource management.