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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (476) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  2. package/.claude/agents/analysis/code-analyzer.md +209 -209
  3. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  4. package/.claude/agents/architecture/arch-system-design.md +156 -156
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/browser/browser-agent.yaml +182 -182
  7. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  8. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  9. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  10. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  11. package/.claude/agents/consensus/quorum-manager.md +822 -822
  12. package/.claude/agents/consensus/raft-manager.md +62 -62
  13. package/.claude/agents/consensus/security-manager.md +621 -621
  14. package/.claude/agents/core/coder.md +452 -452
  15. package/.claude/agents/core/planner.md +374 -374
  16. package/.claude/agents/core/researcher.md +368 -368
  17. package/.claude/agents/core/reviewer.md +519 -519
  18. package/.claude/agents/core/tester.md +511 -511
  19. package/.claude/agents/custom/test-long-runner.md +44 -44
  20. package/.claude/agents/data/data-ml-model.md +444 -444
  21. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  22. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  23. package/.claude/agents/development/dev-backend-api.md +344 -344
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  25. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  26. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  27. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  28. package/.claude/agents/flow-nexus/app-store.md +87 -87
  29. package/.claude/agents/flow-nexus/authentication.md +68 -68
  30. package/.claude/agents/flow-nexus/challenges.md +80 -80
  31. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  32. package/.claude/agents/flow-nexus/payments.md +82 -82
  33. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  34. package/.claude/agents/flow-nexus/swarm.md +75 -75
  35. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  36. package/.claude/agents/flow-nexus/workflow.md +83 -83
  37. package/.claude/agents/github/code-review-swarm.md +377 -377
  38. package/.claude/agents/github/github-modes.md +172 -172
  39. package/.claude/agents/github/issue-tracker.md +575 -575
  40. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  41. package/.claude/agents/github/pr-manager.md +437 -437
  42. package/.claude/agents/github/project-board-sync.md +508 -508
  43. package/.claude/agents/github/release-manager.md +604 -604
  44. package/.claude/agents/github/release-swarm.md +582 -582
  45. package/.claude/agents/github/repo-architect.md +397 -397
  46. package/.claude/agents/github/swarm-issue.md +572 -572
  47. package/.claude/agents/github/swarm-pr.md +427 -427
  48. package/.claude/agents/github/sync-coordinator.md +451 -451
  49. package/.claude/agents/github/workflow-automation.md +902 -902
  50. package/.claude/agents/goal/agent.md +815 -815
  51. package/.claude/agents/goal/goal-planner.md +72 -72
  52. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  53. package/.claude/agents/optimization/load-balancer.md +430 -430
  54. package/.claude/agents/optimization/performance-monitor.md +671 -671
  55. package/.claude/agents/optimization/resource-allocator.md +673 -673
  56. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  57. package/.claude/agents/payments/agentic-payments.md +126 -126
  58. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  59. package/.claude/agents/sparc/architecture.md +698 -698
  60. package/.claude/agents/sparc/pseudocode.md +519 -519
  61. package/.claude/agents/sparc/refinement.md +801 -801
  62. package/.claude/agents/sparc/specification.md +477 -477
  63. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  64. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  65. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  66. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  67. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  68. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  69. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  70. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  71. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  72. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  73. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  74. package/.claude/agents/templates/base-template-generator.md +289 -289
  75. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  76. package/.claude/agents/templates/github-pr-manager.md +176 -176
  77. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  78. package/.claude/agents/templates/memory-coordinator.md +186 -186
  79. package/.claude/agents/templates/orchestrator-task.md +138 -138
  80. package/.claude/agents/templates/performance-analyzer.md +198 -198
  81. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  82. package/.claude/agents/testing/production-validator.md +394 -394
  83. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  84. package/.claude/agents/v3/adr-architect.md +184 -184
  85. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  86. package/.claude/agents/v3/claims-authorizer.md +208 -208
  87. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  88. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  89. package/.claude/agents/v3/injection-analyst.md +236 -236
  90. package/.claude/agents/v3/memory-specialist.md +995 -995
  91. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  92. package/.claude/agents/v3/pii-detector.md +151 -151
  93. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  94. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  95. package/.claude/agents/v3/security-architect.md +867 -867
  96. package/.claude/agents/v3/security-auditor.md +771 -771
  97. package/.claude/agents/v3/sparc-orchestrator.md +182 -182
  98. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  99. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  100. package/.claude/commands/agents/README.md +50 -50
  101. package/.claude/commands/agents/agent-capabilities.md +140 -140
  102. package/.claude/commands/agents/agent-coordination.md +28 -28
  103. package/.claude/commands/agents/agent-spawning.md +28 -28
  104. package/.claude/commands/agents/agent-types.md +216 -216
  105. package/.claude/commands/agents/health.md +139 -139
  106. package/.claude/commands/agents/list.md +100 -100
  107. package/.claude/commands/agents/logs.md +130 -130
  108. package/.claude/commands/agents/metrics.md +122 -122
  109. package/.claude/commands/agents/pool.md +127 -127
  110. package/.claude/commands/agents/spawn.md +140 -140
  111. package/.claude/commands/agents/status.md +115 -115
  112. package/.claude/commands/agents/stop.md +102 -102
  113. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  114. package/.claude/commands/analysis/README.md +9 -9
  115. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  116. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  117. package/.claude/commands/analysis/performance-report.md +25 -25
  118. package/.claude/commands/analysis/token-efficiency.md +44 -44
  119. package/.claude/commands/analysis/token-usage.md +25 -25
  120. package/.claude/commands/automation/README.md +9 -9
  121. package/.claude/commands/automation/auto-agent.md +122 -122
  122. package/.claude/commands/automation/self-healing.md +105 -105
  123. package/.claude/commands/automation/session-memory.md +89 -89
  124. package/.claude/commands/automation/smart-agents.md +72 -72
  125. package/.claude/commands/automation/smart-spawn.md +25 -25
  126. package/.claude/commands/automation/workflow-select.md +25 -25
  127. package/.claude/commands/claude-flow-help.md +103 -103
  128. package/.claude/commands/claude-flow-memory.md +107 -107
  129. package/.claude/commands/claude-flow-swarm.md +205 -205
  130. package/.claude/commands/coordination/README.md +9 -9
  131. package/.claude/commands/coordination/agent-spawn.md +25 -25
  132. package/.claude/commands/coordination/init.md +44 -44
  133. package/.claude/commands/coordination/orchestrate.md +43 -43
  134. package/.claude/commands/coordination/spawn.md +45 -45
  135. package/.claude/commands/coordination/swarm-init.md +85 -85
  136. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  137. package/.claude/commands/flow-nexus/app-store.md +123 -123
  138. package/.claude/commands/flow-nexus/challenges.md +119 -119
  139. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  140. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  141. package/.claude/commands/flow-nexus/payments.md +115 -115
  142. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  143. package/.claude/commands/flow-nexus/swarm.md +86 -86
  144. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  145. package/.claude/commands/flow-nexus/workflow.md +114 -114
  146. package/.claude/commands/github/README.md +11 -11
  147. package/.claude/commands/github/code-review-swarm.md +513 -513
  148. package/.claude/commands/github/code-review.md +25 -25
  149. package/.claude/commands/github/github-modes.md +146 -146
  150. package/.claude/commands/github/github-swarm.md +121 -121
  151. package/.claude/commands/github/issue-tracker.md +291 -291
  152. package/.claude/commands/github/issue-triage.md +25 -25
  153. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  154. package/.claude/commands/github/pr-enhance.md +26 -26
  155. package/.claude/commands/github/pr-manager.md +169 -169
  156. package/.claude/commands/github/project-board-sync.md +470 -470
  157. package/.claude/commands/github/release-manager.md +337 -337
  158. package/.claude/commands/github/release-swarm.md +543 -543
  159. package/.claude/commands/github/repo-analyze.md +25 -25
  160. package/.claude/commands/github/repo-architect.md +366 -366
  161. package/.claude/commands/github/swarm-issue.md +481 -481
  162. package/.claude/commands/github/swarm-pr.md +284 -284
  163. package/.claude/commands/github/sync-coordinator.md +300 -300
  164. package/.claude/commands/github/workflow-automation.md +441 -441
  165. package/.claude/commands/hive-mind/README.md +17 -17
  166. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  167. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  168. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  170. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  173. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  175. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  177. package/.claude/commands/hooks/README.md +11 -11
  178. package/.claude/commands/hooks/overview.md +57 -57
  179. package/.claude/commands/hooks/post-edit.md +117 -117
  180. package/.claude/commands/hooks/post-task.md +112 -112
  181. package/.claude/commands/hooks/pre-edit.md +113 -113
  182. package/.claude/commands/hooks/pre-task.md +111 -111
  183. package/.claude/commands/hooks/session-end.md +118 -118
  184. package/.claude/commands/hooks/setup.md +102 -102
  185. package/.claude/commands/memory/README.md +9 -9
  186. package/.claude/commands/memory/memory-persist.md +25 -25
  187. package/.claude/commands/memory/memory-search.md +25 -25
  188. package/.claude/commands/memory/memory-usage.md +25 -25
  189. package/.claude/commands/memory/neural.md +47 -47
  190. package/.claude/commands/monitoring/README.md +9 -9
  191. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  192. package/.claude/commands/monitoring/agents.md +44 -44
  193. package/.claude/commands/monitoring/real-time-view.md +25 -25
  194. package/.claude/commands/monitoring/status.md +46 -46
  195. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  196. package/.claude/commands/optimization/README.md +9 -9
  197. package/.claude/commands/optimization/auto-topology.md +61 -61
  198. package/.claude/commands/optimization/cache-manage.md +25 -25
  199. package/.claude/commands/optimization/parallel-execute.md +25 -25
  200. package/.claude/commands/optimization/parallel-execution.md +49 -49
  201. package/.claude/commands/optimization/topology-optimize.md +25 -25
  202. package/.claude/commands/pair/README.md +260 -260
  203. package/.claude/commands/pair/commands.md +545 -545
  204. package/.claude/commands/pair/config.md +509 -509
  205. package/.claude/commands/pair/examples.md +511 -511
  206. package/.claude/commands/pair/modes.md +347 -347
  207. package/.claude/commands/pair/session.md +406 -406
  208. package/.claude/commands/pair/start.md +208 -208
  209. package/.claude/commands/sparc/analyzer.md +51 -51
  210. package/.claude/commands/sparc/architect.md +53 -53
  211. package/.claude/commands/sparc/ask.md +97 -97
  212. package/.claude/commands/sparc/batch-executor.md +54 -54
  213. package/.claude/commands/sparc/code.md +89 -89
  214. package/.claude/commands/sparc/coder.md +54 -54
  215. package/.claude/commands/sparc/debug.md +83 -83
  216. package/.claude/commands/sparc/debugger.md +54 -54
  217. package/.claude/commands/sparc/designer.md +53 -53
  218. package/.claude/commands/sparc/devops.md +109 -109
  219. package/.claude/commands/sparc/docs-writer.md +80 -80
  220. package/.claude/commands/sparc/documenter.md +54 -54
  221. package/.claude/commands/sparc/innovator.md +54 -54
  222. package/.claude/commands/sparc/integration.md +83 -83
  223. package/.claude/commands/sparc/mcp.md +117 -117
  224. package/.claude/commands/sparc/memory-manager.md +54 -54
  225. package/.claude/commands/sparc/optimizer.md +54 -54
  226. package/.claude/commands/sparc/orchestrator.md +131 -131
  227. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  228. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  229. package/.claude/commands/sparc/researcher.md +54 -54
  230. package/.claude/commands/sparc/reviewer.md +54 -54
  231. package/.claude/commands/sparc/security-review.md +80 -80
  232. package/.claude/commands/sparc/sparc-modes.md +174 -174
  233. package/.claude/commands/sparc/sparc.md +111 -111
  234. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  235. package/.claude/commands/sparc/supabase-admin.md +348 -348
  236. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  237. package/.claude/commands/sparc/tdd.md +54 -54
  238. package/.claude/commands/sparc/tester.md +54 -54
  239. package/.claude/commands/sparc/tutorial.md +79 -79
  240. package/.claude/commands/sparc/workflow-manager.md +54 -54
  241. package/.claude/commands/sparc.md +166 -166
  242. package/.claude/commands/stream-chain/pipeline.md +120 -120
  243. package/.claude/commands/stream-chain/run.md +69 -69
  244. package/.claude/commands/swarm/README.md +15 -15
  245. package/.claude/commands/swarm/analysis.md +95 -95
  246. package/.claude/commands/swarm/development.md +96 -96
  247. package/.claude/commands/swarm/examples.md +168 -168
  248. package/.claude/commands/swarm/maintenance.md +102 -102
  249. package/.claude/commands/swarm/optimization.md +117 -117
  250. package/.claude/commands/swarm/research.md +136 -136
  251. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  252. package/.claude/commands/swarm/swarm-background.md +8 -8
  253. package/.claude/commands/swarm/swarm-init.md +19 -19
  254. package/.claude/commands/swarm/swarm-modes.md +8 -8
  255. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  256. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  257. package/.claude/commands/swarm/swarm-status.md +8 -8
  258. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  259. package/.claude/commands/swarm/swarm.md +87 -87
  260. package/.claude/commands/swarm/testing.md +131 -131
  261. package/.claude/commands/training/README.md +9 -9
  262. package/.claude/commands/training/model-update.md +25 -25
  263. package/.claude/commands/training/neural-patterns.md +107 -107
  264. package/.claude/commands/training/neural-train.md +75 -75
  265. package/.claude/commands/training/pattern-learn.md +25 -25
  266. package/.claude/commands/training/specialization.md +62 -62
  267. package/.claude/commands/truth/start.md +142 -142
  268. package/.claude/commands/verify/check.md +49 -49
  269. package/.claude/commands/verify/start.md +127 -127
  270. package/.claude/commands/workflows/README.md +9 -9
  271. package/.claude/commands/workflows/development.md +77 -77
  272. package/.claude/commands/workflows/research.md +62 -62
  273. package/.claude/commands/workflows/workflow-create.md +25 -25
  274. package/.claude/commands/workflows/workflow-execute.md +25 -25
  275. package/.claude/commands/workflows/workflow-export.md +25 -25
  276. package/.claude/helpers/README.md +96 -96
  277. package/.claude/helpers/adr-compliance.sh +186 -186
  278. package/.claude/helpers/auto-commit.sh +178 -178
  279. package/.claude/helpers/auto-memory-hook.mjs +368 -368
  280. package/.claude/helpers/checkpoint-manager.sh +251 -251
  281. package/.claude/helpers/daemon-manager.sh +252 -252
  282. package/.claude/helpers/ddd-tracker.sh +144 -144
  283. package/.claude/helpers/github-safe.js +121 -121
  284. package/.claude/helpers/github-setup.sh +28 -28
  285. package/.claude/helpers/guidance-hook.sh +13 -13
  286. package/.claude/helpers/guidance-hooks.sh +102 -102
  287. package/.claude/helpers/health-monitor.sh +108 -108
  288. package/.claude/helpers/hook-handler.cjs +278 -278
  289. package/.claude/helpers/intelligence.cjs +1031 -1031
  290. package/.claude/helpers/learning-hooks.sh +329 -329
  291. package/.claude/helpers/learning-optimizer.sh +127 -127
  292. package/.claude/helpers/learning-service.mjs +1144 -1144
  293. package/.claude/helpers/memory.js +83 -83
  294. package/.claude/helpers/metrics-db.mjs +488 -488
  295. package/.claude/helpers/pattern-consolidator.sh +86 -86
  296. package/.claude/helpers/perf-worker.sh +160 -160
  297. package/.claude/helpers/post-commit +16 -16
  298. package/.claude/helpers/pre-commit +26 -26
  299. package/.claude/helpers/quick-start.sh +19 -19
  300. package/.claude/helpers/router.js +66 -66
  301. package/.claude/helpers/security-scanner.sh +127 -127
  302. package/.claude/helpers/session.js +135 -135
  303. package/.claude/helpers/setup-mcp.sh +18 -18
  304. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  305. package/.claude/helpers/statusline-hook.sh +21 -21
  306. package/.claude/helpers/statusline.cjs +575 -575
  307. package/.claude/helpers/statusline.js +321 -321
  308. package/.claude/helpers/swarm-comms.sh +353 -353
  309. package/.claude/helpers/swarm-hooks.sh +761 -761
  310. package/.claude/helpers/swarm-monitor.sh +210 -210
  311. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  312. package/.claude/helpers/update-v3-progress.sh +165 -165
  313. package/.claude/helpers/v3-quick-status.sh +57 -57
  314. package/.claude/helpers/v3.sh +110 -110
  315. package/.claude/helpers/validate-v3-config.sh +215 -215
  316. package/.claude/helpers/worker-manager.sh +170 -170
  317. package/.claude/settings.json +182 -182
  318. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  319. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  320. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  321. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  322. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  323. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  324. package/.claude/skills/aidefence-scan.md +151 -151
  325. package/.claude/skills/aidefence.yaml +297 -297
  326. package/.claude/skills/browser/SKILL.md +204 -204
  327. package/.claude/skills/flow-nexus-neural/SKILL.md +738 -738
  328. package/.claude/skills/flow-nexus-platform/SKILL.md +1157 -1157
  329. package/.claude/skills/flow-nexus-swarm/SKILL.md +610 -610
  330. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  331. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  332. package/.claude/skills/github-project-management/SKILL.md +1290 -1277
  333. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  334. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  335. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  336. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  337. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  338. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  339. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  340. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  341. package/.claude/skills/secure-review.md +181 -181
  342. package/.claude/skills/skill-builder/SKILL.md +910 -910
  343. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  344. package/.claude/skills/stream-chain/SKILL.md +563 -563
  345. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  346. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  347. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  348. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  349. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  350. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  351. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  352. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  353. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  354. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  355. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  356. package/.claude/skills/verification-quality/SKILL.md +649 -649
  357. package/.claude/skills/worker-benchmarks/skill.md +135 -135
  358. package/.claude/skills/worker-integration/skill.md +154 -154
  359. package/README.md +393 -391
  360. package/bin/cli.js +220 -220
  361. package/bin/mcp-server.js +224 -224
  362. package/bin/preinstall.cjs +2 -2
  363. package/dist/src/commands/agent-wasm.js +2 -2
  364. package/dist/src/commands/agent-wasm.js.map +1 -1
  365. package/dist/src/commands/completions.js +409 -409
  366. package/dist/src/commands/daemon.d.ts.map +1 -1
  367. package/dist/src/commands/daemon.js +19 -3
  368. package/dist/src/commands/daemon.js.map +1 -1
  369. package/dist/src/commands/doctor.d.ts.map +1 -1
  370. package/dist/src/commands/doctor.js +105 -23
  371. package/dist/src/commands/doctor.js.map +1 -1
  372. package/dist/src/commands/embeddings.js +26 -26
  373. package/dist/src/commands/hive-mind.d.ts.map +1 -1
  374. package/dist/src/commands/hive-mind.js +122 -104
  375. package/dist/src/commands/hive-mind.js.map +1 -1
  376. package/dist/src/commands/hooks.d.ts.map +1 -1
  377. package/dist/src/commands/hooks.js +34 -21
  378. package/dist/src/commands/hooks.js.map +1 -1
  379. package/dist/src/commands/memory.d.ts.map +1 -1
  380. package/dist/src/commands/memory.js +68 -0
  381. package/dist/src/commands/memory.js.map +1 -1
  382. package/dist/src/commands/ruvector/backup.js +23 -23
  383. package/dist/src/commands/ruvector/benchmark.js +31 -31
  384. package/dist/src/commands/ruvector/import.js +14 -14
  385. package/dist/src/commands/ruvector/init.js +115 -115
  386. package/dist/src/commands/ruvector/migrate.js +99 -99
  387. package/dist/src/commands/ruvector/optimize.js +51 -51
  388. package/dist/src/commands/ruvector/setup.js +624 -624
  389. package/dist/src/commands/ruvector/status.js +38 -38
  390. package/dist/src/index.d.ts +5 -1
  391. package/dist/src/index.d.ts.map +1 -1
  392. package/dist/src/index.js +59 -18
  393. package/dist/src/index.js.map +1 -1
  394. package/dist/src/init/claudemd-generator.js +226 -226
  395. package/dist/src/init/executor.d.ts.map +1 -1
  396. package/dist/src/init/executor.js +511 -453
  397. package/dist/src/init/executor.js.map +1 -1
  398. package/dist/src/init/helpers-generator.js +645 -645
  399. package/dist/src/init/settings-generator.d.ts.map +1 -1
  400. package/dist/src/init/settings-generator.js +11 -5
  401. package/dist/src/init/settings-generator.js.map +1 -1
  402. package/dist/src/init/statusline-generator.js +858 -858
  403. package/dist/src/init/types.d.ts +7 -0
  404. package/dist/src/init/types.d.ts.map +1 -1
  405. package/dist/src/init/types.js.map +1 -1
  406. package/dist/src/mcp-tools/agentdb-tools.d.ts +3 -0
  407. package/dist/src/mcp-tools/agentdb-tools.d.ts.map +1 -1
  408. package/dist/src/mcp-tools/agentdb-tools.js +108 -0
  409. package/dist/src/mcp-tools/agentdb-tools.js.map +1 -1
  410. package/dist/src/mcp-tools/hooks-tools.d.ts.map +1 -1
  411. package/dist/src/mcp-tools/hooks-tools.js +4 -2
  412. package/dist/src/mcp-tools/hooks-tools.js.map +1 -1
  413. package/dist/src/mcp-tools/memory-tools.d.ts.map +1 -1
  414. package/dist/src/mcp-tools/memory-tools.js +19 -0
  415. package/dist/src/mcp-tools/memory-tools.js.map +1 -1
  416. package/dist/src/mcp-tools/neural-tools.d.ts.map +1 -1
  417. package/dist/src/mcp-tools/neural-tools.js +14 -1
  418. package/dist/src/mcp-tools/neural-tools.js.map +1 -1
  419. package/dist/src/mcp-tools/security-tools.d.ts.map +1 -1
  420. package/dist/src/mcp-tools/security-tools.js +28 -3
  421. package/dist/src/mcp-tools/security-tools.js.map +1 -1
  422. package/dist/src/mcp-tools/swarm-tools.d.ts.map +1 -1
  423. package/dist/src/mcp-tools/swarm-tools.js +72 -3
  424. package/dist/src/mcp-tools/swarm-tools.js.map +1 -1
  425. package/dist/src/mcp-tools/wasm-agent-tools.js +1 -1
  426. package/dist/src/mcp-tools/wasm-agent-tools.js.map +1 -1
  427. package/dist/src/memory/intelligence.d.ts.map +1 -1
  428. package/dist/src/memory/intelligence.js +28 -3
  429. package/dist/src/memory/intelligence.js.map +1 -1
  430. package/dist/src/memory/memory-bridge.d.ts +69 -0
  431. package/dist/src/memory/memory-bridge.d.ts.map +1 -1
  432. package/dist/src/memory/memory-bridge.js +319 -66
  433. package/dist/src/memory/memory-bridge.js.map +1 -1
  434. package/dist/src/memory/memory-initializer.d.ts +5 -0
  435. package/dist/src/memory/memory-initializer.d.ts.map +1 -1
  436. package/dist/src/memory/memory-initializer.js +369 -363
  437. package/dist/src/memory/memory-initializer.js.map +1 -1
  438. package/dist/src/memory/neural-package-bridge.d.ts +48 -0
  439. package/dist/src/memory/neural-package-bridge.d.ts.map +1 -0
  440. package/dist/src/memory/neural-package-bridge.js +87 -0
  441. package/dist/src/memory/neural-package-bridge.js.map +1 -0
  442. package/dist/src/memory/rabitq-index.js +5 -5
  443. package/dist/src/memory/sona-optimizer.d.ts.map +1 -1
  444. package/dist/src/memory/sona-optimizer.js +1 -0
  445. package/dist/src/memory/sona-optimizer.js.map +1 -1
  446. package/dist/src/parser.d.ts +9 -0
  447. package/dist/src/parser.d.ts.map +1 -1
  448. package/dist/src/parser.js +11 -0
  449. package/dist/src/parser.js.map +1 -1
  450. package/dist/src/runtime/headless.js +28 -28
  451. package/dist/src/ruvector/agent-wasm.d.ts.map +1 -1
  452. package/dist/src/ruvector/agent-wasm.js +4 -1
  453. package/dist/src/ruvector/agent-wasm.js.map +1 -1
  454. package/dist/src/ruvector/index.d.ts +0 -2
  455. package/dist/src/ruvector/index.d.ts.map +1 -1
  456. package/dist/src/ruvector/index.js +8 -2
  457. package/dist/src/ruvector/index.js.map +1 -1
  458. package/dist/src/ruvector/model-router.d.ts +22 -1
  459. package/dist/src/ruvector/model-router.d.ts.map +1 -1
  460. package/dist/src/ruvector/model-router.js +125 -5
  461. package/dist/src/ruvector/model-router.js.map +1 -1
  462. package/dist/src/services/headless-worker-executor.js +84 -84
  463. package/dist/src/transfer/deploy-seraphine.js +23 -23
  464. package/dist/tsconfig.tsbuildinfo +1 -1
  465. package/package.json +5 -4
  466. package/scripts/deploy-ipfs-node.sh +153 -153
  467. package/scripts/postinstall.cjs +153 -153
  468. package/scripts/publish-registry.ts +345 -345
  469. package/scripts/publish.sh +57 -57
  470. package/scripts/setup-ipfs-registry.md +366 -366
  471. package/dist/src/services/event-stream.d.ts.map +0 -1
  472. package/dist/src/services/event-stream.js.map +0 -1
  473. package/dist/src/services/loop-worker-runner.d.ts.map +0 -1
  474. package/dist/src/services/loop-worker-runner.js.map +0 -1
  475. package/dist/src/services/runtime-capabilities.d.ts.map +0 -1
  476. package/dist/src/services/runtime-capabilities.js.map +0 -1
