@apralabs/apra-fleet 0.3.6 → 0.4.0

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 (569) hide show
  1. package/README.md +245 -257
  2. package/dist/agents/backlog-groomer.md +287 -0
  3. package/dist/agents/deployer.md +52 -11
  4. package/dist/agents/doer.md +32 -7
  5. package/dist/agents/integ-test-runner.md +151 -61
  6. package/dist/agents/plan-reviewer.md +74 -17
  7. package/dist/agents/planner.md +94 -14
  8. package/dist/agents/regression-test-runner.md +216 -0
  9. package/dist/agents/reviewer.md +21 -6
  10. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  11. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  12. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  13. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  14. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  15. package/dist/agents/schemas/reviewer-output.json +4 -0
  16. package/dist/cli/agent-transform.d.ts +1 -0
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +77 -0
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts +3 -0
  21. package/dist/cli/auth.d.ts.map +1 -1
  22. package/dist/cli/auth.js +181 -5
  23. package/dist/cli/auth.js.map +1 -1
  24. package/dist/cli/config.d.ts +5 -1
  25. package/dist/cli/config.d.ts.map +1 -1
  26. package/dist/cli/config.js +7 -1
  27. package/dist/cli/config.js.map +1 -1
  28. package/dist/cli/dolt-install.d.ts +91 -0
  29. package/dist/cli/dolt-install.d.ts.map +1 -0
  30. package/dist/cli/dolt-install.js +334 -0
  31. package/dist/cli/dolt-install.js.map +1 -0
  32. package/dist/cli/install-guard.d.ts +29 -0
  33. package/dist/cli/install-guard.d.ts.map +1 -0
  34. package/dist/cli/install-guard.js +153 -0
  35. package/dist/cli/install-guard.js.map +1 -0
  36. package/dist/cli/install.d.ts +44 -3
  37. package/dist/cli/install.d.ts.map +1 -1
  38. package/dist/cli/install.js +604 -108
  39. package/dist/cli/install.js.map +1 -1
  40. package/dist/cli/join.d.ts +12 -0
  41. package/dist/cli/join.d.ts.map +1 -0
  42. package/dist/cli/join.js +87 -0
  43. package/dist/cli/join.js.map +1 -0
  44. package/dist/cli/register-member.d.ts +2 -0
  45. package/dist/cli/register-member.d.ts.map +1 -0
  46. package/dist/cli/register-member.js +193 -0
  47. package/dist/cli/register-member.js.map +1 -0
  48. package/dist/cli/restart.d.ts +2 -0
  49. package/dist/cli/restart.d.ts.map +1 -0
  50. package/dist/cli/restart.js +7 -0
  51. package/dist/cli/restart.js.map +1 -0
  52. package/dist/cli/spoke.d.ts +35 -0
  53. package/dist/cli/spoke.d.ts.map +1 -0
  54. package/dist/cli/spoke.js +212 -0
  55. package/dist/cli/spoke.js.map +1 -0
  56. package/dist/cli/start.d.ts +2 -0
  57. package/dist/cli/start.d.ts.map +1 -0
  58. package/dist/cli/start.js +92 -0
  59. package/dist/cli/start.js.map +1 -0
  60. package/dist/cli/status.d.ts +2 -0
  61. package/dist/cli/status.d.ts.map +1 -0
  62. package/dist/cli/status.js +83 -0
  63. package/dist/cli/status.js.map +1 -0
  64. package/dist/cli/stop.d.ts +2 -0
  65. package/dist/cli/stop.d.ts.map +1 -0
  66. package/dist/cli/stop.js +51 -0
  67. package/dist/cli/stop.js.map +1 -0
  68. package/dist/cli/uninstall.d.ts.map +1 -1
  69. package/dist/cli/uninstall.js +109 -9
  70. package/dist/cli/uninstall.js.map +1 -1
  71. package/dist/cli/update.d.ts.map +1 -1
  72. package/dist/cli/update.js +10 -1
  73. package/dist/cli/update.js.map +1 -1
  74. package/dist/cli/workflow-assets.d.ts +37 -0
  75. package/dist/cli/workflow-assets.d.ts.map +1 -0
  76. package/dist/cli/workflow-assets.js +144 -0
  77. package/dist/cli/workflow-assets.js.map +1 -0
  78. package/dist/cli/workflow.d.ts +75 -0
  79. package/dist/cli/workflow.d.ts.map +1 -0
  80. package/dist/cli/workflow.js +397 -0
  81. package/dist/cli/workflow.js.map +1 -0
  82. package/dist/hub-service/activity.d.ts +30 -0
  83. package/dist/hub-service/activity.d.ts.map +1 -0
  84. package/dist/hub-service/activity.js +20 -0
  85. package/dist/hub-service/activity.js.map +1 -0
  86. package/dist/hub-service/audit-log.d.ts +19 -0
  87. package/dist/hub-service/audit-log.d.ts.map +1 -0
  88. package/dist/hub-service/audit-log.js +13 -0
  89. package/dist/hub-service/audit-log.js.map +1 -0
  90. package/dist/hub-service/db/pool.d.ts +19 -0
  91. package/dist/hub-service/db/pool.d.ts.map +1 -0
  92. package/dist/hub-service/db/pool.js +53 -0
  93. package/dist/hub-service/db/pool.js.map +1 -0
  94. package/dist/hub-service/enrollment.d.ts +29 -0
  95. package/dist/hub-service/enrollment.d.ts.map +1 -0
  96. package/dist/hub-service/enrollment.js +48 -0
  97. package/dist/hub-service/enrollment.js.map +1 -0
  98. package/dist/hub-service/envelope-routes.d.ts +46 -0
  99. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  100. package/dist/hub-service/envelope-routes.js +94 -0
  101. package/dist/hub-service/envelope-routes.js.map +1 -0
  102. package/dist/hub-service/handlers/installers.d.ts +14 -0
  103. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  104. package/dist/hub-service/handlers/installers.js +8 -0
  105. package/dist/hub-service/handlers/installers.js.map +1 -0
  106. package/dist/hub-service/http-server.d.ts +31 -0
  107. package/dist/hub-service/http-server.d.ts.map +1 -0
  108. package/dist/hub-service/http-server.js +711 -0
  109. package/dist/hub-service/http-server.js.map +1 -0
  110. package/dist/hub-service/hub-jwt.d.ts +30 -0
  111. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  112. package/dist/hub-service/hub-jwt.js +105 -0
  113. package/dist/hub-service/hub-jwt.js.map +1 -0
  114. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  115. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  116. package/dist/hub-service/jwt-revocation.js +18 -0
  117. package/dist/hub-service/jwt-revocation.js.map +1 -0
  118. package/dist/hub-service/machines.d.ts +16 -0
  119. package/dist/hub-service/machines.d.ts.map +1 -0
  120. package/dist/hub-service/machines.js +14 -0
  121. package/dist/hub-service/machines.js.map +1 -0
  122. package/dist/hub-service/main.d.ts +3 -0
  123. package/dist/hub-service/main.d.ts.map +1 -0
  124. package/dist/hub-service/main.js +64 -0
  125. package/dist/hub-service/main.js.map +1 -0
  126. package/dist/hub-service/member-tokens.d.ts +11 -0
  127. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  128. package/dist/hub-service/member-tokens.js +49 -0
  129. package/dist/hub-service/member-tokens.js.map +1 -0
  130. package/dist/hub-service/member-view.d.ts +20 -0
  131. package/dist/hub-service/member-view.d.ts.map +1 -0
  132. package/dist/hub-service/member-view.js +76 -0
  133. package/dist/hub-service/member-view.js.map +1 -0
  134. package/dist/hub-service/members.d.ts +44 -0
  135. package/dist/hub-service/members.d.ts.map +1 -0
  136. package/dist/hub-service/members.js +25 -0
  137. package/dist/hub-service/members.js.map +1 -0
  138. package/dist/hub-service/presence.d.ts +40 -0
  139. package/dist/hub-service/presence.d.ts.map +1 -0
  140. package/dist/hub-service/presence.js +44 -0
  141. package/dist/hub-service/presence.js.map +1 -0
  142. package/dist/hub-service/project-view.d.ts +12 -0
  143. package/dist/hub-service/project-view.d.ts.map +1 -0
  144. package/dist/hub-service/project-view.js +34 -0
  145. package/dist/hub-service/project-view.js.map +1 -0
  146. package/dist/hub-service/projects.d.ts +48 -0
  147. package/dist/hub-service/projects.d.ts.map +1 -0
  148. package/dist/hub-service/projects.js +80 -0
  149. package/dist/hub-service/projects.js.map +1 -0
  150. package/dist/hub-service/relay-queue.d.ts +115 -0
  151. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  152. package/dist/hub-service/relay-queue.js +148 -0
  153. package/dist/hub-service/relay-queue.js.map +1 -0
  154. package/dist/hub-service/session-jwt.d.ts +10 -0
  155. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  156. package/dist/hub-service/session-jwt.js +69 -0
  157. package/dist/hub-service/session-jwt.js.map +1 -0
  158. package/dist/hub-service/usage.d.ts +40 -0
  159. package/dist/hub-service/usage.d.ts.map +1 -0
  160. package/dist/hub-service/usage.js +25 -0
  161. package/dist/hub-service/usage.js.map +1 -0
  162. package/dist/hub-service/users.d.ts +56 -0
  163. package/dist/hub-service/users.d.ts.map +1 -0
  164. package/dist/hub-service/users.js +72 -0
  165. package/dist/hub-service/users.js.map +1 -0
  166. package/dist/hub-service/workspaces.d.ts +20 -0
  167. package/dist/hub-service/workspaces.d.ts.map +1 -0
  168. package/dist/hub-service/workspaces.js +10 -0
  169. package/dist/hub-service/workspaces.js.map +1 -0
  170. package/dist/index.js +179 -132
  171. package/dist/index.js.map +1 -1
  172. package/dist/os/linux.d.ts +13 -0
  173. package/dist/os/linux.d.ts.map +1 -1
  174. package/dist/os/linux.js +62 -3
  175. package/dist/os/linux.js.map +1 -1
  176. package/dist/os/os-commands.d.ts +10 -0
  177. package/dist/os/os-commands.d.ts.map +1 -1
  178. package/dist/os/windows.d.ts +1 -0
  179. package/dist/os/windows.d.ts.map +1 -1
  180. package/dist/os/windows.js +21 -1
  181. package/dist/os/windows.js.map +1 -1
  182. package/dist/paths.d.ts +23 -0
  183. package/dist/paths.d.ts.map +1 -1
  184. package/dist/paths.js +29 -0
  185. package/dist/paths.js.map +1 -1
  186. package/dist/providers/agy.d.ts +9 -2
  187. package/dist/providers/agy.d.ts.map +1 -1
  188. package/dist/providers/agy.js +127 -14
  189. package/dist/providers/agy.js.map +1 -1
  190. package/dist/providers/claude.d.ts +6 -2
  191. package/dist/providers/claude.d.ts.map +1 -1
  192. package/dist/providers/claude.js +248 -9
  193. package/dist/providers/claude.js.map +1 -1
  194. package/dist/providers/codex.d.ts +3 -2
  195. package/dist/providers/codex.d.ts.map +1 -1
  196. package/dist/providers/codex.js +7 -0
  197. package/dist/providers/codex.js.map +1 -1
  198. package/dist/providers/copilot.d.ts +3 -2
  199. package/dist/providers/copilot.d.ts.map +1 -1
  200. package/dist/providers/copilot.js +8 -1
  201. package/dist/providers/copilot.js.map +1 -1
  202. package/dist/providers/gemini.d.ts +3 -2
  203. package/dist/providers/gemini.d.ts.map +1 -1
  204. package/dist/providers/gemini.js +11 -1
  205. package/dist/providers/gemini.js.map +1 -1
  206. package/dist/providers/index.d.ts +1 -0
  207. package/dist/providers/index.d.ts.map +1 -1
  208. package/dist/providers/index.js +3 -0
  209. package/dist/providers/index.js.map +1 -1
  210. package/dist/providers/none.d.ts +51 -0
  211. package/dist/providers/none.d.ts.map +1 -0
  212. package/dist/providers/none.js +103 -0
  213. package/dist/providers/none.js.map +1 -0
  214. package/dist/providers/opencode.d.ts +4 -2
  215. package/dist/providers/opencode.d.ts.map +1 -1
  216. package/dist/providers/opencode.js +49 -0
  217. package/dist/providers/opencode.js.map +1 -1
  218. package/dist/providers/provider.d.ts +79 -1
  219. package/dist/providers/provider.d.ts.map +1 -1
  220. package/dist/providers/provider.js +10 -0
  221. package/dist/providers/provider.js.map +1 -1
  222. package/dist/services/agent-provisioner.d.ts +3 -3
  223. package/dist/services/agent-provisioner.d.ts.map +1 -1
  224. package/dist/services/agent-provisioner.js +12 -5
  225. package/dist/services/agent-provisioner.js.map +1 -1
  226. package/dist/services/auth-socket.d.ts.map +1 -1
  227. package/dist/services/auth-socket.js +2 -0
  228. package/dist/services/auth-socket.js.map +1 -1
  229. package/dist/services/budget-awareness.d.ts +130 -0
  230. package/dist/services/budget-awareness.d.ts.map +1 -0
  231. package/dist/services/budget-awareness.js +129 -0
  232. package/dist/services/budget-awareness.js.map +1 -0
  233. package/dist/services/cloud-sync.d.ts +35 -0
  234. package/dist/services/cloud-sync.d.ts.map +1 -0
  235. package/dist/services/cloud-sync.js +90 -0
  236. package/dist/services/cloud-sync.js.map +1 -0
  237. package/dist/services/context-admission.d.ts +82 -0
  238. package/dist/services/context-admission.d.ts.map +1 -0
  239. package/dist/services/context-admission.js +136 -0
  240. package/dist/services/context-admission.js.map +1 -0
  241. package/dist/services/event-bus.d.ts +27 -0
  242. package/dist/services/event-bus.d.ts.map +1 -0
  243. package/dist/services/event-bus.js +20 -0
  244. package/dist/services/event-bus.js.map +1 -0
  245. package/dist/services/file-chunker.d.ts +38 -0
  246. package/dist/services/file-chunker.d.ts.map +1 -0
  247. package/dist/services/file-chunker.js +63 -0
  248. package/dist/services/file-chunker.js.map +1 -0
  249. package/dist/services/file-transfer-relay.d.ts +55 -0
  250. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  251. package/dist/services/file-transfer-relay.js +115 -0
  252. package/dist/services/file-transfer-relay.js.map +1 -0
  253. package/dist/services/github-app.d.ts.map +1 -1
  254. package/dist/services/github-app.js +1 -0
  255. package/dist/services/github-app.js.map +1 -1
  256. package/dist/services/http-transport.d.ts +25 -0
  257. package/dist/services/http-transport.d.ts.map +1 -0
  258. package/dist/services/http-transport.js +371 -0
  259. package/dist/services/http-transport.js.map +1 -0
  260. package/dist/services/hub-client.d.ts +69 -0
  261. package/dist/services/hub-client.d.ts.map +1 -0
  262. package/dist/services/hub-client.js +217 -0
  263. package/dist/services/hub-client.js.map +1 -0
  264. package/dist/services/jwt.d.ts +17 -0
  265. package/dist/services/jwt.d.ts.map +1 -0
  266. package/dist/services/jwt.js +70 -0
  267. package/dist/services/jwt.js.map +1 -0
  268. package/dist/services/known-sessions.d.ts +8 -0
  269. package/dist/services/known-sessions.d.ts.map +1 -0
  270. package/dist/services/known-sessions.js +40 -0
  271. package/dist/services/known-sessions.js.map +1 -0
  272. package/dist/services/model-pricing.d.ts +36 -0
  273. package/dist/services/model-pricing.d.ts.map +1 -0
  274. package/dist/services/model-pricing.js +108 -0
  275. package/dist/services/model-pricing.js.map +1 -0
  276. package/dist/services/orphan-recovery.d.ts +56 -0
  277. package/dist/services/orphan-recovery.d.ts.map +1 -0
  278. package/dist/services/orphan-recovery.js +111 -0
  279. package/dist/services/orphan-recovery.js.map +1 -0
  280. package/dist/services/pending-responses.d.ts +23 -0
  281. package/dist/services/pending-responses.d.ts.map +1 -0
  282. package/dist/services/pending-responses.js +52 -0
  283. package/dist/services/pending-responses.js.map +1 -0
  284. package/dist/services/registry.d.ts +4 -1
  285. package/dist/services/registry.d.ts.map +1 -1
  286. package/dist/services/registry.js +3 -0
  287. package/dist/services/registry.js.map +1 -1
  288. package/dist/services/relay-context.d.ts +23 -0
  289. package/dist/services/relay-context.d.ts.map +1 -0
  290. package/dist/services/relay-context.js +8 -0
  291. package/dist/services/relay-context.js.map +1 -0
  292. package/dist/services/relay-executor.d.ts +68 -0
  293. package/dist/services/relay-executor.d.ts.map +1 -0
  294. package/dist/services/relay-executor.js +70 -0
  295. package/dist/services/relay-executor.js.map +1 -0
  296. package/dist/services/relay-request.d.ts +65 -0
  297. package/dist/services/relay-request.d.ts.map +1 -0
  298. package/dist/services/relay-request.js +129 -0
  299. package/dist/services/relay-request.js.map +1 -0
  300. package/dist/services/relay-strategy.d.ts +19 -0
  301. package/dist/services/relay-strategy.d.ts.map +1 -0
  302. package/dist/services/relay-strategy.js +111 -0
  303. package/dist/services/relay-strategy.js.map +1 -0
  304. package/dist/services/service-manager/index.d.ts +5 -0
  305. package/dist/services/service-manager/index.d.ts.map +1 -0
  306. package/dist/services/service-manager/index.js +66 -0
  307. package/dist/services/service-manager/index.js.map +1 -0
  308. package/dist/services/service-manager/linux.d.ts +10 -0
  309. package/dist/services/service-manager/linux.d.ts.map +1 -0
  310. package/dist/services/service-manager/linux.js +97 -0
  311. package/dist/services/service-manager/linux.js.map +1 -0
  312. package/dist/services/service-manager/macos.d.ts +10 -0
  313. package/dist/services/service-manager/macos.d.ts.map +1 -0
  314. package/dist/services/service-manager/macos.js +94 -0
  315. package/dist/services/service-manager/macos.js.map +1 -0
  316. package/dist/services/service-manager/types.d.ts +18 -0
  317. package/dist/services/service-manager/types.d.ts.map +1 -0
  318. package/dist/services/service-manager/types.js +5 -0
  319. package/dist/services/service-manager/types.js.map +1 -0
  320. package/dist/services/service-manager/windows.d.ts +10 -0
  321. package/dist/services/service-manager/windows.d.ts.map +1 -0
  322. package/dist/services/service-manager/windows.js +73 -0
  323. package/dist/services/service-manager/windows.js.map +1 -0
  324. package/dist/services/session-registry.d.ts +70 -0
  325. package/dist/services/session-registry.d.ts.map +1 -0
  326. package/dist/services/session-registry.js +91 -0
  327. package/dist/services/session-registry.js.map +1 -0
  328. package/dist/services/singleton.d.ts +15 -0
  329. package/dist/services/singleton.d.ts.map +1 -0
  330. package/dist/services/singleton.js +98 -0
  331. package/dist/services/singleton.js.map +1 -0
  332. package/dist/services/sprint-coordination.d.ts +168 -0
  333. package/dist/services/sprint-coordination.d.ts.map +1 -0
  334. package/dist/services/sprint-coordination.js +564 -0
  335. package/dist/services/sprint-coordination.js.map +1 -0
  336. package/dist/services/ssh.d.ts.map +1 -1
  337. package/dist/services/ssh.js +70 -3
  338. package/dist/services/ssh.js.map +1 -1
  339. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  340. package/dist/services/stall/log-path-resolver.js +8 -1
  341. package/dist/services/stall/log-path-resolver.js.map +1 -1
  342. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  343. package/dist/services/stall/stall-detector.js +39 -7
  344. package/dist/services/stall/stall-detector.js.map +1 -1
  345. package/dist/services/stall/stall-poller.d.ts +16 -0
  346. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  347. package/dist/services/stall/stall-poller.js +136 -18
  348. package/dist/services/stall/stall-poller.js.map +1 -1
  349. package/dist/services/strategy.d.ts.map +1 -1
  350. package/dist/services/strategy.js +55 -5
  351. package/dist/services/strategy.js.map +1 -1
  352. package/dist/services/substitution-engine.d.ts +20 -0
  353. package/dist/services/substitution-engine.d.ts.map +1 -0
  354. package/dist/services/substitution-engine.js +92 -0
  355. package/dist/services/substitution-engine.js.map +1 -0
  356. package/dist/services/task-cleanup.d.ts.map +1 -1
  357. package/dist/services/task-cleanup.js +1 -9
  358. package/dist/services/task-cleanup.js.map +1 -1
  359. package/dist/services/token-issuer.d.ts +47 -0
  360. package/dist/services/token-issuer.d.ts.map +1 -0
  361. package/dist/services/token-issuer.js +63 -0
  362. package/dist/services/token-issuer.js.map +1 -0
  363. package/dist/services/tool-registry.d.ts +3 -0
  364. package/dist/services/tool-registry.d.ts.map +1 -0
  365. package/dist/services/tool-registry.js +139 -0
  366. package/dist/services/tool-registry.js.map +1 -0
  367. package/dist/services/user-config.d.ts +14 -0
  368. package/dist/services/user-config.d.ts.map +1 -1
  369. package/dist/services/user-config.js +55 -0
  370. package/dist/services/user-config.js.map +1 -1
  371. package/dist/services/vcs/types.d.ts +44 -0
  372. package/dist/services/vcs/types.d.ts.map +1 -1
  373. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  374. package/dist/skills/pm/cost.md +3 -0
  375. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  376. package/dist/tools/check-status.d.ts.map +1 -1
  377. package/dist/tools/check-status.js +8 -2
  378. package/dist/tools/check-status.js.map +1 -1
  379. package/dist/tools/child-id-allocator.d.ts +45 -0
  380. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  381. package/dist/tools/child-id-allocator.js +62 -0
  382. package/dist/tools/child-id-allocator.js.map +1 -0
  383. package/dist/tools/cloud-control.d.ts +2 -2
  384. package/dist/tools/compose-permissions.d.ts +12 -4
  385. package/dist/tools/compose-permissions.d.ts.map +1 -1
  386. package/dist/tools/compose-permissions.js +55 -4
  387. package/dist/tools/compose-permissions.js.map +1 -1
  388. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  389. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  390. package/dist/tools/dolt-push-mutex.js +83 -0
  391. package/dist/tools/dolt-push-mutex.js.map +1 -0
  392. package/dist/tools/execute-command.d.ts +11 -1
  393. package/dist/tools/execute-command.d.ts.map +1 -1
  394. package/dist/tools/execute-command.js +22 -5
  395. package/dist/tools/execute-command.js.map +1 -1
  396. package/dist/tools/execute-prompt.d.ts +72 -12
  397. package/dist/tools/execute-prompt.d.ts.map +1 -1
  398. package/dist/tools/execute-prompt.js +962 -71
  399. package/dist/tools/execute-prompt.js.map +1 -1
  400. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  401. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  402. package/dist/tools/get-member-model-pricing.js +29 -0
  403. package/dist/tools/get-member-model-pricing.js.map +1 -0
  404. package/dist/tools/list-members.d.ts.map +1 -1
  405. package/dist/tools/list-members.js +39 -7
  406. package/dist/tools/list-members.js.map +1 -1
  407. package/dist/tools/member-detail.d.ts +1 -1
  408. package/dist/tools/member-detail.d.ts.map +1 -1
  409. package/dist/tools/member-detail.js +8 -2
  410. package/dist/tools/member-detail.js.map +1 -1
  411. package/dist/tools/member-reservation.d.ts +29 -0
  412. package/dist/tools/member-reservation.d.ts.map +1 -0
  413. package/dist/tools/member-reservation.js +71 -0
  414. package/dist/tools/member-reservation.js.map +1 -0
  415. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  416. package/dist/tools/provision-vcs-auth.js +1 -1
  417. package/dist/tools/provision-vcs-auth.js.map +1 -1
  418. package/dist/tools/register-member.d.ts +17 -5
  419. package/dist/tools/register-member.d.ts.map +1 -1
  420. package/dist/tools/register-member.js +144 -5
  421. package/dist/tools/register-member.js.map +1 -1
  422. package/dist/tools/remove-member.d.ts +1 -1
  423. package/dist/tools/report-status.d.ts +33 -0
  424. package/dist/tools/report-status.d.ts.map +1 -0
  425. package/dist/tools/report-status.js +44 -0
  426. package/dist/tools/report-status.js.map +1 -0
  427. package/dist/tools/respond-to-message.d.ts +21 -0
  428. package/dist/tools/respond-to-message.d.ts.map +1 -0
  429. package/dist/tools/respond-to-message.js +23 -0
  430. package/dist/tools/respond-to-message.js.map +1 -0
  431. package/dist/tools/send-files.d.ts +3 -0
  432. package/dist/tools/send-files.d.ts.map +1 -1
  433. package/dist/tools/send-files.js +88 -8
  434. package/dist/tools/send-files.js.map +1 -1
  435. package/dist/tools/send-message.d.ts +27 -0
  436. package/dist/tools/send-message.d.ts.map +1 -0
  437. package/dist/tools/send-message.js +46 -0
  438. package/dist/tools/send-message.js.map +1 -0
  439. package/dist/tools/shutdown-server.d.ts +2 -0
  440. package/dist/tools/shutdown-server.d.ts.map +1 -1
  441. package/dist/tools/shutdown-server.js +19 -0
  442. package/dist/tools/shutdown-server.js.map +1 -1
  443. package/dist/tools/update-member.d.ts +8 -8
  444. package/dist/tools/update-member.d.ts.map +1 -1
  445. package/dist/tools/update-member.js +11 -1
  446. package/dist/tools/update-member.js.map +1 -1
  447. package/dist/types.d.ts +15 -3
  448. package/dist/types.d.ts.map +1 -1
  449. package/dist/utils/agent-helpers.d.ts +2 -1
  450. package/dist/utils/agent-helpers.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.js +7 -2
  452. package/dist/utils/agent-helpers.js.map +1 -1
  453. package/dist/utils/pid-helpers.d.ts +15 -0
  454. package/dist/utils/pid-helpers.d.ts.map +1 -1
  455. package/dist/utils/pid-helpers.js +23 -0
  456. package/dist/utils/pid-helpers.js.map +1 -1
  457. package/dist/utils/process-utils.d.ts +3 -0
  458. package/dist/utils/process-utils.d.ts.map +1 -0
  459. package/dist/utils/process-utils.js +42 -0
  460. package/dist/utils/process-utils.js.map +1 -0
  461. package/dist/utils/prompt-errors.d.ts +2 -1
  462. package/dist/utils/prompt-errors.d.ts.map +1 -1
  463. package/dist/utils/prompt-errors.js +13 -3
  464. package/dist/utils/prompt-errors.js.map +1 -1
  465. package/dist/utils/workspace-trust.d.ts +24 -0
  466. package/dist/utils/workspace-trust.d.ts.map +1 -0
  467. package/dist/utils/workspace-trust.js +35 -0
  468. package/dist/utils/workspace-trust.js.map +1 -0
  469. package/dist/workflows/auto-sprint.js +450 -87
  470. package/package.json +35 -7
  471. package/packages/apra-fleet-client/package.json +26 -0
  472. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  473. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  474. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  475. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  476. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  477. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  478. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  479. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  506. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  507. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  514. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  515. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  516. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  517. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  518. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  519. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  520. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  521. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  525. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  526. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  530. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  531. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  532. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  533. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  534. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  535. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  536. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  542. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  543. package/packages/apra-fleet-se/package.json +28 -0
  544. package/packages/apra-fleet-se/workflow.json +1 -0
  545. package/packages/apra-fleet-workflow/package.json +30 -0
  546. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  547. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  548. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  549. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  550. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  551. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  552. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  553. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  554. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  555. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  556. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  557. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  558. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  559. package/scripts/agy-transcript-reader.js +1 -0
  560. package/scripts/fleet-statusline.sh +17 -13
  561. package/skills/fleet/SKILL.md +37 -2
  562. package/skills/fleet/beads.md +14 -7
  563. package/skills/fleet/permissions.md +50 -0
  564. package/skills/fleet/profiles/base-dev.json +1 -0
  565. package/skills/fleet/profiles/base-reviewer.json +1 -0
  566. package/skills/fleet/profiles/node.json +2 -2
  567. package/version.json +1 -1
  568. package/scripts/agy-settings-merge.js +0 -27
  569. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -3,8 +3,28 @@ import path from 'node:path';
