@apralabs/apra-fleet 0.4.3 → 0.4.5

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 (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -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';
@@ -107,6 +107,18 @@ async function listCredentialStoreNames(fleetApi) {
107
107
  }
108
108
  }
109
109
 
110
+ /**
111
+ * A remote URL safe to quote in a log line: the userinfo of a scheme'd URL
112
+ * (`https://user:TOKEN@host/...` -- git prints an embedded credential
113
+ * verbatim) becomes `***`. scp-like `git@host:path` is left as is: `git` is
114
+ * the login name, not a secret.
115
+ * @param {string} url
116
+ * @returns {string}
117
+ */
118
+ export function redactUrlUserinfo(url) {
119
+ return String(url ?? '').replace(/([a-z][a-z0-9+.-]*:\/\/)[^/@\s]*@/gi, (_m, scheme) => scheme + '***@');
120
+ }
121
+
110
122
  /**
111
123
  * Build the provision_vcs_auth arguments for a member, dispatched through the
112
124
  * resolved provider's OPTIONAL buildProvisionArgs hook (apra-fleet-5co8.2.1).
@@ -125,10 +137,22 @@ async function listCredentialStoreNames(fleetApi) {
125
137
  * advisory the operator should see (e.g. an ssh remote the PAT cannot
126
138
  * serve) that is NOT a failure.
127
139
  *
140
+ * apra-fleet-qeq1.9: a hook may also answer `{ skip: true }` -- "this
141
+ * provider has nothing to provision for THIS request, proceed on the
142
+ * credential already deployed". That is a third answer, distinct from both
143
+ * `args` (dispatch these) and `error` (fail): a provider whose credential is
144
+ * deployed out of band and carries no scope axis has no meaningful
145
+ * just-in-time re-provision to run, and forcing a doomed one would abort the
146
+ * very call it is supposed to enable. Reported to the caller as a `null`
147
+ * return -- no provider ever legitimately produces null `args`, and the
148
+ * no-hook path above returns `base`, so null is unambiguous. The skip is
149
+ * never silent: a hook taking it should also return a `note`, logged below
150
+ * exactly like any other advisory.
151
+ *
128
152
  * @param {{ provider: string, base: object, repoRef: object|null, fleetApi: object,
129
153
  * secretName?: string, remoteUrl?: string, remoteReadError?: string|null,
130
154
  * log?: Function, logPrefix?: string }} ctx
131
- * @returns {Promise<object>} the arguments to send
155
+ * @returns {Promise<object|null>} the arguments to send, or null to skip provisioning entirely
132
156
  */
