@claude-flow/shared 3.0.0-alpha.1

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 (541) hide show
  1. package/.agentic-flow/intelligence.json +16 -0
  2. package/README.md +323 -0
  3. package/__tests__/coverage/base.css +224 -0
  4. package/__tests__/coverage/block-navigation.js +87 -0
  5. package/__tests__/coverage/coverage-final.json +50 -0
  6. package/__tests__/coverage/favicon.png +0 -0
  7. package/__tests__/coverage/index.html +326 -0
  8. package/__tests__/coverage/lcov-report/base.css +224 -0
  9. package/__tests__/coverage/lcov-report/block-navigation.js +87 -0
  10. package/__tests__/coverage/lcov-report/favicon.png +0 -0
  11. package/__tests__/coverage/lcov-report/index.html +326 -0
  12. package/__tests__/coverage/lcov-report/prettify.css +1 -0
  13. package/__tests__/coverage/lcov-report/prettify.js +2 -0
  14. package/__tests__/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  15. package/__tests__/coverage/lcov-report/sorter.js +210 -0
  16. package/__tests__/coverage/lcov-report/src/core/config/defaults.ts.html +706 -0
  17. package/__tests__/coverage/lcov-report/src/core/config/index.html +161 -0
  18. package/__tests__/coverage/lcov-report/src/core/config/loader.ts.html +898 -0
  19. package/__tests__/coverage/lcov-report/src/core/config/schema.ts.html +649 -0
  20. package/__tests__/coverage/lcov-report/src/core/config/validator.ts.html +712 -0
  21. package/__tests__/coverage/lcov-report/src/core/event-bus.ts.html +793 -0
  22. package/__tests__/coverage/lcov-report/src/core/index.html +116 -0
  23. package/__tests__/coverage/lcov-report/src/core/interfaces/event.interface.ts.html +886 -0
  24. package/__tests__/coverage/lcov-report/src/core/interfaces/index.html +116 -0
  25. package/__tests__/coverage/lcov-report/src/core/orchestrator/event-coordinator.ts.html +451 -0
  26. package/__tests__/coverage/lcov-report/src/core/orchestrator/health-monitor.ts.html +727 -0
  27. package/__tests__/coverage/lcov-report/src/core/orchestrator/index.html +176 -0
  28. package/__tests__/coverage/lcov-report/src/core/orchestrator/lifecycle-manager.ts.html +874 -0
  29. package/__tests__/coverage/lcov-report/src/core/orchestrator/session-manager.ts.html +922 -0
  30. package/__tests__/coverage/lcov-report/src/core/orchestrator/task-manager.ts.html +1036 -0
  31. package/__tests__/coverage/lcov-report/src/events/domain-events.ts.html +1837 -0
  32. package/__tests__/coverage/lcov-report/src/events/event-store.ts.html +1849 -0
  33. package/__tests__/coverage/lcov-report/src/events/example-usage.ts.html +964 -0
  34. package/__tests__/coverage/lcov-report/src/events/index.html +176 -0
  35. package/__tests__/coverage/lcov-report/src/events/projections.ts.html +1768 -0
  36. package/__tests__/coverage/lcov-report/src/events/state-reconstructor.ts.html +1132 -0
  37. package/__tests__/coverage/lcov-report/src/events.ts.html +1186 -0
  38. package/__tests__/coverage/lcov-report/src/hooks/example-usage.ts.html +1582 -0
  39. package/__tests__/coverage/lcov-report/src/hooks/executor.ts.html +1222 -0
  40. package/__tests__/coverage/lcov-report/src/hooks/index.html +191 -0
  41. package/__tests__/coverage/lcov-report/src/hooks/registry.ts.html +1084 -0
  42. package/__tests__/coverage/lcov-report/src/hooks/safety/bash-safety.ts.html +1897 -0
  43. package/__tests__/coverage/lcov-report/src/hooks/safety/file-organization.ts.html +1504 -0
  44. package/__tests__/coverage/lcov-report/src/hooks/safety/git-commit.ts.html +1954 -0
  45. package/__tests__/coverage/lcov-report/src/hooks/safety/index.html +146 -0
  46. package/__tests__/coverage/lcov-report/src/hooks/session-hooks.ts.html +1762 -0
  47. package/__tests__/coverage/lcov-report/src/hooks/task-hooks.ts.html +1624 -0
  48. package/__tests__/coverage/lcov-report/src/hooks/types.ts.html +1156 -0
  49. package/__tests__/coverage/lcov-report/src/index.html +176 -0
  50. package/__tests__/coverage/lcov-report/src/mcp/connection-pool.ts.html +1399 -0
  51. package/__tests__/coverage/lcov-report/src/mcp/index.html +176 -0
  52. package/__tests__/coverage/lcov-report/src/mcp/server.ts.html +2407 -0
  53. package/__tests__/coverage/lcov-report/src/mcp/session-manager.ts.html +1369 -0
  54. package/__tests__/coverage/lcov-report/src/mcp/tool-registry.ts.html +1783 -0
  55. package/__tests__/coverage/lcov-report/src/mcp/transport/http.ts.html +1756 -0
  56. package/__tests__/coverage/lcov-report/src/mcp/transport/index.html +146 -0
  57. package/__tests__/coverage/lcov-report/src/mcp/transport/stdio.ts.html +1057 -0
  58. package/__tests__/coverage/lcov-report/src/mcp/transport/websocket.ts.html +1537 -0
  59. package/__tests__/coverage/lcov-report/src/mcp/types.ts.html +1780 -0
  60. package/__tests__/coverage/lcov-report/src/plugin-interface.ts.html +2074 -0
  61. package/__tests__/coverage/lcov-report/src/plugin-loader.ts.html +1999 -0
  62. package/__tests__/coverage/lcov-report/src/plugin-registry.ts.html +1897 -0
  63. package/__tests__/coverage/lcov-report/src/plugins/official/hive-mind-plugin.ts.html +1075 -0
  64. package/__tests__/coverage/lcov-report/src/plugins/official/index.html +131 -0
  65. package/__tests__/coverage/lcov-report/src/plugins/official/maestro-plugin.ts.html +1609 -0
  66. package/__tests__/coverage/lcov-report/src/resilience/bulkhead.ts.html +916 -0
  67. package/__tests__/coverage/lcov-report/src/resilience/circuit-breaker.ts.html +1063 -0
  68. package/__tests__/coverage/lcov-report/src/resilience/index.html +161 -0
  69. package/__tests__/coverage/lcov-report/src/resilience/rate-limiter.ts.html +1345 -0
  70. package/__tests__/coverage/lcov-report/src/resilience/retry.ts.html +757 -0
  71. package/__tests__/coverage/lcov-report/src/security/index.html +131 -0
  72. package/__tests__/coverage/lcov-report/src/security/input-validation.ts.html +880 -0
  73. package/__tests__/coverage/lcov-report/src/security/secure-random.ts.html +562 -0
  74. package/__tests__/coverage/lcov-report/src/types/index.html +131 -0
  75. package/__tests__/coverage/lcov-report/src/types/swarm.types.ts.html +850 -0
  76. package/__tests__/coverage/lcov-report/src/types/task.types.ts.html +700 -0
  77. package/__tests__/coverage/lcov-report/src/types.ts.html +1186 -0
  78. package/__tests__/coverage/lcov-report/src/utils/index.html +116 -0
  79. package/__tests__/coverage/lcov-report/src/utils/secure-logger.ts.html +856 -0
  80. package/__tests__/coverage/lcov.info +19877 -0
  81. package/__tests__/coverage/prettify.css +1 -0
  82. package/__tests__/coverage/prettify.js +2 -0
  83. package/__tests__/coverage/sort-arrow-sprite.png +0 -0
  84. package/__tests__/coverage/sorter.js +210 -0
  85. package/__tests__/coverage/src/core/config/defaults.ts.html +706 -0
  86. package/__tests__/coverage/src/core/config/index.html +161 -0
  87. package/__tests__/coverage/src/core/config/loader.ts.html +898 -0
  88. package/__tests__/coverage/src/core/config/schema.ts.html +649 -0
  89. package/__tests__/coverage/src/core/config/validator.ts.html +712 -0
  90. package/__tests__/coverage/src/core/event-bus.ts.html +793 -0
  91. package/__tests__/coverage/src/core/index.html +116 -0
  92. package/__tests__/coverage/src/core/interfaces/event.interface.ts.html +886 -0
  93. package/__tests__/coverage/src/core/interfaces/index.html +116 -0
  94. package/__tests__/coverage/src/core/orchestrator/event-coordinator.ts.html +451 -0
  95. package/__tests__/coverage/src/core/orchestrator/health-monitor.ts.html +727 -0
  96. package/__tests__/coverage/src/core/orchestrator/index.html +176 -0
  97. package/__tests__/coverage/src/core/orchestrator/lifecycle-manager.ts.html +874 -0
  98. package/__tests__/coverage/src/core/orchestrator/session-manager.ts.html +922 -0
  99. package/__tests__/coverage/src/core/orchestrator/task-manager.ts.html +1036 -0
  100. package/__tests__/coverage/src/events/domain-events.ts.html +1837 -0
  101. package/__tests__/coverage/src/events/event-store.ts.html +1849 -0
  102. package/__tests__/coverage/src/events/example-usage.ts.html +964 -0
  103. package/__tests__/coverage/src/events/index.html +176 -0
  104. package/__tests__/coverage/src/events/projections.ts.html +1768 -0
  105. package/__tests__/coverage/src/events/state-reconstructor.ts.html +1132 -0
  106. package/__tests__/coverage/src/events.ts.html +1186 -0
  107. package/__tests__/coverage/src/hooks/example-usage.ts.html +1582 -0
  108. package/__tests__/coverage/src/hooks/executor.ts.html +1222 -0
  109. package/__tests__/coverage/src/hooks/index.html +191 -0
  110. package/__tests__/coverage/src/hooks/registry.ts.html +1084 -0
  111. package/__tests__/coverage/src/hooks/safety/bash-safety.ts.html +1897 -0
  112. package/__tests__/coverage/src/hooks/safety/file-organization.ts.html +1504 -0
  113. package/__tests__/coverage/src/hooks/safety/git-commit.ts.html +1954 -0
  114. package/__tests__/coverage/src/hooks/safety/index.html +146 -0
  115. package/__tests__/coverage/src/hooks/session-hooks.ts.html +1762 -0
  116. package/__tests__/coverage/src/hooks/task-hooks.ts.html +1624 -0
  117. package/__tests__/coverage/src/hooks/types.ts.html +1156 -0
  118. package/__tests__/coverage/src/index.html +176 -0
  119. package/__tests__/coverage/src/mcp/connection-pool.ts.html +1399 -0
  120. package/__tests__/coverage/src/mcp/index.html +176 -0
  121. package/__tests__/coverage/src/mcp/server.ts.html +2407 -0
  122. package/__tests__/coverage/src/mcp/session-manager.ts.html +1369 -0
  123. package/__tests__/coverage/src/mcp/tool-registry.ts.html +1783 -0
  124. package/__tests__/coverage/src/mcp/transport/http.ts.html +1756 -0
  125. package/__tests__/coverage/src/mcp/transport/index.html +146 -0
  126. package/__tests__/coverage/src/mcp/transport/stdio.ts.html +1057 -0
  127. package/__tests__/coverage/src/mcp/transport/websocket.ts.html +1537 -0
  128. package/__tests__/coverage/src/mcp/types.ts.html +1780 -0
  129. package/__tests__/coverage/src/plugin-interface.ts.html +2074 -0
  130. package/__tests__/coverage/src/plugin-loader.ts.html +1999 -0
  131. package/__tests__/coverage/src/plugin-registry.ts.html +1897 -0
  132. package/__tests__/coverage/src/plugins/official/hive-mind-plugin.ts.html +1075 -0
  133. package/__tests__/coverage/src/plugins/official/index.html +131 -0
  134. package/__tests__/coverage/src/plugins/official/maestro-plugin.ts.html +1609 -0
  135. package/__tests__/coverage/src/resilience/bulkhead.ts.html +916 -0
  136. package/__tests__/coverage/src/resilience/circuit-breaker.ts.html +1063 -0
  137. package/__tests__/coverage/src/resilience/index.html +161 -0
  138. package/__tests__/coverage/src/resilience/rate-limiter.ts.html +1345 -0
  139. package/__tests__/coverage/src/resilience/retry.ts.html +757 -0
  140. package/__tests__/coverage/src/security/index.html +131 -0
  141. package/__tests__/coverage/src/security/input-validation.ts.html +880 -0
  142. package/__tests__/coverage/src/security/secure-random.ts.html +562 -0
  143. package/__tests__/coverage/src/types/index.html +131 -0
  144. package/__tests__/coverage/src/types/swarm.types.ts.html +850 -0
  145. package/__tests__/coverage/src/types/task.types.ts.html +700 -0
  146. package/__tests__/coverage/src/types.ts.html +1186 -0
  147. package/__tests__/coverage/src/utils/index.html +116 -0
  148. package/__tests__/coverage/src/utils/secure-logger.ts.html +856 -0
  149. package/__tests__/hooks/bash-safety.test.ts +289 -0
  150. package/__tests__/hooks/file-organization.test.ts +335 -0
  151. package/__tests__/hooks/git-commit.test.ts +336 -0
  152. package/__tests__/hooks/index.ts +23 -0
  153. package/__tests__/hooks/session-hooks.test.ts +357 -0
  154. package/__tests__/hooks/task-hooks.test.ts +193 -0
  155. package/dist/core/config/defaults.d.ts +41 -0
  156. package/dist/core/config/defaults.d.ts.map +1 -0
  157. package/dist/core/config/defaults.js +186 -0
  158. package/dist/core/config/defaults.js.map +1 -0
  159. package/dist/core/config/index.d.ts +8 -0
  160. package/dist/core/config/index.d.ts.map +1 -0
  161. package/dist/core/config/index.js +12 -0
  162. package/dist/core/config/index.js.map +1 -0
  163. package/dist/core/config/loader.d.ts +45 -0
  164. package/dist/core/config/loader.d.ts.map +1 -0
  165. package/dist/core/config/loader.js +222 -0
  166. package/dist/core/config/loader.js.map +1 -0
  167. package/dist/core/config/schema.d.ts +1134 -0
  168. package/dist/core/config/schema.d.ts.map +1 -0
  169. package/dist/core/config/schema.js +158 -0
  170. package/dist/core/config/schema.js.map +1 -0
  171. package/dist/core/config/validator.d.ts +92 -0
  172. package/dist/core/config/validator.d.ts.map +1 -0
  173. package/dist/core/config/validator.js +147 -0
  174. package/dist/core/config/validator.js.map +1 -0
  175. package/dist/core/event-bus.d.ts +31 -0
  176. package/dist/core/event-bus.d.ts.map +1 -0
  177. package/dist/core/event-bus.js +197 -0
  178. package/dist/core/event-bus.js.map +1 -0
  179. package/dist/core/index.d.ts +15 -0
  180. package/dist/core/index.d.ts.map +1 -0
  181. package/dist/core/index.js +19 -0
  182. package/dist/core/index.js.map +1 -0
  183. package/dist/core/interfaces/agent.interface.d.ts +200 -0
  184. package/dist/core/interfaces/agent.interface.d.ts.map +1 -0
  185. package/dist/core/interfaces/agent.interface.js +6 -0
  186. package/dist/core/interfaces/agent.interface.js.map +1 -0
  187. package/dist/core/interfaces/coordinator.interface.d.ts +310 -0
  188. package/dist/core/interfaces/coordinator.interface.d.ts.map +1 -0
  189. package/dist/core/interfaces/coordinator.interface.js +7 -0
  190. package/dist/core/interfaces/coordinator.interface.js.map +1 -0
  191. package/dist/core/interfaces/event.interface.d.ts +224 -0
  192. package/dist/core/interfaces/event.interface.d.ts.map +1 -0
  193. package/dist/core/interfaces/event.interface.js +46 -0
  194. package/dist/core/interfaces/event.interface.js.map +1 -0
  195. package/dist/core/interfaces/index.d.ts +10 -0
  196. package/dist/core/interfaces/index.d.ts.map +1 -0
  197. package/dist/core/interfaces/index.js +15 -0
  198. package/dist/core/interfaces/index.js.map +1 -0
  199. package/dist/core/interfaces/memory.interface.d.ts +298 -0
  200. package/dist/core/interfaces/memory.interface.d.ts.map +1 -0
  201. package/dist/core/interfaces/memory.interface.js +7 -0
  202. package/dist/core/interfaces/memory.interface.js.map +1 -0
  203. package/dist/core/interfaces/task.interface.d.ts +185 -0
  204. package/dist/core/interfaces/task.interface.d.ts.map +1 -0
  205. package/dist/core/interfaces/task.interface.js +6 -0
  206. package/dist/core/interfaces/task.interface.js.map +1 -0
  207. package/dist/core/orchestrator/event-coordinator.d.ts +35 -0
  208. package/dist/core/orchestrator/event-coordinator.d.ts.map +1 -0
  209. package/dist/core/orchestrator/event-coordinator.js +101 -0
  210. package/dist/core/orchestrator/event-coordinator.js.map +1 -0
  211. package/dist/core/orchestrator/health-monitor.d.ts +60 -0
  212. package/dist/core/orchestrator/health-monitor.d.ts.map +1 -0
  213. package/dist/core/orchestrator/health-monitor.js +166 -0
  214. package/dist/core/orchestrator/health-monitor.js.map +1 -0
  215. package/dist/core/orchestrator/index.d.ts +46 -0
  216. package/dist/core/orchestrator/index.d.ts.map +1 -0
  217. package/dist/core/orchestrator/index.js +64 -0
  218. package/dist/core/orchestrator/index.js.map +1 -0
  219. package/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
  220. package/dist/core/orchestrator/lifecycle-manager.d.ts.map +1 -0
  221. package/dist/core/orchestrator/lifecycle-manager.js +195 -0
  222. package/dist/core/orchestrator/lifecycle-manager.js.map +1 -0
  223. package/dist/core/orchestrator/session-manager.d.ts +83 -0
  224. package/dist/core/orchestrator/session-manager.d.ts.map +1 -0
  225. package/dist/core/orchestrator/session-manager.js +193 -0
  226. package/dist/core/orchestrator/session-manager.js.map +1 -0
  227. package/dist/core/orchestrator/task-manager.d.ts +49 -0
  228. package/dist/core/orchestrator/task-manager.d.ts.map +1 -0
  229. package/dist/core/orchestrator/task-manager.js +253 -0
  230. package/dist/core/orchestrator/task-manager.js.map +1 -0
  231. package/dist/events/domain-events.d.ts +282 -0
  232. package/dist/events/domain-events.d.ts.map +1 -0
  233. package/dist/events/domain-events.js +165 -0
  234. package/dist/events/domain-events.js.map +1 -0
  235. package/dist/events/event-store.d.ts +126 -0
  236. package/dist/events/event-store.d.ts.map +1 -0
  237. package/dist/events/event-store.js +416 -0
  238. package/dist/events/event-store.js.map +1 -0
  239. package/dist/events/event-store.test.d.ts +8 -0
  240. package/dist/events/event-store.test.d.ts.map +1 -0
  241. package/dist/events/event-store.test.js +293 -0
  242. package/dist/events/event-store.test.js.map +1 -0
  243. package/dist/events/example-usage.d.ts +10 -0
  244. package/dist/events/example-usage.d.ts.map +1 -0
  245. package/dist/events/example-usage.js +193 -0
  246. package/dist/events/example-usage.js.map +1 -0
  247. package/dist/events/index.d.ts +19 -0
  248. package/dist/events/index.d.ts.map +1 -0
  249. package/dist/events/index.js +20 -0
  250. package/dist/events/index.js.map +1 -0
  251. package/dist/events/projections.d.ts +177 -0
  252. package/dist/events/projections.d.ts.map +1 -0
  253. package/dist/events/projections.js +421 -0
  254. package/dist/events/projections.js.map +1 -0
  255. package/dist/events/state-reconstructor.d.ts +101 -0
  256. package/dist/events/state-reconstructor.d.ts.map +1 -0
  257. package/dist/events/state-reconstructor.js +263 -0
  258. package/dist/events/state-reconstructor.js.map +1 -0
  259. package/dist/events.d.ts +80 -0
  260. package/dist/events.d.ts.map +1 -0
  261. package/dist/events.js +249 -0
  262. package/dist/events.js.map +1 -0
  263. package/dist/hooks/example-usage.d.ts +42 -0
  264. package/dist/hooks/example-usage.d.ts.map +1 -0
  265. package/dist/hooks/example-usage.js +351 -0
  266. package/dist/hooks/example-usage.js.map +1 -0
  267. package/dist/hooks/executor.d.ts +100 -0
  268. package/dist/hooks/executor.d.ts.map +1 -0
  269. package/dist/hooks/executor.js +264 -0
  270. package/dist/hooks/executor.js.map +1 -0
  271. package/dist/hooks/hooks.test.d.ts +9 -0
  272. package/dist/hooks/hooks.test.d.ts.map +1 -0
  273. package/dist/hooks/hooks.test.js +322 -0
  274. package/dist/hooks/hooks.test.js.map +1 -0
  275. package/dist/hooks/index.d.ts +52 -0
  276. package/dist/hooks/index.d.ts.map +1 -0
  277. package/dist/hooks/index.js +51 -0
  278. package/dist/hooks/index.js.map +1 -0
  279. package/dist/hooks/registry.d.ts +133 -0
  280. package/dist/hooks/registry.d.ts.map +1 -0
  281. package/dist/hooks/registry.js +277 -0
  282. package/dist/hooks/registry.js.map +1 -0
  283. package/dist/hooks/safety/bash-safety.d.ts +105 -0
  284. package/dist/hooks/safety/bash-safety.d.ts.map +1 -0
  285. package/dist/hooks/safety/bash-safety.js +481 -0
  286. package/dist/hooks/safety/bash-safety.js.map +1 -0
  287. package/dist/hooks/safety/file-organization.d.ts +144 -0
  288. package/dist/hooks/safety/file-organization.d.ts.map +1 -0
  289. package/dist/hooks/safety/file-organization.js +328 -0
  290. package/dist/hooks/safety/file-organization.js.map +1 -0
  291. package/dist/hooks/safety/git-commit.d.ts +158 -0
  292. package/dist/hooks/safety/git-commit.d.ts.map +1 -0
  293. package/dist/hooks/safety/git-commit.js +450 -0
  294. package/dist/hooks/safety/git-commit.js.map +1 -0
  295. package/dist/hooks/safety/index.d.ts +17 -0
  296. package/dist/hooks/safety/index.d.ts.map +1 -0
  297. package/dist/hooks/safety/index.js +17 -0
  298. package/dist/hooks/safety/index.js.map +1 -0
  299. package/dist/hooks/session-hooks.d.ts +234 -0
  300. package/dist/hooks/session-hooks.d.ts.map +1 -0
  301. package/dist/hooks/session-hooks.js +334 -0
  302. package/dist/hooks/session-hooks.js.map +1 -0
  303. package/dist/hooks/task-hooks.d.ts +163 -0
  304. package/dist/hooks/task-hooks.d.ts.map +1 -0
  305. package/dist/hooks/task-hooks.js +326 -0
  306. package/dist/hooks/task-hooks.js.map +1 -0
  307. package/dist/hooks/types.d.ts +267 -0
  308. package/dist/hooks/types.d.ts.map +1 -0
  309. package/dist/hooks/types.js +62 -0
  310. package/dist/hooks/types.js.map +1 -0
  311. package/dist/hooks/verify-exports.test.d.ts +9 -0
  312. package/dist/hooks/verify-exports.test.d.ts.map +1 -0
  313. package/dist/hooks/verify-exports.test.js +93 -0
  314. package/dist/hooks/verify-exports.test.js.map +1 -0
  315. package/dist/index.d.ts +19 -0
  316. package/dist/index.d.ts.map +1 -0
  317. package/dist/index.js +46 -0
  318. package/dist/index.js.map +1 -0
  319. package/dist/mcp/connection-pool.d.ts +98 -0
  320. package/dist/mcp/connection-pool.d.ts.map +1 -0
  321. package/dist/mcp/connection-pool.js +364 -0
  322. package/dist/mcp/connection-pool.js.map +1 -0
  323. package/dist/mcp/index.d.ts +69 -0
  324. package/dist/mcp/index.d.ts.map +1 -0
  325. package/dist/mcp/index.js +84 -0
  326. package/dist/mcp/index.js.map +1 -0
  327. package/dist/mcp/server.d.ts +166 -0
  328. package/dist/mcp/server.d.ts.map +1 -0
  329. package/dist/mcp/server.js +593 -0
  330. package/dist/mcp/server.js.map +1 -0
  331. package/dist/mcp/session-manager.d.ts +136 -0
  332. package/dist/mcp/session-manager.d.ts.map +1 -0
  333. package/dist/mcp/session-manager.js +335 -0
  334. package/dist/mcp/session-manager.js.map +1 -0
  335. package/dist/mcp/tool-registry.d.ts +178 -0
  336. package/dist/mcp/tool-registry.d.ts.map +1 -0
  337. package/dist/mcp/tool-registry.js +439 -0
  338. package/dist/mcp/tool-registry.js.map +1 -0
  339. package/dist/mcp/transport/http.d.ts +104 -0
  340. package/dist/mcp/transport/http.d.ts.map +1 -0
  341. package/dist/mcp/transport/http.js +476 -0
  342. package/dist/mcp/transport/http.js.map +1 -0
  343. package/dist/mcp/transport/index.d.ts +102 -0
  344. package/dist/mcp/transport/index.d.ts.map +1 -0
  345. package/dist/mcp/transport/index.js +238 -0
  346. package/dist/mcp/transport/index.js.map +1 -0
  347. package/dist/mcp/transport/stdio.d.ts +104 -0
  348. package/dist/mcp/transport/stdio.d.ts.map +1 -0
  349. package/dist/mcp/transport/stdio.js +263 -0
  350. package/dist/mcp/transport/stdio.js.map +1 -0
  351. package/dist/mcp/transport/websocket.d.ts +133 -0
  352. package/dist/mcp/transport/websocket.d.ts.map +1 -0
  353. package/dist/mcp/transport/websocket.js +396 -0
  354. package/dist/mcp/transport/websocket.js.map +1 -0
  355. package/dist/mcp/types.d.ts +438 -0
  356. package/dist/mcp/types.d.ts.map +1 -0
  357. package/dist/mcp/types.js +54 -0
  358. package/dist/mcp/types.js.map +1 -0
  359. package/dist/plugin-interface.d.ts +544 -0
  360. package/dist/plugin-interface.d.ts.map +1 -0
  361. package/dist/plugin-interface.js +23 -0
  362. package/dist/plugin-interface.js.map +1 -0
  363. package/dist/plugin-loader.d.ts +139 -0
  364. package/dist/plugin-loader.d.ts.map +1 -0
  365. package/dist/plugin-loader.js +434 -0
  366. package/dist/plugin-loader.js.map +1 -0
  367. package/dist/plugin-registry.d.ts +183 -0
  368. package/dist/plugin-registry.d.ts.map +1 -0
  369. package/dist/plugin-registry.js +457 -0
  370. package/dist/plugin-registry.js.map +1 -0
  371. package/dist/plugins/index.d.ts +10 -0
  372. package/dist/plugins/index.d.ts.map +1 -0
  373. package/dist/plugins/index.js +10 -0
  374. package/dist/plugins/index.js.map +1 -0
  375. package/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
  376. package/dist/plugins/official/hive-mind-plugin.d.ts.map +1 -0
  377. package/dist/plugins/official/hive-mind-plugin.js +241 -0
  378. package/dist/plugins/official/hive-mind-plugin.js.map +1 -0
  379. package/dist/plugins/official/index.d.ts +10 -0
  380. package/dist/plugins/official/index.d.ts.map +1 -0
  381. package/dist/plugins/official/index.js +10 -0
  382. package/dist/plugins/official/index.js.map +1 -0
  383. package/dist/plugins/official/maestro-plugin.d.ts +121 -0
  384. package/dist/plugins/official/maestro-plugin.d.ts.map +1 -0
  385. package/dist/plugins/official/maestro-plugin.js +355 -0
  386. package/dist/plugins/official/maestro-plugin.js.map +1 -0
  387. package/dist/plugins/types.d.ts +93 -0
  388. package/dist/plugins/types.d.ts.map +1 -0
  389. package/dist/plugins/types.js +9 -0
  390. package/dist/plugins/types.js.map +1 -0
  391. package/dist/resilience/bulkhead.d.ts +105 -0
  392. package/dist/resilience/bulkhead.d.ts.map +1 -0
  393. package/dist/resilience/bulkhead.js +206 -0
  394. package/dist/resilience/bulkhead.js.map +1 -0
  395. package/dist/resilience/circuit-breaker.d.ts +132 -0
  396. package/dist/resilience/circuit-breaker.d.ts.map +1 -0
  397. package/dist/resilience/circuit-breaker.js +233 -0
  398. package/dist/resilience/circuit-breaker.js.map +1 -0
  399. package/dist/resilience/index.d.ts +19 -0
  400. package/dist/resilience/index.d.ts.map +1 -0
  401. package/dist/resilience/index.js +19 -0
  402. package/dist/resilience/index.js.map +1 -0
  403. package/dist/resilience/rate-limiter.d.ts +168 -0
  404. package/dist/resilience/rate-limiter.d.ts.map +1 -0
  405. package/dist/resilience/rate-limiter.js +314 -0
  406. package/dist/resilience/rate-limiter.js.map +1 -0
  407. package/dist/resilience/retry.d.ts +91 -0
  408. package/dist/resilience/retry.d.ts.map +1 -0
  409. package/dist/resilience/retry.js +159 -0
  410. package/dist/resilience/retry.js.map +1 -0
  411. package/dist/security/index.d.ts +10 -0
  412. package/dist/security/index.d.ts.map +1 -0
  413. package/dist/security/index.js +12 -0
  414. package/dist/security/index.js.map +1 -0
  415. package/dist/security/input-validation.d.ts +73 -0
  416. package/dist/security/input-validation.d.ts.map +1 -0
  417. package/dist/security/input-validation.js +201 -0
  418. package/dist/security/input-validation.js.map +1 -0
  419. package/dist/security/secure-random.d.ts +92 -0
  420. package/dist/security/secure-random.d.ts.map +1 -0
  421. package/dist/security/secure-random.js +142 -0
  422. package/dist/security/secure-random.js.map +1 -0
  423. package/dist/types/agent.types.d.ts +137 -0
  424. package/dist/types/agent.types.d.ts.map +1 -0
  425. package/dist/types/agent.types.js +6 -0
  426. package/dist/types/agent.types.js.map +1 -0
  427. package/dist/types/index.d.ts +11 -0
  428. package/dist/types/index.d.ts.map +1 -0
  429. package/dist/types/index.js +17 -0
  430. package/dist/types/index.js.map +1 -0
  431. package/dist/types/mcp.types.d.ts +266 -0
  432. package/dist/types/mcp.types.d.ts.map +1 -0
  433. package/dist/types/mcp.types.js +7 -0
  434. package/dist/types/mcp.types.js.map +1 -0
  435. package/dist/types/memory.types.d.ts +236 -0
  436. package/dist/types/memory.types.d.ts.map +1 -0
  437. package/dist/types/memory.types.js +7 -0
  438. package/dist/types/memory.types.js.map +1 -0
  439. package/dist/types/swarm.types.d.ts +186 -0
  440. package/dist/types/swarm.types.d.ts.map +1 -0
  441. package/dist/types/swarm.types.js +65 -0
  442. package/dist/types/swarm.types.js.map +1 -0
  443. package/dist/types/task.types.d.ts +178 -0
  444. package/dist/types/task.types.d.ts.map +1 -0
  445. package/dist/types/task.types.js +32 -0
  446. package/dist/types/task.types.js.map +1 -0
  447. package/dist/types.d.ts +197 -0
  448. package/dist/types.d.ts.map +1 -0
  449. package/dist/types.js +21 -0
  450. package/dist/types.js.map +1 -0
  451. package/dist/utils/secure-logger.d.ts +69 -0
  452. package/dist/utils/secure-logger.d.ts.map +1 -0
  453. package/dist/utils/secure-logger.js +208 -0
  454. package/dist/utils/secure-logger.js.map +1 -0
  455. package/docs/EVENTS_IMPLEMENTATION_SUMMARY.md +388 -0
  456. package/docs/EVENTS_QUICK_REFERENCE.md +470 -0
  457. package/docs/EVENTS_README.md +352 -0
  458. package/package.json +34 -0
  459. package/src/core/config/defaults.ts +207 -0
  460. package/src/core/config/index.ts +15 -0
  461. package/src/core/config/loader.ts +271 -0
  462. package/src/core/config/schema.ts +188 -0
  463. package/src/core/config/validator.ts +209 -0
  464. package/src/core/event-bus.ts +236 -0
  465. package/src/core/index.ts +22 -0
  466. package/src/core/interfaces/agent.interface.ts +251 -0
  467. package/src/core/interfaces/coordinator.interface.ts +363 -0
  468. package/src/core/interfaces/event.interface.ts +267 -0
  469. package/src/core/interfaces/index.ts +19 -0
  470. package/src/core/interfaces/memory.interface.ts +332 -0
  471. package/src/core/interfaces/task.interface.ts +223 -0
  472. package/src/core/orchestrator/event-coordinator.ts +122 -0
  473. package/src/core/orchestrator/health-monitor.ts +214 -0
  474. package/src/core/orchestrator/index.ts +89 -0
  475. package/src/core/orchestrator/lifecycle-manager.ts +263 -0
  476. package/src/core/orchestrator/session-manager.ts +279 -0
  477. package/src/core/orchestrator/task-manager.ts +317 -0
  478. package/src/events/domain-events.ts +584 -0
  479. package/src/events/event-store.test.ts +387 -0
  480. package/src/events/event-store.ts +588 -0
  481. package/src/events/example-usage.ts +293 -0
  482. package/src/events/index.ts +90 -0
  483. package/src/events/projections.ts +561 -0
  484. package/src/events/state-reconstructor.ts +349 -0
  485. package/src/events.ts +367 -0
  486. package/src/hooks/INTEGRATION.md +658 -0
  487. package/src/hooks/README.md +532 -0
  488. package/src/hooks/example-usage.ts +499 -0
  489. package/src/hooks/executor.ts +379 -0
  490. package/src/hooks/hooks.test.ts +421 -0
  491. package/src/hooks/index.ts +131 -0
  492. package/src/hooks/registry.ts +333 -0
  493. package/src/hooks/safety/bash-safety.ts +604 -0
  494. package/src/hooks/safety/file-organization.ts +473 -0
  495. package/src/hooks/safety/git-commit.ts +623 -0
  496. package/src/hooks/safety/index.ts +46 -0
  497. package/src/hooks/session-hooks.ts +559 -0
  498. package/src/hooks/task-hooks.ts +513 -0
  499. package/src/hooks/types.ts +357 -0
  500. package/src/hooks/verify-exports.test.ts +125 -0
  501. package/src/index.ts +190 -0
  502. package/src/mcp/connection-pool.ts +438 -0
  503. package/src/mcp/index.ts +183 -0
  504. package/src/mcp/server.ts +774 -0
  505. package/src/mcp/session-manager.ts +428 -0
  506. package/src/mcp/tool-registry.ts +566 -0
  507. package/src/mcp/transport/http.ts +557 -0
  508. package/src/mcp/transport/index.ts +294 -0
  509. package/src/mcp/transport/stdio.ts +324 -0
  510. package/src/mcp/transport/websocket.ts +484 -0
  511. package/src/mcp/types.ts +565 -0
  512. package/src/plugin-interface.ts +663 -0
  513. package/src/plugin-loader.ts +638 -0
  514. package/src/plugin-registry.ts +604 -0
  515. package/src/plugins/index.ts +34 -0
  516. package/src/plugins/official/hive-mind-plugin.ts +330 -0
  517. package/src/plugins/official/index.ts +24 -0
  518. package/src/plugins/official/maestro-plugin.ts +508 -0
  519. package/src/plugins/types.ts +108 -0
  520. package/src/resilience/bulkhead.ts +277 -0
  521. package/src/resilience/circuit-breaker.ts +326 -0
  522. package/src/resilience/index.ts +26 -0
  523. package/src/resilience/rate-limiter.ts +420 -0
  524. package/src/resilience/retry.ts +224 -0
  525. package/src/security/index.ts +39 -0
  526. package/src/security/input-validation.ts +265 -0
  527. package/src/security/secure-random.ts +159 -0
  528. package/src/types/agent.types.ts +144 -0
  529. package/src/types/index.ts +22 -0
  530. package/src/types/mcp.types.ts +300 -0
  531. package/src/types/memory.types.ts +263 -0
  532. package/src/types/swarm.types.ts +255 -0
  533. package/src/types/task.types.ts +205 -0
  534. package/src/types.ts +367 -0
  535. package/src/utils/secure-logger.d.ts +69 -0
  536. package/src/utils/secure-logger.d.ts.map +1 -0
  537. package/src/utils/secure-logger.js +208 -0
  538. package/src/utils/secure-logger.js.map +1 -0
  539. package/src/utils/secure-logger.ts +257 -0
  540. package/tsconfig.json +9 -0
  541. package/tsconfig.tsbuildinfo +1 -0
