@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,338 @@
1
+ // =============================================================================
2
+ // Supervisor seam -- orphaned ephemeral `dolt sql-server` sweep
3
+ // (docs/dolt-sync-redesign.md Part 3.3)
4
+ // =============================================================================
5
+ //
6
+ // settleDoltConflicts() (fleet-sprint/dolt-settle.mjs) spawns a genuinely
7
+ // DETACHED, short-lived `dolt sql-server` on a member and tears it down in a
8
+ // real `finally` -- kill the recorded pid, verify the port closed. That
9
+ // `finally` covers every throw path inside the orchestrator process.
10
+ //
11
+ // It cannot cover ONE case: the orchestrator process itself dying mid-settle
12
+ // (SIGKILL, machine crash, a supervisor restart while a detached sprint child
13
+ // was settling). The server survives -- that is the whole point of the
14
+ // detachment -- and then holds Dolt's per-directory exclusive lock on the
15
+ // member's beads data dir, wedging every subsequent embedded `bd` command on
16
+ // that member. That is exactly the apra-fleet-5mqg damage class.
17
+ //
18
+ // This sweep is the backstop for that one case, and NOTHING else. If settle's
19
+ // `finally` is correct, this sweep should never find anything -- finding
20
+ // something is itself a signal worth logging loudly. It only ever kills a
21
+ // process that is BOTH a `dolt sql-server` AND listening on a port inside
22
+ // settle's own ephemeral range AND older than a generous age threshold, so a
23
+ // settle actually in progress is never interrupted and an operator's own
24
+ // long-lived dolt server (on any other port) is never touched.
25
+ //
26
+ // ASCII only.
27
+ // =============================================================================
28
+
29
+ import { DEFAULT_PORT_RANGE } from '../../fleet-sprint/dolt-settle.mjs';
30
+ import { SeWindowsCommands } from '../../fleet-sprint/se-windows.mjs';
31
+
32
+ const seWindows = new SeWindowsCommands();
33
+
34
+ /** How often the sweep runs. Settles take seconds; this is a safety net. */
35
+ export const DEFAULT_SWEEP_INTERVAL_MS = 5 * 60 * 1000;
36
+
37
+ /** A server younger than this is assumed to belong to a settle in progress and
38
+ * is left alone. Settle's own bounded waits are far shorter than this. */
39
+ export const DEFAULT_MAX_AGE_MS = 10 * 60 * 1000;
40
+
41
+ /** Settle's ephemeral port range. Re-exported from dolt-settle.mjs's
42
+ * DEFAULT_PORT_RANGE -- never re-derive these bounds by hand, so the sweep
43
+ * can never drift out of sync with the range settle actually uses. Only a
44
+ * server bound inside this range can be settle residue. */
45
+ export const SETTLE_PORT_RANGE = DEFAULT_PORT_RANGE;
46
+
47
+ /**
48
+ * Owner scope (the cross-instance-kill fix). The probe/kill command below is
49
+ * otherwise a MACHINE-WIDE process scan bounded only by port range and process
50
+ * age -- so an isolated supervisor instance (e.g. the regression playbook's
51
+ * sandbox, whose HOME/FLEET_SE_DATA_DIR point inside the sandbox) could kill an
52
+ * aged ephemeral server belonging to a DIFFERENT, live supervisor on the same
53
+ * machine. Passing an owner data-dir prefix constrains candidates to processes
54
+ * whose `--data-dir` lives under that prefix.
55
+ *
56
+ * This is deliberately OPT-IN, wired at the deps level by bin/serve.mjs from
57
+ * FLEET_SE_SWEEP_OWNER_DATA_DIR: the ephemeral server's `--data-dir` is the
58
+ * MEMBER's beads data dir (dolt-settle.mjs's resolveDoltStatus reads it from
59
+ * `bd dolt status` on the member), which for a remote member has no relation to
60
+ * the sweeping supervisor's own data dir. Deriving the prefix from
61
+ * FLEET_SE_DATA_DIR unconditionally would therefore silently turn the sweep
62
+ * into a no-op for every remote member -- destroying the safety net to fix the
63
+ * isolation problem. An operator/test that KNOWS its members are confined to
64
+ * one root opts in; production keeps the machine-wide default.
65
+ *
66
+ * KNOWN LIMIT: resolveDoltStatus's `unknown` parse fallback yields the
67
+ * RELATIVE default data dir, so such a command line carries no absolute path
68
+ * and is excluded by ANY prefix. That direction is fail-safe (the sweep skips
69
+ * rather than kills a foreign process), but it means an owner-scoped sweep is
70
+ * inert for that fallback -- see scripts/reap-sandbox-dolt.mjs, which covers
71
+ * the same blind spot with a recency bound instead.
72
+ */
73
+ export function normalizeOwnerDataDirPrefix(prefix) {
74
+ const text = String(prefix == null ? '' : prefix).trim();
75
+ return text ? text : null;
76
+ }
77
+
78
+ /**
79
+ * apra-fleet-5co8.36: Node's `path.resolve()` does NOT understand MSYS-style
80
+ * POSIX paths (e.g. `/c/Users/x/temp` -- what Git Bash reports as `$HOME` on
81
+ * Windows). On win32 it treats a leading `/c/...` as a root-relative path on
82
+ * the CURRENT drive and prefixes it with that drive, producing a nonexistent
83
+ * path like `C:\c\Users\x\temp` rather than `C:\Users\x\temp`. Since
84
+ * `FLEET_SE_SWEEP_OWNER_DATA_DIR` is commonly set from `$HOME` under Git
85
+ * Bash (see regression-test-playbook.md's `## Setup`), that mangling made the
86
+ * owner-scoped sweep match no real `--data-dir` and silently degrade to
87
+ * matching nothing while still logging a confident scope claim.
88
+ *
89
+ * Call this BEFORE `path.resolve()` on a raw env value: it rewrites a
90
+ * `/<drive>/...` MSYS path to its native Windows form (`<DRIVE>:\...`) when
91
+ * `platform` is `'win32'`, and returns the input unchanged for any other
92
+ * platform or any value that does not look like an MSYS path (e.g. one
93
+ * that is already native, like `C:\Users\x` or `C:/Users/x`).
94
+ *
95
+ * @param {string} value
96
+ * @param {string} [platform] defaults to `process.platform` (win32 under
97
+ * Git Bash even though the invoking shell is POSIX-like -- Node's own
98
+ * platform, never the shell, decides this).
99
+ * @returns {string}
100
+ */
101
+ export function normalizeMsysPathForPlatform(value, platform = process.platform) {
102
+ const text = String(value == null ? '' : value);
103
+ if (platform !== 'win32' || !text) return text;
104
+ const match = /^\/([a-zA-Z])\/(.*)$/.exec(text);
105
+ if (!match) return text;
106
+ const [, drive, rest] = match;
107
+ return `${drive.toUpperCase()}:\\${rest.replace(/\//g, '\\')}`;
108
+ }
109
+
110
+ /** Quote a value for embedding in a PowerShell single-quoted string literal.
111
+ * PowerShell also treats U+2018..U+201B as single quotes; each quote
112
+ * character is doubled as itself. */
113
+ function psQuote(value) {
114
+ return `'${String(value).replace(/['\u2018-\u201B]/g, '$&$&')}'`;
115
+ }
116
+
117
+ /** Escape PowerShell -like wildcard metacharacters so a path is matched
118
+ * LITERALLY. -like (not -match) is used deliberately: a regex operator would
119
+ * clobber $Matches, which the port-range bound above reads, and a Windows
120
+ * path's backslashes would be read as regex escapes. */
121
+ function psLikeEscape(value) {
122
+ return String(value).replace(/([*?[\]`])/g, '`$1');
123
+ }
124
+
125
+ /** Quote a value for embedding in a POSIX shell single-quoted word. awk's -v
126
+ * ALSO processes backslash escapes in the assigned value, so backslashes are
127
+ * doubled first -- otherwise a `\U`/`\x` in a path would be mangled. */
128
+ function awkVarQuote(value) {
129
+ const escaped = String(value).replace(/\\/g, '\\\\');
130
+ return `'${escaped.replace(/'/g, "'\\''")}'`;
131
+ }
132
+
133
+ /** Normalize a member registry `os` value to the shell family we must speak. */
134
+ export function memberShellFamily(os) {
135
+ // NOTE: a bare /win/ test is wrong -- 'darwin' contains 'win'.
136
+ const text = String(os || '').toLowerCase();
137
+ return (text.startsWith('win') || text.includes('windows')) ? 'win32' : 'posix';
138
+ }
139
+
140
+ /**
141
+ * The probe-and-kill command, per shell family. One command does both: it
142
+ * enumerates candidates, prints what it is about to kill (so the sweep can log
143
+ * evidence rather than a silent body count), and kills only those.
144
+ *
145
+ * @param {'win32'|'posix'} family
146
+ * @param {number} maxAgeMs
147
+ * @param {string|null} [ownerDataDirPrefix] when set, only a process whose
148
+ * command line carries a `--data-dir` under this prefix is a candidate
149
+ * (see normalizeOwnerDataDirPrefix above). Omitted -> machine-wide.
150
+ * @returns {string}
151
+ */
152
+ export function buildSweepCommand(family, maxAgeMs = DEFAULT_MAX_AGE_MS, ownerDataDirPrefix = null) {
153
+ const maxAgeSeconds = Math.floor(maxAgeMs / 1000);
154
+ const owner = normalizeOwnerDataDirPrefix(ownerDataDirPrefix);
155
+ // Exact numeric bounds, never a hand-derived digit-prefix regex: matching
156
+ // must be EXACT on [SETTLE_PORT_RANGE.start, SETTLE_PORT_RANGE.end) so an
157
+ // operator's own long-lived server (e.g. --port 1337, or ANY 4-digit port,
158
+ // or a 5-digit port merely starting with the same leading digits like
159
+ // --port 13400) is never a false positive -- see the module doc above.
160
+ const portLo = SETTLE_PORT_RANGE.start;
161
+ const portHi = SETTLE_PORT_RANGE.end - 1; // inclusive upper bound
162
+ if (family === 'win32') {
163
+ // The registered `shell` for a win32 member can be real PowerShell OR
164
+ // gitbash (bash.exe) -- and MSYS `ps` cannot support the POSIX branch
165
+ // below (no -o/etimes support, confirmed live). Rather than add a
166
+ // third shell-family branch, wrap this script as an opaque
167
+ // `powershell -EncodedCommand <blob>` invocation via the same
168
+ // wrapForMember() envelope se-windows.mjs uses for its own member
169
+ // dispatch. That string is a single shell-agnostic argument to any
170
+ // OUTER shell (bash.exe, cmd.exe, powershell.exe) -- it always execs
171
+ // the literal powershell.exe binary regardless of which one the
172
+ // receiving member actually runs.
173
+ const rawScript = [
174
+ `$cutoff = (Get-Date).AddSeconds(-${maxAgeSeconds})`,
175
+ '$procs = Get-CimInstance Win32_Process -Filter "Name=\'dolt.exe\'" -ErrorAction SilentlyContinue |'
176
+ + ' Where-Object { $_.CommandLine -match \'sql-server\''
177
+ + ` -and $_.CommandLine -match '--port (\\d+)' -and [int]$Matches[1] -ge ${portLo} -and [int]$Matches[1] -le ${portHi}`
178
+ + ' -and $_.CreationDate -lt $cutoff'
179
+ // Owner clause LAST, and -like rather than -match: $Matches still
180
+ // holds the --port capture the bound above compares, so any regex
181
+ // operator inserted here would silently break the port range.
182
+ + (owner ? ` -and $_.CommandLine -like ${psQuote(`*--data-dir*${psLikeEscape(owner)}*`)}` : '')
183
+ + ' }',
184
+ 'foreach ($p in $procs) { Write-Output "ORPHAN:$($p.ProcessId):$($p.CommandLine)"; Stop-Process -Id $p.ProcessId -Force -ErrorAction SilentlyContinue }',
185
+ ].join('; ');
186
+ return seWindows.wrapForMember(rawScript);
187
+ }
188
+ // POSIX: etimes is the process age in seconds, so no clock skew maths.
189
+ // awk has no lookahead, so the port bound is an actual numeric range
190
+ // check (match() + substr() to pull the digits, then compare) rather than
191
+ // a digit-prefix regex -- exact, not "harmlessly overbroad".
192
+ // The owner clause is a literal SUBSTRING test (index()), never a regex:
193
+ // a path may contain regex metacharacters, and awk has no literal-match
194
+ // operator. The value is passed via -v so it is never spliced into the
195
+ // program text.
196
+ const ownerVar = owner ? `-v owner=${awkVarQuote(owner)} ` : '';
197
+ const ownerClause = owner ? ' && /--data-dir/ && index($0, owner) > 0' : '';
198
+ return [
199
+ `ps -eo pid=,etimes=,args= | awk ${ownerVar}-v lo=${portLo} -v hi=${portHi} '$2 > ${maxAgeSeconds} && /sql-server/${ownerClause} && match($0, /--port [0-9]+/) {`
200
+ + ' port = substr($0, RSTART + 7, RLENGTH - 7) + 0;'
201
+ + ' if (port >= lo && port <= hi) { printf "ORPHAN:%s:", $1; for (i=3; i<=NF; i++) printf "%s ", $i; print "" }'
202
+ + " }'",
203
+ '| tee /dev/stderr',
204
+ "| sed -n 's/^ORPHAN:\\([0-9]*\\):.*/\\1/p'",
205
+ '| xargs -r kill -9',
206
+ ].join(' ');
207
+ }
208
+
209
+ /** Parse the ORPHAN: lines a sweep command emits. */
210
+ export function parseSweepOutput(output) {
211
+ const found = [];
212
+ for (const line of String(output || '').split('\n')) {
213
+ const match = line.replace(/\r$/, '').match(/ORPHAN:(\d+):(.*)$/);
214
+ if (match) found.push({ pid: Number(match[1]), commandLine: match[2].trim() });
215
+ }
216
+ return found;
217
+ }
218
+
219
+ /**
220
+ * Create the sweep seam. Shape matches the supervisor's other timer-driven
221
+ * seams (dolt-mutex.mjs, id-allocator.mjs): construct, then start()/stop() is
222
+ * driven by the seam machinery in server.mjs.
223
+ *
224
+ * @param {{
225
+ * listMembers: () => Promise<{ members: Array<object> }>,
226
+ * execCommand: (opts: { member: string, command: string }) => Promise<{ ok: boolean, output?: string, error?: string }>,
227
+ * intervalMs?: number,
228
+ * maxAgeMs?: number,
229
+ * ownerDataDirPrefix?: string|null,
230
+ * setInterval?: Function,
231
+ * clearInterval?: Function,
232
+ * logger?: { log?: Function, error?: Function },
233
+ * }} deps
234
+ */
235
+ export function createDoltOrphanSweep(deps = {}) {
236
+ const {
237
+ listMembers,
238
+ execCommand,
239
+ intervalMs = DEFAULT_SWEEP_INTERVAL_MS,
240
+ maxAgeMs = DEFAULT_MAX_AGE_MS,
241
+ ownerDataDirPrefix = null,
242
+ setInterval: setIntervalFn = setInterval,
243
+ clearInterval: clearIntervalFn = clearInterval,
244
+ logger = console,
245
+ } = deps;
246
+
247
+ const owner = normalizeOwnerDataDirPrefix(ownerDataDirPrefix);
248
+
249
+ const log = (...a) => (logger.log ?? (() => {}))(...a);
250
+ const logError = (...a) => (logger.error ?? logger.log ?? (() => {}))(...a);
251
+
252
+ let timer = null;
253
+ let inFlight = false;
254
+
255
+ /**
256
+ * One sweep pass across every registered member. Never throws: this is a
257
+ * safety net, and a safety net that can take the supervisor down is worse
258
+ * than the leak it guards against.
259
+ *
260
+ * @returns {Promise<{ swept: number, killed: Array<{ member: string, pid: number, commandLine: string }>, errors: number }>}
261
+ */
262
+ async function sweepOnce() {
263
+ const killed = [];
264
+ let swept = 0;
265
+ let errors = 0;
266
+
267
+ let members = [];
268
+ try {
269
+ const listed = await listMembers();
270
+ members = (listed && Array.isArray(listed.members)) ? listed.members : [];
271
+ } catch (err) {
272
+ logError('[dolt-orphan-sweep] could not list fleet members (skipping this pass):', err);
273
+ return { swept, killed, errors: 1 };
274
+ }
275
+
276
+ for (const member of members) {
277
+ const name = member && (member.name || member.id);
278
+ if (!name) continue;
279
+ const family = memberShellFamily(member && member.os);
280
+ const command = buildSweepCommand(family, maxAgeMs, owner);
281
+ swept += 1;
282
+ let res;
283
+ try {
284
+ // eslint-disable-next-line no-await-in-loop -- deliberately sequential: a safety net must not fan out N SSH sessions at once
285
+ res = await execCommand({ member: name, command });
286
+ } catch (err) {
287
+ errors += 1;
288
+ logError(`[dolt-orphan-sweep] probe failed for member '${name}':`, err && err.message ? err.message : err);
289
+ continue;
290
+ }
291
+ if (res && res.ok === false) {
292
+ errors += 1;
293
+ logError(`[dolt-orphan-sweep] probe failed for member '${name}': ${res.error}`);
294
+ continue;
295
+ }
296
+ for (const orphan of parseSweepOutput(res && (res.output || res.error))) {
297
+ killed.push({ member: name, pid: orphan.pid, commandLine: orphan.commandLine });
298
+ logError(
299
+ `[dolt-orphan-sweep] KILLED an orphaned ephemeral dolt sql-server on member '${name}' `
300
+ + `(pid ${orphan.pid}, older than ${Math.floor(maxAgeMs / 1000)}s, cmd: ${orphan.commandLine}). `
301
+ + "This should be impossible if settle's own finally-block teardown ran -- it means an orchestrator "
302
+ + 'process died mid-settle (docs/dolt-sync-redesign.md Part 3.3). Investigate the sprint that was settling.',
303
+ );
304
+ }
305
+ }
306
+
307
+ if (killed.length === 0) log(`[dolt-orphan-sweep] pass complete: ${swept} member(s) probed, no orphaned settle servers found.`);
308
+ return { swept, killed, errors };
309
+ }
310
+
311
+ return {
312
+ name: 'dolt-orphan-sweep',
313
+ sweepOnce,
314
+ start() {
315
+ if (timer) return;
316
+ timer = setIntervalFn(() => {
317
+ // Skip a tick rather than stacking passes if the previous one
318
+ // is still walking members over SSH (same reentrancy posture
319
+ // as the watchdog's interval).
320
+ if (inFlight) return;
321
+ inFlight = true;
322
+ Promise.resolve()
323
+ .then(sweepOnce)
324
+ .catch((err) => logError('[dolt-orphan-sweep] sweep pass failed:', err))
325
+ .finally(() => { inFlight = false; });
326
+ }, intervalMs);
327
+ if (timer && typeof timer.unref === 'function') timer.unref();
328
+ },
329
+ stop() {
330
+ if (!timer) return;
331
+ clearIntervalFn(timer);
332
+ timer = null;
333
+ },
334
+ get intervalMs() { return intervalMs; },
335
+ get maxAgeMs() { return maxAgeMs; },
336
+ get ownerDataDirPrefix() { return owner; },
337
+ };
338
+ }
@@ -0,0 +1,292 @@
1
+ // =============================================================================
2
+ // fleet-sprint supervisor -- fleet-backed member listing (apra-fleet-eft.4.8.1
3
+ // wiring helper)
4
+ // =============================================================================
5
+ //
6
+ // api.mjs's createSprintController() accepts an injected `listMembers()`
7
+ // collaborator (defaults to `() => ({ members: [] })` when omitted) used by:
8
+ // * GET /api/members (the raw list, overlaid with THIS supervisor's own
9
+ // ledger reservations), and
10
+ // * the default eft.5.2/eft.26.2 member-overlap guard's second reservation
11
+ // source (the fleet server's own `reservedBy` record).
12
+ //
13
+ // The supervisor process itself is NOT a fleet MCP client (it has no
14
+ // standing transport -- bin/cli.mjs's per-sprint children own that), so this
15
+ // module opens a SHORT-LIVED StreamableHttp connection per call, mirroring
16
+ // bin/cli.mjs's own `fleetApi.listMembers({ format: 'json' })` call (the
17
+ // single source of truth for that request shape), and tears the connection
18
+ // down again immediately after. This is deliberately NOT connected once at
19
+ // supervisor boot: `fleet-se serve` must stay independently up (and answer
20
+ // GET /api/health) even when no fleet HTTP singleton is reachable yet -- the
21
+ // supervisor's OWN lifecycle never depends on the fleet server's.
22
+ // =============================================================================
23
+
24
+ import { StreamableHttpTransport } from '@apralabs/apra-fleet-client/transport';
25
+ import { McpClient } from '@apralabs/apra-fleet-client/client';
26
+ import { withFleetAccessSecret } from '@apralabs/apra-fleet-client/server-resolution';
27
+ import { ApraFleet } from '@apralabs/apra-fleet-client';
28
+
29
+ /**
30
+ * "The fleet member list could not be read" marker, attached to a
31
+ * listFleetMembers() result as a NON-ENUMERABLE symbol-keyed property whose
32
+ * value is the human-readable reason. Non-enumerable on purpose: the existing
33
+ * callers (GET /api/members, the dolt orphan sweep, the member-overlap guard)
34
+ * only read `.members` and keep seeing exactly `{ members: [] }` (deepEqual
35
+ * included), while callers that MUST tell "fleet unreachable" apart from "no
36
+ * members registered" (the backlog-member ensure and the launch-time backlog
37
+ * pin) read it through fleetMembersUnavailableReason().
38
+ */
39
+ export const FLEET_MEMBERS_UNAVAILABLE = Symbol.for('apra-fleet-se.fleetMembersUnavailable');
40
+ /** Set (with the client's actionable message) when the fleet server was stopped with 'apra-fleet stop'. */
41
+ export const FLEET_STOPPED_BY_USER = Symbol.for('apra-fleet-se.fleetStoppedByUser');
42
+
43
+ /**
44
+ * The "stopped by the user" message carried by a listMembers()-shaped
45
+ * result, or null. A launch must surface it verbatim (the fix is
46
+ * 'apra-fleet start'), not a generic "fleet unavailable".
47
+ * @param {*} result
48
+ * @returns {string|null}
49
+ */
50
+ export function fleetMembersStoppedByUserReason(result) {
51
+ if (!result || (typeof result !== 'object' && typeof result !== 'function')) return null;
52
+ const reason = result[FLEET_STOPPED_BY_USER];
53
+ return typeof reason === 'string' ? reason : null;
54
+ }
55
+
56
+ /**
57
+ * Mark a listMembers()-shaped result as "unavailable". Returns the same
58
+ * object (created as `{ members: [] }` when omitted), for use by
59
+ * listFleetMembers() itself and by test fakes of the listMembers seam.
60
+ * @param {object} [result]
61
+ * @param {string} [reason]
62
+ * @returns {object}
63
+ */
64
+ export function markFleetMembersUnavailable(result = { members: [] }, reason = 'fleet member list unavailable') {
65
+ Object.defineProperty(result, FLEET_MEMBERS_UNAVAILABLE, {
66
+ value: String(reason), enumerable: false, configurable: true, writable: false,
67
+ });
68
+ return result;
69
+ }
70
+
71
+ /**
72
+ * The unavailable reason carried by a listMembers()-shaped result, or null
73
+ * when the list was actually read (an empty list included).
74
+ * @param {*} result
75
+ * @returns {string|null}
76
+ */
77
+ export function fleetMembersUnavailableReason(result) {
78
+ if (!result || (typeof result !== 'object' && typeof result !== 'function')) return null;
79
+ const reason = result[FLEET_MEMBERS_UNAVAILABLE];
80
+ return typeof reason === 'string' ? reason : null;
81
+ }
82
+
83
+ /** U+274C, the prefix fleet tools put on a refusal reply's text. */
84
+ const FLEET_TOOL_FAILURE_MARK = String.fromCodePoint(0x274c);
85
+
86
+ function errorText(err) {
87
+ return err && err.message ? err.message : String(err);
88
+ }
89
+
90
+ /**
91
+ * Fetches the fleet's registered members via a short-lived MCP connection.
92
+ * Never throws: any resolution/connection/parse failure resolves to an empty
93
+ * member list rather than taking down the caller (GET /api/members degrades
94
+ * to "no members known" instead of a hard failure; the member-overlap guard
95
+ * that also consumes this already treats it as a best-effort second source).
96
+ *
97
+ * @param {{
98
+ * resolveConnection?: () => Promise<{ mode: string, url?: string, reason?: string }>,
99
+ * logger?: { log?: Function, error?: Function },
100
+ * }} [deps]
101
+ * @returns {Promise<{ members: Array<object> }>}
102
+ */
103
+ export async function listFleetMembers(deps = {}) {
104
+ const logger = deps.logger ?? console;
105
+ const logError = (...a) => (logger.error ?? logger.log)?.(...a);
106
+ const resolveConnection = deps.resolveConnection;
107
+ if (typeof resolveConnection !== 'function') {
108
+ throw new TypeError('listFleetMembers requires a resolveConnection() collaborator');
109
+ }
110
+
111
+ let connection;
112
+ try {
113
+ connection = await resolveConnection();
114
+ } catch (err) {
115
+ logError('[fleet-members] failed to resolve fleet server connection:', err);
116
+ const result = markFleetMembersUnavailable({ members: [] }, `could not resolve the fleet server connection: ${errorText(err)}`);
117
+ if (err && err.code === 'SERVER_STOPPED_BY_USER') {
118
+ Object.defineProperty(result, FLEET_STOPPED_BY_USER, { value: errorText(err), enumerable: false, configurable: true, writable: false });
119
+ }
120
+ return result;
121
+ }
122
+ if (!connection || connection.mode !== 'http') {
123
+ logError(`[fleet-members] no reachable fleet HTTP singleton (${connection && connection.reason})`);
124
+ return markFleetMembersUnavailable({ members: [] }, `no reachable fleet HTTP singleton (${connection && connection.reason})`);
125
+ }
126
+
127
+ const transport = new StreamableHttpTransport(connection.url, withFleetAccessSecret());
128
+ try {
129
+ await transport.start();
130
+ const mcpClient = new McpClient(transport);
131
+ const fleetApi = new ApraFleet(mcpClient);
132
+ const listRes = await fleetApi.listMembers({ format: 'json' });
133
+ // The tool-registry wrapper may prepend an <apra-fleet-display> (user-audience)
134
+ // content item; the tool result is the first text item that is not one.
135
+ const items = listRes && Array.isArray(listRes.content) ? listRes.content : [];
136
+ const resultItem = items.find((c) => c && typeof c.text === 'string'
137
+ && !c.text.trimStart().startsWith('<apra-fleet-display')
138
+ && !(c.annotations && Array.isArray(c.annotations.audience)
139
+ && c.annotations.audience.length > 0 && !c.annotations.audience.includes('assistant')));
140
+ const text = resultItem ? resultItem.text : JSON.stringify(listRes);
141
+ const parsed = JSON.parse(text);
142
+ if (!parsed || !Array.isArray(parsed.members)) {
143
+ return markFleetMembersUnavailable({ members: [] }, 'list_members returned no members array');
144
+ }
145
+ return { members: parsed.members };
146
+ } catch (err) {
147
+ logError('[fleet-members] failed to list fleet members:', err);
148
+ return markFleetMembersUnavailable({ members: [] }, `failed to list fleet members: ${errorText(err)}`);
149
+ } finally {
150
+ // close(), not stop(): stop() only aborts local streams and leaves the
151
+ // server session (and its McpServer) open.
152
+ try { await transport.close(); } catch { /* best-effort teardown */ }
153
+ }
154
+ }
155
+
156
+ /**
157
+ * Runs one shell command on one member via the same SHORT-LIVED MCP connection
158
+ * pattern as listFleetMembers() above (the supervisor holds no standing fleet
159
+ * transport, deliberately). Added for the orphaned-`dolt sql-server` sweep
160
+ * (dolt-orphan-sweep.mjs, docs/dolt-sync-redesign.md Part 3.3), which is the
161
+ * only supervisor-side thing that must touch a member directly.
162
+ *
163
+ * Never throws: a failure resolves to `{ ok: false, error }` so the sweep --
164
+ * a safety net -- can log and move on rather than taking the supervisor down.
165
+ *
166
+ * @param {{ member: string, command: string, timeoutSeconds?: number,
167
+ * resolveConnection?: () => Promise<{ mode: string, url?: string, reason?: string }>,
168
+ * logger?: { log?: Function, error?: Function } }} opts
169
+ * @returns {Promise<{ ok: boolean, output?: string, error?: string }>}
170
+ */
171
+ export async function executeFleetCommand(opts = {}) {
172
+ const { member, command, timeoutSeconds = 60, resolveConnection, logger = console } = opts;
173
+ const logError = (...a) => (logger.error ?? logger.log)?.(...a);
174
+ if (typeof resolveConnection !== 'function') {
175
+ throw new TypeError('executeFleetCommand requires a resolveConnection() collaborator');
176
+ }
177
+ if (!member || !command) throw new TypeError('executeFleetCommand requires a member and a command');
178
+
179
+ let connection;
180
+ try {
181
+ connection = await resolveConnection();
182
+ } catch (err) {
183
+ return { ok: false, error: `could not resolve fleet server connection: ${err && err.message ? err.message : err}` };
184
+ }
185
+ if (!connection || connection.mode !== 'http') {
186
+ return { ok: false, error: `no reachable fleet HTTP singleton (${connection && connection.reason})` };
187
+ }
188
+
189
+ const transport = new StreamableHttpTransport(connection.url, withFleetAccessSecret());
190
+ try {
191
+ await transport.start();
192
+ const fleetApi = new ApraFleet(new McpClient(transport));
193
+ const res = await fleetApi.executeCommand({ command, member_name: member, timeout_s: timeoutSeconds });
194
+ const text = res && res.content && res.content[0] ? res.content[0].text : (typeof res === 'string' ? res : JSON.stringify(res));
195
+ if (res && res.isError) {
196
+ return { ok: false, error: String(text ?? 'unknown error') };
197
+ }
198
+ // The fleet server's execute_command does NOT set isError on a
199
+ // non-zero exit; it reports the real exit code (and clean, unprefixed
200
+ // stdout/stderr) in structuredContent instead, while `text` is the
201
+ // display form `Exit code: N\n<output>`. Surface those fields
202
+ // ADDITIVELY (only when the server sent them) so a caller that needs
203
+ // exit-code truth -- the beads view's dolt command adapter
204
+ // (beads-view.mjs) -- can read it, while `ok`/`output` keep their
205
+ // existing meaning for the orphan sweep.
206
+ const sc = res && res.structuredContent;
207
+ if (sc && typeof sc.exitCode === 'number') {
208
+ return {
209
+ ok: true,
210
+ output: String(text ?? ''),
211
+ exitCode: sc.exitCode,
212
+ stdout: typeof sc.stdout === 'string' ? sc.stdout : '',
213
+ stderr: typeof sc.stderr === 'string' ? sc.stderr : '',
214
+ };
215
+ }
216
+ return { ok: true, output: String(text ?? '') };
217
+ } catch (err) {
218
+ logError(`[fleet-members] execute_command failed on member '${member}':`, err);
219
+ return { ok: false, error: err && err.message ? err.message : String(err) };
220
+ } finally {
221
+ // close(), not stop(): stop() only aborts local streams and leaves the
222
+ // server session (and its McpServer) open.
223
+ try { await transport.close(); } catch { /* best-effort teardown */ }
224
+ }
225
+ }
226
+
227
+ /**
228
+ * Shared short-lived-connection tool call for registerFleetMember() /
229
+ * updateFleetMember() below (same pattern as executeFleetCommand above).
230
+ * Never throws: resolves `{ ok: true, output }` or `{ ok: false, error }`.
231
+ * A tool reply flagged isError, or whose text starts with the fleet tools'
232
+ * failure marker (U+274C), is a failure -- register_member/update_member
233
+ * report refusals as text rather than isError.
234
+ */
235
+ async function callFleetMemberTool(toolName, invoke, { resolveConnection, logger = console }) {
236
+ const logError = (...a) => (logger.error ?? logger.log)?.(...a);
237
+ if (typeof resolveConnection !== 'function') {
238
+ throw new TypeError(`${toolName} requires a resolveConnection() collaborator`);
239
+ }
240
+ let connection;
241
+ try {
242
+ connection = await resolveConnection();
243
+ } catch (err) {
244
+ return { ok: false, unavailable: true, error: `could not resolve fleet server connection: ${errorText(err)}` };
245
+ }
246
+ if (!connection || connection.mode !== 'http') {
247
+ return { ok: false, unavailable: true, error: `no reachable fleet HTTP singleton (${connection && connection.reason})` };
248
+ }
249
+ const transport = new StreamableHttpTransport(connection.url, withFleetAccessSecret());
250
+ try {
251
+ await transport.start();
252
+ const fleetApi = new ApraFleet(new McpClient(transport));
253
+ const res = await invoke(fleetApi);
254
+ const text = res && res.content && res.content[0] ? res.content[0].text : (typeof res === 'string' ? res : JSON.stringify(res));
255
+ const textStr = String(text ?? '');
256
+ if ((res && res.isError) || textStr.trimStart().startsWith(FLEET_TOOL_FAILURE_MARK)) {
257
+ return { ok: false, error: textStr || 'unknown error' };
258
+ }
259
+ return { ok: true, output: textStr };
260
+ } catch (err) {
261
+ logError(`[fleet-members] ${toolName} failed:`, err);
262
+ return { ok: false, unavailable: true, error: errorText(err) };
263
+ } finally {
264
+ // close(), not stop(): stop() only aborts local streams and leaves the
265
+ // server session (and its McpServer) open.
266
+ try { await transport.close(); } catch { /* best-effort teardown */ }
267
+ }
268
+ }
269
+
270
+ /**
271
+ * register_member over a short-lived connection. `options` is the
272
+ * register_member input (friendly_name, member_type, work_folder, ...).
273
+ * @param {{ options: object, resolveConnection: Function, logger?: object }} opts
274
+ * @returns {Promise<{ ok: boolean, output?: string, error?: string, unavailable?: boolean }>}
275
+ */
276
+ export async function registerFleetMember(opts = {}) {
277
+ const { options, ...deps } = opts;
278
+ if (!options || !options.friendly_name) throw new TypeError('registerFleetMember requires options.friendly_name');
279
+ return callFleetMemberTool('register_member', (api) => api.registerMember(options), deps);
280
+ }
281
+
282
+ /**
283
+ * update_member over a short-lived connection. `options` is the
284
+ * update_member input (member_name or member_id plus the fields to change).
285
+ * @param {{ options: object, resolveConnection: Function, logger?: object }} opts
286
+ * @returns {Promise<{ ok: boolean, output?: string, error?: string, unavailable?: boolean }>}
287
+ */
288
+ export async function updateFleetMember(opts = {}) {
289
+ const { options, ...deps } = opts;
290
+ if (!options || (!options.member_name && !options.member_id)) throw new TypeError('updateFleetMember requires options.member_name or options.member_id');
291
+ return callFleetMemberTool('update_member', (api) => api.updateMember(options), deps);
292
+ }