133
157
  async function buildProvisionArgsForProvider({ provider, base, repoRef, fleetApi, secretName, remoteUrl, remoteReadError, log = () => {}, logPrefix = '' }) {
134
158
  const impl = getVcsProvider(provider);
@@ -137,13 +161,14 @@ async function buildProvisionArgsForProvider({ provider, base, repoRef, fleetApi
137
161
  const availableSecrets = await listCredentialStoreNames(fleetApi);
138
162
  const built = impl.buildProvisionArgs({ base, repoRef, availableSecrets, secretName, remoteUrl, remoteReadError });
139
163
  if (built && typeof built.error === 'string') throw new Error(built.error);
140
- if (!built || !built.args || typeof built.args !== 'object') {
164
+ const skipped = !!(built && built.skip === true);
165
+ if (!built || (!skipped && (!built.args || typeof built.args !== 'object'))) {
141
166
  throw new Error(`ERROR: VCS provider '${provider}' returned no provision arguments for member '${base.member_name}'.`);
142
167
  }
143
168
  if (typeof built.note === 'string' && built.note.trim()) {
144
169
  log(`${logPrefix}: note: ${built.note.trim()}`);
145
170
  }
146
- return built.args;
171
+ return skipped ? null : built.args;
147
172
  }
148
173
 
149
174
  // apra-fleet-3swo.13: provision_vcs_auth / provision_llm_auth used to be
@@ -257,7 +282,7 @@ function detectVcsProviderFromRemote(remoteUrl) {
257
282
  return (impl && impl.name) || null;
258
283
  }
259
284
 
260
- async function provisionVcsAuthForMember({ fleetApi, command, member, log = () => {}, logPrefix, gitAccess = DEFAULT_SYNC_GIT_ACCESS, azdevopsPatSecretName, remoteUrlOverride, resolvedProvider }) {
285
+ async function provisionVcsAuthForMember({ fleetApi, command, member, log = () => {}, logPrefix, gitAccess = DEFAULT_SYNC_GIT_ACCESS, azdevopsPatSecretName, remoteUrlOverride, resolvedProvider, refuseLocalNonReMintable = false }) {
261
286
  let repos;
262
287
  let derivedRepo = null;
263
288
  let derivedRef = null;
@@ -273,7 +298,7 @@ async function provisionVcsAuthForMember({ fleetApi, command, member, log = () =
273
298
  // origin remote via a real git-capable member (e.g. Publish PR's
274
299
  // publishGitMember) passes it here instead of making THIS function shell
275
300
  // 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
301
+ // when `member` is backlogMember and may be a git-less/shared member
277
302
  // with no checkout to read a remote from at all. Skips the read entirely,
278
303
  // never the parse below.
279
304
  if (remoteUrlOverride) {
@@ -311,7 +336,7 @@ async function provisionVcsAuthForMember({ fleetApi, command, member, log = () =
311
336
  // member/repo than `member` -- see the caller-note above -- so
312
337
  // this log deliberately does not claim the URL is `member`'s own.
313
338
  const remoteSource = remoteUrlOverride ? 'the supplied remote URL' : `member '${member}' git remote`;
314
- log(`${logPrefix}: could not derive an owner/repo from ${remoteSource} (raw: '${remoteUrl}'); calling provision_vcs_auth without an explicit repos scope.`);
339
+ log(`${logPrefix}: could not derive an owner/repo from ${remoteSource} (raw: '${redactUrlUserinfo(remoteUrl)}'); calling provision_vcs_auth without an explicit repos scope.`);
315
340
  }
316
341
  }
317
342
 
@@ -357,8 +382,26 @@ async function provisionVcsAuthForMember({ fleetApi, command, member, log = () =
357
382
  // that stable code rather than by its message text.
358
383
  let provider;
359
384
  let authMode;
385
+ // PR-raising (push+pr) calls act on the TARGET repo, so the provider whose
386
+ // host serves that remote wins over the member's registered one: a
387
+ // GitHub-registered backlog member publishing a bitbucket.org sprint must
388
+ // use Bitbucket's provider (and its own credential label), never mint a
389
+ // GitHub credential for a Bitbucket repo. Only an anchored auth-provider
390
+ // host match counts (detectVcsProviderFromRemote); anything else keeps
391
+ // the registry answer.
392
+ const hostProvider = (gitAccess === 'push+pr' && !resolvedProvider && !remoteReadFailed && remoteUrl)
393
+ ? detectVcsProviderFromRemote(remoteUrl)
394
+ : null;
395
+ let registeredMismatch = null;
360
396
  try {
361
397
  ({ provider, authMode } = resolvedProvider || await resolveProvider(member, { fleetApi }));
398
+ if (hostProvider && hostProvider !== provider) {
399
+ registeredMismatch = provider;
400
+ provider = hostProvider;
401
+ const impl = getVcsProvider(provider);
402
+ authMode = isAuthBackend(impl) ? impl.defaultAuthMode : null;
403
+ log(`${logPrefix}: member '${member}' is registered for VCS provider '${registeredMismatch}', but the target remote is served by '${provider}'; using '${provider}' for this pull-request call.`);
404
+ }
362
405
  } catch (resolveErr) {
363
406
  if (!resolveErr || resolveErr.code !== VCS_NO_REGISTERED_PROVIDER) throw resolveErr;
364
407
  const detected = (!remoteReadFailed && remoteUrl)
@@ -371,6 +414,12 @@ async function provisionVcsAuthForMember({ fleetApi, command, member, log = () =
371
414
  const remoteSource = remoteUrlOverride ? 'the supplied remote URL' : 'its git remote';
372
415
  log(`${logPrefix}: member '${member}' had no registered VCS provider; detected '${provider}' from ${remoteSource} and will provision it now`);
373
416
  }
417
+ // A caller that could not run its own local-member check (e.g. the
418
+ // self-heal whose provider lookup failed) asks for it here, now that the
419
+ // provider is known. Fails CLOSED -- see assertNotLocalNonReMintable.
420
+ if (refuseLocalNonReMintable) {
421
+ await assertNotLocalNonReMintable({ fleetApi, member, provider });
422
+ }
374
423
  // apra-fleet-5co8.2.1: the argument shape itself is now provider-owned.
375
424
  // What follows is the DEFAULT (GitHub-App) shape; a provider that declares
376
425
  // a buildProvisionArgs hook replaces it wholesale -- see
@@ -392,7 +441,34 @@ async function provisionVcsAuthForMember({ fleetApi, command, member, log = () =
392
441
  log,
393
442
  logPrefix,
394
443
  });
395
- const provisionRes = await fleetApi.provisionVcsAuth(provisionArgs);
444
+ // apra-fleet-qeq1.9: the hook answered "nothing to provision for this
445
+ // request" (see buildProvisionArgsForProvider's own doc for the null
446
+ // contract). Dispatch nothing, claim no new expiry -- the credential in
447
+ // place is whatever it already was -- and still hand back the derived
448
+ // repo, which is the other half of this function's return contract and is
449
+ // what the PR-raising call sites need to build their command.
450
+ //
451
+ // `provider` + `provisionSkipped` are returned too: with no
452
+ // provision_vcs_auth call, a member that had no registered vcsProvider
453
+ // (detected from its remote above) is never persisted, so a caller's
454
+ // later resolveProvider() would throw VCS_NO_REGISTERED_PROVIDER. And a
455
+ // skipped provision means the credential exists only if an operator
456
+ // deployed it, so its absence is an operator fix, not an internal fault.
457
+ if (provisionArgs === null) {
458
+ log(`${logPrefix}: provider '${provider}' has nothing to re-provision for member '${member}'; continuing on its already-deployed credential without calling provision_vcs_auth.`);
459
+ return { expiresAt: null, repo: derivedRepo, provider, provisionSkipped: true };
460
+ }
461
+ // A member holds one VCS credential: provisioning the host's provider
462
+ // here would revoke the credential of the provider it is registered for
463
+ // (provision_vcs_auth swaps labels) and break that provider's sprints.
464
+ // Refuse with a typed error instead; the PR callers degrade on it.
465
+ if (registeredMismatch) {
466
+ throw new Error(`member '${member}' is registered for VCS provider '${registeredMismatch}', which does not serve this '${provider}' remote; not provisioning '${provider}' on it, because that would revoke the member's '${registeredMismatch}' credential. Use a backlog member dedicated to '${provider}' for this repository.`);
467
+ }
468
+ // apra-fleet-d1pk.3: fleet-sprint runs unattended, so it never lets
469
+ // provision_vcs_auth fall into its out-of-band secret prompt -- a missing
470
+ // secret comes back as reason credential_missing instead.
471
+ const provisionRes = await fleetApi.provisionVcsAuth({ ...provisionArgs, non_interactive: true });
396
472
  const provisionText = resultText(provisionRes);
397
473
  // provision_vcs_auth NEVER throws on failure -- it reports failure via
398
474
  // structuredContent.ok === false (apra-fleet-3swo.13; see
@@ -451,7 +527,7 @@ async function provisionVcsAuthForMember({ fleetApi, command, member, log = () =
451
527
  * @param {{ fleetApi: object, command: Function, member: string, log?: Function, logPrefix: string }} opts
452
528
  * @returns {Promise<{ expiresAt: Date|null, repo: string|null }>}
453
529
  */
454
- async function provisionPrCapableAuthForMember({ fleetApi, command, member, log = () => {}, logPrefix, remoteUrlOverride }) {
530
+ export async function provisionPrCapableAuthForMember({ fleetApi, command, member, log = () => {}, logPrefix, remoteUrlOverride }) {
455
531
  return provisionVcsAuthForMember({ fleetApi, command, member, log, logPrefix, gitAccess: 'push+pr', remoteUrlOverride });
456
532
  }
457
533
 
@@ -591,12 +667,33 @@ export function buildCredentialReadCommand(target, label) {
591
667
  // Splits a VCSModule create-pull-request curl result's captured stdout into
592
668
  // its HTTP status code and JSON body. VCSModule's buildCreatePrCommand always
593
669
  // appends `-w '\n%{http_code}'`, so curl's own stdout is "<json body>\n<status>".
670
+ // A builder may also pass curl `-D -` (bitbucket.mjs does), which puts the
671
+ // RESPONSE header block(s) first: "HTTP/x NNN\r\nName: v\r\n\r\n<body>\n<status>".
672
+ // Each leading block is consumed into `headers` (lowercased names; a later
673
+ // block -- after a 100 Continue -- replaces an earlier one), and the rest
674
+ // parses exactly as before, so output without headers is unaffected.
675
+ // Cookie-bearing and auth headers are dropped, never returned: callers quote
676
+ // header values into log lines.
594
677
  /**
595
678
  * @param {string} output
596
- * @returns {{ status: number|null, body: unknown }}
679
+ * @returns {{ status: number|null, body: unknown, bodyText: string, headers: Record<string, string> }}
597
680
  */
598
681
  function parseVcsCurlOutput(output) {
599
- const text = String(output || '');
682
+ let text = String(output || '');
683
+ const headers = {};
684
+ while (/^HTTP\/\d(?:\.\d)? \d{3}/.test(text)) {
685
+ const end = /\r?\n\r?\n/.exec(text);
686
+ const block = end ? text.slice(0, end.index) : text;
687
+ text = end ? text.slice(end.index + end[0].length) : '';
688
+ for (const k of Object.keys(headers)) delete headers[k];
689
+ for (const line of block.split(/\r?\n/).slice(1)) {
690
+ const colon = line.indexOf(':');
691
+ if (colon <= 0) continue;
692
+ const name = line.slice(0, colon).trim().toLowerCase();
693
+ if (/^(?:set-cookie|cookie|authorization|proxy-authorization|www-authenticate|proxy-authenticate)$/.test(name)) continue;
694
+ headers[name] = line.slice(colon + 1).trim();
695
+ }
696
+ }
600
697
  const lines = text.split('\n');
601
698
  const statusLine = lines.length ? lines[lines.length - 1].trim() : '';
602
699
  const status = /^\d+$/.test(statusLine) ? parseInt(statusLine, 10) : null;
@@ -609,7 +706,7 @@ function parseVcsCurlOutput(output) {
609
706
  body = null;
610
707
  }
611
708
  }
612
- return { status, body, bodyText };
709
+ return { status, body, bodyText, headers };
613
710
  }
614
711
 
615
712
  const PR_AUTH_404_TEXT_RE = /not accessible by (this )?(integration|token|personal access token)|requires (authentication|additional scopes?)|insufficient (scope|permission)/i;
@@ -658,14 +755,32 @@ function isPrAuthFailure(status, errorText) {
658
755
  // server-side. If the retry still fails, the failure (auth or not) is
659
756
  // returned as-is; the raw token is never logged (and is never even held
660
757
  // here), only `built.logSafeCommand`.
758
+ //
759
+ // EXISTING-PR UPDATE (optional `updateExisting`). A sprint relaunched on a
760
+ // branch that already has a PR must not leave the old run's verdict in the
761
+ // title/body. When the caller passes `updateExisting(old) -> { title, body }`
762
+ // and creation reports already-exists, this finds the open PR for
763
+ // head -> base (provider 'find-pull-request' builder -- the create response
764
+ // carries neither the PR id nor its current body), hands the old title/body
765
+ // to `updateExisting`, and PATCHes the result ('update-pull-request'
766
+ // builder), with the same placeholder handoff, body cap and one-shot auth
767
+ // self-heal as creation. It never throws: any failure (including a provider
768
+ // with no such builder) comes back as `updated: false` + `updateError` for
769
+ // the caller to log as a WARNING, leaving the PR as it was. Without
770
+ // `updateExisting` the returned shape is exactly the historical one.
661
771
  /**
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 }>}
772
+ * @param {{ fleetApi: object, command: Function, member: string, base: string, head: string, title: string, body?: string, log?: Function, logPrefix: string, updateExisting?: Function }} opts
773
+ * @returns {Promise<{ ok: boolean, alreadyExists: boolean, prUrl: string|null, error: string|null, authFailure: boolean, updated?: boolean, updateError?: string|null }>}
664
774
  */
665
- export async function raiseVcsPrForMember({ fleetApi, command, member, base, head, title, body, log = () => {}, logPrefix, remoteUrlOverride }) {
775
+ export async function raiseVcsPrForMember({ fleetApi, command, member, base, head, title, body, log = () => {}, logPrefix, remoteUrlOverride, updateExisting }) {
666
776
  let repo;
777
+ // Set when the provider's buildProvisionArgs hook answered `skip` (its
778
+ // credential is deployed out of band only -- see provisionVcsAuthForMember).
779
+ let skippedProvider = null;
667
780
  try {
668
- ({ repo } = await provisionPrCapableAuthForMember({ fleetApi, command, member, log, logPrefix, remoteUrlOverride }));
781
+ const provisioned = await provisionPrCapableAuthForMember({ fleetApi, command, member, log, logPrefix, remoteUrlOverride });
782
+ repo = provisioned.repo;
783
+ if (provisioned.provisionSkipped && provisioned.provider) skippedProvider = provisioned.provider;
669
784
  } catch (provisionErr) {
670
785
  // apra-fleet-5co8.15: provisionPrCapableAuthForMember has no failSoft
671
786
  // of its own (by design -- see its doc comment above), so a
@@ -680,8 +795,21 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
680
795
  // and keep going rather than aborting on this condition.
681
796
  let remedyHint = null;
682
797
  try {
683
- const { provider } = await resolveProvider(member, { fleetApi });
684
- const impl = getVcsProvider(provider);
798
+ // The TARGET remote's provider wins over the member's registered
799
+ // one (same rule provisionVcsAuthForMember applies at push+pr): a
800
+ // GitHub-registered member publishing to bitbucket.org must be
801
+ // told the Bitbucket remedy, not the registered provider's.
802
+ let remedyProvider = null;
803
+ try {
804
+ let remote = remoteUrlOverride ? String(remoteUrlOverride).trim() : '';
805
+ if (!remote) {
806
+ const r = await command('git remote get-url origin', { member_name: member, silent: true, failSoft: true });
807
+ remote = r && r.ok ? String(r.output || '').trim() : '';
808
+ }
809
+ if (remote) remedyProvider = detectVcsProviderFromRemote(remote);
810
+ } catch { /* fall back to the registered provider below */ }
811
+ if (!remedyProvider) ({ provider: remedyProvider } = await resolveProvider(member, { fleetApi }));
812
+ const impl = getVcsProvider(remedyProvider);
685
813
  if (impl && impl.authRemedy && impl.authRemedy.hint) remedyHint = impl.authRemedy.hint;
686
814
  } catch (resolveErr) {
687
815
  log(`${logPrefix}: could not resolve member '${member}'s VCS provider to look up an auth remedy hint (falling back to the raw provisioning error): ${resolveErr.message}`);
@@ -721,8 +849,49 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
721
849
  // stale GitHub token left over from an earlier provider and send it to
722
850
  // dev.azure.com). `credentialLabel` is threaded into every
723
851
  // vcsCredentialExec() call below for exactly that reason.
724
- const { provider } = await resolveProvider(member, { fleetApi });
852
+ //
853
+ // A skipped provision never persisted a vcsProvider, so a member that had
854
+ // none registered (provider detected from its remote) would make
855
+ // resolveProvider() throw here -- use the provider the skip named instead.
856
+ const { provider } = skippedProvider ? { provider: skippedProvider } : await resolveProvider(member, { fleetApi });
725
857
  const credentialLabel = vcsCredentialLabelForProvider(provider);
858
+ // The provider's operator-facing remedy, appended to every degraded
859
+ // (authFailure) outcome below when the credential is out-of-band only.
860
+ const skippedRemedy = () => {
861
+ const impl = getVcsProvider(provider);
862
+ return impl && impl.authRemedy && impl.authRemedy.hint ? ` -- ${impl.authRemedy.hint}` : '';
863
+ };
864
+ // Provider-owned explanation of an HTTP failure (e.g. Bitbucket 410/403),
865
+ // appended to failure messages. The hook gets the whole parsed response
866
+ // ({ status, body, headers }) plus what this caller knows (credential
867
+ // store names, member, repo coordinates), so it can name the credential
868
+ // type and scopes the server reported instead of guessing from the
869
+ // status. It answers a string (legacy: diagnosis only) or
870
+ // { hint, remedy }; a non-empty `remedy` REPLACES the provider's generic
871
+ // authRemedy.hint for this failure (see vcs-providers/index.mjs).
872
+ // Returns { hint: ' -- ...'|'', remedy: ' -- ...'|null }.
873
+ let storeNames;
874
+ const statusHint = async (parsed) => {
875
+ const impl = getVcsProvider(provider);
876
+ if (!impl || typeof impl.httpFailureHint !== 'function') return { hint: '', remedy: null };
877
+ const { status } = parsed;
878
+ if (storeNames === undefined && typeof status === 'number' && status >= 400 && status < 500) {
879
+ storeNames = await listCredentialStoreNames(fleetApi);
880
+ }
881
+ const out = impl.httpFailureHint({
882
+ status,
883
+ body: parsed.body,
884
+ headers: parsed.headers || {},
885
+ availableSecrets: storeNames === undefined ? null : storeNames,
886
+ memberName: member,
887
+ repoRef,
888
+ repo,
889
+ });
890
+ if (typeof out === 'string') return { hint: out ? ` -- ${out}` : '', remedy: null };
891
+ const hint = out && typeof out.hint === 'string' && out.hint ? ` -- ${out.hint}` : '';
892
+ const remedy = out && typeof out.remedy === 'string' && out.remedy ? ` -- ${out.remedy}` : null;
893
+ return { hint, remedy };
894
+ };
726
895
 
727
896
  // apra-fleet-3swo.7.6: the orchestrator never learns the token at all now.
728
897
  // It passes the INLINE placeholder as the `token` parameter, so each
@@ -738,6 +907,8 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
738
907
  // top-level declarations symbol-for-symbol and a new const desyncs that
739
908
  // census.
740
909
  const token = '{{vcs_token_inline}}';
910
+ // Bitbucket REST authenticates with a Bearer token (the same inline
911
+ // token placeholder as above); no username is sent for any provider.
741
912
  // Both os AND shell feed the command builder: os picks the curl binary
742
913
  // token (curl.exe vs curl), shell picks the quoting dialect. A Windows
743
914
  // member whose registered shell is gitbash needs POSIX quoting, not
@@ -765,6 +936,110 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
765
936
  }
766
937
  const repoRef = providerRef ? providerRef.ref : null;
767
938
 
939
+ // One REST round trip for the existing-PR update path (see the header
940
+ // note): placeholder handoff, 2xx check, one-shot auth self-heal. Returns
941
+ // { ok, built, body } or { ok: false, error } -- never throws on an HTTP
942
+ // or handoff failure.
943
+ const runUpdatePathCall = async (buildFn, what) => {
944
+ let healed = false;
945
+ // eslint-disable-next-line no-constant-condition
946
+ while (true) {
947
+ const b = buildFn();
948
+ const res = await fleetApi.vcsCredentialExec({ member_name: member, label: credentialLabel, command: b.command });
949
+ const h = (res && res.structuredContent) || {};
950
+ if (!h.ok || (typeof h.exitCode === 'number' && h.exitCode !== 0)) {
951
+ return { ok: false, error: `${what} dispatch failed (${h.reason || 'nonzero exit'}): ${h.stderr || resultText(res) || '(no detail)'}` };
952
+ }
953
+ const parsed = parseVcsCurlOutput(h.stdout);
954
+ const [lo, hi] = b.interpret.successStatusRange;
955
+ if (parsed.status !== null && parsed.status >= lo && parsed.status <= hi) return { ok: true, built: b, body: parsed.body };
956
+ // Bitbucket nests its error text at error.message.
957
+ const msg = (parsed.body && typeof parsed.body.message === 'string') ? parsed.body.message
958
+ : (parsed.body && parsed.body.error && typeof parsed.body.error.message === 'string') ? parsed.body.error.message
959
+ : (parsed.bodyText || '');
960
+ if (isPrAuthFailure(parsed.status, msg) && !healed && !skippedProvider) {
961
+ healed = true;
962
+ 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}`);
963
+ try {
964
+ const reprov = await provisionPrCapableAuthForMember({ fleetApi, command, member, log, logPrefix, remoteUrlOverride });
965
+ if (reprov.repo) repo = reprov.repo;
966
+ } catch (healErr) {
967
+ return { ok: false, error: `${what} auth self-heal failed: ${healErr.message}` };
968
+ }
969
+ continue;
970
+ }
971
+ const why = await statusHint(parsed);
972
+ return { ok: false, error: `${what} failed: HTTP ${parsed.status ?? '(unknown)'}: ${msg}${why.hint}${skippedProvider && isPrAuthFailure(parsed.status, msg) ? (why.remedy ?? skippedRemedy()) : ''}` };
973
+ }
974
+ };
975
+ const coords = () => ({ provider, ...(repoRef ? { repoRef } : { repo }), token, os, shell });
976
+ // Open PRs for head -> base: { ok: true, prs } or { ok: false, error }.
977
+ // Never throws (a missing builder comes back as { ok: false }).
978
+ const findOpenPrs = async () => {
979
+ try {
980
+ const found = await runUpdatePathCall(() => buildFindPrCommand({ ...coords(), base, head }), 'find-pull-request');
981
+ if (!found.ok) return found;
982
+ return { ok: true, prs: found.built.mapResponse(found.body) };
983
+ } catch (err) {
984
+ return { ok: false, error: (err && err.message) ? err.message : String(err) };
985
+ }
986
+ };
987
+ // `knownPr` skips the lookup when the caller already found the PR.
988
+ const updateExistingPr = async (knownPr = null) => {
989
+ try {
990
+ let pr = knownPr;
991
+ if (!pr) {
992
+ const found = await findOpenPrs();
993
+ if (!found.ok) return { updated: false, updateError: found.error, prUrl: null };
994
+ if (!found.prs.length) {
995
+ return { updated: false, updateError: `no open pull request found for '${head}' -> '${base}'`, prUrl: null };
996
+ }
997
+ pr = found.prs[0];
998
+ }
999
+ const next = updateExisting({ title: pr.title, body: pr.body }) || {};
1000
+ let warned = false;
1001
+ const upd = await runUpdatePathCall(() => {
1002
+ const b = buildUpdatePrCommand({
1003
+ ...coords(),
1004
+ pull_request_id: pr.id,
1005
+ title: next.title || title,
1006
+ body: next.body !== undefined ? next.body : body,
1007
+ });
1008
+ if (b.descriptionTruncated && !warned) {
1009
+ warned = true;
1010
+ log(`${logPrefix}: WARNING: updated PR description for member '${member}' was ${b.descriptionTruncated.originalLength} chars, exceeding the ${b.descriptionTruncated.maxLength}-char limit; truncated.`);
1011
+ }
1012
+ return b;
1013
+ }, 'update-pull-request');
1014
+ if (!upd.ok) return { updated: false, updateError: upd.error, prUrl: pr.url };
1015
+ return { updated: true, updateError: null, prUrl: pr.url };
1016
+ } catch (err) {
1017
+ return { updated: false, updateError: (err && err.message) ? err.message : String(err), prUrl: null };
1018
+ }
1019
+ };
1020
+
1021
+ // Providers whose create is not an upsert (and whose duplicate-PR
1022
+ // response is unverified) declare `findBeforeCreate`: look up the open PR
1023
+ // for head -> base FIRST and update it in place (preserving the run
1024
+ // history block) instead of POSTing a second PR. A failed lookup falls
1025
+ // through to the normal create path.
1026
+ if (typeof updateExisting === 'function') {
1027
+ const preImpl = getVcsProvider(provider);
1028
+ if (preImpl && preImpl.findBeforeCreate === true) {
1029
+ const pre = await findOpenPrs();
1030
+ if (pre.ok && pre.prs.length) {
1031
+ const pr = pre.prs[0];
1032
+ const upd = await updateExistingPr(pr);
1033
+ const updUrl = upd.prUrl || pr.url;
1034
+ if (updUrl) log(`${logPrefix}: updated PR URL for member '${member}': ${updUrl}`);
1035
+ return { ok: true, alreadyExists: true, prUrl: updUrl, error: null, authFailure: false, updated: upd.updated, updateError: upd.updateError };
1036
+ }
1037
+ if (!pre.ok) {
1038
+ log(`${logPrefix}: could not check for an existing open PR before creating (${pre.error}); creating a new one.`);
1039
+ }
1040
+ }
1041
+ }
1042
+
768
1043
  let authHealAttempted = false;
769
1044
  // apra-fleet PR-body length fix: buildCreatePrCommand deterministically
770
1045
  // truncates `body` to PR_DESCRIPTION_MAX_LENGTH and reports it back via
@@ -813,6 +1088,30 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
813
1088
  // failure, so it degrades the same way a failed command() dispatch
814
1089
  // did: returned, not thrown.
815
1090
  if (!handoff.ok && handoff.reason !== 'dispatch_failed') {
1091
+ // Out-of-band-only credential (provision skipped) that is absent:
1092
+ // the operator has not deployed it yet. Degrade to a skipped PR
1093
+ // naming the fix instead of failing the sprint. A just-in-time
1094
+ // minted credential that cannot be read is still a hard failure.
1095
+ // credential_read_failed WITHOUT an exitCode means the read itself
1096
+ // threw (dispatch/connection error): the credential may well be
1097
+ // deployed, so report the read failure and never take the
1098
+ // credentialAbsent path that closes targets without a PR.
1099
+ const transientRead = handoff.reason === 'credential_read_failed' && typeof handoff.exitCode !== 'number';
1100
+ if (skippedProvider && transientRead) {
1101
+ const message = `Could not read the '${credentialLabel}' VCS credential on member '${member}' `
1102
+ + `(transient read failure, vcs_credential_exec reason: ${handoff.reason}): ${handoffText || '(no detail)'}`;
1103
+ log(`${logPrefix}: ${message}`);
1104
+ return { ok: false, alreadyExists: false, prUrl: null, error: message, authFailure: false, credentialReadFailed: true };
1105
+ }
1106
+ if (skippedProvider && ['credential_read_failed', 'credential_empty', 'username_empty'].includes(handoff.reason)) {
1107
+ const message = `No usable '${credentialLabel}' VCS credential is deployed on member '${member}' `
1108
+ + `(vcs_credential_exec reason: ${handoff.reason})${skippedRemedy()}`;
1109
+ log(`${logPrefix}: ${message}`);
1110
+ // credentialAbsent: no PR was possible at all (nothing is
1111
+ // deployed), as opposed to a deployed credential that failed.
1112
+ // Publish PR keeps the pre-PR-support behaviour for it.
1113
+ return { ok: false, alreadyExists: false, prUrl: null, error: message, authFailure: true, credentialAbsent: true };
1114
+ }
816
1115
  throw new Error(
817
1116
  `Failed to read VCS credential token for member '${member}' from the `
818
1117
  + `'${credentialLabel}'-labelled credential helper via vcs_credential_exec `
@@ -824,7 +1123,8 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
824
1123
  return { ok: false, alreadyExists: false, prUrl: null, error: failText, authFailure: false };
825
1124
  }
826
1125
 
827
- const { status, body: respBody, bodyText } = parseVcsCurlOutput(handoff.stdout);
1126
+ const parsedResponse = parseVcsCurlOutput(handoff.stdout);
1127
+ const { status, body: respBody, bodyText } = parsedResponse;
828
1128
  const [lo, hi] = built.interpret.successStatusRange;
829
1129
  if (status !== null && status >= lo && status <= hi) {
830
1130
  // apra-fleet-lzfv.5: read the created PR's id/url through the
@@ -839,11 +1139,13 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
839
1139
  const mapped = (impl && impl.pullRequestResponse && typeof impl.pullRequestResponse.map === 'function')
840
1140
  ? impl.pullRequestResponse.map(respBody, repoRef ? { repoRef } : { repo })
841
1141
  : { id: null, url: null };
1142
+ if (mapped.url) log(`${logPrefix}: opened PR URL for member '${member}': ${mapped.url}`);
842
1143
  return { ok: true, alreadyExists: false, prUrl: mapped.url, error: null, authFailure: false };
843
1144
  }
844
1145
 
845
1146
  const errorMessages = [];
846
1147
  if (respBody && typeof respBody.message === 'string') errorMessages.push(respBody.message);
1148
+ if (respBody && respBody.error && typeof respBody.error.message === 'string') errorMessages.push(respBody.error.message);
847
1149
  if (respBody && Array.isArray(respBody.errors)) {
848
1150
  for (const e of respBody.errors) {
849
1151
  if (e && typeof e.message === 'string') errorMessages.push(e.message);
@@ -851,18 +1153,56 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
851
1153
  }
852
1154
  const errorText = errorMessages.join('; ') || bodyText || `HTTP ${status ?? '(unknown)'}`;
853
1155
 
854
- if (status === built.interpret.alreadyExistsStatus && new RegExp(built.interpret.alreadyExistsPattern, 'i').test(errorText)) {
1156
+ if (built.interpret.alreadyExistsStatus != null && built.interpret.alreadyExistsPattern && status === built.interpret.alreadyExistsStatus && new RegExp(built.interpret.alreadyExistsPattern, 'i').test(errorText)) {
855
1157
  const urlMatch = /https?:\/\/\S+/.exec(errorText);
856
1158
  const existingUrl = urlMatch ? urlMatch[0].replace(/[.,)]+$/, '') : null;
857
- return { ok: true, alreadyExists: true, prUrl: existingUrl, error: null, authFailure: false };
1159
+ const existing = { ok: true, alreadyExists: true, prUrl: existingUrl, error: null, authFailure: false };
1160
+ if (typeof updateExisting !== 'function') return existing;
1161
+ const upd = await updateExistingPr();
1162
+ return { ...existing, prUrl: upd.prUrl || existingUrl, updated: upd.updated, updateError: upd.updateError };
1163
+ }
1164
+
1165
+ const authFailed = isPrAuthFailure(status, errorText);
1166
+ if (authFailed && skippedProvider) {
1167
+ // Nothing to re-provision (the provider skipped it), so a retry
1168
+ // would resend the same credential: report it with the remedy.
1169
+ const why = await statusHint(parsedResponse);
1170
+ return { ok: false, alreadyExists: false, prUrl: null, error: `HTTP ${status ?? '(unknown)'}: ${errorText}${why.hint}${why.remedy ?? skippedRemedy()}`, authFailure: true };
858
1171
  }
859
1172
 
860
- if (isPrAuthFailure(status, errorText) && !authHealAttempted) {
1173
+ // A provider whose duplicate-PR response is unverified declares
1174
+ // `probeExistingOnFailure` instead of an alreadyExists dialect: on any
1175
+ // other non-2xx create failure, look for an open PR for head -> base,
1176
+ // and treat a hit as already-exists (then update it like above).
1177
+ if (!authFailed && built.interpret.probeExistingOnFailure) {
1178
+ const found = await findOpenPrs();
1179
+ if (found.ok && found.prs.length) {
1180
+ const pr = found.prs[0];
1181
+ log(`${logPrefix}: PR creation for '${head}' -> '${base}' failed (HTTP ${status ?? '(unknown)'}: ${errorText}) but an open PR already exists for it${pr.url ? `: ${pr.url}` : ''} -- treating as already-exists.`);
1182
+ const existing = { ok: true, alreadyExists: true, prUrl: pr.url, error: null, authFailure: false };
1183
+ if (typeof updateExisting !== 'function') return existing;
1184
+ const upd = await updateExistingPr(pr);
1185
+ return { ...existing, prUrl: upd.prUrl || pr.url, updated: upd.updated, updateError: upd.updateError };
1186
+ }
1187
+ if (!found.ok) {
1188
+ log(`${logPrefix}: could not check for an existing open PR after the create failure (${found.error}); reporting the create failure.`);
1189
+ }
1190
+ }
1191
+
1192
+ if (authFailed && !authHealAttempted) {
861
1193
  authHealAttempted = true;
862
1194
  log(`${logPrefix}: PR creation returned an auth-classified failure (HTTP ${status ?? '(unknown)'}) for member '${member}'; re-provisioning a push+pr credential and retrying once (command: ${built.logSafeCommand}): ${errorText}`);
863
1195
  try {
864
1196
  const reprov = await provisionPrCapableAuthForMember({ fleetApi, command, member, log, logPrefix, remoteUrlOverride });
865
1197
  if (reprov.repo) repo = reprov.repo;
1198
+ if (reprov.provisionSkipped) {
1199
+ // The provider deploys its credential out of band, so the
1200
+ // re-provision ran nothing: no heal happened and a retry
1201
+ // would resend a byte-identical command.
1202
+ log(`${logPrefix}: no PR auth self-heal ran for member '${member}' (provider '${reprov.provider || provider}' skipped re-provisioning); not retrying.`);
1203
+ const why = await statusHint(parsedResponse);
1204
+ return { ok: false, alreadyExists: false, prUrl: null, error: `HTTP ${status ?? '(unknown)'}: ${errorText}${why.hint}${why.remedy ?? skippedRemedy()}`, authFailure: true };
1205
+ }
866
1206
  // No token re-read here any more: `built.command` still
867
1207
  // carries the placeholder, so the retry's own
868
1208
  // vcs_credential_exec dispatch re-reads the FRESHLY
@@ -876,7 +1216,7 @@ export async function raiseVcsPrForMember({ fleetApi, command, member, base, hea
876
1216
  continue;
877
1217
  }
878
1218
 
879
- return { ok: false, alreadyExists: false, prUrl: null, error: `HTTP ${status ?? '(unknown)'}: ${errorText}`, authFailure: isPrAuthFailure(status, errorText) };
1219
+ return { ok: false, alreadyExists: false, prUrl: null, error: `HTTP ${status ?? '(unknown)'}: ${errorText}${(await statusHint(parsedResponse)).hint}`, authFailure: isPrAuthFailure(status, errorText) };
880
1220
  }
881
1221
  }
882
1222
 
@@ -936,14 +1276,44 @@ export function createMemberVcsProviderResolver(opts = {}) {
936
1276
  * transport-agnostic and unit-testable without a live fleet server.
937
1277
  *
938
1278
  * @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>}
1279
+ * @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
1280
  */
941
1281
  export function createVcsAuthSelfHealCallback(opts = {}) {
942
- const { callTool, command, log = () => {}, azdevopsPatSecretName } = opts;
1282
+ const { callTool, command, log = () => {}, azdevopsPatSecretName, now = () => Date.now(), futileHealTtlMs = FUTILE_HEAL_TTL_MS } = opts;
943
1283
  const fleetApi = new ApraFleet({ callTool });
1284
+ // GitHub #616: last-resort heals of UNCLASSIFIED failures that ran and did
1285
+ // NOT recover, keyed by member + normalised error, so the same futile
1286
+ // re-provisioning is not repeated on every D-pull. Only 'unknown' failures
1287
+ // are remembered -- a genuine auth failure is always healed -- and each
1288
+ // entry expires after futileHealTtlMs, so a later, different cause behind
1289
+ // the same text still gets a heal.
1290
+ /** @type {Map<string, { label: string, at: number }>} */
1291
+ const futileHeals = new Map();
1292
+
1293
+ function rememberedFutileHeal(key) {
1294
+ const entry = futileHeals.get(key);
1295
+ if (!entry) return null;
1296
+ if (now() - entry.at >= futileHealTtlMs) {
1297
+ futileHeals.delete(key);
1298
+ return null;
1299
+ }
1300
+ return entry;
1301
+ }
944
1302
 
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}`);
1303
+ async function onAuthFailure({ member, label, error, source, failureKind }) {
1304
+ if (failureKind === 'unknown') {
1305
+ const entry = rememberedFutileHeal(selfHealMemoryKey(member, error));
1306
+ if (entry) {
1307
+ throw new Error(
1308
+ `skipping self-heal for member '${member}' (${label}): re-provisioning credentials already failed to recover ` +
1309
+ `this same unclassified failure earlier in this run (${entry.label}); fix the cause on the member instead.`,
1310
+ );
1311
+ }
1312
+ }
1313
+ const isAuth = failureKind === undefined || failureKind === 'auth';
1314
+ log(isAuth
1315
+ ? `[Sync] self-heal: auth failure detected for member '${member}' (${label}${source ? `, ${source}` : ''}); calling provision_vcs_auth to re-provision credentials: ${error}`
1316
+ : `[Sync] self-heal: unclassified failure for member '${member}' (${label}${source ? `, ${source}` : ''}); re-provisioning credentials as a last resort via provision_vcs_auth: ${error}`);
947
1317
 
948
1318
  // apra-fleet-5co8.4.2: some providers (e.g. Azure DevOps PATs) can
949
1319
  // never be fixed by this reactive re-provisioning call alone -- it
@@ -964,19 +1334,135 @@ export function createVcsAuthSelfHealCallback(opts = {}) {
964
1334
  let resolved;
965
1335
  try {
966
1336
  resolved = await resolveProvider(member, { fleetApi });
1337
+ } catch (resolveErr) {
1338
+ log(`[Sync] self-heal: could not resolve member '${member}' (${label})'s VCS provider to check for an auth remedy hint (continuing with the self-heal attempt): ${resolveErr.message}`);
1339
+ }
1340
+ if (resolved) {
967
1341
  const { provider } = resolved;
968
1342
  const impl = getVcsProvider(provider);
969
1343
  if (impl && impl.authRemedy && impl.authRemedy.serverSideReMintable === false) {
970
1344
  log(`[Sync] self-heal: member '${member}' (${label}) uses '${provider}', whose credentials cannot be re-minted server-side. ${impl.authRemedy.hint}`);
1345
+ // apra-fleet-d1pk.3: re-provisioning a LOCAL member of such a
1346
+ // provider rewrites the host's own credential helper and
1347
+ // cannot mint anything new, so the self-heal refuses it --
1348
+ // and refuses too when the lookup fails (fail closed, F4).
1349
+ await assertNotLocalNonReMintable({ fleetApi, member, provider });
971
1350
  }
972
- } catch (resolveErr) {
973
- log(`[Sync] self-heal: could not resolve member '${member}' (${label})'s VCS provider to check for an auth remedy hint (continuing with the self-heal attempt): ${resolveErr.message}`);
974
1351
  }
1352
+ // When the provider could not be resolved above, the local check has
1353
+ // not run yet: provisionVcsAuthForMember runs it once its own lookup
1354
+ // has named the provider.
1355
+ await provisionVcsAuthForMember({ fleetApi, command, member, log, logPrefix: '[Sync] self-heal', azdevopsPatSecretName, resolvedProvider: resolved, refuseLocalNonReMintable: !resolved });
975
1356
 
976
- await provisionVcsAuthForMember({ fleetApi, command, member, log, logPrefix: '[Sync] self-heal', azdevopsPatSecretName, resolvedProvider: resolved });
1357
+ log(`[Sync] self-heal: credentials re-provisioned for member '${member}' (${label}); the failed command will be retried once.`);
1358
+ }
977
1359
 
978
- log(`[Sync] self-heal: provision_vcs_auth succeeded for member '${member}' (${label}); the failed command will be retried once.`);
1360
+ /**
1361
+ * Called by runGitStep/runDoltStep after the post-heal retry; a heal that
1362
+ * did not recover is remembered so it is not attempted again this run.
1363
+ * @param {{ member: string, label: string, error: string, recovered: boolean, failureKind?: string }} info
1364
+ */
1365
+ onAuthFailure.recordHealOutcome = async function recordHealOutcome({ member, label, error, recovered, failureKind }) {
1366
+ if (recovered || failureKind !== 'unknown') return;
1367
+ futileHeals.set(selfHealMemoryKey(member, error), { label, at: now() });
979
1368
  };
1369
+
1370
+ return onAuthFailure;
1371
+ }
1372
+
1373
+ /** How long a futile unclassified self-heal is remembered (30 minutes). */
1374
+ export const FUTILE_HEAL_TTL_MS = 30 * 60 * 1000;
1375
+
1376
+ /**
1377
+ * Key for remembering a futile self-heal: the member plus the failure's
1378
+ * DISTINGUISHING text. Warning/hint lines (shell-profile noise, git hints) are
1379
+ * dropped and the fatal/error lines kept (else the TAIL of what remains), so
1380
+ * two failures sharing a long common prefix never collapse into one key. The
1381
+ * run-varying parts (pids, counts, hex ids, whitespace runs) are normalised
1382
+ * away, but the number after "exit code"/"exit status" is kept, so distinct
1383
+ * exit codes stay distinct.
1384
+ * @param {string} member
1385
+ * @param {string} error
1386
+ * @returns {string}
1387
+ */
1388
+ export function selfHealMemoryKey(member, error) {
1389
+ const lines = String(error || '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean)
1390
+ .filter((l) => !/^(?:remote:\s*)?(?:warning|hint)\b/i.test(l));
1391
+ const decisive = lines.filter((l) => /\b(?:fatal|error)\b/i.test(l));
1392
+ let text = (decisive.length > 0 ? decisive : lines).join(' ');
1393
+ text = text.replace(/(\bexit (?:code|status)\s*:?\s*)(\d+)|\b[0-9a-f]{7,}\b|\d+/gi,
1394
+ (m, prefix, code) => (prefix ? `${prefix}${code}` : (/^\d+$/.test(m) ? '<n>' : '<hex>')));
1395
+ text = text.toLowerCase().replace(/\s+/g, ' ').trim();
1396
+ if (text.length > 500) text = text.slice(-500);
1397
+ return `${member}|${text}`;
1398
+ }
1399
+
1400
+ /**
1401
+ * Typed error code the VCS preflight logs (once per member per run) when a
1402
+ * non-re-mintable member's existing credential fails its probe and cannot be
1403
+ * fixed by the fleet. Stable, so log readers and tests match it, not prose.
1404
+ */
1405
+ export const VCS_CREDENTIAL_PROBE_FAILED = 'vcs_credential_probe_failed';
1406
+
1407
+ /**
1408
+ * Typed error code for the local-member guard failing CLOSED: member_detail
1409
+ * could not say whether a member is local, so a credential the fleet cannot
1410
+ * mint is NOT provisioned (on a local member it would overwrite the host's own
1411
+ * credential helper). Stable, so log readers and tests match it, not prose.
1412
+ */
1413
+ export const VCS_MEMBER_LOOKUP_FAILED = 'vcs_member_lookup_failed';
1414
+
1415
+ /**
1416
+ * Throw unless `member` is known NOT to be a local member, when `provider` is
1417
+ * one whose credential the fleet cannot mint (authRemedy.serverSideReMintable
1418
+ * === false). Re-provisioning a local member of such a provider rewrites the
1419
+ * host's own credential helper, so: a local record -> refuse; a member_detail
1420
+ * failure or non-record answer -> refuse with VCS_MEMBER_LOOKUP_FAILED (fail
1421
+ * closed, never provision on an unknown member type). Any other provider is a
1422
+ * no-op. Messages are ASCII-only.
1423
+ * @param {{ fleetApi: object, member: string, provider: string }} opts
1424
+ */
1425
+ async function assertNotLocalNonReMintable({ fleetApi, member, provider }) {
1426
+ const impl = getVcsProvider(provider);
1427
+ if (!impl || !impl.authRemedy || impl.authRemedy.serverSideReMintable !== false) return;
1428
+ let record = null;
1429
+ let why = 'member_detail did not return a member record';
1430
+ try {
1431
+ record = await readMemberRecord(member, fleetApi);
1432
+ } catch (err) {
1433
+ why = `member_detail failed: ${err && err.message ? err.message : String(err)}`;
1434
+ }
1435
+ if (!record) {
1436
+ const err = new Error(
1437
+ `ERROR ${VCS_MEMBER_LOOKUP_FAILED}: could not confirm member '${member}' is not a local member (${why}); `
1438
+ + `not provisioning its '${provider}' credential, which on a local member would overwrite the host's own credential. `
1439
+ + 'Retry once the fleet server answers member_detail for this member.',
1440
+ );
1441
+ err.message = err.message.replace(/[^\x20-\x7e]+/g, ' ');
1442
+ err.code = VCS_MEMBER_LOOKUP_FAILED;
1443
+ throw err;
1444
+ }
1445
+ if (record.type === 'local') {
1446
+ throw new Error(`member '${member}' is a local member on '${provider}': not re-provisioning it, which would overwrite the host's own credential; fix the host's credential instead.`);
1447
+ }
1448
+ }
1449
+
1450
+ /**
1451
+ * Parsed member_detail JSON for `member` (type, os, shell, vcsProvider, ...),
1452
+ * or null when the response is not JSON (e.g. an unknown member's plain-text
1453
+ * answer). A failing memberDetail() call rejects; callers decide.
1454
+ * @param {string} member
1455
+ * @param {{ memberDetail: Function }} fleetApi
1456
+ * @returns {Promise<object|null>}
1457
+ */
1458
+ async function readMemberRecord(member, fleetApi) {
1459
+ const res = await fleetApi.memberDetail({ member_name: member, format: 'json' });
1460
+ try {
1461
+ const parsed = JSON.parse(resultText(res));
1462
+ return parsed && typeof parsed === 'object' ? parsed : null;
1463
+ } catch {
1464
+ return null;
1465
+ }
980
1466
  }
981
1467
 
982
1468
  // How far ahead of a credential's known expiry the preflight treats it as
@@ -1016,20 +1502,260 @@ export function createVcsAuthPreflightCallback(opts = {}) {
1016
1502
  const fleetApi = new ApraFleet({ callTool });
1017
1503
  /** @type {Map<string, Date|null>} member -> last-known expiresAt (null = no expiry tracked, e.g. PAT mode). */
1018
1504
  const knownGoodUntil = new Map();
1505
+ // apra-fleet-d1pk.3: PROBE-FIRST branch for members whose credential the
1506
+ // fleet cannot mint (provider authRemedy.serverSideReMintable === false,
1507
+ // e.g. Bitbucket API tokens, Azure DevOps PATs). Provisioning such a
1508
+ // member just redeploys a stored secret -- and on a LOCAL member it
1509
+ // rewrites the host's own git credential helper -- so the preflight first
1510
+ // asks whether the credential ALREADY in place works (a non-interactive
1511
+ // `git ls-remote origin HEAD`, see getSeCommands().gitLsRemoteProbe()),
1512
+ // and decides once per member per run:
1513
+ // 'ok' -- probe passed, or a remote member was provisioned after a
1514
+ // failed probe: never probe or provision again this run.
1515
+ // 'failed' -- one typed ERROR line naming the provider remedy was
1516
+ // logged; never re-probed, re-provisioned or re-logged.
1517
+ // A GitHub-App (server-side re-mintable) member never enters this branch
1518
+ // and keeps the expiry-based refresh below exactly as before.
1519
+ /** @type {Map<string, { probe: boolean, provider?: string, impl?: object, local?: boolean, target?: { os: string, shell: string } }>} */
1520
+ const plans = new Map();
1521
+ /** @type {Map<string, 'ok'|'failed'>} */
1522
+ const probeVerdicts = new Map();
1523
+
1524
+ async function planFor(member) {
1525
+ if (plans.has(member)) return plans.get(member);
1526
+ let plan = { probe: false };
1527
+ const record = await readMemberRecord(member, fleetApi);
1528
+ if (record) {
1529
+ let provider = typeof record.vcsProvider === 'string' && getVcsProvider(record.vcsProvider) ? record.vcsProvider : null;
1530
+ if (!provider) {
1531
+ // No registered provider: detect it from the member's own
1532
+ // remote with the same anchored auth-host match the
1533
+ // provisioning path's LAYER 2 fallback uses, so an
1534
+ // unregistered local Bitbucket member is never provisioned.
1535
+ const remoteRes = await command('git remote get-url origin', { member_name: member, silent: true, failSoft: true });
1536
+ const remoteUrl = remoteRes && remoteRes.ok ? String(remoteRes.output || '').trim() : '';
1537
+ provider = remoteUrl ? detectVcsProviderFromRemote(remoteUrl) : null;
1538
+ }
1539
+ const impl = provider ? getVcsProvider(provider) : null;
1540
+ if (impl && impl.authRemedy && impl.authRemedy.serverSideReMintable === false) {
1541
+ plan = {
1542
+ probe: true,
1543
+ provider,
1544
+ impl,
1545
+ local: record.type === 'local',
1546
+ target: { os: typeof record.os === 'string' ? record.os : '', shell: typeof record.shell === 'string' ? record.shell : '' },
1547
+ };
1548
+ }
1549
+ }
1550
+ plans.set(member, plan);
1551
+ return plan;
1552
+ }
1553
+
1554
+ // `remedy` (when given) replaces the provider's generic authRemedy.hint:
1555
+ // a credentialProbe provider words its own member-specific fix.
1556
+ // `noPr` appends the consequence for the labelled PR credential.
1557
+ function logProbeFailure(member, plan, why, { remedy = null, noPr = false } = {}) {
1558
+ const where = plan.local ? 'local member' : 'member';
1559
+ const consequence = noPr
1560
+ ? ` No PR will be opened this sprint for member '${member}': Publish PR reads this same '${vcsCredentialLabelForProvider(plan.provider)}' credential (the sprint continues and the skipped PR is reported in its final status).`
1561
+ : '';
1562
+ const line = `[Sync] preflight: ERROR ${VCS_CREDENTIAL_PROBE_FAILED}: ${where} '${member}' (provider '${plan.provider}') cannot reach its origin with the credential already in place: ${why}. ${remedy || plan.impl.authRemedy.hint}${consequence}`;
1563
+ // ASCII only, whatever git or the member shell printed.
1564
+ log(line.replace(/[^\x20-\x7e]+/g, ' '));
1565
+ }
1566
+
1567
+ // The provider's credentialProbe (see vcs-providers/index.mjs) checks the
1568
+ // credential Publish PR will actually read -- the provider-labelled
1569
+ // fleet helper -- instead of trusting git ls-remote, which goes through
1570
+ // the host's whole credential helper chain where ANOTHER helper (a
1571
+ // system credential manager, a global store) can answer for a broken
1572
+ // fleet helper. Two checks, both on that labelled credential:
1573
+ // 1. the provider's REST probe through vcs_credential_exec with the
1574
+ // provider label and the {{vcs_token_inline}} placeholder -- the
1575
+ // same server-side handoff as the PR path, so the token never
1576
+ // reaches this process;
1577
+ // 2. the helper's username= line (read member-side, filtered there so
1578
+ // the token line never leaves the member) against the provider's
1579
+ // expectedUsername; an unresolved {{...}} placeholder literal is
1580
+ // named as such, any other value is NOT printed.
1581
+ // Returns { ok, reasons: string[], remedy: string|null }. Never throws.
1582
+ let storeNames;
1583
+ async function checkLabelledCredential(member, plan) {
1584
+ const probe = plan.impl.credentialProbe;
1585
+ const label = vcsCredentialLabelForProvider(plan.provider);
1586
+ const reasons = [];
1587
+ let remedy = null;
1588
+ if (storeNames === undefined) storeNames = await listCredentialStoreNames(fleetApi);
1589
+ const availableSecrets = storeNames;
1590
+
1591
+ const remoteRes = await command('git remote get-url origin', { member_name: member, silent: true, failSoft: true });
1592
+ const remoteUrl = remoteRes && remoteRes.ok ? String(remoteRes.output || '').trim() : '';
1593
+ const repoRef = remoteUrl && typeof plan.impl.parseRepoRef === 'function' ? plan.impl.parseRepoRef(remoteUrl) : null;
1594
+ const remedyCtx = { availableSecrets, memberName: member, repoRef, local: plan.local };
1595
+
1596
+ if (!repoRef) {
1597
+ // The raw origin may embed a credential (https://user:TOKEN@host/...,
1598
+ // which git prints verbatim): quote it with the userinfo masked.
1599
+ const shown = remoteUrl ? ` '${redactUrlUserinfo(remoteUrl)}'` : ' (unreadable)';
1600
+ reasons.push(`the REST credential probe could not run: no ${plan.provider} repository could be derived from the member's origin remote${shown}`);
1601
+ } else if (!fleetApi || typeof fleetApi.vcsCredentialExec !== 'function') {
1602
+ reasons.push('the REST credential probe could not run: this fleet client exposes no vcs_credential_exec tool');
1603
+ } else {
1604
+ const built = probe.build({ repoRef, token: '{{vcs_token_inline}}', os: plan.target.os, shell: plan.target.shell });
1605
+ let handoff = {};
1606
+ try {
1607
+ const execRes = await fleetApi.vcsCredentialExec({ member_name: member, label, command: built.command });
1608
+ handoff = (execRes && execRes.structuredContent) || {};
1609
+ } catch (err) {
1610
+ handoff = { ok: false, reason: 'dispatch_failed', stderr: err && err.message ? err.message : String(err) };
1611
+ }
1612
+ if (!handoff.ok) {
1613
+ reasons.push(`the '${label}' fleet credential helper could not be used for the REST probe (vcs_credential_exec reason: ${handoff.reason || 'unknown'})`);
1614
+ } else {
1615
+ const parsed = parseVcsCurlOutput(handoff.stdout);
1616
+ const [lo, hi] = built.interpret.successStatusRange;
1617
+ if (!(typeof handoff.exitCode !== 'number' || handoff.exitCode === 0) || parsed.status === null) {
1618
+ reasons.push(`the REST credential probe (${built.logSafeCommand}) did not complete (exit ${handoff.exitCode ?? 'unknown'}${handoff.stderr ? `: ${String(handoff.stderr).trim().slice(0, 200)}` : ''})`);
1619
+ } else if (parsed.status < lo || parsed.status > hi) {
1620
+ const out = typeof plan.impl.httpFailureHint === 'function'
1621
+ ? plan.impl.httpFailureHint({ status: parsed.status, body: parsed.body, headers: parsed.headers, ...remedyCtx })
1622
+ : '';
1623
+ const hint = typeof out === 'string' ? out : (out && out.hint) || '';
1624
+ if (out && typeof out === 'object' && out.remedy) remedy = out.remedy;
1625
+ reasons.push(`the '${label}' fleet credential Publish PR uses was refused by the REST probe with HTTP ${parsed.status}${hint ? `: ${hint}` : ''}`);
1626
+ }
1627
+ }
1628
+ }
1629
+
1630
+ if (typeof probe.expectedUsername === 'string') {
1631
+ const read = getSeCommands(plan.target).readCredentialHelperUsername(label);
1632
+ let userRes;
1633
+ try {
1634
+ userRes = await command(read.command, { member_name: member, silent: true, failSoft: true });
1635
+ } catch (err) {
1636
+ userRes = { ok: false, output: '' };
1637
+ }
1638
+ // Only the username= line is ever looked at, even if a broken
1639
+ // member-side filter let more through.
1640
+ const m = /^username=(.*)$/m.exec(String((userRes && userRes.output) || ''));
1641
+ const username = m ? m[1].trim() : '';
1642
+ if (!m) {
1643
+ reasons.push(`the '${label}' fleet credential helper (${read.descriptor}) printed no username= line (missing helper, or written without a username)`);
1644
+ } else if (username !== probe.expectedUsername) {
1645
+ reasons.push(/^\{\{\s*[A-Za-z]+\.[A-Za-z0-9_.-]+\s*\}\}$/.test(username)
1646
+ ? `the '${label}' fleet credential helper's username line is the unresolved placeholder literal ${username}, not ${probe.expectedUsername} (it was written without placeholder resolution)`
1647
+ : `the '${label}' fleet credential helper's username line is not ${probe.expectedUsername} (it was written by something other than provision_vcs_auth for this provider)`);
1648
+ }
1649
+ }
1650
+
1651
+ if (!remedy && reasons.length && typeof probe.remedy === 'function') remedy = probe.remedy(remedyCtx);
1652
+ return { ok: reasons.length === 0, reasons, remedy };
1653
+ }
1654
+
1655
+ async function probeFirst(member, plan) {
1656
+ const verdict = probeVerdicts.get(member);
1657
+ if (verdict) {
1658
+ log(verdict === 'ok'
1659
+ ? `[Sync] preflight: provision_vcs_auth skipped for member '${member}': its '${plan.provider}' credential already passed this run's probe.`
1660
+ : `[Sync] preflight: provision_vcs_auth skipped for member '${member}': its '${plan.provider}' credential probe already failed this run (reported once above).`);
1661
+ return;
1662
+ }
1663
+ const restProbe = !!(plan.impl.credentialProbe && typeof plan.impl.credentialProbe.build === 'function');
1664
+ const restNote = restProbe ? `, plus a REST probe of the '${vcsCredentialLabelForProvider(plan.provider)}' credential Publish PR uses` : '';
1665
+ log(`[Sync] preflight: probing member '${member}''s existing '${plan.provider}' credential (git ls-remote origin, non-interactive${restNote}) instead of provisioning.`);
1666
+ let res;
1667
+ try {
1668
+ res = await command(getSeCommands(plan.target).gitLsRemoteProbe(), { member_name: member, silent: true, failSoft: true });
1669
+ } catch (err) {
1670
+ res = { ok: false, error: err && err.message ? err.message : String(err) };
1671
+ }
1672
+ const gitOk = !!(res && res.ok);
1673
+ const detail = gitOk ? '' : String((res && (res.error || res.output)) || 'git ls-remote origin failed').trim().split(/\r?\n/).filter(Boolean).slice(-2).join(' / ').slice(0, 300);
1674
+ // Both must pass for a credentialProbe provider: ls-remote alone can
1675
+ // be answered by another host helper while the labelled one is dead.
1676
+ const cred = restProbe ? await checkLabelledCredential(member, plan) : { ok: true, reasons: [], remedy: null };
1677
+ if (gitOk && cred.ok) {
1678
+ probeVerdicts.set(member, 'ok');
1679
+ log(`[Sync] preflight: member '${member}''s existing '${plan.provider}' credential works; provision_vcs_auth skipped for this run.`);
1680
+ return;
1681
+ }
1682
+ const why = [gitOk ? '' : (restProbe ? `git ls-remote origin failed: ${detail}` : detail), ...cred.reasons].filter(Boolean).join('; ');
1683
+ if (plan.local) {
1684
+ // Never provision a LOCAL non-re-mintable member: it would
1685
+ // rewrite the host operator's own credential helper.
1686
+ //
1687
+ // DECISION (documented in docs/fleet-sprint-getting-started.md):
1688
+ // a failed labelled-credential probe on a local member does NOT
1689
+ // stop the sprint. It is reported once, here, at preflight time
1690
+ // with the exact by-hand fix; the sprint keeps going, Publish PR
1691
+ // skips the PR (its credential is this same dead one) and the
1692
+ // final status surfaces the skipped PR. Stopping the launch would
1693
+ // throw away a whole sprint over a PR that the operator can open
1694
+ // by hand after fixing the helper.
1695
+ probeVerdicts.set(member, 'failed');
1696
+ logProbeFailure(member, plan, `${why}; not provisioning a local member, which would overwrite the host's own credential`, { remedy: cred.remedy, noPr: !cred.ok });
1697
+ return;
1698
+ }
1699
+ // A remote member gets exactly ONE non-interactive provision attempt;
1700
+ // for a credentialProbe provider the labelled credential is re-probed
1701
+ // after it and that re-probe decides the verdict.
1702
+ try {
1703
+ const { expiresAt } = await provisionVcsAuthForMember({ fleetApi, command, member, log, logPrefix: '[Sync] preflight', azdevopsPatSecretName, refuseLocalNonReMintable: true });
1704
+ knownGoodUntil.set(member, expiresAt);
1705
+ } catch (err) {
1706
+ probeVerdicts.set(member, 'failed');
1707
+ logProbeFailure(member, plan, `${why}; provision_vcs_auth also failed: ${err.message}`, { remedy: cred.remedy, noPr: !cred.ok });
1708
+ return;
1709
+ }
1710
+ if (restProbe) {
1711
+ const again = await checkLabelledCredential(member, plan);
1712
+ if (!again.ok) {
1713
+ probeVerdicts.set(member, 'failed');
1714
+ logProbeFailure(member, plan, `${why}; provision_vcs_auth ran once, but the re-probe still fails: ${again.reasons.join('; ')}`, { remedy: again.remedy, noPr: true });
1715
+ return;
1716
+ }
1717
+ }
1718
+ probeVerdicts.set(member, 'ok');
1719
+ log(`[Sync] preflight: provision_vcs_auth succeeded for member '${member}' after its credential probe failed.`);
1720
+ }
1019
1721
 
1020
1722
  return async function ensureVcsAuthFresh(member) {
1723
+ let plan;
1724
+ try {
1725
+ plan = await planFor(member);
1726
+ } catch (err) {
1727
+ // Fail CLOSED: without the record this cannot tell a local member
1728
+ // (whose host credential must never be overwritten) from a remote
1729
+ // one, so nothing is provisioned. Not cached: the next call
1730
+ // retries the lookup. Still never throws (see above).
1731
+ const line = `[Sync] preflight: ERROR ${VCS_MEMBER_LOOKUP_FAILED}: could not read member '${member}''s record (member_detail) to choose probe vs provision; provision_vcs_auth skipped for member '${member}' (fail closed, a local member's host credential must not be overwritten): ${err && err.message ? err.message : String(err)}`;
1732
+ log(line.replace(/[^\x20-\x7e]+/g, ' '));
1733
+ return;
1734
+ }
1735
+ if (plan.probe) {
1736
+ try {
1737
+ await probeFirst(member, plan);
1738
+ } catch (err) {
1739
+ log(`[Sync] preflight: credential probe for member '${member}' failed unexpectedly (continuing): ${err.message}`);
1740
+ }
1741
+ return;
1742
+ }
1021
1743
  if (knownGoodUntil.has(member)) {
1022
1744
  const expiresAt = knownGoodUntil.get(member);
1023
1745
  if (expiresAt === null || expiresAt.getTime() - now() > VCS_AUTH_EXPIRY_PREFLIGHT_MS) {
1024
1746
  // Still fresh (or a no-expiry credential type) -- skip, so
1025
1747
  // this is not an unconditional provisioning call on every
1026
- // dispatch.
1748
+ // dispatch. Still state WHY nothing was provisioned, so the
1749
+ // "needs a fresh VCS credential" line is never left dangling.
1750
+ log(expiresAt === null
1751
+ ? `[Sync] preflight: provision_vcs_auth skipped for member '${member}': PAT mode, credential has no expiry.`
1752
+ : `[Sync] preflight: provision_vcs_auth skipped for member '${member}': cached credential fresh until ${expiresAt.toISOString()}.`);
1027
1753
  return;
1028
1754
  }
1029
1755
  }
1030
1756
  log(`[Sync] preflight: ensuring member '${member}' has a fresh VCS credential before dispatch; calling provision_vcs_auth.`);
1031
1757
  try {
1032
- const { expiresAt } = await provisionVcsAuthForMember({ fleetApi, command, member, log, logPrefix: '[Sync] preflight', azdevopsPatSecretName });
1758
+ const { expiresAt } = await provisionVcsAuthForMember({ fleetApi, command, member, log, logPrefix: '[Sync] preflight', azdevopsPatSecretName, refuseLocalNonReMintable: true });
1033
1759
  knownGoodUntil.set(member, expiresAt);
1034
1760
  log(`[Sync] preflight: provision_vcs_auth succeeded for member '${member}'${expiresAt ? ` (expires ${expiresAt.toISOString()})` : ''}.`);
1035
1761
  } catch (err) {
@@ -1151,7 +1877,11 @@ export function createWorkflowsPermissionPreflightCallback(opts = {}) {
1151
1877
 
1152
1878
  return async function warnIfWorkflowsPermissionMissing(member, branch, baseBranch) {
1153
1879
  try {
1154
- if (!branch || !baseBranch || branch === baseBranch) return;
1880
+ // branch === baseBranch is rejected at launch (sprint-args.mjs
1881
+ // validateBranchPair), so it is no longer tolerated as a silent no-op
1882
+ // here: a same-named pair falls through to the ahead-count check,
1883
+ // which still returns early when nothing is ahead of origin.
1884
+ if (!branch || !baseBranch) return;
1155
1885
  if (silentMembers.has(member)) return;
1156
1886
 
1157
1887
  const { provider, authMode } = await resolveProvider(member, { fleetApi });
@@ -1273,6 +2003,15 @@ export function createLlmAuthSelfHealCallback(opts = {}) {
1273
2003
  return false;
1274
2004
  }
1275
2005
 
2006
+ if (outcome.reason === 'deployed_unverified') {
2007
+ // Credentials were deployed but the server's post-deploy auth test
2008
+ // did not confirm them: surface its error line and the explicit
2009
+ // switch, then still retry once (the test can be stricter than a real dispatch).
2010
+ const authLine = (text.split('\n').find((l) => /Auth test/i.test(l)) || '').trim();
2011
+ 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.`);
2012
+ return true;
2013
+ }
2014
+
1276
2015
  log(`[Dispatch] self-heal: provision_llm_auth succeeded for member '${member}' (${label}); the failed dispatch will be retried once.`);
1277
2016
  return true;
1278
2017
  };