@apralabs/apra-fleet 0.4.3 → 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 (951) hide show
  1. package/README.md +66 -30
  2. package/dist/agents/backlog-groomer.md +75 -27
  3. package/dist/agents/ci-watcher.md +37 -22
  4. package/dist/agents/deployer.md +39 -22
  5. package/dist/agents/doer.md +74 -40
  6. package/dist/agents/harvester.md +49 -40
  7. package/dist/agents/integ-test-runner.md +40 -23
  8. package/dist/agents/kb-reconciler.md +28 -7
  9. package/dist/agents/plan-reviewer.md +49 -24
  10. package/dist/agents/planner.md +66 -43
  11. package/dist/agents/regression-test-runner.md +101 -78
  12. package/dist/agents/reviewer.md +117 -56
  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/planner-output.json +1 -1
  17. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  18. package/dist/agents/schemas/reviewer-output.json +62 -3
  19. package/dist/cli/agent-transform.d.ts +7 -0
  20. package/dist/cli/agent-transform.js +46 -1
  21. package/dist/cli/auth.d.ts +1 -0
  22. package/dist/cli/auth.js +38 -8
  23. package/dist/cli/beads-install.d.ts +35 -0
  24. package/dist/cli/beads-install.js +125 -0
  25. package/dist/cli/beads-pin.d.ts +5 -0
  26. package/dist/cli/beads-pin.js +27 -0
  27. package/dist/cli/call.d.ts +27 -0
  28. package/dist/cli/call.js +177 -0
  29. package/dist/cli/config.d.ts +24 -1
  30. package/dist/cli/config.js +69 -2
  31. package/dist/cli/dolt-install.d.ts +18 -2
  32. package/dist/cli/dolt-install.js +46 -15
  33. package/dist/cli/fleet-se-guard.d.ts +51 -0
  34. package/dist/cli/fleet-se-guard.js +215 -0
  35. package/dist/cli/install-guard.d.ts +54 -0
  36. package/dist/cli/install-guard.js +132 -4
  37. package/dist/cli/install.d.ts +77 -21
  38. package/dist/cli/install.js +610 -152
  39. package/dist/cli/kb-commit.d.ts +2 -1
  40. package/dist/cli/kb-commit.js +1 -1
  41. package/dist/cli/kb-import.d.ts +2 -1
  42. package/dist/cli/kb-import.js +1 -1
  43. package/dist/cli/register-member.js +20 -3
  44. package/dist/cli/remove-member.d.ts +4 -0
  45. package/dist/cli/remove-member.js +63 -0
  46. package/dist/cli/secret.js +9 -0
  47. package/dist/cli/start.js +59 -4
  48. package/dist/cli/status.d.ts +3 -0
  49. package/dist/cli/status.js +45 -12
  50. package/dist/cli/stop.js +64 -9
  51. package/dist/cli/uninstall.js +101 -15
  52. package/dist/cli/update.js +33 -2
  53. package/dist/cli/watch.js +1 -1
  54. package/dist/cli/workflow.js +3 -2
  55. package/dist/commands/kb-server.js +9 -2
  56. package/dist/hub-service/http-server.d.ts +5 -1
  57. package/dist/hub-service/http-server.js +55 -5
  58. package/dist/index.js +155 -8
  59. package/dist/os/child-env-bound.d.ts +77 -0
  60. package/dist/os/child-env-bound.js +171 -0
  61. package/dist/os/linux.d.ts +7 -2
  62. package/dist/os/linux.js +40 -14
  63. package/dist/os/macos.d.ts +1 -1
  64. package/dist/os/macos.js +2 -11
  65. package/dist/os/os-commands.d.ts +17 -2
  66. package/dist/os/windows-gitbash.d.ts +1 -0
  67. package/dist/os/windows-gitbash.js +17 -3
  68. package/dist/os/windows-wrapper.d.ts +0 -4
  69. package/dist/os/windows-wrapper.js +2 -1
  70. package/dist/os/windows.d.ts +5 -2
  71. package/dist/os/windows.js +75 -29
  72. package/dist/paths.d.ts +21 -0
  73. package/dist/paths.js +35 -0
  74. package/dist/providers/agy.d.ts +6 -2
  75. package/dist/providers/agy.js +245 -106
  76. package/dist/providers/claude-permission-denial.d.ts +7 -0
  77. package/dist/providers/claude-permission-denial.js +137 -0
  78. package/dist/providers/claude.d.ts +86 -38
  79. package/dist/providers/claude.js +426 -164
  80. package/dist/providers/codex.js +5 -1
  81. package/dist/providers/copilot.js +5 -1
  82. package/dist/providers/opencode.d.ts +10 -2
  83. package/dist/providers/opencode.js +114 -53
  84. package/dist/providers/provider.d.ts +171 -33
  85. package/dist/providers/provider.js +164 -3
  86. package/dist/services/agent-provisioner.d.ts +29 -0
  87. package/dist/services/agent-provisioner.js +107 -0
  88. package/dist/services/agent-shadow.d.ts +96 -0
  89. package/dist/services/agent-shadow.js +479 -0
  90. package/dist/services/agy-project.d.ts +2 -1
  91. package/dist/services/agy-project.js +15 -17
  92. package/dist/services/auth-socket.d.ts +25 -0
  93. package/dist/services/auth-socket.js +68 -23
  94. package/dist/services/auth-web.js +1 -1
  95. package/dist/services/budget-awareness.d.ts +11 -11
  96. package/dist/services/budget-awareness.js +15 -3
  97. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  98. package/dist/services/claude-local-scope-mcp.js +91 -0
  99. package/dist/services/cloud/aws.js +2 -1
  100. package/dist/services/cloud/lifecycle.js +19 -2
  101. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  102. package/dist/services/cloud/task-wrapper.js +15 -6
  103. package/dist/services/event-loop-watchdog.d.ts +32 -0
  104. package/dist/services/event-loop-watchdog.js +140 -0
  105. package/dist/services/http-transport.d.ts +49 -1
  106. package/dist/services/http-transport.js +190 -24
  107. package/dist/services/in-flight-agents.d.ts +2 -0
  108. package/dist/services/in-flight-agents.js +4 -0
  109. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  110. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  111. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  112. package/dist/services/knowledge/bible-blob-id.js +113 -0
  113. package/dist/services/knowledge/bible-import.d.ts +65 -0
  114. package/dist/services/knowledge/bible-import.js +211 -0
  115. package/dist/services/knowledge/file-hash.d.ts +31 -0
  116. package/dist/services/knowledge/file-hash.js +153 -23
  117. package/dist/services/knowledge/http-provider.d.ts +4 -3
  118. package/dist/services/knowledge/http-provider.js +17 -5
  119. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  120. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  121. package/dist/services/knowledge/kb-providers.d.ts +4 -0
  122. package/dist/services/knowledge/kb-providers.js +8 -0
  123. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  124. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  125. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  126. package/dist/services/knowledge/kb-scopes.js +47 -0
  127. package/dist/services/knowledge/kb-self.d.ts +91 -0
  128. package/dist/services/knowledge/kb-self.js +198 -0
  129. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  130. package/dist/services/knowledge/member-bible-view.js +194 -0
  131. package/dist/services/knowledge/pre-init.js +1 -0
  132. package/dist/services/knowledge/project-slug.js +2 -2
  133. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  134. package/dist/services/knowledge/sqlite-provider.js +303 -41
  135. package/dist/services/knowledge/types.d.ts +45 -2
  136. package/dist/services/member-access-secret.d.ts +70 -0
  137. package/dist/services/member-access-secret.js +195 -0
  138. package/dist/services/member-call-counts.d.ts +24 -0
  139. package/dist/services/member-call-counts.js +58 -0
  140. package/dist/services/member-config-io.d.ts +192 -0
  141. package/dist/services/member-config-io.js +443 -0
  142. package/dist/services/member-fleet-install.d.ts +710 -0
  143. package/dist/services/member-fleet-install.js +1895 -0
  144. package/dist/services/member-secret-env.d.ts +42 -0
  145. package/dist/services/member-secret-env.js +68 -0
  146. package/dist/services/member-tool-allowlist.d.ts +49 -0
  147. package/dist/services/member-tool-allowlist.js +111 -0
  148. package/dist/services/model-pricing.d.ts +19 -0
  149. package/dist/services/model-pricing.js +54 -8
  150. package/dist/services/port-holder.d.ts +86 -0
  151. package/dist/services/port-holder.js +351 -0
  152. package/dist/services/preflight-check.js +2 -0
  153. package/dist/services/registry.d.ts +13 -2
  154. package/dist/services/registry.js +27 -1
  155. package/dist/services/relay-strategy.d.ts +2 -0
  156. package/dist/services/relay-strategy.js +8 -0
  157. package/dist/services/server-lifecycle.d.ts +26 -0
  158. package/dist/services/server-lifecycle.js +85 -0
  159. package/dist/services/service-manager/index.d.ts +7 -1
  160. package/dist/services/service-manager/index.js +17 -4
  161. package/dist/services/service-manager/linux.d.ts +1 -1
  162. package/dist/services/service-manager/linux.js +15 -7
  163. package/dist/services/service-manager/macos.d.ts +11 -1
  164. package/dist/services/service-manager/macos.js +45 -7
  165. package/dist/services/service-manager/service-path.d.ts +24 -0
  166. package/dist/services/service-manager/service-path.js +55 -0
  167. package/dist/services/service-manager/types.d.ts +38 -3
  168. package/dist/services/service-manager/types.js +29 -0
  169. package/dist/services/service-manager/windows.d.ts +181 -2
  170. package/dist/services/service-manager/windows.js +666 -49
  171. package/dist/services/service-notice.d.ts +14 -0
  172. package/dist/services/service-notice.js +62 -0
  173. package/dist/services/service-start-guard.d.ts +20 -0
  174. package/dist/services/service-start-guard.js +86 -0
  175. package/dist/services/session-cost.d.ts +24 -0
  176. package/dist/services/session-cost.js +105 -0
  177. package/dist/services/session-mcp-config.d.ts +83 -0
  178. package/dist/services/session-mcp-config.js +211 -0
  179. package/dist/services/sftp.d.ts +34 -0
  180. package/dist/services/sftp.js +304 -76
  181. package/dist/services/shell-probe.d.ts +0 -24
  182. package/dist/services/shell-probe.js +28 -3
  183. package/dist/services/singleton.d.ts +68 -2
  184. package/dist/services/singleton.js +168 -11
  185. package/dist/services/sprint-coordination.js +9 -3
  186. package/dist/services/ssh.d.ts +27 -0
  187. package/dist/services/ssh.js +229 -38
  188. package/dist/services/stall/find-log-file.js +12 -5
  189. package/dist/services/stall/index.d.ts +1 -1
  190. package/dist/services/stall/read-log-tail.d.ts +23 -0
  191. package/dist/services/stall/read-log-tail.js +33 -2
  192. package/dist/services/stall/stall-detector.d.ts +25 -1
  193. package/dist/services/stall/stall-detector.js +85 -6
  194. package/dist/services/stall/stall-poller.d.ts +16 -0
  195. package/dist/services/stall/stall-poller.js +50 -6
  196. package/dist/services/stopped-marker.d.ts +16 -0
  197. package/dist/services/stopped-marker.js +55 -0
  198. package/dist/services/strategy.d.ts +33 -1
  199. package/dist/services/strategy.js +86 -17
  200. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  201. package/dist/services/supervisor-service-cleanup.js +332 -0
  202. package/dist/services/tool-registry.d.ts +8 -1
  203. package/dist/services/tool-registry.js +160 -59
  204. package/dist/services/tool-scope.d.ts +58 -0
  205. package/dist/services/tool-scope.js +99 -0
  206. package/dist/services/watch/project-resolver.js +1 -0
  207. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  208. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  209. package/dist/skills/pm/SKILL.md +3 -3
  210. package/dist/skills/pm/index.md +4 -2
  211. package/dist/skills/pm/kb-reconcile.md +29 -14
  212. package/dist/skills/pm/kb-review.md +1 -0
  213. package/dist/skills/pm/sprint.md +5 -5
  214. package/dist/tools/check-status.d.ts +53 -5
  215. package/dist/tools/check-status.js +210 -53
  216. package/dist/tools/child-id-allocator.d.ts +2 -2
  217. package/dist/tools/child-id-allocator.js +1 -1
  218. package/dist/tools/code-index-heal.d.ts +8 -0
  219. package/dist/tools/code-index-heal.js +21 -0
  220. package/dist/tools/code-index-state.d.ts +45 -0
  221. package/dist/tools/code-index-state.js +115 -0
  222. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  223. package/dist/tools/code-intelligence-freshness.js +1 -1
  224. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  225. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  226. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  227. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  228. package/dist/tools/code-intelligence-readiness.js +206 -0
  229. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  230. package/dist/tools/code-intelligence-reindex.js +530 -50
  231. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  232. package/dist/tools/code-intelligence-telemetry.js +12 -3
  233. package/dist/tools/code-intelligence.d.ts +81 -31
  234. package/dist/tools/code-intelligence.js +156 -52
  235. package/dist/tools/compose-permissions.d.ts +57 -2
  236. package/dist/tools/compose-permissions.js +497 -44
  237. package/dist/tools/execute-command.d.ts +11 -0
  238. package/dist/tools/execute-command.js +80 -12
  239. package/dist/tools/execute-prompt.d.ts +59 -15
  240. package/dist/tools/execute-prompt.js +544 -133
  241. package/dist/tools/kb-bible-commit.d.ts +65 -0
  242. package/dist/tools/kb-bible-commit.js +239 -0
  243. package/dist/tools/kb-capture.d.ts +13 -9
  244. package/dist/tools/kb-capture.js +42 -11
  245. package/dist/tools/kb-context.d.ts +27 -7
  246. package/dist/tools/kb-context.js +60 -9
  247. package/dist/tools/kb-export.d.ts +96 -7
  248. package/dist/tools/kb-export.js +228 -65
  249. package/dist/tools/kb-feedback.d.ts +13 -9
  250. package/dist/tools/kb-feedback.js +13 -7
  251. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  252. package/dist/tools/kb-freshness-sweep.js +7 -7
  253. package/dist/tools/kb-harvest.d.ts +11 -7
  254. package/dist/tools/kb-harvest.js +7 -7
  255. package/dist/tools/kb-import.d.ts +26 -10
  256. package/dist/tools/kb-import.js +169 -159
  257. package/dist/tools/kb-invalidate.d.ts +17 -10
  258. package/dist/tools/kb-invalidate.js +41 -8
  259. package/dist/tools/kb-list.d.ts +14 -10
  260. package/dist/tools/kb-list.js +30 -10
  261. package/dist/tools/kb-promote.d.ts +11 -7
  262. package/dist/tools/kb-promote.js +14 -8
  263. package/dist/tools/kb-query.d.ts +21 -11
  264. package/dist/tools/kb-query.js +76 -13
  265. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  266. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  267. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  268. package/dist/tools/kb-resolve-contradiction.js +7 -7
  269. package/dist/tools/kb-session-prime.d.ts +14 -7
  270. package/dist/tools/kb-session-prime.js +44 -44
  271. package/dist/tools/kb-setup.d.ts +11 -4
  272. package/dist/tools/kb-setup.js +25 -11
  273. package/dist/tools/kb-stats.d.ts +11 -10
  274. package/dist/tools/kb-stats.js +22 -41
  275. package/dist/tools/list-members.js +5 -2
  276. package/dist/tools/member-detail.d.ts +3 -0
  277. package/dist/tools/member-detail.js +88 -17
  278. package/dist/tools/member-reservation.d.ts +2 -2
  279. package/dist/tools/provision-auth.d.ts +39 -1
  280. package/dist/tools/provision-auth.js +269 -47
  281. package/dist/tools/provision-vcs-auth.d.ts +2 -2
  282. package/dist/tools/receive-files.js +3 -1
  283. package/dist/tools/register-member.d.ts +34 -8
  284. package/dist/tools/register-member.js +76 -58
  285. package/dist/tools/remove-member.js +110 -32
  286. package/dist/tools/send-email.d.ts +2 -2
  287. package/dist/tools/send-files.js +6 -4
  288. package/dist/tools/session-stats.d.ts +17 -0
  289. package/dist/tools/session-stats.js +27 -0
  290. package/dist/tools/shutdown-server.js +5 -0
  291. package/dist/tools/update-agent-cli.d.ts +19 -0
  292. package/dist/tools/update-agent-cli.js +59 -2
  293. package/dist/tools/update-member.d.ts +13 -10
  294. package/dist/tools/update-member.js +138 -7
  295. package/dist/tools/vcs-credential-exec.js +8 -2
  296. package/dist/types.d.ts +98 -1
  297. package/dist/utils/agent-helpers.js +2 -0
  298. package/dist/utils/auth-env.d.ts +15 -4
  299. package/dist/utils/auth-env.js +52 -23
  300. package/dist/utils/find-on-path.d.ts +37 -0
  301. package/dist/utils/find-on-path.js +85 -0
  302. package/dist/utils/log-helpers.d.ts +37 -0
  303. package/dist/utils/log-helpers.js +106 -20
  304. package/dist/utils/owner-only-fs.d.ts +56 -0
  305. package/dist/utils/owner-only-fs.js +98 -0
  306. package/dist/utils/process-utils.d.ts +28 -0
  307. package/dist/utils/process-utils.js +68 -0
  308. package/dist/utils/prompt-errors.js +4 -1
  309. package/dist/utils/session-caller.d.ts +4 -2
  310. package/dist/utils/session-caller.js +3 -2
  311. package/dist/utils/shell-escape.d.ts +42 -3
  312. package/dist/utils/shell-escape.js +70 -4
  313. package/dist/utils/ssh-error-messages.js +3 -0
  314. package/dist/utils/workspace-trust.d.ts +24 -1
  315. package/dist/utils/workspace-trust.js +21 -17
  316. package/dist/workflows/auto-sprint.js +223 -43
  317. package/package.json +11 -8
  318. package/packages/apra-fleet-client/package.json +2 -2
  319. package/packages/apra-fleet-client/src/client/api.mjs +558 -27
  320. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  321. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  322. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  323. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  324. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  325. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  326. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
  327. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
  328. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
  329. package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
  330. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
  331. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
  332. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
  333. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
  334. package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
  335. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
  336. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
  337. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  338. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  339. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  340. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  341. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  342. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  343. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  344. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  345. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  346. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  347. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  348. package/packages/apra-fleet-se/bin/cli.mjs +184 -54
  349. package/packages/apra-fleet-se/bin/serve.mjs +143 -10
  350. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
  351. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  352. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
  353. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  354. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  355. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  356. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
  357. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  358. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  359. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  360. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
  361. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
  362. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  363. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  364. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
  365. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
  366. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  367. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  368. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
  369. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
  370. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  371. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
  372. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
  373. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
  374. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  375. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  376. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  377. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
  378. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  379. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  380. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  381. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  382. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
  383. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  384. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  385. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
  386. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
  387. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  388. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
  389. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
  390. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  391. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
  392. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
  393. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
  394. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  395. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  396. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
  397. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  398. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
  399. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  400. package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
  401. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  402. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
  403. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  404. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  405. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  406. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
  407. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
  408. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
  409. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
  410. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  411. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  413. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  414. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  415. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
  416. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  417. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  418. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
  419. package/packages/apra-fleet-se/package.json +2 -2
  420. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  421. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  422. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  423. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  424. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  425. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  426. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  427. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  428. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  429. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  430. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  431. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  432. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  433. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  434. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  435. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  436. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  437. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  438. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  439. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  440. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  441. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  442. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  443. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  444. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  445. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  446. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  447. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  448. package/packages/apra-fleet-workflow/package.json +1 -1
  449. package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
  450. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  451. package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
  452. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  453. package/skills/fleet/permissions.md +9 -0
  454. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  455. package/version.json +1 -1
  456. package/dist/cli/agent-transform.d.ts.map +0 -1
  457. package/dist/cli/agent-transform.js.map +0 -1
  458. package/dist/cli/auth.d.ts.map +0 -1
  459. package/dist/cli/auth.js.map +0 -1
  460. package/dist/cli/config.d.ts.map +0 -1
  461. package/dist/cli/config.js.map +0 -1
  462. package/dist/cli/dolt-install.d.ts.map +0 -1
  463. package/dist/cli/dolt-install.js.map +0 -1
  464. package/dist/cli/install-guard.d.ts.map +0 -1
  465. package/dist/cli/install-guard.js.map +0 -1
  466. package/dist/cli/install.d.ts.map +0 -1
  467. package/dist/cli/install.js.map +0 -1
  468. package/dist/cli/join.d.ts.map +0 -1
  469. package/dist/cli/join.js.map +0 -1
  470. package/dist/cli/kb-commit.d.ts.map +0 -1
  471. package/dist/cli/kb-commit.js.map +0 -1
  472. package/dist/cli/kb-directives.d.ts.map +0 -1
  473. package/dist/cli/kb-directives.js.map +0 -1
  474. package/dist/cli/kb-import.d.ts.map +0 -1
  475. package/dist/cli/kb-import.js.map +0 -1
  476. package/dist/cli/register-member.d.ts.map +0 -1
  477. package/dist/cli/register-member.js.map +0 -1
  478. package/dist/cli/restart.d.ts.map +0 -1
  479. package/dist/cli/restart.js.map +0 -1
  480. package/dist/cli/secret.d.ts.map +0 -1
  481. package/dist/cli/secret.js.map +0 -1
  482. package/dist/cli/spoke.d.ts.map +0 -1
  483. package/dist/cli/spoke.js.map +0 -1
  484. package/dist/cli/start.d.ts.map +0 -1
  485. package/dist/cli/start.js.map +0 -1
  486. package/dist/cli/status.d.ts.map +0 -1
  487. package/dist/cli/status.js.map +0 -1
  488. package/dist/cli/stop.d.ts.map +0 -1
  489. package/dist/cli/stop.js.map +0 -1
  490. package/dist/cli/uninstall.d.ts.map +0 -1
  491. package/dist/cli/uninstall.js.map +0 -1
  492. package/dist/cli/update.d.ts.map +0 -1
  493. package/dist/cli/update.js.map +0 -1
  494. package/dist/cli/watch.d.ts.map +0 -1
  495. package/dist/cli/watch.js.map +0 -1
  496. package/dist/cli/workflow-assets.d.ts.map +0 -1
  497. package/dist/cli/workflow-assets.js.map +0 -1
  498. package/dist/cli/workflow.d.ts.map +0 -1
  499. package/dist/cli/workflow.js.map +0 -1
  500. package/dist/commands/kb-server.d.ts.map +0 -1
  501. package/dist/commands/kb-server.js.map +0 -1
  502. package/dist/delivery-mode.d.ts.map +0 -1
  503. package/dist/delivery-mode.js.map +0 -1
  504. package/dist/hub-service/activity.d.ts.map +0 -1
  505. package/dist/hub-service/activity.js.map +0 -1
  506. package/dist/hub-service/audit-log.d.ts.map +0 -1
  507. package/dist/hub-service/audit-log.js.map +0 -1
  508. package/dist/hub-service/db/pool.d.ts.map +0 -1
  509. package/dist/hub-service/db/pool.js.map +0 -1
  510. package/dist/hub-service/enrollment.d.ts.map +0 -1
  511. package/dist/hub-service/enrollment.js.map +0 -1
  512. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  513. package/dist/hub-service/envelope-routes.js.map +0 -1
  514. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  515. package/dist/hub-service/handlers/installers.js.map +0 -1
  516. package/dist/hub-service/http-server.d.ts.map +0 -1
  517. package/dist/hub-service/http-server.js.map +0 -1
  518. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  519. package/dist/hub-service/hub-jwt.js.map +0 -1
  520. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  521. package/dist/hub-service/jwt-revocation.js.map +0 -1
  522. package/dist/hub-service/machines.d.ts.map +0 -1
  523. package/dist/hub-service/machines.js.map +0 -1
  524. package/dist/hub-service/main.d.ts.map +0 -1
  525. package/dist/hub-service/main.js.map +0 -1
  526. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  527. package/dist/hub-service/member-tokens.js.map +0 -1
  528. package/dist/hub-service/member-view.d.ts.map +0 -1
  529. package/dist/hub-service/member-view.js.map +0 -1
  530. package/dist/hub-service/members.d.ts.map +0 -1
  531. package/dist/hub-service/members.js.map +0 -1
  532. package/dist/hub-service/presence.d.ts.map +0 -1
  533. package/dist/hub-service/presence.js.map +0 -1
  534. package/dist/hub-service/project-view.d.ts.map +0 -1
  535. package/dist/hub-service/project-view.js.map +0 -1
  536. package/dist/hub-service/projects.d.ts.map +0 -1
  537. package/dist/hub-service/projects.js.map +0 -1
  538. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  539. package/dist/hub-service/relay-queue.js.map +0 -1
  540. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  541. package/dist/hub-service/session-jwt.js.map +0 -1
  542. package/dist/hub-service/usage.d.ts.map +0 -1
  543. package/dist/hub-service/usage.js.map +0 -1
  544. package/dist/hub-service/users.d.ts.map +0 -1
  545. package/dist/hub-service/users.js.map +0 -1
  546. package/dist/hub-service/workspaces.d.ts.map +0 -1
  547. package/dist/hub-service/workspaces.js.map +0 -1
  548. package/dist/index.d.ts.map +0 -1
  549. package/dist/index.js.map +0 -1
  550. package/dist/onboarding/text.d.ts.map +0 -1
  551. package/dist/onboarding/text.js.map +0 -1
  552. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  553. package/dist/os/git-bash-candidates.js.map +0 -1
  554. package/dist/os/index.d.ts.map +0 -1
  555. package/dist/os/index.js.map +0 -1
  556. package/dist/os/linux.d.ts.map +0 -1
  557. package/dist/os/linux.js.map +0 -1
  558. package/dist/os/macos.d.ts.map +0 -1
  559. package/dist/os/macos.js.map +0 -1
  560. package/dist/os/os-commands.d.ts.map +0 -1
  561. package/dist/os/os-commands.js.map +0 -1
  562. package/dist/os/windows-gitbash.d.ts.map +0 -1
  563. package/dist/os/windows-gitbash.js.map +0 -1
  564. package/dist/os/windows-wrapper.d.ts.map +0 -1
  565. package/dist/os/windows-wrapper.js.map +0 -1
  566. package/dist/os/windows.d.ts.map +0 -1
  567. package/dist/os/windows.js.map +0 -1
  568. package/dist/paths.d.ts.map +0 -1
  569. package/dist/paths.js.map +0 -1
  570. package/dist/providers/agy.d.ts.map +0 -1
  571. package/dist/providers/agy.js.map +0 -1
  572. package/dist/providers/claude.d.ts.map +0 -1
  573. package/dist/providers/claude.js.map +0 -1
  574. package/dist/providers/codex.d.ts.map +0 -1
  575. package/dist/providers/codex.js.map +0 -1
  576. package/dist/providers/copilot.d.ts.map +0 -1
  577. package/dist/providers/copilot.js.map +0 -1
  578. package/dist/providers/email/headers.d.ts.map +0 -1
  579. package/dist/providers/email/headers.js.map +0 -1
  580. package/dist/providers/email/index.d.ts.map +0 -1
  581. package/dist/providers/email/index.js.map +0 -1
  582. package/dist/providers/email/provider.d.ts.map +0 -1
  583. package/dist/providers/email/provider.js.map +0 -1
  584. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  585. package/dist/providers/email/sendgrid.js.map +0 -1
  586. package/dist/providers/email/smtp.d.ts.map +0 -1
  587. package/dist/providers/email/smtp.js.map +0 -1
  588. package/dist/providers/index.d.ts.map +0 -1
  589. package/dist/providers/index.js.map +0 -1
  590. package/dist/providers/none.d.ts.map +0 -1
  591. package/dist/providers/none.js.map +0 -1
  592. package/dist/providers/opencode.d.ts.map +0 -1
  593. package/dist/providers/opencode.js.map +0 -1
  594. package/dist/providers/provider.d.ts.map +0 -1
  595. package/dist/providers/provider.js.map +0 -1
  596. package/dist/services/agent-provisioner.d.ts.map +0 -1
  597. package/dist/services/agent-provisioner.js.map +0 -1
  598. package/dist/services/agy-project.d.ts.map +0 -1
  599. package/dist/services/agy-project.js.map +0 -1
  600. package/dist/services/auth-socket.d.ts.map +0 -1
  601. package/dist/services/auth-socket.js.map +0 -1
  602. package/dist/services/auth-web.d.ts.map +0 -1
  603. package/dist/services/auth-web.js.map +0 -1
  604. package/dist/services/budget-awareness.d.ts.map +0 -1
  605. package/dist/services/budget-awareness.js.map +0 -1
  606. package/dist/services/cloud/activity.d.ts.map +0 -1
  607. package/dist/services/cloud/activity.js.map +0 -1
  608. package/dist/services/cloud/aws.d.ts.map +0 -1
  609. package/dist/services/cloud/aws.js.map +0 -1
  610. package/dist/services/cloud/cost.d.ts.map +0 -1
  611. package/dist/services/cloud/cost.js.map +0 -1
  612. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  613. package/dist/services/cloud/idle-manager.js.map +0 -1
  614. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  615. package/dist/services/cloud/lifecycle.js.map +0 -1
  616. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  617. package/dist/services/cloud/task-wrapper.js.map +0 -1
  618. package/dist/services/cloud/types.d.ts.map +0 -1
  619. package/dist/services/cloud/types.js.map +0 -1
  620. package/dist/services/cloud-sync.d.ts.map +0 -1
  621. package/dist/services/cloud-sync.js.map +0 -1
  622. package/dist/services/context-admission.d.ts.map +0 -1
  623. package/dist/services/context-admission.js.map +0 -1
  624. package/dist/services/credential-cleanup.d.ts.map +0 -1
  625. package/dist/services/credential-cleanup.js.map +0 -1
  626. package/dist/services/credential-store.d.ts.map +0 -1
  627. package/dist/services/credential-store.js.map +0 -1
  628. package/dist/services/event-bus.d.ts.map +0 -1
  629. package/dist/services/event-bus.js.map +0 -1
  630. package/dist/services/exit-drain.d.ts.map +0 -1
  631. package/dist/services/exit-drain.js.map +0 -1
  632. package/dist/services/file-chunker.d.ts.map +0 -1
  633. package/dist/services/file-chunker.js.map +0 -1
  634. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  635. package/dist/services/file-transfer-relay.js.map +0 -1
  636. package/dist/services/file-transfer.d.ts.map +0 -1
  637. package/dist/services/file-transfer.js.map +0 -1
  638. package/dist/services/git-config.d.ts.map +0 -1
  639. package/dist/services/git-config.js.map +0 -1
  640. package/dist/services/github-app.d.ts.map +0 -1
  641. package/dist/services/github-app.js.map +0 -1
  642. package/dist/services/http-transport.d.ts.map +0 -1
  643. package/dist/services/http-transport.js.map +0 -1
  644. package/dist/services/hub-client.d.ts.map +0 -1
  645. package/dist/services/hub-client.js.map +0 -1
  646. package/dist/services/icons.d.ts.map +0 -1
  647. package/dist/services/icons.js.map +0 -1
  648. package/dist/services/jwt.d.ts.map +0 -1
  649. package/dist/services/jwt.js.map +0 -1
  650. package/dist/services/knowledge/audn.d.ts.map +0 -1
  651. package/dist/services/knowledge/audn.js.map +0 -1
  652. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  653. package/dist/services/knowledge/file-hash.js.map +0 -1
  654. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  655. package/dist/services/knowledge/http-provider.js.map +0 -1
  656. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  657. package/dist/services/knowledge/kb-config.js.map +0 -1
  658. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  659. package/dist/services/knowledge/kb-providers.js.map +0 -1
  660. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  661. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  662. package/dist/services/knowledge/kb-scope-input.js +0 -11
  663. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  664. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  665. package/dist/services/knowledge/kb-service.js.map +0 -1
  666. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  667. package/dist/services/knowledge/path-validation.js.map +0 -1
  668. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  669. package/dist/services/knowledge/pre-init.js.map +0 -1
  670. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  671. package/dist/services/knowledge/project-slug.js.map +0 -1
  672. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  673. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  674. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  675. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  676. package/dist/services/knowledge/types.d.ts.map +0 -1
  677. package/dist/services/knowledge/types.js.map +0 -1
  678. package/dist/services/known-hosts.d.ts.map +0 -1
  679. package/dist/services/known-hosts.js.map +0 -1
  680. package/dist/services/known-sessions.d.ts.map +0 -1
  681. package/dist/services/known-sessions.js.map +0 -1
  682. package/dist/services/member-home.d.ts.map +0 -1
  683. package/dist/services/member-home.js.map +0 -1
  684. package/dist/services/member-remote-url.d.ts.map +0 -1
  685. package/dist/services/member-remote-url.js.map +0 -1
  686. package/dist/services/model-pricing.d.ts.map +0 -1
  687. package/dist/services/model-pricing.js.map +0 -1
  688. package/dist/services/onboarding.d.ts.map +0 -1
  689. package/dist/services/onboarding.js.map +0 -1
  690. package/dist/services/orphan-recovery.d.ts.map +0 -1
  691. package/dist/services/orphan-recovery.js.map +0 -1
  692. package/dist/services/pending-responses.d.ts.map +0 -1
  693. package/dist/services/pending-responses.js.map +0 -1
  694. package/dist/services/preflight-check.d.ts.map +0 -1
  695. package/dist/services/preflight-check.js.map +0 -1
  696. package/dist/services/registry.d.ts.map +0 -1
  697. package/dist/services/registry.js.map +0 -1
  698. package/dist/services/relay-context.d.ts.map +0 -1
  699. package/dist/services/relay-context.js.map +0 -1
  700. package/dist/services/relay-executor.d.ts.map +0 -1
  701. package/dist/services/relay-executor.js.map +0 -1
  702. package/dist/services/relay-request.d.ts.map +0 -1
  703. package/dist/services/relay-request.js.map +0 -1
  704. package/dist/services/relay-strategy.d.ts.map +0 -1
  705. package/dist/services/relay-strategy.js.map +0 -1
  706. package/dist/services/secret-token.d.ts.map +0 -1
  707. package/dist/services/secret-token.js.map +0 -1
  708. package/dist/services/service-manager/index.d.ts.map +0 -1
  709. package/dist/services/service-manager/index.js.map +0 -1
  710. package/dist/services/service-manager/linux.d.ts.map +0 -1
  711. package/dist/services/service-manager/linux.js.map +0 -1
  712. package/dist/services/service-manager/macos.d.ts.map +0 -1
  713. package/dist/services/service-manager/macos.js.map +0 -1
  714. package/dist/services/service-manager/types.d.ts.map +0 -1
  715. package/dist/services/service-manager/types.js.map +0 -1
  716. package/dist/services/service-manager/windows.d.ts.map +0 -1
  717. package/dist/services/service-manager/windows.js.map +0 -1
  718. package/dist/services/session-registry.d.ts.map +0 -1
  719. package/dist/services/session-registry.js.map +0 -1
  720. package/dist/services/sftp.d.ts.map +0 -1
  721. package/dist/services/sftp.js.map +0 -1
  722. package/dist/services/shell-probe.d.ts.map +0 -1
  723. package/dist/services/shell-probe.js.map +0 -1
  724. package/dist/services/singleton.d.ts.map +0 -1
  725. package/dist/services/singleton.js.map +0 -1
  726. package/dist/services/sprint-coordination.d.ts.map +0 -1
  727. package/dist/services/sprint-coordination.js.map +0 -1
  728. package/dist/services/ssh.d.ts.map +0 -1
  729. package/dist/services/ssh.js.map +0 -1
  730. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  731. package/dist/services/stall/find-log-file.js.map +0 -1
  732. package/dist/services/stall/index.d.ts.map +0 -1
  733. package/dist/services/stall/index.js.map +0 -1
  734. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  735. package/dist/services/stall/log-path-resolver.js.map +0 -1
  736. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  737. package/dist/services/stall/read-log-tail.js.map +0 -1
  738. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  739. package/dist/services/stall/stall-detector.js.map +0 -1
  740. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  741. package/dist/services/stall/stall-poller.js.map +0 -1
  742. package/dist/services/stall/time-utils.d.ts.map +0 -1
  743. package/dist/services/stall/time-utils.js.map +0 -1
  744. package/dist/services/statusline.d.ts.map +0 -1
  745. package/dist/services/statusline.js.map +0 -1
  746. package/dist/services/strategy.d.ts.map +0 -1
  747. package/dist/services/strategy.js.map +0 -1
  748. package/dist/services/substitution-engine.d.ts.map +0 -1
  749. package/dist/services/substitution-engine.js.map +0 -1
  750. package/dist/services/task-cleanup.d.ts.map +0 -1
  751. package/dist/services/task-cleanup.js.map +0 -1
  752. package/dist/services/token-issuer.d.ts.map +0 -1
  753. package/dist/services/token-issuer.js.map +0 -1
  754. package/dist/services/tool-registry.d.ts.map +0 -1
  755. package/dist/services/tool-registry.js.map +0 -1
  756. package/dist/services/update-check.d.ts.map +0 -1
  757. package/dist/services/update-check.js.map +0 -1
  758. package/dist/services/user-config.d.ts.map +0 -1
  759. package/dist/services/user-config.js.map +0 -1
  760. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  761. package/dist/services/vcs/azure-devops.js.map +0 -1
  762. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  763. package/dist/services/vcs/bitbucket.js.map +0 -1
  764. package/dist/services/vcs/constants.d.ts.map +0 -1
  765. package/dist/services/vcs/constants.js.map +0 -1
  766. package/dist/services/vcs/github.d.ts.map +0 -1
  767. package/dist/services/vcs/github.js.map +0 -1
  768. package/dist/services/vcs/types.d.ts.map +0 -1
  769. package/dist/services/vcs/types.js.map +0 -1
  770. package/dist/services/version-check.d.ts.map +0 -1
  771. package/dist/services/version-check.js.map +0 -1
  772. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  773. package/dist/services/watch/fleet-log.js.map +0 -1
  774. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  775. package/dist/services/watch/project-resolver.js.map +0 -1
  776. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  777. package/dist/services/watch/transcript-formatter.js.map +0 -1
  778. package/dist/smoke-test.d.ts.map +0 -1
  779. package/dist/smoke-test.js.map +0 -1
  780. package/dist/tools/check-status.d.ts.map +0 -1
  781. package/dist/tools/check-status.js.map +0 -1
  782. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  783. package/dist/tools/child-id-allocator.js.map +0 -1
  784. package/dist/tools/cloud-control.d.ts.map +0 -1
  785. package/dist/tools/cloud-control.js.map +0 -1
  786. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  787. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  788. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  789. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  790. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  791. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  792. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  793. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  794. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  795. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  796. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  797. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  798. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  799. package/dist/tools/code-intelligence-tests.js.map +0 -1
  800. package/dist/tools/code-intelligence.d.ts.map +0 -1
  801. package/dist/tools/code-intelligence.js.map +0 -1
  802. package/dist/tools/compose-permissions.d.ts.map +0 -1
  803. package/dist/tools/compose-permissions.js.map +0 -1
  804. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  805. package/dist/tools/credential-store-delete.js.map +0 -1
  806. package/dist/tools/credential-store-list.d.ts.map +0 -1
  807. package/dist/tools/credential-store-list.js.map +0 -1
  808. package/dist/tools/credential-store-set.d.ts.map +0 -1
  809. package/dist/tools/credential-store-set.js.map +0 -1
  810. package/dist/tools/credential-store-update.d.ts.map +0 -1
  811. package/dist/tools/credential-store-update.js.map +0 -1
  812. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  813. package/dist/tools/dolt-push-mutex.js.map +0 -1
  814. package/dist/tools/execute-command.d.ts.map +0 -1
  815. package/dist/tools/execute-command.js.map +0 -1
  816. package/dist/tools/execute-prompt.d.ts.map +0 -1
  817. package/dist/tools/execute-prompt.js.map +0 -1
  818. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  819. package/dist/tools/get-member-model-pricing.js.map +0 -1
  820. package/dist/tools/kb-capture.d.ts.map +0 -1
  821. package/dist/tools/kb-capture.js.map +0 -1
  822. package/dist/tools/kb-context.d.ts.map +0 -1
  823. package/dist/tools/kb-context.js.map +0 -1
  824. package/dist/tools/kb-export.d.ts.map +0 -1
  825. package/dist/tools/kb-export.js.map +0 -1
  826. package/dist/tools/kb-feedback.d.ts.map +0 -1
  827. package/dist/tools/kb-feedback.js.map +0 -1
  828. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  829. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  830. package/dist/tools/kb-harvest.d.ts.map +0 -1
  831. package/dist/tools/kb-harvest.js.map +0 -1
  832. package/dist/tools/kb-import.d.ts.map +0 -1
  833. package/dist/tools/kb-import.js.map +0 -1
  834. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  835. package/dist/tools/kb-invalidate.js.map +0 -1
  836. package/dist/tools/kb-list.d.ts.map +0 -1
  837. package/dist/tools/kb-list.js.map +0 -1
  838. package/dist/tools/kb-promote.d.ts.map +0 -1
  839. package/dist/tools/kb-promote.js.map +0 -1
  840. package/dist/tools/kb-query.d.ts.map +0 -1
  841. package/dist/tools/kb-query.js.map +0 -1
  842. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  843. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  844. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  845. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  846. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  847. package/dist/tools/kb-session-prime.js.map +0 -1
  848. package/dist/tools/kb-setup.d.ts.map +0 -1
  849. package/dist/tools/kb-setup.js.map +0 -1
  850. package/dist/tools/kb-stats.d.ts.map +0 -1
  851. package/dist/tools/kb-stats.js.map +0 -1
  852. package/dist/tools/list-members.d.ts.map +0 -1
  853. package/dist/tools/list-members.js.map +0 -1
  854. package/dist/tools/member-detail.d.ts.map +0 -1
  855. package/dist/tools/member-detail.js.map +0 -1
  856. package/dist/tools/member-reservation.d.ts.map +0 -1
  857. package/dist/tools/member-reservation.js.map +0 -1
  858. package/dist/tools/monitor-task.d.ts.map +0 -1
  859. package/dist/tools/monitor-task.js.map +0 -1
  860. package/dist/tools/provision-auth.d.ts.map +0 -1
  861. package/dist/tools/provision-auth.js.map +0 -1
  862. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  863. package/dist/tools/provision-vcs-auth.js.map +0 -1
  864. package/dist/tools/receive-files.d.ts.map +0 -1
  865. package/dist/tools/receive-files.js.map +0 -1
  866. package/dist/tools/register-member.d.ts.map +0 -1
  867. package/dist/tools/register-member.js.map +0 -1
  868. package/dist/tools/remove-member.d.ts.map +0 -1
  869. package/dist/tools/remove-member.js.map +0 -1
  870. package/dist/tools/report-status.d.ts.map +0 -1
  871. package/dist/tools/report-status.js.map +0 -1
  872. package/dist/tools/respond-to-message.d.ts.map +0 -1
  873. package/dist/tools/respond-to-message.js.map +0 -1
  874. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  875. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  876. package/dist/tools/send-email.d.ts.map +0 -1
  877. package/dist/tools/send-email.js.map +0 -1
  878. package/dist/tools/send-files.d.ts.map +0 -1
  879. package/dist/tools/send-files.js.map +0 -1
  880. package/dist/tools/send-message.d.ts.map +0 -1
  881. package/dist/tools/send-message.js.map +0 -1
  882. package/dist/tools/setup-git-app.d.ts.map +0 -1
  883. package/dist/tools/setup-git-app.js.map +0 -1
  884. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  885. package/dist/tools/setup-ssh-key.js.map +0 -1
  886. package/dist/tools/shutdown-server.d.ts.map +0 -1
  887. package/dist/tools/shutdown-server.js.map +0 -1
  888. package/dist/tools/stop-prompt.d.ts.map +0 -1
  889. package/dist/tools/stop-prompt.js.map +0 -1
  890. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  891. package/dist/tools/update-agent-cli.js.map +0 -1
  892. package/dist/tools/update-member.d.ts.map +0 -1
  893. package/dist/tools/update-member.js.map +0 -1
  894. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  895. package/dist/tools/vcs-credential-exec.js.map +0 -1
  896. package/dist/tools/version.d.ts.map +0 -1
  897. package/dist/tools/version.js.map +0 -1
  898. package/dist/types.d.ts.map +0 -1
  899. package/dist/types.js.map +0 -1
  900. package/dist/utils/agent-helpers.d.ts.map +0 -1
  901. package/dist/utils/agent-helpers.js.map +0 -1
  902. package/dist/utils/ansi.d.ts.map +0 -1
  903. package/dist/utils/ansi.js.map +0 -1
  904. package/dist/utils/auth-env.d.ts.map +0 -1
  905. package/dist/utils/auth-env.js.map +0 -1
  906. package/dist/utils/collect-secret.d.ts.map +0 -1
  907. package/dist/utils/collect-secret.js.map +0 -1
  908. package/dist/utils/credential-validation.d.ts.map +0 -1
  909. package/dist/utils/credential-validation.js.map +0 -1
  910. package/dist/utils/crypto.d.ts.map +0 -1
  911. package/dist/utils/crypto.js.map +0 -1
  912. package/dist/utils/deep-merge.d.ts.map +0 -1
  913. package/dist/utils/deep-merge.js.map +0 -1
  914. package/dist/utils/file-permissions.d.ts.map +0 -1
  915. package/dist/utils/file-permissions.js.map +0 -1
  916. package/dist/utils/gpu-parser.d.ts.map +0 -1
  917. package/dist/utils/gpu-parser.js.map +0 -1
  918. package/dist/utils/log-helpers.d.ts.map +0 -1
  919. package/dist/utils/log-helpers.js.map +0 -1
  920. package/dist/utils/oob-timeout.d.ts.map +0 -1
  921. package/dist/utils/oob-timeout.js.map +0 -1
  922. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  923. package/dist/utils/opencode-model-validation.js.map +0 -1
  924. package/dist/utils/pid-helpers.d.ts.map +0 -1
  925. package/dist/utils/pid-helpers.js.map +0 -1
  926. package/dist/utils/platform.d.ts.map +0 -1
  927. package/dist/utils/platform.js.map +0 -1
  928. package/dist/utils/process-utils.d.ts.map +0 -1
  929. package/dist/utils/process-utils.js.map +0 -1
  930. package/dist/utils/prompt-errors.d.ts.map +0 -1
  931. package/dist/utils/prompt-errors.js.map +0 -1
  932. package/dist/utils/resolve-member.d.ts.map +0 -1
  933. package/dist/utils/resolve-member.js.map +0 -1
  934. package/dist/utils/secure-input.d.ts.map +0 -1
  935. package/dist/utils/secure-input.js.map +0 -1
  936. package/dist/utils/session-caller.d.ts.map +0 -1
  937. package/dist/utils/session-caller.js.map +0 -1
  938. package/dist/utils/shell-escape.d.ts.map +0 -1
  939. package/dist/utils/shell-escape.js.map +0 -1
  940. package/dist/utils/skill-matrix.d.ts.map +0 -1
  941. package/dist/utils/skill-matrix.js.map +0 -1
  942. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  943. package/dist/utils/ssh-error-messages.js.map +0 -1
  944. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  945. package/dist/utils/vcs-provider-detect.js.map +0 -1
  946. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  947. package/dist/utils/work-folder-validation.js.map +0 -1
  948. package/dist/utils/workspace-trust.d.ts.map +0 -1
  949. package/dist/utils/workspace-trust.js.map +0 -1
  950. package/dist/version.d.ts.map +0 -1
  951. package/dist/version.js.map +0 -1
