@apralabs/apra-fleet 0.4.1 → 0.4.3

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 (476) hide show
  1. package/README.md +53 -12
  2. package/dist/agents/backlog-groomer.md +42 -21
  3. package/dist/agents/ci-watcher.md +14 -0
  4. package/dist/agents/deployer.md +59 -46
  5. package/dist/agents/doer.md +157 -134
  6. package/dist/agents/harvester.md +31 -32
  7. package/dist/agents/integ-test-runner.md +92 -113
  8. package/dist/agents/kb-reconciler.md +40 -42
  9. package/dist/agents/plan-reviewer.md +139 -63
  10. package/dist/agents/planner.md +176 -100
  11. package/dist/agents/regression-test-runner.md +77 -81
  12. package/dist/agents/reviewer.md +69 -85
  13. package/dist/agents/schemas/integ-test-runner-output.json +1 -1
  14. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  15. package/dist/agents/schemas/regression-test-runner-output.json +4 -17
  16. package/dist/cli/agent-transform.d.ts +83 -2
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +266 -21
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts.map +1 -1
  21. package/dist/cli/auth.js +29 -11
  22. package/dist/cli/auth.js.map +1 -1
  23. package/dist/cli/config.d.ts +7 -5
  24. package/dist/cli/config.d.ts.map +1 -1
  25. package/dist/cli/config.js +44 -43
  26. package/dist/cli/config.js.map +1 -1
  27. package/dist/cli/install.d.ts +33 -0
  28. package/dist/cli/install.d.ts.map +1 -1
  29. package/dist/cli/install.js +294 -61
  30. package/dist/cli/install.js.map +1 -1
  31. package/dist/cli/kb-directives.d.ts.map +1 -1
  32. package/dist/cli/kb-directives.js +2 -1
  33. package/dist/cli/kb-directives.js.map +1 -1
  34. package/dist/cli/register-member.d.ts.map +1 -1
  35. package/dist/cli/register-member.js +7 -3
  36. package/dist/cli/register-member.js.map +1 -1
  37. package/dist/cli/start.d.ts.map +1 -1
  38. package/dist/cli/start.js +7 -0
  39. package/dist/cli/start.js.map +1 -1
  40. package/dist/cli/uninstall.d.ts.map +1 -1
  41. package/dist/cli/uninstall.js +5 -3
  42. package/dist/cli/uninstall.js.map +1 -1
  43. package/dist/cli/watch.d.ts +26 -3
  44. package/dist/cli/watch.d.ts.map +1 -1
  45. package/dist/cli/watch.js +41 -9
  46. package/dist/cli/watch.js.map +1 -1
  47. package/dist/commands/kb-server.d.ts +3 -0
  48. package/dist/commands/kb-server.d.ts.map +1 -1
  49. package/dist/commands/kb-server.js +43 -3
  50. package/dist/commands/kb-server.js.map +1 -1
  51. package/dist/index.js +3 -3
  52. package/dist/os/git-bash-candidates.d.ts +35 -0
  53. package/dist/os/git-bash-candidates.d.ts.map +1 -0
  54. package/dist/os/git-bash-candidates.js +46 -0
  55. package/dist/os/git-bash-candidates.js.map +1 -0
  56. package/dist/os/index.d.ts +13 -4
  57. package/dist/os/index.d.ts.map +1 -1
  58. package/dist/os/index.js +17 -2
  59. package/dist/os/index.js.map +1 -1
  60. package/dist/os/linux.d.ts +6 -0
  61. package/dist/os/linux.d.ts.map +1 -1
  62. package/dist/os/linux.js +36 -3
  63. package/dist/os/linux.js.map +1 -1
  64. package/dist/os/os-commands.d.ts +68 -2
  65. package/dist/os/os-commands.d.ts.map +1 -1
  66. package/dist/os/os-commands.js.map +1 -1
  67. package/dist/os/windows-gitbash.d.ts +98 -0
  68. package/dist/os/windows-gitbash.d.ts.map +1 -0
  69. package/dist/os/windows-gitbash.js +259 -0
  70. package/dist/os/windows-gitbash.js.map +1 -0
  71. package/dist/os/windows.d.ts +6 -0
  72. package/dist/os/windows.d.ts.map +1 -1
  73. package/dist/os/windows.js +73 -8
  74. package/dist/os/windows.js.map +1 -1
  75. package/dist/providers/agy.d.ts +118 -8
  76. package/dist/providers/agy.d.ts.map +1 -1
  77. package/dist/providers/agy.js +580 -55
  78. package/dist/providers/agy.js.map +1 -1
  79. package/dist/providers/claude.d.ts +83 -4
  80. package/dist/providers/claude.d.ts.map +1 -1
  81. package/dist/providers/claude.js +365 -12
  82. package/dist/providers/claude.js.map +1 -1
  83. package/dist/providers/codex.d.ts +7 -4
  84. package/dist/providers/codex.d.ts.map +1 -1
  85. package/dist/providers/codex.js +24 -4
  86. package/dist/providers/codex.js.map +1 -1
  87. package/dist/providers/copilot.d.ts +7 -4
  88. package/dist/providers/copilot.d.ts.map +1 -1
  89. package/dist/providers/copilot.js +27 -4
  90. package/dist/providers/copilot.js.map +1 -1
  91. package/dist/providers/index.d.ts +0 -1
  92. package/dist/providers/index.d.ts.map +1 -1
  93. package/dist/providers/index.js +0 -3
  94. package/dist/providers/index.js.map +1 -1
  95. package/dist/providers/none.d.ts +7 -4
  96. package/dist/providers/none.d.ts.map +1 -1
  97. package/dist/providers/none.js +22 -4
  98. package/dist/providers/none.js.map +1 -1
  99. package/dist/providers/opencode.d.ts +6 -3
  100. package/dist/providers/opencode.d.ts.map +1 -1
  101. package/dist/providers/opencode.js +27 -4
  102. package/dist/providers/opencode.js.map +1 -1
  103. package/dist/providers/provider.d.ts +215 -11
  104. package/dist/providers/provider.d.ts.map +1 -1
  105. package/dist/providers/provider.js +58 -2
  106. package/dist/providers/provider.js.map +1 -1
  107. package/dist/services/agent-provisioner.js +2 -2
  108. package/dist/services/agent-provisioner.js.map +1 -1
  109. package/dist/services/agy-project.d.ts +102 -0
  110. package/dist/services/agy-project.d.ts.map +1 -0
  111. package/dist/services/agy-project.js +356 -0
  112. package/dist/services/agy-project.js.map +1 -0
  113. package/dist/services/auth-socket.js +4 -4
  114. package/dist/services/auth-web.js +1 -1
  115. package/dist/services/cloud/activity.js +2 -2
  116. package/dist/services/cloud/activity.js.map +1 -1
  117. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  118. package/dist/services/cloud/lifecycle.js +33 -4
  119. package/dist/services/cloud/lifecycle.js.map +1 -1
  120. package/dist/services/context-admission.d.ts.map +1 -1
  121. package/dist/services/context-admission.js +9 -7
  122. package/dist/services/context-admission.js.map +1 -1
  123. package/dist/services/credential-cleanup.d.ts.map +1 -1
  124. package/dist/services/credential-cleanup.js +47 -10
  125. package/dist/services/credential-cleanup.js.map +1 -1
  126. package/dist/services/exit-drain.d.ts +44 -0
  127. package/dist/services/exit-drain.d.ts.map +1 -0
  128. package/dist/services/exit-drain.js +52 -0
  129. package/dist/services/exit-drain.js.map +1 -0
  130. package/dist/services/github-app.d.ts.map +1 -1
  131. package/dist/services/github-app.js +32 -4
  132. package/dist/services/github-app.js.map +1 -1
  133. package/dist/services/http-transport.d.ts +1 -0
  134. package/dist/services/http-transport.d.ts.map +1 -1
  135. package/dist/services/http-transport.js +48 -1
  136. package/dist/services/http-transport.js.map +1 -1
  137. package/dist/services/knowledge/kb-config.d.ts +42 -0
  138. package/dist/services/knowledge/kb-config.d.ts.map +1 -0
  139. package/dist/services/knowledge/kb-config.js +54 -0
  140. package/dist/services/knowledge/kb-config.js.map +1 -0
  141. package/dist/services/knowledge/kb-providers.d.ts +7 -1
  142. package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
  143. package/dist/services/knowledge/kb-providers.js +191 -17
  144. package/dist/services/knowledge/kb-providers.js.map +1 -1
  145. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  146. package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
  149. package/dist/services/member-home.d.ts +1 -1
  150. package/dist/services/member-home.d.ts.map +1 -1
  151. package/dist/services/member-home.js +15 -12
  152. package/dist/services/member-home.js.map +1 -1
  153. package/dist/services/model-pricing.d.ts.map +1 -1
  154. package/dist/services/model-pricing.js +7 -8
  155. package/dist/services/model-pricing.js.map +1 -1
  156. package/dist/services/orphan-recovery.d.ts +6 -3
  157. package/dist/services/orphan-recovery.d.ts.map +1 -1
  158. package/dist/services/orphan-recovery.js +17 -14
  159. package/dist/services/orphan-recovery.js.map +1 -1
  160. package/dist/services/preflight-check.js +2 -2
  161. package/dist/services/preflight-check.js.map +1 -1
  162. package/dist/services/secret-token.d.ts +38 -0
  163. package/dist/services/secret-token.d.ts.map +1 -0
  164. package/dist/services/secret-token.js +51 -0
  165. package/dist/services/secret-token.js.map +1 -0
  166. package/dist/services/service-manager/types.d.ts +3 -1
  167. package/dist/services/service-manager/types.d.ts.map +1 -1
  168. package/dist/services/service-manager/windows.d.ts +14 -2
  169. package/dist/services/service-manager/windows.d.ts.map +1 -1
  170. package/dist/services/service-manager/windows.js +65 -7
  171. package/dist/services/service-manager/windows.js.map +1 -1
  172. package/dist/services/shell-probe.d.ts +131 -0
  173. package/dist/services/shell-probe.d.ts.map +1 -0
  174. package/dist/services/shell-probe.js +210 -0
  175. package/dist/services/shell-probe.js.map +1 -0
  176. package/dist/services/singleton.d.ts +2 -0
  177. package/dist/services/singleton.d.ts.map +1 -1
  178. package/dist/services/singleton.js +1 -1
  179. package/dist/services/singleton.js.map +1 -1
  180. package/dist/services/ssh.d.ts.map +1 -1
  181. package/dist/services/ssh.js +60 -4
  182. package/dist/services/ssh.js.map +1 -1
  183. package/dist/services/stall/find-log-file.d.ts.map +1 -1
  184. package/dist/services/stall/find-log-file.js +22 -16
  185. package/dist/services/stall/find-log-file.js.map +1 -1
  186. package/dist/services/stall/read-log-tail.d.ts.map +1 -1
  187. package/dist/services/stall/read-log-tail.js +26 -15
  188. package/dist/services/stall/read-log-tail.js.map +1 -1
  189. package/dist/services/stall/stall-detector.d.ts +53 -4
  190. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  191. package/dist/services/stall/stall-detector.js +212 -34
  192. package/dist/services/stall/stall-detector.js.map +1 -1
  193. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  194. package/dist/services/stall/stall-poller.js +35 -42
  195. package/dist/services/stall/stall-poller.js.map +1 -1
  196. package/dist/services/strategy.d.ts +9 -0
  197. package/dist/services/strategy.d.ts.map +1 -1
  198. package/dist/services/strategy.js +119 -8
  199. package/dist/services/strategy.js.map +1 -1
  200. package/dist/services/substitution-engine.js +2 -2
  201. package/dist/services/substitution-engine.js.map +1 -1
  202. package/dist/services/tool-registry.d.ts.map +1 -1
  203. package/dist/services/tool-registry.js +5 -3
  204. package/dist/services/tool-registry.js.map +1 -1
  205. package/dist/services/user-config.js +1 -1
  206. package/dist/services/user-config.js.map +1 -1
  207. package/dist/services/vcs/azure-devops.d.ts +67 -2
  208. package/dist/services/vcs/azure-devops.d.ts.map +1 -1
  209. package/dist/services/vcs/azure-devops.js +281 -15
  210. package/dist/services/vcs/azure-devops.js.map +1 -1
  211. package/dist/services/vcs/bitbucket.d.ts.map +1 -1
  212. package/dist/services/vcs/bitbucket.js +16 -0
  213. package/dist/services/vcs/bitbucket.js.map +1 -1
  214. package/dist/services/vcs/github.d.ts.map +1 -1
  215. package/dist/services/vcs/github.js +24 -0
  216. package/dist/services/vcs/github.js.map +1 -1
  217. package/dist/services/vcs/types.d.ts +123 -2
  218. package/dist/services/vcs/types.d.ts.map +1 -1
  219. package/dist/skills/fleet-sprint-cli/SKILL.md +20 -1
  220. package/dist/skills/pm/SKILL.md +1 -2
  221. package/dist/skills/pm/cost.md +0 -4
  222. package/dist/skills/pm/fleet-addendum.md +2 -3
  223. package/dist/tools/check-status.d.ts +7 -4
  224. package/dist/tools/check-status.d.ts.map +1 -1
  225. package/dist/tools/check-status.js +5 -3
  226. package/dist/tools/check-status.js.map +1 -1
  227. package/dist/tools/cloud-control.js +2 -2
  228. package/dist/tools/cloud-control.js.map +1 -1
  229. package/dist/tools/compose-permissions.d.ts +6 -0
  230. package/dist/tools/compose-permissions.d.ts.map +1 -1
  231. package/dist/tools/compose-permissions.js +211 -50
  232. package/dist/tools/compose-permissions.js.map +1 -1
  233. package/dist/tools/credential-store-set.js +1 -1
  234. package/dist/tools/execute-command.d.ts.map +1 -1
  235. package/dist/tools/execute-command.js +56 -29
  236. package/dist/tools/execute-command.js.map +1 -1
  237. package/dist/tools/execute-prompt.d.ts +15 -2
  238. package/dist/tools/execute-prompt.d.ts.map +1 -1
  239. package/dist/tools/execute-prompt.js +1214 -873
  240. package/dist/tools/execute-prompt.js.map +1 -1
  241. package/dist/tools/kb-capture.d.ts +2 -2
  242. package/dist/tools/kb-capture.d.ts.map +1 -1
  243. package/dist/tools/kb-capture.js +29 -5
  244. package/dist/tools/kb-capture.js.map +1 -1
  245. package/dist/tools/kb-export.d.ts +2 -2
  246. package/dist/tools/kb-export.d.ts.map +1 -1
  247. package/dist/tools/kb-export.js +3 -28
  248. package/dist/tools/kb-export.js.map +1 -1
  249. package/dist/tools/kb-feedback.d.ts.map +1 -1
  250. package/dist/tools/kb-feedback.js +3 -1
  251. package/dist/tools/kb-feedback.js.map +1 -1
  252. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
  253. package/dist/tools/kb-freshness-sweep.js +3 -1
  254. package/dist/tools/kb-freshness-sweep.js.map +1 -1
  255. package/dist/tools/kb-import.d.ts.map +1 -1
  256. package/dist/tools/kb-import.js +2 -1
  257. package/dist/tools/kb-import.js.map +1 -1
  258. package/dist/tools/kb-list.d.ts.map +1 -1
  259. package/dist/tools/kb-list.js +3 -1
  260. package/dist/tools/kb-list.js.map +1 -1
  261. package/dist/tools/kb-query.d.ts +2 -2
  262. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
  263. package/dist/tools/kb-reconcile-prefilter.js +3 -1
  264. package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
  265. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
  266. package/dist/tools/kb-resolve-contradiction.js +3 -1
  267. package/dist/tools/kb-resolve-contradiction.js.map +1 -1
  268. package/dist/tools/kb-setup.d.ts.map +1 -1
  269. package/dist/tools/kb-setup.js +125 -20
  270. package/dist/tools/kb-setup.js.map +1 -1
  271. package/dist/tools/kb-stats.d.ts.map +1 -1
  272. package/dist/tools/kb-stats.js +64 -43
  273. package/dist/tools/kb-stats.js.map +1 -1
  274. package/dist/tools/list-members.d.ts +2 -2
  275. package/dist/tools/list-members.d.ts.map +1 -1
  276. package/dist/tools/list-members.js +7 -2
  277. package/dist/tools/list-members.js.map +1 -1
  278. package/dist/tools/member-detail.d.ts +2 -2
  279. package/dist/tools/member-detail.d.ts.map +1 -1
  280. package/dist/tools/member-detail.js +22 -3
  281. package/dist/tools/member-detail.js.map +1 -1
  282. package/dist/tools/member-reservation.d.ts +58 -1
  283. package/dist/tools/member-reservation.d.ts.map +1 -1
  284. package/dist/tools/member-reservation.js +71 -18
  285. package/dist/tools/member-reservation.js.map +1 -1
  286. package/dist/tools/monitor-task.d.ts.map +1 -1
  287. package/dist/tools/monitor-task.js +17 -2
  288. package/dist/tools/monitor-task.js.map +1 -1
  289. package/dist/tools/provision-auth.d.ts +80 -1
  290. package/dist/tools/provision-auth.d.ts.map +1 -1
  291. package/dist/tools/provision-auth.js +147 -59
  292. package/dist/tools/provision-auth.js.map +1 -1
  293. package/dist/tools/provision-vcs-auth.d.ts +96 -3
  294. package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
  295. package/dist/tools/provision-vcs-auth.js +254 -88
  296. package/dist/tools/provision-vcs-auth.js.map +1 -1
  297. package/dist/tools/register-member.d.ts +21 -12
  298. package/dist/tools/register-member.d.ts.map +1 -1
  299. package/dist/tools/register-member.js +141 -16
  300. package/dist/tools/register-member.js.map +1 -1
  301. package/dist/tools/remove-member.d.ts.map +1 -1
  302. package/dist/tools/remove-member.js +29 -4
  303. package/dist/tools/remove-member.js.map +1 -1
  304. package/dist/tools/revoke-vcs-auth.js +2 -2
  305. package/dist/tools/revoke-vcs-auth.js.map +1 -1
  306. package/dist/tools/send-email.d.ts +2 -2
  307. package/dist/tools/setup-git-app.d.ts.map +1 -1
  308. package/dist/tools/setup-git-app.js +11 -7
  309. package/dist/tools/setup-git-app.js.map +1 -1
  310. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  311. package/dist/tools/setup-ssh-key.js +2 -1
  312. package/dist/tools/setup-ssh-key.js.map +1 -1
  313. package/dist/tools/shutdown-server.d.ts +2 -0
  314. package/dist/tools/shutdown-server.d.ts.map +1 -1
  315. package/dist/tools/shutdown-server.js +23 -1
  316. package/dist/tools/shutdown-server.js.map +1 -1
  317. package/dist/tools/stop-prompt.js +2 -2
  318. package/dist/tools/stop-prompt.js.map +1 -1
  319. package/dist/tools/update-agent-cli.js +2 -2
  320. package/dist/tools/update-agent-cli.js.map +1 -1
  321. package/dist/tools/update-member.d.ts +21 -12
  322. package/dist/tools/update-member.d.ts.map +1 -1
  323. package/dist/tools/update-member.js +61 -12
  324. package/dist/tools/update-member.js.map +1 -1
  325. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  326. package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
  327. package/dist/tools/vcs-credential-exec.js +197 -0
  328. package/dist/tools/vcs-credential-exec.js.map +1 -0
  329. package/dist/types.d.ts +24 -1
  330. package/dist/types.d.ts.map +1 -1
  331. package/dist/utils/agent-helpers.d.ts +36 -0
  332. package/dist/utils/agent-helpers.d.ts.map +1 -1
  333. package/dist/utils/agent-helpers.js +39 -1
  334. package/dist/utils/agent-helpers.js.map +1 -1
  335. package/dist/utils/log-helpers.d.ts.map +1 -1
  336. package/dist/utils/log-helpers.js +2 -2
  337. package/dist/utils/log-helpers.js.map +1 -1
  338. package/dist/utils/platform.d.ts +7 -0
  339. package/dist/utils/platform.d.ts.map +1 -1
  340. package/dist/utils/platform.js +11 -1
  341. package/dist/utils/platform.js.map +1 -1
  342. package/dist/utils/prompt-errors.d.ts.map +1 -1
  343. package/dist/utils/prompt-errors.js +7 -1
  344. package/dist/utils/prompt-errors.js.map +1 -1
  345. package/dist/utils/shell-escape.d.ts +16 -0
  346. package/dist/utils/shell-escape.d.ts.map +1 -1
  347. package/dist/utils/shell-escape.js +22 -2
  348. package/dist/utils/shell-escape.js.map +1 -1
  349. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  350. package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
  351. package/dist/utils/vcs-provider-detect.js +109 -0
  352. package/dist/utils/vcs-provider-detect.js.map +1 -0
  353. package/dist/utils/workspace-trust.d.ts +20 -17
  354. package/dist/utils/workspace-trust.d.ts.map +1 -1
  355. package/dist/utils/workspace-trust.js +91 -1
  356. package/dist/utils/workspace-trust.js.map +1 -1
  357. package/dist/workflows/auto-sprint.js +180 -32
  358. package/package.json +7 -5
  359. package/packages/apra-fleet-client/src/client/api.mjs +403 -12
  360. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  361. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  362. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +42 -21
  363. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +14 -0
  364. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -46
  365. package/packages/apra-fleet-se/apra-pm/agents/doer.md +157 -134
  366. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +31 -32
  367. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +92 -113
  368. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +40 -42
  369. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +139 -63
  370. package/packages/apra-fleet-se/apra-pm/agents/planner.md +176 -100
  371. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +77 -81
  372. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +69 -85
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
  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/regression-test-runner-output.json +4 -17
  376. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -2
  377. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -4
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -3
  379. package/packages/apra-fleet-se/bin/cli.mjs +280 -3
  380. package/packages/apra-fleet-se/bin/serve.mjs +114 -5
  381. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
  382. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
  383. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
  384. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
  385. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
  386. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
  387. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  388. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
  389. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +199 -34
  390. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
  391. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
  392. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
  393. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  394. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
  395. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
  396. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +285 -4
  397. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +3 -3
  398. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  399. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +12 -12
  400. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
  401. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  402. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
  403. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1054 -39
  404. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +308 -0
  405. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  406. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  407. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  408. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +556 -0
  409. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
  410. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
  411. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  412. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
  413. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  414. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
  415. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -0
  416. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  417. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  418. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  419. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
  420. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
  421. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
  422. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
  423. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
  424. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  425. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
  426. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
  427. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
  428. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
  429. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
  430. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
  431. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
  432. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
  433. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  434. package/packages/apra-fleet-se/fleet-sprint/runner.js +1672 -9072
  435. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
  436. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +159 -0
  437. package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
  438. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
  439. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
  440. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +20 -1
  441. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
  442. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
  443. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
  444. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -0
  445. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  446. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +211 -0
  447. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
  448. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +204 -19
  449. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +707 -12
  450. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  451. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
  452. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +191 -43
  453. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +333 -6
  454. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +165 -0
  455. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +167 -37
  456. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  457. package/packages/apra-fleet-se/package.json +1 -1
  458. package/packages/apra-fleet-workflow/src/viewer/index.mjs +178 -1
  459. package/packages/apra-fleet-workflow/src/workflow/index.mjs +478 -32
  460. package/skills/fleet/SKILL.md +27 -16
  461. package/skills/fleet/auth-azdevops.md +57 -7
  462. package/skills/fleet/auth-bitbucket.md +5 -5
  463. package/skills/fleet/auth-github.md +7 -6
  464. package/skills/fleet/beads-conflict-resolution.md +141 -0
  465. package/skills/fleet/beads.md +16 -12
  466. package/skills/fleet/onboarding.md +6 -6
  467. package/skills/fleet/permissions.md +11 -7
  468. package/skills/fleet/profiles/node.json +1 -1
  469. package/skills/fleet/skill-matrix.md +1 -1
  470. package/skills/fleet/troubleshooting.md +4 -3
  471. package/version.json +1 -1
  472. package/dist/providers/gemini.d.ts +0 -52
  473. package/dist/providers/gemini.d.ts.map +0 -1
  474. package/dist/providers/gemini.js +0 -236
  475. package/dist/providers/gemini.js.map +0 -1
  476. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
