@apralabs/apra-fleet 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
package/dist/index.js
CHANGED
|
@@ -36,6 +36,9 @@ Usage:
|
|
|
36
36
|
apra-fleet install --skill none Skip skill installation
|
|
37
37
|
apra-fleet install --no-skill Same as --skill none
|
|
38
38
|
apra-fleet register-member --name <name> --path <folder> [options] Register a fleet member from the shell (see 'register-member --help')
|
|
39
|
+
apra-fleet remove-member --id <uuid> [--force] Remove a member registration from this install (see 'remove-member --help')
|
|
40
|
+
apra-fleet call --member <uuid> <tool> [--args-file <path>] Call a tool as a member session (see 'call --help')
|
|
41
|
+
apra-fleet call --member <uuid> --list-tools List the member session's tools
|
|
39
42
|
apra-fleet uninstall Remove binary, hooks, and MCP registration
|
|
40
43
|
apra-fleet secret --set <name> Deliver a secret to a waiting request
|
|
41
44
|
apra-fleet secret --list List secrets
|
|
@@ -51,6 +54,7 @@ Usage:
|
|
|
51
54
|
apra-fleet kb reject-directive <id> Reject a proposal or retire an active directive
|
|
52
55
|
apra-fleet kb add-directive "<text>" [--symbols a,b] Create an already-active directive (human-only)
|
|
53
56
|
apra-fleet kb commit [--repo <path>] [--global] Re-export + auto-commit the canonical bible (manual/recovery)
|
|
57
|
+
apra-fleet kb profile [full|developer|custom <a,b>] Show or set the KB tool profile for interactive sessions
|
|
54
58
|
apra-fleet join <member-jwt> [--hub-url <url>] Activate a device using a member JWT obtained out-of-band from fleet-dashboard
|
|
55
59
|
apra-fleet spoke <origin-member-id> Run as an outbound hub-connected spoke; requires apra-fleet join first
|
|
56
60
|
apra-fleet --version Print version
|
|
@@ -73,6 +77,16 @@ else if (arg === 'register-member') {
|
|
|
73
77
|
.then(m => m.runRegisterMember(process.argv.slice(3)))
|
|
74
78
|
.catch(err => { logError('cli', `Register-member failed: ${err.message}`); process.exit(1); });
|
|
75
79
|
}
|
|
80
|
+
else if (arg === 'remove-member') {
|
|
81
|
+
import('./cli/remove-member.js')
|
|
82
|
+
.then(m => m.runRemoveMember(process.argv.slice(3)))
|
|
83
|
+
.catch(err => { logError('cli', `Remove-member failed: ${err.message}`); process.exit(1); });
|
|
84
|
+
}
|
|
85
|
+
else if (arg === 'call') {
|
|
86
|
+
import('./cli/call.js')
|
|
87
|
+
.then(m => m.runCallCli(process.argv.slice(3)))
|
|
88
|
+
.catch(err => { logError('cli', `Call failed: ${err.message}`); process.exit(1); });
|
|
89
|
+
}
|
|
76
90
|
else if (arg === 'uninstall') {
|
|
77
91
|
import('./cli/uninstall.js')
|
|
78
92
|
.then(m => m.runUninstall(process.argv.slice(3)))
|
|
@@ -130,7 +144,7 @@ else if (arg === 'kb-server') {
|
|
|
130
144
|
import('./commands/kb-server.js')
|
|
131
145
|
.then(async (m) => {
|
|
132
146
|
const opts = m.parseKbServerArgs(process.argv.slice(3));
|
|
133
|
-
await m.startKbServer(opts.port, opts.generateToken, opts.dbPath);
|
|
147
|
+
await m.startKbServer(opts.port, opts.generateToken, opts.dbPath, opts.tokenFile);
|
|
134
148
|
})
|
|
135
149
|
.catch(err => { logError('cli', `kb-server failed: ${err.message}`); process.exit(1); });
|
|
136
150
|
}
|
|
@@ -169,6 +183,13 @@ else if (arg === 'kb') {
|
|
|
169
183
|
.then(code => process.exit(code))
|
|
170
184
|
.catch(err => { logError('cli', `kb commit failed: ${err.message}`); process.exit(1); });
|
|
171
185
|
}
|
|
186
|
+
else if (subCmd === 'profile') {
|
|
187
|
+
// GitHub #759: show/set the install-wide KB tool profile. Required because
|
|
188
|
+
// the developer profile hides kb_setup from interactive sessions.
|
|
189
|
+
import('./cli/kb-profile.js')
|
|
190
|
+
.then(m => process.exit(m.runKbProfile(process.argv.slice(4))))
|
|
191
|
+
.catch(err => { logError('cli', `kb profile failed: ${err.message}`); process.exit(1); });
|
|
192
|
+
}
|
|
172
193
|
else if (subCmd === 'import') {
|
|
173
194
|
// T2.2 (F4, D3): post-merge entry point for absorbing a merged bible into
|
|
174
195
|
// the local KB. Thin wrapper over the same kbImport the MCP tool uses.
|
|
@@ -258,6 +279,30 @@ else {
|
|
|
258
279
|
console.error(`\nRun 'apra-fleet --help' for usage.`);
|
|
259
280
|
process.exit(1);
|
|
260
281
|
}
|
|
282
|
+
/**
|
|
283
|
+
* Exit code for "refusing to start because another/foreign server holds the
|
|
284
|
+
* port or data dir" (GitHub #584). Under a service manager (systemd
|
|
285
|
+
* Restart=on-failure, launchd KeepAlive SuccessfulExit=false) a non-zero exit
|
|
286
|
+
* restarts the server every few seconds -- each attempt a new fleet-<pid>.log
|
|
287
|
+
* that `apra-fleet watch` then follows -- while the cause persists. Only a
|
|
288
|
+
* launch by such a service manager (launchedByServiceManager: the
|
|
289
|
+
* APRA_FLEET_SERVICE marker, systemd INVOCATION_ID, launchd XPC_SERVICE_NAME)
|
|
290
|
+
* exits 0, like the already-running case. Every other launch (terminal, CI,
|
|
291
|
+
* nohup, containers, scripts) exits 1 so the refusal stays visible.
|
|
292
|
+
*/
|
|
293
|
+
// Captured once by startHttpServer (which also strips our markers from the
|
|
294
|
+
// env so children never inherit them). Still "any service-manager hint":
|
|
295
|
+
// installs predating the APRA_FLEET_SERVICE marker rely on systemd/launchd
|
|
296
|
+
// vars, and for a refusal the only cost of a false positive (a hand-run shell
|
|
297
|
+
// under systemd) is exit code 0 instead of 1 -- the refusal is still printed.
|
|
298
|
+
let serviceManagedLaunch = null;
|
|
299
|
+
async function refusalExitCode() {
|
|
300
|
+
if (serviceManagedLaunch === null) {
|
|
301
|
+
const { launchedByServiceManager } = await import('./services/service-manager/types.js');
|
|
302
|
+
serviceManagedLaunch = launchedByServiceManager();
|
|
303
|
+
}
|
|
304
|
+
return serviceManagedLaunch ? 0 : 1;
|
|
305
|
+
}
|
|
261
306
|
function resolveTransport(args) {
|
|
262
307
|
if (args.length === 0)
|
|
263
308
|
return 'http';
|
|
@@ -273,6 +318,17 @@ function resolveTransport(args) {
|
|
|
273
318
|
}
|
|
274
319
|
return 'invalid';
|
|
275
320
|
}
|
|
321
|
+
/** Clear busy statuses persisted by a server that died mid-task. */
|
|
322
|
+
async function reconcileStartupBusyImpl() {
|
|
323
|
+
const { reconcileStaleBusy } = await import('./services/statusline.js');
|
|
324
|
+
const cleared = reconcileStaleBusy();
|
|
325
|
+
if (cleared.length > 0) {
|
|
326
|
+
logLine('startup', `reset stale busy status for ${cleared.length} member(s) left by a previous server: ${cleared.join(', ')}`);
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
function reconcileStartupBusy() {
|
|
330
|
+
void reconcileStartupBusyImpl().catch(() => { });
|
|
331
|
+
}
|
|
276
332
|
async function startStdioServer() {
|
|
277
333
|
const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
|
|
278
334
|
const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
|
|
@@ -328,20 +384,71 @@ async function startStdioServer() {
|
|
|
328
384
|
logLine('startup', `apra-fleet ${serverVersion} started transport=stdio${clientStr}${versionStr}${pidStr} FLEET_DIR=${FLEET_DIR}`);
|
|
329
385
|
idleManager.start();
|
|
330
386
|
void cleanupStaleTasks();
|
|
387
|
+
reconcileStartupBusy();
|
|
331
388
|
purgeExpiredCredentials();
|
|
332
389
|
void checkForUpdate();
|
|
390
|
+
// GitHub #562: leave a trace when the event loop freezes.
|
|
391
|
+
const { startEventLoopWatchdog } = await import('./services/event-loop-watchdog.js');
|
|
392
|
+
const { getActiveLogFile } = await import('./utils/log-helpers.js');
|
|
393
|
+
const watchdog = startEventLoopWatchdog({ logFile: getActiveLogFile() });
|
|
333
394
|
const { cleanupAuthSocket } = await import('./services/auth-socket.js');
|
|
334
|
-
|
|
335
|
-
|
|
395
|
+
// GitHub #585: every exit path (SIGINT/SIGTERM/SIGHUP/SIGBREAK, crashes)
|
|
396
|
+
// writes one synchronous shutdown record before the process exits.
|
|
397
|
+
const { installShutdownHandlers } = await import('./services/server-lifecycle.js');
|
|
398
|
+
let stdioStopping = false;
|
|
399
|
+
installShutdownHandlers(() => {
|
|
400
|
+
if (stdioStopping)
|
|
401
|
+
return;
|
|
402
|
+
stdioStopping = true;
|
|
403
|
+
void watchdog.stop();
|
|
404
|
+
cleanupAuthSocket().then(() => { closeAllConnections(); stallDetector.stop(); process.exit(0); });
|
|
405
|
+
});
|
|
336
406
|
}
|
|
337
407
|
async function startHttpServer() {
|
|
408
|
+
// GitHub #585 recovery: a service launch (logon, the Windows task's repeating
|
|
409
|
+
// revive trigger) that keeps failing backs off instead of retrying -- and
|
|
410
|
+
// writing a new fleet-<pid>.log -- every interval. See service-start-guard.ts.
|
|
411
|
+
const { consumeLaunchMarkers } = await import('./services/service-manager/types.js');
|
|
412
|
+
const launch = consumeLaunchMarkers();
|
|
413
|
+
serviceManagedLaunch = launch.managed;
|
|
414
|
+
// The stopped-by-user skip and the start backoff decide whether to start at
|
|
415
|
+
// all, so they apply ONLY to our own service templates (APRA_FLEET_SERVICE=1,
|
|
416
|
+
// set by the task wrapper, the plist and the unit) -- never to a hand-run
|
|
417
|
+
// `apra-fleet run` in a shell that merely inherited INVOCATION_ID or
|
|
418
|
+
// XPC_SERVICE_NAME (systemd-run --shell, tmux from a user unit, CI runners).
|
|
419
|
+
const startGuard = launch.service ? await import('./services/service-start-guard.js') : null;
|
|
420
|
+
if (startGuard) {
|
|
421
|
+
// A deliberate `apra-fleet stop` must stick across logon/boot on every OS:
|
|
422
|
+
// launchd RunAtLoad, an enabled systemd unit, the Windows HKCU Run
|
|
423
|
+
// fallback, or an old task that could not be disabled all launch us here.
|
|
424
|
+
// Exit 0 (launchd SuccessfulExit=false / systemd Restart=on-failure do not
|
|
425
|
+
// restart it) and KEEP the marker -- only `apra-fleet start`/install clear it.
|
|
426
|
+
const { readStoppedMarker, describeStoppedMarker } = await import('./services/stopped-marker.js');
|
|
427
|
+
const stopped = readStoppedMarker();
|
|
428
|
+
if (stopped) {
|
|
429
|
+
const line = `${new Date().toISOString()} apra-fleet service launch skipped: ${describeStoppedMarker(stopped)}`;
|
|
430
|
+
// Someone is watching (a console, or stderr on a mintty/Git Bash tty
|
|
431
|
+
// while stdout is piped): always say why.
|
|
432
|
+
if (process.stdout.isTTY || process.stderr.isTTY)
|
|
433
|
+
console.error(line);
|
|
434
|
+
else if (startGuard.shouldLogServiceNotice('stopped-by-user'))
|
|
435
|
+
console.log(line);
|
|
436
|
+
process.exit(0);
|
|
437
|
+
}
|
|
438
|
+
const skip = startGuard.serviceStartBackoff();
|
|
439
|
+
if (skip) {
|
|
440
|
+
console.log(`${new Date().toISOString()} ${skip}`);
|
|
441
|
+
process.exit(0);
|
|
442
|
+
}
|
|
443
|
+
startGuard.recordServiceStartAttempt();
|
|
444
|
+
}
|
|
338
445
|
const { loadOnboardingState, resetSessionFlags } = await import('./services/onboarding.js');
|
|
339
446
|
const { getAllAgents: getAgentsForStartup } = await import('./services/registry.js');
|
|
340
447
|
// Pass current member count so upgrade detection works: existing registry + no onboarding.json -> skip banner
|
|
341
448
|
loadOnboardingState(getAgentsForStartup().length);
|
|
342
449
|
resetSessionFlags();
|
|
343
|
-
const { checkRunningInstance, claimStartupLock } = await import('./services/singleton.js');
|
|
344
|
-
const { createHttpTransport } = await import('./services/http-transport.js');
|
|
450
|
+
const { checkRunningInstance, claimStartupLock, unresponsiveInstanceMessage, portInUseMessage, readServerInfoPid, describePreviousServer, } = await import('./services/singleton.js');
|
|
451
|
+
const { createHttpTransport, PortInUseError } = await import('./services/http-transport.js');
|
|
345
452
|
const { registerAllTools } = await import('./services/tool-registry.js');
|
|
346
453
|
const { FLEET_DIR, SERVER_INFO_PATH } = await import('./paths.js');
|
|
347
454
|
const { closeAllConnections } = await import('./services/ssh.js');
|
|
@@ -355,16 +462,53 @@ async function startHttpServer() {
|
|
|
355
462
|
// Detect already-running instance before starting
|
|
356
463
|
const instance = await checkRunningInstance();
|
|
357
464
|
if (instance.running) {
|
|
358
|
-
|
|
465
|
+
const msg = `apra-fleet already running at ${instance.url} pid=${instance.pid} -- exiting`;
|
|
466
|
+
if (startGuard) {
|
|
467
|
+
// Service launches (a revive-trigger tick) go to the service log only,
|
|
468
|
+
// not a fresh fleet-<pid>.log per tick, and at most once an hour (a
|
|
469
|
+
// server running outside the task would otherwise log ~288 lines/day).
|
|
470
|
+
if (startGuard.shouldLogServiceNotice('already-running')) {
|
|
471
|
+
console.log(`${new Date().toISOString()} ${msg}`);
|
|
472
|
+
}
|
|
473
|
+
startGuard.clearServiceStartFailures();
|
|
474
|
+
}
|
|
475
|
+
else {
|
|
476
|
+
logLine('startup', msg);
|
|
477
|
+
}
|
|
359
478
|
process.exit(0);
|
|
360
479
|
}
|
|
480
|
+
if (instance.state === 'gone') {
|
|
481
|
+
const previousNote = describePreviousServer(instance.previous);
|
|
482
|
+
if (previousNote)
|
|
483
|
+
logLine('startup', `${previousNote}; removed its stale server.json`);
|
|
484
|
+
}
|
|
485
|
+
if (instance.state === 'unresponsive') {
|
|
486
|
+
// A live server with a blocked event loop is not dead: starting a second
|
|
487
|
+
// one would split the fleet (GitHub #584). Refuse; the operator stops it.
|
|
488
|
+
logError('startup', unresponsiveInstanceMessage(instance));
|
|
489
|
+
process.exit(await refusalExitCode());
|
|
490
|
+
}
|
|
361
491
|
// Atomic startup lock to prevent concurrent double-start race
|
|
362
492
|
const lock = claimStartupLock();
|
|
363
493
|
if (!lock.acquired) {
|
|
364
494
|
logLine('startup', 'Another fleet instance is starting up -- exiting');
|
|
365
495
|
process.exit(0);
|
|
366
496
|
}
|
|
367
|
-
|
|
497
|
+
let handle;
|
|
498
|
+
try {
|
|
499
|
+
handle = await createHttpTransport({ registerTools: registerAllTools });
|
|
500
|
+
}
|
|
501
|
+
catch (err) {
|
|
502
|
+
lock.release();
|
|
503
|
+
if (err instanceof PortInUseError) {
|
|
504
|
+
const { findPortHolder, describePortConflict } = await import('./services/port-holder.js');
|
|
505
|
+
const { hasMemberInstallMarker } = await import('./cli/install-guard.js');
|
|
506
|
+
const conflict = describePortConflict(err.port, portInUseMessage(err.port, readServerInfoPid()), await findPortHolder(err.port), hasMemberInstallMarker() ? 'member' : 'full');
|
|
507
|
+
logError('startup', conflict.message);
|
|
508
|
+
process.exit(await refusalExitCode());
|
|
509
|
+
}
|
|
510
|
+
throw err;
|
|
511
|
+
}
|
|
368
512
|
// Write server.json so other processes can detect this instance
|
|
369
513
|
fs.mkdirSync(FLEET_DIR, { recursive: true });
|
|
370
514
|
fs.writeFileSync(SERVER_INFO_PATH, JSON.stringify({
|
|
@@ -376,6 +520,12 @@ async function startHttpServer() {
|
|
|
376
520
|
}));
|
|
377
521
|
// Release startup lock now that server.json is written (server.json is the long-lived detection mechanism)
|
|
378
522
|
lock.release();
|
|
523
|
+
// The stopped-by-user marker is NOT cleared here: only an explicit
|
|
524
|
+
// `apra-fleet start` / `apra-fleet install` ends a deliberate stop. (A
|
|
525
|
+
// service launch never gets this far while it exists; a manual `run`
|
|
526
|
+
// leaves it, so if this server later dies clients still do not
|
|
527
|
+
// auto-start -- the conservative side.)
|
|
528
|
+
startGuard?.clearServiceStartFailures();
|
|
379
529
|
// Make HTTP handle available to shutdown_server tool
|
|
380
530
|
setHttpHandle(handle);
|
|
381
531
|
const stallDetector = getStallDetector();
|
|
@@ -388,8 +538,13 @@ async function startHttpServer() {
|
|
|
388
538
|
logLine('startup', `apra-fleet ${serverVersion} started transport=http port=${handle.port} pid=${process.pid} FLEET_DIR=${FLEET_DIR}`);
|
|
389
539
|
idleManager.start();
|
|
390
540
|
void cleanupStaleTasks();
|
|
541
|
+
reconcileStartupBusy();
|
|
391
542
|
purgeExpiredCredentials();
|
|
392
543
|
void checkForUpdate();
|
|
544
|
+
// GitHub #562: leave a trace when the event loop freezes.
|
|
545
|
+
const { startEventLoopWatchdog } = await import('./services/event-loop-watchdog.js');
|
|
546
|
+
const { getActiveLogFile } = await import('./utils/log-helpers.js');
|
|
547
|
+
const watchdog = startEventLoopWatchdog({ logFile: getActiveLogFile() });
|
|
393
548
|
async function shutdown() {
|
|
394
549
|
try {
|
|
395
550
|
lock.release();
|
|
@@ -399,6 +554,10 @@ async function startHttpServer() {
|
|
|
399
554
|
fs.unlinkSync(SERVER_INFO_PATH);
|
|
400
555
|
}
|
|
401
556
|
catch { }
|
|
557
|
+
try {
|
|
558
|
+
await watchdog.stop();
|
|
559
|
+
}
|
|
560
|
+
catch { }
|
|
402
561
|
try {
|
|
403
562
|
await handle.close();
|
|
404
563
|
}
|
|
@@ -417,7 +576,16 @@ async function startHttpServer() {
|
|
|
417
576
|
catch { }
|
|
418
577
|
process.exit(0);
|
|
419
578
|
}
|
|
420
|
-
|
|
421
|
-
|
|
579
|
+
// GitHub #585: every exit path (SIGINT/SIGTERM/SIGHUP/SIGBREAK, POST
|
|
580
|
+
// /shutdown, shutdown_server, crashes) writes one synchronous shutdown
|
|
581
|
+
// record to fleet-<pid>.log before the process exits.
|
|
582
|
+
const { installShutdownHandlers } = await import('./services/server-lifecycle.js');
|
|
583
|
+
let stopping = false;
|
|
584
|
+
installShutdownHandlers(() => {
|
|
585
|
+
if (stopping)
|
|
586
|
+
return;
|
|
587
|
+
stopping = true;
|
|
588
|
+
void shutdown();
|
|
589
|
+
});
|
|
422
590
|
}
|
|
423
591
|
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Bounded child environment for local Windows spawns.
|
|
3
|
+
*
|
|
4
|
+
* Why this exists: on a Windows fleet host, `bd dolt pull/push` repeatedly
|
|
5
|
+
* failed with
|
|
6
|
+
* fork/exec C:\Program Files\Git\mingw64\bin\git.exe: Not enough memory
|
|
7
|
+
* resources are available to process this command.
|
|
8
|
+
* while tens of GB of RAM were free. That text is ERROR_NOT_ENOUGH_MEMORY (8)
|
|
9
|
+
* from CreateProcess. With RAM free, the known causes are an oversized
|
|
10
|
+
* environment block (every spawn copies the whole block into the child, and
|
|
11
|
+
* each nested hop -- fleet server -> PowerShell/bash -> bd -> dolt -> git --
|
|
12
|
+
* copies it again) and desktop-heap exhaustion in a non-interactive session.
|
|
13
|
+
* The first one the product controls: WindowsCommands.getCleanEnv() builds
|
|
14
|
+
* Path as Machine Path + ';' + User Path with no dedupe, and the gitbash
|
|
15
|
+
* variant inherits the fleet server's env wholesale. See
|
|
16
|
+
* docs/troubleshooting.md ("git spawned by bd/dolt fails with Not enough
|
|
17
|
+
* memory resources") for the evidence and what was and was not reproduced.
|
|
18
|
+
*
|
|
19
|
+
* The rule (pure, unit-tested in tests/child-env-bound.test.ts):
|
|
20
|
+
* 1. PATH is deduplicated: entries compared case-insensitively with
|
|
21
|
+
* trailing slashes ignored, first occurrence kept, empty entries
|
|
22
|
+
* dropped. All PATH-named keys (Path/PATH) are merged into the first.
|
|
23
|
+
* 2. If the env block is still larger than CHILD_ENV_BLOCK_CAP_CHARS, the
|
|
24
|
+
* largest NON-PROTECTED variables are dropped, largest first, until it
|
|
25
|
+
* fits. Protected variables (what bd/dolt/git and the provider CLIs need:
|
|
26
|
+
* PATH, HOME/USERPROFILE and the session vars, temp dirs, git/ssh/proxy
|
|
27
|
+
* config, and anything that looks like a credential) are never dropped.
|
|
28
|
+
* 3. If protected variables alone exceed the cap, the env is returned as
|
|
29
|
+
* small as the rule can make it and `overCap` is set so the caller can
|
|
30
|
+
* say so loudly -- the rule never drops PATH or a credential to fit.
|
|
31
|
+
*
|
|
32
|
+
* ASCII only.
|
|
33
|
+
*/
|
|
34
|
+
/**
|
|
35
|
+
* Cap on the child environment block, in UTF-16 code units (what Windows
|
|
36
|
+
* stores): 32767, the classic Windows environment-block limit and the hard
|
|
37
|
+
* per-variable limit. A normal Windows user env is 3-8K, so a block above
|
|
38
|
+
* this is a leak (duplicated PATH, an inherited oversized variable), not a
|
|
39
|
+
* legitimate need.
|
|
40
|
+
*/
|
|
41
|
+
export declare const CHILD_ENV_BLOCK_CAP_CHARS = 32767;
|
|
42
|
+
export declare function isProtectedEnvName(name: string): boolean;
|
|
43
|
+
/**
|
|
44
|
+
* Size of an environment block as CreateProcess sees it: each variable is
|
|
45
|
+
* `NAME=VALUE\0`, and the block ends with one extra `\0`. JS string length is
|
|
46
|
+
* UTF-16 code units, the same unit Windows uses.
|
|
47
|
+
*/
|
|
48
|
+
export declare function envBlockSize(env: Record<string, string>): number;
|
|
49
|
+
/** Dedupe a PATH value: case-insensitive, trailing slashes ignored, first wins, empties dropped. */
|
|
50
|
+
export declare function dedupePathValue(value: string, sep: string): string;
|
|
51
|
+
export interface BoundedEnvReport {
|
|
52
|
+
sizeBefore: number;
|
|
53
|
+
sizeAfter: number;
|
|
54
|
+
pathEntriesBefore: number;
|
|
55
|
+
pathEntriesAfter: number;
|
|
56
|
+
/** Names of variables dropped to fit the cap, largest first. */
|
|
57
|
+
dropped: string[];
|
|
58
|
+
/** True when protected variables alone exceed the cap. */
|
|
59
|
+
overCap: boolean;
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Apply the bounding rule (see the file header). Never mutates `env`.
|
|
63
|
+
*
|
|
64
|
+
* @param env the environment the child would otherwise receive
|
|
65
|
+
* @param opts.sep PATH separator (';' on Windows, the default)
|
|
66
|
+
* @param opts.capChars block cap in UTF-16 code units
|
|
67
|
+
*/
|
|
68
|
+
export declare function boundChildEnv(env: Record<string, string | undefined>, opts?: {
|
|
69
|
+
sep?: string;
|
|
70
|
+
capChars?: number;
|
|
71
|
+
}): {
|
|
72
|
+
env: Record<string, string>;
|
|
73
|
+
report: BoundedEnvReport;
|
|
74
|
+
};
|
|
75
|
+
/** One-line human summary of a report, for a warning log. */
|
|
76
|
+
export declare function describeBoundedEnv(report: BoundedEnvReport): string;
|
|
77
|
+
//# sourceMappingURL=child-env-bound.d.ts.map
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Bounded child environment for local Windows spawns.
|
|
3
|
+
*
|
|
4
|
+
* Why this exists: on a Windows fleet host, `bd dolt pull/push` repeatedly
|
|
5
|
+
* failed with
|
|
6
|
+
* fork/exec C:\Program Files\Git\mingw64\bin\git.exe: Not enough memory
|
|
7
|
+
* resources are available to process this command.
|
|
8
|
+
* while tens of GB of RAM were free. That text is ERROR_NOT_ENOUGH_MEMORY (8)
|
|
9
|
+
* from CreateProcess. With RAM free, the known causes are an oversized
|
|
10
|
+
* environment block (every spawn copies the whole block into the child, and
|
|
11
|
+
* each nested hop -- fleet server -> PowerShell/bash -> bd -> dolt -> git --
|
|
12
|
+
* copies it again) and desktop-heap exhaustion in a non-interactive session.
|
|
13
|
+
* The first one the product controls: WindowsCommands.getCleanEnv() builds
|
|
14
|
+
* Path as Machine Path + ';' + User Path with no dedupe, and the gitbash
|
|
15
|
+
* variant inherits the fleet server's env wholesale. See
|
|
16
|
+
* docs/troubleshooting.md ("git spawned by bd/dolt fails with Not enough
|
|
17
|
+
* memory resources") for the evidence and what was and was not reproduced.
|
|
18
|
+
*
|
|
19
|
+
* The rule (pure, unit-tested in tests/child-env-bound.test.ts):
|
|
20
|
+
* 1. PATH is deduplicated: entries compared case-insensitively with
|
|
21
|
+
* trailing slashes ignored, first occurrence kept, empty entries
|
|
22
|
+
* dropped. All PATH-named keys (Path/PATH) are merged into the first.
|
|
23
|
+
* 2. If the env block is still larger than CHILD_ENV_BLOCK_CAP_CHARS, the
|
|
24
|
+
* largest NON-PROTECTED variables are dropped, largest first, until it
|
|
25
|
+
* fits. Protected variables (what bd/dolt/git and the provider CLIs need:
|
|
26
|
+
* PATH, HOME/USERPROFILE and the session vars, temp dirs, git/ssh/proxy
|
|
27
|
+
* config, and anything that looks like a credential) are never dropped.
|
|
28
|
+
* 3. If protected variables alone exceed the cap, the env is returned as
|
|
29
|
+
* small as the rule can make it and `overCap` is set so the caller can
|
|
30
|
+
* say so loudly -- the rule never drops PATH or a credential to fit.
|
|
31
|
+
*
|
|
32
|
+
* ASCII only.
|
|
33
|
+
*/
|
|
34
|
+
/**
|
|
35
|
+
* Cap on the child environment block, in UTF-16 code units (what Windows
|
|
36
|
+
* stores): 32767, the classic Windows environment-block limit and the hard
|
|
37
|
+
* per-variable limit. A normal Windows user env is 3-8K, so a block above
|
|
38
|
+
* this is a leak (duplicated PATH, an inherited oversized variable), not a
|
|
39
|
+
* legitimate need.
|
|
40
|
+
*/
|
|
41
|
+
export const CHILD_ENV_BLOCK_CAP_CHARS = 32767;
|
|
42
|
+
/** Variable names (case-insensitive) a bd/dolt/git/provider child needs. */
|
|
43
|
+
const PROTECTED_NAMES = new Set([
|
|
44
|
+
'PATH', 'PATHEXT', 'HOME', 'USERPROFILE', 'HOMEDRIVE', 'HOMEPATH',
|
|
45
|
+
'USERNAME', 'USERDOMAIN', 'COMPUTERNAME', 'APPDATA', 'LOCALAPPDATA',
|
|
46
|
+
'PROGRAMDATA', 'PUBLIC', 'ALLUSERSPROFILE', 'SYSTEMROOT', 'SYSTEMDRIVE',
|
|
47
|
+
'WINDIR', 'COMSPEC', 'TEMP', 'TMP', 'TMPDIR',
|
|
48
|
+
'PROGRAMFILES', 'PROGRAMFILES(X86)', 'PROGRAMW6432',
|
|
49
|
+
'COMMONPROGRAMFILES', 'COMMONPROGRAMFILES(X86)', 'COMMONPROGRAMW6432',
|
|
50
|
+
'PSMODULEPATH', 'NUMBER_OF_PROCESSORS', 'PROCESSOR_ARCHITECTURE', 'OS',
|
|
51
|
+
'MSYSTEM', 'SHELL', 'TERM', 'LANG', 'LC_ALL', 'TZ',
|
|
52
|
+
'HTTP_PROXY', 'HTTPS_PROXY', 'NO_PROXY', 'ALL_PROXY',
|
|
53
|
+
]);
|
|
54
|
+
/** Name prefixes (case-insensitive) a bd/dolt/git/provider child needs. */
|
|
55
|
+
const PROTECTED_PREFIXES = [
|
|
56
|
+
'GIT_', 'GCM_', 'GH_', 'GITHUB_', 'SSH_', 'BEADS_', 'BD_', 'DOLT_',
|
|
57
|
+
'APRA_', 'FLEET_', 'ANTHROPIC_', 'CLAUDE_', 'OPENAI_', 'CODEX_',
|
|
58
|
+
'GEMINI_', 'GOOGLE_', 'COPILOT_', 'AWS_', 'AZURE_', 'NODE_', 'NPM_',
|
|
59
|
+
];
|
|
60
|
+
/** Anything that looks like a credential is never dropped. */
|
|
61
|
+
const CREDENTIAL_NAME_RE = /(TOKEN|SECRET|PASSWORD|PASSWD|CREDENTIAL|API_?KEY|AUTH)/i;
|
|
62
|
+
export function isProtectedEnvName(name) {
|
|
63
|
+
const upper = name.toUpperCase();
|
|
64
|
+
if (PROTECTED_NAMES.has(upper))
|
|
65
|
+
return true;
|
|
66
|
+
if (PROTECTED_PREFIXES.some((p) => upper.startsWith(p)))
|
|
67
|
+
return true;
|
|
68
|
+
return CREDENTIAL_NAME_RE.test(name);
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Size of an environment block as CreateProcess sees it: each variable is
|
|
72
|
+
* `NAME=VALUE\0`, and the block ends with one extra `\0`. JS string length is
|
|
73
|
+
* UTF-16 code units, the same unit Windows uses.
|
|
74
|
+
*/
|
|
75
|
+
export function envBlockSize(env) {
|
|
76
|
+
let size = 1;
|
|
77
|
+
for (const [k, v] of Object.entries(env))
|
|
78
|
+
size += k.length + 1 + v.length + 1;
|
|
79
|
+
return size;
|
|
80
|
+
}
|
|
81
|
+
/** Dedupe a PATH value: case-insensitive, trailing slashes ignored, first wins, empties dropped. */
|
|
82
|
+
export function dedupePathValue(value, sep) {
|
|
83
|
+
const seen = new Set();
|
|
84
|
+
const out = [];
|
|
85
|
+
for (const raw of value.split(sep)) {
|
|
86
|
+
const entry = raw.trim();
|
|
87
|
+
if (!entry)
|
|
88
|
+
continue;
|
|
89
|
+
const norm = entry.replace(/[\\/]+$/, '').toLowerCase();
|
|
90
|
+
if (seen.has(norm))
|
|
91
|
+
continue;
|
|
92
|
+
seen.add(norm);
|
|
93
|
+
out.push(entry);
|
|
94
|
+
}
|
|
95
|
+
return out.join(sep);
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Apply the bounding rule (see the file header). Never mutates `env`.
|
|
99
|
+
*
|
|
100
|
+
* @param env the environment the child would otherwise receive
|
|
101
|
+
* @param opts.sep PATH separator (';' on Windows, the default)
|
|
102
|
+
* @param opts.capChars block cap in UTF-16 code units
|
|
103
|
+
*/
|
|
104
|
+
export function boundChildEnv(env, opts = {}) {
|
|
105
|
+
const sep = opts.sep ?? ';';
|
|
106
|
+
const cap = opts.capChars ?? CHILD_ENV_BLOCK_CAP_CHARS;
|
|
107
|
+
const input = {};
|
|
108
|
+
for (const [k, v] of Object.entries(env))
|
|
109
|
+
if (v !== undefined)
|
|
110
|
+
input[k] = v;
|
|
111
|
+
const sizeBefore = envBlockSize(input);
|
|
112
|
+
const out = {};
|
|
113
|
+
let pathKey = null;
|
|
114
|
+
const pathParts = [];
|
|
115
|
+
for (const [k, v] of Object.entries(input)) {
|
|
116
|
+
if (k.toUpperCase() === 'PATH') {
|
|
117
|
+
if (pathKey === null) {
|
|
118
|
+
pathKey = k;
|
|
119
|
+
out[k] = '';
|
|
120
|
+
}
|
|
121
|
+
pathParts.push(v);
|
|
122
|
+
continue;
|
|
123
|
+
}
|
|
124
|
+
out[k] = v;
|
|
125
|
+
}
|
|
126
|
+
const rawPath = pathParts.join(sep);
|
|
127
|
+
const pathEntriesBefore = rawPath.split(sep).filter((e) => e.trim()).length;
|
|
128
|
+
let pathEntriesAfter = 0;
|
|
129
|
+
if (pathKey !== null) {
|
|
130
|
+
out[pathKey] = dedupePathValue(rawPath, sep);
|
|
131
|
+
pathEntriesAfter = out[pathKey] ? out[pathKey].split(sep).length : 0;
|
|
132
|
+
}
|
|
133
|
+
const dropped = [];
|
|
134
|
+
let size = envBlockSize(out);
|
|
135
|
+
if (size > cap) {
|
|
136
|
+
const candidates = Object.keys(out)
|
|
137
|
+
.filter((k) => !isProtectedEnvName(k))
|
|
138
|
+
.sort((a, b) => (b.length + out[b].length) - (a.length + out[a].length));
|
|
139
|
+
for (const k of candidates) {
|
|
140
|
+
if (size <= cap)
|
|
141
|
+
break;
|
|
142
|
+
size -= k.length + 1 + out[k].length + 1;
|
|
143
|
+
delete out[k];
|
|
144
|
+
dropped.push(k);
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
return {
|
|
148
|
+
env: out,
|
|
149
|
+
report: {
|
|
150
|
+
sizeBefore,
|
|
151
|
+
sizeAfter: size,
|
|
152
|
+
pathEntriesBefore,
|
|
153
|
+
pathEntriesAfter,
|
|
154
|
+
dropped,
|
|
155
|
+
overCap: size > cap,
|
|
156
|
+
},
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
/** One-line human summary of a report, for a warning log. */
|
|
160
|
+
export function describeBoundedEnv(report) {
|
|
161
|
+
const parts = [
|
|
162
|
+
`child env block ${report.sizeBefore} -> ${report.sizeAfter} chars (cap ${CHILD_ENV_BLOCK_CAP_CHARS})`,
|
|
163
|
+
`PATH entries ${report.pathEntriesBefore} -> ${report.pathEntriesAfter}`,
|
|
164
|
+
];
|
|
165
|
+
if (report.dropped.length)
|
|
166
|
+
parts.push(`dropped oversized vars: ${report.dropped.join(', ')}`);
|
|
167
|
+
if (report.overCap)
|
|
168
|
+
parts.push('STILL OVER CAP from protected vars alone (PATH/credentials) -- Windows may refuse to spawn child processes ("Not enough memory resources")');
|
|
169
|
+
return parts.join('; ');
|
|
170
|
+
}
|
|
171
|
+
//# sourceMappingURL=child-env-bound.js.map
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The git executable every fleet-server git spawn uses.
|
|
3
|
+
*
|
|
4
|
+
* On Windows, CreateProcess (and libuv's own search, which Node's child_process
|
|
5
|
+
* uses) looks in the CURRENT DIRECTORY before PATH when a bare program name is
|
|
6
|
+
* given. Every KB / code-intelligence git call runs with a work folder as its
|
|
7
|
+
* cwd, so `execFileSync('git', ..., { cwd: workFolder })` would run a git.exe
|
|
8
|
+
* planted at the root of that work folder instead of the real git
|
|
9
|
+
* (apra-fleet-rx6b).
|
|
10
|
+
*
|
|
11
|
+
* gitExecutable() therefore resolves git ONCE, on win32, to an absolute path
|
|
12
|
+
* taken ONLY from PATH entries -- never the process cwd or any spawn cwd:
|
|
13
|
+
* - empty and relative PATH entries are skipped (a relative entry, like an
|
|
14
|
+
* empty one, would be resolved against the cwd);
|
|
15
|
+
* - surrounding double quotes on an entry are stripped;
|
|
16
|
+
* - PATHEXT order is honoured, restricted to the extensions a shell-less
|
|
17
|
+
* spawn can run directly (.EXE / .COM). A git.cmd / git.bat shim cannot be
|
|
18
|
+
* spawned without a shell (Node refuses it with EINVAL), so it is never
|
|
19
|
+
* returned; Git for Windows puts cmd\git.exe on PATH.
|
|
20
|
+
* The PATH-only search itself lives in windows-executable.ts (shared with the
|
|
21
|
+
* Windows shells the fleet server starts). The result is cached for the
|
|
22
|
+
* process. A missing git throws GitNotFoundError, one clear error naming PATH, instead of a confusing failure in whichever
|
|
23
|
+
* caller ran first. A failed lookup is not cached, so installing git later
|
|
24
|
+
* starts working without a restart.
|
|
25
|
+
*
|
|
26
|
+
* On every other platform the bare name 'git' is returned unchanged: execvp
|
|
27
|
+
* never searches the cwd unless PATH itself says so.
|
|
28
|
+
*
|
|
29
|
+
* Out of scope: packages/apra-fleet-client git spawns (separate package).
|
|
30
|
+
* Member-bound command STRINGS (src/os/*.ts builders, member-config-io, vcs
|
|
31
|
+
* providers) run on the member through its own shell and are not spawns by
|
|
32
|
+
* the fleet server's own process.
|
|
33
|
+
*/
|
|
34
|
+
import { type WindowsExecutableDeps } from './windows-executable.js';
|
|
35
|
+
export declare const GIT_NOT_FOUND_CODE = "E-GIT-NOT-FOUND";
|
|
36
|
+
export declare class GitNotFoundError extends Error {
|
|
37
|
+
readonly searched: readonly string[];
|
|
38
|
+
readonly code = "E-GIT-NOT-FOUND";
|
|
39
|
+
constructor(searched: readonly string[]);
|
|
40
|
+
}
|
|
41
|
+
/** git has no preferred location: only the PATH fields of the shared deps apply. */
|
|
42
|
+
export type GitResolveDeps = Pick<WindowsExecutableDeps, 'platform' | 'pathValue' | 'pathext' | 'isFile'>;
|
|
43
|
+
export declare function defaultGitResolveDeps(): GitResolveDeps;
|
|
44
|
+
/**
|
|
45
|
+
* Pure resolution (no cache). Returns 'git' on non-Windows platforms; on win32
|
|
46
|
+
* returns an absolute path from a PATH entry or throws GitNotFoundError.
|
|
47
|
+
*/
|
|
48
|
+
export declare function resolveGitExecutable(deps: GitResolveDeps): string;
|
|
49
|
+
/**
|
|
50
|
+
* The git executable for a fleet-server spawn: cached absolute PATH-only
|
|
51
|
+
* resolution on win32, bare 'git' elsewhere. Throws GitNotFoundError on win32
|
|
52
|
+
* when git is not on PATH.
|
|
53
|
+
*/
|
|
54
|
+
export declare function gitExecutable(): string;
|
|
55
|
+
/** Test hook: forget the cached resolution. */
|
|
56
|
+
export declare function resetGitExecutableCache(): void;
|
|
57
|
+
//# sourceMappingURL=git-executable.d.ts.map
|