@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,211 @@
|
|
|
1
|
+
// apra-fleet-hzeb.4.2 -- fleet-sprint usage-limit pause/resume/re-probe
|
|
2
|
+
// controller.
|
|
3
|
+
//
|
|
4
|
+
// This module owns the cooperative-pause control loop a role dispatch enters
|
|
5
|
+
// when a provider reports a usage/rate limit (execute_prompt relays it as an
|
|
6
|
+
// AgentDispatchError whose details.reason === 'usage_limit', carrying the
|
|
7
|
+
// provider's UsageLimitSignal on details.usageLimit). It is INJECTED into
|
|
8
|
+
// dispatch-role.mjs as ctx.onUsageLimit by runner.js -- never imported there,
|
|
9
|
+
// so the engine stays free of runner-side primitives (requestPause/
|
|
10
|
+
// requestResume/agent) and this loop stays unit-testable with an injected
|
|
11
|
+
// clock, sleep and agent (no real waits, no live fleet).
|
|
12
|
+
//
|
|
13
|
+
// WHY A DEDICATED MODULE (not inline in runner.js): the probe is a REAL
|
|
14
|
+
// agent() dispatch, and runner.js's dispatch-safety census pins its own
|
|
15
|
+
// agent() call-site count at zero now that every role ladder runs through the
|
|
16
|
+
// dispatchRole engine. Housing the probe here keeps that census intact while
|
|
17
|
+
// still guarding this dispatch site under the shared guarded-module list
|
|
18
|
+
// (member_name is spelled explicitly at the call site, exactly as
|
|
19
|
+
// dispatch-safety-guard.mjs requires).
|
|
20
|
+
//
|
|
21
|
+
// WHAT THIS DOES NOT DO: it never invents its own wait window. The guessed
|
|
22
|
+
// one-hour fallback is the PROVIDER adapter's (provider.ts's
|
|
23
|
+
// DEFAULT_USAGE_LIMIT_RESUME_MS, surfaced on the signal's resumeAt); this
|
|
24
|
+
// controller only ever reads the signal's resumeAt or steps the reprobe
|
|
25
|
+
// backoff ladder from role-policies.mjs. It deliberately hard-codes no
|
|
26
|
+
// millisecond wait window of its own.
|
|
27
|
+
//
|
|
28
|
+
// KNOWN SIMPLIFICATIONS (apra-fleet-hzeb.10 -- documented, not fixed here):
|
|
29
|
+
// (1) the pause this controller requests is SPRINT-WIDE, not per-member --
|
|
30
|
+
// only the rate-limited `member` is re-probed above; every other member's
|
|
31
|
+
// dispatches are simply gated by the engine's cooperative pause rather than
|
|
32
|
+
// each being individually probed for its own usage limit.
|
|
33
|
+
// (2) a pause held longer than ~30 minutes (DEFAULT_IDLE_TIMEOUT_MS in
|
|
34
|
+
// src/services/cloud/idle-manager.ts) can let the idle manager suspend a
|
|
35
|
+
// cloud member's VM while it sits reservation-released during the wait;
|
|
36
|
+
// ensureCloudReady (src/tools/execute-prompt.ts) transparently restarts it
|
|
37
|
+
// on the probe dispatch above, so this is logged but given no special
|
|
38
|
+
// handling here.
|
|
39
|
+
import { CancelledError } from '@apralabs/apra-fleet-workflow';
|
|
40
|
+
import { isUsageLimitDispatchError, usageLimitOf, UsageLimitWaitExhaustedError } from './errors.mjs';
|
|
41
|
+
import { USAGE_LIMIT_BUDGET_DEFAULTS } from './role-policies.mjs';
|
|
42
|
+
|
|
43
|
+
// A minimal, target-agnostic probe. Its ONLY purpose is to observe whether the
|
|
44
|
+
// member still trips the usage limit, so it is the shortest possible real
|
|
45
|
+
// dispatch: one turn, a one-line generic prompt (no target-repo assumptions,
|
|
46
|
+
// no bead ids -- check-generic-boundary.mjs), a fresh session, a short timeout.
|
|
47
|
+
const PROBE_PROMPT = 'Reply with the single word: ok.';
|
|
48
|
+
const PROBE_TIMEOUT_S = 60;
|
|
49
|
+
|
|
50
|
+
/** The default injected sleep: a non-blocking timer that keeps the event loop
|
|
51
|
+
* (and the viewer's /state endpoint) responsive while the sprint is paused. */
|
|
52
|
+
function defaultSleep(ms) {
|
|
53
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Builds the ctx.onUsageLimit controller dispatch-role.mjs arms when a role's
|
|
58
|
+
* retry.usageLimitPause is set.
|
|
59
|
+
*
|
|
60
|
+
* @param {object} deps
|
|
61
|
+
* @param {(reason: string, opts?: { resumeAt?: string, source?: string }) => (void|Promise<void>)} deps.requestPause
|
|
62
|
+
* engine cooperative-pause primitive (script-facing, apra-fleet-hzeb.3): pausing
|
|
63
|
+
* releases member reservations, the watchdog reads PAUSED, and the dashboard
|
|
64
|
+
* shows the expected resume time.
|
|
65
|
+
* @param {(reason: string) => Promise<void>} deps.requestResume
|
|
66
|
+
* engine resume primitive; its pre-resume hook re-reserves + resyncs the
|
|
67
|
+
* member as a HARD BARRIER before the probe dispatch runs.
|
|
68
|
+
* @param {(prompt: string, opts: object) => Promise<any>} deps.agent the
|
|
69
|
+
* runner's dispatch function, used for the one real re-probe dispatch.
|
|
70
|
+
* @param {(msg: string) => void} [deps.log]
|
|
71
|
+
* @param {object} [deps.budgets] usage-limit budgets (USAGE_LIMIT_MAX_WAIT_S,
|
|
72
|
+
* USAGE_LIMIT_MAX_REPROBES, USAGE_LIMIT_MIN_WAIT_S,
|
|
73
|
+
* USAGE_LIMIT_REPROBE_BACKOFF_MS); each falls back to
|
|
74
|
+
* USAGE_LIMIT_BUDGET_DEFAULTS.
|
|
75
|
+
* @param {() => number} [deps.now] injected epoch-ms clock (default Date.now).
|
|
76
|
+
* @param {(ms: number) => Promise<void>} [deps.sleep] injected timer (default a
|
|
77
|
+
* real non-blocking setTimeout).
|
|
78
|
+
* @returns {(args: { member: string, roleLabel: string, signal: object|null,
|
|
79
|
+
* sessionId?: string|null, tier?: string }) =>
|
|
80
|
+
* Promise<{ resumed: true } | { resumed: false, error: Error }>}
|
|
81
|
+
*/
|
|
82
|
+
export function createUsageLimitPauseController({
|
|
83
|
+
requestPause,
|
|
84
|
+
requestResume,
|
|
85
|
+
agent,
|
|
86
|
+
log = () => {},
|
|
87
|
+
budgets = {},
|
|
88
|
+
now = () => Date.now(),
|
|
89
|
+
sleep = defaultSleep,
|
|
90
|
+
} = {}) {
|
|
91
|
+
const maxWaitS = budgets.USAGE_LIMIT_MAX_WAIT_S ?? USAGE_LIMIT_BUDGET_DEFAULTS.USAGE_LIMIT_MAX_WAIT_S;
|
|
92
|
+
const maxReprobes = budgets.USAGE_LIMIT_MAX_REPROBES ?? USAGE_LIMIT_BUDGET_DEFAULTS.USAGE_LIMIT_MAX_REPROBES;
|
|
93
|
+
const minWaitS = budgets.USAGE_LIMIT_MIN_WAIT_S ?? USAGE_LIMIT_BUDGET_DEFAULTS.USAGE_LIMIT_MIN_WAIT_S;
|
|
94
|
+
const backoffLadder = budgets.USAGE_LIMIT_REPROBE_BACKOFF_MS ?? USAGE_LIMIT_BUDGET_DEFAULTS.USAGE_LIMIT_REPROBE_BACKOFF_MS;
|
|
95
|
+
const maxWaitMs = maxWaitS * 1000;
|
|
96
|
+
const minWaitMs = minWaitS * 1000;
|
|
97
|
+
|
|
98
|
+
// `sessionId` (the session that hit the limit) is part of the caller's
|
|
99
|
+
// payload but deliberately unused here: the probe is a FRESH dispatch
|
|
100
|
+
// (resume:false), so it never resumes the limited session. It is left off
|
|
101
|
+
// the destructure rather than bound-and-ignored to keep the linter quiet.
|
|
102
|
+
return async function onUsageLimit({ member, roleLabel, signal, tier } = {}) {
|
|
103
|
+
const firstHitAt = now();
|
|
104
|
+
// The signal that drives THIS pause: the failing dispatch's signal
|
|
105
|
+
// first, then whatever fresh signal each reprobe reports (or null,
|
|
106
|
+
// which drops onto the backoff ladder).
|
|
107
|
+
let currentSignal = signal || null;
|
|
108
|
+
let reprobes = 0;
|
|
109
|
+
let waitedMs = 0;
|
|
110
|
+
let lastResumeAt = currentSignal && currentSignal.resumeAt ? currentSignal.resumeAt : null;
|
|
111
|
+
|
|
112
|
+
const exhausted = () => new UsageLimitWaitExhaustedError(
|
|
113
|
+
`Usage limit on member ${member} (${roleLabel}) did not clear within the allowed ` +
|
|
114
|
+
`wait budget (${maxWaitS}s / ${maxReprobes} reprobes)` +
|
|
115
|
+
(lastResumeAt ? `; last reported resume time was ${lastResumeAt}.` : '.'),
|
|
116
|
+
{
|
|
117
|
+
member,
|
|
118
|
+
roleLabel,
|
|
119
|
+
firstHitAt,
|
|
120
|
+
lastResumeAt: lastResumeAt ? new Date(lastResumeAt).getTime() : null,
|
|
121
|
+
reprobes,
|
|
122
|
+
waitedMs,
|
|
123
|
+
}
|
|
124
|
+
);
|
|
125
|
+
|
|
126
|
+
for (;;) {
|
|
127
|
+
const remainingMs = maxWaitMs - waitedMs;
|
|
128
|
+
if (remainingMs <= 0) return { resumed: false, error: exhausted() };
|
|
129
|
+
|
|
130
|
+
// Wait for THIS pause. Trust the provider's own resumeAt when it
|
|
131
|
+
// gave one (parsed or guessed -- either way it is the signal's, not
|
|
132
|
+
// ours); otherwise step the reprobe backoff ladder. NEVER a
|
|
133
|
+
// hard-coded window here.
|
|
134
|
+
let targetMs;
|
|
135
|
+
let source;
|
|
136
|
+
if (currentSignal && currentSignal.resumeAt) {
|
|
137
|
+
targetMs = new Date(currentSignal.resumeAt).getTime() - now();
|
|
138
|
+
source = currentSignal.resumeAtSource || 'parsed';
|
|
139
|
+
lastResumeAt = currentSignal.resumeAt;
|
|
140
|
+
} else {
|
|
141
|
+
targetMs = backoffLadder[Math.min(reprobes, backoffLadder.length - 1)];
|
|
142
|
+
source = 'backoff';
|
|
143
|
+
}
|
|
144
|
+
// Clamp: never below the floor, never past the remaining budget.
|
|
145
|
+
const waitMs = Math.min(Math.max(targetMs, minWaitMs), remainingMs);
|
|
146
|
+
|
|
147
|
+
log(
|
|
148
|
+
`usage limit on member ${member} (${roleLabel}): source=${source}` +
|
|
149
|
+
(lastResumeAt ? `, resumeAt=${lastResumeAt}` : '') +
|
|
150
|
+
`, pausing ~${Math.round(waitMs / 1000)}s (reprobe ${reprobes}/${maxReprobes}).`
|
|
151
|
+
);
|
|
152
|
+
|
|
153
|
+
// Pause the whole run through the engine primitive. dispatch-role.mjs
|
|
154
|
+
// guarantees this runs OUTSIDE any git-sync bracket, so the
|
|
155
|
+
// clean-state pause guard engages the pause here rather than
|
|
156
|
+
// deferring it forever.
|
|
157
|
+
await requestPause(
|
|
158
|
+
`usage limit on member ${member} (${roleLabel})`,
|
|
159
|
+
{ ...(lastResumeAt ? { resumeAt: lastResumeAt } : {}), source: 'usage_limit' }
|
|
160
|
+
);
|
|
161
|
+
// Sleep on the injected timer (never a blocking loop). A cooperative
|
|
162
|
+
// stop taken here surfaces on the next resume/probe below and is
|
|
163
|
+
// propagated, never swallowed.
|
|
164
|
+
await sleep(waitMs);
|
|
165
|
+
waitedMs += waitMs;
|
|
166
|
+
// Resume: the engine's pre-resume hook re-reserves + resyncs the
|
|
167
|
+
// member (a MemberReservationResumeError propagates as today).
|
|
168
|
+
await requestResume(`usage limit wait elapsed on member ${member} (${roleLabel})`);
|
|
169
|
+
|
|
170
|
+
// Probe before trusting the clock: one real dispatch to the same
|
|
171
|
+
// member at the same tier.
|
|
172
|
+
try {
|
|
173
|
+
await agent(PROBE_PROMPT, {
|
|
174
|
+
member_name: member,
|
|
175
|
+
...(tier ? { model: tier } : {}),
|
|
176
|
+
max_turns: 1,
|
|
177
|
+
resume: false,
|
|
178
|
+
timeout_s: PROBE_TIMEOUT_S,
|
|
179
|
+
label: `usage-limit re-probe: ${member}`,
|
|
180
|
+
});
|
|
181
|
+
// Probe succeeded -- the member is usable again.
|
|
182
|
+
return { resumed: true };
|
|
183
|
+
} catch (probeErr) {
|
|
184
|
+
// A cooperative stop (requestStop -> CancelledError) taken
|
|
185
|
+
// during the pause is NOT a probe failure: propagate it so an
|
|
186
|
+
// operator stop still tears the run down mid-pause. Never
|
|
187
|
+
// swallowed by the inconclusive-probe path below.
|
|
188
|
+
if (probeErr instanceof CancelledError) throw probeErr;
|
|
189
|
+
if (isUsageLimitDispatchError(probeErr)) {
|
|
190
|
+
reprobes += 1;
|
|
191
|
+
// Prefer the probe's OWN fresh signal (a new parsed
|
|
192
|
+
// resumeAt); absent one, the next pass drops onto the
|
|
193
|
+
// backoff ladder.
|
|
194
|
+
currentSignal = usageLimitOf(probeErr) || null;
|
|
195
|
+
if (reprobes > maxReprobes || waitedMs >= maxWaitMs) {
|
|
196
|
+
return { resumed: false, error: exhausted() };
|
|
197
|
+
}
|
|
198
|
+
continue;
|
|
199
|
+
}
|
|
200
|
+
// Any OTHER probe outcome (a transient busy/transport error) is
|
|
201
|
+
// inconclusive: log it and let the real re-dispatch be the final
|
|
202
|
+
// test rather than burning a reprobe on an unrelated fault.
|
|
203
|
+
log(
|
|
204
|
+
`usage limit re-probe for member ${member} (${roleLabel}) was inconclusive ` +
|
|
205
|
+
`(${probeErr && probeErr.message ? probeErr.message : probeErr}) -- proceeding to re-dispatch.`
|
|
206
|
+
);
|
|
207
|
+
return { resumed: true };
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
};
|
|
211
|
+
}
|