@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -1,16 +1,25 @@
1
1
  import fs from 'node:fs';
2
+ import { getOrCreateMemberAccessSecret, MEMBER_SECRET_HEADER, readMemberAccessSecret } from '../services/member-access-secret.js';
3
+ import { claudeUserConfigPath, refreshClaudeLocalScopeEntries } from '../services/claude-local-scope-mcp.js';
2
4
  import path from 'node:path';
3
5
  import os from 'node:os';
4
6
  import { execSync, execFileSync } from 'node:child_process';
5
7
  import { serverVersion } from '../version.js';
6
- import { DEFAULT_PORT, LOG_FILE_PATH } from '../paths.js';
8
+ import { BUILTIN_DEFAULT_PORT, DEFAULT_PORT, DEFAULT_HOST, LOG_FILE_PATH, recordedMemberInstallPort, resolveServerPort, validPort } from '../paths.js';
7
9
  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';
10
+ import { LINUX_UNIT_NAME, MACOS_PLIST_LABEL } from '../services/service-manager/types.js';
11
+ import { BIN_DIR, HOOKS_DIR, SCRIPTS_DIR, getProviderInstallConfig, readConfig, readInstallConfig, writeOwnerOnlyFile, writeOwnerOnlyFileAtomic, writeConfig, writeInstallConfig, PROVIDER_STANDARD_MODELS, INSTALLABLE_LLM_PROVIDERS } from './config.js';
12
+ import { transformAgentForOpenCode, transformAgentForAgy, transformAgentForClaude } from './agent-transform.js';
10
13
  import { FLEET_DIR } from '../paths.js';
11
14
  import { extractWorkflowSubsystemAssets } from './workflow-assets.js';
12
15
  import { downloadAndExtractDolt, verifyDolt } from './dolt-install.js';
13
- import { classifyRunningServer, getInstallDataDir } from './install-guard.js';
16
+ import { installBeads } from './beads-install.js';
17
+ import { classifyRunningServer, relevantServerPids, getInstallDataDir, memberForceMayStop, fullInstallRefusalText, selfInvocationLines, writeMemberInstallMarker, clearMemberInstallMarker, FORCE_STOP_FULL_INSTALL_FLAG, } from './install-guard.js';
18
+ import { detectRunningFleetSe, fleetSeRefusalText, realFleetSeProbes, IGNORE_RUNNING_SPRINTS_FLAG } from './fleet-se-guard.js';
19
+ import { writeServiceNotice, clearServiceNoticeContaining } from '../services/service-notice.js';
20
+ import { convertClaudeAllowToAgyPermissions, formatAgyPermissionRules } from '../providers/agy.js';
21
+ import { codeIntelPathWarning } from '../utils/find-on-path.js';
22
+ import { gitBashCandidates } from '../os/git-bash-candidates.js';
14
23
  const realDoltStepDeps = { downloadAndExtractDolt, verifyDolt };
15
24
  let doltStepDeps = realDoltStepDeps;
16
25
  /** Test-only: inject fakes for the dolt CLI install step's download/verify calls. */
