@rryando/arcs 3.10.0 → 4.0.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 (366) hide show
  1. package/README.md +172 -146
  2. package/dist/cli/agent-registry.d.ts +12 -0
  3. package/dist/cli/agent-registry.d.ts.map +1 -0
  4. package/dist/cli/agent-registry.js +67 -0
  5. package/dist/cli/agent-registry.js.map +1 -0
  6. package/dist/cli/arcs-flash.d.ts +2 -0
  7. package/dist/cli/arcs-flash.d.ts.map +1 -0
  8. package/dist/cli/arcs-flash.js +68 -0
  9. package/dist/cli/arcs-flash.js.map +1 -0
  10. package/dist/cli/arcs-orchestrate-caveman.d.ts +2 -14
  11. package/dist/cli/arcs-orchestrate-caveman.d.ts.map +1 -1
  12. package/dist/cli/arcs-orchestrate-caveman.js +6 -97
  13. package/dist/cli/arcs-orchestrate-caveman.js.map +1 -1
  14. package/dist/cli/arcs-orchestrate.d.ts +1 -1
  15. package/dist/cli/arcs-orchestrate.d.ts.map +1 -1
  16. package/dist/cli/arcs-orchestrate.js +40 -383
  17. package/dist/cli/arcs-orchestrate.js.map +1 -1
  18. package/dist/cli/bundle-installer.d.ts +10 -4
  19. package/dist/cli/bundle-installer.d.ts.map +1 -1
  20. package/dist/cli/bundle-installer.js +99 -6
  21. package/dist/cli/bundle-installer.js.map +1 -1
  22. package/dist/cli/commands/batch.js +4 -0
  23. package/dist/cli/commands/batch.js.map +1 -1
  24. package/dist/cli/commands/hooks.d.ts +76 -0
  25. package/dist/cli/commands/hooks.d.ts.map +1 -0
  26. package/dist/cli/commands/hooks.js +436 -0
  27. package/dist/cli/commands/hooks.js.map +1 -0
  28. package/dist/cli/commands/index.d.ts +2 -0
  29. package/dist/cli/commands/index.d.ts.map +1 -1
  30. package/dist/cli/commands/index.js +2 -0
  31. package/dist/cli/commands/index.js.map +1 -1
  32. package/dist/cli/commands/project.js +27 -0
  33. package/dist/cli/commands/project.js.map +1 -1
  34. package/dist/cli/commands/task.js +16 -1
  35. package/dist/cli/commands/task.js.map +1 -1
  36. package/dist/cli/commands/web.d.ts +2 -0
  37. package/dist/cli/commands/web.d.ts.map +1 -0
  38. package/dist/cli/commands/web.js +66 -0
  39. package/dist/cli/commands/web.js.map +1 -0
  40. package/dist/cli/config.d.ts +46 -3
  41. package/dist/cli/config.d.ts.map +1 -1
  42. package/dist/cli/config.js +95 -38
  43. package/dist/cli/config.js.map +1 -1
  44. package/dist/cli/instructions.d.ts +32 -7
  45. package/dist/cli/instructions.d.ts.map +1 -1
  46. package/dist/cli/instructions.js +99 -34
  47. package/dist/cli/instructions.js.map +1 -1
  48. package/dist/cli/orchestrator-shared-blocks.d.ts +31 -0
  49. package/dist/cli/orchestrator-shared-blocks.d.ts.map +1 -0
  50. package/dist/cli/orchestrator-shared-blocks.js +148 -0
  51. package/dist/cli/orchestrator-shared-blocks.js.map +1 -0
  52. package/dist/cli/setup.d.ts.map +1 -1
  53. package/dist/cli/setup.js +230 -91
  54. package/dist/cli/setup.js.map +1 -1
  55. package/dist/retrieval/index-builder.d.ts.map +1 -1
  56. package/dist/retrieval/index-builder.js +29 -1
  57. package/dist/retrieval/index-builder.js.map +1 -1
  58. package/dist/shared/session-vocabulary.d.ts +88 -0
  59. package/dist/shared/session-vocabulary.d.ts.map +1 -0
  60. package/dist/shared/session-vocabulary.js +114 -0
  61. package/dist/shared/session-vocabulary.js.map +1 -0
  62. package/dist/utils/claude-code-hook-install.d.ts +80 -0
  63. package/dist/utils/claude-code-hook-install.d.ts.map +1 -0
  64. package/dist/utils/claude-code-hook-install.js +211 -0
  65. package/dist/utils/claude-code-hook-install.js.map +1 -0
  66. package/dist/utils/claude-transcript.d.ts +206 -0
  67. package/dist/utils/claude-transcript.d.ts.map +1 -0
  68. package/dist/utils/claude-transcript.js +384 -0
  69. package/dist/utils/claude-transcript.js.map +1 -0
  70. package/dist/utils/diagram-generator.d.ts +1 -1
  71. package/dist/utils/diagram-generator.d.ts.map +1 -1
  72. package/dist/utils/diagram-generator.js +3 -2
  73. package/dist/utils/diagram-generator.js.map +1 -1
  74. package/dist/utils/errors.d.ts +6 -2
  75. package/dist/utils/errors.d.ts.map +1 -1
  76. package/dist/utils/errors.js +12 -0
  77. package/dist/utils/errors.js.map +1 -1
  78. package/dist/utils/git.d.ts +21 -0
  79. package/dist/utils/git.d.ts.map +1 -1
  80. package/dist/utils/git.js +65 -1
  81. package/dist/utils/git.js.map +1 -1
  82. package/dist/utils/hook-contract.d.ts +36 -0
  83. package/dist/utils/hook-contract.d.ts.map +1 -0
  84. package/dist/utils/hook-contract.js +35 -0
  85. package/dist/utils/hook-contract.js.map +1 -0
  86. package/dist/utils/hook-token-store.d.ts +61 -0
  87. package/dist/utils/hook-token-store.d.ts.map +1 -0
  88. package/dist/utils/hook-token-store.js +86 -0
  89. package/dist/utils/hook-token-store.js.map +1 -0
  90. package/dist/utils/json-schemas.d.ts +186 -2
  91. package/dist/utils/json-schemas.d.ts.map +1 -1
  92. package/dist/utils/json-schemas.js +48 -4
  93. package/dist/utils/json-schemas.js.map +1 -1
  94. package/dist/utils/knowledge-store.d.ts +7 -1
  95. package/dist/utils/knowledge-store.d.ts.map +1 -1
  96. package/dist/utils/knowledge-store.js +97 -65
  97. package/dist/utils/knowledge-store.js.map +1 -1
  98. package/dist/utils/plan-store.d.ts +8 -0
  99. package/dist/utils/plan-store.d.ts.map +1 -1
  100. package/dist/utils/plan-store.js +98 -59
  101. package/dist/utils/plan-store.js.map +1 -1
  102. package/dist/utils/project-resolver.d.ts +8 -0
  103. package/dist/utils/project-resolver.d.ts.map +1 -1
  104. package/dist/utils/project-resolver.js +7 -2
  105. package/dist/utils/project-resolver.js.map +1 -1
  106. package/dist/utils/session-store.d.ts +339 -0
  107. package/dist/utils/session-store.d.ts.map +1 -0
  108. package/dist/utils/session-store.js +577 -0
  109. package/dist/utils/session-store.js.map +1 -0
  110. package/dist/utils/storage-utils.d.ts +31 -0
  111. package/dist/utils/storage-utils.d.ts.map +1 -1
  112. package/dist/utils/storage-utils.js +116 -5
  113. package/dist/utils/storage-utils.js.map +1 -1
  114. package/dist/utils/task-store.d.ts +7 -0
  115. package/dist/utils/task-store.d.ts.map +1 -1
  116. package/dist/utils/task-store.js +73 -23
  117. package/dist/utils/task-store.js.map +1 -1
  118. package/dist/web-client/assets/GraphCanvas-CTyf_XXQ.js +1 -0
  119. package/dist/web-client/assets/MarkdownEditor-af2vwQOX.js +77 -0
  120. package/dist/web-client/assets/abnfDiagram-VRR7QNED-CdxcKX9t.js +1 -0
  121. package/dist/web-client/assets/arc-Bfaogrm1.js +1 -0
  122. package/dist/web-client/assets/architecture-TIHT7OUA-Bt2-DmfV.js +1 -0
  123. package/dist/web-client/assets/architectureDiagram-ZJ3FMSHR-DOISDv6o.js +36 -0
  124. package/dist/web-client/assets/array-BifhSqXX.js +1 -0
  125. package/dist/web-client/assets/blockDiagram-677ZJIJ3-DKwtbttM.js +132 -0
  126. package/dist/web-client/assets/c4Diagram-LMCZKHZV-CilqK-Mm.js +10 -0
  127. package/dist/web-client/assets/channel-C2mb9np_.js +1 -0
  128. package/dist/web-client/assets/chunk-2Q5K7J3B-C1jixKkw.js +1 -0
  129. package/dist/web-client/assets/chunk-32BRIVSS-C79m1mkG.js +1 -0
  130. package/dist/web-client/assets/chunk-52WLFC77-C6WelGWJ.js +10 -0
  131. package/dist/web-client/assets/chunk-5VM5RSS4-ZNzvKenW.js +15 -0
  132. package/dist/web-client/assets/chunk-7BUUIJ7U-Bb538aSH.js +1 -0
  133. package/dist/web-client/assets/chunk-C7G6YPKG-DLg7ryWI.js +1 -0
  134. package/dist/web-client/assets/chunk-EX3LRPZG-DjWgo4gL.js +231 -0
  135. package/dist/web-client/assets/chunk-FWX5IMBZ-BgS9p_zy.js +2 -0
  136. package/dist/web-client/assets/chunk-HOUHSVGY-DuVR7dZO.js +1 -0
  137. package/dist/web-client/assets/chunk-ICXQ74PX-Y8DlnIJM.js +2 -0
  138. package/dist/web-client/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
  139. package/dist/web-client/assets/chunk-KEIR6QF5-DEvma7oi.js +161 -0
  140. package/dist/web-client/assets/chunk-MOJQB5TN-BEM3QgeD.js +88 -0
  141. package/dist/web-client/assets/chunk-OGEWGWER-DlM8LxGr.js +1 -0
  142. package/dist/web-client/assets/chunk-PUDLZKDR-c6cqNVTx.js +156 -0
  143. package/dist/web-client/assets/chunk-Q4XR5HBZ-C5lNmcka.js +70 -0
  144. package/dist/web-client/assets/chunk-RYQCIY6F-np2RyIY1.js +1 -0
  145. package/dist/web-client/assets/chunk-V7JOEXUC-nSswxvSG.js +206 -0
  146. package/dist/web-client/assets/chunk-VAUOI2AC-CqJkCkT0.js +1 -0
  147. package/dist/web-client/assets/chunk-VR4S4FIN-D3pFchin.js +1 -0
  148. package/dist/web-client/assets/chunk-WYO6CB5R-BI9c-NzI.js +125 -0
  149. package/dist/web-client/assets/chunk-XXDRQBXY-BvKO0v-W.js +1 -0
  150. package/dist/web-client/assets/chunk-Y2CYZVJY-DsF7k-Jl.js +1 -0
  151. package/dist/web-client/assets/chunk-ZGVPDNZ5-CKTF2kLR.js +62 -0
  152. package/dist/web-client/assets/chunk-ZIRB5QZD-BpeS1aZ7.js +32 -0
  153. package/dist/web-client/assets/classDiagram-OUVF2IWQ-CPd_w3Zr.js +1 -0
  154. package/dist/web-client/assets/classDiagram-v2-EOCWNBFH-CPd_w3Zr.js +1 -0
  155. package/dist/web-client/assets/cose-bilkent-JH36ORCC-BebHqzgp.js +1 -0
  156. package/dist/web-client/assets/cynefin-VYW2F7L2-BrJrnfh1.js +1 -0
  157. package/dist/web-client/assets/cynefinDiagram-TSTJHNR4-9jYzPWJZ.js +62 -0
  158. package/dist/web-client/assets/cytoscape-fcose-peAzqedC.js +1 -0
  159. package/dist/web-client/assets/cytoscape.esm-C3UvhD5t.js +321 -0
  160. package/dist/web-client/assets/dagre-Buvkdvvj.js +1 -0
  161. package/dist/web-client/assets/dagre-VKFMJZFB-B705Djpu.js +4 -0
  162. package/dist/web-client/assets/defaultLocale-BFoDCU3G.js +1 -0
  163. package/dist/web-client/assets/diagram-FQU43EPY-BfQAlUlJ.js +3 -0
  164. package/dist/web-client/assets/diagram-G47NLZAW-s1YDe06A.js +24 -0
  165. package/dist/web-client/assets/diagram-NH7WQ7WH-Dy3z11Hc.js +24 -0
  166. package/dist/web-client/assets/diagram-OA4YK3LP-Bius2xUN.js +30 -0
  167. package/dist/web-client/assets/diagram-WEI45ONY-D7x4VcHM.js +41 -0
  168. package/dist/web-client/assets/dist-B_J_HbC0.js +1 -0
  169. package/dist/web-client/assets/ebnfDiagram-CCIWWBDH-CBg1xrmD.js +1 -0
  170. package/dist/web-client/assets/erDiagram-Q63AITRT-CJRvTFvd.js +85 -0
  171. package/dist/web-client/assets/eventmodeling-45OFAUF4-CTKRC2Yj.js +1 -0
  172. package/dist/web-client/assets/flowDiagram-23GEKE2U-CaZjFyU1.js +1 -0
  173. package/dist/web-client/assets/ganttDiagram-NO4QXBWP-C_LsypZ4.js +292 -0
  174. package/dist/web-client/assets/gitGraph-TEB2WS4Q-Dx2XxdGk.js +1 -0
  175. package/dist/web-client/assets/gitGraphDiagram-IHSO6WYX-DiKWkGWQ.js +106 -0
  176. package/dist/web-client/assets/graphlib-DS17s2tU.js +1 -0
  177. package/dist/web-client/assets/index-CYwhkPtc.js +60 -0
  178. package/dist/web-client/assets/index-wSzUPvml.css +2 -0
  179. package/dist/web-client/assets/info-DKCQHKI2-DORwHenK.js +1 -0
  180. package/dist/web-client/assets/infoDiagram-FWYZ7A6U-CQecXS1E.js +2 -0
  181. package/dist/web-client/assets/init-C-OQMol4.js +1 -0
  182. package/dist/web-client/assets/ishikawaDiagram-FXEZZL3T-CWhj60Zp.js +70 -0
  183. package/dist/web-client/assets/jetbrains-mono-cyrillic-wght-normal-D73BlboJ.woff2 +0 -0
  184. package/dist/web-client/assets/jetbrains-mono-greek-wght-normal-Bw9x6K1M.woff2 +0 -0
  185. package/dist/web-client/assets/jetbrains-mono-latin-ext-wght-normal-DBQx-q_a.woff2 +0 -0
  186. package/dist/web-client/assets/jetbrains-mono-latin-wght-normal-B9CIFXIH.woff2 +0 -0
  187. package/dist/web-client/assets/jetbrains-mono-vietnamese-wght-normal-Bt-aOZkq.woff2 +0 -0
  188. package/dist/web-client/assets/journeyDiagram-5HDEW3XC-Cj3z2U8u.js +139 -0
  189. package/dist/web-client/assets/kanban-definition-HUTT4EX6-DFmBRenP.js +89 -0
  190. package/dist/web-client/assets/katex-DolUETbr.js +257 -0
  191. package/dist/web-client/assets/line-C_Hxz9xb.js +1 -0
  192. package/dist/web-client/assets/linear-DeUiD2wj.js +1 -0
  193. package/dist/web-client/assets/map-BaFkSB1l.js +1 -0
  194. package/dist/web-client/assets/mermaid-parser.core-E3xRdzPn.js +7 -0
  195. package/dist/web-client/assets/mermaid.core-C2_CcotH.js +11 -0
  196. package/dist/web-client/assets/mindmap-definition-LN4V7U3C-Bs7VxPid.js +96 -0
  197. package/dist/web-client/assets/ordinal-BDEzSJ7C.js +1 -0
  198. package/dist/web-client/assets/packet-7NZHBO7P-D2nqso7i.js +1 -0
  199. package/dist/web-client/assets/path-COt_16Va.js +1 -0
  200. package/dist/web-client/assets/pegDiagram-2B236MQR-Cepo1sIu.js +1 -0
  201. package/dist/web-client/assets/pie-RZYD4A2V-Sx0IGbXt.js +1 -0
  202. package/dist/web-client/assets/pieDiagram-ENE6RG2P-D-PMDNhk.js +39 -0
  203. package/dist/web-client/assets/quadrantDiagram-ABIIQ3AL-BNGC7Fms.js +7 -0
  204. package/dist/web-client/assets/radar-I7S5WNFK-CFf_-2OC.js +1 -0
  205. package/dist/web-client/assets/railroad-3IZDKUUU-BvZeVRGh.js +1 -0
  206. package/dist/web-client/assets/railroad-abnf-AHOZXSZD-DnGh6x2O.js +1 -0
  207. package/dist/web-client/assets/railroad-ebnf-EBAXGLYW-CGfgCoaE.js +1 -0
  208. package/dist/web-client/assets/railroad-peg-LSFZ7HO6-BzQxYdqp.js +1 -0
  209. package/dist/web-client/assets/railroadDiagram-RFXS5EU6-D0iK_k84.js +1 -0
  210. package/dist/web-client/assets/requirementDiagram-TGXJPOKE-BPdsw9tz.js +84 -0
  211. package/dist/web-client/assets/rolldown-runtime-Dd_uD5pT.js +1 -0
  212. package/dist/web-client/assets/rough.esm-By172zw-.js +1 -0
  213. package/dist/web-client/assets/sankeyDiagram-HTMAVEWB-maA6ukOJ.js +40 -0
  214. package/dist/web-client/assets/sequenceDiagram-DBY2YBRQ-DKmAjmgr.js +162 -0
  215. package/dist/web-client/assets/sizeCapture-X5ZJPWSS-B0uUizjq.js +1 -0
  216. package/dist/web-client/assets/src-oBChb5qS.js +1 -0
  217. package/dist/web-client/assets/stateDiagram-2N3HPSRC-esxmzk3w.js +1 -0
  218. package/dist/web-client/assets/stateDiagram-v2-6OUMAXLB-hcBqlOLc.js +1 -0
  219. package/dist/web-client/assets/swimlanes-5IMT3BWC-DFd-wGBv.js +2 -0
  220. package/dist/web-client/assets/swimlanesDiagram-G3AALYLV-DbSrPBYr.js +8 -0
  221. package/dist/web-client/assets/timeline-definition-FHXFAJF6-C7SG8MQH.js +120 -0
  222. package/dist/web-client/assets/treeView-QDETBFTQ-M0rhxbs2.js +1 -0
  223. package/dist/web-client/assets/treemap-6X3UGDF4-BQfkQxSh.js +1 -0
  224. package/dist/web-client/assets/vennDiagram-L72KCM5P-CyIlb8ju.js +34 -0
  225. package/dist/web-client/assets/wardley-OPB4EBWU-EE-7q8M1.js +1 -0
  226. package/dist/web-client/assets/wardleyDiagram-EHGQE667-bY8XdYYS.js +78 -0
  227. package/dist/web-client/assets/xychartDiagram-FW5EYKEG-AhuXJ3de.js +7 -0
  228. package/dist/web-client/index.html +15 -0
  229. package/dist/web-server/app.d.ts +16 -0
  230. package/dist/web-server/app.d.ts.map +1 -0
  231. package/dist/web-server/app.js +77 -0
  232. package/dist/web-server/app.js.map +1 -0
  233. package/dist/web-server/claude-runner.d.ts +188 -0
  234. package/dist/web-server/claude-runner.d.ts.map +1 -0
  235. package/dist/web-server/claude-runner.js +599 -0
  236. package/dist/web-server/claude-runner.js.map +1 -0
  237. package/dist/web-server/hook-auth.d.ts +12 -0
  238. package/dist/web-server/hook-auth.d.ts.map +1 -0
  239. package/dist/web-server/hook-auth.js +36 -0
  240. package/dist/web-server/hook-auth.js.map +1 -0
  241. package/dist/web-server/index.d.ts +23 -0
  242. package/dist/web-server/index.d.ts.map +1 -0
  243. package/dist/web-server/index.js +50 -0
  244. package/dist/web-server/index.js.map +1 -0
  245. package/dist/web-server/opencode-client.d.ts +123 -0
  246. package/dist/web-server/opencode-client.d.ts.map +1 -0
  247. package/dist/web-server/opencode-client.js +514 -0
  248. package/dist/web-server/opencode-client.js.map +1 -0
  249. package/dist/web-server/permission-policy.d.ts +46 -0
  250. package/dist/web-server/permission-policy.d.ts.map +1 -0
  251. package/dist/web-server/permission-policy.js +96 -0
  252. package/dist/web-server/permission-policy.js.map +1 -0
  253. package/dist/web-server/prompt-assembly.d.ts +454 -0
  254. package/dist/web-server/prompt-assembly.d.ts.map +1 -0
  255. package/dist/web-server/prompt-assembly.js +1122 -0
  256. package/dist/web-server/prompt-assembly.js.map +1 -0
  257. package/dist/web-server/respond.d.ts +33 -0
  258. package/dist/web-server/respond.d.ts.map +1 -0
  259. package/dist/web-server/respond.js +79 -0
  260. package/dist/web-server/respond.js.map +1 -0
  261. package/dist/web-server/routes/collections.d.ts +11 -0
  262. package/dist/web-server/routes/collections.d.ts.map +1 -0
  263. package/dist/web-server/routes/collections.js +217 -0
  264. package/dist/web-server/routes/collections.js.map +1 -0
  265. package/dist/web-server/routes/discovery.d.ts +7 -0
  266. package/dist/web-server/routes/discovery.d.ts.map +1 -0
  267. package/dist/web-server/routes/discovery.js +159 -0
  268. package/dist/web-server/routes/discovery.js.map +1 -0
  269. package/dist/web-server/routes/events.d.ts +6 -0
  270. package/dist/web-server/routes/events.d.ts.map +1 -0
  271. package/dist/web-server/routes/events.js +25 -0
  272. package/dist/web-server/routes/events.js.map +1 -0
  273. package/dist/web-server/routes/hook-events.d.ts +44 -0
  274. package/dist/web-server/routes/hook-events.d.ts.map +1 -0
  275. package/dist/web-server/routes/hook-events.js +320 -0
  276. package/dist/web-server/routes/hook-events.js.map +1 -0
  277. package/dist/web-server/routes/projects.d.ts +7 -0
  278. package/dist/web-server/routes/projects.d.ts.map +1 -0
  279. package/dist/web-server/routes/projects.js +272 -0
  280. package/dist/web-server/routes/projects.js.map +1 -0
  281. package/dist/web-server/routes/sessions.d.ts +18 -0
  282. package/dist/web-server/routes/sessions.d.ts.map +1 -0
  283. package/dist/web-server/routes/sessions.js +1298 -0
  284. package/dist/web-server/routes/sessions.js.map +1 -0
  285. package/dist/web-server/routes/workspace.d.ts +27 -0
  286. package/dist/web-server/routes/workspace.d.ts.map +1 -0
  287. package/dist/web-server/routes/workspace.js +280 -0
  288. package/dist/web-server/routes/workspace.js.map +1 -0
  289. package/dist/web-server/run-event-log.d.ts +167 -0
  290. package/dist/web-server/run-event-log.d.ts.map +1 -0
  291. package/dist/web-server/run-event-log.js +468 -0
  292. package/dist/web-server/run-event-log.js.map +1 -0
  293. package/dist/web-server/security.d.ts +7 -0
  294. package/dist/web-server/security.d.ts.map +1 -0
  295. package/dist/web-server/security.js +41 -0
  296. package/dist/web-server/security.js.map +1 -0
  297. package/dist/web-server/session-reconciler.d.ts +162 -0
  298. package/dist/web-server/session-reconciler.d.ts.map +1 -0
  299. package/dist/web-server/session-reconciler.js +363 -0
  300. package/dist/web-server/session-reconciler.js.map +1 -0
  301. package/dist/web-server/static.d.ts +17 -0
  302. package/dist/web-server/static.d.ts.map +1 -0
  303. package/dist/web-server/static.js +79 -0
  304. package/dist/web-server/static.js.map +1 -0
  305. package/dist/web-server/storage.d.ts +17 -0
  306. package/dist/web-server/storage.d.ts.map +1 -0
  307. package/dist/web-server/storage.js +42 -0
  308. package/dist/web-server/storage.js.map +1 -0
  309. package/dist/web-server/watcher.d.ts +37 -0
  310. package/dist/web-server/watcher.d.ts.map +1 -0
  311. package/dist/web-server/watcher.js +181 -0
  312. package/dist/web-server/watcher.js.map +1 -0
  313. package/dist/web-server/web-auth.d.ts +17 -0
  314. package/dist/web-server/web-auth.d.ts.map +1 -0
  315. package/dist/web-server/web-auth.js +33 -0
  316. package/dist/web-server/web-auth.js.map +1 -0
  317. package/dist/web-server/web-token.d.ts +39 -0
  318. package/dist/web-server/web-token.d.ts.map +1 -0
  319. package/dist/web-server/web-token.js +71 -0
  320. package/dist/web-server/web-token.js.map +1 -0
  321. package/opencode/arcs/bundle-runtime.json +5 -13
  322. package/opencode/arcs/manifest.json +215 -151
  323. package/opencode/arcs/prompts/arcs-docs.txt +53 -47
  324. package/opencode/arcs/prompts/arcs-flash.txt +190 -0
  325. package/opencode/arcs/prompts/arcs-orchestrate-caveman.txt +116 -422
  326. package/opencode/arcs/prompts/arcs-orchestrate.txt +114 -341
  327. package/opencode/arcs/prompts/code-reviewer.txt +37 -98
  328. package/opencode/arcs/prompts/devil-advocate.txt +44 -115
  329. package/opencode/arcs/prompts/graph-explorer.txt +31 -179
  330. package/opencode/arcs/prompts/software-engineer.txt +24 -6
  331. package/opencode/arcs/prompts/tech-architect.txt +25 -9
  332. package/opencode/arcs/skills/brainstorming/SKILL.md +65 -105
  333. package/opencode/arcs/skills/deep-pr-review/SKILL.md +5 -5
  334. package/opencode/arcs/skills/deep-pr-review/review-template.md +1 -1
  335. package/opencode/arcs/skills/enriching-codegraph-proposals/SKILL.md +17 -18
  336. package/opencode/arcs/skills/executing-plans/SKILL.md +26 -234
  337. package/opencode/arcs/skills/implementation/SKILL.md +61 -0
  338. package/opencode/arcs/skills/init-project/SKILL.md +16 -15
  339. package/opencode/arcs/skills/install-claude-code-hook/SKILL.md +143 -0
  340. package/opencode/arcs/skills/systematic-debugging/SKILL.md +7 -7
  341. package/opencode/arcs/skills/test-driven-development/SKILL.md +1 -1
  342. package/opencode/arcs/skills/to-diagram/SKILL.md +8 -3
  343. package/opencode/arcs/skills/writing-knowledge/SKILL.md +7 -6
  344. package/opencode/arcs/skills/writing-plans/SKILL.md +80 -130
  345. package/opencode/arcs/skills/writing-plans/plan-document-reviewer-prompt.md +38 -30
  346. package/package.json +14 -6
  347. package/scripts/build-opencode-bundle.mjs +22 -7
  348. package/scripts/claude-code-session-hook.mjs +171 -0
  349. package/scripts/deploy-claudecode-bundle.mjs +206 -132
  350. package/scripts/deploy-opencode-bundle.mjs +181 -5
  351. package/scripts/lib/bundle-helpers.mjs +26 -0
  352. package/scripts/lint-bundle.mjs +123 -3
  353. package/skills/explore-dag.md +5 -3
  354. package/skills/init-project.md +27 -26
  355. package/skills/orchestrate.md +29 -13
  356. package/skills/update-docs.md +8 -13
  357. package/opencode/arcs/prompts/docs-researcher.txt +0 -79
  358. package/opencode/arcs/prompts/oncall-ops.txt +0 -85
  359. package/opencode/arcs/skills/code-agent/SKILL.md +0 -63
  360. package/opencode/arcs/skills/executing-plans/code-quality-reviewer-prompt.md +0 -57
  361. package/opencode/arcs/skills/executing-plans/implementer-prompt.md +0 -152
  362. package/opencode/arcs/skills/executing-plans/spec-reviewer-prompt.md +0 -91
  363. package/opencode/arcs/skills/quick-dev/SKILL.md +0 -52
  364. package/opencode/arcs/skills/requesting-code-review/SKILL.md +0 -59
  365. package/opencode/arcs/skills/requesting-code-review/code-reviewer.md +0 -139
  366. package/opencode/arcs/skills/the-ladder/SKILL.md +0 -54
