@apralabs/apra-fleet 0.3.6 → 0.4.1
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 +378 -252
- package/dist/agents/backlog-groomer.md +303 -0
- package/dist/agents/ci-watcher.md +13 -1
- package/dist/agents/deployer.md +66 -13
- package/dist/agents/doer.md +67 -8
- package/dist/agents/harvester.md +22 -3
- package/dist/agents/integ-test-runner.md +166 -60
- package/dist/agents/kb-reconciler.md +216 -0
- package/dist/agents/plan-reviewer.md +88 -18
- package/dist/agents/planner.md +182 -19
- package/dist/agents/regression-test-runner.md +234 -0
- package/dist/agents/reviewer.md +125 -9
- package/dist/agents/schemas/backlog-groomer-input.json +35 -0
- package/dist/agents/schemas/backlog-groomer-output.json +164 -0
- package/dist/agents/schemas/doer-output.json +63 -3
- package/dist/agents/schemas/harvester-output.json +59 -2
- package/dist/agents/schemas/integ-test-runner-output.json +34 -0
- package/dist/agents/schemas/kb-reconciler-output.json +87 -0
- package/dist/agents/schemas/planner-output.json +65 -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 +108 -7
- 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 +45 -3
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +736 -109
- 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/kb-commit.d.ts +12 -0
- package/dist/cli/kb-commit.d.ts.map +1 -0
- package/dist/cli/kb-commit.js +53 -0
- package/dist/cli/kb-commit.js.map +1 -0
- package/dist/cli/kb-directives.d.ts +17 -0
- package/dist/cli/kb-directives.d.ts.map +1 -0
- package/dist/cli/kb-directives.js +146 -0
- package/dist/cli/kb-directives.js.map +1 -0
- package/dist/cli/kb-import.d.ts +13 -0
- package/dist/cli/kb-import.d.ts.map +1 -0
- package/dist/cli/kb-import.js +56 -0
- package/dist/cli/kb-import.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 +120 -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/watch.d.ts +53 -4
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +118 -17
- package/dist/cli/watch.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/commands/kb-server.d.ts +8 -0
- package/dist/commands/kb-server.d.ts.map +1 -0
- package/dist/commands/kb-server.js +221 -0
- package/dist/commands/kb-server.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 +254 -132
- package/dist/index.js.map +1 -1
- package/dist/os/linux.d.ts +14 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +80 -4
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +15 -0
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows.d.ts +36 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +74 -18
- 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 +20 -2
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +259 -21
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +16 -2
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +283 -16
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +13 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +36 -6
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +13 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +34 -7
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/email/headers.d.ts +15 -0
- package/dist/providers/email/headers.d.ts.map +1 -0
- package/dist/providers/email/headers.js +42 -0
- package/dist/providers/email/headers.js.map +1 -0
- package/dist/providers/email/index.d.ts +18 -0
- package/dist/providers/email/index.d.ts.map +1 -0
- package/dist/providers/email/index.js +60 -0
- package/dist/providers/email/index.js.map +1 -0
- package/dist/providers/email/provider.d.ts +49 -0
- package/dist/providers/email/provider.d.ts.map +1 -0
- package/dist/providers/email/provider.js +2 -0
- package/dist/providers/email/provider.js.map +1 -0
- package/dist/providers/email/sendgrid.d.ts +12 -0
- package/dist/providers/email/sendgrid.d.ts.map +1 -0
- package/dist/providers/email/sendgrid.js +67 -0
- package/dist/providers/email/sendgrid.js.map +1 -0
- package/dist/providers/email/smtp.d.ts +65 -0
- package/dist/providers/email/smtp.d.ts.map +1 -0
- package/dist/providers/email/smtp.js +373 -0
- package/dist/providers/email/smtp.js.map +1 -0
- package/dist/providers/gemini.d.ts +13 -2
- package/dist/providers/gemini.d.ts.map +1 -1
- package/dist/providers/gemini.js +49 -5
- 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 +61 -0
- package/dist/providers/none.d.ts.map +1 -0
- package/dist/providers/none.js +124 -0
- package/dist/providers/none.js.map +1 -0
- package/dist/providers/opencode.d.ts +14 -2
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +104 -4
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +156 -1
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +54 -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 +11 -7
- 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/lifecycle.d.ts.map +1 -1
- package/dist/services/cloud/lifecycle.js +3 -0
- package/dist/services/cloud/lifecycle.js.map +1 -1
- package/dist/services/cloud/task-wrapper.d.ts +18 -0
- package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
- package/dist/services/cloud/task-wrapper.js +157 -0
- package/dist/services/cloud/task-wrapper.js.map +1 -1
- 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 +12 -2
- 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/knowledge/audn.d.ts +37 -0
- package/dist/services/knowledge/audn.d.ts.map +1 -0
- package/dist/services/knowledge/audn.js +219 -0
- package/dist/services/knowledge/audn.js.map +1 -0
- package/dist/services/knowledge/file-hash.d.ts +11 -0
- package/dist/services/knowledge/file-hash.d.ts.map +1 -0
- package/dist/services/knowledge/file-hash.js +123 -0
- package/dist/services/knowledge/file-hash.js.map +1 -0
- package/dist/services/knowledge/http-provider.d.ts +46 -0
- package/dist/services/knowledge/http-provider.d.ts.map +1 -0
- package/dist/services/knowledge/http-provider.js +254 -0
- package/dist/services/knowledge/http-provider.js.map +1 -0
- package/dist/services/knowledge/kb-providers.d.ts +15 -0
- package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
- package/dist/services/knowledge/kb-providers.js +92 -0
- package/dist/services/knowledge/kb-providers.js.map +1 -0
- package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
- package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
- package/dist/services/knowledge/kb-scope-input.js +11 -0
- package/dist/services/knowledge/kb-scope-input.js.map +1 -0
- package/dist/services/knowledge/kb-service.d.ts +3 -0
- package/dist/services/knowledge/kb-service.d.ts.map +1 -0
- package/dist/services/knowledge/kb-service.js +2 -0
- package/dist/services/knowledge/kb-service.js.map +1 -0
- package/dist/services/knowledge/path-validation.d.ts +2 -0
- package/dist/services/knowledge/path-validation.d.ts.map +1 -0
- package/dist/services/knowledge/path-validation.js +13 -0
- package/dist/services/knowledge/path-validation.js.map +1 -0
- package/dist/services/knowledge/pre-init.d.ts +14 -0
- package/dist/services/knowledge/pre-init.d.ts.map +1 -0
- package/dist/services/knowledge/pre-init.js +147 -0
- package/dist/services/knowledge/pre-init.js.map +1 -0
- package/dist/services/knowledge/project-slug.d.ts +2 -0
- package/dist/services/knowledge/project-slug.d.ts.map +1 -0
- package/dist/services/knowledge/project-slug.js +49 -0
- package/dist/services/knowledge/project-slug.js.map +1 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
- package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
- package/dist/services/knowledge/sqlite-provider.js +1646 -0
- package/dist/services/knowledge/sqlite-provider.js.map +1 -0
- package/dist/services/knowledge/types.d.ts +163 -0
- package/dist/services/knowledge/types.d.ts.map +1 -0
- package/dist/services/knowledge/types.js +9 -0
- package/dist/services/knowledge/types.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/member-home.d.ts +89 -0
- package/dist/services/member-home.d.ts.map +1 -0
- package/dist/services/member-home.js +256 -0
- package/dist/services/member-home.js.map +1 -0
- package/dist/services/member-remote-url.d.ts +34 -0
- package/dist/services/member-remote-url.d.ts.map +1 -0
- package/dist/services/member-remote-url.js +39 -0
- package/dist/services/member-remote-url.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 +59 -0
- package/dist/services/orphan-recovery.d.ts.map +1 -0
- package/dist/services/orphan-recovery.js +122 -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/preflight-check.d.ts +56 -0
- package/dist/services/preflight-check.d.ts.map +1 -0
- package/dist/services/preflight-check.js +277 -0
- package/dist/services/preflight-check.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 +11 -8
- package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
- package/dist/services/stall/log-path-resolver.js +17 -33
- package/dist/services/stall/log-path-resolver.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts +32 -0
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +187 -12
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts +50 -0
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +268 -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 +57 -7
- 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 +225 -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/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +32 -1
- package/dist/services/vcs/github.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/services/version-check.d.ts +22 -0
- package/dist/services/version-check.d.ts.map +1 -0
- package/dist/services/version-check.js +103 -0
- package/dist/services/version-check.js.map +1 -0
- package/dist/skills/fleet-sprint-cli/SKILL.md +114 -0
- package/dist/skills/pm/beads.md +6 -0
- package/dist/skills/pm/cost.md +3 -0
- package/dist/skills/pm/doer-reviewer-loop.md +3 -0
- package/dist/skills/pm/fleet-addendum.md +6 -0
- package/dist/skills/pm/index.md +56 -0
- package/dist/skills/pm/kb-reconcile.md +132 -0
- package/dist/skills/pm/kb-review.md +109 -0
- package/dist/tools/check-status.d.ts +47 -0
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +250 -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/code-intelligence-codebase-memory.d.ts +11 -0
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
- package/dist/tools/code-intelligence-codebase-memory.js +270 -0
- package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
- package/dist/tools/code-intelligence-freshness.d.ts +2 -0
- package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
- package/dist/tools/code-intelligence-freshness.js +26 -0
- package/dist/tools/code-intelligence-freshness.js.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
- package/dist/tools/code-intelligence-gitnexus.js +475 -0
- package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
- package/dist/tools/code-intelligence-kb-enrich.js +65 -0
- package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
- package/dist/tools/code-intelligence-reindex.d.ts +7 -0
- package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
- package/dist/tools/code-intelligence-reindex.js +106 -0
- package/dist/tools/code-intelligence-reindex.js.map +1 -0
- package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
- package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
- package/dist/tools/code-intelligence-telemetry.js +52 -0
- package/dist/tools/code-intelligence-telemetry.js.map +1 -0
- package/dist/tools/code-intelligence-tests.d.ts +2 -0
- package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
- package/dist/tools/code-intelligence-tests.js +24 -0
- package/dist/tools/code-intelligence-tests.js.map +1 -0
- package/dist/tools/code-intelligence.d.ts +114 -0
- package/dist/tools/code-intelligence.d.ts.map +1 -0
- package/dist/tools/code-intelligence.js +124 -0
- package/dist/tools/code-intelligence.js.map +1 -0
- package/dist/tools/compose-permissions.d.ts +38 -4
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +295 -33
- 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 +13 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +108 -21
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +84 -12
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +1191 -88
- 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/kb-capture.d.ts +53 -0
- package/dist/tools/kb-capture.d.ts.map +1 -0
- package/dist/tools/kb-capture.js +130 -0
- package/dist/tools/kb-capture.js.map +1 -0
- package/dist/tools/kb-context.d.ts +17 -0
- package/dist/tools/kb-context.d.ts.map +1 -0
- package/dist/tools/kb-context.js +29 -0
- package/dist/tools/kb-context.js.map +1 -0
- package/dist/tools/kb-export.d.ts +19 -0
- package/dist/tools/kb-export.d.ts.map +1 -0
- package/dist/tools/kb-export.js +344 -0
- package/dist/tools/kb-export.js.map +1 -0
- package/dist/tools/kb-feedback.d.ts +23 -0
- package/dist/tools/kb-feedback.d.ts.map +1 -0
- package/dist/tools/kb-feedback.js +43 -0
- package/dist/tools/kb-feedback.js.map +1 -0
- package/dist/tools/kb-freshness-sweep.d.ts +14 -0
- package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
- package/dist/tools/kb-freshness-sweep.js +29 -0
- package/dist/tools/kb-freshness-sweep.js.map +1 -0
- package/dist/tools/kb-harvest.d.ts +20 -0
- package/dist/tools/kb-harvest.d.ts.map +1 -0
- package/dist/tools/kb-harvest.js +143 -0
- package/dist/tools/kb-harvest.js.map +1 -0
- package/dist/tools/kb-import.d.ts +44 -0
- package/dist/tools/kb-import.d.ts.map +1 -0
- package/dist/tools/kb-import.js +239 -0
- package/dist/tools/kb-import.js.map +1 -0
- package/dist/tools/kb-invalidate.d.ts +19 -0
- package/dist/tools/kb-invalidate.d.ts.map +1 -0
- package/dist/tools/kb-invalidate.js +34 -0
- package/dist/tools/kb-invalidate.js.map +1 -0
- package/dist/tools/kb-list.d.ts +32 -0
- package/dist/tools/kb-list.d.ts.map +1 -0
- package/dist/tools/kb-list.js +43 -0
- package/dist/tools/kb-list.js.map +1 -0
- package/dist/tools/kb-promote.d.ts +20 -0
- package/dist/tools/kb-promote.d.ts.map +1 -0
- package/dist/tools/kb-promote.js +20 -0
- package/dist/tools/kb-promote.js.map +1 -0
- package/dist/tools/kb-query.d.ts +35 -0
- package/dist/tools/kb-query.d.ts.map +1 -0
- package/dist/tools/kb-query.js +111 -0
- package/dist/tools/kb-query.js.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
- package/dist/tools/kb-reconcile-prefilter.js +26 -0
- package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
- package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
- package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
- package/dist/tools/kb-resolve-contradiction.js +37 -0
- package/dist/tools/kb-resolve-contradiction.js.map +1 -0
- package/dist/tools/kb-session-prime.d.ts +26 -0
- package/dist/tools/kb-session-prime.d.ts.map +1 -0
- package/dist/tools/kb-session-prime.js +392 -0
- package/dist/tools/kb-session-prime.js.map +1 -0
- package/dist/tools/kb-setup.d.ts +20 -0
- package/dist/tools/kb-setup.d.ts.map +1 -0
- package/dist/tools/kb-setup.js +49 -0
- package/dist/tools/kb-setup.js.map +1 -0
- package/dist/tools/kb-stats.d.ts +20 -0
- package/dist/tools/kb-stats.d.ts.map +1 -0
- package/dist/tools/kb-stats.js +115 -0
- package/dist/tools/kb-stats.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 +16 -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/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +21 -3
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.d.ts.map +1 -1
- package/dist/tools/provision-auth.js +10 -3
- package/dist/tools/provision-auth.js.map +1 -1
- 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 +20 -5
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +174 -6
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts +1 -1
- package/dist/tools/remove-member.d.ts.map +1 -1
- package/dist/tools/remove-member.js +17 -3
- package/dist/tools/remove-member.js.map +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 +45 -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-email.d.ts +69 -0
- package/dist/tools/send-email.d.ts.map +1 -0
- package/dist/tools/send-email.js +177 -0
- package/dist/tools/send-email.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/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +2 -0
- package/dist/tools/setup-ssh-key.js.map +1 -1
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.d.ts.map +1 -1
- package/dist/tools/shutdown-server.js +19 -0
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/update-member.d.ts +11 -8
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +36 -2
- package/dist/tools/update-member.js.map +1 -1
- package/dist/types.d.ts +16 -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/session-caller.d.ts +28 -0
- package/dist/utils/session-caller.d.ts.map +1 -0
- package/dist/utils/session-caller.js +24 -0
- package/dist/utils/session-caller.js.map +1 -0
- package/dist/utils/work-folder-validation.d.ts +39 -0
- package/dist/utils/work-folder-validation.d.ts.map +1 -0
- package/dist/utils/work-folder-validation.js +60 -0
- package/dist/utils/work-folder-validation.js.map +1 -0
- 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 +994 -91
- package/package.json +40 -9
- package/packages/apra-fleet-client/package.json +26 -0
- package/packages/apra-fleet-client/src/client/api.mjs +510 -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 +303 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +101 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +151 -0
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +259 -0
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +188 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +332 -0
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +201 -0
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +322 -0
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +234 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +275 -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 +82 -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 +75 -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/kb-reconciler-output.json +87 -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/planner-output.json +65 -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 +135 -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 +148 -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 +127 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -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 +864 -0
- package/packages/apra-fleet-se/bin/serve.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +178 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +940 -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 +23 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +94 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -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-settle.mjs +972 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +616 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +118 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +10747 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +114 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-lock.mjs +140 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -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 +235 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +942 -0
- package/packages/apra-fleet-se/package.json +29 -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 +1439 -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/run-title.mjs +60 -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 +1727 -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/knowledge-agent.md +66 -0
- package/skills/fleet/permissions.md +76 -2
- package/skills/fleet/profiles/base-dev.json +11 -1
- package/skills/fleet/profiles/base-reviewer.json +9 -1
- package/skills/fleet/profiles/node.json +2 -2
- package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
- 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
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: fleet-sprint-cli
|
|
3
|
+
description: How to launch and supervise apra-fleet's autonomous sprint workflow from the CLI (`apra-fleet workflow fleet-sprint`) -- the --issue/--members/--branch/--base flag contract, the preconditions to check first, how to launch it as a detached process, and how to watch it via its dashboard. Trigger before running `apra-fleet workflow fleet-sprint`.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# fleet-sprint
|
|
7
|
+
|
|
8
|
+
`fleet-sprint` is apra-fleet's autonomous sprint engine. It drives a full
|
|
9
|
+
plan -> develop -> review -> deploy -> integ-test -> harvest cycle across one
|
|
10
|
+
or more registered fleet members, working a set of beads issues on a branch
|
|
11
|
+
and opening a PR at the end.
|
|
12
|
+
|
|
13
|
+
## The command
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
apra-fleet workflow fleet-sprint \
|
|
17
|
+
--issue <id[,id2,...]> \
|
|
18
|
+
--members <name[,name2,...]> \
|
|
19
|
+
--branch <branch-name> \
|
|
20
|
+
--base <base-branch> \
|
|
21
|
+
[--goal P1|P1/P2|P1/P2/P3] # default P1/P2
|
|
22
|
+
[--max-cycles N] # default 5
|
|
23
|
+
[--allow-missing-members]
|
|
24
|
+
[--requirements-file <path>]
|
|
25
|
+
[--role-map <json|@file>] # {"doer":["m1","m2"], ...}
|
|
26
|
+
[--viewer-port <port>] # default 8080
|
|
27
|
+
[--budget <usd>] # default unlimited
|
|
28
|
+
[--dispatch-timeout-s <s>] # default 9000
|
|
29
|
+
[--sync] # synced-topology mode
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
`--issue`, `--members`, `--branch`, and `--base` are required. Verify the
|
|
33
|
+
live flag set with `apra-fleet workflow fleet-sprint --help` before relying
|
|
34
|
+
on this list -- flags evolve and this skill can drift.
|
|
35
|
+
|
|
36
|
+
## Flag notes
|
|
37
|
+
|
|
38
|
+
- `--issue` takes comma-separated **beads parent/epic IDs**. Scope is
|
|
39
|
+
resolved internally via `bd list --parent <id>`, so it only ever
|
|
40
|
+
understands the parent-child hierarchy. A `blocked-by`-only manifest bead
|
|
41
|
+
is invisible to the scope filter no matter what you pass -- only true
|
|
42
|
+
children are picked up. See the epics/manifest-bead guidance in
|
|
43
|
+
`packages/apra-fleet-se/fleet-sprint/docs/README.md`.
|
|
44
|
+
- `--branch` is created from `--base` if it does not already exist. If it
|
|
45
|
+
does exist (e.g. you are resuming), it is reused as-is.
|
|
46
|
+
- **`--base` is resolved against the remote, not your local checkout.** A new
|
|
47
|
+
sprint branch is cut from `origin/<base>`, so any local commit on `<base>`
|
|
48
|
+
that you have not pushed is invisible to the run. Push `<base>` first --
|
|
49
|
+
otherwise the sprint silently starts from an older tree, and work that
|
|
50
|
+
depends on those commits (a `.beads/config.yaml` from `bd init`, a new
|
|
51
|
+
package.json script) fails in ways that look unrelated.
|
|
52
|
+
- `--role-map` assigns specific members to specific roles, e.g.
|
|
53
|
+
`--role-map '{"doer":["m1","m2"],"reviewer":["m3"]}'`. Accepts inline JSON
|
|
54
|
+
or `@path/to/file.json`.
|
|
55
|
+
- `--goal` controls which bead priorities are in scope for the run.
|
|
56
|
+
- `--budget` caps total spend in USD; the run aborts when it is exhausted.
|
|
57
|
+
|
|
58
|
+
## Preconditions to check first
|
|
59
|
+
|
|
60
|
+
1. Every `--issue` target exists and is open: `bd show <id>`, **and already has
|
|
61
|
+
children**: `bd list --parent <id>` must return at least one open bead.
|
|
62
|
+
Pre-sprint validation runs BEFORE the planner, so a childless epic aborts
|
|
63
|
+
the run ("No open/in-progress/blocked/deferred beads found for scope ...")
|
|
64
|
+
rather than being decomposed. The planner refines an existing DAG; it does
|
|
65
|
+
not create the first level of it.
|
|
66
|
+
2. Every `--members` name is registered with the fleet (`list_members` /
|
|
67
|
+
`mcp__apra-fleet__list_members`). An unregistered member aborts the
|
|
68
|
+
sprint unless `--allow-missing-members` is passed.
|
|
69
|
+
3. Multi-member sprints require all members to share the same git topology
|
|
70
|
+
unless `--sync` is passed. Stick to single-member unless that is
|
|
71
|
+
verified -- see `fleet-sprint-diagram.md` in the package docs.
|
|
72
|
+
4. If a member's LLM session is stale or unauthenticated (dispatch fails
|
|
73
|
+
with `empty_response`, or "member CLI likely died"), re-run
|
|
74
|
+
`provision_llm_auth` for that member before retrying.
|
|
75
|
+
|
|
76
|
+
## Launching it
|
|
77
|
+
|
|
78
|
+
Run this on your own orchestrating machine, not on a `--members` target --
|
|
79
|
+
members are dispatch destinations, not where this command runs.
|
|
80
|
+
|
|
81
|
+
Use the delivered `apra-fleet` binary (on PATH after `npm run build:binary`),
|
|
82
|
+
and start it as a genuinely detached OS process. A harness-owned background
|
|
83
|
+
task can be silently killed when its owning tool call's process group ends,
|
|
84
|
+
which orphans the sprint mid-run.
|
|
85
|
+
|
|
86
|
+
Windows:
|
|
87
|
+
|
|
88
|
+
```powershell
|
|
89
|
+
Start-Process -FilePath "apra-fleet" -ArgumentList "workflow","fleet-sprint", `
|
|
90
|
+
"--issue","<id>","--members","<name>","--branch","<branch>","--base","<base>" `
|
|
91
|
+
-RedirectStandardOutput "<log>.log" -RedirectStandardError "<log>.err.log" `
|
|
92
|
+
-WindowStyle Hidden -PassThru
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
POSIX:
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
nohup apra-fleet workflow fleet-sprint \
|
|
99
|
+
--issue <id> --members <name> --branch <branch> --base <base> \
|
|
100
|
+
> sprint.log 2>&1 &
|
|
101
|
+
disown
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
From a source checkout you can run the same engine directly with
|
|
105
|
+
`node packages/apra-fleet-se/bin/cli.mjs <same flags>`. That form runs the
|
|
106
|
+
working tree instead of the installed copy -- use it when developing the
|
|
107
|
+
engine itself, and the packaged binary otherwise.
|
|
108
|
+
|
|
109
|
+
## Watching it
|
|
110
|
+
|
|
111
|
+
On start, the run prints a dashboard URL (`http://localhost:<viewer-port>`,
|
|
112
|
+
default port 8080). Watch progress there rather than tailing raw stdout --
|
|
113
|
+
the dashboard shows per-role activity, the bead DAG, live cost, and the
|
|
114
|
+
final verdict and PR link.
|
|
@@ -0,0 +1,350 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: fleet-supervisor
|
|
3
|
+
description: How to start/smoke-test the supervisor process itself, and start, check, and kill fleet-sprints via its HTTP API only (POST /api/sprints on localhost:8787). Never call the fleet-sprint CLI directly. Trigger whenever asked to start/launch/check/stop/kill the supervisor or a sprint.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# fleet-supervisor (supervisor API)
|
|
7
|
+
|
|
8
|
+
Sprints are started, checked, and killed through the supervisor's HTTP API.
|
|
9
|
+
Default port: **8787**. Never invoke `apra-fleet workflow fleet-sprint` or
|
|
10
|
+
`bin/cli.mjs` directly -- always go through this API.
|
|
11
|
+
|
|
12
|
+
## 0. Start the supervisor (if not already running)
|
|
13
|
+
|
|
14
|
+
Check first: `curl -s -m 5 http://localhost:8787/api/sprints`. Connection
|
|
15
|
+
refused/timeout = not running. `{"sprints": [...]}` = already up, skip this.
|
|
16
|
+
|
|
17
|
+
Start it detached (it runs indefinitely -- exits only on `POST
|
|
18
|
+
/api/shutdown` or SIGINT/SIGTERM, never on its own):
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
node packages/apra-fleet-se/bin/serve.mjs # background/detached, from repo root
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
`--port <n>` overrides the default (8787). Self-logs to
|
|
25
|
+
`<dataDir>/logs/supervisor.log` in addition to stdout.
|
|
26
|
+
|
|
27
|
+
Smoke test (a few seconds after launch -- give it time to bind):
|
|
28
|
+
```bash
|
|
29
|
+
curl -s -m 5 http://localhost:8787/api/sprints # expect {"sprints":[],...}
|
|
30
|
+
curl -s -m 5 http://localhost:8787/api/members # expect the registered fleet, non-empty
|
|
31
|
+
```
|
|
32
|
+
Both must succeed before treating the supervisor as up -- a bound port with
|
|
33
|
+
a 500 on `/api/members` still means something is broken.
|
|
34
|
+
|
|
35
|
+
## Stop the supervisor
|
|
36
|
+
|
|
37
|
+
Two paths: **graceful** (preferred -- lets in-flight requests finish and every
|
|
38
|
+
seam tear down cleanly) and **hard-stop** (only when the API itself is
|
|
39
|
+
unresponsive, e.g. a hung event loop). Resolve commands per the target
|
|
40
|
+
member's own OS (`agent.os`) -- do not assume the orchestrator's shell; some
|
|
41
|
+
members run PowerShell, not POSIX.
|
|
42
|
+
|
|
43
|
+
### Graceful (preferred)
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
curl -s -X POST http://localhost:8787/api/shutdown
|
|
47
|
+
```
|
|
48
|
+
Returns `{"status":"shutting-down"}` immediately; the process then finishes
|
|
49
|
+
tearing down every seam (ledger, watchdog, dashboard, etc) and exits on its
|
|
50
|
+
own a moment later. Confirm it is actually gone:
|
|
51
|
+
```bash
|
|
52
|
+
curl -s -m 5 http://localhost:8787/api/sprints # expect connection refused
|
|
53
|
+
```
|
|
54
|
+
If that still connects after a few seconds, fall through to hard-stop below.
|
|
55
|
+
|
|
56
|
+
### Find the supervisor's PID/port (when the API is unresponsive)
|
|
57
|
+
|
|
58
|
+
`GET /api/health` normally reports the running `pid` directly (`curl -s -m 5
|
|
59
|
+
http://localhost:8787/api/health`), but if the API itself is unresponsive
|
|
60
|
+
that call will hang or refuse -- fall back to an OS-level lookup by port
|
|
61
|
+
(default **8787**) or process name (`serve.mjs`):
|
|
62
|
+
|
|
63
|
+
**macOS / Linux:**
|
|
64
|
+
```bash
|
|
65
|
+
lsof -i :8787 # shows the PID (COMMAND, PID columns) bound to the port
|
|
66
|
+
lsof -ti:8787 # PID only, convenient for command substitution
|
|
67
|
+
# or, by process name if the port lookup finds nothing (already unbound but
|
|
68
|
+
# the process is still alive/hung):
|
|
69
|
+
pgrep -f 'bin/serve.mjs'
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
**Windows (PowerShell):**
|
|
73
|
+
```powershell
|
|
74
|
+
Get-NetTCPConnection -LocalPort 8787 | Select-Object OwningProcess
|
|
75
|
+
Get-Process -Id <pid> # confirm it is the supervisor before killing it
|
|
76
|
+
# or, by process name:
|
|
77
|
+
Get-Process | Where-Object { $_.Path -like '*serve.mjs*' -or $_.CommandLine -like '*serve.mjs*' }
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
**Windows (cmd.exe, if PowerShell is unavailable):**
|
|
81
|
+
```cmd
|
|
82
|
+
netstat -ano | findstr :8787
|
|
83
|
+
tasklist /FI "PID eq <pid>"
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### Hard-stop (PID-based kill)
|
|
87
|
+
|
|
88
|
+
Only once you have confirmed the PID above is actually the supervisor
|
|
89
|
+
process. Try a graceful signal first, then force:
|
|
90
|
+
|
|
91
|
+
**macOS / Linux:**
|
|
92
|
+
```bash
|
|
93
|
+
kill <pid> # SIGTERM -- gives it a chance to exit cleanly
|
|
94
|
+
sleep 2
|
|
95
|
+
kill -0 <pid> 2>/dev/null && kill -9 <pid> # still alive? force it
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
**Windows (PowerShell):**
|
|
99
|
+
```powershell
|
|
100
|
+
Stop-Process -Id <pid> # graceful-ish first attempt
|
|
101
|
+
Stop-Process -Id <pid> -Force # still running? force-kill
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
**Windows (cmd.exe):**
|
|
105
|
+
```cmd
|
|
106
|
+
taskkill /PID <pid>
|
|
107
|
+
taskkill /PID <pid> /F
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
After either path, verify the port is free before restarting:
|
|
111
|
+
`curl -s -m 5 http://localhost:8787/api/sprints` must refuse the connection
|
|
112
|
+
(macOS/Linux), or the port-lookup command above must return nothing
|
|
113
|
+
(Windows).
|
|
114
|
+
|
|
115
|
+
## Restart the supervisor
|
|
116
|
+
|
|
117
|
+
A discrete stop-then-start procedure -- use this instead of assuming a bare
|
|
118
|
+
restart command exists:
|
|
119
|
+
|
|
120
|
+
1. **Stop** it: graceful shutdown above; if that does not actually stop it
|
|
121
|
+
(still answering after a few seconds), fall back to the hard-stop path
|
|
122
|
+
above.
|
|
123
|
+
2. **Confirm it is down**: `curl -s -m 5 http://localhost:8787/api/sprints`
|
|
124
|
+
must refuse the connection (or the per-OS port lookup above returns
|
|
125
|
+
nothing).
|
|
126
|
+
3. **Start** it again: see section 0 ("Start the supervisor") above, then
|
|
127
|
+
run its smoke test (`GET /api/sprints`, `GET /api/members`) to confirm the
|
|
128
|
+
new process is actually serving before treating the restart as done.
|
|
129
|
+
|
|
130
|
+
## Auto-start on login/boot
|
|
131
|
+
|
|
132
|
+
Instead of a human running `node bin/serve.mjs` by hand each session, the
|
|
133
|
+
supervisor can be registered with the OS to start automatically on
|
|
134
|
+
login/boot. Resolve commands per the target member's own OS (`agent.os`) --
|
|
135
|
+
do not assume the orchestrator's shell; some members run PowerShell, not
|
|
136
|
+
POSIX. Every example below assumes the repo root is
|
|
137
|
+
`/path/to/apra-fleet` (POSIX) or `C:\path\to\apra-fleet` (Windows) --
|
|
138
|
+
substitute the real path on the target member. After registering (any OS),
|
|
139
|
+
run the same-process smoke test from section 0 above (`GET /api/sprints`,
|
|
140
|
+
`GET /api/members`) against the newly auto-started instance to confirm it is
|
|
141
|
+
actually serving, not just that the OS accepted the registration.
|
|
142
|
+
|
|
143
|
+
### Windows
|
|
144
|
+
|
|
145
|
+
**Option A -- Task Scheduler, "At log on" trigger** (simplest; runs in the
|
|
146
|
+
user's own session):
|
|
147
|
+
|
|
148
|
+
Register:
|
|
149
|
+
```cmd
|
|
150
|
+
schtasks /Create /TN "ApraFleetSupervisor" /TR "node C:\path\to\apra-fleet\packages\apra-fleet-se\bin\serve.mjs" /SC ONLOGON /RL LIMITED
|
|
151
|
+
```
|
|
152
|
+
De-register:
|
|
153
|
+
```cmd
|
|
154
|
+
schtasks /Delete /TN "ApraFleetSupervisor" /F
|
|
155
|
+
```
|
|
156
|
+
Confirm it registered:
|
|
157
|
+
```cmd
|
|
158
|
+
schtasks /Query /TN "ApraFleetSupervisor"
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
**Option B -- a Windows service via NSSM** (runs even with nobody logged
|
|
162
|
+
in; requires NSSM installed and on PATH):
|
|
163
|
+
|
|
164
|
+
Register:
|
|
165
|
+
```cmd
|
|
166
|
+
nssm install ApraFleetSupervisor node "C:\path\to\apra-fleet\packages\apra-fleet-se\bin\serve.mjs"
|
|
167
|
+
nssm set ApraFleetSupervisor AppDirectory "C:\path\to\apra-fleet"
|
|
168
|
+
nssm start ApraFleetSupervisor
|
|
169
|
+
```
|
|
170
|
+
De-register:
|
|
171
|
+
```cmd
|
|
172
|
+
nssm stop ApraFleetSupervisor
|
|
173
|
+
nssm remove ApraFleetSupervisor confirm
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
### macOS (launchd user LaunchAgent)
|
|
177
|
+
|
|
178
|
+
Create `~/Library/LaunchAgents/com.apra-fleet.supervisor.plist`:
|
|
179
|
+
```xml
|
|
180
|
+
<?xml version="1.0" encoding="UTF-8"?>
|
|
181
|
+
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
|
|
182
|
+
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
|
183
|
+
<plist version="1.0">
|
|
184
|
+
<dict>
|
|
185
|
+
<key>Label</key>
|
|
186
|
+
<string>com.apra-fleet.supervisor</string>
|
|
187
|
+
<key>ProgramArguments</key>
|
|
188
|
+
<array>
|
|
189
|
+
<string>/usr/local/bin/node</string>
|
|
190
|
+
<string>/path/to/apra-fleet/packages/apra-fleet-se/bin/serve.mjs</string>
|
|
191
|
+
</array>
|
|
192
|
+
<key>RunAtLoad</key>
|
|
193
|
+
<true/>
|
|
194
|
+
<key>KeepAlive</key>
|
|
195
|
+
<false/>
|
|
196
|
+
<key>StandardOutPath</key>
|
|
197
|
+
<string>/tmp/apra-fleet-supervisor.log</string>
|
|
198
|
+
<key>StandardErrorPath</key>
|
|
199
|
+
<string>/tmp/apra-fleet-supervisor.log</string>
|
|
200
|
+
</dict>
|
|
201
|
+
</plist>
|
|
202
|
+
```
|
|
203
|
+
`RunAtLoad` starts it at login; `KeepAlive` is deliberately `false` -- the
|
|
204
|
+
supervisor already runs indefinitely on its own (see section 0), so it does
|
|
205
|
+
not need launchd to respawn it on exit (an explicit `POST /api/shutdown`
|
|
206
|
+
should stay stopped, not bounce back up). launchd runs with a minimal PATH
|
|
207
|
+
(`/usr/bin:/bin:/usr/sbin:/sbin`), so a bare `node` command will not resolve
|
|
208
|
+
if node is installed via Homebrew or a version manager. Use the real path to
|
|
209
|
+
`node` on your system (`which node`) if it differs from `/usr/local/bin/node`.
|
|
210
|
+
|
|
211
|
+
Register (load) and start now:
|
|
212
|
+
```bash
|
|
213
|
+
launchctl load ~/Library/LaunchAgents/com.apra-fleet.supervisor.plist
|
|
214
|
+
launchctl start com.apra-fleet.supervisor
|
|
215
|
+
```
|
|
216
|
+
De-register (stop and unload, so it no longer starts at login):
|
|
217
|
+
```bash
|
|
218
|
+
launchctl stop com.apra-fleet.supervisor
|
|
219
|
+
launchctl unload ~/Library/LaunchAgents/com.apra-fleet.supervisor.plist
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
### Linux (systemd --user unit)
|
|
223
|
+
|
|
224
|
+
Create `~/.config/systemd/user/apra-fleet-supervisor.service`:
|
|
225
|
+
```ini
|
|
226
|
+
[Unit]
|
|
227
|
+
Description=Apra Fleet supervisor
|
|
228
|
+
|
|
229
|
+
[Service]
|
|
230
|
+
ExecStart=/usr/bin/node /path/to/apra-fleet/packages/apra-fleet-se/bin/serve.mjs
|
|
231
|
+
Restart=no
|
|
232
|
+
WorkingDirectory=/path/to/apra-fleet
|
|
233
|
+
|
|
234
|
+
[Install]
|
|
235
|
+
WantedBy=default.target
|
|
236
|
+
```
|
|
237
|
+
`Restart=no` matches the launchd `KeepAlive=false` choice above: the
|
|
238
|
+
supervisor is already self-persistent (section 0), and an explicit `POST
|
|
239
|
+
/api/shutdown` should stay stopped rather than being auto-respawned by the
|
|
240
|
+
unit. Use the real path to `node` on the target member (`which node`) if it
|
|
241
|
+
differs from `/usr/bin/node`.
|
|
242
|
+
|
|
243
|
+
Register and start:
|
|
244
|
+
```bash
|
|
245
|
+
systemctl --user daemon-reload
|
|
246
|
+
systemctl --user enable apra-fleet-supervisor.service
|
|
247
|
+
systemctl --user start apra-fleet-supervisor.service
|
|
248
|
+
```
|
|
249
|
+
De-register (stop and disable, so it no longer starts at login/boot):
|
|
250
|
+
```bash
|
|
251
|
+
systemctl --user stop apra-fleet-supervisor.service
|
|
252
|
+
systemctl --user disable apra-fleet-supervisor.service
|
|
253
|
+
```
|
|
254
|
+
A user unit only starts at login unless lingering is enabled for boot-time
|
|
255
|
+
start with no login (`loginctl enable-linger <username>`).
|
|
256
|
+
|
|
257
|
+
## 1. Before you launch a sprint
|
|
258
|
+
|
|
259
|
+
1. If you just created/edited beads locally, push them first:
|
|
260
|
+
`bd dolt commit` then `bd dolt push`. Members pull their own copy; a
|
|
261
|
+
sprint launched before the push works from stale scope.
|
|
262
|
+
2. Check no conflicting sprint is already running: `GET /api/sprints`.
|
|
263
|
+
3. Multi-member sprints need all members on the SAME git HEAD, or the
|
|
264
|
+
launch crashes immediately with a topology error. If unsure, use ONE
|
|
265
|
+
member. Don't guess a member list -- ask, or default to one.
|
|
266
|
+
|
|
267
|
+
## 2. Start a sprint
|
|
268
|
+
|
|
269
|
+
```bash
|
|
270
|
+
curl -s -X POST http://localhost:8787/api/sprints \
|
|
271
|
+
-H "Content-Type: application/json" \
|
|
272
|
+
-d '{
|
|
273
|
+
"issue": "<id[,id2,...]>",
|
|
274
|
+
"branch": "<new-or-existing-branch>",
|
|
275
|
+
"base": "<base-branch>",
|
|
276
|
+
"members": ["<member-name>"],
|
|
277
|
+
"goal": "P1/P2"
|
|
278
|
+
}'
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
Field names, exactly as the API expects them:
|
|
282
|
+
|
|
283
|
+
| Field | Required | Notes |
|
|
284
|
+
|---|---|---|
|
|
285
|
+
| `issue` | yes | comma-separated bead root IDs (parent/epic OR a standalone leaf bead). Alias: `target_issue`. |
|
|
286
|
+
| `branch` | yes | created from `base` if it doesn't exist yet. |
|
|
287
|
+
| `base` | yes | alias: `base_branch`. This is what the sprint branches FROM -- pass the branch you actually want, not always `main`. |
|
|
288
|
+
| `members` | yes | array of registered member names. One member = safest default. |
|
|
289
|
+
| `goal` | no | `P1`, `P1/P2` (default), or `P1/P2/P3`. |
|
|
290
|
+
| `maxCycles` | no | default 5. |
|
|
291
|
+
| `allowMissingMembers` | no | bool. |
|
|
292
|
+
| `requirementsFile` | no | path. |
|
|
293
|
+
| `roleMap` | no | `{"doer":["m1","m2"], "reviewer":["m3"]}`. |
|
|
294
|
+
| `budget` | no | USD cap. |
|
|
295
|
+
| `overrideRelaunchGate` | no | bool. See below. |
|
|
296
|
+
|
|
297
|
+
Response has `sprintId`, `pid`, `port` (its own dashboard), `logPath`.
|
|
298
|
+
**A 201 response does NOT mean the sprint is alive** -- it can crash in the
|
|
299
|
+
first few seconds (bad topology, bad member, etc). Always verify (step 3)
|
|
300
|
+
a few seconds after launch.
|
|
301
|
+
|
|
302
|
+
## 3. Check status
|
|
303
|
+
|
|
304
|
+
All live sprints:
|
|
305
|
+
```bash
|
|
306
|
+
curl -s http://localhost:8787/api/sprints
|
|
307
|
+
```
|
|
308
|
+
Empty `sprints: []` after a launch = it already died. Check its `logPath`.
|
|
309
|
+
|
|
310
|
+
One sprint (live state, or its terminal record if it finished/crashed):
|
|
311
|
+
```bash
|
|
312
|
+
curl -s http://localhost:8787/api/sprints/<sprintId>
|
|
313
|
+
```
|
|
314
|
+
|
|
315
|
+
Sprint-scoped dashboard (per-role activity, bead DAG, cost, PR link):
|
|
316
|
+
`http://localhost:<port>` (the `port` from the launch response).
|
|
317
|
+
|
|
318
|
+
## 4. Kill a sprint
|
|
319
|
+
|
|
320
|
+
```bash
|
|
321
|
+
curl -s -X POST http://localhost:8787/api/sprints/<sprintId>/stop
|
|
322
|
+
```
|
|
323
|
+
|
|
324
|
+
## Relaunch gate
|
|
325
|
+
|
|
326
|
+
If a prior run of the SAME issue root ended in a deterministic, unaddressed
|
|
327
|
+
failure (crash, sync conflict, etc), a relaunch is refused with a 409. Once
|
|
328
|
+
you understand and have actually fixed the cause, retry with
|
|
329
|
+
`"overrideRelaunchGate": true` in the body. This is not a silent bypass --
|
|
330
|
+
only use it once you know why the prior run died.
|
|
331
|
+
|
|
332
|
+
## Common launch-time crashes
|
|
333
|
+
|
|
334
|
+
- **Topology mismatch**: members are on different git commits. Fix: use one
|
|
335
|
+
member, or align them first (`git fetch && git checkout <branch>` on
|
|
336
|
+
each), or pass whatever sync option the engine currently exposes -- check
|
|
337
|
+
`docs/architecture.md` "Multi-member topology" section, don't guess.
|
|
338
|
+
- **Unregistered member**: `GET /api/members` to see valid names.
|
|
339
|
+
- **Stale LLM auth**: dispatch fails with `empty_response`. Re-run
|
|
340
|
+
`provision_llm_auth` for that member.
|
|
341
|
+
|
|
342
|
+
## Member layout: isolate deploy/test roles from dev roles
|
|
343
|
+
|
|
344
|
+
For projects where the deployed software runs and is verified LOCALLY on the
|
|
345
|
+
member, give `deployer`, `integ-test-runner`, and `regression-test-runner` a
|
|
346
|
+
dedicated member with its own independent git clone (not a worktree),
|
|
347
|
+
separate from `planner`/`plan-reviewer`/`doer`/`reviewer`, via `roleMap`:
|
|
348
|
+
`{"deployer": ["<deploy-member>"], "integ-test-runner": ["<deploy-member>"],
|
|
349
|
+
"regression-test-runner": ["<deploy-member>"], "doer": ["<dev-member>"], ...}`.
|
|
350
|
+
Dev roles can all safely share one generic member.
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
// apra-fleet-eft.75.2 -- a machine-local pidfile mutex keyed on
|
|
2
|
+
// (branch, members), guarding against a duplicate concurrent `fleet-sprint`
|
|
3
|
+
// engine launch for the SAME sprint.
|
|
4
|
+
//
|
|
5
|
+
// Root incident (apra-fleet-eft.75): a duplicate concurrent runner.js engine
|
|
6
|
+
// dispatched against the same shared git branch/beads DB while the first was
|
|
7
|
+
// still alive (both alive 50+ minutes, a duplicate smoke-test sprint
|
|
8
|
+
// launched by the orphaned first session was itself duplicated by the
|
|
9
|
+
// second). The ONLY thing that had stopped a duplicate concurrent runner
|
|
10
|
+
// before this was an ACCIDENTAL viewer-port-8080 collision -- itself
|
|
11
|
+
// trivially avoided by passing a different --viewer-port, so it was never a
|
|
12
|
+
// real guard. This module is the explicit, always-on mutex that replaces
|
|
13
|
+
// that accident with a deliberate, named lock.
|
|
14
|
+
//
|
|
15
|
+
// One pidfile per (branch, sorted-members) combination lives under
|
|
16
|
+
// `lockDir` (default: a fixed subdirectory of the OS tmpdir; override via
|
|
17
|
+
// APRA_FLEET_SPRINT_LOCK_DIR for test isolation / a non-default host
|
|
18
|
+
// layout). Its content is just the acquiring process's pid as plain text.
|
|
19
|
+
// A conflicting acquire attempt:
|
|
20
|
+
// - if the recorded pid is verifiably alive: refuses with the distinct,
|
|
21
|
+
// named SprintLockHeldError (never falls through to a generic error a
|
|
22
|
+
// caller could accidentally swallow/retry).
|
|
23
|
+
// - if the recorded pid is dead (crashed process that never released
|
|
24
|
+
// cleanly), or the pidfile is unreadable/corrupt: reclaims the stale
|
|
25
|
+
// pidfile and proceeds, exactly once per acquire() call, without a
|
|
26
|
+
// false block.
|
|
27
|
+
|
|
28
|
+
import fs from 'node:fs';
|
|
29
|
+
import path from 'node:path';
|
|
30
|
+
import os from 'node:os';
|
|
31
|
+
import { SprintLockHeldError } from './errors.mjs';
|
|
32
|
+
|
|
33
|
+
export { SprintLockHeldError };
|
|
34
|
+
|
|
35
|
+
function defaultLockDir() {
|
|
36
|
+
return process.env.APRA_FLEET_SPRINT_LOCK_DIR
|
|
37
|
+
|| path.join(os.tmpdir(), 'apra-fleet-sprint-locks');
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Filename-safe key for a (branch, members) pair -- deterministic
|
|
42
|
+
* regardless of `members` input ORDER or duplicate entries, so the SAME
|
|
43
|
+
* sprint (same branch, same member set) always maps to the SAME lock file
|
|
44
|
+
* no matter which order/repetition --members were listed in on either
|
|
45
|
+
* launch.
|
|
46
|
+
* @param {string} branch
|
|
47
|
+
* @param {string[]} members
|
|
48
|
+
* @returns {string}
|
|
49
|
+
*/
|
|
50
|
+
export function sprintLockKey(branch, members) {
|
|
51
|
+
const memberPart = Array.from(new Set((members || []).map(String))).sort().join('+');
|
|
52
|
+
const raw = `${branch}::${memberPart}`;
|
|
53
|
+
return raw.replace(/[^a-zA-Z0-9._+-]/g, '_');
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* True when `pid` is a currently-running process on this machine. Mirrors
|
|
58
|
+
* the fleet server's own isPidAlive (src/utils/pid-helpers.ts) but is
|
|
59
|
+
* reimplemented locally -- this package never imports server TS source
|
|
60
|
+
* directly. EPERM (process exists, owned by a different user) is treated as
|
|
61
|
+
* alive: we could signal it but that does not mean it is dead.
|
|
62
|
+
* @param {number} pid
|
|
63
|
+
* @returns {boolean}
|
|
64
|
+
*/
|
|
65
|
+
function isPidAlive(pid) {
|
|
66
|
+
if (typeof pid !== 'number' || !Number.isInteger(pid) || pid <= 0) return false;
|
|
67
|
+
try {
|
|
68
|
+
process.kill(pid, 0);
|
|
69
|
+
return true;
|
|
70
|
+
} catch (err) {
|
|
71
|
+
return err && err.code === 'EPERM';
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Acquire the sprint lock for (branch, members). Synchronous (pidfile
|
|
77
|
+
* open/write/read are all cheap local-disk ops and every existing call site
|
|
78
|
+
* in this package -- sprint launch, once, before any dispatch -- has no need
|
|
79
|
+
* to await anything else concurrently).
|
|
80
|
+
*
|
|
81
|
+
* @param {{ branch: string, members: string[], lockDir?: string, pid?: number }} opts
|
|
82
|
+
* @returns {{ path: string, release: () => void }}
|
|
83
|
+
* @throws {SprintLockHeldError} when a live process already holds the lock
|
|
84
|
+
* for this exact (branch, members) key, or a concurrent process wins the
|
|
85
|
+
* reclaim race.
|
|
86
|
+
*/
|
|
87
|
+
export function acquireSprintLock({ branch, members, lockDir = defaultLockDir(), pid = process.pid }) {
|
|
88
|
+
fs.mkdirSync(lockDir, { recursive: true });
|
|
89
|
+
const key = sprintLockKey(branch, members);
|
|
90
|
+
const lockPath = path.join(lockDir, `${key}.lock`);
|
|
91
|
+
|
|
92
|
+
function tryAcquire(allowReclaim) {
|
|
93
|
+
try {
|
|
94
|
+
const fd = fs.openSync(lockPath, 'wx');
|
|
95
|
+
fs.writeSync(fd, String(pid));
|
|
96
|
+
fs.closeSync(fd);
|
|
97
|
+
return {
|
|
98
|
+
path: lockPath,
|
|
99
|
+
release: () => { try { fs.unlinkSync(lockPath); } catch { /* already gone -- fine */ } },
|
|
100
|
+
};
|
|
101
|
+
} catch (err) {
|
|
102
|
+
if (!err || err.code !== 'EEXIST') throw err;
|
|
103
|
+
|
|
104
|
+
let existingPid = null;
|
|
105
|
+
try {
|
|
106
|
+
existingPid = parseInt(fs.readFileSync(lockPath, 'utf8').trim(), 10);
|
|
107
|
+
} catch {
|
|
108
|
+
// File vanished (or became unreadable) between our openSync
|
|
109
|
+
// failing and this read -- treat as reclaimable below.
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
if (Number.isInteger(existingPid) && isPidAlive(existingPid)) {
|
|
113
|
+
throw new SprintLockHeldError(
|
|
114
|
+
`[Sprint Lock] Sprint branch "${branch}" (members: ${(members || []).join(', ')}) is already ` +
|
|
115
|
+
`running under pid ${existingPid}. Refusing to start a second concurrent engine against the ` +
|
|
116
|
+
`same sprint -- wait for it to finish, or stop it first.`,
|
|
117
|
+
{ branch, members, existingPid },
|
|
118
|
+
);
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
if (!allowReclaim) {
|
|
122
|
+
// We already reclaimed once in this call and STILL hit
|
|
123
|
+
// EEXIST -- a concurrent acquire won the race between our
|
|
124
|
+
// unlink and this retry.
|
|
125
|
+
throw new SprintLockHeldError(
|
|
126
|
+
`[Sprint Lock] Sprint branch "${branch}" (members: ${(members || []).join(', ')}) lock could ` +
|
|
127
|
+
`not be acquired -- a concurrent process claimed it during stale-pidfile reclaim.`,
|
|
128
|
+
{ branch, members },
|
|
129
|
+
);
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
// Stale pidfile (dead pid, or unreadable/corrupt content) --
|
|
133
|
+
// reclaim it and retry exactly once, never a false block.
|
|
134
|
+
try { fs.unlinkSync(lockPath); } catch { /* already gone -- fine */ }
|
|
135
|
+
return tryAcquire(false);
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
return tryAcquire(true);
|
|
140
|
+
}
|