@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
@@ -19,19 +19,23 @@ export const WORKFLOWS_DIR = path.join(FLEET_BASE, 'workflows');
19
19
  // current generation automatically, so they never go stale as Anthropic
20
20
  // ships new models. Other providers' CLIs don't share this alias support,
21
21
  // so their entries stay pinned to literal model IDs.
22
- // gemini-3.5-flash(-lite) remain here because they are AGY's (Antigravity's)
23
- // own model ids, not the removed gemini provider's -- AGY is built on
24
- // Google's Gemini stack and inherits its model catalog. See agy.ts's
25
- // modelTiers()/modelForTier().
22
+ // The gemini-*/claude-*-thinking entries are AGY's (Antigravity's) own model
23
+ // ids, not the removed gemini provider's -- AGY is built on Google's Gemini
24
+ // stack and inherits its model catalog. They are the STABLE slug ids `agy
25
+ // models` prints, and must stay in step with AGY_MODEL_FOR_TIER in
26
+ // src/providers/agy.ts: a slug AGY does not recognize is not a soft fallback,
27
+ // it fails the dispatch outright with "invalid model selection".
26
28
  export const CURATED_CHEAP_MODELS = [
27
29
  'gpt-oss-120b',
28
30
  'gpt-120',
29
- 'gemini-3.5-flash-lite',
31
+ 'gemini-3.8-flash-low',
30
32
  'haiku',
31
33
  'gpt-5.4-mini',
32
34
  ];
