@winspan/claude-forge 8.41.0 → 8.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (923) hide show
  1. package/.claude/CLAUDE.md +17 -0
  2. package/.eslintrc.js +23 -0
  3. package/.prettierrc +8 -0
  4. package/ARCHITECTURE_ISSUES.md +249 -0
  5. package/CLAUDE.md +265 -0
  6. package/CLAUDE.md.backup +488 -0
  7. package/DEVELOPMENT.md +310 -0
  8. package/dist/claudemd/claudemd-generator.d.ts +38 -3
  9. package/dist/claudemd/claudemd-generator.d.ts.map +1 -1
  10. package/dist/claudemd/claudemd-generator.js +420 -12
  11. package/dist/claudemd/claudemd-generator.js.map +1 -1
  12. package/dist/claudemd/index.d.ts +2 -2
  13. package/dist/claudemd/index.d.ts.map +1 -1
  14. package/dist/claudemd/index.js.map +1 -1
  15. package/dist/claudemd/resume-manager.d.ts.map +1 -1
  16. package/dist/claudemd/resume-manager.js +6 -3
  17. package/dist/claudemd/resume-manager.js.map +1 -1
  18. package/dist/claudemd/tech-detector.d.ts +1 -0
  19. package/dist/claudemd/tech-detector.d.ts.map +1 -1
  20. package/dist/claudemd/tech-detector.js +53 -0
  21. package/dist/claudemd/tech-detector.js.map +1 -1
  22. package/dist/claudemd/templates/swarm-protocol.md +222 -0
  23. package/dist/cli/commands/claudemd.js +2 -2
  24. package/dist/cli/commands/claudemd.js.map +1 -1
  25. package/dist/cli/commands/daemon.d.ts +28 -0
  26. package/dist/cli/commands/daemon.d.ts.map +1 -1
  27. package/dist/cli/commands/daemon.js +204 -12
  28. package/dist/cli/commands/daemon.js.map +1 -1
  29. package/dist/cli/commands/executions.d.ts.map +1 -1
  30. package/dist/cli/commands/executions.js +4 -3
  31. package/dist/cli/commands/executions.js.map +1 -1
  32. package/dist/cli/commands/init.d.ts.map +1 -1
  33. package/dist/cli/commands/init.js +5 -37
  34. package/dist/cli/commands/init.js.map +1 -1
  35. package/dist/cli/commands/logs.js.map +1 -1
  36. package/dist/cli/commands/mcp.d.ts.map +1 -1
  37. package/dist/cli/commands/mcp.js +3 -5
  38. package/dist/cli/commands/mcp.js.map +1 -1
  39. package/dist/cli/commands/menu.d.ts.map +1 -1
  40. package/dist/cli/commands/menu.js +14 -13
  41. package/dist/cli/commands/menu.js.map +1 -1
  42. package/dist/cli/commands/skills.d.ts.map +1 -1
  43. package/dist/cli/commands/skills.js +8 -2
  44. package/dist/cli/commands/skills.js.map +1 -1
  45. package/dist/cli/commands/stats.d.ts.map +1 -1
  46. package/dist/cli/commands/stats.js +2 -20
  47. package/dist/cli/commands/stats.js.map +1 -1
  48. package/dist/cli/commands/status.js +2 -2
  49. package/dist/cli/commands/status.js.map +1 -1
  50. package/dist/cli/commands/trace.d.ts +9 -0
  51. package/dist/cli/commands/trace.d.ts.map +1 -0
  52. package/dist/cli/commands/trace.js +125 -0
  53. package/dist/cli/commands/trace.js.map +1 -0
  54. package/dist/cli/index.js +2 -4
  55. package/dist/cli/index.js.map +1 -1
  56. package/dist/cli/init/hook-manager.d.ts.map +1 -1
  57. package/dist/cli/init/hook-manager.js +2 -2
  58. package/dist/cli/init/hook-manager.js.map +1 -1
  59. package/dist/core/ai/provider.d.ts +10 -2
  60. package/dist/core/ai/provider.d.ts.map +1 -1
  61. package/dist/core/ai/provider.js +2 -2
  62. package/dist/core/ai/provider.js.map +1 -1
  63. package/dist/core/ai/types.d.ts +1 -19
  64. package/dist/core/ai/types.d.ts.map +1 -1
  65. package/dist/core/ai/types.js +1 -1
  66. package/dist/core/config.d.ts +2 -1
  67. package/dist/core/config.d.ts.map +1 -1
  68. package/dist/core/config.js +23 -6
  69. package/dist/core/config.js.map +1 -1
  70. package/dist/core/constants.d.ts +14 -3
  71. package/dist/core/constants.d.ts.map +1 -1
  72. package/dist/core/constants.js +17 -3
  73. package/dist/core/constants.js.map +1 -1
  74. package/dist/core/event-fields.d.ts +16 -0
  75. package/dist/core/event-fields.d.ts.map +1 -0
  76. package/dist/core/event-fields.js +19 -0
  77. package/dist/core/event-fields.js.map +1 -0
  78. package/dist/core/queue/index.d.ts +52 -0
  79. package/dist/core/queue/index.d.ts.map +1 -0
  80. package/dist/core/queue/index.js +175 -0
  81. package/dist/core/queue/index.js.map +1 -0
  82. package/dist/core/storage/base.d.ts +66 -0
  83. package/dist/core/storage/base.d.ts.map +1 -0
  84. package/dist/core/storage/base.js +254 -0
  85. package/dist/core/storage/base.js.map +1 -0
  86. package/dist/core/storage/events.d.ts +141 -0
  87. package/dist/core/storage/events.d.ts.map +1 -0
  88. package/dist/core/storage/events.js +348 -0
  89. package/dist/core/storage/events.js.map +1 -0
  90. package/dist/core/storage/injections.d.ts +27 -0
  91. package/dist/core/storage/injections.d.ts.map +1 -0
  92. package/dist/core/storage/injections.js +51 -0
  93. package/dist/core/storage/injections.js.map +1 -0
  94. package/dist/core/storage/maintenance.d.ts +21 -0
  95. package/dist/core/storage/maintenance.d.ts.map +1 -0
  96. package/dist/core/storage/maintenance.js +52 -0
  97. package/dist/core/storage/maintenance.js.map +1 -0
  98. package/dist/core/storage/routing.d.ts +124 -0
  99. package/dist/core/storage/routing.d.ts.map +1 -0
  100. package/dist/core/storage/routing.js +239 -0
  101. package/dist/core/storage/routing.js.map +1 -0
  102. package/dist/core/storage/rows.d.ts +0 -47
  103. package/dist/core/storage/rows.d.ts.map +1 -1
  104. package/dist/core/storage/schema.sql +85 -137
  105. package/dist/core/storage/sessions.d.ts +54 -0
  106. package/dist/core/storage/sessions.d.ts.map +1 -0
  107. package/dist/core/storage/sessions.js +137 -0
  108. package/dist/core/storage/sessions.js.map +1 -0
  109. package/dist/core/storage/skills.d.ts +63 -0
  110. package/dist/core/storage/skills.d.ts.map +1 -0
  111. package/dist/core/storage/skills.js +154 -0
  112. package/dist/core/storage/skills.js.map +1 -0
  113. package/dist/core/storage/sqlite.d.ts +97 -266
  114. package/dist/core/storage/sqlite.d.ts.map +1 -1
  115. package/dist/core/storage/sqlite.js +196 -764
  116. package/dist/core/storage/sqlite.js.map +1 -1
  117. package/dist/core/storage/tasks.d.ts +113 -0
  118. package/dist/core/storage/tasks.d.ts.map +1 -0
  119. package/dist/core/storage/tasks.js +276 -0
  120. package/dist/core/storage/tasks.js.map +1 -0
  121. package/dist/core/storage/token-usage.d.ts +36 -0
  122. package/dist/core/storage/token-usage.d.ts.map +1 -0
  123. package/dist/core/storage/token-usage.js +59 -0
  124. package/dist/core/storage/token-usage.js.map +1 -0
  125. package/dist/core/types.d.ts +83 -6
  126. package/dist/core/types.d.ts.map +1 -1
  127. package/dist/core/types.js +24 -1
  128. package/dist/core/types.js.map +1 -1
  129. package/dist/core/utils/error-handler.d.ts.map +1 -1
  130. package/dist/core/utils/error-handler.js +3 -2
  131. package/dist/core/utils/error-handler.js.map +1 -1
  132. package/dist/core/utils/format.d.ts +28 -0
  133. package/dist/core/utils/format.d.ts.map +1 -0
  134. package/dist/core/utils/format.js +68 -0
  135. package/dist/core/utils/format.js.map +1 -0
  136. package/dist/core/utils/git.d.ts +10 -0
  137. package/dist/core/utils/git.d.ts.map +1 -0
  138. package/dist/core/utils/git.js +24 -0
  139. package/dist/core/utils/git.js.map +1 -0
  140. package/dist/core/utils/logger.d.ts +6 -1
  141. package/dist/core/utils/logger.d.ts.map +1 -1
  142. package/dist/core/utils/logger.js +87 -3
  143. package/dist/core/utils/logger.js.map +1 -1
  144. package/dist/core/utils/lru-cache.d.ts +1 -0
  145. package/dist/core/utils/lru-cache.d.ts.map +1 -1
  146. package/dist/core/utils/lru-cache.js +3 -0
  147. package/dist/core/utils/lru-cache.js.map +1 -1
  148. package/dist/core/utils/session.d.ts +16 -0
  149. package/dist/core/utils/session.d.ts.map +1 -0
  150. package/dist/core/utils/session.js +25 -0
  151. package/dist/core/utils/session.js.map +1 -0
  152. package/dist/core/utils/time.d.ts +22 -0
  153. package/dist/core/utils/time.d.ts.map +1 -0
  154. package/dist/core/utils/time.js +38 -0
  155. package/dist/core/utils/time.js.map +1 -0
  156. package/dist/core/utils/token-tracker.js +1 -1
  157. package/dist/core/utils/token-tracker.js.map +1 -1
  158. package/dist/daemon/event-parser.d.ts.map +1 -1
  159. package/dist/daemon/event-parser.js +2 -1
  160. package/dist/daemon/event-parser.js.map +1 -1
  161. package/dist/daemon/handlers/history-exporter.d.ts.map +1 -1
  162. package/dist/daemon/handlers/history-exporter.js +6 -4
  163. package/dist/daemon/handlers/history-exporter.js.map +1 -1
  164. package/dist/daemon/handlers/post-tool-use.d.ts +5 -12
  165. package/dist/daemon/handlers/post-tool-use.d.ts.map +1 -1
  166. package/dist/daemon/handlers/post-tool-use.js +25 -79
  167. package/dist/daemon/handlers/post-tool-use.js.map +1 -1
  168. package/dist/daemon/handlers/stop.d.ts +28 -12
  169. package/dist/daemon/handlers/stop.d.ts.map +1 -1
  170. package/dist/daemon/handlers/stop.js +129 -42
  171. package/dist/daemon/handlers/stop.js.map +1 -1
  172. package/dist/daemon/handlers/user-prompt.d.ts +18 -19
  173. package/dist/daemon/handlers/user-prompt.d.ts.map +1 -1
  174. package/dist/daemon/handlers/user-prompt.js +93 -227
  175. package/dist/daemon/handlers/user-prompt.js.map +1 -1
  176. package/dist/daemon/index.d.ts +6 -2
  177. package/dist/daemon/index.d.ts.map +1 -1
  178. package/dist/daemon/index.js +97 -127
  179. package/dist/daemon/index.js.map +1 -1
  180. package/dist/daemon/launchd/com.claude-forge.daemon.plist.template +47 -0
  181. package/dist/daemon/launchd-installer.d.ts +61 -0
  182. package/dist/daemon/launchd-installer.d.ts.map +1 -0
  183. package/dist/daemon/launchd-installer.js +182 -0
  184. package/dist/daemon/launchd-installer.js.map +1 -0
  185. package/dist/daemon/lifecycle.d.ts +11 -0
  186. package/dist/daemon/lifecycle.d.ts.map +1 -1
  187. package/dist/daemon/lifecycle.js +47 -4
  188. package/dist/daemon/lifecycle.js.map +1 -1
  189. package/dist/daemon/router.d.ts +9 -2
  190. package/dist/daemon/router.d.ts.map +1 -1
  191. package/dist/daemon/router.js +27 -3
  192. package/dist/daemon/router.js.map +1 -1
  193. package/dist/daemon/server.d.ts +6 -4
  194. package/dist/daemon/server.d.ts.map +1 -1
  195. package/dist/daemon/server.js +80 -88
  196. package/dist/daemon/server.js.map +1 -1
  197. package/dist/{intelligence → daemon/services}/task-segmenter.d.ts +7 -1
  198. package/dist/daemon/services/task-segmenter.d.ts.map +1 -0
  199. package/dist/{intelligence → daemon/services}/task-segmenter.js +30 -7
  200. package/dist/daemon/services/task-segmenter.js.map +1 -0
  201. package/dist/hooks/hook-lib.sh +118 -0
  202. package/dist/hooks/notification.sh +9 -5
  203. package/dist/hooks/post-tool-use.sh +10 -6
  204. package/dist/hooks/pre-tool-use.sh +9 -6
  205. package/dist/hooks/stop.sh +10 -7
  206. package/dist/hooks/user-prompt-submit.sh +10 -11
  207. package/dist/mcp/server.d.ts +2 -2
  208. package/dist/mcp/server.d.ts.map +1 -1
  209. package/dist/mcp/server.js +71 -11
  210. package/dist/mcp/server.js.map +1 -1
  211. package/dist/skills/invocation-guard.d.ts +20 -0
  212. package/dist/skills/invocation-guard.d.ts.map +1 -1
  213. package/dist/skills/invocation-guard.js +63 -0
  214. package/dist/skills/invocation-guard.js.map +1 -1
  215. package/dist/skills/matcher.d.ts.map +1 -1
  216. package/dist/skills/matcher.js +12 -3
  217. package/dist/skills/matcher.js.map +1 -1
  218. package/dist/skills/official/code-simplifier.md +16 -0
  219. package/dist/skills/official/find-skills.md +23 -0
  220. package/dist/skills/official/official-api-design.md +17 -0
  221. package/dist/skills/official/official-architecture-decision.md +20 -0
  222. package/dist/skills/official/official-bmad.md +118 -0
  223. package/dist/skills/official/official-db-schema-design.md +16 -0
  224. package/dist/skills/official/official-debug.md +17 -0
  225. package/dist/skills/official/official-doc-driven.md +31 -0
  226. package/dist/skills/official/official-harness-engineering.md +108 -0
  227. package/dist/skills/official/official-performance-optimization.md +30 -0
  228. package/dist/skills/official/official-pr-review.md +35 -0
  229. package/dist/skills/official/official-release-checklist.md +30 -0
  230. package/dist/skills/official/official-security-hardening.md +26 -0
  231. package/dist/skills/official/official-spec-driven-design.md +31 -0
  232. package/dist/skills/official/planning-with-files.md +37 -0
  233. package/dist/skills/official/ui-ux-pro-max.md +18 -0
  234. package/dist/skills/official/webapp-testing.md +12 -0
  235. package/dist/skills/official-skills.d.ts +8 -4
  236. package/dist/skills/official-skills.d.ts.map +1 -1
  237. package/dist/skills/official-skills.js +48 -704
  238. package/dist/skills/official-skills.js.map +1 -1
  239. package/dist/skills/registry.d.ts +5 -0
  240. package/dist/skills/registry.d.ts.map +1 -1
  241. package/dist/skills/registry.js +48 -15
  242. package/dist/skills/registry.js.map +1 -1
  243. package/dist/skills/tools/pipeline-suggest.d.ts +30 -0
  244. package/dist/skills/tools/pipeline-suggest.d.ts.map +1 -0
  245. package/dist/skills/tools/pipeline-suggest.js +178 -0
  246. package/dist/skills/tools/pipeline-suggest.js.map +1 -0
  247. package/dist/web/analytics/anti-pattern-detector.d.ts +49 -0
  248. package/dist/web/analytics/anti-pattern-detector.d.ts.map +1 -0
  249. package/dist/web/analytics/anti-pattern-detector.js +318 -0
  250. package/dist/web/analytics/anti-pattern-detector.js.map +1 -0
  251. package/dist/web/analytics/drift-detector.d.ts +64 -0
  252. package/dist/web/analytics/drift-detector.d.ts.map +1 -0
  253. package/dist/web/analytics/drift-detector.js +198 -0
  254. package/dist/web/analytics/drift-detector.js.map +1 -0
  255. package/dist/web/analytics/weekly-report.d.ts +91 -0
  256. package/dist/web/analytics/weekly-report.d.ts.map +1 -0
  257. package/dist/web/analytics/weekly-report.js +328 -0
  258. package/dist/web/analytics/weekly-report.js.map +1 -0
  259. package/dist/web/auth-middleware.d.ts.map +1 -1
  260. package/dist/web/auth-middleware.js +1 -2
  261. package/dist/web/auth-middleware.js.map +1 -1
  262. package/dist/web/routes/_helpers.d.ts +16 -0
  263. package/dist/web/routes/_helpers.d.ts.map +1 -0
  264. package/dist/web/routes/_helpers.js +32 -0
  265. package/dist/web/routes/_helpers.js.map +1 -0
  266. package/dist/web/routes/ai.d.ts.map +1 -1
  267. package/dist/web/routes/ai.js +16 -22
  268. package/dist/web/routes/ai.js.map +1 -1
  269. package/dist/web/routes/drift.d.ts +10 -0
  270. package/dist/web/routes/drift.d.ts.map +1 -0
  271. package/dist/web/routes/drift.js +21 -0
  272. package/dist/web/routes/drift.js.map +1 -0
  273. package/dist/web/routes/error-handler.d.ts +43 -0
  274. package/dist/web/routes/error-handler.d.ts.map +1 -0
  275. package/dist/web/routes/error-handler.js +99 -0
  276. package/dist/web/routes/error-handler.js.map +1 -0
  277. package/dist/web/routes/insights.d.ts +9 -0
  278. package/dist/web/routes/insights.d.ts.map +1 -0
  279. package/dist/web/routes/insights.js +34 -0
  280. package/dist/web/routes/insights.js.map +1 -0
  281. package/dist/web/routes/patch.js +2 -2
  282. package/dist/web/routes/patch.js.map +1 -1
  283. package/dist/web/routes/reports.d.ts +10 -0
  284. package/dist/web/routes/reports.d.ts.map +1 -0
  285. package/dist/web/routes/reports.js +27 -0
  286. package/dist/web/routes/reports.js.map +1 -0
  287. package/dist/web/routes/rules.d.ts +13 -3
  288. package/dist/web/routes/rules.d.ts.map +1 -1
  289. package/dist/web/routes/rules.js +58 -97
  290. package/dist/web/routes/rules.js.map +1 -1
  291. package/dist/web/routes/sessions.d.ts +1 -2
  292. package/dist/web/routes/sessions.d.ts.map +1 -1
  293. package/dist/web/routes/sessions.js +43 -69
  294. package/dist/web/routes/sessions.js.map +1 -1
  295. package/dist/web/routes/skill-stats.d.ts +2 -0
  296. package/dist/web/routes/skill-stats.d.ts.map +1 -1
  297. package/dist/web/routes/skill-stats.js +41 -39
  298. package/dist/web/routes/skill-stats.js.map +1 -1
  299. package/dist/web/routes/skills.d.ts.map +1 -1
  300. package/dist/web/routes/skills.js +39 -4
  301. package/dist/web/routes/skills.js.map +1 -1
  302. package/dist/web/routes/stats.d.ts +11 -0
  303. package/dist/web/routes/stats.d.ts.map +1 -0
  304. package/dist/web/routes/stats.js +42 -0
  305. package/dist/web/routes/stats.js.map +1 -0
  306. package/dist/web/routes/status.js +1 -1
  307. package/dist/web/routes/status.js.map +1 -1
  308. package/dist/web/routes/tasks.d.ts +4 -0
  309. package/dist/web/routes/tasks.d.ts.map +1 -0
  310. package/dist/web/routes/tasks.js +156 -0
  311. package/dist/web/routes/tasks.js.map +1 -0
  312. package/dist/web/routes/trace.d.ts +10 -0
  313. package/dist/web/routes/trace.d.ts.map +1 -0
  314. package/dist/web/routes/trace.js +113 -0
  315. package/dist/web/routes/trace.js.map +1 -0
  316. package/dist/web/routes/types.d.ts +1 -14
  317. package/dist/web/routes/types.d.ts.map +1 -1
  318. package/dist/web/routes/types.js +12 -20
  319. package/dist/web/routes/types.js.map +1 -1
  320. package/dist/web/server.d.ts +1 -9
  321. package/dist/web/server.d.ts.map +1 -1
  322. package/dist/web/server.js +28 -28
  323. package/dist/web/server.js.map +1 -1
  324. package/dist/web/static/assets/AIConfig-CdDWzJyO.js +2 -0
  325. package/dist/web/static/assets/AIConfig-CdDWzJyO.js.map +1 -0
  326. package/dist/web/static/assets/Dashboard-CoEmmIDt.js +2 -0
  327. package/dist/web/static/assets/Dashboard-CoEmmIDt.js.map +1 -0
  328. package/dist/web/static/assets/{Drawer-DcU3ln98.js → Drawer-DdRTzlLB.js} +2 -2
  329. package/dist/web/static/assets/{Drawer-DcU3ln98.js.map → Drawer-DdRTzlLB.js.map} +1 -1
  330. package/dist/web/static/assets/Events-DrIq1SUS.js +2 -0
  331. package/dist/web/static/assets/Events-DrIq1SUS.js.map +1 -0
  332. package/dist/web/static/assets/Reports-DFBM3MDK.js +2 -0
  333. package/dist/web/static/assets/Reports-DFBM3MDK.js.map +1 -0
  334. package/dist/web/static/assets/SearchInput-qCj_jAcf.js +2 -0
  335. package/dist/web/static/assets/SearchInput-qCj_jAcf.js.map +1 -0
  336. package/dist/web/static/assets/SessionDetail-CCzwdoT7.js +2 -0
  337. package/dist/web/static/assets/SessionDetail-CCzwdoT7.js.map +1 -0
  338. package/dist/web/static/assets/Sessions-FfLYkAw9.js +2 -0
  339. package/dist/web/static/assets/Sessions-FfLYkAw9.js.map +1 -0
  340. package/dist/web/static/assets/Skills-C8Gvs3Qa.js +2 -0
  341. package/dist/web/static/assets/Skills-C8Gvs3Qa.js.map +1 -0
  342. package/dist/web/static/assets/TaskDetail-BS8pYhaR.js +2 -0
  343. package/dist/web/static/assets/TaskDetail-BS8pYhaR.js.map +1 -0
  344. package/dist/web/static/assets/Tasks-CyuhizG8.js +2 -0
  345. package/dist/web/static/assets/Tasks-CyuhizG8.js.map +1 -0
  346. package/dist/web/static/assets/export-L_VBD2p1.js +4 -0
  347. package/dist/web/static/assets/export-L_VBD2p1.js.map +1 -0
  348. package/dist/web/static/assets/index-CBX47X8l.js +3 -0
  349. package/dist/web/static/assets/index-CBX47X8l.js.map +1 -0
  350. package/dist/web/static/assets/index-DjIoMdoR.css +1 -0
  351. package/dist/web/static/assets/{lucide-53bR2rki.js → lucide-Bs_edTLa.js} +73 -38
  352. package/dist/web/static/assets/lucide-Bs_edTLa.js.map +1 -0
  353. package/dist/web/static/assets/react-router-r79dBVy4.js +20 -0
  354. package/dist/web/static/assets/{react-router-I-HqunH7.js.map → react-router-r79dBVy4.js.map} +1 -1
  355. package/dist/web/static/assets/task-title-BhOcemuR.js +2 -0
  356. package/dist/web/static/assets/task-title-BhOcemuR.js.map +1 -0
  357. package/dist/web/static/assets/time-Bxuk0M-C.js +2 -0
  358. package/dist/web/static/assets/time-Bxuk0M-C.js.map +1 -0
  359. package/dist/web/static/index.html +4 -4
  360. package/docs/concurrent-agents.md +129 -0
  361. package/docs/design/architecture-review-20260516.md +232 -0
  362. package/docs/design/fix-skills-data-and-set-leak-spec-20260516-1300.md +219 -0
  363. package/docs/design/h1-storage-aggregation-spec-20260518-1121.md +299 -0
  364. package/docs/design/h2-getdatabase-encapsulation-spec-20260518-1450.md +191 -0
  365. package/docs/design/h3-fallback-removal-spec-20260518-1245.md +76 -0
  366. package/docs/design/h4-index-dedup-spec-20260518-1230.md +109 -0
  367. package/docs/design/h6-services-migration-spec-20260518-1355.md +82 -0
  368. package/docs/design/hook-failure-queue-spec-20260516-1530.md +204 -0
  369. package/docs/design/l1-swarm-protocol-extract-spec-20260518-1605.md +106 -0
  370. package/docs/design/m10-forge-paths-spec-20260518-1320.md +121 -0
  371. package/docs/design/m2-m3-tool-input-spec-20260518-1425.md +131 -0
  372. package/docs/design/m7-routing-event-association-spec-20260518-1545.md +103 -0
  373. package/docs/design/project-path-gitroot-spec-20260518-1715.md +134 -0
  374. package/docs/design/refactor-phase1-spec-20260515-1600.md +543 -0
  375. package/docs/design/refactor-phase2-spec-20260515-1700.md +424 -0
  376. package/docs/design/task-active-gc-spec-20260518-1745.md +146 -0
  377. package/docs/design/tasks-list-filter-pagination-spec-20260518-0930.md +208 -0
  378. package/docs/implementation/fix-skills-data-and-set-leak-changelog-20260516-1300.md +104 -0
  379. package/docs/implementation/h1-storage-aggregation-changelog-20260518-1121.md +82 -0
  380. package/docs/implementation/h2-final-changelog-20260518-1530.md +61 -0
  381. package/docs/implementation/h2-phase1-safety-net-changelog-20260518-1450.md +70 -0
  382. package/docs/implementation/h2-phase2-operations-changelog-20260518-1450.md +120 -0
  383. package/docs/implementation/h2-phase3-callsites-changelog-20260518-1450.md +71 -0
  384. package/docs/implementation/h3-fallback-removal-changelog-20260518-1245.md +71 -0
  385. package/docs/implementation/h4-index-dedup-changelog-20260518-1230.md +60 -0
  386. package/docs/implementation/h6-services-migration-changelog-20260518-1355.md +46 -0
  387. package/docs/implementation/h7-m9-defaults-changelog-20260518-1300.md +46 -0
  388. package/docs/implementation/hook-failure-queue-changelog-20260516-1530.md +196 -0
  389. package/docs/implementation/hotfix-daemon-event-reject-20260516-1430.md +56 -0
  390. package/docs/implementation/l1-swarm-protocol-extract-changelog-20260518-1605.md +45 -0
  391. package/docs/implementation/l3-l4-daemon-perf-changelog-20260518-1410.md +63 -0
  392. package/docs/implementation/l6-l8-final-cleanup-changelog-20260518-1640.md +38 -0
  393. package/docs/implementation/m1-m4-m5-l7-cleanup-changelog-20260518-1310.md +58 -0
  394. package/docs/implementation/m10-forge-paths-changelog-20260518-1320.md +60 -0
  395. package/docs/implementation/m2-m3-tool-input-changelog-20260518-1425.md +43 -0
  396. package/docs/implementation/m6-m8-naming-shutdown-changelog-20260518-1340.md +56 -0
  397. package/docs/implementation/m7-routing-association-changelog-20260518-1545.md +69 -0
  398. package/docs/implementation/project-path-gitroot-changelog-20260518-1715.md +63 -0
  399. package/docs/implementation/refactor-phase1-changelog-20260515-1630.md +354 -0
  400. package/docs/implementation/refactor-phase2-changelog-20260515-1705.md +421 -0
  401. package/docs/implementation/task-active-gc-changelog-20260518-1745.md +35 -0
  402. package/docs/implementation/task-title-summary-changelog-20260518-1130.md +39 -0
  403. package/docs/implementation/tasks-detail-back-loses-filters-changelog-20260518-1100.md +22 -0
  404. package/docs/implementation/tasks-list-filter-pagination-changelog-20260518-0930.md +72 -0
  405. package/docs/implementation/tasks-page-white-screen-hotfix-changelog-20260518-1015.md +56 -0
  406. package/docs/reviews/claudemd-template-sync.md +54 -0
  407. package/docs/reviews/task-title-summary.md +92 -0
  408. package/docs/reviews/tasks-detail-back-loses-filters.md +58 -0
  409. package/docs/reviews/tasks-filter-pagination.md +80 -0
  410. package/docs/reviews/tasks-page-white-screen-hotfix.md +126 -0
  411. package/docs/ruflo-learning-strategy.md +322 -0
  412. package/docs/skills-deduplication-analysis.md +83 -0
  413. package/docs/skills-multiformat-support.md +177 -0
  414. package/docs/skills-third-party.md +183 -0
  415. package/docs/testing/tasks-filter-pagination-test-report.md +86 -0
  416. package/forge +321 -0
  417. package/package.json +28 -62
  418. package/playwright.config.ts +40 -0
  419. package/scripts/demo-v2.ts +91 -0
  420. package/scripts/dev-daemon.sh +232 -0
  421. package/scripts/dev-web.ts +109 -0
  422. package/scripts/e2e-mcp-link.ts +423 -0
  423. package/scripts/e2e-methodology-quality.ts +253 -0
  424. package/scripts/e2e-routing.ts +456 -0
  425. package/scripts/e2e-user-methodology.ts +326 -0
  426. package/scripts/e2e-web-workflows.ts +299 -0
  427. package/scripts/migrate-legacy-to-dynamic.sql +108 -0
  428. package/scripts/regenerate-execution-docs.ts +116 -0
  429. package/scripts/sync-agent-skills.ts +193 -0
  430. package/scripts/test-hook.sh +71 -0
  431. package/scripts/verify-skill-loading.ts +62 -0
  432. package/src/claudemd/claudemd-generator.ts +568 -0
  433. package/src/claudemd/convention-extractor.ts +69 -0
  434. package/src/claudemd/index.ts +35 -0
  435. package/src/claudemd/persona-manager.ts +88 -0
  436. package/src/claudemd/resume-manager.ts +236 -0
  437. package/src/claudemd/tech-detector.ts +220 -0
  438. package/src/claudemd/templates/swarm-protocol.md +222 -0
  439. package/src/cli/commands/claudemd.ts +84 -0
  440. package/src/cli/commands/config.ts +46 -0
  441. package/src/cli/commands/daemon.ts +310 -0
  442. package/src/cli/commands/executions.ts +115 -0
  443. package/src/cli/commands/init.ts +204 -0
  444. package/src/cli/commands/logs.ts +181 -0
  445. package/src/cli/commands/mcp.ts +242 -0
  446. package/src/cli/commands/menu.ts +357 -0
  447. package/src/cli/commands/skills.ts +185 -0
  448. package/src/cli/commands/stats.ts +73 -0
  449. package/src/cli/commands/status.ts +69 -0
  450. package/src/cli/commands/template.ts +77 -0
  451. package/src/cli/commands/trace.ts +148 -0
  452. package/src/cli/index.ts +42 -0
  453. package/src/cli/init/hook-manager.ts +132 -0
  454. package/src/core/ai/provider.ts +308 -0
  455. package/src/core/ai/types.ts +51 -0
  456. package/src/core/config.ts +124 -0
  457. package/src/core/constants.ts +62 -0
  458. package/src/core/event-fields.ts +32 -0
  459. package/src/core/queue/index.ts +192 -0
  460. package/src/core/storage/base.ts +302 -0
  461. package/src/core/storage/events.ts +434 -0
  462. package/src/core/storage/injections.ts +78 -0
  463. package/src/core/storage/maintenance.ts +59 -0
  464. package/src/core/storage/migrations/002_add_skill_tracking.sql +6 -0
  465. package/src/core/storage/migrations/003_add_skill_invocations.sql +23 -0
  466. package/src/core/storage/performance-indexes.sql +23 -0
  467. package/src/core/storage/routing.ts +322 -0
  468. package/src/core/storage/rows.ts +112 -0
  469. package/src/core/storage/schema.sql +224 -0
  470. package/src/core/storage/sessions.ts +168 -0
  471. package/src/core/storage/skills.ts +233 -0
  472. package/src/core/storage/sqlite.ts +293 -0
  473. package/src/core/storage/tasks.ts +318 -0
  474. package/src/core/storage/token-usage.ts +93 -0
  475. package/src/core/types.ts +181 -0
  476. package/src/core/utils/error-handler.ts +257 -0
  477. package/src/core/utils/forge-resume-block.ts +74 -0
  478. package/src/core/utils/format.ts +69 -0
  479. package/src/core/utils/git.ts +23 -0
  480. package/src/core/utils/logger.ts +134 -0
  481. package/src/core/utils/lru-cache.ts +54 -0
  482. package/src/core/utils/path.ts +19 -0
  483. package/src/core/utils/session.ts +26 -0
  484. package/src/core/utils/time.ts +37 -0
  485. package/src/core/utils/token-tracker.ts +97 -0
  486. package/src/daemon/event-parser.ts +36 -0
  487. package/src/daemon/handlers/history-exporter.ts +117 -0
  488. package/src/daemon/handlers/post-tool-use.ts +54 -0
  489. package/src/daemon/handlers/stop.ts +208 -0
  490. package/src/daemon/handlers/user-prompt.ts +178 -0
  491. package/src/daemon/index.ts +292 -0
  492. package/src/daemon/launchd/com.claude-forge.daemon.plist.template +47 -0
  493. package/src/daemon/launchd-installer.ts +260 -0
  494. package/src/daemon/lifecycle.ts +128 -0
  495. package/src/daemon/router.ts +40 -0
  496. package/src/daemon/server.ts +196 -0
  497. package/src/daemon/services/task-segmenter.ts +112 -0
  498. package/src/hooks/hook-lib.sh +118 -0
  499. package/src/hooks/notification.sh +35 -0
  500. package/src/hooks/post-tool-use.sh +61 -0
  501. package/src/hooks/pre-tool-use.sh +63 -0
  502. package/src/hooks/stop.sh +43 -0
  503. package/src/hooks/user-prompt-submit.sh +69 -0
  504. package/src/mcp/server.ts +322 -0
  505. package/src/skills/index.ts +2 -0
  506. package/src/skills/invocation-guard.ts +177 -0
  507. package/src/skills/matcher.ts +148 -0
  508. package/src/skills/official/code-simplifier.md +16 -0
  509. package/src/skills/official/find-skills.md +23 -0
  510. package/src/skills/official/official-api-design.md +17 -0
  511. package/src/skills/official/official-architecture-decision.md +20 -0
  512. package/src/skills/official/official-bmad.md +118 -0
  513. package/src/skills/official/official-db-schema-design.md +16 -0
  514. package/src/skills/official/official-debug.md +17 -0
  515. package/src/skills/official/official-doc-driven.md +31 -0
  516. package/src/skills/official/official-harness-engineering.md +108 -0
  517. package/src/skills/official/official-performance-optimization.md +30 -0
  518. package/src/skills/official/official-pr-review.md +35 -0
  519. package/src/skills/official/official-release-checklist.md +30 -0
  520. package/src/skills/official/official-security-hardening.md +26 -0
  521. package/src/skills/official/official-spec-driven-design.md +31 -0
  522. package/src/skills/official/planning-with-files.md +37 -0
  523. package/src/skills/official/ui-ux-pro-max.md +18 -0
  524. package/src/skills/official/webapp-testing.md +12 -0
  525. package/src/skills/official-skills.ts +89 -0
  526. package/src/skills/registry.ts +355 -0
  527. package/src/skills/semantic-matcher.ts +231 -0
  528. package/src/skills/tools/pipeline-suggest.ts +226 -0
  529. package/src/skills/tools/skill-invoke.ts +168 -0
  530. package/src/skills/tools/skill-list.ts +59 -0
  531. package/src/templates/go.yaml +53 -0
  532. package/src/templates/python.yaml +59 -0
  533. package/src/templates/react.yaml +55 -0
  534. package/src/templates/template-manager.ts +170 -0
  535. package/src/web/analytics/anti-pattern-detector.ts +367 -0
  536. package/src/web/analytics/drift-detector.ts +219 -0
  537. package/src/web/analytics/weekly-report.ts +431 -0
  538. package/src/web/auth-middleware.ts +54 -0
  539. package/src/web/routes/_helpers.ts +34 -0
  540. package/src/web/routes/ai.ts +204 -0
  541. package/src/web/routes/auth.ts +22 -0
  542. package/src/web/routes/drift.ts +25 -0
  543. package/src/web/routes/error-handler.ts +120 -0
  544. package/src/web/routes/events.ts +47 -0
  545. package/src/web/routes/insights.ts +43 -0
  546. package/src/web/routes/patch.ts +117 -0
  547. package/src/web/routes/reports.ts +34 -0
  548. package/src/web/routes/rules.ts +76 -0
  549. package/src/web/routes/sessions.ts +250 -0
  550. package/src/web/routes/skill-stats.ts +92 -0
  551. package/src/web/routes/skills.ts +350 -0
  552. package/src/web/routes/static.ts +67 -0
  553. package/src/web/routes/stats.ts +50 -0
  554. package/src/web/routes/status.ts +30 -0
  555. package/src/web/routes/tasks.ts +193 -0
  556. package/src/web/routes/token-usage.ts +20 -0
  557. package/src/web/routes/trace.ts +126 -0
  558. package/src/web/routes/types.ts +57 -0
  559. package/src/web/server.ts +134 -0
  560. package/src/web/ssrf-guard.ts +112 -0
  561. package/src/web/static/index.html +3251 -0
  562. package/src/web/static/vendor/chart.umd.min.js +20 -0
  563. package/tests/e2e/dashboard.spec.ts +205 -0
  564. package/tests/e2e/routing-skill-e2e.test.ts +39 -0
  565. package/tests/helpers/mock-ai.ts +92 -0
  566. package/tests/helpers/mock-storage.ts +159 -0
  567. package/tests/integration/claudemd-generator.test.ts +90 -0
  568. package/tests/integration/queue-replay.integration.test.ts +193 -0
  569. package/tests/integration/tasks-filter.integration.test.ts +154 -0
  570. package/tests/integration/web-analytics.integration.test.ts +133 -0
  571. package/tests/integration/web-stats.integration.test.ts +135 -0
  572. package/tests/integration/web-trace.integration.test.ts +175 -0
  573. package/tests/performance/database.benchmark.ts +161 -0
  574. package/tests/semantic-matcher.test.ts +99 -0
  575. package/tests/skill-matcher.test.ts +110 -0
  576. package/tests/unit/ai-provider-retry.test.ts +194 -0
  577. package/tests/unit/ai-provider-vision.test.ts +224 -0
  578. package/tests/unit/claudemd-generator.test.ts +68 -0
  579. package/tests/unit/cli-mcp.test.ts +141 -0
  580. package/tests/unit/core/forge-paths.test.ts +99 -0
  581. package/tests/unit/daemon/post-tool-use.test.ts +121 -0
  582. package/tests/unit/daemon/stop-handler-behavior-summary.test.ts +202 -0
  583. package/tests/unit/daemon/task-segmenter-recover.test.ts +84 -0
  584. package/tests/unit/event-fields.test.ts +88 -0
  585. package/tests/unit/event-parser.test.ts +55 -0
  586. package/tests/unit/handlers.test.ts +171 -0
  587. package/tests/unit/hooks/resolve-project-path.test.ts +122 -0
  588. package/tests/unit/invocation-guard.test.ts +125 -0
  589. package/tests/unit/queue.test.ts +272 -0
  590. package/tests/unit/router.test.ts +138 -0
  591. package/tests/unit/security.test.ts +128 -0
  592. package/tests/unit/skill-invocations-workflow.test.ts +495 -0
  593. package/tests/unit/skill-registry.test.ts +94 -0
  594. package/tests/unit/skills/invocation-guard-ttl.test.ts +211 -0
  595. package/tests/unit/skills/official-skills-loader.test.ts +126 -0
  596. package/tests/unit/skills/registry-multiformat.test.ts +92 -0
  597. package/tests/unit/socket-server.test.ts +183 -0
  598. package/tests/unit/storage/event-operations-aggregates.test.ts +342 -0
  599. package/tests/unit/storage/migration-idempotent.test.ts +304 -0
  600. package/tests/unit/storage/routing-aggregates.test.ts +276 -0
  601. package/tests/unit/storage/routing.test.ts +117 -0
  602. package/tests/unit/storage/schema-missing.test.ts +81 -0
  603. package/tests/unit/storage/session-operations-aggregates.test.ts +120 -0
  604. package/tests/unit/storage/sessions-aggregate.test.ts +435 -0
  605. package/tests/unit/storage/skill-operations-counts.test.ts +106 -0
  606. package/tests/unit/storage/skills-aggregates.test.ts +104 -0
  607. package/tests/unit/storage/sqlite-refactor-harness.test.ts +314 -0
  608. package/tests/unit/storage/task-operations-counts.test.ts +46 -0
  609. package/tests/unit/storage/tasks-getById.test.ts +343 -0
  610. package/tests/unit/storage/tasks-stale-gc.test.ts +86 -0
  611. package/tests/unit/storage.test.ts +172 -0
  612. package/tests/unit/token-usage.test.ts +144 -0
  613. package/tests/unit/type-guards.test.ts +201 -0
  614. package/tests/unit/utils/format.test.ts +189 -0
  615. package/tests/unit/utils/session.test.ts +89 -0
  616. package/tests/unit/utils/time.test.ts +112 -0
  617. package/tests/unit/web/navigation-back-contract.test.ts +134 -0
  618. package/tests/unit/web/routes-auth.test.ts +93 -0
  619. package/tests/unit/web/routes-events.test.ts +101 -0
  620. package/tests/unit/web/routes-rules.test.ts +182 -0
  621. package/tests/unit/web/routes-sessions.test.ts +181 -0
  622. package/tests/unit/web/routes-skill-stats.test.ts +179 -0
  623. package/tests/unit/web/routes-stats.test.ts +92 -0
  624. package/tests/unit/web/routes-tasks.test.ts +385 -0
  625. package/tests/unit/web/task-title-contract.test.ts +210 -0
  626. package/tests/unit/web/tasks-component-contract.test.ts +179 -0
  627. package/tsconfig.json +22 -0
  628. package/vitest.config.ts +21 -0
  629. package/vitest.integration.config.ts +16 -0
  630. package/web/CLAUDE.md +20 -0
  631. package/web/index.html +13 -0
  632. package/web/package-lock.json +4854 -0
  633. package/web/package.json +35 -0
  634. package/web/postcss.config.js +6 -0
  635. package/web/src/App.tsx +110 -0
  636. package/web/src/components/CodeBlock.tsx +31 -0
  637. package/web/src/components/Confirm.tsx +96 -0
  638. package/web/src/components/Drawer.tsx +60 -0
  639. package/web/src/components/Layout.tsx +145 -0
  640. package/web/src/components/MarkdownRenderer.tsx +77 -0
  641. package/web/src/components/SearchInput.tsx +31 -0
  642. package/web/src/components/SessionDetailContent.tsx +157 -0
  643. package/web/src/components/Toast.tsx +92 -0
  644. package/web/src/index.css +19 -0
  645. package/web/src/main.tsx +31 -0
  646. package/web/src/pages/AIConfig.tsx +233 -0
  647. package/web/src/pages/Dashboard.tsx +572 -0
  648. package/web/src/pages/Events.tsx +271 -0
  649. package/web/src/pages/Reports.tsx +428 -0
  650. package/web/src/pages/SessionDetail.tsx +162 -0
  651. package/web/src/pages/Sessions.tsx +205 -0
  652. package/web/src/pages/Skills.tsx +180 -0
  653. package/web/src/pages/TaskDetail.tsx +515 -0
  654. package/web/src/pages/Tasks.tsx +415 -0
  655. package/web/src/utils/auth.ts +59 -0
  656. package/web/src/utils/export.ts +54 -0
  657. package/web/src/utils/navigation.ts +25 -0
  658. package/web/src/utils/task-title.ts +49 -0
  659. package/web/src/utils/time.ts +13 -0
  660. package/web/tailwind.config.js +11 -0
  661. package/web/tsconfig.json +21 -0
  662. package/web/tsconfig.node.json +10 -0
  663. package/web/vite.config.ts +76 -0
  664. package/winspan-claude-forge-8.43.0.tgz +0 -0
  665. package/dist/agents/definition.d.ts +0 -62
  666. package/dist/agents/definition.d.ts.map +0 -1
  667. package/dist/agents/definition.js +0 -27
  668. package/dist/agents/definition.js.map +0 -1
  669. package/dist/agents/distributor.d.ts +0 -23
  670. package/dist/agents/distributor.d.ts.map +0 -1
  671. package/dist/agents/distributor.js +0 -85
  672. package/dist/agents/distributor.js.map +0 -1
  673. package/dist/agents/index.d.ts +0 -5
  674. package/dist/agents/index.d.ts.map +0 -1
  675. package/dist/agents/index.js +0 -5
  676. package/dist/agents/index.js.map +0 -1
  677. package/dist/agents/methodologies/agent-builder.d.ts +0 -21
  678. package/dist/agents/methodologies/agent-builder.d.ts.map +0 -1
  679. package/dist/agents/methodologies/agent-builder.js +0 -149
  680. package/dist/agents/methodologies/agent-builder.js.map +0 -1
  681. package/dist/agents/methodologies/phases/bmad/analyze.d.ts +0 -3
  682. package/dist/agents/methodologies/phases/bmad/analyze.d.ts.map +0 -1
  683. package/dist/agents/methodologies/phases/bmad/analyze.js +0 -19
  684. package/dist/agents/methodologies/phases/bmad/analyze.js.map +0 -1
  685. package/dist/agents/methodologies/phases/bmad/design.d.ts +0 -3
  686. package/dist/agents/methodologies/phases/bmad/design.d.ts.map +0 -1
  687. package/dist/agents/methodologies/phases/bmad/design.js +0 -18
  688. package/dist/agents/methodologies/phases/bmad/design.js.map +0 -1
  689. package/dist/agents/methodologies/phases/bmad/implement.d.ts +0 -3
  690. package/dist/agents/methodologies/phases/bmad/implement.d.ts.map +0 -1
  691. package/dist/agents/methodologies/phases/bmad/implement.js +0 -17
  692. package/dist/agents/methodologies/phases/bmad/implement.js.map +0 -1
  693. package/dist/agents/methodologies/phases/bmad/index.d.ts +0 -6
  694. package/dist/agents/methodologies/phases/bmad/index.d.ts.map +0 -1
  695. package/dist/agents/methodologies/phases/bmad/index.js +0 -6
  696. package/dist/agents/methodologies/phases/bmad/index.js.map +0 -1
  697. package/dist/agents/methodologies/phases/bmad/review.d.ts +0 -3
  698. package/dist/agents/methodologies/phases/bmad/review.d.ts.map +0 -1
  699. package/dist/agents/methodologies/phases/bmad/review.js +0 -17
  700. package/dist/agents/methodologies/phases/bmad/review.js.map +0 -1
  701. package/dist/agents/methodologies/phases/bmad/test.d.ts +0 -3
  702. package/dist/agents/methodologies/phases/bmad/test.d.ts.map +0 -1
  703. package/dist/agents/methodologies/phases/bmad/test.js +0 -21
  704. package/dist/agents/methodologies/phases/bmad/test.js.map +0 -1
  705. package/dist/agents/methodologies/phases/harness/fix.d.ts +0 -3
  706. package/dist/agents/methodologies/phases/harness/fix.d.ts.map +0 -1
  707. package/dist/agents/methodologies/phases/harness/fix.js +0 -17
  708. package/dist/agents/methodologies/phases/harness/fix.js.map +0 -1
  709. package/dist/agents/methodologies/phases/harness/index.d.ts +0 -6
  710. package/dist/agents/methodologies/phases/harness/index.d.ts.map +0 -1
  711. package/dist/agents/methodologies/phases/harness/index.js +0 -6
  712. package/dist/agents/methodologies/phases/harness/index.js.map +0 -1
  713. package/dist/agents/methodologies/phases/harness/reproduce.d.ts +0 -3
  714. package/dist/agents/methodologies/phases/harness/reproduce.d.ts.map +0 -1
  715. package/dist/agents/methodologies/phases/harness/reproduce.js +0 -20
  716. package/dist/agents/methodologies/phases/harness/reproduce.js.map +0 -1
  717. package/dist/agents/methodologies/phases/harness/root-cause.d.ts +0 -3
  718. package/dist/agents/methodologies/phases/harness/root-cause.d.ts.map +0 -1
  719. package/dist/agents/methodologies/phases/harness/root-cause.js +0 -21
  720. package/dist/agents/methodologies/phases/harness/root-cause.js.map +0 -1
  721. package/dist/agents/methodologies/phases/harness/safety-net.d.ts +0 -3
  722. package/dist/agents/methodologies/phases/harness/safety-net.d.ts.map +0 -1
  723. package/dist/agents/methodologies/phases/harness/safety-net.js +0 -17
  724. package/dist/agents/methodologies/phases/harness/safety-net.js.map +0 -1
  725. package/dist/agents/methodologies/phases/harness/verify.d.ts +0 -3
  726. package/dist/agents/methodologies/phases/harness/verify.d.ts.map +0 -1
  727. package/dist/agents/methodologies/phases/harness/verify.js +0 -22
  728. package/dist/agents/methodologies/phases/harness/verify.js.map +0 -1
  729. package/dist/agents/methodologies/presets.d.ts +0 -10
  730. package/dist/agents/methodologies/presets.d.ts.map +0 -1
  731. package/dist/agents/methodologies/presets.js +0 -79
  732. package/dist/agents/methodologies/presets.js.map +0 -1
  733. package/dist/agents/methodologies/types.d.ts +0 -45
  734. package/dist/agents/methodologies/types.d.ts.map +0 -1
  735. package/dist/agents/methodologies/types.js +0 -10
  736. package/dist/agents/methodologies/types.js.map +0 -1
  737. package/dist/agents/methodologies/user-config-loader.d.ts +0 -30
  738. package/dist/agents/methodologies/user-config-loader.d.ts.map +0 -1
  739. package/dist/agents/methodologies/user-config-loader.js +0 -159
  740. package/dist/agents/methodologies/user-config-loader.js.map +0 -1
  741. package/dist/agents/official-agents.d.ts +0 -4
  742. package/dist/agents/official-agents.d.ts.map +0 -1
  743. package/dist/agents/official-agents.js +0 -559
  744. package/dist/agents/official-agents.js.map +0 -1
  745. package/dist/agents/registry.d.ts +0 -57
  746. package/dist/agents/registry.d.ts.map +0 -1
  747. package/dist/agents/registry.js +0 -271
  748. package/dist/agents/registry.js.map +0 -1
  749. package/dist/capability/index.d.ts +0 -10
  750. package/dist/capability/index.d.ts.map +0 -1
  751. package/dist/capability/index.js +0 -10
  752. package/dist/capability/index.js.map +0 -1
  753. package/dist/capability/types.d.ts +0 -10
  754. package/dist/capability/types.d.ts.map +0 -1
  755. package/dist/capability/types.js +0 -10
  756. package/dist/capability/types.js.map +0 -1
  757. package/dist/cli/commands/agents.d.ts +0 -3
  758. package/dist/cli/commands/agents.d.ts.map +0 -1
  759. package/dist/cli/commands/agents.js +0 -62
  760. package/dist/cli/commands/agents.js.map +0 -1
  761. package/dist/cli/commands/rules.d.ts +0 -8
  762. package/dist/cli/commands/rules.d.ts.map +0 -1
  763. package/dist/cli/commands/rules.js +0 -89
  764. package/dist/cli/commands/rules.js.map +0 -1
  765. package/dist/daemon/auto-disable-scheduler.d.ts +0 -53
  766. package/dist/daemon/auto-disable-scheduler.d.ts.map +0 -1
  767. package/dist/daemon/auto-disable-scheduler.js +0 -114
  768. package/dist/daemon/auto-disable-scheduler.js.map +0 -1
  769. package/dist/daemon/handlers/pre-tool-use.d.ts +0 -39
  770. package/dist/daemon/handlers/pre-tool-use.d.ts.map +0 -1
  771. package/dist/daemon/handlers/pre-tool-use.js +0 -166
  772. package/dist/daemon/handlers/pre-tool-use.js.map +0 -1
  773. package/dist/daemon/routing-observer.d.ts +0 -42
  774. package/dist/daemon/routing-observer.d.ts.map +0 -1
  775. package/dist/daemon/routing-observer.js +0 -264
  776. package/dist/daemon/routing-observer.js.map +0 -1
  777. package/dist/daemon/routing-state.d.ts +0 -64
  778. package/dist/daemon/routing-state.d.ts.map +0 -1
  779. package/dist/daemon/routing-state.js +0 -240
  780. package/dist/daemon/routing-state.js.map +0 -1
  781. package/dist/engine/agent-router.d.ts +0 -142
  782. package/dist/engine/agent-router.d.ts.map +0 -1
  783. package/dist/engine/agent-router.js +0 -276
  784. package/dist/engine/agent-router.js.map +0 -1
  785. package/dist/engine/context-builder.d.ts +0 -23
  786. package/dist/engine/context-builder.d.ts.map +0 -1
  787. package/dist/engine/context-builder.js +0 -63
  788. package/dist/engine/context-builder.js.map +0 -1
  789. package/dist/engine/conventions/basic-security.yaml +0 -109
  790. package/dist/engine/conventions/code-quality.yaml +0 -123
  791. package/dist/engine/conventions/database-safety.yaml +0 -74
  792. package/dist/engine/conventions/dependency-safety.yaml +0 -132
  793. package/dist/engine/conventions/docker-safety.yaml +0 -69
  794. package/dist/engine/conventions/git-safety.yaml +0 -118
  795. package/dist/engine/conventions/go-best-practices.yaml +0 -84
  796. package/dist/engine/conventions/python-best-practices.yaml +0 -96
  797. package/dist/engine/conventions/react-best-practices.yaml +0 -96
  798. package/dist/engine/conventions/routing.yaml +0 -378
  799. package/dist/engine/conventions/strict-security.yaml +0 -30
  800. package/dist/engine/conventions/ts-quality.yaml +0 -49
  801. package/dist/engine/dsl/compiler.d.ts +0 -34
  802. package/dist/engine/dsl/compiler.d.ts.map +0 -1
  803. package/dist/engine/dsl/compiler.js +0 -702
  804. package/dist/engine/dsl/compiler.js.map +0 -1
  805. package/dist/engine/dsl/parser.d.ts +0 -25
  806. package/dist/engine/dsl/parser.d.ts.map +0 -1
  807. package/dist/engine/dsl/parser.js +0 -208
  808. package/dist/engine/dsl/parser.js.map +0 -1
  809. package/dist/engine/dsl/runtime.d.ts +0 -46
  810. package/dist/engine/dsl/runtime.d.ts.map +0 -1
  811. package/dist/engine/dsl/runtime.js +0 -173
  812. package/dist/engine/dsl/runtime.js.map +0 -1
  813. package/dist/engine/dsl/types.d.ts +0 -139
  814. package/dist/engine/dsl/types.d.ts.map +0 -1
  815. package/dist/engine/dsl/types.js +0 -11
  816. package/dist/engine/dsl/types.js.map +0 -1
  817. package/dist/engine/evidence-store.d.ts +0 -44
  818. package/dist/engine/evidence-store.d.ts.map +0 -1
  819. package/dist/engine/evidence-store.js +0 -109
  820. package/dist/engine/evidence-store.js.map +0 -1
  821. package/dist/engine/experiment-router.d.ts +0 -102
  822. package/dist/engine/experiment-router.d.ts.map +0 -1
  823. package/dist/engine/experiment-router.js +0 -289
  824. package/dist/engine/experiment-router.js.map +0 -1
  825. package/dist/engine/recommender.d.ts +0 -52
  826. package/dist/engine/recommender.d.ts.map +0 -1
  827. package/dist/engine/recommender.js +0 -162
  828. package/dist/engine/recommender.js.map +0 -1
  829. package/dist/engine/rule-engine.d.ts +0 -33
  830. package/dist/engine/rule-engine.d.ts.map +0 -1
  831. package/dist/engine/rule-engine.js +0 -250
  832. package/dist/engine/rule-engine.js.map +0 -1
  833. package/dist/engine/security-gates.d.ts +0 -42
  834. package/dist/engine/security-gates.d.ts.map +0 -1
  835. package/dist/engine/security-gates.js +0 -210
  836. package/dist/engine/security-gates.js.map +0 -1
  837. package/dist/intelligence/classifier.d.ts +0 -75
  838. package/dist/intelligence/classifier.d.ts.map +0 -1
  839. package/dist/intelligence/classifier.js +0 -352
  840. package/dist/intelligence/classifier.js.map +0 -1
  841. package/dist/intelligence/context-gatherer.d.ts +0 -101
  842. package/dist/intelligence/context-gatherer.d.ts.map +0 -1
  843. package/dist/intelligence/context-gatherer.js +0 -417
  844. package/dist/intelligence/context-gatherer.js.map +0 -1
  845. package/dist/intelligence/cot-classifier.d.ts +0 -95
  846. package/dist/intelligence/cot-classifier.d.ts.map +0 -1
  847. package/dist/intelligence/cot-classifier.js +0 -391
  848. package/dist/intelligence/cot-classifier.js.map +0 -1
  849. package/dist/intelligence/distiller.d.ts +0 -22
  850. package/dist/intelligence/distiller.d.ts.map +0 -1
  851. package/dist/intelligence/distiller.js +0 -108
  852. package/dist/intelligence/distiller.js.map +0 -1
  853. package/dist/intelligence/execution-doc-builder.d.ts +0 -151
  854. package/dist/intelligence/execution-doc-builder.d.ts.map +0 -1
  855. package/dist/intelligence/execution-doc-builder.js +0 -1018
  856. package/dist/intelligence/execution-doc-builder.js.map +0 -1
  857. package/dist/intelligence/intent-types.d.ts +0 -13
  858. package/dist/intelligence/intent-types.d.ts.map +0 -1
  859. package/dist/intelligence/intent-types.js +0 -19
  860. package/dist/intelligence/intent-types.js.map +0 -1
  861. package/dist/intelligence/multimodal-parser.d.ts +0 -105
  862. package/dist/intelligence/multimodal-parser.d.ts.map +0 -1
  863. package/dist/intelligence/multimodal-parser.js +0 -425
  864. package/dist/intelligence/multimodal-parser.js.map +0 -1
  865. package/dist/intelligence/quality-gate.d.ts +0 -45
  866. package/dist/intelligence/quality-gate.d.ts.map +0 -1
  867. package/dist/intelligence/quality-gate.js +0 -193
  868. package/dist/intelligence/quality-gate.js.map +0 -1
  869. package/dist/intelligence/task-segmenter.d.ts.map +0 -1
  870. package/dist/intelligence/task-segmenter.js.map +0 -1
  871. package/dist/web/routes/agents.d.ts +0 -7
  872. package/dist/web/routes/agents.d.ts.map +0 -1
  873. package/dist/web/routes/agents.js +0 -209
  874. package/dist/web/routes/agents.js.map +0 -1
  875. package/dist/web/routes/execution-trace.d.ts +0 -21
  876. package/dist/web/routes/execution-trace.d.ts.map +0 -1
  877. package/dist/web/routes/execution-trace.js +0 -353
  878. package/dist/web/routes/execution-trace.js.map +0 -1
  879. package/dist/web/routes/experiments.d.ts +0 -15
  880. package/dist/web/routes/experiments.d.ts.map +0 -1
  881. package/dist/web/routes/experiments.js +0 -187
  882. package/dist/web/routes/experiments.js.map +0 -1
  883. package/dist/web/routes/routing.d.ts +0 -17
  884. package/dist/web/routes/routing.d.ts.map +0 -1
  885. package/dist/web/routes/routing.js +0 -592
  886. package/dist/web/routes/routing.js.map +0 -1
  887. package/dist/web/routes/workflows.d.ts +0 -19
  888. package/dist/web/routes/workflows.d.ts.map +0 -1
  889. package/dist/web/routes/workflows.js +0 -86
  890. package/dist/web/routes/workflows.js.map +0 -1
  891. package/dist/web/static/assets/AIConfig-R5wZ3ZKT.js +0 -2
  892. package/dist/web/static/assets/AIConfig-R5wZ3ZKT.js.map +0 -1
  893. package/dist/web/static/assets/Agents-Beg34V1g.js +0 -2
  894. package/dist/web/static/assets/Agents-Beg34V1g.js.map +0 -1
  895. package/dist/web/static/assets/CodeBlock--H53gk46.js +0 -2
  896. package/dist/web/static/assets/CodeBlock--H53gk46.js.map +0 -1
  897. package/dist/web/static/assets/Dashboard-Cy1xsj1J.js +0 -2
  898. package/dist/web/static/assets/Dashboard-Cy1xsj1J.js.map +0 -1
  899. package/dist/web/static/assets/Events-mFhXl4zI.js +0 -2
  900. package/dist/web/static/assets/Events-mFhXl4zI.js.map +0 -1
  901. package/dist/web/static/assets/ExecutionTrace-DG901hLR.js +0 -3
  902. package/dist/web/static/assets/ExecutionTrace-DG901hLR.js.map +0 -1
  903. package/dist/web/static/assets/MarkdownRenderer-CCIz1MOz.js +0 -2
  904. package/dist/web/static/assets/MarkdownRenderer-CCIz1MOz.js.map +0 -1
  905. package/dist/web/static/assets/Routing-B7BFLfjh.js +0 -2
  906. package/dist/web/static/assets/Routing-B7BFLfjh.js.map +0 -1
  907. package/dist/web/static/assets/SessionDetail-BT0l4RrK.js +0 -2
  908. package/dist/web/static/assets/SessionDetail-BT0l4RrK.js.map +0 -1
  909. package/dist/web/static/assets/Sessions-C6J_HQ_u.js +0 -2
  910. package/dist/web/static/assets/Sessions-C6J_HQ_u.js.map +0 -1
  911. package/dist/web/static/assets/Skills-4DQWLaTv.js +0 -2
  912. package/dist/web/static/assets/Skills-4DQWLaTv.js.map +0 -1
  913. package/dist/web/static/assets/WorkflowDetail-zhNqUkBE.js +0 -2
  914. package/dist/web/static/assets/WorkflowDetail-zhNqUkBE.js.map +0 -1
  915. package/dist/web/static/assets/Workflows-Btvi-lGw.js +0 -2
  916. package/dist/web/static/assets/Workflows-Btvi-lGw.js.map +0 -1
  917. package/dist/web/static/assets/export-BQQZLaHV.js +0 -4
  918. package/dist/web/static/assets/export-BQQZLaHV.js.map +0 -1
  919. package/dist/web/static/assets/index-Cgr9qMtq.js +0 -3
  920. package/dist/web/static/assets/index-Cgr9qMtq.js.map +0 -1
  921. package/dist/web/static/assets/index-CngWb5gC.css +0 -1
  922. package/dist/web/static/assets/lucide-53bR2rki.js.map +0 -1
  923. package/dist/web/static/assets/react-router-I-HqunH7.js +0 -20
