@apralabs/apra-fleet 0.4.1 → 0.4.3

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 (476) hide show
  1. package/README.md +53 -12
  2. package/dist/agents/backlog-groomer.md +42 -21
  3. package/dist/agents/ci-watcher.md +14 -0
  4. package/dist/agents/deployer.md +59 -46
  5. package/dist/agents/doer.md +157 -134
  6. package/dist/agents/harvester.md +31 -32
  7. package/dist/agents/integ-test-runner.md +92 -113
  8. package/dist/agents/kb-reconciler.md +40 -42
  9. package/dist/agents/plan-reviewer.md +139 -63
  10. package/dist/agents/planner.md +176 -100
  11. package/dist/agents/regression-test-runner.md +77 -81
  12. package/dist/agents/reviewer.md +69 -85
  13. package/dist/agents/schemas/integ-test-runner-output.json +1 -1
  14. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  15. package/dist/agents/schemas/regression-test-runner-output.json +4 -17
  16. package/dist/cli/agent-transform.d.ts +83 -2
  17. package/dist/cli/agent-transform.d.ts.map +1 -1
  18. package/dist/cli/agent-transform.js +266 -21
  19. package/dist/cli/agent-transform.js.map +1 -1
  20. package/dist/cli/auth.d.ts.map +1 -1
  21. package/dist/cli/auth.js +29 -11
  22. package/dist/cli/auth.js.map +1 -1
  23. package/dist/cli/config.d.ts +7 -5
  24. package/dist/cli/config.d.ts.map +1 -1
  25. package/dist/cli/config.js +44 -43
  26. package/dist/cli/config.js.map +1 -1
  27. package/dist/cli/install.d.ts +33 -0
  28. package/dist/cli/install.d.ts.map +1 -1
  29. package/dist/cli/install.js +294 -61
  30. package/dist/cli/install.js.map +1 -1
  31. package/dist/cli/kb-directives.d.ts.map +1 -1
  32. package/dist/cli/kb-directives.js +2 -1
  33. package/dist/cli/kb-directives.js.map +1 -1
  34. package/dist/cli/register-member.d.ts.map +1 -1
  35. package/dist/cli/register-member.js +7 -3
  36. package/dist/cli/register-member.js.map +1 -1
  37. package/dist/cli/start.d.ts.map +1 -1
  38. package/dist/cli/start.js +7 -0
  39. package/dist/cli/start.js.map +1 -1
  40. package/dist/cli/uninstall.d.ts.map +1 -1
  41. package/dist/cli/uninstall.js +5 -3
  42. package/dist/cli/uninstall.js.map +1 -1
  43. package/dist/cli/watch.d.ts +26 -3
  44. package/dist/cli/watch.d.ts.map +1 -1
  45. package/dist/cli/watch.js +41 -9
  46. package/dist/cli/watch.js.map +1 -1
  47. package/dist/commands/kb-server.d.ts +3 -0
  48. package/dist/commands/kb-server.d.ts.map +1 -1
  49. package/dist/commands/kb-server.js +43 -3
  50. package/dist/commands/kb-server.js.map +1 -1
  51. package/dist/index.js +3 -3
  52. package/dist/os/git-bash-candidates.d.ts +35 -0
  53. package/dist/os/git-bash-candidates.d.ts.map +1 -0
  54. package/dist/os/git-bash-candidates.js +46 -0
  55. package/dist/os/git-bash-candidates.js.map +1 -0
  56. package/dist/os/index.d.ts +13 -4
  57. package/dist/os/index.d.ts.map +1 -1
  58. package/dist/os/index.js +17 -2
  59. package/dist/os/index.js.map +1 -1
  60. package/dist/os/linux.d.ts +6 -0
  61. package/dist/os/linux.d.ts.map +1 -1
  62. package/dist/os/linux.js +36 -3
  63. package/dist/os/linux.js.map +1 -1
  64. package/dist/os/os-commands.d.ts +68 -2
  65. package/dist/os/os-commands.d.ts.map +1 -1
  66. package/dist/os/os-commands.js.map +1 -1
  67. package/dist/os/windows-gitbash.d.ts +98 -0
  68. package/dist/os/windows-gitbash.d.ts.map +1 -0
  69. package/dist/os/windows-gitbash.js +259 -0
  70. package/dist/os/windows-gitbash.js.map +1 -0
  71. package/dist/os/windows.d.ts +6 -0
  72. package/dist/os/windows.d.ts.map +1 -1
  73. package/dist/os/windows.js +73 -8
  74. package/dist/os/windows.js.map +1 -1
  75. package/dist/providers/agy.d.ts +118 -8
  76. package/dist/providers/agy.d.ts.map +1 -1
  77. package/dist/providers/agy.js +580 -55
  78. package/dist/providers/agy.js.map +1 -1
  79. package/dist/providers/claude.d.ts +83 -4
  80. package/dist/providers/claude.d.ts.map +1 -1
  81. package/dist/providers/claude.js +365 -12
  82. package/dist/providers/claude.js.map +1 -1
  83. package/dist/providers/codex.d.ts +7 -4
  84. package/dist/providers/codex.d.ts.map +1 -1
  85. package/dist/providers/codex.js +24 -4
  86. package/dist/providers/codex.js.map +1 -1
  87. package/dist/providers/copilot.d.ts +7 -4
  88. package/dist/providers/copilot.d.ts.map +1 -1
  89. package/dist/providers/copilot.js +27 -4
  90. package/dist/providers/copilot.js.map +1 -1
  91. package/dist/providers/index.d.ts +0 -1
  92. package/dist/providers/index.d.ts.map +1 -1
  93. package/dist/providers/index.js +0 -3
  94. package/dist/providers/index.js.map +1 -1
  95. package/dist/providers/none.d.ts +7 -4
  96. package/dist/providers/none.d.ts.map +1 -1
  97. package/dist/providers/none.js +22 -4
  98. package/dist/providers/none.js.map +1 -1
  99. package/dist/providers/opencode.d.ts +6 -3
  100. package/dist/providers/opencode.d.ts.map +1 -1
  101. package/dist/providers/opencode.js +27 -4
  102. package/dist/providers/opencode.js.map +1 -1
  103. package/dist/providers/provider.d.ts +215 -11
  104. package/dist/providers/provider.d.ts.map +1 -1
  105. package/dist/providers/provider.js +58 -2
  106. package/dist/providers/provider.js.map +1 -1
  107. package/dist/services/agent-provisioner.js +2 -2
  108. package/dist/services/agent-provisioner.js.map +1 -1
  109. package/dist/services/agy-project.d.ts +102 -0
  110. package/dist/services/agy-project.d.ts.map +1 -0
  111. package/dist/services/agy-project.js +356 -0
  112. package/dist/services/agy-project.js.map +1 -0
  113. package/dist/services/auth-socket.js +4 -4
  114. package/dist/services/auth-web.js +1 -1
  115. package/dist/services/cloud/activity.js +2 -2
  116. package/dist/services/cloud/activity.js.map +1 -1
  117. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  118. package/dist/services/cloud/lifecycle.js +33 -4
  119. package/dist/services/cloud/lifecycle.js.map +1 -1
  120. package/dist/services/context-admission.d.ts.map +1 -1
  121. package/dist/services/context-admission.js +9 -7
  122. package/dist/services/context-admission.js.map +1 -1
  123. package/dist/services/credential-cleanup.d.ts.map +1 -1
  124. package/dist/services/credential-cleanup.js +47 -10
  125. package/dist/services/credential-cleanup.js.map +1 -1
  126. package/dist/services/exit-drain.d.ts +44 -0
  127. package/dist/services/exit-drain.d.ts.map +1 -0
  128. package/dist/services/exit-drain.js +52 -0
  129. package/dist/services/exit-drain.js.map +1 -0
  130. package/dist/services/github-app.d.ts.map +1 -1
  131. package/dist/services/github-app.js +32 -4
  132. package/dist/services/github-app.js.map +1 -1
  133. package/dist/services/http-transport.d.ts +1 -0
  134. package/dist/services/http-transport.d.ts.map +1 -1
  135. package/dist/services/http-transport.js +48 -1
  136. package/dist/services/http-transport.js.map +1 -1
  137. package/dist/services/knowledge/kb-config.d.ts +42 -0
  138. package/dist/services/knowledge/kb-config.d.ts.map +1 -0
  139. package/dist/services/knowledge/kb-config.js +54 -0
  140. package/dist/services/knowledge/kb-config.js.map +1 -0
  141. package/dist/services/knowledge/kb-providers.d.ts +7 -1
  142. package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
  143. package/dist/services/knowledge/kb-providers.js +191 -17
  144. package/dist/services/knowledge/kb-providers.js.map +1 -1
  145. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  146. package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
  149. package/dist/services/member-home.d.ts +1 -1
  150. package/dist/services/member-home.d.ts.map +1 -1
  151. package/dist/services/member-home.js +15 -12
  152. package/dist/services/member-home.js.map +1 -1
  153. package/dist/services/model-pricing.d.ts.map +1 -1
  154. package/dist/services/model-pricing.js +7 -8
  155. package/dist/services/model-pricing.js.map +1 -1
  156. package/dist/services/orphan-recovery.d.ts +6 -3
  157. package/dist/services/orphan-recovery.d.ts.map +1 -1
  158. package/dist/services/orphan-recovery.js +17 -14
  159. package/dist/services/orphan-recovery.js.map +1 -1
  160. package/dist/services/preflight-check.js +2 -2
  161. package/dist/services/preflight-check.js.map +1 -1
  162. package/dist/services/secret-token.d.ts +38 -0
  163. package/dist/services/secret-token.d.ts.map +1 -0
  164. package/dist/services/secret-token.js +51 -0
  165. package/dist/services/secret-token.js.map +1 -0
  166. package/dist/services/service-manager/types.d.ts +3 -1
  167. package/dist/services/service-manager/types.d.ts.map +1 -1
  168. package/dist/services/service-manager/windows.d.ts +14 -2
  169. package/dist/services/service-manager/windows.d.ts.map +1 -1
  170. package/dist/services/service-manager/windows.js +65 -7
  171. package/dist/services/service-manager/windows.js.map +1 -1
  172. package/dist/services/shell-probe.d.ts +131 -0
  173. package/dist/services/shell-probe.d.ts.map +1 -0
  174. package/dist/services/shell-probe.js +210 -0
  175. package/dist/services/shell-probe.js.map +1 -0
  176. package/dist/services/singleton.d.ts +2 -0
  177. package/dist/services/singleton.d.ts.map +1 -1
  178. package/dist/services/singleton.js +1 -1
  179. package/dist/services/singleton.js.map +1 -1
  180. package/dist/services/ssh.d.ts.map +1 -1
  181. package/dist/services/ssh.js +60 -4
  182. package/dist/services/ssh.js.map +1 -1
  183. package/dist/services/stall/find-log-file.d.ts.map +1 -1
  184. package/dist/services/stall/find-log-file.js +22 -16
  185. package/dist/services/stall/find-log-file.js.map +1 -1
  186. package/dist/services/stall/read-log-tail.d.ts.map +1 -1
  187. package/dist/services/stall/read-log-tail.js +26 -15
  188. package/dist/services/stall/read-log-tail.js.map +1 -1
  189. package/dist/services/stall/stall-detector.d.ts +53 -4
  190. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  191. package/dist/services/stall/stall-detector.js +212 -34
  192. package/dist/services/stall/stall-detector.js.map +1 -1
  193. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  194. package/dist/services/stall/stall-poller.js +35 -42
  195. package/dist/services/stall/stall-poller.js.map +1 -1
  196. package/dist/services/strategy.d.ts +9 -0
  197. package/dist/services/strategy.d.ts.map +1 -1
  198. package/dist/services/strategy.js +119 -8
  199. package/dist/services/strategy.js.map +1 -1
  200. package/dist/services/substitution-engine.js +2 -2
  201. package/dist/services/substitution-engine.js.map +1 -1
  202. package/dist/services/tool-registry.d.ts.map +1 -1
  203. package/dist/services/tool-registry.js +5 -3
  204. package/dist/services/tool-registry.js.map +1 -1
  205. package/dist/services/user-config.js +1 -1
  206. package/dist/services/user-config.js.map +1 -1
  207. package/dist/services/vcs/azure-devops.d.ts +67 -2
  208. package/dist/services/vcs/azure-devops.d.ts.map +1 -1
  209. package/dist/services/vcs/azure-devops.js +281 -15
  210. package/dist/services/vcs/azure-devops.js.map +1 -1
  211. package/dist/services/vcs/bitbucket.d.ts.map +1 -1
  212. package/dist/services/vcs/bitbucket.js +16 -0
  213. package/dist/services/vcs/bitbucket.js.map +1 -1
  214. package/dist/services/vcs/github.d.ts.map +1 -1
  215. package/dist/services/vcs/github.js +24 -0
  216. package/dist/services/vcs/github.js.map +1 -1
  217. package/dist/services/vcs/types.d.ts +123 -2
  218. package/dist/services/vcs/types.d.ts.map +1 -1
  219. package/dist/skills/fleet-sprint-cli/SKILL.md +20 -1
  220. package/dist/skills/pm/SKILL.md +1 -2
  221. package/dist/skills/pm/cost.md +0 -4
  222. package/dist/skills/pm/fleet-addendum.md +2 -3
  223. package/dist/tools/check-status.d.ts +7 -4
  224. package/dist/tools/check-status.d.ts.map +1 -1
  225. package/dist/tools/check-status.js +5 -3
  226. package/dist/tools/check-status.js.map +1 -1
  227. package/dist/tools/cloud-control.js +2 -2
  228. package/dist/tools/cloud-control.js.map +1 -1
  229. package/dist/tools/compose-permissions.d.ts +6 -0
  230. package/dist/tools/compose-permissions.d.ts.map +1 -1
  231. package/dist/tools/compose-permissions.js +211 -50
  232. package/dist/tools/compose-permissions.js.map +1 -1
  233. package/dist/tools/credential-store-set.js +1 -1
  234. package/dist/tools/execute-command.d.ts.map +1 -1
  235. package/dist/tools/execute-command.js +56 -29
  236. package/dist/tools/execute-command.js.map +1 -1
  237. package/dist/tools/execute-prompt.d.ts +15 -2
  238. package/dist/tools/execute-prompt.d.ts.map +1 -1
  239. package/dist/tools/execute-prompt.js +1214 -873
  240. package/dist/tools/execute-prompt.js.map +1 -1
  241. package/dist/tools/kb-capture.d.ts +2 -2
  242. package/dist/tools/kb-capture.d.ts.map +1 -1
  243. package/dist/tools/kb-capture.js +29 -5
  244. package/dist/tools/kb-capture.js.map +1 -1
  245. package/dist/tools/kb-export.d.ts +2 -2
  246. package/dist/tools/kb-export.d.ts.map +1 -1
  247. package/dist/tools/kb-export.js +3 -28
  248. package/dist/tools/kb-export.js.map +1 -1
  249. package/dist/tools/kb-feedback.d.ts.map +1 -1
  250. package/dist/tools/kb-feedback.js +3 -1
  251. package/dist/tools/kb-feedback.js.map +1 -1
  252. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
  253. package/dist/tools/kb-freshness-sweep.js +3 -1
  254. package/dist/tools/kb-freshness-sweep.js.map +1 -1
  255. package/dist/tools/kb-import.d.ts.map +1 -1
  256. package/dist/tools/kb-import.js +2 -1
  257. package/dist/tools/kb-import.js.map +1 -1
  258. package/dist/tools/kb-list.d.ts.map +1 -1
  259. package/dist/tools/kb-list.js +3 -1
  260. package/dist/tools/kb-list.js.map +1 -1
  261. package/dist/tools/kb-query.d.ts +2 -2
  262. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
  263. package/dist/tools/kb-reconcile-prefilter.js +3 -1
  264. package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
  265. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
  266. package/dist/tools/kb-resolve-contradiction.js +3 -1
  267. package/dist/tools/kb-resolve-contradiction.js.map +1 -1
  268. package/dist/tools/kb-setup.d.ts.map +1 -1
  269. package/dist/tools/kb-setup.js +125 -20
  270. package/dist/tools/kb-setup.js.map +1 -1
  271. package/dist/tools/kb-stats.d.ts.map +1 -1
  272. package/dist/tools/kb-stats.js +64 -43
  273. package/dist/tools/kb-stats.js.map +1 -1
  274. package/dist/tools/list-members.d.ts +2 -2
  275. package/dist/tools/list-members.d.ts.map +1 -1
  276. package/dist/tools/list-members.js +7 -2
  277. package/dist/tools/list-members.js.map +1 -1
  278. package/dist/tools/member-detail.d.ts +2 -2
  279. package/dist/tools/member-detail.d.ts.map +1 -1
  280. package/dist/tools/member-detail.js +22 -3
  281. package/dist/tools/member-detail.js.map +1 -1
  282. package/dist/tools/member-reservation.d.ts +58 -1
  283. package/dist/tools/member-reservation.d.ts.map +1 -1
  284. package/dist/tools/member-reservation.js +71 -18
  285. package/dist/tools/member-reservation.js.map +1 -1
  286. package/dist/tools/monitor-task.d.ts.map +1 -1
  287. package/dist/tools/monitor-task.js +17 -2
  288. package/dist/tools/monitor-task.js.map +1 -1
  289. package/dist/tools/provision-auth.d.ts +80 -1
  290. package/dist/tools/provision-auth.d.ts.map +1 -1
  291. package/dist/tools/provision-auth.js +147 -59
  292. package/dist/tools/provision-auth.js.map +1 -1
  293. package/dist/tools/provision-vcs-auth.d.ts +96 -3
  294. package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
  295. package/dist/tools/provision-vcs-auth.js +254 -88
  296. package/dist/tools/provision-vcs-auth.js.map +1 -1
  297. package/dist/tools/register-member.d.ts +21 -12
  298. package/dist/tools/register-member.d.ts.map +1 -1
  299. package/dist/tools/register-member.js +141 -16
  300. package/dist/tools/register-member.js.map +1 -1
  301. package/dist/tools/remove-member.d.ts.map +1 -1
  302. package/dist/tools/remove-member.js +29 -4
  303. package/dist/tools/remove-member.js.map +1 -1
  304. package/dist/tools/revoke-vcs-auth.js +2 -2
  305. package/dist/tools/revoke-vcs-auth.js.map +1 -1
  306. package/dist/tools/send-email.d.ts +2 -2
  307. package/dist/tools/setup-git-app.d.ts.map +1 -1
  308. package/dist/tools/setup-git-app.js +11 -7
  309. package/dist/tools/setup-git-app.js.map +1 -1
  310. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  311. package/dist/tools/setup-ssh-key.js +2 -1
  312. package/dist/tools/setup-ssh-key.js.map +1 -1
  313. package/dist/tools/shutdown-server.d.ts +2 -0
  314. package/dist/tools/shutdown-server.d.ts.map +1 -1
  315. package/dist/tools/shutdown-server.js +23 -1
  316. package/dist/tools/shutdown-server.js.map +1 -1
  317. package/dist/tools/stop-prompt.js +2 -2
  318. package/dist/tools/stop-prompt.js.map +1 -1
  319. package/dist/tools/update-agent-cli.js +2 -2
  320. package/dist/tools/update-agent-cli.js.map +1 -1
  321. package/dist/tools/update-member.d.ts +21 -12
  322. package/dist/tools/update-member.d.ts.map +1 -1
  323. package/dist/tools/update-member.js +61 -12
  324. package/dist/tools/update-member.js.map +1 -1
  325. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  326. package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
  327. package/dist/tools/vcs-credential-exec.js +197 -0
  328. package/dist/tools/vcs-credential-exec.js.map +1 -0
  329. package/dist/types.d.ts +24 -1
  330. package/dist/types.d.ts.map +1 -1
  331. package/dist/utils/agent-helpers.d.ts +36 -0
  332. package/dist/utils/agent-helpers.d.ts.map +1 -1
  333. package/dist/utils/agent-helpers.js +39 -1
  334. package/dist/utils/agent-helpers.js.map +1 -1
  335. package/dist/utils/log-helpers.d.ts.map +1 -1
  336. package/dist/utils/log-helpers.js +2 -2
  337. package/dist/utils/log-helpers.js.map +1 -1
  338. package/dist/utils/platform.d.ts +7 -0
  339. package/dist/utils/platform.d.ts.map +1 -1
  340. package/dist/utils/platform.js +11 -1
  341. package/dist/utils/platform.js.map +1 -1
  342. package/dist/utils/prompt-errors.d.ts.map +1 -1
  343. package/dist/utils/prompt-errors.js +7 -1
  344. package/dist/utils/prompt-errors.js.map +1 -1
  345. package/dist/utils/shell-escape.d.ts +16 -0
  346. package/dist/utils/shell-escape.d.ts.map +1 -1
  347. package/dist/utils/shell-escape.js +22 -2
  348. package/dist/utils/shell-escape.js.map +1 -1
  349. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  350. package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
  351. package/dist/utils/vcs-provider-detect.js +109 -0
  352. package/dist/utils/vcs-provider-detect.js.map +1 -0
  353. package/dist/utils/workspace-trust.d.ts +20 -17
  354. package/dist/utils/workspace-trust.d.ts.map +1 -1
  355. package/dist/utils/workspace-trust.js +91 -1
  356. package/dist/utils/workspace-trust.js.map +1 -1
  357. package/dist/workflows/auto-sprint.js +180 -32
  358. package/package.json +7 -5
  359. package/packages/apra-fleet-client/src/client/api.mjs +403 -12
  360. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  361. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  362. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +42 -21
  363. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +14 -0
  364. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -46
  365. package/packages/apra-fleet-se/apra-pm/agents/doer.md +157 -134
  366. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +31 -32
  367. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +92 -113
  368. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +40 -42
  369. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +139 -63
  370. package/packages/apra-fleet-se/apra-pm/agents/planner.md +176 -100
  371. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +77 -81
  372. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +69 -85
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
  376. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -2
  377. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -4
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -3
  379. package/packages/apra-fleet-se/bin/cli.mjs +280 -3
  380. package/packages/apra-fleet-se/bin/serve.mjs +114 -5
  381. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
  382. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
  383. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
  384. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
  385. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
  386. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
  387. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  388. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
  389. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +199 -34
  390. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
  391. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
  392. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
  393. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  394. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
  395. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
  396. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +285 -4
  397. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +3 -3
  398. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  399. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +12 -12
  400. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
  401. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  402. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
  403. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1054 -39
  404. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +308 -0
  405. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  406. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  407. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  408. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +556 -0
  409. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
  410. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
  411. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  412. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
  413. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  414. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
  415. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -0
  416. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  417. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  418. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  419. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
  420. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
  421. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
  422. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
  423. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
  424. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  425. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
  426. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
  427. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
  428. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
  429. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
  430. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
  431. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
  432. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
  433. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  434. package/packages/apra-fleet-se/fleet-sprint/runner.js +1672 -9072
  435. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
  436. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +159 -0
  437. package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
  438. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
  439. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
  440. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +20 -1
  441. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
  442. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
  443. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
  444. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -0
  445. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  446. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +211 -0
  447. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
  448. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +204 -19
  449. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +707 -12
  450. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  451. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
  452. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +191 -43
  453. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +333 -6
  454. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +165 -0
  455. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +167 -37
  456. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  457. package/packages/apra-fleet-se/package.json +1 -1
  458. package/packages/apra-fleet-workflow/src/viewer/index.mjs +178 -1
  459. package/packages/apra-fleet-workflow/src/workflow/index.mjs +478 -32
  460. package/skills/fleet/SKILL.md +27 -16
  461. package/skills/fleet/auth-azdevops.md +57 -7
  462. package/skills/fleet/auth-bitbucket.md +5 -5
  463. package/skills/fleet/auth-github.md +7 -6
  464. package/skills/fleet/beads-conflict-resolution.md +141 -0
  465. package/skills/fleet/beads.md +16 -12
  466. package/skills/fleet/onboarding.md +6 -6
  467. package/skills/fleet/permissions.md +11 -7
  468. package/skills/fleet/profiles/node.json +1 -1
  469. package/skills/fleet/skill-matrix.md +1 -1
  470. package/skills/fleet/troubleshooting.md +4 -3
  471. package/version.json +1 -1
  472. package/dist/providers/gemini.d.ts +0 -52
  473. package/dist/providers/gemini.d.ts.map +0 -1
  474. package/dist/providers/gemini.js +0 -236
  475. package/dist/providers/gemini.js.map +0 -1
  476. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
