claude-flow 3.28.0 → 3.29.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (679) hide show
  1. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  2. package/.claude/agents/analysis/analyze-code-quality.md +57 -57
  3. package/.claude/agents/analysis/code-analyzer.md +188 -188
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
  6. package/.claude/agents/base-template-generator.md +41 -41
  7. package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
  8. package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
  9. package/.claude/agents/consensus/gossip-coordinator.md +42 -42
  10. package/.claude/agents/consensus/performance-benchmarker.md +830 -830
  11. package/.claude/agents/consensus/quorum-manager.md +802 -802
  12. package/.claude/agents/consensus/raft-manager.md +42 -42
  13. package/.claude/agents/consensus/security-manager.md +601 -601
  14. package/.claude/agents/core/coder.md +254 -254
  15. package/.claude/agents/core/planner.md +151 -151
  16. package/.claude/agents/core/researcher.md +173 -173
  17. package/.claude/agents/core/reviewer.md +308 -308
  18. package/.claude/agents/core/tester.md +299 -299
  19. package/.claude/agents/custom/test-long-runner.md +43 -43
  20. package/.claude/agents/data/ml/data-ml-model.md +75 -75
  21. package/.claude/agents/database-specialist.md +9 -9
  22. package/.claude/agents/development/backend/dev-backend-api.md +28 -28
  23. package/.claude/agents/development/dev-backend-api.md +177 -177
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
  25. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
  26. package/.claude/agents/dual-mode/codex-coordinator.md +206 -206
  27. package/.claude/agents/dual-mode/codex-worker.md +190 -190
  28. package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
  29. package/.claude/agents/flow-nexus/app-store.md +87 -87
  30. package/.claude/agents/flow-nexus/authentication.md +68 -68
  31. package/.claude/agents/flow-nexus/challenges.md +80 -80
  32. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  33. package/.claude/agents/flow-nexus/payments.md +82 -82
  34. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  35. package/.claude/agents/flow-nexus/swarm.md +75 -75
  36. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  37. package/.claude/agents/flow-nexus/workflow.md +83 -83
  38. package/.claude/agents/github/code-review-swarm.md +520 -520
  39. package/.claude/agents/github/github-modes.md +153 -153
  40. package/.claude/agents/github/issue-tracker.md +298 -298
  41. package/.claude/agents/github/multi-repo-swarm.md +524 -524
  42. package/.claude/agents/github/pr-manager.md +162 -162
  43. package/.claude/agents/github/project-board-sync.md +477 -477
  44. package/.claude/agents/github/release-manager.md +337 -337
  45. package/.claude/agents/github/release-swarm.md +550 -550
  46. package/.claude/agents/github/repo-architect.md +364 -364
  47. package/.claude/agents/github/swarm-issue.md +550 -550
  48. package/.claude/agents/github/swarm-pr.md +401 -401
  49. package/.claude/agents/github/sync-coordinator.md +424 -424
  50. package/.claude/agents/github/workflow-automation.md +604 -604
  51. package/.claude/agents/goal/agent.md +816 -816
  52. package/.claude/agents/goal/code-goal-planner.md +444 -444
  53. package/.claude/agents/goal/goal-planner.md +167 -167
  54. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
  55. package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
  56. package/.claude/agents/hive-mind/scout-explorer.md +240 -240
  57. package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
  58. package/.claude/agents/hive-mind/worker-specialist.md +215 -215
  59. package/.claude/agents/neural/safla-neural.md +73 -73
  60. package/.claude/agents/optimization/benchmark-suite.md +662 -662
  61. package/.claude/agents/optimization/load-balancer.md +428 -428
  62. package/.claude/agents/optimization/performance-monitor.md +669 -669
  63. package/.claude/agents/optimization/resource-allocator.md +671 -671
  64. package/.claude/agents/optimization/topology-optimizer.md +805 -805
  65. package/.claude/agents/payments/agentic-payments.md +126 -126
  66. package/.claude/agents/project-coordinator.md +8 -8
  67. package/.claude/agents/python-specialist.md +9 -9
  68. package/.claude/agents/reasoning/agent.md +816 -816
  69. package/.claude/agents/reasoning/goal-planner.md +72 -72
  70. package/.claude/agents/security-auditor.md +9 -9
  71. package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
  72. package/.claude/agents/sparc/architecture.md +452 -452
  73. package/.claude/agents/sparc/pseudocode.md +298 -298
  74. package/.claude/agents/sparc/refinement.md +503 -503
  75. package/.claude/agents/sparc/specification.md +257 -257
  76. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
  77. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  78. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  79. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  80. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  81. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  82. package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
  83. package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
  84. package/.claude/agents/swarm/mesh-coordinator.md +362 -362
  85. package/.claude/agents/templates/automation-smart-agent.md +184 -184
  86. package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
  87. package/.claude/agents/templates/github-pr-manager.md +154 -154
  88. package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
  89. package/.claude/agents/templates/memory-coordinator.md +162 -162
  90. package/.claude/agents/templates/migration-plan.md +723 -723
  91. package/.claude/agents/templates/orchestrator-task.md +119 -119
  92. package/.claude/agents/templates/performance-analyzer.md +178 -178
  93. package/.claude/agents/templates/sparc-coordinator.md +162 -162
  94. package/.claude/agents/testing/production-validator.md +372 -372
  95. package/.claude/agents/testing/tdd-london-swarm.md +221 -221
  96. package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
  97. package/.claude/agents/testing/validation/production-validator.md +372 -372
  98. package/.claude/agents/typescript-specialist.md +9 -9
  99. package/.claude/agents/v3/database-specialist.md +9 -9
  100. package/.claude/agents/v3/project-coordinator.md +8 -8
  101. package/.claude/agents/v3/python-specialist.md +9 -9
  102. package/.claude/agents/v3/test-architect.md +9 -9
  103. package/.claude/agents/v3/typescript-specialist.md +9 -9
  104. package/.claude/agents/v3/v3-integration-architect.md +311 -311
  105. package/.claude/agents/v3/v3-memory-specialist.md +280 -280
  106. package/.claude/agents/v3/v3-performance-engineer.md +362 -362
  107. package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
  108. package/.claude/agents/v3/v3-security-architect.md +139 -139
  109. package/.claude/checkpoints/1767754460.json +8 -8
  110. package/.claude/commands/agents/README.md +10 -10
  111. package/.claude/commands/agents/agent-capabilities.md +21 -21
  112. package/.claude/commands/agents/agent-coordination.md +28 -28
  113. package/.claude/commands/agents/agent-spawning.md +28 -28
  114. package/.claude/commands/agents/agent-types.md +26 -26
  115. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  116. package/.claude/commands/analysis/README.md +9 -9
  117. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  118. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  119. package/.claude/commands/analysis/performance-report.md +25 -25
  120. package/.claude/commands/analysis/token-efficiency.md +44 -44
  121. package/.claude/commands/analysis/token-usage.md +25 -25
  122. package/.claude/commands/automation/README.md +9 -9
  123. package/.claude/commands/automation/auto-agent.md +122 -122
  124. package/.claude/commands/automation/self-healing.md +105 -105
  125. package/.claude/commands/automation/session-memory.md +89 -89
  126. package/.claude/commands/automation/smart-agents.md +72 -72
  127. package/.claude/commands/automation/smart-spawn.md +25 -25
  128. package/.claude/commands/automation/workflow-select.md +25 -25
  129. package/.claude/commands/claude-flow-help.md +103 -103
  130. package/.claude/commands/claude-flow-memory.md +107 -107
  131. package/.claude/commands/claude-flow-swarm.md +205 -205
  132. package/.claude/commands/coordination/README.md +9 -9
  133. package/.claude/commands/coordination/agent-spawn.md +25 -25
  134. package/.claude/commands/coordination/init.md +44 -44
  135. package/.claude/commands/coordination/orchestrate.md +43 -43
  136. package/.claude/commands/coordination/spawn.md +45 -45
  137. package/.claude/commands/coordination/swarm-init.md +85 -85
  138. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  139. package/.claude/commands/flow-nexus/app-store.md +123 -123
  140. package/.claude/commands/flow-nexus/challenges.md +119 -119
  141. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  142. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  143. package/.claude/commands/flow-nexus/payments.md +115 -115
  144. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  145. package/.claude/commands/flow-nexus/swarm.md +86 -86
  146. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  147. package/.claude/commands/flow-nexus/workflow.md +114 -114
  148. package/.claude/commands/github/README.md +11 -11
  149. package/.claude/commands/github/code-review-swarm.md +513 -513
  150. package/.claude/commands/github/code-review.md +25 -25
  151. package/.claude/commands/github/github-modes.md +146 -146
  152. package/.claude/commands/github/github-swarm.md +121 -121
  153. package/.claude/commands/github/issue-tracker.md +291 -291
  154. package/.claude/commands/github/issue-triage.md +25 -25
  155. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  156. package/.claude/commands/github/pr-enhance.md +26 -26
  157. package/.claude/commands/github/pr-manager.md +169 -169
  158. package/.claude/commands/github/project-board-sync.md +470 -470
  159. package/.claude/commands/github/release-manager.md +337 -337
  160. package/.claude/commands/github/release-swarm.md +543 -543
  161. package/.claude/commands/github/repo-analyze.md +25 -25
  162. package/.claude/commands/github/repo-architect.md +366 -366
  163. package/.claude/commands/github/swarm-issue.md +481 -481
  164. package/.claude/commands/github/swarm-pr.md +284 -284
  165. package/.claude/commands/github/sync-coordinator.md +300 -300
  166. package/.claude/commands/github/workflow-automation.md +441 -441
  167. package/.claude/commands/hive-mind/README.md +17 -17
  168. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  170. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  173. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  175. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  177. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  178. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  179. package/.claude/commands/hooks/README.md +11 -11
  180. package/.claude/commands/hooks/overview.md +57 -57
  181. package/.claude/commands/hooks/post-edit.md +117 -117
  182. package/.claude/commands/hooks/post-task.md +112 -112
  183. package/.claude/commands/hooks/pre-edit.md +113 -113
  184. package/.claude/commands/hooks/pre-task.md +111 -111
  185. package/.claude/commands/hooks/session-end.md +118 -118
  186. package/.claude/commands/hooks/setup.md +102 -102
  187. package/.claude/commands/memory/README.md +9 -9
  188. package/.claude/commands/memory/memory-persist.md +25 -25
  189. package/.claude/commands/memory/memory-search.md +25 -25
  190. package/.claude/commands/memory/memory-usage.md +25 -25
  191. package/.claude/commands/memory/neural.md +47 -47
  192. package/.claude/commands/monitoring/README.md +9 -9
  193. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  194. package/.claude/commands/monitoring/agents.md +44 -44
  195. package/.claude/commands/monitoring/real-time-view.md +25 -25
  196. package/.claude/commands/monitoring/status.md +46 -46
  197. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  198. package/.claude/commands/optimization/README.md +9 -9
  199. package/.claude/commands/optimization/auto-topology.md +61 -61
  200. package/.claude/commands/optimization/cache-manage.md +25 -25
  201. package/.claude/commands/optimization/parallel-execute.md +25 -25
  202. package/.claude/commands/optimization/parallel-execution.md +49 -49
  203. package/.claude/commands/optimization/topology-optimize.md +25 -25
  204. package/.claude/commands/pair/README.md +260 -260
  205. package/.claude/commands/pair/commands.md +545 -545
  206. package/.claude/commands/pair/config.md +509 -509
  207. package/.claude/commands/pair/examples.md +511 -511
  208. package/.claude/commands/pair/modes.md +347 -347
  209. package/.claude/commands/pair/session.md +406 -406
  210. package/.claude/commands/pair/start.md +208 -208
  211. package/.claude/commands/sparc/analyzer.md +51 -51
  212. package/.claude/commands/sparc/architect.md +53 -53
  213. package/.claude/commands/sparc/ask.md +97 -97
  214. package/.claude/commands/sparc/batch-executor.md +54 -54
  215. package/.claude/commands/sparc/code.md +89 -89
  216. package/.claude/commands/sparc/coder.md +54 -54
  217. package/.claude/commands/sparc/debug.md +83 -83
  218. package/.claude/commands/sparc/debugger.md +54 -54
  219. package/.claude/commands/sparc/designer.md +53 -53
  220. package/.claude/commands/sparc/devops.md +109 -109
  221. package/.claude/commands/sparc/docs-writer.md +80 -80
  222. package/.claude/commands/sparc/documenter.md +54 -54
  223. package/.claude/commands/sparc/innovator.md +54 -54
  224. package/.claude/commands/sparc/integration.md +83 -83
  225. package/.claude/commands/sparc/mcp.md +117 -117
  226. package/.claude/commands/sparc/memory-manager.md +54 -54
  227. package/.claude/commands/sparc/optimizer.md +54 -54
  228. package/.claude/commands/sparc/orchestrator.md +131 -131
  229. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  230. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  231. package/.claude/commands/sparc/researcher.md +54 -54
  232. package/.claude/commands/sparc/reviewer.md +54 -54
  233. package/.claude/commands/sparc/security-review.md +80 -80
  234. package/.claude/commands/sparc/sparc-modes.md +174 -174
  235. package/.claude/commands/sparc/sparc.md +111 -111
  236. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  237. package/.claude/commands/sparc/supabase-admin.md +348 -348
  238. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  239. package/.claude/commands/sparc/tdd.md +54 -54
  240. package/.claude/commands/sparc/tester.md +54 -54
  241. package/.claude/commands/sparc/tutorial.md +79 -79
  242. package/.claude/commands/sparc/workflow-manager.md +54 -54
  243. package/.claude/commands/sparc.md +166 -166
  244. package/.claude/commands/stream-chain/pipeline.md +120 -120
  245. package/.claude/commands/stream-chain/run.md +69 -69
  246. package/.claude/commands/swarm/README.md +15 -15
  247. package/.claude/commands/swarm/analysis.md +95 -95
  248. package/.claude/commands/swarm/development.md +96 -96
  249. package/.claude/commands/swarm/examples.md +168 -168
  250. package/.claude/commands/swarm/maintenance.md +102 -102
  251. package/.claude/commands/swarm/optimization.md +117 -117
  252. package/.claude/commands/swarm/research.md +136 -136
  253. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  254. package/.claude/commands/swarm/swarm-background.md +8 -8
  255. package/.claude/commands/swarm/swarm-init.md +19 -19
  256. package/.claude/commands/swarm/swarm-modes.md +8 -8
  257. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  258. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  259. package/.claude/commands/swarm/swarm-status.md +8 -8
  260. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  261. package/.claude/commands/swarm/swarm.md +27 -27
  262. package/.claude/commands/swarm/testing.md +131 -131
  263. package/.claude/commands/training/README.md +9 -9
  264. package/.claude/commands/training/model-update.md +25 -25
  265. package/.claude/commands/training/neural-patterns.md +73 -73
  266. package/.claude/commands/training/neural-train.md +25 -25
  267. package/.claude/commands/training/pattern-learn.md +25 -25
  268. package/.claude/commands/training/specialization.md +62 -62
  269. package/.claude/commands/truth/start.md +142 -142
  270. package/.claude/commands/verify/check.md +49 -49
  271. package/.claude/commands/verify/start.md +127 -127
  272. package/.claude/commands/workflows/README.md +9 -9
  273. package/.claude/commands/workflows/development.md +77 -77
  274. package/.claude/commands/workflows/research.md +62 -62
  275. package/.claude/commands/workflows/workflow-create.md +25 -25
  276. package/.claude/commands/workflows/workflow-execute.md +25 -25
  277. package/.claude/commands/workflows/workflow-export.md +25 -25
  278. package/.claude/config/v3-dependency-optimization.json +265 -265
  279. package/.claude/config/v3-performance-targets.json +250 -250
  280. package/.claude/helpers/.helpers-version +1 -1
  281. package/.claude/helpers/README.md +96 -96
  282. package/.claude/helpers/adr-compliance.sh +186 -186
  283. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  284. package/.claude/helpers/auto-commit.sh +178 -178
  285. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  286. package/.claude/helpers/checkpoint-manager.sh +251 -251
  287. package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
  288. package/.claude/helpers/daemon-manager.sh +252 -252
  289. package/.claude/helpers/ddd-tracker.sh +144 -144
  290. package/.claude/helpers/github-safe.js +156 -156
  291. package/.claude/helpers/github-setup.sh +45 -45
  292. package/.claude/helpers/guidance-hook.sh +13 -13
  293. package/.claude/helpers/guidance-hooks.sh +102 -102
  294. package/.claude/helpers/health-monitor.sh +108 -108
  295. package/.claude/helpers/helpers.manifest.json +6 -5
  296. package/.claude/helpers/hook-handler.cjs +460 -460
  297. package/.claude/helpers/intelligence.cjs +1058 -1058
  298. package/.claude/helpers/learning-hooks.sh +329 -329
  299. package/.claude/helpers/learning-optimizer.sh +127 -127
  300. package/.claude/helpers/learning-service.mjs +1144 -1144
  301. package/.claude/helpers/memory.cjs +84 -84
  302. package/.claude/helpers/metrics-db.mjs +503 -503
  303. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  304. package/.claude/helpers/pattern-consolidator.sh +86 -86
  305. package/.claude/helpers/perf-worker.sh +160 -160
  306. package/.claude/helpers/quick-start.sh +19 -19
  307. package/.claude/helpers/router.cjs +62 -62
  308. package/.claude/helpers/security-scanner.sh +127 -127
  309. package/.claude/helpers/session.cjs +125 -125
  310. package/.claude/helpers/setup-mcp.sh +18 -18
  311. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  312. package/.claude/helpers/statusline.cjs +925 -925
  313. package/.claude/helpers/swarm-comms.sh +353 -353
  314. package/.claude/helpers/swarm-hooks.sh +761 -761
  315. package/.claude/helpers/swarm-monitor.sh +210 -210
  316. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  317. package/.claude/helpers/update-v3-progress.sh +165 -165
  318. package/.claude/helpers/v3-quick-status.sh +57 -57
  319. package/.claude/helpers/v3.sh +110 -110
  320. package/.claude/helpers/validate-v3-config.sh +215 -215
  321. package/.claude/helpers/worker-manager.sh +170 -170
  322. package/.claude/mcp.json +12 -12
  323. package/.claude/proven-config.json +1 -1
  324. package/.claude/settings.json +285 -285
  325. package/.claude/settings.json.bak +526 -526
  326. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  327. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  328. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  329. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  330. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  331. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  332. package/.claude/skills/browser/SKILL.md +204 -204
  333. package/.claude/skills/dual-mode/README.md +71 -71
  334. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  335. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  336. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  337. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  338. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  339. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  340. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  341. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  342. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  343. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  344. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  345. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  346. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  347. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  348. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  349. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  350. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  351. package/.claude/skills/skill-builder/SKILL.md +910 -910
  352. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  353. package/.claude/skills/stream-chain/SKILL.md +560 -560
  354. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  355. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  356. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  357. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  358. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  359. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  360. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  361. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  362. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  363. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  364. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  365. package/.claude/skills/verification-quality/SKILL.md +691 -691
  366. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  367. package/.claude/skills/worker-integration/SKILL.md +147 -147
  368. package/.claude/statusline-command.sh +176 -176
  369. package/.claude/statusline.mjs +109 -109
  370. package/.claude/statusline.sh +431 -431
  371. package/.claude/workflows/full-system-test.js +65 -65
  372. package/.claude/workflows/intelligence-system-hardening.js +120 -120
  373. package/.claude/workflows/plugin-contract-audit.js +91 -91
  374. package/.claude-plugin/README.md +720 -720
  375. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  376. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  377. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  378. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  379. package/.claude-plugin/hooks/hooks.json +77 -77
  380. package/.claude-plugin/marketplace.json +185 -185
  381. package/.claude-plugin/plugin.json +71 -71
  382. package/.claude-plugin/scripts/install.sh +234 -234
  383. package/.claude-plugin/scripts/ruflo-hook.cjs +166 -166
  384. package/.claude-plugin/scripts/ruflo-hook.sh +37 -37
  385. package/.claude-plugin/scripts/uninstall.sh +36 -36
  386. package/.claude-plugin/scripts/verify.sh +108 -108
  387. package/LICENSE +21 -21
  388. package/README.md +419 -419
  389. package/bin/cli.js +11 -11
  390. package/bin/npx-repair.js +7 -7
  391. package/bin/npx-safe-launch.js +9 -9
  392. package/package.json +185 -185
  393. package/v3/@claude-flow/cli/README.md +419 -419
  394. package/v3/@claude-flow/cli/bin/cli.js +314 -314
  395. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  396. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  397. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  398. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
  399. package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  400. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  401. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
  402. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  403. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +2 -0
  404. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +110 -2
  405. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  406. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  407. package/v3/@claude-flow/cli/dist/src/commands/init.js +94 -38
  408. package/v3/@claude-flow/cli/dist/src/commands/memory.js +85 -1
  409. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  410. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  411. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  412. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  413. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  414. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  415. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  416. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  417. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  418. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +1 -0
  419. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +12 -0
  420. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +1 -1
  421. package/v3/@claude-flow/cli/dist/src/funnel/index.js +1 -1
  422. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
  423. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  424. package/v3/@claude-flow/cli/dist/src/init/helper-signing.d.ts +8 -1
  425. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +9 -2
  426. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
  427. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +949 -949
  428. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  429. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  430. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +22 -22
  431. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.d.ts +10 -0
  432. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +139 -88
  433. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +18 -0
  434. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +539 -407
  435. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  436. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  437. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.d.ts +195 -0
  438. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.js +643 -0
  439. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.d.ts +206 -0
  440. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.js +626 -0
  441. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  442. package/v3/@claude-flow/cli/dist/src/services/event-stream.d.ts +25 -0
  443. package/v3/@claude-flow/cli/dist/src/services/event-stream.js +27 -0
  444. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  445. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.d.ts +16 -0
  446. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.js +34 -0
  447. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
  448. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.d.ts +22 -0
  449. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.js +45 -0
  450. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  451. package/v3/@claude-flow/cli/package.json +134 -133
  452. package/v3/@claude-flow/guidance/README.md +1195 -1195
  453. package/v3/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
  454. package/v3/@claude-flow/guidance/dist/adversarial.js +572 -0
  455. package/v3/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
  456. package/v3/@claude-flow/guidance/dist/analyzer.js +2587 -0
  457. package/v3/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
  458. package/v3/@claude-flow/guidance/dist/artifacts.js +356 -0
  459. package/v3/@claude-flow/guidance/dist/authority.d.ts +290 -0
  460. package/v3/@claude-flow/guidance/dist/authority.js +558 -0
  461. package/v3/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
  462. package/v3/@claude-flow/guidance/dist/capabilities.js +485 -0
  463. package/v3/@claude-flow/guidance/dist/coherence.d.ts +233 -0
  464. package/v3/@claude-flow/guidance/dist/coherence.js +372 -0
  465. package/v3/@claude-flow/guidance/dist/compiler.d.ts +87 -0
  466. package/v3/@claude-flow/guidance/dist/compiler.js +410 -0
  467. package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
  468. package/v3/@claude-flow/guidance/dist/conformance-kit.js +629 -0
  469. package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
  470. package/v3/@claude-flow/guidance/dist/continue-gate.js +353 -0
  471. package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
  472. package/v3/@claude-flow/guidance/dist/crypto-utils.js +24 -0
  473. package/v3/@claude-flow/guidance/dist/evolution.d.ts +282 -0
  474. package/v3/@claude-flow/guidance/dist/evolution.js +500 -0
  475. package/v3/@claude-flow/guidance/dist/gates.d.ts +79 -0
  476. package/v3/@claude-flow/guidance/dist/gates.js +302 -0
  477. package/v3/@claude-flow/guidance/dist/gateway.d.ts +206 -0
  478. package/v3/@claude-flow/guidance/dist/gateway.js +452 -0
  479. package/v3/@claude-flow/guidance/dist/generators.d.ts +153 -0
  480. package/v3/@claude-flow/guidance/dist/generators.js +682 -0
  481. package/v3/@claude-flow/guidance/dist/headless.d.ts +177 -0
  482. package/v3/@claude-flow/guidance/dist/headless.js +342 -0
  483. package/v3/@claude-flow/guidance/dist/hooks.d.ts +109 -0
  484. package/v3/@claude-flow/guidance/dist/hooks.js +347 -0
  485. package/v3/@claude-flow/guidance/dist/index.d.ts +205 -0
  486. package/v3/@claude-flow/guidance/dist/index.js +321 -0
  487. package/v3/@claude-flow/guidance/dist/ledger.d.ts +162 -0
  488. package/v3/@claude-flow/guidance/dist/ledger.js +375 -0
  489. package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
  490. package/v3/@claude-flow/guidance/dist/manifest-validator.js +838 -0
  491. package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
  492. package/v3/@claude-flow/guidance/dist/memory-gate.js +382 -0
  493. package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
  494. package/v3/@claude-flow/guidance/dist/meta-governance.js +348 -0
  495. package/v3/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
  496. package/v3/@claude-flow/guidance/dist/optimizer.js +329 -0
  497. package/v3/@claude-flow/guidance/dist/persistence.d.ts +189 -0
  498. package/v3/@claude-flow/guidance/dist/persistence.js +464 -0
  499. package/v3/@claude-flow/guidance/dist/proof.d.ts +185 -0
  500. package/v3/@claude-flow/guidance/dist/proof.js +238 -0
  501. package/v3/@claude-flow/guidance/dist/retriever.d.ts +172 -0
  502. package/v3/@claude-flow/guidance/dist/retriever.js +596 -0
  503. package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
  504. package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
  505. package/v3/@claude-flow/guidance/dist/temporal.d.ts +426 -0
  506. package/v3/@claude-flow/guidance/dist/temporal.js +658 -0
  507. package/v3/@claude-flow/guidance/dist/trust.d.ts +283 -0
  508. package/v3/@claude-flow/guidance/dist/trust.js +473 -0
  509. package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
  510. package/v3/@claude-flow/guidance/dist/truth-anchors.js +488 -0
  511. package/v3/@claude-flow/guidance/dist/types.d.ts +378 -0
  512. package/v3/@claude-flow/guidance/dist/types.js +10 -0
  513. package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
  514. package/v3/@claude-flow/guidance/dist/uncertainty.js +619 -0
  515. package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
  516. package/v3/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
  517. package/v3/@claude-flow/guidance/package.json +198 -198
  518. package/v3/@claude-flow/shared/README.md +323 -323
  519. package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +41 -0
  520. package/v3/@claude-flow/shared/dist/core/config/defaults.js +186 -0
  521. package/v3/@claude-flow/shared/dist/core/config/index.d.ts +8 -0
  522. package/v3/@claude-flow/shared/dist/core/config/index.js +12 -0
  523. package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +45 -0
  524. package/v3/@claude-flow/shared/dist/core/config/loader.js +238 -0
  525. package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +1728 -0
  526. package/v3/@claude-flow/shared/dist/core/config/schema.js +160 -0
  527. package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +92 -0
  528. package/v3/@claude-flow/shared/dist/core/config/validator.js +147 -0
  529. package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +31 -0
  530. package/v3/@claude-flow/shared/dist/core/event-bus.js +197 -0
  531. package/v3/@claude-flow/shared/dist/core/index.d.ts +15 -0
  532. package/v3/@claude-flow/shared/dist/core/index.js +19 -0
  533. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +200 -0
  534. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +6 -0
  535. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +310 -0
  536. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +7 -0
  537. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +224 -0
  538. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +46 -0
  539. package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +10 -0
  540. package/v3/@claude-flow/shared/dist/core/interfaces/index.js +15 -0
  541. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +298 -0
  542. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +7 -0
  543. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +185 -0
  544. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +6 -0
  545. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +35 -0
  546. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +101 -0
  547. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +60 -0
  548. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +166 -0
  549. package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +46 -0
  550. package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +64 -0
  551. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
  552. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +195 -0
  553. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +83 -0
  554. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +193 -0
  555. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +49 -0
  556. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +253 -0
  557. package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +282 -0
  558. package/v3/@claude-flow/shared/dist/events/domain-events.js +165 -0
  559. package/v3/@claude-flow/shared/dist/events/event-store.d.ts +126 -0
  560. package/v3/@claude-flow/shared/dist/events/event-store.js +427 -0
  561. package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +8 -0
  562. package/v3/@claude-flow/shared/dist/events/event-store.test.js +293 -0
  563. package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +10 -0
  564. package/v3/@claude-flow/shared/dist/events/example-usage.js +193 -0
  565. package/v3/@claude-flow/shared/dist/events/index.d.ts +21 -0
  566. package/v3/@claude-flow/shared/dist/events/index.js +22 -0
  567. package/v3/@claude-flow/shared/dist/events/projections.d.ts +177 -0
  568. package/v3/@claude-flow/shared/dist/events/projections.js +421 -0
  569. package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +82 -0
  570. package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +340 -0
  571. package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +101 -0
  572. package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +263 -0
  573. package/v3/@claude-flow/shared/dist/events.d.ts +80 -0
  574. package/v3/@claude-flow/shared/dist/events.js +249 -0
  575. package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +42 -0
  576. package/v3/@claude-flow/shared/dist/hooks/example-usage.js +351 -0
  577. package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +100 -0
  578. package/v3/@claude-flow/shared/dist/hooks/executor.js +267 -0
  579. package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +9 -0
  580. package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +322 -0
  581. package/v3/@claude-flow/shared/dist/hooks/index.d.ts +52 -0
  582. package/v3/@claude-flow/shared/dist/hooks/index.js +51 -0
  583. package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +133 -0
  584. package/v3/@claude-flow/shared/dist/hooks/registry.js +277 -0
  585. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +105 -0
  586. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +481 -0
  587. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +144 -0
  588. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +328 -0
  589. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +158 -0
  590. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +450 -0
  591. package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +17 -0
  592. package/v3/@claude-flow/shared/dist/hooks/safety/index.js +17 -0
  593. package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +234 -0
  594. package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +334 -0
  595. package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +163 -0
  596. package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +326 -0
  597. package/v3/@claude-flow/shared/dist/hooks/types.d.ts +267 -0
  598. package/v3/@claude-flow/shared/dist/hooks/types.js +62 -0
  599. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +9 -0
  600. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +93 -0
  601. package/v3/@claude-flow/shared/dist/index.d.ts +20 -0
  602. package/v3/@claude-flow/shared/dist/index.js +50 -0
  603. package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +98 -0
  604. package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +364 -0
  605. package/v3/@claude-flow/shared/dist/mcp/index.d.ts +69 -0
  606. package/v3/@claude-flow/shared/dist/mcp/index.js +84 -0
  607. package/v3/@claude-flow/shared/dist/mcp/server.d.ts +166 -0
  608. package/v3/@claude-flow/shared/dist/mcp/server.js +590 -0
  609. package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +136 -0
  610. package/v3/@claude-flow/shared/dist/mcp/session-manager.js +335 -0
  611. package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +178 -0
  612. package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +439 -0
  613. package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +104 -0
  614. package/v3/@claude-flow/shared/dist/mcp/transport/http.js +476 -0
  615. package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +102 -0
  616. package/v3/@claude-flow/shared/dist/mcp/transport/index.js +238 -0
  617. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +104 -0
  618. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +263 -0
  619. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +133 -0
  620. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +396 -0
  621. package/v3/@claude-flow/shared/dist/mcp/types.d.ts +436 -0
  622. package/v3/@claude-flow/shared/dist/mcp/types.js +54 -0
  623. package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +544 -0
  624. package/v3/@claude-flow/shared/dist/plugin-interface.js +23 -0
  625. package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +139 -0
  626. package/v3/@claude-flow/shared/dist/plugin-loader.js +434 -0
  627. package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +183 -0
  628. package/v3/@claude-flow/shared/dist/plugin-registry.js +457 -0
  629. package/v3/@claude-flow/shared/dist/plugins/index.d.ts +10 -0
  630. package/v3/@claude-flow/shared/dist/plugins/index.js +10 -0
  631. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
  632. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +241 -0
  633. package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +10 -0
  634. package/v3/@claude-flow/shared/dist/plugins/official/index.js +10 -0
  635. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +121 -0
  636. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +355 -0
  637. package/v3/@claude-flow/shared/dist/plugins/types.d.ts +93 -0
  638. package/v3/@claude-flow/shared/dist/plugins/types.js +9 -0
  639. package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +105 -0
  640. package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +206 -0
  641. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +132 -0
  642. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +233 -0
  643. package/v3/@claude-flow/shared/dist/resilience/index.d.ts +19 -0
  644. package/v3/@claude-flow/shared/dist/resilience/index.js +19 -0
  645. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +168 -0
  646. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +314 -0
  647. package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +91 -0
  648. package/v3/@claude-flow/shared/dist/resilience/retry.js +159 -0
  649. package/v3/@claude-flow/shared/dist/security/index.d.ts +10 -0
  650. package/v3/@claude-flow/shared/dist/security/index.js +12 -0
  651. package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +73 -0
  652. package/v3/@claude-flow/shared/dist/security/input-validation.js +201 -0
  653. package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +92 -0
  654. package/v3/@claude-flow/shared/dist/security/secure-random.js +142 -0
  655. package/v3/@claude-flow/shared/dist/services/index.d.ts +7 -0
  656. package/v3/@claude-flow/shared/dist/services/index.js +7 -0
  657. package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +124 -0
  658. package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +402 -0
  659. package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +137 -0
  660. package/v3/@claude-flow/shared/dist/types/agent.types.js +6 -0
  661. package/v3/@claude-flow/shared/dist/types/index.d.ts +11 -0
  662. package/v3/@claude-flow/shared/dist/types/index.js +17 -0
  663. package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +266 -0
  664. package/v3/@claude-flow/shared/dist/types/mcp.types.js +7 -0
  665. package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +236 -0
  666. package/v3/@claude-flow/shared/dist/types/memory.types.js +7 -0
  667. package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +186 -0
  668. package/v3/@claude-flow/shared/dist/types/swarm.types.js +65 -0
  669. package/v3/@claude-flow/shared/dist/types/task.types.d.ts +178 -0
  670. package/v3/@claude-flow/shared/dist/types/task.types.js +32 -0
  671. package/v3/@claude-flow/shared/dist/types.d.ts +197 -0
  672. package/v3/@claude-flow/shared/dist/types.js +21 -0
  673. package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +69 -0
  674. package/v3/@claude-flow/shared/dist/utils/secure-logger.js +208 -0
  675. package/v3/@claude-flow/shared/package.json +43 -43
  676. package/v3/README.md +493 -493
  677. package/.claude/security-scans/scan-all-standard.json +0 -321
  678. package/.claude/security-scans/scan-code-deep.json +0 -1209
  679. package/.claude/security-scans/scan-deps-full.json +0 -14
