@apralabs/apra-fleet 0.4.2 → 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 +38 -5
- package/dist/agents/backlog-groomer.md +25 -0
- package/dist/agents/ci-watcher.md +11 -0
- package/dist/agents/deployer.md +37 -2
- package/dist/agents/doer.md +36 -12
- package/dist/agents/harvester.md +11 -0
- package/dist/agents/integ-test-runner.md +11 -0
- package/dist/agents/kb-reconciler.md +9 -0
- package/dist/agents/plan-reviewer.md +110 -22
- package/dist/agents/planner.md +125 -37
- package/dist/agents/regression-test-runner.md +11 -0
- package/dist/agents/reviewer.md +13 -2
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- 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 +28 -9
- 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 -34
- 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 +290 -23
- 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 +6 -2
- package/dist/cli/register-member.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/linux.d.ts +6 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +35 -2
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +61 -2
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows-gitbash.d.ts +5 -0
- package/dist/os/windows-gitbash.d.ts.map +1 -1
- package/dist/os/windows-gitbash.js +15 -0
- package/dist/os/windows-gitbash.js.map +1 -1
- package/dist/os/windows.d.ts +6 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +46 -3
- package/dist/os/windows.js.map +1 -1
- package/dist/providers/agy.d.ts +115 -6
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +569 -53
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +81 -3
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +344 -10
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +19 -2
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +20 -2
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.d.ts.map +1 -1
- package/dist/providers/none.js +17 -2
- package/dist/providers/none.js.map +1 -1
- package/dist/providers/opencode.d.ts +3 -1
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +22 -2
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +201 -6
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +56 -0
- package/dist/providers/provider.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/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/credential-cleanup.d.ts.map +1 -1
- package/dist/services/credential-cleanup.js +35 -17
- 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/model-pricing.d.ts.map +1 -1
- package/dist/services/model-pricing.js +7 -3
- package/dist/services/model-pricing.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/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +58 -2
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/read-log-tail.d.ts.map +1 -1
- package/dist/services/stall/read-log-tail.js +20 -10
- 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/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +79 -2
- 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/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.d.ts.map +1 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/azure-devops.js.map +1 -1
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +18 -0
- package/dist/skills/pm/SKILL.md +1 -1
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- 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 +2 -0
- package/dist/tools/check-status.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 +182 -34
- 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 +31 -20
- 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 +1196 -892
- 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 +1 -0
- 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 +17 -0
- 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 +61 -20
- package/dist/tools/member-reservation.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 +142 -54
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +91 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +12 -9
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +99 -12
- 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 +27 -2
- package/dist/tools/remove-member.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/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/update-member.d.ts +12 -9
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +43 -11
- 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 +13 -0
- package/dist/types.d.ts.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/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 +87 -1
- package/dist/utils/workspace-trust.js.map +1 -1
- package/dist/workflows/auto-sprint.js +176 -15
- package/package.json +6 -4
- package/packages/apra-fleet-client/src/client/api.mjs +319 -17
- 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 +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +11 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +37 -2
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +36 -12
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +11 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +11 -0
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +9 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +110 -22
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +125 -37
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +11 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +13 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/bin/cli.mjs +149 -1
- package/packages/apra-fleet-se/bin/serve.mjs +78 -4
- 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 +61 -14
- 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 +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +276 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +996 -32
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +267 -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 +1467 -9798
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +17 -12
- 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 +18 -0
- 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 +153 -19
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +71 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +131 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +140 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +77 -2
- 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 +17 -6
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +49 -7
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +5 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
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. */
|
|
@@ -448,7 +515,17 @@ function mergeHooksConfig(paths, hooksConfig, provider) {
|
|
|
448
515
|
}
|
|
449
516
|
}
|
|
450
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*\(.*\)$/;
|
|
451
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
|
+
}
|
|
452
529
|
if (providerName !== 'Claude')
|
|
453
530
|
return allow;
|
|
454
531
|
return allow.filter(rule => !CLAUDE_INVALID_RULES.includes(rule));
|
|
@@ -472,7 +549,18 @@ export function buildRequiredPerms(paths) {
|
|
|
472
549
|
}
|
|
473
550
|
function mergePermissions(paths, extraPerms = []) {
|
|
474
551
|
const settings = readConfig(paths);
|
|
475
|
-
|
|
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
|
+
}
|
|
476
564
|
settings.permissions = settings.permissions || {};
|
|
477
565
|
settings.permissions.allow = settings.permissions.allow || [];
|
|
478
566
|
settings.permissions.allow = pruneInvalidRules(settings.permissions.allow, paths.name);
|
|
@@ -579,29 +667,47 @@ function isCommandAvailable(cmd) {
|
|
|
579
667
|
return false;
|
|
580
668
|
}
|
|
581
669
|
}
|
|
582
|
-
|
|
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() {
|
|
583
684
|
try {
|
|
685
|
+
const currentPid = process.pid.toString();
|
|
584
686
|
if (process.platform === 'win32') {
|
|
585
687
|
const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe' });
|
|
586
|
-
const currentPid = process.pid.toString();
|
|
587
688
|
// Each CSV line: "apra-fleet.exe","<PID>","..." - exclude the current installer process
|
|
588
|
-
return out.split('\n')
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
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);
|
|
592
694
|
}
|
|
593
695
|
else {
|
|
594
696
|
// -x = exact name match; installer is apra-fleet-installer-* so won't match;
|
|
595
697
|
// exclude current PID to handle self-update (installed apra-fleet binary running install)
|
|
596
698
|
const out = execSync('pgrep -x apra-fleet', { encoding: 'utf-8', stdio: 'pipe' });
|
|
597
|
-
|
|
598
|
-
|
|
699
|
+
return out.split('\n')
|
|
700
|
+
.map(line => line.trim())
|
|
701
|
+
.filter(pid => pid !== '' && pid !== currentPid);
|
|
599
702
|
}
|
|
600
703
|
}
|
|
601
704
|
catch {
|
|
602
|
-
return
|
|
705
|
+
return [];
|
|
603
706
|
}
|
|
604
707
|
}
|
|
708
|
+
export function isApraFleetRunning() {
|
|
709
|
+
return apraFleetPids().length > 0;
|
|
710
|
+
}
|
|
605
711
|
export function killApraFleet(signal = 'SIGTERM') {
|
|
606
712
|
if (process.platform === 'win32') {
|
|
607
713
|
// taskkill /F is already forceful -- no softer signal to escalate from,
|
|
@@ -655,6 +761,71 @@ export async function waitForApraFleetToStop() {
|
|
|
655
761
|
await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
|
|
656
762
|
}
|
|
657
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
|
+
}
|
|
658
829
|
/**
|
|
659
830
|
* Write empty .ignore overlay files into a LOCAL agy member's workspace to block
|
|
660
831
|
* the global apra-fleet MCP server and PM/fleet skills from loading inside that
|
|
@@ -728,6 +899,7 @@ Options:
|
|
|
728
899
|
--workflows <mode> Which workflow assets to install: all (default) or none. Installs
|
|
729
900
|
~/.apra-fleet/node_modules (workflow runtime), /schemas (agent role
|
|
730
901
|
schemas), and /workflows/{fleet-sprint,hello-world} (built-in workflows).
|
|
902
|
+
fleet-se requires Node.js 22.16+ and npm.
|
|
731
903
|
--force Stop a running apra-fleet server before installing (SEA mode only).`);
|
|
732
904
|
process.exit(0);
|
|
733
905
|
return;
|
|
@@ -744,7 +916,7 @@ Options:
|
|
|
744
916
|
llm = args[idx + 1];
|
|
745
917
|
}
|
|
746
918
|
}
|
|
747
|
-
const supported =
|
|
919
|
+
const supported = INSTALLABLE_LLM_PROVIDERS;
|
|
748
920
|
if (!supported.includes(llm)) {
|
|
749
921
|
console.error(`Error: Unsupported LLM provider "${llm}". Supported: ${supported.join(', ')}`);
|
|
750
922
|
process.exit(1);
|
|
@@ -848,6 +1020,14 @@ Options:
|
|
|
848
1020
|
const installPm = skillMode === 'pm' || skillMode === 'all';
|
|
849
1021
|
const installAgents = installPm && paths.agentsDir !== undefined;
|
|
850
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
|
+
}
|
|
851
1031
|
const serviceStep = isSea() && transport === 'http';
|
|
852
1032
|
let totalSteps = (installFleet && installPm) ? 8 : installFleet ? 7 : installPm ? 8 : 6;
|
|
853
1033
|
if (installAgents)
|
|
@@ -875,6 +1055,10 @@ Options:
|
|
|
875
1055
|
if (runningScope && !runningScope.relevant) {
|
|
876
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`);
|
|
877
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;
|
|
878
1062
|
if (runningScope?.relevant) {
|
|
879
1063
|
if (!force) {
|
|
880
1064
|
const killHint = process.platform === 'win32'
|
|
@@ -892,9 +1076,49 @@ ${killHint}
|
|
|
892
1076
|
`);
|
|
893
1077
|
process.exit(1);
|
|
894
1078
|
}
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
|
|
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
|
+
}
|
|
898
1122
|
console.error(`
|
|
899
1123
|
Error: could not stop the running apra-fleet server (it is still running after
|
|
900
1124
|
SIGTERM and a SIGKILL escalation). Stop it manually before installing:
|
|
@@ -924,6 +1148,25 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
924
1148
|
else {
|
|
925
1149
|
console.log(` [1/${totalSteps}] Dev mode -- skipping binary copy`);
|
|
926
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
|
+
}
|
|
927
1170
|
// --- Step 2: Extract hooks ---
|
|
928
1171
|
console.log(` [2/${totalSteps}] Installing hooks...`);
|
|
929
1172
|
const manifest = loadManifest();
|
|
@@ -1248,11 +1491,15 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1248
1491
|
// as a fallback), preserving this branch's no-dist/agents rule, and it
|
|
1249
1492
|
// recurses into _shared/ and schemas/ which the old flat readdir missed.
|
|
1250
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).
|
|
1251
1498
|
const content = llm === 'opencode'
|
|
1252
1499
|
? transformAgentForOpenCode(rawContent, relPath)
|
|
1253
1500
|
: llm === 'agy'
|
|
1254
1501
|
? transformAgentForAgy(rawContent, relPath)
|
|
1255
|
-
: rawContent;
|
|
1502
|
+
: transformAgentForClaude(rawContent, relPath);
|
|
1256
1503
|
writeAssetFile(path.join(agentsDestDir, relPath), content);
|
|
1257
1504
|
}
|
|
1258
1505
|
}
|
|
@@ -1323,7 +1570,9 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1323
1570
|
}
|
|
1324
1571
|
catch {
|
|
1325
1572
|
// not installed - install it
|
|
1326
|
-
|
|
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 });
|
|
1327
1576
|
}
|
|
1328
1577
|
}
|
|
1329
1578
|
catch (err) {
|
|
@@ -1397,25 +1646,43 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1397
1646
|
writeInstallConfig(llm, skillMode, workflowsMode);
|
|
1398
1647
|
// --- Step N: Register and start service (SEA + HTTP mode only) ---
|
|
1399
1648
|
let serviceRegistered = false;
|
|
1649
|
+
let serviceReused = false;
|
|
1400
1650
|
if (serviceStep) {
|
|
1401
1651
|
console.log(` [${totalSteps}/${totalSteps}] Registering and starting service...`);
|
|
1402
1652
|
const svcMgr = await getServiceManager();
|
|
1403
1653
|
try {
|
|
1404
|
-
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.');
|
|
1405
1657
|
try {
|
|
1406
1658
|
await svcMgr.start();
|
|
1407
1659
|
serviceRegistered = true;
|
|
1408
1660
|
}
|
|
1409
1661
|
catch (startErr) {
|
|
1410
|
-
|
|
1411
|
-
|
|
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 { }
|
|
1412
1668
|
}
|
|
1413
|
-
catch { }
|
|
1414
1669
|
throw startErr;
|
|
1415
1670
|
}
|
|
1416
1671
|
}
|
|
1417
1672
|
catch (err) {
|
|
1418
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
|
+
}
|
|
1419
1686
|
}
|
|
1420
1687
|
}
|
|
1421
1688
|
// --- Done ---
|
|
@@ -1430,7 +1697,7 @@ ${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pki
|
|
|
1430
1697
|
const clientName = llm === 'claude' ? 'Claude Code' : paths.name;
|
|
1431
1698
|
const instructions = llm === 'claude' ? 'Run /mcp in Claude Code to load the server.' : `Restart ${paths.name} to load the server.`;
|
|
1432
1699
|
const forceNote = force ? `\nRestart ${clientName} to reload the MCP server.` : '';
|
|
1433
|
-
const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ?
|
|
1700
|
+
const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ? `registered and running${serviceReused ? ' (existing task reused)' : ''}` : 'registration skipped'}` : '';
|
|
1434
1701
|
console.log(`
|
|
1435
1702
|
Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
|
|
1436
1703
|
Binary: ${BIN_DIR}
|