@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,85 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Server exit bookkeeping (GitHub #585).
|
|
3
|
+
*
|
|
4
|
+
* Every observable exit path of a fleet server appends exactly ONE
|
|
5
|
+
* {"tag":"shutdown","reason":...} record to fleet-<pid>.log, synchronously,
|
|
6
|
+
* before the process exits -- so a server that vanished can be told apart
|
|
7
|
+
* from one that was asked to stop (and status/start can report the former,
|
|
8
|
+
* see describeUncleanExit in singleton.ts).
|
|
9
|
+
*
|
|
10
|
+
* Paths: SIGINT, SIGTERM, SIGHUP, SIGBREAK (Windows console Ctrl+Break;
|
|
11
|
+
* SIGTERM never arrives on Windows), POST /shutdown, the shutdown_server
|
|
12
|
+
* tool, and crashes (uncaughtException / unhandledRejection). Crashes are
|
|
13
|
+
* observed via 'uncaughtExceptionMonitor', which runs BEFORE Node's default
|
|
14
|
+
* crash handling without replacing it -- the process still prints the error
|
|
15
|
+
* and exits 1 exactly as before.
|
|
16
|
+
*/
|
|
17
|
+
import { appendLogRecord, maskSecrets } from '../utils/log-helpers.js';
|
|
18
|
+
let recorded = false;
|
|
19
|
+
/**
|
|
20
|
+
* Append the shutdown record once per process (the first reason wins: e.g.
|
|
21
|
+
* POST /shutdown re-enters the SIGINT path, which must not add a second line).
|
|
22
|
+
* Synchronous -- the line is on disk when this returns.
|
|
23
|
+
*/
|
|
24
|
+
export function recordShutdown(reason, detail) {
|
|
25
|
+
if (recorded)
|
|
26
|
+
return;
|
|
27
|
+
recorded = true;
|
|
28
|
+
const crash = reason === 'uncaughtException' || reason === 'unhandledRejection';
|
|
29
|
+
appendLogRecord(crash ? 'error' : 'info', { tag: 'shutdown', reason, pid: process.pid, ...(detail ?? {}) });
|
|
30
|
+
}
|
|
31
|
+
/** Test hook: forget that a record was written. */
|
|
32
|
+
export function _resetShutdownRecordForTests() {
|
|
33
|
+
recorded = false;
|
|
34
|
+
}
|
|
35
|
+
/** Signals that end a server, per platform. SIGBREAK exists only on Windows. */
|
|
36
|
+
export function shutdownSignals(platform = process.platform) {
|
|
37
|
+
const sigs = ['SIGINT', 'SIGTERM', 'SIGHUP'];
|
|
38
|
+
if (platform === 'win32')
|
|
39
|
+
sigs.push('SIGBREAK');
|
|
40
|
+
return sigs;
|
|
41
|
+
}
|
|
42
|
+
export const SHUTDOWN_FORCE_EXIT_MS = 10_000;
|
|
43
|
+
export function installShutdownHandlers(onSignal, proc = process, platform = process.platform, options = {}) {
|
|
44
|
+
const removers = [];
|
|
45
|
+
const exit = options.exit ?? ((code) => process.exit(code));
|
|
46
|
+
const forceExitMs = options.forceExitMs ?? SHUTDOWN_FORCE_EXIT_MS;
|
|
47
|
+
let shuttingDown = false;
|
|
48
|
+
let forceTimer;
|
|
49
|
+
const forceExit = (why) => {
|
|
50
|
+
appendLogRecord('warn', { tag: 'shutdown_forced', reason: why, pid: process.pid });
|
|
51
|
+
exit(1);
|
|
52
|
+
};
|
|
53
|
+
removers.push(() => { if (forceTimer)
|
|
54
|
+
clearTimeout(forceTimer); });
|
|
55
|
+
for (const sig of shutdownSignals(platform)) {
|
|
56
|
+
const handler = () => {
|
|
57
|
+
// A graceful shutdown can hang (e.g. handle.close() waiting on open
|
|
58
|
+
// connections) where SIGHUP/SIGBREAK used to just end the process: a
|
|
59
|
+
// second signal exits at once, and an unref'd deadline bounds the wait.
|
|
60
|
+
if (shuttingDown) {
|
|
61
|
+
forceExit(`second ${sig}`);
|
|
62
|
+
return;
|
|
63
|
+
}
|
|
64
|
+
shuttingDown = true;
|
|
65
|
+
recordShutdown(sig);
|
|
66
|
+
forceTimer = setTimeout(() => forceExit(`graceful shutdown exceeded ${forceExitMs}ms`), forceExitMs);
|
|
67
|
+
forceTimer.unref();
|
|
68
|
+
onSignal(sig);
|
|
69
|
+
};
|
|
70
|
+
proc.on(sig, handler);
|
|
71
|
+
removers.push(() => proc.off(sig, handler));
|
|
72
|
+
}
|
|
73
|
+
const monitor = (err, origin) => {
|
|
74
|
+
const e = err;
|
|
75
|
+
const message = typeof e?.message === 'string' ? e.message : String(err);
|
|
76
|
+
recordShutdown(origin === 'unhandledRejection' ? 'unhandledRejection' : 'uncaughtException', {
|
|
77
|
+
error: maskSecrets(message).slice(0, 2000),
|
|
78
|
+
});
|
|
79
|
+
};
|
|
80
|
+
proc.on('uncaughtExceptionMonitor', monitor);
|
|
81
|
+
removers.push(() => proc.off('uncaughtExceptionMonitor', monitor));
|
|
82
|
+
return () => { for (const r of removers)
|
|
83
|
+
r(); };
|
|
84
|
+
}
|
|
85
|
+
//# sourceMappingURL=server-lifecycle.js.map
|
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
import type { ServiceManager, ServiceStatus } from './types.js';
|
|
2
2
|
export type { ServiceManager, ServiceStatus };
|
|
3
|
-
|
|
3
|
+
/**
|
|
4
|
+
* Graceful stop via server.json: POST /shutdown, then force-kill a verified
|
|
5
|
+
* apra-fleet pid. Resolves false when the server was left running because its
|
|
6
|
+
* pid could not be verified as apra-fleet; true otherwise (stopped, or nothing
|
|
7
|
+
* to stop).
|
|
8
|
+
*/
|
|
9
|
+
export declare function gracefulStopByServerJson(fallbackKill?: (pid: number) => void): Promise<boolean>;
|
|
4
10
|
export declare function getServiceManager(): Promise<ServiceManager>;
|
|
5
11
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1,25 +1,37 @@
|
|
|
1
1
|
import fs from 'node:fs';
|
|
2
2
|
import { SERVER_INFO_PATH } from '../../paths.js';
|
|
3
|
-
import { isPidAlive, postShutdown } from '../../utils/process-utils.js';
|
|
3
|
+
import { isApraFleetProcess, isPidAlive, postShutdown } from '../../utils/process-utils.js';
|
|
4
|
+
/**
|
|
5
|
+
* Graceful stop via server.json: POST /shutdown, then force-kill a verified
|
|
6
|
+
* apra-fleet pid. Resolves false when the server was left running because its
|
|
7
|
+
* pid could not be verified as apra-fleet; true otherwise (stopped, or nothing
|
|
8
|
+
* to stop).
|
|
9
|
+
*/
|
|
4
10
|
export async function gracefulStopByServerJson(fallbackKill) {
|
|
5
11
|
let info;
|
|
6
12
|
try {
|
|
7
13
|
info = JSON.parse(fs.readFileSync(SERVER_INFO_PATH, 'utf8'));
|
|
8
14
|
}
|
|
9
15
|
catch {
|
|
10
|
-
return;
|
|
16
|
+
return true;
|
|
11
17
|
}
|
|
12
18
|
const { pid, url } = info;
|
|
13
19
|
if (!pid || !url)
|
|
14
|
-
return;
|
|
20
|
+
return true;
|
|
15
21
|
if (!isPidAlive(pid))
|
|
16
|
-
return;
|
|
22
|
+
return true;
|
|
17
23
|
await postShutdown(url);
|
|
18
24
|
const deadline = Date.now() + 5000;
|
|
19
25
|
while (isPidAlive(pid) && Date.now() < deadline) {
|
|
20
26
|
await new Promise(resolve => setTimeout(resolve, 500));
|
|
21
27
|
}
|
|
22
28
|
if (isPidAlive(pid)) {
|
|
29
|
+
// GitHub #584 review: never force-kill a reused pid that is no longer an
|
|
30
|
+
// apra-fleet server; leave server.json for the operator to inspect.
|
|
31
|
+
if (isApraFleetProcess(pid) !== true) {
|
|
32
|
+
console.error(`Server pid ${pid} did not exit after /shutdown and could not be verified as an apra-fleet process -- not force-killing it.`);
|
|
33
|
+
return false;
|
|
34
|
+
}
|
|
23
35
|
if (fallbackKill) {
|
|
24
36
|
fallbackKill(pid);
|
|
25
37
|
}
|
|
@@ -34,6 +46,7 @@ export async function gracefulStopByServerJson(fallbackKill) {
|
|
|
34
46
|
fs.unlinkSync(SERVER_INFO_PATH);
|
|
35
47
|
}
|
|
36
48
|
catch { }
|
|
49
|
+
return true;
|
|
37
50
|
}
|
|
38
51
|
class NoopServiceManager {
|
|
39
52
|
async register(_binaryPath, _args, _logPath) { }
|
|
@@ -3,7 +3,7 @@ export declare class LinuxServiceManager implements ServiceManager {
|
|
|
3
3
|
register(binaryPath: string, args: string[], logPath: string): Promise<void>;
|
|
4
4
|
unregister(): Promise<void>;
|
|
5
5
|
start(): Promise<void>;
|
|
6
|
-
stop(): Promise<
|
|
6
|
+
stop(): Promise<boolean>;
|
|
7
7
|
query(): Promise<ServiceStatus>;
|
|
8
8
|
isInstalled(): Promise<boolean>;
|
|
9
9
|
}
|
|
@@ -2,8 +2,10 @@ import { execFileSync } from 'node:child_process';
|
|
|
2
2
|
import fs from 'node:fs';
|
|
3
3
|
import path from 'node:path';
|
|
4
4
|
import os from 'node:os';
|
|
5
|
-
import { LINUX_UNIT_NAME } from './types.js';
|
|
5
|
+
import { LINUX_UNIT_NAME, SERVICE_ENV_MARKER } from './types.js';
|
|
6
6
|
import { gracefulStopByServerJson } from './index.js';
|
|
7
|
+
import { clearServiceStartFailures } from '../service-start-guard.js';
|
|
8
|
+
import { computeServicePath, systemdEnvironmentLine } from './service-path.js';
|
|
7
9
|
const UNIT_DIR = path.join(os.homedir(), '.config', 'systemd', 'user');
|
|
8
10
|
const UNIT_PATH = path.join(UNIT_DIR, LINUX_UNIT_NAME);
|
|
9
11
|
const SERVICE_NAME = LINUX_UNIT_NAME.replace(/\.service$/, '');
|
|
@@ -25,6 +27,10 @@ export class LinuxServiceManager {
|
|
|
25
27
|
'Type=simple',
|
|
26
28
|
`ExecStart=${binaryPath} ${args.join(' ')}`,
|
|
27
29
|
'Restart=on-failure',
|
|
30
|
+
// Lets the server tell it runs under a restarting service manager.
|
|
31
|
+
`Environment=${SERVICE_ENV_MARKER}=1`,
|
|
32
|
+
// systemd --user's default PATH lacks nvm/custom node dirs; npx needs both npx and node.
|
|
33
|
+
systemdEnvironmentLine('PATH', computeServicePath({ platform: 'linux' })),
|
|
28
34
|
`StandardOutput=append:${logPath}`,
|
|
29
35
|
`StandardError=append:${logPath}`,
|
|
30
36
|
'',
|
|
@@ -47,11 +53,11 @@ export class LinuxServiceManager {
|
|
|
47
53
|
await gracefulStopByServerJson();
|
|
48
54
|
checkSystemd();
|
|
49
55
|
try {
|
|
50
|
-
execFileSync('systemctl', ['--user', 'disable', SERVICE_NAME]);
|
|
56
|
+
execFileSync('systemctl', ['--user', 'disable', SERVICE_NAME], { stdio: 'pipe' });
|
|
51
57
|
}
|
|
52
58
|
catch { }
|
|
53
59
|
try {
|
|
54
|
-
execFileSync('systemctl', ['--user', 'stop', SERVICE_NAME]);
|
|
60
|
+
execFileSync('systemctl', ['--user', 'stop', SERVICE_NAME], { stdio: 'pipe' });
|
|
55
61
|
}
|
|
56
62
|
catch { }
|
|
57
63
|
try {
|
|
@@ -59,17 +65,19 @@ export class LinuxServiceManager {
|
|
|
59
65
|
}
|
|
60
66
|
catch { }
|
|
61
67
|
try {
|
|
62
|
-
execFileSync('systemctl', ['--user', 'daemon-reload']);
|
|
68
|
+
execFileSync('systemctl', ['--user', 'daemon-reload'], { stdio: 'pipe' });
|
|
63
69
|
}
|
|
64
70
|
catch { }
|
|
65
71
|
}
|
|
66
72
|
async start() {
|
|
73
|
+
// An explicit start is never skipped by the failed-start backoff.
|
|
74
|
+
clearServiceStartFailures();
|
|
67
75
|
checkSystemd();
|
|
68
76
|
execFileSync('systemctl', ['--user', 'start', SERVICE_NAME]);
|
|
69
77
|
}
|
|
70
78
|
async stop() {
|
|
71
79
|
checkSystemd();
|
|
72
|
-
|
|
80
|
+
return gracefulStopByServerJson();
|
|
73
81
|
}
|
|
74
82
|
async query() {
|
|
75
83
|
checkSystemd();
|
|
@@ -79,12 +87,12 @@ export class LinuxServiceManager {
|
|
|
79
87
|
let running = false;
|
|
80
88
|
let enabled;
|
|
81
89
|
try {
|
|
82
|
-
const active = execFileSync('systemctl', ['--user', 'is-active', SERVICE_NAME], { encoding: 'utf8' }).trim();
|
|
90
|
+
const active = execFileSync('systemctl', ['--user', 'is-active', SERVICE_NAME], { encoding: 'utf8', stdio: 'pipe' }).trim();
|
|
83
91
|
running = active === 'active';
|
|
84
92
|
}
|
|
85
93
|
catch { }
|
|
86
94
|
try {
|
|
87
|
-
const enabledOut = execFileSync('systemctl', ['--user', 'is-enabled', SERVICE_NAME], { encoding: 'utf8' }).trim();
|
|
95
|
+
const enabledOut = execFileSync('systemctl', ['--user', 'is-enabled', SERVICE_NAME], { encoding: 'utf8', stdio: 'pipe' }).trim();
|
|
88
96
|
enabled = enabledOut === 'enabled';
|
|
89
97
|
}
|
|
90
98
|
catch { }
|
|
@@ -1,9 +1,19 @@
|
|
|
1
1
|
import type { ServiceManager, ServiceStatus } from './types.js';
|
|
2
|
+
/** servicePath: PATH for the server (launchd's default lacks Homebrew/nvm node and npx). */
|
|
3
|
+
export declare function buildPlist(binaryPath: string, args: string[], logPath: string, servicePath: string): string;
|
|
4
|
+
/**
|
|
5
|
+
* Whether a launchd label is enabled in its domain, from `launchctl
|
|
6
|
+
* print-disabled <domain>` output: lines like `"label" => disabled` (newer
|
|
7
|
+
* macOS) or `"label" => true` (older, where true means disabled). A label not
|
|
8
|
+
* listed is enabled (launchd's default). If the query fails, assume enabled --
|
|
9
|
+
* the plist exists, which is the installed-and-enabled common case.
|
|
10
|
+
*/
|
|
11
|
+
export declare function macosLabelEnabled(label: string, printDisabled: () => string): boolean;
|
|
2
12
|
export declare class MacOSServiceManager implements ServiceManager {
|
|
3
13
|
register(binaryPath: string, args: string[], logPath: string): Promise<void>;
|
|
4
14
|
unregister(): Promise<void>;
|
|
5
15
|
start(): Promise<void>;
|
|
6
|
-
stop(): Promise<
|
|
16
|
+
stop(): Promise<boolean>;
|
|
7
17
|
query(): Promise<ServiceStatus>;
|
|
8
18
|
isInstalled(): Promise<boolean>;
|
|
9
19
|
}
|
|
@@ -2,8 +2,10 @@ import { execFileSync } from 'node:child_process';
|
|
|
2
2
|
import fs from 'node:fs';
|
|
3
3
|
import path from 'node:path';
|
|
4
4
|
import os from 'node:os';
|
|
5
|
-
import { MACOS_PLIST_LABEL } from './types.js';
|
|
5
|
+
import { MACOS_PLIST_LABEL, SERVICE_ENV_MARKER } from './types.js';
|
|
6
6
|
import { gracefulStopByServerJson } from './index.js';
|
|
7
|
+
import { clearServiceStartFailures } from '../service-start-guard.js';
|
|
8
|
+
import { computeServicePath } from './service-path.js';
|
|
7
9
|
const PLIST_DIR = path.join(os.homedir(), 'Library', 'LaunchAgents');
|
|
8
10
|
const PLIST_PATH = path.join(PLIST_DIR, `${MACOS_PLIST_LABEL}.plist`);
|
|
9
11
|
function getUid() {
|
|
@@ -15,7 +17,8 @@ function domain() {
|
|
|
15
17
|
function xmlEscape(s) {
|
|
16
18
|
return s.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>');
|
|
17
19
|
}
|
|
18
|
-
|
|
20
|
+
/** servicePath: PATH for the server (launchd's default lacks Homebrew/nvm node and npx). */
|
|
21
|
+
export function buildPlist(binaryPath, args, logPath, servicePath) {
|
|
19
22
|
const argElements = [binaryPath, ...args]
|
|
20
23
|
.map(a => ` <string>${xmlEscape(a)}</string>`)
|
|
21
24
|
.join('\n');
|
|
@@ -30,6 +33,13 @@ function buildPlist(binaryPath, args, logPath) {
|
|
|
30
33
|
' <array>',
|
|
31
34
|
argElements,
|
|
32
35
|
' </array>',
|
|
36
|
+
' <key>EnvironmentVariables</key>',
|
|
37
|
+
' <dict>',
|
|
38
|
+
` <key>${SERVICE_ENV_MARKER}</key>`,
|
|
39
|
+
' <string>1</string>',
|
|
40
|
+
' <key>PATH</key>',
|
|
41
|
+
` <string>${xmlEscape(servicePath)}</string>`,
|
|
42
|
+
' </dict>',
|
|
33
43
|
' <key>RunAtLoad</key>',
|
|
34
44
|
' <true/>',
|
|
35
45
|
' <key>KeepAlive</key>',
|
|
@@ -46,10 +56,32 @@ function buildPlist(binaryPath, args, logPath) {
|
|
|
46
56
|
'',
|
|
47
57
|
].join('\n');
|
|
48
58
|
}
|
|
59
|
+
/**
|
|
60
|
+
* Whether a launchd label is enabled in its domain, from `launchctl
|
|
61
|
+
* print-disabled <domain>` output: lines like `"label" => disabled` (newer
|
|
62
|
+
* macOS) or `"label" => true` (older, where true means disabled). A label not
|
|
63
|
+
* listed is enabled (launchd's default). If the query fails, assume enabled --
|
|
64
|
+
* the plist exists, which is the installed-and-enabled common case.
|
|
65
|
+
*/
|
|
66
|
+
export function macosLabelEnabled(label, printDisabled) {
|
|
67
|
+
let out;
|
|
68
|
+
try {
|
|
69
|
+
out = printDisabled();
|
|
70
|
+
}
|
|
71
|
+
catch {
|
|
72
|
+
return true;
|
|
73
|
+
}
|
|
74
|
+
const esc = label.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
75
|
+
const m = new RegExp(`"${esc}"\\s*=>\\s*(\\w+)`).exec(out);
|
|
76
|
+
if (!m)
|
|
77
|
+
return true;
|
|
78
|
+
const v = m[1].toLowerCase();
|
|
79
|
+
return !(v === 'disabled' || v === 'true');
|
|
80
|
+
}
|
|
49
81
|
export class MacOSServiceManager {
|
|
50
82
|
async register(binaryPath, args, logPath) {
|
|
51
83
|
fs.mkdirSync(PLIST_DIR, { recursive: true });
|
|
52
|
-
fs.writeFileSync(PLIST_PATH, buildPlist(binaryPath, args, logPath), 'utf8');
|
|
84
|
+
fs.writeFileSync(PLIST_PATH, buildPlist(binaryPath, args, logPath, computeServicePath({ platform: 'darwin' })), 'utf8');
|
|
53
85
|
// Bootout first to make register idempotent
|
|
54
86
|
try {
|
|
55
87
|
execFileSync('launchctl', ['bootout', `${domain()}/${MACOS_PLIST_LABEL}`]);
|
|
@@ -68,23 +100,29 @@ export class MacOSServiceManager {
|
|
|
68
100
|
catch { }
|
|
69
101
|
}
|
|
70
102
|
async start() {
|
|
103
|
+
// An explicit start is never skipped by the failed-start backoff.
|
|
104
|
+
clearServiceStartFailures();
|
|
71
105
|
execFileSync('launchctl', ['kickstart', `${domain()}/${MACOS_PLIST_LABEL}`]);
|
|
72
106
|
}
|
|
73
107
|
async stop() {
|
|
74
|
-
|
|
108
|
+
return gracefulStopByServerJson();
|
|
75
109
|
}
|
|
76
110
|
async query() {
|
|
77
111
|
if (!fs.existsSync(PLIST_PATH)) {
|
|
78
112
|
return { installed: false, running: false };
|
|
79
113
|
}
|
|
114
|
+
// GitHub #585: report enabled (status showed every installed agent as
|
|
115
|
+
// "installed (disabled)"), and pipe stderr so launchctl errors never print
|
|
116
|
+
// above apra-fleet status.
|
|
117
|
+
const enabled = macosLabelEnabled(MACOS_PLIST_LABEL, () => execFileSync('launchctl', ['print-disabled', domain()], { encoding: 'utf8', stdio: 'pipe' }));
|
|
80
118
|
try {
|
|
81
|
-
const out = execFileSync('launchctl', ['print', `${domain()}/${MACOS_PLIST_LABEL}`], { encoding: 'utf8' });
|
|
119
|
+
const out = execFileSync('launchctl', ['print', `${domain()}/${MACOS_PLIST_LABEL}`], { encoding: 'utf8', stdio: 'pipe' });
|
|
82
120
|
const pidMatch = out.match(/\bpid\s*=\s*(\d+)/);
|
|
83
121
|
const pid = pidMatch ? parseInt(pidMatch[1], 10) : undefined;
|
|
84
|
-
return { installed: true, running: !!pid && pid > 0, pid };
|
|
122
|
+
return { installed: true, running: !!pid && pid > 0, pid, enabled };
|
|
85
123
|
}
|
|
86
124
|
catch {
|
|
87
|
-
return { installed: true, running: false };
|
|
125
|
+
return { installed: true, running: false, enabled };
|
|
88
126
|
}
|
|
89
127
|
}
|
|
90
128
|
async isInstalled() {
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { type FindOnPathOptions } from '../../utils/find-on-path.js';
|
|
2
|
+
export interface ServicePathInputs {
|
|
3
|
+
/** Target platform: 'darwin' or 'linux' (default: process.platform). */
|
|
4
|
+
platform?: NodeJS.Platform;
|
|
5
|
+
/** The installing process's PATH (default: process.env.PATH). */
|
|
6
|
+
envPath?: string;
|
|
7
|
+
/** File-existence check used to resolve node/npx. Injected by tests. */
|
|
8
|
+
isFile?: FindOnPathOptions['isFile'];
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Ordered, de-duplicated PATH entries: the dirs holding node and npx on the
|
|
12
|
+
* installer's PATH, then the installer's own PATH, then platform well-known
|
|
13
|
+
* dirs. Only absolute, control-char-free entries survive.
|
|
14
|
+
*/
|
|
15
|
+
export declare function computeServicePathEntries(inputs?: ServicePathInputs): string[];
|
|
16
|
+
/** The PATH value (colon-joined) for a POSIX service definition. */
|
|
17
|
+
export declare function computeServicePath(inputs?: ServicePathInputs): string;
|
|
18
|
+
/**
|
|
19
|
+
* A systemd `Environment=` line for NAME=value, quoted per systemd.exec:
|
|
20
|
+
* the whole assignment in double quotes, `\` and `"` backslash-escaped, and
|
|
21
|
+
* `%` doubled so it is never taken as a unit specifier.
|
|
22
|
+
*/
|
|
23
|
+
export declare function systemdEnvironmentLine(name: string, value: string): string;
|
|
24
|
+
//# sourceMappingURL=service-path.d.ts.map
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import path from 'node:path';
|
|
2
|
+
import { findExecutableOnPath, splitPath } from '../../utils/find-on-path.js';
|
|
3
|
+
/**
|
|
4
|
+
* PATH written into the launchd plist / systemd user unit. Service managers
|
|
5
|
+
* start the server with a minimal default PATH (launchd: /usr/bin:/bin:...,
|
|
6
|
+
* systemd --user: no ~/.nvm), so without this the server cannot spawn npx
|
|
7
|
+
* (and npx's `#!/usr/bin/env node` cannot find node) -- code intelligence goes
|
|
8
|
+
* offline with "spawn npx ENOENT". Computed at register time, so re-running
|
|
9
|
+
* install (which always rewrites the service definition) refreshes it.
|
|
10
|
+
*/
|
|
11
|
+
const MACOS_WELL_KNOWN = ['/opt/homebrew/bin', '/usr/local/bin'];
|
|
12
|
+
const POSIX_WELL_KNOWN = ['/usr/bin', '/bin', '/usr/sbin', '/sbin'];
|
|
13
|
+
/** A PATH entry is kept only when absolute and free of control characters. */
|
|
14
|
+
function isSafeEntry(dir) {
|
|
15
|
+
return path.posix.isAbsolute(dir) && !/[\x00-\x1f\x7f]/.test(dir);
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Ordered, de-duplicated PATH entries: the dirs holding node and npx on the
|
|
19
|
+
* installer's PATH, then the installer's own PATH, then platform well-known
|
|
20
|
+
* dirs. Only absolute, control-char-free entries survive.
|
|
21
|
+
*/
|
|
22
|
+
export function computeServicePathEntries(inputs = {}) {
|
|
23
|
+
const platform = inputs.platform ?? process.platform;
|
|
24
|
+
const envPath = inputs.envPath ?? process.env.PATH ?? '';
|
|
25
|
+
const find = (name) => findExecutableOnPath(name, { platform, envPath, isFile: inputs.isFile });
|
|
26
|
+
const toolDirs = ['node', 'npx']
|
|
27
|
+
.map(find)
|
|
28
|
+
.filter((p) => !!p)
|
|
29
|
+
.map(p => path.posix.dirname(p));
|
|
30
|
+
const wellKnown = platform === 'darwin' ? [...MACOS_WELL_KNOWN, ...POSIX_WELL_KNOWN] : POSIX_WELL_KNOWN;
|
|
31
|
+
const out = [];
|
|
32
|
+
const seen = new Set();
|
|
33
|
+
for (const raw of [...toolDirs, ...splitPath(envPath, platform), ...wellKnown]) {
|
|
34
|
+
const dir = raw.length > 1 ? raw.replace(/\/+$/, '') : raw;
|
|
35
|
+
if (!isSafeEntry(dir) || seen.has(dir))
|
|
36
|
+
continue;
|
|
37
|
+
seen.add(dir);
|
|
38
|
+
out.push(dir);
|
|
39
|
+
}
|
|
40
|
+
return out;
|
|
41
|
+
}
|
|
42
|
+
/** The PATH value (colon-joined) for a POSIX service definition. */
|
|
43
|
+
export function computeServicePath(inputs = {}) {
|
|
44
|
+
return computeServicePathEntries(inputs).join(':');
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* A systemd `Environment=` line for NAME=value, quoted per systemd.exec:
|
|
48
|
+
* the whole assignment in double quotes, `\` and `"` backslash-escaped, and
|
|
49
|
+
* `%` doubled so it is never taken as a unit specifier.
|
|
50
|
+
*/
|
|
51
|
+
export function systemdEnvironmentLine(name, value) {
|
|
52
|
+
const quoted = `${name}=${value}`.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/%/g, '%%');
|
|
53
|
+
return `Environment="${quoted}"`;
|
|
54
|
+
}
|
|
55
|
+
//# sourceMappingURL=service-path.js.map
|
|
@@ -1,17 +1,54 @@
|
|
|
1
1
|
export declare const WINDOWS_TASK_NAME = "ApraFleet";
|
|
2
2
|
export declare const LINUX_UNIT_NAME = "apra-fleet.service";
|
|
3
3
|
export declare const MACOS_PLIST_LABEL = "com.apra-fleet.server";
|
|
4
|
+
/** Env var the service definitions (systemd unit, launchd plist, Windows task
|
|
5
|
+
* wrapper) set so the server can tell it runs under a service manager. */
|
|
6
|
+
export declare const SERVICE_ENV_MARKER = "APRA_FLEET_SERVICE";
|
|
7
|
+
/**
|
|
8
|
+
* True when this process was launched by a service manager (GitHub #584
|
|
9
|
+
* review): the explicit APRA_FLEET_SERVICE=1 marker (new installs), systemd's
|
|
10
|
+
* INVOCATION_ID, or launchd's XPC_SERVICE_NAME for our own label (installs
|
|
11
|
+
* predating the marker).
|
|
12
|
+
*/
|
|
13
|
+
export declare function launchedByServiceManager(env?: Record<string, string | undefined>): boolean;
|
|
14
|
+
/** Env var set by a client auto-start on the `apra-fleet start` it spawns (cli/start.ts). */
|
|
15
|
+
export declare const AUTOSTART_ENV_MARKER = "APRA_FLEET_AUTOSTART";
|
|
16
|
+
export interface LaunchMarkers {
|
|
17
|
+
/** APRA_FLEET_SERVICE=1: launched by one of OUR service templates (task wrapper, plist, unit). */
|
|
18
|
+
service: boolean;
|
|
19
|
+
/** Any service-manager hint, including systemd/launchd vars that also leak to hand-run shells. */
|
|
20
|
+
managed: boolean;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Read the launch markers ONCE at server start and remove ours from the
|
|
24
|
+
* environment, so nothing the server spawns (local agents, execute_command,
|
|
25
|
+
* a later `apra-fleet start`) inherits APRA_FLEET_SERVICE / APRA_FLEET_AUTOSTART
|
|
26
|
+
* and is mistaken for a service or auto-start launch. INVOCATION_ID and
|
|
27
|
+
* XPC_SERVICE_NAME are not ours to remove.
|
|
28
|
+
*/
|
|
29
|
+
export declare function consumeLaunchMarkers(env?: Record<string, string | undefined>): LaunchMarkers;
|
|
4
30
|
export interface ServiceStatus {
|
|
5
31
|
installed: boolean;
|
|
6
32
|
running: boolean;
|
|
7
33
|
pid?: number;
|
|
8
34
|
enabled?: boolean;
|
|
35
|
+
/** Extra human-readable state for apra-fleet status (e.g. why it is disabled). */
|
|
36
|
+
detail?: string;
|
|
37
|
+
/** Multi-line action the user should take (printed under the Service line by apra-fleet status). */
|
|
38
|
+
notice?: string;
|
|
9
39
|
}
|
|
40
|
+
/**
|
|
41
|
+
* 'reused': the platform kept an existing registration it could not recreate (Windows).
|
|
42
|
+
* 'run-key': last-resort Windows fallback -- a per-user HKCU Run entry (logon
|
|
43
|
+
* autostart only, nothing restarts a server that dies mid-session).
|
|
44
|
+
*/
|
|
45
|
+
export type RegisterResult = 'created' | 'reused' | 'run-key';
|
|
10
46
|
export interface ServiceManager {
|
|
11
|
-
register(binaryPath: string, args: string[], logPath: string): Promise<void>;
|
|
47
|
+
register(binaryPath: string, args: string[], logPath: string): Promise<RegisterResult | void>;
|
|
12
48
|
unregister(): Promise<void>;
|
|
13
49
|
start(): Promise<void>;
|
|
14
|
-
|
|
50
|
+
/** Resolves false when the server was left running (pid not verifiable as apra-fleet). */
|
|
51
|
+
stop(): Promise<boolean | void>;
|
|
15
52
|
query(): Promise<ServiceStatus>;
|
|
16
53
|
isInstalled(): Promise<boolean>;
|
|
17
54
|
}
|
|
@@ -2,4 +2,33 @@
|
|
|
2
2
|
export const WINDOWS_TASK_NAME = 'ApraFleet';
|
|
3
3
|
export const LINUX_UNIT_NAME = 'apra-fleet.service';
|
|
4
4
|
export const MACOS_PLIST_LABEL = 'com.apra-fleet.server';
|
|
5
|
+
/** Env var the service definitions (systemd unit, launchd plist, Windows task
|
|
6
|
+
* wrapper) set so the server can tell it runs under a service manager. */
|
|
7
|
+
export const SERVICE_ENV_MARKER = 'APRA_FLEET_SERVICE';
|
|
8
|
+
/**
|
|
9
|
+
* True when this process was launched by a service manager (GitHub #584
|
|
10
|
+
* review): the explicit APRA_FLEET_SERVICE=1 marker (new installs), systemd's
|
|
11
|
+
* INVOCATION_ID, or launchd's XPC_SERVICE_NAME for our own label (installs
|
|
12
|
+
* predating the marker).
|
|
13
|
+
*/
|
|
14
|
+
export function launchedByServiceManager(env = process.env) {
|
|
15
|
+
return env[SERVICE_ENV_MARKER] === '1'
|
|
16
|
+
|| !!env.INVOCATION_ID
|
|
17
|
+
|| env.XPC_SERVICE_NAME === MACOS_PLIST_LABEL;
|
|
18
|
+
}
|
|
19
|
+
/** Env var set by a client auto-start on the `apra-fleet start` it spawns (cli/start.ts). */
|
|
20
|
+
export const AUTOSTART_ENV_MARKER = 'APRA_FLEET_AUTOSTART';
|
|
21
|
+
/**
|
|
22
|
+
* Read the launch markers ONCE at server start and remove ours from the
|
|
23
|
+
* environment, so nothing the server spawns (local agents, execute_command,
|
|
24
|
+
* a later `apra-fleet start`) inherits APRA_FLEET_SERVICE / APRA_FLEET_AUTOSTART
|
|
25
|
+
* and is mistaken for a service or auto-start launch. INVOCATION_ID and
|
|
26
|
+
* XPC_SERVICE_NAME are not ours to remove.
|
|
27
|
+
*/
|
|
28
|
+
export function consumeLaunchMarkers(env = process.env) {
|
|
29
|
+
const markers = { service: env[SERVICE_ENV_MARKER] === '1', managed: launchedByServiceManager(env) };
|
|
30
|
+
delete env[SERVICE_ENV_MARKER];
|
|
31
|
+
delete env[AUTOSTART_ENV_MARKER];
|
|
32
|
+
return markers;
|
|
33
|
+
}
|
|
5
34
|
//# sourceMappingURL=types.js.map
|