@@ -170,6 +170,13 @@ export function createUsageLimitPauseController({
170
170
  // Probe before trusting the clock: one real dispatch to the same
171
171
  // member at the same tier.
172
172
  try {
173
+ // Deliberately NOT strict (no fail_on_permission_denial): the
174
+ // probe only tests whether the member answers at all after a
175
+ // usage-limit wait, it runs no tools, and a permission refusal
176
+ // there says nothing about the usage limit. A refusal must not
177
+ // be read as a usage limit (isUsageLimitDispatchError matches
178
+ // only the usage_limit reason) nor abort the wait: any such
179
+ // outcome falls through to the inconclusive-probe handling below.
173
180
  await agent(PROBE_PROMPT, {
174
181
  member_name: member,
175
182
  ...(tier ? { model: tier } : {}),
@@ -10,7 +10,7 @@
10
10
  // (provisionOutcome below), keeping the prose regexes only as a fallback for
11
11
  // a result with no structuredContent at all.
12
12
  import { ApraFleet } from '@apralabs/apra-fleet-client';
13
- import { buildCreatePrCommand, resolveProvider, capabilities as vcsCapabilities, parseProviderRepoRef, getVcsProvider, resolveVcsAuthProviderForHost, isAuthBackend, VCS_NO_REGISTERED_PROVIDER, DEFAULT_VCS_PROVIDER } from './vcs-module.mjs';
13
+ import { buildCreatePrCommand, buildFindPrCommand, buildUpdatePrCommand, resolveProvider, capabilities as vcsCapabilities, parseProviderRepoRef, getVcsProvider, resolveVcsAuthProviderForHost, isAuthBackend, VCS_NO_REGISTERED_PROVIDER, DEFAULT_VCS_PROVIDER } from './vcs-module.mjs';
14
14
  import { getSeCommands } from './se-os-commands.mjs';
15
15
  import { resolveMemberTarget } from './member-target.mjs';
16
16
  import { resultText } from './mcp-result.mjs';
@@ -273,7 +273,7 @@ async function provisionVcsAuthForMember({ fleetApi, command, member, log = () =
273
273
  // origin remote via a real git-capable member (e.g. Publish PR's
274
274
  // publishGitMember) passes it here instead of making THIS function shell
275
275
  // out its own 'git remote get-url origin' to `member` -- which matters
276
- // when `member` is orchestratorMember and may be a git-less/shared member
276
+ // when `member` is backlogMember and may be a git-less/shared member
277
277
  // with no checkout to read a remote from at all. Skips the read entirely,
278
278
  // never the parse below.
279
279
  if (remoteUrlOverride) {
@@ -451,7 +451,7 @@ async function provisionVcsAuthForMember({ fleetApi, command, member, log = () =
451
451
  * @param {{ fleetApi: object, command: Function, member: string, log?: Function, logPrefix: string }} opts
452
452
  * @returns {Promise<{ expiresAt: Date|null, repo: string|null }>}
453
453
  */
454
- async function provisionPrCapableAuthForMember({ fleetApi, command, member, log = () => {}, logPrefix, remoteUrlOverride }) {
454
+ export async function provisionPrCapableAuthForMember({ fleetApi, command, member, log = () => {}, logPrefix, remoteUrlOverride }) {
455
455
  return provisionVcsAuthForMember({ fleetApi, command, member, log, logPrefix, gitAccess: 'push+pr', remoteUrlOverride });
456
456
  }
457
457
 
@@ -658,11 +658,24 @@ function isPrAuthFailure(status, errorText) {
658
658
  // server-side. If the retry still fails, the failure (auth or not) is
659
659
  // returned as-is; the raw token is never logged (and is never even held
660
660
  // here), only `built.logSafeCommand`.
661
+ //
662
+ // EXISTING-PR UPDATE (optional `updateExisting`). A sprint relaunched on a
663
+ // branch that already has a PR must not leave the old run's verdict in the
664
+ // title/body. When the caller passes `updateExisting(old) -> { title, body }`
665
+ // and creation reports already-exists, this finds the open PR for
666
+ // head -> base (provider 'find-pull-request' builder -- the create response
667
+ // carries neither the PR id nor its current body), hands the old title/body
668
+ // to `updateExisting`, and PATCHes the result ('update-pull-request'
669
+ // builder), with the same placeholder handoff, body cap and one-shot auth
670
+ // self-heal as creation. It never throws: any failure (including a provider
671
+ // with no such builder) comes back as `updated: false` + `updateError` for
672
+ // the caller to log as a WARNING, leaving the PR as it was. Without
673
+ // `updateExisting` the returned shape is exactly the historical one.
661
674
  /**
662
- * @param {{ fleetApi: object, command: Function, member: string, base: string, head: string, title: string, body?: string, log?: Function, logPrefix: string }} opts
663
- * @returns {Promise<{ ok: boolean, alreadyExists: boolean, prUrl: string|null, error: string|null, authFailure: boolean }>}
675
+ * @param {{ fleetApi: object, command: Function, member: string, base: string, head: string, title: string, body?: string, log?: Function, logPrefix: string, updateExisting?: Function }} opts
676
+ * @returns {Promise<{ ok: boolean, alreadyExists: boolean, prUrl: string|null, error: string|null, authFailure: boolean, updated?: boolean, updateError?: string|null }>}
664
677
  */
665
- export async function raiseVcsPrForMember({ fleetApi, command, member, base, head, title, body, log = () => {}, logPrefix, remoteUrlOverride }) {
678
+ export async function raiseVcsPrForMember({ fleetApi, command, member, base, head, title, body, log = () => {}, logPrefix, remoteUrlOverride, updateExisting }) {
666
679
  let repo;
667
680
  try {
668
681
  ({ repo } = await provisionPrCapableAuthForMember({ fleetApi, command, member, log, logPrefix, remoteUrlOverride }));
@@ -765,6 +778,70 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
765
778
  }
766
779
  const repoRef = providerRef ? providerRef.ref : null;
767
780
 
781
+ // One REST round trip for the existing-PR update path (see the header
782
+ // note): placeholder handoff, 2xx check, one-shot auth self-heal. Returns
783
+ // { ok, built, body } or { ok: false, error } -- never throws on an HTTP
784
+ // or handoff failure.
785
+ const runUpdatePathCall = async (buildFn, what) => {
786
+ let healed = false;
787
+ // eslint-disable-next-line no-constant-condition
788
+ while (true) {
789
+ const b = buildFn();
790
+ const res = await fleetApi.vcsCredentialExec({ member_name: member, label: credentialLabel, command: b.command });
791
+ const h = (res && res.structuredContent) || {};
792
+ if (!h.ok || (typeof h.exitCode === 'number' && h.exitCode !== 0)) {
793
+ return { ok: false, error: `${what} dispatch failed (${h.reason || 'nonzero exit'}): ${h.stderr || resultText(res) || '(no detail)'}` };
794
+ }
795
+ const parsed = parseVcsCurlOutput(h.stdout);
796
+ const [lo, hi] = b.interpret.successStatusRange;
797
+ if (parsed.status !== null && parsed.status >= lo && parsed.status <= hi) return { ok: true, built: b, body: parsed.body };
798
+ const msg = (parsed.body && typeof parsed.body.message === 'string') ? parsed.body.message : (parsed.bodyText || '');
799
+ if (isPrAuthFailure(parsed.status, msg) && !healed) {
800
+ healed = true;
801
+ log(`${logPrefix}: ${what} returned an auth-classified failure (HTTP ${parsed.status ?? '(unknown)'}) for member '${member}'; re-provisioning a push+pr credential and retrying once (command: ${b.logSafeCommand}): ${msg}`);
802
+ try {
803
+ const reprov = await provisionPrCapableAuthForMember({ fleetApi, command, member, log, logPrefix, remoteUrlOverride });
804
+ if (reprov.repo) repo = reprov.repo;
805
+ } catch (healErr) {
806
+ return { ok: false, error: `${what} auth self-heal failed: ${healErr.message}` };
807
+ }
808
+ continue;
809
+ }
810
+ return { ok: false, error: `${what} failed: HTTP ${parsed.status ?? '(unknown)'}: ${msg}` };
811
+ }
812
+ };
813
+ const updateExistingPr = async () => {
814
+ try {
815
+ const coords = () => ({ provider, ...(repoRef ? { repoRef } : { repo }), token, os, shell });
816
+ const found = await runUpdatePathCall(() => buildFindPrCommand({ ...coords(), base, head }), 'find-pull-request');
817
+ if (!found.ok) return { updated: false, updateError: found.error, prUrl: null };
818
+ const prs = found.built.mapResponse(found.body);
819
+ if (!prs.length) {
820
+ return { updated: false, updateError: `no open pull request found for '${head}' -> '${base}'`, prUrl: null };
821
+ }
822
+ const pr = prs[0];
823
+ const next = updateExisting({ title: pr.title, body: pr.body }) || {};
824
+ let warned = false;
825
+ const upd = await runUpdatePathCall(() => {
826
+ const b = buildUpdatePrCommand({
827
+ ...coords(),
828
+ pull_request_id: pr.id,
829
+ title: next.title || title,
830
+ body: next.body !== undefined ? next.body : body,
831
+ });
832
+ if (b.descriptionTruncated && !warned) {
833
+ warned = true;
834
+ log(`${logPrefix}: WARNING: updated PR description for member '${member}' was ${b.descriptionTruncated.originalLength} chars, exceeding the ${b.descriptionTruncated.maxLength}-char limit; truncated.`);
835
+ }
836
+ return b;
837
+ }, 'update-pull-request');
838
+ if (!upd.ok) return { updated: false, updateError: upd.error, prUrl: pr.url };
839
+ return { updated: true, updateError: null, prUrl: pr.url };
840
+ } catch (err) {
841
+ return { updated: false, updateError: (err && err.message) ? err.message : String(err), prUrl: null };
842
+ }
843
+ };
844
+
768
845
  let authHealAttempted = false;
769
846
  // apra-fleet PR-body length fix: buildCreatePrCommand deterministically
770
847
  // truncates `body` to PR_DESCRIPTION_MAX_LENGTH and reports it back via
@@ -854,7 +931,10 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
854
931
  if (status === built.interpret.alreadyExistsStatus && new RegExp(built.interpret.alreadyExistsPattern, 'i').test(errorText)) {
855
932
  const urlMatch = /https?:\/\/\S+/.exec(errorText);
856
933
  const existingUrl = urlMatch ? urlMatch[0].replace(/[.,)]+$/, '') : null;
857
- return { ok: true, alreadyExists: true, prUrl: existingUrl, error: null, authFailure: false };
934
+ const existing = { ok: true, alreadyExists: true, prUrl: existingUrl, error: null, authFailure: false };
935
+ if (typeof updateExisting !== 'function') return existing;
936
+ const upd = await updateExistingPr();
937
+ return { ...existing, prUrl: upd.prUrl || existingUrl, updated: upd.updated, updateError: upd.updateError };
858
938
  }
859
939
 
860
940
  if (isPrAuthFailure(status, errorText) && !authHealAttempted) {
@@ -936,14 +1016,44 @@ export function createMemberVcsProviderResolver(opts = {}) {
936
1016
  * transport-agnostic and unit-testable without a live fleet server.
937
1017
  *
938
1018
  * @param {{ callTool: (name: string, args: object) => Promise<any>, command: Function, log?: Function }} opts
939
- * @returns {(info: { member: string, label: string, cmd?: string, error: string, kind: 'git'|'dolt' }) => Promise<void>}
1019
+ * @returns {((info: { member: string, label: string, cmd?: string, error: string, source?: 'git'|'dolt', failureKind?: string }) => Promise<void>) & { recordHealOutcome: (info: { member: string, label: string, error: string, recovered: boolean }) => Promise<void> }}
940
1020
  */
941
1021
  export function createVcsAuthSelfHealCallback(opts = {}) {
942
- const { callTool, command, log = () => {}, azdevopsPatSecretName } = opts;
1022
+ const { callTool, command, log = () => {}, azdevopsPatSecretName, now = () => Date.now(), futileHealTtlMs = FUTILE_HEAL_TTL_MS } = opts;
943
1023
  const fleetApi = new ApraFleet({ callTool });
1024
+ // GitHub #616: last-resort heals of UNCLASSIFIED failures that ran and did
1025
+ // NOT recover, keyed by member + normalised error, so the same futile
1026
+ // re-provisioning is not repeated on every D-pull. Only 'unknown' failures
1027
+ // are remembered -- a genuine auth failure is always healed -- and each
1028
+ // entry expires after futileHealTtlMs, so a later, different cause behind
1029
+ // the same text still gets a heal.
1030
+ /** @type {Map<string, { label: string, at: number }>} */
1031
+ const futileHeals = new Map();
944
1032
 
945
- return async function onAuthFailure({ member, label, error }) {
946
- log(`[Sync] self-heal: auth failure detected for member '${member}' (${label}); calling provision_vcs_auth to re-provision credentials: ${error}`);
1033
+ function rememberedFutileHeal(key) {
1034
+ const entry = futileHeals.get(key);
1035
+ if (!entry) return null;
1036
+ if (now() - entry.at >= futileHealTtlMs) {
1037
+ futileHeals.delete(key);
1038
+ return null;
1039
+ }
1040
+ return entry;
1041
+ }
1042
+
1043
+ async function onAuthFailure({ member, label, error, source, failureKind }) {
1044
+ if (failureKind === 'unknown') {
1045
+ const entry = rememberedFutileHeal(selfHealMemoryKey(member, error));
1046
+ if (entry) {
1047
+ throw new Error(
1048
+ `skipping self-heal for member '${member}' (${label}): re-provisioning credentials already failed to recover ` +
1049
+ `this same unclassified failure earlier in this run (${entry.label}); fix the cause on the member instead.`,
1050
+ );
1051
+ }
1052
+ }
1053
+ const isAuth = failureKind === undefined || failureKind === 'auth';
1054
+ log(isAuth
1055
+ ? `[Sync] self-heal: auth failure detected for member '${member}' (${label}${source ? `, ${source}` : ''}); calling provision_vcs_auth to re-provision credentials: ${error}`
1056
+ : `[Sync] self-heal: unclassified failure for member '${member}' (${label}${source ? `, ${source}` : ''}); re-provisioning credentials as a last resort via provision_vcs_auth: ${error}`);
947
1057
 
948
1058
  // apra-fleet-5co8.4.2: some providers (e.g. Azure DevOps PATs) can
949
1059
  // never be fixed by this reactive re-provisioning call alone -- it
@@ -975,8 +1085,47 @@ export function createVcsAuthSelfHealCallback(opts = {}) {
975
1085
 
976
1086
  await provisionVcsAuthForMember({ fleetApi, command, member, log, logPrefix: '[Sync] self-heal', azdevopsPatSecretName, resolvedProvider: resolved });
977
1087
 
978
- log(`[Sync] self-heal: provision_vcs_auth succeeded for member '${member}' (${label}); the failed command will be retried once.`);
1088
+ log(`[Sync] self-heal: credentials re-provisioned for member '${member}' (${label}); the failed command will be retried once.`);
1089
+ }
1090
+
1091
+ /**
1092
+ * Called by runGitStep/runDoltStep after the post-heal retry; a heal that
1093
+ * did not recover is remembered so it is not attempted again this run.
1094
+ * @param {{ member: string, label: string, error: string, recovered: boolean, failureKind?: string }} info
1095
+ */
1096
+ onAuthFailure.recordHealOutcome = async function recordHealOutcome({ member, label, error, recovered, failureKind }) {
1097
+ if (recovered || failureKind !== 'unknown') return;
1098
+ futileHeals.set(selfHealMemoryKey(member, error), { label, at: now() });
979
1099
  };
1100
+
1101
+ return onAuthFailure;
1102
+ }
1103
+
1104
+ /** How long a futile unclassified self-heal is remembered (30 minutes). */
1105
+ export const FUTILE_HEAL_TTL_MS = 30 * 60 * 1000;
1106
+
1107
+ /**
1108
+ * Key for remembering a futile self-heal: the member plus the failure's
1109
+ * DISTINGUISHING text. Warning/hint lines (shell-profile noise, git hints) are
1110
+ * dropped and the fatal/error lines kept (else the TAIL of what remains), so
1111
+ * two failures sharing a long common prefix never collapse into one key. The
1112
+ * run-varying parts (pids, counts, hex ids, whitespace runs) are normalised
1113
+ * away, but the number after "exit code"/"exit status" is kept, so distinct
1114
+ * exit codes stay distinct.
1115
+ * @param {string} member
1116
+ * @param {string} error
1117
+ * @returns {string}
1118
+ */
1119
+ export function selfHealMemoryKey(member, error) {
1120
+ const lines = String(error || '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean)
1121
+ .filter((l) => !/^(?:remote:\s*)?(?:warning|hint)\b/i.test(l));
1122
+ const decisive = lines.filter((l) => /\b(?:fatal|error)\b/i.test(l));
1123
+ let text = (decisive.length > 0 ? decisive : lines).join(' ');
1124
+ text = text.replace(/(\bexit (?:code|status)\s*:?\s*)(\d+)|\b[0-9a-f]{7,}\b|\d+/gi,
1125
+ (m, prefix, code) => (prefix ? `${prefix}${code}` : (/^\d+$/.test(m) ? '<n>' : '<hex>')));
1126
+ text = text.toLowerCase().replace(/\s+/g, ' ').trim();
1127
+ if (text.length > 500) text = text.slice(-500);
1128
+ return `${member}|${text}`;
980
1129
  }
981
1130
 
982
1131
  // How far ahead of a credential's known expiry the preflight treats it as
@@ -1023,7 +1172,11 @@ export function createVcsAuthPreflightCallback(opts = {}) {
1023
1172
  if (expiresAt === null || expiresAt.getTime() - now() > VCS_AUTH_EXPIRY_PREFLIGHT_MS) {
1024
1173
  // Still fresh (or a no-expiry credential type) -- skip, so
1025
1174
  // this is not an unconditional provisioning call on every
1026
- // dispatch.
1175
+ // dispatch. Still state WHY nothing was provisioned, so the
1176
+ // "needs a fresh VCS credential" line is never left dangling.
1177
+ log(expiresAt === null
1178
+ ? `[Sync] preflight: provision_vcs_auth skipped for member '${member}': PAT mode, credential has no expiry.`
1179
+ : `[Sync] preflight: provision_vcs_auth skipped for member '${member}': cached credential fresh until ${expiresAt.toISOString()}.`);
1027
1180
  return;
1028
1181
  }
1029
1182
  }
@@ -1151,7 +1304,11 @@ export function createWorkflowsPermissionPreflightCallback(opts = {}) {
1151
1304
 
1152
1305
  return async function warnIfWorkflowsPermissionMissing(member, branch, baseBranch) {
1153
1306
  try {
1154
- if (!branch || !baseBranch || branch === baseBranch) return;
1307
+ // branch === baseBranch is rejected at launch (sprint-args.mjs
1308
+ // validateBranchPair), so it is no longer tolerated as a silent no-op
1309
+ // here: a same-named pair falls through to the ahead-count check,
1310
+ // which still returns early when nothing is ahead of origin.
1311
+ if (!branch || !baseBranch) return;
1155
1312
  if (silentMembers.has(member)) return;
1156
1313
 
1157
1314
  const { provider, authMode } = await resolveProvider(member, { fleetApi });
@@ -1273,6 +1430,15 @@ export function createLlmAuthSelfHealCallback(opts = {}) {
1273
1430
  return false;
1274
1431
  }
1275
1432
 
1433
+ if (outcome.reason === 'deployed_unverified') {
1434
+ // Credentials were deployed but the server's post-deploy auth test
1435
+ // did not confirm them: surface its error line and the explicit
1436
+ // switch, then still retry once (the test can be stricter than a real dispatch).
1437
+ const authLine = (text.split('\n').find((l) => /Auth test/i.test(l)) || '').trim();
1438
+ log(`[Dispatch] self-heal: provision_llm_auth deployed credentials for member '${member}' (${label}) but could not verify them${authLine ? `: ${authLine}` : ''}. If the member's stored credential is stale, re-run provision_llm_auth with a fresh api_key, or with force_oauth_copy: true to use your local login. Retrying the failed dispatch once.`);
1439
+ return true;
1440
+ }
1441
+
1276
1442
  log(`[Dispatch] self-heal: provision_llm_auth succeeded for member '${member}' (${label}); the failed dispatch will be retried once.`);
1277
1443
  return true;
1278
1444
  };
@@ -43,7 +43,8 @@ import {
43
43
 
44
44
  /**
45
45
  * Provider-dispatched command build step. `action` is one of
46
- * 'create-pull-request' | 'comment'; `params.provider` selects the REST
46
+ * 'create-pull-request' | 'comment' | 'find-pull-request' |
47
+ * 'update-pull-request'; `params.provider` selects the REST
47
48
  * dispatch. Pure and deterministic -- no network I/O, no filesystem access,
48
49
  * no randomness (beyond whatever caller-supplied fields it is handed).
49
50
  *
@@ -101,6 +102,12 @@ export const PR_DESCRIPTION_MAX_LENGTH = 3500;
101
102
  * log/emit the warning through its own logging convention.
102
103
  */
103
104
  export function buildCreatePrCommand(params) {
105
+ return buildCappedBodyCommand('create-pull-request', params);
106
+ }
107
+
108
+ /** Shared PR_DESCRIPTION_MAX_LENGTH enforcement for every action that sends a
109
+ * PR description (create-pull-request, update-pull-request). */
110
+ function buildCappedBodyCommand(action, params) {
104
111
  const { body } = params || {};
105
112
  let effectiveBody = body;
106
113
  let descriptionTruncated = null;
@@ -108,10 +115,31 @@ export function buildCreatePrCommand(params) {
108
115
  descriptionTruncated = { originalLength: body.length, maxLength: PR_DESCRIPTION_MAX_LENGTH };
109
116
  effectiveBody = body.slice(0, PR_DESCRIPTION_MAX_LENGTH);
110
117
  }
111
- const built = buildVcsCommand('create-pull-request', { ...params, body: effectiveBody });
118
+ const built = buildVcsCommand(action, { ...params, body: effectiveBody });
112
119
  return descriptionTruncated ? { ...built, descriptionTruncated } : { ...built, descriptionTruncated: null };
113
120
  }
114
121
 
122
+ /**
123
+ * Build a "find the open PR for head -> base" command for the given provider.
124
+ * The returned object carries `mapResponse(body)` -> [{ id, title, body, url }]
125
+ * so a caller reads the provider's list dialect without knowing it. A
126
+ * provider with no such builder fails with the same typed "ERROR: ... does
127
+ * not yet implement action" as every other missing action.
128
+ */
129
+ export function buildFindPrCommand(params) {
130
+ return buildVcsCommand('find-pull-request', params);
131
+ }
132
+
133
+ /**
134
+ * Build an "update an existing PR's title/description" command for the given
135
+ * provider (`params.pull_request_id` from buildFindPrCommand's mapping). Same
136
+ * deterministic PR_DESCRIPTION_MAX_LENGTH cap and `descriptionTruncated`
137
+ * report as buildCreatePrCommand.
138
+ */
139
+ export function buildUpdatePrCommand(params) {
140
+ return buildCappedBodyCommand('update-pull-request', params);
141
+ }
142
+
115
143
  // ---------------------------------------------------------------------------
116
144
  // Provider resolution (apra-fleet-647.1.2.1; refolded onto the registry
117
145
  // apra-fleet-647.1.5.1)
@@ -238,6 +266,7 @@ export function buildCommentCommand(params) {
238
266
  // TRANSIENT | true | network / server / lock blip | retry, bounded
239
267
  // NO_REMOTE | false | no remote configured; nothing to sync | none; benign no-op
240
268
  // UNSUPPORTED_OPERATION | false | action not implemented for this provider | fix the call/config
269
+ // MISSING_TOOL | false | the binary is not installed / not on PATH| install it / fix PATH
241
270
  // UNKNOWN | false | unrecognized -- must surface, not guess | operator triage
242
271
  //
243
272
  // `retryable` is true ONLY for TRANSIENT, and means "safe to re-run the same
@@ -268,6 +297,89 @@ export function buildCommentCommand(params) {
268
297
  // possibly help" apart from every other AUTH_DENIED, WITHOUT re-reading
269
298
  // stderr at the call site.
270
299
 
300
+ // MISSING TOOL (GitHub #616). Provider-agnostic shell/spawn wording for "a
301
+ // binary could not be found on this member". It is decided BEFORE the
302
+ // permission-scope and provider rules, but ONLY when the binary the wording
303
+ // names is the binary the failing step itself ran (`opts.tool`, see
304
+ // commandBinary). A member's shell profile routinely prints unrelated "not
305
+ // found" noise (`.bashrc: line 12: pyenv: command not found`, PowerShell
306
+ // "conda : The term 'conda' is not recognized ...", a git hook's `npx: command
307
+ // not found`, a server-side `git-receive-pack: command not found`) ahead of
308
+ // the real failure; that noise must never outrank the real classification
309
+ // (a diverged pull, an auth refusal, a lock). Unnamed signals (exit code 127,
310
+ // the generic "is not recognized" tails) count only when the step's binary is
311
+ // known and the text names no other binary. Without step context the named
312
+ // binary must be one of the sync tools (DEFAULT_MISSING_TOOL_TARGETS).
313
+ // Windows (PowerShell, cmd.exe) and POSIX (bash, zsh, dash/sh) wordings are
314
+ // covered, plus exit code 127 and Node's spawn ENOENT.
315
+ const MISSING_TOOL_NAMED_RULES = Object.freeze([
316
+ // PowerShell: "bd : The term 'bd' is not recognized as the name of a cmdlet, function, ..."
317
+ /The term '([^']+)' is not recognized as the name of a cmdlet/i,
318
+ // cmd.exe: "'bd' is not recognized as an internal or external command,"
319
+ /'([^']+)' is not recognized as an internal or external command/i,
320
+ // zsh: "zsh: command not found: bd" (checked before the bash form so the
321
+ // "zsh:" prefix is never read as the tool)
322
+ /command not found: ([^\s'"]+)/i,
323
+ // bash: "bash: bd: command not found", "bash: line 1: bd: command not found"
324
+ /([^\s:'"]+): command not found/i,
325
+ // dash/sh: "sh: 1: bd: not found"
326
+ /(?:^|\n|\s)(?:\/bin\/)?(?:sh|dash|bash): (?:line )?\d+: ([^\s:'"]+): not found/i,
327
+ // Node child_process: "spawn bd ENOENT"
328
+ /spawn ([^\s'"]+) ENOENT/,
329
+ ]);
330
+ const MISSING_TOOL_UNNAMED_RULES = Object.freeze([
331
+ /is not recognized as (?:the )?name of a cmdlet/i,
332
+ /is not recognized as an internal or external command/i,
333
+ // The shell's own "not found" exit status, as the fleet transport reports it.
334
+ /\bexit (?:code|status) 127\b/i,
335
+ ]);
336
+
337
+ /** The sync binaries a context-free classification may report as missing. */
338
+ const DEFAULT_MISSING_TOOL_TARGETS = Object.freeze(['bd', 'dolt', 'git']);
339
+
340
+ /** Bare, lower-case binary name: no directory, no Windows executable suffix. */
341
+ function normalizeToolName(name) {
342
+ const base = String(name || '').trim().replace(/^["']|["']$/g, '').split(/[\\/]/).pop() || '';
343
+ return base.replace(/\.(exe|cmd|bat|ps1)$/i, '').toLowerCase();
344
+ }
345
+
346
+ /**
347
+ * Detects a missing-binary failure OF THE STEP'S OWN BINARY. Returns
348
+ * `{ tool }` or null (not a missing-tool failure for this step -- the
349
+ * normal classification rules decide).
350
+ * @param {string} raw
351
+ * @param {{ exitCode?: number|null, tool?: string|null }} [ctx]
352
+ * @returns {{ tool: string }|null}
353
+ */
354
+ function detectMissingTool(raw, ctx = {}) {
355
+ const stepTool = ctx.tool ? normalizeToolName(ctx.tool) : '';
356
+ const targets = stepTool ? [stepTool] : DEFAULT_MISSING_TOOL_TARGETS;
357
+ const named = [];
358
+ for (const rule of MISSING_TOOL_NAMED_RULES) {
359
+ // A fresh global copy per call keeps the module-level rules stateless.
360
+ for (const m of raw.matchAll(new RegExp(rule.source, `${rule.flags}g`))) {
361
+ if (m[1]) named.push(normalizeToolName(m[1]));
362
+ }
363
+ }
364
+ const hit = named.find((n) => targets.includes(n));
365
+ if (hit) return { tool: hit };
366
+ const unnamed = ctx.exitCode === 127 || MISSING_TOOL_UNNAMED_RULES.some((re) => re.test(raw));
367
+ if (stepTool && unnamed && named.length === 0) return { tool: stepTool };
368
+ return null;
369
+ }
370
+
371
+ /**
372
+ * The binary a command string invokes (its first whitespace-separated token,
373
+ * quotes stripped) -- the fallback name for a MISSING_TOOL failure whose
374
+ * wording names no binary (e.g. a bare exit code 127).
375
+ * @param {string} cmd
376
+ * @returns {string}
377
+ */
378
+ export function commandBinary(cmd) {
379
+ const first = String(cmd || '').trim().split(/\s+/)[0] || '';
380
+ return first.replace(/^["']|["']$/g, '') || '(unknown command)';
381
+ }
382
+
271
383
  const KIND_PRECEDENCE = Object.freeze([
272
384
  VCS_FAILURE_KINDS.DIVERGED,
273
385
  VCS_FAILURE_KINDS.AUTH_EXPIRED,
@@ -294,10 +406,11 @@ const KIND_PRECEDENCE = Object.freeze([
294
406
  * self-healed, so a mis-fallback degrades to "surface it", not to a guess.
295
407
  *
296
408
  * @param {string} rawStderr - the raw stderr/stdout of the failed command
297
- * @param {{ provider?: string }} [opts] - provider selects the rule chain;
409
+ * @param {{ provider?: string, exitCode?: number|null, tool?: string|null }} [opts] - provider selects the rule chain; tool is the binary the failing step ran (see detectMissingTool -- MISSING_TOOL is only reported for that binary);
298
410
  * defaults to DEFAULT_VCS_PROVIDER ('github'), which reproduces runner.js's
299
411
  * full auth pattern set exactly.
300
- * @returns {{ kind: string, providerCode: string|null, retryable: boolean, permissionScope: boolean, operatorReferral: string|null, raw: string }}
412
+ * @returns {{ kind: string, providerCode: string|null, retryable: boolean, permissionScope: boolean, operatorReferral: string|null, missingTool: string|null, raw: string }}
413
+ * `missingTool` is the binary name a MISSING_TOOL failure names (null when the wording names none, and for every other kind).
301
414
  * `kind` is the ONLY field control flow may branch on, with ONE declared
302
415
  * exception: `permissionScope` (see below), which is a REFINEMENT of
303
416
  * AUTH_DENIED, not a parallel vocabulary. `providerCode` is the
@@ -317,6 +430,16 @@ export function classifyFailure(rawStderr, opts = {}) {
317
430
  const providerName = (opts && opts.provider) || DEFAULT_VCS_PROVIDER;
318
431
  const chain = resolveVcsProviderChain(providerName);
319
432
 
433
+ // MISSING TOOL first, ahead of permission-scope and provider rules (see
434
+ // MISSING_TOOL_RULES above).
435
+ const missing = detectMissingTool(raw, { exitCode: opts && opts.exitCode, tool: opts && opts.tool });
436
+ if (missing) {
437
+ return {
438
+ kind: VCS_FAILURE_KINDS.MISSING_TOOL, providerCode: null, retryable: false,
439
+ permissionScope: false, operatorReferral: null, missingTool: missing.tool, raw,
440
+ };
441
+ }
442
+
320
443
  // PERMISSION-SCOPE RULES ARE CHECKED FIRST, ahead of KIND_PRECEDENCE.
321
444
  //
322
445
  // A host's permission refusal almost always arrives wrapped in that host's
@@ -380,7 +503,7 @@ export function classifyFailure(rawStderr, opts = {}) {
380
503
  }
381
504
  }
382
505
 
383
- return { kind, providerCode, retryable: VCS_RETRYABLE_KINDS.has(kind), permissionScope, operatorReferral, raw };
506
+ return { kind, providerCode, retryable: VCS_RETRYABLE_KINDS.has(kind), permissionScope, operatorReferral, missingTool: null, raw };
384
507
  }
385
508
 
386
509
  /**
@@ -394,7 +517,7 @@ export function classifyFailure(rawStderr, opts = {}) {
394
517
  * preserving parity, not inventing behavior.
395
518
  *
396
519
  * @param {string} kind - a VCS_FAILURE_KINDS member
397
- * @returns {'diverged'|'auth'|'transient'|'unknown'}
520
+ * @returns {'diverged'|'auth'|'transient'|'missing-tool'|'unknown'}
398
521
  */
399
522
  export function toGitVerdict(kind) {
400
523
  switch (kind) {
@@ -402,6 +525,7 @@ export function toGitVerdict(kind) {
402
525
  case VCS_FAILURE_KINDS.AUTH_EXPIRED:
403
526
  case VCS_FAILURE_KINDS.AUTH_DENIED: return 'auth';
404
527
  case VCS_FAILURE_KINDS.TRANSIENT: return 'transient';
528
+ case VCS_FAILURE_KINDS.MISSING_TOOL: return 'missing-tool';
405
529
  default: return 'unknown';
406
530
  }
407
531
  }
@@ -420,7 +544,7 @@ export function toGitVerdict(kind) {
420
544
  * dolt auth literal, including the publickey-refusal one; see dolt.mjs).
421
545
  *
422
546
  * @param {string} kind - a VCS_FAILURE_KINDS member
423
- * @returns {'no-remote'|'empty-remote'|'remote-unreachable'|'auth'|'diverged'|'transient'|'unknown'}
547
+ * @returns {'no-remote'|'empty-remote'|'remote-unreachable'|'auth'|'diverged'|'transient'|'missing-tool'|'unknown'}
424
548
  */
425
549
  export function toDoltVerdict(kind) {
426
550
  switch (kind) {
@@ -431,6 +555,7 @@ export function toDoltVerdict(kind) {
431
555
  case VCS_FAILURE_KINDS.AUTH_EXPIRED:
432
556
  case VCS_FAILURE_KINDS.AUTH_DENIED: return 'auth';
433
557
  case VCS_FAILURE_KINDS.TRANSIENT: return 'transient';
558
+ case VCS_FAILURE_KINDS.MISSING_TOOL: return 'missing-tool';
434
559
  default: return 'unknown';
435
560
  }
436
561
  }
@@ -572,6 +697,8 @@ export function parseProviderRepoRef(remoteUrl) {
572
697
 
573
698
  export const VCSModule = {
574
699
  buildCreatePrCommand,
700
+ buildFindPrCommand,
701
+ buildUpdatePrCommand,
575
702
  parseProviderRepoRef,
576
703
  buildCommentCommand,
577
704
  classifyFailure,
@@ -686,6 +686,103 @@ const pullRequestResponse = Object.freeze({
686
686
  map: mapPullRequestResponse,
687
687
  });
688
688
 
689
+ /** Map one Azure DevOps pull request object to the provider-neutral
690
+ * { id, title, body, url } shape the existing-PR update path reads. */
691
+ function mapAzureDevOpsPull(pr, coords) {
692
+ const src = (pr && typeof pr === 'object') ? pr : {};
693
+ const { id, url } = mapPullRequestResponse(src, coords);
694
+ return {
695
+ id,
696
+ title: typeof src.title === 'string' ? src.title : '',
697
+ body: typeof src.description === 'string' ? src.description : '',
698
+ url,
699
+ };
700
+ }
701
+
702
+ /**
703
+ * Build the Azure DevOps REST "find the active pull request for source ->
704
+ * target" curl command, used on the already-exists (409 TF401179) path to
705
+ * learn the existing PR's id and current description.
706
+ * GET .../pullrequests?searchCriteria.sourceRefName=..&searchCriteria.targetRefName=..
707
+ * &searchCriteria.status=active&api-version=7.1
708
+ * -- see https://learn.microsoft.com/rest/api/azure/devops/git/pull-requests/get-pull-requests
709
+ * The URL carries '&', so it is quoted like every other argument.
710
+ */
711
+ function buildAzureDevOpsFindPrCommand(params) {
712
+ const { base, head, token, os, shell } = params || {};
713
+ const coords = assertRepoCoords(params, 'find-pull-request');
714
+ const safeToken = assertToken(token);
715
+ if (!base) throw new Error('ERROR: VCSModule: "base" branch is required to build a find-pull-request command.');
716
+ if (!head) throw new Error('ERROR: VCSModule: "head" branch is required to build a find-pull-request command.');
717
+ const query = [
718
+ `searchCriteria.sourceRefName=${encodeURIComponent(toFullRef(head))}`,
719
+ `searchCriteria.targetRefName=${encodeURIComponent(toFullRef(base))}`,
720
+ 'searchCriteria.status=active',
721
+ `api-version=${API_VERSION}`,
722
+ ].join('&');
723
+ const url = `${repoApiBase(coords)}/pullrequests?${query}`;
724
+
725
+ const buildCurl = (authToken) => [
726
+ `${curlBinary(os)} -sS -X GET`,
727
+ `-u ${shQuote(`:${authToken}`, os, shell)}`,
728
+ `-H ${shQuote('Accept: application/json', os, shell)}`,
729
+ `-w ${shQuote('\n%{http_code}', os, shell)}`,
730
+ shQuote(url, os, shell),
731
+ ].join(' ');
732
+
733
+ return {
734
+ provider: 'azure-devops',
735
+ action: 'find-pull-request',
736
+ command: buildCurl(safeToken),
737
+ logSafeCommand: buildCurl(REDACTED),
738
+ interpret: { successStatusRange: [200, 299] },
739
+ /** 2xx body ({ value: [...] }) -> [{ id, title, body, url }]. */
740
+ mapResponse: (respBody) => {
741
+ const list = respBody && Array.isArray(respBody.value) ? respBody.value : [];
742
+ return list.map((pr) => mapAzureDevOpsPull(pr, coords)).filter((p) => p.id !== null);
743
+ },
744
+ };
745
+ }
746
+
747
+ /**
748
+ * Build the Azure DevOps REST "update a pull request" curl command (title +
749
+ * description).
750
+ * PATCH .../pullrequests/{id}?api-version=7.1
751
+ * -- see https://learn.microsoft.com/rest/api/azure/devops/git/pull-requests/update
752
+ */
753
+ function buildAzureDevOpsUpdatePrCommand(params) {
754
+ const { pull_request_id: pullRequestId, title, body, token, os, shell } = params || {};
755
+ const coords = assertRepoCoords(params, 'update-pull-request');
756
+ const safeToken = assertToken(token);
757
+ const id = String(pullRequestId ?? '').trim();
758
+ if (!/^\d+$/.test(id)) throw new Error('ERROR: VCSModule: a numeric "pull_request_id" is required to build an update-pull-request command.');
759
+ if (!title) throw new Error('ERROR: VCSModule: "title" is required to build an update-pull-request command.');
760
+
761
+ const payload = { title };
762
+ if (body !== undefined) payload.description = body;
763
+ const payloadJson = JSON.stringify(payload);
764
+ const url = `${repoApiBase(coords)}/pullrequests/${id}?api-version=${API_VERSION}`;
765
+
766
+ const buildCurl = (authToken) => [
767
+ `${curlBinary(os)} -sS -X PATCH`,
768
+ `-u ${shQuote(`:${authToken}`, os, shell)}`,
769
+ `-H ${shQuote('Content-Type: application/json', os, shell)}`,
770
+ `-H ${shQuote('Accept: application/json', os, shell)}`,
771
+ `-d ${shQuoteJson(payloadJson, os, shell)}`,
772
+ `-w ${shQuote('\n%{http_code}', os, shell)}`,
773
+ url,
774
+ ].join(' ');
775
+
776
+ return {
777
+ provider: 'azure-devops',
778
+ action: 'update-pull-request',
779
+ command: buildCurl(safeToken),
780
+ logSafeCommand: buildCurl(REDACTED),
781
+ interpret: { successStatusRange: [200, 299] },
782
+ mapResponse: (respBody) => mapAzureDevOpsPull(respBody, coords),
783
+ };
784
+ }
785
+
689
786
  // ---------------------------------------------------------------------------
690
787
  // Auth self-heal remedy (apra-fleet-5co8.4.2)
691
788
  // ---------------------------------------------------------------------------
@@ -757,6 +854,8 @@ export const AzureDevOpsVCS = Object.freeze({
757
854
  builders: Object.freeze({
758
855
  'create-pull-request': buildAzureDevOpsCreatePrCommand,
759
856
  comment: buildAzureDevOpsCommentCommand,
857
+ 'find-pull-request': buildAzureDevOpsFindPrCommand,
858
+ 'update-pull-request': buildAzureDevOpsUpdatePrCommand,
760
859
  }),
761
860
  });
762
861