@apralabs/apra-fleet 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +53 -5
- package/dist/tools/check-status.js +210 -53
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +30 -10
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- the supervisor's OWN stdout/stderr, captured and
|
|
3
|
+
// served (companion to log-view.mjs, which does the same for a sprint CHILD's
|
|
4
|
+
// output). Before this, the supervisor's own console.log/error output only
|
|
5
|
+
// existed wherever the launching shell happened to redirect it (or nowhere,
|
|
6
|
+
// for an interactive run) -- there was no operator-facing way to see it, and
|
|
7
|
+
// no timestamps on individual lines to correlate against sprint activity.
|
|
8
|
+
// =============================================================================
|
|
9
|
+
|
|
10
|
+
import fs from 'node:fs';
|
|
11
|
+
import path from 'node:path';
|
|
12
|
+
import { defaultDataDir, SPRINT_LOG_SUBDIR } from './spawner.mjs';
|
|
13
|
+
import { sendPlain } from './history-view.mjs';
|
|
14
|
+
import { tailLines } from './log-view.mjs';
|
|
15
|
+
|
|
16
|
+
/** Filename for the supervisor's own log, under the same logs/ dir sprint children's raw logs live in. */
|
|
17
|
+
export const SELF_LOG_FILE_NAME = 'supervisor.log';
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* @param {string} [dataDir]
|
|
21
|
+
* @returns {string} `<dataDir>/logs/supervisor.log`
|
|
22
|
+
*/
|
|
23
|
+
export function resolveSelfLogPath(dataDir = defaultDataDir()) {
|
|
24
|
+
return path.join(dataDir, SPRINT_LOG_SUBDIR, SELF_LOG_FILE_NAME);
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* Local-time (not UTC) timestamp for a log line, `YYYY-MM-DD HH:mm:ss.sss`.
|
|
29
|
+
* `Date#toISOString()` is deliberately not used here -- it is always UTC,
|
|
30
|
+
* which is the wrong read for an operator correlating this log against
|
|
31
|
+
* their own wall clock while watching a live sprint.
|
|
32
|
+
* @param {Date} [d]
|
|
33
|
+
* @returns {string}
|
|
34
|
+
*/
|
|
35
|
+
export function formatLocalTimestamp(d = new Date()) {
|
|
36
|
+
const pad = (n, len = 2) => String(n).padStart(len, '0');
|
|
37
|
+
return (
|
|
38
|
+
`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` +
|
|
39
|
+
`${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${pad(d.getMilliseconds(), 3)}`
|
|
40
|
+
);
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* Installs a timestamped tee on console.log/warn/error: every call still
|
|
45
|
+
* reaches the original console method (so an interactive run or a shell
|
|
46
|
+
* redirect still sees output as before) AND is appended, prefixed with a
|
|
47
|
+
* local-time timestamp, to the self-log file. Returns a `stop()` that
|
|
48
|
+
* restores the original console methods and closes the file.
|
|
49
|
+
*
|
|
50
|
+
* @param {{ dataDir?: string, consoleObj?: Console, now?: () => Date, fsImpl?: typeof fs }} [opts]
|
|
51
|
+
* @returns {{ logPath: string, stop: () => void }}
|
|
52
|
+
*/
|
|
53
|
+
export function installSelfLogTee(opts = {}) {
|
|
54
|
+
const dataDir = opts.dataDir ?? defaultDataDir();
|
|
55
|
+
const consoleObj = opts.consoleObj ?? console;
|
|
56
|
+
const now = opts.now ?? (() => new Date());
|
|
57
|
+
const fsImpl = opts.fsImpl ?? fs;
|
|
58
|
+
|
|
59
|
+
const logPath = resolveSelfLogPath(dataDir);
|
|
60
|
+
fsImpl.mkdirSync(path.dirname(logPath), { recursive: true });
|
|
61
|
+
const stream = fsImpl.createWriteStream(logPath, { flags: 'a' });
|
|
62
|
+
|
|
63
|
+
const original = { log: consoleObj.log, warn: consoleObj.warn, error: consoleObj.error };
|
|
64
|
+
const wrap = (level, orig) => (...args) => {
|
|
65
|
+
orig.apply(consoleObj, args);
|
|
66
|
+
try {
|
|
67
|
+
const line = args.map((a) => (typeof a === 'string' ? a : inspectArg(a))).join(' ');
|
|
68
|
+
stream.write(`[${formatLocalTimestamp(now())}] [${level}] ${line}\n`);
|
|
69
|
+
} catch {
|
|
70
|
+
// Never let a formatting/write failure take down the supervisor
|
|
71
|
+
// over a logging side channel -- the original console call above
|
|
72
|
+
// already happened either way.
|
|
73
|
+
}
|
|
74
|
+
};
|
|
75
|
+
consoleObj.log = wrap('info', original.log);
|
|
76
|
+
consoleObj.warn = wrap('warn', original.warn);
|
|
77
|
+
consoleObj.error = wrap('error', original.error);
|
|
78
|
+
|
|
79
|
+
return {
|
|
80
|
+
logPath,
|
|
81
|
+
stop() {
|
|
82
|
+
consoleObj.log = original.log;
|
|
83
|
+
consoleObj.warn = original.warn;
|
|
84
|
+
consoleObj.error = original.error;
|
|
85
|
+
stream.end();
|
|
86
|
+
},
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/** Minimal stand-in for util.inspect for the rare non-string console arg (an Error, an object), without pulling in the full module. */
|
|
91
|
+
function inspectArg(a) {
|
|
92
|
+
if (a instanceof Error) return a.stack || a.message;
|
|
93
|
+
try { return JSON.stringify(a); } catch { return String(a); }
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* Create the self-log HTTP view: `GET /supervisor/log`, mirroring log-view.mjs's
|
|
98
|
+
* per-sprint route (same `?tail=N` support, same plain-text response).
|
|
99
|
+
* @param {{ logPath: string, readFile?: (p: string, enc: string) => Promise<string> }} deps
|
|
100
|
+
*/
|
|
101
|
+
export function createSelfLogView({ logPath, readFile } = {}) {
|
|
102
|
+
if (!logPath) throw new TypeError('createSelfLogView requires a logPath');
|
|
103
|
+
const read = readFile ?? ((p, enc) => fs.promises.readFile(p, enc));
|
|
104
|
+
|
|
105
|
+
async function handleGet(req, res, ctx) {
|
|
106
|
+
let content;
|
|
107
|
+
try {
|
|
108
|
+
content = await read(logPath, 'utf-8');
|
|
109
|
+
} catch (err) {
|
|
110
|
+
if (err && err.code === 'ENOENT') {
|
|
111
|
+
sendPlain(res, 404, 'Supervisor log not found yet -- nothing has been logged since this route was registered.');
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
sendPlain(res, 500, `failed to read supervisor log: ${err.message}`);
|
|
115
|
+
return;
|
|
116
|
+
}
|
|
117
|
+
const tailParam = ctx?.url?.searchParams?.get('tail');
|
|
118
|
+
const tailN = tailParam != null ? Number(tailParam) : NaN;
|
|
119
|
+
const body = Number.isInteger(tailN) && tailN > 0 ? tailLines(content, tailN) : content;
|
|
120
|
+
sendPlain(res, 200, body);
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
return { name: 'self-log', handleGet };
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* Registers `GET /supervisor/log` against a supervisor (server.mjs).
|
|
128
|
+
* @param {{ route: (method: string, path: string, handler: Function) => void }} supervisor
|
|
129
|
+
* @param {ReturnType<typeof createSelfLogView>} view
|
|
130
|
+
*/
|
|
131
|
+
export function registerSelfLogRoutes(supervisor, view) {
|
|
132
|
+
supervisor.route('GET', '/supervisor/log', view.handleGet);
|
|
133
|
+
}
|
|
@@ -0,0 +1,399 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- HTTP server skeleton (Plan Part 2.1, process model B)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// This module stands up the always-on `fleet-se serve` supervisor process.
|
|
6
|
+
// Per the confirmed design (process model B, fork()/IPC explicitly rejected):
|
|
7
|
+
//
|
|
8
|
+
// * A single long-lived process owns the reservation ledger and an HTTP API.
|
|
9
|
+
// * It spawns the existing bin/cli.mjs per sprint as a DETACHED child
|
|
10
|
+
// (spawn({ detached: true, stdio: 'ignore' })) -- there is deliberately NO
|
|
11
|
+
// parent-child IPC channel; children are independently-surviving orphans.
|
|
12
|
+
// A crashed sprint can never take down a sibling or this supervisor.
|
|
13
|
+
// * The supervisor runs INDEFINITELY. It exits ONLY on POST /api/shutdown or
|
|
14
|
+
// an explicit signal (SIGINT/SIGTERM) -- never because a sprint finished,
|
|
15
|
+
// and never because a child crashed.
|
|
16
|
+
//
|
|
17
|
+
// -----------------------------------------------------------------------------
|
|
18
|
+
// MODULE SEAMS (this is the boundary other eft.4 / eft.5 / eft.6 tasks plug in)
|
|
19
|
+
// -----------------------------------------------------------------------------
|
|
20
|
+
// `createSupervisor()` accepts four collaborators by dependency injection. This
|
|
21
|
+
// skeleton ships inert default stubs for each so `fleet-se serve` boots and
|
|
22
|
+
// stays up on its own; later tasks replace the stubs with real implementations
|
|
23
|
+
// without touching this file's lifecycle/HTTP-bootstrap logic:
|
|
24
|
+
//
|
|
25
|
+
// ledger -- the persisted reservation ledger of live sprints (eft.5). The
|
|
26
|
+
// durable source of truth a restarted supervisor re-adopts from.
|
|
27
|
+
// spawner -- the detached child-per-sprint spawner (eft.4.2): allocates a
|
|
28
|
+
// per-sprint --viewer-port and launches bin/cli.mjs detached.
|
|
29
|
+
// watchdog -- the PID-liveness watchdog + four-status classifier (eft.4.3):
|
|
30
|
+
// running-healthy / running-unresponsive / crashed / finished.
|
|
31
|
+
// dashboard -- the operator dashboard / static+proxy HTTP surface (eft.6).
|
|
32
|
+
//
|
|
33
|
+
// Each seam is a plain object; this skeleton only calls each collaborator's
|
|
34
|
+
// optional `start()` / `stop()` lifecycle hooks (if present) so wiring later
|
|
35
|
+
// implementations in is a drop-in. The richer HTTP endpoints (GET /api/members,
|
|
36
|
+
// /api/backlog, POST /api/sprints, etc.) are added by eft.4.4 by registering
|
|
37
|
+
// routes via `supervisor.route()`; this skeleton implements only the two the
|
|
38
|
+
// lifecycle itself owns: POST /api/shutdown and GET /api/health.
|
|
39
|
+
// =============================================================================
|
|
40
|
+
|
|
41
|
+
import http from 'node:http';
|
|
42
|
+
import { toBeadsSummary } from './beads-identity.mjs';
|
|
43
|
+
|
|
44
|
+
/** Default HTTP service port for the always-on supervisor. */
|
|
45
|
+
export const DEFAULT_SERVICE_PORT = 8787;
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* An inert seam stub. Later eft tasks pass real implementations; until then the
|
|
49
|
+
* supervisor boots against these no-ops so `fleet-se serve` is independently
|
|
50
|
+
* runnable. Named so logs/introspection make the "not yet wired" state obvious.
|
|
51
|
+
* @param {string} name
|
|
52
|
+
* @returns {{ name: string, start(): Promise<void>, stop(): Promise<void> }}
|
|
53
|
+
*/
|
|
54
|
+
export function makeSeamStub(name) {
|
|
55
|
+
return {
|
|
56
|
+
name: `${name}:stub`,
|
|
57
|
+
async start() {},
|
|
58
|
+
async stop() {},
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Reads and JSON-parses a request body with a hard size cap so a hostile or
|
|
64
|
+
* buggy client cannot exhaust memory. Returns `undefined` for an empty body.
|
|
65
|
+
* @param {import('http').IncomingMessage} req
|
|
66
|
+
* @param {{ maxBytes?: number }} [opts]
|
|
67
|
+
* @returns {Promise<any>}
|
|
68
|
+
*/
|
|
69
|
+
export function readJsonBody(req, opts = {}) {
|
|
70
|
+
const maxBytes = opts.maxBytes ?? 1_000_000;
|
|
71
|
+
return new Promise((resolve, reject) => {
|
|
72
|
+
let size = 0;
|
|
73
|
+
const chunks = [];
|
|
74
|
+
req.on('data', (chunk) => {
|
|
75
|
+
size += chunk.length;
|
|
76
|
+
if (size > maxBytes) {
|
|
77
|
+
reject(new Error(`request body exceeds ${maxBytes} byte limit`));
|
|
78
|
+
req.destroy();
|
|
79
|
+
return;
|
|
80
|
+
}
|
|
81
|
+
chunks.push(chunk);
|
|
82
|
+
});
|
|
83
|
+
req.on('end', () => {
|
|
84
|
+
const raw = Buffer.concat(chunks).toString('utf-8').trim();
|
|
85
|
+
if (raw.length === 0) {
|
|
86
|
+
resolve(undefined);
|
|
87
|
+
return;
|
|
88
|
+
}
|
|
89
|
+
try {
|
|
90
|
+
resolve(JSON.parse(raw));
|
|
91
|
+
} catch (err) {
|
|
92
|
+
reject(new Error(`invalid JSON request body: ${err.message}`));
|
|
93
|
+
}
|
|
94
|
+
});
|
|
95
|
+
req.on('error', reject);
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/**
|
|
100
|
+
* Writes a JSON response. Centralized so every handler (and the error-isolation
|
|
101
|
+
* wrapper) emits a consistent shape.
|
|
102
|
+
* @param {import('http').ServerResponse} res
|
|
103
|
+
* @param {number} status
|
|
104
|
+
* @param {any} payload
|
|
105
|
+
*/
|
|
106
|
+
export function sendJson(res, status, payload) {
|
|
107
|
+
const body = JSON.stringify(payload ?? {});
|
|
108
|
+
res.writeHead(status, {
|
|
109
|
+
'content-type': 'application/json; charset=utf-8',
|
|
110
|
+
'content-length': Buffer.byteLength(body),
|
|
111
|
+
});
|
|
112
|
+
res.end(body);
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* Creates (but does not start) the always-on supervisor. Returns a handle whose
|
|
117
|
+
* `start()`/`stop()` own the full lifecycle; `route()` lets later tasks register
|
|
118
|
+
* additional endpoints against the same error-isolated dispatcher.
|
|
119
|
+
*
|
|
120
|
+
* @param {{
|
|
121
|
+
* port?: number,
|
|
122
|
+
* ledger?: object,
|
|
123
|
+
* spawner?: object,
|
|
124
|
+
* watchdog?: object,
|
|
125
|
+
* dashboard?: object,
|
|
126
|
+
* beadsIdentity?: { get: () => object|null, refresh: () => Promise<object> },
|
|
127
|
+
* backlogMember?: { get: () => { member: object|null, status: string, reason: string|null } },
|
|
128
|
+
* logger?: { log?: Function, error?: Function },
|
|
129
|
+
* createServer?: (handler: (req: any, res: any) => void) => import('http').Server,
|
|
130
|
+
* }} [deps]
|
|
131
|
+
* @returns {{
|
|
132
|
+
* route(method: string, path: string, handler: Function): void,
|
|
133
|
+
* start(): Promise<{ port: number }>,
|
|
134
|
+
* stop(reason?: string): Promise<void>,
|
|
135
|
+
* handleRequest(req: any, res: any): Promise<void>,
|
|
136
|
+
* server: import('http').Server,
|
|
137
|
+
* seams: { ledger: object, spawner: object, watchdog: object, dashboard: object },
|
|
138
|
+
* port: number,
|
|
139
|
+
* }}
|
|
140
|
+
*/
|
|
141
|
+
export function createSupervisor(deps = {}) {
|
|
142
|
+
let port = Number.isInteger(deps.port) ? deps.port : DEFAULT_SERVICE_PORT;
|
|
143
|
+
const logger = deps.logger ?? console;
|
|
144
|
+
const log = (...a) => logger.log?.(...a);
|
|
145
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
146
|
+
// Optional beads-identity handle (bin/serve.mjs wires the real one);
|
|
147
|
+
// read by GET /api/health below. Not a seam: it has no start()/stop().
|
|
148
|
+
const beadsIdentity = deps.beadsIdentity && typeof deps.beadsIdentity.get === 'function' ? deps.beadsIdentity : null;
|
|
149
|
+
// The "identity unknown" warning (getWarning() is optional on the handle
|
|
150
|
+
// so an older/test-only { get, refresh } stub still works).
|
|
151
|
+
const beadsWarningOf = (h) => (h && typeof h.getWarning === 'function' && !h.get() ? (h.getWarning() || null) : null);
|
|
152
|
+
// Optional backlog-member state handle (src/supervisor/backlog-member.mjs,
|
|
153
|
+
// wired by bin/serve.mjs); surfaced on GET /api/health as `backlogMember`
|
|
154
|
+
// only when wired, so an unwired health answer is unchanged.
|
|
155
|
+
const backlogMember = deps.backlogMember && typeof deps.backlogMember.get === 'function' ? deps.backlogMember : null;
|
|
156
|
+
const backlogMemberSummary = () => {
|
|
157
|
+
const st = backlogMember.get();
|
|
158
|
+
return { status: st.status, name: st.member ? st.member.name : null, reason: st.reason ?? null };
|
|
159
|
+
};
|
|
160
|
+
|
|
161
|
+
// Module seams -- inert stubs unless a real collaborator was injected.
|
|
162
|
+
const seams = {
|
|
163
|
+
ledger: deps.ledger ?? makeSeamStub('ledger'),
|
|
164
|
+
spawner: deps.spawner ?? makeSeamStub('spawner'),
|
|
165
|
+
watchdog: deps.watchdog ?? makeSeamStub('watchdog'),
|
|
166
|
+
dashboard: deps.dashboard ?? makeSeamStub('dashboard'),
|
|
167
|
+
// apra-fleet-eft.9.2/9.3: the cross-sprint coordination seams -- the
|
|
168
|
+
// global dolt push mutex (serializes every cross-sprint `bd dolt push`)
|
|
169
|
+
// and the child-id allocator (serial-per-parent id minting). Both are
|
|
170
|
+
// supervisor-owned singletons whose start()/stop() lifecycle (lease
|
|
171
|
+
// sweep timers, state persistence) is driven by the same seam machinery
|
|
172
|
+
// as every other collaborator; their HTTP routes are registered by
|
|
173
|
+
// their own register*Routes() helpers (see bin/serve.mjs).
|
|
174
|
+
doltMutex: deps.doltMutex ?? makeSeamStub('doltMutex'),
|
|
175
|
+
idAllocator: deps.idAllocator ?? makeSeamStub('idAllocator'),
|
|
176
|
+
// docs/dolt-sync-redesign.md Part 3.3: the backstop for the one case
|
|
177
|
+
// settle's own try/finally teardown cannot cover -- an orchestrator
|
|
178
|
+
// process killed mid-settle, leaving a detached ephemeral
|
|
179
|
+
// `dolt sql-server` holding a member's beads data-dir lock.
|
|
180
|
+
doltOrphanSweep: deps.doltOrphanSweep ?? makeSeamStub('doltOrphanSweep'),
|
|
181
|
+
};
|
|
182
|
+
|
|
183
|
+
/** @type {Map<string, Function>} keyed by `METHOD path` (exact paths). */
|
|
184
|
+
const routes = new Map();
|
|
185
|
+
const routeKey = (method, path) => `${method.toUpperCase()} ${path}`;
|
|
186
|
+
|
|
187
|
+
// Pattern routes carry `:param` segments (e.g. /api/reservations/:sprintId/
|
|
188
|
+
// force-release). They are kept separate from the exact-match Map and only
|
|
189
|
+
// consulted when an exact match misses, so existing exact routes are
|
|
190
|
+
// unaffected. Each `:name` segment matches exactly one non-empty path
|
|
191
|
+
// segment and is surfaced to the handler via ctx.params.
|
|
192
|
+
/** @type {Array<{ method: string, regex: RegExp, paramNames: string[], handler: Function }>} */
|
|
193
|
+
const patternRoutes = [];
|
|
194
|
+
|
|
195
|
+
function compilePattern(method, path) {
|
|
196
|
+
const paramNames = [];
|
|
197
|
+
const source = path.split('/').map((seg) => {
|
|
198
|
+
if (seg.startsWith(':')) {
|
|
199
|
+
paramNames.push(seg.slice(1));
|
|
200
|
+
return '([^/]+)';
|
|
201
|
+
}
|
|
202
|
+
// Escape regex metacharacters in literal segments.
|
|
203
|
+
return seg.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
204
|
+
}).join('/');
|
|
205
|
+
return { method: method.toUpperCase(), regex: new RegExp(`^${source}$`), paramNames };
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
function route(method, path, handler) {
|
|
209
|
+
if (path.includes('/:')) {
|
|
210
|
+
const { method: m, regex, paramNames } = compilePattern(method, path);
|
|
211
|
+
patternRoutes.push({ method: m, regex, paramNames, handler });
|
|
212
|
+
return;
|
|
213
|
+
}
|
|
214
|
+
routes.set(routeKey(method, path), handler);
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
function matchPattern(method, path) {
|
|
218
|
+
for (const pr of patternRoutes) {
|
|
219
|
+
if (pr.method !== method) continue;
|
|
220
|
+
const m = pr.regex.exec(path);
|
|
221
|
+
if (!m) continue;
|
|
222
|
+
const params = {};
|
|
223
|
+
pr.paramNames.forEach((name, i) => { params[name] = decodeURIComponent(m[i + 1]); });
|
|
224
|
+
return { handler: pr.handler, params };
|
|
225
|
+
}
|
|
226
|
+
return null;
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
let server;
|
|
230
|
+
let shutdownResolve;
|
|
231
|
+
// Promise that resolves once shutdown has been requested (via /api/shutdown
|
|
232
|
+
// or a signal) AND the HTTP server + seams are torn down. `start()` returns
|
|
233
|
+
// only the listening info; callers keep the process alive by awaiting the
|
|
234
|
+
// server, so the process exits solely on explicit shutdown -- never because
|
|
235
|
+
// a sprint finished or a child crashed.
|
|
236
|
+
const shutdownRequested = new Promise((resolve) => {
|
|
237
|
+
shutdownResolve = resolve;
|
|
238
|
+
});
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* The single request dispatcher. CRITICAL (acceptance criterion): an
|
|
242
|
+
* unhandled error inside ANY one request handler is caught here and turned
|
|
243
|
+
* into a 500 -- it must NEVER propagate out and exit the supervisor.
|
|
244
|
+
*/
|
|
245
|
+
async function handleRequest(req, res) {
|
|
246
|
+
const method = (req.method || 'GET').toUpperCase();
|
|
247
|
+
const url = new URL(req.url || '/', `http://localhost:${port}`);
|
|
248
|
+
const path = url.pathname;
|
|
249
|
+
|
|
250
|
+
try {
|
|
251
|
+
const handler = routes.get(routeKey(method, path));
|
|
252
|
+
if (handler) {
|
|
253
|
+
await handler(req, res, { url, params: {} });
|
|
254
|
+
return;
|
|
255
|
+
}
|
|
256
|
+
const matched = matchPattern(method, path);
|
|
257
|
+
if (!matched) {
|
|
258
|
+
sendJson(res, 404, { error: `no route for ${method} ${path}` });
|
|
259
|
+
return;
|
|
260
|
+
}
|
|
261
|
+
await matched.handler(req, res, { url, params: matched.params });
|
|
262
|
+
} catch (err) {
|
|
263
|
+
// Isolate the failure: log it, answer 500 if we still can, and
|
|
264
|
+
// keep the process alive.
|
|
265
|
+
logError(`[supervisor] request ${method} ${path} failed:`, err && err.stack ? err.stack : err);
|
|
266
|
+
if (!res.headersSent) {
|
|
267
|
+
sendJson(res, 500, { error: 'internal supervisor error' });
|
|
268
|
+
} else {
|
|
269
|
+
try { res.end(); } catch { /* already gone */ }
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
// -- Lifecycle-owned endpoints ------------------------------------------
|
|
275
|
+
|
|
276
|
+
// GET /api/health -- liveness probe; confirms the supervisor is up and
|
|
277
|
+
// reports which seams are still inert stubs.
|
|
278
|
+
//
|
|
279
|
+
// `beads` is the .beads identity this process resolved at startup
|
|
280
|
+
// (src/supervisor/beads-identity.mjs; { dir, prefix, syncRemote,
|
|
281
|
+
// repoRemote }, or null when no beadsIdentity dep was wired -- tests,
|
|
282
|
+
// the inert skeleton -- or when the identity is UNKNOWN: no .beads was
|
|
283
|
+
// found, or its probe failed; then `beadsWarning` carries the reason
|
|
284
|
+
// and the fix). `?refresh=1` re-runs the probes first; a probe failure
|
|
285
|
+
// keeps the last good identity and is reported as `beadsRefreshError`
|
|
286
|
+
// rather than failing the liveness answer.
|
|
287
|
+
route('GET', '/api/health', async (req, res, ctx) => {
|
|
288
|
+
let beadsRefreshError;
|
|
289
|
+
const refresh = ctx && ctx.url ? ctx.url.searchParams.get('refresh') : null;
|
|
290
|
+
if (beadsIdentity && refresh && refresh !== '0' && refresh !== 'false') {
|
|
291
|
+
try {
|
|
292
|
+
await beadsIdentity.refresh();
|
|
293
|
+
} catch (err) {
|
|
294
|
+
beadsRefreshError = err && err.message ? err.message : String(err);
|
|
295
|
+
logError('[supervisor] beads identity refresh failed:', beadsRefreshError);
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
sendJson(res, 200, {
|
|
299
|
+
status: 'ok',
|
|
300
|
+
uptimeSeconds: Math.round(process.uptime()),
|
|
301
|
+
pid: process.pid,
|
|
302
|
+
seams: Object.fromEntries(
|
|
303
|
+
Object.entries(seams).map(([k, v]) => [k, v.name ?? 'wired']),
|
|
304
|
+
),
|
|
305
|
+
beads: beadsIdentity ? toBeadsSummary(beadsIdentity.get()) : null,
|
|
306
|
+
...(beadsWarningOf(beadsIdentity) ? { beadsWarning: beadsWarningOf(beadsIdentity) } : {}),
|
|
307
|
+
...(beadsRefreshError !== undefined ? { beadsRefreshError } : {}),
|
|
308
|
+
...(backlogMember ? { backlogMember: backlogMemberSummary() } : {}),
|
|
309
|
+
});
|
|
310
|
+
});
|
|
311
|
+
|
|
312
|
+
// POST /api/shutdown -- the ONLY clean, in-band way to stop the supervisor.
|
|
313
|
+
route('POST', '/api/shutdown', async (req, res) => {
|
|
314
|
+
sendJson(res, 200, { status: 'shutting-down' });
|
|
315
|
+
// Defer the actual teardown until after this response flushes so the
|
|
316
|
+
// caller always gets an answer.
|
|
317
|
+
setImmediate(() => { stop('http:/api/shutdown').catch((e) => logError(e)); });
|
|
318
|
+
});
|
|
319
|
+
|
|
320
|
+
let stopping = null;
|
|
321
|
+
/**
|
|
322
|
+
* Idempotent teardown: close the HTTP server and stop every seam, then
|
|
323
|
+
* resolve `shutdownRequested`. Safe to call more than once.
|
|
324
|
+
* @param {string} [reason]
|
|
325
|
+
*/
|
|
326
|
+
function stop(reason = 'explicit') {
|
|
327
|
+
if (stopping) return stopping;
|
|
328
|
+
stopping = (async () => {
|
|
329
|
+
log(`[supervisor] shutting down (${reason})`);
|
|
330
|
+
await new Promise((resolve) => {
|
|
331
|
+
if (!server || !server.listening) { resolve(); return; }
|
|
332
|
+
server.close(() => resolve());
|
|
333
|
+
});
|
|
334
|
+
// Stop seams in reverse of a natural start order; isolate each so
|
|
335
|
+
// one failing seam cannot block the others' teardown.
|
|
336
|
+
for (const seam of [seams.doltOrphanSweep, seams.idAllocator, seams.doltMutex, seams.dashboard, seams.watchdog, seams.spawner, seams.ledger]) {
|
|
337
|
+
try { await seam.stop?.(); } catch (err) { logError(`[supervisor] seam ${seam.name ?? ''} stop failed:`, err); }
|
|
338
|
+
}
|
|
339
|
+
shutdownResolve();
|
|
340
|
+
})();
|
|
341
|
+
return stopping;
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
/**
|
|
345
|
+
* Bind the HTTP server and start every seam. Resolves once listening.
|
|
346
|
+
* @returns {Promise<{ port: number }>}
|
|
347
|
+
*/
|
|
348
|
+
async function start() {
|
|
349
|
+
// Start seams first so the API never serves before its collaborators
|
|
350
|
+
// are ready. Stubs are no-ops.
|
|
351
|
+
for (const seam of [seams.ledger, seams.spawner, seams.watchdog, seams.dashboard, seams.doltMutex, seams.idAllocator, seams.doltOrphanSweep]) {
|
|
352
|
+
await seam.start?.();
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
const factory = deps.createServer ?? ((h) => http.createServer(h));
|
|
356
|
+
server = factory((req, res) => { handleRequest(req, res); });
|
|
357
|
+
|
|
358
|
+
await new Promise((resolve, reject) => {
|
|
359
|
+
const onError = (err) => {
|
|
360
|
+
server.removeListener('listening', onListening);
|
|
361
|
+
reject(err);
|
|
362
|
+
};
|
|
363
|
+
const onListening = () => {
|
|
364
|
+
server.removeListener('error', onError);
|
|
365
|
+
resolve();
|
|
366
|
+
};
|
|
367
|
+
server.once('error', onError);
|
|
368
|
+
server.once('listening', onListening);
|
|
369
|
+
server.listen(port);
|
|
370
|
+
});
|
|
371
|
+
|
|
372
|
+
// port:0 asks the OS to pick a free port; reflect the port it
|
|
373
|
+
// actually bound so callers (and the returned/getter `port` below)
|
|
374
|
+
// see the real value instead of the literal 0 they requested.
|
|
375
|
+
const bound = server.address();
|
|
376
|
+
if (bound && typeof bound === 'object' && Number.isInteger(bound.port)) {
|
|
377
|
+
port = bound.port;
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
// After bootstrap, a later server-level 'error' must not crash the
|
|
381
|
+
// process; log and keep serving.
|
|
382
|
+
server.on('error', (err) => logError('[supervisor] server error:', err));
|
|
383
|
+
|
|
384
|
+
log(`[supervisor] listening on http://localhost:${port} (pid ${process.pid})`);
|
|
385
|
+
return { port };
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
return {
|
|
389
|
+
route,
|
|
390
|
+
start,
|
|
391
|
+
stop,
|
|
392
|
+
handleRequest,
|
|
393
|
+
get server() { return server; },
|
|
394
|
+
seams,
|
|
395
|
+
get port() { return port; },
|
|
396
|
+
/** Resolves once the supervisor has fully shut down. */
|
|
397
|
+
get shutdownRequested() { return shutdownRequested; },
|
|
398
|
+
};
|
|
399
|
+
}
|