@@ -1,823 +1,823 @@
1
- ---
2
- name: quorum-manager
3
- type: coordinator
4
- color: "#673AB7"
5
- description: Implements dynamic quorum adjustment and intelligent membership management
6
- capabilities:
7
- - dynamic_quorum_calculation
8
- - membership_management
9
- - network_monitoring
10
- - weighted_voting
11
- - fault_tolerance_optimization
12
- priority: high
13
- hooks:
14
- pre: |
15
- echo "🎯 Quorum Manager adjusting: $TASK"
16
- # Assess current network conditions
17
- if [[ "$TASK" == *"quorum"* ]]; then
18
- echo "📡 Analyzing network topology and node health"
19
- fi
20
- post: |
21
- echo "⚖️ Quorum adjustment complete"
22
- # Validate new quorum configuration
23
- echo "✅ Verifying fault tolerance and availability guarantees"
24
- ---
25
-
26
- # Quorum Manager
27
-
28
- Implements dynamic quorum adjustment and intelligent membership management for distributed consensus protocols.
29
-
30
- ## Core Responsibilities
31
-
32
- 1. **Dynamic Quorum Calculation**: Adapt quorum requirements based on real-time network conditions
33
- 2. **Membership Management**: Handle seamless node addition, removal, and failure scenarios
34
- 3. **Network Monitoring**: Assess connectivity, latency, and partition detection
35
- 4. **Weighted Voting**: Implement capability-based voting weight assignments
36
- 5. **Fault Tolerance Optimization**: Balance availability and consistency guarantees
37
-
38
- ## Technical Implementation
39
-
40
- ### Core Quorum Management System
41
- ```javascript
42
- class QuorumManager {
43
- constructor(nodeId, consensusProtocol) {
44
- this.nodeId = nodeId;
45
- this.protocol = consensusProtocol;
46
- this.currentQuorum = new Map(); // nodeId -> QuorumNode
47
- this.quorumHistory = [];
48
- this.networkMonitor = new NetworkConditionMonitor();
49
- this.membershipTracker = new MembershipTracker();
50
- this.faultToleranceCalculator = new FaultToleranceCalculator();
51
- this.adjustmentStrategies = new Map();
52
-
53
- this.initializeStrategies();
54
- }
55
-
56
- // Initialize quorum adjustment strategies
57
- initializeStrategies() {
58
- this.adjustmentStrategies.set('NETWORK_BASED', new NetworkBasedStrategy());
59
- this.adjustmentStrategies.set('PERFORMANCE_BASED', new PerformanceBasedStrategy());
60
- this.adjustmentStrategies.set('FAULT_TOLERANCE_BASED', new FaultToleranceStrategy());
61
- this.adjustmentStrategies.set('HYBRID', new HybridStrategy());
62
- }
63
-
64
- // Calculate optimal quorum size based on current conditions
65
- async calculateOptimalQuorum(context = {}) {
66
- const networkConditions = await this.networkMonitor.getCurrentConditions();
67
- const membershipStatus = await this.membershipTracker.getMembershipStatus();
68
- const performanceMetrics = context.performanceMetrics || await this.getPerformanceMetrics();
69
-
70
- const analysisInput = {
71
- networkConditions: networkConditions,
72
- membershipStatus: membershipStatus,
73
- performanceMetrics: performanceMetrics,
74
- currentQuorum: this.currentQuorum,
75
- protocol: this.protocol,
76
- faultToleranceRequirements: context.faultToleranceRequirements || this.getDefaultFaultTolerance()
77
- };
78
-
79
- // Apply multiple strategies and select optimal result
80
- const strategyResults = new Map();
81
-
82
- for (const [strategyName, strategy] of this.adjustmentStrategies) {
83
- try {
84
- const result = await strategy.calculateQuorum(analysisInput);
85
- strategyResults.set(strategyName, result);
86
- } catch (error) {
87
- console.warn(`Strategy ${strategyName} failed:`, error);
88
- }
89
- }
90
-
91
- // Select best strategy result
92
- const optimalResult = this.selectOptimalStrategy(strategyResults, analysisInput);
93
-
94
- return {
95
- recommendedQuorum: optimalResult.quorum,
96
- strategy: optimalResult.strategy,
97
- confidence: optimalResult.confidence,
98
- reasoning: optimalResult.reasoning,
99
- expectedImpact: optimalResult.expectedImpact
100
- };
101
- }
102
-
103
- // Apply quorum changes with validation and rollback capability
104
- async adjustQuorum(newQuorumConfig, options = {}) {
105
- const adjustmentId = `adjustment_${Date.now()}`;
106
-
107
- try {
108
- // Validate new quorum configuration
109
- await this.validateQuorumConfiguration(newQuorumConfig);
110
-
111
- // Create adjustment plan
112
- const adjustmentPlan = await this.createAdjustmentPlan(
113
- this.currentQuorum, newQuorumConfig
114
- );
115
-
116
- // Execute adjustment with monitoring
117
- const adjustmentResult = await this.executeQuorumAdjustment(
118
- adjustmentPlan, adjustmentId, options
119
- );
120
-
121
- // Verify adjustment success
122
- await this.verifyQuorumAdjustment(adjustmentResult);
123
-
124
- // Update current quorum
125
- this.currentQuorum = newQuorumConfig.quorum;
126
-
127
- // Record successful adjustment
128
- this.recordQuorumChange(adjustmentId, adjustmentResult);
129
-
130
- return {
131
- success: true,
132
- adjustmentId: adjustmentId,
133
- previousQuorum: adjustmentPlan.previousQuorum,
134
- newQuorum: this.currentQuorum,
135
- impact: adjustmentResult.impact
136
- };
137
-
138
- } catch (error) {
139
- console.error(`Quorum adjustment failed:`, error);
140
-
141
- // Attempt rollback
142
- await this.rollbackQuorumAdjustment(adjustmentId);
143
-
144
- throw error;
145
- }
146
- }
147
-
148
- async executeQuorumAdjustment(adjustmentPlan, adjustmentId, options) {
149
- const startTime = Date.now();
150
-
151
- // Phase 1: Prepare nodes for quorum change
152
- await this.prepareNodesForAdjustment(adjustmentPlan.affectedNodes);
153
-
154
- // Phase 2: Execute membership changes
155
- const membershipChanges = await this.executeMembershipChanges(
156
- adjustmentPlan.membershipChanges
157
- );
158
-
159
- // Phase 3: Update voting weights if needed
160
- if (adjustmentPlan.weightChanges.length > 0) {
161
- await this.updateVotingWeights(adjustmentPlan.weightChanges);
162
- }
163
-
164
- // Phase 4: Reconfigure consensus protocol
165
- await this.reconfigureConsensusProtocol(adjustmentPlan.protocolChanges);
166
-
167
- // Phase 5: Verify new quorum is operational
168
- const verificationResult = await this.verifyQuorumOperational(adjustmentPlan.newQuorum);
169
-
170
- const endTime = Date.now();
171
-
172
- return {
173
- adjustmentId: adjustmentId,
174
- duration: endTime - startTime,
175
- membershipChanges: membershipChanges,
176
- verificationResult: verificationResult,
177
- impact: await this.measureAdjustmentImpact(startTime, endTime)
178
- };
179
- }
180
- }
181
- ```
182
-
183
- ### Network-Based Quorum Strategy
184
- ```javascript
185
- class NetworkBasedStrategy {
186
- constructor() {
187
- this.networkAnalyzer = new NetworkAnalyzer();
188
- this.connectivityMatrix = new ConnectivityMatrix();
189
- this.partitionPredictor = new PartitionPredictor();
190
- }
191
-
192
- async calculateQuorum(analysisInput) {
193
- const { networkConditions, membershipStatus, currentQuorum } = analysisInput;
194
-
195
- // Analyze network topology and connectivity
196
- const topologyAnalysis = await this.analyzeNetworkTopology(membershipStatus.activeNodes);
197
-
198
- // Predict potential network partitions
199
- const partitionRisk = await this.assessPartitionRisk(networkConditions, topologyAnalysis);
200
-
201
- // Calculate minimum quorum for fault tolerance
202
- const minQuorum = this.calculateMinimumQuorum(
203
- membershipStatus.activeNodes.length,
204
- partitionRisk.maxPartitionSize
205
- );
206
-
207
- // Optimize for network conditions
208
- const optimizedQuorum = await this.optimizeForNetworkConditions(
209
- minQuorum,
210
- networkConditions,
211
- topologyAnalysis
212
- );
213
-
214
- return {
215
- quorum: optimizedQuorum,
216
- strategy: 'NETWORK_BASED',
217
- confidence: this.calculateConfidence(networkConditions, topologyAnalysis),
218
- reasoning: this.generateReasoning(optimizedQuorum, partitionRisk, networkConditions),
219
- expectedImpact: {
220
- availability: this.estimateAvailabilityImpact(optimizedQuorum),
221
- performance: this.estimatePerformanceImpact(optimizedQuorum, networkConditions)
222
- }
223
- };
224
- }
225
-
226
- async analyzeNetworkTopology(activeNodes) {
227
- const topology = {
228
- nodes: activeNodes.length,
229
- edges: 0,
230
- clusters: [],
231
- diameter: 0,
232
- connectivity: new Map()
233
- };
234
-
235
- // Build connectivity matrix
236
- for (const node of activeNodes) {
237
- const connections = await this.getNodeConnections(node);
238
- topology.connectivity.set(node.id, connections);
239
- topology.edges += connections.length;
240
- }
241
-
242
- // Identify network clusters
243
- topology.clusters = await this.identifyNetworkClusters(topology.connectivity);
244
-
245
- // Calculate network diameter
246
- topology.diameter = await this.calculateNetworkDiameter(topology.connectivity);
247
-
248
- return topology;
249
- }
250
-
251
- async assessPartitionRisk(networkConditions, topologyAnalysis) {
252
- const riskFactors = {
253
- connectivityReliability: this.assessConnectivityReliability(networkConditions),
254
- geographicDistribution: this.assessGeographicRisk(topologyAnalysis),
255
- networkLatency: this.assessLatencyRisk(networkConditions),
256
- historicalPartitions: await this.getHistoricalPartitionData()
257
- };
258
-
259
- // Calculate overall partition risk
260
- const overallRisk = this.calculateOverallPartitionRisk(riskFactors);
261
-
262
- // Estimate maximum partition size
263
- const maxPartitionSize = this.estimateMaxPartitionSize(
264
- topologyAnalysis,
265
- riskFactors
266
- );
267
-
268
- return {
269
- overallRisk: overallRisk,
270
- maxPartitionSize: maxPartitionSize,
271
- riskFactors: riskFactors,
272
- mitigationStrategies: this.suggestMitigationStrategies(riskFactors)
273
- };
274
- }
275
-
276
- calculateMinimumQuorum(totalNodes, maxPartitionSize) {
277
- // For Byzantine fault tolerance: need > 2/3 of total nodes
278
- const byzantineMinimum = Math.floor(2 * totalNodes / 3) + 1;
279
-
280
- // For network partition tolerance: need > 1/2 of largest connected component
281
- const partitionMinimum = Math.floor((totalNodes - maxPartitionSize) / 2) + 1;
282
-
283
- // Use the more restrictive requirement
284
- return Math.max(byzantineMinimum, partitionMinimum);
285
- }
286
-
287
- async optimizeForNetworkConditions(minQuorum, networkConditions, topologyAnalysis) {
288
- const optimization = {
289
- baseQuorum: minQuorum,
290
- nodes: new Map(),
291
- totalWeight: 0
292
- };
293
-
294
- // Select nodes for quorum based on network position and reliability
295
- const nodeScores = await this.scoreNodesForQuorum(networkConditions, topologyAnalysis);
296
-
297
- // Sort nodes by score (higher is better)
298
- const sortedNodes = Array.from(nodeScores.entries())
299
- .sort(([,scoreA], [,scoreB]) => scoreB - scoreA);
300
-
301
- // Select top nodes for quorum
302
- let selectedCount = 0;
303
- for (const [nodeId, score] of sortedNodes) {
304
- if (selectedCount < minQuorum) {
305
- const weight = this.calculateNodeWeight(nodeId, score, networkConditions);
306
- optimization.nodes.set(nodeId, {
307
- weight: weight,
308
- score: score,
309
- role: selectedCount === 0 ? 'primary' : 'secondary'
310
- });
311
- optimization.totalWeight += weight;
312
- selectedCount++;
313
- }
314
- }
315
-
316
- return optimization;
317
- }
318
-
319
- async scoreNodesForQuorum(networkConditions, topologyAnalysis) {
320
- const scores = new Map();
321
-
322
- for (const [nodeId, connections] of topologyAnalysis.connectivity) {
323
- let score = 0;
324
-
325
- // Connectivity score (more connections = higher score)
326
- score += (connections.length / topologyAnalysis.nodes) * 30;
327
-
328
- // Network position score (central nodes get higher scores)
329
- const centrality = this.calculateCentrality(nodeId, topologyAnalysis);
330
- score += centrality * 25;
331
-
332
- // Reliability score based on network conditions
333
- const reliability = await this.getNodeReliability(nodeId, networkConditions);
334
- score += reliability * 25;
335
-
336
- // Geographic diversity score
337
- const geoScore = await this.getGeographicDiversityScore(nodeId, topologyAnalysis);
338
- score += geoScore * 20;
339
-
340
- scores.set(nodeId, score);
341
- }
342
-
343
- return scores;
344
- }
345
-
346
- calculateNodeWeight(nodeId, score, networkConditions) {
347
- // Base weight of 1, adjusted by score and conditions
348
- let weight = 1.0;
349
-
350
- // Adjust based on normalized score (0-1)
351
- const normalizedScore = score / 100;
352
- weight *= (0.5 + normalizedScore);
353
-
354
- // Adjust based on network latency
355
- const nodeLatency = networkConditions.nodeLatencies.get(nodeId) || 100;
356
- const latencyFactor = Math.max(0.1, 1.0 - (nodeLatency / 1000)); // Lower latency = higher weight
357
- weight *= latencyFactor;
358
-
359
- // Ensure minimum weight
360
- return Math.max(0.1, Math.min(2.0, weight));
361
- }
362
- }
363
- ```
364
-
365
- ### Performance-Based Quorum Strategy
366
- ```javascript
367
- class PerformanceBasedStrategy {
368
- constructor() {
369
- this.performanceAnalyzer = new PerformanceAnalyzer();
370
- this.throughputOptimizer = new ThroughputOptimizer();
371
- this.latencyOptimizer = new LatencyOptimizer();
372
- }
373
-
374
- async calculateQuorum(analysisInput) {
375
- const { performanceMetrics, membershipStatus, protocol } = analysisInput;
376
-
377
- // Analyze current performance bottlenecks
378
- const bottlenecks = await this.identifyPerformanceBottlenecks(performanceMetrics);
379
-
380
- // Calculate throughput-optimal quorum size
381
- const throughputOptimal = await this.calculateThroughputOptimalQuorum(
382
- performanceMetrics, membershipStatus.activeNodes
383
- );
384
-
385
- // Calculate latency-optimal quorum size
386
- const latencyOptimal = await this.calculateLatencyOptimalQuorum(
387
- performanceMetrics, membershipStatus.activeNodes
388
- );
389
-
390
- // Balance throughput and latency requirements
391
- const balancedQuorum = await this.balanceThroughputAndLatency(
392
- throughputOptimal, latencyOptimal, performanceMetrics.requirements
393
- );
394
-
395
- return {
396
- quorum: balancedQuorum,
397
- strategy: 'PERFORMANCE_BASED',
398
- confidence: this.calculatePerformanceConfidence(performanceMetrics),
399
- reasoning: this.generatePerformanceReasoning(
400
- balancedQuorum, throughputOptimal, latencyOptimal, bottlenecks
401
- ),
402
- expectedImpact: {
403
- throughputImprovement: this.estimateThroughputImpact(balancedQuorum),
404
- latencyImprovement: this.estimateLatencyImpact(balancedQuorum)
405
- }
406
- };
407
- }
408
-
409
- async calculateThroughputOptimalQuorum(performanceMetrics, activeNodes) {
410
- const currentThroughput = performanceMetrics.throughput;
411
- const targetThroughput = performanceMetrics.requirements.targetThroughput;
412
-
413
- // Analyze relationship between quorum size and throughput
414
- const throughputCurve = await this.analyzeThroughputCurve(activeNodes);
415
-
416
- // Find quorum size that maximizes throughput while meeting requirements
417
- let optimalSize = Math.ceil(activeNodes.length / 2) + 1; // Minimum viable quorum
418
- let maxThroughput = 0;
419
-
420
- for (let size = optimalSize; size <= activeNodes.length; size++) {
421
- const projectedThroughput = this.projectThroughput(size, throughputCurve);
422
-
423
- if (projectedThroughput > maxThroughput && projectedThroughput >= targetThroughput) {
424
- maxThroughput = projectedThroughput;
425
- optimalSize = size;
426
- } else if (projectedThroughput < maxThroughput * 0.9) {
427
- // Stop if throughput starts decreasing significantly
428
- break;
429
- }
430
- }
431
-
432
- return await this.selectOptimalNodes(activeNodes, optimalSize, 'THROUGHPUT');
433
- }
434
-
435
- async calculateLatencyOptimalQuorum(performanceMetrics, activeNodes) {
436
- const currentLatency = performanceMetrics.latency;
437
- const targetLatency = performanceMetrics.requirements.maxLatency;
438
-
439
- // Analyze relationship between quorum size and latency
440
- const latencyCurve = await this.analyzeLatencyCurve(activeNodes);
441
-
442
- // Find minimum quorum size that meets latency requirements
443
- const minViableQuorum = Math.ceil(activeNodes.length / 2) + 1;
444
-
445
- for (let size = minViableQuorum; size <= activeNodes.length; size++) {
446
- const projectedLatency = this.projectLatency(size, latencyCurve);
447
-
448
- if (projectedLatency <= targetLatency) {
449
- return await this.selectOptimalNodes(activeNodes, size, 'LATENCY');
450
- }
451
- }
452
-
453
- // If no size meets requirements, return minimum viable with warning
454
- console.warn('No quorum size meets latency requirements');
455
- return await this.selectOptimalNodes(activeNodes, minViableQuorum, 'LATENCY');
456
- }
457
-
458
- async selectOptimalNodes(availableNodes, targetSize, optimizationTarget) {
459
- const nodeScores = new Map();
460
-
461
- // Score nodes based on optimization target
462
- for (const node of availableNodes) {
463
- let score = 0;
464
-
465
- if (optimizationTarget === 'THROUGHPUT') {
466
- score = await this.scoreThroughputCapability(node);
467
- } else if (optimizationTarget === 'LATENCY') {
468
- score = await this.scoreLatencyPerformance(node);
469
- }
470
-
471
- nodeScores.set(node.id, score);
472
- }
473
-
474
- // Select top-scoring nodes
475
- const sortedNodes = availableNodes.sort((a, b) =>
476
- nodeScores.get(b.id) - nodeScores.get(a.id)
477
- );
478
-
479
- const selectedNodes = new Map();
480
-
481
- for (let i = 0; i < Math.min(targetSize, sortedNodes.length); i++) {
482
- const node = sortedNodes[i];
483
- selectedNodes.set(node.id, {
484
- weight: this.calculatePerformanceWeight(node, nodeScores.get(node.id)),
485
- score: nodeScores.get(node.id),
486
- role: i === 0 ? 'primary' : 'secondary',
487
- optimizationTarget: optimizationTarget
488
- });
489
- }
490
-
491
- return {
492
- nodes: selectedNodes,
493
- totalWeight: Array.from(selectedNodes.values())
494
- .reduce((sum, node) => sum + node.weight, 0),
495
- optimizationTarget: optimizationTarget
496
- };
497
- }
498
-
499
- async scoreThroughputCapability(node) {
500
- let score = 0;
501
-
502
- // CPU capacity score
503
- const cpuCapacity = await this.getNodeCPUCapacity(node);
504
- score += (cpuCapacity / 100) * 30; // 30% weight for CPU
505
-
506
- // Network bandwidth score
507
- const bandwidth = await this.getNodeBandwidth(node);
508
- score += (bandwidth / 1000) * 25; // 25% weight for bandwidth (Mbps)
509
-
510
- // Memory capacity score
511
- const memory = await this.getNodeMemory(node);
512
- score += (memory / 8192) * 20; // 20% weight for memory (MB)
513
-
514
- // Historical throughput performance
515
- const historicalPerformance = await this.getHistoricalThroughput(node);
516
- score += (historicalPerformance / 1000) * 25; // 25% weight for historical performance
517
-
518
- return Math.min(100, score); // Normalize to 0-100
519
- }
520
-
521
- async scoreLatencyPerformance(node) {
522
- let score = 100; // Start with perfect score, subtract penalties
523
-
524
- // Network latency penalty
525
- const avgLatency = await this.getAverageNodeLatency(node);
526
- score -= (avgLatency / 10); // Subtract 1 point per 10ms latency
527
-
528
- // CPU load penalty
529
- const cpuLoad = await this.getNodeCPULoad(node);
530
- score -= (cpuLoad / 2); // Subtract 0.5 points per 1% CPU load
531
-
532
- // Geographic distance penalty (for distributed networks)
533
- const geoLatency = await this.getGeographicLatency(node);
534
- score -= (geoLatency / 20); // Subtract 1 point per 20ms geo latency
535
-
536
- // Consistency penalty (nodes with inconsistent performance)
537
- const consistencyScore = await this.getPerformanceConsistency(node);
538
- score *= consistencyScore; // Multiply by consistency factor (0-1)
539
-
540
- return Math.max(0, score);
541
- }
542
- }
543
- ```
544
-
545
- ### Fault Tolerance Strategy
546
- ```javascript
547
- class FaultToleranceStrategy {
548
- constructor() {
549
- this.faultAnalyzer = new FaultAnalyzer();
550
- this.reliabilityCalculator = new ReliabilityCalculator();
551
- this.redundancyOptimizer = new RedundancyOptimizer();
552
- }
553
-
554
- async calculateQuorum(analysisInput) {
555
- const { membershipStatus, faultToleranceRequirements, networkConditions } = analysisInput;
556
-
557
- // Analyze fault scenarios
558
- const faultScenarios = await this.analyzeFaultScenarios(
559
- membershipStatus.activeNodes, networkConditions
560
- );
561
-
562
- // Calculate minimum quorum for fault tolerance requirements
563
- const minQuorum = this.calculateFaultTolerantQuorum(
564
- faultScenarios, faultToleranceRequirements
565
- );
566
-
567
- // Optimize node selection for maximum fault tolerance
568
- const faultTolerantQuorum = await this.optimizeForFaultTolerance(
569
- membershipStatus.activeNodes, minQuorum, faultScenarios
570
- );
571
-
572
- return {
573
- quorum: faultTolerantQuorum,
574
- strategy: 'FAULT_TOLERANCE_BASED',
575
- confidence: this.calculateFaultConfidence(faultScenarios),
576
- reasoning: this.generateFaultToleranceReasoning(
577
- faultTolerantQuorum, faultScenarios, faultToleranceRequirements
578
- ),
579
- expectedImpact: {
580
- availability: this.estimateAvailabilityImprovement(faultTolerantQuorum),
581
- resilience: this.estimateResilienceImprovement(faultTolerantQuorum)
582
- }
583
- };
584
- }
585
-
586
- async analyzeFaultScenarios(activeNodes, networkConditions) {
587
- const scenarios = [];
588
-
589
- // Single node failure scenarios
590
- for (const node of activeNodes) {
591
- const scenario = await this.analyzeSingleNodeFailure(node, activeNodes, networkConditions);
592
- scenarios.push(scenario);
593
- }
594
-
595
- // Multiple node failure scenarios
596
- const multiFailureScenarios = await this.analyzeMultipleNodeFailures(
597
- activeNodes, networkConditions
598
- );
599
- scenarios.push(...multiFailureScenarios);
600
-
601
- // Network partition scenarios
602
- const partitionScenarios = await this.analyzeNetworkPartitionScenarios(
603
- activeNodes, networkConditions
604
- );
605
- scenarios.push(...partitionScenarios);
606
-
607
- // Correlated failure scenarios
608
- const correlatedFailureScenarios = await this.analyzeCorrelatedFailures(
609
- activeNodes, networkConditions
610
- );
611
- scenarios.push(...correlatedFailureScenarios);
612
-
613
- return this.prioritizeScenariosByLikelihood(scenarios);
614
- }
615
-
616
- calculateFaultTolerantQuorum(faultScenarios, requirements) {
617
- let maxRequiredQuorum = 0;
618
-
619
- for (const scenario of faultScenarios) {
620
- if (scenario.likelihood >= requirements.minLikelihoodToConsider) {
621
- const requiredQuorum = this.calculateQuorumForScenario(scenario, requirements);
622
- maxRequiredQuorum = Math.max(maxRequiredQuorum, requiredQuorum);
623
- }
624
- }
625
-
626
- return maxRequiredQuorum;
627
- }
628
-
629
- calculateQuorumForScenario(scenario, requirements) {
630
- const totalNodes = scenario.totalNodes;
631
- const failedNodes = scenario.failedNodes;
632
- const availableNodes = totalNodes - failedNodes;
633
-
634
- // For Byzantine fault tolerance
635
- if (requirements.byzantineFaultTolerance) {
636
- const maxByzantineNodes = Math.floor((totalNodes - 1) / 3);
637
- return Math.floor(2 * totalNodes / 3) + 1;
638
- }
639
-
640
- // For crash fault tolerance
641
- return Math.floor(availableNodes / 2) + 1;
642
- }
643
-
644
- async optimizeForFaultTolerance(activeNodes, minQuorum, faultScenarios) {
645
- const optimizedQuorum = {
646
- nodes: new Map(),
647
- totalWeight: 0,
648
- faultTolerance: {
649
- singleNodeFailures: 0,
650
- multipleNodeFailures: 0,
651
- networkPartitions: 0
652
- }
653
- };
654
-
655
- // Score nodes based on fault tolerance contribution
656
- const nodeScores = await this.scoreFaultToleranceContribution(
657
- activeNodes, faultScenarios
658
- );
659
-
660
- // Select nodes to maximize fault tolerance coverage
661
- const selectedNodes = this.selectFaultTolerantNodes(
662
- activeNodes, minQuorum, nodeScores, faultScenarios
663
- );
664
-
665
- for (const [nodeId, nodeData] of selectedNodes) {
666
- optimizedQuorum.nodes.set(nodeId, {
667
- weight: nodeData.weight,
668
- score: nodeData.score,
669
- role: nodeData.role,
670
- faultToleranceContribution: nodeData.faultToleranceContribution
671
- });
672
- optimizedQuorum.totalWeight += nodeData.weight;
673
- }
674
-
675
- // Calculate fault tolerance metrics for selected quorum
676
- optimizedQuorum.faultTolerance = await this.calculateFaultToleranceMetrics(
677
- selectedNodes, faultScenarios
678
- );
679
-
680
- return optimizedQuorum;
681
- }
682
-
683
- async scoreFaultToleranceContribution(activeNodes, faultScenarios) {
684
- const scores = new Map();
685
-
686
- for (const node of activeNodes) {
687
- let score = 0;
688
-
689
- // Independence score (nodes in different failure domains get higher scores)
690
- const independenceScore = await this.calculateIndependenceScore(node, activeNodes);
691
- score += independenceScore * 40;
692
-
693
- // Reliability score (historical uptime and performance)
694
- const reliabilityScore = await this.calculateReliabilityScore(node);
695
- score += reliabilityScore * 30;
696
-
697
- // Geographic diversity score
698
- const diversityScore = await this.calculateDiversityScore(node, activeNodes);
699
- score += diversityScore * 20;
700
-
701
- // Recovery capability score
702
- const recoveryScore = await this.calculateRecoveryScore(node);
703
- score += recoveryScore * 10;
704
-
705
- scores.set(node.id, score);
706
- }
707
-
708
- return scores;
709
- }
710
-
711
- selectFaultTolerantNodes(activeNodes, minQuorum, nodeScores, faultScenarios) {
712
- const selectedNodes = new Map();
713
- const remainingNodes = [...activeNodes];
714
-
715
- // Greedy selection to maximize fault tolerance coverage
716
- while (selectedNodes.size < minQuorum && remainingNodes.length > 0) {
717
- let bestNode = null;
718
- let bestScore = -1;
719
- let bestIndex = -1;
720
-
721
- for (let i = 0; i < remainingNodes.length; i++) {
722
- const node = remainingNodes[i];
723
- const additionalCoverage = this.calculateAdditionalFaultCoverage(
724
- node, selectedNodes, faultScenarios
725
- );
726
-
727
- const combinedScore = nodeScores.get(node.id) + (additionalCoverage * 50);
728
-
729
- if (combinedScore > bestScore) {
730
- bestScore = combinedScore;
731
- bestNode = node;
732
- bestIndex = i;
733
- }
734
- }
735
-
736
- if (bestNode) {
737
- selectedNodes.set(bestNode.id, {
738
- weight: this.calculateFaultToleranceWeight(bestNode, nodeScores.get(bestNode.id)),
739
- score: nodeScores.get(bestNode.id),
740
- role: selectedNodes.size === 0 ? 'primary' : 'secondary',
741
- faultToleranceContribution: this.calculateFaultToleranceContribution(bestNode)
742
- });
743
-
744
- remainingNodes.splice(bestIndex, 1);
745
- } else {
746
- break; // No more beneficial nodes
747
- }
748
- }
749
-
750
- return selectedNodes;
751
- }
752
- }
753
- ```
754
-
755
- ## MCP Integration Hooks
756
-
757
- ### Quorum State Management
758
- ```javascript
759
- // Store quorum configuration and history
760
- await this.mcpTools.memory_usage({
761
- action: 'store',
762
- key: `quorum_config_${this.nodeId}`,
763
- value: JSON.stringify({
764
- currentQuorum: Array.from(this.currentQuorum.entries()),
765
- strategy: this.activeStrategy,
766
- networkConditions: this.lastNetworkAnalysis,
767
- adjustmentHistory: this.quorumHistory.slice(-10)
768
- }),
769
- namespace: 'quorum_management',
770
- ttl: 3600000 // 1 hour
771
- });
772
-
773
- // Coordinate with swarm for membership changes
774
- const swarmStatus = await this.mcpTools.swarm_status({
775
- swarmId: this.swarmId
776
- });
777
-
778
- await this.mcpTools.coordination_sync({
779
- swarmId: this.swarmId
780
- });
781
- ```
782
-
783
- ### Performance Monitoring Integration
784
- ```javascript
785
- // Track quorum adjustment performance
786
- await this.mcpTools.metrics_collect({
787
- components: [
788
- 'quorum_adjustment_latency',
789
- 'consensus_availability',
790
- 'fault_tolerance_coverage',
791
- 'network_partition_recovery_time'
792
- ]
793
- });
794
-
795
- // Neural learning for quorum optimization
796
- await this.mcpTools.neural_patterns({
797
- action: 'learn',
798
- operation: 'quorum_optimization',
799
- outcome: JSON.stringify({
800
- adjustmentType: adjustment.strategy,
801
- performanceImpact: measurementResults,
802
- networkConditions: currentNetworkState,
803
- faultToleranceImprovement: faultToleranceMetrics
804
- })
805
- });
806
- ```
807
-
808
- ### Task Orchestration for Quorum Changes
809
- ```javascript
810
- // Orchestrate complex quorum adjustments
811
- await this.mcpTools.task_orchestrate({
812
- task: 'quorum_adjustment',
813
- strategy: 'sequential',
814
- priority: 'high',
815
- dependencies: [
816
- 'network_analysis',
817
- 'membership_validation',
818
- 'performance_assessment'
819
- ]
820
- });
821
- ```
822
-
1
+ ---
2
+ name: quorum-manager
3
+ type: coordinator
4
+ color: "#673AB7"
5
+ description: Implements dynamic quorum adjustment and intelligent membership management
6
+ capabilities:
7
+ - dynamic_quorum_calculation
8
+ - membership_management
9
+ - network_monitoring
10
+ - weighted_voting
11
+ - fault_tolerance_optimization
12
+ priority: high
13
+ hooks:
14
+ pre: |
15
+ echo "🎯 Quorum Manager adjusting: $TASK"
16
+ # Assess current network conditions
17
+ if [[ "$TASK" == *"quorum"* ]]; then
18
+ echo "📡 Analyzing network topology and node health"
19
+ fi
20
+ post: |
21
+ echo "⚖️ Quorum adjustment complete"
22
+ # Validate new quorum configuration
23
+ echo "✅ Verifying fault tolerance and availability guarantees"
24
+ ---
25
+
26
+ # Quorum Manager
27
+
28
+ Implements dynamic quorum adjustment and intelligent membership management for distributed consensus protocols.
29
+
30
+ ## Core Responsibilities
31
+
32
+ 1. **Dynamic Quorum Calculation**: Adapt quorum requirements based on real-time network conditions
33
+ 2. **Membership Management**: Handle seamless node addition, removal, and failure scenarios
34
+ 3. **Network Monitoring**: Assess connectivity, latency, and partition detection
35
+ 4. **Weighted Voting**: Implement capability-based voting weight assignments
36
+ 5. **Fault Tolerance Optimization**: Balance availability and consistency guarantees
37
+
38
+ ## Technical Implementation
39
+
40
+ ### Core Quorum Management System
41
+ ```javascript
42
+ class QuorumManager {
43
+ constructor(nodeId, consensusProtocol) {
44
+ this.nodeId = nodeId;
45
+ this.protocol = consensusProtocol;
46
+ this.currentQuorum = new Map(); // nodeId -> QuorumNode
47
+ this.quorumHistory = [];
48
+ this.networkMonitor = new NetworkConditionMonitor();
49
+ this.membershipTracker = new MembershipTracker();
50
+ this.faultToleranceCalculator = new FaultToleranceCalculator();
51
+ this.adjustmentStrategies = new Map();
52
+
53
+ this.initializeStrategies();
54
+ }
55
+
56
+ // Initialize quorum adjustment strategies
57
+ initializeStrategies() {
58
+ this.adjustmentStrategies.set('NETWORK_BASED', new NetworkBasedStrategy());
59
+ this.adjustmentStrategies.set('PERFORMANCE_BASED', new PerformanceBasedStrategy());
60
+ this.adjustmentStrategies.set('FAULT_TOLERANCE_BASED', new FaultToleranceStrategy());
61
+ this.adjustmentStrategies.set('HYBRID', new HybridStrategy());
62
+ }
63
+
64
+ // Calculate optimal quorum size based on current conditions
65
+ async calculateOptimalQuorum(context = {}) {
66
+ const networkConditions = await this.networkMonitor.getCurrentConditions();
67
+ const membershipStatus = await this.membershipTracker.getMembershipStatus();
68
+ const performanceMetrics = context.performanceMetrics || await this.getPerformanceMetrics();
69
+
70
+ const analysisInput = {
71
+ networkConditions: networkConditions,
72
+ membershipStatus: membershipStatus,
73
+ performanceMetrics: performanceMetrics,
74
+ currentQuorum: this.currentQuorum,
75
+ protocol: this.protocol,
76
+ faultToleranceRequirements: context.faultToleranceRequirements || this.getDefaultFaultTolerance()
77
+ };
78
+
79
+ // Apply multiple strategies and select optimal result
80
+ const strategyResults = new Map();
81
+
82
+ for (const [strategyName, strategy] of this.adjustmentStrategies) {
83
+ try {
84
+ const result = await strategy.calculateQuorum(analysisInput);
85
+ strategyResults.set(strategyName, result);
86
+ } catch (error) {
87
+ console.warn(`Strategy ${strategyName} failed:`, error);
88
+ }
89
+ }
90
+
91
+ // Select best strategy result
92
+ const optimalResult = this.selectOptimalStrategy(strategyResults, analysisInput);
93
+
94
+ return {
95
+ recommendedQuorum: optimalResult.quorum,
96
+ strategy: optimalResult.strategy,
97
+ confidence: optimalResult.confidence,
98
+ reasoning: optimalResult.reasoning,
99
+ expectedImpact: optimalResult.expectedImpact
100
+ };
101
+ }
102
+
103
+ // Apply quorum changes with validation and rollback capability
104
+ async adjustQuorum(newQuorumConfig, options = {}) {
105
+ const adjustmentId = `adjustment_${Date.now()}`;
106
+
107
+ try {
108
+ // Validate new quorum configuration
109
+ await this.validateQuorumConfiguration(newQuorumConfig);
110
+
111
+ // Create adjustment plan
112
+ const adjustmentPlan = await this.createAdjustmentPlan(
113
+ this.currentQuorum, newQuorumConfig
114
+ );
115
+
116
+ // Execute adjustment with monitoring
117
+ const adjustmentResult = await this.executeQuorumAdjustment(
118
+ adjustmentPlan, adjustmentId, options
119
+ );
120
+
121
+ // Verify adjustment success
122
+ await this.verifyQuorumAdjustment(adjustmentResult);
123
+
124
+ // Update current quorum
125
+ this.currentQuorum = newQuorumConfig.quorum;
126
+
127
+ // Record successful adjustment
128
+ this.recordQuorumChange(adjustmentId, adjustmentResult);
129
+
130
+ return {
131
+ success: true,
132
+ adjustmentId: adjustmentId,
133
+ previousQuorum: adjustmentPlan.previousQuorum,
134
+ newQuorum: this.currentQuorum,
135
+ impact: adjustmentResult.impact
136
+ };
137
+
138
+ } catch (error) {
139
+ console.error(`Quorum adjustment failed:`, error);
140
+
141
+ // Attempt rollback
142
+ await this.rollbackQuorumAdjustment(adjustmentId);
143
+
144
+ throw error;
145
+ }
146
+ }
147
+
148
+ async executeQuorumAdjustment(adjustmentPlan, adjustmentId, options) {
149
+ const startTime = Date.now();
150
+
151
+ // Phase 1: Prepare nodes for quorum change
152
+ await this.prepareNodesForAdjustment(adjustmentPlan.affectedNodes);
153
+
154
+ // Phase 2: Execute membership changes
155
+ const membershipChanges = await this.executeMembershipChanges(
156
+ adjustmentPlan.membershipChanges
157
+ );
158
+
159
+ // Phase 3: Update voting weights if needed
160
+ if (adjustmentPlan.weightChanges.length > 0) {
161
+ await this.updateVotingWeights(adjustmentPlan.weightChanges);
162
+ }
163
+
164
+ // Phase 4: Reconfigure consensus protocol
165
+ await this.reconfigureConsensusProtocol(adjustmentPlan.protocolChanges);
166
+
167
+ // Phase 5: Verify new quorum is operational
168
+ const verificationResult = await this.verifyQuorumOperational(adjustmentPlan.newQuorum);
169
+
170
+ const endTime = Date.now();
171
+
172
+ return {
173
+ adjustmentId: adjustmentId,
174
+ duration: endTime - startTime,
175
+ membershipChanges: membershipChanges,
176
+ verificationResult: verificationResult,
177
+ impact: await this.measureAdjustmentImpact(startTime, endTime)
178
+ };
179
+ }
180
+ }
181
+ ```
182
+
183
+ ### Network-Based Quorum Strategy
184
+ ```javascript
185
+ class NetworkBasedStrategy {
186
+ constructor() {
187
+ this.networkAnalyzer = new NetworkAnalyzer();
188
+ this.connectivityMatrix = new ConnectivityMatrix();
189
+ this.partitionPredictor = new PartitionPredictor();
190
+ }
191
+
192
+ async calculateQuorum(analysisInput) {
193
+ const { networkConditions, membershipStatus, currentQuorum } = analysisInput;
194
+
195
+ // Analyze network topology and connectivity
196
+ const topologyAnalysis = await this.analyzeNetworkTopology(membershipStatus.activeNodes);
197
+
198
+ // Predict potential network partitions
199
+ const partitionRisk = await this.assessPartitionRisk(networkConditions, topologyAnalysis);
200
+
201
+ // Calculate minimum quorum for fault tolerance
202
+ const minQuorum = this.calculateMinimumQuorum(
203
+ membershipStatus.activeNodes.length,
204
+ partitionRisk.maxPartitionSize
205
+ );
206
+
207
+ // Optimize for network conditions
208
+ const optimizedQuorum = await this.optimizeForNetworkConditions(
209
+ minQuorum,
210
+ networkConditions,
211
+ topologyAnalysis
212
+ );
213
+
214
+ return {
215
+ quorum: optimizedQuorum,
216
+ strategy: 'NETWORK_BASED',
217
+ confidence: this.calculateConfidence(networkConditions, topologyAnalysis),
218
+ reasoning: this.generateReasoning(optimizedQuorum, partitionRisk, networkConditions),
219
+ expectedImpact: {
220
+ availability: this.estimateAvailabilityImpact(optimizedQuorum),
221
+ performance: this.estimatePerformanceImpact(optimizedQuorum, networkConditions)
222
+ }
223
+ };
224
+ }
225
+
226
+ async analyzeNetworkTopology(activeNodes) {
227
+ const topology = {
228
+ nodes: activeNodes.length,
229
+ edges: 0,
230
+ clusters: [],
231
+ diameter: 0,
232
+ connectivity: new Map()
233
+ };
234
+
235
+ // Build connectivity matrix
236
+ for (const node of activeNodes) {
237
+ const connections = await this.getNodeConnections(node);
238
+ topology.connectivity.set(node.id, connections);
239
+ topology.edges += connections.length;
240
+ }
241
+
242
+ // Identify network clusters
243
+ topology.clusters = await this.identifyNetworkClusters(topology.connectivity);
244
+
245
+ // Calculate network diameter
246
+ topology.diameter = await this.calculateNetworkDiameter(topology.connectivity);
247
+
248
+ return topology;
249
+ }
250
+
251
+ async assessPartitionRisk(networkConditions, topologyAnalysis) {
252
+ const riskFactors = {
253
+ connectivityReliability: this.assessConnectivityReliability(networkConditions),
254
+ geographicDistribution: this.assessGeographicRisk(topologyAnalysis),
255
+ networkLatency: this.assessLatencyRisk(networkConditions),
256
+ historicalPartitions: await this.getHistoricalPartitionData()
257
+ };
258
+
259
+ // Calculate overall partition risk
260
+ const overallRisk = this.calculateOverallPartitionRisk(riskFactors);
261
+
262
+ // Estimate maximum partition size
263
+ const maxPartitionSize = this.estimateMaxPartitionSize(
264
+ topologyAnalysis,
265
+ riskFactors
266
+ );
267
+
268
+ return {
269
+ overallRisk: overallRisk,
270
+ maxPartitionSize: maxPartitionSize,
271
+ riskFactors: riskFactors,
272
+ mitigationStrategies: this.suggestMitigationStrategies(riskFactors)
273
+ };
274
+ }
275
+
276
+ calculateMinimumQuorum(totalNodes, maxPartitionSize) {
277
+ // For Byzantine fault tolerance: need > 2/3 of total nodes
278
+ const byzantineMinimum = Math.floor(2 * totalNodes / 3) + 1;
279
+
280
+ // For network partition tolerance: need > 1/2 of largest connected component
281
+ const partitionMinimum = Math.floor((totalNodes - maxPartitionSize) / 2) + 1;
282
+
283
+ // Use the more restrictive requirement
284
+ return Math.max(byzantineMinimum, partitionMinimum);
285
+ }
286
+
287
+ async optimizeForNetworkConditions(minQuorum, networkConditions, topologyAnalysis) {
288
+ const optimization = {
289
+ baseQuorum: minQuorum,
290
+ nodes: new Map(),
291
+ totalWeight: 0
292
+ };
293
+
294
+ // Select nodes for quorum based on network position and reliability
295
+ const nodeScores = await this.scoreNodesForQuorum(networkConditions, topologyAnalysis);
296
+
297
+ // Sort nodes by score (higher is better)
298
+ const sortedNodes = Array.from(nodeScores.entries())
299
+ .sort(([,scoreA], [,scoreB]) => scoreB - scoreA);
300
+
301
+ // Select top nodes for quorum
302
+ let selectedCount = 0;
303
+ for (const [nodeId, score] of sortedNodes) {
304
+ if (selectedCount < minQuorum) {
305
+ const weight = this.calculateNodeWeight(nodeId, score, networkConditions);
306
+ optimization.nodes.set(nodeId, {
307
+ weight: weight,
308
+ score: score,
309
+ role: selectedCount === 0 ? 'primary' : 'secondary'
310
+ });
311
+ optimization.totalWeight += weight;
312
+ selectedCount++;
313
+ }
314
+ }
315
+
316
+ return optimization;
317
+ }
318
+
319
+ async scoreNodesForQuorum(networkConditions, topologyAnalysis) {
320
+ const scores = new Map();
321
+
322
+ for (const [nodeId, connections] of topologyAnalysis.connectivity) {
323
+ let score = 0;
324
+
325
+ // Connectivity score (more connections = higher score)
326
+ score += (connections.length / topologyAnalysis.nodes) * 30;
327
+
328
+ // Network position score (central nodes get higher scores)
329
+ const centrality = this.calculateCentrality(nodeId, topologyAnalysis);
330
+ score += centrality * 25;
331
+
332
+ // Reliability score based on network conditions
333
+ const reliability = await this.getNodeReliability(nodeId, networkConditions);
334
+ score += reliability * 25;
335
+
336
+ // Geographic diversity score
337
+ const geoScore = await this.getGeographicDiversityScore(nodeId, topologyAnalysis);
338
+ score += geoScore * 20;
339
+
340
+ scores.set(nodeId, score);
341
+ }
342
+
343
+ return scores;
344
+ }
345
+
346
+ calculateNodeWeight(nodeId, score, networkConditions) {
347
+ // Base weight of 1, adjusted by score and conditions
348
+ let weight = 1.0;
349
+
350
+ // Adjust based on normalized score (0-1)
351
+ const normalizedScore = score / 100;
352
+ weight *= (0.5 + normalizedScore);
353
+
354
+ // Adjust based on network latency
355
+ const nodeLatency = networkConditions.nodeLatencies.get(nodeId) || 100;
356
+ const latencyFactor = Math.max(0.1, 1.0 - (nodeLatency / 1000)); // Lower latency = higher weight
357
+ weight *= latencyFactor;
358
+
359
+ // Ensure minimum weight
360
+ return Math.max(0.1, Math.min(2.0, weight));
361
+ }
362
+ }
363
+ ```
364
+
365
+ ### Performance-Based Quorum Strategy
366
+ ```javascript
367
+ class PerformanceBasedStrategy {
368
+ constructor() {
369
+ this.performanceAnalyzer = new PerformanceAnalyzer();
370
+ this.throughputOptimizer = new ThroughputOptimizer();
371
+ this.latencyOptimizer = new LatencyOptimizer();
372
+ }
373
+
374
+ async calculateQuorum(analysisInput) {
375
+ const { performanceMetrics, membershipStatus, protocol } = analysisInput;
376
+
377
+ // Analyze current performance bottlenecks
378
+ const bottlenecks = await this.identifyPerformanceBottlenecks(performanceMetrics);
379
+
380
+ // Calculate throughput-optimal quorum size
381
+ const throughputOptimal = await this.calculateThroughputOptimalQuorum(
382
+ performanceMetrics, membershipStatus.activeNodes
383
+ );
384
+
385
+ // Calculate latency-optimal quorum size
386
+ const latencyOptimal = await this.calculateLatencyOptimalQuorum(
387
+ performanceMetrics, membershipStatus.activeNodes
388
+ );
389
+
390
+ // Balance throughput and latency requirements
391
+ const balancedQuorum = await this.balanceThroughputAndLatency(
392
+ throughputOptimal, latencyOptimal, performanceMetrics.requirements
393
+ );
394
+
395
+ return {
396
+ quorum: balancedQuorum,
397
+ strategy: 'PERFORMANCE_BASED',
398
+ confidence: this.calculatePerformanceConfidence(performanceMetrics),
399
+ reasoning: this.generatePerformanceReasoning(
400
+ balancedQuorum, throughputOptimal, latencyOptimal, bottlenecks
401
+ ),
402
+ expectedImpact: {
403
+ throughputImprovement: this.estimateThroughputImpact(balancedQuorum),
404
+ latencyImprovement: this.estimateLatencyImpact(balancedQuorum)
405
+ }
406
+ };
407
+ }
408
+
409
+ async calculateThroughputOptimalQuorum(performanceMetrics, activeNodes) {
410
+ const currentThroughput = performanceMetrics.throughput;
411
+ const targetThroughput = performanceMetrics.requirements.targetThroughput;
412
+
413
+ // Analyze relationship between quorum size and throughput
414
+ const throughputCurve = await this.analyzeThroughputCurve(activeNodes);
415
+
416
+ // Find quorum size that maximizes throughput while meeting requirements
417
+ let optimalSize = Math.ceil(activeNodes.length / 2) + 1; // Minimum viable quorum
418
+ let maxThroughput = 0;
419
+
420
+ for (let size = optimalSize; size <= activeNodes.length; size++) {
421
+ const projectedThroughput = this.projectThroughput(size, throughputCurve);
422
+
423
+ if (projectedThroughput > maxThroughput && projectedThroughput >= targetThroughput) {
424
+ maxThroughput = projectedThroughput;
425
+ optimalSize = size;
426
+ } else if (projectedThroughput < maxThroughput * 0.9) {
427
+ // Stop if throughput starts decreasing significantly
428
+ break;
429
+ }
430
+ }
431
+
432
+ return await this.selectOptimalNodes(activeNodes, optimalSize, 'THROUGHPUT');
433
+ }
434
+
435
+ async calculateLatencyOptimalQuorum(performanceMetrics, activeNodes) {
436
+ const currentLatency = performanceMetrics.latency;
437
+ const targetLatency = performanceMetrics.requirements.maxLatency;
438
+
439
+ // Analyze relationship between quorum size and latency
440
+ const latencyCurve = await this.analyzeLatencyCurve(activeNodes);
441
+
442
+ // Find minimum quorum size that meets latency requirements
443
+ const minViableQuorum = Math.ceil(activeNodes.length / 2) + 1;
444
+
445
+ for (let size = minViableQuorum; size <= activeNodes.length; size++) {
446
+ const projectedLatency = this.projectLatency(size, latencyCurve);
447
+
448
+ if (projectedLatency <= targetLatency) {
449
+ return await this.selectOptimalNodes(activeNodes, size, 'LATENCY');
450
+ }
451
+ }
452
+
453
+ // If no size meets requirements, return minimum viable with warning
454
+ console.warn('No quorum size meets latency requirements');
455
+ return await this.selectOptimalNodes(activeNodes, minViableQuorum, 'LATENCY');
456
+ }
457
+
458
+ async selectOptimalNodes(availableNodes, targetSize, optimizationTarget) {
459
+ const nodeScores = new Map();
460
+
461
+ // Score nodes based on optimization target
462
+ for (const node of availableNodes) {
463
+ let score = 0;
464
+
465
+ if (optimizationTarget === 'THROUGHPUT') {
466
+ score = await this.scoreThroughputCapability(node);
467
+ } else if (optimizationTarget === 'LATENCY') {
468
+ score = await this.scoreLatencyPerformance(node);
469
+ }
470
+
471
+ nodeScores.set(node.id, score);
472
+ }
473
+
474
+ // Select top-scoring nodes
475
+ const sortedNodes = availableNodes.sort((a, b) =>
476
+ nodeScores.get(b.id) - nodeScores.get(a.id)
477
+ );
478
+
479
+ const selectedNodes = new Map();
480
+
481
+ for (let i = 0; i < Math.min(targetSize, sortedNodes.length); i++) {
482
+ const node = sortedNodes[i];
483
+ selectedNodes.set(node.id, {
484
+ weight: this.calculatePerformanceWeight(node, nodeScores.get(node.id)),
485
+ score: nodeScores.get(node.id),
486
+ role: i === 0 ? 'primary' : 'secondary',
487
+ optimizationTarget: optimizationTarget
488
+ });
489
+ }
490
+
491
+ return {
492
+ nodes: selectedNodes,
493
+ totalWeight: Array.from(selectedNodes.values())
494
+ .reduce((sum, node) => sum + node.weight, 0),
495
+ optimizationTarget: optimizationTarget
496
+ };
497
+ }
498
+
499
+ async scoreThroughputCapability(node) {
500
+ let score = 0;
501
+
502
+ // CPU capacity score
503
+ const cpuCapacity = await this.getNodeCPUCapacity(node);
504
+ score += (cpuCapacity / 100) * 30; // 30% weight for CPU
505
+
506
+ // Network bandwidth score
507
+ const bandwidth = await this.getNodeBandwidth(node);
508
+ score += (bandwidth / 1000) * 25; // 25% weight for bandwidth (Mbps)
509
+
510
+ // Memory capacity score
511
+ const memory = await this.getNodeMemory(node);
512
+ score += (memory / 8192) * 20; // 20% weight for memory (MB)
513
+
514
+ // Historical throughput performance
515
+ const historicalPerformance = await this.getHistoricalThroughput(node);
516
+ score += (historicalPerformance / 1000) * 25; // 25% weight for historical performance
517
+
518
+ return Math.min(100, score); // Normalize to 0-100
519
+ }
520
+
521
+ async scoreLatencyPerformance(node) {
522
+ let score = 100; // Start with perfect score, subtract penalties
523
+
524
+ // Network latency penalty
525
+ const avgLatency = await this.getAverageNodeLatency(node);
526
+ score -= (avgLatency / 10); // Subtract 1 point per 10ms latency
527
+
528
+ // CPU load penalty
529
+ const cpuLoad = await this.getNodeCPULoad(node);
530
+ score -= (cpuLoad / 2); // Subtract 0.5 points per 1% CPU load
531
+
532
+ // Geographic distance penalty (for distributed networks)
533
+ const geoLatency = await this.getGeographicLatency(node);
534
+ score -= (geoLatency / 20); // Subtract 1 point per 20ms geo latency
535
+
536
+ // Consistency penalty (nodes with inconsistent performance)
537
+ const consistencyScore = await this.getPerformanceConsistency(node);
538
+ score *= consistencyScore; // Multiply by consistency factor (0-1)
539
+
540
+ return Math.max(0, score);
541
+ }
542
+ }
543
+ ```
544
+
545
+ ### Fault Tolerance Strategy
546
+ ```javascript
547
+ class FaultToleranceStrategy {
548
+ constructor() {
549
+ this.faultAnalyzer = new FaultAnalyzer();
550
+ this.reliabilityCalculator = new ReliabilityCalculator();
551
+ this.redundancyOptimizer = new RedundancyOptimizer();
552
+ }
553
+
554
+ async calculateQuorum(analysisInput) {
555
+ const { membershipStatus, faultToleranceRequirements, networkConditions } = analysisInput;
556
+
557
+ // Analyze fault scenarios
558
+ const faultScenarios = await this.analyzeFaultScenarios(
559
+ membershipStatus.activeNodes, networkConditions
560
+ );
561
+
562
+ // Calculate minimum quorum for fault tolerance requirements
563
+ const minQuorum = this.calculateFaultTolerantQuorum(
564
+ faultScenarios, faultToleranceRequirements
565
+ );
566
+
567
+ // Optimize node selection for maximum fault tolerance
568
+ const faultTolerantQuorum = await this.optimizeForFaultTolerance(
569
+ membershipStatus.activeNodes, minQuorum, faultScenarios
570
+ );
571
+
572
+ return {
573
+ quorum: faultTolerantQuorum,
574
+ strategy: 'FAULT_TOLERANCE_BASED',
575
+ confidence: this.calculateFaultConfidence(faultScenarios),
576
+ reasoning: this.generateFaultToleranceReasoning(
577
+ faultTolerantQuorum, faultScenarios, faultToleranceRequirements
578
+ ),
579
+ expectedImpact: {
580
+ availability: this.estimateAvailabilityImprovement(faultTolerantQuorum),
581
+ resilience: this.estimateResilienceImprovement(faultTolerantQuorum)
582
+ }
583
+ };
584
+ }
585
+
586
+ async analyzeFaultScenarios(activeNodes, networkConditions) {
587
+ const scenarios = [];
588
+
589
+ // Single node failure scenarios
590
+ for (const node of activeNodes) {
591
+ const scenario = await this.analyzeSingleNodeFailure(node, activeNodes, networkConditions);
592
+ scenarios.push(scenario);
593
+ }
594
+
595
+ // Multiple node failure scenarios
596
+ const multiFailureScenarios = await this.analyzeMultipleNodeFailures(
597
+ activeNodes, networkConditions
598
+ );
599
+ scenarios.push(...multiFailureScenarios);
600
+
601
+ // Network partition scenarios
602
+ const partitionScenarios = await this.analyzeNetworkPartitionScenarios(
603
+ activeNodes, networkConditions
604
+ );
605
+ scenarios.push(...partitionScenarios);
606
+
607
+ // Correlated failure scenarios
608
+ const correlatedFailureScenarios = await this.analyzeCorrelatedFailures(
609
+ activeNodes, networkConditions
610
+ );
611
+ scenarios.push(...correlatedFailureScenarios);
612
+
613
+ return this.prioritizeScenariosByLikelihood(scenarios);
614
+ }
615
+
616
+ calculateFaultTolerantQuorum(faultScenarios, requirements) {
617
+ let maxRequiredQuorum = 0;
618
+
619
+ for (const scenario of faultScenarios) {
620
+ if (scenario.likelihood >= requirements.minLikelihoodToConsider) {
621
+ const requiredQuorum = this.calculateQuorumForScenario(scenario, requirements);
622
+ maxRequiredQuorum = Math.max(maxRequiredQuorum, requiredQuorum);
623
+ }
624
+ }
625
+
626
+ return maxRequiredQuorum;
627
+ }
628
+
629
+ calculateQuorumForScenario(scenario, requirements) {
630
+ const totalNodes = scenario.totalNodes;
631
+ const failedNodes = scenario.failedNodes;
632
+ const availableNodes = totalNodes - failedNodes;
633
+
634
+ // For Byzantine fault tolerance
635
+ if (requirements.byzantineFaultTolerance) {
636
+ const maxByzantineNodes = Math.floor((totalNodes - 1) / 3);
637
+ return Math.floor(2 * totalNodes / 3) + 1;
638
+ }
639
+
640
+ // For crash fault tolerance
641
+ return Math.floor(availableNodes / 2) + 1;
642
+ }
643
+
644
+ async optimizeForFaultTolerance(activeNodes, minQuorum, faultScenarios) {
645
+ const optimizedQuorum = {
646
+ nodes: new Map(),
647
+ totalWeight: 0,
648
+ faultTolerance: {
649
+ singleNodeFailures: 0,
650
+ multipleNodeFailures: 0,
651
+ networkPartitions: 0
652
+ }
653
+ };
654
+
655
+ // Score nodes based on fault tolerance contribution
656
+ const nodeScores = await this.scoreFaultToleranceContribution(
657
+ activeNodes, faultScenarios
658
+ );
659
+
660
+ // Select nodes to maximize fault tolerance coverage
661
+ const selectedNodes = this.selectFaultTolerantNodes(
662
+ activeNodes, minQuorum, nodeScores, faultScenarios
663
+ );
664
+
665
+ for (const [nodeId, nodeData] of selectedNodes) {
666
+ optimizedQuorum.nodes.set(nodeId, {
667
+ weight: nodeData.weight,
668
+ score: nodeData.score,
669
+ role: nodeData.role,
670
+ faultToleranceContribution: nodeData.faultToleranceContribution
671
+ });
672
+ optimizedQuorum.totalWeight += nodeData.weight;
673
+ }
674
+
675
+ // Calculate fault tolerance metrics for selected quorum
676
+ optimizedQuorum.faultTolerance = await this.calculateFaultToleranceMetrics(
677
+ selectedNodes, faultScenarios
678
+ );
679
+
680
+ return optimizedQuorum;
681
+ }
682
+
683
+ async scoreFaultToleranceContribution(activeNodes, faultScenarios) {
684
+ const scores = new Map();
685
+
686
+ for (const node of activeNodes) {
687
+ let score = 0;
688
+
689
+ // Independence score (nodes in different failure domains get higher scores)
690
+ const independenceScore = await this.calculateIndependenceScore(node, activeNodes);
691
+ score += independenceScore * 40;
692
+
693
+ // Reliability score (historical uptime and performance)
694
+ const reliabilityScore = await this.calculateReliabilityScore(node);
695
+ score += reliabilityScore * 30;
696
+
697
+ // Geographic diversity score
698
+ const diversityScore = await this.calculateDiversityScore(node, activeNodes);
699
+ score += diversityScore * 20;
700
+
701
+ // Recovery capability score
702
+ const recoveryScore = await this.calculateRecoveryScore(node);
703
+ score += recoveryScore * 10;
704
+
705
+ scores.set(node.id, score);
706
+ }
707
+
708
+ return scores;
709
+ }
710
+
711
+ selectFaultTolerantNodes(activeNodes, minQuorum, nodeScores, faultScenarios) {
712
+ const selectedNodes = new Map();
713
+ const remainingNodes = [...activeNodes];
714
+
715
+ // Greedy selection to maximize fault tolerance coverage
716
+ while (selectedNodes.size < minQuorum && remainingNodes.length > 0) {
717
+ let bestNode = null;
718
+ let bestScore = -1;
719
+ let bestIndex = -1;
720
+
721
+ for (let i = 0; i < remainingNodes.length; i++) {
722
+ const node = remainingNodes[i];
723
+ const additionalCoverage = this.calculateAdditionalFaultCoverage(
724
+ node, selectedNodes, faultScenarios
725
+ );
726
+
727
+ const combinedScore = nodeScores.get(node.id) + (additionalCoverage * 50);
728
+
729
+ if (combinedScore > bestScore) {
730
+ bestScore = combinedScore;
731
+ bestNode = node;
732
+ bestIndex = i;
733
+ }
734
+ }
735
+
736
+ if (bestNode) {
737
+ selectedNodes.set(bestNode.id, {
738
+ weight: this.calculateFaultToleranceWeight(bestNode, nodeScores.get(bestNode.id)),
739
+ score: nodeScores.get(bestNode.id),
740
+ role: selectedNodes.size === 0 ? 'primary' : 'secondary',
741
+ faultToleranceContribution: this.calculateFaultToleranceContribution(bestNode)
742
+ });
743
+
744
+ remainingNodes.splice(bestIndex, 1);
745
+ } else {
746
+ break; // No more beneficial nodes
747
+ }
748
+ }
749
+
750
+ return selectedNodes;
751
+ }
752
+ }
753
+ ```
754
+
755
+ ## MCP Integration Hooks
756
+
757
+ ### Quorum State Management
758
+ ```javascript
759
+ // Store quorum configuration and history
760
+ await this.mcpTools.memory_usage({
761
+ action: 'store',
762
+ key: `quorum_config_${this.nodeId}`,
763
+ value: JSON.stringify({
764
+ currentQuorum: Array.from(this.currentQuorum.entries()),
765
+ strategy: this.activeStrategy,
766
+ networkConditions: this.lastNetworkAnalysis,
767
+ adjustmentHistory: this.quorumHistory.slice(-10)
768
+ }),
769
+ namespace: 'quorum_management',
770
+ ttl: 3600000 // 1 hour
771
+ });
772
+
773
+ // Coordinate with swarm for membership changes
774
+ const swarmStatus = await this.mcpTools.swarm_status({
775
+ swarmId: this.swarmId
776
+ });
777
+
778
+ await this.mcpTools.coordination_sync({
779
+ swarmId: this.swarmId
780
+ });
781
+ ```
782
+
783
+ ### Performance Monitoring Integration
784
+ ```javascript
785
+ // Track quorum adjustment performance
786
+ await this.mcpTools.metrics_collect({
787
+ components: [
788
+ 'quorum_adjustment_latency',
789
+ 'consensus_availability',
790
+ 'fault_tolerance_coverage',
791
+ 'network_partition_recovery_time'
792
+ ]
793
+ });
794
+
795
+ // Neural learning for quorum optimization
796
+ await this.mcpTools.neural_patterns({
797
+ action: 'learn',
798
+ operation: 'quorum_optimization',
799
+ outcome: JSON.stringify({
800
+ adjustmentType: adjustment.strategy,
801
+ performanceImpact: measurementResults,
802
+ networkConditions: currentNetworkState,
803
+ faultToleranceImprovement: faultToleranceMetrics
804
+ })
805
+ });
806
+ ```
807
+
808
+ ### Task Orchestration for Quorum Changes
809
+ ```javascript
810
+ // Orchestrate complex quorum adjustments
811
+ await this.mcpTools.task_orchestrate({
812
+ task: 'quorum_adjustment',
813
+ strategy: 'sequential',
814
+ priority: 'high',
815
+ dependencies: [
816
+ 'network_analysis',
817
+ 'membership_validation',
818
+ 'performance_assessment'
819
+ ]
820
+ });
821
+ ```
822
+
823
823
  This Quorum Manager provides intelligent, adaptive quorum management that optimizes for network conditions, performance requirements, and fault tolerance needs while maintaining the safety and liveness properties of distributed consensus protocols.