3
3
  import os from 'node:os';
4
4
  import { execSync, execFileSync } from 'node:child_process';
5
5
  import { serverVersion } from '../version.js';
6
+ import { DEFAULT_PORT, LOG_FILE_PATH } from '../paths.js';
7
+ import { getServiceManager } from '../services/service-manager/index.js';
6
8
  import { BIN_DIR, HOOKS_DIR, SCRIPTS_DIR, getProviderInstallConfig, readConfig, writeConfig, writeInstallConfig, PROVIDER_STANDARD_MODELS } from './config.js';
7
- import { transformAgentForOpenCode } from './agent-transform.js';
9
+ import { transformAgentForOpenCode, transformAgentForAgy } from './agent-transform.js';
10
+ import { extractWorkflowSubsystemAssets } from './workflow-assets.js';
11
+ import { downloadAndExtractDolt, verifyDolt } from './dolt-install.js';
12
+ import { classifyRunningServer, getInstallDataDir } from './install-guard.js';
13
+ const realDoltStepDeps = { downloadAndExtractDolt, verifyDolt };
14
+ let doltStepDeps = realDoltStepDeps;
15
+ /** Test-only: inject fakes for the dolt CLI install step's download/verify calls. */
16
+ export function _setDoltStepDeps(overrides) {
17
+ doltStepDeps = { ...realDoltStepDeps, ...overrides };
18
+ }
19
+ /** Test-only: restore the real (non-mocked) dolt step dependencies. */
20
+ export function _resetDoltStepDeps() {
21
+ doltStepDeps = realDoltStepDeps;
22
+ }
23
+ function doltStepEnabled() {
24
+ if (process.env.NODE_ENV !== 'test')
25
+ return true;
26
+ return process.env.APRA_FLEET_ENABLE_DOLT_INSTALL === '1';
27
+ }
8
28
  // Detect SEA mode
