@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,301 @@
|
|
|
1
|
+
// Reviewer-verdict bead transitions for fleet-sprint (apra-fleet-3swo.4.7):
|
|
2
|
+
// the reopen/replan/close transitions the ORCHESTRATOR -- never the LLM --
|
|
3
|
+
// applies to beads after a role returns a verdict. Extracted out of runner.js;
|
|
4
|
+
// runner.js re-exports every symbol it previously exported from this region,
|
|
5
|
+
// so existing importers of fleet-sprint/runner.js resolve unchanged.
|
|
6
|
+
//
|
|
7
|
+
// THREE CALL SITES, ONE GUARD. Three places apply a reviewer-shaped verdict to
|
|
8
|
+
// beads, and before this extraction only two of them were guarded:
|
|
9
|
+
//
|
|
10
|
+
// 1. the per-round reviewer inside the Develop/Review loop,
|
|
11
|
+
// 2. Final Review, and
|
|
12
|
+
// 3. Re-Review (the "0 open beads at goal but the last verdict was not
|
|
13
|
+
// APPROVED" branch) -- which looped over reopenIds issuing
|
|
14
|
+
// `bd update <id> --status=open` with NO goal-scope guard at all.
|
|
15
|
+
//
|
|
16
|
+
// Site 3's omission was a real hole, not a deliberate exemption: reopening a
|
|
17
|
+
// DEFERRED below-goal bead injects work the sprint no longer targets and pins
|
|
18
|
+
// the verdict at CHANGES_NEEDED forever -- the exact failure the other two
|
|
19
|
+
// sites guard against. All three now go through applyGuardedReopens() below,
|
|
20
|
+
// so the guard cannot be forgotten by a fourth site either.
|
|
21
|
+
//
|
|
22
|
+
// WHAT WAS UNIFIED AND WHAT WAS DELIBERATELY NOT. The GUARD is unified. The
|
|
23
|
+
// PAYLOAD SHAPES are not: the three sites take three different reopen-entry
|
|
24
|
+
// shapes (site 1 bare string, site 2 `{id, reason}` with BOTH fields
|
|
25
|
+
// required, site 3 bare string), each with its own producer on the other end
|
|
26
|
+
// of a dispatch contract. Normalising the shape would be a behaviour change
|
|
27
|
+
// to those contracts, not a move, so each site keeps its own `parseEntry` and
|
|
28
|
+
// its own `buildReopenCommand` while sharing the allowlist, the below-goal
|
|
29
|
+
// check, the skip log text and the control flow.
|
|
30
|
+
//
|
|
31
|
+
// FAIL OPEN, DELIBERATELY. When the scope lookup THROWS, the allowlist is set
|
|
32
|
+
// to null and every reopen is applied UNGUARDED rather than dropped. This is
|
|
33
|
+
// intentional and must not be "hardened" into a fail-closed drop: a failed
|
|
34
|
+
// scope lookup is an infrastructure problem, and silently swallowing a
|
|
35
|
+
// reviewer's reopens because of one would lose real review signal with no
|
|
36
|
+
// trace. A null allowlist therefore means "apply everything", never "skip
|
|
37
|
+
// everything" -- see buildReopenAllowlist() and isDeferredScopeReopen().
|
|
38
|
+
// =============================================================================
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Detects the reviewer contract violation described on
|
|
42
|
+
* `ReviewerContractViolationError`: a `CHANGES_NEEDED` verdict naming nothing
|
|
43
|
+
* to reopen, proposing no follow-up work, AND naming no scoped-replan targets
|
|
44
|
+
* is schema-legal but self-contradictory -- the orchestrator has nothing to
|
|
45
|
+
* act on, so the sprint cannot make progress off of it. A non-empty
|
|
46
|
+
* `replanIds` exempts the verdict from that hard abort even with empty
|
|
47
|
+
* reopenIds/newTasks -- NOT because the field is guaranteed to be consumed
|
|
48
|
+
* (foldReplanIds() below only accepts replanIds entries ALSO named in
|
|
49
|
+
* reopenIds this round), but because a verdict that names a genuine replan
|
|
50
|
+
* intent in `notes` still represents real reviewer signal worth an ordinary
|
|
51
|
+
* next-round retry rather than a hard sprint abort.
|
|
52
|
+
*
|
|
53
|
+
* @param {{ verdict: string, reopenIds?: string[], replanIds?: string[], newTasks?: object[] }} verdict
|
|
54
|
+
* @returns {boolean}
|
|
55
|
+
*/
|
|
56
|
+
export function isReviewerContractViolation(verdict) {
|
|
57
|
+
return verdict.verdict === 'CHANGES_NEEDED'
|
|
58
|
+
&& (!verdict.reopenIds || verdict.reopenIds.length === 0)
|
|
59
|
+
&& (!verdict.newTasks || verdict.newTasks.length === 0)
|
|
60
|
+
&& (!verdict.replanIds || verdict.replanIds.length === 0);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Look up the beads currently in sprint scope, as the goal-scope allowlist
|
|
65
|
+
* every reopen is checked against.
|
|
66
|
+
*
|
|
67
|
+
* FAILS OPEN BY DESIGN: any throw from the scope lookup yields `null`, which
|
|
68
|
+
* isDeferredScopeReopen() reads as "apply every reopen unguarded". Dropping a
|
|
69
|
+
* reviewer's reopens because a `bd list` failed would silently lose review
|
|
70
|
+
* signal; a redundant unguarded reopen is the far cheaper failure.
|
|
71
|
+
*
|
|
72
|
+
* @param {(rest: string) => Promise<Array<object>>} bdListScoped
|
|
73
|
+
* @returns {Promise<Map<string, object>|null>} the allowlist, or null on lookup failure
|
|
74
|
+
*/
|
|
75
|
+
export async function buildReopenAllowlist(bdListScoped) {
|
|
76
|
+
try {
|
|
77
|
+
const inScopeNow = await bdListScoped('');
|
|
78
|
+
return new Map(inScopeNow.map((b) => [b.id, b]));
|
|
79
|
+
} catch {
|
|
80
|
+
return null; // lookup failed -- apply reopens unguarded rather than dropping them
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Coerce a goal-priority ceiling to the NUMBER the priority comparison needs.
|
|
86
|
+
*
|
|
87
|
+
* runner.js's `goalMax` closure variable is goalPriorityMax(goal), which
|
|
88
|
+
* returns the STRING form ('P2') because its other consumers want exactly
|
|
89
|
+
* that: `bd list --priority-max=P2` and the human-facing log text. A bead's
|
|
90
|
+
* own `priority`, though, is a NUMBER (3).
|
|
91
|
+
*
|
|
92
|
+
* That mismatch was a live, silent bug in the pre-extraction guard, which
|
|
93
|
+
* compared them directly:
|
|
94
|
+
*
|
|
95
|
+
* bead.priority > goalMax // 3 > 'P2' -> NaN comparison -> false
|
|
96
|
+
*
|
|
97
|
+
* `>` coerces the string to a number, `Number('P2')` is NaN, and every
|
|
98
|
+
* comparison against NaN is false -- so the goal-scope guard NEVER skipped
|
|
99
|
+
* anything, at ANY site, for ANY priority (even a P9 bead in a P1 sprint
|
|
100
|
+
* returned false). The two "guarded" sites were guarded in appearance only.
|
|
101
|
+
* runner.js already knew the numeric form was required elsewhere and derived
|
|
102
|
+
* it explicitly (`Number(goalPriorityMax(goal).slice(1))` in
|
|
103
|
+
* partitionByGoalMembership and in the dashboard payload); only this guard
|
|
104
|
+
* missed it.
|
|
105
|
+
*
|
|
106
|
+
* Accepts either form so callers may pass the string ceiling they already
|
|
107
|
+
* have; returns NaN for anything unparseable, which -- since every comparison
|
|
108
|
+
* against NaN is false -- degrades to the historical never-skip behaviour
|
|
109
|
+
* rather than to skipping everything.
|
|
110
|
+
*
|
|
111
|
+
* @param {number|string} goalMax - e.g. 2 or 'P2'
|
|
112
|
+
* @returns {number}
|
|
113
|
+
*/
|
|
114
|
+
export function normalizeGoalMax(goalMax) {
|
|
115
|
+
if (typeof goalMax === 'number') return goalMax;
|
|
116
|
+
if (typeof goalMax === 'string') return Number(goalMax.replace(/^[Pp]/, ''));
|
|
117
|
+
return NaN;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* The goal-scope check itself: is `id` a bead this sprint has DEFERRED below
|
|
122
|
+
* its goal priority, and therefore must not reopen?
|
|
123
|
+
*
|
|
124
|
+
* Every clause matters. A null `allowlist` (lookup failed) is never a skip --
|
|
125
|
+
* see buildReopenAllowlist. A bead absent from the allowlist is never a skip
|
|
126
|
+
* either: it is out-of-scope or brand new, and the pre-extraction sites
|
|
127
|
+
* deliberately let those through rather than guessing. Only a bead the
|
|
128
|
+
* allowlist KNOWS about, with a NUMERIC priority strictly worse (higher) than
|
|
129
|
+
* the goal max, is refused -- and `goalMax` is normalized to a number first,
|
|
130
|
+
* because comparing against the raw 'P2' string is what made this guard inert
|
|
131
|
+
* (see normalizeGoalMax).
|
|
132
|
+
*
|
|
133
|
+
* @param {Map<string, object>|null} allowlist
|
|
134
|
+
* @param {string} id
|
|
135
|
+
* @param {number|string} goalMax - numeric ceiling, or the 'Pn' string form
|
|
136
|
+
* @returns {{ deferred: boolean, priority: number|null }}
|
|
137
|
+
*/
|
|
138
|
+
export function isDeferredScopeReopen(allowlist, id, goalMax) {
|
|
139
|
+
const bead = allowlist ? allowlist.get(id) : null;
|
|
140
|
+
const max = normalizeGoalMax(goalMax);
|
|
141
|
+
if (allowlist && bead && typeof bead.priority === 'number' && bead.priority > max) {
|
|
142
|
+
return { deferred: true, priority: bead.priority };
|
|
143
|
+
}
|
|
144
|
+
return { deferred: false, priority: bead && typeof bead.priority === 'number' ? bead.priority : null };
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* The single reopen-entry parser for the two sites whose reopenIds are BARE
|
|
149
|
+
* STRINGS carrying no reason (the per-round reviewer and Re-Review).
|
|
150
|
+
*
|
|
151
|
+
* @param {unknown} entry
|
|
152
|
+
* @returns {{ id: string, reason: string }|{ error: string }}
|
|
153
|
+
*/
|
|
154
|
+
export function parseBareIdEntry(entry) {
|
|
155
|
+
const id = typeof entry === 'string' ? entry.trim() : '';
|
|
156
|
+
if (!id) return { error: `expected a bead id string -- ${JSON.stringify(entry)}` };
|
|
157
|
+
return { id, reason: '' };
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
/**
|
|
161
|
+
* Final Review's reopen-entry parser: `{id, reason}` with BOTH fields
|
|
162
|
+
* required. Unlike the per-round reviewer's single blanket `notes` string
|
|
163
|
+
* shared across every id, each Final Review entry carries its OWN reason, so
|
|
164
|
+
* an entry missing either field has nothing usable to record and is refused.
|
|
165
|
+
*
|
|
166
|
+
* @param {unknown} entry
|
|
167
|
+
* @returns {{ id: string, reason: string }|{ error: string }}
|
|
168
|
+
*/
|
|
169
|
+
export function parseIdWithReasonEntry(entry) {
|
|
170
|
+
const id = entry && typeof entry.id === 'string' ? entry.id.trim() : '';
|
|
171
|
+
const reason = entry && typeof entry.reason === 'string' ? entry.reason.trim() : '';
|
|
172
|
+
if (!id || !reason) {
|
|
173
|
+
return { error: `a malformed entry (both id and reason are required) -- ${JSON.stringify(entry)}` };
|
|
174
|
+
}
|
|
175
|
+
return { id, reason };
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* Apply a verdict's reopenIds to beads, behind the shared goal-scope guard.
|
|
180
|
+
* This is the ONE path all three verdict sites now take.
|
|
181
|
+
*
|
|
182
|
+
* The below-goal skip emits the identical "deferred scope, not reopened"
|
|
183
|
+
* outcome at every site -- that exact phrasing is what makes the guard
|
|
184
|
+
* greppable in a run log and is asserted by the extraction's tests, so keep
|
|
185
|
+
* it verbatim if you touch this.
|
|
186
|
+
*
|
|
187
|
+
* @param {object} o
|
|
188
|
+
* @param {Array<unknown>} o.entries - the verdict's raw reopenIds, in its own shape
|
|
189
|
+
* @param {(rest: string) => Promise<Array<object>>} o.bdListScoped - scope lookup for the allowlist
|
|
190
|
+
* @param {number} o.goalMax - worst (numerically highest) priority this sprint targets
|
|
191
|
+
* @param {string} o.goal - the goal label, for log text (e.g. 'P1/P2')
|
|
192
|
+
* @param {string} o.logPrefix - site label for log lines (e.g. 'Reviewer reopenIds')
|
|
193
|
+
* @param {(msg: string) => void} o.log
|
|
194
|
+
* @param {(cmd: string, opts: object) => Promise<any>} o.command
|
|
195
|
+
* @param {string} o.member - the member every `bd` command here is dispatched to
|
|
196
|
+
* @param {(entry: unknown) => {id: string, reason: string}|{error: string}} [o.parseEntry]
|
|
197
|
+
* @param {(e: {id: string, reason: string}) => {cmd: string, label: string}|null} o.buildReopenCommand
|
|
198
|
+
* @param {(e: {id: string, reason: string}) => void} [o.onReopened] - per-bead side effects (thrash counters, feedback routing)
|
|
199
|
+
* @param {(e: {id: string, reason: string}, err: Error) => void} [o.onEntryError] - when present, a throwing entry is non-fatal and reported here
|
|
200
|
+
* @returns {Promise<string[]>} the ids ACTUALLY reopened (survived the guard)
|
|
201
|
+
*/
|
|
202
|
+
export async function applyGuardedReopens(o) {
|
|
203
|
+
const {
|
|
204
|
+
entries, bdListScoped, goalMax, goal, logPrefix, log, command, member,
|
|
205
|
+
parseEntry = parseBareIdEntry, buildReopenCommand, onReopened, onEntryError,
|
|
206
|
+
} = o;
|
|
207
|
+
|
|
208
|
+
const list = Array.isArray(entries) ? entries : [];
|
|
209
|
+
// Short-circuit an empty verdict WITHOUT issuing the scope lookup: the
|
|
210
|
+
// pre-extraction sites both guarded the lookup on a non-empty reopenIds,
|
|
211
|
+
// and a `bd list` per empty verdict is real dispatch cost.
|
|
212
|
+
if (list.length === 0) return [];
|
|
213
|
+
|
|
214
|
+
const allowlist = await buildReopenAllowlist(bdListScoped);
|
|
215
|
+
const reopenedIds = [];
|
|
216
|
+
|
|
217
|
+
for (const entry of list) {
|
|
218
|
+
const parsed = parseEntry(entry);
|
|
219
|
+
if (parsed.error) {
|
|
220
|
+
log(`${logPrefix}: SKIPPED ${parsed.error}`);
|
|
221
|
+
continue;
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
const { deferred, priority } = isDeferredScopeReopen(allowlist, parsed.id, goalMax);
|
|
225
|
+
if (deferred) {
|
|
226
|
+
log(`${logPrefix}: SKIPPED '${parsed.id}' (priority P${priority} is below this sprint's goal ${goal} -- deferred scope, not reopened).`);
|
|
227
|
+
continue;
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
try {
|
|
231
|
+
const built = buildReopenCommand(parsed);
|
|
232
|
+
// A builder may refuse an entry it cannot render safely (Final
|
|
233
|
+
// Review's reason sanitizing to empty); it has already logged why.
|
|
234
|
+
if (!built) continue;
|
|
235
|
+
await command(built.cmd, { member_name: member, silent: true, label: built.label });
|
|
236
|
+
reopenedIds.push(parsed.id);
|
|
237
|
+
if (onReopened) onReopened(parsed);
|
|
238
|
+
} catch (err) {
|
|
239
|
+
if (!onEntryError) throw err;
|
|
240
|
+
onEntryError(parsed, err);
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
return reopenedIds;
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
/**
|
|
248
|
+
* Fold a round's reviewer `replanIds` into the cycle's running replan union.
|
|
249
|
+
* Only the per-round reviewer site uses this; Final Review and Re-Review have
|
|
250
|
+
* no scoped-replan machinery to feed.
|
|
251
|
+
*
|
|
252
|
+
* Two independent refusals, each logged so the drop is visible in the run log
|
|
253
|
+
* rather than vanishing with no trace:
|
|
254
|
+
*
|
|
255
|
+
* 1. NOT ALSO REOPENED. An id named in replanIds without ALSO being named
|
|
256
|
+
* in (and surviving the guard on) this round's reopenIds is DROPPED and
|
|
257
|
+
* never reaches the scoped-replan machinery. buildReviewerPrompt
|
|
258
|
+
* requires replanIds to be a subset of reopenIds; this is the
|
|
259
|
+
* enforcement side. Note the subset is checked against ids ACTUALLY
|
|
260
|
+
* reopened, so a below-goal id skipped by the scope guard cannot sneak
|
|
261
|
+
* back in through replanIds.
|
|
262
|
+
* 2. ALREADY REPLANNED THIS CYCLE. A bead that has already been through one
|
|
263
|
+
* in-cycle scoped replan is refused a SECOND: it stays reopened (real
|
|
264
|
+
* dev feedback still applies) but is not re-added, so the develop loop
|
|
265
|
+
* never dispatches a second scoped planner pass for it -- it is handed
|
|
266
|
+
* to the next cycle's planner instead. This is what makes "max one
|
|
267
|
+
* scoped replan per bead per cycle" hold regardless of the round budget.
|
|
268
|
+
*
|
|
269
|
+
* @param {object} o
|
|
270
|
+
* @param {string[]|undefined} o.replanIds - the verdict's replanIds (absent on verdicts that do not use it)
|
|
271
|
+
* @param {Set<string>} o.reopenedIds - ids actually reopened this round
|
|
272
|
+
* @param {Set<string>} o.replannedThisCycle - beads already scoped-replanned this cycle
|
|
273
|
+
* @param {number|string} o.cycle - cycle label, for log text
|
|
274
|
+
* @param {(msg: string) => void} o.log
|
|
275
|
+
* @returns {string[]} the ids accepted into the cycle's replan union
|
|
276
|
+
*/
|
|
277
|
+
export function foldReplanIds(o) {
|
|
278
|
+
const { replanIds, reopenedIds, replannedThisCycle, cycle, log } = o;
|
|
279
|
+
const accepted = [];
|
|
280
|
+
for (const id of (replanIds || [])) {
|
|
281
|
+
if (!reopenedIds.has(id)) {
|
|
282
|
+
log(
|
|
283
|
+
`[fleet-sprint] replanIds: DROPPED '${id}' -- not also named in this round's reopenIds ` +
|
|
284
|
+
`(reviewer prompt requires replanIds to be a subset of reopenIds), so it never reaches the ` +
|
|
285
|
+
`scoped-replan machinery.`
|
|
286
|
+
);
|
|
287
|
+
continue;
|
|
288
|
+
}
|
|
289
|
+
if (replannedThisCycle.has(id)) {
|
|
290
|
+
log(
|
|
291
|
+
`[fleet-sprint] replan loop guard: bead ${id} was already scoped-replanned once this cycle ` +
|
|
292
|
+
`(C${cycle}) and a reviewer has flagged it for replan AGAIN -- refusing a second in-cycle scoped ` +
|
|
293
|
+
`replan (max one per bead per cycle). It stays reopened and is handed off to the next cycle's ` +
|
|
294
|
+
`planner rather than re-planned again now.`
|
|
295
|
+
);
|
|
296
|
+
continue;
|
|
297
|
+
}
|
|
298
|
+
accepted.push(id);
|
|
299
|
+
}
|
|
300
|
+
return accepted;
|
|
301
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
// The pure branch-selection decision helper for fleet-sprint's Ensure Sprint
|
|
2
|
+
// Branch phase (apra-fleet-3swo.3.6). Moved verbatim out of runner.js --
|
|
3
|
+
// runner.js imports it back for its own Ensure Sprint Branch phase and for
|
|
4
|
+
// resyncReacquiredMember(). This is a move-only extraction: no I/O, no
|
|
5
|
+
// behaviour change -- the helper stays pure.
|
|
6
|
+
|
|
7
|
+
// Pure branch-selection decision for the Ensure Sprint Branch phase. Given the
|
|
8
|
+
// outcomes of the probes that phase issues -- a soft-failed
|
|
9
|
+
// `git fetch origin/<branch>` and, when that reports the ref is missing, a
|
|
10
|
+
// local-branch existence probe -- this decides which checkout command to run,
|
|
11
|
+
// or that the phase must abort rather than touch git at all. No I/O of its
|
|
12
|
+
// own; the caller still issues the command() calls and does the logging.
|
|
13
|
+
//
|
|
14
|
+
// Returns one of:
|
|
15
|
+
// { action: 'abort', message } -- the fetch failed for a reason other than
|
|
16
|
+
// "branch doesn't exist yet", or local and origin have diverged. The
|
|
17
|
+
// caller must throw and never attempt a checkout: a transient fetch
|
|
18
|
+
// failure misread as "new branch" would reset the branch to base and
|
|
19
|
+
// destroy pushed work.
|
|
20
|
+
// { action: 'checkout', reused: true, command } -- reuse an existing local
|
|
21
|
+
// branch as-is (plain `git checkout`, no reset), preserving commits that
|
|
22
|
+
// exist only locally.
|
|
23
|
+
// { action: 'checkout', reused: false, command, startPoint } -- normal
|
|
24
|
+
// `git checkout -B <branch> <startPoint>`, where startPoint is
|
|
25
|
+
// `origin/<branch>` when the fetch succeeded and `origin/<baseBranch>`
|
|
26
|
+
// when the branch is genuinely new.
|
|
27
|
+
//
|
|
28
|
+
// When the fetch succeeds and a local branch also exists, the two tips can
|
|
29
|
+
// still disagree, because a doer may have committed without its push
|
|
30
|
+
// succeeding. `localTipStatus` -- the caller's comparison of the two tips via
|
|
31
|
+
// `git merge-base --is-ancestor` in both directions -- resolves that:
|
|
32
|
+
// 'behind-or-equal' -- local holds nothing origin does not; safe to reset.
|
|
33
|
+
// 'ahead' -- local holds commits origin does not and origin holds
|
|
34
|
+
// none local does not; reuse the local branch so those
|
|
35
|
+
// commits survive.
|
|
36
|
+
// 'diverged' -- neither tip is an ancestor of the other; abort rather
|
|
37
|
+
// than attempt any automatic merge or rebase, since
|
|
38
|
+
// either direction could discard real commits.
|
|
39
|
+
export function decideEnsureBranchAction({ branch, baseBranch, branchFetchOk, branchFetchError, localBranchExists, localTipStatus, localSha, remoteSha }) {
|
|
40
|
+
// A failed fetch is only safe to read as "branch doesn't exist yet" when
|
|
41
|
+
// git says exactly that. Any other failure -- network blip, auth expiry,
|
|
42
|
+
// DNS hiccup -- must not fall back to origin/<baseBranch>, or a transient
|
|
43
|
+
// error would silently reset the branch to base.
|
|
44
|
+
if (!branchFetchOk && !/couldn't find remote ref/i.test(branchFetchError || '')) {
|
|
45
|
+
return {
|
|
46
|
+
action: 'abort',
|
|
47
|
+
message:
|
|
48
|
+
`Ensure Sprint Branch: fetch of existing branch 'origin/${branch}' ` +
|
|
49
|
+
`failed for a reason other than "branch doesn't exist" (${branchFetchError || 'unknown error'}) -- ` +
|
|
50
|
+
`refusing to silently fall back to resetting to base, since the branch may actually exist with real ` +
|
|
51
|
+
`pushed work and this fetch failure could be transient. Investigate and retry.`,
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
// Both refs exist and neither tip is an ancestor of the other: never
|
|
56
|
+
// attempt an automatic merge or rebase, abort and let a human reconcile.
|
|
57
|
+
if (branchFetchOk && localBranchExists && localTipStatus === 'diverged') {
|
|
58
|
+
const shaNote = (localSha || remoteSha)
|
|
59
|
+
? ` (local ${localSha || 'unknown'} vs 'origin/${branch}' ${remoteSha || 'unknown'} -- if 'git branch -vv' ` +
|
|
60
|
+
`on the machine you are inspecting does not show '${branch}' at all, this member is very likely ` +
|
|
61
|
+
`dispatching commands against a DIFFERENT git working directory than the one you checked; verify the ` +
|
|
62
|
+
`member's actual registered working directory before assuming this is a real divergence.)`
|
|
63
|
+
: '';
|
|
64
|
+
return {
|
|
65
|
+
action: 'abort',
|
|
66
|
+
message:
|
|
67
|
+
`Ensure Sprint Branch: local branch '${branch}' has diverged from 'origin/${branch}' ` +
|
|
68
|
+
`(neither is an ancestor of the other) -- refusing to reset or auto-merge, since either direction ` +
|
|
69
|
+
`could silently discard real commits. A human needs to investigate and reconcile the two branches ` +
|
|
70
|
+
`manually before this sprint can safely proceed.${shaNote}`,
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
const startPoint = branchFetchOk ? `origin/${branch}` : `origin/${baseBranch}`;
|
|
75
|
+
// Reuse the local branch as-is (no reset) whenever the remote ref is
|
|
76
|
+
// missing entirely, or it exists but the local branch is strictly ahead of
|
|
77
|
+
// it -- resetting would discard committed-but-unpushed local work.
|
|
78
|
+
const reuseLocalBranch =
|
|
79
|
+
(!branchFetchOk && !!localBranchExists) ||
|
|
80
|
+
(branchFetchOk && !!localBranchExists && localTipStatus === 'ahead');
|
|
81
|
+
|
|
82
|
+
if (reuseLocalBranch) {
|
|
83
|
+
return {
|
|
84
|
+
action: 'checkout',
|
|
85
|
+
reused: true,
|
|
86
|
+
command: `git checkout ${branch}`,
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
return {
|
|
91
|
+
action: 'checkout',
|
|
92
|
+
reused: false,
|
|
93
|
+
command: `git checkout -B ${branch} ${startPoint}`,
|
|
94
|
+
startPoint,
|
|
95
|
+
};
|
|
96
|
+
}
|
|
@@ -172,6 +172,14 @@ export async function dispatchConflictResolutionAgent({ agent, member, branch, u
|
|
|
172
172
|
member_name: member,
|
|
173
173
|
label: `Tier 2 conflict resolution [${unmergedPaths.join(', ')}]`,
|
|
174
174
|
model,
|
|
175
|
+
// EXPLICITLY a fresh session. The runbook above is entirely
|
|
176
|
+
// self-contained (it names the member, the branch and every
|
|
177
|
+
// conflicted path), and the member's stored last session is whatever
|
|
178
|
+
// role dispatch happened to run there -- resuming it would drop a git
|
|
179
|
+
// conflict-resolution instruction into an unrelated conversation.
|
|
180
|
+
// Never rely on an omitted `resume`: execute_prompt defaults it to
|
|
181
|
+
// true, i.e. best-effort reattachment to exactly that stale session.
|
|
182
|
+
resume: false,
|
|
175
183
|
timeout_s: 1800,
|
|
176
184
|
max_total_s: 1800,
|
|
177
185
|
});
|