@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
@@ -7,26 +7,29 @@
7
7
  * vcs-module.mjs's now-deleted BUILDERS/DEFAULT_AUTH_MODES tables, which a
8
8
  * new provider had to also edit.
9
9
  *
10
- * No auth-mode axis of its own (Bitbucket authenticates via a single app
11
- * password / token field at provision_vcs_auth time, same as Azure DevOps --
12
- * see ./azure-devops.mjs), and no REST create-pull-request/comment builders
13
- * implemented yet -- both are DELIBERATELY absent (`builders: null`) rather
14
- * than guessed at, so buildVcsCommand() fails closed with a clear ASCII
15
- * "ERROR: ... does not yet implement action ..." instead of silently
16
- * building a wrong command. Declaring `defaultAuthMode` (even as `null`) is
10
+ * No auth-mode axis of its own (Bitbucket authenticates via a single
11
+ * Atlassian API token field at provision_vcs_auth time, same as Azure DevOps --
12
+ * see ./azure-devops.mjs). Declaring `defaultAuthMode` (even as `null`) is
17
13
  * what makes 'bitbucket' part of resolveProvider()'s known vocabulary -- see
18
14
  * ./index.mjs's isAuthBackend().
19
15
  *
16
+ * Bitbucket Cloud PR support (adapted from PR #513): create/find/update
17
+ * pull-request builders + response dialect below, and capabilitiesForHost()
18
+ * returning {canOpenPullRequest: true}, mirroring github.mjs and
19
+ * azure-devops.mjs (see ./index.mjs's REQUIRED EXPORT SHAPE: a host never
20
+ * ADVERTISES a pull request it cannot actually deliver). Bitbucket Cloud
21
+ * only -- a Data Center install has an arbitrary host and stays generic-git.
22
+ *
20
23
  * Extends GenericGitVCS for stderr classification (Bitbucket speaks plain
21
24
  * git-over-HTTPS/SSH; it had no vendor-specific auth literal in the parity
22
25
  * corpus before apra-fleet-417.6 -- see generic-git.mjs's own header note on
23
26
  * what belongs portable vs. vendor-specific).
24
27
  *
25
28
  * apra-fleet-417.6: 'remote: Invalid or expired app password.' is
26
- * Bitbucket's own literal for a dead/rotated app password, reached without
27
- * git's generic "fatal: Authentication failed" tail (e.g. over a transport
28
- * that does not append it). The text says "expired" outright, and
29
- * re-provisioning a fresh app password is exactly the fix, so AUTH_EXPIRED
29
+ * Bitbucket's own literal for a dead/rotated (legacy) app password, reached
30
+ * without git's generic "fatal: Authentication failed" tail (e.g. over a
31
+ * transport that does not append it). The text says "expired" outright, and
32
+ * re-provisioning a fresh credential (an API token) is the fix, so AUTH_EXPIRED
30
33
  * (contrast Azure DevOps' TF401019, which is AUTH_DENIED -- see
31
34
  * ./azure-devops.mjs -- because re-minting the same credential there cannot
32
35
  * help).
@@ -35,6 +38,7 @@
35
38
  */
36
39
 
37
40
  import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
41
+ import { shQuote, shQuoteJson, curlBinary, assertToken } from './shell-helpers.mjs';
38
42
 