9
29
  let _seaOverride = null;
10
30
  /** Override isSea() result -- for tests only. Pass null to restore default. */
@@ -52,21 +72,28 @@ export function isNpmGlobalInstall() {
52
72
  function getSeaAsset(key) {
53
73
  const sea = require('node:sea');
54
74
  const buf = sea.getAsset(key);
55
- // getAsset returns ArrayBuffer — decode to string
75
+ // getAsset returns ArrayBuffer - decode to string
56
76
  return new TextDecoder().decode(buf);
57
77
  }
58
78
  function getSeaAssetBuffer(key) {
59
79
  const sea = require('node:sea');
60
80
  return Buffer.from(sea.getAsset(key));
61
81
  }
62
- // Claude-only helper skill vendored alongside apra-pm's auto-sprint workflow --
82
+ // Claude-only helper skill packaged alongside apra-pm's auto-sprint workflow --
63
83
  // installed into <configDir>/skills/auto-sprint-args, mirrors apra-pm/install.mjs.
64
84
  const AUTO_SPRINT_ARGS_SKILL_NAME = 'auto-sprint-args';
85
+ // Helper skill for the fleet-sprint workflow (`apra-fleet workflow
86
+ // fleet-sprint`), shipped inside the fleet-sprint package itself. NOT provider-
87
+ // specific: installed into <configDir>/skills/fleet-sprint-cli for every LLM
88
+ // provider (every provider's config layout is <configDir>/skills/<name>, same
89
+ // as the pm and fleet skills).
90
+ const FLEET_SPRINT_CLI_SKILL_NAME = 'fleet-sprint-cli';
91
+ const FLEET_SPRINT_CLI_SKILL_VENDOR_BASE = 'packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli';
65
92
  import { fileURLToPath } from 'url';
66
93
  import { dirname } from 'path';
67
94
  const __filename = fileURLToPath(import.meta.url);
68
95
  const __dirname = dirname(__filename);
69
- // Find project root — works for both tsc (dist/cli/install.js) and esbuild (dist/sea-bundle.cjs)
96
+ // Find project root - works for both tsc (dist/cli/install.js) and esbuild (dist/sea-bundle.cjs)
70
97
  function findProjectRoot() {
71
98
  let dir = __dirname;
72
99
  for (let i = 0; i < 5; i++) {
@@ -76,7 +103,7 @@ function findProjectRoot() {
76
103
  }
77
104
  throw new Error('Cannot find project root (version.json not found)');
78
105
  }
79
- // Collect files recursively — used by dev-mode manifest generation
106
+ // Collect files recursively - used by dev-mode manifest generation
80
107
  function collectFilesRec(dir, base, rootBase) {
81
108
  const effectiveRootBase = rootBase ?? base;
82
109
  const results = {};
@@ -94,39 +121,142 @@ function collectFilesRec(dir, base, rootBase) {
94
121
  }
95
122
  return results;
96
123
  }
97
- function buildDevManifest(root) {
124
+ // Directory names excluded (recursively) when collecting a package tree for
125
+ // the workflow-runtime / agent-schemas / built-in-workflow sections -- mirrors
126
+ // scripts/gen-sea-config.mjs's PACKAGE_TREE_EXCLUDE_DIRS.
127
+ const PACKAGE_TREE_EXCLUDE_DIRS = new Set(['test', 'docs', 'scripts', 'examples']);
128
+ /**
129
+ * Resolve a runtime dependency's package directory by walking the node_modules
130
+ * chain upward from `root`, the way Node's own resolver does.
131
+ *
132
+ * Why this exists: gen-sea-config.mjs (the SEA parity source) can assume every
133
+ * runtime dep sits at `root/node_modules/<pkg>` because it always runs from the
134
+ * git/workspace checkout, where nothing is hoisted above the repo root. But
135
+ * buildDevManifest() also runs at `apra-fleet install` time inside a REAL
136
+ * npm-installed tree, where `root` is `node_modules/@apralabs/apra-fleet` and
137
+ * npm HOISTS shared deps (ajv, undici, fast-uri, ...) up to a PARENT
138
+ * node_modules. A fixed `root/node_modules/<pkg>` probe misses every hoisted
139
+ * dep there, so the whole workflow-runtime section fails its existsSync gate and
140
+ * silently drops out -- leaving `apra-fleet workflow fleet-sprint` dead with no
141
+ * error (the exact class of failure tests/install-dev-manifest.test.ts guards).
142
+ * Walking up the chain resolves the dep wherever npm actually placed it; in a
143
+ * dev checkout the first candidate (`root/node_modules/<pkg>`) still wins, so
144
+ * the manifest is byte-identical there. Returns null when the dep is nowhere on
145
+ * the chain.
146
+ */
147
+ function resolveNodeModulesDir(root, pkg) {
148
+ let dir = root;
149
+ for (;;) {
150
+ const candidate = path.join(dir, 'node_modules', pkg);
151
+ if (fs.existsSync(candidate))
152
+ return candidate;
153
+ const parent = path.dirname(dir);
154
+ if (parent === dir)
155
+ return null; // reached filesystem root
156
+ dir = parent;
157
+ }
158
+ }
159
+ // Runtime deps of the workflow subsystem that live under node_modules (as
160
+ // opposed to the first-party packages/ trees). Each tuple is [package name on
161
+ // disk, manifest prefix]; the two coincide today but are kept explicit to
162
+ // mirror gen-sea-config.mjs's collectPackageTree(..., '<prefix>') calls exactly.
163
+ const WORKFLOW_RUNTIME_NODE_MODULES_DEPS = [
164
+ ['ajv', 'ajv'],
165
+ ['fast-deep-equal', 'fast-deep-equal'],
166
+ ['fast-uri', 'fast-uri'],
167
+ ['json-schema-traverse', 'json-schema-traverse'],
168
+ ['require-from-string', 'require-from-string'],
169
+ // undici is a direct runtime dependency of apra-fleet-client's transport
170
+ // (packages/apra-fleet-client/src/client/transport.mjs). undici-types is a
171
+ // types-only peer dependency (no runtime require of it in undici's lib), so
172
+ // it is intentionally not bundled here.
173
+ ['undici', 'undici'],
174
+ ];
175
+ function collectFilesFilteredRec(dir, base, rootBase, excludeDirs) {
176
+ const results = {};
177
+ if (!fs.existsSync(dir))
178
+ return results;
179
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
180
+ if (entry.isDirectory() && excludeDirs.has(entry.name))
181
+ continue;
182
+ const fullPath = path.join(dir, entry.name);
183
+ const relPath = path.join(base, entry.name).replace(/\\/g, '/');
184
+ if (entry.isDirectory()) {
185
+ Object.assign(results, collectFilesFilteredRec(fullPath, relPath, rootBase, excludeDirs));
186
+ }
187
+ else {
188
+ results[path.relative(rootBase, relPath).replace(/\\/g, '/')] = relPath;
189
+ }
190
+ }
191
+ return results;
192
+ }
193
+ /**
194
+ * Collects a package/module tree using its real root-relative path (so values
195
+ * stay valid `join(root, value)` disk paths -- and thus valid dev-mode
196
+ * extractAsset() keys), then re-keys the result under `manifestPrefix` so
197
+ * multiple trees merge into one manifest section without key collisions.
198
+ * Mirrors scripts/gen-sea-config.mjs's collectPackageTree exactly, so the
199
+ * namespaced keys install.ts's workflow-install step consumes are identical
200
+ * in dev mode and SEA mode.
201
+ */
202
+ function collectPackageTree(root, sourceDir, manifestPrefix, excludeDirs = PACKAGE_TREE_EXCLUDE_DIRS) {
203
+ const rootRelBase = path.relative(root, sourceDir).replace(/\\/g, '/');
204
+ const raw = collectFilesFilteredRec(sourceDir, rootRelBase, rootRelBase, excludeDirs);
205
+ const results = {};
206
+ for (const [shortKey, diskPath] of Object.entries(raw)) {
207
+ results[`${manifestPrefix}/${shortKey}`] = diskPath;
208
+ }
209
+ return results;
210
+ }
211
+ // Exported for tests: the dev-mode manifest is what gates the entire workflow
212
+ // subsystem install, and its inputs are filesystem paths that can silently go
213
+ // stale when directories move (see agentSchemasDir below).
214
+ export function buildDevManifest(root) {
98
215
  const hooks = {};
99
216
  for (const entry of fs.readdirSync(path.join(root, 'hooks'))) {
100
217
  hooks[entry] = `hooks/${entry}`;
101
218
  }
102
219
  const scripts = {};
103
- for (const entry of fs.readdirSync(path.join(root, 'scripts'))) {
104
- if (entry.endsWith('.mjs'))
220
+ for (const entry of fs.readdirSync(path.join(root, 'scripts'), { withFileTypes: true })) {
221
+ if (!entry.isFile())
222
+ continue; // skip subdirectories (e.g. agent-doc-partials/)
223
+ if (entry.name.endsWith('.mjs'))
105
224
  continue; // skip build scripts
106
- scripts[entry] = `scripts/${entry}`;
225
+ scripts[entry.name] = `scripts/${entry.name}`;
107
226
  }
108
- // Source PM skills and agents from vendor/apra-pm submodule (dev mode),
109
- // fall back to dist/ for npm global installs where submodule is absent.
110
- const vendorPmSkills = path.join(root, 'vendor', 'apra-pm', 'skills', 'pm');
111
- const vendorAgents = path.join(root, 'vendor', 'apra-pm', 'agents');
227
+ // Source PM skills from apra-pm local package copy (dev mode), fall back to
228
+ // dist/ for npm global installs. Skills have no
229
+ // build-time resolution step, so reading directly is safe.
230
+ const vendorPmSkills = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'skills', 'pm');
112
231
  const pmSkillsDir = fs.existsSync(vendorPmSkills) ? vendorPmSkills : path.join(root, 'dist', 'skills', 'pm');
113
- const agentsDir = fs.existsSync(vendorAgents) ? vendorAgents : path.join(root, 'dist', 'agents');
114
- const pmBase = fs.existsSync(vendorPmSkills) ? 'vendor/apra-pm/skills/pm' : 'dist/skills/pm';
115
- const agentsBase = fs.existsSync(vendorAgents) ? 'vendor/apra-pm/agents' : 'dist/agents';
232
+ const pmBase = fs.existsSync(vendorPmSkills) ? 'packages/apra-fleet-se/apra-pm/skills/pm' : 'dist/skills/pm';
233
+ // Read straight from the local package copy -- same as skills above.
234
+ const agentsDir = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'agents');
235
+ const agentsBase = 'packages/apra-fleet-se/apra-pm/agents';
116
236
  const skills = collectFilesRec(pmSkillsDir, pmBase, pmBase);
117
237
  const agents = collectFilesRec(agentsDir, agentsBase, agentsBase);
118
238
  const fleetSkills = collectFilesRec(path.join(root, 'skills', 'fleet'), 'skills/fleet');
119
- // auto-sprint-args helper skill (vendored alongside apra-pm's auto-sprint workflow;
239
+ // auto-sprint-args helper skill (packaged alongside apra-pm's auto-sprint workflow;
120
240
  // claude-only install target, see the install flow's PM cost/workflow step).
121
- const vendorArgsSkill = path.join(root, 'vendor', 'apra-pm', '.claude', 'skills', 'auto-sprint-args');
241
+ const vendorArgsSkill = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', '.claude', 'skills', 'auto-sprint-args');
122
242
  const distArgsSkill = path.join(root, 'dist', 'skills', 'auto-sprint-args');
123
243
  const argsSkillDir = fs.existsSync(vendorArgsSkill) ? vendorArgsSkill : distArgsSkill;
124
244
  const argsSkillBase = fs.existsSync(vendorArgsSkill)
125
- ? 'vendor/apra-pm/.claude/skills/auto-sprint-args'
245
+ ? 'packages/apra-fleet-se/apra-pm/.claude/skills/auto-sprint-args'
126
246
  : 'dist/skills/auto-sprint-args';
127
247
  const autoSprintArgsSkill = collectFilesRec(argsSkillDir, argsSkillBase, argsSkillBase);
128
- // Collect auto-sprint.js from vendor/apra-pm/.claude/workflows (or dist/workflows fallback)
129
- const vendorWorkflows = path.join(root, 'vendor', 'apra-pm', '.claude', 'workflows');
248
+ // fleet-sprint-cli helper skill (ships inside the fleet-sprint package;
249
+ // documents the `apra-fleet workflow fleet-sprint` CLI flag contract).
250
+ // Provider-agnostic -- installed for every LLM provider.
251
+ const vendorCliSkill = path.join(root, ...FLEET_SPRINT_CLI_SKILL_VENDOR_BASE.split('/'));
252
+ const distCliSkill = path.join(root, 'dist', 'skills', FLEET_SPRINT_CLI_SKILL_NAME);
253
+ const cliSkillDir = fs.existsSync(vendorCliSkill) ? vendorCliSkill : distCliSkill;
254
+ const cliSkillBase = fs.existsSync(vendorCliSkill)
255
+ ? FLEET_SPRINT_CLI_SKILL_VENDOR_BASE
256
+ : `dist/skills/${FLEET_SPRINT_CLI_SKILL_NAME}`;
257
+ const fleetSprintCliSkill = collectFilesRec(cliSkillDir, cliSkillBase, cliSkillBase);
258
+ // Collect auto-sprint.js from apra-pm/.claude/workflows (or dist/workflows fallback)
259
+ const vendorWorkflows = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', '.claude', 'workflows');
130
260
  const workflowsSrc = fs.existsSync(vendorWorkflows)
131
261
  ? vendorWorkflows
132
262
  : path.join(root, 'dist', 'workflows');
@@ -138,12 +268,61 @@ function buildDevManifest(root) {
138
268
  }
139
269
  }
140
270
  }
