@apralabs/apra-fleet 0.3.5 → 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 (571) 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/secret.js +8 -2
  53. package/dist/cli/secret.js.map +1 -1
  54. package/dist/cli/spoke.d.ts +35 -0
  55. package/dist/cli/spoke.d.ts.map +1 -0
  56. package/dist/cli/spoke.js +212 -0
  57. package/dist/cli/spoke.js.map +1 -0
  58. package/dist/cli/start.d.ts +2 -0
  59. package/dist/cli/start.d.ts.map +1 -0
  60. package/dist/cli/start.js +92 -0
  61. package/dist/cli/start.js.map +1 -0
  62. package/dist/cli/status.d.ts +2 -0
  63. package/dist/cli/status.d.ts.map +1 -0
  64. package/dist/cli/status.js +83 -0
  65. package/dist/cli/status.js.map +1 -0
  66. package/dist/cli/stop.d.ts +2 -0
  67. package/dist/cli/stop.d.ts.map +1 -0
  68. package/dist/cli/stop.js +51 -0
  69. package/dist/cli/stop.js.map +1 -0
  70. package/dist/cli/uninstall.d.ts.map +1 -1
  71. package/dist/cli/uninstall.js +109 -9
  72. package/dist/cli/uninstall.js.map +1 -1
  73. package/dist/cli/update.d.ts.map +1 -1
  74. package/dist/cli/update.js +10 -1
  75. package/dist/cli/update.js.map +1 -1
  76. package/dist/cli/workflow-assets.d.ts +37 -0
  77. package/dist/cli/workflow-assets.d.ts.map +1 -0
  78. package/dist/cli/workflow-assets.js +144 -0
  79. package/dist/cli/workflow-assets.js.map +1 -0
  80. package/dist/cli/workflow.d.ts +75 -0
  81. package/dist/cli/workflow.d.ts.map +1 -0
  82. package/dist/cli/workflow.js +397 -0
  83. package/dist/cli/workflow.js.map +1 -0
  84. package/dist/hub-service/activity.d.ts +30 -0
  85. package/dist/hub-service/activity.d.ts.map +1 -0
  86. package/dist/hub-service/activity.js +20 -0
  87. package/dist/hub-service/activity.js.map +1 -0
  88. package/dist/hub-service/audit-log.d.ts +19 -0
  89. package/dist/hub-service/audit-log.d.ts.map +1 -0
  90. package/dist/hub-service/audit-log.js +13 -0
  91. package/dist/hub-service/audit-log.js.map +1 -0
  92. package/dist/hub-service/db/pool.d.ts +19 -0
  93. package/dist/hub-service/db/pool.d.ts.map +1 -0
  94. package/dist/hub-service/db/pool.js +53 -0
  95. package/dist/hub-service/db/pool.js.map +1 -0
  96. package/dist/hub-service/enrollment.d.ts +29 -0
  97. package/dist/hub-service/enrollment.d.ts.map +1 -0
  98. package/dist/hub-service/enrollment.js +48 -0
  99. package/dist/hub-service/enrollment.js.map +1 -0
  100. package/dist/hub-service/envelope-routes.d.ts +46 -0
  101. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  102. package/dist/hub-service/envelope-routes.js +94 -0
  103. package/dist/hub-service/envelope-routes.js.map +1 -0
  104. package/dist/hub-service/handlers/installers.d.ts +14 -0
  105. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  106. package/dist/hub-service/handlers/installers.js +8 -0
  107. package/dist/hub-service/handlers/installers.js.map +1 -0
  108. package/dist/hub-service/http-server.d.ts +31 -0
  109. package/dist/hub-service/http-server.d.ts.map +1 -0
  110. package/dist/hub-service/http-server.js +711 -0
  111. package/dist/hub-service/http-server.js.map +1 -0
  112. package/dist/hub-service/hub-jwt.d.ts +30 -0
  113. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  114. package/dist/hub-service/hub-jwt.js +105 -0
  115. package/dist/hub-service/hub-jwt.js.map +1 -0
  116. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  117. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  118. package/dist/hub-service/jwt-revocation.js +18 -0
  119. package/dist/hub-service/jwt-revocation.js.map +1 -0
  120. package/dist/hub-service/machines.d.ts +16 -0
  121. package/dist/hub-service/machines.d.ts.map +1 -0
  122. package/dist/hub-service/machines.js +14 -0
  123. package/dist/hub-service/machines.js.map +1 -0
  124. package/dist/hub-service/main.d.ts +3 -0
  125. package/dist/hub-service/main.d.ts.map +1 -0
  126. package/dist/hub-service/main.js +64 -0
  127. package/dist/hub-service/main.js.map +1 -0
  128. package/dist/hub-service/member-tokens.d.ts +11 -0
  129. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  130. package/dist/hub-service/member-tokens.js +49 -0
  131. package/dist/hub-service/member-tokens.js.map +1 -0
  132. package/dist/hub-service/member-view.d.ts +20 -0
  133. package/dist/hub-service/member-view.d.ts.map +1 -0
  134. package/dist/hub-service/member-view.js +76 -0
  135. package/dist/hub-service/member-view.js.map +1 -0
  136. package/dist/hub-service/members.d.ts +44 -0
  137. package/dist/hub-service/members.d.ts.map +1 -0
  138. package/dist/hub-service/members.js +25 -0
  139. package/dist/hub-service/members.js.map +1 -0
  140. package/dist/hub-service/presence.d.ts +40 -0
  141. package/dist/hub-service/presence.d.ts.map +1 -0
  142. package/dist/hub-service/presence.js +44 -0
  143. package/dist/hub-service/presence.js.map +1 -0
  144. package/dist/hub-service/project-view.d.ts +12 -0
  145. package/dist/hub-service/project-view.d.ts.map +1 -0
  146. package/dist/hub-service/project-view.js +34 -0
  147. package/dist/hub-service/project-view.js.map +1 -0
  148. package/dist/hub-service/projects.d.ts +48 -0
  149. package/dist/hub-service/projects.d.ts.map +1 -0
  150. package/dist/hub-service/projects.js +80 -0
  151. package/dist/hub-service/projects.js.map +1 -0
  152. package/dist/hub-service/relay-queue.d.ts +115 -0
  153. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  154. package/dist/hub-service/relay-queue.js +148 -0
  155. package/dist/hub-service/relay-queue.js.map +1 -0
  156. package/dist/hub-service/session-jwt.d.ts +10 -0
  157. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  158. package/dist/hub-service/session-jwt.js +69 -0
  159. package/dist/hub-service/session-jwt.js.map +1 -0
  160. package/dist/hub-service/usage.d.ts +40 -0
  161. package/dist/hub-service/usage.d.ts.map +1 -0
  162. package/dist/hub-service/usage.js +25 -0
  163. package/dist/hub-service/usage.js.map +1 -0
  164. package/dist/hub-service/users.d.ts +56 -0
  165. package/dist/hub-service/users.d.ts.map +1 -0
  166. package/dist/hub-service/users.js +72 -0
  167. package/dist/hub-service/users.js.map +1 -0
  168. package/dist/hub-service/workspaces.d.ts +20 -0
  169. package/dist/hub-service/workspaces.d.ts.map +1 -0
  170. package/dist/hub-service/workspaces.js +10 -0
  171. package/dist/hub-service/workspaces.js.map +1 -0
  172. package/dist/index.js +179 -132
  173. package/dist/index.js.map +1 -1
  174. package/dist/os/linux.d.ts +13 -0
  175. package/dist/os/linux.d.ts.map +1 -1
  176. package/dist/os/linux.js +62 -3
  177. package/dist/os/linux.js.map +1 -1
  178. package/dist/os/os-commands.d.ts +10 -0
  179. package/dist/os/os-commands.d.ts.map +1 -1
  180. package/dist/os/windows.d.ts +1 -0
  181. package/dist/os/windows.d.ts.map +1 -1
  182. package/dist/os/windows.js +21 -1
  183. package/dist/os/windows.js.map +1 -1
  184. package/dist/paths.d.ts +23 -0
  185. package/dist/paths.d.ts.map +1 -1
  186. package/dist/paths.js +29 -0
  187. package/dist/paths.js.map +1 -1
  188. package/dist/providers/agy.d.ts +9 -2
  189. package/dist/providers/agy.d.ts.map +1 -1
  190. package/dist/providers/agy.js +127 -14
  191. package/dist/providers/agy.js.map +1 -1
  192. package/dist/providers/claude.d.ts +6 -2
  193. package/dist/providers/claude.d.ts.map +1 -1
  194. package/dist/providers/claude.js +248 -9
  195. package/dist/providers/claude.js.map +1 -1
  196. package/dist/providers/codex.d.ts +3 -2
  197. package/dist/providers/codex.d.ts.map +1 -1
  198. package/dist/providers/codex.js +7 -0
  199. package/dist/providers/codex.js.map +1 -1
  200. package/dist/providers/copilot.d.ts +3 -2
  201. package/dist/providers/copilot.d.ts.map +1 -1
  202. package/dist/providers/copilot.js +8 -1
  203. package/dist/providers/copilot.js.map +1 -1
  204. package/dist/providers/gemini.d.ts +3 -2
  205. package/dist/providers/gemini.d.ts.map +1 -1
  206. package/dist/providers/gemini.js +11 -1
  207. package/dist/providers/gemini.js.map +1 -1
  208. package/dist/providers/index.d.ts +1 -0
  209. package/dist/providers/index.d.ts.map +1 -1
  210. package/dist/providers/index.js +3 -0
  211. package/dist/providers/index.js.map +1 -1
  212. package/dist/providers/none.d.ts +51 -0
  213. package/dist/providers/none.d.ts.map +1 -0
  214. package/dist/providers/none.js +103 -0
  215. package/dist/providers/none.js.map +1 -0
  216. package/dist/providers/opencode.d.ts +4 -2
  217. package/dist/providers/opencode.d.ts.map +1 -1
  218. package/dist/providers/opencode.js +49 -0
  219. package/dist/providers/opencode.js.map +1 -1
  220. package/dist/providers/provider.d.ts +79 -1
  221. package/dist/providers/provider.d.ts.map +1 -1
  222. package/dist/providers/provider.js +10 -0
  223. package/dist/providers/provider.js.map +1 -1
  224. package/dist/services/agent-provisioner.d.ts +3 -3
  225. package/dist/services/agent-provisioner.d.ts.map +1 -1
  226. package/dist/services/agent-provisioner.js +12 -5
  227. package/dist/services/agent-provisioner.js.map +1 -1
  228. package/dist/services/auth-socket.d.ts.map +1 -1
  229. package/dist/services/auth-socket.js +2 -0
  230. package/dist/services/auth-socket.js.map +1 -1
  231. package/dist/services/budget-awareness.d.ts +130 -0
  232. package/dist/services/budget-awareness.d.ts.map +1 -0
  233. package/dist/services/budget-awareness.js +129 -0
  234. package/dist/services/budget-awareness.js.map +1 -0
  235. package/dist/services/cloud-sync.d.ts +35 -0
  236. package/dist/services/cloud-sync.d.ts.map +1 -0
  237. package/dist/services/cloud-sync.js +90 -0
  238. package/dist/services/cloud-sync.js.map +1 -0
  239. package/dist/services/context-admission.d.ts +82 -0
  240. package/dist/services/context-admission.d.ts.map +1 -0
  241. package/dist/services/context-admission.js +136 -0
  242. package/dist/services/context-admission.js.map +1 -0
  243. package/dist/services/event-bus.d.ts +27 -0
  244. package/dist/services/event-bus.d.ts.map +1 -0
  245. package/dist/services/event-bus.js +20 -0
  246. package/dist/services/event-bus.js.map +1 -0
  247. package/dist/services/file-chunker.d.ts +38 -0
  248. package/dist/services/file-chunker.d.ts.map +1 -0
  249. package/dist/services/file-chunker.js +63 -0
  250. package/dist/services/file-chunker.js.map +1 -0
  251. package/dist/services/file-transfer-relay.d.ts +55 -0
  252. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  253. package/dist/services/file-transfer-relay.js +115 -0
  254. package/dist/services/file-transfer-relay.js.map +1 -0
  255. package/dist/services/github-app.d.ts.map +1 -1
  256. package/dist/services/github-app.js +1 -0
  257. package/dist/services/github-app.js.map +1 -1
  258. package/dist/services/http-transport.d.ts +25 -0
  259. package/dist/services/http-transport.d.ts.map +1 -0
  260. package/dist/services/http-transport.js +371 -0
  261. package/dist/services/http-transport.js.map +1 -0
  262. package/dist/services/hub-client.d.ts +69 -0
  263. package/dist/services/hub-client.d.ts.map +1 -0
  264. package/dist/services/hub-client.js +217 -0
  265. package/dist/services/hub-client.js.map +1 -0
  266. package/dist/services/jwt.d.ts +17 -0
  267. package/dist/services/jwt.d.ts.map +1 -0
  268. package/dist/services/jwt.js +70 -0
  269. package/dist/services/jwt.js.map +1 -0
  270. package/dist/services/known-sessions.d.ts +8 -0
  271. package/dist/services/known-sessions.d.ts.map +1 -0
  272. package/dist/services/known-sessions.js +40 -0
  273. package/dist/services/known-sessions.js.map +1 -0
  274. package/dist/services/model-pricing.d.ts +36 -0
  275. package/dist/services/model-pricing.d.ts.map +1 -0
  276. package/dist/services/model-pricing.js +108 -0
  277. package/dist/services/model-pricing.js.map +1 -0
  278. package/dist/services/orphan-recovery.d.ts +56 -0
  279. package/dist/services/orphan-recovery.d.ts.map +1 -0
  280. package/dist/services/orphan-recovery.js +111 -0
  281. package/dist/services/orphan-recovery.js.map +1 -0
  282. package/dist/services/pending-responses.d.ts +23 -0
  283. package/dist/services/pending-responses.d.ts.map +1 -0
  284. package/dist/services/pending-responses.js +52 -0
  285. package/dist/services/pending-responses.js.map +1 -0
  286. package/dist/services/registry.d.ts +4 -1
  287. package/dist/services/registry.d.ts.map +1 -1
  288. package/dist/services/registry.js +3 -0
  289. package/dist/services/registry.js.map +1 -1
  290. package/dist/services/relay-context.d.ts +23 -0
  291. package/dist/services/relay-context.d.ts.map +1 -0
  292. package/dist/services/relay-context.js +8 -0
  293. package/dist/services/relay-context.js.map +1 -0
  294. package/dist/services/relay-executor.d.ts +68 -0
  295. package/dist/services/relay-executor.d.ts.map +1 -0
  296. package/dist/services/relay-executor.js +70 -0
  297. package/dist/services/relay-executor.js.map +1 -0
  298. package/dist/services/relay-request.d.ts +65 -0
  299. package/dist/services/relay-request.d.ts.map +1 -0
  300. package/dist/services/relay-request.js +129 -0
  301. package/dist/services/relay-request.js.map +1 -0
  302. package/dist/services/relay-strategy.d.ts +19 -0
  303. package/dist/services/relay-strategy.d.ts.map +1 -0
  304. package/dist/services/relay-strategy.js +111 -0
  305. package/dist/services/relay-strategy.js.map +1 -0
  306. package/dist/services/service-manager/index.d.ts +5 -0
  307. package/dist/services/service-manager/index.d.ts.map +1 -0
  308. package/dist/services/service-manager/index.js +66 -0
  309. package/dist/services/service-manager/index.js.map +1 -0
  310. package/dist/services/service-manager/linux.d.ts +10 -0
  311. package/dist/services/service-manager/linux.d.ts.map +1 -0
  312. package/dist/services/service-manager/linux.js +97 -0
  313. package/dist/services/service-manager/linux.js.map +1 -0
  314. package/dist/services/service-manager/macos.d.ts +10 -0
  315. package/dist/services/service-manager/macos.d.ts.map +1 -0
  316. package/dist/services/service-manager/macos.js +94 -0
  317. package/dist/services/service-manager/macos.js.map +1 -0
  318. package/dist/services/service-manager/types.d.ts +18 -0
  319. package/dist/services/service-manager/types.d.ts.map +1 -0
  320. package/dist/services/service-manager/types.js +5 -0
  321. package/dist/services/service-manager/types.js.map +1 -0
  322. package/dist/services/service-manager/windows.d.ts +10 -0
  323. package/dist/services/service-manager/windows.d.ts.map +1 -0
  324. package/dist/services/service-manager/windows.js +73 -0
  325. package/dist/services/service-manager/windows.js.map +1 -0
  326. package/dist/services/session-registry.d.ts +70 -0
  327. package/dist/services/session-registry.d.ts.map +1 -0
  328. package/dist/services/session-registry.js +91 -0
  329. package/dist/services/session-registry.js.map +1 -0
  330. package/dist/services/singleton.d.ts +15 -0
  331. package/dist/services/singleton.d.ts.map +1 -0
  332. package/dist/services/singleton.js +98 -0
  333. package/dist/services/singleton.js.map +1 -0
  334. package/dist/services/sprint-coordination.d.ts +168 -0
  335. package/dist/services/sprint-coordination.d.ts.map +1 -0
  336. package/dist/services/sprint-coordination.js +564 -0
  337. package/dist/services/sprint-coordination.js.map +1 -0
  338. package/dist/services/ssh.d.ts.map +1 -1
  339. package/dist/services/ssh.js +70 -3
  340. package/dist/services/ssh.js.map +1 -1
  341. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  342. package/dist/services/stall/log-path-resolver.js +8 -1
  343. package/dist/services/stall/log-path-resolver.js.map +1 -1
  344. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  345. package/dist/services/stall/stall-detector.js +39 -7
  346. package/dist/services/stall/stall-detector.js.map +1 -1
  347. package/dist/services/stall/stall-poller.d.ts +16 -0
  348. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  349. package/dist/services/stall/stall-poller.js +136 -18
  350. package/dist/services/stall/stall-poller.js.map +1 -1
  351. package/dist/services/strategy.d.ts.map +1 -1
  352. package/dist/services/strategy.js +55 -5
  353. package/dist/services/strategy.js.map +1 -1
  354. package/dist/services/substitution-engine.d.ts +20 -0
  355. package/dist/services/substitution-engine.d.ts.map +1 -0
  356. package/dist/services/substitution-engine.js +92 -0
  357. package/dist/services/substitution-engine.js.map +1 -0
  358. package/dist/services/task-cleanup.d.ts.map +1 -1
  359. package/dist/services/task-cleanup.js +1 -9
  360. package/dist/services/task-cleanup.js.map +1 -1
  361. package/dist/services/token-issuer.d.ts +47 -0
  362. package/dist/services/token-issuer.d.ts.map +1 -0
  363. package/dist/services/token-issuer.js +63 -0
  364. package/dist/services/token-issuer.js.map +1 -0
  365. package/dist/services/tool-registry.d.ts +3 -0
  366. package/dist/services/tool-registry.d.ts.map +1 -0
  367. package/dist/services/tool-registry.js +139 -0
  368. package/dist/services/tool-registry.js.map +1 -0
  369. package/dist/services/user-config.d.ts +14 -0
  370. package/dist/services/user-config.d.ts.map +1 -1
  371. package/dist/services/user-config.js +55 -0
  372. package/dist/services/user-config.js.map +1 -1
  373. package/dist/services/vcs/types.d.ts +44 -0
  374. package/dist/services/vcs/types.d.ts.map +1 -1
  375. package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
  376. package/dist/skills/pm/cost.md +3 -0
  377. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  378. package/dist/tools/check-status.d.ts.map +1 -1
  379. package/dist/tools/check-status.js +8 -2
  380. package/dist/tools/check-status.js.map +1 -1
  381. package/dist/tools/child-id-allocator.d.ts +45 -0
  382. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  383. package/dist/tools/child-id-allocator.js +62 -0
  384. package/dist/tools/child-id-allocator.js.map +1 -0
  385. package/dist/tools/cloud-control.d.ts +2 -2
  386. package/dist/tools/compose-permissions.d.ts +12 -4
  387. package/dist/tools/compose-permissions.d.ts.map +1 -1
  388. package/dist/tools/compose-permissions.js +55 -4
  389. package/dist/tools/compose-permissions.js.map +1 -1
  390. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  391. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  392. package/dist/tools/dolt-push-mutex.js +83 -0
  393. package/dist/tools/dolt-push-mutex.js.map +1 -0
  394. package/dist/tools/execute-command.d.ts +11 -1
  395. package/dist/tools/execute-command.d.ts.map +1 -1
  396. package/dist/tools/execute-command.js +22 -5
  397. package/dist/tools/execute-command.js.map +1 -1
  398. package/dist/tools/execute-prompt.d.ts +72 -12
  399. package/dist/tools/execute-prompt.d.ts.map +1 -1
  400. package/dist/tools/execute-prompt.js +962 -71
  401. package/dist/tools/execute-prompt.js.map +1 -1
  402. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  403. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  404. package/dist/tools/get-member-model-pricing.js +29 -0
  405. package/dist/tools/get-member-model-pricing.js.map +1 -0
  406. package/dist/tools/list-members.d.ts.map +1 -1
  407. package/dist/tools/list-members.js +39 -7
  408. package/dist/tools/list-members.js.map +1 -1
  409. package/dist/tools/member-detail.d.ts +1 -1
  410. package/dist/tools/member-detail.d.ts.map +1 -1
  411. package/dist/tools/member-detail.js +8 -2
  412. package/dist/tools/member-detail.js.map +1 -1
  413. package/dist/tools/member-reservation.d.ts +29 -0
  414. package/dist/tools/member-reservation.d.ts.map +1 -0
  415. package/dist/tools/member-reservation.js +71 -0
  416. package/dist/tools/member-reservation.js.map +1 -0
  417. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  418. package/dist/tools/provision-vcs-auth.js +1 -1
  419. package/dist/tools/provision-vcs-auth.js.map +1 -1
  420. package/dist/tools/register-member.d.ts +17 -5
  421. package/dist/tools/register-member.d.ts.map +1 -1
  422. package/dist/tools/register-member.js +144 -5
  423. package/dist/tools/register-member.js.map +1 -1
  424. package/dist/tools/remove-member.d.ts +1 -1
  425. package/dist/tools/report-status.d.ts +33 -0
  426. package/dist/tools/report-status.d.ts.map +1 -0
  427. package/dist/tools/report-status.js +44 -0
  428. package/dist/tools/report-status.js.map +1 -0
  429. package/dist/tools/respond-to-message.d.ts +21 -0
  430. package/dist/tools/respond-to-message.d.ts.map +1 -0
  431. package/dist/tools/respond-to-message.js +23 -0
  432. package/dist/tools/respond-to-message.js.map +1 -0
  433. package/dist/tools/send-files.d.ts +3 -0
  434. package/dist/tools/send-files.d.ts.map +1 -1
  435. package/dist/tools/send-files.js +88 -8
  436. package/dist/tools/send-files.js.map +1 -1
  437. package/dist/tools/send-message.d.ts +27 -0
  438. package/dist/tools/send-message.d.ts.map +1 -0
  439. package/dist/tools/send-message.js +46 -0
  440. package/dist/tools/send-message.js.map +1 -0
  441. package/dist/tools/shutdown-server.d.ts +2 -0
  442. package/dist/tools/shutdown-server.d.ts.map +1 -1
  443. package/dist/tools/shutdown-server.js +19 -0
  444. package/dist/tools/shutdown-server.js.map +1 -1
  445. package/dist/tools/update-member.d.ts +8 -8
  446. package/dist/tools/update-member.d.ts.map +1 -1
  447. package/dist/tools/update-member.js +11 -1
  448. package/dist/tools/update-member.js.map +1 -1
  449. package/dist/types.d.ts +15 -3
  450. package/dist/types.d.ts.map +1 -1
  451. package/dist/utils/agent-helpers.d.ts +2 -1
  452. package/dist/utils/agent-helpers.d.ts.map +1 -1
  453. package/dist/utils/agent-helpers.js +7 -2
  454. package/dist/utils/agent-helpers.js.map +1 -1
  455. package/dist/utils/pid-helpers.d.ts +15 -0
  456. package/dist/utils/pid-helpers.d.ts.map +1 -1
  457. package/dist/utils/pid-helpers.js +23 -0
  458. package/dist/utils/pid-helpers.js.map +1 -1
  459. package/dist/utils/process-utils.d.ts +3 -0
  460. package/dist/utils/process-utils.d.ts.map +1 -0
  461. package/dist/utils/process-utils.js +42 -0
  462. package/dist/utils/process-utils.js.map +1 -0
  463. package/dist/utils/prompt-errors.d.ts +2 -1
  464. package/dist/utils/prompt-errors.d.ts.map +1 -1
  465. package/dist/utils/prompt-errors.js +13 -3
  466. package/dist/utils/prompt-errors.js.map +1 -1
  467. package/dist/utils/workspace-trust.d.ts +24 -0
  468. package/dist/utils/workspace-trust.d.ts.map +1 -0
  469. package/dist/utils/workspace-trust.js +35 -0
  470. package/dist/utils/workspace-trust.js.map +1 -0
  471. package/dist/workflows/auto-sprint.js +450 -87
  472. package/package.json +35 -7
  473. package/packages/apra-fleet-client/package.json +26 -0
  474. package/packages/apra-fleet-client/src/client/api.mjs +396 -0
  475. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  476. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  477. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  478. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  479. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  480. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
  481. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
  482. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
  483. package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
  486. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
  487. package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
  488. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
  489. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
  490. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  491. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  492. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  493. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  494. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  495. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  496. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  497. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
  498. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  499. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
  500. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  501. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  502. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  503. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  504. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  505. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  506. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  507. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
  508. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  509. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
  510. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  511. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  512. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
  513. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  514. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  515. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  516. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  517. package/packages/apra-fleet-se/bin/cli.mjs +857 -0
  518. package/packages/apra-fleet-se/bin/serve.mjs +383 -0
  519. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  520. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
  521. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  522. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  523. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
  524. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
  525. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  526. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  527. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  528. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
  529. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
  530. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
  531. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
  532. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
  533. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  534. package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
  535. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
  536. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  537. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  538. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  539. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  540. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  541. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  542. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
  543. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  544. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
  545. package/packages/apra-fleet-se/package.json +28 -0
  546. package/packages/apra-fleet-se/workflow.json +1 -0
  547. package/packages/apra-fleet-workflow/package.json +30 -0
  548. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  549. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  550. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  551. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
  552. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  553. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  554. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  555. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  556. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  557. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
  558. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  559. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  560. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  561. package/scripts/agy-transcript-reader.js +1 -0
  562. package/scripts/fleet-statusline.sh +17 -13
  563. package/skills/fleet/SKILL.md +37 -2
  564. package/skills/fleet/beads.md +14 -7
  565. package/skills/fleet/permissions.md +50 -0
  566. package/skills/fleet/profiles/base-dev.json +1 -0
  567. package/skills/fleet/profiles/base-reviewer.json +1 -0
  568. package/skills/fleet/profiles/node.json +2 -2
  569. package/version.json +1 -1
  570. package/scripts/agy-settings-merge.js +0 -27
  571. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,334 @@
