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
@@ -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