@apralabs/apra-fleet 0.4.3 → 0.4.5

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 (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -0,0 +1,731 @@
1
+ // =============================================================================
2
+ // PAUSED AWAITING A DECISION, AND RESUMING ON THE ANSWER.
3
+ //
4
+ // decisions.mjs records a NEEDS-DECISION request and sets its bead aside.
5
+ // When the run then reaches the point where it used to throw
6
+ // StalledSprintError -- nothing is ready and every open in-scope bead is set
7
+ // aside or stuck behind a set-aside bead -- and at least one decision is
8
+ // still pending, runner.js calls awaitAnswer() below instead of throwing.
9
+ //
10
+ // UNFILED DECISION: a decision whose decision bead could not be filed (the
11
+ // best-effort `bd create` in decisions.mjs failed) has no answer path, so it
12
+ // never holds the run: a stall on it alone still throws StalledSprintError,
13
+ // whose set-aside reason names it with its full question and says the
14
+ // decision bead could not be filed. recordDecisionAnswer refuses it.
15
+ //
16
+ // MIXED CASE (decided): the run pauses while ANY decision is pending, even if
17
+ // some other remaining bead is set aside for a non-decision reason (a doer
18
+ // BLOCKED, a set-aside deploy): answering the decision may unblock work. Only
19
+ // a stall with NO pending decision still throws StalledSprintError, exactly as
20
+ // before.
21
+ //
22
+ // THE WAIT parks the run ONCE through the engine's EXISTING cooperative pause
23
+ // (the requestPause/requestResume pair the usage-limit controller drives),
24
+ // with the typed source 'needs_decision', and then stays parked -- members
25
+ // reserved and idle -- until an answer is available or the operator stops:
26
+ //
27
+ // requestPause(reason, { source: 'needs_decision' }) -- ONCE; state
28
+ // 'paused-awaiting-decision' (sprintState.decisionWait and the
29
+ // 'decisions' published state namespace)
30
+ // issue ONE read of the pending decision beads (`bd show`), which blocks
31
+ // at the engine's pause gate: it runs only once the run is released,
32
+ // and an operator stop rejects it
33
+ // every poll interval (a non-blocking timer; woken at once by
34
+ // recordDecisionAnswer) check ONLY the in-process answer queue -- no
35
+ // command, no log line, no resume
36
+ // every read poll interval, ONE pause-exempt `bd show --json` of the
37
+ // holding decision beads on the backlog member (command() with
38
+ // opts.pauseExempt: it skips the pause gate and is not an in-flight
39
+ // activity) -- no pull, no resync, no member release, no pause/resume
40
+ // an answer is queued, or the read reports a holding decision bead
41
+ // closed: requestResume(...) ONCE -- the engine's pre-resume hook runs
42
+ // as for any resume (the CLI skips its re-reserve/resync for this
43
+ // pause, because it never handed the reservations back) -- the blocked
44
+ // read runs, a queued answer is applied, and `bd comments` is read for
45
+ // every decision bead the read reports closed
46
+ //
47
+ // ANSWER SOURCES. (a) The in-process answer queue: recordDecisionAnswer /
48
+ // answerPendingDecision, which the run's own viewer action and the
49
+ // supervisor's POST /api/sprints/:id/decisions/:decisionId reach. It needs no
50
+ // member command, so the 60s poll checks only it. (b) An operator running
51
+ // `bd human respond` elsewhere: the read poll above sees the decision bead
52
+ // closed and resumes the run on its own, within one read poll interval -- no
53
+ // dashboard Resume needed. The read targets the backlog member (the
54
+ // supervisor-owned, unreservable member on the project beads folder), so it
55
+ // touches no reserved sprint member. An operator Resume still works as
56
+ // before: it runs the blocked read, pulls the beads clone and reads once more
57
+ // when nothing is answered yet. A release with no answer logs ONE line and,
58
+ // after one poll interval (an answer or a stop ends it early), parks the run
59
+ // again -- never a tight loop.
60
+ //
61
+ // A decision bead CLOSED by `bd human respond` is an answer; its last
62
+ // "Response: ..." comment is the answer text (a bead closed some other way,
63
+ // e.g. `bd human dismiss`, counts as answered with no text). For each answer
64
+ // the work bead's notes gain the chosen answer (appended), the set-aside
65
+ // entries recorded for that decision (the bead and its blocks dependents) are
66
+ // cleared, the decision moves from sprintState.pendingDecisions to
67
+ // sprintState.answeredDecisions, and the run continues: the released bead
68
+ // re-enters through the ordinary ready set.
69
+ //
70
+ // POLL INTERVALS: DECISION_POLL_INTERVAL_MS_DEFAULT (60s, the in-process
71
+ // queue check), overridable with the APRA_FLEET_DECISION_POLL_MS environment
72
+ // variable, and DECISION_READ_POLL_INTERVAL_MS_DEFAULT (5 minutes, the
73
+ // decision bead read), overridable with APRA_FLEET_DECISION_READ_POLL_MS (each
74
+ // a positive integer, in milliseconds). Never a tight loop. Logging is one
75
+ // line per state change (paused, an out-of-process answer seen, a failed
76
+ // resume or a failed read -- once per distinct error --, released without an
77
+ // answer, resumed), never one per poll.
78
+ //
79
+ // IDLE TIMEOUT: the ~30 minute DEFAULT_IDLE_TIMEOUT_MS is the fleet server's
80
+ // cloud idle manager, which STOPS an idle cloud member's VM; it never aborts a
81
+ // sprint. The engine itself has no pause timeout, and this wait has no total
82
+ // budget of its own: a decision may take hours. Nothing touches the sprint
83
+ // members while waiting (the read poll goes to the backlog member only), so a
84
+ // cloud member may be stopped as idle; the next dispatch to it restarts it
85
+ // transparently, as after a usage-limit pause.
86
+ //
87
+ // RESERVATIONS: unlike the usage-limit pause, the members stay reserved by
88
+ // this sprint for the whole wait: the CLI's 'paused' handler skips the
89
+ // hand-back when the pause source is 'needs_decision' (and its pre-resume
90
+ // hook then has nothing to re-acquire or resync), so no other sprint can take
91
+ // a member meanwhile. The sprint lock is held too: a paused run is running.
92
+ //
93
+ // STOP: an operator stop during the wait rejects at once with a CancelledError
94
+ // -- through the engine's stop signal (context.stopSignal()), which also
95
+ // cancels an in-flight pause-exempt read, and through the read blocked at the
96
+ // pause gate -- and it is propagated (never swallowed),
97
+ // so the run tears down immediately, with no further dispatch. The wait never
98
+ // re-parks a run whose stop signal has fired.
99
+ //
100
+ // recordDecisionAnswer(decisionId, answer) is the programmatic answer entry
101
+ // point (for a dashboard route). It only VALIDATES and QUEUES the answer and
102
+ // resolves as soon as it is recorded ({ status: 'recorded' }); it never awaits
103
+ // a resume, a member command or a push, and it never calls pushBeads itself.
104
+ // The queued answer is applied exactly once, through the SAME
105
+ // `bd human respond` command an operator runs, so the bead state is identical:
106
+ // - while the run is waiting: the wait is woken at once, resumes the run
107
+ // once and applies it;
108
+ // - while the run is running: the runner calls applyRecordedAnswers() inside
109
+ // its next beads sync bracket (the start of the next cycle, after the
110
+ // bracket's pull), which writes the `bd human respond` / `bd note`
111
+ // commands and pushes once, all inside that bracket and under the dolt
112
+ // push mutex -- never a free-standing push overlapping a phase's own.
113
+ // An apply error surfaces in the log and in the published 'decisions' state
114
+ // (answerErrors), not through the route; the decision stays pending so it can
115
+ // be answered again.
116
+ // =============================================================================
117
+
118
+ import { stageCommandBodyMemberSide } from './member-provisioning.mjs';
119
+ import { collectSetAsideEntries } from './set-aside.mjs';
120
+ import { removeStagedBody } from './decisions.mjs';
121
+ import { CancelledError } from '@apralabs/apra-fleet-workflow';
122
+
123
+ /** The run state while waiting (sprintState.decisionWait.state, published under 'decisions'). */
124
+ export const PAUSED_AWAITING_DECISION = 'paused-awaiting-decision';
125
+
126
+ /** requestPause's typed source for this pause. */
127
+ export const DECISION_PAUSE_SOURCE = 'needs_decision';
128
+
129
+ /** The published state namespace. */
130
+ export const DECISIONS_STATE_NAMESPACE = 'decisions';
131
+
132
+ export const DECISION_POLL_INTERVAL_MS_DEFAULT = 60_000;
133
+
134
+ /** How often a paused run reads its decision beads for an out-of-process answer. */
135
+ export const DECISION_READ_POLL_INTERVAL_MS_DEFAULT = 5 * 60_000;
136
+
137
+ // Every decision wait currently paused in this process. An in-process answer
138
+ // route (the sprint's own viewer/dashboard) finds the run to answer here.
139
+ const liveWaits = new Set();
140
+
141
+ // Every decision wait created in this process, so an in-process answer route
142
+ // can find the run owning a pending decision whether or not that run is
143
+ // currently paused (a decision may be pending while other beads still run).
144
+ // Pruned of idle entries on each creation so it cannot grow without bound.
145
+ const allWaits = new Set();
146
+
147
+ /**
148
+ * Answers a pending decision through whichever run in this process owns it.
149
+ * Same bead state as `bd human respond`; the run resumes without relaunch.
150
+ * Throws when no run has that pending decision.
151
+ * @param {string} decisionId
152
+ * @param {string} answer
153
+ * @returns {Promise<object>}
154
+ */
155
+ export async function answerPendingDecision(decisionId, answer) {
156
+ for (const w of allWaits) {
157
+ if (w.pending().some((d) => d.decisionId === decisionId)) return w.recordDecisionAnswer(decisionId, answer);
158
+ }
159
+ throw new Error(`no pending decision ${JSON.stringify(decisionId)}`);
160
+ }
161
+
162
+ /** The pending decisions of every run in this process (full, untruncated). */
163
+ export function allPendingDecisions() {
164
+ return [...allWaits].flatMap((w) => w.pending());
165
+ }
166
+
167
+ /**
168
+ * The decision waits currently paused in this process: each exposes
169
+ * pending() (the pending decision records) and recordDecisionAnswer().
170
+ * @returns {Array<{ pending: () => object[], recordDecisionAnswer: (decisionId: string, answer: string) => Promise<object> }>}
171
+ */
172
+ export function activeDecisionWaits() {
173
+ return [...liveWaits];
174
+ }
175
+
176
+ /** The poll interval: APRA_FLEET_DECISION_POLL_MS when it is a positive integer, else the default. */
177
+ export function decisionPollIntervalMs(env = process.env) {
178
+ const raw = env && env.APRA_FLEET_DECISION_POLL_MS;
179
+ const n = Number(raw);
180
+ return raw !== undefined && raw !== '' && Number.isInteger(n) && n > 0 ? n : DECISION_POLL_INTERVAL_MS_DEFAULT;
181
+ }
182
+
183
+ /**
184
+ * The decision bead read interval while paused: APRA_FLEET_DECISION_READ_POLL_MS
185
+ * when it is a positive integer, else the default (5 minutes).
186
+ */
187
+ export function decisionReadPollIntervalMs(env = process.env) {
188
+ const raw = env && env.APRA_FLEET_DECISION_READ_POLL_MS;
189
+ const n = Number(raw);
190
+ return raw !== undefined && raw !== '' && Number.isInteger(n) && n > 0 ? n : DECISION_READ_POLL_INTERVAL_MS_DEFAULT;
191
+ }
192
+
193
+ /**
194
+ * The answer text from a decision bead's comments: the last comment written
195
+ * by `bd human respond` ("Response: <text>"), else the last comment, else ''.
196
+ * @param {Array<{ text?: string }>} comments
197
+ * @returns {string}
198
+ */
199
+ export function answerFromComments(comments) {
200
+ const list = Array.isArray(comments) ? comments.filter((c) => c && typeof c.text === 'string') : [];
201
+ for (let i = list.length - 1; i >= 0; i--) {
202
+ const m = list[i].text.match(/^Response:\s*([\s\S]*)$/);
203
+ if (m) return m[1].trim();
204
+ }
205
+ return list.length > 0 ? list[list.length - 1].text.trim() : '';
206
+ }
207
+
208
+ /**
209
+ * The note appended to the work bead once its decision is answered.
210
+ * @param {object} decision a pendingDecisions record
211
+ * @param {string} answer
212
+ * @param {string} via 'bd human respond' or 'recordDecisionAnswer'
213
+ * @returns {string}
214
+ */
215
+ export function formatDecisionAnswerNote(decision, answer, via) {
216
+ return [
217
+ `[fleet-sprint] OPERATOR DECISION on ${decision.beadId}` +
218
+ (decision.decisionBeadId ? ` (decision bead ${decision.decisionBeadId}, via ${via})` : ` (via ${via})`),
219
+ '',
220
+ 'Answer:',
221
+ answer || '(closed without a response text)',
222
+ '',
223
+ 'Question was:',
224
+ decision.question,
225
+ '',
226
+ 'Options were:',
227
+ ...decision.options.map((o) => `(${o.id}) ${o.text}`),
228
+ '',
229
+ `Recommendation was: ${decision.recommendation}`,
230
+ '',
231
+ 'Follow this answer when working the bead.',
232
+ ].join('\n');
233
+ }
234
+
235
+ /** "5 minutes", "90 seconds": a poll cadence as the operator reads it. */
236
+ export function formatInterval(ms) {
237
+ if (ms >= 60_000 && ms % 60_000 === 0) return `${ms / 60_000} minute${ms === 60_000 ? '' : 's'}`;
238
+ const sec = Math.max(1, Math.round(ms / 1000));
239
+ return `${sec} second${sec === 1 ? '' : 's'}`;
240
+ }
241
+
242
+ function parseJson(raw) {
243
+ if (raw && typeof raw === 'object') return raw;
244
+ const text = String(raw ?? '').trim();
245
+ if (!text) return null;
246
+ const start = text.search(/[[{]/);
247
+ return JSON.parse(start > 0 ? text.slice(start) : text);
248
+ }
249
+
250
+ /**
251
+ * Builds the decision wait for one run.
252
+ *
253
+ * @param {object} deps
254
+ * @param {object} deps.sprintState
255
+ * @param {(reason: string, opts?: object) => (void|Promise<void>)} deps.requestPause
256
+ * @param {(reason: string) => Promise<void>} deps.requestResume
257
+ * @param {Function} deps.command the workflow command() seam (must honour
258
+ * opts.pauseExempt for the read made while paused)
259
+ * @param {string} deps.member the member whose beads clone the engine reads and
260
+ * writes: the runner passes its backlog member, which no sprint reserves
261
+ * @param {(member: string) => Promise<any>} [deps.pullBeads] pull that clone before a poll read
262
+ * @param {(member: string) => Promise<any>} [deps.pushBeads] push it after applying answers
263
+ * @param {(namespace: string, data: object) => void} [deps.publishState]
264
+ * @param {(msg: string) => void} [deps.log]
265
+ * @param {number} [deps.pollIntervalMs] the in-process answer queue check interval
266
+ * @param {number} [deps.readPollIntervalMs] the pause-exempt decision bead read interval
267
+ * @param {() => number} [deps.now]
268
+ * @param {() => (AbortSignal|undefined)} [deps.stopSignal] the engine's run
269
+ * stop signal (context.stopSignal); without it a stop is seen only through
270
+ * the read blocked at the pause gate
271
+ * @returns {{
272
+ * pending: () => object[],
273
+ * hasPending: () => boolean,
274
+ * awaitAnswer: (opts: { where: string, cycle?: number }) => Promise<object[]>,
275
+ * recordDecisionAnswer: (decisionId: string, answer: string) => Promise<object>,
276
+ * }}
277
+ */
278
+ export function createDecisionWait({
279
+ sprintState,
280
+ requestPause,
281
+ requestResume,
282
+ command,
283
+ member,
284
+ pullBeads = async () => {},
285
+ pushBeads = async () => {},
286
+ publishState = () => {},
287
+ log = () => {},
288
+ pollIntervalMs = decisionPollIntervalMs(),
289
+ readPollIntervalMs = decisionReadPollIntervalMs(),
290
+ now = () => Date.now(),
291
+ stopSignal = () => undefined,
292
+ }) {
293
+ let waiting = false;
294
+ let wake = null;
295
+ const queued = new Map(); // decisionId -> { answer, recordedAt }
296
+ const answerErrors = new Map(); // decisionId -> last apply error message
297
+
298
+ const pendingMap = () => (sprintState.pendingDecisions instanceof Map ? sprintState.pendingDecisions : new Map());
299
+ const setAside = () => (sprintState.doctorBlockedIds instanceof Map ? sprintState.doctorBlockedIds : new Map());
300
+ // Pending decisions whose bead is still set aside for them.
301
+ const settingAside = () => [...pendingMap().values()].filter((d) => {
302
+ const e = setAside().get(d.beadId);
303
+ return e && e.decisionId === d.decisionId;
304
+ });
305
+ // A decision only holds the run while its bead is still set aside for it
306
+ // AND it has a decision bead. One whose decision bead could not be filed
307
+ // has no answer path (polling reads decision beads; bd human respond and
308
+ // recordDecisionAnswer both respond on one), so waiting on it could never
309
+ // end: it does not hold the run, and a stall on it throws
310
+ // StalledSprintError naming it with its full question, as before.
311
+ const holding = () => settingAside().filter((d) => d.decisionBeadId);
312
+
313
+ const publish = (state) => {
314
+ const pending = [...pendingMap().values()].map((d) => ({
315
+ decisionId: d.decisionId, beadId: d.beadId, decisionBeadId: d.decisionBeadId,
316
+ question: d.question, options: d.options, recommendation: d.recommendation,
317
+ raisedBy: d.raisedBy, cycle: d.cycle, round: d.round, raisedAt: d.raisedAt || null,
318
+ notification: d.notification || {},
319
+ answerRecorded: queued.has(d.decisionId),
320
+ }));
321
+ try {
322
+ publishState(DECISIONS_STATE_NAMESPACE, {
323
+ state, pending,
324
+ waitingSince: sprintState.decisionWait ? sprintState.decisionWait.since : null,
325
+ setAside: collectSetAsideEntries(sprintState),
326
+ answerErrors: [...answerErrors].map(([decisionId, error]) => ({ decisionId, error })),
327
+ });
328
+ } catch (err) {
329
+ log(`decision wait: publishing state failed (non-fatal): ${err.message}`);
330
+ }
331
+ };
332
+
333
+ // Applies one answer: note on the work bead, release of its set-aside,
334
+ // bookkeeping. `respond` first runs `bd human respond` (programmatic path).
335
+ const applyAnswer = async (decision, answer, { via, respond }) => {
336
+ if (respond) {
337
+ if (!decision.decisionBeadId) throw new Error(`decision ${decision.decisionId} has no decision bead to respond on`);
338
+ const file = await stageCommandBodyMemberSide({
339
+ command, member, content: answer, label: `Stage operator answer for ${decision.decisionBeadId}`,
340
+ });
341
+ try {
342
+ await command(
343
+ `bd human respond ${decision.decisionBeadId} --file "${file}"`,
344
+ { member_name: member, silent: true, label: `Record operator answer on ${decision.decisionBeadId}` },
345
+ );
346
+ } finally {
347
+ await removeStagedBody({ command, member, file, log });
348
+ }
349
+ }
350
+ let noteFile = null;
351
+ try {
352
+ noteFile = await stageCommandBodyMemberSide({
353
+ command, member, content: formatDecisionAnswerNote(decision, answer, via),
354
+ label: `Stage decision answer note for ${decision.beadId}`,
355
+ });
356
+ await command(
357
+ `bd note ${decision.beadId} --file "${noteFile}"`,
358
+ { member_name: member, silent: true, label: `Append operator decision to ${decision.beadId} notes` },
359
+ );
360
+ } catch (err) {
361
+ if (err && err.name === 'CancelledError') throw err;
362
+ log(`decision ${decision.decisionId}: appending the answer to '${decision.beadId}' notes FAILED (non-fatal): ${err.message}`);
363
+ }
364
+ await removeStagedBody({ command, member, file: noteFile, log });
365
+ const released = [];
366
+ for (const [id, e] of [...setAside()]) {
367
+ if (e && e.decisionId === decision.decisionId) {
368
+ setAside().delete(id);
369
+ released.push(id);
370
+ }
371
+ }
372
+ pendingMap().delete(decision.decisionId);
373
+ sprintState.answeredDecisions = sprintState.answeredDecisions instanceof Map ? sprintState.answeredDecisions : new Map();
374
+ const record = { ...decision, answer, via, answeredAt: new Date(now()).toISOString(), released };
375
+ sprintState.answeredDecisions.set(decision.decisionId, record);
376
+ log(
377
+ `Decision ${decision.decisionId} answered via ${via}: released [${released.join(', ')}] for dispatch; ` +
378
+ `the answer is in ${decision.beadId}'s notes. Answer: ${answer || '(none)'}`,
379
+ );
380
+ return record;
381
+ };
382
+
383
+ // The ids one poll reads: each holding decision's decision bead (a
384
+ // decision without one never holds the run, see holding()).
385
+ const pollIds = (decisions) => [...new Set(decisions.map((d) => d.decisionBeadId).filter(Boolean))];
386
+
387
+ const readBeads = async (ids, label, extraOpts = {}) => {
388
+ if (ids.length === 0) return [];
389
+ const shown = parseJson(await command(
390
+ `bd show ${ids.join(' ')} --json`,
391
+ { member_name: member, silent: true, label, ...extraOpts },
392
+ ));
393
+ return Array.isArray(shown) ? shown : (shown ? [shown] : []);
394
+ };
395
+
396
+ // Which of `decisions` have a decision bead that `shown` reports closed
397
+ // (answered), with the answer text from its comments.
398
+ const closedAnswers = async (decisions, shown) => {
399
+ const closed = new Set((shown || []).filter((b) => b && b.status === 'closed').map((b) => String(b.id)));
400
+ const out = [];
401
+ for (const d of decisions) {
402
+ if (!d.decisionBeadId || !closed.has(d.decisionBeadId)) continue;
403
+ let answer = '';
404
+ try {
405
+ const comments = parseJson(await command(
406
+ `bd comments ${d.decisionBeadId} --json`,
407
+ { member_name: member, silent: true, label: `Read the answer on ${d.decisionBeadId}` },
408
+ ));
409
+ answer = answerFromComments(comments);
410
+ } catch (err) {
411
+ if (err && err.name === 'CancelledError') throw err;
412
+ log(`decision ${d.decisionId}: reading the response on ${d.decisionBeadId} failed (${err.message}); treating it as answered without text.`);
413
+ }
414
+ out.push({ decision: d, answer });
415
+ }
416
+ return out;
417
+ };
418
+
419
+ // Applies every queued answer (bd human respond + note + set-aside
420
+ // release). An apply error is logged and published, the answer dropped and
421
+ // its decision left pending (so it can be answered again, and a failing
422
+ // answer can never spin the wait); a stop propagates.
423
+ const drainQueued = async () => {
424
+ const results = [];
425
+ let failed = false;
426
+ for (const [decisionId, q] of [...queued]) {
427
+ queued.delete(decisionId);
428
+ const decision = pendingMap().get(decisionId);
429
+ if (!decision) continue;
430
+ try {
431
+ const rec = await applyAnswer(decision, q.answer, { via: 'recordDecisionAnswer', respond: true });
432
+ answerErrors.delete(decisionId);
433
+ results.push(rec);
434
+ } catch (err) {
435
+ if (err && err.name === 'CancelledError') throw err;
436
+ const msg = err && err.message ? err.message : String(err);
437
+ answerErrors.set(decisionId, msg);
438
+ failed = true;
439
+ log(`decision ${decisionId}: applying the recorded answer FAILED (${msg}); the decision stays pending and can be answered again.`);
440
+ }
441
+ }
442
+ if (failed) publish(waiting ? PAUSED_AWAITING_DECISION : 'running');
443
+ return results;
444
+ };
445
+
446
+ let api = null;
447
+
448
+ const signalOf = () => {
449
+ try { return stopSignal() || null; } catch { return null; }
450
+ };
451
+ const stopError = (signal) => (signal.reason instanceof Error
452
+ ? signal.reason
453
+ : new CancelledError(`[Workflow Error] ${signal.reason ? String(signal.reason) : 'run stopped'}`));
454
+ const throwIfStopped = () => {
455
+ const signal = signalOf();
456
+ if (signal && signal.aborted) throw stopError(signal);
457
+ };
458
+ // Settles when `promise` does, or rejects at once on a stop.
459
+ const untilStopped = (promise, cleanup = () => {}) => {
460
+ const signal = signalOf();
461
+ let onAbort = null;
462
+ return new Promise((resolve, reject) => {
463
+ if (signal) {
464
+ onAbort = () => reject(stopError(signal));
465
+ if (signal.aborted) { onAbort(); return; }
466
+ signal.addEventListener('abort', onAbort, { once: true });
467
+ }
468
+ promise.then(resolve, reject);
469
+ }).finally(() => {
470
+ if (signal && onAbort) signal.removeEventListener('abort', onAbort);
471
+ cleanup();
472
+ });
473
+ };
474
+
475
+ // Parks the run ONCE and holds it parked -- no member release, no resume
476
+ // -- until it is released. The one gated read is issued while the run is
477
+ // paused, so it blocks at the engine's pause gate and only runs on
478
+ // release. Two timers run meanwhile:
479
+ // - every pollIntervalMs (and every recordDecisionAnswer wake): check
480
+ // the in-process answer queue; no command;
481
+ // - every readPollIntervalMs: ONE pause-exempt `bd show` of the holding
482
+ // decision beads on the backlog member (command opts.pauseExempt:
483
+ // it skips the pause gate and is not an in-flight activity). No pull,
484
+ // no resync, no release, no pause/resume per read. A read failure is
485
+ // logged once per distinct error and the wait keeps going.
486
+ // A queued answer, or a decision bead the read reports closed (answered
487
+ // out of process with `bd human respond`), resumes the run ONCE. A failed
488
+ // resume (the pre-resume hook threw) keeps the run parked and is retried
489
+ // on the next interval, logged once per distinct error. Any other release
490
+ // (an operator Resume) also ends the hold. Returns the gated read and
491
+ // whether this wait did the resume; rejects with a CancelledError on a
492
+ // stop.
493
+ const holdUntilReleased = async (reason, ids) => {
494
+ throwIfStopped();
495
+ // Captured now, inside the run: the timers below may fire outside the
496
+ // run's async context, where stopSignal() can no longer find it.
497
+ const runSignal = signalOf();
498
+ await requestPause(reason, { source: DECISION_PAUSE_SOURCE });
499
+ let selfResume = false;
500
+ let resuming = false;
501
+ let lastResumeError = null;
502
+ let lastReadError = null;
503
+ let answeredOutOfProcess = false;
504
+ let reading = false;
505
+ let released = false;
506
+ let timer = null;
507
+ let readTimer = null;
508
+ const stopped = () => !!(runSignal && runSignal.aborted);
509
+ const tryResume = () => {
510
+ if (resuming || selfResume || (queued.size === 0 && !answeredOutOfProcess)) return;
511
+ if (stopped()) return;
512
+ resuming = true;
513
+ selfResume = true;
514
+ const why = queued.size > 0
515
+ ? 'an operator answer to a pending decision was recorded'
516
+ : 'an operator answered a pending decision with bd human respond';
517
+ Promise.resolve()
518
+ .then(() => requestResume(why))
519
+ .then(() => { resuming = false; }, (err) => {
520
+ resuming = false;
521
+ selfResume = false;
522
+ const msg = err && err.message ? err.message : String(err);
523
+ if (msg !== lastResumeError) {
524
+ lastResumeError = msg;
525
+ log(`decision wait: resume failed, staying paused and retrying every ${Math.round(pollIntervalMs / 1000)}s while an answer is waiting: ${msg}`);
526
+ }
527
+ });
528
+ };
529
+ // One pause-exempt read of the holding decision beads (never two at
530
+ // once, none after an answer was seen or the run was released/stopped).
531
+ const pollRead = async () => {
532
+ if (reading || answeredOutOfProcess || released || stopped()) return;
533
+ reading = true;
534
+ try {
535
+ // The run's stop signal is passed explicitly: this read is
536
+ // issued from a timer, outside any guarantee that the run's
537
+ // async context (where command() finds it) is still current.
538
+ const shown = await readBeads(
539
+ ids, 'Check pending decision beads for an answer (read while paused)',
540
+ { pauseExempt: true, ...(runSignal ? { signal: runSignal } : {}) },
541
+ );
542
+ if (released || stopped()) return;
543
+ const closedIds = shown.filter((b) => b && b.status === 'closed').map((b) => String(b.id)).filter((id) => ids.includes(id));
544
+ if (closedIds.length > 0) {
545
+ answeredOutOfProcess = true;
546
+ log(`Decision bead(s) ${closedIds.join(', ')} answered with bd human respond; resuming the sprint to apply the answer.`);
547
+ tryResume();
548
+ }
549
+ } catch (err) {
550
+ if (err && err.name === 'CancelledError') return; // a stop: untilStopped reports it
551
+ const msg = err && err.message ? err.message : String(err);
552
+ if (msg !== lastReadError) {
553
+ lastReadError = msg;
554
+ log(`decision wait: reading the decision bead(s) for an answer failed (non-fatal; retrying every ${Math.round(readPollIntervalMs / 1000)}s): ${msg}`);
555
+ }
556
+ } finally {
557
+ reading = false;
558
+ }
559
+ };
560
+ const tick = () => {
561
+ tryResume();
562
+ timer = setTimeout(tick, pollIntervalMs);
563
+ };
564
+ const readTick = () => {
565
+ pollRead().then(() => tryResume(), () => {});
566
+ readTimer = setTimeout(readTick, readPollIntervalMs);
567
+ };
568
+ timer = setTimeout(tick, pollIntervalMs);
569
+ if (ids.length > 0) readTimer = setTimeout(readTick, readPollIntervalMs);
570
+ wake = tryResume;
571
+ const read = readBeads(ids, 'Read pending decisions once the run is released (waits at the pause gate)');
572
+ read.catch(() => {}); // a stop rejects it; untilStopped reports that
573
+ tryResume();
574
+ const shown = await untilStopped(read, () => {
575
+ released = true;
576
+ clearTimeout(timer);
577
+ clearTimeout(readTimer);
578
+ wake = null;
579
+ });
580
+ return { shown, resumedBySelf: selfResume };
581
+ };
582
+
583
+ // One poll interval while the run is NOT parked (after a release with no
584
+ // answer): ends early on a recordDecisionAnswer wake, rejects on a stop.
585
+ const idleInterval = () => {
586
+ let timer = null;
587
+ const elapsed = new Promise((resolve) => {
588
+ timer = setTimeout(resolve, pollIntervalMs);
589
+ wake = resolve;
590
+ if (queued.size > 0) resolve();
591
+ });
592
+ return untilStopped(elapsed, () => { clearTimeout(timer); wake = null; });
593
+ };
594
+
595
+ api = {
596
+ /** Re-publishes the decisions namespace (e.g. after a new decision or a notification outcome). */
597
+ publish() {
598
+ publish(waiting ? PAUSED_AWAITING_DECISION : 'running');
599
+ },
600
+
601
+ pending() {
602
+ return [...pendingMap().values()];
603
+ },
604
+
605
+ hasPending() {
606
+ return holding().length > 0;
607
+ },
608
+
609
+ /** Whether a recorded answer is waiting to be applied. */
610
+ hasQueuedAnswers() {
611
+ return queued.size > 0;
612
+ },
613
+
614
+ /**
615
+ * Applies the answers recorded while the run was running, and pushes
616
+ * once when any applied. The runner calls this INSIDE an open beads
617
+ * sync bracket (after its pull); this is the only place a mid-run
618
+ * answer's bd writes and push happen. Returns the applied records.
619
+ */
620
+ async applyRecordedAnswers() {
621
+ if (waiting || queued.size === 0) return [];
622
+ const applied = await drainQueued();
623
+ if (applied.length > 0) {
624
+ await pushBeads(member);
625
+ publish('running');
626
+ }
627
+ return applied;
628
+ },
629
+
630
+ /**
631
+ * Pending decisions still setting their bead aside whose decision
632
+ * bead could NOT be filed: nothing can answer them in this run.
633
+ */
634
+ unfiled() {
635
+ return settingAside().filter((d) => !d.decisionBeadId);
636
+ },
637
+
638
+ /**
639
+ * Pauses until at least one pending decision is answered; returns the
640
+ * applied answers. Throws whatever a resume or poll throws (an
641
+ * operator stop's CancelledError included).
642
+ */
643
+ async awaitAnswer({ where, cycle = null } = {}) {
644
+ const decisions = holding();
645
+ if (decisions.length === 0) return [];
646
+ waiting = true;
647
+ sprintState.decisionWait = {
648
+ state: PAUSED_AWAITING_DECISION, since: new Date(now()).toISOString(), where, cycle,
649
+ decisionIds: decisions.map((d) => d.decisionId),
650
+ };
651
+ const names = decisions.map((d) => `${d.beadId} (${d.decisionBeadId || 'no decision bead'})`).join(', ');
652
+ log(
653
+ `Sprint ${PAUSED_AWAITING_DECISION} (${where}): nothing else can run until an operator answers ` +
654
+ `${decisions.length} pending decision(s): ${names}. Members stay reserved and idle. Answer from the ` +
655
+ `sprint dashboard's decision banner (resumes at once), or with ` +
656
+ `bd human respond <decision bead> "<answer>" (picked up within ${formatInterval(readPollIntervalMs)}, no Resume needed).`,
657
+ );
658
+ publish(PAUSED_AWAITING_DECISION);
659
+ liveWaits.add(api);
660
+ let loggedRelease = false;
661
+ try {
662
+ for (;;) {
663
+ if (holding().length === 0 && queued.size === 0) return [];
664
+ const { shown, resumedBySelf } = await holdUntilReleased(`awaiting operator decision(s): ${names}`, pollIds(holding()));
665
+ const answered = await drainQueued();
666
+ let polled = await closedAnswers(holding(), shown);
667
+ if (answered.length === 0 && polled.length === 0 && holding().length > 0) {
668
+ // Released with nothing answered in the local clone:
669
+ // pull, then read once more (an operator may have
670
+ // answered elsewhere with bd human respond).
671
+ await pullBeads(member);
672
+ polled = await closedAnswers(holding(), await readBeads(pollIds(holding()), 'Read pending decisions after a beads pull'));
673
+ }
674
+ for (const { decision, answer } of polled) {
675
+ answered.push(await applyAnswer(decision, answer, { via: 'bd human respond', respond: false }));
676
+ }
677
+ if (answered.length > 0) {
678
+ await pushBeads(member);
679
+ log(`Sprint resumed (${where}): ${answered.length} decision(s) answered; the released bead(s) return to the ready pool.`);
680
+ return answered;
681
+ }
682
+ if (!loggedRelease) {
683
+ loggedRelease = true;
684
+ log(
685
+ `Sprint released from ${PAUSED_AWAITING_DECISION} (${where}) ${resumedBySelf ? 'after a failed answer' : 'by a resume'} ` +
686
+ `with no decision answered yet; parking it again after ${Math.round(pollIntervalMs / 1000)}s.`,
687
+ );
688
+ }
689
+ await idleInterval();
690
+ }
691
+ } finally {
692
+ liveWaits.delete(api);
693
+ waiting = false;
694
+ wake = null;
695
+ sprintState.decisionWait = null;
696
+ publish('running');
697
+ }
698
+ },
699
+
700
+ /**
701
+ * Programmatic answer: same bead state as `bd human respond`.
702
+ * @param {string} decisionId
703
+ * @param {string} answer
704
+ */
705
+ async recordDecisionAnswer(decisionId, answer) {
706
+ const decision = pendingMap().get(decisionId);
707
+ if (!decision) throw new Error(`recordDecisionAnswer: no pending decision ${JSON.stringify(decisionId)}`);
708
+ if (!decision.decisionBeadId) {
709
+ throw new Error(
710
+ `recordDecisionAnswer: decision ${decisionId} on '${decision.beadId}' has no decision bead (filing it failed), ` +
711
+ 'so there is no bd human respond path to record the answer on; the run cannot be resumed with it. ' +
712
+ `Record the decision in '${decision.beadId}' notes and re-run the sprint.`,
713
+ );
714
+ }
715
+ const text = String(answer ?? '').trim();
716
+ if (!text) throw new Error('recordDecisionAnswer: the answer is empty');
717
+ if (queued.has(decisionId)) {
718
+ throw new Error(`recordDecisionAnswer: an answer for decision ${JSON.stringify(decisionId)} is already recorded and awaiting apply`);
719
+ }
720
+ queued.set(decisionId, { answer: text, recordedAt: new Date(now()).toISOString() });
721
+ answerErrors.delete(decisionId);
722
+ log(`Decision ${decisionId}: answer recorded; it is applied ${waiting ? 'now (the paused run is woken)' : 'in the next beads sync bracket'}.`);
723
+ publish(waiting ? PAUSED_AWAITING_DECISION : 'running');
724
+ if (wake) wake();
725
+ return { status: 'recorded', decisionId, released: [] };
726
+ },
727
+ };
728
+ for (const w of [...allWaits]) if (w.pending().length === 0) allWaits.delete(w);
729
+ allWaits.add(api);
730
+ return api;
731
+ }