@apralabs/apra-fleet 0.4.2 → 0.4.4
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 +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -48,18 +48,42 @@ to satisfy a criterion as SETTLED for the rest of the cycle:
|
|
|
48
48
|
- This binds within the current review cycle only. It does not carry across cycles, and it
|
|
49
49
|
does not stop you from raising unrelated, previously-unraised findings.
|
|
50
50
|
|
|
51
|
-
## Step 0 -- Knowledge Bank (
|
|
51
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
52
|
+
|
|
53
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
54
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
55
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
56
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
57
|
+
the orchestrator fetched for the features in the DAG under review.
|
|
58
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
59
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
60
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
61
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
62
|
+
|
|
63
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
64
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
65
|
+
|
|
66
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
67
|
+
relevant to the features in the DAG under review.
|
|
68
|
+
2. Any judgment that depends on KB coverage (e.g. whether a task touches unexplored code
|
|
69
|
+
and needs a stronger model tier) is made from the live result or the injected block,
|
|
70
|
+
never inferred from a tool failure. An entry recording that a module is harder than
|
|
71
|
+
it looks is a task-sizing input.
|
|
72
|
+
3. This role has no KB-capture channel: note a non-obvious, durable finding (a hidden
|
|
73
|
+
constraint, a gotcha, an invariant) -- or a KB entry that proved wrong in practice --
|
|
74
|
+
in your own review notes.
|
|
75
|
+
|
|
76
|
+
### Persistent Memories (operational rules)
|
|
77
|
+
|
|
78
|
+
Before starting plan review, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
52
79
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
recording that a module is harder than it looks is a task-sizing input.
|
|
58
|
-
3. When you discover something non-obvious and durable (a hidden constraint, a gotcha,
|
|
59
|
-
an invariant), call `mcp__apra-fleet__kb_capture` immediately with type "knowledge" or
|
|
60
|
-
"learning".
|
|
80
|
+
```bash
|
|
81
|
+
bd memories --json +all+
|
|
82
|
+
bd memories --json +plan-reviewer+
|
|
83
|
+
```
|
|
61
84
|
|
|
62
|
-
|
|
85
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
86
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+plan-reviewer+`.
|
|
63
87
|
|
|
64
88
|
## Step 1 -- Inspect the DAG
|
|
65
89
|
|
|
@@ -76,8 +100,21 @@ For each open feature and its tasks, run `bd show <id>` to read the full descrip
|
|
|
76
100
|
1. **Coverage**: every open sprint goal has at least one feature that directly addresses it
|
|
77
101
|
2. **Test tasks**: every feature has at least one `[test]` task
|
|
78
102
|
3. **Acceptance criteria**: every task description states concretely what done looks like
|
|
79
|
-
4. **Task size**:
|
|
80
|
-
|
|
103
|
+
4. **Task size**: a task must have crisp, verifiable acceptance criteria and be closable
|
|
104
|
+
in one doer pass (typically 1-4 files). Flag a task that is too LARGE to have crisp
|
|
105
|
+
criteria, AND flag a chain of tasks that were split only to stay small (e.g. "add
|
|
106
|
+
helper" / "call helper" / "test helper" as three tasks with no independent value) --
|
|
107
|
+
those should be fewer tasks, or at minimum one lane.
|
|
108
|
+
5. **Dependency wiring**: a `[test]` task follows its `[impl]` task in the SAME lane with
|
|
109
|
+
a higher `streakOrder` -- splitting an impl/test pair across two lanes for convenience
|
|
110
|
+
is a finding. The only legitimate exception is a feature-level `[test]` task whose impl
|
|
111
|
+
work was itself split across multiple lanes by the sizing rules (planner.md's rule that
|
|
112
|
+
a lane is split "ONLY at a point where the earlier part is a self-contained, reviewable
|
|
113
|
+
increment"): then the test task's own lane may depend cross-lane on each of those impl
|
|
114
|
+
lanes. A `blocks` edge between two tasks that share a `streak` id is ALWAYS a finding,
|
|
115
|
+
regardless of task type -- it silently splits the lane into separate review rounds. A
|
|
116
|
+
legitimate cross-lane edge must originate from every task of the downstream lane and
|
|
117
|
+
target the last (highest `streakOrder`) task of the upstream lane.
|
|
81
118
|
6. **No scope creep**: tasks address only the original sprint goals and open bugs/features
|
|
82
119
|
7. **No duplicate work**: no two tasks do the same thing
|
|
83
120
|
8. **Feasibility**: no task assumes something that has not been built yet
|
|
@@ -106,26 +143,66 @@ For each open feature and its tasks, run `bd show <id>` to read the full descrip
|
|
|
106
143
|
in `bd show <id>` -- the single location, per `planner.md` Step 3; never `--notes`
|
|
107
144
|
or free text). A missing key is a criterion-10 failure; Step 3's fallback is for
|
|
108
145
|
classification/reporting only.
|
|
109
|
-
11. **Lane cohesion**: every task carries `streak` and `streakOrder` in
|
|
110
|
-
`--metadata` channel as `model` -- a task missing
|
|
111
|
-
finding.
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
146
|
+
11. **Lane cohesion and sizing**: every task carries `size`, `streak` and `streakOrder` in
|
|
147
|
+
the same `--metadata` channel as `model` -- a task missing any of these three keys is
|
|
148
|
+
a criterion-11 finding. (A missing `model` key is criterion 10's finding,
|
|
149
|
+
`kind: "model_metadata"` -- do not also report it here.) Beyond presence:
|
|
150
|
+
- **Cohesive lanes**: tasks sharing a `streak` id name overlapping files, the same
|
|
151
|
+
component/module, or an enabling relationship in their descriptions -- a lane
|
|
152
|
+
grouping unrelated work areas is a finding.
|
|
153
|
+
- **Under-batched lanes** (this is the finding this criterion most often should
|
|
154
|
+
produce): two lanes joined by a `blocks` edge (directly, or transitively through
|
|
155
|
+
other lanes) that are cohesive by the planner's SAME-lane rules (same
|
|
156
|
+
files/component, enabling relationship, impl and its test, mutex members) and whose
|
|
157
|
+
combined effort is within `laneMaxEffort` and `laneMaxTasks` must be ONE lane, UNLESS
|
|
158
|
+
the downstream lane is a feature-level `[test]` lane covering impl work legitimately
|
|
159
|
+
split across several lanes (criterion 5's exception) -- that cross-lane wiring is
|
|
160
|
+
required, not under-batching. Each other unnecessary lane boundary in a CHAIN is an
|
|
161
|
+
extra review round; name the lanes to merge. Two cohesive lanes with NO `blocks` edge
|
|
162
|
+
between them normally already run in the same review round -- merging them would only
|
|
163
|
+
remove parallelism, usually for no review saving, so that is NOT a finding.
|
|
164
|
+
- **No intra-lane `blocks` edges; cross-lane edges wired correctly**: see criterion 5
|
|
165
|
+
for the rule -- report a violation there as `kind: "dependency_wiring"`, not here.
|
|
118
166
|
- **Mutex resources co-laned**: tasks that contend for the same mutual-exclusion
|
|
119
167
|
resource (a resource only one change may hold at a time -- e.g. the same submodule
|
|
120
168
|
pointer, a shared version/manifest field, or the same test fixture) share one `streak`
|
|
121
169
|
and are never split across lanes.
|
|
122
|
-
- **
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
170
|
+
- **Within limits**: per lane, task count `<=` `laneMaxTasks` and `effort` (computed
|
|
171
|
+
from the recorded `size` values, not your own estimate -- `effort = sum of size
|
|
172
|
+
points S=1/M=2/L=4 x max model weight in the lane, cheap=1/standard=10/premium=20`)
|
|
173
|
+
`<=` `laneMaxEffort`. These three numbers (defaults `laneMaxTasks=6`,
|
|
174
|
+
`laneMaxEffort=200`, `laneTargetEffort=60`) are fixed for now -- no per-dispatch
|
|
175
|
+
override channel exists yet. A lane over either cap is a finding unless it was split
|
|
176
|
+
at a point where the earlier part is a self-contained, reviewable increment, without
|
|
177
|
+
separating mutex-resource members.
|
|
178
|
+
- **Safety valves -- do NOT ask for a merge when**: the lanes have no `blocks` edge
|
|
179
|
+
between them (see Under-batched lanes above); the lanes sit across a risk boundary
|
|
180
|
+
the planner named (contract change, migration, security-sensitive or destructive
|
|
181
|
+
path); a downstream task's criteria genuinely depend on the upstream outcome being
|
|
182
|
+
reviewed first; or the merged lane would exceed either cap.
|
|
183
|
+
A violation of any finding bullet above -- excluding the intra-lane/cross-lane bullet
|
|
184
|
+
(routes to criterion 5) and the Safety valves bullet (describes non-findings) -- is
|
|
185
|
+
CHANGES_NEEDED referencing "criterion 11" and the specific lane/task IDs involved.
|
|
186
|
+
12. **NOTES-vs-child contradiction**: for each child under review, check whether its
|
|
187
|
+
parent bead's NOTES contains any entry recognizable as a correction or amendment --
|
|
188
|
+
language such as "CORRECTION", "AMENDMENT", "SUPERSEDES", "REVISED", or an explicit
|
|
189
|
+
"do X, not Y" statement. Compare each such correction against the child's own
|
|
190
|
+
DESCRIPTION/acceptance criteria. If the child's text contradicts a correction
|
|
191
|
+
recorded in the parent's NOTES -- e.g. it reintroduces an approach the correction
|
|
192
|
+
explicitly rejected, or omits a requirement the correction added -- this is a
|
|
193
|
+
CHANGES_NEEDED finding. When reporting a finding of this kind, quote the exact
|
|
194
|
+
conflicting text from BOTH the parent's correction and the child's contradicting
|
|
195
|
+
passage in `detail` -- a vague "may not be aligned with parent notes" is not
|
|
196
|
+
sufficient; the finding must be falsifiable by inspection. Use `kind: "other"` for
|
|
197
|
+
findings of this type (Step 4's closed vocabulary has no dedicated kind for it).
|
|
198
|
+
13. **No CI-status criterion**: no bead in the plan (task, feature or bug) may carry an
|
|
199
|
+
acceptance criterion that depends on a CI run -- "CI is green", "the CI workflow
|
|
200
|
+
passes on every OS", "the pipeline succeeds". Doers and reviewers do not trigger,
|
|
201
|
+
wait for or judge CI, so such a criterion cannot be closed inside the sprint and
|
|
202
|
+
stalls it. A plan that puts a CI-status criterion on any bead is CHANGES_NEEDED
|
|
203
|
+
referencing "criterion 13" and naming the bead id and the offending criterion text;
|
|
204
|
+
the fix is to replace it with what can be checked locally (build, lint, the tests a
|
|
205
|
+
doer can run). Use `kind: "acceptance_criteria"` for this finding.
|
|
129
206
|
|
|
130
207
|
## Step 3 -- Classify each task
|
|
131
208
|
|
|
@@ -141,21 +218,48 @@ For each open `type=task` issue, determine:
|
|
|
141
218
|
criterion 10 as a CHANGES_NEEDED finding -- the fallback lets you finish
|
|
142
219
|
classification, it does not excuse the planner.
|
|
143
220
|
|
|
221
|
+
Compare your bucket with the task's recorded `size`. Agreement, or a one-step difference
|
|
222
|
+
(S/M or M/L), needs no action. A two-step disagreement -- your bucket `L` against a
|
|
223
|
+
recorded `size` of `S`, or the reverse -- is a finding under criterion 4
|
|
224
|
+
(`kind: "task_size"`), not a silent override.
|
|
225
|
+
|
|
144
226
|
## Step 4 -- Output verdict
|
|
145
227
|
|
|
146
228
|
Return your verdict:
|
|
147
229
|
- `verdict`: `"APPROVED"` or `"CHANGES_NEEDED"` (exact strings -- the machine-readable
|
|
148
230
|
enum in the output schema uses the underscore form, never "CHANGES NEEDED" with a space)
|
|
149
231
|
- `notes`: specific, actionable findings referencing beads IDs
|
|
232
|
+
- `findings`: array with one entry per bead that must change -- `{ id, kind, detail }`.
|
|
233
|
+
`id` is the bead, written exactly as it appears in `taskAssignments`. `kind` is a closed
|
|
234
|
+
vocabulary naming the criterion that failed, one of `coverage`, `missing_test_task`,
|
|
235
|
+
`acceptance_criteria`, `task_size`, `dependency_wiring`, `scope_creep`, `duplicate_work`,
|
|
236
|
+
`feasibility`, `ready_work`, `model_metadata`, `lane_cohesion`, `other` -- in the order of
|
|
237
|
+
the numbered criteria in Step 2, with `other` covering both criterion 12
|
|
238
|
+
(NOTES-vs-child contradiction) and any failure none of the listed kinds describes.
|
|
239
|
+
`detail` is the human explanation for that bead.
|
|
150
240
|
- `taskAssignments`: array with one entry per open task -- `{ id, bucket, model }`
|
|
151
241
|
|
|
152
|
-
|
|
242
|
+
`notes` must also state the expected number of review rounds (the longest chain of lanes
|
|
243
|
+
joined by `blocks` edges) so the orchestrator can see review cadence before development
|
|
244
|
+
starts.
|
|
245
|
+
|
|
246
|
+
**APPROVED** means all thirteen criteria in Step 2 pass.
|
|
153
247
|
|
|
154
248
|
**CHANGES_NEEDED** means one or more criteria fail. Notes must name the specific beads ID
|
|
155
|
-
and what is wrong. Do not return CHANGES_NEEDED for minor style preferences
|
|
249
|
+
and what is wrong. Do not return CHANGES_NEEDED for minor style preferences -- but a plan
|
|
250
|
+
that is correct yet needs more review rounds than necessary (lanes that should be merged
|
|
251
|
+
per criterion 11's under-batched-lanes check) IS CHANGES_NEEDED, not a style preference.
|
|
156
252
|
|
|
157
253
|
Always populate `taskAssignments` even on CHANGES_NEEDED -- cost estimation uses it regardless.
|
|
158
254
|
|
|
255
|
+
Always populate `findings` on every CHANGES_NEEDED verdict, for the same reason: it is the
|
|
256
|
+
machine-readable channel a caller routes on, so an objection that exists only in `notes` is
|
|
257
|
+
an objection the caller cannot act on. One entry per bead you are objecting to. If the
|
|
258
|
+
objection is genuinely plan-wide and names no individual bead, return `findings: []` and
|
|
259
|
+
explain it in `notes` -- the empty array is the explicit "plan-wide" signal, not an
|
|
260
|
+
oversight. On APPROVED, omit `findings` or return `[]`. `notes` remains the narration
|
|
261
|
+
channel and must stay readable on its own; `findings` does not replace it.
|
|
262
|
+
|
|
159
263
|
## Output schema
|
|
160
264
|
|
|
161
265
|
The canonical machine-readable contract for this output lives in the sibling file
|
|
@@ -165,10 +269,15 @@ placeholder):
|
|
|
165
269
|
```json
|
|
166
270
|
{
|
|
167
271
|
"verdict": "CHANGES_NEEDED",
|
|
168
|
-
"notes": "BD-14 missing [test] task; BD-22 has no model tier metadata set",
|
|
272
|
+
"notes": "Expected review rounds: 2. BD-14 missing [test] task; BD-22 has no model tier metadata set",
|
|
273
|
+
"findings": [
|
|
274
|
+
{ "id": "BD-14", "kind": "missing_test_task", "detail": "Feature has an [impl] task but no [test] task covering it." },
|
|
275
|
+
{ "id": "BD-22", "kind": "model_metadata", "detail": "No model key in beads metadata; classified as standard under the Step 3 fallback." }
|
|
276
|
+
],
|
|
169
277
|
"taskAssignments": [
|
|
170
278
|
{ "id": "BD-10", "bucket": "M", "model": "standard" },
|
|
171
|
-
{ "id": "BD-14", "bucket": "S", "model": "cheap" }
|
|
279
|
+
{ "id": "BD-14", "bucket": "S", "model": "cheap" },
|
|
280
|
+
{ "id": "BD-22", "bucket": "S", "model": "standard" }
|
|
172
281
|
]
|
|
173
282
|
}
|
|
174
283
|
```
|
|
@@ -187,3 +296,7 @@ or as prose if you are answering a human directly.
|
|
|
187
296
|
- NEVER write feedback.md or PLAN.md
|
|
188
297
|
- NEVER compute any USD costs or token totals -- that is done in JavaScript by the workflow
|
|
189
298
|
- Be specific: "BD-14 missing [test] task" beats "some features have no tests"
|
|
299
|
+
|
|
300
|
+
## Shell command discipline
|
|
301
|
+
|
|
302
|
+
No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.
|
package/dist/agents/planner.md
CHANGED
|
@@ -28,43 +28,56 @@ 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 (
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
31
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
32
|
+
|
|
33
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
34
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
35
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
36
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
37
|
+
the orchestrator fetched for the sprint goals/requirements you are about to decompose.
|
|
38
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
39
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
40
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
41
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
42
|
+
|
|
43
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
44
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
45
|
+
|
|
46
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
47
|
+
derived from the sprint goals / requirements you are about to decompose.
|
|
48
|
+
2. From whichever source you have (a live `kb_session_prime` result, the injected
|
|
49
|
+
block, or both), read every entry. Treat INFERRED as a strong hint but verify it
|
|
50
|
+
against source before baking it into a task description (an INFERRED entry may be an
|
|
51
|
+
unvalidated in-flight capture). Let prior sprint knowledge inform your planning:
|
|
42
52
|
- **CONFIRMED coverage** on a symbol -> well-understood code, may lean toward a
|
|
43
53
|
lighter model tier. Note it in the task description so the doer knows to
|
|
44
54
|
retrieve from the KB first instead of re-deriving it from source.
|
|
45
|
-
- **No KB entries** for a symbol
|
|
46
|
-
|
|
55
|
+
- **No KB entries** for a symbol (in the live result, or -- without the tools -- in
|
|
56
|
+
the injected block; never inferred from a tool failure) -> unexplored
|
|
57
|
+
territory, front-load as Task 1 and lean toward a stronger model tier.
|
|
47
58
|
- **Non-obvious constraints** in KB entries (e.g. "init() must be called before
|
|
48
59
|
query", "jitter applied after maxDelayMs cap") -> copy them verbatim into the
|
|
49
60
|
relevant task description so the doer does not rediscover them.
|
|
50
|
-
3. Quantify the assignment: call `
|
|
51
|
-
sprint's tasks will actually touch and use the returned
|
|
52
|
-
sharpen the qualitative judgment above into a number (see
|
|
53
|
-
in Step 3 for the thresholds and how to record it).
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
4.
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
61
|
+
3. Quantify the assignment when `kb_stats` is present: call `kb_stats` with the key
|
|
62
|
+
symbols the sprint's tasks will actually touch and use the returned
|
|
63
|
+
`coverage.fraction` to sharpen the qualitative judgment above into a number (see
|
|
64
|
+
"Model assignment rules" in Step 3 for the thresholds and how to record it). When
|
|
65
|
+
`kb_stats` is absent or fails, skip the quantitative step and rely on the
|
|
66
|
+
qualitative KB signals above instead.
|
|
67
|
+
4. This role has no KB-capture channel: note a genuinely durable, non-obvious finding --
|
|
68
|
+
or a KB entry that proved wrong in practice -- in your own report.
|
|
69
|
+
|
|
70
|
+
### Persistent Memories (operational rules)
|
|
71
|
+
|
|
72
|
+
Before starting sprint planning, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
bd memories --json +all+
|
|
76
|
+
bd memories --json +planner+
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
80
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+planner+`.
|
|
68
81
|
|
|
69
82
|
## Step 1 -- Explore the backlog
|
|
70
83
|
|
|
@@ -96,6 +109,23 @@ anywhere in the title, so the doubled `[regression][carry-over]` prefix is found
|
|
|
96
109
|
extra quoting; and it EXCLUDES closed issues by default -- add `--status all` only when
|
|
97
110
|
auditing history.
|
|
98
111
|
|
|
112
|
+
**Read NOTES before decomposing.** Before decomposing any bead -- sprint goal, feature,
|
|
113
|
+
or task -- that has a non-empty NOTES section, read NOTES in full, in chronological
|
|
114
|
+
order, as part of understanding the bead's current scope, not merely as optional
|
|
115
|
+
background context. A bead's NOTES section functions as an append-only changelog:
|
|
116
|
+
corrections, amendments, and design-review findings accumulate there over the bead's
|
|
117
|
+
lifetime, often after its DESCRIPTION was written. Treat a NOTES entry that explicitly
|
|
118
|
+
corrects, amends, or supersedes something in DESCRIPTION -- recognizable by language such
|
|
119
|
+
as "CORRECTION", "AMENDMENT", "SUPERSEDES", "REVISED", or an explicit "do X, not Y"
|
|
120
|
+
statement -- as authoritative over the DESCRIPTION passage it contradicts. When writing a
|
|
121
|
+
child's own DESCRIPTION/acceptance criteria (Steps 2 and 3 below), do not copy stale
|
|
122
|
+
DESCRIPTION language verbatim if a later NOTES entry corrected it -- write the child from
|
|
123
|
+
the corrected understanding. It is fine, and often preferable, for the child to
|
|
124
|
+
explicitly cite which correction it incorporates, so a later reader does not need to
|
|
125
|
+
cross-reference the parent's full history. This does not change how you decompose a bead
|
|
126
|
+
whose NOTES is empty or purely procedural (e.g. claim/close log lines) -- it applies only
|
|
127
|
+
when NOTES contains substantive corrections to DESCRIPTION.
|
|
128
|
+
|
|
99
129
|
## Step 2 -- Decompose sprint goals into features
|
|
100
130
|
|
|
101
131
|
Every title you write below (Steps 2 and 3) is plain text only -- letters,
|
|
@@ -103,6 +133,13 @@ digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -`. No backticks, double
|
|
|
103
133
|
quotes, `$`, or backslash (shell-interpolated by `bd create`); put any
|
|
104
134
|
command/flag/filename formatting in the description instead.
|
|
105
135
|
|
|
136
|
+
Execute each `bd create`, `bd update`, or `bd dep` command directly as an
|
|
137
|
+
individual tool call through your shell/command tool. Never author or execute
|
|
138
|
+
intermediate shell script files (such as `cat << 'EOF' > script.sh` or writing
|
|
139
|
+
`.sh` files to disk) to batch commands -- planning dispatches operate with
|
|
140
|
+
read-mostly permissions and do not permit writing executable scripts to the
|
|
141
|
+
workspace.
|
|
142
|
+
|
|
106
143
|
For each sprint goal create type=feature issues as direct children:
|
|
107
144
|
- Title: a concrete deliverable ("User can reset password via email")
|
|
108
145
|
- Description: what done looks like, who uses it, acceptance criteria
|
|
@@ -121,7 +158,11 @@ making them independent siblings.
|
|
|
121
158
|
For each feature create two classes of tasks:
|
|
122
159
|
|
|
123
160
|
**Implementation tasks** (`[impl]` prefix optional but helpful):
|
|
124
|
-
- One task per
|
|
161
|
+
- One task per independently verifiable change. A task is the unit the doer commits and
|
|
162
|
+
closes; the LANE (below) is the unit the reviewer reviews. Keep a task small enough to
|
|
163
|
+
have crisp acceptance criteria (typically 1-4 files), but do NOT split a change into
|
|
164
|
+
several tasks just to keep each one small -- a chain of tiny dependent tasks is more
|
|
165
|
+
expensive to review than one lane that holds them together.
|
|
125
166
|
- Title: specific and imperative ("Add password reset endpoint to auth router")
|
|
126
167
|
- Description includes: expected files to change, expected behaviour, acceptance
|
|
127
168
|
criteria. The file list is a best-effort scope estimate, NOT an allowlist -- phrase it
|
|
@@ -145,6 +186,14 @@ For each feature create two classes of tasks:
|
|
|
145
186
|
(architecture, docs, UX judgment).
|
|
146
187
|
- Priority: same as its feature
|
|
147
188
|
|
|
189
|
+
**No CI-status criteria in the plan**: never write an acceptance criterion that
|
|
190
|
+
depends on a CI run ("CI is green", "the CI workflow passes on every OS") on any
|
|
191
|
+
task, feature or bug you create. Doers and reviewers do not trigger, wait for, or
|
|
192
|
+
judge CI; such a criterion cannot be closed inside the sprint and stalls it. State
|
|
193
|
+
what can be checked locally instead (build, lint, the tests a doer can run itself).
|
|
194
|
+
If a scope bead carries a CI-status criterion, plan the locally checkable work for
|
|
195
|
+
it and leave the CI part out of every task.
|
|
196
|
+
|
|
148
197
|
**Model tier** (required on every task, both impl and test): set the model tier as beads
|
|
149
198
|
metadata at creation time, not in `--notes`:
|
|
150
199
|
```bash
|
|
@@ -182,35 +231,75 @@ Pick from the models actually available in the current environment. A user overr
|
|
|
182
231
|
always wins.
|
|
183
232
|
|
|
184
233
|
**Streak lane metadata** (required on every task, both impl and test): in addition to
|
|
185
|
-
`model`, record
|
|
234
|
+
`model`, record three lane fields through the SAME beads metadata channel at creation time --
|
|
186
235
|
never in `--notes`, a METADATA-section comment, or anywhere else:
|
|
187
236
|
```bash
|
|
188
|
-
bd create ... --metadata '{"model": "<cheap|standard|premium>", "streak": "<lane-id>", "streakOrder": <n>}'
|
|
237
|
+
bd create ... --metadata '{"model": "<cheap|standard|premium>", "size": "<S|M|L>", "streak": "<lane-id>", "streakOrder": <n>}'
|
|
189
238
|
```
|
|
190
239
|
- `streak` -- a stable lane identifier (any short opaque string) shared by every task to
|
|
191
240
|
be dispatched together to a single doer; read back via `bd show <id>` like `model`.
|
|
192
241
|
- `streakOrder` -- an integer giving this task's intended position within its lane. Lower
|
|
193
|
-
runs first; ties
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
242
|
+
runs first; ties break by insertion order -- do NOT use a `blocks` edge to break an
|
|
243
|
+
intra-lane tie (see the dependency-wiring rules below).
|
|
244
|
+
- `size` -- `S`/`M`/`L`, used for lane sizing below.
|
|
245
|
+
|
|
246
|
+
**Lanes are review units.** The engine dispatches every task in one lane to ONE doer in
|
|
247
|
+
`streakOrder`, and the reviewer reviews a whole Develop ROUND at once -- every lane
|
|
248
|
+
dispatched in that round together. A lane is therefore the SMALLEST thing a review can
|
|
249
|
+
cover: never split one coherent increment across two lanes joined by a `blocks` edge,
|
|
250
|
+
because each extra link in that chain costs a full review round (diff read + full test
|
|
251
|
+
run). Lanes with no `blocks` edge between them dispatch and review in the SAME round
|
|
252
|
+
whenever the round's doer count and effort budget allow (unlaned-but-independent lanes
|
|
253
|
+
overflow to the next round only under doer/budget pressure, not because they were kept
|
|
254
|
+
separate), so normally that costs nothing extra -- keep genuinely independent work in
|
|
255
|
+
separate lanes rather than merging it for size alone; merging removes parallelism without
|
|
256
|
+
reliably saving a review.
|
|
257
|
+
|
|
258
|
+
Put tasks in the SAME lane when they are highly coupled or cohesive -- any of:
|
|
259
|
+
- they touch the same files, module, or component, or the same test suite;
|
|
260
|
+
- one exists to enable the next (add a helper, then use it; change a schema, then its
|
|
261
|
+
consumer; implement, then its `[test]` task) -- an `[impl]` task and its paired `[test]`
|
|
262
|
+
task ALWAYS share a lane, UNLESS the feature's impl work itself had to span multiple
|
|
263
|
+
lanes under the sizing rules below -- then the feature's `[test]` task takes the LAST
|
|
264
|
+
impl lane, or ends its own final lane wired cross-lane to every impl lane it verifies;
|
|
265
|
+
- they contend for a **mutex resource** -- a resource only one change may hold at a time,
|
|
266
|
+
e.g. the same submodule pointer, a shared version/manifest field, or the same test
|
|
267
|
+
fixture -- these MUST share a lane and MUST NOT be separated into different streaks;
|
|
268
|
+
- reviewing one without the other would leave the reviewer unable to judge whether the
|
|
269
|
+
feature actually works.
|
|
270
|
+
|
|
271
|
+
Put tasks in DIFFERENT lanes only when at least one of these holds:
|
|
272
|
+
- they are genuinely independent (different feature areas, no shared files, no enabling
|
|
273
|
+
relationship) -- so multiple doers can run them in parallel;
|
|
274
|
+
- they sit on different sides of a RISK BOUNDARY: a change the reviewer must sign off
|
|
275
|
+
before further work is safe to build on (a public contract change, a data migration, a
|
|
276
|
+
security-sensitive path, a destructive operation);
|
|
277
|
+
- a later task cannot be reviewed until the earlier one's outcome has been judged (true
|
|
278
|
+
design uncertainty) -- write the later task's criteria as conditional on that outcome,
|
|
279
|
+
not left blank, and state the dependency explicitly in its description so the criteria
|
|
280
|
+
are never read as unconditional; the earlier task ends its lane, and the later one
|
|
281
|
+
starts a new lane in the next round;
|
|
282
|
+
- the lane would exceed the sizing limits below.
|
|
283
|
+
|
|
284
|
+
**Sizing a lane.** Size buckets are the same ones the plan reviewer classifies with:
|
|
285
|
+
S = 1 file/narrow, M = 2-3 files/moderate logic, L = 3+ files or non-trivial design (see
|
|
286
|
+
the `bd create ... --metadata` example above -- `size` is recorded there, alongside
|
|
287
|
+
`model`/`streak`/`streakOrder`, not as a separate call). Then check each lane against
|
|
288
|
+
these LANE SIZING PARAMETERS (fixed defaults for now -- no per-dispatch override channel
|
|
289
|
+
exists yet):
|
|
290
|
+
- `laneMaxTasks` (default `6`): hard cap on tasks per lane -- a reviewer must be able to
|
|
291
|
+
verify the whole lane in one pass.
|
|
292
|
+
- `laneMaxEffort` (default `200`): `effort = (sum of size points S=1/M=2/L=4) x (max model
|
|
293
|
+
weight in the lane, cheap=1/standard=10/premium=20)`; caps one doer session's load.
|
|
294
|
+
- `laneTargetEffort` (default `60`): a lane BELOW this that has a cohesive neighbour (per
|
|
295
|
+
the SAME-lane rules above) should be MERGED with it, not left as its own review round.
|
|
296
|
+
State in the lane's first task description why a lane was left below target if it was.
|
|
297
|
+
|
|
298
|
+
A lane over either cap is split ONLY at a point where the earlier part is a self-contained,
|
|
299
|
+
reviewable increment (never mid-refactor, never between mutex-resource members). An
|
|
300
|
+
`[impl]` lane may be split from its feature's `[test]` task ONLY as the exception above
|
|
301
|
+
describes -- the test task then ends the chain, cross-lane blocked on every impl lane it
|
|
302
|
+
verifies; it is never itself mid-split. Give each part its own `streak` id and renumber
|
|
214
303
|
`streakOrder` from the start within it.
|
|
215
304
|
|
|
216
305
|
Wire dependencies (semantics: `bd dep add A B` means A is blocked by B -- B must finish before A can close):
|
|
@@ -218,9 +307,16 @@ Wire dependencies (semantics: `bd dep add A B` means A is blocked by B -- B must
|
|
|
218
307
|
do NOT `bd dep add <feature-id> <impl-task>` or `<feature-id> <test-task>`; a feature's
|
|
219
308
|
"not done until its tasks close" status comes from its children, never from a `blocks`
|
|
220
309
|
edge back onto them)
|
|
221
|
-
-
|
|
222
|
-
|
|
223
|
-
-
|
|
310
|
+
- INSIDE a lane, order comes from `streakOrder` ONLY. Do NOT add a `blocks` edge between
|
|
311
|
+
two tasks in the same lane -- the engine dispatches only currently-unblocked tasks, so an
|
|
312
|
+
intra-lane edge would push the later task into a separate review round and silently
|
|
313
|
+
defeat the lane. This includes the `[test]` task: it follows its `[impl]` task by
|
|
314
|
+
`streakOrder`, not by an edge.
|
|
315
|
+
- BETWEEN lanes, order comes from `blocks` edges: when lane B must not start until lane A
|
|
316
|
+
is done, add `bd dep add <B-task> <A-last-task>` for EVERY task in lane B against the
|
|
317
|
+
LAST (highest `streakOrder`) task of lane A. Wiring only B's first task would let B's
|
|
318
|
+
later tasks become ready out of order.
|
|
319
|
+
- Sibling tasks in different lanes with no enabling relationship get no edge.
|
|
224
320
|
|
|
225
321
|
## Step 4 -- Validate your own DAG
|
|
226
322
|
|
|
@@ -257,11 +353,18 @@ direction, and re-run the scoped `--ready` query to confirm issues are unblocked
|
|
|
257
353
|
Also check each open feature:
|
|
258
354
|
- Has at least one [impl] task AND one [test] task?
|
|
259
355
|
- Every task description has clear acceptance criteria?
|
|
260
|
-
-
|
|
261
|
-
|
|
262
|
-
-
|
|
263
|
-
|
|
264
|
-
|
|
356
|
+
- Every task carries `model`, `size`, `streak`, `streakOrder` metadata via `--metadata`
|
|
357
|
+
(see Step 3) -- never `--notes`?
|
|
358
|
+
- Does every lane hold ONE reviewable increment (impl + its test, all mutex members, all
|
|
359
|
+
enabling chains), within `laneMaxTasks` / `laneMaxEffort`?
|
|
360
|
+
- Is every lane below `laneTargetEffort` either justified in its first task description or
|
|
361
|
+
merged with a cohesive neighbour?
|
|
362
|
+
- Is there NO `blocks` edge between two tasks that share a `streak` id?
|
|
363
|
+
- Does every cross-lane `blocks` edge target the upstream lane's LAST task and originate
|
|
364
|
+
from EVERY task of the downstream lane?
|
|
365
|
+
- Expected review rounds (= longest chain of lanes joined by `blocks` edges): state the
|
|
366
|
+
number in your `notes`. If it exceeds 3 for one sprint goal, re-examine whether the
|
|
367
|
+
chain can be shortened by merging lanes.
|
|
265
368
|
- Where `kb_stats` backed a model tier choice, does the task description cite the
|
|
266
369
|
coverage number (see Step 3)? Not required for tiers set on qualitative KB signals
|
|
267
370
|
alone or when `kb_stats` was unavailable.
|
|
@@ -285,12 +388,13 @@ dependency edges), which `plan-reviewer` evaluates against its own Output schema
|
|
|
285
388
|
In addition, return a structured result matching the sibling file
|
|
286
389
|
`agents/schemas/planner-output.json`: `status` (`OK` or `BLOCKED`), `notes`, the
|
|
287
390
|
`featureIds`/`taskIds` you created or updated this round, and an optional `kb_captures`
|
|
288
|
-
array (see Step 0.4 --
|
|
391
|
+
array (see Step 0.4) -- the engine does not read or apply this field for the planner
|
|
392
|
+
role today, so always omit it or send `[]`. Example instance:
|
|
289
393
|
|
|
290
394
|
```json
|
|
291
395
|
{
|
|
292
396
|
"status": "OK",
|
|
293
|
-
"notes": "Created 2 features, 6 tasks across 3 streak lanes.",
|
|
397
|
+
"notes": "Created 2 features, 6 tasks across 3 streak lanes; expected review rounds: 2.",
|
|
294
398
|
"featureIds": ["BD-20", "BD-21"],
|
|
295
399
|
"taskIds": ["BD-22", "BD-23", "BD-24", "BD-25", "BD-26", "BD-27"],
|
|
296
400
|
"kb_captures": []
|
|
@@ -299,12 +403,19 @@ array (see Step 0.4 -- omit or send `[]` to capture nothing). Example instance:
|
|
|
299
403
|
|
|
300
404
|
## Rules
|
|
301
405
|
|
|
406
|
+
- NEVER write output schema files (e.g. planner-output.json) to disk -- emit the JSON result object directly in your final response text
|
|
302
407
|
- NEVER create PLAN.md or progress.json
|
|
303
408
|
- NEVER close any issues -- you only create and link
|
|
304
409
|
- NEVER add scope beyond the sprint goals you were given and open bugs/features
|
|
305
410
|
- Every task must be completable in one agent session
|
|
306
411
|
- A task with no acceptance criteria is incomplete -- fix it before finishing
|
|
307
|
-
- Every task must carry
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
412
|
+
- Every task must carry `model`, `size`, `streak` and `streakOrder` in the SAME
|
|
413
|
+
`--metadata` channel at creation time -- never `--notes` -- fix before finishing
|
|
414
|
+
- Lanes must respect `laneMaxEffort`/`laneMaxTasks` and never split mutex-resource members
|
|
415
|
+
apart
|
|
416
|
+
- Never place a `blocks` edge between two tasks that share a `streak` id -- it silently
|
|
417
|
+
defeats the lane by pushing the later task into a separate review round
|
|
418
|
+
|
|
419
|
+
## Shell command discipline
|
|
420
|
+
|
|
421
|
+
No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.
|