@apralabs/apra-fleet 0.4.2 → 0.4.4

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 (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  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/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,345 @@
1
+ // =============================================================================
2
+ // PHASE MODULE: Publish PR (apra-fleet-3swo.6.9).
3
+ //
4
+ // The TWELFTH and LAST of runSprintCycle's twelve phase() boundaries: push the
5
+ // sprint branch and raise (but never merge) a pull request for it. Per the pm
6
+ // skill's R12 rule a human -- or a later, explicitly-scoped issue -- must
7
+ // review and merge; nothing here merges anything. Moved verbatim out of
8
+ // runner.js: every log line, PR title/body string and command() option is
9
+ // byte-identical to the inline version, so the golden transcript is unchanged.
10
+ // Move-only, no behaviour change.
11
+ //
12
+ // WHERE THIS PHASE STARTS AND STOPS. It starts at its own phase() call and
13
+ // ends where the inline version's final `endGroup()` used to sit. The
14
+ // `// 7. Publish` section banner above it, BOTH endGroup() calls and the two
15
+ // return objects stay in runner.js -- group('Finalization')/endGroup() wrap all
16
+ // four Finalization phases, not this one, and runSprintCycle's return value is
17
+ // the function's own contract. This phase returns `{ pushed }` and runner.js
18
+ // builds both return objects from it; that is the ONLY structural change, and
19
+ // it is behaviour-preserving in both directions:
20
+ // - push failed: this phase logs [Publish Push Failed] and returns
21
+ // pushed:false WITHOUT doing any PR/target-issue work, exactly as the
22
+ // inline early return did; runner.js then endGroup()s and returns the
23
+ // COMPUTED verdict with pushed:false.
24
+ // - push succeeded: this phase runs the PR/target-issue work and returns
25
+ // pushed:true; runner.js endGroup()s and returns the computed verdict.
26
+ // A genuine PR-creation failure still throws a typed CommandError from inside
27
+ // this phase, so it propagates out BEFORE runner.js's endGroup() -- same
28
+ // ordering the inline version had.
29
+ //
30
+ // THE BRANCH PUSH STAYS INSIDE A SYNC BRACKET (apra-fleet-3swo.4.1). The push
31
+ // goes through gitSync.pushGitAfter(), the bracketed syncMemberAfter() entry
32
+ // point -- never a raw `git push` and never the bare primitive -- so the pause
33
+ // guard reads "not clean" for its whole duration and a pause can never land
34
+ // mid-push of the sprint branch. Registering this module in
35
+ // ../guarded-modules.mjs is what keeps unbracketed-push-guard covering that
36
+ // site instead of silently losing it now that it has left runner.js. The
37
+ // non-hosted-remote target-issue closure's D-push likewise goes through
38
+ // gitSync.syncBeadsAfter(..., { pushBeads: true }).
39
+ //
40
+ // WHICH MEMBER DOES WHAT, AND WHY IT MATTERS. The branch push and the
41
+ // `git remote get-url origin` read run on publishGitMember -- the role-resolved
42
+ // 'harvester' member, a real dispatch member with an actual git checkout --
43
+ // NEVER backlogMember, which may be a shared/unreservable, git-less member
44
+ // (docs/design-orchestrator-worktree-model-v2.md section 4.3/4.5).
45
+ // raiseVcsPrForMember() and the direct `bd close` calls stay on
46
+ // backlogMember: a credential-file read plus a REST call, and beads
47
+ // mutations, neither of which needs a git checkout (section 4.6).
48
+ //
49
+ // WHY ITS HELPERS ARE INJECTED RATHER THAN IMPORTED. command, gitSync,
50
+ // getMemberForRole and args are runSprintCycle-scoped, so there is nothing to
51
+ // import; vcsCapabilities, raiseVcsPrForMember, the ../pr-body.mjs builders,
52
+ // ApraFleet and CommandError live in real modules and are imported directly.
53
+ // (sanitizePrText used to be injected for the notes; the body no longer uses
54
+ // it -- see the PR body comment below.)
55
+ //
56
+ // GUARD COVERAGE: registered as 'phases/publish-pr.mjs' in
57
+ // ../guarded-modules.mjs. It took TWO member_name-bearing command() call sites
58
+ // out of runner.js -- the `git remote get-url origin` capability probe on
59
+ // publishGitMember and the per-target-issue `bd close` on backlogMember --
60
+ // plus the branch push and the beads D-push described above, and NO
61
+ // dispatchRole() site (it dispatches no agent; raiseVcsPrForMember is a REST
62
+ // call). That is exactly what dispatch-safety-guard, unbracketed-push-guard
63
+ // and the phase 3 dispatch census read, so all three baselines are pinned
64
+ // rather than assumed. It also owns the ONLY remaining vcsCapabilities() call
65
+ // site outside abort.mjs, which test/vcs-capabilities-table.test.mjs counts.
66
+ // =============================================================================
67
+
68
+ import { CommandError } from '@apralabs/apra-fleet-workflow';
69
+ import { ApraFleet } from '@apralabs/apra-fleet-client';
70
+ import { capabilities as vcsCapabilities } from '../vcs-module.mjs';
71
+ import { raiseVcsPrForMember } from '../vcs-auth.mjs';
72
+ import { buildSprintPrBody, buildSprintPrTitle } from '../pr-body.mjs';
73
+
74
+ /**
75
+ * Runs the Publish PR phase: push the sprint branch, then either raise a PR on
76
+ * a hosted remote or (on a remote that can never open one) close the target
77
+ * issue(s) directly when the verdict passed.
78
+ *
79
+ * @param {object} state Explicit phase state; see this file's header.
80
+ * @returns {Promise<{ pushed: boolean }>} Whether the sprint branch actually
81
+ * reached the remote. runner.js folds this straight into runSprintCycle's
82
+ * return value -- it never overrides the sprint's own computed verdict.
83
+ */
84
+ export async function runPublishPrPhase({
85
+ // Lower-quality banner (lower-quality.mjs), or null when every member was verified.
86
+ lowerQualityBanner = null,
87
+ // Presentation + command seams.
88
+ phase,
89
+ log,
90
+ command,
91
+ // Sprint identity/config.
92
+ args,
93
+ validated,
94
+ targetIssues,
95
+ backlogMember,
96
+ finalCycleLabel,
97
+ // The sync brackets this phase's branch push and beads D-push go through.
98
+ gitSync,
99
+ // Role resolution for the git-capable publishing member (see header).
100
+ getMemberForRole,
101
+ // The verdict this phase publishes but must never change.
102
+ finalVerdictResult,
103
+ // Engine-computed cost block from ./harvest.mjs, rendered in the PR body.
104
+ costAnalysis = '',
105
+ }) {
106
+ phase(`Publish PR C${finalCycleLabel}`);
107
+ // The branch push is the LAST step of a sprint that has already done all of
108
+ // its work and computed a final verdict. A transient push failure (a racing
109
+ // writer, a momentarily unreachable remote, a credential refresh in flight)
110
+ // used to throw a CommandError from here, which converted a computed PASS
111
+ // into `verdict: 'ABORTED'` and discarded the whole run's conclusion over a
112
+ // network hiccup at the very end. So: failSoft plus the same short, bounded
113
+ // sync backoff every other push round trip uses, and -- if it STILL will not
114
+ // go through -- log loudly and return the COMPUTED verdict with
115
+ // `pushed: false` rather than destroying it.
116
+ //
117
+ // A persistent failure also skips everything downstream of the push (PR
118
+ // creation on a hosted remote; direct target-issue closure + D-push on a
119
+ // non-hosted one). None of that may run against a branch whose commits
120
+ // never reached the remote: a PR cannot be raised for unpushed work, and
121
+ // closing the sprint's target issue would advertise a completion nobody can
122
+ // see. This is the deliberately MINIMAL hardening -- the pluggable-publish
123
+ // restructure is apra-fleet-647.2, which supersedes it.
124
+ // apra-fleet: this push and the origin-remote read just below it run on
125
+ // publishGitMember -- a real dispatch member with an actual git checkout
126
+ // (harvester, falling back to the fallback pool like every other role
127
+ // resolution in ../runner.js) -- NEVER backlogMember, which may be a
128
+ // shared/unreservable, git-less member (docs/design-orchestrator-
129
+ // worktree-model-v2.md section 4.3/4.5). raiseVcsPrForMember() below
130
+ // stays on backlogMember: it is a credential-file read + REST call,
131
+ // not git, and is explicitly designed to stay there (section 4.6).
132
+ const publishGitMember = getMemberForRole('harvester');
133
+ let pushed = false;
134
+ let lastPushError = '';
135
+ // apra-fleet-9wdh-adjacent (Publish-PR push self-heal): this used to retry
136
+ // the byte-identical `git push` up to 3 times with no fetch/rebase step in
137
+ // between -- fine for a transient/busy-remote failure, but a genuine
138
+ // non-fast-forward rejection ("fetch first") is deterministic, so all 3
139
+ // attempts failed identically and the branch's work was stranded local-
140
+ // only. syncMemberAfter() (../git-sync.mjs) already implements the
141
+ // correct self-heal for exactly this failure shape -- bounded transient
142
+ // retry, then one pull-rebase-then-re-push on a genuine non-fast-forward
143
+ // divergence, never a blind force-push -- and every OTHER post-dispatch
144
+ // G-push in fleet-sprint already routes through it. Publish PR is the one
145
+ // push site that bypassed it. Route through it here too instead of the
146
+ // raw retry loop. NOTE: no `agent` is passed here, so a real content
147
+ // conflict during the rebase (not just a plain non-FF race) throws
148
+ // GitDivergedError directly rather than getting syncMemberAfter's
149
+ // optional Tier 2 conflict-resolution-agent dispatch -- same as the old
150
+ // loop, which had no Tier 2 either; not a regression.
151
+ // (apra-fleet-3swo.4.1) ... and this G-push, unlike the Publish-PR D-push
152
+ // just below, was never inside a sync bracket either -- a pause could land
153
+ // mid-`git push` of the sprint branch. pushGitAfter() is the bracketed
154
+ // syncMemberAfter() entry point; it threads the same command/log/branch/
155
+ // onAuthFailure/provider-resolver state the bare call passed by hand.
156
+ try {
157
+ await gitSync.pushGitAfter(publishGitMember, { remote: 'origin', setUpstream: true });
158
+ pushed = true;
159
+ } catch (pushErr) {
160
+ lastPushError = pushErr.message;
161
+ }
162
+ if (!pushed) {
163
+ log(`[Publish Push Failed] Could not push sprint branch '${validated.branch}' to origin (bounded transient retry, and a rebase-then-re-push if diverged, both exhausted) -- the sprint's work is COMMITTED LOCALLY ONLY and is NOT on the remote. Skipping PR creation and target-issue closure (neither is meaningful for an unpushed branch); the sprint's own computed verdict (${finalVerdictResult.verdict}) is preserved and returned with pushed:false. Push the branch by hand and raise the PR, or re-run finalization once the remote is reachable. Last error: ${lastPushError}`);
164
+ return { pushed: false };
165
+ }
166
+ // The final verdict is surfaced directly in the PR title and body -- a
167
+ // human reviewer must never have to dig through sprint logs to learn
168
+ // whether the run's own review gate passed. A FAIL verdict still publishes
169
+ // the PR (never suppressed), with the verdict stated plainly so the
170
+ // reviewer can weigh it before merging.
171
+ const finalVerdictLabel = finalVerdictResult.verdict === 'PASS' ? 'PASS' : 'FAIL';
172
+
173
+ // Resolve the sprint's own git 'origin' remote and classify it via
174
+ // VCSModule.capabilities() BEFORE ever attempting the VCSModule REST
175
+ // create-pull-request call. A remote whose provider cannot open a PR (a
176
+ // file:// bare mirror, or any other host with no hosting API support)
177
+ // means PR creation can never succeed, and attempting it anyway throws a
178
+ // hard 'gh auth login required'-shaped CommandError that would fail the
179
+ // whole sprint. Resolving the remote is itself failSoft -- an
180
+ // unresolvable remote fails closed to canOpenPullRequest:false, per
181
+ // capabilities()'s own contract -- so a probe hiccup here can never kill
182
+ // the sprint.
183
+ const originUrlRes = await command('git remote get-url origin', {
184
+ member_name: publishGitMember,
185
+ silent: true,
186
+ failSoft: true,
187
+ label: 'Resolve origin remote URL',
188
+ });
189
+ const originUrl = originUrlRes.ok ? originUrlRes.output.trim() : '';
190
+ // (apra-fleet-3swo.4.10) capabilities() is already the provider-agnostic
191
+ // hook -- it dispatches to WHICHEVER registered provider's matchesHost()
192
+ // claims this remote's host (github, azure-devops, bitbucket, ... see
193
+ // vcs-module.mjs's capabilities()), never a hardcoded GitHub check. The
194
+ // log line below used to say "not a gh-hostable GitHub remote" even
195
+ // though the gate itself was already provider-neutral -- that wording
196
+ // was pure residue, not control flow, but a broken/misconfigured
197
+ // Azure DevOps or Bitbucket remote hitting this same branch would have
198
+ // been told (wrongly) that it looked like a GitHub problem. `host` is
199
+ // carried through so the log names what was actually resolved, matching
200
+ // finalizeAbort's identical gate (abort.mjs) which never had the stale
201
+ // GitHub wording in the first place.
202
+ const publishPrCapabilities = vcsCapabilities(originUrl);
203
+ const hostedRemote = publishPrCapabilities.canOpenPullRequest;
204
+
205
+ if (!hostedRemote) {
206
+ log(`Publish PR: origin remote '${originUrl || '(unresolved)'}' cannot open a pull request (host: ${publishPrCapabilities.host || 'unknown'}) -- ` +
207
+ 'skipping PR creation entirely (no dependency on any VCS provider\'s auth for this path).');
208
+ // A non-hosted remote can never complete PR creation, so target-issue
209
+ // closure cannot be gated on it -- close the target issue(s) directly,
210
+ // but only when the sprint's own final verdict actually passed. A FAIL
211
+ // verdict must never be masked by closing the issue anyway; it still
212
+ // ends the sprint 'failed' via the return value below, same as the
213
+ // hosted-remote path.
214
+ if (finalVerdictResult.verdict === 'PASS') {
215
+ for (const id of targetIssues) {
216
+ const closeRes = await command(`bd close ${id}`, {
217
+ member_name: backlogMember,
218
+ silent: true,
219
+ failSoft: true,
220
+ label: `Close target issue '${id}' directly (non-hosted remote, no PR gate)`,
221
+ });
222
+ if (closeRes.ok) {
223
+ log(`Publish PR: closed target issue '${id}' directly (non-hosted remote, PASS verdict).`);
224
+ } else {
225
+ log(`Publish PR: failed to close target issue '${id}' directly (non-fatal, continuing): ${closeRes.error}`);
226
+ }
227
+ }
228
+ await gitSync.syncBeadsAfter(backlogMember, { pushBeads: true });
229
+ } else {
230
+ log('Publish PR: final verdict is FAIL -- leaving target issue(s) open (not closing on a non-PASS verdict).');
231
+ }
232
+ } else {
233
+ // finalVerdictResult.notes is LLM-authored free text. It used to go
234
+ // through sanitizePrText() (a single-line shell-argument sanitizer
235
+ // that maps every newline to a space), which is what flattened the
236
+ // reviewer's paragraphs and bullets into one line. The body never
237
+ // reaches a shell as raw text -- every provider builder JSON-encodes
238
+ // it and quotes the JSON per member shell -- so ../pr-body.mjs now
239
+ // applies markdown/transport hygiene instead (no raw HTML, no
240
+ // credential-placeholder spelling, balanced fences, ASCII, capped)
241
+ // while keeping the line structure.
242
+ const prTitle = buildSprintPrTitle({ verdict: finalVerdictLabel, branch: validated.branch });
243
+ const runId = validated.runId || (args && args.run_id) || '';
244
+ const now = new Date();
245
+ const buildBody = (previousBody = '') => buildSprintPrBody({
246
+ verdict: finalVerdictLabel,
247
+ goal: validated.goal,
248
+ branch: validated.branch,
249
+ baseBranch: validated.baseBranch,
250
+ runId,
251
+ now,
252
+ notes: finalVerdictResult.notes,
253
+ details: [
254
+ validated.skipRegression ? 'Regression pass: skipped by launch option -- not run this sprint.' : null,
255
+ lowerQualityBanner || null,
256
+ ],
257
+ costAnalysis,
258
+ previousBody,
259
+ });
260
+ const prBody = buildBody();
261
+
262
+ // Idempotent PR creation via VCSModule (apra-fleet-tfx.8: the reverted
263
+ // gh-based path is gone). A push+pr credential is minted just-in-time immediately
264
+ // before this one call (never at sprint setup, never for any other
265
+ // phase), VCSModule builds the orchestrator-side curl command, and
266
+ // `backlogMember` dispatches it via execute_command -- no gh, no
267
+ // server-side fallback. A re-run of finalization against a branch
268
+ // that ALREADY has an open PR from a prior, otherwise-successful run
269
+ // can be told apart from a genuine failure: the REST create-PR call
270
+ // returns 422 "already exists" in that case -- that specific outcome
271
+ // is swallowed (logged, not thrown) because it means the desired end
272
+ // state (a PR is open for this branch) already holds. Any OTHER
273
+ // failure (auth, network, a real API error, the injectable mock
274
+ // failure below) is NOT swallowed -- it is re-raised as a typed
275
+ // CommandError so it surfaces clearly rather than being silently
276
+ // invisible.
277
+ const fleetApiForPr = (args && typeof args.callTool === 'function') ? new ApraFleet({ callTool: args.callTool }) : null;
278
+ if (!fleetApiForPr) {
279
+ // Graceful degradation (apra-fleet-tfx.8.1): minting the push+pr
280
+ // credential VCSModule needs to raise this PR requires an MCP
281
+ // client. When no callTool is wired (e.g. a mock-sprint scenario
282
+ // that never opted into an MCP client), the sprint branch is
283
+ // already pushed by the withGitSync bracket -- so rather than an
284
+ // unconditional hard-throw that would fail every such pre-existing
285
+ // scenario at the very last step, this degrades to a clear,
286
+ // skipped-PR log and lets the sprint report its real verdict. In
287
+ // production callTool is always wired (bin/cli.mjs), so this branch
288
+ // never runs there; it exists purely so PR creation is not a hard
289
+ // MCP dependency for callers that legitimately have none. A genuine
290
+ // PR-creation FAILURE (auth, network, a real API error) still
291
+ // throws below -- only the callTool-absent case is degraded.
292
+ log(`[Publish PR Skipped] no MCP callTool available to mint a push+pr credential for member '${backlogMember}' -- branch '${validated.branch}' is pushed but the PR was not raised.`);
293
+ } else {
294
+ const prResult = await raiseVcsPrForMember({
295
+ fleetApi: fleetApiForPr,
296
+ command,
297
+ member: backlogMember,
298
+ base: validated.baseBranch,
299
+ head: validated.branch,
300
+ title: prTitle,
301
+ body: prBody,
302
+ log,
303
+ logPrefix: '[Publish PR]',
304
+ // Already resolved above via publishGitMember (a real
305
+ // git-capable member) for the PR-capability gate -- skip
306
+ // re-deriving it a second time by shelling out to
307
+ // backlogMember, which may have no git checkout of its
308
+ // own to read a remote from (docs/design-orchestrator-
309
+ // worktree-model-v2.md section 4.6: this call stays workspace-
310
+ // independent by design, credential-file-read + REST only).
311
+ remoteUrlOverride: originUrl,
312
+ // A relaunch on a branch that already has a PR rewrites that
313
+ // PR's title and body for THIS run's verdict, carrying the
314
+ // earlier runs forward from the old body's history block.
315
+ updateExisting: ({ body: oldBody }) => ({ title: prTitle, body: buildBody(oldBody) }),
316
+ });
317
+ if (!prResult.ok) {
318
+ if (prResult.authFailure) {
319
+ // apra-fleet-5co8.15: an auth failure raiseVcsPrForMember
320
+ // could not clear -- including one that never got past
321
+ // credential provisioning, e.g. a missing Azure DevOps PAT
322
+ // credential-store entry -- degrades the publish phase
323
+ // instead of aborting the sprint, same policy
324
+ // finalizeAbort() already applies to its own authFailure
325
+ // outcome (see ../abort.mjs). The branch is already pushed; only
326
+ // the PR itself is skipped.
327
+ log(`[Publish PR Skipped] could not raise a PR for branch '${validated.branch}' -> '${validated.baseBranch}' (branch is pushed) due to an unrecoverable VCS auth failure: ${prResult.error}`);
328
+ } else {
329
+ throw new CommandError(
330
+ `[Publish PR Failed] VCSModule create-pull-request failed for branch '${validated.branch}' -> '${validated.baseBranch}': ${prResult.error}`,
331
+ { details: { branch: validated.branch, baseBranch: validated.baseBranch, error: prResult.error } }
332
+ );
333
+ }
334
+ } else if (prResult.alreadyExists) {
335
+ if (prResult.updated) {
336
+ log(`Publish PR: a PR for branch '${validated.branch}' already exists -- updated its title and body to this run's verdict (${finalVerdictLabel})${prResult.prUrl ? `: ${prResult.prUrl}` : ''}.`);
337
+ } else {
338
+ log(`[Publish PR] WARNING: a PR for branch '${validated.branch}' already exists but could NOT be updated to this run's verdict (${finalVerdictLabel}) -- its title/body may still show an earlier run's verdict; update it by hand. Cause: ${prResult.updateError || '(unknown)'}`);
339
+ }
340
+ }
341
+ }
342
+ }
343
+
344
+ return { pushed: true };
345
+ }
@@ -0,0 +1,264 @@
1
+ // =============================================================================
2
+ // PHASE MODULE: Re-Review (apra-fleet-3swo.6.8).
3
+ //
4
+ // The EIGHTH of runSprintCycle's twelve phase() boundaries -- the ONE fresh
5
+ // review Cycle Evaluation dispatches when the goal-priority bead count already
6
+ // reads 0 but no review ran THIS cycle (the Develop/Review loop was skipped
7
+ // because there were no ready beads). Without it the exit decision would rest
8
+ // on a verdict from an earlier cycle, or the loop would spin with no way to
9
+ // confirm completion. Like ./review.mjs it then has the ORCHESTRATOR -- never
10
+ // the LLM -- apply every structured transition the verdict asks for (guarded
11
+ // reopens, validated newTask creation) before D-pushing the beads it just
12
+ // mutated. Moved verbatim out of runner.js: every prompt, log line, dispatch
13
+ // option, validation branch and sync call is byte-identical to the inline
14
+ // version, so the golden transcript is unchanged. Move-only, no behaviour
15
+ // change.
16
+ //
17
+ // WHERE THIS PHASE STARTS AND STOPS. It is the body of Cycle Evaluation's
18
+ // `if (openAtGoal.length === 0 && !reviewedThisCycle)` branch, and nothing
19
+ // else -- from its own phase() call to the post-mutation
20
+ // `gitSync.syncBeadsAfter(...)` that closes it. The `if` itself stays in
21
+ // runner.js because it is built out of Cycle Evaluation's own freshly-read
22
+ // counts, exactly as ./deploy.mjs's `if (hasDeploy)` probe and ./replan.mjs's
23
+ // `if (eligibleReplan.length > 0)` filter stayed behind; the
24
+ // stillOpenVerifyIds exit gate that follows it belongs to Cycle Evaluation,
25
+ // not to this phase.
26
+ //
27
+ // THE GUARDED VERDICT PATH IS NOT OPTIONAL. apra-fleet-3swo.4.7 brought this
28
+ // site's reopenIds under the SHARED applyGuardedReopens() path from
29
+ // ../beads-transitions.mjs -- it was previously the only one of the three
30
+ // verdict sites applying reopens with NO goal-scope guard, so a below-goal
31
+ // DEFERRED bead named here was pulled back into a sprint that no longer
32
+ // targeted it. That import, and the Re-review reopenIds site it wraps, moved
33
+ // here INTACT: this module must never grow a private reopen loop or a private
34
+ // allowlist of its own (pinned by
35
+ // test/beads-transitions-extraction.test.mjs, which now scans runner.js,
36
+ // phases/review.mjs and this file as separate sources and asserts which one
37
+ // owns which of the three sites).
38
+ //
39
+ // EXPLICIT STATE, NOT A CLOSURE -- AND WHY THREE VALUES COME BACK. Same shape
40
+ // as ./review.mjs, whose newTasks half this phase mirrors line for line.
41
+ // `rejectedNewTasks` is an array this phase PUSHES to, so passing the array
42
+ // itself is exactly equivalent to the closure it replaces. The three genuinely
43
+ // REASSIGNED values -- `lastReviewVerdict` and `reviewedThisCycle` (which the
44
+ // exit decision immediately below this phase's call site reads) and
45
+ // `pendingRejectedNewTasks` (which trackRejectedNewTaskForResurfacing()/
46
+ // clearResubmittedNewTask() return a NEW list from every time) -- are passed
47
+ // in and returned instead.
48
+ //
49
+ // WHY SOME HELPERS ARE INJECTED RATHER THAN IMPORTED. dispatchReview,
50
+ // bdListScoped, goalMax, recordReopen, childIdAllocator and sprintMutexId are
51
+ // runSprintCycle-scoped locals, so there is nothing to import. computeChildFloor,
52
+ // createChildBeadWithAllocatedId, trackRejectedNewTaskForResurfacing and
53
+ // clearResubmittedNewTask are exported BY runner.js; importing them here would
54
+ // make phases/re-review.mjs <-> runner.js a circular pair for the sake of four
55
+ // helpers, so they come through the state argument instead -- the same rule
56
+ // ./review.mjs's header states. The dependencies that live in real sibling
57
+ // modules (applyGuardedReopens from ../beads-transitions.mjs, validateNewTask/
58
+ // appendRejectedFindingToParentNotes/persistNewTaskBestEffort from ../abort.mjs)
59
+ // are imported directly.
60
+ //
61
+ // GUARD COVERAGE: registered as 'phases/re-review.mjs' in
62
+ // ../guarded-modules.mjs. It took NO command() call site out of runner.js --
63
+ // its reopen and newTask writes reach bd through injected helpers that issue
64
+ // their own command() calls in the modules that already own them, exactly as
65
+ // ./review.mjs's do -- and NO dispatchRole() site either: the reviewer ladder
66
+ // runs through runner.js's shared dispatchReview() helper, which the per-round
67
+ // Review and Final Review phases call too. Its only repo-side effect is the
68
+ // shared gitSync bracket at the end. Both zero baselines are pinned rather
69
+ // than assumed, so a future edit that reaches for a raw command() here turns
70
+ // red instead of landing on an unguarded site.
71
+ // =============================================================================
72
+
73
+ import { applyGuardedReopens, ensureRedBranchFixTask, isInGoalPriority } from '../beads-transitions.mjs';
74
+ import {
75
+ validateNewTask, appendRejectedFindingToParentNotes, persistNewTaskBestEffort,
76
+ } from '../abort.mjs';
77
+
78
+ /**
79
+ * Runs the Re-Review phase: one fresh review of the CURRENT state, plus the
80
+ * orchestrator-applied transitions its verdict asks for.
81
+ *
82
+ * @param {object} state Explicit phase state; see this file's header.
83
+ * @returns {Promise<{
84
+ * lastReviewVerdict: string|undefined,
85
+ * reviewedThisCycle: boolean,
86
+ * pendingRejectedNewTasks: object[],
87
+ * }>} The three REASSIGNED values described in the header. Every other output
88
+ * of this phase is an in-place mutation of an array the caller still holds.
89
+ */
90
+ export async function runReReviewPhase({
91
+ // Presentation + dispatch seams.
92
+ phase,
93
+ log,
94
+ command,
95
+ // Sprint identity/config.
96
+ cycle,
97
+ validated,
98
+ targetIssues,
99
+ backlogMember,
100
+ // The git/beads sync bracket this phase's post-mutation D-push goes
101
+ // through.
102
+ gitSync,
103
+ // Mutated in place; never reassigned by this phase (see header).
104
+ rejectedNewTasks,
105
+ // Reassigned, so passed in and returned (see header).
106
+ lastReviewVerdict,
107
+ reviewedThisCycle,
108
+ pendingRejectedNewTasks,
109
+ // runSprintCycle-scoped locals and runner.js-exported helpers, injected
110
+ // rather than imported (see header).
111
+ dispatchReview,
112
+ bdListScoped,
113
+ goalMax,
114
+ // Bead ids this sprint has dispatched or closed: a below-goal reopen of
115
+ // one of them is applied, not deferred (see isDeferredScopeReopen).
116
+ workedOnIds,
117
+ recordReopen,
118
+ childIdAllocator,
119
+ sprintMutexId,
120
+ computeChildFloor,
121
+ createChildBeadWithAllocatedId,
122
+ trackRejectedNewTaskForResurfacing,
123
+ clearResubmittedNewTask,
124
+ }) {
125
+ phase(`Re-Review C${cycle}`);
126
+ log(
127
+ `Cycle ${cycle}: 0 open goal-priority bead(s) but no review ran THIS cycle (Develop/Review ` +
128
+ `loop was skipped) -- dispatching a fresh re-review of the current state before deciding ` +
129
+ `whether to exit, rather than trusting a verdict from an earlier cycle.`
130
+ );
131
+ const reReviewScope = await bdListScoped('--json');
132
+ // apra-fleet-jfo.3: this call passed beadIds: [] unconditionally,
133
+ // which buildReviewerPrompt renders as "Review the work just done
134
+ // for the following bead id(s): ." -- no ids to review. The
135
+ // reviewer correctly treats that as missing required input and
136
+ // refuses (a CHANGES_NEEDED-shaped response with empty
137
+ // reopenIds/newTasks), which after one retry throws
138
+ // ReviewerContractViolationError and aborts the WHOLE sprint --
139
+ // hit live 2026-08-02 on apra-fleet-l7n-style sprints (Deploy
140
+ // fails on cycle 1 -> IntegTest skipped -> openAtGoal reads 0 ->
141
+ // this branch -> crash, before the sprint ever gets a real
142
+ // chance). The sprint's own root issue id(s) are always a valid,
143
+ // in-scope target for "review the current state" -- pass them as
144
+ // beadIds so the reviewer has something concrete to ground its
145
+ // verdict in; acceptanceCriteriaJson still carries the full scope
146
+ // for context.
147
+ const reReviewVerdict = await dispatchReview({ beadIds: targetIssues, acceptanceCriteriaJson: JSON.stringify(reReviewScope) });
148
+ lastReviewVerdict = reReviewVerdict.verdict;
149
+ reviewedThisCycle = true;
150
+
151
+ // Same orchestrator-applies-the-transition contract as the
152
+ // regular Develop/Review dispatch above: a re-review that
153
+ // reopens beads or proposes follow-up work must have those
154
+ // effects actually applied, not silently discarded just because
155
+ // this dispatch happened outside the normal Develop loop.
156
+ //
157
+ // apra-fleet-3swo.4.7: this site used to apply reopenIds with NO
158
+ // goal-scope guard -- the only one of the three verdict sites that
159
+ // did. It now goes through the same applyGuardedReopens() path as
160
+ // the per-round reviewer and Final Review, so a below-goal
161
+ // DEFERRED bead named here is skipped with the identical
162
+ // "deferred scope, not reopened" outcome instead of being pulled
163
+ // back into a sprint that no longer targets it.
164
+ const reopenedIds = new Set(await applyGuardedReopens({
165
+ entries: reReviewVerdict.reopenIds,
166
+ bdListScoped, goalMax, goal: validated.goal, log, command,
167
+ member: backlogMember,
168
+ workedOnIds,
169
+ logPrefix: 'Re-review reopenIds',
170
+ buildReopenCommand: ({ id }) => ({
171
+ cmd: `bd update ${id} --status=open`,
172
+ label: `Reopen ${id} per re-review verdict`,
173
+ }),
174
+ // Track per-bead reopen counts for reopen-thrash detection.
175
+ onReopened: ({ id }) => recordReopen(id),
176
+ }));
177
+ let inGoalNewTaskCount = 0;
178
+ for (const newTask of reReviewVerdict.newTasks) {
179
+ const validation = validateNewTask(newTask);
180
+ if (!validation.ok) {
181
+ log(`Re-review newTasks: REJECTED (not sent to bd create) -- ${validation.reason}`);
182
+ rejectedNewTasks.push({ cycle, reason: validation.reason, raw: newTask });
183
+ // Track it for resurfacing into the NEXT planning-phase
184
+ // dispatch too -- see trackRejectedNewTaskForResurfacing()'s
185
+ // doc comment.
186
+ pendingRejectedNewTasks = trackRejectedNewTaskForResurfacing(pendingRejectedNewTasks, {
187
+ title: newTask && newTask.title, description: newTask && newTask.description,
188
+ reason: validation.reason, cycle,
189
+ });
190
+ // Never let a rejected finding vanish -- persist it verbatim
191
+ // to the parent bead's notes as a fallback (non-fatal;
192
+ // degrades to the run log).
193
+ try {
194
+ await appendRejectedFindingToParentNotes({
195
+ command, member: backlogMember, parentId: targetIssues[0],
196
+ newTask, reason: validation.reason, cycle, log,
197
+ });
198
+ } catch (noteErr) {
199
+ log(`[fleet-sprint] rejected-finding notes fallback FAILED (non-fatal): ${noteErr.message}; finding preserved VERBATIM in this run log: ${JSON.stringify(newTask)}`);
200
+ }
201
+ continue;
202
+ }
203
+ const { title, description, priority } = validation;
204
+ // A bead can only have one parent -- when multiple sprint-root
205
+ // target issues are given, file follow-up work under the first
206
+ // one. `--parent` never accepts a comma-joined list; passing one
207
+ // silently creates an unparented/misparented bead.
208
+ //
209
+ // Same allocator-minted id path as the Develop/Review newTasks
210
+ // site above -- concurrent sprints must never mint the same child
211
+ // id under a shared parent.
212
+ const persisted = await persistNewTaskBestEffort({
213
+ command, member: backlogMember, parentId: targetIssues[0],
214
+ newTask, cycle, log, stage: 're-review',
215
+ createFn: async () => {
216
+ const floor = await computeChildFloor({ command, member: backlogMember, parentId: targetIssues[0], log });
217
+ await createChildBeadWithAllocatedId({
218
+ command, allocator: childIdAllocator, member: backlogMember,
219
+ title, description, priority, parentId: targetIssues[0],
220
+ sprintId: sprintMutexId, floor, log,
221
+ label: `Create follow-up task from re-review newTasks: ${title}`,
222
+ });
223
+ },
224
+ });
225
+ // Same resurface-list bookkeeping (title+description) as the
226
+ // Develop/Review newTasks site above.
227
+ if (persisted) {
228
+ pendingRejectedNewTasks = clearResubmittedNewTask(pendingRejectedNewTasks, { title, description });
229
+ if (isInGoalPriority(priority, goalMax)) inGoalNewTaskCount += 1;
230
+ }
231
+ }
232
+
233
+ // Same red-branch rule as the per-round Review phase: a verdict reporting
234
+ // failing build/tests with no surviving reopen or in-goal newTask still
235
+ // leaves one in-goal fix task for the next cycle to dispatch.
236
+ await ensureRedBranchFixTask({
237
+ verdict: reReviewVerdict,
238
+ reopenedCount: reopenedIds.size,
239
+ inGoalNewTaskCount,
240
+ skippedReopenIds: (reReviewVerdict.reopenIds || []).filter((id) => typeof id === 'string' && !reopenedIds.has(id)),
241
+ goal: validated.goal,
242
+ site: `Re-Review C${cycle}`,
243
+ bdListScoped, log,
244
+ createTask: (task) => persistNewTaskBestEffort({
245
+ command, member: backlogMember, parentId: targetIssues[0],
246
+ newTask: task, cycle, log, stage: 're-review-red-branch',
247
+ createFn: async () => {
248
+ const floor = await computeChildFloor({ command, member: backlogMember, parentId: targetIssues[0], log });
249
+ return createChildBeadWithAllocatedId({
250
+ command, allocator: childIdAllocator, member: backlogMember,
251
+ title: task.title, description: task.description, priority: task.priority,
252
+ parentId: targetIssues[0], sprintId: sprintMutexId, floor, log,
253
+ label: `Create red-branch fix task: ${task.title}`,
254
+ });
255
+ },
256
+ }),
257
+ });
258
+
259
+ // D-push the orchestrator's applied re-review reopens/newTask
260
+ // creates, same as the Develop/Review transition site above.
261
+ await gitSync.syncBeadsAfter(backlogMember, { pushBeads: true });
262
+
263
+ return { lastReviewVerdict, reviewedThisCycle, pendingRejectedNewTasks };
264
+ }