@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,352 @@
1
+ // Who holds a local TCP port: used by `apra-fleet start`, the server's own
2
+ // startup and `apra-fleet install` when the configured port is already bound.
3
+ //
4
+ // Two Unix users on one host can each have a member install, but not on the
5
+ // same port: the server binds 127.0.0.1:<port> with no fallback. When the
6
+ // port is held by ANOTHER user's process, the operator must be told who holds
7
+ // it and how to fix it (give this install its own port), instead of a generic
8
+ // "port in use" -- or worse, sessions silently reaching the other user's
9
+ // server. A port held by this user's own apra-fleet for THIS data dir is the
10
+ // existing already-running reuse path (checkRunningInstance), decided before
11
+ // any of this runs.
12
+ //
13
+ // Everything here runs locally on the machine that owns the port (install,
14
+ // start and the server run ON the member), so the probes are built in
15
+ // JavaScript and run through Node -- never a member-bound shell string:
16
+ // - linux: /proc/net/tcp{,6} gives the listening socket's uid and inode for
17
+ // ANY user; the pid is found by matching the inode in /proc/<pid>/fd,
18
+ // which is only readable for this user's own processes (another user's pid
19
+ // is reported as not visible, never guessed);
20
+ // - macOS: lsof -iTCP:<port> -sTCP:LISTEN;
21
+ // - windows: Get-NetTCPConnection + the owning process's GetOwner(), run as
22
+ // an encoded PowerShell command (src/os/windows.ts wrapPowerShellEncoded).
23
+ // Every probe is best effort and never throws: an unknown holder falls back
24
+ // to the existing port-in-use message.
25
+ import fs from 'node:fs';
26
+ import os from 'node:os';
27
+ import { execFileSync, execSync } from 'node:child_process';
28
+ import { wrapPowerShellEncoded } from '../os/windows.js';
29
+ let probeOverride = null;
30
+ /** Test hook: replace the platform probe (null restores it). */
31
+ export function _setPortHolderProbeOverride(fn) {
32
+ probeOverride = fn;
33
+ }
34
+ const PROBE_TIMEOUT_MS = 8000;
35
+ /** The process holding a LISTEN socket on `port`, or null when unknown. Never throws. */
36
+ export async function findPortHolder(port) {
37
+ try {
38
+ if (probeOverride)
39
+ return await probeOverride(port);
40
+ if (process.platform === 'linux')
41
+ return linuxPortHolder(port);
42
+ if (process.platform === 'darwin')
43
+ return lsofPortHolder(port);
44
+ if (process.platform === 'win32')
45
+ return windowsPortHolder(port);
46
+ return null;
47
+ }
48
+ catch {
49
+ return null;
50
+ }
51
+ }
52
+ // ---------------------------------------------------------------------------
53
+ // linux
54
+ // ---------------------------------------------------------------------------
55
+ /** Parse /proc/net/tcp(6) text: the uid and inode of the LISTEN socket on `port`. */
56
+ export function parseProcNetTcp(text, port) {
57
+ const portHex = port.toString(16).toUpperCase().padStart(4, '0');
58
+ for (const line of text.split('\n').slice(1)) {
59
+ const f = line.trim().split(/\s+/);
60
+ if (f.length < 10)
61
+ continue;
62
+ const local = f[1];
63
+ const state = f[3];
64
+ if (state !== '0A')
65
+ continue; // TCP_LISTEN
66
+ if (local.slice(local.lastIndexOf(':') + 1).toUpperCase() !== portHex)
67
+ continue;
68
+ const uid = Number(f[7]);
69
+ if (!Number.isInteger(uid))
70
+ continue;
71
+ return { uid, inode: f[9] };
72
+ }
73
+ return null;
74
+ }
75
+ /** Login name for a uid from /etc/passwd text, or undefined. */
76
+ export function userFromPasswd(text, uid) {
77
+ for (const line of text.split('\n')) {
78
+ const f = line.split(':');
79
+ if (f.length >= 3 && Number(f[2]) === uid && f[0])
80
+ return f[0];
81
+ }
82
+ return undefined;
83
+ }
84
+ function linuxUserName(uid) {
85
+ try {
86
+ const u = userFromPasswd(fs.readFileSync('/etc/passwd', 'utf8'), uid);
87
+ if (u)
88
+ return u;
89
+ }
90
+ catch { /* fall through to getent (LDAP/NSS users) */ }
91
+ try {
92
+ const out = execFileSync('getent', ['passwd', String(uid)], { encoding: 'utf8', timeout: PROBE_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true });
93
+ return userFromPasswd(String(out), uid);
94
+ }
95
+ catch {
96
+ return undefined;
97
+ }
98
+ }
99
+ function linuxPidForInode(inode) {
100
+ const target = `socket:[${inode}]`;
101
+ let pids;
102
+ try {
103
+ pids = fs.readdirSync('/proc').filter(d => /^\d+$/.test(d));
104
+ }
105
+ catch {
106
+ return undefined;
107
+ }
108
+ for (const pid of pids) {
109
+ let fds;
110
+ try {
111
+ fds = fs.readdirSync(`/proc/${pid}/fd`);
112
+ }
113
+ catch {
114
+ continue;
115
+ } // another user's process
116
+ for (const fd of fds) {
117
+ try {
118
+ if (fs.readlinkSync(`/proc/${pid}/fd/${fd}`) === target)
119
+ return Number(pid);
120
+ }
121
+ catch { /* closed meanwhile */ }
122
+ }
123
+ }
124
+ return undefined;
125
+ }
126
+ function linuxCommand(pid) {
127
+ try {
128
+ return fs.readFileSync(`/proc/${pid}/comm`, 'utf8').trim() || undefined;
129
+ }
130
+ catch {
131
+ return undefined;
132
+ }
133
+ }
134
+ function linuxPortHolder(port) {
135
+ let hit = null;
136
+ for (const f of ['/proc/net/tcp', '/proc/net/tcp6']) {
137
+ try {
138
+ hit = parseProcNetTcp(fs.readFileSync(f, 'utf8'), port);
139
+ }
140
+ catch {
141
+ hit = null;
142
+ }
143
+ if (hit)
144
+ break;
145
+ }
146
+ if (!hit)
147
+ return null;
148
+ const pid = linuxPidForInode(hit.inode);
149
+ const user = linuxUserName(hit.uid);
150
+ const command = pid !== undefined ? linuxCommand(pid) : undefined;
151
+ return { uid: hit.uid, ...(user ? { user } : {}), ...(pid !== undefined ? { pid } : {}), ...(command ? { command } : {}) };
152
+ }
153
+ // ---------------------------------------------------------------------------
154
+ // macOS
155
+ // ---------------------------------------------------------------------------
156
+ /** Parse `lsof -F pcLu` output: the first process record. */
157
+ export function parseLsofFields(out) {
158
+ const h = {};
159
+ for (const line of out.split('\n')) {
160
+ const tag = line[0];
161
+ const v = line.slice(1).trim();
162
+ if (!v)
163
+ continue;
164
+ if (tag === 'p') {
165
+ if (h.pid !== undefined)
166
+ break;
167
+ h.pid = Number(v);
168
+ }
169
+ else if (tag === 'c' && !h.command)
170
+ h.command = v;
171
+ else if (tag === 'L' && !h.user)
172
+ h.user = v;
173
+ else if (tag === 'u' && h.uid === undefined)
174
+ h.uid = Number(v);
175
+ }
176
+ return h.pid !== undefined || h.user ? h : null;
177
+ }
178
+ /** macOS probe (exported with an exec seam for tests). */
179
+ export function lsofPortHolder(port, exec = execFileSync) {
180
+ try {
181
+ const out = exec('lsof', ['-nP', `-iTCP:${port}`, '-sTCP:LISTEN', '-FpcLu'], {
182
+ encoding: 'utf8', timeout: PROBE_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
183
+ });
184
+ return parseLsofFields(String(out));
185
+ }
186
+ catch (err) {
187
+ // lsof ran but listed nothing (exit 1, no output): a non-root lsof lists
188
+ // every socket of THIS user, so a bound port it cannot see is held by
189
+ // another OS user (or root). Only called once the port is known bound.
190
+ const e = err;
191
+ if (e.code !== 'ENOENT' && e.status === 1 && !String(e.stdout ?? '').trim())
192
+ return { otherUser: true };
193
+ return null;
194
+ }
195
+ }
196
+ // ---------------------------------------------------------------------------
197
+ // windows
198
+ // ---------------------------------------------------------------------------
199
+ /** The PowerShell probe (wrapped with wrapPowerShellEncoded before it runs). */
200
+ export function windowsPortHolderScript(port) {
201
+ const p = Math.trunc(port);
202
+ return `$c = Get-NetTCPConnection -State Listen -LocalPort ${p} -ErrorAction SilentlyContinue | Select-Object -First 1; `
203
+ + `if ($c) { $procId = [int]$c.OwningProcess; $proc = Get-CimInstance Win32_Process -Filter ('ProcessId=' + $procId) -ErrorAction SilentlyContinue; `
204
+ + `$owner = $null; if ($proc) { try { $owner = Invoke-CimMethod -InputObject $proc -MethodName GetOwner -ErrorAction Stop } catch { $owner = $null } }; `
205
+ + `[Console]::Out.Write((@{ pid = $procId; name = $(if ($proc) { $proc.Name } else { $null }); user = $(if ($owner) { $owner.User } else { $null }) } | ConvertTo-Json -Compress)) }`;
206
+ }
207
+ /** Parse the PowerShell probe's JSON line. */
208
+ export function parseWindowsPortHolder(out) {
209
+ const line = out.trim().split(/\r?\n/).filter(Boolean).pop();
210
+ if (!line)
211
+ return null;
212
+ try {
213
+ const j = JSON.parse(line);
214
+ const pid = typeof j.pid === 'number' && j.pid > 0 ? j.pid : undefined;
215
+ const user = typeof j.user === 'string' && j.user ? j.user : undefined;
216
+ const command = typeof j.name === 'string' && j.name ? j.name : undefined;
217
+ if (pid === undefined && !user)
218
+ return null;
219
+ return { ...(pid !== undefined ? { pid } : {}), ...(user ? { user } : {}), ...(command ? { command } : {}) };
220
+ }
221
+ catch {
222
+ return null;
223
+ }
224
+ }
225
+ /** Windows probe (exported with seams for tests). */
226
+ export function windowsPortHolder(port, runProbe = (cmd) => String(execSync(cmd, {
227
+ encoding: 'utf8', timeout: PROBE_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
228
+ }) ?? ''), kill) {
229
+ try {
230
+ const holder = parseWindowsPortHolder(runProbe(wrapPowerShellEncoded(windowsPortHolderScript(port))));
231
+ if (holder) {
232
+ // GetOwner on another user's process returns access denied without
233
+ // throwing, leaving no user: classify the pid by signal 0 instead.
234
+ if (!holder.user && holder.pid !== undefined) {
235
+ const otherUser = pidOwnedByOtherUser(holder.pid, kill);
236
+ if (otherUser !== undefined)
237
+ holder.otherUser = otherUser;
238
+ }
239
+ return holder;
240
+ }
241
+ }
242
+ catch { /* CIM denied (standard user on a network/SSH logon): fall back below */ }
243
+ return netstatPortHolder(port, undefined, kill);
244
+ }
245
+ /**
246
+ * Pid of the LISTEN socket on `port` from `netstat -ano -p TCP` (no CIM/WMI,
247
+ * so it works for a standard user over SSH). The state column is localized,
248
+ * so a listener is recognised by its unbound foreign address instead.
249
+ */
250
+ export function parseNetstatListenPid(out, port) {
251
+ for (const line of out.split(/\r?\n/)) {
252
+ const f = line.trim().split(/\s+/);
253
+ if (f.length < 5 || f[0].toUpperCase() !== 'TCP')
254
+ continue;
255
+ if (!f[1].endsWith(`:${port}`))
256
+ continue;
257
+ if (!/^(0\.0\.0\.0|\[::\]):0$/.test(f[2]))
258
+ continue;
259
+ const pid = Number(f[f.length - 1]);
260
+ if (Number.isInteger(pid) && pid > 0)
261
+ return pid;
262
+ }
263
+ return undefined;
264
+ }
265
+ /** Whether `pid` belongs to another user: signal 0 is refused (EPERM) for one. */
266
+ export function pidOwnedByOtherUser(pid, kill = (p, s) => process.kill(p, s)) {
267
+ try {
268
+ kill(pid, 0);
269
+ return false;
270
+ }
271
+ catch (err) {
272
+ return err.code === 'EPERM' ? true : undefined;
273
+ }
274
+ }
275
+ /** Windows CIM-free fallback probe (exported with seams for tests). */
276
+ export function netstatPortHolder(port, exec = execFileSync, kill) {
277
+ try {
278
+ const out = exec('netstat', ['-ano', '-p', 'TCP'], {
279
+ encoding: 'utf8', timeout: PROBE_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
280
+ });
281
+ const pid = parseNetstatListenPid(String(out), port);
282
+ if (pid === undefined)
283
+ return null;
284
+ const otherUser = pidOwnedByOtherUser(pid, kill);
285
+ return { pid, ...(otherUser !== undefined ? { otherUser } : {}) };
286
+ }
287
+ catch {
288
+ return null;
289
+ }
290
+ }
291
+ // ---------------------------------------------------------------------------
292
+ // classification and messages
293
+ // ---------------------------------------------------------------------------
294
+ /** This process's user (name and, on POSIX, uid). */
295
+ export function currentUser() {
296
+ let user;
297
+ try {
298
+ user = os.userInfo().username;
299
+ }
300
+ catch { /* unknown */ }
301
+ const uid = typeof process.getuid === 'function' ? process.getuid() : undefined;
302
+ return { ...(user ? { user } : {}), ...(uid !== undefined ? { uid } : {}) };
303
+ }
304
+ /**
305
+ * True when the holder belongs to a different user than `me`, false when it
306
+ * is the same user, undefined when that cannot be told. uid wins over the
307
+ * name when both sides have one; names compare case-insensitively (Windows).
308
+ */
309
+ export function heldByOtherUser(holder, me = currentUser()) {
310
+ if (holder.uid !== undefined && me.uid !== undefined)
311
+ return holder.uid !== me.uid;
312
+ if (holder.user && me.user)
313
+ return holder.user.toLowerCase() !== me.user.toLowerCase();
314
+ return holder.otherUser;
315
+ }
316
+ /** Machine-readable code on the refusal when another user holds the port. */
317
+ export const PORT_HELD_BY_OTHER_USER_CODE = 'E-PORT-HELD-BY-OTHER-USER';
318
+ function holderPhrase(holder) {
319
+ const who = holder.user ?? (holder.uid !== undefined ? `uid ${holder.uid}` : 'an unknown user');
320
+ const pid = holder.pid !== undefined ? `pid ${holder.pid}` : 'pid not visible to this user';
321
+ const whose = !holder.user && holder.uid === undefined && holder.otherUser ? 'another OS user' : `user "${who}"`;
322
+ return `${whose} (${pid}${holder.command ? `, ${holder.command}` : ''})`;
323
+ }
324
+ /** The refusal when ANOTHER user's process holds the port: who, pid, remedy.
325
+ * A member install can move to its own recorded port; a full install's
326
+ * service is not given a custom port, so its remedy is freeing the port. */
327
+ export function portHeldByOtherUserMessage(port, holder, installKind, me = currentUser()) {
328
+ const self = me.user ? ` (this is "${me.user}")` : '';
329
+ const remedy = installKind === 'member'
330
+ ? 'Remedy: give this member install its own port -- re-run "apra-fleet install --member --port <free port>"; '
331
+ + 'the fleet picks up the new port on its next fleet_install "auto" probe.'
332
+ : `Remedy: that user stops their apra-fleet server ("apra-fleet stop", or "apra-fleet uninstall" to remove it), then re-run the install. `
333
+ + 'A full install\'s service binds the port its last install recorded (APRA_FLEET_PORT at install time, else the default): '
334
+ + 'to change it, re-run "apra-fleet install" with APRA_FLEET_PORT set to a free port.';
335
+ return `${PORT_HELD_BY_OTHER_USER_CODE}: port ${port} on 127.0.0.1 is held by ${holderPhrase(holder)}, another user's process${self}. `
336
+ + 'apra-fleet will not share or take over another user\'s server. '
337
+ + remedy;
338
+ }
339
+ /**
340
+ * The full operator message for a configured port that is taken, given the
341
+ * generic port-in-use text. Another user's holder -> the refusal above (with
342
+ * `foreign: true`); otherwise the generic text plus the holder when known.
343
+ */
344
+ export function describePortConflict(port, genericMessage, holder, installKind, me = currentUser()) {
345
+ if (holder && heldByOtherUser(holder, me) === true) {
346
+ return { foreign: true, message: portHeldByOtherUserMessage(port, holder, installKind, me) };
347
+ }
348
+ if (holder)
349
+ return { foreign: false, message: `${genericMessage} Holder: ${holderPhrase(holder)}.` };
350
+ return { foreign: false, message: genericMessage };
351
+ }
352
+ //# sourceMappingURL=port-holder.js.map
@@ -133,6 +133,8 @@ export async function preflightCheck(agent, options) {
133
133
  authEnvVarSet.add(provider.authEnvVarForToken('sk-ant-probe'));
134
134
  authEnvVarSet.add(provider.authEnvVarForToken('non-sk-ant-probe'));
135
135
  }