@@ -5,12 +5,14 @@ import { execSync, execFileSync } from 'node:child_process';
5
5
  import { serverVersion } from '../version.js';
6
6
  import { DEFAULT_PORT, LOG_FILE_PATH } from '../paths.js';
7
7
  import { getServiceManager } from '../services/service-manager/index.js';
8
- import { BIN_DIR, HOOKS_DIR, SCRIPTS_DIR, getProviderInstallConfig, readConfig, writeConfig, writeInstallConfig, PROVIDER_STANDARD_MODELS } from './config.js';
9
- import { transformAgentForOpenCode, transformAgentForAgy } from './agent-transform.js';
8
+ import { LINUX_UNIT_NAME, MACOS_PLIST_LABEL, WINDOWS_TASK_NAME } from '../services/service-manager/types.js';
9
+ import { BIN_DIR, HOOKS_DIR, SCRIPTS_DIR, getProviderInstallConfig, readConfig, writeConfig, writeInstallConfig, PROVIDER_STANDARD_MODELS, INSTALLABLE_LLM_PROVIDERS } from './config.js';
10
+ import { transformAgentForOpenCode, transformAgentForAgy, transformAgentForClaude } from './agent-transform.js';
10
11
  import { FLEET_DIR } from '../paths.js';
11
12
  import { extractWorkflowSubsystemAssets } from './workflow-assets.js';