@@ -0,0 +1,277 @@
1
+ /**
2
+ * V3 Hooks System - Hook Registry
3
+ *
4
+ * Central registry for managing hook definitions and lifecycle.
5
+ * Provides registration, unregistration, and discovery of hooks.
6
+ *
7
+ * @module v3/shared/hooks/registry
8
+ */
9
+ import { HookPriority, } from './types.js';
10
+ /**
11
+ * Hook registry implementation
12
+ */
13
+ export class HookRegistry {
14
+ hooks = new Map();
15
+ hooksById = new Map();
16
+ hookIdCounter = 0;
17
+ // Statistics tracking
18
+ stats = {
19
+ executions: 0,
20
+ failures: 0,
21
+ totalExecutionTime: 0,
22
+ };
23
+ /**
24
+ * Register a new hook
25
+ *
26
+ * @param event - Hook event type
27
+ * @param handler - Hook handler function
28
+ * @param priority - Hook priority (default: Normal)
29
+ * @param options - Additional hook options
30
+ * @returns Hook ID for later unregistration
31
+ */
32
+ register(event, handler, priority = HookPriority.Normal, options = {}) {
33
+ // Generate unique hook ID
34
+ const id = `hook_${++this.hookIdCounter}_${Date.now()}`;
35
+ // Create hook definition
36
+ const definition = {
37
+ id,
38
+ event,
39
+ handler,
40
+ priority,
41
+ name: options.name,
42
+ enabled: options.enabled ?? true,
43
+ timeout: options.timeout,
44
+ metadata: options.metadata,
45
+ };
46
+ // Add to event-specific list
47
+ let eventHooks = this.hooks.get(event);
48
+ if (!eventHooks) {
49
+ eventHooks = [];
50
+ this.hooks.set(event, eventHooks);
51
+ }
52
+ eventHooks.push(definition);
53
+ // Sort by priority (highest first)
54
+ eventHooks.sort((a, b) => b.priority - a.priority);
55
+ // Add to ID map
56
+ this.hooksById.set(id, definition);
57
+ return id;
58
+ }
59
+ /**
60
+ * Unregister a hook by ID
61
+ *
62
+ * @param hookId - Hook ID to unregister
63
+ * @returns Whether hook was found and removed
64
+ */
65
+ unregister(hookId) {
66
+ const definition = this.hooksById.get(hookId);
67
+ if (!definition) {
68
+ return false;
69
+ }
70
+ // Remove from event-specific list
71
+ const eventHooks = this.hooks.get(definition.event);
72
+ if (eventHooks) {
73
+ const index = eventHooks.findIndex(h => h.id === hookId);
74
+ if (index !== -1) {
75
+ eventHooks.splice(index, 1);
76
+ }
77
+ // Clean up empty arrays
78
+ if (eventHooks.length === 0) {
79
+ this.hooks.delete(definition.event);
80
+ }
81
+ }
82
+ // Remove from ID map
83
+ this.hooksById.delete(hookId);
84
+ return true;
85
+ }
86
+ /**
87
+ * Unregister all hooks for an event
88
+ *
89
+ * @param event - Event type to clear hooks for
90
+ * @returns Number of hooks removed
91
+ */
92
+ unregisterAll(event) {
93
+ if (event) {
94
+ const eventHooks = this.hooks.get(event) || [];
95
+ const count = eventHooks.length;
96
+ // Remove from ID map
97
+ for (const hook of eventHooks) {
98
+ this.hooksById.delete(hook.id);
99
+ }
100
+ // Clear event hooks
101
+ this.hooks.delete(event);
102
+ return count;
103
+ }
104
+ else {
105
+ // Clear all hooks
106
+ const count = this.hooksById.size;
107
+ this.hooks.clear();
108
+ this.hooksById.clear();
109
+ this.hookIdCounter = 0;
110
+ return count;
111
+ }
112
+ }
113
+ /**
114
+ * Get all hooks for a specific event (sorted by priority)
115
+ *
116
+ * @param event - Event type
117
+ * @param includeDisabled - Whether to include disabled hooks
118
+ * @returns Array of hook definitions
119
+ */
120
+ getHandlers(event, includeDisabled = false) {
121
+ const eventHooks = this.hooks.get(event) || [];
122
+ if (includeDisabled) {
123
+ return [...eventHooks];
124
+ }
125
+ return eventHooks.filter(h => h.enabled);
126
+ }
127
+ /**
128
+ * Get a hook by ID
129
+ *
130
+ * @param hookId - Hook ID
131
+ * @returns Hook definition or undefined
132
+ */
133
+ getHook(hookId) {
134
+ return this.hooksById.get(hookId);
135
+ }
136
+ /**
137
+ * Enable a hook
138
+ *
139
+ * @param hookId - Hook ID
140
+ * @returns Whether hook was found and enabled
141
+ */
142
+ enable(hookId) {
143
+ const hook = this.hooksById.get(hookId);
144
+ if (hook) {
145
+ hook.enabled = true;
146
+ return true;
147
+ }
148
+ return false;
149
+ }
150
+ /**
151
+ * Disable a hook
152
+ *
153
+ * @param hookId - Hook ID
154
+ * @returns Whether hook was found and disabled
155
+ */
156
+ disable(hookId) {
157
+ const hook = this.hooksById.get(hookId);
158
+ if (hook) {
159
+ hook.enabled = false;
160
+ return true;
161
+ }
162
+ return false;
163
+ }
164
+ /**
165
+ * List all registered hooks
166
+ *
167
+ * @param filter - Optional filter options
168
+ * @returns Array of hook definitions
169
+ */
170
+ listHooks(filter) {
171
+ let hooks;
172
+ if (filter?.event) {
173
+ hooks = this.hooks.get(filter.event) || [];
174
+ }
175
+ else {
176
+ hooks = Array.from(this.hooksById.values());
177
+ }
178
+ // Apply filters
179
+ if (filter?.enabled !== undefined) {
180
+ hooks = hooks.filter(h => h.enabled === filter.enabled);
181
+ }
182
+ if (filter?.minPriority !== undefined) {
183
+ const minPriority = filter.minPriority;
184
+ hooks = hooks.filter(h => h.priority >= minPriority);
185
+ }
186
+ return hooks;
187
+ }
188
+ /**
189
+ * Get all event types with registered hooks
190
+ *
191
+ * @returns Array of event types
192
+ */
193
+ getEventTypes() {
194
+ return Array.from(this.hooks.keys());
195
+ }
196
+ /**
197
+ * Get count of hooks for an event
198
+ *
199
+ * @param event - Event type (optional)
200
+ * @returns Hook count
201
+ */
202
+ count(event) {
203
+ if (event) {
204
+ return this.hooks.get(event)?.length || 0;
205
+ }
206
+ return this.hooksById.size;
207
+ }
208
+ /**
209
+ * Record hook execution statistics
210
+ *
211
+ * @param success - Whether execution succeeded
212
+ * @param executionTime - Execution time in ms
213
+ */
214
+ recordExecution(success, executionTime) {
215
+ this.stats.executions++;
216
+ this.stats.totalExecutionTime += executionTime;
217
+ if (!success) {
218
+ this.stats.failures++;
219
+ }
220
+ }
221
+ /**
222
+ * Get hook statistics
223
+ *
224
+ * @returns Hook statistics
225
+ */
226
+ getStats() {
227
+ const byEvent = {};
228
+ for (const [event, hooks] of this.hooks) {
229
+ byEvent[event] = hooks.filter(h => h.enabled).length;
230
+ }
231
+ return {
232
+ totalHooks: this.hooksById.size,
233
+ byEvent,
234
+ totalExecutions: this.stats.executions,
235
+ totalFailures: this.stats.failures,
236
+ avgExecutionTime: this.stats.executions > 0
237
+ ? this.stats.totalExecutionTime / this.stats.executions
238
+ : 0,
239
+ totalExecutionTime: this.stats.totalExecutionTime,
240
+ };
241
+ }
242
+ /**
243
+ * Reset statistics
244
+ */
245
+ resetStats() {
246
+ this.stats = {
247
+ executions: 0,
248
+ failures: 0,
249
+ totalExecutionTime: 0,
250
+ };
251
+ }
252
+ /**
253
+ * Check if a hook exists
254
+ *
255
+ * @param hookId - Hook ID
256
+ * @returns Whether hook exists
257
+ */
258
+ has(hookId) {
259
+ return this.hooksById.has(hookId);
260
+ }
261
+ /**
262
+ * Clear all hooks and reset state
263
+ */
264
+ clear() {
265
+ this.hooks.clear();
266
+ this.hooksById.clear();
267
+ this.hookIdCounter = 0;
268
+ this.resetStats();
269
+ }
270
+ }
271
+ /**
272
+ * Create a new hook registry
273
+ */
274
+ export function createHookRegistry() {
275
+ return new HookRegistry();
276
+ }
277
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,105 @@
1
+ /**
2
+ * V3 Bash Safety Hook
3
+ *
4
+ * TypeScript conversion of V2 bash-hook.sh.
5
+ * Provides command safety analysis, dangerous command detection,
6
+ * secret detection, and safe alternatives.
7
+ *
8
+ * @module v3/shared/hooks/safety/bash-safety
9
+ */
10
+ import { HookContext, HookResult } from '../types.js';
11
+ import { HookRegistry } from '../registry.js';
12
+ /**
13
+ * Bash safety hook result
14
+ */
15
+ export interface BashSafetyResult extends HookResult {
16
+ /** Risk level assessment */
17
+ riskLevel: 'low' | 'medium' | 'high' | 'critical';
18
+ /** Whether the command should be blocked */
19
+ blocked: boolean;
20
+ /** Reason for blocking (if blocked) */
21
+ blockReason?: string;
22
+ /** Modified command (if applicable) */
23
+ modifiedCommand?: string;
24
+ /** Detected risks */
25
+ risks: CommandRisk[];
26
+ /** Safe alternatives */
27
+ safeAlternatives?: string[];
28
+ /** Warnings (non-blocking) */
29
+ warnings?: string[];
30
+ /** Missing dependencies detected */
31
+ missingDependencies?: string[];
32
+ /** Redacted command (secrets removed) */
33
+ redactedCommand?: string;
34
+ }
35
+ /**
36
+ * Command risk definition
37
+ */
38
+ export interface CommandRisk {
39
+ /** Risk type */
40
+ type: 'dangerous' | 'destructive' | 'secret' | 'privilege' | 'network' | 'resource';
41
+ /** Risk severity */
42
+ severity: 'low' | 'medium' | 'high' | 'critical';
43
+ /** Risk description */
44
+ description: string;
45
+ /** Pattern that matched */
46
+ pattern?: string;
47
+ }
48
+ /**
49
+ * Bash Safety Hook Manager
50
+ */
51
+ export declare class BashSafetyHook {
52
+ private registry;
53
+ private blockedCommands;
54
+ private availableDependencies;
55
+ constructor(registry: HookRegistry);
56
+ /**
57
+ * Register bash safety hooks
58
+ */
59
+ private registerHooks;
60
+ /**
61
+ * Detect available dependencies
62
+ */
63
+ private detectAvailableDependencies;
64
+ /**
65
+ * Analyze a command for safety
66
+ */
67
+ analyzeCommand(context: HookContext): Promise<BashSafetyResult>;
68
+ /**
69
+ * Detect secrets in command
70
+ */
71
+ private detectSecrets;
72
+ /**
73
+ * Check for missing dependencies
74
+ */
75
+ private checkDependencies;
76
+ /**
77
+ * Calculate overall risk level
78
+ */
79
+ private calculateRiskLevel;
80
+ /**
81
+ * Create a result object
82
+ */
83
+ private createResult;
84
+ /**
85
+ * Manually analyze a command
86
+ */
87
+ analyze(command: string): Promise<BashSafetyResult>;
88
+ /**
89
+ * Add a custom dangerous pattern
90
+ */
91
+ addDangerousPattern(pattern: RegExp, type: CommandRisk['type'], severity: CommandRisk['severity'], description: string, block?: boolean): void;
92
+ /**
93
+ * Mark a dependency as available
94
+ */
95
+ markDependencyAvailable(dependency: string): void;
96
+ /**
97
+ * Check if a command would be blocked
98
+ */
99
+ wouldBlock(command: string): boolean;
100
+ }
101
+ /**
102
+ * Create bash safety hook
103
+ */
104
+ export declare function createBashSafetyHook(registry: HookRegistry): BashSafetyHook;
105
+ //# sourceMappingURL=bash-safety.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bash-safety.d.ts","sourceRoot":"","sources":["../../../src/hooks/safety/bash-safety.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,WAAW,EACX,UAAU,EAGX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,4BAA4B;IAC5B,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oCAAoC;IACpC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IACpF,oBAAoB;IACpB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA6RD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,qBAAqB,CAA0B;gBAE3C,QAAQ,EAAE,YAAY;IAMlC;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;YACW,2BAA2B;IAOzC;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuFrE;;OAEG;IACH,OAAO,CAAC,aAAa;IA8BrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUzD;;OAEG;IACH,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,EACjC,WAAW,EAAE,MAAM,EACnB,KAAK,UAAO,GACX,IAAI;IAIP;;OAEG;IACH,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIjD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAQrC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,cAAc,CAE3E"}