271
+ // Workflow subsystem parity (mirrors scripts/gen-sea-config.mjs) so `node
272
+ // dist/index.js install` behaves identically to the SEA binary. Each source
273
+ // tree is optional -- an npm global install missing any piece simply omits
274
+ // the section, same as an older SEA manifest built before this epic; the
275
+ // install step warns and skips. The first-party packages/ trees resolve
276
+ // relative to root (shipped inside the tarball by the files allowlist); the
277
+ // node_modules runtime deps resolve via resolveNodeModulesDir() so a real
278
+ // npm-installed tree (which hoists them above root) still finds them.
279
+ const workflowRuntimeDir = path.join(root, 'packages', 'apra-fleet-workflow');
280
+ const clientDir = path.join(root, 'packages', 'apra-fleet-client');
281
+ const resolvedRuntimeDeps = WORKFLOW_RUNTIME_NODE_MODULES_DEPS.map(([pkg, prefix]) => [prefix, resolveNodeModulesDir(root, pkg)]);
282
+ const allRuntimeDepsResolved = resolvedRuntimeDeps.every(([, dir]) => dir !== null);
283
+ let workflowRuntime;
284
+ if (fs.existsSync(workflowRuntimeDir) && fs.existsSync(clientDir) && allRuntimeDepsResolved) {
285
+ workflowRuntime = {
286
+ ...collectPackageTree(root, workflowRuntimeDir, '@apralabs/apra-fleet-workflow'),
287
+ ...collectPackageTree(root, clientDir, '@apralabs/apra-fleet-client'),
288
+ };
289
+ for (const [prefix, dir] of resolvedRuntimeDeps) {
290
+ Object.assign(workflowRuntime, collectPackageTree(root, dir, prefix));
291
+ }
292
+ }
293
+ const agentSchemasDir = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'agents', 'schemas');
294
+ let agentSchemas;
295
+ if (fs.existsSync(agentSchemasDir)) {
296
+ agentSchemas = collectPackageTree(root, agentSchemasDir, 'agentSchemas');
297
+ }
298
+ const fleetSprintDir = path.join(root, 'packages', 'apra-fleet-se');
299
+ const helloWorldDir = path.join(root, 'examples', 'workflows', 'hello-world');
300
+ let builtinWorkflows;
301
+ if (fs.existsSync(fleetSprintDir) || fs.existsSync(helloWorldDir)) {
302
+ builtinWorkflows = {
303
+ ...(fs.existsSync(fleetSprintDir) ? collectPackageTree(root, fleetSprintDir, 'fleet-sprint') : {}),
304
+ ...(fs.existsSync(helloWorldDir) ? collectPackageTree(root, helloWorldDir, 'hello-world') : {}),
305
+ };
306
+ }
141
307
  const vf = JSON.parse(fs.readFileSync(path.join(root, 'version.json'), 'utf-8'));
