@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,246 @@
1
+ // =============================================================================
2
+ // Supervisor beads identity -- which .beads THIS supervisor process runs
3
+ // against, resolved once at startup and displayed everywhere it matters.
4
+ // =============================================================================
5
+ //
6
+ // The supervisor runs `bd` itself in exactly three read-only places
7
+ // (backlog.mjs's full-tracker fetch, scope-overlap.mjs's two list calls),
8
+ // always in its own process cwd, so bd's walk-up discovery silently decides
9
+ // which database those reads hit. Every sprint child it spawns (spawner.mjs)
10
+ // inherits that cwd too. Nothing used to show which .beads that was, and a
11
+ // supervisor started from the wrong folder would happily serve an empty
12
+ // backlog or dispatch sprints against an unrelated tracker.
13
+ //
14
+ // This module is the supervisor half of the shared contract in
15
+ // ../../fleet-sprint/beads-identity.mjs (the pure parse/compare/format
16
+ // helpers both sides use):
17
+ // - discoverBeadsDir(): the same walk-up bd performs, done here so serve
18
+ // can WARN loudly at startup when no .beads is reachable (the server
19
+ // still starts, with the identity "unknown" -- see
20
+ // createBeadsIdentityState), and so the sprint children get the project
21
+ // root (not a subfolder) as cwd.
22
+ // - probeBeadsIdentity(): the three read-only probes (`bd where --json`,
23
+ // `bd config get sync.remote --json`, `git remote get-url origin`) run in
24
+ // that cwd and parsed into one { beadsDir, prefix, syncRemote,
25
+ // repoRemote } record. beadsDir comes from bd's OWN answer (bd is
26
+ // git-worktree aware and may resolve a worktree's .beads to the main
27
+ // checkout's database), which is why discovery alone is not the identity.
28
+ // - createBeadsIdentityState(): the resolved record, held for the health
29
+ // route / dashboard header / spawner (`--expect-beads`), re-probeable on
30
+ // demand (GET /api/health?refresh=1).
31
+ //
32
+ // Deliberately NOT here: setting BEADS_DIR, or any persisted config file.
33
+ // The operator's cwd (or an explicit `--beads-dir`) is the one input.
34
+ // =============================================================================
35
+
36
+ import fs from 'node:fs';
37
+ import path from 'node:path';
38
+ import { execFile as nodeExecFile } from 'node:child_process';
39
+ import { promisify } from 'node:util';
40
+ import { execBdAsync } from './lib/exec-bd.mjs';
41
+ import { parseBeadsIdentity } from '../../fleet-sprint/beads-identity.mjs';
42
+
43
+ const nodeExecFileAsync = promisify(nodeExecFile);
44
+
45
+ /** Directory name bd discovers by walking up from its cwd. */
46
+ export const BEADS_DIR_NAME = '.beads';
47
+
48
+ /**
49
+ * Walks up from `cwd` (inclusive) to the filesystem root looking for the
50
+ * first directory that contains a `.beads` entry -- the same discovery bd
51
+ * performs. Returns `{ beadsDir, repoRoot }` (repoRoot = the directory that
52
+ * holds `.beads`) or `null` when no ancestor has one.
53
+ *
54
+ * `fs` is injectable so a test can drive an in-memory layout on any host
55
+ * without touching real disk; only `existsSync` (and optionally `statSync`)
56
+ * is used.
57
+ * @param {{ cwd?: string, fs?: { existsSync: (p: string) => boolean, statSync?: (p: string) => { isDirectory(): boolean } } }} [opts]
58
+ * @returns {{ beadsDir: string, repoRoot: string }|null}
59
+ */
60
+ export function discoverBeadsDir(opts = {}) {
61
+ const fsImpl = opts.fs ?? fs;
62
+ let dir = path.resolve(opts.cwd ?? process.cwd());
63
+ for (;;) {
64
+ const candidate = path.join(dir, BEADS_DIR_NAME);
65
+ let found = false;
66
+ try {
67
+ found = fsImpl.existsSync(candidate)
68
+ && (typeof fsImpl.statSync !== 'function' || fsImpl.statSync(candidate).isDirectory());
69
+ } catch {
70
+ found = false;
71
+ }
72
+ if (found) return { beadsDir: candidate, repoRoot: dir };
73
+ const parent = path.dirname(dir);
74
+ if (parent === dir) return null;
75
+ dir = parent;
76
+ }
77
+ }
78
+
79
+ /**
80
+ * Resolves an operator-supplied `--beads-dir` value to the directory the
81
+ * supervisor should chdir into before discovery: the value itself, or its
82
+ * parent when it names the `.beads` directory directly. Throws when the
83
+ * path does not exist or is not a directory. Pure apart from the injectable
84
+ * fs, so serve's arg handling is unit-testable.
85
+ * @param {string} value
86
+ * @param {{ fs?: { existsSync: (p: string) => boolean, statSync: (p: string) => { isDirectory(): boolean } } }} [opts]
87
+ * @returns {string} absolute directory path
88
+ */
89
+ export function resolveBeadsDirArg(value, opts = {}) {
90
+ const fsImpl = opts.fs ?? fs;
91
+ if (typeof value !== 'string' || !value.trim()) {
92
+ throw new Error('--beads-dir requires a path');
93
+ }
94
+ const resolved = path.resolve(value.trim());
95
+ let isDir = false;
96
+ try {
97
+ isDir = fsImpl.existsSync(resolved) && fsImpl.statSync(resolved).isDirectory();
98
+ } catch {
99
+ isDir = false;
100
+ }
101
+ if (!isDir) {
102
+ throw new Error(`--beads-dir '${resolved}' does not exist or is not a directory`);
103
+ }
104
+ return path.basename(resolved) === BEADS_DIR_NAME ? path.dirname(resolved) : resolved;
105
+ }
106
+
107
+ function textOf(v) {
108
+ if (v == null) return '';
109
+ if (Buffer.isBuffer(v)) return v.toString('utf-8');
110
+ return String(v);
111
+ }
112
+
113
+ /**
114
+ * Runs the three identity probes in `cwd` and parses them into one record
115
+ * (see ../../fleet-sprint/beads-identity.mjs's parseBeadsIdentity()).
116
+ *
117
+ * - `bd where --json` failing (no reachable database, bd not installed)
118
+ * throws with a message that names the cwd -- there is no identity to
119
+ * report and the caller (serve) must not proceed.
120
+ * - an unset `sync.remote` is NOT an error (bd exits 0 with value ""):
121
+ * the field is simply ''. A failing `bd config get` is folded to '' too,
122
+ * since the where-probe above already proved the database is reachable.
123
+ * - `git remote get-url origin` failing (not a git repo, no origin) folds
124
+ * to '' for the same reason.
125
+ *
126
+ * `execBd`/`execGit` are injectable (same shapes as execBdAsync / the
127
+ * promisified execFile) so tests never need a real bd or git.
128
+ * @param {{
129
+ * cwd?: string,
130
+ * execBd?: (args: string[], options: object) => Promise<{ stdout: string|Buffer }>,
131
+ * execGit?: (file: string, args: string[], options: object) => Promise<{ stdout: string|Buffer }>,
132
+ * }} [opts]
133
+ * @returns {Promise<{ beadsDir: string, prefix: string, databasePath: string, syncRemote: string, repoRemote: string }>}
134
+ */
135
+ export async function probeBeadsIdentity(opts = {}) {
136
+ const cwd = path.resolve(opts.cwd ?? process.cwd());
137
+ const execBd = opts.execBd ?? execBdAsync;
138
+ const execGit = opts.execGit ?? nodeExecFileAsync;
139
+ const execOpts = { cwd, encoding: 'utf-8', windowsHide: true };
140
+
141
+ let where;
142
+ try {
143
+ where = textOf((await execBd(['where', '--json'], execOpts)).stdout);
144
+ } catch (err) {
145
+ const detail = textOf(err && (err.stderr || err.stdout)).trim() || (err && err.message) || String(err);
146
+ throw new Error(`'bd where --json' failed in '${cwd}': ${detail}`);
147
+ }
148
+
149
+ let syncRemote = '';
150
+ try {
151
+ syncRemote = textOf((await execBd(['config', 'get', 'sync.remote', '--json'], execOpts)).stdout);
152
+ } catch {
153
+ syncRemote = '';
154
+ }
155
+
156
+ let repoRemote = '';
157
+ try {
158
+ repoRemote = textOf((await execGit('git', ['remote', 'get-url', 'origin'], execOpts)).stdout);
159
+ } catch {
160
+ repoRemote = '';
161
+ }
162
+
163
+ const identity = parseBeadsIdentity({ where, syncRemote, repoRemote });
164
+ if (!identity.beadsDir) {
165
+ throw new Error(`'bd where --json' in '${cwd}' returned no .beads path: ${where.trim() || '(empty output)'}`);
166
+ }
167
+ return identity;
168
+ }
169
+
170
+ // The operator-facing warning texts for an UNKNOWN identity. Each one says
171
+ // what was found and what to do; the same string goes to the startup log
172
+ // (`[supervisor] WARNING: ...`), GET /api/health (`beadsWarning`) and the
173
+ // dashboard header. Generic on purpose: no product paths.
174
+ const FIX_TAIL = 'then GET /api/health?refresh=1.';
175
+
176
+ /** No `.beads` reachable by walking up from `cwd`. */
177
+ export function formatNoBeadsWarning(cwd) {
178
+ return `no beads database found walking up from ${cwd}. ` +
179
+ "Backlog and scope-overlap checks are disabled and sprints will verify against the backlog member's beads instead. " +
180
+ `To fix: restart fleet-se from inside the project folder, or pass --beads-dir <project-or-.beads-path>, ${FIX_TAIL}`;
181
+ }
182
+
183
+ /** A `.beads` was found under `repoRoot` but the identity probe failed. */
184
+ export function formatProbeFailedWarning(repoRoot, error) {
185
+ const detail = error && error.message ? error.message : String(error);
186
+ return `could not resolve the beads identity under ${repoRoot}: ${detail}. ` +
187
+ "Backlog and scope-overlap checks may fail and sprints will verify against the backlog member's beads instead. " +
188
+ `To fix: run 'bd where' in ${repoRoot} to see the error, ensure bd is on PATH and the project is initialised (bd init / sync.remote set), ${FIX_TAIL}`;
189
+ }
190
+
191
+ /**
192
+ * Holds the supervisor's resolved identity, or the warning explaining why
193
+ * it is unknown. `refresh()` re-runs the probes (GET /api/health?refresh=1)
194
+ * and REPLACES the held record only on success -- a transient probe failure
195
+ * leaves the last good identity in place and rethrows, so a reader never
196
+ * sees a half-updated record. When there is NO last good identity (startup
197
+ * found no .beads, or its probe failed) a successful refresh recovers it
198
+ * and clears the warning; a failed one refreshes the warning text so the
199
+ * health route and dashboard show the current reason.
200
+ * @param {{
201
+ * cwd?: string,
202
+ * probe?: (opts: { cwd: string }) => Promise<object>,
203
+ * initial?: object|null,
204
+ * warning?: string|null,
205
+ * }} [deps]
206
+ * @returns {{ get(): object|null, getWarning(): string|null, refresh(): Promise<object>, cwd: string }}
207
+ */
208
+ export function createBeadsIdentityState(deps = {}) {
209
+ const cwd = path.resolve(deps.cwd ?? process.cwd());
210
+ const probe = deps.probe ?? probeBeadsIdentity;
211
+ let current = deps.initial ?? null;
212
+ let warning = current ? null : (deps.warning ?? null);
213
+ return {
214
+ cwd,
215
+ get() { return current; },
216
+ getWarning() { return current ? null : warning; },
217
+ async refresh() {
218
+ let next;
219
+ try {
220
+ next = await probe({ cwd });
221
+ } catch (err) {
222
+ if (!current) warning = formatProbeFailedWarning(cwd, err);
223
+ throw err;
224
+ }
225
+ current = next;
226
+ warning = null;
227
+ return next;
228
+ },
229
+ };
230
+ }
231
+
232
+ /**
233
+ * The four display fields the health route, ledger entry and dashboard all
234
+ * carry (never `databasePath` -- a host-local detail).
235
+ * @param {object|null} id
236
+ * @returns {{ dir: string, prefix: string, syncRemote: string, repoRemote: string }|null}
237
+ */
238
+ export function toBeadsSummary(id) {
239
+ if (!id) return null;
240
+ return {
241
+ dir: id.beadsDir || '',
242
+ prefix: id.prefix || '',
243
+ syncRemote: id.syncRemote || '',
244
+ repoRemote: id.repoRemote || '',
245
+ };
246
+ }
@@ -0,0 +1,438 @@
1
+ // The supervisor's cached beads view.
2
+ //
3
+ // One in-memory copy of the RAW `bd list --all --limit 0 --json` rows for the
4
+ // supervisor's own .beads, kept current through the supervisor's backlog
5
+ // member (src/supervisor/backlog-member.mjs): every refresh first runs the
6
+ // engine's own D-pull (fleet-sprint/dolt-sync.mjs doltPullBefore()) on that
7
+ // member, whose remote-tip fingerprint turns an unchanged shared remote into a
8
+ // single `git ls-remote` -- no `bd dolt pull`, and no re-list either.
9
+ //
10
+ // Design decisions (already made upstream -- see the planning notes):
11
+ //
12
+ // * RAW rows only. Never a derived or claim-subtracted tree: claimed scope
13
+ // depends on the live ledger and watchdog classification at READ time.
14
+ // * One bulk list (bdListAllBeadsWithClosed, i.e. `bd list --all --limit 0
15
+ // --json`), never per-root subtree fetches.
16
+ // * The list runs IN-PROCESS with cwd = repoRoot, the same folder the
17
+ // backlog member's work folder is, so the pull and the list provably touch
18
+ // the same clone. A null/degraded backlog member records lastError with
19
+ // the reason and lists nothing (no silent list from an unpulled clone).
20
+ // * maxTransientRetries: 0 on the pull. runDoltStep() otherwise retries a
21
+ // lock/transient failure with backoff for minutes, and one busy lock would
22
+ // stall the single in-flight slot. A lock/busy round is SKIPPED instead
23
+ // (rows kept, lastSkip set, lastError untouched); the next refresh retries
24
+ // and the pull is idempotent.
25
+ // * No `settle`: the supervisor never runs conflict settlement.
26
+ // * ledger.setScopeFreshness() on EVERY successful check (a pull+re-list AND
27
+ // a confirmed unchanged tip) -- lastSyncedAt means "this clone is known
28
+ // current as of that moment". Never on a skip or failure.
29
+ // * Single in-flight: concurrent refresh() callers join one promise.
30
+ // * snapshot() never spawns or waits. refreshIfStale() starts a background
31
+ // refresh and returns immediately. freshForLaunch() is the only reader that
32
+ // waits, and it never returns rows it did not fetch in that very call.
33
+ //
34
+ // The supervisor performs no bead mutations of its own (only reads), so there
35
+ // is no invalidate-on-mutation seam here.
36
+
37
+ import { doltPullBefore as defaultDoltPullBefore, classifyDoltFailure } from '../../fleet-sprint/dolt-sync.mjs';
38
+ import { bdListAllBeadsWithClosed } from './scope-overlap.mjs';
39
+
40
+ /** refreshIfStale()'s default staleness bound. */
41
+ export const DEFAULT_BEADS_VIEW_MAX_AGE_MS = 15_000;
42
+
43
+ /** Per-step bound handed to doltPullBefore (forwarded to every member
44
+ * command as timeout_s): short, because a refresh holds the only slot. */
45
+ export const DEFAULT_BEADS_VIEW_PULL_TIMEOUT_S = 30;
46
+
47
+ /** freshForLaunch()'s default wall-clock bound (join + own check). */
48
+ export const DEFAULT_FRESH_FOR_LAUNCH_TIMEOUT_MS = 45_000;
49
+
50
+ /** A lock/busy failure named in error text the dolt classifier left 'unknown'. */
51
+ const LOCK_OR_BUSY_RE = /\block(?:ed|s)?\b|\bbusy\b/i;
52
+
53
+ /**
54
+ * Typed rejection of freshForLaunch(): the launch path answers 503 with
55
+ * `reason`.
56
+ */
57
+ export class BeadsViewUnavailableError extends Error {
58
+ /**
59
+ * @param {string} reason - human-readable cause
60
+ * @param {{ kind?: 'timeout'|'skip'|'error'|'stopped' }} [opts]
61
+ */
62
+ constructor(reason, opts = {}) {
63
+ super(`beads view unavailable: ${reason}`);
64
+ this.name = 'BeadsViewUnavailableError';
65
+ this.code = 'BEADS_VIEW_UNAVAILABLE';
66
+ this.reason = reason;
67
+ this.kind = opts.kind ?? 'error';
68
+ }
69
+ }
70
+
71
+ /**
72
+ * Normalize an executeFleetCommand() result into the `{ ok, output }` /
73
+ * `{ ok: false, error }` shape doltPullBefore's command() contract expects.
74
+ *
75
+ * The fleet server's execute_command does not flag a non-zero exit as an
76
+ * error, so `ok` is derived from the real exit code: structured `exitCode`
77
+ * (with clean stdout) when the server sent it, else the `Exit code: N` prefix
78
+ * of the display text. Without this a failed `bd dolt pull` would read as a
79
+ * success, and `bd config get sync.remote --json` would never parse (the
80
+ * prefix is not JSON), silently disabling the remote-tip fingerprint.
81
+ *
82
+ * @param {any} res
83
+ * @returns {{ ok: true, output: string } | { ok: false, error: string }}
84
+ */
85
+ export function normalizeFleetCommandResult(res) {
86
+ if (!res || typeof res !== 'object') return { ok: false, error: 'no result from execute_command' };
87
+ if (res.ok === false) return { ok: false, error: String(res.error ?? 'unknown error') };
88
+ if (typeof res.exitCode === 'number') {
89
+ const stdout = typeof res.stdout === 'string' ? res.stdout : '';
90
+ const stderr = typeof res.stderr === 'string' ? res.stderr : '';
91
+ if (res.exitCode !== 0) {
92
+ const body = [stderr, stdout].filter((s) => s && s.trim()).join('\n').trim();
93
+ return { ok: false, error: `Exit code ${res.exitCode}: ${body || '(no output)'}` };
94
+ }
95
+ return { ok: true, output: stdout };
96
+ }
97
+ const text = String(res.output ?? '');
98
+ const m = /^Exit code:\s*(-?\d+)\r?\n?/.exec(text);
99
+ if (m) {
100
+ const code = Number(m[1]);
101
+ const body = text.slice(m[0].length);
102
+ if (code !== 0) return { ok: false, error: `Exit code ${code}: ${body.trim() || '(no output)'}` };
103
+ return { ok: true, output: body };
104
+ }
105
+ // No recoverable exit code means the command never ran: every such
106
+ // execute_command reply is the tool's own refusal/failure text (`Member
107
+ // "<x>" not found.`, a credential refusal, `Failed to execute command on
108
+ // "<member>": ...`). Fail CLOSED -- reading it as success would let an
109
+ // unpulled clone be listed and reported fresh.
110
+ return { ok: false, error: text.trim() || 'execute_command returned no exit code and no output' };
111
+ }
112
+
113
+ /**
114
+ * Build the command() doltPullBefore expects -- `command(cmd, { member_name,
115
+ * silent, failSoft, label, timeout_s })` -> `{ ok, output }` / `{ ok: false,
116
+ * error }` -- over executeFleetCommand (fleet-members.mjs). `timeout_s` MUST
117
+ * be forwarded: executeFleetCommand's own default is 60s, which would cut off
118
+ * every real pull at 60s regardless of the step bound.
119
+ *
120
+ * @param {{ executeFleetCommand: Function, resolveConnection: Function, logger?: object }} deps
121
+ * @returns {(cmd: string, opts?: object) => Promise<{ ok: boolean, output?: string, error?: string }>}
122
+ */
123
+ export function createBeadsViewCommand(deps = {}) {
124
+ const { executeFleetCommand, resolveConnection, logger } = deps;
125
+ if (typeof executeFleetCommand !== 'function') throw new TypeError('createBeadsViewCommand requires an executeFleetCommand() collaborator');
126
+ if (typeof resolveConnection !== 'function') throw new TypeError('createBeadsViewCommand requires a resolveConnection() collaborator');
127
+ return async function beadsViewCommand(cmd, opts = {}) {
128
+ const req = { member: opts.member_name, command: cmd, resolveConnection };
129
+ if (opts.timeout_s !== undefined && opts.timeout_s !== null) req.timeoutSeconds = opts.timeout_s;
130
+ if (logger) req.logger = logger;
131
+ let res;
132
+ try {
133
+ res = await executeFleetCommand(req);
134
+ } catch (err) {
135
+ return { ok: false, error: err && err.message ? err.message : String(err) };
136
+ }
137
+ return normalizeFleetCommandResult(res);
138
+ };
139
+ }
140
+
141
+ function errorText(err) {
142
+ if (!err) return 'unknown error';
143
+ const parts = [];
144
+ if (typeof err.doltOutput === 'string' && err.doltOutput) parts.push(err.doltOutput);
145
+ if (typeof err.stderr === 'string' && err.stderr) parts.push(err.stderr);
146
+ parts.push(err.message ? err.message : String(err));
147
+ return parts.join('\n');
148
+ }
149
+
150
+ /**
151
+ * Is `err` a lock/busy/transient failure (skip the round) rather than a real
152
+ * failure (record lastError)? The dolt classifier decides first; only when it
153
+ * cannot place the text at all does a lock/busy mention count.
154
+ */
155
+ export function isBusyFailure(err) {
156
+ const text = errorText(err);
157
+ const kind = classifyDoltFailure(text);
158
+ if (kind === 'transient') return true;
159
+ return kind === 'unknown' && LOCK_OR_BUSY_RE.test(text);
160
+ }
161
+
162
+ /**
163
+ * Create the cached beads view.
164
+ *
165
+ * @param {{
166
+ * backlogMember: { get: () => { member: { name: string }|null, status: string, reason?: string|null } },
167
+ * ledger?: { setScopeFreshness: (timestamp?: string) => Promise<unknown> } | null,
168
+ * command: Function,
169
+ * repoRoot?: string|null,
170
+ * listAllBeads?: (opts: { cwd?: string }) => Promise<object[]>,
171
+ * doltPullBefore?: Function,
172
+ * now?: () => number,
173
+ * logger?: { log?: Function, warn?: Function, error?: Function },
174
+ * pullTimeoutS?: number,
175
+ * setTimeout?: Function,
176
+ * clearTimeout?: Function,
177
+ * }} deps
178
+ */
179
+ export function createBeadsView(deps = {}) {
180
+ const { backlogMember, command } = deps;
181
+ if (!backlogMember || typeof backlogMember.get !== 'function') {
182
+ throw new TypeError('createBeadsView requires a backlogMember handle with get()');
183
+ }
184
+ if (typeof command !== 'function') throw new TypeError('createBeadsView requires a command() collaborator');
185
+ const ledger = deps.ledger ?? null;
186
+ const repoRoot = deps.repoRoot ?? null;
187
+ const listAllBeads = deps.listAllBeads ?? bdListAllBeadsWithClosed;
188
+ const pull = deps.doltPullBefore ?? defaultDoltPullBefore;
189
+ const now = deps.now ?? Date.now;
190
+ const logger = deps.logger ?? console;
191
+ const log = (...a) => (logger.log ?? (() => {}))(...a);
192
+ const warn = (...a) => (logger.warn ?? logger.log ?? (() => {}))(...a);
193
+ const logError = (...a) => (logger.error ?? logger.log ?? (() => {}))(...a);
194
+ const pullTimeoutS = Number.isFinite(deps.pullTimeoutS) && deps.pullTimeoutS > 0 ? deps.pullTimeoutS : DEFAULT_BEADS_VIEW_PULL_TIMEOUT_S;
195
+ const setTimer = deps.setTimeout ?? setTimeout;
196
+ const clearTimer = deps.clearTimeout ?? clearTimeout;
197
+
198
+ let rows = null;
199
+ let asOf = null;
200
+ let lastCheckedAt = null;
201
+ let lastError = null;
202
+ let lastSkip = null;
203
+ let inFlight = null;
204
+ let stopped = false;
205
+ // True from the start of a pull until a check completes with current rows
206
+ // (see runCheck): a skipped/failed list after a successful pull must be
207
+ // retried even though the recorded remote tip no longer moves.
208
+ let listPending = false;
209
+
210
+ function snapshot() {
211
+ return { rows, asOf, lastCheckedAt, lastError, lastSkip, refreshing: inFlight !== null };
212
+ }
213
+
214
+ function recordSkip(reason) {
215
+ const at = now();
216
+ lastCheckedAt = at;
217
+ lastSkip = { reason, at };
218
+ warn(`[beads-view] refresh skipped (will retry on the next refresh): ${reason}`);
219
+ return { kind: 'skip', reason };
220
+ }
221
+
222
+ function recordError(reason) {
223
+ const at = now();
224
+ lastCheckedAt = at;
225
+ lastError = { message: reason, at };
226
+ logError(`[beads-view] ERROR: refresh failed; keeping the previously cached rows: ${reason}`);
227
+ return { kind: 'error', reason };
228
+ }
229
+
230
+ /**
231
+ * One check. `forceList` re-lists rows even when the remote tip is
232
+ * unchanged (freshForLaunch). Never throws.
233
+ */
234
+ async function runCheck({ forceList }) {
235
+ const st = backlogMember.get() || {};
236
+ const memberName = st.member && typeof st.member.name === 'string' ? st.member.name : null;
237
+ if (st.status !== 'ready' || !memberName) {
238
+ return recordError(`backlog member not ready (${st.reason || st.status || 'no backlog member'}); the beads clone cannot be pulled`);
239
+ }
240
+
241
+ // doltPullBefore records the new remote tip as soon as the pull
242
+ // succeeds -- BEFORE the list below runs. If that list then skips or
243
+ // fails, the next check would see an "unchanged" tip and keep serving
244
+ // the pre-pull rows as fresh. So a list is owed from here until one
245
+ // succeeds (or a confirmed-current check clears it below).
246
+ const listOwed = listPending;
247
+ listPending = true;
248
+
249
+ let pullRes;
250
+ try {
251
+ pullRes = await pull(memberName, { command, log, maxTransientRetries: 0, timeoutS: pullTimeoutS });
252
+ } catch (err) {
253
+ if (isBusyFailure(err)) return recordSkip(`D-pull on backlog member '${memberName}' hit a lock/busy/transient failure: ${err && err.message ? err.message : err}`);
254
+ return recordError(`D-pull on backlog member '${memberName}' failed: ${err && err.message ? err.message : err}`);
255
+ }
256
+
257
+ const tipUnchanged = !!(pullRes && pullRes.skipped && pullRes.reason === 'remote-unchanged');
258
+ const needList = forceList || rows === null || !tipUnchanged || listOwed;
259
+ let listed = null;
260
+ if (needList) {
261
+ try {
262
+ listed = await listAllBeads(repoRoot ? { cwd: repoRoot } : {});
263
+ } catch (err) {
264
+ if (isBusyFailure(err)) return recordSkip(`bd list hit a lock/busy failure: ${err && err.message ? err.message : err}`);
265
+ return recordError(`bd list --all failed: ${err && err.message ? err.message : err}`);
266
+ }
267
+ if (!Array.isArray(listed)) return recordError('bd list --all returned a non-array result');
268
+ rows = listed;
269
+ }
270
+ listPending = false;
271
+
272
+ const at = now();
273
+ asOf = at;
274
+ lastCheckedAt = at;
275
+ lastError = null;
276
+ lastSkip = null;
277
+ if (ledger && typeof ledger.setScopeFreshness === 'function') {
278
+ try {
279
+ await ledger.setScopeFreshness(new Date(at).toISOString());
280
+ } catch (err) {
281
+ logError(`[beads-view] ERROR: could not record scope freshness in the ledger: ${err && err.message ? err.message : err}`);
282
+ }
283
+ }
284
+ return { kind: 'ok', rows: listed, listed: listed !== null, tipUnchanged };
285
+ }
286
+
287
+ /** Occupy the single in-flight slot with `fn`; the slot frees when it settles. */
288
+ function occupy(fn) {
289
+ const p = (async () => {
290
+ try {
291
+ return await fn();
292
+ } catch (err) {
293
+ // runCheck never throws; this is a last-resort guard so the
294
+ // slot can never hold a rejected promise that callers see.
295
+ return recordError(`unexpected beads view failure: ${err && err.message ? err.message : err}`);
296
+ } finally {
297
+ if (inFlight === p) inFlight = null;
298
+ }
299
+ })();
300
+ inFlight = p;
301
+ return p;
302
+ }
303
+
304
+ /** Refresh now (or join the refresh in flight). Resolves the snapshot; never rejects. */
305
+ async function refresh() {
306
+ if (!inFlight && !stopped) occupy(() => runCheck({ forceList: false }));
307
+ if (inFlight) await inFlight;
308
+ return snapshot();
309
+ }
310
+
311
+ /**
312
+ * Start a background refresh when the last check is older than
313
+ * `maxAgeMs` (or never happened) and nothing is in flight. Returns
314
+ * immediately: true when a refresh was started. Never rejects.
315
+ */
316
+ function refreshIfStale(maxAgeMs = DEFAULT_BEADS_VIEW_MAX_AGE_MS) {
317
+ if (stopped || inFlight) return false;
318
+ if (lastCheckedAt !== null && now() - lastCheckedAt < maxAgeMs) return false;
319
+ occupy(() => runCheck({ forceList: false })).catch(() => {});
320
+ return true;
321
+ }
322
+
323
+ /**
324
+ * Rows fetched by THIS call, for the launch overlap guard. Joins any
325
+ * in-flight refresh first (never a second concurrent one), then runs its
326
+ * own check, which always re-lists. Rejects with BeadsViewUnavailableError
327
+ * on timeout, skip, failure, or a not-ready backlog member.
328
+ *
329
+ * @param {{ timeoutMs?: number }} [opts]
330
+ * @returns {Promise<object[]>}
331
+ */
332
+ function freshForLaunch(opts = {}) {
333
+ const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : DEFAULT_FRESH_FOR_LAUNCH_TIMEOUT_MS;
334
+ if (stopped) return Promise.reject(new BeadsViewUnavailableError('the supervisor is shutting down', { kind: 'stopped' }));
335
+ let abandoned = false;
336
+ const work = (async () => {
337
+ // Join whatever is in flight; loop because another caller may
338
+ // have taken the slot again by the time we resume.
339
+ while (inFlight) await inFlight;
340
+ if (abandoned) return null;
341
+ if (stopped) throw new BeadsViewUnavailableError('the supervisor is shutting down', { kind: 'stopped' });
342
+ const outcome = await occupy(() => runCheck({ forceList: true }));
343
+ if (outcome.kind === 'ok' && Array.isArray(outcome.rows)) return outcome.rows;
344
+ if (outcome.kind === 'skip') throw new BeadsViewUnavailableError(outcome.reason, { kind: 'skip' });
345
+ throw new BeadsViewUnavailableError(outcome.reason || 'fresh beads check failed', { kind: 'error' });
346
+ })();
347
+ let timer = null;
348
+ const timeout = new Promise((_, reject) => {
349
+ timer = setTimer(() => {
350
+ abandoned = true;
351
+ reject(new BeadsViewUnavailableError(`fresh beads check did not finish within ${timeoutMs}ms`, { kind: 'timeout' }));
352
+ }, timeoutMs);
353
+ if (timer && typeof timer.unref === 'function') timer.unref();
354
+ });
355
+ // If the timeout wins, the work keeps holding the slot until it
356
+ // settles (so no second pull starts); its own outcome is discarded.
357
+ work.catch(() => {});
358
+ return Promise.race([work, timeout]).finally(() => clearTimer(timer));
359
+ }
360
+
361
+ function stop() {
362
+ stopped = true;
363
+ }
364
+
365
+ return { snapshot, refresh, refreshIfStale, freshForLaunch, stop };
366
+ }
367
+
368
+ /** Launch-path busy-skip retries (a sprint child briefly holding the clone lock). */
369
+ export const DEFAULT_LAUNCH_BUSY_RETRIES = 3;
370
+ /** Pause between launch-path busy-skip retries. */
371
+ export const DEFAULT_LAUNCH_BUSY_RETRY_DELAY_MS = 500;
372
+
373
+ /**
374
+ * The launch overlap guard's `listAllBeads`: rows fetched by a forced fresh
375
+ * check made in THIS call (view.freshForLaunch()), never cached rows. A busy
376
+ * /lock skip is retried a small bounded number of times inside ONE wall-clock
377
+ * bound (`timeoutMs`); a timeout or any non-transient failure rejects
378
+ * immediately with BeadsViewUnavailableError (the launch path answers 503).
379
+ *
380
+ * @param {{ freshForLaunch: Function }} view
381
+ * @param {{ timeoutMs?: number, busyRetries?: number, retryDelayMs?: number,
382
+ * now?: () => number, sleep?: (ms: number) => Promise<void> }} [opts]
383
+ * @returns {() => Promise<object[]>}
384
+ */
385
+ export function createLaunchRowsFetcher(view, opts = {}) {
386
+ if (!view || typeof view.freshForLaunch !== 'function') throw new TypeError('createLaunchRowsFetcher requires a view with freshForLaunch()');
387
+ const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : DEFAULT_FRESH_FOR_LAUNCH_TIMEOUT_MS;
388
+ const busyRetries = Number.isInteger(opts.busyRetries) && opts.busyRetries >= 0 ? opts.busyRetries : DEFAULT_LAUNCH_BUSY_RETRIES;
389
+ const retryDelayMs = Number.isFinite(opts.retryDelayMs) && opts.retryDelayMs >= 0 ? opts.retryDelayMs : DEFAULT_LAUNCH_BUSY_RETRY_DELAY_MS;
390
+ const now = opts.now ?? Date.now;
391
+ const sleep = opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
392
+ return async function listAllBeadsFresh() {
393
+ const deadline = now() + timeoutMs;
394
+ let retriesLeft = busyRetries;
395
+ for (;;) {
396
+ const remaining = deadline - now();
397
+ if (remaining <= 0) {
398
+ throw new BeadsViewUnavailableError(`fresh beads check did not finish within ${timeoutMs}ms`, { kind: 'timeout' });
399
+ }
400
+ try {
401
+ return await view.freshForLaunch({ timeoutMs: remaining });
402
+ } catch (err) {
403
+ const transient = err instanceof BeadsViewUnavailableError && err.kind === 'skip';
404
+ if (!transient || retriesLeft <= 0) throw err;
405
+ retriesLeft -= 1;
406
+ if (retryDelayMs > 0) await sleep(Math.min(retryDelayMs, Math.max(0, deadline - now())));
407
+ }
408
+ }
409
+ };
410
+ }
411
+
412
+ /**
413
+ * A rows reader over the view's snapshot for the dashboard/backlog: never
414
+ * spawns or waits (kicks refreshIfStale(maxAgeMs) in the background first).
415
+ * With no rows yet (startup, first refresh failed) it throws -- callers take
416
+ * their existing degraded path -- unless `emptyWhenNoRows` is set, in which
417
+ * case it returns [] (the backlog panel: an empty table plus the dashboard's
418
+ * freshness notice, instead of a failed panel). `openOnly` drops closed beads, reproducing the default
419
+ * `bd list --json --limit 0` set (the view holds `--all` rows). Difference
420
+ * documented: `bd list`'s default also hides gate-type issues; this filter
421
+ * does not -- gates are an agent-synchronisation construct this tracker does
422
+ * not use.
423
+ *
424
+ * @param {{ snapshot: Function, refreshIfStale?: Function }} view
425
+ * @param {{ maxAgeMs?: number, openOnly?: boolean, emptyWhenNoRows?: boolean }} [opts]
426
+ * @returns {() => object[]}
427
+ */
428
+ export function createSnapshotRowsReader(view, opts = {}) {
429
+ if (!view || typeof view.snapshot !== 'function') throw new TypeError('createSnapshotRowsReader requires a view with snapshot()');
430
+ const maxAgeMs = opts.maxAgeMs ?? DEFAULT_BEADS_VIEW_MAX_AGE_MS;
431
+ return function readCachedRows() {
432
+ if (typeof view.refreshIfStale === 'function') view.refreshIfStale(maxAgeMs);
433
+ const snap = view.snapshot();
434
+ if (!Array.isArray(snap.rows) && opts.emptyWhenNoRows) return [];
435
+ if (!Array.isArray(snap.rows)) throw new Error('beads view has no rows yet (startup or first refresh failed)');
436
+ return opts.openOnly ? snap.rows.filter((b) => !(b && b.status === 'closed')) : snap.rows;
437
+ };
438
+ }