33
35
  export const CURATED_STANDARD_MODELS = [
34
- 'gemini-3.5-flash',
36
+ 'gemini-3.8-flash-high',
37
+ 'gemini-3.8-flash-medium',
38
+ 'gemini-3.1-pro-low',
35
39
  'gpt-oss-120b',
36
40
  'gpt-120',
37
41
  'sonnet',
@@ -40,61 +44,67 @@ export const CURATED_STANDARD_MODELS = [
40
44
  export const CURATED_PREMIUM_MODELS = [
41
45
  'sonnet',
42
46
  'opus',
47
+ 'gemini-3.1-pro-high',
48
+ 'claude-opus-4-6-thinking',
43
49
  'gpt-oss-120b',
44
50
  ];
45
51
  export const PROVIDER_STANDARD_MODELS = {
46
52
  claude: 'sonnet',
47
53
  codex: 'gpt-5.4',
48
54
  copilot: 'claude-sonnet-4-5',
49
- agy: 'gemini-3.5-flash',
55
+ agy: 'gemini-3.8-flash-high',
50
56
  opencode: 'ollama/qwen3-coder:30b',
51
57
  };
52
- export function getProviderInstallConfig(provider) {
58
+ /** Supported install targets, in deterministic profile-discovery fallback order. */
59
+ export const INSTALLABLE_LLM_PROVIDERS = [
60
+ 'claude', 'codex', 'copilot', 'agy', 'opencode',
61
+ ];
62
+ export function getProviderInstallConfig(provider, homeDir = home) {
53
63
  switch (provider) {
54
64
  case 'agy':
55
65
  return {
56
- configDir: path.join(home, '.gemini', 'antigravity-cli'),
57
- settingsFile: path.join(home, '.gemini', 'antigravity-cli', 'settings.json'),
58
- skillsDir: path.join(home, '.gemini', 'antigravity-cli', 'skills', 'pm'),
59
- fleetSkillsDir: path.join(home, '.gemini', 'antigravity-cli', 'skills', 'fleet'),
60
- agentsDir: path.join(home, '.gemini', 'antigravity-cli', 'agents'),
66
+ configDir: path.join(homeDir, '.gemini', 'antigravity-cli'),
67
+ settingsFile: path.join(homeDir, '.gemini', 'antigravity-cli', 'settings.json'),
68
+ skillsDir: path.join(homeDir, '.gemini', 'antigravity-cli', 'skills', 'pm'),
69
+ fleetSkillsDir: path.join(homeDir, '.gemini', 'antigravity-cli', 'skills', 'fleet'),
70
+ agentsDir: path.join(homeDir, '.gemini', 'antigravity-cli', 'agents'),
61
71
  name: 'Antigravity',
62
72
  };
63
73
  case 'codex':
64
74
  return {
65
- configDir: path.join(home, '.codex'),
66
- settingsFile: path.join(home, '.codex', 'config.toml'),
67
- skillsDir: path.join(home, '.codex', 'skills', 'pm'),
68
- fleetSkillsDir: path.join(home, '.codex', 'skills', 'fleet'),
75
+ configDir: path.join(homeDir, '.codex'),
76
+ settingsFile: path.join(homeDir, '.codex', 'config.toml'),
77
+ skillsDir: path.join(homeDir, '.codex', 'skills', 'pm'),
78
+ fleetSkillsDir: path.join(homeDir, '.codex', 'skills', 'fleet'),
69
79
  agentsDir: undefined,
70
80
  name: 'Codex',
71
81
  };
72
82
  case 'copilot':
73
83
  return {
74
- configDir: path.join(home, '.copilot'),
75
- settingsFile: path.join(home, '.copilot', 'settings.json'),
76
- skillsDir: path.join(home, '.copilot', 'skills', 'pm'),
77
- fleetSkillsDir: path.join(home, '.copilot', 'skills', 'fleet'),
84
+ configDir: path.join(homeDir, '.copilot'),
85
+ settingsFile: path.join(homeDir, '.copilot', 'settings.json'),
86
+ skillsDir: path.join(homeDir, '.copilot', 'skills', 'pm'),
87
+ fleetSkillsDir: path.join(homeDir, '.copilot', 'skills', 'fleet'),
78
88
  agentsDir: undefined,
79
89
  name: 'Copilot',
80
90
  };
81
91
  case 'opencode':
82
92
  return {
83
- configDir: path.join(home, '.config', 'opencode'),
84
- settingsFile: path.join(home, '.config', 'opencode', 'opencode.json'),
85
- skillsDir: path.join(home, '.config', 'opencode', 'skills', 'pm'),
86
- fleetSkillsDir: path.join(home, '.config', 'opencode', 'skills', 'fleet'),
87
- agentsDir: path.join(home, '.config', 'opencode', 'agents'),
93
+ configDir: path.join(homeDir, '.config', 'opencode'),
94
+ settingsFile: path.join(homeDir, '.config', 'opencode', 'opencode.json'),
95
+ skillsDir: path.join(homeDir, '.config', 'opencode', 'skills', 'pm'),
96
+ fleetSkillsDir: path.join(homeDir, '.config', 'opencode', 'skills', 'fleet'),
97
+ agentsDir: path.join(homeDir, '.config', 'opencode', 'agents'),
88
98
  name: 'OpenCode',
89
99
  };
90
100
  case 'claude':
91
101
  default:
92
102
  return {
93
- configDir: path.join(home, '.claude'),
94
- settingsFile: path.join(home, '.claude', 'settings.json'),
95
- skillsDir: path.join(home, '.claude', 'skills', 'pm'),
96
- fleetSkillsDir: path.join(home, '.claude', 'skills', 'fleet'),
97
- agentsDir: path.join(home, '.claude', 'agents'),
103
+ configDir: path.join(homeDir, '.claude'),
104
+ settingsFile: path.join(homeDir, '.claude', 'settings.json'),
105
+ skillsDir: path.join(homeDir, '.claude', 'skills', 'pm'),
106
+ fleetSkillsDir: path.join(homeDir, '.claude', 'skills', 'fleet'),
107
+ agentsDir: path.join(homeDir, '.claude', 'agents'),
98
108
  name: 'Claude',
99
109
  };
100
110
  }
@@ -131,7 +141,71 @@ export function readConfig(paths) {
131
141
  return {};
132
142
  }
133
143
  }
134
- export function writeConfig(paths, config) {
144
+ /**
145
+ * Write a file that carries a credential: owner-only (0600), never briefly
146
+ * readable by others. writeFileSync's mode applies only when the file is
147
+ * created, so an existing file (a provider config the user already had, at
148
+ * 0644) is chmod-ed BEFORE the credential is written into it; a new file is
149
+ * created 0600. The final chmod pins exactly 0600 whatever the umask.
150
+ */
151
+ export function writeOwnerOnlyFile(file, content) {
152
+ try {
153
+ fs.chmodSync(file, 0o600);
154
+ }
155
+ catch (err) {
156
+ if (err.code !== 'ENOENT')
157
+ throw err;
158
+ }
159
+ fs.writeFileSync(file, content, { mode: 0o600 });
160
+ fs.chmodSync(file, 0o600);
161
+ }
162
+ /**
163
+ * writeOwnerOnlyFile for a file another process saves concurrently (Claude
164
+ * Code's ~/.claude.json): the content goes to an owner-only temp file in the
165
+ * same directory, then replaces the target by rename, so a crash or a racing
166
+ * save never leaves it truncated. When the rename fails (e.g. the target is
167
+ * briefly locked on Windows) it falls back to the in-place owner-only write.
168
+ * A symlinked file keeps its link: the temp file is placed next to, and
169
+ * renamed over, the link's real target. On POSIX a file owned by another uid
170
+ * (e.g. install run under sudo) is written in place, since a rename would
171
+ * hand it to the current user. The temp file takes the existing file's
172
+ * owner permission bits (never group/other).
173
+ */
174
+ export function writeOwnerOnlyFileAtomic(file, content) {
175
+ let target = file;
176
+ try {
177
+ const real = fs.realpathSync(file);
178
+ if (typeof real === 'string' && real)
179
+ target = real;
180
+ }
181
+ catch { /* missing: write at `file` */ }
182
+ let st;
183
+ try {
184
+ st = fs.statSync(target);
185
+ }
186
+ catch { /* new file */ }
187
+ const getuid = process.getuid;
188
+ if (st && typeof getuid === 'function' && typeof st.uid === 'number' && st.uid !== getuid()) {
189
+ writeOwnerOnlyFile(target, content);
190
+ return;
191
+ }
192
+ const mode = st && typeof st.mode === 'number' && (st.mode & 0o700) ? (st.mode & 0o700) | 0o600 : 0o600;
193
+ const tmp = path.join(path.dirname(target), `.${path.basename(target)}.${process.pid}.${Date.now()}.tmp`);
194
+ try {
195
+ fs.writeFileSync(tmp, content, { mode, flag: 'wx' });
196
+ fs.chmodSync(tmp, mode);
197
+ fs.renameSync(tmp, target);
198
+ return;
199
+ }
200
+ catch {
201
+ try {
202
+ fs.unlinkSync(tmp);
203
+ }
204
+ catch { /* not created / already moved */ }
205
+ }
206
+ writeOwnerOnlyFile(target, content);
207
+ }
208
+ export function writeConfig(paths, config, opts = {}) {
135
209
  fs.mkdirSync(paths.configDir, { recursive: true });
136
210
  let content = '';
137
211
  if (paths.settingsFile.endsWith('.toml')) {
@@ -140,14 +214,17 @@ export function writeConfig(paths, config) {
140
214
  else {
141
215
  content = JSON.stringify(config, null, 2) + '\n';
142
216
  }
143
- fs.writeFileSync(paths.settingsFile, content);
217
+ if (opts.ownerOnly)
218
+ writeOwnerOnlyFile(paths.settingsFile, content);
219
+ else
220
+ fs.writeFileSync(paths.settingsFile, content);
144
221
  }
145
- export function readInstallConfig() {
146
- if (!fs.existsSync(INSTALL_CONFIG_PATH)) {
222
+ export function readInstallConfig(installConfigPath = INSTALL_CONFIG_PATH) {
223
+ if (!fs.existsSync(installConfigPath)) {
147
224
  return { providers: {} };
148
225
  }
149
226
  try {
150
- const data = JSON.parse(fs.readFileSync(INSTALL_CONFIG_PATH, 'utf-8'));
227
+ const data = JSON.parse(fs.readFileSync(installConfigPath, 'utf-8'));
151
228
  // Handle old format migration
152
229
  if (data.llm && data.skill) {
153
230
  return {
@@ -68,9 +68,25 @@ export interface DoltVerifyDeps {
68
68
  getEphemeralPort: () => Promise<number>;
69
69
  waitForConnect: (port: number, timeoutMs: number) => Promise<boolean>;
70
70
  };
71
- /** Terminates the spawned dolt sql-server child. Platform-specific (mirrors stop.ts). */
72
- killChild: (child: ChildProcess) => void;
71
+ /** Terminates the spawned dolt sql-server child in bounded time (see killChild). */
72
+ killChild: (child: ChildProcess) => void | Promise<void>;
73
73
  }
74
+ /** Seams for killChild so tests drive both OS branches on any runner. */
75
+ export interface KillChildOpts {
76
+ platform?: NodeJS.Platform;
77
+ execFileSync?: typeof execFileSync;
78
+ /** Bounded wait (ms) for the child to exit after each kill attempt. Default 3000. */
79
+ waitMs?: number;
80
+ warn?: (msg: string) => void;
81
+ }
82
+ /**
83
+ * Terminate the dolt verify child in bounded time on every OS. child.kill()
84
+ * first (TerminateProcess on Windows, SIGKILL on POSIX): it needs no WMI, so it
85
+ * works for a standard user on a network (SSH) logon, where taskkill /T is
86
+ * denied. taskkill /F /T is only the Windows fallback. The child is always unref'd so a survivor can never
87
+ * keep the installer from exiting; a survivor is reported, not silently left.
88
+ */
89
+ export declare function killChild(child: ChildProcess, opts?: KillChildOpts): Promise<void>;
74
90
  /**
75
91
  * Proves a downloaded dolt binary is actually usable:
76
92
  * 1. Runs `dolt version` (execFileSync, shell:true on Windows per the
@@ -223,25 +223,55 @@ function waitForConnect(port, timeoutMs) {
223
223
  attempt();
224
224
  });
225
225
  }
226
- /** Platform-specific child termination, mirroring the convention in cli/stop.ts. */
227
- function killChild(child) {
228
- if (child.pid === undefined || child.killed)
229
- return;
230
- if (process.platform === 'win32') {
226
+ function childAlive(child) {
227
+ return child.exitCode === null && child.signalCode === null;
228
+ }
229
+ function waitForExit(child, ms) {
230
+ if (!childAlive(child))
231
+ return Promise.resolve(true);
232
+ return new Promise((resolve) => {
233
+ const onExit = () => { clearTimeout(timer); resolve(true); };
234
+ const timer = setTimeout(() => { child.removeListener('exit', onExit); resolve(!childAlive(child)); }, ms);
235
+ child.once('exit', onExit);
236
+ });
237
+ }
238
+ /**
239
+ * Terminate the dolt verify child in bounded time on every OS. child.kill()
240
+ * first (TerminateProcess on Windows, SIGKILL on POSIX): it needs no WMI, so it
241
+ * works for a standard user on a network (SSH) logon, where taskkill /T is
242
+ * denied. taskkill /F /T is only the Windows fallback. The child is always unref'd so a survivor can never
243
+ * keep the installer from exiting; a survivor is reported, not silently left.
244
+ */
245
+ export async function killChild(child, opts = {}) {
246
+ const platform = opts.platform ?? process.platform;
247
+ const waitMs = opts.waitMs ?? 3000;
248
+ try {
249
+ if (child.pid === undefined || !childAlive(child))
250
+ return;
231
251
  try {
232
- execFileSync('taskkill', ['/F', '/T', '/PID', String(child.pid)], { stdio: 'ignore' });
252
+ child.kill(platform === 'win32' ? undefined : 'SIGKILL');
233
253
  }
234
- catch {
235
- // best-effort
254
+ catch { /* fallback below */ }
255
+ if (await waitForExit(child, waitMs))
256
+ return;
257
+ // POSIX already sent SIGKILL (the child is not a process-group leader, so
258
+ // there is no tree to kill); Windows falls back to taskkill /T.
259
+ if (platform === 'win32') {
260
+ try {
261
+ (opts.execFileSync ?? execFileSync)('taskkill', ['/F', '/T', '/PID', String(child.pid)], { stdio: 'ignore', windowsHide: true, timeout: 10_000 });
262
+ }
263
+ catch { /* denied: reported below */ }
264
+ if (await waitForExit(child, waitMs))
265
+ return;
236
266
  }
267
+ const how = platform === 'win32' ? `Stop-Process -Id ${child.pid} -Force` : `kill -9 ${child.pid}`;
268
+ (opts.warn ?? ((m) => console.warn(m)))(` [!] the dolt verify server (pid ${child.pid}) did not exit; stop it by hand: ${how}`);
237
269
  }
238
- else {
270
+ finally {
239
271
  try {
240
- child.kill('SIGKILL');
241
- }
242
- catch {
243
- // best-effort
272
+ child.unref();
244
273
  }
274
+ catch { /* best-effort */ }
245
275
  }
246
276
  }
247
277
  const realVerifyDeps = {
@@ -252,7 +282,7 @@ const realVerifyDeps = {
252
282
  rmSync: (dir, opts) => fs.rmSync(dir, opts),
253
283
  },
254
284
  net: { isPortFree, getEphemeralPort, waitForConnect },
255
- killChild,
285
+ killChild: (child) => killChild(child),
256
286
  };
257
287
  /**
258
288
  * Proves a downloaded dolt binary is actually usable:
@@ -296,6 +326,7 @@ export async function verifyDolt(doltPath, opts = {}, deps = realVerifyDeps) {
296
326
  }
297
327
  child = deps.spawn(doltPath, ['sql-server', '--port', String(port), '--data-dir', scratchDir], {
298
328
  stdio: 'ignore',
329
+ windowsHide: true,
299
330
  });
300
331
  let spawnError;
301
332
  child.once('error', (err) => {
@@ -319,7 +350,7 @@ export async function verifyDolt(doltPath, opts = {}, deps = realVerifyDeps) {
319
350
  }
320
351
  finally {
321
352
  if (child) {
322
- deps.killChild(child);
353
+ await deps.killChild(child);
323
354
  }
324
355
  if (scratchDir) {
325
356
  try {
@@ -0,0 +1,51 @@
1
+ /** Installed supervisor entry point, resolved here (no shell ~ expansion). */
2
+ export declare const INSTALLED_SERVE_SCRIPT: string;
3
+ export declare const IGNORE_RUNNING_SPRINTS_FLAG = "--ignore-running-sprints";
4
+ export declare const DEFAULT_SUPERVISOR_PORT = 8787;
5
+ export interface RunningSupervisor {
6
+ pid: number;
7
+ port: number;
8
+ }
9
+ export interface RunningSprint {
10
+ pid: number;
11
+ sprintId?: string;
12
+ lockFile?: string;
13
+ }
14
+ export interface RunningFleetSe {
15
+ supervisor: RunningSupervisor | null;
16
+ sprints: RunningSprint[];
17
+ /** Detection caveats the caller prints as WARNINGs. */
18
+ warnings?: string[];
19
+ }
20
+ /**
21
+ * A fleet-sprint engine run: the supervisor's `node .../bin/cli.mjs ...`
22
+ * (installed tree or an apra-fleet-se checkout) or the SEA's
23
+ * `apra-fleet workflow fleet-sprint ...`.
24
+ */
25
+ export declare function isFleetSprintCommandLine(cmd: string): boolean;
26
+ export interface FleetSeProbes {
27
+ lockDir: () => string;
28
+ supervisorLogPath: () => string;
29
+ readDir: (dir: string) => string[];
30
+ readFile: (file: string) => string;
31
+ isPidAlive: (pid: number) => boolean;
32
+ /** Command line of a live pid, or null when it cannot be read. */
33
+ commandLine: (pid: number) => string | null;
34
+ /** Parsed JSON body of a 200 response, or null (refused, timeout, non-200, bad JSON). */
35
+ getJson: (url: string) => Promise<unknown>;
36
+ }
37
+ export declare const realFleetSeProbes: FleetSeProbes;
38
+ /**
39
+ * What fleet-se work is running for this OS user. Throws only on an
40
+ * unexpected detection error (the caller then warns and proceeds).
41
+ */
42
+ export declare function detectRunningFleetSe(probes?: FleetSeProbes): Promise<RunningFleetSe>;
43
+ /** The refusal printed when fleet-se work is running. */
44
+ export declare function fleetSeRefusalText(found: RunningFleetSe, opts: {
45
+ platform: NodeJS.Platform;
46
+ rerunLines: string[];
47
+ ignoreLines: string[];
48
+ /** Supervisor script to restart; defaults to the installed one. */
49
+ serveScript?: string;
50
+ }): string;
51
+ //# sourceMappingURL=fleet-se-guard.d.ts.map
@@ -0,0 +1,215 @@
1
+ /**
2
+ * Install-time guard against upgrading under a running fleet-sprint
3
+ * supervisor or sprint.
4
+ *
5
+ * A supervisor or sprint keeps running its old code after an upgrade, and
6
+ * install --force replaces the fleet server underneath it. One started before
7
+ * the member access secret existed (0.4.3 and earlier) never sends it, so
8
+ * every call it makes gets HTTP 401 -- the sprint fails silently mid-run. In
9
+ * general a running sprint should not have its server replaced underneath it,
10
+ * so install refuses while one is running for
11
+ * this OS user, unless the user explicitly passes IGNORE_RUNNING_SPRINTS_FLAG.
12
+ * --force does NOT bypass this: --force only means "stop the running fleet
13
+ * server", and `apra-fleet update` always passes it.
14
+ *
15
+ * The supervisor is not restarted automatically: this release never registers
16
+ * a supervisor OS service (see services/supervisor-service-cleanup.ts), and the
17
+ * supervisor writes no server.json, so there is nothing install could restart.
18
+ *
19
+ * Signals:
20
+ * - sprints: every fleet-sprint engine run (supervisor-launched or a direct
21
+ * `apra-fleet workflow fleet-sprint`) holds a pidfile lock under
22
+ * APRA_FLEET_SPRINT_LOCK_DIR or <tmpdir>/apra-fleet-sprint-locks
23
+ * (fleet-sprint/sprint-lock.mjs). A lock whose pid is alive is a running
24
+ * sprint. isPidAlive() is false on EPERM, so another user's sprints in a
25
+ * shared /tmp do not count. A lock left behind by a killed run can name a
26
+ * pid since reused by an unrelated process, so the pid's command line must
27
+ * also look like a fleet-sprint run; when it cannot be read the lock is
28
+ * skipped with a WARNING (fail open).
29
+ * - supervisor: GET /api/health on the default port 8787 and on the port the
30
+ * supervisor last logged in <FLEET_SE_DATA_DIR or ~/.apra-fleet-se>/logs/
31
+ * supervisor.log; a 200 with status ok + seams + a live pid is the
32
+ * supervisor. GET /api/sprints then names its sprints for the stop steps.
33
+ */
34
+ import fs from 'node:fs';
35
+ import path from 'node:path';
36
+ import os from 'node:os';
37
+ import { isPidAlive, processCommandLine } from '../utils/process-utils.js';
38
+ import { WORKFLOWS_DIR } from './config.js';
39
+ /** Installed supervisor entry point, resolved here (no shell ~ expansion). */
40
+ export const INSTALLED_SERVE_SCRIPT = path.join(WORKFLOWS_DIR, 'fleet-sprint', 'bin', 'serve.mjs');
41
+ export const IGNORE_RUNNING_SPRINTS_FLAG = '--ignore-running-sprints';
42
+ export const DEFAULT_SUPERVISOR_PORT = 8787;
43
+ /**
44
+ * A fleet-sprint engine run: the supervisor's `node .../bin/cli.mjs ...`
45
+ * (installed tree or an apra-fleet-se checkout) or the SEA's
46
+ * `apra-fleet workflow fleet-sprint ...`.
47
+ */
48
+ export function isFleetSprintCommandLine(cmd) {
49
+ return /apra-fleet|fleet-sprint|fleet-se|runner\.js|cli\.mjs/i.test(cmd);
50
+ }
51
+ async function getJsonWithTimeout(url) {
52
+ const controller = new AbortController();
53
+ const tid = setTimeout(() => controller.abort(), 1500);
54
+ try {
55
+ const res = await fetch(url, { signal: controller.signal });
56
+ if (!res.ok)
57
+ return null;
58
+ return await res.json();
59
+ }
60
+ catch {
61
+ return null;
62
+ }
63
+ finally {
64
+ clearTimeout(tid);
65
+ }
66
+ }
67
+ export const realFleetSeProbes = {
68
+ lockDir: () => process.env.APRA_FLEET_SPRINT_LOCK_DIR || path.join(os.tmpdir(), 'apra-fleet-sprint-locks'),
69
+ supervisorLogPath: () => path.join(process.env.FLEET_SE_DATA_DIR ? path.resolve(process.env.FLEET_SE_DATA_DIR) : path.join(os.homedir(), '.apra-fleet-se'), 'logs', 'supervisor.log'),
70
+ readDir: dir => fs.readdirSync(dir),
71
+ readFile: file => fs.readFileSync(file, 'utf8'),
72
+ isPidAlive,
73
+ commandLine: processCommandLine,
74
+ getJson: getJsonWithTimeout,
75
+ };
76
+ function isEnoent(err) {
77
+ return err?.code === 'ENOENT';
78
+ }
79
+ /** Port from the supervisor's last "listening on http://localhost:<port>" log line, or null. */
80
+ function loggedSupervisorPort(probes) {
81
+ let text;
82
+ try {
83
+ text = probes.readFile(probes.supervisorLogPath());
84
+ }
85
+ catch (err) {
86
+ if (isEnoent(err))
87
+ return null;
88
+ throw err;
89
+ }
90
+ const matches = [...text.matchAll(/\[supervisor\] listening on http:\/\/localhost:(\d+)/g)];
91
+ const port = matches.length > 0 ? Number(matches[matches.length - 1][1]) : NaN;
92
+ return Number.isInteger(port) && port > 0 && port < 65536 ? port : null;
93
+ }
94
+ /**
95
+ * What fleet-se work is running for this OS user. Throws only on an
96
+ * unexpected detection error (the caller then warns and proceeds).
97
+ */
98
+ export async function detectRunningFleetSe(probes = realFleetSeProbes) {
99
+ const sprints = new Map();
100
+ const warnings = [];
101
+ const lockDir = probes.lockDir();
102
+ let lockFiles = [];
103
+ try {
104
+ lockFiles = probes.readDir(lockDir).filter(f => f.endsWith('.lock'));
105
+ }
106
+ catch (err) {
107
+ if (!isEnoent(err))
108
+ throw err;
109
+ }
110
+ for (const f of lockFiles) {
111
+ const lockFile = path.join(lockDir, f);
112
+ let pid;
113
+ try {
114
+ pid = parseInt(probes.readFile(lockFile).trim(), 10);
115
+ }
116
+ catch (err) {
117
+ if (isEnoent(err))
118
+ continue;
119
+ throw err;
120
+ }
121
+ if (!Number.isInteger(pid) || pid <= 0 || pid === process.pid || !probes.isPidAlive(pid))
122
+ continue;
123
+ const cmd = probes.commandLine(pid);
124
+ if (cmd === null) {
125
+ warnings.push(`could not read the command line of pid ${pid} (sprint lock ${lockFile}), so it is not treated as a running sprint. If it is one, stop it before upgrading.`);
126
+ continue;
127
+ }
128
+ // Otherwise a stale lock whose pid was reused by an unrelated process.
129
+ if (isFleetSprintCommandLine(cmd))
130
+ sprints.set(pid, { pid, lockFile });
131
+ }
132
+ let supervisor = null;
133
+ const ports = [DEFAULT_SUPERVISOR_PORT];
134
+ const logged = loggedSupervisorPort(probes);
135
+ if (logged !== null && logged !== DEFAULT_SUPERVISOR_PORT)
136
+ ports.push(logged);
137
+ for (const port of ports) {
138
+ const health = await probes.getJson(`http://127.0.0.1:${port}/api/health`);
139
+ if (!health || health.status !== 'ok' || typeof health.seams !== 'object' || health.seams === null)
140
+ continue;
141
+ if (typeof health.pid !== 'number' || !probes.isPidAlive(health.pid))
142
+ continue;
143
+ supervisor = { pid: health.pid, port };
144
+ const list = await probes.getJson(`http://127.0.0.1:${port}/api/sprints`);
145
+ for (const s of list?.sprints ?? []) {
146
+ if (typeof s.childPid !== 'number' || !probes.isPidAlive(s.childPid))
147
+ continue;
148
+ const sprintId = typeof s.sprintId === 'string' ? s.sprintId : undefined;
149
+ sprints.set(s.childPid, { ...sprints.get(s.childPid), pid: s.childPid, sprintId });
150
+ }
151
+ break;
152
+ }
153
+ return { supervisor, sprints: [...sprints.values()], warnings };
154
+ }
155
+ /** The refusal printed when fleet-se work is running. */
156
+ export function fleetSeRefusalText(found, opts) {
157
+ const serveScript = opts.serveScript ?? INSTALLED_SERVE_SCRIPT;
158
+ const curl = opts.platform === 'win32' ? 'curl.exe' : 'curl';
159
+ const sup = found.supervisor;
160
+ const base = sup ? `http://localhost:${sup.port}` : `http://localhost:${DEFAULT_SUPERVISOR_PORT}`;
161
+ const running = [];
162
+ if (sup)
163
+ running.push(` - fleet-sprint supervisor: pid ${sup.pid}, ${base}`);
164
+ for (const s of found.sprints) {
165
+ const what = s.sprintId ? `sprint ${s.sprintId}` : 'fleet-sprint run';
166
+ running.push(` - ${what}: pid ${s.pid}${s.lockFile ? ` (lock file ${s.lockFile})` : ''}`);
167
+ }
168
+ const steps = [];
169
+ if (found.sprints.length > 0) {
170
+ steps.push(' 1. Stop the running sprints or let them finish.');
171
+ for (const s of found.sprints) {
172
+ if (sup && s.sprintId)
173
+ steps.push(` ${curl} -X POST ${base}/api/sprints/${s.sprintId}/stop`);
174
+ }
175
+ if (found.sprints.some(s => !(sup && s.sprintId))) {
176
+ steps.push(' A sprint started directly (apra-fleet workflow fleet-sprint) is stopped with Ctrl-C in its');
177
+ steps.push(' console, or by ending its pid shown above. If that pid is not a fleet-sprint (a stale');
178
+ steps.push(' lock whose pid was reused), delete the lock file instead.');
179
+ }
180
+ }
181
+ else {
182
+ steps.push(' 1. No sprint is running.');
183
+ }
184
+ steps.push(sup
185
+ ? ` 2. Stop the supervisor:\n ${curl} -X POST ${base}/api/shutdown`
186
+ : ' 2. No supervisor is running.');
187
+ steps.push(' 3. Upgrade:');
188
+ for (const l of opts.rerunLines)
189
+ steps.push(` ${l}`);
190
+ steps.push(sup
191
+ ? [
192
+ ' 4. Restart the supervisor from your project folder (the one holding .beads), or add',
193
+ ' --beads-dir <project folder>, then relaunch sprints:',
194
+ ` node "${serveScript}"`,
195
+ ].join('\n')
196
+ : ' 4. Relaunch the sprints.');
197
+ return [
198
+ '',
199
+ 'Error: E-FLEET-SE-RUNNING: fleet-sprint work is running for this user. Installing now replaces',
200
+ 'the fleet server underneath it while it keeps running its old code; a supervisor or sprint',
201
+ 'started before the member access secret existed (0.4.3 and earlier) then fails every call',
202
+ 'with HTTP 401. Nothing was stopped or installed.',
203
+ '',
204
+ 'Running:',
205
+ ...running,
206
+ '',
207
+ 'To upgrade safely:',
208
+ ...steps,
209
+ '',
210
+ 'To install anyway (the processes above will fail until restarted):',
211
+ ...opts.ignoreLines.map(l => ` ${l}`),
212
+ '',
213
+ ].join('\n');
214
+ }
215
+ //# sourceMappingURL=fleet-se-guard.js.map
@@ -26,4 +26,58 @@ export declare function isUnderInstallPrefix(exePath: string | null, prefixDir:
26
26
  * that writes its binary into `installPrefixDir`.
27
27
  */
28
28
  export declare function classifyRunningServer(installPrefixDir: string): RunningServerScope;
29
+ /**
30
+ * The pids install --force may stop for an install into `installPrefixDir`,
31
+ * re-derived on every call so a poll also sees a server a supervisor relaunched
32
+ * under a NEW pid (it re-records itself in server.json and runs from the prefix):
33
+ *
34
+ * - the live pid recorded in the targeted data dir, when it is still an
35
+ * apra-fleet process (pids are reused: a stale server.json pid that now
36
+ * belongs to something else is never returned), and
37
+ * - every apra-fleet process whose executable lives under the install prefix.
38
+ *
39
+ * This process is never included -- the installer may itself be named
40
+ * apra-fleet. Unrelated apra-fleet servers (other data dir, other prefix,
41
+ * unresolvable executable) are never included either.
42
+ */
43
+ export declare function relevantServerPids(installPrefixDir: string): number[];
44
+ /** Name of the explicit override that lets a member install stop a full-install server. */
45
+ export declare const FORCE_STOP_FULL_INSTALL_FLAG = "--force-stop-full-install";
46
+ /** Machine-readable code printed on the refusal (the fleet-side install maps it to a typed status). */
47
+ export declare const FULL_INSTALL_RUNNING_CODE = "E-FULL-INSTALL-RUNNING";
48
+ export declare function memberInstallMarkerPath(): string;
49
+ export declare function hasMemberInstallMarker(): boolean;
50
+ /** Writes the marker. `port` is the port this member install's server listens
51
+ * on (the server reads it back at launch, see resolveServerPort, and the
52
+ * orchestrator reads it to build the member's MCP URL). */
53
+ export declare function writeMemberInstallMarker(version: string, port?: number): void;
54
+ export declare function clearMemberInstallMarker(): void;
55
+ /**
56
+ * Whether a `--member --force` install may stop the relevant running server.
57
+ * Allowed when the server is a member install's own (marker present) or the
58
+ * caller passed the explicit override; not applicable to a non-member install.
59
+ */
60
+ export declare function memberForceMayStop(opts: {
61
+ memberMode: boolean;
62
+ overridden: boolean;
63
+ }): boolean;
64
+ /** The refusal text: names the running server and the override. */
65
+ export declare function fullInstallRefusalText(serverDetail: string): string;
66
+ /**
67
+ * The exact command line that re-runs THIS executable with `args`, for a hint
68
+ * the user copies: a downloaded installer is usually not on PATH, so
69
+ * "apra-fleet ..." can name a missing (or an older, installed) binary. SEA:
70
+ * the executable itself; npm/dev: node plus the entry script. One line per
71
+ * shell: POSIX single-quotes when needed; Windows prints the bare words when
72
+ * none needs quoting (valid in cmd and PowerShell), else a PowerShell
73
+ * `& '...'` line and a cmd `"..."` line (a quoted path followed by arguments
74
+ * is a PowerShell parse error without `&`).
75
+ */
76
+ export declare function selfInvocationLines(opts: {
77
+ platform: NodeJS.Platform;
78
+ execPath: string;
79
+ scriptPath?: string;
80
+ sea: boolean;
81
+ args: string[];
82
+ }): string[];
29
83
  //# sourceMappingURL=install-guard.d.ts.map