@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,539 @@
|
|
|
1
|
+
// Coordination clients for fleet-sprint: the supervisor-owned global dolt
|
|
2
|
+
// push mutex, the global child-id allocator, and the fleet server's own
|
|
3
|
+
// per-member reservation ledger (apra-fleet-3swo.4.3). Moved verbatim out of
|
|
4
|
+
// runner.js -- runner.js re-exports every symbol it previously exported from
|
|
5
|
+
// this region, so existing importers of fleet-sprint/runner.js resolve
|
|
6
|
+
// unchanged.
|
|
7
|
+
//
|
|
8
|
+
// Every client here speaks a coordination surface that is EXTERNAL to this
|
|
9
|
+
// process (a supervisor HTTP route, the fleet MCP server's own tools, or
|
|
10
|
+
// both) and is implemented INLINE rather than imported from its
|
|
11
|
+
// server-side counterpart, because runner.js (and this module alongside it)
|
|
12
|
+
// is copied verbatim next to the shipped bundle and loaded via
|
|
13
|
+
// engine.executeFile(), never bundled -- a cross-package relative import
|
|
14
|
+
// would not resolve in the shipped layout.
|
|
15
|
+
//
|
|
16
|
+
// `sprintId`/`sprint_id` on every client here is the SAME opaque sprint-
|
|
17
|
+
// identity token (derived in runner.js from the sprint's branch name, see
|
|
18
|
+
// sprintMutexId) -- it is passed through verbatim by every client below,
|
|
19
|
+
// never re-derived, reformatted, prefixed or namespaced, so a dispatch and
|
|
20
|
+
// the reservation/mutex/allocator calls that gate it always agree on who
|
|
21
|
+
// "this sprint" is.
|
|
22
|
+
|
|
23
|
+
import { resultText } from './mcp-result.mjs';
|
|
24
|
+
import { MemberReservationResumeError } from './errors.mjs';
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Child-side HTTP client for the supervisor-owned global dolt push mutex
|
|
28
|
+
* (src/supervisor/dolt-mutex.mjs). The mutex object lives in the always-on
|
|
29
|
+
* supervisor process, but each detached sprint child runs in its OWN process
|
|
30
|
+
* and can only reach it over HTTP. Speaks the routes
|
|
31
|
+
* registerDoltMutexRoutes() exposes:
|
|
32
|
+
*
|
|
33
|
+
* POST {serviceUrl}/api/dolt-push-mutex/{sprintId}/acquire body { pid }
|
|
34
|
+
* POST {serviceUrl}/api/dolt-push-mutex/{sprintId}/release body { token }
|
|
35
|
+
*
|
|
36
|
+
* The acquire route long-polls -- it does not answer until this sprint
|
|
37
|
+
* genuinely owns the mutex (FIFO after every earlier waiter) -- so a resolved
|
|
38
|
+
* acquire() means this child holds it and no sibling sprint is pushing.
|
|
39
|
+
*
|
|
40
|
+
* Implemented INLINE rather than imported from src/supervisor/dolt-mutex.mjs
|
|
41
|
+
* because runner.js is copied verbatim next to the bundle and loaded via
|
|
42
|
+
* engine.executeFile(), never bundled -- a cross-package relative import would
|
|
43
|
+
* not resolve in the shipped layout. The { acquire, release } surface is
|
|
44
|
+
* exactly what doltPushAfter() calls.
|
|
45
|
+
*
|
|
46
|
+
* @param {{ serviceUrl: string, sprintId: string, fetch?: typeof fetch, log?: Function }} opts
|
|
47
|
+
* @returns {{ acquire: (sprintId: string, o?: { pid?: number|null }) => Promise<{ token: string|null }>, release: (token: string|null) => Promise<boolean> }}
|
|
48
|
+
*/
|
|
49
|
+
export function createHttpDoltPushMutexClient(opts = {}) {
|
|
50
|
+
const base = String(opts.serviceUrl || '').replace(/\/+$/, '');
|
|
51
|
+
if (!base) throw new Error('createHttpDoltPushMutexClient requires a serviceUrl');
|
|
52
|
+
const boundSprintId = opts.sprintId;
|
|
53
|
+
const fetchImpl = opts.fetch ?? globalThis.fetch;
|
|
54
|
+
if (typeof fetchImpl !== 'function') {
|
|
55
|
+
throw new Error('createHttpDoltPushMutexClient requires a fetch implementation (Node >=18 global fetch or an injected one)');
|
|
56
|
+
}
|
|
57
|
+
const log = opts.log ?? (() => {});
|
|
58
|
+
const routeFor = (sprintId, action) =>
|
|
59
|
+
`${base}/api/dolt-push-mutex/${encodeURIComponent(sprintId)}/${action}`;
|
|
60
|
+
|
|
61
|
+
async function postJson(url, body) {
|
|
62
|
+
const res = await fetchImpl(url, {
|
|
63
|
+
method: 'POST',
|
|
64
|
+
headers: { 'content-type': 'application/json' },
|
|
65
|
+
body: JSON.stringify(body ?? {}),
|
|
66
|
+
});
|
|
67
|
+
if (!res || !res.ok) {
|
|
68
|
+
const status = res ? res.status : 'no-response';
|
|
69
|
+
throw new Error(`[dolt-mutex] ${url} returned HTTP ${status}`);
|
|
70
|
+
}
|
|
71
|
+
return res.json();
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
return {
|
|
75
|
+
async acquire(sprintId, o = {}) {
|
|
76
|
+
const id = sprintId || boundSprintId;
|
|
77
|
+
if (!id) throw new Error('[dolt-mutex] acquire requires a sprintId');
|
|
78
|
+
const payload = await postJson(routeFor(id, 'acquire'), { pid: o.pid ?? null });
|
|
79
|
+
return { token: payload.token ?? null, sprintId: payload.sprintId, expiresAt: payload.expiresAt };
|
|
80
|
+
},
|
|
81
|
+
async release(token) {
|
|
82
|
+
if (token == null) return true;
|
|
83
|
+
const id = boundSprintId;
|
|
84
|
+
if (!id) throw new Error('[dolt-mutex] release requires a bound sprintId');
|
|
85
|
+
try {
|
|
86
|
+
const payload = await postJson(routeFor(id, 'release'), { token });
|
|
87
|
+
return Boolean(payload.released);
|
|
88
|
+
} catch (err) {
|
|
89
|
+
// Non-fatal: the holder's lease expiry will reclaim the mutex
|
|
90
|
+
// even if this release never lands. Surface it for diagnostics.
|
|
91
|
+
log(`[dolt-mutex] release failed (non-fatal; lease will expire): ${err.message}`);
|
|
92
|
+
return false;
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
// Lease renewal (docs/dolt-sync-redesign.md Part 3.4): doltPushAfter()
|
|
96
|
+
// renews on an interval while it holds the mutex, so a legitimately
|
|
97
|
+
// long hold (push + reconcile + settle) is never force-evicted by the
|
|
98
|
+
// supervisor's 60s lease expiry while this sprint is still pushing.
|
|
99
|
+
async renew(token) {
|
|
100
|
+
if (token == null) return false;
|
|
101
|
+
const id = boundSprintId;
|
|
102
|
+
if (!id) throw new Error('[dolt-mutex] renew requires a bound sprintId');
|
|
103
|
+
try {
|
|
104
|
+
const payload = await postJson(routeFor(id, 'renew'), { token });
|
|
105
|
+
return Boolean(payload.renewed);
|
|
106
|
+
} catch (err) {
|
|
107
|
+
log(`[dolt-mutex] renew failed (non-fatal; the lease may expire): ${err.message}`);
|
|
108
|
+
return false;
|
|
109
|
+
}
|
|
110
|
+
},
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* Child-side HTTP client for the supervisor-owned global child-id allocator
|
|
116
|
+
* (src/supervisor/id-allocator.mjs), used by the orchestrator's bead-creation
|
|
117
|
+
* path. Without a single minting authority, two sprints that each `bd create
|
|
118
|
+
* --parent X` in their own dolt clone independently derive the SAME next child
|
|
119
|
+
* id and their D-pushes hard-conflict; with it, each creator gets an EXPLICIT
|
|
120
|
+
* distinct id passed to `bd create --id <childId>`, so the creates target
|
|
121
|
+
* different rows. Speaks the routes registerIdAllocatorRoutes() exposes:
|
|
122
|
+
*
|
|
123
|
+
* POST {serviceUrl}/api/child-id-allocator/{parentId}/allocate body { pid, sprintId, floor }
|
|
124
|
+
* POST {serviceUrl}/api/child-id-allocator/confirm body { token }
|
|
125
|
+
* POST {serviceUrl}/api/child-id-allocator/release body { token }
|
|
126
|
+
*
|
|
127
|
+
* Implemented INLINE for the same shipped-layout reason as the dolt push mutex
|
|
128
|
+
* client above. The { allocate, confirm, release } surface is exactly what the
|
|
129
|
+
* bead-creation path calls.
|
|
130
|
+
*
|
|
131
|
+
* @param {{ serviceUrl: string, sprintId?: string, fetch?: typeof fetch, log?: Function }} opts
|
|
132
|
+
* @returns {{ allocate: Function, confirm: Function, release: Function }}
|
|
133
|
+
*/
|
|
134
|
+
export function createHttpChildIdAllocatorClient(opts = {}) {
|
|
135
|
+
const base = String(opts.serviceUrl || '').replace(/\/+$/, '');
|
|
136
|
+
if (!base) throw new Error('createHttpChildIdAllocatorClient requires a serviceUrl');
|
|
137
|
+
const boundSprintId = opts.sprintId;
|
|
138
|
+
const fetchImpl = opts.fetch ?? globalThis.fetch;
|
|
139
|
+
if (typeof fetchImpl !== 'function') {
|
|
140
|
+
throw new Error('createHttpChildIdAllocatorClient requires a fetch implementation (Node >=18 global fetch or an injected one)');
|
|
141
|
+
}
|
|
142
|
+
const log = opts.log ?? (() => {});
|
|
143
|
+
|
|
144
|
+
async function postJson(url, body) {
|
|
145
|
+
const res = await fetchImpl(url, {
|
|
146
|
+
method: 'POST',
|
|
147
|
+
headers: { 'content-type': 'application/json' },
|
|
148
|
+
body: JSON.stringify(body ?? {}),
|
|
149
|
+
});
|
|
150
|
+
if (!res || !res.ok) {
|
|
151
|
+
const status = res ? res.status : 'no-response';
|
|
152
|
+
throw new Error(`[id-allocator] ${url} returned HTTP ${status}`);
|
|
153
|
+
}
|
|
154
|
+
return res.json();
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
return {
|
|
158
|
+
async allocate(parentId, o = {}) {
|
|
159
|
+
if (!parentId) throw new Error('[id-allocator] allocate requires a parentId');
|
|
160
|
+
const url = `${base}/api/child-id-allocator/${encodeURIComponent(parentId)}/allocate`;
|
|
161
|
+
const payload = await postJson(url, {
|
|
162
|
+
pid: o.pid ?? null,
|
|
163
|
+
sprintId: o.sprintId ?? boundSprintId ?? null,
|
|
164
|
+
floor: o.floor,
|
|
165
|
+
});
|
|
166
|
+
return { childId: payload.childId ?? null, seq: payload.seq, token: payload.token ?? null, expiresAt: payload.expiresAt };
|
|
167
|
+
},
|
|
168
|
+
async confirm(token) {
|
|
169
|
+
if (token == null) return true;
|
|
170
|
+
try {
|
|
171
|
+
const payload = await postJson(`${base}/api/child-id-allocator/confirm`, { token });
|
|
172
|
+
return Boolean(payload.confirmed);
|
|
173
|
+
} catch (err) {
|
|
174
|
+
// Non-fatal: the reservation's lease expiry reclaims it even if
|
|
175
|
+
// this confirm never lands. Surface it for diagnostics.
|
|
176
|
+
log(`[id-allocator] confirm failed (non-fatal; lease will expire): ${err.message}`);
|
|
177
|
+
return false;
|
|
178
|
+
}
|
|
179
|
+
},
|
|
180
|
+
async release(token) {
|
|
181
|
+
if (token == null) return true;
|
|
182
|
+
try {
|
|
183
|
+
const payload = await postJson(`${base}/api/child-id-allocator/release`, { token });
|
|
184
|
+
return Boolean(payload.released);
|
|
185
|
+
} catch (err) {
|
|
186
|
+
log(`[id-allocator] release failed (non-fatal; lease will expire): ${err.message}`);
|
|
187
|
+
return false;
|
|
188
|
+
}
|
|
189
|
+
},
|
|
190
|
+
};
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/**
|
|
194
|
+
* Shared MCP tool-result-to-JSON parser for the two fleet-MCP-hosted
|
|
195
|
+
* coordination clients below. Tool handlers return a JSON STRING wrapped in
|
|
196
|
+
* the standard content[] envelope, so both clients need the same
|
|
197
|
+
* extract-then-parse step.
|
|
198
|
+
* @param {any} result
|
|
199
|
+
* @param {string} label
|
|
200
|
+
* @returns {object}
|
|
201
|
+
*/
|
|
202
|
+
function parseCoordinationToolResult(result, label) {
|
|
203
|
+
let text = result;
|
|
204
|
+
if (typeof text !== 'string') {
|
|
205
|
+
text = (result && Array.isArray(result.content) && result.content[0] && typeof result.content[0].text === 'string')
|
|
206
|
+
? result.content[0].text
|
|
207
|
+
: '';
|
|
208
|
+
}
|
|
209
|
+
let payload;
|
|
210
|
+
try {
|
|
211
|
+
payload = JSON.parse(text);
|
|
212
|
+
} catch {
|
|
213
|
+
throw new Error(`${label} returned a non-JSON response: ${String(text).slice(0, 200) || '(empty)'}`);
|
|
214
|
+
}
|
|
215
|
+
if (payload && payload.error) throw new Error(`${label} error: ${payload.error}`);
|
|
216
|
+
return payload ?? {};
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* MCP-transport counterpart to createHttpDoltPushMutexClient above, for the
|
|
221
|
+
* SUPERVISOR-LESS topology: a standalone/detached-binary CLI launch has no
|
|
222
|
+
* supervisor to reach, so `--service-url` is absent and the HTTP client cannot
|
|
223
|
+
* be built, but the launcher always holds a connected MCP client to the shared
|
|
224
|
+
* fleet HTTP singleton, making the fleet server's own `dolt_push_mutex` tool
|
|
225
|
+
* (src/tools/dolt-push-mutex.ts) the reachable coordination point.
|
|
226
|
+
*
|
|
227
|
+
* Ticketed acquire, not long-poll: an MCP tool call cannot block indefinitely,
|
|
228
|
+
* so `acquire` waits a bounded slice per call and then RE-POLLS the same
|
|
229
|
+
* ticket. The server keeps the waiter enqueued across polls, preserving FIFO
|
|
230
|
+
* order (a cancel-and-retry loop would send every timed-out waiter to the back
|
|
231
|
+
* of the queue). The caller's real pid is threaded through so a crashed holder
|
|
232
|
+
* is reclaimed by the server's dead-pid probe rather than wedging the mutex.
|
|
233
|
+
*
|
|
234
|
+
* Implemented INLINE for the same shipped-layout reason as the HTTP clients
|
|
235
|
+
* above.
|
|
236
|
+
*
|
|
237
|
+
* @param {{ callTool: (name: string, args: object) => Promise<any>, sprintId?: string, waitMs?: number, timeoutMs?: number, log?: Function }} opts
|
|
238
|
+
* @returns {{ acquire: Function, release: Function }}
|
|
239
|
+
*/
|
|
240
|
+
export function createMcpDoltPushMutexClient(opts = {}) {
|
|
241
|
+
const { callTool, sprintId: boundSprintId, log = () => {} } = opts;
|
|
242
|
+
if (typeof callTool !== 'function') throw new Error('createMcpDoltPushMutexClient requires a callTool function');
|
|
243
|
+
const waitMs = Number.isFinite(opts.waitMs) && opts.waitMs > 0 ? opts.waitMs : 5000;
|
|
244
|
+
// Overall ceiling on how long a single acquire may keep re-polling before
|
|
245
|
+
// giving up (a wedged peer is bounded by the server-side lease anyway).
|
|
246
|
+
const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : 15 * 60 * 1000;
|
|
247
|
+
|
|
248
|
+
async function call(args) {
|
|
249
|
+
return parseCoordinationToolResult(await callTool('dolt_push_mutex', args), '[dolt-mutex/mcp]');
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
return {
|
|
253
|
+
async acquire(sprintId, o = {}) {
|
|
254
|
+
const id = sprintId || boundSprintId;
|
|
255
|
+
if (!id) throw new Error('[dolt-mutex/mcp] acquire requires a sprintId');
|
|
256
|
+
const deadline = Date.now() + timeoutMs;
|
|
257
|
+
let payload = await call({ action: 'acquire', sprint_id: id, pid: o.pid ?? undefined, wait_ms: waitMs });
|
|
258
|
+
while (!payload.granted) {
|
|
259
|
+
if (Date.now() >= deadline) {
|
|
260
|
+
try { await call({ action: 'cancel', ticket: payload.ticket }); } catch { /* best effort */ }
|
|
261
|
+
throw new Error(`[dolt-mutex/mcp] timed out after ${timeoutMs} ms waiting for the push mutex (sprint '${id}')`);
|
|
262
|
+
}
|
|
263
|
+
log(`[dolt-mutex/mcp] waiting for the global push mutex (sprint '${id}', ticket ${payload.ticket})`);
|
|
264
|
+
payload = await call({ action: 'poll', ticket: payload.ticket, wait_ms: waitMs });
|
|
265
|
+
}
|
|
266
|
+
return { token: payload.token ?? null, sprintId: id, expiresAt: payload.expiresAt };
|
|
267
|
+
},
|
|
268
|
+
async release(token) {
|
|
269
|
+
if (token == null) return true;
|
|
270
|
+
try {
|
|
271
|
+
const payload = await call({ action: 'release', token });
|
|
272
|
+
return Boolean(payload.released);
|
|
273
|
+
} catch (err) {
|
|
274
|
+
// Non-fatal: the holder's lease expiry reclaims the mutex even
|
|
275
|
+
// if this release never lands (same posture as the HTTP client).
|
|
276
|
+
log(`[dolt-mutex/mcp] release failed (non-fatal; lease will expire): ${err.message}`);
|
|
277
|
+
return false;
|
|
278
|
+
}
|
|
279
|
+
},
|
|
280
|
+
// Same lease-renewal contract as the HTTP client above (design doc
|
|
281
|
+
// Part 3.4); the fleet tool exposes action 'renew'.
|
|
282
|
+
async renew(token) {
|
|
283
|
+
if (token == null) return false;
|
|
284
|
+
try {
|
|
285
|
+
const payload = await call({ action: 'renew', token });
|
|
286
|
+
return Boolean(payload.renewed);
|
|
287
|
+
} catch (err) {
|
|
288
|
+
log(`[dolt-mutex/mcp] renew failed (non-fatal; the lease may expire): ${err.message}`);
|
|
289
|
+
return false;
|
|
290
|
+
}
|
|
291
|
+
},
|
|
292
|
+
};
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
/**
|
|
296
|
+
* MCP-transport counterpart to createHttpChildIdAllocatorClient above, for the
|
|
297
|
+
* SUPERVISOR-LESS topology. Speaks the fleet server's own
|
|
298
|
+
* `child_id_allocator` tool (src/tools/child-id-allocator.ts); same rationale,
|
|
299
|
+
* same inline-implementation constraint, and the same { allocate, confirm,
|
|
300
|
+
* release } surface the bead-creation path already calls.
|
|
301
|
+
*
|
|
302
|
+
* @param {{ callTool: (name: string, args: object) => Promise<any>, sprintId?: string, log?: Function }} opts
|
|
303
|
+
* @returns {{ allocate: Function, confirm: Function, release: Function }}
|
|
304
|
+
*/
|
|
305
|
+
export function createMcpChildIdAllocatorClient(opts = {}) {
|
|
306
|
+
const { callTool, sprintId: boundSprintId, log = () => {} } = opts;
|
|
307
|
+
if (typeof callTool !== 'function') throw new Error('createMcpChildIdAllocatorClient requires a callTool function');
|
|
308
|
+
|
|
309
|
+
async function call(args) {
|
|
310
|
+
return parseCoordinationToolResult(await callTool('child_id_allocator', args), '[id-allocator/mcp]');
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
return {
|
|
314
|
+
async allocate(parentId, o = {}) {
|
|
315
|
+
if (!parentId) throw new Error('[id-allocator/mcp] allocate requires a parentId');
|
|
316
|
+
const payload = await call({
|
|
317
|
+
action: 'allocate',
|
|
318
|
+
parent_id: parentId,
|
|
319
|
+
pid: o.pid ?? undefined,
|
|
320
|
+
sprint_id: o.sprintId ?? boundSprintId ?? undefined,
|
|
321
|
+
floor: o.floor,
|
|
322
|
+
});
|
|
323
|
+
return { childId: payload.childId ?? null, seq: payload.seq, token: payload.token ?? null, expiresAt: payload.expiresAt };
|
|
324
|
+
},
|
|
325
|
+
async confirm(token) {
|
|
326
|
+
if (token == null) return true;
|
|
327
|
+
try {
|
|
328
|
+
const payload = await call({ action: 'confirm', token });
|
|
329
|
+
return Boolean(payload.confirmed);
|
|
330
|
+
} catch (err) {
|
|
331
|
+
log(`[id-allocator/mcp] confirm failed (non-fatal; lease will expire): ${err.message}`);
|
|
332
|
+
return false;
|
|
333
|
+
}
|
|
334
|
+
},
|
|
335
|
+
async release(token) {
|
|
336
|
+
if (token == null) return true;
|
|
337
|
+
try {
|
|
338
|
+
const payload = await call({ action: 'release', token });
|
|
339
|
+
return Boolean(payload.released);
|
|
340
|
+
} catch (err) {
|
|
341
|
+
log(`[id-allocator/mcp] release failed (non-fatal; lease will expire): ${err.message}`);
|
|
342
|
+
return false;
|
|
343
|
+
}
|
|
344
|
+
},
|
|
345
|
+
};
|
|
346
|
+
}
|
|
347
|
+
|
|
348
|
+
/**
|
|
349
|
+
* Reserves and releases every sprint member against the fleet server's OWN
|
|
350
|
+
* per-member reservation record (the `member_reservation` tool), so that a
|
|
351
|
+
* sprint launched directly from the CLI -- never routed through the
|
|
352
|
+
* supervisor, and so absent from its ledger -- is still visible to
|
|
353
|
+
* execute_prompt's dispatch-time reservedBy check and to the supervisor's
|
|
354
|
+
* overlap guard.
|
|
355
|
+
*
|
|
356
|
+
* `callTool` is injected (the caller's MCP client) so this stays
|
|
357
|
+
* transport-agnostic and unit-testable without a live fleet server.
|
|
358
|
+
* Deliberately NOT built on the supervisor's HTTP routes, unlike the
|
|
359
|
+
* dolt-mutex/id-allocator clients above: `member_reservation` lives on the
|
|
360
|
+
* fleet MCP server every launch path already connects to, whereas the
|
|
361
|
+
* supervisor is optional and unwired for direct CLI launches.
|
|
362
|
+
*
|
|
363
|
+
* `sprintId` should be the SAME opaque identity used for the dolt push mutex
|
|
364
|
+
* and child-id allocator -- opaque and target-agnostic, with no assumption
|
|
365
|
+
* about which repo the sprint develops.
|
|
366
|
+
*
|
|
367
|
+
* Reserve/release are BEST-EFFORT per member: a failure (transport error, or
|
|
368
|
+
* the tool's own "already reserved by X" rejection) is logged and does NOT
|
|
369
|
+
* throw. That is safe because execute_prompt independently rejects any
|
|
370
|
+
* dispatch to a member this sprint failed to reserve, so an unreserved member
|
|
371
|
+
* fails loudly at its first dispatch rather than silently interleaving with
|
|
372
|
+
* another sprint.
|
|
373
|
+
*
|
|
374
|
+
* @param {{ callTool: (name: string, args: object) => Promise<any>, members?: string[], sprintId?: string, log?: Function }} opts
|
|
375
|
+
* @returns {{ reserveAll: () => Promise<void>, releaseAll: () => Promise<void> }}
|
|
376
|
+
*/
|
|
377
|
+
// (apra-fleet-3swo.7.5) Classify a `member_reservation` result from its
|
|
378
|
+
// STRUCTURED half, not from its prose.
|
|
379
|
+
//
|
|
380
|
+
// The tool used to be readable only as text, and callFor() below discriminated
|
|
381
|
+
// a rejection by the leading '[-]' marker src/tools/member-reservation.ts
|
|
382
|
+
// prefixes onto its failure summaries. That coupled a load-bearing control-flow
|
|
383
|
+
// decision -- "did this sprint actually get the member?", which reReserveForResume
|
|
384
|
+
// turns into a hard resume failure -- to a human-facing wording detail, exactly
|
|
385
|
+
// the class of dependency that silently inverted once the provisioning tools
|
|
386
|
+
// retired their own status prefixes.
|
|
387
|
+
//
|
|
388
|
+
// member_reservation now returns `structuredContent.{ ok, outcome }`
|
|
389
|
+
// (MemberReservationFields / MemberReservationOutcome in
|
|
390
|
+
// src/tools/member-reservation.ts, mirrored by MemberReservationStructured in
|
|
391
|
+
// packages/apra-fleet-client/src/client/api.mjs), where `ok` already folds in
|
|
392
|
+
// the server's own authoritative list of failing outcomes
|
|
393
|
+
// (already_reserved_by_other, invalid_input, member_not_found, failed). Read
|
|
394
|
+
// THAT when present.
|
|
395
|
+
//
|
|
396
|
+
// The legacy prose/isError heuristic is kept ONLY for a result that carries no
|
|
397
|
+
// structuredContent at all -- a test double that mocks the bare string or
|
|
398
|
+
// `{ content }` shape. This mirrors provisionOutcome() in vcs-auth.mjs
|
|
399
|
+
// field-for-field so the two coordination surfaces cannot drift on what
|
|
400
|
+
// "the server said no" means. `outcome` is null on that fallback path,
|
|
401
|
+
// because there is no structured discriminator to report.
|
|
402
|
+
/**
|
|
403
|
+
* @param {unknown} result an MCP tool result from member_reservation
|
|
404
|
+
* @param {string} text the same result rendered as text, for the fallback only
|
|
405
|
+
* @returns {{ ok: boolean, outcome: string|null }}
|
|
406
|
+
*/
|
|
407
|
+
function reservationOutcome(result, text) {
|
|
408
|
+
const structured = result && result.structuredContent;
|
|
409
|
+
if (structured && typeof structured.ok === 'boolean') {
|
|
410
|
+
return { ok: structured.ok, outcome: typeof structured.outcome === 'string' ? structured.outcome : null };
|
|
411
|
+
}
|
|
412
|
+
return {
|
|
413
|
+
ok: !((result && result.isError) || String(text == null ? '' : text).startsWith('[-]')),
|
|
414
|
+
outcome: null,
|
|
415
|
+
};
|
|
416
|
+
}
|
|
417
|
+
|
|
418
|
+
export function createMemberReservationClient(opts = {}) {
|
|
419
|
+
const { callTool, members = [], sprintId, log = () => {} } = opts;
|
|
420
|
+
const active = typeof callTool === 'function' && typeof sprintId === 'string' && sprintId.length > 0 && members.length > 0;
|
|
421
|
+
|
|
422
|
+
// Returns { ok, text } rather than throwing so BOTH the best-effort callers
|
|
423
|
+
// (reserveAll/releaseAll, which ignore the outcome) and the owner-checked
|
|
424
|
+
// resume caller (reReserveForResume, which MUST know per-member whether the
|
|
425
|
+
// reserve was granted or rejected) can share one call path. `ok` is false
|
|
426
|
+
// on a tool rejection ("already reserved by X") OR a transport throw; the
|
|
427
|
+
// caller decides what a failure means for its own contract.
|
|
428
|
+
async function callFor(action, member) {
|
|
429
|
+
try {
|
|
430
|
+
const result = await callTool('member_reservation', { member_name: member, action, sprint_id: sprintId });
|
|
431
|
+
const text = resultText(result);
|
|
432
|
+
const { ok, outcome } = reservationOutcome(result, text);
|
|
433
|
+
if (!ok) {
|
|
434
|
+
log(`[member-reservation] ${action} rejected for member '${member}'${outcome ? ` (${outcome})` : ''}: ${text || '(no detail)'}`);
|
|
435
|
+
return { ok: false, text, outcome };
|
|
436
|
+
}
|
|
437
|
+
return { ok: true, text, outcome };
|
|
438
|
+
} catch (err) {
|
|
439
|
+
log(`[member-reservation] ${action} failed for member '${member}' (non-fatal; execute_prompt's dispatch-time reservedBy check still applies): ${err.message}`);
|
|
440
|
+
return { ok: false, text: err.message };
|
|
441
|
+
}
|
|
442
|
+
}
|
|
443
|
+
|
|
444
|
+
async function releaseAll() {
|
|
445
|
+
if (!active) return;
|
|
446
|
+
for (const member of members) await callFor('release', member);
|
|
447
|
+
}
|
|
448
|
+
|
|
449
|
+
return {
|
|
450
|
+
async reserveAll() {
|
|
451
|
+
if (!active) return;
|
|
452
|
+
for (const member of members) await callFor('reserve', member);
|
|
453
|
+
},
|
|
454
|
+
releaseAll,
|
|
455
|
+
|
|
456
|
+
// Launch reserve, run BEFORE launch alignment moves any member (stash +
|
|
457
|
+
// branch switch). Unlike reserveAll() it reports the members another
|
|
458
|
+
// sprint already holds (outcome already_reserved_by_other), so the
|
|
459
|
+
// caller can refuse the launch before touching them; when any is held,
|
|
460
|
+
// the members this call did reserve are handed back. A transport throw
|
|
461
|
+
// or any other rejection stays best-effort, exactly as in reserveAll()
|
|
462
|
+
// (execute_prompt's dispatch-time reservedBy check still applies).
|
|
463
|
+
// @returns {Promise<{ held: string[] }>}
|
|
464
|
+
async reserveForLaunch() {
|
|
465
|
+
if (!active) return { held: [] };
|
|
466
|
+
const reserved = [];
|
|
467
|
+
const held = [];
|
|
468
|
+
for (const member of members) {
|
|
469
|
+
const res = await callFor('reserve', member);
|
|
470
|
+
if (res.ok) reserved.push(member);
|
|
471
|
+
else if (res.outcome === 'already_reserved_by_other') held.push(member);
|
|
472
|
+
}
|
|
473
|
+
if (held.length > 0) {
|
|
474
|
+
for (const member of reserved) await callFor('release', member);
|
|
475
|
+
}
|
|
476
|
+
return { held };
|
|
477
|
+
},
|
|
478
|
+
|
|
479
|
+
// (apra-fleet-p2to.4.2) Pause hand-back: release EVERY member so a
|
|
480
|
+
// different sprint may claim it while this one is parked at a
|
|
481
|
+
// cooperative pause. Best-effort per member, exactly like releaseAll()
|
|
482
|
+
// -- a pause must never fail on a release hiccup, and execute_prompt's
|
|
483
|
+
// dispatch-time reservedBy check still fails loudly on any member this
|
|
484
|
+
// sprint later dispatches to without holding.
|
|
485
|
+
//
|
|
486
|
+
// (apra-fleet-p2to.4.4.1) releaseForPause() is intentionally the SAME
|
|
487
|
+
// operation as releaseAll() -- both release every member,
|
|
488
|
+
// best-effort, with no distinct behavior of their own -- so this
|
|
489
|
+
// calls straight through to releaseAll() rather than keeping a
|
|
490
|
+
// byte-identical second copy of the loop to drift out of sync. The
|
|
491
|
+
// two names stay separate call sites (not aliased) because they mean
|
|
492
|
+
// different things to a caller even though today they do the same
|
|
493
|
+
// work: this is intended to change independently if a pause hand-back
|
|
494
|
+
// ever needs behavior releaseAll() should not have (e.g. skipping a
|
|
495
|
+
// member expected back imminently).
|
|
496
|
+
releaseForPause: releaseAll,
|
|
497
|
+
|
|
498
|
+
// (apra-fleet-p2to.4.2) Resume re-acquire, OWNER-CHECKED: re-reserve
|
|
499
|
+
// every member released at pause. A member is "unavailable" when its
|
|
500
|
+
// reserve is rejected -- another sprint claimed it while we were paused,
|
|
501
|
+
// so it is no longer ours. We refuse to silently continue on top of a
|
|
502
|
+
// member some other sprint now owns: collect every unavailable member
|
|
503
|
+
// and, if any, fail the resume with a single clean error that NAMES
|
|
504
|
+
// them (MemberReservationResumeError) so the operator knows exactly what
|
|
505
|
+
// to free before retrying the resume.
|
|
506
|
+
//
|
|
507
|
+
// Every successfully re-acquired member then runs `resyncMember` (git
|
|
508
|
+
// fetch + decideEnsureBranchAction probe + bd dolt pull) UNCONDITIONALLY
|
|
509
|
+
// before any work continues -- while paused, origin and the beads DB can
|
|
510
|
+
// have moved (another sprint, a human push), so the re-sync is never
|
|
511
|
+
// gated on a "looks unchanged" heuristic.
|
|
512
|
+
//
|
|
513
|
+
// @param {{ resyncMember?: (member: string) => Promise<void> }} [opts]
|
|
514
|
+
// @returns {Promise<{ reacquired: string[] }>}
|
|
515
|
+
async reReserveForResume({ resyncMember } = {}) {
|
|
516
|
+
if (!active) return { reacquired: [] };
|
|
517
|
+
const reacquired = [];
|
|
518
|
+
const unavailable = [];
|
|
519
|
+
for (const member of members) {
|
|
520
|
+
const res = await callFor('reserve', member);
|
|
521
|
+
if (res.ok) reacquired.push(member);
|
|
522
|
+
else unavailable.push(member);
|
|
523
|
+
}
|
|
524
|
+
if (unavailable.length > 0) {
|
|
525
|
+
// Hand back the ones we DID re-grab so a failed resume does not
|
|
526
|
+
// leave this sprint holding a partial, unusable reservation set
|
|
527
|
+
// that blocks the very members another operator may need to free
|
|
528
|
+
// up the unavailable ones. Best-effort -- the resume is failing
|
|
529
|
+
// regardless.
|
|
530
|
+
for (const member of reacquired) await callFor('release', member);
|
|
531
|
+
throw new MemberReservationResumeError(unavailable);
|
|
532
|
+
}
|
|
533
|
+
if (typeof resyncMember === 'function') {
|
|
534
|
+
for (const member of reacquired) await resyncMember(member);
|
|
535
|
+
}
|
|
536
|
+
return { reacquired };
|
|
537
|
+
},
|
|
538
|
+
};
|
|
539
|
+
}
|