@apralabs/apra-fleet 0.4.1 → 0.4.3
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 +53 -12
- package/dist/agents/backlog-groomer.md +42 -21
- package/dist/agents/ci-watcher.md +14 -0
- package/dist/agents/deployer.md +59 -46
- package/dist/agents/doer.md +157 -134
- package/dist/agents/harvester.md +31 -32
- package/dist/agents/integ-test-runner.md +92 -113
- package/dist/agents/kb-reconciler.md +40 -42
- package/dist/agents/plan-reviewer.md +139 -63
- package/dist/agents/planner.md +176 -100
- package/dist/agents/regression-test-runner.md +77 -81
- package/dist/agents/reviewer.md +69 -85
- package/dist/agents/schemas/integ-test-runner-output.json +1 -1
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/regression-test-runner-output.json +4 -17
- package/dist/cli/agent-transform.d.ts +83 -2
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +266 -21
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +29 -11
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +7 -5
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +44 -43
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/install.d.ts +33 -0
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +294 -61
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/kb-directives.d.ts.map +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-directives.js.map +1 -1
- package/dist/cli/register-member.d.ts.map +1 -1
- package/dist/cli/register-member.js +7 -3
- package/dist/cli/register-member.js.map +1 -1
- package/dist/cli/start.d.ts.map +1 -1
- package/dist/cli/start.js +7 -0
- package/dist/cli/start.js.map +1 -1
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +5 -3
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/watch.d.ts +26 -3
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +41 -9
- package/dist/cli/watch.js.map +1 -1
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.d.ts.map +1 -1
- package/dist/commands/kb-server.js +43 -3
- package/dist/commands/kb-server.js.map +1 -1
- package/dist/index.js +3 -3
- package/dist/os/git-bash-candidates.d.ts +35 -0
- package/dist/os/git-bash-candidates.d.ts.map +1 -0
- package/dist/os/git-bash-candidates.js +46 -0
- package/dist/os/git-bash-candidates.js.map +1 -0
- package/dist/os/index.d.ts +13 -4
- package/dist/os/index.d.ts.map +1 -1
- package/dist/os/index.js +17 -2
- package/dist/os/index.js.map +1 -1
- package/dist/os/linux.d.ts +6 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +36 -3
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +68 -2
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/os-commands.js.map +1 -1
- package/dist/os/windows-gitbash.d.ts +98 -0
- package/dist/os/windows-gitbash.d.ts.map +1 -0
- package/dist/os/windows-gitbash.js +259 -0
- package/dist/os/windows-gitbash.js.map +1 -0
- package/dist/os/windows.d.ts +6 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +73 -8
- package/dist/os/windows.js.map +1 -1
- package/dist/providers/agy.d.ts +118 -8
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +580 -55
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +83 -4
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +365 -12
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +7 -4
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +24 -4
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +7 -4
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +27 -4
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/index.d.ts +0 -1
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +0 -3
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +7 -4
- package/dist/providers/none.d.ts.map +1 -1
- package/dist/providers/none.js +22 -4
- package/dist/providers/none.js.map +1 -1
- package/dist/providers/opencode.d.ts +6 -3
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +27 -4
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +215 -11
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +58 -2
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.js +2 -2
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/agy-project.d.ts +102 -0
- package/dist/services/agy-project.d.ts.map +1 -0
- package/dist/services/agy-project.js +356 -0
- package/dist/services/agy-project.js.map +1 -0
- package/dist/services/auth-socket.js +4 -4
- package/dist/services/auth-web.js +1 -1
- package/dist/services/cloud/activity.js +2 -2
- package/dist/services/cloud/activity.js.map +1 -1
- package/dist/services/cloud/lifecycle.d.ts.map +1 -1
- package/dist/services/cloud/lifecycle.js +33 -4
- package/dist/services/cloud/lifecycle.js.map +1 -1
- package/dist/services/context-admission.d.ts.map +1 -1
- package/dist/services/context-admission.js +9 -7
- package/dist/services/context-admission.js.map +1 -1
- package/dist/services/credential-cleanup.d.ts.map +1 -1
- package/dist/services/credential-cleanup.js +47 -10
- package/dist/services/credential-cleanup.js.map +1 -1
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.d.ts.map +1 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/exit-drain.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +32 -4
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +1 -0
- package/dist/services/http-transport.d.ts.map +1 -1
- package/dist/services/http-transport.js +48 -1
- package/dist/services/http-transport.js.map +1 -1
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.d.ts.map +1 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-config.js.map +1 -0
- package/dist/services/knowledge/kb-providers.d.ts +7 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
- package/dist/services/knowledge/kb-providers.js +191 -17
- package/dist/services/knowledge/kb-providers.js.map +1 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
- package/dist/services/member-home.d.ts +1 -1
- package/dist/services/member-home.d.ts.map +1 -1
- package/dist/services/member-home.js +15 -12
- package/dist/services/member-home.js.map +1 -1
- package/dist/services/model-pricing.d.ts.map +1 -1
- package/dist/services/model-pricing.js +7 -8
- package/dist/services/model-pricing.js.map +1 -1
- package/dist/services/orphan-recovery.d.ts +6 -3
- package/dist/services/orphan-recovery.d.ts.map +1 -1
- package/dist/services/orphan-recovery.js +17 -14
- package/dist/services/orphan-recovery.js.map +1 -1
- package/dist/services/preflight-check.js +2 -2
- package/dist/services/preflight-check.js.map +1 -1
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.d.ts.map +1 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/secret-token.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +3 -1
- package/dist/services/service-manager/types.d.ts.map +1 -1
- package/dist/services/service-manager/windows.d.ts +14 -2
- package/dist/services/service-manager/windows.d.ts.map +1 -1
- package/dist/services/service-manager/windows.js +65 -7
- package/dist/services/service-manager/windows.js.map +1 -1
- package/dist/services/shell-probe.d.ts +131 -0
- package/dist/services/shell-probe.d.ts.map +1 -0
- package/dist/services/shell-probe.js +210 -0
- package/dist/services/shell-probe.js.map +1 -0
- package/dist/services/singleton.d.ts +2 -0
- package/dist/services/singleton.d.ts.map +1 -1
- package/dist/services/singleton.js +1 -1
- package/dist/services/singleton.js.map +1 -1
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +60 -4
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/find-log-file.d.ts.map +1 -1
- package/dist/services/stall/find-log-file.js +22 -16
- package/dist/services/stall/find-log-file.js.map +1 -1
- package/dist/services/stall/read-log-tail.d.ts.map +1 -1
- package/dist/services/stall/read-log-tail.js +26 -15
- package/dist/services/stall/read-log-tail.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts +53 -4
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +212 -34
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +35 -42
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts +9 -0
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +119 -8
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/substitution-engine.js.map +1 -1
- package/dist/services/tool-registry.d.ts.map +1 -1
- package/dist/services/tool-registry.js +5 -3
- package/dist/services/tool-registry.js.map +1 -1
- package/dist/services/user-config.js +1 -1
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/azure-devops.d.ts +67 -2
- package/dist/services/vcs/azure-devops.d.ts.map +1 -1
- package/dist/services/vcs/azure-devops.js +281 -15
- package/dist/services/vcs/azure-devops.js.map +1 -1
- package/dist/services/vcs/bitbucket.d.ts.map +1 -1
- package/dist/services/vcs/bitbucket.js +16 -0
- package/dist/services/vcs/bitbucket.js.map +1 -1
- package/dist/services/vcs/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +24 -0
- package/dist/services/vcs/github.js.map +1 -1
- package/dist/services/vcs/types.d.ts +123 -2
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +20 -1
- package/dist/skills/pm/SKILL.md +1 -2
- package/dist/skills/pm/cost.md +0 -4
- package/dist/skills/pm/fleet-addendum.md +2 -3
- package/dist/tools/check-status.d.ts +7 -4
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +5 -3
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/cloud-control.js +2 -2
- package/dist/tools/cloud-control.js.map +1 -1
- package/dist/tools/compose-permissions.d.ts +6 -0
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +211 -50
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +56 -29
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +15 -2
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +1214 -873
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/kb-capture.d.ts +2 -2
- package/dist/tools/kb-capture.d.ts.map +1 -1
- package/dist/tools/kb-capture.js +29 -5
- package/dist/tools/kb-capture.js.map +1 -1
- package/dist/tools/kb-export.d.ts +2 -2
- package/dist/tools/kb-export.d.ts.map +1 -1
- package/dist/tools/kb-export.js +3 -28
- package/dist/tools/kb-export.js.map +1 -1
- package/dist/tools/kb-feedback.d.ts.map +1 -1
- package/dist/tools/kb-feedback.js +3 -1
- package/dist/tools/kb-feedback.js.map +1 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
- package/dist/tools/kb-freshness-sweep.js +3 -1
- package/dist/tools/kb-freshness-sweep.js.map +1 -1
- package/dist/tools/kb-import.d.ts.map +1 -1
- package/dist/tools/kb-import.js +2 -1
- package/dist/tools/kb-import.js.map +1 -1
- package/dist/tools/kb-list.d.ts.map +1 -1
- package/dist/tools/kb-list.js +3 -1
- package/dist/tools/kb-list.js.map +1 -1
- package/dist/tools/kb-query.d.ts +2 -2
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
- package/dist/tools/kb-reconcile-prefilter.js +3 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
- package/dist/tools/kb-resolve-contradiction.js +3 -1
- package/dist/tools/kb-resolve-contradiction.js.map +1 -1
- package/dist/tools/kb-setup.d.ts.map +1 -1
- package/dist/tools/kb-setup.js +125 -20
- package/dist/tools/kb-setup.js.map +1 -1
- package/dist/tools/kb-stats.d.ts.map +1 -1
- package/dist/tools/kb-stats.js +64 -43
- package/dist/tools/kb-stats.js.map +1 -1
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +7 -2
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +2 -2
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +22 -3
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +58 -1
- package/dist/tools/member-reservation.d.ts.map +1 -1
- package/dist/tools/member-reservation.js +71 -18
- package/dist/tools/member-reservation.js.map +1 -1
- package/dist/tools/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +17 -2
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.d.ts +80 -1
- package/dist/tools/provision-auth.d.ts.map +1 -1
- package/dist/tools/provision-auth.js +147 -59
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +96 -3
- package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
- package/dist/tools/provision-vcs-auth.js +254 -88
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +21 -12
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +141 -16
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts.map +1 -1
- package/dist/tools/remove-member.js +29 -4
- package/dist/tools/remove-member.js.map +1 -1
- package/dist/tools/revoke-vcs-auth.js +2 -2
- package/dist/tools/revoke-vcs-auth.js.map +1 -1
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/setup-git-app.d.ts.map +1 -1
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/setup-git-app.js.map +1 -1
- package/dist/tools/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +2 -1
- package/dist/tools/setup-ssh-key.js.map +1 -1
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.d.ts.map +1 -1
- package/dist/tools/shutdown-server.js +23 -1
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/stop-prompt.js +2 -2
- package/dist/tools/stop-prompt.js.map +1 -1
- package/dist/tools/update-agent-cli.js +2 -2
- package/dist/tools/update-agent-cli.js.map +1 -1
- package/dist/tools/update-member.d.ts +21 -12
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +61 -12
- package/dist/tools/update-member.js.map +1 -1
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
- package/dist/tools/vcs-credential-exec.js +197 -0
- package/dist/tools/vcs-credential-exec.js.map +1 -0
- package/dist/types.d.ts +24 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +36 -0
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +39 -1
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/log-helpers.d.ts.map +1 -1
- package/dist/utils/log-helpers.js +2 -2
- package/dist/utils/log-helpers.js.map +1 -1
- package/dist/utils/platform.d.ts +7 -0
- package/dist/utils/platform.d.ts.map +1 -1
- package/dist/utils/platform.js +11 -1
- package/dist/utils/platform.js.map +1 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +7 -1
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/shell-escape.d.ts +16 -0
- package/dist/utils/shell-escape.d.ts.map +1 -1
- package/dist/utils/shell-escape.js +22 -2
- package/dist/utils/shell-escape.js.map +1 -1
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/vcs-provider-detect.js.map +1 -0
- package/dist/utils/workspace-trust.d.ts +20 -17
- package/dist/utils/workspace-trust.d.ts.map +1 -1
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/utils/workspace-trust.js.map +1 -1
- package/dist/workflows/auto-sprint.js +180 -32
- package/package.json +7 -5
- package/packages/apra-fleet-client/src/client/api.mjs +403 -12
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- 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 +42 -21
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +14 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -46
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +157 -134
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +31 -32
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +92 -113
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +40 -42
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +139 -63
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +176 -100
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +77 -81
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +69 -85
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -3
- package/packages/apra-fleet-se/bin/cli.mjs +280 -3
- package/packages/apra-fleet-se/bin/serve.mjs +114 -5
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +199 -34
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +285 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.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/docs/shared-orchestrator-reservation-design.md +12 -12
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1054 -39
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +308 -0
- 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 +556 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -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/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1672 -9072
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +159 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +20 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -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 +211 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +204 -19
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +707 -12
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +191 -43
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +333 -6
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +165 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +167 -37
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +178 -1
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +478 -32
- package/skills/fleet/SKILL.md +27 -16
- package/skills/fleet/auth-azdevops.md +57 -7
- package/skills/fleet/auth-bitbucket.md +5 -5
- package/skills/fleet/auth-github.md +7 -6
- package/skills/fleet/beads-conflict-resolution.md +141 -0
- package/skills/fleet/beads.md +16 -12
- package/skills/fleet/onboarding.md +6 -6
- package/skills/fleet/permissions.md +11 -7
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/skill-matrix.md +1 -1
- package/skills/fleet/troubleshooting.md +4 -3
- package/version.json +1 -1
- package/dist/providers/gemini.d.ts +0 -52
- package/dist/providers/gemini.d.ts.map +0 -1
- package/dist/providers/gemini.js +0 -236
- package/dist/providers/gemini.js.map +0 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
package/dist/cli/install.js
CHANGED
|
@@ -5,12 +5,14 @@ import { execSync, execFileSync } from 'node:child_process';
|
|
|
5
5
|
import { serverVersion } from '../version.js';
|
|
6
6
|
import { DEFAULT_PORT, LOG_FILE_PATH } from '../paths.js';
|
|
7
7
|
import { getServiceManager } from '../services/service-manager/index.js';
|
|
8
|
-
import {
|
|
9
|
-
import {
|
|
8
|
+
import { LINUX_UNIT_NAME, MACOS_PLIST_LABEL, WINDOWS_TASK_NAME } from '../services/service-manager/types.js';
|
|
9
|
+
import { BIN_DIR, HOOKS_DIR, SCRIPTS_DIR, getProviderInstallConfig, readConfig, writeConfig, writeInstallConfig, PROVIDER_STANDARD_MODELS, INSTALLABLE_LLM_PROVIDERS } from './config.js';
|
|
10
|
+
import { transformAgentForOpenCode, transformAgentForAgy, transformAgentForClaude } from './agent-transform.js';
|
|
10
11
|
import { FLEET_DIR } from '../paths.js';
|
|
11
12
|
import { extractWorkflowSubsystemAssets } from './workflow-assets.js';
|
|
12
13
|
import { downloadAndExtractDolt, verifyDolt } from './dolt-install.js';
|
|
13
14
|
import { classifyRunningServer, getInstallDataDir } from './install-guard.js';
|
|
15
|
+
import { convertClaudeAllowToAgyPermissions, formatAgyPermissionRules } from '../providers/agy.js';
|
|
14
16
|
const realDoltStepDeps = { downloadAndExtractDolt, verifyDolt };
|
|
15
17
|
let doltStepDeps = realDoltStepDeps;
|
|
16
18
|
/** Test-only: inject fakes for the dolt CLI install step's download/verify calls. */
|
|
@@ -26,6 +28,71 @@ function doltStepEnabled() {
|
|
|
26
28
|
return true;
|
|
27
29
|
return process.env.APRA_FLEET_ENABLE_DOLT_INSTALL === '1';
|
|
28
30
|
}
|
|
31
|
+
const FLEET_SE_MIN_NODE = [22, 16, 0];
|
|
32
|
+
function probeVersion(cmd, shell) {
|
|
33
|
+
try {
|
|
34
|
+
const out = execFileSync(cmd, ['--version'], { stdio: 'pipe', encoding: 'utf-8', timeout: 15_000, shell });
|
|
35
|
+
return String(out).trim() || null;
|
|
36
|
+
}
|
|
37
|
+
catch {
|
|
38
|
+
return null;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
// System node from PATH, NOT process.version (in SEA mode that is the embedded runtime).
|
|
42
|
+
// node/npm can be .cmd shims on Windows (nvm-windows, corporate wrappers), so both need shell:true.
|
|
43
|
+
const realFleetSePrereqProbes = {
|
|
44
|
+
nodeVersion: () => probeVersion('node', true),
|
|
45
|
+
npmVersion: () => probeVersion('npm', true),
|
|
46
|
+
};
|
|
47
|
+
let fleetSePrereqProbes = realFleetSePrereqProbes;
|
|
48
|
+
/** Test-only: the real (non-overridden) probes, to assert their exec options. */
|
|
49
|
+
export const _realFleetSePrereqProbes = realFleetSePrereqProbes;
|
|
50
|
+
/** Test-only: inject fake probes for the fleet-se prerequisite check. */
|
|
51
|
+
export function _setFleetSePrereqProbes(overrides) {
|
|
52
|
+
fleetSePrereqProbes = { ...realFleetSePrereqProbes, ...overrides };
|
|
53
|
+
}
|
|
54
|
+
/** Test-only: restore the real fleet-se prerequisite probes. */
|
|
55
|
+
export function _resetFleetSePrereqProbes() {
|
|
56
|
+
fleetSePrereqProbes = realFleetSePrereqProbes;
|
|
57
|
+
}
|
|
58
|
+
function fleetSePrereqCheckEnabled() {
|
|
59
|
+
if (process.env.NODE_ENV !== 'test')
|
|
60
|
+
return true;
|
|
61
|
+
return process.env.APRA_FLEET_ENABLE_FLEET_SE_PREREQ_CHECK === '1';
|
|
62
|
+
}
|
|
63
|
+
function nodeVersionSatisfies(raw) {
|
|
64
|
+
const m = raw.trim().replace(/^v/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
|
|
65
|
+
if (!m)
|
|
66
|
+
return false;
|
|
67
|
+
const v = [Number(m[1]), Number(m[2]), Number(m[3])];
|
|
68
|
+
for (let i = 0; i < 3; i++) {
|
|
69
|
+
if (v[i] !== FLEET_SE_MIN_NODE[i])
|
|
70
|
+
return v[i] > FLEET_SE_MIN_NODE[i];
|
|
71
|
+
}
|
|
72
|
+
return true;
|
|
73
|
+
}
|
|
74
|
+
export function checkFleetSePrereqs(probes) {
|
|
75
|
+
const missing = [];
|
|
76
|
+
const causes = [];
|
|
77
|
+
const minNode = FLEET_SE_MIN_NODE.join('.');
|
|
78
|
+
const node = probes.nodeVersion();
|
|
79
|
+
if (node === null) {
|
|
80
|
+
missing.push('node');
|
|
81
|
+
causes.push('Node.js not found on PATH');
|
|
82
|
+
}
|
|
83
|
+
else if (!nodeVersionSatisfies(node)) {
|
|
84
|
+
missing.push('node');
|
|
85
|
+
causes.push(`Node.js ${node.trim()} found, ${minNode}+ required`);
|
|
86
|
+
}
|
|
87
|
+
if (probes.npmVersion() === null) {
|
|
88
|
+
missing.push('npm');
|
|
89
|
+
causes.push('npm not found on PATH');
|
|
90
|
+
}
|
|
91
|
+
if (missing.length === 0)
|
|
92
|
+
return { ok: true, missing, message: '' };
|
|
93
|
+
const message = `${causes.join('; ')}. fleet-se requires Node.js 22.16+ and npm. Install them and re-run, or use --workflows none to install the core only.`;
|
|
94
|
+
return { ok: false, missing, message };
|
|
95
|
+
}
|
|
29
96
|
// Detect SEA mode
|
|
30
97
|
let _seaOverride = null;
|
|
31
98
|
/** Override isSea() result -- for tests only. Pass null to restore default. */
|
|
@@ -408,14 +475,6 @@ function writeAssetFile(destPath, content) {
|
|
|
408
475
|
fs.mkdirSync(path.dirname(destPath), { recursive: true });
|
|
409
476
|
fs.writeFileSync(destPath, content);
|
|
410
477
|
}
|
|
411
|
-
// Gemini CLI uses different hook event names than Claude CLI.
|
|
412
|
-
const GEMINI_HOOK_NAME_MAP = {
|
|
413
|
-
PostToolUse: 'AfterTool',
|
|
414
|
-
PreToolUse: 'BeforeTool',
|
|
415
|
-
UserPromptSubmit: 'BeforeAgent',
|
|
416
|
-
Stop: 'SessionEnd',
|
|
417
|
-
PreCompact: 'PreCompress',
|
|
418
|
-
};
|
|
419
478
|
function mergeHooksConfig(paths, hooksConfig, provider) {
|
|
420
479
|
let settingsFile = paths.settingsFile;
|
|
421
480
|
const isAgy = provider === 'agy';
|
|
@@ -436,13 +495,7 @@ function mergeHooksConfig(paths, hooksConfig, provider) {
|
|
|
436
495
|
}
|
|
437
496
|
settings.hooks = settings.hooks || {};
|
|
438
497
|
for (const [claudeName, hookEntries] of Object.entries(hooksConfig.hooks || {})) {
|
|
439
|
-
const eventName =
|
|
440
|
-
? (GEMINI_HOOK_NAME_MAP[claudeName] ?? claudeName)
|
|
441
|
-
: claudeName;
|
|
442
|
-
// Remove stale Claude-style key if we're writing under a different Gemini name.
|
|
443
|
-
if (provider === 'gemini' && claudeName in GEMINI_HOOK_NAME_MAP && claudeName !== eventName) {
|
|
444
|
-
delete settings.hooks[claudeName];
|
|
445
|
-
}
|
|
498
|
+
const eventName = claudeName;
|
|
446
499
|
settings.hooks[eventName] = settings.hooks[eventName] || [];
|
|
447
500
|
for (const newHook of hookEntries) {
|
|
448
501
|
const idx = settings.hooks[eventName].findIndex((h) => h.matcher === newHook.matcher);
|
|
@@ -462,7 +515,17 @@ function mergeHooksConfig(paths, hooksConfig, provider) {
|
|
|
462
515
|
}
|
|
463
516
|
}
|
|
464
517
|
const CLAUDE_INVALID_RULES = ['tracker_*'];
|
|
518
|
+
/** AGY validates every permissions.allow entry against this regex (verbatim
|
|
519
|
+
* from the agy CLI binary, 1.2.8) and ignores anything that fails it. */
|
|
520
|
+
const AGY_RULE_RE = /^(command|read_file|write_file|read_url|mcp|execute_url|unsandboxed)\s*\(.*\)$/;
|
|
465
521
|
export function pruneInvalidRules(allow, providerName) {
|
|
522
|
+
if (providerName === 'Antigravity') {
|
|
523
|
+
// Self-heal: strip Claude-syntax entries a previous install wrote into
|
|
524
|
+
// AGY's settings.json (mcp__apra-fleet__*, Agent(*), tracker_*, ...). AGY
|
|
525
|
+
// rejects them already, so removing them changes no effective grant -- it
|
|
526
|
+
// only stops fleet from leaving junk in a file the human user also owns.
|
|
527
|
+
return allow.filter(rule => AGY_RULE_RE.test(rule));
|
|
528
|
+
}
|
|
466
529
|
if (providerName !== 'Claude')
|
|
467
530
|
return allow;
|
|
468
531
|
return allow.filter(rule => !CLAUDE_INVALID_RULES.includes(rule));
|
|
@@ -486,7 +549,18 @@ export function buildRequiredPerms(paths) {
|
|
|
486
549
|
}
|
|
487
550
|
function mergePermissions(paths, extraPerms = []) {
|
|
488
551
|
const settings = readConfig(paths);
|
|
489
|
-
|
|
552
|
+
let requiredPerms = [...buildRequiredPerms(paths), ...extraPerms];
|
|
553
|
+
if (paths.name === 'Antigravity') {
|
|
554
|
+
// buildRequiredPerms speaks Claude's permission vocabulary. AGY accepts
|
|
555
|
+
// only `action(target)` strings from a fixed action set, so the Read(<dir>)
|
|
556
|
+
// grants are translated to read_file(<dir>) and the tokens with no AGY
|
|
557
|
+
// equivalent (mcp__apra-fleet__*, activate_skill(*), Agent(*), tracker_*)
|
|
558
|
+
// are dropped -- same "no Antigravity equivalent" handling the agent
|
|
559
|
+
// transform already applies to unsupported tools. Writing them verbatim
|
|
560
|
+
// left AGY with an allow-list it discarded wholesale, so every headless
|
|
561
|
+
// dispatch hit the auto-deny wall on its first tool call.
|
|
562
|
+
requiredPerms = formatAgyPermissionRules(convertClaudeAllowToAgyPermissions(requiredPerms));
|
|
563
|
+
}
|
|
490
564
|
settings.permissions = settings.permissions || {};
|
|
491
565
|
settings.permissions.allow = settings.permissions.allow || [];
|
|
492
566
|
settings.permissions.allow = pruneInvalidRules(settings.permissions.allow, paths.name);
|
|
@@ -521,15 +595,6 @@ function configureStatusline(paths, scriptPath, llm) {
|
|
|
521
595
|
};
|
|
522
596
|
writeConfig(paths, settings);
|
|
523
597
|
}
|
|
524
|
-
function mergeGeminiConfig(paths, mcpConfig) {
|
|
525
|
-
const settings = readConfig(paths);
|
|
526
|
-
settings.mcpServers = settings.mcpServers || {};
|
|
527
|
-
settings.mcpServers['apra-fleet'] = {
|
|
528
|
-
...mcpConfig,
|
|
529
|
-
trust: true,
|
|
530
|
-
};
|
|
531
|
-
writeConfig(paths, settings);
|
|
532
|
-
}
|
|
533
598
|
function mergeAgyConfig(paths, mcpConfig) {
|
|
534
599
|
const configDir = path.join(os.homedir(), '.gemini', 'config');
|
|
535
600
|
fs.mkdirSync(configDir, { recursive: true });
|
|
@@ -602,29 +667,47 @@ function isCommandAvailable(cmd) {
|
|
|
602
667
|
return false;
|
|
603
668
|
}
|
|
604
669
|
}
|
|
605
|
-
|
|
670
|
+
/**
|
|
671
|
+
* PIDs of every non-installer apra-fleet process currently running, as strings.
|
|
672
|
+
*
|
|
673
|
+
* OS-global on purpose -- isApraFleetRunning() is defined in terms of this, and
|
|
674
|
+
* waitForApraFleetToStop()/uninstall.ts depend on that scope. The current
|
|
675
|
+
* process is always excluded so a self-update (the installed apra-fleet binary
|
|
676
|
+
* running `install`) never sees itself.
|
|
677
|
+
*
|
|
678
|
+
* Exposed separately from the boolean so the install --force guard can tell
|
|
679
|
+
* "the SAME process is refusing to die" from "the supervisor relaunched it
|
|
680
|
+
* under a NEW pid" -- those need different remedies and different error text
|
|
681
|
+
* (see the service-aware stop note below).
|
|
682
|
+
*/
|
|
683
|
+
export function apraFleetPids() {
|
|
606
684
|
try {
|
|
685
|
+
const currentPid = process.pid.toString();
|
|
607
686
|
if (process.platform === 'win32') {
|
|
608
687
|
const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe' });
|
|
609
|
-
const currentPid = process.pid.toString();
|
|
610
688
|
// Each CSV line: "apra-fleet.exe","<PID>","..." - exclude the current installer process
|
|
611
|
-
return out.split('\n')
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
689
|
+
return out.split('\n')
|
|
690
|
+
.map(line => line.match(/"apra-fleet\.exe","(\d+)"/))
|
|
691
|
+
.filter((match) => match !== null)
|
|
692
|
+
.map(match => match[1])
|
|
693
|
+
.filter(pid => pid !== currentPid);
|
|
615
694
|
}
|
|
616
695
|
else {
|
|
617
696
|
// -x = exact name match; installer is apra-fleet-installer-* so won't match;
|
|
618
697
|
// exclude current PID to handle self-update (installed apra-fleet binary running install)
|
|
619
698
|
const out = execSync('pgrep -x apra-fleet', { encoding: 'utf-8', stdio: 'pipe' });
|
|
620
|
-
|
|
621
|
-
|
|
699
|
+
return out.split('\n')
|
|
700
|
+
.map(line => line.trim())
|
|
701
|
+
.filter(pid => pid !== '' && pid !== currentPid);
|
|
622
702
|
}
|
|
623
703
|
}
|
|
624
704
|
catch {
|
|
625
|
-
return
|
|
705
|
+
return [];
|
|
626
706
|
}
|
|
627
707
|
}
|
|
708
|
+
export function isApraFleetRunning() {
|
|
709
|
+
return apraFleetPids().length > 0;
|
|
710
|
+
}
|
|
628
711
|
export function killApraFleet(signal = 'SIGTERM') {
|
|
629
712
|
if (process.platform === 'win32') {
|
|
630
713
|
// taskkill /F is already forceful -- no softer signal to escalate from,
|
|
@@ -678,6 +761,71 @@ export async function waitForApraFleetToStop() {
|
|
|
678
761
|
await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
|
|
679
762
|
}
|
|
680
763
|
}
|
|
764
|
+
// --- install --force service-aware stop ---
|
|
765
|
+
//
|
|
766
|
+
// killApraFleet() signals the server by process NAME. When the server is
|
|
767
|
+
// registered with the platform service manager that is a race the installer
|
|
768
|
+
// cannot win: the macOS LaunchAgent this installer writes declares
|
|
769
|
+
// KeepAlive/SuccessfulExit=false (src/services/service-manager/macos.ts), so
|
|
770
|
+
// launchd relaunches the server under a NEW pid the instant a SIGKILL takes it
|
|
771
|
+
// down, and the liveness poll below then reports "still running" forever. The
|
|
772
|
+
// systemd unit's Restart=on-failure has the same shape. The remedy is to stop
|
|
773
|
+
// the SERVICE first: ServiceManager.stop() performs a graceful shutdown that
|
|
774
|
+
// exits 0, which neither supervisor restarts.
|
|
775
|
+
/**
|
|
776
|
+
* The platform ServiceManager, but only when a service is actually registered.
|
|
777
|
+
* Any failure to determine that (no systemd, unsupported platform, adapter
|
|
778
|
+
* error) is indistinguishable from "nothing registered" for the guard's
|
|
779
|
+
* purposes, so it degrades to the historical kill path rather than throwing.
|
|
780
|
+
*/
|
|
781
|
+
async function registeredServiceManager() {
|
|
782
|
+
try {
|
|
783
|
+
const mgr = await getServiceManager();
|
|
784
|
+
return (await mgr.isInstalled()) ? mgr : null;
|
|
785
|
+
}
|
|
786
|
+
catch {
|
|
787
|
+
return null;
|
|
788
|
+
}
|
|
789
|
+
}
|
|
790
|
+
/** Exact command an operator can run to bring the registered service back up. */
|
|
791
|
+
export function serviceRestartCommand() {
|
|
792
|
+
switch (process.platform) {
|
|
793
|
+
case 'win32': return `schtasks /run /tn ${WINDOWS_TASK_NAME}`;
|
|
794
|
+
case 'linux': return `systemctl --user start ${LINUX_UNIT_NAME}`;
|
|
795
|
+
case 'darwin': return `launchctl kickstart -k gui/${macosGuiUid()}/${MACOS_PLIST_LABEL}`;
|
|
796
|
+
default: return 'apra-fleet install';
|
|
797
|
+
}
|
|
798
|
+
}
|
|
799
|
+
/** Exact command an operator can run to take the registered service down. */
|
|
800
|
+
export function serviceStopCommand() {
|
|
801
|
+
switch (process.platform) {
|
|
802
|
+
case 'win32': return `schtasks /end /tn ${WINDOWS_TASK_NAME}`;
|
|
803
|
+
case 'linux': return `systemctl --user stop ${LINUX_UNIT_NAME}`;
|
|
804
|
+
case 'darwin': return `launchctl bootout gui/${macosGuiUid()}/${MACOS_PLIST_LABEL}`;
|
|
805
|
+
default: return 'apra-fleet uninstall';
|
|
806
|
+
}
|
|
807
|
+
}
|
|
808
|
+
// Resolved in JS, never left to shell expansion: the printed command must be
|
|
809
|
+
// copy-pasteable as-is (mirrors getUid() in service-manager/macos.ts).
|
|
810
|
+
function macosGuiUid() {
|
|
811
|
+
return typeof process.getuid === 'function' ? String(process.getuid()) : '501';
|
|
812
|
+
}
|
|
813
|
+
/**
|
|
814
|
+
* Poll for the server to disappear after ServiceManager.stop(), WITHOUT
|
|
815
|
+
* signalling it -- signalling is exactly what loses the race against a
|
|
816
|
+
* supervisor relaunch. Returns the pids still observed once the window closes
|
|
817
|
+
* (empty when the service is down).
|
|
818
|
+
*/
|
|
819
|
+
async function waitForServiceStop() {
|
|
820
|
+
const { pollIntervalMs, graceMs } = installForceTiming();
|
|
821
|
+
const deadline = Date.now() + graceMs;
|
|
822
|
+
let pids = apraFleetPids();
|
|
823
|
+
while (pids.length > 0 && Date.now() < deadline) {
|
|
824
|
+
await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
|
|
825
|
+
pids = apraFleetPids();
|
|
826
|
+
}
|
|
827
|
+
return pids;
|
|
828
|
+
}
|
|
681
829
|
/**
|
|
682
830
|
* Write empty .ignore overlay files into a LOCAL agy member's workspace to block
|
|
683
831
|
* the global apra-fleet MCP server and PM/fleet skills from loading inside that
|
|
@@ -736,16 +884,14 @@ Usage:
|
|
|
736
884
|
apra-fleet install --no-skill Same as --skill none
|
|
737
885
|
apra-fleet install --workflows none Skip installing the workflow runtime + built-in workflows
|
|
738
886
|
apra-fleet install --force Stop a running server before installing
|
|
739
|
-
apra-fleet install --llm <provider> Target LLM provider: claude (default),
|
|
887
|
+
apra-fleet install --llm <provider> Target LLM provider: claude (default), codex, copilot, agy, opencode
|
|
740
888
|
apra-fleet install --transport http Register MCP server with HTTP transport (default)
|
|
741
889
|
apra-fleet install --transport stdio Register MCP server with stdio transport (legacy)
|
|
742
890
|
apra-fleet install --help Show this help
|
|
743
891
|
|
|
744
892
|
Options:
|
|
745
|
-
--llm <provider> LLM provider to configure. Supported: claude,
|
|
746
|
-
Defaults to claude.
|
|
747
|
-
dispatch -- Gemini does not support background agents, so fleet operations
|
|
748
|
-
run sequentially rather than in parallel.
|
|
893
|
+
--llm <provider> LLM provider to configure. Supported: claude, codex, copilot, agy, opencode.
|
|
894
|
+
Defaults to claude.
|
|
749
895
|
--transport <mode> MCP transport to use: http (default) or stdio. HTTP uses the singleton
|
|
750
896
|
fleet server at http://localhost:7523/mcp. stdio runs fleet as a subprocess.
|
|
751
897
|
--skill <mode> Which skills to install: all (default), fleet, pm, or none.
|
|
@@ -753,6 +899,7 @@ Options:
|
|
|
753
899
|
--workflows <mode> Which workflow assets to install: all (default) or none. Installs
|
|
754
900
|
~/.apra-fleet/node_modules (workflow runtime), /schemas (agent role
|
|
755
901
|
schemas), and /workflows/{fleet-sprint,hello-world} (built-in workflows).
|
|
902
|
+
fleet-se requires Node.js 22.16+ and npm.
|
|
756
903
|
--force Stop a running apra-fleet server before installing (SEA mode only).`);
|
|
757
904
|
process.exit(0);
|
|
758
905
|
return;
|
|
@@ -769,7 +916,7 @@ Options:
|
|
|
769
916
|
llm = args[idx + 1];
|
|
770
917
|
}
|
|
771
918
|
}
|
|
772
|
-
const supported =
|
|
919
|
+
const supported = INSTALLABLE_LLM_PROVIDERS;
|
|
773
920
|
if (!supported.includes(llm)) {
|
|
774
921
|
console.error(`Error: Unsupported LLM provider "${llm}". Supported: ${supported.join(', ')}`);
|
|
775
922
|
process.exit(1);
|
|
@@ -873,6 +1020,14 @@ Options:
|
|
|
873
1020
|
const installPm = skillMode === 'pm' || skillMode === 'all';
|
|
874
1021
|
const installAgents = installPm && paths.agentsDir !== undefined;
|
|
875
1022
|
const installWorkflows = workflowsMode === 'all';
|
|
1023
|
+
// fleet-se prerequisites: fail before the running-process guard so nothing is stopped or written.
|
|
1024
|
+
if (installWorkflows && fleetSePrereqCheckEnabled()) {
|
|
1025
|
+
const prereq = checkFleetSePrereqs(fleetSePrereqProbes);
|
|
1026
|
+
if (!prereq.ok) {
|
|
1027
|
+
console.error(`Error: ${prereq.message}`);
|
|
1028
|
+
process.exit(1);
|
|
1029
|
+
}
|
|
1030
|
+
}
|
|
876
1031
|
const serviceStep = isSea() && transport === 'http';
|
|
877
1032
|
let totalSteps = (installFleet && installPm) ? 8 : installFleet ? 7 : installPm ? 8 : 6;
|
|
878
1033
|
if (installAgents)
|
|
@@ -885,9 +1040,6 @@ Options:
|
|
|
885
1040
|
totalSteps++; // KB + code intelligence setup -- unconditional, runs after Beads
|
|
886
1041
|
if (serviceStep)
|
|
887
1042
|
totalSteps++;
|
|
888
|
-
if (llm === 'gemini' && (installFleet || installPm)) {
|
|
889
|
-
console.warn(`\n- Note: Gemini does not support background agents. If you plan to use Gemini as the\n PM/orchestrator, fleet operations will run sequentially (no parallel dispatch).\n For best orchestration performance, consider using Claude. See docs for details.\n`);
|
|
890
|
-
}
|
|
891
1043
|
// --- Running-process guard (SEA + npm modes -- dev mode runs via node, not a managed binary) ---
|
|
892
1044
|
//
|
|
893
1045
|
// isApraFleetRunning() is OS-global on purpose (waitForApraFleetToStop() and
|
|
@@ -903,6 +1055,10 @@ Options:
|
|
|
903
1055
|
if (runningScope && !runningScope.relevant) {
|
|
904
1056
|
console.log(`\n Note: an unrelated apra-fleet server is running -- ${runningScope.detail}.\n It is not associated with this install (data dir ${getInstallDataDir()}, prefix ${BIN_DIR}), so it is left running.\n`);
|
|
905
1057
|
}
|
|
1058
|
+
// Set when the --force guard below stopped a REGISTERED service, so the
|
|
1059
|
+
// binary-copy step can bring it back up instead of leaving it down.
|
|
1060
|
+
let guardServiceMgr = null;
|
|
1061
|
+
let guardStoppedService = false;
|
|
906
1062
|
if (runningScope?.relevant) {
|
|
907
1063
|
if (!force) {
|
|
908
1064
|
const killHint = process.platform === 'win32'
|
|
@@ -920,9 +1076,49 @@ ${killHint}
|
|
|
920
1076
|
`);
|
|
921
1077
|
process.exit(1);
|
|
922
1078
|
}
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
|
|
1079
|
+
// Snapshot BEFORE anything is stopped: a pid that is present afterwards but
|
|
1080
|
+
// absent here is a supervisor relaunch, not a process refusing to die.
|
|
1081
|
+
const pidsBeforeStop = apraFleetPids();
|
|
1082
|
+
guardServiceMgr = await registeredServiceManager();
|
|
1083
|
+
if (guardServiceMgr) {
|
|
1084
|
+
// A service is registered: stop the SERVICE, never pkill first.
|
|
1085
|
+
console.log(' Registered service detected -- stopping it through the service manager.');
|
|
1086
|
+
try {
|
|
1087
|
+
await guardServiceMgr.stop();
|
|
1088
|
+
guardStoppedService = true;
|
|
1089
|
+
}
|
|
1090
|
+
catch (err) {
|
|
1091
|
+
console.warn(` Service stop failed: ${err.message}`);
|
|
1092
|
+
}
|
|
1093
|
+
const stillUp = await waitForServiceStop();
|
|
1094
|
+
// Escalate ONLY when the very same pids are still there -- i.e. nothing
|
|
1095
|
+
// relaunched the server and there is no supervisor race to lose. If a NEW
|
|
1096
|
+
// pid appeared, signalling by name is futile and is deliberately skipped
|
|
1097
|
+
// so the relaunch is reported instead of retried forever.
|
|
1098
|
+
if (stillUp.length > 0 && stillUp.every(pid => pidsBeforeStop.includes(pid))) {
|
|
1099
|
+
killApraFleet();
|
|
1100
|
+
await waitForApraFleetToStop();
|
|
1101
|
+
}
|
|
1102
|
+
}
|
|
1103
|
+
else {
|
|
1104
|
+
// No service registered: historical path, unchanged.
|
|
1105
|
+
killApraFleet();
|
|
1106
|
+
await waitForApraFleetToStop();
|
|
1107
|
+
}
|
|
1108
|
+
const pidsAfterStop = apraFleetPids();
|
|
1109
|
+
if (pidsAfterStop.length > 0) {
|
|
1110
|
+
const relaunchedPids = pidsAfterStop.filter(pid => !pidsBeforeStop.includes(pid));
|
|
1111
|
+
if (relaunchedPids.length > 0) {
|
|
1112
|
+
console.error(`
|
|
1113
|
+
Error: the apra-fleet server was RELAUNCHED by its service supervisor while
|
|
1114
|
+
install --force was stopping it -- the observed pid changed between polls (was
|
|
1115
|
+
${pidsBeforeStop.join(', ') || 'none'}, now ${pidsAfterStop.join(', ')}), so it did not merely refuse to die.
|
|
1116
|
+
Signalling the process by name cannot win that race. Stop the service itself,
|
|
1117
|
+
then re-run the install:
|
|
1118
|
+
${serviceStopCommand()}
|
|
1119
|
+
`);
|
|
1120
|
+
process.exit(1);
|
|
1121
|
+
}
|
|
926
1122
|
console.error(`
|
|
927
1123
|
Error: could not stop the running apra-fleet server (it is still running after
|
|
928
1124
|
SIGTERM and a SIGKILL escalation). Stop it manually before installing:
|
|
@@ -952,6 +1148,25 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
952
1148
|
else {
|
|
953
1149
|
console.log(` [1/${totalSteps}] Dev mode -- skipping binary copy`);
|
|
954
1150
|
}
|
|
1151
|
+
// A registered service that the --force guard stopped must never be left
|
|
1152
|
+
// permanently down. When serviceStep is set the final install step
|
|
1153
|
+
// re-registers and starts it, so restarting here would only add a redundant
|
|
1154
|
+
// bootout/bootstrap cycle mid-install; otherwise nothing else would ever
|
|
1155
|
+
// bring it back, so start it now that the new binary is in place. Either way
|
|
1156
|
+
// the exact restart command is printed, so a failure at any later step stays
|
|
1157
|
+
// recoverable by hand.
|
|
1158
|
+
if (guardStoppedService && guardServiceMgr) {
|
|
1159
|
+
console.log(` The registered service was stopped by --force. Restart command: ${serviceRestartCommand()}`);
|
|
1160
|
+
if (!serviceStep) {
|
|
1161
|
+
try {
|
|
1162
|
+
await guardServiceMgr.start();
|
|
1163
|
+
console.log(' Restarted the registered service.');
|
|
1164
|
+
}
|
|
1165
|
+
catch (err) {
|
|
1166
|
+
console.warn(` [WARN] Could not restart the registered service: ${err.message}`);
|
|
1167
|
+
}
|
|
1168
|
+
}
|
|
1169
|
+
}
|
|
955
1170
|
// --- Step 2: Extract hooks ---
|
|
956
1171
|
console.log(` [2/${totalSteps}] Installing hooks...`);
|
|
957
1172
|
const manifest = loadManifest();
|
|
@@ -1004,9 +1219,6 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1004
1219
|
run(`claude mcp add --scope user --transport http apra-fleet ${fleetUrl}`);
|
|
1005
1220
|
}
|
|
1006
1221
|
}
|
|
1007
|
-
else if (llm === 'gemini') {
|
|
1008
|
-
mergeGeminiConfig(paths, { httpUrl: fleetUrl });
|
|
1009
|
-
}
|
|
1010
1222
|
else if (llm === 'codex') {
|
|
1011
1223
|
mergeCodexConfig(paths, { url: fleetUrl });
|
|
1012
1224
|
}
|
|
@@ -1048,9 +1260,6 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1048
1260
|
run(cmd);
|
|
1049
1261
|
}
|
|
1050
1262
|
}
|
|
1051
|
-
else if (llm === 'gemini') {
|
|
1052
|
-
mergeGeminiConfig(paths, mcpConfig);
|
|
1053
|
-
}
|
|
1054
1263
|
else if (llm === 'codex') {
|
|
1055
1264
|
mergeCodexConfig(paths, mcpConfig);
|
|
1056
1265
|
}
|
|
@@ -1282,11 +1491,15 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1282
1491
|
// as a fallback), preserving this branch's no-dist/agents rule, and it
|
|
1283
1492
|
// recurses into _shared/ and schemas/ which the old flat readdir missed.
|
|
1284
1493
|
for (const { relPath, content: rawContent } of loadAgentAssets()) {
|
|
1494
|
+
// Every branch runs a transform -- the default one is NOT a passthrough. Claude
|
|
1495
|
+
// keeps the source frontmatter and every conditional's if-branch, but the
|
|
1496
|
+
// conditional markers themselves still have to be stripped or they ship
|
|
1497
|
+
// verbatim into the installed agent file (apra-fleet-oomh.1).
|
|
1285
1498
|
const content = llm === 'opencode'
|
|
1286
1499
|
? transformAgentForOpenCode(rawContent, relPath)
|
|
1287
1500
|
: llm === 'agy'
|
|
1288
1501
|
? transformAgentForAgy(rawContent, relPath)
|
|
1289
|
-
: rawContent;
|
|
1502
|
+
: transformAgentForClaude(rawContent, relPath);
|
|
1290
1503
|
writeAssetFile(path.join(agentsDestDir, relPath), content);
|
|
1291
1504
|
}
|
|
1292
1505
|
}
|
|
@@ -1357,7 +1570,9 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1357
1570
|
}
|
|
1358
1571
|
catch {
|
|
1359
1572
|
// not installed - install it
|
|
1360
|
-
|
|
1573
|
+
// apra-fleet-4ipl: bumped 1.1.2 -> 1.3.0 to match .github/workflows/ci.yml's
|
|
1574
|
+
// pin -- see that file's comment for why (schema v66 compatibility).
|
|
1575
|
+
execFileSync('npm', ['install', '-g', '@beads/bd@1.3.0'], { stdio: 'inherit', shell: true });
|
|
1361
1576
|
}
|
|
1362
1577
|
}
|
|
1363
1578
|
catch (err) {
|
|
@@ -1431,25 +1646,43 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1431
1646
|
writeInstallConfig(llm, skillMode, workflowsMode);
|
|
1432
1647
|
// --- Step N: Register and start service (SEA + HTTP mode only) ---
|
|
1433
1648
|
let serviceRegistered = false;
|
|
1649
|
+
let serviceReused = false;
|
|
1434
1650
|
if (serviceStep) {
|
|
1435
1651
|
console.log(` [${totalSteps}/${totalSteps}] Registering and starting service...`);
|
|
1436
1652
|
const svcMgr = await getServiceManager();
|
|
1437
1653
|
try {
|
|
1438
|
-
await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH);
|
|
1654
|
+
serviceReused = (await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH)) === 'reused';
|
|
1655
|
+
if (serviceReused)
|
|
1656
|
+
console.log(' Could not recreate the service task -- existing task reused.');
|
|
1439
1657
|
try {
|
|
1440
1658
|
await svcMgr.start();
|
|
1441
1659
|
serviceRegistered = true;
|
|
1442
1660
|
}
|
|
1443
1661
|
catch (startErr) {
|
|
1444
|
-
|
|
1445
|
-
|
|
1662
|
+
// Never delete a reused task: it predates this install (e.g. elevated).
|
|
1663
|
+
if (!serviceReused) {
|
|
1664
|
+
try {
|
|
1665
|
+
await svcMgr.unregister();
|
|
1666
|
+
}
|
|
1667
|
+
catch { }
|
|
1446
1668
|
}
|
|
1447
|
-
catch { }
|
|
1448
1669
|
throw startErr;
|
|
1449
1670
|
}
|
|
1450
1671
|
}
|
|
1451
1672
|
catch (err) {
|
|
1452
1673
|
console.warn(` Service registration skipped: ${err.message}`);
|
|
1674
|
+
// --force stopped the server; reporting success would leave it down silently.
|
|
1675
|
+
if (force && (runningScope?.relevant || guardStoppedService)) {
|
|
1676
|
+
const restartHint = guardStoppedService
|
|
1677
|
+
? `Start it with:\n ${serviceRestartCommand()}\nor re-run the install from an elevated prompt.`
|
|
1678
|
+
: 'Start it with:\n apra-fleet start';
|
|
1679
|
+
console.error(`
|
|
1680
|
+
Error: install --force stopped the running apra-fleet server, but the service
|
|
1681
|
+
could not be registered/started, so the server is NOT running.
|
|
1682
|
+
${restartHint}
|
|
1683
|
+
`);
|
|
1684
|
+
process.exit(1);
|
|
1685
|
+
}
|
|
1453
1686
|
}
|
|
1454
1687
|
}
|
|
1455
1688
|
// --- Done ---
|
|
@@ -1464,7 +1697,7 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1464
1697
|
const clientName = llm === 'claude' ? 'Claude Code' : paths.name;
|
|
1465
1698
|
const instructions = llm === 'claude' ? 'Run /mcp in Claude Code to load the server.' : `Restart ${paths.name} to load the server.`;
|
|
1466
1699
|
const forceNote = force ? `\nRestart ${clientName} to reload the MCP server.` : '';
|
|
1467
|
-
const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ?
|
|
1700
|
+
const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ? `registered and running${serviceReused ? ' (existing task reused)' : ''}` : 'registration skipped'}` : '';
|
|
1468
1701
|
console.log(`
|
|
1469
1702
|
Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
|
|
1470
1703
|
Binary: ${BIN_DIR}
|