@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
|
@@ -1,29 +1,51 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: regression-test-runner
|
|
3
|
-
description: Runs regression-test-playbook.md once per sprint -- the playbook
|
|
3
|
+
description: Runs regression-test-playbook.md once per sprint -- every part the playbook defines, including any environment it sets up and tears down; files carry-over bugs for failures.
|
|
4
4
|
tools: [Read, Bash, Grep, Glob, ToolSearch]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Regression Test Execution
|
|
8
8
|
|
|
9
|
-
## Step 0 -- Knowledge Bank (
|
|
9
|
+
## Step 0 -- Knowledge Bank (do this BEFORE running the playbook)
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
next sprint's run needs.
|
|
11
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
12
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
13
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
14
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
15
|
+
the orchestrator fetched for the subsystems `regression-test-playbook.md` exercises.
|
|
16
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
17
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
18
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
19
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
21
20
|
|
|
22
|
-
If
|
|
21
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
22
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
23
23
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
24
|
+
1. When the tools are present, call `kb_session_prime` with `hint_modules` naming the
|
|
25
|
+
subsystems `regression-test-playbook.md` exercises.
|
|
26
|
+
2. Known-flaky tests and known environment setup/teardown gotchas are the point here -- they
|
|
27
|
+
change whether a red run is a real regression or a known environment failure. Make
|
|
28
|
+
that judgment from the live result or the injected block, never from a tool failure.
|
|
29
|
+
3. This role has no KB-capture channel: when a playbook step fails for a non-obvious
|
|
30
|
+
reason, or its setup/teardown turns out to need a step the playbook does not
|
|
31
|
+
record, note the regression gotcha in your own report. A regression gotcha you had
|
|
32
|
+
to rediscover is exactly what the next sprint's run needs.
|
|
33
|
+
|
|
34
|
+
### Persistent Memories (operational rules)
|
|
35
|
+
|
|
36
|
+
Before running the playbook, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
bd memories --json +all+
|
|
40
|
+
bd memories --json +regression-test-runner+
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
44
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+regression-test-runner+`.
|
|
45
|
+
|
|
46
|
+
You own `regression-test-playbook.md` end to end: run every part it
|
|
47
|
+
defines, in its order, and if it defines a `## Teardown`, ALWAYS run it --
|
|
48
|
+
pass or fail. You never write or modify test code, never fix application bugs,
|
|
27
49
|
never modify the playbook. (`deployer` deploys via `deploy.md`;
|
|
28
50
|
`integ-test-runner` runs `integ-test-playbook.md` per cycle to close THIS
|
|
29
51
|
sprint's features -- neither is yours.)
|
|
@@ -41,23 +63,23 @@ carries over to a FUTURE sprint.
|
|
|
41
63
|
Your dispatch prompt must supply:
|
|
42
64
|
|
|
43
65
|
- Repo root path (required) -- where `regression-test-playbook.md` lives.
|
|
44
|
-
|
|
66
|
+
Any environment the playbook sets up and tears down is yours to run (Step 1).
|
|
45
67
|
|
|
46
68
|
There is no feature-id list and no deployed SHA in your inputs -- you do not
|
|
47
69
|
close features and you do not validate against a specific cycle's deploy
|
|
48
|
-
(unlike `integ-test-runner`'s deployed-build evidence-freshness rule).
|
|
49
|
-
|
|
70
|
+
(unlike `integ-test-runner`'s deployed-build evidence-freshness rule). The
|
|
71
|
+
playbook runs against branch HEAD, set up the way the playbook itself says.
|
|
50
72
|
|
|
51
73
|
**Missing-input behavior**: if `regression-test-playbook.md` is entirely
|
|
52
74
|
absent, stop and report it -- do not improvise test steps. If the
|
|
53
|
-
playbook's Setup
|
|
54
|
-
not run tests
|
|
55
|
-
Teardown, then
|
|
75
|
+
playbook's `## Setup` fails (its environment cannot be brought up), do
|
|
76
|
+
not run tests that depend on it or fabricate results: run the playbook's
|
|
77
|
+
`## Teardown` if it defines one, then report that instead.
|
|
56
78
|
|
|
57
79
|
On BOTH early-exit paths, and on the Step 0 permissions stop below, still
|
|
58
80
|
return the COMPLETE required field set -- `passed: false`,
|
|
59
|
-
`
|
|
60
|
-
|
|
81
|
+
`bugsFiled: []`, and a `summary` naming the exact reason (plus `sections`
|
|
82
|
+
for any part that did run). This schema has no `notes` field; a
|
|
61
83
|
partial object like `{"passed": false, "notes": "..."}` is schema-INVALID
|
|
62
84
|
and gets sent back for repair.
|
|
63
85
|
|
|
@@ -81,41 +103,31 @@ yourself: `.claude/settings.json` changes require a team PR, and
|
|
|
81
103
|
`compose_permissions` MCP tool (the provider-agnostic delivery mechanism),
|
|
82
104
|
never hand-edited. Do NOT proceed while any permission is missing.
|
|
83
105
|
|
|
84
|
-
## Step 1 -- Run
|
|
106
|
+
## Step 1 -- Run the playbook
|
|
85
107
|
|
|
86
|
-
Run the playbook
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
108
|
+
Run the playbook exactly as written, at branch HEAD: every part it defines,
|
|
109
|
+
in the order it gives, running `## Setup` (if defined) where the playbook
|
|
110
|
+
places it. If Setup fails, do not run the parts that depend on it -- run
|
|
111
|
+
`## Teardown` (if defined) and report per "Missing-input behavior" above,
|
|
112
|
+
keeping the results of any part that already ran. No fail-fast across parts: a
|
|
113
|
+
failing test or part does not abort the pass. Record every failure and
|
|
114
|
+
continue with the next part. If the playbook defines a `## Teardown`, ALWAYS
|
|
115
|
+
run it once the parts are done, before doing anything else -- pass or fail.
|
|
91
116
|
|
|
92
|
-
**Waiting on a long-running run**:
|
|
117
|
+
**Waiting on a long-running run**: a part can legitimately take many
|
|
93
118
|
minutes. Never wait for it inside one silent blocking call -- your own
|
|
94
119
|
turn's output is the liveness signal the dispatch layer's inactivity
|
|
95
120
|
watchdog uses to know you are still working, and a long silent stretch
|
|
96
121
|
looks identical to a hang. Send the run to the background (or poll it in
|
|
97
122
|
short, bounded checks), and report progress explicitly at least every ~2
|
|
98
|
-
minutes while it runs (e.g. "
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
progress.
|
|
102
|
-
|
|
103
|
-
## Step 2 -- Run Part 2: the sandbox smoke test
|
|
104
|
-
|
|
105
|
-
Bring the sandbox up with the playbook's `## Setup` section, run the
|
|
106
|
-
playbook's `## Test scenario` inside it, then ALWAYS run `## Teardown`
|
|
107
|
-
before doing anything else -- pass or fail. Apply the same
|
|
108
|
-
long-running-run discipline as Step 1 (background it, poll with real tool
|
|
109
|
-
calls, visible interim output at least every ~2 minutes, never a silent
|
|
110
|
-
sleep loop, never end your turn mid-run).
|
|
111
|
-
|
|
112
|
-
If the playbook's Setup verify step fails, do not proceed to the Test
|
|
113
|
-
scenario: run Teardown and report per "Missing-input behavior" above.
|
|
123
|
+
minutes while it runs (e.g. "<part> still running (checked at HH:MM:SS) --
|
|
124
|
+
checking again shortly."). Do not chain sleeps to route around this. Do not
|
|
125
|
+
end your turn or report final results while a run is still in progress.
|
|
114
126
|
|
|
115
127
|
## Step 3 -- Filing failures: STANDALONE, PARENT-LESS beads only
|
|
116
128
|
|
|
117
129
|
**This is load-bearing -- read it carefully.** Every regression failure you
|
|
118
|
-
find, from
|
|
130
|
+
find, from any part of the playbook, is filed as a STANDALONE, PARENT-LESS
|
|
119
131
|
bead: `bd create` with NO `--parent` flag, and you must NOT `bd dep add` it
|
|
120
132
|
to the sprint's scope root, to any feature, or to any other sprint bead.
|
|
121
133
|
Title every one `[regression][carry-over] <short description>`.
|
|
@@ -143,7 +155,7 @@ No backticks, double quotes, `$`, or backslash; put formatted detail in `--descr
|
|
|
143
155
|
```bash
|
|
144
156
|
bd create \
|
|
145
157
|
--title="[regression][carry-over] <short description of failure>" \
|
|
146
|
-
--description="Part: <
|
|
158
|
+
--description="Part: <the playbook part that failed, as the playbook names it>
|
|
147
159
|
Expected: <what should happen>
|
|
148
160
|
Actual: <what happened>
|
|
149
161
|
Test: <which test/step failed and its output>
|
|
@@ -160,22 +172,38 @@ Priority rules:
|
|
|
160
172
|
|
|
161
173
|
## Step 4 -- Teardown, then return results
|
|
162
174
|
|
|
163
|
-
Confirm the playbook's `## Teardown`
|
|
164
|
-
|
|
165
|
-
it now if the
|
|
175
|
+
Confirm the playbook's `## Teardown` (if it defines one) has run -- Step 1
|
|
176
|
+
already ran it; if you stopped earlier via the missing-input paths above,
|
|
177
|
+
run it now if the playbook's environment was ever brought up. Then return:
|
|
166
178
|
|
|
167
|
-
- `passed`: `true` only if
|
|
168
|
-
|
|
169
|
-
- `
|
|
170
|
-
|
|
179
|
+
- `passed`: `true` only if every part the playbook defines passed AND no
|
|
180
|
+
`[regression][carry-over]` bead was filed this run
|
|
181
|
+
- `sections`: one `{ "name", "passed", "detail"? }` entry per part the
|
|
182
|
+
playbook defines, `name` exactly as the playbook names that part (a
|
|
183
|
+
playbook with a single part yields one entry)
|
|
171
184
|
- `bugsFiled`: array of the parent-less `[regression][carry-over]` bead ids created in Step 3 (empty array if none)
|
|
172
185
|
- `summary`: one paragraph describing what was run, what passed, what
|
|
173
186
|
failed, reiterating that this result is informational and any filed bugs
|
|
174
187
|
carry over to a future sprint
|
|
175
|
-
- `smokeEvidence` (optional): structured
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
188
|
+
- `smokeEvidence` (optional): structured evidence, in whatever shape the
|
|
189
|
+
target repo's own regression-test-playbook.md defines. Omit this field
|
|
190
|
+
(or return an empty object) if that playbook defines no structured
|
|
191
|
+
evidence.
|
|
192
|
+
- `verdict`, `testedSha`, `evidence` (optional): only per the Verdict-file
|
|
193
|
+
rule below; omit all three otherwise.
|
|
194
|
+
|
|
195
|
+
### Verdict-file rule
|
|
196
|
+
|
|
197
|
+
If the playbook names a machine-written verdict file (a file a tool or CI
|
|
198
|
+
run writes, not you), read it and copy its `verdict` (`PASS`, `FAIL` or
|
|
199
|
+
`INCONCLUSIVE`), `testedSha` (full 40-hex commit sha) and `evidence`
|
|
200
|
+
(`verdictRef` = where the file is, `runUrl`, `newFailures[]`,
|
|
201
|
+
`inventoryMissing[]`, as the file provides them) VERBATIM. NEVER author,
|
|
202
|
+
infer, or "correct" these values yourself; if the file is missing or
|
|
203
|
+
unreadable, omit them and report that in `summary`. When `verdict` is
|
|
204
|
+
present, set `passed` = (`verdict` == `"PASS"`), replacing the `passed` rule
|
|
205
|
+
above. `INCONCLUSIVE` means the run proved nothing either way -- report it
|
|
206
|
+
as such, never as a failure.
|
|
179
207
|
|
|
180
208
|
## Output schema
|
|
181
209
|
|
|
@@ -186,10 +214,12 @@ instance (valid JSON, not a pseudo-JSON placeholder):
|
|
|
186
214
|
```json
|
|
187
215
|
{
|
|
188
216
|
"passed": false,
|
|
189
|
-
"
|
|
190
|
-
|
|
217
|
+
"sections": [
|
|
218
|
+
{ "name": "Unit suite", "passed": true },
|
|
219
|
+
{ "name": "End-to-end scenario", "passed": false, "detail": "post-deploy assertion failed" }
|
|
220
|
+
],
|
|
191
221
|
"bugsFiled": ["BD-42"],
|
|
192
|
-
"summary": "Ran
|
|
222
|
+
"summary": "Ran both parts the playbook defines: the unit suite was green; the end-to-end scenario's post-deploy assertion failed, filed BD-42 as a parent-less carry-over bug. This result is informational and does not gate the current sprint.",
|
|
193
223
|
"smokeEvidence": {
|
|
194
224
|
"checksRun": ["..."],
|
|
195
225
|
"notes": "..."
|
|
@@ -213,7 +243,11 @@ directly.
|
|
|
213
243
|
- NEVER write or modify test code
|
|
214
244
|
- NEVER fix application bugs -- report them as parent-less carry-over beads
|
|
215
245
|
- NEVER `--parent` or `bd dep add` a bead you file here into the current sprint's scope tree
|
|
216
|
-
- NEVER skip the playbook's Teardown -- it runs after every run, pass or fail
|
|
246
|
+
- NEVER skip the playbook's Teardown (when it defines one) -- it runs after every run, pass or fail
|
|
217
247
|
- NEVER modify regression-test-playbook.md
|
|
218
248
|
- NEVER close beads -- this role only creates carry-over bugs, it does not close features or tasks
|
|
219
249
|
- Tag every new issue title with `[regression][carry-over]` so it is searchable and structurally distinguishable from `[integ]` and planned work
|
|
250
|
+
|
|
251
|
+
## Shell command discipline
|
|
252
|
+
|
|
253
|
+
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.
|
|
@@ -29,34 +29,70 @@ Step 2) are read directly by you; they are not passed in the prompt.
|
|
|
29
29
|
exist), do not guess a branch name. Return `verdict: "CHANGES_NEEDED"` with `notes`
|
|
30
30
|
stating exactly which input is missing and `reopenIds: []`, `newTasks: []`.
|
|
31
31
|
|
|
32
|
-
## Step 0 -- Knowledge Bank (
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
32
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
33
|
+
|
|
34
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
35
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
36
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
37
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
38
|
+
the orchestrator fetched for the files changed in this review round.
|
|
39
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
40
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
41
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
42
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
43
|
+
|
|
44
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
45
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
46
|
+
|
|
47
|
+
The `code_impact` and `kb_query` calls below are EXPECTED, not optional, whenever the
|
|
48
|
+
tools are present. If a tool is genuinely not present (or the KB or code index is not set
|
|
49
|
+
up for this repo), record that in `toolUse` (Output schema) and continue -- never skip
|
|
50
|
+
silently.
|
|
51
|
+
|
|
52
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
53
|
+
relevant to the files changed in this review round. An INFERRED entry may be an
|
|
54
|
+
unvalidated in-flight capture.
|
|
55
|
+
2. The `code_*` tools answer what the KB cannot: what the changed code actually connects
|
|
56
|
+
to. Call `code_impact` on each changed file (or its changed symbols) BEFORE judging
|
|
57
|
+
blast radius -- once per file or symbol; test, doc and fixture-only files are
|
|
58
|
+
exempt -- and `code_context`/`code_graph`/`code_query` to trace callers before
|
|
59
|
+
accepting a signature or behaviour change -- prefer them over grep for structural
|
|
60
|
+
questions. If they are absent, fail, or report the repo is not indexed, fall back to
|
|
61
|
+
reading the diff and grep and record it in `toolUse`; do not build an index.
|
|
62
|
+
3. Call `kb_query` at least once per review, on the changed files' topics, to check the
|
|
63
|
+
doer's claims and the diff against what the KB already records, and to dedupe your
|
|
64
|
+
captures (item 4). This is for verification only; promotion candidates still come
|
|
65
|
+
solely from the block named in Step 5.
|
|
66
|
+
4. **Capture through output, not a tool call.** Add findings (gotchas, missed invariants,
|
|
67
|
+
non-obvious constraints) to the `kb_captures` array of your structured output (type
|
|
68
|
+
`knowledge`, `learning`, or `runbook`; shape in Output schema below); the engine
|
|
69
|
+
records them. Captures are clamped to INFERRED regardless of route -- CONFIRMED is
|
|
70
|
+
minted only via Step 5. Dedupe against the KB first (`kb_query` when present,
|
|
71
|
+
otherwise the block). Only durable, non-obvious findings qualify (no task logs, no
|
|
72
|
+
obvious facts); one concern per entry; cite real symbols and source_files. Do not
|
|
73
|
+
call `kb_list`, promote entries or write to the KB yourself (your session is not
|
|
74
|
+
served the promotion tool) -- promotions go through Step 5 and captures through
|
|
75
|
+
this field.
|
|
76
|
+
5. If a KB entry you retrieved proves wrong in practice, name the entry and what was
|
|
77
|
+
wrong in your review notes.
|
|
78
|
+
6. Report in `toolUse`: `kb` and `code` are each `used`, `unavailable` or `not_needed`;
|
|
79
|
+
`note` says why for anything not `used`. `used` means the expected call was made
|
|
80
|
+
(`kb_query` for kb -- `kb_session_prime` alone is not `used`; `code_impact`/
|
|
81
|
+
`code_context`/`code_graph` for code). `not_needed` only when no changed file called
|
|
82
|
+
for a lookup (e.g. docs-only). If your output schema has no `toolUse` field, put the
|
|
83
|
+
same statement in `notes`.
|
|
84
|
+
|
|
85
|
+
### Persistent Memories (operational rules)
|
|
86
|
+
|
|
87
|
+
Before starting code review, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
bd memories --json +all+
|
|
91
|
+
bd memories --json +reviewer+
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
95
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+reviewer+`.
|
|
60
96
|
|
|
61
97
|
## Step 1 -- Context recovery
|
|
62
98
|
|
|
@@ -76,7 +112,8 @@ If a bead carries a doer-raised flag -- a "CRITERIA-DEFECT" note, or a skip repo
|
|
|
76
112
|
the doer's dispatch context (missing/defective criteria, mis-assigned container with
|
|
77
113
|
open children) -- evaluate the flag on its merits THIS round. If it holds, put the bead
|
|
78
114
|
in both `reopenIds` and `replanIds` now, with `notes` explaining the defect -- do not
|
|
79
|
-
demand implementation against criteria you agree are broken.
|
|
115
|
+
demand implementation against criteria you agree are broken. A criterion that can only
|
|
116
|
+
be met by a CI run is always a valid criteria defect (see Step 6).
|
|
80
117
|
|
|
81
118
|
## Step 3 -- Review the diff
|
|
82
119
|
|
|
@@ -133,25 +170,33 @@ foreground command, treat it as if you backgrounded it yourself; do not chain sh
|
|
|
133
170
|
sleeps to route around the sleep-block. Do not return a verdict while the suite is
|
|
134
171
|
still running -- a backgrounded run with no reported outcome is not a completed step.
|
|
135
172
|
|
|
136
|
-
## Step 5 -- Promote knowledge you verified
|
|
173
|
+
## Step 5 -- Promote or discard knowledge you verified
|
|
137
174
|
|
|
138
|
-
This step covers
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
`kb_*` tool for this** -- the
|
|
142
|
-
decisions.
|
|
175
|
+
This step covers judgements on existing INFERRED candidates: promote one to CONFIRMED,
|
|
176
|
+
or discard one you showed to be wrong. Fresh findings go in `kb_captures` (Step 0,
|
|
177
|
+
item 4) -- the fields are independent and can all be returned. You are the only role
|
|
178
|
+
permitted to mint CONFIRMED. **You do not call any `kb_*` tool for this** -- the
|
|
179
|
+
orchestrator hands you the candidates and executes your decisions.
|
|
143
180
|
|
|
144
181
|
1. Read the **KNOWLEDGE BANK -- promotion candidates** block in your dispatch prompt. It
|
|
145
182
|
lists every INFERRED entry for the repo under review as `{id, title, summary,
|
|
146
|
-
source_files}`. If that block is absent, there is nothing to promote
|
|
147
|
-
move on.
|
|
183
|
+
source_files}`. If that block is absent, there is nothing to promote or discard:
|
|
184
|
+
return `[]` for both and move on.
|
|
148
185
|
2. Promote **only** entries whose claim you independently verified during THIS review --
|
|
149
186
|
by reading the diff, running the tests, or checking the cited files yourself.
|
|
150
187
|
3. Return them in the `kb_promotions` field of your structured output as
|
|
151
188
|
`[{id, reason}]`, where `reason` states the evidence (minimum 20 characters), e.g.
|
|
152
189
|
`"verified against src/auth/token.ts:88 and the expired-token test"`. The orchestrator
|
|
153
|
-
makes the
|
|
190
|
+
makes the promotion calls.
|
|
154
191
|
4. Promote nothing else. `kb_promotions: []` is a valid, common answer.
|
|
192
|
+
5. **Discard** a candidate only when you showed its claim to be WRONG during this review
|
|
193
|
+
-- the cited code says otherwise, or a test you ran contradicts it. Return it in the
|
|
194
|
+
`kb_discards` field as `[{id, reason}]` with the same evidence bar (minimum 20
|
|
195
|
+
characters, stating what you checked that contradicts the claim). The orchestrator
|
|
196
|
+
discards it, so it drops out of every later read. An entry you merely could not
|
|
197
|
+
confirm is not wrong: leave it INFERRED. Never list the same id in both
|
|
198
|
+
`kb_promotions` and `kb_discards` -- the orchestrator refuses both.
|
|
199
|
+
`kb_discards: []` is a valid, common answer.
|
|
155
200
|
|
|
156
201
|
Hard limits:
|
|
157
202
|
|
|
@@ -164,14 +209,27 @@ Hard limits:
|
|
|
164
209
|
verified even when the code needs rework.
|
|
165
210
|
- **User-directives are off limits.** Activation is human-only; the orchestrator filters
|
|
166
211
|
them from your candidate list. If one appears anyway, leave it alone.
|
|
167
|
-
- **Never invent an id.** Only ids from the candidate block
|
|
168
|
-
|
|
212
|
+
- **Never invent an id.** Only ids from the candidate block in THIS dispatch are
|
|
213
|
+
promotable or discardable. The orchestrator refuses any other id, so an id from
|
|
214
|
+
anywhere else -- including one you remember from an earlier round -- is dropped
|
|
215
|
+
and logged, never applied.
|
|
169
216
|
|
|
170
|
-
Promotion
|
|
171
|
-
mutate beads" rule below. Report what you promoted in `notes` as
|
|
217
|
+
Promotion and discard are KB decisions, not beads mutations -- they do not conflict with
|
|
218
|
+
the "never mutate beads" rule below. Report what you promoted or discarded in `notes` as
|
|
219
|
+
well.
|
|
172
220
|
|
|
173
221
|
## Step 6 -- Verdict
|
|
174
222
|
|
|
223
|
+
**CI is out of scope.** Never trigger, wait for, poll or judge a CI run. If an
|
|
224
|
+
acceptance criterion depends on CI, treat that part as not checkable in this review:
|
|
225
|
+
say so in `notes` and judge only the locally checkable parts. A CI part is never a
|
|
226
|
+
reason to reopen a bead for rework, withhold APPROVED, return FAIL (final review) or
|
|
227
|
+
file a new task, and never write a CI-status criterion into a new task. One exception:
|
|
228
|
+
if a bead is still open because its doer flagged a CI-only criterion as a criteria
|
|
229
|
+
defect (Step 2), the flag holds -- put the bead in both `reopenIds` and `replanIds` so
|
|
230
|
+
the planner rewrites its criteria without the CI part. That is a replan, not a CI
|
|
231
|
+
judgement.
|
|
232
|
+
|
|
175
233
|
Return your structured output ONLY. You never call `bd update`, `bd close`, `bd create`,
|
|
176
234
|
or any other beads mutation yourself -- the orchestrator reads your structured output and
|
|
177
235
|
applies the reopen/create transitions:
|
|
@@ -183,6 +241,11 @@ applies the reopen/create transitions:
|
|
|
183
241
|
needs a planner to rewrite the criteria before further development makes sense. Omit
|
|
184
242
|
it (equivalent to `[]`) when every reopened bead just needs rework against its
|
|
185
243
|
existing criteria.
|
|
244
|
+
- `buildFailing`: optional boolean -- `true` when the project's build or test suite FAILS
|
|
245
|
+
on the branch under review (omit or `false` when they pass). On CHANGES_NEEDED the
|
|
246
|
+
orchestrator guarantees a fix is dispatched for a red branch: if none of your
|
|
247
|
+
`reopenIds` can be reopened and no in-goal `newTasks` entry covers it, it files an
|
|
248
|
+
in-goal fix task carrying your `notes`.
|
|
186
249
|
- `newTasks`: array of `{ title, description, priority }` for follow-up work the review
|
|
187
250
|
surfaced that no existing task covers (empty array if none). `title` is PLAIN TEXT
|
|
188
251
|
ONLY: letters, digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -` -- no backticks,
|
|
@@ -215,6 +278,9 @@ placeholder):
|
|
|
215
278
|
"kb_promotions": [
|
|
216
279
|
{ "id": "kb-0042", "reason": "verified against src/auth/token.ts:88 and the expired-token test" }
|
|
217
280
|
],
|
|
281
|
+
"kb_discards": [
|
|
282
|
+
{ "id": "kb-0051", "reason": "src/auth/session.ts:40 refreshes eagerly; the entry's lazy-refresh claim is wrong" }
|
|
283
|
+
],
|
|
218
284
|
"kb_captures": [
|
|
219
285
|
{
|
|
220
286
|
"type": "knowledge",
|
|
@@ -223,12 +289,14 @@ placeholder):
|
|
|
223
289
|
"content": "src/auth/token.ts:refreshToken() does not guard against concurrent retries; a second caller racing a timed-out first call can consume the same refresh token twice, invalidating the session. Confirmed by tracing the retry wrapper in src/auth/retry.ts.",
|
|
224
290
|
"source_files": ["src/auth/token.ts", "src/auth/retry.ts"]
|
|
225
291
|
}
|
|
226
|
-
]
|
|
292
|
+
],
|
|
293
|
+
"toolUse": { "kb": "used", "code": "used" }
|
|
227
294
|
}
|
|
228
295
|
```
|
|
229
296
|
|
|
230
|
-
`kb_promotions` and `kb_captures` are
|
|
231
|
-
have nothing to promote or capture this round.
|
|
297
|
+
`kb_promotions`, `kb_discards` and `kb_captures` are all optional -- omit them, or send
|
|
298
|
+
`[]`, when you have nothing to promote, discard or capture this round. `toolUse` is
|
|
299
|
+
optional in the schema but expected: see Step 0.
|
|
232
300
|
|
|
233
301
|
**Precedence**: If your dispatch prompt includes a JSON schema instruction, that schema is
|
|
234
302
|
authoritative -- respond with exactly that JSON and nothing else. It is expected to match
|
|
@@ -246,3 +314,7 @@ or as prose if you are answering a human directly.
|
|
|
246
314
|
- NEVER mutate beads directly -- no `bd update`, `bd close`, `bd create`, `bd reopen`.
|
|
247
315
|
Return `reopenIds`/`newTasks` and let the orchestrator apply the transitions.
|
|
248
316
|
- NEVER write feedback.md -- return structured output only
|
|
317
|
+
|
|
318
|
+
## Shell command discipline
|
|
319
|
+
|
|
320
|
+
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.
|
|
@@ -155,7 +155,7 @@
|
|
|
155
155
|
"type": "object",
|
|
156
156
|
"required": ["key", "content"],
|
|
157
157
|
"properties": {
|
|
158
|
-
"key": { "type": "string", "description": "The groomer
|
|
158
|
+
"key": { "type": "string", "description": "The +groomer+:<slug> key (or +groomer+<role>+:<slug> when other roles need it) used with bd remember." },
|
|
159
159
|
"content": { "type": "string" }
|
|
160
160
|
}
|
|
161
161
|
}
|
|
@@ -77,6 +77,38 @@
|
|
|
77
77
|
}
|
|
78
78
|
}
|
|
79
79
|
}
|
|
80
|
+
},
|
|
81
|
+
"toolUse": {
|
|
82
|
+
"type": "object",
|
|
83
|
+
"description": "How this run used the kb_* and code_* tools its role prompt expects (Step 0). Optional for backward compatibility, but expected: report \"unavailable\" or \"not_needed\" with a note rather than skipping the calls silently.",
|
|
84
|
+
"required": [
|
|
85
|
+
"kb",
|
|
86
|
+
"code"
|
|
87
|
+
],
|
|
88
|
+
"properties": {
|
|
89
|
+
"kb": {
|
|
90
|
+
"type": "string",
|
|
91
|
+
"enum": [
|
|
92
|
+
"used",
|
|
93
|
+
"unavailable",
|
|
94
|
+
"not_needed"
|
|
95
|
+
],
|
|
96
|
+
"description": "used = kb_query was called (kb_session_prime alone is not used)."
|
|
97
|
+
},
|
|
98
|
+
"code": {
|
|
99
|
+
"type": "string",
|
|
100
|
+
"enum": [
|
|
101
|
+
"used",
|
|
102
|
+
"unavailable",
|
|
103
|
+
"not_needed"
|
|
104
|
+
],
|
|
105
|
+
"description": "used = code_impact, code_context or code_graph was called."
|
|
106
|
+
},
|
|
107
|
+
"note": {
|
|
108
|
+
"type": "string",
|
|
109
|
+
"description": "Why a value is not \"used\": which tool was missing or failed, or why no lookup was needed."
|
|
110
|
+
}
|
|
111
|
+
}
|
|
80
112
|
}
|
|
81
113
|
}
|
|
82
114
|
}
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"title": "harvester input",
|
|
6
6
|
"description": "Required dispatch-context keys for the harvester role, per agents/harvester.md Inputs section. Consumed by callers for pre-dispatch validation only -- never appended to the prompt or shown to the LLM.",
|
|
7
7
|
"type": "object",
|
|
8
|
-
"required": ["analysisArtifactFile", "analysisText", "
|
|
8
|
+
"required": ["analysisArtifactFile", "analysisText", "base-branch", "branch"],
|
|
9
9
|
"properties": {
|
|
10
10
|
"analysisArtifactFile": {
|
|
11
11
|
"type": "string",
|
|
@@ -15,10 +15,6 @@
|
|
|
15
15
|
"type": "string",
|
|
16
16
|
"description": "Exact, pre-formatted analysis content to write verbatim."
|
|
17
17
|
},
|
|
18
|
-
"costAnalysis": {
|
|
19
|
-
"type": "string",
|
|
20
|
-
"description": "Exact, pre-computed cost analysis block to insert verbatim into the CHANGELOG entry."
|
|
21
|
-
},
|
|
22
18
|
"base-branch": {
|
|
23
19
|
"type": "string",
|
|
24
20
|
"description": "Branch to diff against for git log/git diff in Step 2."
|
|
@@ -14,6 +14,43 @@
|
|
|
14
14
|
"notes": {
|
|
15
15
|
"type": "string"
|
|
16
16
|
},
|
|
17
|
+
"findings": {
|
|
18
|
+
"type": "array",
|
|
19
|
+
"description": "Machine-readable per-bead findings: one entry per bead that must change, so a caller can route a CHANGES_NEEDED verdict without parsing notes. Populate on every CHANGES_NEEDED verdict. Return an empty array when the objection is genuinely plan-wide and names no individual bead -- an empty array is the explicit 'plan-wide' signal. Omit or return an empty array on APPROVED. Optional, and deliberately absent-tolerant for one release: a verdict produced against the previous contract still validates, and a caller may fall back to reading notes. notes stays the narration channel.",
|
|
20
|
+
"items": {
|
|
21
|
+
"type": "object",
|
|
22
|
+
"required": ["id", "kind", "detail"],
|
|
23
|
+
"properties": {
|
|
24
|
+
"id": {
|
|
25
|
+
"type": "string",
|
|
26
|
+
"description": "The bead this finding concerns, written exactly as it appears in taskAssignments (e.g. BD-14)."
|
|
27
|
+
},
|
|
28
|
+
"kind": {
|
|
29
|
+
"type": "string",
|
|
30
|
+
"description": "Which quality criterion failed, as a closed vocabulary mirroring the numbered criteria in the prose contract's Step 2. Use other only when no listed kind fits, and explain it in detail.",
|
|
31
|
+
"enum": [
|
|
32
|
+
"coverage",
|
|
33
|
+
"missing_test_task",
|
|
34
|
+
"acceptance_criteria",
|
|
35
|
+
"task_size",
|
|
36
|
+
"dependency_wiring",
|
|
37
|
+
"scope_creep",
|
|
38
|
+
"duplicate_work",
|
|
39
|
+
"feasibility",
|
|
40
|
+
"ready_work",
|
|
41
|
+
"model_metadata",
|
|
42
|
+
"lane_cohesion",
|
|
43
|
+
"other"
|
|
44
|
+
]
|
|
45
|
+
},
|
|
46
|
+
"detail": {
|
|
47
|
+
"type": "string",
|
|
48
|
+
"minLength": 1,
|
|
49
|
+
"description": "The human explanation for this bead: what is wrong and what would make it pass."
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
},
|
|
17
54
|
"taskAssignments": {
|
|
18
55
|
"type": "array",
|
|
19
56
|
"items": {
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
},
|
|
27
27
|
"kb_captures": {
|
|
28
28
|
"type": "array",
|
|
29
|
-
"description": "
|
|
29
|
+
"description": "IGNORED FOR THIS ROLE -- the planner has no apply path, so anything sent here is silently dropped rather than captured. Declared only for forward compatibility and shape-parity with the roles that do capture; always omit it or send []. Do not spend planning effort producing entries for it.",
|
|
30
30
|
"items": {
|
|
31
31
|
"type": "object",
|
|
32
32
|
"required": ["type", "title", "summary", "content", "source_files"],
|