142
- return { version: vf.version, hooks, scripts, skills, fleetSkills, agents, workflows, autoSprintArgsSkill };
308
+ return {
309
+ version: vf.version, hooks, scripts, skills, fleetSkills, agents, workflows,
310
+ workflowRuntime, agentSchemas, builtinWorkflows, autoSprintArgsSkill,
311
+ fleetSprintCliSkill,
312
+ };
143
313
  }
144
314
  let _manifestOverride = null;
145
- /** Inject a manifest for tests — avoids SEA asset extraction. Pass null to restore default. */
315
+ /** Inject a manifest for tests - avoids SEA asset extraction. Pass null to restore default. */
146
316
  export function _setManifestOverride(m) { _manifestOverride = m; }
317
+ /**
318
+ * Test-only escape hatch to exercise the real buildDevManifest() (against the
319
+ * real filesystem, not the mocked node:fs used elsewhere in
320
+ * tests/install-workflows.test.ts) so regressions like apra-fleet-eft.19
321
+ * (dev-mode install omitting undici from the workflowRuntime bundle) are
322
+ * caught by a direct assertion on the generated manifest, not just on the
323
+ * mocked-fs runInstall() flow.
324
+ */
325
+ export function _buildDevManifestForTest(root) { return buildDevManifest(root); }
147
326
  function loadManifest() {
148
327
  if (_manifestOverride !== null)
149
328
  return _manifestOverride;
@@ -168,9 +347,9 @@ export function loadAgentAssets() {
168
347
  return results;
169
348
  }
170
349
  const root = findProjectRoot();
171
- const vendorAgents = path.join(root, 'vendor', 'apra-pm', 'agents');
350
+ const vendorAgents = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'agents');
172
351
  const agentsSrc = fs.existsSync(vendorAgents) ? vendorAgents : path.join(root, 'dist', 'agents');
173
- const agentsBase = fs.existsSync(vendorAgents) ? 'vendor/apra-pm/agents' : 'dist/agents';
352
+ const agentsBase = fs.existsSync(vendorAgents) ? 'packages/apra-fleet-se/apra-pm/agents' : 'dist/agents';
174
353
  const collected = collectFilesRec(agentsSrc, agentsBase, agentsBase);
175
354
  for (const [relPath, rootRelativeLabel] of Object.entries(collected)) {
176
355
  results.push({ relPath, content: fs.readFileSync(path.join(root, rootRelativeLabel), 'utf-8') });
@@ -303,10 +482,23 @@ function mergePermissions(paths, extraPerms = []) {
303
482
  }
304
483
  writeConfig(paths, settings);
305
484
  }