1
+ /**
2
+ * Portable dolt CLI download/extract helper (apra-fleet-ire.1).
3
+ *
4
+ * PoC (2026-07-16, dolt-poc-v2) confirmed that having a real dolt binary
5
+ * available -- no admin/system install needed -- unlocks the documented
6
+ * dolt_conflicts / dolt_conflicts_resolve resolve-in-place path for Dolt
7
+ * merge conflicts, which is otherwise completely blocked in bd's embedded
8
+ * mode. This module resolves the correct dolt v2.2.0 release asset for the
9
+ * running platform/arch and downloads+extracts the single static binary
10
+ * into a caller-supplied destDir (BIN_DIR-adjacent, NEVER system PATH).
11
+ *
12
+ * Mirrors the fetch/asset-download pattern in update.ts (line ~32-70) and
13
+ * the deps-injection-for-testability pattern in join.ts (JoinDeps/realDeps).
14
+ */
15
+ import fs from 'node:fs';
16
+ import os from 'node:os';
17
+ import path from 'node:path';
18
+ import zlib from 'node:zlib';
19
+ import net from 'node:net';
20
+ import { execFileSync, spawn } from 'node:child_process';
21
+ export const DOLT_VERSION = 'v2.2.0';
22
+ const DOLT_RELEASE_BASE = `https://github.com/dolthub/dolt/releases/download/${DOLT_VERSION}`;
23
+ /** Typed error thrown for a platform/arch combo with no known dolt release asset. */
24
+ export class UnsupportedDoltPlatformError extends Error {
25
+ constructor(platform, arch) {
26
+ super(`Unsupported platform/arch for portable dolt install: ${platform}/${arch}`);
27
+ this.name = 'UnsupportedDoltPlatformError';
28
+ }
29
+ }
30
+ /**
31
+ * Resolves the dolthub/dolt v2.2.0 release asset for the given platform/arch.
32
+ * Throws UnsupportedDoltPlatformError rather than silently no-op'ing on an
33
+ * unsupported combo (e.g. win32/arm64, linux/arm64 -- not published upstream
34
+ * for this pinned version).
35
+ */
36
+ export function resolveDoltAsset(platform, arch) {
37
+ const binaryName = platform === 'win32' ? 'dolt.exe' : 'dolt';
38
+ let assetName;
39
+ let archiveType;
40
+ if (platform === 'win32' && arch === 'x64') {
41
+ assetName = 'dolt-windows-amd64.zip';
42
+ archiveType = 'zip';
43
+ }
44
+ else if (platform === 'linux' && arch === 'x64') {
45
+ assetName = 'dolt-linux-amd64.tar.gz';
46
+ archiveType = 'tar.gz';
47
+ }
48
+ else if (platform === 'darwin' && arch === 'x64') {
49
+ assetName = 'dolt-darwin-amd64.tar.gz';
50
+ archiveType = 'tar.gz';
51
+ }
52
+ else if (platform === 'darwin' && arch === 'arm64') {
53
+ assetName = 'dolt-darwin-arm64.tar.gz';
54
+ archiveType = 'tar.gz';
55
+ }
56
+ if (!assetName || !archiveType) {
57
+ throw new UnsupportedDoltPlatformError(platform, arch);
58
+ }
59
+ return {
60
+ assetName,
61
+ url: `${DOLT_RELEASE_BASE}/${assetName}`,
62
+ archiveType,
63
+ binaryName,
64
+ };
65
+ }
66
+ const realDeps = {
67
+ fetch: (...a) => globalThis.fetch(...a),
68
+ fs: {
69
+ mkdir: (dir, opts) => fs.promises.mkdir(dir, opts),
70
+ writeFile: (file, data) => fs.promises.writeFile(file, data),
71
+ chmod: (file, mode) => fs.promises.chmod(file, mode),
72
+ },
73
+ };
74
+ /**
75
+ * Finds and returns the raw (decompressed) bytes of a single named file
76
+ * inside a .zip archive buffer. Handles both the STORE (0) and DEFLATE (8)
77
+ * compression methods -- the only two dolt release zips and typical zip
78
+ * fixtures use.
79
+ */
80
+ function extractSingleFileFromZip(buf, binaryName) {
81
+ const eocdSig = 0x06054b50;
82
+ let eocdOffset = -1;
83
+ for (let i = buf.length - 22; i >= 0; i--) {
84
+ if (buf.readUInt32LE(i) === eocdSig) {
85
+ eocdOffset = i;
86
+ break;
87
+ }
88
+ }
89
+ if (eocdOffset === -1) {
90
+ throw new Error('Invalid zip archive: End Of Central Directory record not found');
91
+ }
92
+ const entryCount = buf.readUInt16LE(eocdOffset + 10);
93
+ const cdOffset = buf.readUInt32LE(eocdOffset + 16);
94
+ let offset = cdOffset;
95
+ for (let i = 0; i < entryCount; i++) {
96
+ const sig = buf.readUInt32LE(offset);
97
+ if (sig !== 0x02014b50) {
98
+ throw new Error('Invalid zip archive: malformed central directory entry');
99
+ }
100
+ const compressionMethod = buf.readUInt16LE(offset + 10);
101
+ const compressedSize = buf.readUInt32LE(offset + 20);
102
+ const fileNameLength = buf.readUInt16LE(offset + 28);
103
+ const extraFieldLength = buf.readUInt16LE(offset + 30);
104
+ const fileCommentLength = buf.readUInt16LE(offset + 32);
105
+ const localHeaderOffset = buf.readUInt32LE(offset + 42);
106
+ const fileName = buf.toString('utf-8', offset + 46, offset + 46 + fileNameLength);
107
+ if (fileName.replace(/\\/g, '/').split('/').pop() === binaryName) {
108
+ const localSig = buf.readUInt32LE(localHeaderOffset);
109
+ if (localSig !== 0x04034b50) {
110
+ throw new Error('Invalid zip archive: malformed local file header');
111
+ }
112
+ const localNameLength = buf.readUInt16LE(localHeaderOffset + 26);
113
+ const localExtraLength = buf.readUInt16LE(localHeaderOffset + 28);
114
+ const dataStart = localHeaderOffset + 30 + localNameLength + localExtraLength;
115
+ const compressedData = buf.subarray(dataStart, dataStart + compressedSize);
116
+ if (compressionMethod === 0) {
117
+ return Buffer.from(compressedData);
118
+ }
119
+ if (compressionMethod === 8) {
120
+ return zlib.inflateRawSync(compressedData);
121
+ }
122
+ throw new Error(`Unsupported zip compression method ${compressionMethod} for entry ${fileName}`);
123
+ }
124
+ offset += 46 + fileNameLength + extraFieldLength + fileCommentLength;
125
+ }
126
+ throw new Error(`Binary "${binaryName}" not found in zip archive`);
127
+ }
128
+ /**
129
+ * Finds and returns the raw bytes of a single named file inside a gzipped
130
+ * (ustar/POSIX) tar archive buffer.
131
+ */
132
+ function extractSingleFileFromTarGz(buf, binaryName) {
133
+ const tarBuf = zlib.gunzipSync(buf);
134
+ let offset = 0;
135
+ while (offset + 512 <= tarBuf.length) {
136
+ const header = tarBuf.subarray(offset, offset + 512);
137
+ if (header.every((b) => b === 0))
138
+ break; // end-of-archive marker block
139
+ const rawName = header.toString('utf-8', 0, 100).replace(/\0.*$/, '');
140
+ const sizeField = header.toString('utf-8', 124, 136).replace(/\0.*$/, '').trim();
141
+ const size = sizeField ? parseInt(sizeField, 8) : 0;
142
+ const typeFlag = header.toString('utf-8', 156, 157);
143
+ const dataStart = offset + 512;
144
+ const paddedSize = Math.ceil(size / 512) * 512;
145
+ // '0' and '\0' both denote a regular file per the tar spec.
146
+ const isRegularFile = typeFlag === '0' || typeFlag === '\0' || typeFlag === '';
147
+ if (isRegularFile && rawName.replace(/\\/g, '/').split('/').pop() === binaryName) {
148
+ return Buffer.from(tarBuf.subarray(dataStart, dataStart + size));
149
+ }
150
+ offset = dataStart + paddedSize;
151
+ }
152
+ throw new Error(`Binary "${binaryName}" not found in tar archive`);
153
+ }
154
+ /**
155
+ * Downloads the platform-appropriate dolt v2.2.0 release asset and extracts
156
+ * the single static dolt binary into destDir (caller-supplied,
157
+ * BIN_DIR-adjacent -- NEVER system PATH, no admin rights required). Returns
158
+ * the absolute path to the extracted, executable binary.
159
+ */
160
+ export async function downloadAndExtractDolt(destDir, deps = realDeps) {
161
+ const platform = process.platform;
162
+ const arch = process.arch;
163
+ const asset = resolveDoltAsset(platform, arch);
164
+ const res = await deps.fetch(asset.url);
165
+ if (!res.ok) {
166
+ throw new Error(`Failed to download dolt release asset "${asset.assetName}": HTTP ${res.status}`);
167
+ }
168
+ const archiveBuf = Buffer.from(await res.arrayBuffer());
169
+ const binaryBuf = asset.archiveType === 'zip'
170
+ ? extractSingleFileFromZip(archiveBuf, asset.binaryName)
171
+ : extractSingleFileFromTarGz(archiveBuf, asset.binaryName);
172
+ await deps.fs.mkdir(destDir, { recursive: true });
173
+ const destPath = path.join(destDir, asset.binaryName);
174
+ await deps.fs.writeFile(destPath, binaryBuf);
175
+ if (platform !== 'win32') {
176
+ await deps.fs.chmod(destPath, 0o755);
177
+ }
178
+ return path.resolve(destPath);
179
+ }
180
+ function isPortFree(port) {
181
+ return new Promise((resolve) => {
182
+ const srv = net.createServer();
183
+ srv.once('error', () => resolve(false));
184
+ srv.listen(port, '127.0.0.1', () => {
185
+ srv.close(() => resolve(true));
186
+ });
187
+ });
188
+ }
189
+ function getEphemeralPort() {
190
+ return new Promise((resolve, reject) => {
191
+ const srv = net.createServer();
192
+ srv.once('error', reject);
193
+ srv.listen(0, '127.0.0.1', () => {
194
+ const addr = srv.address();
195
+ const port = addr && typeof addr === 'object' ? addr.port : 0;
196
+ srv.close(() => resolve(port));
197
+ });
198
+ });
199
+ }
200
+ /** Bounded poll for a TCP connection to succeed; never hangs past timeoutMs. */
201
+ function waitForConnect(port, timeoutMs) {
202
+ const deadline = Date.now() + timeoutMs;
203
+ return new Promise((resolve) => {
204
+ const attempt = () => {
205
+ const socket = net.createConnection({ port, host: '127.0.0.1' });
206
+ const finish = (ok) => {
207
+ socket.removeAllListeners();
208
+ socket.destroy();
209
+ if (ok) {
210
+ resolve(true);
211
+ return;
212
+ }
213
+ if (Date.now() >= deadline) {
214
+ resolve(false);
215
+ return;
216
+ }
217
+ setTimeout(attempt, 150);
218
+ };
219
+ socket.once('connect', () => finish(true));
220
+ socket.once('error', () => finish(false));
221
+ socket.setTimeout(Math.min(500, Math.max(0, deadline - Date.now())), () => finish(false));
222
+ };
223
+ attempt();
224
+ });
225
+ }
226
+ /** Platform-specific child termination, mirroring the convention in cli/stop.ts. */
227
+ function killChild(child) {
228
+ if (child.pid === undefined || child.killed)
229
+ return;
230
+ if (process.platform === 'win32') {
231
+ try {
232
+ execFileSync('taskkill', ['/F', '/T', '/PID', String(child.pid)], { stdio: 'ignore' });
233
+ }
234
+ catch {
235
+ // best-effort
236
+ }
237
+ }
238
+ else {
239
+ try {
240
+ child.kill('SIGKILL');
241
+ }
242
+ catch {
243
+ // best-effort
244
+ }
245
+ }
246
+ }
247
+ const realVerifyDeps = {
248
+ execFileSync,
249
+ spawn,
250
+ fs: {
251
+ mkdtempSync: (prefix) => fs.mkdtempSync(prefix),
252
+ rmSync: (dir, opts) => fs.rmSync(dir, opts),
253
+ },
254
+ net: { isPortFree, getEphemeralPort, waitForConnect },
255
+ killChild,
256
+ };
257
+ /**
258
+ * Proves a downloaded dolt binary is actually usable:
259
+ * 1. Runs `dolt version` (execFileSync, shell:true on Windows per the
260
+ * Beads-step convention at install.ts:1034) and parses the version
261
+ * string. Throws if this fails -- a broken/missing binary should fail
262
+ * the install outright.
263
+ * 2. Smoke-tests a real `dolt sql-server` against a throwaway scratch data
264
+ * dir on a configurable port (default 3306; falls back to an ephemeral
265
+ * free port if the requested one is already in use), waits (bounded,
266
+ * ~15s cap) for it to accept a TCP connection, then terminates the
267
+ * child and removes the scratch dir. This portion never throws -- it
268
+ * returns serverOk:false with a reason so the caller can warn-not-fail.
269
+ *
270
+ * The scratch dir and dolt child are always cleaned up (try/finally), even
271
+ * if the server never comes up or something throws mid-way.
272
+ */
273
+ export async function verifyDolt(doltPath, opts = {}, deps = realVerifyDeps) {
274
+ const versionOut = deps.execFileSync(doltPath, ['version'], {
275
+ stdio: 'pipe',
276
+ encoding: 'utf-8',
277
+ shell: process.platform === 'win32',
278
+ });
279
+ const versionMatch = versionOut.match(/(\d+\.\d+\.\d+\S*)/);
280
+ const version = versionMatch ? versionMatch[1] : versionOut.trim();
281
+ const requestedPort = opts.port ?? 3306;
282
+ const waitTimeoutMs = opts.waitTimeoutMs ?? 15000;
283
+ let scratchDir;
284
+ let child;
285
+ try {
286
+ scratchDir = deps.fs.mkdtempSync(path.join(os.tmpdir(), 'dolt-verify-'));
287
+ let port = requestedPort;
288
+ const portFree = await deps.net.isPortFree(requestedPort);
289
+ if (!portFree) {
290
+ try {
291
+ port = await deps.net.getEphemeralPort();
292
+ }
293
+ catch (err) {
294
+ return { version, serverOk: false, reason: `No free port available: ${err.message}` };
295
+ }
296
+ }
297
+ child = deps.spawn(doltPath, ['sql-server', '--port', String(port), '--data-dir', scratchDir], {
298
+ stdio: 'ignore',
299
+ });
300
+ let spawnError;
301
+ child.once('error', (err) => {
302
+ spawnError = err;
303
+ });
304
+ const connected = await deps.net.waitForConnect(port, waitTimeoutMs);
305
+ if (spawnError) {
306
+ return { version, serverOk: false, reason: `Failed to spawn dolt sql-server: ${spawnError.message}` };
307
+ }
308
+ if (!connected) {
309
+ return {
310
+ version,
311
+ serverOk: false,
312
+ reason: `dolt sql-server did not accept connections on port ${port} within ${waitTimeoutMs}ms`,
313
+ };
314
+ }
315
+ return { version, serverOk: true };
316
+ }
317
+ catch (err) {
318
+ return { version, serverOk: false, reason: err.message };
319
+ }
320
+ finally {
321
+ if (child) {
322
+ deps.killChild(child);
323
+ }
324
+ if (scratchDir) {
325
+ try {
326
+ deps.fs.rmSync(scratchDir, { recursive: true, force: true });
327
+ }
328
+ catch {
329
+ // best-effort cleanup
330
+ }
331
+ }
332
+ }
333
+ }
334
+ //# sourceMappingURL=dolt-install.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dolt-install.js","sourceRoot":"","sources":["../../src/cli/dolt-install.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ export interface RunningApraFleetProcess {
2
+ pid: number;
3
+ /** Absolute path of the running executable, or null when it could not be resolved. */
4
+ exePath: string | null;
5
+ }
6
+ export interface RunningServerScope {
7
+ /** True when the running server must block/force-stop this install. */
8
+ relevant: boolean;
9
+ reason: 'data-dir' | 'install-prefix' | null;
10
+ /** Human-readable one-liner describing what was found. */
11
+ detail: string;
12
+ }
13
+ /** Data dir this process would use -- mirrors services/singleton.ts getFleetDir(). */
14
+ export declare function getInstallDataDir(): string;
15
+ /**
16
+ * PID of a live server recorded in the data dir this install targets, or null.
17
+ * Read-only: unlike checkRunningInstance() this never deletes server.json.
18
+ */
19
+ export declare function liveInstancePidForDataDir(): number | null;
20
+ /** Running apra-fleet processes (excluding this one) with their executable paths. */
21
+ export declare function getRunningApraFleetProcesses(): RunningApraFleetProcess[];
22
+ /** True when `exePath` is the install prefix dir itself or a file underneath it. */
23
+ export declare function isUnderInstallPrefix(exePath: string | null, prefixDir: string): boolean;
24
+ /**
25
+ * Decide whether the running apra-fleet server(s) are relevant to an install
26
+ * that writes its binary into `installPrefixDir`.
27
+ */
28
+ export declare function classifyRunningServer(installPrefixDir: string): RunningServerScope;
29
+ //# sourceMappingURL=install-guard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"install-guard.d.ts","sourceRoot":"","sources":["../../src/cli/install-guard.ts"],"names":[],"mappings":"AAuCA,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,sFAAsF;IACtF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAC7C,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAUD;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,IAAI,CASzD;AAED,qFAAqF;AACrF,wBAAgB,4BAA4B,IAAI,uBAAuB,EAAE,CA0CxE;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAUvF;AASD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,GAAG,kBAAkB,CAqBlF"}
@@ -0,0 +1,153 @@
1
+ /**
2
+ * Scoped running-server pre-check for `apra-fleet install` (apra-fleet-1aw).
3
+ *
4
+ * The install guard used to refuse whenever ANY process named `apra-fleet`
5
+ * existed on the machine (isApraFleetRunning(), OS-global by design). That
6
+ * makes a fully isolated install -- separate HOME, APRA_FLEET_DATA_DIR and
7
+ * install prefix, the shape ci.yml's "Pack + install into a clean temp
8
+ * prefix" step uses -- unreplayable on any box that already runs a fleet
9
+ * server.
10
+ *
11
+ * This module answers the narrower question the guard actually cares about:
12
+ * is the running server relevant to THIS install? It is relevant when either
13
+ *
14
+ * (a) a live instance is recorded for the data dir this install targets
15
+ * (server.json + isPidAlive, the same machinery as
16
+ * services/singleton.ts checkRunningInstance(), minus the HTTP health
17
+ * probe and its server.json unlink -- a wedged-but-alive server must
18
+ * still fire the guard, and the guard path must not stall 2s), or
19
+ * (b) the running server's executable lives under the install prefix being
20
+ * written -- overwriting a binary that is currently open is exactly the
21
+ * ETXTBSY failure the guard exists to prevent.
22
+ *
23
+ * Anything else is an unrelated server: the install proceeds and just prints
24
+ * an informational note. When a running process's executable path cannot be
25
+ * determined at all (restricted /proc, PowerShell unavailable, ...) we
26
+ * deliberately classify it as NOT relevant and say so in the note, rather
27
+ * than falling back to the old global refusal -- a silent fallback to
28
+ * "refuse" would reinstate the original bug precisely in the constrained
29
+ * environments this fix exists for.
30
+ *
31
+ * isApraFleetRunning() itself is intentionally untouched: waitForApraFleetToStop()
32
+ * and uninstall.ts depend on its OS-global semantics.
33
+ */
34
+ import fs from 'node:fs';
35
+ import path from 'node:path';
36
+ import os from 'node:os';
37
+ import { execSync } from 'node:child_process';
38
+ import { isPidAlive } from '../utils/process-utils.js';
39
+ /** Data dir this process would use -- mirrors services/singleton.ts getFleetDir(). */
40
+ export function getInstallDataDir() {
41
+ return process.env.APRA_FLEET_DATA_DIR ?? path.join(os.homedir(), '.apra-fleet', 'data');
42
+ }
43
+ function runCapture(cmd) {
44
+ try {
45
+ return execSync(cmd, { encoding: 'utf-8', stdio: 'pipe' });
46
+ }
47
+ catch {
48
+ return null;
49
+ }
50
+ }
51
+ /**
52
+ * PID of a live server recorded in the data dir this install targets, or null.
53
+ * Read-only: unlike checkRunningInstance() this never deletes server.json.
54
+ */
55
+ export function liveInstancePidForDataDir() {
56
+ try {
57
+ const raw = fs.readFileSync(path.join(getInstallDataDir(), 'server.json'), 'utf8');
58
+ const info = JSON.parse(raw.toString());
59
+ if (!info || typeof info.pid !== 'number')
60
+ return null;
61
+ return isPidAlive(info.pid) ? info.pid : null;
62
+ }
63
+ catch {
64
+ return null;
65
+ }
66
+ }
67
+ /** Running apra-fleet processes (excluding this one) with their executable paths. */
68
+ export function getRunningApraFleetProcesses() {
69
+ const currentPid = process.pid;
70
+ if (process.platform === 'win32') {
71
+ const out = runCapture('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV') ?? '';
72
+ const pids = [];
73
+ for (const line of out.split('\n')) {
74
+ const match = line.match(/"apra-fleet\.exe","(\d+)"/);
75
+ if (match && Number(match[1]) !== currentPid)
76
+ pids.push(Number(match[1]));
77
+ }
78
+ if (pids.length === 0)
79
+ return [];
80
+ // Get-Process (no nested quoting, unlike a CIM -Filter) yields "<pid>|<path>".
81
+ const paths = new Map();
82
+ const psOut = runCapture('powershell -NoProfile -Command "Get-Process apra-fleet | ForEach-Object { $_.Id.ToString() + \'|\' + $_.Path }"') ?? '';
83
+ for (const line of psOut.split('\n')) {
84
+ const [pidText, ...rest] = line.trim().split('|');
85
+ const pid = Number(pidText);
86
+ const exePath = rest.join('|').trim();
87
+ if (Number.isFinite(pid) && pid > 0 && exePath)
88
+ paths.set(pid, exePath);
89
+ }
90
+ return pids.map(pid => ({ pid, exePath: paths.get(pid) ?? null }));
91
+ }
92
+ const out = runCapture('pgrep -x apra-fleet') ?? '';
93
+ const pids = out
94
+ .split('\n')
95
+ .map(l => l.trim())
96
+ .filter(l => l !== '')
97
+ .map(Number)
98
+ .filter(pid => Number.isFinite(pid) && pid > 0 && pid !== currentPid);
99
+ return pids.map(pid => {
100
+ // macOS `ps -o comm=` prints the full executable path; Linux needs /proc.
101
+ const cmd = process.platform === 'darwin'
102
+ ? `ps -p ${pid} -o comm=`
103
+ : `readlink -f /proc/${pid}/exe`;
104
+ const resolved = (runCapture(cmd) ?? '').trim();
105
+ return { pid, exePath: resolved === '' ? null : resolved };
106
+ });
107
+ }
108
+ /** True when `exePath` is the install prefix dir itself or a file underneath it. */
109
+ export function isUnderInstallPrefix(exePath, prefixDir) {
110
+ if (!exePath || !prefixDir)
111
+ return false;
112
+ let target = path.resolve(exePath);
113
+ let prefix = path.resolve(prefixDir);
114
+ if (process.platform === 'win32') {
115
+ target = target.toLowerCase();
116
+ prefix = prefix.toLowerCase();
117
+ }
118
+ if (target === prefix)
119
+ return true;
120
+ return target.startsWith(prefix.endsWith(path.sep) ? prefix : prefix + path.sep);
121
+ }
122
+ function describeProcesses(procs) {
123
+ if (procs.length === 0)
124
+ return 'a running apra-fleet process (pid unknown)';
125
+ return procs
126
+ .map(p => `pid ${p.pid} (${p.exePath ?? 'executable path could not be determined'})`)
127
+ .join(', ');
128
+ }
129
+ /**
130
+ * Decide whether the running apra-fleet server(s) are relevant to an install
131
+ * that writes its binary into `installPrefixDir`.
132
+ */
133
+ export function classifyRunningServer(installPrefixDir) {
134
+ const livePid = liveInstancePidForDataDir();
135
+ if (livePid !== null) {
136
+ return {
137
+ relevant: true,
138
+ reason: 'data-dir',
139
+ detail: `pid ${livePid} is recorded live in the data dir this install targets (${getInstallDataDir()})`,
140
+ };
141
+ }
142
+ const procs = getRunningApraFleetProcesses();
143
+ const inPrefix = procs.find(p => isUnderInstallPrefix(p.exePath, installPrefixDir));
144
+ if (inPrefix) {
145
+ return {
146
+ relevant: true,
147
+ reason: 'install-prefix',
148
+ detail: `pid ${inPrefix.pid} runs from ${inPrefix.exePath}, inside the install prefix being written (${installPrefixDir})`,
149
+ };
150
+ }
151
+ return { relevant: false, reason: null, detail: describeProcesses(procs) };
152
+ }
153
+ //# sourceMappingURL=install-guard.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"install-guard.js","sourceRoot":"","sources":["../../src/cli/install-guard.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,13 @@
1
1
  import { ProviderInstallConfig } from './config.js';
