@apralabs/apra-fleet 0.3.6 → 0.4.1

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 (826) hide show
  1. package/README.md +378 -252
  2. package/dist/agents/backlog-groomer.md +303 -0
  3. package/dist/agents/ci-watcher.md +13 -1
  4. package/dist/agents/deployer.md +66 -13
  5. package/dist/agents/doer.md +67 -8
  6. package/dist/agents/harvester.md +22 -3
  7. package/dist/agents/integ-test-runner.md +166 -60
  8. package/dist/agents/kb-reconciler.md +216 -0
  9. package/dist/agents/plan-reviewer.md +88 -18
  10. package/dist/agents/planner.md +182 -19
  11. package/dist/agents/regression-test-runner.md +234 -0
  12. package/dist/agents/reviewer.md +125 -9
  13. package/dist/agents/schemas/backlog-groomer-input.json +35 -0
  14. package/dist/agents/schemas/backlog-groomer-output.json +164 -0
  15. package/dist/agents/schemas/doer-output.json +63 -3
  16. package/dist/agents/schemas/harvester-output.json +59 -2
  17. package/dist/agents/schemas/integ-test-runner-output.json +34 -0
  18. package/dist/agents/schemas/kb-reconciler-output.json +87 -0
  19. package/dist/agents/schemas/planner-output.json +65 -0
  20. package/dist/agents/schemas/regression-test-runner-input.json +15 -0
  21. package/dist/agents/schemas/regression-test-runner-output.json +50 -0
  22. package/dist/agents/schemas/reviewer-output.json +108 -7
  23. package/dist/cli/agent-transform.d.ts +1 -0
  24. package/dist/cli/agent-transform.d.ts.map +1 -1
  25. package/dist/cli/agent-transform.js +77 -0
  26. package/dist/cli/agent-transform.js.map +1 -1
  27. package/dist/cli/auth.d.ts +3 -0
  28. package/dist/cli/auth.d.ts.map +1 -1
  29. package/dist/cli/auth.js +181 -5
  30. package/dist/cli/auth.js.map +1 -1
  31. package/dist/cli/config.d.ts +5 -1
  32. package/dist/cli/config.d.ts.map +1 -1
  33. package/dist/cli/config.js +7 -1
  34. package/dist/cli/config.js.map +1 -1
  35. package/dist/cli/dolt-install.d.ts +91 -0
  36. package/dist/cli/dolt-install.d.ts.map +1 -0
  37. package/dist/cli/dolt-install.js +334 -0
  38. package/dist/cli/dolt-install.js.map +1 -0
  39. package/dist/cli/install-guard.d.ts +29 -0
  40. package/dist/cli/install-guard.d.ts.map +1 -0
  41. package/dist/cli/install-guard.js +153 -0
  42. package/dist/cli/install-guard.js.map +1 -0
  43. package/dist/cli/install.d.ts +45 -3
  44. package/dist/cli/install.d.ts.map +1 -1
  45. package/dist/cli/install.js +736 -109
  46. package/dist/cli/install.js.map +1 -1
  47. package/dist/cli/join.d.ts +12 -0
  48. package/dist/cli/join.d.ts.map +1 -0
  49. package/dist/cli/join.js +87 -0
  50. package/dist/cli/join.js.map +1 -0
  51. package/dist/cli/kb-commit.d.ts +12 -0
  52. package/dist/cli/kb-commit.d.ts.map +1 -0
  53. package/dist/cli/kb-commit.js +53 -0
  54. package/dist/cli/kb-commit.js.map +1 -0
  55. package/dist/cli/kb-directives.d.ts +17 -0
  56. package/dist/cli/kb-directives.d.ts.map +1 -0
  57. package/dist/cli/kb-directives.js +146 -0
  58. package/dist/cli/kb-directives.js.map +1 -0
  59. package/dist/cli/kb-import.d.ts +13 -0
  60. package/dist/cli/kb-import.d.ts.map +1 -0
  61. package/dist/cli/kb-import.js +56 -0
  62. package/dist/cli/kb-import.js.map +1 -0
  63. package/dist/cli/register-member.d.ts +2 -0
  64. package/dist/cli/register-member.d.ts.map +1 -0
  65. package/dist/cli/register-member.js +193 -0
  66. package/dist/cli/register-member.js.map +1 -0
  67. package/dist/cli/restart.d.ts +2 -0
  68. package/dist/cli/restart.d.ts.map +1 -0
  69. package/dist/cli/restart.js +7 -0
  70. package/dist/cli/restart.js.map +1 -0
  71. package/dist/cli/spoke.d.ts +35 -0
  72. package/dist/cli/spoke.d.ts.map +1 -0
  73. package/dist/cli/spoke.js +212 -0
  74. package/dist/cli/spoke.js.map +1 -0
  75. package/dist/cli/start.d.ts +2 -0
  76. package/dist/cli/start.d.ts.map +1 -0
  77. package/dist/cli/start.js +92 -0
  78. package/dist/cli/start.js.map +1 -0
  79. package/dist/cli/status.d.ts +2 -0
  80. package/dist/cli/status.d.ts.map +1 -0
  81. package/dist/cli/status.js +83 -0
  82. package/dist/cli/status.js.map +1 -0
  83. package/dist/cli/stop.d.ts +2 -0
  84. package/dist/cli/stop.d.ts.map +1 -0
  85. package/dist/cli/stop.js +51 -0
  86. package/dist/cli/stop.js.map +1 -0
  87. package/dist/cli/uninstall.d.ts.map +1 -1
  88. package/dist/cli/uninstall.js +120 -9
  89. package/dist/cli/uninstall.js.map +1 -1
  90. package/dist/cli/update.d.ts.map +1 -1
  91. package/dist/cli/update.js +10 -1
  92. package/dist/cli/update.js.map +1 -1
  93. package/dist/cli/watch.d.ts +53 -4
  94. package/dist/cli/watch.d.ts.map +1 -1
  95. package/dist/cli/watch.js +118 -17
  96. package/dist/cli/watch.js.map +1 -1
  97. package/dist/cli/workflow-assets.d.ts +37 -0
  98. package/dist/cli/workflow-assets.d.ts.map +1 -0
  99. package/dist/cli/workflow-assets.js +144 -0
  100. package/dist/cli/workflow-assets.js.map +1 -0
  101. package/dist/cli/workflow.d.ts +75 -0
  102. package/dist/cli/workflow.d.ts.map +1 -0
  103. package/dist/cli/workflow.js +397 -0
  104. package/dist/cli/workflow.js.map +1 -0
  105. package/dist/commands/kb-server.d.ts +8 -0
  106. package/dist/commands/kb-server.d.ts.map +1 -0
  107. package/dist/commands/kb-server.js +221 -0
  108. package/dist/commands/kb-server.js.map +1 -0
  109. package/dist/hub-service/activity.d.ts +30 -0
  110. package/dist/hub-service/activity.d.ts.map +1 -0
  111. package/dist/hub-service/activity.js +20 -0
  112. package/dist/hub-service/activity.js.map +1 -0
  113. package/dist/hub-service/audit-log.d.ts +19 -0
  114. package/dist/hub-service/audit-log.d.ts.map +1 -0
  115. package/dist/hub-service/audit-log.js +13 -0
  116. package/dist/hub-service/audit-log.js.map +1 -0
  117. package/dist/hub-service/db/pool.d.ts +19 -0
  118. package/dist/hub-service/db/pool.d.ts.map +1 -0
  119. package/dist/hub-service/db/pool.js +53 -0
  120. package/dist/hub-service/db/pool.js.map +1 -0
  121. package/dist/hub-service/enrollment.d.ts +29 -0
  122. package/dist/hub-service/enrollment.d.ts.map +1 -0
  123. package/dist/hub-service/enrollment.js +48 -0
  124. package/dist/hub-service/enrollment.js.map +1 -0
  125. package/dist/hub-service/envelope-routes.d.ts +46 -0
  126. package/dist/hub-service/envelope-routes.d.ts.map +1 -0
  127. package/dist/hub-service/envelope-routes.js +94 -0
  128. package/dist/hub-service/envelope-routes.js.map +1 -0
  129. package/dist/hub-service/handlers/installers.d.ts +14 -0
  130. package/dist/hub-service/handlers/installers.d.ts.map +1 -0
  131. package/dist/hub-service/handlers/installers.js +8 -0
  132. package/dist/hub-service/handlers/installers.js.map +1 -0
  133. package/dist/hub-service/http-server.d.ts +31 -0
  134. package/dist/hub-service/http-server.d.ts.map +1 -0
  135. package/dist/hub-service/http-server.js +711 -0
  136. package/dist/hub-service/http-server.js.map +1 -0
  137. package/dist/hub-service/hub-jwt.d.ts +30 -0
  138. package/dist/hub-service/hub-jwt.d.ts.map +1 -0
  139. package/dist/hub-service/hub-jwt.js +105 -0
  140. package/dist/hub-service/hub-jwt.js.map +1 -0
  141. package/dist/hub-service/jwt-revocation.d.ts +20 -0
  142. package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
  143. package/dist/hub-service/jwt-revocation.js +18 -0
  144. package/dist/hub-service/jwt-revocation.js.map +1 -0
  145. package/dist/hub-service/machines.d.ts +16 -0
  146. package/dist/hub-service/machines.d.ts.map +1 -0
  147. package/dist/hub-service/machines.js +14 -0
  148. package/dist/hub-service/machines.js.map +1 -0
  149. package/dist/hub-service/main.d.ts +3 -0
  150. package/dist/hub-service/main.d.ts.map +1 -0
  151. package/dist/hub-service/main.js +64 -0
  152. package/dist/hub-service/main.js.map +1 -0
  153. package/dist/hub-service/member-tokens.d.ts +11 -0
  154. package/dist/hub-service/member-tokens.d.ts.map +1 -0
  155. package/dist/hub-service/member-tokens.js +49 -0
  156. package/dist/hub-service/member-tokens.js.map +1 -0
  157. package/dist/hub-service/member-view.d.ts +20 -0
  158. package/dist/hub-service/member-view.d.ts.map +1 -0
  159. package/dist/hub-service/member-view.js +76 -0
  160. package/dist/hub-service/member-view.js.map +1 -0
  161. package/dist/hub-service/members.d.ts +44 -0
  162. package/dist/hub-service/members.d.ts.map +1 -0
  163. package/dist/hub-service/members.js +25 -0
  164. package/dist/hub-service/members.js.map +1 -0
  165. package/dist/hub-service/presence.d.ts +40 -0
  166. package/dist/hub-service/presence.d.ts.map +1 -0
  167. package/dist/hub-service/presence.js +44 -0
  168. package/dist/hub-service/presence.js.map +1 -0
  169. package/dist/hub-service/project-view.d.ts +12 -0
  170. package/dist/hub-service/project-view.d.ts.map +1 -0
  171. package/dist/hub-service/project-view.js +34 -0
  172. package/dist/hub-service/project-view.js.map +1 -0
  173. package/dist/hub-service/projects.d.ts +48 -0
  174. package/dist/hub-service/projects.d.ts.map +1 -0
  175. package/dist/hub-service/projects.js +80 -0
  176. package/dist/hub-service/projects.js.map +1 -0
  177. package/dist/hub-service/relay-queue.d.ts +115 -0
  178. package/dist/hub-service/relay-queue.d.ts.map +1 -0
  179. package/dist/hub-service/relay-queue.js +148 -0
  180. package/dist/hub-service/relay-queue.js.map +1 -0
  181. package/dist/hub-service/session-jwt.d.ts +10 -0
  182. package/dist/hub-service/session-jwt.d.ts.map +1 -0
  183. package/dist/hub-service/session-jwt.js +69 -0
  184. package/dist/hub-service/session-jwt.js.map +1 -0
  185. package/dist/hub-service/usage.d.ts +40 -0
  186. package/dist/hub-service/usage.d.ts.map +1 -0
  187. package/dist/hub-service/usage.js +25 -0
  188. package/dist/hub-service/usage.js.map +1 -0
  189. package/dist/hub-service/users.d.ts +56 -0
  190. package/dist/hub-service/users.d.ts.map +1 -0
  191. package/dist/hub-service/users.js +72 -0
  192. package/dist/hub-service/users.js.map +1 -0
  193. package/dist/hub-service/workspaces.d.ts +20 -0
  194. package/dist/hub-service/workspaces.d.ts.map +1 -0
  195. package/dist/hub-service/workspaces.js +10 -0
  196. package/dist/hub-service/workspaces.js.map +1 -0
  197. package/dist/index.js +254 -132
  198. package/dist/index.js.map +1 -1
  199. package/dist/os/linux.d.ts +14 -0
  200. package/dist/os/linux.d.ts.map +1 -1
  201. package/dist/os/linux.js +80 -4
  202. package/dist/os/linux.js.map +1 -1
  203. package/dist/os/os-commands.d.ts +15 -0
  204. package/dist/os/os-commands.d.ts.map +1 -1
  205. package/dist/os/windows.d.ts +36 -0
  206. package/dist/os/windows.d.ts.map +1 -1
  207. package/dist/os/windows.js +74 -18
  208. package/dist/os/windows.js.map +1 -1
  209. package/dist/paths.d.ts +23 -0
  210. package/dist/paths.d.ts.map +1 -1
  211. package/dist/paths.js +29 -0
  212. package/dist/paths.js.map +1 -1
  213. package/dist/providers/agy.d.ts +20 -2
  214. package/dist/providers/agy.d.ts.map +1 -1
  215. package/dist/providers/agy.js +259 -21
  216. package/dist/providers/agy.js.map +1 -1
  217. package/dist/providers/claude.d.ts +16 -2
  218. package/dist/providers/claude.d.ts.map +1 -1
  219. package/dist/providers/claude.js +283 -16
  220. package/dist/providers/claude.js.map +1 -1
  221. package/dist/providers/codex.d.ts +13 -2
  222. package/dist/providers/codex.d.ts.map +1 -1
  223. package/dist/providers/codex.js +36 -6
  224. package/dist/providers/codex.js.map +1 -1
  225. package/dist/providers/copilot.d.ts +13 -2
  226. package/dist/providers/copilot.d.ts.map +1 -1
  227. package/dist/providers/copilot.js +34 -7
  228. package/dist/providers/copilot.js.map +1 -1
  229. package/dist/providers/email/headers.d.ts +15 -0
  230. package/dist/providers/email/headers.d.ts.map +1 -0
  231. package/dist/providers/email/headers.js +42 -0
  232. package/dist/providers/email/headers.js.map +1 -0
  233. package/dist/providers/email/index.d.ts +18 -0
  234. package/dist/providers/email/index.d.ts.map +1 -0
  235. package/dist/providers/email/index.js +60 -0
  236. package/dist/providers/email/index.js.map +1 -0
  237. package/dist/providers/email/provider.d.ts +49 -0
  238. package/dist/providers/email/provider.d.ts.map +1 -0
  239. package/dist/providers/email/provider.js +2 -0
  240. package/dist/providers/email/provider.js.map +1 -0
  241. package/dist/providers/email/sendgrid.d.ts +12 -0
  242. package/dist/providers/email/sendgrid.d.ts.map +1 -0
  243. package/dist/providers/email/sendgrid.js +67 -0
  244. package/dist/providers/email/sendgrid.js.map +1 -0
  245. package/dist/providers/email/smtp.d.ts +65 -0
  246. package/dist/providers/email/smtp.d.ts.map +1 -0
  247. package/dist/providers/email/smtp.js +373 -0
  248. package/dist/providers/email/smtp.js.map +1 -0
  249. package/dist/providers/gemini.d.ts +13 -2
  250. package/dist/providers/gemini.d.ts.map +1 -1
  251. package/dist/providers/gemini.js +49 -5
  252. package/dist/providers/gemini.js.map +1 -1
  253. package/dist/providers/index.d.ts +1 -0
  254. package/dist/providers/index.d.ts.map +1 -1
  255. package/dist/providers/index.js +3 -0
  256. package/dist/providers/index.js.map +1 -1
  257. package/dist/providers/none.d.ts +61 -0
  258. package/dist/providers/none.d.ts.map +1 -0
  259. package/dist/providers/none.js +124 -0
  260. package/dist/providers/none.js.map +1 -0
  261. package/dist/providers/opencode.d.ts +14 -2
  262. package/dist/providers/opencode.d.ts.map +1 -1
  263. package/dist/providers/opencode.js +104 -4
  264. package/dist/providers/opencode.js.map +1 -1
  265. package/dist/providers/provider.d.ts +156 -1
  266. package/dist/providers/provider.d.ts.map +1 -1
  267. package/dist/providers/provider.js +54 -0
  268. package/dist/providers/provider.js.map +1 -1
  269. package/dist/services/agent-provisioner.d.ts +3 -3
  270. package/dist/services/agent-provisioner.d.ts.map +1 -1
  271. package/dist/services/agent-provisioner.js +11 -7
  272. package/dist/services/agent-provisioner.js.map +1 -1
  273. package/dist/services/auth-socket.d.ts.map +1 -1
  274. package/dist/services/auth-socket.js +2 -0
  275. package/dist/services/auth-socket.js.map +1 -1
  276. package/dist/services/budget-awareness.d.ts +130 -0
  277. package/dist/services/budget-awareness.d.ts.map +1 -0
  278. package/dist/services/budget-awareness.js +129 -0
  279. package/dist/services/budget-awareness.js.map +1 -0
  280. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  281. package/dist/services/cloud/lifecycle.js +3 -0
  282. package/dist/services/cloud/lifecycle.js.map +1 -1
  283. package/dist/services/cloud/task-wrapper.d.ts +18 -0
  284. package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
  285. package/dist/services/cloud/task-wrapper.js +157 -0
  286. package/dist/services/cloud/task-wrapper.js.map +1 -1
  287. package/dist/services/cloud-sync.d.ts +35 -0
  288. package/dist/services/cloud-sync.d.ts.map +1 -0
  289. package/dist/services/cloud-sync.js +90 -0
  290. package/dist/services/cloud-sync.js.map +1 -0
  291. package/dist/services/context-admission.d.ts +82 -0
  292. package/dist/services/context-admission.d.ts.map +1 -0
  293. package/dist/services/context-admission.js +136 -0
  294. package/dist/services/context-admission.js.map +1 -0
  295. package/dist/services/event-bus.d.ts +27 -0
  296. package/dist/services/event-bus.d.ts.map +1 -0
  297. package/dist/services/event-bus.js +20 -0
  298. package/dist/services/event-bus.js.map +1 -0
  299. package/dist/services/file-chunker.d.ts +38 -0
  300. package/dist/services/file-chunker.d.ts.map +1 -0
  301. package/dist/services/file-chunker.js +63 -0
  302. package/dist/services/file-chunker.js.map +1 -0
  303. package/dist/services/file-transfer-relay.d.ts +55 -0
  304. package/dist/services/file-transfer-relay.d.ts.map +1 -0
  305. package/dist/services/file-transfer-relay.js +115 -0
  306. package/dist/services/file-transfer-relay.js.map +1 -0
  307. package/dist/services/github-app.d.ts.map +1 -1
  308. package/dist/services/github-app.js +12 -2
  309. package/dist/services/github-app.js.map +1 -1
  310. package/dist/services/http-transport.d.ts +25 -0
  311. package/dist/services/http-transport.d.ts.map +1 -0
  312. package/dist/services/http-transport.js +371 -0
  313. package/dist/services/http-transport.js.map +1 -0
  314. package/dist/services/hub-client.d.ts +69 -0
  315. package/dist/services/hub-client.d.ts.map +1 -0
  316. package/dist/services/hub-client.js +217 -0
  317. package/dist/services/hub-client.js.map +1 -0
  318. package/dist/services/jwt.d.ts +17 -0
  319. package/dist/services/jwt.d.ts.map +1 -0
  320. package/dist/services/jwt.js +70 -0
  321. package/dist/services/jwt.js.map +1 -0
  322. package/dist/services/knowledge/audn.d.ts +37 -0
  323. package/dist/services/knowledge/audn.d.ts.map +1 -0
  324. package/dist/services/knowledge/audn.js +219 -0
  325. package/dist/services/knowledge/audn.js.map +1 -0
  326. package/dist/services/knowledge/file-hash.d.ts +11 -0
  327. package/dist/services/knowledge/file-hash.d.ts.map +1 -0
  328. package/dist/services/knowledge/file-hash.js +123 -0
  329. package/dist/services/knowledge/file-hash.js.map +1 -0
  330. package/dist/services/knowledge/http-provider.d.ts +46 -0
  331. package/dist/services/knowledge/http-provider.d.ts.map +1 -0
  332. package/dist/services/knowledge/http-provider.js +254 -0
  333. package/dist/services/knowledge/http-provider.js.map +1 -0
  334. package/dist/services/knowledge/kb-providers.d.ts +15 -0
  335. package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
  336. package/dist/services/knowledge/kb-providers.js +92 -0
  337. package/dist/services/knowledge/kb-providers.js.map +1 -0
  338. package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
  339. package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
  340. package/dist/services/knowledge/kb-scope-input.js +11 -0
  341. package/dist/services/knowledge/kb-scope-input.js.map +1 -0
  342. package/dist/services/knowledge/kb-service.d.ts +3 -0
  343. package/dist/services/knowledge/kb-service.d.ts.map +1 -0
  344. package/dist/services/knowledge/kb-service.js +2 -0
  345. package/dist/services/knowledge/kb-service.js.map +1 -0
  346. package/dist/services/knowledge/path-validation.d.ts +2 -0
  347. package/dist/services/knowledge/path-validation.d.ts.map +1 -0
  348. package/dist/services/knowledge/path-validation.js +13 -0
  349. package/dist/services/knowledge/path-validation.js.map +1 -0
  350. package/dist/services/knowledge/pre-init.d.ts +14 -0
  351. package/dist/services/knowledge/pre-init.d.ts.map +1 -0
  352. package/dist/services/knowledge/pre-init.js +147 -0
  353. package/dist/services/knowledge/pre-init.js.map +1 -0
  354. package/dist/services/knowledge/project-slug.d.ts +2 -0
  355. package/dist/services/knowledge/project-slug.d.ts.map +1 -0
  356. package/dist/services/knowledge/project-slug.js +49 -0
  357. package/dist/services/knowledge/project-slug.js.map +1 -0
  358. package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
  359. package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
  360. package/dist/services/knowledge/sqlite-provider.js +1646 -0
  361. package/dist/services/knowledge/sqlite-provider.js.map +1 -0
  362. package/dist/services/knowledge/types.d.ts +163 -0
  363. package/dist/services/knowledge/types.d.ts.map +1 -0
  364. package/dist/services/knowledge/types.js +9 -0
  365. package/dist/services/knowledge/types.js.map +1 -0
  366. package/dist/services/known-sessions.d.ts +8 -0
  367. package/dist/services/known-sessions.d.ts.map +1 -0
  368. package/dist/services/known-sessions.js +40 -0
  369. package/dist/services/known-sessions.js.map +1 -0
  370. package/dist/services/member-home.d.ts +89 -0
  371. package/dist/services/member-home.d.ts.map +1 -0
  372. package/dist/services/member-home.js +256 -0
  373. package/dist/services/member-home.js.map +1 -0
  374. package/dist/services/member-remote-url.d.ts +34 -0
  375. package/dist/services/member-remote-url.d.ts.map +1 -0
  376. package/dist/services/member-remote-url.js +39 -0
  377. package/dist/services/member-remote-url.js.map +1 -0
  378. package/dist/services/model-pricing.d.ts +36 -0
  379. package/dist/services/model-pricing.d.ts.map +1 -0
  380. package/dist/services/model-pricing.js +108 -0
  381. package/dist/services/model-pricing.js.map +1 -0
  382. package/dist/services/orphan-recovery.d.ts +59 -0
  383. package/dist/services/orphan-recovery.d.ts.map +1 -0
  384. package/dist/services/orphan-recovery.js +122 -0
  385. package/dist/services/orphan-recovery.js.map +1 -0
  386. package/dist/services/pending-responses.d.ts +23 -0
  387. package/dist/services/pending-responses.d.ts.map +1 -0
  388. package/dist/services/pending-responses.js +52 -0
  389. package/dist/services/pending-responses.js.map +1 -0
  390. package/dist/services/preflight-check.d.ts +56 -0
  391. package/dist/services/preflight-check.d.ts.map +1 -0
  392. package/dist/services/preflight-check.js +277 -0
  393. package/dist/services/preflight-check.js.map +1 -0
  394. package/dist/services/registry.d.ts +4 -1
  395. package/dist/services/registry.d.ts.map +1 -1
  396. package/dist/services/registry.js +3 -0
  397. package/dist/services/registry.js.map +1 -1
  398. package/dist/services/relay-context.d.ts +23 -0
  399. package/dist/services/relay-context.d.ts.map +1 -0
  400. package/dist/services/relay-context.js +8 -0
  401. package/dist/services/relay-context.js.map +1 -0
  402. package/dist/services/relay-executor.d.ts +68 -0
  403. package/dist/services/relay-executor.d.ts.map +1 -0
  404. package/dist/services/relay-executor.js +70 -0
  405. package/dist/services/relay-executor.js.map +1 -0
  406. package/dist/services/relay-request.d.ts +65 -0
  407. package/dist/services/relay-request.d.ts.map +1 -0
  408. package/dist/services/relay-request.js +129 -0
  409. package/dist/services/relay-request.js.map +1 -0
  410. package/dist/services/relay-strategy.d.ts +19 -0
  411. package/dist/services/relay-strategy.d.ts.map +1 -0
  412. package/dist/services/relay-strategy.js +111 -0
  413. package/dist/services/relay-strategy.js.map +1 -0
  414. package/dist/services/service-manager/index.d.ts +5 -0
  415. package/dist/services/service-manager/index.d.ts.map +1 -0
  416. package/dist/services/service-manager/index.js +66 -0
  417. package/dist/services/service-manager/index.js.map +1 -0
  418. package/dist/services/service-manager/linux.d.ts +10 -0
  419. package/dist/services/service-manager/linux.d.ts.map +1 -0
  420. package/dist/services/service-manager/linux.js +97 -0
  421. package/dist/services/service-manager/linux.js.map +1 -0
  422. package/dist/services/service-manager/macos.d.ts +10 -0
  423. package/dist/services/service-manager/macos.d.ts.map +1 -0
  424. package/dist/services/service-manager/macos.js +94 -0
  425. package/dist/services/service-manager/macos.js.map +1 -0
  426. package/dist/services/service-manager/types.d.ts +18 -0
  427. package/dist/services/service-manager/types.d.ts.map +1 -0
  428. package/dist/services/service-manager/types.js +5 -0
  429. package/dist/services/service-manager/types.js.map +1 -0
  430. package/dist/services/service-manager/windows.d.ts +10 -0
  431. package/dist/services/service-manager/windows.d.ts.map +1 -0
  432. package/dist/services/service-manager/windows.js +73 -0
  433. package/dist/services/service-manager/windows.js.map +1 -0
  434. package/dist/services/session-registry.d.ts +70 -0
  435. package/dist/services/session-registry.d.ts.map +1 -0
  436. package/dist/services/session-registry.js +91 -0
  437. package/dist/services/session-registry.js.map +1 -0
  438. package/dist/services/singleton.d.ts +15 -0
  439. package/dist/services/singleton.d.ts.map +1 -0
  440. package/dist/services/singleton.js +98 -0
  441. package/dist/services/singleton.js.map +1 -0
  442. package/dist/services/sprint-coordination.d.ts +168 -0
  443. package/dist/services/sprint-coordination.d.ts.map +1 -0
  444. package/dist/services/sprint-coordination.js +564 -0
  445. package/dist/services/sprint-coordination.js.map +1 -0
  446. package/dist/services/ssh.d.ts.map +1 -1
  447. package/dist/services/ssh.js +70 -3
  448. package/dist/services/ssh.js.map +1 -1
  449. package/dist/services/stall/log-path-resolver.d.ts +11 -8
  450. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  451. package/dist/services/stall/log-path-resolver.js +17 -33
  452. package/dist/services/stall/log-path-resolver.js.map +1 -1
  453. package/dist/services/stall/stall-detector.d.ts +32 -0
  454. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  455. package/dist/services/stall/stall-detector.js +187 -12
  456. package/dist/services/stall/stall-detector.js.map +1 -1
  457. package/dist/services/stall/stall-poller.d.ts +50 -0
  458. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  459. package/dist/services/stall/stall-poller.js +268 -18
  460. package/dist/services/stall/stall-poller.js.map +1 -1
  461. package/dist/services/strategy.d.ts.map +1 -1
  462. package/dist/services/strategy.js +57 -7
  463. package/dist/services/strategy.js.map +1 -1
  464. package/dist/services/substitution-engine.d.ts +20 -0
  465. package/dist/services/substitution-engine.d.ts.map +1 -0
  466. package/dist/services/substitution-engine.js +92 -0
  467. package/dist/services/substitution-engine.js.map +1 -0
  468. package/dist/services/task-cleanup.d.ts.map +1 -1
  469. package/dist/services/task-cleanup.js +1 -9
  470. package/dist/services/task-cleanup.js.map +1 -1
  471. package/dist/services/token-issuer.d.ts +47 -0
  472. package/dist/services/token-issuer.d.ts.map +1 -0
  473. package/dist/services/token-issuer.js +63 -0
  474. package/dist/services/token-issuer.js.map +1 -0
  475. package/dist/services/tool-registry.d.ts +3 -0
  476. package/dist/services/tool-registry.d.ts.map +1 -0
  477. package/dist/services/tool-registry.js +225 -0
  478. package/dist/services/tool-registry.js.map +1 -0
  479. package/dist/services/user-config.d.ts +14 -0
  480. package/dist/services/user-config.d.ts.map +1 -1
  481. package/dist/services/user-config.js +55 -0
  482. package/dist/services/user-config.js.map +1 -1
  483. package/dist/services/vcs/github.d.ts.map +1 -1
  484. package/dist/services/vcs/github.js +32 -1
  485. package/dist/services/vcs/github.js.map +1 -1
  486. package/dist/services/vcs/types.d.ts +44 -0
  487. package/dist/services/vcs/types.d.ts.map +1 -1
  488. package/dist/services/version-check.d.ts +22 -0
  489. package/dist/services/version-check.d.ts.map +1 -0
  490. package/dist/services/version-check.js +103 -0
  491. package/dist/services/version-check.js.map +1 -0
  492. package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
  493. package/dist/skills/pm/beads.md +6 -0
  494. package/dist/skills/pm/cost.md +3 -0
  495. package/dist/skills/pm/doer-reviewer-loop.md +3 -0
  496. package/dist/skills/pm/fleet-addendum.md +6 -0
  497. package/dist/skills/pm/index.md +56 -0
  498. package/dist/skills/pm/kb-reconcile.md +132 -0
  499. package/dist/skills/pm/kb-review.md +109 -0
  500. package/dist/tools/check-status.d.ts +47 -0
  501. package/dist/tools/check-status.d.ts.map +1 -1
  502. package/dist/tools/check-status.js +250 -2
  503. package/dist/tools/check-status.js.map +1 -1
  504. package/dist/tools/child-id-allocator.d.ts +45 -0
  505. package/dist/tools/child-id-allocator.d.ts.map +1 -0
  506. package/dist/tools/child-id-allocator.js +62 -0
  507. package/dist/tools/child-id-allocator.js.map +1 -0
  508. package/dist/tools/cloud-control.d.ts +2 -2
  509. package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
  510. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
  511. package/dist/tools/code-intelligence-codebase-memory.js +270 -0
  512. package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
  513. package/dist/tools/code-intelligence-freshness.d.ts +2 -0
  514. package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
  515. package/dist/tools/code-intelligence-freshness.js +26 -0
  516. package/dist/tools/code-intelligence-freshness.js.map +1 -0
  517. package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
  518. package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
  519. package/dist/tools/code-intelligence-gitnexus.js +475 -0
  520. package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
  521. package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
  522. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
  523. package/dist/tools/code-intelligence-kb-enrich.js +65 -0
  524. package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
  525. package/dist/tools/code-intelligence-reindex.d.ts +7 -0
  526. package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
  527. package/dist/tools/code-intelligence-reindex.js +106 -0
  528. package/dist/tools/code-intelligence-reindex.js.map +1 -0
  529. package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
  530. package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
  531. package/dist/tools/code-intelligence-telemetry.js +52 -0
  532. package/dist/tools/code-intelligence-telemetry.js.map +1 -0
  533. package/dist/tools/code-intelligence-tests.d.ts +2 -0
  534. package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
  535. package/dist/tools/code-intelligence-tests.js +24 -0
  536. package/dist/tools/code-intelligence-tests.js.map +1 -0
  537. package/dist/tools/code-intelligence.d.ts +114 -0
  538. package/dist/tools/code-intelligence.d.ts.map +1 -0
  539. package/dist/tools/code-intelligence.js +124 -0
  540. package/dist/tools/code-intelligence.js.map +1 -0
  541. package/dist/tools/compose-permissions.d.ts +38 -4
  542. package/dist/tools/compose-permissions.d.ts.map +1 -1
  543. package/dist/tools/compose-permissions.js +295 -33
  544. package/dist/tools/compose-permissions.js.map +1 -1
  545. package/dist/tools/dolt-push-mutex.d.ts +44 -0
  546. package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
  547. package/dist/tools/dolt-push-mutex.js +83 -0
  548. package/dist/tools/dolt-push-mutex.js.map +1 -0
  549. package/dist/tools/execute-command.d.ts +13 -1
  550. package/dist/tools/execute-command.d.ts.map +1 -1
  551. package/dist/tools/execute-command.js +108 -21
  552. package/dist/tools/execute-command.js.map +1 -1
  553. package/dist/tools/execute-prompt.d.ts +84 -12
  554. package/dist/tools/execute-prompt.d.ts.map +1 -1
  555. package/dist/tools/execute-prompt.js +1191 -88
  556. package/dist/tools/execute-prompt.js.map +1 -1
  557. package/dist/tools/get-member-model-pricing.d.ts +21 -0
  558. package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
  559. package/dist/tools/get-member-model-pricing.js +29 -0
  560. package/dist/tools/get-member-model-pricing.js.map +1 -0
  561. package/dist/tools/kb-capture.d.ts +53 -0
  562. package/dist/tools/kb-capture.d.ts.map +1 -0
  563. package/dist/tools/kb-capture.js +130 -0
  564. package/dist/tools/kb-capture.js.map +1 -0
  565. package/dist/tools/kb-context.d.ts +17 -0
  566. package/dist/tools/kb-context.d.ts.map +1 -0
  567. package/dist/tools/kb-context.js +29 -0
  568. package/dist/tools/kb-context.js.map +1 -0
  569. package/dist/tools/kb-export.d.ts +19 -0
  570. package/dist/tools/kb-export.d.ts.map +1 -0
  571. package/dist/tools/kb-export.js +344 -0
  572. package/dist/tools/kb-export.js.map +1 -0
  573. package/dist/tools/kb-feedback.d.ts +23 -0
  574. package/dist/tools/kb-feedback.d.ts.map +1 -0
  575. package/dist/tools/kb-feedback.js +43 -0
  576. package/dist/tools/kb-feedback.js.map +1 -0
  577. package/dist/tools/kb-freshness-sweep.d.ts +14 -0
  578. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
  579. package/dist/tools/kb-freshness-sweep.js +29 -0
  580. package/dist/tools/kb-freshness-sweep.js.map +1 -0
  581. package/dist/tools/kb-harvest.d.ts +20 -0
  582. package/dist/tools/kb-harvest.d.ts.map +1 -0
  583. package/dist/tools/kb-harvest.js +143 -0
  584. package/dist/tools/kb-harvest.js.map +1 -0
  585. package/dist/tools/kb-import.d.ts +44 -0
  586. package/dist/tools/kb-import.d.ts.map +1 -0
  587. package/dist/tools/kb-import.js +239 -0
  588. package/dist/tools/kb-import.js.map +1 -0
  589. package/dist/tools/kb-invalidate.d.ts +19 -0
  590. package/dist/tools/kb-invalidate.d.ts.map +1 -0
  591. package/dist/tools/kb-invalidate.js +34 -0
  592. package/dist/tools/kb-invalidate.js.map +1 -0
  593. package/dist/tools/kb-list.d.ts +32 -0
  594. package/dist/tools/kb-list.d.ts.map +1 -0
  595. package/dist/tools/kb-list.js +43 -0
  596. package/dist/tools/kb-list.js.map +1 -0
  597. package/dist/tools/kb-promote.d.ts +20 -0
  598. package/dist/tools/kb-promote.d.ts.map +1 -0
  599. package/dist/tools/kb-promote.js +20 -0
  600. package/dist/tools/kb-promote.js.map +1 -0
  601. package/dist/tools/kb-query.d.ts +35 -0
  602. package/dist/tools/kb-query.d.ts.map +1 -0
  603. package/dist/tools/kb-query.js +111 -0
  604. package/dist/tools/kb-query.js.map +1 -0
  605. package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
  606. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
  607. package/dist/tools/kb-reconcile-prefilter.js +26 -0
  608. package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
  609. package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
  610. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
  611. package/dist/tools/kb-resolve-contradiction.js +37 -0
  612. package/dist/tools/kb-resolve-contradiction.js.map +1 -0
  613. package/dist/tools/kb-session-prime.d.ts +26 -0
  614. package/dist/tools/kb-session-prime.d.ts.map +1 -0
  615. package/dist/tools/kb-session-prime.js +392 -0
  616. package/dist/tools/kb-session-prime.js.map +1 -0
  617. package/dist/tools/kb-setup.d.ts +20 -0
  618. package/dist/tools/kb-setup.d.ts.map +1 -0
  619. package/dist/tools/kb-setup.js +49 -0
  620. package/dist/tools/kb-setup.js.map +1 -0
  621. package/dist/tools/kb-stats.d.ts +20 -0
  622. package/dist/tools/kb-stats.d.ts.map +1 -0
  623. package/dist/tools/kb-stats.js +115 -0
  624. package/dist/tools/kb-stats.js.map +1 -0
  625. package/dist/tools/list-members.d.ts.map +1 -1
  626. package/dist/tools/list-members.js +39 -7
  627. package/dist/tools/list-members.js.map +1 -1
  628. package/dist/tools/member-detail.d.ts +1 -1
  629. package/dist/tools/member-detail.d.ts.map +1 -1
  630. package/dist/tools/member-detail.js +16 -2
  631. package/dist/tools/member-detail.js.map +1 -1
  632. package/dist/tools/member-reservation.d.ts +29 -0
  633. package/dist/tools/member-reservation.d.ts.map +1 -0
  634. package/dist/tools/member-reservation.js +71 -0
  635. package/dist/tools/member-reservation.js.map +1 -0
  636. package/dist/tools/monitor-task.d.ts.map +1 -1
  637. package/dist/tools/monitor-task.js +21 -3
  638. package/dist/tools/monitor-task.js.map +1 -1
  639. package/dist/tools/provision-auth.d.ts.map +1 -1
  640. package/dist/tools/provision-auth.js +10 -3
  641. package/dist/tools/provision-auth.js.map +1 -1
  642. package/dist/tools/provision-vcs-auth.d.ts +7 -7
  643. package/dist/tools/provision-vcs-auth.js +1 -1
  644. package/dist/tools/provision-vcs-auth.js.map +1 -1
  645. package/dist/tools/register-member.d.ts +20 -5
  646. package/dist/tools/register-member.d.ts.map +1 -1
  647. package/dist/tools/register-member.js +174 -6
  648. package/dist/tools/register-member.js.map +1 -1
  649. package/dist/tools/remove-member.d.ts +1 -1
  650. package/dist/tools/remove-member.d.ts.map +1 -1
  651. package/dist/tools/remove-member.js +17 -3
  652. package/dist/tools/remove-member.js.map +1 -1
  653. package/dist/tools/report-status.d.ts +33 -0
  654. package/dist/tools/report-status.d.ts.map +1 -0
  655. package/dist/tools/report-status.js +45 -0
  656. package/dist/tools/report-status.js.map +1 -0
  657. package/dist/tools/respond-to-message.d.ts +21 -0
  658. package/dist/tools/respond-to-message.d.ts.map +1 -0
  659. package/dist/tools/respond-to-message.js +23 -0
  660. package/dist/tools/respond-to-message.js.map +1 -0
  661. package/dist/tools/send-email.d.ts +69 -0
  662. package/dist/tools/send-email.d.ts.map +1 -0
  663. package/dist/tools/send-email.js +177 -0
  664. package/dist/tools/send-email.js.map +1 -0
  665. package/dist/tools/send-files.d.ts +3 -0
  666. package/dist/tools/send-files.d.ts.map +1 -1
  667. package/dist/tools/send-files.js +88 -8
  668. package/dist/tools/send-files.js.map +1 -1
  669. package/dist/tools/send-message.d.ts +27 -0
  670. package/dist/tools/send-message.d.ts.map +1 -0
  671. package/dist/tools/send-message.js +46 -0
  672. package/dist/tools/send-message.js.map +1 -0
  673. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  674. package/dist/tools/setup-ssh-key.js +2 -0
  675. package/dist/tools/setup-ssh-key.js.map +1 -1
  676. package/dist/tools/shutdown-server.d.ts +2 -0
  677. package/dist/tools/shutdown-server.d.ts.map +1 -1
  678. package/dist/tools/shutdown-server.js +19 -0
  679. package/dist/tools/shutdown-server.js.map +1 -1
  680. package/dist/tools/update-member.d.ts +11 -8
  681. package/dist/tools/update-member.d.ts.map +1 -1
  682. package/dist/tools/update-member.js +36 -2
  683. package/dist/tools/update-member.js.map +1 -1
  684. package/dist/types.d.ts +16 -3
  685. package/dist/types.d.ts.map +1 -1
  686. package/dist/utils/agent-helpers.d.ts +2 -1
  687. package/dist/utils/agent-helpers.d.ts.map +1 -1
  688. package/dist/utils/agent-helpers.js +7 -2
  689. package/dist/utils/agent-helpers.js.map +1 -1
  690. package/dist/utils/pid-helpers.d.ts +15 -0
  691. package/dist/utils/pid-helpers.d.ts.map +1 -1
  692. package/dist/utils/pid-helpers.js +23 -0
  693. package/dist/utils/pid-helpers.js.map +1 -1
  694. package/dist/utils/process-utils.d.ts +3 -0
  695. package/dist/utils/process-utils.d.ts.map +1 -0
  696. package/dist/utils/process-utils.js +42 -0
  697. package/dist/utils/process-utils.js.map +1 -0
  698. package/dist/utils/prompt-errors.d.ts +2 -1
  699. package/dist/utils/prompt-errors.d.ts.map +1 -1
  700. package/dist/utils/prompt-errors.js +13 -3
  701. package/dist/utils/prompt-errors.js.map +1 -1
  702. package/dist/utils/session-caller.d.ts +28 -0
  703. package/dist/utils/session-caller.d.ts.map +1 -0
  704. package/dist/utils/session-caller.js +24 -0
  705. package/dist/utils/session-caller.js.map +1 -0
  706. package/dist/utils/work-folder-validation.d.ts +39 -0
  707. package/dist/utils/work-folder-validation.d.ts.map +1 -0
  708. package/dist/utils/work-folder-validation.js +60 -0
  709. package/dist/utils/work-folder-validation.js.map +1 -0
  710. package/dist/utils/workspace-trust.d.ts +24 -0
  711. package/dist/utils/workspace-trust.d.ts.map +1 -0
  712. package/dist/utils/workspace-trust.js +35 -0
  713. package/dist/utils/workspace-trust.js.map +1 -0
  714. package/dist/workflows/auto-sprint.js +994 -91
  715. package/package.json +40 -9
  716. package/packages/apra-fleet-client/package.json +26 -0
  717. package/packages/apra-fleet-client/src/client/api.mjs +510 -0
  718. package/packages/apra-fleet-client/src/client/client.mjs +146 -0
  719. package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
  720. package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
  721. package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
  722. package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
  723. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +303 -0
  724. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
  725. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
  726. package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
  727. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
  728. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
  729. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
  730. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
  731. package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
  732. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
  733. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -0
  734. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
  735. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
  736. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
  737. package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
  738. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
  739. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
  740. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
  741. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +82 -0
  742. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
  743. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +75 -0
  744. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
  745. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
  746. package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
  747. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
  748. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
  749. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
  750. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
  751. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
  752. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
  753. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +135 -0
  754. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
  755. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +148 -0
  756. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
  757. package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
  758. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +127 -0
  759. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
  760. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
  761. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
  762. package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
  763. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
  764. package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
  765. package/packages/apra-fleet-se/apra-pm/version.json +3 -0
  766. package/packages/apra-fleet-se/bin/cli.mjs +864 -0
  767. package/packages/apra-fleet-se/bin/serve.mjs +395 -0
  768. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
  769. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -0
  770. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
  771. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
  772. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -0
  773. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
  774. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
  775. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
  776. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
  777. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
  778. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
  779. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
  780. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
  781. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
  782. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
  783. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
  784. package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
  785. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
  786. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
  787. package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
  788. package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
  789. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
  790. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
  791. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
  792. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
  793. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
  794. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +235 -0
  795. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
  796. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
  797. package/packages/apra-fleet-se/package.json +29 -0
  798. package/packages/apra-fleet-se/workflow.json +1 -0
  799. package/packages/apra-fleet-workflow/package.json +30 -0
  800. package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
  801. package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
  802. package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
  803. package/packages/apra-fleet-workflow/src/viewer/index.mjs +1439 -0
  804. package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
  805. package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
  806. package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
  807. package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
  808. package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
  809. package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
  810. package/packages/apra-fleet-workflow/src/workflow/index.mjs +1727 -0
  811. package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
  812. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
  813. package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
  814. package/scripts/agy-transcript-reader.js +1 -0
  815. package/scripts/fleet-statusline.sh +17 -13
  816. package/skills/fleet/SKILL.md +37 -2
  817. package/skills/fleet/beads.md +14 -7
  818. package/skills/fleet/knowledge-agent.md +66 -0
  819. package/skills/fleet/permissions.md +76 -2
  820. package/skills/fleet/profiles/base-dev.json +11 -1
  821. package/skills/fleet/profiles/base-reviewer.json +9 -1
  822. package/skills/fleet/profiles/node.json +2 -2
  823. package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
  824. package/version.json +1 -1
  825. package/scripts/agy-settings-merge.js +0 -27
  826. /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
