@apralabs/apra-fleet 0.4.2 → 0.4.4

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 (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  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 +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  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 +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,542 @@
1
+ // =============================================================================
2
+ // fleet-sprint supervisor -- detached child-per-sprint spawner (apra-fleet-eft.4.2,
3
+ // Plan Part 2.1, process model B)
4
+ // =============================================================================
5
+ //
6
+ // Launches each sprint as the EXISTING `bin/cli.mjs` CLI (see its argv contract
7
+ // around buildOptionsSpec()/main(), ~line 100-420), as a fully detached, truly
8
+ // independently-surviving orphan:
9
+ //
10
+ // spawn(command, args, { detached: true, stdio: 'ignore' }) + child.unref()
11
+ //
12
+ // There is deliberately NO parent-child IPC channel and NO kill-on-parent-exit
13
+ // behavior wired here. On POSIX, `detached: true` gives the child its own
14
+ // process group/session, so:
15
+ //
16
+ // * killing the supervisor (even SIGKILL) leaves every already-launched
17
+ // child running -- this module never listens for or reacts to the
18
+ // supervisor's own exit;
19
+ // * a crashing/killed child never takes down a sibling child or the
20
+ // supervisor -- each child is spawned independently and this module only
21
+ // tracks its own local bookkeeping (freed on that child's 'exit'), it
22
+ // never propagates one child's failure to another.
23
+ //
24
+ // This module owns exactly one extra invariant beyond "spawn detached":
25
+ // **--viewer-port allocation is unique across every currently-live sprint**.
26
+ // The four-status watchdog (eft.4.3), restart re-adoption (eft.4.5), and the
27
+ // combined reservation ledger (eft.5, src/supervisor/ledger.mjs) are separate
28
+ // concerns and are NOT this module's job -- the ledger, notably, persists
29
+ // `childPid` for restart PID-probe reconciliation but does not persist ports,
30
+ // so live-port uniqueness is this module's own in-memory bookkeeping for as
31
+ // long as this supervisor process has been up.
32
+ // =============================================================================
33
+
34
+ import { spawn as nodeSpawn } from 'node:child_process';
35
+ import net from 'node:net';
36
+ import path from 'node:path';
37
+ import fs from 'node:fs';
38
+ import os from 'node:os';
39
+ import { createHash, randomUUID } from 'node:crypto';
40
+ import { fileURLToPath } from 'node:url';
41
+
42
+ const __filename = fileURLToPath(import.meta.url);
43
+ const __dirname = path.dirname(__filename);
44
+
45
+ /** Default first port tried when allocating a fresh `--viewer-port`. */
46
+ export const DEFAULT_SPAWNER_BASE_PORT = 8081;
47
+
48
+ /**
49
+ * The default service data directory. Overridable via the FLEET_SE_DATA_DIR
50
+ * env var, otherwise `~/.apra-fleet-se`. Mirrors ledger.mjs's/history.mjs's
51
+ * own identically-named helper (each module keeps its own small copy rather
52
+ * than cross-importing one another -- the established convention in this
53
+ * package, see id-allocator.mjs's own copy too).
54
+ * @returns {string}
55
+ */
56
+ export function defaultDataDir() {
57
+ return process.env.FLEET_SE_DATA_DIR
58
+ ? path.resolve(process.env.FLEET_SE_DATA_DIR)
59
+ : path.join(os.homedir(), '.apra-fleet-se');
60
+ }
61
+
62
+ /** Max length of a sprint log file's stem (basename without '.log'), identical on every OS. */
63
+ export const MAX_LOG_STEM_LENGTH = 80;
64
+ const LOG_STEM_HASH_LENGTH = 12;
65
+
66
+ /** Subdirectory (under the SE data dir) that per-sprint raw stdout/stderr log files live in. */
67
+ export const SPRINT_LOG_SUBDIR = 'logs';
68
+
69
+ /**
70
+ * apra-fleet-ou7.1: builds the per-sprint raw stdout/stderr log file path
71
+ * (`<dataDir>/logs/<stem>.log`) a spawned child's stdio is teed to for its
72
+ * whole lifetime, including after a crash (spawnSprint() below opens this
73
+ * BEFORE spawning and hands the fd directly to the child, so a Node-level
74
+ * buffered stream is never in the way of capturing a crash's last output).
75
+ *
76
+ * `stem` is sanitized to the same shell/filesystem-safe character class
77
+ * fleet-sprint/runner.js's ISSUE_ID_PATTERN already uses for issue ids
78
+ * (letters, digits, '.', '_', '-') so a caller-supplied runId can never
79
+ * escape the logs directory (no '/', '\\', or '..' path-traversal) and never
80
+ * needs any extra shell quoting.
81
+ * @param {string} dataDir
82
+ * @param {string} stem - typically the sprint's runId; sanitized before use
83
+ * @returns {string}
84
+ */
85
+ export function resolveSprintLogPath(dataDir, stem) {
86
+ let safeStem = String(stem ?? '').replace(/[^A-Za-z0-9._-]/g, '_');
87
+ // Bound the stem on EVERY OS (not just Windows) so the file name -- and
88
+ // so the full path under a long Windows-style dataDir -- never depends on
89
+ // how many issue ids a caller's runId happens to embed. An over-long stem
90
+ // keeps its head for readability and appends a hash of the WHOLE original
91
+ // stem, so two different long stems never collide.
92
+ if (safeStem.length > MAX_LOG_STEM_LENGTH) {
93
+ const digest = createHash('sha256').update(String(stem)).digest('hex').slice(0, LOG_STEM_HASH_LENGTH);
94
+ safeStem = `${safeStem.slice(0, MAX_LOG_STEM_LENGTH - LOG_STEM_HASH_LENGTH - 1)}-${digest}`;
95
+ }
96
+ const fileName = `${safeStem.length > 0 ? safeStem : 'sprint'}.log`;
97
+ // Defense in depth: even after sanitizing, refuse anything that is not
98
+ // a single plain filename (e.g. a sanitized-to-'..'-only stem).
99
+ if (fileName !== path.basename(fileName) || fileName === '.log') {
100
+ throw new Error(`[spawner] refusing to build an unsafe sprint log file name from stem '${stem}'`);
101
+ }
102
+ return path.join(dataDir, SPRINT_LOG_SUBDIR, fileName);
103
+ }
104
+
105
+ /**
106
+ * Resolves the on-disk path to `bin/cli.mjs`, the existing per-sprint CLI this
107
+ * spawner launches. Relative to this file's own package tree
108
+ * (src/supervisor/spawner.mjs -> ../../bin/cli.mjs), matching the layout
109
+ * convention already used by cli.mjs's own resolveRunnerScriptPath().
110
+ * @param {{ dirname?: string }} [deps]
111
+ * @returns {string}
112
+ */
113
+ export function defaultCliPath(deps = {}) {
114
+ const dirname = deps.dirname || __dirname;
115
+ return path.join(dirname, '../../bin/cli.mjs');
116
+ }
117
+
118
+ /**
119
+ * Checks whether a TCP port is currently free by actually attempting to bind
120
+ * it (not just consulting in-memory bookkeeping) -- so allocation reflects
121
+ * real OS-level availability, not just what this supervisor process itself
122
+ * has handed out.
123
+ *
124
+ * The real viewer binds the wildcard address (`server.listen(port, cb)`, no
125
+ * host -- see apra-fleet-workflow/src/viewer/index.mjs). On Windows, a
126
+ * loopback-only bind and a pre-existing wildcard bind on the same port can
127
+ * coexist without either side erroring, so a plain `host` bind-test alone
128
+ * can report a port "free" when a real viewer already owns it via a
129
+ * wildcard bind -- allocateFreePort would then hand that port to a second
130
+ * process, and inbound connections would silently split between the two.
131
+ *
132
+ * This is deliberately NOT fixed by making the probe itself bind the
133
+ * wildcard address: doing so opens this process up to inbound connections
134
+ * from every interface, which triggers an interactive Windows Firewall
135
+ * "allow this app" prompt on first use per port -- and in a headless/CI
136
+ * run nothing ever dismisses that prompt, so the bind call hangs
137
+ * indefinitely (confirmed directly: a wildcard-bind probe stalled a real
138
+ * test run with zero CPU progress). Instead, first try to CONNECT to
139
+ * `host` -- a connect (never a bind) never triggers that firewall prompt,
140
+ * and it reaches a wildcard-bound listener just as reliably as a
141
+ * loopback-only one, since either accepts loopback connections. Only if
142
+ * nothing answers do we fall back to the original bind test, which still
143
+ * catches a same-host bind conflict a connect probe alone cannot (e.g. a
144
+ * listener that accepted the socket but is slow to respond).
145
+ * @param {number} port
146
+ * @param {string} [host]
147
+ * @returns {Promise<boolean>}
148
+ */
149
+ export function isPortAvailable(port, host = '127.0.0.1') {
150
+ return new Promise((resolve) => {
151
+ const probe = net.connect({ port, host });
152
+ const onOccupied = () => { probe.destroy(); resolve(false); };
153
+ probe.once('connect', onOccupied);
154
+ probe.once('error', () => {
155
+ probe.destroy();
156
+ const tester = net.createServer();
157
+ tester.unref();
158
+ tester.once('error', () => resolve(false));
159
+ tester.listen({ port, host, exclusive: true }, () => {
160
+ tester.close(() => resolve(true));
161
+ });
162
+ });
163
+ });
164
+ }
165
+
166
+ /**
167
+ * Finds the lowest free port at or above `startPort`, skipping any port in
168
+ * `excludedPorts` (the set of ports already handed to other LIVE sprints by
169
+ * this supervisor) and any port the OS reports as unavailable. This is the
170
+ * mechanism behind the acceptance criterion "port allocation never hands the
171
+ * same port to two live sprints": excludedPorts is the live set at call time,
172
+ * re-checked against the OS so a port that some unrelated process is already
173
+ * using is also skipped.
174
+ * @param {{
175
+ * startPort?: number,
176
+ * maxAttempts?: number,
177
+ * excludedPorts?: Set<number>|number[],
178
+ * isAvailable?: (port: number) => Promise<boolean>,
179
+ * }} [opts]
180
+ * @returns {Promise<number>}
181
+ */
182
+ export async function allocateFreePort(opts = {}) {
183
+ const startPort = Number.isInteger(opts.startPort) ? opts.startPort : DEFAULT_SPAWNER_BASE_PORT;
184
+ const maxAttempts = Number.isInteger(opts.maxAttempts) ? opts.maxAttempts : 1000;
185
+ const excluded = opts.excludedPorts instanceof Set ? opts.excludedPorts : new Set(opts.excludedPorts || []);
186
+ const isAvailable = opts.isAvailable || isPortAvailable;
187
+
188
+ for (let i = 0; i < maxAttempts; i++) {
189
+ const candidate = startPort + i;
190
+ if (candidate > 65535) break;
191
+ if (excluded.has(candidate)) continue;
192
+ // eslint-disable-next-line no-await-in-loop -- sequential probing is intentional: we want the LOWEST free port, and each check is cheap.
193
+ if (await isAvailable(candidate)) return candidate;
194
+ }
195
+ throw new Error(
196
+ `[spawner] no free --viewer-port found in [${startPort}, ${startPort + maxAttempts}) ` +
197
+ `(excluding ${excluded.size} port(s) already held by live sprints)`,
198
+ );
199
+ }
200
+
201
+ /**
202
+ * Builds the cli.mjs argv (everything after the script path) for one sprint
203
+ * launch, given the already-allocated `viewerPort`. Pulled into its own pure
204
+ * function so a test can assert the exact flags reach cli.mjs without
205
+ * spawning a real process, matching cli.mjs's own buildRunnerArgs() pattern.
206
+ * @param {{
207
+ * issue: string, members: string, branch: string, base: string,
208
+ * goal?: string, maxCycles?: number|string, allowMissingMembers?: boolean,
209
+ * requirementsFile?: string, roleMap?: object|string, budget?: number|string,
210
+ * viewerPort: number, serviceUrl?: string, runId?: string, expectBeads?: string,
211
+ * extraArgs?: string[], skipRegression?: boolean,
212
+ * }} opts
213
+ * @returns {string[]}
214
+ */
215
+ export function buildSprintArgv(opts = {}) {
216
+ const { issue, members, branch, base, goal, maxCycles, allowMissingMembers,
217
+ requirementsFile, roleMap, budget, viewerPort, serviceUrl, runId, expectBeads, extraArgs, skipRegression } = opts;
218
+
219
+ if (!issue || !members || !branch || !base) {
220
+ throw new Error('buildSprintArgv requires issue, members, branch, and base');
221
+ }
222
+ if (!Number.isInteger(viewerPort) || viewerPort <= 0 || viewerPort > 65535) {
223
+ throw new Error('buildSprintArgv requires an integer viewerPort in [1, 65535]');
224
+ }
225
+
226
+ const args = [
227
+ '--issue', issue,
228
+ '--members', members,
229
+ '--branch', branch,
230
+ '--base', base,
231
+ '--viewer-port', String(viewerPort),
232
+ ];
233
+ if (goal !== undefined) args.push('--goal', goal);
234
+ if (maxCycles !== undefined) args.push('--max-cycles', String(maxCycles));
235
+ if (allowMissingMembers) args.push('--allow-missing-members');
236
+ if (requirementsFile !== undefined) args.push('--requirements-file', requirementsFile);
237
+ if (roleMap !== undefined) {
238
+ args.push('--role-map', typeof roleMap === 'string' ? roleMap : JSON.stringify(roleMap));
239
+ }
240
+ if (budget !== undefined) args.push('--budget', String(budget));
241
+ if (skipRegression === true) args.push('--skip-regression');
242
+ // apra-fleet-f34.1: when this supervisor instance has a known --service-url
243
+ // (its own HTTP listen address, wired in from createSpawner()'s deps.serviceUrl
244
+ // below), forward it so the spawned cli.mjs child threads it into
245
+ // runner.js's HTTP-backed dolt-mutex/id-allocator clients instead of the
246
+ // source-3 no-op fallback. Absent a configured serviceUrl this is omitted
247
+ // entirely -- fallback behavior is unchanged.
248
+ if (serviceUrl !== undefined) args.push('--service-url', serviceUrl);
249
+ // apra-fleet-k7b.1: the supervisor's own sprintId (its ledger reservation
250
+ // key) forwarded as this child's --run-id, so the engine's run-state
251
+ // (running/<runId>.json -> old_runs/<runId>.json, apra-fleet-workflow's
252
+ // viewer) and the dashboard viewer's identity are keyed by the SAME
253
+ // incarnation-unique id the supervisor already uses -- not the sprint
254
+ // branch name, which is reused across relaunches on the same branch and
255
+ // would otherwise silently overwrite prior run history. Omitted here (a
256
+ // direct/standalone CLI launch never goes through this spawner) means
257
+ // cli.mjs falls back to the branch name itself.
258
+ if (runId !== undefined) args.push('--run-id', runId);
259
+ // The beads identity this supervisor resolved at startup (see
260
+ // beads-identity.mjs / bin/serve.mjs), serialized by the shared
261
+ // fleet-sprint/beads-identity.mjs serializeExpectedIdentity(), forwarded
262
+ // so the engine can verify every member's `bd where` against the SAME
263
+ // database this supervisor reads. Omitted when the caller has none (a
264
+ // direct/test spawner) -- the engine then skips the verification.
265
+ if (expectBeads !== undefined) args.push('--expect-beads', expectBeads);
266
+ if (Array.isArray(extraArgs)) args.push(...extraArgs);
267
+ return args;
268
+ }
269
+
270
+ /**
271
+ * Creates the spawner seam (see src/supervisor/server.mjs's seam docs). Not
272
+ * started until `start()` is called (a no-op here -- there is no persistent
273
+ * state to load; the ledger owns that). `stop()` deliberately never kills any
274
+ * live child: it only clears this process's own local bookkeeping.
275
+ *
276
+ * @param {{
277
+ * basePort?: number,
278
+ * command?: string,
279
+ * cliPath?: string,
280
+ * cwd?: string,
281
+ * env?: NodeJS.ProcessEnv,
282
+ * spawn?: typeof import('node:child_process').spawn,
283
+ * isPortAvailable?: (port: number) => Promise<boolean>,
284
+ * logger?: { log?: Function, error?: Function },
285
+ * serviceUrl?: string,
286
+ * expectBeads?: string|(() => string|undefined),
287
+ * onChildExit?: (info: { pid: number, runId: string|null, exitCode: number|null, signal: string|null, at: string, logPath: string }) => void,
288
+ * now?: () => string,
289
+ * dataDir?: string,
290
+ * fs?: {
291
+ * mkdirSync: typeof import('node:fs').mkdirSync,
292
+ * openSync: typeof import('node:fs').openSync,
293
+ * closeSync: typeof import('node:fs').closeSync,
294
+ * },
295
+ * }} [deps]
296
+ * @returns {{
297
+ * name: string,
298
+ * start(): Promise<void>,
299
+ * stop(): Promise<void>,
300
+ * spawnSprint(opts: object): Promise<{ pid: number, port: number, command: string, args: string[], logPath: string }>,
301
+ * liveCount: number,
302
+ * livePorts: Set<number>,
303
+ * getLiveEntry(pid: number): { port: number, child: object, logPath: string }|undefined,
304
+ * }}
305
+ */
306
+ export function createSpawner(deps = {}) {
307
+ const logger = deps.logger ?? console;
308
+ const logError = (...a) => (logger.error ?? logger.log)?.(...a);
309
+ const spawnImpl = deps.spawn ?? nodeSpawn;
310
+ const isAvailable = deps.isPortAvailable ?? isPortAvailable;
311
+ const basePort = Number.isInteger(deps.basePort) ? deps.basePort : DEFAULT_SPAWNER_BASE_PORT;
312
+ // apra-fleet-ou7.1: where per-sprint raw stdout/stderr log files live
313
+ // (<dataDir>/logs/<stem>.log, resolveSprintLogPath() above). Injectable
314
+ // fs so a test can drive a temp dir/fake fs without touching real disk.
315
+ const dataDir = deps.dataDir ?? defaultDataDir();
316
+ const fsImpl = deps.fs ?? fs;
317
+ const command = deps.command ?? process.execPath;
318
+ const cliPath = deps.cliPath ?? defaultCliPath();
319
+ // apra-fleet-f34.1: the supervisor's OWN HTTP listen address (e.g.
320
+ // `http://localhost:8787`), the same address it already binds for its
321
+ // dolt-mutex/id-allocator/sprint-control API. Threaded into every spawned
322
+ // child's `--service-url` (see buildSprintArgv above) so runner.js takes
323
+ // the HTTP-backed dolt-mutex/id-allocator clients instead of the source-3
324
+ // no-op fallback. Optional: when the caller (bin/serve.mjs) does not pass
325
+ // one, spawned children simply omit --service-url and fall back exactly
326
+ // as before -- no crash, unchanged behavior.
327
+ const serviceUrl = deps.serviceUrl;
328
+ // The serialized beads identity (fleet-sprint/beads-identity.mjs's
329
+ // serializeExpectedIdentity() JSON) every child receives as
330
+ // `--expect-beads`; threaded exactly like serviceUrl above -- optional,
331
+ // and a per-call opts.expectBeads wins over the instance default. May be
332
+ // a function (bin/serve.mjs passes one) so it is read at each spawn:
333
+ // the supervisor's identity can start out unknown and be recovered
334
+ // later by GET /api/health?refresh=1. undefined -> the flag is omitted.
335
+ const expectBeadsDep = deps.expectBeads;
336
+ const resolveExpectBeads = () => (typeof expectBeadsDep === 'function' ? expectBeadsDep() : expectBeadsDep);
337
+ // apra-fleet-k7b.3: optional same-instance child-exit notification (see
338
+ // the 'exit' listener below) and its injectable clock (test determinism,
339
+ // matching ledger.mjs/history.mjs's own `now` seam convention).
340
+ const onChildExit = deps.onChildExit;
341
+ const nowFn = deps.now ?? (() => new Date().toISOString());
342
+
343
+ /**
344
+ * Live sprints launched BY THIS supervisor process, keyed by child pid.
345
+ * This is only ever used to keep --viewer-port allocation unique within
346
+ * this process's lifetime; it is NOT the durable source of truth (that is
347
+ * eft.5's ledger, re-adopted across restarts by eft.4.5).
348
+ * @type {Map<number, { port: number, child: import('node:child_process').ChildProcess, logPath: string }>}
349
+ */
350
+ const live = new Map();
351
+
352
+ function livePortSet() {
353
+ return new Set(Array.from(live.values(), (entry) => entry.port));
354
+ }
355
+
356
+ /**
357
+ * Spawns one sprint as a detached `bin/cli.mjs` child with a freshly
358
+ * allocated, currently-unique `--viewer-port`.
359
+ *
360
+ * apra-fleet-ou7.1: the child's stdout+stderr are teed to a per-sprint
361
+ * raw log file (resolveSprintLogPath()) instead of `stdio: 'ignore'` --
362
+ * opened BEFORE spawning and handed to the child as a real fd (not a
363
+ * Node stream), so raw output is captured for the sprint's WHOLE
364
+ * lifetime, including whatever it wrote right before a crash. The
365
+ * file's own fd is a plain OS-level dup once spawn() hands it to the
366
+ * child, so this process's copy is safe to close the moment the child
367
+ * itself exits (or immediately, if spawn/the pid check fails) without
368
+ * losing anything the child is still writing.
369
+ * @param {object} opts - the sprint's cli.mjs flags (issue, members, branch, base, ...)
370
+ * @returns {Promise<{ pid: number, port: number, command: string, args: string[], logPath: string }>}
371
+ */
372
+ async function spawnSprint(opts = {}) {
373
+ const port = await allocateFreePort({ startPort: basePort, excludedPorts: livePortSet(), isAvailable });
374
+ const args = [cliPath, ...buildSprintArgv({
375
+ ...opts,
376
+ viewerPort: port,
377
+ serviceUrl: opts.serviceUrl ?? serviceUrl,
378
+ expectBeads: opts.expectBeads ?? resolveExpectBeads(),
379
+ })];
380
+
381
+ // apra-fleet-ou7.1: opts.runId is the SAME sprintId createSprintController
382
+ // generates and claims in the ledger BEFORE spawning (apra-fleet-k7b.1) --
383
+ // reused here (not re-derived) so the log file name and the ledger's
384
+ // sprintId key always agree. A direct/standalone spawnSprint() call with
385
+ // no runId (or a test) still gets a unique file via the randomUUID() fallback.
386
+ const logPath = resolveSprintLogPath(dataDir, opts.runId || `direct-${randomUUID()}`);
387
+ fsImpl.mkdirSync(path.dirname(logPath), { recursive: true });
388
+ const logFd = fsImpl.openSync(logPath, 'a');
389
+ let logFdClosed = false;
390
+ const closeLogFd = () => {
391
+ if (logFdClosed) return;
392
+ logFdClosed = true;
393
+ try {
394
+ fsImpl.closeSync(logFd);
395
+ } catch (err) {
396
+ logError(`[spawner] failed to close log fd for '${logPath}':`, err);
397
+ }
398
+ };
399
+
400
+ let child;
401
+ try {
402
+ child = spawnImpl(command, args, {
403
+ detached: true,
404
+ windowsHide: true,
405
+ stdio: ['ignore', logFd, logFd],
406
+ ...(deps.cwd !== undefined ? { cwd: deps.cwd } : {}),
407
+ ...(deps.env !== undefined ? { env: deps.env } : {}),
408
+ });
409
+ } catch (err) {
410
+ // Spawn itself threw synchronously (e.g. an injected fake spawn in
411
+ // a test) -- our copy of the fd is never handed off, close it now
412
+ // so a failed launch can never leak it.
413
+ closeLogFd();
414
+ throw err;
415
+ }
416
+
417
+ if (!child || typeof child.pid !== 'number') {
418
+ closeLogFd();
419
+ throw new Error('[spawner] spawn did not return a pid; sprint child process failed to launch');
420
+ }
421
+ const pid = child.pid;
422
+ live.set(pid, { port, child, logPath });
423
+
424
+ // Free this port for reuse and drop local bookkeeping once the child
425
+ // actually exits. This ONLY reacts to the child's own lifecycle --
426
+ // never to the supervisor's, and never to another child's.
427
+ //
428
+ // apra-fleet-k7b.3: also forward the exit code/signal (Node's own
429
+ // 'exit' event args) to the optional onChildExit callback, keyed by
430
+ // this launch's runId (the SAME sprintId createSprintController
431
+ // generates and claims in the ledger BEFORE spawning, apra-fleet-
432
+ // k7b.1) -- NOT re-derived here, so this stays a thin same-instance
433
+ // notification rather than owning ledger/history persistence itself
434
+ // (bin/serve.mjs's wiring does that). A throwing callback must never
435
+ // take down this listener's own bookkeeping cleanup above it.
436
+ //
437
+ // apra-fleet-ou7.1: this is also where the log fd is closed --
438
+ // acceptance criterion "file handles are closed on child exit (no fd
439
+ // leak across many launches)". The child has its own OS-level
440
+ // duplicated descriptor (dup2'd at spawn time), so closing OUR copy
441
+ // here never truncates or loses anything the child wrote, including
442
+ // its very last output before a crash.
443
+ child.once('exit', (code, signal) => {
444
+ live.delete(pid);
445
+ closeLogFd();
446
+ if (typeof onChildExit === 'function') {
447
+ try {
448
+ // Promise.resolve(...).catch(...) covers BOTH a synchronous
449
+ // throw and an async callback's rejected promise (bin/
450
+ // serve.mjs's real wiring is `async`) -- either way this
451
+ // listener's own bookkeeping cleanup above must never be
452
+ // affected, and no unhandled rejection should escape.
453
+ Promise.resolve(onChildExit({
454
+ pid,
455
+ runId: opts.runId ?? null,
456
+ exitCode: code ?? null,
457
+ signal: signal ?? null,
458
+ at: nowFn(),
459
+ logPath,
460
+ })).catch((err) => {
461
+ logError(`[spawner] onChildExit callback rejected for pid=${pid}:`, err);
462
+ });
463
+ } catch (err) {
464
+ logError(`[spawner] onChildExit callback threw for pid=${pid}:`, err);
465
+ }
466
+ }
467
+ });
468
+ child.once('error', (err) => {
469
+ logError(`[spawner] child pid=${pid} (issue=${opts.issue}) emitted error:`, err);
470
+ live.delete(pid);
471
+ // 'error' can fire instead of, or alongside, 'exit' -- closeLogFd()
472
+ // is idempotent, so whichever fires (or both) closes exactly once.
473
+ closeLogFd();
474
+ });
475
+
476
+ // CRITICAL (acceptance criterion): unref() so this child never keeps
477
+ // the supervisor's event loop alive on its account. Combined with
478
+ // `detached: true` (its own process group/session on POSIX), a
479
+ // supervisor SIGKILL/exit can never take this child down with it.
480
+ child.unref();
481
+
482
+ return { pid, port, command, args, logPath };
483
+ }
484
+
485
+ return {
486
+ name: 'spawner',
487
+ async start() {},
488
+ async stop() {
489
+ // Detached-orphan contract: tearing down the spawner/supervisor
490
+ // must NEVER kill a live sprint child. This only clears local
491
+ // bookkeeping -- the ledger (eft.5) is the durable, restart-
492
+ // surviving record of what is actually still live.
493
+ live.clear();
494
+ },
495
+
496
+ spawnSprint,
497
+
498
+ /**
499
+ * Registers a RE-ADOPTED child (apra-fleet-eft.4.5): a live process
500
+ * this supervisor instance did not itself spawn -- typically a sprint
501
+ * recovered by PID from the persisted ledger after a supervisor
502
+ * restart, whose --viewer-port has since been recovered from its own
503
+ * command line. This makes the pid known to getLiveEntry()/livePorts
504
+ * for exactly the same reasons a freshly-spawned child is: watchdog
505
+ * HTTP-reachability probing and API port resolution both key off this
506
+ * bookkeeping.
507
+ *
508
+ * There is no ChildProcess handle for a re-adopted pid (this process
509
+ * never spawned it), so unlike spawnSprint() no 'exit'/'error'
510
+ * listener is wired here -- nothing in this process can be notified
511
+ * the moment it exits. The watchdog's own periodic PID-liveness probe
512
+ * is what eventually detects the pid going away; adopt() itself does
513
+ * NOT re-verify liveness (the caller -- eft.4.5's re-adopter -- has
514
+ * already PID-probed via the restart reconciler before calling this).
515
+ * Idempotent: adopting the same pid again simply overwrites its port.
516
+ *
517
+ * apra-fleet-ou7.1: `logPath` is not recovered here (unlike --viewer-
518
+ * port, it is not on the re-adopted child's own command line) --
519
+ * consumers needing it for a re-adopted sprint read it from the
520
+ * ledger's own persisted reservation (recorded at the ORIGINAL
521
+ * claim/spawn, survives the restart), not from this in-memory entry.
522
+ * @param {number} pid
523
+ * @param {number} port
524
+ */
525
+ adopt(pid, port) {
526
+ if (!Number.isInteger(pid) || pid <= 0) {
527
+ throw new TypeError('adopt() requires a positive integer pid');
528
+ }
529
+ if (!Number.isInteger(port) || port <= 0 || port > 65535) {
530
+ throw new TypeError('adopt() requires an integer port in [1, 65535]');
531
+ }
532
+ live.set(pid, { port, child: null, logPath: null });
533
+ },
534
+
535
+ /** Number of sprints spawned by this process that haven't exited yet. */
536
+ get liveCount() { return live.size; },
537
+ /** The set of --viewer-port values currently in use by live sprints. */
538
+ get livePorts() { return livePortSet(); },
539
+ /** @param {number} pid */
540
+ getLiveEntry(pid) { return live.get(pid); },
541
+ };
542
+ }
@@ -0,0 +1,96 @@
1
+ // Self-vs-foreign classification for the reservation ledger entries that
2
+ // GET /api/sprints returns (api.mjs listSprints()).
3
+ //
4
+ // apra-fleet-5co8.37: the deploy runbook's active-sprints gate used to STOP on
5
+ // ANY non-empty `sprints` array. A sprint that dispatches its own deployer is
6
+ // itself in that ledger, so the gate always fired on the deploying sprint's OWN
7
+ // reservation and no sprint could ever deploy its own work. The deployer is now
8
+ // told its dispatching sprint's identity and uses this module to keep only
9
+ // GENUINELY foreign reservations as a stop condition.
10
+ //
11
+ // Identity comparison is EXACT (=== on the sprintId string, === on an integer
12
+ // childPid). It is deliberately never a substring/prefix match: a sprintId
13
+ // embeds its issue roots, so `includes()` would make two unrelated sprints on
14
+ // overlapping issue roots look like each other.
15
+
16
+ /**
17
+ * @typedef {object} SprintReservation
18
+ * @property {string} [sprintId] ledger reservation key (incarnation-unique)
19
+ * @property {number|null} [childPid] pid of the sprint child process, if known
20
+ */
21
+
22
+ /**
23
+ * @typedef {object} SprintSelfIdentity
24
+ * @property {string} [sprintId] the dispatching sprint's own reservation key
25
+ * @property {number} [childPid] the dispatching sprint's own child pid
26
+ */
27
+
28
+ /** @param {unknown} value @returns {string|null} */
29
+ function exactStringOrNull(value) {
30
+ return typeof value === 'string' && value.length > 0 ? value : null;
31
+ }
32
+
33
+ /** @param {unknown} value @returns {number|null} */
34
+ function exactPidOrNull(value) {
35
+ return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : null;
36
+ }
37
+
38
+ /**
39
+ * True when `reservation` is the caller's OWN reservation.
40
+ *
41
+ * Matching requires at least one exact identifier match. With no usable
42
+ * self-identity (neither a sprintId nor a childPid), NOTHING matches: an
43
+ * unidentified caller must treat every reservation as foreign, which preserves
44
+ * the old conservative stop-on-anything behavior.
45
+ *
46
+ * @param {SprintReservation} reservation
47
+ * @param {SprintSelfIdentity} [identity]
48
+ * @returns {boolean}
49
+ */
50
+ export function isSelfReservation(reservation, identity = {}) {
51
+ if (!reservation || typeof reservation !== 'object') return false;
52
+ const selfSprintId = exactStringOrNull(identity?.sprintId);
53
+ const selfChildPid = exactPidOrNull(identity?.childPid);
54
+ if (selfSprintId === null && selfChildPid === null) return false;
55
+
56
+ const resSprintId = exactStringOrNull(reservation.sprintId);
57
+ if (selfSprintId !== null && resSprintId !== null && resSprintId === selfSprintId) return true;
58
+
59
+ const resChildPid = exactPidOrNull(reservation.childPid);
60
+ if (selfChildPid !== null && resChildPid !== null && resChildPid === selfChildPid) return true;
61
+
62
+ return false;
63
+ }
64
+
65
+ /**
66
+ * Splits a GET /api/sprints `sprints` array into the caller's own reservations
67
+ * and genuinely foreign ones.
68
+ *
69
+ * `shouldStop` is the deploy gate's answer: stop only when at least one FOREIGN
70
+ * reservation is live. A list containing only the caller's own reservation(s)
71
+ * -- or an empty list -- lets the deploy proceed.
72
+ *
73
+ * @param {SprintReservation[]} sprints
74
+ * @param {SprintSelfIdentity} [identity]
75
+ * @returns {{ self: SprintReservation[], foreign: SprintReservation[], shouldStop: boolean }}
76
+ */
77
+ export function classifyActiveSprints(sprints, identity = {}) {
78
+ const list = Array.isArray(sprints) ? sprints : [];
79
+ /** @type {SprintReservation[]} */ const self = [];
80
+ /** @type {SprintReservation[]} */ const foreign = [];
81
+ for (const reservation of list) {
82
+ if (isSelfReservation(reservation, identity)) self.push(reservation);
83
+ else foreign.push(reservation);
84
+ }
85
+ return { self, foreign, shouldStop: foreign.length > 0 };
86
+ }
87
+
88
+ /**
89
+ * Convenience wrapper: just the foreign reservations.
90
+ * @param {SprintReservation[]} sprints
91
+ * @param {SprintSelfIdentity} [identity]
92
+ * @returns {SprintReservation[]}
93
+ */
94
+ export function selectForeignSprints(sprints, identity = {}) {
95
+ return classifyActiveSprints(sprints, identity).foreign;
96
+ }