claude-flow 3.28.0 → 3.30.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 (690) 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/.LOCKED +2 -0
  281. package/.claude/helpers/.helpers-version +1 -1
  282. package/.claude/helpers/README.md +96 -96
  283. package/.claude/helpers/adr-compliance.sh +186 -186
  284. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  285. package/.claude/helpers/auto-commit.sh +178 -178
  286. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  287. package/.claude/helpers/checkpoint-manager.sh +251 -251
  288. package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
  289. package/.claude/helpers/daemon-manager.sh +252 -252
  290. package/.claude/helpers/ddd-tracker.sh +144 -144
  291. package/.claude/helpers/github-safe.js +156 -156
  292. package/.claude/helpers/github-setup.sh +45 -45
  293. package/.claude/helpers/guidance-hook.sh +13 -13
  294. package/.claude/helpers/guidance-hooks.sh +102 -102
  295. package/.claude/helpers/health-monitor.sh +108 -108
  296. package/.claude/helpers/helpers.manifest.json +6 -5
  297. package/.claude/helpers/hook-handler.cjs +564 -460
  298. package/.claude/helpers/intelligence.cjs +1058 -1058
  299. package/.claude/helpers/learning-hooks.sh +329 -329
  300. package/.claude/helpers/learning-optimizer.sh +127 -127
  301. package/.claude/helpers/learning-service.mjs +1144 -1144
  302. package/.claude/helpers/memory.cjs +84 -84
  303. package/.claude/helpers/metrics-db.mjs +503 -503
  304. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  305. package/.claude/helpers/pattern-consolidator.sh +86 -86
  306. package/.claude/helpers/perf-worker.sh +160 -160
  307. package/.claude/helpers/quick-start.sh +19 -19
  308. package/.claude/helpers/router.cjs +62 -62
  309. package/.claude/helpers/security-scanner.sh +127 -127
  310. package/.claude/helpers/session.cjs +125 -125
  311. package/.claude/helpers/setup-mcp.sh +18 -18
  312. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  313. package/.claude/helpers/statusline.cjs +999 -925
  314. package/.claude/helpers/swarm-comms.sh +353 -353
  315. package/.claude/helpers/swarm-hooks.sh +761 -761
  316. package/.claude/helpers/swarm-monitor.sh +210 -210
  317. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  318. package/.claude/helpers/update-v3-progress.sh +165 -165
  319. package/.claude/helpers/v3-quick-status.sh +57 -57
  320. package/.claude/helpers/v3.sh +110 -110
  321. package/.claude/helpers/validate-v3-config.sh +215 -215
  322. package/.claude/helpers/worker-manager.sh +170 -170
  323. package/.claude/mcp.json +12 -12
  324. package/.claude/proven-config.json +1 -1
  325. package/.claude/settings.json +285 -285
  326. package/.claude/settings.json.bak +526 -526
  327. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  328. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  329. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  330. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  331. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  332. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  333. package/.claude/skills/browser/SKILL.md +204 -204
  334. package/.claude/skills/dual-mode/README.md +71 -71
  335. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  336. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  337. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  338. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  339. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  340. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  341. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  342. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  343. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  344. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  345. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  346. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  347. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  348. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  349. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  350. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  351. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  352. package/.claude/skills/skill-builder/SKILL.md +910 -910
  353. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  354. package/.claude/skills/stream-chain/SKILL.md +560 -560
  355. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  356. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  357. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  358. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  359. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  360. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  361. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  362. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  363. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  364. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  365. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  366. package/.claude/skills/verification-quality/SKILL.md +691 -691
  367. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  368. package/.claude/skills/worker-integration/SKILL.md +147 -147
  369. package/.claude/statusline-command.sh +176 -176
  370. package/.claude/statusline.mjs +109 -109
  371. package/.claude/statusline.sh +431 -431
  372. package/.claude/workflows/full-system-test.js +65 -65
  373. package/.claude/workflows/intelligence-system-hardening.js +120 -120
  374. package/.claude/workflows/plugin-contract-audit.js +91 -91
  375. package/.claude-plugin/README.md +720 -720
  376. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  377. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  378. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  379. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  380. package/.claude-plugin/hooks/hooks.json +77 -77
  381. package/.claude-plugin/marketplace.json +185 -185
  382. package/.claude-plugin/plugin.json +71 -71
  383. package/.claude-plugin/scripts/install.sh +234 -234
  384. package/.claude-plugin/scripts/ruflo-hook.cjs +166 -166
  385. package/.claude-plugin/scripts/ruflo-hook.sh +37 -37
  386. package/.claude-plugin/scripts/uninstall.sh +36 -36
  387. package/.claude-plugin/scripts/verify.sh +108 -108
  388. package/LICENSE +21 -21
  389. package/README.md +419 -419
  390. package/bin/cli.js +11 -11
  391. package/bin/npx-repair.js +7 -7
  392. package/bin/npx-safe-launch.js +9 -9
  393. package/package.json +185 -185
  394. package/v3/@claude-flow/cli/README.md +419 -419
  395. package/v3/@claude-flow/cli/bin/cli.js +314 -314
  396. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  397. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  398. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  399. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
  400. package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  401. package/v3/@claude-flow/cli/dist/src/commands/announcements.d.ts +17 -0
  402. package/v3/@claude-flow/cli/dist/src/commands/announcements.js +0 -0
  403. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  404. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
  405. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  406. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +10 -5
  407. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +206 -7
  408. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  409. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  410. package/v3/@claude-flow/cli/dist/src/commands/index.js +4 -0
  411. package/v3/@claude-flow/cli/dist/src/commands/init.js +94 -38
  412. package/v3/@claude-flow/cli/dist/src/commands/memory.js +85 -1
  413. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  414. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  415. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  416. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  417. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  418. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  419. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  420. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  421. package/v3/@claude-flow/cli/dist/src/commands/spinner.d.ts +16 -0
  422. package/v3/@claude-flow/cli/dist/src/commands/spinner.js +329 -0
  423. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  424. package/v3/@claude-flow/cli/dist/src/funnel/consent.js +3 -0
  425. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +1 -0
  426. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +12 -0
  427. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +2 -1
  428. package/v3/@claude-flow/cli/dist/src/funnel/index.js +2 -1
  429. package/v3/@claude-flow/cli/dist/src/funnel/payout.d.ts +40 -0
  430. package/v3/@claude-flow/cli/dist/src/funnel/payout.js +60 -0
  431. package/v3/@claude-flow/cli/dist/src/funnel/types.d.ts +13 -1
  432. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
  433. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  434. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.js +17 -0
  435. package/v3/@claude-flow/cli/dist/src/init/helper-signing.d.ts +8 -1
  436. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +9 -2
  437. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
  438. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +955 -949
  439. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  440. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  441. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +22 -22
  442. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.d.ts +10 -0
  443. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +139 -88
  444. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +18 -0
  445. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +539 -407
  446. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  447. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  448. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.d.ts +195 -0
  449. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.js +643 -0
  450. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.d.ts +206 -0
  451. package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.js +626 -0
  452. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  453. package/v3/@claude-flow/cli/dist/src/services/event-stream.d.ts +25 -0
  454. package/v3/@claude-flow/cli/dist/src/services/event-stream.js +27 -0
  455. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  456. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.d.ts +16 -0
  457. package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.js +34 -0
  458. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
  459. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.d.ts +22 -0
  460. package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.js +45 -0
  461. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  462. package/v3/@claude-flow/cli/package.json +134 -133
  463. package/v3/@claude-flow/guidance/README.md +1195 -1195
  464. package/v3/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
  465. package/v3/@claude-flow/guidance/dist/adversarial.js +572 -0
  466. package/v3/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
  467. package/v3/@claude-flow/guidance/dist/analyzer.js +2587 -0
  468. package/v3/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
  469. package/v3/@claude-flow/guidance/dist/artifacts.js +356 -0
  470. package/v3/@claude-flow/guidance/dist/authority.d.ts +290 -0
  471. package/v3/@claude-flow/guidance/dist/authority.js +558 -0
  472. package/v3/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
  473. package/v3/@claude-flow/guidance/dist/capabilities.js +485 -0
  474. package/v3/@claude-flow/guidance/dist/coherence.d.ts +233 -0
  475. package/v3/@claude-flow/guidance/dist/coherence.js +372 -0
  476. package/v3/@claude-flow/guidance/dist/compiler.d.ts +87 -0
  477. package/v3/@claude-flow/guidance/dist/compiler.js +410 -0
  478. package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
  479. package/v3/@claude-flow/guidance/dist/conformance-kit.js +629 -0
  480. package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
  481. package/v3/@claude-flow/guidance/dist/continue-gate.js +353 -0
  482. package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
  483. package/v3/@claude-flow/guidance/dist/crypto-utils.js +24 -0
  484. package/v3/@claude-flow/guidance/dist/evolution.d.ts +282 -0
  485. package/v3/@claude-flow/guidance/dist/evolution.js +500 -0
  486. package/v3/@claude-flow/guidance/dist/gates.d.ts +79 -0
  487. package/v3/@claude-flow/guidance/dist/gates.js +302 -0
  488. package/v3/@claude-flow/guidance/dist/gateway.d.ts +206 -0
  489. package/v3/@claude-flow/guidance/dist/gateway.js +452 -0
  490. package/v3/@claude-flow/guidance/dist/generators.d.ts +153 -0
  491. package/v3/@claude-flow/guidance/dist/generators.js +682 -0
  492. package/v3/@claude-flow/guidance/dist/headless.d.ts +177 -0
  493. package/v3/@claude-flow/guidance/dist/headless.js +342 -0
  494. package/v3/@claude-flow/guidance/dist/hooks.d.ts +109 -0
  495. package/v3/@claude-flow/guidance/dist/hooks.js +347 -0
  496. package/v3/@claude-flow/guidance/dist/index.d.ts +205 -0
  497. package/v3/@claude-flow/guidance/dist/index.js +321 -0
  498. package/v3/@claude-flow/guidance/dist/ledger.d.ts +162 -0
  499. package/v3/@claude-flow/guidance/dist/ledger.js +375 -0
  500. package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
  501. package/v3/@claude-flow/guidance/dist/manifest-validator.js +838 -0
  502. package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
  503. package/v3/@claude-flow/guidance/dist/memory-gate.js +382 -0
  504. package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
  505. package/v3/@claude-flow/guidance/dist/meta-governance.js +348 -0
  506. package/v3/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
  507. package/v3/@claude-flow/guidance/dist/optimizer.js +329 -0
  508. package/v3/@claude-flow/guidance/dist/persistence.d.ts +189 -0
  509. package/v3/@claude-flow/guidance/dist/persistence.js +464 -0
  510. package/v3/@claude-flow/guidance/dist/proof.d.ts +185 -0
  511. package/v3/@claude-flow/guidance/dist/proof.js +238 -0
  512. package/v3/@claude-flow/guidance/dist/retriever.d.ts +172 -0
  513. package/v3/@claude-flow/guidance/dist/retriever.js +596 -0
  514. package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
  515. package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
  516. package/v3/@claude-flow/guidance/dist/temporal.d.ts +426 -0
  517. package/v3/@claude-flow/guidance/dist/temporal.js +658 -0
  518. package/v3/@claude-flow/guidance/dist/trust.d.ts +283 -0
  519. package/v3/@claude-flow/guidance/dist/trust.js +473 -0
  520. package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
  521. package/v3/@claude-flow/guidance/dist/truth-anchors.js +488 -0
  522. package/v3/@claude-flow/guidance/dist/types.d.ts +378 -0
  523. package/v3/@claude-flow/guidance/dist/types.js +10 -0
  524. package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
  525. package/v3/@claude-flow/guidance/dist/uncertainty.js +619 -0
  526. package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
  527. package/v3/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
  528. package/v3/@claude-flow/guidance/package.json +198 -198
  529. package/v3/@claude-flow/shared/README.md +323 -323
  530. package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +41 -0
  531. package/v3/@claude-flow/shared/dist/core/config/defaults.js +186 -0
  532. package/v3/@claude-flow/shared/dist/core/config/index.d.ts +8 -0
  533. package/v3/@claude-flow/shared/dist/core/config/index.js +12 -0
  534. package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +45 -0
  535. package/v3/@claude-flow/shared/dist/core/config/loader.js +238 -0
  536. package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +1728 -0
  537. package/v3/@claude-flow/shared/dist/core/config/schema.js +160 -0
  538. package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +92 -0
  539. package/v3/@claude-flow/shared/dist/core/config/validator.js +147 -0
  540. package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +31 -0
  541. package/v3/@claude-flow/shared/dist/core/event-bus.js +197 -0
  542. package/v3/@claude-flow/shared/dist/core/index.d.ts +15 -0
  543. package/v3/@claude-flow/shared/dist/core/index.js +19 -0
  544. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +200 -0
  545. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +6 -0
  546. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +310 -0
  547. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +7 -0
  548. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +224 -0
  549. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +46 -0
  550. package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +10 -0
  551. package/v3/@claude-flow/shared/dist/core/interfaces/index.js +15 -0
  552. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +298 -0
  553. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +7 -0
  554. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +185 -0
  555. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +6 -0
  556. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +35 -0
  557. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +101 -0
  558. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +60 -0
  559. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +166 -0
  560. package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +46 -0
  561. package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +64 -0
  562. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
  563. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +195 -0
  564. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +83 -0
  565. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +193 -0
  566. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +49 -0
  567. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +253 -0
  568. package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +282 -0
  569. package/v3/@claude-flow/shared/dist/events/domain-events.js +165 -0
  570. package/v3/@claude-flow/shared/dist/events/event-store.d.ts +126 -0
  571. package/v3/@claude-flow/shared/dist/events/event-store.js +427 -0
  572. package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +8 -0
  573. package/v3/@claude-flow/shared/dist/events/event-store.test.js +293 -0
  574. package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +10 -0
  575. package/v3/@claude-flow/shared/dist/events/example-usage.js +193 -0
  576. package/v3/@claude-flow/shared/dist/events/index.d.ts +21 -0
  577. package/v3/@claude-flow/shared/dist/events/index.js +22 -0
  578. package/v3/@claude-flow/shared/dist/events/projections.d.ts +177 -0
  579. package/v3/@claude-flow/shared/dist/events/projections.js +421 -0
  580. package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +82 -0
  581. package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +340 -0
  582. package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +101 -0
  583. package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +263 -0
  584. package/v3/@claude-flow/shared/dist/events.d.ts +80 -0
  585. package/v3/@claude-flow/shared/dist/events.js +249 -0
  586. package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +42 -0
  587. package/v3/@claude-flow/shared/dist/hooks/example-usage.js +351 -0
  588. package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +100 -0
  589. package/v3/@claude-flow/shared/dist/hooks/executor.js +267 -0
  590. package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +9 -0
  591. package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +322 -0
  592. package/v3/@claude-flow/shared/dist/hooks/index.d.ts +52 -0
  593. package/v3/@claude-flow/shared/dist/hooks/index.js +51 -0
  594. package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +133 -0
  595. package/v3/@claude-flow/shared/dist/hooks/registry.js +277 -0
  596. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +105 -0
  597. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +481 -0
  598. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +144 -0
  599. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +328 -0
  600. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +158 -0
  601. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +450 -0
  602. package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +17 -0
  603. package/v3/@claude-flow/shared/dist/hooks/safety/index.js +17 -0
  604. package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +234 -0
  605. package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +334 -0
  606. package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +163 -0
  607. package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +326 -0
  608. package/v3/@claude-flow/shared/dist/hooks/types.d.ts +267 -0
  609. package/v3/@claude-flow/shared/dist/hooks/types.js +62 -0
  610. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +9 -0
  611. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +93 -0
  612. package/v3/@claude-flow/shared/dist/index.d.ts +20 -0
  613. package/v3/@claude-flow/shared/dist/index.js +50 -0
  614. package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +98 -0
  615. package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +364 -0
  616. package/v3/@claude-flow/shared/dist/mcp/index.d.ts +69 -0
  617. package/v3/@claude-flow/shared/dist/mcp/index.js +84 -0
  618. package/v3/@claude-flow/shared/dist/mcp/server.d.ts +166 -0
  619. package/v3/@claude-flow/shared/dist/mcp/server.js +590 -0
  620. package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +136 -0
  621. package/v3/@claude-flow/shared/dist/mcp/session-manager.js +335 -0
  622. package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +178 -0
  623. package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +439 -0
  624. package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +104 -0
  625. package/v3/@claude-flow/shared/dist/mcp/transport/http.js +476 -0
  626. package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +102 -0
  627. package/v3/@claude-flow/shared/dist/mcp/transport/index.js +238 -0
  628. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +104 -0
  629. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +263 -0
  630. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +133 -0
  631. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +396 -0
  632. package/v3/@claude-flow/shared/dist/mcp/types.d.ts +436 -0
  633. package/v3/@claude-flow/shared/dist/mcp/types.js +54 -0
  634. package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +544 -0
  635. package/v3/@claude-flow/shared/dist/plugin-interface.js +23 -0
  636. package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +139 -0
  637. package/v3/@claude-flow/shared/dist/plugin-loader.js +434 -0
  638. package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +183 -0
  639. package/v3/@claude-flow/shared/dist/plugin-registry.js +457 -0
  640. package/v3/@claude-flow/shared/dist/plugins/index.d.ts +10 -0
  641. package/v3/@claude-flow/shared/dist/plugins/index.js +10 -0
  642. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
  643. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +241 -0
  644. package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +10 -0
  645. package/v3/@claude-flow/shared/dist/plugins/official/index.js +10 -0
  646. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +121 -0
  647. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +355 -0
  648. package/v3/@claude-flow/shared/dist/plugins/types.d.ts +93 -0
  649. package/v3/@claude-flow/shared/dist/plugins/types.js +9 -0
  650. package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +105 -0
  651. package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +206 -0
  652. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +132 -0
  653. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +233 -0
  654. package/v3/@claude-flow/shared/dist/resilience/index.d.ts +19 -0
  655. package/v3/@claude-flow/shared/dist/resilience/index.js +19 -0
  656. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +168 -0
  657. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +314 -0
  658. package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +91 -0
  659. package/v3/@claude-flow/shared/dist/resilience/retry.js +159 -0
  660. package/v3/@claude-flow/shared/dist/security/index.d.ts +10 -0
  661. package/v3/@claude-flow/shared/dist/security/index.js +12 -0
  662. package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +73 -0
  663. package/v3/@claude-flow/shared/dist/security/input-validation.js +201 -0
  664. package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +92 -0
  665. package/v3/@claude-flow/shared/dist/security/secure-random.js +142 -0
  666. package/v3/@claude-flow/shared/dist/services/index.d.ts +7 -0
  667. package/v3/@claude-flow/shared/dist/services/index.js +7 -0
  668. package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +124 -0
  669. package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +402 -0
  670. package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +137 -0
  671. package/v3/@claude-flow/shared/dist/types/agent.types.js +6 -0
  672. package/v3/@claude-flow/shared/dist/types/index.d.ts +11 -0
  673. package/v3/@claude-flow/shared/dist/types/index.js +17 -0
  674. package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +266 -0
  675. package/v3/@claude-flow/shared/dist/types/mcp.types.js +7 -0
  676. package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +236 -0
  677. package/v3/@claude-flow/shared/dist/types/memory.types.js +7 -0
  678. package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +186 -0
  679. package/v3/@claude-flow/shared/dist/types/swarm.types.js +65 -0
  680. package/v3/@claude-flow/shared/dist/types/task.types.d.ts +178 -0
  681. package/v3/@claude-flow/shared/dist/types/task.types.js +32 -0
  682. package/v3/@claude-flow/shared/dist/types.d.ts +197 -0
  683. package/v3/@claude-flow/shared/dist/types.js +21 -0
  684. package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +69 -0
  685. package/v3/@claude-flow/shared/dist/utils/secure-logger.js +208 -0
  686. package/v3/@claude-flow/shared/package.json +43 -43
  687. package/v3/README.md +493 -493
  688. package/.claude/security-scans/scan-all-standard.json +0 -321
  689. package/.claude/security-scans/scan-code-deep.json +0 -1209
  690. package/.claude/security-scans/scan-deps-full.json +0 -14
