@apralabs/apra-fleet 0.3.6 → 0.4.0
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 +245 -257
- package/dist/agents/backlog-groomer.md +287 -0
- package/dist/agents/deployer.md +52 -11
- package/dist/agents/doer.md +32 -7
- package/dist/agents/integ-test-runner.md +151 -61
- package/dist/agents/plan-reviewer.md +74 -17
- package/dist/agents/planner.md +94 -14
- package/dist/agents/regression-test-runner.md +216 -0
- package/dist/agents/reviewer.md +21 -6
- package/dist/agents/schemas/backlog-groomer-input.json +35 -0
- package/dist/agents/schemas/backlog-groomer-output.json +164 -0
- package/dist/agents/schemas/integ-test-runner-output.json +34 -0
- package/dist/agents/schemas/regression-test-runner-input.json +15 -0
- package/dist/agents/schemas/regression-test-runner-output.json +50 -0
- package/dist/agents/schemas/reviewer-output.json +4 -0
- package/dist/cli/agent-transform.d.ts +1 -0
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +77 -0
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts +3 -0
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +181 -5
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +5 -1
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +7 -1
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/dolt-install.d.ts +91 -0
- package/dist/cli/dolt-install.d.ts.map +1 -0
- package/dist/cli/dolt-install.js +334 -0
- package/dist/cli/dolt-install.js.map +1 -0
- package/dist/cli/install-guard.d.ts +29 -0
- package/dist/cli/install-guard.d.ts.map +1 -0
- package/dist/cli/install-guard.js +153 -0
- package/dist/cli/install-guard.js.map +1 -0
- package/dist/cli/install.d.ts +44 -3
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +604 -108
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/join.d.ts +12 -0
- package/dist/cli/join.d.ts.map +1 -0
- package/dist/cli/join.js +87 -0
- package/dist/cli/join.js.map +1 -0
- package/dist/cli/register-member.d.ts +2 -0
- package/dist/cli/register-member.d.ts.map +1 -0
- package/dist/cli/register-member.js +193 -0
- package/dist/cli/register-member.js.map +1 -0
- package/dist/cli/restart.d.ts +2 -0
- package/dist/cli/restart.d.ts.map +1 -0
- package/dist/cli/restart.js +7 -0
- package/dist/cli/restart.js.map +1 -0
- package/dist/cli/spoke.d.ts +35 -0
- package/dist/cli/spoke.d.ts.map +1 -0
- package/dist/cli/spoke.js +212 -0
- package/dist/cli/spoke.js.map +1 -0
- package/dist/cli/start.d.ts +2 -0
- package/dist/cli/start.d.ts.map +1 -0
- package/dist/cli/start.js +92 -0
- package/dist/cli/start.js.map +1 -0
- package/dist/cli/status.d.ts +2 -0
- package/dist/cli/status.d.ts.map +1 -0
- package/dist/cli/status.js +83 -0
- package/dist/cli/status.js.map +1 -0
- package/dist/cli/stop.d.ts +2 -0
- package/dist/cli/stop.d.ts.map +1 -0
- package/dist/cli/stop.js +51 -0
- package/dist/cli/stop.js.map +1 -0
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +109 -9
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/update.d.ts.map +1 -1
- package/dist/cli/update.js +10 -1
- package/dist/cli/update.js.map +1 -1
- package/dist/cli/workflow-assets.d.ts +37 -0
- package/dist/cli/workflow-assets.d.ts.map +1 -0
- package/dist/cli/workflow-assets.js +144 -0
- package/dist/cli/workflow-assets.js.map +1 -0
- package/dist/cli/workflow.d.ts +75 -0
- package/dist/cli/workflow.d.ts.map +1 -0
- package/dist/cli/workflow.js +397 -0
- package/dist/cli/workflow.js.map +1 -0
- package/dist/hub-service/activity.d.ts +30 -0
- package/dist/hub-service/activity.d.ts.map +1 -0
- package/dist/hub-service/activity.js +20 -0
- package/dist/hub-service/activity.js.map +1 -0
- package/dist/hub-service/audit-log.d.ts +19 -0
- package/dist/hub-service/audit-log.d.ts.map +1 -0
- package/dist/hub-service/audit-log.js +13 -0
- package/dist/hub-service/audit-log.js.map +1 -0
- package/dist/hub-service/db/pool.d.ts +19 -0
- package/dist/hub-service/db/pool.d.ts.map +1 -0
- package/dist/hub-service/db/pool.js +53 -0
- package/dist/hub-service/db/pool.js.map +1 -0
- package/dist/hub-service/enrollment.d.ts +29 -0
- package/dist/hub-service/enrollment.d.ts.map +1 -0
- package/dist/hub-service/enrollment.js +48 -0
- package/dist/hub-service/enrollment.js.map +1 -0
- package/dist/hub-service/envelope-routes.d.ts +46 -0
- package/dist/hub-service/envelope-routes.d.ts.map +1 -0
- package/dist/hub-service/envelope-routes.js +94 -0
- package/dist/hub-service/envelope-routes.js.map +1 -0
- package/dist/hub-service/handlers/installers.d.ts +14 -0
- package/dist/hub-service/handlers/installers.d.ts.map +1 -0
- package/dist/hub-service/handlers/installers.js +8 -0
- package/dist/hub-service/handlers/installers.js.map +1 -0
- package/dist/hub-service/http-server.d.ts +31 -0
- package/dist/hub-service/http-server.d.ts.map +1 -0
- package/dist/hub-service/http-server.js +711 -0
- package/dist/hub-service/http-server.js.map +1 -0
- package/dist/hub-service/hub-jwt.d.ts +30 -0
- package/dist/hub-service/hub-jwt.d.ts.map +1 -0
- package/dist/hub-service/hub-jwt.js +105 -0
- package/dist/hub-service/hub-jwt.js.map +1 -0
- package/dist/hub-service/jwt-revocation.d.ts +20 -0
- package/dist/hub-service/jwt-revocation.d.ts.map +1 -0
- package/dist/hub-service/jwt-revocation.js +18 -0
- package/dist/hub-service/jwt-revocation.js.map +1 -0
- package/dist/hub-service/machines.d.ts +16 -0
- package/dist/hub-service/machines.d.ts.map +1 -0
- package/dist/hub-service/machines.js +14 -0
- package/dist/hub-service/machines.js.map +1 -0
- package/dist/hub-service/main.d.ts +3 -0
- package/dist/hub-service/main.d.ts.map +1 -0
- package/dist/hub-service/main.js +64 -0
- package/dist/hub-service/main.js.map +1 -0
- package/dist/hub-service/member-tokens.d.ts +11 -0
- package/dist/hub-service/member-tokens.d.ts.map +1 -0
- package/dist/hub-service/member-tokens.js +49 -0
- package/dist/hub-service/member-tokens.js.map +1 -0
- package/dist/hub-service/member-view.d.ts +20 -0
- package/dist/hub-service/member-view.d.ts.map +1 -0
- package/dist/hub-service/member-view.js +76 -0
- package/dist/hub-service/member-view.js.map +1 -0
- package/dist/hub-service/members.d.ts +44 -0
- package/dist/hub-service/members.d.ts.map +1 -0
- package/dist/hub-service/members.js +25 -0
- package/dist/hub-service/members.js.map +1 -0
- package/dist/hub-service/presence.d.ts +40 -0
- package/dist/hub-service/presence.d.ts.map +1 -0
- package/dist/hub-service/presence.js +44 -0
- package/dist/hub-service/presence.js.map +1 -0
- package/dist/hub-service/project-view.d.ts +12 -0
- package/dist/hub-service/project-view.d.ts.map +1 -0
- package/dist/hub-service/project-view.js +34 -0
- package/dist/hub-service/project-view.js.map +1 -0
- package/dist/hub-service/projects.d.ts +48 -0
- package/dist/hub-service/projects.d.ts.map +1 -0
- package/dist/hub-service/projects.js +80 -0
- package/dist/hub-service/projects.js.map +1 -0
- package/dist/hub-service/relay-queue.d.ts +115 -0
- package/dist/hub-service/relay-queue.d.ts.map +1 -0
- package/dist/hub-service/relay-queue.js +148 -0
- package/dist/hub-service/relay-queue.js.map +1 -0
- package/dist/hub-service/session-jwt.d.ts +10 -0
- package/dist/hub-service/session-jwt.d.ts.map +1 -0
- package/dist/hub-service/session-jwt.js +69 -0
- package/dist/hub-service/session-jwt.js.map +1 -0
- package/dist/hub-service/usage.d.ts +40 -0
- package/dist/hub-service/usage.d.ts.map +1 -0
- package/dist/hub-service/usage.js +25 -0
- package/dist/hub-service/usage.js.map +1 -0
- package/dist/hub-service/users.d.ts +56 -0
- package/dist/hub-service/users.d.ts.map +1 -0
- package/dist/hub-service/users.js +72 -0
- package/dist/hub-service/users.js.map +1 -0
- package/dist/hub-service/workspaces.d.ts +20 -0
- package/dist/hub-service/workspaces.d.ts.map +1 -0
- package/dist/hub-service/workspaces.js +10 -0
- package/dist/hub-service/workspaces.js.map +1 -0
- package/dist/index.js +179 -132
- package/dist/index.js.map +1 -1
- package/dist/os/linux.d.ts +13 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +62 -3
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +10 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows.d.ts +1 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +21 -1
- package/dist/os/windows.js.map +1 -1
- package/dist/paths.d.ts +23 -0
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +29 -0
- package/dist/paths.js.map +1 -1
- package/dist/providers/agy.d.ts +9 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +127 -14
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +6 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +248 -9
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +3 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +7 -0
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +3 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +8 -1
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/gemini.d.ts +3 -2
- package/dist/providers/gemini.d.ts.map +1 -1
- package/dist/providers/gemini.js +11 -1
- package/dist/providers/gemini.js.map +1 -1
- package/dist/providers/index.d.ts +1 -0
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +3 -0
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +51 -0
- package/dist/providers/none.d.ts.map +1 -0
- package/dist/providers/none.js +103 -0
- package/dist/providers/none.js.map +1 -0
- package/dist/providers/opencode.d.ts +4 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +49 -0
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +79 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +10 -0
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.d.ts +3 -3
- package/dist/services/agent-provisioner.d.ts.map +1 -1
- package/dist/services/agent-provisioner.js +12 -5
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/auth-socket.d.ts.map +1 -1
- package/dist/services/auth-socket.js +2 -0
- package/dist/services/auth-socket.js.map +1 -1
- package/dist/services/budget-awareness.d.ts +130 -0
- package/dist/services/budget-awareness.d.ts.map +1 -0
- package/dist/services/budget-awareness.js +129 -0
- package/dist/services/budget-awareness.js.map +1 -0
- package/dist/services/cloud-sync.d.ts +35 -0
- package/dist/services/cloud-sync.d.ts.map +1 -0
- package/dist/services/cloud-sync.js +90 -0
- package/dist/services/cloud-sync.js.map +1 -0
- package/dist/services/context-admission.d.ts +82 -0
- package/dist/services/context-admission.d.ts.map +1 -0
- package/dist/services/context-admission.js +136 -0
- package/dist/services/context-admission.js.map +1 -0
- package/dist/services/event-bus.d.ts +27 -0
- package/dist/services/event-bus.d.ts.map +1 -0
- package/dist/services/event-bus.js +20 -0
- package/dist/services/event-bus.js.map +1 -0
- package/dist/services/file-chunker.d.ts +38 -0
- package/dist/services/file-chunker.d.ts.map +1 -0
- package/dist/services/file-chunker.js +63 -0
- package/dist/services/file-chunker.js.map +1 -0
- package/dist/services/file-transfer-relay.d.ts +55 -0
- package/dist/services/file-transfer-relay.d.ts.map +1 -0
- package/dist/services/file-transfer-relay.js +115 -0
- package/dist/services/file-transfer-relay.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +1 -0
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +25 -0
- package/dist/services/http-transport.d.ts.map +1 -0
- package/dist/services/http-transport.js +371 -0
- package/dist/services/http-transport.js.map +1 -0
- package/dist/services/hub-client.d.ts +69 -0
- package/dist/services/hub-client.d.ts.map +1 -0
- package/dist/services/hub-client.js +217 -0
- package/dist/services/hub-client.js.map +1 -0
- package/dist/services/jwt.d.ts +17 -0
- package/dist/services/jwt.d.ts.map +1 -0
- package/dist/services/jwt.js +70 -0
- package/dist/services/jwt.js.map +1 -0
- package/dist/services/known-sessions.d.ts +8 -0
- package/dist/services/known-sessions.d.ts.map +1 -0
- package/dist/services/known-sessions.js +40 -0
- package/dist/services/known-sessions.js.map +1 -0
- package/dist/services/model-pricing.d.ts +36 -0
- package/dist/services/model-pricing.d.ts.map +1 -0
- package/dist/services/model-pricing.js +108 -0
- package/dist/services/model-pricing.js.map +1 -0
- package/dist/services/orphan-recovery.d.ts +56 -0
- package/dist/services/orphan-recovery.d.ts.map +1 -0
- package/dist/services/orphan-recovery.js +111 -0
- package/dist/services/orphan-recovery.js.map +1 -0
- package/dist/services/pending-responses.d.ts +23 -0
- package/dist/services/pending-responses.d.ts.map +1 -0
- package/dist/services/pending-responses.js +52 -0
- package/dist/services/pending-responses.js.map +1 -0
- package/dist/services/registry.d.ts +4 -1
- package/dist/services/registry.d.ts.map +1 -1
- package/dist/services/registry.js +3 -0
- package/dist/services/registry.js.map +1 -1
- package/dist/services/relay-context.d.ts +23 -0
- package/dist/services/relay-context.d.ts.map +1 -0
- package/dist/services/relay-context.js +8 -0
- package/dist/services/relay-context.js.map +1 -0
- package/dist/services/relay-executor.d.ts +68 -0
- package/dist/services/relay-executor.d.ts.map +1 -0
- package/dist/services/relay-executor.js +70 -0
- package/dist/services/relay-executor.js.map +1 -0
- package/dist/services/relay-request.d.ts +65 -0
- package/dist/services/relay-request.d.ts.map +1 -0
- package/dist/services/relay-request.js +129 -0
- package/dist/services/relay-request.js.map +1 -0
- package/dist/services/relay-strategy.d.ts +19 -0
- package/dist/services/relay-strategy.d.ts.map +1 -0
- package/dist/services/relay-strategy.js +111 -0
- package/dist/services/relay-strategy.js.map +1 -0
- package/dist/services/service-manager/index.d.ts +5 -0
- package/dist/services/service-manager/index.d.ts.map +1 -0
- package/dist/services/service-manager/index.js +66 -0
- package/dist/services/service-manager/index.js.map +1 -0
- package/dist/services/service-manager/linux.d.ts +10 -0
- package/dist/services/service-manager/linux.d.ts.map +1 -0
- package/dist/services/service-manager/linux.js +97 -0
- package/dist/services/service-manager/linux.js.map +1 -0
- package/dist/services/service-manager/macos.d.ts +10 -0
- package/dist/services/service-manager/macos.d.ts.map +1 -0
- package/dist/services/service-manager/macos.js +94 -0
- package/dist/services/service-manager/macos.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +18 -0
- package/dist/services/service-manager/types.d.ts.map +1 -0
- package/dist/services/service-manager/types.js +5 -0
- package/dist/services/service-manager/types.js.map +1 -0
- package/dist/services/service-manager/windows.d.ts +10 -0
- package/dist/services/service-manager/windows.d.ts.map +1 -0
- package/dist/services/service-manager/windows.js +73 -0
- package/dist/services/service-manager/windows.js.map +1 -0
- package/dist/services/session-registry.d.ts +70 -0
- package/dist/services/session-registry.d.ts.map +1 -0
- package/dist/services/session-registry.js +91 -0
- package/dist/services/session-registry.js.map +1 -0
- package/dist/services/singleton.d.ts +15 -0
- package/dist/services/singleton.d.ts.map +1 -0
- package/dist/services/singleton.js +98 -0
- package/dist/services/singleton.js.map +1 -0
- package/dist/services/sprint-coordination.d.ts +168 -0
- package/dist/services/sprint-coordination.d.ts.map +1 -0
- package/dist/services/sprint-coordination.js +564 -0
- package/dist/services/sprint-coordination.js.map +1 -0
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +70 -3
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
- package/dist/services/stall/log-path-resolver.js +8 -1
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +39 -7
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +136 -18
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +55 -5
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.d.ts +20 -0
- package/dist/services/substitution-engine.d.ts.map +1 -0
- package/dist/services/substitution-engine.js +92 -0
- package/dist/services/substitution-engine.js.map +1 -0
- package/dist/services/task-cleanup.d.ts.map +1 -1
- package/dist/services/task-cleanup.js +1 -9
- package/dist/services/task-cleanup.js.map +1 -1
- package/dist/services/token-issuer.d.ts +47 -0
- package/dist/services/token-issuer.d.ts.map +1 -0
- package/dist/services/token-issuer.js +63 -0
- package/dist/services/token-issuer.js.map +1 -0
- package/dist/services/tool-registry.d.ts +3 -0
- package/dist/services/tool-registry.d.ts.map +1 -0
- package/dist/services/tool-registry.js +139 -0
- package/dist/services/tool-registry.js.map +1 -0
- package/dist/services/user-config.d.ts +14 -0
- package/dist/services/user-config.d.ts.map +1 -1
- package/dist/services/user-config.js +55 -0
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/types.d.ts +44 -0
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/dist/skills/pm/cost.md +3 -0
- package/dist/skills/pm/doer-reviewer-loop.md +3 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +8 -2
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/child-id-allocator.d.ts +45 -0
- package/dist/tools/child-id-allocator.d.ts.map +1 -0
- package/dist/tools/child-id-allocator.js +62 -0
- package/dist/tools/child-id-allocator.js.map +1 -0
- package/dist/tools/cloud-control.d.ts +2 -2
- package/dist/tools/compose-permissions.d.ts +12 -4
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +55 -4
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/dolt-push-mutex.d.ts +44 -0
- package/dist/tools/dolt-push-mutex.d.ts.map +1 -0
- package/dist/tools/dolt-push-mutex.js +83 -0
- package/dist/tools/dolt-push-mutex.js.map +1 -0
- package/dist/tools/execute-command.d.ts +11 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +22 -5
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +72 -12
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +962 -71
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/get-member-model-pricing.d.ts +21 -0
- package/dist/tools/get-member-model-pricing.d.ts.map +1 -0
- package/dist/tools/get-member-model-pricing.js +29 -0
- package/dist/tools/get-member-model-pricing.js.map +1 -0
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +39 -7
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +1 -1
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +8 -2
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +29 -0
- package/dist/tools/member-reservation.d.ts.map +1 -0
- package/dist/tools/member-reservation.js +71 -0
- package/dist/tools/member-reservation.js.map +1 -0
- package/dist/tools/provision-vcs-auth.d.ts +7 -7
- package/dist/tools/provision-vcs-auth.js +1 -1
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +17 -5
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +144 -5
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts +1 -1
- package/dist/tools/report-status.d.ts +33 -0
- package/dist/tools/report-status.d.ts.map +1 -0
- package/dist/tools/report-status.js +44 -0
- package/dist/tools/report-status.js.map +1 -0
- package/dist/tools/respond-to-message.d.ts +21 -0
- package/dist/tools/respond-to-message.d.ts.map +1 -0
- package/dist/tools/respond-to-message.js +23 -0
- package/dist/tools/respond-to-message.js.map +1 -0
- package/dist/tools/send-files.d.ts +3 -0
- package/dist/tools/send-files.d.ts.map +1 -1
- package/dist/tools/send-files.js +88 -8
- package/dist/tools/send-files.js.map +1 -1
- package/dist/tools/send-message.d.ts +27 -0
- package/dist/tools/send-message.d.ts.map +1 -0
- package/dist/tools/send-message.js +46 -0
- package/dist/tools/send-message.js.map +1 -0
- 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 +19 -0
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/update-member.d.ts +8 -8
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +11 -1
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +15 -3
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +2 -1
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +7 -2
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/pid-helpers.d.ts +15 -0
- package/dist/utils/pid-helpers.d.ts.map +1 -1
- package/dist/utils/pid-helpers.js +23 -0
- package/dist/utils/pid-helpers.js.map +1 -1
- package/dist/utils/process-utils.d.ts +3 -0
- package/dist/utils/process-utils.d.ts.map +1 -0
- package/dist/utils/process-utils.js +42 -0
- package/dist/utils/process-utils.js.map +1 -0
- package/dist/utils/prompt-errors.d.ts +2 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +13 -3
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/workspace-trust.d.ts +24 -0
- package/dist/utils/workspace-trust.d.ts.map +1 -0
- package/dist/utils/workspace-trust.js +35 -0
- package/dist/utils/workspace-trust.js.map +1 -0
- package/dist/workflows/auto-sprint.js +450 -87
- package/package.json +35 -7
- package/packages/apra-fleet-client/package.json +26 -0
- package/packages/apra-fleet-client/src/client/api.mjs +396 -0
- package/packages/apra-fleet-client/src/client/client.mjs +146 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +71 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +65 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +265 -0
- package/packages/apra-fleet-client/src/client/transport.mjs +327 -0
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +287 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +89 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +139 -0
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +225 -0
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +169 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +316 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +188 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +239 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +216 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +174 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-input.json +35 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +164 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-input.json +26 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/ci-watcher-output.json +18 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-input.json +19 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +17 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +22 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +31 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +18 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-input.json +20 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +61 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +30 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-input.json +15 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +50 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-input.json +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +38 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +402 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +142 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +157 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/doer-reviewer-loop.md +300 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +121 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/simple-sprint.md +65 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +327 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/worktrees.md +92 -0
- package/packages/apra-fleet-se/apra-pm/version.json +3 -0
- package/packages/apra-fleet-se/bin/cli.mjs +857 -0
- package/packages/apra-fleet-se/bin/serve.mjs +383 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +914 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +177 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +191 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +151 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +127 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +1125 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +72 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +360 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +363 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1244 -0
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +572 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +9447 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +103 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +435 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +68 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +53 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +146 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/generic-git.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +222 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +882 -0
- package/packages/apra-fleet-se/package.json +28 -0
- package/packages/apra-fleet-se/workflow.json +1 -0
- package/packages/apra-fleet-workflow/package.json +30 -0
- package/packages/apra-fleet-workflow/src/viewer/command-output-cap.mjs +112 -0
- package/packages/apra-fleet-workflow/src/viewer/debounced-writer.mjs +153 -0
- package/packages/apra-fleet-workflow/src/viewer/html-utils.mjs +31 -0
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +1325 -0
- package/packages/apra-fleet-workflow/src/viewer/lean-state.mjs +237 -0
- package/packages/apra-fleet-workflow/src/viewer/run-state-paths.mjs +130 -0
- package/packages/apra-fleet-workflow/src/viewer/sprint-state-paths.mjs +29 -0
- package/packages/apra-fleet-workflow/src/workflow/engine.mjs +200 -0
- package/packages/apra-fleet-workflow/src/workflow/errors.mjs +146 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +1723 -0
- package/packages/apra-fleet-workflow/src/workflow/journal.mjs +291 -0
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +99 -0
- package/packages/apra-fleet-workflow/src/workflow/vetting.mjs +111 -0
- package/scripts/agy-transcript-reader.js +1 -0
- package/scripts/fleet-statusline.sh +17 -13
- package/skills/fleet/SKILL.md +37 -2
- package/skills/fleet/beads.md +14 -7
- package/skills/fleet/permissions.md +50 -0
- package/skills/fleet/profiles/base-dev.json +1 -0
- package/skills/fleet/profiles/base-reviewer.json +1 -0
- package/skills/fleet/profiles/node.json +2 -2
- package/version.json +1 -1
- package/scripts/agy-settings-merge.js +0 -27
- /package/{dist → packages/apra-fleet-se/apra-pm}/agents/_shared/GRAPH-SEMANTICS.md +0 -0
package/dist/cli/install.js
CHANGED
|
@@ -3,8 +3,28 @@ import path from 'node:path';
|
|
|
3
3
|
import os from 'node:os';
|
|
4
4
|
import { execSync, execFileSync } from 'node:child_process';
|
|
5
5
|
import { serverVersion } from '../version.js';
|
|
6
|
+
import { DEFAULT_PORT, LOG_FILE_PATH } from '../paths.js';
|
|
7
|
+
import { getServiceManager } from '../services/service-manager/index.js';
|
|
6
8
|
import { BIN_DIR, HOOKS_DIR, SCRIPTS_DIR, getProviderInstallConfig, readConfig, writeConfig, writeInstallConfig, PROVIDER_STANDARD_MODELS } from './config.js';
|
|
7
|
-
import { transformAgentForOpenCode } from './agent-transform.js';
|
|
9
|
+
import { transformAgentForOpenCode, transformAgentForAgy } from './agent-transform.js';
|
|
10
|
+
import { extractWorkflowSubsystemAssets } from './workflow-assets.js';
|
|
11
|
+
import { downloadAndExtractDolt, verifyDolt } from './dolt-install.js';
|
|
12
|
+
import { classifyRunningServer, getInstallDataDir } from './install-guard.js';
|
|
13
|
+
const realDoltStepDeps = { downloadAndExtractDolt, verifyDolt };
|
|
14
|
+
let doltStepDeps = realDoltStepDeps;
|
|
15
|
+
/** Test-only: inject fakes for the dolt CLI install step's download/verify calls. */
|
|
16
|
+
export function _setDoltStepDeps(overrides) {
|
|
17
|
+
doltStepDeps = { ...realDoltStepDeps, ...overrides };
|
|
18
|
+
}
|
|
19
|
+
/** Test-only: restore the real (non-mocked) dolt step dependencies. */
|
|
20
|
+
export function _resetDoltStepDeps() {
|
|
21
|
+
doltStepDeps = realDoltStepDeps;
|
|
22
|
+
}
|
|
23
|
+
function doltStepEnabled() {
|
|
24
|
+
if (process.env.NODE_ENV !== 'test')
|
|
25
|
+
return true;
|
|
26
|
+
return process.env.APRA_FLEET_ENABLE_DOLT_INSTALL === '1';
|
|
27
|
+
}
|
|
8
28
|
// Detect SEA mode
|
|
9
29
|
let _seaOverride = null;
|
|
10
30
|
/** Override isSea() result -- for tests only. Pass null to restore default. */
|
|
@@ -52,21 +72,28 @@ export function isNpmGlobalInstall() {
|
|
|
52
72
|
function getSeaAsset(key) {
|
|
53
73
|
const sea = require('node:sea');
|
|
54
74
|
const buf = sea.getAsset(key);
|
|
55
|
-
// getAsset returns ArrayBuffer
|
|
75
|
+
// getAsset returns ArrayBuffer - decode to string
|
|
56
76
|
return new TextDecoder().decode(buf);
|
|
57
77
|
}
|
|
58
78
|
function getSeaAssetBuffer(key) {
|
|
59
79
|
const sea = require('node:sea');
|
|
60
80
|
return Buffer.from(sea.getAsset(key));
|
|
61
81
|
}
|
|
62
|
-
// Claude-only helper skill
|
|
82
|
+
// Claude-only helper skill packaged alongside apra-pm's auto-sprint workflow --
|
|
63
83
|
// installed into <configDir>/skills/auto-sprint-args, mirrors apra-pm/install.mjs.
|
|
64
84
|
const AUTO_SPRINT_ARGS_SKILL_NAME = 'auto-sprint-args';
|
|
85
|
+
// Helper skill for the fleet-sprint workflow (`apra-fleet workflow
|
|
86
|
+
// fleet-sprint`), shipped inside the fleet-sprint package itself. NOT provider-
|
|
87
|
+
// specific: installed into <configDir>/skills/fleet-sprint-cli for every LLM
|
|
88
|
+
// provider (every provider's config layout is <configDir>/skills/<name>, same
|
|
89
|
+
// as the pm and fleet skills).
|
|
90
|
+
const FLEET_SPRINT_CLI_SKILL_NAME = 'fleet-sprint-cli';
|
|
91
|
+
const FLEET_SPRINT_CLI_SKILL_VENDOR_BASE = 'packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli';
|
|
65
92
|
import { fileURLToPath } from 'url';
|
|
66
93
|
import { dirname } from 'path';
|
|
67
94
|
const __filename = fileURLToPath(import.meta.url);
|
|
68
95
|
const __dirname = dirname(__filename);
|
|
69
|
-
// Find project root
|
|
96
|
+
// Find project root - works for both tsc (dist/cli/install.js) and esbuild (dist/sea-bundle.cjs)
|
|
70
97
|
function findProjectRoot() {
|
|
71
98
|
let dir = __dirname;
|
|
72
99
|
for (let i = 0; i < 5; i++) {
|
|
@@ -76,7 +103,7 @@ function findProjectRoot() {
|
|
|
76
103
|
}
|
|
77
104
|
throw new Error('Cannot find project root (version.json not found)');
|
|
78
105
|
}
|
|
79
|
-
// Collect files recursively
|
|
106
|
+
// Collect files recursively - used by dev-mode manifest generation
|
|
80
107
|
function collectFilesRec(dir, base, rootBase) {
|
|
81
108
|
const effectiveRootBase = rootBase ?? base;
|
|
82
109
|
const results = {};
|
|
@@ -94,39 +121,142 @@ function collectFilesRec(dir, base, rootBase) {
|
|
|
94
121
|
}
|
|
95
122
|
return results;
|
|
96
123
|
}
|
|
97
|
-
|
|
124
|
+
// Directory names excluded (recursively) when collecting a package tree for
|
|
125
|
+
// the workflow-runtime / agent-schemas / built-in-workflow sections -- mirrors
|
|
126
|
+
// scripts/gen-sea-config.mjs's PACKAGE_TREE_EXCLUDE_DIRS.
|
|
127
|
+
const PACKAGE_TREE_EXCLUDE_DIRS = new Set(['test', 'docs', 'scripts', 'examples']);
|
|
128
|
+
/**
|
|
129
|
+
* Resolve a runtime dependency's package directory by walking the node_modules
|
|
130
|
+
* chain upward from `root`, the way Node's own resolver does.
|
|
131
|
+
*
|
|
132
|
+
* Why this exists: gen-sea-config.mjs (the SEA parity source) can assume every
|
|
133
|
+
* runtime dep sits at `root/node_modules/<pkg>` because it always runs from the
|
|
134
|
+
* git/workspace checkout, where nothing is hoisted above the repo root. But
|
|
135
|
+
* buildDevManifest() also runs at `apra-fleet install` time inside a REAL
|
|
136
|
+
* npm-installed tree, where `root` is `node_modules/@apralabs/apra-fleet` and
|
|
137
|
+
* npm HOISTS shared deps (ajv, undici, fast-uri, ...) up to a PARENT
|
|
138
|
+
* node_modules. A fixed `root/node_modules/<pkg>` probe misses every hoisted
|
|
139
|
+
* dep there, so the whole workflow-runtime section fails its existsSync gate and
|
|
140
|
+
* silently drops out -- leaving `apra-fleet workflow fleet-sprint` dead with no
|
|
141
|
+
* error (the exact class of failure tests/install-dev-manifest.test.ts guards).
|
|
142
|
+
* Walking up the chain resolves the dep wherever npm actually placed it; in a
|
|
143
|
+
* dev checkout the first candidate (`root/node_modules/<pkg>`) still wins, so
|
|
144
|
+
* the manifest is byte-identical there. Returns null when the dep is nowhere on
|
|
145
|
+
* the chain.
|
|
146
|
+
*/
|
|
147
|
+
function resolveNodeModulesDir(root, pkg) {
|
|
148
|
+
let dir = root;
|
|
149
|
+
for (;;) {
|
|
150
|
+
const candidate = path.join(dir, 'node_modules', pkg);
|
|
151
|
+
if (fs.existsSync(candidate))
|
|
152
|
+
return candidate;
|
|
153
|
+
const parent = path.dirname(dir);
|
|
154
|
+
if (parent === dir)
|
|
155
|
+
return null; // reached filesystem root
|
|
156
|
+
dir = parent;
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
// Runtime deps of the workflow subsystem that live under node_modules (as
|
|
160
|
+
// opposed to the first-party packages/ trees). Each tuple is [package name on
|
|
161
|
+
// disk, manifest prefix]; the two coincide today but are kept explicit to
|
|
162
|
+
// mirror gen-sea-config.mjs's collectPackageTree(..., '<prefix>') calls exactly.
|
|
163
|
+
const WORKFLOW_RUNTIME_NODE_MODULES_DEPS = [
|
|
164
|
+
['ajv', 'ajv'],
|
|
165
|
+
['fast-deep-equal', 'fast-deep-equal'],
|
|
166
|
+
['fast-uri', 'fast-uri'],
|
|
167
|
+
['json-schema-traverse', 'json-schema-traverse'],
|
|
168
|
+
['require-from-string', 'require-from-string'],
|
|
169
|
+
// undici is a direct runtime dependency of apra-fleet-client's transport
|
|
170
|
+
// (packages/apra-fleet-client/src/client/transport.mjs). undici-types is a
|
|
171
|
+
// types-only peer dependency (no runtime require of it in undici's lib), so
|
|
172
|
+
// it is intentionally not bundled here.
|
|
173
|
+
['undici', 'undici'],
|
|
174
|
+
];
|
|
175
|
+
function collectFilesFilteredRec(dir, base, rootBase, excludeDirs) {
|
|
176
|
+
const results = {};
|
|
177
|
+
if (!fs.existsSync(dir))
|
|
178
|
+
return results;
|
|
179
|
+
for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
|
|
180
|
+
if (entry.isDirectory() && excludeDirs.has(entry.name))
|
|
181
|
+
continue;
|
|
182
|
+
const fullPath = path.join(dir, entry.name);
|
|
183
|
+
const relPath = path.join(base, entry.name).replace(/\\/g, '/');
|
|
184
|
+
if (entry.isDirectory()) {
|
|
185
|
+
Object.assign(results, collectFilesFilteredRec(fullPath, relPath, rootBase, excludeDirs));
|
|
186
|
+
}
|
|
187
|
+
else {
|
|
188
|
+
results[path.relative(rootBase, relPath).replace(/\\/g, '/')] = relPath;
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
return results;
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* Collects a package/module tree using its real root-relative path (so values
|
|
195
|
+
* stay valid `join(root, value)` disk paths -- and thus valid dev-mode
|
|
196
|
+
* extractAsset() keys), then re-keys the result under `manifestPrefix` so
|
|
197
|
+
* multiple trees merge into one manifest section without key collisions.
|
|
198
|
+
* Mirrors scripts/gen-sea-config.mjs's collectPackageTree exactly, so the
|
|
199
|
+
* namespaced keys install.ts's workflow-install step consumes are identical
|
|
200
|
+
* in dev mode and SEA mode.
|
|
201
|
+
*/
|
|
202
|
+
function collectPackageTree(root, sourceDir, manifestPrefix, excludeDirs = PACKAGE_TREE_EXCLUDE_DIRS) {
|
|
203
|
+
const rootRelBase = path.relative(root, sourceDir).replace(/\\/g, '/');
|
|
204
|
+
const raw = collectFilesFilteredRec(sourceDir, rootRelBase, rootRelBase, excludeDirs);
|
|
205
|
+
const results = {};
|
|
206
|
+
for (const [shortKey, diskPath] of Object.entries(raw)) {
|
|
207
|
+
results[`${manifestPrefix}/${shortKey}`] = diskPath;
|
|
208
|
+
}
|
|
209
|
+
return results;
|
|
210
|
+
}
|
|
211
|
+
// Exported for tests: the dev-mode manifest is what gates the entire workflow
|
|
212
|
+
// subsystem install, and its inputs are filesystem paths that can silently go
|
|
213
|
+
// stale when directories move (see agentSchemasDir below).
|
|
214
|
+
export function buildDevManifest(root) {
|
|
98
215
|
const hooks = {};
|
|
99
216
|
for (const entry of fs.readdirSync(path.join(root, 'hooks'))) {
|
|
100
217
|
hooks[entry] = `hooks/${entry}`;
|
|
101
218
|
}
|
|
102
219
|
const scripts = {};
|
|
103
|
-
for (const entry of fs.readdirSync(path.join(root, 'scripts'))) {
|
|
104
|
-
if (entry.
|
|
220
|
+
for (const entry of fs.readdirSync(path.join(root, 'scripts'), { withFileTypes: true })) {
|
|
221
|
+
if (!entry.isFile())
|
|
222
|
+
continue; // skip subdirectories (e.g. agent-doc-partials/)
|
|
223
|
+
if (entry.name.endsWith('.mjs'))
|
|
105
224
|
continue; // skip build scripts
|
|
106
|
-
scripts[entry] = `scripts/${entry}`;
|
|
225
|
+
scripts[entry.name] = `scripts/${entry.name}`;
|
|
107
226
|
}
|
|
108
|
-
// Source PM skills
|
|
109
|
-
//
|
|
110
|
-
|
|
111
|
-
const
|
|
227
|
+
// Source PM skills from apra-pm local package copy (dev mode), fall back to
|
|
228
|
+
// dist/ for npm global installs. Skills have no
|
|
229
|
+
// build-time resolution step, so reading directly is safe.
|
|
230
|
+
const vendorPmSkills = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'skills', 'pm');
|
|
112
231
|
const pmSkillsDir = fs.existsSync(vendorPmSkills) ? vendorPmSkills : path.join(root, 'dist', 'skills', 'pm');
|
|
113
|
-
const
|
|
114
|
-
|
|
115
|
-
const
|
|
232
|
+
const pmBase = fs.existsSync(vendorPmSkills) ? 'packages/apra-fleet-se/apra-pm/skills/pm' : 'dist/skills/pm';
|
|
233
|
+
// Read straight from the local package copy -- same as skills above.
|
|
234
|
+
const agentsDir = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'agents');
|
|
235
|
+
const agentsBase = 'packages/apra-fleet-se/apra-pm/agents';
|
|
116
236
|
const skills = collectFilesRec(pmSkillsDir, pmBase, pmBase);
|
|
117
237
|
const agents = collectFilesRec(agentsDir, agentsBase, agentsBase);
|
|
118
238
|
const fleetSkills = collectFilesRec(path.join(root, 'skills', 'fleet'), 'skills/fleet');
|
|
119
|
-
// auto-sprint-args helper skill (
|
|
239
|
+
// auto-sprint-args helper skill (packaged alongside apra-pm's auto-sprint workflow;
|
|
120
240
|
// claude-only install target, see the install flow's PM cost/workflow step).
|
|
121
|
-
const vendorArgsSkill = path.join(root, '
|
|
241
|
+
const vendorArgsSkill = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', '.claude', 'skills', 'auto-sprint-args');
|
|
122
242
|
const distArgsSkill = path.join(root, 'dist', 'skills', 'auto-sprint-args');
|
|
123
243
|
const argsSkillDir = fs.existsSync(vendorArgsSkill) ? vendorArgsSkill : distArgsSkill;
|
|
124
244
|
const argsSkillBase = fs.existsSync(vendorArgsSkill)
|
|
125
|
-
? '
|
|
245
|
+
? 'packages/apra-fleet-se/apra-pm/.claude/skills/auto-sprint-args'
|
|
126
246
|
: 'dist/skills/auto-sprint-args';
|
|
127
247
|
const autoSprintArgsSkill = collectFilesRec(argsSkillDir, argsSkillBase, argsSkillBase);
|
|
128
|
-
//
|
|
129
|
-
|
|
248
|
+
// fleet-sprint-cli helper skill (ships inside the fleet-sprint package;
|
|
249
|
+
// documents the `apra-fleet workflow fleet-sprint` CLI flag contract).
|
|
250
|
+
// Provider-agnostic -- installed for every LLM provider.
|
|
251
|
+
const vendorCliSkill = path.join(root, ...FLEET_SPRINT_CLI_SKILL_VENDOR_BASE.split('/'));
|
|
252
|
+
const distCliSkill = path.join(root, 'dist', 'skills', FLEET_SPRINT_CLI_SKILL_NAME);
|
|
253
|
+
const cliSkillDir = fs.existsSync(vendorCliSkill) ? vendorCliSkill : distCliSkill;
|
|
254
|
+
const cliSkillBase = fs.existsSync(vendorCliSkill)
|
|
255
|
+
? FLEET_SPRINT_CLI_SKILL_VENDOR_BASE
|
|
256
|
+
: `dist/skills/${FLEET_SPRINT_CLI_SKILL_NAME}`;
|
|
257
|
+
const fleetSprintCliSkill = collectFilesRec(cliSkillDir, cliSkillBase, cliSkillBase);
|
|
258
|
+
// Collect auto-sprint.js from apra-pm/.claude/workflows (or dist/workflows fallback)
|
|
259
|
+
const vendorWorkflows = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', '.claude', 'workflows');
|
|
130
260
|
const workflowsSrc = fs.existsSync(vendorWorkflows)
|
|
131
261
|
? vendorWorkflows
|
|
132
262
|
: path.join(root, 'dist', 'workflows');
|
|
@@ -138,12 +268,61 @@ function buildDevManifest(root) {
|
|
|
138
268
|
}
|
|
139
269
|
}
|
|
140
270
|
}
|
|
271
|
+
// Workflow subsystem parity (mirrors scripts/gen-sea-config.mjs) so `node
|
|
272
|
+
// dist/index.js install` behaves identically to the SEA binary. Each source
|
|
273
|
+
// tree is optional -- an npm global install missing any piece simply omits
|
|
274
|
+
// the section, same as an older SEA manifest built before this epic; the
|
|
275
|
+
// install step warns and skips. The first-party packages/ trees resolve
|
|
276
|
+
// relative to root (shipped inside the tarball by the files allowlist); the
|
|
277
|
+
// node_modules runtime deps resolve via resolveNodeModulesDir() so a real
|
|
278
|
+
// npm-installed tree (which hoists them above root) still finds them.
|
|
279
|
+
const workflowRuntimeDir = path.join(root, 'packages', 'apra-fleet-workflow');
|
|
280
|
+
const clientDir = path.join(root, 'packages', 'apra-fleet-client');
|
|
281
|
+
const resolvedRuntimeDeps = WORKFLOW_RUNTIME_NODE_MODULES_DEPS.map(([pkg, prefix]) => [prefix, resolveNodeModulesDir(root, pkg)]);
|
|
282
|
+
const allRuntimeDepsResolved = resolvedRuntimeDeps.every(([, dir]) => dir !== null);
|
|
283
|
+
let workflowRuntime;
|
|
284
|
+
if (fs.existsSync(workflowRuntimeDir) && fs.existsSync(clientDir) && allRuntimeDepsResolved) {
|
|
285
|
+
workflowRuntime = {
|
|
286
|
+
...collectPackageTree(root, workflowRuntimeDir, '@apralabs/apra-fleet-workflow'),
|
|
287
|
+
...collectPackageTree(root, clientDir, '@apralabs/apra-fleet-client'),
|
|
288
|
+
};
|
|
289
|
+
for (const [prefix, dir] of resolvedRuntimeDeps) {
|
|
290
|
+
Object.assign(workflowRuntime, collectPackageTree(root, dir, prefix));
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
const agentSchemasDir = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'agents', 'schemas');
|
|
294
|
+
let agentSchemas;
|
|
295
|
+
if (fs.existsSync(agentSchemasDir)) {
|
|
296
|
+
agentSchemas = collectPackageTree(root, agentSchemasDir, 'agentSchemas');
|
|
297
|
+
}
|
|
298
|
+
const fleetSprintDir = path.join(root, 'packages', 'apra-fleet-se');
|
|
299
|
+
const helloWorldDir = path.join(root, 'examples', 'workflows', 'hello-world');
|
|
300
|
+
let builtinWorkflows;
|
|
301
|
+
if (fs.existsSync(fleetSprintDir) || fs.existsSync(helloWorldDir)) {
|
|
302
|
+
builtinWorkflows = {
|
|
303
|
+
...(fs.existsSync(fleetSprintDir) ? collectPackageTree(root, fleetSprintDir, 'fleet-sprint') : {}),
|
|
304
|
+
...(fs.existsSync(helloWorldDir) ? collectPackageTree(root, helloWorldDir, 'hello-world') : {}),
|
|
305
|
+
};
|
|
306
|
+
}
|
|
141
307
|
const vf = JSON.parse(fs.readFileSync(path.join(root, 'version.json'), 'utf-8'));
|
|
142
|
-
return {
|
|
308
|
+
return {
|
|
309
|
+
version: vf.version, hooks, scripts, skills, fleetSkills, agents, workflows,
|
|
310
|
+
workflowRuntime, agentSchemas, builtinWorkflows, autoSprintArgsSkill,
|
|
311
|
+
fleetSprintCliSkill,
|
|
312
|
+
};
|
|
143
313
|
}
|
|
144
314
|
let _manifestOverride = null;
|
|
145
|
-
/** Inject a manifest for tests
|
|
315
|
+
/** Inject a manifest for tests - avoids SEA asset extraction. Pass null to restore default. */
|
|
146
316
|
export function _setManifestOverride(m) { _manifestOverride = m; }
|
|
317
|
+
/**
|
|
318
|
+
* Test-only escape hatch to exercise the real buildDevManifest() (against the
|
|
319
|
+
* real filesystem, not the mocked node:fs used elsewhere in
|
|
320
|
+
* tests/install-workflows.test.ts) so regressions like apra-fleet-eft.19
|
|
321
|
+
* (dev-mode install omitting undici from the workflowRuntime bundle) are
|
|
322
|
+
* caught by a direct assertion on the generated manifest, not just on the
|
|
323
|
+
* mocked-fs runInstall() flow.
|
|
324
|
+
*/
|
|
325
|
+
export function _buildDevManifestForTest(root) { return buildDevManifest(root); }
|
|
147
326
|
function loadManifest() {
|
|
148
327
|
if (_manifestOverride !== null)
|
|
149
328
|
return _manifestOverride;
|
|
@@ -168,9 +347,9 @@ export function loadAgentAssets() {
|
|
|
168
347
|
return results;
|
|
169
348
|
}
|
|
170
349
|
const root = findProjectRoot();
|
|
171
|
-
const vendorAgents = path.join(root, '
|
|
350
|
+
const vendorAgents = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'agents');
|
|
172
351
|
const agentsSrc = fs.existsSync(vendorAgents) ? vendorAgents : path.join(root, 'dist', 'agents');
|
|
173
|
-
const agentsBase = fs.existsSync(vendorAgents) ? '
|
|
352
|
+
const agentsBase = fs.existsSync(vendorAgents) ? 'packages/apra-fleet-se/apra-pm/agents' : 'dist/agents';
|
|
174
353
|
const collected = collectFilesRec(agentsSrc, agentsBase, agentsBase);
|
|
175
354
|
for (const [relPath, rootRelativeLabel] of Object.entries(collected)) {
|
|
176
355
|
results.push({ relPath, content: fs.readFileSync(path.join(root, rootRelativeLabel), 'utf-8') });
|
|
@@ -303,10 +482,23 @@ function mergePermissions(paths, extraPerms = []) {
|
|
|
303
482
|
}
|
|
304
483
|
writeConfig(paths, settings);
|
|
305
484
|
}
|
|
306
|
-
function configureStatusline(paths, scriptPath) {
|
|
485
|
+
function configureStatusline(paths, scriptPath, llm) {
|
|
307
486
|
const settings = readConfig(paths);
|
|
308
|
-
|
|
309
|
-
|
|
487
|
+
let command;
|
|
488
|
+
if (process.platform === 'win32') {
|
|
489
|
+
if (llm === 'agy') {
|
|
490
|
+
const gitBash = 'C:\\Program Files\\Git\\bin\\bash.exe';
|
|
491
|
+
const bashBin = fs.existsSync(gitBash) ? `"${gitBash}"` : 'bash';
|
|
492
|
+
const formattedScriptPath = scriptPath.replace(/\\/g, '/');
|
|
493
|
+
command = `${bashBin} "${formattedScriptPath}"`;
|
|
494
|
+
}
|
|
495
|
+
else {
|
|
496
|
+
command = `bash "${scriptPath}"`;
|
|
497
|
+
}
|
|
498
|
+
}
|
|
499
|
+
else {
|
|
500
|
+
command = scriptPath;
|
|
501
|
+
}
|
|
310
502
|
settings.statusLine = {
|
|
311
503
|
type: 'command',
|
|
312
504
|
command,
|
|
@@ -353,20 +545,27 @@ function mergeCopilotConfig(paths, mcpConfig) {
|
|
|
353
545
|
function mergeOpenCodeConfig(paths, mcpConfig) {
|
|
354
546
|
const settings = readConfig(paths);
|
|
355
547
|
settings.mcp = settings.mcp || {};
|
|
356
|
-
settings.mcp['apra-fleet'] =
|
|
357
|
-
type: '
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
548
|
+
settings.mcp['apra-fleet'] = mcpConfig.url
|
|
549
|
+
? { type: 'remote', url: mcpConfig.url, enabled: true }
|
|
550
|
+
: {
|
|
551
|
+
type: 'local',
|
|
552
|
+
command: [mcpConfig.command, ...(mcpConfig.args || [])],
|
|
553
|
+
enabled: true,
|
|
554
|
+
};
|
|
361
555
|
writeConfig(paths, settings);
|
|
362
556
|
}
|
|
363
557
|
function mergeCodexConfig(paths, mcpConfig) {
|
|
364
558
|
const settings = readConfig(paths);
|
|
365
559
|
settings.mcp_servers = settings.mcp_servers || {};
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
560
|
+
if (mcpConfig.url) {
|
|
561
|
+
settings.mcp_servers['apra-fleet'] = { url: mcpConfig.url };
|
|
562
|
+
}
|
|
563
|
+
else {
|
|
564
|
+
settings.mcp_servers['apra-fleet'] = {
|
|
565
|
+
command: mcpConfig.command.replace(/\\/g, '/'),
|
|
566
|
+
args: mcpConfig.args.map((a) => a.replace(/\\/g, '/')),
|
|
567
|
+
};
|
|
568
|
+
}
|
|
370
569
|
writeConfig(paths, settings);
|
|
371
570
|
}
|
|
372
571
|
function run(cmd, opts) {
|
|
@@ -374,12 +573,25 @@ function run(cmd, opts) {
|
|
|
374
573
|
const shellOpt = process.platform === 'win32' ? { shell: 'cmd.exe' } : {};
|
|
375
574
|
execSync(cmd, { stdio: 'inherit', ...shellOpt, ...opts });
|
|
376
575
|
}
|
|
576
|
+
/** Is `cmd` resolvable on PATH? Used before shelling out to a provider's own
|
|
577
|
+
* CLI (e.g. `claude`) so a missing binary degrades to a clear warning
|
|
578
|
+
* instead of install crashing with a raw "Command failed" error. */
|
|
579
|
+
function isCommandAvailable(cmd) {
|
|
580
|
+
try {
|
|
581
|
+
const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
|
|
582
|
+
execSync(checkCmd, { stdio: 'ignore' });
|
|
583
|
+
return true;
|
|
584
|
+
}
|
|
585
|
+
catch {
|
|
586
|
+
return false;
|
|
587
|
+
}
|
|
588
|
+
}
|
|
377
589
|
export function isApraFleetRunning() {
|
|
378
590
|
try {
|
|
379
591
|
if (process.platform === 'win32') {
|
|
380
592
|
const out = execSync('tasklist /FI "IMAGENAME eq apra-fleet.exe" /NH /FO CSV', { encoding: 'utf-8', stdio: 'pipe' });
|
|
381
593
|
const currentPid = process.pid.toString();
|
|
382
|
-
// Each CSV line: "apra-fleet.exe","<PID>","..."
|
|
594
|
+
// Each CSV line: "apra-fleet.exe","<PID>","..." - exclude the current installer process
|
|
383
595
|
return out.split('\n').some(line => {
|
|
384
596
|
const match = line.match(/"apra-fleet\.exe","(\d+)"/);
|
|
385
597
|
return match !== null && match[1] !== currentPid;
|
|
@@ -397,13 +609,57 @@ export function isApraFleetRunning() {
|
|
|
397
609
|
return false;
|
|
398
610
|
}
|
|
399
611
|
}
|
|
400
|
-
export function killApraFleet() {
|
|
612
|
+
export function killApraFleet(signal = 'SIGTERM') {
|
|
401
613
|
if (process.platform === 'win32') {
|
|
614
|
+
// taskkill /F is already forceful -- no softer signal to escalate from,
|
|
615
|
+
// so SIGKILL escalation on Windows just reissues the same command.
|
|
402
616
|
execSync('taskkill /F /IM apra-fleet.exe', { stdio: 'ignore' });
|
|
403
617
|
}
|
|
404
618
|
else {
|
|
405
619
|
// -x = exact name match
|
|
406
|
-
|
|
620
|
+
const cmd = signal === 'SIGKILL' ? 'pkill -9 -x apra-fleet' : 'pkill -x apra-fleet';
|
|
621
|
+
execSync(cmd, { stdio: 'ignore' });
|
|
622
|
+
}
|
|
623
|
+
}
|
|
624
|
+
const PROD_INSTALL_FORCE_TIMING = { pollIntervalMs: 200, graceMs: 3000, killGraceMs: 2000 };
|
|
625
|
+
// Tests run with NODE_ENV=test (see tests/setup.ts) and don't fake these timers,
|
|
626
|
+
// so default to a much shorter window there to keep the suite fast, unless a
|
|
627
|
+
// test explicitly overrides via _setInstallForceTimingOverride() to exercise
|
|
628
|
+
// the escalation path directly.
|
|
629
|
+
const TEST_INSTALL_FORCE_TIMING = { pollIntervalMs: 2, graceMs: 20, killGraceMs: 20 };
|
|
630
|
+
let _installForceTimingOverride = null;
|
|
631
|
+
/** Test-only: override the poll/grace timing used by waitForApraFleetToStop(). Pass null to restore default. */
|
|
632
|
+
export function _setInstallForceTimingOverride(t) {
|
|
633
|
+
_installForceTimingOverride = t;
|
|
634
|
+
}
|
|
635
|
+
function installForceTiming() {
|
|
636
|
+
if (_installForceTimingOverride)
|
|
637
|
+
return _installForceTimingOverride;
|
|
638
|
+
return process.env.NODE_ENV === 'test' ? TEST_INSTALL_FORCE_TIMING : PROD_INSTALL_FORCE_TIMING;
|
|
639
|
+
}
|
|
640
|
+
/**
|
|
641
|
+
* Wait for any non-installer apra-fleet process to exit after killApraFleet()
|
|
642
|
+
* sends SIGTERM. Polls isApraFleetRunning() over a grace window; if the
|
|
643
|
+
* process is still alive once the window elapses, escalates to SIGKILL and
|
|
644
|
+
* polls again over a second (shorter) window. Returns as soon as no
|
|
645
|
+
* non-installer apra-fleet process is detected, or once both windows have
|
|
646
|
+
* elapsed -- callers should not assume termination is guaranteed in the
|
|
647
|
+
* latter case (see apra-fleet-l7n.3 for surfacing that failure to the
|
|
648
|
+
* operator instead of asserting success).
|
|
649
|
+
*/
|
|
650
|
+
export async function waitForApraFleetToStop() {
|
|
651
|
+
const { pollIntervalMs, graceMs, killGraceMs } = installForceTiming();
|
|
652
|
+
let deadline = Date.now() + graceMs;
|
|
653
|
+
while (isApraFleetRunning() && Date.now() < deadline) {
|
|
654
|
+
await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
|
|
655
|
+
}
|
|
656
|
+
if (!isApraFleetRunning())
|
|
657
|
+
return;
|
|
658
|
+
// Grace window elapsed and a non-installer apra-fleet process is still alive -- escalate.
|
|
659
|
+
killApraFleet('SIGKILL');
|
|
660
|
+
deadline = Date.now() + killGraceMs;
|
|
661
|
+
while (isApraFleetRunning() && Date.now() < deadline) {
|
|
662
|
+
await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
|
|
407
663
|
}
|
|
408
664
|
}
|
|
409
665
|
/**
|
|
@@ -426,7 +682,7 @@ export function writeAgyWorkspaceOverlays(workFolder) {
|
|
|
426
682
|
}
|
|
427
683
|
}
|
|
428
684
|
export async function runInstall(args) {
|
|
429
|
-
// --help / -h guard
|
|
685
|
+
// --help / -h guard - must come first, before any side effects (#142)
|
|
430
686
|
if (args.includes('--help') || args.includes('-h')) {
|
|
431
687
|
console.log(`apra-fleet install
|
|
432
688
|
|
|
@@ -436,20 +692,28 @@ Usage:
|
|
|
436
692
|
apra-fleet install Install binary + hooks + statusline + MCP + fleet & PM skills (default)
|
|
437
693
|
apra-fleet install --skill all Same as bare install (all skills)
|
|
438
694
|
apra-fleet install --skill fleet Install fleet skill only
|
|
439
|
-
apra-fleet install --skill pm Install PM skill (also installs fleet
|
|
695
|
+
apra-fleet install --skill pm Install PM skill (also installs fleet -- PM depends on fleet)
|
|
440
696
|
apra-fleet install --skill none Skip skill installation
|
|
441
697
|
apra-fleet install --no-skill Same as --skill none
|
|
698
|
+
apra-fleet install --workflows none Skip installing the workflow runtime + built-in workflows
|
|
442
699
|
apra-fleet install --force Stop a running server before installing
|
|
443
700
|
apra-fleet install --llm <provider> Target LLM provider: claude (default), gemini, codex, copilot, agy, opencode
|
|
701
|
+
apra-fleet install --transport http Register MCP server with HTTP transport (default)
|
|
702
|
+
apra-fleet install --transport stdio Register MCP server with stdio transport (legacy)
|
|
444
703
|
apra-fleet install --help Show this help
|
|
445
704
|
|
|
446
705
|
Options:
|
|
447
706
|
--llm <provider> LLM provider to configure. Supported: claude, gemini, codex, copilot, agy, opencode.
|
|
448
707
|
Defaults to claude. Note: --llm gemini shows a warning about sequential
|
|
449
|
-
dispatch
|
|
708
|
+
dispatch -- Gemini does not support background agents, so fleet operations
|
|
450
709
|
run sequentially rather than in parallel.
|
|
710
|
+
--transport <mode> MCP transport to use: http (default) or stdio. HTTP uses the singleton
|
|
711
|
+
fleet server at http://localhost:7523/mcp. stdio runs fleet as a subprocess.
|
|
451
712
|
--skill <mode> Which skills to install: all (default), fleet, pm, or none.
|
|
452
713
|
--no-skill Alias for --skill none.
|
|
714
|
+
--workflows <mode> Which workflow assets to install: all (default) or none. Installs
|
|
715
|
+
~/.apra-fleet/node_modules (workflow runtime), /schemas (agent role
|
|
716
|
+
schemas), and /workflows/{fleet-sprint,hello-world} (built-in workflows).
|
|
453
717
|
--force Stop a running apra-fleet server before installing (SEA mode only).`);
|
|
454
718
|
process.exit(0);
|
|
455
719
|
return;
|
|
@@ -492,7 +756,7 @@ Options:
|
|
|
492
756
|
skillMode = nextArg;
|
|
493
757
|
}
|
|
494
758
|
else {
|
|
495
|
-
// --skill with no value
|
|
759
|
+
// --skill with no value - install both (backwards-compat)
|
|
496
760
|
skillMode = 'all';
|
|
497
761
|
}
|
|
498
762
|
}
|
|
@@ -501,11 +765,61 @@ Options:
|
|
|
501
765
|
if (args.includes('--no-skill')) {
|
|
502
766
|
skillMode = 'none';
|
|
503
767
|
}
|
|
768
|
+
let workflowsMode = 'all';
|
|
769
|
+
const workflowsEqualArg = args.find(a => a.startsWith('--workflows='));
|
|
770
|
+
if (workflowsEqualArg) {
|
|
771
|
+
const val = workflowsEqualArg.split('=')[1];
|
|
772
|
+
if (val === 'all' || val === 'none') {
|
|
773
|
+
workflowsMode = val;
|
|
774
|
+
}
|
|
775
|
+
else {
|
|
776
|
+
console.error(`Error: --workflows value must be one of: all, none (got "${val}")`);
|
|
777
|
+
process.exit(1);
|
|
778
|
+
}
|
|
779
|
+
}
|
|
780
|
+
else {
|
|
781
|
+
const workflowsIdx = args.indexOf('--workflows');
|
|
782
|
+
if (workflowsIdx >= 0) {
|
|
783
|
+
const nextArg = args[workflowsIdx + 1];
|
|
784
|
+
if (nextArg === 'all' || nextArg === 'none') {
|
|
785
|
+
workflowsMode = nextArg;
|
|
786
|
+
}
|
|
787
|
+
else {
|
|
788
|
+
console.error(`Error: --workflows requires a value: all or none.`);
|
|
789
|
+
process.exit(1);
|
|
790
|
+
}
|
|
791
|
+
}
|
|
792
|
+
}
|
|
504
793
|
// Parse --force flag
|
|
505
794
|
const force = args.includes('--force');
|
|
795
|
+
let transport = 'http';
|
|
796
|
+
const transportEqualArg = args.find(a => a.startsWith('--transport='));
|
|
797
|
+
if (transportEqualArg) {
|
|
798
|
+
const val = transportEqualArg.split('=')[1];
|
|
799
|
+
if (val === 'http' || val === 'stdio') {
|
|
800
|
+
transport = val;
|
|
801
|
+
}
|
|
802
|
+
else {
|
|
803
|
+
console.error(`Error: --transport value must be one of: http, stdio (got "${val}")`);
|
|
804
|
+
process.exit(1);
|
|
805
|
+
}
|
|
806
|
+
}
|
|
807
|
+
else {
|
|
808
|
+
const transportIdx = args.indexOf('--transport');
|
|
809
|
+
if (transportIdx >= 0 && transportIdx < args.length - 1) {
|
|
810
|
+
const val = args[transportIdx + 1];
|
|
811
|
+
if (val === 'http' || val === 'stdio') {
|
|
812
|
+
transport = val;
|
|
813
|
+
}
|
|
814
|
+
else {
|
|
815
|
+
console.error(`Error: --transport value must be one of: http, stdio (got "${val}")`);
|
|
816
|
+
process.exit(1);
|
|
817
|
+
}
|
|
818
|
+
}
|
|
819
|
+
}
|
|
506
820
|
// Reject unknown flags to catch typos early
|
|
507
|
-
const knownFlagPrefixes = ['--llm=', '--skill='];
|
|
508
|
-
const knownFlagExact = new Set(['--llm', '--skill', '--no-skill', '--force', '--help', '-h']);
|
|
821
|
+
const knownFlagPrefixes = ['--llm=', '--skill=', '--transport=', '--workflows='];
|
|
822
|
+
const knownFlagExact = new Set(['--llm', '--skill', '--no-skill', '--workflows', '--force', '--transport', '--help', '-h']);
|
|
509
823
|
for (const a of args) {
|
|
510
824
|
if (knownFlagExact.has(a))
|
|
511
825
|
continue;
|
|
@@ -519,22 +833,44 @@ Options:
|
|
|
519
833
|
const installFleet = skillMode === 'fleet' || skillMode === 'pm' || skillMode === 'all';
|
|
520
834
|
const installPm = skillMode === 'pm' || skillMode === 'all';
|
|
521
835
|
const installAgents = installPm && paths.agentsDir !== undefined;
|
|
836
|
+
const installWorkflows = workflowsMode === 'all';
|
|
837
|
+
const serviceStep = isSea() && transport === 'http';
|
|
522
838
|
let totalSteps = (installFleet && installPm) ? 8 : installFleet ? 7 : installPm ? 8 : 6;
|
|
523
839
|
if (installAgents)
|
|
524
840
|
totalSteps++;
|
|
525
841
|
if (installPm)
|
|
526
842
|
totalSteps++; // cost.js extraction + workflow copy step
|
|
843
|
+
if (installWorkflows)
|
|
844
|
+
totalSteps++; // workflow-subsystem runtime/schemas/built-ins step
|
|
845
|
+
totalSteps++; // dolt CLI install step (apra-fleet-ire.3) -- unconditional, mirrors Beads step
|
|
846
|
+
if (serviceStep)
|
|
847
|
+
totalSteps++;
|
|
527
848
|
if (llm === 'gemini' && (installFleet || installPm)) {
|
|
528
|
-
console.warn(`\n
|
|
849
|
+
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`);
|
|
529
850
|
}
|
|
530
851
|
// --- Running-process guard (SEA + npm modes -- dev mode runs via node, not a managed binary) ---
|
|
531
|
-
|
|
852
|
+
//
|
|
853
|
+
// isApraFleetRunning() is OS-global on purpose (waitForApraFleetToStop() and
|
|
854
|
+
// uninstall.ts depend on that). It is only the cheap first filter here:
|
|
855
|
+
// classifyRunningServer() then decides whether the running server is actually
|
|
856
|
+
// relevant to THIS install -- recorded live in the target data dir, or running
|
|
857
|
+
// from the install prefix we are about to overwrite (ETXTBSY). An unrelated
|
|
858
|
+
// server (isolated HOME/APRA_FLEET_DATA_DIR/prefix, e.g. ci.yml's clean temp
|
|
859
|
+
// prefix step) no longer blocks the install. See apra-fleet-1aw.
|
|
860
|
+
const runningScope = (isSea() || isNpmGlobalInstall()) && isApraFleetRunning()
|
|
861
|
+
? classifyRunningServer(BIN_DIR)
|
|
862
|
+
: null;
|
|
863
|
+
if (runningScope && !runningScope.relevant) {
|
|
864
|
+
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`);
|
|
865
|
+
}
|
|
866
|
+
if (runningScope?.relevant) {
|
|
532
867
|
if (!force) {
|
|
533
868
|
const killHint = process.platform === 'win32'
|
|
534
869
|
? ' taskkill /F /IM apra-fleet.exe'
|
|
535
870
|
: ' pkill -x apra-fleet';
|
|
536
871
|
console.error(`
|
|
537
872
|
Error: apra-fleet is currently running. Stop the server before installing.
|
|
873
|
+
(${runningScope.detail})
|
|
538
874
|
|
|
539
875
|
Run with --force to stop it automatically:
|
|
540
876
|
apra-fleet install --force
|
|
@@ -545,7 +881,15 @@ ${killHint}
|
|
|
545
881
|
process.exit(1);
|
|
546
882
|
}
|
|
547
883
|
killApraFleet();
|
|
548
|
-
await
|
|
884
|
+
await waitForApraFleetToStop();
|
|
885
|
+
if (isApraFleetRunning()) {
|
|
886
|
+
console.error(`
|
|
887
|
+
Error: could not stop the running apra-fleet server (it is still running after
|
|
888
|
+
SIGTERM and a SIGKILL escalation). Stop it manually before installing:
|
|
889
|
+
${process.platform === 'win32' ? ' taskkill /F /IM apra-fleet.exe' : ' pkill -x apra-fleet'}
|
|
890
|
+
`);
|
|
891
|
+
process.exit(1);
|
|
892
|
+
}
|
|
549
893
|
console.log(' Stopped running server.');
|
|
550
894
|
}
|
|
551
895
|
console.log(`\nInstalling Apra Fleet ${serverVersion} for ${paths.name}...\n`);
|
|
@@ -596,49 +940,93 @@ ${killHint}
|
|
|
596
940
|
const installedHooksConfig = JSON.parse(fs.readFileSync(path.join(HOOKS_DIR, 'hooks-config.json'), 'utf-8'));
|
|
597
941
|
mergeHooksConfig(paths, installedHooksConfig, llm);
|
|
598
942
|
const statuslineScript = path.join(SCRIPTS_DIR, 'fleet-statusline.sh');
|
|
599
|
-
configureStatusline(paths, statuslineScript);
|
|
943
|
+
configureStatusline(paths, statuslineScript, llm);
|
|
600
944
|
const standardModel = PROVIDER_STANDARD_MODELS[llm] ?? PROVIDER_STANDARD_MODELS['claude'];
|
|
601
945
|
writeDefaultModel(paths, standardModel);
|
|
602
946
|
}
|
|
603
947
|
// --- Step 5: Register MCP server ---
|
|
604
948
|
console.log(` [5/${totalSteps}] Registering MCP server...`);
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
949
|
+
const fleetPort = DEFAULT_PORT;
|
|
950
|
+
const fleetUrl = `http://localhost:${fleetPort}/mcp`;
|
|
951
|
+
if (transport === 'http') {
|
|
952
|
+
if (llm === 'claude') {
|
|
953
|
+
if (!isCommandAvailable('claude')) {
|
|
954
|
+
console.warn(` Warning: the 'claude' CLI was not found on PATH -- skipping MCP server registration.\n` +
|
|
955
|
+
` Install Claude Code (https://claude.com/claude-code), then re-run 'apra-fleet install'\n` +
|
|
956
|
+
` to register apra-fleet with it, or register manually with:\n` +
|
|
957
|
+
` claude mcp add --scope user --transport http apra-fleet ${fleetUrl}`);
|
|
958
|
+
}
|
|
959
|
+
else {
|
|
960
|
+
try {
|
|
961
|
+
run('claude mcp remove apra-fleet --scope user', { stdio: 'ignore' });
|
|
962
|
+
}
|
|
963
|
+
catch { /* not registered */ }
|
|
964
|
+
run(`claude mcp add --scope user --transport http apra-fleet ${fleetUrl}`);
|
|
965
|
+
}
|
|
966
|
+
}
|
|
967
|
+
else if (llm === 'gemini') {
|
|
968
|
+
mergeGeminiConfig(paths, { httpUrl: fleetUrl });
|
|
969
|
+
}
|
|
970
|
+
else if (llm === 'codex') {
|
|
971
|
+
mergeCodexConfig(paths, { url: fleetUrl });
|
|
972
|
+
}
|
|
973
|
+
else if (llm === 'copilot') {
|
|
974
|
+
mergeCopilotConfig(paths, { url: fleetUrl, type: 'http' });
|
|
975
|
+
}
|
|
976
|
+
else if (llm === 'agy') {
|
|
977
|
+
mergeAgyConfig(paths, { url: fleetUrl });
|
|
978
|
+
}
|
|
979
|
+
else if (llm === 'opencode') {
|
|
980
|
+
mergeOpenCodeConfig(paths, { url: fleetUrl });
|
|
616
981
|
}
|
|
617
|
-
catch { /* not registered */ }
|
|
618
|
-
// Build the claude MCP command from the actual mcpConfig structure.
|
|
619
|
-
// All args are quoted and joined so paths with spaces (e.g. Windows "Program Files") work.
|
|
620
|
-
const quotedArgs = mcpConfig.args.map((a) => `"${a.replace(/"/g, '\\"')}"`).join(' ');
|
|
621
|
-
const cmd = `claude mcp add --scope user apra-fleet -- "${mcpConfig.command}" ${quotedArgs}`;
|
|
622
|
-
run(cmd);
|
|
623
|
-
}
|
|
624
|
-
else if (llm === 'gemini') {
|
|
625
|
-
mergeGeminiConfig(paths, mcpConfig);
|
|
626
|
-
}
|
|
627
|
-
else if (llm === 'codex') {
|
|
628
|
-
mergeCodexConfig(paths, mcpConfig);
|
|
629
|
-
}
|
|
630
|
-
else if (llm === 'copilot') {
|
|
631
|
-
mergeCopilotConfig(paths, mcpConfig);
|
|
632
|
-
}
|
|
633
|
-
else if (llm === 'agy') {
|
|
634
|
-
mergeAgyConfig(paths, mcpConfig);
|
|
635
982
|
}
|
|
636
|
-
else
|
|
637
|
-
|
|
983
|
+
else {
|
|
984
|
+
// 'run --transport stdio' starts the stdio MCP server; passed as trailing args so
|
|
985
|
+
// LLM providers invoke `apra-fleet run` (or `node dist/index.js run`) and the no-arg
|
|
986
|
+
// default (installation) is never accidentally triggered by the MCP host.
|
|
987
|
+
const mcpConfig = isSea()
|
|
988
|
+
? { command: binaryPath, args: ['run', '--transport', 'stdio'] }
|
|
989
|
+
: isNpmGlobalInstall()
|
|
990
|
+
? { command: process.execPath, args: [process.argv[1], 'run', '--transport', 'stdio'] }
|
|
991
|
+
: { command: 'node', args: [path.join(findProjectRoot(), 'dist', 'index.js'), 'run', '--transport', 'stdio'] };
|
|
992
|
+
if (llm === 'claude') {
|
|
993
|
+
// Build the claude MCP command from the actual mcpConfig structure.
|
|
994
|
+
// All args are quoted and joined so paths with spaces (e.g. Windows "Program Files") work.
|
|
995
|
+
const quotedArgs = mcpConfig.args.map((a) => `"${a.replace(/"/g, '\\"')}"`).join(' ');
|
|
996
|
+
const cmd = `claude mcp add --scope user apra-fleet -- "${mcpConfig.command}" ${quotedArgs}`;
|
|
997
|
+
if (!isCommandAvailable('claude')) {
|
|
998
|
+
console.warn(` Warning: the 'claude' CLI was not found on PATH -- skipping MCP server registration.\n` +
|
|
999
|
+
` Install Claude Code (https://claude.com/claude-code), then re-run 'apra-fleet install'\n` +
|
|
1000
|
+
` to register apra-fleet with it, or register manually with:\n` +
|
|
1001
|
+
` ${cmd}`);
|
|
1002
|
+
}
|
|
1003
|
+
else {
|
|
1004
|
+
try {
|
|
1005
|
+
run('claude mcp remove apra-fleet --scope user', { stdio: 'ignore' });
|
|
1006
|
+
}
|
|
1007
|
+
catch { /* not registered */ }
|
|
1008
|
+
run(cmd);
|
|
1009
|
+
}
|
|
1010
|
+
}
|
|
1011
|
+
else if (llm === 'gemini') {
|
|
1012
|
+
mergeGeminiConfig(paths, mcpConfig);
|
|
1013
|
+
}
|
|
1014
|
+
else if (llm === 'codex') {
|
|
1015
|
+
mergeCodexConfig(paths, mcpConfig);
|
|
1016
|
+
}
|
|
1017
|
+
else if (llm === 'copilot') {
|
|
1018
|
+
mergeCopilotConfig(paths, mcpConfig);
|
|
1019
|
+
}
|
|
1020
|
+
else if (llm === 'agy') {
|
|
1021
|
+
mergeAgyConfig(paths, mcpConfig);
|
|
1022
|
+
}
|
|
1023
|
+
else if (llm === 'opencode') {
|
|
1024
|
+
mergeOpenCodeConfig(paths, mcpConfig);
|
|
1025
|
+
}
|
|
638
1026
|
}
|
|
639
1027
|
// --- Step 6: Install fleet skill (optional) ---
|
|
640
1028
|
if (skillMode === 'pm') {
|
|
641
|
-
console.warn(`\n
|
|
1029
|
+
console.warn(`\n- Note: PM skill depends on fleet skill - installing fleet skill first.\n`);
|
|
642
1030
|
}
|
|
643
1031
|
if (installFleet) {
|
|
644
1032
|
console.log(` [6/${totalSteps}] Installing fleet skill...`);
|
|
@@ -657,20 +1045,6 @@ ${killHint}
|
|
|
657
1045
|
}
|
|
658
1046
|
}
|
|
659
1047
|
// --- Step 7: Install PM skill (optional) ---
|
|
660
|
-
// Empty-submodule guard: vendor/apra-pm dir exists but was not initialized
|
|
661
|
-
if (installPm && !isSea()) {
|
|
662
|
-
const root = findProjectRoot();
|
|
663
|
-
const vendorDir = path.join(root, 'vendor', 'apra-pm');
|
|
664
|
-
if (fs.existsSync(vendorDir)) {
|
|
665
|
-
const skillMarker = path.join(vendorDir, 'skills', 'pm', 'SKILL.md');
|
|
666
|
-
if (!fs.existsSync(skillMarker)) {
|
|
667
|
-
console.error(`Error: vendor/apra-pm exists but appears empty (non-recursive clone).
|
|
668
|
-
Run: git submodule update --init --recursive
|
|
669
|
-
Then re-run: apra-fleet install`);
|
|
670
|
-
process.exit(1);
|
|
671
|
-
}
|
|
672
|
-
}
|
|
673
|
-
}
|
|
674
1048
|
if (installPm) {
|
|
675
1049
|
console.log(` [7/${totalSteps}] Installing PM skill...`);
|
|
676
1050
|
clearDirSync(paths.skillsDir);
|
|
@@ -682,9 +1056,9 @@ Then re-run: apra-fleet install`);
|
|
|
682
1056
|
}
|
|
683
1057
|
}
|
|
684
1058
|
else {
|
|
685
|
-
// Dev/npm mode: prefer
|
|
1059
|
+
// Dev/npm mode: prefer apra-pm local copy, fall back to dist/
|
|
686
1060
|
const root = findProjectRoot();
|
|
687
|
-
const vendorPm = path.join(root, '
|
|
1061
|
+
const vendorPm = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', 'skills', 'pm');
|
|
688
1062
|
const pmSrc = fs.existsSync(vendorPm) ? vendorPm : path.join(root, 'dist', 'skills', 'pm');
|
|
689
1063
|
copyDirSync(pmSrc, paths.skillsDir);
|
|
690
1064
|
}
|
|
@@ -702,7 +1076,7 @@ Then re-run: apra-fleet install`);
|
|
|
702
1076
|
}
|
|
703
1077
|
else {
|
|
704
1078
|
const root = findProjectRoot();
|
|
705
|
-
const wfPath = path.join(root, '
|
|
1079
|
+
const wfPath = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', '.claude', 'workflows', 'auto-sprint.js');
|
|
706
1080
|
const wfFallback = path.join(root, 'dist', 'workflows', 'auto-sprint.js');
|
|
707
1081
|
const wfSrc = fs.existsSync(wfPath) ? wfPath : fs.existsSync(wfFallback) ? wfFallback : null;
|
|
708
1082
|
if (wfSrc)
|
|
@@ -761,11 +1135,11 @@ Then re-run: apra-fleet install`);
|
|
|
761
1135
|
}))
|
|
762
1136
|
: (() => {
|
|
763
1137
|
const root = findProjectRoot();
|
|
764
|
-
const vendorArgsSkill = path.join(root, '
|
|
1138
|
+
const vendorArgsSkill = path.join(root, 'packages', 'apra-fleet-se', 'apra-pm', '.claude', 'skills', AUTO_SPRINT_ARGS_SKILL_NAME);
|
|
765
1139
|
const distArgsSkill = path.join(root, 'dist', 'skills', AUTO_SPRINT_ARGS_SKILL_NAME);
|
|
766
1140
|
const argsSkillSrc = fs.existsSync(vendorArgsSkill) ? vendorArgsSkill : distArgsSkill;
|
|
767
1141
|
const argsSkillBase = fs.existsSync(vendorArgsSkill)
|
|
768
|
-
? `
|
|
1142
|
+
? `packages/apra-fleet-se/apra-pm/.claude/skills/${AUTO_SPRINT_ARGS_SKILL_NAME}`
|
|
769
1143
|
: `dist/skills/${AUTO_SPRINT_ARGS_SKILL_NAME}`;
|
|
770
1144
|
const collected = collectFilesRec(argsSkillSrc, argsSkillBase, argsSkillBase);
|
|
771
1145
|
return Object.entries(collected).map(([relPath, rootRelativeLabel]) => ({
|
|
@@ -784,6 +1158,42 @@ Then re-run: apra-fleet install`);
|
|
|
784
1158
|
}
|
|
785
1159
|
}
|
|
786
1160
|
}
|
|
1161
|
+
// --- fleet-sprint-cli helper skill (all providers) ---
|
|
1162
|
+
// Documents the `apra-fleet workflow fleet-sprint` CLI contract for any LLM
|
|
1163
|
+
// driving apra-fleet. Deliberately NOT gated on provider (every provider gets
|
|
1164
|
+
// it) and NOT gated on installPm (fleet-sprint ships independently of the PM
|
|
1165
|
+
// skill) -- only on "skills are being installed at all".
|
|
1166
|
+
if (installFleet || installPm) {
|
|
1167
|
+
const cliSkillDest = path.join(paths.configDir, 'skills', FLEET_SPRINT_CLI_SKILL_NAME);
|
|
1168
|
+
const cliSkillEntries = isSea()
|
|
1169
|
+
? Object.entries(manifest.fleetSprintCliSkill ?? {}).map(([relPath, assetKey]) => ({
|
|
1170
|
+
relPath,
|
|
1171
|
+
content: extractAsset(assetKey),
|
|
1172
|
+
}))
|
|
1173
|
+
: (() => {
|
|
1174
|
+
const root = findProjectRoot();
|
|
1175
|
+
const vendorCliSkill = path.join(root, ...FLEET_SPRINT_CLI_SKILL_VENDOR_BASE.split('/'));
|
|
1176
|
+
const distCliSkill = path.join(root, 'dist', 'skills', FLEET_SPRINT_CLI_SKILL_NAME);
|
|
1177
|
+
const cliSkillSrc = fs.existsSync(vendorCliSkill) ? vendorCliSkill : distCliSkill;
|
|
1178
|
+
const cliSkillBase = fs.existsSync(vendorCliSkill)
|
|
1179
|
+
? FLEET_SPRINT_CLI_SKILL_VENDOR_BASE
|
|
1180
|
+
: `dist/skills/${FLEET_SPRINT_CLI_SKILL_NAME}`;
|
|
1181
|
+
const collected = collectFilesRec(cliSkillSrc, cliSkillBase, cliSkillBase);
|
|
1182
|
+
return Object.entries(collected).map(([relPath, rootRelativeLabel]) => ({
|
|
1183
|
+
relPath,
|
|
1184
|
+
content: fs.readFileSync(path.join(root, rootRelativeLabel), 'utf-8'),
|
|
1185
|
+
}));
|
|
1186
|
+
})();
|
|
1187
|
+
if (cliSkillEntries.length > 0) {
|
|
1188
|
+
clearDirSync(cliSkillDest);
|
|
1189
|
+
for (const { relPath, content } of cliSkillEntries) {
|
|
1190
|
+
writeAssetFile(path.join(cliSkillDest, relPath), content);
|
|
1191
|
+
}
|
|
1192
|
+
}
|
|
1193
|
+
else {
|
|
1194
|
+
console.warn(` [!] ${FLEET_SPRINT_CLI_SKILL_NAME} skill source not found -- skill not installed`);
|
|
1195
|
+
}
|
|
1196
|
+
}
|
|
787
1197
|
if (!installFleet && !installPm) {
|
|
788
1198
|
console.log(` Skipping skills (use --skill all to install, or omit --skill for default)`);
|
|
789
1199
|
}
|
|
@@ -793,29 +1203,90 @@ Then re-run: apra-fleet install`);
|
|
|
793
1203
|
console.log(` [${agentStep}/${totalSteps}] Installing PM agents...`);
|
|
794
1204
|
const agentsDestDir = paths.agentsDir;
|
|
795
1205
|
fs.mkdirSync(agentsDestDir, { recursive: true });
|
|
1206
|
+
// #336's loadAgentAssets() unifies SEA and dev-mode sourcing; its
|
|
1207
|
+
// dev-mode path reads packages/apra-fleet-se/apra-pm/agents directly (dist/agents only
|
|
1208
|
+
// as a fallback), preserving this branch's no-dist/agents rule, and it
|
|
1209
|
+
// recurses into _shared/ and schemas/ which the old flat readdir missed.
|
|
796
1210
|
for (const { relPath, content: rawContent } of loadAgentAssets()) {
|
|
797
|
-
const content = llm === 'opencode'
|
|
1211
|
+
const content = llm === 'opencode'
|
|
1212
|
+
? transformAgentForOpenCode(rawContent, relPath)
|
|
1213
|
+
: llm === 'agy'
|
|
1214
|
+
? transformAgentForAgy(rawContent, relPath)
|
|
1215
|
+
: rawContent;
|
|
798
1216
|
writeAssetFile(path.join(agentsDestDir, relPath), content);
|
|
799
1217
|
}
|
|
800
1218
|
}
|
|
1219
|
+
// --- Workflow-subsystem install step (optional, --workflows all|none) ---
|
|
1220
|
+
// Writes ~/.apra-fleet/{node_modules,schemas,workflows/{fleet-sprint,hello-world}}.
|
|
1221
|
+
// See docs/workflow-subsystem-plan.md Section 6 / Section 2.1 for the layout.
|
|
1222
|
+
if (installWorkflows) {
|
|
1223
|
+
// Two steps follow workflows (dolt, then Beads) before the optional service step.
|
|
1224
|
+
const workflowsStepNum = serviceStep ? totalSteps - 3 : totalSteps - 2;
|
|
1225
|
+
console.log(` [${workflowsStepNum}/${totalSteps}] Installing workflow runtime...`);
|
|
1226
|
+
// Extraction itself (node_modules / schemas / built-in workflows / .installed.json)
|
|
1227
|
+
// lives in workflow-assets.ts -- the SAME code path workflow.ts's self-heal
|
|
1228
|
+
// launcher path uses on-demand (apra-fleet-7pm.8).
|
|
1229
|
+
extractWorkflowSubsystemAssets({
|
|
1230
|
+
manifest,
|
|
1231
|
+
extractAssetBuffer,
|
|
1232
|
+
version: serverVersion,
|
|
1233
|
+
});
|
|
1234
|
+
}
|
|
1235
|
+
// --- Dolt CLI install step (apra-fleet-ire.3) ---
|
|
1236
|
+
// Portable dolt binary, downloaded straight into BIN_DIR (never system PATH).
|
|
1237
|
+
// Mirrors the Beads install step immediately below: already-installed check
|
|
1238
|
+
// first, download+extract+verify otherwise. NON-FATAL, same as Beads -- a
|
|
1239
|
+
// missing/broken dolt must never fail "apra-fleet install".
|
|
1240
|
+
const doltStep = serviceStep ? totalSteps - 2 : totalSteps - 1;
|
|
1241
|
+
console.log(` [${doltStep}/${totalSteps}] Installing Dolt CLI...`);
|
|
1242
|
+
let doltVersion = 'not available';
|
|
1243
|
+
if (doltStepEnabled()) {
|
|
1244
|
+
try {
|
|
1245
|
+
const doltBinaryName = process.platform === 'win32' ? 'dolt.exe' : 'dolt';
|
|
1246
|
+
const doltPath = path.join(BIN_DIR, doltBinaryName);
|
|
1247
|
+
let installed = false;
|
|
1248
|
+
// Check if already installed
|
|
1249
|
+
if (fs.existsSync(doltPath)) {
|
|
1250
|
+
try {
|
|
1251
|
+
const result = await doltStepDeps.verifyDolt(doltPath);
|
|
1252
|
+
doltVersion = result.version;
|
|
1253
|
+
installed = true;
|
|
1254
|
+
}
|
|
1255
|
+
catch {
|
|
1256
|
+
// existing binary is broken/unusable -- fall through and (re)download
|
|
1257
|
+
}
|
|
1258
|
+
}
|
|
1259
|
+
if (!installed) {
|
|
1260
|
+
// not installed (or broken) -- download and verify it
|
|
1261
|
+
const extractedPath = await doltStepDeps.downloadAndExtractDolt(BIN_DIR);
|
|
1262
|
+
const result = await doltStepDeps.verifyDolt(extractedPath);
|
|
1263
|
+
doltVersion = result.version;
|
|
1264
|
+
}
|
|
1265
|
+
}
|
|
1266
|
+
catch (err) {
|
|
1267
|
+
// non-fatal: warn but don't fail the install
|
|
1268
|
+
console.warn(` Dolt install skipped -- ${err.message}`);
|
|
1269
|
+
}
|
|
1270
|
+
}
|
|
801
1271
|
// --- Beads install step ---
|
|
802
|
-
// shell:true required on Windows
|
|
1272
|
+
// shell:true required on Windows - npm global packages install as .cmd wrappers
|
|
803
1273
|
// that cannot be directly spawned by Node without a shell
|
|
804
|
-
|
|
1274
|
+
const beadsStep = serviceStep ? totalSteps - 1 : totalSteps;
|
|
1275
|
+
console.log(` [${beadsStep}/${totalSteps}] Installing Beads task tracker...`);
|
|
805
1276
|
try {
|
|
806
1277
|
// Check if already installed
|
|
807
1278
|
try {
|
|
808
1279
|
execFileSync('bd', ['--version'], { stdio: 'pipe', shell: true });
|
|
809
|
-
// already installed
|
|
1280
|
+
// already installed - skip
|
|
810
1281
|
}
|
|
811
1282
|
catch {
|
|
812
|
-
// not installed
|
|
1283
|
+
// not installed - install it
|
|
813
1284
|
execFileSync('npm', ['install', '-g', '@beads/bd@1.0.4'], { stdio: 'inherit', shell: true });
|
|
814
1285
|
}
|
|
815
1286
|
}
|
|
816
1287
|
catch (err) {
|
|
817
1288
|
// non-fatal: warn but don't fail the install
|
|
818
|
-
console.warn('
|
|
1289
|
+
console.warn(' - Beads install skipped - npm not available or install failed');
|
|
819
1290
|
}
|
|
820
1291
|
// OpenCode uses --dangerously-skip-permissions and per-agent permission: frontmatter;
|
|
821
1292
|
// a top-level "permissions" key is invalid in opencode.json
|
|
@@ -826,7 +1297,30 @@ Then re-run: apra-fleet install`);
|
|
|
826
1297
|
mergePermissions(paths, extraPerms);
|
|
827
1298
|
}
|
|
828
1299
|
// Write install-config.json (merge provider entry)
|
|
829
|
-
writeInstallConfig(llm, skillMode);
|
|
1300
|
+
writeInstallConfig(llm, skillMode, workflowsMode);
|
|
1301
|
+
// --- Step N: Register and start service (SEA + HTTP mode only) ---
|
|
1302
|
+
let serviceRegistered = false;
|
|
1303
|
+
if (serviceStep) {
|
|
1304
|
+
console.log(` [${totalSteps}/${totalSteps}] Registering and starting service...`);
|
|
1305
|
+
const svcMgr = await getServiceManager();
|
|
1306
|
+
try {
|
|
1307
|
+
await svcMgr.register(binaryPath, ['--transport', 'http'], LOG_FILE_PATH);
|
|
1308
|
+
try {
|
|
1309
|
+
await svcMgr.start();
|
|
1310
|
+
serviceRegistered = true;
|
|
1311
|
+
}
|
|
1312
|
+
catch (startErr) {
|
|
1313
|
+
try {
|
|
1314
|
+
await svcMgr.unregister();
|
|
1315
|
+
}
|
|
1316
|
+
catch { }
|
|
1317
|
+
throw startErr;
|
|
1318
|
+
}
|
|
1319
|
+
}
|
|
1320
|
+
catch (err) {
|
|
1321
|
+
console.warn(` Service registration skipped: ${err.message}`);
|
|
1322
|
+
}
|
|
1323
|
+
}
|
|
830
1324
|
// --- Done ---
|
|
831
1325
|
let beadsVersion = 'installed';
|
|
832
1326
|
try {
|
|
@@ -839,6 +1333,7 @@ Then re-run: apra-fleet install`);
|
|
|
839
1333
|
const clientName = llm === 'claude' ? 'Claude Code' : paths.name;
|
|
840
1334
|
const instructions = llm === 'claude' ? 'Run /mcp in Claude Code to load the server.' : `Restart ${paths.name} to load the server.`;
|
|
841
1335
|
const forceNote = force ? `\nRestart ${clientName} to reload the MCP server.` : '';
|
|
1336
|
+
const serviceLine = serviceStep ? `\n Service: ${serviceRegistered ? 'registered and running' : 'registration skipped'}` : '';
|
|
842
1337
|
console.log(`
|
|
843
1338
|
Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
|
|
844
1339
|
Binary: ${BIN_DIR}
|
|
@@ -846,6 +1341,7 @@ Apra Fleet ${serverVersion} installed successfully for ${paths.name}.
|
|
|
846
1341
|
Scripts: ${SCRIPTS_DIR}
|
|
847
1342
|
Settings: ${paths.settingsFile}${installFleet ? `\n Fleet Skill: ${paths.fleetSkillsDir}` : ''}${installPm ? `\n PM Skill: ${paths.skillsDir}` : ''}${installAgents ? `\n Agents: ${paths.agentsDir}` : ''}
|
|
848
1343
|
Beads: ${beadsVersion}
|
|
1344
|
+
Dolt: ${doltVersion}${serviceLine}
|
|
849
1345
|
|
|
850
1346
|
${instructions}${forceNote}
|
|
851
1347
|
`);
|