@apralabs/apra-fleet 0.4.2 → 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 (370) hide show
  1. package/README.md +38 -5
  2. package/dist/agents/backlog-groomer.md +25 -0
  3. package/dist/agents/ci-watcher.md +11 -0
  4. package/dist/agents/deployer.md +37 -2
  5. package/dist/agents/doer.md +36 -12
  6. package/dist/agents/harvester.md +11 -0
  7. package/dist/agents/integ-test-runner.md +11 -0
  8. package/dist/agents/kb-reconciler.md +9 -0
  9. package/dist/agents/plan-reviewer.md +110 -22
  10. package/dist/agents/planner.md +125 -37
  11. package/dist/agents/regression-test-runner.md +11 -0
  12. package/dist/agents/reviewer.md +13 -2
  13. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  14. package/dist/cli/agent-transform.d.ts +83 -2
  15. package/dist/cli/agent-transform.d.ts.map +1 -1
  16. package/dist/cli/agent-transform.js +266 -21
  17. package/dist/cli/agent-transform.js.map +1 -1
  18. package/dist/cli/auth.d.ts.map +1 -1
  19. package/dist/cli/auth.js +28 -9
  20. package/dist/cli/auth.js.map +1 -1
  21. package/dist/cli/config.d.ts +7 -5
  22. package/dist/cli/config.d.ts.map +1 -1
  23. package/dist/cli/config.js +44 -34
  24. package/dist/cli/config.js.map +1 -1
  25. package/dist/cli/install.d.ts +33 -0
  26. package/dist/cli/install.d.ts.map +1 -1
  27. package/dist/cli/install.js +290 -23
  28. package/dist/cli/install.js.map +1 -1
  29. package/dist/cli/kb-directives.d.ts.map +1 -1
  30. package/dist/cli/kb-directives.js +2 -1
  31. package/dist/cli/kb-directives.js.map +1 -1
  32. package/dist/cli/register-member.d.ts.map +1 -1
  33. package/dist/cli/register-member.js +6 -2
  34. package/dist/cli/register-member.js.map +1 -1
  35. package/dist/commands/kb-server.d.ts +3 -0
  36. package/dist/commands/kb-server.d.ts.map +1 -1
  37. package/dist/commands/kb-server.js +43 -3
  38. package/dist/commands/kb-server.js.map +1 -1
  39. package/dist/index.js +3 -3
  40. package/dist/os/linux.d.ts +6 -0
  41. package/dist/os/linux.d.ts.map +1 -1
  42. package/dist/os/linux.js +35 -2
  43. package/dist/os/linux.js.map +1 -1
  44. package/dist/os/os-commands.d.ts +61 -2
  45. package/dist/os/os-commands.d.ts.map +1 -1
  46. package/dist/os/windows-gitbash.d.ts +5 -0
  47. package/dist/os/windows-gitbash.d.ts.map +1 -1
  48. package/dist/os/windows-gitbash.js +15 -0
  49. package/dist/os/windows-gitbash.js.map +1 -1
  50. package/dist/os/windows.d.ts +6 -0
  51. package/dist/os/windows.d.ts.map +1 -1
  52. package/dist/os/windows.js +46 -3
  53. package/dist/os/windows.js.map +1 -1
  54. package/dist/providers/agy.d.ts +115 -6
  55. package/dist/providers/agy.d.ts.map +1 -1
  56. package/dist/providers/agy.js +569 -53
  57. package/dist/providers/agy.js.map +1 -1
  58. package/dist/providers/claude.d.ts +81 -3
  59. package/dist/providers/claude.d.ts.map +1 -1
  60. package/dist/providers/claude.js +344 -10
  61. package/dist/providers/claude.js.map +1 -1
  62. package/dist/providers/codex.d.ts +4 -2
  63. package/dist/providers/codex.d.ts.map +1 -1
  64. package/dist/providers/codex.js +19 -2
  65. package/dist/providers/codex.js.map +1 -1
  66. package/dist/providers/copilot.d.ts +4 -2
  67. package/dist/providers/copilot.d.ts.map +1 -1
  68. package/dist/providers/copilot.js +20 -2
  69. package/dist/providers/copilot.js.map +1 -1
  70. package/dist/providers/none.d.ts +4 -2
  71. package/dist/providers/none.d.ts.map +1 -1
  72. package/dist/providers/none.js +17 -2
  73. package/dist/providers/none.js.map +1 -1
  74. package/dist/providers/opencode.d.ts +3 -1
  75. package/dist/providers/opencode.d.ts.map +1 -1
  76. package/dist/providers/opencode.js +22 -2
  77. package/dist/providers/opencode.js.map +1 -1
  78. package/dist/providers/provider.d.ts +201 -6
  79. package/dist/providers/provider.d.ts.map +1 -1
  80. package/dist/providers/provider.js +56 -0
  81. package/dist/providers/provider.js.map +1 -1
  82. package/dist/services/agy-project.d.ts +102 -0
  83. package/dist/services/agy-project.d.ts.map +1 -0
  84. package/dist/services/agy-project.js +356 -0
  85. package/dist/services/agy-project.js.map +1 -0
  86. package/dist/services/auth-socket.js +4 -4
  87. package/dist/services/auth-web.js +1 -1
  88. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  89. package/dist/services/cloud/lifecycle.js +33 -4
  90. package/dist/services/cloud/lifecycle.js.map +1 -1
  91. package/dist/services/credential-cleanup.d.ts.map +1 -1
  92. package/dist/services/credential-cleanup.js +35 -17
  93. package/dist/services/credential-cleanup.js.map +1 -1
  94. package/dist/services/exit-drain.d.ts +44 -0
  95. package/dist/services/exit-drain.d.ts.map +1 -0
  96. package/dist/services/exit-drain.js +52 -0
  97. package/dist/services/exit-drain.js.map +1 -0
  98. package/dist/services/github-app.d.ts.map +1 -1
  99. package/dist/services/github-app.js +32 -4
  100. package/dist/services/github-app.js.map +1 -1
  101. package/dist/services/http-transport.d.ts +1 -0
  102. package/dist/services/http-transport.d.ts.map +1 -1
  103. package/dist/services/http-transport.js +48 -1
  104. package/dist/services/http-transport.js.map +1 -1
  105. package/dist/services/knowledge/kb-config.d.ts +42 -0
  106. package/dist/services/knowledge/kb-config.d.ts.map +1 -0
  107. package/dist/services/knowledge/kb-config.js +54 -0
  108. package/dist/services/knowledge/kb-config.js.map +1 -0
  109. package/dist/services/knowledge/kb-providers.d.ts +7 -1
  110. package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
  111. package/dist/services/knowledge/kb-providers.js +191 -17
  112. package/dist/services/knowledge/kb-providers.js.map +1 -1
  113. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  114. package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
  115. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  116. package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
  117. package/dist/services/model-pricing.d.ts.map +1 -1
  118. package/dist/services/model-pricing.js +7 -3
  119. package/dist/services/model-pricing.js.map +1 -1
  120. package/dist/services/secret-token.d.ts +38 -0
  121. package/dist/services/secret-token.d.ts.map +1 -0
  122. package/dist/services/secret-token.js +51 -0
  123. package/dist/services/secret-token.js.map +1 -0
  124. package/dist/services/service-manager/types.d.ts +3 -1
  125. package/dist/services/service-manager/types.d.ts.map +1 -1
  126. package/dist/services/service-manager/windows.d.ts +14 -2
  127. package/dist/services/service-manager/windows.d.ts.map +1 -1
  128. package/dist/services/service-manager/windows.js +65 -7
  129. package/dist/services/service-manager/windows.js.map +1 -1
  130. package/dist/services/ssh.d.ts.map +1 -1
  131. package/dist/services/ssh.js +58 -2
  132. package/dist/services/ssh.js.map +1 -1
  133. package/dist/services/stall/read-log-tail.d.ts.map +1 -1
  134. package/dist/services/stall/read-log-tail.js +20 -10
  135. package/dist/services/stall/read-log-tail.js.map +1 -1
  136. package/dist/services/stall/stall-detector.d.ts +53 -4
  137. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  138. package/dist/services/stall/stall-detector.js +212 -34
  139. package/dist/services/stall/stall-detector.js.map +1 -1
  140. package/dist/services/strategy.d.ts.map +1 -1
  141. package/dist/services/strategy.js +79 -2
  142. package/dist/services/strategy.js.map +1 -1
  143. package/dist/services/substitution-engine.js +2 -2
  144. package/dist/services/substitution-engine.js.map +1 -1
  145. package/dist/services/tool-registry.d.ts.map +1 -1
  146. package/dist/services/tool-registry.js +5 -3
  147. package/dist/services/tool-registry.js.map +1 -1
  148. package/dist/services/vcs/azure-devops.d.ts +66 -1
  149. package/dist/services/vcs/azure-devops.d.ts.map +1 -1
  150. package/dist/services/vcs/azure-devops.js +192 -21
  151. package/dist/services/vcs/azure-devops.js.map +1 -1
  152. package/dist/services/vcs/types.d.ts +1 -1
  153. package/dist/skills/fleet-sprint-cli/SKILL.md +18 -0
  154. package/dist/skills/pm/SKILL.md +1 -1
  155. package/dist/skills/pm/cost.md +0 -3
  156. package/dist/skills/pm/fleet-addendum.md +2 -2
  157. package/dist/tools/check-status.d.ts +7 -4
  158. package/dist/tools/check-status.d.ts.map +1 -1
  159. package/dist/tools/check-status.js +2 -0
  160. package/dist/tools/check-status.js.map +1 -1
  161. package/dist/tools/compose-permissions.d.ts +6 -0
  162. package/dist/tools/compose-permissions.d.ts.map +1 -1
  163. package/dist/tools/compose-permissions.js +182 -34
  164. package/dist/tools/compose-permissions.js.map +1 -1
  165. package/dist/tools/credential-store-set.js +1 -1
  166. package/dist/tools/execute-command.d.ts.map +1 -1
  167. package/dist/tools/execute-command.js +31 -20
  168. package/dist/tools/execute-command.js.map +1 -1
  169. package/dist/tools/execute-prompt.d.ts +15 -2
  170. package/dist/tools/execute-prompt.d.ts.map +1 -1
  171. package/dist/tools/execute-prompt.js +1196 -892
  172. package/dist/tools/execute-prompt.js.map +1 -1
  173. package/dist/tools/kb-capture.d.ts +2 -2
  174. package/dist/tools/kb-capture.d.ts.map +1 -1
  175. package/dist/tools/kb-capture.js +29 -5
  176. package/dist/tools/kb-capture.js.map +1 -1
  177. package/dist/tools/kb-export.d.ts +2 -2
  178. package/dist/tools/kb-export.d.ts.map +1 -1
  179. package/dist/tools/kb-export.js +3 -28
  180. package/dist/tools/kb-export.js.map +1 -1
  181. package/dist/tools/kb-feedback.d.ts.map +1 -1
  182. package/dist/tools/kb-feedback.js +3 -1
  183. package/dist/tools/kb-feedback.js.map +1 -1
  184. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
  185. package/dist/tools/kb-freshness-sweep.js +3 -1
  186. package/dist/tools/kb-freshness-sweep.js.map +1 -1
  187. package/dist/tools/kb-import.d.ts.map +1 -1
  188. package/dist/tools/kb-import.js +2 -1
  189. package/dist/tools/kb-import.js.map +1 -1
  190. package/dist/tools/kb-list.d.ts.map +1 -1
  191. package/dist/tools/kb-list.js +3 -1
  192. package/dist/tools/kb-list.js.map +1 -1
  193. package/dist/tools/kb-query.d.ts +2 -2
  194. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
  195. package/dist/tools/kb-reconcile-prefilter.js +3 -1
  196. package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
  197. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
  198. package/dist/tools/kb-resolve-contradiction.js +3 -1
  199. package/dist/tools/kb-resolve-contradiction.js.map +1 -1
  200. package/dist/tools/kb-setup.d.ts.map +1 -1
  201. package/dist/tools/kb-setup.js +125 -20
  202. package/dist/tools/kb-setup.js.map +1 -1
  203. package/dist/tools/kb-stats.d.ts.map +1 -1
  204. package/dist/tools/kb-stats.js +64 -43
  205. package/dist/tools/kb-stats.js.map +1 -1
  206. package/dist/tools/list-members.d.ts +2 -2
  207. package/dist/tools/list-members.d.ts.map +1 -1
  208. package/dist/tools/list-members.js +1 -0
  209. package/dist/tools/list-members.js.map +1 -1
  210. package/dist/tools/member-detail.d.ts +2 -2
  211. package/dist/tools/member-detail.d.ts.map +1 -1
  212. package/dist/tools/member-detail.js +17 -0
  213. package/dist/tools/member-detail.js.map +1 -1
  214. package/dist/tools/member-reservation.d.ts +58 -1
  215. package/dist/tools/member-reservation.d.ts.map +1 -1
  216. package/dist/tools/member-reservation.js +61 -20
  217. package/dist/tools/member-reservation.js.map +1 -1
  218. package/dist/tools/provision-auth.d.ts +80 -1
  219. package/dist/tools/provision-auth.d.ts.map +1 -1
  220. package/dist/tools/provision-auth.js +142 -54
  221. package/dist/tools/provision-auth.js.map +1 -1
  222. package/dist/tools/provision-vcs-auth.d.ts +91 -1
  223. package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
  224. package/dist/tools/provision-vcs-auth.js +209 -49
  225. package/dist/tools/provision-vcs-auth.js.map +1 -1
  226. package/dist/tools/register-member.d.ts +12 -9
  227. package/dist/tools/register-member.d.ts.map +1 -1
  228. package/dist/tools/register-member.js +99 -12
  229. package/dist/tools/register-member.js.map +1 -1
  230. package/dist/tools/remove-member.d.ts.map +1 -1
  231. package/dist/tools/remove-member.js +27 -2
  232. package/dist/tools/remove-member.js.map +1 -1
  233. package/dist/tools/send-email.d.ts +2 -2
  234. package/dist/tools/setup-git-app.d.ts.map +1 -1
  235. package/dist/tools/setup-git-app.js +11 -7
  236. package/dist/tools/setup-git-app.js.map +1 -1
  237. package/dist/tools/shutdown-server.d.ts +2 -0
  238. package/dist/tools/shutdown-server.d.ts.map +1 -1
  239. package/dist/tools/shutdown-server.js +23 -1
  240. package/dist/tools/shutdown-server.js.map +1 -1
  241. package/dist/tools/update-member.d.ts +12 -9
  242. package/dist/tools/update-member.d.ts.map +1 -1
  243. package/dist/tools/update-member.js +43 -11
  244. package/dist/tools/update-member.js.map +1 -1
  245. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  246. package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
  247. package/dist/tools/vcs-credential-exec.js +197 -0
  248. package/dist/tools/vcs-credential-exec.js.map +1 -0
  249. package/dist/types.d.ts +13 -0
  250. package/dist/types.d.ts.map +1 -1
  251. package/dist/utils/log-helpers.d.ts.map +1 -1
  252. package/dist/utils/log-helpers.js +2 -2
  253. package/dist/utils/log-helpers.js.map +1 -1
  254. package/dist/utils/prompt-errors.d.ts.map +1 -1
  255. package/dist/utils/prompt-errors.js +7 -1
  256. package/dist/utils/prompt-errors.js.map +1 -1
  257. package/dist/utils/shell-escape.d.ts +16 -0
  258. package/dist/utils/shell-escape.d.ts.map +1 -1
  259. package/dist/utils/shell-escape.js +22 -2
  260. package/dist/utils/shell-escape.js.map +1 -1
  261. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  262. package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
  263. package/dist/utils/vcs-provider-detect.js +109 -0
  264. package/dist/utils/vcs-provider-detect.js.map +1 -0
  265. package/dist/utils/workspace-trust.d.ts +20 -17
  266. package/dist/utils/workspace-trust.d.ts.map +1 -1
  267. package/dist/utils/workspace-trust.js +87 -1
  268. package/dist/utils/workspace-trust.js.map +1 -1
  269. package/dist/workflows/auto-sprint.js +176 -15
  270. package/package.json +6 -4
  271. package/packages/apra-fleet-client/src/client/api.mjs +319 -17
  272. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  273. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  274. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +25 -0
  275. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +11 -0
  276. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +37 -2
  277. package/packages/apra-fleet-se/apra-pm/agents/doer.md +36 -12
  278. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +11 -0
  279. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +11 -0
  280. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +9 -0
  281. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +110 -22
  282. package/packages/apra-fleet-se/apra-pm/agents/planner.md +125 -37
  283. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +11 -0
  284. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +13 -2
  285. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  286. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -1
  287. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  288. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  289. package/packages/apra-fleet-se/bin/cli.mjs +149 -1
  290. package/packages/apra-fleet-se/bin/serve.mjs +78 -4
  291. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
  292. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
  293. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
  294. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
  295. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
  296. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
  297. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  298. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
  299. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +61 -14
  300. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
  301. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
  302. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
  303. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  304. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +1 -1
  305. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +276 -0
  306. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  307. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  308. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  309. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +996 -32
  310. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +267 -0
  311. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  312. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  313. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  314. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +556 -0
  315. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
  316. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
  317. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  318. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
  319. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  320. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
  321. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -0
  322. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  323. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  324. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  325. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
  326. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
  327. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
  328. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
  329. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
  330. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  331. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
  332. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
  333. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
  334. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
  335. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
  336. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
  337. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
  338. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
  339. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  340. package/packages/apra-fleet-se/fleet-sprint/runner.js +1467 -9798
  341. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +17 -12
  342. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
  343. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +18 -0
  344. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
  345. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
  346. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
  347. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -0
  348. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  349. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +211 -0
  350. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
  351. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +153 -19
  352. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +71 -21
  353. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  354. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +131 -0
  355. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +140 -16
  356. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +1 -0
  357. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +77 -2
  358. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  359. package/packages/apra-fleet-se/package.json +1 -1
  360. package/packages/apra-fleet-workflow/src/viewer/index.mjs +17 -6
  361. package/packages/apra-fleet-workflow/src/workflow/index.mjs +49 -7
  362. package/skills/fleet/SKILL.md +8 -8
  363. package/skills/fleet/auth-azdevops.md +14 -3
  364. package/skills/fleet/auth-bitbucket.md +2 -2
  365. package/skills/fleet/auth-github.md +5 -4
  366. package/skills/fleet/onboarding.md +3 -3
  367. package/skills/fleet/permissions.md +5 -1
  368. package/skills/fleet/profiles/node.json +1 -1
  369. package/skills/fleet/troubleshooting.md +3 -3
  370. package/version.json +1 -1