@@ -21,15 +30,130 @@ export function _setDoltStepDeps(overrides) {
21
30
  export function _resetDoltStepDeps() {
22
31
  doltStepDeps = realDoltStepDeps;
23
32
  }
33
+ /** Real transports for the Beads step (execFileSync is mocked by the install tests). */
34
+ function beadsStepDeps() {
35
+ return {
36
+ platform: process.platform,
37
+ exec: (cmd, args, opts) => execFileSync(cmd, args, { stdio: 'pipe', encoding: 'utf-8', shell: opts.shell, windowsHide: true }),
38
+ existsSync: p => fs.existsSync(p),
39
+ mkdirSync: p => { fs.mkdirSync(p, { recursive: true }); },
40
+ rmSync: p => { fs.rmSync(p, { recursive: true, force: true }); },
41
+ copyFileSync: (src, dest) => fs.copyFileSync(src, dest),
42
+ chmodSync: (p, mode) => fs.chmodSync(p, mode),
43
+ };
44
+ }
24
45
  function doltStepEnabled() {
25
46
  if (process.env.NODE_ENV !== 'test')
26
47
  return true;
27
48
  return process.env.APRA_FLEET_ENABLE_DOLT_INSTALL === '1';
28
49
  }
50
+ const FLEET_SE_MIN_NODE = [22, 16, 0];
51
+ function probeVersion(cmd, shell) {
52
+ try {
53
+ const out = execFileSync(cmd, ['--version'], { stdio: 'pipe', encoding: 'utf-8', timeout: 15_000, shell, windowsHide: true });
54
+ return String(out).trim() || null;
55
+ }
56
+ catch {
57
+ return null;
58
+ }
59
+ }
60
+ // System node from PATH, NOT process.version (in SEA mode that is the embedded runtime).
61
+ // node/npm can be .cmd shims on Windows (nvm-windows, corporate wrappers), so both need shell:true.
62
+ const realFleetSePrereqProbes = {
63
+ nodeVersion: () => probeVersion('node', true),
64
+ npmVersion: () => probeVersion('npm', true),
65
+ };
66
+ let fleetSePrereqProbes = realFleetSePrereqProbes;
67
+ /** Test-only: the real (non-overridden) probes, to assert their exec options. */
68
+ export const _realFleetSePrereqProbes = realFleetSePrereqProbes;
69
+ /** Test-only: inject fake probes for the fleet-se prerequisite check. */
70
+ export function _setFleetSePrereqProbes(overrides) {
71
+ fleetSePrereqProbes = { ...realFleetSePrereqProbes, ...overrides };
72
+ }
73
+ /** Test-only: restore the real fleet-se prerequisite probes. */
74
+ export function _resetFleetSePrereqProbes() {
75
+ fleetSePrereqProbes = realFleetSePrereqProbes;
76
+ }
77
+ // Running fleet-sprint supervisor/sprint guard (fleet-se-guard.ts): same
78
+ // injectable-probes + NODE_ENV=test gate as the prereq check above, so unit
79
+ // tests never probe the real port 8787 or tmp lock dir.
80
+ let fleetSeProbes = realFleetSeProbes;
81
+ /** Test-only: inject fake probes for the running fleet-sprint guard. */
82
+ export function _setFleetSeProbes(overrides) {
83
+ fleetSeProbes = { ...realFleetSeProbes, ...overrides };
84
+ }
85
+ /** Test-only: restore the real running fleet-sprint guard probes. */
86
+ export function _resetFleetSeProbes() {
87
+ fleetSeProbes = realFleetSeProbes;
88
+ }
89
+ /** The probes the running fleet-sprint guard uses (shared with update.ts). */
90
+ export function currentFleetSeProbes() { return fleetSeProbes; }
91
+ export function fleetSeGuardEnabled() {
92
+ if (process.env.NODE_ENV !== 'test')
93
+ return true;
94
+ return process.env.APRA_FLEET_ENABLE_FLEET_SE_GUARD === '1';
95
+ }
96
+ function fleetSePrereqCheckEnabled() {
97
+ if (process.env.NODE_ENV !== 'test')
98
+ return true;
99
+ return process.env.APRA_FLEET_ENABLE_FLEET_SE_PREREQ_CHECK === '1';
100
+ }
101
+ function nodeVersionSatisfies(raw) {
102
+ const m = raw.trim().replace(/^v/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
103
+ if (!m)
104
+ return false;
105
+ const v = [Number(m[1]), Number(m[2]), Number(m[3])];
106
+ for (let i = 0; i < 3; i++) {
107
+ if (v[i] !== FLEET_SE_MIN_NODE[i])
108
+ return v[i] > FLEET_SE_MIN_NODE[i];
109
+ }
110
+ return true;
111
+ }
112
+ export function checkFleetSePrereqs(probes) {
113
+ const missing = [];
114
+ const causes = [];
115
+ const minNode = FLEET_SE_MIN_NODE.join('.');
116
+ const node = probes.nodeVersion();
117
+ if (node === null) {
118
+ missing.push('node');
119
+ causes.push('Node.js not found on PATH');
120
+ }
121
+ else if (!nodeVersionSatisfies(node)) {
122
+ missing.push('node');
123
+ causes.push(`Node.js ${node.trim()} found, ${minNode}+ required`);
124
+ }
125
+ if (probes.npmVersion() === null) {
126
+ missing.push('npm');
127
+ causes.push('npm not found on PATH');
128
+ }
129
+ if (missing.length === 0)
130
+ return { ok: true, missing, message: '' };
131
+ 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.`;
132
+ return { ok: false, missing, message };
133
+ }
29
134
  // Detect SEA mode
30
135
  let _seaOverride = null;
31
136
  /** Override isSea() result -- for tests only. Pass null to restore default. */
32
137
  export function _setSeaOverride(v) { _seaOverride = v; }
138
+ let _serviceHealthWaitOverride = null;
139
+ export function _setServiceHealthWaitOverride(fn) { _serviceHealthWaitOverride = fn; }
140
+ async function waitForServiceHealth() {
141
+ if (_serviceHealthWaitOverride)
142
+ return _serviceHealthWaitOverride();
143
+ const raw = parseInt(process.env.APRA_FLEET_INSTALL_HEALTH_TIMEOUT_MS ?? '', 10);
144
+ const timeoutMs = Number.isFinite(raw) && raw >= 0 ? raw : 30_000;
145
+ if (timeoutMs === 0)
146
+ return null;
147
+ const { checkRunningInstance } = await import('../services/singleton.js');
148
+ const deadline = Date.now() + timeoutMs;
149
+ for (;;) {
150
+ if ((await checkRunningInstance()).running)
151
+ return true;
152
+ if (Date.now() >= deadline)
153
+ return false;
154
+ await new Promise(resolve => setTimeout(resolve, 500));
155
+ }
156
+ }
33
157
  export function isSea() {
34
158
  if (_seaOverride !== null)
35
159
  return _seaOverride;
@@ -448,7 +572,17 @@ function mergeHooksConfig(paths, hooksConfig, provider) {
448
572
  }
449
573
  }
450
574
  const CLAUDE_INVALID_RULES = ['tracker_*'];
575
+ /** AGY validates every permissions.allow entry against this regex (verbatim
576
+ * from the agy CLI binary, 1.2.8) and ignores anything that fails it. */
577
+ const AGY_RULE_RE = /^(command|read_file|write_file|read_url|mcp|execute_url|unsandboxed)\s*\(.*\)$/;
451
578
  export function pruneInvalidRules(allow, providerName) {
579
+ if (providerName === 'Antigravity') {
580
+ // Self-heal: strip Claude-syntax entries a previous install wrote into
581
+ // AGY's settings.json (mcp__apra-fleet__*, Agent(*), tracker_*, ...). AGY
582
+ // rejects them already, so removing them changes no effective grant -- it
583
+ // only stops fleet from leaving junk in a file the human user also owns.
584
+ return allow.filter(rule => AGY_RULE_RE.test(rule));
585
+ }
452
586
  if (providerName !== 'Claude')
453
587
  return allow;
454
588
  return allow.filter(rule => !CLAUDE_INVALID_RULES.includes(rule));
@@ -472,7 +606,18 @@ export function buildRequiredPerms(paths) {
472
606
  }
473
607
  function mergePermissions(paths, extraPerms = []) {
474
608
  const settings = readConfig(paths);
475
- const requiredPerms = [...buildRequiredPerms(paths), ...extraPerms];
609
+ let requiredPerms = [...buildRequiredPerms(paths), ...extraPerms];
610
+ if (paths.name === 'Antigravity') {
611
+ // buildRequiredPerms speaks Claude's permission vocabulary. AGY accepts
612
+ // only `action(target)` strings from a fixed action set, so the Read(<dir>)
613
+ // grants are translated to read_file(<dir>) and the tokens with no AGY
614
+ // equivalent (mcp__apra-fleet__*, activate_skill(*), Agent(*), tracker_*)
615
+ // are dropped -- same "no Antigravity equivalent" handling the agent
616
+ // transform already applies to unsupported tools. Writing them verbatim
617
+ // left AGY with an allow-list it discarded wholesale, so every headless
618
+ // dispatch hit the auto-deny wall on its first tool call.
619
+ requiredPerms = formatAgyPermissionRules(convertClaudeAllowToAgyPermissions(requiredPerms));
620
+ }
476
621
  settings.permissions = settings.permissions || {};
477
622
  settings.permissions.allow = settings.permissions.allow || [];
478
623
  settings.permissions.allow = pruneInvalidRules(settings.permissions.allow, paths.name);
@@ -489,10 +634,16 @@ function configureStatusline(paths, scriptPath, llm) {
489
634
  let command;
490
635
  if (process.platform === 'win32') {
491
636
  if (llm === 'agy') {
492
- const gitBash = 'C:\\Program Files\\Git\\bin\\bash.exe';
493
- const bashBin = fs.existsSync(gitBash) ? `"${gitBash}"` : 'bash';
494
637
  const formattedScriptPath = scriptPath.replace(/\\/g, '/');
495
- command = `${bashBin} "${formattedScriptPath}"`;
638
+ const candidates = gitBashCandidates(process.env.LOCALAPPDATA);
639
+ const gitBash = candidates.find(c => fs.existsSync(c));
640
+ if (gitBash) {
641
+ const gitBin = path.dirname(gitBash);
642
+ command = `set PATH=${gitBin};%PATH% && bash '${formattedScriptPath}'`;
643
+ }
644
+ else {
645
+ command = `bash '${formattedScriptPath}'`;
646
+ }
496
647
  }
497
648
  else {
498
649
  command = `bash "${scriptPath}"`;
@@ -520,7 +671,11 @@ function mergeAgyConfig(paths, mcpConfig) {
520
671
  }
521
672
  settings.mcpServers = settings.mcpServers || {};
522
673
  settings.mcpServers['apra-fleet'] = mcpConfig;
523
- fs.writeFileSync(mcpConfigFile, JSON.stringify(settings, null, 2) + '\n');
674
+ const out = JSON.stringify(settings, null, 2) + '\n';
675
+ if (mcpConfig.headers)
676
+ writeOwnerOnlyFile(mcpConfigFile, out);
677
+ else
678
+ fs.writeFileSync(mcpConfigFile, out);
524
679
  }
525
680
  function writeDefaultModel(paths, standardModel) {
526
681
  const settings = readConfig(paths);
@@ -533,25 +688,25 @@ function mergeCopilotConfig(paths, mcpConfig) {
533
688
  const settings = readConfig(paths);
534
689
  settings.mcpServers = settings.mcpServers || {};
535
690
  settings.mcpServers['apra-fleet'] = mcpConfig;
536
- writeConfig(paths, settings);
691
+ writeConfig(paths, settings, { ownerOnly: !!mcpConfig.headers });
537
692
  }
538
693
  function mergeOpenCodeConfig(paths, mcpConfig) {
539
694
  const settings = readConfig(paths);
540
695
  settings.mcp = settings.mcp || {};
541
696
  settings.mcp['apra-fleet'] = mcpConfig.url
542
- ? { type: 'remote', url: mcpConfig.url, enabled: true }
697
+ ? { type: 'remote', url: mcpConfig.url, enabled: true, ...(mcpConfig.headers ? { headers: mcpConfig.headers } : {}) }
543
698
  : {
544
699
  type: 'local',
545
700
  command: [mcpConfig.command, ...(mcpConfig.args || [])],
546
701
  enabled: true,
547
702
  };
548
- writeConfig(paths, settings);
703
+ writeConfig(paths, settings, { ownerOnly: !!mcpConfig.headers });
549
704
  }
550
705
  function mergeCodexConfig(paths, mcpConfig) {
551
706
  const settings = readConfig(paths);
552
707
  settings.mcp_servers = settings.mcp_servers || {};
553
708
  if (mcpConfig.url) {
554
- settings.mcp_servers['apra-fleet'] = { url: mcpConfig.url };
709
+ settings.mcp_servers['apra-fleet'] = { url: mcpConfig.url, ...(mcpConfig.headers ? { http_headers: mcpConfig.headers } : {}) };
555
710
  }
556
711
  else {
557
712
  settings.mcp_servers['apra-fleet'] = {
@@ -559,12 +714,101 @@ function mergeCodexConfig(paths, mcpConfig) {
559
714
  args: mcpConfig.args.map((a) => a.replace(/\\/g, '/')),
560
715
  };
561
716
  }
562
- writeConfig(paths, settings);
717
+ writeConfig(paths, settings, { ownerOnly: !!mcpConfig.headers });
718
+ }
719
+ export { claudeUserConfigPath } from '../services/claude-local-scope-mcp.js';
720
+ /**
721
+ * Register the http apra-fleet server in claude's user scope WITHOUT putting
722
+ * the access secret in argv (`claude mcp add --header` is visible to other
723
+ * local users via ps): the entry is merged into the claude config file
724
+ * directly, which is kept owner-only. An unparseable existing file is never
725
+ * overwritten.
726
+ */
727
+ export function registerClaudeHttpMcp(url, headers) {
728
+ const file = claudeUserConfigPath();
729
+ let settings = {};
730
+ if (fs.existsSync(file)) {
731
+ const raw = fs.readFileSync(file, 'utf-8').trim();
732
+ if (raw) {
733
+ try {
734
+ settings = JSON.parse(raw);
735
+ }
736
+ catch {
737
+ throw new Error(`${file} is not valid JSON; fix or remove it, then re-run 'apra-fleet install'`);
738
+ }
739
+ }
740
+ }
741
+ settings.mcpServers = settings.mcpServers || {};
742
+ settings.mcpServers['apra-fleet'] = { type: 'http', url, headers };
743
+ writeOwnerOnlyFileAtomic(file, JSON.stringify(settings, null, 2) + '\n');
744
+ }
745
+ /** Write the http (url + access-secret header) apra-fleet registration for one provider. */
746
+ export function registerHttpMcp(provider, paths, url, headers) {
747
+ if (provider === 'claude')
748
+ registerClaudeHttpMcp(url, headers);
749
+ else if (provider === 'codex')
750
+ mergeCodexConfig(paths, { url, headers });
751
+ else if (provider === 'copilot')
752
+ mergeCopilotConfig(paths, { url, type: 'http', headers });
753
+ else if (provider === 'agy')
754
+ mergeAgyConfig(paths, { url, headers });
755
+ else if (provider === 'opencode')
756
+ mergeOpenCodeConfig(paths, { url, headers });
757
+ }
758
+ /** The apra-fleet MCP entry `provider` has registered (parsed), or undefined. Never throws. */
759
+ function registeredMcpEntry(provider, paths) {
760
+ try {
761
+ if (provider === 'claude')
762
+ return readJsonOrEmpty(claudeUserConfigPath()).mcpServers?.['apra-fleet'];
763
+ if (provider === 'agy')
764
+ return readJsonOrEmpty(path.join(os.homedir(), '.gemini', 'config', 'mcp_config.json')).mcpServers?.['apra-fleet'];
765
+ const settings = readConfig(paths);
766
+ if (provider === 'codex')
767
+ return settings.mcp_servers?.['apra-fleet'];
768
+ if (provider === 'copilot')
769
+ return settings.mcpServers?.['apra-fleet'];
770
+ if (provider === 'opencode')
771
+ return settings.mcp?.['apra-fleet'];
772
+ }
773
+ catch { /* unreadable -> unknown */ }
774
+ return undefined;
775
+ }
776
+ /**
777
+ * Key-order-independent serialization of `provider`'s apra-fleet entry, to
778
+ * tell whether a registration write changed it (formatting and the rest of
779
+ * the file do not count).
780
+ */
781
+ function mcpRegistrationSnapshot(provider, paths) {
782
+ const canon = (v) => Array.isArray(v) ? v.map(canon)
783
+ : v && typeof v === 'object' ? Object.fromEntries(Object.keys(v).sort().map(k => [k, canon(v[k])])) : v;
784
+ return JSON.stringify(canon(registeredMcpEntry(provider, paths)) ?? null);
785
+ }
786
+ function readJsonOrEmpty(file) {
787
+ try {
788
+ return fs.existsSync(file) ? JSON.parse(fs.readFileSync(file, 'utf-8')) : {};
789
+ }
790
+ catch {
791
+ return {};
792
+ }
793
+ }
794
+ /**
795
+ * The transport of the apra-fleet MCP entry `provider` currently has
796
+ * registered, read from the provider's own config (install-config.json
797
+ * records no transport): 'stdio' (a command entry), 'http' (a url entry), or
798
+ * undefined (no entry / unreadable config). Never throws.
799
+ */
800
+ export function registeredMcpTransport(provider, paths) {
801
+ const classify = (e) => !e || typeof e !== 'object' ? undefined : e.url ? 'http' : e.command ? 'stdio' : undefined;
802
+ const e = registeredMcpEntry(provider, paths);
803
+ if (provider === 'opencode') {
804
+ return e?.type === 'remote' || e?.url ? 'http' : e?.type === 'local' || e?.command ? 'stdio' : undefined;
805
+ }
806
+ return classify(e);
563
807
  }
564
808
  function run(cmd, opts) {
565
809
  // Windows needs a shell for .cmd executables (e.g. claude.cmd)
566
810
  const shellOpt = process.platform === 'win32' ? { shell: 'cmd.exe' } : {};
567
- execSync(cmd, { stdio: 'inherit', ...shellOpt, ...opts });
811
+ execSync(cmd, { stdio: 'inherit', windowsHide: true, ...shellOpt, ...opts });
568
812
  }
569
813
  /** Is `cmd` resolvable on PATH? Used before shelling out to a provider's own
570
814
  * CLI (e.g. `claude`) so a missing binary degrades to a clear warning
@@ -572,48 +816,91 @@ function run(cmd, opts) {
572
816
  function isCommandAvailable(cmd) {
573
817
  try {
574
818
  const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
575
- execSync(checkCmd, { stdio: 'ignore' });
819
+ execSync(checkCmd, { stdio: 'ignore', windowsHide: true });
576
820
  return true;
577
821
  }
578
822
  catch {
579
823
  return false;
580
824
  }
581
825
  }
582
- export function isApraFleetRunning() {
826
+ /**
827
+ * PIDs of every apra-fleet process currently running other than this one, as
828
+ * strings.
829
+ *
830
+ * OS-global on purpose -- isApraFleetRunning() is defined in terms of this and
831
+ * is the install guard's cheap first filter and uninstall.ts's running check.
832
+ * It is NOT what install --force stops or watches: that is scoped to
833
+ * relevantServerPids() (install-guard.ts). The current process is always
834
+ * excluded: the installer may itself be named apra-fleet (the fleet's member
835
+ * upgrade runs <home>/.apra-fleet/staging/apra-fleet, and a self-update runs
836
+ * the installed binary).
837
+ */
838
+ export function apraFleetPids() {
583
839
  try {
840
+ const currentPid = process.pid.toString();
584
841
  if (process.platform === 'win32') {
585
- const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe' });
586
- const currentPid = process.pid.toString();
842
+ const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe', windowsHide: true });
587
843
  // 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
- });
844
+ return out.split('\n')
845
+ .map(line => line.match(/"apra-fleet\.exe","(\d+)"/))
846
+ .filter((match) => match !== null)
847
+ .map(match => match[1])
848
+ .filter(pid => pid !== currentPid);
592
849
  }
593
850
  else {
594
- // -x = exact name match; installer is apra-fleet-installer-* so won't match;
595
- // exclude current PID to handle self-update (installed apra-fleet binary running install)
596
- 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);
851
+ // -x = exact name match; the installer itself may be named apra-fleet,
852
+ // so the current PID is excluded.
853
+ const out = execSync('pgrep -x apra-fleet', { encoding: 'utf-8', stdio: 'pipe', windowsHide: true });
854
+ return out.split('\n')
855
+ .map(line => line.trim())
856
+ .filter(pid => pid !== '' && pid !== currentPid);
599
857
  }
600
858
  }
601
859
  catch {
602
- return false;
860
+ return [];
603
861
  }
604
862
  }
605
- export function killApraFleet(signal = 'SIGTERM') {
606
- if (process.platform === 'win32') {
607
- // taskkill /F is already forceful -- no softer signal to escalate from,
608
- // so SIGKILL escalation on Windows just reissues the same command.
609
- execSync('taskkill /F /IM apra-fleet.exe', { stdio: 'ignore' });
610
- }
611
- else {
612
- // -x = exact name match
613
- const cmd = signal === 'SIGKILL' ? 'pkill -9 -x apra-fleet' : 'pkill -x apra-fleet';
614
- execSync(cmd, { stdio: 'ignore' });
863
+ export function isApraFleetRunning() {
864
+ return apraFleetPids().length > 0;
865
+ }
866
+ /**
867
+ * Signal the given apra-fleet pids -- by PID, never by process name. A
868
+ * name-based kill (pkill -x apra-fleet / taskkill /IM apra-fleet.exe) also
869
+ * matches the installer when it is named apra-fleet, which killed the fleet's
870
+ * member upgrade mid-install (exit 143), and every unrelated apra-fleet server
871
+ * of the same user (apra-fleet-b4g.72). This process is never signalled, even
872
+ * when passed in. A pid that already exited is ignored.
873
+ */
874
+ export function killApraFleet(pids, signal = 'SIGTERM') {
875
+ for (const raw of pids) {
876
+ const pid = Number(raw);
877
+ if (!Number.isInteger(pid) || pid <= 0 || pid === process.pid)
878
+ continue;
879
+ try {
880
+ if (process.platform === 'win32') {
881
+ // taskkill /F is already forceful -- no softer signal to escalate from,
882
+ // so SIGKILL escalation on Windows just reissues the same command.
883
+ execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore', windowsHide: true });
884
+ }
885
+ else {
886
+ process.kill(pid, signal);
887
+ }
888
+ }
889
+ catch {
890
+ // Already gone (ESRCH / taskkill "not found"): nothing to stop.
891
+ }
615
892
  }
616
893
  }
894
+ /** Manual stop advice: the pids still running, plus the by-name fallback. */
895
+ function manualStopHint(pids) {
896
+ const byName = process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pkill -x apra-fleet';
897
+ if (pids.length === 0)
898
+ return byName;
899
+ const byPid = process.platform === 'win32'
900
+ ? pids.map(pid => ` taskkill /F /PID ${pid}`).join('\n')
901
+ : ` kill ${pids.join(' ')}`;
902
+ return `${byPid}\n or, when no other apra-fleet server of yours must keep running:\n${byName}`;
903
+ }
617
904
  const PROD_INSTALL_FORCE_TIMING = { pollIntervalMs: 200, graceMs: 3000, killGraceMs: 2000 };
618
905
  // Tests run with NODE_ENV=test (see tests/setup.ts) and don't fake these timers,
619
906
  // so default to a much shorter window there to keep the suite fast, unless a
@@ -631,30 +918,101 @@ function installForceTiming() {
631
918
  return process.env.NODE_ENV === 'test' ? TEST_INSTALL_FORCE_TIMING : PROD_INSTALL_FORCE_TIMING;
632
919
  }
633
920
  /**
634
- * Wait for any non-installer apra-fleet process to exit after killApraFleet()
635
- * sends SIGTERM. Polls isApraFleetRunning() over a grace window; if the
636
- * process is still alive once the window elapses, escalates to SIGKILL and
637
- * polls again over a second (shorter) window. Returns as soon as no
638
- * non-installer apra-fleet process is detected, or once both windows have
639
- * elapsed -- callers should not assume termination is guaranteed in the
640
- * latter case (see apra-fleet-l7n.3 for surfacing that failure to the
641
- * operator instead of asserting success).
921
+ * Wait for the relevant apra-fleet pids (`listPids`, re-evaluated on every
922
+ * poll; never this process) to exit after killApraFleet() sends SIGTERM. If
923
+ * any is still alive once the grace window elapses, escalates to SIGKILL
924
+ * against exactly those and polls again over a second (shorter) window.
925
+ * Returns as soon as none is detected, or once both windows have elapsed --
926
+ * callers should not assume termination is guaranteed in the latter case (see
927
+ * apra-fleet-l7n.3 for surfacing that failure to the operator instead of
928
+ * asserting success).
642
929
  */
643
- export async function waitForApraFleetToStop() {
930
+ export async function waitForApraFleetToStop(listPids) {
644
931
  const { pollIntervalMs, graceMs, killGraceMs } = installForceTiming();
645
932
  let deadline = Date.now() + graceMs;
646
- while (isApraFleetRunning() && Date.now() < deadline) {
933
+ let pids = listPids();
934
+ while (pids.length > 0 && Date.now() < deadline) {
647
935
  await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
936
+ pids = listPids();
648
937
  }
649
- if (!isApraFleetRunning())
938
+ if (pids.length === 0)
650
939
  return;
651
- // Grace window elapsed and a non-installer apra-fleet process is still alive -- escalate.
652
- killApraFleet('SIGKILL');
940
+ // Grace window elapsed and a relevant apra-fleet process is still alive -- escalate.
941
+ killApraFleet(pids, 'SIGKILL');
653
942
  deadline = Date.now() + killGraceMs;
654
- while (isApraFleetRunning() && Date.now() < deadline) {
943
+ while (listPids().length > 0 && Date.now() < deadline) {
655
944
  await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
656
945
  }
657
946
  }
947
+ // --- install --force service-aware stop ---
948
+ //
949
+ // killApraFleet() signals the server's pid directly. When the server is
950
+ // registered with the platform service manager that is a race the installer
951
+ // cannot win: the macOS LaunchAgent this installer writes declares
952
+ // KeepAlive/SuccessfulExit=false (src/services/service-manager/macos.ts), so
953
+ // launchd relaunches the server under a NEW pid the instant a SIGKILL takes it
954
+ // down, and the liveness poll below then reports "still running" forever. The
955
+ // systemd unit's Restart=on-failure has the same shape. The remedy is to stop
956
+ // the SERVICE first: ServiceManager.stop() performs a graceful shutdown that
957
+ // exits 0, which neither supervisor restarts.
958
+ /**
959
+ * The platform ServiceManager, but only when a service is actually registered.
960
+ * Any failure to determine that (no systemd, unsupported platform, adapter
961
+ * error) is indistinguishable from "nothing registered" for the guard's
962
+ * purposes, so it degrades to the historical kill path rather than throwing.
963
+ */
964
+ async function registeredServiceManager() {
965
+ try {
966
+ const mgr = await getServiceManager();
967
+ return (await mgr.isInstalled()) ? mgr : null;
968
+ }
969
+ catch {
970
+ return null;
971
+ }
972
+ }
973
+ /** Exact command an operator can run to bring the registered service back up. */
974
+ export function serviceRestartCommand() {
975
+ switch (process.platform) {
976
+ // A stop disables the task (its repeating trigger would undo the stop);
977
+ // apra-fleet start re-enables it before running it.
978
+ case 'win32': return 'apra-fleet start';
979
+ case 'linux': return `systemctl --user start ${LINUX_UNIT_NAME}`;
980
+ case 'darwin': return `launchctl kickstart -k gui/${macosGuiUid()}/${MACOS_PLIST_LABEL}`;
981
+ default: return 'apra-fleet install';
982
+ }
983
+ }
984
+ /** Exact command an operator can run to take the registered service down. */
985
+ export function serviceStopCommand() {
986
+ switch (process.platform) {
987
+ // apra-fleet stop disables the task (its repeating trigger would undo a
988
+ // bare /end) and records the stop so nothing restarts the server.
989
+ case 'win32': return 'apra-fleet stop';
990
+ case 'linux': return `systemctl --user stop ${LINUX_UNIT_NAME}`;
991
+ case 'darwin': return `launchctl bootout gui/${macosGuiUid()}/${MACOS_PLIST_LABEL}`;
992
+ default: return 'apra-fleet uninstall';
993
+ }
994
+ }
995
+ // Resolved in JS, never left to shell expansion: the printed command must be
996
+ // copy-pasteable as-is (mirrors getUid() in service-manager/macos.ts).
997
+ function macosGuiUid() {
998
+ return typeof process.getuid === 'function' ? String(process.getuid()) : '501';
999
+ }
1000
+ /**
1001
+ * Poll for the server to disappear after ServiceManager.stop(), WITHOUT
1002
+ * signalling it -- signalling is exactly what loses the race against a
1003
+ * supervisor relaunch. Returns the pids still observed once the window closes
1004
+ * (empty when the service is down).
1005
+ */
1006
+ async function waitForServiceStop(listPids) {
1007
+ const { pollIntervalMs, graceMs } = installForceTiming();
1008
+ const deadline = Date.now() + graceMs;
1009
+ let pids = listPids();
1010
+ while (pids.length > 0 && Date.now() < deadline) {
1011
+ await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
1012
+ pids = listPids();
1013
+ }
1014
+ return pids;
1015
+ }
658
1016
  /**
659
1017
  * Write empty .ignore overlay files into a LOCAL agy member's workspace to block
660
1018
  * the global apra-fleet MCP server and PM/fleet skills from loading inside that
@@ -697,6 +1055,42 @@ function copyGlobalBible(repoCwd) {
697
1055
  console.warn(' [WARN] Global knowledge bible copy skipped:', err instanceof Error ? err.message : String(err));
698
1056
  }
699
1057
  }
1058
+ /** The one next step a member install prints: the orchestrator registers the
1059
+ * member, which also writes its per-folder apra-fleet MCP entry. */
1060
+ export const MEMBER_INSTALL_NEXT_STEP = 'Next step (on the orchestrator): run update_member {member_id, fleet_install: "auto"} (or register_member) for this member; ' +
1061
+ 'it registers the member on this install and writes its per-folder apra-fleet MCP entry.';
1062
+ /**
1063
+ * The port a member install records: --port <n> / --port=<n>, else
1064
+ * APRA_FLEET_PORT, else the port an earlier member install in this data dir
1065
+ * recorded (an upgrade keeps it), else the built-in default. `explicit` is
1066
+ * true when --port was passed. --port that disagrees with APRA_FLEET_PORT is
1067
+ * an error: the two would put the server and its record on different ports.
1068
+ */
1069
+ export function resolveMemberInstallPort(args, envPort, recordedPort) {
1070
+ let raw;
1071
+ const eq = args.find(a => a.startsWith('--port='));
1072
+ if (eq)
1073
+ raw = eq.slice('--port='.length);
1074
+ else {
1075
+ const i = args.indexOf('--port');
1076
+ if (i >= 0) {
1077
+ raw = args[i + 1];
1078
+ if (raw === undefined || raw.startsWith('-'))
1079
+ return { error: '--port requires a port number (1-65535).' };
1080
+ }
1081
+ }
1082
+ const env = envPort !== undefined && envPort !== '' ? validPort(envPort) : undefined;
1083
+ if (raw !== undefined) {
1084
+ const port = validPort(raw);
1085
+ if (port === undefined)
1086
+ return { error: `--port must be a port number (1-65535), got "${raw}".` };
1087
+ if (env !== undefined && env !== port) {
1088
+ return { error: `--port ${port} disagrees with APRA_FLEET_PORT=${env}; pass one of them.` };
1089
+ }
1090
+ return { port, explicit: true };
1091
+ }
1092
+ return { port: env ?? recordedPort ?? BUILTIN_DEFAULT_PORT, explicit: false };
1093
+ }
700
1094
  export async function runInstall(args) {
701
1095
  // --help / -h guard - must come first, before any side effects (#142)
702
1096
  if (args.includes('--help') || args.includes('-h')) {
@@ -712,6 +1106,7 @@ Usage:
712
1106
  apra-fleet install --skill none Skip skill installation
713
1107
  apra-fleet install --no-skill Same as --skill none
714
1108
  apra-fleet install --workflows none Skip installing the workflow runtime + built-in workflows
1109
+ apra-fleet install --member Member install: server + user-mode auto-start only (see below)
715
1110
  apra-fleet install --force Stop a running server before installing
716
1111
  apra-fleet install --llm <provider> Target LLM provider: claude (default), codex, copilot, agy, opencode
717
1112
  apra-fleet install --transport http Register MCP server with HTTP transport (default)
@@ -725,10 +1120,29 @@ Options:
725
1120
  fleet server at http://localhost:7523/mcp. stdio runs fleet as a subprocess.
726
1121
  --skill <mode> Which skills to install: all (default), fleet, pm, or none.
727
1122
  --no-skill Alias for --skill none.
1123
+ --member Install only the server and its user-mode auto-start. Implies
1124
+ --skill none --workflows none; writes NO user-scope MCP entry,
1125
+ hooks/statusline/permissions settings or ~/.claude/CLAUDE.md block.
1126
+ Fails with E-MEMBER-AUTOSTART if the auto-start cannot be registered.
728
1127
  --workflows <mode> Which workflow assets to install: all (default) or none. Installs
729
1128
  ~/.apra-fleet/node_modules (workflow runtime), /schemas (agent role
730
1129
  schemas), and /workflows/{fleet-sprint,hello-world} (built-in workflows).
731
- --force Stop a running apra-fleet server before installing (SEA mode only).`);
1130
+ fleet-se requires Node.js 22.16+ and npm.
1131
+ --force Stop a running apra-fleet server before installing (SEA mode only).
1132
+ With --member, only a server a previous member install left behind
1133
+ is stopped; anything else is refused (E-FULL-INSTALL-RUNNING).
1134
+ --ignore-running-sprints
1135
+ Install even while a fleet-sprint supervisor or sprint is running for this
1136
+ user; the server is replaced underneath them (ones started under 0.4.3 or
1137
+ earlier then fail with HTTP 401 until restarted). Without it install
1138
+ refuses (E-FLEET-SE-RUNNING); --force does not override this.
1139
+ --force-stop-full-install
1140
+ With --member --force: also stop a running server that was not started
1141
+ by a member install (e.g. a full install on a shared machine).
1142
+ --port <n> With --member: the port this member install's server listens on
1143
+ (default: APRA_FLEET_PORT, else the port a previous member install
1144
+ recorded, else 7523). Recorded in the member-install marker; use a
1145
+ different port for each Unix user's member install on one host.`);
732
1146
  process.exit(0);
733
1147
  return;
734
1148
  }
@@ -744,7 +1158,7 @@ Options:
744
1158
  llm = args[idx + 1];
745
1159
  }
