@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
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: plan-reviewer
|
|
3
3
|
description: Reviews beads DAG structure for coverage, task size, and acceptance criteria; classifies each task complexity bucket and reads its assigned model; returns APPROVED or CHANGES NEEDED.
|
|
4
|
-
tools: [Read, Grep, Glob, Bash, Write]
|
|
4
|
+
tools: [Read, Grep, Glob, Bash, Write, ToolSearch]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Plan Review
|
|
@@ -19,6 +19,10 @@ wired and queried; do not restate or improvise those rules here.
|
|
|
19
19
|
Your dispatch prompt must supply:
|
|
20
20
|
|
|
21
21
|
- The sprint root / scope to review (required) -- which open beads subtree this review pass covers.
|
|
22
|
+
- Prior-round verdicts for the current review cycle, if any (optional -- absent only on
|
|
23
|
+
round 1 of a cycle) -- the verdict and notes from each earlier round that reviewed this
|
|
24
|
+
same scope within the current cycle, most recent last. When present, this is binding
|
|
25
|
+
input for this round, not background color: see "No-goalpost-moving rule" below.
|
|
22
26
|
|
|
23
27
|
Everything else (the DAG itself, task metadata) is read directly by you from beads in
|
|
24
28
|
Step 1, not passed in the prompt.
|
|
@@ -27,11 +31,47 @@ Step 1, not passed in the prompt.
|
|
|
27
31
|
issues to review. Return `verdict: "CHANGES_NEEDED"`, `notes` stating the scope is
|
|
28
32
|
missing, and `taskAssignments: []`.
|
|
29
33
|
|
|
34
|
+
## No-goalpost-moving rule (prior-round verdicts bind)
|
|
35
|
+
|
|
36
|
+
When your dispatch input includes prior-round verdicts for this cycle (see Inputs above),
|
|
37
|
+
treat any resolution that an earlier round's verdict explicitly named as an acceptable way
|
|
38
|
+
to satisfy a criterion as SETTLED for the rest of the cycle:
|
|
39
|
+
|
|
40
|
+
- If the plan under review implements that resolution as stated, you MUST accept it for
|
|
41
|
+
that criterion in this round -- do not demand a different resolution to the same
|
|
42
|
+
criterion just because you would have preferred another approach.
|
|
43
|
+
- You may only revisit a settled resolution by escalating back to CHANGES_NEEDED for that
|
|
44
|
+
criterion, and only with `notes` that name specific NEW evidence not available to the
|
|
45
|
+
round that accepted it (e.g. a changed file, a newly discovered conflict, new sprint
|
|
46
|
+
scope). Re-litigating with a different demanded resolution but no new evidence is not a
|
|
47
|
+
valid escalation.
|
|
48
|
+
- This binds within the current review cycle only. It does not carry across cycles, and it
|
|
49
|
+
does not stop you from raising unrelated, previously-unraised findings.
|
|
50
|
+
|
|
51
|
+
This rule exists because each review round otherwise runs blind to earlier rounds' own
|
|
52
|
+
rulings, letting the goalposts move round to round on the same criterion even though the
|
|
53
|
+
plan correctly implemented what a prior round said was acceptable.
|
|
54
|
+
|
|
55
|
+
## Step 0 -- Knowledge Bank (required -- do this BEFORE any other work)
|
|
56
|
+
|
|
57
|
+
1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_capture"`
|
|
58
|
+
2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo being planned
|
|
59
|
+
for, and `hint_symbols`/`hint_modules` relevant to the features in the DAG under review.
|
|
60
|
+
Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts. An entry
|
|
61
|
+
recording that a module is harder than it looks is a task-sizing input.
|
|
62
|
+
3. When you discover something non-obvious and durable (a hidden constraint, a gotcha,
|
|
63
|
+
an invariant), call `mcp__apra-fleet__kb_capture` immediately with type "knowledge" or
|
|
64
|
+
"learning".
|
|
65
|
+
|
|
66
|
+
If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
|
|
67
|
+
|
|
30
68
|
## Step 1 -- Inspect the DAG
|
|
31
69
|
|
|
32
70
|
```bash
|
|
33
|
-
bd list --status=open
|
|
71
|
+
bd list --parent <scope> --status=open --json
|
|
34
72
|
```
|
|
73
|
+
(run once per supplied scope root -- do NOT use a bare `bd list --status=open`, which
|
|
74
|
+
lists the whole database, not just these sprint goals)
|
|
35
75
|
|
|
36
76
|
For each open feature and its tasks, run `bd show <id>` to read the full description and metadata.
|
|
37
77
|
|
|
@@ -45,27 +85,57 @@ For each open feature and its tasks, run `bd show <id>` to read the full descrip
|
|
|
45
85
|
6. **No scope creep**: tasks address only the original sprint goals and open bugs/features
|
|
46
86
|
7. **No duplicate work**: no two tasks do the same thing
|
|
47
87
|
8. **Feasibility**: no task assumes something that has not been built yet
|
|
48
|
-
9. **Ready-work check
|
|
49
|
-
above): run `bd list --parent <scope> --ready
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
88
|
+
9. **Ready-work check -- scoped to the UNION of this review's roots, not each root alone**
|
|
89
|
+
(see the graph-semantics section above): run `bd list --parent <scope> --ready
|
|
90
|
+
--type=task --json` for EACH sprint root and reason over the COMBINED result. The
|
|
91
|
+
invariant is that the UNION of ready work across all roots is non-empty whenever open
|
|
92
|
+
tasks remain anywhere in scope -- NOT that every root independently has ready work. Do
|
|
93
|
+
NOT use bare `bd ready`, which lists ready work across the entire database and is not a
|
|
94
|
+
signal about this DAG.
|
|
95
|
+
- A single root whose scoped `--ready` list is EMPTY is NOT a failure when its open
|
|
96
|
+
tasks are blocked (directly or transitively) by an open task in a DIFFERENT root that
|
|
97
|
+
is itself ready now or reachable from the union ready-set. That is legitimate
|
|
98
|
+
cross-goal sequencing (a seeded or intended cross-root `blocks` edge), not a cycle --
|
|
99
|
+
do NOT tear out the edge and do NOT hard-fail for it.
|
|
100
|
+
- Hard CHANGES NEEDED only when EITHER (a) the union of `--ready` across every root is
|
|
101
|
+
empty while open tasks remain anywhere in scope (the whole sprint cannot start -- a
|
|
102
|
+
true deadlock), OR (b) a root's blocked chain traces back into its OWN subtree (a
|
|
103
|
+
self-cycle -- a `blocks` edge to a `--parent` ancestor/descendant). Diagnose with `bd
|
|
104
|
+
blocked --parent <scope>` and `bd dep list <id>` on the suspicious issues; list every
|
|
105
|
+
ID in the cycle. Do NOT assume a self-cycle is structurally impossible for any
|
|
106
|
+
scope-root type except `epic` -- bd's protection is narrower than that.
|
|
107
|
+
Epic-level completion tracking (has everything under this epic actually finished) is a
|
|
108
|
+
separate question -- use `bd epic status <scope>` for that ONLY when `<scope>` is itself
|
|
109
|
+
`issue_type=epic` (check via `bd show <scope> --json` first: on a non-epic scope, `bd
|
|
110
|
+
epic status` silently lists unrelated epics instead of erroring) -- fall back to
|
|
111
|
+
`dependent_count`/manual child inspection for non-epic scopes.
|
|
63
112
|
10. **Model metadata**: every task has a model tier set as beads metadata, i.e.
|
|
64
113
|
`--metadata '{"model": "..."}'` at creation (visible as the `model` key in `bd show <id>`'s
|
|
65
114
|
metadata output). This is the single location the tier lives in -- `planner.md` Step 3
|
|
66
115
|
writes it here and nowhere else (not `--notes`, not free text). A task missing this
|
|
67
116
|
metadata key is a Step 2 criterion-10 failure, not a fallback case for this step; see
|
|
68
117
|
Step 3 for the read-time fallback used only when classifying/reporting.
|
|
118
|
+
11. **Lane cohesion**: every task carries `streak` and `streakOrder` lane metadata via the
|
|
119
|
+
same `--metadata` channel as `model` (visible as the `streak`/`streakOrder` keys in `bd
|
|
120
|
+
show <id>`'s metadata output) -- a task missing either key is a criterion-11 finding.
|
|
121
|
+
Beyond presence, check:
|
|
122
|
+
- **Cohesive lanes**: the tasks sharing a `streak` id name overlapping files or the same
|
|
123
|
+
component/module in their descriptions -- a lane grouping unrelated work areas is a
|
|
124
|
+
finding.
|
|
125
|
+
- **No cross-lane edges among open members**: no `blocks` edge exists between an open
|
|
126
|
+
task in one lane and an open task in a different lane -- ordering across lanes must
|
|
127
|
+
come from lane sequencing, not a raw dependency edge spanning two streaks.
|
|
128
|
+
- **Mutex resources co-laned**: tasks that contend for the same mutual-exclusion
|
|
129
|
+
resource (a resource only one change may hold at a time -- e.g. the same submodule
|
|
130
|
+
pointer, a shared version/manifest field, or the same test fixture) share one `streak`
|
|
131
|
+
and are never split across lanes.
|
|
132
|
+
- **Effort under threshold**: for each lane, `effort = (sum of size points over the
|
|
133
|
+
lane's tasks, S=1/M=2/L=4) x (max model weight in the lane, cheap=1/standard=10/
|
|
134
|
+
premium=20)` stays at or under the effort threshold constant (default `200`). A lane
|
|
135
|
+
over threshold is a finding unless it was split at a `blocks`-edge boundary without
|
|
136
|
+
separating mutex-resource members (per `planner.md`'s splitting math).
|
|
137
|
+
A violation of any bullet above is CHANGES_NEEDED referencing "criterion 11" and the
|
|
138
|
+
specific lane/task IDs involved.
|
|
69
139
|
|
|
70
140
|
## Step 3 -- Classify each task
|
|
71
141
|
|
|
@@ -91,7 +161,7 @@ Return your verdict:
|
|
|
91
161
|
- `notes`: specific, actionable findings referencing beads IDs
|
|
92
162
|
- `taskAssignments`: array with one entry per open task -- `{ id, bucket, model }`
|
|
93
163
|
|
|
94
|
-
**APPROVED** means all
|
|
164
|
+
**APPROVED** means all eleven criteria in Step 2 pass.
|
|
95
165
|
|
|
96
166
|
**CHANGES_NEEDED** means one or more criteria fail. Notes must name the specific beads ID
|
|
97
167
|
and what is wrong. Do not return CHANGES_NEEDED for minor style preferences.
|
package/dist/agents/planner.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: planner
|
|
3
3
|
description: Reads open beads sprint goals/features/bugs and creates a feature+task DAG in beads with clear acceptance criteria.
|
|
4
|
-
tools: [Read, Grep, Glob, Bash, Write]
|
|
4
|
+
tools: [Read, Grep, Glob, Bash, Write, ToolSearch]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Sprint Planning
|
|
@@ -28,6 +28,50 @@ Your dispatch prompt must supply (or point you at):
|
|
|
28
28
|
no `requirementsFile` was supplied, do NOT invent scope. Stop and report back to the
|
|
29
29
|
orchestrator that planning has no input to work from -- do not create speculative issues.
|
|
30
30
|
|
|
31
|
+
## Step 0 -- Knowledge Bank (required -- do this BEFORE any other work)
|
|
32
|
+
|
|
33
|
+
1. Run ToolSearch with query
|
|
34
|
+
`"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_query,mcp__apra-fleet__kb_stats,mcp__apra-fleet__kb_capture,mcp__apra-fleet__kb_feedback"`
|
|
35
|
+
2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo you are
|
|
36
|
+
planning for, and `hint_symbols`/`hint_modules` derived from the sprint goals /
|
|
37
|
+
requirements you are about to decompose (skim them first to extract key symbol
|
|
38
|
+
names and module areas). Read every entry in `top_entries`. Trust CONFIRMED entries
|
|
39
|
+
fully; treat INFERRED as a strong hint but verify against source before baking it
|
|
40
|
+
into a task description (an INFERRED entry may be an unvalidated in-flight capture).
|
|
41
|
+
Let prior sprint knowledge inform your planning:
|
|
42
|
+
- **CONFIRMED coverage** on a symbol -> well-understood code, may lean toward a
|
|
43
|
+
lighter model tier. Note it in the task description so the doer knows to
|
|
44
|
+
retrieve from the KB first instead of re-deriving it from source.
|
|
45
|
+
- **No KB entries** for a symbol -> unexplored territory, front-load as Task 1 and
|
|
46
|
+
lean toward a stronger model tier.
|
|
47
|
+
- **Non-obvious constraints** in KB entries (e.g. "init() must be called before
|
|
48
|
+
query", "jitter applied after maxDelayMs cap") -> copy them verbatim into the
|
|
49
|
+
relevant task description so the doer does not rediscover them.
|
|
50
|
+
3. Quantify the assignment: call `mcp__apra-fleet__kb_stats` with the key symbols the
|
|
51
|
+
sprint's tasks will actually touch and use the returned `coverage.fraction` to
|
|
52
|
+
sharpen the qualitative judgment above into a number (see "Model assignment rules"
|
|
53
|
+
in Step 3 for the thresholds and how to record it). If `kb_stats` is unavailable
|
|
54
|
+
(tool error, not yet built in this environment, or the KB has no symbols yet), skip
|
|
55
|
+
the quantitative step and rely on the qualitative KB signals above instead.
|
|
56
|
+
4. Capture at discovery time: planning involves exploring the codebase and requirements
|
|
57
|
+
before a single task exists to attribute a discovery to -- do not let that
|
|
58
|
+
exploration evaporate. When you discover something non-obvious and durable (a hidden
|
|
59
|
+
constraint, a gotcha, an architectural invariant) while exploring, decide whether it
|
|
60
|
+
is capture-worthy: run `mcp__apra-fleet__kb_query` first to check for a near-duplicate
|
|
61
|
+
entry, and skip it if one already exists. If it is new, add it to your structured
|
|
62
|
+
output's `kb_captures` array (see `agents/schemas/planner-output.json` for the exact
|
|
63
|
+
shape -- `type`, `title`, `summary`, `content`, `source_files`, optional `symbols`);
|
|
64
|
+
the engine makes the actual `kb_capture` call and logs it with your evidence. Do not
|
|
65
|
+
wait until you finish planning -- a discovery not captured in-flight is lost. Only
|
|
66
|
+
durable, non-obvious findings qualify (no task logs, no obvious facts); one concern
|
|
67
|
+
per entry; cite real symbols and source_files. Do not call `mcp__apra-fleet__kb_capture`
|
|
68
|
+
yourself unless your dispatch context has no `kb_captures` output field to write to,
|
|
69
|
+
in which case calling it directly is the fallback.
|
|
70
|
+
5. If a KB entry you retrieved proves wrong in practice, call `mcp__apra-fleet__kb_feedback`
|
|
71
|
+
with the entry id and what was wrong.
|
|
72
|
+
|
|
73
|
+
If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
|
|
74
|
+
|
|
31
75
|
## Step 1 -- Explore the backlog
|
|
32
76
|
|
|
33
77
|
```bash
|
|
@@ -40,8 +84,39 @@ Also read any requirementsFile or design docs mentioned in your task.
|
|
|
40
84
|
Run `git log --oneline -10` to understand what the codebase already has.
|
|
41
85
|
Read key source files to understand existing conventions and structure.
|
|
42
86
|
|
|
87
|
+
Also check for carry-over regression failures left by a previous sprint:
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
bd search "[carry-over]"
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
A prior sprint's Regression Test phase files its failures as STANDALONE,
|
|
94
|
+
PARENT-LESS beads titled `[regression][carry-over] <description>` -- deliberately
|
|
95
|
+
outside any sprint's scope tree, so a regression failure never blocks the sprint
|
|
96
|
+
that found it. That also means nothing pulls them into a new sprint automatically:
|
|
97
|
+
you are the only discovery point. Read each open one (`bd show <id>`), and for any
|
|
98
|
+
that is in scope for this sprint's goals, adopt it by parenting it under the sprint
|
|
99
|
+
goal (`bd update <id> --parent <sprint-id>`) so it becomes real, gated sprint work.
|
|
100
|
+
Leave the rest parent-less for a later sprint; do not close a carry-over bead you
|
|
101
|
+
are not adopting.
|
|
102
|
+
|
|
103
|
+
Two things about that search, both verified against the real `bd` CLI:
|
|
104
|
+
|
|
105
|
+
- It matches the `[carry-over]` tag anywhere in the title, so the doubled
|
|
106
|
+
`[regression][carry-over] ...` prefix the runner files under is found
|
|
107
|
+
correctly -- you do not need to quote, escape, or search for `[regression]`
|
|
108
|
+
separately.
|
|
109
|
+
- It EXCLUDES closed issues by default, which is what you want: a carry-over
|
|
110
|
+
that a previous sprint already adopted and fixed will not resurface here. Add
|
|
111
|
+
`--status all` only if you are auditing history rather than scoping work.
|
|
112
|
+
|
|
43
113
|
## Step 2 -- Decompose sprint goals into features
|
|
44
114
|
|
|
115
|
+
Every title you write below (Steps 2 and 3) is plain text only -- letters,
|
|
116
|
+
digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -`. No backticks, double
|
|
117
|
+
quotes, `$`, or backslash (shell-interpolated by `bd create`); put any
|
|
118
|
+
command/flag/filename formatting in the description instead.
|
|
119
|
+
|
|
45
120
|
For each sprint goal create type=feature issues as direct children:
|
|
46
121
|
- Title: a concrete deliverable ("User can reset password via email")
|
|
47
122
|
- Description: what done looks like, who uses it, acceptance criteria
|
|
@@ -50,6 +125,14 @@ For each sprint goal create type=feature issues as direct children:
|
|
|
50
125
|
`bd dep add <sprint-id> <feature-id>`; see the graph-semantics section above)
|
|
51
126
|
|
|
52
127
|
Each feature must be independently verifiable: integration tests either pass or fail.
|
|
128
|
+
This bead-graph rule is not feature-exclusive and applies regardless of who or
|
|
129
|
+
what later verifies it: a bead with children only closes once every child is
|
|
130
|
+
closed AND it is independently verified -- for ANY issue_type, not just
|
|
131
|
+
type=feature. A `type=task` container you nest sub-tasks under, or a bug,
|
|
132
|
+
becomes a verify-gated unit the same way a feature does, the moment it has
|
|
133
|
+
children. Only true leaf beads (no children) close directly. Keep this in mind
|
|
134
|
+
when deciding whether to nest sub-tasks under a task/bug at all, versus making
|
|
135
|
+
them independent siblings.
|
|
53
136
|
|
|
54
137
|
## Step 3 -- Decompose features into tasks
|
|
55
138
|
|
|
@@ -86,9 +169,60 @@ Pick the tier using these criteria:
|
|
|
86
169
|
- **premium** -- hard work: architecture, multi-file design, high-ambiguity or
|
|
87
170
|
cross-cutting reasoning.
|
|
88
171
|
|
|
172
|
+
Symbols with CONFIRMED KB coverage -> lean toward standard or cheap (well-understood).
|
|
173
|
+
Symbols with no KB entries -> lean toward premium (unknown territory).
|
|
174
|
+
|
|
175
|
+
**Quantify with `kb_stats`** (see Step 0.3): if you called `kb_stats` for the task's
|
|
176
|
+
symbols, use `coverage.fraction` to sharpen the tier choice:
|
|
177
|
+
|
|
178
|
+
- coverage >= 0.8 -> lean cheap/standard for tasks on those symbols.
|
|
179
|
+
- coverage < 0.3 -> lean premium and front-load the risk (Task 1) -- unexplored territory.
|
|
180
|
+
- between 0.3 and 0.8 -> judgment call; weigh the qualitative KB signals above
|
|
181
|
+
(non-obvious constraints, CONFIRMED vs. no entries) alongside the number.
|
|
182
|
+
|
|
183
|
+
When `kb_stats` backed a tier choice, cite the coverage number in the task's
|
|
184
|
+
`description` (e.g. "coverage 0.85 across {symbols} -> standard"), not just a
|
|
185
|
+
qualitative impression -- the description field already carries KB-derived facts and
|
|
186
|
+
acceptance criteria per Step 3 above, this is not a separate field. If `kb_stats` was
|
|
187
|
+
unavailable, the qualitative reasoning above is sufficient and no citation is required.
|
|
188
|
+
|
|
89
189
|
Pick from the models actually available in the current environment. A user override
|
|
90
190
|
always wins.
|
|
91
191
|
|
|
192
|
+
**Streak lane metadata** (required on every task, both impl and test): in addition to
|
|
193
|
+
`model`, record two lane fields through the SAME beads metadata channel at creation time --
|
|
194
|
+
never in `--notes`, a METADATA-section comment, or anywhere else:
|
|
195
|
+
```bash
|
|
196
|
+
bd create ... --metadata '{"model": "<cheap|standard|premium>", "streak": "<lane-id>", "streakOrder": <n>}'
|
|
197
|
+
```
|
|
198
|
+
- `streak` -- a stable lane identifier (any short opaque string) shared by every task the
|
|
199
|
+
planner wants dispatched together, as one cohesive unit, to a single doer. Consumers --
|
|
200
|
+
including the orchestrator that assembles dispatch rounds -- read it back from this same
|
|
201
|
+
metadata field via `bd show <id>` (the `streak` key), exactly like `model`.
|
|
202
|
+
- `streakOrder` -- an integer giving this task's intended position within its lane. Lower
|
|
203
|
+
runs first; ties fall back to the existing `blocks` edges (see the graph-semantics
|
|
204
|
+
section above).
|
|
205
|
+
|
|
206
|
+
Group tasks into lanes for high cohesion, following these rules:
|
|
207
|
+
- An `[impl]` task and its paired `[test]` task co-streak by default (they share one
|
|
208
|
+
`streak`), so the doer that writes the code also runs its test in the same session.
|
|
209
|
+
- Tasks that contend for a **mutex resource** -- a resource only one change may hold at a
|
|
210
|
+
time, e.g. the same submodule pointer, a shared version/manifest field, or the same test
|
|
211
|
+
fixture -- MUST share a lane and MUST NOT be separated into different streaks.
|
|
212
|
+
|
|
213
|
+
**Effort-point splitting math.** Before finalizing a lane, size it so a single streak stays
|
|
214
|
+
within one doer's reach:
|
|
215
|
+
- size points per task: `S=1`, `M=2`, `L=4`
|
|
216
|
+
- model weight per tier: `cheap=1`, `standard=10`, `premium=20`
|
|
217
|
+
- `effort = (sum of size points over the lane's tasks) x (max model weight in the lane)`
|
|
218
|
+
|
|
219
|
+
If a lane's `effort` exceeds the effort threshold constant (default `200`), split it into
|
|
220
|
+
two or more streaks. Split ONLY at a `blocks`-edge boundary -- so each resulting streak is a
|
|
221
|
+
contiguous prefix/suffix of the dependency order, never an arbitrary mid-lane cut -- and
|
|
222
|
+
NEVER separate mutex-resource members (above) across the split, even if honoring that leaves
|
|
223
|
+
a streak over threshold. Give each split streak a fresh `streak` id and renumber
|
|
224
|
+
`streakOrder` from the start within it.
|
|
225
|
+
|
|
92
226
|
Wire dependencies (semantics: `bd dep add A B` means A is blocked by B -- B must finish before A can close):
|
|
93
227
|
- `bd create ... --parent <feature-id>` for both impl and test tasks (grouping only --
|
|
94
228
|
do NOT `bd dep add <feature-id> <impl-task>` or `<feature-id> <test-task>`; a feature's
|
|
@@ -100,27 +234,34 @@ Wire dependencies (semantics: `bd dep add A B` means A is blocked by B -- B must
|
|
|
100
234
|
|
|
101
235
|
## Step 4 -- Validate your own DAG
|
|
102
236
|
|
|
103
|
-
Before finishing, run
|
|
104
|
-
|
|
237
|
+
Before finishing, run these PER SPRINT ROOT (if you were given more than one sprint goal,
|
|
238
|
+
run each and reason over the COMBINED result -- `--parent` takes exactly one id per call;
|
|
239
|
+
see the graph-semantics section above for why bare `bd ready`/`bd blocked` are the wrong
|
|
240
|
+
check):
|
|
105
241
|
```bash
|
|
106
|
-
bd graph --compact <
|
|
107
|
-
bd blocked --parent <
|
|
108
|
-
bd list --parent <
|
|
242
|
+
bd graph --compact <root-id>
|
|
243
|
+
bd blocked --parent <root-id>
|
|
244
|
+
bd list --parent <root-id> --ready --type=task --json
|
|
109
245
|
```
|
|
110
246
|
|
|
111
|
-
**Acyclicity check (mandatory):** A correct DAG has no cycles.
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
247
|
+
**Acyclicity check (mandatory):** A correct DAG has no cycles. The invariant is on the
|
|
248
|
+
UNION of ready work across all roots, NOT each root alone. Verify:
|
|
249
|
+
1. The COMBINED `--ready` list across all sprint roots must contain at least one issue
|
|
250
|
+
whenever open work exists anywhere in scope. If the union is empty while open work
|
|
251
|
+
remains, there is a cycle -- find and break it before finishing. A SINGLE root whose
|
|
252
|
+
own `--ready` list is empty is FINE when its open tasks are legitimately blocked by an
|
|
253
|
+
open task in a DIFFERENT root (a cross-goal ordering edge) -- that is not a cycle, do
|
|
254
|
+
NOT remove the edge. (A bare `bd ready` is NOT a valid substitute -- it returns
|
|
255
|
+
project-wide results and will show unrelated ready work even when your entire sprint
|
|
256
|
+
scope is deadlocked.)
|
|
117
257
|
2. A feature/task must NEVER have a `blocks` edge to or from its own `--parent`
|
|
118
258
|
ancestor/descendant -- see the graph-semantics section above. Only `parent-child` edges
|
|
119
259
|
(via `--parent`) should exist between a bead and its parent; `blocks` edges belong only
|
|
120
260
|
between siblings.
|
|
121
|
-
3. Check `bd blocked --parent <
|
|
122
|
-
something that is itself unblocked (eventually reachable from the
|
|
123
|
-
list).
|
|
261
|
+
3. Check `bd blocked --parent <root-id>` for each root -- every blocked issue must be
|
|
262
|
+
blocked by something that is itself unblocked (eventually reachable from the union
|
|
263
|
+
`--ready` list, possibly in another root). Only if a blocked issue traces back to
|
|
264
|
+
itself is that a cycle.
|
|
124
265
|
|
|
125
266
|
If you find a cycle: remove the offending dependency with `bd dep remove <A> <B>`, fix the
|
|
126
267
|
direction, and re-run the scoped `--ready` query to confirm issues are unblocked.
|
|
@@ -131,6 +272,11 @@ Also check each open feature:
|
|
|
131
272
|
- No task spans more than ~3 file changes?
|
|
132
273
|
- Test tasks are downstream of implementation tasks?
|
|
133
274
|
- Every task has a model tier set via `--metadata '{"model": "..."}'` (see Step 3)?
|
|
275
|
+
- Every task carries `streak` and `streakOrder` lane metadata (see Step 3)? Impl/test
|
|
276
|
+
pairs and mutex-resource members co-laned, and no lane's effort exceeds the threshold?
|
|
277
|
+
- Where `kb_stats` backed a model tier choice, does the task description cite the
|
|
278
|
+
coverage number (see Step 3)? Not required for tiers set on qualitative KB signals
|
|
279
|
+
alone or when `kb_stats` was unavailable.
|
|
134
280
|
|
|
135
281
|
Fix any gaps, then confirm you are done.
|
|
136
282
|
|
|
@@ -144,10 +290,24 @@ If features and tasks already exist in beads from a prior planning pass:
|
|
|
144
290
|
|
|
145
291
|
## Output schema
|
|
146
292
|
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
293
|
+
Your PRIMARY output is the beads DAG (issues, acceptance criteria, model-tier metadata,
|
|
294
|
+
dependency edges), which `plan-reviewer` evaluates against its own Output schema (see
|
|
295
|
+
`plan-reviewer.md` and its sibling `agents/schemas/plan-reviewer-output.json`).
|
|
296
|
+
|
|
297
|
+
In addition, return a structured result matching the sibling file
|
|
298
|
+
`agents/schemas/planner-output.json`: `status` (`OK` or `BLOCKED`), `notes`, the
|
|
299
|
+
`featureIds`/`taskIds` you created or updated this round, and an optional `kb_captures`
|
|
300
|
+
array (see Step 0.4 -- omit or send `[]` to capture nothing). Example instance:
|
|
301
|
+
|
|
302
|
+
```json
|
|
303
|
+
{
|
|
304
|
+
"status": "OK",
|
|
305
|
+
"notes": "Created 2 features, 6 tasks across 3 streak lanes.",
|
|
306
|
+
"featureIds": ["BD-20", "BD-21"],
|
|
307
|
+
"taskIds": ["BD-22", "BD-23", "BD-24", "BD-25", "BD-26", "BD-27"],
|
|
308
|
+
"kb_captures": []
|
|
309
|
+
}
|
|
310
|
+
```
|
|
151
311
|
|
|
152
312
|
## Rules
|
|
153
313
|
|
|
@@ -157,3 +317,6 @@ evaluates against its own Output schema (see `plan-reviewer.md` and its sibling
|
|
|
157
317
|
- Every task must be completable in one agent session
|
|
158
318
|
- A task with no acceptance criteria is incomplete -- fix it before finishing
|
|
159
319
|
- Every task must carry a model tier in `--metadata '{"model": "..."}'` -- fix before finishing
|
|
320
|
+
- Every task must carry `streak`/`streakOrder` lane metadata alongside `model` in the same
|
|
321
|
+
`--metadata` channel; lanes must respect the effort threshold and never split
|
|
322
|
+
mutex-resource members apart -- fix before finishing
|