@@ -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. */
@@ -448,7 +515,17 @@ function mergeHooksConfig(paths, hooksConfig, provider) {
448
515
  }
449
516
  }
450
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*\(.*\)$/;
451
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
+ }
452
529
  if (providerName !== 'Claude')
453
530
  return allow;
454
531
  return allow.filter(rule => !CLAUDE_INVALID_RULES.includes(rule));
@@ -472,7 +549,18 @@ export function buildRequiredPerms(paths) {
472
549
  }
473
550
  function mergePermissions(paths, extraPerms = []) {
474
551
  const settings = readConfig(paths);
475
- 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
+ }
476
564
  settings.permissions = settings.permissions || {};
477
565
  settings.permissions.allow = settings.permissions.allow || [];
478
566
  settings.permissions.allow = pruneInvalidRules(settings.permissions.allow, paths.name);
@@ -579,29 +667,47 @@ function isCommandAvailable(cmd) {
579
667
  return false;
580
668
  }
581
669
  }
582
- 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() {
583
684
  try {
685
+ const currentPid = process.pid.toString();
584
686
  if (process.platform === 'win32') {
585
687
  const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe' });
586
- const currentPid = process.pid.toString();
587
688
  // Each CSV line: "apra-fleet.exe","<PID>","..." - exclude the current installer process
588
- return out.split('\n').some(line => {
589
- const match = line.match(/"apra-fleet\.exe","(\d+)"/);
590
- return match !== null && match[1] !== currentPid;
591
- });
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);
592
694
  }
593
695
  else {
594
696
  // -x = exact name match; installer is apra-fleet-installer-* so won't match;
595
697
  // exclude current PID to handle self-update (installed apra-fleet binary running install)
596
698
  const out = execSync('pgrep -x apra-fleet', { encoding: 'utf-8', stdio: 'pipe' });
597
- const currentPid = process.pid.toString();
598
- 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);
599
702
  }
