@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,517 @@
1
+ // Typed sprint-abort detection, abort-path PR publish and the newTask
2
+ // validation/persistence helpers for fleet-sprint (apra-fleet-3swo.3.6).
3
+ // Moved verbatim out of runner.js -- runner.js re-exports isTypedAbortError,
4
+ // finalizeAbort and persistNewTaskBestEffort so existing importers keep
5
+ // working. This is a move-only extraction: predicate logic, the finalizeAbort
6
+ // degrade-on-failed-provider-resolution path, and the persistNewTaskBestEffort
7
+ // non-fatal fallback ladder are all unchanged.
8
+ //
9
+ // Scope note (apra-fleet-3swo.3.6): the bead names only two new files
10
+ // (abort.mjs, branch-ensure.mjs) for three conceptual clusters -- abort
11
+ // predicates, the pure branch-selection helper, and newTask
12
+ // validation/persistence. branch-ensure.mjs's name is unambiguous (the
13
+ // branch-selection helper only), so the newTask validation/persistence
14
+ // cluster is folded into this file to stay within the bead's three-file
15
+ // budget (abort.mjs, branch-ensure.mjs, runner.js) rather than adding a
16
+ // fourth file for a small, self-contained cluster.
17
+ //
18
+ // SAFE_TEXT_RE, runGitStep, sanitizePrText and stageCommandBodyMemberSide stay
19
+ // in runner.js (out of this bead's scope -- each has a second, non-moving
20
+ // caller: SAFE_TEXT_RE/sanitizePrText also gate the Publish PR step's text,
21
+ // runGitStep is the main withGitSync dispatch bracket's own helper, and
22
+ // stageCommandBodyMemberSide also backs createChildBeadWithAllocatedId) and
23
+ // are imported back here; findDoltDivergedCause similarly stays (used
24
+ // elsewhere in runner.js) and is imported back for isTypedAbortError. The
25
+ // resulting runner.js <-> abort.mjs cycle is safe because every use is inside
26
+ // a function body, never at module-evaluation time.
27
+ import { CommandError, BudgetExceededError, CancelledError } from '@apralabs/apra-fleet-workflow';
28
+ import {
29
+ SprintPlanRejectedError, StalledSprintError, ReviewerContractViolationError, GitDivergedError,
30
+ UsageLimitWaitExhaustedError,
31
+ } from './errors.mjs';
32
+ import { ApraFleet } from '@apralabs/apra-fleet-client';
33
+ import { resolveProvider, capabilities as vcsCapabilities } from './vcs-module.mjs';
34
+ import { raiseVcsPrForMember, PR_SKIPPED_NO_MCP_CLIENT } from './vcs-auth.mjs';
35
+ import { buildSprintPrBody } from './pr-body.mjs';
36
+ import {
37
+ findDoltDivergedCause, runGitStep, sanitizePrText, stageCommandBodyMemberSide, SAFE_TEXT_RE,
38
+ } from './runner.js';
39
+
40
+ /**
41
+ * Follow-up-task persistence is bookkeeping -- it must NEVER abort the sprint.
42
+ * Every persistence path degrades instead of throwing: bd create ->
43
+ * parent-bead notes -> this run log, in that order.
44
+ */
45
+ export async function persistNewTaskBestEffort({ createFn, command, member, parentId, newTask, cycle, log = () => {}, stage }) {
46
+ try {
47
+ // createFn's return value (when it forwards createChildBeadWithAllocatedId's
48
+ // { childId }) lets callers log exactly which bead id was created, not just
49
+ // a count. Existing callers that ignore the return value are unaffected --
50
+ // this is still truthy either way.
51
+ const result = await createFn();
52
+ return result ?? true;
53
+ } catch (err) {
54
+ // Child ids the failed attempts consumed (never re-pooled), so the
55
+ // notes fallback names them alongside the finding.
56
+ const consumed = Array.isArray(err && err.consumedIds) ? err.consumedIds.filter(Boolean) : [];
57
+ const consumedNote = consumed.length > 0 ? ` [consumed child ids: ${consumed.join(', ')}]` : '';
58
+ log(`[fleet-sprint] newTask bd create FAILED (non-fatal, ${stage}): ${err.message}${consumedNote} -- falling back to parent-bead notes.`);
59
+ try {
60
+ await appendRejectedFindingToParentNotes({
61
+ command, member, parentId, newTask,
62
+ reason: `bd create failed (${stage}): ${err.message}${consumedNote}`, cycle, log,
63
+ });
64
+ } catch (err2) {
65
+ log(`[fleet-sprint] newTask persistence FAILED at every level (non-fatal, ${stage}); finding preserved VERBATIM in this run log: ${JSON.stringify(newTask)} -- last error: ${err2.message}`);
66
+ }
67
+ return false;
68
+ }
69
+ }
70
+
71
+ const SAFE_DESCRIPTION_RE = /^[\t\n\r\x20-\x7E]+$/;
72
+ const SAFE_PRIORITY_RE = /^P[0-4]$/;
73
+
74
+ /**
75
+ * Rewrites the handful of common non-ASCII punctuation characters LLM
76
+ * reviewers routinely emit in newTask descriptions -- em/en dashes, curly
77
+ * quotes, ellipsis -- to ASCII equivalents before SAFE_DESCRIPTION_RE
78
+ * validation, so a description is not rejected wholesale over characters that
79
+ * lose no meaning when normalized. This is a fixed substitution table, not a
80
+ * general Unicode stripper: anything still outside the allowlist afterwards is
81
+ * still a hard rejection. See sanitizeNewTaskTitle() below for title's own,
82
+ * stricter table.
83
+ * @param {string} description
84
+ * @returns {string}
85
+ */
86
+ export function sanitizeNewTaskDescription(description) {
87
+ return String(description ?? '')
88
+ .replace(/[\u2014\u2013]/g, '--') // em dash (\u2014), en dash (\u2013)
89
+ .replace(/[\u2018\u2019]/g, "'") // curly single quotes (\u2018 \u2019)
90
+ .replace(/[\u201C\u201D]/g, '"') // curly double quotes (\u201C \u201D)
91
+ .replace(/\u2026/g, '...'); // horizontal ellipsis (\u2026)
92
+ }
93
+
94
+ /**
95
+ * Same idea as sanitizeNewTaskDescription() above, for title -- but with a
96
+ * STRICTER substitution table, since title still has to pass the tighter
97
+ * SAFE_TEXT_RE shell-safety allowlist afterwards (it is interpolated inline
98
+ * into a `bd create "..."` command; description is not). Every substitution
99
+ * here maps to a character SAFE_TEXT_RE already admits, so this never
100
+ * reopens the injection surface that allowlist exists to close -- it only
101
+ * rescues titles that would otherwise be needlessly rejected over benign,
102
+ * common LLM punctuation choices. Observed live (apra-fleet-vk0a's sibling
103
+ * finding): a reviewer wrote a title referencing a CLI command in backticks
104
+ * (`` `apra-fleet status` ``, ordinary Markdown inline-code style), which
105
+ * SAFE_TEXT_RE rejects outright (backtick is excluded as a POSIX
106
+ * command-substitution risk) -- the finding was then silently demoted to a
107
+ * freetext note on the parent bead instead of becoming its own actionable
108
+ * task. Backtick has no special meaning in a bd title (bd has no
109
+ * code-formatting concept), so it is rewritten to a single quote here rather
110
+ * than dropped or preserved. A literal `"`/`$`/backslash in a title is NOT
111
+ * rewritten (there is no safe ASCII stand-in that preserves meaning without
112
+ * reopening the injection question) -- those still hard-reject via
113
+ * SAFE_TEXT_RE below, exactly as before this function existed.
114
+ * @param {string} title
115
+ * @returns {string}
116
+ */
117
+ export function sanitizeNewTaskTitle(title) {
118
+ return String(title ?? '')
119
+ .replace(/[\u2014\u2013]/g, '--') // em dash (\u2014), en dash (\u2013)
120
+ .replace(/[\u2018\u2019]/g, "'") // curly single quotes (\u2018 \u2019)
121
+ .replace(/[\u201C\u201D]/g, "'") // curly double quotes -> single quote (a literal `"` stays disallowed in title, unlike description)
122
+ .replace(/\u2026/g, '...') // horizontal ellipsis (\u2026)
123
+ .replace(/`/g, "'"); // backtick (Markdown inline-code marker) -> single quote
124
+ }
125
+
126
+ /**
127
+ * Validates one reviewer-authored newTask entry. `title` is checked against
128
+ * SAFE_TEXT_RE because it is interpolated inline into a `bd create` command
129
+ * string; `description` is checked against the more permissive
130
+ * SAFE_DESCRIPTION_RE because it travels via `bd create --body-file` and is
131
+ * never shell-interpolated (see createChildBeadWithAllocatedId). Returns
132
+ * either `{ ok: true, title, description, priority }` (safe to use) or
133
+ * `{ ok: false, reason }`. A rejected entry must never reach `command()` as a
134
+ * `bd create` interpolation; rejection is non-fatal and the sprint continues.
135
+ * @param {{ title: unknown, description: unknown, priority: unknown }} newTask
136
+ * @returns {{ ok: true, title: string, description: string, priority: string } | { ok: false, reason: string }}
137
+ */
138
+ export function validateNewTask(newTask) {
139
+ const priority = String(newTask && newTask.priority);
140
+ if (!SAFE_PRIORITY_RE.test(priority)) {
141
+ return { ok: false, reason: `priority '${priority}' does not match required pattern ${SAFE_PRIORITY_RE}` };
142
+ }
143
+ const sanitizedTitle = sanitizeNewTaskTitle(newTask && newTask.title);
144
+ if (!sanitizedTitle || !SAFE_TEXT_RE.test(sanitizedTitle)) {
145
+ return { ok: false, reason: `title fails safe-character allowlist ${SAFE_TEXT_RE} (or is empty): ${JSON.stringify(sanitizedTitle)}` };
146
+ }
147
+ // The title is the first positional argument of `bd create`, so a leading
148
+ // '-' would be parsed as a flag. Strip leading dashes (and the whitespace
149
+ // after them) shell-independently; when anything was stripped, keep the
150
+ // original title (JSON-escaped, ASCII) at the top of the description so
151
+ // nothing is lost. A title that is only dashes becomes empty and is
152
+ // rejected below, falling through to the parent-notes fallback.
153
+ const title = sanitizedTitle.replace(/^[-\s]+/, '');
154
+ if (!title) {
155
+ return { ok: false, reason: `title is empty after removing leading dashes: ${JSON.stringify(sanitizedTitle)}` };
156
+ }
157
+ let description = sanitizeNewTaskDescription(newTask && newTask.description);
158
+ if (description && title !== sanitizedTitle) {
159
+ description = `Original title: ${JSON.stringify(sanitizedTitle)}\n\n${description}`;
160
+ }
161
+ if (!description || !SAFE_DESCRIPTION_RE.test(description)) {
162
+ return { ok: false, reason: `description fails ASCII-printable validation ${SAFE_DESCRIPTION_RE} (or is empty): ${JSON.stringify(description)}` };
163
+ }
164
+ return { ok: true, title, description, priority };
165
+ }
166
+
167
+ /**
168
+ * Persists a newTask that failed validateNewTask() into the parent bead's
169
+ * notes, raw and unmodified (title/description/priority plus the rejection
170
+ * reason), so a rejected finding is still recoverable by a human or the next
171
+ * planner even though it was not filed as its own child bead. The note body
172
+ * goes through the same member-side staging seam as the description path
173
+ * (stageCommandBodyMemberSide) and is never interpolated into a shell string.
174
+ *
175
+ * A failure to append is logged AND re-thrown. Every call site wraps this in
176
+ * its own try/catch whose purpose is to log the raw finding verbatim as the
177
+ * last fallback rung; swallowing the failure here would make that rung
178
+ * unreachable on exactly the path it exists to cover. Re-throwing is still
179
+ * non-fatal to the sprint -- the caller's catch is what contains it.
180
+ * @param {{ command: Function, member: string, parentId: string, newTask: unknown, reason: string, cycle?: string|number, log?: Function }} opts
181
+ */
182
+ export async function appendRejectedFindingToParentNotes({ command, member, parentId, newTask, reason, cycle, log = () => {} }) {
183
+ const raw = {
184
+ cycle,
185
+ rejectionReason: reason,
186
+ title: newTask && newTask.title,
187
+ description: newTask && newTask.description,
188
+ priority: newTask && newTask.priority,
189
+ };
190
+ const noteBody = `[fleet-sprint newTask REJECTED -- residual validation failure, appended verbatim]\n${JSON.stringify(raw, null, 2)}`;
191
+ try {
192
+ const noteFile = await stageCommandBodyMemberSide({
193
+ command, member, content: noteBody,
194
+ label: `Stage rejected newTask finding for ${parentId} notes`,
195
+ });
196
+ await command(
197
+ `bd note ${parentId} --file "${noteFile}"`,
198
+ { member_name: member, silent: true, label: `Append rejected newTask finding to ${parentId} notes` }
199
+ );
200
+ log(`Rejected newTask finding appended verbatim to '${parentId}' notes (residual validation failure: ${reason}).`);
201
+ } catch (err) {
202
+ log(`[newTask notes-fallback] FAILED to append rejected finding to '${parentId}' notes: ${err.message}`);
203
+ throw err;
204
+ }
205
+ }
206
+
207
+ // ---------------------------------------------------------------------------
208
+ // Typed sprint-abort detection
209
+ // ---------------------------------------------------------------------------
210
+ //
211
+ // The single predicate deciding whether an error thrown out of
212
+ // runSprintCycle() is a "sprint-abort" the caller routes through
213
+ // finalizeAbort() plus a terminal history record, as opposed to an unexpected
214
+ // failure that keeps the plain grace-window/exit-1 path with no PR and no
215
+ // history record. The intended set is:
216
+ // - StalledSprintError, SprintPlanRejectedError and
217
+ // ReviewerContractViolationError (errors.mjs), which this runner throws
218
+ // itself, plus BudgetExceededError, which the workflow package throws on
219
+ // its behalf;
220
+ // - GitDivergedError and DoltDivergedError, the state-integrity divergences.
221
+ // A divergence means the single-writer invariant this engine relies on is
222
+ // already violated (or the shared beads DB genuinely cannot be
223
+ // fast-forwarded), so no retry or later phase can recover the run -- it
224
+ // must terminate with an operator-visible record. A DoltDivergedError also
225
+ // arrives WRAPPED one level down inside a PostDispatchSyncError (the D-push
226
+ // bracket's shape), so membership is decided by findDoltDivergedCause()
227
+ // walking the cause chain rather than by the outermost class. That the
228
+ // divergences belong in this set is not an inference: main()'s typed-abort
229
+ // catch below already calls resolveTerminalReason()/captureDoltConflictDump()
230
+ // precisely to report them as the distinct BEADS_SYNC_CONFLICT terminal
231
+ // state, which is dead code unless they reach it;
232
+ // - UsageLimitWaitExhaustedError (apra-fleet-hzeb.4.1/.4.2): the usage-limit
233
+ // pause/reprobe controller's own give-up error, thrown once its budget
234
+ // (role-policies.mjs's USAGE_LIMIT_BUDGET_DEFAULTS) is spent with no
235
+ // successful resume. A member still rate-limited past every allowed wait
236
+ // is as terminal as a stalled sprint -- no retry or later phase recovers it
237
+ // either -- so it gets the same finalizeAbort()/[ABORTED]-PR treatment;
238
+ // - the plain `Error` pre-sprint validation failures, which are not
239
+ // WorkflowError subclasses and are identified by the stable
240
+ // 'Pre-sprint validation failed:' message prefix every such throw site
241
+ // uses.
242
+ //
243
+ // Everything else is deliberately EXCLUDED, and the check is an explicit class
244
+ // list rather than the blanket `instanceof WorkflowError` it used to be --
245
+ // which swept in every routine, non-terminal failure and turned it into a
246
+ // spurious `verdict: 'ABORTED'`:
247
+ // - CancelledError: a cooperative cancellation is a requested shutdown, not
248
+ // an aborted sprint, and must keep flowing through its own 'cancelled'
249
+ // status path;
250
+ // - AgentOutputError, AgentDispatchError, FleetTransportError, CommandError:
251
+ // dispatch-level failures each phase's own retry/soft-fail policy owns;
252
+ // - GitSyncError, DoltSyncError, and a PostDispatchSyncError whose cause
253
+ // chain carries NO divergence: transient sync failures that are retried in
254
+ // place and, if they still surface, are ordinary run failures rather than
255
+ // sprint aborts;
256
+ // - SprintLockHeldError: structurally unreachable here. acquireSprintLock()
257
+ // runs in main() BEFORE its try block, so a held lock never reaches this
258
+ // predicate; there is also no sprint of our own to finalize when another
259
+ // engine already owns the branch.
260
+ export function isTypedAbortError(err) {
261
+ if (!err || err instanceof CancelledError) return false;
262
+ if (err instanceof StalledSprintError) return true;
263
+ if (err instanceof SprintPlanRejectedError) return true;
264
+ if (err instanceof ReviewerContractViolationError) return true;
265
+ if (err instanceof BudgetExceededError) return true;
266
+ if (err instanceof GitDivergedError) return true;
267
+ if (err instanceof UsageLimitWaitExhaustedError) return true;
268
+ // Bare DoltDivergedError, or one wrapped inside a PostDispatchSyncError.
269
+ if (findDoltDivergedCause(err)) return true;
270
+ return typeof err.message === 'string' && err.message.startsWith('Pre-sprint validation failed:');
271
+ }
272
+
273
+ // ---------------------------------------------------------------------------
274
+ // Abort-path PR publish
275
+ // ---------------------------------------------------------------------------
276
+ //
277
+ // The ordinary Publish PR step only runs when the sprint reaches a final
278
+ // PASS/FAIL verdict. A sprint that instead aborts by throwing a typed error
279
+ // would otherwise propagate straight to the CLI's top-level catch with no
280
+ // branch push and no PR, leaving any work a doer already committed visible
281
+ // only to someone willing to dig through git history. Called from the
282
+ // typed-abort catch site with the causing error, finalizeAbort():
283
+ // 1. counts commits on the sprint branch beyond base, which decides whether
284
+ // there is anything for a human to look at;
285
+ // 2. with >=1 commit, pushes the branch and raises an idempotent
286
+ // 'fleet-sprint [ABORTED]: <branch>' PR whose body carries the error's
287
+ // code/message/details, sanitized by sanitizePrText for the same reason
288
+ // the PASS/FAIL step sanitizes reviewer notes;
289
+ // 3. with 0 commits, raises no PR -- there is no diff, so the PR would be
290
+ // noise -- and reports that in its return value, so the caller can still
291
+ // write a terminal history record.
292
+ // `command` and `log` are dependency-injected rather than closed over
293
+ // `context`, so this is callable both from the catch site and directly from
294
+ // unit tests with a mock `command`.
295
+ /**
296
+ * @param {{
297
+ * error: { code?: string, message?: string, details?: unknown },
298
+ * branch: string,
299
+ * baseBranch: string,
300
+ * member: string,
301
+ * command: (cmd: string, opts: object) => Promise<any>,
302
+ * log?: (msg: string) => void,
303
+ * onAuthFailure?: (info: { member: string, label: string, cmd?: string, error: string, source: 'git'|'dolt', failureKind: string }) => Promise<void>,
304
+ * callTool?: (name: string, args: object) => Promise<any>,
305
+ * }} opts
306
+ * @returns {Promise<{ prUrl: string|null, reason: string, pushed: boolean, commitCount: number }>}
307
+ */
308
+ export async function finalizeAbort({ error, branch, baseBranch, member, command, log = () => {}, onAuthFailure, callTool, runId }) {
309
+ // Built up-front (not just at the PR-creation step further down) so the
310
+ // SAME ApraFleet client can also resolve `member`'s VCS provider
311
+ // (apra-fleet-417.7) for the runGitStep calls below -- avoids
312
+ // constructing a second client just for that lookup. `null` when no
313
+ // callTool is wired (e.g. a mock-sprint scenario with no MCP client);
314
+ // every downstream use already guards on this being non-null.
315
+ const fleetApi = typeof callTool === 'function' ? new ApraFleet({ callTool }) : null;
316
+
317
+ // apra-fleet-417.7: resolve `member`'s VCS provider ONCE up-front so the
318
+ // git failures below (fetch/rev-list/push) classify via that member's own
319
+ // provider chain, not just the default 'github' one. Fails closed to
320
+ // `undefined` (today's default chain) on any error -- a provider-
321
+ // resolution hiccup here must never abort an otherwise-recoverable abort
322
+ // finalization.
323
+ let provider;
324
+ if (fleetApi) {
325
+ try {
326
+ ({ provider } = await resolveProvider(member, { fleetApi }));
327
+ } catch (err) {
328
+ log(`finalizeAbort: could not resolve member '${member}'s VCS provider for git-failure classification (falling back to the default provider chain, no verdict change for GitHub members): ${err.message}`);
329
+ }
330
+ }
331
+
332
+ // 1. How many commits (if any) does the sprint branch carry beyond base?
333
+ // Every command() call below passes an explicit `member_name` -- this
334
+ // runner never lets a git/gh dispatch fall back to an ambient member.
335
+ //
336
+ // `member` need not be a member that ever checked out a LOCAL branch named
337
+ // `baseBranch`; it may only have the sprint branch. A bare
338
+ // `git rev-list base..branch` would then fail with "unknown revision", so
339
+ // fetch first and diff against the remote-tracking ref, which is always
340
+ // resolvable: baseBranch is the ref the sprint branch was created from.
341
+ //
342
+ // apra-fleet-5d5.1: these three git calls now go through runGitStep()
343
+ // (the same helper the main withGitSync dispatch bracket uses) instead of
344
+ // calling `command()` directly, so a git-auth failure here gets the SAME
345
+ // provision_vcs_auth self-heal-and-retry-once treatment instead of being
346
+ // silently swallowed (live: apra-fleet-l7n Cycle 3 abort hit exactly this
347
+ // -- "Authentication failed ... Password authentication is not
348
+ // supported" while writing the terminal history record, with no self-heal
349
+ // available). runGitStep never throws; a non-ok result here is re-thrown
350
+ // as a CommandError so finalizeAbort()'s own external throw-on-failure
351
+ // contract (see main()'s catch site, which falls back to "no PR lookup"
352
+ // on any thrown error) is unchanged for callers.
353
+ const fetchRes = await runGitStep({
354
+ command, member, cmd: `git fetch origin ${baseBranch}`,
355
+ label: `Fetch base branch '${baseBranch}' for abort-path diff`,
356
+ log, maxTransientRetries: 1, onAuthFailure, provider,
357
+ });
358
+ if (!fetchRes.ok) {
359
+ throw new CommandError(
360
+ `[Abort Finalize Failed] git fetch origin ${baseBranch} failed: ${fetchRes.error}`,
361
+ { details: { branch, baseBranch, error: fetchRes.error, kind: fetchRes.kind } }
362
+ );
363
+ }
364
+ const revListRes = await runGitStep({
365
+ command, member, cmd: `git rev-list --count origin/${baseBranch}..${branch}`,
366
+ label: `Count commits beyond base for abort-path branch '${branch}'`,
367
+ log, maxTransientRetries: 1, onAuthFailure, provider,
368
+ });
369
+ if (!revListRes.ok) {
370
+ throw new CommandError(
371
+ `[Abort Finalize Failed] git rev-list --count origin/${baseBranch}..${branch} failed: ${revListRes.error}`,
372
+ { details: { branch, baseBranch, error: revListRes.error, kind: revListRes.kind } }
373
+ );
374
+ }
375
+ const commitCount = parseInt(String(revListRes.output).trim(), 10) || 0;
376
+
377
+ if (commitCount < 1) {
378
+ log(`finalizeAbort: branch '${branch}' has 0 commits beyond '${baseBranch}' -- no [ABORTED] PR raised (zero-commit-abort policy).`);
379
+ return { prUrl: null, reason: 'zero-commit-abort', pushed: false, commitCount };
380
+ }
381
+
382
+ // 2. There is real work on the branch -- publish it and raise the PR.
383
+ const pushRes = await runGitStep({
384
+ command, member, cmd: `git push -u origin ${branch}`,
385
+ label: `Push abort-path sprint branch '${branch}'`,
386
+ log, maxTransientRetries: 1, onAuthFailure, provider,
387
+ });
388
+ if (!pushRes.ok) {
389
+ throw new CommandError(
390
+ `[Abort Finalize Failed] git push -u origin ${branch} failed: ${pushRes.error}`,
391
+ { details: { branch, baseBranch, error: pushRes.error, kind: pushRes.kind } }
392
+ );
393
+ }
394
+
395
+ // Same origin-remote gate as the Publish PR step, via
396
+ // VCSModule.capabilities(): a remote whose provider cannot open a PR (a
397
+ // file:// bare mirror, or any other host with no hosting API support)
398
+ // must never hit raiseVcsPrForMember()'s doomed REST call, which would
399
+ // surface as a hard-to-diagnose failure while the sprint is already
400
+ // aborting. Resolving the remote is itself failSoft -- an unresolvable
401
+ // remote fails closed to canOpenPullRequest:false -- so a probe hiccup
402
+ // here degrades to "PR skipped", never a thrown error. The branch above
403
+ // is already pushed either way.
404
+ const originUrlRes = await command('git remote get-url origin', {
405
+ member_name: member,
406
+ silent: true,
407
+ failSoft: true,
408
+ label: 'Resolve origin remote URL for abort-path PR gate',
409
+ });
410
+ const originUrl = originUrlRes.ok ? originUrlRes.output.trim() : '';
411
+ const abortPathCapabilities = vcsCapabilities(originUrl);
412
+ if (!abortPathCapabilities.canOpenPullRequest) {
413
+ log(`finalizeAbort: origin remote '${originUrl || '(unresolved)'}' cannot open a pull request (host: ${abortPathCapabilities.host || 'unknown'}) -- skipping [ABORTED] PR creation; branch '${branch}' is still pushed.`);
414
+ return { prUrl: null, reason: 'non-hosted-remote', pushed: true, commitCount };
415
+ }
416
+
417
+ const prTitle = `fleet-sprint [ABORTED]: ${branch}`;
418
+ // The error's code/message/details can originate from agent output, and
419
+ // this text is embedded in a VCSModule-built PR body -- same sanitization
420
+ // rationale as the PASS/FAIL Publish PR step.
421
+ const safeCode = sanitizePrText(error && error.code);
422
+ const safeMessage = sanitizePrText(error && error.message);
423
+ const safeDetails = sanitizePrText(
424
+ error && error.details !== undefined ? JSON.stringify(error.details) : ''
425
+ );
426
+ // Same markdown body builder as the PASS/FAIL Publish PR step
427
+ // (pr-body.mjs), so an abort after an earlier PASS/FAIL run also rewrites
428
+ // the existing PR and carries that run forward in its history.
429
+ const abortNow = new Date();
430
+ const buildAbortBody = (previousBody = '') => buildSprintPrBody({
431
+ verdict: 'ABORTED',
432
+ branch,
433
+ baseBranch,
434
+ runId,
435
+ now: abortNow,
436
+ notesHeading: 'Abort details',
437
+ notes: [
438
+ 'The sprint ABORTED before reaching a final PASS/FAIL verdict.',
439
+ '',
440
+ safeCode ? `- Error code: ${safeCode}` : null,
441
+ safeMessage ? `- Error message: ${safeMessage}` : null,
442
+ safeDetails ? `- Error details: ${safeDetails}` : null,
443
+ ].filter((line) => line !== null).join('\n'),
444
+ previousBody,
445
+ });
446
+ const prBody = buildAbortBody();
447
+
448
+ // The reverted gh-based PR creation is gone (apra-fleet-tfx.8): raise the [ABORTED] PR via
449
+ // VCSModule's orchestrator-built curl command, dispatched to `member`
450
+ // through execute_command, using a push+pr credential minted
451
+ // just-in-time immediately before this one call (never at sprint setup).
452
+ // (fleetApi is built at the top of this function, above.)
453
+ if (!fleetApi) {
454
+ // Graceful degradation (apra-fleet-tfx.8.1): raising the [ABORTED] PR
455
+ // needs an MCP client to mint a just-in-time push+pr credential on
456
+ // `member`. When no callTool is wired (e.g. a mock-sprint scenario
457
+ // that never opted into an MCP client), the abort-path branch is
458
+ // ALREADY pushed above -- so instead of an unconditional hard-throw
459
+ // that would break every such pre-existing scenario, this degrades to
460
+ // a typed 'pr-skipped-no-mcp-client' outcome: a clear log line, the
461
+ // pushed branch still returned to the caller, only the auto-raised PR
462
+ // skipped. In production callTool is always wired (bin/cli.mjs), so
463
+ // this branch never runs there; it exists purely so PR creation is not
464
+ // a hard MCP dependency for callers that legitimately have none.
465
+ log(`[Publish Abort PR Skipped] no MCP callTool available to mint a push+pr credential for member '${member}' -- branch '${branch}' is pushed but the [ABORTED] PR was not raised.`);
466
+ return { prUrl: null, reason: PR_SKIPPED_NO_MCP_CLIENT, pushed: true, commitCount };
467
+ }
468
+ const prResult = await raiseVcsPrForMember({
469
+ fleetApi,
470
+ command,
471
+ member,
472
+ base: baseBranch,
473
+ head: branch,
474
+ title: prTitle,
475
+ body: prBody,
476
+ log,
477
+ logPrefix: '[Publish Abort PR]',
478
+ // Already resolved just above (the origin-remote PR-capability gate)
479
+ // via a real git-capable member -- skip re-deriving it a second time
480
+ // by shelling out to `member`, which may be backlogMember and
481
+ // have no git checkout of its own to read a remote from.
482
+ remoteUrlOverride: originUrl,
483
+ updateExisting: ({ body: oldBody }) => ({ title: prTitle, body: buildAbortBody(oldBody) }),
484
+ });
485
+
486
+ if (!prResult.ok) {
487
+ if (prResult.authFailure) {
488
+ // apra-fleet-647.1.1.1: a PR auth failure survives the reactive
489
+ // one-shot self-heal+retry inside raiseVcsPrForMember (i.e. the
490
+ // credential is still no good after re-provisioning) -- degrade
491
+ // to a logged, non-throwing outcome instead of a CommandError, so
492
+ // finalizeAbort() -- whose whole job is to record a sprint abort
493
+ // -- can never itself be killed by the very auth failure it is
494
+ // trying to report. The branch is still pushed (`pushed: true`)
495
+ // even though the [ABORTED] PR could not be raised.
496
+ log(`finalizeAbort: [Publish Abort PR] failed with an auth failure that survived the reactive self-heal retry for branch '${branch}' -> '${baseBranch}': ${prResult.error} -- degrading (not throwing) so the abort can still be recorded.`);
497
+ return { prUrl: null, reason: 'pr-auth-failed', pushed: true, commitCount };
498
+ }
499
+ throw new CommandError(
500
+ `[Publish Abort PR Failed] VCSModule create-pull-request failed for branch '${branch}' -> '${baseBranch}': ${prResult.error}`,
501
+ { details: { branch, baseBranch, error: prResult.error } }
502
+ );
503
+ }
504
+ if (prResult.alreadyExists) {
505
+ // Idempotent: the desired end state -- a PR open for this branch --
506
+ // already holds, so this is swallowed rather than thrown.
507
+ log(`finalizeAbort: an [ABORTED] PR for branch '${branch}' already exists -- treating as idempotent success.`);
508
+ if (prResult.updated) {
509
+ log(`finalizeAbort: updated the existing PR for branch '${branch}' to this run's verdict (ABORTED)${prResult.prUrl ? `: ${prResult.prUrl}` : ''}.`);
510
+ } else {
511
+ log(`finalizeAbort: WARNING: could NOT update the existing PR for branch '${branch}' to this run's verdict (ABORTED) -- its title/body may still show an earlier run's verdict; update it by hand. Cause: ${prResult.updateError || '(unknown)'}`);
512
+ }
513
+ return { prUrl: prResult.prUrl, reason: 'already-exists', pushed: true, commitCount };
514
+ }
515
+
516
+ return { prUrl: prResult.prUrl, reason: 'aborted-pr-created', pushed: true, commitCount };
517
+ }
@@ -0,0 +1,93 @@
1
+ /**
2
+ * The backlog-role alias layer.
3
+ *
4
+ * `backlog` is the application-level pseudo-role naming the member whose beads
5
+ * clone the sprint runner issues its own `bd`/`git` commands against. Before
6
+ * 0.4.4 that role was spelled `orchestrator`; the old spelling is a deprecated
7
+ * alias, accepted in 0.4.4 and removed in v0.5. This module is the ONE place
8
+ * that knows the old spelling: callers pass an already key-normalized
9
+ * (trim + lowercase) roleMap and get back a roleMap carrying only `backlog`.
10
+ */
11
+
12
+ export const ROLE_BACKLOG = 'backlog';
13
+ export const ROLE_BACKLOG_ALIAS = 'orchestrator';
14
+
15
+ export const BACKLOG_ALIAS_WARNING =
16
+ 'Deprecated: roleMap.orchestrator is a deprecated alias of roleMap.backlog; ' +
17
+ 'use roleMap.backlog instead. The orchestrator alias will be removed in v0.5.';
18
+
19
+ /**
20
+ * @param {object|undefined} normalizedRoleMap - keys already normalized
21
+ * @returns {{ roleMap: object|undefined, warnings: string[] }}
22
+ * @throws {Error} when both keys are present with different member lists
23
+ */
24
+ export function resolveBacklogRoleAlias(normalizedRoleMap) {
25
+ if (normalizedRoleMap === undefined) return { roleMap: undefined, warnings: [] };
26
+ const has = (k) => Object.prototype.hasOwnProperty.call(normalizedRoleMap, k);
27
+ if (!has(ROLE_BACKLOG_ALIAS)) return { roleMap: normalizedRoleMap, warnings: [] };
28
+
29
+ const aliasValue = normalizedRoleMap[ROLE_BACKLOG_ALIAS];
30
+ const roleMap = { ...normalizedRoleMap };
31
+ delete roleMap[ROLE_BACKLOG_ALIAS];
32
+ if (has(ROLE_BACKLOG)) {
33
+ const a = JSON.stringify(normalizedRoleMap[ROLE_BACKLOG]);
34
+ const b = JSON.stringify(aliasValue);
35
+ if (a !== b) {
36
+ throw new Error(
37
+ `roleMap has both "${ROLE_BACKLOG}" (${a}) and its deprecated alias "${ROLE_BACKLOG_ALIAS}" (${b}) ` +
38
+ `with different member lists. Use roleMap.${ROLE_BACKLOG} only.`
39
+ );
40
+ }
41
+ } else {
42
+ roleMap[ROLE_BACKLOG] = aliasValue;
43
+ }
44
+ return { roleMap, warnings: [BACKLOG_ALIAS_WARNING] };
45
+ }
46
+
47
+ /**
48
+ * The ONE backlog-member selector shared by every direct launch (runner.js and
49
+ * bin/cli.mjs). Never throws on an unmapped backlog: it auto-selects and says
50
+ * why, so the caller can report the choice loudly.
51
+ *
52
+ * Order (roleMap already key-normalized and alias-resolved):
53
+ * 1. roleMap.backlog non-empty -> its first entry (explicit).
54
+ * 2. the first member (members order) named in no roleMap value
55
+ * (no roleMap -> the first member).
56
+ * 3. the first member mapped to doer.
57
+ * 4. the first member.
58
+ *
59
+ * @param {{ roleMap?: object, members: string[] }} input
60
+ * @returns {{ member: string|undefined, explicit: boolean, reason: string }}
61
+ */
62
+ export function selectBacklogMember({ roleMap, members } = {}) {
63
+ const list = Array.isArray(members) ? members : [];
64
+ const explicitList = roleMap && Array.isArray(roleMap[ROLE_BACKLOG]) ? roleMap[ROLE_BACKLOG] : [];
65
+ if (explicitList.length > 0) {
66
+ return { member: explicitList[0], explicit: true, reason: 'roleMap.backlog' };
67
+ }
68
+ const mapped = new Set();
69
+ if (roleMap) {
70
+ for (const v of Object.values(roleMap)) {
71
+ if (Array.isArray(v)) for (const m of v) mapped.add(m);
72
+ }
73
+ }
74
+ if (!roleMap || mapped.size === 0) {
75
+ return { member: list[0], explicit: false, reason: 'no roleMap, first member' };
76
+ }
77
+ const generalist = list.find((m) => !mapped.has(m));
78
+ if (generalist !== undefined) {
79
+ return { member: generalist, explicit: false, reason: 'first member not mapped to any role' };
80
+ }
81
+ const doers = Array.isArray(roleMap.doer) ? roleMap.doer : [];
82
+ const doer = list.find((m) => doers.includes(m));
83
+ if (doer !== undefined) {
84
+ return { member: doer, explicit: false, reason: 'every member is role-mapped; first doer-mapped member' };
85
+ }
86
+ return { member: list[0], explicit: false, reason: 'every member is role-mapped and none is a doer; first member' };
87
+ }
88
+
89
+ /** The loud one-line report for an auto-selected backlog member (null when explicit). */
90
+ export function formatBacklogSelection(sel) {
91
+ if (!sel || sel.explicit) return null;
92
+ return `backlog: ${sel.member} (auto-selected: ${sel.reason})`;
93
+ }