@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,481 @@
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 { HookEvent, HookPriority, } from '../types.js';
11
+ /**
12
+ * Dangerous command patterns
13
+ */
14
+ const DANGEROUS_PATTERNS = [
15
+ // Critical - Always block
16
+ {
17
+ pattern: /rm\s+(-[rRf]+\s+)*\//,
18
+ type: 'destructive',
19
+ severity: 'critical',
20
+ description: 'Recursive deletion from root directory',
21
+ block: true,
22
+ },
23
+ {
24
+ pattern: /rm\s+-rf\s+\/\*/,
25
+ type: 'destructive',
26
+ severity: 'critical',
27
+ description: 'Recursive deletion of all root files',
28
+ block: true,
29
+ },
30
+ {
31
+ pattern: /dd\s+if=.*of=\/dev\/(sd|hd|nvme)/,
32
+ type: 'destructive',
33
+ severity: 'critical',
34
+ description: 'Direct disk write that can destroy data',
35
+ block: true,
36
+ },
37
+ {
38
+ pattern: /mkfs\./,
39
+ type: 'destructive',
40
+ severity: 'critical',
41
+ description: 'Filesystem formatting command',
42
+ block: true,
43
+ },
44
+ {
45
+ pattern: />\s*\/dev\/sd[a-z]/,
46
+ type: 'destructive',
47
+ severity: 'critical',
48
+ description: 'Direct write to disk device',
49
+ block: true,
50
+ },
51
+ {
52
+ // Fork bomb patterns - various formats (with flexible spacing)
53
+ pattern: /:\s*\(\s*\)\s*\{\s*:\s*\|\s*:\s*&\s*\}\s*;\s*:|bomb\s*\(\)|while\s+true.*fork/,
54
+ type: 'resource',
55
+ severity: 'critical',
56
+ description: 'Fork bomb detected',
57
+ block: true,
58
+ },
59
+ {
60
+ pattern: /chmod\s+(-R\s+)?777\s+\//,
61
+ type: 'privilege',
62
+ severity: 'critical',
63
+ description: 'Setting dangerous permissions on root',
64
+ block: true,
65
+ },
66
+ // High - Block but offer alternatives
67
+ {
68
+ pattern: /rm\s+-rf\s+\*/,
69
+ type: 'destructive',
70
+ severity: 'high',
71
+ description: 'Recursive deletion of all files in directory',
72
+ block: true,
73
+ },
74
+ {
75
+ pattern: /rm\s+-rf\s+\.\//,
76
+ type: 'destructive',
77
+ severity: 'high',
78
+ description: 'Recursive deletion of current directory',
79
+ block: true,
80
+ },
81
+ {
82
+ pattern: /rm\s+-rf\s+~/,
83
+ type: 'destructive',
84
+ severity: 'high',
85
+ description: 'Recursive deletion of home directory',
86
+ block: true,
87
+ },
88
+ {
89
+ pattern: /curl.*\|\s*(bash|sh|zsh)/,
90
+ type: 'dangerous',
91
+ severity: 'high',
92
+ description: 'Piping remote content directly to shell',
93
+ block: true,
94
+ },
95
+ {
96
+ pattern: /wget.*-O-\s*\|\s*(bash|sh|zsh)/,
97
+ type: 'dangerous',
98
+ severity: 'high',
99
+ description: 'Piping remote content directly to shell',
100
+ block: true,
101
+ },
102
+ {
103
+ pattern: /eval\s+.*\$\(/,
104
+ type: 'dangerous',
105
+ severity: 'high',
106
+ description: 'Dynamic code execution with command substitution',
107
+ block: true,
108
+ },
109
+ // Medium - Warn
110
+ {
111
+ pattern: /rm\s+(?!.*-i)/,
112
+ type: 'destructive',
113
+ severity: 'medium',
114
+ description: 'Remove command without interactive flag',
115
+ block: false,
116
+ },
117
+ {
118
+ pattern: /sudo\s+rm/,
119
+ type: 'privilege',
120
+ severity: 'medium',
121
+ description: 'Privileged file deletion',
122
+ block: false,
123
+ },
124
+ {
125
+ pattern: /sudo\s+chmod/,
126
+ type: 'privilege',
127
+ severity: 'medium',
128
+ description: 'Privileged permission change',
129
+ block: false,
130
+ },
131
+ {
132
+ pattern: /git\s+push\s+.*--force/,
133
+ type: 'destructive',
134
+ severity: 'medium',
135
+ description: 'Force push can overwrite remote history',
136
+ block: false,
137
+ },
138
+ {
139
+ pattern: /git\s+reset\s+--hard/,
140
+ type: 'destructive',
141
+ severity: 'medium',
142
+ description: 'Hard reset discards uncommitted changes',
143
+ block: false,
144
+ },
145
+ {
146
+ pattern: /DROP\s+(DATABASE|TABLE)/i,
147
+ type: 'destructive',
148
+ severity: 'high',
149
+ description: 'Database/table deletion command',
150
+ block: false,
151
+ },
152
+ {
153
+ pattern: /TRUNCATE\s+TABLE/i,
154
+ type: 'destructive',
155
+ severity: 'medium',
156
+ description: 'Table truncation command',
157
+ block: false,
158
+ },
159
+ // Low - Informational
160
+ {
161
+ pattern: /kill\s+-9/,
162
+ type: 'dangerous',
163
+ severity: 'low',
164
+ description: 'Force kill signal prevents graceful shutdown',
165
+ block: false,
166
+ },
167
+ {
168
+ pattern: /killall/,
169
+ type: 'dangerous',
170
+ severity: 'low',
171
+ description: 'Kills all processes by name',
172
+ block: false,
173
+ },
174
+ ];
175
+ /**
176
+ * Secret patterns to detect and redact
177
+ */
178
+ const SECRET_PATTERNS = [
179
+ { pattern: /(password|passwd|pwd)\s*[=:]\s*['"]?([^\s'"]+)/i, name: 'password', redactGroup: 2 },
180
+ { pattern: /(api[_-]?key)\s*[=:]\s*['"]?([^\s'"]+)/i, name: 'API key', redactGroup: 2 },
181
+ { pattern: /(secret[_-]?key)\s*[=:]\s*['"]?([^\s'"]+)/i, name: 'secret key', redactGroup: 2 },
182
+ { pattern: /(access[_-]?token)\s*[=:]\s*['"]?([^\s'"]+)/i, name: 'access token', redactGroup: 2 },
183
+ { pattern: /(auth[_-]?token)\s*[=:]\s*['"]?([^\s'"]+)/i, name: 'auth token', redactGroup: 2 },
184
+ { pattern: /(bearer)\s+([a-zA-Z0-9._-]+)/i, name: 'bearer token', redactGroup: 2 },
185
+ { pattern: /(private[_-]?key)\s*[=:]\s*['"]?([^\s'"]+)/i, name: 'private key', redactGroup: 2 },
186
+ { pattern: /(\bsk-[a-zA-Z0-9]{20,})/i, name: 'OpenAI API key' },
187
+ { pattern: /(\bghp_[a-zA-Z0-9]{36,})/i, name: 'GitHub token' },
188
+ { pattern: /(\bnpm_[a-zA-Z0-9]{36,})/i, name: 'npm token' },
189
+ { pattern: /(AKIA[0-9A-Z]{16})/i, name: 'AWS access key' },
190
+ ];
191
+ /**
192
+ * Common dependencies to check
193
+ */
194
+ const DEPENDENCY_CHECKS = [
195
+ { command: /\bjq\b/, dependency: 'jq' },
196
+ { command: /\byq\b/, dependency: 'yq' },
197
+ { command: /\bawk\b/, dependency: 'awk' },
198
+ { command: /\bsed\b/, dependency: 'sed' },
199
+ { command: /\bcurl\b/, dependency: 'curl' },
200
+ { command: /\bwget\b/, dependency: 'wget' },
201
+ { command: /\bgit\b/, dependency: 'git' },
202
+ { command: /\bdocker\b/, dependency: 'docker' },
203
+ { command: /\bkubectl\b/, dependency: 'kubectl' },
204
+ { command: /\bpython3?\b/, dependency: 'python' },
205
+ { command: /\bnode\b/, dependency: 'node' },
206
+ { command: /\bnpm\b/, dependency: 'npm' },
207
+ { command: /\byarn\b/, dependency: 'yarn' },
208
+ { command: /\bpnpm\b/, dependency: 'pnpm' },
209
+ ];
210
+ /**
211
+ * Safe alternatives for dangerous commands (with patterns for matching)
212
+ */
213
+ const SAFE_ALTERNATIVES = [
214
+ {
215
+ pattern: /rm\s+-rf\s+\*/,
216
+ alternatives: [
217
+ 'rm -ri * (interactive mode)',
218
+ 'find . -maxdepth 1 -type f -delete (only files)',
219
+ 'git clean -fd (for git repositories)',
220
+ ],
221
+ },
222
+ {
223
+ pattern: /rm\s+-rf/,
224
+ alternatives: [
225
+ 'rm -ri (interactive mode)',
226
+ 'trash-cli (move to trash instead)',
227
+ 'mv to backup directory first',
228
+ ],
229
+ },
230
+ {
231
+ pattern: /kill\s+-9/,
232
+ alternatives: [
233
+ 'kill (graceful termination first)',
234
+ 'kill -15 (SIGTERM)',
235
+ 'systemctl stop (for services)',
236
+ ],
237
+ },
238
+ {
239
+ pattern: /curl.*\|\s*(bash|sh|zsh)/,
240
+ alternatives: [
241
+ 'Download script first, review, then execute',
242
+ 'Use package managers when available',
243
+ 'Verify script hash before execution',
244
+ ],
245
+ },
246
+ {
247
+ pattern: /wget.*\|\s*(bash|sh|zsh)/,
248
+ alternatives: [
249
+ 'Download script first, review, then execute',
250
+ 'Use package managers when available',
251
+ 'Verify script hash before execution',
252
+ ],
253
+ },
254
+ {
255
+ pattern: /git\s+push.*--force/,
256
+ alternatives: [
257
+ 'git push --force-with-lease (safer)',
258
+ 'Create backup branch first',
259
+ 'git push --force-if-includes',
260
+ ],
261
+ },
262
+ {
263
+ pattern: /git\s+reset\s+--hard/,
264
+ alternatives: [
265
+ 'git stash (save changes first)',
266
+ 'git reset --soft (keep changes staged)',
267
+ 'Create backup branch first',
268
+ ],
269
+ },
270
+ ];
271
+ /**
272
+ * Bash Safety Hook Manager
273
+ */
274
+ export class BashSafetyHook {
275
+ registry;
276
+ blockedCommands = new Set();
277
+ availableDependencies = new Set();
278
+ constructor(registry) {
279
+ this.registry = registry;
280
+ this.registerHooks();
281
+ this.detectAvailableDependencies();
282
+ }
283
+ /**
284
+ * Register bash safety hooks
285
+ */
286
+ registerHooks() {
287
+ this.registry.register(HookEvent.PreCommand, this.analyzeCommand.bind(this), HookPriority.Critical, { name: 'bash-safety:pre-command' });
288
+ }
289
+ /**
290
+ * Detect available dependencies
291
+ */
292
+ async detectAvailableDependencies() {
293
+ // In a real implementation, this would check which commands are available
294
+ // For now, assume common ones are available
295
+ const commonDeps = ['git', 'node', 'npm', 'curl', 'sed', 'awk'];
296
+ commonDeps.forEach(dep => this.availableDependencies.add(dep));
297
+ }
298
+ /**
299
+ * Analyze a command for safety
300
+ */
301
+ async analyzeCommand(context) {
302
+ const commandInfo = context.command;
303
+ if (!commandInfo) {
304
+ return this.createResult('low', false, []);
305
+ }
306
+ const command = commandInfo.command;
307
+ const risks = [];
308
+ const warnings = [];
309
+ let blocked = false;
310
+ let blockReason;
311
+ let modifiedCommand;
312
+ let safeAlternatives;
313
+ // Check for dangerous patterns
314
+ for (const pattern of DANGEROUS_PATTERNS) {
315
+ if (pattern.pattern.test(command)) {
316
+ risks.push({
317
+ type: pattern.type,
318
+ severity: pattern.severity,
319
+ description: pattern.description,
320
+ pattern: pattern.pattern.toString(),
321
+ });
322
+ if (pattern.block) {
323
+ blocked = true;
324
+ blockReason = pattern.description;
325
+ }
326
+ // Find safe alternatives using pattern matching
327
+ for (const { pattern: altPattern, alternatives } of SAFE_ALTERNATIVES) {
328
+ if (altPattern.test(command)) {
329
+ safeAlternatives = alternatives;
330
+ break;
331
+ }
332
+ }
333
+ }
334
+ }
335
+ // Check for secrets
336
+ const { secrets, redactedCommand } = this.detectSecrets(command);
337
+ for (const secret of secrets) {
338
+ risks.push({
339
+ type: 'secret',
340
+ severity: 'high',
341
+ description: `Potential ${secret.name} detected in command`,
342
+ });
343
+ warnings.push(`Detected potential secret: ${secret.name}`);
344
+ }
345
+ // Check for missing dependencies
346
+ const missingDependencies = this.checkDependencies(command);
347
+ // Add -i flag to rm commands if not present
348
+ if (/\brm\s+/.test(command) && !/-i\b/.test(command) && !blocked) {
349
+ modifiedCommand = command.replace(/\brm\s+/, 'rm -i ');
350
+ warnings.push('Added -i flag for interactive confirmation');
351
+ }
352
+ // Calculate overall risk level
353
+ const riskLevel = this.calculateRiskLevel(risks);
354
+ // Determine if we should proceed
355
+ const shouldProceed = !blocked;
356
+ return {
357
+ success: true,
358
+ riskLevel,
359
+ blocked,
360
+ blockReason,
361
+ modifiedCommand,
362
+ risks,
363
+ safeAlternatives,
364
+ warnings: warnings.length > 0 ? warnings : undefined,
365
+ missingDependencies: missingDependencies.length > 0 ? missingDependencies : undefined,
366
+ redactedCommand: secrets.length > 0 ? redactedCommand : undefined,
367
+ abort: blocked,
368
+ data: blocked ? undefined : {
369
+ command: {
370
+ ...commandInfo,
371
+ command: modifiedCommand || command,
372
+ isDestructive: risks.some(r => r.type === 'destructive'),
373
+ },
374
+ },
375
+ };
376
+ }
377
+ /**
378
+ * Detect secrets in command
379
+ */
380
+ detectSecrets(command) {
381
+ const secrets = [];
382
+ let redactedCommand = command;
383
+ for (const { pattern, name, redactGroup } of SECRET_PATTERNS) {
384
+ const match = pattern.exec(command);
385
+ if (match) {
386
+ secrets.push({ name, position: match.index });
387
+ // Redact the secret value
388
+ if (redactGroup && match[redactGroup]) {
389
+ redactedCommand = redactedCommand.replace(match[redactGroup], '[REDACTED]');
390
+ }
391
+ else {
392
+ redactedCommand = redactedCommand.replace(match[0], `[REDACTED_${name.toUpperCase().replace(/\s/g, '_')}]`);
393
+ }
394
+ }
395
+ }
396
+ return { secrets, redactedCommand };
397
+ }
398
+ /**
399
+ * Check for missing dependencies
400
+ */
401
+ checkDependencies(command) {
402
+ const missing = [];
403
+ for (const { command: pattern, dependency } of DEPENDENCY_CHECKS) {
404
+ if (pattern.test(command) && !this.availableDependencies.has(dependency)) {
405
+ missing.push(dependency);
406
+ }
407
+ }
408
+ return missing;
409
+ }
410
+ /**
411
+ * Calculate overall risk level
412
+ */
413
+ calculateRiskLevel(risks) {
414
+ if (risks.length === 0) {
415
+ return 'low';
416
+ }
417
+ const severities = risks.map(r => r.severity);
418
+ if (severities.includes('critical')) {
419
+ return 'critical';
420
+ }
421
+ if (severities.includes('high')) {
422
+ return 'high';
423
+ }
424
+ if (severities.includes('medium')) {
425
+ return 'medium';
426
+ }
427
+ return 'low';
428
+ }
429
+ /**
430
+ * Create a result object
431
+ */
432
+ createResult(riskLevel, blocked, risks) {
433
+ return {
434
+ success: true,
435
+ riskLevel,
436
+ blocked,
437
+ risks,
438
+ };
439
+ }
440
+ /**
441
+ * Manually analyze a command
442
+ */
443
+ async analyze(command) {
444
+ const context = {
445
+ event: HookEvent.PreCommand,
446
+ timestamp: new Date(),
447
+ command: { command },
448
+ };
449
+ return this.analyzeCommand(context);
450
+ }
451
+ /**
452
+ * Add a custom dangerous pattern
453
+ */
454
+ addDangerousPattern(pattern, type, severity, description, block = true) {
455
+ DANGEROUS_PATTERNS.push({ pattern, type, severity, description, block });
456
+ }
457
+ /**
458
+ * Mark a dependency as available
459
+ */
460
+ markDependencyAvailable(dependency) {
461
+ this.availableDependencies.add(dependency);
462
+ }
463
+ /**
464
+ * Check if a command would be blocked
465
+ */
466
+ wouldBlock(command) {
467
+ for (const pattern of DANGEROUS_PATTERNS) {
468
+ if (pattern.block && pattern.pattern.test(command)) {
469
+ return true;
470
+ }
471
+ }
472
+ return false;
473
+ }
474
+ }
475
+ /**
476
+ * Create bash safety hook
477
+ */
478
+ export function createBashSafetyHook(registry) {
479
+ return new BashSafetyHook(registry);
480
+ }
481
+ //# sourceMappingURL=bash-safety.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bash-safety.js","sourceRoot":"","sources":["../../../src/hooks/safety/bash-safety.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,144 @@
1
+ /**
2
+ * V3 File Organization Hook
3
+ *
4
+ * TypeScript conversion of V2 file-hook.sh.
5
+ * Enforces file organization, blocks writes to root folder,
6
+ * suggests proper directories, and recommends formatters.
7
+ *
8
+ * @module v3/shared/hooks/safety/file-organization
9
+ */
10
+ import { HookContext, HookResult } from '../types.js';
11
+ import { HookRegistry } from '../registry.js';
12
+ /**
13
+ * File organization hook result
14
+ */
15
+ export interface FileOrganizationResult extends HookResult {
16
+ /** Whether the file operation should be blocked */
17
+ blocked: boolean;
18
+ /** Reason for blocking */
19
+ blockReason?: string;
20
+ /** Suggested new path */
21
+ suggestedPath?: string;
22
+ /** Suggested directory */
23
+ suggestedDirectory?: string;
24
+ /** Formatter recommendation */
25
+ formatter?: FormatterRecommendation;
26
+ /** Linter recommendation */
27
+ linter?: LinterRecommendation;
28
+ /** File type detected */
29
+ fileType?: string;
30
+ /** Warnings */
31
+ warnings?: string[];
32
+ /** Organization issues detected */
33
+ issues?: OrganizationIssue[];
34
+ }
35
+ /**
36
+ * Formatter recommendation
37
+ */
38
+ export interface FormatterRecommendation {
39
+ /** Formatter name */
40
+ name: string;
41
+ /** Command to run */
42
+ command: string;
43
+ /** Config file to check for */
44
+ configFile?: string;
45
+ /** Whether config exists */
46
+ configExists?: boolean;
47
+ }
48
+ /**
49
+ * Linter recommendation
50
+ */
51
+ export interface LinterRecommendation {
52
+ /** Linter name */
53
+ name: string;
54
+ /** Command to run */
55
+ command: string;
56
+ /** Config file to check for */
57
+ configFile?: string;
58
+ }
59
+ /**
60
+ * Organization issue
61
+ */
62
+ export interface OrganizationIssue {
63
+ /** Issue type */
64
+ type: 'wrong-directory' | 'naming-convention' | 'missing-config' | 'root-write';
65
+ /** Issue severity */
66
+ severity: 'info' | 'warning' | 'error';
67
+ /** Issue description */
68
+ description: string;
69
+ /** Suggested fix */
70
+ suggestedFix?: string;
71
+ }
72
+ /**
73
+ * File Organization Hook Manager
74
+ */
75
+ export declare class FileOrganizationHook {
76
+ private registry;
77
+ private projectRoot;
78
+ constructor(registry: HookRegistry);
79
+ /**
80
+ * Register file organization hooks
81
+ */
82
+ private registerHooks;
83
+ /**
84
+ * Analyze file operation for organization issues
85
+ */
86
+ analyzeFileOperation(context: HookContext): Promise<FileOrganizationResult>;
87
+ /**
88
+ * Check if directory is root
89
+ */
90
+ private isRootDirectory;
91
+ /**
92
+ * Normalize path for comparison
93
+ */
94
+ private normalizePath;
95
+ /**
96
+ * Get file type information
97
+ */
98
+ private getFileTypeInfo;
99
+ /**
100
+ * Check naming convention
101
+ */
102
+ private checkNamingConvention;
103
+ /**
104
+ * Get formatter recommendation
105
+ */
106
+ private getFormatterRecommendation;
107
+ /**
108
+ * Get linter recommendation
109
+ */
110
+ private getLinterRecommendation;
111
+ /**
112
+ * Create result object
113
+ */
114
+ private createResult;
115
+ /**
116
+ * Manually analyze a file path
117
+ */
118
+ analyze(filePath: string): Promise<FileOrganizationResult>;
119
+ /**
120
+ * Get suggested directory for a file
121
+ */
122
+ getSuggestedDirectory(fileName: string): string | null;
123
+ /**
124
+ * Check if a file path would be blocked
125
+ */
126
+ wouldBlock(filePath: string): boolean;
127
+ /**
128
+ * Set project root directory
129
+ */
130
+ setProjectRoot(root: string): void;
131
+ /**
132
+ * Get all formatter recommendations
133
+ */
134
+ getAllFormatters(): Record<string, FormatterRecommendation>;
135
+ /**
136
+ * Get all linter recommendations
137
+ */
138
+ getAllLinters(): Record<string, LinterRecommendation>;
139
+ }
140
+ /**
141
+ * Create file organization hook
142
+ */
143
+ export declare function createFileOrganizationHook(registry: HookRegistry): FileOrganizationHook;
144
+ //# sourceMappingURL=file-organization.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-organization.d.ts","sourceRoot":"","sources":["../../../src/hooks/safety/file-organization.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAEL,WAAW,EACX,UAAU,EAGX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mCAAmC;IACnC,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB;IACjB,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,YAAY,CAAC;IAChF,qBAAqB;IACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAqHD;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,WAAW,CAAyB;gBAEhC,QAAQ,EAAE,YAAY;IAKlC;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA2FjF;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAIlC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAahE;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKtD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASrC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC;IAI3D;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC;CAGtD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,YAAY,GAAG,oBAAoB,CAEvF"}