@@ -0,0 +1,301 @@
1
+ // Reviewer-verdict bead transitions for fleet-sprint (apra-fleet-3swo.4.7):
2
+ // the reopen/replan/close transitions the ORCHESTRATOR -- never the LLM --
3
+ // applies to beads after a role returns a verdict. Extracted out of runner.js;
4
+ // runner.js re-exports every symbol it previously exported from this region,
5
+ // so existing importers of fleet-sprint/runner.js resolve unchanged.
6
+ //
7
+ // THREE CALL SITES, ONE GUARD. Three places apply a reviewer-shaped verdict to
8
+ // beads, and before this extraction only two of them were guarded:
9
+ //
10
+ // 1. the per-round reviewer inside the Develop/Review loop,
11
+ // 2. Final Review, and
12
+ // 3. Re-Review (the "0 open beads at goal but the last verdict was not
13
+ // APPROVED" branch) -- which looped over reopenIds issuing
14
+ // `bd update <id> --status=open` with NO goal-scope guard at all.
15
+ //
16
+ // Site 3's omission was a real hole, not a deliberate exemption: reopening a
17
+ // DEFERRED below-goal bead injects work the sprint no longer targets and pins
18
+ // the verdict at CHANGES_NEEDED forever -- the exact failure the other two
19
+ // sites guard against. All three now go through applyGuardedReopens() below,
20
+ // so the guard cannot be forgotten by a fourth site either.
21
+ //
22
+ // WHAT WAS UNIFIED AND WHAT WAS DELIBERATELY NOT. The GUARD is unified. The
23
+ // PAYLOAD SHAPES are not: the three sites take three different reopen-entry
24
+ // shapes (site 1 bare string, site 2 `{id, reason}` with BOTH fields
25
+ // required, site 3 bare string), each with its own producer on the other end
26
+ // of a dispatch contract. Normalising the shape would be a behaviour change
27
+ // to those contracts, not a move, so each site keeps its own `parseEntry` and
28
+ // its own `buildReopenCommand` while sharing the allowlist, the below-goal
29
+ // check, the skip log text and the control flow.
30
+ //
31
+ // FAIL OPEN, DELIBERATELY. When the scope lookup THROWS, the allowlist is set
32
+ // to null and every reopen is applied UNGUARDED rather than dropped. This is
33
+ // intentional and must not be "hardened" into a fail-closed drop: a failed
34
+ // scope lookup is an infrastructure problem, and silently swallowing a
35
+ // reviewer's reopens because of one would lose real review signal with no
36
+ // trace. A null allowlist therefore means "apply everything", never "skip
37
+ // everything" -- see buildReopenAllowlist() and isDeferredScopeReopen().
38
+ // =============================================================================
39
+
40
+ /**
41
+ * Detects the reviewer contract violation described on
42
+ * `ReviewerContractViolationError`: a `CHANGES_NEEDED` verdict naming nothing
43
+ * to reopen, proposing no follow-up work, AND naming no scoped-replan targets
44
+ * is schema-legal but self-contradictory -- the orchestrator has nothing to
45
+ * act on, so the sprint cannot make progress off of it. A non-empty
46
+ * `replanIds` exempts the verdict from that hard abort even with empty
47
+ * reopenIds/newTasks -- NOT because the field is guaranteed to be consumed
48
+ * (foldReplanIds() below only accepts replanIds entries ALSO named in
49
+ * reopenIds this round), but because a verdict that names a genuine replan
50
+ * intent in `notes` still represents real reviewer signal worth an ordinary
51
+ * next-round retry rather than a hard sprint abort.
52
+ *
53
+ * @param {{ verdict: string, reopenIds?: string[], replanIds?: string[], newTasks?: object[] }} verdict
54
+ * @returns {boolean}
55
+ */
56
+ export function isReviewerContractViolation(verdict) {
57
+ return verdict.verdict === 'CHANGES_NEEDED'
58
+ && (!verdict.reopenIds || verdict.reopenIds.length === 0)
59
+ && (!verdict.newTasks || verdict.newTasks.length === 0)
60
+ && (!verdict.replanIds || verdict.replanIds.length === 0);
61
+ }
62
+
63
+ /**
64
+ * Look up the beads currently in sprint scope, as the goal-scope allowlist
65
+ * every reopen is checked against.
66
+ *
67
+ * FAILS OPEN BY DESIGN: any throw from the scope lookup yields `null`, which
68
+ * isDeferredScopeReopen() reads as "apply every reopen unguarded". Dropping a
69
+ * reviewer's reopens because a `bd list` failed would silently lose review
70
+ * signal; a redundant unguarded reopen is the far cheaper failure.
71
+ *
72
+ * @param {(rest: string) => Promise<Array<object>>} bdListScoped
73
+ * @returns {Promise<Map<string, object>|null>} the allowlist, or null on lookup failure
74
+ */
75
+ export async function buildReopenAllowlist(bdListScoped) {
76
+ try {
77
+ const inScopeNow = await bdListScoped('');
78
+ return new Map(inScopeNow.map((b) => [b.id, b]));
79
+ } catch {
80
+ return null; // lookup failed -- apply reopens unguarded rather than dropping them
81
+ }
82
+ }
83
+
84
+ /**
85
+ * Coerce a goal-priority ceiling to the NUMBER the priority comparison needs.
86
+ *
87
+ * runner.js's `goalMax` closure variable is goalPriorityMax(goal), which
88
+ * returns the STRING form ('P2') because its other consumers want exactly
89
+ * that: `bd list --priority-max=P2` and the human-facing log text. A bead's
90
+ * own `priority`, though, is a NUMBER (3).
91
+ *
92
+ * That mismatch was a live, silent bug in the pre-extraction guard, which
93
+ * compared them directly:
94
+ *
95
+ * bead.priority > goalMax // 3 > 'P2' -> NaN comparison -> false
96
+ *
97
+ * `>` coerces the string to a number, `Number('P2')` is NaN, and every
98
+ * comparison against NaN is false -- so the goal-scope guard NEVER skipped
99
+ * anything, at ANY site, for ANY priority (even a P9 bead in a P1 sprint
100
+ * returned false). The two "guarded" sites were guarded in appearance only.
101
+ * runner.js already knew the numeric form was required elsewhere and derived
102
+ * it explicitly (`Number(goalPriorityMax(goal).slice(1))` in
103
+ * partitionByGoalMembership and in the dashboard payload); only this guard
104
+ * missed it.
105
+ *
106
+ * Accepts either form so callers may pass the string ceiling they already
107
+ * have; returns NaN for anything unparseable, which -- since every comparison
108
+ * against NaN is false -- degrades to the historical never-skip behaviour
109
+ * rather than to skipping everything.
110
+ *
111
+ * @param {number|string} goalMax - e.g. 2 or 'P2'
112
+ * @returns {number}
113
+ */
114
+ export function normalizeGoalMax(goalMax) {
115
+ if (typeof goalMax === 'number') return goalMax;
116
+ if (typeof goalMax === 'string') return Number(goalMax.replace(/^[Pp]/, ''));
117
+ return NaN;
118
+ }
119
+
120
+ /**
121
+ * The goal-scope check itself: is `id` a bead this sprint has DEFERRED below
122
+ * its goal priority, and therefore must not reopen?
123
+ *
124
+ * Every clause matters. A null `allowlist` (lookup failed) is never a skip --
125
+ * see buildReopenAllowlist. A bead absent from the allowlist is never a skip
126
+ * either: it is out-of-scope or brand new, and the pre-extraction sites
127
+ * deliberately let those through rather than guessing. Only a bead the
128
+ * allowlist KNOWS about, with a NUMERIC priority strictly worse (higher) than
129
+ * the goal max, is refused -- and `goalMax` is normalized to a number first,
130
+ * because comparing against the raw 'P2' string is what made this guard inert
131
+ * (see normalizeGoalMax).
132
+ *
133
+ * @param {Map<string, object>|null} allowlist
134
+ * @param {string} id
135
+ * @param {number|string} goalMax - numeric ceiling, or the 'Pn' string form
136
+ * @returns {{ deferred: boolean, priority: number|null }}
137
+ */
138
+ export function isDeferredScopeReopen(allowlist, id, goalMax) {
139
+ const bead = allowlist ? allowlist.get(id) : null;
140
+ const max = normalizeGoalMax(goalMax);
141
+ if (allowlist && bead && typeof bead.priority === 'number' && bead.priority > max) {
142
+ return { deferred: true, priority: bead.priority };
143
+ }
144
+ return { deferred: false, priority: bead && typeof bead.priority === 'number' ? bead.priority : null };
145
+ }
146
+
147
+ /**
148
+ * The single reopen-entry parser for the two sites whose reopenIds are BARE
149
+ * STRINGS carrying no reason (the per-round reviewer and Re-Review).
150
+ *
151
+ * @param {unknown} entry
152
+ * @returns {{ id: string, reason: string }|{ error: string }}
153
+ */
154
+ export function parseBareIdEntry(entry) {
155
+ const id = typeof entry === 'string' ? entry.trim() : '';
156
+ if (!id) return { error: `expected a bead id string -- ${JSON.stringify(entry)}` };
157
+ return { id, reason: '' };
158
+ }
159
+
160
+ /**
161
+ * Final Review's reopen-entry parser: `{id, reason}` with BOTH fields
162
+ * required. Unlike the per-round reviewer's single blanket `notes` string
163
+ * shared across every id, each Final Review entry carries its OWN reason, so
164
+ * an entry missing either field has nothing usable to record and is refused.
165
+ *
166
+ * @param {unknown} entry
167
+ * @returns {{ id: string, reason: string }|{ error: string }}
168
+ */
169
+ export function parseIdWithReasonEntry(entry) {
170
+ const id = entry && typeof entry.id === 'string' ? entry.id.trim() : '';
171
+ const reason = entry && typeof entry.reason === 'string' ? entry.reason.trim() : '';
172
+ if (!id || !reason) {
173
+ return { error: `a malformed entry (both id and reason are required) -- ${JSON.stringify(entry)}` };
174
+ }
175
+ return { id, reason };
176
+ }
177
+
178
+ /**
179
+ * Apply a verdict's reopenIds to beads, behind the shared goal-scope guard.
180
+ * This is the ONE path all three verdict sites now take.
181
+ *
182
+ * The below-goal skip emits the identical "deferred scope, not reopened"
183
+ * outcome at every site -- that exact phrasing is what makes the guard
184
+ * greppable in a run log and is asserted by the extraction's tests, so keep
185
+ * it verbatim if you touch this.
186
+ *
187
+ * @param {object} o
188
+ * @param {Array<unknown>} o.entries - the verdict's raw reopenIds, in its own shape
189
+ * @param {(rest: string) => Promise<Array<object>>} o.bdListScoped - scope lookup for the allowlist
190
+ * @param {number} o.goalMax - worst (numerically highest) priority this sprint targets
191
+ * @param {string} o.goal - the goal label, for log text (e.g. 'P1/P2')
192
+ * @param {string} o.logPrefix - site label for log lines (e.g. 'Reviewer reopenIds')
193
+ * @param {(msg: string) => void} o.log
194
+ * @param {(cmd: string, opts: object) => Promise<any>} o.command
195
+ * @param {string} o.member - the member every `bd` command here is dispatched to
196
+ * @param {(entry: unknown) => {id: string, reason: string}|{error: string}} [o.parseEntry]
197
+ * @param {(e: {id: string, reason: string}) => {cmd: string, label: string}|null} o.buildReopenCommand
198
+ * @param {(e: {id: string, reason: string}) => void} [o.onReopened] - per-bead side effects (thrash counters, feedback routing)
199
+ * @param {(e: {id: string, reason: string}, err: Error) => void} [o.onEntryError] - when present, a throwing entry is non-fatal and reported here
200
+ * @returns {Promise<string[]>} the ids ACTUALLY reopened (survived the guard)
201
+ */
202
+ export async function applyGuardedReopens(o) {
203
+ const {
204
+ entries, bdListScoped, goalMax, goal, logPrefix, log, command, member,
205
+ parseEntry = parseBareIdEntry, buildReopenCommand, onReopened, onEntryError,
206
+ } = o;
207
+
208
+ const list = Array.isArray(entries) ? entries : [];
209
+ // Short-circuit an empty verdict WITHOUT issuing the scope lookup: the
210
+ // pre-extraction sites both guarded the lookup on a non-empty reopenIds,
211
+ // and a `bd list` per empty verdict is real dispatch cost.
212
+ if (list.length === 0) return [];
213
+
214
+ const allowlist = await buildReopenAllowlist(bdListScoped);
215
+ const reopenedIds = [];
216
+
217
+ for (const entry of list) {
218
+ const parsed = parseEntry(entry);
219
+ if (parsed.error) {
220
+ log(`${logPrefix}: SKIPPED ${parsed.error}`);
221
+ continue;
222
+ }
223
+
224
+ const { deferred, priority } = isDeferredScopeReopen(allowlist, parsed.id, goalMax);
225
+ if (deferred) {
226
+ log(`${logPrefix}: SKIPPED '${parsed.id}' (priority P${priority} is below this sprint's goal ${goal} -- deferred scope, not reopened).`);
227
+ continue;
228
+ }
229
+
230
+ try {
231
+ const built = buildReopenCommand(parsed);
232
+ // A builder may refuse an entry it cannot render safely (Final
233
+ // Review's reason sanitizing to empty); it has already logged why.
234
+ if (!built) continue;
235
+ await command(built.cmd, { member_name: member, silent: true, label: built.label });
236
+ reopenedIds.push(parsed.id);
237
+ if (onReopened) onReopened(parsed);
238
+ } catch (err) {
239
+ if (!onEntryError) throw err;
240
+ onEntryError(parsed, err);
241
+ }
242
+ }
243
+
244
+ return reopenedIds;
245
+ }
246
+
247
+ /**
248
+ * Fold a round's reviewer `replanIds` into the cycle's running replan union.
249
+ * Only the per-round reviewer site uses this; Final Review and Re-Review have
250
+ * no scoped-replan machinery to feed.
251
+ *
252
+ * Two independent refusals, each logged so the drop is visible in the run log
253
+ * rather than vanishing with no trace:
254
+ *
255
+ * 1. NOT ALSO REOPENED. An id named in replanIds without ALSO being named
256
+ * in (and surviving the guard on) this round's reopenIds is DROPPED and
257
+ * never reaches the scoped-replan machinery. buildReviewerPrompt
258
+ * requires replanIds to be a subset of reopenIds; this is the
259
+ * enforcement side. Note the subset is checked against ids ACTUALLY
260
+ * reopened, so a below-goal id skipped by the scope guard cannot sneak
261
+ * back in through replanIds.
262
+ * 2. ALREADY REPLANNED THIS CYCLE. A bead that has already been through one
263
+ * in-cycle scoped replan is refused a SECOND: it stays reopened (real
264
+ * dev feedback still applies) but is not re-added, so the develop loop
265
+ * never dispatches a second scoped planner pass for it -- it is handed
266
+ * to the next cycle's planner instead. This is what makes "max one
267
+ * scoped replan per bead per cycle" hold regardless of the round budget.
268
+ *
269
+ * @param {object} o
270
+ * @param {string[]|undefined} o.replanIds - the verdict's replanIds (absent on verdicts that do not use it)
271
+ * @param {Set<string>} o.reopenedIds - ids actually reopened this round
272
+ * @param {Set<string>} o.replannedThisCycle - beads already scoped-replanned this cycle
273
+ * @param {number|string} o.cycle - cycle label, for log text
274
+ * @param {(msg: string) => void} o.log
275
+ * @returns {string[]} the ids accepted into the cycle's replan union
276
+ */
277
+ export function foldReplanIds(o) {
278
+ const { replanIds, reopenedIds, replannedThisCycle, cycle, log } = o;
279
+ const accepted = [];
280
+ for (const id of (replanIds || [])) {
281
+ if (!reopenedIds.has(id)) {
282
+ log(
283
+ `[fleet-sprint] replanIds: DROPPED '${id}' -- not also named in this round's reopenIds ` +
284
+ `(reviewer prompt requires replanIds to be a subset of reopenIds), so it never reaches the ` +
285
+ `scoped-replan machinery.`
286
+ );
287
+ continue;
288
+ }
289
+ if (replannedThisCycle.has(id)) {
290
+ log(
291
+ `[fleet-sprint] replan loop guard: bead ${id} was already scoped-replanned once this cycle ` +
292
+ `(C${cycle}) and a reviewer has flagged it for replan AGAIN -- refusing a second in-cycle scoped ` +
293
+ `replan (max one per bead per cycle). It stays reopened and is handed off to the next cycle's ` +
294
+ `planner rather than re-planned again now.`
295
+ );
296
+ continue;
297
+ }
298
+ accepted.push(id);
299
+ }
300
+ return accepted;
301
+ }
@@ -0,0 +1,96 @@
1
+ // The pure branch-selection decision helper for fleet-sprint's Ensure Sprint
2
+ // Branch phase (apra-fleet-3swo.3.6). Moved verbatim out of runner.js --
3
+ // runner.js imports it back for its own Ensure Sprint Branch phase and for
4
+ // resyncReacquiredMember(). This is a move-only extraction: no I/O, no
5
+ // behaviour change -- the helper stays pure.
6
+
7
+ // Pure branch-selection decision for the Ensure Sprint Branch phase. Given the
8
+ // outcomes of the probes that phase issues -- a soft-failed
9
+ // `git fetch origin/<branch>` and, when that reports the ref is missing, a
10
+ // local-branch existence probe -- this decides which checkout command to run,
11
+ // or that the phase must abort rather than touch git at all. No I/O of its
12
+ // own; the caller still issues the command() calls and does the logging.
13
+ //
14
+ // Returns one of:
15
+ // { action: 'abort', message } -- the fetch failed for a reason other than
16
+ // "branch doesn't exist yet", or local and origin have diverged. The
17
+ // caller must throw and never attempt a checkout: a transient fetch
18
+ // failure misread as "new branch" would reset the branch to base and
19
+ // destroy pushed work.
20
+ // { action: 'checkout', reused: true, command } -- reuse an existing local
21
+ // branch as-is (plain `git checkout`, no reset), preserving commits that
22
+ // exist only locally.
23
+ // { action: 'checkout', reused: false, command, startPoint } -- normal
24
+ // `git checkout -B <branch> <startPoint>`, where startPoint is
25
+ // `origin/<branch>` when the fetch succeeded and `origin/<baseBranch>`
26
+ // when the branch is genuinely new.
27
+ //
28
+ // When the fetch succeeds and a local branch also exists, the two tips can
29
+ // still disagree, because a doer may have committed without its push
30
+ // succeeding. `localTipStatus` -- the caller's comparison of the two tips via
31
+ // `git merge-base --is-ancestor` in both directions -- resolves that:
32
+ // 'behind-or-equal' -- local holds nothing origin does not; safe to reset.
33
+ // 'ahead' -- local holds commits origin does not and origin holds
34
+ // none local does not; reuse the local branch so those
35
+ // commits survive.
36
+ // 'diverged' -- neither tip is an ancestor of the other; abort rather
37
+ // than attempt any automatic merge or rebase, since
38
+ // either direction could discard real commits.
39
+ export function decideEnsureBranchAction({ branch, baseBranch, branchFetchOk, branchFetchError, localBranchExists, localTipStatus, localSha, remoteSha }) {
40
+ // A failed fetch is only safe to read as "branch doesn't exist yet" when
41
+ // git says exactly that. Any other failure -- network blip, auth expiry,
42
+ // DNS hiccup -- must not fall back to origin/<baseBranch>, or a transient
43
+ // error would silently reset the branch to base.
44
+ if (!branchFetchOk && !/couldn't find remote ref/i.test(branchFetchError || '')) {
45
+ return {
46
+ action: 'abort',
47
+ message:
48
+ `Ensure Sprint Branch: fetch of existing branch 'origin/${branch}' ` +
49
+ `failed for a reason other than "branch doesn't exist" (${branchFetchError || 'unknown error'}) -- ` +
50
+ `refusing to silently fall back to resetting to base, since the branch may actually exist with real ` +
51
+ `pushed work and this fetch failure could be transient. Investigate and retry.`,
52
+ };
53
+ }
54
+
55
+ // Both refs exist and neither tip is an ancestor of the other: never
56
+ // attempt an automatic merge or rebase, abort and let a human reconcile.
57
+ if (branchFetchOk && localBranchExists && localTipStatus === 'diverged') {
58
+ const shaNote = (localSha || remoteSha)
59
+ ? ` (local ${localSha || 'unknown'} vs 'origin/${branch}' ${remoteSha || 'unknown'} -- if 'git branch -vv' ` +
60
+ `on the machine you are inspecting does not show '${branch}' at all, this member is very likely ` +
61
+ `dispatching commands against a DIFFERENT git working directory than the one you checked; verify the ` +
62
+ `member's actual registered working directory before assuming this is a real divergence.)`
63
+ : '';
64
+ return {
65
+ action: 'abort',
66
+ message:
67
+ `Ensure Sprint Branch: local branch '${branch}' has diverged from 'origin/${branch}' ` +
68
+ `(neither is an ancestor of the other) -- refusing to reset or auto-merge, since either direction ` +
69
+ `could silently discard real commits. A human needs to investigate and reconcile the two branches ` +
70
+ `manually before this sprint can safely proceed.${shaNote}`,
71
+ };
72
+ }
73
+
74
+ const startPoint = branchFetchOk ? `origin/${branch}` : `origin/${baseBranch}`;
75
+ // Reuse the local branch as-is (no reset) whenever the remote ref is
76
+ // missing entirely, or it exists but the local branch is strictly ahead of
77
+ // it -- resetting would discard committed-but-unpushed local work.
78
+ const reuseLocalBranch =
79
+ (!branchFetchOk && !!localBranchExists) ||
80
+ (branchFetchOk && !!localBranchExists && localTipStatus === 'ahead');
81
+
82
+ if (reuseLocalBranch) {
83
+ return {
84
+ action: 'checkout',
85
+ reused: true,
86
+ command: `git checkout ${branch}`,
87
+ };
88
+ }
89
+
90
+ return {
91
+ action: 'checkout',
92
+ reused: false,
93
+ command: `git checkout -B ${branch} ${startPoint}`,
94
+ startPoint,
95
+ };
96
+ }
@@ -172,6 +172,14 @@ export async function dispatchConflictResolutionAgent({ agent, member, branch, u
172
172
  member_name: member,
173
173
  label: `Tier 2 conflict resolution [${unmergedPaths.join(', ')}]`,
174
174
  model,
175
+ // EXPLICITLY a fresh session. The runbook above is entirely
176
+ // self-contained (it names the member, the branch and every
177
+ // conflicted path), and the member's stored last session is whatever
178
+ // role dispatch happened to run there -- resuming it would drop a git
179
+ // conflict-resolution instruction into an unrelated conversation.
180
+ // Never rely on an omitted `resume`: execute_prompt defaults it to
181
+ // true, i.e. best-effort reattachment to exactly that stale session.
182
+ resume: false,
175
183
  timeout_s: 1800,
176
184
  max_total_s: 1800,
177
185
  });