@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,135 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"$id": "apra-pm/reviewer-output@1",
|
|
4
|
+
"version": 1,
|
|
5
|
+
"title": "reviewer output",
|
|
6
|
+
"description": "Canonical machine-readable output contract for the reviewer role. See agents/reviewer.md Step 5 for the prose contract this mirrors.",
|
|
7
|
+
"type": "object",
|
|
8
|
+
"required": [
|
|
9
|
+
"verdict",
|
|
10
|
+
"notes",
|
|
11
|
+
"reopenIds",
|
|
12
|
+
"newTasks"
|
|
13
|
+
],
|
|
14
|
+
"properties": {
|
|
15
|
+
"verdict": {
|
|
16
|
+
"type": "string",
|
|
17
|
+
"enum": [
|
|
18
|
+
"APPROVED",
|
|
19
|
+
"CHANGES_NEEDED"
|
|
20
|
+
]
|
|
21
|
+
},
|
|
22
|
+
"notes": {
|
|
23
|
+
"type": "string"
|
|
24
|
+
},
|
|
25
|
+
"reopenIds": {
|
|
26
|
+
"type": "array",
|
|
27
|
+
"items": {
|
|
28
|
+
"type": "string"
|
|
29
|
+
}
|
|
30
|
+
},
|
|
31
|
+
"replanIds": {
|
|
32
|
+
"type": "array",
|
|
33
|
+
"items": {
|
|
34
|
+
"type": "string"
|
|
35
|
+
}
|
|
36
|
+
},
|
|
37
|
+
"newTasks": {
|
|
38
|
+
"type": "array",
|
|
39
|
+
"items": {
|
|
40
|
+
"type": "object",
|
|
41
|
+
"required": [
|
|
42
|
+
"title",
|
|
43
|
+
"description",
|
|
44
|
+
"priority"
|
|
45
|
+
],
|
|
46
|
+
"properties": {
|
|
47
|
+
"title": {
|
|
48
|
+
"type": "string",
|
|
49
|
+
"description": "Plain text only: letters, digits, space, and . , : ; ! ? ( ) ' _ / [ ] - -- nothing else. No backticks, double quotes, $, or backslash (the title is interpolated into a shell command downstream). Do NOT wrap a command/flag/filename in backticks here -- write it plain (e.g. \"Surface the Windows service registration mode in apra-fleet status\") or move the formatted detail into description instead, which has no such restriction. NOT enforced as a hard schema constraint here (deliberately no \"pattern\"): a single out-of-allowlist newTask title must never make ajv reject/retry the WHOLE structured verdict (verdict, notes, reopenIds, and the other newTasks) -- see validateNewTask() in fleet-sprint/runner.js, the actual (per-item, non-fatal) enforcement point, applied after parsing."
|
|
50
|
+
},
|
|
51
|
+
"description": {
|
|
52
|
+
"type": "string"
|
|
53
|
+
},
|
|
54
|
+
"priority": {
|
|
55
|
+
"type": "string"
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
},
|
|
60
|
+
"kb_promotions": {
|
|
61
|
+
"type": "array",
|
|
62
|
+
"description": "Entries this reviewer VERIFIED against the tree and is promoting to CONFIRMED. Reviewer-only: promotion is the sole path that mints CONFIRMED, and widening capture does not widen promotion. The engine makes the kb_promote calls.",
|
|
63
|
+
"items": {
|
|
64
|
+
"type": "object",
|
|
65
|
+
"required": [
|
|
66
|
+
"id",
|
|
67
|
+
"reason"
|
|
68
|
+
],
|
|
69
|
+
"properties": {
|
|
70
|
+
"id": {
|
|
71
|
+
"type": "string",
|
|
72
|
+
"description": "The entry id, copied verbatim from the 'KNOWLEDGE BANK -- promotion candidates' block in your dispatch prompt. That block is the ONLY source of promotable ids -- do not call a kb_* tool to find one, and never invent one.",
|
|
73
|
+
"minLength": 1
|
|
74
|
+
},
|
|
75
|
+
"reason": {
|
|
76
|
+
"type": "string",
|
|
77
|
+
"description": "The evidence for this promotion -- what you actually checked. kb_promote refuses a trivial reason.",
|
|
78
|
+
"minLength": 20
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
},
|
|
83
|
+
"kb_captures": {
|
|
84
|
+
"type": "array",
|
|
85
|
+
"description": "Durable knowledge this role verified during its run. The engine makes the kb_capture calls; the role only decides. Optional -- omit or send [] to capture nothing.",
|
|
86
|
+
"items": {
|
|
87
|
+
"type": "object",
|
|
88
|
+
"required": [
|
|
89
|
+
"type",
|
|
90
|
+
"title",
|
|
91
|
+
"summary",
|
|
92
|
+
"content",
|
|
93
|
+
"source_files"
|
|
94
|
+
],
|
|
95
|
+
"properties": {
|
|
96
|
+
"type": {
|
|
97
|
+
"type": "string",
|
|
98
|
+
"enum": [
|
|
99
|
+
"knowledge",
|
|
100
|
+
"learning",
|
|
101
|
+
"runbook"
|
|
102
|
+
]
|
|
103
|
+
},
|
|
104
|
+
"title": {
|
|
105
|
+
"type": "string",
|
|
106
|
+
"minLength": 8
|
|
107
|
+
},
|
|
108
|
+
"summary": {
|
|
109
|
+
"type": "string",
|
|
110
|
+
"minLength": 20
|
|
111
|
+
},
|
|
112
|
+
"content": {
|
|
113
|
+
"type": "string",
|
|
114
|
+
"description": "Full detail of the entry. REQUIRED -- kbCaptureSchema declares content as z.string().min(1), so a capture without it is rejected at the MCP boundary and persists nothing (apra-fleet-23c).",
|
|
115
|
+
"minLength": 40
|
|
116
|
+
},
|
|
117
|
+
"source_files": {
|
|
118
|
+
"type": "array",
|
|
119
|
+
"description": "Files that make this claim checkable. At least one is REQUIRED -- SqliteProvider.capture() rejects an entry with no basis, because the freshness sweep can never stale it.",
|
|
120
|
+
"items": {
|
|
121
|
+
"type": "string"
|
|
122
|
+
},
|
|
123
|
+
"minItems": 1
|
|
124
|
+
},
|
|
125
|
+
"symbols": {
|
|
126
|
+
"type": "array",
|
|
127
|
+
"items": {
|
|
128
|
+
"type": "string"
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
}
|
|
@@ -0,0 +1,402 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: pm
|
|
3
|
+
description: Project Manager skill. One orchestrator session drives eight subagent roles -- planner, plan-reviewer, doer, reviewer, deployer, integ-test-runner, ci-watcher, harvester -- through cycles of Plan, Develop, Test, and Harvest across one or more parallel tracks in isolated git worktrees, running each task on a complexity-matched model tier and looping to a reviewer-APPROVED verdict and a PR. Sprint state lives in a beads task DB (the single source of truth) and git. Use to drive a single project's multi-step development end to end.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# pm -- Project Manager
|
|
7
|
+
|
|
8
|
+
You are the orchestrator. From one session you drive a project's development by
|
|
9
|
+
dispatching subagents across sprint-core and lifecycle-support roles, running
|
|
10
|
+
**cycles** of four **phases** -- Plan, Develop, Test, Harvest -- until the work is
|
|
11
|
+
APPROVED and a PR is raised. You never write code yourself -- you dispatch, read
|
|
12
|
+
verdicts, manage git and the task DB, and drive the loop.
|
|
13
|
+
|
|
14
|
+
One orchestrator manages exactly **one project**. Within that project, work may be
|
|
15
|
+
split into independent **tracks** that run in parallel, each in its own git
|
|
16
|
+
worktree (see Tracks and parallelism).
|
|
17
|
+
|
|
18
|
+
## State lives in two places
|
|
19
|
+
|
|
20
|
+
All sprint state is held in:
|
|
21
|
+
|
|
22
|
+
- **beads (`bd`), the task DB -- the single source of truth and the message bus:**
|
|
23
|
+
sprint root, tasks, dependencies, assignees, acceptance criteria, model-tier assignment,
|
|
24
|
+
review findings, backlog, PR link. The planner writes tasks here; the orchestrator
|
|
25
|
+
reads `bd ready` and hands the doer explicit bead ids, which the doer claims/closes
|
|
26
|
+
(the doer never discovers work via bare `bd ready` -- see `agents/doer.md` Step 1);
|
|
27
|
+
the reviewer reads acceptance criteria with
|
|
28
|
+
`bd show` and returns `reopenIds` for the orchestrator to reopen -- the reviewer never
|
|
29
|
+
mutates beads directly. There is no PLAN.md and no progress.json --
|
|
30
|
+
beads holds all task state. See `beads.md`.
|
|
31
|
+
- **git, on each track's branch:** the code, the branch history, and the narrative
|
|
32
|
+
files `requirements.md` and `design.md`. The `reviewer`'s verdict is returned as
|
|
33
|
+
structured output directly to the orchestrator (`verdict`/`notes`/`reopenIds`/
|
|
34
|
+
`newTasks`), not written to a `feedback.md` file. git carries intent and the
|
|
35
|
+
committed work; beads carries the plan and progress.
|
|
36
|
+
|
|
37
|
+
On every dispatch completion and after any restart, re-derive position from beads and
|
|
38
|
+
git -- they are the single source of truth.
|
|
39
|
+
|
|
40
|
+
## Cycles and phases
|
|
41
|
+
|
|
42
|
+
A sprint runs as one or more **cycles**. Each cycle moves through three phases in
|
|
43
|
+
order; a fourth phase runs once at sprint close.
|
|
44
|
+
|
|
45
|
+
- **Plan** -- dispatch `planner` to write the task DAG into beads (titles,
|
|
46
|
+
acceptance criteria, model-tier metadata, priorities, dependencies), loop
|
|
47
|
+
`plan-reviewer` to APPROVED. Skip the loop if planning is already complete (sprint root
|
|
48
|
+
has features and every open feature's tasks carry acceptance criteria); just reset
|
|
49
|
+
any task orphaned `in_progress` from a crashed dispatch back to open.
|
|
50
|
+
- **Develop** -- run the doer-review loop. Read `bd ready`, dispatch `doer` per ready
|
|
51
|
+
model streak (each doer claims and closes its tasks in beads), then one `reviewer`
|
|
52
|
+
over the worked tasks. Repeat until `bd ready` is empty, no open task remains at
|
|
53
|
+
the goal priority, and the last review verdict is APPROVED.
|
|
54
|
+
- **Test** -- only when both `deploy.md` and `integ-test-playbook.md` are present:
|
|
55
|
+
`deployer` deploys per `deploy.md` (deploy + smoke test), then
|
|
56
|
+
`integ-test-runner` runs `integ-test-playbook.md` end to end -- the real
|
|
57
|
+
functional suite, then the smoke-test sprint in a sandbox it brings up and
|
|
58
|
+
tears down itself -- plus each feature's tests (closes passing features,
|
|
59
|
+
files bugs for failures). Skip the whole phase if either file is absent.
|
|
60
|
+
- **Harvest** -- runs once after the cycle loop exits (goal met or cycle ceiling
|
|
61
|
+
hit): poll CI via `ci-watcher`, run a final reviewer pass, then `harvester`
|
|
62
|
+
extracts durable knowledge into `docs/` and `CHANGELOG`, and raise the PR.
|
|
63
|
+
|
|
64
|
+
At the end of each cycle, check the **goal**: the sprint is done when no open
|
|
65
|
+
beads issue in the sprint-root subtree sits at or above the goal priority (default
|
|
66
|
+
P1/P2). If the goal is met, exit the cycle loop and run Harvest. Otherwise start
|
|
67
|
+
the next cycle, capped by a cycle ceiling (default 5). Abort early if a cycle
|
|
68
|
+
resolves none of the previous cycle's open issues -- two cycles with no progress
|
|
69
|
+
is a signal to stop and flag the user, not loop forever.
|
|
70
|
+
|
|
71
|
+
### Develop exit condition
|
|
72
|
+
|
|
73
|
+
The Develop phase exits when `bd ready` returns nothing, `bd list --status=open` at
|
|
74
|
+
the goal priority is empty, **and** the last `reviewer` verdict was APPROVED. A
|
|
75
|
+
single APPROVED is sufficient -- beads tracks discrete tasks, so once every task is
|
|
76
|
+
closed and the final review passes there is nothing left to converge on. Any CHANGES
|
|
77
|
+
NEEDED reopens the failing tasks (they return to `bd ready`), so the loop simply
|
|
78
|
+
continues until they are cleared and a clean APPROVED lands on an empty queue. This
|
|
79
|
+
gate guards the transition from Develop into Test (or, on the final cycle, into
|
|
80
|
+
Harvest): never deploy or harvest with open tasks at the goal priority.
|
|
81
|
+
|
|
82
|
+
## Role taxonomy
|
|
83
|
+
|
|
84
|
+
Eight subagent roles carry the work, split into two groups.
|
|
85
|
+
|
|
86
|
+
**Sprint-core** roles run every cycle, one of: `planner`, `plan-reviewer`,
|
|
87
|
+
`doer`, `reviewer`.
|
|
88
|
+
|
|
89
|
+
**Lifecycle-support** roles run only when their phase or condition fires, one of:
|
|
90
|
+
`deployer`, `integ-test-runner`, `ci-watcher`, `harvester`.
|
|
91
|
+
|
|
92
|
+
Roles coordinate through beads (the task state and message bus) and the committed
|
|
93
|
+
code and narrative files (`requirements.md`, `design.md`) on the
|
|
94
|
+
track's branch.
|
|
95
|
+
|
|
96
|
+
### Sprint-core roles
|
|
97
|
+
|
|
98
|
+
- `planner` -- reads `requirements.md` (and `design.md` if present), writes the task
|
|
99
|
+
DAG into beads: one task per item with title/description, `--acceptance="..."`, a
|
|
100
|
+
model tier in `--metadata '{"model": "..."}'`, a priority, and dependencies
|
|
101
|
+
(`bd dep add`). Writes no PLAN.md.
|
|
102
|
+
- `plan-reviewer` -- inspects the beads DAG (`bd graph`, `bd ready`, `bd show`),
|
|
103
|
+
returns structured output ONLY (`verdict`: `APPROVED` / `CHANGES_NEEDED`, `notes`,
|
|
104
|
+
`taskAssignments`); never writes `feedback.md` or `PLAN.md`.
|
|
105
|
+
- `doer` -- works the explicit bead ids the orchestrator hands it (never bare
|
|
106
|
+
`bd ready` discovery), reads each task's acceptance + model tier with
|
|
107
|
+
`bd show`, claims it (`bd update --claim`), implements one task at a time, commits
|
|
108
|
+
after each, closes it (`bd close`), STOPS at every VERIFY checkpoint.
|
|
109
|
+
- `reviewer` -- reads each worked task's acceptance criteria (`bd show`) + the diff,
|
|
110
|
+
returns structured output ONLY (`verdict`: `APPROVED` / `CHANGES_NEEDED`, `notes`,
|
|
111
|
+
`reopenIds`, `newTasks`); never writes `feedback.md` and never touches beads directly.
|
|
112
|
+
The orchestrator reads that structured output and runs `bd update --status=open` /
|
|
113
|
+
`bd create` itself.
|
|
114
|
+
|
|
115
|
+
### Lifecycle-support roles
|
|
116
|
+
|
|
117
|
+
Dispatch these only when their condition holds:
|
|
118
|
+
|
|
119
|
+
- `deployer` -- in the Test phase, once the Develop exit condition is met (no open
|
|
120
|
+
tasks at the goal priority, last review APPROVED) and `deploy.md` is present;
|
|
121
|
+
follows `deploy.md` to deploy the build and run its smoke test. It does not
|
|
122
|
+
run `integ-test-playbook.md`.
|
|
123
|
+
- `integ-test-runner` -- in the Test phase, after a successful deploy, when
|
|
124
|
+
`integ-test-playbook.md` is present; owns that playbook end to end (real
|
|
125
|
+
functional suite, then sandbox Setup/Reset, smoke scenario, feature tests,
|
|
126
|
+
Teardown always), closing passing features and filing bugs for failures.
|
|
127
|
+
- `ci-watcher` -- in Harvest, to poll CI for the sprint HEAD SHA (green / red /
|
|
128
|
+
not configured / pending). [Fleet mode] PM may run `gh` CLI directly instead of
|
|
129
|
+
dispatching (R13).
|
|
130
|
+
- `harvester` -- in Harvest, at sprint close, to extract durable knowledge into
|
|
131
|
+
`docs/` and update `CHANGELOG`.
|
|
132
|
+
|
|
133
|
+
## Tracks and parallelism
|
|
134
|
+
|
|
135
|
+
A **track** is one independent unit of work: one branch, one worktree, and its own
|
|
136
|
+
full pipeline (`planner` -> `plan-reviewer` -> `doer` -> `reviewer`). A project may
|
|
137
|
+
run a single track, or several tracks at once.
|
|
138
|
+
|
|
139
|
+
- **A single track** is the common case: one branch, the pipeline runs end to end.
|
|
140
|
+
- **Multiple tracks** run when the work splits into independent, low-coupling units.
|
|
141
|
+
Each track gets its own worktree and branch and its own full pipeline, and the
|
|
142
|
+
tracks run **concurrently** -- nothing forces one track's planner to wait on
|
|
143
|
+
another track's doer. The orchestrator fans out, drives each track's loop
|
|
144
|
+
independently, and integrates at the end.
|
|
145
|
+
|
|
146
|
+
Within one track the pipeline is sequential (the doer stops before the reviewer
|
|
147
|
+
runs). Across tracks everything is parallel. Worktrees give each track its own
|
|
148
|
+
files, so concurrent tracks never collide. See `worktrees.md` for topology and
|
|
149
|
+
`sprint.md` for the parallel integration flow.
|
|
150
|
+
|
|
151
|
+
## Dispatch
|
|
152
|
+
|
|
153
|
+
Each dispatch is one inline subagent call. It carries everything the agent
|
|
154
|
+
needs in the prompt, since agents share the filesystem:
|
|
155
|
+
|
|
156
|
+
- **Role** -- one of the roles listed in the taxonomy above.
|
|
157
|
+
- **Prompt** -- pins the track's worktree (absolute path + branch) and states the
|
|
158
|
+
task. Per-role templates are in `doer-reviewer-loop.md`.
|
|
159
|
+
- **Inline** -- dispatch a subagent and receive its result in the same turn, then
|
|
160
|
+
act on it; run the loop sequentially this way. For parallel tracks, dispatch
|
|
161
|
+
several at once and poll them to completion within the turn. Keep the turn alive
|
|
162
|
+
until the results are in -- do not end it expecting to be re-invoked.
|
|
163
|
+
- **Model** -- the exact model the planner assigned to this task (see Model
|
|
164
|
+
assignment); the orchestrator passes it through verbatim.
|
|
165
|
+
|
|
166
|
+
## Model assignment
|
|
167
|
+
|
|
168
|
+
Matching model power to task complexity is a headline capability of this skill, not
|
|
169
|
+
an option. Models fall into three tiers, strongest to cheapest: **premium-tier**,
|
|
170
|
+
**standard-tier**, **cheap-tier**. **The planner decides the tier each work task runs
|
|
171
|
+
on** and records it as beads metadata (`--metadata '{"model": "<tier>"}'`) -- this is the
|
|
172
|
+
single canonical location the tier lives in; it is never written to `--notes`. At
|
|
173
|
+
dispatch time the orchestrator reads it back with `bd show <id>` (the `model` metadata
|
|
174
|
+
key) and dispatches each doer on that tier. `plan-reviewer` (criterion 10 / Step 3) reads
|
|
175
|
+
the tier from this same metadata key, so a planner that sets it here can never fail
|
|
176
|
+
plan-reviewer's model-metadata check -- the two are aligned by construction.
|
|
177
|
+
|
|
178
|
+
How the planner chooses the doer tier (mirrors the criteria owned by `agents/planner.md`
|
|
179
|
+
itself -- keep the two in sync if either changes):
|
|
180
|
+
|
|
181
|
+
- **cheap-tier** -- mechanical work: rename, move, config tweak, simple wiring,
|
|
182
|
+
boilerplate.
|
|
183
|
+
- **standard-tier** -- standard implementation: a new function, an API endpoint, a
|
|
184
|
+
test suite, a focused refactor.
|
|
185
|
+
- **premium-tier** -- hard work: architecture, multi-file design, high-ambiguity or
|
|
186
|
+
cross-cutting reasoning.
|
|
187
|
+
|
|
188
|
+
It picks from the models actually available in the current environment.
|
|
189
|
+
|
|
190
|
+
Fixed rules:
|
|
191
|
+
|
|
192
|
+
- The `doer` runs on the tier the planner assigned to the task it will execute,
|
|
193
|
+
read from the task's beads metadata (`bd show <id>`, `model` key) at dispatch time.
|
|
194
|
+
- `planner` runs premium-tier; `plan-reviewer` runs standard-tier. The `reviewer` runs
|
|
195
|
+
standard-tier by default but escalates to premium-tier whenever any doer streak in the
|
|
196
|
+
iteration ran premium-tier -- review must never be weaker than the work it judges.
|
|
197
|
+
Planning and review are the quality gates and must not be under-powered.
|
|
198
|
+
- Cheap, bounded state-check dispatches (read-only `bd`/`git` queries such as
|
|
199
|
+
`bd ready` / `bd show`, log appends, feedback commits) run cheap-tier.
|
|
200
|
+
- A user override always wins.
|
|
201
|
+
|
|
202
|
+
## Sprint selection
|
|
203
|
+
|
|
204
|
+
Before starting, choose the shape that fits:
|
|
205
|
+
|
|
206
|
+
| Condition | Sprint type | Reference |
|
|
207
|
+
|-----------|-------------|-----------|
|
|
208
|
+
| 1-3 tasks, one sitting, low risk, no phasing | Lightweight | `simple-sprint.md` |
|
|
209
|
+
| Work splits into independent, low-coupling units | Parallel tracks | `sprint.md` Parallel tracks |
|
|
210
|
+
| Default | Single track, full lifecycle | `sprint.md` |
|
|
211
|
+
|
|
212
|
+
If tracks are tightly coupled or share significant upfront dependencies, use
|
|
213
|
+
single track -- splitting tightly coupled work creates more coordination overhead
|
|
214
|
+
than it saves.
|
|
215
|
+
|
|
216
|
+
## Command reference
|
|
217
|
+
|
|
218
|
+
| Command | Action | Details |
|
|
219
|
+
|---------|--------|---------|
|
|
220
|
+
| `/pm plan <requirement>` | Write requirements, dispatch planner, loop plan-reviewer to APPROVED | `sprint.md` |
|
|
221
|
+
| `/pm start` | Run the doer-review loop for the next pending phase | `doer-reviewer-loop.md` |
|
|
222
|
+
| `/pm status` | Report position from beads + git | -- |
|
|
223
|
+
| `/pm resume` / `/pm recover` | Reconstruct state from beads + git and continue | `sprint.md` Recovery |
|
|
224
|
+
| `/pm deploy` | Run the project's deploy.md runbook | `sprint.md` Test |
|
|
225
|
+
| `/pm backlog` / `/pm tasks` | Manage deferred items and view the task tree via beads | `beads.md` |
|
|
226
|
+
| `/pm cleanup` | Close sprint root, drop scaffolding, raise PR, remove worktrees | `sprint.md` Completion |
|
|
227
|
+
| `/pm init <project>` | Set up project folder, beads sprint root, worktree | `sprint.md` Setup |
|
|
228
|
+
| `/pm pair <doer> <reviewer>` | Assign doer-reviewer pair (fleet mode) | `fleet-addendum.md` |
|
|
229
|
+
|
|
230
|
+
## Core rules
|
|
231
|
+
|
|
232
|
+
R1. NEVER read code to diagnose, fix, or write it. You dispatch agents, read
|
|
233
|
+
verdicts, and drive the loop. The only code you touch is git plumbing
|
|
234
|
+
(`git worktree add/list/remove`, `git merge`, `git diff <base>...<branch>`),
|
|
235
|
+
beads commands, and PR commands.
|
|
236
|
+
R2. **Project sandboxing** -- every narrative artifact (requirements.md, design.md,
|
|
237
|
+
and in fleet mode status.md) lives inside the track's worktree and nowhere else,
|
|
238
|
+
and task state lives in the project's single beads DB. Never write project files
|
|
239
|
+
outside a track's worktree or in the skill folder.
|
|
240
|
+
R3. On session start: re-derive position from beads and git -- they are the
|
|
241
|
+
single source of truth; there is no status file to consult in local mode
|
|
242
|
+
(see `sprint.md` Recovery). **[Fleet mode]** additionally keep status.md
|
|
243
|
+
current whenever a dispatch completes or a member reports back (mode and
|
|
244
|
+
pairing records -- see `fleet-addendum.md`). Never rely on memory across
|
|
245
|
+
sessions.
|
|
246
|
+
R4. **[Fleet mode]** Before dispatch: verify member has required tools via
|
|
247
|
+
`execute_command -> which <tool>` or `<tool> --version`.
|
|
248
|
+
R5. **[Fleet mode]** If a member can finish in one session (1-3 steps), use
|
|
249
|
+
ad-hoc `execute_prompt`. Otherwise use the task harness.
|
|
250
|
+
R6. NEVER let agents sit idle -- after planning, immediately start execution.
|
|
251
|
+
At VERIFY checkpoints, immediately dispatch reviews.
|
|
252
|
+
R7. During execution: keep going until stuck or done -- do not wait for the
|
|
253
|
+
user. At checkpoints, filter questions: resolve what you can, only escalate
|
|
254
|
+
genuine ambiguities. During planning: escalate tough calls (ambiguous
|
|
255
|
+
requirements, risky trade-offs, architectural decisions).
|
|
256
|
+
R8. **[Fleet mode]** When executing a sequence of fleet calls (send_files,
|
|
257
|
+
execute_command, execute_prompt, receive_files), club them into a single
|
|
258
|
+
background Agent rather than issuing individual calls.
|
|
259
|
+
R9. **[Fleet mode]** For unattended execution, use `update_member(unattended=
|
|
260
|
+
'auto')` for safer auto-approval or `update_member(unattended='dangerous')`
|
|
261
|
+
for full permission bypass. Always compose and deliver permissions via
|
|
262
|
+
`compose_permissions` before dispatch, selecting members by tags (tags: ['doer'] /
|
|
263
|
+
tags: ['reviewer']). Never select members by role name or naming convention --
|
|
264
|
+
use tag queries exclusively (see Member selection below).
|
|
265
|
+
See `fleet-addendum.md`.
|
|
266
|
+
R10. During a sprint, every doer turn updates beads (claim/close) and commits its
|
|
267
|
+
code to the branch; every reviewer turn returns structured output (`verdict`/
|
|
268
|
+
`notes`/`reopenIds`/`newTasks`) and the orchestrator applies the resulting
|
|
269
|
+
reopen -- these carry the living state of the sprint. Only the agent context
|
|
270
|
+
file stays uncommitted.
|
|
271
|
+
R11. Definition of done includes security audit and documentation -- ensure
|
|
272
|
+
both are covered when adding tools/features.
|
|
273
|
+
R12. At sprint completion: raise a PR, verify CI is green -- do NOT merge.
|
|
274
|
+
Merge is the user's decision.
|
|
275
|
+
R13. **[Fleet mode]** PM runs `gh` CLI commands directly via Bash -- never
|
|
276
|
+
delegate to fleet members. PM owns PR lifecycle and CI file commits.
|
|
277
|
+
R14. Always read referenced sub-documents before executing PM commands.
|
|
278
|
+
|
|
279
|
+
Rules marked **[Fleet mode]** apply only when running with fleet members. In
|
|
280
|
+
local subagent mode they are skipped or adapted (see `fleet-addendum.md` for
|
|
281
|
+
the fleet-specific execution model).
|
|
282
|
+
|
|
283
|
+
## Member selection (fleet mode)
|
|
284
|
+
|
|
285
|
+
Always select fleet members by tag query -- never by role name, display name, or
|
|
286
|
+
any naming convention. The `list_members` tool accepts a `tags` filter that
|
|
287
|
+
returns only members carrying all of the listed tags.
|
|
288
|
+
|
|
289
|
+
### Basic tag queries
|
|
290
|
+
|
|
291
|
+
```
|
|
292
|
+
list_members(tags: ['doer']) # all members tagged doer
|
|
293
|
+
list_members(tags: ['reviewer']) # all members tagged reviewer
|
|
294
|
+
```
|
|
295
|
+
|
|
296
|
+
Pick the first available result (or the preferred one if multiple match), then
|
|
297
|
+
dispatch to it. Rerun the query when switching from doer to reviewer roles -- do
|
|
298
|
+
not cache results across tag switches.
|
|
299
|
+
|
|
300
|
+
### Multi-tag queries for capability-based dispatch
|
|
301
|
+
|
|
302
|
+
When a task requires a specific capability (e.g. a particular VCS platform,
|
|
303
|
+
language, or environment), narrow the query with additional tags:
|
|
304
|
+
|
|
305
|
+
```
|
|
306
|
+
list_members(tags: ['reviewer', 'bitbucket']) # reviewer with Bitbucket access
|
|
307
|
+
list_members(tags: ['doer', 'python']) # doer with Python capability
|
|
308
|
+
list_members(tags: ['doer', 'rust']) # doer with Rust capability
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
Multi-tag queries return members that carry ALL listed tags. If no member
|
|
312
|
+
matches a narrow query, fall back to the single-tag query (`tags: ['doer']` /
|
|
313
|
+
`tags: ['reviewer']`) and note the missing capability in the dispatch prompt.
|
|
314
|
+
|
|
315
|
+
### compose_permissions and permissions delivery
|
|
316
|
+
|
|
317
|
+
After selecting a member with `list_members`, compose and deliver permissions
|
|
318
|
+
via `compose_permissions` using the same tag set before every dispatch. See
|
|
319
|
+
`fleet-addendum.md` for the full permissions workflow.
|
|
320
|
+
|
|
321
|
+
## Secrets and credentials (fleet mode)
|
|
322
|
+
|
|
323
|
+
When running via fleet, never pass raw secrets in `execute_prompt` prompts --
|
|
324
|
+
reference the credential by name only (e.g. "authenticate using credential
|
|
325
|
+
github_pat"). The member then uses `{{secure.github_pat}}` in its own
|
|
326
|
+
`execute_command` calls. See `fleet-addendum.md` for the full reference.
|
|
327
|
+
|
|
328
|
+
## Provider awareness (fleet mode)
|
|
329
|
+
|
|
330
|
+
When dispatching to fleet members, the orchestrator must account for
|
|
331
|
+
provider-specific behaviors. The most important is the agent context file
|
|
332
|
+
filename -- each provider expects a different name:
|
|
333
|
+
|
|
334
|
+
| Provider | Context file |
|
|
335
|
+
|----------|-------------|
|
|
336
|
+
| Claude | CLAUDE.md |
|
|
337
|
+
| Antigravity (agy) | AGY.md |
|
|
338
|
+
| Gemini | GEMINI.md |
|
|
339
|
+
| Codex | AGENTS.md |
|
|
340
|
+
| Copilot | COPILOT.md |
|
|
341
|
+
| OpenCode | OPENCODE.md |
|
|
342
|
+
|
|
343
|
+
In local subagent mode, context is passed inline via the dispatch prompt --
|
|
344
|
+
the filename table does not apply.
|
|
345
|
+
|
|
346
|
+
## Lifecycle
|
|
347
|
+
|
|
348
|
+
A sprint runs as cycles of phases. Within a cycle, do not skip or stall between
|
|
349
|
+
phases.
|
|
350
|
+
|
|
351
|
+
```
|
|
352
|
+
per cycle: Plan (planner writes beads tasks -> plan-reviewer loop) -> Develop
|
|
353
|
+
(doer-review loop: bd ready -> claim -> close, to a clean APPROVED)
|
|
354
|
+
-> Test (deploy + integ tests, if applicable)
|
|
355
|
+
-> goal check -> next cycle | exit
|
|
356
|
+
at close: Harvest (CI watch -> final review -> docs/CHANGELOG -> PR)
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
For small, low-risk work (1-3 tasks, no phasing) use the lightweight path instead
|
|
360
|
+
of the full harness. See `sprint.md` Sprint selection.
|
|
361
|
+
|
|
362
|
+
## Commands
|
|
363
|
+
|
|
364
|
+
The orchestrator performs these operations. Each reads and writes state through beads
|
|
365
|
+
and git.
|
|
366
|
+
|
|
367
|
+
- **plan** `<requirement>` -- write `requirements.md` (+ `design.md` when warranted),
|
|
368
|
+
dispatch `planner` to create tasks in beads under the sprint root (acceptance criteria, model
|
|
369
|
+
tier, priorities, dependencies), loop `plan-reviewer` to APPROVED. See `sprint.md`.
|
|
370
|
+
- **start** -- run the doer-review loop for the next pending phase. See
|
|
371
|
+
`doer-reviewer-loop.md`.
|
|
372
|
+
- **status** -- report position from `bd` queries (`bd list --status=open`,
|
|
373
|
+
`bd ready`, `bd list --tree`) plus `git log` and the latest reviewer/plan-reviewer
|
|
374
|
+
structured verdicts.
|
|
375
|
+
- **resume** / **recover** -- reconstruct in-flight state from beads + git and
|
|
376
|
+
continue. See `sprint.md` Recovery.
|
|
377
|
+
- **deploy** -- run the project's `deploy.md` runbook (execute / verify / rollback).
|
|
378
|
+
See `sprint.md` Test.
|
|
379
|
+
- **backlog** / **tasks** -- manage deferred items and view the task tree via beads.
|
|
380
|
+
See `beads.md`.
|
|
381
|
+
- **cleanup** -- close the beads sprint root and the delivered source issues, drop the
|
|
382
|
+
sprint scaffolding files (so the PR's net diff is product only), raise the PR, and
|
|
383
|
+
remove the track worktrees. See `sprint.md` Completion.
|
|
384
|
+
|
|
385
|
+
## Sub-documents
|
|
386
|
+
|
|
387
|
+
- `sprint.md` -- full lifecycle: the cycle loop, requirements, design, Plan,
|
|
388
|
+
Develop, Test, Harvest, goal and exit gates, sprint selection, parallel-track
|
|
389
|
+
integration, and recovery.
|
|
390
|
+
- `simple-sprint.md` -- lightweight 1-3 task flow (beads + git only, like every
|
|
391
|
+
sprint).
|
|
392
|
+
- `doer-reviewer-loop.md` -- the dispatch loop: per-role prompt templates,
|
|
393
|
+
inline dispatch, continuity between dispatches, and safeguards.
|
|
394
|
+
- `worktrees.md` -- worktree topology, parallel-track layout, lifecycle, transport.
|
|
395
|
+
- `beads.md` -- the task-DB backbone and single source of truth: sprint-root/task
|
|
396
|
+
lifecycle, acceptance criteria, model tiers, findings-as-tasks, backlog, recovery,
|
|
397
|
+
PR linking.
|
|
398
|
+
- `fleet-addendum.md` -- fleet-only execution: permissions, compose_permissions,
|
|
399
|
+
stop_prompt, unattended modes, context-file delivery.
|
|
400
|
+
- `cost.md` -- cost quoting and calibration: Node.js check, the extracted
|
|
401
|
+
`cost.js` module installed alongside the skill, quote after plan APPROVED,
|
|
402
|
+
sprint log format, harvest analysis and calibration update.
|