@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,148 @@
|
|
|
1
|
+
# Beads -- the single source of truth
|
|
2
|
+
|
|
3
|
+
beads (`bd`) is pm's task store and message bus. It holds what is in flight, what
|
|
4
|
+
is blocked, what was deferred, what each task must satisfy, and what each review
|
|
5
|
+
found. There is no PLAN.md and no progress.json: the planner writes tasks into
|
|
6
|
+
beads, the orchestrator reads `bd ready` and hands the doer explicit bead ids to
|
|
7
|
+
claim/close, and the reviewer reads each task's acceptance criteria with `bd show`. git holds only the code, the branch
|
|
8
|
+
history, and the requirements/design narrative; **beads holds all task state.**
|
|
9
|
+
|
|
10
|
+
## One project, one DB
|
|
11
|
+
|
|
12
|
+
An orchestrator manages one project, so there is one beads DB for that project and
|
|
13
|
+
one **sprint root** per sprint. The DB is a local `.beads/` at the **base checkout** (the
|
|
14
|
+
orchestrator's repo root) -- not inside any track worktree. The orchestrator runs
|
|
15
|
+
every `bd` command from there. Doers run `bd show` / `bd update --claim` /
|
|
16
|
+
`bd close` against that same DB; reviewers run `bd show` only -- they never write to
|
|
17
|
+
beads. On CHANGES NEEDED the reviewer returns `reopenIds` and `newTasks` as structured
|
|
18
|
+
output (it never writes feedback.md); the orchestrator reads that output and runs the
|
|
19
|
+
beads updates.
|
|
20
|
+
The DB persists on disk across sessions, so it survives without being committed.
|
|
21
|
+
Committing it is optional and only shares issue history across machines; if you do,
|
|
22
|
+
commit it on the base or integration branch -- keeping it off the track feature
|
|
23
|
+
branches so parallel tracks share one DB. Tasks reference their track via assignee
|
|
24
|
+
or label.
|
|
25
|
+
|
|
26
|
+
## Lifecycle hooks (not optional)
|
|
27
|
+
|
|
28
|
+
`bd` is called at these points. The planner, doer, and reviewer run their own `bd`
|
|
29
|
+
commands; the orchestrator runs setup, completion, and recovery queries.
|
|
30
|
+
|
|
31
|
+
**Sprint setup** (orchestrator) -- create the sprint root, reusing an existing one if present:
|
|
32
|
+
```
|
|
33
|
+
bd search "sprint: <name>" --status all # reuse the id if found
|
|
34
|
+
bd create "sprint: <name>" -p 1 # else create -> <sprint-id>
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
**Plan phase** (planner) -- one task per plan item, each carrying its acceptance
|
|
38
|
+
criteria, assigned model tier, priority, and track; dependencies wired. The planner
|
|
39
|
+
writes these directly into beads -- there is no PLAN.md:
|
|
40
|
+
```
|
|
41
|
+
bd create "T1.1: <title>" -p 1 --parent <sprint-id> --assignee <track> \
|
|
42
|
+
--acceptance="<what must be true for this task to be done>" \
|
|
43
|
+
--metadata '{"model": "standard-tier"}' # -> task-id
|
|
44
|
+
bd create "T1.2: <title>" -p 2 --parent <sprint-id> --assignee <track> \
|
|
45
|
+
--acceptance="..." --metadata '{"model": "cheap-tier"}'
|
|
46
|
+
bd dep add <T1.2-id> <T1.1-id> # T1.2 blocked until T1.1 done
|
|
47
|
+
```
|
|
48
|
+
The acceptance criteria are the reviewer's contract; the model tier in metadata is the
|
|
49
|
+
doer's dispatch tier. Both live on the task -- nothing is written to a plan file.
|
|
50
|
+
|
|
51
|
+
**Doer dispatch** (doer) -- read the task, claim it, implement, close it:
|
|
52
|
+
```
|
|
53
|
+
bd show <task-id> # read description + acceptance + model tier metadata
|
|
54
|
+
bd update <task-id> --claim # claim (open -> in_progress, assigns self)
|
|
55
|
+
bd close <task-id> # when the work is complete
|
|
56
|
+
```
|
|
57
|
+
The ORCHESTRATOR finds ready work (`bd ready` -- tasks with no open blockers, scoped to
|
|
58
|
+
the sprint root) and hands the doer an explicit list of bead ids in the dispatch prompt.
|
|
59
|
+
The doer works exactly that list and never runs bare `bd ready` to discover work itself
|
|
60
|
+
(it would see other sprints' concurrent tasks with no way to tell which are its own --
|
|
61
|
+
see `agents/doer.md` Step 1). Never steal a task already `in_progress`.
|
|
62
|
+
|
|
63
|
+
**Reviewer returns CHANGES NEEDED** (orchestrator, after reading the reviewer's
|
|
64
|
+
structured output) -- the reviewer returns its verdict, human notes, and the
|
|
65
|
+
machine-readable `reopenIds` / `newTasks` arrays as structured output (see
|
|
66
|
+
`doer-reviewer-loop.md` reviewer template); it never writes feedback.md. The
|
|
67
|
+
orchestrator reads those fields and runs:
|
|
68
|
+
```
|
|
69
|
+
# for each id in reopenIds:
|
|
70
|
+
bd update <task-id> --status=open --notes="review: <finding from notes section>"
|
|
71
|
+
|
|
72
|
+
# for each entry in newTasks ({title, description, priority}):
|
|
73
|
+
bd create "<title>" -p <priority> --parent <sprint-id> --assignee <track> --description="<description>"
|
|
74
|
+
```
|
|
75
|
+
Reopened tasks return to `bd ready` as work for the next iteration. On APPROVED
|
|
76
|
+
neither command is needed -- tasks stay closed.
|
|
77
|
+
|
|
78
|
+
**At completion** -- close the sprint root, close the delivered source issues, persist the
|
|
79
|
+
state, link the PR:
|
|
80
|
+
```
|
|
81
|
+
bd close <sprint-id> <source-issue-id> [<source-issue-id> ...]
|
|
82
|
+
bd export -o <track-worktree>/.beads/issues.jsonl # refresh the tracked file from the db
|
|
83
|
+
bd note <sprint-id> "PR: <url>"
|
|
84
|
+
```
|
|
85
|
+
The source issues are the ready backlog items the sprint's requirement was drawn
|
|
86
|
+
from. Closing the sprint root alone leaves them open, so the backlog never reflects the
|
|
87
|
+
delivered work -- close them here too. With a db backend (dolt) `bd close` does NOT
|
|
88
|
+
update `issues.jsonl`; `bd export -o <file>` rewrites it (a bare `bd export` prints to
|
|
89
|
+
stdout). Commit the refreshed `.beads/issues.jsonl` on the branch so the closures are
|
|
90
|
+
durable and visible in the PR.
|
|
91
|
+
|
|
92
|
+
## Findings are never lost
|
|
93
|
+
|
|
94
|
+
A review finding against the reviewed task goes into `reopenIds` in the reviewer's
|
|
95
|
+
structured output; the orchestrator runs `bd update --status=open` so the doer picks it
|
|
96
|
+
up next loop. A finding outside the reviewed scope goes into `newTasks`; the
|
|
97
|
+
orchestrator creates it.
|
|
98
|
+
MEDIUM/LOW findings and any scope deferred mid-sprint become low-priority backlog
|
|
99
|
+
tasks. Every finding either gets fixed (`bd close`) or is explicitly carried as
|
|
100
|
+
backlog -- it is never dropped silently.
|
|
101
|
+
|
|
102
|
+
## Backlog
|
|
103
|
+
|
|
104
|
+
Deferred work lives as low-priority tasks under the sprint root, with enough detail to act
|
|
105
|
+
on later without re-investigation:
|
|
106
|
+
```
|
|
107
|
+
bd create "<headline>" -p 3 --parent <sprint-id> --description "Impact / Source / Detail / Cost of not doing it"
|
|
108
|
+
```
|
|
109
|
+
Manage it:
|
|
110
|
+
```
|
|
111
|
+
bd list --status open --pretty # review
|
|
112
|
+
bd update <id> -p 1 # promote
|
|
113
|
+
bd close <id> --reason "<why>" # retire as stale/superseded
|
|
114
|
+
bd dep add <id> <blocker-id> # gate behind another item
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## Status and recovery via beads
|
|
118
|
+
|
|
119
|
+
State re-derives entirely from beads + git -- no PLAN.md, no progress.json. To see
|
|
120
|
+
position at any time:
|
|
121
|
+
```
|
|
122
|
+
bd list --status=open # work still to do
|
|
123
|
+
bd list --status=in_progress # tasks claimed by an interrupted dispatch
|
|
124
|
+
bd ready # everything unblocked right now, across tracks
|
|
125
|
+
bd list --tree <sprint-id> # full sprint tree: tasks, status, assignee
|
|
126
|
+
bd show <task-id> # full context: description, acceptance, model tier metadata, notes
|
|
127
|
+
```
|
|
128
|
+
beads reflects claim/close actions, not on-disk completion -- always confirm against
|
|
129
|
+
`git log <base>..<branch>` and `git status` before acting. A task marked
|
|
130
|
+
`in_progress` with no matching commits is an orphaned claim from a crashed dispatch;
|
|
131
|
+
reset it with `bd update <id> --status=open`. See `sprint.md` Recovery.
|
|
132
|
+
|
|
133
|
+
## Rules
|
|
134
|
+
|
|
135
|
+
- **Title is plain text only** -- letters, digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -`.
|
|
136
|
+
No backticks, double quotes, `$`, or backslash: every `bd create ... "<title>"` /
|
|
137
|
+
`--title="..."` is shell-interpolated verbatim. Put any command/flag/filename or other
|
|
138
|
+
formatted detail in `--description` instead, which has no such restriction. Applies to
|
|
139
|
+
every role that creates beads directly (planner, integ-test-runner,
|
|
140
|
+
regression-test-runner, backlog-groomer), not just reviewer's `newTasks`.
|
|
141
|
+
- **Check before create** (sprint root and task) -- `bd search ... --status all`; reuse if
|
|
142
|
+
found, never duplicate.
|
|
143
|
+
- **Check before claim** -- dispatch only if the task is `open`.
|
|
144
|
+
- `bd close` is idempotent and safe to re-run.
|
|
145
|
+
- **Never re-run `bd init`** on a repo that already has `.beads/` -- it pulls from remote, recreates the Dolt database, and overwrites local issue state. If the database is missing, prefer `bd export` + restore over `bd init`.
|
|
146
|
+
- Premature close -> `bd reopen <id>`.
|
|
147
|
+
- Never use `bd edit` -- it opens an interactive editor and blocks. Use
|
|
148
|
+
`bd update --status/--assignee/--notes` inline.
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# Cost Quoting and Calibration
|
|
2
|
+
|
|
3
|
+
pm produces sprint cost quotes and post-sprint analyses using the same pure
|
|
4
|
+
JavaScript functions as the auto-sprint workflow. No arithmetic is done in prose --
|
|
5
|
+
all numbers come from deterministic JS. Node.js (v18+) is required; the orchestrator
|
|
6
|
+
checks for it at setup and warns the user if it is absent (cost features are skipped,
|
|
7
|
+
everything else runs normally).
|
|
8
|
+
|
|
9
|
+
## Source of the functions
|
|
10
|
+
|
|
11
|
+
`install.mjs` extracts the pure functions from `auto-sprint.js` at install time
|
|
12
|
+
and writes them as a self-contained CommonJS module to `cost.js` in the same
|
|
13
|
+
directory as this file (`<configDir>/skills/pm/cost.js`). It is refreshed
|
|
14
|
+
automatically on every install run -- no `--force` needed. On Claude Code, the
|
|
15
|
+
full `auto-sprint.js` is additionally copied to `~/.claude/workflows/auto-sprint.js`
|
|
16
|
+
so the `/auto-sprint` workflow works natively.
|
|
17
|
+
|
|
18
|
+
The orchestrator loads the functions with a plain `require()` using `__SKILL_DIR__`
|
|
19
|
+
(the absolute path to the skill directory, available in the orchestrator context):
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
node -e "
|
|
23
|
+
const { computeSprintQuote } = require('__SKILL_DIR__/cost.js');
|
|
24
|
+
const fs = require('fs');
|
|
25
|
+
const calib = JSON.parse(fs.readFileSync('sprint-logs/calibration.json', 'utf8'));
|
|
26
|
+
const ta = JSON.parse(process.env.TASK_ASSIGNMENTS);
|
|
27
|
+
process.stdout.write(JSON.stringify(computeSprintQuote(ta, calib)));
|
|
28
|
+
"
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Replace `__SKILL_DIR__` with the absolute path for your provider:
|
|
32
|
+
|
|
33
|
+
| Provider | `__SKILL_DIR__` |
|
|
34
|
+
|----------|----------------|
|
|
35
|
+
| Claude | `~/.claude/skills/pm` |
|
|
36
|
+
| Gemini | `~/.gemini/skills/pm` |
|
|
37
|
+
| AGY | `~/.gemini/antigravity-cli/skills/pm` |
|
|
38
|
+
| OpenCode | `~/.config/opencode/skills/pm` |
|
|
39
|
+
|
|
40
|
+
Pass inputs via `process.env` (for JSON blobs) or inline literals. Capture stdout
|
|
41
|
+
and parse as JSON.
|
|
42
|
+
|
|
43
|
+
## Calibration file
|
|
44
|
+
|
|
45
|
+
`sprint-logs/calibration.json` is the single source of truth for pricing, bucket
|
|
46
|
+
sizes, cycle assumptions, and historical averages. It is shared between auto-sprint
|
|
47
|
+
and pm -- they update the same file so historical data accumulates regardless of
|
|
48
|
+
which harness ran the sprint.
|
|
49
|
+
|
|
50
|
+
Keys in `model_prices_per_1m_output_tokens` and `role_models` are **tier names**
|
|
51
|
+
(`cheap`, `standard`, `premium`), not provider-specific model IDs. The mapping from
|
|
52
|
+
tier name to actual model ID lives exclusively in `TIER_TO_MODEL` inside
|
|
53
|
+
`auto-sprint.js` -- the single place to update when models change. This makes
|
|
54
|
+
`calibration.json` provider-agnostic and reusable across Claude, AGY, OpenCode, etc.
|
|
55
|
+
|
|
56
|
+
- **On first run** (file absent): the setup step bootstraps it from `DEFAULT_CALIBRATION`
|
|
57
|
+
inside `cost.js` (same object the workflow uses). Write it with:
|
|
58
|
+
```bash
|
|
59
|
+
node -e "
|
|
60
|
+
const { DEFAULT_CALIBRATION } = require('__SKILL_DIR__/cost.js');
|
|
61
|
+
const fs = require('fs');
|
|
62
|
+
fs.mkdirSync('sprint-logs', { recursive: true });
|
|
63
|
+
fs.writeFileSync('sprint-logs/calibration.json', JSON.stringify(DEFAULT_CALIBRATION, null, 2));
|
|
64
|
+
"
|
|
65
|
+
```
|
|
66
|
+
Replace `__SKILL_DIR__` with the absolute path to the pm skill directory.
|
|
67
|
+
- **On subsequent runs**: read it, deep-merge with `DEFAULT_CALIBRATION` (so new
|
|
68
|
+
fields added to the source always have a default), and use the result.
|
|
69
|
+
|
|
70
|
+
## Setup check (once per sprint)
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
node --version 2>/dev/null || echo MISSING
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
If `MISSING`: warn the user that cost quoting is unavailable, skip all cost steps,
|
|
77
|
+
continue the sprint normally. If Node.js is present, proceed with calibration load /
|
|
78
|
+
bootstrap as above.
|
|
79
|
+
|
|
80
|
+
## Phase 3 -- quote after plan APPROVED
|
|
81
|
+
|
|
82
|
+
After the plan-reviewer returns APPROVED with `taskAssignments` (id + bucket + model
|
|
83
|
+
per task -- see `doer-reviewer-loop.md` plan-reviewer template), the orchestrator:
|
|
84
|
+
|
|
85
|
+
1. Writes `taskAssignments` to a temp env var or file.
|
|
86
|
+
2. Runs `computeSprintQuote(taskAssignments, calibration)` via the node snippet above.
|
|
87
|
+
3. Logs the quote (opt/expected/pessimistic scenarios, calibration source).
|
|
88
|
+
4. Writes per-task cost estimates back to beads notes:
|
|
89
|
+
```bash
|
|
90
|
+
bd update <id> --notes="cost-estimate: bucket=<B> model=<M> doer_tokens=<N> reviewer_tokens=<N> output_usd=<N>"
|
|
91
|
+
```
|
|
92
|
+
Dispatch a single cheap-tier agent to run all `bd update` commands in one pass.
|
|
93
|
+
|
|
94
|
+
The `taskAssignments` array shape (matches the plan-reviewer role schema,
|
|
95
|
+
`agents/schemas/plan-reviewer-output.json`).
|
|
96
|
+
The `model` field is the **tier name** (`cheap`/`standard`/`premium`) read from the
|
|
97
|
+
task's assigned model tier in its beads metadata (`--metadata '{"model": "<tier>"}'`)
|
|
98
|
+
-- never a provider-specific model ID:
|
|
99
|
+
```json
|
|
100
|
+
[{ "id": "BD-10", "bucket": "M", "model": "standard" }, ...]
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## Harvest -- analysis and calibration update
|
|
104
|
+
|
|
105
|
+
At sprint close, after the harvester runs:
|
|
106
|
+
|
|
107
|
+
1. **Compute analysis**: run `computeSprintAnalysis(quote, logEntries, calibration,
|
|
108
|
+
actualCycles)`. `logEntries` is the sprint log JSONL (see Sprint log below) read
|
|
109
|
+
and parsed from `sprint-logs/<branch>-<startedAt>.jsonl`. If the log file does not
|
|
110
|
+
exist (pm ran without logging), pass `[]` for logEntries -- the analysis degrades
|
|
111
|
+
gracefully to estimates-only.
|
|
112
|
+
2. **Build summary**: run `buildSprintSummary(analysis, quote, calibration, opts)`
|
|
113
|
+
where `opts = { branch, goal, goalMet, cycleCount, tasksCompleted, tasksOpen,
|
|
114
|
+
startedAt }`. Write the returned `summaryText` to
|
|
115
|
+
`sprint-logs/<branch>-<startedAt>.analysis.md` and commit it.
|
|
116
|
+
3. **Update calibration**: run `computeUpdatedCalibration(calibration, analysis,
|
|
117
|
+
startedAt, taskAssignments, logEntries)` and write the result back to
|
|
118
|
+
`sprint-logs/calibration.json`. Commit it. This blends the actual token counts
|
|
119
|
+
into the historical averages so future quotes improve.
|
|
120
|
+
4. **Update fleet token memory**: Parse the `tuple_averages` from the updated
|
|
121
|
+
calibration object into a flat array: `const tokenEstimates = { averages: Object.values(updatedCalibration.historical?.tuple_averages || {}) }`. Then write it to the beads persistent memory:
|
|
122
|
+
`bd remember '<json_string>' --key token-estimates-json`
|
|
123
|
+
|
|
124
|
+
## Sprint log
|
|
125
|
+
|
|
126
|
+
pm appends one JSONL record per dispatch to `sprint-logs/<branch>-<startedAt>.jsonl`
|
|
127
|
+
so `computeSprintAnalysis` can compare estimates to actuals. Each record:
|
|
128
|
+
|
|
129
|
+
```json
|
|
130
|
+
{ "ts": "<ISO timestamp>", "cycle": 1, "phase": "Develop", "label": "doer-c1-i1",
|
|
131
|
+
"model": "<tier: cheap|standard|premium>", "context": "tasks BD-10, BD-11",
|
|
132
|
+
"outTokens": 1234, "costUsd": 0.0185 }
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
The orchestrator appends after each dispatch using a cheap-tier agent (same
|
|
136
|
+
`appendNewEntries` pattern as auto-sprint). The `label` format `<role>-c<N>-i<M>`
|
|
137
|
+
is required -- `computeSprintAnalysis` strips the suffix to recover the role name.
|
|
138
|
+
|
|
139
|
+
If the harness/CLI does not expose per-subagent token counts, record
|
|
140
|
+
`outTokens: 0` and `costUsd: 0` -- the analysis will show actuals as zero but the
|
|
141
|
+
estimate side still works and calibration is not corrupted.
|
|
142
|
+
|
|
143
|
+
## Node.js invocation pattern for all functions
|
|
144
|
+
|
|
145
|
+
All five functions follow the same extract-and-call pattern. Reference:
|
|
146
|
+
|
|
147
|
+
| Function | When | Inputs | Output |
|
|
148
|
+
|---|---|---|---|
|
|
149
|
+
| `computeSprintQuote` | After plan APPROVED | `taskAssignments`, `calibration` | quote object with scenarios |
|
|
150
|
+
| `computeSprintAnalysis` | Harvest | `quote`, `logEntries`, `calibration`, `actualCycles` | analysisText + byRole |
|
|
151
|
+
| `buildSprintSummary` | Harvest | `analysis`, `quote`, `calibration`, `opts` | summaryText markdown |
|
|
152
|
+
| `computeUpdatedCalibration` | Harvest | `calibration`, `analysis`, `startedAt`, `taskAssignments`, `logEntries` | updated calibration object |
|
|
153
|
+
| `DEFAULT_CALIBRATION` | Setup bootstrap | -- | JSON to write to calibration.json |
|
|
154
|
+
|
|
155
|
+
Never hardcode prices, bucket sizes, or cycle assumptions -- always read them from
|
|
156
|
+
`calibration.json` (or `DEFAULT_CALIBRATION` on first bootstrap). The file is the
|
|
157
|
+
single source of truth shared across all sprint harnesses.
|
|
@@ -0,0 +1,300 @@
|
|
|
1
|
+
# Doer-Reviewer Loop
|
|
2
|
+
|
|
3
|
+
The execute-phase loop for one track. Every dispatch is an inline subagent call (its
|
|
4
|
+
result returns in the same turn). Beads is the task store; the reviewer's verdict is
|
|
5
|
+
returned as structured output directly to the orchestrator. The orchestrator finds
|
|
6
|
+
ready work with `bd ready` and hands the doer explicit bead ids; the doer claims each
|
|
7
|
+
with `bd update --claim` and closes it with `bd close`. The
|
|
8
|
+
reviewer reads acceptance criteria with `bd show` and returns its verdict
|
|
9
|
+
(`verdict`/`notes`/`reopenIds`/`newTasks`) as structured output -- it never touches
|
|
10
|
+
beads. On CHANGES NEEDED the orchestrator reads that structured output and runs the
|
|
11
|
+
beads updates itself. There is no PLAN.md and no progress.json -- code is committed to
|
|
12
|
+
the branch; all task state lives in beads. (The plan loop that precedes this -- planner /
|
|
13
|
+
plan-reviewer -- is in `sprint.md`.)
|
|
14
|
+
|
|
15
|
+
## Pre-flight checks
|
|
16
|
+
|
|
17
|
+
### Before any dispatch
|
|
18
|
+
|
|
19
|
+
Verify the agent's worktree is on the correct branch with a clean working tree:
|
|
20
|
+
|
|
21
|
+
1. `git -C <worktree> status --porcelain` -- must be empty.
|
|
22
|
+
2. `git -C <worktree> branch --show-current` -- must match the track's branch.
|
|
23
|
+
|
|
24
|
+
Do not dispatch into a worktree on the wrong branch or with uncommitted changes.
|
|
25
|
+
|
|
26
|
+
### Before review dispatch (SHA matching)
|
|
27
|
+
|
|
28
|
+
Verify the reviewer sees the same state the doer pushed:
|
|
29
|
+
|
|
30
|
+
1. `git -C <reviewer-worktree> rev-parse HEAD` -- record the SHA.
|
|
31
|
+
2. Compare with the doer's last pushed HEAD on the track branch.
|
|
32
|
+
3. If SHA does not match: `git -C <reviewer-worktree> fetch origin &&
|
|
33
|
+
git -C <reviewer-worktree> reset --hard origin/<branch>`, then re-verify.
|
|
34
|
+
|
|
35
|
+
Never dispatch a reviewer against stale code -- SHA mismatch means the review
|
|
36
|
+
covers the wrong diff.
|
|
37
|
+
|
|
38
|
+
## The loop (the Develop phase of one cycle)
|
|
39
|
+
|
|
40
|
+
```
|
|
41
|
+
Plan APPROVED, beads tasks created (each with acceptance criteria + model tier in
|
|
42
|
+
metadata). goal priority = the sprint's exit threshold.
|
|
43
|
+
loop:
|
|
44
|
+
1. Find ready tasks: bd ready (tasks with no open blockers, in the sprint-root subtree).
|
|
45
|
+
If none AND bd list --status=open at the goal priority is empty AND the last
|
|
46
|
+
reviewer verdict was APPROVED -> Develop phase done; exit to Test (or Harvest
|
|
47
|
+
on the final cycle).
|
|
48
|
+
2. Group ready tasks into model streaks (consecutive tasks sharing a model tier,
|
|
49
|
+
in priority/dependency order). For each streak the doer, on dispatch:
|
|
50
|
+
- reads each task with `bd show <id>` (description, acceptance, model tier),
|
|
51
|
+
- claims it with `bd update <id> --claim`,
|
|
52
|
+
- implements the work and commits,
|
|
53
|
+
- closes it with `bd close <id>`.
|
|
54
|
+
The doer works its streak in order and STOPS at the VERIFY checkpoint.
|
|
55
|
+
3. On doer completion: assert the worktree is clean (`git status --porcelain`
|
|
56
|
+
empty); a dirty tree means the doer left uncommitted work -- send it back to
|
|
57
|
+
commit before any review. If a task is blocked, the doer leaves it open with a
|
|
58
|
+
blocker note -- handle the blocker (see Safeguards). The doer has already
|
|
59
|
+
closed the tasks it finished; the orchestrator does not touch beads here.
|
|
60
|
+
4. Dispatch ONE reviewer (inline) over all tasks worked this iteration. It reads
|
|
61
|
+
each task's acceptance criteria with `bd show <id>` and the diff. The reviewer
|
|
62
|
+
runs standard-tier, escalated to premium-tier if any streak this iteration ran
|
|
63
|
+
premium-tier. It returns its verdict as structured output only (see reviewer
|
|
64
|
+
template) -- it never writes a file. Read the returned verdict:
|
|
65
|
+
APPROVED -> tasks stay closed. `reopenIds` and `newTasks` absent or
|
|
66
|
+
empty -- no beads action needed.
|
|
67
|
+
CHANGES NEEDED -> the orchestrator parses `reopenIds` and `newTasks` from
|
|
68
|
+
the reviewer's structured output (see "Orchestrator reads
|
|
69
|
+
the reviewer's output" below) and runs the beads updates.
|
|
70
|
+
Dispatch the doer to fix.
|
|
71
|
+
-> back to step 1.
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
**Exit condition.** The Develop phase exits when `bd ready` returns nothing, no open
|
|
75
|
+
task at the goal priority remains, **and** the last reviewer verdict was APPROVED --
|
|
76
|
+
a single APPROVED is sufficient because beads tracks discrete tasks, not a
|
|
77
|
+
convergence streak. Any CHANGES NEEDED reopens tasks, so the loop continues until
|
|
78
|
+
they are cleared and a clean APPROVED lands on an empty ready queue. Never advance to
|
|
79
|
+
Test or Harvest with open tasks at the goal priority.
|
|
80
|
+
|
|
81
|
+
The orchestrator does nothing between a doer finishing and a reviewer starting except
|
|
82
|
+
read state from beads + git and dispatch. Never pause for the user mid-loop.
|
|
83
|
+
|
|
84
|
+
## Model per task
|
|
85
|
+
|
|
86
|
+
The planner assigned each task a model **tier** -- cheap-tier for mechanical tasks,
|
|
87
|
+
standard-tier for standard implementation, premium-tier for hard design -- and wrote it
|
|
88
|
+
into the task's beads metadata (`--metadata '{"model": "<tier>"}'`). Read it with `bd show <id>`
|
|
89
|
+
at dispatch time and dispatch the doer on that tier. An iteration may span tiers
|
|
90
|
+
across its ready tasks; run one doer dispatch per model streak (a run of consecutive
|
|
91
|
+
tasks sharing a tier), in priority/dependency order. An iteration with three tier
|
|
92
|
+
groups becomes up to three doer dispatches, each on its own tier. The dispatch whose
|
|
93
|
+
streak reaches the VERIFY task carries through it.
|
|
94
|
+
|
|
95
|
+
The reviewer runs standard-tier, escalated to premium-tier whenever any streak in the
|
|
96
|
+
iteration ran premium-tier -- review must never be weaker than the work it judges. Cheap
|
|
97
|
+
bounded state checks (`bd ready` queries, feedback commits, log appends) run
|
|
98
|
+
cheap-tier.
|
|
99
|
+
|
|
100
|
+
## Dispatch and wait inline
|
|
101
|
+
|
|
102
|
+
Dispatch each subagent and wait for its result in the same turn -- the dispatch
|
|
103
|
+
returns the agent's result to you inline. Run the loop sequentially this way: one
|
|
104
|
+
dispatch, its result, the next. NEVER end your turn while a dispatched agent still
|
|
105
|
+
owes you a result; in a headless run nothing re-invokes you, so ending the turn
|
|
106
|
+
parks the sprint. With multiple tracks, dispatch one per active track and poll them
|
|
107
|
+
to completion within the turn -- track A's reviewer can run while track B's doer
|
|
108
|
+
works -- but keep the turn alive until you have collected their results.
|
|
109
|
+
|
|
110
|
+
After each agent returns, the orchestrator's FIRST action is to read state from beads
|
|
111
|
+
and git (`bd ready`, `bd list --status=open`, `bd show <id>`, the reviewer's returned
|
|
112
|
+
structured output, `git log <base>..<branch>`); those are the source of truth for what
|
|
113
|
+
was dispatched and where it landed.
|
|
114
|
+
|
|
115
|
+
## Commit identity
|
|
116
|
+
|
|
117
|
+
So the branch history shows who did what, each role commits under its OWN git
|
|
118
|
+
identity rather than the ambient one. Pass it inline on every commit -- do not rely
|
|
119
|
+
on global config:
|
|
120
|
+
|
|
121
|
+
```
|
|
122
|
+
git -c user.name='pm-<role>' -c user.email='<role>@pm.local' commit -m "<msg>"
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Identities: `pm-planner`, `pm-plan-reviewer`, `pm-doer`,
|
|
126
|
+
`pm-reviewer`. The orchestrator's own git plumbing (requirements.md, design.md,
|
|
127
|
+
and the completion scaffolding drop) commits as `pm`. Each template below restates
|
|
128
|
+
its identity so the dispatched agent uses it.
|
|
129
|
+
|
|
130
|
+
## Per-role prompt templates
|
|
131
|
+
|
|
132
|
+
Everything the agent needs is in the prompt plus the committed files in its
|
|
133
|
+
worktree. Every prompt pins the worktree path. `<transport line>` is decided once
|
|
134
|
+
per repo (see `worktrees.md` Transport): remote present => "Push your commits." ;
|
|
135
|
+
local-only => "This is a local-only worktree -- commit every turn and skip pushing."
|
|
136
|
+
|
|
137
|
+
### planner
|
|
138
|
+
|
|
139
|
+
```
|
|
140
|
+
You are planning a track. Your worktree is <abs worktree path> on branch <branch>
|
|
141
|
+
(base <base>). cd there first; use absolute paths. Read requirements.md (and
|
|
142
|
+
design.md if present). Follow your planner instructions: explore, draft, front-load
|
|
143
|
+
foundations, self-critique, refine. Then write the plan into beads under sprint root
|
|
144
|
+
<sprint-id> -- do NOT write PLAN.md. For each task: bd create "<title>" -p <priority>
|
|
145
|
+
--parent <sprint-id> --assignee <track> --acceptance="<what must be true to be done>"
|
|
146
|
+
--metadata '{"model": "<tier>"}', where <tier> is cheap-tier for mechanical work, standard-tier
|
|
147
|
+
for standard implementation, premium-tier for hard design (pick from the tiers available
|
|
148
|
+
in this environment). Wire dependencies with bd dep add <task> <blocker>. Verify
|
|
149
|
+
with bd ready that leaf tasks (not features/sprint roots) are unblocked. <transport line>.
|
|
150
|
+
The worktree and branch already exist -- do not create or switch branches.
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### plan-reviewer
|
|
154
|
+
|
|
155
|
+
```
|
|
156
|
+
You are reviewing a plan. Your worktree is <abs worktree path> on branch <branch>.
|
|
157
|
+
cd there; use absolute paths. Read requirements.md and design.md (if present), then
|
|
158
|
+
inspect the beads DAG under sprint root <sprint-id>: bd graph --compact <sprint-id>, bd ready,
|
|
159
|
+
and bd show <id> on each task to read its acceptance criteria and model-tier metadata.
|
|
160
|
+
Follow your plan-reviewer instructions: check coverage, task size, acceptance
|
|
161
|
+
criteria, dependency direction, and model-tier assignment. Classify each task with a
|
|
162
|
+
complexity bucket (S = 1 file/narrow scope, M = 2-3 files/moderate logic,
|
|
163
|
+
L = 3+ files/non-trivial design) and read its assigned model tier from its metadata.
|
|
164
|
+
|
|
165
|
+
Return your structured output ONLY -- do not write a file:
|
|
166
|
+
- `verdict`: APPROVED or CHANGES_NEEDED (exact strings; the machine value is the
|
|
167
|
+
underscore form from agents/schemas/plan-reviewer-output.json)
|
|
168
|
+
- `notes`: specific findings with issue IDs and exact bd commands to fix any
|
|
169
|
+
dependency direction problems
|
|
170
|
+
- `taskAssignments`: one entry per task in JSON array form:
|
|
171
|
+
[{"id":"<beads-id>","bucket":"S|M|L","model":"<tier: cheap|standard|premium>"},...]
|
|
172
|
+
|
|
173
|
+
You never write feedback.md or mutate beads -- the orchestrator reads your structured
|
|
174
|
+
output. <transport line>.
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
The orchestrator reads `taskAssignments` from the plan-reviewer's structured output
|
|
178
|
+
after APPROVED to run `computeSprintQuote` (see `cost.md`). The array shape must match
|
|
179
|
+
exactly: `[{ "id": "<beads task id>", "bucket": "S|M|L", "model": "<tier: cheap|standard|premium>" }]`.
|
|
180
|
+
|
|
181
|
+
### doer
|
|
182
|
+
|
|
183
|
+
```
|
|
184
|
+
You are executing tasks. Your worktree is <abs worktree path> on branch <branch>
|
|
185
|
+
(base <base>). cd there; use absolute paths. Work ONLY task(s) <task scope>, in
|
|
186
|
+
order. For each task: bd show <id> to read its description and acceptance criteria;
|
|
187
|
+
bd update <id> --claim to claim it; implement the work; run fast tests; commit as
|
|
188
|
+
identity pm-doer (git -c user.name='pm-doer' -c user.email='doer@pm.local' commit);
|
|
189
|
+
then bd close <id>. Never close a type=feature or type=bug issue -- only type=task.
|
|
190
|
+
(Verify-set beads -- a parent of ANY issue_type whose children are all closed while
|
|
191
|
+
it is still open -- are closed later by integ-test-runner, not by you; this is not a
|
|
192
|
+
feature-only path.)
|
|
193
|
+
If your scope reaches the VERIFY checkpoint, run it -- build, linter, and full test
|
|
194
|
+
suite -- then stop. Otherwise stop after the last task in <task scope>. If a task is
|
|
195
|
+
blocked, leave it open, add a blocker note (bd update <id> --notes="blocked: ..."),
|
|
196
|
+
and stop. <transport line>. Do not start anything beyond <task scope>. The worktree
|
|
197
|
+
and branch already exist -- do not create branches.
|
|
198
|
+
[If fixing review findings:] the reopened task(s) carry review notes (bd show <id>).
|
|
199
|
+
Address every finding, commit, bd close <id> again, then stop for re-review.
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
### reviewer
|
|
203
|
+
|
|
204
|
+
```
|
|
205
|
+
You are reviewing code. Your worktree is <abs worktree path> on branch <branch>
|
|
206
|
+
(base <base>). cd there; use absolute paths. Review ONLY the tasks worked this
|
|
207
|
+
iteration: <task ids>. Run bd show <id> on each to read its acceptance criteria, and
|
|
208
|
+
git diff <base>...<branch> to see the changes. Read requirements.md and design.md (if
|
|
209
|
+
present). Run the build, linter, and full test suite. Read the prior review history
|
|
210
|
+
(git log <base>..<branch>) so you account for how earlier findings were addressed.
|
|
211
|
+
Judge each task against its acceptance criteria.
|
|
212
|
+
|
|
213
|
+
Do NOT run any bd commands. Return your structured output ONLY -- do not write a file:
|
|
214
|
+
|
|
215
|
+
verdict: "APPROVED" or "CHANGES_NEEDED"
|
|
216
|
+
notes: <human-readable notes: one finding per task, referencing the task ID and what
|
|
217
|
+
acceptance criterion was not met>
|
|
218
|
+
reopenIds: ["<id1>", "<id2>"]
|
|
219
|
+
newTasks: [{"title": "fix: <finding>", "description": "<detail>", "priority": "P2"}]
|
|
220
|
+
(newTasks entries use {title, description, priority-as-string} -- the exact shape in
|
|
221
|
+
agents/schemas/reviewer-output.json)
|
|
222
|
+
|
|
223
|
+
On APPROVED: reopenIds and newTasks are both empty arrays.
|
|
224
|
+
On CHANGES NEEDED: reopenIds lists every task that failed its acceptance criteria;
|
|
225
|
+
newTasks lists out-of-scope findings that need a new tracked task (may be []).
|
|
226
|
+
Both fields must be present and contain valid JSON arrays when verdict is CHANGES NEEDED.
|
|
227
|
+
|
|
228
|
+
You never write feedback.md or mutate beads -- the orchestrator reads your structured
|
|
229
|
+
output and applies the reopen/create transitions. <transport line>.
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
### Orchestrator reads the reviewer's output
|
|
233
|
+
|
|
234
|
+
After the reviewer returns, the orchestrator reads its structured output and runs all
|
|
235
|
+
beads updates itself -- the reviewer is a pure reader of beads:
|
|
236
|
+
|
|
237
|
+
1. Read the `verdict` field (`APPROVED` or `CHANGES_NEEDED`).
|
|
238
|
+
2. On CHANGES NEEDED:
|
|
239
|
+
- Read `reopenIds`. For each id: `bd update <id> --status=open --notes="<relevant finding from notes>"`.
|
|
240
|
+
Reopened tasks return to `bd ready` next iteration.
|
|
241
|
+
- Read `newTasks`. For each entry:
|
|
242
|
+
`bd create "<title>" -p <priority> --parent <sprint-id> --assignee <track> --description="<description>"`.
|
|
243
|
+
Empty array `[]` means no new tasks to create.
|
|
244
|
+
3. On APPROVED: no beads action needed.
|
|
245
|
+
|
|
246
|
+
## Continuity between dispatches
|
|
247
|
+
|
|
248
|
+
Each dispatch is a fresh subagent run; continuity comes from the files it reads.
|
|
249
|
+
Two ways to continue:
|
|
250
|
+
|
|
251
|
+
- **Default: fresh dispatch.** Dispatch a new agent with the right tags (tags: ['doer'] / tags: ['reviewer']); it
|
|
252
|
+
reconstructs context from beads (`bd ready`, `bd show <id>`) and `git log`. This is
|
|
253
|
+
robust and the right choice across phase boundaries and tag switches -- the agents
|
|
254
|
+
begin with a context-recovery `git log` and `bd` query.
|
|
255
|
+
- **Tight iteration: continue the same agent.** For a quick same-worktree, same-tag
|
|
256
|
+
turn -- e.g. the doer addressing review findings it just produced context for --
|
|
257
|
+
continue the SAME agent instance, which keeps its context. Use this within one
|
|
258
|
+
worktree and one tag; switch tags with a fresh dispatch.
|
|
259
|
+
|
|
260
|
+
## Resume rules
|
|
261
|
+
|
|
262
|
+
Resume is data-driven from beads task state, not manually reasoned. A fresh dispatch
|
|
263
|
+
re-derives everything from `bd ready` / `bd show <id>` and `git log`; resume keeps an
|
|
264
|
+
agent's in-session context for a tight follow-up turn.
|
|
265
|
+
|
|
266
|
+
### Doer dispatches
|
|
267
|
+
|
|
268
|
+
| Condition | resume |
|
|
269
|
+
|-----------|--------|
|
|
270
|
+
| Next ready task is the same kind of work the agent just finished | `true` (continue session) |
|
|
271
|
+
| Next ready task is a context switch (different feature/area) | `false` (fresh) |
|
|
272
|
+
| After reviewer CHANGES NEEDED -> same doer fixes the reopened task it just built | `true` |
|
|
273
|
+
| Role switch (doer -> reviewer) | `false` |
|
|
274
|
+
|
|
275
|
+
### All dispatches
|
|
276
|
+
|
|
277
|
+
| Dispatch | resume |
|
|
278
|
+
|----------|--------|
|
|
279
|
+
| Initial plan generation | `false` |
|
|
280
|
+
| Plan revision (any feedback iteration) | `true` |
|
|
281
|
+
| Initial review dispatch | `false` |
|
|
282
|
+
| Re-review after CHANGES NEEDED + doer fixes | `true` |
|
|
283
|
+
| Tag switch (tags: ['doer'] -> tags: ['reviewer'], or vice versa) | `false` |
|
|
284
|
+
| After stop_prompt cancellation (fleet mode) | `false` -- session state unreliable after kill; start fresh |
|
|
285
|
+
| After session timed out mid-grant (fleet mode) | `true` -- fleet auto-recovers but member restarts without prior context |
|
|
286
|
+
|
|
287
|
+
A tag switch always requires sending the new context (context file or inline
|
|
288
|
+
prompt). Never resume across a tag switch.
|
|
289
|
+
|
|
290
|
+
## Safeguards
|
|
291
|
+
|
|
292
|
+
| Safeguard | Trigger | Orchestrator action | Limit |
|
|
293
|
+
|----------------------|----------------------------------|------------------------------------------------------------------|------------------|
|
|
294
|
+
| Dispatch retry | Agent errors or returns nothing | Re-dispatch the same tag fresh; after 3 fails, pause + flag user | 3 per dispatch |
|
|
295
|
+
| Doer-reviewer cycle | Reviewer lists task in `reopenIds`; orchestrator reopens it | Doer fixes, re-review; if 3 cycles leave it open, pause + flag | 3 cycles/task |
|
|
296
|
+
| Zero progress | Two fresh dispatches, no commits | Escalate to a stronger model; still stuck after the strongest => flag | 2 per model |
|
|
297
|
+
| Blocked task | Doer left a task open with a `blocked:` note | Read the blocker note (bd show <id>); resolve if mechanical, else flag user | -- |
|
|
298
|
+
|
|
299
|
+
Escalate to the user only after a safeguard limit trips, on a genuine requirements
|
|
300
|
+
ambiguity, or on a risky/irreversible action. Otherwise keep the loop running.
|