@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,177 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
|
|
4
|
+
// =============================================================================
|
|
5
|
+
// apra-fleet-eft.3.3 -- dispatch-safety guard checker, extracted so it is
|
|
6
|
+
// exported/parameterizable by path.
|
|
7
|
+
//
|
|
8
|
+
// This module holds the bracket-aware `command(`/`agent(` call-site parser
|
|
9
|
+
// originally written inline in dispatch-safety-guard.test.mjs
|
|
10
|
+
// (apra-fleet-eft.3.1). It is factored out here so the checker can be
|
|
11
|
+
// pointed at an arbitrary source file -- in particular a test fixture that
|
|
12
|
+
// deliberately violates the invariant -- WITHOUT mutating
|
|
13
|
+
// packages/apra-fleet-se/fleet-sprint/runner.js itself to manufacture a
|
|
14
|
+
// failure case. dispatch-safety-guard.test.mjs imports this module both for
|
|
15
|
+
// its real runner.js baseline assertion and for fixture-driven tests that
|
|
16
|
+
// prove the checker actually detects a violation rather than passing
|
|
17
|
+
// vacuously.
|
|
18
|
+
//
|
|
19
|
+
// Invariant under test (unchanged from eft.3.1): EVERY `command(` / `agent(`
|
|
20
|
+
// call site in a scanned source file must supply an explicit `member_name`
|
|
21
|
+
// (or `member_id`) in its options object.
|
|
22
|
+
// =============================================================================
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Returns true if `col` (0-based index into `lineText`) sits inside an open
|
|
26
|
+
* `"..."` or `'...'` string that started earlier on the SAME line -- i.e. an
|
|
27
|
+
* odd number of unescaped quote characters of the currently-open type
|
|
28
|
+
* precede it. Deliberately scoped to a single line (not a whole-file quote
|
|
29
|
+
* scan): a whole-file scan misfires on stray apostrophes in prose comments
|
|
30
|
+
* (e.g. "doesn't", "it's"), which would otherwise be misread as opening a
|
|
31
|
+
* string and swallow everything up to the next quote -- including real
|
|
32
|
+
* command()/agent() call sites many lines later. Backticks are deliberately
|
|
33
|
+
* NOT tracked here: template literals legitimately span multiple lines (git
|
|
34
|
+
* command strings) and are not a source of the false positive this guards
|
|
35
|
+
* against (a real call site's own leading backtick is never itself inside a
|
|
36
|
+
* string).
|
|
37
|
+
*/
|
|
38
|
+
export function isInsideSameLineString(lineText, col) {
|
|
39
|
+
let quote = null;
|
|
40
|
+
for (let i = 0; i < col; i++) {
|
|
41
|
+
const ch = lineText[i];
|
|
42
|
+
if (ch === '\\') { i++; continue; }
|
|
43
|
+
if (quote) {
|
|
44
|
+
if (ch === quote) quote = null;
|
|
45
|
+
} else if (ch === '"' || ch === "'") {
|
|
46
|
+
quote = ch;
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
return quote !== null;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** Returns the index of the closing quote char matching the one at `start`. */
|
|
53
|
+
export function skipStringLiteral(src, start, quoteChar) {
|
|
54
|
+
let i = start + 1;
|
|
55
|
+
for (; i < src.length; i++) {
|
|
56
|
+
const ch = src[i];
|
|
57
|
+
if (ch === '\\') {
|
|
58
|
+
i++; // skip escaped char
|
|
59
|
+
continue;
|
|
60
|
+
}
|
|
61
|
+
if (ch === quoteChar) return i;
|
|
62
|
+
}
|
|
63
|
+
return i;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Given the index of an opening '(' in `src`, returns the full call-site
|
|
68
|
+
* text from that '(' through its matching ')', tracking paren depth and
|
|
69
|
+
* skipping over string/template-literal contents (so parens embedded in
|
|
70
|
+
* string/template content, e.g. `bd show ${ids.join(' ')}`, never disturb
|
|
71
|
+
* the depth count).
|
|
72
|
+
*/
|
|
73
|
+
export function extractBalancedCall(src, openParenIdx) {
|
|
74
|
+
let depth = 0;
|
|
75
|
+
let i = openParenIdx;
|
|
76
|
+
for (; i < src.length; i++) {
|
|
77
|
+
const ch = src[i];
|
|
78
|
+
if (ch === '(') {
|
|
79
|
+
depth++;
|
|
80
|
+
} else if (ch === ')') {
|
|
81
|
+
depth--;
|
|
82
|
+
if (depth === 0) {
|
|
83
|
+
return src.slice(openParenIdx, i + 1);
|
|
84
|
+
}
|
|
85
|
+
} else if (ch === '"' || ch === "'" || ch === '`') {
|
|
86
|
+
i = skipStringLiteral(src, i, ch);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
// Unbalanced -- should never happen against real, syntactically-valid
|
|
90
|
+
// source; return what we found so the caller's member_name check still
|
|
91
|
+
// has something to inspect rather than throwing mid-scan.
|
|
92
|
+
return src.slice(openParenIdx, i);
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* Scans `src` for `command(`/`agent(` call sites, skipping call-site tokens
|
|
97
|
+
* that only appear inside a full-line comment. Returns an array of
|
|
98
|
+
* { fnName, line, callText } for every real call site found.
|
|
99
|
+
*/
|
|
100
|
+
export function findCallSites(src) {
|
|
101
|
+
const lines = src.split('\n');
|
|
102
|
+
// Byte offset of the start of each line, so a regex match index into
|
|
103
|
+
// the whole-file string can be mapped back to a 1-based line number.
|
|
104
|
+
const lineStarts = [];
|
|
105
|
+
let offset = 0;
|
|
106
|
+
for (const line of lines) {
|
|
107
|
+
lineStarts.push(offset);
|
|
108
|
+
offset += line.length + 1; // +1 for the '\n' stripped by split()
|
|
109
|
+
}
|
|
110
|
+
function lineNumberForIndex(idx) {
|
|
111
|
+
// Binary search would be overkill for a single source file; linear
|
|
112
|
+
// scan is fine here.
|
|
113
|
+
let ln = 0;
|
|
114
|
+
for (let i = 0; i < lineStarts.length; i++) {
|
|
115
|
+
if (lineStarts[i] > idx) break;
|
|
116
|
+
ln = i;
|
|
117
|
+
}
|
|
118
|
+
return ln + 1; // 1-based
|
|
119
|
+
}
|
|
120
|
+
function isCommentLine(ln) {
|
|
121
|
+
const text = lines[ln - 1] ? lines[ln - 1].trim() : '';
|
|
122
|
+
return text.startsWith('//') || text.startsWith('*') || text.startsWith('/*');
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
// Matches `command(` / `agent(` NOT preceded by a `.` or word character
|
|
126
|
+
// (so e.g. `dispatchCommand(` or `.command(` -- neither of which occurs
|
|
127
|
+
// for the fleet dispatch primitives, but this guards against false
|
|
128
|
+
// positives from unrelated identifiers ending in the same substring).
|
|
129
|
+
const callRe = /(?<![.\w])(command|agent)\(/g;
|
|
130
|
+
const sites = [];
|
|
131
|
+
let m;
|
|
132
|
+
while ((m = callRe.exec(src)) !== null) {
|
|
133
|
+
const fnName = m[1];
|
|
134
|
+
const openParenIdx = m.index + m[0].length - 1; // index of the '(' itself
|
|
135
|
+
const line = lineNumberForIndex(m.index);
|
|
136
|
+
if (isCommentLine(line)) continue;
|
|
137
|
+
// Reject matches where the literal text "command(" / "agent(" sits
|
|
138
|
+
// inside a same-line quoted string (e.g. a `throw new Error("...
|
|
139
|
+
// command() ...")` message) -- not a real dispatch call site.
|
|
140
|
+
const lineText = lines[line - 1] || '';
|
|
141
|
+
const col = m.index - lineStarts[line - 1];
|
|
142
|
+
if (isInsideSameLineString(lineText, col)) continue;
|
|
143
|
+
const callText = extractBalancedCall(src, openParenIdx);
|
|
144
|
+
sites.push({ fnName, line, callText });
|
|
145
|
+
}
|
|
146
|
+
return sites;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
const MEMBER_RE = /\b(member_name|member_id)\b/;
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* Given an array of call sites (as returned by findCallSites), returns the
|
|
153
|
+
* subset lacking an explicit member_name/member_id, each formatted as a
|
|
154
|
+
* human-readable violation string naming `fileLabel` and the offending
|
|
155
|
+
* line -- e.g. "fixture.mjs:4 (command()) is missing member_name/member_id".
|
|
156
|
+
*/
|
|
157
|
+
export function findViolations(sites, fileLabel) {
|
|
158
|
+
return sites
|
|
159
|
+
.filter((s) => !MEMBER_RE.test(s.callText))
|
|
160
|
+
.map((s) => `${fileLabel}:${s.line} (${s.fnName}()) is missing member_name/member_id`);
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* Reads and scans the source file at `filePath` for command()/agent() call
|
|
165
|
+
* sites, returning { sites, violations }. This is the checker's main
|
|
166
|
+
* path-parameterized entry point: callers -- real runner.js baseline
|
|
167
|
+
* assertions, or fixture-driven tests exercising a deliberately
|
|
168
|
+
* non-compliant call site -- pass whatever file path they want scanned,
|
|
169
|
+
* without needing to mutate runner.js to manufacture a failing case.
|
|
170
|
+
*/
|
|
171
|
+
export function checkPath(filePath) {
|
|
172
|
+
const src = fs.readFileSync(filePath, 'utf8');
|
|
173
|
+
const sites = findCallSites(src);
|
|
174
|
+
const fileLabel = path.basename(filePath);
|
|
175
|
+
const violations = findViolations(sites, fileLabel);
|
|
176
|
+
return { sites, violations };
|
|
177
|
+
}
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
# Running fleet-sprint
|
|
2
|
+
|
|
3
|
+
`fleet-sprint` is this package's autonomous sprint engine. It drives a full
|
|
4
|
+
plan -> develop -> review -> deploy -> integ-test -> harvest cycle across one
|
|
5
|
+
or more registered fleet members, working a set of beads issues on a branch
|
|
6
|
+
and opening a PR at the end.
|
|
7
|
+
|
|
8
|
+
This doc covers the two ways to invoke it, the full argument contract, the
|
|
9
|
+
preconditions to check first, and the beads hierarchy rules that determine
|
|
10
|
+
what a sprint actually picks up as its scope.
|
|
11
|
+
|
|
12
|
+
## Two ways to invoke it
|
|
13
|
+
|
|
14
|
+
Both forms run the exact same engine
|
|
15
|
+
(`packages/apra-fleet-se/fleet-sprint/runner.js`) with the same flags. They
|
|
16
|
+
differ only in how the entry point is resolved.
|
|
17
|
+
|
|
18
|
+
### 1. Installed binary (normal use)
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
apra-fleet workflow fleet-sprint \
|
|
22
|
+
--issue apra-fleet-eft \
|
|
23
|
+
--members fleet-rev \
|
|
24
|
+
--branch sprint/eft-service-fixes \
|
|
25
|
+
--base main \
|
|
26
|
+
--viewer-port 18300
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
This is the ONE command for every install method -- git-clone dev checkout,
|
|
30
|
+
`npm install -g @apralabs/apra-fleet`, and the pre-built standalone binary
|
|
31
|
+
all resolve it identically; there is no separate npm-only invocation to
|
|
32
|
+
learn. The launcher resolves the workflow from
|
|
33
|
+
`~/.apra-fleet/workflows/fleet-sprint` (installed by `apra-fleet install`,
|
|
34
|
+
self-healed on demand). Everything after the workflow name is passed
|
|
35
|
+
through verbatim, so `apra-fleet workflow fleet-sprint --help` prints the
|
|
36
|
+
engine's own help.
|
|
37
|
+
|
|
38
|
+
### 2. Directly from a source checkout (development only)
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
node packages/apra-fleet-se/bin/cli.mjs \
|
|
42
|
+
--issue apra-fleet-eft \
|
|
43
|
+
--members fleet-rev \
|
|
44
|
+
--branch sprint/eft-service-fixes \
|
|
45
|
+
--base main \
|
|
46
|
+
--viewer-port 18300
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
A development-only shortcut for when you are actively changing the engine
|
|
50
|
+
itself and want to run the working tree directly rather than the installed
|
|
51
|
+
copy. Not needed, and not documented as a supported path, for any other use
|
|
52
|
+
-- use mode 1 above.
|
|
53
|
+
|
|
54
|
+
### Backgrounding
|
|
55
|
+
|
|
56
|
+
A sprint is a long-running process. Start it genuinely detached, not as a
|
|
57
|
+
child of a short-lived tool call whose process group can be killed out from
|
|
58
|
+
under it:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
# POSIX
|
|
62
|
+
nohup apra-fleet workflow fleet-sprint --issue <id> --members <m> \
|
|
63
|
+
--branch <branch> --base <base> > sprint.log 2>&1 &
|
|
64
|
+
disown
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
```powershell
|
|
68
|
+
# Windows
|
|
69
|
+
Start-Process -FilePath "apra-fleet" -ArgumentList "workflow","fleet-sprint", `
|
|
70
|
+
"--issue","<id>","--members","<m>","--branch","<branch>","--base","<base>" `
|
|
71
|
+
-RedirectStandardOutput "sprint.log" -RedirectStandardError "sprint.err.log" `
|
|
72
|
+
-WindowStyle Hidden -PassThru
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
On start it prints the dashboard URL (`http://localhost:<viewer-port>`).
|
|
76
|
+
Watch progress there rather than tailing raw stdout.
|
|
77
|
+
|
|
78
|
+
## Arguments
|
|
79
|
+
|
|
80
|
+
| Flag | Short | Required | Default | Description |
|
|
81
|
+
|---|---|---|---|---|
|
|
82
|
+
| `--issue <ids>` | `-i` | yes | -- | Target issue ID(s), comma separated (e.g. `epic-1,epic-2`). Scope resolves via `bd list --parent <id>` -- see the epics section below. |
|
|
83
|
+
| `--members <ids>` | `-m` | yes | -- | Member IDs/names to use, comma separated. Members act as repo targets for parallelism. |
|
|
84
|
+
| `--branch <name>` | `-b` | yes | -- | Sprint branch to develop on. Created from `--base` if it does not exist; reused as-is if it does. |
|
|
85
|
+
| `--base <name>` | `-B` | yes | -- | Base branch the sprint branch is created from, and the branch the eventual PR targets. |
|
|
86
|
+
| `--goal <goal>` | `-g` | no | `P1/P2` | Sprint goal constraint. One of `P1`, `P1/P2`, `P1/P2/P3`. |
|
|
87
|
+
| `--max-cycles <n>` | `-c` | no | `5` | Max plan/develop/review cycles. |
|
|
88
|
+
| `--allow-missing-members` | | no | off | Warn and continue if some `--members` are not registered with the fleet. Without it, any missing member aborts the sprint. |
|
|
89
|
+
| `--requirements-file <path>` | | no | -- | Path to a requirements file threaded into the planner's prompt. |
|
|
90
|
+
| `--role-map <json\|@file>` | | no | -- | JSON object mapping role -> member[], e.g. `'{"doer":["m1","m2"]}'`. Inline JSON or `@path/to/file.json`. |
|
|
91
|
+
| `--viewer-port <port>` | | no | `8080` | Port for the local dashboard viewer. |
|
|
92
|
+
| `--budget <usd>` | | no | unlimited | USD ceiling for this run's total estimated spend. |
|
|
93
|
+
| `--dispatch-timeout-s <s>` | | no | `9000` | Per-dispatch time budget in seconds, applied as both the inactivity timeout and the hard ceiling on every agent dispatch (integ-test dispatch ceiling is 2x, regression-test ceiling is 3x). Minimum 60. Lower it for small sprints so a hung dispatch costs minutes, not 2.5 hours. |
|
|
94
|
+
| `--sync` | | no | off | Synced topology mode (orchestrator-bracketed git sync): members may sit on differing HEADs but must share the same origin URL and pass a `bd dolt pull` probe. Omitted uses shared-workspace mode (all members on the same HEAD). |
|
|
95
|
+
| `--help` | `-h` | | | Show the engine's help. |
|
|
96
|
+
|
|
97
|
+
Unrecognized flags fail loudly rather than being silently ignored, so a typo
|
|
98
|
+
like `--max-cycle` aborts instead of quietly applying the default.
|
|
99
|
+
|
|
100
|
+
## Preconditions worth checking first
|
|
101
|
+
|
|
102
|
+
- The target issue (e.g. `apra-fleet-7pm`) must exist and be open:
|
|
103
|
+
`bd show <issue>`.
|
|
104
|
+
- Every `--members` name must be registered with the fleet
|
|
105
|
+
(`list_members`); an unregistered member aborts the sprint unless
|
|
106
|
+
`--allow-missing-members` is passed.
|
|
107
|
+
- Multi-member sprints require all configured members to share the same
|
|
108
|
+
git HEAD (`checkMemberTopology`) unless `--sync` is passed -- see
|
|
109
|
+
`fleet-sprint-diagram.md` for the supported-topology notes. Stick to
|
|
110
|
+
single-member unless that is verified.
|
|
111
|
+
- If a member's LLM session is stale or unauthenticated (dispatch fails with
|
|
112
|
+
`empty_response`, or "member CLI likely died"), re-run `provision_llm_auth`
|
|
113
|
+
for that member before retrying.
|
|
114
|
+
|
|
115
|
+
## How to make one bead represent a whole set (epics / manifest beads)
|
|
116
|
+
|
|
117
|
+
If you want a single bead to stand in for a group of other beads (an epic,
|
|
118
|
+
a "next sprint scope" manifest, etc.), the group members MUST be linked as
|
|
119
|
+
**parent-child**, not as **blocked-by**:
|
|
120
|
+
|
|
121
|
+
- Add each item as a child of the umbrella bead:
|
|
122
|
+
`bd create ... --parent <umbrella-id>` (new beads), or
|
|
123
|
+
`bd update <id> --parent <umbrella-id>` (existing beads).
|
|
124
|
+
- The umbrella bead itself must have **zero** blocking dependencies of its
|
|
125
|
+
own -- do not also add `blocks` edges from the umbrella bead to its own
|
|
126
|
+
children. It should only ever be the *target* of parent-child edges
|
|
127
|
+
(children point at it), never the source of a `blocks` edge pointing at
|
|
128
|
+
them.
|
|
129
|
+
- "All done" tracking (closing the umbrella bead once every child is
|
|
130
|
+
closed) is a manual/observational step based on child status
|
|
131
|
+
(`dependent_count`), not something enforced by a `blocks` edge.
|
|
132
|
+
|
|
133
|
+
Why this matters: `bd`'s ready-work engine treats a `blocks` edge as a real
|
|
134
|
+
blocker. If the umbrella bead both (a) is `blocked-by` its children (so it
|
|
135
|
+
can't close until they do) AND (b) is their `parent` (so they belong to it),
|
|
136
|
+
that is a 2-node cycle on every pair -- and `bd` marks every bead caught in
|
|
137
|
+
a cycle as **not ready**, deadlocking the umbrella bead and all of its
|
|
138
|
+
children simultaneously. This is exactly what "blocked-by" gets you wrong
|
|
139
|
+
and "parent-child" gets right: a successful epic (e.g. `apra-fleet-7pm`)
|
|
140
|
+
has `dependency_count: 0` (it depends on / is blocked by nothing) and a
|
|
141
|
+
nonzero `dependent_count` (its children point at it). A broken manifest
|
|
142
|
+
bead that used `blocks` instead had `dependency_count: 5` and, once
|
|
143
|
+
children were also parented under it, deadlocked completely.
|
|
144
|
+
|
|
145
|
+
This also matters for launching a sprint: `fleet-sprint`'s `--issue <id>`
|
|
146
|
+
flag resolves the sprint's scope via `bd list --parent <id>` internally --
|
|
147
|
+
it only ever understands the `parent-child` hierarchy. A `blocked-by`-only
|
|
148
|
+
manifest bead is invisible to fleet-sprint's scope filter no matter what you
|
|
149
|
+
pass to `--issue`; only true children are picked up.
|
|
150
|
+
|
|
151
|
+
## Recovering a wedged member reservation (launched via the supervisor)
|
|
152
|
+
|
|
153
|
+
If a sprint was launched through the supervisor (`fleet-se serve`, `POST
|
|
154
|
+
/api/sprints`) and its child process crashes or is killed, the supervisor's
|
|
155
|
+
reservation ledger does **not** release that sprint's claim on its own during
|
|
156
|
+
normal runtime -- only a supervisor restart, or an explicit operator call,
|
|
157
|
+
clears it. Symptom: relaunching against the same member(s) is rejected with
|
|
158
|
+
|
|
159
|
+
```
|
|
160
|
+
409 member overlap rejects launch: sprint '<old-sprint-id>' already claims [<member>]
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
and `POST /api/sprints/:id/stop` against that same old sprint id also fails
|
|
164
|
+
(`409 ... no reachable child (port unknown)`) because the child is already
|
|
165
|
+
dead -- there is nothing left to proxy a stop to.
|
|
166
|
+
|
|
167
|
+
Clear it directly, with no supervisor restart required:
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
curl -X POST http://localhost:8787/api/reservations/<old-sprint-id>/force-release \
|
|
171
|
+
-H "Content-Type: application/json" \
|
|
172
|
+
-d '{"by": "<your name/reason>", "reason": "sprint child crashed, pid confirmed dead"}'
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
This releases both of the supervisor ledger's axes (member set + issue-scope
|
|
176
|
+
root) for that sprint id in one call and records an auditable
|
|
177
|
+
`force-released` event in the supervisor's event history. It does **not**
|
|
178
|
+
restart anything and does not affect any other live sprint.
|
|
179
|
+
|
|
180
|
+
This is a *different* mechanism from the fleet server's own per-member
|
|
181
|
+
`reservedBy` field (enforced at dispatch time, independent of the
|
|
182
|
+
supervisor). If a relaunch still 409s after force-releasing the ledger side,
|
|
183
|
+
also clear that axis:
|
|
184
|
+
|
|
185
|
+
```
|
|
186
|
+
mcp__apra-fleet__member_reservation action: "force_release" member_name: "<member>"
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
A crashed sprint can leave either axis wedged independently of the other --
|
|
190
|
+
check both. See `packages/apra-fleet-se/docs/architecture.md` ("Supervisor:
|
|
191
|
+
process model" / "Manual force-release") for the full mechanism.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Coach Role (superseded -- see escalate-to-llm-design.md)
|
|
2
|
+
|
|
3
|
+
Status: SUPERSEDED 2026-08-10 by the sprint-doctor design in
|
|
4
|
+
[`escalate-to-llm-design.md`](escalate-to-llm-design.md). Kept as a pointer so
|
|
5
|
+
links and history resolve; the full original text is in git history
|
|
6
|
+
(this file, prior to this commit).
|
|
7
|
+
|
|
8
|
+
The coach idea (2026-07-20): an in-workflow LLM role for error classes the
|
|
9
|
+
deterministic engine did not foresee -- invoked strictly after typed
|
|
10
|
+
handlers/ladders, single-shot, capped per error class, filing a sanitized
|
|
11
|
+
bug report for every intervention, failing loudly when it cannot fix.
|
|
12
|
+
|
|
13
|
+
sprint-doctor is that idea carried forward under a new name, with a stricter
|
|
14
|
+
decision/action split (zero-tool consult; the runner executes a bounded
|
|
15
|
+
action enum), an explicit environment-vs-engine-vs-task-shape triage, a
|
|
16
|
+
data-driven symptom/remedy registry, stagnation triggers on top of coach's
|
|
17
|
+
red-state events, and a generic engine-level pause/resume for human
|
|
18
|
+
hand-off. Every load-bearing coach idea was folded in and is credited
|
|
19
|
+
inline in the doctor doc: the three-layer error-handling hierarchy and
|
|
20
|
+
red-state taxonomy (its section 1), same-class-twice fingerprint cap,
|
|
21
|
+
no-recursion, interventions-as-review-evidence and deterministic test
|
|
22
|
+
stubbing (section 6), rescue-WIP-to-branch salvage (section 2.5), and the
|
|
23
|
+
consent-gated sanitized telemetry flow (section 4.4).
|
|
@@ -0,0 +1,256 @@
|
|
|
1
|
+
# Dolt manual recovery runbook (verified 2026-08-12, all steps live-tested on fleet-win-dev1)
|
|
2
|
+
|
|
3
|
+
This is the ground-truth procedure for standing up an ephemeral `dolt sql-server`
|
|
4
|
+
against a wedged embedded Dolt clone, querying/repairing it, and tearing it back
|
|
5
|
+
down -- verified end to end against a real clone on a real member, not written
|
|
6
|
+
from docs.
|
|
7
|
+
|
|
8
|
+
STATUS: this procedure is now AUTOMATED end to end by `settleDoltConflicts()`
|
|
9
|
+
(`packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs`), which is the
|
|
10
|
+
executable form of this document and runs at both sync divergence terminals --
|
|
11
|
+
fleet members self-heal without a human or an LLM. The old Path A / Path B /
|
|
12
|
+
Tier 2 ladder and its LLM runbook (`dolt-tier2-runbook.md`) were retired and
|
|
13
|
+
deleted; see `dolt-sync-redesign.md`.
|
|
14
|
+
|
|
15
|
+
This document remains the SPECIFICATION that code encodes, and the human
|
|
16
|
+
copy-paste fallback for driving a clone by hand. Every step here was
|
|
17
|
+
independently rediscovered by trial and error at least once already (see
|
|
18
|
+
apra-fleet-ga61, apra-fleet-5mqg) -- which is exactly why it is written down
|
|
19
|
+
and encoded once.
|
|
20
|
+
|
|
21
|
+
## 0. Precondition: find the REAL data directory. Never hardcode it.
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
bd dolt status
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Read the `Data:` line from the output (also mirrored in `.beads/metadata.json`'s
|
|
28
|
+
`dolt_mode` field). This is bd's own live, authoritative answer for THIS clone,
|
|
29
|
+
right now. Do not assume `.beads/embeddeddolt` -- that happens to be bd's
|
|
30
|
+
convention today, but a script that hardcodes it and finds a second/different
|
|
31
|
+
directory should treat that as orphaned residue from a prior failed recovery
|
|
32
|
+
(see apra-fleet-5mqg) and refuse to proceed blind, not silently pick one.
|
|
33
|
+
|
|
34
|
+
If `bd dolt status` reports `embedded (in-process, no server)`, there is no
|
|
35
|
+
live server to route through -- an ephemeral one must be started (step 2). If
|
|
36
|
+
it already reports a live server (host:port), skip straight to step 3 and
|
|
37
|
+
target that existing server/port instead of starting a second one.
|
|
38
|
+
|
|
39
|
+
## 1. Ensure the PINNED `dolt` binary is present (never a package manager)
|
|
40
|
+
|
|
41
|
+
The embedded `bd` binary does NOT ship enough of the Dolt CLI to drive a
|
|
42
|
+
merge-conflict resolution over SQL -- that requires the real `dolt` binary and
|
|
43
|
+
a real `dolt sql-server` process, temporarily, against the SAME data directory.
|
|
44
|
+
|
|
45
|
+
CORRECTED 2026-08-13 (`dolt-sync-redesign.md` Part 5, Precondition V2). This
|
|
46
|
+
step previously said `winget install --id DoltHub.Dolt` on Windows, plus
|
|
47
|
+
`apt`/`brew` on POSIX. That was a genuine mistake and must not be repeated:
|
|
48
|
+
winget delivered a STALE 1.86.3 build while this repo carries its own version
|
|
49
|
+
pin, so an OS package manager is a second, unpinned version channel -- banned
|
|
50
|
+
from every code path and runbook this design owns. It also created a PATH
|
|
51
|
+
problem of its own: a winget-installed binary is invisible to processes that
|
|
52
|
+
started before the install, which is every SSH-dispatched session.
|
|
53
|
+
|
|
54
|
+
The fleet's ONE pinned channel is the same GitHub release asset
|
|
55
|
+
`src/cli/dolt-install.ts` uses (`DOLT_VERSION`, currently `v2.2.0`), landed at
|
|
56
|
+
the fleet-managed path -- always referenced as an absolute path, never system
|
|
57
|
+
PATH, and needing no admin rights:
|
|
58
|
+
|
|
59
|
+
- Windows: `%USERPROFILE%\.apra-fleet\bin\dolt.exe`
|
|
60
|
+
- POSIX: `$HOME/.apra-fleet/bin/dolt`
|
|
61
|
+
|
|
62
|
+
Probe it first -- existence is not enough, it must actually RUN and report the
|
|
63
|
+
pinned version:
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
"$HOME/.apra-fleet/bin/dolt" version # POSIX
|
|
67
|
+
```
|
|
68
|
+
```powershell
|
|
69
|
+
& "$env:USERPROFILE\.apra-fleet\bin\dolt.exe" version # Windows
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
If it is missing, broken, or the wrong version, install it from the pinned
|
|
73
|
+
asset. `settleDoltConflicts()` does exactly this itself (`ensurePinnedDolt()`
|
|
74
|
+
in `dolt-settle.mjs`, design doc Part 5.3) -- members never run
|
|
75
|
+
`apra-fleet install`, so nothing else on a member ever puts a pinned dolt
|
|
76
|
+
there. By hand, the same sequence is:
|
|
77
|
+
|
|
78
|
+
**Windows:**
|
|
79
|
+
```powershell
|
|
80
|
+
New-Item -ItemType Directory -Force "$env:USERPROFILE\.apra-fleet\bin" | Out-Null
|
|
81
|
+
Invoke-WebRequest -Uri https://github.com/dolthub/dolt/releases/download/v2.2.0/dolt-windows-amd64.zip -OutFile "$env:TEMP\dolt-settle.zip" -TimeoutSec 300
|
|
82
|
+
Expand-Archive -Force "$env:TEMP\dolt-settle.zip" "$env:TEMP\dolt-settle"
|
|
83
|
+
Get-ChildItem -Recurse -Filter dolt.exe "$env:TEMP\dolt-settle" | Select-Object -First 1 |
|
|
84
|
+
Copy-Item -Force -Destination "$env:USERPROFILE\.apra-fleet\bin\dolt.exe"
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
**Linux / macOS** (swap the asset for `dolt-linux-amd64.tar.gz`,
|
|
88
|
+
`dolt-darwin-amd64.tar.gz` or `dolt-darwin-arm64.tar.gz` to match the member):
|
|
89
|
+
```bash
|
|
90
|
+
mkdir -p "$HOME/.apra-fleet/bin"
|
|
91
|
+
curl -fL --max-time 300 https://github.com/dolthub/dolt/releases/download/v2.2.0/dolt-linux-amd64.tar.gz -o /tmp/dolt-settle.tgz
|
|
92
|
+
mkdir -p /tmp/dolt-settle && tar -xzf /tmp/dolt-settle.tgz -C /tmp/dolt-settle
|
|
93
|
+
install -m 0755 "$(find /tmp/dolt-settle -type f -name dolt | head -1)" "$HOME/.apra-fleet/bin/dolt"
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
Then re-probe: the freshly installed binary must report the pinned version
|
|
97
|
+
before you continue. On Windows a replace can fail because a stray `dolt`
|
|
98
|
+
process holds the file -- kill any process whose executable path IS this
|
|
99
|
+
fleet-managed path (nothing else ever launches a binary there) and retry once.
|
|
100
|
+
|
|
101
|
+
Every `dolt ...` invocation below means that absolute pinned path, not a bare
|
|
102
|
+
`dolt` from PATH.
|
|
103
|
+
|
|
104
|
+
## 2. Start the ephemeral sql-server -- GENUINELY DETACHED
|
|
105
|
+
|
|
106
|
+
This is the step with real cross-platform divergence, and where most of the
|
|
107
|
+
danger lives (an interrupted/never-torn-down server is exactly what
|
|
108
|
+
apra-fleet-5mqg is about).
|
|
109
|
+
|
|
110
|
+
**Windows -- do NOT use `Start-Process` or `schtasks`:**
|
|
111
|
+
|
|
112
|
+
- `Start-Process -WindowStyle Hidden` looked detached but is NOT: it is still a
|
|
113
|
+
child of the invoking SSH/job-object session. Verified live: the sql-server
|
|
114
|
+
process (and its listening port) died the instant the launching
|
|
115
|
+
`execute_command` call's session ended, even with `-RedirectStandardOutput`/
|
|
116
|
+
`-RedirectStandardError` set and `-PassThru`.
|
|
117
|
+
- `schtasks`/`Register-ScheduledTask` + `Start-ScheduledTask` also failed:
|
|
118
|
+
verified live, `Get-ScheduledTaskInfo` reported `LastTaskResult 267011`
|
|
119
|
+
(`SCHED_S_TASK_QUEUED`) -- the task was queued but never actually ran,
|
|
120
|
+
because this is a non-interactive SSH session with no interactive logon
|
|
121
|
+
(the exact apra-fleet-i8qj failure mode, reproduced here independently).
|
|
122
|
+
- **What actually works, verified live:** spawn via WMI, which creates the
|
|
123
|
+
process under the WMI provider host's own session (session 0), fully
|
|
124
|
+
independent of the SSH session's job object:
|
|
125
|
+
|
|
126
|
+
```powershell
|
|
127
|
+
$result = Invoke-CimMethod -ClassName Win32_Process -MethodName Create -Arguments @{
|
|
128
|
+
CommandLine = '"C:\Users\<you>\.apra-fleet\bin\dolt.exe" sql-server --host 127.0.0.1 --port 13399 --data-dir .beads/embeddeddolt'
|
|
129
|
+
CurrentDirectory = 'C:\akhil\git\apra-fleet'
|
|
130
|
+
}
|
|
131
|
+
$result.ProcessId # <-- record this PID for teardown (step 5)
|
|
132
|
+
```
|
|
133
|
+
Verify it is actually up before proceeding: `Get-Process -Id <pid>` should
|
|
134
|
+
show it running under `SI` (session ID) `0`, and
|
|
135
|
+
`Test-NetConnection -ComputerName 127.0.0.1 -Port 13399` should report
|
|
136
|
+
`TcpTestSucceeded: True`.
|
|
137
|
+
|
|
138
|
+
**Linux / macOS (POSIX):** the SSH-session-job-object problem does not exist on
|
|
139
|
+
POSIX in the same way; the existing `nohup ... & disown` pattern (as used by
|
|
140
|
+
`task-wrapper.ts`'s bash wrapper for `long_running` commands elsewhere in this
|
|
141
|
+
codebase) is sufficient:
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
nohup dolt sql-server --host 127.0.0.1 --port 13399 --data-dir .beads/embeddeddolt \
|
|
145
|
+
> /tmp/dolt-recovery.log 2>&1 &
|
|
146
|
+
echo "PID:$!"
|
|
147
|
+
disown
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
## 3. Connect and query -- the exact working flag set (verified live)
|
|
151
|
+
|
|
152
|
+
```
|
|
153
|
+
dolt --no-tls --host=127.0.0.1 --port=13399 sql -q "USE beads; SELECT ...;"
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
Two specific, non-obvious landmines, both reproduced live on this run:
|
|
157
|
+
|
|
158
|
+
1. **`--no-tls` must come BEFORE `--host`/`--port`.** With `--host`/`--port`
|
|
159
|
+
given first and `--no-tls` after, the client still requested TLS and failed
|
|
160
|
+
with `TLS requested but server does not support TLS` -- Dolt's global-flag
|
|
161
|
+
parser is order-sensitive here. Always lead with `--no-tls`.
|
|
162
|
+
2. **Do NOT pass `--user=root` or `--password` at all**, even though root with
|
|
163
|
+
an empty password is the documented default. Explicitly passing `--user=root`
|
|
164
|
+
switches the client into a credential-resolution path that issues an
|
|
165
|
+
interactive `Enter password:` prompt and then fails non-interactively with
|
|
166
|
+
`Failed to parse credentials: The handle is invalid` -- this is the EXACT
|
|
167
|
+
apra-fleet-ga61 symptom, reproduced live and now root-caused precisely: it
|
|
168
|
+
is triggered by explicitly specifying `--user`/`--password`, not by network
|
|
169
|
+
mode itself. Omitting both flags entirely lets the client silently
|
|
170
|
+
authenticate as root with the empty-password default with zero prompt.
|
|
171
|
+
(Separately, on Windows/PowerShell specifically: an empty-string argument
|
|
172
|
+
like `--password ''` can be silently dropped by PowerShell's native-argument
|
|
173
|
+
passing, shifting the NEXT flag into becoming its value -- another reason to
|
|
174
|
+
just omit the flag rather than try to pass an explicit empty value.)
|
|
175
|
+
|
|
176
|
+
Use `USE beads;` as the first statement of every query -- the target database
|
|
177
|
+
name is not implied by `--data-dir` alone once connected over SQL.
|
|
178
|
+
|
|
179
|
+
The actual recovery SQL (identical across all three OSes -- this part has no
|
|
180
|
+
platform variance):
|
|
181
|
+
|
|
182
|
+
```sql
|
|
183
|
+
SET @@dolt_allow_commit_conflicts = 1;
|
|
184
|
+
CALL DOLT_MERGE('origin/main');
|
|
185
|
+
SELECT `table` FROM dolt_conflicts; -- enumerate EVERY conflicted table
|
|
186
|
+
CALL DOLT_CONFLICTS_RESOLVE('--theirs', 'issues'); -- table name is REQUIRED
|
|
187
|
+
CALL DOLT_COMMIT('-m', 'manual recovery: resolve conflict');
|
|
188
|
+
SELECT COUNT(*) FROM dolt_conflicts; -- MUST be 0 before you republish
|
|
189
|
+
```
|
|
190
|
+
A bare `--theirs` is only correct when discarding our side's version of those
|
|
191
|
+
rows is genuinely acceptable. `settleDoltConflicts()` applies the full rulebook
|
|
192
|
+
instead -- per-field last-writer-wins by `updated_at` for `issues` and
|
|
193
|
+
`dependencies`, a real set-union INSERT for `labels`, generic
|
|
194
|
+
LWW-or-theirs for anything else (design doc Part 3.2 step 4). Resolving by hand
|
|
195
|
+
with real content on both sides, follow the same rules rather than clobbering
|
|
196
|
+
one side.
|
|
197
|
+
|
|
198
|
+
Then, outside the SQL session -- and ONLY AFTER the teardown in step 5 --
|
|
199
|
+
`bd dolt pull` (verify), `bd dolt push` (republish). The order matters; see
|
|
200
|
+
step 5.
|
|
201
|
+
|
|
202
|
+
## 4. Verify before teardown
|
|
203
|
+
|
|
204
|
+
```
|
|
205
|
+
dolt --no-tls --host=127.0.0.1 --port=13399 sql -q "USE beads; SELECT * FROM dolt_status;"
|
|
206
|
+
```
|
|
207
|
+
Confirm no residual uncommitted/conflicted state before tearing the server down.
|
|
208
|
+
|
|
209
|
+
## 5. Teardown -- ALWAYS, every path, even on failure, and BEFORE republishing
|
|
210
|
+
|
|
211
|
+
Ordering, corrected (design doc Part 7.2): tear the ephemeral server down
|
|
212
|
+
FIRST, then run `bd dolt pull` / `bd dolt push`. Embedded-mode `bd` must open
|
|
213
|
+
the same data dir the server still holds under Dolt's per-directory exclusive
|
|
214
|
+
lock, so republishing while the server is still up fails or falls back
|
|
215
|
+
read-only.
|
|
216
|
+
|
|
217
|
+
**Windows:**
|
|
218
|
+
```powershell
|
|
219
|
+
Stop-Process -Id <pid> -Force -ErrorAction SilentlyContinue
|
|
220
|
+
```
|
|
221
|
+
**POSIX:**
|
|
222
|
+
```bash
|
|
223
|
+
kill <pid>
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
Then, on every OS:
|
|
227
|
+
- Verify the port is actually closed (`Test-NetConnection` / `nc -z` /
|
|
228
|
+
`lsof -i:<port>`).
|
|
229
|
+
- Verify `bd dolt status` reports `embedded (in-process, no server)` again and
|
|
230
|
+
`.beads/metadata.json`'s `dolt_mode` is `"embedded"` -- if this recovery
|
|
231
|
+
procedure ever explicitly flips `dolt_mode` to `"server"` as part of routing
|
|
232
|
+
bd itself through the ephemeral server (this manual run did NOT do that --
|
|
233
|
+
it talked to the raw `dolt` CLI directly, bypassing bd entirely -- and
|
|
234
|
+
`settleDoltConflicts()` deliberately does the same, which is what makes its
|
|
235
|
+
teardown unconditionally safe), flipping it back is
|
|
236
|
+
MANDATORY and must happen in a `finally`/guaranteed-cleanup block, not as
|
|
237
|
+
the last step of a list that can be abandoned mid-way (exactly what went
|
|
238
|
+
wrong in the incident apra-fleet-5mqg documents).
|
|
239
|
+
- Remove any temp log files created for the ephemeral server's stdout/stderr.
|
|
240
|
+
|
|
241
|
+
## Why this matters for the code fix (apra-fleet-5mqg, apra-fleet-ga61)
|
|
242
|
+
|
|
243
|
+
Every numbered landmine above (`--no-tls` ordering, omitting `--user`/
|
|
244
|
+
`--password`, WMI vs `Start-Process`/`schtasks` for real detachment on Windows,
|
|
245
|
+
never hardcoding the data directory) was independently rediscovered by trial
|
|
246
|
+
and error here, and was ALSO independently rediscovered by trial and error by
|
|
247
|
+
the Tier-2 LLM dispatch whose transcript motivated apra-fleet-5mqg. That was
|
|
248
|
+
strong evidence this entire procedure is mechanical and fully scriptable --
|
|
249
|
+
there was no judgment call anywhere in this runbook, only flag/ordering
|
|
250
|
+
trivia a fixed script encodes once and never has to rediscover again. That
|
|
251
|
+
script now exists: `fleet-sprint/dolt-settle.mjs`.
|
|
252
|
+
|
|
253
|
+
CAVEAT on the evidence: every landmine above was verified live against a
|
|
254
|
+
winget-installed dolt **1.86.3**, not against the pinned **v2.2.0** the fleet
|
|
255
|
+
now installs. Re-verifying them on the pinned binary, per OS, is Precondition
|
|
256
|
+
V0 of the design doc's Part 4 verification pass.
|