cloving 1.2.0 → 1.4.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 (752) hide show
  1. package/README.md +700 -331
  2. package/dist/src/agent-harness-shell.d.ts +13 -0
  3. package/dist/src/agent-harness-shell.js +93 -0
  4. package/dist/src/agent-harness-versions.d.ts +8 -0
  5. package/dist/src/agent-harness-versions.js +49 -0
  6. package/dist/src/agent-harnesses.d.ts +4 -0
  7. package/dist/src/agent-harnesses.js +13 -0
  8. package/dist/src/authority/command-wait-checks.d.ts +8 -0
  9. package/dist/src/authority/command-wait-checks.js +88 -0
  10. package/dist/src/authority/command-wait-results.d.ts +15 -0
  11. package/dist/src/authority/command-wait-results.js +73 -0
  12. package/dist/src/authority/command-wait-view.d.ts +21 -0
  13. package/dist/src/authority/command-wait-view.js +34 -0
  14. package/dist/src/authority/command-waits.d.ts +39 -0
  15. package/dist/src/authority/command-waits.js +97 -0
  16. package/dist/src/authority/commands.d.ts +1 -0
  17. package/dist/src/authority/commands.js +46 -5
  18. package/dist/src/authority/dispatch-decision.d.ts +8 -0
  19. package/dist/src/authority/dispatch-decision.js +26 -1
  20. package/dist/src/authority/effect-requests.js +6 -3
  21. package/dist/src/authority/effect-results.js +4 -2
  22. package/dist/src/authority/gate-reduction.d.ts +1 -0
  23. package/dist/src/authority/gate-reduction.js +18 -3
  24. package/dist/src/authority/gates.d.ts +2 -1
  25. package/dist/src/authority/gates.js +5 -1
  26. package/dist/src/authority/history-state.d.ts +2 -0
  27. package/dist/src/authority/history-state.js +13 -1
  28. package/dist/src/authority/instants.d.ts +1 -0
  29. package/dist/src/authority/instants.js +21 -0
  30. package/dist/src/authority/operations.js +1 -1
  31. package/dist/src/authority/reduction-state.d.ts +2 -0
  32. package/dist/src/authority/reduction-state.js +5 -0
  33. package/dist/src/authority/reduction.d.ts +1 -1
  34. package/dist/src/authority/reduction.js +30 -1
  35. package/dist/src/authority/status-input.d.ts +3 -1
  36. package/dist/src/authority/status.d.ts +3 -0
  37. package/dist/src/authority/status.js +28 -3
  38. package/dist/src/authority/stop-sequence.d.ts +1 -0
  39. package/dist/src/authority/stop-sequence.js +2 -1
  40. package/dist/src/authority/transitions.d.ts +7 -5
  41. package/dist/src/authority/transitions.js +13 -0
  42. package/dist/src/broker/actor/authority-delivery.js +1 -0
  43. package/dist/src/broker/actor/authority-queries.d.ts +9 -2
  44. package/dist/src/broker/actor/authority-queries.js +29 -5
  45. package/dist/src/broker/actor/authority-receipts.js +11 -1
  46. package/dist/src/broker/actor/authority-session.js +2 -2
  47. package/dist/src/broker/actor/authority-settings.js +4 -0
  48. package/dist/src/broker/actor/authority-upgrades.d.ts +19 -2
  49. package/dist/src/broker/actor/authority-upgrades.js +7 -2
  50. package/dist/src/broker/actor/delivery-intents.d.ts +2 -1
  51. package/dist/src/broker/actor/delivery-intents.js +6 -4
  52. package/dist/src/broker/actor/effect-delivery.d.ts +1 -1
  53. package/dist/src/broker/actor/effect-delivery.js +18 -2
  54. package/dist/src/broker/actor/effect-plan.js +11 -2
  55. package/dist/src/broker/actor/effect-queries.d.ts +5 -0
  56. package/dist/src/broker/actor/effect-queries.js +16 -1
  57. package/dist/src/broker/actor/effect-turn.js +2 -0
  58. package/dist/src/broker/actor/pin-check.js +1 -1
  59. package/dist/src/broker/actor/stop-plan.js +10 -4
  60. package/dist/src/broker/actor/stop-turn.d.ts +2 -0
  61. package/dist/src/broker/actor/stop-turn.js +24 -11
  62. package/dist/src/broker/actor/turn-draft.d.ts +1 -0
  63. package/dist/src/broker/actor/turn-draft.js +4 -0
  64. package/dist/src/broker/actor/turn-state.js +6 -2
  65. package/dist/src/broker/authority-admission.js +80 -7
  66. package/dist/src/broker/authority-restore.d.ts +2 -0
  67. package/dist/src/broker/authority-restore.js +36 -1
  68. package/dist/src/broker/command-wait-restore.d.ts +31 -0
  69. package/dist/src/broker/command-wait-restore.js +86 -0
  70. package/dist/src/broker/decision-restore.d.ts +1 -1
  71. package/dist/src/broker/decision-restore.js +5 -4
  72. package/dist/src/broker/effect-upgrade.d.ts +2 -0
  73. package/dist/src/broker/effect-upgrade.js +8 -2
  74. package/dist/src/broker/socket-address.d.ts +3 -1
  75. package/dist/src/broker/socket-address.js +2 -2
  76. package/dist/src/cli/arguments.d.ts +22 -11
  77. package/dist/src/cli/arguments.js +73 -104
  78. package/dist/src/cli/chat-stores.d.ts +2 -0
  79. package/dist/src/cli/chat-stores.js +113 -0
  80. package/dist/src/cli/client.d.ts +4 -1
  81. package/dist/src/cli/client.js +9 -3
  82. package/dist/src/cli/command-effects.d.ts +7 -0
  83. package/dist/src/cli/command-effects.js +39 -0
  84. package/dist/src/cli/command-requests.d.ts +17 -0
  85. package/dist/src/cli/command-requests.js +43 -0
  86. package/dist/src/cli/command-waits.d.ts +9 -0
  87. package/dist/src/cli/command-waits.js +51 -0
  88. package/dist/src/cli/commands.js +21 -41
  89. package/dist/src/cli/config-arguments.d.ts +11 -0
  90. package/dist/src/cli/config-arguments.js +59 -0
  91. package/dist/src/cli/config-command.d.ts +2 -0
  92. package/dist/src/cli/config-command.js +105 -0
  93. package/dist/src/cli/config-file.d.ts +3 -0
  94. package/dist/src/cli/config-file.js +52 -0
  95. package/dist/src/cli/config-lock.d.ts +7 -0
  96. package/dist/src/cli/config-lock.js +61 -0
  97. package/dist/src/cli/config-notice.d.ts +5 -0
  98. package/dist/src/cli/config-notice.js +46 -0
  99. package/dist/src/cli/doctor-github.d.ts +9 -0
  100. package/dist/src/cli/doctor-github.js +138 -0
  101. package/dist/src/cli/doctor-harness.d.ts +13 -0
  102. package/dist/src/cli/doctor-harness.js +242 -0
  103. package/dist/src/cli/doctor-local.d.ts +18 -0
  104. package/dist/src/cli/doctor-local.js +77 -0
  105. package/dist/src/cli/doctor-runtime.d.ts +15 -0
  106. package/dist/src/cli/doctor-runtime.js +176 -0
  107. package/dist/src/cli/doctor-service.d.ts +1 -0
  108. package/dist/src/cli/doctor-service.js +11 -0
  109. package/dist/src/cli/doctor-workflows.d.ts +6 -0
  110. package/dist/src/cli/doctor-workflows.js +50 -0
  111. package/dist/src/cli/doctor.d.ts +15 -0
  112. package/dist/src/cli/doctor.js +187 -0
  113. package/dist/src/cli/github-ci-progress.d.ts +8 -0
  114. package/dist/src/cli/github-ci-progress.js +83 -0
  115. package/dist/src/cli/github-retry.d.ts +6 -0
  116. package/dist/src/cli/github-retry.js +47 -0
  117. package/dist/src/cli/harness-probes.d.ts +24 -0
  118. package/dist/src/cli/harness-probes.js +183 -0
  119. package/dist/src/cli/harness-processes.d.ts +6 -0
  120. package/dist/src/cli/harness-processes.js +36 -0
  121. package/dist/src/cli/init-command.d.ts +9 -0
  122. package/dist/src/cli/init-command.js +52 -0
  123. package/dist/src/cli/init-prompt-command.d.ts +10 -0
  124. package/dist/src/cli/init-prompt-command.js +145 -0
  125. package/dist/src/cli/init-prompt.d.ts +35 -0
  126. package/dist/src/cli/init-prompt.js +74 -0
  127. package/dist/src/cli/init-selection.d.ts +13 -0
  128. package/dist/src/cli/init-selection.js +75 -0
  129. package/dist/src/cli/main.d.ts +9 -1
  130. package/dist/src/cli/main.js +69 -61
  131. package/dist/src/cli/mcp-server.d.ts +1 -0
  132. package/dist/src/cli/mcp-server.js +156 -0
  133. package/dist/src/cli/mcp-tools.d.ts +15 -0
  134. package/dist/src/cli/mcp-tools.js +80 -0
  135. package/dist/src/cli/phone-arguments.d.ts +14 -0
  136. package/dist/src/cli/phone-arguments.js +37 -0
  137. package/dist/src/cli/phone-client.d.ts +2 -0
  138. package/dist/src/cli/phone-client.js +32 -0
  139. package/dist/src/cli/phone-command.d.ts +13 -0
  140. package/dist/src/cli/phone-command.js +101 -0
  141. package/dist/src/cli/probe-command.d.ts +36 -0
  142. package/dist/src/cli/probe-command.js +59 -0
  143. package/dist/src/cli/project-settings.d.ts +4 -0
  144. package/dist/src/cli/project-settings.js +33 -0
  145. package/dist/src/cli/render.d.ts +2 -1
  146. package/dist/src/cli/render.js +57 -54
  147. package/dist/src/cli/report-ci-jobs.d.ts +23 -0
  148. package/dist/src/cli/report-ci-jobs.js +103 -0
  149. package/dist/src/cli/report-ci-usage.d.ts +9 -0
  150. package/dist/src/cli/report-ci-usage.js +185 -0
  151. package/dist/src/cli/report-ci.d.ts +13 -0
  152. package/dist/src/cli/report-ci.js +74 -0
  153. package/dist/src/cli/report-closures.d.ts +6 -0
  154. package/dist/src/cli/report-closures.js +97 -0
  155. package/dist/src/cli/report-flow.d.ts +7 -0
  156. package/dist/src/cli/report-flow.js +122 -0
  157. package/dist/src/cli/report-github-reader.d.ts +29 -0
  158. package/dist/src/cli/report-github-reader.js +157 -0
  159. package/dist/src/cli/report-github.d.ts +25 -0
  160. package/dist/src/cli/report-github.js +181 -0
  161. package/dist/src/cli/report-operator.d.ts +3 -0
  162. package/dist/src/cli/report-operator.js +40 -0
  163. package/dist/src/cli/report-ready.d.ts +3 -0
  164. package/dist/src/cli/report-ready.js +96 -0
  165. package/dist/src/cli/report-text.d.ts +9 -0
  166. package/dist/src/cli/report-text.js +33 -0
  167. package/dist/src/cli/report.d.ts +18 -0
  168. package/dist/src/cli/report.js +269 -0
  169. package/dist/src/cli/repository-arguments.d.ts +5 -0
  170. package/dist/src/cli/repository-arguments.js +34 -0
  171. package/dist/src/cli/runtime-arguments.d.ts +6 -1
  172. package/dist/src/cli/runtime-arguments.js +22 -2
  173. package/dist/src/cli/runtime-directory.d.ts +6 -2
  174. package/dist/src/cli/runtime-directory.js +72 -14
  175. package/dist/src/cli/schedule-arguments.d.ts +14 -0
  176. package/dist/src/cli/schedule-arguments.js +26 -0
  177. package/dist/src/cli/schedule-render.d.ts +22 -0
  178. package/dist/src/cli/schedule-render.js +73 -0
  179. package/dist/src/cli/terminal-text.d.ts +3 -0
  180. package/dist/src/cli/terminal-text.js +28 -0
  181. package/dist/src/cli/toolchain.d.ts +2 -0
  182. package/dist/src/cli/toolchain.js +22 -2
  183. package/dist/src/cli/usage-render.d.ts +6 -0
  184. package/dist/src/cli/usage-render.js +67 -1
  185. package/dist/src/cli/usage.d.ts +3 -3
  186. package/dist/src/cli/usage.js +119 -50
  187. package/dist/src/cli/watch-actions.d.ts +2 -0
  188. package/dist/src/cli/watch-actions.js +6 -6
  189. package/dist/src/cli/watch-board-view.d.ts +1 -1
  190. package/dist/src/cli/watch-board-view.js +27 -4
  191. package/dist/src/cli/watch-board.d.ts +4 -2
  192. package/dist/src/cli/watch-board.js +58 -35
  193. package/dist/src/cli/watch-card-forms.d.ts +1 -1
  194. package/dist/src/cli/watch-card-forms.js +13 -12
  195. package/dist/src/cli/watch-client.d.ts +1 -1
  196. package/dist/src/cli/watch-client.js +7 -11
  197. package/dist/src/cli/watch-header-view.d.ts +22 -0
  198. package/dist/src/cli/watch-header-view.js +104 -0
  199. package/dist/src/cli/watch-model.d.ts +4 -1
  200. package/dist/src/cli/watch-model.js +34 -15
  201. package/dist/src/cli/watch-page.js +57 -23
  202. package/dist/src/cli/watch-phases.d.ts +12 -3
  203. package/dist/src/cli/watch-phases.js +68 -11
  204. package/dist/src/cli/watch-phone-client.d.ts +1 -0
  205. package/dist/src/cli/watch-phone-client.js +84 -0
  206. package/dist/src/cli/watch-phone-view.d.ts +56 -0
  207. package/dist/src/cli/watch-phone-view.js +113 -0
  208. package/dist/src/cli/watch-phone.d.ts +5 -0
  209. package/dist/src/cli/watch-phone.js +53 -0
  210. package/dist/src/cli/watch-pr-board.js +1 -1
  211. package/dist/src/cli/watch-pr-command.d.ts +1 -0
  212. package/dist/src/cli/watch-pull-request.d.ts +3 -1
  213. package/dist/src/cli/watch-pull-request.js +22 -8
  214. package/dist/src/cli/watch-reads.d.ts +2 -0
  215. package/dist/src/cli/watch-reads.js +17 -16
  216. package/dist/src/cli/watch-render.d.ts +23 -1
  217. package/dist/src/cli/watch-run-input.d.ts +0 -1
  218. package/dist/src/cli/watch-run-input.js +0 -13
  219. package/dist/src/cli/watch-server.js +29 -11
  220. package/dist/src/cli/watch-turn.d.ts +4 -1
  221. package/dist/src/cli/watch-turn.js +37 -1
  222. package/dist/src/cli/watch-usage.js +5 -1
  223. package/dist/src/cli/watch-view.d.ts +4 -21
  224. package/dist/src/cli/watch-view.js +26 -118
  225. package/dist/src/cli.js +165 -28
  226. package/dist/src/command-settings.d.ts +16 -0
  227. package/dist/src/command-settings.js +42 -0
  228. package/dist/src/command-wait.d.ts +4 -0
  229. package/dist/src/command-wait.js +45 -0
  230. package/dist/src/configuration-change.d.ts +18 -0
  231. package/dist/src/configuration-change.js +76 -0
  232. package/dist/src/configuration-display.d.ts +21 -0
  233. package/dist/src/configuration-display.js +69 -0
  234. package/dist/src/configuration-schema.d.ts +58 -0
  235. package/dist/src/configuration-schema.js +163 -0
  236. package/dist/src/daemon/attachment-file.d.ts +6 -0
  237. package/dist/src/daemon/attachment-file.js +86 -0
  238. package/dist/src/daemon/attachments.d.ts +14 -0
  239. package/dist/src/daemon/attachments.js +17 -0
  240. package/dist/src/daemon/claude-recovery.d.ts +50 -0
  241. package/dist/src/daemon/claude-recovery.js +204 -0
  242. package/dist/src/daemon/claude-stream.d.ts +27 -0
  243. package/dist/src/daemon/claude-stream.js +63 -0
  244. package/dist/src/daemon/claude-turn.d.ts +18 -18
  245. package/dist/src/daemon/claude-turn.js +151 -105
  246. package/dist/src/daemon/claude-worker.d.ts +5 -4
  247. package/dist/src/daemon/claude-worker.js +149 -158
  248. package/dist/src/daemon/command-journal.d.ts +5 -0
  249. package/dist/src/daemon/command-journal.js +50 -0
  250. package/dist/src/daemon/command-process.d.ts +28 -0
  251. package/dist/src/daemon/command-process.js +164 -0
  252. package/dist/src/daemon/command-worker.d.ts +19 -0
  253. package/dist/src/daemon/command-worker.js +182 -0
  254. package/dist/src/daemon/cursor-stream.d.ts +4 -0
  255. package/dist/src/daemon/cursor-stream.js +154 -0
  256. package/dist/src/daemon/daemon-adapters.d.ts +60 -0
  257. package/dist/src/daemon/daemon-adapters.js +126 -0
  258. package/dist/src/daemon/daemon-loops.d.ts +16 -0
  259. package/dist/src/daemon/daemon-loops.js +41 -0
  260. package/dist/src/daemon/daemon.d.ts +2 -33
  261. package/dist/src/daemon/daemon.js +133 -131
  262. package/dist/src/daemon/declared-input.d.ts +3 -0
  263. package/dist/src/daemon/declared-input.js +9 -0
  264. package/dist/src/daemon/delivery-router.js +1 -1
  265. package/dist/src/daemon/gemini-stream.d.ts +4 -0
  266. package/dist/src/daemon/gemini-stream.js +129 -0
  267. package/dist/src/daemon/github-attach.d.ts +2 -0
  268. package/dist/src/daemon/github-attach.js +149 -0
  269. package/dist/src/daemon/github-ci-filters.d.ts +6 -0
  270. package/dist/src/daemon/github-ci-filters.js +138 -0
  271. package/dist/src/daemon/github-ci-rerun.d.ts +26 -0
  272. package/dist/src/daemon/github-ci-rerun.js +92 -0
  273. package/dist/src/daemon/github-ci-workflows.d.ts +10 -0
  274. package/dist/src/daemon/github-ci-workflows.js +148 -0
  275. package/dist/src/daemon/github-ci.js +109 -10
  276. package/dist/src/daemon/github-issue-methods.d.ts +2 -0
  277. package/dist/src/daemon/github-issue-methods.js +37 -2
  278. package/dist/src/daemon/github-merge-call.d.ts +4 -1
  279. package/dist/src/daemon/github-merge-call.js +10 -3
  280. package/dist/src/daemon/github-merge.js +58 -26
  281. package/dist/src/daemon/github-methods.js +22 -2
  282. package/dist/src/daemon/github-operation.d.ts +5 -0
  283. package/dist/src/daemon/github-operation.js +6 -0
  284. package/dist/src/daemon/github-retry.js +8 -44
  285. package/dist/src/daemon/github-worker.d.ts +4 -0
  286. package/dist/src/daemon/github-worker.js +6 -0
  287. package/dist/src/daemon/issue-queue.d.ts +1 -0
  288. package/dist/src/daemon/issue-queue.js +16 -34
  289. package/dist/src/daemon/notify-events.d.ts +6 -0
  290. package/dist/src/daemon/notify-events.js +84 -0
  291. package/dist/src/daemon/notify-journal.js +1 -1
  292. package/dist/src/daemon/notify-message.d.ts +4 -1
  293. package/dist/src/daemon/notify-message.js +36 -0
  294. package/dist/src/daemon/notify.d.ts +1 -1
  295. package/dist/src/daemon/notify.js +7 -78
  296. package/dist/src/daemon/opencode-stream.d.ts +5 -0
  297. package/dist/src/daemon/opencode-stream.js +87 -0
  298. package/dist/src/daemon/operation-journal.d.ts +1 -0
  299. package/dist/src/daemon/queue-status.d.ts +10 -0
  300. package/dist/src/daemon/queue-status.js +51 -0
  301. package/dist/src/daemon/resume-index-lock.d.ts +13 -0
  302. package/dist/src/daemon/resume-index-lock.js +160 -0
  303. package/dist/src/daemon/resume-worktree.d.ts +7 -0
  304. package/dist/src/daemon/resume-worktree.js +29 -0
  305. package/dist/src/daemon/retry-worktree.d.ts +18 -0
  306. package/dist/src/daemon/retry-worktree.js +139 -0
  307. package/dist/src/daemon/retrying-turn.d.ts +2 -10
  308. package/dist/src/daemon/retrying-turn.js +145 -141
  309. package/dist/src/daemon/schedule-control.d.ts +26 -0
  310. package/dist/src/daemon/schedule-control.js +110 -0
  311. package/dist/src/daemon/schedule-journal.d.ts +6 -0
  312. package/dist/src/daemon/schedule-journal.js +120 -0
  313. package/dist/src/daemon/text-output.d.ts +18 -0
  314. package/dist/src/daemon/text-output.js +44 -0
  315. package/dist/src/daemon/ticket-registration.d.ts +7 -14
  316. package/dist/src/daemon/ticket-registration.js +93 -114
  317. package/dist/src/daemon/turn-attempt-journal.d.ts +38 -0
  318. package/dist/src/daemon/turn-attempt-journal.js +136 -0
  319. package/dist/src/daemon/turn-attempts.d.ts +47 -0
  320. package/dist/src/daemon/turn-attempts.js +166 -0
  321. package/dist/src/daemon/turn-command.d.ts +10 -0
  322. package/dist/src/daemon/turn-command.js +33 -0
  323. package/dist/src/daemon/turn-report.d.ts +25 -0
  324. package/dist/src/daemon/turn-report.js +118 -0
  325. package/dist/src/daemon/work-tree.d.ts +11 -1
  326. package/dist/src/daemon/work-tree.js +35 -12
  327. package/dist/src/daemon/worker-profile.d.ts +8 -0
  328. package/dist/src/daemon/worker-profile.js +40 -0
  329. package/dist/src/daemon/workflow-generations.d.ts +32 -0
  330. package/dist/src/daemon/workflow-generations.js +57 -0
  331. package/dist/src/daemon/workflow-replay.d.ts +16 -0
  332. package/dist/src/daemon/workflow-replay.js +58 -0
  333. package/dist/src/daemon/workflow-schedules.d.ts +30 -0
  334. package/dist/src/daemon/workflow-schedules.js +238 -0
  335. package/dist/src/daemon/worktree-processes.d.ts +9 -0
  336. package/dist/src/daemon/worktree-processes.js +151 -0
  337. package/dist/src/decision-wait.d.ts +1 -0
  338. package/dist/src/decision-wait.js +3 -0
  339. package/dist/src/delivery-backoff.d.ts +1 -0
  340. package/dist/src/delivery-backoff.js +3 -0
  341. package/dist/src/doctor-report.d.ts +22 -0
  342. package/dist/src/doctor-report.js +63 -0
  343. package/dist/src/execution-pin.d.ts +5 -0
  344. package/dist/src/execution-pin.js +67 -4
  345. package/dist/src/grok-result.d.ts +12 -0
  346. package/dist/src/grok-result.js +61 -0
  347. package/dist/src/harness-defaults.d.ts +35 -0
  348. package/dist/src/harness-defaults.js +121 -0
  349. package/dist/src/harness-start.d.ts +15 -0
  350. package/dist/src/harness-start.js +37 -0
  351. package/dist/src/host/command-wait.d.ts +38 -0
  352. package/dist/src/host/command-wait.js +115 -0
  353. package/dist/src/host/decision-resume.d.ts +35 -0
  354. package/dist/src/host/decision-resume.js +86 -0
  355. package/dist/src/host/gate-bridge.d.ts +48 -0
  356. package/dist/src/host/gate-bridge.js +124 -0
  357. package/dist/src/host/run-wait.d.ts +26 -0
  358. package/dist/src/host/run-wait.js +37 -0
  359. package/dist/src/host/start-delivery.d.ts +6 -8
  360. package/dist/src/host/start-delivery.js +13 -18
  361. package/dist/src/host/step-bridge-host.d.ts +8 -20
  362. package/dist/src/host/step-bridge-host.js +65 -58
  363. package/dist/src/merge-request.d.ts +19 -0
  364. package/dist/src/merge-request.js +32 -0
  365. package/dist/src/operation-identity.d.ts +1 -0
  366. package/dist/src/operation-identity.js +4 -0
  367. package/dist/src/phone/canonical-json.d.ts +1 -0
  368. package/dist/src/phone/canonical-json.js +16 -0
  369. package/dist/src/phone/phone-link.d.ts +7 -0
  370. package/dist/src/phone/phone-link.js +21 -0
  371. package/dist/src/phone/qr-data.d.ts +8 -0
  372. package/dist/src/phone/qr-data.js +133 -0
  373. package/dist/src/phone/qr-matrix.d.ts +6 -0
  374. package/dist/src/phone/qr-matrix.js +175 -0
  375. package/dist/src/phone/qr-penalty.d.ts +3 -0
  376. package/dist/src/phone/qr-penalty.js +67 -0
  377. package/dist/src/phone/qr-picture.d.ts +5 -0
  378. package/dist/src/phone/qr-picture.js +24 -0
  379. package/dist/src/private-config.schema.json +303 -0
  380. package/dist/src/project-config.schema.json +105 -0
  381. package/dist/src/project-settings.d.ts +19 -0
  382. package/dist/src/project-settings.js +133 -0
  383. package/dist/src/queue-spend.d.ts +4 -0
  384. package/dist/src/queue-spend.js +21 -0
  385. package/dist/src/relay/answer-check.d.ts +24 -0
  386. package/dist/src/relay/answer-check.js +145 -0
  387. package/dist/src/relay/answer-inbox.d.ts +15 -0
  388. package/dist/src/relay/answer-inbox.js +173 -0
  389. package/dist/src/relay/daemon-keys.d.ts +16 -0
  390. package/dist/src/relay/daemon-keys.js +75 -0
  391. package/dist/src/relay/decision-check.d.ts +3 -0
  392. package/dist/src/relay/decision-check.js +77 -0
  393. package/dist/src/relay/decision-close.d.ts +6 -0
  394. package/dist/src/relay/decision-close.js +72 -0
  395. package/dist/src/relay/decision-envelopes.d.ts +29 -0
  396. package/dist/src/relay/decision-envelopes.js +93 -0
  397. package/dist/src/relay/decision-watch.d.ts +14 -0
  398. package/dist/src/relay/decision-watch.js +68 -0
  399. package/dist/src/relay/envelope-post.d.ts +8 -0
  400. package/dist/src/relay/envelope-post.js +71 -0
  401. package/dist/src/relay/envelope.d.ts +28 -0
  402. package/dist/src/relay/envelope.js +53 -0
  403. package/dist/src/relay/hpke.d.ts +25 -0
  404. package/dist/src/relay/hpke.js +108 -0
  405. package/dist/src/relay/pairing-checks.d.ts +42 -0
  406. package/dist/src/relay/pairing-checks.js +172 -0
  407. package/dist/src/relay/pairing-follow.d.ts +8 -0
  408. package/dist/src/relay/pairing-follow.js +95 -0
  409. package/dist/src/relay/pairing-session.d.ts +29 -0
  410. package/dist/src/relay/pairing-session.js +87 -0
  411. package/dist/src/relay/phone-delivery.d.ts +51 -0
  412. package/dist/src/relay/phone-delivery.js +139 -0
  413. package/dist/src/relay/phone-devices.d.ts +36 -0
  414. package/dist/src/relay/phone-devices.js +46 -0
  415. package/dist/src/relay/phone-inbox.d.ts +18 -0
  416. package/dist/src/relay/phone-inbox.js +17 -0
  417. package/dist/src/relay/phone-operations.d.ts +18 -0
  418. package/dist/src/relay/phone-operations.js +121 -0
  419. package/dist/src/relay/phone-outbox.d.ts +21 -0
  420. package/dist/src/relay/phone-outbox.js +25 -0
  421. package/dist/src/relay/phone-socket.d.ts +6 -0
  422. package/dist/src/relay/phone-socket.js +63 -0
  423. package/dist/src/relay/relay-control.d.ts +7 -0
  424. package/dist/src/relay/relay-control.js +24 -0
  425. package/dist/src/relay/relay-files.d.ts +2 -0
  426. package/dist/src/relay/relay-files.js +23 -0
  427. package/dist/src/relay/relay-heartbeat.d.ts +17 -0
  428. package/dist/src/relay/relay-heartbeat.js +81 -0
  429. package/dist/src/relay/relay-http.d.ts +14 -0
  430. package/dist/src/relay/relay-http.js +63 -0
  431. package/dist/src/relay/relay-registration.d.ts +15 -0
  432. package/dist/src/relay/relay-registration.js +63 -0
  433. package/dist/src/relay/relay-service.d.ts +28 -0
  434. package/dist/src/relay/relay-service.js +218 -0
  435. package/dist/src/relay/relay-store.d.ts +48 -0
  436. package/dist/src/relay/relay-store.js +131 -0
  437. package/dist/src/relay/sealed-post.d.ts +25 -0
  438. package/dist/src/relay/sealed-post.js +52 -0
  439. package/dist/src/relay.d.ts +1 -0
  440. package/dist/src/relay.js +8 -0
  441. package/dist/src/report-ci.d.ts +164 -0
  442. package/dist/src/report-ci.js +32 -0
  443. package/dist/src/report-effects.d.ts +15 -0
  444. package/dist/src/report-effects.js +212 -0
  445. package/dist/src/report-flow-types.d.ts +38 -0
  446. package/dist/src/report-flow-types.js +7 -0
  447. package/dist/src/report-flow.d.ts +43 -0
  448. package/dist/src/report-flow.js +193 -0
  449. package/dist/src/report-operator.d.ts +67 -0
  450. package/dist/src/report-operator.js +25 -0
  451. package/dist/src/report-quality.d.ts +221 -0
  452. package/dist/src/report-quality.js +94 -0
  453. package/dist/src/report-ready.d.ts +23 -0
  454. package/dist/src/report-ready.js +117 -0
  455. package/dist/src/report-statistics.d.ts +51 -0
  456. package/dist/src/report-statistics.js +106 -0
  457. package/dist/src/report.d.ts +712 -0
  458. package/dist/src/report.js +234 -0
  459. package/dist/src/repository-identity.d.ts +4 -0
  460. package/dist/src/repository-identity.js +4 -0
  461. package/dist/src/review-subject.d.ts +41 -0
  462. package/dist/src/review-subject.js +91 -0
  463. package/dist/src/run-wait.d.ts +23 -0
  464. package/dist/src/run-wait.js +20 -0
  465. package/dist/src/schedule-progress.d.ts +33 -0
  466. package/dist/src/schedule-progress.js +45 -0
  467. package/dist/src/service/active-tickets.d.ts +4 -0
  468. package/dist/src/service/active-tickets.js +49 -0
  469. package/dist/src/service/command-effects.d.ts +4 -0
  470. package/dist/src/service/command-effects.js +16 -0
  471. package/dist/src/service/command-waits.d.ts +34 -0
  472. package/dist/src/service/command-waits.js +86 -0
  473. package/dist/src/service/decision-handler.d.ts +4 -0
  474. package/dist/src/service/decision-handler.js +39 -4
  475. package/dist/src/service/expiry.js +2 -0
  476. package/dist/src/service/gateway.js +21 -4
  477. package/dist/src/service/queue-spend.d.ts +6 -0
  478. package/dist/src/service/queue-spend.js +68 -0
  479. package/dist/src/service/registry.d.ts +16 -3
  480. package/dist/src/service/registry.js +34 -3
  481. package/dist/src/service/replies.d.ts +16 -1
  482. package/dist/src/service/replies.js +23 -0
  483. package/dist/src/service/run-handlers.js +35 -56
  484. package/dist/src/service/run-metadata.d.ts +22 -0
  485. package/dist/src/service/run-metadata.js +138 -0
  486. package/dist/src/service/run-waits.d.ts +3 -0
  487. package/dist/src/service/run-waits.js +41 -0
  488. package/dist/src/service/service.d.ts +22 -2
  489. package/dist/src/service/service.js +29 -13
  490. package/dist/src/service/submission-handler.d.ts +0 -1
  491. package/dist/src/service/submission-handler.js +22 -36
  492. package/dist/src/service/worker-port.d.ts +1 -0
  493. package/dist/src/service/worker-port.js +9 -1
  494. package/dist/src/service/worker-totals.d.ts +2 -0
  495. package/dist/src/service/worker-totals.js +9 -24
  496. package/dist/src/step-bridge.d.ts +43 -0
  497. package/dist/src/steps/command-wait.d.ts +12 -0
  498. package/dist/src/steps/command-wait.js +26 -0
  499. package/dist/src/steps/merge-by-person.d.ts +2 -0
  500. package/dist/src/steps/merge-by-person.js +18 -0
  501. package/dist/src/steps/merge-when-green.d.ts +2 -0
  502. package/dist/src/steps/merge-when-green.js +62 -0
  503. package/dist/src/steps/open-decision-wait.d.ts +2 -0
  504. package/dist/src/steps/open-decision-wait.js +8 -0
  505. package/dist/src/steps/review-by-agent.d.ts +5 -0
  506. package/dist/src/steps/review-by-agent.js +124 -0
  507. package/dist/src/steps/review-by-person.d.ts +4 -0
  508. package/dist/src/steps/review-by-person.js +19 -0
  509. package/dist/src/steps/review-subject.d.ts +2 -0
  510. package/dist/src/steps/review-subject.js +11 -0
  511. package/dist/src/steps/run-command.d.ts +2 -0
  512. package/dist/src/steps/run-command.js +15 -0
  513. package/dist/src/steps/sleep.d.ts +3 -0
  514. package/dist/src/steps/sleep.js +19 -0
  515. package/dist/src/steps/wait-for-command.d.ts +3 -0
  516. package/dist/src/steps/wait-for-command.js +17 -0
  517. package/dist/src/steps/wait-for-decision.d.ts +2 -0
  518. package/dist/src/steps/wait-for-decision.js +71 -0
  519. package/dist/src/steps/wait-for-run.d.ts +5 -0
  520. package/dist/src/steps/wait-for-run.js +9 -0
  521. package/dist/src/storage/command-wait-rows.d.ts +30 -0
  522. package/dist/src/storage/command-wait-rows.js +96 -0
  523. package/dist/src/storage/decision-snapshots.d.ts +9 -1
  524. package/dist/src/storage/decision-snapshots.js +22 -2
  525. package/dist/src/storage/domain-changes.d.ts +2 -0
  526. package/dist/src/storage/domain-changes.js +3 -0
  527. package/dist/src/storage/domain-schema.d.ts +13 -1
  528. package/dist/src/storage/domain-schema.js +31 -4
  529. package/dist/src/storage/effect-schema.d.ts +1 -0
  530. package/dist/src/storage/effect-schema.js +5 -0
  531. package/dist/src/submission.d.ts +4 -0
  532. package/dist/src/submission.js +6 -2
  533. package/dist/src/testing-requests.d.ts +15 -0
  534. package/dist/src/testing-requests.js +93 -0
  535. package/dist/src/testing.d.ts +23 -0
  536. package/dist/src/testing.js +211 -0
  537. package/dist/src/ticket-status-stream.d.ts +9 -0
  538. package/dist/src/ticket-status-stream.js +94 -0
  539. package/dist/src/token-prices.d.ts +12 -4
  540. package/dist/src/token-prices.js +15 -2
  541. package/dist/src/turn-profile.d.ts +1 -0
  542. package/dist/src/turn-profile.js +8 -1
  543. package/dist/src/worker-usage.d.ts +17 -0
  544. package/dist/src/worker-usage.js +60 -0
  545. package/dist/src/workflow-admission.d.ts +5 -0
  546. package/dist/src/workflow-candidate.d.ts +8 -2
  547. package/dist/src/workflow-candidate.js +59 -6
  548. package/dist/src/workflow-contracts.d.ts +1 -0
  549. package/dist/src/workflow-contracts.js +9 -2
  550. package/dist/src/workflow-declaration.d.ts +21 -3
  551. package/dist/src/workflow-declaration.js +77 -9
  552. package/dist/src/workflow-discovery.d.ts +3 -13
  553. package/dist/src/workflow-discovery.js +5 -14
  554. package/dist/src/workflow-refusals.js +3 -1
  555. package/dist/src/workflow-schedule.d.ts +22 -0
  556. package/dist/src/workflow-schedule.js +53 -0
  557. package/dist/src/workflows.d.ts +12 -2
  558. package/dist/src/workflows.js +9 -1
  559. package/dist/tools/admit-workflow.d.ts +1 -0
  560. package/dist/tools/admit-workflow.js +18 -5
  561. package/dist/tools/doctor-adoption.d.ts +1 -0
  562. package/dist/tools/doctor-adoption.js +11 -0
  563. package/dist/tools/project-configuration.d.ts +4 -0
  564. package/dist/tools/project-configuration.js +47 -0
  565. package/dist/tools/red-green-command.d.ts +1 -0
  566. package/dist/tools/red-green-command.js +174 -0
  567. package/dist/tools/red-green-process.d.ts +10 -0
  568. package/dist/tools/red-green-process.js +59 -0
  569. package/dist/tools/self-host-processes.d.ts +3 -0
  570. package/dist/tools/self-host-processes.js +63 -33
  571. package/dist/tools/self-host-project.d.ts +4 -0
  572. package/dist/tools/self-host-project.js +42 -60
  573. package/dist/tools/self-host-runtime.d.ts +16 -0
  574. package/dist/tools/self-host-runtime.js +60 -0
  575. package/dist/tools/self-host-workflows.d.ts +1 -0
  576. package/dist/tools/self-host-workflows.js +36 -1
  577. package/dist/tools/self-host.js +128 -71
  578. package/dist/tools/template-command.d.ts +1 -0
  579. package/dist/tools/template-command.js +160 -0
  580. package/dist/tools/template-copy.d.ts +11 -0
  581. package/dist/tools/template-copy.js +130 -0
  582. package/dist/tools/template-files.d.ts +17 -0
  583. package/dist/tools/template-files.js +74 -0
  584. package/dist/tools/workflow-bundles.js +1 -0
  585. package/dist/tools/workflow-candidate-counts.d.ts +6 -2
  586. package/dist/tools/workflow-candidate-counts.js +31 -16
  587. package/dist/tools/workflow-candidate-fields.d.ts +5 -0
  588. package/dist/tools/workflow-candidate-fields.js +24 -0
  589. package/dist/tools/workflow-candidate-helper-counts.d.ts +10 -0
  590. package/dist/tools/workflow-candidate-helper-counts.js +129 -0
  591. package/dist/tools/workflow-candidate-program.d.ts +2 -0
  592. package/dist/tools/workflow-candidate-program.js +36 -8
  593. package/dist/tools/workflow-candidate-shape.d.ts +3 -0
  594. package/dist/tools/workflow-candidate-shape.js +90 -0
  595. package/dist/tools/workflow-candidate-source.js +92 -16
  596. package/dist/tools/workflow-candidate-syntax.d.ts +9 -3
  597. package/dist/tools/workflow-candidate-syntax.js +83 -109
  598. package/dist/tools/workflow-command.d.ts +1 -0
  599. package/dist/tools/workflow-command.js +142 -0
  600. package/dist/tools/workflow-folder-capture.d.ts +1 -0
  601. package/dist/tools/workflow-folder-capture.js +47 -2
  602. package/dist/tools/workflow-folders.d.ts +18 -3
  603. package/dist/tools/workflow-folders.js +60 -7
  604. package/dist/tools/workflow-test-hook.d.ts +7 -0
  605. package/dist/tools/workflow-test-hook.js +16 -0
  606. package/dist/tools/workflow-test-loader.d.ts +1 -0
  607. package/dist/tools/workflow-test-loader.js +10 -0
  608. package/package.json +60 -10
  609. package/templates/develop/README.md +90 -0
  610. package/templates/develop/develop/accept.ts +11 -0
  611. package/templates/develop/develop/flow-tests.ts +394 -0
  612. package/templates/develop/develop/local.ts +40 -0
  613. package/templates/develop/develop/option-tests.ts +174 -0
  614. package/templates/develop/develop/partial-choice.ts +29 -0
  615. package/templates/develop/develop/partial.ts +28 -0
  616. package/templates/develop/develop/pull.ts +156 -0
  617. package/templates/develop/develop/queue-partial.ts +39 -0
  618. package/templates/develop/develop/refusal-tests.ts +251 -0
  619. package/templates/develop/develop/report.ts +156 -0
  620. package/templates/develop/develop/round.ts +40 -0
  621. package/templates/develop/develop/scenarios.ts +87 -0
  622. package/templates/develop/develop/turn.ts +68 -0
  623. package/templates/develop/develop.declaration.json +24 -0
  624. package/templates/develop/develop.test.ts +287 -0
  625. package/templates/develop/develop.ts +30 -0
  626. package/templates/develop/template.json +153 -0
  627. package/templates/idea-to-issue/README.md +27 -0
  628. package/templates/idea-to-issue/idea-to-issue/effects.ts +52 -0
  629. package/templates/idea-to-issue/idea-to-issue/leave.ts +10 -0
  630. package/templates/idea-to-issue/idea-to-issue/next.ts +29 -0
  631. package/templates/idea-to-issue/idea-to-issue/post-person.ts +18 -0
  632. package/templates/idea-to-issue/idea-to-issue/post.ts +50 -0
  633. package/templates/idea-to-issue/idea-to-issue/queue.ts +27 -0
  634. package/templates/idea-to-issue/idea-to-issue/review.ts +42 -0
  635. package/templates/idea-to-issue/idea-to-issue/scenarios.ts +50 -0
  636. package/templates/idea-to-issue/idea-to-issue/turn.ts +40 -0
  637. package/templates/idea-to-issue/idea-to-issue.declaration.json +16 -0
  638. package/templates/idea-to-issue/idea-to-issue.test.ts +79 -0
  639. package/templates/idea-to-issue/idea-to-issue.ts +49 -0
  640. package/templates/idea-to-issue/template.json +81 -0
  641. package/templates/review-day/README.md +97 -0
  642. package/templates/review-day/review-day/critique.ts +58 -0
  643. package/templates/review-day/review-day/decision.ts +29 -0
  644. package/templates/review-day/review-day/facts.ts +69 -0
  645. package/templates/review-day/review-day/label.ts +29 -0
  646. package/templates/review-day/review-day/next.ts +28 -0
  647. package/templates/review-day/review-day/post.ts +27 -0
  648. package/templates/review-day/review-day/report.ts +98 -0
  649. package/templates/review-day/review-day/rules.ts +12 -0
  650. package/templates/review-day/review-day/scenarios.ts +76 -0
  651. package/templates/review-day/review-day/turn.ts +73 -0
  652. package/templates/review-day/review-day.declaration.json +16 -0
  653. package/templates/review-day/review-day.test.ts +362 -0
  654. package/templates/review-day/review-day.ts +37 -0
  655. package/templates/review-day/template.json +56 -0
  656. package/dist/src/chats/analysis-batches.d.ts +0 -42
  657. package/dist/src/chats/analysis-batches.js +0 -97
  658. package/dist/src/chats/analysis-checkpoint.d.ts +0 -29
  659. package/dist/src/chats/analysis-checkpoint.js +0 -31
  660. package/dist/src/chats/analysis-contract.d.ts +0 -80
  661. package/dist/src/chats/analysis-contract.js +0 -16
  662. package/dist/src/chats/analysis-data.d.ts +0 -3
  663. package/dist/src/chats/analysis-data.js +0 -85
  664. package/dist/src/chats/analysis-input.d.ts +0 -18
  665. package/dist/src/chats/analysis-input.js +0 -97
  666. package/dist/src/chats/analysis-links.d.ts +0 -2
  667. package/dist/src/chats/analysis-links.js +0 -25
  668. package/dist/src/chats/analysis-merge.d.ts +0 -16
  669. package/dist/src/chats/analysis-merge.js +0 -134
  670. package/dist/src/chats/analysis-prompt.d.ts +0 -18
  671. package/dist/src/chats/analysis-prompt.js +0 -42
  672. package/dist/src/chats/analysis-proposal.d.ts +0 -4
  673. package/dist/src/chats/analysis-proposal.js +0 -41
  674. package/dist/src/chats/analysis-provenance.d.ts +0 -4
  675. package/dist/src/chats/analysis-provenance.js +0 -99
  676. package/dist/src/chats/analysis-shape.d.ts +0 -4
  677. package/dist/src/chats/analysis-shape.js +0 -235
  678. package/dist/src/chats/analysis.d.ts +0 -3
  679. package/dist/src/chats/analysis.js +0 -42
  680. package/dist/src/chats/corpus-input.d.ts +0 -5
  681. package/dist/src/chats/corpus-input.js +0 -288
  682. package/dist/src/chats/destination.d.ts +0 -4
  683. package/dist/src/chats/destination.js +0 -96
  684. package/dist/src/chats/import.d.ts +0 -15
  685. package/dist/src/chats/import.js +0 -243
  686. package/dist/src/chats/input-file.d.ts +0 -3
  687. package/dist/src/chats/input-file.js +0 -32
  688. package/dist/src/chats/normalize.d.ts +0 -29
  689. package/dist/src/chats/normalize.js +0 -155
  690. package/dist/src/chats/previous-import.d.ts +0 -5
  691. package/dist/src/chats/previous-import.js +0 -34
  692. package/dist/src/chats/reader.d.ts +0 -21
  693. package/dist/src/chats/reader.js +0 -118
  694. package/dist/src/chats/redact-import.d.ts +0 -14
  695. package/dist/src/chats/redact-import.js +0 -141
  696. package/dist/src/chats/redaction.d.ts +0 -41
  697. package/dist/src/chats/redaction.js +0 -161
  698. package/dist/src/chats/reference-mapping.d.ts +0 -16
  699. package/dist/src/chats/reference-mapping.js +0 -153
  700. package/dist/src/chats/revision-input.d.ts +0 -3
  701. package/dist/src/chats/revision-input.js +0 -180
  702. package/dist/src/chats/revision.d.ts +0 -48
  703. package/dist/src/chats/revision.js +0 -94
  704. package/dist/src/chats/selection.d.ts +0 -25
  705. package/dist/src/chats/selection.js +0 -109
  706. package/dist/src/chats/source.d.ts +0 -23
  707. package/dist/src/chats/source.js +0 -135
  708. package/dist/src/chats/structure.d.ts +0 -57
  709. package/dist/src/chats/structure.js +0 -216
  710. package/dist/src/chats/workflow-generation-projection.d.ts +0 -8
  711. package/dist/src/chats/workflow-generation-projection.js +0 -75
  712. package/dist/src/chats/workflow-generation-source.d.ts +0 -25
  713. package/dist/src/chats/workflow-generation-source.js +0 -124
  714. package/dist/src/chats/workflow-generation-text.d.ts +0 -23
  715. package/dist/src/chats/workflow-generation-text.js +0 -74
  716. package/dist/src/chats/workflow-generation.d.ts +0 -69
  717. package/dist/src/chats/workflow-generation.js +0 -142
  718. package/dist/src/cli/watch-start-view.d.ts +0 -18
  719. package/dist/src/cli/watch-start-view.js +0 -77
  720. package/dist/src/daemon/analysis-launch.d.ts +0 -5
  721. package/dist/src/daemon/analysis-launch.js +0 -81
  722. package/dist/src/daemon/analysis-token.d.ts +0 -6
  723. package/dist/src/daemon/analysis-token.js +0 -88
  724. package/dist/src/daemon/analysis-worker.d.ts +0 -20
  725. package/dist/src/daemon/analysis-worker.js +0 -271
  726. package/dist/src/daemon/chats-batch-binding.d.ts +0 -23
  727. package/dist/src/daemon/chats-batch-binding.js +0 -99
  728. package/dist/src/daemon/chats-capture.d.ts +0 -18
  729. package/dist/src/daemon/chats-capture.js +0 -194
  730. package/dist/src/daemon/chats-checkpoints.d.ts +0 -41
  731. package/dist/src/daemon/chats-checkpoints.js +0 -186
  732. package/dist/src/daemon/chats-files.d.ts +0 -42
  733. package/dist/src/daemon/chats-files.js +0 -252
  734. package/dist/src/daemon/chats-follow-up.d.ts +0 -38
  735. package/dist/src/daemon/chats-follow-up.js +0 -180
  736. package/dist/src/daemon/chats-question.d.ts +0 -15
  737. package/dist/src/daemon/chats-question.js +0 -93
  738. package/dist/src/daemon/chats-worker.d.ts +0 -13
  739. package/dist/src/daemon/chats-worker.js +0 -201
  740. package/dist/src/steps/decision-gate.d.ts +0 -2
  741. package/dist/src/steps/decision-gate.js +0 -8
  742. package/dist/workflows/analyze-chats.d.ts +0 -15
  743. package/dist/workflows/analyze-chats.declaration.json +0 -22
  744. package/dist/workflows/analyze-chats.js +0 -250
  745. package/dist/workflows/develop-prd.d.ts +0 -7
  746. package/dist/workflows/develop-prd.js +0 -165
  747. package/dist/workflows/develop-ticket.d.ts +0 -9
  748. package/dist/workflows/develop-ticket.js +0 -207
  749. package/dist/workflows/issue-labels.d.ts +0 -16
  750. package/dist/workflows/issue-labels.js +0 -70
  751. package/dist/workflows/ticket-prompts.d.ts +0 -35
  752. package/dist/workflows/ticket-prompts.js +0 -143
