@apralabs/apra-fleet 0.4.2 → 0.4.4
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 +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- 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 +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.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/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- 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 +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -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/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -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 +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,447 @@
|
|
|
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
|
+
// A verdict reporting a red build/test run is actionable on its own:
|
|
62
|
+
// the orchestrator files an in-goal fix task for it (see
|
|
63
|
+
// needsRedBranchFixTask below), so it is not self-contradictory.
|
|
64
|
+
&& verdict.buildFailing !== true;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// =============================================================================
|
|
68
|
+
// RED BRANCH -> ALWAYS A FIX DISPATCH.
|
|
69
|
+
//
|
|
70
|
+
// A CHANGES_NEEDED verdict reporting a failing build or test run must always
|
|
71
|
+
// leave dispatchable work behind. Before this, a reviewer naming only
|
|
72
|
+
// below-goal reopenIds (all skipped by the goal-scope guard) -- or none at all
|
|
73
|
+
// -- left the develop loop with zero open work on a red branch: it idled or
|
|
74
|
+
// exited, and nothing ever fixed the tests. When nothing actionable survived,
|
|
75
|
+
// the orchestrator files ONE in-goal fix task carrying the reviewer's notes.
|
|
76
|
+
// =============================================================================
|
|
77
|
+
|
|
78
|
+
/** Fixed title of the orchestrator-filed red-branch fix task (also its dedupe key). */
|
|
79
|
+
export const RED_BRANCH_FIX_TITLE = 'Fix the failing build or tests on the sprint branch';
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Does this verdict need an orchestrator-filed red-branch fix task?
|
|
83
|
+
*
|
|
84
|
+
* @param {object} o
|
|
85
|
+
* @param {{ verdict: string, buildFailing?: boolean }} o.verdict
|
|
86
|
+
* @param {number} o.reopenedCount - reopens that survived the goal-scope guard
|
|
87
|
+
* @param {number} o.inGoalNewTaskCount - newTasks persisted at an in-goal priority
|
|
88
|
+
* @returns {boolean}
|
|
89
|
+
*/
|
|
90
|
+
export function needsRedBranchFixTask({ verdict, reopenedCount, inGoalNewTaskCount }) {
|
|
91
|
+
return Boolean(verdict)
|
|
92
|
+
&& verdict.verdict === 'CHANGES_NEEDED'
|
|
93
|
+
&& verdict.buildFailing === true
|
|
94
|
+
&& reopenedCount === 0
|
|
95
|
+
&& inGoalNewTaskCount === 0;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Is a newTask priority string ('P2') inside the sprint's goal band?
|
|
100
|
+
*
|
|
101
|
+
* @param {string} priority
|
|
102
|
+
* @param {number|string} goalMax
|
|
103
|
+
* @returns {boolean}
|
|
104
|
+
*/
|
|
105
|
+
export function isInGoalPriority(priority, goalMax) {
|
|
106
|
+
const p = normalizeGoalMax(String(priority));
|
|
107
|
+
const max = normalizeGoalMax(goalMax);
|
|
108
|
+
return Number.isFinite(p) && Number.isFinite(max) && p <= max;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* Build the red-branch fix task: highest tier named in the goal, a fixed
|
|
113
|
+
* title, and the reviewer's notes (non-printable/non-ASCII characters
|
|
114
|
+
* replaced so newTask validation cannot reject it).
|
|
115
|
+
*
|
|
116
|
+
* @param {object} o
|
|
117
|
+
* @param {string} o.goal - e.g. 'P1/P2'
|
|
118
|
+
* @param {string} o.notes - the reviewer's notes
|
|
119
|
+
* @param {string} o.site - site label for the description, e.g. 'Review C1 R2'
|
|
120
|
+
* @param {string[]} [o.skippedReopenIds] - reopenIds the guard filtered out
|
|
121
|
+
* @returns {{ title: string, description: string, priority: string }}
|
|
122
|
+
*/
|
|
123
|
+
export function buildRedBranchFixTask({ goal, notes, site, skippedReopenIds = [] }) {
|
|
124
|
+
const tiers = String(goal || '').split('/').map((p) => Number(p.trim().replace(/^[Pp]/, ''))).filter(Number.isFinite);
|
|
125
|
+
const best = tiers.length > 0 ? Math.min(...tiers) : 1;
|
|
126
|
+
const safeNotes = String(notes || '(no reviewer notes)').replace(/[^\t\n\r\x20-\x7E]/g, '?');
|
|
127
|
+
const skipped = skippedReopenIds.length > 0
|
|
128
|
+
? `\n\nThe reviewer named these beads for rework, but none could be reopened in this sprint: ${skippedReopenIds.join(', ')}.`
|
|
129
|
+
: '';
|
|
130
|
+
return {
|
|
131
|
+
title: RED_BRANCH_FIX_TITLE,
|
|
132
|
+
priority: `P${best}`,
|
|
133
|
+
description:
|
|
134
|
+
`The reviewer (${site}) reported that the build or tests FAIL on the sprint branch, and no reopened ` +
|
|
135
|
+
`or newly filed in-goal task covers the fix. Make the project's build and full test suite pass again ` +
|
|
136
|
+
`without weakening any test, then close this task.${skipped}\n\nReviewer notes:\n${safeNotes}`,
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* File the red-branch fix task when the verdict needs one, unless an earlier
|
|
142
|
+
* one is still not closed (one open fix task at a time, never one per round).
|
|
143
|
+
*
|
|
144
|
+
* @param {object} o
|
|
145
|
+
* @param {object} o.verdict - the reviewer verdict
|
|
146
|
+
* @param {number} o.reopenedCount
|
|
147
|
+
* @param {number} o.inGoalNewTaskCount
|
|
148
|
+
* @param {string[]} [o.skippedReopenIds]
|
|
149
|
+
* @param {string} o.goal
|
|
150
|
+
* @param {string} o.site - log/description label, e.g. 'Review C1 R2'
|
|
151
|
+
* @param {(rest: string) => Promise<Array<object>>} o.bdListScoped
|
|
152
|
+
* @param {(task: {title: string, description: string, priority: string}) => Promise<any>} o.createTask - creates the bead; truthy on success
|
|
153
|
+
* @param {(msg: string) => void} o.log
|
|
154
|
+
* @returns {Promise<'not-needed'|'exists'|'created'|'failed'>}
|
|
155
|
+
*/
|
|
156
|
+
export async function ensureRedBranchFixTask(o) {
|
|
157
|
+
const { verdict, reopenedCount, inGoalNewTaskCount, skippedReopenIds = [], goal, site, bdListScoped, createTask, log } = o;
|
|
158
|
+
if (!needsRedBranchFixTask({ verdict, reopenedCount, inGoalNewTaskCount })) return 'not-needed';
|
|
159
|
+
let existing = null;
|
|
160
|
+
try {
|
|
161
|
+
const scope = await bdListScoped('');
|
|
162
|
+
existing = scope.find((b) => b && b.title === RED_BRANCH_FIX_TITLE && b.status !== 'closed') || null;
|
|
163
|
+
} catch {
|
|
164
|
+
existing = null; // lookup failed -- file the task rather than risk leaving a red branch with no work
|
|
165
|
+
}
|
|
166
|
+
if (existing) {
|
|
167
|
+
log(`${site}: build/tests reported FAILING and no reopen or in-goal newTask survived -- red-branch fix task ${existing.id} is still open, not filing another.`);
|
|
168
|
+
return 'exists';
|
|
169
|
+
}
|
|
170
|
+
const task = buildRedBranchFixTask({ goal, notes: verdict.notes, site, skippedReopenIds });
|
|
171
|
+
const created = await createTask(task);
|
|
172
|
+
if (created) {
|
|
173
|
+
const idText = created && typeof created === 'object' && created.childId ? ` ${created.childId}` : '';
|
|
174
|
+
log(`${site}: build/tests reported FAILING and no reopen or in-goal newTask survived -- filed in-goal red-branch fix task${idText} ("${task.title}", ${task.priority}) so the branch is never left red with zero open work.`);
|
|
175
|
+
return 'created';
|
|
176
|
+
}
|
|
177
|
+
log(`${site}: build/tests reported FAILING and no reopen or in-goal newTask survived -- filing the red-branch fix task FAILED; see the newTask persistence log above.`);
|
|
178
|
+
return 'failed';
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
/**
|
|
182
|
+
* Look up the beads currently in sprint scope, as the goal-scope allowlist
|
|
183
|
+
* every reopen is checked against.
|
|
184
|
+
*
|
|
185
|
+
* FAILS OPEN BY DESIGN: any throw from the scope lookup yields `null`, which
|
|
186
|
+
* isDeferredScopeReopen() reads as "apply every reopen unguarded". Dropping a
|
|
187
|
+
* reviewer's reopens because a `bd list` failed would silently lose review
|
|
188
|
+
* signal; a redundant unguarded reopen is the far cheaper failure.
|
|
189
|
+
*
|
|
190
|
+
* @param {(rest: string) => Promise<Array<object>>} bdListScoped
|
|
191
|
+
* @returns {Promise<Map<string, object>|null>} the allowlist, or null on lookup failure
|
|
192
|
+
*/
|
|
193
|
+
export async function buildReopenAllowlist(bdListScoped) {
|
|
194
|
+
try {
|
|
195
|
+
const inScopeNow = await bdListScoped('');
|
|
196
|
+
return new Map(inScopeNow.map((b) => [b.id, b]));
|
|
197
|
+
} catch {
|
|
198
|
+
return null; // lookup failed -- apply reopens unguarded rather than dropping them
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/**
|
|
203
|
+
* Coerce a goal-priority ceiling to the NUMBER the priority comparison needs.
|
|
204
|
+
*
|
|
205
|
+
* runner.js's `goalMax` closure variable is goalPriorityMax(goal), which
|
|
206
|
+
* returns the STRING form ('P2') because its other consumers want exactly
|
|
207
|
+
* that: `bd list --priority-max=P2` and the human-facing log text. A bead's
|
|
208
|
+
* own `priority`, though, is a NUMBER (3).
|
|
209
|
+
*
|
|
210
|
+
* That mismatch was a live, silent bug in the pre-extraction guard, which
|
|
211
|
+
* compared them directly:
|
|
212
|
+
*
|
|
213
|
+
* bead.priority > goalMax // 3 > 'P2' -> NaN comparison -> false
|
|
214
|
+
*
|
|
215
|
+
* `>` coerces the string to a number, `Number('P2')` is NaN, and every
|
|
216
|
+
* comparison against NaN is false -- so the goal-scope guard NEVER skipped
|
|
217
|
+
* anything, at ANY site, for ANY priority (even a P9 bead in a P1 sprint
|
|
218
|
+
* returned false). The two "guarded" sites were guarded in appearance only.
|
|
219
|
+
* runner.js already knew the numeric form was required elsewhere and derived
|
|
220
|
+
* it explicitly (`Number(goalPriorityMax(goal).slice(1))` in
|
|
221
|
+
* partitionByGoalMembership and in the dashboard payload); only this guard
|
|
222
|
+
* missed it.
|
|
223
|
+
*
|
|
224
|
+
* Accepts either form so callers may pass the string ceiling they already
|
|
225
|
+
* have; returns NaN for anything unparseable, which -- since every comparison
|
|
226
|
+
* against NaN is false -- degrades to the historical never-skip behaviour
|
|
227
|
+
* rather than to skipping everything.
|
|
228
|
+
*
|
|
229
|
+
* @param {number|string} goalMax - e.g. 2 or 'P2'
|
|
230
|
+
* @returns {number}
|
|
231
|
+
*/
|
|
232
|
+
export function normalizeGoalMax(goalMax) {
|
|
233
|
+
if (typeof goalMax === 'number') return goalMax;
|
|
234
|
+
if (typeof goalMax === 'string') return Number(goalMax.replace(/^[Pp]/, ''));
|
|
235
|
+
return NaN;
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
/**
|
|
239
|
+
* The goal-scope check itself: is `id` a bead this sprint has DEFERRED below
|
|
240
|
+
* its goal priority, and therefore must not reopen?
|
|
241
|
+
*
|
|
242
|
+
* Every clause matters. A null `allowlist` (lookup failed) is never a skip --
|
|
243
|
+
* see buildReopenAllowlist. A bead absent from the allowlist is never a skip
|
|
244
|
+
* either: it is out-of-scope or brand new, and the pre-extraction sites
|
|
245
|
+
* deliberately let those through rather than guessing. Only a bead the
|
|
246
|
+
* allowlist KNOWS about, with a NUMERIC priority strictly worse (higher) than
|
|
247
|
+
* the goal max, is refused -- and `goalMax` is normalized to a number first,
|
|
248
|
+
* because comparing against the raw 'P2' string is what made this guard inert
|
|
249
|
+
* (see normalizeGoalMax).
|
|
250
|
+
*
|
|
251
|
+
* WORKED-ON EXEMPTION. A below-goal bead THIS SPRINT already dispatched or
|
|
252
|
+
* closed is never deferred: the sprint's own commits for it are on the branch
|
|
253
|
+
* under review, so a reviewer reopening it is asking the sprint to repair its
|
|
254
|
+
* own work (typically a red build or test run) -- not to pull deferred scope
|
|
255
|
+
* back in. Skipping that reopen left a red branch with nothing dispatched to
|
|
256
|
+
* fix it. `belowGoal` is still reported so the caller can log WHY the bead
|
|
257
|
+
* was kept.
|
|
258
|
+
*
|
|
259
|
+
* @param {Map<string, object>|null} allowlist
|
|
260
|
+
* @param {string} id
|
|
261
|
+
* @param {number|string} goalMax - numeric ceiling, or the 'Pn' string form
|
|
262
|
+
* @param {Set<string>|Iterable<string>|null} [workedOnIds] - bead ids this sprint dispatched or closed
|
|
263
|
+
* @returns {{ deferred: boolean, priority: number|null, belowGoal: boolean, workedOn: boolean }}
|
|
264
|
+
*/
|
|
265
|
+
export function isDeferredScopeReopen(allowlist, id, goalMax, workedOnIds = null) {
|
|
266
|
+
const bead = allowlist ? allowlist.get(id) : null;
|
|
267
|
+
const max = normalizeGoalMax(goalMax);
|
|
268
|
+
const priority = bead && typeof bead.priority === 'number' ? bead.priority : null;
|
|
269
|
+
const belowGoal = Boolean(allowlist && bead && priority !== null && priority > max);
|
|
270
|
+
const workedOn = toIdSet(workedOnIds).has(id);
|
|
271
|
+
return { deferred: belowGoal && !workedOn, priority, belowGoal, workedOn };
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* Normalise an optional worked-on id collection (Set, array, any iterable, or
|
|
276
|
+
* absent) to a Set. Absent means "the sprint has worked on nothing yet", which
|
|
277
|
+
* keeps the guard's historical behaviour exactly.
|
|
278
|
+
*
|
|
279
|
+
* @param {Set<string>|Iterable<string>|null|undefined} ids
|
|
280
|
+
* @returns {Set<string>}
|
|
281
|
+
*/
|
|
282
|
+
function toIdSet(ids) {
|
|
283
|
+
if (ids instanceof Set) return ids;
|
|
284
|
+
if (ids && typeof ids[Symbol.iterator] === 'function' && typeof ids !== 'string') return new Set(ids);
|
|
285
|
+
return new Set();
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/**
|
|
289
|
+
* The single reopen-entry parser for the two sites whose reopenIds are BARE
|
|
290
|
+
* STRINGS carrying no reason (the per-round reviewer and Re-Review).
|
|
291
|
+
*
|
|
292
|
+
* @param {unknown} entry
|
|
293
|
+
* @returns {{ id: string, reason: string }|{ error: string }}
|
|
294
|
+
*/
|
|
295
|
+
export function parseBareIdEntry(entry) {
|
|
296
|
+
const id = typeof entry === 'string' ? entry.trim() : '';
|
|
297
|
+
if (!id) return { error: `expected a bead id string -- ${JSON.stringify(entry)}` };
|
|
298
|
+
return { id, reason: '' };
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
/**
|
|
302
|
+
* Final Review's reopen-entry parser: `{id, reason}` with BOTH fields
|
|
303
|
+
* required. Unlike the per-round reviewer's single blanket `notes` string
|
|
304
|
+
* shared across every id, each Final Review entry carries its OWN reason, so
|
|
305
|
+
* an entry missing either field has nothing usable to record and is refused.
|
|
306
|
+
*
|
|
307
|
+
* @param {unknown} entry
|
|
308
|
+
* @returns {{ id: string, reason: string }|{ error: string }}
|
|
309
|
+
*/
|
|
310
|
+
export function parseIdWithReasonEntry(entry) {
|
|
311
|
+
const id = entry && typeof entry.id === 'string' ? entry.id.trim() : '';
|
|
312
|
+
const reason = entry && typeof entry.reason === 'string' ? entry.reason.trim() : '';
|
|
313
|
+
if (!id || !reason) {
|
|
314
|
+
return { error: `a malformed entry (both id and reason are required) -- ${JSON.stringify(entry)}` };
|
|
315
|
+
}
|
|
316
|
+
return { id, reason };
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
/**
|
|
320
|
+
* Apply a verdict's reopenIds to beads, behind the shared goal-scope guard.
|
|
321
|
+
* This is the ONE path all three verdict sites now take.
|
|
322
|
+
*
|
|
323
|
+
* The below-goal skip emits the identical "deferred scope, not reopened"
|
|
324
|
+
* outcome at every site -- that exact phrasing is what makes the guard
|
|
325
|
+
* greppable in a run log and is asserted by the extraction's tests, so keep
|
|
326
|
+
* it verbatim if you touch this.
|
|
327
|
+
*
|
|
328
|
+
* @param {object} o
|
|
329
|
+
* @param {Array<unknown>} o.entries - the verdict's raw reopenIds, in its own shape
|
|
330
|
+
* @param {(rest: string) => Promise<Array<object>>} o.bdListScoped - scope lookup for the allowlist
|
|
331
|
+
* @param {number} o.goalMax - worst (numerically highest) priority this sprint targets
|
|
332
|
+
* @param {string} o.goal - the goal label, for log text (e.g. 'P1/P2')
|
|
333
|
+
* @param {string} o.logPrefix - site label for log lines (e.g. 'Reviewer reopenIds')
|
|
334
|
+
* @param {(msg: string) => void} o.log
|
|
335
|
+
* @param {(cmd: string, opts: object) => Promise<any>} o.command
|
|
336
|
+
* @param {string} o.member - the member every `bd` command here is dispatched to
|
|
337
|
+
* @param {(entry: unknown) => {id: string, reason: string}|{error: string}} [o.parseEntry]
|
|
338
|
+
* @param {(e: {id: string, reason: string}) => {cmd: string, label: string}|null} o.buildReopenCommand
|
|
339
|
+
* @param {(e: {id: string, reason: string}) => void} [o.onReopened] - per-bead side effects (thrash counters, feedback routing)
|
|
340
|
+
* @param {(e: {id: string, reason: string}, err: Error) => void} [o.onEntryError] - when present, a throwing entry is non-fatal and reported here
|
|
341
|
+
* @param {Set<string>|Iterable<string>} [o.workedOnIds] - bead ids this sprint dispatched or closed; a below-goal reopen of one of these is APPLIED (see isDeferredScopeReopen)
|
|
342
|
+
* @returns {Promise<string[]>} the ids ACTUALLY reopened (survived the guard)
|
|
343
|
+
*/
|
|
344
|
+
export async function applyGuardedReopens(o) {
|
|
345
|
+
const {
|
|
346
|
+
entries, bdListScoped, goalMax, goal, logPrefix, log, command, member,
|
|
347
|
+
parseEntry = parseBareIdEntry, buildReopenCommand, onReopened, onEntryError,
|
|
348
|
+
workedOnIds = null,
|
|
349
|
+
} = o;
|
|
350
|
+
|
|
351
|
+
const list = Array.isArray(entries) ? entries : [];
|
|
352
|
+
// Short-circuit an empty verdict WITHOUT issuing the scope lookup: the
|
|
353
|
+
// pre-extraction sites both guarded the lookup on a non-empty reopenIds,
|
|
354
|
+
// and a `bd list` per empty verdict is real dispatch cost.
|
|
355
|
+
if (list.length === 0) return [];
|
|
356
|
+
|
|
357
|
+
const allowlist = await buildReopenAllowlist(bdListScoped);
|
|
358
|
+
const reopenedIds = [];
|
|
359
|
+
|
|
360
|
+
for (const entry of list) {
|
|
361
|
+
const parsed = parseEntry(entry);
|
|
362
|
+
if (parsed.error) {
|
|
363
|
+
log(`${logPrefix}: SKIPPED ${parsed.error}`);
|
|
364
|
+
continue;
|
|
365
|
+
}
|
|
366
|
+
|
|
367
|
+
const { deferred, priority, belowGoal } = isDeferredScopeReopen(allowlist, parsed.id, goalMax, workedOnIds);
|
|
368
|
+
if (deferred) {
|
|
369
|
+
log(`${logPrefix}: SKIPPED '${parsed.id}' (priority P${priority} is below this sprint's goal ${goal} -- deferred scope, not reopened).`);
|
|
370
|
+
continue;
|
|
371
|
+
}
|
|
372
|
+
if (belowGoal) {
|
|
373
|
+
log(`${logPrefix}: KEPT '${parsed.id}' (priority P${priority} is below this sprint's goal ${goal}, but this sprint already dispatched or closed it -- reopening so the sprint repairs its own work).`);
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
try {
|
|
377
|
+
const built = buildReopenCommand(parsed);
|
|
378
|
+
// A builder may refuse an entry it cannot render safely (Final
|
|
379
|
+
// Review's reason sanitizing to empty); it has already logged why.
|
|
380
|
+
if (!built) continue;
|
|
381
|
+
await command(built.cmd, { member_name: member, silent: true, label: built.label });
|
|
382
|
+
reopenedIds.push(parsed.id);
|
|
383
|
+
if (onReopened) onReopened(parsed);
|
|
384
|
+
} catch (err) {
|
|
385
|
+
if (!onEntryError) throw err;
|
|
386
|
+
onEntryError(parsed, err);
|
|
387
|
+
}
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
return reopenedIds;
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
/**
|
|
394
|
+
* Fold a round's reviewer `replanIds` into the cycle's running replan union.
|
|
395
|
+
* Only the per-round reviewer site uses this; Final Review and Re-Review have
|
|
396
|
+
* no scoped-replan machinery to feed.
|
|
397
|
+
*
|
|
398
|
+
* Two independent refusals, each logged so the drop is visible in the run log
|
|
399
|
+
* rather than vanishing with no trace:
|
|
400
|
+
*
|
|
401
|
+
* 1. NOT ALSO REOPENED. An id named in replanIds without ALSO being named
|
|
402
|
+
* in (and surviving the guard on) this round's reopenIds is DROPPED and
|
|
403
|
+
* never reaches the scoped-replan machinery. buildReviewerPrompt
|
|
404
|
+
* requires replanIds to be a subset of reopenIds; this is the
|
|
405
|
+
* enforcement side. Note the subset is checked against ids ACTUALLY
|
|
406
|
+
* reopened, so a below-goal id skipped by the scope guard cannot sneak
|
|
407
|
+
* back in through replanIds.
|
|
408
|
+
* 2. ALREADY REPLANNED THIS CYCLE. A bead that has already been through one
|
|
409
|
+
* in-cycle scoped replan is refused a SECOND: it stays reopened (real
|
|
410
|
+
* dev feedback still applies) but is not re-added, so the develop loop
|
|
411
|
+
* never dispatches a second scoped planner pass for it -- it is handed
|
|
412
|
+
* to the next cycle's planner instead. This is what makes "max one
|
|
413
|
+
* scoped replan per bead per cycle" hold regardless of the round budget.
|
|
414
|
+
*
|
|
415
|
+
* @param {object} o
|
|
416
|
+
* @param {string[]|undefined} o.replanIds - the verdict's replanIds (absent on verdicts that do not use it)
|
|
417
|
+
* @param {Set<string>} o.reopenedIds - ids actually reopened this round
|
|
418
|
+
* @param {Set<string>} o.replannedThisCycle - beads already scoped-replanned this cycle
|
|
419
|
+
* @param {number|string} o.cycle - cycle label, for log text
|
|
420
|
+
* @param {(msg: string) => void} o.log
|
|
421
|
+
* @returns {string[]} the ids accepted into the cycle's replan union
|
|
422
|
+
*/
|
|
423
|
+
export function foldReplanIds(o) {
|
|
424
|
+
const { replanIds, reopenedIds, replannedThisCycle, cycle, log } = o;
|
|
425
|
+
const accepted = [];
|
|
426
|
+
for (const id of (replanIds || [])) {
|
|
427
|
+
if (!reopenedIds.has(id)) {
|
|
428
|
+
log(
|
|
429
|
+
`[fleet-sprint] replanIds: DROPPED '${id}' -- not also named in this round's reopenIds ` +
|
|
430
|
+
`(reviewer prompt requires replanIds to be a subset of reopenIds), so it never reaches the ` +
|
|
431
|
+
`scoped-replan machinery.`
|
|
432
|
+
);
|
|
433
|
+
continue;
|
|
434
|
+
}
|
|
435
|
+
if (replannedThisCycle.has(id)) {
|
|
436
|
+
log(
|
|
437
|
+
`[fleet-sprint] replan loop guard: bead ${id} was already scoped-replanned once this cycle ` +
|
|
438
|
+
`(C${cycle}) and a reviewer has flagged it for replan AGAIN -- refusing a second in-cycle scoped ` +
|
|
439
|
+
`replan (max one per bead per cycle). It stays reopened and is handed off to the next cycle's ` +
|
|
440
|
+
`planner rather than re-planned again now.`
|
|
441
|
+
);
|
|
442
|
+
continue;
|
|
443
|
+
}
|
|
444
|
+
accepted.push(id);
|
|
445
|
+
}
|
|
446
|
+
return accepted;
|
|
447
|
+
}
|
|
@@ -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
|
+
}
|