@@ -0,0 +1,616 @@
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
+ * @property {string[]} [blockerIds] - apra-fleet-mjo: the bead ids still open
139
+ * at/above goal priority when the stall was declared, i.e. exactly what an
140
+ * operator must clear. Counts alone cannot answer "blocked on what?".
141
+ */
142
+ export class StalledSprintError extends WorkflowError {
143
+ /**
144
+ * @param {string} message
145
+ * @param {{ staleCycles?: number, closedCountHistory?: number[], highWaterClosedCount?: number, thrashIds?: string[], blockerIds?: string[], cycle?: number, details?: object, cause?: unknown }} [opts]
146
+ */
147
+ constructor(message, opts = {}) {
148
+ const { staleCycles = null, closedCountHistory = [], highWaterClosedCount = null, thrashIds = [], blockerIds = [], cycle, details, cause } = opts;
149
+ super(message, {
150
+ code: 'SPRINT_STALLED',
151
+ details: { staleCycles, closedCountHistory, highWaterClosedCount, thrashIds, blockerIds, cycle, ...details },
152
+ cause,
153
+ });
154
+ this.staleCycles = staleCycles;
155
+ this.closedCountHistory = closedCountHistory;
156
+ this.highWaterClosedCount = highWaterClosedCount;
157
+ this.thrashIds = thrashIds;
158
+ this.blockerIds = blockerIds;
159
+ }
160
+ }
161
+
162
+ /**
163
+ * apra-fleet-unw2.6 (N8) -- thrown when the reviewer persistently returns a
164
+ * self-contradictory verdict: `CHANGES_NEEDED` with BOTH `reopenIds` and
165
+ * `newTasks` empty. That combination is schema-legal but semantically
166
+ * meaningless -- `CHANGES_NEEDED` asserts more work is required, yet the
167
+ * verdict names nothing to reopen and proposes no new follow-up work, so
168
+ * there is nothing for the orchestrator to act on. Left unhandled, this
169
+ * "verdict" can never resolve to APPROVED and never produces a reopened/new
170
+ * bead either, so a cycle loop that keeps hitting it makes no closed-bead
171
+ * progress -- which apra-fleet-unw.17's stall-abort bookkeeping cannot tell
172
+ * apart from genuine no-progress, and can misreport an otherwise-finished
173
+ * sprint (every bead already closed) as `StalledSprintError`.
174
+ *
175
+ * The cycle loop retries the review dispatch exactly once when this
176
+ * contradiction is first seen (the reviewer may have been dispatched with
177
+ * stale/incomplete context); if the SAME contradiction repeats on the
178
+ * retry, this error is thrown instead of letting the round silently
179
+ * accumulate toward stall-abort. Never caught inside runner.js's cycle
180
+ * loop -- it unwinds `runWithContext()`'s promise and fails the whole
181
+ * sprint run, the same way `StalledSprintError`/`SprintPlanRejectedError` do.
182
+ *
183
+ * @property {number} cycle - the outer sprint cycle the violation occurred in
184
+ * @property {string|null} notes - the reviewer's own `notes` field from the
185
+ * contradictory verdict, carried through for a human/CI reading the failure
186
+ */
187
+ export class ReviewerContractViolationError extends WorkflowError {
188
+ /**
189
+ * @param {string} message
190
+ * @param {{ cycle?: number, notes?: string|null, details?: object, cause?: unknown }} [opts]
191
+ */
192
+ constructor(message, opts = {}) {
193
+ const { cycle, notes = null, details, cause } = opts;
194
+ super(message, {
195
+ code: 'REVIEWER_CONTRACT_VIOLATION',
196
+ details: { cycle, notes, ...details },
197
+ cause,
198
+ });
199
+ this.cycle = cycle;
200
+ this.notes = notes;
201
+ }
202
+ }
203
+
204
+ /**
205
+ * apra-fleet-eft.8.1 (Plan Part 3.1/3.3, risk 2) -- thrown when an
206
+ * orchestrator-bracketed git sync (G-pull / G-push) discovers that a member
207
+ * has DIVERGED from the shared sprint branch: a `git merge --ff-only` that
208
+ * could not fast-forward, an unmerged/conflicted `git pull --rebase`, or a
209
+ * `git push` still rejected as non-fast-forward AFTER the single bounded
210
+ * pull-rebase retry.
211
+ *
212
+ * Divergence is the hard, non-retryable failure class in the single-writer
213
+ * token-passing model: because the writer pushes and the next reader pulls,
214
+ * every intra-sprint merge is fast-forward BY CONSTRUCTION, so a non-FF state
215
+ * means the invariant is already broken. It MUST NEVER be auto-resolved or
216
+ * retried blindly -- the whole point of a distinct typed error (vs a generic
217
+ * CommandError) is that the classifier can tell "diverged -> abort" apart from
218
+ * "transient -> retry" and route the two differently.
219
+ *
220
+ * @property {string|null} member - the member whose checkout diverged
221
+ * @property {string|null} gitOutput - the raw git stderr/stdout that proved divergence
222
+ * @property {string|null} operation - which bracket step diverged
223
+ * ('pull' | 'push' | 'push-rebase')
224
+ */
225
+ export class GitDivergedError extends WorkflowError {
226
+ /**
227
+ * @param {string} message
228
+ * @param {{ member?: string|null, gitOutput?: string|null, operation?: string|null, details?: object, cause?: unknown }} [opts]
229
+ */
230
+ constructor(message, opts = {}) {
231
+ const { member = null, gitOutput = null, operation = null, details, cause } = opts;
232
+ super(message, {
233
+ code: 'GIT_DIVERGED',
234
+ details: { member, gitOutput, operation, ...details },
235
+ cause,
236
+ });
237
+ this.member = member;
238
+ this.gitOutput = gitOutput;
239
+ this.operation = operation;
240
+ }
241
+ }
242
+
243
+ /**
244
+ * apra-fleet-eft.8.1 -- thrown when an orchestrator-bracketed git sync
245
+ * (G-pull / G-push) fails for a reason that is NOT divergence and that
246
+ * SURVIVED the bounded transient-retry budget: a transient class failure
247
+ * (network unreachable, an index/ref lock) that kept failing after its
248
+ * allowed retries, or an unclassifiable git failure that must not be retried
249
+ * blindly.
250
+ *
251
+ * This is the counterpart to {@link GitDivergedError}: both extend
252
+ * WorkflowError and both carry the member and raw git output, but they are
253
+ * deliberately distinct types so a caller/test can assert the two failure
254
+ * classifications (transient-retry-exhausted vs diverged-abort) SEPARATELY,
255
+ * which is the crux of risk 2 in the plan.
256
+ *
257
+ * @property {string|null} member - the member whose sync failed
258
+ * @property {string|null} gitOutput - the raw git stderr/stdout of the failure
259
+ */
260
+ export class GitSyncError extends WorkflowError {
261
+ /**
262
+ * @param {string} message
263
+ * @param {{ member?: string|null, gitOutput?: string|null, details?: object, cause?: unknown }} [opts]
264
+ */
265
+ constructor(message, opts = {}) {
266
+ const { member = null, gitOutput = null, details, cause } = opts;
267
+ super(message, {
268
+ code: 'GIT_SYNC_FAILED',
269
+ details: { member, gitOutput, ...details },
270
+ cause,
271
+ });
272
+ this.member = member;
273
+ this.gitOutput = gitOutput;
274
+ }
275
+ }
276
+
277
+ /**
278
+ * apra-fleet-eft.9.1 (Plan Part 3.3) -- thrown when an orchestrator-bracketed
279
+ * DOLT sync (D-pull / D-push of the shared beads database) discovers a
280
+ * divergence that the fixed, mechanical conflict policy could NOT close: a
281
+ * `bd dolt pull` that reports a data/merge conflict outside a push-loser's
282
+ * reconcile, or a `bd dolt push` STILL rejected after the single bounded
283
+ * pull-then-repush reconcile.
284
+ *
285
+ * This is the Dolt counterpart of {@link GitDivergedError}. The beads-sync
286
+ * conflict policy is deliberately NOT per-conflict judgment: it is
287
+ * first-successful-pusher-wins, with ours/theirs decided mechanically by which
288
+ * clone is doing the resolving (the push loser reconciles by pulling the
289
+ * winner's state, then re-pushes). A divergence that outlives that one bounded
290
+ * reconcile is a hard, non-retryable failure -- surfacing it as a distinct
291
+ * typed error lets callers/tests tell "diverged -> abort" apart from
292
+ * "transient -> retry", exactly as the git brackets do.
293
+ *
294
+ * @property {string|null} member - the member whose beads clone diverged
295
+ * @property {string|null} doltOutput - the raw `bd dolt` stderr/stdout that proved divergence
296
+ * @property {string|null} operation - which bracket step diverged
297
+ * ('pull' | 'push' | 'push-reconcile')
298
+ */
299
+ export class DoltDivergedError extends WorkflowError {
300
+ /**
301
+ * @param {string} message
302
+ * @param {{ member?: string|null, doltOutput?: string|null, operation?: string|null, details?: object, cause?: unknown }} [opts]
303
+ */
304
+ constructor(message, opts = {}) {
305
+ const { member = null, doltOutput = null, operation = null, details, cause } = opts;
306
+ super(message, {
307
+ code: 'DOLT_DIVERGED',
308
+ details: { member, doltOutput, operation, ...details },
309
+ cause,
310
+ });
311
+ this.member = member;
312
+ this.doltOutput = doltOutput;
313
+ this.operation = operation;
314
+ }
315
+ }
316
+
317
+ /**
318
+ * apra-fleet-eft.9.1 (Plan Part 3.3) -- thrown when an orchestrator-bracketed
319
+ * DOLT sync (D-pull / D-push) fails for a reason that is NOT divergence and
320
+ * that SURVIVED the bounded transient-retry budget: a transient-class failure
321
+ * (network unreachable, a server/lock hiccup) that kept failing after its
322
+ * allowed retries, or an unclassifiable `bd dolt` failure that must not be
323
+ * retried blindly.
324
+ *
325
+ * The Dolt counterpart of {@link GitSyncError}: deliberately a distinct type
326
+ * from {@link DoltDivergedError} so a caller/test can assert the two failure
327
+ * classifications (transient-retry-exhausted vs diverged-abort) SEPARATELY.
328
+ *
329
+ * @property {string|null} member - the member whose beads sync failed
330
+ * @property {string|null} doltOutput - the raw `bd dolt` stderr/stdout of the failure
331
+ */
332
+ export class DoltSyncError extends WorkflowError {
333
+ /**
334
+ * @param {string} message
335
+ * @param {{ member?: string|null, doltOutput?: string|null, details?: object, cause?: unknown }} [opts]
336
+ */
337
+ constructor(message, opts = {}) {
338
+ const { member = null, doltOutput = null, details, cause } = opts;
339
+ super(message, {
340
+ code: 'DOLT_SYNC_FAILED',
341
+ details: { member, doltOutput, ...details },
342
+ cause,
343
+ });
344
+ this.member = member;
345
+ this.doltOutput = doltOutput;
346
+ }
347
+ }
348
+
349
+ /**
350
+ * apra-fleet dolt-settle redesign (see fleet-sprint/docs/dolt-sync-redesign.md
351
+ * Part 5) -- thrown by settleDoltConflicts() when a member has no usable,
352
+ * correctly-pinned `dolt` binary and settle's own install/repair ladder
353
+ * (probe -> install -> kill-blocking-process-and-retry -> warn-and-fall-back-
354
+ * to-a-functionally-probed-alternative) could not produce one. This is an
355
+ * ordinary operational/infra failure under the existing degraded/fatal
356
+ * taxonomy -- NOT an escalation tier, exactly the same posture as
357
+ * DoltSyncError for "server wouldn't start". It is deliberately NOT thrown
358
+ * for the "wrong version but a functional fallback was found and passed its
359
+ * preflight" case (Part 5.6) -- that path proceeds with a warning instead;
360
+ * this error is reserved for "no runnable dolt at all" or "unsupported
361
+ * platform/arch with nothing usable already present".
362
+ *
363
+ * @property {string|null} member - the member with no usable dolt binary
364
+ * @property {string|null} probedPath - the path settle probed/attempted to install to
365
+ * @property {string|null} probeOutput - the raw probe/install failure output
366
+ * @property {string|null} repairCommand - the exact manual command an operator can run to fix this
367
+ */
368
+ export class DoltBinaryUnavailableError extends WorkflowError {
369
+ /**
370
+ * @param {string} message
371
+ * @param {{ member?: string|null, probedPath?: string|null, probeOutput?: string|null, repairCommand?: string|null, details?: object, cause?: unknown }} [opts]
372
+ */
373
+ constructor(message, opts = {}) {
374
+ const { member = null, probedPath = null, probeOutput = null, repairCommand = null, details, cause } = opts;
375
+ super(message, {
376
+ code: 'DOLT_BINARY_UNAVAILABLE',
377
+ details: { member, probedPath, probeOutput, repairCommand, ...details },
378
+ cause,
379
+ });
380
+ this.member = member;
381
+ this.probedPath = probedPath;
382
+ this.probeOutput = probeOutput;
383
+ this.repairCommand = repairCommand;
384
+ }
385
+ }
386
+
387
+ // ---------------------------------------------------------------------------
388
+ // Non-retryable dispatch failures (stabilization Issue 43 / smoke rehearsal)
389
+ // ---------------------------------------------------------------------------
390
+ //
391
+ // An authentication or workspace-trust failure is deterministic: the member's
392
+ // credential/trust state does not change between attempts, so every retry
393
+ // burns a full dispatch budget to reproduce the identical failure (observed
394
+ // live: 5 planner retries x 15-minute interactive timeouts against an
395
+ // unauthenticated member = 75 wasted minutes for an error that was terminal
396
+ // at second zero). The fleet server already classifies these categories as
397
+ // non-retryable (src/utils/prompt-errors.ts isRetryable()); this mirrors
398
+ // that judgment on the engine side, keyed off the server's own error-message
399
+ // signatures since the message string was, until apra-fleet-391, all that
400
+ // crossed the dispatch boundary. execute-prompt.ts now also emits a
401
+ // structured `details.reason` ('auth' | 'workspace_not_trusted') on
402
+ // AgentDispatchError -- checked FIRST below since it can't be fooled by
403
+ // auth-like noise in an unrelated failure's message text; the regex remains
404
+ // as a fallback for older/mocked errors that only ever set `.message`.
405
+ const NON_RETRYABLE_DISPATCH_RE = /authentication failed|not logged in|workspace not trusted|has not been trusted/i;
406
+
407
+ /**
408
+ * True when a dispatch error can NEVER be fixed by retrying (auth /
409
+ * workspace-trust failures). Callers must abort their retry loop and surface
410
+ * the error immediately, with remediation left to the operator.
411
+ * @param {unknown} err
412
+ * @returns {boolean}
413
+ */
414
+ export function isNonRetryableDispatchError(err) {
415
+ const reason = err?.details?.reason;
416
+ if (reason === 'auth' || reason === 'workspace_not_trusted'
417
+ || reason === 'preflight_auth_missing' || reason === 'preflight_auth_expired') return true;
418
+ return NON_RETRYABLE_DISPATCH_RE.test(String(err?.message ?? ''));
419
+ }
420
+
421
+ // apra-fleet-391: subset of NON_RETRYABLE_DISPATCH_RE that is specifically an
422
+ // LLM credential failure (as opposed to workspace-trust, which
423
+ // provision_llm_auth cannot fix -- that needs an operator to run `claude
424
+ // --dangerously-skip-permissions` or trust the folder interactively).
425
+ const AUTH_DISPATCH_RE = /authentication failed|not logged in/i;
426
+
427
+ /**
428
+ * True when a dispatch error is specifically an LLM auth/credential failure
429
+ * (not workspace-trust) -- the subset self-heal via provision_llm_auth can
430
+ * actually fix.
431
+ * @param {unknown} err
432
+ * @returns {boolean}
433
+ */
434
+ export function isAuthDispatchError(err) {
435
+ const reason = err?.details?.reason;
436
+ if (reason === 'auth' || reason === 'preflight_auth_missing' || reason === 'preflight_auth_expired') return true;
437
+ return AUTH_DISPATCH_RE.test(String(err?.message ?? ''));
438
+ }
439
+
440
+ // ---------------------------------------------------------------------------
441
+ // apra-fleet-04g.6 -- infrastructure dispatch failures (NOT a test verdict)
442
+ // ---------------------------------------------------------------------------
443
+ //
444
+ // execute-prompt.ts emits these structured `reason`s when the member CLI
445
+ // itself failed to deliver a parseable result envelope, as opposed to running
446
+ // a task to a real pass/fail conclusion:
447
+ // - 'empty_response' -- CLI exited 0 but produced no parseable output
448
+ // (died silently mid-turn without printing its
449
+ // result envelope; observed live cycle C4).
450
+ // - 'dispatch_failed' -- strategy.execCommand threw, e.g. an
451
+ // inactivity timeout kill or an SSH/transport
452
+ // failure (observed live cycle C5: a 3600000ms
453
+ // inactivity timeout).
454
+ // - 'orphan_recovery_timeout'-- the SSH channel was lost while the CLI was
455
+ // still running and it was still alive after
456
+ // the recovery window; the pid was killed with
457
+ // no result recovered.
458
+ // - 'stalled' -- a confirmed stall (no member-side progress
459
+ // for the whole stall threshold) killed the
460
+ // remote pid and aborted the in-flight dispatch
461
+ // (apra-fleet-3c9.1). Like the others, no test
462
+ // verdict was ever produced.
463
+ //
464
+ // For an integ-test-runner dispatch, all of these mean "no test verdict was
465
+ // ever produced" -- the run never reported pass or fail. Treating them as a
466
+ // genuine passed:false FAIL (the pre-04g.6 behavior) is a false negative: it
467
+ // records a test failure that never happened and blocks the sprint's confidence
468
+ // check on an infra fault. Callers use this classifier to (a) retry once via a
469
+ // session resume and (b) failing that, record the cycle as INCONCLUSIVE rather
470
+ // than a test FAIL -- exactly as the part-2 stale-evidence path already does.
471
+ const INFRA_DISPATCH_REASONS = new Set(['empty_response', 'dispatch_failed', 'orphan_recovery_timeout', 'stalled', 'preflight_offline']);
472
+
473
+ /**
474
+ * True when a dispatch error is an INFRASTRUCTURE failure (the member CLI never
475
+ * delivered a parseable result envelope) rather than a genuine task
476
+ * pass/fail conclusion -- keyed off the server's structured `details.reason`.
477
+ * @param {unknown} err
478
+ * @returns {boolean}
479
+ */
480
+ export function isInfraDispatchFailure(err) {
481
+ return INFRA_DISPATCH_REASONS.has(err?.details?.reason);
482
+ }
483
+
484
+ // ---------------------------------------------------------------------------
485
+ // apra-fleet-eft.75.2 -- sprint-launch machine-local pidfile mutex
486
+ // ---------------------------------------------------------------------------
487
+
488
+ /**
489
+ * Thrown by sprint-lock.mjs's acquireSprintLock() when a duplicate `auto-
490
+ * sprint` engine start is attempted for the SAME sprint (branch+members)
491
+ * while a live process already holds that sprint's pidfile lock, OR when a
492
+ * concurrent process wins a stale-pidfile reclaim race. Root incident
493
+ * (apra-fleet-eft.75): a duplicate concurrent runner was previously stopped
494
+ * only by an ACCIDENTAL viewer-port-8080 collision (itself trivially avoided
495
+ * with a different --viewer-port) -- this is the explicit, always-on mutex
496
+ * that replaces that accident with a deliberate, named guard. Never caught
497
+ * inside runner.js -- it unwinds main()'s promise and fails the whole sprint
498
+ * launch before any fleet dispatch occurs.
499
+ *
500
+ * @property {string|null} branch
501
+ * @property {string[]|null} members
502
+ * @property {number|null} existingPid - the live pid currently holding the lock (when known)
503
+ */
504
+ export class SprintLockHeldError extends WorkflowError {
505
+ /**
506
+ * @param {string} message
507
+ * @param {{ branch?: string|null, members?: string[]|null, existingPid?: number|null, details?: object, cause?: unknown }} [opts]
508
+ */
509
+ constructor(message, opts = {}) {
510
+ const { branch = null, members = null, existingPid = null, details, cause } = opts;
511
+ super(message, {
512
+ code: 'SPRINT_LOCK_HELD',
513
+ details: { branch, members, existingPid, ...details },
514
+ cause,
515
+ });
516
+ this.branch = branch;
517
+ this.members = members;
518
+ this.existingPid = existingPid;
519
+ }
520
+ }
521
+
522
+ /**
523
+ * apra-fleet-9ta.4 -- thrown when the Plan phase exhausts its planning
524
+ * rounds and the LAST round's plan-reviewer verdict was itself synthesized
525
+ * from an infrastructure dispatch failure (schema-repair exhaustion, a
526
+ * dropped transport, etc -- see `dispatchFailed` on the synthesized
527
+ * CHANGES_NEEDED verdict), never a genuine LLM verdict.
528
+ *
529
+ * Before this error existed, that same exhaustion threw
530
+ * SprintPlanRejectedError -- indistinguishable from a REAL plan rejection by
531
+ * the reviewer -- which misdiagnoses "the plan-reviewer's dispatch channel
532
+ * never came back" as "the reviewer looked at the plan and rejected it".
533
+ * The plan was never actually reviewed, so this is a distinct, infra-flavored
534
+ * failure a human/CI should treat as "retry the sprint", not "fix the plan".
535
+ *
536
+ * Deliberately NOT one of isTypedAbortError()'s curated abort classes (see
537
+ * runner.js): a dispatch-channel/transport blip is recoverable by simply
538
+ * re-running the sprint, unlike a genuine stall/budget/reviewer-contract
539
+ * abort or an unmergeable divergence, so it earns a terminal record (via
540
+ * isTerminalSprintFailure()'s blanket WorkflowError match) but not the
541
+ * push + [ABORTED] PR a real abort gets.
542
+ *
543
+ * @property {string|null} notes - the last plan-reviewer verdict's `notes`
544
+ * field (the synthesized dispatch-failure message), carried through for a
545
+ * human/CI reading the failure
546
+ */
547
+ export class PlanReviewDispatchFailedError extends WorkflowError {
548
+ /**
549
+ * @param {string} message
550
+ * @param {{ notes?: string|null, cycle?: number, planningRounds?: number, details?: object, cause?: unknown }} [opts]
551
+ */
552
+ constructor(message, opts = {}) {
553
+ const { notes = null, cycle, planningRounds, details, cause } = opts;
554
+ super(message, {
555
+ code: 'PLAN_REVIEW_DISPATCH_FAILED',
556
+ details: { notes, cycle, planningRounds, ...details },
557
+ cause,
558
+ });
559
+ this.notes = notes;
560
+ }
561
+ }
562
+
563
+ // ---------------------------------------------------------------------------
564
+ // apra-fleet-6z8.3 -- post-dispatch sync failure (NOT a dispatch failure)
565
+ // ---------------------------------------------------------------------------
566
+
567
+ /**
568
+ * Thrown by withGitSync when the agent dispatch COMPLETED successfully but the
569
+ * bracket's post-dispatch sync teardown (G-push / D-push) failed, and retrying
570
+ * just that sync step did not recover it.
571
+ *
572
+ * Why it needs its own type (apra-fleet-6z8, Symptom 2): withGitSync wraps the
573
+ * pre-dispatch pull, the LLM turn, and the post-dispatch sync in ONE bracket,
574
+ * so a DoltSyncError thrown by doltPushGuarded propagated out of the whole
575
+ * bracket. The Planner's PLANNER_DISPATCH_RETRY_DELAYS_MS ladder only saw "the
576
+ * bracket threw" and called dispatchPlannerOnce() again -- redispatching a
577
+ * brand-new Planner LLM turn even though the previous turn's output was already
578
+ * safely committed in the member's local beads clone, purely because an
579
+ * unrelated push step (e.g. missing VCS credentials) failed. Retry callers MUST
580
+ * treat this error as "do not redispatch": the turn already happened.
581
+ *
582
+ * @property {string|null} member - the member whose post-dispatch sync failed
583
+ * @property {unknown} dispatchResult - the COMPLETED dispatch's result, preserved
584
+ * so a caller that can proceed without the sync still has the turn's output
585
+ * @property {number} syncAttempts - how many times the sync step was attempted
586
+ */
587
+ export class PostDispatchSyncError extends WorkflowError {
588
+ /**
589
+ * @param {string} message
590
+ * @param {{ member?: string|null, dispatchResult?: unknown, syncAttempts?: number, details?: object, cause?: unknown }} [opts]
591
+ */
592
+ constructor(message, opts = {}) {
593
+ const { member = null, dispatchResult = undefined, syncAttempts = 1, details, cause } = opts;
594
+ super(message, {
595
+ code: 'POST_DISPATCH_SYNC_FAILED',
596
+ details: { member, syncAttempts, ...details },
597
+ cause,
598
+ });
599
+ this.member = member;
600
+ this.dispatchResult = dispatchResult;
601
+ this.syncAttempts = syncAttempts;
602
+ }
603
+ }
604
+
605
+ /**
606
+ * True when an error means "a COMPLETED dispatch's post-step sync failed" --
607
+ * i.e. the LLM turn itself already succeeded and re-running it would duplicate
608
+ * real work (duplicate beads writes, duplicate commits). A retry caller must
609
+ * NOT redispatch on this; the sync step has already been retried on its own
610
+ * inside withGitSync (apra-fleet-6z8.3).
611
+ * @param {unknown} err
612
+ * @returns {boolean}
613
+ */
614
+ export function isPostDispatchSyncFailure(err) {
615
+ return err instanceof PostDispatchSyncError;
616
+ }