@@ -1,602 +1,602 @@
1
- ---
2
- name: security-manager
3
- description: Implements comprehensive security mechanisms for distributed consensus protocols
4
- ---
5
-
6
- # Consensus Security Manager
7
-
8
- Implements comprehensive security mechanisms for distributed consensus protocols with advanced threat detection.
9
-
10
- ## Core Responsibilities
11
-
12
- 1. **Cryptographic Infrastructure**: Deploy threshold cryptography and zero-knowledge proofs
13
- 2. **Attack Detection**: Identify Byzantine, Sybil, Eclipse, and DoS attacks
14
- 3. **Key Management**: Handle distributed key generation and rotation protocols
15
- 4. **Secure Communications**: Ensure TLS 1.3 encryption and message authentication
16
- 5. **Threat Mitigation**: Implement real-time security countermeasures
17
-
18
- ## Technical Implementation
19
-
20
- ### Threshold Signature System
21
- ```javascript
22
- class ThresholdSignatureSystem {
23
- constructor(threshold, totalParties, curveType = 'secp256k1') {
24
- this.t = threshold; // Minimum signatures required
25
- this.n = totalParties; // Total number of parties
26
- this.curve = this.initializeCurve(curveType);
27
- this.masterPublicKey = null;
28
- this.privateKeyShares = new Map();
29
- this.publicKeyShares = new Map();
30
- this.polynomial = null;
31
- }
32
-
33
- // Distributed Key Generation (DKG) Protocol
34
- async generateDistributedKeys() {
35
- // Phase 1: Each party generates secret polynomial
36
- const secretPolynomial = this.generateSecretPolynomial();
37
- const commitments = this.generateCommitments(secretPolynomial);
38
-
39
- // Phase 2: Broadcast commitments
40
- await this.broadcastCommitments(commitments);
41
-
42
- // Phase 3: Share secret values
43
- const secretShares = this.generateSecretShares(secretPolynomial);
44
- await this.distributeSecretShares(secretShares);
45
-
46
- // Phase 4: Verify received shares
47
- const validShares = await this.verifyReceivedShares();
48
-
49
- // Phase 5: Combine to create master keys
50
- this.masterPublicKey = this.combineMasterPublicKey(validShares);
51
-
52
- return {
53
- masterPublicKey: this.masterPublicKey,
54
- privateKeyShare: this.privateKeyShares.get(this.nodeId),
55
- publicKeyShares: this.publicKeyShares
56
- };
57
- }
58
-
59
- // Threshold Signature Creation
60
- async createThresholdSignature(message, signatories) {
61
- if (signatories.length < this.t) {
62
- throw new Error('Insufficient signatories for threshold');
63
- }
64
-
65
- const partialSignatures = [];
66
-
67
- // Each signatory creates partial signature
68
- for (const signatory of signatories) {
69
- const partialSig = await this.createPartialSignature(message, signatory);
70
- partialSignatures.push({
71
- signatory: signatory,
72
- signature: partialSig,
73
- publicKeyShare: this.publicKeyShares.get(signatory)
74
- });
75
- }
76
-
77
- // Verify partial signatures
78
- const validPartials = partialSignatures.filter(ps =>
79
- this.verifyPartialSignature(message, ps.signature, ps.publicKeyShare)
80
- );
81
-
82
- if (validPartials.length < this.t) {
83
- throw new Error('Insufficient valid partial signatures');
84
- }
85
-
86
- // Combine partial signatures using Lagrange interpolation
87
- return this.combinePartialSignatures(message, validPartials.slice(0, this.t));
88
- }
89
-
90
- // Signature Verification
91
- verifyThresholdSignature(message, signature) {
92
- return this.curve.verify(message, signature, this.masterPublicKey);
93
- }
94
-
95
- // Lagrange Interpolation for Signature Combination
96
- combinePartialSignatures(message, partialSignatures) {
97
- const lambda = this.computeLagrangeCoefficients(
98
- partialSignatures.map(ps => ps.signatory)
99
- );
100
-
101
- let combinedSignature = this.curve.infinity();
102
-
103
- for (let i = 0; i < partialSignatures.length; i++) {
104
- const weighted = this.curve.multiply(
105
- partialSignatures[i].signature,
106
- lambda[i]
107
- );
108
- combinedSignature = this.curve.add(combinedSignature, weighted);
109
- }
110
-
111
- return combinedSignature;
112
- }
113
- }
114
- ```
115
-
116
- ### Zero-Knowledge Proof System
117
- ```javascript
118
- class ZeroKnowledgeProofSystem {
119
- constructor() {
120
- this.curve = new EllipticCurve('secp256k1');
121
- this.hashFunction = 'sha256';
122
- this.proofCache = new Map();
123
- }
124
-
125
- // Prove knowledge of discrete logarithm (Schnorr proof)
126
- async proveDiscreteLog(secret, publicKey, challenge = null) {
127
- // Generate random nonce
128
- const nonce = this.generateSecureRandom();
129
- const commitment = this.curve.multiply(this.curve.generator, nonce);
130
-
131
- // Use provided challenge or generate Fiat-Shamir challenge
132
- const c = challenge || this.generateChallenge(commitment, publicKey);
133
-
134
- // Compute response
135
- const response = (nonce + c * secret) % this.curve.order;
136
-
137
- return {
138
- commitment: commitment,
139
- challenge: c,
140
- response: response
141
- };
142
- }
143
-
144
- // Verify discrete logarithm proof
145
- verifyDiscreteLogProof(proof, publicKey) {
146
- const { commitment, challenge, response } = proof;
147
-
148
- // Verify: g^response = commitment * publicKey^challenge
149
- const leftSide = this.curve.multiply(this.curve.generator, response);
150
- const rightSide = this.curve.add(
151
- commitment,
152
- this.curve.multiply(publicKey, challenge)
153
- );
154
-
155
- return this.curve.equals(leftSide, rightSide);
156
- }
157
-
158
- // Range proof for committed values
159
- async proveRange(value, commitment, min, max) {
160
- if (value < min || value > max) {
161
- throw new Error('Value outside specified range');
162
- }
163
-
164
- const bitLength = Math.ceil(Math.log2(max - min + 1));
165
- const bits = this.valueToBits(value - min, bitLength);
166
-
167
- const proofs = [];
168
- let currentCommitment = commitment;
169
-
170
- // Create proof for each bit
171
- for (let i = 0; i < bitLength; i++) {
172
- const bitProof = await this.proveBit(bits[i], currentCommitment);
173
- proofs.push(bitProof);
174
-
175
- // Update commitment for next bit
176
- currentCommitment = this.updateCommitmentForNextBit(currentCommitment, bits[i]);
177
- }
178
-
179
- return {
180
- bitProofs: proofs,
181
- range: { min, max },
182
- bitLength: bitLength
183
- };
184
- }
185
-
186
- // Bulletproof implementation for range proofs
187
- async createBulletproof(value, commitment, range) {
188
- const n = Math.ceil(Math.log2(range));
189
- const generators = this.generateBulletproofGenerators(n);
190
-
191
- // Inner product argument
192
- const innerProductProof = await this.createInnerProductProof(
193
- value, commitment, generators
194
- );
195
-
196
- return {
197
- type: 'bulletproof',
198
- commitment: commitment,
199
- proof: innerProductProof,
200
- generators: generators,
201
- range: range
202
- };
203
- }
204
- }
205
- ```
206
-
207
- ### Attack Detection System
208
- ```javascript
209
- class ConsensusSecurityMonitor {
210
- constructor() {
211
- this.attackDetectors = new Map();
212
- this.behaviorAnalyzer = new BehaviorAnalyzer();
213
- this.reputationSystem = new ReputationSystem();
214
- this.alertSystem = new SecurityAlertSystem();
215
- this.forensicLogger = new ForensicLogger();
216
- }
217
-
218
- // Byzantine Attack Detection
219
- async detectByzantineAttacks(consensusRound) {
220
- const participants = consensusRound.participants;
221
- const messages = consensusRound.messages;
222
-
223
- const anomalies = [];
224
-
225
- // Detect contradictory messages from same node
226
- const contradictions = this.detectContradictoryMessages(messages);
227
- if (contradictions.length > 0) {
228
- anomalies.push({
229
- type: 'CONTRADICTORY_MESSAGES',
230
- severity: 'HIGH',
231
- details: contradictions
232
- });
233
- }
234
-
235
- // Detect timing-based attacks
236
- const timingAnomalies = this.detectTimingAnomalies(messages);
237
- if (timingAnomalies.length > 0) {
238
- anomalies.push({
239
- type: 'TIMING_ATTACK',
240
- severity: 'MEDIUM',
241
- details: timingAnomalies
242
- });
243
- }
244
-
245
- // Detect collusion patterns
246
- const collusionPatterns = await this.detectCollusion(participants, messages);
247
- if (collusionPatterns.length > 0) {
248
- anomalies.push({
249
- type: 'COLLUSION_DETECTED',
250
- severity: 'HIGH',
251
- details: collusionPatterns
252
- });
253
- }
254
-
255
- // Update reputation scores
256
- for (const participant of participants) {
257
- await this.reputationSystem.updateReputation(
258
- participant,
259
- anomalies.filter(a => a.details.includes(participant))
260
- );
261
- }
262
-
263
- return anomalies;
264
- }
265
-
266
- // Sybil Attack Prevention
267
- async preventSybilAttacks(nodeJoinRequest) {
268
- const identityVerifiers = [
269
- this.verifyProofOfWork(nodeJoinRequest),
270
- this.verifyStakeProof(nodeJoinRequest),
271
- this.verifyIdentityCredentials(nodeJoinRequest),
272
- this.checkReputationHistory(nodeJoinRequest)
273
- ];
274
-
275
- const verificationResults = await Promise.all(identityVerifiers);
276
- const passedVerifications = verificationResults.filter(r => r.valid);
277
-
278
- // Require multiple verification methods
279
- const requiredVerifications = 2;
280
- if (passedVerifications.length < requiredVerifications) {
281
- throw new SecurityError('Insufficient identity verification for node join');
282
- }
283
-
284
- // Additional checks for suspicious patterns
285
- const suspiciousPatterns = await this.detectSybilPatterns(nodeJoinRequest);
286
- if (suspiciousPatterns.length > 0) {
287
- await this.alertSystem.raiseSybilAlert(nodeJoinRequest, suspiciousPatterns);
288
- throw new SecurityError('Potential Sybil attack detected');
289
- }
290
-
291
- return true;
292
- }
293
-
294
- // Eclipse Attack Protection
295
- async protectAgainstEclipseAttacks(nodeId, connectionRequests) {
296
- const diversityMetrics = this.analyzePeerDiversity(connectionRequests);
297
-
298
- // Check for geographic diversity
299
- if (diversityMetrics.geographicEntropy < 2.0) {
300
- await this.enforceGeographicDiversity(nodeId, connectionRequests);
301
- }
302
-
303
- // Check for network diversity (ASNs)
304
- if (diversityMetrics.networkEntropy < 1.5) {
305
- await this.enforceNetworkDiversity(nodeId, connectionRequests);
306
- }
307
-
308
- // Limit connections from single source
309
- const maxConnectionsPerSource = 3;
310
- const groupedConnections = this.groupConnectionsBySource(connectionRequests);
311
-
312
- for (const [source, connections] of groupedConnections) {
313
- if (connections.length > maxConnectionsPerSource) {
314
- await this.alertSystem.raiseEclipseAlert(nodeId, source, connections);
315
- // Randomly select subset of connections
316
- const allowedConnections = this.randomlySelectConnections(
317
- connections, maxConnectionsPerSource
318
- );
319
- this.blockExcessConnections(
320
- connections.filter(c => !allowedConnections.includes(c))
321
- );
322
- }
323
- }
324
- }
325
-
326
- // DoS Attack Mitigation
327
- async mitigateDoSAttacks(incomingRequests) {
328
- const rateLimiter = new AdaptiveRateLimiter();
329
- const requestAnalyzer = new RequestPatternAnalyzer();
330
-
331
- // Analyze request patterns for anomalies
332
- const anomalousRequests = await requestAnalyzer.detectAnomalies(incomingRequests);
333
-
334
- if (anomalousRequests.length > 0) {
335
- // Implement progressive response strategies
336
- const mitigationStrategies = [
337
- this.applyRateLimiting(anomalousRequests),
338
- this.implementPriorityQueuing(incomingRequests),
339
- this.activateCircuitBreakers(anomalousRequests),
340
- this.deployTemporaryBlacklisting(anomalousRequests)
341
- ];
342
-
343
- await Promise.all(mitigationStrategies);
344
- }
345
-
346
- return this.filterLegitimateRequests(incomingRequests, anomalousRequests);
347
- }
348
- }
349
- ```
350
-
351
- ### Secure Key Management
352
- ```javascript
353
- class SecureKeyManager {
354
- constructor() {
355
- this.keyStore = new EncryptedKeyStore();
356
- this.rotationScheduler = new KeyRotationScheduler();
357
- this.distributionProtocol = new SecureDistributionProtocol();
358
- this.backupSystem = new SecureBackupSystem();
359
- }
360
-
361
- // Distributed Key Generation
362
- async generateDistributedKey(participants, threshold) {
363
- const dkgProtocol = new DistributedKeyGeneration(threshold, participants.length);
364
-
365
- // Phase 1: Initialize DKG ceremony
366
- const ceremony = await dkgProtocol.initializeCeremony(participants);
367
-
368
- // Phase 2: Each participant contributes randomness
369
- const contributions = await this.collectContributions(participants, ceremony);
370
-
371
- // Phase 3: Verify contributions
372
- const validContributions = await this.verifyContributions(contributions);
373
-
374
- // Phase 4: Combine contributions to generate master key
375
- const masterKey = await dkgProtocol.combineMasterKey(validContributions);
376
-
377
- // Phase 5: Generate and distribute key shares
378
- const keyShares = await dkgProtocol.generateKeyShares(masterKey, participants);
379
-
380
- // Phase 6: Secure distribution of key shares
381
- await this.securelyDistributeShares(keyShares, participants);
382
-
383
- return {
384
- masterPublicKey: masterKey.publicKey,
385
- ceremony: ceremony,
386
- participants: participants
387
- };
388
- }
389
-
390
- // Key Rotation Protocol
391
- async rotateKeys(currentKeyId, participants) {
392
- // Generate new key using proactive secret sharing
393
- const newKey = await this.generateDistributedKey(participants, Math.floor(participants.length / 2) + 1);
394
-
395
- // Create transition period where both keys are valid
396
- const transitionPeriod = 24 * 60 * 60 * 1000; // 24 hours
397
- await this.scheduleKeyTransition(currentKeyId, newKey.masterPublicKey, transitionPeriod);
398
-
399
- // Notify all participants about key rotation
400
- await this.notifyKeyRotation(participants, newKey);
401
-
402
- // Gradually phase out old key
403
- setTimeout(async () => {
404
- await this.deactivateKey(currentKeyId);
405
- }, transitionPeriod);
406
-
407
- return newKey;
408
- }
409
-
410
- // Secure Key Backup and Recovery
411
- async backupKeyShares(keyShares, backupThreshold) {
412
- const backupShares = this.createBackupShares(keyShares, backupThreshold);
413
-
414
- // Encrypt backup shares with different passwords
415
- const encryptedBackups = await Promise.all(
416
- backupShares.map(async (share, index) => ({
417
- id: `backup_${index}`,
418
- encryptedShare: await this.encryptBackupShare(share, `password_${index}`),
419
- checksum: this.computeChecksum(share)
420
- }))
421
- );
422
-
423
- // Distribute backups to secure locations
424
- await this.distributeBackups(encryptedBackups);
425
-
426
- return encryptedBackups.map(backup => ({
427
- id: backup.id,
428
- checksum: backup.checksum
429
- }));
430
- }
431
-
432
- async recoverFromBackup(backupIds, passwords) {
433
- const backupShares = [];
434
-
435
- // Retrieve and decrypt backup shares
436
- for (let i = 0; i < backupIds.length; i++) {
437
- const encryptedBackup = await this.retrieveBackup(backupIds[i]);
438
- const decryptedShare = await this.decryptBackupShare(
439
- encryptedBackup.encryptedShare,
440
- passwords[i]
441
- );
442
-
443
- // Verify integrity
444
- const checksum = this.computeChecksum(decryptedShare);
445
- if (checksum !== encryptedBackup.checksum) {
446
- throw new Error(`Backup integrity check failed for ${backupIds[i]}`);
447
- }
448
-
449
- backupShares.push(decryptedShare);
450
- }
451
-
452
- // Reconstruct original key from backup shares
453
- return this.reconstructKeyFromBackup(backupShares);
454
- }
455
- }
456
- ```
457
-
458
- ## MCP Integration Hooks
459
-
460
- ### Security Monitoring Integration
461
- ```javascript
462
- // Store security metrics in memory
463
- await this.mcpTools.memory_usage({
464
- action: 'store',
465
- key: `security_metrics_${Date.now()}`,
466
- value: JSON.stringify({
467
- attacksDetected: this.attacksDetected,
468
- reputationScores: Array.from(this.reputationSystem.scores.entries()),
469
- keyRotationEvents: this.keyRotationHistory
470
- }),
471
- namespace: 'consensus_security',
472
- ttl: 86400000 // 24 hours
473
- });
474
-
475
- // Performance monitoring for security operations
476
- await this.mcpTools.metrics_collect({
477
- components: [
478
- 'signature_verification_time',
479
- 'zkp_generation_time',
480
- 'attack_detection_latency',
481
- 'key_rotation_overhead'
482
- ]
483
- });
484
- ```
485
-
486
- ### Neural Pattern Learning for Security
487
- ```javascript
488
- // Learn attack patterns
489
- await this.mcpTools.neural_patterns({
490
- action: 'learn',
491
- operation: 'attack_pattern_recognition',
492
- outcome: JSON.stringify({
493
- attackType: detectedAttack.type,
494
- patterns: detectedAttack.patterns,
495
- mitigation: appliedMitigation
496
- })
497
- });
498
-
499
- // Predict potential security threats
500
- const threatPrediction = await this.mcpTools.neural_predict({
501
- modelId: 'security_threat_model',
502
- input: JSON.stringify(currentSecurityMetrics)
503
- });
504
- ```
505
-
506
- ## Integration with Consensus Protocols
507
-
508
- ### Byzantine Consensus Security
509
- ```javascript
510
- class ByzantineConsensusSecurityWrapper {
511
- constructor(byzantineCoordinator, securityManager) {
512
- this.consensus = byzantineCoordinator;
513
- this.security = securityManager;
514
- }
515
-
516
- async secureConsensusRound(proposal) {
517
- // Pre-consensus security checks
518
- await this.security.validateProposal(proposal);
519
-
520
- // Execute consensus with security monitoring
521
- const result = await this.executeSecureConsensus(proposal);
522
-
523
- // Post-consensus security analysis
524
- await this.security.analyzeConsensusRound(result);
525
-
526
- return result;
527
- }
528
-
529
- async executeSecureConsensus(proposal) {
530
- // Sign proposal with threshold signature
531
- const signedProposal = await this.security.thresholdSignature.sign(proposal);
532
-
533
- // Monitor consensus execution for attacks
534
- const monitor = this.security.startConsensusMonitoring();
535
-
536
- try {
537
- // Execute Byzantine consensus
538
- const result = await this.consensus.initiateConsensus(signedProposal);
539
-
540
- // Verify result integrity
541
- await this.security.verifyConsensusResult(result);
542
-
543
- return result;
544
- } finally {
545
- monitor.stop();
546
- }
547
- }
548
- }
549
- ```
550
-
551
- ## Security Testing and Validation
552
-
553
- ### Penetration Testing Framework
554
- ```javascript
555
- class ConsensusPenetrationTester {
556
- constructor(securityManager) {
557
- this.security = securityManager;
558
- this.testScenarios = new Map();
559
- this.vulnerabilityDatabase = new VulnerabilityDatabase();
560
- }
561
-
562
- async runSecurityTests() {
563
- const testResults = [];
564
-
565
- // Test 1: Byzantine attack simulation
566
- testResults.push(await this.testByzantineAttack());
567
-
568
- // Test 2: Sybil attack simulation
569
- testResults.push(await this.testSybilAttack());
570
-
571
- // Test 3: Eclipse attack simulation
572
- testResults.push(await this.testEclipseAttack());
573
-
574
- // Test 4: DoS attack simulation
575
- testResults.push(await this.testDoSAttack());
576
-
577
- // Test 5: Cryptographic security tests
578
- testResults.push(await this.testCryptographicSecurity());
579
-
580
- return this.generateSecurityReport(testResults);
581
- }
582
-
583
- async testByzantineAttack() {
584
- // Simulate malicious nodes sending contradictory messages
585
- const maliciousNodes = this.createMaliciousNodes(3);
586
- const attack = new ByzantineAttackSimulator(maliciousNodes);
587
-
588
- const startTime = Date.now();
589
- const detectionTime = await this.security.detectByzantineAttacks(attack.execute());
590
- const endTime = Date.now();
591
-
592
- return {
593
- test: 'Byzantine Attack',
594
- detected: detectionTime !== null,
595
- detectionLatency: detectionTime ? endTime - startTime : null,
596
- mitigation: await this.security.mitigateByzantineAttack(attack)
597
- };
598
- }
599
- }
600
- ```
601
-
1
+ ---
2
+ name: security-manager
3
+ description: Implements comprehensive security mechanisms for distributed consensus protocols
4
+ ---
5
+
6
+ # Consensus Security Manager
7
+
8
+ Implements comprehensive security mechanisms for distributed consensus protocols with advanced threat detection.
9
+
10
+ ## Core Responsibilities
11
+
12
+ 1. **Cryptographic Infrastructure**: Deploy threshold cryptography and zero-knowledge proofs
13
+ 2. **Attack Detection**: Identify Byzantine, Sybil, Eclipse, and DoS attacks
14
+ 3. **Key Management**: Handle distributed key generation and rotation protocols
15
+ 4. **Secure Communications**: Ensure TLS 1.3 encryption and message authentication
16
+ 5. **Threat Mitigation**: Implement real-time security countermeasures
17
+
18
+ ## Technical Implementation
19
+
20
+ ### Threshold Signature System
21
+ ```javascript
22
+ class ThresholdSignatureSystem {
23
+ constructor(threshold, totalParties, curveType = 'secp256k1') {
24
+ this.t = threshold; // Minimum signatures required
25
+ this.n = totalParties; // Total number of parties
26
+ this.curve = this.initializeCurve(curveType);
27
+ this.masterPublicKey = null;
28
+ this.privateKeyShares = new Map();
29
+ this.publicKeyShares = new Map();
30
+ this.polynomial = null;
31
+ }
32
+
33
+ // Distributed Key Generation (DKG) Protocol
34
+ async generateDistributedKeys() {
35
+ // Phase 1: Each party generates secret polynomial
36
+ const secretPolynomial = this.generateSecretPolynomial();
37
+ const commitments = this.generateCommitments(secretPolynomial);
38
+
39
+ // Phase 2: Broadcast commitments
40
+ await this.broadcastCommitments(commitments);
41
+
42
+ // Phase 3: Share secret values
43
+ const secretShares = this.generateSecretShares(secretPolynomial);
44
+ await this.distributeSecretShares(secretShares);
45
+
46
+ // Phase 4: Verify received shares
47
+ const validShares = await this.verifyReceivedShares();
48
+
49
+ // Phase 5: Combine to create master keys
50
+ this.masterPublicKey = this.combineMasterPublicKey(validShares);
51
+
52
+ return {
53
+ masterPublicKey: this.masterPublicKey,
54
+ privateKeyShare: this.privateKeyShares.get(this.nodeId),
55
+ publicKeyShares: this.publicKeyShares
56
+ };
57
+ }
58
+
59
+ // Threshold Signature Creation
60
+ async createThresholdSignature(message, signatories) {
61
+ if (signatories.length < this.t) {
62
+ throw new Error('Insufficient signatories for threshold');
63
+ }
64
+
65
+ const partialSignatures = [];
66
+
67
+ // Each signatory creates partial signature
68
+ for (const signatory of signatories) {
69
+ const partialSig = await this.createPartialSignature(message, signatory);
70
+ partialSignatures.push({
71
+ signatory: signatory,
72
+ signature: partialSig,
73
+ publicKeyShare: this.publicKeyShares.get(signatory)
74
+ });
75
+ }
76
+
77
+ // Verify partial signatures
78
+ const validPartials = partialSignatures.filter(ps =>
79
+ this.verifyPartialSignature(message, ps.signature, ps.publicKeyShare)
80
+ );
81
+
82
+ if (validPartials.length < this.t) {
83
+ throw new Error('Insufficient valid partial signatures');
84
+ }
85
+
86
+ // Combine partial signatures using Lagrange interpolation
87
+ return this.combinePartialSignatures(message, validPartials.slice(0, this.t));
88
+ }
89
+
90
+ // Signature Verification
91
+ verifyThresholdSignature(message, signature) {
92
+ return this.curve.verify(message, signature, this.masterPublicKey);
93
+ }
94
+
95
+ // Lagrange Interpolation for Signature Combination
96
+ combinePartialSignatures(message, partialSignatures) {
97
+ const lambda = this.computeLagrangeCoefficients(
98
+ partialSignatures.map(ps => ps.signatory)
99
+ );
100
+
101
+ let combinedSignature = this.curve.infinity();
102
+
103
+ for (let i = 0; i < partialSignatures.length; i++) {
104
+ const weighted = this.curve.multiply(
105
+ partialSignatures[i].signature,
106
+ lambda[i]
107
+ );
108
+ combinedSignature = this.curve.add(combinedSignature, weighted);
109
+ }
110
+
111
+ return combinedSignature;
112
+ }
113
+ }
114
+ ```
115
+
116
+ ### Zero-Knowledge Proof System
117
+ ```javascript
118
+ class ZeroKnowledgeProofSystem {
119
+ constructor() {
120
+ this.curve = new EllipticCurve('secp256k1');
121
+ this.hashFunction = 'sha256';
122
+ this.proofCache = new Map();
123
+ }
124
+
125
+ // Prove knowledge of discrete logarithm (Schnorr proof)
126
+ async proveDiscreteLog(secret, publicKey, challenge = null) {
127
+ // Generate random nonce
128
+ const nonce = this.generateSecureRandom();
129
+ const commitment = this.curve.multiply(this.curve.generator, nonce);
130
+
131
+ // Use provided challenge or generate Fiat-Shamir challenge
132
+ const c = challenge || this.generateChallenge(commitment, publicKey);
133
+
134
+ // Compute response
135
+ const response = (nonce + c * secret) % this.curve.order;
136
+
137
+ return {
138
+ commitment: commitment,
139
+ challenge: c,
140
+ response: response
141
+ };
142
+ }
143
+
144
+ // Verify discrete logarithm proof
145
+ verifyDiscreteLogProof(proof, publicKey) {
146
+ const { commitment, challenge, response } = proof;
147
+
148
+ // Verify: g^response = commitment * publicKey^challenge
149
+ const leftSide = this.curve.multiply(this.curve.generator, response);
150
+ const rightSide = this.curve.add(
151
+ commitment,
152
+ this.curve.multiply(publicKey, challenge)
153
+ );
154
+
155
+ return this.curve.equals(leftSide, rightSide);
156
+ }
157
+
158
+ // Range proof for committed values
159
+ async proveRange(value, commitment, min, max) {
160
+ if (value < min || value > max) {
161
+ throw new Error('Value outside specified range');
162
+ }
163
+
164
+ const bitLength = Math.ceil(Math.log2(max - min + 1));
165
+ const bits = this.valueToBits(value - min, bitLength);
166
+
167
+ const proofs = [];
168
+ let currentCommitment = commitment;
169
+
170
+ // Create proof for each bit
171
+ for (let i = 0; i < bitLength; i++) {
172
+ const bitProof = await this.proveBit(bits[i], currentCommitment);
173
+ proofs.push(bitProof);
174
+
175
+ // Update commitment for next bit
176
+ currentCommitment = this.updateCommitmentForNextBit(currentCommitment, bits[i]);
177
+ }
178
+
179
+ return {
180
+ bitProofs: proofs,
181
+ range: { min, max },
182
+ bitLength: bitLength
183
+ };
184
+ }
185
+
186
+ // Bulletproof implementation for range proofs
187
+ async createBulletproof(value, commitment, range) {
188
+ const n = Math.ceil(Math.log2(range));
189
+ const generators = this.generateBulletproofGenerators(n);
190
+
191
+ // Inner product argument
192
+ const innerProductProof = await this.createInnerProductProof(
193
+ value, commitment, generators
194
+ );
195
+
196
+ return {
197
+ type: 'bulletproof',
198
+ commitment: commitment,
199
+ proof: innerProductProof,
200
+ generators: generators,
201
+ range: range
202
+ };
203
+ }
204
+ }
205
+ ```
206
+
207
+ ### Attack Detection System
208
+ ```javascript
209
+ class ConsensusSecurityMonitor {
210
+ constructor() {
211
+ this.attackDetectors = new Map();
212
+ this.behaviorAnalyzer = new BehaviorAnalyzer();
213
+ this.reputationSystem = new ReputationSystem();
214
+ this.alertSystem = new SecurityAlertSystem();
215
+ this.forensicLogger = new ForensicLogger();
216
+ }
217
+
218
+ // Byzantine Attack Detection
219
+ async detectByzantineAttacks(consensusRound) {
220
+ const participants = consensusRound.participants;
221
+ const messages = consensusRound.messages;
222
+
223
+ const anomalies = [];
224
+
225
+ // Detect contradictory messages from same node
226
+ const contradictions = this.detectContradictoryMessages(messages);
227
+ if (contradictions.length > 0) {
228
+ anomalies.push({
229
+ type: 'CONTRADICTORY_MESSAGES',
230
+ severity: 'HIGH',
231
+ details: contradictions
232
+ });
233
+ }
234
+
235
+ // Detect timing-based attacks
236
+ const timingAnomalies = this.detectTimingAnomalies(messages);
237
+ if (timingAnomalies.length > 0) {
238
+ anomalies.push({
239
+ type: 'TIMING_ATTACK',
240
+ severity: 'MEDIUM',
241
+ details: timingAnomalies
242
+ });
243
+ }
244
+
245
+ // Detect collusion patterns
246
+ const collusionPatterns = await this.detectCollusion(participants, messages);
247
+ if (collusionPatterns.length > 0) {
248
+ anomalies.push({
249
+ type: 'COLLUSION_DETECTED',
250
+ severity: 'HIGH',
251
+ details: collusionPatterns
252
+ });
253
+ }
254
+
255
+ // Update reputation scores
256
+ for (const participant of participants) {
257
+ await this.reputationSystem.updateReputation(
258
+ participant,
259
+ anomalies.filter(a => a.details.includes(participant))
260
+ );
261
+ }
262
+
263
+ return anomalies;
264
+ }
265
+
266
+ // Sybil Attack Prevention
267
+ async preventSybilAttacks(nodeJoinRequest) {
268
+ const identityVerifiers = [
269
+ this.verifyProofOfWork(nodeJoinRequest),
270
+ this.verifyStakeProof(nodeJoinRequest),
271
+ this.verifyIdentityCredentials(nodeJoinRequest),
272
+ this.checkReputationHistory(nodeJoinRequest)
273
+ ];
274
+
275
+ const verificationResults = await Promise.all(identityVerifiers);
276
+ const passedVerifications = verificationResults.filter(r => r.valid);
277
+
278
+ // Require multiple verification methods
279
+ const requiredVerifications = 2;
280
+ if (passedVerifications.length < requiredVerifications) {
281
+ throw new SecurityError('Insufficient identity verification for node join');
282
+ }
283
+
284
+ // Additional checks for suspicious patterns
285
+ const suspiciousPatterns = await this.detectSybilPatterns(nodeJoinRequest);
286
+ if (suspiciousPatterns.length > 0) {
287
+ await this.alertSystem.raiseSybilAlert(nodeJoinRequest, suspiciousPatterns);
288
+ throw new SecurityError('Potential Sybil attack detected');
289
+ }
290
+
291
+ return true;
292
+ }
293
+
294
+ // Eclipse Attack Protection
295
+ async protectAgainstEclipseAttacks(nodeId, connectionRequests) {
296
+ const diversityMetrics = this.analyzePeerDiversity(connectionRequests);
297
+
298
+ // Check for geographic diversity
299
+ if (diversityMetrics.geographicEntropy < 2.0) {
300
+ await this.enforceGeographicDiversity(nodeId, connectionRequests);
301
+ }
302
+
303
+ // Check for network diversity (ASNs)
304
+ if (diversityMetrics.networkEntropy < 1.5) {
305
+ await this.enforceNetworkDiversity(nodeId, connectionRequests);
306
+ }
307
+
308
+ // Limit connections from single source
309
+ const maxConnectionsPerSource = 3;
310
+ const groupedConnections = this.groupConnectionsBySource(connectionRequests);
311
+
312
+ for (const [source, connections] of groupedConnections) {
313
+ if (connections.length > maxConnectionsPerSource) {
314
+ await this.alertSystem.raiseEclipseAlert(nodeId, source, connections);
315
+ // Randomly select subset of connections
316
+ const allowedConnections = this.randomlySelectConnections(
317
+ connections, maxConnectionsPerSource
318
+ );
319
+ this.blockExcessConnections(
320
+ connections.filter(c => !allowedConnections.includes(c))
321
+ );
322
+ }
323
+ }
324
+ }
325
+
326
+ // DoS Attack Mitigation
327
+ async mitigateDoSAttacks(incomingRequests) {
328
+ const rateLimiter = new AdaptiveRateLimiter();
329
+ const requestAnalyzer = new RequestPatternAnalyzer();
330
+
331
+ // Analyze request patterns for anomalies
332
+ const anomalousRequests = await requestAnalyzer.detectAnomalies(incomingRequests);
333
+
334
+ if (anomalousRequests.length > 0) {
335
+ // Implement progressive response strategies
336
+ const mitigationStrategies = [
337
+ this.applyRateLimiting(anomalousRequests),
338
+ this.implementPriorityQueuing(incomingRequests),
339
+ this.activateCircuitBreakers(anomalousRequests),
340
+ this.deployTemporaryBlacklisting(anomalousRequests)
341
+ ];
342
+
343
+ await Promise.all(mitigationStrategies);
344
+ }
345
+
346
+ return this.filterLegitimateRequests(incomingRequests, anomalousRequests);
347
+ }
348
+ }
349
+ ```
350
+
351
+ ### Secure Key Management
352
+ ```javascript
353
+ class SecureKeyManager {
354
+ constructor() {
355
+ this.keyStore = new EncryptedKeyStore();
356
+ this.rotationScheduler = new KeyRotationScheduler();
357
+ this.distributionProtocol = new SecureDistributionProtocol();
358
+ this.backupSystem = new SecureBackupSystem();
359
+ }
360
+
361
+ // Distributed Key Generation
362
+ async generateDistributedKey(participants, threshold) {
363
+ const dkgProtocol = new DistributedKeyGeneration(threshold, participants.length);
364
+
365
+ // Phase 1: Initialize DKG ceremony
366
+ const ceremony = await dkgProtocol.initializeCeremony(participants);
367
+
368
+ // Phase 2: Each participant contributes randomness
369
+ const contributions = await this.collectContributions(participants, ceremony);
370
+
371
+ // Phase 3: Verify contributions
372
+ const validContributions = await this.verifyContributions(contributions);
373
+
374
+ // Phase 4: Combine contributions to generate master key
375
+ const masterKey = await dkgProtocol.combineMasterKey(validContributions);
376
+
377
+ // Phase 5: Generate and distribute key shares
378
+ const keyShares = await dkgProtocol.generateKeyShares(masterKey, participants);
379
+
380
+ // Phase 6: Secure distribution of key shares
381
+ await this.securelyDistributeShares(keyShares, participants);
382
+
383
+ return {
384
+ masterPublicKey: masterKey.publicKey,
385
+ ceremony: ceremony,
386
+ participants: participants
387
+ };
388
+ }
389
+
390
+ // Key Rotation Protocol
391
+ async rotateKeys(currentKeyId, participants) {
392
+ // Generate new key using proactive secret sharing
393
+ const newKey = await this.generateDistributedKey(participants, Math.floor(participants.length / 2) + 1);
394
+
395
+ // Create transition period where both keys are valid
396
+ const transitionPeriod = 24 * 60 * 60 * 1000; // 24 hours
397
+ await this.scheduleKeyTransition(currentKeyId, newKey.masterPublicKey, transitionPeriod);
398
+
399
+ // Notify all participants about key rotation
400
+ await this.notifyKeyRotation(participants, newKey);
401
+
402
+ // Gradually phase out old key
403
+ setTimeout(async () => {
404
+ await this.deactivateKey(currentKeyId);
405
+ }, transitionPeriod);
406
+
407
+ return newKey;
408
+ }
409
+
410
+ // Secure Key Backup and Recovery
411
+ async backupKeyShares(keyShares, backupThreshold) {
412
+ const backupShares = this.createBackupShares(keyShares, backupThreshold);
413
+
414
+ // Encrypt backup shares with different passwords
415
+ const encryptedBackups = await Promise.all(
416
+ backupShares.map(async (share, index) => ({
417
+ id: `backup_${index}`,
418
+ encryptedShare: await this.encryptBackupShare(share, `password_${index}`),
419
+ checksum: this.computeChecksum(share)
420
+ }))
421
+ );
422
+
423
+ // Distribute backups to secure locations
424
+ await this.distributeBackups(encryptedBackups);
425
+
426
+ return encryptedBackups.map(backup => ({
427
+ id: backup.id,
428
+ checksum: backup.checksum
429
+ }));
430
+ }
431
+
432
+ async recoverFromBackup(backupIds, passwords) {
433
+ const backupShares = [];
434
+
435
+ // Retrieve and decrypt backup shares
436
+ for (let i = 0; i < backupIds.length; i++) {
437
+ const encryptedBackup = await this.retrieveBackup(backupIds[i]);
438
+ const decryptedShare = await this.decryptBackupShare(
439
+ encryptedBackup.encryptedShare,
440
+ passwords[i]
441
+ );
442
+
443
+ // Verify integrity
444
+ const checksum = this.computeChecksum(decryptedShare);
445
+ if (checksum !== encryptedBackup.checksum) {
446
+ throw new Error(`Backup integrity check failed for ${backupIds[i]}`);
447
+ }
448
+
449
+ backupShares.push(decryptedShare);
450
+ }
451
+
452
+ // Reconstruct original key from backup shares
453
+ return this.reconstructKeyFromBackup(backupShares);
454
+ }
455
+ }
456
+ ```
457
+
458
+ ## MCP Integration Hooks
459
+
460
+ ### Security Monitoring Integration
461
+ ```javascript
462
+ // Store security metrics in memory
463
+ await this.mcpTools.memory_usage({
464
+ action: 'store',
465
+ key: `security_metrics_${Date.now()}`,
466
+ value: JSON.stringify({
467
+ attacksDetected: this.attacksDetected,
468
+ reputationScores: Array.from(this.reputationSystem.scores.entries()),
469
+ keyRotationEvents: this.keyRotationHistory
470
+ }),
471
+ namespace: 'consensus_security',
472
+ ttl: 86400000 // 24 hours
473
+ });
474
+
475
+ // Performance monitoring for security operations
476
+ await this.mcpTools.metrics_collect({
477
+ components: [
478
+ 'signature_verification_time',
479
+ 'zkp_generation_time',
480
+ 'attack_detection_latency',
481
+ 'key_rotation_overhead'
482
+ ]
483
+ });
484
+ ```
485
+
486
+ ### Neural Pattern Learning for Security
487
+ ```javascript
488
+ // Learn attack patterns
489
+ await this.mcpTools.neural_patterns({
490
+ action: 'learn',
491
+ operation: 'attack_pattern_recognition',
492
+ outcome: JSON.stringify({
493
+ attackType: detectedAttack.type,
494
+ patterns: detectedAttack.patterns,
495
+ mitigation: appliedMitigation
496
+ })
497
+ });
498
+
499
+ // Predict potential security threats
500
+ const threatPrediction = await this.mcpTools.neural_predict({
501
+ modelId: 'security_threat_model',
502
+ input: JSON.stringify(currentSecurityMetrics)
503
+ });
504
+ ```
505
+
506
+ ## Integration with Consensus Protocols
507
+
508
+ ### Byzantine Consensus Security
509
+ ```javascript
510
+ class ByzantineConsensusSecurityWrapper {
511
+ constructor(byzantineCoordinator, securityManager) {
512
+ this.consensus = byzantineCoordinator;
513
+ this.security = securityManager;
514
+ }
515
+
516
+ async secureConsensusRound(proposal) {
517
+ // Pre-consensus security checks
518
+ await this.security.validateProposal(proposal);
519
+
520
+ // Execute consensus with security monitoring
521
+ const result = await this.executeSecureConsensus(proposal);
522
+
523
+ // Post-consensus security analysis
524
+ await this.security.analyzeConsensusRound(result);
525
+
526
+ return result;
527
+ }
528
+
529
+ async executeSecureConsensus(proposal) {
530
+ // Sign proposal with threshold signature
531
+ const signedProposal = await this.security.thresholdSignature.sign(proposal);
532
+
533
+ // Monitor consensus execution for attacks
534
+ const monitor = this.security.startConsensusMonitoring();
535
+
536
+ try {
537
+ // Execute Byzantine consensus
538
+ const result = await this.consensus.initiateConsensus(signedProposal);
539
+
540
+ // Verify result integrity
541
+ await this.security.verifyConsensusResult(result);
542
+
543
+ return result;
544
+ } finally {
545
+ monitor.stop();
546
+ }
547
+ }
548
+ }
549
+ ```
550
+
551
+ ## Security Testing and Validation
552
+
553
+ ### Penetration Testing Framework
554
+ ```javascript
555
+ class ConsensusPenetrationTester {
556
+ constructor(securityManager) {
557
+ this.security = securityManager;
558
+ this.testScenarios = new Map();
559
+ this.vulnerabilityDatabase = new VulnerabilityDatabase();
560
+ }
561
+
562
+ async runSecurityTests() {
563
+ const testResults = [];
564
+
565
+ // Test 1: Byzantine attack simulation
566
+ testResults.push(await this.testByzantineAttack());
567
+
568
+ // Test 2: Sybil attack simulation
569
+ testResults.push(await this.testSybilAttack());
570
+
571
+ // Test 3: Eclipse attack simulation
572
+ testResults.push(await this.testEclipseAttack());
573
+
574
+ // Test 4: DoS attack simulation
575
+ testResults.push(await this.testDoSAttack());
576
+
577
+ // Test 5: Cryptographic security tests
578
+ testResults.push(await this.testCryptographicSecurity());
579
+
580
+ return this.generateSecurityReport(testResults);
581
+ }
582
+
583
+ async testByzantineAttack() {
584
+ // Simulate malicious nodes sending contradictory messages
585
+ const maliciousNodes = this.createMaliciousNodes(3);
586
+ const attack = new ByzantineAttackSimulator(maliciousNodes);
587
+
588
+ const startTime = Date.now();
589
+ const detectionTime = await this.security.detectByzantineAttacks(attack.execute());
590
+ const endTime = Date.now();
591
+
592
+ return {
593
+ test: 'Byzantine Attack',
594
+ detected: detectionTime !== null,
595
+ detectionLatency: detectionTime ? endTime - startTime : null,
596
+ mitigation: await this.security.mitigateByzantineAttack(attack)
597
+ };
598
+ }
599
+ }
600
+ ```
601
+
602
602
  This security manager provides comprehensive protection for distributed consensus protocols with enterprise-grade cryptographic security, advanced threat detection, and robust key management capabilities.