@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -6,13 +6,19 @@ import { collectOobPassword } from '../services/auth-socket.js';
|
|
|
6
6
|
import { credentialResolve } from '../services/credential-store.js';
|
|
7
7
|
import { isValidIcon, resolveIcon, DEFAULT_ICON } from '../services/icons.js';
|
|
8
8
|
import { writeStatusline } from '../services/statusline.js';
|
|
9
|
-
import { logLine } from '../utils/log-helpers.js';
|
|
9
|
+
import { logLine, logWarn } from '../utils/log-helpers.js';
|
|
10
|
+
import { findSecretTokens, legacyTokenWarning } from '../services/secret-token.js';
|
|
10
11
|
import { invalidatePreflightCache } from '../services/preflight-check.js';
|
|
11
12
|
import { CURATED_CHEAP_MODELS, CURATED_STANDARD_MODELS, CURATED_PREMIUM_MODELS } from '../cli/config.js';
|
|
12
13
|
import { validateOpenCodeModelTiers } from '../utils/opencode-model-validation.js';
|
|
13
14
|
import { provisionAgents, remoteAgentsDir } from '../services/agent-provisioner.js';
|
|
15
|
+
import { recheckProjectAgentShadows, invalidateProjectAgentShadowCache } from '../services/agent-shadow.js';
|
|
14
16
|
import { getStrategy } from '../services/strategy.js';
|
|
15
17
|
import { seedWorkspaceTrust } from '../utils/workspace-trust.js';
|
|
18
|
+
import { ensureAgyProject } from '../services/agy-project.js';
|
|
19
|
+
import { beadsStatusNote, refreshMemberFleetMcp, getMemberFleetMcpDeps, fleetInstallWarning } from '../services/member-fleet-install.js';
|
|
20
|
+
import { composePermissions, removeComposedMemberConfig, missingClaudeAllowRules } from './compose-permissions.js';
|
|
21
|
+
import { memberMcpAllowRules } from '../services/member-config-io.js';
|
|
16
22
|
import { isFullyQualifiedPath, workFolderNotAbsoluteError } from '../utils/work-folder-validation.js';
|
|
17
23
|
export const updateMemberSchema = z.object({
|
|
18
24
|
...memberIdentifier,
|
|
@@ -28,14 +34,14 @@ export const updateMemberSchema = z.object({
|
|
|
28
34
|
port: z.number().optional().describe('New SSH port (remote members only)'),
|
|
29
35
|
username: z.string().optional().describe('New SSH username (remote members only)'),
|
|
30
36
|
auth_type: z.enum(['password', 'key']).optional().describe('New auth method (remote members only)'),
|
|
31
|
-
password: z.string().optional().describe('New SSH password. Omit for
|
|
32
|
-
rotate_password: z.boolean().optional().describe('Trigger
|
|
37
|
+
password: z.string().optional().describe('New SSH password. Omit for out-of-band entry — a password prompt will open in a separate terminal window. Supports {{secret.NAME}} token — value is resolved from the credential store before use.'),
|
|
38
|
+
rotate_password: z.boolean().optional().describe('Trigger out-of-band password re-entry for a member already using password auth. '
|
|
33
39
|
+ 'A password prompt will open in a separate terminal window. Ignored if auth_type is not password.'),
|
|
34
40
|
key_path: z.string().optional().describe('Path to SSH private key. Used for both regular SSH connections and cloud instance lifecycle.'),
|
|
35
41
|
work_folder: z.string()
|
|
36
42
|
.regex(/^[^<>\n\r]+$/, 'work_folder must not contain angle brackets or newlines')
|
|
37
43
|
.optional()
|
|
38
|
-
.describe('New working directory on target machine. For non-local (remote/relay) members, must be a fully-qualified/absolute path (e.g. "/home/bella/repo" or "C:\\Users\\bella\\repo") -- "~" and relative paths are rejected, since they are never resolved for a non-local member.'),
|
|
44
|
+
.describe('New working directory on target machine. For non-local (remote/relay) members, must be a fully-qualified/absolute path (e.g. "/home/bella/repo" or "C:\\Users\\bella\\repo") -- "~" and relative paths are rejected, since they are never resolved for a non-local member. A folder may hold at most one LLM member and one LLM-less (llm_provider none) member.'),
|
|
39
45
|
git_access: z.enum(['read', 'push', 'admin', 'issues', 'full']).optional().describe('Git access level for this member'),
|
|
40
46
|
git_repos: z.array(z.string()).optional().describe('Git repositories this member can access (e.g. ["Apra-Labs/ApraPipes"])'),
|
|
41
47
|
icon: z.string().optional().describe('Override the auto-assigned emoji icon. Use named aliases: blue-circle, green-square, red-circle, etc. (8 colors × 2 shapes: circle, square). Or pass raw emoji.'),
|
|
@@ -53,15 +59,17 @@ export const updateMemberSchema = z.object({
|
|
|
53
59
|
standard: z.string().optional(),
|
|
54
60
|
premium: z.string().optional(),
|
|
55
61
|
}).optional().describe('Per-member model tier map with free-form model IDs (e.g. "ollama/qwen3-coder:30b"). A single model fills all tiers. At least one model required.'),
|
|
56
|
-
unattended: z.preprocess((v) => v === false ? 'false' : v, z.enum(['false', 'auto', 'dangerous'])).optional().describe('Permission mode for unattended execution. Pass "false" to reset to interactive prompts; "auto" = auto-approve safe operations; "dangerous" = skip all permission checks.'),
|
|
62
|
+
unattended: z.preprocess((v) => v === false ? 'false' : v, z.enum(['false', 'auto', 'dangerous'])).optional().describe('Permission mode for unattended execution. Pass "false" to reset to interactive prompts; "auto" = auto-approve safe operations (Claude: --permission-mode auto; on a model without auto-mode support, such as Haiku, the dispatch runs acceptEdits instead); "dangerous" = skip all permission checks.'),
|
|
57
63
|
category: z.string().max(64).optional().describe('Group label for this member (e.g. "doers", "reviewers"). Pass empty string to clear.'),
|
|
58
64
|
tags: z.array(z.string().max(64, 'Each tag must be 64 characters or fewer'))
|
|
59
65
|
.max(10, 'At most 10 tags are allowed')
|
|
60
66
|
.optional()
|
|
61
67
|
.describe('Free-form labels for this member (max 10 tags, each max 64 chars). Empty array clears all tags; non-empty array replaces existing tags.'),
|
|
62
68
|
code_intel_provider: z.enum(['codebase-memory', 'gitnexus', 'none']).optional().describe('Change the code-intelligence provider for this member.'),
|
|
63
|
-
unreservable: z.boolean().optional().describe('Mark this member as never exclusively reservable, so it can be shared by more than one sprint at once (e.g. a member filling fleet-sprint\'s shared "
|
|
69
|
+
unreservable: z.boolean().optional().describe('Mark this member as never exclusively reservable, so it can be shared by more than one sprint at once (e.g. a member filling fleet-sprint\'s shared "backlog" role). reserve/release/force_release become no-op successes and overlap guards skip it.'),
|
|
64
70
|
shell: z.enum(['gitbash', 'pwsh7', 'powershell5']).optional().describe('Override the probed Windows shell for this member (gitbash, pwsh7, or powershell5). Windows members only -- ignored for non-windows members.'),
|
|
71
|
+
vcs_provider: z.enum(['github', 'bitbucket', 'azure-devops', 'none']).optional().describe('Directly set (override) this member\'s VCS provider -- an explicit operator value, never auto-detected. Use this to correct a wrong auto-detect from register_member, or to set the provider for a member with no credentials to provision (so provision_vcs_auth is not required just to record it). Pass "none" to clear it, declaring the member deliberately has no VCS provider.'),
|
|
72
|
+
fleet_install: z.enum(['auto', 'skip', 'replace-full']).optional().describe('Upgrade or skip the member\'s own apra-fleet install. "auto": for a remote member, probe it and install/upgrade apra-fleet when it is missing or older than this orchestrator (build-aware), self-register, write its per-folder apra-fleet MCP entry and verify a MEMBER session, even when nothing else changed; an install/upgrade that ran (or an install that only now became available) also adds the member apra-fleet tool rules to a claude member\'s permission allow-list through compose_permissions grant mode, keeping its role and grants (a NOTICE says so; a failure is a WARNING); local members only get the MEMBER-session probe. An install without the member-install marker (a full install) is never touched by "auto". "replace-full": everything "auto" does, plus an explicit opt-in to REPLACE such a full install with a member install (back up data and fleet.key to a timestamped dir, uninstall with the installed binary, stop the linux fleet-supervisor unit, move data aside, run the current installer in member mode, self-register); refused with no destructive command when the marker probe fails. "skip": no install (a refresh triggered by another change runs with install off). Omit to keep the default: install only on a provider change. The result reports the recoverable fleetMcp status (re-probe with member_detail refresh:true). A requested install/upgrade that cannot happen (no release for this build, checksum or download failure, unsupported platform, full install present, ...) never fails the update: it adds a WARNING naming the consequence, the exact reason and OS-correct manual install steps (also in fleetMcp.manualInstall).'),
|
|
65
73
|
});
|
|
66
74
|
export async function updateMember(input) {
|
|
67
75
|
const existingOrError = resolveMember(input.member_id, input.member_name);
|
|
@@ -95,16 +103,20 @@ export async function updateMember(input) {
|
|
|
95
103
|
if (resultingUnreservable && resultingLlmProvider !== 'none') {
|
|
96
104
|
return '❌ "unreservable" requires llm_provider: "none" -- it is reserved for plain command-executor members that never receive an agent dispatch. Member was NOT updated.';
|
|
97
105
|
}
|
|
106
|
+
// A change of LLM kind can create a same-kind clash in an unchanged folder,
|
|
107
|
+
// since a folder may hold one LLM member and one LLM-less member.
|
|
108
|
+
const llmKindChanged = ((existing.llmProvider ?? 'claude') === 'none') !== (resultingLlmProvider === 'none');
|
|
98
109
|
const needsUniquenessCheck = existing.agentType === 'remote'
|
|
99
|
-
? (hostChanged || portChanged || folderChanged)
|
|
100
|
-
: folderChanged;
|
|
110
|
+
? (hostChanged || portChanged || folderChanged || llmKindChanged)
|
|
111
|
+
: (folderChanged || llmKindChanged);
|
|
101
112
|
if (needsUniquenessCheck) {
|
|
102
113
|
const newHost = input.host ?? existing.host;
|
|
103
114
|
const newPort = input.port ?? existing.port;
|
|
104
115
|
const newFolder = input.work_folder ?? existing.workFolder;
|
|
105
|
-
if (hasDuplicateFolder(existing.agentType, newFolder, newHost, newPort, existing.id)) {
|
|
116
|
+
if (hasDuplicateFolder(existing.agentType, newFolder, newHost, newPort, existing.id, resultingLlmProvider)) {
|
|
106
117
|
const scope = existing.agentType === 'local' ? 'this machine' : `host ${newHost}:${newPort}`;
|
|
107
|
-
|
|
118
|
+
const kind = resultingLlmProvider === 'none' ? 'LLM-less' : 'LLM';
|
|
119
|
+
return `❌ Another ${kind} member already uses folder "${newFolder}" on ${scope} (a folder may hold one LLM member and one LLM-less member). Update rejected.`;
|
|
108
120
|
}
|
|
109
121
|
}
|
|
110
122
|
// Resolve named alias (e.g. "blue-circle" → "🔵") before validation
|
|
@@ -113,16 +125,14 @@ export async function updateMember(input) {
|
|
|
113
125
|
if (resolvedIcon !== undefined && !isValidIcon(resolvedIcon)) {
|
|
114
126
|
return `❌ Invalid icon "${input.icon}". Use a named alias (e.g., blue-circle, red-square, green-square) or a valid emoji.`;
|
|
115
127
|
}
|
|
116
|
-
// Resolve {{secure.NAME}} tokens in password field
|
|
128
|
+
// Resolve {{secret.NAME}} / legacy {{secure.NAME}} tokens in password field
|
|
117
129
|
let resolvedPassword = input.password;
|
|
130
|
+
let passwordLegacyNames = [];
|
|
118
131
|
if (resolvedPassword) {
|
|
119
|
-
const
|
|
120
|
-
let match;
|
|
132
|
+
const tokens = findSecretTokens(resolvedPassword);
|
|
121
133
|
let resolved = resolvedPassword;
|
|
122
|
-
const tokenNames = new Set();
|
|
123
|
-
|
|
124
|
-
tokenNames.add(match[1]);
|
|
125
|
-
}
|
|
134
|
+
const tokenNames = new Set(tokens.map((t) => t.name));
|
|
135
|
+
passwordLegacyNames = tokens.filter((t) => t.legacy).map((t) => t.name);
|
|
126
136
|
for (const name of tokenNames) {
|
|
127
137
|
const entry = credentialResolve(name, existing.friendlyName);
|
|
128
138
|
if (!entry)
|
|
@@ -131,9 +141,13 @@ export async function updateMember(input) {
|
|
|
131
141
|
return `❌ ${entry.denied} Member was NOT updated.`;
|
|
132
142
|
if ('expired' in entry)
|
|
133
143
|
return `❌ ${entry.expired} Member was NOT updated.`;
|
|
134
|
-
resolved = resolved.replaceAll(`{{
|
|
144
|
+
resolved = resolved.replaceAll(`{{secret.${name}}}`, entry.plaintext);
|
|
145
|
+
resolved = resolved.replaceAll(`{{secure.${name}}}`, entry.plaintext); // legacy spelling
|
|
135
146
|
}
|
|
136
147
|
resolvedPassword = resolved;
|
|
148
|
+
if (passwordLegacyNames.length > 0) {
|
|
149
|
+
logWarn('update_member', legacyTokenWarning(passwordLegacyNames), { id: existing.id, friendlyName: existing.friendlyName });
|
|
150
|
+
}
|
|
137
151
|
}
|
|
138
152
|
// Out-of-band password collection:
|
|
139
153
|
// - switchingToPassword: changing from key → password auth without inline password
|
|
@@ -149,6 +163,8 @@ export async function updateMember(input) {
|
|
|
149
163
|
}
|
|
150
164
|
const updates = {};
|
|
151
165
|
const warnings = [];
|
|
166
|
+
if (passwordLegacyNames.length > 0)
|
|
167
|
+
warnings.push(legacyTokenWarning(passwordLegacyNames));
|
|
152
168
|
// --- model_tiers normalization ---
|
|
153
169
|
if (input.model_tiers !== undefined) {
|
|
154
170
|
const values = Object.values(input.model_tiers).filter(Boolean);
|
|
@@ -195,6 +211,12 @@ export async function updateMember(input) {
|
|
|
195
211
|
updates.unreservable = input.unreservable;
|
|
196
212
|
if (input.shell !== undefined)
|
|
197
213
|
updates.shell = input.shell;
|
|
214
|
+
// Explicit operator override -- never auto-detected (that only happens in
|
|
215
|
+
// register_member). 'none' clears vcsProvider, matching how register_member
|
|
216
|
+
// records it (Agent.vcsProvider has no 'none' member -- see src/types.ts).
|
|
217
|
+
if (input.vcs_provider !== undefined) {
|
|
218
|
+
updates.vcsProvider = input.vcs_provider === 'none' ? undefined : input.vcs_provider;
|
|
219
|
+
}
|
|
198
220
|
if (input.model_cheap !== undefined)
|
|
199
221
|
updates.modelCheap = input.model_cheap;
|
|
200
222
|
if (input.model_standard !== undefined)
|
|
@@ -246,6 +268,19 @@ export async function updateMember(input) {
|
|
|
246
268
|
warnings.push(`Warning: cloud fields (${passedCloudFields.join(', ')}) are ignored for non-cloud members.`);
|
|
247
269
|
}
|
|
248
270
|
}
|
|
271
|
+
// Switching a member TO agy: create (or re-verify) its own agy project
|
|
272
|
+
// before recording the switch, so an agy member always has a bindable
|
|
273
|
+
// --project id. Evaluated on the resulting member (new host/folder/shell).
|
|
274
|
+
if (input.llm_provider === 'agy' && (existing.llmProvider ?? 'claude') !== 'agy') {
|
|
275
|
+
const preview = { ...existing, ...updates };
|
|
276
|
+
try {
|
|
277
|
+
const ensured = await ensureAgyProject(preview, { persist: false });
|
|
278
|
+
updates.agyProjectId = ensured.projectId;
|
|
279
|
+
}
|
|
280
|
+
catch (e) {
|
|
281
|
+
return `ERROR: could not create the agy project for "${existing.friendlyName}": ${e?.message ?? String(e)}\nMember was NOT updated.`;
|
|
282
|
+
}
|
|
283
|
+
}
|
|
249
284
|
const updated = updateInRegistry(existing.id, updates);
|
|
250
285
|
if (!updated) {
|
|
251
286
|
return `Failed to update member "${existing.id}".`;
|
|
@@ -288,6 +323,126 @@ export async function updateMember(input) {
|
|
|
288
323
|
// Local members have no connectivity concept -- always attempt (best-effort/non-fatal).
|
|
289
324
|
await seedWorkspaceTrust(updated, undefined, 'update_member');
|
|
290
325
|
}
|
|
326
|
+
// Provider switch OR work-folder move: remove exactly what
|
|
327
|
+
// compose_permissions wrote for the member as it was BEFORE this update (old
|
|
328
|
+
// provider, old folder/host -- its permission files, its per-folder
|
|
329
|
+
// apra-fleet MCP entry and the exclude lines), then re-compose for the
|
|
330
|
+
// member as it is now, so the new folder gets its ?member= entry at once
|
|
331
|
+
// (until then a session there would see the FULL user-scope entry) and the
|
|
332
|
+
// old folder is left with no stale member entry. Skipped entirely when
|
|
333
|
+
// neither the provider nor the work folder changed.
|
|
334
|
+
const oldProvider = existing.llmProvider ?? 'claude';
|
|
335
|
+
const newProvider = updated.llmProvider ?? 'claude';
|
|
336
|
+
const providerChanged = oldProvider !== newProvider;
|
|
337
|
+
const workFolderMoved = updated.workFolder !== existing.workFolder;
|
|
338
|
+
if (providerChanged || workFolderMoved) {
|
|
339
|
+
const why = providerChanged
|
|
340
|
+
? `Provider switch ${oldProvider} -> ${newProvider}`
|
|
341
|
+
: `Work folder move ${existing.workFolder} -> ${updated.workFolder}`;
|
|
342
|
+
const oldWhat = providerChanged ? `the old ${oldProvider} config` : `the config in the old work folder`;
|
|
343
|
+
try {
|
|
344
|
+
const removed = await removeComposedMemberConfig(existing);
|
|
345
|
+
logLine('update_member', `${why}: removed old config (${removed.join('; ') || 'nothing to remove'})`, updated);
|
|
346
|
+
}
|
|
347
|
+
catch (e) {
|
|
348
|
+
warnings.push(`${why}: could not remove ${oldWhat}: ${e?.message ?? String(e)}`);
|
|
349
|
+
}
|
|
350
|
+
let composeResult;
|
|
351
|
+
try {
|
|
352
|
+
composeResult = await composePermissions({ member_id: updated.id, role: 'doer', tags: updated.tags });
|
|
353
|
+
}
|
|
354
|
+
catch (e) {
|
|
355
|
+
composeResult = `compose_permissions threw: ${e?.message ?? String(e)}`;
|
|
356
|
+
}
|
|
357
|
+
if (!composeResult.startsWith('\u2705')) {
|
|
358
|
+
const asciiDetail = composeResult.replace(/^[^\x00-\x7F]+\s*/, '');
|
|
359
|
+
warnings.push(providerChanged
|
|
360
|
+
? `ERROR: provider switched to ${newProvider} but compose_permissions failed -- the member has no ${newProvider} permission/MCP config: ${asciiDetail}`
|
|
361
|
+
: `ERROR: work folder moved to ${updated.workFolder} but compose_permissions failed -- the new folder has no member permission/MCP config: ${asciiDetail}`);
|
|
362
|
+
}
|
|
363
|
+
}
|
|
364
|
+
// fleetMcp: a provider change re-runs the member install with --llm <new
|
|
365
|
+
// provider>; a name or work-folder change re-runs `register-member --id` on
|
|
366
|
+
// the member's own install. Best-effort: the update itself already succeeded
|
|
367
|
+
// and the outcome is a recorded, recoverable status (apra-fleet-b4g.56).
|
|
368
|
+
const nameChanged = updated.friendlyName !== existing.friendlyName;
|
|
369
|
+
let fleetMcpLine;
|
|
370
|
+
// "replace-full" is "auto" plus the opt-in full-install replacement.
|
|
371
|
+
const fleetInstallAuto = input.fleet_install === 'auto' || input.fleet_install === 'replace-full';
|
|
372
|
+
if (providerChanged || nameChanged || workFolderMoved || fleetInstallAuto) {
|
|
373
|
+
try {
|
|
374
|
+
// 'skip' disables the install; 'auto' installs a remote member (upgrading
|
|
375
|
+
// only when missing/older); omitted keeps the provider-change-only default.
|
|
376
|
+
const install = input.fleet_install === 'skip'
|
|
377
|
+
? false
|
|
378
|
+
: (providerChanged || fleetInstallAuto) && updated.agentType !== 'local';
|
|
379
|
+
const status = await refreshMemberFleetMcp(updated, getMemberFleetMcpDeps(), {
|
|
380
|
+
install,
|
|
381
|
+
forceInstall: providerChanged && input.fleet_install !== 'skip',
|
|
382
|
+
// An install also (re)writes the per-folder MCP entry before it is
|
|
383
|
+
// checked, so one fleet_install:"auto" call ends at fleetMcp=available.
|
|
384
|
+
writeMcpEntry: install,
|
|
385
|
+
replaceFull: install && input.fleet_install === 'replace-full',
|
|
386
|
+
});
|
|
387
|
+
fleetMcpLine = status.state === 'available'
|
|
388
|
+
? `available${status.version ? ` (apra-fleet ${status.version})` : ''}${(status.installFailure || status.replacedFullInstall) && status.detail ? ` -- ${status.installFailure ? 'warning: ' : ''}${status.detail}` : ''}`
|
|
389
|
+
: `unavailable (${status.reason ?? 'unknown'})${status.detail ? ` -- ${status.detail}` : ''}`;
|
|
390
|
+
fleetMcpLine += beadsStatusNote(status);
|
|
391
|
+
// A requested install that did not happen never fails the update: it is
|
|
392
|
+
// a prominent WARNING with the consequence, reason and manual steps.
|
|
393
|
+
const installWarning = fleetInstallWarning(updated.friendlyName, status);
|
|
394
|
+
if (installWarning) {
|
|
395
|
+
fleetMcpLine += installWarning.startsWith('NOTICE') ? ' (see NOTICE below)' : ' (see WARNING below)';
|
|
396
|
+
warnings.unshift(installWarning);
|
|
397
|
+
}
|
|
398
|
+
// A fresh install/upgrade/replace -- or an install that only now became
|
|
399
|
+
// usable (e.g. a failed autostart fixed by `apra-fleet start`) -- can
|
|
400
|
+
// serve member tools a claude member's allow list does not grant yet
|
|
401
|
+
// (opencode keeps no client-side tool list; agy/codex/copilot get no
|
|
402
|
+
// member install here). Grant mode ADDS the member tool rules to the
|
|
403
|
+
// existing allow list, so the member's role and reactive grants are kept.
|
|
404
|
+
// Skipped when the provider or folder block above already composed.
|
|
405
|
+
// Also runs whenever the install is available, not only on a recorded
|
|
406
|
+
// transition: a member_detail refresh between `apra-fleet start` and
|
|
407
|
+
// this update already recorded available. The grant is skipped (no
|
|
408
|
+
// NOTICE, no file rewrite) when the allow list already has every rule.
|
|
409
|
+
const mayNeedMemberRules = status.fleetInstalledAt !== existing.fleetMcp?.fleetInstalledAt
|
|
410
|
+
|| !!status.replacedFullInstall
|
|
411
|
+
|| status.state === 'available';
|
|
412
|
+
if (install && mayNeedMemberRules && !providerChanged && !workFolderMoved && (updated.llmProvider ?? 'claude') === 'claude'
|
|
413
|
+
&& (await missingClaudeAllowRules(updated, memberMcpAllowRules())).length > 0) {
|
|
414
|
+
let recompose;
|
|
415
|
+
try {
|
|
416
|
+
recompose = await composePermissions({ member_id: updated.id, role: 'doer', tags: updated.tags, grant: memberMcpAllowRules() });
|
|
417
|
+
}
|
|
418
|
+
catch (e) {
|
|
419
|
+
recompose = `compose_permissions threw: ${e?.message ?? String(e)}`;
|
|
420
|
+
}
|
|
421
|
+
if (!recompose.startsWith('\u2705')) {
|
|
422
|
+
const asciiDetail = recompose.replace(/^[^\x00-\x7F]+\s*/, '');
|
|
423
|
+
warnings.push(`WARNING: apra-fleet was installed/upgraded on the member but compose_permissions failed -- its permission allow-list was not refreshed, so its LLM may refuse fleet tools the new install serves. Retry with compose_permissions {member_id, role}: ${asciiDetail}`);
|
|
424
|
+
}
|
|
425
|
+
else {
|
|
426
|
+
warnings.push('NOTICE: the member apra-fleet tool rules were added to its permission allow-list (existing rules and grants kept).');
|
|
427
|
+
}
|
|
428
|
+
}
|
|
429
|
+
}
|
|
430
|
+
catch (e) {
|
|
431
|
+
fleetMcpLine = `unavailable (probe-failed) -- ${e?.message ?? String(e)}`;
|
|
432
|
+
}
|
|
433
|
+
}
|
|
434
|
+
// Re-check project-level agent files that would shadow the managed role set
|
|
435
|
+
// (the work folder or provider may have changed). The dispatch-time cache is
|
|
436
|
+
// always invalidated; the check itself runs only when the member is reachable
|
|
437
|
+
// (local members always). Never throws.
|
|
438
|
+
invalidateProjectAgentShadowCache(updated.id);
|
|
439
|
+
const shadowReachable = updated.agentType !== 'remote' || agentProvisionResult !== undefined
|
|
440
|
+
|| remoteAgentsDir(updated.llmProvider ?? 'claude') === null;
|
|
441
|
+
if (shadowReachable) {
|
|
442
|
+
const shadowWarning = await recheckProjectAgentShadows(updated);
|
|
443
|
+
if (shadowWarning)
|
|
444
|
+
warnings.push(shadowWarning);
|
|
445
|
+
}
|
|
291
446
|
let result = `✅ Member "${updated.friendlyName}" updated.\n\n`;
|
|
292
447
|
result += ` Icon: ${updated.icon ?? DEFAULT_ICON}\n`;
|
|
293
448
|
result += ` ID: ${updated.id}\n`;
|
|
@@ -301,6 +456,12 @@ export async function updateMember(input) {
|
|
|
301
456
|
result += ` Auth: ${updated.authType}\n`;
|
|
302
457
|
}
|
|
303
458
|
result += ` Provider: ${updated.llmProvider ?? 'claude'}\n`;
|
|
459
|
+
if (updated.llmProvider === 'agy' && updated.agyProjectId) {
|
|
460
|
+
result += ` AGY project: ${updated.agyProjectId}\n`;
|
|
461
|
+
}
|
|
462
|
+
if (input.vcs_provider !== undefined) {
|
|
463
|
+
result += ` VCS Provider: ${updated.vcsProvider ?? 'none'}\n`;
|
|
464
|
+
}
|
|
304
465
|
if (updated.modelCheap)
|
|
305
466
|
result += ` Model Cheap: ${updated.modelCheap}\n`;
|
|
306
467
|
if (updated.modelStandard)
|
|
@@ -322,6 +483,8 @@ export async function updateMember(input) {
|
|
|
322
483
|
const mt = updated.modelTiers;
|
|
323
484
|
result += ` Model Tiers: cheap=${mt.cheap ?? '-'} standard=${mt.standard ?? '-'} premium=${mt.premium ?? '-'}\n`;
|
|
324
485
|
}
|
|
486
|
+
if (fleetMcpLine)
|
|
487
|
+
result += ` fleetMcp: ${fleetMcpLine}\n`;
|
|
325
488
|
if (warnings.length > 0) {
|
|
326
489
|
result += '\n';
|
|
327
490
|
for (const w of warnings) {
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
/**
|
|
3
|
+
* Server-side VCS credential handoff (apra-fleet-3swo.7.3).
|
|
4
|
+
*
|
|
5
|
+
* BEFORE: the only way an orchestrator-side caller could run a
|
|
6
|
+
* credential-requiring git/VCS command was to first LEARN the token --
|
|
7
|
+
* fleet-sprint's readMemberVcsCredentialToken dispatches the deployed
|
|
8
|
+
* git-credential-helper as a member command and parses `password=<token>` out
|
|
9
|
+
* of the captured stdout. Even dispatched with silent:true, the plaintext
|
|
10
|
+
* still round-trips through a command result the orchestrator reads.
|
|
11
|
+
*
|
|
12
|
+
* NOW: the caller sends the command it already builds (VCSModule's
|
|
13
|
+
* buildCreatePrCommand and friends) with a literal placeholder where the
|
|
14
|
+
* token belongs -- `{{vcs_token}}` for a bare reference or
|
|
15
|
+
* `{{vcs_token_inline}}` for one sitting inside the caller's own single
|
|
16
|
+
* quotes (apra-fleet-3swo.7.16; see VCS_TOKEN_INLINE_PLACEHOLDER below) --
|
|
17
|
+
* and the SERVER performs the whole handoff inside this one call:
|
|
18
|
+
*
|
|
19
|
+
* 1. runs the member's deployed credential helper through
|
|
20
|
+
* strategy.execCommand -- that output is consumed in-process and is
|
|
21
|
+
* NEVER part of this tool's result;
|
|
22
|
+
* 2. substitutes whichever placeholder(s) are present with the token,
|
|
23
|
+
* escaped for the member's OWN shell (the same isPosixShell branch
|
|
24
|
+
* execute_command uses for {{secret.NAME}}) -- `{{vcs_token}}` gets the
|
|
25
|
+
* fully-quoted form, `{{vcs_token_inline}}` gets the bare interior
|
|
26
|
+
* escaping with no quotes of its own;
|
|
27
|
+
* 3. dispatches the substituted command;
|
|
28
|
+
* 4. redacts any occurrence of the token from stdout/stderr before
|
|
29
|
+
* returning, the same defence execute-command.ts's redactOutput applies.
|
|
30
|
+
*
|
|
31
|
+
* The plaintext token therefore appears in no field of any result an
|
|
32
|
+
* orchestrator-side caller can read. readMemberVcsCredentialToken is
|
|
33
|
+
* deliberately left in place; retiring it is a separate task.
|
|
34
|
+
*/
|
|
35
|
+
/**
|
|
36
|
+
* Reference this one BARE (never inside your own quotes): the substituted
|
|
37
|
+
* value arrives ALREADY shell-escaped for the member's shell (quotes
|
|
38
|
+
* included), exactly like execute_command's {{secret.NAME}} tokens --
|
|
39
|
+
* wrapping it in the caller's own quotes double-escapes it and surfaces as a
|
|
40
|
+
* false 401 / invalid-token error.
|
|
41
|
+
*/
|
|
42
|
+
export declare const VCS_TOKEN_PLACEHOLDER = "{{vcs_token}}";
|
|
43
|
+
/**
|
|
44
|
+
* Reference this one INSIDE your own single quotes (e.g.
|
|
45
|
+
* `'Authorization: Bearer {{vcs_token_inline}}'`): the substituted value is
|
|
46
|
+
* escaped for the INTERIOR of a single-quoted string in the member's shell
|
|
47
|
+
* dialect and carries no quotes of its own, for callers (like VCSModule's
|
|
48
|
+
* provider command builders) that must interpolate the token into a larger
|
|
49
|
+
* already-quoted value rather than reference it as a free-standing word.
|
|
50
|
+
* Using `{{vcs_token}}` in that position double-escapes it the same way
|
|
51
|
+
* wrapping it in extra quotes would; use this placeholder there instead.
|
|
52
|
+
*
|
|
53
|
+
* Whether a given occurrence really sits inside the caller's open quotes is
|
|
54
|
+
* not reliably decidable from the command string alone, so this tool does
|
|
55
|
+
* not attempt to validate placement -- a heuristic here would produce false
|
|
56
|
+
* refusals. The contract is documented, not enforced (apra-fleet-3swo.7.16).
|
|
57
|
+
*/
|
|
58
|
+
export declare const VCS_TOKEN_INLINE_PLACEHOLDER = "{{vcs_token_inline}}";
|
|
59
|
+
export declare const vcsCredentialExecSchema: z.ZodObject<{
|
|
60
|
+
command: z.ZodString;
|
|
61
|
+
label: z.ZodOptional<z.ZodString>;
|
|
62
|
+
timeout_s: z.ZodOptional<z.ZodNumber>;
|
|
63
|
+
member_id: z.ZodOptional<z.ZodString>;
|
|
64
|
+
member_name: z.ZodOptional<z.ZodString>;
|
|
65
|
+
}, "strip", z.ZodTypeAny, {
|
|
66
|
+
command: string;
|
|
67
|
+
member_id?: string | undefined;
|
|
68
|
+
member_name?: string | undefined;
|
|
69
|
+
label?: string | undefined;
|
|
70
|
+
timeout_s?: number | undefined;
|
|
71
|
+
}, {
|
|
72
|
+
command: string;
|
|
73
|
+
member_id?: string | undefined;
|
|
74
|
+
member_name?: string | undefined;
|
|
75
|
+
label?: string | undefined;
|
|
76
|
+
timeout_s?: number | undefined;
|
|
77
|
+
}>;
|
|
78
|
+
export type VcsCredentialExecInput = z.infer<typeof vcsCredentialExecSchema>;
|
|
79
|
+
export type VcsCredentialExecReason =
|
|
80
|
+
/** The command ran (inspect exitCode for its own success). */
|
|
81
|
+
'ok'
|
|
82
|
+
/** No member matched member_id/member_name. */
|
|
83
|
+
| 'member_not_found'
|
|
84
|
+
/** `command` contained neither {{vcs_token}} nor {{vcs_token_inline}}. */
|
|
85
|
+
| 'placeholder_missing'
|
|
86
|
+
/** This member's OS/shell has no credential-read implementation. */
|
|
87
|
+
| 'unsupported_member_os'
|
|
88
|
+
/** Running the credential helper on the member failed. */
|
|
89
|
+
| 'credential_read_failed'
|
|
90
|
+
/** The helper ran but printed no usable password= line. */
|
|
91
|
+
| 'credential_empty'
|
|
92
|
+
/** Dispatching the credential-requiring command threw. */
|
|
93
|
+
| 'dispatch_failed';
|
|
94
|
+
interface VcsCredentialExecFields {
|
|
95
|
+
/** True when the credential-requiring command was dispatched. Read exitCode for its outcome. */
|
|
96
|
+
ok: boolean;
|
|
97
|
+
/** Machine-readable outcome code. Branch on this, never on `text`. */
|
|
98
|
+
reason: VcsCredentialExecReason;
|
|
99
|
+
/** Exit code of the dispatched command, or null when it never ran. */
|
|
100
|
+
exitCode: number | null;
|
|
101
|
+
/** Command stdout with every occurrence of the credential redacted. */
|
|
102
|
+
stdout: string;
|
|
103
|
+
/** Command stderr with every occurrence of the credential redacted. */
|
|
104
|
+
stderr: string;
|
|
105
|
+
/**
|
|
106
|
+
* How many times the credential had to be redacted out of stdout+stderr.
|
|
107
|
+
* Normally 0; a nonzero count means the dispatched command echoed its own
|
|
108
|
+
* credential back and the redaction earned its keep.
|
|
109
|
+
*/
|
|
110
|
+
tokenRedactions: number;
|
|
111
|
+
/** Credential label used, or null for the unlabelled helper. */
|
|
112
|
+
credentialLabel: string | null;
|
|
113
|
+
/** Registry id of the resolved member, or null. */
|
|
114
|
+
memberId: string | null;
|
|
115
|
+
/** Friendly name of the resolved member, or null. */
|
|
116
|
+
memberName: string | null;
|
|
117
|
+
}
|
|
118
|
+
export interface VcsCredentialExecStructured extends VcsCredentialExecFields {
|
|
119
|
+
[key: string]: unknown;
|
|
120
|
+
}
|
|
121
|
+
export interface VcsCredentialExecResult {
|
|
122
|
+
text: string;
|
|
123
|
+
structuredContent: VcsCredentialExecStructured;
|
|
124
|
+
}
|
|
125
|
+
export declare function vcsCredentialExec(input: VcsCredentialExecInput): Promise<VcsCredentialExecResult>;
|
|
126
|
+
export {};
|
|
127
|
+
//# sourceMappingURL=vcs-credential-exec.d.ts.map
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { getStrategy } from '../services/strategy.js';
|
|
3
|
+
import { getOsCommands } from '../os/index.js';
|
|
4
|
+
import { getAgentOS, getAgentShell, isPosixShell } from '../utils/agent-helpers.js';
|
|
5
|
+
import { memberIdentifier, resolveMember } from '../utils/resolve-member.js';
|
|
6
|
+
import { escapeShellArg, escapePowerShellArg, escapeShellArgInner, escapePowerShellArgInner } from '../utils/shell-escape.js';
|
|
7
|
+
import { logLine } from '../utils/log-helpers.js';
|
|
8
|
+
/**
|
|
9
|
+
* Server-side VCS credential handoff (apra-fleet-3swo.7.3).
|
|
10
|
+
*
|
|
11
|
+
* BEFORE: the only way an orchestrator-side caller could run a
|
|
12
|
+
* credential-requiring git/VCS command was to first LEARN the token --
|
|
13
|
+
* fleet-sprint's readMemberVcsCredentialToken dispatches the deployed
|
|
14
|
+
* git-credential-helper as a member command and parses `password=<token>` out
|
|
15
|
+
* of the captured stdout. Even dispatched with silent:true, the plaintext
|
|
16
|
+
* still round-trips through a command result the orchestrator reads.
|
|
17
|
+
*
|
|
18
|
+
* NOW: the caller sends the command it already builds (VCSModule's
|
|
19
|
+
* buildCreatePrCommand and friends) with a literal placeholder where the
|
|
20
|
+
* token belongs -- `{{vcs_token}}` for a bare reference or
|
|
21
|
+
* `{{vcs_token_inline}}` for one sitting inside the caller's own single
|
|
22
|
+
* quotes (apra-fleet-3swo.7.16; see VCS_TOKEN_INLINE_PLACEHOLDER below) --
|
|
23
|
+
* and the SERVER performs the whole handoff inside this one call:
|
|
24
|
+
*
|
|
25
|
+
* 1. runs the member's deployed credential helper through
|
|
26
|
+
* strategy.execCommand -- that output is consumed in-process and is
|
|
27
|
+
* NEVER part of this tool's result;
|
|
28
|
+
* 2. substitutes whichever placeholder(s) are present with the token,
|
|
29
|
+
* escaped for the member's OWN shell (the same isPosixShell branch
|
|
30
|
+
* execute_command uses for {{secret.NAME}}) -- `{{vcs_token}}` gets the
|
|
31
|
+
* fully-quoted form, `{{vcs_token_inline}}` gets the bare interior
|
|
32
|
+
* escaping with no quotes of its own;
|
|
33
|
+
* 3. dispatches the substituted command;
|
|
34
|
+
* 4. redacts any occurrence of the token from stdout/stderr before
|
|
35
|
+
* returning, the same defence execute-command.ts's redactOutput applies.
|
|
36
|
+
*
|
|
37
|
+
* The plaintext token therefore appears in no field of any result an
|
|
38
|
+
* orchestrator-side caller can read. readMemberVcsCredentialToken is
|
|
39
|
+
* deliberately left in place; retiring it is a separate task.
|
|
40
|
+
*/
|
|
41
|
+
/**
|
|
42
|
+
* Reference this one BARE (never inside your own quotes): the substituted
|
|
43
|
+
* value arrives ALREADY shell-escaped for the member's shell (quotes
|
|
44
|
+
* included), exactly like execute_command's {{secret.NAME}} tokens --
|
|
45
|
+
* wrapping it in the caller's own quotes double-escapes it and surfaces as a
|
|
46
|
+
* false 401 / invalid-token error.
|
|
47
|
+
*/
|
|
48
|
+
export const VCS_TOKEN_PLACEHOLDER = '{{vcs_token}}';
|
|
49
|
+
/**
|
|
50
|
+
* Reference this one INSIDE your own single quotes (e.g.
|
|
51
|
+
* `'Authorization: Bearer {{vcs_token_inline}}'`): the substituted value is
|
|
52
|
+
* escaped for the INTERIOR of a single-quoted string in the member's shell
|
|
53
|
+
* dialect and carries no quotes of its own, for callers (like VCSModule's
|
|
54
|
+
* provider command builders) that must interpolate the token into a larger
|
|
55
|
+
* already-quoted value rather than reference it as a free-standing word.
|
|
56
|
+
* Using `{{vcs_token}}` in that position double-escapes it the same way
|
|
57
|
+
* wrapping it in extra quotes would; use this placeholder there instead.
|
|
58
|
+
*
|
|
59
|
+
* Whether a given occurrence really sits inside the caller's open quotes is
|
|
60
|
+
* not reliably decidable from the command string alone, so this tool does
|
|
61
|
+
* not attempt to validate placement -- a heuristic here would produce false
|
|
62
|
+
* refusals. The contract is documented, not enforced (apra-fleet-3swo.7.16).
|
|
63
|
+
*/
|
|
64
|
+
export const VCS_TOKEN_INLINE_PLACEHOLDER = '{{vcs_token_inline}}';
|
|
65
|
+
export const vcsCredentialExecSchema = z.object({
|
|
66
|
+
...memberIdentifier,
|
|
67
|
+
command: z.string().min(1).describe('The credential-requiring command to run on the member. MUST contain at least one of two '
|
|
68
|
+
+ 'placeholders where the credential belongs: {{vcs_token}}, referenced BARE (never inside your '
|
|
69
|
+
+ 'own quotes) -- the server substitutes it with the value already escaped AND quoted for the '
|
|
70
|
+
+ 'member\'s shell; or {{vcs_token_inline}}, referenced INSIDE your own single quotes -- the '
|
|
71
|
+
+ 'server substitutes it with the value escaped for the interior of a single-quoted string, with '
|
|
72
|
+
+ 'no quotes of its own (use this one when the token must be interpolated into a larger quoted '
|
|
73
|
+
+ 'value, e.g. an Authorization header). Both may appear in the same command. '
|
|
74
|
+
+ 'The plaintext credential never leaves the server and never appears in this tool\'s result.'),
|
|
75
|
+
label: z.string().regex(/^[a-zA-Z0-9._-]{1,64}$/).optional().describe('Credential label the helper was deployed under by provision_vcs_auth (defaults to the '
|
|
76
|
+
+ 'provider name there, e.g. "github" or "azure-devops"). Omit to use the unlabelled helper.'),
|
|
77
|
+
timeout_s: z.number().int().positive().max(600).optional().describe('Inactivity timeout in seconds for the credential-requiring command (default: 120). '
|
|
78
|
+
+ 'On expiry the command\'s remote process tree is killed and the result is reason dispatch_failed '
|
|
79
|
+
+ 'with a "Command timed out" message.'),
|
|
80
|
+
});
|
|
81
|
+
const REDACTION = '[REDACTED:vcs_token]';
|
|
82
|
+
function execResult(text, fields) {
|
|
83
|
+
return {
|
|
84
|
+
text,
|
|
85
|
+
structuredContent: {
|
|
86
|
+
ok: fields.ok ?? fields.reason === 'ok',
|
|
87
|
+
reason: fields.reason,
|
|
88
|
+
exitCode: fields.exitCode ?? null,
|
|
89
|
+
stdout: fields.stdout ?? '',
|
|
90
|
+
stderr: fields.stderr ?? '',
|
|
91
|
+
tokenRedactions: fields.tokenRedactions ?? 0,
|
|
92
|
+
credentialLabel: fields.credentialLabel ?? null,
|
|
93
|
+
memberId: fields.memberId ?? null,
|
|
94
|
+
memberName: fields.memberName ?? null,
|
|
95
|
+
},
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
/** Replace every occurrence of `secret` in `output`, and report how many. */
|
|
99
|
+
function redactToken(output, secret) {
|
|
100
|
+
if (!secret)
|
|
101
|
+
return { text: output, count: 0 };
|
|
102
|
+
const parts = output.split(secret);
|
|
103
|
+
return { text: parts.join(REDACTION), count: parts.length - 1 };
|
|
104
|
+
}
|
|
105
|
+
export async function vcsCredentialExec(input) {
|
|
106
|
+
const agentOrError = resolveMember(input.member_id, input.member_name);
|
|
107
|
+
if (typeof agentOrError === 'string') {
|
|
108
|
+
return execResult(agentOrError, {
|
|
109
|
+
reason: 'member_not_found',
|
|
110
|
+
memberId: input.member_id ?? null,
|
|
111
|
+
memberName: input.member_name ?? null,
|
|
112
|
+
});
|
|
113
|
+
}
|
|
114
|
+
const agent = agentOrError;
|
|
115
|
+
const who = { memberId: agent.id, memberName: agent.friendlyName, credentialLabel: input.label ?? null };
|
|
116
|
+
// Refusing a command with neither placeholder is what keeps this tool a
|
|
117
|
+
// credential handoff rather than a second, unguarded execute_command.
|
|
118
|
+
const hasBare = input.command.includes(VCS_TOKEN_PLACEHOLDER);
|
|
119
|
+
const hasInline = input.command.includes(VCS_TOKEN_INLINE_PLACEHOLDER);
|
|
120
|
+
if (!hasBare && !hasInline) {
|
|
121
|
+
return execResult(`[FAIL] command must contain ${VCS_TOKEN_PLACEHOLDER} or ${VCS_TOKEN_INLINE_PLACEHOLDER} -- use execute_command for a command that needs no credential.`, { ...who, reason: 'placeholder_missing' });
|
|
122
|
+
}
|
|
123
|
+
const agentOs = getAgentOS(agent);
|
|
124
|
+
const agentShell = getAgentShell(agent);
|
|
125
|
+
const cmds = getOsCommands(agentOs, agentShell);
|
|
126
|
+
const strategy = getStrategy(agent);
|
|
127
|
+
// A member OS/shell with no credential-read implementation is a HARD
|
|
128
|
+
// failure with a surfaced error, never an advisory warning that lets the
|
|
129
|
+
// caller proceed credential-less.
|
|
130
|
+
let read;
|
|
131
|
+
try {
|
|
132
|
+
read = cmds.gitCredentialHelperRead(input.label);
|
|
133
|
+
}
|
|
134
|
+
catch (err) {
|
|
135
|
+
return execResult(`[FAIL] Cannot read a VCS credential on "${agent.friendlyName}" (os=${agentOs} shell=${agentShell ?? 'default'}): ${err.message}`, { ...who, reason: 'unsupported_member_os' });
|
|
136
|
+
}
|
|
137
|
+
// STEP 1 -- read the credential SERVER-SIDE. This result is consumed
|
|
138
|
+
// in-process and is never placed in the payload returned below.
|
|
139
|
+
let token = '';
|
|
140
|
+
try {
|
|
141
|
+
const readRes = await strategy.execCommand(read.command, 15000);
|
|
142
|
+
if (readRes.code !== 0) {
|
|
143
|
+
return execResult(`[FAIL] Failed to read the VCS credential for "${agent.friendlyName}" from '${read.path}' (exit ${readRes.code}).`, { ...who, reason: 'credential_read_failed', exitCode: readRes.code });
|
|
144
|
+
}
|
|
145
|
+
const m = /^password=(.*)$/m.exec(readRes.stdout || '');
|
|
146
|
+
token = m ? m[1].trim() : '';
|
|
147
|
+
}
|
|
148
|
+
catch (err) {
|
|
149
|
+
return execResult(`[FAIL] Failed to read the VCS credential for "${agent.friendlyName}" from '${read.path}': ${err.message}`, { ...who, reason: 'credential_read_failed' });
|
|
150
|
+
}
|
|
151
|
+
if (!token) {
|
|
152
|
+
return execResult(`[FAIL] The VCS credential for "${agent.friendlyName}" was empty or unreadable (expected a 'password=' line from '${read.path}'). Re-run provision_vcs_auth.`, { ...who, reason: 'credential_empty' });
|
|
153
|
+
}
|
|
154
|
+
// STEP 2 -- substitute, escaped for the member's OWN shell. A Windows
|
|
155
|
+
// member registered with shell=gitbash runs bash, so it needs POSIX
|
|
156
|
+
// escaping even though its OS is windows; isPosixShell owns that decision
|
|
157
|
+
// for every consumer. The bare placeholder gets the fully-quoted form; the
|
|
158
|
+
// inline placeholder gets the SAME dialect's interior-only escaping, with
|
|
159
|
+
// no wrapping quotes of its own, so it composes inside the caller's
|
|
160
|
+
// already-open single quotes instead of double-escaping.
|
|
161
|
+
const posix = isPosixShell(agentOs, agentShell);
|
|
162
|
+
const escaped = posix ? escapeShellArg(token) : escapePowerShellArg(token);
|
|
163
|
+
const escapedInline = posix ? escapeShellArgInner(token) : escapePowerShellArgInner(token);
|
|
164
|
+
const finalCommand = input.command
|
|
165
|
+
.replaceAll(VCS_TOKEN_PLACEHOLDER, escaped)
|
|
166
|
+
.replaceAll(VCS_TOKEN_INLINE_PLACEHOLDER, escapedInline);
|
|
167
|
+
// STEP 3 -- dispatch. Only the log-safe form (placeholder still in place) is
|
|
168
|
+
// ever logged; `finalCommand` is never written anywhere.
|
|
169
|
+
logLine('vcs_credential_exec', `label=${input.label ?? '(default)'} command=${input.command.slice(0, 120)}`, agent);
|
|
170
|
+
let code;
|
|
171
|
+
let stdout;
|
|
172
|
+
let stderr;
|
|
173
|
+
try {
|
|
174
|
+
// Run under the FLEET_PID wrapper, as execute_command does: on timeout,
|
|
175
|
+
// execCommand kills the remote process tree explicitly and the caller
|
|
176
|
+
// gets "Command timed out ..." (reason dispatch_failed) -- a git push or
|
|
177
|
+
// clone is never left running, or cut mid-operation, unreported.
|
|
178
|
+
const res = await strategy.execCommand(cmds.wrapPidCapture(finalCommand), (input.timeout_s ?? 120) * 1000);
|
|
179
|
+
code = res.code;
|
|
180
|
+
stdout = res.stdout ?? '';
|
|
181
|
+
stderr = res.stderr ?? '';
|
|
182
|
+
}
|
|
183
|
+
catch (err) {
|
|
184
|
+
// The thrown message can quote the command that failed, so it is redacted
|
|
185
|
+
// on the same footing as stdout/stderr.
|
|
186
|
+
const redactedErr = redactToken(String(err?.message ?? err), token);
|
|
187
|
+
return execResult(`[FAIL] Command dispatch failed on "${agent.friendlyName}": ${redactedErr.text}`, { ...who, reason: 'dispatch_failed', stderr: redactedErr.text, tokenRedactions: redactedErr.count });
|
|
188
|
+
}
|
|
189
|
+
// STEP 4 -- defence in depth: the command itself may echo the credential
|
|
190
|
+
// back (a curl -v, a git error quoting the remote URL), so scrub both
|
|
191
|
+
// streams before anything is returned.
|
|
192
|
+
const outRedacted = redactToken(stdout, token);
|
|
193
|
+
const errRedacted = redactToken(stderr, token);
|
|
194
|
+
return execResult(`[OK] Ran credential-requiring command on "${agent.friendlyName}" (exit ${code}).`, {
|
|
195
|
+
...who,
|
|
196
|
+
reason: 'ok',
|
|
197
|
+
exitCode: code,
|
|
198
|
+
stdout: outRedacted.text,
|
|
199
|
+
stderr: errRedacted.text,
|
|
200
|
+
tokenRedactions: outRedacted.count + errRedacted.count,
|
|
201
|
+
});
|
|
202
|
+
}
|
|
203
|
+
//# sourceMappingURL=vcs-credential-exec.js.map
|