@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
@@ -0,0 +1,572 @@
1
+ // apra-fleet-unw.15 -- typed error(s) local to the auto-sprint runner.
2
+ //
3
+ // SprintPlanRejectedError is sprint-specific (it is only ever thrown by
4
+ // runner.js's Plan phase) so it lives here rather than in
5
+ // packages/apra-fleet-workflow/src/workflow/errors.mjs, which is the
6
+ // generic, package-wide error taxonomy for agent()/command() failures.
7
+ // It still extends WorkflowError so callers that only know about the
8
+ // generic taxonomy (e.g. a future top-level sprint-status classifier) can
9
+ // catch `WorkflowError` and still see this failure.
10
+
11
+ import { WorkflowError } from '@apralabs/apra-fleet-workflow';
12
+
13
+ // ---------------------------------------------------------------------------
14
+ // Neutral VCS failure taxonomy (apra-fleet-647.1.3.1)
15
+ // ---------------------------------------------------------------------------
16
+ //
17
+ // The provider-agnostic vocabulary VCSModule.classifyFailure() emits, and the
18
+ // ONLY vocabulary downstream code is allowed to branch on. It deliberately
19
+ // contains no provider words: a caller decides what to do from `kind` alone,
20
+ // never by re-reading raw stderr and never by asking which provider produced
21
+ // it. Provider-specific detail (an Azure DevOps 'TF401019', a GitHub HTTP
22
+ // status) travels separately in `providerCode` as a DIAGNOSTIC, never as a
23
+ // control-flow input.
24
+ //
25
+ // AUTH_EXPIRED The presented credential is missing, stale or
26
+ // rejected as invalid. RE-PROVISIONING CAN FIX IT --
27
+ // this is the kind the one-shot provision_vcs_auth
28
+ // self-heal path exists for.
29
+ // AUTH_DENIED The identity was understood and refused: the
30
+ // principal lacks access. Re-minting the SAME
31
+ // credential cannot fix it; an operator must grant
32
+ // access.
33
+ // DIVERGED The remote moved / a non-fast-forward, unmerged or
34
+ // conflicted state. Never retried blindly -- under the
35
+ // single-writer stance this is proof the invariant is
36
+ // already broken.
37
+ // TRANSIENT A network / server / lock blip. The ONLY kind for
38
+ // which `retryable` is true.
39
+ // NO_REMOTE No remote is configured at all -- there is nothing
40
+ // to push or pull. Benign, not an error condition.
41
+ // EMPTY_REMOTE A remote IS configured but has never had anything
42
+ // pushed into it (apra-fleet-647.1.3.2, dolt provider
43
+ // only today -- Dolt's "no branches found in remote"
44
+ // Error 1105). Distinct from NO_REMOTE (nothing
45
+ // configured at all): benign, nothing to reconcile.
46
+ // REMOTE_UNREACHABLE A configured remote cannot be opened at all (a
47
+ // deleted directory behind a file:// remote, a dead
48
+ // path). Distinct from TRANSIENT: retrying cannot
49
+ // help, the target is gone, not busy.
50
+ // UNSUPPORTED_OPERATION The requested action is not implemented for this
51
+ // provider. A programming/config error; retrying and
52
+ // re-authenticating are both pointless.
53
+ // UNKNOWN Explicitly unrecognized. Never retried, never
54
+ // self-healed -- an unmatched stderr must surface, not
55
+ // be guessed at.
56
+ //
57
+ // `retryable` means exactly one thing: SAFE TO RE-RUN THE SAME COMMAND WITH NO
58
+ // REMEDIATION FIRST. It is therefore false for AUTH_EXPIRED even though the
59
+ // auth self-heal path does retry once -- that retry is only legal AFTER
60
+ // re-provisioning, which is remediation. REMOTE_UNREACHABLE is false for the
61
+ // same "retrying cannot help" reason.
62
+ export const VCS_FAILURE_KINDS = Object.freeze({
63
+ AUTH_EXPIRED: 'AUTH_EXPIRED',
64
+ AUTH_DENIED: 'AUTH_DENIED',
65
+ DIVERGED: 'DIVERGED',
66
+ TRANSIENT: 'TRANSIENT',
67
+ NO_REMOTE: 'NO_REMOTE',
68
+ EMPTY_REMOTE: 'EMPTY_REMOTE',
69
+ REMOTE_UNREACHABLE: 'REMOTE_UNREACHABLE',
70
+ UNSUPPORTED_OPERATION: 'UNSUPPORTED_OPERATION',
71
+ UNKNOWN: 'UNKNOWN',
72
+ });
73
+
74
+ /** The kinds that are safe to retry with no remediation -- TRANSIENT only.
75
+ * See the `retryable` note above before adding to this set. */
76
+ export const VCS_RETRYABLE_KINDS = Object.freeze(new Set([VCS_FAILURE_KINDS.TRANSIENT]));
77
+
78
+ /** The kinds that mean "the credential is the problem" (either half of the
79
+ * AUTH split), for callers that route both to the same remediation. */
80
+ export const VCS_AUTH_KINDS = Object.freeze(new Set([
81
+ VCS_FAILURE_KINDS.AUTH_EXPIRED,
82
+ VCS_FAILURE_KINDS.AUTH_DENIED,
83
+ ]));
84
+
85
+ /**
86
+ * Thrown when a sprint's Plan phase exhausts its planning rounds (3, per
87
+ * apra-fleet-unw.15) without the plan-reviewer returning an APPROVED
88
+ * verdict. The sprint MUST NEVER proceed to Develop with an unapproved
89
+ * plan -- this error is how that guarantee is enforced: it is not caught
90
+ * anywhere in the Plan phase, so it unwinds runWithContext()'s promise and
91
+ * fails the whole sprint run before any Doer dispatch occurs.
92
+ *
93
+ * @property {string|null} notes - the last plan-reviewer verdict's `notes`
94
+ * field (or a synthesized message if the reviewer never returned
95
+ * schema-valid output at all), carried through so a human/CI reading the
96
+ * failure knows exactly what was wrong with the plan.
97
+ */
98
+ export class SprintPlanRejectedError extends WorkflowError {
99
+ /**
100
+ * @param {string} message
101
+ * @param {{ notes?: string|null, cycle?: number, planningRounds?: number, details?: object, cause?: unknown }} [opts]
102
+ */
103
+ constructor(message, opts = {}) {
104
+ const { notes = null, cycle, planningRounds, details, cause } = opts;
105
+ super(message, {
106
+ code: 'SPRINT_PLAN_REJECTED',
107
+ details: { notes, cycle, planningRounds, ...details },
108
+ cause,
109
+ });
110
+ this.notes = notes;
111
+ }
112
+ }
113
+
114
+ /**
115
+ * apra-fleet-unw.17 (A5) -- thrown when the sprint's cycle loop detects N
116
+ * consecutive cycles (default 2, per the pm skill mandate cited in the
117
+ * issue text) with zero net change in the closed-bead count for the
118
+ * sprint's scope. Before this issue, a permanently blocked/orphaned
119
+ * in_progress bead (or a develop/review loop that keeps reopening and
120
+ * re-failing the same bead(s) without ever closing anything new) had no
121
+ * escape hatch other than burning every remaining cycle up to
122
+ * `max_cycles` -- this error aborts loudly and early instead, with the
123
+ * per-cycle closed-count history attached so a human/CI reading the
124
+ * failure can see exactly where progress stopped.
125
+ *
126
+ * Never caught inside runner.js's cycle loop -- it unwinds
127
+ * `runWithContext()`'s promise and fails the whole sprint run, the same
128
+ * way `SprintPlanRejectedError` does for an unapproved plan.
129
+ *
130
+ * @property {number} staleCycles - how many consecutive cycles showed zero progress
131
+ * @property {number[]} closedCountHistory - closed-bead count in scope, per cycle, in order
132
+ * @property {number} [highWaterClosedCount] - N9 (apra-fleet-unw2.7): the
133
+ * highest closed-bead count observed at any point this sprint (the
134
+ * high-water mark progress is measured against)
135
+ * @property {string[]} [thrashIds] - N9: bead ids reopened more than the
136
+ * reopen-thrash threshold this sprint, i.e. the beads most likely
137
+ * responsible for a close/reopen oscillation stall
138
+ */
139
+ export class StalledSprintError extends WorkflowError {
140
+ /**
141
+ * @param {string} message
142
+ * @param {{ staleCycles?: number, closedCountHistory?: number[], highWaterClosedCount?: number, thrashIds?: string[], cycle?: number, details?: object, cause?: unknown }} [opts]
143
+ */
144
+ constructor(message, opts = {}) {
145
+ const { staleCycles = null, closedCountHistory = [], highWaterClosedCount = null, thrashIds = [], cycle, details, cause } = opts;
146
+ super(message, {
147
+ code: 'SPRINT_STALLED',
148
+ details: { staleCycles, closedCountHistory, highWaterClosedCount, thrashIds, cycle, ...details },
149
+ cause,
150
+ });
151
+ this.staleCycles = staleCycles;
152
+ this.closedCountHistory = closedCountHistory;
153
+ this.highWaterClosedCount = highWaterClosedCount;
154
+ this.thrashIds = thrashIds;
155
+ }
156
+ }
157
+
158
+ /**
159
+ * apra-fleet-unw2.6 (N8) -- thrown when the reviewer persistently returns a
160
+ * self-contradictory verdict: `CHANGES_NEEDED` with BOTH `reopenIds` and
161
+ * `newTasks` empty. That combination is schema-legal but semantically
162
+ * meaningless -- `CHANGES_NEEDED` asserts more work is required, yet the
163
+ * verdict names nothing to reopen and proposes no new follow-up work, so
164
+ * there is nothing for the orchestrator to act on. Left unhandled, this
165
+ * "verdict" can never resolve to APPROVED and never produces a reopened/new
166
+ * bead either, so a cycle loop that keeps hitting it makes no closed-bead
167
+ * progress -- which apra-fleet-unw.17's stall-abort bookkeeping cannot tell
168
+ * apart from genuine no-progress, and can misreport an otherwise-finished
169
+ * sprint (every bead already closed) as `StalledSprintError`.
170
+ *
171
+ * The cycle loop retries the review dispatch exactly once when this
172
+ * contradiction is first seen (the reviewer may have been dispatched with
173
+ * stale/incomplete context); if the SAME contradiction repeats on the
174
+ * retry, this error is thrown instead of letting the round silently
175
+ * accumulate toward stall-abort. Never caught inside runner.js's cycle
176
+ * loop -- it unwinds `runWithContext()`'s promise and fails the whole
177
+ * sprint run, the same way `StalledSprintError`/`SprintPlanRejectedError` do.
178
+ *
179
+ * @property {number} cycle - the outer sprint cycle the violation occurred in
180
+ * @property {string|null} notes - the reviewer's own `notes` field from the
181
+ * contradictory verdict, carried through for a human/CI reading the failure
182
+ */
183
+ export class ReviewerContractViolationError extends WorkflowError {
184
+ /**
185
+ * @param {string} message
186
+ * @param {{ cycle?: number, notes?: string|null, details?: object, cause?: unknown }} [opts]
187
+ */
188
+ constructor(message, opts = {}) {
189
+ const { cycle, notes = null, details, cause } = opts;
190
+ super(message, {
191
+ code: 'REVIEWER_CONTRACT_VIOLATION',
192
+ details: { cycle, notes, ...details },
193
+ cause,
194
+ });
195
+ this.cycle = cycle;
196
+ this.notes = notes;
197
+ }
198
+ }
199
+
200
+ /**
201
+ * apra-fleet-eft.8.1 (Plan Part 3.1/3.3, risk 2) -- thrown when an
202
+ * orchestrator-bracketed git sync (G-pull / G-push) discovers that a member
203
+ * has DIVERGED from the shared sprint branch: a `git merge --ff-only` that
204
+ * could not fast-forward, an unmerged/conflicted `git pull --rebase`, or a
205
+ * `git push` still rejected as non-fast-forward AFTER the single bounded
206
+ * pull-rebase retry.
207
+ *
208
+ * Divergence is the hard, non-retryable failure class in the single-writer
209
+ * token-passing model: because the writer pushes and the next reader pulls,
210
+ * every intra-sprint merge is fast-forward BY CONSTRUCTION, so a non-FF state
211
+ * means the invariant is already broken. It MUST NEVER be auto-resolved or
212
+ * retried blindly -- the whole point of a distinct typed error (vs a generic
213
+ * CommandError) is that the classifier can tell "diverged -> abort" apart from
214
+ * "transient -> retry" and route the two differently.
215
+ *
216
+ * @property {string|null} member - the member whose checkout diverged
217
+ * @property {string|null} gitOutput - the raw git stderr/stdout that proved divergence
218
+ * @property {string|null} operation - which bracket step diverged
219
+ * ('pull' | 'push' | 'push-rebase')
220
+ */
221
+ export class GitDivergedError extends WorkflowError {
222
+ /**
223
+ * @param {string} message
224
+ * @param {{ member?: string|null, gitOutput?: string|null, operation?: string|null, details?: object, cause?: unknown }} [opts]
225
+ */
226
+ constructor(message, opts = {}) {
227
+ const { member = null, gitOutput = null, operation = null, details, cause } = opts;
228
+ super(message, {
229
+ code: 'GIT_DIVERGED',
230
+ details: { member, gitOutput, operation, ...details },
231
+ cause,
232
+ });
233
+ this.member = member;
234
+ this.gitOutput = gitOutput;
235
+ this.operation = operation;
236
+ }
237
+ }
238
+
239
+ /**
240
+ * apra-fleet-eft.8.1 -- thrown when an orchestrator-bracketed git sync
241
+ * (G-pull / G-push) fails for a reason that is NOT divergence and that
242
+ * SURVIVED the bounded transient-retry budget: a transient class failure
243
+ * (network unreachable, an index/ref lock) that kept failing after its
244
+ * allowed retries, or an unclassifiable git failure that must not be retried
245
+ * blindly.
246
+ *
247
+ * This is the counterpart to {@link GitDivergedError}: both extend
248
+ * WorkflowError and both carry the member and raw git output, but they are
249
+ * deliberately distinct types so a caller/test can assert the two failure
250
+ * classifications (transient-retry-exhausted vs diverged-abort) SEPARATELY,
251
+ * which is the crux of risk 2 in the plan.
252
+ *
253
+ * @property {string|null} member - the member whose sync failed
254
+ * @property {string|null} gitOutput - the raw git stderr/stdout of the failure
255
+ */
256
+ export class GitSyncError extends WorkflowError {
257
+ /**
258
+ * @param {string} message
259
+ * @param {{ member?: string|null, gitOutput?: string|null, details?: object, cause?: unknown }} [opts]
260
+ */
261
+ constructor(message, opts = {}) {
262
+ const { member = null, gitOutput = null, details, cause } = opts;
263
+ super(message, {
264
+ code: 'GIT_SYNC_FAILED',
265
+ details: { member, gitOutput, ...details },
266
+ cause,
267
+ });
268
+ this.member = member;
269
+ this.gitOutput = gitOutput;
270
+ }
271
+ }
272
+
273
+ /**
274
+ * apra-fleet-eft.9.1 (Plan Part 3.3) -- thrown when an orchestrator-bracketed
275
+ * DOLT sync (D-pull / D-push of the shared beads database) discovers a
276
+ * divergence that the fixed, mechanical conflict policy could NOT close: a
277
+ * `bd dolt pull` that reports a data/merge conflict outside a push-loser's
278
+ * reconcile, or a `bd dolt push` STILL rejected after the single bounded
279
+ * pull-then-repush reconcile.
280
+ *
281
+ * This is the Dolt counterpart of {@link GitDivergedError}. The beads-sync
282
+ * conflict policy is deliberately NOT per-conflict judgment: it is
283
+ * first-successful-pusher-wins, with ours/theirs decided mechanically by which
284
+ * clone is doing the resolving (the push loser reconciles by pulling the
285
+ * winner's state, then re-pushes). A divergence that outlives that one bounded
286
+ * reconcile is a hard, non-retryable failure -- surfacing it as a distinct
287
+ * typed error lets callers/tests tell "diverged -> abort" apart from
288
+ * "transient -> retry", exactly as the git brackets do.
289
+ *
290
+ * @property {string|null} member - the member whose beads clone diverged
291
+ * @property {string|null} doltOutput - the raw `bd dolt` stderr/stdout that proved divergence
292
+ * @property {string|null} operation - which bracket step diverged
293
+ * ('pull' | 'push' | 'push-reconcile')
294
+ */
295
+ export class DoltDivergedError extends WorkflowError {
296
+ /**
297
+ * @param {string} message
298
+ * @param {{ member?: string|null, doltOutput?: string|null, operation?: string|null, details?: object, cause?: unknown }} [opts]
299
+ */
300
+ constructor(message, opts = {}) {
301
+ const { member = null, doltOutput = null, operation = null, details, cause } = opts;
302
+ super(message, {
303
+ code: 'DOLT_DIVERGED',
304
+ details: { member, doltOutput, operation, ...details },
305
+ cause,
306
+ });
307
+ this.member = member;
308
+ this.doltOutput = doltOutput;
309
+ this.operation = operation;
310
+ }
311
+ }
312
+
313
+ /**
314
+ * apra-fleet-eft.9.1 (Plan Part 3.3) -- thrown when an orchestrator-bracketed
315
+ * DOLT sync (D-pull / D-push) fails for a reason that is NOT divergence and
316
+ * that SURVIVED the bounded transient-retry budget: a transient-class failure
317
+ * (network unreachable, a server/lock hiccup) that kept failing after its
318
+ * allowed retries, or an unclassifiable `bd dolt` failure that must not be
319
+ * retried blindly.
320
+ *
321
+ * The Dolt counterpart of {@link GitSyncError}: deliberately a distinct type
322
+ * from {@link DoltDivergedError} so a caller/test can assert the two failure
323
+ * classifications (transient-retry-exhausted vs diverged-abort) SEPARATELY.
324
+ *
325
+ * @property {string|null} member - the member whose beads sync failed
326
+ * @property {string|null} doltOutput - the raw `bd dolt` stderr/stdout of the failure
327
+ */
328
+ export class DoltSyncError extends WorkflowError {
329
+ /**
330
+ * @param {string} message
331
+ * @param {{ member?: string|null, doltOutput?: string|null, details?: object, cause?: unknown }} [opts]
332
+ */
333
+ constructor(message, opts = {}) {
334
+ const { member = null, doltOutput = null, details, cause } = opts;
335
+ super(message, {
336
+ code: 'DOLT_SYNC_FAILED',
337
+ details: { member, doltOutput, ...details },
338
+ cause,
339
+ });
340
+ this.member = member;
341
+ this.doltOutput = doltOutput;
342
+ }
343
+ }
344
+
345
+ // ---------------------------------------------------------------------------
346
+ // Non-retryable dispatch failures (stabilization Issue 43 / smoke rehearsal)
347
+ // ---------------------------------------------------------------------------
348
+ //
349
+ // An authentication or workspace-trust failure is deterministic: the member's
350
+ // credential/trust state does not change between attempts, so every retry
351
+ // burns a full dispatch budget to reproduce the identical failure (observed
352
+ // live: 5 planner retries x 15-minute interactive timeouts against an
353
+ // unauthenticated member = 75 wasted minutes for an error that was terminal
354
+ // at second zero). The fleet server already classifies these categories as
355
+ // non-retryable (src/utils/prompt-errors.ts isRetryable()); this mirrors
356
+ // that judgment on the engine side, keyed off the server's own error-message
357
+ // signatures since the message string was, until apra-fleet-391, all that
358
+ // crossed the dispatch boundary. execute-prompt.ts now also emits a
359
+ // structured `details.reason` ('auth' | 'workspace_not_trusted') on
360
+ // AgentDispatchError -- checked FIRST below since it can't be fooled by
361
+ // auth-like noise in an unrelated failure's message text; the regex remains
362
+ // as a fallback for older/mocked errors that only ever set `.message`.
363
+ const NON_RETRYABLE_DISPATCH_RE = /authentication failed|not logged in|workspace not trusted|has not been trusted/i;
364
+
365
+ /**
366
+ * True when a dispatch error can NEVER be fixed by retrying (auth /
367
+ * workspace-trust failures). Callers must abort their retry loop and surface
368
+ * the error immediately, with remediation left to the operator.
369
+ * @param {unknown} err
370
+ * @returns {boolean}
371
+ */
372
+ export function isNonRetryableDispatchError(err) {
373
+ const reason = err?.details?.reason;
374
+ if (reason === 'auth' || reason === 'workspace_not_trusted') return true;
375
+ return NON_RETRYABLE_DISPATCH_RE.test(String(err?.message ?? ''));
376
+ }
377
+
378
+ // apra-fleet-391: subset of NON_RETRYABLE_DISPATCH_RE that is specifically an
379
+ // LLM credential failure (as opposed to workspace-trust, which
380
+ // provision_llm_auth cannot fix -- that needs an operator to run `claude
381
+ // --dangerously-skip-permissions` or trust the folder interactively).
382
+ const AUTH_DISPATCH_RE = /authentication failed|not logged in/i;
383
+
384
+ /**
385
+ * True when a dispatch error is specifically an LLM auth/credential failure
386
+ * (not workspace-trust) -- the subset self-heal via provision_llm_auth can
387
+ * actually fix.
388
+ * @param {unknown} err
389
+ * @returns {boolean}
390
+ */
391
+ export function isAuthDispatchError(err) {
392
+ if (err?.details?.reason === 'auth') return true;
393
+ return AUTH_DISPATCH_RE.test(String(err?.message ?? ''));
394
+ }
395
+
396
+ // ---------------------------------------------------------------------------
397
+ // apra-fleet-04g.6 -- infrastructure dispatch failures (NOT a test verdict)
398
+ // ---------------------------------------------------------------------------
399
+ //
400
+ // execute-prompt.ts emits these structured `reason`s when the member CLI
401
+ // itself failed to deliver a parseable result envelope, as opposed to running
402
+ // a task to a real pass/fail conclusion:
403
+ // - 'empty_response' -- CLI exited 0 but produced no parseable output
404
+ // (died silently mid-turn without printing its
405
+ // result envelope; observed live cycle C4).
406
+ // - 'dispatch_failed' -- strategy.execCommand threw, e.g. an
407
+ // inactivity timeout kill or an SSH/transport
408
+ // failure (observed live cycle C5: a 3600000ms
409
+ // inactivity timeout).
410
+ // - 'orphan_recovery_timeout'-- the SSH channel was lost while the CLI was
411
+ // still running and it was still alive after
412
+ // the recovery window; the pid was killed with
413
+ // no result recovered.
414
+ // - 'stalled' -- a confirmed stall (no member-side progress
415
+ // for the whole stall threshold) killed the
416
+ // remote pid and aborted the in-flight dispatch
417
+ // (apra-fleet-3c9.1). Like the others, no test
418
+ // verdict was ever produced.
419
+ //
420
+ // For an integ-test-runner dispatch, all of these mean "no test verdict was
421
+ // ever produced" -- the run never reported pass or fail. Treating them as a
422
+ // genuine passed:false FAIL (the pre-04g.6 behavior) is a false negative: it
423
+ // records a test failure that never happened and blocks the sprint's confidence
424
+ // check on an infra fault. Callers use this classifier to (a) retry once via a
425
+ // session resume and (b) failing that, record the cycle as INCONCLUSIVE rather
426
+ // than a test FAIL -- exactly as the part-2 stale-evidence path already does.
427
+ const INFRA_DISPATCH_REASONS = new Set(['empty_response', 'dispatch_failed', 'orphan_recovery_timeout', 'stalled']);
428
+
429
+ /**
430
+ * True when a dispatch error is an INFRASTRUCTURE failure (the member CLI never
431
+ * delivered a parseable result envelope) rather than a genuine task
432
+ * pass/fail conclusion -- keyed off the server's structured `details.reason`.
433
+ * @param {unknown} err
434
+ * @returns {boolean}
435
+ */
436
+ export function isInfraDispatchFailure(err) {
437
+ return INFRA_DISPATCH_REASONS.has(err?.details?.reason);
438
+ }
439
+
440
+ // ---------------------------------------------------------------------------
441
+ // apra-fleet-eft.75.2 -- sprint-launch machine-local pidfile mutex
442
+ // ---------------------------------------------------------------------------
443
+
444
+ /**
445
+ * Thrown by sprint-lock.mjs's acquireSprintLock() when a duplicate `auto-
446
+ * sprint` engine start is attempted for the SAME sprint (branch+members)
447
+ * while a live process already holds that sprint's pidfile lock, OR when a
448
+ * concurrent process wins a stale-pidfile reclaim race. Root incident
449
+ * (apra-fleet-eft.75): a duplicate concurrent runner was previously stopped
450
+ * only by an ACCIDENTAL viewer-port-8080 collision (itself trivially avoided
451
+ * with a different --viewer-port) -- this is the explicit, always-on mutex
452
+ * that replaces that accident with a deliberate, named guard. Never caught
453
+ * inside runner.js -- it unwinds main()'s promise and fails the whole sprint
454
+ * launch before any fleet dispatch occurs.
455
+ *
456
+ * @property {string|null} branch
457
+ * @property {string[]|null} members
458
+ * @property {number|null} existingPid - the live pid currently holding the lock (when known)
459
+ */
460
+ export class SprintLockHeldError extends WorkflowError {
461
+ /**
462
+ * @param {string} message
463
+ * @param {{ branch?: string|null, members?: string[]|null, existingPid?: number|null, details?: object, cause?: unknown }} [opts]
464
+ */
465
+ constructor(message, opts = {}) {
466
+ const { branch = null, members = null, existingPid = null, details, cause } = opts;
467
+ super(message, {
468
+ code: 'SPRINT_LOCK_HELD',
469
+ details: { branch, members, existingPid, ...details },
470
+ cause,
471
+ });
472
+ this.branch = branch;
473
+ this.members = members;
474
+ this.existingPid = existingPid;
475
+ }
476
+ }
477
+
478
+ /**
479
+ * apra-fleet-9ta.4 -- thrown when the Plan phase exhausts its planning
480
+ * rounds and the LAST round's plan-reviewer verdict was itself synthesized
481
+ * from an infrastructure dispatch failure (schema-repair exhaustion, a
482
+ * dropped transport, etc -- see `dispatchFailed` on the synthesized
483
+ * CHANGES_NEEDED verdict), never a genuine LLM verdict.
484
+ *
485
+ * Before this error existed, that same exhaustion threw
486
+ * SprintPlanRejectedError -- indistinguishable from a REAL plan rejection by
487
+ * the reviewer -- which misdiagnoses "the plan-reviewer's dispatch channel
488
+ * never came back" as "the reviewer looked at the plan and rejected it".
489
+ * The plan was never actually reviewed, so this is a distinct, infra-flavored
490
+ * failure a human/CI should treat as "retry the sprint", not "fix the plan".
491
+ *
492
+ * Deliberately NOT one of isTypedAbortError()'s curated abort classes (see
493
+ * runner.js): a dispatch-channel/transport blip is recoverable by simply
494
+ * re-running the sprint, unlike a genuine stall/budget/reviewer-contract
495
+ * abort or an unmergeable divergence, so it earns a terminal record (via
496
+ * isTerminalSprintFailure()'s blanket WorkflowError match) but not the
497
+ * push + [ABORTED] PR a real abort gets.
498
+ *
499
+ * @property {string|null} notes - the last plan-reviewer verdict's `notes`
500
+ * field (the synthesized dispatch-failure message), carried through for a
501
+ * human/CI reading the failure
502
+ */
503
+ export class PlanReviewDispatchFailedError extends WorkflowError {
504
+ /**
505
+ * @param {string} message
506
+ * @param {{ notes?: string|null, cycle?: number, planningRounds?: number, details?: object, cause?: unknown }} [opts]
507
+ */
508
+ constructor(message, opts = {}) {
509
+ const { notes = null, cycle, planningRounds, details, cause } = opts;
510
+ super(message, {
511
+ code: 'PLAN_REVIEW_DISPATCH_FAILED',
512
+ details: { notes, cycle, planningRounds, ...details },
513
+ cause,
514
+ });
515
+ this.notes = notes;
516
+ }
517
+ }
518
+
519
+ // ---------------------------------------------------------------------------
520
+ // apra-fleet-6z8.3 -- post-dispatch sync failure (NOT a dispatch failure)
521
+ // ---------------------------------------------------------------------------
522
+
523
+ /**
524
+ * Thrown by withGitSync when the agent dispatch COMPLETED successfully but the
525
+ * bracket's post-dispatch sync teardown (G-push / D-push) failed, and retrying
526
+ * just that sync step did not recover it.
527
+ *
528
+ * Why it needs its own type (apra-fleet-6z8, Symptom 2): withGitSync wraps the
529
+ * pre-dispatch pull, the LLM turn, and the post-dispatch sync in ONE bracket,
530
+ * so a DoltSyncError thrown by doltPushGuarded propagated out of the whole
531
+ * bracket. The Planner's PLANNER_DISPATCH_RETRY_DELAYS_MS ladder only saw "the
532
+ * bracket threw" and called dispatchPlannerOnce() again -- redispatching a
533
+ * brand-new Planner LLM turn even though the previous turn's output was already
534
+ * safely committed in the member's local beads clone, purely because an
535
+ * unrelated push step (e.g. missing VCS credentials) failed. Retry callers MUST
536
+ * treat this error as "do not redispatch": the turn already happened.
537
+ *
538
+ * @property {string|null} member - the member whose post-dispatch sync failed
539
+ * @property {unknown} dispatchResult - the COMPLETED dispatch's result, preserved
540
+ * so a caller that can proceed without the sync still has the turn's output
541
+ * @property {number} syncAttempts - how many times the sync step was attempted
542
+ */
543
+ export class PostDispatchSyncError extends WorkflowError {
544
+ /**
545
+ * @param {string} message
546
+ * @param {{ member?: string|null, dispatchResult?: unknown, syncAttempts?: number, details?: object, cause?: unknown }} [opts]
547
+ */
548
+ constructor(message, opts = {}) {
549
+ const { member = null, dispatchResult = undefined, syncAttempts = 1, details, cause } = opts;
550
+ super(message, {
551
+ code: 'POST_DISPATCH_SYNC_FAILED',
552
+ details: { member, syncAttempts, ...details },
553
+ cause,
554
+ });
555
+ this.member = member;
556
+ this.dispatchResult = dispatchResult;
557
+ this.syncAttempts = syncAttempts;
558
+ }
559
+ }
560
+
561
+ /**
562
+ * True when an error means "a COMPLETED dispatch's post-step sync failed" --
563
+ * i.e. the LLM turn itself already succeeded and re-running it would duplicate
564
+ * real work (duplicate beads writes, duplicate commits). A retry caller must
565
+ * NOT redispatch on this; the sync step has already been retried on its own
566
+ * inside withGitSync (apra-fleet-6z8.3).
567
+ * @param {unknown} err
568
+ * @returns {boolean}
569
+ */
570
+ export function isPostDispatchSyncFailure(err) {
571
+ return err instanceof PostDispatchSyncError;
572
+ }