136
+ for (const name of provider.authEnvVarNames?.() ?? [])
137
+ authEnvVarSet.add(name);
136
138
  // R3 regression fix: providers with no env-var-based auth (e.g. OpenCode,
137
139
  // whose authEnvVar/authEnvVarForToken always return '') would otherwise
138
140
  // populate authEnvVars with ''. getOsCommands(...).apiKeyCheck('') builds a
@@ -1,9 +1,14 @@
1
- import type { Agent } from '../types.js';
1
+ import type { Agent, FleetMcpStatus } from '../types.js';
2
2
  export declare function getAllAgents(): Agent[];
3
3
  export declare function getAgent(id: string): Agent | undefined;
4
4
  export declare function findAgentByName(name: string): Agent | undefined;
5
5
  export declare function addAgent(agent: Agent): void;
6
6
  export declare function updateAgent(id: string, updates: Partial<Agent>): Agent | undefined;
7
+ /** Record the latest fleetMcp observation for a member (overwrites; never sticky),
8
+ * except that the CURRENT fleetInstalledAt stamp is carried forward unless the
9
+ * new status sets its own -- it is the only signal this fleet installed the
10
+ * member, and observation-only writers (compose errors) must not drop it. */
11
+ export declare function recordFleetMcpStatus(id: string, status: FleetMcpStatus): Agent | undefined;
7
12
  export declare function removeAgent(id: string): boolean;