@@ -1,114 +0,0 @@
1
- /**
2
- * AutoDisableScheduler — periodically scans routing_events for persistent
3
- * violation patterns and auto-disables the offending (taskType, agent) pair.
4
- *
5
- * Threshold (matches Web UI "critical" severity from Phase 3 Feature 3):
6
- * - refusal_rate >= 0.8
7
- * - total_attempts >= 10
8
- * - pattern observed over the last 24 hours
9
- *
10
- * When such a pattern is detected, we set routing_rule_states.disabled = 1
11
- * with auto_disabled = 1 so the router skips the rule and users can review
12
- * / override in Web UI.
13
- *
14
- * Behavior:
15
- * - Manual disables (auto_disabled = 0) are never touched.
16
- * - Patterns already disabled are skipped.
17
- * - Patterns that no longer meet the threshold are NOT auto-re-enabled —
18
- * that is an explicit user decision. This avoids flapping.
19
- */
20
- import { logger } from '../core/utils/logger.js';
21
- export class AutoDisableScheduler {
22
- storage;
23
- timer = null;
24
- intervalMs;
25
- windowMs;
26
- minAttempts;
27
- refusalRateThreshold;
28
- constructor(storage, opts = {}) {
29
- this.storage = storage;
30
- this.intervalMs = opts.intervalMs ?? 60 * 60 * 1000; // 1h
31
- this.windowMs = opts.windowMs ?? 24 * 60 * 60 * 1000; // 24h
32
- this.minAttempts = opts.minAttempts ?? 10;
33
- this.refusalRateThreshold = opts.refusalRateThreshold ?? 0.8;
34
- }
35
- /** Start periodic scanning. Safe to call multiple times (idempotent). */
36
- start() {
37
- if (this.timer)
38
- return;
39
- // Do not run immediately — give daemon startup time to stabilize.
40
- this.timer = setInterval(() => {
41
- try {
42
- this.scanOnce();
43
- }
44
- catch (err) {
45
- logger.warn(`[AutoDisable] Scan failed: ${err}`);
46
- }
47
- }, this.intervalMs);
48
- if (typeof this.timer.unref === 'function')
49
- this.timer.unref();
50
- logger.info(`[AutoDisable] Scheduler started (interval=${this.intervalMs}ms, window=${this.windowMs}ms)`);
51
- }
52
- stop() {
53
- if (this.timer) {
54
- clearInterval(this.timer);
55
- this.timer = null;
56
- }
57
- }
58
- /**
59
- * Run one scan cycle. Exposed for tests and manual trigger (e.g. Web API).
60
- * Returns the list of (taskType, agent) pairs that were newly auto-disabled.
61
- */
62
- scanOnce() {
63
- const since = Date.now() - this.windowMs;
64
- const events = this.storage.queryRoutingEvents({ since_ts: since, limit: 10000 });
65
- const patterns = new Map();
66
- for (const e of events) {
67
- if (!e.is_forced || e.obeyed === null || e.obeyed === undefined)
68
- continue;
69
- if (!e.routed_to_name)
70
- continue;
71
- let taskType = 'unknown';
72
- try {
73
- const parsed = JSON.parse(e.intent_json ?? '{}');
74
- if (typeof parsed.taskType === 'string')
75
- taskType = parsed.taskType;
76
- }
77
- catch { /* ignore */ }
78
- const key = `${taskType}__${e.routed_to_name}`;
79
- const agg = patterns.get(key) ?? {
80
- taskType,
81
- agent: e.routed_to_name,
82
- attempts: 0,
83
- refusals: 0,
84
- };
85
- agg.attempts++;
86
- if (e.obeyed === 0)
87
- agg.refusals++;
88
- patterns.set(key, agg);
89
- }
90
- const newlyDisabled = [];
91
- for (const p of patterns.values()) {
92
- if (p.attempts < this.minAttempts)
93
- continue;
94
- const rate = p.refusals / p.attempts;
95
- if (rate < this.refusalRateThreshold)
96
- continue;
97
- const existing = this.storage.getRuleState(p.taskType, p.agent);
98
- if (existing && existing.disabled === 1)
99
- continue; // already disabled (manual or auto)
100
- const reason = `自动禁用: 最近 ${Math.round(this.windowMs / 3600000)} 小时违抗率 ${(rate * 100).toFixed(1)}% (${p.refusals}/${p.attempts})`;
101
- this.storage.setRuleState({
102
- taskType: p.taskType,
103
- agent: p.agent,
104
- disabled: true,
105
- reason,
106
- autoDisabled: true,
107
- });
108
- newlyDisabled.push({ taskType: p.taskType, agent: p.agent, refusalRate: rate, attempts: p.attempts });
109
- logger.warn(`[AutoDisable] Disabled rule ${p.taskType}__${p.agent}: ${reason}`);
110
- }
111
- return newlyDisabled;
112
- }
113
- }
114
- //# sourceMappingURL=auto-disable-scheduler.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"auto-disable-scheduler.js","sourceRoot":"","sources":["../../src/daemon/auto-disable-scheduler.ts"],"names":[],"mappings":"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"}
@@ -1,39 +0,0 @@
1
- /**
2
- * PreToolUseHandler — handles PreToolUse hook
3
- *
4
- * Responsibilities:
5
- * 1. Build rule evaluation context from event
6
- * 2. Evaluate governance rules
7
- * 3. Return block/warn/allow decision
8
- */
9
- import type { ForgeEvent, HookResult } from '../../core/types.js';
10
- import type { RuleEngine } from '../../engine/rule-engine.js';
11
- import type { GovernanceDecision } from '../../engine/dsl/types.js';
12
- import type { ContextBuilder } from '../../engine/context-builder.js';
13
- import type { SecurityConfig } from '../../core/types.js';
14
- export declare class PreToolUseHandler {
15
- private ruleEngine;
16
- private contextBuilder;
17
- private sessionStartTime;
18
- private securityGates;
19
- constructor(ruleEngine: RuleEngine, contextBuilder: ContextBuilder, securityConfig?: SecurityConfig);
20
- handle(event: ForgeEvent): Promise<HookResult>;
21
- /**
22
- * Track routing compliance without blocking (inspired by ruflo's design).
23
- *
24
- * Ruflo's approach: routing is a SUGGESTION enforced by CLAUDE.md instructions,
25
- * not a hard block in the hook layer. This prevents the deadlock where:
26
- * 1. UserPrompt injects [ROUTE_TO: agent]
27
- * 2. PreToolUse blocks all tools
28
- * 3. Claude can't call Agent tool because it's blocked
29
- *
30
- * New approach: Let CLAUDE.md guide behavior, track compliance for metrics.
31
- */
32
- private trackRoutingCompliance;
33
- handleWithDecision(event: ForgeEvent): Promise<{
34
- result: HookResult;
35
- decision: GovernanceDecision;
36
- }>;
37
- private findPrimaryMatch;
38
- }
39
- //# sourceMappingURL=pre-tool-use.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"pre-tool-use.d.ts","sourceRoot":"","sources":["../../../src/daemon/handlers/pre-tool-use.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,iCAAiC,CAAC;AAI7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAiB1D,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc;IALxB,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,aAAa,CAA8B;gBAGzC,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,cAAc,EACtC,cAAc,CAAC,EAAE,cAAc;IAO3B,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IA+BpD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,sBAAsB;IA6BxB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,kBAAkB,CAAA;KAAE,CAAC;IAyD1G,OAAO,CAAC,gBAAgB;CASzB"}
@@ -1,166 +0,0 @@
1
- /**
2
- * PreToolUseHandler — handles PreToolUse hook
3
- *
4
- * Responsibilities:
5
- * 1. Build rule evaluation context from event
6
- * 2. Evaluate governance rules
7
- * 3. Return block/warn/allow decision
8
- */
9
- import { logger } from '../../core/utils/logger.js';
10
- import { routingState } from '../routing-state.js';
11
- import { SecurityGates } from '../../engine/security-gates.js';
12
- // Tools that are allowed even when routing is active (investigation phase)
13
- const ROUTING_WHITELIST = new Set([
14
- 'Read', 'Grep', 'Glob', // Code exploration
15
- 'AskUserQuestion', // Clarification
16
- 'WebSearch', 'WebFetch', // Research
17
- ]);
18
- // Tools that trigger routing enforcement (decision/action phase)
19
- const ROUTING_ENFORCEMENT_TOOLS = new Set([
20
- 'Edit', 'Write', 'Bash', // Code modification & execution
21
- 'Agent', 'Task', // Delegation (must match routed agent)
22
- 'NotebookEdit', // Notebook modification
23
- 'EnterPlanMode', 'ExitPlanMode', // Planning (should be done by agent)
24
- ]);
25
- export class PreToolUseHandler {
26
- ruleEngine;
27
- contextBuilder;
28
- sessionStartTime = Date.now();
29
- securityGates = null;
30
- constructor(ruleEngine, contextBuilder, securityConfig) {
31
- this.ruleEngine = ruleEngine;
32
- this.contextBuilder = contextBuilder;
33
- if (securityConfig) {
34
- this.securityGates = new SecurityGates(securityConfig);
35
- }
36
- }
37
- async handle(event) {
38
- // Security checks run first (highest priority)
39
- if (this.securityGates) {
40
- const securityResult = this.securityGates.evaluate(event);
41
- if (securityResult) {
42
- if (securityResult.level === 'block') {
43
- logger.info(`[PreToolUse] BLOCKED by security gate: ${securityResult.checkName}`);
44
- return { allow: false, reason: securityResult.reason };
45
- }
46
- if (securityResult.level === 'warn') {
47
- logger.info(`[PreToolUse] WARNED by security gate: ${securityResult.checkName}`);
48
- // Continue to governance rules but include security warning
49
- const { result } = await this.handleWithDecision(event);
50
- if (result.additionalContext) {
51
- result.additionalContext = `${securityResult.reason}\n\n${result.additionalContext}`;
52
- }
53
- else {
54
- result.additionalContext = securityResult.reason;
55
- }
56
- return result;
57
- }
58
- }
59
- }
60
- // Track routing compliance but don't block (inspired by ruflo's design)
61
- this.trackRoutingCompliance(event);
62
- // Run governance rules
63
- const { result } = await this.handleWithDecision(event);
64
- return result;
65
- }
66
- /**
67
- * Track routing compliance without blocking (inspired by ruflo's design).
68
- *
69
- * Ruflo's approach: routing is a SUGGESTION enforced by CLAUDE.md instructions,
70
- * not a hard block in the hook layer. This prevents the deadlock where:
71
- * 1. UserPrompt injects [ROUTE_TO: agent]
72
- * 2. PreToolUse blocks all tools
73
- * 3. Claude can't call Agent tool because it's blocked
74
- *
75
- * New approach: Let CLAUDE.md guide behavior, track compliance for metrics.
76
- */
77
- trackRoutingCompliance(event) {
78
- const routing = routingState.getRouting(event.session_id);
79
- if (!routing) {
80
- return; // No active routing
81
- }
82
- const toolName = event.tool_name;
83
- if (!toolName) {
84
- return;
85
- }
86
- // Track Agent tool invocations
87
- if (toolName === 'Agent' || toolName === 'Task') {
88
- const subagentType = event.tool_input?.subagent_type;
89
- if (subagentType === routing.agentName) {
90
- // Correct agent invoked - clear routing state
91
- routingState.clearRouting(event.session_id);
92
- logger.info(`[PreToolUse] ✅ Routing complied: ${routing.agentName} invoked correctly`);
93
- }
94
- else {
95
- logger.warn(`[PreToolUse] ⚠️ Routing mismatch: expected ${routing.agentName}, got ${subagentType}`);
96
- }
97
- }
98
- // Log potential routing bypasses (for metrics, not blocking)
99
- if (ROUTING_ENFORCEMENT_TOOLS.has(toolName) && toolName !== 'Agent' && toolName !== 'Task') {
100
- logger.info(`[PreToolUse] ℹ️ Direct tool usage while routing active: ${toolName} (routed to ${routing.agentName})`);
101
- }
102
- }
103
- async handleWithDecision(event) {
104
- try {
105
- const options = {
106
- sessionStartTime: this.sessionStartTime,
107
- };
108
- const ctx = this.contextBuilder.build(event, options);
109
- const evaluation = this.ruleEngine.evaluateDetailed(ctx);
110
- const decision = evaluation.decision;
111
- const primaryMatch = this.findPrimaryMatch(decision, evaluation.matches);
112
- const operatorGuidance = primaryMatch?.operator_guidance;
113
- if (decision.level === 'block') {
114
- logger.info(`[PreToolUse] BLOCKED: ${decision.reason}`);
115
- const reason = operatorGuidance
116
- ? `${decision.reason}\n\n${operatorGuidance}`
117
- : decision.reason ?? 'Blocked by governance rule';
118
- return {
119
- decision,
120
- result: { allow: false, reason },
121
- };
122
- }
123
- if (decision.level === 'warn') {
124
- logger.info(`[PreToolUse] WARN: ${decision.reason}`);
125
- const context = operatorGuidance
126
- ? `[Forge 警告] ${decision.reason}\n\n${operatorGuidance}`
127
- : `[Forge 警告] ${decision.reason}`;
128
- return {
129
- decision,
130
- result: { allow: true, additionalContext: context },
131
- };
132
- }
133
- if (decision.level === 'confirm') {
134
- logger.info(`[PreToolUse] CONFIRM: ${decision.reason}`);
135
- const context = operatorGuidance
136
- ? `[Forge 确认] ${decision.reason}\n\n${operatorGuidance}`
137
- : `[Forge 确认] ${decision.reason}`;
138
- return {
139
- decision,
140
- result: { allow: true, additionalContext: context },
141
- };
142
- }
143
- return {
144
- decision,
145
- result: { allow: true },
146
- };
147
- }
148
- catch (err) {
149
- logger.warn(`[PreToolUse] Handler failed: ${err}`);
150
- return {
151
- decision: { level: 'allow' },
152
- result: { allow: true },
153
- };
154
- }
155
- }
156
- findPrimaryMatch(decision, matches) {
157
- if (decision.rule_id) {
158
- return matches.find((match) => match.id === decision.rule_id);
159
- }
160
- if (decision.level === 'warn') {
161
- return matches.find((match) => match.level === 'warn');
162
- }
163
- return undefined;
164
- }
165
- }
166
- //# sourceMappingURL=pre-tool-use.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"pre-tool-use.js","sourceRoot":"","sources":["../../../src/daemon/handlers/pre-tool-use.ts"],"names":[],"mappings":"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"}
@@ -1,42 +0,0 @@
1
- /**
2
- * RoutingObserver — tracks in-flight routing decisions and judges whether
3
- * the main Claude obeyed the injected agent recommendation.
4
- *
5
- * Lifecycle per session:
6
- * 1. UserPromptSubmit handler: after routing decides an agent, call
7
- * `beginPending(session_id, eventId, routedAgent)`.
8
- * 2. PostToolUse handler: call `observeTool(session_id, tool_name, tool_input)`
9
- * to classify the tool (read-only → ignore, decision-type → judge).
10
- * 3. Stop handler: call `finalizePending(session_id, lastAssistantText?)` to
11
- * flush any still-pending event as obeyed=NULL and optionally extract
12
- * refusal_reason from Claude's last message.
13
- *
14
- * The 30s safety timer ensures stale pending entries are cleaned up even if
15
- * no Stop arrives (e.g. daemon restart window).
16
- */
17
- import type { SQLiteStorage } from '../core/storage/sqlite.js';
18
- export declare class RoutingObserver {
19
- private storage;
20
- private pending;
21
- constructor(storage: SQLiteStorage);
22
- beginPending(sessionId: string, eventId: number, routeRequestId: string, routedAgent: string | null, routedAgents?: string[] | null): void;
23
- observeTool(sessionId: string, toolName: string, toolInput: Record<string, unknown>): void;
24
- /**
25
- * Flush the pending event for a session (obeyed = NULL if still unset,
26
- * persist downstream chain, optionally extract refusal_reason).
27
- */
28
- finalizePending(sessionId: string, lastAssistantText?: string): void;
29
- private timeoutPending;
30
- private finishPending;
31
- private dropPending;
32
- /** Used by tests/introspection. */
33
- getPending(sessionId: string): {
34
- eventId: number;
35
- routeRequestId: string;
36
- routedAgent: string | null;
37
- routedAgents: string[] | null;
38
- } | null;
39
- }
40
- /** Extract refusal explanation from Claude's last message. */
41
- export declare function extractRefusalReason(text: string): string | null;
42
- //# sourceMappingURL=routing-observer.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"routing-observer.d.ts","sourceRoot":"","sources":["../../src/daemon/routing-observer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAgC/D,qBAAa,eAAe;IAGd,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,OAAO,CAAmC;gBAE9B,OAAO,EAAE,aAAa;IAE1C,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAC7B,IAAI;IA0BP,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAkH1F;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI;IAMpE,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IA2DrB,OAAO,CAAC,WAAW;IAOnB,mCAAmC;IACnC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;CAI7I;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAahE"}
@@ -1,264 +0,0 @@
1
- /**
2
- * RoutingObserver — tracks in-flight routing decisions and judges whether
3
- * the main Claude obeyed the injected agent recommendation.
4
- *
5
- * Lifecycle per session:
6
- * 1. UserPromptSubmit handler: after routing decides an agent, call
7
- * `beginPending(session_id, eventId, routedAgent)`.
8
- * 2. PostToolUse handler: call `observeTool(session_id, tool_name, tool_input)`
9
- * to classify the tool (read-only → ignore, decision-type → judge).
10
- * 3. Stop handler: call `finalizePending(session_id, lastAssistantText?)` to
11
- * flush any still-pending event as obeyed=NULL and optionally extract
12
- * refusal_reason from Claude's last message.
13
- *
14
- * The 30s safety timer ensures stale pending entries are cleaned up even if
15
- * no Stop arrives (e.g. daemon restart window).
16
- */
17
- import { logger } from '../core/utils/logger.js';
18
- const OBEYED_TIMEOUT_MS = 120_000;
19
- const READ_ONLY_TOOLS = new Set([
20
- 'Read', 'Grep', 'Glob', 'LS', 'NotebookRead', 'WebFetch', 'WebSearch',
21
- ]);
22
- /**
23
- * These tools are allowed as "investigation" or "housekeeping" before the agent
24
- * is actually called. First tool being one of these doesn't count as disobedience.
25
- */
26
- const INVESTIGATION_TOOLS = new Set([
27
- 'Read', 'Grep', 'Glob', // code investigation
28
- 'TaskCreate', 'TaskUpdate', 'TaskList', 'TaskGet', // task list housekeeping
29
- 'TodoRead', 'TodoWrite', // todo housekeeping (if used)
30
- 'WebFetch', 'WebSearch', // external research
31
- ]);
32
- export class RoutingObserver {
33
- storage;
34
- pending = new Map();
35
- constructor(storage) {
36
- this.storage = storage;
37
- }
38
- beginPending(sessionId, eventId, routeRequestId, routedAgent, routedAgents) {
39
- // Replace any existing pending (new prompt supersedes previous unfinished observation)
40
- const prev = this.pending.get(sessionId);
41
- if (prev) {
42
- clearTimeout(prev.timer);
43
- this.finishPending(sessionId, prev, 'superseded');
44
- }
45
- const timer = setTimeout(() => {
46
- this.timeoutPending(sessionId);
47
- }, OBEYED_TIMEOUT_MS);
48
- timer.unref?.();
49
- this.pending.set(sessionId, {
50
- eventId,
51
- routeRequestId,
52
- routedAgent,
53
- routedAgents: routedAgents ?? null,
54
- t0: Date.now(),
55
- timer,
56
- obeyedWritten: false,
57
- firstToolRecorded: false,
58
- downstreamChain: [],
59
- });
60
- }
61
- observeTool(sessionId, toolName, toolInput) {
62
- const entry = this.pending.get(sessionId);
63
- if (!entry)
64
- return;
65
- const isAgentCall = toolName === 'Agent' || toolName === 'Task';
66
- const subagentType = typeof toolInput.subagent_type === 'string' ? toolInput.subagent_type : null;
67
- // Already judged — but Agent/Task tools have highest priority and can override
68
- if (entry.obeyedWritten) {
69
- // If this is an Agent/Task call that matches the routed agent, override the previous judgment
70
- if (isAgentCall && subagentType !== null) {
71
- const isSingleAgentRouting = entry.routedAgent !== null && entry.routedAgents === null;
72
- if (isSingleAgentRouting && subagentType === entry.routedAgent) {
73
- // Override: this Agent call matches the routing recommendation
74
- const now = Date.now();
75
- try {
76
- this.storage.updateRoutingEvent(entry.eventId, {
77
- obeyed: 1,
78
- first_tool_name: toolName,
79
- first_tool_ts: now,
80
- completed_ts: now,
81
- total_execution_ms: now - entry.t0,
82
- completion_reason: null,
83
- });
84
- entry.downstreamChain.push(subagentType);
85
- logger.info(`[RoutingObserver] Agent tool override: ${subagentType} matched ${entry.routedAgent}`);
86
- }
87
- catch (err) {
88
- logger.warn(`[RoutingObserver] Agent override failed: ${err}`);
89
- }
90
- return;
91
- }
92
- // Not a match, just track in downstream chain
93
- entry.downstreamChain.push(subagentType);
94
- }
95
- return;
96
- }
97
- // Investigation/housekeeping tool — record first_tool_name once, defer obeyed verdict.
98
- // These tools are explicitly allowed before the agent is called.
99
- if (INVESTIGATION_TOOLS.has(toolName)) {
100
- if (!entry.firstToolRecorded) {
101
- try {
102
- this.storage.updateRoutingEvent(entry.eventId, {
103
- first_tool_name: toolName,
104
- first_tool_ts: Date.now(),
105
- });
106
- entry.firstToolRecorded = true;
107
- }
108
- catch (err) {
109
- logger.warn(`[RoutingObserver] updateRoutingEvent (investigation) failed: ${err}`);
110
- }
111
- }
112
- return;
113
- }
114
- // Legacy read-only tools not in INVESTIGATION_TOOLS (e.g. LS, NotebookRead) —
115
- // keep original behavior: ignore silently, no first_tool_name write.
116
- if (READ_ONLY_TOOLS.has(toolName))
117
- return;
118
- // Decision-type tool — judge now.
119
- // For single agent routing: check if subagentType matches routedAgent
120
- // For agent group routing: defer judgment to finalizePending (need to see all Task calls)
121
- const isSingleAgentRouting = entry.routedAgent !== null && entry.routedAgents === null;
122
- const isAgentGroupRouting = entry.routedAgents !== null && entry.routedAgents.length > 0;
123
- let matched = false;
124
- let obeyed = 0;
125
- if (isSingleAgentRouting) {
126
- // Original single-agent logic
127
- matched = isAgentCall && subagentType !== null && subagentType === entry.routedAgent;
128
- obeyed = matched ? 1 : 0;
129
- }
130
- else if (isAgentGroupRouting) {
131
- // For agent group, we need to collect all Task calls before judging
132
- // Track this Task call in downstream chain and defer judgment
133
- if (isAgentCall && subagentType !== null) {
134
- entry.downstreamChain.push(subagentType);
135
- }
136
- // Don't write obeyed yet — wait for finalizePending to judge all calls together
137
- return;
138
- }
139
- const now = Date.now();
140
- const completionReason = matched ? null : 'judged';
141
- const patch = {
142
- obeyed,
143
- ...(matched ? {} : {
144
- completed_ts: now,
145
- total_execution_ms: now - entry.t0,
146
- completion_reason: completionReason,
147
- }),
148
- };
149
- // Only overwrite first_tool_name if we haven't already recorded an investigation tool.
150
- if (!entry.firstToolRecorded) {
151
- patch.first_tool_name = toolName;
152
- patch.first_tool_ts = now;
153
- }
154
- try {
155
- this.storage.updateRoutingEvent(entry.eventId, patch);
156
- entry.obeyedWritten = true;
157
- entry.firstToolRecorded = true;
158
- if (matched && subagentType !== null)
159
- entry.downstreamChain.push(subagentType);
160
- }
161
- catch (err) {
162
- logger.warn(`[RoutingObserver] updateRoutingEvent failed: ${err}`);
163
- }
164
- // If it wasn't an Agent/Task call, we have our verdict — stop tracking
165
- if (!isAgentCall) {
166
- this.dropPending(sessionId);
167
- }
168
- }
169
- /**
170
- * Flush the pending event for a session (obeyed = NULL if still unset,
171
- * persist downstream chain, optionally extract refusal_reason).
172
- */
173
- finalizePending(sessionId, lastAssistantText) {
174
- const entry = this.pending.get(sessionId);
175
- if (!entry)
176
- return;
177
- this.finishPending(sessionId, entry, 'stop', lastAssistantText);
178
- }
179
- timeoutPending(sessionId) {
180
- const entry = this.pending.get(sessionId);
181
- if (!entry)
182
- return;
183
- this.finishPending(sessionId, entry, 'timeout');
184
- }
185
- finishPending(sessionId, entry, completionReason, lastAssistantText) {
186
- const patch = {
187
- completed_ts: Date.now(),
188
- total_execution_ms: Date.now() - entry.t0,
189
- completion_reason: completionReason,
190
- };
191
- // For agent group routing, judge based on downstream chain
192
- const isAgentGroupRouting = entry.routedAgents !== null && entry.routedAgents.length > 0;
193
- if (!entry.obeyedWritten) {
194
- if (isAgentGroupRouting && entry.downstreamChain.length > 0) {
195
- // Agent group routing: check if actual agents are within recommended agents
196
- const recommendedAgents = entry.routedAgents;
197
- const actualAgents = entry.downstreamChain;
198
- // Check if any actual agent is NOT in recommended list
199
- const notInRecommended = actualAgents.filter(a => !recommendedAgents.includes(a));
200
- if (notInRecommended.length > 0) {
201
- // Called agents outside recommendation → obeyed=0
202
- patch.obeyed = 0;
203
- patch.refusal_reason = `调用了推荐之外的 agent: ${notInRecommended.join(', ')}`;
204
- }
205
- else {
206
- // All actual agents are within recommendation → obeyed=1 (partial compliance is OK)
207
- patch.obeyed = 1;
208
- }
209
- }
210
- else {
211
- // Single agent routing or no agent group routing
212
- // Investigation was started but no matching Task followed → obeyed=0.
213
- // Otherwise (no tool at all, pure conversation) → obeyed=null.
214
- patch.obeyed = entry.firstToolRecorded ? 0 : null;
215
- }
216
- }
217
- if (entry.downstreamChain.length > 0) {
218
- patch.downstream_task_chain = JSON.stringify(entry.downstreamChain);
219
- }
220
- if (lastAssistantText && (!entry.obeyedWritten || entry.routedAgent || isAgentGroupRouting)) {
221
- const reason = extractRefusalReason(lastAssistantText);
222
- if (reason && !patch.refusal_reason) {
223
- patch.refusal_reason = reason;
224
- }
225
- }
226
- try {
227
- this.storage.updateRoutingEvent(entry.eventId, patch);
228
- }
229
- catch (err) {
230
- logger.warn(`[RoutingObserver] finalize failed: ${err}`);
231
- }
232
- this.dropPending(sessionId);
233
- }
234
- dropPending(sessionId) {
235
- const entry = this.pending.get(sessionId);
236
- if (!entry)
237
- return;
238
- clearTimeout(entry.timer);
239
- this.pending.delete(sessionId);
240
- }
241
- /** Used by tests/introspection. */
242
- getPending(sessionId) {
243
- const e = this.pending.get(sessionId);
244
- return e ? { eventId: e.eventId, routeRequestId: e.routeRequestId, routedAgent: e.routedAgent, routedAgents: e.routedAgents } : null;
245
- }
246
- }
247
- /** Extract refusal explanation from Claude's last message. */
248
- export function extractRefusalReason(text) {
249
- if (!text)
250
- return null;
251
- const patterns = [
252
- /不适用此路径[^。\n]*[。\n]?/,
253
- /不需要(?:使用|调用|借助)[^。\n]*agent[^。\n]*/i,
254
- /I(?:'m| am) not going to use the \w+ agent[^.\n]*/i,
255
- /Skipping the \w+ agent[^.\n]*/i,
256
- ];
257
- for (const p of patterns) {
258
- const m = text.match(p);
259
- if (m)
260
- return m[0].trim().slice(0, 300);
261
- }
262
- return null;
263
- }
264
- //# sourceMappingURL=routing-observer.js.map