306
- function configureStatusline(paths, scriptPath) {
485
+ function configureStatusline(paths, scriptPath, llm) {
307
486
  const settings = readConfig(paths);
308
- // Windows: Claude Code can't execute .sh directly — prefix with bash
309
- const command = process.platform === 'win32' ? `bash "${scriptPath}"` : scriptPath;
487
+ let command;
488
+ if (process.platform === 'win32') {
489
+ if (llm === 'agy') {
490
+ const gitBash = 'C:\\Program Files\\Git\\bin\\bash.exe';
491
+ const bashBin = fs.existsSync(gitBash) ? `"${gitBash}"` : 'bash';
492
+ const formattedScriptPath = scriptPath.replace(/\\/g, '/');
493
+ command = `${bashBin} "${formattedScriptPath}"`;
494
+ }
495
+ else {
496
+ command = `bash "${scriptPath}"`;
497
+ }
498
+ }
499
+ else {
500
+ command = scriptPath;
501
+ }
310
502
  settings.statusLine = {
311
503
  type: 'command',
312
504
  command,
@@ -353,20 +545,27 @@ function mergeCopilotConfig(paths, mcpConfig) {
353
545
  function mergeOpenCodeConfig(paths, mcpConfig) {
354
546
  const settings = readConfig(paths);
355
547
  settings.mcp = settings.mcp || {};
356
- settings.mcp['apra-fleet'] = {
357
- type: 'local',
358
- command: [mcpConfig.command, ...(mcpConfig.args || [])],
359
- enabled: true,
360
- };
548
+ settings.mcp['apra-fleet'] = mcpConfig.url
549
+ ? { type: 'remote', url: mcpConfig.url, enabled: true }
550
+ : {
551
+ type: 'local',
552
+ command: [mcpConfig.command, ...(mcpConfig.args || [])],
553
+ enabled: true,
554
+ };
361
555
  writeConfig(paths, settings);
362
556
  }
363
557
  function mergeCodexConfig(paths, mcpConfig) {
364
558
  const settings = readConfig(paths);
365
559
  settings.mcp_servers = settings.mcp_servers || {};
366
- settings.mcp_servers['apra-fleet'] = {
367
- command: mcpConfig.command.replace(/\\/g, '/'),
368
- args: mcpConfig.args.map((a) => a.replace(/\\/g, '/')),
369
- };
560
+ if (mcpConfig.url) {
561
+ settings.mcp_servers['apra-fleet'] = { url: mcpConfig.url };
562
+ }
563
+ else {
564
+ settings.mcp_servers['apra-fleet'] = {
565
+ command: mcpConfig.command.replace(/\\/g, '/'),
566
+ args: mcpConfig.args.map((a) => a.replace(/\\/g, '/')),
567
+ };
568
+ }
370
569
  writeConfig(paths, settings);
371
570
  }
372
571
  function run(cmd, opts) {
@@ -374,12 +573,25 @@ function run(cmd, opts) {
374
573
  const shellOpt = process.platform === 'win32' ? { shell: 'cmd.exe' } : {};
375
574
  execSync(cmd, { stdio: 'inherit', ...shellOpt, ...opts });
376
575
  }
576
+ /** Is `cmd` resolvable on PATH? Used before shelling out to a provider's own
577
+ * CLI (e.g. `claude`) so a missing binary degrades to a clear warning
578
+ * instead of install crashing with a raw "Command failed" error. */
579
+ function isCommandAvailable(cmd) {
580
+ try {
581
+ const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
582
+ execSync(checkCmd, { stdio: 'ignore' });
583
+ return true;
584
+ }
585
+ catch {
586
+ return false;
587
+ }
588
+ }
377
589
  export function isApraFleetRunning() {
378
590
  try {
379
591
  if (process.platform === 'win32') {
380
592
  const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe' });
381
593
  const currentPid = process.pid.toString();
382
- // Each CSV line: "apra-fleet.exe","<PID>","..." — exclude the current installer process
594
+ // Each CSV line: "apra-fleet.exe","<PID>","..." - exclude the current installer process
383
595
  return out.split('\n').some(line => {
384
596
  const match = line.match(/"apra-fleet\.exe","(\d+)"/);
385
597
  return match !== null && match[1] !== currentPid;
@@ -397,13 +609,57 @@ export function isApraFleetRunning() {
397
609
  return false;
398
610
  }
399
611
  }
400
- export function killApraFleet() {
612
+ export function killApraFleet(signal = 'SIGTERM') {
401
613
  if (process.platform === 'win32') {
614
+ // taskkill /F is already forceful -- no softer signal to escalate from,
615
+ // so SIGKILL escalation on Windows just reissues the same command.
402
616
  execSync('taskkill /F /IM apra-fleet.exe', { stdio: 'ignore' });
403
617
  }
404
618
  else {
405
619
  // -x = exact name match
406
- execSync('pkill -x apra-fleet', { stdio: 'ignore' });
620
+ const cmd = signal === 'SIGKILL' ? 'pkill -9 -x apra-fleet' : 'pkill -x apra-fleet';
621
+ execSync(cmd, { stdio: 'ignore' });
622
+ }
623
+ }
624
+ const PROD_INSTALL_FORCE_TIMING = { pollIntervalMs: 200, graceMs: 3000, killGraceMs: 2000 };
625
+ // Tests run with NODE_ENV=test (see tests/setup.ts) and don't fake these timers,
626
+ // so default to a much shorter window there to keep the suite fast, unless a
627
+ // test explicitly overrides via _setInstallForceTimingOverride() to exercise
628
+ // the escalation path directly.
629
+ const TEST_INSTALL_FORCE_TIMING = { pollIntervalMs: 2, graceMs: 20, killGraceMs: 20 };
630
+ let _installForceTimingOverride = null;
631
+ /** Test-only: override the poll/grace timing used by waitForApraFleetToStop(). Pass null to restore default. */
632
+ export function _setInstallForceTimingOverride(t) {
633
+ _installForceTimingOverride = t;
634
+ }
635
+ function installForceTiming() {
636
+ if (_installForceTimingOverride)
637
+ return _installForceTimingOverride;
638
+ return process.env.NODE_ENV === 'test' ? TEST_INSTALL_FORCE_TIMING : PROD_INSTALL_FORCE_TIMING;
639
+ }
640
+ /**
641
+ * Wait for any non-installer apra-fleet process to exit after killApraFleet()
642
+ * sends SIGTERM. Polls isApraFleetRunning() over a grace window; if the
643
+ * process is still alive once the window elapses, escalates to SIGKILL and
644
+ * polls again over a second (shorter) window. Returns as soon as no
645
+ * non-installer apra-fleet process is detected, or once both windows have
646
+ * elapsed -- callers should not assume termination is guaranteed in the
647
+ * latter case (see apra-fleet-l7n.3 for surfacing that failure to the
648
+ * operator instead of asserting success).
649
+ */
650
+ export async function waitForApraFleetToStop() {
651
+ const { pollIntervalMs, graceMs, killGraceMs } = installForceTiming();
652
+ let deadline = Date.now() + graceMs;
653
+ while (isApraFleetRunning() && Date.now() < deadline) {
654
+ await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
655
+ }
656
+ if (!isApraFleetRunning())
657
+ return;
658
+ // Grace window elapsed and a non-installer apra-fleet process is still alive -- escalate.
659
+ killApraFleet('SIGKILL');
660
+ deadline = Date.now() + killGraceMs;
661
+ while (isApraFleetRunning() && Date.now() < deadline) {
662
+ await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
407
663
  }
408
664
  }
409
665
  /**
@@ -426,7 +682,7 @@ export function writeAgyWorkspaceOverlays(workFolder) {
426
682
  }
427
683
  }
428
684
  export async function runInstall(args) {
429
- // --help / -h guard — must come first, before any side effects (#142)
685
+ // --help / -h guard - must come first, before any side effects (#142)
430
686
  if (args.includes('--help') || args.includes('-h')) {
431
687
  console.log(`apra-fleet install
432
688
 
@@ -436,20 +692,28 @@ Usage:
436
692
  apra-fleet install Install binary + hooks + statusline + MCP + fleet & PM skills (default)
437
693
  apra-fleet install --skill all Same as bare install (all skills)
438
694
  apra-fleet install --skill fleet Install fleet skill only
439
- apra-fleet install --skill pm Install PM skill (also installs fleet — PM depends on fleet)
695
+ apra-fleet install --skill pm Install PM skill (also installs fleet -- PM depends on fleet)
440
696
  apra-fleet install --skill none Skip skill installation
441
697
  apra-fleet install --no-skill Same as --skill none
698
+ apra-fleet install --workflows none Skip installing the workflow runtime + built-in workflows
442
699
  apra-fleet install --force Stop a running server before installing
443
700
  apra-fleet install --llm <provider> Target LLM provider: claude (default), gemini, codex, copilot, agy, opencode
701
+ apra-fleet install --transport http Register MCP server with HTTP transport (default)
702
+ apra-fleet install --transport stdio Register MCP server with stdio transport (legacy)
444
703
  apra-fleet install --help Show this help
445
704
 
446
705
  Options:
447
706
  --llm <provider> LLM provider to configure. Supported: claude, gemini, codex, copilot, agy, opencode.
448
707
  Defaults to claude. Note: --llm gemini shows a warning about sequential
449
- dispatch — Gemini does not support background agents, so fleet operations
708
+ dispatch -- Gemini does not support background agents, so fleet operations
450
709
  run sequentially rather than in parallel.
710
+ --transport <mode> MCP transport to use: http (default) or stdio. HTTP uses the singleton
711
+ fleet server at http://localhost:7523/mcp. stdio runs fleet as a subprocess.
451
712
  --skill <mode> Which skills to install: all (default), fleet, pm, or none.
452
713
  --no-skill Alias for --skill none.
714
+ --workflows <mode> Which workflow assets to install: all (default) or none. Installs
715
+ ~/.apra-fleet/node_modules (workflow runtime), /schemas (agent role
716
+ schemas), and /workflows/{fleet-sprint,hello-world} (built-in workflows).
453
717
  --force Stop a running apra-fleet server before installing (SEA mode only).`);
454
718
  process.exit(0);
455
719
  return;
@@ -492,7 +756,7 @@ Options:
492
756
  skillMode = nextArg;
493
757
  }
494
758
  else {
495
- // --skill with no value → install both (backwards-compat)
759
+ // --skill with no value - install both (backwards-compat)
496
760
  skillMode = 'all';
497
761
  }
498
762
  }
@@ -501,11 +765,61 @@ Options:
501
765
  if (args.includes('--no-skill')) {
502
766
  skillMode = 'none';
503
767
  }
768
+ let workflowsMode = 'all';
769
+ const workflowsEqualArg = args.find(a => a.startsWith('--workflows='));
770
+ if (workflowsEqualArg) {
771
+ const val = workflowsEqualArg.split('=')[1];
772
+ if (val === 'all' || val === 'none') {
773
+ workflowsMode = val;
774
+ }
775
+ else {
776
+ console.error(`Error: --workflows value must be one of: all, none (got "${val}")`);
777
+ process.exit(1);
778
+ }
779
+ }
780
+ else {
781
+ const workflowsIdx = args.indexOf('--workflows');
782
+ if (workflowsIdx >= 0) {
783
+ const nextArg = args[workflowsIdx + 1];
784
+ if (nextArg === 'all' || nextArg === 'none') {
785
+ workflowsMode = nextArg;
786
+ }
787
+ else {
788
+ console.error(`Error: --workflows requires a value: all or none.`);
789
+ process.exit(1);
790
+ }
791
+ }
792
+ }
504
793
  // Parse --force flag
505
794
  const force = args.includes('--force');
795
+ let transport = 'http';
796
+ const transportEqualArg = args.find(a => a.startsWith('--transport='));
797
+ if (transportEqualArg) {
798
+ const val = transportEqualArg.split('=')[1];
799
+ if (val === 'http' || val === 'stdio') {
800
+ transport = val;
801
+ }
802
+ else {
803
+ console.error(`Error: --transport value must be one of: http, stdio (got "${val}")`);
804
+ process.exit(1);
805
+ }
806
+ }
807
+ else {
808
+ const transportIdx = args.indexOf('--transport');
809
+ if (transportIdx >= 0 && transportIdx < args.length - 1) {
810
+ const val = args[transportIdx + 1];
811
+ if (val === 'http' || val === 'stdio') {
812
+ transport = val;
813
+ }
814
+ else {
815
+ console.error(`Error: --transport value must be one of: http, stdio (got "${val}")`);
816
+ process.exit(1);
817
+ }
818
+ }
819
+ }
506
820
  // Reject unknown flags to catch typos early
507
- const knownFlagPrefixes = ['--llm=', '--skill='];
508
- const knownFlagExact = new Set(['--llm', '--skill', '--no-skill', '--force', '--help', '-h']);
821
+ const knownFlagPrefixes = ['--llm=', '--skill=', '--transport=', '--workflows='];
822
+ const knownFlagExact = new Set(['--llm', '--skill', '--no-skill', '--workflows', '--force', '--transport', '--help', '-h']);
509
823
  for (const a of args) {
510
824
  if (knownFlagExact.has(a))
511
825
  continue;
@@ -519,22 +833,44 @@ Options:
519
833
  const installFleet = skillMode === 'fleet' || skillMode === 'pm' || skillMode === 'all';
520
834
  const installPm = skillMode === 'pm' || skillMode === 'all';
521
835
  const installAgents = installPm && paths.agentsDir !== undefined;
836
+ const installWorkflows = workflowsMode === 'all';
837
+ const serviceStep = isSea() && transport === 'http';
522
838
  let totalSteps = (installFleet && installPm) ? 8 : installFleet ? 7 : installPm ? 8 : 6;
523
839
  if (installAgents)
524
840
  totalSteps++;
525
841
  if (installPm)
526
842
  totalSteps++; // cost.js extraction + workflow copy step
843
+ if (installWorkflows)
844
+ totalSteps++; // workflow-subsystem runtime/schemas/built-ins step
845
+ totalSteps++; // dolt CLI install step (apra-fleet-ire.3) -- unconditional, mirrors Beads step
846
+ if (serviceStep)
847
+ totalSteps++;
527
848
  if (llm === 'gemini' && (installFleet || installPm)) {
528
- console.warn(`\n⚠ Note: Gemini does not support background agents. If you plan to use Gemini as the\n PM/orchestrator, fleet operations will run sequentially (no parallel dispatch).\n For best orchestration performance, consider using Claude. See docs for details.\n`);
849
+ console.warn(`\n- Note: Gemini does not support background agents. If you plan to use Gemini as the\n PM/orchestrator, fleet operations will run sequentially (no parallel dispatch).\n For best orchestration performance, consider using Claude. See docs for details.\n`);
529
850
  }
530
851
  // --- Running-process guard (SEA + npm modes -- dev mode runs via node, not a managed binary) ---
531
- if ((isSea() || isNpmGlobalInstall()) && isApraFleetRunning()) {
852
+ //
853
+ // isApraFleetRunning() is OS-global on purpose (waitForApraFleetToStop() and
854
+ // uninstall.ts depend on that). It is only the cheap first filter here:
855
+ // classifyRunningServer() then decides whether the running server is actually
856
+ // relevant to THIS install -- recorded live in the target data dir, or running
857
+ // from the install prefix we are about to overwrite (ETXTBSY). An unrelated
858
+ // server (isolated HOME/APRA_FLEET_DATA_DIR/prefix, e.g. ci.yml's clean temp
859
+ // prefix step) no longer blocks the install. See apra-fleet-1aw.
860
+ const runningScope = (isSea() || isNpmGlobalInstall()) && isApraFleetRunning()
861
+ ? classifyRunningServer(BIN_DIR)
862
+ : null;
863
+ if (runningScope && !runningScope.relevant) {
864
+ 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`);
865
+ }
866
+ if (runningScope?.relevant) {
532
867
  if (!force) {
533
868
  const killHint = process.platform === 'win32'
534
869
  ? ' taskkill /F /IM apra-fleet.exe'
535
870
  : ' pkill -x apra-fleet';
536
871
  console.error(`
537
872
  Error: apra-fleet is currently running. Stop the server before installing.
873
+ (${runningScope.detail})
538
874
 
539
875
  Run with --force to stop it automatically:
540
876
  apra-fleet install --force
@@ -545,7 +881,15 @@ ${killHint}
545
881
  process.exit(1);
546
882
  }
547
883
  killApraFleet();
548
- await new Promise(resolve => setTimeout(resolve, 500));
884
+ await waitForApraFleetToStop();
885
+ if (isApraFleetRunning()) {
886
+ console.error(`
887
+ Error: could not stop the running apra-fleet server (it is still running after
888
+ SIGTERM and a SIGKILL escalation). Stop it manually before installing:
889
+ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pkill -x apra-fleet'}
890
+ `);
891
+ process.exit(1);
892
+ }
549
893
  console.log(' Stopped running server.');
550
894
  }
551
895
  console.log(`\nInstalling Apra Fleet ${serverVersion} for ${paths.name}...\n`);
@@ -596,49 +940,93 @@ ${killHint}
596
940
  const installedHooksConfig = JSON.parse(fs.readFileSync(path.join(HOOKS_DIR, 'hooks-config.json'), 'utf-8'));
597
941
  mergeHooksConfig(paths, installedHooksConfig, llm);
598
942
  const statuslineScript = path.join(SCRIPTS_DIR, 'fleet-statusline.sh');
599
- configureStatusline(paths, statuslineScript);
943
+ configureStatusline(paths, statuslineScript, llm);
600
944
  const standardModel = PROVIDER_STANDARD_MODELS[llm] ?? PROVIDER_STANDARD_MODELS['claude'];
601
945
  writeDefaultModel(paths, standardModel);
602
946
  }
603
947
  // --- Step 5: Register MCP server ---
604
948
  console.log(` [5/${totalSteps}] Registering MCP server...`);
605
- // 'run' is the subcommand that starts the MCP server; it is passed as the last arg so
606
- // LLM providers invoke `apra-fleet run` (or `node dist/index.js run`) and the no-arg
607
- // default (installation) is never accidentally triggered by the MCP host.
608
- const mcpConfig = isSea()
609
- ? { command: binaryPath, args: ['run'] }
610
- : isNpmGlobalInstall()
611
- ? { command: process.execPath, args: [process.argv[1], 'run'] }
612
- : { command: 'node', args: [path.join(findProjectRoot(), 'dist', 'index.js'), 'run'] };
613
- if (llm === 'claude') {
614
- try {
615
- run('claude mcp remove apra-fleet --scope user', { stdio: 'ignore' });
949
+ const fleetPort = DEFAULT_PORT;
950
+ const fleetUrl = `http://localhost:${fleetPort}/mcp`;
951
+ if (transport === 'http') {
952
+ if (llm === 'claude') {
953
+ if (!isCommandAvailable('claude')) {
954
+ console.warn(` Warning: the 'claude' CLI was not found on PATH -- skipping MCP server registration.\n` +
955
+ ` Install Claude Code (https://claude.com/claude-code), then re-run 'apra-fleet install'\n` +
956
+ ` to register apra-fleet with it, or register manually with:\n` +
957
+ ` claude mcp add --scope user --transport http apra-fleet ${fleetUrl}`);
958
+ }
959
+ else {
960
+ try {
961
+ run('claude mcp remove apra-fleet --scope user', { stdio: 'ignore' });
962
+ }
963
+ catch { /* not registered */ }
964
+ run(`claude mcp add --scope user --transport http apra-fleet ${fleetUrl}`);
965
+ }
966
+ }
967
+ else if (llm === 'gemini') {
968
+ mergeGeminiConfig(paths, { httpUrl: fleetUrl });
969
+ }
970
+ else if (llm === 'codex') {
971
+ mergeCodexConfig(paths, { url: fleetUrl });
972
+ }
973
+ else if (llm === 'copilot') {
974
+ mergeCopilotConfig(paths, { url: fleetUrl, type: 'http' });
975
+ }
976
+ else if (llm === 'agy') {
977
+ mergeAgyConfig(paths, { url: fleetUrl });
978
+ }
979
+ else if (llm === 'opencode') {
980
+ mergeOpenCodeConfig(paths, { url: fleetUrl });
616
981
  }
617
- catch { /* not registered */ }
618
- // Build the claude MCP command from the actual mcpConfig structure.
619
- // All args are quoted and joined so paths with spaces (e.g. Windows "Program Files") work.
620
- const quotedArgs = mcpConfig.args.map((a) => `"${a.replace(/"/g, '\\"')}"`).join(' ');
621
- const cmd = `claude mcp add --scope user apra-fleet -- "${mcpConfig.command}" ${quotedArgs}`;
622
- run(cmd);
623
- }
624
- else if (llm === 'gemini') {
625
- mergeGeminiConfig(paths, mcpConfig);
626
- }
627
- else if (llm === 'codex') {
628
- mergeCodexConfig(paths, mcpConfig);
629
- }
630
- else if (llm === 'copilot') {
631
- mergeCopilotConfig(paths, mcpConfig);
632
- }
633
- else if (llm === 'agy') {
634
- mergeAgyConfig(paths, mcpConfig);
635
982
  }
636
- else if (llm === 'opencode') {
637
- mergeOpenCodeConfig(paths, mcpConfig);
983
+ else {
984
+ // 'run --transport stdio' starts the stdio MCP server; passed as trailing args so
985
+ // LLM providers invoke `apra-fleet run` (or `node dist/index.js run`) and the no-arg
986
+ // default (installation) is never accidentally triggered by the MCP host.
987
+ const mcpConfig = isSea()
988
+ ? { command: binaryPath, args: ['run', '--transport', 'stdio'] }
989
+ : isNpmGlobalInstall()
990
+ ? { command: process.execPath, args: [process.argv[1], 'run', '--transport', 'stdio'] }
991
+ : { command: 'node', args: [path.join(findProjectRoot(), 'dist', 'index.js'), 'run', '--transport', 'stdio'] };
992
+ if (llm === 'claude') {
993
+ // Build the claude MCP command from the actual mcpConfig structure.
994
+ // All args are quoted and joined so paths with spaces (e.g. Windows "Program Files") work.
995
+ const quotedArgs = mcpConfig.args.map((a) => `"${a.replace(/"/g, '\\"')}"`).join(' ');
996
+ const cmd = `claude mcp add --scope user apra-fleet -- "${mcpConfig.command}" ${quotedArgs}`;
997
+ if (!isCommandAvailable('claude')) {
998
+ console.warn(` Warning: the 'claude' CLI was not found on PATH -- skipping MCP server registration.\n` +
999
+ ` Install Claude Code (https://claude.com/claude-code), then re-run 'apra-fleet install'\n` +
1000
+ ` to register apra-fleet with it, or register manually with:\n` +
1001
+ ` ${cmd}`);
1002
+ }
1003
+ else {
1004
+ try {
1005
+ run('claude mcp remove apra-fleet --scope user', { stdio: 'ignore' });
1006
+ }
1007
+ catch { /* not registered */ }
1008
+ run(cmd);
1009
+ }
1010
+ }
1011
+ else if (llm === 'gemini') {
1012
+ mergeGeminiConfig(paths, mcpConfig);
1013
+ }
1014
+ else if (llm === 'codex') {
1015
+ mergeCodexConfig(paths, mcpConfig);
1016
+ }
1017
+ else if (llm === 'copilot') {
1018
+ mergeCopilotConfig(paths, mcpConfig);
1019
+ }
1020
+ else if (llm === 'agy') {
1021
+ mergeAgyConfig(paths, mcpConfig);
1022
+ }
1023
+ else if (llm === 'opencode') {
1024
+ mergeOpenCodeConfig(paths, mcpConfig);
1025
+ }
638
1026
  }
639
1027
  // --- Step 6: Install fleet skill (optional) ---
640
1028
  if (skillMode === 'pm') {
641
- console.warn(`\n⚠ Note: PM skill depends on fleet skill — installing fleet skill first.\n`);
1029
+ console.warn(`\n- Note: PM skill depends on fleet skill - installing fleet skill first.\n`);
642
1030
  }
643
1031
  if (installFleet) {
644
1032
  console.log(` [6/${totalSteps}] Installing fleet skill...`);
@@ -657,20 +1045,6 @@ ${killHint}
657
1045
  }
658
1046
  }
659
1047
  // --- Step 7: Install PM skill (optional) ---
660
- // Empty-submodule guard: vendor/apra-pm dir exists but was not initialized
661
- if (installPm && !isSea()) {
662
- const root = findProjectRoot();
663
- const vendorDir = path.join(root, 'vendor', 'apra-pm');
664
- if (fs.existsSync(vendorDir)) {
665
- const skillMarker = path.join(vendorDir, 'skills', 'pm', 'SKILL.md');
666
- if (!fs.existsSync(skillMarker)) {
667
- console.error(`Error: vendor/apra-pm exists but appears empty (non-recursive clone).
668
- Run: git submodule update --init --recursive
669
- Then re-run: apra-fleet install`);
670
- process.exit(1);
671
- }
672
- }
673
- }
674
1048
  if (installPm) {
675
1049
  console.log(` [7/${totalSteps}] Installing PM skill...`);
676
1050
  clearDirSync(paths.skillsDir);
@@ -682,9 +1056,9 @@ Then re-run: apra-fleet install`);
682
1056
  }
683
1057
  }
684
1058
  else {
685
- // Dev/npm mode: prefer vendor/apra-pm submodule, fall back to dist/
1059
+ // Dev/npm mode: prefer apra-pm local copy, fall back to dist/
686
1060
  const root = findProjectRoot();
687
- const vendorPm = path.join(root, 'vendor', 'apra-pm', 'skills', 'pm');
1061
+ const vendorPm = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'skills', 'pm');
688
1062
  const pmSrc = fs.existsSync(vendorPm) ? vendorPm : path.join(root, 'dist', 'skills', 'pm');
689
1063
  copyDirSync(pmSrc, paths.skillsDir);
690
1064
  }
@@ -702,7 +1076,7 @@ Then re-run: apra-fleet install`);
702
1076
  }
703
1077
  else {
704
1078
  const root = findProjectRoot();
705
- const wfPath = path.join(root, 'vendor', 'apra-pm', '.claude', 'workflows', 'auto-sprint.js');
1079
+ const wfPath = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', '.claude', 'workflows', 'auto-sprint.js');
706
1080
  const wfFallback = path.join(root, 'dist', 'workflows', 'auto-sprint.js');
707
1081
  const wfSrc = fs.existsSync(wfPath) ? wfPath : fs.existsSync(wfFallback) ? wfFallback : null;
708
1082
  if (wfSrc)
@@ -761,11 +1135,11 @@ Then re-run: apra-fleet install`);
761
1135
  }))
762
1136
  : (() => {
763
1137
  const root = findProjectRoot();
764
- const vendorArgsSkill = path.join(root, 'vendor', 'apra-pm', '.claude', 'skills', AUTO_SPRINT_ARGS_SKILL_NAME);
1138
+ const vendorArgsSkill = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', '.claude', 'skills', AUTO_SPRINT_ARGS_SKILL_NAME);
765
1139
  const distArgsSkill = path.join(root, 'dist', 'skills', AUTO_SPRINT_ARGS_SKILL_NAME);
766
1140
  const argsSkillSrc = fs.existsSync(vendorArgsSkill) ? vendorArgsSkill : distArgsSkill;
767
1141
  const argsSkillBase = fs.existsSync(vendorArgsSkill)
768
- ? `vendor/apra-pm/.claude/skills/${AUTO_SPRINT_ARGS_SKILL_NAME}`
1142
+ ? `packages/apra-fleet-se/apra-pm/.claude/skills/${AUTO_SPRINT_ARGS_SKILL_NAME}`
769
1143
  : `dist/skills/${AUTO_SPRINT_ARGS_SKILL_NAME}`;
770
1144
  const collected = collectFilesRec(argsSkillSrc, argsSkillBase, argsSkillBase);
771
1145
  return Object.entries(collected).map(([relPath, rootRelativeLabel]) => ({
@@ -784,6 +1158,42 @@ Then re-run: apra-fleet install`);
784
1158
  }
785
1159
  }
786
1160
  }
1161
+ // --- fleet-sprint-cli helper skill (all providers) ---
1162
+ // Documents the `apra-fleet workflow fleet-sprint` CLI contract for any LLM
1163
+ // driving apra-fleet. Deliberately NOT gated on provider (every provider gets
1164
+ // it) and NOT gated on installPm (fleet-sprint ships independently of the PM
1165
+ // skill) -- only on "skills are being installed at all".
1166
+ if (installFleet || installPm) {
1167
+ const cliSkillDest = path.join(paths.configDir, 'skills', FLEET_SPRINT_CLI_SKILL_NAME);
1168
+ const cliSkillEntries = isSea()
1169
+ ? Object.entries(manifest.fleetSprintCliSkill ?? {}).map(([relPath, assetKey]) => ({
1170
+ relPath,
1171
+ content: extractAsset(assetKey),
1172
+ }))
1173
+ : (() => {
1174
+ const root = findProjectRoot();
1175
+ const vendorCliSkill = path.join(root, ...FLEET_SPRINT_CLI_SKILL_VENDOR_BASE.split('/'));
1176
+ const distCliSkill = path.join(root, 'dist', 'skills', FLEET_SPRINT_CLI_SKILL_NAME);
1177
+ const cliSkillSrc = fs.existsSync(vendorCliSkill) ? vendorCliSkill : distCliSkill;
1178
+ const cliSkillBase = fs.existsSync(vendorCliSkill)
1179
+ ? FLEET_SPRINT_CLI_SKILL_VENDOR_BASE
1180
+ : `dist/skills/${FLEET_SPRINT_CLI_SKILL_NAME}`;
1181
+ const collected = collectFilesRec(cliSkillSrc, cliSkillBase, cliSkillBase);
1182
+ return Object.entries(collected).map(([relPath, rootRelativeLabel]) => ({
1183
+ relPath,
1184
+ content: fs.readFileSync(path.join(root, rootRelativeLabel), 'utf-8'),
1185
+ }));
1186
+ })();
1187
+ if (cliSkillEntries.length > 0) {
1188
+ clearDirSync(cliSkillDest);
1189
+ for (const { relPath, content } of cliSkillEntries) {
1190
+ writeAssetFile(path.join(cliSkillDest, relPath), content);
1191
+ }
1192
+ }
1193
+ else {
1194
+ console.warn(` [!] ${FLEET_SPRINT_CLI_SKILL_NAME} skill source not found -- skill not installed`);
1195
+ }
1196
+ }
787
1197
  if (!installFleet && !installPm) {
788
1198
  console.log(` Skipping skills (use --skill all to install, or omit --skill for default)`);
789
1199
  }
@@ -793,29 +1203,90 @@ Then re-run: apra-fleet install`);
793
1203
  console.log(` [${agentStep}/${totalSteps}] Installing PM agents...`);
794
1204
  const agentsDestDir = paths.agentsDir;
795
1205
  fs.mkdirSync(agentsDestDir, { recursive: true });
1206
+ // #336's loadAgentAssets() unifies SEA and dev-mode sourcing; its
1207
+ // dev-mode path reads packages/apra-fleet-se/apra-pm/agents directly (dist/agents only
1208
+ // as a fallback), preserving this branch's no-dist/agents rule, and it
1209
+ // recurses into _shared/ and schemas/ which the old flat readdir missed.
796
1210
  for (const { relPath, content: rawContent } of loadAgentAssets()) {
797
- const content = llm === 'opencode' ? transformAgentForOpenCode(rawContent, relPath) : rawContent;
1211
+ const content = llm === 'opencode'
1212
+ ? transformAgentForOpenCode(rawContent, relPath)
1213
+ : llm === 'agy'
1214
+ ? transformAgentForAgy(rawContent, relPath)
1215
+ : rawContent;
798
1216
  writeAssetFile(path.join(agentsDestDir, relPath), content);
799
1217
  }
800
1218
  }
1219
+ // --- Workflow-subsystem install step (optional, --workflows all|none) ---
1220
+ // Writes ~/.apra-fleet/{node_modules,schemas,workflows/{fleet-sprint,hello-world}}.
1221
+ // See docs/workflow-subsystem-plan.md Section 6 / Section 2.1 for the layout.
1222
+ if (installWorkflows) {
1223
+ // Two steps follow workflows (dolt, then Beads) before the optional service step.
1224
+ const workflowsStepNum = serviceStep ? totalSteps - 3 : totalSteps - 2;
1225
+ console.log(` [${workflowsStepNum}/${totalSteps}] Installing workflow runtime...`);
1226
+ // Extraction itself (node_modules / schemas / built-in workflows / .installed.json)
1227
+ // lives in workflow-assets.ts -- the SAME code path workflow.ts's self-heal
1228
+ // launcher path uses on-demand (apra-fleet-7pm.8).
1229
+ extractWorkflowSubsystemAssets({
1230
+ manifest,
1231
+ extractAssetBuffer,
1232
+ version: serverVersion,
1233
+ });
1234
+ }
1235
+ // --- Dolt CLI install step (apra-fleet-ire.3) ---
1236
+ // Portable dolt binary, downloaded straight into BIN_DIR (never system PATH).
1237
+ // Mirrors the Beads install step immediately below: already-installed check
1238
+ // first, download+extract+verify otherwise. NON-FATAL, same as Beads -- a
1239
+ // missing/broken dolt must never fail "apra-fleet install".
1240
+ const doltStep = serviceStep ? totalSteps - 2 : totalSteps - 1;
1241
+ console.log(` [${doltStep}/${totalSteps}] Installing Dolt CLI...`);
1242
+ let doltVersion = 'not available';
1243
+ if (doltStepEnabled()) {
1244
+ try {
1245
+ const doltBinaryName = process.platform === 'win32' ? 'dolt.exe' : 'dolt';
1246
+ const doltPath = path.join(BIN_DIR, doltBinaryName);
1247
+ let installed = false;
1248
+ // Check if already installed
1249
+ if (fs.existsSync(doltPath)) {
1250
+ try {
1251
+ const result = await doltStepDeps.verifyDolt(doltPath);
1252
+ doltVersion = result.version;
1253
+ installed = true;
1254
+ }
1255
+ catch {
1256
+ // existing binary is broken/unusable -- fall through and (re)download
1257
+ }
1258
+ }
1259
+ if (!installed) {
1260
+ // not installed (or broken) -- download and verify it
1261
+ const extractedPath = await doltStepDeps.downloadAndExtractDolt(BIN_DIR);
1262
+ const result = await doltStepDeps.verifyDolt(extractedPath);
1263
+ doltVersion = result.version;
1264
+ }
1265
+ }
1266
+ catch (err) {
1267
+ // non-fatal: warn but don't fail the install
1268
+ console.warn(` Dolt install skipped -- ${err.message}`);
1269
+ }
1270
+ }
801
1271
  // --- Beads install step ---
802
- // shell:true required on Windows — npm global packages install as .cmd wrappers
1272
+ // shell:true required on Windows - npm global packages install as .cmd wrappers
803
1273
  // that cannot be directly spawned by Node without a shell
804
- console.log(` [${totalSteps}/${totalSteps}] Installing Beads task tracker...`);
1274
+ const beadsStep = serviceStep ? totalSteps - 1 : totalSteps;
1275
+ console.log(` [${beadsStep}/${totalSteps}] Installing Beads task tracker...`);
805
1276
  try {
806
1277
  // Check if already installed
807
1278
  try {
808
1279
  execFileSync('bd', ['--version'], { stdio: 'pipe', shell: true });
809
- // already installed — skip
1280
+ // already installed - skip
810
1281
  }
811
1282
  catch {
812
- // not installed — install it
1283
+ // not installed - install it
813
1284
  execFileSync('npm', ['install', '-g', '@beads/bd@1.0.4'], { stdio: 'inherit', shell: true });
814
1285
  }
815
1286
  }
816
1287
  catch (err) {
817
1288
  // non-fatal: warn but don't fail the install
818
- console.warn(' ⚠ Beads install skipped — npm not available or install failed');
1289
+ console.warn(' - Beads install skipped - npm not available or install failed');
819
1290
  }
820
1291
  // OpenCode uses --dangerously-skip-permissions and per-agent permission: frontmatter;
821
1292
  // a top-level "permissions" key is invalid in opencode.json
@@ -826,7 +1297,30 @@ Then re-run: apra-fleet install`);
826
1297
  mergePermissions(paths, extraPerms);
827
1298
  }