39
43
  const AUTH_EXPIRED = [
40
44
  /Invalid or expired app password/i,
@@ -53,29 +57,819 @@ const AUTH_EXPIRED = [
53
57
  *
54
58
  * apra-fleet-5oo: declaring this makes resolveVcsProviderForHost() name
55
59
  * 'bitbucket' for a Bitbucket remote, which is what lets runner.js's
56
- * dispatch-time VCS-provider fallback detect it. Behaviour-neutral for
57
- * VCSModule.capabilities(): this provider declares no capabilitiesForHost,
58
- * and the caller's default (canOpenPullRequest:false) matches what
59
- * GenericGitVCS returned for these hosts before.
60
+ * dispatch-time VCS-provider fallback detect it. VCSModule.capabilities()
61
+ * now reports canOpenPullRequest:true via this provider's capabilitiesForHost
62
+ * (apra-fleet-qeq1.4), allowing the Publish PR phase to dispatch the builder.
60
63
  *
61
64
  * Kept character-for-character in step with
62
65
  * src/utils/vcs-provider-detect.ts's BITBUCKET_HOST_RE -- the two halves of
63
66
  * the same decision must never disagree about who owns a host. */
64
- const HOST_RE = /^(?:www\.|altssh\.)?bitbucket\.org$/i;
67
+ const HOST_RE = /^(?:www\.|altssh\.|ssh\.)?bitbucket\.org$/i;
65
68
 
66
69
  function matchesHost(host) {
67
70
  return typeof host === 'string' && HOST_RE.test(host.trim());
68
71
  }
69
72
 
73
+ /** Every host this provider matches can open a PR via the REST call
74
+ * buildBitbucketCreatePrCommand() builds -- bitbucket.org and its aliases
75
+ * all speak the same `/repositories/{workspace}/{repo}/pullrequests` shape. */
76
+ function capabilitiesForHost(_host) {
77
+ return { canOpenPullRequest: true };
78
+ }
79
+
80
+ /** Split a remote URL into { host, path } for BOTH shapes git speaks: a real
81
+ * scheme'd URL (https, with optional userinfo and port) and the scp-like
82
+ * shorthand `git@host:path` that `new URL()` cannot parse at all. Mirrors
83
+ * ./azure-devops.mjs's splitRemote(). */
84
+ function splitRemote(url) {
85
+ if (/^[a-z][a-z0-9+.-]*:\/\//i.test(url)) {
86
+ let parsed;
87
+ try {
88
+ parsed = new URL(url);
89
+ } catch {
90
+ return null;
91
+ }
92
+ if (!parsed.hostname) return null;
93
+ return { host: parsed.hostname.toLowerCase(), path: parsed.pathname };
94
+ }
95
+ const scp = /^(?:[^@\s/]+@)?([^:\s/]+):(.*)$/.exec(url);
96
+ if (!scp) return null;
97
+ return { host: scp[1].toLowerCase(), path: `/${scp[2]}` };
98
+ }
99
+
100
+ /** Split `path` into non-empty segments with any trailing '.git' stripped off
101
+ * the last one. Bitbucket workspace/repo slugs are not percent-encoded in
102
+ * practice (unlike Azure DevOps project names), so no decode step is needed
103
+ * here. */
104
+ function pathSegments(path) {
105
+ const raw = String(path).split('/').filter((part) => part !== '');
106
+ if (raw.length === 0) return raw;
107
+ raw[raw.length - 1] = raw[raw.length - 1].replace(/\.git$/i, '');
108
+ return raw;
109
+ }
110
+
111
+ function makeRef(workspace, repo) {
112
+ if (!workspace || !repo) return null;
113
+ return {
114
+ workspace,
115
+ repo,
116
+ canonical: `${workspace}/${repo}`,
117
+ };
118
+ }
119
+
120
+ /**
121
+ * Parse a Bitbucket git remote URL into its { workspace, repo, canonical }
122
+ * coordinates -- the identity every Bitbucket REST call needs
123
+ * (https://api.bitbucket.org/2.0/repositories/{workspace}/{repo}/...).
124
+ *
125
+ * Recognized shapes:
126
+ * git@bitbucket.org:WORKSPACE/REPO[.git]
127
+ * https://[user@]bitbucket.org/WORKSPACE/REPO[.git][/]
128
+ * ssh://git@altssh.bitbucket.org[:22]/WORKSPACE/REPO[.git]
129
+ * git@ssh.bitbucket.org:WORKSPACE/REPO[.git] and ssh://git@ssh.bitbucket.org/WORKSPACE/REPO[.git]
130
+ *
131
+ * NEVER throws and NEVER partially guesses: anything that is not one of the
132
+ * shapes above -- including a non-Bitbucket host and a lookalike like
133
+ * `bitbucket.org.evil.example` -- returns null, so the caller can raise its
134
+ * own typed ERROR naming the expected shape (repoRefHint) instead of
135
+ * proceeding with half-parsed coordinates.
136
+ *
137
+ * @param {unknown} remoteUrl
138
+ * @returns {{ workspace: string, repo: string, canonical: string }|null}
139
+ */
140
+ function parseRepoRef(remoteUrl) {
141
+ if (typeof remoteUrl !== 'string') return null;
142
+ const url = remoteUrl.trim();
143
+ if (!url) return null;
144
+
145
+ const split = splitRemote(url);
146
+ if (!split || !matchesHost(split.host)) return null;
147
+
148
+ const segments = pathSegments(split.path);
149
+ if (segments.length !== 2) return null;
150
+
151
+ return makeRef(segments[0], segments[1]);
152
+ }
153
+
154
+ /** The remote shape parseRepoRef() expects, quoted into every
155
+ * operator-facing remedy this module produces -- the modern form an
156
+ * operator copies out of Bitbucket's "Clone" dialog. */
157
+ const REPO_REF_HINT = 'git@bitbucket.org:WORKSPACE/REPO.git, git@ssh.bitbucket.org:WORKSPACE/REPO.git or https://bitbucket.org/WORKSPACE/REPO.git';
158
+
159
+ // ---------------------------------------------------------------------------
160
+ // Provisioning (apra-fleet-qeq1.9)
161
+ // ---------------------------------------------------------------------------
162
+ //
163
+ // WHY THIS PROVIDER NEEDS A HOOK AT ALL, and why its two git-access levels
164
+ // answer differently. The shared caller's default argument shape
165
+ // (`git_access` + a `repos` allowlist) is GitHub-App vocabulary; Bitbucket
166
+ // has no App/installation model, so provision_vcs_auth's Bitbucket path
167
+ // instead requires TWO fields -- `api_token` and `workspace` (see
168
+ // src/services/vcs/bitbucket.ts's buildCredentials) -- neither of which the
169
+ // default shape sends. Sending the default shape dispatches a call with no
170
+ // `api_token` at all, which trips that path's `missingCredential` hook and
171
+ // opens an OUT-OF-BAND operator prompt in the middle of an unattended
172
+ // sprint. Every branch below exists to make that unreachable.
173
+ //
174
+ // What the orchestrator CAN supply (everything required):
175
+ // workspace parseRepoRef() above derives it from the member's own remote.
176
+ // api_token as a `{{secret.NAME}}` PLACEHOLDER, never a value:
177
+ // provision_vcs_auth resolves that placeholder hub-side.
178
+ // Same secret transport ./azure-devops.mjs documents; the
179
+ // orchestrator process never holds, logs or transports the
180
+ // plaintext.
181
+ //
182
+ // Hence the split:
183
+ //
184
+ // git_access 'push+pr' (the JUST-IN-TIME re-provision both PR-raising call
185
+ // sites run immediately before dispatching create-pull-request) ->
186
+ // SKIP. That re-provision exists to WIDEN a GitHub App token's scope
187
+ // for the duration of one PR call. A Bitbucket API token has no
188
+ // scope axis to widen -- it carries whatever scopes it was minted with
189
+ // -- and cannot be re-assembled here anyway, so the step is both
190
+ // impossible and unnecessary. Skipping it leaves the operator-deployed
191
+ // credential in place, which is exactly what the PR dispatch goes on to
192
+ // read server-side (vcs_credential_exec's {{vcs_token_inline}}
193
+ // placeholder). Without this the PR is never even
194
+ // attempted: the re-provision runs FIRST and its failure short-circuits
195
+ // the whole call.
196
+ //
197
+ // any other git_access (the shared preflight / reactive self-heal paths) ->
198
+ // send the complete argument set (workspace + api_token placeholder);
199
+ // a missing secret is a typed error naming the credential-store entry,
200
+ // never an out-of-band prompt.
201
+ //
202
+ // A remote whose workspace cannot be derived is a typed `error` on every
203
+ // path: that is a real, actionable misconfiguration, not something to guess
204
+ // past. (A MALFORMED bitbucket.org remote is already rejected upstream by
205
+ // parseRepoScopeFromRemoteUrl; the branch below is reached when the remote
206
+ // could not be READ at all, which is a different cause and must be worded as
207
+ // one.)
208
+
209
+ /** Credential-store entry name this hook references for the `api_token`
210
+ * field, mirroring ./azure-devops.mjs's DEFAULT_PAT_SECRET convention of
211
+ * naming the entry after the provision_vcs_auth field it feeds. Deliberately
212
+ * does NOT honour ctx.secretName: that value is threaded from a sprint
213
+ * argument scoped to Azure DevOps' PAT, so consuming it here would point
214
+ * Bitbucket at another provider's secret. */
215
+ const DEFAULT_API_TOKEN_SECRET = 'bitbucket_api_token';
216
+
217
+ /** Remedy text for a Bitbucket auth failure, surfaced through the generic
218
+ * `authRemedy` descriptor field (below) so the shared self-heal and the
219
+ * PR-raising degrade path print it without a provider-name conditional of
220
+ * their own. Names the ONLY fix: deploy the credential out of band, because
221
+ * the fleet cannot assemble one. No secret VALUE appears here or anywhere
222
+ * else -- the token is always a credential-store name or a placeholder. */
223
+ /** The fixed git username provision_vcs_auth writes into a Bitbucket
224
+ * helper (src/services/vcs/bitbucket.ts BITBUCKET_TOKEN_USERNAME). Any
225
+ * other username line means the helper was written by something else (an
226
+ * older fleet, a hand edit, an unresolved placeholder) and git over HTTPS
227
+ * with an API token will not authenticate with it. */
228
+ const TOKEN_USERNAME = 'x-bitbucket-api-token-auth';
229
+
230
+ /** The four scopes an Atlassian API token needs for everything the sprint
231
+ * does against Bitbucket (clone/push, find/create/update a PR). */
232
+ const REQUIRED_TOKEN_SCOPES = 'read:repository:bitbucket, write:repository:bitbucket, '
233
+ + 'read:pullrequest:bitbucket and write:pullrequest:bitbucket';
234
+
235
+ /** The actionable one-liner, worded for a member/workspace when known. */
236
+ function provisionCommandLine(member, workspace) {
237
+ return `provision_vcs_auth member_name=${member || 'MEMBER'} provider=bitbucket `
238
+ + `workspace=${workspace || 'WORKSPACE'} api_token={{secret.${DEFAULT_API_TOKEN_SECRET}}}`;
239
+ }
240
+
241
+ /** Long-form background for the remedy -- everything after the one-line fix.
242
+ * Kept separate so a context-aware remedy (credentialRemedy below) can lead
243
+ * with its own member-specific fix line and still carry the same detail. */
244
+ const AUTH_REMEDY_DETAIL =
245
+ 'Bitbucket credentials cannot be minted by the fleet: an operator creates '
246
+ + 'an Atlassian API token at '
247
+ + 'https://id.atlassian.com/manage-profile/security/api-tokens ("Create API '
248
+ + 'token with scopes", app Bitbucket, scopes read:repository:bitbucket, '
249
+ + 'write:repository:bitbucket, read:pullrequest:bitbucket and '
250
+ + 'write:pullrequest:bitbucket), stores it with '
251
+ + `credential_store_set name=${DEFAULT_API_TOKEN_SECRET}, then runs provision_vcs_auth `
252
+ + 'member_name=MEMBER provider=bitbucket '
253
+ + `workspace=WORKSPACE api_token={{secret.${DEFAULT_API_TOKEN_SECRET}}}. `
254
+ + 'Bitbucket app passwords are deprecated: replace an existing one with an '
255
+ + 'API token the same way. Two cautions: (1) a member holds ONE VCS '
256
+ + 'credential, so provisioning Bitbucket on a backlog member already '
257
+ + 'provisioned for another provider (e.g. GitHub) replaces that credential '
258
+ + '-- use a backlog member dedicated to Bitbucket; (2) on a LOCAL member '
259
+ + 'provision_vcs_auth rewrites the host\'s own global bitbucket.org git '
260
+ + 'credential helper, which can break the operator\'s HTTPS git -- provision '
261
+ + 'a non-local member, or keep the local member on SSH (Atlassian is moving '
262
+ + 'git-over-SSH to ssh.bitbucket.org: use '
263
+ + 'git@ssh.bitbucket.org:WORKSPACE/REPO.git for SSH remotes). A LOCAL member '
264
+ + 'provisioned by fleet 0.4.4 still has a helper with the old account-login '
265
+ + 'username; the sprint never re-provisions a local member, so it fails its '
266
+ + 'credential probe until it is re-provisioned by hand, once: '
267
+ + 'provision_vcs_auth member_name=MEMBER provider=bitbucket workspace=WORKSPACE '
268
+ + `api_token={{secret.${DEFAULT_API_TOKEN_SECRET}}} (this rewrites the host's `
269
+ + 'global bitbucket.org helper to the fixed username x-bitbucket-api-token-auth). '
270
+ + 'Without a deployed '
271
+ + 'credential the sprint still completes: no PR is opened and target '
272
+ + 'issues are closed directly on PASS.';
273
+
274
+ /** The generic remedy (no member/workspace/store knowledge): the actionable
275
+ * line FIRST, then the background. */
276
+ const AUTH_REMEDY_HINT = 'Fix: store an Atlassian API token with '
277
+ + `credential_store_set name=${DEFAULT_API_TOKEN_SECRET}, then run `
278
+ + `${provisionCommandLine()}. ${AUTH_REMEDY_DETAIL}`;
279
+
280
+ /**
281
+ * The remedy for a Bitbucket credential that was refused, worded for what
282
+ * the caller actually knows. Leads with ONE actionable line:
283
+ * - the credential store HAS `bitbucket_api_token` -> re-provision the
284
+ * member from it (exact provision_vcs_auth line). Never tells the
285
+ * operator to create a new token: the token they need is already stored,
286
+ * and the deployed helper is what is wrong (e.g. a repository access
287
+ * token or a stale username written by something other than the fleet).
288
+ * - no such entry (or the store could not be read) -> store a token, then
289
+ * the same provision line, followed by the long creation guidance.
290
+ * `local` true/false/undefined words the host-helper caution for a local,
291
+ * remote or unknown member type. ASCII only; secrets appear only as the
292
+ * {{secret.NAME}} placeholder.
293
+ *
294
+ * @param {{ availableSecrets?: string[]|null, memberName?: string,
295
+ * workspace?: string, repoRef?: { workspace?: string }|null,
296
+ * repo?: string, local?: boolean }} [ctx]
297
+ * @returns {string}
298
+ */
299
+ function credentialRemedy(ctx = {}) {
300
+ const member = ctx.memberName || 'MEMBER';
301
+ const workspace = workspaceFromCtx(ctx) || 'WORKSPACE';
302
+ const line = provisionCommandLine(member, workspace);
303
+ const helperNote = ctx.local === true
304
+ ? ' (this member is LOCAL: that command rewrites the host\'s global bitbucket.org git credential helper)'
305
+ : ctx.local === false
306
+ ? ''
307
+ : ' (on a LOCAL member that command rewrites the host\'s global bitbucket.org git credential helper)';
308
+ const stored = Array.isArray(ctx.availableSecrets) && ctx.availableSecrets.includes(DEFAULT_API_TOKEN_SECRET);
309
+ if (stored) {
310
+ return `Fix: re-provision member '${member}' from the stored ${DEFAULT_API_TOKEN_SECRET}: ${line}${helperNote}. `
311
+ + `That entry must carry ${REQUIRED_TOKEN_SCOPES}; if the refused credential IS that stored entry, `
312
+ + `update the ${DEFAULT_API_TOKEN_SECRET} entry (credential_store_set) to a token with those scopes before re-provisioning.`;
313
+ }
314
+ const why = Array.isArray(ctx.availableSecrets)
315
+ ? `the credential store has no ${DEFAULT_API_TOKEN_SECRET} entry`
316
+ : `the credential store could not be read to look for ${DEFAULT_API_TOKEN_SECRET}`;
317
+ return `Fix: ${why}; store an Atlassian API token with credential_store_set name=${DEFAULT_API_TOKEN_SECRET}, `
318
+ + `then run ${line}${helperNote}. ${AUTH_REMEDY_DETAIL}`;
319
+ }
320
+
321
+ function workspaceFromCtx(ctx) {
322
+ if (ctx && typeof ctx.workspace === 'string' && ctx.workspace.trim()) return ctx.workspace.trim();
323
+ if (ctx && ctx.repoRef && typeof ctx.repoRef.workspace === 'string' && ctx.repoRef.workspace.trim()) return ctx.repoRef.workspace.trim();
324
+ if (ctx && typeof ctx.repo === 'string' && ctx.repo.includes('/')) return ctx.repo.split('/')[0].trim();
325
+ return '';
326
+ }
327
+
328
+ function repoFromCtx(ctx) {
329
+ if (ctx && ctx.repoRef && typeof ctx.repoRef.repo === 'string' && ctx.repoRef.repo.trim()) return ctx.repoRef.repo.trim();
330
+ if (ctx && typeof ctx.repo === 'string' && ctx.repo.includes('/')) return ctx.repo.split('/').slice(1).join('/').trim();
331
+ return '';
332
+ }
333
+
334
+ const authRemedy = Object.freeze({
335
+ // An API token is created by a human against an Atlassian identity;
336
+ // nothing server-side can re-mint one. Same answer ./azure-devops.mjs
337
+ // gives for its PATs, and what makes the shared self-heal print the hint
338
+ // above BEFORE it attempts a re-provision that cannot help.
339
+ serverSideReMintable: false,
340
+ hint: AUTH_REMEDY_HINT,
341
+ });
342
+
343
+ /** Printable-ASCII, length-capped copy of a value read off a response (a
344
+ * header or a body field): it is quoted into an operator-facing log line. */
345
+ function asciiField(value, max = 200) {
346
+ return String(value == null ? '' : value).replace(/[^\x20-\x7e]+/g, ' ').trim().slice(0, max);
347
+ }
348
+
349
+ /** Case-insensitive header lookup over the `{ lowercased-name: value }` map
350
+ * parseVcsCurlOutput builds from curl's `-D -` dump. */
351
+ function headerValue(headers, name) {
352
+ if (!headers || typeof headers !== 'object') return '';
353
+ const key = Object.keys(headers).find((k) => k.toLowerCase() === name);
354
+ return key ? asciiField(headers[key]) : '';
355
+ }
356
+
357
+ /** Bitbucket's error.detail.required / .granted: an array of scope names
358
+ * (or, defensively, a comma/space separated string). */
359
+ function scopeList(value) {
360
+ const raw = Array.isArray(value) ? value : (typeof value === 'string' ? value.split(/[\s,]+/) : []);
361
+ return raw.map((s) => asciiField(s, 80)).filter(Boolean).slice(0, 20);
362
+ }
363
+
364
+ /**
365
+ * The credential-and-scope facts Bitbucket returns with a refusal, read off
366
+ * the X-Credential-Type / X-OAuth-Scopes response headers and the body's
367
+ * error.detail.{required,granted}. Every field is '' / [] when absent.
368
+ */
369
+ function refusalFacts(ctx) {
370
+ const detail = ctx && ctx.body && ctx.body.error && typeof ctx.body.error === 'object' ? ctx.body.error.detail : null;
371
+ return {
372
+ type: headerValue(ctx && ctx.headers, 'x-credential-type'),
373
+ oauthScopes: headerValue(ctx && ctx.headers, 'x-oauth-scopes'),
374
+ required: scopeList(detail && typeof detail === 'object' ? detail.required : null),
375
+ granted: scopeList(detail && typeof detail === 'object' ? detail.granted : null),
376
+ };
377
+ }
378
+
379
+ /** Diagnosis text for a 401/403/404 refusal. Says "API token" ONLY when the
380
+ * response says the credential IS one (X-Credential-Type api_token); an
381
+ * absent header is worded as an unknown credential type, never assumed. */
382
+ function describeRefusal(status, ctx) {
383
+ const facts = refusalFacts(ctx);
384
+ const subject = facts.type === 'api_token'
385
+ ? 'the Bitbucket API token (X-Credential-Type api_token)'
386
+ : facts.type
387
+ ? `the Bitbucket credential of type ${facts.type} (X-Credential-Type)`
388
+ : 'the Bitbucket credential (type unknown: the response carried no X-Credential-Type header)';
389
+ const notDeployed = facts.type && facts.type !== 'api_token'
390
+ ? `; a ${facts.type} is not the Atlassian API token provision_vcs_auth deploys, so the helper was written by something else`
391
+ : '';
392
+ const scopes = [
393
+ facts.required.length ? `required: ${facts.required.join(', ')}` : '',
394
+ facts.granted.length ? `granted: ${facts.granted.join(', ')}` : '',
395
+ facts.oauthScopes ? `X-OAuth-Scopes: ${facts.oauthScopes}` : '',
396
+ ].filter(Boolean).join('; ');
397
+ const scopeTail = scopes ? ` (${scopes})` : '';
398
+ const ws = workspaceFromCtx(ctx);
399
+ const repo = repoFromCtx(ctx);
400
+ const target = ws && repo ? `repository ${ws}/${repo}` : 'the repository';
401
+ if (status === 401) {
402
+ return `${subject} was rejected (HTTP 401): it is expired, revoked or not a valid Bitbucket credential${scopeTail}${notDeployed}.`;
403
+ }
404
+ if (status === 404) {
405
+ return `${subject} cannot see ${target} (HTTP 404): it was issued for a different repository or workspace, or has no read access to this one${scopeTail}${notDeployed}.`;
406
+ }
407
+ // 403
408
+ const needs = facts.required.length || facts.type ? '' : `; an API token needs ${REQUIRED_TOKEN_SCOPES}`;
409
+ return `${subject} is missing a required scope (HTTP 403)${scopeTail}${notDeployed}${needs}.`;
410
+ }
411
+
412
+ /**
413
+ * Explain a Bitbucket REST HTTP failure the way an operator can act on it --
414
+ * the OPTIONAL `httpFailureHint` provider hook (see ./index.mjs).
415
+ *
416
+ * Two call shapes:
417
+ * httpFailureHint(status) legacy: returns a diagnosis string ('' when the
418
+ * status has none). No headers, so the credential type is unknown.
419
+ * httpFailureHint({ status, body, headers, availableSecrets, memberName,
420
+ * workspace|repoRef|repo, local }) returns { hint, remedy }:
421
+ * `hint` diagnoses the refusal from the response itself (credential
422
+ * type from X-Credential-Type, error.detail.required/granted,
423
+ * X-OAuth-Scopes); `remedy` is the member-specific fix
424
+ * (credentialRemedy above) that REPLACES the generic authRemedy.hint
425
+ * for this failure. Both '' for a status with nothing to say.
426
+ *
427
+ * 410: Atlassian retired app passwords (CHANGE-3222). 401/403/404: a refused
428
+ * credential (see describeRefusal). Anything else: nothing. No header value
429
+ * or body field is quoted except as sanitized ASCII, and none of them can
430
+ * carry the request's Authorization header (curl's `-D -` dumps RESPONSE
431
+ * headers only).
432
+ *
433
+ * @param {number|null|undefined|object} statusOrCtx
434
+ * @returns {string|{ hint: string, remedy: string }}
435
+ */
436
+ function httpFailureHint(statusOrCtx) {
437
+ const withCtx = statusOrCtx !== null && typeof statusOrCtx === 'object';
438
+ const ctx = withCtx ? statusOrCtx : { status: statusOrCtx };
439
+ const { status } = ctx;
440
+ let hint = '';
441
+ if (status === 410) {
442
+ hint = 'Bitbucket app passwords have been retired (Atlassian CHANGE-3222); '
443
+ + 'replace the app password with an Atlassian API token stored as '
444
+ + `${DEFAULT_API_TOKEN_SECRET}.`;
445
+ } else if (status === 403 || (withCtx && (status === 401 || status === 404))) {
446
+ hint = describeRefusal(status, ctx);
447
+ }
448
+ if (!withCtx) return hint;
449
+ return { hint, remedy: hint ? credentialRemedy(ctx) : '' };
450
+ }
451
+
452
+ /**
453
+ * Build the provision_vcs_auth arguments for a Bitbucket member -- the
454
+ * OPTIONAL descriptor hook described in ./index.mjs's REQUIRED EXPORT SHAPE.
455
+ * See the section header above for the full reasoning behind each branch.
456
+ *
457
+ * @param {{ base: object, repoRef: ({ workspace: string }|null|undefined),
458
+ * availableSecrets: string[]|null, remoteUrl?: string,
459
+ * remoteReadError?: string|null }} ctx
460
+ * @returns {{ args: object, note?: string }|{ skip: true, note?: string }|{ error: string }}
461
+ */
462
+ function buildProvisionArgs(ctx) {
463
+ const { base = {}, repoRef, availableSecrets, remoteUrl, remoteReadError } = ctx || {};
464
+ const workspace = repoRef && typeof repoRef.workspace === 'string' ? repoRef.workspace.trim() : '';
465
+ if (!workspace) {
466
+ const raw = typeof remoteUrl === 'string' ? remoteUrl.trim() : '';
467
+ const why = remoteReadError
468
+ ? `the member's git remote could not be read (${remoteReadError})`
469
+ : raw
470
+ ? `the member's git remote '${raw}' is not a recognized Bitbucket repository URL`
471
+ : "no workspace could be derived from the member's git remote";
472
+ return {
473
+ error: `ERROR: cannot provision Bitbucket auth for member '${base.member_name}': ${why}; expected a remote of the shape ${REPO_REF_HINT}`,
474
+ };
475
+ }
476
+
477
+ if (base.git_access === 'push+pr') {
478
+ return {
479
+ skip: true,
480
+ note: `member '${base.member_name}' is on Bitbucket, whose credential has no just-in-time scope axis to widen and cannot be re-assembled by the fleet; keeping the credential already deployed for workspace '${workspace}' and going straight to the pull-request call`,
481
+ };
482
+ }
483
+
484
+ const name = DEFAULT_API_TOKEN_SECRET;
485
+ if (Array.isArray(availableSecrets) && !availableSecrets.includes(name)) {
486
+ return {
487
+ error: `ERROR: cannot provision Bitbucket auth for member '${base.member_name}': the credential store has no entry named '${name}'. ${AUTH_REMEDY_HINT}`,
488
+ };
489
+ }
490
+
491
+ return {
492
+ args: {
493
+ member_name: base.member_name,
494
+ provider: base.provider,
495
+ git_access: base.git_access,
496
+ ...(base.repos ? { repos: base.repos } : {}),
497
+ workspace,
498
+ // Placeholder, NOT a value -- resolved hub-side. Always present,
499
+ // so provision_vcs_auth's missing-api_token out-of-band prompt is
500
+ // unreachable from this path.
501
+ api_token: `{{secret.${name}}}`,
502
+ },
503
+ note: `member '${base.member_name}' is on Bitbucket: providing workspace '${workspace}' and the '${name}' credential-store token placeholder.`,
504
+ };
505
+ }
506
+
507
+ // ---------------------------------------------------------------------------
508
+ // REST command builder (apra-fleet-qeq1.3)
509
+ // ---------------------------------------------------------------------------
510
+ //
511
+ // PARAMETER CONTRACT (the shape buildVcsCommand() hands this builder, the
512
+ // same convention azure-devops.mjs documents for its own builders):
513
+ //
514
+ // provider 'bitbucket'
515
+ // repoRef OPTIONAL { workspace, repo } -- parseRepoRef()'s own output.
516
+ // Individual workspace/repo params take PRECEDENCE over the
517
+ // matching repoRef field, same rule assertRepoCoords() below
518
+ // applies.
519
+ // workspace/repo the two coordinates every Bitbucket REST call needs.
520
+ // Both required after the repoRef merge; a missing one is a
521
+ // typed ERROR naming the expected remote shape, never a
522
+ // half-built URL.
523
+ // base/head branch names, GitHub's own vocabulary (see azure-devops.mjs) --
524
+ // Bitbucket's own payload names them source/destination, mapped
525
+ // below.
526
+ // title/body PR title and description.
527
+ // token the Atlassian API token. REQUIRED -- assertToken() throws
528
+ // the shared typed ERROR.
529
+ // os/shell same meaning and same resolution as azure-devops.mjs documents.
530
+ //
531
+ // AUTH: `-H 'Authorization: Bearer <token>'` -- no username, no email. The
532
+ // token appears in `command` ONLY; `logSafeCommand` is built by the SAME
533
+ // closure with REDACTED substituted, so no other field can carry it.
534
+
535
+ /** Same fixed marker github.mjs/azure-devops.mjs use, so a log scrubber/
536
+ * assertion looking for a redacted VCS command matches identically across
537
+ * providers. */
538
+ const REDACTED = '***REDACTED***';
539
+
540
+ /** curl's `-D -`: dump the RESPONSE header block to stdout ahead of the body,
541
+ * so a refusal's X-Credential-Type / X-OAuth-Scopes reach
542
+ * parseVcsCurlOutput (vcs-auth.mjs) alongside the body and the `-w` status
543
+ * line. A bare `-` is inert in POSIX sh, Git-for-Windows bash and
544
+ * PowerShell alike, and works for curl and curl.exe. Response headers only:
545
+ * the request's Authorization header is never written back. */
546
+ const DUMP_RESPONSE_HEADERS = '-D -';
547
+
548
+ /** Merge a `repoRef` object with any explicit workspace/repo overrides and
549
+ * require both. Throws the typed ERROR (quoting REPO_REF_HINT) rather than
550
+ * building a partial URL -- mirrors azure-devops.mjs's assertRepoCoords(). */
551
+ function assertRepoCoords(params, action) {
552
+ const ref = (params && typeof params.repoRef === 'object' && params.repoRef) ? params.repoRef : {};
553
+ const pick = (key) => {
554
+ const own = params && params[key] != null ? params[key] : ref[key];
555
+ return String(own ?? '').trim();
556
+ };
557
+ const workspace = pick('workspace');
558
+ const repo = pick('repo');
559
+ const missing = [['workspace', workspace], ['repo', repo]].filter(([, v]) => !v).map(([k]) => k);
560
+ if (missing.length > 0) {
561
+ throw new Error(`ERROR: VCSModule: bitbucket "${action}" needs workspace and repo (missing: ${missing.join(', ')}) -- pass them explicitly or as the repoRef parsed from a remote of the shape ${REPO_REF_HINT}.`);
562
+ }
563
+ const slashed = [['workspace', workspace], ['repo', repo]].filter(([, v]) => v.includes('/'));
564
+ if (slashed.length > 0) {
565
+ throw new Error(`ERROR: VCSModule: bitbucket "${action}" got a '/' inside ${slashed.map(([k]) => k).join(', ')} -- pass the workspace/repo coordinates SEPARATELY, not a combined "workspace/repo" string, per the remote shape ${REPO_REF_HINT}.`);
566
+ }
567
+ return { workspace, repo };
568
+ }
569
+
570
+ /** The workspace/repo REST prefix, each coordinate percent-encoded per
571
+ * segment (same convention azure-devops.mjs's repoApiBase() follows). */
572
+ function repoApiBase({ workspace, repo }) {
573
+ return `https://api.bitbucket.org/2.0/repositories/${encodeURIComponent(workspace)}/${encodeURIComponent(repo)}`;
574
+ }
575
+
576
+ /**
577
+ * Build the Bitbucket REST "create pull request" curl command.
578
+ * POST https://api.bitbucket.org/2.0/repositories/{workspace}/{repo}/pullrequests
579
+ * -- see https://developer.atlassian.com/cloud/bitbucket/rest/api-group-pullrequests/#api-repositories-workspace-repo-slug-pullrequests-post
580
+ */
581
+ function buildBitbucketCreatePrCommand(params) {
582
+ const { base, head, title, body, token, os, shell } = params || {};
583
+ const coords = assertRepoCoords(params, 'create-pull-request');
584
+ const safeToken = assertToken(token);
585
+ if (!base) throw new Error('ERROR: VCSModule: "base" branch is required to build a create-pull-request command.');
586
+ if (!head) throw new Error('ERROR: VCSModule: "head" branch is required to build a create-pull-request command.');
587
+ if (!title) throw new Error('ERROR: VCSModule: "title" is required to build a create-pull-request command.');
588
+
589
+ const payload = {
590
+ title,
591
+ source: { branch: { name: head } },
592
+ destination: { branch: { name: base } },
593
+ };
594
+ if (body !== undefined) payload.description = body;
595
+ const payloadJson = JSON.stringify(payload);
596
+ const url = `${repoApiBase(coords)}/pullrequests`;
597
+
598
+ const buildCurl = (authToken) => [
599
+ `${curlBinary(os)} -sS -X POST`,
600
+ `-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
601
+ `-H ${shQuote('Content-Type: application/json', os, shell)}`,
602
+ `-H ${shQuote('Accept: application/json', os, shell)}`,
603
+ `-d ${shQuoteJson(payloadJson, os, shell)}`,
604
+ `-w ${shQuote('\n%{http_code}', os, shell)}`,
605
+ DUMP_RESPONSE_HEADERS,
606
+ url,
607
+ ].join(' ');
608
+
609
+ return {
610
+ provider: 'bitbucket',
611
+ action: 'create-pull-request',
612
+ command: buildCurl(safeToken),
613
+ logSafeCommand: buildCurl(REDACTED),
614
+ // Interpretation contract, same field NAMES github.mjs/
615
+ // azure-devops.mjs use so a consumer reads it generically:
616
+ // - 2xx -> success
617
+ // - anything else -> error
618
+ // NO already-exists status/pattern: Bitbucket's API reference does
619
+ // not document the duplicate source/destination response (POST lists
620
+ // only 201/400/401), and an unverified dialect stays ABSENT rather
621
+ // than guessed. Instead `probeExistingOnFailure` asks the shared
622
+ // caller (vcs-auth.mjs raiseVcsPrForMember) to look up an open PR for
623
+ // head -> base via the find-pull-request builder below on any non-2xx,
624
+ // non-auth create failure, and treat a hit as already-exists.
625
+ interpret: {
626
+ successStatusRange: [200, 299],
627
+ probeExistingOnFailure: true,
628
+ },
629
+ };
630
+ }
631
+
632
+ /** Escape a value for a double-quoted BBQL string literal. */
633
+ function bbqlString(value) {
634
+ return `"${String(value).replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
635
+ }
636
+
637
+ /**
638
+ * Build the Bitbucket REST "find the open pull request for head -> base"
639
+ * curl command, used on the already-exists path to learn the existing PR's id
640
+ * and current description.
641
+ * GET .../pullrequests?state=OPEN&q=source.branch.name="H" AND destination.branch.name="B"
642
+ * -- see https://developer.atlassian.com/cloud/bitbucket/rest/intro/#filtering
643
+ * The whole BBQL expression is percent-encoded, so no literal double quote
644
+ * reaches the member shell (PowerShell 5.1 strips embedded double quotes from
645
+ * native-exe arguments); the URL carries '&', so it is quoted.
646
+ */
647
+ function buildBitbucketFindPrCommand(params) {
648
+ const { base, head, token, os, shell } = params || {};
649
+ const coords = assertRepoCoords(params, 'find-pull-request');
650
+ const safeToken = assertToken(token);
651
+ if (!base) throw new Error('ERROR: VCSModule: "base" branch is required to build a find-pull-request command.');
652
+ if (!head) throw new Error('ERROR: VCSModule: "head" branch is required to build a find-pull-request command.');
653
+ const bbql = `source.branch.name=${bbqlString(head)} AND destination.branch.name=${bbqlString(base)}`;
654
+ // `fields` asks for exactly what the update path needs, so the existing
655
+ // description (which carries the run history) is never left out of a
656
+ // partial list representation, plus the source repository for the
657
+ // fork filter in mapResponse.
658
+ const fields = [
659
+ 'values.id', 'values.title', 'values.description', 'values.summary.raw',
660
+ 'values.links.html.href', 'values.source.repository.full_name',
661
+ ].join(',');
662
+ const url = `${repoApiBase(coords)}/pullrequests?state=OPEN&q=${encodeURIComponent(bbql)}&fields=${encodeURIComponent(fields)}`;
663
+ const ownFullName = `${coords.workspace}/${coords.repo}`.toLowerCase();
664
+
665
+ const buildCurl = (authToken) => [
666
+ `${curlBinary(os)} -sS -X GET`,
667
+ `-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
668
+ `-H ${shQuote('Accept: application/json', os, shell)}`,
669
+ `-w ${shQuote('\n%{http_code}', os, shell)}`,
670
+ DUMP_RESPONSE_HEADERS,
671
+ shQuote(url, os, shell),
672
+ ].join(' ');
673
+
674
+ return {
675
+ provider: 'bitbucket',
676
+ action: 'find-pull-request',
677
+ command: buildCurl(safeToken),
678
+ logSafeCommand: buildCurl(REDACTED),
679
+ interpret: { successStatusRange: [200, 299] },
680
+ /** 2xx body ({ values: [...] }) -> [{ id, title, body, url }]. */
681
+ // A PR from a FORK with the same branch name is not this sprint's PR:
682
+ // drop any entry whose source repository is a different repo
683
+ // (compared case-insensitively; an entry without the field is kept).
684
+ mapResponse: (respBody) => {
685
+ const list = respBody && Array.isArray(respBody.values) ? respBody.values : [];
686
+ return list
687
+ .filter((pr) => {
688
+ const fullName = pr && pr.source && pr.source.repository && pr.source.repository.full_name;
689
+ return typeof fullName !== 'string' || fullName.toLowerCase() === ownFullName;
690
+ })
691
+ .map(mapBitbucketPull)
692
+ .filter((p) => p.id !== null);
693
+ },
694
+ };
695
+ }
696
+
697
+ /**
698
+ * Build the Bitbucket REST "update a pull request" curl command (title +
699
+ * description). Bitbucket uses PUT (not PATCH) and only open pull requests
700
+ * can be mutated: PUT .../pullrequests/{id} -- see
701
+ * https://developer.atlassian.com/cloud/bitbucket/rest/api-group-pullrequests/#api-repositories-workspace-repo-slug-pullrequests-pull-request-id-put
702
+ */
703
+ function buildBitbucketUpdatePrCommand(params) {
704
+ const { pull_request_id: pullRequestId, title, body, token, os, shell } = params || {};
705
+ const coords = assertRepoCoords(params, 'update-pull-request');
706
+ const safeToken = assertToken(token);
707
+ const id = String(pullRequestId ?? '').trim();
708
+ if (!/^\d+$/.test(id)) throw new Error('ERROR: VCSModule: a numeric "pull_request_id" is required to build an update-pull-request command.');
709
+ if (!title) throw new Error('ERROR: VCSModule: "title" is required to build an update-pull-request command.');
710
+
711
+ const payload = { title };
712
+ if (body !== undefined) payload.description = body;
713
+ const payloadJson = JSON.stringify(payload);
714
+ const url = `${repoApiBase(coords)}/pullrequests/${id}`;
715
+
716
+ const buildCurl = (authToken) => [
717
+ `${curlBinary(os)} -sS -X PUT`,
718
+ `-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
719
+ `-H ${shQuote('Content-Type: application/json', os, shell)}`,
720
+ `-H ${shQuote('Accept: application/json', os, shell)}`,
721
+ `-d ${shQuoteJson(payloadJson, os, shell)}`,
722
+ `-w ${shQuote('\n%{http_code}', os, shell)}`,
723
+ DUMP_RESPONSE_HEADERS,
724
+ url,
725
+ ].join(' ');
726
+
727
+ return {
728
+ provider: 'bitbucket',
729
+ action: 'update-pull-request',
730
+ command: buildCurl(safeToken),
731
+ logSafeCommand: buildCurl(REDACTED),
732
+ interpret: { successStatusRange: [200, 299] },
733
+ mapResponse: (respBody) => mapBitbucketPull(respBody),
734
+ };
735
+ }
736
+
737
+ /**
738
+ * Build the preflight's REST credential probe: GET
739
+ * .../repositories/{workspace}/{repo}/pullrequests?pagelen=1 -- the
740
+ * cheapest call that needs exactly what Publish PR will need (repository
741
+ * visibility plus read:pullrequest), sent with the SAME labelled credential
742
+ * the PR path reads (the caller passes the {{vcs_token_inline}} placeholder
743
+ * and dispatches through vcs_credential_exec). `git ls-remote` alone cannot
744
+ * prove this: it goes through the host's whole git credential helper chain,
745
+ * where another helper can answer for a fleet helper that is broken.
746
+ * Same Bearer auth, -D - header capture and -w status line as the PR
747
+ * builders, so a refusal parses into the same { status, body, headers }
748
+ * httpFailureHint diagnoses.
749
+ */
750
+ function buildBitbucketCredentialProbeCommand(params) {
751
+ const { token, os, shell } = params || {};
752
+ const coords = assertRepoCoords(params, 'credential-probe');
753
+ const safeToken = assertToken(token);
754
+ const url = `${repoApiBase(coords)}/pullrequests?pagelen=1`;
755
+ const buildCurl = (authToken) => [
756
+ `${curlBinary(os)} -sS -X GET`,
757
+ `-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
758
+ `-H ${shQuote('Accept: application/json', os, shell)}`,
759
+ `-w ${shQuote('\n%{http_code}', os, shell)}`,
760
+ DUMP_RESPONSE_HEADERS,
761
+ shQuote(url, os, shell),
762
+ ].join(' ');
763
+ return {
764
+ provider: 'bitbucket',
765
+ action: 'credential-probe',
766
+ command: buildCurl(safeToken),
767
+ logSafeCommand: buildCurl(REDACTED),
768
+ interpret: { successStatusRange: [200, 299] },
769
+ };
770
+ }
771
+
772
+ /** The OPTIONAL `credentialProbe` descriptor field (see ./index.mjs): what
773
+ * the VCS preflight checks on the labelled credential, beyond git ls-remote.
774
+ * build the REST probe command builder above
775
+ * expectedUsername the only username= line a fleet-deployed helper has
776
+ * remedy(ctx) the member-specific fix, worded by credential store
777
+ * contents (credentialRemedy above) */
778
+ const credentialProbe = Object.freeze({
779
+ build: buildBitbucketCredentialProbeCommand,
780
+ expectedUsername: TOKEN_USERNAME,
781
+ remedy: credentialRemedy,
782
+ });
783
+
784
+ // ---------------------------------------------------------------------------
785
+ // Pull-request RESPONSE mapping (apra-fleet-qeq1.3)
786
+ // ---------------------------------------------------------------------------
787
+ //
788
+ // Bitbucket's create-pull-request 2xx body speaks a THIRD dialect: the
789
+ // numeric id is flat at `id` (like Azure DevOps' `pullRequestId` is flat, but
790
+ // named differently), while the browsable web URL is NESTED at
791
+ // `links.html.href` -- contrast github.mjs, which reads a flat `html_url`.
792
+
793
+ const PR_ID_FIELD = 'id';
794
+
795
+ /** Map a Bitbucket create-pull-request response body to { id, url }. Reads
796
+ * the DECLARED id field above and walks the nested links.html.href path;
797
+ * either a missing id or a missing/malformed nested path degrades to `null`
798
+ * rather than throwing, so an otherwise successful PR is never turned into
799
+ * a crash. `ctx` is unused -- Bitbucket's body already carries the
800
+ * browsable URL, so there is nothing to construct (contrast
801
+ * azure-devops.mjs). */
802
+ function mapPullRequestResponse(body, _ctx) {
803
+ const source = (body && typeof body === 'object') ? body : {};
804
+ const rawId = source[PR_ID_FIELD];
805
+ let id = null;
806
+ if (typeof rawId === 'number' && Number.isFinite(rawId)) id = rawId;
807
+ else if (typeof rawId === 'string' && /^\d+$/.test(rawId.trim())) id = Number(rawId.trim());
808
+ const rawUrl = source.links && typeof source.links === 'object'
809
+ && source.links.html && typeof source.links.html === 'object'
810
+ ? source.links.html.href
811
+ : null;
812
+ return { id, url: typeof rawUrl === 'string' ? rawUrl : null };
813
+ }
814
+
815
+ /** One Bitbucket pull-request object (list entry or single) -> the
816
+ * provider-neutral { id, title, body, url } shape the existing-PR update
817
+ * path reads. */
818
+ function mapBitbucketPull(pr) {
819
+ const src = (pr && typeof pr === 'object') ? pr : {};
820
+ const { id, url } = mapPullRequestResponse(src);
821
+ return {
822
+ id,
823
+ title: typeof src.title === 'string' ? src.title : '',
824
+ // description, falling back to summary.raw (same markdown source).
825
+ body: typeof src.description === 'string' ? src.description
826
+ : (src.summary && typeof src.summary.raw === 'string') ? src.summary.raw : '',
827
+ url,
828
+ };
829
+ }
830
+
831
+ const pullRequestResponse = Object.freeze({
832
+ idField: PR_ID_FIELD,
833
+ // The web URL is NESTED, not a flat field -- see the header note above.
834
+ webUrlField: 'links.html.href',
835
+ // Read from the body, never constructed -- contrast azure-devops.mjs.
836
+ webUrlTemplate: null,
837
+ map: mapPullRequestResponse,
838
+ });
839
+
70
840
  export const BitbucketVCS = Object.freeze({
71
841
  name: 'bitbucket',
72
842
  extends: 'generic-git',
73
843
  rules: Object.freeze({
74
844
  [K.AUTH_EXPIRED]: AUTH_EXPIRED,
75
845
  }),
846
+ httpFailureHint,
76
847
  matchesHost,
848
+ capabilitiesForHost,
849
+ // remote-URL -> { workspace, repo, canonical }, mirroring
850
+ // ./azure-devops.mjs's own parseRepoRef axis (apra-fleet-qeq1.2).
851
+ parseRepoRef,
852
+ repoRefHint: REPO_REF_HINT,
853
+ // apra-fleet-qeq1.9: OPTIONAL descriptor hook -- see ./index.mjs and the
854
+ // "Provisioning" section above for why the push+pr level skips.
855
+ buildProvisionArgs,
856
+ // apra-fleet-qeq1.9: API tokens are never minted server-side -- see
857
+ // above.
858
+ authRemedy,
859
+ // Preflight checks the labelled PR credential itself (REST probe +
860
+ // username line), not only git ls-remote -- see credentialProbe above.
861
+ credentialProbe,
862
+ // Create is not an upsert: look the open PR up first and update it.
863
+ findBeforeCreate: true,
77
864
  defaultAuthMode: null,
78
- builders: null,
865
+ // create/find/update pull-request builders; capabilitiesForHost lets the
866
+ // Publish PR phase dispatch them via VCSModule.capabilities().
867
+ builders: Object.freeze({
868
+ 'create-pull-request': buildBitbucketCreatePrCommand,
869
+ 'find-pull-request': buildBitbucketFindPrCommand,
870
+ 'update-pull-request': buildBitbucketUpdatePrCommand,
871
+ }),
872
+ pullRequestResponse,
79
873
  });
80
874
 
81
875
  export default BitbucketVCS;