@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
|
@@ -7,17 +7,20 @@ import { existsSync, realpathSync } from 'node:fs';
|
|
|
7
7
|
import { FleetWorkflow } from '@apralabs/apra-fleet-workflow';
|
|
8
8
|
import { WorkflowEngine } from '@apralabs/apra-fleet-workflow/engine';
|
|
9
9
|
import { createDashboardViewer } from '@apralabs/apra-fleet-workflow/viewer';
|
|
10
|
-
import { StreamableHttpTransport } from '@apralabs/apra-fleet-client/transport';
|
|
11
10
|
import { McpClient } from '@apralabs/apra-fleet-client/client';
|
|
12
11
|
import { ApraFleet } from '@apralabs/apra-fleet-client';
|
|
13
12
|
import {
|
|
14
13
|
resolveFleetServerCommand as sharedResolveFleetServerCommand,
|
|
15
14
|
resolveFleetServerConnection as sharedResolveFleetServerConnection,
|
|
15
|
+
createFleetHttpTransport,
|
|
16
16
|
getServerInfoPath,
|
|
17
17
|
} from '@apralabs/apra-fleet-client/server-resolution';
|
|
18
|
-
import { beadsExtension } from '../fleet-sprint/viewer-extensions.mjs';
|
|
19
|
-
import { validateIssueId, validateBranchName,
|
|
18
|
+
import { beadsExtension, kbCodeIntelExtension } from '../fleet-sprint/viewer-extensions.mjs';
|
|
19
|
+
import { validateIssueId, validateBranchName, validateBranchPair, createMemberReservationClient, resyncReacquiredMember, commandResultToSoftGit } from '../fleet-sprint/runner.js';
|
|
20
20
|
import { normalizeRole } from '../fleet-sprint/contracts.mjs';
|
|
21
|
+
import { prepareLaunchTopology, toAlignCommandResult } from '../fleet-sprint/member-align.mjs';
|
|
22
|
+
import { ROLE_BACKLOG, resolveBacklogRoleAlias, selectBacklogMember, formatBacklogSelection } from '../fleet-sprint/backlog-role.mjs';
|
|
23
|
+
import { BEADS_IDENTITY_PROBES, parseBeadsIdentity, formatBeadsIdentity, parseExpectedIdentity } from '../fleet-sprint/beads-identity.mjs';
|
|
21
24
|
|
|
22
25
|
const __filename = fileURLToPath(import.meta.url);
|
|
23
26
|
const __dirname = path.dirname(__filename);
|
|
@@ -155,15 +158,33 @@ export function buildOptionsSpec() {
|
|
|
155
158
|
// a direct/standalone CLI launch (no supervisor) falls back to
|
|
156
159
|
// --branch for this identity, exactly as before this flag existed.
|
|
157
160
|
'run-id': { type: 'string' },
|
|
161
|
+
// The beads identity (JSON, serializeExpectedIdentity output) every
|
|
162
|
+
// member's bd must resolve to, injected by the supervisor's spawner;
|
|
163
|
+
// env fallback FLEET_SPRINT_EXPECT_BEADS. Omitted (direct launch):
|
|
164
|
+
// the runner takes the expectation from the backlog member.
|
|
165
|
+
'expect-beads': { type: 'string' },
|
|
158
166
|
budget: { type: 'string' },
|
|
159
167
|
// Stabilization Issue 32: per-dispatch time budget in seconds
|
|
160
168
|
// (timeout_s == max_total_s at every dispatch; integ ceiling 2x).
|
|
161
169
|
'dispatch-timeout-s': { type: 'string' },
|
|
170
|
+
// apra-fleet-hzeb.4.2: the CLI-overridable usage-limit pause budgets.
|
|
171
|
+
// Both optional; omitted, the runner uses USAGE_LIMIT_BUDGET_DEFAULTS.
|
|
172
|
+
'usage-limit-max-wait-s': { type: 'string' },
|
|
173
|
+
'usage-limit-max-reprobes': { type: 'string' },
|
|
162
174
|
// apra-fleet-eft.8.5: explicitly opt a multi-member run into synced
|
|
163
175
|
// topology mode (orchestrator-bracketed git sync -- same-origin +
|
|
164
176
|
// dolt-probe precondition, differing HEADs allowed). Omitted => legacy
|
|
165
177
|
// shared-workspace mode (same-HEAD). Mode is never inferred silently.
|
|
166
178
|
sync: { type: 'boolean' },
|
|
179
|
+
// Explicitly skip the once-per-sprint regression pass (forwarded as the
|
|
180
|
+
// runner's skip_regression arg; the supervisor sets it from the launch
|
|
181
|
+
// body's phases.regression:"skip"). Never silent: logged, and reported in
|
|
182
|
+
// the sprint analysis and the PR body.
|
|
183
|
+
'skip-regression': { type: 'boolean' },
|
|
184
|
+
// --ci-gate is DELIBERATELY NOT WIRED (2026-10-01): the runner's
|
|
185
|
+
// ci_gate arg is disabled until the CI-as-quality-resource epic
|
|
186
|
+
// (apra-fleet-dv8i) designs the flow -- see fleet-sprint/sprint-args.mjs.
|
|
187
|
+
// 'ci-gate': { type: 'string' },
|
|
167
188
|
help: { type: 'boolean', short: 'h' },
|
|
168
189
|
};
|
|
169
190
|
}
|
|
@@ -193,16 +214,29 @@ Options:
|
|
|
193
214
|
Normally set automatically to the supervisor's sprintId when this
|
|
194
215
|
sprint is supervisor-spawned; omitted (direct/standalone launch)
|
|
195
216
|
falls back to --branch, exactly as before this flag existed.
|
|
217
|
+
--expect-beads <json> Beads identity every member must resolve to, as JSON
|
|
218
|
+
({"beadsDir","prefix","syncRemote","repoRemote"}). Normally injected by
|
|
219
|
+
the supervisor; env fallback FLEET_SPRINT_EXPECT_BEADS. Omitted: the
|
|
220
|
+
backlog member's own 'bd where' becomes the expectation and every
|
|
221
|
+
other member must match it. A mismatch aborts before any bd mutation.
|
|
196
222
|
--budget <usd> USD ceiling for this run's total estimated spend. Optional;
|
|
197
223
|
omitted (the default) means unlimited, identical to prior behavior.
|
|
198
|
-
--dispatch-timeout-s <s> Per-dispatch time budget in seconds (default
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
sprints so a hung dispatch costs minutes, not
|
|
224
|
+
--dispatch-timeout-s <s> Per-dispatch time budget in seconds (default 9000). The hard ceiling
|
|
225
|
+
on every agent dispatch (integration-test ceiling 2x, regression-test
|
|
226
|
+
ceiling 3x); the inactivity timeout is this value capped at 1800.
|
|
227
|
+
Lower it for small sprints so a hung dispatch costs minutes, not
|
|
228
|
+
hours. Minimum 60.
|
|
229
|
+
--usage-limit-max-wait-s <s> Total wall-clock seconds a dispatch may stay paused across all
|
|
230
|
+
usage-limit reprobes before giving up (typed sprint abort). Optional;
|
|
231
|
+
omitted uses the runner default. Minimum 60.
|
|
232
|
+
--usage-limit-max-reprobes <n> Max usage-limit reprobe attempts before giving up, independent
|
|
233
|
+
of elapsed wait. Optional; omitted uses the runner default. Minimum 1.
|
|
202
234
|
--sync Use synced topology mode (orchestrator-bracketed git sync):
|
|
203
235
|
members may sit on differing HEADs but must share the same
|
|
204
236
|
origin URL and pass a 'bd dolt pull' probe. Omitted (default)
|
|
205
237
|
uses legacy shared-workspace mode (all members on the same HEAD).
|
|
238
|
+
--skip-regression Skip the once-per-sprint regression pass. Logged, and stated in the
|
|
239
|
+
sprint analysis and the PR body. Integration tests still run.
|
|
206
240
|
-h, --help Show this help message.
|
|
207
241
|
`.trim();
|
|
208
242
|
|
|
@@ -234,7 +268,18 @@ export function parseCliArgs(argv) {
|
|
|
234
268
|
* @returns {Promise<object|undefined>}
|
|
235
269
|
*/
|
|
236
270
|
export async function resolveRoleMap(rawValue, deps = {}) {
|
|
237
|
-
|
|
271
|
+
return (await resolveRoleMapWithWarnings(rawValue, deps)).roleMap;
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* Same as resolveRoleMap() but also returns the backlog-alias deprecation
|
|
276
|
+
* warnings, so main() can print them and forward them to the runner (which
|
|
277
|
+
* logs them in the run log -- the rewritten roleMap no longer carries the
|
|
278
|
+
* deprecated key, so the runner could not detect it itself).
|
|
279
|
+
* @returns {Promise<{ roleMap: object|undefined, warnings: string[] }>}
|
|
280
|
+
*/
|
|
281
|
+
export async function resolveRoleMapWithWarnings(rawValue, deps = {}) {
|
|
282
|
+
if (rawValue === undefined) return { roleMap: undefined, warnings: [] };
|
|
238
283
|
const readFile = deps.readFile || fs.readFile;
|
|
239
284
|
|
|
240
285
|
let jsonText = rawValue;
|
|
@@ -267,12 +312,12 @@ export async function resolveRoleMap(rawValue, deps = {}) {
|
|
|
267
312
|
// contracts.normalizeRole() (trim + lowercase) HERE -- this is where
|
|
268
313
|
// roleMap keys first enter the system from a user-supplied
|
|
269
314
|
// `--role-map`/`@file.json` value, so callers of `resolveRoleMap()`
|
|
270
|
-
// (including this CLI's own pre-transport `
|
|
315
|
+
// (including this CLI's own pre-transport `backlogMember` lookup
|
|
271
316
|
// below, and runner.js's `validateArgs()`, which normalizes again
|
|
272
317
|
// defensively for callers that bypass the CLI and pass a raw roleMap
|
|
273
318
|
// straight to `engine.executeFile()`) can rely on keys already being in
|
|
274
319
|
// canonical lowercase form. This also covers the 'orchestrator'
|
|
275
|
-
// application-level pseudo-role key (see runner.js's
|
|
320
|
+
// application-level pseudo-role key (see runner.js's ROLE_BACKLOG
|
|
276
321
|
// doc comment) -- it is not a vendored contracts.ROLES member but is
|
|
277
322
|
// still just a plain string key here, so the same normalization applies.
|
|
278
323
|
const normalized = {};
|
|
@@ -287,7 +332,12 @@ export async function resolveRoleMap(rawValue, deps = {}) {
|
|
|
287
332
|
normalized[key] = members;
|
|
288
333
|
}
|
|
289
334
|
|
|
290
|
-
|
|
335
|
+
// Deprecated 'orchestrator' key -> 'backlog'; a conflict throws.
|
|
336
|
+
try {
|
|
337
|
+
return resolveBacklogRoleAlias(normalized);
|
|
338
|
+
} catch (err) {
|
|
339
|
+
throw new Error(`Error: --role-map ${err.message}`);
|
|
340
|
+
}
|
|
291
341
|
}
|
|
292
342
|
|
|
293
343
|
/**
|
|
@@ -303,7 +353,7 @@ export async function resolveRoleMap(rawValue, deps = {}) {
|
|
|
303
353
|
* }} opts
|
|
304
354
|
* @returns {object}
|
|
305
355
|
*/
|
|
306
|
-
export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goal, maxCycles, requirementsFile, roleMap, budget, dispatchTimeoutS, serviceUrl, runId }) {
|
|
356
|
+
export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goal, maxCycles, requirementsFile, roleMap, roleMapWarnings, budget, dispatchTimeoutS, usageLimitMaxWaitS, usageLimitMaxReprobes, serviceUrl, runId, expectBeads, skipRegression, ciGate }) {
|
|
307
357
|
const args = {
|
|
308
358
|
target_issues: targetIssues,
|
|
309
359
|
members,
|
|
@@ -314,8 +364,14 @@ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goa
|
|
|
314
364
|
};
|
|
315
365
|
if (requirementsFile !== undefined) args.requirementsFile = requirementsFile;
|
|
316
366
|
if (roleMap !== undefined) args.roleMap = roleMap;
|
|
367
|
+
if (Array.isArray(roleMapWarnings) && roleMapWarnings.length > 0) args.roleMapWarnings = roleMapWarnings;
|
|
317
368
|
if (budget !== undefined) args.budget = budget;
|
|
318
369
|
if (dispatchTimeoutS !== undefined) args.dispatch_timeout_s = dispatchTimeoutS;
|
|
370
|
+
// apra-fleet-hzeb.4.2: the CLI-overridable usage-limit pause budgets,
|
|
371
|
+
// forwarded to runner.js's validateArgs() when supplied (omitted keeps the
|
|
372
|
+
// runner's USAGE_LIMIT_BUDGET_DEFAULTS).
|
|
373
|
+
if (usageLimitMaxWaitS !== undefined) args.usage_limit_max_wait_s = usageLimitMaxWaitS;
|
|
374
|
+
if (usageLimitMaxReprobes !== undefined) args.usage_limit_max_reprobes = usageLimitMaxReprobes;
|
|
319
375
|
// apra-fleet-f34.1: forwarded straight through to runner.js's validateArgs()
|
|
320
376
|
// (args.serviceUrl), which is what actually switches it onto the
|
|
321
377
|
// HTTP-backed dolt-mutex/id-allocator clients (fleet-sprint/runner.js
|
|
@@ -327,9 +383,70 @@ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goa
|
|
|
327
383
|
// dispatch so deploy.md's active-sprints gate can recognize this sprint's
|
|
328
384
|
// OWN reservation instead of stopping on it.
|
|
329
385
|
if (runId !== undefined) args.run_id = runId;
|
|
386
|
+
// Only forwarded when set, so a default launch's runner args are unchanged.
|
|
387
|
+
if (skipRegression === true) args.skip_regression = true;
|
|
388
|
+
// The raw --expect-beads JSON, forwarded verbatim; runner.js's
|
|
389
|
+
// validateArgs() parses it (validateExpectBeads) and rejects bad JSON.
|
|
390
|
+
if (expectBeads !== undefined) args.expect_beads = expectBeads;
|
|
391
|
+
// --ci-gate is not wired (apra-fleet-dv8i); ci_gate is never forwarded.
|
|
392
|
+
// if (ciGate !== undefined) args.ci_gate = ciGate;
|
|
330
393
|
return args;
|
|
331
394
|
}
|
|
332
395
|
|
|
396
|
+
/**
|
|
397
|
+
* Resolves the `--expect-beads` value: the flag wins, else the
|
|
398
|
+
* FLEET_SPRINT_EXPECT_BEADS env var, else undefined (no expectation).
|
|
399
|
+
* @param {string|undefined} flagValue
|
|
400
|
+
* @param {NodeJS.ProcessEnv} env
|
|
401
|
+
* @returns {string|undefined}
|
|
402
|
+
*/
|
|
403
|
+
export function resolveExpectBeads(flagValue, env = process.env) {
|
|
404
|
+
if (typeof flagValue === 'string' && flagValue.trim()) return flagValue;
|
|
405
|
+
const fromEnv = env.FLEET_SPRINT_EXPECT_BEADS;
|
|
406
|
+
if (typeof fromEnv === 'string' && fromEnv.trim()) return fromEnv;
|
|
407
|
+
return undefined;
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
/**
|
|
411
|
+
* Runs `bd where --json` on the BACKLOG MEMBER (never locally -- the
|
|
412
|
+
* sprint's bd commands run in that member's workFolder, see
|
|
413
|
+
* checkIssuesExistOnMember below) so the startup banner can show which
|
|
414
|
+
* .beads the sprint is about to mutate, and so a member with no beads
|
|
415
|
+
* database is reported plainly (as a WARNING with the fix -- the `bd show`
|
|
416
|
+
* precondition right after it is what actually fails a member whose bd
|
|
417
|
+
* cannot answer). The runner re-probes every member and does the hard
|
|
418
|
+
* expected-vs-actual comparison; this is display only.
|
|
419
|
+
* @param {{ member: string, runCommand: (cmd: string, member: string) => Promise<string> }} opts
|
|
420
|
+
* @returns {Promise<{ ok: boolean, identity: object|null, message: string }>}
|
|
421
|
+
*/
|
|
422
|
+
export async function probeBeadsIdentityOnMember({ member, runCommand }) {
|
|
423
|
+
const raw = {};
|
|
424
|
+
const fix = `To fix: run 'bd where' in the member's workFolder; ensure bd is installed there and the folder contains the project's .beads.`;
|
|
425
|
+
for (const [key, cmd] of Object.entries(BEADS_IDENTITY_PROBES)) {
|
|
426
|
+
try {
|
|
427
|
+
raw[key] = await runCommand(cmd, member);
|
|
428
|
+
} catch (err) {
|
|
429
|
+
if (key === 'where') {
|
|
430
|
+
return {
|
|
431
|
+
ok: false,
|
|
432
|
+
identity: null,
|
|
433
|
+
message: `Warning: no beads database found at member '${member}'s workFolder ('${cmd}' failed: ${err && err.message ? err.message : String(err)}); the beads identity cannot be shown and is not verified for this member. ${fix}`,
|
|
434
|
+
};
|
|
435
|
+
}
|
|
436
|
+
raw[key] = '';
|
|
437
|
+
}
|
|
438
|
+
}
|
|
439
|
+
const identity = parseBeadsIdentity(raw);
|
|
440
|
+
if (!identity.beadsDir) {
|
|
441
|
+
return {
|
|
442
|
+
ok: false,
|
|
443
|
+
identity: null,
|
|
444
|
+
message: `Warning: no beads database found at member '${member}'s workFolder ('${BEADS_IDENTITY_PROBES.where}' returned no database path: ${String(raw.where || '').trim() || '(no output)'}); the beads identity cannot be shown and is not verified for this member. ${fix}`,
|
|
445
|
+
};
|
|
446
|
+
}
|
|
447
|
+
return { ok: true, identity, message: formatBeadsIdentity(identity, { label: `[Precondition] member '${member}'` }) };
|
|
448
|
+
}
|
|
449
|
+
|
|
333
450
|
/**
|
|
334
451
|
* Splits `--members` against the fleet's registered member names and decides
|
|
335
452
|
* whether the sprint may proceed.
|
|
@@ -379,9 +496,9 @@ export function resolveMemberValidation({ rawMembers, registeredNames, allowMiss
|
|
|
379
496
|
}
|
|
380
497
|
|
|
381
498
|
/**
|
|
382
|
-
* Verifies every target issue exists, run on the
|
|
499
|
+
* Verifies every target issue exists, run on the BACKLOG MEMBER via the
|
|
383
500
|
* fleet transport (`runBdShow`) -- NOT on the local machine. The sprint's own
|
|
384
|
-
* `bd` commands run against the
|
|
501
|
+
* `bd` commands run against the backlog member's beads DB (see
|
|
385
502
|
* fleet-sprint/runner.js's SUPPORTED-TOPOLOGY NOTE), which can be a different
|
|
386
503
|
* database than whatever is local to wherever this CLI process happens to
|
|
387
504
|
* run. Checking locally could pass (or worse, resolve a same-named-but-
|
|
@@ -466,6 +583,37 @@ export function attachViewerErrorHandler(server, port, opts = {}) {
|
|
|
466
583
|
// the failure -- and precisely which members block the resume -- is surfaced to
|
|
467
584
|
// the operator instead of lost to a console.error line. Extracted and exported
|
|
468
585
|
// so the rethrow-and-name behavior is unit-testable without a live engine.
|
|
586
|
+
// Launch ordering: launch alignment (prepareLaunchTopology) stashes WIP and
|
|
587
|
+
// switches branches on members, so it must never run on a member another
|
|
588
|
+
// sprint holds -- that sprint's in-flight work would be moved under it. Reserve
|
|
589
|
+
// first (reserveForLaunch reports members another sprint already holds and
|
|
590
|
+
// then hands back what it took), align only when nothing is held, and release
|
|
591
|
+
// every reservation again when alignment refuses or throws, so a refused
|
|
592
|
+
// launch leaves no reservation behind. Exported so the ordering is unit-
|
|
593
|
+
// testable without a live server.
|
|
594
|
+
export async function reserveThenAlign({ sprintReservation, align } = {}) {
|
|
595
|
+
const { held } = await sprintReservation.reserveForLaunch();
|
|
596
|
+
if (held.length > 0) {
|
|
597
|
+
return {
|
|
598
|
+
ok: false,
|
|
599
|
+
reserved: false,
|
|
600
|
+
message: `member(s) ${held.join(', ')} are reserved by another running sprint, so no member was aligned or changed. Wait for that sprint to finish or release its reservation (member_reservation), then launch again.`,
|
|
601
|
+
};
|
|
602
|
+
}
|
|
603
|
+
let topology;
|
|
604
|
+
try {
|
|
605
|
+
topology = await align();
|
|
606
|
+
} catch (err) {
|
|
607
|
+
await sprintReservation.releaseAll();
|
|
608
|
+
throw err;
|
|
609
|
+
}
|
|
610
|
+
if (!topology || !topology.ok) {
|
|
611
|
+
await sprintReservation.releaseAll();
|
|
612
|
+
return { ...(topology || { ok: false, message: 'launch alignment returned no result' }), reserved: false };
|
|
613
|
+
}
|
|
614
|
+
return { ...topology, reserved: true };
|
|
615
|
+
}
|
|
616
|
+
|
|
469
617
|
export async function reReserveOnResume({ sprintReservation, resyncMember, requestPause, log = () => {} } = {}) {
|
|
470
618
|
try {
|
|
471
619
|
return await sprintReservation.reReserveForResume({ resyncMember });
|
|
@@ -521,6 +669,18 @@ async function main() {
|
|
|
521
669
|
// (unchanged pre-existing behavior in that case).
|
|
522
670
|
const effectiveRunId = values['run-id'] || branchName;
|
|
523
671
|
const dispatchTimeoutS = values['dispatch-timeout-s'] !== undefined ? Number(values['dispatch-timeout-s']) : undefined;
|
|
672
|
+
// apra-fleet-hzeb.4.2: the CLI-overridable usage-limit pause budgets.
|
|
673
|
+
const usageLimitMaxWaitS = values['usage-limit-max-wait-s'] !== undefined ? Number(values['usage-limit-max-wait-s']) : undefined;
|
|
674
|
+
const usageLimitMaxReprobes = values['usage-limit-max-reprobes'] !== undefined ? Number(values['usage-limit-max-reprobes']) : undefined;
|
|
675
|
+
// --expect-beads (flag, else FLEET_SPRINT_EXPECT_BEADS). Parsed here too
|
|
676
|
+
// so malformed JSON fails before any fleet connection; the runner's
|
|
677
|
+
// validateArgs() re-validates the raw string it is handed.
|
|
678
|
+
const expectBeads = resolveExpectBeads(values['expect-beads']);
|
|
679
|
+
const expectedBeads = expectBeads !== undefined ? parseExpectedIdentity(expectBeads) : null;
|
|
680
|
+
if (expectBeads !== undefined && !expectedBeads) {
|
|
681
|
+
console.error(`Error: --expect-beads is not valid JSON: ${expectBeads}`);
|
|
682
|
+
process.exit(1);
|
|
683
|
+
}
|
|
524
684
|
|
|
525
685
|
// --- A7 defense-in-depth: reject shell-unsafe issue ids / branch names
|
|
526
686
|
// BEFORE any bd/fleet dispatch happens. runner.js re-validates these
|
|
@@ -529,11 +689,14 @@ async function main() {
|
|
|
529
689
|
// is somehow bypassed -- both layers share the exact same validators
|
|
530
690
|
// (imported from runner.js) so there is a single source of truth.
|
|
531
691
|
let roleMap;
|
|
692
|
+
let roleMapWarnings = [];
|
|
532
693
|
try {
|
|
533
694
|
targetIssues.forEach(validateIssueId);
|
|
534
695
|
validateBranchName(branchName, 'branch');
|
|
535
696
|
validateBranchName(baseBranch, 'base');
|
|
536
|
-
|
|
697
|
+
validateBranchPair(branchName, baseBranch);
|
|
698
|
+
({ roleMap, warnings: roleMapWarnings } = await resolveRoleMapWithWarnings(values['role-map']));
|
|
699
|
+
for (const w of roleMapWarnings) console.warn(`Warning: ${w}`);
|
|
537
700
|
} catch (err) {
|
|
538
701
|
console.error(`Error: ${err.message}`);
|
|
539
702
|
process.exit(1);
|
|
@@ -561,6 +724,18 @@ async function main() {
|
|
|
561
724
|
process.exit(1);
|
|
562
725
|
}
|
|
563
726
|
|
|
727
|
+
// apra-fleet-hzeb.4.2: same strict-parsing posture as --dispatch-timeout-s
|
|
728
|
+
// above; mirrors (does not replace) runner.js validateArgs's own checks.
|
|
729
|
+
if (usageLimitMaxWaitS !== undefined && (!Number.isInteger(usageLimitMaxWaitS) || usageLimitMaxWaitS < 60)) {
|
|
730
|
+
console.error(`Error: --usage-limit-max-wait-s must be an integer >= 60 (seconds), got "${values['usage-limit-max-wait-s']}".`);
|
|
731
|
+
process.exit(1);
|
|
732
|
+
}
|
|
733
|
+
|
|
734
|
+
if (usageLimitMaxReprobes !== undefined && (!Number.isInteger(usageLimitMaxReprobes) || usageLimitMaxReprobes < 1)) {
|
|
735
|
+
console.error(`Error: --usage-limit-max-reprobes must be an integer >= 1, got "${values['usage-limit-max-reprobes']}".`);
|
|
736
|
+
process.exit(1);
|
|
737
|
+
}
|
|
738
|
+
|
|
564
739
|
if (budget !== undefined && (!Number.isFinite(budget) || budget < 0)) {
|
|
565
740
|
console.error(`Error: --budget must be a non-negative finite number (USD ceiling), got "${values.budget}".`);
|
|
566
741
|
process.exit(1);
|
|
@@ -571,7 +746,7 @@ async function main() {
|
|
|
571
746
|
// 1. Attach to the fleet MCP transport FIRST, so member validation, the
|
|
572
747
|
// "bd show" issue precondition (below), and the sprint itself all run
|
|
573
748
|
// against the same live client/connection -- and so the issue
|
|
574
|
-
// precondition can target the
|
|
749
|
+
// precondition can target the backlog MEMBER rather than the local
|
|
575
750
|
// machine (apra-fleet-unw2.16, N14 (d): the sprint's own `bd` commands
|
|
576
751
|
// run on the member via the fleet transport, which can be a different
|
|
577
752
|
// database than whatever is local to this CLI process).
|
|
@@ -585,7 +760,17 @@ async function main() {
|
|
|
585
760
|
// fail fast with a typed error naming the missing connection config --
|
|
586
761
|
// silently self-spawning a private stdio server here would defeat the
|
|
587
762
|
// whole point of sharing one fleet-server connection across N children.
|
|
588
|
-
|
|
763
|
+
let connection;
|
|
764
|
+
try {
|
|
765
|
+
connection = await resolveFleetServerConnection();
|
|
766
|
+
} catch (err) {
|
|
767
|
+
// e.g. the server was stopped with 'apra-fleet stop', or auto-start
|
|
768
|
+
// refused/failed: print the actionable message on stderr (the
|
|
769
|
+
// supervisor surfaces a launch's stderr tail), not a stack trace.
|
|
770
|
+
console.error(`Error: ${err && err.message ? err.message : err}`);
|
|
771
|
+
process.exit(1);
|
|
772
|
+
return;
|
|
773
|
+
}
|
|
589
774
|
if (connection.mode !== 'http') {
|
|
590
775
|
const err = new FleetServerUnreachableError(
|
|
591
776
|
'No reachable apra-fleet HTTP singleton was found. cli.mjs no longer ' +
|
|
@@ -601,7 +786,10 @@ async function main() {
|
|
|
601
786
|
process.exit(1);
|
|
602
787
|
return;
|
|
603
788
|
}
|
|
604
|
-
|
|
789
|
+
// Reconnecting HTTP transport: if the shared server dies mid-run it is
|
|
790
|
+
// re-probed (and auto-started when gone) before the next request; a request
|
|
791
|
+
// is retried once only when it provably never reached the server.
|
|
792
|
+
const transport = createFleetHttpTransport(connection, { dirname: __dirname, exists: existsSync });
|
|
605
793
|
await transport.start();
|
|
606
794
|
const mcpClient = new McpClient(transport);
|
|
607
795
|
|
|
@@ -611,9 +799,9 @@ async function main() {
|
|
|
611
799
|
let validMembers = [];
|
|
612
800
|
// apra-fleet: names flagged unreservable in the SAME list_members read --
|
|
613
801
|
// hoisted out of this try block so the topology filter below (item 4) can
|
|
614
|
-
// key on the actual unreservable flag, not on roleMap.
|
|
802
|
+
// key on the actual unreservable flag, not on roleMap.backlog
|
|
615
803
|
// membership (which would also match a real, git-having dispatch member
|
|
616
|
-
// that is ADDITIONALLY role-mapped as
|
|
804
|
+
// that is ADDITIONALLY role-mapped as backlog, and wrongly skip its
|
|
617
805
|
// legitimate same-HEAD topology check).
|
|
618
806
|
let unreservableNames = new Set();
|
|
619
807
|
try {
|
|
@@ -636,21 +824,43 @@ async function main() {
|
|
|
636
824
|
process.exit(1);
|
|
637
825
|
}
|
|
638
826
|
|
|
639
|
-
// 3. bd show issue precondition -- run on the
|
|
827
|
+
// 3. bd show issue precondition -- run on the backlog MEMBER via the
|
|
640
828
|
// fleet transport (apra-fleet-unw2.16, N14 (d)), immediately after the
|
|
641
829
|
// transport/initialize handshake above and before any sprint phase
|
|
642
|
-
// begins. The
|
|
643
|
-
// `getMemberForRole(
|
|
830
|
+
// begins. The backlog member mirrors fleet-sprint/runner.js's
|
|
831
|
+
// `getMemberForRole(ROLE_BACKLOG)` resolution: roleMap.backlog[0]
|
|
644
832
|
// if configured, else the first valid member. `roleMap` here is already
|
|
645
833
|
// key-normalized by `resolveRoleMap()` above (N15, apra-fleet-unw2.11),
|
|
646
|
-
// so the canonical lowercase '
|
|
834
|
+
// so the canonical lowercase 'backlog' key is the only one that can
|
|
647
835
|
// be present -- this must NOT read a capitalized 'Orchestrator' key (the
|
|
648
836
|
// N15 finding: that stray casing silently never matched a roleMap
|
|
649
837
|
// author's natural lowercase key).
|
|
650
|
-
const
|
|
838
|
+
const backlogSelection = selectBacklogMember({ roleMap, members: validMembers });
|
|
839
|
+
const backlogMember = backlogSelection.member;
|
|
840
|
+
const backlogSelectionLine = formatBacklogSelection(backlogSelection);
|
|
841
|
+
if (backlogSelectionLine) console.log(backlogSelectionLine);
|
|
842
|
+
const runProbe = async (cmd, member) => {
|
|
843
|
+
const res = await fleetApi.executeCommand({ command: cmd, member_name: member });
|
|
844
|
+
const text = res && res.content && res.content[0] ? res.content[0].text : '';
|
|
845
|
+
if (res && res.isError) throw new Error(text || 'unknown error');
|
|
846
|
+
const exitCode = res && res.structuredContent && typeof res.structuredContent.exitCode === 'number' ? res.structuredContent.exitCode : 0;
|
|
847
|
+
if (exitCode !== 0) throw new Error(text || `exit code ${exitCode}`);
|
|
848
|
+
return res && res.structuredContent && typeof res.structuredContent.stdout === 'string' ? res.structuredContent.stdout : text;
|
|
849
|
+
};
|
|
850
|
+
// Which .beads the backlog member's bd resolves to -- probed BEFORE
|
|
851
|
+
// the `bd show` precondition below so a member with no beads database
|
|
852
|
+
// is reported plainly (a warning with the fix) ahead of the bare bd
|
|
853
|
+
// error that precondition would otherwise be the first to show, and
|
|
854
|
+
// shown in the banner. A failed probe is a warning, not an exit: the
|
|
855
|
+
// existing preconditions decide. The runner repeats this for every
|
|
856
|
+
// member and hard-fails only a mismatch against --expect-beads.
|
|
857
|
+
const beadsProbe = await probeBeadsIdentityOnMember({ member: backlogMember, runCommand: runProbe });
|
|
858
|
+
if (!beadsProbe.ok) {
|
|
859
|
+
console.warn(beadsProbe.message);
|
|
860
|
+
}
|
|
651
861
|
const issueCheck = await checkIssuesExistOnMember({
|
|
652
862
|
targetIssues,
|
|
653
|
-
member:
|
|
863
|
+
member: backlogMember,
|
|
654
864
|
runBdShow: async (id, member) => fleetApi.executeCommand({ command: `bd show ${id}`, member_name: member }),
|
|
655
865
|
});
|
|
656
866
|
if (!issueCheck.ok) {
|
|
@@ -663,7 +873,7 @@ async function main() {
|
|
|
663
873
|
//
|
|
664
874
|
// LEGACY mode (default): the runner's cross-member coherence relies on
|
|
665
875
|
// every member sharing one workspace/DB -- every orchestrator-side `bd`
|
|
666
|
-
// command runs against the
|
|
876
|
+
// command runs against the backlog member's beads DB, and the sprint
|
|
667
877
|
// git branch is only coherent if every member operates on the same working
|
|
668
878
|
// state. Enforce that by comparing `git rev-parse HEAD` across members and
|
|
669
879
|
// refusing to start on a mismatch.
|
|
@@ -689,16 +899,16 @@ async function main() {
|
|
|
689
899
|
// fleet-sprint orchestrator, docs/design-orchestrator-worktree-model-v2.md)
|
|
690
900
|
// may have no real checkout at all, and `git rev-parse HEAD` on one
|
|
691
901
|
// hard-fails the launch (process.exit(1) just below). Deliberately keyed
|
|
692
|
-
// on the `unreservable` FLAG, not on roleMap.
|
|
902
|
+
// on the `unreservable` FLAG, not on roleMap.backlog membership: a
|
|
693
903
|
// real, git-having dispatch member that is ADDITIONALLY role-mapped as
|
|
694
|
-
//
|
|
904
|
+
// backlog (a supported topology, runner.js's branchEnsureMembers
|
|
695
905
|
// dedupe comment) must still pass its legitimate same-HEAD check against
|
|
696
|
-
// the other dispatch members -- filtering on roleMap.
|
|
906
|
+
// the other dispatch members -- filtering on roleMap.backlog alone
|
|
697
907
|
// would silently skip that check instead of just skipping a git-less
|
|
698
908
|
// member. This only matters when an operator also lists a shared member
|
|
699
|
-
// in --members (redundant with roleMap.
|
|
700
|
-
// a normal launch that passes the shared
|
|
701
|
-
// roleMap.
|
|
909
|
+
// in --members (redundant with roleMap.backlog, and not required);
|
|
910
|
+
// a normal launch that passes the shared backlog member ONLY via
|
|
911
|
+
// roleMap.backlog was never affected.
|
|
702
912
|
const topologyMembersFiltered = validMembers.filter((m) => !unreservableNames.has(m));
|
|
703
913
|
// Degrade back to the unfiltered list if excluding unreservable members
|
|
704
914
|
// would empty it out entirely -- checkMemberTopology refuses to start on
|
|
@@ -707,13 +917,54 @@ async function main() {
|
|
|
707
917
|
// the ORIGINAL single-member-trivial-pass behavior rather than a topology
|
|
708
918
|
// error about having no members at all.
|
|
709
919
|
const topologyMembers = topologyMembersFiltered.length > 0 ? topologyMembersFiltered : validMembers;
|
|
710
|
-
|
|
920
|
+
// apra-fleet-rsd9.1.1: in legacy mode, first ALIGN every topology member
|
|
921
|
+
// to the sprint base (fetch, preserve WIP in a named stash, check out the
|
|
922
|
+
// sprint branch -- see fleet-sprint/member-align.mjs), then run the
|
|
923
|
+
// topology check against the aligned state. Members that merely sat on
|
|
924
|
+
// other commits no longer refuse the launch; only what cannot be
|
|
925
|
+
// reconciled automatically (unreachable member, differing origin, base
|
|
926
|
+
// missing on origin, fetch auth failure, diverged sprint branch) does,
|
|
927
|
+
// and then before any member is moved. Synced mode is unchanged.
|
|
928
|
+
const runAlignGit = async (cmd, member) => {
|
|
929
|
+
try {
|
|
930
|
+
return toAlignCommandResult(await fleetApi.executeCommand({ command: cmd, member_name: member }));
|
|
931
|
+
} catch (err) {
|
|
932
|
+
return toAlignCommandResult(undefined, err);
|
|
933
|
+
}
|
|
934
|
+
};
|
|
935
|
+
// eft.26.1 reservation: a sprint launched directly through this CLI
|
|
936
|
+
// (never routed through the supervisor's POST /api/sprints) reserves its
|
|
937
|
+
// members server-side, on the SAME opaque sprint id runner.js uses for the
|
|
938
|
+
// dolt-mutex/allocator (the sprint branch name), so the supervisor's
|
|
939
|
+
// overlap guard and execute_prompt's dispatch-time reservedBy check can see
|
|
940
|
+
// it. It is taken BEFORE launch alignment (reserveThenAlign) and released
|
|
941
|
+
// on EVERY exit path below: a refused alignment, a viewer port failure,
|
|
942
|
+
// normal success, a caught failure/stall-abort, or SIGINT.
|
|
943
|
+
const sprintReservation = createMemberReservationClient({
|
|
944
|
+
callTool: (name, args) => mcpClient.callTool(name, args),
|
|
945
|
+
members: validMembers,
|
|
946
|
+
sprintId: branchName,
|
|
947
|
+
log: (msg) => console.log(msg),
|
|
948
|
+
});
|
|
949
|
+
// Ctrl-C between the reserve and the sprint's own SIGINT handler (below)
|
|
950
|
+
// must not leave the members reserved.
|
|
951
|
+
const onLaunchSigint = () => {
|
|
952
|
+
sprintReservation.releaseAll()
|
|
953
|
+
.catch((err) => console.error('[member-reservation] release-on-SIGINT failed:', err))
|
|
954
|
+
.finally(() => process.exit(130));
|
|
955
|
+
};
|
|
956
|
+
process.once('SIGINT', onLaunchSigint);
|
|
957
|
+
const topology = await reserveThenAlign({ sprintReservation, align: () => prepareLaunchTopology({
|
|
711
958
|
members: topologyMembers,
|
|
712
959
|
mode: syncedMode ? 'synced' : 'legacy',
|
|
960
|
+
baseBranch,
|
|
961
|
+
branch: branchName,
|
|
962
|
+
runGit: runAlignGit,
|
|
963
|
+
log: (msg) => console.log(msg),
|
|
713
964
|
getIdentity: (member) => runCommand('git rev-parse HEAD', member),
|
|
714
965
|
getOriginUrl: (member) => runCommand('git remote get-url origin', member),
|
|
715
966
|
doltProbe: (member) => runCommand('bd dolt pull', member),
|
|
716
|
-
});
|
|
967
|
+
}) });
|
|
717
968
|
if (!topology.ok) {
|
|
718
969
|
console.error(`Error: ${topology.message}`);
|
|
719
970
|
transport.stop();
|
|
@@ -723,12 +974,16 @@ async function main() {
|
|
|
723
974
|
console.log(topology.message);
|
|
724
975
|
}
|
|
725
976
|
|
|
726
|
-
console.log('Starting
|
|
977
|
+
console.log('Starting fleet-sprint');
|
|
727
978
|
console.log(`Target Issues: ${targetIssues.join(', ')}`);
|
|
728
979
|
console.log(`Sprint Branch: ${branchName} (Base: ${baseBranch})`);
|
|
729
980
|
console.log(`Goal Constraint: ${goal}`);
|
|
730
981
|
console.log(`Max Cycles: ${maxCycles}`);
|
|
731
982
|
console.log(`Active Members (${validMembers.length}): ${validMembers.join(', ')}`);
|
|
983
|
+
console.log(`Beads: ${formatBeadsIdentity(beadsProbe.identity, { label: `backlog '${backlogMember}'` })}`);
|
|
984
|
+
if (expectedBeads) {
|
|
985
|
+
console.log(`Beads: ${formatBeadsIdentity(expectedBeads, { label: 'expected (--expect-beads)' })}`);
|
|
986
|
+
}
|
|
732
987
|
|
|
733
988
|
const workflow = new FleetWorkflow(fleetApi);
|
|
734
989
|
const engine = new WorkflowEngine(workflow);
|
|
@@ -736,7 +991,9 @@ async function main() {
|
|
|
736
991
|
const server = createDashboardViewer(workflow, {
|
|
737
992
|
port: viewerPort,
|
|
738
993
|
name: 'Fleet-Sprint',
|
|
739
|
-
|
|
994
|
+
// kbCodeIntelExtension: its own tab (per-member, per-dispatch kb_* and
|
|
995
|
+
// code_* call counts), separate from the Tasks tab.
|
|
996
|
+
dashboardExtensions: [beadsExtension, kbCodeIntelExtension],
|
|
740
997
|
// apra-fleet-eft.37.1/37.2: the core viewer now speaks opts.runId
|
|
741
998
|
// (opts.sprintId is a deprecated BOUNDARY-COMPAT alias -- never use
|
|
742
999
|
// it from here).
|
|
@@ -755,7 +1012,7 @@ async function main() {
|
|
|
755
1012
|
runId: effectiveRunId,
|
|
756
1013
|
// BOUNDARY-COMPAT/user-facing convention (apra-fleet-eft.37.1): core's
|
|
757
1014
|
// crash-net snapshot defaults are domain-neutral (workflow-logs/run_)
|
|
758
|
-
// now that sprintId->runId is renamed;
|
|
1015
|
+
// now that sprintId->runId is renamed; fleet-sprint keeps its historical
|
|
759
1016
|
// sprint-logs/sprint_<HHMMSS>.json convention by passing these
|
|
760
1017
|
// explicitly rather than picking up the new core defaults.
|
|
761
1018
|
stateSnapshotDir: 'sprint-logs',
|
|
@@ -778,14 +1035,18 @@ async function main() {
|
|
|
778
1035
|
onError: (message) => {
|
|
779
1036
|
viewerFailed = true;
|
|
780
1037
|
console.error(`Error: ${message}`);
|
|
781
|
-
|
|
782
|
-
|
|
1038
|
+
sprintReservation.releaseAll()
|
|
1039
|
+
.catch((err) => console.error('[member-reservation] release on viewer failure failed:', err && err.message ? err.message : err))
|
|
1040
|
+
.finally(() => {
|
|
1041
|
+
transport.stop();
|
|
1042
|
+
process.exit(1);
|
|
1043
|
+
});
|
|
783
1044
|
},
|
|
784
1045
|
});
|
|
785
1046
|
|
|
786
1047
|
console.log(`Dashboard live at http://localhost:${viewerPort}`);
|
|
787
1048
|
|
|
788
|
-
if (viewerFailed) return; //
|
|
1049
|
+
if (viewerFailed) return; // onError releases the reservations, then exits
|
|
789
1050
|
|
|
790
1051
|
// apra-fleet-eft.26.1 (Reservation interop gap, Hole 1): a sprint
|
|
791
1052
|
// launched directly through this CLI (never routed through the
|
|
@@ -797,13 +1058,7 @@ async function main() {
|
|
|
797
1058
|
// for the dolt-mutex/allocator (the sprint branch name), and release on
|
|
798
1059
|
// EVERY exit path below: normal success, a caught failure/stall-abort,
|
|
799
1060
|
// or SIGINT.
|
|
800
|
-
|
|
801
|
-
callTool: (name, args) => mcpClient.callTool(name, args),
|
|
802
|
-
members: validMembers,
|
|
803
|
-
sprintId: branchName,
|
|
804
|
-
log: (msg) => console.log(msg),
|
|
805
|
-
});
|
|
806
|
-
await sprintReservation.reserveAll();
|
|
1061
|
+
// (The members were reserved above, before launch alignment.)
|
|
807
1062
|
|
|
808
1063
|
// apra-fleet-p2to.4.2: reservation handling across a cooperative
|
|
809
1064
|
// pause/resume (apra-fleet-p2to.1's engine primitive). On 'paused' hand
|
|
@@ -880,6 +1135,7 @@ async function main() {
|
|
|
880
1135
|
.catch((err) => console.error('[member-reservation] release-on-SIGINT failed:', err))
|
|
881
1136
|
.finally(() => process.exit(130));
|
|
882
1137
|
};
|
|
1138
|
+
process.removeListener('SIGINT', onLaunchSigint);
|
|
883
1139
|
process.once('SIGINT', onSigint);
|
|
884
1140
|
|
|
885
1141
|
try {
|
|
@@ -894,10 +1150,16 @@ async function main() {
|
|
|
894
1150
|
maxCycles,
|
|
895
1151
|
requirementsFile,
|
|
896
1152
|
roleMap,
|
|
1153
|
+
roleMapWarnings,
|
|
897
1154
|
budget,
|
|
898
1155
|
dispatchTimeoutS,
|
|
1156
|
+
usageLimitMaxWaitS,
|
|
1157
|
+
usageLimitMaxReprobes,
|
|
899
1158
|
serviceUrl,
|
|
900
1159
|
runId: effectiveRunId,
|
|
1160
|
+
expectBeads,
|
|
1161
|
+
skipRegression: Boolean(values['skip-regression']),
|
|
1162
|
+
// ciGate: values['ci-gate'], -- not wired (apra-fleet-dv8i)
|
|
901
1163
|
}),
|
|
902
1164
|
// apra-fleet-eft.75.1: wires this already-connected mcpClient
|
|
903
1165
|
// through to runner.js's createMemberSessionGuard (see its doc
|
|
@@ -952,6 +1214,22 @@ async function main() {
|
|
|
952
1214
|
|
|
953
1215
|
function isMainModule() {
|
|
954
1216
|
try {
|
|
1217
|
+
// Never self-execute when this module is loaded as a test file under a
|
|
1218
|
+
// Node test runner. `node --test <file>` sets NODE_TEST_CONTEXT in the
|
|
1219
|
+
// process that evaluates the file AND leaves process.argv[1] pointing at
|
|
1220
|
+
// that file, so the URL comparison below would otherwise treat the test
|
|
1221
|
+
// load as a direct CLI run and fire main() for real. The Phase-4
|
|
1222
|
+
// move-only probe (scripts/phase4-moveonly-probe.mjs) does exactly this:
|
|
1223
|
+
// it copies cli.mjs to a sibling `.phase4probe-cli.mjs` and runs
|
|
1224
|
+
// `node --test` on it, so without this guard main() runs, exits 1 on the
|
|
1225
|
+
// missing required flags, and the CURRENT revision fails to corroborate
|
|
1226
|
+
// as an ANCHOR_DESYNC -- turning the move-only gate red. NODE_TEST_CONTEXT
|
|
1227
|
+
// is stripped from the probe's spawn env, but `node --test` re-injects it
|
|
1228
|
+
// into the file's own process, so it is a reliable "loaded as a test"
|
|
1229
|
+
// signal. A production CLI launch (node bin/cli.mjs ...) and the workflow
|
|
1230
|
+
// import trampoline (src/cli/workflow.ts, which is not a node --test run)
|
|
1231
|
+
// never have it set, so both keep self-executing.
|
|
1232
|
+
if (process.env.NODE_TEST_CONTEXT) return false;
|
|
955
1233
|
if (process.argv[1] === undefined) return false;
|
|
956
1234
|
const invokedUrl = pathToFileURL(process.argv[1]).href;
|
|
957
1235
|
const moduleUrl = import.meta.url;
|