@@ -0,0 +1,267 @@
1
+ /**
2
+ * V3 Hooks System - Hook Executor
3
+ *
4
+ * Executes hooks in priority order with timeout handling and error recovery.
5
+ * Integrates with event bus for coordination and monitoring.
6
+ *
7
+ * @module v3/shared/hooks/executor
8
+ */
9
+ /**
10
+ * Hook executor implementation
11
+ */
12
+ export class HookExecutor {
13
+ registry;
14
+ eventBus;
15
+ constructor(registry, eventBus) {
16
+ this.registry = registry;
17
+ this.eventBus = eventBus;
18
+ }
19
+ /**
20
+ * Execute all hooks for an event
21
+ *
22
+ * @param event - Hook event type
23
+ * @param context - Hook context
24
+ * @param options - Execution options
25
+ * @returns Aggregated results
26
+ */
27
+ async execute(event, context, options = {}) {
28
+ const startTime = Date.now();
29
+ const results = [];
30
+ let aborted = false;
31
+ let finalContext = {};
32
+ // Get enabled hooks for this event
33
+ const hooks = this.registry.getHandlers(event, false);
34
+ // Emit pre-execution event
35
+ this.eventBus?.emit('hooks:pre-execute', {
36
+ event,
37
+ hookCount: hooks.length,
38
+ context,
39
+ });
40
+ // Execute hooks in priority order
41
+ for (const hook of hooks) {
42
+ if (aborted) {
43
+ break;
44
+ }
45
+ try {
46
+ const result = await this.executeSingleHook(hook.handler, context, hook.timeout || options.timeout);
47
+ results.push(result);
48
+ // Record execution statistics
49
+ this.registry.recordExecution(result.success, result.executionTime || 0);
50
+ // Merge context modifications
51
+ if (result.data) {
52
+ finalContext = { ...finalContext, ...result.data };
53
+ // Update context for next hooks
54
+ Object.assign(context, result.data);
55
+ }
56
+ // Check if we should abort
57
+ if (result.abort) {
58
+ aborted = true;
59
+ break;
60
+ }
61
+ // Check if we should stop the chain
62
+ if (result.continueChain === false) {
63
+ break;
64
+ }
65
+ // Check if we should stop on error
66
+ if (!result.success && !options.continueOnError) {
67
+ aborted = true;
68
+ break;
69
+ }
70
+ }
71
+ catch (error) {
72
+ const errorResult = {
73
+ success: false,
74
+ error: error instanceof Error ? error : new Error(String(error)),
75
+ continueChain: options.continueOnError,
76
+ };
77
+ results.push(errorResult);
78
+ this.registry.recordExecution(false, 0);
79
+ // Emit error event
80
+ this.eventBus?.emit('hooks:error', {
81
+ event,
82
+ hookId: hook.id,
83
+ error,
84
+ });
85
+ if (!options.continueOnError) {
86
+ aborted = true;
87
+ break;
88
+ }
89
+ }
90
+ }
91
+ const totalExecutionTime = Date.now() - startTime;
92
+ const hooksFailed = results.filter(r => !r.success).length;
93
+ // Build aggregated result
94
+ const aggregatedResult = {
95
+ success: hooksFailed === 0 && !aborted,
96
+ results: options.collectResults ? results : [],
97
+ totalExecutionTime,
98
+ hooksExecuted: results.length,
99
+ hooksFailed,
100
+ aborted,
101
+ finalContext,
102
+ };
103
+ // Emit post-execution event
104
+ this.eventBus?.emit('hooks:post-execute', {
105
+ event,
106
+ ...aggregatedResult,
107
+ });
108
+ return aggregatedResult;
109
+ }
110
+ /**
111
+ * Execute hooks with timeout
112
+ *
113
+ * @param event - Hook event type
114
+ * @param context - Hook context
115
+ * @param timeout - Timeout in ms
116
+ * @returns Aggregated results
117
+ */
118
+ async executeWithTimeout(event, context, timeout) {
119
+ return this.withTimeout(this.execute(event, context, { timeout }), timeout);
120
+ }
121
+ /**
122
+ * Execute a single hook with timeout and error handling
123
+ *
124
+ * @param handler - Hook handler function
125
+ * @param context - Hook context
126
+ * @param timeout - Optional timeout in ms
127
+ * @returns Hook result
128
+ */
129
+ async executeSingleHook(handler, context, timeout) {
130
+ const startTime = Date.now();
131
+ try {
132
+ let resultPromise = Promise.resolve(handler(context));
133
+ // Apply timeout if specified
134
+ if (timeout && timeout > 0) {
135
+ resultPromise = this.withTimeout(resultPromise, timeout);
136
+ }
137
+ const result = await resultPromise;
138
+ const executionTime = Date.now() - startTime;
139
+ return {
140
+ ...result,
141
+ executionTime,
142
+ };
143
+ }
144
+ catch (error) {
145
+ const executionTime = Date.now() - startTime;
146
+ return {
147
+ success: false,
148
+ error: error instanceof Error ? error : new Error(String(error)),
149
+ executionTime,
150
+ };
151
+ }
152
+ }
153
+ /**
154
+ * Execute multiple hooks in parallel
155
+ *
156
+ * @param events - Array of hook events
157
+ * @param contexts - Array of contexts (matched by index)
158
+ * @param options - Execution options
159
+ * @returns Array of aggregated results
160
+ */
161
+ async executeParallel(events, contexts, options = {}) {
162
+ if (events.length !== contexts.length) {
163
+ throw new Error('Events and contexts arrays must have same length');
164
+ }
165
+ const maxParallel = options.maxParallel || events.length;
166
+ const results = [];
167
+ // Execute in batches
168
+ for (let i = 0; i < events.length; i += maxParallel) {
169
+ const batch = events.slice(i, i + maxParallel);
170
+ const batchContexts = contexts.slice(i, i + maxParallel);
171
+ const batchResults = await Promise.allSettled(batch.map((event, index) => this.execute(event, batchContexts[index], options)));
172
+ for (const result of batchResults) {
173
+ if (result.status === 'fulfilled') {
174
+ results.push(result.value);
175
+ }
176
+ else {
177
+ // Create error result for rejected promises
178
+ results.push({
179
+ success: false,
180
+ results: [{
181
+ success: false,
182
+ error: result.reason instanceof Error
183
+ ? result.reason
184
+ : new Error(String(result.reason)),
185
+ }],
186
+ totalExecutionTime: 0,
187
+ hooksExecuted: 0,
188
+ hooksFailed: 1,
189
+ aborted: true,
190
+ });
191
+ }
192
+ }
193
+ }
194
+ return results;
195
+ }
196
+ /**
197
+ * Execute hooks sequentially with context chaining
198
+ *
199
+ * @param events - Array of hook events
200
+ * @param initialContext - Initial context
201
+ * @param options - Execution options
202
+ * @returns Final aggregated result with chained context
203
+ */
204
+ async executeSequential(events, initialContext, options = {}) {
205
+ const results = [];
206
+ let currentContext = { ...initialContext };
207
+ let totalExecutionTime = 0;
208
+ let totalHooksExecuted = 0;
209
+ let totalHooksFailed = 0;
210
+ let aborted = false;
211
+ for (const event of events) {
212
+ if (aborted) {
213
+ break;
214
+ }
215
+ const result = await this.execute(event, currentContext, options);
216
+ results.push(...result.results);
217
+ totalExecutionTime += result.totalExecutionTime;
218
+ totalHooksExecuted += result.hooksExecuted;
219
+ totalHooksFailed += result.hooksFailed;
220
+ // Merge context for next event
221
+ if (result.finalContext) {
222
+ currentContext = { ...currentContext, ...result.finalContext };
223
+ }
224
+ if (result.aborted || !result.success) {
225
+ aborted = true;
226
+ break;
227
+ }
228
+ }
229
+ return {
230
+ success: totalHooksFailed === 0 && !aborted,
231
+ results: options.collectResults ? results : [],
232
+ totalExecutionTime,
233
+ hooksExecuted: totalHooksExecuted,
234
+ hooksFailed: totalHooksFailed,
235
+ aborted,
236
+ finalContext: currentContext,
237
+ };
238
+ }
239
+ /**
240
+ * Wrap a promise with timeout
241
+ */
242
+ async withTimeout(promise, timeout) {
243
+ return Promise.race([
244
+ promise,
245
+ new Promise((_, reject) => setTimeout(() => reject(new Error(`Hook execution timeout after ${timeout}ms`)), timeout)),
246
+ ]);
247
+ }
248
+ /**
249
+ * Set event bus for coordination
250
+ */
251
+ setEventBus(eventBus) {
252
+ this.eventBus = eventBus;
253
+ }
254
+ /**
255
+ * Get hook registry
256
+ */
257
+ getRegistry() {
258
+ return this.registry;
259
+ }
260
+ }
261
+ /**
262
+ * Create a new hook executor
263
+ */
264
+ export function createHookExecutor(registry, eventBus) {
265
+ return new HookExecutor(registry, eventBus);
266
+ }
267
+ //# sourceMappingURL=executor.js.map
@@ -0,0 +1,9 @@
1
+ /**
2
+ * V3 Hooks System - Tests
3
+ *
4
+ * Comprehensive tests for hook registry and executor.
5
+ *
6
+ * @module v3/shared/hooks/hooks.test
7
+ */
8
+ export {};
9
+ //# sourceMappingURL=hooks.test.d.ts.map
@@ -0,0 +1,322 @@
1
+ /**
2
+ * V3 Hooks System - Tests
3
+ *
4
+ * Comprehensive tests for hook registry and executor.
5
+ *
6
+ * @module v3/shared/hooks/hooks.test
7
+ */
8
+ import { describe, it, expect, beforeEach, vi } from 'vitest';
9
+ import { createHookRegistry } from './registry.js';
10
+ import { createHookExecutor } from './executor.js';
11
+ import { HookEvent, HookPriority } from './types.js';
12
+ import { createEventBus } from '../core/event-bus.js';
13
+ describe('HookRegistry', () => {
14
+ let registry;
15
+ beforeEach(() => {
16
+ registry = createHookRegistry();
17
+ });
18
+ it('should register a hook', () => {
19
+ const handler = vi.fn();
20
+ const id = registry.register(HookEvent.PreToolUse, handler);
21
+ expect(id).toBeDefined();
22
+ expect(registry.has(id)).toBe(true);
23
+ expect(registry.count()).toBe(1);
24
+ });
25
+ it('should unregister a hook', () => {
26
+ const handler = vi.fn();
27
+ const id = registry.register(HookEvent.PreToolUse, handler);
28
+ const result = registry.unregister(id);
29
+ expect(result).toBe(true);
30
+ expect(registry.has(id)).toBe(false);
31
+ expect(registry.count()).toBe(0);
32
+ });
33
+ it('should return false when unregistering non-existent hook', () => {
34
+ const result = registry.unregister('non-existent');
35
+ expect(result).toBe(false);
36
+ });
37
+ it('should get handlers sorted by priority', () => {
38
+ const handler1 = vi.fn();
39
+ const handler2 = vi.fn();
40
+ const handler3 = vi.fn();
41
+ registry.register(HookEvent.PreToolUse, handler1, HookPriority.Normal);
42
+ registry.register(HookEvent.PreToolUse, handler2, HookPriority.High);
43
+ registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
44
+ const handlers = registry.getHandlers(HookEvent.PreToolUse);
45
+ expect(handlers).toHaveLength(3);
46
+ expect(handlers[0].handler).toBe(handler2); // High priority first
47
+ expect(handlers[1].handler).toBe(handler1); // Normal priority second
48
+ expect(handlers[2].handler).toBe(handler3); // Low priority last
49
+ });
50
+ it('should filter disabled hooks', () => {
51
+ const handler = vi.fn();
52
+ const id = registry.register(HookEvent.PreToolUse, handler, HookPriority.Normal, {
53
+ enabled: false,
54
+ });
55
+ const handlers = registry.getHandlers(HookEvent.PreToolUse);
56
+ const allHandlers = registry.getHandlers(HookEvent.PreToolUse, true);
57
+ expect(handlers).toHaveLength(0);
58
+ expect(allHandlers).toHaveLength(1);
59
+ });
60
+ it('should enable and disable hooks', () => {
61
+ const handler = vi.fn();
62
+ const id = registry.register(HookEvent.PreToolUse, handler);
63
+ registry.disable(id);
64
+ expect(registry.getHandlers(HookEvent.PreToolUse)).toHaveLength(0);
65
+ registry.enable(id);
66
+ expect(registry.getHandlers(HookEvent.PreToolUse)).toHaveLength(1);
67
+ });
68
+ it('should list hooks with filters', () => {
69
+ registry.register(HookEvent.PreToolUse, vi.fn(), HookPriority.High);
70
+ registry.register(HookEvent.PostToolUse, vi.fn(), HookPriority.Normal);
71
+ registry.register(HookEvent.PreEdit, vi.fn(), HookPriority.Low);
72
+ const allHooks = registry.listHooks();
73
+ expect(allHooks).toHaveLength(3);
74
+ const preToolHooks = registry.listHooks({ event: HookEvent.PreToolUse });
75
+ expect(preToolHooks).toHaveLength(1);
76
+ const highPriorityHooks = registry.listHooks({ minPriority: HookPriority.Normal });
77
+ expect(highPriorityHooks).toHaveLength(2);
78
+ });
79
+ it('should get event types', () => {
80
+ registry.register(HookEvent.PreToolUse, vi.fn());
81
+ registry.register(HookEvent.PostToolUse, vi.fn());
82
+ registry.register(HookEvent.PreEdit, vi.fn());
83
+ const eventTypes = registry.getEventTypes();
84
+ expect(eventTypes).toContain(HookEvent.PreToolUse);
85
+ expect(eventTypes).toContain(HookEvent.PostToolUse);
86
+ expect(eventTypes).toContain(HookEvent.PreEdit);
87
+ });
88
+ it('should track statistics', () => {
89
+ registry.register(HookEvent.PreToolUse, vi.fn());
90
+ registry.register(HookEvent.PostToolUse, vi.fn());
91
+ registry.recordExecution(true, 10);
92
+ registry.recordExecution(true, 20);
93
+ registry.recordExecution(false, 5);
94
+ const stats = registry.getStats();
95
+ expect(stats.totalHooks).toBe(2);
96
+ expect(stats.totalExecutions).toBe(3);
97
+ expect(stats.totalFailures).toBe(1);
98
+ expect(stats.avgExecutionTime).toBe((10 + 20 + 5) / 3);
99
+ });
100
+ it('should reset statistics', () => {
101
+ registry.recordExecution(true, 10);
102
+ registry.resetStats();
103
+ const stats = registry.getStats();
104
+ expect(stats.totalExecutions).toBe(0);
105
+ expect(stats.totalFailures).toBe(0);
106
+ });
107
+ it('should clear all hooks', () => {
108
+ registry.register(HookEvent.PreToolUse, vi.fn());
109
+ registry.register(HookEvent.PostToolUse, vi.fn());
110
+ registry.clear();
111
+ expect(registry.count()).toBe(0);
112
+ expect(registry.getEventTypes()).toHaveLength(0);
113
+ });
114
+ });
115
+ describe('HookExecutor', () => {
116
+ let registry;
117
+ let executor;
118
+ let eventBus;
119
+ beforeEach(() => {
120
+ registry = createHookRegistry();
121
+ eventBus = createEventBus();
122
+ executor = createHookExecutor(registry, eventBus);
123
+ });
124
+ it('should execute single hook successfully', async () => {
125
+ const handler = vi.fn(async () => ({ success: true }));
126
+ registry.register(HookEvent.PreToolUse, handler);
127
+ const context = {
128
+ event: HookEvent.PreToolUse,
129
+ timestamp: new Date(),
130
+ tool: { name: 'Read', parameters: { path: 'file.ts' } },
131
+ };
132
+ const result = await executor.execute(HookEvent.PreToolUse, context);
133
+ expect(result.success).toBe(true);
134
+ expect(result.hooksExecuted).toBe(1);
135
+ expect(result.hooksFailed).toBe(0);
136
+ expect(handler).toHaveBeenCalledWith(context);
137
+ });
138
+ it('should execute multiple hooks in priority order', async () => {
139
+ const executionOrder = [];
140
+ const handler1 = vi.fn(async () => {
141
+ executionOrder.push(1);
142
+ return { success: true };
143
+ });
144
+ const handler2 = vi.fn(async () => {
145
+ executionOrder.push(2);
146
+ return { success: true };
147
+ });
148
+ const handler3 = vi.fn(async () => {
149
+ executionOrder.push(3);
150
+ return { success: true };
151
+ });
152
+ registry.register(HookEvent.PreToolUse, handler1, HookPriority.Normal);
153
+ registry.register(HookEvent.PreToolUse, handler2, HookPriority.High);
154
+ registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
155
+ const context = {
156
+ event: HookEvent.PreToolUse,
157
+ timestamp: new Date(),
158
+ };
159
+ await executor.execute(HookEvent.PreToolUse, context);
160
+ expect(executionOrder).toEqual([2, 1, 3]); // High, Normal, Low
161
+ });
162
+ it('should handle hook errors gracefully', async () => {
163
+ const handler1 = vi.fn(async () => ({ success: true }));
164
+ const handler2 = vi.fn(async () => {
165
+ throw new Error('Hook failed');
166
+ });
167
+ const handler3 = vi.fn(async () => ({ success: true }));
168
+ registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
169
+ registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
170
+ registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
171
+ const context = {
172
+ event: HookEvent.PreToolUse,
173
+ timestamp: new Date(),
174
+ };
175
+ const result = await executor.execute(HookEvent.PreToolUse, context, {
176
+ continueOnError: true,
177
+ });
178
+ expect(result.hooksExecuted).toBe(3);
179
+ expect(result.hooksFailed).toBe(1);
180
+ expect(handler3).toHaveBeenCalled(); // Should continue despite error
181
+ });
182
+ it('should abort on error when continueOnError is false', async () => {
183
+ const handler1 = vi.fn(async () => ({ success: true }));
184
+ const handler2 = vi.fn(async () => {
185
+ throw new Error('Hook failed');
186
+ });
187
+ const handler3 = vi.fn(async () => ({ success: true }));
188
+ registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
189
+ registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
190
+ registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
191
+ const context = {
192
+ event: HookEvent.PreToolUse,
193
+ timestamp: new Date(),
194
+ };
195
+ const result = await executor.execute(HookEvent.PreToolUse, context);
196
+ expect(result.aborted).toBe(true);
197
+ expect(result.hooksExecuted).toBe(2);
198
+ expect(handler3).not.toHaveBeenCalled(); // Should not execute after error
199
+ });
200
+ it('should abort when hook returns abort flag', async () => {
201
+ const handler1 = vi.fn(async () => ({ success: true }));
202
+ const handler2 = vi.fn(async () => ({ success: true, abort: true }));
203
+ const handler3 = vi.fn(async () => ({ success: true }));
204
+ registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
205
+ registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
206
+ registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
207
+ const context = {
208
+ event: HookEvent.PreToolUse,
209
+ timestamp: new Date(),
210
+ };
211
+ const result = await executor.execute(HookEvent.PreToolUse, context);
212
+ expect(result.aborted).toBe(true);
213
+ expect(result.hooksExecuted).toBe(2);
214
+ expect(handler3).not.toHaveBeenCalled();
215
+ });
216
+ it('should merge context modifications', async () => {
217
+ const handler1 = vi.fn(async () => ({
218
+ success: true,
219
+ data: { metadata: { modified: true } },
220
+ }));
221
+ const handler2 = vi.fn(async (context) => {
222
+ expect(context.metadata?.modified).toBe(true);
223
+ return { success: true };
224
+ });
225
+ registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
226
+ registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
227
+ const context = {
228
+ event: HookEvent.PreToolUse,
229
+ timestamp: new Date(),
230
+ };
231
+ const result = await executor.execute(HookEvent.PreToolUse, context);
232
+ expect(result.finalContext?.metadata).toEqual({ modified: true });
233
+ });
234
+ it('should handle timeout', async () => {
235
+ const handler = vi.fn(async () => {
236
+ await new Promise(resolve => setTimeout(resolve, 200));
237
+ return { success: true };
238
+ });
239
+ registry.register(HookEvent.PreToolUse, handler);
240
+ const context = {
241
+ event: HookEvent.PreToolUse,
242
+ timestamp: new Date(),
243
+ };
244
+ const result = await executor.executeWithTimeout(HookEvent.PreToolUse, context, 100);
245
+ expect(result.success).toBe(false);
246
+ expect(result.hooksFailed).toBe(1);
247
+ });
248
+ it('should execute hooks in parallel', async () => {
249
+ const handler1 = vi.fn(async () => ({ success: true }));
250
+ const handler2 = vi.fn(async () => ({ success: true }));
251
+ registry.register(HookEvent.PreToolUse, handler1);
252
+ registry.register(HookEvent.PostToolUse, handler2);
253
+ const contexts = [
254
+ { event: HookEvent.PreToolUse, timestamp: new Date() },
255
+ { event: HookEvent.PostToolUse, timestamp: new Date() },
256
+ ];
257
+ const results = await executor.executeParallel([HookEvent.PreToolUse, HookEvent.PostToolUse], contexts);
258
+ expect(results).toHaveLength(2);
259
+ expect(results[0].success).toBe(true);
260
+ expect(results[1].success).toBe(true);
261
+ });
262
+ it('should execute hooks sequentially with context chaining', async () => {
263
+ const handler1 = vi.fn(async () => ({
264
+ success: true,
265
+ data: { metadata: { step: 1 } },
266
+ }));
267
+ const handler2 = vi.fn(async () => ({
268
+ success: true,
269
+ data: { metadata: { step: 2 } },
270
+ }));
271
+ registry.register(HookEvent.PreToolUse, handler1);
272
+ registry.register(HookEvent.PostToolUse, handler2);
273
+ const initialContext = {
274
+ event: HookEvent.PreToolUse,
275
+ timestamp: new Date(),
276
+ };
277
+ const result = await executor.executeSequential([HookEvent.PreToolUse, HookEvent.PostToolUse], initialContext);
278
+ expect(result.success).toBe(true);
279
+ expect(result.hooksExecuted).toBe(2);
280
+ });
281
+ it('should emit events to event bus', async () => {
282
+ const preExecuteHandler = vi.fn();
283
+ const postExecuteHandler = vi.fn();
284
+ eventBus.on('hooks:pre-execute', preExecuteHandler);
285
+ eventBus.on('hooks:post-execute', postExecuteHandler);
286
+ const handler = vi.fn(async () => ({ success: true }));
287
+ registry.register(HookEvent.PreToolUse, handler);
288
+ const context = {
289
+ event: HookEvent.PreToolUse,
290
+ timestamp: new Date(),
291
+ };
292
+ await executor.execute(HookEvent.PreToolUse, context);
293
+ expect(preExecuteHandler).toHaveBeenCalled();
294
+ expect(postExecuteHandler).toHaveBeenCalled();
295
+ });
296
+ it('should skip disabled hooks', async () => {
297
+ const handler = vi.fn(async () => ({ success: true }));
298
+ const id = registry.register(HookEvent.PreToolUse, handler, HookPriority.Normal, {
299
+ enabled: false,
300
+ });
301
+ const context = {
302
+ event: HookEvent.PreToolUse,
303
+ timestamp: new Date(),
304
+ };
305
+ const result = await executor.execute(HookEvent.PreToolUse, context);
306
+ expect(result.hooksExecuted).toBe(0);
307
+ expect(handler).not.toHaveBeenCalled();
308
+ });
309
+ it('should record execution statistics', async () => {
310
+ const handler = vi.fn(async () => ({ success: true }));
311
+ registry.register(HookEvent.PreToolUse, handler);
312
+ const context = {
313
+ event: HookEvent.PreToolUse,
314
+ timestamp: new Date(),
315
+ };
316
+ await executor.execute(HookEvent.PreToolUse, context);
317
+ const stats = registry.getStats();
318
+ expect(stats.totalExecutions).toBe(1);
319
+ expect(stats.totalFailures).toBe(0);
320
+ });
321
+ });
322
+ //# sourceMappingURL=hooks.test.js.map
@@ -0,0 +1,52 @@
1
+ /**
2
+ * V3 Hooks System - Main Export
3
+ *
4
+ * Provides extensible hook points for tool execution, file operations,
5
+ * and session lifecycle events. Integrates with event bus for coordination.
6
+ *
7
+ * Example usage:
8
+ *
9
+ * ```typescript
10
+ * import { createHookRegistry, createHookExecutor, HookEvent, HookPriority } from '@claude-flow/shared/hooks';
11
+ *
12
+ * const registry = createHookRegistry();
13
+ * const executor = createHookExecutor(registry, eventBus);
14
+ *
15
+ * // Register a hook
16
+ * const hookId = registry.register(
17
+ * HookEvent.PreToolUse,
18
+ * async (context) => {
19
+ * console.log('Before tool use:', context.tool?.name);
20
+ * return { success: true };
21
+ * },
22
+ * HookPriority.High
23
+ * );
24
+ *
25
+ * // Execute hooks
26
+ * const result = await executor.execute(
27
+ * HookEvent.PreToolUse,
28
+ * {
29
+ * event: HookEvent.PreToolUse,
30
+ * timestamp: new Date(),
31
+ * tool: { name: 'Read', parameters: { path: 'file.ts' } }
32
+ * }
33
+ * );
34
+ *
35
+ * // Unregister hook
36
+ * registry.unregister(hookId);
37
+ * ```
38
+ *
39
+ * @module v3/shared/hooks
40
+ */
41
+ export type { HookContext, HookResult, HookHandler, HookDefinition, HookStats, HookExecutionOptions, ToolInfo, CommandInfo, FileOperationInfo, SessionInfo, AgentInfo, TaskInfo, MemoryInfo, ErrorInfo, } from './types.js';
42
+ export { HookEvent, HookPriority, } from './types.js';
43
+ export { HookRegistry, createHookRegistry, } from './registry.js';
44
+ export type { AggregatedHookResult, } from './executor.js';
45
+ export { HookExecutor, createHookExecutor, } from './executor.js';
46
+ export { TaskHooksManager, createTaskHooksManager, } from './task-hooks.js';
47
+ export type { PreTaskHookResult, PostTaskHookResult, AgentSuggestion, TaskPattern, TaskOutcome, LearningUpdate, } from './task-hooks.js';
48
+ export { SessionHooksManager, createSessionHooksManager, InMemorySessionStorage, } from './session-hooks.js';
49
+ export type { SessionState, SessionEndHookResult, SessionRestoreHookResult, SessionSummary, SessionStorage, } from './session-hooks.js';
50
+ export { BashSafetyHook, createBashSafetyHook, FileOrganizationHook, createFileOrganizationHook, GitCommitHook, createGitCommitHook, } from './safety/index.js';
51
+ export type { BashSafetyResult, CommandRisk, FileOrganizationResult, FormatterRecommendation, LinterRecommendation, OrganizationIssue, GitCommitResult, CommitType, CommitValidationIssue, } from './safety/index.js';
52
+ //# sourceMappingURL=index.d.ts.map