@apralabs/apra-fleet 0.4.3 → 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 +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- 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/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 +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- 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 +24 -1
- package/dist/cli/config.js +69 -2
- 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 +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- 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.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- 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 +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- 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 +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- 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 +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- 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 +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- 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-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- 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/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 +54 -8
- 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/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 +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- 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 +229 -38
- 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 +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- 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 +86 -17
- 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 +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- 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 +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- 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 +53 -5
- package/dist/tools/check-status.js +210 -53
- 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 +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- 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 +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- 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 +169 -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 +30 -10
- 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 +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- 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 +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- 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/shutdown-server.js +5 -0
- 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 +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -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 +106 -20
- 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 +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- 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/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/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- 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/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 +3 -3
- 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 +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- 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 +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -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 +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- 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 +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- 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/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.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/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.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-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.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/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.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/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.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/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.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/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.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,263 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- restart reconciliation + force-release endpoint
|
|
3
|
+
// (apra-fleet-eft.5.4, Plan Part 2.2)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// Two flows that turn a reservation into a durable terminal event:
|
|
7
|
+
//
|
|
8
|
+
// 1. Restart reconciliation (pairs with eft.4.5 re-adoption). On supervisor
|
|
9
|
+
// restart the ledger is reloaded from disk, but the children it recorded
|
|
10
|
+
// may or may not still be alive. We PID-probe each entry:
|
|
11
|
+
// * a DEAD child releases BOTH axes in ONE atomic write (ledger.release
|
|
12
|
+
// deletes the whole entry -- members AND issueRoots together, never a
|
|
13
|
+
// torn half-release) and its sprint is marked `aborted-by-restart` in
|
|
14
|
+
// the history log;
|
|
15
|
+
// * a LIVE child keeps both axes reserved -- eft.4.5 re-adopts it.
|
|
16
|
+
// An entry with no recorded childPid cannot be probed and so is treated as
|
|
17
|
+
// not-alive: there is no live process to re-adopt, so holding its
|
|
18
|
+
// reservation forever would wedge the scope.
|
|
19
|
+
//
|
|
20
|
+
// 2. Force-release (POST /api/reservations/:sprintId/force-release) for a
|
|
21
|
+
// wedged reservation an operator needs to tear down by hand. It releases
|
|
22
|
+
// BOTH axes and records who/why in history. An unknown sprint id 404s.
|
|
23
|
+
//
|
|
24
|
+
// Both flows go through the SAME ledger.release() (one atomic both-axis write)
|
|
25
|
+
// and the SAME history log, so the audit trail is uniform.
|
|
26
|
+
//
|
|
27
|
+
// apra-fleet-3i3.1: force-release now ALSO kills the reservation's still-live
|
|
28
|
+
// child (if any) via the injected `killPid` collaborator, in the SAME action
|
|
29
|
+
// -- previously an operator had to separately hunt down and kill a wedged
|
|
30
|
+
// child by hand after force-releasing its reservation. `killPid` defaults to
|
|
31
|
+
// a SAFE NO-OP (kills nothing, always returns false): sending a real
|
|
32
|
+
// destructive signal to an arbitrary pid must never be something a caller
|
|
33
|
+
// gets by omission. Only bin/serve.mjs's production wiring injects the real
|
|
34
|
+
// `killPid` export below (`process.kill(pid, 'SIGKILL')`, guarded), scoped to
|
|
35
|
+
// pids the eft.4.2 spawner actually tracks. Every existing/other test that
|
|
36
|
+
// constructs createReconciler({ ledger, history }) without injecting killPid
|
|
37
|
+
// therefore never sends a real signal, even when a seeded reservation happens
|
|
38
|
+
// to carry a low/system-adjacent childPid.
|
|
39
|
+
//
|
|
40
|
+
// apra-fleet-3i3.3: forceRelease()'s return now ALSO echoes the released
|
|
41
|
+
// entry's branch/base/goal (in addition to the members/issueRoots history.
|
|
42
|
+
// record() already echoed) -- release() deletes the whole ledger entry, so
|
|
43
|
+
// this is the last point they are readable. The Sprint Stack's new Restart
|
|
44
|
+
// control (dashboard.mjs) is a client-side, two-step flow: it calls THIS
|
|
45
|
+
// same force-release route first, then POSTs the SAME branch/base/goal/
|
|
46
|
+
// members/issueRoots straight back to POST /api/sprints to relaunch, without
|
|
47
|
+
// a dedicated server-side "restart" endpoint or any new plumbing here. Purely
|
|
48
|
+
// additive to forceRelease()'s existing return shape -- every pre-existing
|
|
49
|
+
// caller that ignores the new fields is unaffected.
|
|
50
|
+
// =============================================================================
|
|
51
|
+
|
|
52
|
+
import { readJsonBody, sendJson } from './server.mjs';
|
|
53
|
+
import { HISTORY_EVENTS } from './history.mjs';
|
|
54
|
+
import { withTimestamps } from './log-timestamp.mjs';
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Default liveness probe: signal 0 tests for the process's existence without
|
|
58
|
+
* actually delivering a signal. ESRCH => the pid is gone (dead). EPERM => the
|
|
59
|
+
* process exists but we may not signal it (still ALIVE). Any other error is
|
|
60
|
+
* treated conservatively as not-alive.
|
|
61
|
+
* @param {number} pid
|
|
62
|
+
* @returns {boolean}
|
|
63
|
+
*/
|
|
64
|
+
export function isPidAlive(pid) {
|
|
65
|
+
if (!Number.isInteger(pid) || pid <= 0) return false;
|
|
66
|
+
try {
|
|
67
|
+
process.kill(pid, 0);
|
|
68
|
+
return true;
|
|
69
|
+
} catch (err) {
|
|
70
|
+
if (err && err.code === 'EPERM') return true;
|
|
71
|
+
return false;
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Real kill-signal implementation: sends `signal` (default SIGKILL, an
|
|
77
|
+
* immediate hard kill -- distinct from the existing cooperative
|
|
78
|
+
* POST /api/sprints/:id/stop proxy, which asks the child's own /stop
|
|
79
|
+
* endpoint to shut down gracefully) to `pid`. ESRCH (already gone) is
|
|
80
|
+
* treated as success -- the goal ("make sure this pid is not running") is
|
|
81
|
+
* already satisfied. Any other failure (e.g. EPERM) returns false rather
|
|
82
|
+
* than throwing, so a kill failure never blocks the reservation release
|
|
83
|
+
* that follows it in forceRelease() below.
|
|
84
|
+
*
|
|
85
|
+
* NOT wired as createReconciler()'s default -- see the module doc above for
|
|
86
|
+
* why an accidental real kill must never happen by omission. Only
|
|
87
|
+
* bin/serve.mjs's production wiring imports and injects this explicitly.
|
|
88
|
+
* @param {number} pid
|
|
89
|
+
* @param {NodeJS.Signals} [signal]
|
|
90
|
+
* @returns {boolean}
|
|
91
|
+
*/
|
|
92
|
+
export function killPid(pid, signal = 'SIGKILL') {
|
|
93
|
+
if (!Number.isInteger(pid) || pid <= 0) return false;
|
|
94
|
+
try {
|
|
95
|
+
process.kill(pid, signal);
|
|
96
|
+
return true;
|
|
97
|
+
} catch (err) {
|
|
98
|
+
if (err && err.code === 'ESRCH') return true;
|
|
99
|
+
return false;
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** Error thrown when a force-release targets a sprint with no live reservation. */
|
|
104
|
+
export class SprintNotFoundError extends Error {
|
|
105
|
+
constructor(sprintId) {
|
|
106
|
+
super(`no live reservation for sprint '${sprintId}'`);
|
|
107
|
+
this.name = 'SprintNotFoundError';
|
|
108
|
+
this.code = 'SPRINT_NOT_FOUND';
|
|
109
|
+
this.sprintId = sprintId;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* Create the restart-reconciler / force-release controller.
|
|
115
|
+
*
|
|
116
|
+
* @param {{
|
|
117
|
+
* ledger: {
|
|
118
|
+
* list: () => Array<{ sprintId: string, members: string[], issueRoots: string[], childPid: number|null }>,
|
|
119
|
+
* get: (sprintId: string) => object|undefined,
|
|
120
|
+
* release: (sprintId: string) => Promise<boolean>,
|
|
121
|
+
* },
|
|
122
|
+
* history: { record: (entry: object) => Promise<object> },
|
|
123
|
+
* isPidAlive?: (pid: number) => boolean,
|
|
124
|
+
* killPid?: (pid: number) => boolean,
|
|
125
|
+
* now?: () => string,
|
|
126
|
+
* logger?: { log?: Function, error?: Function },
|
|
127
|
+
* }} deps
|
|
128
|
+
*/
|
|
129
|
+
export function createReconciler(deps = {}) {
|
|
130
|
+
const ledger = deps.ledger;
|
|
131
|
+
const history = deps.history;
|
|
132
|
+
if (!ledger || typeof ledger.list !== 'function' || typeof ledger.release !== 'function') {
|
|
133
|
+
throw new TypeError('createReconciler requires a ledger with list()/get()/release()');
|
|
134
|
+
}
|
|
135
|
+
if (!history || typeof history.record !== 'function') {
|
|
136
|
+
throw new TypeError('createReconciler requires a history with record()');
|
|
137
|
+
}
|
|
138
|
+
const probe = deps.isPidAlive ?? isPidAlive;
|
|
139
|
+
// apra-fleet-3i3.1: safe no-op default -- see killPid()'s and the module
|
|
140
|
+
// doc's explanation of why a real kill must be an explicit opt-in, never
|
|
141
|
+
// an accidental default.
|
|
142
|
+
const kill = deps.killPid ?? (() => false);
|
|
143
|
+
const now = deps.now ?? (() => new Date().toISOString());
|
|
144
|
+
// apra-fleet-k7b.2: ISO-timestamp-prefix every log line from this module.
|
|
145
|
+
const logger = withTimestamps(deps.logger ?? console);
|
|
146
|
+
const log = (...a) => logger.log?.(...a);
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* PID-probe every reloaded ledger entry once, at supervisor restart. Dead
|
|
150
|
+
* children release both axes and are marked aborted-by-restart; live
|
|
151
|
+
* children are retained for eft.4.5 re-adoption.
|
|
152
|
+
* @returns {Promise<{ released: string[], retained: string[] }>}
|
|
153
|
+
*/
|
|
154
|
+
async function reconcile() {
|
|
155
|
+
// Snapshot first: ledger.list() returns clones, so releasing during the
|
|
156
|
+
// loop cannot disturb iteration.
|
|
157
|
+
const entries = ledger.list();
|
|
158
|
+
const released = [];
|
|
159
|
+
const retained = [];
|
|
160
|
+
for (const entry of entries) {
|
|
161
|
+
const alive = entry.childPid != null && probe(entry.childPid);
|
|
162
|
+
if (alive) {
|
|
163
|
+
retained.push(entry.sprintId);
|
|
164
|
+
continue;
|
|
165
|
+
}
|
|
166
|
+
// Dead (or unprobeable) child: release BOTH axes in one atomic write.
|
|
167
|
+
// eslint-disable-next-line no-await-in-loop -- releases must be serialized through the ledger's single-writer transaction chain.
|
|
168
|
+
await ledger.release(entry.sprintId);
|
|
169
|
+
// eslint-disable-next-line no-await-in-loop
|
|
170
|
+
await history.record({
|
|
171
|
+
sprintId: entry.sprintId,
|
|
172
|
+
event: HISTORY_EVENTS.ABORTED_BY_RESTART,
|
|
173
|
+
reason: entry.childPid == null
|
|
174
|
+
? 'no recorded child pid at supervisor restart'
|
|
175
|
+
: `child pid ${entry.childPid} not alive at supervisor restart`,
|
|
176
|
+
members: entry.members,
|
|
177
|
+
issueRoots: entry.issueRoots,
|
|
178
|
+
at: now(),
|
|
179
|
+
});
|
|
180
|
+
released.push(entry.sprintId);
|
|
181
|
+
}
|
|
182
|
+
log(`[reconcile] restart: released ${released.length} dead, retained ${retained.length} live`);
|
|
183
|
+
return { released, retained };
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
/**
|
|
187
|
+
* Operator force-release of a wedged reservation. apra-fleet-3i3.1: ALSO
|
|
188
|
+
* kills the reservation's still-live child (if any, via the injected
|
|
189
|
+
* `killPid`) in the SAME action, before releasing both axes and
|
|
190
|
+
* recording an audit reason -- a kill failure (or no recorded childPid at
|
|
191
|
+
* all) never blocks the release that follows it. Throws
|
|
192
|
+
* SprintNotFoundError for an unknown sprint.
|
|
193
|
+
* @param {string} sprintId
|
|
194
|
+
* @param {{ by?: string, reason?: string }} [audit]
|
|
195
|
+
* @returns {Promise<object>} the recorded history event, plus `childPid`,
|
|
196
|
+
* `killed` (whether the kill signal was believed to land; null when
|
|
197
|
+
* there was no recorded childPid to kill), and (apra-fleet-3i3.3) the
|
|
198
|
+
* released entry's `branch`/`base`/`goal` (each `null` when the entry
|
|
199
|
+
* never persisted it -- a pre-3i3.2 legacy entry, or an omitted `goal`)
|
|
200
|
+
*/
|
|
201
|
+
async function forceRelease(sprintId, audit = {}) {
|
|
202
|
+
if (typeof sprintId !== 'string' || sprintId.length === 0) {
|
|
203
|
+
throw new TypeError('forceRelease requires a non-empty sprintId');
|
|
204
|
+
}
|
|
205
|
+
const entry = ledger.get(sprintId);
|
|
206
|
+
if (!entry) {
|
|
207
|
+
throw new SprintNotFoundError(sprintId);
|
|
208
|
+
}
|
|
209
|
+
const childPid = entry.childPid ?? null;
|
|
210
|
+
const killed = childPid != null ? kill(childPid) : null;
|
|
211
|
+
// apra-fleet-3i3.3: capture BEFORE release() below deletes the whole
|
|
212
|
+
// entry -- this is the last point these are readable from the ledger.
|
|
213
|
+
const branch = entry.branch ?? null;
|
|
214
|
+
const base = entry.base ?? null;
|
|
215
|
+
const goal = entry.goal ?? null;
|
|
216
|
+
await ledger.release(sprintId);
|
|
217
|
+
const recorded = await history.record({
|
|
218
|
+
sprintId,
|
|
219
|
+
event: HISTORY_EVENTS.FORCE_RELEASED,
|
|
220
|
+
reason: audit.reason ?? 'force-released by operator',
|
|
221
|
+
by: audit.by ?? null,
|
|
222
|
+
members: entry.members,
|
|
223
|
+
issueRoots: entry.issueRoots,
|
|
224
|
+
at: now(),
|
|
225
|
+
});
|
|
226
|
+
return { ...recorded, childPid, killed, branch, base, goal };
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
return {
|
|
230
|
+
name: 'reconciler',
|
|
231
|
+
reconcile,
|
|
232
|
+
forceRelease,
|
|
233
|
+
};
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
/**
|
|
237
|
+
* Register the force-release HTTP route against a supervisor (server.mjs).
|
|
238
|
+
* The path carries the sprint id as a `:sprintId` param, matched by the
|
|
239
|
+
* supervisor's pattern-route support.
|
|
240
|
+
*
|
|
241
|
+
* @param {{ route: (method: string, path: string, handler: Function) => void }} supervisor
|
|
242
|
+
* @param {{ forceRelease: (sprintId: string, audit: object) => Promise<object> }} reconciler
|
|
243
|
+
*/
|
|
244
|
+
export function registerReservationRoutes(supervisor, reconciler) {
|
|
245
|
+
supervisor.route('POST', '/api/reservations/:sprintId/force-release', async (req, res, ctx) => {
|
|
246
|
+
const sprintId = ctx?.params?.sprintId;
|
|
247
|
+
if (!sprintId) {
|
|
248
|
+
sendJson(res, 400, { error: 'missing sprintId in path' });
|
|
249
|
+
return;
|
|
250
|
+
}
|
|
251
|
+
const body = (await readJsonBody(req)) ?? {};
|
|
252
|
+
try {
|
|
253
|
+
const audit = await reconciler.forceRelease(sprintId, { by: body.by, reason: body.reason });
|
|
254
|
+
sendJson(res, 200, { status: 'force-released', sprintId, audit });
|
|
255
|
+
} catch (err) {
|
|
256
|
+
if (err && err.code === 'SPRINT_NOT_FOUND') {
|
|
257
|
+
sendJson(res, 404, { error: err.message });
|
|
258
|
+
return;
|
|
259
|
+
}
|
|
260
|
+
throw err;
|
|
261
|
+
}
|
|
262
|
+
});
|
|
263
|
+
}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- bounded EPERM/EBUSY retry around an atomic
|
|
3
|
+
// tmp-write-then-rename replace (apra-fleet-ed4.1)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// history.mjs's and ledger.mjs's persist() both write to a `.tmp` file then
|
|
7
|
+
// fs.rename() it over the real file -- the same atomic-replace primitive, so
|
|
8
|
+
// a torn/partial write is never visible to a concurrent reader. On Windows,
|
|
9
|
+
// that fs.rename() step can fail with EPERM/EBUSY when the destination file
|
|
10
|
+
// is momentarily locked/open by another process (e.g. an AV scanner, a
|
|
11
|
+
// concurrent reader mid-open) -- a TRANSIENT, self-clearing condition, not a
|
|
12
|
+
// real failure. Without a retry this silently drops whatever persist() was
|
|
13
|
+
// writing (observed live 2026-08-01 on a watchdog history.record(
|
|
14
|
+
// AUTO_RELEASED) -- a durable audit event vanished with no error surfaced
|
|
15
|
+
// anywhere).
|
|
16
|
+
//
|
|
17
|
+
// This module is the single shared retry loop both persist() call sites use,
|
|
18
|
+
// so the bounded-retry discipline (and its "what counts as retryable" rule)
|
|
19
|
+
// lives in exactly one place instead of being duplicated.
|
|
20
|
+
// =============================================================================
|
|
21
|
+
|
|
22
|
+
/** Default max attempts (the first try, plus up to this many-1 retries). */
|
|
23
|
+
export const RENAME_RETRY_DEFAULT_MAX_ATTEMPTS = 5;
|
|
24
|
+
|
|
25
|
+
/** Default base backoff (ms) -- escalates linearly per attempt (attempt * base). */
|
|
26
|
+
export const RENAME_RETRY_DEFAULT_BASE_DELAY_MS = 10;
|
|
27
|
+
|
|
28
|
+
function defaultSleep(ms) {
|
|
29
|
+
return new Promise((resolve) => { setTimeout(resolve, ms); });
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Bounded EPERM/EBUSY retry around `fs.rename(tmpPath, destPath)`.
|
|
34
|
+
*
|
|
35
|
+
* Retries ONLY when `err.code === 'EPERM' || err.code === 'EBUSY'` (the
|
|
36
|
+
* transient Windows-locking symptom) -- any other error (e.g. ENOENT, a
|
|
37
|
+
* permanent EACCES) re-throws immediately on the FIRST attempt, since a
|
|
38
|
+
* bounded retry loop must never mask a genuinely different failure as "just
|
|
39
|
+
* needs another try".
|
|
40
|
+
*
|
|
41
|
+
* Bounded: after `maxAttempts` total attempts (default 5, escalating ~10ms
|
|
42
|
+
* backoff per attempt) a still-failing rename re-throws the LAST error it
|
|
43
|
+
* saw, so a genuinely stuck rename still surfaces -- this never retries
|
|
44
|
+
* forever.
|
|
45
|
+
*
|
|
46
|
+
* On POSIX, or on any platform where the very first `fs.rename()` call
|
|
47
|
+
* succeeds, this makes EXACTLY ONE rename call -- byte-identical behavior to
|
|
48
|
+
* a bare `await fs.rename(tmpPath, destPath)`, so callers that never hit
|
|
49
|
+
* EPERM/EBUSY see no change at all.
|
|
50
|
+
*
|
|
51
|
+
* @param {{ rename: (src: string, dst: string) => Promise<void> }} fs an
|
|
52
|
+
* injectable fs-like collaborator (matching history.mjs's/ledger.mjs's own
|
|
53
|
+
* injected `deps.fs` convention) exposing an async `rename()`.
|
|
54
|
+
* @param {string} tmpPath
|
|
55
|
+
* @param {string} destPath
|
|
56
|
+
* @param {{
|
|
57
|
+
* maxAttempts?: number,
|
|
58
|
+
* baseDelayMs?: number,
|
|
59
|
+
* sleep?: (ms: number) => Promise<void>,
|
|
60
|
+
* }} [opts] Injectable so a test can drive a fake clock/sleep with no real
|
|
61
|
+
* timers -- `sleep` defaults to a real `setTimeout`-backed delay.
|
|
62
|
+
* @returns {Promise<void>}
|
|
63
|
+
*/
|
|
64
|
+
export async function renameWithRetry(fs, tmpPath, destPath, opts = {}) {
|
|
65
|
+
const maxAttempts = Number.isInteger(opts.maxAttempts) && opts.maxAttempts > 0
|
|
66
|
+
? opts.maxAttempts
|
|
67
|
+
: RENAME_RETRY_DEFAULT_MAX_ATTEMPTS;
|
|
68
|
+
const baseDelayMs = Number.isInteger(opts.baseDelayMs) && opts.baseDelayMs >= 0
|
|
69
|
+
? opts.baseDelayMs
|
|
70
|
+
: RENAME_RETRY_DEFAULT_BASE_DELAY_MS;
|
|
71
|
+
const sleep = typeof opts.sleep === 'function' ? opts.sleep : defaultSleep;
|
|
72
|
+
|
|
73
|
+
let attempt = 0;
|
|
74
|
+
for (;;) {
|
|
75
|
+
attempt += 1;
|
|
76
|
+
try {
|
|
77
|
+
// eslint-disable-next-line no-await-in-loop
|
|
78
|
+
await fs.rename(tmpPath, destPath);
|
|
79
|
+
return;
|
|
80
|
+
} catch (err) {
|
|
81
|
+
const retryable = Boolean(err) && (err.code === 'EPERM' || err.code === 'EBUSY');
|
|
82
|
+
if (!retryable || attempt >= maxAttempts) throw err;
|
|
83
|
+
// eslint-disable-next-line no-await-in-loop
|
|
84
|
+
await sleep(baseDelayMs * attempt);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
}
|
|
@@ -0,0 +1,327 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- issue-scope overlap guard via live-expanded subtree
|
|
3
|
+
// recomputation (apra-fleet-eft.5.3, Plan Part 2.2)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// The reservation ledger (src/supervisor/ledger.mjs) stores each live sprint's
|
|
7
|
+
// issue-scope IDENTITY: the root issue id(s) it launched with (`issueRoots`).
|
|
8
|
+
// It deliberately does NOT store a frozen list of every descendant, because
|
|
9
|
+
// planners and reviewers GROW a sprint's subtree mid-run (they add tasks/tests
|
|
10
|
+
// under an already-claimed root). A launch-time snapshot of "everything under
|
|
11
|
+
// root R" would therefore go stale the instant a new child is created, letting
|
|
12
|
+
// a second sprint claim that brand-new child without detecting the overlap.
|
|
13
|
+
//
|
|
14
|
+
// So overlap is checked by RE-EXPANDING subtrees LIVE at every launch attempt:
|
|
15
|
+
//
|
|
16
|
+
// * For the incoming request, expand its root(s) to the full live subtree.
|
|
17
|
+
// * For every active sprint in the ledger, expand ITS root(s) to the full
|
|
18
|
+
// live subtree, right now -- never a launch-time snapshot.
|
|
19
|
+
// * Intersect. Any nonzero intersection rejects the ENTIRE launch, naming the
|
|
20
|
+
// conflicting sprint and the overlapping bead ids.
|
|
21
|
+
//
|
|
22
|
+
// There is deliberately NO partial-launch / carve-out path: we do not launch a
|
|
23
|
+
// sprint over "its scope minus the already-claimed beads". That would require
|
|
24
|
+
// an exclude-set threaded through the runner core loop and is explicitly
|
|
25
|
+
// deferred. Overlap is all-or-nothing: any conflict fails the whole launch.
|
|
26
|
+
//
|
|
27
|
+
// Subtree expansion historically reused the runner.js `bdListScoped`
|
|
28
|
+
// discipline (fleet-sprint/runner.js ~1360): `bd list --parent <id>` accepts
|
|
29
|
+
// EXACTLY ONE id per invocation (a comma-joined `--parent a,b` is silently
|
|
30
|
+
// treated as one nonexistent id and returns []), and is ALSO single-level
|
|
31
|
+
// only (it returns direct children, never grandchildren). That meant one `bd`
|
|
32
|
+
// subprocess spawn PER DISCOVERED NODE in every checkLaunch() call -- N
|
|
33
|
+
// spawns for an N-bead ledger+request tree, every launch attempt.
|
|
34
|
+
//
|
|
35
|
+
// apra-fleet-72o0: the production path now does ONE bulk fetch per
|
|
36
|
+
// checkLaunch() call (`bd list --all --limit 0 --json`, see
|
|
37
|
+
// `bdListAllBeadsWithClosed()` below) and builds the parent-child index / BFS
|
|
38
|
+
// expansion IN-MEMORY off that single result, reusing backlog.mjs's
|
|
39
|
+
// `buildChildIndex()` / `expandScopeInMemory()` (apra-fleet-c4s) -- the SAME
|
|
40
|
+
// technique the dashboard Backlog tab already uses to avoid a per-node `bd`
|
|
41
|
+
// subprocess walk on every render. `--all` matters here specifically: `bd
|
|
42
|
+
// list` hides closed issues by default, so a CLOSED intermediate parent would
|
|
43
|
+
// silently orphan its OPEN subtree from this check without it -- two sprints
|
|
44
|
+
// with genuinely overlapping open work could otherwise both launch. This is a
|
|
45
|
+
// correctness fix, not just a speed one (backlog.mjs's own
|
|
46
|
+
// `bdListAllBeadsRaw()` omits `--all`; that is a separate, already-known bug
|
|
47
|
+
// there, deliberately NOT touched by this change).
|
|
48
|
+
//
|
|
49
|
+
// The old per-node async `expandScope()`/`bdListChildren()` pair is KEPT as
|
|
50
|
+
// the test seam: `createScopeGuard({ listChildren })` still drives the exact
|
|
51
|
+
// same per-root, single-id-per-call `bd list --parent <id>` BFS when a caller
|
|
52
|
+
// explicitly injects `listChildren` (existing tests and callers that want a
|
|
53
|
+
// stubbed child-lister without a bulk-fetch fixture) -- never a comma-joined
|
|
54
|
+
// `--parent`, never a single call expected to return a whole subtree.
|
|
55
|
+
//
|
|
56
|
+
// KNOWN HOLE (surfaced, not hidden): a `blocks` edge that crosses two disjoint
|
|
57
|
+
// claimed scopes is NOT detected here. This guard reasons purely about the
|
|
58
|
+
// parent-child grouping subtree of each root; cross-scope ordering edges are
|
|
59
|
+
// out of scope for this reservation check.
|
|
60
|
+
// =============================================================================
|
|
61
|
+
|
|
62
|
+
import { validateIssueId } from '../../fleet-sprint/runner.js';
|
|
63
|
+
import { execBdAsync } from './lib/exec-bd.mjs';
|
|
64
|
+
import { normalizeBead, buildChildIndex, expandScopeInMemory } from './backlog.mjs';
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Default `listChildren`: return the DIRECT child bead ids of a single parent
|
|
68
|
+
* id via `bd list --parent <id> --json`. One id per call -- never a
|
|
69
|
+
* comma-joined multi-parent query (bd silently treats that as one nonexistent
|
|
70
|
+
* id and returns []). Single-level only by design; the BFS in expandScope()
|
|
71
|
+
* walks it to full depth.
|
|
72
|
+
* @param {string} parentId
|
|
73
|
+
* @returns {Promise<string[]>}
|
|
74
|
+
*/
|
|
75
|
+
export async function bdListChildren(parentId) {
|
|
76
|
+
// Routed through the shared execBdAsync() helper (apra-fleet-xuo.2), which
|
|
77
|
+
// resolves the platform `bd` command directly (`bd.cmd` on win32) instead
|
|
78
|
+
// of shelling out via `{ shell: true }` -- so no shell is invoked at all,
|
|
79
|
+
// and no shell metacharacter in `parentId` can reach one. validateIssueId()
|
|
80
|
+
// below is kept as defense in depth (letters/digits/'.'/'_'/'-' -only
|
|
81
|
+
// charset, same as the launch API boundary's runner.js ISSUE_ID_PATTERN)
|
|
82
|
+
// in case some future caller forgets to validate upstream.
|
|
83
|
+
validateIssueId(parentId);
|
|
84
|
+
const { stdout } = await execBdAsync(['list', '--parent', parentId, '--json', '--limit', '0']);
|
|
85
|
+
const text = stdout && stdout.trim() ? stdout : '[]';
|
|
86
|
+
let rows;
|
|
87
|
+
try {
|
|
88
|
+
rows = JSON.parse(text);
|
|
89
|
+
} catch (err) {
|
|
90
|
+
throw new Error(`[scope-overlap] failed to parse 'bd list --parent ${parentId} --json': ${err.message}`);
|
|
91
|
+
}
|
|
92
|
+
if (!Array.isArray(rows)) return [];
|
|
93
|
+
return rows
|
|
94
|
+
.map((b) => (b && typeof b.id === 'string' ? b.id : null))
|
|
95
|
+
.filter((id) => id !== null);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Expand a set of root issue ids into the full live parent-child subtree they
|
|
100
|
+
* span (roots INCLUDED). Each node is queried at most once via `listChildren`,
|
|
101
|
+
* one id per call, and the frontier is walked breadth-first so grandchildren
|
|
102
|
+
* (and deeper) are reached even though `bd list --parent` is single-level.
|
|
103
|
+
*
|
|
104
|
+
* The roots themselves are part of the scope: two sprints launched with the
|
|
105
|
+
* same root, or a request rooted at a bead already inside an active scope, must
|
|
106
|
+
* both surface that shared id.
|
|
107
|
+
*
|
|
108
|
+
* @param {Iterable<string>} roots
|
|
109
|
+
* @param {(parentId: string) => Promise<string[]>} listChildren
|
|
110
|
+
* @returns {Promise<Set<string>>} every bead id in the live subtree, roots included
|
|
111
|
+
*/
|
|
112
|
+
export async function expandScope(roots, listChildren) {
|
|
113
|
+
const scope = new Set();
|
|
114
|
+
const frontier = [];
|
|
115
|
+
for (const r of roots) {
|
|
116
|
+
if (typeof r === 'string' && r.length > 0 && !scope.has(r)) {
|
|
117
|
+
scope.add(r);
|
|
118
|
+
frontier.push(r);
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
while (frontier.length > 0) {
|
|
122
|
+
const id = frontier.shift();
|
|
123
|
+
// eslint-disable-next-line no-await-in-loop -- BFS must query each node one --parent id at a time (bd rejects comma-joined multi-parent).
|
|
124
|
+
const children = await listChildren(id);
|
|
125
|
+
for (const child of children) {
|
|
126
|
+
if (typeof child === 'string' && child.length > 0 && !scope.has(child)) {
|
|
127
|
+
scope.add(child);
|
|
128
|
+
frontier.push(child);
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
return scope;
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* Default `listAllBeads` for the bulk path (apra-fleet-72o0): every bead,
|
|
137
|
+
* OPEN AND CLOSED, in one call -- `bd list --all --limit 0 --json`.
|
|
138
|
+
* Deliberately its own small fetcher (not a reuse of backlog.mjs's
|
|
139
|
+
* `bdListAllBeadsRaw()`) because that helper omits `--all` -- a separate,
|
|
140
|
+
* already-known bug there this change must not copy or silently "fix" as a
|
|
141
|
+
* side effect. `--all` is required HERE: a CLOSED intermediate parent must
|
|
142
|
+
* still surface its OPEN descendants to the overlap check, or that subtree
|
|
143
|
+
* silently falls out of both the request's and an active sprint's live scope.
|
|
144
|
+
* @returns {Promise<object[]>} raw `bd list` rows, unnormalized
|
|
145
|
+
*/
|
|
146
|
+
export async function bdListAllBeadsWithClosed(options = {}) {
|
|
147
|
+
// Routed through the shared execBdAsync() helper (apra-fleet-xuo.2), same
|
|
148
|
+
// as bdListChildren() below and backlog.mjs's fetchAllBeadsRaw() -- no
|
|
149
|
+
// shell metacharacter risk, consistent cross-platform `bd` resolution.
|
|
150
|
+
// `options.cwd` (optional) pins WHICH .beads is listed; omitted, bd
|
|
151
|
+
// resolves from process.cwd() exactly as before. The supervisor's cached
|
|
152
|
+
// beads view passes its repoRoot so the list provably reads the same
|
|
153
|
+
// clone its backlog member pulls.
|
|
154
|
+
const execOptions = options && typeof options.cwd === 'string' && options.cwd.length > 0 ? { cwd: options.cwd } : {};
|
|
155
|
+
const { stdout } = await execBdAsync(['list', '--all', '--limit', '0', '--json'], execOptions);
|
|
156
|
+
const text = stdout && stdout.trim() ? stdout : '[]';
|
|
157
|
+
let rows;
|
|
158
|
+
try {
|
|
159
|
+
rows = JSON.parse(text);
|
|
160
|
+
} catch (err) {
|
|
161
|
+
throw new Error(`[scope-overlap] failed to parse 'bd list --all --json': ${err.message}`);
|
|
162
|
+
}
|
|
163
|
+
if (!Array.isArray(rows)) return [];
|
|
164
|
+
return rows.filter((b) => b && typeof b.id === 'string' && b.id.length > 0);
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* Human-readable rejection message naming every conflicting sprint and the
|
|
169
|
+
* overlapping bead ids, for surfacing to the launch caller / API response.
|
|
170
|
+
* @param {Array<{ sprintId: string, overlappingIds: string[] }>} conflicts
|
|
171
|
+
* @returns {string}
|
|
172
|
+
*/
|
|
173
|
+
export function formatScopeConflict(conflicts) {
|
|
174
|
+
const parts = conflicts.map(
|
|
175
|
+
(c) => `sprint '${c.sprintId}' already claims [${c.overlappingIds.join(', ')}]`,
|
|
176
|
+
);
|
|
177
|
+
return `issue-scope overlap rejects launch: ${parts.join('; ')}`;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* Create the issue-scope overlap guard. Collaborators are injected so tests can
|
|
182
|
+
* drive an in-memory ledger and a stub child-lister without a real `bd`.
|
|
183
|
+
*
|
|
184
|
+
* Two expansion paths, chosen once at construction (apra-fleet-72o0):
|
|
185
|
+
* - `deps.listChildren` supplied (explicit test seam): every expansion goes
|
|
186
|
+
* through the OLD per-node async BFS (`expandScope()` above) -- one
|
|
187
|
+
* `bd list --parent <id>`-shaped call per discovered node, exactly the
|
|
188
|
+
* pre-existing behavior existing tests/callers already rely on.
|
|
189
|
+
* - `deps.listChildren` omitted (the production default): `checkLaunch()`
|
|
190
|
+
* does ONE bulk `deps.listAllBeads()` fetch (default
|
|
191
|
+
* `bdListAllBeadsWithClosed()`, i.e. `bd list --all --limit 0 --json`) up
|
|
192
|
+
* front, builds a `buildChildIndex()` off it ONCE, and expands BOTH the
|
|
193
|
+
* request's roots and every ledger sprint's `issueRoots` from that same
|
|
194
|
+
* in-memory index via `expandScopeInMemory()` -- zero additional `bd`
|
|
195
|
+
* subprocess spawns per node. Mirrors backlog.mjs's `createBacklog()`
|
|
196
|
+
* `explicitExpand` seam (same shape, same reasoning: an injected
|
|
197
|
+
* collaborator overrides wholesale, the production default never calls
|
|
198
|
+
* the injected-only path).
|
|
199
|
+
*
|
|
200
|
+
* @param {{
|
|
201
|
+
* ledger: { list: () => Array<{ sprintId: string, issueRoots: string[] }> },
|
|
202
|
+
* listChildren?: (parentId: string) => Promise<string[]>,
|
|
203
|
+
* listAllBeads?: () => Promise<object[]>,
|
|
204
|
+
* logger?: { log?: Function, error?: Function },
|
|
205
|
+
* }} deps
|
|
206
|
+
*/
|
|
207
|
+
export function createScopeGuard(deps = {}) {
|
|
208
|
+
const ledger = deps.ledger;
|
|
209
|
+
if (!ledger || typeof ledger.list !== 'function') {
|
|
210
|
+
throw new TypeError('createScopeGuard requires a ledger with a list() method');
|
|
211
|
+
}
|
|
212
|
+
// Only set when a caller (test, or a future explicit-stub consumer)
|
|
213
|
+
// injects a child-lister wholesale -- the production default path below
|
|
214
|
+
// never calls it (apra-fleet-72o0: no per-node `bd` subprocess walk on
|
|
215
|
+
// every checkLaunch()).
|
|
216
|
+
const explicitListChildren = deps.listChildren ?? null;
|
|
217
|
+
const listAllBeads = deps.listAllBeads ?? bdListAllBeadsWithClosed;
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* Expand `roots` under the currently-selected path: the injected
|
|
221
|
+
* per-node lister if one was supplied at construction, else a fresh bulk
|
|
222
|
+
* fetch + in-memory BFS. Used by the guard's standalone `expandScope()`
|
|
223
|
+
* export below (called outside a `checkLaunch()` batch, so it cannot
|
|
224
|
+
* reuse a shared child index).
|
|
225
|
+
* @param {Iterable<string>} roots
|
|
226
|
+
* @returns {Promise<Set<string>>}
|
|
227
|
+
*/
|
|
228
|
+
async function expandScopeStandalone(roots) {
|
|
229
|
+
if (explicitListChildren) return expandScope(roots, explicitListChildren);
|
|
230
|
+
const rawBeads = await listAllBeads();
|
|
231
|
+
const beads = (Array.isArray(rawBeads) ? rawBeads : []).map(normalizeBead).filter((b) => b.id.length > 0);
|
|
232
|
+
return expandScopeInMemory(roots, buildChildIndex(beads));
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
/**
|
|
236
|
+
* Check whether launching a sprint with `requestRoots` would overlap any
|
|
237
|
+
* currently-active sprint's live-expanded issue subtree. Re-expands BOTH
|
|
238
|
+
* the request's and every active sprint's roots AT CALL TIME -- never a
|
|
239
|
+
* frozen snapshot -- so a bead created after an earlier launch, under an
|
|
240
|
+
* already-claimed root, is still detected.
|
|
241
|
+
*
|
|
242
|
+
* Any nonzero intersection with ANY active sprint rejects the ENTIRE
|
|
243
|
+
* launch (no partial/carve-out path). `conflicts` lists every offending
|
|
244
|
+
* sprint and the overlapping bead ids.
|
|
245
|
+
*
|
|
246
|
+
* @param {string[]} requestRoots - the incoming sprint's root issue id(s)
|
|
247
|
+
* @param {{ excludeSprintId?: string }} [opts] - ignore one sprint (e.g. a
|
|
248
|
+
* re-adoption / self-check that should not conflict with itself)
|
|
249
|
+
* @returns {Promise<{ ok: boolean, requestScope: string[], conflicts: Array<{ sprintId: string, overlappingIds: string[] }> }>}
|
|
250
|
+
*/
|
|
251
|
+
async function checkLaunch(requestRoots, opts = {}) {
|
|
252
|
+
const roots = Array.isArray(requestRoots) ? requestRoots : [];
|
|
253
|
+
if (roots.length === 0) {
|
|
254
|
+
throw new TypeError('checkLaunch requires a non-empty array of request root issue ids');
|
|
255
|
+
}
|
|
256
|
+
const excludeSprintId = opts.excludeSprintId;
|
|
257
|
+
|
|
258
|
+
// Validate the REQUEST's root ids before they are used (dolt sync
|
|
259
|
+
// budget review round 2, item 6). The old per-node path validated
|
|
260
|
+
// every root inside bdListChildren(); the bulk in-memory path never
|
|
261
|
+
// calls it, so a malformed root id silently expanded to just itself
|
|
262
|
+
// and was then reported as non-overlapping -- an invalid launch
|
|
263
|
+
// request accepted rather than rejected. This is a correctness/UX
|
|
264
|
+
// restoration, not an injection guard (the bulk fetch passes no root
|
|
265
|
+
// id to `bd` at all). Only the request's own roots are validated:
|
|
266
|
+
// ledger roots were validated when their sprint launched, and
|
|
267
|
+
// re-rejecting them here would turn one bad historical record into a
|
|
268
|
+
// hard failure of every subsequent launch.
|
|
269
|
+
if (!explicitListChildren) {
|
|
270
|
+
for (const root of roots) validateIssueId(root);
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
// Build the child index ONCE per checkLaunch() call (bulk path only)
|
|
274
|
+
// -- one `bd` subprocess spawn total, however many roots/ledger
|
|
275
|
+
// sprints there are to expand. The explicit-listChildren seam has no
|
|
276
|
+
// shared index; each expansion issues its own per-node calls, same
|
|
277
|
+
// as before apra-fleet-72o0.
|
|
278
|
+
let childIndex = null;
|
|
279
|
+
if (!explicitListChildren) {
|
|
280
|
+
const rawBeads = await listAllBeads();
|
|
281
|
+
const beads = (Array.isArray(rawBeads) ? rawBeads : []).map(normalizeBead).filter((b) => b.id.length > 0);
|
|
282
|
+
childIndex = buildChildIndex(beads);
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
const expand = (rs) => (explicitListChildren
|
|
286
|
+
? expandScope(rs, explicitListChildren)
|
|
287
|
+
: Promise.resolve(expandScopeInMemory(rs, childIndex)));
|
|
288
|
+
|
|
289
|
+
// Live-expand the incoming request's scope once.
|
|
290
|
+
const requestScope = await expand(roots);
|
|
291
|
+
|
|
292
|
+
const conflicts = [];
|
|
293
|
+
for (const reservation of ledger.list()) {
|
|
294
|
+
if (excludeSprintId !== undefined && reservation.sprintId === excludeSprintId) continue;
|
|
295
|
+
const resRoots = Array.isArray(reservation.issueRoots) ? reservation.issueRoots : [];
|
|
296
|
+
if (resRoots.length === 0) continue;
|
|
297
|
+
// Live-expand THIS active sprint's subtree right now, never a
|
|
298
|
+
// launch-time snapshot -- so mid-run subtree growth is seen. In
|
|
299
|
+
// the bulk path this reuses the SAME childIndex built above (no
|
|
300
|
+
// extra `bd` call); in the explicit-listChildren seam it issues
|
|
301
|
+
// its own per-node BFS, same as before.
|
|
302
|
+
// eslint-disable-next-line no-await-in-loop -- explicit-listChildren seam expands each active sprint's subtree independently; ledger sets are small. (Bulk path resolves synchronously, so this never actually awaits a pending promise.)
|
|
303
|
+
const activeScope = await expand(resRoots);
|
|
304
|
+
const overlappingIds = [];
|
|
305
|
+
for (const id of requestScope) {
|
|
306
|
+
if (activeScope.has(id)) overlappingIds.push(id);
|
|
307
|
+
}
|
|
308
|
+
if (overlappingIds.length > 0) {
|
|
309
|
+
overlappingIds.sort();
|
|
310
|
+
conflicts.push({ sprintId: reservation.sprintId, overlappingIds });
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
return {
|
|
315
|
+
ok: conflicts.length === 0,
|
|
316
|
+
requestScope: [...requestScope].sort(),
|
|
317
|
+
conflicts,
|
|
318
|
+
};
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
return {
|
|
322
|
+
name: 'scope-guard',
|
|
323
|
+
expandScope: (roots) => expandScopeStandalone(roots),
|
|
324
|
+
checkLaunch,
|
|
325
|
+
formatScopeConflict,
|
|
326
|
+
};
|
|
327
|
+
}
|