@apralabs/apra-fleet 0.3.5 → 0.4.0
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 +245 -257
- package/dist/agents/backlog-groomer.md +287 -0
- package/dist/agents/deployer.md +52 -11
- package/dist/agents/doer.md +32 -7
- package/dist/agents/integ-test-runner.md +151 -61
- package/dist/agents/plan-reviewer.md +74 -17
- package/dist/agents/planner.md +94 -14
- package/dist/agents/regression-test-runner.md +216 -0
- package/dist/agents/reviewer.md +21 -6
- package/dist/agents/schemas/backlog-groomer-input.json +35 -0
- package/dist/agents/schemas/backlog-groomer-output.json +164 -0
- package/dist/agents/schemas/integ-test-runner-output.json +34 -0
- package/dist/agents/schemas/regression-test-runner-input.json +15 -0
- package/dist/agents/schemas/regression-test-runner-output.json +50 -0
- package/dist/agents/schemas/reviewer-output.json +4 -0
- package/dist/cli/agent-transform.d.ts +1 -0
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +77 -0
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts +3 -0
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +181 -5
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +5 -1
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +7 -1
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/dolt-install.d.ts +91 -0
- package/dist/cli/dolt-install.d.ts.map +1 -0
- package/dist/cli/dolt-install.js +334 -0
- package/dist/cli/dolt-install.js.map +1 -0
- package/dist/cli/install-guard.d.ts +29 -0
- package/dist/cli/install-guard.d.ts.map +1 -0
- package/dist/cli/install-guard.js +153 -0
- package/dist/cli/install-guard.js.map +1 -0
- package/dist/cli/install.d.ts +44 -3
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +604 -108
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/join.d.ts +12 -0
- package/dist/cli/join.d.ts.map +1 -0
- package/dist/cli/join.js +87 -0
- package/dist/cli/join.js.map +1 -0
- package/dist/cli/register-member.d.ts +2 -0
- package/dist/cli/register-member.d.ts.map +1 -0
- package/dist/cli/register-member.js +193 -0
- package/dist/cli/register-member.js.map +1 -0
- package/dist/cli/restart.d.ts +2 -0
- package/dist/cli/restart.d.ts.map +1 -0
- package/dist/cli/restart.js +7 -0
- package/dist/cli/restart.js.map +1 -0
- package/dist/cli/secret.js +8 -2
- package/dist/cli/secret.js.map +1 -1
- package/dist/cli/spoke.d.ts +35 -0
- package/dist/cli/spoke.d.ts.map +1 -0
- package/dist/cli/spoke.js +212 -0
- package/dist/cli/spoke.js.map +1 -0
- package/dist/cli/start.d.ts +2 -0
- package/dist/cli/start.d.ts.map +1 -0
- package/dist/cli/start.js +92 -0
- package/dist/cli/start.js.map +1 -0
- package/dist/cli/status.d.ts +2 -0
- package/dist/cli/status.d.ts.map +1 -0
- package/dist/cli/status.js +83 -0
- package/dist/cli/status.js.map +1 -0
- package/dist/cli/stop.d.ts +2 -0
- package/dist/cli/stop.d.ts.map +1 -0
- package/dist/cli/stop.js +51 -0
- package/dist/cli/stop.js.map +1 -0
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +109 -9
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/update.d.ts.map +1 -1
- package/dist/cli/update.js +10 -1
- package/dist/cli/update.js.map +1 -1
- package/dist/cli/workflow-assets.d.ts +37 -0
- package/dist/cli/workflow-assets.d.ts.map +1 -0
- package/dist/cli/workflow-assets.js +144 -0
- package/dist/cli/workflow-assets.js.map +1 -0
- package/dist/cli/workflow.d.ts +75 -0
- package/dist/cli/workflow.d.ts.map +1 -0
- package/dist/cli/workflow.js +397 -0
- package/dist/cli/workflow.js.map +1 -0
- package/dist/hub-service/activity.d.ts +30 -0
- package/dist/hub-service/activity.d.ts.map +1 -0
- package/dist/hub-service/activity.js +20 -0
- package/dist/hub-service/activity.js.map +1 -0
- package/dist/hub-service/audit-log.d.ts +19 -0
- package/dist/hub-service/audit-log.d.ts.map +1 -0
- package/dist/hub-service/audit-log.js +13 -0
- package/dist/hub-service/audit-log.js.map +1 -0
- package/dist/hub-service/db/pool.d.ts +19 -0
- package/dist/hub-service/db/pool.d.ts.map +1 -0
- package/dist/hub-service/db/pool.js +53 -0
- package/dist/hub-service/db/pool.js.map +1 -0
- package/dist/hub-service/enrollment.d.ts +29 -0
- package/dist/hub-service/enrollment.d.ts.map +1 -0
- package/dist/hub-service/enrollment.js +48 -0
- package/dist/hub-service/enrollment.js.map +1 -0
- package/dist/hub-service/envelope-routes.d.ts +46 -0
- package/dist/hub-service/envelope-routes.d.ts.map +1 -0
- package/dist/hub-service/envelope-routes.js +94 -0
- package/dist/hub-service/envelope-routes.js.map +1 -0
- package/dist/hub-service/handlers/installers.d.ts +14 -0
- package/dist/hub-service/handlers/installers.d.ts.map +1 -0
- package/dist/hub-service/handlers/installers.js +8 -0
- package/dist/hub-service/handlers/installers.js.map +1 -0
- package/dist/hub-service/http-server.d.ts +31 -0
- package/dist/hub-service/http-server.d.ts.map +1 -0
- package/dist/hub-service/http-server.js +711 -0
- package/dist/hub-service/http-server.js.map +1 -0
- package/dist/hub-service/hub-jwt.d.ts +30 -0
- package/dist/hub-service/hub-jwt.d.ts.map +1 -0
- package/dist/hub-service/hub-jwt.js +105 -0
- package/dist/hub-service/hub-jwt.js.map +1 -0
- package/dist/hub-service/jwt-revocation.d.ts +20 -0
- package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
- package/dist/hub-service/jwt-revocation.js +18 -0
- package/dist/hub-service/jwt-revocation.js.map +1 -0
- package/dist/hub-service/machines.d.ts +16 -0
- package/dist/hub-service/machines.d.ts.map +1 -0
- package/dist/hub-service/machines.js +14 -0
- package/dist/hub-service/machines.js.map +1 -0
- package/dist/hub-service/main.d.ts +3 -0
- package/dist/hub-service/main.d.ts.map +1 -0
- package/dist/hub-service/main.js +64 -0
- package/dist/hub-service/main.js.map +1 -0
- package/dist/hub-service/member-tokens.d.ts +11 -0
- package/dist/hub-service/member-tokens.d.ts.map +1 -0
- package/dist/hub-service/member-tokens.js +49 -0
- package/dist/hub-service/member-tokens.js.map +1 -0
- package/dist/hub-service/member-view.d.ts +20 -0
- package/dist/hub-service/member-view.d.ts.map +1 -0
- package/dist/hub-service/member-view.js +76 -0
- package/dist/hub-service/member-view.js.map +1 -0
- package/dist/hub-service/members.d.ts +44 -0
- package/dist/hub-service/members.d.ts.map +1 -0
- package/dist/hub-service/members.js +25 -0
- package/dist/hub-service/members.js.map +1 -0
- package/dist/hub-service/presence.d.ts +40 -0
- package/dist/hub-service/presence.d.ts.map +1 -0
- package/dist/hub-service/presence.js +44 -0
- package/dist/hub-service/presence.js.map +1 -0
- package/dist/hub-service/project-view.d.ts +12 -0
- package/dist/hub-service/project-view.d.ts.map +1 -0
- package/dist/hub-service/project-view.js +34 -0
- package/dist/hub-service/project-view.js.map +1 -0
- package/dist/hub-service/projects.d.ts +48 -0
- package/dist/hub-service/projects.d.ts.map +1 -0
- package/dist/hub-service/projects.js +80 -0
- package/dist/hub-service/projects.js.map +1 -0
- package/dist/hub-service/relay-queue.d.ts +115 -0
- package/dist/hub-service/relay-queue.d.ts.map +1 -0
- package/dist/hub-service/relay-queue.js +148 -0
- package/dist/hub-service/relay-queue.js.map +1 -0
- package/dist/hub-service/session-jwt.d.ts +10 -0
- package/dist/hub-service/session-jwt.d.ts.map +1 -0
- package/dist/hub-service/session-jwt.js +69 -0
- package/dist/hub-service/session-jwt.js.map +1 -0
- package/dist/hub-service/usage.d.ts +40 -0
- package/dist/hub-service/usage.d.ts.map +1 -0
- package/dist/hub-service/usage.js +25 -0
- package/dist/hub-service/usage.js.map +1 -0
- package/dist/hub-service/users.d.ts +56 -0
- package/dist/hub-service/users.d.ts.map +1 -0
- package/dist/hub-service/users.js +72 -0
- package/dist/hub-service/users.js.map +1 -0
- package/dist/hub-service/workspaces.d.ts +20 -0
- package/dist/hub-service/workspaces.d.ts.map +1 -0
- package/dist/hub-service/workspaces.js +10 -0
- package/dist/hub-service/workspaces.js.map +1 -0
- package/dist/index.js +179 -132
- package/dist/index.js.map +1 -1
- package/dist/os/linux.d.ts +13 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +62 -3
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +10 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows.d.ts +1 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +21 -1
- package/dist/os/windows.js.map +1 -1
- package/dist/paths.d.ts +23 -0
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +29 -0
- package/dist/paths.js.map +1 -1
- package/dist/providers/agy.d.ts +9 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +127 -14
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +6 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +248 -9
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +3 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +7 -0
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +3 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +8 -1
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/gemini.d.ts +3 -2
- package/dist/providers/gemini.d.ts.map +1 -1
- package/dist/providers/gemini.js +11 -1
- package/dist/providers/gemini.js.map +1 -1
- package/dist/providers/index.d.ts +1 -0
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +3 -0
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +51 -0
- package/dist/providers/none.d.ts.map +1 -0
- package/dist/providers/none.js +103 -0
- package/dist/providers/none.js.map +1 -0
- package/dist/providers/opencode.d.ts +4 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +49 -0
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +79 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +10 -0
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.d.ts +3 -3
- package/dist/services/agent-provisioner.d.ts.map +1 -1
- package/dist/services/agent-provisioner.js +12 -5
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/auth-socket.d.ts.map +1 -1
- package/dist/services/auth-socket.js +2 -0
- package/dist/services/auth-socket.js.map +1 -1
- package/dist/services/budget-awareness.d.ts +130 -0
- package/dist/services/budget-awareness.d.ts.map +1 -0
- package/dist/services/budget-awareness.js +129 -0
- package/dist/services/budget-awareness.js.map +1 -0
- package/dist/services/cloud-sync.d.ts +35 -0
- package/dist/services/cloud-sync.d.ts.map +1 -0
- package/dist/services/cloud-sync.js +90 -0
- package/dist/services/cloud-sync.js.map +1 -0
- package/dist/services/context-admission.d.ts +82 -0
- package/dist/services/context-admission.d.ts.map +1 -0
- package/dist/services/context-admission.js +136 -0
- package/dist/services/context-admission.js.map +1 -0
- package/dist/services/event-bus.d.ts +27 -0
- package/dist/services/event-bus.d.ts.map +1 -0
- package/dist/services/event-bus.js +20 -0
- package/dist/services/event-bus.js.map +1 -0
- package/dist/services/file-chunker.d.ts +38 -0
- package/dist/services/file-chunker.d.ts.map +1 -0
- package/dist/services/file-chunker.js +63 -0
- package/dist/services/file-chunker.js.map +1 -0
- package/dist/services/file-transfer-relay.d.ts +55 -0
- package/dist/services/file-transfer-relay.d.ts.map +1 -0
- package/dist/services/file-transfer-relay.js +115 -0
- package/dist/services/file-transfer-relay.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +1 -0
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +25 -0
- package/dist/services/http-transport.d.ts.map +1 -0
- package/dist/services/http-transport.js +371 -0
- package/dist/services/http-transport.js.map +1 -0
- package/dist/services/hub-client.d.ts +69 -0
- package/dist/services/hub-client.d.ts.map +1 -0
- package/dist/services/hub-client.js +217 -0
- package/dist/services/hub-client.js.map +1 -0
- package/dist/services/jwt.d.ts +17 -0
- package/dist/services/jwt.d.ts.map +1 -0
- package/dist/services/jwt.js +70 -0
- package/dist/services/jwt.js.map +1 -0
- package/dist/services/known-sessions.d.ts +8 -0
- package/dist/services/known-sessions.d.ts.map +1 -0
- package/dist/services/known-sessions.js +40 -0
- package/dist/services/known-sessions.js.map +1 -0
- package/dist/services/model-pricing.d.ts +36 -0
- package/dist/services/model-pricing.d.ts.map +1 -0
- package/dist/services/model-pricing.js +108 -0
- package/dist/services/model-pricing.js.map +1 -0
- package/dist/services/orphan-recovery.d.ts +56 -0
- package/dist/services/orphan-recovery.d.ts.map +1 -0
- package/dist/services/orphan-recovery.js +111 -0
- package/dist/services/orphan-recovery.js.map +1 -0
- package/dist/services/pending-responses.d.ts +23 -0
- package/dist/services/pending-responses.d.ts.map +1 -0
- package/dist/services/pending-responses.js +52 -0
- package/dist/services/pending-responses.js.map +1 -0
- package/dist/services/registry.d.ts +4 -1
- package/dist/services/registry.d.ts.map +1 -1
- package/dist/services/registry.js +3 -0
- package/dist/services/registry.js.map +1 -1
- package/dist/services/relay-context.d.ts +23 -0
- package/dist/services/relay-context.d.ts.map +1 -0
- package/dist/services/relay-context.js +8 -0
- package/dist/services/relay-context.js.map +1 -0
- package/dist/services/relay-executor.d.ts +68 -0
- package/dist/services/relay-executor.d.ts.map +1 -0
- package/dist/services/relay-executor.js +70 -0
- package/dist/services/relay-executor.js.map +1 -0
- package/dist/services/relay-request.d.ts +65 -0
- package/dist/services/relay-request.d.ts.map +1 -0
- package/dist/services/relay-request.js +129 -0
- package/dist/services/relay-request.js.map +1 -0
- package/dist/services/relay-strategy.d.ts +19 -0
- package/dist/services/relay-strategy.d.ts.map +1 -0
- package/dist/services/relay-strategy.js +111 -0
- package/dist/services/relay-strategy.js.map +1 -0
- package/dist/services/service-manager/index.d.ts +5 -0
- package/dist/services/service-manager/index.d.ts.map +1 -0
- package/dist/services/service-manager/index.js +66 -0
- package/dist/services/service-manager/index.js.map +1 -0
- package/dist/services/service-manager/linux.d.ts +10 -0
- package/dist/services/service-manager/linux.d.ts.map +1 -0
- package/dist/services/service-manager/linux.js +97 -0
- package/dist/services/service-manager/linux.js.map +1 -0
- package/dist/services/service-manager/macos.d.ts +10 -0
- package/dist/services/service-manager/macos.d.ts.map +1 -0
- package/dist/services/service-manager/macos.js +94 -0
- package/dist/services/service-manager/macos.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +18 -0
- package/dist/services/service-manager/types.d.ts.map +1 -0
- package/dist/services/service-manager/types.js +5 -0
- package/dist/services/service-manager/types.js.map +1 -0
- package/dist/services/service-manager/windows.d.ts +10 -0
- package/dist/services/service-manager/windows.d.ts.map +1 -0
- package/dist/services/service-manager/windows.js +73 -0
- package/dist/services/service-manager/windows.js.map +1 -0
- package/dist/services/session-registry.d.ts +70 -0
- package/dist/services/session-registry.d.ts.map +1 -0
- package/dist/services/session-registry.js +91 -0
- package/dist/services/session-registry.js.map +1 -0
- package/dist/services/singleton.d.ts +15 -0
- package/dist/services/singleton.d.ts.map +1 -0
- package/dist/services/singleton.js +98 -0
- package/dist/services/singleton.js.map +1 -0
- package/dist/services/sprint-coordination.d.ts +168 -0
- package/dist/services/sprint-coordination.d.ts.map +1 -0
- package/dist/services/sprint-coordination.js +564 -0
- package/dist/services/sprint-coordination.js.map +1 -0
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +70 -3
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
- package/dist/services/stall/log-path-resolver.js +8 -1
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +39 -7
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +136 -18
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +55 -5
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.d.ts +20 -0
- package/dist/services/substitution-engine.d.ts.map +1 -0
- package/dist/services/substitution-engine.js +92 -0
- package/dist/services/substitution-engine.js.map +1 -0
- package/dist/services/task-cleanup.d.ts.map +1 -1
- package/dist/services/task-cleanup.js +1 -9
- package/dist/services/task-cleanup.js.map +1 -1
- package/dist/services/token-issuer.d.ts +47 -0
- package/dist/services/token-issuer.d.ts.map +1 -0
- package/dist/services/token-issuer.js +63 -0
- package/dist/services/token-issuer.js.map +1 -0
- package/dist/services/tool-registry.d.ts +3 -0
- package/dist/services/tool-registry.d.ts.map +1 -0
- package/dist/services/tool-registry.js +139 -0
- package/dist/services/tool-registry.js.map +1 -0
- package/dist/services/user-config.d.ts +14 -0
- package/dist/services/user-config.d.ts.map +1 -1
- package/dist/services/user-config.js +55 -0
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/types.d.ts +44 -0
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/dist/skills/pm/cost.md +3 -0
- package/dist/skills/pm/doer-reviewer-loop.md +3 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +8 -2
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/child-id-allocator.d.ts +45 -0
- package/dist/tools/child-id-allocator.d.ts.map +1 -0
- package/dist/tools/child-id-allocator.js +62 -0
- package/dist/tools/child-id-allocator.js.map +1 -0
- package/dist/tools/cloud-control.d.ts +2 -2
- package/dist/tools/compose-permissions.d.ts +12 -4
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +55 -4
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/dolt-push-mutex.d.ts +44 -0
- package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
- package/dist/tools/dolt-push-mutex.js +83 -0
- package/dist/tools/dolt-push-mutex.js.map +1 -0
- package/dist/tools/execute-command.d.ts +11 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +22 -5
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +72 -12
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +962 -71
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/get-member-model-pricing.d.ts +21 -0
- package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
- package/dist/tools/get-member-model-pricing.js +29 -0
- package/dist/tools/get-member-model-pricing.js.map +1 -0
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +39 -7
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +1 -1
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +8 -2
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +29 -0
- package/dist/tools/member-reservation.d.ts.map +1 -0
- package/dist/tools/member-reservation.js +71 -0
- package/dist/tools/member-reservation.js.map +1 -0
- package/dist/tools/provision-vcs-auth.d.ts +7 -7
- package/dist/tools/provision-vcs-auth.js +1 -1
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +17 -5
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +144 -5
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts +1 -1
- package/dist/tools/report-status.d.ts +33 -0
- package/dist/tools/report-status.d.ts.map +1 -0
- package/dist/tools/report-status.js +44 -0
- package/dist/tools/report-status.js.map +1 -0
- package/dist/tools/respond-to-message.d.ts +21 -0
- package/dist/tools/respond-to-message.d.ts.map +1 -0
- package/dist/tools/respond-to-message.js +23 -0
- package/dist/tools/respond-to-message.js.map +1 -0
- package/dist/tools/send-files.d.ts +3 -0
- package/dist/tools/send-files.d.ts.map +1 -1
- package/dist/tools/send-files.js +88 -8
- package/dist/tools/send-files.js.map +1 -1
- package/dist/tools/send-message.d.ts +27 -0
- package/dist/tools/send-message.d.ts.map +1 -0
- package/dist/tools/send-message.js +46 -0
- package/dist/tools/send-message.js.map +1 -0
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.d.ts.map +1 -1
- package/dist/tools/shutdown-server.js +19 -0
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/update-member.d.ts +8 -8
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +11 -1
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +15 -3
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +2 -1
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +7 -2
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/pid-helpers.d.ts +15 -0
- package/dist/utils/pid-helpers.d.ts.map +1 -1
- package/dist/utils/pid-helpers.js +23 -0
- package/dist/utils/pid-helpers.js.map +1 -1
- package/dist/utils/process-utils.d.ts +3 -0
- package/dist/utils/process-utils.d.ts.map +1 -0
- package/dist/utils/process-utils.js +42 -0
- package/dist/utils/process-utils.js.map +1 -0
- package/dist/utils/prompt-errors.d.ts +2 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +13 -3
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/workspace-trust.d.ts +24 -0
- package/dist/utils/workspace-trust.d.ts.map +1 -0
- package/dist/utils/workspace-trust.js +35 -0
- package/dist/utils/workspace-trust.js.map +1 -0
- package/dist/workflows/auto-sprint.js +450 -87
- package/package.json +35 -7
- package/packages/apra-fleet-client/package.json +26 -0
- package/packages/apra-fleet-client/src/client/api.mjs +396 -0
- package/packages/apra-fleet-client/src/client/client.mjs +146 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
- package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
- package/packages/apra-fleet-se/apra-pm/version.json +3 -0
- package/packages/apra-fleet-se/bin/cli.mjs +857 -0
- package/packages/apra-fleet-se/bin/serve.mjs +383 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
- package/packages/apra-fleet-se/package.json +28 -0
- package/packages/apra-fleet-se/workflow.json +1 -0
- package/packages/apra-fleet-workflow/package.json +30 -0
- package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
- package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
- package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
- package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
- package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
- package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
- package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
- package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
- package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
- package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
- package/scripts/agy-transcript-reader.js +1 -0
- package/scripts/fleet-statusline.sh +17 -13
- package/skills/fleet/SKILL.md +37 -2
- package/skills/fleet/beads.md +14 -7
- package/skills/fleet/permissions.md +50 -0
- package/skills/fleet/profiles/base-dev.json +1 -0
- package/skills/fleet/profiles/base-reviewer.json +1 -0
- package/skills/fleet/profiles/node.json +2 -2
- package/version.json +1 -1
- package/scripts/agy-settings-merge.js +0 -27
- /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AzureDevOpsVCS -- the Azure DevOps provider entry (apra-fleet-647.1.5.1).
|
|
3
|
+
*
|
|
4
|
+
* Registered so Azure DevOps is a first-class member of the SAME registry
|
|
5
|
+
* that drives classifyFailure(), resolveProvider() and buildVcsCommand() --
|
|
6
|
+
* before this file existed, 'azure-devops' was only a name-keyed entry in
|
|
7
|
+
* vcs-module.mjs's now-deleted BUILDERS/DEFAULT_AUTH_MODES tables, which a
|
|
8
|
+
* new provider had to also edit.
|
|
9
|
+
*
|
|
10
|
+
* No auth-mode axis of its own (a single PAT token field at
|
|
11
|
+
* provision_vcs_auth time, same as Bitbucket -- see ./bitbucket.mjs), and no
|
|
12
|
+
* REST create-pull-request/comment builders implemented yet -- both are
|
|
13
|
+
* DELIBERATELY absent (`builders: null`) rather than guessed at, so
|
|
14
|
+
* buildVcsCommand() fails closed with a clear ASCII "ERROR: ... does not yet
|
|
15
|
+
* implement action ..." instead of silently building a wrong command.
|
|
16
|
+
* Declaring `defaultAuthMode` (even as `null`) is what makes 'azure-devops'
|
|
17
|
+
* part of resolveProvider()'s known vocabulary -- see ./index.mjs's
|
|
18
|
+
* isAuthBackend().
|
|
19
|
+
*
|
|
20
|
+
* Extends GenericGitVCS for stderr classification. Azure DevOps' own
|
|
21
|
+
* TF-numbered error codes (e.g. TF401019) previously were NOT added as a
|
|
22
|
+
* dedicated pattern here, on the reasoning that the realistic full stderr for
|
|
23
|
+
* an expired/invalid Azure DevOps credential over git-over-HTTPS still
|
|
24
|
+
* carries git's own generic "fatal: Authentication failed for '<url>'" tail
|
|
25
|
+
* line, which GenericGitVCS already classifies AUTH_EXPIRED (see
|
|
26
|
+
* test/vcs-nongithub-auth-selfheal.test.mjs, apra-fleet-647.1.3.4).
|
|
27
|
+
*
|
|
28
|
+
* apra-fleet-417.6 (BLOCKS apra-fleet-647.1.3.4's own AC that no non-GitHub
|
|
29
|
+
* provider signal is recognized without that tail): a bare 'remote:
|
|
30
|
+
* TF401019: ...' line -- e.g. a REST/API path, or any transport that does not
|
|
31
|
+
* append git's own tail -- reached classifyFailure() as UNKNOWN before this
|
|
32
|
+
* pattern existed. TF401019's own text ("does not exist, or you do not have
|
|
33
|
+
* permission to perform this operation") is Azure DevOps' deliberately
|
|
34
|
+
* ambiguous repo-not-found-or-no-access message; re-minting the identical PAT
|
|
35
|
+
* cannot fix either case (a missing repo needs creating, a real permission
|
|
36
|
+
* gap needs granting), so this is AUTH_DENIED, not AUTH_EXPIRED -- consistent
|
|
37
|
+
* with vcs-classify-failure.test.mjs's own AC1 example provider, which models
|
|
38
|
+
* TF401019 the same way.
|
|
39
|
+
*
|
|
40
|
+
* ASCII only.
|
|
41
|
+
*/
|
|
42
|
+
|
|
43
|
+
import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
|
|
44
|
+
|
|
45
|
+
const AUTH_DENIED = [
|
|
46
|
+
/TF401019/,
|
|
47
|
+
];
|
|
48
|
+
|
|
49
|
+
/** Best-effort Azure DevOps TF-numbered error code, purely DIAGNOSTIC: never
|
|
50
|
+
* branch on it -- branch on `kind`. */
|
|
51
|
+
function extractProviderCode(raw) {
|
|
52
|
+
const text = String(raw == null ? '' : raw);
|
|
53
|
+
const match = text.match(/\b(TF\d{6})\b/);
|
|
54
|
+
return match ? match[1] : null;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export const AzureDevOpsVCS = Object.freeze({
|
|
58
|
+
name: 'azure-devops',
|
|
59
|
+
extends: 'generic-git',
|
|
60
|
+
rules: Object.freeze({
|
|
61
|
+
[K.AUTH_DENIED]: AUTH_DENIED,
|
|
62
|
+
}),
|
|
63
|
+
extractProviderCode,
|
|
64
|
+
defaultAuthMode: null,
|
|
65
|
+
builders: null,
|
|
66
|
+
});
|
|
67
|
+
|
|
68
|
+
export default AzureDevOpsVCS;
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* BitbucketVCS -- the Bitbucket provider entry (apra-fleet-647.1.5.1).
|
|
3
|
+
*
|
|
4
|
+
* Registered so Bitbucket is a first-class member of the SAME registry that
|
|
5
|
+
* drives classifyFailure(), resolveProvider() and buildVcsCommand() --
|
|
6
|
+
* before this file existed, 'bitbucket' was only a name-keyed entry in
|
|
7
|
+
* vcs-module.mjs's now-deleted BUILDERS/DEFAULT_AUTH_MODES tables, which a
|
|
8
|
+
* new provider had to also edit.
|
|
9
|
+
*
|
|
10
|
+
* No auth-mode axis of its own (Bitbucket authenticates via a single app
|
|
11
|
+
* password / token field at provision_vcs_auth time, same as Azure DevOps --
|
|
12
|
+
* see ./azure-devops.mjs), and no REST create-pull-request/comment builders
|
|
13
|
+
* implemented yet -- both are DELIBERATELY absent (`builders: null`) rather
|
|
14
|
+
* than guessed at, so buildVcsCommand() fails closed with a clear ASCII
|
|
15
|
+
* "ERROR: ... does not yet implement action ..." instead of silently
|
|
16
|
+
* building a wrong command. Declaring `defaultAuthMode` (even as `null`) is
|
|
17
|
+
* what makes 'bitbucket' part of resolveProvider()'s known vocabulary -- see
|
|
18
|
+
* ./index.mjs's isAuthBackend().
|
|
19
|
+
*
|
|
20
|
+
* Extends GenericGitVCS for stderr classification (Bitbucket speaks plain
|
|
21
|
+
* git-over-HTTPS/SSH; it had no vendor-specific auth literal in the parity
|
|
22
|
+
* corpus before apra-fleet-417.6 -- see generic-git.mjs's own header note on
|
|
23
|
+
* what belongs portable vs. vendor-specific).
|
|
24
|
+
*
|
|
25
|
+
* apra-fleet-417.6: 'remote: Invalid or expired app password.' is
|
|
26
|
+
* Bitbucket's own literal for a dead/rotated app password, reached without
|
|
27
|
+
* git's generic "fatal: Authentication failed" tail (e.g. over a transport
|
|
28
|
+
* that does not append it). The text says "expired" outright, and
|
|
29
|
+
* re-provisioning a fresh app password is exactly the fix, so AUTH_EXPIRED
|
|
30
|
+
* (contrast Azure DevOps' TF401019, which is AUTH_DENIED -- see
|
|
31
|
+
* ./azure-devops.mjs -- because re-minting the same credential there cannot
|
|
32
|
+
* help).
|
|
33
|
+
*
|
|
34
|
+
* ASCII only.
|
|
35
|
+
*/
|
|
36
|
+
|
|
37
|
+
import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
|
|
38
|
+
|
|
39
|
+
const AUTH_EXPIRED = [
|
|
40
|
+
/Invalid or expired app password/i,
|
|
41
|
+
];
|
|
42
|
+
|
|
43
|
+
export const BitbucketVCS = Object.freeze({
|
|
44
|
+
name: 'bitbucket',
|
|
45
|
+
extends: 'generic-git',
|
|
46
|
+
rules: Object.freeze({
|
|
47
|
+
[K.AUTH_EXPIRED]: AUTH_EXPIRED,
|
|
48
|
+
}),
|
|
49
|
+
defaultAuthMode: null,
|
|
50
|
+
builders: null,
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
export default BitbucketVCS;
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DoltVCS -- the Dolt (beads-sync) provider for VCSModule.classifyFailure()
|
|
3
|
+
* (apra-fleet-647.1.3.2).
|
|
4
|
+
*
|
|
5
|
+
* `extends: null` DELIBERATELY -- this does NOT extend GenericGitVCS or
|
|
6
|
+
* GitHubVCS. classifyFailure()'s inheritance walk is ADDITIVE (a provider's
|
|
7
|
+
* own rules are checked FIRST, but every ancestor's rules are still checked
|
|
8
|
+
* too), so extending either would import git-flavored TRANSIENT texts
|
|
9
|
+
* ('fetch failed', 'transport failure while executing command',
|
|
10
|
+
* 'ssh_exchange_identification', ...) into Dolt's classification. Those
|
|
11
|
+
* strings classify 'unknown' (never retried) for dolt today; silently
|
|
12
|
+
* widening TRANSIENT would change that verdict, which apra-fleet-647.1.3.2
|
|
13
|
+
* AC3 (no verdict change) forbids. Every table below is therefore dolt's OWN
|
|
14
|
+
* copy, even where it duplicates a GenericGitVCS/GitHubVCS pattern verbatim
|
|
15
|
+
* (the 8 shared auth literals) -- see generic-git.mjs's "DELIBERATELY NOT
|
|
16
|
+
* FOLDED IN" note, which named this exact tradeoff in advance.
|
|
17
|
+
*
|
|
18
|
+
* PARITY CONSTRAINT: every regex table here is dolt-sync.mjs's own
|
|
19
|
+
* DOLT_*_PATTERNS verbatim (apra-fleet-417.3.1's classifyDoltFailure), so
|
|
20
|
+
* dolt-sync.mjs can delegate to VCSModule.classifyFailure(raw, {provider:
|
|
21
|
+
* 'dolt'}) with NO verdict change.
|
|
22
|
+
*
|
|
23
|
+
* PRECEDENCE (apra-fleet-spp / apra-fleet-417.3.1): no-remote, empty-remote
|
|
24
|
+
* and remote-unreachable are checked first (each is a distinct benign/fatal
|
|
25
|
+
* non-error condition that must win over a looser downstream pattern), THEN
|
|
26
|
+
* auth, THEN diverged, THEN transient -- auth is deliberately checked BEFORE
|
|
27
|
+
* diverged here (the OPPOSITE of GenericGitVCS/GitHubVCS's default
|
|
28
|
+
* DIVERGED-before-AUTH order): a live incident (2026-08-02, fleet-mac) had a
|
|
29
|
+
* `could not read Username for` credential failure misclassified as data
|
|
30
|
+
* divergence by a looser conflict pattern and hard-aborted an otherwise
|
|
31
|
+
* healthy sprint, when the fix was simply to re-provision credentials. A
|
|
32
|
+
* credential failure must never reach 'diverged' for dolt.
|
|
33
|
+
*
|
|
34
|
+
* PURITY: non-global regexes only -- see the note in ./generic-git.mjs.
|
|
35
|
+
*
|
|
36
|
+
* ASCII only.
|
|
37
|
+
*/
|
|
38
|
+
|
|
39
|
+
import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
|
|
40
|
+
|
|
41
|
+
/** Verbatim DOLT_NO_REMOTE_PATTERNS. */
|
|
42
|
+
const NO_REMOTE = [
|
|
43
|
+
/error 1105.*no remote/i,
|
|
44
|
+
/\bno remote\b/i,
|
|
45
|
+
];
|
|
46
|
+
|
|
47
|
+
/** Verbatim DOLT_EMPTY_REMOTE_PATTERNS. */
|
|
48
|
+
const EMPTY_REMOTE = [
|
|
49
|
+
/error 1105.*no branches found in remote/i,
|
|
50
|
+
/no branches found in remote/i,
|
|
51
|
+
];
|
|
52
|
+
|
|
53
|
+
/** Verbatim DOLT_REMOTE_UNREACHABLE_PATTERNS. */
|
|
54
|
+
const REMOTE_UNREACHABLE = [
|
|
55
|
+
/could not be accessed/i,
|
|
56
|
+
/failed to get remote db/i,
|
|
57
|
+
/stat [^:]+: no such file or directory/i,
|
|
58
|
+
];
|
|
59
|
+
|
|
60
|
+
/** Verbatim DOLT_AUTH_PATTERNS. dolt-sync.mjs's classifyDoltFailure returns a
|
|
61
|
+
* single undifferentiated 'auth' (no AUTH_EXPIRED/AUTH_DENIED split), so
|
|
62
|
+
* every one of these -- including the publickey-refusal literal -- lands in
|
|
63
|
+
* AUTH_EXPIRED here; toDoltVerdict() collapses both AUTH_* kinds back to
|
|
64
|
+
* 'auth' regardless, so this bucketing is verdict-neutral. */
|
|
65
|
+
const AUTH_EXPIRED = [
|
|
66
|
+
/could not read Username for/i,
|
|
67
|
+
/could not read Password for/i,
|
|
68
|
+
/Authentication failed/i,
|
|
69
|
+
/Permission denied \(publickey\)/i,
|
|
70
|
+
/remote: Invalid username or (token|password)/i,
|
|
71
|
+
/terminal prompts disabled/i,
|
|
72
|
+
/support for password authentication was removed/i,
|
|
73
|
+
/Bad credentials/i,
|
|
74
|
+
];
|
|
75
|
+
|
|
76
|
+
/** Verbatim DOLT_DIVERGED_PATTERNS. */
|
|
77
|
+
const DIVERGED = [
|
|
78
|
+
/conflict/i,
|
|
79
|
+
/would (be )?overwrit/i,
|
|
80
|
+
/cannot fast[- ]forward/i,
|
|
81
|
+
/not possible to fast[- ]forward/i,
|
|
82
|
+
/non-fast-forward/i,
|
|
83
|
+
/\[rejected\]/i,
|
|
84
|
+
/failed to push/i,
|
|
85
|
+
/updates were rejected/i,
|
|
86
|
+
/remote (is )?ahead/i,
|
|
87
|
+
/behind the remote/i,
|
|
88
|
+
/not up[- ]to[- ]date/i,
|
|
89
|
+
/have diverged/i,
|
|
90
|
+
/merge (is )?required/i,
|
|
91
|
+
/working set (is )?not clean/i,
|
|
92
|
+
];
|
|
93
|
+
|
|
94
|
+
/** Verbatim DOLT_TRANSIENT_PATTERNS. */
|
|
95
|
+
const TRANSIENT = [
|
|
96
|
+
/could not resolve host/i,
|
|
97
|
+
/unable to (access|connect)/i,
|
|
98
|
+
/connection (timed out|reset|refused)/i,
|
|
99
|
+
/operation timed out/i,
|
|
100
|
+
/\btimed out\b/i,
|
|
101
|
+
/\btimeout\b/i,
|
|
102
|
+
/temporary failure/i,
|
|
103
|
+
/early eof/i,
|
|
104
|
+
/rpc failed/i,
|
|
105
|
+
/the remote end hung up/i,
|
|
106
|
+
/server (is )?(starting|not ready|unavailable)/i,
|
|
107
|
+
/connection refused/i,
|
|
108
|
+
/dial tcp/i,
|
|
109
|
+
/i\/o timeout/i,
|
|
110
|
+
/database is locked/i,
|
|
111
|
+
/lock/i,
|
|
112
|
+
];
|
|
113
|
+
|
|
114
|
+
const PRECEDENCE = Object.freeze([
|
|
115
|
+
K.NO_REMOTE,
|
|
116
|
+
K.EMPTY_REMOTE,
|
|
117
|
+
K.REMOTE_UNREACHABLE,
|
|
118
|
+
K.AUTH_EXPIRED,
|
|
119
|
+
K.AUTH_DENIED,
|
|
120
|
+
K.DIVERGED,
|
|
121
|
+
K.TRANSIENT,
|
|
122
|
+
]);
|
|
123
|
+
|
|
124
|
+
export const DoltVCS = Object.freeze({
|
|
125
|
+
name: 'dolt',
|
|
126
|
+
extends: null,
|
|
127
|
+
precedence: PRECEDENCE,
|
|
128
|
+
rules: Object.freeze({
|
|
129
|
+
[K.NO_REMOTE]: NO_REMOTE,
|
|
130
|
+
[K.EMPTY_REMOTE]: EMPTY_REMOTE,
|
|
131
|
+
[K.REMOTE_UNREACHABLE]: REMOTE_UNREACHABLE,
|
|
132
|
+
[K.AUTH_EXPIRED]: AUTH_EXPIRED,
|
|
133
|
+
[K.DIVERGED]: DIVERGED,
|
|
134
|
+
[K.TRANSIENT]: TRANSIENT,
|
|
135
|
+
}),
|
|
136
|
+
/** Dolt stderr carries no vendor error code today. */
|
|
137
|
+
extractProviderCode() {
|
|
138
|
+
return null;
|
|
139
|
+
},
|
|
140
|
+
// Deliberately NO matchesHost/capabilitiesForHost: Dolt is a beads-sync
|
|
141
|
+
// backend, not a git-remote PR-hosting provider, so it must never be a
|
|
142
|
+
// candidate in VCSModule.capabilities()'s host dispatch
|
|
143
|
+
// (resolveVcsProviderForHost skips any provider with no matchesHost).
|
|
144
|
+
});
|
|
145
|
+
|
|
146
|
+
export default DoltVCS;
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GenericGitVCS -- the portable base provider for VCSModule.classifyFailure().
|
|
3
|
+
*
|
|
4
|
+
* Owns ONLY the texts any git/OpenSSH client emits regardless of who hosts the
|
|
5
|
+
* remote. Anything with a vendor's name, product literal or error code in it
|
|
6
|
+
* belongs in that vendor's provider file (see ./github.mjs), never here.
|
|
7
|
+
*
|
|
8
|
+
* Every provider file has this exact shape, and adding a provider means adding
|
|
9
|
+
* one more file like it (plus one registration line in ./index.mjs) -- never a
|
|
10
|
+
* change to classifyFailure's dispatch contract:
|
|
11
|
+
*
|
|
12
|
+
* {
|
|
13
|
+
* name: string // the `provider` value callers pass
|
|
14
|
+
* extends: string|null // provider whose rules are inherited
|
|
15
|
+
* rules: { [VCS_FAILURE_KIND]: RegExp[] }
|
|
16
|
+
* precedence: string[]|undefined // optional kind-check order override
|
|
17
|
+
* extractProviderCode: (raw) => string|null
|
|
18
|
+
* }
|
|
19
|
+
*
|
|
20
|
+
* PURITY: every regex here is non-global on purpose. A module-level /g regex
|
|
21
|
+
* retains `lastIndex` between calls, which would make classifyFailure return
|
|
22
|
+
* different answers for the same input on successive calls.
|
|
23
|
+
*
|
|
24
|
+
* PARITY CONSTRAINT (apra-fleet-647.1.3.1 AC2): the DIVERGED and TRANSIENT
|
|
25
|
+
* tables below are runner.js's GIT_DIVERGED_PATTERNS / GIT_TRANSIENT_PATTERNS
|
|
26
|
+
* verbatim, and the AUTH tables are the six PORTABLE members of
|
|
27
|
+
* GIT_AUTH_PATTERNS / DOLT_AUTH_PATTERNS (those two lists are identical; their
|
|
28
|
+
* two remaining members are GitHub literals and live in ./github.mjs). This is
|
|
29
|
+
* what lets apra-fleet-647.1.3.2 delete those tables and delegate with no
|
|
30
|
+
* verdict change.
|
|
31
|
+
*
|
|
32
|
+
* DELIBERATELY NOT FOLDED IN: dolt-sync.mjs's DOLT_TRANSIENT_PATTERNS is
|
|
33
|
+
* BROADER than the git set (bare /lock/i, /database is locked/i, /dial tcp/i,
|
|
34
|
+
* /connection refused/i, /server (is )?(starting|not ready|unavailable)/i,
|
|
35
|
+
* /unable to (access|connect)/i), and dolt has two extra classes with no
|
|
36
|
+
* neutral kind yet (empty-remote, remote-unreachable). Folding dolt's wider
|
|
37
|
+
* transient set in here would silently widen GIT classification -- a git stderr
|
|
38
|
+
* merely containing "lock" is 'unknown' (never retried) today and would start
|
|
39
|
+
* being retried. A dolt delegation must add its own provider file and the two
|
|
40
|
+
* missing kinds; it must not widen this one.
|
|
41
|
+
*
|
|
42
|
+
* ASCII only.
|
|
43
|
+
*/
|
|
44
|
+
|
|
45
|
+
import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
|
|
46
|
+
|
|
47
|
+
/** Non-fast-forward / unmerged / conflicted. Verbatim GIT_DIVERGED_PATTERNS. */
|
|
48
|
+
const DIVERGED = [
|
|
49
|
+
/not possible to fast-forward/i,
|
|
50
|
+
/non-fast-forward/i,
|
|
51
|
+
/fast-forwards? are not allowed/i,
|
|
52
|
+
/\[rejected\]/i,
|
|
53
|
+
/failed to push some refs/i,
|
|
54
|
+
/updates were rejected/i,
|
|
55
|
+
/unmerged/i,
|
|
56
|
+
/needs merge/i,
|
|
57
|
+
/would be overwritten/i,
|
|
58
|
+
/^conflict/im,
|
|
59
|
+
/automatic merge failed/i,
|
|
60
|
+
/have diverged/i,
|
|
61
|
+
];
|
|
62
|
+
|
|
63
|
+
/** Credential missing / stale / rejected as invalid -- re-provisioning can fix
|
|
64
|
+
* it. git and OpenSSH emit all of these with no vendor involvement: the first
|
|
65
|
+
* three are git's credential-helper prompts (or their suppression), and the
|
|
66
|
+
* last is git's own refusal text for basic-auth-over-HTTPS.
|
|
67
|
+
*
|
|
68
|
+
* apra-fleet-417.6: 'remote: 401 Unauthorized' is Gitea's literal in the
|
|
69
|
+
* 647.1.3 epic's provider list, but the text itself is a bare HTTP status
|
|
70
|
+
* with no vendor name or product literal in it -- exactly the kind of entry
|
|
71
|
+
* this file's header says belongs here rather than in a dedicated
|
|
72
|
+
* gitea.mjs. HTTP's own semantics pick the AUTH_* split: 401 means "you did
|
|
73
|
+
* not authenticate" (no/expired/invalid credential -- re-provisioning is the
|
|
74
|
+
* fix), as opposed to 403 ("you authenticated fine, but you may not do
|
|
75
|
+
* this" -- see AUTH_DENIED below). No dedicated Gitea provider file/registry
|
|
76
|
+
* entry is added for this: registering a classification-only 'gitea'
|
|
77
|
+
* provider would flip buildVcsCommand()'s unknown-provider error for it from
|
|
78
|
+
* "unsupported VCS provider" to "does not yet implement action", which is
|
|
79
|
+
* not this bead's scope. */
|
|
80
|
+
const AUTH_EXPIRED = [
|
|
81
|
+
/could not read Username for/i,
|
|
82
|
+
/could not read Password for/i,
|
|
83
|
+
/terminal prompts disabled/i,
|
|
84
|
+
/Authentication failed/i,
|
|
85
|
+
/support for password authentication was removed/i,
|
|
86
|
+
/remote:\s*401 Unauthorized/i,
|
|
87
|
+
];
|
|
88
|
+
|
|
89
|
+
/** Identity understood, access refused. OpenSSH offered a key and the server
|
|
90
|
+
* rejected it: minting the same credential again cannot help.
|
|
91
|
+
*
|
|
92
|
+
* apra-fleet-417.6: 'remote: HTTP Basic: Access denied' is GitLab's literal
|
|
93
|
+
* in the 647.1.3 epic's provider list, but -- same rationale as the 401
|
|
94
|
+
* entry above -- it names no vendor and is the generic Apache/git-http-
|
|
95
|
+
* backend basic-auth refusal text, so it lives here rather than in a
|
|
96
|
+
* dedicated gitlab.mjs (no registered 'gitlab' provider is added for the
|
|
97
|
+
* same buildVcsCommand()-error-shape reason documented on AUTH_EXPIRED
|
|
98
|
+
* above). The literal says "Access denied", not "expired"/"invalid" --
|
|
99
|
+
* HTTP's 403-shaped refusal, not a 401 -- so AUTH_DENIED, not
|
|
100
|
+
* AUTH_EXPIRED. */
|
|
101
|
+
const AUTH_DENIED = [
|
|
102
|
+
/Permission denied \(publickey\)/i,
|
|
103
|
+
/HTTP Basic:\s*Access denied/i,
|
|
104
|
+
];
|
|
105
|
+
|
|
106
|
+
/** Network / lock blips a plain retry can clear. Verbatim
|
|
107
|
+
* GIT_TRANSIENT_PATTERNS -- including the two dispatch-channel texts, which
|
|
108
|
+
* are a transient failure of the fleet transport rather than of git, and must
|
|
109
|
+
* be retried rather than left 'unknown' (which is sprint-fatal). */
|
|
110
|
+
const TRANSIENT = [
|
|
111
|
+
/could not resolve host/i,
|
|
112
|
+
/unable to access/i,
|
|
113
|
+
/connection (timed out|reset|refused)/i,
|
|
114
|
+
/operation timed out/i,
|
|
115
|
+
/\btimed out\b/i,
|
|
116
|
+
/\btimeout\b/i,
|
|
117
|
+
/temporary failure/i,
|
|
118
|
+
/early eof/i,
|
|
119
|
+
/rpc failed/i,
|
|
120
|
+
/the remote end hung up/i,
|
|
121
|
+
/index\.lock/i,
|
|
122
|
+
/unable to create '.*lock'/i,
|
|
123
|
+
/cannot lock ref/i,
|
|
124
|
+
/ssh_exchange_identification/i,
|
|
125
|
+
/transport failure while executing command/i,
|
|
126
|
+
/fetch failed/i,
|
|
127
|
+
];
|
|
128
|
+
|
|
129
|
+
/** No remote configured at all -- nothing to push or pull. Kept narrow on
|
|
130
|
+
* purpose: these must never swallow a real failure that merely mentions the
|
|
131
|
+
* word "remote". */
|
|
132
|
+
const NO_REMOTE = [
|
|
133
|
+
/error 1105.*no remote/i,
|
|
134
|
+
/\bno remote\b/i,
|
|
135
|
+
/no such remote/i,
|
|
136
|
+
];
|
|
137
|
+
|
|
138
|
+
/** VCSModule's OWN refusal texts (vcs-module.mjs buildVcsCommand). Kept to
|
|
139
|
+
* exactly those two literals -- a broad /not supported/i would capture
|
|
140
|
+
* unrelated remote chatter. */
|
|
141
|
+
const UNSUPPORTED_OPERATION = [
|
|
142
|
+
/unsupported VCS provider/i,
|
|
143
|
+
/does not yet implement action/i,
|
|
144
|
+
];
|
|
145
|
+
|
|
146
|
+
export const GenericGitVCS = Object.freeze({
|
|
147
|
+
name: 'generic-git',
|
|
148
|
+
extends: null,
|
|
149
|
+
rules: Object.freeze({
|
|
150
|
+
[K.DIVERGED]: DIVERGED,
|
|
151
|
+
[K.AUTH_EXPIRED]: AUTH_EXPIRED,
|
|
152
|
+
[K.AUTH_DENIED]: AUTH_DENIED,
|
|
153
|
+
[K.TRANSIENT]: TRANSIENT,
|
|
154
|
+
[K.NO_REMOTE]: NO_REMOTE,
|
|
155
|
+
[K.UNSUPPORTED_OPERATION]: UNSUPPORTED_OPERATION,
|
|
156
|
+
}),
|
|
157
|
+
/** Portable git stderr carries no vendor error code. */
|
|
158
|
+
extractProviderCode() {
|
|
159
|
+
return null;
|
|
160
|
+
},
|
|
161
|
+
/** Catch-all for VCSModule.capabilities() host dispatch (apra-fleet-
|
|
162
|
+
* 647.1.4.1): every resolvable host matches SOME provider, and this is
|
|
163
|
+
* the fallback when no more specific provider (e.g. GitHubVCS) claims
|
|
164
|
+
* it, so resolveVcsProviderForHost() never returns nothing. */
|
|
165
|
+
matchesHost() {
|
|
166
|
+
return true;
|
|
167
|
+
},
|
|
168
|
+
/** No REST create-pull-request implementation exists for a generic/
|
|
169
|
+
* unrecognized host (Azure DevOps, GitLab, or anything else VCSModule
|
|
170
|
+
* has no provider for yet) -- fails closed, never guesses a vendor. */
|
|
171
|
+
capabilitiesForHost() {
|
|
172
|
+
return { canOpenPullRequest: false };
|
|
173
|
+
},
|
|
174
|
+
});
|
|
175
|
+
|
|
176
|
+
export default GenericGitVCS;
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* GitHubVCS -- the GitHub provider for VCSModule.classifyFailure(), and (apra-
|
|
3
|
+
* fleet-647.1.5.1) THE manifest entry for everything else GitHub-specific:
|
|
4
|
+
* its default auth mode and its create-pull-request/comment command builders.
|
|
5
|
+
* Before 647.1.5.1 those lived in two separate provider-name-keyed tables in
|
|
6
|
+
* vcs-module.mjs (BUILDERS, DEFAULT_AUTH_MODES) that a new provider had to
|
|
7
|
+
* also edit; now they are fields on THIS descriptor, so adding a provider is
|
|
8
|
+
* one file here, nothing in vcs-module.mjs.
|
|
9
|
+
*
|
|
10
|
+
* Owns ONLY GitHub's own literals and inherits everything portable from
|
|
11
|
+
* GenericGitVCS via `extends` (a GitHub push still fails with plain git and
|
|
12
|
+
* OpenSSH texts, so those must not be duplicated here). Inherited patterns are
|
|
13
|
+
* checked too; this file's patterns are checked FIRST within each kind, so a
|
|
14
|
+
* provider can always sharpen a base verdict without editing the base.
|
|
15
|
+
*
|
|
16
|
+
* PARITY NOTE (apra-fleet-647.1.3.1 AC2): the two members of runner.js's
|
|
17
|
+
* GIT_AUTH_PATTERNS / DOLT_AUTH_PATTERNS that are GitHub-specific live here.
|
|
18
|
+
* Together with GenericGitVCS's six, `provider: 'github'` reproduces those
|
|
19
|
+
* lists EXACTLY -- which is why 'github' is classifyFailure's default provider
|
|
20
|
+
* (see vcs-module.mjs): runner.js applies the full eight unconditionally today,
|
|
21
|
+
* so anything less would be a verdict regression for apra-fleet-647.1.3.2.
|
|
22
|
+
*
|
|
23
|
+
* PURITY: non-global regexes only -- see the note in ./generic-git.mjs.
|
|
24
|
+
*
|
|
25
|
+
* ASCII only.
|
|
26
|
+
*/
|
|
27
|
+
|
|
28
|
+
import { VCS_FAILURE_KINDS as K } from '../errors.mjs';
|
|
29
|
+
|
|
30
|
+
const GITHUB_API = 'https://api.github.com';
|
|
31
|
+
const REDACTED = '***REDACTED***';
|
|
32
|
+
const REPO_RE = /^[\w.-]+\/[\w.-]+$/;
|
|
33
|
+
|
|
34
|
+
/** Single-quote a string for embedding in a POSIX shell command,
|
|
35
|
+
* closing/reopening the quote around any embedded single quotes. */
|
|
36
|
+
function shQuote(value) {
|
|
37
|
+
return `'${String(value).replace(/'/g, `'\\''`)}'`;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function assertRepo(repo) {
|
|
41
|
+
const value = String(repo ?? '').trim();
|
|
42
|
+
if (!REPO_RE.test(value)) {
|
|
43
|
+
throw new Error(`ERROR: VCSModule: invalid repo "${repo}" -- expected "owner/name" (e.g. "Apra-Labs/apra-fleet").`);
|
|
44
|
+
}
|
|
45
|
+
return value;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
function assertToken(token) {
|
|
49
|
+
const value = String(token ?? '');
|
|
50
|
+
if (!value) {
|
|
51
|
+
throw new Error('ERROR: VCSModule: no token supplied -- caller must mint one via provision_vcs_auth before calling VCSModule.');
|
|
52
|
+
}
|
|
53
|
+
return value;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/** Build the GitHub REST "create pull request" curl command.
|
|
57
|
+
* POST /repos/{owner}/{repo}/pulls -- see
|
|
58
|
+
* https://docs.github.com/en/rest/pulls/pulls#create-a-pull-request */
|
|
59
|
+
function buildGitHubCreatePrCommand({ repo, base, head, title, body, token }) {
|
|
60
|
+
const safeRepo = assertRepo(repo);
|
|
61
|
+
const safeToken = assertToken(token);
|
|
62
|
+
if (!base) throw new Error('ERROR: VCSModule: "base" branch is required to build a create-pull-request command.');
|
|
63
|
+
if (!head) throw new Error('ERROR: VCSModule: "head" branch is required to build a create-pull-request command.');
|
|
64
|
+
if (!title) throw new Error('ERROR: VCSModule: "title" is required to build a create-pull-request command.');
|
|
65
|
+
|
|
66
|
+
const payload = { title, head, base };
|
|
67
|
+
if (body !== undefined) payload.body = body;
|
|
68
|
+
const payloadJson = JSON.stringify(payload);
|
|
69
|
+
const url = `${GITHUB_API}/repos/${safeRepo}/pulls`;
|
|
70
|
+
|
|
71
|
+
const buildCurl = (authToken) => [
|
|
72
|
+
'curl -sS -X POST',
|
|
73
|
+
`-H ${shQuote(`Authorization: Bearer ${authToken}`)}`,
|
|
74
|
+
`-H ${shQuote('Accept: application/vnd.github+json')}`,
|
|
75
|
+
`-H ${shQuote('Content-Type: application/json')}`,
|
|
76
|
+
`-H ${shQuote('X-GitHub-Api-Version: 2022-11-28')}`,
|
|
77
|
+
`-d ${shQuote(payloadJson)}`,
|
|
78
|
+
`-w ${shQuote('\n%{http_code}')}`,
|
|
79
|
+
url,
|
|
80
|
+
].join(' ');
|
|
81
|
+
|
|
82
|
+
return {
|
|
83
|
+
provider: 'github',
|
|
84
|
+
action: 'create-pull-request',
|
|
85
|
+
command: buildCurl(safeToken),
|
|
86
|
+
logSafeCommand: buildCurl(REDACTED),
|
|
87
|
+
// Interpretation contract mirrors the reverted server-side tool
|
|
88
|
+
// (src/tools/create-pull-request.ts) so callers migrating to
|
|
89
|
+
// VCSModule keep the same success/already-exists/error semantics:
|
|
90
|
+
// - 2xx -> success; body has .number/.html_url
|
|
91
|
+
// - 422 + "already exists" text -> idempotent success
|
|
92
|
+
// - anything else -> error
|
|
93
|
+
interpret: {
|
|
94
|
+
successStatusRange: [200, 299],
|
|
95
|
+
alreadyExistsStatus: 422,
|
|
96
|
+
alreadyExistsPattern: 'already exists',
|
|
97
|
+
},
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** Build the GitHub REST "comment on an issue/PR" curl command, used to
|
|
102
|
+
* annotate an existing PR when a sprint aborts after the PR was already
|
|
103
|
+
* raised (rather than opening a second PR for the same head).
|
|
104
|
+
* POST /repos/{owner}/{repo}/issues/{issue_number}/comments -- see
|
|
105
|
+
* https://docs.github.com/en/rest/issues/comments#create-an-issue-comment */
|
|
106
|
+
function buildGitHubCommentCommand({ repo, issue_number: issueNumber, body, token }) {
|
|
107
|
+
const safeRepo = assertRepo(repo);
|
|
108
|
+
const safeToken = assertToken(token);
|
|
109
|
+
if (!issueNumber) throw new Error('ERROR: VCSModule: "issue_number" is required to build a comment command.');
|
|
110
|
+
if (!body) throw new Error('ERROR: VCSModule: "body" is required to build a comment command.');
|
|
111
|
+
|
|
112
|
+
const payloadJson = JSON.stringify({ body });
|
|
113
|
+
const url = `${GITHUB_API}/repos/${safeRepo}/issues/${issueNumber}/comments`;
|
|
114
|
+
|
|
115
|
+
const buildCurl = (authToken) => [
|
|
116
|
+
'curl -sS -X POST',
|
|
117
|
+
`-H ${shQuote(`Authorization: Bearer ${authToken}`)}`,
|
|
118
|
+
`-H ${shQuote('Accept: application/vnd.github+json')}`,
|
|
119
|
+
`-H ${shQuote('Content-Type: application/json')}`,
|
|
120
|
+
`-H ${shQuote('X-GitHub-Api-Version: 2022-11-28')}`,
|
|
121
|
+
`-d ${shQuote(payloadJson)}`,
|
|
122
|
+
`-w ${shQuote('\n%{http_code}')}`,
|
|
123
|
+
url,
|
|
124
|
+
].join(' ');
|
|
125
|
+
|
|
126
|
+
return {
|
|
127
|
+
provider: 'github',
|
|
128
|
+
action: 'comment',
|
|
129
|
+
command: buildCurl(safeToken),
|
|
130
|
+
logSafeCommand: buildCurl(REDACTED),
|
|
131
|
+
interpret: {
|
|
132
|
+
successStatusRange: [200, 299],
|
|
133
|
+
},
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/** GitHub's credential-rejection literals. "remote: Invalid username or
|
|
138
|
+
* token/password" is what a git push over HTTPS gets back from GitHub with a
|
|
139
|
+
* dead PAT; "Bad credentials" is the REST API's equivalent, which reaches us
|
|
140
|
+
* through the curl commands VCSModule builds. Both mean the token itself is
|
|
141
|
+
* no longer good -- re-provisioning is the remedy, so AUTH_EXPIRED. */
|
|
142
|
+
const AUTH_EXPIRED = [
|
|
143
|
+
/remote: Invalid username or (token|password)/i,
|
|
144
|
+
/Bad credentials/i,
|
|
145
|
+
];
|
|
146
|
+
|
|
147
|
+
// DELIBERATELY ABSENT, and not an oversight: GitHub texts that are NOT in
|
|
148
|
+
// runner.js's pattern tables today -- scope/permission refusals ("Resource not
|
|
149
|
+
// accessible by integration", the vague "remote: Repository not found" for a
|
|
150
|
+
// private repo) and throttling ("API rate limit exceeded", "secondary rate
|
|
151
|
+
// limit"). Each classifies as 'unknown' today, so adding it here would CHANGE
|
|
152
|
+
// the verdict apra-fleet-647.1.3.2 must preserve: a rate-limit text would newly
|
|
153
|
+
// become retryable, a permission refusal would newly trigger the auth
|
|
154
|
+
// self-heal. Widening the taxonomy is a real behavior change and belongs in its
|
|
155
|
+
// own bead with its own tests, not smuggled in under a no-verdict-change
|
|
156
|
+
// consolidation.
|
|
157
|
+
|
|
158
|
+
/** Best-effort GitHub provider code, purely DIAGNOSTIC: never branch on it --
|
|
159
|
+
* branch on `kind`. Returns the HTTP status git/curl surfaced (e.g. '403'
|
|
160
|
+
* from git's "The requested URL returned error: 403", or the trailing status
|
|
161
|
+
* code the VCSModule curl commands append via -w '\n%{http_code}'), else null.
|
|
162
|
+
*
|
|
163
|
+
* Constructed in-function rather than hoisted: these are exec/match calls on
|
|
164
|
+
* patterns that must never carry `lastIndex` state between classifyFailure
|
|
165
|
+
* calls (AC3 purity).
|
|
166
|
+
*/
|
|
167
|
+
function extractProviderCode(raw) {
|
|
168
|
+
const text = String(raw == null ? '' : raw);
|
|
169
|
+
const urlError = text.match(/requested URL returned error:\s*(\d{3})/i);
|
|
170
|
+
if (urlError) return urlError[1];
|
|
171
|
+
const httpStatus = text.match(/\bHTTP(?:\/[\d.]+)?\s+(\d{3})\b/);
|
|
172
|
+
if (httpStatus) return httpStatus[1];
|
|
173
|
+
const trailing = text.match(/(?:^|\n)\s*(\d{3})\s*$/);
|
|
174
|
+
if (trailing) return trailing[1];
|
|
175
|
+
return null;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/** Host-recognition for VCSModule.capabilities() (apra-fleet-647.1.4.1).
|
|
179
|
+
* `github.com` itself plus GitHub Enterprise Server hosts, which have no
|
|
180
|
+
* fixed domain -- an operator names theirs anything ("github.mycompany.com",
|
|
181
|
+
* "ghe.internal", ...) -- so there is no closed literal list to match
|
|
182
|
+
* against. The portable signal every such host shares is the vendor name
|
|
183
|
+
* itself appearing in the hostname; a host with no "github" substring (Azure
|
|
184
|
+
* DevOps' dev.azure.com, GitLab's gitlab.com or a self-hosted
|
|
185
|
+
* gitlab.example.com, ...) is deliberately left to GenericGitVCS's
|
|
186
|
+
* catch-all rather than guessed at here. */
|
|
187
|
+
function matchesHost(host) {
|
|
188
|
+
return typeof host === 'string' && /github/i.test(host);
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/** Every host this provider matches can open a PR via the REST call
|
|
192
|
+
* buildGitHubCreatePrCommand() builds -- github.com and GitHub Enterprise
|
|
193
|
+
* Server alike speak the same `/repos/{owner}/{repo}/pulls` shape. */
|
|
194
|
+
function capabilitiesForHost(_host) {
|
|
195
|
+
return { canOpenPullRequest: true };
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
export const GitHubVCS = Object.freeze({
|
|
199
|
+
name: 'github',
|
|
200
|
+
extends: 'generic-git',
|
|
201
|
+
rules: Object.freeze({
|
|
202
|
+
[K.AUTH_EXPIRED]: AUTH_EXPIRED,
|
|
203
|
+
}),
|
|
204
|
+
extractProviderCode,
|
|
205
|
+
matchesHost,
|
|
206
|
+
capabilitiesForHost,
|
|
207
|
+
// apra-fleet-647.1.5.1: GitHub's own default auth mode (App, never PAT --
|
|
208
|
+
// see vcs-module.mjs resolveProvider()'s header note on why this must stay
|
|
209
|
+
// 'github-app') and its command builders. A provider descriptor need not
|
|
210
|
+
// declare `defaultAuthMode`/`builders` at all (see ./generic-git.mjs,
|
|
211
|
+
// ./dolt.mjs -- classification-only providers that are not a member-facing
|
|
212
|
+
// VCS auth backend); declaring `defaultAuthMode` (even as `null`) is what
|
|
213
|
+
// makes a provider part of resolveProvider()'s/buildVcsCommand()'s known
|
|
214
|
+
// vocabulary -- see ./index.mjs's isAuthBackend().
|
|
215
|
+
defaultAuthMode: 'github-app',
|
|
216
|
+
builders: Object.freeze({
|
|
217
|
+
'create-pull-request': buildGitHubCreatePrCommand,
|
|
218
|
+
comment: buildGitHubCommentCommand,
|
|
219
|
+
}),
|
|
220
|
+
});
|
|
221
|
+
|
|
222
|
+
export default GitHubVCS;
|