746
1160
  }
747
- const supported = ['claude', 'codex', 'copilot', 'agy', 'opencode'];
1161
+ const supported = INSTALLABLE_LLM_PROVIDERS;
748
1162
  if (!supported.includes(llm)) {
749
1163
  console.error(`Error: Unsupported LLM provider "${llm}". Supported: ${supported.join(', ')}`);
750
1164
  process.exit(1);
@@ -806,6 +1220,7 @@ Options:
806
1220
  }
807
1221
  // Parse --force flag
808
1222
  const force = args.includes('--force');
1223
+ const forceStopFullInstall = args.includes(FORCE_STOP_FULL_INSTALL_FLAG);
809
1224
  let transport = 'http';
810
1225
  const transportEqualArg = args.find(a => a.startsWith('--transport='));
811
1226
  if (transportEqualArg) {
@@ -832,8 +1247,14 @@ Options:
832
1247
  }
833
1248
  }
834
1249
  // Reject unknown flags to catch typos early
835
- const knownFlagPrefixes = ['--llm=', '--skill=', '--transport=', '--workflows='];
836
- const knownFlagExact = new Set(['--llm', '--skill', '--no-skill', '--workflows', '--force', '--transport', '--help', '-h']);
1250
+ const memberMode = args.includes('--member');
1251
+ if (memberMode) {
1252
+ // A member install carries the server only: no skills, no workflows.
1253
+ skillMode = 'none';
1254
+ workflowsMode = 'none';
1255
+ }
1256
+ const knownFlagPrefixes = ['--llm=', '--skill=', '--transport=', '--workflows=', '--port='];
1257
+ const knownFlagExact = new Set(['--member', '--llm', '--skill', '--no-skill', '--workflows', '--force', FORCE_STOP_FULL_INSTALL_FLAG, IGNORE_RUNNING_SPRINTS_FLAG, '--transport', '--port', '--help', '-h']);
837
1258
  for (const a of args) {
838
1259
  if (knownFlagExact.has(a))
839
1260
  continue;
@@ -844,11 +1265,83 @@ Options:
844
1265
  console.error(`Error: Unknown option "${a}". Run apra-fleet install --help for usage.`);
845
1266
  process.exit(1);
846
1267
  }