2
+ import { downloadAndExtractDolt, verifyDolt } from './dolt-install.js';
3
+ export interface DoltStepDeps {
4
+ downloadAndExtractDolt: typeof downloadAndExtractDolt;
5
+ verifyDolt: typeof verifyDolt;
6
+ }
7
+ /** Test-only: inject fakes for the dolt CLI install step's download/verify calls. */
8
+ export declare function _setDoltStepDeps(overrides: Partial<DoltStepDeps>): void;
9
+ /** Test-only: restore the real (non-mocked) dolt step dependencies. */
10
+ export declare function _resetDoltStepDeps(): void;
2
11
  /** Override isSea() result -- for tests only. Pass null to restore default. */
3
12
  export declare function _setSeaOverride(v: boolean | null): void;
4
13
  export declare function isSea(): boolean;
@@ -21,10 +30,24 @@ interface AssetManifest {
21
30
  fleetSkills: Record<string, string>;
22
31
  agents: Record<string, string>;
23
32
  workflows: Record<string, string>;
24
- autoSprintArgsSkill: Record<string, string>;
33
+ workflowRuntime?: Record<string, string>;
34
+ agentSchemas?: Record<string, string>;
35
+ builtinWorkflows?: Record<string, string>;
36
+ autoSprintArgsSkill?: Record<string, string>;
37
+ fleetSprintCliSkill?: Record<string, string>;
25
38
  }