8
13
  export declare function getKeysDir(): string;
9
14
  /**
@@ -13,7 +18,13 @@ export declare function getKeysDir(): string;
13
18
  * - Relay agents: no check -- the folder is a path on the RELAYED machine,
14
19
  * not this machine's own filesystem, so there's no local duplicate-folder
15
20
  * concept to enforce here (apra-fleet-jfn).
21
+ * - When `llmProvider` is given, a folder may hold at most one LLM member and
22
+ * at most one LLM-less (llm_provider 'none') member: only members of the
23
+ * SAME kind clash. The rule exists so two agents never edit one checkout;
24
+ * an LLM-less command executor (e.g. a supervisor's backlog member running
25
+ * bd) is not an agent. Omitting `llmProvider` keeps the strict any-member
26
+ * check.
16
27
  * Returns true if a duplicate exists.
17
28
  */
18
- export declare function hasDuplicateFolder(agentType: 'local' | 'remote' | 'relay', folder: string, host?: string, port?: number, excludeId?: string): boolean;
29
+ export declare function hasDuplicateFolder(agentType: 'local' | 'remote' | 'relay', folder: string, host?: string, port?: number, excludeId?: string, llmProvider?: string): boolean;
19
30
  //# sourceMappingURL=registry.d.ts.map
@@ -102,6 +102,23 @@ export function updateAgent(id, updates) {
102
102
  saveRegistry(registry);
103
103
  return registry.agents[idx];
104
104
  }