12
13
  import { downloadAndExtractDolt, verifyDolt } from './dolt-install.js';
13
14
  import { classifyRunningServer, getInstallDataDir } from './install-guard.js';
15
+ import { convertClaudeAllowToAgyPermissions, formatAgyPermissionRules } from '../providers/agy.js';
14
16
  const realDoltStepDeps = { downloadAndExtractDolt, verifyDolt };
15
17
  let doltStepDeps = realDoltStepDeps;
16
18
  /** Test-only: inject fakes for the dolt CLI install step's download/verify calls. */
@@ -26,6 +28,71 @@ function doltStepEnabled() {
26
28
  return true;
27
29
  return process.env.APRA_FLEET_ENABLE_DOLT_INSTALL === '1';
28
30
  }
31
+ const FLEET_SE_MIN_NODE = [22, 16, 0];
32
+ function probeVersion(cmd, shell) {
33
+ try {
34
+ const out = execFileSync(cmd, ['--version'], { stdio: 'pipe', encoding: 'utf-8', timeout: 15_000, shell });
35
+ return String(out).trim() || null;
36
+ }
37
+ catch {
38
+ return null;
39
+ }
40
+ }
41
+ // System node from PATH, NOT process.version (in SEA mode that is the embedded runtime).
42
+ // node/npm can be .cmd shims on Windows (nvm-windows, corporate wrappers), so both need shell:true.
43
+ const realFleetSePrereqProbes = {
44
+ nodeVersion: () => probeVersion('node', true),
45
+ npmVersion: () => probeVersion('npm', true),
46
+ };
47
+ let fleetSePrereqProbes = realFleetSePrereqProbes;
48
+ /** Test-only: the real (non-overridden) probes, to assert their exec options. */
49
+ export const _realFleetSePrereqProbes = realFleetSePrereqProbes;
50
+ /** Test-only: inject fake probes for the fleet-se prerequisite check. */
51
+ export function _setFleetSePrereqProbes(overrides) {
52
+ fleetSePrereqProbes = { ...realFleetSePrereqProbes, ...overrides };
53
+ }
54
+ /** Test-only: restore the real fleet-se prerequisite probes. */
55
+ export function _resetFleetSePrereqProbes() {
56
+ fleetSePrereqProbes = realFleetSePrereqProbes;
57
+ }
58
+ function fleetSePrereqCheckEnabled() {
59
+ if (process.env.NODE_ENV !== 'test')
60
+ return true;
61
+ return process.env.APRA_FLEET_ENABLE_FLEET_SE_PREREQ_CHECK === '1';
62
+ }
63
+ function nodeVersionSatisfies(raw) {
64
+ const m = raw.trim().replace(/^v/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
65
+ if (!m)
66
+ return false;
67
+ const v = [Number(m[1]), Number(m[2]), Number(m[3])];
68
+ for (let i = 0; i < 3; i++) {
69
+ if (v[i] !== FLEET_SE_MIN_NODE[i])
70
+ return v[i] > FLEET_SE_MIN_NODE[i];
71
+ }
72
+ return true;
73
+ }
74
+ export function checkFleetSePrereqs(probes) {
75
+ const missing = [];
76
+ const causes = [];
77
+ const minNode = FLEET_SE_MIN_NODE.join('.');
78
+ const node = probes.nodeVersion();
79
+ if (node === null) {
80
+ missing.push('node');
81
+ causes.push('Node.js not found on PATH');
82
+ }
83
+ else if (!nodeVersionSatisfies(node)) {
84
+ missing.push('node');
85
+ causes.push(`Node.js ${node.trim()} found, ${minNode}+ required`);
86
+ }
87
+ if (probes.npmVersion() === null) {
88
+ missing.push('npm');
89
+ causes.push('npm not found on PATH');
90
+ }
91
+ if (missing.length === 0)
92
+ return { ok: true, missing, message: '' };
93
+ const message = `${causes.join('; ')}. fleet-se requires Node.js 22.16+ and npm. Install them and re-run, or use --workflows none to install the core only.`;
94
+ return { ok: false, missing, message };
95
+ }
29
96
  // Detect SEA mode
30
97
  let _seaOverride = null;
31
98
  /** Override isSea() result -- for tests only. Pass null to restore default. */
@@ -408,14 +475,6 @@ function writeAssetFile(destPath, content) {
408
475
  fs.mkdirSync(path.dirname(destPath), { recursive: true });
409
476
  fs.writeFileSync(destPath, content);
410
477
  }
411
- // Gemini CLI uses different hook event names than Claude CLI.
412
- const GEMINI_HOOK_NAME_MAP = {
413
- PostToolUse: 'AfterTool',
414
- PreToolUse: 'BeforeTool',
415
- UserPromptSubmit: 'BeforeAgent',
416
- Stop: 'SessionEnd',
417
- PreCompact: 'PreCompress',
418
- };
419
478
  function mergeHooksConfig(paths, hooksConfig, provider) {
420
479
  let settingsFile = paths.settingsFile;
421
480
  const isAgy = provider === 'agy';
@@ -436,13 +495,7 @@ function mergeHooksConfig(paths, hooksConfig, provider) {
436
495
  }
437
496
  settings.hooks = settings.hooks || {};
438
497
  for (const [claudeName, hookEntries] of Object.entries(hooksConfig.hooks || {})) {
439
- const eventName = provider === 'gemini'
440
- ? (GEMINI_HOOK_NAME_MAP[claudeName] ?? claudeName)
441
- : claudeName;
442
- // Remove stale Claude-style key if we're writing under a different Gemini name.
443
- if (provider === 'gemini' && claudeName in GEMINI_HOOK_NAME_MAP && claudeName !== eventName) {
444
- delete settings.hooks[claudeName];
445
- }
498
+ const eventName = claudeName;
446
499
  settings.hooks[eventName] = settings.hooks[eventName] || [];
447
500
  for (const newHook of hookEntries) {
448
501
  const idx = settings.hooks[eventName].findIndex((h) => h.matcher === newHook.matcher);
@@ -462,7 +515,17 @@ function mergeHooksConfig(paths, hooksConfig, provider) {
462
515
  }
463
516
  }
464
517
  const CLAUDE_INVALID_RULES = ['tracker_*'];
518
+ /** AGY validates every permissions.allow entry against this regex (verbatim
519
+ * from the agy CLI binary, 1.2.8) and ignores anything that fails it. */
520
+ const AGY_RULE_RE = /^(command|read_file|write_file|read_url|mcp|execute_url|unsandboxed)\s*\(.*\)$/;
465
521
  export function pruneInvalidRules(allow, providerName) {
522
+ if (providerName === 'Antigravity') {
523
+ // Self-heal: strip Claude-syntax entries a previous install wrote into
524
+ // AGY's settings.json (mcp__apra-fleet__*, Agent(*), tracker_*, ...). AGY
525
+ // rejects them already, so removing them changes no effective grant -- it
526
+ // only stops fleet from leaving junk in a file the human user also owns.
527
+ return allow.filter(rule => AGY_RULE_RE.test(rule));
528
+ }
466
529
  if (providerName !== 'Claude')
467
530
  return allow;
468
531
  return allow.filter(rule => !CLAUDE_INVALID_RULES.includes(rule));
@@ -486,7 +549,18 @@ export function buildRequiredPerms(paths) {
486
549
  }
487
550
  function mergePermissions(paths, extraPerms = []) {
488
551
  const settings = readConfig(paths);
489
- const requiredPerms = [...buildRequiredPerms(paths), ...extraPerms];
552
+ let requiredPerms = [...buildRequiredPerms(paths), ...extraPerms];
553
+ if (paths.name === 'Antigravity') {
554
+ // buildRequiredPerms speaks Claude's permission vocabulary. AGY accepts
555
+ // only `action(target)` strings from a fixed action set, so the Read(<dir>)
556
+ // grants are translated to read_file(<dir>) and the tokens with no AGY
557
+ // equivalent (mcp__apra-fleet__*, activate_skill(*), Agent(*), tracker_*)
558
+ // are dropped -- same "no Antigravity equivalent" handling the agent
559
+ // transform already applies to unsupported tools. Writing them verbatim
560
+ // left AGY with an allow-list it discarded wholesale, so every headless
561
+ // dispatch hit the auto-deny wall on its first tool call.
562
+ requiredPerms = formatAgyPermissionRules(convertClaudeAllowToAgyPermissions(requiredPerms));
563
+ }
490
564
  settings.permissions = settings.permissions || {};
491
565
  settings.permissions.allow = settings.permissions.allow || [];
492
566
  settings.permissions.allow = pruneInvalidRules(settings.permissions.allow, paths.name);
@@ -521,15 +595,6 @@ function configureStatusline(paths, scriptPath, llm) {
521
595
  };
522
596
  writeConfig(paths, settings);
523
597
  }
524
- function mergeGeminiConfig(paths, mcpConfig) {
525
- const settings = readConfig(paths);
526
- settings.mcpServers = settings.mcpServers || {};
527
- settings.mcpServers['apra-fleet'] = {
528
- ...mcpConfig,
529
- trust: true,
530
- };
531
- writeConfig(paths, settings);
532
- }
533
598
  function mergeAgyConfig(paths, mcpConfig) {
534
599
  const configDir = path.join(os.homedir(), '.gemini', 'config');
535
600
  fs.mkdirSync(configDir, { recursive: true });
@@ -602,29 +667,47 @@ function isCommandAvailable(cmd) {
602
667
  return false;
603
668
  }
604
669
  }
605
- export function isApraFleetRunning() {
670
+ /**
671
+ * PIDs of every non-installer apra-fleet process currently running, as strings.
672
+ *
673
+ * OS-global on purpose -- isApraFleetRunning() is defined in terms of this, and
674
+ * waitForApraFleetToStop()/uninstall.ts depend on that scope. The current
675
+ * process is always excluded so a self-update (the installed apra-fleet binary
676
+ * running `install`) never sees itself.
677
+ *
678
+ * Exposed separately from the boolean so the install --force guard can tell
679
+ * "the SAME process is refusing to die" from "the supervisor relaunched it
680
+ * under a NEW pid" -- those need different remedies and different error text
681
+ * (see the service-aware stop note below).
682
+ */
683
+ export function apraFleetPids() {
606
684
  try {
685
+ const currentPid = process.pid.toString();
607
686
  if (process.platform === 'win32') {
608
687
  const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe' });
609
- const currentPid = process.pid.toString();
610
688
  // Each CSV line: "apra-fleet.exe","<PID>","..." - exclude the current installer process
611
- return out.split('\n').some(line => {
612
- const match = line.match(/"apra-fleet\.exe","(\d+)"/);
613
- return match !== null && match[1] !== currentPid;
614
- });
689
+ return out.split('\n')
690
+ .map(line => line.match(/"apra-fleet\.exe","(\d+)"/))
691
+ .filter((match) => match !== null)
692
+ .map(match => match[1])
693
+ .filter(pid => pid !== currentPid);
615
694
  }
616
695
  else {
617
696
  // -x = exact name match; installer is apra-fleet-installer-* so won't match;
618
697
  // exclude current PID to handle self-update (installed apra-fleet binary running install)
619
698
  const out = execSync('pgrep -x apra-fleet', { encoding: 'utf-8', stdio: 'pipe' });
620
- const currentPid = process.pid.toString();
621
- return out.split('\n').some(line => line.trim() !== '' && line.trim() !== currentPid);
699
+ return out.split('\n')
700
+ .map(line => line.trim())
701
+ .filter(pid => pid !== '' && pid !== currentPid);
622
702
  }
623
703
  }
624
704
  catch {
625
- return false;
705
+ return [];
626
706
  }
627
707
  }
708
+ export function isApraFleetRunning() {
709
+ return apraFleetPids().length > 0;
710
+ }
628
711
  export function killApraFleet(signal = 'SIGTERM') {
629
712
  if (process.platform === 'win32') {
630
713
  // taskkill /F is already forceful -- no softer signal to escalate from,
@@ -678,6 +761,71 @@ export async function waitForApraFleetToStop() {
678
761
  await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
679
762
  }
680
763
  }
764
+ // --- install --force service-aware stop ---
765
+ //
766
+ // killApraFleet() signals the server by process NAME. When the server is
767
+ // registered with the platform service manager that is a race the installer
768
+ // cannot win: the macOS LaunchAgent this installer writes declares
769
+ // KeepAlive/SuccessfulExit=false (src/services/service-manager/macos.ts), so
770
+ // launchd relaunches the server under a NEW pid the instant a SIGKILL takes it
771
+ // down, and the liveness poll below then reports "still running" forever. The
772
+ // systemd unit's Restart=on-failure has the same shape. The remedy is to stop
773
+ // the SERVICE first: ServiceManager.stop() performs a graceful shutdown that
774
+ // exits 0, which neither supervisor restarts.
775
+ /**
776
+ * The platform ServiceManager, but only when a service is actually registered.
777
+ * Any failure to determine that (no systemd, unsupported platform, adapter
778
+ * error) is indistinguishable from "nothing registered" for the guard's
779
+ * purposes, so it degrades to the historical kill path rather than throwing.
780
+ */
781
+ async function registeredServiceManager() {
782
+ try {
783
+ const mgr = await getServiceManager();
784
+ return (await mgr.isInstalled()) ? mgr : null;
785
+ }
786
+ catch {
787
+ return null;
788
+ }
789
+ }
790
+ /** Exact command an operator can run to bring the registered service back up. */
791
+ export function serviceRestartCommand() {
792
+ switch (process.platform) {
793
+ case 'win32': return `schtasks /run /tn ${WINDOWS_TASK_NAME}`;
794
+ case 'linux': return `systemctl --user start ${LINUX_UNIT_NAME}`;
795
+ case 'darwin': return `launchctl kickstart -k gui/${macosGuiUid()}/${MACOS_PLIST_LABEL}`;
796
+ default: return 'apra-fleet install';
797
+ }
798
+ }
799
+ /** Exact command an operator can run to take the registered service down. */
800
+ export function serviceStopCommand() {
801
+ switch (process.platform) {
802
+ case 'win32': return `schtasks /end /tn ${WINDOWS_TASK_NAME}`;
803
+ case 'linux': return `systemctl --user stop ${LINUX_UNIT_NAME}`;
804
+ case 'darwin': return `launchctl bootout gui/${macosGuiUid()}/${MACOS_PLIST_LABEL}`;
805
+ default: return 'apra-fleet uninstall';
806
+ }
807
+ }
808
+ // Resolved in JS, never left to shell expansion: the printed command must be
809
+ // copy-pasteable as-is (mirrors getUid() in service-manager/macos.ts).
810
+ function macosGuiUid() {
811
+ return typeof process.getuid === 'function' ? String(process.getuid()) : '501';
812
+ }
813
+ /**
814
+ * Poll for the server to disappear after ServiceManager.stop(), WITHOUT
815
+ * signalling it -- signalling is exactly what loses the race against a
816
+ * supervisor relaunch. Returns the pids still observed once the window closes
817
+ * (empty when the service is down).
818
+ */
819
+ async function waitForServiceStop() {
820
+ const { pollIntervalMs, graceMs } = installForceTiming();
821
+ const deadline = Date.now() + graceMs;
822
+ let pids = apraFleetPids();
823
+ while (pids.length > 0 && Date.now() < deadline) {
824
+ await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
825
+ pids = apraFleetPids();
826
+ }
827
+ return pids;
828
+ }
681
829
  /**
682
830
  * Write empty .ignore overlay files into a LOCAL agy member's workspace to block
683
831
  * the global apra-fleet MCP server and PM/fleet skills from loading inside that
@@ -736,16 +884,14 @@ Usage:
736
884
  apra-fleet install --no-skill Same as --skill none
737
885
  apra-fleet install --workflows none Skip installing the workflow runtime + built-in workflows
738
886
  apra-fleet install --force Stop a running server before installing
739
- apra-fleet install --llm <provider> Target LLM provider: claude (default), gemini, codex, copilot, agy, opencode
887
+ apra-fleet install --llm <provider> Target LLM provider: claude (default), codex, copilot, agy, opencode
740
888
  apra-fleet install --transport http Register MCP server with HTTP transport (default)
741
889
  apra-fleet install --transport stdio Register MCP server with stdio transport (legacy)
742
890
  apra-fleet install --help Show this help
743
891
 
744
892
  Options:
745
- --llm <provider> LLM provider to configure. Supported: claude, gemini, codex, copilot, agy, opencode.
746
- Defaults to claude. Note: --llm gemini shows a warning about sequential
747
- dispatch -- Gemini does not support background agents, so fleet operations
748
- run sequentially rather than in parallel.
893
+ --llm <provider> LLM provider to configure. Supported: claude, codex, copilot, agy, opencode.
894
+ Defaults to claude.
749
895
  --transport <mode> MCP transport to use: http (default) or stdio. HTTP uses the singleton
750
896
  fleet server at http://localhost:7523/mcp. stdio runs fleet as a subprocess.
751
897
  --skill <mode> Which skills to install: all (default), fleet, pm, or none.
@@ -753,6 +899,7 @@ Options:
753
899
  --workflows <mode> Which workflow assets to install: all (default) or none. Installs
754
900
  ~/.apra-fleet/node_modules (workflow runtime), /schemas (agent role
755
901
  schemas), and /workflows/{fleet-sprint,hello-world} (built-in workflows).
902
+ fleet-se requires Node.js 22.16+ and npm.
756
903
  --force Stop a running apra-fleet server before installing (SEA mode only).`);
757
904
  process.exit(0);
758
905
  return;
@@ -769,7 +916,7 @@ Options:
769
916
  llm = args[idx + 1];
770
917
  }
771
918
  }
772
- const supported = ['claude', 'gemini', 'codex', 'copilot', 'agy', 'opencode'];
919
+ const supported = INSTALLABLE_LLM_PROVIDERS;
773
920
  if (!supported.includes(llm)) {
774
921
  console.error(`Error: Unsupported LLM provider "${llm}". Supported: ${supported.join(', ')}`);
775
922
  process.exit(1);
@@ -873,6 +1020,14 @@ Options:
873
1020
  const installPm = skillMode === 'pm' || skillMode === 'all';
874
1021
  const installAgents = installPm && paths.agentsDir !== undefined;
875
1022
  const installWorkflows = workflowsMode === 'all';
1023
+ // fleet-se prerequisites: fail before the running-process guard so nothing is stopped or written.
1024
+ if (installWorkflows && fleetSePrereqCheckEnabled()) {
1025
+ const prereq = checkFleetSePrereqs(fleetSePrereqProbes);
1026
+ if (!prereq.ok) {
1027
+ console.error(`Error: ${prereq.message}`);
1028
+ process.exit(1);
1029
+ }
1030
+ }
876
1031
  const serviceStep = isSea() && transport === 'http';
877
1032
  let totalSteps = (installFleet && installPm) ? 8 : installFleet ? 7 : installPm ? 8 : 6;
878
1033
  if (installAgents)
@@ -885,9 +1040,6 @@ Options:
885
1040
  totalSteps++; // KB + code intelligence setup -- unconditional, runs after Beads
886
1041
  if (serviceStep)
887
1042
  totalSteps++;
888
- if (llm === 'gemini' && (installFleet || installPm)) {
889
- console.warn(`\n- Note: Gemini does not support background agents. If you plan to use Gemini as the\n PM/orchestrator, fleet operations will run sequentially (no parallel dispatch).\n For best orchestration performance, consider using Claude. See docs for details.\n`);
890
- }
891
1043
  // --- Running-process guard (SEA + npm modes -- dev mode runs via node, not a managed binary) ---
892
1044
  //
893
1045
  // isApraFleetRunning() is OS-global on purpose (waitForApraFleetToStop() and
@@ -903,6 +1055,10 @@ Options:
903
1055
  if (runningScope && !runningScope.relevant) {
904
1056
  console.log(`\n Note: an unrelated apra-fleet server is running -- ${runningScope.detail}.\n It is not associated with this install (data dir ${getInstallDataDir()}, prefix ${BIN_DIR}), so it is left running.\n`);
905
1057
  }
1058
+ // Set when the --force guard below stopped a REGISTERED service, so the
1059
+ // binary-copy step can bring it back up instead of leaving it down.
1060
+ let guardServiceMgr = null;
1061
+ let guardStoppedService = false;
906
1062
  if (runningScope?.relevant) {
907
1063
  if (!force) {
908
1064
  const killHint = process.platform === 'win32'
@@ -920,9 +1076,49 @@ ${killHint}
920
1076
  `);
921
1077
  process.exit(1);
922
1078
  }
923
- killApraFleet();
924
- await waitForApraFleetToStop();
925
- if (isApraFleetRunning()) {
1079
+ // Snapshot BEFORE anything is stopped: a pid that is present afterwards but
1080
+ // absent here is a supervisor relaunch, not a process refusing to die.
1081
+ const pidsBeforeStop = apraFleetPids();
1082
+ guardServiceMgr = await registeredServiceManager();
1083
+ if (guardServiceMgr) {
1084
+ // A service is registered: stop the SERVICE, never pkill first.
1085
+ console.log(' Registered service detected -- stopping it through the service manager.');
1086
+ try {
1087
+ await guardServiceMgr.stop();
1088
+ guardStoppedService = true;
1089
+ }
1090
+ catch (err) {
1091
+ console.warn(` Service stop failed: ${err.message}`);
1092
+ }
1093
+ const stillUp = await waitForServiceStop();
1094
+ // Escalate ONLY when the very same pids are still there -- i.e. nothing
1095
+ // relaunched the server and there is no supervisor race to lose. If a NEW
1096
+ // pid appeared, signalling by name is futile and is deliberately skipped
1097
+ // so the relaunch is reported instead of retried forever.
1098
+ if (stillUp.length > 0 && stillUp.every(pid => pidsBeforeStop.includes(pid))) {
1099
+ killApraFleet();
1100
+ await waitForApraFleetToStop();
1101
+ }
1102
+ }
1103
+ else {
1104
+ // No service registered: historical path, unchanged.
1105
+ killApraFleet();
1106
+ await waitForApraFleetToStop();
1107
+ }
1108
+ const pidsAfterStop = apraFleetPids();
1109
+ if (pidsAfterStop.length > 0) {
1110
+ const relaunchedPids = pidsAfterStop.filter(pid => !pidsBeforeStop.includes(pid));
1111
+ if (relaunchedPids.length > 0) {
1112
+ console.error(`
1113
+ Error: the apra-fleet server was RELAUNCHED by its service supervisor while
1114
+ install --force was stopping it -- the observed pid changed between polls (was
1115
+ ${pidsBeforeStop.join(', ') || 'none'}, now ${pidsAfterStop.join(', ')}), so it did not merely refuse to die.
1116
+ Signalling the process by name cannot win that race. Stop the service itself,
1117
+ then re-run the install:
1118
+ ${serviceStopCommand()}
1119
+ `);
1120
+ process.exit(1);
1121
+ }
926
1122
  console.error(`
927
1123
  Error: could not stop the running apra-fleet server (it is still running after
928
1124
  SIGTERM and a SIGKILL escalation). Stop it manually before installing:
@@ -952,6 +1148,25 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
952
1148
  else {
953
1149
  console.log(` [1/${totalSteps}] Dev mode -- skipping binary copy`);
954
1150
  }
1151
+ // A registered service that the --force guard stopped must never be left
1152
+ // permanently down. When serviceStep is set the final install step
1153
+ // re-registers and starts it, so restarting here would only add a redundant
1154
+ // bootout/bootstrap cycle mid-install; otherwise nothing else would ever
1155
+ // bring it back, so start it now that the new binary is in place. Either way
1156
+ // the exact restart command is printed, so a failure at any later step stays
1157
+ // recoverable by hand.
1158
+ if (guardStoppedService && guardServiceMgr) {
1159
+ console.log(` The registered service was stopped by --force. Restart command: ${serviceRestartCommand()}`);
1160
+ if (!serviceStep) {
1161
+ try {
1162
+ await guardServiceMgr.start();
1163
+ console.log(' Restarted the registered service.');
1164
+ }
1165
+ catch (err) {
1166
+ console.warn(` [WARN] Could not restart the registered service: ${err.message}`);
1167
+ }
1168
+ }
1169
+ }
955
1170
  // --- Step 2: Extract hooks ---
956
1171
  console.log(` [2/${totalSteps}] Installing hooks...`);
957
1172
  const manifest = loadManifest();
@@ -1004,9 +1219,6 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1004
1219
  run(`claude mcp add --scope user --transport http apra-fleet ${fleetUrl}`);
1005
1220
  }
1006
1221
  }
1007
- else if (llm === 'gemini') {
1008
- mergeGeminiConfig(paths, { httpUrl: fleetUrl });
1009
- }
1010
1222
  else if (llm === 'codex') {
1011
1223
  mergeCodexConfig(paths, { url: fleetUrl });
1012
1224
  }
@@ -1048,9 +1260,6 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1048
1260
  run(cmd);
1049
1261
  }
1050
1262
  }
1051
- else if (llm === 'gemini') {
1052
- mergeGeminiConfig(paths, mcpConfig);
1053
- }
1054
1263
  else if (llm === 'codex') {
1055
1264
  mergeCodexConfig(paths, mcpConfig);
1056
1265
  }
@@ -1282,11 +1491,15 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1282
1491
  // as a fallback), preserving this branch's no-dist/agents rule, and it
1283
1492
  // recurses into _shared/ and schemas/ which the old flat readdir missed.
1284
1493
  for (const { relPath, content: rawContent } of loadAgentAssets()) {
1494
+ // Every branch runs a transform -- the default one is NOT a passthrough. Claude
1495
+ // keeps the source frontmatter and every conditional's if-branch, but the
1496
+ // conditional markers themselves still have to be stripped or they ship
1497
+ // verbatim into the installed agent file (apra-fleet-oomh.1).
1285
1498
  const content = llm === 'opencode'
1286
1499
  ? transformAgentForOpenCode(rawContent, relPath)
1287
1500
  : llm === 'agy'
1288
1501
  ? transformAgentForAgy(rawContent, relPath)
1289
- : rawContent;
1502
+ : transformAgentForClaude(rawContent, relPath);
1290
1503
  writeAssetFile(path.join(agentsDestDir, relPath), content);
1291
1504
  }
1292
1505
  }
@@ -1357,7 +1570,9 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1357
1570
  }
1358
1571
  catch {
1359
1572
  // not installed - install it
1360
- execFileSync('npm', ['install', '-g', '@beads/bd@1.1.2'], { stdio: 'inherit', shell: true });
1573
+ // apra-fleet-4ipl: bumped 1.1.2 -> 1.3.0 to match .github/workflows/ci.yml's
1574
+ // pin -- see that file's comment for why (schema v66 compatibility).
1575
+ execFileSync('npm', ['install', '-g', '@beads/bd@1.3.0'], { stdio: 'inherit', shell: true });
1361
1576
  }
1362
1577
  }
1363
1578
  catch (err) {
@@ -1431,25 +1646,43 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1431
1646
  writeInstallConfig(llm, skillMode, workflowsMode);
1432
1647
  // --- Step N: Register and start service (SEA + HTTP mode only) ---
1433
1648
  let serviceRegistered = false;
1649
+ let serviceReused = false;
1434
1650
  if (serviceStep) {
1435
1651
  console.log(` [${totalSteps}/${totalSteps}] Registering and starting service...`);
1436
1652
  const svcMgr = await getServiceManager();
1437
1653
  try {
1438
- await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH);
1654
+ serviceReused = (await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH)) === 'reused';
1655
+ if (serviceReused)
1656
+ console.log(' Could not recreate the service task -- existing task reused.');
1439
1657
  try {
1440
1658
  await svcMgr.start();
1441
1659
  serviceRegistered = true;
1442
1660
  }
1443
1661
  catch (startErr) {
1444
- try {
1445
- await svcMgr.unregister();
1662
+ // Never delete a reused task: it predates this install (e.g. elevated).
1663
+ if (!serviceReused) {
1664
+ try {
1665
+ await svcMgr.unregister();
1666
+ }
1667
+ catch { }
1446
1668
  }
1447
- catch { }
1448
1669
  throw startErr;
1449
1670
  }
1450
1671
  }
1451
1672
  catch (err) {
1452
1673
  console.warn(` Service registration skipped: ${err.message}`);
1674
+ // --force stopped the server; reporting success would leave it down silently.
1675
+ if (force && (runningScope?.relevant || guardStoppedService)) {
1676
+ const restartHint = guardStoppedService
1677
+ ? `Start it with:\n ${serviceRestartCommand()}\nor re-run the install from an elevated prompt.`
1678
+ : 'Start it with:\n apra-fleet start';
1679
+ console.error(`
1680
+ Error: install --force stopped the running apra-fleet server, but the service
1681
+ could not be registered/started, so the server is NOT running.
1682
+ ${restartHint}
1683
+ `);
1684
+ process.exit(1);
1685
+ }
1453
1686
  }
1454
1687
  }
1455
1688
  // --- Done ---
@@ -1464,7 +1697,7 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1464
1697
  const clientName = llm === 'claude' ? 'Claude Code' : paths.name;
1465
1698
  const instructions = llm === 'claude' ? 'Run /mcp in Claude Code to load the server.' : `Restart ${paths.name} to load the server.`;
1466
1699
  const forceNote = force ? `\nRestart ${clientName} to reload the MCP server.` : '';
1467
- const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ? 'registered and running' : 'registration skipped'}` : '';
1700
+ const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ? `registered and running${serviceReused ? ' (existing task reused)' : ''}` : 'registration skipped'}` : '';
1468
1701
  console.log(`
1469
1702
  Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
1470
1703
  Binary: ${BIN_DIR}