@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,474 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- live-detail reverse proxy (apra-fleet-eft.6.4,
|
|
3
|
+
// Plan Part 2.3)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// Serves each sprint's LIVE detail view at `/sprints/:id/live` on the SUPERVISOR
|
|
7
|
+
// port, reverse-proxied to that sprint's detached child viewer (the per-sprint
|
|
8
|
+
// dashboard the eft.4.2 spawner launched on its own `--viewer-port`). The child
|
|
9
|
+
// viewer serves `/` (HTML), `/events` (Server-Sent Events), `/state` (JSON), and
|
|
10
|
+
// `/stop`/`/save_logs` (POST) -- see packages/apra-fleet-workflow/src/viewer/
|
|
11
|
+
// index.mjs.
|
|
12
|
+
//
|
|
13
|
+
// WHY PROXY INSTEAD OF LINKING THE CHILD PORT DIRECTLY
|
|
14
|
+
// ----------------------------------------------------
|
|
15
|
+
// Bare child-port links (`http://host:8083/`) leak the supervisor's internal
|
|
16
|
+
// port allocation, break the moment the operator is on a different host, and
|
|
17
|
+
// would need a firewall hole punched per sprint. So the ONLY externally visible
|
|
18
|
+
// surface is the supervisor's own port, and every child endpoint is reached
|
|
19
|
+
// through the `/sprints/:id/live` path prefix. The child viewer's own client
|
|
20
|
+
// script calls its endpoints via absolute app-paths (`new EventSource('/events')`,
|
|
21
|
+
// `fetch('/state?...')`, `fetch('/stop')`); those are rewritten in the served
|
|
22
|
+
// HTML to the live prefix so the browser's follow-up requests re-enter this
|
|
23
|
+
// proxy rather than hitting the supervisor root (which has no such routes) or a
|
|
24
|
+
// bare child port. No child port ever appears in the served HTML.
|
|
25
|
+
//
|
|
26
|
+
// SSE PASSTHROUGH DISCIPLINE (acceptance criterion)
|
|
27
|
+
// -------------------------------------------------
|
|
28
|
+
// `/sprints/:id/live/events` streams the child's SSE feed with NO buffering and
|
|
29
|
+
// NO compression: `accept-encoding` is stripped upstream so the child never
|
|
30
|
+
// gzips a stream, hop-by-hop headers (incl. `transfer-encoding`) are dropped so
|
|
31
|
+
// we re-chunk cleanly, and every upstream data chunk is written straight to the
|
|
32
|
+
// client as it arrives (events reach the browser incrementally, never buffered
|
|
33
|
+
// to completion). A client disconnect (`res`/`req` 'close') destroys the
|
|
34
|
+
// upstream request, which the child observes as its own `req` closing and drops
|
|
35
|
+
// the SSE subscriber -- disconnect propagates end to end.
|
|
36
|
+
//
|
|
37
|
+
// HISTORY FALLTHROUGH (acceptance criterion)
|
|
38
|
+
// ------------------------------------------
|
|
39
|
+
// When a sprint has finished there is no live child to proxy to. Rather than
|
|
40
|
+
// 404 or serve a dead proxy, the SAME `/sprints/:id/live` URL falls through to a
|
|
41
|
+
// read-only historical view rendered from the sprint's persisted terminal state
|
|
42
|
+
// (old_runs/<sprintId>.json, falling back to the legacy old_sprints/<sprintId>.json,
|
|
43
|
+
// apra-fleet-eft.37.1). The full history rendering is eft.6.5's job, so
|
|
44
|
+
// the renderer is injectable (`renderHistory`); the default here reads the
|
|
45
|
+
// terminal-state file and renders a compact read-only page (no `/events`, no
|
|
46
|
+
// `/stop`) so the fallthrough is never a dead socket.
|
|
47
|
+
// =============================================================================
|
|
48
|
+
|
|
49
|
+
import http from 'node:http';
|
|
50
|
+
import fsp from 'node:fs/promises';
|
|
51
|
+
import { escapeHtml } from '@apralabs/apra-fleet-workflow/viewer/html-utils';
|
|
52
|
+
import { getTerminalRunStatePath } from '@apralabs/apra-fleet-workflow/viewer/run-state-paths';
|
|
53
|
+
import { withTimestamps } from './log-timestamp.mjs';
|
|
54
|
+
import { createChildPortResolver } from './child-port.mjs';
|
|
55
|
+
|
|
56
|
+
/** Hop-by-hop headers that must never be forwarded verbatim across a proxy. */
|
|
57
|
+
const HOP_BY_HOP = Object.freeze([
|
|
58
|
+
'connection', 'keep-alive', 'proxy-authenticate', 'proxy-authorization',
|
|
59
|
+
'te', 'trailer', 'transfer-encoding', 'upgrade',
|
|
60
|
+
]);
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Supervisor-relative live-view path prefix for one sprint. Matches the link the
|
|
64
|
+
* index dashboard renders (dashboard.mjs), so the rewritten child-endpoint URLs
|
|
65
|
+
* line up exactly with the document URL the browser is viewing.
|
|
66
|
+
* @param {string} sprintId
|
|
67
|
+
* @returns {string}
|
|
68
|
+
*/
|
|
69
|
+
export function livePrefixFor(sprintId) {
|
|
70
|
+
return '/sprints/' + encodeURIComponent(sprintId) + '/live';
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Rewrites the child viewer's served HTML so its absolute app-path client calls
|
|
75
|
+
* re-enter this proxy under the live prefix. Targets the child's known call
|
|
76
|
+
* sites verbatim (single-quoted literals in viewer/index.mjs and
|
|
77
|
+
* fleet-sprint/viewer-extensions.mjs): `'/events'`, `'/state?`, `'/stop'`,
|
|
78
|
+
* `'/save_logs'`, `'/extensions/` (generic on-demand-detail route, apra-fleet-04g.1
|
|
79
|
+
* -- covers every extension id, e.g. the beads task-tree description fetch),
|
|
80
|
+
* `'/activities/` (the activity tree's 'more...' full-output fetch). String (not
|
|
81
|
+
* regex) replacement keeps it unambiguous and metachar-safe.
|
|
82
|
+
* @param {string} html
|
|
83
|
+
* @param {string} prefix - e.g. `/sprints/my-sprint/live`
|
|
84
|
+
* @returns {string}
|
|
85
|
+
*/
|
|
86
|
+
export function rewriteChildHtml(html, prefix) {
|
|
87
|
+
if (typeof html !== 'string') return html;
|
|
88
|
+
return html
|
|
89
|
+
.split("'/events'").join("'" + prefix + "/events'")
|
|
90
|
+
.split("'/state?").join("'" + prefix + "/state?")
|
|
91
|
+
.split("'/stop'").join("'" + prefix + "/stop'")
|
|
92
|
+
// (apra-fleet-p2to.3.1) the child viewer's own Pause/Resume buttons
|
|
93
|
+
// (apra-fleet-p2to.2.1, viewer/index.mjs's pauseWorkflow()/
|
|
94
|
+
// resumeWorkflow()) call these two absolute app-paths -- rewritten
|
|
95
|
+
// here exactly like '/stop' so the live-proxied view's buttons
|
|
96
|
+
// re-enter this proxy instead of hitting the supervisor root.
|
|
97
|
+
.split("'/pause'").join("'" + prefix + "/pause'")
|
|
98
|
+
.split("'/resume'").join("'" + prefix + "/resume'")
|
|
99
|
+
.split("'/save_logs'").join("'" + prefix + "/save_logs'")
|
|
100
|
+
.split("'/extensions/").join("'" + prefix + "/extensions/")
|
|
101
|
+
.split("'/activities/").join("'" + prefix + "/activities/");
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/** Copy request headers for the upstream call, dropping host/encoding/hop-by-hop. */
|
|
105
|
+
function upstreamRequestHeaders(req) {
|
|
106
|
+
const headers = { ...req.headers };
|
|
107
|
+
delete headers.host;
|
|
108
|
+
// SSE passthrough must stay uncompressed and unbuffered -- never let the
|
|
109
|
+
// child gzip a stream we need to flush event-by-event.
|
|
110
|
+
delete headers['accept-encoding'];
|
|
111
|
+
for (const h of HOP_BY_HOP) delete headers[h];
|
|
112
|
+
return headers;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/** Copy upstream response headers for the client, dropping encoding/hop-by-hop. */
|
|
116
|
+
function downstreamResponseHeaders(upstreamHeaders) {
|
|
117
|
+
const out = { ...upstreamHeaders };
|
|
118
|
+
delete out['content-encoding'];
|
|
119
|
+
for (const h of HOP_BY_HOP) delete out[h];
|
|
120
|
+
return out;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** Writes a small text response with an explicit content-length. */
|
|
124
|
+
function sendPlain(res, status, text) {
|
|
125
|
+
const body = Buffer.from(String(text), 'utf-8');
|
|
126
|
+
res.writeHead(status, {
|
|
127
|
+
'content-type': 'text/plain; charset=utf-8',
|
|
128
|
+
'content-length': body.length,
|
|
129
|
+
});
|
|
130
|
+
res.end(body);
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/**
|
|
134
|
+
* Streams a child endpoint straight through to the client with no buffering.
|
|
135
|
+
* Used for `/events` (SSE), `/state`, `/stop`, `/save_logs`. Each upstream chunk
|
|
136
|
+
* is written to the client as it arrives; a client disconnect destroys the
|
|
137
|
+
* upstream request so the child sees the subscription drop.
|
|
138
|
+
*/
|
|
139
|
+
function proxyStream({ host, port, childPath, req, res, logError }) {
|
|
140
|
+
let settled = false;
|
|
141
|
+
const upstream = http.request(
|
|
142
|
+
{ host, port, path: childPath, method: req.method || 'GET', headers: upstreamRequestHeaders(req) },
|
|
143
|
+
(up) => {
|
|
144
|
+
settled = true;
|
|
145
|
+
res.writeHead(up.statusCode || 502, downstreamResponseHeaders(up.headers));
|
|
146
|
+
// Flush headers immediately so an SSE client's connection opens
|
|
147
|
+
// before the first event, not only once data starts flowing.
|
|
148
|
+
if (typeof res.flushHeaders === 'function') res.flushHeaders();
|
|
149
|
+
up.on('data', (chunk) => { res.write(chunk); });
|
|
150
|
+
up.on('end', () => { try { res.end(); } catch { /* already gone */ } });
|
|
151
|
+
up.on('error', (err) => {
|
|
152
|
+
logError?.('[proxy] upstream response stream error:', err);
|
|
153
|
+
try { res.end(); } catch { /* already gone */ }
|
|
154
|
+
});
|
|
155
|
+
},
|
|
156
|
+
);
|
|
157
|
+
upstream.on('error', (err) => {
|
|
158
|
+
logError?.('[proxy] upstream connect error:', err);
|
|
159
|
+
if (settled) { try { res.end(); } catch { /* gone */ } return; }
|
|
160
|
+
settled = true;
|
|
161
|
+
if (!res.headersSent) { try { res.writeHead(502); } catch { /* gone */ } }
|
|
162
|
+
try { res.end(); } catch { /* gone */ }
|
|
163
|
+
});
|
|
164
|
+
// Propagate a client disconnect to the child so its SSE subscriber is
|
|
165
|
+
// dropped. Only a PREMATURE close (client went away before we finished the
|
|
166
|
+
// response) should abort the upstream -- the 'close' that fires on normal
|
|
167
|
+
// completion must NOT, or it would tear down an already-finished request.
|
|
168
|
+
res.on('close', () => {
|
|
169
|
+
if (res.writableEnded) return;
|
|
170
|
+
try { upstream.destroy(); } catch { /* gone */ }
|
|
171
|
+
});
|
|
172
|
+
// Forward any request body (POST /stop, /save_logs) then finish the request.
|
|
173
|
+
req.pipe(upstream);
|
|
174
|
+
return upstream;
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/**
|
|
178
|
+
* Proxies the child's `/` HTML, buffering it just long enough to rewrite the
|
|
179
|
+
* client-endpoint URLs to the live prefix (the ONE endpoint that needs a body
|
|
180
|
+
* transform -- everything else streams). A pre-response connection failure
|
|
181
|
+
* invokes `onConnectError` so the base handler can fall through to history.
|
|
182
|
+
*/
|
|
183
|
+
function proxyHtml({ host, port, req, res, prefix, logError, onConnectError }) {
|
|
184
|
+
let settled = false;
|
|
185
|
+
const fail = (err) => {
|
|
186
|
+
if (settled) return;
|
|
187
|
+
settled = true;
|
|
188
|
+
logError?.('[proxy] html upstream error:', err);
|
|
189
|
+
if (onConnectError) { onConnectError(err); return; }
|
|
190
|
+
if (!res.headersSent) { try { res.writeHead(502); } catch { /* gone */ } }
|
|
191
|
+
try { res.end(); } catch { /* gone */ }
|
|
192
|
+
};
|
|
193
|
+
const upstream = http.request(
|
|
194
|
+
{ host, port, path: '/', method: 'GET', headers: upstreamRequestHeaders(req) },
|
|
195
|
+
(up) => {
|
|
196
|
+
const chunks = [];
|
|
197
|
+
up.on('data', (c) => chunks.push(c));
|
|
198
|
+
up.on('end', () => {
|
|
199
|
+
if (settled) return;
|
|
200
|
+
settled = true;
|
|
201
|
+
const html = rewriteChildHtml(Buffer.concat(chunks).toString('utf-8'), prefix);
|
|
202
|
+
const body = Buffer.from(html, 'utf-8');
|
|
203
|
+
if (res.headersSent) { try { res.end(); } catch { /* gone */ } return; }
|
|
204
|
+
res.writeHead(up.statusCode || 200, {
|
|
205
|
+
'content-type': 'text/html; charset=utf-8',
|
|
206
|
+
'content-length': body.length,
|
|
207
|
+
});
|
|
208
|
+
res.end(body);
|
|
209
|
+
});
|
|
210
|
+
up.on('error', fail);
|
|
211
|
+
},
|
|
212
|
+
);
|
|
213
|
+
upstream.on('error', fail);
|
|
214
|
+
res.on('close', () => { try { upstream.destroy(); } catch { /* gone */ } });
|
|
215
|
+
upstream.end();
|
|
216
|
+
return upstream;
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* Default read-only historical view renderer. Reads the sprint's persisted
|
|
221
|
+
* terminal state (old_runs/<sprintId>.json, falling back to the legacy
|
|
222
|
+
* old_sprints/<sprintId>.json, apra-fleet-eft.37.1) and renders a compact
|
|
223
|
+
* read-only page. Returns `null` when no terminal state exists (caller
|
|
224
|
+
* answers 404). eft.6.5 replaces this with the full History-view rendering;
|
|
225
|
+
* kept minimal here so the fallthrough is never a dead proxy and never a 404
|
|
226
|
+
* for a finished sprint.
|
|
227
|
+
* @param {string} sprintId
|
|
228
|
+
* @param {NodeJS.ProcessEnv} env
|
|
229
|
+
* @param {(p: string, enc: string) => Promise<string>} [readFile]
|
|
230
|
+
* @returns {Promise<string|null>}
|
|
231
|
+
*/
|
|
232
|
+
export async function defaultRenderHistory(sprintId, env, readFile) {
|
|
233
|
+
const read = readFile ?? fsp.readFile;
|
|
234
|
+
const filePath = getTerminalRunStatePath(sprintId, env);
|
|
235
|
+
let raw;
|
|
236
|
+
try {
|
|
237
|
+
raw = await read(filePath, 'utf-8');
|
|
238
|
+
} catch (err) {
|
|
239
|
+
if (err && err.code === 'ENOENT') return null;
|
|
240
|
+
throw err;
|
|
241
|
+
}
|
|
242
|
+
let state = null;
|
|
243
|
+
try { state = JSON.parse(raw); } catch { state = null; }
|
|
244
|
+
return renderReadOnlyHistoryHtml(sprintId, state);
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
/**
|
|
248
|
+
* Renders the compact read-only historical page for a finished sprint. Contains
|
|
249
|
+
* NO `/events` (SSE) or `/stop` controls -- it is a static, process-free view,
|
|
250
|
+
* so nothing here re-enters the proxy or targets a now-dead child port.
|
|
251
|
+
* @param {string} sprintId
|
|
252
|
+
* @param {object|null} state - parsed terminal state (old_runs/, or legacy
|
|
253
|
+
* old_sprints/, apra-fleet-eft.37.1) <sprintId>.json, if available
|
|
254
|
+
* @returns {string}
|
|
255
|
+
*/
|
|
256
|
+
export function renderReadOnlyHistoryHtml(sprintId, state) {
|
|
257
|
+
const id = escapeHtml(sprintId);
|
|
258
|
+
const s = state && typeof state === 'object' ? state : {};
|
|
259
|
+
const reason = s.terminalReason ? escapeHtml(String(s.terminalReason)) : 'unknown';
|
|
260
|
+
const startedAt = s.startedAt ? escapeHtml(String(s.startedAt)) : 'unknown';
|
|
261
|
+
const endedAt = s.endedAt ? escapeHtml(String(s.endedAt)) : 'unknown';
|
|
262
|
+
const status = s.status ? escapeHtml(String(s.status)) : 'unknown';
|
|
263
|
+
return (
|
|
264
|
+
'<!DOCTYPE html>\n' +
|
|
265
|
+
'<html lang="en">\n' +
|
|
266
|
+
'<head>\n' +
|
|
267
|
+
'<meta charset="utf-8"/>\n' +
|
|
268
|
+
'<title>Sprint ' + id + ' -- historical (read-only)</title>\n' +
|
|
269
|
+
'<style>body{background:#18181b;color:#e4e4e7;font-family:system-ui,sans-serif;margin:24px;}' +
|
|
270
|
+
'a{color:#60a5fa;}.tag{color:#a1a1aa;}</style>\n' +
|
|
271
|
+
'</head>\n' +
|
|
272
|
+
'<body data-view="history" data-sprint-id="' + id + '">\n' +
|
|
273
|
+
'<p><a href="/">← Back to supervisor</a></p>\n' +
|
|
274
|
+
'<h1>Sprint ' + id + '</h1>\n' +
|
|
275
|
+
'<p><strong>Historical, read-only view.</strong> This sprint has finished; ' +
|
|
276
|
+
'its live process is gone, so there is nothing to stream.</p>\n' +
|
|
277
|
+
'<ul>\n' +
|
|
278
|
+
'<li><span class="tag">Status:</span> ' + status + '</li>\n' +
|
|
279
|
+
'<li><span class="tag">Terminal reason:</span> ' + reason + '</li>\n' +
|
|
280
|
+
'<li><span class="tag">Started:</span> ' + startedAt + '</li>\n' +
|
|
281
|
+
'<li><span class="tag">Ended:</span> ' + endedAt + '</li>\n' +
|
|
282
|
+
'</ul>\n' +
|
|
283
|
+
'</body>\n' +
|
|
284
|
+
'</html>\n'
|
|
285
|
+
);
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/**
|
|
289
|
+
* Create the live-view reverse proxy. Collaborators are injected so tests can
|
|
290
|
+
* drive a fake child server and a fixed history renderer.
|
|
291
|
+
*
|
|
292
|
+
* @param {{
|
|
293
|
+
* ledger?: { get: (sprintId: string) => ({ childPid: number|null }|undefined) },
|
|
294
|
+
* spawner?: { getLiveEntry: (pid: number) => ({ port: number }|undefined) },
|
|
295
|
+
* resolvePort?: (sprintId: string) => number|undefined,
|
|
296
|
+
* renderHistory?: (sprintId: string) => Promise<string|null>|string|null,
|
|
297
|
+
* host?: string,
|
|
298
|
+
* env?: NodeJS.ProcessEnv,
|
|
299
|
+
* readFile?: (p: string, enc: string) => Promise<string>,
|
|
300
|
+
* logger?: { log?: Function, error?: Function },
|
|
301
|
+
* }} [deps]
|
|
302
|
+
* @returns {{
|
|
303
|
+
* name: string,
|
|
304
|
+
* resolvePort: (sprintId: string) => number|undefined,
|
|
305
|
+
* handleBase: Function,
|
|
306
|
+
* handleEvents: Function,
|
|
307
|
+
* handleState: Function,
|
|
308
|
+
* handleStop: Function,
|
|
309
|
+
* handleSaveLogs: Function,
|
|
310
|
+
* }}
|
|
311
|
+
*/
|
|
312
|
+
export function createLiveProxy(deps = {}) {
|
|
313
|
+
const ledger = deps.ledger ?? null;
|
|
314
|
+
const spawner = deps.spawner ?? null;
|
|
315
|
+
const host = deps.host ?? '127.0.0.1';
|
|
316
|
+
const env = deps.env ?? process.env;
|
|
317
|
+
// apra-fleet-k7b.2: ISO-timestamp-prefix every log line from this module.
|
|
318
|
+
const logger = withTimestamps(deps.logger ?? console);
|
|
319
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
320
|
+
|
|
321
|
+
// Default port resolution: sprintId -> ledger childPid -> spawner live port
|
|
322
|
+
// (child-port.mjs, shared with the dashboard's per-row summary pull). The
|
|
323
|
+
// ledger deliberately does NOT persist ports; the spawner is the live
|
|
324
|
+
// pid->port bookkeeping (freshly spawned OR re-adopted across a restart), so
|
|
325
|
+
// a finished/crashed child (no live entry) resolves to `undefined` and the
|
|
326
|
+
// request falls through to history.
|
|
327
|
+
const defaultResolvePort = createChildPortResolver({ ledger, spawner });
|
|
328
|
+
const resolvePort = deps.resolvePort ?? defaultResolvePort;
|
|
329
|
+
|
|
330
|
+
const renderHistory = deps.renderHistory
|
|
331
|
+
?? ((sprintId) => defaultRenderHistory(sprintId, env, deps.readFile));
|
|
332
|
+
|
|
333
|
+
/** Resolve a live port, isolating any injected-resolver failure as "no live". */
|
|
334
|
+
function safeResolvePort(sprintId) {
|
|
335
|
+
try {
|
|
336
|
+
return resolvePort(sprintId);
|
|
337
|
+
} catch (err) {
|
|
338
|
+
logError('[proxy] resolvePort failed for', sprintId, err);
|
|
339
|
+
return undefined;
|
|
340
|
+
}
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
/** Render + send the read-only historical view; 404 when no history exists. */
|
|
344
|
+
async function serveHistory(sprintId, res) {
|
|
345
|
+
let html = null;
|
|
346
|
+
try {
|
|
347
|
+
html = await renderHistory(sprintId);
|
|
348
|
+
} catch (err) {
|
|
349
|
+
logError('[proxy] history render failed for', sprintId, err);
|
|
350
|
+
}
|
|
351
|
+
if (html == null) {
|
|
352
|
+
sendPlain(res, 404, `No live sprint or history for '${sprintId}'.`);
|
|
353
|
+
return;
|
|
354
|
+
}
|
|
355
|
+
const body = Buffer.from(html, 'utf-8');
|
|
356
|
+
res.writeHead(200, {
|
|
357
|
+
'content-type': 'text/html; charset=utf-8',
|
|
358
|
+
'content-length': body.length,
|
|
359
|
+
});
|
|
360
|
+
res.end(body);
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
// GET /sprints/:id/live -- the live HTML, or the history fallthrough.
|
|
364
|
+
async function handleBase(req, res, ctx) {
|
|
365
|
+
const sprintId = ctx?.params?.id;
|
|
366
|
+
if (!sprintId) { sendPlain(res, 400, 'missing sprint id in path'); return; }
|
|
367
|
+
const port = safeResolvePort(sprintId);
|
|
368
|
+
if (!Number.isInteger(port)) {
|
|
369
|
+
await serveHistory(sprintId, res);
|
|
370
|
+
return;
|
|
371
|
+
}
|
|
372
|
+
proxyHtml({
|
|
373
|
+
host, port, req, res,
|
|
374
|
+
prefix: livePrefixFor(sprintId),
|
|
375
|
+
logError,
|
|
376
|
+
// A live entry existed but the child is unreachable (raced with exit):
|
|
377
|
+
// fall through to history rather than serve a dead proxy.
|
|
378
|
+
onConnectError: () => { serveHistory(sprintId, res).catch((e) => logError(e)); },
|
|
379
|
+
});
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
// Subpath handlers proxy their fixed child endpoint. A request arriving after
|
|
383
|
+
// the child is gone answers cleanly (no dead socket); the read-only history
|
|
384
|
+
// page makes no such calls, so this only happens if a sprint ends mid-view.
|
|
385
|
+
function makeSubpath(childPathFor) {
|
|
386
|
+
return async (req, res, ctx) => {
|
|
387
|
+
const sprintId = ctx?.params?.id;
|
|
388
|
+
if (!sprintId) { sendPlain(res, 400, 'missing sprint id in path'); return; }
|
|
389
|
+
const port = safeResolvePort(sprintId);
|
|
390
|
+
if (!Number.isInteger(port)) {
|
|
391
|
+
sendPlain(res, 404, `sprint '${sprintId}' is no longer live`);
|
|
392
|
+
return;
|
|
393
|
+
}
|
|
394
|
+
proxyStream({ host, port, childPath: childPathFor(ctx?.url), req, res, logError });
|
|
395
|
+
};
|
|
396
|
+
}
|
|
397
|
+
|
|
398
|
+
const handleEvents = makeSubpath(() => '/events');
|
|
399
|
+
const handleState = makeSubpath((url) => '/state' + (url && url.search ? url.search : ''));
|
|
400
|
+
const handleStop = makeSubpath(() => '/stop');
|
|
401
|
+
// (apra-fleet-p2to.3.1) Proxy the child's own cooperative POST /pause and
|
|
402
|
+
// /resume (apra-fleet-p2to.2.1, viewer/index.mjs), which forward to the
|
|
403
|
+
// engine's requestPause()/requestResume() -- NEVER the kill+force-release
|
|
404
|
+
// route the Sprint Stack's Stop button uses (POST /api/reservations/
|
|
405
|
+
// :sprintId/force-release, dashboard.mjs). Same makeSubpath() plumbing as
|
|
406
|
+
// handleStop above: a request arriving after the child is gone answers
|
|
407
|
+
// 404 cleanly rather than a dead socket.
|
|
408
|
+
const handlePause = makeSubpath(() => '/pause');
|
|
409
|
+
const handleResume = makeSubpath(() => '/resume');
|
|
410
|
+
const handleSaveLogs = makeSubpath(() => '/save_logs');
|
|
411
|
+
|
|
412
|
+
// apra-fleet-04g.1: the generic on-demand-detail route (extension id +
|
|
413
|
+
// item id both come from the URL, unlike the fixed-path subpaths above) and
|
|
414
|
+
// the activity tree's full-output route. Both are GET, no request body.
|
|
415
|
+
async function handleExtensionDetail(req, res, ctx) {
|
|
416
|
+
const sprintId = ctx?.params?.id;
|
|
417
|
+
if (!sprintId) { sendPlain(res, 400, 'missing sprint id in path'); return; }
|
|
418
|
+
const port = safeResolvePort(sprintId);
|
|
419
|
+
if (!Number.isInteger(port)) {
|
|
420
|
+
sendPlain(res, 404, `sprint '${sprintId}' is no longer live`);
|
|
421
|
+
return;
|
|
422
|
+
}
|
|
423
|
+
const childPath = '/extensions/' + encodeURIComponent(ctx?.params?.extId ?? '')
|
|
424
|
+
+ '/detail/' + encodeURIComponent(ctx?.params?.itemId ?? '');
|
|
425
|
+
proxyStream({ host, port, childPath, req, res, logError });
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
async function handleActivityOutput(req, res, ctx) {
|
|
429
|
+
const sprintId = ctx?.params?.id;
|
|
430
|
+
if (!sprintId) { sendPlain(res, 400, 'missing sprint id in path'); return; }
|
|
431
|
+
const port = safeResolvePort(sprintId);
|
|
432
|
+
if (!Number.isInteger(port)) {
|
|
433
|
+
sendPlain(res, 404, `sprint '${sprintId}' is no longer live`);
|
|
434
|
+
return;
|
|
435
|
+
}
|
|
436
|
+
const childPath = '/activities/' + encodeURIComponent(ctx?.params?.activityId ?? '') + '/output';
|
|
437
|
+
proxyStream({ host, port, childPath, req, res, logError });
|
|
438
|
+
}
|
|
439
|
+
|
|
440
|
+
return {
|
|
441
|
+
name: 'live-proxy',
|
|
442
|
+
resolvePort: safeResolvePort,
|
|
443
|
+
serveHistory,
|
|
444
|
+
handleBase,
|
|
445
|
+
handleEvents,
|
|
446
|
+
handleState,
|
|
447
|
+
handleStop,
|
|
448
|
+
handlePause,
|
|
449
|
+
handleResume,
|
|
450
|
+
handleSaveLogs,
|
|
451
|
+
handleExtensionDetail,
|
|
452
|
+
handleActivityOutput,
|
|
453
|
+
};
|
|
454
|
+
}
|
|
455
|
+
|
|
456
|
+
/**
|
|
457
|
+
* Register the live-view routes against a supervisor (server.mjs), mirroring the
|
|
458
|
+
* registration pattern of registerReservationRoutes()/registerDashboardRoutes().
|
|
459
|
+
* @param {{ route: (method: string, path: string, handler: Function) => void }} supervisor
|
|
460
|
+
* @param {ReturnType<typeof createLiveProxy>} proxy
|
|
461
|
+
*/
|
|
462
|
+
export function registerLiveRoutes(supervisor, proxy) {
|
|
463
|
+
supervisor.route('GET', '/sprints/:id/live', proxy.handleBase);
|
|
464
|
+
supervisor.route('GET', '/sprints/:id/live/events', proxy.handleEvents);
|
|
465
|
+
supervisor.route('GET', '/sprints/:id/live/state', proxy.handleState);
|
|
466
|
+
supervisor.route('POST', '/sprints/:id/live/stop', proxy.handleStop);
|
|
467
|
+
// (apra-fleet-p2to.3.1) Cooperative pause/resume proxy routes -- see
|
|
468
|
+
// createLiveProxy()'s handlePause/handleResume doc comment above.
|
|
469
|
+
supervisor.route('POST', '/sprints/:id/live/pause', proxy.handlePause);
|
|
470
|
+
supervisor.route('POST', '/sprints/:id/live/resume', proxy.handleResume);
|
|
471
|
+
supervisor.route('POST', '/sprints/:id/live/save_logs', proxy.handleSaveLogs);
|
|
472
|
+
supervisor.route('GET', '/sprints/:id/live/extensions/:extId/detail/:itemId', proxy.handleExtensionDetail);
|
|
473
|
+
supervisor.route('GET', '/sprints/:id/live/activities/:activityId/output', proxy.handleActivityOutput);
|
|
474
|
+
}
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- restart re-adoption of live children by PID
|
|
3
|
+
// (apra-fleet-eft.4.5, Plan Part 2.2, pairs with eft.5.4's restart reconciler)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// eft.5.4's reconciler (./reconcile.mjs) already does the PID-probe pass on
|
|
7
|
+
// every restart: a DEAD ledger entry releases both reservation axes and is
|
|
8
|
+
// marked aborted-by-restart, while a LIVE entry is left untouched in the
|
|
9
|
+
// ledger for re-adoption. This module is that re-adoption: it drives the
|
|
10
|
+
// reconciler, then for every retained (still-live) sprint recovers the
|
|
11
|
+
// child's --viewer-port -- the ONE piece of state the ledger deliberately
|
|
12
|
+
// does NOT persist (see ledger.mjs's Reservation typedef and spawner.mjs's
|
|
13
|
+
// own doc comment) -- by reading the live process's own command line and
|
|
14
|
+
// registering it with the spawner seam.
|
|
15
|
+
//
|
|
16
|
+
// That registration is what makes a re-adopted child "tracked" in exactly the
|
|
17
|
+
// same sense as a freshly-spawned one: spawner.getLiveEntry(pid) now resolves
|
|
18
|
+
// its port, so the watchdog (eft.4.3) can HTTP-probe it and the sprints API
|
|
19
|
+
// (eft.4.4, GET /api/sprints) can proxy its live `/state`.
|
|
20
|
+
//
|
|
21
|
+
// Confirmed scope (per the task): detach-and-PID-readopt only. Sprints do NOT
|
|
22
|
+
// need to survive a machine restart (only a supervisor-process restart), and
|
|
23
|
+
// there is no IPC and no journal/replay productization -- re-adoption reads
|
|
24
|
+
// ONLY the persisted ledger plus PID probing (via the reconciler) plus a
|
|
25
|
+
// best-effort read of the live process's own command line.
|
|
26
|
+
// =============================================================================
|
|
27
|
+
|
|
28
|
+
import { readProcessCmdline } from './watchdog.mjs';
|
|
29
|
+
import { withTimestamps } from './log-timestamp.mjs';
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Extracts the `--viewer-port <N>` value from a process command line string
|
|
33
|
+
* (as produced by readProcessCmdline()). Returns `null` when the flag is
|
|
34
|
+
* absent, malformed, or the parsed value is not a valid TCP port -- callers
|
|
35
|
+
* treat `null` as "port could not be recovered", never as port 0/falsy.
|
|
36
|
+
* @param {string|null} cmdline
|
|
37
|
+
* @returns {number|null}
|
|
38
|
+
*/
|
|
39
|
+
export function parseViewerPortFromCmdline(cmdline) {
|
|
40
|
+
if (typeof cmdline !== 'string' || cmdline.length === 0) return null;
|
|
41
|
+
const match = cmdline.match(/--viewer-port[\s=]+(\d+)/);
|
|
42
|
+
if (!match) return null;
|
|
43
|
+
const port = Number(match[1]);
|
|
44
|
+
return Number.isInteger(port) && port > 0 && port <= 65535 ? port : null;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Creates the restart re-adopter. Every collaborator is injected so a test
|
|
49
|
+
* can drive deterministic PID/cmdline signals without real processes.
|
|
50
|
+
*
|
|
51
|
+
* @param {{
|
|
52
|
+
* ledger: { get: (sprintId: string) => { childPid: number|null }|undefined },
|
|
53
|
+
* spawner: { adopt: (pid: number, port: number) => void },
|
|
54
|
+
* reconciler: { reconcile: () => Promise<{ released: string[], retained: string[] }> },
|
|
55
|
+
* readCmdline?: (pid: number) => string|null|Promise<string|null>,
|
|
56
|
+
* logger?: { log?: Function, warn?: Function, error?: Function },
|
|
57
|
+
* }} deps
|
|
58
|
+
* @returns {{
|
|
59
|
+
* name: string,
|
|
60
|
+
* readopt(): Promise<{ released: string[], retained: string[], adopted: Array<{ sprintId: string, childPid: number, port: number }>, unresolved: string[] }>,
|
|
61
|
+
* }}
|
|
62
|
+
*/
|
|
63
|
+
export function createReadopter(deps = {}) {
|
|
64
|
+
const ledger = deps.ledger;
|
|
65
|
+
const spawner = deps.spawner;
|
|
66
|
+
const reconciler = deps.reconciler;
|
|
67
|
+
if (!ledger || typeof ledger.get !== 'function') {
|
|
68
|
+
throw new TypeError('createReadopter requires a ledger with a get() method');
|
|
69
|
+
}
|
|
70
|
+
if (!spawner || typeof spawner.adopt !== 'function') {
|
|
71
|
+
throw new TypeError('createReadopter requires a spawner with an adopt() method');
|
|
72
|
+
}
|
|
73
|
+
if (!reconciler || typeof reconciler.reconcile !== 'function') {
|
|
74
|
+
throw new TypeError('createReadopter requires a reconciler with a reconcile() method');
|
|
75
|
+
}
|
|
76
|
+
const readCmdline = deps.readCmdline ?? readProcessCmdline;
|
|
77
|
+
// apra-fleet-k7b.2: ISO-timestamp-prefix every log line from this module.
|
|
78
|
+
const logger = withTimestamps(deps.logger ?? console);
|
|
79
|
+
const log = (...a) => logger.log?.(...a);
|
|
80
|
+
const logWarn = (...a) => (logger.warn ?? logger.log)?.(...a);
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* Runs the full restart re-adoption pass, ONCE, at supervisor startup:
|
|
84
|
+
* 1. Drive eft.5.4's reconciler -- dead entries release both axes and
|
|
85
|
+
* are marked aborted-by-restart; live entries are retained as-is.
|
|
86
|
+
* 2. For every retained (live) sprint, recover its --viewer-port from
|
|
87
|
+
* the live process's own command line and register it with the
|
|
88
|
+
* spawner so the sprint is tracked/watchdog-monitored/HTTP-proxyable
|
|
89
|
+
* exactly like a freshly-spawned child.
|
|
90
|
+
* A live sprint whose port cannot be recovered (unreadable cmdline, e.g.
|
|
91
|
+
* no /proc on this platform, or a permission error) is left retained in
|
|
92
|
+
* the ledger -- it is still counted live for the purpose of NOT auto-
|
|
93
|
+
* aborting it -- but is reported back as `unresolved` rather than thrown,
|
|
94
|
+
* since a best-effort port-recovery failure must never crash startup or
|
|
95
|
+
* silently drop the reservation.
|
|
96
|
+
* @returns {Promise<{ released: string[], retained: string[], adopted: Array<object>, unresolved: string[] }>}
|
|
97
|
+
*/
|
|
98
|
+
async function readopt() {
|
|
99
|
+
const { released, retained } = await reconciler.reconcile();
|
|
100
|
+
|
|
101
|
+
const adopted = [];
|
|
102
|
+
const unresolved = [];
|
|
103
|
+
for (const sprintId of retained) {
|
|
104
|
+
const entry = ledger.get(sprintId);
|
|
105
|
+
const pid = entry?.childPid ?? null;
|
|
106
|
+
if (pid == null) {
|
|
107
|
+
logWarn(`[readopt] restart: live sprint '${sprintId}' has no recorded childPid -- cannot re-adopt.`);
|
|
108
|
+
unresolved.push(sprintId);
|
|
109
|
+
continue;
|
|
110
|
+
}
|
|
111
|
+
const cmdline = await readCmdline(pid);
|
|
112
|
+
const port = parseViewerPortFromCmdline(cmdline);
|
|
113
|
+
if (port == null) {
|
|
114
|
+
logWarn(
|
|
115
|
+
`[readopt] restart: could not recover --viewer-port for re-adopted sprint '${sprintId}' `
|
|
116
|
+
+ `(pid ${pid}) from its command line -- it stays reserved but is not yet HTTP-proxyable.`,
|
|
117
|
+
);
|
|
118
|
+
unresolved.push(sprintId);
|
|
119
|
+
continue;
|
|
120
|
+
}
|
|
121
|
+
spawner.adopt(pid, port);
|
|
122
|
+
adopted.push({ sprintId, childPid: pid, port });
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
log(
|
|
126
|
+
`[readopt] restart: re-adopted ${adopted.length} live sprint(s) by PID `
|
|
127
|
+
+ `(${released.length} dead released, ${unresolved.length} live but port-unresolved)`,
|
|
128
|
+
);
|
|
129
|
+
return { released, retained, adopted, unresolved };
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
return {
|
|
133
|
+
name: 'readopter',
|
|
134
|
+
readopt,
|
|
135
|
+
};
|
|
136
|
+
}
|