1268
+ // The port a member install's server listens on, recorded in the marker
1269
+ // (the server reads it back at launch; the orchestrator reads it for the
1270
+ // member's MCP URL). Only a member install takes --port.
1271
+ const memberPortChoice = resolveMemberInstallPort(args, process.env.APRA_FLEET_PORT, recordedMemberInstallPort());
1272
+ if ('error' in memberPortChoice) {
1273
+ console.error(`Error: ${memberPortChoice.error}`);
1274
+ process.exit(1);
1275
+ }
1276
+ if (memberPortChoice.explicit && !memberMode) {
1277
+ console.error('Error: --port is only valid with --member (a full install uses APRA_FLEET_PORT).');
1278
+ process.exit(1);
1279
+ }
1280
+ const memberPort = memberPortChoice.port;
847
1281
  const installFleet = skillMode === 'fleet' || skillMode === 'pm' || skillMode === 'all';
848
1282
  const installPm = skillMode === 'pm' || skillMode === 'all';
849
1283
  const installAgents = installPm && paths.agentsDir !== undefined;
850
1284
  const installWorkflows = workflowsMode === 'all';
1285
+ // fleet-se prerequisites: fail before the running-process guard so nothing is stopped or written.
1286
+ if (installWorkflows && fleetSePrereqCheckEnabled()) {
1287
+ const prereq = checkFleetSePrereqs(fleetSePrereqProbes);
1288
+ if (!prereq.ok) {
1289
+ console.error(`Error: ${prereq.message}`);
1290
+ process.exit(1);
1291
+ }
1292
+ }
1293
+ // Running fleet-sprint supervisor/sprint guard: before the running-server
1294
+ // guard so a refusal stops and writes nothing. --force does not bypass it
1295
+ // (update always passes --force); only the dedicated flag does. A member
1296
+ // install is exempt: it installs no fleet-se and is driven remotely by the
1297
+ // orchestrator, whose own host runs the sprints.
1298
+ if (!memberMode && !args.includes(IGNORE_RUNNING_SPRINTS_FLAG)
1299
+ && (isSea() || isNpmGlobalInstall()) && fleetSeGuardEnabled()) {
1300
+ let found = null;
1301
+ try {
1302
+ found = await detectRunningFleetSe(fleetSeProbes);
1303
+ }
1304
+ catch (err) {
1305
+ console.warn(`WARNING: could not check for a running fleet-sprint supervisor or sprint (${err.message}). If one is running, stop it before upgrading.`);
1306
+ }
1307
+ for (const w of found?.warnings ?? [])
1308
+ console.warn(`WARNING: ${w}`);
1309
+ if (found && (found.supervisor || found.sprints.length > 0)) {
1310
+ const self = (a) => selfInvocationLines({
1311
+ platform: process.platform, execPath: process.execPath, scriptPath: process.argv[1], sea: isSea(), args: ['install', ...a],
1312
+ });
1313
+ const text = fleetSeRefusalText(found, {
1314
+ platform: process.platform,
1315
+ rerunLines: self(args),
1316
+ ignoreLines: self([...args, IGNORE_RUNNING_SPRINTS_FLAG]),
1317
+ });
1318
+ console.error(text);
1319
+ // apra-fleet update runs install detached with no console: persist it
1320
+ // for the next service verb.
1321
+ writeServiceNotice(text.trim(), undefined, new Date(), Boolean(process.stderr.isTTY));
1322
+ process.exit(1);
1323
+ return;
1324
+ }
1325
+ }
1326
+ // Past the guard: a refusal persisted by an earlier (detached) install is
1327
+ // obsolete and must not be shown after this install succeeds. All OSes --
1328
+ // only the Windows service manager clears notices on registration.
1329
+ clearServiceNoticeContaining('E-FLEET-SE-RUNNING');
851
1330
  const serviceStep = isSea() && transport === 'http';
