@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
package/dist/cli/install.js
CHANGED
|
@@ -1,16 +1,25 @@
|
|
|
1
1
|
import fs from 'node:fs';
|
|
2
|
+
import { getOrCreateMemberAccessSecret, MEMBER_SECRET_HEADER, readMemberAccessSecret } from '../services/member-access-secret.js';
|
|
3
|
+
import { claudeUserConfigPath, refreshClaudeLocalScopeEntries } from '../services/claude-local-scope-mcp.js';
|
|
2
4
|
import path from 'node:path';
|
|
3
5
|
import os from 'node:os';
|
|
4
6
|
import { execSync, execFileSync } from 'node:child_process';
|
|
5
7
|
import { serverVersion } from '../version.js';
|
|
6
|
-
import { DEFAULT_PORT, LOG_FILE_PATH } from '../paths.js';
|
|
8
|
+
import { BUILTIN_DEFAULT_PORT, DEFAULT_PORT, DEFAULT_HOST, LOG_FILE_PATH, recordedMemberInstallPort, resolveServerPort, validPort } from '../paths.js';
|
|
7
9
|
import { getServiceManager } from '../services/service-manager/index.js';
|
|
8
|
-
import {
|
|
9
|
-
import {
|
|
10
|
+
import { LINUX_UNIT_NAME, MACOS_PLIST_LABEL } from '../services/service-manager/types.js';
|
|
11
|
+
import { BIN_DIR, HOOKS_DIR, SCRIPTS_DIR, getProviderInstallConfig, readConfig, readInstallConfig, writeOwnerOnlyFile, writeOwnerOnlyFileAtomic, writeConfig, writeInstallConfig, PROVIDER_STANDARD_MODELS, INSTALLABLE_LLM_PROVIDERS } from './config.js';
|
|
12
|
+
import { transformAgentForOpenCode, transformAgentForAgy, transformAgentForClaude } from './agent-transform.js';
|
|
10
13
|
import { FLEET_DIR } from '../paths.js';
|
|
11
14
|
import { extractWorkflowSubsystemAssets } from './workflow-assets.js';
|
|
12
15
|
import { downloadAndExtractDolt, verifyDolt } from './dolt-install.js';
|
|
13
|
-
import {
|
|
16
|
+
import { installBeads } from './beads-install.js';
|
|
17
|
+
import { classifyRunningServer, relevantServerPids, getInstallDataDir, memberForceMayStop, fullInstallRefusalText, selfInvocationLines, writeMemberInstallMarker, clearMemberInstallMarker, FORCE_STOP_FULL_INSTALL_FLAG, } from './install-guard.js';
|
|
18
|
+
import { detectRunningFleetSe, fleetSeRefusalText, realFleetSeProbes, IGNORE_RUNNING_SPRINTS_FLAG } from './fleet-se-guard.js';
|
|
19
|
+
import { writeServiceNotice, clearServiceNoticeContaining } from '../services/service-notice.js';
|
|
20
|
+
import { convertClaudeAllowToAgyPermissions, formatAgyPermissionRules } from '../providers/agy.js';
|
|
21
|
+
import { codeIntelPathWarning } from '../utils/find-on-path.js';
|
|
22
|
+
import { gitBashCandidates } from '../os/git-bash-candidates.js';
|
|
14
23
|
const realDoltStepDeps = { downloadAndExtractDolt, verifyDolt };
|
|
15
24
|
let doltStepDeps = realDoltStepDeps;
|
|
16
25
|
/** Test-only: inject fakes for the dolt CLI install step's download/verify calls. */
|
|
@@ -21,15 +30,130 @@ export function _setDoltStepDeps(overrides) {
|
|
|
21
30
|
export function _resetDoltStepDeps() {
|
|
22
31
|
doltStepDeps = realDoltStepDeps;
|
|
23
32
|
}
|
|
33
|
+
/** Real transports for the Beads step (execFileSync is mocked by the install tests). */
|
|
34
|
+
function beadsStepDeps() {
|
|
35
|
+
return {
|
|
36
|
+
platform: process.platform,
|
|
37
|
+
exec: (cmd, args, opts) => execFileSync(cmd, args, { stdio: 'pipe', encoding: 'utf-8', shell: opts.shell, windowsHide: true }),
|
|
38
|
+
existsSync: p => fs.existsSync(p),
|
|
39
|
+
mkdirSync: p => { fs.mkdirSync(p, { recursive: true }); },
|
|
40
|
+
rmSync: p => { fs.rmSync(p, { recursive: true, force: true }); },
|
|
41
|
+
copyFileSync: (src, dest) => fs.copyFileSync(src, dest),
|
|
42
|
+
chmodSync: (p, mode) => fs.chmodSync(p, mode),
|
|
43
|
+
};
|
|
44
|
+
}
|
|
24
45
|
function doltStepEnabled() {
|
|
25
46
|
if (process.env.NODE_ENV !== 'test')
|
|
26
47
|
return true;
|
|
27
48
|
return process.env.APRA_FLEET_ENABLE_DOLT_INSTALL === '1';
|
|
28
49
|
}
|
|
50
|
+
const FLEET_SE_MIN_NODE = [22, 16, 0];
|
|
51
|
+
function probeVersion(cmd, shell) {
|
|
52
|
+
try {
|
|
53
|
+
const out = execFileSync(cmd, ['--version'], { stdio: 'pipe', encoding: 'utf-8', timeout: 15_000, shell, windowsHide: true });
|
|
54
|
+
return String(out).trim() || null;
|
|
55
|
+
}
|
|
56
|
+
catch {
|
|
57
|
+
return null;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
// System node from PATH, NOT process.version (in SEA mode that is the embedded runtime).
|
|
61
|
+
// node/npm can be .cmd shims on Windows (nvm-windows, corporate wrappers), so both need shell:true.
|
|
62
|
+
const realFleetSePrereqProbes = {
|
|
63
|
+
nodeVersion: () => probeVersion('node', true),
|
|
64
|
+
npmVersion: () => probeVersion('npm', true),
|
|
65
|
+
};
|
|
66
|
+
let fleetSePrereqProbes = realFleetSePrereqProbes;
|
|
67
|
+
/** Test-only: the real (non-overridden) probes, to assert their exec options. */
|
|
68
|
+
export const _realFleetSePrereqProbes = realFleetSePrereqProbes;
|
|
69
|
+
/** Test-only: inject fake probes for the fleet-se prerequisite check. */
|
|
70
|
+
export function _setFleetSePrereqProbes(overrides) {
|
|
71
|
+
fleetSePrereqProbes = { ...realFleetSePrereqProbes, ...overrides };
|
|
72
|
+
}
|
|
73
|
+
/** Test-only: restore the real fleet-se prerequisite probes. */
|
|
74
|
+
export function _resetFleetSePrereqProbes() {
|
|
75
|
+
fleetSePrereqProbes = realFleetSePrereqProbes;
|
|
76
|
+
}
|
|
77
|
+
// Running fleet-sprint supervisor/sprint guard (fleet-se-guard.ts): same
|
|
78
|
+
// injectable-probes + NODE_ENV=test gate as the prereq check above, so unit
|
|
79
|
+
// tests never probe the real port 8787 or tmp lock dir.
|
|
80
|
+
let fleetSeProbes = realFleetSeProbes;
|
|
81
|
+
/** Test-only: inject fake probes for the running fleet-sprint guard. */
|
|
82
|
+
export function _setFleetSeProbes(overrides) {
|
|
83
|
+
fleetSeProbes = { ...realFleetSeProbes, ...overrides };
|
|
84
|
+
}
|
|
85
|
+
/** Test-only: restore the real running fleet-sprint guard probes. */
|
|
86
|
+
export function _resetFleetSeProbes() {
|
|
87
|
+
fleetSeProbes = realFleetSeProbes;
|
|
88
|
+
}
|
|
89
|
+
/** The probes the running fleet-sprint guard uses (shared with update.ts). */
|
|
90
|
+
export function currentFleetSeProbes() { return fleetSeProbes; }
|
|
91
|
+
export function fleetSeGuardEnabled() {
|
|
92
|
+
if (process.env.NODE_ENV !== 'test')
|
|
93
|
+
return true;
|
|
94
|
+
return process.env.APRA_FLEET_ENABLE_FLEET_SE_GUARD === '1';
|
|
95
|
+
}
|
|
96
|
+
function fleetSePrereqCheckEnabled() {
|
|
97
|
+
if (process.env.NODE_ENV !== 'test')
|
|
98
|
+
return true;
|
|
99
|
+
return process.env.APRA_FLEET_ENABLE_FLEET_SE_PREREQ_CHECK === '1';
|
|
100
|
+
}
|
|
101
|
+
function nodeVersionSatisfies(raw) {
|
|
102
|
+
const m = raw.trim().replace(/^v/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
|
|
103
|
+
if (!m)
|
|
104
|
+
return false;
|
|
105
|
+
const v = [Number(m[1]), Number(m[2]), Number(m[3])];
|
|
106
|
+
for (let i = 0; i < 3; i++) {
|
|
107
|
+
if (v[i] !== FLEET_SE_MIN_NODE[i])
|
|
108
|
+
return v[i] > FLEET_SE_MIN_NODE[i];
|
|
109
|
+
}
|
|
110
|
+
return true;
|
|
111
|
+
}
|
|
112
|
+
export function checkFleetSePrereqs(probes) {
|
|
113
|
+
const missing = [];
|
|
114
|
+
const causes = [];
|
|
115
|
+
const minNode = FLEET_SE_MIN_NODE.join('.');
|
|
116
|
+
const node = probes.nodeVersion();
|
|
117
|
+
if (node === null) {
|
|
118
|
+
missing.push('node');
|
|
119
|
+
causes.push('Node.js not found on PATH');
|
|
120
|
+
}
|
|
121
|
+
else if (!nodeVersionSatisfies(node)) {
|
|
122
|
+
missing.push('node');
|
|
123
|
+
causes.push(`Node.js ${node.trim()} found, ${minNode}+ required`);
|
|
124
|
+
}
|
|
125
|
+
if (probes.npmVersion() === null) {
|
|
126
|
+
missing.push('npm');
|
|
127
|
+
causes.push('npm not found on PATH');
|
|
128
|
+
}
|
|
129
|
+
if (missing.length === 0)
|
|
130
|
+
return { ok: true, missing, message: '' };
|
|
131
|
+
const message = `${causes.join('; ')}. fleet-se requires Node.js 22.16+ and npm. Install them and re-run, or use --workflows none to install the core only.`;
|
|
132
|
+
return { ok: false, missing, message };
|
|
133
|
+
}
|
|
29
134
|
// Detect SEA mode
|
|
30
135
|
let _seaOverride = null;
|
|
31
136
|
/** Override isSea() result -- for tests only. Pass null to restore default. */
|
|
32
137
|
export function _setSeaOverride(v) { _seaOverride = v; }
|
|
138
|
+
let _serviceHealthWaitOverride = null;
|
|
139
|
+
export function _setServiceHealthWaitOverride(fn) { _serviceHealthWaitOverride = fn; }
|
|
140
|
+
async function waitForServiceHealth() {
|
|
141
|
+
if (_serviceHealthWaitOverride)
|
|
142
|
+
return _serviceHealthWaitOverride();
|
|
143
|
+
const raw = parseInt(process.env.APRA_FLEET_INSTALL_HEALTH_TIMEOUT_MS ?? '', 10);
|
|
144
|
+
const timeoutMs = Number.isFinite(raw) && raw >= 0 ? raw : 30_000;
|
|
145
|
+
if (timeoutMs === 0)
|
|
146
|
+
return null;
|
|
147
|
+
const { checkRunningInstance } = await import('../services/singleton.js');
|
|
148
|
+
const deadline = Date.now() + timeoutMs;
|
|
149
|
+
for (;;) {
|
|
150
|
+
if ((await checkRunningInstance()).running)
|
|
151
|
+
return true;
|
|
152
|
+
if (Date.now() >= deadline)
|
|
153
|
+
return false;
|
|
154
|
+
await new Promise(resolve => setTimeout(resolve, 500));
|
|
155
|
+
}
|
|
156
|
+
}
|
|
33
157
|
export function isSea() {
|
|
34
158
|
if (_seaOverride !== null)
|
|
35
159
|
return _seaOverride;
|
|
@@ -448,7 +572,17 @@ function mergeHooksConfig(paths, hooksConfig, provider) {
|
|
|
448
572
|
}
|
|
449
573
|
}
|
|
450
574
|
const CLAUDE_INVALID_RULES = ['tracker_*'];
|
|
575
|
+
/** AGY validates every permissions.allow entry against this regex (verbatim
|
|
576
|
+
* from the agy CLI binary, 1.2.8) and ignores anything that fails it. */
|
|
577
|
+
const AGY_RULE_RE = /^(command|read_file|write_file|read_url|mcp|execute_url|unsandboxed)\s*\(.*\)$/;
|
|
451
578
|
export function pruneInvalidRules(allow, providerName) {
|
|
579
|
+
if (providerName === 'Antigravity') {
|
|
580
|
+
// Self-heal: strip Claude-syntax entries a previous install wrote into
|
|
581
|
+
// AGY's settings.json (mcp__apra-fleet__*, Agent(*), tracker_*, ...). AGY
|
|
582
|
+
// rejects them already, so removing them changes no effective grant -- it
|
|
583
|
+
// only stops fleet from leaving junk in a file the human user also owns.
|
|
584
|
+
return allow.filter(rule => AGY_RULE_RE.test(rule));
|
|
585
|
+
}
|
|
452
586
|
if (providerName !== 'Claude')
|
|
453
587
|
return allow;
|
|
454
588
|
return allow.filter(rule => !CLAUDE_INVALID_RULES.includes(rule));
|
|
@@ -472,7 +606,18 @@ export function buildRequiredPerms(paths) {
|
|
|
472
606
|
}
|
|
473
607
|
function mergePermissions(paths, extraPerms = []) {
|
|
474
608
|
const settings = readConfig(paths);
|
|
475
|
-
|
|
609
|
+
let requiredPerms = [...buildRequiredPerms(paths), ...extraPerms];
|
|
610
|
+
if (paths.name === 'Antigravity') {
|
|
611
|
+
// buildRequiredPerms speaks Claude's permission vocabulary. AGY accepts
|
|
612
|
+
// only `action(target)` strings from a fixed action set, so the Read(<dir>)
|
|
613
|
+
// grants are translated to read_file(<dir>) and the tokens with no AGY
|
|
614
|
+
// equivalent (mcp__apra-fleet__*, activate_skill(*), Agent(*), tracker_*)
|
|
615
|
+
// are dropped -- same "no Antigravity equivalent" handling the agent
|
|
616
|
+
// transform already applies to unsupported tools. Writing them verbatim
|
|
617
|
+
// left AGY with an allow-list it discarded wholesale, so every headless
|
|
618
|
+
// dispatch hit the auto-deny wall on its first tool call.
|
|
619
|
+
requiredPerms = formatAgyPermissionRules(convertClaudeAllowToAgyPermissions(requiredPerms));
|
|
620
|
+
}
|
|
476
621
|
settings.permissions = settings.permissions || {};
|
|
477
622
|
settings.permissions.allow = settings.permissions.allow || [];
|
|
478
623
|
settings.permissions.allow = pruneInvalidRules(settings.permissions.allow, paths.name);
|
|
@@ -489,10 +634,16 @@ function configureStatusline(paths, scriptPath, llm) {
|
|
|
489
634
|
let command;
|
|
490
635
|
if (process.platform === 'win32') {
|
|
491
636
|
if (llm === 'agy') {
|
|
492
|
-
const gitBash = 'C:\\Program Files\\Git\\bin\\bash.exe';
|
|
493
|
-
const bashBin = fs.existsSync(gitBash) ? `"${gitBash}"` : 'bash';
|
|
494
637
|
const formattedScriptPath = scriptPath.replace(/\\/g, '/');
|
|
495
|
-
|
|
638
|
+
const candidates = gitBashCandidates(process.env.LOCALAPPDATA);
|
|
639
|
+
const gitBash = candidates.find(c => fs.existsSync(c));
|
|
640
|
+
if (gitBash) {
|
|
641
|
+
const gitBin = path.dirname(gitBash);
|
|
642
|
+
command = `set PATH=${gitBin};%PATH% && bash '${formattedScriptPath}'`;
|
|
643
|
+
}
|
|
644
|
+
else {
|
|
645
|
+
command = `bash '${formattedScriptPath}'`;
|
|
646
|
+
}
|
|
496
647
|
}
|
|
497
648
|
else {
|
|
498
649
|
command = `bash "${scriptPath}"`;
|
|
@@ -520,7 +671,11 @@ function mergeAgyConfig(paths, mcpConfig) {
|
|
|
520
671
|
}
|
|
521
672
|
settings.mcpServers = settings.mcpServers || {};
|
|
522
673
|
settings.mcpServers['apra-fleet'] = mcpConfig;
|
|
523
|
-
|
|
674
|
+
const out = JSON.stringify(settings, null, 2) + '\n';
|
|
675
|
+
if (mcpConfig.headers)
|
|
676
|
+
writeOwnerOnlyFile(mcpConfigFile, out);
|
|
677
|
+
else
|
|
678
|
+
fs.writeFileSync(mcpConfigFile, out);
|
|
524
679
|
}
|
|
525
680
|
function writeDefaultModel(paths, standardModel) {
|
|
526
681
|
const settings = readConfig(paths);
|
|
@@ -533,25 +688,25 @@ function mergeCopilotConfig(paths, mcpConfig) {
|
|
|
533
688
|
const settings = readConfig(paths);
|
|
534
689
|
settings.mcpServers = settings.mcpServers || {};
|
|
535
690
|
settings.mcpServers['apra-fleet'] = mcpConfig;
|
|
536
|
-
writeConfig(paths, settings);
|
|
691
|
+
writeConfig(paths, settings, { ownerOnly: !!mcpConfig.headers });
|
|
537
692
|
}
|
|
538
693
|
function mergeOpenCodeConfig(paths, mcpConfig) {
|
|
539
694
|
const settings = readConfig(paths);
|
|
540
695
|
settings.mcp = settings.mcp || {};
|
|
541
696
|
settings.mcp['apra-fleet'] = mcpConfig.url
|
|
542
|
-
? { type: 'remote', url: mcpConfig.url, enabled: true }
|
|
697
|
+
? { type: 'remote', url: mcpConfig.url, enabled: true, ...(mcpConfig.headers ? { headers: mcpConfig.headers } : {}) }
|
|
543
698
|
: {
|
|
544
699
|
type: 'local',
|
|
545
700
|
command: [mcpConfig.command, ...(mcpConfig.args || [])],
|
|
546
701
|
enabled: true,
|
|
547
702
|
};
|
|
548
|
-
writeConfig(paths, settings);
|
|
703
|
+
writeConfig(paths, settings, { ownerOnly: !!mcpConfig.headers });
|
|
549
704
|
}
|
|
550
705
|
function mergeCodexConfig(paths, mcpConfig) {
|
|
551
706
|
const settings = readConfig(paths);
|
|
552
707
|
settings.mcp_servers = settings.mcp_servers || {};
|
|
553
708
|
if (mcpConfig.url) {
|
|
554
|
-
settings.mcp_servers['apra-fleet'] = { url: mcpConfig.url };
|
|
709
|
+
settings.mcp_servers['apra-fleet'] = { url: mcpConfig.url, ...(mcpConfig.headers ? { http_headers: mcpConfig.headers } : {}) };
|
|
555
710
|
}
|
|
556
711
|
else {
|
|
557
712
|
settings.mcp_servers['apra-fleet'] = {
|
|
@@ -559,12 +714,101 @@ function mergeCodexConfig(paths, mcpConfig) {
|
|
|
559
714
|
args: mcpConfig.args.map((a) => a.replace(/\\/g, '/')),
|
|
560
715
|
};
|
|
561
716
|
}
|
|
562
|
-
writeConfig(paths, settings);
|
|
717
|
+
writeConfig(paths, settings, { ownerOnly: !!mcpConfig.headers });
|
|
718
|
+
}
|
|
719
|
+
export { claudeUserConfigPath } from '../services/claude-local-scope-mcp.js';
|
|
720
|
+
/**
|
|
721
|
+
* Register the http apra-fleet server in claude's user scope WITHOUT putting
|
|
722
|
+
* the access secret in argv (`claude mcp add --header` is visible to other
|
|
723
|
+
* local users via ps): the entry is merged into the claude config file
|
|
724
|
+
* directly, which is kept owner-only. An unparseable existing file is never
|
|
725
|
+
* overwritten.
|
|
726
|
+
*/
|
|
727
|
+
export function registerClaudeHttpMcp(url, headers) {
|
|
728
|
+
const file = claudeUserConfigPath();
|
|
729
|
+
let settings = {};
|
|
730
|
+
if (fs.existsSync(file)) {
|
|
731
|
+
const raw = fs.readFileSync(file, 'utf-8').trim();
|
|
732
|
+
if (raw) {
|
|
733
|
+
try {
|
|
734
|
+
settings = JSON.parse(raw);
|
|
735
|
+
}
|
|
736
|
+
catch {
|
|
737
|
+
throw new Error(`${file} is not valid JSON; fix or remove it, then re-run 'apra-fleet install'`);
|
|
738
|
+
}
|
|
739
|
+
}
|
|
740
|
+
}
|
|
741
|
+
settings.mcpServers = settings.mcpServers || {};
|
|
742
|
+
settings.mcpServers['apra-fleet'] = { type: 'http', url, headers };
|
|
743
|
+
writeOwnerOnlyFileAtomic(file, JSON.stringify(settings, null, 2) + '\n');
|
|
744
|
+
}
|
|
745
|
+
/** Write the http (url + access-secret header) apra-fleet registration for one provider. */
|
|
746
|
+
export function registerHttpMcp(provider, paths, url, headers) {
|
|
747
|
+
if (provider === 'claude')
|
|
748
|
+
registerClaudeHttpMcp(url, headers);
|
|
749
|
+
else if (provider === 'codex')
|
|
750
|
+
mergeCodexConfig(paths, { url, headers });
|
|
751
|
+
else if (provider === 'copilot')
|
|
752
|
+
mergeCopilotConfig(paths, { url, type: 'http', headers });
|
|
753
|
+
else if (provider === 'agy')
|
|
754
|
+
mergeAgyConfig(paths, { url, headers });
|
|
755
|
+
else if (provider === 'opencode')
|
|
756
|
+
mergeOpenCodeConfig(paths, { url, headers });
|
|
757
|
+
}
|
|
758
|
+
/** The apra-fleet MCP entry `provider` has registered (parsed), or undefined. Never throws. */
|
|
759
|
+
function registeredMcpEntry(provider, paths) {
|
|
760
|
+
try {
|
|
761
|
+
if (provider === 'claude')
|
|
762
|
+
return readJsonOrEmpty(claudeUserConfigPath()).mcpServers?.['apra-fleet'];
|
|
763
|
+
if (provider === 'agy')
|
|
764
|
+
return readJsonOrEmpty(path.join(os.homedir(), '.gemini', 'config', 'mcp_config.json')).mcpServers?.['apra-fleet'];
|
|
765
|
+
const settings = readConfig(paths);
|
|
766
|
+
if (provider === 'codex')
|
|
767
|
+
return settings.mcp_servers?.['apra-fleet'];
|
|
768
|
+
if (provider === 'copilot')
|
|
769
|
+
return settings.mcpServers?.['apra-fleet'];
|
|
770
|
+
if (provider === 'opencode')
|
|
771
|
+
return settings.mcp?.['apra-fleet'];
|
|
772
|
+
}
|
|
773
|
+
catch { /* unreadable -> unknown */ }
|
|
774
|
+
return undefined;
|
|
775
|
+
}
|
|
776
|
+
/**
|
|
777
|
+
* Key-order-independent serialization of `provider`'s apra-fleet entry, to
|
|
778
|
+
* tell whether a registration write changed it (formatting and the rest of
|
|
779
|
+
* the file do not count).
|
|
780
|
+
*/
|
|
781
|
+
function mcpRegistrationSnapshot(provider, paths) {
|
|
782
|
+
const canon = (v) => Array.isArray(v) ? v.map(canon)
|
|
783
|
+
: v && typeof v === 'object' ? Object.fromEntries(Object.keys(v).sort().map(k => [k, canon(v[k])])) : v;
|
|
784
|
+
return JSON.stringify(canon(registeredMcpEntry(provider, paths)) ?? null);
|
|
785
|
+
}
|
|
786
|
+
function readJsonOrEmpty(file) {
|
|
787
|
+
try {
|
|
788
|
+
return fs.existsSync(file) ? JSON.parse(fs.readFileSync(file, 'utf-8')) : {};
|
|
789
|
+
}
|
|
790
|
+
catch {
|
|
791
|
+
return {};
|
|
792
|
+
}
|
|
793
|
+
}
|
|
794
|
+
/**
|
|
795
|
+
* The transport of the apra-fleet MCP entry `provider` currently has
|
|
796
|
+
* registered, read from the provider's own config (install-config.json
|
|
797
|
+
* records no transport): 'stdio' (a command entry), 'http' (a url entry), or
|
|
798
|
+
* undefined (no entry / unreadable config). Never throws.
|
|
799
|
+
*/
|
|
800
|
+
export function registeredMcpTransport(provider, paths) {
|
|
801
|
+
const classify = (e) => !e || typeof e !== 'object' ? undefined : e.url ? 'http' : e.command ? 'stdio' : undefined;
|
|
802
|
+
const e = registeredMcpEntry(provider, paths);
|
|
803
|
+
if (provider === 'opencode') {
|
|
804
|
+
return e?.type === 'remote' || e?.url ? 'http' : e?.type === 'local' || e?.command ? 'stdio' : undefined;
|
|
805
|
+
}
|
|
806
|
+
return classify(e);
|
|
563
807
|
}
|
|
564
808
|
function run(cmd, opts) {
|
|
565
809
|
// Windows needs a shell for .cmd executables (e.g. claude.cmd)
|
|
566
810
|
const shellOpt = process.platform === 'win32' ? { shell: 'cmd.exe' } : {};
|
|
567
|
-
execSync(cmd, { stdio: 'inherit', ...shellOpt, ...opts });
|
|
811
|
+
execSync(cmd, { stdio: 'inherit', windowsHide: true, ...shellOpt, ...opts });
|
|
568
812
|
}
|
|
569
813
|
/** Is `cmd` resolvable on PATH? Used before shelling out to a provider's own
|
|
570
814
|
* CLI (e.g. `claude`) so a missing binary degrades to a clear warning
|
|
@@ -572,48 +816,91 @@ function run(cmd, opts) {
|
|
|
572
816
|
function isCommandAvailable(cmd) {
|
|
573
817
|
try {
|
|
574
818
|
const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
|
|
575
|
-
execSync(checkCmd, { stdio: 'ignore' });
|
|
819
|
+
execSync(checkCmd, { stdio: 'ignore', windowsHide: true });
|
|
576
820
|
return true;
|
|
577
821
|
}
|
|
578
822
|
catch {
|
|
579
823
|
return false;
|
|
580
824
|
}
|
|
581
825
|
}
|
|
582
|
-
|
|
826
|
+
/**
|
|
827
|
+
* PIDs of every apra-fleet process currently running other than this one, as
|
|
828
|
+
* strings.
|
|
829
|
+
*
|
|
830
|
+
* OS-global on purpose -- isApraFleetRunning() is defined in terms of this and
|
|
831
|
+
* is the install guard's cheap first filter and uninstall.ts's running check.
|
|
832
|
+
* It is NOT what install --force stops or watches: that is scoped to
|
|
833
|
+
* relevantServerPids() (install-guard.ts). The current process is always
|
|
834
|
+
* excluded: the installer may itself be named apra-fleet (the fleet's member
|
|
835
|
+
* upgrade runs <home>/.apra-fleet/staging/apra-fleet, and a self-update runs
|
|
836
|
+
* the installed binary).
|
|
837
|
+
*/
|
|
838
|
+
export function apraFleetPids() {
|
|
583
839
|
try {
|
|
840
|
+
const currentPid = process.pid.toString();
|
|
584
841
|
if (process.platform === 'win32') {
|
|
585
|
-
const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe' });
|
|
586
|
-
const currentPid = process.pid.toString();
|
|
842
|
+
const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe', windowsHide: true });
|
|
587
843
|
// Each CSV line: "apra-fleet.exe","<PID>","..." - exclude the current installer process
|
|
588
|
-
return out.split('\n')
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
844
|
+
return out.split('\n')
|
|
845
|
+
.map(line => line.match(/"apra-fleet\.exe","(\d+)"/))
|
|
846
|
+
.filter((match) => match !== null)
|
|
847
|
+
.map(match => match[1])
|
|
848
|
+
.filter(pid => pid !== currentPid);
|
|
592
849
|
}
|
|
593
850
|
else {
|
|
594
|
-
// -x = exact name match; installer
|
|
595
|
-
//
|
|
596
|
-
const out = execSync('pgrep -x apra-fleet', { encoding: 'utf-8', stdio: 'pipe' });
|
|
597
|
-
|
|
598
|
-
|
|
851
|
+
// -x = exact name match; the installer itself may be named apra-fleet,
|
|
852
|
+
// so the current PID is excluded.
|
|
853
|
+
const out = execSync('pgrep -x apra-fleet', { encoding: 'utf-8', stdio: 'pipe', windowsHide: true });
|
|
854
|
+
return out.split('\n')
|
|
855
|
+
.map(line => line.trim())
|
|
856
|
+
.filter(pid => pid !== '' && pid !== currentPid);
|
|
599
857
|
}
|
|
600
858
|
}
|
|
601
859
|
catch {
|
|
602
|
-
return
|
|
860
|
+
return [];
|
|
603
861
|
}
|
|
604
862
|
}
|
|
605
|
-
export function
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
863
|
+
export function isApraFleetRunning() {
|
|
864
|
+
return apraFleetPids().length > 0;
|
|
865
|
+
}
|
|
866
|
+
/**
|
|
867
|
+
* Signal the given apra-fleet pids -- by PID, never by process name. A
|
|
868
|
+
* name-based kill (pkill -x apra-fleet / taskkill /IM apra-fleet.exe) also
|
|
869
|
+
* matches the installer when it is named apra-fleet, which killed the fleet's
|
|
870
|
+
* member upgrade mid-install (exit 143), and every unrelated apra-fleet server
|
|
871
|
+
* of the same user (apra-fleet-b4g.72). This process is never signalled, even
|
|
872
|
+
* when passed in. A pid that already exited is ignored.
|
|
873
|
+
*/
|
|
874
|
+
export function killApraFleet(pids, signal = 'SIGTERM') {
|
|
875
|
+
for (const raw of pids) {
|
|
876
|
+
const pid = Number(raw);
|
|
877
|
+
if (!Number.isInteger(pid) || pid <= 0 || pid === process.pid)
|
|
878
|
+
continue;
|
|
879
|
+
try {
|
|
880
|
+
if (process.platform === 'win32') {
|
|
881
|
+
// taskkill /F is already forceful -- no softer signal to escalate from,
|
|
882
|
+
// so SIGKILL escalation on Windows just reissues the same command.
|
|
883
|
+
execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore', windowsHide: true });
|
|
884
|
+
}
|
|
885
|
+
else {
|
|
886
|
+
process.kill(pid, signal);
|
|
887
|
+
}
|
|
888
|
+
}
|
|
889
|
+
catch {
|
|
890
|
+
// Already gone (ESRCH / taskkill "not found"): nothing to stop.
|
|
891
|
+
}
|
|
615
892
|
}
|
|
616
893
|
}
|
|
894
|
+
/** Manual stop advice: the pids still running, plus the by-name fallback. */
|
|
895
|
+
function manualStopHint(pids) {
|
|
896
|
+
const byName = process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pkill -x apra-fleet';
|
|
897
|
+
if (pids.length === 0)
|
|
898
|
+
return byName;
|
|
899
|
+
const byPid = process.platform === 'win32'
|
|
900
|
+
? pids.map(pid => ` taskkill /F /PID ${pid}`).join('\n')
|
|
901
|
+
: ` kill ${pids.join(' ')}`;
|
|
902
|
+
return `${byPid}\n or, when no other apra-fleet server of yours must keep running:\n${byName}`;
|
|
903
|
+
}
|
|
617
904
|
const PROD_INSTALL_FORCE_TIMING = { pollIntervalMs: 200, graceMs: 3000, killGraceMs: 2000 };
|
|
618
905
|
// Tests run with NODE_ENV=test (see tests/setup.ts) and don't fake these timers,
|
|
619
906
|
// so default to a much shorter window there to keep the suite fast, unless a
|
|
@@ -631,30 +918,101 @@ function installForceTiming() {
|
|
|
631
918
|
return process.env.NODE_ENV === 'test' ? TEST_INSTALL_FORCE_TIMING : PROD_INSTALL_FORCE_TIMING;
|
|
632
919
|
}
|
|
633
920
|
/**
|
|
634
|
-
* Wait for
|
|
635
|
-
*
|
|
636
|
-
*
|
|
637
|
-
* polls again over a second (shorter) window.
|
|
638
|
-
*
|
|
639
|
-
*
|
|
640
|
-
*
|
|
641
|
-
*
|
|
921
|
+
* Wait for the relevant apra-fleet pids (`listPids`, re-evaluated on every
|
|
922
|
+
* poll; never this process) to exit after killApraFleet() sends SIGTERM. If
|
|
923
|
+
* any is still alive once the grace window elapses, escalates to SIGKILL
|
|
924
|
+
* against exactly those and polls again over a second (shorter) window.
|
|
925
|
+
* Returns as soon as none is detected, or once both windows have elapsed --
|
|
926
|
+
* callers should not assume termination is guaranteed in the latter case (see
|
|
927
|
+
* apra-fleet-l7n.3 for surfacing that failure to the operator instead of
|
|
928
|
+
* asserting success).
|
|
642
929
|
*/
|
|
643
|
-
export async function waitForApraFleetToStop() {
|
|
930
|
+
export async function waitForApraFleetToStop(listPids) {
|
|
644
931
|
const { pollIntervalMs, graceMs, killGraceMs } = installForceTiming();
|
|
645
932
|
let deadline = Date.now() + graceMs;
|
|
646
|
-
|
|
933
|
+
let pids = listPids();
|
|
934
|
+
while (pids.length > 0 && Date.now() < deadline) {
|
|
647
935
|
await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
|
|
936
|
+
pids = listPids();
|
|
648
937
|
}
|
|
649
|
-
if (
|
|
938
|
+
if (pids.length === 0)
|
|
650
939
|
return;
|
|
651
|
-
// Grace window elapsed and a
|
|
652
|
-
killApraFleet('SIGKILL');
|
|
940
|
+
// Grace window elapsed and a relevant apra-fleet process is still alive -- escalate.
|
|
941
|
+
killApraFleet(pids, 'SIGKILL');
|
|
653
942
|
deadline = Date.now() + killGraceMs;
|
|
654
|
-
while (
|
|
943
|
+
while (listPids().length > 0 && Date.now() < deadline) {
|
|
655
944
|
await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
|
|
656
945
|
}
|
|
657
946
|
}
|
|
947
|
+
// --- install --force service-aware stop ---
|
|
948
|
+
//
|
|
949
|
+
// killApraFleet() signals the server's pid directly. When the server is
|
|
950
|
+
// registered with the platform service manager that is a race the installer
|
|
951
|
+
// cannot win: the macOS LaunchAgent this installer writes declares
|
|
952
|
+
// KeepAlive/SuccessfulExit=false (src/services/service-manager/macos.ts), so
|
|
953
|
+
// launchd relaunches the server under a NEW pid the instant a SIGKILL takes it
|
|
954
|
+
// down, and the liveness poll below then reports "still running" forever. The
|
|
955
|
+
// systemd unit's Restart=on-failure has the same shape. The remedy is to stop
|
|
956
|
+
// the SERVICE first: ServiceManager.stop() performs a graceful shutdown that
|
|
957
|
+
// exits 0, which neither supervisor restarts.
|
|
958
|
+
/**
|
|
959
|
+
* The platform ServiceManager, but only when a service is actually registered.
|
|
960
|
+
* Any failure to determine that (no systemd, unsupported platform, adapter
|
|
961
|
+
* error) is indistinguishable from "nothing registered" for the guard's
|
|
962
|
+
* purposes, so it degrades to the historical kill path rather than throwing.
|
|
963
|
+
*/
|
|
964
|
+
async function registeredServiceManager() {
|
|
965
|
+
try {
|
|
966
|
+
const mgr = await getServiceManager();
|
|
967
|
+
return (await mgr.isInstalled()) ? mgr : null;
|
|
968
|
+
}
|
|
969
|
+
catch {
|
|
970
|
+
return null;
|
|
971
|
+
}
|
|
972
|
+
}
|
|
973
|
+
/** Exact command an operator can run to bring the registered service back up. */
|
|
974
|
+
export function serviceRestartCommand() {
|
|
975
|
+
switch (process.platform) {
|
|
976
|
+
// A stop disables the task (its repeating trigger would undo the stop);
|
|
977
|
+
// apra-fleet start re-enables it before running it.
|
|
978
|
+
case 'win32': return 'apra-fleet start';
|
|
979
|
+
case 'linux': return `systemctl --user start ${LINUX_UNIT_NAME}`;
|
|
980
|
+
case 'darwin': return `launchctl kickstart -k gui/${macosGuiUid()}/${MACOS_PLIST_LABEL}`;
|
|
981
|
+
default: return 'apra-fleet install';
|
|
982
|
+
}
|
|
983
|
+
}
|
|
984
|
+
/** Exact command an operator can run to take the registered service down. */
|
|
985
|
+
export function serviceStopCommand() {
|
|
986
|
+
switch (process.platform) {
|
|
987
|
+
// apra-fleet stop disables the task (its repeating trigger would undo a
|
|
988
|
+
// bare /end) and records the stop so nothing restarts the server.
|
|
989
|
+
case 'win32': return 'apra-fleet stop';
|
|
990
|
+
case 'linux': return `systemctl --user stop ${LINUX_UNIT_NAME}`;
|
|
991
|
+
case 'darwin': return `launchctl bootout gui/${macosGuiUid()}/${MACOS_PLIST_LABEL}`;
|
|
992
|
+
default: return 'apra-fleet uninstall';
|
|
993
|
+
}
|
|
994
|
+
}
|
|
995
|
+
// Resolved in JS, never left to shell expansion: the printed command must be
|
|
996
|
+
// copy-pasteable as-is (mirrors getUid() in service-manager/macos.ts).
|
|
997
|
+
function macosGuiUid() {
|
|
998
|
+
return typeof process.getuid === 'function' ? String(process.getuid()) : '501';
|
|
999
|
+
}
|
|
1000
|
+
/**
|
|
1001
|
+
* Poll for the server to disappear after ServiceManager.stop(), WITHOUT
|
|
1002
|
+
* signalling it -- signalling is exactly what loses the race against a
|
|
1003
|
+
* supervisor relaunch. Returns the pids still observed once the window closes
|
|
1004
|
+
* (empty when the service is down).
|
|
1005
|
+
*/
|
|
1006
|
+
async function waitForServiceStop(listPids) {
|
|
1007
|
+
const { pollIntervalMs, graceMs } = installForceTiming();
|
|
1008
|
+
const deadline = Date.now() + graceMs;
|
|
1009
|
+
let pids = listPids();
|
|
1010
|
+
while (pids.length > 0 && Date.now() < deadline) {
|
|
1011
|
+
await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
|
|
1012
|
+
pids = listPids();
|
|
1013
|
+
}
|
|
1014
|
+
return pids;
|
|
1015
|
+
}
|
|
658
1016
|
/**
|
|
659
1017
|
* Write empty .ignore overlay files into a LOCAL agy member's workspace to block
|
|
660
1018
|
* the global apra-fleet MCP server and PM/fleet skills from loading inside that
|
|
@@ -697,6 +1055,42 @@ function copyGlobalBible(repoCwd) {
|
|
|
697
1055
|
console.warn(' [WARN] Global knowledge bible copy skipped:', err instanceof Error ? err.message : String(err));
|
|
698
1056
|
}
|
|
699
1057
|
}
|
|
1058
|
+
/** The one next step a member install prints: the orchestrator registers the
|
|
1059
|
+
* member, which also writes its per-folder apra-fleet MCP entry. */
|
|
1060
|
+
export const MEMBER_INSTALL_NEXT_STEP = 'Next step (on the orchestrator): run update_member {member_id, fleet_install: "auto"} (or register_member) for this member; ' +
|
|
1061
|
+
'it registers the member on this install and writes its per-folder apra-fleet MCP entry.';
|
|
1062
|
+
/**
|
|
1063
|
+
* The port a member install records: --port <n> / --port=<n>, else
|
|
1064
|
+
* APRA_FLEET_PORT, else the port an earlier member install in this data dir
|
|
1065
|
+
* recorded (an upgrade keeps it), else the built-in default. `explicit` is
|
|
1066
|
+
* true when --port was passed. --port that disagrees with APRA_FLEET_PORT is
|
|
1067
|
+
* an error: the two would put the server and its record on different ports.
|
|
1068
|
+
*/
|
|
1069
|
+
export function resolveMemberInstallPort(args, envPort, recordedPort) {
|
|
1070
|
+
let raw;
|
|
1071
|
+
const eq = args.find(a => a.startsWith('--port='));
|
|
1072
|
+
if (eq)
|
|
1073
|
+
raw = eq.slice('--port='.length);
|
|
1074
|
+
else {
|
|
1075
|
+
const i = args.indexOf('--port');
|
|
1076
|
+
if (i >= 0) {
|
|
1077
|
+
raw = args[i + 1];
|
|
1078
|
+
if (raw === undefined || raw.startsWith('-'))
|
|
1079
|
+
return { error: '--port requires a port number (1-65535).' };
|
|
1080
|
+
}
|
|
1081
|
+
}
|
|
1082
|
+
const env = envPort !== undefined && envPort !== '' ? validPort(envPort) : undefined;
|
|
1083
|
+
if (raw !== undefined) {
|
|
1084
|
+
const port = validPort(raw);
|
|
1085
|
+
if (port === undefined)
|
|
1086
|
+
return { error: `--port must be a port number (1-65535), got "${raw}".` };
|
|
1087
|
+
if (env !== undefined && env !== port) {
|
|
1088
|
+
return { error: `--port ${port} disagrees with APRA_FLEET_PORT=${env}; pass one of them.` };
|
|
1089
|
+
}
|
|
1090
|
+
return { port, explicit: true };
|
|
1091
|
+
}
|
|
1092
|
+
return { port: env ?? recordedPort ?? BUILTIN_DEFAULT_PORT, explicit: false };
|
|
1093
|
+
}
|
|
700
1094
|
export async function runInstall(args) {
|
|
701
1095
|
// --help / -h guard - must come first, before any side effects (#142)
|
|
702
1096
|
if (args.includes('--help') || args.includes('-h')) {
|
|
@@ -712,6 +1106,7 @@ Usage:
|
|
|
712
1106
|
apra-fleet install --skill none Skip skill installation
|
|
713
1107
|
apra-fleet install --no-skill Same as --skill none
|
|
714
1108
|
apra-fleet install --workflows none Skip installing the workflow runtime + built-in workflows
|
|
1109
|
+
apra-fleet install --member Member install: server + user-mode auto-start only (see below)
|
|
715
1110
|
apra-fleet install --force Stop a running server before installing
|
|
716
1111
|
apra-fleet install --llm <provider> Target LLM provider: claude (default), codex, copilot, agy, opencode
|
|
717
1112
|
apra-fleet install --transport http Register MCP server with HTTP transport (default)
|
|
@@ -725,10 +1120,29 @@ Options:
|
|
|
725
1120
|
fleet server at http://localhost:7523/mcp. stdio runs fleet as a subprocess.
|
|
726
1121
|
--skill <mode> Which skills to install: all (default), fleet, pm, or none.
|
|
727
1122
|
--no-skill Alias for --skill none.
|
|
1123
|
+
--member Install only the server and its user-mode auto-start. Implies
|
|
1124
|
+
--skill none --workflows none; writes NO user-scope MCP entry,
|
|
1125
|
+
hooks/statusline/permissions settings or ~/.claude/CLAUDE.md block.
|
|
1126
|
+
Fails with E-MEMBER-AUTOSTART if the auto-start cannot be registered.
|
|
728
1127
|
--workflows <mode> Which workflow assets to install: all (default) or none. Installs
|
|
729
1128
|
~/.apra-fleet/node_modules (workflow runtime), /schemas (agent role
|
|
730
1129
|
schemas), and /workflows/{fleet-sprint,hello-world} (built-in workflows).
|
|
731
|
-
|
|
1130
|
+
fleet-se requires Node.js 22.16+ and npm.
|
|
1131
|
+
--force Stop a running apra-fleet server before installing (SEA mode only).
|
|
1132
|
+
With --member, only a server a previous member install left behind
|
|
1133
|
+
is stopped; anything else is refused (E-FULL-INSTALL-RUNNING).
|
|
1134
|
+
--ignore-running-sprints
|
|
1135
|
+
Install even while a fleet-sprint supervisor or sprint is running for this
|
|
1136
|
+
user; the server is replaced underneath them (ones started under 0.4.3 or
|
|
1137
|
+
earlier then fail with HTTP 401 until restarted). Without it install
|
|
1138
|
+
refuses (E-FLEET-SE-RUNNING); --force does not override this.
|
|
1139
|
+
--force-stop-full-install
|
|
1140
|
+
With --member --force: also stop a running server that was not started
|
|
1141
|
+
by a member install (e.g. a full install on a shared machine).
|
|
1142
|
+
--port <n> With --member: the port this member install's server listens on
|
|
1143
|
+
(default: APRA_FLEET_PORT, else the port a previous member install
|
|
1144
|
+
recorded, else 7523). Recorded in the member-install marker; use a
|
|
1145
|
+
different port for each Unix user's member install on one host.`);
|
|
732
1146
|
process.exit(0);
|
|
733
1147
|
return;
|
|
734
1148
|
}
|
|
@@ -744,7 +1158,7 @@ Options:
|
|
|
744
1158
|
llm = args[idx + 1];
|
|
745
1159
|
}
|
|
746
1160
|
}
|
|
747
|
-
const supported =
|
|
1161
|
+
const supported = INSTALLABLE_LLM_PROVIDERS;
|
|
748
1162
|
if (!supported.includes(llm)) {
|
|
749
1163
|
console.error(`Error: Unsupported LLM provider "${llm}". Supported: ${supported.join(', ')}`);
|
|
750
1164
|
process.exit(1);
|
|
@@ -806,6 +1220,7 @@ Options:
|
|
|
806
1220
|
}
|
|
807
1221
|
// Parse --force flag
|
|
808
1222
|
const force = args.includes('--force');
|
|
1223
|
+
const forceStopFullInstall = args.includes(FORCE_STOP_FULL_INSTALL_FLAG);
|
|
809
1224
|
let transport = 'http';
|
|
810
1225
|
const transportEqualArg = args.find(a => a.startsWith('--transport='));
|
|
811
1226
|
if (transportEqualArg) {
|
|
@@ -832,8 +1247,14 @@ Options:
|
|
|
832
1247
|
}
|
|
833
1248
|
}
|
|
834
1249
|
// Reject unknown flags to catch typos early
|
|
835
|
-
const
|
|
836
|
-
|
|
1250
|
+
const memberMode = args.includes('--member');
|
|
1251
|
+
if (memberMode) {
|
|
1252
|
+
// A member install carries the server only: no skills, no workflows.
|
|
1253
|
+
skillMode = 'none';
|
|
1254
|
+
workflowsMode = 'none';
|
|
1255
|
+
}
|
|
1256
|
+
const knownFlagPrefixes = ['--llm=', '--skill=', '--transport=', '--workflows=', '--port='];
|
|
1257
|
+
const knownFlagExact = new Set(['--member', '--llm', '--skill', '--no-skill', '--workflows', '--force', FORCE_STOP_FULL_INSTALL_FLAG, IGNORE_RUNNING_SPRINTS_FLAG, '--transport', '--port', '--help', '-h']);
|
|
837
1258
|
for (const a of args) {
|
|
838
1259
|
if (knownFlagExact.has(a))
|
|
839
1260
|
continue;
|
|
@@ -844,11 +1265,83 @@ Options:
|
|
|
844
1265
|
console.error(`Error: Unknown option "${a}". Run apra-fleet install --help for usage.`);
|
|
845
1266
|
process.exit(1);
|
|
846
1267
|
}
|
|
1268
|
+
// The port a member install's server listens on, recorded in the marker
|
|
1269
|
+
// (the server reads it back at launch; the orchestrator reads it for the
|
|
1270
|
+
// member's MCP URL). Only a member install takes --port.
|
|
1271
|
+
const memberPortChoice = resolveMemberInstallPort(args, process.env.APRA_FLEET_PORT, recordedMemberInstallPort());
|
|
1272
|
+
if ('error' in memberPortChoice) {
|
|
1273
|
+
console.error(`Error: ${memberPortChoice.error}`);
|
|
1274
|
+
process.exit(1);
|
|
1275
|
+
}
|
|
1276
|
+
if (memberPortChoice.explicit && !memberMode) {
|
|
1277
|
+
console.error('Error: --port is only valid with --member (a full install uses APRA_FLEET_PORT).');
|
|
1278
|
+
process.exit(1);
|
|
1279
|
+
}
|
|
1280
|
+
const memberPort = memberPortChoice.port;
|
|
847
1281
|
const installFleet = skillMode === 'fleet' || skillMode === 'pm' || skillMode === 'all';
|
|
848
1282
|
const installPm = skillMode === 'pm' || skillMode === 'all';
|
|
849
1283
|
const installAgents = installPm && paths.agentsDir !== undefined;
|
|
850
1284
|
const installWorkflows = workflowsMode === 'all';
|
|
1285
|
+
// fleet-se prerequisites: fail before the running-process guard so nothing is stopped or written.
|
|
1286
|
+
if (installWorkflows && fleetSePrereqCheckEnabled()) {
|
|
1287
|
+
const prereq = checkFleetSePrereqs(fleetSePrereqProbes);
|
|
1288
|
+
if (!prereq.ok) {
|
|
1289
|
+
console.error(`Error: ${prereq.message}`);
|
|
1290
|
+
process.exit(1);
|
|
1291
|
+
}
|
|
1292
|
+
}
|
|
1293
|
+
// Running fleet-sprint supervisor/sprint guard: before the running-server
|
|
1294
|
+
// guard so a refusal stops and writes nothing. --force does not bypass it
|
|
1295
|
+
// (update always passes --force); only the dedicated flag does. A member
|
|
1296
|
+
// install is exempt: it installs no fleet-se and is driven remotely by the
|
|
1297
|
+
// orchestrator, whose own host runs the sprints.
|
|
1298
|
+
if (!memberMode && !args.includes(IGNORE_RUNNING_SPRINTS_FLAG)
|
|
1299
|
+
&& (isSea() || isNpmGlobalInstall()) && fleetSeGuardEnabled()) {
|
|
1300
|
+
let found = null;
|
|
1301
|
+
try {
|
|
1302
|
+
found = await detectRunningFleetSe(fleetSeProbes);
|
|
1303
|
+
}
|
|
1304
|
+
catch (err) {
|
|
1305
|
+
console.warn(`WARNING: could not check for a running fleet-sprint supervisor or sprint (${err.message}). If one is running, stop it before upgrading.`);
|
|
1306
|
+
}
|
|
1307
|
+
for (const w of found?.warnings ?? [])
|
|
1308
|
+
console.warn(`WARNING: ${w}`);
|
|
1309
|
+
if (found && (found.supervisor || found.sprints.length > 0)) {
|
|
1310
|
+
const self = (a) => selfInvocationLines({
|
|
1311
|
+
platform: process.platform, execPath: process.execPath, scriptPath: process.argv[1], sea: isSea(), args: ['install', ...a],
|
|
1312
|
+
});
|
|
1313
|
+
const text = fleetSeRefusalText(found, {
|
|
1314
|
+
platform: process.platform,
|
|
1315
|
+
rerunLines: self(args),
|
|
1316
|
+
ignoreLines: self([...args, IGNORE_RUNNING_SPRINTS_FLAG]),
|
|
1317
|
+
});
|
|
1318
|
+
console.error(text);
|
|
1319
|
+
// apra-fleet update runs install detached with no console: persist it
|
|
1320
|
+
// for the next service verb.
|
|
1321
|
+
writeServiceNotice(text.trim(), undefined, new Date(), Boolean(process.stderr.isTTY));
|
|
1322
|
+
process.exit(1);
|
|
1323
|
+
return;
|
|
1324
|
+
}
|
|
1325
|
+
}
|
|
1326
|
+
// Past the guard: a refusal persisted by an earlier (detached) install is
|
|
1327
|
+
// obsolete and must not be shown after this install succeeds. All OSes --
|
|
1328
|
+
// only the Windows service manager clears notices on registration.
|
|
1329
|
+
clearServiceNoticeContaining('E-FLEET-SE-RUNNING');
|
|
851
1330
|
const serviceStep = isSea() && transport === 'http';
|
|
1331
|
+
// A member install exists to leave an auto-starting server behind. With no
|
|
1332
|
+
// service step (stdio transport or non-SEA install) nothing would register
|
|
1333
|
+
// the auto-start, so fail loudly before touching anything.
|
|
1334
|
+
if (memberMode && !serviceStep) {
|
|
1335
|
+
const why = transport !== 'http'
|
|
1336
|
+
? `--transport ${transport} has no auto-start (use --transport http)`
|
|
1337
|
+
: 'a non-SEA (dev) install has no auto-start (use the SEA binary)';
|
|
1338
|
+
console.error(`
|
|
1339
|
+
Error: E-MEMBER-AUTOSTART: --member requires the user-mode auto-start, but ${why}.
|
|
1340
|
+
Nothing was installed.
|
|
1341
|
+
`);
|
|
1342
|
+
process.exitCode = 1;
|
|
1343
|
+
return;
|
|
1344
|
+
}
|
|
852
1345
|
let totalSteps = (installFleet && installPm) ? 8 : installFleet ? 7 : installPm ? 8 : 6;
|
|
853
1346
|
if (installAgents)
|
|
854
1347
|
totalSteps++;
|
|
@@ -862,8 +1355,8 @@ Options:
|
|
|
862
1355
|
totalSteps++;
|
|
863
1356
|
// --- Running-process guard (SEA + npm modes -- dev mode runs via node, not a managed binary) ---
|
|
864
1357
|
//
|
|
865
|
-
// isApraFleetRunning() is OS-global on purpose (
|
|
866
|
-
//
|
|
1358
|
+
// isApraFleetRunning() is OS-global on purpose (uninstall.ts depends on
|
|
1359
|
+
// that). It is only the cheap first filter here:
|
|
867
1360
|
// classifyRunningServer() then decides whether the running server is actually
|
|
868
1361
|
// relevant to THIS install -- recorded live in the target data dir, or running
|
|
869
1362
|
// from the install prefix we are about to overwrite (ETXTBSY). An unrelated
|
|
@@ -875,36 +1368,106 @@ Options:
|
|
|
875
1368
|
if (runningScope && !runningScope.relevant) {
|
|
876
1369
|
console.log(`\n Note: an unrelated apra-fleet server is running -- ${runningScope.detail}.\n It is not associated with this install (data dir ${getInstallDataDir()}, prefix ${BIN_DIR}), so it is left running.\n`);
|
|
877
1370
|
}
|
|
1371
|
+
// Set when the --force guard below stopped a REGISTERED service, so the
|
|
1372
|
+
// binary-copy step can bring it back up instead of leaving it down.
|
|
1373
|
+
let guardServiceMgr = null;
|
|
1374
|
+
let guardStoppedService = false;
|
|
878
1375
|
if (runningScope?.relevant) {
|
|
879
1376
|
if (!force) {
|
|
880
1377
|
const killHint = process.platform === 'win32'
|
|
881
1378
|
? ' taskkill /F /IM apra-fleet.exe'
|
|
882
1379
|
: ' pkill -x apra-fleet';
|
|
1380
|
+
// Name THIS executable, not "apra-fleet": a downloaded installer is
|
|
1381
|
+
// usually not on PATH, and PATH may resolve to the older installed one.
|
|
1382
|
+
const forceHint = selfInvocationLines({
|
|
1383
|
+
platform: process.platform,
|
|
1384
|
+
execPath: process.execPath,
|
|
1385
|
+
scriptPath: process.argv[1],
|
|
1386
|
+
sea: isSea(),
|
|
1387
|
+
args: ['install', ...args.filter(a => a !== '--force'), '--force'],
|
|
1388
|
+
}).map(l => ` ${l}`).join('\n');
|
|
883
1389
|
console.error(`
|
|
884
1390
|
Error: apra-fleet is currently running. Stop the server before installing.
|
|
885
1391
|
(${runningScope.detail})
|
|
886
1392
|
|
|
887
1393
|
Run with --force to stop it automatically:
|
|
888
|
-
|
|
1394
|
+
${forceHint}
|
|
889
1395
|
|
|
890
1396
|
Or stop it manually:
|
|
891
1397
|
${killHint}
|
|
892
1398
|
`);
|
|
893
1399
|
process.exit(1);
|
|
894
1400
|
}
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
if (
|
|
1401
|
+
// A member install (fleet's remote upgrade path) never stops a server it
|
|
1402
|
+
// did not start unless explicitly told to: nothing has been stopped yet.
|
|
1403
|
+
if (!memberForceMayStop({ memberMode, overridden: forceStopFullInstall })) {
|
|
1404
|
+
console.error(fullInstallRefusalText(runningScope.detail));
|
|
1405
|
+
process.exit(3);
|
|
1406
|
+
}
|
|
1407
|
+
// Only the pids relevant to THIS install are stopped or watched -- by pid,
|
|
1408
|
+
// never by name, never this process (which may itself be named apra-fleet).
|
|
1409
|
+
// Unrelated apra-fleet servers of the same user are left alone.
|
|
1410
|
+
const relevantPids = () => relevantServerPids(BIN_DIR).map(String);
|
|
1411
|
+
// Snapshot BEFORE anything is stopped: a pid that is present afterwards but
|
|
1412
|
+
// absent here is a supervisor relaunch, not a process refusing to die.
|
|
1413
|
+
const pidsBeforeStop = relevantPids();
|
|
1414
|
+
guardServiceMgr = await registeredServiceManager();
|
|
1415
|
+
if (guardServiceMgr) {
|
|
1416
|
+
// A service is registered: stop the SERVICE, never pkill first.
|
|
1417
|
+
console.log(' Registered service detected -- stopping it through the service manager.');
|
|
1418
|
+
try {
|
|
1419
|
+
await guardServiceMgr.stop();
|
|
1420
|
+
guardStoppedService = true;
|
|
1421
|
+
}
|
|
1422
|
+
catch (err) {
|
|
1423
|
+
console.warn(` Service stop failed: ${err.message}`);
|
|
1424
|
+
}
|
|
1425
|
+
const stillUp = await waitForServiceStop(relevantPids);
|
|
1426
|
+
// Escalate ONLY when the very same pids are still there -- i.e. nothing
|
|
1427
|
+
// relaunched the server and there is no supervisor race to lose. If a NEW
|
|
1428
|
+
// pid appeared, signalling is futile and is deliberately skipped so the
|
|
1429
|
+
// relaunch is reported instead of retried forever.
|
|
1430
|
+
if (stillUp.length > 0 && stillUp.every(pid => pidsBeforeStop.includes(pid))) {
|
|
1431
|
+
killApraFleet(stillUp);
|
|
1432
|
+
await waitForApraFleetToStop(relevantPids);
|
|
1433
|
+
}
|
|
1434
|
+
}
|
|
1435
|
+
else {
|
|
1436
|
+
// No service registered: signal the relevant pids directly.
|
|
1437
|
+
killApraFleet(pidsBeforeStop);
|
|
1438
|
+
await waitForApraFleetToStop(relevantPids);
|
|
1439
|
+
}
|
|
1440
|
+
const pidsAfterStop = relevantPids();
|
|
1441
|
+
if (pidsAfterStop.length > 0) {
|
|
1442
|
+
const relaunchedPids = pidsAfterStop.filter(pid => !pidsBeforeStop.includes(pid));
|
|
1443
|
+
if (relaunchedPids.length > 0) {
|
|
1444
|
+
console.error(`
|
|
1445
|
+
Error: the apra-fleet server was RELAUNCHED by its service supervisor while
|
|
1446
|
+
install --force was stopping it -- the observed pid changed between polls (was
|
|
1447
|
+
${pidsBeforeStop.join(', ') || 'none'}, now ${pidsAfterStop.join(', ')}), so it did not merely refuse to die.
|
|
1448
|
+
Signalling the process cannot win that race. Stop the service itself,
|
|
1449
|
+
then re-run the install:
|
|
1450
|
+
${serviceStopCommand()}
|
|
1451
|
+
`);
|
|
1452
|
+
process.exit(1);
|
|
1453
|
+
}
|
|
898
1454
|
console.error(`
|
|
899
1455
|
Error: could not stop the running apra-fleet server (it is still running after
|
|
900
1456
|
SIGTERM and a SIGKILL escalation). Stop it manually before installing:
|
|
901
|
-
${
|
|
1457
|
+
${manualStopHint(pidsAfterStop)}
|
|
902
1458
|
`);
|
|
903
1459
|
process.exit(1);
|
|
904
1460
|
}
|
|
905
|
-
console.log(
|
|
1461
|
+
console.log(pidsBeforeStop.length > 0 || guardStoppedService
|
|
1462
|
+
? ' Stopped running server.'
|
|
1463
|
+
: ' No running server process of this install was found to stop.');
|
|
906
1464
|
}
|
|
907
1465
|
console.log(`\nInstalling Apra Fleet ${serverVersion} for ${paths.name}...\n`);
|
|
1466
|
+
// Installing is an explicit (re)start intent: end a previous 'apra-fleet stop'.
|
|
1467
|
+
{
|
|
1468
|
+
const { clearStoppedMarker } = await import('../services/stopped-marker.js');
|
|
1469
|
+
clearStoppedMarker();
|
|
1470
|
+
}
|
|
908
1471
|
// --- Step 1: Copy binary ---
|
|
909
1472
|
let binaryPath = '';
|
|
910
1473
|
if (isSea()) {
|
|
@@ -924,6 +1487,25 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
924
1487
|
else {
|
|
925
1488
|
console.log(` [1/${totalSteps}] Dev mode -- skipping binary copy`);
|
|
926
1489
|
}
|
|
1490
|
+
// A registered service that the --force guard stopped must never be left
|
|
1491
|
+
// permanently down. When serviceStep is set the final install step
|
|
1492
|
+
// re-registers and starts it, so restarting here would only add a redundant
|
|
1493
|
+
// bootout/bootstrap cycle mid-install; otherwise nothing else would ever
|
|
1494
|
+
// bring it back, so start it now that the new binary is in place. Either way
|
|
1495
|
+
// the exact restart command is printed, so a failure at any later step stays
|
|
1496
|
+
// recoverable by hand.
|
|
1497
|
+
if (guardStoppedService && guardServiceMgr) {
|
|
1498
|
+
console.log(` The registered service was stopped by --force. Restart command: ${serviceRestartCommand()}`);
|
|
1499
|
+
if (!serviceStep) {
|
|
1500
|
+
try {
|
|
1501
|
+
await guardServiceMgr.start();
|
|
1502
|
+
console.log(' Restarted the registered service.');
|
|
1503
|
+
}
|
|
1504
|
+
catch (err) {
|
|
1505
|
+
console.warn(` [WARN] Could not restart the registered service: ${err.message}`);
|
|
1506
|
+
}
|
|
1507
|
+
}
|
|
1508
|
+
}
|
|
927
1509
|
// --- Step 2: Extract hooks ---
|
|
928
1510
|
console.log(` [2/${totalSteps}] Installing hooks...`);
|
|
929
1511
|
const manifest = loadManifest();
|
|
@@ -948,7 +1530,10 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
948
1530
|
// --- Step 4: Configure hooks + statusline in settings.json ---
|
|
949
1531
|
console.log(` [4/${totalSteps}] Configuring ${paths.name} settings...`);
|
|
950
1532
|
// OpenCode has a strict config schema -- hooks/statusLine/defaultModel are not valid keys
|
|
951
|
-
if (
|
|
1533
|
+
if (memberMode) {
|
|
1534
|
+
console.log(' Skipped (--member): user-scope settings are left untouched.');
|
|
1535
|
+
}
|
|
1536
|
+
else if (llm !== 'opencode') {
|
|
952
1537
|
const installedHooksConfig = JSON.parse(fs.readFileSync(path.join(HOOKS_DIR, 'hooks-config.json'), 'utf-8'));
|
|
953
1538
|
mergeHooksConfig(paths, installedHooksConfig, llm);
|
|
954
1539
|
const statuslineScript = path.join(SCRIPTS_DIR, 'fleet-statusline.sh');
|
|
@@ -960,33 +1545,61 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
960
1545
|
console.log(` [5/${totalSteps}] Registering MCP server...`);
|
|
961
1546
|
const fleetPort = DEFAULT_PORT;
|
|
962
1547
|
const fleetUrl = `http://localhost:${fleetPort}/mcp`;
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
966
|
-
|
|
967
|
-
|
|
968
|
-
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
|
|
1548
|
+
// The server refuses an /mcp session without this install's access secret
|
|
1549
|
+
// (an owner-only file in its data dir), so every http registration carries
|
|
1550
|
+
// it as a header. Re-running install rewrites existing registrations.
|
|
1551
|
+
const secretExisted = readMemberAccessSecret() !== null;
|
|
1552
|
+
const fleetAccessHeaders = { [MEMBER_SECRET_HEADER]: getOrCreateMemberAccessSecret() };
|
|
1553
|
+
// Open LLM CLI sessions keep the MCP config they started with; a new secret
|
|
1554
|
+
// or a rewritten registration needs them restarted (reported at the end).
|
|
1555
|
+
// stdio registrations are not gated by the secret.
|
|
1556
|
+
let registrationChanged = !secretExisted && transport === 'http';
|
|
1557
|
+
if (memberMode) {
|
|
1558
|
+
// The per-folder member entry is written by compose_permissions; a member
|
|
1559
|
+
// install must never register apra-fleet in any provider's user-scope config.
|
|
1560
|
+
console.log(' Skipped (--member): no user-scope MCP registration.');
|
|
1561
|
+
}
|
|
1562
|
+
else if (transport === 'http') {
|
|
1563
|
+
const before = mcpRegistrationSnapshot(llm, paths);
|
|
1564
|
+
registerHttpMcp(llm, paths, fleetUrl, fleetAccessHeaders);
|
|
1565
|
+
if (mcpRegistrationSnapshot(llm, paths) !== before)
|
|
1566
|
+
registrationChanged = true;
|
|
1567
|
+
// Upgrade path: every OTHER provider this install registered earlier holds a
|
|
1568
|
+
// header-less http entry the server now refuses; rewrite those too. Each
|
|
1569
|
+
// provider keeps its own transport: a stdio entry (its own server process,
|
|
1570
|
+
// not gated by the access secret) is left untouched, and a provider with
|
|
1571
|
+
// no apra-fleet entry is not given one by another provider's install.
|
|
1572
|
+
for (const other of Object.keys(readInstallConfig().providers)) {
|
|
1573
|
+
if (other === llm || !INSTALLABLE_LLM_PROVIDERS.includes(other))
|
|
1574
|
+
continue;
|
|
1575
|
+
try {
|
|
1576
|
+
const otherPaths = getProviderInstallConfig(other);
|
|
1577
|
+
const existing = registeredMcpTransport(other, otherPaths);
|
|
1578
|
+
if (existing !== 'http') {
|
|
1579
|
+
console.log(` ${other}: ${existing === 'stdio' ? 'stdio registration kept as is' : 'no apra-fleet registration, skipped'}`);
|
|
1580
|
+
continue;
|
|
974
1581
|
}
|
|
975
|
-
|
|
976
|
-
|
|
1582
|
+
const otherBefore = mcpRegistrationSnapshot(other, otherPaths);
|
|
1583
|
+
registerHttpMcp(other, otherPaths, fleetUrl, fleetAccessHeaders);
|
|
1584
|
+
if (mcpRegistrationSnapshot(other, otherPaths) !== otherBefore)
|
|
1585
|
+
registrationChanged = true;
|
|
1586
|
+
}
|
|
1587
|
+
catch (err) {
|
|
1588
|
+
console.warn(` [!] could not refresh the ${other} MCP registration with the access secret: ${err instanceof Error ? err.message : String(err)}`);
|
|
977
1589
|
}
|
|
978
1590
|
}
|
|
979
|
-
|
|
980
|
-
|
|
981
|
-
|
|
982
|
-
|
|
983
|
-
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
1591
|
+
// Claude LOCAL-scope entries for this URL (e.g. an older `claude mcp add
|
|
1592
|
+
// apra-fleet` without --scope) win over the user-scope entry and stay
|
|
1593
|
+
// header-less: rewrite them with the secret too.
|
|
1594
|
+
try {
|
|
1595
|
+
const rewritten = refreshClaudeLocalScopeEntries(claudeUserConfigPath(), fleetUrl, fleetAccessHeaders);
|
|
1596
|
+
for (const project of rewritten)
|
|
1597
|
+
console.log(` claude: local-scope apra-fleet entry for ${project} rewritten with the access secret`);
|
|
1598
|
+
if (rewritten.length)
|
|
1599
|
+
registrationChanged = true;
|
|
987
1600
|
}
|
|
988
|
-
|
|
989
|
-
|
|
1601
|
+
catch (err) {
|
|
1602
|
+
console.warn(` [!] could not refresh claude local-scope apra-fleet entries: ${err instanceof Error ? err.message : String(err)}`);
|
|
990
1603
|
}
|
|
991
1604
|
}
|
|
992
1605
|
else {
|
|
@@ -1248,11 +1861,15 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1248
1861
|
// as a fallback), preserving this branch's no-dist/agents rule, and it
|
|
1249
1862
|
// recurses into _shared/ and schemas/ which the old flat readdir missed.
|
|
1250
1863
|
for (const { relPath, content: rawContent } of loadAgentAssets()) {
|
|
1864
|
+
// Every branch runs a transform -- the default one is NOT a passthrough. Claude
|
|
1865
|
+
// keeps the source frontmatter and every conditional's if-branch, but the
|
|
1866
|
+
// conditional markers themselves still have to be stripped or they ship
|
|
1867
|
+
// verbatim into the installed agent file (apra-fleet-oomh.1).
|
|
1251
1868
|
const content = llm === 'opencode'
|
|
1252
1869
|
? transformAgentForOpenCode(rawContent, relPath)
|
|
1253
1870
|
: llm === 'agy'
|
|
1254
1871
|
? transformAgentForAgy(rawContent, relPath)
|
|
1255
|
-
: rawContent;
|
|
1872
|
+
: transformAgentForClaude(rawContent, relPath);
|
|
1256
1873
|
writeAssetFile(path.join(agentsDestDir, relPath), content);
|
|
1257
1874
|
}
|
|
1258
1875
|
}
|
|
@@ -1309,26 +1926,22 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1309
1926
|
}
|
|
1310
1927
|
}
|
|
1311
1928
|
// --- Beads install step ---
|
|
1312
|
-
//
|
|
1313
|
-
//
|
|
1929
|
+
// PATH first, then BIN_DIR, then npm -g, then a user-level install into
|
|
1930
|
+
// BIN_DIR (see beads-install.ts). NON-FATAL like dolt, but LOUD: a member
|
|
1931
|
+
// without bd cannot run sprint work, so the reason and the fix are printed
|
|
1932
|
+
// and repeated in the summary.
|
|
1314
1933
|
// KB + code intelligence is the final step (before the optional service step),
|
|
1315
1934
|
// so Beads sits one slot earlier than it does on main.
|
|
1316
1935
|
const beadsStep = serviceStep ? totalSteps - 2 : totalSteps - 1;
|
|
1317
1936
|
console.log(` [${beadsStep}/${totalSteps}] Installing Beads task tracker...`);
|
|
1318
|
-
|
|
1319
|
-
|
|
1320
|
-
|
|
1321
|
-
execFileSync('bd', ['--version'], { stdio: 'pipe', shell: true });
|
|
1322
|
-
// already installed - skip
|
|
1323
|
-
}
|
|
1324
|
-
catch {
|
|
1325
|
-
// not installed - install it
|
|
1326
|
-
execFileSync('npm', ['install', '-g', '@beads/bd@1.1.2'], { stdio: 'inherit', shell: true });
|
|
1327
|
-
}
|
|
1937
|
+
const beadsResult = installBeads(BIN_DIR, beadsStepDeps());
|
|
1938
|
+
if (beadsResult.state === 'installed' && beadsResult.location === 'bin-dir') {
|
|
1939
|
+
console.log(` - bd installed for this user at ${beadsResult.binPath} (fleet commands find it there; add ${BIN_DIR} to your own shell PATH to use bd by hand)`);
|
|
1328
1940
|
}
|
|
1329
|
-
|
|
1330
|
-
|
|
1331
|
-
console.warn(
|
|
1941
|
+
else if (beadsResult.state === 'missing') {
|
|
1942
|
+
console.warn(` [!] Beads (bd) NOT installed: ${beadsResult.reason}`);
|
|
1943
|
+
console.warn(` [!] Fix: ${beadsResult.fix}`);
|
|
1944
|
+
console.warn(' - Beads install skipped - sprint work on this machine needs bd and will fail until it is installed');
|
|
1332
1945
|
}
|
|
1333
1946
|
// --- KB + code intelligence setup step ---
|
|
1334
1947
|
// Only runs when the installer is invoked from inside a git repository.
|
|
@@ -1349,7 +1962,7 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1349
1962
|
}
|
|
1350
1963
|
}
|
|
1351
1964
|
catch (err) {
|
|
1352
|
-
console.warn('
|
|
1965
|
+
console.warn(' [!] .mcp.json cleanup skipped:', err instanceof Error ? err.message : String(err));
|
|
1353
1966
|
}
|
|
1354
1967
|
}
|
|
1355
1968
|
else {
|
|
@@ -1368,26 +1981,33 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1368
1981
|
console.log(' [OK] Code intelligence provider config written');
|
|
1369
1982
|
}
|
|
1370
1983
|
catch (err) {
|
|
1371
|
-
console.warn('
|
|
1984
|
+
console.warn(' [!] Code intelligence config skipped:', err instanceof Error ? err.message : String(err));
|
|
1372
1985
|
}
|
|
1986
|
+
// Code intelligence runs through npx: warn now (inside this step, no new
|
|
1987
|
+
// numbered step) when node/npx cannot be resolved from the installer PATH.
|
|
1988
|
+
const codeIntelPathWarn = codeIntelPathWarning();
|
|
1989
|
+
if (codeIntelPathWarn)
|
|
1990
|
+
console.warn(` [!] ${codeIntelPathWarn}`);
|
|
1373
1991
|
// Write code intelligence routing instruction to ~/.claude/CLAUDE.md
|
|
1374
|
-
|
|
1375
|
-
|
|
1376
|
-
|
|
1377
|
-
|
|
1378
|
-
|
|
1379
|
-
|
|
1380
|
-
fs.
|
|
1381
|
-
|
|
1382
|
-
|
|
1992
|
+
// (never for a --member install: that file belongs to the member's user)
|
|
1993
|
+
if (!memberMode)
|
|
1994
|
+
try {
|
|
1995
|
+
const claudeMdPath = path.join(os.homedir(), '.claude', 'CLAUDE.md');
|
|
1996
|
+
const sentinel = '<!-- apra-fleet:code-intelligence -->';
|
|
1997
|
+
const block = `\n${sentinel}\nWhen code_graph, code_impact, code_query, or code_context tools are available,\nuse them for symbol lookups, call chain tracing, and impact analysis.\nNever use grep or file reads for structural questions when these tools are present.\n<!-- /apra-fleet:code-intelligence -->\n`;
|
|
1998
|
+
const existing = fs.existsSync(claudeMdPath) ? fs.readFileSync(claudeMdPath, 'utf-8') : '';
|
|
1999
|
+
if (!existing.includes(sentinel)) {
|
|
2000
|
+
fs.mkdirSync(path.dirname(claudeMdPath), { recursive: true });
|
|
2001
|
+
fs.appendFileSync(claudeMdPath, block);
|
|
2002
|
+
console.log(' [OK] Code intelligence routing instruction written to ~/.claude/CLAUDE.md');
|
|
2003
|
+
}
|
|
2004
|
+
}
|
|
2005
|
+
catch (err) {
|
|
2006
|
+
console.warn(' [!] ~/.claude/CLAUDE.md update skipped:', err instanceof Error ? err.message : String(err));
|
|
1383
2007
|
}
|
|
1384
|
-
}
|
|
1385
|
-
catch (err) {
|
|
1386
|
-
console.warn(' ⚠ ~/.claude/CLAUDE.md update skipped:', err instanceof Error ? err.message : String(err));
|
|
1387
|
-
}
|
|
1388
2008
|
// OpenCode uses --dangerously-skip-permissions and per-agent permission: frontmatter;
|
|
1389
2009
|
// a top-level "permissions" key is invalid in opencode.json
|
|
1390
|
-
if (llm !== 'opencode') {
|
|
2010
|
+
if (llm !== 'opencode' && !memberMode) {
|
|
1391
2011
|
const extraPerms = (llm === 'claude' && installPm)
|
|
1392
2012
|
? ['Bash(*)', 'Skill(auto-sprint)', 'Workflow(auto-sprint)']
|
|
1393
2013
|
: [];
|
|
@@ -1395,52 +2015,157 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1395
2015
|
}
|
|
1396
2016
|
// Write install-config.json (merge provider entry)
|
|
1397
2017
|
writeInstallConfig(llm, skillMode, workflowsMode);
|
|
2018
|
+
// The fleet owns this install from here on: record the marker BEFORE the
|
|
2019
|
+
// auto-start registration, which can fail. A failed auto-start still exits
|
|
2020
|
+
// non-zero (E-MEMBER-AUTOSTART) but leaves the marker, so the next fleet_install
|
|
2021
|
+
// "auto" recognises its own half-finished install and retries.
|
|
2022
|
+
if (memberMode)
|
|
2023
|
+
writeMemberInstallMarker(serverVersion, memberPort);
|
|
2024
|
+
// Every install holds a member access secret (owner-only, in its data dir):
|
|
2025
|
+
// its server accepts a ?member= session only with it, so another local
|
|
2026
|
+
// user's session cannot use this install. Created once, kept on reinstall
|
|
2027
|
+
// (sessions configured with it keep working). Best effort here -- the server
|
|
2028
|
+
// creates it at start too.
|
|
2029
|
+
try {
|
|
2030
|
+
const { getOrCreateMemberAccessSecret, memberAccessSecretPath } = await import('../services/member-access-secret.js');
|
|
2031
|
+
getOrCreateMemberAccessSecret(memberAccessSecretPath(getInstallDataDir()));
|
|
2032
|
+
}
|
|
2033
|
+
catch (err) {
|
|
2034
|
+
console.warn(' [!] member access secret not created:', err instanceof Error ? err.message : String(err));
|
|
2035
|
+
}
|
|
2036
|
+
// Windows: make the data dir and the secret owner-only NOW, and say so
|
|
2037
|
+
// loudly when icacls fails (the server only logs it). POSIX keeps its
|
|
2038
|
+
// chmod path (0600 file mode, 0700 dirs at server start).
|
|
2039
|
+
if (process.platform === 'win32') {
|
|
2040
|
+
try {
|
|
2041
|
+
const { ownerOnlyInstallWarnings } = await import('../utils/owner-only-fs.js');
|
|
2042
|
+
const { memberAccessSecretPath } = await import('../services/member-access-secret.js');
|
|
2043
|
+
const dataDir = getInstallDataDir();
|
|
2044
|
+
for (const line of ownerOnlyInstallWarnings([{ path: dataDir, kind: 'dir' }, { path: memberAccessSecretPath(dataDir), kind: 'file' }])) {
|
|
2045
|
+
console.warn(line);
|
|
2046
|
+
}
|
|
2047
|
+
}
|
|
2048
|
+
catch (err) {
|
|
2049
|
+
console.warn(' [!] owner-only permissions not checked:', err instanceof Error ? err.message : String(err));
|
|
2050
|
+
}
|
|
2051
|
+
}
|
|
1398
2052
|
// --- Step N: Register and start service (SEA + HTTP mode only) ---
|
|
1399
2053
|
let serviceRegistered = false;
|
|
2054
|
+
let serviceHealthy = null;
|
|
2055
|
+
let serviceReused = false;
|
|
2056
|
+
let serviceRunKey = false;
|
|
1400
2057
|
if (serviceStep) {
|
|
1401
2058
|
console.log(` [${totalSteps}/${totalSteps}] Registering and starting service...`);
|
|
2059
|
+
// The server refuses to start when its configured port is taken (no
|
|
2060
|
+
// random-port fallback, GitHub #584) -- say so here rather than leaving a
|
|
2061
|
+
// service that exits on every launch with the reason only in the log.
|
|
2062
|
+
{
|
|
2063
|
+
const { checkRunningInstance, isPortInUse, portInUseMessage, readServerInfoPid } = await import('../services/singleton.js');
|
|
2064
|
+
const probe = await checkRunningInstance();
|
|
2065
|
+
const serverPort = resolveServerPort();
|
|
2066
|
+
if (probe.state === 'gone' && await isPortInUse(serverPort, DEFAULT_HOST)) {
|
|
2067
|
+
const { findPortHolder, describePortConflict } = await import('../services/port-holder.js');
|
|
2068
|
+
const conflict = describePortConflict(serverPort, portInUseMessage(serverPort, readServerInfoPid()), await findPortHolder(serverPort), memberMode ? 'member' : 'full');
|
|
2069
|
+
// Another user's process holds this install's port (a second member
|
|
2070
|
+
// install on this host): the server can never start here, so fail
|
|
2071
|
+
// now with who holds it and the remedy, not after a dead service.
|
|
2072
|
+
if (conflict.foreign) {
|
|
2073
|
+
console.error(`
|
|
2074
|
+
Error: ${conflict.message}
|
|
2075
|
+
`);
|
|
2076
|
+
process.exitCode = 1;
|
|
2077
|
+
return;
|
|
2078
|
+
}
|
|
2079
|
+
console.warn(` Warning: ${conflict.message}`);
|
|
2080
|
+
}
|
|
2081
|
+
}
|
|
1402
2082
|
const svcMgr = await getServiceManager();
|
|
1403
2083
|
try {
|
|
1404
|
-
await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH);
|
|
2084
|
+
const registered = await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH);
|
|
2085
|
+
serviceReused = registered === 'reused';
|
|
2086
|
+
serviceRunKey = registered === 'run-key';
|
|
2087
|
+
if (serviceReused)
|
|
2088
|
+
console.log(' Could not recreate the service task -- existing task reused.');
|
|
2089
|
+
if (serviceRunKey) {
|
|
2090
|
+
console.log(' Could not create the scheduled task -- registered a per-user logon entry (HKCU Run) instead.');
|
|
2091
|
+
console.log(' This starts the server at logon but does NOT restart it if it stops; use apra-fleet start.');
|
|
2092
|
+
}
|
|
1405
2093
|
try {
|
|
1406
2094
|
await svcMgr.start();
|
|
1407
2095
|
serviceRegistered = true;
|
|
2096
|
+
// Never report "running" on the strength of the start call alone (a
|
|
2097
|
+
// launcher that cannot run, a refused port, a crash): ask /health.
|
|
2098
|
+
serviceHealthy = await waitForServiceHealth();
|
|
2099
|
+
if (serviceHealthy === false) {
|
|
2100
|
+
console.warn(` Service registered, but the server is not answering /health. Check ${LOG_FILE_PATH} and run apra-fleet status.`);
|
|
2101
|
+
}
|
|
1408
2102
|
}
|
|
1409
2103
|
catch (startErr) {
|
|
1410
|
-
|
|
1411
|
-
|
|
2104
|
+
// Never delete a reused task: it predates this install (e.g. elevated).
|
|
2105
|
+
if (!serviceReused) {
|
|
2106
|
+
try {
|
|
2107
|
+
await svcMgr.unregister();
|
|
2108
|
+
}
|
|
2109
|
+
catch { }
|
|
1412
2110
|
}
|
|
1413
|
-
catch { }
|
|
1414
2111
|
throw startErr;
|
|
1415
2112
|
}
|
|
1416
2113
|
}
|
|
1417
2114
|
catch (err) {
|
|
1418
2115
|
console.warn(` Service registration skipped: ${err.message}`);
|
|
2116
|
+
// A member install exists to leave an auto-starting server behind; without
|
|
2117
|
+
// the auto-start it is not a success, so say so with a typed status.
|
|
2118
|
+
if (memberMode) {
|
|
2119
|
+
console.error(`
|
|
2120
|
+
Error: E-MEMBER-AUTOSTART: the member install could not register the user-mode
|
|
2121
|
+
auto-start (${err.message}). The server binary is installed but will
|
|
2122
|
+
not start automatically.
|
|
2123
|
+
`);
|
|
2124
|
+
process.exitCode = 1;
|
|
2125
|
+
return;
|
|
2126
|
+
}
|
|
2127
|
+
// --force stopped the server; reporting success would leave it down silently.
|
|
2128
|
+
if (force && (runningScope?.relevant || guardStoppedService)) {
|
|
2129
|
+
const restartHint = guardStoppedService
|
|
2130
|
+
? `Start it with:\n ${serviceRestartCommand()}\nthen run 'apra-fleet status' for how to repair the service (apra-fleet never needs an elevated install).`
|
|
2131
|
+
: 'Start it with:\n apra-fleet start';
|
|
2132
|
+
console.error(`
|
|
2133
|
+
Error: install --force stopped the running apra-fleet server, but the service
|
|
2134
|
+
could not be registered/started, so the server is NOT running.
|
|
2135
|
+
${restartHint}
|
|
2136
|
+
`);
|
|
2137
|
+
process.exit(1);
|
|
2138
|
+
}
|
|
1419
2139
|
}
|
|
1420
2140
|
}
|
|
1421
2141
|
// --- Done ---
|
|
1422
|
-
|
|
1423
|
-
|
|
1424
|
-
|
|
1425
|
-
|
|
1426
|
-
|
|
1427
|
-
catch {
|
|
1428
|
-
beadsVersion = 'not available';
|
|
1429
|
-
}
|
|
2142
|
+
if (!memberMode)
|
|
2143
|
+
clearMemberInstallMarker();
|
|
2144
|
+
const beadsVersion = beadsResult.state === 'missing'
|
|
2145
|
+
? `not available -- ${beadsResult.reason}. Fix: ${beadsResult.fix}`
|
|
2146
|
+
: `${beadsResult.version}${beadsResult.location === 'bin-dir' ? ` (${beadsResult.binPath})` : ''}`;
|
|
1430
2147
|
const clientName = llm === 'claude' ? 'Claude Code' : paths.name;
|
|
1431
|
-
|
|
1432
|
-
|
|
1433
|
-
const
|
|
2148
|
+
// A member install touched no user-scope settings or MCP registration, so it
|
|
2149
|
+
// names only what it did and the member's one next step (on the orchestrator).
|
|
2150
|
+
const instructions = memberMode
|
|
2151
|
+
? MEMBER_INSTALL_NEXT_STEP
|
|
2152
|
+
: llm === 'claude' ? 'Run /mcp in Claude Code to load the server.' : `Restart ${paths.name} to load the server.`;
|
|
2153
|
+
const forceNote = force && !memberMode ? `\nRestart ${clientName} to reload the MCP server.` : '';
|
|
2154
|
+
const accessNote = registrationChanged && !memberMode
|
|
2155
|
+
? '\n[!] Restart every open LLM CLI session (Claude Code, Codex, ...): sessions started before this install keep their old MCP registration without the access secret, and the server refuses them (Claude Code shows "Dynamic Client Registration rejected (HTTP 404)").'
|
|
2156
|
+
: '';
|
|
2157
|
+
const settingsLine = memberMode ? '' : `\n Settings: ${paths.settingsFile}`;
|
|
2158
|
+
const serviceState = serviceHealthy === true ? 'registered and running' : serviceHealthy === false ? 'registered, but NOT answering /health (see the warning above)' : 'registered (health not checked)';
|
|
2159
|
+
const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ? `${serviceState}${serviceReused ? ' (existing task reused)' : ''}${serviceRunKey ? ' (logon autostart via HKCU Run, no automatic restart)' : ''}` : 'registration skipped'}` : '';
|
|
1434
2160
|
console.log(`
|
|
1435
2161
|
Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
|
|
1436
2162
|
Binary: ${BIN_DIR}
|
|
1437
2163
|
Hooks: ${HOOKS_DIR}
|
|
1438
|
-
Scripts: ${SCRIPTS_DIR}
|
|
1439
|
-
Settings: ${paths.settingsFile}${installFleet ? `\n Fleet Skill: ${paths.fleetSkillsDir}` : ''}${installPm ? `\n PM Skill: ${paths.skillsDir}` : ''}${installAgents ? `\n Agents: ${paths.agentsDir}` : ''}
|
|
2164
|
+
Scripts: ${SCRIPTS_DIR}${settingsLine}${installFleet ? `\n Fleet Skill: ${paths.fleetSkillsDir}` : ''}${installPm ? `\n PM Skill: ${paths.skillsDir}` : ''}${installAgents ? `\n Agents: ${paths.agentsDir}` : ''}
|
|
1440
2165
|
Beads: ${beadsVersion}
|
|
1441
2166
|
Dolt: ${doltVersion}${serviceLine}
|
|
1442
2167
|
|
|
1443
|
-
${instructions}${forceNote}
|
|
2168
|
+
${instructions}${forceNote}${accessNote}
|
|
1444
2169
|
`);
|
|
1445
2170
|
if (llm === 'claude' && installPm) {
|
|
1446
2171
|
console.log(' /auto-sprint BD-1 (native workflow, current branch)');
|