@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
package/README.md
CHANGED
|
@@ -1,4 +1,17 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<picture>
|
|
4
|
+
<source media="(prefers-color-scheme: dark)" srcset="assets/marketing/hero-banner-dark.svg">
|
|
5
|
+
<img src="assets/marketing/hero-banner-light.svg" alt="apra-fleet: run a fleet of AI agents across your devices, your providers, your workflows." width="100%">
|
|
6
|
+
</picture>
|
|
7
|
+
|
|
8
|
+
# apra-fleet
|
|
9
|
+
|
|
10
|
+
**Run a fleet of AI agents across your devices, your providers, your workflows.**
|
|
11
|
+
|
|
12
|
+
What Kubernetes did for containers, apra-fleet does for AI agents:
|
|
13
|
+
scheduling, credentials, isolation, and observability for an agentic
|
|
14
|
+
workforce -- on any machine, anywhere, using every LLM provider at once.
|
|
2
15
|
|
|
3
16
|
[](https://github.com/Apra-Labs/apra-fleet/actions/workflows/ci.yml)
|
|
4
17
|
[](https://opensource.org/licenses/Apache-2.0)
|
|
@@ -6,316 +19,401 @@
|
|
|
6
19
|
[](https://modelcontextprotocol.io)
|
|
7
20
|
[](https://deepwiki.com/Apra-Labs/apra-fleet)
|
|
8
21
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
Apra Fleet is an open-source **MCP server** that turns AI agents (Claude
|
|
12
|
-
Code, Antigravity, Codex, Copilot, Gemini, OpenCode) into a coordinated team instead of a lone
|
|
13
|
-
assistant. Any job that needs more than one agent -- software sprints,
|
|
14
|
-
customer-support triage, cost and operations-efficiency analysis,
|
|
15
|
-
infrastructure surveys -- becomes a fleet you direct in plain conversation.
|
|
16
|
-
Need more horsepower? Fleet reaches across every machine on your network
|
|
17
|
-
over SSH -- no dashboards, no orchestration YAML.
|
|
18
|
-
|
|
19
|
-
**The agents need not share a vendor.** A Claude agent and an Antigravity agent can
|
|
20
|
-
work the same sprint -- one writes, the other reviews -- so a different model,
|
|
21
|
-
with different blind spots, checks every change. Cross-provider collaboration is
|
|
22
|
-
a built-in quality mechanism, not an afterthought.
|
|
22
|
+
[Quick Start](#quick-start-5-minutes) - [Live Demo](#watch-a-fleet-work) - [How It Works](#how-it-works) - [fleet-sprint Getting Started Guide](docs/fleet-sprint-getting-started.md) - [Website](https://apra-labs.github.io/apra-fleet)
|
|
23
23
|
|
|
24
|
-
>
|
|
25
|
-
> A fleet is however many of those you register, working in concert.
|
|
24
|
+
</div>
|
|
26
25
|
|
|
27
|
-
|
|
26
|
+
---
|
|
28
27
|
|
|
29
|
-
|
|
28
|
+
<img src="assets/marketing/dashboard-demo.gif" alt="apra-fleet fleet-sprint dashboard, real recording: the sprint's own integration tester finds two real bugs, files them against itself, then a second cycle plans, fixes, and closes them -- captions burned in." width="100%">
|
|
30
29
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
30
|
+
> **This repository is built by the product you are looking at.** An
|
|
31
|
+
> autonomous apra-fleet workflow plans, codes, reviews, tests, and ships
|
|
32
|
+
> this codebase in multi-hour sprints -- filing bugs against itself and
|
|
33
|
+
> fixing them. The recording above is a real run, not a mockup.
|
|
34
34
|
|
|
35
35
|
---
|
|
36
36
|
|
|
37
|
-
##
|
|
37
|
+
## Why a fleet?
|
|
38
|
+
|
|
39
|
+
Running one AI agent is a demo. Running fifty -- across a MacBook in the
|
|
40
|
+
office, a GPU box in the lab, three cloud VMs, and your CI -- is an
|
|
41
|
+
operations problem nobody else has solved:
|
|
42
|
+
|
|
43
|
+
- **Which machine runs which agent?** Real devices, not throwaway sandboxes:
|
|
44
|
+
registered, credentialed, health-checked members you already own.
|
|
45
|
+
- **Which model does which job?** Claude for review, a cheap tier for
|
|
46
|
+
mechanical edits, a local vLLM model for private data -- all in one fleet,
|
|
47
|
+
routed by cost tier, switchable per task.
|
|
48
|
+
- **Who watches the agents?** Durable workflows with supervisors, watchdogs,
|
|
49
|
+
reservations, and live dashboards. Agents that die get detected. Work that
|
|
50
|
+
stalls gets resumed. Nothing runs silently.
|
|
51
|
+
- **Who holds the keys?** Secrets entered out-of-band, never visible to any
|
|
52
|
+
model. Per-provider permission composition. Network egress policy per
|
|
53
|
+
credential.
|
|
54
|
+
|
|
55
|
+
One control plane. Any device. Any model. Any workflow. Any domain.
|
|
56
|
+
|
|
57
|
+
## What you get
|
|
58
|
+
|
|
59
|
+
| Pillar | Concretely |
|
|
60
|
+
|---|---|
|
|
61
|
+
| **Any device** | Register any Windows / macOS / Linux machine (local or over SSH) as a fleet member in one command. Cloud members auto-start on demand. Windows members are fully supported for dispatch, command execution, and background long-running tasks (launched detached via WMI). |
|
|
62
|
+
| **Any model** | Claude, Codex, Gemini, Copilot, Antigravity, local models (any OpenAI-compatible endpoint via OpenCode) -- mixed freely. Tier-based routing (cheap / standard / premium) keeps cost governance built in. Cross-provider review is a quality mechanism: a different model, with different blind spots, checks every change. |
|
|
63
|
+
| **Any workflow** | Workflows are durable programs, not prompt chains: multi-hour, resumable, observable, with member reservations and atomic state. Write your own; ship it to the fleet. |
|
|
64
|
+
| **Any domain** | Not just software development. The pattern fits wherever work decomposes into agent-sized pieces that need orchestration and an audit trail: nightly retail replenishment (reconcile inventory deltas, draft purchase orders for sign-off), logistics exception handling (triage a delayed shipment, re-book, notify), healthcare intake (summarize referrals, check completeness, route), back-office runs (invoice matching, compliance evidence collection). Software engineering is the vertical running today -- your domain is a workflow away. |
|
|
65
|
+
|
|
66
|
+
<picture>
|
|
67
|
+
<source media="(prefers-color-scheme: dark)" srcset="assets/marketing/fleet-topology-dark.svg">
|
|
68
|
+
<img src="assets/marketing/fleet-topology-light.svg" alt="apra-fleet topology: one control plane dispatching to six heterogeneous member devices across providers and operating systems" width="100%">
|
|
69
|
+
</picture>
|
|
70
|
+
|
|
71
|
+
## Watch a fleet work
|
|
72
|
+
|
|
73
|
+
Our flagship workflow, **fleet-sprint**, develops software autonomously:
|
|
74
|
+
plan -> develop -> review -> deploy -> integration-test -> harvest, in
|
|
75
|
+
cycles, until the goal is met or the evidence says stop.
|
|
76
|
+
|
|
77
|
+
It is not a toy. It builds apra-fleet itself:
|
|
78
|
+
|
|
79
|
+
- Multi-cycle sprints running for hours, unattended
|
|
80
|
+
- 2,300+ unit tests and an 81-file integration suite against real backends
|
|
81
|
+
- Files bugs against itself, decomposes them, fixes them, and blocks its
|
|
82
|
+
own release until quality gates pass
|
|
83
|
+
- Every dispatch, verdict, and dollar visible live on the dashboard
|
|
84
|
+
- Every sprint's raw child stdout/stderr is captured to a per-sprint log
|
|
85
|
+
and linked from the dashboard, so a run's output is traceable even if it
|
|
86
|
+
crashes before reporting anything back
|
|
87
|
+
|
|
88
|
+
A fleet that has run in production:
|
|
38
89
|
|
|
39
90
|
```
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
/pm status
|
|
91
|
+
pm-1 Opus (premium) orchestrator
|
|
92
|
+
doer-1 Sonnet (standard) feature work
|
|
93
|
+
doer-2 Antigravity large-context tasks
|
|
94
|
+
reviewer Opus (premium) final review
|
|
45
95
|
```
|
|
46
96
|
|
|
47
|
-
|
|
97
|
+
The engine does not know what a "sprint" is; it knows how to run your
|
|
98
|
+
workflow reliably across your fleet (see **Any domain** above).
|
|
48
99
|
|
|
49
|
-
## Quick start
|
|
100
|
+
## Quick start (5 minutes)
|
|
50
101
|
|
|
51
|
-
|
|
102
|
+
**1. Install** -- one command via npm (Node.js 22+), or grab the
|
|
103
|
+
standalone installer binary for your platform from
|
|
104
|
+
[Releases](https://github.com/Apra-Labs/apra-fleet/releases) and
|
|
105
|
+
double-click it (installation is the default action):
|
|
52
106
|
|
|
53
107
|
```bash
|
|
54
108
|
npm install -g @apralabs/apra-fleet
|
|
55
|
-
apra-fleet
|
|
56
|
-
apra-fleet --llm agy
|
|
57
|
-
apra-fleet
|
|
58
|
-
apra-fleet --llm codex # OpenAI Codex CLI
|
|
59
|
-
apra-fleet --llm opencode # OpenCode (local/self-hosted models)
|
|
109
|
+
apra-fleet # installs for Claude Code (default)
|
|
110
|
+
apra-fleet --llm agy # or OpenCode/Codex/Copilot/Gemini
|
|
111
|
+
cd ~/.apra-fleet/bin && apra-fleet start # start the apra-fleet
|
|
60
112
|
```
|
|
61
113
|
|
|
62
|
-
|
|
63
|
-
|
|
114
|
+
**2. Connect your agent.** Load the fleet server in Claude Code with
|
|
115
|
+
`/mcp` (or restart your provider CLI). Your agent now has a fleet.
|
|
64
116
|
|
|
65
|
-
|
|
117
|
+
**3. Register members -- in plain language.** apra-fleet is driven
|
|
118
|
+
conversationally through any MCP-capable agent:
|
|
66
119
|
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
**double-click it** (or run it from the terminal) -- installation is the default action.
|
|
120
|
+
> "Register a local member called `doer`. Register another called
|
|
121
|
+
> `reviewer`. Pair them."
|
|
70
122
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
123
|
+
> "Register 192.168.1.10 as `build-server`. Username akhil, work folder
|
|
124
|
+
> `/home/akhil/projects/myapp`."
|
|
125
|
+
|
|
126
|
+
Remote passwords are collected out-of-band -- typed into a separate
|
|
127
|
+
terminal, never the chat -- used once to set up SSH keys, then forgotten.
|
|
128
|
+
|
|
129
|
+
**4. Run your first workflow:**
|
|
75
130
|
|
|
76
|
-
**Linux (x64)**
|
|
77
131
|
```bash
|
|
78
|
-
|
|
132
|
+
apra-fleet workflow hello-world
|
|
79
133
|
```
|
|
80
134
|
|
|
81
|
-
|
|
82
|
-
```powershell
|
|
83
|
-
Invoke-WebRequest -Uri https://github.com/Apra-Labs/apra-fleet/releases/latest/download/apra-fleet-installer-win-x64.exe -OutFile apra-fleet-installer.exe; .\apra-fleet-installer.exe
|
|
84
|
-
```
|
|
135
|
+
Then point the fleet at real work:
|
|
85
136
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
137
|
+
```bash
|
|
138
|
+
apra-fleet workflow fleet-sprint \
|
|
139
|
+
--issue my-project-epic --members doer \
|
|
140
|
+
--branch fleet-sprint/first-run --base main
|
|
141
|
+
```
|
|
89
142
|
|
|
90
|
-
|
|
143
|
+
Open the dashboard, watch your fleet PLAN->BUILD->REVIEW->TEST->SHIP in a loop till closure
|
|
91
144
|
|
|
92
|
-
|
|
145
|
+
> **New to fleet-sprint?** Read the
|
|
146
|
+
> [fleet-sprint Getting Started Guide](https://apra-labs.github.io/apra-fleet/fleet-sprint-getting-started.html)
|
|
147
|
+
> ([Markdown](docs/fleet-sprint-getting-started.md) if you're reading this on
|
|
148
|
+
> GitHub -- [PDF](docs/fleet-sprint-getting-started.pdf)) -- a plain-English walkthrough
|
|
149
|
+
> of what it does, what you need to prepare (beads backlog, `deploy.md`,
|
|
150
|
+
> test playbooks, member registration), how to launch and monitor a sprint,
|
|
151
|
+
> and what's automated versus what's still your call.
|
|
93
152
|
|
|
94
|
-
|
|
95
|
-
|
|
153
|
+
**Running fleet-sprint after npm install:** the `apra-fleet workflow
|
|
154
|
+
fleet-sprint ...` command above is the same one command for everyone --
|
|
155
|
+
whether you installed via `npm install -g @apralabs/apra-fleet`, the
|
|
156
|
+
standalone binary, or a git-clone dev checkout. There is no separate
|
|
157
|
+
`fleet-sprint` command to install or remember. See
|
|
158
|
+
[the full flag reference](packages/apra-fleet-se/fleet-sprint/docs/README.md)
|
|
159
|
+
for every option.
|
|
96
160
|
|
|
97
|
-
|
|
161
|
+
## How it works
|
|
98
162
|
|
|
99
|
-
|
|
163
|
+
### Layered Architecture
|
|
100
164
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
onboarding. See [docs/features/member-tags.md](docs/features/member-tags.md).
|
|
165
|
+
<picture>
|
|
166
|
+
<source media="(prefers-color-scheme: dark)" srcset="assets/marketing/fleet-stack-dark.svg">
|
|
167
|
+
<img src="assets/marketing/fleet-stack-light.svg" alt="apra-fleet layered architecture stack: dependencies from OS primitives up to autonomous engineering orchestrators" width="100%">
|
|
168
|
+
</picture>
|
|
106
169
|
|
|
107
|
-
|
|
170
|
+
**Component Docs:** [fleet-sprint](packages/apra-fleet-se/fleet-sprint/docs/README.md) | [auto-sprint.js](packages/apra-fleet-se/apra-pm/docs/sprint-workflow.md) | [apra-fleet-client](packages/apra-fleet-client/docs/overview.md) | [apra-pm](packages/apra-fleet-se/apra-pm/README.md) | [apra-fleet-mcp](docs/mcp-tools.md) | [Agent Roles](packages/apra-fleet-se/docs/role-contracts.md)
|
|
108
171
|
|
|
109
|
-
|
|
110
|
-
> `/home/akhil/projects/myapp`."
|
|
172
|
+
### Fleet Dispatch Topology
|
|
111
173
|
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
174
|
+
```mermaid
|
|
175
|
+
flowchart LR
|
|
176
|
+
CP["Control Plane<br/>(Server, Engine, Supervisor)"] -->|Dispatch & Sync| M1["MacBook<br/>(Claude)"] & M2["Linux GPU<br/>(vLLM)"] & M3["Cloud VM<br/>(AGY)"] & M4["Windows<br/>(OpenCode)"]
|
|
177
|
+
```
|
|
115
178
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
179
|
+
- **Fleet server**: the control plane. Registers members, dispatches commands and prompts, moves files, brokers credentials. Speaks MCP, so any MCP-capable agent can drive a fleet.
|
|
180
|
+
- **Members**: real machines running provider CLIs. Composes provider-native permissions before every dispatch; unattended modes are scoped, never blanket.
|
|
181
|
+
- **Workflow engine**: runs workflow programs with phases, retries, turn budgets, resumable sessions, and per-activity persistent state.
|
|
182
|
+
- **Supervisor**: always-on layer -- launch & stop sprints over HTTP, member reservation ledger, crash watchdog, run history.
|
|
119
183
|
|
|
120
|
-
|
|
121
|
-
latest release and installs it in place -- or tells you that you are already up
|
|
122
|
-
to date. See [keeping Fleet updated](docs/features/update.md).
|
|
184
|
+
## Knowledge Layer
|
|
123
185
|
|
|
124
|
-
|
|
186
|
+
Every agent session starts by calling `kb_session_prime`. The KB checks which
|
|
187
|
+
files have changed since last read and returns exactly those. Unchanged files
|
|
188
|
+
are served from cached summaries -- no re-read, no wasted tokens.
|
|
125
189
|
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
participant Reviewer
|
|
132
|
-
You->>PM: "Add a note sharing system, have it reviewed"
|
|
133
|
-
loop Plan: revise until the reviewer signs off
|
|
134
|
-
PM->>Doer: draft / revise the plan
|
|
135
|
-
Doer-->>PM: plan
|
|
136
|
-
PM->>Reviewer: review the plan
|
|
137
|
-
Reviewer-->>PM: rejected with fixes, or signed off
|
|
138
|
-
end
|
|
139
|
-
PM-->>You: plan for approval
|
|
140
|
-
You-->>PM: approved
|
|
141
|
-
loop Build: revise until the review is clean
|
|
142
|
-
PM->>Doer: execute / fix the task
|
|
143
|
-
Doer->>Doer: write code, commit, reach checkpoint
|
|
144
|
-
PM->>Reviewer: review the changes
|
|
145
|
-
Reviewer-->>PM: findings, or signed off
|
|
146
|
-
end
|
|
147
|
-
PM-->>You: reviewed code + PR
|
|
190
|
+
```
|
|
191
|
+
Cold session: kb_session_prime returns stale_files=[a.ts, b.ts, c.ts]
|
|
192
|
+
Agent reads all three, calls kb_capture for each.
|
|
193
|
+
Warm session: kb_session_prime returns stale_files=[], session_warm=true
|
|
194
|
+
Agent works from KB summaries. Zero file reads.
|
|
148
195
|
```
|
|
149
196
|
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
`
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
-
|
|
199
|
-
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
197
|
+
MCP tools that ship with the KB:
|
|
198
|
+
|
|
199
|
+
| Tool | What it does |
|
|
200
|
+
|------|--------------|
|
|
201
|
+
| `kb_session_prime` | Prime a session: stale files, fresh summaries, GitNexus call list |
|
|
202
|
+
| `kb_capture` | Store a learning, context-cache, runbook, or knowledge entry |
|
|
203
|
+
| `kb_query` | Two-level FTS retrieval (L1: title+summary, L2: full content) |
|
|
204
|
+
| `kb_list` | Audit-list entries by confidence/type/module/symbol (read-only, no use_count bump) |
|
|
205
|
+
| `kb_context` | Batch file freshness check (single git call for N files) |
|
|
206
|
+
| `kb_invalidate` | Mark files stale immediately (also called by the git hook) |
|
|
207
|
+
| `kb_promote` | Advance confidence: UNVERIFIED -> INFERRED -> CONFIRMED |
|
|
208
|
+
| `kb_harvest` | Extract learnings from a session transcript (auto-fires after execute_prompt) |
|
|
209
|
+
| `kb_export` | Write live CONFIRMED entries to `.fleet/kb-canonical.json` -- the git-shareable team bible |
|
|
210
|
+
| `kb_setup` | Install git hook, write provider config, store remote token encrypted |
|
|
211
|
+
|
|
212
|
+
Every KB tool call is scoped to the repo it is about -- a fleet server
|
|
213
|
+
handling many members across many repos never lets one repo's learnings land
|
|
214
|
+
in another repo's KB. Scope is normally derived from the caller's repo path;
|
|
215
|
+
tools also accept an explicit `repo_remote_url` so a remote member (whose
|
|
216
|
+
work folder is a path on another host, unreachable from the fleet server's
|
|
217
|
+
filesystem) resolves to the same project KB as a local clone of that repo
|
|
218
|
+
instead of a shared fallback database. The automatic post-prompt harvest and
|
|
219
|
+
the `code_context` KB enrichment path both forward this URL too, and an
|
|
220
|
+
unreachable work-folder path is never silently swapped for the fleet
|
|
221
|
+
server's own working directory -- see
|
|
222
|
+
[Per-repo KB isolation](docs/knowledge-layer.md#per-repo-kb-isolation) for
|
|
223
|
+
the full anchor and cache-keying rules.
|
|
224
|
+
|
|
225
|
+
The backend is swappable: start with local SQLite, add a central HTTP server for
|
|
226
|
+
a team, or plug in Postgres later -- all via a one-line config change.
|
|
227
|
+
|
|
228
|
+
See [docs/knowledge-layer.md](docs/knowledge-layer.md) for the full guide.
|
|
229
|
+
|
|
230
|
+
## Explore with agents. Operate with programs.
|
|
231
|
+
|
|
232
|
+
There are two ways to orchestrate agents, and apra-fleet is built on the
|
|
233
|
+
observation that you need both -- at different stages of a workflow's life:
|
|
234
|
+
|
|
235
|
+
- **Exploration mode.** While a workflow is still being discovered, let an
|
|
236
|
+
LLM orchestrate: flexible, adaptive, and token-hungry -- every step is a
|
|
237
|
+
decision, and every decision costs thinking.
|
|
238
|
+
- **Operation mode.** Once you know what must happen, the control flow
|
|
239
|
+
becomes a deterministic workflow program. Shell, git, and file steps run
|
|
240
|
+
through `execute_command` -- zero tokens. The model is invoked only at
|
|
241
|
+
the corners that genuinely require judgment (`execute_prompt`): review
|
|
242
|
+
this diff, plan this backlog, decide this exception.
|
|
243
|
+
|
|
244
|
+
<picture>
|
|
245
|
+
<source media="(prefers-color-scheme: dark)" srcset="assets/marketing/cost-collapse-dark.svg">
|
|
246
|
+
<img src="assets/marketing/cost-collapse-light.svg" alt="Cost per apra-fleet e2e run: four real LLM-driven runs ranging $0.46-$3.05, then ~$0.00 / run forever after switching to a deterministic workflow." width="100%">
|
|
247
|
+
</picture>
|
|
248
|
+
|
|
249
|
+
That is not a projection -- it is this repository's own e2e setup+teardown
|
|
250
|
+
step, before and after we hardened it. Development tokens are not
|
|
251
|
+
operating tokens: pay once to discover the workflow, then run it free.
|
|
252
|
+
|
|
253
|
+
| | LLM-orchestrated (explore) | Workflow-orchestrated (operate) |
|
|
254
|
+
|---|---|---|
|
|
255
|
+
| Control flow | the model decides each step (tokens) | deterministic program (free) |
|
|
256
|
+
| Shell / git / file steps | narrated through the model | `execute_command`, zero tokens |
|
|
257
|
+
| Where the model runs | everywhere | judgment nodes only (`execute_prompt`) |
|
|
258
|
+
| Cost curve | scales with every step | scales with thinking only |
|
|
259
|
+
| Failure mode | drift and silent retries | typed errors, resumable state |
|
|
260
|
+
|
|
261
|
+
The collapse is two-dimensional. As a workflow hardens, control flow moves
|
|
262
|
+
from model to program -- and the judgment nodes that remain move from
|
|
263
|
+
frontier models to cheaper ones, because a well-specified task no longer
|
|
264
|
+
needs discovery-grade reasoning. **Develop a workflow with Claude;
|
|
265
|
+
operationalize it on OpenCode against a local or OpenRouter model.** Same
|
|
266
|
+
fleet, same workflow -- swap the members. Tier routing makes it a
|
|
267
|
+
registration change, not a rewrite.
|
|
268
|
+
|
|
269
|
+
Only a fleet makes that trade possible. Single-provider tools cannot leave
|
|
270
|
+
their vendor; in-process frameworks cannot move orchestration out of the
|
|
271
|
+
token path. Because apra-fleet's unit of execution is the member -- a
|
|
272
|
+
machine plus a provider, swappable at registration -- the same hardened
|
|
273
|
+
workflow runs on frontier models the day you design it and on commodity
|
|
274
|
+
models every day after.
|
|
275
|
+
|
|
276
|
+
fleet-sprint is this principle, lived: it began as LLM-orchestrated
|
|
277
|
+
exploration; each discovered pattern was hardened into the deterministic
|
|
278
|
+
engine; today the engine drives hour-long autonomous runs in which models
|
|
279
|
+
are consulted only as planner, doer, reviewer, tester, and harvester.
|
|
222
280
|
|
|
223
281
|
## Compare to alternatives
|
|
224
282
|
|
|
225
|
-
| Tool | Overlap | Where
|
|
226
|
-
|
|
227
|
-
| Single-agent coding assistants | AI writes code |
|
|
228
|
-
| CI self-hosted runners | Runs work on other machines |
|
|
229
|
-
| SkyPilot / dstack | Multi-machine compute |
|
|
230
|
-
| Google A2A | Agent-to-agent messaging |
|
|
283
|
+
| Tool | Overlap | Where apra-fleet differs |
|
|
284
|
+
|------|---------|--------------------------|
|
|
285
|
+
| Single-agent coding assistants | AI writes code | A fleet adds agents that review, test, and deploy each other's work -- across vendors. |
|
|
286
|
+
| CI self-hosted runners | Runs work on other machines | Conversational and stateful, not pipeline-triggered; agents carry context between phases. |
|
|
287
|
+
| SkyPilot / dstack | Multi-machine compute | Coordinates agents and their context, credentials, and permissions -- not just jobs. |
|
|
288
|
+
| Google A2A | Agent-to-agent messaging | An opinionated orchestration and operations layer, not just a transport. |
|
|
289
|
+
| Agent frameworks (LangGraph, CrewAI, ...) | Multi-agent logic | Those compose agents inside one process; apra-fleet operates agents across real machines, providers, and days-long workflows. |
|
|
231
290
|
|
|
232
|
-
When
|
|
291
|
+
When NOT to use it: a one-off single-file change needs no fleet.
|
|
233
292
|
|
|
234
|
-
##
|
|
293
|
+
## Security model, in one paragraph
|
|
235
294
|
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
295
|
+
Secrets are entered out-of-band into a credential store and referenced as
|
|
296
|
+
`{{secure.NAME}}` -- resolved server-side at execution, never visible to
|
|
297
|
+
any LLM or log. Credentials scope to members, expire on TTL, and can carry
|
|
298
|
+
a network egress policy (allow / deny / confirm). Every member runs with
|
|
299
|
+
composed, provider-native permission files -- allow-listed tools, not
|
|
300
|
+
god-mode. VCS access is provisioned and revocable per member. Permission
|
|
301
|
+
composition verifies its own delivery: a grant is read back off the target
|
|
302
|
+
member and structurally compared against what was intended before it is
|
|
303
|
+
reported as applied, so a failed or partial write is surfaced as an
|
|
304
|
+
explicit failure rather than a false success.
|
|
240
305
|
|
|
241
|
-
|
|
242
|
-
|------|-------------|-----|
|
|
243
|
-
| PM (orchestrator) | Claude Code or Antigravity (agy) | Both plan and orchestrate well - both support planning, background tasks, and premium models (e.g., Opus / premium-tier). |
|
|
244
|
-
| Doer | Any provider | Sonnet, Antigravity, Codex, Copilot, Gemini, OpenCode - mix freely. |
|
|
245
|
-
| Reviewer | Premium-tier models | Catches subtle issues smaller models miss. |
|
|
306
|
+
## Email Configuration
|
|
246
307
|
|
|
247
|
-
|
|
308
|
+
The fleet `send_email` tool sends email via **SendGrid** or **SMTP**. Secrets
|
|
309
|
+
are stored in the fleet credential store. Non-secret config (provider, host,
|
|
310
|
+
port, from address) is passed by the workflow in each call.
|
|
311
|
+
|
|
312
|
+
### Storing secrets (one-time setup)
|
|
313
|
+
|
|
314
|
+
Store email secrets via the CLI:
|
|
315
|
+
|
|
316
|
+
```bash
|
|
317
|
+
# SendGrid API key
|
|
318
|
+
apra-fleet secret --set sendgrid_api_key --persist
|
|
248
319
|
|
|
320
|
+
# SMTP password
|
|
321
|
+
apra-fleet secret --set smtp_password --persist
|
|
249
322
|
```
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
323
|
+
|
|
324
|
+
Or via the MCP tool (the path an LLM agent uses):
|
|
325
|
+
|
|
326
|
+
```json
|
|
327
|
+
{ "name": "sendgrid_api_key", "prompt": "Enter your SendGrid API key", "persist": true }
|
|
254
328
|
```
|
|
255
329
|
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
|
293
|
-
|
|
294
|
-
|
|
|
295
|
-
|
|
|
296
|
-
|
|
|
297
|
-
|
|
|
298
|
-
|
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
`
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
330
|
+
Secrets are encrypted in the fleet credential store. They never appear in
|
|
331
|
+
workflow code, config files, or environment variables.
|
|
332
|
+
|
|
333
|
+
### Sending email from a workflow
|
|
334
|
+
|
|
335
|
+
The workflow passes non-secret config inline and calls `send_email`. Load
|
|
336
|
+
your config however you prefer (JSON file, hardcoded, etc.):
|
|
337
|
+
|
|
338
|
+
```javascript
|
|
339
|
+
import { parseToolJson } from '@apralabs/apra-fleet-client';
|
|
340
|
+
import { connectFleet } from '@apralabs/apra-fleet-client/server-resolution';
|
|
341
|
+
|
|
342
|
+
const { fleetApi } = await connectFleet({ env: process.env });
|
|
343
|
+
|
|
344
|
+
// fleetApi wrappers return the raw MCP tool result ({ content: [...] });
|
|
345
|
+
// parseToolJson extracts the JSON payload.
|
|
346
|
+
const result = parseToolJson(await fleetApi.sendEmail({
|
|
347
|
+
provider: 'smtp',
|
|
348
|
+
host: 'smtp.example.com',
|
|
349
|
+
port: 587,
|
|
350
|
+
user: 'notifications@example.com',
|
|
351
|
+
from: 'noreply@example.com',
|
|
352
|
+
to: 'team@example.com',
|
|
353
|
+
subject: 'Sprint Report',
|
|
354
|
+
body: 'All tasks completed.'
|
|
355
|
+
}));
|
|
356
|
+
console.log(`Sent: ${result.messageId}`);
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
The SMTP password resolves from the credential store automatically. It never
|
|
360
|
+
appears in the workflow. See `examples/workflows/email-notify/` for a
|
|
361
|
+
complete runnable example and `docs/email-workflow-guide.md` for the full
|
|
362
|
+
walkthrough.
|
|
363
|
+
|
|
364
|
+
### send_email Tool Reference
|
|
365
|
+
|
|
366
|
+
| Parameter | Type | Required | Description |
|
|
367
|
+
|---|---|---|---|
|
|
368
|
+
| `provider` | `"sendgrid"` or `"smtp"` | no (default: `"sendgrid"`) | Email provider |
|
|
369
|
+
| `from` | string | yes | Sender email address |
|
|
370
|
+
| `host` | string | SMTP only | SMTP server hostname |
|
|
371
|
+
| `port` | number | no (default: 587, or 465 when `secure` is true) | SMTP server port |
|
|
372
|
+
| `user` | string | SMTP only | SMTP username |
|
|
373
|
+
| `secure` | boolean | no (default: false) | Implicit TLS (port 465). When false, STARTTLS is required. |
|
|
374
|
+
| `to` | string or string[] | yes | Recipient email address(es) |
|
|
375
|
+
| `subject` | string | yes | Email subject line |
|
|
376
|
+
| `body` | string | yes | Plain-text email body |
|
|
377
|
+
| `html` | string | no | HTML email body |
|
|
378
|
+
| `cc` | string[] | no | CC recipient addresses |
|
|
379
|
+
| `bcc` | string[] | no | BCC recipient addresses |
|
|
380
|
+
| `attachments` | attachment[] | no | File attachments (base64-encoded) |
|
|
381
|
+
|
|
382
|
+
Each attachment: `filename` (string), `content` (string, base64), `contentType` (string, optional).
|
|
383
|
+
|
|
384
|
+
Secrets are resolved from the credential store by name:
|
|
385
|
+
- **SendGrid:** `sendgrid_api_key`
|
|
386
|
+
- **SMTP:** `smtp_password`
|
|
387
|
+
|
|
388
|
+
Returns: `{ ok: true, messageId }` on success, `{ ok: false, error }` on failure.
|
|
389
|
+
|
|
390
|
+
## The packages
|
|
391
|
+
|
|
392
|
+
| Package | What it is |
|
|
393
|
+
|---|---|
|
|
394
|
+
| `apra-fleet` | The fleet platform: server, CLI, member management, credentials, workflows runtime |
|
|
395
|
+
| `packages/apra-fleet-se` | The software-engineering vertical: fleet-sprint engine, agent contracts, integration suites |
|
|
396
|
+
| `packages/apra-fleet-workflow` | Workflow authoring runtime: state, viewer, checkpointing |
|
|
397
|
+
| `packages/fleet-api-contract` | Typed API contract shared by server and clients |
|
|
398
|
+
|
|
399
|
+
## Status and roadmap
|
|
400
|
+
|
|
401
|
+
apra-fleet is under active development -- by its own fleet. Current focus:
|
|
402
|
+
hardening autonomous sprint execution (the toughest workflow we know of),
|
|
403
|
+
supervisor-orchestrated multi-sprint operation, and the workflow SDK for
|
|
404
|
+
third-party verticals.
|
|
311
405
|
|
|
312
406
|
## Documentation
|
|
313
407
|
|
|
314
408
|
| Topic | Link |
|
|
315
409
|
|-------|------|
|
|
410
|
+
| **fleet-sprint Getting Started Guide (start here, plain English)** | [Website](https://apra-labs.github.io/apra-fleet/fleet-sprint-getting-started.html) - [Markdown](docs/fleet-sprint-getting-started.md) - [PDF](docs/fleet-sprint-getting-started.pdf) |
|
|
316
411
|
| Codebase wiki (architecture, internals, AI Q&A) | [DeepWiki](https://deepwiki.com/Apra-Labs/apra-fleet) |
|
|
317
412
|
| Install, uninstall, the `--llm` flag | [docs/install.md](docs/install.md) |
|
|
318
|
-
| Choosing a provider | [docs/provider-guide.md](docs/provider-guide.md) |
|
|
413
|
+
| Choosing a provider (roles, gotchas, mixing providers, OpenCode/local models) | [docs/provider-guide.md](docs/provider-guide.md) |
|
|
414
|
+
| Transport, service mode, and supported interfaces | [docs/transport-and-service-mode.md](docs/transport-and-service-mode.md) |
|
|
415
|
+
| Cost model (tiering, shell-over-prompts, measured token spend) | [docs/cost-model.md](docs/cost-model.md) |
|
|
416
|
+
| The PM skill (doer-reviewer sprints, `/pm` commands) | [docs/pm-skill-overview.md](docs/pm-skill-overview.md) |
|
|
319
417
|
| FAQ | [docs/FAQ.md](docs/FAQ.md) |
|
|
320
418
|
| Troubleshooting | [docs/troubleshooting.md](docs/troubleshooting.md) |
|
|
321
419
|
| Keeping Fleet updated (`apra-fleet update`) | [docs/features/update.md](docs/features/update.md) |
|
|
@@ -326,6 +424,25 @@ Want to build your own skill on top of Fleet? See [docs/writing-skills.md](docs/
|
|
|
326
424
|
| Git authentication | [docs/design-git-auth.md](docs/design-git-auth.md) |
|
|
327
425
|
| Cloud compute | [docs/cloud-compute.md](docs/cloud-compute.md) |
|
|
328
426
|
| Architecture | [docs/architecture.md](docs/architecture.md) |
|
|
427
|
+
| Knowledge Layer (setup, usage, provider swap) | [docs/knowledge-layer.md](docs/knowledge-layer.md) |
|
|
428
|
+
| Code intelligence provider abstraction | [docs/code-intelligence-providers.md](docs/code-intelligence-providers.md) |
|
|
429
|
+
| Hub-spoke cloud migration plan (historical; see tier-3 ownership ADR) | [docs/hub-spoke-master-plan.md](docs/hub-spoke-master-plan.md) |
|
|
430
|
+
| Tier-3 ownership decision (fleet-dashboard vs `src/hub-service/`) | [docs/adr-tier3-ownership.md](docs/adr-tier3-ownership.md) |
|
|
431
|
+
| Shared hub/dashboard API contract package | [packages/fleet-api-contract/README.md](packages/fleet-api-contract/README.md) |
|
|
432
|
+
| Workflow engine internals (`agent()`/`parallel()`/`pipeline()`, journal, budget) | [packages/apra-fleet-workflow/docs/apra-fleet-workflow-architecture.md](packages/apra-fleet-workflow/docs/apra-fleet-workflow-architecture.md) |
|
|
433
|
+
| Writing and running workflow scripts | [packages/apra-fleet-workflow/docs/workflow-guide.md](packages/apra-fleet-workflow/docs/workflow-guide.md) |
|
|
434
|
+
| Authoring a SEA-embedded `apra-fleet workflow` (manifest, entry contract, launcher env vars) | [docs/authoring-workflows.md](docs/authoring-workflows.md) |
|
|
435
|
+
| Workflow launcher fleet-server resolution order (HTTP singleton vs. stdio) | [docs/adr-workflow-server-resolution.md](docs/adr-workflow-server-resolution.md) |
|
|
436
|
+
| Running fleet-sprint (full flag reference; identical for npm-install, standalone binary, and git-clone dev checkout) | [packages/apra-fleet-se/fleet-sprint/docs/README.md](packages/apra-fleet-se/fleet-sprint/docs/README.md) |
|
|
437
|
+
| Auto-sprint overview (autonomous plan-develop-review-publish loop) | [packages/apra-fleet-se/docs/overview.md](packages/apra-fleet-se/docs/overview.md) |
|
|
438
|
+
| Auto-sprint CLI reference | [packages/apra-fleet-se/docs/cli-reference.md](packages/apra-fleet-se/docs/cli-reference.md) |
|
|
439
|
+
| Auto-sprint internals (cycle loop, stall detection, budget, topology) | [packages/apra-fleet-se/docs/architecture.md](packages/apra-fleet-se/docs/architecture.md) |
|
|
440
|
+
| Auto-sprint agent role contracts | [packages/apra-fleet-se/docs/role-contracts.md](packages/apra-fleet-se/docs/role-contracts.md) |
|
|
441
|
+
| fleet-supervisor skill (start/stop/restart/auto-start-on-boot, sprint launch via HTTP API) | [packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md](packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md) |
|
|
442
|
+
| fleet-supervisor packaging self-containment audit | [packages/apra-fleet-se/docs/supervisor-selfcontainment-audit.md](packages/apra-fleet-se/docs/supervisor-selfcontainment-audit.md) |
|
|
443
|
+
| MCP client SDK overview (transports, `ApraFleet` API) | [packages/apra-fleet-client/docs/overview.md](packages/apra-fleet-client/docs/overview.md) |
|
|
444
|
+
| MCP client SDK API reference | [packages/apra-fleet-client/docs/api-reference.md](packages/apra-fleet-client/docs/api-reference.md) |
|
|
445
|
+
| MCP client SDK getting started | [packages/apra-fleet-client/docs/getting-started.md](packages/apra-fleet-client/docs/getting-started.md) |
|
|
329
446
|
|
|
330
447
|
## Community
|
|
331
448
|
|
|
@@ -344,7 +461,6 @@ Build from source (also the path for Intel Macs):
|
|
|
344
461
|
|
|
345
462
|
```bash
|
|
346
463
|
git clone https://github.com/Apra-Labs/apra-fleet && cd apra-fleet
|
|
347
|
-
git submodule update --init
|
|
348
464
|
npm install && npm run build && npm test
|
|
349
465
|
```
|
|
350
466
|
|
|
@@ -353,3 +469,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) to contribute.
|
|
|
353
469
|
## License
|
|
354
470
|
|
|
355
471
|
Apache 2.0 -- see [LICENSE](LICENSE).
|
|
472
|
+
|
|
473
|
+
---
|
|
474
|
+
|
|
475
|
+
<div align="center">
|
|
476
|
+
|
|
477
|
+
**Stop babysitting agents. Start operating fleets.**
|
|
478
|
+
|
|
479
|
+
[Quick Start](#quick-start-5-minutes) - [GitHub Issues](https://github.com/Apra-Labs/apra-fleet/issues) - [Apra Labs](https://apralabs.com)
|
|
480
|
+
|
|
481
|
+
</div>
|