600
703
  }
601
704
  catch {
602
- return false;
705
+ return [];
603
706
  }
604
707
  }
708
+ export function isApraFleetRunning() {
709
+ return apraFleetPids().length > 0;
710
+ }
605
711
  export function killApraFleet(signal = 'SIGTERM') {
606
712
  if (process.platform === 'win32') {
607
713
  // taskkill /F is already forceful -- no softer signal to escalate from,
@@ -655,6 +761,71 @@ export async function waitForApraFleetToStop() {
655
761
  await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
656
762
  }
657
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
+ }
658
829
  /**
659
830
  * Write empty .ignore overlay files into a LOCAL agy member's workspace to block
660
831
  * the global apra-fleet MCP server and PM/fleet skills from loading inside that
@@ -728,6 +899,7 @@ Options:
728
899
  --workflows <mode> Which workflow assets to install: all (default) or none. Installs
729
900
  ~/.apra-fleet/node_modules (workflow runtime), /schemas (agent role
730
901
  schemas), and /workflows/{fleet-sprint,hello-world} (built-in workflows).
902
+ fleet-se requires Node.js 22.16+ and npm.
731
903
  --force Stop a running apra-fleet server before installing (SEA mode only).`);
732
904
  process.exit(0);
733
905
  return;
@@ -744,7 +916,7 @@ Options:
744
916
  llm = args[idx + 1];
745
917
  }
746
918
  }
747
- const supported = ['claude', 'codex', 'copilot', 'agy', 'opencode'];
919
+ const supported = INSTALLABLE_LLM_PROVIDERS;
748
920
  if (!supported.includes(llm)) {
749
921
  console.error(`Error: Unsupported LLM provider "${llm}". Supported: ${supported.join(', ')}`);
750
922
  process.exit(1);
@@ -848,6 +1020,14 @@ Options:
848
1020
  const installPm = skillMode === 'pm' || skillMode === 'all';
849
1021
  const installAgents = installPm && paths.agentsDir !== undefined;
850
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
+ }
851
1031
  const serviceStep = isSea() && transport === 'http';
852
1032
  let totalSteps = (installFleet && installPm) ? 8 : installFleet ? 7 : installPm ? 8 : 6;
853
1033
  if (installAgents)
@@ -875,6 +1055,10 @@ Options:
875
1055
  if (runningScope && !runningScope.relevant) {
876
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`);
877
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;
878
1062
  if (runningScope?.relevant) {
879
1063
  if (!force) {
880
1064
  const killHint = process.platform === 'win32'
@@ -892,9 +1076,49 @@ ${killHint}
892
1076
  `);
893
1077
  process.exit(1);
894
1078
  }
895
- killApraFleet();
896
- await waitForApraFleetToStop();
897
- 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
+ }
898
1122
  console.error(`
899
1123
  Error: could not stop the running apra-fleet server (it is still running after
900
1124
  SIGTERM and a SIGKILL escalation). Stop it manually before installing:
@@ -924,6 +1148,25 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
924
1148
  else {
925
1149
  console.log(` [1/${totalSteps}] Dev mode -- skipping binary copy`);
926
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
+ }
927
1170
  // --- Step 2: Extract hooks ---
928
1171
  console.log(` [2/${totalSteps}] Installing hooks...`);
929
1172
  const manifest = loadManifest();
@@ -1248,11 +1491,15 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1248
1491
  // as a fallback), preserving this branch's no-dist/agents rule, and it
1249
1492
  // recurses into _shared/ and schemas/ which the old flat readdir missed.
1250
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).
1251
1498
  const content = llm === 'opencode'
1252
1499
  ? transformAgentForOpenCode(rawContent, relPath)
1253
1500
  : llm === 'agy'
1254
1501
  ? transformAgentForAgy(rawContent, relPath)
1255
- : rawContent;
1502
+ : transformAgentForClaude(rawContent, relPath);
1256
1503
  writeAssetFile(path.join(agentsDestDir, relPath), content);
1257
1504
  }
1258
1505
  }
@@ -1323,7 +1570,9 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1323
1570
  }
1324
1571
  catch {
1325
1572
  // not installed - install it
1326
- 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 });
1327
1576
  }
1328
1577
  }
1329
1578
  catch (err) {
@@ -1397,25 +1646,43 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1397
1646
  writeInstallConfig(llm, skillMode, workflowsMode);
1398
1647
  // --- Step N: Register and start service (SEA + HTTP mode only) ---
1399
1648
  let serviceRegistered = false;
1649
+ let serviceReused = false;
1400
1650
  if (serviceStep) {
1401
1651
  console.log(` [${totalSteps}/${totalSteps}] Registering and starting service...`);
1402
1652
  const svcMgr = await getServiceManager();
1403
1653
  try {
1404
- 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.');
1405
1657
  try {
1406
1658
  await svcMgr.start();
1407
1659
  serviceRegistered = true;
1408
1660
  }
1409
1661
  catch (startErr) {
1410
- try {
1411
- 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 { }
1412
1668
  }
1413
- catch { }
1414
1669
  throw startErr;
1415
1670
  }
1416
1671
  }
1417
1672
  catch (err) {
1418
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
+ }
1419
1686
  }
1420
1687
  }
1421
1688
  // --- Done ---
@@ -1430,7 +1697,7 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1430
1697
  const clientName = llm === 'claude' ? 'Claude Code' : paths.name;
1431
1698
  const instructions = llm === 'claude' ? 'Run /mcp in Claude Code to load the server.' : `Restart ${paths.name} to load the server.`;
1432
1699
  const forceNote = force ? `\nRestart ${clientName} to reload the MCP server.` : '';
1433
- 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'}` : '';
1434
1701
  console.log(`
1435
1702
  Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
1436
1703
  Binary: ${BIN_DIR}