@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,328 @@
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 * as path from 'path';
11
+ import { HookEvent, HookPriority, } from '../types.js';
12
+ /**
13
+ * File type mapping to directories
14
+ */
15
+ const FILE_TYPE_DIRECTORIES = [
16
+ // Test files (MUST come before source files - more specific patterns first)
17
+ { pattern: /\.test\.(ts|tsx|js|jsx)$/, directories: ['tests/', '__tests__/', 'test/'], type: 'test file', blockRoot: true },
18
+ { pattern: /\.spec\.(ts|tsx|js|jsx)$/, directories: ['tests/', '__tests__/', 'test/', 'spec/'], type: 'spec file', blockRoot: true },
19
+ { pattern: /_test\.go$/, directories: ['tests/', 'test/'], type: 'Go test file', blockRoot: true },
20
+ { pattern: /test_.*\.py$/, directories: ['tests/', 'test/'], type: 'Python test file', blockRoot: true },
21
+ { pattern: /.*_test\.py$/, directories: ['tests/', 'test/'], type: 'Python test file', blockRoot: true },
22
+ // Source files
23
+ { pattern: /\.(ts|tsx)$/, directories: ['src/', 'lib/'], type: 'TypeScript source', blockRoot: true },
24
+ { pattern: /\.(js|jsx|mjs|cjs)$/, directories: ['src/', 'lib/', 'dist/'], type: 'JavaScript source', blockRoot: true },
25
+ { pattern: /\.py$/, directories: ['src/', 'lib/', 'app/'], type: 'Python source', blockRoot: true },
26
+ { pattern: /\.go$/, directories: ['cmd/', 'pkg/', 'internal/'], type: 'Go source', blockRoot: true },
27
+ { pattern: /\.rs$/, directories: ['src/'], type: 'Rust source', blockRoot: true },
28
+ { pattern: /\.java$/, directories: ['src/main/java/', 'src/'], type: 'Java source', blockRoot: true },
29
+ { pattern: /\.rb$/, directories: ['lib/', 'app/'], type: 'Ruby source', blockRoot: true },
30
+ { pattern: /\.php$/, directories: ['src/', 'app/'], type: 'PHP source', blockRoot: true },
31
+ { pattern: /\.cs$/, directories: ['src/'], type: 'C# source', blockRoot: true },
32
+ { pattern: /\.cpp?$/, directories: ['src/'], type: 'C/C++ source', blockRoot: true },
33
+ { pattern: /\.swift$/, directories: ['Sources/'], type: 'Swift source', blockRoot: true },
34
+ { pattern: /\.kt$/, directories: ['src/main/kotlin/', 'src/'], type: 'Kotlin source', blockRoot: true },
35
+ // Config files (usually allowed at root)
36
+ { pattern: /\.(json|yaml|yml|toml)$/, directories: ['config/', './', 'configs/'], type: 'config file', blockRoot: false },
37
+ { pattern: /\.(env|env\.[a-z]+)$/, directories: ['./'], type: 'environment file', blockRoot: false },
38
+ // Documentation
39
+ { pattern: /\.md$/, directories: ['docs/', './'], type: 'Markdown documentation', blockRoot: false },
40
+ { pattern: /\.rst$/, directories: ['docs/'], type: 'reStructuredText documentation', blockRoot: true },
41
+ { pattern: /\.adoc$/, directories: ['docs/'], type: 'AsciiDoc documentation', blockRoot: true },
42
+ // Assets
43
+ { pattern: /\.(css|scss|sass|less)$/, directories: ['styles/', 'src/styles/', 'assets/css/'], type: 'stylesheet', blockRoot: true },
44
+ { pattern: /\.(png|jpg|jpeg|gif|svg|ico)$/, directories: ['assets/', 'public/', 'images/', 'static/'], type: 'image', blockRoot: true },
45
+ { pattern: /\.(woff2?|ttf|otf|eot)$/, directories: ['assets/fonts/', 'fonts/', 'public/fonts/'], type: 'font', blockRoot: true },
46
+ // Scripts
47
+ { pattern: /\.sh$/, directories: ['scripts/', 'bin/'], type: 'shell script', blockRoot: true },
48
+ { pattern: /\.ps1$/, directories: ['scripts/', 'bin/'], type: 'PowerShell script', blockRoot: true },
49
+ // Data
50
+ { pattern: /\.sql$/, directories: ['migrations/', 'db/', 'database/'], type: 'SQL file', blockRoot: true },
51
+ { pattern: /\.csv$/, directories: ['data/', 'fixtures/', 'test/fixtures/'], type: 'CSV data', blockRoot: true },
52
+ ];
53
+ /**
54
+ * Formatter recommendations by file extension
55
+ */
56
+ const FORMATTERS = {
57
+ '.ts': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
58
+ '.tsx': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
59
+ '.js': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
60
+ '.jsx': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
61
+ '.json': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
62
+ '.md': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
63
+ '.yaml': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
64
+ '.yml': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
65
+ '.py': { name: 'Black', command: 'black', configFile: 'pyproject.toml' },
66
+ '.go': { name: 'gofmt', command: 'gofmt -w', configFile: undefined },
67
+ '.rs': { name: 'rustfmt', command: 'rustfmt', configFile: 'rustfmt.toml' },
68
+ '.java': { name: 'google-java-format', command: 'google-java-format -i', configFile: undefined },
69
+ '.rb': { name: 'RuboCop', command: 'rubocop -a', configFile: '.rubocop.yml' },
70
+ '.php': { name: 'PHP-CS-Fixer', command: 'php-cs-fixer fix', configFile: '.php-cs-fixer.php' },
71
+ '.cs': { name: 'dotnet-format', command: 'dotnet format', configFile: '.editorconfig' },
72
+ '.swift': { name: 'swift-format', command: 'swift-format -i', configFile: '.swift-format' },
73
+ '.kt': { name: 'ktlint', command: 'ktlint -F', configFile: '.editorconfig' },
74
+ '.css': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
75
+ '.scss': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
76
+ '.html': { name: 'Prettier', command: 'prettier --write', configFile: '.prettierrc' },
77
+ };
78
+ /**
79
+ * Linter recommendations by file extension
80
+ */
81
+ const LINTERS = {
82
+ '.ts': { name: 'ESLint', command: 'eslint --fix', configFile: '.eslintrc' },
83
+ '.tsx': { name: 'ESLint', command: 'eslint --fix', configFile: '.eslintrc' },
84
+ '.js': { name: 'ESLint', command: 'eslint --fix', configFile: '.eslintrc' },
85
+ '.jsx': { name: 'ESLint', command: 'eslint --fix', configFile: '.eslintrc' },
86
+ '.py': { name: 'Pylint', command: 'pylint', configFile: 'pylintrc' },
87
+ '.go': { name: 'golangci-lint', command: 'golangci-lint run', configFile: '.golangci.yml' },
88
+ '.rs': { name: 'Clippy', command: 'cargo clippy', configFile: 'Cargo.toml' },
89
+ '.rb': { name: 'RuboCop', command: 'rubocop', configFile: '.rubocop.yml' },
90
+ '.php': { name: 'PHPStan', command: 'phpstan analyse', configFile: 'phpstan.neon' },
91
+ };
92
+ /**
93
+ * Naming convention checks
94
+ */
95
+ const NAMING_CONVENTIONS = [
96
+ { pattern: /^[a-z][a-z0-9-]*\.[a-z]+$/, convention: 'kebab-case', fileTypes: /\.(tsx?|jsx?|css|scss)$/ },
97
+ { pattern: /^[a-z][a-z0-9_]*\.[a-z]+$/, convention: 'snake_case', fileTypes: /\.py$/ },
98
+ { pattern: /^[a-z][a-z0-9_]*\.[a-z]+$/, convention: 'snake_case', fileTypes: /\.go$/ },
99
+ { pattern: /^[A-Z][a-zA-Z0-9]*\.[a-z]+$/, convention: 'PascalCase', fileTypes: /\.(java|kt|cs)$/ },
100
+ ];
101
+ /**
102
+ * File Organization Hook Manager
103
+ */
104
+ export class FileOrganizationHook {
105
+ registry;
106
+ projectRoot = process.cwd();
107
+ constructor(registry) {
108
+ this.registry = registry;
109
+ this.registerHooks();
110
+ }
111
+ /**
112
+ * Register file organization hooks
113
+ */
114
+ registerHooks() {
115
+ // Pre-edit hook
116
+ this.registry.register(HookEvent.PreEdit, this.analyzeFileOperation.bind(this), HookPriority.High, { name: 'file-organization:pre-edit' });
117
+ // Pre-write hook
118
+ this.registry.register(HookEvent.PreWrite, this.analyzeFileOperation.bind(this), HookPriority.High, { name: 'file-organization:pre-write' });
119
+ }
120
+ /**
121
+ * Analyze file operation for organization issues
122
+ */
123
+ async analyzeFileOperation(context) {
124
+ const fileInfo = context.file;
125
+ if (!fileInfo) {
126
+ return this.createResult(false, []);
127
+ }
128
+ const filePath = fileInfo.path;
129
+ const fileName = path.basename(filePath);
130
+ const dirName = path.dirname(filePath);
131
+ const ext = path.extname(filePath);
132
+ const issues = [];
133
+ const warnings = [];
134
+ let blocked = false;
135
+ let blockReason;
136
+ let suggestedPath;
137
+ let suggestedDirectory;
138
+ // Check if writing to root folder
139
+ const isRootWrite = this.isRootDirectory(dirName);
140
+ const fileTypeInfo = this.getFileTypeInfo(fileName);
141
+ if (isRootWrite && fileTypeInfo?.blockRoot) {
142
+ blocked = true;
143
+ blockReason = `Source files should not be written to root folder. Suggested: ${fileTypeInfo.directories[0]}`;
144
+ suggestedDirectory = fileTypeInfo.directories[0];
145
+ suggestedPath = path.join(suggestedDirectory, fileName);
146
+ issues.push({
147
+ type: 'root-write',
148
+ severity: 'error',
149
+ description: `${fileTypeInfo.type} files should not be in the root directory`,
150
+ suggestedFix: `Move to ${suggestedDirectory}`,
151
+ });
152
+ }
153
+ // Check if file is in wrong directory
154
+ if (!isRootWrite && fileTypeInfo) {
155
+ const isInCorrectDir = fileTypeInfo.directories.some(dir => this.normalizePath(dirName).includes(this.normalizePath(dir)));
156
+ if (!isInCorrectDir) {
157
+ issues.push({
158
+ type: 'wrong-directory',
159
+ severity: 'warning',
160
+ description: `${fileTypeInfo.type} typically goes in: ${fileTypeInfo.directories.join(' or ')}`,
161
+ suggestedFix: `Consider moving to ${fileTypeInfo.directories[0]}`,
162
+ });
163
+ warnings.push(`File may be in wrong directory. Expected: ${fileTypeInfo.directories.join(' or ')}`);
164
+ }
165
+ }
166
+ // Check naming convention
167
+ const namingIssue = this.checkNamingConvention(fileName, ext);
168
+ if (namingIssue) {
169
+ issues.push(namingIssue);
170
+ warnings.push(namingIssue.description);
171
+ }
172
+ // Get formatter recommendation
173
+ const formatter = this.getFormatterRecommendation(ext);
174
+ // Get linter recommendation
175
+ const linter = this.getLinterRecommendation(ext);
176
+ return {
177
+ success: true,
178
+ blocked,
179
+ blockReason,
180
+ suggestedPath,
181
+ suggestedDirectory,
182
+ formatter,
183
+ linter,
184
+ fileType: fileTypeInfo?.type,
185
+ warnings: warnings.length > 0 ? warnings : undefined,
186
+ issues: issues.length > 0 ? issues : undefined,
187
+ abort: blocked,
188
+ data: blocked ? undefined : {
189
+ file: {
190
+ ...fileInfo,
191
+ path: suggestedPath || filePath,
192
+ },
193
+ metadata: {
194
+ formatter: formatter?.command,
195
+ linter: linter?.command,
196
+ },
197
+ },
198
+ };
199
+ }
200
+ /**
201
+ * Check if directory is root
202
+ */
203
+ isRootDirectory(dirName) {
204
+ const normalized = this.normalizePath(dirName);
205
+ return normalized === '.' ||
206
+ normalized === './' ||
207
+ normalized === '' ||
208
+ normalized === this.normalizePath(this.projectRoot);
209
+ }
210
+ /**
211
+ * Normalize path for comparison
212
+ */
213
+ normalizePath(p) {
214
+ return p.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/$/, '');
215
+ }
216
+ /**
217
+ * Get file type information
218
+ */
219
+ getFileTypeInfo(fileName) {
220
+ for (const info of FILE_TYPE_DIRECTORIES) {
221
+ if (info.pattern.test(fileName)) {
222
+ return {
223
+ directories: info.directories,
224
+ type: info.type,
225
+ blockRoot: info.blockRoot,
226
+ };
227
+ }
228
+ }
229
+ return null;
230
+ }
231
+ /**
232
+ * Check naming convention
233
+ */
234
+ checkNamingConvention(fileName, ext) {
235
+ for (const rule of NAMING_CONVENTIONS) {
236
+ if (rule.fileTypes.test(ext)) {
237
+ const baseName = fileName.replace(ext, '');
238
+ if (!rule.pattern.test(fileName)) {
239
+ return {
240
+ type: 'naming-convention',
241
+ severity: 'info',
242
+ description: `File name may not follow ${rule.convention} convention`,
243
+ suggestedFix: `Consider renaming to follow ${rule.convention}`,
244
+ };
245
+ }
246
+ }
247
+ }
248
+ return null;
249
+ }
250
+ /**
251
+ * Get formatter recommendation
252
+ */
253
+ getFormatterRecommendation(ext) {
254
+ return FORMATTERS[ext];
255
+ }
256
+ /**
257
+ * Get linter recommendation
258
+ */
259
+ getLinterRecommendation(ext) {
260
+ return LINTERS[ext];
261
+ }
262
+ /**
263
+ * Create result object
264
+ */
265
+ createResult(blocked, issues) {
266
+ return {
267
+ success: true,
268
+ blocked,
269
+ issues: issues.length > 0 ? issues : undefined,
270
+ };
271
+ }
272
+ /**
273
+ * Manually analyze a file path
274
+ */
275
+ async analyze(filePath) {
276
+ const context = {
277
+ event: HookEvent.PreEdit,
278
+ timestamp: new Date(),
279
+ file: {
280
+ path: filePath,
281
+ operation: 'write',
282
+ },
283
+ };
284
+ return this.analyzeFileOperation(context);
285
+ }
286
+ /**
287
+ * Get suggested directory for a file
288
+ */
289
+ getSuggestedDirectory(fileName) {
290
+ const info = this.getFileTypeInfo(fileName);
291
+ return info?.directories[0] || null;
292
+ }
293
+ /**
294
+ * Check if a file path would be blocked
295
+ */
296
+ wouldBlock(filePath) {
297
+ const fileName = path.basename(filePath);
298
+ const dirName = path.dirname(filePath);
299
+ const isRoot = this.isRootDirectory(dirName);
300
+ const info = this.getFileTypeInfo(fileName);
301
+ return isRoot && (info?.blockRoot ?? false);
302
+ }
303
+ /**
304
+ * Set project root directory
305
+ */
306
+ setProjectRoot(root) {
307
+ this.projectRoot = root;
308
+ }
309
+ /**
310
+ * Get all formatter recommendations
311
+ */
312
+ getAllFormatters() {
313
+ return { ...FORMATTERS };
314
+ }
315
+ /**
316
+ * Get all linter recommendations
317
+ */
318
+ getAllLinters() {
319
+ return { ...LINTERS };
320
+ }
321
+ }
322
+ /**
323
+ * Create file organization hook
324
+ */
325
+ export function createFileOrganizationHook(registry) {
326
+ return new FileOrganizationHook(registry);
327
+ }
328
+ //# sourceMappingURL=file-organization.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-organization.js","sourceRoot":"","sources":["../../../src/hooks/safety/file-organization.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,158 @@
1
+ /**
2
+ * V3 Git Commit Hook
3
+ *
4
+ * TypeScript conversion of V2 git-commit-hook.sh.
5
+ * Provides conventional commit formatting, JIRA ticket extraction,
6
+ * co-author addition, and commit message validation.
7
+ *
8
+ * @module v3/shared/hooks/safety/git-commit
9
+ */
10
+ import { HookContext, HookResult } from '../types.js';
11
+ import { HookRegistry } from '../registry.js';
12
+ /**
13
+ * Git commit hook result
14
+ */
15
+ export interface GitCommitResult extends HookResult {
16
+ /** Original commit message */
17
+ originalMessage: string;
18
+ /** Modified commit message */
19
+ modifiedMessage: string;
20
+ /** Detected commit type */
21
+ commitType?: CommitType;
22
+ /** Extracted ticket reference */
23
+ ticketReference?: string;
24
+ /** Whether co-author was added */
25
+ coAuthorAdded: boolean;
26
+ /** Validation issues */
27
+ validationIssues?: CommitValidationIssue[];
28
+ /** Suggestions for improvement */
29
+ suggestions?: string[];
30
+ }
31
+ /**
32
+ * Commit type definition
33
+ */
34
+ export type CommitType = 'feat' | 'fix' | 'docs' | 'style' | 'refactor' | 'perf' | 'test' | 'build' | 'ci' | 'chore' | 'revert';
35
+ /**
36
+ * Commit validation issue
37
+ */
38
+ export interface CommitValidationIssue {
39
+ /** Issue type */
40
+ type: 'format' | 'length' | 'scope' | 'body' | 'breaking';
41
+ /** Issue severity */
42
+ severity: 'info' | 'warning' | 'error';
43
+ /** Issue description */
44
+ description: string;
45
+ /** Suggested fix */
46
+ suggestedFix?: string;
47
+ }
48
+ /**
49
+ * Co-author configuration
50
+ */
51
+ interface CoAuthor {
52
+ name: string;
53
+ email: string;
54
+ }
55
+ /**
56
+ * Commit message configuration
57
+ */
58
+ interface CommitConfig {
59
+ /** Maximum subject line length */
60
+ maxSubjectLength: number;
61
+ /** Maximum body line length */
62
+ maxBodyLength: number;
63
+ /** Require conventional commit format */
64
+ requireConventional: boolean;
65
+ /** Add co-author by default */
66
+ addCoAuthor: boolean;
67
+ /** Co-author to add */
68
+ coAuthor: CoAuthor;
69
+ /** Add Claude Code reference */
70
+ addClaudeReference: boolean;
71
+ /** Allowed scopes */
72
+ allowedScopes?: string[];
73
+ }
74
+ /**
75
+ * Git Commit Hook Manager
76
+ */
77
+ export declare class GitCommitHook {
78
+ private registry;
79
+ private config;
80
+ constructor(registry: HookRegistry, config?: Partial<CommitConfig>);
81
+ /**
82
+ * Register git commit hooks
83
+ */
84
+ private registerHooks;
85
+ /**
86
+ * Handle pre-commit (when a git commit command is detected)
87
+ */
88
+ handlePreCommit(context: HookContext): Promise<HookResult>;
89
+ /**
90
+ * Process commit message
91
+ */
92
+ processCommitMessage(message: string, branchName?: string): Promise<GitCommitResult>;
93
+ /**
94
+ * Parse commit message into parts
95
+ */
96
+ private parseMessage;
97
+ /**
98
+ * Detect commit type from message
99
+ */
100
+ private detectCommitType;
101
+ /**
102
+ * Check if message has conventional commit prefix
103
+ */
104
+ private hasConventionalPrefix;
105
+ /**
106
+ * Lowercase first letter of a string
107
+ */
108
+ private lowercaseFirstLetter;
109
+ /**
110
+ * Extract ticket reference from branch name
111
+ */
112
+ private extractTicket;
113
+ /**
114
+ * Add ticket reference to message
115
+ */
116
+ private addTicketReference;
117
+ /**
118
+ * Validate conventional commit format
119
+ */
120
+ private validateConventional;
121
+ /**
122
+ * Process commit message manually
123
+ */
124
+ process(message: string, branchName?: string): Promise<GitCommitResult>;
125
+ /**
126
+ * Format a commit message with heredoc-style for git
127
+ */
128
+ formatForGit(message: string): string;
129
+ /**
130
+ * Generate a commit command with formatted message
131
+ */
132
+ generateCommitCommand(message: string): string;
133
+ /**
134
+ * Get commit type description
135
+ */
136
+ getCommitTypeDescription(type: CommitType): string;
137
+ /**
138
+ * Get all available commit types
139
+ */
140
+ getAllCommitTypes(): Array<{
141
+ type: CommitType;
142
+ description: string;
143
+ }>;
144
+ /**
145
+ * Update configuration
146
+ */
147
+ setConfig(config: Partial<CommitConfig>): void;
148
+ /**
149
+ * Get current configuration
150
+ */
151
+ getConfig(): CommitConfig;
152
+ }
153
+ /**
154
+ * Create git commit hook
155
+ */
156
+ export declare function createGitCommitHook(registry: HookRegistry, config?: Partial<CommitConfig>): GitCommitHook;
157
+ export {};
158
+ //# sourceMappingURL=git-commit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"git-commit.d.ts","sourceRoot":"","sources":["../../../src/hooks/safety/git-commit.ts"],"names":[],"mappings":"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"}