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