1331
+ // A member install exists to leave an auto-starting server behind. With no
1332
+ // service step (stdio transport or non-SEA install) nothing would register
1333
+ // the auto-start, so fail loudly before touching anything.
1334
+ if (memberMode && !serviceStep) {
1335
+ const why = transport !== 'http'
1336
+ ? `--transport ${transport} has no auto-start (use --transport http)`
1337
+ : 'a non-SEA (dev) install has no auto-start (use the SEA binary)';
1338
+ console.error(`
1339
+ Error: E-MEMBER-AUTOSTART: --member requires the user-mode auto-start, but ${why}.
1340
+ Nothing was installed.
1341
+ `);
1342
+ process.exitCode = 1;
1343
+ return;
1344
+ }
852
1345
  let totalSteps = (installFleet && installPm) ? 8 : installFleet ? 7 : installPm ? 8 : 6;
853
1346
  if (installAgents)
854
1347
  totalSteps++;
@@ -862,8 +1355,8 @@ Options:
862
1355
  totalSteps++;
863
1356
  // --- Running-process guard (SEA + npm modes -- dev mode runs via node, not a managed binary) ---
864
1357
  //
865
- // isApraFleetRunning() is OS-global on purpose (waitForApraFleetToStop() and
866
- // uninstall.ts depend on that). It is only the cheap first filter here:
1358
+ // isApraFleetRunning() is OS-global on purpose (uninstall.ts depends on
1359
+ // that). It is only the cheap first filter here:
867
1360
  // classifyRunningServer() then decides whether the running server is actually
868
1361
  // relevant to THIS install -- recorded live in the target data dir, or running
869
1362
  // from the install prefix we are about to overwrite (ETXTBSY). An unrelated
@@ -875,36 +1368,106 @@ Options:
875
1368
  if (runningScope && !runningScope.relevant) {
876
1369
  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
1370
  }
