@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
|
@@ -0,0 +1,193 @@
|
|
|
1
|
+
import type { Agent, SSHExecResult } from '../types.js';
|
|
2
|
+
import type { MemberShell } from '../os/os-commands.js';
|
|
3
|
+
import type { MemberMcpSyncContext } from '../providers/provider.js';
|
|
4
|
+
export type MemberExecFn = (command: string, timeoutMs?: number) => Promise<SSHExecResult>;
|
|
5
|
+
/** Name of the per-folder member MCP entry every provider writes. */
|
|
6
|
+
export declare const MEMBER_MCP_SERVER_NAME = "apra-fleet";
|
|
7
|
+
/** Name of the retired url+bearer member entry; pruned wherever compose finds it. */
|
|
8
|
+
export declare const LEGACY_MEMBER_MCP_SERVER_NAME = "apra-fleet-member";
|
|
9
|
+
/**
|
|
10
|
+
* The URL a member session uses to reach the fleet MCP server on its OWN
|
|
11
|
+
* machine. `?member=<uuid>` identifies the session as that member, which is
|
|
12
|
+
* what reduces the served tool list to the member allowlist. A local member
|
|
13
|
+
* shares this process's server, so it follows the port that server binds
|
|
14
|
+
* (resolveServerPort: an APRA_FLEET_PORT sandbox, else the recorded install
|
|
15
|
+
* port); a remote member talks to its OWN install, on
|
|
16
|
+
* the port that install records in its member-install marker
|
|
17
|
+
* (agent.memberMcpPort, resolved on the member by the fleetMcp probe), or the
|
|
18
|
+
* built-in default when it recorded none (the probe reports that in fleetMcp
|
|
19
|
+
* detail). Two member installs on one host (one per Unix user) therefore each
|
|
20
|
+
* get their own server, never the other user's.
|
|
21
|
+
*/
|
|
22
|
+
export declare function memberMcpUrl(agent: Pick<Agent, 'id' | 'agentType' | 'memberMcpPort'>): string;
|
|
23
|
+
/** Claude permission deny rules: every registered fleet tool outside the member
|
|
24
|
+
* allowlist, on the member's apra-fleet server. Derived, never hand-listed. */
|
|
25
|
+
export declare function claudeMemberDenyRules(): string[];
|
|
26
|
+
/** Allow rules, in Claude's mcp__<server>__<tool> form, for every fleet tool in
|
|
27
|
+
* the member allowlist (kb_*, code_* and the self-reporting tools) -- never a
|
|
28
|
+
* maintainer-only or never-served tool. compose_permissions adds them to every
|
|
29
|
+
* composed profile so an acceptEdits session (a model without auto support)
|
|
30
|
+
* is not refused a member tool for lack of an allow rule. Derived, never
|
|
31
|
+
* hand-listed; agy maps the same tokens to mcp(<server>/<tool>). */
|
|
32
|
+
export declare function memberMcpAllowRules(): string[];
|
|
33
|
+
/** agy permission deny rules: same complement, in agy's mcp(<server>/<tool>) form. */
|
|
34
|
+
export declare function agyMemberDenyRules(): string[];
|
|
35
|
+
/**
|
|
36
|
+
* Removes the legacy/superseded fleet MCP entries from a parsed config object,
|
|
37
|
+
* in place, and reports whether anything changed:
|
|
38
|
+
* - mcpServers['apra-fleet-member'] and mcp['apra-fleet-member'] (the retired
|
|
39
|
+
* url+bearer registration);
|
|
40
|
+
* - mcpServers['apra-fleet'] when it is the old blanket `{disabled: true}`
|
|
41
|
+
* switch compose used to write.
|
|
42
|
+
* Any other entry (deepwiki, user-added servers) is never touched. A map this
|
|
43
|
+
* prune empties is removed so no `mcpServers: {}` residue is left behind.
|
|
44
|
+
*/
|
|
45
|
+
export declare function pruneLegacyMcpEntries(obj: Record<string, unknown>): boolean;
|
|
46
|
+
/** Joins `relPath` (forward-slash separated) onto an absolute member-side base
|
|
47
|
+
* directory, OS- and shell-appropriately. PowerShell members get backslashes;
|
|
48
|
+
* a Git-for-Windows (gitbash) member gets the C:/... form bash understands. */
|
|
49
|
+
export declare function joinMemberPath(base: string, relPath: string, isWindows: boolean, shell?: MemberShell): string;
|
|
50
|
+
/**
|
|
51
|
+
* Quotes a resolved member-side path for a POSIX shell (bash/sh/zsh, including
|
|
52
|
+
* Git-for-Windows bash). Wrapped in double quotes with every character that
|
|
53
|
+
* stays special inside them -- $ (expansion), backtick (command substitution),
|
|
54
|
+
* " (ends the string), and backslash (the escape character) -- backslash-escaped,
|
|
55
|
+
* so the member's shell receives the path verbatim. Single quotes are literal
|
|
56
|
+
* inside double quotes and need nothing. A path with no metacharacter yields
|
|
57
|
+
* exactly `"<path>"`, the shape these commands have always carried.
|
|
58
|
+
*/
|
|
59
|
+
export declare function quotePosixPath(p: string): string;
|
|
60
|
+
/**
|
|
61
|
+
* Quotes a resolved member-side path for PowerShell (5.1 and 7). Wrapped in
|
|
62
|
+
* double quotes with every character that stays special inside them -- $
|
|
63
|
+
* (expansion), backtick (the escape character), and the double-quote forms
|
|
64
|
+
* PowerShell recognises (ASCII " and U+201C..U+201E) -- backtick-escaped.
|
|
65
|
+
* Single quotes are literal inside double quotes and need nothing. A path with
|
|
66
|
+
* no metacharacter yields exactly `"<path>"`.
|
|
67
|
+
*/
|
|
68
|
+
export declare function quotePwshPath(p: string): string;
|
|
69
|
+
/**
|
|
70
|
+
* Command string that moves `staged` to `target`, making any missing parent
|
|
71
|
+
* directory along the way. Target directory permissions follow the member's
|
|
72
|
+
* default; only the staged file itself carries owner-only permissions
|
|
73
|
+
* (creating its directory). POSIX also forces 0600 on the result; the staged
|
|
74
|
+
* file is owner-only already. Carries resolved, quoted paths only.
|
|
75
|
+
*/
|
|
76
|
+
export declare function moveStagedFileCommand(staged: string, target: string, posix: boolean): string;
|
|
77
|
+
/**
|
|
78
|
+
* A member-side config file the apra-fleet MCP sync cannot safely touch
|
|
79
|
+
* (unreadable, not strict JSON, git-tracked, ...). compose_permissions treats it
|
|
80
|
+
* as a RECOVERABLE condition: nothing is written to that file, the member's
|
|
81
|
+
* fleetMcp status is recorded unavailable with `reason`, and the rest of
|
|
82
|
+
* compose carries on.
|
|
83
|
+
*/
|
|
84
|
+
export declare class MemberConfigError extends Error {
|
|
85
|
+
readonly code: string;
|
|
86
|
+
/** Machine-readable fleetMcp unavailable reason recorded by compose. */
|
|
87
|
+
readonly reason: string;
|
|
88
|
+
readonly filePath: string;
|
|
89
|
+
constructor(code: string,
|
|
90
|
+
/** Machine-readable fleetMcp unavailable reason recorded by compose. */
|
|
91
|
+
reason: string, filePath: string, message: string);
|
|
92
|
+
}
|
|
93
|
+
/** The file exists but could not be read (EACCES, sharing violation, ...). */
|
|
94
|
+
export declare class MemberConfigUnreadableError extends MemberConfigError {
|
|
95
|
+
constructor(filePath: string, detail?: string);
|
|
96
|
+
}
|
|
97
|
+
/** The file exists and was read, but is not a strict JSON object (e.g. JSONC). */
|
|
98
|
+
export declare class MemberConfigNotJsonError extends MemberConfigError {
|
|
99
|
+
constructor(filePath: string, detail: string, reason?: string);
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* The read command for a member-side file. The existence test is built here in
|
|
103
|
+
* JavaScript per shell (never shell-variable expansion): a MISSING file yields
|
|
104
|
+
* empty output and exit 0, an EXISTING file that cannot be read yields a
|
|
105
|
+
* non-zero exit -- the exit code is never swallowed.
|
|
106
|
+
*/
|
|
107
|
+
export declare function readMemberFileCommand(absPath: string, posix: boolean): string;
|
|
108
|
+
/** Read a member-side text file. A missing file reads as ''; an existing file
|
|
109
|
+
* that cannot be read THROWS MemberConfigUnreadableError (never reads as ''). */
|
|
110
|
+
export declare function readMemberFile(exec: MemberExecFn, absPath: string, posix: boolean): Promise<string>;
|
|
111
|
+
/** PowerShell regular-file probe whose exit code reflects the result (a bare
|
|
112
|
+
* Test-Path prints True/False and exits 0 either way). `-PathType Leaf`
|
|
113
|
+
* excludes directories. Single-quoted literal (no expansion at all). */
|
|
114
|
+
export declare function memberFileExistsPwshCommand(absPath: string): string;
|
|
115
|
+
/** POSIX regular-file probe: `test -f` (a directory, or a missing path, exits 1). */
|
|
116
|
+
export declare function memberFileExistsPosixCommand(absPath: string): string;
|
|
117
|
+
/**
|
|
118
|
+
* True when a regular file exists at the member-side `absPath`. A directory at
|
|
119
|
+
* that path reads as false (POSIX `test -f`, PowerShell `-PathType Leaf`), as
|
|
120
|
+
* does a missing path or any other non-zero exit. The command carries a
|
|
121
|
+
* resolved, quoted path only (no expansion).
|
|
122
|
+
*/
|
|
123
|
+
export declare function memberFileExists(exec: MemberExecFn, absPath: string, posix: boolean): Promise<boolean>;
|
|
124
|
+
/**
|
|
125
|
+
* True when git tracks `relPath` in the member work folder
|
|
126
|
+
* (`git ls-files --error-unmatch`). Not a repo / git missing / untracked all
|
|
127
|
+
* read as false. The command carries a resolved path only (no expansion), with
|
|
128
|
+
* the path form the member's shell expects.
|
|
129
|
+
*/
|
|
130
|
+
export declare function isGitTracked(exec: MemberExecFn, workFolder: string, relPath: string, isWindows: boolean, posix: boolean): Promise<boolean>;
|
|
131
|
+
/**
|
|
132
|
+
* The command that prints the git repository root of `workFolder` on the
|
|
133
|
+
* member. Resolved path, quoted per shell (quotePosixPath / quotePwshPath), no
|
|
134
|
+
* $VAR, ~ or backtick expansion for the member shell to perform.
|
|
135
|
+
*/
|
|
136
|
+
export declare function memberRepoRootCommand(workFolder: string, isWindows: boolean, posix: boolean): string;
|
|
137
|
+
/** Forward-slash, no trailing slash: the form Claude's project keys take. */
|
|
138
|
+
export declare function normalizeProjectKey(p: string): string;
|
|
139
|
+
/**
|
|
140
|
+
* The key Claude Code files a work folder's LOCAL-scope MCP servers under in
|
|
141
|
+
* its config file (projects[<key>].mcpServers): the git repository root of the
|
|
142
|
+
* folder, or the exact folder outside a git repo (git missing, not a repo, an
|
|
143
|
+
* unusable answer). The ONE resolver for both the writer (syncMemberMcpEntry)
|
|
144
|
+
* and the fleetMcp probe, so they can never disagree on the key.
|
|
145
|
+
*/
|
|
146
|
+
export declare function resolveClaudeProjectKey(exec: MemberExecFn, workFolder: string, isWindows: boolean, posix: boolean): Promise<string>;
|
|
147
|
+
/** Reads and parses a member-side JSON file. Returns {} for a missing/empty
|
|
148
|
+
* file; THROWS a typed MemberConfigError for an unreadable file or a non-empty
|
|
149
|
+
* file that is not a JSON object, so a caller can never clobber a file it
|
|
150
|
+
* could not understand. */
|
|
151
|
+
export declare function readMemberJson(exec: MemberExecFn, absPath: string, posix: boolean): Promise<Record<string, unknown>>;
|
|
152
|
+
/**
|
|
153
|
+
* Writes `content` to a member-side file (creating its parent directory), then
|
|
154
|
+
* reads it back and confirms it landed. Throws on a nonzero exit or a
|
|
155
|
+
* read-back mismatch -- a write that did not land is never reported as done.
|
|
156
|
+
*/
|
|
157
|
+
export declare function writeMemberFile(exec: MemberExecFn, absPath: string, content: string, posix: boolean): Promise<void>;
|
|
158
|
+
/** Writes a JSON object to a member-side file (pretty-printed), verified. */
|
|
159
|
+
export declare function writeMemberJson(exec: MemberExecFn, absPath: string, obj: Record<string, unknown>, posix: boolean): Promise<void>;
|
|
160
|
+
/**
|
|
161
|
+
* Writes a config file that carries a member access secret WITHOUT the
|
|
162
|
+
* content ever appearing in a command string: staged in an owner-only file
|
|
163
|
+
* through the secret-file channel, then moved into place by a content-free
|
|
164
|
+
* command (the file stays owner-only, 0600 on POSIX). No channel -> throws loudly;
|
|
165
|
+
* there is no inline fallback.
|
|
166
|
+
*/
|
|
167
|
+
export declare function writeSecretBearingConfig(ctx: MemberMcpSyncContext, file: string, content: string, posix: boolean): Promise<void>;
|
|
168
|
+
/** Deletes a member-side file (no error when it is already gone). */
|
|
169
|
+
export declare function deleteMemberFile(exec: MemberExecFn, absPath: string, posix: boolean): Promise<void>;
|
|
170
|
+
/**
|
|
171
|
+
* Resolves the member work folder's git exclude file (`.git/info/exclude`, or
|
|
172
|
+
* the common git dir's for a worktree). Returns null when the work folder is
|
|
173
|
+
* not a git repository -- there is nothing to keep clean then.
|
|
174
|
+
*/
|
|
175
|
+
export declare function resolveGitExcludePath(exec: MemberExecFn, workFolder: string, isWindows: boolean, shell?: MemberShell): Promise<string | null>;
|
|
176
|
+
/** Exclude-file line for a work-folder-relative path: anchored to the repo root. */
|
|
177
|
+
export declare function excludeLineFor(relPath: string): string;
|
|
178
|
+
/**
|
|
179
|
+
* Adds each work-folder-relative path to the work folder's git exclude file so
|
|
180
|
+
* files fleet writes into a member clone never show the clone as dirty. Never
|
|
181
|
+
* touches a tracked file (.gitignore) -- info/exclude is local-only.
|
|
182
|
+
*/
|
|
183
|
+
export declare function ensureGitExcluded(exec: MemberExecFn, workFolder: string, relPaths: string[], isWindows: boolean, shell?: MemberShell): Promise<void>;
|
|
184
|
+
/** Removes the exclude lines ensureGitExcluded added for `relPaths`. */
|
|
185
|
+
export declare function removeGitExcluded(exec: MemberExecFn, workFolder: string, relPaths: string[], isWindows: boolean, shell?: MemberShell): Promise<void>;
|
|
186
|
+
/**
|
|
187
|
+
* Prunes the legacy fleet MCP entries (pruneLegacyMcpEntries) from an EXISTING
|
|
188
|
+
* member-side JSON config file. A missing/empty file is left alone (never
|
|
189
|
+
* created); the file is rewritten only when something was actually removed.
|
|
190
|
+
* Returns whether it changed the file.
|
|
191
|
+
*/
|
|
192
|
+
export declare function pruneLegacyMcpInMemberFile(exec: MemberExecFn, absPath: string, posix: boolean): Promise<boolean>;
|
|
193
|
+
//# sourceMappingURL=member-config-io.d.ts.map
|
|
@@ -0,0 +1,446 @@
|
|
|
1
|
+
// Member-side config file I/O shared by compose_permissions and the provider
|
|
2
|
+
// adapters' per-folder member MCP wiring (syncMemberMcpEntry).
|
|
3
|
+
//
|
|
4
|
+
// Every command built here carries fully resolved paths -- never $HOME, ~/,
|
|
5
|
+
// $env:..., or backticks for the member's shell to expand -- because that
|
|
6
|
+
// shell may be PowerShell, not POSIX. The caller resolves the member's home
|
|
7
|
+
// in JavaScript (getMemberHomeDir) before handing paths in, and every path is
|
|
8
|
+
// quoted per shell (quotePosixPath / quotePwshPath) so a $, backtick or quote
|
|
9
|
+
// that is part of a real path name is passed through verbatim, never
|
|
10
|
+
// interpolated.
|
|
11
|
+
//
|
|
12
|
+
// The read/write command shapes are deliberately identical to the ones
|
|
13
|
+
// compose_permissions' deliverConfigFile has always issued (cat / heredoc
|
|
14
|
+
// FLEET_PERMS_EOF on POSIX, Get-Content / WriteAllText on PowerShell), so a
|
|
15
|
+
// single member-filesystem test double serves both.
|
|
16
|
+
import { isPosixShell } from '../utils/agent-helpers.js';
|
|
17
|
+
import { escapePowerShellArgInner } from '../utils/shell-escape.js';
|
|
18
|
+
import { BUILTIN_DEFAULT_PORT, resolveServerPort } from '../paths.js';
|
|
19
|
+
import { MEMBER_ALLOWED_TOOLS, MEMBER_DENIED_TOOLS } from './member-tool-allowlist.js';
|
|
20
|
+
/** Name of the per-folder member MCP entry every provider writes. */
|
|
21
|
+
export const MEMBER_MCP_SERVER_NAME = 'apra-fleet';
|
|
22
|
+
/** Name of the retired url+bearer member entry; pruned wherever compose finds it. */
|
|
23
|
+
export const LEGACY_MEMBER_MCP_SERVER_NAME = 'apra-fleet-member';
|
|
24
|
+
const FS_OP_TIMEOUT_MS = 15000;
|
|
25
|
+
/**
|
|
26
|
+
* The URL a member session uses to reach the fleet MCP server on its OWN
|
|
27
|
+
* machine. `?member=<uuid>` identifies the session as that member, which is
|
|
28
|
+
* what reduces the served tool list to the member allowlist. A local member
|
|
29
|
+
* shares this process's server, so it follows the port that server binds
|
|
30
|
+
* (resolveServerPort: an APRA_FLEET_PORT sandbox, else the recorded install
|
|
31
|
+
* port); a remote member talks to its OWN install, on
|
|
32
|
+
* the port that install records in its member-install marker
|
|
33
|
+
* (agent.memberMcpPort, resolved on the member by the fleetMcp probe), or the
|
|
34
|
+
* built-in default when it recorded none (the probe reports that in fleetMcp
|
|
35
|
+
* detail). Two member installs on one host (one per Unix user) therefore each
|
|
36
|
+
* get their own server, never the other user's.
|
|
37
|
+
*/
|
|
38
|
+
export function memberMcpUrl(agent) {
|
|
39
|
+
// Local: the port this server binds (env, else the recorded member/full
|
|
40
|
+
// install port, else the default) -- the same source http-transport uses.
|
|
41
|
+
const port = agent.agentType === 'local' ? resolveServerPort() : (agent.memberMcpPort ?? BUILTIN_DEFAULT_PORT);
|
|
42
|
+
return `http://localhost:${port}/mcp?member=${encodeURIComponent(agent.id)}`;
|
|
43
|
+
}
|
|
44
|
+
/** Claude permission deny rules: every registered fleet tool outside the member
|
|
45
|
+
* allowlist, on the member's apra-fleet server. Derived, never hand-listed. */
|
|
46
|
+
export function claudeMemberDenyRules() {
|
|
47
|
+
return MEMBER_DENIED_TOOLS.map(tool => `mcp__${MEMBER_MCP_SERVER_NAME}__${tool}`);
|
|
48
|
+
}
|
|
49
|
+
/** Allow rules, in Claude's mcp__<server>__<tool> form, for every fleet tool in
|
|
50
|
+
* the member allowlist (kb_*, code_* and the self-reporting tools) -- never a
|
|
51
|
+
* maintainer-only or never-served tool. compose_permissions adds them to every
|
|
52
|
+
* composed profile so an acceptEdits session (a model without auto support)
|
|
53
|
+
* is not refused a member tool for lack of an allow rule. Derived, never
|
|
54
|
+
* hand-listed; agy maps the same tokens to mcp(<server>/<tool>). */
|
|
55
|
+
export function memberMcpAllowRules() {
|
|
56
|
+
return MEMBER_ALLOWED_TOOLS.map(tool => `mcp__${MEMBER_MCP_SERVER_NAME}__${tool}`);
|
|
57
|
+
}
|
|
58
|
+
/** agy permission deny rules: same complement, in agy's mcp(<server>/<tool>) form. */
|
|
59
|
+
export function agyMemberDenyRules() {
|
|
60
|
+
return MEMBER_DENIED_TOOLS.map(tool => `mcp(${MEMBER_MCP_SERVER_NAME}/${tool})`);
|
|
61
|
+
}
|
|
62
|
+
function isPlainObject(v) {
|
|
63
|
+
return typeof v === 'object' && v !== null && !Array.isArray(v);
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Removes the legacy/superseded fleet MCP entries from a parsed config object,
|
|
67
|
+
* in place, and reports whether anything changed:
|
|
68
|
+
* - mcpServers['apra-fleet-member'] and mcp['apra-fleet-member'] (the retired
|
|
69
|
+
* url+bearer registration);
|
|
70
|
+
* - mcpServers['apra-fleet'] when it is the old blanket `{disabled: true}`
|
|
71
|
+
* switch compose used to write.
|
|
72
|
+
* Any other entry (deepwiki, user-added servers) is never touched. A map this
|
|
73
|
+
* prune empties is removed so no `mcpServers: {}` residue is left behind.
|
|
74
|
+
*/
|
|
75
|
+
export function pruneLegacyMcpEntries(obj) {
|
|
76
|
+
let changed = false;
|
|
77
|
+
for (const mapKey of ['mcpServers', 'mcp']) {
|
|
78
|
+
const map = obj[mapKey];
|
|
79
|
+
if (!isPlainObject(map))
|
|
80
|
+
continue;
|
|
81
|
+
let touched = false;
|
|
82
|
+
if (LEGACY_MEMBER_MCP_SERVER_NAME in map) {
|
|
83
|
+
delete map[LEGACY_MEMBER_MCP_SERVER_NAME];
|
|
84
|
+
touched = true;
|
|
85
|
+
}
|
|
86
|
+
const fleet = map[MEMBER_MCP_SERVER_NAME];
|
|
87
|
+
if (isPlainObject(fleet) && fleet.disabled === true) {
|
|
88
|
+
delete map[MEMBER_MCP_SERVER_NAME];
|
|
89
|
+
touched = true;
|
|
90
|
+
}
|
|
91
|
+
if (touched) {
|
|
92
|
+
changed = true;
|
|
93
|
+
if (Object.keys(map).length === 0)
|
|
94
|
+
delete obj[mapKey];
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
return changed;
|
|
98
|
+
}
|
|
99
|
+
/** Joins `relPath` (forward-slash separated) onto an absolute member-side base
|
|
100
|
+
* directory, OS- and shell-appropriately. PowerShell members get backslashes;
|
|
101
|
+
* a Git-for-Windows (gitbash) member gets the C:/... form bash understands. */
|
|
102
|
+
export function joinMemberPath(base, relPath, isWindows, shell) {
|
|
103
|
+
if (isWindows) {
|
|
104
|
+
const b = base.replace(/[\\/]+$/, '').replace(/\//g, '\\');
|
|
105
|
+
const winPath = `${b}\\${relPath.replace(/\//g, '\\')}`;
|
|
106
|
+
if (isPosixShell(isWindows, shell))
|
|
107
|
+
return winPath.replace(/\\/g, '/');
|
|
108
|
+
return winPath;
|
|
109
|
+
}
|
|
110
|
+
return `${base.replace(/\/+$/, '')}/${relPath}`;
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Quotes a resolved member-side path for a POSIX shell (bash/sh/zsh, including
|
|
114
|
+
* Git-for-Windows bash). Wrapped in double quotes with every character that
|
|
115
|
+
* stays special inside them -- $ (expansion), backtick (command substitution),
|
|
116
|
+
* " (ends the string), and backslash (the escape character) -- backslash-escaped,
|
|
117
|
+
* so the member's shell receives the path verbatim. Single quotes are literal
|
|
118
|
+
* inside double quotes and need nothing. A path with no metacharacter yields
|
|
119
|
+
* exactly `"<path>"`, the shape these commands have always carried.
|
|
120
|
+
*/
|
|
121
|
+
export function quotePosixPath(p) {
|
|
122
|
+
return `"${p.replace(/[\\"$`]/g, '\\$&')}"`;
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Quotes a resolved member-side path for PowerShell (5.1 and 7). Wrapped in
|
|
126
|
+
* double quotes with every character that stays special inside them -- $
|
|
127
|
+
* (expansion), backtick (the escape character), and the double-quote forms
|
|
128
|
+
* PowerShell recognises (ASCII " and U+201C..U+201E) -- backtick-escaped.
|
|
129
|
+
* Single quotes are literal inside double quotes and need nothing. A path with
|
|
130
|
+
* no metacharacter yields exactly `"<path>"`.
|
|
131
|
+
*/
|
|
132
|
+
export function quotePwshPath(p) {
|
|
133
|
+
return `"${p.replace(/[`$"\u201C-\u201E]/g, '`$&')}"`;
|
|
134
|
+
}
|
|
135
|
+
/** quotePosixPath or quotePwshPath (with Windows backslashes) per shell. */
|
|
136
|
+
function quotePath(absPath, posix) {
|
|
137
|
+
return posix ? quotePosixPath(absPath) : quotePwshPath(absPath.replace(/\//g, '\\'));
|
|
138
|
+
}
|
|
139
|
+
function dirOf(absPath, posix) {
|
|
140
|
+
return posix
|
|
141
|
+
? absPath.split('/').slice(0, -1).join('/')
|
|
142
|
+
: absPath.replace(/\//g, '\\').split('\\').slice(0, -1).join('\\');
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* Command string that moves `staged` to `target`, making any missing parent
|
|
146
|
+
* directory along the way. Target directory permissions follow the member's
|
|
147
|
+
* default; only the staged file itself carries owner-only permissions
|
|
148
|
+
* (creating its directory). POSIX also forces 0600 on the result; the staged
|
|
149
|
+
* file is owner-only already. Carries resolved, quoted paths only.
|
|
150
|
+
*/
|
|
151
|
+
export function moveStagedFileCommand(staged, target, posix) {
|
|
152
|
+
if (posix) {
|
|
153
|
+
const dir = target.split('/').slice(0, -1).join('/');
|
|
154
|
+
return `mkdir -p ${quotePosixPath(dir)} && mv -f ${quotePosixPath(staged)} ${quotePosixPath(target)} && chmod 600 ${quotePosixPath(target)}`;
|
|
155
|
+
}
|
|
156
|
+
const t = target.replace(/\//g, '\\');
|
|
157
|
+
const dir = t.split('\\').slice(0, -1).join('\\');
|
|
158
|
+
return `New-Item -ItemType Directory -Force -Path ${quotePwshPath(dir)} | Out-Null; Move-Item -Force -LiteralPath ${quotePwshPath(staged.replace(/\//g, '\\'))} -Destination ${quotePwshPath(t)}`;
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* A member-side config file the apra-fleet MCP sync cannot safely touch
|
|
162
|
+
* (unreadable, not strict JSON, git-tracked, ...). compose_permissions treats it
|
|
163
|
+
* as a RECOVERABLE condition: nothing is written to that file, the member's
|
|
164
|
+
* fleetMcp status is recorded unavailable with `reason`, and the rest of
|
|
165
|
+
* compose carries on.
|
|
166
|
+
*/
|
|
167
|
+
export class MemberConfigError extends Error {
|
|
168
|
+
code;
|
|
169
|
+
reason;
|
|
170
|
+
filePath;
|
|
171
|
+
constructor(code,
|
|
172
|
+
/** Machine-readable fleetMcp unavailable reason recorded by compose. */
|
|
173
|
+
reason, filePath, message) {
|
|
174
|
+
super(message);
|
|
175
|
+
this.code = code;
|
|
176
|
+
this.reason = reason;
|
|
177
|
+
this.filePath = filePath;
|
|
178
|
+
this.name = 'MemberConfigError';
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
/** The file exists but could not be read (EACCES, sharing violation, ...). */
|
|
182
|
+
export class MemberConfigUnreadableError extends MemberConfigError {
|
|
183
|
+
constructor(filePath, detail) {
|
|
184
|
+
super('E-MEMBER-CONFIG-UNREADABLE', 'member-config-unreadable', filePath, `E-MEMBER-CONFIG-UNREADABLE: ${filePath} exists but could not be read${detail ? ` (${detail})` : ''}; refusing to treat it as empty or rewrite it`);
|
|
185
|
+
this.name = 'MemberConfigUnreadableError';
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
/** The file exists and was read, but is not a strict JSON object (e.g. JSONC). */
|
|
189
|
+
export class MemberConfigNotJsonError extends MemberConfigError {
|
|
190
|
+
constructor(filePath, detail, reason = 'member-config-unparseable') {
|
|
191
|
+
super('E-MEMBER-CONFIG-NOT-JSON', reason, filePath, `E-MEMBER-CONFIG-NOT-JSON: ${filePath} ${detail}; refusing to rewrite it`);
|
|
192
|
+
this.name = 'MemberConfigNotJsonError';
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* The read command for a member-side file. The existence test is built here in
|
|
197
|
+
* JavaScript per shell (never shell-variable expansion): a MISSING file yields
|
|
198
|
+
* empty output and exit 0, an EXISTING file that cannot be read yields a
|
|
199
|
+
* non-zero exit -- the exit code is never swallowed.
|
|
200
|
+
*/
|
|
201
|
+
export function readMemberFileCommand(absPath, posix) {
|
|
202
|
+
const q = quotePath(absPath, posix);
|
|
203
|
+
if (posix)
|
|
204
|
+
return `if test -e ${q}; then cat ${q}; fi`;
|
|
205
|
+
return `if (Test-Path -LiteralPath ${q}) { Get-Content -Raw -LiteralPath ${q} -ErrorAction Stop }`;
|
|
206
|
+
}
|
|
207
|
+
/** Read a member-side text file. A missing file reads as ''; an existing file
|
|
208
|
+
* that cannot be read THROWS MemberConfigUnreadableError (never reads as ''). */
|
|
209
|
+
export async function readMemberFile(exec, absPath, posix) {
|
|
210
|
+
const r = await exec(readMemberFileCommand(absPath, posix), FS_OP_TIMEOUT_MS);
|
|
211
|
+
if (typeof r.code === 'number' && r.code !== 0) {
|
|
212
|
+
throw new MemberConfigUnreadableError(absPath, `exit ${r.code}${stderrExcerpt(r)}`);
|
|
213
|
+
}
|
|
214
|
+
return r.stdout ?? '';
|
|
215
|
+
}
|
|
216
|
+
/** PowerShell regular-file probe whose exit code reflects the result (a bare
|
|
217
|
+
* Test-Path prints True/False and exits 0 either way). `-PathType Leaf`
|
|
218
|
+
* excludes directories. Single-quoted literal (no expansion at all). */
|
|
219
|
+
export function memberFileExistsPwshCommand(absPath) {
|
|
220
|
+
const p = escapePowerShellArgInner(absPath.replace(/\//g, '\\'));
|
|
221
|
+
return `if (Test-Path -LiteralPath '${p}' -PathType Leaf) { exit 0 } else { exit 1 }`;
|
|
222
|
+
}
|
|
223
|
+
/** POSIX regular-file probe: `test -f` (a directory, or a missing path, exits 1). */
|
|
224
|
+
export function memberFileExistsPosixCommand(absPath) {
|
|
225
|
+
return `test -f ${quotePosixPath(absPath)}`;
|
|
226
|
+
}
|
|
227
|
+
/**
|
|
228
|
+
* True when a regular file exists at the member-side `absPath`. A directory at
|
|
229
|
+
* that path reads as false (POSIX `test -f`, PowerShell `-PathType Leaf`), as
|
|
230
|
+
* does a missing path or any other non-zero exit. The command carries a
|
|
231
|
+
* resolved, quoted path only (no expansion).
|
|
232
|
+
*/
|
|
233
|
+
export async function memberFileExists(exec, absPath, posix) {
|
|
234
|
+
const cmd = posix ? memberFileExistsPosixCommand(absPath) : memberFileExistsPwshCommand(absPath);
|
|
235
|
+
const r = await exec(cmd, FS_OP_TIMEOUT_MS);
|
|
236
|
+
return r.code === 0;
|
|
237
|
+
}
|
|
238
|
+
/**
|
|
239
|
+
* True when git tracks `relPath` in the member work folder
|
|
240
|
+
* (`git ls-files --error-unmatch`). Not a repo / git missing / untracked all
|
|
241
|
+
* read as false. The command carries a resolved path only (no expansion), with
|
|
242
|
+
* the path form the member's shell expects.
|
|
243
|
+
*/
|
|
244
|
+
export async function isGitTracked(exec, workFolder, relPath, isWindows, posix) {
|
|
245
|
+
const wf = isWindows && !posix ? workFolder.replace(/\//g, '\\') : workFolder.replace(/\\/g, '/');
|
|
246
|
+
const q = posix ? quotePosixPath : quotePwshPath;
|
|
247
|
+
const r = await exec(`git -C ${q(wf)} ls-files --error-unmatch -- ${q(relPath)}`, FS_OP_TIMEOUT_MS);
|
|
248
|
+
return r.code === 0;
|
|
249
|
+
}
|
|
250
|
+
/**
|
|
251
|
+
* The command that prints the git repository root of `workFolder` on the
|
|
252
|
+
* member. Resolved path, quoted per shell (quotePosixPath / quotePwshPath), no
|
|
253
|
+
* $VAR, ~ or backtick expansion for the member shell to perform.
|
|
254
|
+
*/
|
|
255
|
+
export function memberRepoRootCommand(workFolder, isWindows, posix) {
|
|
256
|
+
const wf = isWindows && !posix ? workFolder.replace(/\//g, '\\') : workFolder.replace(/\\/g, '/');
|
|
257
|
+
const q = posix ? quotePosixPath : quotePwshPath;
|
|
258
|
+
return `git -C ${q(wf)} rev-parse --show-toplevel`;
|
|
259
|
+
}
|
|
260
|
+
/** Forward-slash, no trailing slash: the form Claude's project keys take. */
|
|
261
|
+
export function normalizeProjectKey(p) {
|
|
262
|
+
return p.trim().replace(/\\/g, '/').replace(/\/+$/, '');
|
|
263
|
+
}
|
|
264
|
+
/**
|
|
265
|
+
* The key Claude Code files a work folder's LOCAL-scope MCP servers under in
|
|
266
|
+
* its config file (projects[<key>].mcpServers): the git repository root of the
|
|
267
|
+
* folder, or the exact folder outside a git repo (git missing, not a repo, an
|
|
268
|
+
* unusable answer). The ONE resolver for both the writer (syncMemberMcpEntry)
|
|
269
|
+
* and the fleetMcp probe, so they can never disagree on the key.
|
|
270
|
+
*/
|
|
271
|
+
export async function resolveClaudeProjectKey(exec, workFolder, isWindows, posix) {
|
|
272
|
+
const fallback = normalizeProjectKey(workFolder);
|
|
273
|
+
try {
|
|
274
|
+
const r = await exec(memberRepoRootCommand(workFolder, isWindows, posix), FS_OP_TIMEOUT_MS);
|
|
275
|
+
if (r.code !== 0)
|
|
276
|
+
return fallback;
|
|
277
|
+
const root = (r.stdout ?? '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean).pop();
|
|
278
|
+
if (!root)
|
|
279
|
+
return fallback;
|
|
280
|
+
const absolute = root.startsWith('/') || /^[A-Za-z]:[\\/]/.test(root);
|
|
281
|
+
return absolute ? normalizeProjectKey(root) : fallback;
|
|
282
|
+
}
|
|
283
|
+
catch {
|
|
284
|
+
return fallback;
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
/** Reads and parses a member-side JSON file. Returns {} for a missing/empty
|
|
288
|
+
* file; THROWS a typed MemberConfigError for an unreadable file or a non-empty
|
|
289
|
+
* file that is not a JSON object, so a caller can never clobber a file it
|
|
290
|
+
* could not understand. */
|
|
291
|
+
export async function readMemberJson(exec, absPath, posix) {
|
|
292
|
+
const raw = (await readMemberFile(exec, absPath, posix)).trim();
|
|
293
|
+
if (!raw)
|
|
294
|
+
return {};
|
|
295
|
+
let parsed;
|
|
296
|
+
try {
|
|
297
|
+
parsed = JSON.parse(raw);
|
|
298
|
+
}
|
|
299
|
+
catch {
|
|
300
|
+
throw new MemberConfigNotJsonError(absPath, 'exists but is not valid JSON');
|
|
301
|
+
}
|
|
302
|
+
if (!isPlainObject(parsed))
|
|
303
|
+
throw new MemberConfigNotJsonError(absPath, 'is not a JSON object');
|
|
304
|
+
return parsed;
|
|
305
|
+
}
|
|
306
|
+
function stderrExcerpt(r) {
|
|
307
|
+
const s = (r.stderr ?? '').replace(/\s+/g, ' ').trim();
|
|
308
|
+
return s ? `: ${s.slice(0, 300)}` : '';
|
|
309
|
+
}
|
|
310
|
+
/**
|
|
311
|
+
* Writes `content` to a member-side file (creating its parent directory), then
|
|
312
|
+
* reads it back and confirms it landed. Throws on a nonzero exit or a
|
|
313
|
+
* read-back mismatch -- a write that did not land is never reported as done.
|
|
314
|
+
*/
|
|
315
|
+
export async function writeMemberFile(exec, absPath, content, posix) {
|
|
316
|
+
const dir = dirOf(absPath, posix);
|
|
317
|
+
const qPath = quotePath(absPath, posix);
|
|
318
|
+
const qDir = quotePath(dir, posix);
|
|
319
|
+
const mkdirCmd = posix ? `mkdir -p ${qDir}` : `New-Item -ItemType Directory -Force ${qDir}`;
|
|
320
|
+
const mk = await exec(mkdirCmd, FS_OP_TIMEOUT_MS);
|
|
321
|
+
if (mk.code !== 0)
|
|
322
|
+
throw new Error(`could not create "${dir}" (exit ${mk.code})${stderrExcerpt(mk)}`);
|
|
323
|
+
const body = content.replace(/\n+$/, '');
|
|
324
|
+
const writeCmd = posix
|
|
325
|
+
? `cat > ${qPath} << 'FLEET_PERMS_EOF'\n${body}\nFLEET_PERMS_EOF`
|
|
326
|
+
: `[System.IO.File]::WriteAllText(${qPath}, '${escapePowerShellArgInner(body + '\n')}', (New-Object System.Text.UTF8Encoding($false)))`;
|
|
327
|
+
const w = await exec(writeCmd, FS_OP_TIMEOUT_MS);
|
|
328
|
+
if (w.code !== 0)
|
|
329
|
+
throw new Error(`write of ${absPath} failed (exit ${w.code})${stderrExcerpt(w)}`);
|
|
330
|
+
if (!body.trim())
|
|
331
|
+
return; // an intentionally empty file has nothing to read back
|
|
332
|
+
const back = (await readMemberFile(exec, absPath, posix)).trim();
|
|
333
|
+
if (!back || !back.replace(/\r\n/g, '\n').includes(body.trim())) {
|
|
334
|
+
throw new Error(`read-back of ${absPath} did not match what was written`);
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
/** Writes a JSON object to a member-side file (pretty-printed), verified. */
|
|
338
|
+
export async function writeMemberJson(exec, absPath, obj, posix) {
|
|
339
|
+
await writeMemberFile(exec, absPath, JSON.stringify(obj, null, 2), posix);
|
|
340
|
+
}
|
|
341
|
+
/**
|
|
342
|
+
* Writes a config file that carries a member access secret WITHOUT the
|
|
343
|
+
* content ever appearing in a command string: staged in an owner-only file
|
|
344
|
+
* through the secret-file channel, then moved into place by a content-free
|
|
345
|
+
* command (the file stays owner-only, 0600 on POSIX). No channel -> throws loudly;
|
|
346
|
+
* there is no inline fallback.
|
|
347
|
+
*/
|
|
348
|
+
export async function writeSecretBearingConfig(ctx, file, content, posix) {
|
|
349
|
+
if (!ctx.secretChannel) {
|
|
350
|
+
throw new Error(`E-MEMBER-CONFIG-NO-FILE-CHANNEL: cannot write ${file} on the member without putting the member access secret on a command line; no secret-file channel is available for this member. Enable the SFTP subsystem on the member's sshd, or use a member type with a file channel.`);
|
|
351
|
+
}
|
|
352
|
+
const staged = await ctx.secretChannel.write(content);
|
|
353
|
+
const r = await ctx.execCommand(moveStagedFileCommand(staged, file, posix), FS_OP_TIMEOUT_MS);
|
|
354
|
+
if (r.code !== 0) {
|
|
355
|
+
try {
|
|
356
|
+
await ctx.secretChannel.remove(staged);
|
|
357
|
+
}
|
|
358
|
+
catch { /* best effort */ }
|
|
359
|
+
throw new Error(`moving the staged config into ${file} failed (exit ${r.code}): ${(r.stderr || r.stdout || '').trim().slice(0, 300)}`);
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
/** Deletes a member-side file (no error when it is already gone). */
|
|
363
|
+
export async function deleteMemberFile(exec, absPath, posix) {
|
|
364
|
+
const cmd = posix
|
|
365
|
+
? `rm -f ${quotePosixPath(absPath)}`
|
|
366
|
+
: `Remove-Item -Force -ErrorAction SilentlyContinue -LiteralPath ${quotePath(absPath, false)}`;
|
|
367
|
+
const r = await exec(cmd, FS_OP_TIMEOUT_MS);
|
|
368
|
+
if (r.code !== 0)
|
|
369
|
+
throw new Error(`delete of ${absPath} failed (exit ${r.code})${stderrExcerpt(r)}`);
|
|
370
|
+
}
|
|
371
|
+
/**
|
|
372
|
+
* Resolves the member work folder's git exclude file (`.git/info/exclude`, or
|
|
373
|
+
* the common git dir's for a worktree). Returns null when the work folder is
|
|
374
|
+
* not a git repository -- there is nothing to keep clean then.
|
|
375
|
+
*/
|
|
376
|
+
export async function resolveGitExcludePath(exec, workFolder, isWindows, shell) {
|
|
377
|
+
const posix = isPosixShell(isWindows, shell);
|
|
378
|
+
const wf = isWindows && !posix ? workFolder.replace(/\//g, '\\') : workFolder.replace(/\\/g, '/');
|
|
379
|
+
const r = await exec(`git -C ${posix ? quotePosixPath(wf) : quotePwshPath(wf)} rev-parse --git-path info/exclude`, FS_OP_TIMEOUT_MS);
|
|
380
|
+
const out = (r.stdout ?? '').trim().split(/\r?\n/)[0]?.trim() ?? '';
|
|
381
|
+
if (r.code !== 0 || !out)
|
|
382
|
+
return null;
|
|
383
|
+
const isAbs = out.startsWith('/') || /^[A-Za-z]:[\\/]/.test(out);
|
|
384
|
+
if (isAbs)
|
|
385
|
+
return isWindows && !posix ? out.replace(/\//g, '\\') : out;
|
|
386
|
+
return joinMemberPath(workFolder, out.replace(/\\/g, '/'), isWindows, shell);
|
|
387
|
+
}
|
|
388
|
+
/** Exclude-file line for a work-folder-relative path: anchored to the repo root. */
|
|
389
|
+
export function excludeLineFor(relPath) {
|
|
390
|
+
return `/${relPath.replace(/\\/g, '/').replace(/^\/+/, '')}`;
|
|
391
|
+
}
|
|
392
|
+
/**
|
|
393
|
+
* Adds each work-folder-relative path to the work folder's git exclude file so
|
|
394
|
+
* files fleet writes into a member clone never show the clone as dirty. Never
|
|
395
|
+
* touches a tracked file (.gitignore) -- info/exclude is local-only.
|
|
396
|
+
*/
|
|
397
|
+
export async function ensureGitExcluded(exec, workFolder, relPaths, isWindows, shell) {
|
|
398
|
+
if (relPaths.length === 0)
|
|
399
|
+
return;
|
|
400
|
+
const excludePath = await resolveGitExcludePath(exec, workFolder, isWindows, shell);
|
|
401
|
+
if (!excludePath)
|
|
402
|
+
return;
|
|
403
|
+
const posix = isPosixShell(isWindows, shell);
|
|
404
|
+
const current = (await readMemberFile(exec, excludePath, posix)).replace(/\r\n/g, '\n');
|
|
405
|
+
const lines = current.split('\n').map(l => l.trim());
|
|
406
|
+
const missing = [...new Set(relPaths.map(excludeLineFor))].filter(l => !lines.includes(l));
|
|
407
|
+
if (missing.length === 0)
|
|
408
|
+
return;
|
|
409
|
+
const base = current.replace(/\n+$/, '');
|
|
410
|
+
const next = (base ? `${base}\n` : '') + missing.join('\n');
|
|
411
|
+
await writeMemberFile(exec, excludePath, next, posix);
|
|
412
|
+
}
|
|
413
|
+
/** Removes the exclude lines ensureGitExcluded added for `relPaths`. */
|
|
414
|
+
export async function removeGitExcluded(exec, workFolder, relPaths, isWindows, shell) {
|
|
415
|
+
if (relPaths.length === 0)
|
|
416
|
+
return;
|
|
417
|
+
const excludePath = await resolveGitExcludePath(exec, workFolder, isWindows, shell);
|
|
418
|
+
if (!excludePath)
|
|
419
|
+
return;
|
|
420
|
+
const posix = isPosixShell(isWindows, shell);
|
|
421
|
+
const current = (await readMemberFile(exec, excludePath, posix)).replace(/\r\n/g, '\n');
|
|
422
|
+
if (!current.trim())
|
|
423
|
+
return;
|
|
424
|
+
const drop = new Set(relPaths.map(excludeLineFor));
|
|
425
|
+
const kept = current.replace(/\n+$/, '').split('\n').filter(l => !drop.has(l.trim()));
|
|
426
|
+
const next = kept.join('\n');
|
|
427
|
+
if (next === current.replace(/\n+$/, ''))
|
|
428
|
+
return;
|
|
429
|
+
await writeMemberFile(exec, excludePath, next, posix);
|
|
430
|
+
}
|
|
431
|
+
/**
|
|
432
|
+
* Prunes the legacy fleet MCP entries (pruneLegacyMcpEntries) from an EXISTING
|
|
433
|
+
* member-side JSON config file. A missing/empty file is left alone (never
|
|
434
|
+
* created); the file is rewritten only when something was actually removed.
|
|
435
|
+
* Returns whether it changed the file.
|
|
436
|
+
*/
|
|
437
|
+
export async function pruneLegacyMcpInMemberFile(exec, absPath, posix) {
|
|
438
|
+
const config = await readMemberJson(exec, absPath, posix);
|
|
439
|
+
if (Object.keys(config).length === 0)
|
|
440
|
+
return false;
|
|
441
|
+
if (!pruneLegacyMcpEntries(config))
|
|
442
|
+
return false;
|
|
443
|
+
await writeMemberJson(exec, absPath, config, posix);
|
|
444
|
+
return true;
|
|
445
|
+
}
|
|
446
|
+
//# sourceMappingURL=member-config-io.js.map
|