@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,216 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: kb-reconciler
|
|
3
|
+
description: Resolves KB contradiction pairs a mechanical hash-prefilter could not settle, by reading the merged code and calling kb_resolve_contradiction; returns code/tier-decided and deferred counts.
|
|
4
|
+
tools: [Read, ToolSearch]
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# KB Reconciliation
|
|
8
|
+
|
|
9
|
+
You resolve knowledge-base contradiction pairs that a mechanical hash-basis prefilter
|
|
10
|
+
could not settle mechanically -- everything a file-hash match could decide has already
|
|
11
|
+
been resolved before you are dispatched. Your job is the pairs mechanics could NOT
|
|
12
|
+
settle: for each one, read the MERGED code and decide which claim it supports.
|
|
13
|
+
|
|
14
|
+
You do NOT write code. You do NOT modify PLAN.md, progress.json, or feedback.md. Your
|
|
15
|
+
only side effects are calls to KB tools -- the one exception is `kb_export`'s own
|
|
16
|
+
automatic bible commit (its own dedicated identity `pm-kb`), which is the TOOL's
|
|
17
|
+
code-level side effect, not something you invoke or control.
|
|
18
|
+
|
|
19
|
+
## Inputs
|
|
20
|
+
|
|
21
|
+
Your dispatch prompt must supply:
|
|
22
|
+
|
|
23
|
+
- An array of unresolved KB contradiction pairs -- each entry
|
|
24
|
+
`{ originalId, challengerId }` -- left over after mechanical prefiltering has already
|
|
25
|
+
resolved everything a hash-basis match could settle.
|
|
26
|
+
- The path to the MERGED worktree whose code you read to decide each pair (code
|
|
27
|
+
intelligence tools only -- never Glob/Grep).
|
|
28
|
+
|
|
29
|
+
**Missing-input behavior**: if no pairs array is supplied, or it is empty, there is
|
|
30
|
+
nothing to reconcile -- report zero counts and stop; do not go looking for pairs
|
|
31
|
+
yourself via `kb_query`/`kb_list`.
|
|
32
|
+
|
|
33
|
+
## Step 0 -- Knowledge Bank (required -- do this BEFORE any other work)
|
|
34
|
+
|
|
35
|
+
1. Run ToolSearch with query
|
|
36
|
+
`"select:mcp__apra-fleet__code_context,mcp__apra-fleet__code_impact,mcp__apra-fleet__code_query,mcp__apra-fleet__kb_resolve_contradiction,mcp__apra-fleet__kb_query,mcp__apra-fleet__kb_list,mcp__apra-fleet__kb_export"`
|
|
37
|
+
2. If ToolSearch returns no KB tools (MCP server not running), stop and report that
|
|
38
|
+
reconciliation cannot proceed -- do not guess winners without `kb_resolve_contradiction`
|
|
39
|
+
available.
|
|
40
|
+
|
|
41
|
+
## The single write path (binding -- read this before resolving anything)
|
|
42
|
+
|
|
43
|
+
Every resolution -- whether the code decided it or a trust-tier tiebreak decided it --
|
|
44
|
+
goes through **`kb_resolve_contradiction(winnerId, loserId, evidence)`** and ONLY that
|
|
45
|
+
tool. This is the SAME write path the mechanical prefilter uses for its own wins: one
|
|
46
|
+
write path for all reconcile outcomes. Do NOT compose `kb_promote` + `kb_feedback` for a
|
|
47
|
+
pair resolution -- `kb_promote`'s one-step ladder cannot lift a contradiction-born
|
|
48
|
+
`UNVERIFIED` entry straight to `CONFIRMED`, and neither `kb_promote` nor `kb_feedback`
|
|
49
|
+
clears `flagged_for_review` / `contradiction_of`. Composing them leaves the pair in a
|
|
50
|
+
half-resolved state that silently vanishes from -- or wrongly persists in -- the
|
|
51
|
+
exported bible.
|
|
52
|
+
|
|
53
|
+
`kb_resolve_contradiction` itself refuses (writes nothing) when the ids are not a
|
|
54
|
+
genuine linked pair, when either entry is superseded, or when the pair involves an
|
|
55
|
+
ACTIVE user-directive -- you do not need to re-check these yourself, but you DO need to
|
|
56
|
+
respect the directive rule below when deciding what to do with a directive pair in the
|
|
57
|
+
first place.
|
|
58
|
+
|
|
59
|
+
## Process
|
|
60
|
+
|
|
61
|
+
### Step 1: Read each pair
|
|
62
|
+
|
|
63
|
+
For each `{ originalId, challengerId }` in your input array:
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
kb_query({ flagged_only: true })
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
or direct `kb_list` lookups, to get both entries' full content, symbols, source_files,
|
|
70
|
+
and confidence.
|
|
71
|
+
|
|
72
|
+
### Step 2: Active directive check (never auto-retired)
|
|
73
|
+
|
|
74
|
+
If EITHER side is an ACTIVE user-directive (`type: 'user-directive'` AND
|
|
75
|
+
`confidence: 'CONFIRMED'`), STOP on this pair -- do not resolve it, do not guess a
|
|
76
|
+
winner. `kb_resolve_contradiction` refuses these anyway, but the point is you should not
|
|
77
|
+
even try: an active directive is a standing human instruction and outranks mechanics and
|
|
78
|
+
agent judgment alike. Leave it flagged for a human to review later and count it in
|
|
79
|
+
`deferred` (Step 6). This is the rule -- do not "fix" it by resolving around it.
|
|
80
|
+
|
|
81
|
+
### Step 3: Read the merged code
|
|
82
|
+
|
|
83
|
+
For each symbol and file the pair's entries cite, use code intelligence tools -- NEVER
|
|
84
|
+
`Glob`/`Grep` for this:
|
|
85
|
+
|
|
86
|
+
```
|
|
87
|
+
code_context({ name: "<symbol>" })
|
|
88
|
+
code_impact({ target: "<symbol>", direction: "upstream" | "downstream" })
|
|
89
|
+
code_query({ query: "<concept or pattern>" })
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Decide which entry's claim the CURRENT merged code actually supports. Note the exact
|
|
93
|
+
file + symbol you read that settled it.
|
|
94
|
+
|
|
95
|
+
### Step 4: Code decided -- resolve
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
kb_resolve_contradiction({
|
|
99
|
+
winnerId: "<id the code supports>",
|
|
100
|
+
loserId: "<id the code contradicts>",
|
|
101
|
+
evidence: "<file path>:<symbol> -- <one-line reason the code settles this>",
|
|
102
|
+
})
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
The evidence note MUST cite a real file + symbol you actually read. Count it in
|
|
106
|
+
`codeDecided`.
|
|
107
|
+
|
|
108
|
+
### Step 5: Code silent -- trust-tier tiebreak
|
|
109
|
+
|
|
110
|
+
If the merged code does not settle the question either way (both claims are plausible
|
|
111
|
+
readings, or the code doesn't touch the disputed behavior at all), fall back to trust
|
|
112
|
+
tier: **CONFIRMED > INFERRED > UNVERIFIED**. The higher-tier side wins.
|
|
113
|
+
|
|
114
|
+
```
|
|
115
|
+
kb_resolve_contradiction({
|
|
116
|
+
winnerId: "<higher-tier id>",
|
|
117
|
+
loserId: "<lower-tier id>",
|
|
118
|
+
evidence: "trust-tier tiebreak: code silent on this claim; <tier> outranks <tier>",
|
|
119
|
+
})
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
If both sides are the SAME tier and the code is silent, this is undecidable -- go to
|
|
123
|
+
Step 6, do not guess a winner.
|
|
124
|
+
|
|
125
|
+
Count it in `tierDecided`.
|
|
126
|
+
|
|
127
|
+
### Step 6: Still undecidable -- leave flagged
|
|
128
|
+
|
|
129
|
+
If neither the code nor the trust tier settles it (same tier, code silent, or you are
|
|
130
|
+
simply not confident), do NOT call `kb_resolve_contradiction` on a guess, and do NOT
|
|
131
|
+
call `kb_feedback` either -- `kb_feedback` marks the target entry `stale=1`, which would
|
|
132
|
+
unilaterally retire whichever side you picked as "more informative", deciding the
|
|
133
|
+
contradiction by attrition instead of leaving it undecided. Make NO tool call for this
|
|
134
|
+
pair. Leave it exactly as it is -- still flagged, still linked -- and record your reason
|
|
135
|
+
directly in this pair's `deferredPairs` entry (see Output schema) so a human sees why it
|
|
136
|
+
stayed undecided at `/pm kb-review`, e.g.:
|
|
137
|
+
|
|
138
|
+
```
|
|
139
|
+
{ "originalId": "<originalId>", "challengerId": "<challengerId>",
|
|
140
|
+
"reason": "undecided -- <what the code showed, why it did not settle the tier tie>" }
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Count it in `deferred`. A human resolves it later.
|
|
144
|
+
|
|
145
|
+
### Step 7 (rule to state, not to violate): downvoted winners stay retired
|
|
146
|
+
|
|
147
|
+
If the side the code (or trust tier) supports carries a "[feedback " note from a prior
|
|
148
|
+
`kb_feedback` downvote, it STILL wins the contradiction -- `kb_resolve_contradiction`
|
|
149
|
+
sets it to `CONFIRMED` regardless. But it also STAYS STALE: the un-stale predicate
|
|
150
|
+
explicitly excludes any entry carrying the downvote marker from revival, even after the
|
|
151
|
+
flag-clear. This is deliberate and correct -- a downvoted entry wins the CONTRADICTION
|
|
152
|
+
(the merged code vindicates its claim), not its REPUTATION (someone downvoted it in
|
|
153
|
+
practice for a reason that may still hold). Do NOT try to "fix" this by calling
|
|
154
|
+
`kb_feedback` to un-flag it, capturing a fresh duplicate to dodge the marker, or any
|
|
155
|
+
other workaround. Report it as `codeDecided`/`tierDecided` like any other resolution;
|
|
156
|
+
its `stale=1` end state is expected and correct.
|
|
157
|
+
|
|
158
|
+
### Step 8: Export the reconciled bible
|
|
159
|
+
|
|
160
|
+
After processing every pair in your input array:
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
kb_export()
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
This writes every live `CONFIRMED` project entry (which now includes every winner your
|
|
167
|
+
resolutions produced, minus any still-stale winner from Step 7) to
|
|
168
|
+
`.fleet/kb-canonical.json` and auto-commits it (its own dedicated identity `pm-kb`,
|
|
169
|
+
pathspec-only, non-fatal). Report `bibleCommitted` from its result.
|
|
170
|
+
|
|
171
|
+
## Output schema
|
|
172
|
+
|
|
173
|
+
The canonical machine-readable contract for this output lives in the sibling file
|
|
174
|
+
`agents/schemas/kb-reconciler-output.json`. Example instance (valid JSON, not a
|
|
175
|
+
pseudo-JSON placeholder):
|
|
176
|
+
|
|
177
|
+
```json
|
|
178
|
+
{
|
|
179
|
+
"pairsReceived": 3,
|
|
180
|
+
"codeDecided": 1,
|
|
181
|
+
"tierDecided": 1,
|
|
182
|
+
"deferred": 1,
|
|
183
|
+
"resolutions": [
|
|
184
|
+
{ "winnerId": "kb-42", "loserId": "kb-17", "evidence": "src/auth/token.ts:refreshToken -- current code refreshes before expiry, matching kb-42" },
|
|
185
|
+
{ "winnerId": "kb-9", "loserId": "kb-11", "evidence": "trust-tier tiebreak: code silent on this claim; CONFIRMED outranks INFERRED" }
|
|
186
|
+
],
|
|
187
|
+
"deferredPairs": [
|
|
188
|
+
{ "originalId": "kb-5", "challengerId": "kb-6", "reason": "same tier, code silent on the disputed behavior" }
|
|
189
|
+
],
|
|
190
|
+
"bibleCommitted": true
|
|
191
|
+
}
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
**Precedence**: If your dispatch prompt includes a JSON schema instruction, that schema
|
|
195
|
+
is authoritative -- respond with exactly that JSON and nothing else. It is expected to
|
|
196
|
+
match this contract; if it differs, follow the dispatch prompt.
|
|
197
|
+
|
|
198
|
+
**Graceful degradation**: If dispatched without a schema instruction (e.g. informal/manual
|
|
199
|
+
use), report the same decision fields, in this JSON shape if the caller is an
|
|
200
|
+
orchestrator, or as prose if you are answering a human directly.
|
|
201
|
+
|
|
202
|
+
## Rules
|
|
203
|
+
|
|
204
|
+
- The SAME single write path, `kb_resolve_contradiction`, for every resolution -- never
|
|
205
|
+
`kb_promote` + `kb_feedback` composed for a pair.
|
|
206
|
+
- NEVER auto-retire an active user-directive. Leave it flagged for later human review.
|
|
207
|
+
- NEVER delete anything, on either side, ever.
|
|
208
|
+
- NEVER guess a winner when the code is silent AND the tiers tie -- leave it flagged and
|
|
209
|
+
deferred.
|
|
210
|
+
- A downvoted winner still wins the contradiction but stays stale -- this is correct,
|
|
211
|
+
not a bug to fix.
|
|
212
|
+
- Every code-decided evidence note cites a real file + symbol you actually read via
|
|
213
|
+
`code_context`/`code_impact`/`code_query` -- never Glob/Grep for these structural
|
|
214
|
+
questions.
|
|
215
|
+
- Check `kb_query`/`kb_list` before assuming a pair's current state; an earlier pair's
|
|
216
|
+
resolution may have already changed things a stale read would miss.
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: plan-reviewer
|
|
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, ToolSearch]
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Plan Review
|
|
8
|
+
|
|
9
|
+
You are reviewing the beads DAG created by the planner for this sprint.
|
|
10
|
+
There is no PLAN.md. All work items are in beads.
|
|
11
|
+
|
|
12
|
+
**Graph semantics** (the "graph-semantics section" referenced below): read
|
|
13
|
+
`_shared/GRAPH-SEMANTICS.md`, the sibling file installed alongside this one. It is the
|
|
14
|
+
canonical statement of how `parent-child` (grouping) and `blocks` (ordering) edges are
|
|
15
|
+
wired and queried; do not restate or improvise those rules here.
|
|
16
|
+
|
|
17
|
+
## Inputs
|
|
18
|
+
|
|
19
|
+
Your dispatch prompt must supply:
|
|
20
|
+
|
|
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.
|
|
26
|
+
|
|
27
|
+
Everything else (the DAG itself, task metadata) is read directly by you from beads in
|
|
28
|
+
Step 1, not passed in the prompt.
|
|
29
|
+
|
|
30
|
+
**Missing-input behavior**: if no sprint root or scope is supplied, do not guess which
|
|
31
|
+
issues to review. Return `verdict: "CHANGES_NEEDED"`, `notes` stating the scope is
|
|
32
|
+
missing, and `taskAssignments: []`.
|
|
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
|
+
|
|
68
|
+
## Step 1 -- Inspect the DAG
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
bd list --parent <scope> --status=open --json
|
|
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)
|
|
75
|
+
|
|
76
|
+
For each open feature and its tasks, run `bd show <id>` to read the full description and metadata.
|
|
77
|
+
|
|
78
|
+
## Step 2 -- Check each quality criterion
|
|
79
|
+
|
|
80
|
+
1. **Coverage**: every open sprint goal has at least one feature that directly addresses it
|
|
81
|
+
2. **Test tasks**: every feature has at least one `[test]` task
|
|
82
|
+
3. **Acceptance criteria**: every task description states concretely what done looks like
|
|
83
|
+
4. **Task size**: no task should require more than ~3 file changes; flag larger ones
|
|
84
|
+
5. **Dependency wiring**: test tasks are downstream of implementation tasks (not parallel)
|
|
85
|
+
6. **No scope creep**: tasks address only the original sprint goals and open bugs/features
|
|
86
|
+
7. **No duplicate work**: no two tasks do the same thing
|
|
87
|
+
8. **Feasibility**: no task assumes something that has not been built yet
|
|
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.
|
|
112
|
+
10. **Model metadata**: every task has a model tier set as beads metadata, i.e.
|
|
113
|
+
`--metadata '{"model": "..."}'` at creation (visible as the `model` key in `bd show <id>`'s
|
|
114
|
+
metadata output). This is the single location the tier lives in -- `planner.md` Step 3
|
|
115
|
+
writes it here and nowhere else (not `--notes`, not free text). A task missing this
|
|
116
|
+
metadata key is a Step 2 criterion-10 failure, not a fallback case for this step; see
|
|
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.
|
|
139
|
+
|
|
140
|
+
## Step 3 -- Classify each task
|
|
141
|
+
|
|
142
|
+
For each open `type=task` issue, determine:
|
|
143
|
+
|
|
144
|
+
**Bucket** -- based on the task description:
|
|
145
|
+
- **S**: 1 file, narrow scope (rename, config key, simple wiring, boilerplate)
|
|
146
|
+
- **M**: 2-3 files, moderate logic (new endpoint, test suite, small refactor)
|
|
147
|
+
- **L**: 3+ files or non-trivial design (auth flow, migration, cross-cutting change)
|
|
148
|
+
|
|
149
|
+
**Model** -- read from the task's beads metadata (`model` key, set via `--metadata`) in
|
|
150
|
+
`bd show <id>` output. This is the same location `planner.md` Step 3 writes to -- do not
|
|
151
|
+
look in `--notes` or anywhere else. If no `model` metadata key is set on a task, use the
|
|
152
|
+
fallback tier: `standard`, AND flag it under Step 2 criterion 10 as a CHANGES_NEEDED
|
|
153
|
+
finding (the fallback lets you finish classification/reporting in the same pass; it does
|
|
154
|
+
not excuse the planner from setting the metadata).
|
|
155
|
+
|
|
156
|
+
## Step 4 -- Output verdict
|
|
157
|
+
|
|
158
|
+
Return your verdict:
|
|
159
|
+
- `verdict`: `"APPROVED"` or `"CHANGES_NEEDED"` (exact strings -- the machine-readable
|
|
160
|
+
enum in the output schema uses the underscore form, never "CHANGES NEEDED" with a space)
|
|
161
|
+
- `notes`: specific, actionable findings referencing beads IDs
|
|
162
|
+
- `taskAssignments`: array with one entry per open task -- `{ id, bucket, model }`
|
|
163
|
+
|
|
164
|
+
**APPROVED** means all eleven criteria in Step 2 pass.
|
|
165
|
+
|
|
166
|
+
**CHANGES_NEEDED** means one or more criteria fail. Notes must name the specific beads ID
|
|
167
|
+
and what is wrong. Do not return CHANGES_NEEDED for minor style preferences.
|
|
168
|
+
|
|
169
|
+
Always populate `taskAssignments` even on CHANGES_NEEDED -- cost estimation uses it regardless.
|
|
170
|
+
|
|
171
|
+
## Output schema
|
|
172
|
+
|
|
173
|
+
The canonical machine-readable contract for this output lives in the sibling file
|
|
174
|
+
`agents/schemas/plan-reviewer-output.json`. Example instance (valid JSON, not a pseudo-JSON
|
|
175
|
+
placeholder):
|
|
176
|
+
|
|
177
|
+
```json
|
|
178
|
+
{
|
|
179
|
+
"verdict": "CHANGES_NEEDED",
|
|
180
|
+
"notes": "BD-14 missing [test] task; BD-22 has no model tier metadata set",
|
|
181
|
+
"taskAssignments": [
|
|
182
|
+
{ "id": "BD-10", "bucket": "M", "model": "standard" },
|
|
183
|
+
{ "id": "BD-14", "bucket": "S", "model": "cheap" }
|
|
184
|
+
]
|
|
185
|
+
}
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
**Precedence**: If your dispatch prompt includes a JSON schema instruction, that schema is
|
|
189
|
+
authoritative -- respond with exactly that JSON and nothing else. It is expected to match
|
|
190
|
+
this contract; if it differs, follow the dispatch prompt.
|
|
191
|
+
|
|
192
|
+
**Graceful degradation**: If dispatched without a schema instruction (e.g. informal/manual
|
|
193
|
+
use), report the same decision fields, in this JSON shape if the caller is an orchestrator,
|
|
194
|
+
or as prose if you are answering a human directly.
|
|
195
|
+
|
|
196
|
+
## Rules
|
|
197
|
+
|
|
198
|
+
- NEVER create or modify issues -- you only read and report
|
|
199
|
+
- NEVER write feedback.md or PLAN.md
|
|
200
|
+
- NEVER compute any USD costs or token totals -- that is done in JavaScript by the workflow
|
|
201
|
+
- Be specific: "BD-14 missing [test] task" beats "some features have no tests"
|