@@ -0,0 +1,25 @@
1
+ /**
2
+ * SSE route: pushes debounced data-dir change events to connected clients.
3
+ */
4
+ import { Hono } from "hono";
5
+ import { streamSSE } from "hono/streaming";
6
+ import { onDataChange } from "../watcher.js";
7
+ export const eventsRoute = new Hono();
8
+ const HEARTBEAT_MS = 25_000;
9
+ eventsRoute.get("/api/events", (c) => streamSSE(c, async (stream) => {
10
+ const listener = (event) => {
11
+ void stream.writeSSE({ event: "change", data: JSON.stringify(event) }).catch(() => { });
12
+ };
13
+ const unsubscribe = onDataChange(listener);
14
+ const heartbeat = setInterval(() => {
15
+ void stream.writeSSE({ event: "ping", data: "{}" }).catch(() => { });
16
+ }, HEARTBEAT_MS);
17
+ await new Promise((resolve) => {
18
+ stream.onAbort(() => {
19
+ clearInterval(heartbeat);
20
+ unsubscribe();
21
+ resolve();
22
+ });
23
+ });
24
+ }));
25
+ //# sourceMappingURL=events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/web-server/routes/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;AAEtC,MAAM,YAAY,GAAG,MAAM,CAAC;AAE5B,WAAW,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CACnC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAC5B,MAAM,QAAQ,GAAG,CAAC,KAAkB,EAAE,EAAE;QACtC,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE3C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACtE,CAAC,EAAE,YAAY,CAAC,CAAC;IAEjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;YAClB,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CAAC"}
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Claude Code session-bridge endpoint.
3
+ *
4
+ * Claude Code has no live-injection channel: hooks are stateless, fire per
5
+ * event, and hold no persistent connection. So the session drives the bridge —
6
+ * it announces itself at `SessionStart`, picks up whatever the web UI queued at
7
+ * every `UserPromptSubmit` checkpoint, closes out at `SessionEnd`, and reports
8
+ * its transcript at `Stop` (the last checkpoint before teardown).
9
+ *
10
+ * Those checkpoints are also the only liveness signal an observed session ever
11
+ * emits, so each one stamps `lastCheckpointAt` — the field the session's derived
12
+ * phase reads to decide whether a terminal is still working.
13
+ *
14
+ * `SessionStart` additionally answers with `stagedContext`: the same staged
15
+ * environment an ARCS-owned headless run carries on `--append-system-prompt`,
16
+ * so a terminal a human drives knows its project, its workspace and its DAG
17
+ * position without the human setting the stage by hand. See
18
+ * `sessionStartContext` for what differs from the owned path.
19
+ *
20
+ * The response stays ARCS-shaped (`{sessionId, queuedMessages, stagedContext?}`);
21
+ * turning that into Claude Code's `hookSpecificOutput` envelope is the hook
22
+ * script's job, so a change to Claude Code's wire format never reaches the
23
+ * server.
24
+ *
25
+ * Unlike every other route here this one is not browser-facing, so it sits
26
+ * behind `requireHookToken` in addition to the global loopback check.
27
+ */
28
+ import { Hono } from "hono";
29
+ export declare const hookEventsRoute: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
30
+ /**
31
+ * Ceiling on the block a SessionStart mirrors into a terminal, in characters.
32
+ *
33
+ * Deliberately far below `STAGE_SOFT_CAP` (6000): that budget is spent inside a
34
+ * headless `claude -p` process nobody is watching, whereas this text lands at
35
+ * the head of a live session a human is about to type into. Anything wider buys
36
+ * context nobody asked for at the cost of the window they did.
37
+ *
38
+ * Enforced by SELECTION, never by clipping — see `sessionStartContext`.
39
+ * `scripts/claude-code-session-hook.mjs` carries its own, wider refusal bound
40
+ * (`MAX_CONTEXT_CHARS`), pinned against this constant by
41
+ * `test/claude-code-hook-script.test.ts`.
42
+ */
43
+ export declare const SESSION_START_STAGE_CAP = 2500;
44
+ //# sourceMappingURL=hook-events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hook-events.d.ts","sourceRoot":"","sources":["../../../src/web-server/routes/hook-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAkB5B,eAAO,MAAM,eAAe,4EAAa,CAAC;AAsI1C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC"}
@@ -0,0 +1,320 @@
1
+ /**
2
+ * Claude Code session-bridge endpoint.
3
+ *
4
+ * Claude Code has no live-injection channel: hooks are stateless, fire per
5
+ * event, and hold no persistent connection. So the session drives the bridge —
6
+ * it announces itself at `SessionStart`, picks up whatever the web UI queued at
7
+ * every `UserPromptSubmit` checkpoint, closes out at `SessionEnd`, and reports
8
+ * its transcript at `Stop` (the last checkpoint before teardown).
9
+ *
10
+ * Those checkpoints are also the only liveness signal an observed session ever
11
+ * emits, so each one stamps `lastCheckpointAt` — the field the session's derived
12
+ * phase reads to decide whether a terminal is still working.
13
+ *
14
+ * `SessionStart` additionally answers with `stagedContext`: the same staged
15
+ * environment an ARCS-owned headless run carries on `--append-system-prompt`,
16
+ * so a terminal a human drives knows its project, its workspace and its DAG
17
+ * position without the human setting the stage by hand. See
18
+ * `sessionStartContext` for what differs from the owned path.
19
+ *
20
+ * The response stays ARCS-shaped (`{sessionId, queuedMessages, stagedContext?}`);
21
+ * turning that into Claude Code's `hookSpecificOutput` envelope is the hook
22
+ * script's job, so a change to Claude Code's wire format never reaches the
23
+ * server.
24
+ *
25
+ * Unlike every other route here this one is not browser-facing, so it sits
26
+ * behind `requireHookToken` in addition to the global loopback check.
27
+ */
28
+ import { join } from "node:path";
29
+ import { Hono } from "hono";
30
+ import { z } from "zod";
31
+ import { mirrorSessionTranscript } from "../../utils/claude-transcript.js";
32
+ import { HOOK_EVENTS } from "../../utils/hook-contract.js";
33
+ import { readJsonSafe } from "../../utils/json.js";
34
+ import { readPlanIndex } from "../../utils/plan-store.js";
35
+ import { drainSessionMessageQueue, getSession, updateSession, upsertSession, } from "../../utils/session-store.js";
36
+ import { listTasks } from "../../utils/task-store.js";
37
+ import { deriveOperatingBrief } from "../../utils/workflow-policy.js";
38
+ import { buildStagedEnvironment, stripStageDelimiters } from "../prompt-assembly.js";
39
+ import { parseBody, requireProjectDir, respond } from "../respond.js";
40
+ export const hookEventsRoute = new Hono();
41
+ /**
42
+ * Claude Code's native stdin fields, forwarded verbatim by the hook script.
43
+ * Unknown extra fields are ignored rather than rejected — Claude Code adds
44
+ * fields between releases and a hook must not start failing because of it.
45
+ *
46
+ * The accepted event names come straight from the bridge contract: the server
47
+ * cannot end up rejecting an event the installer registered the hook for.
48
+ */
49
+ const hookEventSchema = z.object({
50
+ hook_event_name: z.enum(HOOK_EVENTS),
51
+ session_id: z.string().min(1),
52
+ cwd: z.string().optional(),
53
+ source: z.string().optional(),
54
+ prompt: z.string().optional(),
55
+ reason: z.string().optional(),
56
+ transcript_path: z.string().optional(),
57
+ control: z.string().optional(),
58
+ });
59
+ /**
60
+ * Builds the metadata persisted on the session. Claude Code's `cwd` lands under
61
+ * the `directory` key: that is the metadata key the sessions UI and the opencode
62
+ * bridge already read, so both runtimes render their worktree the same way.
63
+ * `transcript_path` is persisted under `transcriptPath` (the sessions UI reads
64
+ * that key) so headless-run write-backs can resolve the transcript without the
65
+ * client resupplying it, and `control` is persisted verbatim for back-compat
66
+ * with readers that still display it — it no longer decides anything here, the
67
+ * session's persisted `origin` does.
68
+ */
69
+ function sessionMetadata(event) {
70
+ const metadata = {
71
+ ...(event.cwd && { directory: event.cwd }),
72
+ ...(event.source && { source: event.source }),
73
+ ...(event.control !== undefined && { control: event.control }),
74
+ ...(event.transcript_path !== undefined && { transcriptPath: event.transcript_path }),
75
+ };
76
+ return Object.keys(metadata).length > 0 ? metadata : undefined;
77
+ }
78
+ /**
79
+ * Registers (or refreshes) the session behind a hook event.
80
+ *
81
+ * Anything announcing itself through this endpoint is by definition a real
82
+ * terminal session ARCS is watching, so a record created here is `observed` —
83
+ * which is what makes it queueable. Provenance is create-only in the store, so
84
+ * an event arriving for an ARCS-owned thread refreshes it without demoting it.
85
+ */
86
+ function registerSession(projectDir, event) {
87
+ const metadata = sessionMetadata(event);
88
+ return upsertSession(projectDir, {
89
+ runtimeType: "claude-code",
90
+ runtimeSessionId: event.session_id,
91
+ origin: "observed",
92
+ status: "active",
93
+ ...(metadata && { metadata }),
94
+ });
95
+ }
96
+ /**
97
+ * Records the checkpoint itself, plus whatever it carried.
98
+ *
99
+ * `lastCheckpointAt` is written at EVERY UserPromptSubmit and Stop, even for an
100
+ * event with no metadata at all: it is the only proof of life a session ARCS
101
+ * merely observes ever emits, and the derived phase reads nothing else for such
102
+ * a session. Miss one and a working terminal reads idle.
103
+ *
104
+ * ISO-8601, like every other top-level session timestamp (`metadata.run` keeps
105
+ * epoch ms — the two units never mix). Checkpoint-derived metadata
106
+ * (transcriptPath, directory…) rides the same write, so the transcript path a
107
+ * checkpoint carries is still never dropped.
108
+ */
109
+ async function persistCheckpoint(projectDir, session, event) {
110
+ const metadata = sessionMetadata(event);
111
+ return updateSession(projectDir, {
112
+ id: session.normalizedId,
113
+ lastCheckpointAt: new Date().toISOString(),
114
+ ...(metadata !== undefined && { metadata }),
115
+ });
116
+ }
117
+ /**
118
+ * Whether a checkpoint's runtime transcript should be mirrored into the
119
+ * session's sidecar.
120
+ *
121
+ * Only sessions ARCS observes qualify. An `arcs`-origin record owns its sidecar
122
+ * through the run route's own turn appends, so mirroring a runtime transcript
123
+ * on top would duplicate the conversation. The rule reads the persisted origin,
124
+ * never `metadata.control`.
125
+ */
126
+ function shouldMirrorTranscript(session) {
127
+ return session.origin === "observed";
128
+ }
129
+ /**
130
+ * Resolves the session behind a checkpoint, registering it if this is the first
131
+ * event ARCS has seen. `resume`/`compact` can deliver a prompt for a session
132
+ * whose SessionStart never reached us, and dropping the checkpoint would strand
133
+ * every message queued for it.
134
+ */
135
+ async function resolveCheckpointSession(projectDir, event) {
136
+ try {
137
+ return await getSession(projectDir, event.session_id);
138
+ }
139
+ catch {
140
+ return registerSession(projectDir, event);
141
+ }
142
+ }
143
+ // ---------------------------------------------------------------------------
144
+ // SessionStart staged context
145
+ // ---------------------------------------------------------------------------
146
+ /**
147
+ * Ceiling on the block a SessionStart mirrors into a terminal, in characters.
148
+ *
149
+ * Deliberately far below `STAGE_SOFT_CAP` (6000): that budget is spent inside a
150
+ * headless `claude -p` process nobody is watching, whereas this text lands at
151
+ * the head of a live session a human is about to type into. Anything wider buys
152
+ * context nobody asked for at the cost of the window they did.
153
+ *
154
+ * Enforced by SELECTION, never by clipping — see `sessionStartContext`.
155
+ * `scripts/claude-code-session-hook.mjs` carries its own, wider refusal bound
156
+ * (`MAX_CONTEXT_CHARS`), pinned against this constant by
157
+ * `test/claude-code-hook-script.test.ts`.
158
+ */
159
+ export const SESSION_START_STAGE_CAP = 2500;
160
+ /** Width for one value interpolated into the degraded block. */
161
+ const DEGRADED_FIELD_WIDTH = 160;
162
+ /**
163
+ * Normalizes one untrusted value for an ARCS-authored line: delimiter-stripped,
164
+ * whitespace-collapsed, width-bounded. Mirrors prompt-assembly's `field` (not
165
+ * exported), and applies to EVERY slot below rather than to the values that
166
+ * look risky — a project name and a task title are both agent- or user-authored
167
+ * text arriving in the controller's voice.
168
+ */
169
+ function degradedField(value, width = DEGRADED_FIELD_WIDTH) {
170
+ const clean = stripStageDelimiters(value).replace(/\s+/g, " ").trim();
171
+ return clean.length <= width ? clean : `${clean.slice(0, width - 1)}…`;
172
+ }
173
+ /**
174
+ * The two lines a session with nothing staged for it still deserves.
175
+ *
176
+ * An observed session carries no `linkedNodeId` until a human sets one —
177
+ * discovery never links — so this is the COMMON case at SessionStart, not an
178
+ * edge. It therefore states what is true and useful (which project this
179
+ * workspace is, how to read its DAG, and what the operating brief says the
180
+ * project is currently on) instead of apologising for the missing link.
181
+ *
182
+ * No wrapper, and none needed: nothing here is a quoted body. The two variable
183
+ * values are stripped, collapsed and width-bounded through `degradedField`,
184
+ * exactly as prompt-assembly treats the same task title in its own brief block.
185
+ */
186
+ async function degradedStagedContext(projectDir, slug) {
187
+ const [projectMeta, tasks, planIndex] = await Promise.all([
188
+ readJsonSafe(join(projectDir, "meta.json")),
189
+ listTasks(projectDir),
190
+ readPlanIndex(projectDir),
191
+ ]);
192
+ const operating = deriveOperatingBrief({
193
+ tasks: tasks.map((t) => ({
194
+ id: t.id,
195
+ title: t.title,
196
+ status: t.status,
197
+ planId: t.planId,
198
+ priority: t.priority,
199
+ dependsOn: t.dependsOn,
200
+ })),
201
+ plans: planIndex.plans.map((p) => ({ id: p.id, title: p.title, status: p.status })),
202
+ });
203
+ return [
204
+ `This workspace is tracked by ARCS as project ${degradedField(slug)} ` +
205
+ `"${degradedField(projectMeta?.name ?? slug)}" — read its DAG with ` +
206
+ `\`arcs brief ${degradedField(slug)} --lean --json\`. Link this session to a task in the ` +
207
+ "ARCS web UI to stage that task's scope, acceptance and verify command here.",
208
+ `Project current focus: ${degradedField(operating.currentFocus)} · ` +
209
+ `Next action: ${degradedField(operating.nextAction)}`,
210
+ ].join("\n");
211
+ }
212
+ /**
213
+ * The staged block a SessionStart answers with, or nothing at all.
214
+ *
215
+ * Same builder as an ARCS-owned headless run (`buildStagedEnvironment`), and
216
+ * deliberately NOT the same call:
217
+ * - no references — those are attached per SEND, and a session that has not
218
+ * started yet has none;
219
+ * - no argv, no permission segment — the terminal's user owns their own
220
+ * permissions and ARCS does not get to narrow them from here;
221
+ * - a much tighter cap (see SESSION_START_STAGE_CAP);
222
+ * - STATELESS — no fingerprint, no `metadata.stage`, no restage bookkeeping at
223
+ * all. The staleness machinery exists to avoid re-injecting an unchanged
224
+ * block across turns of one conversation; a SessionStart IS turn zero, so
225
+ * there is nothing to compare against and nothing to persist.
226
+ *
227
+ * The cap is enforced by SELECTION — the whole assembled text, or the whole
228
+ * degraded block — never by clipping the assembled text. A head truncation
229
+ * would keep an untrusted body's opener and sever its closer, putting every
230
+ * later ARCS-authored line (including the one stating the controller's own
231
+ * scope) inside an unterminated untrusted region. `softCap` lets the builder's
232
+ * own ladder degrade gracefully first; the degraded block is the floor for the
233
+ * DAG wide enough that even a fully degraded build does not fit.
234
+ *
235
+ * Any failure returns `undefined`: the hook script's hard rule is that a broken
236
+ * bridge is invisible, so a staging error must reach it as an absent field, not
237
+ * as a 500.
238
+ *
239
+ * ONE builder, but not one wording: prompt-assembly conditions its IDENTITY and
240
+ * LIMITS blocks on the session's PERSISTED origin, and provenance is CREATE-ONLY
241
+ * (see `registerSession`). A first sighting is created `observed`; an event
242
+ * arriving for an ARCS-owned thread refreshes it without demoting it, so an
243
+ * `arcs`-origin session reaching SessionStart keeps its origin and therefore gets
244
+ * the `arcs` variant. Either variant states what is true of THAT session — for
245
+ * the observed one, that ARCS is NOT setting its tools, permissions or lifecycle,
246
+ * which the bullets above are the reason for, since no argv exists to set them
247
+ * with. The untrusted-content half is identical on both origins; only the claim
248
+ * of control moves.
249
+ */
250
+ async function sessionStartContext(projectDir, slug, session, event) {
251
+ try {
252
+ if (session.linkedNodeType && session.linkedNodeId) {
253
+ const staged = await buildStagedEnvironment(projectDir, slug, session, {
254
+ // Claude Code's own cwd: the directory this terminal is actually in,
255
+ // which is a truer workspace root than the project's registered first
256
+ // path when a project spans more than one checkout.
257
+ ...(event.cwd && { workspaceRoot: event.cwd }),
258
+ softCap: SESSION_START_STAGE_CAP,
259
+ });
260
+ if (staged.text.length <= SESSION_START_STAGE_CAP)
261
+ return staged.text;
262
+ }
263
+ return await degradedStagedContext(projectDir, slug);
264
+ }
265
+ catch {
266
+ return undefined;
267
+ }
268
+ }
269
+ async function handleHookEvent(projectDir, slug, event) {
270
+ if (event.hook_event_name === "SessionStart") {
271
+ const session = await registerSession(projectDir, event);
272
+ const stagedContext = await sessionStartContext(projectDir, slug, session, event);
273
+ return {
274
+ sessionId: session.normalizedId,
275
+ queuedMessages: [],
276
+ ...(stagedContext !== undefined && { stagedContext }),
277
+ };
278
+ }
279
+ if (event.hook_event_name === "UserPromptSubmit") {
280
+ const session = await resolveCheckpointSession(projectDir, event);
281
+ const checkpoint = await persistCheckpoint(projectDir, session, event);
282
+ if (event.transcript_path !== undefined && shouldMirrorTranscript(checkpoint)) {
283
+ await mirrorSessionTranscript(projectDir, checkpoint.normalizedId, event.transcript_path);
284
+ }
285
+ const queuedMessages = await drainSessionMessageQueue(projectDir, checkpoint.normalizedId);
286
+ return { sessionId: checkpoint.normalizedId, queuedMessages };
287
+ }
288
+ if (event.hook_event_name === "Stop") {
289
+ // Stop is a checkpoint like UserPromptSubmit, so an unknown session is
290
+ // auto-registered — but the queue is deliberately NOT drained: a message
291
+ // queued for the session must survive to the next UserPromptSubmit, and
292
+ // Stop can arrive before that checkpoint if the turn ends without one.
293
+ const session = await resolveCheckpointSession(projectDir, event);
294
+ const checkpoint = await persistCheckpoint(projectDir, session, event);
295
+ if (event.transcript_path !== undefined && shouldMirrorTranscript(checkpoint)) {
296
+ await mirrorSessionTranscript(projectDir, checkpoint.normalizedId, event.transcript_path);
297
+ }
298
+ return { sessionId: checkpoint.normalizedId, queuedMessages: [] };
299
+ }
300
+ // SessionEnd. Every documented reason (clear|resume|logout|other) is an
301
+ // ordinary teardown — none of them signals a crash, so none maps to "failed".
302
+ const metadata = sessionMetadata(event);
303
+ const session = await updateSession(projectDir, {
304
+ id: event.session_id,
305
+ status: "completed",
306
+ ...(metadata !== undefined && { metadata }),
307
+ });
308
+ if (event.transcript_path !== undefined && shouldMirrorTranscript(session)) {
309
+ await mirrorSessionTranscript(projectDir, session.normalizedId, event.transcript_path);
310
+ }
311
+ return { sessionId: session.normalizedId, queuedMessages: [] };
312
+ }
313
+ hookEventsRoute.post("/api/hook/:slug/event", async (c) => respond(c, async () => {
314
+ const slug = c.req.param("slug");
315
+ // Validates the slug before it is threaded on to the stager, which uses it
316
+ // both as a knowledge-selection key and as an interpolated identity value.
317
+ const projectDir = requireProjectDir(slug);
318
+ return handleHookEvent(projectDir, slug, await parseBody(c, hookEventSchema));
319
+ }));
320
+ //# sourceMappingURL=hook-events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hook-events.js","sourceRoot":"","sources":["../../../src/web-server/routes/hook-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,UAAU,EAEV,aAAa,EACb,aAAa,GACd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,IAAI,EAAE,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAgBH;;;;;;;;;GASG;AACH,SAAS,eAAe,CAAC,KAAgB;IACvC,MAAM,QAAQ,GAA4B;QACxC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;QAC1C,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC7C,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC9D,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC;KACtF,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,UAAkB,EAAE,KAAgB;IAC3D,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,aAAa,CAAC,UAAU,EAAE;QAC/B,WAAW,EAAE,aAAa;QAC1B,gBAAgB,EAAE,KAAK,CAAC,UAAU;QAClC,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,QAAQ;QAChB,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,iBAAiB,CAC9B,UAAkB,EAClB,OAAoB,EACpB,KAAgB;IAEhB,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,aAAa,CAAC,UAAU,EAAE;QAC/B,EAAE,EAAE,OAAO,CAAC,YAAY;QACxB,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC1C,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;KAC5C,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,sBAAsB,CAAC,OAAoB;IAClD,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,wBAAwB,CACrC,UAAkB,EAClB,KAAgB;IAEhB,IAAI,CAAC;QACH,OAAO,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,gEAAgE;AAChE,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,KAAa,EAAE,KAAK,GAAG,oBAAoB;IAChE,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACtE,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,qBAAqB,CAAC,UAAkB,EAAE,IAAY;IACnE,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxD,YAAY,CAAoB,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC9D,SAAS,CAAC,UAAU,CAAC;QACrB,aAAa,CAAC,UAAU,CAAC;KAC1B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,oBAAoB,CAAC;QACrC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC;QACH,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KACpF,CAAC,CAAC;IACH,OAAO;QACL,gDAAgD,aAAa,CAAC,IAAI,CAAC,GAAG;YACpE,IAAI,aAAa,CAAC,WAAW,EAAE,IAAI,IAAI,IAAI,CAAC,wBAAwB;YACpE,gBAAgB,aAAa,CAAC,IAAI,CAAC,uDAAuD;YAC1F,6EAA6E;QAC/E,0BAA0B,aAAa,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK;YAClE,gBAAgB,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE;KACxD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,KAAK,UAAU,mBAAmB,CAChC,UAAkB,EAClB,IAAY,EACZ,OAAoB,EACpB,KAAgB;IAEhB,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;gBACrE,qEAAqE;gBACrE,sEAAsE;gBACtE,oDAAoD;gBACpD,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;gBAC9C,OAAO,EAAE,uBAAuB;aACjC,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,uBAAuB;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QACxE,CAAC;QACD,OAAO,MAAM,qBAAqB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,UAAkB,EAClB,IAAY,EACZ,KAAgB;IAEhB,IAAI,KAAK,CAAC,eAAe,KAAK,cAAc,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACzD,MAAM,aAAa,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAClF,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,YAAY;YAC/B,cAAc,EAAE,EAAE;YAClB,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,CAAC;SACtD,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,eAAe,KAAK,kBAAkB,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACvE,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9E,MAAM,uBAAuB,CAAC,UAAU,EAAE,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,wBAAwB,CAAC,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;QAC3F,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,CAAC;IAChE,CAAC;IAED,IAAI,KAAK,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC;QACrC,uEAAuE;QACvE,yEAAyE;QACzE,wEAAwE;QACxE,uEAAuE;QACvE,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACvE,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9E,MAAM,uBAAuB,CAAC,UAAU,EAAE,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IACpE,CAAC;IAED,wEAAwE;IACxE,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE;QAC9C,EAAE,EAAE,KAAK,CAAC,UAAU;QACpB,MAAM,EAAE,WAAW;QACnB,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;KAC5C,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3E,MAAM,uBAAuB,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;AACjE,CAAC;AAED,eAAe,CAAC,IAAI,CAAC,uBAAuB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CACxD,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjC,2EAA2E;IAC3E,2EAA2E;IAC3E,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;AAChF,CAAC,CAAC,CACH,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Project-level routes: project listing, docs, cross-project graph,
3
+ * flat search index, and root DAG dependency edits.
4
+ */
5
+ import { Hono } from "hono";
6
+ export declare const projectsRoute: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
7
+ //# sourceMappingURL=projects.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../src/web-server/routes/projects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAoB5B,eAAO,MAAM,aAAa,4EAAa,CAAC"}