@@ -0,0 +1,96 @@
1
+ import { record } from "../protocol.js";
2
+ import { hardDependencies } from "../ticket-dependencies.js";
3
+ import { rows, identity, timestamp, issueTimeline, } from "./report-github-reader.js";
4
+ function intervals(events) {
5
+ const labels = events
6
+ .filter((event) => ["labeled", "unlabeled"].includes(String(event["event"])) &&
7
+ record(event["label"])?.["name"] === "cloving: ready")
8
+ .map((event) => ({
9
+ type: event["event"],
10
+ at: timestamp(event["created_at"]),
11
+ }))
12
+ .toSorted((a, b) => a.at - b.at);
13
+ const result = [];
14
+ let start = null;
15
+ for (const label of labels) {
16
+ if (label.type === "labeled")
17
+ start ??= label.at;
18
+ else if (start !== null) {
19
+ result.push({ start, end: label.at });
20
+ start = null;
21
+ }
22
+ }
23
+ if (start !== null)
24
+ result.push({ start, end: null });
25
+ return result;
26
+ }
27
+ async function detail(reader, number) {
28
+ const row = record(await reader.read(`issues/${String(number)}`));
29
+ if (row === undefined ||
30
+ identity(row, { repository: reader.repository, kind: "issues" }) !==
31
+ number ||
32
+ Object.hasOwn(row, "pull_request"))
33
+ throw new Error("identity");
34
+ return row;
35
+ }
36
+ async function dependencies(reader, row) {
37
+ const body = row["body"];
38
+ if (body !== null && typeof body !== "string")
39
+ throw new Error("response");
40
+ const result = [];
41
+ for (const id of hardDependencies(body ?? "")) {
42
+ const number = Number(id);
43
+ if (!Number.isSafeInteger(number))
44
+ throw new Error("identity");
45
+ const dependency = await detail(reader, number);
46
+ const state = dependency["state"];
47
+ if (state !== "closed" && state !== "open")
48
+ throw new Error("response");
49
+ result.push({
50
+ issue: number,
51
+ closedAt: state === "open" ? null : timestamp(dependency["closed_at"]),
52
+ });
53
+ }
54
+ return result;
55
+ }
56
+ export async function readyTicketsOf(reader) {
57
+ const result = [];
58
+ const seen = new Set();
59
+ for (let page = 1;; page += 1) {
60
+ const values = rows(await reader.read(`issues?state=all&per_page=100&page=${String(page)}`, [
61
+ "--jq",
62
+ 'map({number, html_url} + (if has("pull_request") then {pull_request: {}} else {} end))',
63
+ ]));
64
+ const numbers = [];
65
+ for (const row of values) {
66
+ if (Object.hasOwn(row, "pull_request"))
67
+ continue;
68
+ const number = identity(row, {
69
+ repository: reader.repository,
70
+ kind: "issues",
71
+ });
72
+ if (seen.has(number))
73
+ throw new Error("response");
74
+ seen.add(number);
75
+ numbers.push(number);
76
+ }
77
+ for (let offset = 0; offset < numbers.length; offset += 5) {
78
+ const tickets = await Promise.all(numbers
79
+ .slice(offset, offset + 5)
80
+ .map((number) => readyTicket(reader, number)));
81
+ result.push(...tickets.filter((ticket) => ticket !== null));
82
+ }
83
+ if (values.length < 100)
84
+ return result;
85
+ }
86
+ }
87
+ async function readyTicket(reader, number) {
88
+ const ready = intervals(await issueTimeline(reader, number));
89
+ if (ready.length === 0)
90
+ return null;
91
+ return {
92
+ issue: number,
93
+ intervals: ready,
94
+ dependencies: await dependencies(reader, await detail(reader, number)),
95
+ };
96
+ }
@@ -0,0 +1,9 @@
1
+ import type { loopReport } from "../report.ts";
2
+ type TextReport = Omit<ReturnType<typeof loopReport>, "window" | "runCosts"> & {
3
+ readonly window: Readonly<Record<string, string | number>>;
4
+ readonly runCosts: readonly (Omit<ReturnType<typeof loopReport>["runCosts"][number], "completedAt"> & {
5
+ readonly completedAt: string;
6
+ })[];
7
+ };
8
+ export declare function textReport(report: TextReport): string;
9
+ export {};
@@ -0,0 +1,33 @@
1
+ function isMetric(value) {
2
+ return typeof value["status"] === "string";
3
+ }
4
+ function sectionMetrics(section, prefix) {
5
+ return Object.fromEntries(Object.entries(section).flatMap(([name, value]) => isMetric(value)
6
+ ? [[`${prefix}.${name}`, value]]
7
+ : Object.entries(value).map(([key, metric]) => [`${prefix}.${name}.${key}`, metric])));
8
+ }
9
+ export function textReport(report) {
10
+ const lines = [`Loop report ${JSON.stringify(report.window)}`];
11
+ const { jobLogs, ...quality } = report.quality;
12
+ const metrics = {
13
+ ...report.metrics,
14
+ ...sectionMetrics(quality, "quality"),
15
+ ...sectionMetrics(report.ci, "ci"),
16
+ ...sectionMetrics(report.operator, "operator"),
17
+ };
18
+ for (const [name, metric] of Object.entries(metrics)) {
19
+ lines.push(`${name}: ${metric.status === "unavailable" ? "unavailable" : String(metric.value)}`);
20
+ const baseline = metric.baseline;
21
+ lines.push(` history: ${baseline.history}; median: ${String(baseline.median)}; band: ${JSON.stringify(baseline.band)}${metric.mark === "outside" ? "; outside" : ""}`);
22
+ lines.push(` comparison value: ${String(metric.comparisonValue)}`);
23
+ lines.push(` evidence: ${JSON.stringify(metric.evidence)}`);
24
+ lines.push(` baseline evidence: ${JSON.stringify(baseline.evidence)}`);
25
+ }
26
+ lines.push(`Quality job logs: ${JSON.stringify(jobLogs)}`);
27
+ lines.push(`Run costs (USD): ${JSON.stringify(report.runCosts)}`);
28
+ lines.push(`Completed ticket costs (USD): ${JSON.stringify(report.completedTicketCosts)}`);
29
+ lines.push(`Semantics: ${JSON.stringify(report.semantics)}`);
30
+ lines.push(`Sources: ${JSON.stringify(report.sources)}`);
31
+ lines.push(`Coverage: ${JSON.stringify(report.coverage)}`);
32
+ return lines.join("\n") + "\n";
33
+ }
@@ -0,0 +1,18 @@
1
+ import { type Fields } from "../protocol.ts";
2
+ import { type ReportCompletion } from "../report.ts";
3
+ import type { WatchPrSettings } from "./watch-pr-settings.ts";
4
+ interface ReportEnvironment {
5
+ readonly now?: number;
6
+ readonly runtimeDirectory: string;
7
+ readonly workingDirectory: string;
8
+ readonly watchPr?: WatchPrSettings;
9
+ readonly terminal: {
10
+ readonly out: (text: string) => void;
11
+ };
12
+ }
13
+ export declare function reportCommand(invocation: {
14
+ readonly since: number;
15
+ readonly json: boolean;
16
+ }, environment: ReportEnvironment): Promise<number>;
17
+ export declare function reportCompletion(event: Fields): ReportCompletion | null;
18
+ export {};
@@ -0,0 +1,269 @@
1
+ import { textReport } from "./report-text.js";
2
+ import { record } from "../protocol.js";
3
+ import { loopReport, } from "../report.js";
4
+ import { send } from "./client.js";
5
+ import { readReportFlow } from "./report-flow.js";
6
+ import { readReportGithub } from "./report-github.js";
7
+ function reportRecord(value, after) {
8
+ const event = record(value) ?? {};
9
+ const sequence = event["sequence"];
10
+ const at = event["recordedAt"];
11
+ if (typeof sequence !== "number" ||
12
+ !Number.isSafeInteger(sequence) ||
13
+ sequence <= after ||
14
+ typeof at !== "string" ||
15
+ !Number.isFinite(Date.parse(at)))
16
+ throw new Error("invalid-report-cursor");
17
+ return { event, sequence, at: Date.parse(at) };
18
+ }
19
+ function appendEvents(snapshot, values) {
20
+ for (const value of values) {
21
+ const parsed = reportRecord(value, snapshot.after);
22
+ if (snapshot.latest !== null && parsed.sequence > snapshot.latest)
23
+ break;
24
+ snapshot.after = parsed.sequence;
25
+ if (snapshot.observedSince === null || parsed.at < snapshot.observedSince)
26
+ snapshot.observedSince = parsed.at;
27
+ if (["effect.requested", "effect.reported"].includes(String(parsed.event["type"])))
28
+ snapshot.effects.push({ ...parsed.event, at: parsed.at });
29
+ if (["run.started", "schedule.skipped"].includes(String(parsed.event["type"])))
30
+ snapshot.flowEvents.push(parsed.event);
31
+ const completion = reportCompletion(parsed.event);
32
+ if (completion === null)
33
+ continue;
34
+ if (snapshot.completions.has(completion.runId))
35
+ throw new Error("duplicate-report-completion");
36
+ snapshot.completions.set(completion.runId, completion);
37
+ }
38
+ }
39
+ async function daemonReport(runtime) {
40
+ const snapshot = {
41
+ after: 0,
42
+ latest: null,
43
+ observedSince: null,
44
+ completions: new Map(),
45
+ effects: [],
46
+ flowEvents: [],
47
+ };
48
+ for (;;) {
49
+ const reply = await send(runtime, {
50
+ operation: "events",
51
+ parameters: { after: snapshot.after, limit: 1000 },
52
+ });
53
+ if (reply.kind === "error")
54
+ throw new Error(reply.error.code);
55
+ const latest = reply.result["latestSequence"];
56
+ if (typeof latest !== "number" ||
57
+ !Number.isSafeInteger(latest) ||
58
+ latest < snapshot.after)
59
+ throw new Error("invalid-report-snapshot");
60
+ snapshot.latest ??= latest;
61
+ const events = reply.result["events"];
62
+ if (!Array.isArray(events))
63
+ throw new Error("invalid-report-events");
64
+ appendEvents(snapshot, events);
65
+ if (snapshot.after >= snapshot.latest)
66
+ return {
67
+ completions: [...snapshot.completions.values()],
68
+ effects: snapshot.effects,
69
+ flowEvents: snapshot.flowEvents,
70
+ observedSince: snapshot.observedSince,
71
+ };
72
+ if (events.length < 1000)
73
+ throw new Error("incomplete-report-snapshot");
74
+ }
75
+ }
76
+ function settledSpending(run) {
77
+ const condition = run["condition"];
78
+ const effects = run["effects"];
79
+ return (["completed", "failed", "cancelled"].includes(String(condition)) &&
80
+ Array.isArray(effects) &&
81
+ effects.every((value) => ["completed", "failed", "stopped", "cancelled", "refused"].includes(String(record(value)?.["state"]))));
82
+ }
83
+ async function runCost(runtime, runId) {
84
+ const reply = await send(runtime, {
85
+ operation: "status",
86
+ parameters: { runId },
87
+ });
88
+ if (reply.kind === "error")
89
+ return { runId, turns: null };
90
+ const run = record(reply.result["run"]);
91
+ if (run?.["runId"] !== runId)
92
+ return { runId, turns: null };
93
+ const turns = run["workerTurns"];
94
+ const ticket = runTicket(run);
95
+ if (!Array.isArray(turns) || !settledSpending(run))
96
+ return { runId, ...ticket, turns: null };
97
+ const parsed = turns.map((value) => {
98
+ const turn = record(value);
99
+ const operationId = turn?.["operationId"];
100
+ const costUsd = turn?.["costUsd"];
101
+ return typeof operationId === "string" &&
102
+ (costUsd === null ||
103
+ (typeof costUsd === "number" &&
104
+ Number.isFinite(costUsd) &&
105
+ costUsd >= 0))
106
+ ? { operationId, costUsd }
107
+ : null;
108
+ });
109
+ return {
110
+ runId,
111
+ ...ticket,
112
+ turns: parsed.some((turn) => turn === null)
113
+ ? null
114
+ : parsed.filter((turn) => turn !== null),
115
+ };
116
+ }
117
+ export async function reportCommand(invocation, environment) {
118
+ const now = environment.now ?? Date.now();
119
+ const since = new Date(now - (invocation.since + 168) * 3_600_000).toISOString();
120
+ const settings = environment.watchPr === undefined ? {} : { settings: environment.watchPr };
121
+ const [daemonRead, githubRead] = await Promise.allSettled([
122
+ daemonReport(environment.runtimeDirectory),
123
+ readReportGithub({ since, ...settings }),
124
+ ]);
125
+ const daemon = daemonRead.status === "fulfilled"
126
+ ? daemonRead.value
127
+ : {
128
+ completions: null,
129
+ effects: null,
130
+ flowEvents: null,
131
+ observedSince: null,
132
+ };
133
+ const github = githubRead.status === "fulfilled" ? { github: githubRead.value } : {};
134
+ const costs = await reportCosts(environment.runtimeDirectory, {
135
+ completions: daemon.completions ?? [],
136
+ start: Date.parse(since),
137
+ end: now,
138
+ issues: githubRead.status === "fulfilled" ? githubRead.value.issues : null,
139
+ });
140
+ const calculated = loopReport({
141
+ flow: await readReportFlow(environment.runtimeDirectory, {
142
+ events: daemon.flowEvents,
143
+ start: Date.parse(since),
144
+ completions: daemon.completions,
145
+ }),
146
+ since: invocation.since,
147
+ now,
148
+ ...daemon,
149
+ costs,
150
+ ...github,
151
+ });
152
+ const report = {
153
+ ...calculated,
154
+ window: {
155
+ ...calculated.window,
156
+ start: new Date(calculated.window.start).toISOString(),
157
+ end: new Date(now).toISOString(),
158
+ },
159
+ runCosts: calculated.runCosts.map((cost) => ({
160
+ ...cost,
161
+ completedAt: new Date(cost.completedAt).toISOString(),
162
+ })),
163
+ };
164
+ environment.terminal.out(invocation.json ? `${JSON.stringify(report)}\n` : textReport(report));
165
+ return 0;
166
+ }
167
+ function outcomeOf(event) {
168
+ if (event["type"] === "run.failed")
169
+ return "failed";
170
+ if (event["type"] === "run.cancelled")
171
+ return "cancelled";
172
+ if (event["type"] !== "run.completed")
173
+ return null;
174
+ const payload = record(event["payload"]) ?? {};
175
+ if (payload["outcome"] === "handoff_requested" &&
176
+ payload["ticketStatus"] === "partial")
177
+ return "partial";
178
+ const outcome = payload["outcome"];
179
+ if (outcome === undefined || outcome === "handoff_requested")
180
+ return "completed";
181
+ return outcome === "blocked" ? "blocked" : null;
182
+ }
183
+ export function reportCompletion(event) {
184
+ const terminal = ["run.completed", "run.failed", "run.cancelled"].includes(String(event["type"]));
185
+ if (!terminal)
186
+ return null;
187
+ const outcome = outcomeOf(event);
188
+ if (outcome === null)
189
+ throw new Error("invalid-report-event");
190
+ const runId = event["runId"];
191
+ const sequence = event["sequence"];
192
+ const at = event["recordedAt"];
193
+ if (typeof runId !== "string" ||
194
+ typeof sequence !== "number" ||
195
+ typeof at !== "string" ||
196
+ !Number.isFinite(Date.parse(at)))
197
+ throw new Error("invalid-report-event");
198
+ return { runId, sequence, at: Date.parse(at), outcome };
199
+ }
200
+ function runTicket(run) {
201
+ const ticketId = run?.["ticketId"];
202
+ return ticketId === null || (typeof ticketId === "string" && ticketId !== "")
203
+ ? { ticketId }
204
+ : {};
205
+ }
206
+ async function ticketIndex(runtime) {
207
+ const index = new Map();
208
+ let after = "";
209
+ for (;;) {
210
+ const reply = await send(runtime, {
211
+ operation: "status",
212
+ parameters: { metadata: "tickets", after, limit: 500 },
213
+ });
214
+ if (reply.kind === "error")
215
+ throw new Error(reply.error.code);
216
+ const runs = reply.result["runs"];
217
+ if (!Array.isArray(runs))
218
+ throw new Error("invalid-report-ticket-index");
219
+ const latest = appendTicketIndex(index, { runs, after });
220
+ const next = reply.result["next"];
221
+ if (next === null)
222
+ return index;
223
+ if (typeof next !== "string" || next !== latest || next <= after)
224
+ throw new Error("invalid-report-ticket-cursor");
225
+ after = next;
226
+ }
227
+ }
228
+ async function reportCosts(runtime, input) {
229
+ const ended = input.completions.filter((event) => event.at < input.end);
230
+ const costs = [];
231
+ for (const event of ended.filter((event) => event.at >= input.start))
232
+ costs.push(await runCost(runtime, event.runId));
233
+ const older = ended.filter((event) => event.at < input.start);
234
+ const tickets = new Set((input.issues ?? [])
235
+ .filter((issue) => issue.at >= input.start && issue.at < input.end)
236
+ .map((issue) => String(issue.evidence["issue"])));
237
+ if (older.length === 0 || tickets.size === 0)
238
+ return costs;
239
+ try {
240
+ const index = await ticketIndex(runtime);
241
+ for (const event of older) {
242
+ const ticketId = index.get(event.runId);
243
+ if (ticketId === undefined)
244
+ continue;
245
+ costs.push(ticketId !== null && tickets.has(ticketId)
246
+ ? await runCost(runtime, event.runId)
247
+ : { runId: event.runId, ticketId, turns: null });
248
+ }
249
+ }
250
+ catch {
251
+ return costs;
252
+ }
253
+ return costs;
254
+ }
255
+ function appendTicketIndex(index, page) {
256
+ let latest = page.after;
257
+ for (const value of page.runs) {
258
+ const row = record(value);
259
+ const runId = row?.["runId"];
260
+ const ticketId = row?.["ticketId"];
261
+ if (typeof runId !== "string" ||
262
+ runId <= latest ||
263
+ !(ticketId === null || (typeof ticketId === "string" && ticketId !== "")))
264
+ throw new Error("invalid-report-ticket-index");
265
+ index.set(runId, ticketId);
266
+ latest = runId;
267
+ }
268
+ return latest;
269
+ }
@@ -0,0 +1,5 @@
1
+ import { type ParseArgsConfig } from "node:util";
2
+ export declare function repositoryArguments(argumentsList: readonly string[], options: NonNullable<ParseArgsConfig["options"]>): {
3
+ readonly argumentsList: readonly string[];
4
+ readonly repository: string | undefined;
5
+ } | string;
@@ -0,0 +1,34 @@
1
+ import { parseArgs } from "node:util";
2
+ export function repositoryArguments(argumentsList, options) {
3
+ if (!argumentsList.some((argument) => argument === "--repository" || argument.startsWith("--repository=")))
4
+ return { argumentsList, repository: undefined };
5
+ try {
6
+ const parsed = parseArgs({
7
+ args: [...argumentsList],
8
+ options: {
9
+ ...options,
10
+ repository: { type: "string" },
11
+ },
12
+ tokens: true,
13
+ allowPositionals: true,
14
+ strict: false,
15
+ });
16
+ const selectors = parsed.tokens.filter((token) => token.kind === "option" && token.name === "repository");
17
+ if (selectors.length > 1)
18
+ return "repeated-option";
19
+ const removed = new Set(selectors.flatMap((token) => token.kind === "option" && !token.inlineValue
20
+ ? [token.index, token.index + 1]
21
+ : [token.index]));
22
+ const repository = parsed.values["repository"];
23
+ if (selectors.length > 0 &&
24
+ (typeof repository !== "string" || repository === ""))
25
+ return "missing-value";
26
+ return {
27
+ argumentsList: argumentsList.filter((_, index) => !removed.has(index)),
28
+ repository: typeof repository === "string" ? repository : undefined,
29
+ };
30
+ }
31
+ catch {
32
+ return "missing-value";
33
+ }
34
+ }
@@ -1,3 +1,4 @@
1
+ import { type ScheduleInvocation } from "./schedule-arguments.ts";
1
2
  export type RunSource = {
2
3
  readonly kind: "prompt";
3
4
  readonly text: string;
@@ -10,7 +11,11 @@ export type RunSource = {
10
11
  };
11
12
  type DecisionCommand = "answer" | "approve" | "deny";
12
13
  type RunCommand = "pause" | "resume" | "drop";
13
- export type RuntimeInvocation = {
14
+ export type RuntimeInvocation = ScheduleInvocation | {
15
+ readonly kind: "report";
16
+ readonly since: number;
17
+ readonly json: boolean;
18
+ } | {
14
19
  readonly kind: "command-help";
15
20
  readonly command: string;
16
21
  } | {
@@ -1,4 +1,5 @@
1
1
  import { isRecordKey } from "../authority/commands.js";
2
+ import { scheduleInvocation, } from "./schedule-arguments.js";
2
3
  const identifier = /^[A-Za-z0-9._:/-]{1,128}$/;
3
4
  const decisionReference = /^[A-Za-z0-9._:/-]{1,256}$/;
4
5
  const sha256Digest = /^sha256:[0-9a-f]{64}$/;
@@ -51,6 +52,15 @@ const shapes = new Map([
51
52
  build: events,
52
53
  },
53
54
  ],
55
+ [
56
+ "report",
57
+ {
58
+ subject: "none",
59
+ required: [],
60
+ allowed: () => ["since", "json"],
61
+ build: report,
62
+ },
63
+ ],
54
64
  [
55
65
  "watch",
56
66
  {
@@ -62,17 +72,21 @@ const shapes = new Map([
62
72
  ],
63
73
  ]);
64
74
  export function isRuntimeCommand(command) {
65
- return shapes.has(command);
75
+ return command === "schedule" || shapes.has(command);
66
76
  }
67
77
  export function runtimeInvocation(request) {
68
78
  const shape = shapes.get(request.command);
69
- if (shape === undefined)
79
+ if (!isRuntimeCommand(request.command))
70
80
  return "unknown-command";
71
81
  const names = request.options.map((option) => option.name);
72
82
  if (new Set(names).size !== names.length)
73
83
  return "repeated-option";
74
84
  if (names.includes("help"))
75
85
  return { kind: "command-help", command: request.command };
86
+ if (request.command === "schedule")
87
+ return scheduleInvocation(request);
88
+ if (shape === undefined)
89
+ return "unknown-command";
76
90
  return shapeFailure(shape, request) ?? shape.build(request);
77
91
  }
78
92
  function shapeFailure(shape, request) {
@@ -246,3 +260,9 @@ function events(request) {
246
260
  const json = given(request, "json");
247
261
  return { kind: "events", runId, after: after ?? 0, limit, follow, json };
248
262
  }
263
+ function report(request) {
264
+ const since = whole(valueOf(request, "since"), { minimum: 1, maximum: 168 });
265
+ if (since === invalid)
266
+ return "invalid-option-value";
267
+ return { kind: "report", since: since ?? 24, json: given(request, "json") };
268
+ }
@@ -1,4 +1,8 @@
1
1
  type Environment = Readonly<Record<string, string | undefined>>;
2
- export declare function clientCommand(environment: Environment): string;
3
- export declare function runtimeDirectory(environment: Environment): string | undefined;
2
+ export declare function shellArgument(value: string): string;
3
+ export declare function clientCommand(environment: Environment, repository?: string): string;
4
+ export declare function repositoryRuntimeName(repository: string): string;
5
+ export declare function adoptionRecordPath(environment: Environment, repository: string): string | undefined;
6
+ export declare function legacyRuntimeDirectory(environment: Environment): string | undefined;
7
+ export declare function runtimeDirectory(environment: Environment, repository?: string): string | undefined;
4
8
  export {};
@@ -1,25 +1,83 @@
1
- import { join } from "node:path";
1
+ import { repositoryFileName } from "../repository-identity.js";
2
+ import { createHash } from "node:crypto";
3
+ import { readFileSync, realpathSync } from "node:fs";
4
+ import { basename, isAbsolute, join } from "node:path";
5
+ import { record } from "../protocol.js";
2
6
  function given(value) {
3
7
  return value !== undefined && value.length > 0;
4
8
  }
5
- export function clientCommand(environment) {
9
+ export function shellArgument(value) {
10
+ return /^[A-Za-z0-9_./-]+$/.test(value)
11
+ ? value
12
+ : `'${value.replaceAll("'", "'\\''")}'`;
13
+ }
14
+ export function clientCommand(environment, repository) {
6
15
  const explicit = environment["CLOVING_RUNTIME_DIR"];
7
16
  return given(explicit)
8
- ? `CLOVING_RUNTIME_DIR=${explicit} cloving`
9
- : "cloving";
17
+ ? `CLOVING_RUNTIME_DIR=${shellArgument(explicit)} cloving`
18
+ : `cloving${repository === undefined ? "" : ` --repository ${shellArgument(repository)}`}`;
19
+ }
20
+ function stateRoot(environment) {
21
+ const state = environment["XDG_STATE_HOME"];
22
+ if (given(state))
23
+ return state;
24
+ const home = environment["HOME"];
25
+ return given(home) ? join(home, ".local", "state") : undefined;
26
+ }
27
+ export function repositoryRuntimeName(repository) {
28
+ const canonical = realpathSync(repository);
29
+ return repositoryFileName({
30
+ name: basename(canonical),
31
+ sha256: createHash("sha256").update(canonical).digest("hex"),
32
+ });
33
+ }
34
+ export function adoptionRecordPath(environment, repository) {
35
+ const state = stateRoot(environment);
36
+ return state === undefined
37
+ ? undefined
38
+ : join(state, "cloving", "adopted-runtime", `${repositoryRuntimeName(repository)}.json`);
39
+ }
40
+ export function legacyRuntimeDirectory(environment) {
41
+ const runtime = environment["XDG_RUNTIME_DIR"];
42
+ if (given(runtime))
43
+ return join(runtime, "cloving");
44
+ const state = stateRoot(environment);
45
+ return state === undefined ? undefined : join(state, "cloving", "run");
46
+ }
47
+ function adoptedRuntime(environment, repository) {
48
+ const path = adoptionRecordPath(environment, repository);
49
+ if (path === undefined)
50
+ return undefined;
51
+ try {
52
+ return runtimeRecord(path, repository);
53
+ }
54
+ catch (error) {
55
+ if (error instanceof Error && "code" in error && error.code === "ENOENT")
56
+ return undefined;
57
+ throw error;
58
+ }
10
59
  }
11
- export function runtimeDirectory(environment) {
60
+ function runtimeRecord(path, repository) {
61
+ const value = record(JSON.parse(readFileSync(path, "utf8")));
62
+ if (value?.["schemaVersion"] === 1 &&
63
+ value["repository"] === realpathSync(repository) &&
64
+ typeof value["runtimeDirectory"] === "string" &&
65
+ isAbsolute(value["runtimeDirectory"]))
66
+ return value["runtimeDirectory"];
67
+ throw new Error("invalid-runtime-record");
68
+ }
69
+ export function runtimeDirectory(environment, repository) {
12
70
  const explicit = environment["CLOVING_RUNTIME_DIR"];
13
71
  if (given(explicit))
14
72
  return explicit;
73
+ if (repository === undefined)
74
+ return undefined;
75
+ const adopted = adoptedRuntime(environment, repository);
76
+ if (adopted !== undefined)
77
+ return adopted;
15
78
  const runtime = environment["XDG_RUNTIME_DIR"];
16
- if (given(runtime))
17
- return join(runtime, "cloving");
18
- const state = environment["XDG_STATE_HOME"];
19
- if (given(state))
20
- return join(state, "cloving", "run");
21
- const home = environment["HOME"];
22
- return given(home)
23
- ? join(home, ".local", "state", "cloving", "run")
24
- : undefined;
79
+ const root = given(runtime) ? runtime : stateRoot(environment);
80
+ return root === undefined
81
+ ? undefined
82
+ : join(root, "cloving", repositoryRuntimeName(repository), "run");
25
83
  }
@@ -0,0 +1,14 @@
1
+ import type { ServiceRequest } from "../protocol.ts";
2
+ export interface ScheduleInvocation {
3
+ readonly kind: "schedule";
4
+ readonly action: "list" | "pause" | "resume";
5
+ readonly workflowId: string | null;
6
+ readonly json: boolean;
7
+ }
8
+ export declare function scheduleInvocation(request: {
9
+ readonly positionals: readonly string[];
10
+ readonly options: readonly {
11
+ readonly name: string;
12
+ }[];
13
+ }): ScheduleInvocation | string;
14
+ export declare function scheduleServiceRequest(invocation: ScheduleInvocation): ServiceRequest;