105
+ /** Record the latest fleetMcp observation for a member (overwrites; never sticky),
106
+ * except that the CURRENT fleetInstalledAt stamp is carried forward unless the
107
+ * new status sets its own -- it is the only signal this fleet installed the
108
+ * member, and observation-only writers (compose errors) must not drop it. */
109
+ export function recordFleetMcpStatus(id, status) {
110
+ const stamp = status.fleetInstalledAt ?? getAgent(id)?.fleetMcp?.fleetInstalledAt;
111
+ const fleetMcp = stamp ? { ...status, fleetInstalledAt: stamp } : status;
112
+ // The member's MCP port is persisted only from a probe that resolved it: a
113
+ // probe that failed before reading the member's install keeps the recorded
114
+ // port (falling back to the default there would point sessions at whatever
115
+ // else listens on it).
116
+ if (status.portSource === 'marker' && status.port !== undefined)
117
+ return updateAgent(id, { fleetMcp, memberMcpPort: status.port });
118
+ if (status.portSource === 'default')
119
+ return updateAgent(id, { fleetMcp, memberMcpPort: undefined });
120
+ return updateAgent(id, { fleetMcp });
121
+ }
105
122
  export function removeAgent(id) {
106
123
  const registry = loadRegistry();
107
124
  const before = registry.agents.length;
@@ -136,17 +153,26 @@ function normalizeFolderPath(folder) {
136
153
  * - Relay agents: no check -- the folder is a path on the RELAYED machine,
137
154
  * not this machine's own filesystem, so there's no local duplicate-folder
138
155
  * concept to enforce here (apra-fleet-jfn).
156
+ * - When `llmProvider` is given, a folder may hold at most one LLM member and
157
+ * at most one LLM-less (llm_provider 'none') member: only members of the
158
+ * SAME kind clash. The rule exists so two agents never edit one checkout;
159
+ * an LLM-less command executor (e.g. a supervisor's backlog member running
160
+ * bd) is not an agent. Omitting `llmProvider` keeps the strict any-member
161
+ * check.
139
162
  * Returns true if a duplicate exists.
140
163
  */
141
- export function hasDuplicateFolder(agentType, folder, host, port, excludeId) {
164
+ export function hasDuplicateFolder(agentType, folder, host, port, excludeId, llmProvider) {
142
165
  const agents = getAllAgents();
143
166
  const normalizedFolder = normalizeFolderPath(folder);
167
+ const isLlmLess = (p) => (p ?? 'claude') === 'none';
144
168
  for (const agent of agents) {
145
169
  if (excludeId && agent.id === excludeId)
146
170
  continue;
147
171
  const agentFolder = normalizeFolderPath(agent.workFolder);
148
172
  if (agentFolder !== normalizedFolder)
149
173
  continue;
174
+ if (llmProvider !== undefined && isLlmLess(llmProvider) !== isLlmLess(agent.llmProvider))
175
+ continue;
150
176
  if (agentType === 'local' && agent.agentType === 'local') {
151
177
  return true;
152
178
  }
@@ -9,6 +9,8 @@ export declare class RelayStrategy implements AgentStrategy {
9
9
  transferFiles(localPaths: string[], destinationPath?: string, abortSignal?: AbortSignal): Promise<TransferResult>;
10
10
  receiveFiles(): Promise<TransferResult>;
11
11
  deleteFiles(): Promise<void>;
12
+ writeSecretFile(): Promise<string>;
13
+ removeSecretFile(): Promise<void>;
12
14
  testConnection(): Promise<{
13
15
  ok: boolean;
14
16
  latencyMs: number;
@@ -93,6 +93,14 @@ export class RelayStrategy {
93
93
  async deleteFiles() {
94
94
  throw new Error('File deletion over relay is not yet supported (apra-fleet-jfn follow-on).');
95
95
  }
96
+ // No relay channel delivers a file to a known absolute path without a
97
+ // command line, so a stored credential cannot reach a relay member safely.
98
+ // Fail loudly rather than fall back to an inline (argv-visible) value;
99
+ // member-secret-env.ts wraps this in a SecretDeliveryError with the remedy.
100
+ async writeSecretFile() {
101
+ throw new Error('the relay transport has no file channel to a known path');
102
+ }
103
+ async removeSecretFile() { }
96
104
  async testConnection() {
97
105
  const start = Date.now();
98
106
  try {
@@ -0,0 +1,26 @@
1
+ export type ShutdownReason = 'SIGINT' | 'SIGTERM' | 'SIGHUP' | 'SIGBREAK' | 'http_shutdown' | 'shutdown_server' | 'uncaughtException' | 'unhandledRejection';
2
+ /**
3
+ * Append the shutdown record once per process (the first reason wins: e.g.
4
+ * POST /shutdown re-enters the SIGINT path, which must not add a second line).
5
+ * Synchronous -- the line is on disk when this returns.
6
+ */
7
+ export declare function recordShutdown(reason: ShutdownReason, detail?: Record<string, unknown>): void;
8
+ /** Test hook: forget that a record was written. */
9
+ export declare function _resetShutdownRecordForTests(): void;
10
+ /** Signals that end a server, per platform. SIGBREAK exists only on Windows. */
11
+ export declare function shutdownSignals(platform?: NodeJS.Platform): NodeJS.Signals[];
12
+ type ProcLike = Pick<NodeJS.Process, 'on' | 'off'>;
13
+ /**
14
+ * Wire every exit path to recordShutdown. `onSignal` runs the server's own
15
+ * graceful shutdown (which ends in process.exit). Returns an uninstaller.
16
+ */
17
+ export interface ShutdownHandlerOptions {
18
+ /** Hard deadline for the graceful shutdown after the first signal (unref'd). */
19
+ forceExitMs?: number;
20
+ /** Injectable for tests. */
21
+ exit?: (code: number) => void;
22
+ }
23
+ export declare const SHUTDOWN_FORCE_EXIT_MS = 10000;
24
+ export declare function installShutdownHandlers(onSignal: (reason: ShutdownReason) => void, proc?: ProcLike, platform?: NodeJS.Platform, options?: ShutdownHandlerOptions): () => void;
25
+ export {};
26
+ //# sourceMappingURL=server-lifecycle.d.ts.map
@@ -0,0 +1,85 @@
1
+ /**
2
+ * Server exit bookkeeping (GitHub #585).
3
+ *
4
+ * Every observable exit path of a fleet server appends exactly ONE
5
+ * {"tag":"shutdown","reason":...} record to fleet-<pid>.log, synchronously,
6
+ * before the process exits -- so a server that vanished can be told apart
7
+ * from one that was asked to stop (and status/start can report the former,
8
+ * see describeUncleanExit in singleton.ts).
9
+ *
10
+ * Paths: SIGINT, SIGTERM, SIGHUP, SIGBREAK (Windows console Ctrl+Break;
11
+ * SIGTERM never arrives on Windows), POST /shutdown, the shutdown_server
12
+ * tool, and crashes (uncaughtException / unhandledRejection). Crashes are
13
+ * observed via 'uncaughtExceptionMonitor', which runs BEFORE Node's default
14
+ * crash handling without replacing it -- the process still prints the error
15
+ * and exits 1 exactly as before.
16
+ */
17
+ import { appendLogRecord, maskSecrets } from '../utils/log-helpers.js';
18
+ let recorded = false;
19
+ /**
20
+ * Append the shutdown record once per process (the first reason wins: e.g.
21
+ * POST /shutdown re-enters the SIGINT path, which must not add a second line).
22
+ * Synchronous -- the line is on disk when this returns.
23
+ */
24
+ export function recordShutdown(reason, detail) {
25
+ if (recorded)
26
+ return;
27
+ recorded = true;
28
+ const crash = reason === 'uncaughtException' || reason === 'unhandledRejection';
29
+ appendLogRecord(crash ? 'error' : 'info', { tag: 'shutdown', reason, pid: process.pid, ...(detail ?? {}) });
30
+ }
31
+ /** Test hook: forget that a record was written. */
32
+ export function _resetShutdownRecordForTests() {
33
+ recorded = false;
34
+ }
35
+ /** Signals that end a server, per platform. SIGBREAK exists only on Windows. */
36
+ export function shutdownSignals(platform = process.platform) {
37
+ const sigs = ['SIGINT', 'SIGTERM', 'SIGHUP'];
38
+ if (platform === 'win32')
39
+ sigs.push('SIGBREAK');
40
+ return sigs;
41
+ }
42
+ export const SHUTDOWN_FORCE_EXIT_MS = 10_000;
43
+ export function installShutdownHandlers(onSignal, proc = process, platform = process.platform, options = {}) {
44
+ const removers = [];
45
+ const exit = options.exit ?? ((code) => process.exit(code));
46
+ const forceExitMs = options.forceExitMs ?? SHUTDOWN_FORCE_EXIT_MS;
47
+ let shuttingDown = false;
48
+ let forceTimer;
49
+ const forceExit = (why) => {
50
+ appendLogRecord('warn', { tag: 'shutdown_forced', reason: why, pid: process.pid });
51
+ exit(1);
52
+ };
53
+ removers.push(() => { if (forceTimer)
54
+ clearTimeout(forceTimer); });
55
+ for (const sig of shutdownSignals(platform)) {
56
+ const handler = () => {
57
+ // A graceful shutdown can hang (e.g. handle.close() waiting on open
58
+ // connections) where SIGHUP/SIGBREAK used to just end the process: a
59
+ // second signal exits at once, and an unref'd deadline bounds the wait.
60
+ if (shuttingDown) {
61
+ forceExit(`second ${sig}`);
62
+ return;
63
+ }
64
+ shuttingDown = true;
65
+ recordShutdown(sig);
66
+ forceTimer = setTimeout(() => forceExit(`graceful shutdown exceeded ${forceExitMs}ms`), forceExitMs);
67
+ forceTimer.unref();
68
+ onSignal(sig);
69
+ };
70
+ proc.on(sig, handler);
71
+ removers.push(() => proc.off(sig, handler));
72
+ }
73
+ const monitor = (err, origin) => {
74
+ const e = err;
75
+ const message = typeof e?.message === 'string' ? e.message : String(err);
76
+ recordShutdown(origin === 'unhandledRejection' ? 'unhandledRejection' : 'uncaughtException', {
77
+ error: maskSecrets(message).slice(0, 2000),
78
+ });
79
+ };
80
+ proc.on('uncaughtExceptionMonitor', monitor);
81
+ removers.push(() => proc.off('uncaughtExceptionMonitor', monitor));
82
+ return () => { for (const r of removers)
83
+ r(); };
84
+ }
85
+ //# sourceMappingURL=server-lifecycle.js.map
@@ -1,5 +1,11 @@
1
1
  import type { ServiceManager, ServiceStatus } from './types.js';
2
2
  export type { ServiceManager, ServiceStatus };
3
- export declare function gracefulStopByServerJson(fallbackKill?: (pid: number) => void): Promise<void>;
3
+ /**
4
+ * Graceful stop via server.json: POST /shutdown, then force-kill a verified
5
+ * apra-fleet pid. Resolves false when the server was left running because its
6
+ * pid could not be verified as apra-fleet; true otherwise (stopped, or nothing
7
+ * to stop).
8
+ */
9
+ export declare function gracefulStopByServerJson(fallbackKill?: (pid: number) => void): Promise<boolean>;
4
10
  export declare function getServiceManager(): Promise<ServiceManager>;
5
11
  //# sourceMappingURL=index.d.ts.map
@@ -1,25 +1,37 @@
1
1
  import fs from 'node:fs';
2
2
  import { SERVER_INFO_PATH } from '../../paths.js';
3
- import { isPidAlive, postShutdown } from '../../utils/process-utils.js';
3
+ import { isApraFleetProcess, isPidAlive, postShutdown } from '../../utils/process-utils.js';
4
+ /**
5
+ * Graceful stop via server.json: POST /shutdown, then force-kill a verified
6
+ * apra-fleet pid. Resolves false when the server was left running because its
7
+ * pid could not be verified as apra-fleet; true otherwise (stopped, or nothing
8
+ * to stop).
9
+ */
4
10
  export async function gracefulStopByServerJson(fallbackKill) {
5
11
  let info;
6
12
  try {
7
13
  info = JSON.parse(fs.readFileSync(SERVER_INFO_PATH, 'utf8'));
8
14
  }
9
15
  catch {
10
- return;
16
+ return true;
11
17
  }
12
18
  const { pid, url } = info;
13
19
  if (!pid || !url)
14
- return;
20
+ return true;
15
21
  if (!isPidAlive(pid))
16
- return;
22
+ return true;
17
23
  await postShutdown(url);
18
24
  const deadline = Date.now() + 5000;
19
25
  while (isPidAlive(pid) && Date.now() < deadline) {
20
26
  await new Promise(resolve => setTimeout(resolve, 500));
21
27
  }
22
28
  if (isPidAlive(pid)) {
29
+ // GitHub #584 review: never force-kill a reused pid that is no longer an
30
+ // apra-fleet server; leave server.json for the operator to inspect.
31
+ if (isApraFleetProcess(pid) !== true) {
32
+ console.error(`Server pid ${pid} did not exit after /shutdown and could not be verified as an apra-fleet process -- not force-killing it.`);
33
+ return false;
34
+ }
23
35
  if (fallbackKill) {
24
36
  fallbackKill(pid);
25
37
  }
@@ -34,6 +46,7 @@ export async function gracefulStopByServerJson(fallbackKill) {
34
46
  fs.unlinkSync(SERVER_INFO_PATH);
35
47
  }
36
48
  catch { }
49
+ return true;
37
50
  }
38
51
  class NoopServiceManager {
39
52
  async register(_binaryPath, _args, _logPath) { }
@@ -3,7 +3,7 @@ export declare class LinuxServiceManager implements ServiceManager {
3
3
  register(binaryPath: string, args: string[], logPath: string): Promise<void>;
4
4
  unregister(): Promise<void>;
5
5
  start(): Promise<void>;
6
- stop(): Promise<void>;
6
+ stop(): Promise<boolean>;
7
7
  query(): Promise<ServiceStatus>;
8
8
  isInstalled(): Promise<boolean>;
9
9
  }