26
- /** Inject a manifest for tests — avoids SEA asset extraction. Pass null to restore default. */
39
+ export declare function buildDevManifest(root: string): AssetManifest;
40
+ /** Inject a manifest for tests - avoids SEA asset extraction. Pass null to restore default. */
27
41
  export declare function _setManifestOverride(m: AssetManifest | null): void;
42
+ /**
43
+ * Test-only escape hatch to exercise the real buildDevManifest() (against the
44
+ * real filesystem, not the mocked node:fs used elsewhere in
45
+ * tests/install-workflows.test.ts) so regressions like apra-fleet-eft.19
46
+ * (dev-mode install omitting undici from the workflowRuntime bundle) are
47
+ * caught by a direct assertion on the generated manifest, not just on the
48
+ * mocked-fs runInstall() flow.
49
+ */
50
+ export declare function _buildDevManifestForTest(root: string): AssetManifest;
28
51
  /**
29
52
  * Recursively load every agent asset (role agents + _shared/ + schemas/) as
30
53
  * {relPath, content} pairs, relPath relative to the agents dir root.
@@ -37,7 +60,25 @@ export declare function loadAgentAssets(): Array<{
37
60
  export declare function pruneInvalidRules(allow: string[], providerName: string): string[];
38
61
  export declare function buildRequiredPerms(paths: ProviderInstallConfig): string[];
39
62
  export declare function isApraFleetRunning(): boolean;
40
- export declare function killApraFleet(): void;
63
+ export declare function killApraFleet(signal?: 'SIGTERM' | 'SIGKILL'): void;
64
+ export interface InstallForceTiming {
65
+ pollIntervalMs: number;
66
+ graceMs: number;
67
+ killGraceMs: number;
68
+ }
69
+ /** Test-only: override the poll/grace timing used by waitForApraFleetToStop(). Pass null to restore default. */
70
+ export declare function _setInstallForceTimingOverride(t: InstallForceTiming | null): void;
71
+ /**
72
+ * Wait for any non-installer apra-fleet process to exit after killApraFleet()
73
+ * sends SIGTERM. Polls isApraFleetRunning() over a grace window; if the
74
+ * process is still alive once the window elapses, escalates to SIGKILL and
75
+ * polls again over a second (shorter) window. Returns as soon as no
76
+ * non-installer apra-fleet process is detected, or once both windows have
77
+ * elapsed -- callers should not assume termination is guaranteed in the
78
+ * latter case (see apra-fleet-l7n.3 for surfacing that failure to the
79
+ * operator instead of asserting success).
80
+ */
81
+ export declare function waitForApraFleetToStop(): Promise<void>;
41
82
  /**
42
83
  * Write empty .ignore overlay files into a LOCAL agy member's workspace to block
43
84
  * the global apra-fleet MCP server and PM/fleet skills from loading inside that
@@ -1 +1 @@
1
- {"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/cli/install.ts"],"names":[],"mappings":"AAMA,OAAO,EASL,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAKrB,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAAsB;AAE9E,wBAAgB,KAAK,IAAI,OAAO,CAQ/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAe5C;AAkBD,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAuFD,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAA2B;AAW9F;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB7E;AA0GD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAGjF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAgBzE;AAwGD,wBAAgB,kBAAkB,IAAI,OAAO,CAoB5C;AAED,wBAAgB,aAAa,IAAI,IAAI,CAOpC;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAUlE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0b9D"}
1
+ {"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/cli/install.ts"],"names":[],"mappings":"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"}