@apralabs/apra-fleet 0.4.3 → 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 +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- 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/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 +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- 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 +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +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.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- 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 +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- 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-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- 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/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 +54 -8
- 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/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 +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- 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 +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- 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 +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- 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 +53 -5
- package/dist/tools/check-status.js +210 -53
- 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 +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- 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 +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -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 +30 -10
- 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 +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +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/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- 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/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 +3 -3
- 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 +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- 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 +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- 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 +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,338 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Supervisor seam -- orphaned ephemeral `dolt sql-server` sweep
|
|
3
|
+
// (docs/dolt-sync-redesign.md Part 3.3)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// settleDoltConflicts() (fleet-sprint/dolt-settle.mjs) spawns a genuinely
|
|
7
|
+
// DETACHED, short-lived `dolt sql-server` on a member and tears it down in a
|
|
8
|
+
// real `finally` -- kill the recorded pid, verify the port closed. That
|
|
9
|
+
// `finally` covers every throw path inside the orchestrator process.
|
|
10
|
+
//
|
|
11
|
+
// It cannot cover ONE case: the orchestrator process itself dying mid-settle
|
|
12
|
+
// (SIGKILL, machine crash, a supervisor restart while a detached sprint child
|
|
13
|
+
// was settling). The server survives -- that is the whole point of the
|
|
14
|
+
// detachment -- and then holds Dolt's per-directory exclusive lock on the
|
|
15
|
+
// member's beads data dir, wedging every subsequent embedded `bd` command on
|
|
16
|
+
// that member. That is exactly the apra-fleet-5mqg damage class.
|
|
17
|
+
//
|
|
18
|
+
// This sweep is the backstop for that one case, and NOTHING else. If settle's
|
|
19
|
+
// `finally` is correct, this sweep should never find anything -- finding
|
|
20
|
+
// something is itself a signal worth logging loudly. It only ever kills a
|
|
21
|
+
// process that is BOTH a `dolt sql-server` AND listening on a port inside
|
|
22
|
+
// settle's own ephemeral range AND older than a generous age threshold, so a
|
|
23
|
+
// settle actually in progress is never interrupted and an operator's own
|
|
24
|
+
// long-lived dolt server (on any other port) is never touched.
|
|
25
|
+
//
|
|
26
|
+
// ASCII only.
|
|
27
|
+
// =============================================================================
|
|
28
|
+
|
|
29
|
+
import { DEFAULT_PORT_RANGE } from '../../fleet-sprint/dolt-settle.mjs';
|
|
30
|
+
import { SeWindowsCommands } from '../../fleet-sprint/se-windows.mjs';
|
|
31
|
+
|
|
32
|
+
const seWindows = new SeWindowsCommands();
|
|
33
|
+
|
|
34
|
+
/** How often the sweep runs. Settles take seconds; this is a safety net. */
|
|
35
|
+
export const DEFAULT_SWEEP_INTERVAL_MS = 5 * 60 * 1000;
|
|
36
|
+
|
|
37
|
+
/** A server younger than this is assumed to belong to a settle in progress and
|
|
38
|
+
* is left alone. Settle's own bounded waits are far shorter than this. */
|
|
39
|
+
export const DEFAULT_MAX_AGE_MS = 10 * 60 * 1000;
|
|
40
|
+
|
|
41
|
+
/** Settle's ephemeral port range. Re-exported from dolt-settle.mjs's
|
|
42
|
+
* DEFAULT_PORT_RANGE -- never re-derive these bounds by hand, so the sweep
|
|
43
|
+
* can never drift out of sync with the range settle actually uses. Only a
|
|
44
|
+
* server bound inside this range can be settle residue. */
|
|
45
|
+
export const SETTLE_PORT_RANGE = DEFAULT_PORT_RANGE;
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* Owner scope (the cross-instance-kill fix). The probe/kill command below is
|
|
49
|
+
* otherwise a MACHINE-WIDE process scan bounded only by port range and process
|
|
50
|
+
* age -- so an isolated supervisor instance (e.g. the regression playbook's
|
|
51
|
+
* sandbox, whose HOME/FLEET_SE_DATA_DIR point inside the sandbox) could kill an
|
|
52
|
+
* aged ephemeral server belonging to a DIFFERENT, live supervisor on the same
|
|
53
|
+
* machine. Passing an owner data-dir prefix constrains candidates to processes
|
|
54
|
+
* whose `--data-dir` lives under that prefix.
|
|
55
|
+
*
|
|
56
|
+
* This is deliberately OPT-IN, wired at the deps level by bin/serve.mjs from
|
|
57
|
+
* FLEET_SE_SWEEP_OWNER_DATA_DIR: the ephemeral server's `--data-dir` is the
|
|
58
|
+
* MEMBER's beads data dir (dolt-settle.mjs's resolveDoltStatus reads it from
|
|
59
|
+
* `bd dolt status` on the member), which for a remote member has no relation to
|
|
60
|
+
* the sweeping supervisor's own data dir. Deriving the prefix from
|
|
61
|
+
* FLEET_SE_DATA_DIR unconditionally would therefore silently turn the sweep
|
|
62
|
+
* into a no-op for every remote member -- destroying the safety net to fix the
|
|
63
|
+
* isolation problem. An operator/test that KNOWS its members are confined to
|
|
64
|
+
* one root opts in; production keeps the machine-wide default.
|
|
65
|
+
*
|
|
66
|
+
* KNOWN LIMIT: resolveDoltStatus's `unknown` parse fallback yields the
|
|
67
|
+
* RELATIVE default data dir, so such a command line carries no absolute path
|
|
68
|
+
* and is excluded by ANY prefix. That direction is fail-safe (the sweep skips
|
|
69
|
+
* rather than kills a foreign process), but it means an owner-scoped sweep is
|
|
70
|
+
* inert for that fallback -- see scripts/reap-sandbox-dolt.mjs, which covers
|
|
71
|
+
* the same blind spot with a recency bound instead.
|
|
72
|
+
*/
|
|
73
|
+
export function normalizeOwnerDataDirPrefix(prefix) {
|
|
74
|
+
const text = String(prefix == null ? '' : prefix).trim();
|
|
75
|
+
return text ? text : null;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* apra-fleet-5co8.36: Node's `path.resolve()` does NOT understand MSYS-style
|
|
80
|
+
* POSIX paths (e.g. `/c/Users/x/temp` -- what Git Bash reports as `$HOME` on
|
|
81
|
+
* Windows). On win32 it treats a leading `/c/...` as a root-relative path on
|
|
82
|
+
* the CURRENT drive and prefixes it with that drive, producing a nonexistent
|
|
83
|
+
* path like `C:\c\Users\x\temp` rather than `C:\Users\x\temp`. Since
|
|
84
|
+
* `FLEET_SE_SWEEP_OWNER_DATA_DIR` is commonly set from `$HOME` under Git
|
|
85
|
+
* Bash (see regression-test-playbook.md's `## Setup`), that mangling made the
|
|
86
|
+
* owner-scoped sweep match no real `--data-dir` and silently degrade to
|
|
87
|
+
* matching nothing while still logging a confident scope claim.
|
|
88
|
+
*
|
|
89
|
+
* Call this BEFORE `path.resolve()` on a raw env value: it rewrites a
|
|
90
|
+
* `/<drive>/...` MSYS path to its native Windows form (`<DRIVE>:\...`) when
|
|
91
|
+
* `platform` is `'win32'`, and returns the input unchanged for any other
|
|
92
|
+
* platform or any value that does not look like an MSYS path (e.g. one
|
|
93
|
+
* that is already native, like `C:\Users\x` or `C:/Users/x`).
|
|
94
|
+
*
|
|
95
|
+
* @param {string} value
|
|
96
|
+
* @param {string} [platform] defaults to `process.platform` (win32 under
|
|
97
|
+
* Git Bash even though the invoking shell is POSIX-like -- Node's own
|
|
98
|
+
* platform, never the shell, decides this).
|
|
99
|
+
* @returns {string}
|
|
100
|
+
*/
|
|
101
|
+
export function normalizeMsysPathForPlatform(value, platform = process.platform) {
|
|
102
|
+
const text = String(value == null ? '' : value);
|
|
103
|
+
if (platform !== 'win32' || !text) return text;
|
|
104
|
+
const match = /^\/([a-zA-Z])\/(.*)$/.exec(text);
|
|
105
|
+
if (!match) return text;
|
|
106
|
+
const [, drive, rest] = match;
|
|
107
|
+
return `${drive.toUpperCase()}:\\${rest.replace(/\//g, '\\')}`;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/** Quote a value for embedding in a PowerShell single-quoted string literal.
|
|
111
|
+
* PowerShell also treats U+2018..U+201B as single quotes; each quote
|
|
112
|
+
* character is doubled as itself. */
|
|
113
|
+
function psQuote(value) {
|
|
114
|
+
return `'${String(value).replace(/['\u2018-\u201B]/g, '$&$&')}'`;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/** Escape PowerShell -like wildcard metacharacters so a path is matched
|
|
118
|
+
* LITERALLY. -like (not -match) is used deliberately: a regex operator would
|
|
119
|
+
* clobber $Matches, which the port-range bound above reads, and a Windows
|
|
120
|
+
* path's backslashes would be read as regex escapes. */
|
|
121
|
+
function psLikeEscape(value) {
|
|
122
|
+
return String(value).replace(/([*?[\]`])/g, '`$1');
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/** Quote a value for embedding in a POSIX shell single-quoted word. awk's -v
|
|
126
|
+
* ALSO processes backslash escapes in the assigned value, so backslashes are
|
|
127
|
+
* doubled first -- otherwise a `\U`/`\x` in a path would be mangled. */
|
|
128
|
+
function awkVarQuote(value) {
|
|
129
|
+
const escaped = String(value).replace(/\\/g, '\\\\');
|
|
130
|
+
return `'${escaped.replace(/'/g, "'\\''")}'`;
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/** Normalize a member registry `os` value to the shell family we must speak. */
|
|
134
|
+
export function memberShellFamily(os) {
|
|
135
|
+
// NOTE: a bare /win/ test is wrong -- 'darwin' contains 'win'.
|
|
136
|
+
const text = String(os || '').toLowerCase();
|
|
137
|
+
return (text.startsWith('win') || text.includes('windows')) ? 'win32' : 'posix';
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* The probe-and-kill command, per shell family. One command does both: it
|
|
142
|
+
* enumerates candidates, prints what it is about to kill (so the sweep can log
|
|
143
|
+
* evidence rather than a silent body count), and kills only those.
|
|
144
|
+
*
|
|
145
|
+
* @param {'win32'|'posix'} family
|
|
146
|
+
* @param {number} maxAgeMs
|
|
147
|
+
* @param {string|null} [ownerDataDirPrefix] when set, only a process whose
|
|
148
|
+
* command line carries a `--data-dir` under this prefix is a candidate
|
|
149
|
+
* (see normalizeOwnerDataDirPrefix above). Omitted -> machine-wide.
|
|
150
|
+
* @returns {string}
|
|
151
|
+
*/
|
|
152
|
+
export function buildSweepCommand(family, maxAgeMs = DEFAULT_MAX_AGE_MS, ownerDataDirPrefix = null) {
|
|
153
|
+
const maxAgeSeconds = Math.floor(maxAgeMs / 1000);
|
|
154
|
+
const owner = normalizeOwnerDataDirPrefix(ownerDataDirPrefix);
|
|
155
|
+
// Exact numeric bounds, never a hand-derived digit-prefix regex: matching
|
|
156
|
+
// must be EXACT on [SETTLE_PORT_RANGE.start, SETTLE_PORT_RANGE.end) so an
|
|
157
|
+
// operator's own long-lived server (e.g. --port 1337, or ANY 4-digit port,
|
|
158
|
+
// or a 5-digit port merely starting with the same leading digits like
|
|
159
|
+
// --port 13400) is never a false positive -- see the module doc above.
|
|
160
|
+
const portLo = SETTLE_PORT_RANGE.start;
|
|
161
|
+
const portHi = SETTLE_PORT_RANGE.end - 1; // inclusive upper bound
|
|
162
|
+
if (family === 'win32') {
|
|
163
|
+
// The registered `shell` for a win32 member can be real PowerShell OR
|
|
164
|
+
// gitbash (bash.exe) -- and MSYS `ps` cannot support the POSIX branch
|
|
165
|
+
// below (no -o/etimes support, confirmed live). Rather than add a
|
|
166
|
+
// third shell-family branch, wrap this script as an opaque
|
|
167
|
+
// `powershell -EncodedCommand <blob>` invocation via the same
|
|
168
|
+
// wrapForMember() envelope se-windows.mjs uses for its own member
|
|
169
|
+
// dispatch. That string is a single shell-agnostic argument to any
|
|
170
|
+
// OUTER shell (bash.exe, cmd.exe, powershell.exe) -- it always execs
|
|
171
|
+
// the literal powershell.exe binary regardless of which one the
|
|
172
|
+
// receiving member actually runs.
|
|
173
|
+
const rawScript = [
|
|
174
|
+
`$cutoff = (Get-Date).AddSeconds(-${maxAgeSeconds})`,
|
|
175
|
+
'$procs = Get-CimInstance Win32_Process -Filter "Name=\'dolt.exe\'" -ErrorAction SilentlyContinue |'
|
|
176
|
+
+ ' Where-Object { $_.CommandLine -match \'sql-server\''
|
|
177
|
+
+ ` -and $_.CommandLine -match '--port (\\d+)' -and [int]$Matches[1] -ge ${portLo} -and [int]$Matches[1] -le ${portHi}`
|
|
178
|
+
+ ' -and $_.CreationDate -lt $cutoff'
|
|
179
|
+
// Owner clause LAST, and -like rather than -match: $Matches still
|
|
180
|
+
// holds the --port capture the bound above compares, so any regex
|
|
181
|
+
// operator inserted here would silently break the port range.
|
|
182
|
+
+ (owner ? ` -and $_.CommandLine -like ${psQuote(`*--data-dir*${psLikeEscape(owner)}*`)}` : '')
|
|
183
|
+
+ ' }',
|
|
184
|
+
'foreach ($p in $procs) { Write-Output "ORPHAN:$($p.ProcessId):$($p.CommandLine)"; Stop-Process -Id $p.ProcessId -Force -ErrorAction SilentlyContinue }',
|
|
185
|
+
].join('; ');
|
|
186
|
+
return seWindows.wrapForMember(rawScript);
|
|
187
|
+
}
|
|
188
|
+
// POSIX: etimes is the process age in seconds, so no clock skew maths.
|
|
189
|
+
// awk has no lookahead, so the port bound is an actual numeric range
|
|
190
|
+
// check (match() + substr() to pull the digits, then compare) rather than
|
|
191
|
+
// a digit-prefix regex -- exact, not "harmlessly overbroad".
|
|
192
|
+
// The owner clause is a literal SUBSTRING test (index()), never a regex:
|
|
193
|
+
// a path may contain regex metacharacters, and awk has no literal-match
|
|
194
|
+
// operator. The value is passed via -v so it is never spliced into the
|
|
195
|
+
// program text.
|
|
196
|
+
const ownerVar = owner ? `-v owner=${awkVarQuote(owner)} ` : '';
|
|
197
|
+
const ownerClause = owner ? ' && /--data-dir/ && index($0, owner) > 0' : '';
|
|
198
|
+
return [
|
|
199
|
+
`ps -eo pid=,etimes=,args= | awk ${ownerVar}-v lo=${portLo} -v hi=${portHi} '$2 > ${maxAgeSeconds} && /sql-server/${ownerClause} && match($0, /--port [0-9]+/) {`
|
|
200
|
+
+ ' port = substr($0, RSTART + 7, RLENGTH - 7) + 0;'
|
|
201
|
+
+ ' if (port >= lo && port <= hi) { printf "ORPHAN:%s:", $1; for (i=3; i<=NF; i++) printf "%s ", $i; print "" }'
|
|
202
|
+
+ " }'",
|
|
203
|
+
'| tee /dev/stderr',
|
|
204
|
+
"| sed -n 's/^ORPHAN:\\([0-9]*\\):.*/\\1/p'",
|
|
205
|
+
'| xargs -r kill -9',
|
|
206
|
+
].join(' ');
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
/** Parse the ORPHAN: lines a sweep command emits. */
|
|
210
|
+
export function parseSweepOutput(output) {
|
|
211
|
+
const found = [];
|
|
212
|
+
for (const line of String(output || '').split('\n')) {
|
|
213
|
+
const match = line.replace(/\r$/, '').match(/ORPHAN:(\d+):(.*)$/);
|
|
214
|
+
if (match) found.push({ pid: Number(match[1]), commandLine: match[2].trim() });
|
|
215
|
+
}
|
|
216
|
+
return found;
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* Create the sweep seam. Shape matches the supervisor's other timer-driven
|
|
221
|
+
* seams (dolt-mutex.mjs, id-allocator.mjs): construct, then start()/stop() is
|
|
222
|
+
* driven by the seam machinery in server.mjs.
|
|
223
|
+
*
|
|
224
|
+
* @param {{
|
|
225
|
+
* listMembers: () => Promise<{ members: Array<object> }>,
|
|
226
|
+
* execCommand: (opts: { member: string, command: string }) => Promise<{ ok: boolean, output?: string, error?: string }>,
|
|
227
|
+
* intervalMs?: number,
|
|
228
|
+
* maxAgeMs?: number,
|
|
229
|
+
* ownerDataDirPrefix?: string|null,
|
|
230
|
+
* setInterval?: Function,
|
|
231
|
+
* clearInterval?: Function,
|
|
232
|
+
* logger?: { log?: Function, error?: Function },
|
|
233
|
+
* }} deps
|
|
234
|
+
*/
|
|
235
|
+
export function createDoltOrphanSweep(deps = {}) {
|
|
236
|
+
const {
|
|
237
|
+
listMembers,
|
|
238
|
+
execCommand,
|
|
239
|
+
intervalMs = DEFAULT_SWEEP_INTERVAL_MS,
|
|
240
|
+
maxAgeMs = DEFAULT_MAX_AGE_MS,
|
|
241
|
+
ownerDataDirPrefix = null,
|
|
242
|
+
setInterval: setIntervalFn = setInterval,
|
|
243
|
+
clearInterval: clearIntervalFn = clearInterval,
|
|
244
|
+
logger = console,
|
|
245
|
+
} = deps;
|
|
246
|
+
|
|
247
|
+
const owner = normalizeOwnerDataDirPrefix(ownerDataDirPrefix);
|
|
248
|
+
|
|
249
|
+
const log = (...a) => (logger.log ?? (() => {}))(...a);
|
|
250
|
+
const logError = (...a) => (logger.error ?? logger.log ?? (() => {}))(...a);
|
|
251
|
+
|
|
252
|
+
let timer = null;
|
|
253
|
+
let inFlight = false;
|
|
254
|
+
|
|
255
|
+
/**
|
|
256
|
+
* One sweep pass across every registered member. Never throws: this is a
|
|
257
|
+
* safety net, and a safety net that can take the supervisor down is worse
|
|
258
|
+
* than the leak it guards against.
|
|
259
|
+
*
|
|
260
|
+
* @returns {Promise<{ swept: number, killed: Array<{ member: string, pid: number, commandLine: string }>, errors: number }>}
|
|
261
|
+
*/
|
|
262
|
+
async function sweepOnce() {
|
|
263
|
+
const killed = [];
|
|
264
|
+
let swept = 0;
|
|
265
|
+
let errors = 0;
|
|
266
|
+
|
|
267
|
+
let members = [];
|
|
268
|
+
try {
|
|
269
|
+
const listed = await listMembers();
|
|
270
|
+
members = (listed && Array.isArray(listed.members)) ? listed.members : [];
|
|
271
|
+
} catch (err) {
|
|
272
|
+
logError('[dolt-orphan-sweep] could not list fleet members (skipping this pass):', err);
|
|
273
|
+
return { swept, killed, errors: 1 };
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
for (const member of members) {
|
|
277
|
+
const name = member && (member.name || member.id);
|
|
278
|
+
if (!name) continue;
|
|
279
|
+
const family = memberShellFamily(member && member.os);
|
|
280
|
+
const command = buildSweepCommand(family, maxAgeMs, owner);
|
|
281
|
+
swept += 1;
|
|
282
|
+
let res;
|
|
283
|
+
try {
|
|
284
|
+
// eslint-disable-next-line no-await-in-loop -- deliberately sequential: a safety net must not fan out N SSH sessions at once
|
|
285
|
+
res = await execCommand({ member: name, command });
|
|
286
|
+
} catch (err) {
|
|
287
|
+
errors += 1;
|
|
288
|
+
logError(`[dolt-orphan-sweep] probe failed for member '${name}':`, err && err.message ? err.message : err);
|
|
289
|
+
continue;
|
|
290
|
+
}
|
|
291
|
+
if (res && res.ok === false) {
|
|
292
|
+
errors += 1;
|
|
293
|
+
logError(`[dolt-orphan-sweep] probe failed for member '${name}': ${res.error}`);
|
|
294
|
+
continue;
|
|
295
|
+
}
|
|
296
|
+
for (const orphan of parseSweepOutput(res && (res.output || res.error))) {
|
|
297
|
+
killed.push({ member: name, pid: orphan.pid, commandLine: orphan.commandLine });
|
|
298
|
+
logError(
|
|
299
|
+
`[dolt-orphan-sweep] KILLED an orphaned ephemeral dolt sql-server on member '${name}' `
|
|
300
|
+
+ `(pid ${orphan.pid}, older than ${Math.floor(maxAgeMs / 1000)}s, cmd: ${orphan.commandLine}). `
|
|
301
|
+
+ "This should be impossible if settle's own finally-block teardown ran -- it means an orchestrator "
|
|
302
|
+
+ 'process died mid-settle (docs/dolt-sync-redesign.md Part 3.3). Investigate the sprint that was settling.',
|
|
303
|
+
);
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
if (killed.length === 0) log(`[dolt-orphan-sweep] pass complete: ${swept} member(s) probed, no orphaned settle servers found.`);
|
|
308
|
+
return { swept, killed, errors };
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
return {
|
|
312
|
+
name: 'dolt-orphan-sweep',
|
|
313
|
+
sweepOnce,
|
|
314
|
+
start() {
|
|
315
|
+
if (timer) return;
|
|
316
|
+
timer = setIntervalFn(() => {
|
|
317
|
+
// Skip a tick rather than stacking passes if the previous one
|
|
318
|
+
// is still walking members over SSH (same reentrancy posture
|
|
319
|
+
// as the watchdog's interval).
|
|
320
|
+
if (inFlight) return;
|
|
321
|
+
inFlight = true;
|
|
322
|
+
Promise.resolve()
|
|
323
|
+
.then(sweepOnce)
|
|
324
|
+
.catch((err) => logError('[dolt-orphan-sweep] sweep pass failed:', err))
|
|
325
|
+
.finally(() => { inFlight = false; });
|
|
326
|
+
}, intervalMs);
|
|
327
|
+
if (timer && typeof timer.unref === 'function') timer.unref();
|
|
328
|
+
},
|
|
329
|
+
stop() {
|
|
330
|
+
if (!timer) return;
|
|
331
|
+
clearIntervalFn(timer);
|
|
332
|
+
timer = null;
|
|
333
|
+
},
|
|
334
|
+
get intervalMs() { return intervalMs; },
|
|
335
|
+
get maxAgeMs() { return maxAgeMs; },
|
|
336
|
+
get ownerDataDirPrefix() { return owner; },
|
|
337
|
+
};
|
|
338
|
+
}
|
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- fleet-backed member listing (apra-fleet-eft.4.8.1
|
|
3
|
+
// wiring helper)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// api.mjs's createSprintController() accepts an injected `listMembers()`
|
|
7
|
+
// collaborator (defaults to `() => ({ members: [] })` when omitted) used by:
|
|
8
|
+
// * GET /api/members (the raw list, overlaid with THIS supervisor's own
|
|
9
|
+
// ledger reservations), and
|
|
10
|
+
// * the default eft.5.2/eft.26.2 member-overlap guard's second reservation
|
|
11
|
+
// source (the fleet server's own `reservedBy` record).
|
|
12
|
+
//
|
|
13
|
+
// The supervisor process itself is NOT a fleet MCP client (it has no
|
|
14
|
+
// standing transport -- bin/cli.mjs's per-sprint children own that), so this
|
|
15
|
+
// module opens a SHORT-LIVED StreamableHttp connection per call, mirroring
|
|
16
|
+
// bin/cli.mjs's own `fleetApi.listMembers({ format: 'json' })` call (the
|
|
17
|
+
// single source of truth for that request shape), and tears the connection
|
|
18
|
+
// down again immediately after. This is deliberately NOT connected once at
|
|
19
|
+
// supervisor boot: `fleet-se serve` must stay independently up (and answer
|
|
20
|
+
// GET /api/health) even when no fleet HTTP singleton is reachable yet -- the
|
|
21
|
+
// supervisor's OWN lifecycle never depends on the fleet server's.
|
|
22
|
+
// =============================================================================
|
|
23
|
+
|
|
24
|
+
import { StreamableHttpTransport } from '@apralabs/apra-fleet-client/transport';
|
|
25
|
+
import { McpClient } from '@apralabs/apra-fleet-client/client';
|
|
26
|
+
import { withFleetAccessSecret } from '@apralabs/apra-fleet-client/server-resolution';
|
|
27
|
+
import { ApraFleet } from '@apralabs/apra-fleet-client';
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* "The fleet member list could not be read" marker, attached to a
|
|
31
|
+
* listFleetMembers() result as a NON-ENUMERABLE symbol-keyed property whose
|
|
32
|
+
* value is the human-readable reason. Non-enumerable on purpose: the existing
|
|
33
|
+
* callers (GET /api/members, the dolt orphan sweep, the member-overlap guard)
|
|
34
|
+
* only read `.members` and keep seeing exactly `{ members: [] }` (deepEqual
|
|
35
|
+
* included), while callers that MUST tell "fleet unreachable" apart from "no
|
|
36
|
+
* members registered" (the backlog-member ensure and the launch-time backlog
|
|
37
|
+
* pin) read it through fleetMembersUnavailableReason().
|
|
38
|
+
*/
|
|
39
|
+
export const FLEET_MEMBERS_UNAVAILABLE = Symbol.for('apra-fleet-se.fleetMembersUnavailable');
|
|
40
|
+
/** Set (with the client's actionable message) when the fleet server was stopped with 'apra-fleet stop'. */
|
|
41
|
+
export const FLEET_STOPPED_BY_USER = Symbol.for('apra-fleet-se.fleetStoppedByUser');
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* The "stopped by the user" message carried by a listMembers()-shaped
|
|
45
|
+
* result, or null. A launch must surface it verbatim (the fix is
|
|
46
|
+
* 'apra-fleet start'), not a generic "fleet unavailable".
|
|
47
|
+
* @param {*} result
|
|
48
|
+
* @returns {string|null}
|
|
49
|
+
*/
|
|
50
|
+
export function fleetMembersStoppedByUserReason(result) {
|
|
51
|
+
if (!result || (typeof result !== 'object' && typeof result !== 'function')) return null;
|
|
52
|
+
const reason = result[FLEET_STOPPED_BY_USER];
|
|
53
|
+
return typeof reason === 'string' ? reason : null;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Mark a listMembers()-shaped result as "unavailable". Returns the same
|
|
58
|
+
* object (created as `{ members: [] }` when omitted), for use by
|
|
59
|
+
* listFleetMembers() itself and by test fakes of the listMembers seam.
|
|
60
|
+
* @param {object} [result]
|
|
61
|
+
* @param {string} [reason]
|
|
62
|
+
* @returns {object}
|
|
63
|
+
*/
|
|
64
|
+
export function markFleetMembersUnavailable(result = { members: [] }, reason = 'fleet member list unavailable') {
|
|
65
|
+
Object.defineProperty(result, FLEET_MEMBERS_UNAVAILABLE, {
|
|
66
|
+
value: String(reason), enumerable: false, configurable: true, writable: false,
|
|
67
|
+
});
|
|
68
|
+
return result;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* The unavailable reason carried by a listMembers()-shaped result, or null
|
|
73
|
+
* when the list was actually read (an empty list included).
|
|
74
|
+
* @param {*} result
|
|
75
|
+
* @returns {string|null}
|
|
76
|
+
*/
|
|
77
|
+
export function fleetMembersUnavailableReason(result) {
|
|
78
|
+
if (!result || (typeof result !== 'object' && typeof result !== 'function')) return null;
|
|
79
|
+
const reason = result[FLEET_MEMBERS_UNAVAILABLE];
|
|
80
|
+
return typeof reason === 'string' ? reason : null;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** U+274C, the prefix fleet tools put on a refusal reply's text. */
|
|
84
|
+
const FLEET_TOOL_FAILURE_MARK = String.fromCodePoint(0x274c);
|
|
85
|
+
|
|
86
|
+
function errorText(err) {
|
|
87
|
+
return err && err.message ? err.message : String(err);
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* Fetches the fleet's registered members via a short-lived MCP connection.
|
|
92
|
+
* Never throws: any resolution/connection/parse failure resolves to an empty
|
|
93
|
+
* member list rather than taking down the caller (GET /api/members degrades
|
|
94
|
+
* to "no members known" instead of a hard failure; the member-overlap guard
|
|
95
|
+
* that also consumes this already treats it as a best-effort second source).
|
|
96
|
+
*
|
|
97
|
+
* @param {{
|
|
98
|
+
* resolveConnection?: () => Promise<{ mode: string, url?: string, reason?: string }>,
|
|
99
|
+
* logger?: { log?: Function, error?: Function },
|
|
100
|
+
* }} [deps]
|
|
101
|
+
* @returns {Promise<{ members: Array<object> }>}
|
|
102
|
+
*/
|
|
103
|
+
export async function listFleetMembers(deps = {}) {
|
|
104
|
+
const logger = deps.logger ?? console;
|
|
105
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
106
|
+
const resolveConnection = deps.resolveConnection;
|
|
107
|
+
if (typeof resolveConnection !== 'function') {
|
|
108
|
+
throw new TypeError('listFleetMembers requires a resolveConnection() collaborator');
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
let connection;
|
|
112
|
+
try {
|
|
113
|
+
connection = await resolveConnection();
|
|
114
|
+
} catch (err) {
|
|
115
|
+
logError('[fleet-members] failed to resolve fleet server connection:', err);
|
|
116
|
+
const result = markFleetMembersUnavailable({ members: [] }, `could not resolve the fleet server connection: ${errorText(err)}`);
|
|
117
|
+
if (err && err.code === 'SERVER_STOPPED_BY_USER') {
|
|
118
|
+
Object.defineProperty(result, FLEET_STOPPED_BY_USER, { value: errorText(err), enumerable: false, configurable: true, writable: false });
|
|
119
|
+
}
|
|
120
|
+
return result;
|
|
121
|
+
}
|
|
122
|
+
if (!connection || connection.mode !== 'http') {
|
|
123
|
+
logError(`[fleet-members] no reachable fleet HTTP singleton (${connection && connection.reason})`);
|
|
124
|
+
return markFleetMembersUnavailable({ members: [] }, `no reachable fleet HTTP singleton (${connection && connection.reason})`);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
const transport = new StreamableHttpTransport(connection.url, withFleetAccessSecret());
|
|
128
|
+
try {
|
|
129
|
+
await transport.start();
|
|
130
|
+
const mcpClient = new McpClient(transport);
|
|
131
|
+
const fleetApi = new ApraFleet(mcpClient);
|
|
132
|
+
const listRes = await fleetApi.listMembers({ format: 'json' });
|
|
133
|
+
const text = listRes && listRes.content && listRes.content[0] ? listRes.content[0].text : JSON.stringify(listRes);
|
|
134
|
+
const parsed = JSON.parse(text);
|
|
135
|
+
if (!parsed || !Array.isArray(parsed.members)) {
|
|
136
|
+
return markFleetMembersUnavailable({ members: [] }, 'list_members returned no members array');
|
|
137
|
+
}
|
|
138
|
+
return { members: parsed.members };
|
|
139
|
+
} catch (err) {
|
|
140
|
+
logError('[fleet-members] failed to list fleet members:', err);
|
|
141
|
+
return markFleetMembersUnavailable({ members: [] }, `failed to list fleet members: ${errorText(err)}`);
|
|
142
|
+
} finally {
|
|
143
|
+
try { transport.stop(); } catch { /* best-effort teardown */ }
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* Runs one shell command on one member via the same SHORT-LIVED MCP connection
|
|
149
|
+
* pattern as listFleetMembers() above (the supervisor holds no standing fleet
|
|
150
|
+
* transport, deliberately). Added for the orphaned-`dolt sql-server` sweep
|
|
151
|
+
* (dolt-orphan-sweep.mjs, docs/dolt-sync-redesign.md Part 3.3), which is the
|
|
152
|
+
* only supervisor-side thing that must touch a member directly.
|
|
153
|
+
*
|
|
154
|
+
* Never throws: a failure resolves to `{ ok: false, error }` so the sweep --
|
|
155
|
+
* a safety net -- can log and move on rather than taking the supervisor down.
|
|
156
|
+
*
|
|
157
|
+
* @param {{ member: string, command: string, timeoutSeconds?: number,
|
|
158
|
+
* resolveConnection?: () => Promise<{ mode: string, url?: string, reason?: string }>,
|
|
159
|
+
* logger?: { log?: Function, error?: Function } }} opts
|
|
160
|
+
* @returns {Promise<{ ok: boolean, output?: string, error?: string }>}
|
|
161
|
+
*/
|
|
162
|
+
export async function executeFleetCommand(opts = {}) {
|
|
163
|
+
const { member, command, timeoutSeconds = 60, resolveConnection, logger = console } = opts;
|
|
164
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
165
|
+
if (typeof resolveConnection !== 'function') {
|
|
166
|
+
throw new TypeError('executeFleetCommand requires a resolveConnection() collaborator');
|
|
167
|
+
}
|
|
168
|
+
if (!member || !command) throw new TypeError('executeFleetCommand requires a member and a command');
|
|
169
|
+
|
|
170
|
+
let connection;
|
|
171
|
+
try {
|
|
172
|
+
connection = await resolveConnection();
|
|
173
|
+
} catch (err) {
|
|
174
|
+
return { ok: false, error: `could not resolve fleet server connection: ${err && err.message ? err.message : err}` };
|
|
175
|
+
}
|
|
176
|
+
if (!connection || connection.mode !== 'http') {
|
|
177
|
+
return { ok: false, error: `no reachable fleet HTTP singleton (${connection && connection.reason})` };
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
const transport = new StreamableHttpTransport(connection.url, withFleetAccessSecret());
|
|
181
|
+
try {
|
|
182
|
+
await transport.start();
|
|
183
|
+
const fleetApi = new ApraFleet(new McpClient(transport));
|
|
184
|
+
const res = await fleetApi.executeCommand({ command, member_name: member, timeout_s: timeoutSeconds });
|
|
185
|
+
const text = res && res.content && res.content[0] ? res.content[0].text : (typeof res === 'string' ? res : JSON.stringify(res));
|
|
186
|
+
if (res && res.isError) {
|
|
187
|
+
return { ok: false, error: String(text ?? 'unknown error') };
|
|
188
|
+
}
|
|
189
|
+
// The fleet server's execute_command does NOT set isError on a
|
|
190
|
+
// non-zero exit; it reports the real exit code (and clean, unprefixed
|
|
191
|
+
// stdout/stderr) in structuredContent instead, while `text` is the
|
|
192
|
+
// display form `Exit code: N\n<output>`. Surface those fields
|
|
193
|
+
// ADDITIVELY (only when the server sent them) so a caller that needs
|
|
194
|
+
// exit-code truth -- the beads view's dolt command adapter
|
|
195
|
+
// (beads-view.mjs) -- can read it, while `ok`/`output` keep their
|
|
196
|
+
// existing meaning for the orphan sweep.
|
|
197
|
+
const sc = res && res.structuredContent;
|
|
198
|
+
if (sc && typeof sc.exitCode === 'number') {
|
|
199
|
+
return {
|
|
200
|
+
ok: true,
|
|
201
|
+
output: String(text ?? ''),
|
|
202
|
+
exitCode: sc.exitCode,
|
|
203
|
+
stdout: typeof sc.stdout === 'string' ? sc.stdout : '',
|
|
204
|
+
stderr: typeof sc.stderr === 'string' ? sc.stderr : '',
|
|
205
|
+
};
|
|
206
|
+
}
|
|
207
|
+
return { ok: true, output: String(text ?? '') };
|
|
208
|
+
} catch (err) {
|
|
209
|
+
logError(`[fleet-members] execute_command failed on member '${member}':`, err);
|
|
210
|
+
return { ok: false, error: err && err.message ? err.message : String(err) };
|
|
211
|
+
} finally {
|
|
212
|
+
try { transport.stop(); } catch { /* best-effort teardown */ }
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
/**
|
|
217
|
+
* Shared short-lived-connection tool call for registerFleetMember() /
|
|
218
|
+
* updateFleetMember() below (same pattern as executeFleetCommand above).
|
|
219
|
+
* Never throws: resolves `{ ok: true, output }` or `{ ok: false, error }`.
|
|
220
|
+
* A tool reply flagged isError, or whose text starts with the fleet tools'
|
|
221
|
+
* failure marker (U+274C), is a failure -- register_member/update_member
|
|
222
|
+
* report refusals as text rather than isError.
|
|
223
|
+
*/
|
|
224
|
+
async function callFleetMemberTool(toolName, invoke, { resolveConnection, logger = console }) {
|
|
225
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
226
|
+
if (typeof resolveConnection !== 'function') {
|
|
227
|
+
throw new TypeError(`${toolName} requires a resolveConnection() collaborator`);
|
|
228
|
+
}
|
|
229
|
+
let connection;
|
|
230
|
+
try {
|
|
231
|
+
connection = await resolveConnection();
|
|
232
|
+
} catch (err) {
|
|
233
|
+
return { ok: false, unavailable: true, error: `could not resolve fleet server connection: ${errorText(err)}` };
|
|
234
|
+
}
|
|
235
|
+
if (!connection || connection.mode !== 'http') {
|
|
236
|
+
return { ok: false, unavailable: true, error: `no reachable fleet HTTP singleton (${connection && connection.reason})` };
|
|
237
|
+
}
|
|
238
|
+
const transport = new StreamableHttpTransport(connection.url, withFleetAccessSecret());
|
|
239
|
+
try {
|
|
240
|
+
await transport.start();
|
|
241
|
+
const fleetApi = new ApraFleet(new McpClient(transport));
|
|
242
|
+
const res = await invoke(fleetApi);
|
|
243
|
+
const text = res && res.content && res.content[0] ? res.content[0].text : (typeof res === 'string' ? res : JSON.stringify(res));
|
|
244
|
+
const textStr = String(text ?? '');
|
|
245
|
+
if ((res && res.isError) || textStr.trimStart().startsWith(FLEET_TOOL_FAILURE_MARK)) {
|
|
246
|
+
return { ok: false, error: textStr || 'unknown error' };
|
|
247
|
+
}
|
|
248
|
+
return { ok: true, output: textStr };
|
|
249
|
+
} catch (err) {
|
|
250
|
+
logError(`[fleet-members] ${toolName} failed:`, err);
|
|
251
|
+
return { ok: false, unavailable: true, error: errorText(err) };
|
|
252
|
+
} finally {
|
|
253
|
+
try { transport.stop(); } catch { /* best-effort teardown */ }
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
/**
|
|
258
|
+
* register_member over a short-lived connection. `options` is the
|
|
259
|
+
* register_member input (friendly_name, member_type, work_folder, ...).
|
|
260
|
+
* @param {{ options: object, resolveConnection: Function, logger?: object }} opts
|
|
261
|
+
* @returns {Promise<{ ok: boolean, output?: string, error?: string, unavailable?: boolean }>}
|
|
262
|
+
*/
|
|
263
|
+
export async function registerFleetMember(opts = {}) {
|
|
264
|
+
const { options, ...deps } = opts;
|
|
265
|
+
if (!options || !options.friendly_name) throw new TypeError('registerFleetMember requires options.friendly_name');
|
|
266
|
+
return callFleetMemberTool('register_member', (api) => api.registerMember(options), deps);
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
/**
|
|
270
|
+
* update_member over a short-lived connection. `options` is the
|
|
271
|
+
* update_member input (member_name or member_id plus the fields to change).
|
|
272
|
+
* @param {{ options: object, resolveConnection: Function, logger?: object }} opts
|
|
273
|
+
* @returns {Promise<{ ok: boolean, output?: string, error?: string, unavailable?: boolean }>}
|
|
274
|
+
*/
|
|
275
|
+
export async function updateFleetMember(opts = {}) {
|
|
276
|
+
const { options, ...deps } = opts;
|
|
277
|
+
if (!options || (!options.member_name && !options.member_id)) throw new TypeError('updateFleetMember requires options.member_name or options.member_id');
|
|
278
|
+
return callFleetMemberTool('update_member', (api) => api.updateMember(options), deps);
|
|
279
|
+
}
|