@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.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- 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
|
|
11
|
-
*
|
|
12
|
-
* see ./azure-devops.mjs)
|
|
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
|
|
27
|
-
* git's generic "fatal: Authentication failed" tail (e.g. over a
|
|
28
|
-
* that does not append it). The text says "expired" outright, and
|
|
29
|
-
* re-provisioning a fresh
|
|
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.
|
|
57
|
-
*
|
|
58
|
-
*
|
|
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
|
|
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;
|