@apralabs/apra-fleet 0.4.1 → 0.4.3
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 +53 -12
- package/dist/agents/backlog-groomer.md +42 -21
- package/dist/agents/ci-watcher.md +14 -0
- package/dist/agents/deployer.md +59 -46
- package/dist/agents/doer.md +157 -134
- package/dist/agents/harvester.md +31 -32
- package/dist/agents/integ-test-runner.md +92 -113
- package/dist/agents/kb-reconciler.md +40 -42
- package/dist/agents/plan-reviewer.md +139 -63
- package/dist/agents/planner.md +176 -100
- package/dist/agents/regression-test-runner.md +77 -81
- package/dist/agents/reviewer.md +69 -85
- package/dist/agents/schemas/integ-test-runner-output.json +1 -1
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/regression-test-runner-output.json +4 -17
- package/dist/cli/agent-transform.d.ts +83 -2
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +266 -21
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +29 -11
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +7 -5
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +44 -43
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/install.d.ts +33 -0
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +294 -61
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/kb-directives.d.ts.map +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-directives.js.map +1 -1
- package/dist/cli/register-member.d.ts.map +1 -1
- package/dist/cli/register-member.js +7 -3
- package/dist/cli/register-member.js.map +1 -1
- package/dist/cli/start.d.ts.map +1 -1
- package/dist/cli/start.js +7 -0
- package/dist/cli/start.js.map +1 -1
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +5 -3
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/watch.d.ts +26 -3
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +41 -9
- package/dist/cli/watch.js.map +1 -1
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.d.ts.map +1 -1
- package/dist/commands/kb-server.js +43 -3
- package/dist/commands/kb-server.js.map +1 -1
- package/dist/index.js +3 -3
- package/dist/os/git-bash-candidates.d.ts +35 -0
- package/dist/os/git-bash-candidates.d.ts.map +1 -0
- package/dist/os/git-bash-candidates.js +46 -0
- package/dist/os/git-bash-candidates.js.map +1 -0
- package/dist/os/index.d.ts +13 -4
- package/dist/os/index.d.ts.map +1 -1
- package/dist/os/index.js +17 -2
- package/dist/os/index.js.map +1 -1
- package/dist/os/linux.d.ts +6 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +36 -3
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +68 -2
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/os-commands.js.map +1 -1
- package/dist/os/windows-gitbash.d.ts +98 -0
- package/dist/os/windows-gitbash.d.ts.map +1 -0
- package/dist/os/windows-gitbash.js +259 -0
- package/dist/os/windows-gitbash.js.map +1 -0
- package/dist/os/windows.d.ts +6 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +73 -8
- package/dist/os/windows.js.map +1 -1
- package/dist/providers/agy.d.ts +118 -8
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +580 -55
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +83 -4
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +365 -12
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +7 -4
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +24 -4
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +7 -4
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +27 -4
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/index.d.ts +0 -1
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +0 -3
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +7 -4
- package/dist/providers/none.d.ts.map +1 -1
- package/dist/providers/none.js +22 -4
- package/dist/providers/none.js.map +1 -1
- package/dist/providers/opencode.d.ts +6 -3
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +27 -4
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +215 -11
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +58 -2
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.js +2 -2
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/agy-project.d.ts +102 -0
- package/dist/services/agy-project.d.ts.map +1 -0
- package/dist/services/agy-project.js +356 -0
- package/dist/services/agy-project.js.map +1 -0
- package/dist/services/auth-socket.js +4 -4
- package/dist/services/auth-web.js +1 -1
- package/dist/services/cloud/activity.js +2 -2
- package/dist/services/cloud/activity.js.map +1 -1
- package/dist/services/cloud/lifecycle.d.ts.map +1 -1
- package/dist/services/cloud/lifecycle.js +33 -4
- package/dist/services/cloud/lifecycle.js.map +1 -1
- package/dist/services/context-admission.d.ts.map +1 -1
- package/dist/services/context-admission.js +9 -7
- package/dist/services/context-admission.js.map +1 -1
- package/dist/services/credential-cleanup.d.ts.map +1 -1
- package/dist/services/credential-cleanup.js +47 -10
- package/dist/services/credential-cleanup.js.map +1 -1
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.d.ts.map +1 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/exit-drain.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +32 -4
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +1 -0
- package/dist/services/http-transport.d.ts.map +1 -1
- package/dist/services/http-transport.js +48 -1
- package/dist/services/http-transport.js.map +1 -1
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.d.ts.map +1 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-config.js.map +1 -0
- package/dist/services/knowledge/kb-providers.d.ts +7 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
- package/dist/services/knowledge/kb-providers.js +191 -17
- package/dist/services/knowledge/kb-providers.js.map +1 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
- package/dist/services/member-home.d.ts +1 -1
- package/dist/services/member-home.d.ts.map +1 -1
- package/dist/services/member-home.js +15 -12
- package/dist/services/member-home.js.map +1 -1
- package/dist/services/model-pricing.d.ts.map +1 -1
- package/dist/services/model-pricing.js +7 -8
- package/dist/services/model-pricing.js.map +1 -1
- package/dist/services/orphan-recovery.d.ts +6 -3
- package/dist/services/orphan-recovery.d.ts.map +1 -1
- package/dist/services/orphan-recovery.js +17 -14
- package/dist/services/orphan-recovery.js.map +1 -1
- package/dist/services/preflight-check.js +2 -2
- package/dist/services/preflight-check.js.map +1 -1
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.d.ts.map +1 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/secret-token.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +3 -1
- package/dist/services/service-manager/types.d.ts.map +1 -1
- package/dist/services/service-manager/windows.d.ts +14 -2
- package/dist/services/service-manager/windows.d.ts.map +1 -1
- package/dist/services/service-manager/windows.js +65 -7
- package/dist/services/service-manager/windows.js.map +1 -1
- package/dist/services/shell-probe.d.ts +131 -0
- package/dist/services/shell-probe.d.ts.map +1 -0
- package/dist/services/shell-probe.js +210 -0
- package/dist/services/shell-probe.js.map +1 -0
- package/dist/services/singleton.d.ts +2 -0
- package/dist/services/singleton.d.ts.map +1 -1
- package/dist/services/singleton.js +1 -1
- package/dist/services/singleton.js.map +1 -1
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +60 -4
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/find-log-file.d.ts.map +1 -1
- package/dist/services/stall/find-log-file.js +22 -16
- package/dist/services/stall/find-log-file.js.map +1 -1
- package/dist/services/stall/read-log-tail.d.ts.map +1 -1
- package/dist/services/stall/read-log-tail.js +26 -15
- package/dist/services/stall/read-log-tail.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts +53 -4
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +212 -34
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +35 -42
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts +9 -0
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +119 -8
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/substitution-engine.js.map +1 -1
- package/dist/services/tool-registry.d.ts.map +1 -1
- package/dist/services/tool-registry.js +5 -3
- package/dist/services/tool-registry.js.map +1 -1
- package/dist/services/user-config.js +1 -1
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/azure-devops.d.ts +67 -2
- package/dist/services/vcs/azure-devops.d.ts.map +1 -1
- package/dist/services/vcs/azure-devops.js +281 -15
- package/dist/services/vcs/azure-devops.js.map +1 -1
- package/dist/services/vcs/bitbucket.d.ts.map +1 -1
- package/dist/services/vcs/bitbucket.js +16 -0
- package/dist/services/vcs/bitbucket.js.map +1 -1
- package/dist/services/vcs/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +24 -0
- package/dist/services/vcs/github.js.map +1 -1
- package/dist/services/vcs/types.d.ts +123 -2
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +20 -1
- package/dist/skills/pm/SKILL.md +1 -2
- package/dist/skills/pm/cost.md +0 -4
- package/dist/skills/pm/fleet-addendum.md +2 -3
- package/dist/tools/check-status.d.ts +7 -4
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +5 -3
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/cloud-control.js +2 -2
- package/dist/tools/cloud-control.js.map +1 -1
- package/dist/tools/compose-permissions.d.ts +6 -0
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +211 -50
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +56 -29
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +15 -2
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +1214 -873
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/kb-capture.d.ts +2 -2
- package/dist/tools/kb-capture.d.ts.map +1 -1
- package/dist/tools/kb-capture.js +29 -5
- package/dist/tools/kb-capture.js.map +1 -1
- package/dist/tools/kb-export.d.ts +2 -2
- package/dist/tools/kb-export.d.ts.map +1 -1
- package/dist/tools/kb-export.js +3 -28
- package/dist/tools/kb-export.js.map +1 -1
- package/dist/tools/kb-feedback.d.ts.map +1 -1
- package/dist/tools/kb-feedback.js +3 -1
- package/dist/tools/kb-feedback.js.map +1 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
- package/dist/tools/kb-freshness-sweep.js +3 -1
- package/dist/tools/kb-freshness-sweep.js.map +1 -1
- package/dist/tools/kb-import.d.ts.map +1 -1
- package/dist/tools/kb-import.js +2 -1
- package/dist/tools/kb-import.js.map +1 -1
- package/dist/tools/kb-list.d.ts.map +1 -1
- package/dist/tools/kb-list.js +3 -1
- package/dist/tools/kb-list.js.map +1 -1
- package/dist/tools/kb-query.d.ts +2 -2
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
- package/dist/tools/kb-reconcile-prefilter.js +3 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
- package/dist/tools/kb-resolve-contradiction.js +3 -1
- package/dist/tools/kb-resolve-contradiction.js.map +1 -1
- package/dist/tools/kb-setup.d.ts.map +1 -1
- package/dist/tools/kb-setup.js +125 -20
- package/dist/tools/kb-setup.js.map +1 -1
- package/dist/tools/kb-stats.d.ts.map +1 -1
- package/dist/tools/kb-stats.js +64 -43
- package/dist/tools/kb-stats.js.map +1 -1
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +7 -2
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +2 -2
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +22 -3
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +58 -1
- package/dist/tools/member-reservation.d.ts.map +1 -1
- package/dist/tools/member-reservation.js +71 -18
- package/dist/tools/member-reservation.js.map +1 -1
- package/dist/tools/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +17 -2
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.d.ts +80 -1
- package/dist/tools/provision-auth.d.ts.map +1 -1
- package/dist/tools/provision-auth.js +147 -59
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +96 -3
- package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
- package/dist/tools/provision-vcs-auth.js +254 -88
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +21 -12
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +141 -16
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts.map +1 -1
- package/dist/tools/remove-member.js +29 -4
- package/dist/tools/remove-member.js.map +1 -1
- package/dist/tools/revoke-vcs-auth.js +2 -2
- package/dist/tools/revoke-vcs-auth.js.map +1 -1
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/setup-git-app.d.ts.map +1 -1
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/setup-git-app.js.map +1 -1
- package/dist/tools/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +2 -1
- package/dist/tools/setup-ssh-key.js.map +1 -1
- 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 +23 -1
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/stop-prompt.js +2 -2
- package/dist/tools/stop-prompt.js.map +1 -1
- package/dist/tools/update-agent-cli.js +2 -2
- package/dist/tools/update-agent-cli.js.map +1 -1
- package/dist/tools/update-member.d.ts +21 -12
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +61 -12
- package/dist/tools/update-member.js.map +1 -1
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
- package/dist/tools/vcs-credential-exec.js +197 -0
- package/dist/tools/vcs-credential-exec.js.map +1 -0
- package/dist/types.d.ts +24 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +36 -0
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +39 -1
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/log-helpers.d.ts.map +1 -1
- package/dist/utils/log-helpers.js +2 -2
- package/dist/utils/log-helpers.js.map +1 -1
- package/dist/utils/platform.d.ts +7 -0
- package/dist/utils/platform.d.ts.map +1 -1
- package/dist/utils/platform.js +11 -1
- package/dist/utils/platform.js.map +1 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +7 -1
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/shell-escape.d.ts +16 -0
- package/dist/utils/shell-escape.d.ts.map +1 -1
- package/dist/utils/shell-escape.js +22 -2
- package/dist/utils/shell-escape.js.map +1 -1
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/vcs-provider-detect.js.map +1 -0
- package/dist/utils/workspace-trust.d.ts +20 -17
- package/dist/utils/workspace-trust.d.ts.map +1 -1
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/utils/workspace-trust.js.map +1 -1
- package/dist/workflows/auto-sprint.js +180 -32
- package/package.json +7 -5
- package/packages/apra-fleet-client/src/client/api.mjs +403 -12
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +42 -21
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +14 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -46
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +157 -134
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +31 -32
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +92 -113
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +40 -42
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +139 -63
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +176 -100
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +77 -81
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +69 -85
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -3
- package/packages/apra-fleet-se/bin/cli.mjs +280 -3
- package/packages/apra-fleet-se/bin/serve.mjs +114 -5
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +199 -34
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +285 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +12 -12
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1054 -39
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +308 -0
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +556 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1672 -9072
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +159 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +20 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +211 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +204 -19
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +707 -12
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +191 -43
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +333 -6
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +165 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +167 -37
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +178 -1
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +478 -32
- package/skills/fleet/SKILL.md +27 -16
- package/skills/fleet/auth-azdevops.md +57 -7
- package/skills/fleet/auth-bitbucket.md +5 -5
- package/skills/fleet/auth-github.md +7 -6
- package/skills/fleet/beads-conflict-resolution.md +141 -0
- package/skills/fleet/beads.md +16 -12
- package/skills/fleet/onboarding.md +6 -6
- package/skills/fleet/permissions.md +11 -7
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/skill-matrix.md +1 -1
- package/skills/fleet/troubleshooting.md +4 -3
- package/version.json +1 -1
- package/dist/providers/gemini.d.ts +0 -52
- package/dist/providers/gemini.d.ts.map +0 -1
- package/dist/providers/gemini.js +0 -236
- package/dist/providers/gemini.js.map +0 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Shared MCP result-text helpers (apra-fleet-3swo.2.4).
|
|
3
|
+
//
|
|
4
|
+
// Extracted move-only from fleet-sprint/runner.js, which defined `resultText`
|
|
5
|
+
// TWICE as identical inner functions (inside createMemberReservationClient and
|
|
6
|
+
// createMemberSessionGuard) plus a separate module-level `toolErrorText`. This
|
|
7
|
+
// module is now the single owner of both; runner.js imports and re-exports
|
|
8
|
+
// them so its existing facade (67 direct importers) stays intact.
|
|
9
|
+
//
|
|
10
|
+
// Behavior is unchanged, including how an empty or missing MCP `content`
|
|
11
|
+
// array is handled: `resultText` returns '' in that case, which several
|
|
12
|
+
// runner.js call sites log with a `|| '(no detail)'` fallback that appears
|
|
13
|
+
// verbatim in golden transcripts -- do not change this without checking those
|
|
14
|
+
// fixtures.
|
|
15
|
+
//
|
|
16
|
+
// content[0] is NOT reliably the tool result: src/services/tool-registry.ts
|
|
17
|
+
// wrapTool() may prepend a user-audience onboarding/welcome-back display
|
|
18
|
+
// banner ahead of the real result (and append a nudge suffix banner after
|
|
19
|
+
// it). resultText skips any content entry that is such a banner --
|
|
20
|
+
// identified by annotations.audience containing 'user', or by its text
|
|
21
|
+
// containing an <apra-fleet-display> open tag as a belt-and-braces fallback
|
|
22
|
+
// -- and returns the first entry that is not one.
|
|
23
|
+
// =============================================================================
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* True when a content entry is a user-audience display banner (onboarding
|
|
27
|
+
* preamble or nudge suffix) rather than actual tool output.
|
|
28
|
+
* @param {any} entry
|
|
29
|
+
* @returns {boolean}
|
|
30
|
+
*/
|
|
31
|
+
function isDisplayBanner(entry) {
|
|
32
|
+
if (!entry) return false;
|
|
33
|
+
if (entry.annotations && Array.isArray(entry.annotations.audience) && entry.annotations.audience.includes('user')) {
|
|
34
|
+
return true;
|
|
35
|
+
}
|
|
36
|
+
return typeof entry.text === 'string' && /<apra-fleet-display[^>]*>/i.test(entry.text);
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Best-effort human-readable text out of an MCP tool result's content array.
|
|
41
|
+
* Accepts a raw string result too (some callers pass one through directly).
|
|
42
|
+
* @param {any} result
|
|
43
|
+
* @returns {string}
|
|
44
|
+
*/
|
|
45
|
+
export function resultText(result) {
|
|
46
|
+
if (typeof result === 'string') return result;
|
|
47
|
+
if (result && Array.isArray(result.content)) {
|
|
48
|
+
for (const entry of result.content) {
|
|
49
|
+
if (entry && typeof entry.text === 'string' && !isDisplayBanner(entry)) {
|
|
50
|
+
return entry.text;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
return '';
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Best-effort human-readable text out of an MCP error result, for logging.
|
|
59
|
+
* Skips any display banner the same way resultText() does (apra-fleet-3swo.63):
|
|
60
|
+
* content[0] is not reliably the tool's error text -- wrapTool() may prepend a
|
|
61
|
+
* user-audience onboarding/welcome-back banner ahead of it -- so an unfiltered
|
|
62
|
+
* `res.content[0]` read can log the banner text as if it were the error.
|
|
63
|
+
* @param {any} res
|
|
64
|
+
* @returns {string}
|
|
65
|
+
*/
|
|
66
|
+
export function toolErrorText(res) {
|
|
67
|
+
if (res && Array.isArray(res.content)) {
|
|
68
|
+
for (const entry of res.content) {
|
|
69
|
+
if (entry && typeof entry.text === 'string' && entry.text && !isDisplayBanner(entry)) {
|
|
70
|
+
return entry.text;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
return 'no error text returned';
|
|
75
|
+
}
|
|
@@ -0,0 +1,252 @@
|
|
|
1
|
+
// Member-provisioning helpers -- extracted move-only out of runner.js
|
|
2
|
+
// (apra-fleet-3swo.6.12). This module owns:
|
|
3
|
+
//
|
|
4
|
+
// 1. createMemberSessionGuard -- the pre-resume `stop_prompt` guard that
|
|
5
|
+
// kills a prior, presumed-dead-or-timed-out session on a member before a
|
|
6
|
+
// resume re-dispatch, so two live sessions never duplicate one logical
|
|
7
|
+
// dispatch's side effects.
|
|
8
|
+
// 2. createUnattendedAutoProvisioner -- best-effort sets a member's
|
|
9
|
+
// `unattended: 'auto'` registration before it is dispatched as deployer/
|
|
10
|
+
// integ-test-runner/regression-test-runner, cached per member for the
|
|
11
|
+
// lifetime of the returned function.
|
|
12
|
+
// 3. createDeployPermissionsProvisioner -- best-effort self-heal that reads
|
|
13
|
+
// deploy.md's own `## Permissions` section off the first target member
|
|
14
|
+
// it provisions and proactively grants every listed prefix via
|
|
15
|
+
// compose_permissions, so a runbook permissions change does not have to
|
|
16
|
+
// wait for a dispatch to fail before anyone notices.
|
|
17
|
+
// 4. stageCommandBodyMemberSide -- stages free-text content to a fresh,
|
|
18
|
+
// member-LOCAL temp file via a shell-agnostic `node -e` one-liner (base64
|
|
19
|
+
// argv, no `$`-expansion/backticks/template literals), so a `bd
|
|
20
|
+
// --body-file` read always finds its file on the same filesystem the
|
|
21
|
+
// subsequent `bd` command runs on.
|
|
22
|
+
//
|
|
23
|
+
// WHAT DID NOT MOVE -- resolveSettleShell. It sat in the middle of this group
|
|
24
|
+
// in runner.js and is module-private wiring: it resolves a member's settle
|
|
25
|
+
// shell from the per-sprint sprintState that sprint-state.mjs introduced,
|
|
26
|
+
// which is composition-root wiring rather than an implementation helper.
|
|
27
|
+
// test/sprint-state.test.mjs also anchors it to runner.js by symbol. It stays
|
|
28
|
+
// defined and exported from runner.js; nothing here imports it back, since
|
|
29
|
+
// none of the four moved symbols call it.
|
|
30
|
+
//
|
|
31
|
+
// runner.js re-exports every symbol it previously exported from this region,
|
|
32
|
+
// so existing importers of fleet-sprint/runner.js resolve unchanged.
|
|
33
|
+
//
|
|
34
|
+
// GUARD REGISTRATION: this module is registered in ./guarded-modules.mjs as
|
|
35
|
+
// part of this extraction (see that file's STANDING RULE). It carries the two
|
|
36
|
+
// member_name-bearing command() call sites this extraction took out of
|
|
37
|
+
// runner.js: createDeployPermissionsProvisioner's `node -e ...` read of
|
|
38
|
+
// deploy.md's Permissions section, and stageCommandBodyMemberSide's `node -e
|
|
39
|
+
// ...` member-side temp-file write. Both already avoid shell-level variable
|
|
40
|
+
// expansion (base64-encoded argv, no `$`/backtick/template-literal
|
|
41
|
+
// interpolation), which is exactly the invariant shell-command-guard.mjs
|
|
42
|
+
// enforces and reads GUARDED_MODULES to find.
|
|
43
|
+
|
|
44
|
+
import { ApraFleet } from '@apralabs/apra-fleet-client';
|
|
45
|
+
import { resultText } from './mcp-result.mjs';
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Guards every "resume" re-dispatch below against spawning a second
|
|
49
|
+
* concurrent session on a member whose PRIOR process for that same logical
|
|
50
|
+
* dispatch is presumed dead or timed out but may still be alive -- two live
|
|
51
|
+
* sessions for one dispatch duplicate whatever side effects the orphaned one
|
|
52
|
+
* performs.
|
|
53
|
+
*
|
|
54
|
+
* Before firing a resume, call the fleet's own `stop_prompt` tool
|
|
55
|
+
* (src/tools/stop-prompt.ts) for that member: it kills whatever process is
|
|
56
|
+
* still on record and is a no-op when nothing is running, so pid liveness is
|
|
57
|
+
* never reimplemented here.
|
|
58
|
+
*
|
|
59
|
+
* `callTool` is injected (the caller's MCP client), so this stays
|
|
60
|
+
* transport-agnostic and unit-testable without a live fleet server. When it
|
|
61
|
+
* is omitted, `killIfAlive()` is a no-op -- there is no live fleet connection
|
|
62
|
+
* to guard against, matching every other best-effort client in this file when
|
|
63
|
+
* its transport is absent.
|
|
64
|
+
*
|
|
65
|
+
* Best-effort by design: a `stop_prompt` failure is logged and swallowed
|
|
66
|
+
* rather than blocking the resume -- the resume is what the sprint needs to
|
|
67
|
+
* make progress, and this guard REDUCES rather than gates the chance of a
|
|
68
|
+
* duplicate concurrent session.
|
|
69
|
+
*
|
|
70
|
+
* @param {{ callTool?: (name: string, args: object) => Promise<any>, log?: Function }} opts
|
|
71
|
+
* @returns {{ killIfAlive: (member: string) => Promise<void> }}
|
|
72
|
+
*/
|
|
73
|
+
export function createMemberSessionGuard(opts = {}) {
|
|
74
|
+
const { callTool, log = () => {} } = opts;
|
|
75
|
+
const active = typeof callTool === 'function';
|
|
76
|
+
|
|
77
|
+
return {
|
|
78
|
+
async killIfAlive(member) {
|
|
79
|
+
if (!active || !member) return;
|
|
80
|
+
try {
|
|
81
|
+
const result = await callTool('stop_prompt', { member_name: member });
|
|
82
|
+
log(`[member-session-guard] pre-resume stop_prompt for '${member}': ${resultText(result) || '(no detail)'}`);
|
|
83
|
+
} catch (err) {
|
|
84
|
+
log(`[member-session-guard] pre-resume stop_prompt for '${member}' failed (non-fatal; resume proceeds): ${err.message}`);
|
|
85
|
+
}
|
|
86
|
+
},
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* Best-effort provisions a member for unattended execution (`unattended:
|
|
92
|
+
* 'auto'`) before dispatching it as deployer, integ-test-runner, or
|
|
93
|
+
* regression-test-runner -- roles that run real deploy commands and test
|
|
94
|
+
* suites via a runbook and must never stall on an interactive permission
|
|
95
|
+
* prompt. Provisioning is a one-way member-registration change and is
|
|
96
|
+
* deliberately NOT reverted after the dispatch: `unattended` lives on the
|
|
97
|
+
* member (update_member), not on the dispatch, so there is nothing to revert
|
|
98
|
+
* to without also clobbering whatever the user set intentionally. In a
|
|
99
|
+
* single-member sprint the same member also plays doer/reviewer/etc, so it
|
|
100
|
+
* ends up unattended='auto' too -- accepted, not a bug.
|
|
101
|
+
*
|
|
102
|
+
* Cached per member for the lifetime of the returned function, so a sprint
|
|
103
|
+
* with many deploy/integ/regression dispatches across cycles calls
|
|
104
|
+
* update_member at most once per member. A failure (fleet unreachable,
|
|
105
|
+
* member not found) is logged and swallowed -- exactly like
|
|
106
|
+
* createMemberVcsProviderResolver above -- so a provisioning hiccup degrades
|
|
107
|
+
* to whatever permission mode the member already had, rather than aborting
|
|
108
|
+
* the phase.
|
|
109
|
+
*
|
|
110
|
+
* `callTool` is injected (the caller's MCP client), so this stays
|
|
111
|
+
* transport-agnostic and unit-testable without a live fleet server.
|
|
112
|
+
*
|
|
113
|
+
* @param {{ callTool: (name: string, args: object) => Promise<any>, log?: Function }} opts
|
|
114
|
+
* @returns {(member: string) => Promise<void>}
|
|
115
|
+
*/
|
|
116
|
+
export function createUnattendedAutoProvisioner(opts = {}) {
|
|
117
|
+
const { callTool, log = () => {} } = opts;
|
|
118
|
+
const fleetApi = new ApraFleet({ callTool });
|
|
119
|
+
/** @type {Set<string>} members already confirmed unattended='auto' this run. */
|
|
120
|
+
const provisioned = new Set();
|
|
121
|
+
|
|
122
|
+
return async function ensureUnattendedAuto(member) {
|
|
123
|
+
if (provisioned.has(member)) return;
|
|
124
|
+
try {
|
|
125
|
+
await fleetApi.updateMember({ member_name: member, unattended: 'auto' });
|
|
126
|
+
provisioned.add(member);
|
|
127
|
+
log(`[unattended] member '${member}' set to unattended='auto' for this dispatch.`);
|
|
128
|
+
} catch (err) {
|
|
129
|
+
log(`[unattended] could not set unattended='auto' on member '${member}' (continuing with its existing permission mode): ${err.message}`);
|
|
130
|
+
}
|
|
131
|
+
};
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* Best-effort, self-heals the "Missing permission" class of deploy/integ/
|
|
136
|
+
* regression-test failure BEFORE it happens: reads deploy.md's own
|
|
137
|
+
* `## Permissions` section -- the exact list the deployer/integ-test-runner/
|
|
138
|
+
* regression-test-runner agent prompts already cross-check at their own
|
|
139
|
+
* Step 0a/0 -- and proactively grants every listed prefix to the target
|
|
140
|
+
* member via compose_permissions. Without this, a runbook permissions
|
|
141
|
+
* change (e.g. the `apra-fleet start` -> `apra-fleet run` swap, #395) only
|
|
142
|
+
* gets noticed when a dispatch fails, and only gets fixed once an operator
|
|
143
|
+
* greps deploy.md by hand and runs compose_permissions manually -- exactly
|
|
144
|
+
* the failure mode this closes the loop on.
|
|
145
|
+
*
|
|
146
|
+
* Reads deploy.md via `command()` against the FIRST target member it is asked
|
|
147
|
+
* to provision (that member is about to be dispatched as deployer/
|
|
148
|
+
* integ-test-runner/regression-test-runner, so its own checkout is the source
|
|
149
|
+
* of truth for what it is about to run) and caches the parsed prefix list for
|
|
150
|
+
* the lifetime of the returned function -- one read per sprint run, since
|
|
151
|
+
* deploy.md does not change mid-run on a healthy pipeline. Also caches per
|
|
152
|
+
* TARGET member, like createUnattendedAutoProvisioner above, so repeat cycles
|
|
153
|
+
* don't re-grant. Deliberately does NOT read via a separate orchestrator
|
|
154
|
+
* member: the orchestrator role may be shared/unreservable across concurrent
|
|
155
|
+
* sprints and carries no git checkout of its own to read from.
|
|
156
|
+
*
|
|
157
|
+
* Failure at any step (probe fails, deploy.md missing/unparseable,
|
|
158
|
+
* compose_permissions unreachable, a listed prefix hitting the
|
|
159
|
+
* NEVER_AUTO_GRANT denylist) is logged and swallowed. This is pure
|
|
160
|
+
* best-effort acceleration -- the deployer's own Step 0a check remains the
|
|
161
|
+
* authoritative, fail-closed backstop regardless of whether this succeeds.
|
|
162
|
+
*
|
|
163
|
+
* @param {{ callTool: (name: string, args: object) => Promise<any>, command: Function, log?: Function }} opts
|
|
164
|
+
* @returns {(member: string) => Promise<void>}
|
|
165
|
+
*/
|
|
166
|
+
export function createDeployPermissionsProvisioner(opts = {}) {
|
|
167
|
+
const { callTool, command, log = () => {} } = opts;
|
|
168
|
+
const fleetApi = new ApraFleet({ callTool });
|
|
169
|
+
/** @type {Set<string>} members already granted deploy.md's permissions this run. */
|
|
170
|
+
const provisioned = new Set();
|
|
171
|
+
/** @type {string[] | null | undefined} undefined = not yet attempted. */
|
|
172
|
+
let cachedPrefixes;
|
|
173
|
+
|
|
174
|
+
async function loadRequiredPrefixes(targetMember) {
|
|
175
|
+
if (cachedPrefixes !== undefined) return cachedPrefixes;
|
|
176
|
+
try {
|
|
177
|
+
const res = await command(
|
|
178
|
+
`node -e "const fs=require('fs'); if(fs.existsSync('deploy.md')) process.stdout.write(fs.readFileSync('deploy.md','utf8'))"`,
|
|
179
|
+
{ member_name: targetMember, silent: true, label: `Read deploy.md permissions`, failSoft: true },
|
|
180
|
+
);
|
|
181
|
+
if (!res.ok || !res.output) {
|
|
182
|
+
cachedPrefixes = null;
|
|
183
|
+
} else {
|
|
184
|
+
const section = res.output.split(/^## Permissions/m)[1]?.split(/^## /m)[0] ?? '';
|
|
185
|
+
const prefixes = [...section.matchAll(/^-\s*`([^`]+)`/gm)].map(m => m[1]);
|
|
186
|
+
cachedPrefixes = prefixes.length ? prefixes : null;
|
|
187
|
+
}
|
|
188
|
+
} catch (err) {
|
|
189
|
+
log(`[deploy-permissions] could not read deploy.md's Permissions section (continuing without auto-provisioning): ${err.message}`);
|
|
190
|
+
cachedPrefixes = null;
|
|
191
|
+
}
|
|
192
|
+
return cachedPrefixes;
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
return async function ensureDeployPermissions(member) {
|
|
196
|
+
if (!member || provisioned.has(member)) return;
|
|
197
|
+
const prefixes = await loadRequiredPrefixes(member);
|
|
198
|
+
if (!prefixes) return;
|
|
199
|
+
try {
|
|
200
|
+
const result = await fleetApi.composePermissions({
|
|
201
|
+
member_name: member,
|
|
202
|
+
role: 'doer',
|
|
203
|
+
grant: prefixes,
|
|
204
|
+
grant_reason: "deploy.md's declared Permissions section, auto-provisioned before dispatch",
|
|
205
|
+
});
|
|
206
|
+
provisioned.add(member);
|
|
207
|
+
log(`[deploy-permissions] ensured deploy.md's required permissions on '${member}': ${result}`);
|
|
208
|
+
} catch (err) {
|
|
209
|
+
log(`[deploy-permissions] could not auto-provision deploy.md permissions on '${member}' (continuing -- the deployer's own Step 0a check remains the backstop): ${err.message}`);
|
|
210
|
+
}
|
|
211
|
+
};
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
/**
|
|
215
|
+
* Stage `content` to a fresh temp file ON THE MEMBER that will run the
|
|
216
|
+
* subsequent `bd` command, and return that MEMBER-LOCAL absolute path.
|
|
217
|
+
* `command()` may dispatch `bd` to a different machine than the workflow
|
|
218
|
+
* engine runs on, so a body file written to the engine host's own tmpdir
|
|
219
|
+
* would not exist where `bd --body-file` reads it. Staging via `command()`
|
|
220
|
+
* (member_name: member) guarantees the file lands on the SAME filesystem.
|
|
221
|
+
*
|
|
222
|
+
* The write is performed by a member-side `node` one-liner -- `node` is
|
|
223
|
+
* present on every fleet member -- and the recipe is shell-agnostic: it
|
|
224
|
+
* contains no `$`-expansion, backticks, template literals, or `%`-vars, so it
|
|
225
|
+
* is inert as syntax in POSIX shells, PowerShell, and cmd.exe alike.
|
|
226
|
+
* `content` is base64-encoded and passed as a SINGLE argv token whose
|
|
227
|
+
* alphabet (A-Za-z0-9+/=) is likewise inert in all of those shells, and node
|
|
228
|
+
* decodes it back to the exact literal bytes. This is the injection-safety
|
|
229
|
+
* property: caller-supplied free text is NEVER interpolated into the shell
|
|
230
|
+
* command string. The staged file is a member-side OS temp file the member's
|
|
231
|
+
* OS reaps on its own.
|
|
232
|
+
* @param {{ command: Function, member: string, content: string, label?: string }} opts
|
|
233
|
+
* @returns {Promise<string>} the MEMBER-LOCAL temp file path
|
|
234
|
+
*/
|
|
235
|
+
export async function stageCommandBodyMemberSide({ command, member, content, label }) {
|
|
236
|
+
const b64 = Buffer.from(content, 'utf-8').toString('base64');
|
|
237
|
+
// No backticks / no `$` / no template literals: inert across POSIX,
|
|
238
|
+
// PowerShell, and cmd.exe. Reads the base64 body from argv[1] (the first
|
|
239
|
+
// arg after the `-e` script), decodes it to raw bytes, writes them to a
|
|
240
|
+
// fresh member-local temp file, and prints ONLY that path to stdout.
|
|
241
|
+
const stageScript =
|
|
242
|
+
"const os=require('os'),p=require('path'),fs=require('fs');" +
|
|
243
|
+
"const f=p.join(os.tmpdir(),'fleet-sprint-body-'+process.pid+'-'+Date.now()+'-'+Math.random().toString(36).slice(2)+'.txt');" +
|
|
244
|
+
"fs.writeFileSync(f,Buffer.from(process.argv[1],'base64'));process.stdout.write(f)";
|
|
245
|
+
const out = await command(
|
|
246
|
+
`node -e "${stageScript}" "${b64}"`,
|
|
247
|
+
{ member_name: member, silent: true, label: label ?? 'Stage bd body file member-side' }
|
|
248
|
+
);
|
|
249
|
+
const staged = String(out ?? '').trim();
|
|
250
|
+
if (!staged) throw new Error('member-side body staging returned an empty path');
|
|
251
|
+
return staged;
|
|
252
|
+
}
|