1371
+ // Set when the --force guard below stopped a REGISTERED service, so the
1372
+ // binary-copy step can bring it back up instead of leaving it down.
1373
+ let guardServiceMgr = null;
1374
+ let guardStoppedService = false;
878
1375
  if (runningScope?.relevant) {
879
1376
  if (!force) {
880
1377
  const killHint = process.platform === 'win32'
881
1378
  ? ' taskkill /F /IM apra-fleet.exe'
882
1379
  : ' pkill -x apra-fleet';
1380
+ // Name THIS executable, not "apra-fleet": a downloaded installer is
1381
+ // usually not on PATH, and PATH may resolve to the older installed one.
1382
+ const forceHint = selfInvocationLines({
1383
+ platform: process.platform,
1384
+ execPath: process.execPath,
1385
+ scriptPath: process.argv[1],
1386
+ sea: isSea(),
1387
+ args: ['install', ...args.filter(a => a !== '--force'), '--force'],
1388
+ }).map(l => ` ${l}`).join('\n');
883
1389
  console.error(`
884
1390
  Error: apra-fleet is currently running. Stop the server before installing.
885
1391
  (${runningScope.detail})
886
1392
 
887
1393
  Run with --force to stop it automatically:
888
- apra-fleet install --force
1394
+ ${forceHint}
889
1395
 
890
1396
  Or stop it manually:
891
1397
  ${killHint}
892
1398
  `);
893
1399
  process.exit(1);
894
1400
  }
895
- killApraFleet();
896
- await waitForApraFleetToStop();
897
- if (isApraFleetRunning()) {
1401
+ // A member install (fleet's remote upgrade path) never stops a server it
1402
+ // did not start unless explicitly told to: nothing has been stopped yet.
1403
+ if (!memberForceMayStop({ memberMode, overridden: forceStopFullInstall })) {
1404
+ console.error(fullInstallRefusalText(runningScope.detail));
1405
+ process.exit(3);
1406
+ }
1407
+ // Only the pids relevant to THIS install are stopped or watched -- by pid,
1408
+ // never by name, never this process (which may itself be named apra-fleet).
1409
+ // Unrelated apra-fleet servers of the same user are left alone.
1410
+ const relevantPids = () => relevantServerPids(BIN_DIR).map(String);
1411
+ // Snapshot BEFORE anything is stopped: a pid that is present afterwards but
1412
+ // absent here is a supervisor relaunch, not a process refusing to die.
1413
+ const pidsBeforeStop = relevantPids();
1414
+ guardServiceMgr = await registeredServiceManager();
1415
+ if (guardServiceMgr) {
1416
+ // A service is registered: stop the SERVICE, never pkill first.
1417
+ console.log(' Registered service detected -- stopping it through the service manager.');
1418
+ try {
1419
+ await guardServiceMgr.stop();
1420
+ guardStoppedService = true;
1421
+ }
1422
+ catch (err) {
1423
+ console.warn(` Service stop failed: ${err.message}`);
1424
+ }
1425
+ const stillUp = await waitForServiceStop(relevantPids);
1426
+ // Escalate ONLY when the very same pids are still there -- i.e. nothing
1427
+ // relaunched the server and there is no supervisor race to lose. If a NEW
1428
+ // pid appeared, signalling is futile and is deliberately skipped so the
1429
+ // relaunch is reported instead of retried forever.
1430
+ if (stillUp.length > 0 && stillUp.every(pid => pidsBeforeStop.includes(pid))) {
1431
+ killApraFleet(stillUp);
1432
+ await waitForApraFleetToStop(relevantPids);
1433
+ }
1434
+ }
1435
+ else {
1436
+ // No service registered: signal the relevant pids directly.
1437
+ killApraFleet(pidsBeforeStop);
1438
+ await waitForApraFleetToStop(relevantPids);
1439
+ }
1440
+ const pidsAfterStop = relevantPids();
1441
+ if (pidsAfterStop.length > 0) {
1442
+ const relaunchedPids = pidsAfterStop.filter(pid => !pidsBeforeStop.includes(pid));
1443
+ if (relaunchedPids.length > 0) {
1444
+ console.error(`
1445
+ Error: the apra-fleet server was RELAUNCHED by its service supervisor while
1446
+ install --force was stopping it -- the observed pid changed between polls (was
1447
+ ${pidsBeforeStop.join(', ') || 'none'}, now ${pidsAfterStop.join(', ')}), so it did not merely refuse to die.
1448
+ Signalling the process cannot win that race. Stop the service itself,
1449
+ then re-run the install:
1450
+ ${serviceStopCommand()}
1451
+ `);
1452
+ process.exit(1);
1453
+ }
898
1454
  console.error(`
899
1455
  Error: could not stop the running apra-fleet server (it is still running after
900
1456
  SIGTERM and a SIGKILL escalation). Stop it manually before installing:
901
- ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pkill -x apra-fleet'}
1457
+ ${manualStopHint(pidsAfterStop)}
902
1458
  `);
903
1459
  process.exit(1);
904
1460
  }
905
- console.log(' Stopped running server.');
1461
+ console.log(pidsBeforeStop.length > 0 || guardStoppedService
1462
+ ? ' Stopped running server.'
1463
+ : ' No running server process of this install was found to stop.');
906
1464
  }
907
1465
  console.log(`\nInstalling Apra Fleet ${serverVersion} for ${paths.name}...\n`);
1466
+ // Installing is an explicit (re)start intent: end a previous 'apra-fleet stop'.
1467
+ {
1468
+ const { clearStoppedMarker } = await import('../services/stopped-marker.js');
1469
+ clearStoppedMarker();
1470
+ }
908
1471
  // --- Step 1: Copy binary ---
909
1472
  let binaryPath = '';
910
1473
  if (isSea()) {
@@ -924,6 +1487,25 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
924
1487
  else {
925
1488
  console.log(` [1/${totalSteps}] Dev mode -- skipping binary copy`);
926
1489
  }
1490
+ // A registered service that the --force guard stopped must never be left
1491
+ // permanently down. When serviceStep is set the final install step
1492
+ // re-registers and starts it, so restarting here would only add a redundant
1493
+ // bootout/bootstrap cycle mid-install; otherwise nothing else would ever
1494
+ // bring it back, so start it now that the new binary is in place. Either way
1495
+ // the exact restart command is printed, so a failure at any later step stays
1496
+ // recoverable by hand.
1497
+ if (guardStoppedService && guardServiceMgr) {
1498
+ console.log(` The registered service was stopped by --force. Restart command: ${serviceRestartCommand()}`);
1499
+ if (!serviceStep) {
1500
+ try {
1501
+ await guardServiceMgr.start();
1502
+ console.log(' Restarted the registered service.');
1503
+ }
1504
+ catch (err) {
1505
+ console.warn(` [WARN] Could not restart the registered service: ${err.message}`);
1506
+ }
1507
+ }
1508
+ }
927
1509
  // --- Step 2: Extract hooks ---
928
1510
  console.log(` [2/${totalSteps}] Installing hooks...`);
929
1511
  const manifest = loadManifest();
@@ -948,7 +1530,10 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
948
1530
  // --- Step 4: Configure hooks + statusline in settings.json ---
949
1531
  console.log(` [4/${totalSteps}] Configuring ${paths.name} settings...`);
950
1532
  // OpenCode has a strict config schema -- hooks/statusLine/defaultModel are not valid keys
951
- if (llm !== 'opencode') {
1533
+ if (memberMode) {
1534
+ console.log(' Skipped (--member): user-scope settings are left untouched.');
1535
+ }
1536
+ else if (llm !== 'opencode') {
952
1537
  const installedHooksConfig = JSON.parse(fs.readFileSync(path.join(HOOKS_DIR, 'hooks-config.json'), 'utf-8'));
953
1538
  mergeHooksConfig(paths, installedHooksConfig, llm);
954
1539
  const statuslineScript = path.join(SCRIPTS_DIR, 'fleet-statusline.sh');
@@ -960,33 +1545,61 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
960
1545
  console.log(` [5/${totalSteps}] Registering MCP server...`);
961
1546
  const fleetPort = DEFAULT_PORT;
962
1547
  const fleetUrl = `http://localhost:${fleetPort}/mcp`;
963
- if (transport === 'http') {
964
- if (llm === 'claude') {
965
- if (!isCommandAvailable('claude')) {
966
- console.warn(` Warning: the 'claude' CLI was not found on PATH -- skipping MCP server registration.\n` +
967
- ` Install Claude Code (https://claude.com/claude-code), then re-run 'apra-fleet install'\n` +
968
- ` to register apra-fleet with it, or register manually with:\n` +
969
- ` claude mcp add --scope user --transport http apra-fleet ${fleetUrl}`);
970
- }
971
- else {
972
- try {
973
- run('claude mcp remove apra-fleet --scope user', { stdio: 'ignore' });
1548
+ // The server refuses an /mcp session without this install's access secret
1549
+ // (an owner-only file in its data dir), so every http registration carries
1550
+ // it as a header. Re-running install rewrites existing registrations.
1551
+ const secretExisted = readMemberAccessSecret() !== null;
1552
+ const fleetAccessHeaders = { [MEMBER_SECRET_HEADER]: getOrCreateMemberAccessSecret() };
1553
+ // Open LLM CLI sessions keep the MCP config they started with; a new secret
1554
+ // or a rewritten registration needs them restarted (reported at the end).
1555
+ // stdio registrations are not gated by the secret.
1556
+ let registrationChanged = !secretExisted && transport === 'http';
1557
+ if (memberMode) {
1558
+ // The per-folder member entry is written by compose_permissions; a member
1559
+ // install must never register apra-fleet in any provider's user-scope config.
1560
+ console.log(' Skipped (--member): no user-scope MCP registration.');
1561
+ }
1562
+ else if (transport === 'http') {
1563
+ const before = mcpRegistrationSnapshot(llm, paths);
1564
+ registerHttpMcp(llm, paths, fleetUrl, fleetAccessHeaders);
1565
+ if (mcpRegistrationSnapshot(llm, paths) !== before)
1566
+ registrationChanged = true;
1567
+ // Upgrade path: every OTHER provider this install registered earlier holds a
1568
+ // header-less http entry the server now refuses; rewrite those too. Each
1569
+ // provider keeps its own transport: a stdio entry (its own server process,
1570
+ // not gated by the access secret) is left untouched, and a provider with
1571
+ // no apra-fleet entry is not given one by another provider's install.
1572
+ for (const other of Object.keys(readInstallConfig().providers)) {
1573
+ if (other === llm || !INSTALLABLE_LLM_PROVIDERS.includes(other))
1574
+ continue;
1575
+ try {
1576
+ const otherPaths = getProviderInstallConfig(other);
1577
+ const existing = registeredMcpTransport(other, otherPaths);
1578
+ if (existing !== 'http') {
1579
+ console.log(` ${other}: ${existing === 'stdio' ? 'stdio registration kept as is' : 'no apra-fleet registration, skipped'}`);
1580
+ continue;
974
1581
  }
975
- catch { /* not registered */ }
976
- run(`claude mcp add --scope user --transport http apra-fleet ${fleetUrl}`);
1582
+ const otherBefore = mcpRegistrationSnapshot(other, otherPaths);
1583
+ registerHttpMcp(other, otherPaths, fleetUrl, fleetAccessHeaders);
1584
+ if (mcpRegistrationSnapshot(other, otherPaths) !== otherBefore)
1585
+ registrationChanged = true;
1586
+ }
1587
+ catch (err) {
1588
+ console.warn(` [!] could not refresh the ${other} MCP registration with the access secret: ${err instanceof Error ? err.message : String(err)}`);
977
1589
  }
978
1590
  }
979
- else if (llm === 'codex') {
980
- mergeCodexConfig(paths, { url: fleetUrl });
981
- }
982
- else if (llm === 'copilot') {
983
- mergeCopilotConfig(paths, { url: fleetUrl, type: 'http' });
984
- }
985
- else if (llm === 'agy') {
986
- mergeAgyConfig(paths, { url: fleetUrl });
1591
+ // Claude LOCAL-scope entries for this URL (e.g. an older `claude mcp add
1592
+ // apra-fleet` without --scope) win over the user-scope entry and stay
1593
+ // header-less: rewrite them with the secret too.
1594
+ try {
1595
+ const rewritten = refreshClaudeLocalScopeEntries(claudeUserConfigPath(), fleetUrl, fleetAccessHeaders);
1596
+ for (const project of rewritten)
1597
+ console.log(` claude: local-scope apra-fleet entry for ${project} rewritten with the access secret`);
1598
+ if (rewritten.length)
1599
+ registrationChanged = true;
987
1600
  }
988
- else if (llm === 'opencode') {
989
- mergeOpenCodeConfig(paths, { url: fleetUrl });
1601
+ catch (err) {
1602
+ console.warn(` [!] could not refresh claude local-scope apra-fleet entries: ${err instanceof Error ? err.message : String(err)}`);
990
1603
  }
991
1604
  }
992
1605
  else {
@@ -1248,11 +1861,15 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1248
1861
  // as a fallback), preserving this branch's no-dist/agents rule, and it
1249
1862
  // recurses into _shared/ and schemas/ which the old flat readdir missed.
1250
1863
  for (const { relPath, content: rawContent } of loadAgentAssets()) {
1864
+ // Every branch runs a transform -- the default one is NOT a passthrough. Claude
1865
+ // keeps the source frontmatter and every conditional's if-branch, but the
1866
+ // conditional markers themselves still have to be stripped or they ship
1867
+ // verbatim into the installed agent file (apra-fleet-oomh.1).
1251
1868
  const content = llm === 'opencode'
1252
1869
  ? transformAgentForOpenCode(rawContent, relPath)
1253
1870
  : llm === 'agy'
1254
1871
  ? transformAgentForAgy(rawContent, relPath)
1255
- : rawContent;
1872
+ : transformAgentForClaude(rawContent, relPath);
1256
1873
  writeAssetFile(path.join(agentsDestDir, relPath), content);
1257
1874
  }
1258
1875
  }
@@ -1309,26 +1926,22 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1309
1926
  }
1310
1927
  }
1311
1928
  // --- Beads install step ---
1312
- // shell:true required on Windows - npm global packages install as .cmd wrappers
1313
- // that cannot be directly spawned by Node without a shell
1929
+ // PATH first, then BIN_DIR, then npm -g, then a user-level install into
1930
+ // BIN_DIR (see beads-install.ts). NON-FATAL like dolt, but LOUD: a member
1931
+ // without bd cannot run sprint work, so the reason and the fix are printed
1932
+ // and repeated in the summary.
1314
1933
  // KB + code intelligence is the final step (before the optional service step),
1315
1934
  // so Beads sits one slot earlier than it does on main.
1316
1935
  const beadsStep = serviceStep ? totalSteps - 2 : totalSteps - 1;
1317
1936
  console.log(` [${beadsStep}/${totalSteps}] Installing Beads task tracker...`);
1318
- try {
1319
- // Check if already installed
1320
- try {
1321
- execFileSync('bd', ['--version'], { stdio: 'pipe', shell: true });
1322
- // already installed - skip
1323
- }
1324
- catch {
1325
- // not installed - install it
1326
- execFileSync('npm', ['install', '-g', '@beads/bd@1.1.2'], { stdio: 'inherit', shell: true });
1327
- }
1937
+ const beadsResult = installBeads(BIN_DIR, beadsStepDeps());
1938
+ if (beadsResult.state === 'installed' && beadsResult.location === 'bin-dir') {
1939
+ console.log(` - bd installed for this user at ${beadsResult.binPath} (fleet commands find it there; add ${BIN_DIR} to your own shell PATH to use bd by hand)`);
1328
1940
  }
1329
- catch (err) {
1330
- // non-fatal: warn but don't fail the install
1331
- console.warn(' - Beads install skipped - npm not available or install failed');
1941
+ else if (beadsResult.state === 'missing') {
1942
+ console.warn(` [!] Beads (bd) NOT installed: ${beadsResult.reason}`);
1943
+ console.warn(` [!] Fix: ${beadsResult.fix}`);
1944
+ console.warn(' - Beads install skipped - sprint work on this machine needs bd and will fail until it is installed');
1332
1945
  }
1333
1946
  // --- KB + code intelligence setup step ---
1334
1947
  // Only runs when the installer is invoked from inside a git repository.
@@ -1349,7 +1962,7 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1349
1962
  }
1350
1963
  }
1351
1964
  catch (err) {
1352
- console.warn(' ⚠ .mcp.json cleanup skipped:', err instanceof Error ? err.message : String(err));
1965
+ console.warn(' [!] .mcp.json cleanup skipped:', err instanceof Error ? err.message : String(err));
1353
1966
  }
1354
1967
  }
1355
1968
  else {
@@ -1368,26 +1981,33 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1368
1981
  console.log(' [OK] Code intelligence provider config written');
1369
1982
  }
1370
1983
  catch (err) {
1371
- console.warn(' ⚠ Code intelligence config skipped:', err instanceof Error ? err.message : String(err));
1984
+ console.warn(' [!] Code intelligence config skipped:', err instanceof Error ? err.message : String(err));
1372
1985
  }
1986
+ // Code intelligence runs through npx: warn now (inside this step, no new
1987
+ // numbered step) when node/npx cannot be resolved from the installer PATH.
1988
+ const codeIntelPathWarn = codeIntelPathWarning();
1989
+ if (codeIntelPathWarn)
1990
+ console.warn(` [!] ${codeIntelPathWarn}`);
1373
1991
  // Write code intelligence routing instruction to ~/.claude/CLAUDE.md
1374
- try {
1375
- const claudeMdPath = path.join(os.homedir(), '.claude', 'CLAUDE.md');
1376
- const sentinel = '<!-- apra-fleet:code-intelligence -->';
1377
- const block = `\n${sentinel}\nWhen code_graph, code_impact, code_query, or code_context tools are available,\nuse them for symbol lookups, call chain tracing, and impact analysis.\nNever use grep or file reads for structural questions when these tools are present.\n<!-- /apra-fleet:code-intelligence -->\n`;
1378
- const existing = fs.existsSync(claudeMdPath) ? fs.readFileSync(claudeMdPath, 'utf-8') : '';
1379
- if (!existing.includes(sentinel)) {
1380
- fs.mkdirSync(path.dirname(claudeMdPath), { recursive: true });
1381
- fs.appendFileSync(claudeMdPath, block);
1382
- console.log(' [OK] Code intelligence routing instruction written to ~/.claude/CLAUDE.md');
1992
+ // (never for a --member install: that file belongs to the member's user)
1993
+ if (!memberMode)
1994
+ try {
1995
+ const claudeMdPath = path.join(os.homedir(), '.claude', 'CLAUDE.md');
1996
+ const sentinel = '<!-- apra-fleet:code-intelligence -->';
1997
+ const block = `\n${sentinel}\nWhen code_graph, code_impact, code_query, or code_context tools are available,\nuse them for symbol lookups, call chain tracing, and impact analysis.\nNever use grep or file reads for structural questions when these tools are present.\n<!-- /apra-fleet:code-intelligence -->\n`;
1998
+ const existing = fs.existsSync(claudeMdPath) ? fs.readFileSync(claudeMdPath, 'utf-8') : '';
1999
+ if (!existing.includes(sentinel)) {
2000
+ fs.mkdirSync(path.dirname(claudeMdPath), { recursive: true });
2001
+ fs.appendFileSync(claudeMdPath, block);
2002
+ console.log(' [OK] Code intelligence routing instruction written to ~/.claude/CLAUDE.md');
2003
+ }
2004
+ }
2005
+ catch (err) {
2006
+ console.warn(' [!] ~/.claude/CLAUDE.md update skipped:', err instanceof Error ? err.message : String(err));
1383
2007
  }
1384
- }
1385
- catch (err) {
1386
- console.warn(' ⚠ ~/.claude/CLAUDE.md update skipped:', err instanceof Error ? err.message : String(err));
1387
- }
1388
2008
  // OpenCode uses --dangerously-skip-permissions and per-agent permission: frontmatter;
1389
2009
  // a top-level "permissions" key is invalid in opencode.json
1390
- if (llm !== 'opencode') {
2010
+ if (llm !== 'opencode' && !memberMode) {
1391
2011
  const extraPerms = (llm === 'claude' && installPm)
1392
2012
  ? ['Bash(*)', 'Skill(auto-sprint)', 'Workflow(auto-sprint)']
1393
2013
  : [];
@@ -1395,52 +2015,157 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
1395
2015
  }
1396
2016
  // Write install-config.json (merge provider entry)
1397
2017
  writeInstallConfig(llm, skillMode, workflowsMode);
2018
+ // The fleet owns this install from here on: record the marker BEFORE the
2019
+ // auto-start registration, which can fail. A failed auto-start still exits
2020
+ // non-zero (E-MEMBER-AUTOSTART) but leaves the marker, so the next fleet_install
2021
+ // "auto" recognises its own half-finished install and retries.
2022
+ if (memberMode)
2023
+ writeMemberInstallMarker(serverVersion, memberPort);
2024
+ // Every install holds a member access secret (owner-only, in its data dir):
2025
+ // its server accepts a ?member= session only with it, so another local
2026
+ // user's session cannot use this install. Created once, kept on reinstall
2027
+ // (sessions configured with it keep working). Best effort here -- the server
2028
+ // creates it at start too.
2029
+ try {
2030
+ const { getOrCreateMemberAccessSecret, memberAccessSecretPath } = await import('../services/member-access-secret.js');
2031
+ getOrCreateMemberAccessSecret(memberAccessSecretPath(getInstallDataDir()));
2032
+ }
2033
+ catch (err) {
2034
+ console.warn(' [!] member access secret not created:', err instanceof Error ? err.message : String(err));
2035
+ }
2036
+ // Windows: make the data dir and the secret owner-only NOW, and say so
2037
+ // loudly when icacls fails (the server only logs it). POSIX keeps its
2038
+ // chmod path (0600 file mode, 0700 dirs at server start).
2039
+ if (process.platform === 'win32') {
2040
+ try {
2041
+ const { ownerOnlyInstallWarnings } = await import('../utils/owner-only-fs.js');
2042
+ const { memberAccessSecretPath } = await import('../services/member-access-secret.js');
2043
+ const dataDir = getInstallDataDir();
2044
+ for (const line of ownerOnlyInstallWarnings([{ path: dataDir, kind: 'dir' }, { path: memberAccessSecretPath(dataDir), kind: 'file' }])) {
2045
+ console.warn(line);
2046
+ }
2047
+ }
2048
+ catch (err) {
2049
+ console.warn(' [!] owner-only permissions not checked:', err instanceof Error ? err.message : String(err));
2050
+ }
2051
+ }
1398
2052
  // --- Step N: Register and start service (SEA + HTTP mode only) ---
1399
2053
  let serviceRegistered = false;
2054
+ let serviceHealthy = null;
2055
+ let serviceReused = false;
2056
+ let serviceRunKey = false;
1400
2057
  if (serviceStep) {
1401
2058
  console.log(` [${totalSteps}/${totalSteps}] Registering and starting service...`);
2059
+ // The server refuses to start when its configured port is taken (no
2060
+ // random-port fallback, GitHub #584) -- say so here rather than leaving a
2061
+ // service that exits on every launch with the reason only in the log.
2062
+ {
2063
+ const { checkRunningInstance, isPortInUse, portInUseMessage, readServerInfoPid } = await import('../services/singleton.js');
2064
+ const probe = await checkRunningInstance();
2065
+ const serverPort = resolveServerPort();
2066
+ if (probe.state === 'gone' && await isPortInUse(serverPort, DEFAULT_HOST)) {
2067
+ const { findPortHolder, describePortConflict } = await import('../services/port-holder.js');
2068
+ const conflict = describePortConflict(serverPort, portInUseMessage(serverPort, readServerInfoPid()), await findPortHolder(serverPort), memberMode ? 'member' : 'full');
2069
+ // Another user's process holds this install's port (a second member
2070
+ // install on this host): the server can never start here, so fail
2071
+ // now with who holds it and the remedy, not after a dead service.
2072
+ if (conflict.foreign) {
2073
+ console.error(`
2074
+ Error: ${conflict.message}
2075
+ `);
2076
+ process.exitCode = 1;
2077
+ return;
2078
+ }
2079
+ console.warn(` Warning: ${conflict.message}`);
2080
+ }
2081
+ }
1402
2082
  const svcMgr = await getServiceManager();
1403
2083
  try {
1404
- await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH);
2084
+ const registered = await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH);
2085
+ serviceReused = registered === 'reused';
2086
+ serviceRunKey = registered === 'run-key';
2087
+ if (serviceReused)
2088
+ console.log(' Could not recreate the service task -- existing task reused.');
2089
+ if (serviceRunKey) {
2090
+ console.log(' Could not create the scheduled task -- registered a per-user logon entry (HKCU Run) instead.');
2091
+ console.log(' This starts the server at logon but does NOT restart it if it stops; use apra-fleet start.');
2092
+ }
1405
2093
  try {
1406
2094
  await svcMgr.start();
1407
2095
  serviceRegistered = true;
2096
+ // Never report "running" on the strength of the start call alone (a
2097
+ // launcher that cannot run, a refused port, a crash): ask /health.
2098
+ serviceHealthy = await waitForServiceHealth();
2099
+ if (serviceHealthy === false) {
2100
+ console.warn(` Service registered, but the server is not answering /health. Check ${LOG_FILE_PATH} and run apra-fleet status.`);
2101
+ }
1408
2102
  }
1409
2103
  catch (startErr) {
1410
- try {
1411
- await svcMgr.unregister();
2104
+ // Never delete a reused task: it predates this install (e.g. elevated).
2105
+ if (!serviceReused) {
2106
+ try {
2107
+ await svcMgr.unregister();
2108
+ }
2109
+ catch { }
1412
2110
  }
1413
- catch { }
1414
2111
  throw startErr;
1415
2112
  }
1416
2113
  }
1417
2114
  catch (err) {
1418
2115
  console.warn(` Service registration skipped: ${err.message}`);
2116
+ // A member install exists to leave an auto-starting server behind; without
2117
+ // the auto-start it is not a success, so say so with a typed status.
2118
+ if (memberMode) {
2119
+ console.error(`
2120
+ Error: E-MEMBER-AUTOSTART: the member install could not register the user-mode
2121
+ auto-start (${err.message}). The server binary is installed but will
2122
+ not start automatically.
2123
+ `);
2124
+ process.exitCode = 1;
2125
+ return;
2126
+ }
2127
+ // --force stopped the server; reporting success would leave it down silently.
2128
+ if (force && (runningScope?.relevant || guardStoppedService)) {
2129
+ const restartHint = guardStoppedService
2130
+ ? `Start it with:\n ${serviceRestartCommand()}\nthen run 'apra-fleet status' for how to repair the service (apra-fleet never needs an elevated install).`
2131
+ : 'Start it with:\n apra-fleet start';
2132
+ console.error(`
2133
+ Error: install --force stopped the running apra-fleet server, but the service
2134
+ could not be registered/started, so the server is NOT running.
2135
+ ${restartHint}
2136
+ `);
2137
+ process.exit(1);
2138
+ }
1419
2139
  }
1420
2140
  }
1421
2141
  // --- Done ---
1422
- let beadsVersion = 'installed';
1423
- try {
1424
- const versionOut = execFileSync('bd', ['--version'], { stdio: 'pipe', encoding: 'utf-8', shell: true });
1425
- beadsVersion = versionOut.trim() || 'installed';
1426
- }
1427
- catch {
1428
- beadsVersion = 'not available';
1429
- }
2142
+ if (!memberMode)
2143
+ clearMemberInstallMarker();
2144
+ const beadsVersion = beadsResult.state === 'missing'
2145
+ ? `not available -- ${beadsResult.reason}. Fix: ${beadsResult.fix}`
2146
+ : `${beadsResult.version}${beadsResult.location === 'bin-dir' ? ` (${beadsResult.binPath})` : ''}`;
1430
2147
  const clientName = llm === 'claude' ? 'Claude Code' : paths.name;
1431
- const instructions = llm === 'claude' ? 'Run /mcp in Claude Code to load the server.' : `Restart ${paths.name} to load the server.`;
1432
- const forceNote = force ? `\nRestart ${clientName} to reload the MCP server.` : '';
1433
- const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ? 'registered and running' : 'registration skipped'}` : '';
2148
+ // A member install touched no user-scope settings or MCP registration, so it
2149
+ // names only what it did and the member's one next step (on the orchestrator).
2150
+ const instructions = memberMode
2151
+ ? MEMBER_INSTALL_NEXT_STEP
2152
+ : llm === 'claude' ? 'Run /mcp in Claude Code to load the server.' : `Restart ${paths.name} to load the server.`;
2153
+ const forceNote = force && !memberMode ? `\nRestart ${clientName} to reload the MCP server.` : '';
2154
+ const accessNote = registrationChanged && !memberMode
2155
+ ? '\n[!] Restart every open LLM CLI session (Claude Code, Codex, ...): sessions started before this install keep their old MCP registration without the access secret, and the server refuses them (Claude Code shows "Dynamic Client Registration rejected (HTTP 404)").'
2156
+ : '';
2157
+ const settingsLine = memberMode ? '' : `\n Settings: ${paths.settingsFile}`;
2158
+ const serviceState = serviceHealthy === true ? 'registered and running' : serviceHealthy === false ? 'registered, but NOT answering /health (see the warning above)' : 'registered (health not checked)';
2159
+ const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ? `${serviceState}${serviceReused ? ' (existing task reused)' : ''}${serviceRunKey ? ' (logon autostart via HKCU Run, no automatic restart)' : ''}` : 'registration skipped'}` : '';
1434
2160
  console.log(`
1435
2161
  Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
1436
2162
  Binary: ${BIN_DIR}
1437
2163
  Hooks: ${HOOKS_DIR}
1438
- Scripts: ${SCRIPTS_DIR}
1439
- Settings: ${paths.settingsFile}${installFleet ? `\n Fleet Skill: ${paths.fleetSkillsDir}` : ''}${installPm ? `\n PM Skill: ${paths.skillsDir}` : ''}${installAgents ? `\n Agents: ${paths.agentsDir}` : ''}
2164
+ Scripts: ${SCRIPTS_DIR}${settingsLine}${installFleet ? `\n Fleet Skill: ${paths.fleetSkillsDir}` : ''}${installPm ? `\n PM Skill: ${paths.skillsDir}` : ''}${installAgents ? `\n Agents: ${paths.agentsDir}` : ''}
1440
2165
  Beads: ${beadsVersion}
1441
2166
  Dolt: ${doltVersion}${serviceLine}
1442
2167
 
1443
- ${instructions}${forceNote}
2168
+ ${instructions}${forceNote}${accessNote}
1444
2169
  `);
1445
2170
  if (llm === 'claude' && installPm) {
1446
2171
  console.log(' /auto-sprint BD-1 (native workflow, current branch)');