@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,351 @@
|
|
|
1
|
+
// Who holds a local TCP port: used by `apra-fleet start`, the server's own
|
|
2
|
+
// startup and `apra-fleet install` when the configured port is already bound.
|
|
3
|
+
//
|
|
4
|
+
// Two Unix users on one host can each have a member install, but not on the
|
|
5
|
+
// same port: the server binds 127.0.0.1:<port> with no fallback. When the
|
|
6
|
+
// port is held by ANOTHER user's process, the operator must be told who holds
|
|
7
|
+
// it and how to fix it (give this install its own port), instead of a generic
|
|
8
|
+
// "port in use" -- or worse, sessions silently reaching the other user's
|
|
9
|
+
// server. A port held by this user's own apra-fleet for THIS data dir is the
|
|
10
|
+
// existing already-running reuse path (checkRunningInstance), decided before
|
|
11
|
+
// any of this runs.
|
|
12
|
+
//
|
|
13
|
+
// Everything here runs locally on the machine that owns the port (install,
|
|
14
|
+
// start and the server run ON the member), so the probes are built in
|
|
15
|
+
// JavaScript and run through Node -- never a member-bound shell string:
|
|
16
|
+
// - linux: /proc/net/tcp{,6} gives the listening socket's uid and inode for
|
|
17
|
+
// ANY user; the pid is found by matching the inode in /proc/<pid>/fd,
|
|
18
|
+
// which is only readable for this user's own processes (another user's pid
|
|
19
|
+
// is reported as not visible, never guessed);
|
|
20
|
+
// - macOS: lsof -iTCP:<port> -sTCP:LISTEN;
|
|
21
|
+
// - windows: Get-NetTCPConnection + the owning process's GetOwner(), run as
|
|
22
|
+
// an encoded PowerShell command (src/os/windows.ts wrapPowerShellEncoded).
|
|
23
|
+
// Every probe is best effort and never throws: an unknown holder falls back
|
|
24
|
+
// to the existing port-in-use message.
|
|
25
|
+
import fs from 'node:fs';
|
|
26
|
+
import os from 'node:os';
|
|
27
|
+
import { execFileSync, execSync } from 'node:child_process';
|
|
28
|
+
import { wrapPowerShellEncoded } from '../os/windows.js';
|
|
29
|
+
let probeOverride = null;
|
|
30
|
+
/** Test hook: replace the platform probe (null restores it). */
|
|
31
|
+
export function _setPortHolderProbeOverride(fn) {
|
|
32
|
+
probeOverride = fn;
|
|
33
|
+
}
|
|
34
|
+
const PROBE_TIMEOUT_MS = 8000;
|
|
35
|
+
/** The process holding a LISTEN socket on `port`, or null when unknown. Never throws. */
|
|
36
|
+
export async function findPortHolder(port) {
|
|
37
|
+
try {
|
|
38
|
+
if (probeOverride)
|
|
39
|
+
return await probeOverride(port);
|
|
40
|
+
if (process.platform === 'linux')
|
|
41
|
+
return linuxPortHolder(port);
|
|
42
|
+
if (process.platform === 'darwin')
|
|
43
|
+
return lsofPortHolder(port);
|
|
44
|
+
if (process.platform === 'win32')
|
|
45
|
+
return windowsPortHolder(port);
|
|
46
|
+
return null;
|
|
47
|
+
}
|
|
48
|
+
catch {
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
// ---------------------------------------------------------------------------
|
|
53
|
+
// linux
|
|
54
|
+
// ---------------------------------------------------------------------------
|
|
55
|
+
/** Parse /proc/net/tcp(6) text: the uid and inode of the LISTEN socket on `port`. */
|
|
56
|
+
export function parseProcNetTcp(text, port) {
|
|
57
|
+
const portHex = port.toString(16).toUpperCase().padStart(4, '0');
|
|
58
|
+
for (const line of text.split('\n').slice(1)) {
|
|
59
|
+
const f = line.trim().split(/\s+/);
|
|
60
|
+
if (f.length < 10)
|
|
61
|
+
continue;
|
|
62
|
+
const local = f[1];
|
|
63
|
+
const state = f[3];
|
|
64
|
+
if (state !== '0A')
|
|
65
|
+
continue; // TCP_LISTEN
|
|
66
|
+
if (local.slice(local.lastIndexOf(':') + 1).toUpperCase() !== portHex)
|
|
67
|
+
continue;
|
|
68
|
+
const uid = Number(f[7]);
|
|
69
|
+
if (!Number.isInteger(uid))
|
|
70
|
+
continue;
|
|
71
|
+
return { uid, inode: f[9] };
|
|
72
|
+
}
|
|
73
|
+
return null;
|
|
74
|
+
}
|
|
75
|
+
/** Login name for a uid from /etc/passwd text, or undefined. */
|
|
76
|
+
export function userFromPasswd(text, uid) {
|
|
77
|
+
for (const line of text.split('\n')) {
|
|
78
|
+
const f = line.split(':');
|
|
79
|
+
if (f.length >= 3 && Number(f[2]) === uid && f[0])
|
|
80
|
+
return f[0];
|
|
81
|
+
}
|
|
82
|
+
return undefined;
|
|
83
|
+
}
|
|
84
|
+
function linuxUserName(uid) {
|
|
85
|
+
try {
|
|
86
|
+
const u = userFromPasswd(fs.readFileSync('/etc/passwd', 'utf8'), uid);
|
|
87
|
+
if (u)
|
|
88
|
+
return u;
|
|
89
|
+
}
|
|
90
|
+
catch { /* fall through to getent (LDAP/NSS users) */ }
|
|
91
|
+
try {
|
|
92
|
+
const out = execFileSync('getent', ['passwd', String(uid)], { encoding: 'utf8', timeout: PROBE_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true });
|
|
93
|
+
return userFromPasswd(String(out), uid);
|
|
94
|
+
}
|
|
95
|
+
catch {
|
|
96
|
+
return undefined;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
function linuxPidForInode(inode) {
|
|
100
|
+
const target = `socket:[${inode}]`;
|
|
101
|
+
let pids;
|
|
102
|
+
try {
|
|
103
|
+
pids = fs.readdirSync('/proc').filter(d => /^\d+$/.test(d));
|
|
104
|
+
}
|
|
105
|
+
catch {
|
|
106
|
+
return undefined;
|
|
107
|
+
}
|
|
108
|
+
for (const pid of pids) {
|
|
109
|
+
let fds;
|
|
110
|
+
try {
|
|
111
|
+
fds = fs.readdirSync(`/proc/${pid}/fd`);
|
|
112
|
+
}
|
|
113
|
+
catch {
|
|
114
|
+
continue;
|
|
115
|
+
} // another user's process
|
|
116
|
+
for (const fd of fds) {
|
|
117
|
+
try {
|
|
118
|
+
if (fs.readlinkSync(`/proc/${pid}/fd/${fd}`) === target)
|
|
119
|
+
return Number(pid);
|
|
120
|
+
}
|
|
121
|
+
catch { /* closed meanwhile */ }
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
return undefined;
|
|
125
|
+
}
|
|
126
|
+
function linuxCommand(pid) {
|
|
127
|
+
try {
|
|
128
|
+
return fs.readFileSync(`/proc/${pid}/comm`, 'utf8').trim() || undefined;
|
|
129
|
+
}
|
|
130
|
+
catch {
|
|
131
|
+
return undefined;
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
function linuxPortHolder(port) {
|
|
135
|
+
let hit = null;
|
|
136
|
+
for (const f of ['/proc/net/tcp', '/proc/net/tcp6']) {
|
|
137
|
+
try {
|
|
138
|
+
hit = parseProcNetTcp(fs.readFileSync(f, 'utf8'), port);
|
|
139
|
+
}
|
|
140
|
+
catch {
|
|
141
|
+
hit = null;
|
|
142
|
+
}
|
|
143
|
+
if (hit)
|
|
144
|
+
break;
|
|
145
|
+
}
|
|
146
|
+
if (!hit)
|
|
147
|
+
return null;
|
|
148
|
+
const pid = linuxPidForInode(hit.inode);
|
|
149
|
+
const user = linuxUserName(hit.uid);
|
|
150
|
+
const command = pid !== undefined ? linuxCommand(pid) : undefined;
|
|
151
|
+
return { uid: hit.uid, ...(user ? { user } : {}), ...(pid !== undefined ? { pid } : {}), ...(command ? { command } : {}) };
|
|
152
|
+
}
|
|
153
|
+
// ---------------------------------------------------------------------------
|
|
154
|
+
// macOS
|
|
155
|
+
// ---------------------------------------------------------------------------
|
|
156
|
+
/** Parse `lsof -F pcLu` output: the first process record. */
|
|
157
|
+
export function parseLsofFields(out) {
|
|
158
|
+
const h = {};
|
|
159
|
+
for (const line of out.split('\n')) {
|
|
160
|
+
const tag = line[0];
|
|
161
|
+
const v = line.slice(1).trim();
|
|
162
|
+
if (!v)
|
|
163
|
+
continue;
|
|
164
|
+
if (tag === 'p') {
|
|
165
|
+
if (h.pid !== undefined)
|
|
166
|
+
break;
|
|
167
|
+
h.pid = Number(v);
|
|
168
|
+
}
|
|
169
|
+
else if (tag === 'c' && !h.command)
|
|
170
|
+
h.command = v;
|
|
171
|
+
else if (tag === 'L' && !h.user)
|
|
172
|
+
h.user = v;
|
|
173
|
+
else if (tag === 'u' && h.uid === undefined)
|
|
174
|
+
h.uid = Number(v);
|
|
175
|
+
}
|
|
176
|
+
return h.pid !== undefined || h.user ? h : null;
|
|
177
|
+
}
|
|
178
|
+
/** macOS probe (exported with an exec seam for tests). */
|
|
179
|
+
export function lsofPortHolder(port, exec = execFileSync) {
|
|
180
|
+
try {
|
|
181
|
+
const out = exec('lsof', ['-nP', `-iTCP:${port}`, '-sTCP:LISTEN', '-FpcLu'], {
|
|
182
|
+
encoding: 'utf8', timeout: PROBE_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
183
|
+
});
|
|
184
|
+
return parseLsofFields(String(out));
|
|
185
|
+
}
|
|
186
|
+
catch (err) {
|
|
187
|
+
// lsof ran but listed nothing (exit 1, no output): a non-root lsof lists
|
|
188
|
+
// every socket of THIS user, so a bound port it cannot see is held by
|
|
189
|
+
// another OS user (or root). Only called once the port is known bound.
|
|
190
|
+
const e = err;
|
|
191
|
+
if (e.code !== 'ENOENT' && e.status === 1 && !String(e.stdout ?? '').trim())
|
|
192
|
+
return { otherUser: true };
|
|
193
|
+
return null;
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
// ---------------------------------------------------------------------------
|
|
197
|
+
// windows
|
|
198
|
+
// ---------------------------------------------------------------------------
|
|
199
|
+
/** The PowerShell probe (wrapped with wrapPowerShellEncoded before it runs). */
|
|
200
|
+
export function windowsPortHolderScript(port) {
|
|
201
|
+
const p = Math.trunc(port);
|
|
202
|
+
return `$c = Get-NetTCPConnection -State Listen -LocalPort ${p} -ErrorAction SilentlyContinue | Select-Object -First 1; `
|
|
203
|
+
+ `if ($c) { $procId = [int]$c.OwningProcess; $proc = Get-CimInstance Win32_Process -Filter ('ProcessId=' + $procId) -ErrorAction SilentlyContinue; `
|
|
204
|
+
+ `$owner = $null; if ($proc) { try { $owner = Invoke-CimMethod -InputObject $proc -MethodName GetOwner -ErrorAction Stop } catch { $owner = $null } }; `
|
|
205
|
+
+ `[Console]::Out.Write((@{ pid = $procId; name = $(if ($proc) { $proc.Name } else { $null }); user = $(if ($owner) { $owner.User } else { $null }) } | ConvertTo-Json -Compress)) }`;
|
|
206
|
+
}
|
|
207
|
+
/** Parse the PowerShell probe's JSON line. */
|
|
208
|
+
export function parseWindowsPortHolder(out) {
|
|
209
|
+
const line = out.trim().split(/\r?\n/).filter(Boolean).pop();
|
|
210
|
+
if (!line)
|
|
211
|
+
return null;
|
|
212
|
+
try {
|
|
213
|
+
const j = JSON.parse(line);
|
|
214
|
+
const pid = typeof j.pid === 'number' && j.pid > 0 ? j.pid : undefined;
|
|
215
|
+
const user = typeof j.user === 'string' && j.user ? j.user : undefined;
|
|
216
|
+
const command = typeof j.name === 'string' && j.name ? j.name : undefined;
|
|
217
|
+
if (pid === undefined && !user)
|
|
218
|
+
return null;
|
|
219
|
+
return { ...(pid !== undefined ? { pid } : {}), ...(user ? { user } : {}), ...(command ? { command } : {}) };
|
|
220
|
+
}
|
|
221
|
+
catch {
|
|
222
|
+
return null;
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
/** Windows probe (exported with seams for tests). */
|
|
226
|
+
export function windowsPortHolder(port, runProbe = (cmd) => String(execSync(cmd, {
|
|
227
|
+
encoding: 'utf8', timeout: PROBE_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
228
|
+
}) ?? ''), kill) {
|
|
229
|
+
try {
|
|
230
|
+
const holder = parseWindowsPortHolder(runProbe(wrapPowerShellEncoded(windowsPortHolderScript(port))));
|
|
231
|
+
if (holder) {
|
|
232
|
+
// GetOwner on another user's process returns access denied without
|
|
233
|
+
// throwing, leaving no user: classify the pid by signal 0 instead.
|
|
234
|
+
if (!holder.user && holder.pid !== undefined) {
|
|
235
|
+
const otherUser = pidOwnedByOtherUser(holder.pid, kill);
|
|
236
|
+
if (otherUser !== undefined)
|
|
237
|
+
holder.otherUser = otherUser;
|
|
238
|
+
}
|
|
239
|
+
return holder;
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
catch { /* CIM denied (standard user on a network/SSH logon): fall back below */ }
|
|
243
|
+
return netstatPortHolder(port, undefined, kill);
|
|
244
|
+
}
|
|
245
|
+
/**
|
|
246
|
+
* Pid of the LISTEN socket on `port` from `netstat -ano -p TCP` (no CIM/WMI,
|
|
247
|
+
* so it works for a standard user over SSH). The state column is localized,
|
|
248
|
+
* so a listener is recognised by its unbound foreign address instead.
|
|
249
|
+
*/
|
|
250
|
+
export function parseNetstatListenPid(out, port) {
|
|
251
|
+
for (const line of out.split(/\r?\n/)) {
|
|
252
|
+
const f = line.trim().split(/\s+/);
|
|
253
|
+
if (f.length < 5 || f[0].toUpperCase() !== 'TCP')
|
|
254
|
+
continue;
|
|
255
|
+
if (!f[1].endsWith(`:${port}`))
|
|
256
|
+
continue;
|
|
257
|
+
if (!/^(0\.0\.0\.0|\[::\]):0$/.test(f[2]))
|
|
258
|
+
continue;
|
|
259
|
+
const pid = Number(f[f.length - 1]);
|
|
260
|
+
if (Number.isInteger(pid) && pid > 0)
|
|
261
|
+
return pid;
|
|
262
|
+
}
|
|
263
|
+
return undefined;
|
|
264
|
+
}
|
|
265
|
+
/** Whether `pid` belongs to another user: signal 0 is refused (EPERM) for one. */
|
|
266
|
+
export function pidOwnedByOtherUser(pid, kill = (p, s) => process.kill(p, s)) {
|
|
267
|
+
try {
|
|
268
|
+
kill(pid, 0);
|
|
269
|
+
return false;
|
|
270
|
+
}
|
|
271
|
+
catch (err) {
|
|
272
|
+
return err.code === 'EPERM' ? true : undefined;
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
/** Windows CIM-free fallback probe (exported with seams for tests). */
|
|
276
|
+
export function netstatPortHolder(port, exec = execFileSync, kill) {
|
|
277
|
+
try {
|
|
278
|
+
const out = exec('netstat', ['-ano', '-p', 'TCP'], {
|
|
279
|
+
encoding: 'utf8', timeout: PROBE_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true,
|
|
280
|
+
});
|
|
281
|
+
const pid = parseNetstatListenPid(String(out), port);
|
|
282
|
+
if (pid === undefined)
|
|
283
|
+
return null;
|
|
284
|
+
const otherUser = pidOwnedByOtherUser(pid, kill);
|
|
285
|
+
return { pid, ...(otherUser !== undefined ? { otherUser } : {}) };
|
|
286
|
+
}
|
|
287
|
+
catch {
|
|
288
|
+
return null;
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
// ---------------------------------------------------------------------------
|
|
292
|
+
// classification and messages
|
|
293
|
+
// ---------------------------------------------------------------------------
|
|
294
|
+
/** This process's user (name and, on POSIX, uid). */
|
|
295
|
+
export function currentUser() {
|
|
296
|
+
let user;
|
|
297
|
+
try {
|
|
298
|
+
user = os.userInfo().username;
|
|
299
|
+
}
|
|
300
|
+
catch { /* unknown */ }
|
|
301
|
+
const uid = typeof process.getuid === 'function' ? process.getuid() : undefined;
|
|
302
|
+
return { ...(user ? { user } : {}), ...(uid !== undefined ? { uid } : {}) };
|
|
303
|
+
}
|
|
304
|
+
/**
|
|
305
|
+
* True when the holder belongs to a different user than `me`, false when it
|
|
306
|
+
* is the same user, undefined when that cannot be told. uid wins over the
|
|
307
|
+
* name when both sides have one; names compare case-insensitively (Windows).
|
|
308
|
+
*/
|
|
309
|
+
export function heldByOtherUser(holder, me = currentUser()) {
|
|
310
|
+
if (holder.uid !== undefined && me.uid !== undefined)
|
|
311
|
+
return holder.uid !== me.uid;
|
|
312
|
+
if (holder.user && me.user)
|
|
313
|
+
return holder.user.toLowerCase() !== me.user.toLowerCase();
|
|
314
|
+
return holder.otherUser;
|
|
315
|
+
}
|
|
316
|
+
/** Machine-readable code on the refusal when another user holds the port. */
|
|
317
|
+
export const PORT_HELD_BY_OTHER_USER_CODE = 'E-PORT-HELD-BY-OTHER-USER';
|
|
318
|
+
function holderPhrase(holder) {
|
|
319
|
+
const who = holder.user ?? (holder.uid !== undefined ? `uid ${holder.uid}` : 'an unknown user');
|
|
320
|
+
const pid = holder.pid !== undefined ? `pid ${holder.pid}` : 'pid not visible to this user';
|
|
321
|
+
const whose = !holder.user && holder.uid === undefined && holder.otherUser ? 'another OS user' : `user "${who}"`;
|
|
322
|
+
return `${whose} (${pid}${holder.command ? `, ${holder.command}` : ''})`;
|
|
323
|
+
}
|
|
324
|
+
/** The refusal when ANOTHER user's process holds the port: who, pid, remedy.
|
|
325
|
+
* A member install can move to its own recorded port; a full install's
|
|
326
|
+
* service is not given a custom port, so its remedy is freeing the port. */
|
|
327
|
+
export function portHeldByOtherUserMessage(port, holder, installKind, me = currentUser()) {
|
|
328
|
+
const self = me.user ? ` (this is "${me.user}")` : '';
|
|
329
|
+
const remedy = installKind === 'member'
|
|
330
|
+
? 'Remedy: give this member install its own port -- re-run "apra-fleet install --member --port <free port>"; '
|
|
331
|
+
+ 'the fleet picks up the new port on its next fleet_install "auto" probe.'
|
|
332
|
+
: `Remedy: that user stops their apra-fleet server ("apra-fleet stop", or "apra-fleet uninstall" to remove it), then re-run the install. `
|
|
333
|
+
+ 'A full install\'s service listens on the default port: it is not given APRA_FLEET_PORT, so changing the port is not a lasting fix.';
|
|
334
|
+
return `${PORT_HELD_BY_OTHER_USER_CODE}: port ${port} on 127.0.0.1 is held by ${holderPhrase(holder)}, another user's process${self}. `
|
|
335
|
+
+ 'apra-fleet will not share or take over another user\'s server. '
|
|
336
|
+
+ remedy;
|
|
337
|
+
}
|
|
338
|
+
/**
|
|
339
|
+
* The full operator message for a configured port that is taken, given the
|
|
340
|
+
* generic port-in-use text. Another user's holder -> the refusal above (with
|
|
341
|
+
* `foreign: true`); otherwise the generic text plus the holder when known.
|
|
342
|
+
*/
|
|
343
|
+
export function describePortConflict(port, genericMessage, holder, installKind, me = currentUser()) {
|
|
344
|
+
if (holder && heldByOtherUser(holder, me) === true) {
|
|
345
|
+
return { foreign: true, message: portHeldByOtherUserMessage(port, holder, installKind, me) };
|
|
346
|
+
}
|
|
347
|
+
if (holder)
|
|
348
|
+
return { foreign: false, message: `${genericMessage} Holder: ${holderPhrase(holder)}.` };
|
|
349
|
+
return { foreign: false, message: genericMessage };
|
|
350
|
+
}
|
|
351
|
+
//# sourceMappingURL=port-holder.js.map
|
|
@@ -133,6 +133,8 @@ export async function preflightCheck(agent, options) {
|
|
|
133
133
|
authEnvVarSet.add(provider.authEnvVarForToken('sk-ant-probe'));
|
|
134
134
|
authEnvVarSet.add(provider.authEnvVarForToken('non-sk-ant-probe'));
|
|
135
135
|
}
|
|
136
|
+
for (const name of provider.authEnvVarNames?.() ?? [])
|
|
137
|
+
authEnvVarSet.add(name);
|
|
136
138
|
// R3 regression fix: providers with no env-var-based auth (e.g. OpenCode,
|
|
137
139
|
// whose authEnvVar/authEnvVarForToken always return '') would otherwise
|
|
138
140
|
// populate authEnvVars with ''. getOsCommands(...).apiKeyCheck('') builds a
|
|
@@ -1,9 +1,14 @@
|
|
|
1
|
-
import type { Agent } from '../types.js';
|
|
1
|
+
import type { Agent, FleetMcpStatus } from '../types.js';
|
|
2
2
|
export declare function getAllAgents(): Agent[];
|
|
3
3
|
export declare function getAgent(id: string): Agent | undefined;
|
|
4
4
|
export declare function findAgentByName(name: string): Agent | undefined;
|
|
5
5
|
export declare function addAgent(agent: Agent): void;
|
|
6
6
|
export declare function updateAgent(id: string, updates: Partial<Agent>): Agent | undefined;
|
|
7
|
+
/** Record the latest fleetMcp observation for a member (overwrites; never sticky),
|
|
8
|
+
* except that the CURRENT fleetInstalledAt stamp is carried forward unless the
|
|
9
|
+
* new status sets its own -- it is the only signal this fleet installed the
|
|
10
|
+
* member, and observation-only writers (compose errors) must not drop it. */
|
|
11
|
+
export declare function recordFleetMcpStatus(id: string, status: FleetMcpStatus): Agent | undefined;
|
|
7
12
|
export declare function removeAgent(id: string): boolean;
|
|
8
13
|
export declare function getKeysDir(): string;
|
|
9
14
|
/**
|
|
@@ -13,7 +18,13 @@ export declare function getKeysDir(): string;
|
|
|
13
18
|
* - Relay agents: no check -- the folder is a path on the RELAYED machine,
|
|
14
19
|
* not this machine's own filesystem, so there's no local duplicate-folder
|
|
15
20
|
* concept to enforce here (apra-fleet-jfn).
|
|
21
|
+
* - When `llmProvider` is given, a folder may hold at most one LLM member and
|
|
22
|
+
* at most one LLM-less (llm_provider 'none') member: only members of the
|
|
23
|
+
* SAME kind clash. The rule exists so two agents never edit one checkout;
|
|
24
|
+
* an LLM-less command executor (e.g. a supervisor's backlog member running
|
|
25
|
+
* bd) is not an agent. Omitting `llmProvider` keeps the strict any-member
|
|
26
|
+
* check.
|
|
16
27
|
* Returns true if a duplicate exists.
|
|
17
28
|
*/
|
|
18
|
-
export declare function hasDuplicateFolder(agentType: 'local' | 'remote' | 'relay', folder: string, host?: string, port?: number, excludeId?: string): boolean;
|
|
29
|
+
export declare function hasDuplicateFolder(agentType: 'local' | 'remote' | 'relay', folder: string, host?: string, port?: number, excludeId?: string, llmProvider?: string): boolean;
|
|
19
30
|
//# sourceMappingURL=registry.d.ts.map
|
|
@@ -102,6 +102,23 @@ export function updateAgent(id, updates) {
|
|
|
102
102
|
saveRegistry(registry);
|
|
103
103
|
return registry.agents[idx];
|
|
104
104
|
}
|
|
105
|
+
/** Record the latest fleetMcp observation for a member (overwrites; never sticky),
|
|
106
|
+
* except that the CURRENT fleetInstalledAt stamp is carried forward unless the
|
|
107
|
+
* new status sets its own -- it is the only signal this fleet installed the
|
|
108
|
+
* member, and observation-only writers (compose errors) must not drop it. */
|
|
109
|
+
export function recordFleetMcpStatus(id, status) {
|
|
110
|
+
const stamp = status.fleetInstalledAt ?? getAgent(id)?.fleetMcp?.fleetInstalledAt;
|
|
111
|
+
const fleetMcp = stamp ? { ...status, fleetInstalledAt: stamp } : status;
|
|
112
|
+
// The member's MCP port is persisted only from a probe that resolved it: a
|
|
113
|
+
// probe that failed before reading the member's install keeps the recorded
|
|
114
|
+
// port (falling back to the default there would point sessions at whatever
|
|
115
|
+
// else listens on it).
|
|
116
|
+
if (status.portSource === 'marker' && status.port !== undefined)
|
|
117
|
+
return updateAgent(id, { fleetMcp, memberMcpPort: status.port });
|
|
118
|
+
if (status.portSource === 'default')
|
|
119
|
+
return updateAgent(id, { fleetMcp, memberMcpPort: undefined });
|
|
120
|
+
return updateAgent(id, { fleetMcp });
|
|
121
|
+
}
|
|
105
122
|
export function removeAgent(id) {
|
|
106
123
|
const registry = loadRegistry();
|
|
107
124
|
const before = registry.agents.length;
|
|
@@ -136,17 +153,26 @@ function normalizeFolderPath(folder) {
|
|
|
136
153
|
* - Relay agents: no check -- the folder is a path on the RELAYED machine,
|
|
137
154
|
* not this machine's own filesystem, so there's no local duplicate-folder
|
|
138
155
|
* concept to enforce here (apra-fleet-jfn).
|
|
156
|
+
* - When `llmProvider` is given, a folder may hold at most one LLM member and
|
|
157
|
+
* at most one LLM-less (llm_provider 'none') member: only members of the
|
|
158
|
+
* SAME kind clash. The rule exists so two agents never edit one checkout;
|
|
159
|
+
* an LLM-less command executor (e.g. a supervisor's backlog member running
|
|
160
|
+
* bd) is not an agent. Omitting `llmProvider` keeps the strict any-member
|
|
161
|
+
* check.
|
|
139
162
|
* Returns true if a duplicate exists.
|
|
140
163
|
*/
|
|
141
|
-
export function hasDuplicateFolder(agentType, folder, host, port, excludeId) {
|
|
164
|
+
export function hasDuplicateFolder(agentType, folder, host, port, excludeId, llmProvider) {
|
|
142
165
|
const agents = getAllAgents();
|
|
143
166
|
const normalizedFolder = normalizeFolderPath(folder);
|
|
167
|
+
const isLlmLess = (p) => (p ?? 'claude') === 'none';
|
|
144
168
|
for (const agent of agents) {
|
|
145
169
|
if (excludeId && agent.id === excludeId)
|
|
146
170
|
continue;
|
|
147
171
|
const agentFolder = normalizeFolderPath(agent.workFolder);
|
|
148
172
|
if (agentFolder !== normalizedFolder)
|
|
149
173
|
continue;
|
|
174
|
+
if (llmProvider !== undefined && isLlmLess(llmProvider) !== isLlmLess(agent.llmProvider))
|
|
175
|
+
continue;
|
|
150
176
|
if (agentType === 'local' && agent.agentType === 'local') {
|
|
151
177
|
return true;
|
|
152
178
|
}
|
|
@@ -9,6 +9,8 @@ export declare class RelayStrategy implements AgentStrategy {
|
|
|
9
9
|
transferFiles(localPaths: string[], destinationPath?: string, abortSignal?: AbortSignal): Promise<TransferResult>;
|
|
10
10
|
receiveFiles(): Promise<TransferResult>;
|
|
11
11
|
deleteFiles(): Promise<void>;
|
|
12
|
+
writeSecretFile(): Promise<string>;
|
|
13
|
+
removeSecretFile(): Promise<void>;
|
|
12
14
|
testConnection(): Promise<{
|
|
13
15
|
ok: boolean;
|
|
14
16
|
latencyMs: number;
|
|
@@ -93,6 +93,14 @@ export class RelayStrategy {
|
|
|
93
93
|
async deleteFiles() {
|
|
94
94
|
throw new Error('File deletion over relay is not yet supported (apra-fleet-jfn follow-on).');
|
|
95
95
|
}
|
|
96
|
+
// No relay channel delivers a file to a known absolute path without a
|
|
97
|
+
// command line, so a stored credential cannot reach a relay member safely.
|
|
98
|
+
// Fail loudly rather than fall back to an inline (argv-visible) value;
|
|
99
|
+
// member-secret-env.ts wraps this in a SecretDeliveryError with the remedy.
|
|
100
|
+
async writeSecretFile() {
|
|
101
|
+
throw new Error('the relay transport has no file channel to a known path');
|
|
102
|
+
}
|
|
103
|
+
async removeSecretFile() { }
|
|
96
104
|
async testConnection() {
|
|
97
105
|
const start = Date.now();
|
|
98
106
|
try {
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared token grammar for the `{{secret.NAME}}` credential-store placeholder
|
|
3
|
+
* (apra-fleet secret terminology standardization). `{{secure.NAME}}` is the
|
|
4
|
+
* legacy spelling -- it still resolves identically, but every call site that
|
|
5
|
+
* finds one must emit legacyTokenWarning() so operators migrate off it.
|
|
6
|
+
* There is no hard-fail; both spellings are accepted indefinitely.
|
|
7
|
+
*
|
|
8
|
+
* Every credential-token regex/redaction/warning in the codebase should go
|
|
9
|
+
* through this module instead of maintaining its own local pattern.
|
|
10
|
+
*/
|
|
11
|
+
/** Matches both {{secret.NAME}} (canonical) and {{secure.NAME}} (legacy). Global + stateful -- clone with `new RegExp(SECRET_TOKEN_RE.source, 'g')` or reset `.lastIndex` before reuse. */
|
|
12
|
+
export declare const SECRET_TOKEN_RE: RegExp;
|
|
13
|
+
export interface SecretTokenMatch {
|
|
14
|
+
/** The credential name inside the token. */
|
|
15
|
+
name: string;
|
|
16
|
+
/** The full matched token text, e.g. "{{secret.FOO}}" or "{{secure.FOO}}". */
|
|
17
|
+
raw: string;
|
|
18
|
+
/** True when this occurrence used the deprecated {{secure.NAME}} spelling. */
|
|
19
|
+
legacy: boolean;
|
|
20
|
+
}
|
|
21
|
+
/** Finds every {{secret.NAME}} / {{secure.NAME}} token in `text`, in order of appearance. */
|
|
22
|
+
export declare function findSecretTokens(text: string): SecretTokenMatch[];
|
|
23
|
+
/** True if `text` contains at least one {{secret.NAME}} or {{secure.NAME}} token. */
|
|
24
|
+
export declare function hasSecretToken(text: string): boolean;
|
|
25
|
+
/** Replaces every {{secret.NAME}} / {{secure.NAME}} token in `text` with `[REDACTED]`. */
|
|
26
|
+
export declare function redactSecretTokens(text: string): string;
|
|
27
|
+
/** Canonical placeholder text for a given credential name, e.g. formatSecretToken('FOO') -> "{{secret.FOO}}". */
|
|
28
|
+
export declare function formatSecretToken(name: string): string;
|
|
29
|
+
/**
|
|
30
|
+
* One-line deprecation notice for the given legacy {{secure.NAME}} token
|
|
31
|
+
* names (deduplicated). Callers append this to a tool's text result and log
|
|
32
|
+
* it whenever resolveSecretTokens-style resolution sees at least one legacy
|
|
33
|
+
* spelling, so operators see the nudge without a hard failure.
|
|
34
|
+
* Deliberately unbraced: the log masker redacts any braced token, and a
|
|
35
|
+
* braced form here would render as "[REDACTED] is deprecated" in fleet logs.
|
|
36
|
+
*/
|
|
37
|
+
export declare function legacyTokenWarning(names: string[]): string;
|
|
38
|
+
//# sourceMappingURL=secret-token.d.ts.map
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared token grammar for the `{{secret.NAME}}` credential-store placeholder
|
|
3
|
+
* (apra-fleet secret terminology standardization). `{{secure.NAME}}` is the
|
|
4
|
+
* legacy spelling -- it still resolves identically, but every call site that
|
|
5
|
+
* finds one must emit legacyTokenWarning() so operators migrate off it.
|
|
6
|
+
* There is no hard-fail; both spellings are accepted indefinitely.
|
|
7
|
+
*
|
|
8
|
+
* Every credential-token regex/redaction/warning in the codebase should go
|
|
9
|
+
* through this module instead of maintaining its own local pattern.
|
|
10
|
+
*/
|
|
11
|
+
/** Matches both {{secret.NAME}} (canonical) and {{secure.NAME}} (legacy). Global + stateful -- clone with `new RegExp(SECRET_TOKEN_RE.source, 'g')` or reset `.lastIndex` before reuse. */
|
|
12
|
+
export const SECRET_TOKEN_RE = /\{\{(secret|secure)\.([a-zA-Z0-9_-]{1,64})\}\}/g;
|
|
13
|
+
/** Finds every {{secret.NAME}} / {{secure.NAME}} token in `text`, in order of appearance. */
|
|
14
|
+
export function findSecretTokens(text) {
|
|
15
|
+
const re = new RegExp(SECRET_TOKEN_RE.source, 'g');
|
|
16
|
+
const results = [];
|
|
17
|
+
let m;
|
|
18
|
+
while ((m = re.exec(text)) !== null) {
|
|
19
|
+
results.push({ name: m[2], raw: m[0], legacy: m[1] === 'secure' });
|
|
20
|
+
}
|
|
21
|
+
return results;
|
|
22
|
+
}
|
|
23
|
+
/** True if `text` contains at least one {{secret.NAME}} or {{secure.NAME}} token. */
|
|
24
|
+
export function hasSecretToken(text) {
|
|
25
|
+
const re = new RegExp(SECRET_TOKEN_RE.source);
|
|
26
|
+
return re.test(text);
|
|
27
|
+
}
|
|
28
|
+
/** Replaces every {{secret.NAME}} / {{secure.NAME}} token in `text` with `[REDACTED]`. */
|
|
29
|
+
export function redactSecretTokens(text) {
|
|
30
|
+
const re = new RegExp(SECRET_TOKEN_RE.source, 'g');
|
|
31
|
+
return text.replace(re, '[REDACTED]');
|
|
32
|
+
}
|
|
33
|
+
/** Canonical placeholder text for a given credential name, e.g. formatSecretToken('FOO') -> "{{secret.FOO}}". */
|
|
34
|
+
export function formatSecretToken(name) {
|
|
35
|
+
return `{{secret.${name}}}`;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* One-line deprecation notice for the given legacy {{secure.NAME}} token
|
|
39
|
+
* names (deduplicated). Callers append this to a tool's text result and log
|
|
40
|
+
* it whenever resolveSecretTokens-style resolution sees at least one legacy
|
|
41
|
+
* spelling, so operators see the nudge without a hard failure.
|
|
42
|
+
* Deliberately unbraced: the log masker redacts any braced token, and a
|
|
43
|
+
* braced form here would render as "[REDACTED] is deprecated" in fleet logs.
|
|
44
|
+
*/
|
|
45
|
+
export function legacyTokenWarning(names) {
|
|
46
|
+
const unique = [...new Set(names)];
|
|
47
|
+
return unique
|
|
48
|
+
.map((n) => `[deprecated] secure.${n} is the legacy spelling -- write secret.${n} instead (still accepted for now)`)
|
|
49
|
+
.join('; ');
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=secret-token.js.map
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export type ShutdownReason = 'SIGINT' | 'SIGTERM' | 'SIGHUP' | 'SIGBREAK' | 'http_shutdown' | 'shutdown_server' | 'uncaughtException' | 'unhandledRejection';
|
|
2
|
+
/**
|
|
3
|
+
* Append the shutdown record once per process (the first reason wins: e.g.
|
|
4
|
+
* POST /shutdown re-enters the SIGINT path, which must not add a second line).
|
|
5
|
+
* Synchronous -- the line is on disk when this returns.
|
|
6
|
+
*/
|
|
7
|
+
export declare function recordShutdown(reason: ShutdownReason, detail?: Record<string, unknown>): void;
|
|
8
|
+
/** Test hook: forget that a record was written. */
|
|
9
|
+
export declare function _resetShutdownRecordForTests(): void;
|
|
10
|
+
/** Signals that end a server, per platform. SIGBREAK exists only on Windows. */
|
|
11
|
+
export declare function shutdownSignals(platform?: NodeJS.Platform): NodeJS.Signals[];
|
|
12
|
+
type ProcLike = Pick<NodeJS.Process, 'on' | 'off'>;
|
|
13
|
+
/**
|
|
14
|
+
* Wire every exit path to recordShutdown. `onSignal` runs the server's own
|
|
15
|
+
* graceful shutdown (which ends in process.exit). Returns an uninstaller.
|
|
16
|
+
*/
|
|
17
|
+
export interface ShutdownHandlerOptions {
|
|
18
|
+
/** Hard deadline for the graceful shutdown after the first signal (unref'd). */
|
|
19
|
+
forceExitMs?: number;
|
|
20
|
+
/** Injectable for tests. */
|
|
21
|
+
exit?: (code: number) => void;
|
|
22
|
+
}
|
|
23
|
+
export declare const SHUTDOWN_FORCE_EXIT_MS = 10000;
|
|
24
|
+
export declare function installShutdownHandlers(onSignal: (reason: ShutdownReason) => void, proc?: ProcLike, platform?: NodeJS.Platform, options?: ShutdownHandlerOptions): () => void;
|
|
25
|
+
export {};
|
|
26
|
+
//# sourceMappingURL=server-lifecycle.d.ts.map
|