@apralabs/apra-fleet 0.4.3 → 0.4.5
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 +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- 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 +166 -5
- 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 +42 -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 +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- 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/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- 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 +62 -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 +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -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 +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- 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/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- 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 +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -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 +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -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 +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- 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 +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -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 +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -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 +115 -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 +352 -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 +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -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/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -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/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- 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 +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- 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/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- 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 +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -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 +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- 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 +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- 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 +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- 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 +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- 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 +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- 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/stop-prompt.js +3 -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 +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- 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 +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- 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/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- 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 +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- 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 +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- 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 +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -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-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -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 +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- 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 +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- 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-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- 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 +1896 -305
- 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 +454 -1
- 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 +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- 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 +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -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 +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -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 +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- 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/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- 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 +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -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 +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -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 +499 -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 +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.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/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,544 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- detached child-per-sprint spawner (apra-fleet-eft.4.2,
|
|
3
|
+
// Plan Part 2.1, process model B)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// Launches each sprint as the EXISTING `bin/cli.mjs` CLI (see its argv contract
|
|
7
|
+
// around buildOptionsSpec()/main(), ~line 100-420), as a fully detached, truly
|
|
8
|
+
// independently-surviving orphan:
|
|
9
|
+
//
|
|
10
|
+
// spawn(command, args, { detached: true, stdio: 'ignore' }) + child.unref()
|
|
11
|
+
//
|
|
12
|
+
// There is deliberately NO parent-child IPC channel and NO kill-on-parent-exit
|
|
13
|
+
// behavior wired here. On POSIX, `detached: true` gives the child its own
|
|
14
|
+
// process group/session, so:
|
|
15
|
+
//
|
|
16
|
+
// * killing the supervisor (even SIGKILL) leaves every already-launched
|
|
17
|
+
// child running -- this module never listens for or reacts to the
|
|
18
|
+
// supervisor's own exit;
|
|
19
|
+
// * a crashing/killed child never takes down a sibling child or the
|
|
20
|
+
// supervisor -- each child is spawned independently and this module only
|
|
21
|
+
// tracks its own local bookkeeping (freed on that child's 'exit'), it
|
|
22
|
+
// never propagates one child's failure to another.
|
|
23
|
+
//
|
|
24
|
+
// This module owns exactly one extra invariant beyond "spawn detached":
|
|
25
|
+
// **--viewer-port allocation is unique across every currently-live sprint**.
|
|
26
|
+
// The four-status watchdog (eft.4.3), restart re-adoption (eft.4.5), and the
|
|
27
|
+
// combined reservation ledger (eft.5, src/supervisor/ledger.mjs) are separate
|
|
28
|
+
// concerns and are NOT this module's job -- the ledger, notably, persists
|
|
29
|
+
// `childPid` for restart PID-probe reconciliation but does not persist ports,
|
|
30
|
+
// so live-port uniqueness is this module's own in-memory bookkeeping for as
|
|
31
|
+
// long as this supervisor process has been up.
|
|
32
|
+
// =============================================================================
|
|
33
|
+
|
|
34
|
+
import { spawn as nodeSpawn } from 'node:child_process';
|
|
35
|
+
import net from 'node:net';
|
|
36
|
+
import path from 'node:path';
|
|
37
|
+
import fs from 'node:fs';
|
|
38
|
+
import os from 'node:os';
|
|
39
|
+
import { createHash, randomUUID } from 'node:crypto';
|
|
40
|
+
import { fileURLToPath } from 'node:url';
|
|
41
|
+
|
|
42
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
43
|
+
const __dirname = path.dirname(__filename);
|
|
44
|
+
|
|
45
|
+
/** Default first port tried when allocating a fresh `--viewer-port`. */
|
|
46
|
+
export const DEFAULT_SPAWNER_BASE_PORT = 8081;
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* The default service data directory. Overridable via the FLEET_SE_DATA_DIR
|
|
50
|
+
* env var, otherwise `~/.apra-fleet-se`. Mirrors ledger.mjs's/history.mjs's
|
|
51
|
+
* own identically-named helper (each module keeps its own small copy rather
|
|
52
|
+
* than cross-importing one another -- the established convention in this
|
|
53
|
+
* package, see id-allocator.mjs's own copy too).
|
|
54
|
+
* @returns {string}
|
|
55
|
+
*/
|
|
56
|
+
export function defaultDataDir() {
|
|
57
|
+
return process.env.FLEET_SE_DATA_DIR
|
|
58
|
+
? path.resolve(process.env.FLEET_SE_DATA_DIR)
|
|
59
|
+
: path.join(os.homedir(), '.apra-fleet-se');
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** Max length of a sprint log file's stem (basename without '.log'), identical on every OS. */
|
|
63
|
+
export const MAX_LOG_STEM_LENGTH = 80;
|
|
64
|
+
const LOG_STEM_HASH_LENGTH = 12;
|
|
65
|
+
|
|
66
|
+
/** Subdirectory (under the SE data dir) that per-sprint raw stdout/stderr log files live in. */
|
|
67
|
+
export const SPRINT_LOG_SUBDIR = 'logs';
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* apra-fleet-ou7.1: builds the per-sprint raw stdout/stderr log file path
|
|
71
|
+
* (`<dataDir>/logs/<stem>.log`) a spawned child's stdio is teed to for its
|
|
72
|
+
* whole lifetime, including after a crash (spawnSprint() below opens this
|
|
73
|
+
* BEFORE spawning and hands the fd directly to the child, so a Node-level
|
|
74
|
+
* buffered stream is never in the way of capturing a crash's last output).
|
|
75
|
+
*
|
|
76
|
+
* `stem` is sanitized to the same shell/filesystem-safe character class
|
|
77
|
+
* fleet-sprint/runner.js's ISSUE_ID_PATTERN already uses for issue ids
|
|
78
|
+
* (letters, digits, '.', '_', '-') so a caller-supplied runId can never
|
|
79
|
+
* escape the logs directory (no '/', '\\', or '..' path-traversal) and never
|
|
80
|
+
* needs any extra shell quoting.
|
|
81
|
+
* @param {string} dataDir
|
|
82
|
+
* @param {string} stem - typically the sprint's runId; sanitized before use
|
|
83
|
+
* @returns {string}
|
|
84
|
+
*/
|
|
85
|
+
export function resolveSprintLogPath(dataDir, stem) {
|
|
86
|
+
let safeStem = String(stem ?? '').replace(/[^A-Za-z0-9._-]/g, '_');
|
|
87
|
+
// Bound the stem on EVERY OS (not just Windows) so the file name -- and
|
|
88
|
+
// so the full path under a long Windows-style dataDir -- never depends on
|
|
89
|
+
// how many issue ids a caller's runId happens to embed. An over-long stem
|
|
90
|
+
// keeps its head for readability and appends a hash of the WHOLE original
|
|
91
|
+
// stem, so two different long stems never collide.
|
|
92
|
+
if (safeStem.length > MAX_LOG_STEM_LENGTH) {
|
|
93
|
+
const digest = createHash('sha256').update(String(stem)).digest('hex').slice(0, LOG_STEM_HASH_LENGTH);
|
|
94
|
+
safeStem = `${safeStem.slice(0, MAX_LOG_STEM_LENGTH - LOG_STEM_HASH_LENGTH - 1)}-${digest}`;
|
|
95
|
+
}
|
|
96
|
+
const fileName = `${safeStem.length > 0 ? safeStem : 'sprint'}.log`;
|
|
97
|
+
// Defense in depth: even after sanitizing, refuse anything that is not
|
|
98
|
+
// a single plain filename (e.g. a sanitized-to-'..'-only stem).
|
|
99
|
+
if (fileName !== path.basename(fileName) || fileName === '.log') {
|
|
100
|
+
throw new Error(`[spawner] refusing to build an unsafe sprint log file name from stem '${stem}'`);
|
|
101
|
+
}
|
|
102
|
+
return path.join(dataDir, SPRINT_LOG_SUBDIR, fileName);
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* Resolves the on-disk path to `bin/cli.mjs`, the existing per-sprint CLI this
|
|
107
|
+
* spawner launches. Relative to this file's own package tree
|
|
108
|
+
* (src/supervisor/spawner.mjs -> ../../bin/cli.mjs), matching the layout
|
|
109
|
+
* convention already used by cli.mjs's own resolveRunnerScriptPath().
|
|
110
|
+
* @param {{ dirname?: string }} [deps]
|
|
111
|
+
* @returns {string}
|
|
112
|
+
*/
|
|
113
|
+
export function defaultCliPath(deps = {}) {
|
|
114
|
+
const dirname = deps.dirname || __dirname;
|
|
115
|
+
return path.join(dirname, '../../bin/cli.mjs');
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Checks whether a TCP port is currently free by actually attempting to bind
|
|
120
|
+
* it (not just consulting in-memory bookkeeping) -- so allocation reflects
|
|
121
|
+
* real OS-level availability, not just what this supervisor process itself
|
|
122
|
+
* has handed out.
|
|
123
|
+
*
|
|
124
|
+
* The real viewer and the supervisor both bind loopback (127.0.0.1) by
|
|
125
|
+
* default, so a bind test on the same host reliably conflicts with them. The
|
|
126
|
+
* connect probe remains because it also detects a FOREIGN process that owns
|
|
127
|
+
* the port -- e.g. one bound to the wildcard address, which on Windows can
|
|
128
|
+
* coexist with a loopback-only bind on the same port without either side
|
|
129
|
+
* erroring, splitting inbound connections between the two.
|
|
130
|
+
*
|
|
131
|
+
* This is deliberately NOT fixed by making the probe itself bind the
|
|
132
|
+
* wildcard address: doing so opens this process up to inbound connections
|
|
133
|
+
* from every interface, which triggers an interactive Windows Firewall
|
|
134
|
+
* "allow this app" prompt on first use per port -- and in a headless/CI
|
|
135
|
+
* run nothing ever dismisses that prompt, so the bind call hangs
|
|
136
|
+
* indefinitely (confirmed directly: a wildcard-bind probe stalled a real
|
|
137
|
+
* test run with zero CPU progress). Instead, first try to CONNECT to
|
|
138
|
+
* `host` -- a connect (never a bind) never triggers that firewall prompt,
|
|
139
|
+
* and it reaches a wildcard-bound listener just as reliably as a
|
|
140
|
+
* loopback-only one, since either accepts loopback connections. Only if
|
|
141
|
+
* nothing answers do we fall back to the original bind test, which still
|
|
142
|
+
* catches a same-host bind conflict a connect probe alone cannot (e.g. a
|
|
143
|
+
* listener that accepted the socket but is slow to respond).
|
|
144
|
+
* @param {number} port
|
|
145
|
+
* @param {string} [host]
|
|
146
|
+
* @returns {Promise<boolean>}
|
|
147
|
+
*/
|
|
148
|
+
export function isPortAvailable(port, host = '127.0.0.1') {
|
|
149
|
+
return new Promise((resolve) => {
|
|
150
|
+
const probe = net.connect({ port, host });
|
|
151
|
+
const onOccupied = () => { probe.destroy(); resolve(false); };
|
|
152
|
+
probe.once('connect', onOccupied);
|
|
153
|
+
probe.once('error', () => {
|
|
154
|
+
probe.destroy();
|
|
155
|
+
const tester = net.createServer();
|
|
156
|
+
tester.unref();
|
|
157
|
+
tester.once('error', () => resolve(false));
|
|
158
|
+
tester.listen({ port, host, exclusive: true }, () => {
|
|
159
|
+
tester.close(() => resolve(true));
|
|
160
|
+
});
|
|
161
|
+
});
|
|
162
|
+
});
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
/**
|
|
166
|
+
* Finds the lowest free port at or above `startPort`, skipping any port in
|
|
167
|
+
* `excludedPorts` (the set of ports already handed to other LIVE sprints by
|
|
168
|
+
* this supervisor) and any port the OS reports as unavailable. This is the
|
|
169
|
+
* mechanism behind the acceptance criterion "port allocation never hands the
|
|
170
|
+
* same port to two live sprints": excludedPorts is the live set at call time,
|
|
171
|
+
* re-checked against the OS so a port that some unrelated process is already
|
|
172
|
+
* using is also skipped.
|
|
173
|
+
* @param {{
|
|
174
|
+
* startPort?: number,
|
|
175
|
+
* maxAttempts?: number,
|
|
176
|
+
* excludedPorts?: Set<number>|number[],
|
|
177
|
+
* isAvailable?: (port: number) => Promise<boolean>,
|
|
178
|
+
* }} [opts]
|
|
179
|
+
* @returns {Promise<number>}
|
|
180
|
+
*/
|
|
181
|
+
export async function allocateFreePort(opts = {}) {
|
|
182
|
+
const startPort = Number.isInteger(opts.startPort) ? opts.startPort : DEFAULT_SPAWNER_BASE_PORT;
|
|
183
|
+
const maxAttempts = Number.isInteger(opts.maxAttempts) ? opts.maxAttempts : 1000;
|
|
184
|
+
const excluded = opts.excludedPorts instanceof Set ? opts.excludedPorts : new Set(opts.excludedPorts || []);
|
|
185
|
+
const isAvailable = opts.isAvailable || isPortAvailable;
|
|
186
|
+
|
|
187
|
+
for (let i = 0; i < maxAttempts; i++) {
|
|
188
|
+
const candidate = startPort + i;
|
|
189
|
+
if (candidate > 65535) break;
|
|
190
|
+
if (excluded.has(candidate)) continue;
|
|
191
|
+
// eslint-disable-next-line no-await-in-loop -- sequential probing is intentional: we want the LOWEST free port, and each check is cheap.
|
|
192
|
+
if (await isAvailable(candidate)) return candidate;
|
|
193
|
+
}
|
|
194
|
+
throw new Error(
|
|
195
|
+
`[spawner] no free --viewer-port found in [${startPort}, ${startPort + maxAttempts}) ` +
|
|
196
|
+
`(excluding ${excluded.size} port(s) already held by live sprints)`,
|
|
197
|
+
);
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* Builds the cli.mjs argv (everything after the script path) for one sprint
|
|
202
|
+
* launch, given the already-allocated `viewerPort`. Pulled into its own pure
|
|
203
|
+
* function so a test can assert the exact flags reach cli.mjs without
|
|
204
|
+
* spawning a real process, matching cli.mjs's own buildRunnerArgs() pattern.
|
|
205
|
+
* @param {{
|
|
206
|
+
* issue: string, members: string, branch: string, base: string,
|
|
207
|
+
* goal?: string, maxCycles?: number|string, allowMissingMembers?: boolean,
|
|
208
|
+
* requirementsFile?: string, roleMap?: object|string, budget?: number|string,
|
|
209
|
+
* viewerPort: number, serviceUrl?: string, runId?: string, expectBeads?: string,
|
|
210
|
+
* extraArgs?: string[], skipRegression?: boolean, kbDemotionLoop?: 'on'|'off',
|
|
211
|
+
* decisionNotify?: string|object,
|
|
212
|
+
* }} opts
|
|
213
|
+
* @returns {string[]}
|
|
214
|
+
*/
|
|
215
|
+
export function buildSprintArgv(opts = {}) {
|
|
216
|
+
const { issue, members, branch, base, goal, maxCycles, allowMissingMembers,
|
|
217
|
+
requirementsFile, roleMap, budget, viewerPort, serviceUrl, runId, expectBeads, extraArgs, skipRegression, kbDemotionLoop, decisionNotify } = opts;
|
|
218
|
+
|
|
219
|
+
if (!issue || !members || !branch || !base) {
|
|
220
|
+
throw new Error('buildSprintArgv requires issue, members, branch, and base');
|
|
221
|
+
}
|
|
222
|
+
if (!Number.isInteger(viewerPort) || viewerPort <= 0 || viewerPort > 65535) {
|
|
223
|
+
throw new Error('buildSprintArgv requires an integer viewerPort in [1, 65535]');
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
const args = [
|
|
227
|
+
'--issue', issue,
|
|
228
|
+
'--members', members,
|
|
229
|
+
'--branch', branch,
|
|
230
|
+
'--base', base,
|
|
231
|
+
'--viewer-port', String(viewerPort),
|
|
232
|
+
];
|
|
233
|
+
if (goal !== undefined) args.push('--goal', goal);
|
|
234
|
+
if (maxCycles !== undefined) args.push('--max-cycles', String(maxCycles));
|
|
235
|
+
if (allowMissingMembers) args.push('--allow-missing-members');
|
|
236
|
+
if (requirementsFile !== undefined) args.push('--requirements-file', requirementsFile);
|
|
237
|
+
if (roleMap !== undefined) {
|
|
238
|
+
args.push('--role-map', typeof roleMap === 'string' ? roleMap : JSON.stringify(roleMap));
|
|
239
|
+
}
|
|
240
|
+
if (budget !== undefined) args.push('--budget', String(budget));
|
|
241
|
+
if (skipRegression === true) args.push('--skip-regression');
|
|
242
|
+
if (kbDemotionLoop !== undefined) args.push('--kb-demotion-loop', kbDemotionLoop);
|
|
243
|
+
if (decisionNotify !== undefined) args.push('--decision-notify', typeof decisionNotify === 'string' ? decisionNotify : JSON.stringify(decisionNotify));
|
|
244
|
+
// apra-fleet-f34.1: when this supervisor instance has a known --service-url
|
|
245
|
+
// (its own HTTP listen address, wired in from createSpawner()'s deps.serviceUrl
|
|
246
|
+
// below), forward it so the spawned cli.mjs child threads it into
|
|
247
|
+
// runner.js's HTTP-backed dolt-mutex/id-allocator clients instead of the
|
|
248
|
+
// source-3 no-op fallback. Absent a configured serviceUrl this is omitted
|
|
249
|
+
// entirely -- fallback behavior is unchanged.
|
|
250
|
+
if (serviceUrl !== undefined) args.push('--service-url', serviceUrl);
|
|
251
|
+
// apra-fleet-k7b.1: the supervisor's own sprintId (its ledger reservation
|
|
252
|
+
// key) forwarded as this child's --run-id, so the engine's run-state
|
|
253
|
+
// (running/<runId>.json -> old_runs/<runId>.json, apra-fleet-workflow's
|
|
254
|
+
// viewer) and the dashboard viewer's identity are keyed by the SAME
|
|
255
|
+
// incarnation-unique id the supervisor already uses -- not the sprint
|
|
256
|
+
// branch name, which is reused across relaunches on the same branch and
|
|
257
|
+
// would otherwise silently overwrite prior run history. Omitted here (a
|
|
258
|
+
// direct/standalone CLI launch never goes through this spawner) means
|
|
259
|
+
// cli.mjs falls back to the branch name itself.
|
|
260
|
+
if (runId !== undefined) args.push('--run-id', runId);
|
|
261
|
+
// The beads identity this supervisor resolved at startup (see
|
|
262
|
+
// beads-identity.mjs / bin/serve.mjs), serialized by the shared
|
|
263
|
+
// fleet-sprint/beads-identity.mjs serializeExpectedIdentity(), forwarded
|
|
264
|
+
// so the engine can verify every member's `bd where` against the SAME
|
|
265
|
+
// database this supervisor reads. Omitted when the caller has none (a
|
|
266
|
+
// direct/test spawner) -- the engine then skips the verification.
|
|
267
|
+
if (expectBeads !== undefined) args.push('--expect-beads', expectBeads);
|
|
268
|
+
if (Array.isArray(extraArgs)) args.push(...extraArgs);
|
|
269
|
+
return args;
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
/**
|
|
273
|
+
* Creates the spawner seam (see src/supervisor/server.mjs's seam docs). Not
|
|
274
|
+
* started until `start()` is called (a no-op here -- there is no persistent
|
|
275
|
+
* state to load; the ledger owns that). `stop()` deliberately never kills any
|
|
276
|
+
* live child: it only clears this process's own local bookkeeping.
|
|
277
|
+
*
|
|
278
|
+
* @param {{
|
|
279
|
+
* basePort?: number,
|
|
280
|
+
* command?: string,
|
|
281
|
+
* cliPath?: string,
|
|
282
|
+
* cwd?: string,
|
|
283
|
+
* env?: NodeJS.ProcessEnv,
|
|
284
|
+
* spawn?: typeof import('node:child_process').spawn,
|
|
285
|
+
* isPortAvailable?: (port: number) => Promise<boolean>,
|
|
286
|
+
* logger?: { log?: Function, error?: Function },
|
|
287
|
+
* serviceUrl?: string,
|
|
288
|
+
* expectBeads?: string|(() => string|undefined),
|
|
289
|
+
* onChildExit?: (info: { pid: number, runId: string|null, exitCode: number|null, signal: string|null, at: string, logPath: string }) => void,
|
|
290
|
+
* now?: () => string,
|
|
291
|
+
* dataDir?: string,
|
|
292
|
+
* fs?: {
|
|
293
|
+
* mkdirSync: typeof import('node:fs').mkdirSync,
|
|
294
|
+
* openSync: typeof import('node:fs').openSync,
|
|
295
|
+
* closeSync: typeof import('node:fs').closeSync,
|
|
296
|
+
* },
|
|
297
|
+
* }} [deps]
|
|
298
|
+
* @returns {{
|
|
299
|
+
* name: string,
|
|
300
|
+
* start(): Promise<void>,
|
|
301
|
+
* stop(): Promise<void>,
|
|
302
|
+
* spawnSprint(opts: object): Promise<{ pid: number, port: number, command: string, args: string[], logPath: string }>,
|
|
303
|
+
* liveCount: number,
|
|
304
|
+
* livePorts: Set<number>,
|
|
305
|
+
* getLiveEntry(pid: number): { port: number, child: object, logPath: string }|undefined,
|
|
306
|
+
* }}
|
|
307
|
+
*/
|
|
308
|
+
export function createSpawner(deps = {}) {
|
|
309
|
+
const logger = deps.logger ?? console;
|
|
310
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
311
|
+
const spawnImpl = deps.spawn ?? nodeSpawn;
|
|
312
|
+
const isAvailable = deps.isPortAvailable ?? isPortAvailable;
|
|
313
|
+
const basePort = Number.isInteger(deps.basePort) ? deps.basePort : DEFAULT_SPAWNER_BASE_PORT;
|
|
314
|
+
// apra-fleet-ou7.1: where per-sprint raw stdout/stderr log files live
|
|
315
|
+
// (<dataDir>/logs/<stem>.log, resolveSprintLogPath() above). Injectable
|
|
316
|
+
// fs so a test can drive a temp dir/fake fs without touching real disk.
|
|
317
|
+
const dataDir = deps.dataDir ?? defaultDataDir();
|
|
318
|
+
const fsImpl = deps.fs ?? fs;
|
|
319
|
+
const command = deps.command ?? process.execPath;
|
|
320
|
+
const cliPath = deps.cliPath ?? defaultCliPath();
|
|
321
|
+
// apra-fleet-f34.1: the supervisor's OWN HTTP listen address (e.g.
|
|
322
|
+
// `http://localhost:8787`), the same address it already binds for its
|
|
323
|
+
// dolt-mutex/id-allocator/sprint-control API. Threaded into every spawned
|
|
324
|
+
// child's `--service-url` (see buildSprintArgv above) so runner.js takes
|
|
325
|
+
// the HTTP-backed dolt-mutex/id-allocator clients instead of the source-3
|
|
326
|
+
// no-op fallback. Optional: when the caller (bin/serve.mjs) does not pass
|
|
327
|
+
// one, spawned children simply omit --service-url and fall back exactly
|
|
328
|
+
// as before -- no crash, unchanged behavior.
|
|
329
|
+
const serviceUrl = deps.serviceUrl;
|
|
330
|
+
// The serialized beads identity (fleet-sprint/beads-identity.mjs's
|
|
331
|
+
// serializeExpectedIdentity() JSON) every child receives as
|
|
332
|
+
// `--expect-beads`; threaded exactly like serviceUrl above -- optional,
|
|
333
|
+
// and a per-call opts.expectBeads wins over the instance default. May be
|
|
334
|
+
// a function (bin/serve.mjs passes one) so it is read at each spawn:
|
|
335
|
+
// the supervisor's identity can start out unknown and be recovered
|
|
336
|
+
// later by GET /api/health?refresh=1. undefined -> the flag is omitted.
|
|
337
|
+
const expectBeadsDep = deps.expectBeads;
|
|
338
|
+
const resolveExpectBeads = () => (typeof expectBeadsDep === 'function' ? expectBeadsDep() : expectBeadsDep);
|
|
339
|
+
// apra-fleet-k7b.3: optional same-instance child-exit notification (see
|
|
340
|
+
// the 'exit' listener below) and its injectable clock (test determinism,
|
|
341
|
+
// matching ledger.mjs/history.mjs's own `now` seam convention).
|
|
342
|
+
const onChildExit = deps.onChildExit;
|
|
343
|
+
const nowFn = deps.now ?? (() => new Date().toISOString());
|
|
344
|
+
|
|
345
|
+
/**
|
|
346
|
+
* Live sprints launched BY THIS supervisor process, keyed by child pid.
|
|
347
|
+
* This is only ever used to keep --viewer-port allocation unique within
|
|
348
|
+
* this process's lifetime; it is NOT the durable source of truth (that is
|
|
349
|
+
* eft.5's ledger, re-adopted across restarts by eft.4.5).
|
|
350
|
+
* @type {Map<number, { port: number, child: import('node:child_process').ChildProcess, logPath: string }>}
|
|
351
|
+
*/
|
|
352
|
+
const live = new Map();
|
|
353
|
+
|
|
354
|
+
function livePortSet() {
|
|
355
|
+
return new Set(Array.from(live.values(), (entry) => entry.port));
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
/**
|
|
359
|
+
* Spawns one sprint as a detached `bin/cli.mjs` child with a freshly
|
|
360
|
+
* allocated, currently-unique `--viewer-port`.
|
|
361
|
+
*
|
|
362
|
+
* apra-fleet-ou7.1: the child's stdout+stderr are teed to a per-sprint
|
|
363
|
+
* raw log file (resolveSprintLogPath()) instead of `stdio: 'ignore'` --
|
|
364
|
+
* opened BEFORE spawning and handed to the child as a real fd (not a
|
|
365
|
+
* Node stream), so raw output is captured for the sprint's WHOLE
|
|
366
|
+
* lifetime, including whatever it wrote right before a crash. The
|
|
367
|
+
* file's own fd is a plain OS-level dup once spawn() hands it to the
|
|
368
|
+
* child, so this process's copy is safe to close the moment the child
|
|
369
|
+
* itself exits (or immediately, if spawn/the pid check fails) without
|
|
370
|
+
* losing anything the child is still writing.
|
|
371
|
+
* @param {object} opts - the sprint's cli.mjs flags (issue, members, branch, base, ...)
|
|
372
|
+
* @returns {Promise<{ pid: number, port: number, command: string, args: string[], logPath: string }>}
|
|
373
|
+
*/
|
|
374
|
+
async function spawnSprint(opts = {}) {
|
|
375
|
+
const port = await allocateFreePort({ startPort: basePort, excludedPorts: livePortSet(), isAvailable });
|
|
376
|
+
const args = [cliPath, ...buildSprintArgv({
|
|
377
|
+
...opts,
|
|
378
|
+
viewerPort: port,
|
|
379
|
+
serviceUrl: opts.serviceUrl ?? serviceUrl,
|
|
380
|
+
expectBeads: opts.expectBeads ?? resolveExpectBeads(),
|
|
381
|
+
})];
|
|
382
|
+
|
|
383
|
+
// apra-fleet-ou7.1: opts.runId is the SAME sprintId createSprintController
|
|
384
|
+
// generates and claims in the ledger BEFORE spawning (apra-fleet-k7b.1) --
|
|
385
|
+
// reused here (not re-derived) so the log file name and the ledger's
|
|
386
|
+
// sprintId key always agree. A direct/standalone spawnSprint() call with
|
|
387
|
+
// no runId (or a test) still gets a unique file via the randomUUID() fallback.
|
|
388
|
+
const logPath = resolveSprintLogPath(dataDir, opts.runId || `direct-${randomUUID()}`);
|
|
389
|
+
fsImpl.mkdirSync(path.dirname(logPath), { recursive: true });
|
|
390
|
+
const logFd = fsImpl.openSync(logPath, 'a');
|
|
391
|
+
let logFdClosed = false;
|
|
392
|
+
const closeLogFd = () => {
|
|
393
|
+
if (logFdClosed) return;
|
|
394
|
+
logFdClosed = true;
|
|
395
|
+
try {
|
|
396
|
+
fsImpl.closeSync(logFd);
|
|
397
|
+
} catch (err) {
|
|
398
|
+
logError(`[spawner] failed to close log fd for '${logPath}':`, err);
|
|
399
|
+
}
|
|
400
|
+
};
|
|
401
|
+
|
|
402
|
+
let child;
|
|
403
|
+
try {
|
|
404
|
+
child = spawnImpl(command, args, {
|
|
405
|
+
detached: true,
|
|
406
|
+
windowsHide: true,
|
|
407
|
+
stdio: ['ignore', logFd, logFd],
|
|
408
|
+
...(deps.cwd !== undefined ? { cwd: deps.cwd } : {}),
|
|
409
|
+
...(deps.env !== undefined ? { env: deps.env } : {}),
|
|
410
|
+
});
|
|
411
|
+
} catch (err) {
|
|
412
|
+
// Spawn itself threw synchronously (e.g. an injected fake spawn in
|
|
413
|
+
// a test) -- our copy of the fd is never handed off, close it now
|
|
414
|
+
// so a failed launch can never leak it.
|
|
415
|
+
closeLogFd();
|
|
416
|
+
throw err;
|
|
417
|
+
}
|
|
418
|
+
|
|
419
|
+
if (!child || typeof child.pid !== 'number') {
|
|
420
|
+
closeLogFd();
|
|
421
|
+
throw new Error('[spawner] spawn did not return a pid; sprint child process failed to launch');
|
|
422
|
+
}
|
|
423
|
+
const pid = child.pid;
|
|
424
|
+
live.set(pid, { port, child, logPath });
|
|
425
|
+
|
|
426
|
+
// Free this port for reuse and drop local bookkeeping once the child
|
|
427
|
+
// actually exits. This ONLY reacts to the child's own lifecycle --
|
|
428
|
+
// never to the supervisor's, and never to another child's.
|
|
429
|
+
//
|
|
430
|
+
// apra-fleet-k7b.3: also forward the exit code/signal (Node's own
|
|
431
|
+
// 'exit' event args) to the optional onChildExit callback, keyed by
|
|
432
|
+
// this launch's runId (the SAME sprintId createSprintController
|
|
433
|
+
// generates and claims in the ledger BEFORE spawning, apra-fleet-
|
|
434
|
+
// k7b.1) -- NOT re-derived here, so this stays a thin same-instance
|
|
435
|
+
// notification rather than owning ledger/history persistence itself
|
|
436
|
+
// (bin/serve.mjs's wiring does that). A throwing callback must never
|
|
437
|
+
// take down this listener's own bookkeeping cleanup above it.
|
|
438
|
+
//
|
|
439
|
+
// apra-fleet-ou7.1: this is also where the log fd is closed --
|
|
440
|
+
// acceptance criterion "file handles are closed on child exit (no fd
|
|
441
|
+
// leak across many launches)". The child has its own OS-level
|
|
442
|
+
// duplicated descriptor (dup2'd at spawn time), so closing OUR copy
|
|
443
|
+
// here never truncates or loses anything the child wrote, including
|
|
444
|
+
// its very last output before a crash.
|
|
445
|
+
child.once('exit', (code, signal) => {
|
|
446
|
+
live.delete(pid);
|
|
447
|
+
closeLogFd();
|
|
448
|
+
if (typeof onChildExit === 'function') {
|
|
449
|
+
try {
|
|
450
|
+
// Promise.resolve(...).catch(...) covers BOTH a synchronous
|
|
451
|
+
// throw and an async callback's rejected promise (bin/
|
|
452
|
+
// serve.mjs's real wiring is `async`) -- either way this
|
|
453
|
+
// listener's own bookkeeping cleanup above must never be
|
|
454
|
+
// affected, and no unhandled rejection should escape.
|
|
455
|
+
Promise.resolve(onChildExit({
|
|
456
|
+
pid,
|
|
457
|
+
runId: opts.runId ?? null,
|
|
458
|
+
exitCode: code ?? null,
|
|
459
|
+
signal: signal ?? null,
|
|
460
|
+
at: nowFn(),
|
|
461
|
+
logPath,
|
|
462
|
+
})).catch((err) => {
|
|
463
|
+
logError(`[spawner] onChildExit callback rejected for pid=${pid}:`, err);
|
|
464
|
+
});
|
|
465
|
+
} catch (err) {
|
|
466
|
+
logError(`[spawner] onChildExit callback threw for pid=${pid}:`, err);
|
|
467
|
+
}
|
|
468
|
+
}
|
|
469
|
+
});
|
|
470
|
+
child.once('error', (err) => {
|
|
471
|
+
logError(`[spawner] child pid=${pid} (issue=${opts.issue}) emitted error:`, err);
|
|
472
|
+
live.delete(pid);
|
|
473
|
+
// 'error' can fire instead of, or alongside, 'exit' -- closeLogFd()
|
|
474
|
+
// is idempotent, so whichever fires (or both) closes exactly once.
|
|
475
|
+
closeLogFd();
|
|
476
|
+
});
|
|
477
|
+
|
|
478
|
+
// CRITICAL (acceptance criterion): unref() so this child never keeps
|
|
479
|
+
// the supervisor's event loop alive on its account. Combined with
|
|
480
|
+
// `detached: true` (its own process group/session on POSIX), a
|
|
481
|
+
// supervisor SIGKILL/exit can never take this child down with it.
|
|
482
|
+
child.unref();
|
|
483
|
+
|
|
484
|
+
return { pid, port, command, args, logPath };
|
|
485
|
+
}
|
|
486
|
+
|
|
487
|
+
return {
|
|
488
|
+
name: 'spawner',
|
|
489
|
+
async start() {},
|
|
490
|
+
async stop() {
|
|
491
|
+
// Detached-orphan contract: tearing down the spawner/supervisor
|
|
492
|
+
// must NEVER kill a live sprint child. This only clears local
|
|
493
|
+
// bookkeeping -- the ledger (eft.5) is the durable, restart-
|
|
494
|
+
// surviving record of what is actually still live.
|
|
495
|
+
live.clear();
|
|
496
|
+
},
|
|
497
|
+
|
|
498
|
+
spawnSprint,
|
|
499
|
+
|
|
500
|
+
/**
|
|
501
|
+
* Registers a RE-ADOPTED child (apra-fleet-eft.4.5): a live process
|
|
502
|
+
* this supervisor instance did not itself spawn -- typically a sprint
|
|
503
|
+
* recovered by PID from the persisted ledger after a supervisor
|
|
504
|
+
* restart, whose --viewer-port has since been recovered from its own
|
|
505
|
+
* command line. This makes the pid known to getLiveEntry()/livePorts
|
|
506
|
+
* for exactly the same reasons a freshly-spawned child is: watchdog
|
|
507
|
+
* HTTP-reachability probing and API port resolution both key off this
|
|
508
|
+
* bookkeeping.
|
|
509
|
+
*
|
|
510
|
+
* There is no ChildProcess handle for a re-adopted pid (this process
|
|
511
|
+
* never spawned it), so unlike spawnSprint() no 'exit'/'error'
|
|
512
|
+
* listener is wired here -- nothing in this process can be notified
|
|
513
|
+
* the moment it exits. The watchdog's own periodic PID-liveness probe
|
|
514
|
+
* is what eventually detects the pid going away; adopt() itself does
|
|
515
|
+
* NOT re-verify liveness (the caller -- eft.4.5's re-adopter -- has
|
|
516
|
+
* already PID-probed via the restart reconciler before calling this).
|
|
517
|
+
* Idempotent: adopting the same pid again simply overwrites its port.
|
|
518
|
+
*
|
|
519
|
+
* apra-fleet-ou7.1: `logPath` is not recovered here (unlike --viewer-
|
|
520
|
+
* port, it is not on the re-adopted child's own command line) --
|
|
521
|
+
* consumers needing it for a re-adopted sprint read it from the
|
|
522
|
+
* ledger's own persisted reservation (recorded at the ORIGINAL
|
|
523
|
+
* claim/spawn, survives the restart), not from this in-memory entry.
|
|
524
|
+
* @param {number} pid
|
|
525
|
+
* @param {number} port
|
|
526
|
+
*/
|
|
527
|
+
adopt(pid, port) {
|
|
528
|
+
if (!Number.isInteger(pid) || pid <= 0) {
|
|
529
|
+
throw new TypeError('adopt() requires a positive integer pid');
|
|
530
|
+
}
|
|
531
|
+
if (!Number.isInteger(port) || port <= 0 || port > 65535) {
|
|
532
|
+
throw new TypeError('adopt() requires an integer port in [1, 65535]');
|
|
533
|
+
}
|
|
534
|
+
live.set(pid, { port, child: null, logPath: null });
|
|
535
|
+
},
|
|
536
|
+
|
|
537
|
+
/** Number of sprints spawned by this process that haven't exited yet. */
|
|
538
|
+
get liveCount() { return live.size; },
|
|
539
|
+
/** The set of --viewer-port values currently in use by live sprints. */
|
|
540
|
+
get livePorts() { return livePortSet(); },
|
|
541
|
+
/** @param {number} pid */
|
|
542
|
+
getLiveEntry(pid) { return live.get(pid); },
|
|
543
|
+
};
|
|
544
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
// Self-vs-foreign classification for the reservation ledger entries that
|
|
2
|
+
// GET /api/sprints returns (api.mjs listSprints()).
|
|
3
|
+
//
|
|
4
|
+
// apra-fleet-5co8.37: the deploy runbook's active-sprints gate used to STOP on
|
|
5
|
+
// ANY non-empty `sprints` array. A sprint that dispatches its own deployer is
|
|
6
|
+
// itself in that ledger, so the gate always fired on the deploying sprint's OWN
|
|
7
|
+
// reservation and no sprint could ever deploy its own work. The deployer is now
|
|
8
|
+
// told its dispatching sprint's identity and uses this module to keep only
|
|
9
|
+
// GENUINELY foreign reservations as a stop condition.
|
|
10
|
+
//
|
|
11
|
+
// Identity comparison is EXACT (=== on the sprintId string, === on an integer
|
|
12
|
+
// childPid). It is deliberately never a substring/prefix match: a sprintId
|
|
13
|
+
// embeds its issue roots, so `includes()` would make two unrelated sprints on
|
|
14
|
+
// overlapping issue roots look like each other.
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* @typedef {object} SprintReservation
|
|
18
|
+
* @property {string} [sprintId] ledger reservation key (incarnation-unique)
|
|
19
|
+
* @property {number|null} [childPid] pid of the sprint child process, if known
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* @typedef {object} SprintSelfIdentity
|
|
24
|
+
* @property {string} [sprintId] the dispatching sprint's own reservation key
|
|
25
|
+
* @property {number} [childPid] the dispatching sprint's own child pid
|
|
26
|
+
*/
|
|
27
|
+
|
|
28
|
+
/** @param {unknown} value @returns {string|null} */
|
|
29
|
+
function exactStringOrNull(value) {
|
|
30
|
+
return typeof value === 'string' && value.length > 0 ? value : null;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** @param {unknown} value @returns {number|null} */
|
|
34
|
+
function exactPidOrNull(value) {
|
|
35
|
+
return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : null;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* True when `reservation` is the caller's OWN reservation.
|
|
40
|
+
*
|
|
41
|
+
* Matching requires at least one exact identifier match. With no usable
|
|
42
|
+
* self-identity (neither a sprintId nor a childPid), NOTHING matches: an
|
|
43
|
+
* unidentified caller must treat every reservation as foreign, which preserves
|
|
44
|
+
* the old conservative stop-on-anything behavior.
|
|
45
|
+
*
|
|
46
|
+
* @param {SprintReservation} reservation
|
|
47
|
+
* @param {SprintSelfIdentity} [identity]
|
|
48
|
+
* @returns {boolean}
|
|
49
|
+
*/
|
|
50
|
+
export function isSelfReservation(reservation, identity = {}) {
|
|
51
|
+
if (!reservation || typeof reservation !== 'object') return false;
|
|
52
|
+
const selfSprintId = exactStringOrNull(identity?.sprintId);
|
|
53
|
+
const selfChildPid = exactPidOrNull(identity?.childPid);
|
|
54
|
+
if (selfSprintId === null && selfChildPid === null) return false;
|
|
55
|
+
|
|
56
|
+
const resSprintId = exactStringOrNull(reservation.sprintId);
|
|
57
|
+
if (selfSprintId !== null && resSprintId !== null && resSprintId === selfSprintId) return true;
|
|
58
|
+
|
|
59
|
+
const resChildPid = exactPidOrNull(reservation.childPid);
|
|
60
|
+
if (selfChildPid !== null && resChildPid !== null && resChildPid === selfChildPid) return true;
|
|
61
|
+
|
|
62
|
+
return false;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Splits a GET /api/sprints `sprints` array into the caller's own reservations
|
|
67
|
+
* and genuinely foreign ones.
|
|
68
|
+
*
|
|
69
|
+
* `shouldStop` is the deploy gate's answer: stop only when at least one FOREIGN
|
|
70
|
+
* reservation is live. A list containing only the caller's own reservation(s)
|
|
71
|
+
* -- or an empty list -- lets the deploy proceed.
|
|
72
|
+
*
|
|
73
|
+
* @param {SprintReservation[]} sprints
|
|
74
|
+
* @param {SprintSelfIdentity} [identity]
|
|
75
|
+
* @returns {{ self: SprintReservation[], foreign: SprintReservation[], shouldStop: boolean }}
|
|
76
|
+
*/
|
|
77
|
+
export function classifyActiveSprints(sprints, identity = {}) {
|
|
78
|
+
const list = Array.isArray(sprints) ? sprints : [];
|
|
79
|
+
/** @type {SprintReservation[]} */ const self = [];
|
|
80
|
+
/** @type {SprintReservation[]} */ const foreign = [];
|
|
81
|
+
for (const reservation of list) {
|
|
82
|
+
if (isSelfReservation(reservation, identity)) self.push(reservation);
|
|
83
|
+
else foreign.push(reservation);
|
|
84
|
+
}
|
|
85
|
+
return { self, foreign, shouldStop: foreign.length > 0 };
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* Convenience wrapper: just the foreign reservations.
|
|
90
|
+
* @param {SprintReservation[]} sprints
|
|
91
|
+
* @param {SprintSelfIdentity} [identity]
|
|
92
|
+
* @returns {SprintReservation[]}
|
|
93
|
+
*/
|
|
94
|
+
export function selectForeignSprints(sprints, identity = {}) {
|
|
95
|
+
return classifyActiveSprints(sprints, identity).foreign;
|
|
96
|
+
}
|