@claude-flow/cli 3.32.9 → 3.32.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 (447) hide show
  1. package/.claude/.proven-config-version +1 -0
  2. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  3. package/.claude/agents/analysis/code-analyzer.md +209 -209
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  5. package/.claude/agents/architecture/arch-system-design.md +156 -156
  6. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  7. package/.claude/agents/browser/browser-agent.yaml +182 -182
  8. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  9. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  10. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  11. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  12. package/.claude/agents/consensus/quorum-manager.md +822 -822
  13. package/.claude/agents/consensus/raft-manager.md +62 -62
  14. package/.claude/agents/consensus/security-manager.md +621 -621
  15. package/.claude/agents/core/planner.md +374 -374
  16. package/.claude/agents/custom/test-long-runner.md +44 -44
  17. package/.claude/agents/data/data-ml-model.md +444 -444
  18. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  19. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  20. package/.claude/agents/development/dev-backend-api.md +344 -344
  21. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  22. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  23. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  24. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  25. package/.claude/agents/flow-nexus/app-store.md +87 -87
  26. package/.claude/agents/flow-nexus/authentication.md +68 -68
  27. package/.claude/agents/flow-nexus/challenges.md +80 -80
  28. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  29. package/.claude/agents/flow-nexus/payments.md +82 -82
  30. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  31. package/.claude/agents/flow-nexus/swarm.md +75 -75
  32. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  33. package/.claude/agents/flow-nexus/workflow.md +83 -83
  34. package/.claude/agents/github/code-review-swarm.md +377 -377
  35. package/.claude/agents/github/github-modes.md +172 -172
  36. package/.claude/agents/github/issue-tracker.md +575 -575
  37. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  38. package/.claude/agents/github/pr-manager.md +437 -437
  39. package/.claude/agents/github/project-board-sync.md +508 -508
  40. package/.claude/agents/github/release-manager.md +604 -604
  41. package/.claude/agents/github/release-swarm.md +582 -582
  42. package/.claude/agents/github/repo-architect.md +397 -397
  43. package/.claude/agents/github/swarm-issue.md +572 -572
  44. package/.claude/agents/github/swarm-pr.md +427 -427
  45. package/.claude/agents/github/sync-coordinator.md +451 -451
  46. package/.claude/agents/github/workflow-automation.md +902 -902
  47. package/.claude/agents/goal/agent.md +815 -815
  48. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  49. package/.claude/agents/optimization/load-balancer.md +430 -430
  50. package/.claude/agents/optimization/performance-monitor.md +671 -671
  51. package/.claude/agents/optimization/resource-allocator.md +673 -673
  52. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  53. package/.claude/agents/payments/agentic-payments.md +126 -126
  54. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  55. package/.claude/agents/sparc/architecture.md +698 -698
  56. package/.claude/agents/sparc/pseudocode.md +519 -519
  57. package/.claude/agents/sparc/refinement.md +801 -801
  58. package/.claude/agents/sparc/specification.md +477 -477
  59. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  60. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  61. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  62. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  63. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  64. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  65. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  66. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  67. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  68. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  69. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  70. package/.claude/agents/templates/base-template-generator.md +289 -289
  71. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  72. package/.claude/agents/templates/github-pr-manager.md +176 -176
  73. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  74. package/.claude/agents/templates/memory-coordinator.md +186 -186
  75. package/.claude/agents/templates/orchestrator-task.md +138 -138
  76. package/.claude/agents/templates/performance-analyzer.md +198 -198
  77. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  78. package/.claude/agents/testing/production-validator.md +394 -394
  79. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  80. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  81. package/.claude/agents/v3/claims-authorizer.md +208 -208
  82. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  83. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  84. package/.claude/agents/v3/injection-analyst.md +236 -236
  85. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  86. package/.claude/agents/v3/pii-detector.md +151 -151
  87. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  88. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  89. package/.claude/agents/v3/security-architect.md +867 -867
  90. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  91. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  92. package/.claude/commands/agents/README.md +50 -50
  93. package/.claude/commands/agents/agent-capabilities.md +140 -140
  94. package/.claude/commands/agents/agent-coordination.md +28 -28
  95. package/.claude/commands/agents/agent-spawning.md +28 -28
  96. package/.claude/commands/agents/agent-types.md +216 -216
  97. package/.claude/commands/agents/health.md +139 -139
  98. package/.claude/commands/agents/list.md +100 -100
  99. package/.claude/commands/agents/logs.md +130 -130
  100. package/.claude/commands/agents/metrics.md +122 -122
  101. package/.claude/commands/agents/pool.md +127 -127
  102. package/.claude/commands/agents/spawn.md +140 -140
  103. package/.claude/commands/agents/status.md +115 -115
  104. package/.claude/commands/agents/stop.md +102 -102
  105. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  106. package/.claude/commands/analysis/README.md +9 -9
  107. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  108. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  109. package/.claude/commands/analysis/performance-report.md +25 -25
  110. package/.claude/commands/analysis/token-efficiency.md +44 -44
  111. package/.claude/commands/analysis/token-usage.md +25 -25
  112. package/.claude/commands/automation/README.md +9 -9
  113. package/.claude/commands/automation/auto-agent.md +122 -122
  114. package/.claude/commands/automation/self-healing.md +105 -105
  115. package/.claude/commands/automation/session-memory.md +89 -89
  116. package/.claude/commands/automation/smart-agents.md +72 -72
  117. package/.claude/commands/automation/smart-spawn.md +25 -25
  118. package/.claude/commands/automation/workflow-select.md +25 -25
  119. package/.claude/commands/claude-flow-help.md +103 -103
  120. package/.claude/commands/claude-flow-memory.md +107 -107
  121. package/.claude/commands/claude-flow-swarm.md +205 -205
  122. package/.claude/commands/coordination/README.md +9 -9
  123. package/.claude/commands/coordination/agent-spawn.md +25 -25
  124. package/.claude/commands/coordination/init.md +44 -44
  125. package/.claude/commands/coordination/orchestrate.md +43 -43
  126. package/.claude/commands/coordination/spawn.md +45 -45
  127. package/.claude/commands/coordination/swarm-init.md +85 -85
  128. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  129. package/.claude/commands/github/README.md +11 -11
  130. package/.claude/commands/github/code-review-swarm.md +513 -513
  131. package/.claude/commands/github/code-review.md +25 -25
  132. package/.claude/commands/github/github-modes.md +146 -146
  133. package/.claude/commands/github/github-swarm.md +121 -121
  134. package/.claude/commands/github/issue-tracker.md +291 -291
  135. package/.claude/commands/github/issue-triage.md +25 -25
  136. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  137. package/.claude/commands/github/pr-enhance.md +26 -26
  138. package/.claude/commands/github/pr-manager.md +169 -169
  139. package/.claude/commands/github/project-board-sync.md +470 -470
  140. package/.claude/commands/github/release-manager.md +339 -339
  141. package/.claude/commands/github/release-swarm.md +543 -543
  142. package/.claude/commands/github/repo-analyze.md +25 -25
  143. package/.claude/commands/github/repo-architect.md +366 -366
  144. package/.claude/commands/github/swarm-issue.md +484 -484
  145. package/.claude/commands/github/swarm-pr.md +287 -287
  146. package/.claude/commands/github/sync-coordinator.md +302 -302
  147. package/.claude/commands/github/workflow-automation.md +441 -441
  148. package/.claude/commands/hive-mind/README.md +17 -17
  149. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  150. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  151. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  152. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  153. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  154. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  155. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  156. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  157. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  159. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  160. package/.claude/commands/hooks/README.md +11 -11
  161. package/.claude/commands/hooks/overview.md +57 -57
  162. package/.claude/commands/hooks/post-edit.md +117 -117
  163. package/.claude/commands/hooks/post-task.md +112 -112
  164. package/.claude/commands/hooks/pre-edit.md +113 -113
  165. package/.claude/commands/hooks/pre-task.md +111 -111
  166. package/.claude/commands/hooks/session-end.md +118 -118
  167. package/.claude/commands/hooks/setup.md +102 -102
  168. package/.claude/commands/memory/README.md +9 -9
  169. package/.claude/commands/memory/memory-persist.md +25 -25
  170. package/.claude/commands/memory/memory-search.md +25 -25
  171. package/.claude/commands/memory/memory-usage.md +25 -25
  172. package/.claude/commands/memory/neural.md +47 -47
  173. package/.claude/commands/monitoring/README.md +9 -9
  174. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  175. package/.claude/commands/monitoring/agents.md +44 -44
  176. package/.claude/commands/monitoring/real-time-view.md +25 -25
  177. package/.claude/commands/monitoring/status.md +46 -46
  178. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  179. package/.claude/commands/optimization/README.md +9 -9
  180. package/.claude/commands/optimization/auto-topology.md +61 -61
  181. package/.claude/commands/optimization/cache-manage.md +25 -25
  182. package/.claude/commands/optimization/parallel-execute.md +25 -25
  183. package/.claude/commands/optimization/parallel-execution.md +49 -49
  184. package/.claude/commands/optimization/topology-optimize.md +25 -25
  185. package/.claude/commands/pair/README.md +260 -260
  186. package/.claude/commands/pair/commands.md +545 -545
  187. package/.claude/commands/pair/config.md +509 -509
  188. package/.claude/commands/pair/examples.md +511 -511
  189. package/.claude/commands/pair/modes.md +347 -347
  190. package/.claude/commands/pair/session.md +406 -406
  191. package/.claude/commands/pair/start.md +208 -208
  192. package/.claude/commands/sparc/analyzer.md +51 -51
  193. package/.claude/commands/sparc/architect.md +53 -53
  194. package/.claude/commands/sparc/ask.md +97 -97
  195. package/.claude/commands/sparc/batch-executor.md +54 -54
  196. package/.claude/commands/sparc/code.md +89 -89
  197. package/.claude/commands/sparc/coder.md +54 -54
  198. package/.claude/commands/sparc/debug.md +83 -83
  199. package/.claude/commands/sparc/debugger.md +54 -54
  200. package/.claude/commands/sparc/designer.md +53 -53
  201. package/.claude/commands/sparc/devops.md +109 -109
  202. package/.claude/commands/sparc/docs-writer.md +80 -80
  203. package/.claude/commands/sparc/documenter.md +54 -54
  204. package/.claude/commands/sparc/innovator.md +54 -54
  205. package/.claude/commands/sparc/integration.md +83 -83
  206. package/.claude/commands/sparc/mcp.md +117 -117
  207. package/.claude/commands/sparc/memory-manager.md +54 -54
  208. package/.claude/commands/sparc/optimizer.md +54 -54
  209. package/.claude/commands/sparc/orchestrator.md +131 -131
  210. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  211. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  212. package/.claude/commands/sparc/researcher.md +54 -54
  213. package/.claude/commands/sparc/reviewer.md +54 -54
  214. package/.claude/commands/sparc/security-review.md +80 -80
  215. package/.claude/commands/sparc/sparc-modes.md +174 -174
  216. package/.claude/commands/sparc/sparc.md +111 -111
  217. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  218. package/.claude/commands/sparc/supabase-admin.md +348 -348
  219. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  220. package/.claude/commands/sparc/tdd.md +54 -54
  221. package/.claude/commands/sparc/tester.md +54 -54
  222. package/.claude/commands/sparc/tutorial.md +79 -79
  223. package/.claude/commands/sparc/workflow-manager.md +54 -54
  224. package/.claude/commands/sparc.md +166 -166
  225. package/.claude/commands/stream-chain/pipeline.md +120 -120
  226. package/.claude/commands/stream-chain/run.md +69 -69
  227. package/.claude/commands/swarm/README.md +15 -15
  228. package/.claude/commands/swarm/analysis.md +95 -95
  229. package/.claude/commands/swarm/development.md +96 -96
  230. package/.claude/commands/swarm/examples.md +168 -168
  231. package/.claude/commands/swarm/maintenance.md +102 -102
  232. package/.claude/commands/swarm/optimization.md +117 -117
  233. package/.claude/commands/swarm/research.md +136 -136
  234. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  235. package/.claude/commands/swarm/swarm-background.md +8 -8
  236. package/.claude/commands/swarm/swarm-init.md +19 -19
  237. package/.claude/commands/swarm/swarm-modes.md +8 -8
  238. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  239. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  240. package/.claude/commands/swarm/swarm-status.md +8 -8
  241. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  242. package/.claude/commands/swarm/swarm.md +87 -87
  243. package/.claude/commands/swarm/testing.md +131 -131
  244. package/.claude/commands/training/README.md +9 -9
  245. package/.claude/commands/training/model-update.md +25 -25
  246. package/.claude/commands/training/neural-patterns.md +107 -107
  247. package/.claude/commands/training/neural-train.md +75 -75
  248. package/.claude/commands/training/pattern-learn.md +25 -25
  249. package/.claude/commands/training/specialization.md +62 -62
  250. package/.claude/commands/truth/start.md +142 -142
  251. package/.claude/commands/verify/check.md +49 -49
  252. package/.claude/commands/verify/start.md +127 -127
  253. package/.claude/commands/workflows/README.md +9 -9
  254. package/.claude/commands/workflows/development.md +77 -77
  255. package/.claude/commands/workflows/research.md +62 -62
  256. package/.claude/commands/workflows/workflow-create.md +25 -25
  257. package/.claude/commands/workflows/workflow-execute.md +25 -25
  258. package/.claude/commands/workflows/workflow-export.md +25 -25
  259. package/.claude/eval/human-relevance-frozen-v1.json +17 -17
  260. package/.claude/evolve-proof/generation-0.json +211 -211
  261. package/.claude/evolve-proof/real-generation-0.json +406 -406
  262. package/.claude/evolve-proof/real-generation-1.json +406 -406
  263. package/.claude/helpers/.helpers-version +1 -1
  264. package/.claude/helpers/README.md +96 -96
  265. package/.claude/helpers/adr-compliance.sh +186 -186
  266. package/.claude/helpers/auto-commit.sh +178 -178
  267. package/.claude/helpers/auto-memory-hook.mjs +0 -0
  268. package/.claude/helpers/checkpoint-manager.sh +251 -251
  269. package/.claude/helpers/daemon-manager.sh +252 -252
  270. package/.claude/helpers/ddd-tracker.sh +144 -144
  271. package/.claude/helpers/github-safe.js +156 -156
  272. package/.claude/helpers/github-setup.sh +45 -45
  273. package/.claude/helpers/guidance-hook.sh +13 -13
  274. package/.claude/helpers/guidance-hooks.sh +102 -102
  275. package/.claude/helpers/health-monitor.sh +108 -108
  276. package/.claude/helpers/helpers.manifest.json +2 -2
  277. package/.claude/helpers/hook-handler.cjs +0 -0
  278. package/.claude/helpers/intelligence.cjs +0 -0
  279. package/.claude/helpers/learning-hooks.sh +329 -329
  280. package/.claude/helpers/learning-optimizer.sh +127 -127
  281. package/.claude/helpers/learning-service.mjs +1144 -1144
  282. package/.claude/helpers/memory.js +83 -83
  283. package/.claude/helpers/metrics-db.mjs +503 -503
  284. package/.claude/helpers/pattern-consolidator.sh +86 -86
  285. package/.claude/helpers/perf-worker.sh +160 -160
  286. package/.claude/helpers/post-commit +16 -16
  287. package/.claude/helpers/pre-commit +26 -26
  288. package/.claude/helpers/quick-start.sh +19 -19
  289. package/.claude/helpers/router.js +105 -105
  290. package/.claude/helpers/security-scanner.sh +127 -127
  291. package/.claude/helpers/session.js +157 -157
  292. package/.claude/helpers/setup-mcp.sh +18 -18
  293. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  294. package/.claude/helpers/statusline-hook.sh +21 -21
  295. package/.claude/helpers/statusline.cjs +0 -0
  296. package/.claude/helpers/statusline.js +340 -340
  297. package/.claude/helpers/swarm-comms.sh +353 -353
  298. package/.claude/helpers/swarm-hooks.sh +761 -761
  299. package/.claude/helpers/swarm-monitor.sh +210 -210
  300. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  301. package/.claude/helpers/update-v3-progress.sh +165 -165
  302. package/.claude/helpers/v3-quick-status.sh +57 -57
  303. package/.claude/helpers/v3.sh +110 -110
  304. package/.claude/helpers/validate-v3-config.sh +215 -215
  305. package/.claude/helpers/worker-manager.sh +170 -170
  306. package/.claude/proven-config.json +42 -0
  307. package/.claude/proven-config.manifest.json +37 -37
  308. package/.claude/proven-config.signed.json +41 -41
  309. package/.claude/settings.json +182 -182
  310. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  311. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  312. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  313. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  314. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  315. package/.claude/skills/browser/SKILL.md +204 -204
  316. package/.claude/skills/dual-mode/README.md +71 -71
  317. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  318. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  319. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  320. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  321. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  322. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  323. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  324. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  325. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  326. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  327. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  328. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  329. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  330. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  331. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  332. package/.claude/skills/skill-builder/SKILL.md +910 -910
  333. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  334. package/.claude/skills/stream-chain/SKILL.md +560 -560
  335. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  336. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  337. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  338. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  339. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  340. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  341. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  342. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  343. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  344. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  345. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  346. package/.claude/skills/verification-quality/SKILL.md +691 -691
  347. package/README.md +419 -419
  348. package/bin/cli.js +314 -314
  349. package/bin/mcp-server.js +224 -224
  350. package/bin/preinstall.cjs +2 -2
  351. package/catalog-manifest.json +2 -2
  352. package/dist/src/autopilot-state.js +24 -7
  353. package/dist/src/benchmarks/gaia-critic.js +24 -24
  354. package/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  355. package/dist/src/commands/completions.js +409 -409
  356. package/dist/src/commands/daemon.js +44 -44
  357. package/dist/src/commands/embeddings.js +26 -26
  358. package/dist/src/commands/hive-mind.js +97 -97
  359. package/dist/src/commands/hooks.js +31 -10
  360. package/dist/src/commands/init.js +202 -34
  361. package/dist/src/commands/memory.js +12 -1
  362. package/dist/src/commands/ruvector/backup.js +23 -23
  363. package/dist/src/commands/ruvector/benchmark.js +31 -31
  364. package/dist/src/commands/ruvector/import.js +14 -14
  365. package/dist/src/commands/ruvector/init.js +115 -115
  366. package/dist/src/commands/ruvector/migrate.js +99 -99
  367. package/dist/src/commands/ruvector/optimize.js +51 -51
  368. package/dist/src/commands/ruvector/setup.js +624 -624
  369. package/dist/src/commands/ruvector/status.js +38 -38
  370. package/dist/src/config/proven-config.js +2 -2
  371. package/dist/src/funnel/disclosure.js +13 -2
  372. package/dist/src/funnel/messages.d.ts +12 -10
  373. package/dist/src/funnel/messages.js +83 -11
  374. package/dist/src/init/claudemd-generator.js +231 -231
  375. package/dist/src/init/executor.js +453 -453
  376. package/dist/src/init/helper-signing.js +2 -2
  377. package/dist/src/init/helpers-generator.js +751 -751
  378. package/dist/src/init/statusline-generator.js +24 -24
  379. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  380. package/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  381. package/dist/src/mcp-tools/browser-tools.js +8 -0
  382. package/dist/src/mcp-tools/hooks-tools.js +21 -0
  383. package/dist/src/mcp-tools/memory-tools.js +4 -3
  384. package/dist/src/memory/graph-edge-writer.js +22 -22
  385. package/dist/src/memory/memory-bridge.js +248 -158
  386. package/dist/src/memory/memory-initializer.js +407 -407
  387. package/dist/src/memory/rabitq-index.js +5 -5
  388. package/dist/src/parser.js +25 -9
  389. package/dist/src/proxy/verify.js +2 -2
  390. package/dist/src/runtime/headless.js +28 -28
  391. package/dist/src/services/distill-tuning.js +7 -7
  392. package/dist/src/services/headless-worker-executor.js +84 -84
  393. package/dist/src/services/memory-distillation.js +4 -4
  394. package/dist/src/services/worker-daemon.js +7 -4
  395. package/dist/src/transfer/deploy-seraphine.js +23 -23
  396. package/package.json +137 -137
  397. package/plugins/ruflo-metaharness/.claude-plugin/plugin.json +32 -32
  398. package/plugins/ruflo-metaharness/README.md +72 -72
  399. package/plugins/ruflo-metaharness/agents/metaharness-architect.md +58 -58
  400. package/plugins/ruflo-metaharness/commands/ruflo-metaharness.md +48 -48
  401. package/plugins/ruflo-metaharness/scripts/_darwin.mjs +210 -210
  402. package/plugins/ruflo-metaharness/scripts/_harness.mjs +330 -330
  403. package/plugins/ruflo-metaharness/scripts/_invoke.mjs +231 -231
  404. package/plugins/ruflo-metaharness/scripts/_redblue.mjs +143 -143
  405. package/plugins/ruflo-metaharness/scripts/_similarity.mjs +161 -161
  406. package/plugins/ruflo-metaharness/scripts/_spike-similarity.mjs +223 -223
  407. package/plugins/ruflo-metaharness/scripts/audit-list.mjs +158 -158
  408. package/plugins/ruflo-metaharness/scripts/audit-trend.mjs +272 -272
  409. package/plugins/ruflo-metaharness/scripts/bench-parse-mcp-scan.mjs +146 -146
  410. package/plugins/ruflo-metaharness/scripts/bench-recordpair-overhead.mjs +186 -186
  411. package/plugins/ruflo-metaharness/scripts/bench-similarity.mjs +177 -177
  412. package/plugins/ruflo-metaharness/scripts/bench.mjs +95 -95
  413. package/plugins/ruflo-metaharness/scripts/drift-from-history.mjs +363 -363
  414. package/plugins/ruflo-metaharness/scripts/evolve.mjs +404 -404
  415. package/plugins/ruflo-metaharness/scripts/genome.mjs +80 -80
  416. package/plugins/ruflo-metaharness/scripts/gepa.mjs +153 -153
  417. package/plugins/ruflo-metaharness/scripts/learn.mjs +127 -127
  418. package/plugins/ruflo-metaharness/scripts/mcp-scan.mjs +111 -111
  419. package/plugins/ruflo-metaharness/scripts/mint.mjs +126 -126
  420. package/plugins/ruflo-metaharness/scripts/oia-audit.mjs +228 -228
  421. package/plugins/ruflo-metaharness/scripts/redblue.mjs +286 -286
  422. package/plugins/ruflo-metaharness/scripts/router-parallel-analyze.mjs +250 -250
  423. package/plugins/ruflo-metaharness/scripts/score.mjs +92 -92
  424. package/plugins/ruflo-metaharness/scripts/security-bench.mjs +174 -174
  425. package/plugins/ruflo-metaharness/scripts/similarity.mjs +158 -158
  426. package/plugins/ruflo-metaharness/scripts/smoke.sh +2356 -2356
  427. package/plugins/ruflo-metaharness/scripts/test-graceful-degradation.mjs +165 -165
  428. package/plugins/ruflo-metaharness/scripts/test-mcp-tools.mjs +472 -472
  429. package/plugins/ruflo-metaharness/scripts/test-parallel-pipeline.mjs +204 -204
  430. package/plugins/ruflo-metaharness/scripts/test-pipeline-roundtrip.mjs +586 -586
  431. package/plugins/ruflo-metaharness/scripts/test-similarity.mjs +334 -334
  432. package/plugins/ruflo-metaharness/scripts/test-with-openrouter.mjs +229 -229
  433. package/plugins/ruflo-metaharness/scripts/threat-model.mjs +59 -59
  434. package/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md +64 -64
  435. package/plugins/ruflo-metaharness/skills/harness-drift-from-history/SKILL.md +65 -65
  436. package/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md +131 -131
  437. package/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md +54 -54
  438. package/plugins/ruflo-metaharness/skills/harness-gepa/SKILL.md +65 -65
  439. package/plugins/ruflo-metaharness/skills/harness-learn/SKILL.md +65 -65
  440. package/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md +49 -49
  441. package/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md +72 -72
  442. package/plugins/ruflo-metaharness/skills/harness-oia-audit/SKILL.md +79 -79
  443. package/plugins/ruflo-metaharness/skills/harness-score/SKILL.md +66 -66
  444. package/plugins/ruflo-metaharness/skills/harness-security-bench/SKILL.md +101 -101
  445. package/plugins/ruflo-metaharness/skills/harness-similarity/SKILL.md +67 -67
  446. package/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md +41 -41
  447. package/scripts/postinstall.cjs +153 -153
@@ -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.