828
1299
  // Write install-config.json (merge provider entry)
829
- writeInstallConfig(llm, skillMode);
1300
+ writeInstallConfig(llm, skillMode, workflowsMode);
1301
+ // --- Step N: Register and start service (SEA + HTTP mode only) ---
1302
+ let serviceRegistered = false;
1303
+ if (serviceStep) {
1304
+ console.log(` [${totalSteps}/${totalSteps}] Registering and starting service...`);
1305
+ const svcMgr = await getServiceManager();
1306
+ try {
1307
+ await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH);
1308
+ try {
1309
+ await svcMgr.start();
1310
+ serviceRegistered = true;
1311
+ }
1312
+ catch (startErr) {
1313
+ try {
1314
+ await svcMgr.unregister();
1315
+ }
1316
+ catch { }
1317
+ throw startErr;
1318
+ }
1319
+ }
1320
+ catch (err) {
1321
+ console.warn(` Service registration skipped: ${err.message}`);
1322
+ }
1323
+ }
830
1324
  // --- Done ---
831
1325
  let beadsVersion = 'installed';
832
1326
  try {
@@ -839,6 +1333,7 @@ Then re-run: apra-fleet install`);
839
1333
  const clientName = llm === 'claude' ? 'Claude Code' : paths.name;
840
1334
  const instructions = llm === 'claude' ? 'Run /mcp in Claude Code to load the server.' : `Restart ${paths.name} to load the server.`;
841
1335
  const forceNote = force ? `\nRestart ${clientName} to reload the MCP server.` : '';
1336
+ const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ? 'registered and running' : 'registration skipped'}` : '';
842
1337
  console.log(`
843
1338
  Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
844
1339
  Binary: ${BIN_DIR}
@@ -846,6 +1341,7 @@ Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
846
1341
  Scripts: ${SCRIPTS_DIR}
847
1342
  Settings: ${paths.settingsFile}${installFleet ? `\n Fleet Skill: ${paths.fleetSkillsDir}` : ''}${installPm ? `\n PM Skill: ${paths.skillsDir}` : ''}${installAgents ? `\n Agents: ${paths.agentsDir}` : ''}
848
1343
  Beads: ${beadsVersion}
1344
+ Dolt: ${doltVersion}${serviceLine}
849
1345
 
850
1346
  ${instructions}${forceNote}
851
1347
  `);