@apralabs/apra-fleet 0.4.3 → 0.4.5
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 +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- 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 +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- 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 +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- 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 +62 -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 +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- 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 +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- 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 +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- 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 +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -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 +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -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 +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- 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 +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -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 +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -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 +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -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/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 +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -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/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -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 +229 -38
- 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 +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- 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 +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- 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 +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -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 +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -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 +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -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 +106 -20
- 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 +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- 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/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- 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 +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- 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 +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- 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 +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -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 +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -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 +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -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 +499 -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 +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.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/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.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/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.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-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.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/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.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/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.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/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.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/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.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,40 +1,56 @@
|
|
|
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 (
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
9
|
+
## Step 0 -- Knowledge Bank (do this BEFORE running the playbook)
|
|
10
|
+
|
|
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.
|
|
20
|
+
|
|
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
|
+
|
|
24
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
25
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
26
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
27
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
28
|
+
|
|
29
|
+
1. When the tools are present, call `kb_session_prime` with `hint_modules` naming the
|
|
30
|
+
subsystems `regression-test-playbook.md` exercises.
|
|
31
|
+
2. Known-flaky tests and known environment setup/teardown gotchas are the point here -- they
|
|
32
|
+
change whether a red run is a real regression or a known environment failure. Make
|
|
33
|
+
that judgment from the live result or the injected block, never from a tool failure.
|
|
34
|
+
3. This role has no KB-capture channel: when a playbook step fails for a non-obvious
|
|
35
|
+
reason, or its setup/teardown turns out to need a step the playbook does not
|
|
36
|
+
record, note the regression gotcha in your own report. A regression gotcha you had
|
|
37
|
+
to rediscover is exactly what the next sprint's run needs.
|
|
38
|
+
|
|
39
|
+
### Persistent Memories (operational rules)
|
|
40
|
+
|
|
41
|
+
Before running the playbook, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
bd memories --json +all+
|
|
45
|
+
bd memories --json +regression-test-runner+
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
49
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+regression-test-runner+`.
|
|
50
|
+
|
|
51
|
+
You own `regression-test-playbook.md` end to end: run every part it
|
|
52
|
+
defines, in its order, and if it defines a `## Teardown`, ALWAYS run it --
|
|
53
|
+
pass or fail. You never write or modify test code, never fix application bugs,
|
|
38
54
|
never modify the playbook. (`deployer` deploys via `deploy.md`;
|
|
39
55
|
`integ-test-runner` runs `integ-test-playbook.md` per cycle to close THIS
|
|
40
56
|
sprint's features -- neither is yours.)
|
|
@@ -52,23 +68,23 @@ carries over to a FUTURE sprint.
|
|
|
52
68
|
Your dispatch prompt must supply:
|
|
53
69
|
|
|
54
70
|
- Repo root path (required) -- where `regression-test-playbook.md` lives.
|
|
55
|
-
|
|
71
|
+
Any environment the playbook sets up and tears down is yours to run (Step 1).
|
|
56
72
|
|
|
57
73
|
There is no feature-id list and no deployed SHA in your inputs -- you do not
|
|
58
74
|
close features and you do not validate against a specific cycle's deploy
|
|
59
|
-
(unlike `integ-test-runner`'s deployed-build evidence-freshness rule).
|
|
60
|
-
|
|
75
|
+
(unlike `integ-test-runner`'s deployed-build evidence-freshness rule). The
|
|
76
|
+
playbook runs against branch HEAD, set up the way the playbook itself says.
|
|
61
77
|
|
|
62
78
|
**Missing-input behavior**: if `regression-test-playbook.md` is entirely
|
|
63
79
|
absent, stop and report it -- do not improvise test steps. If the
|
|
64
|
-
playbook's Setup
|
|
65
|
-
not run tests
|
|
66
|
-
Teardown, then
|
|
80
|
+
playbook's `## Setup` fails (its environment cannot be brought up), do
|
|
81
|
+
not run tests that depend on it or fabricate results: run the playbook's
|
|
82
|
+
`## Teardown` if it defines one, then report that instead.
|
|
67
83
|
|
|
68
84
|
On BOTH early-exit paths, and on the Step 0 permissions stop below, still
|
|
69
85
|
return the COMPLETE required field set -- `passed: false`,
|
|
70
|
-
`
|
|
71
|
-
|
|
86
|
+
`bugsFiled: []`, and a `summary` naming the exact reason (plus `sections`
|
|
87
|
+
for any part that did run). This schema has no `notes` field; a
|
|
72
88
|
partial object like `{"passed": false, "notes": "..."}` is schema-INVALID
|
|
73
89
|
and gets sent back for repair.
|
|
74
90
|
|
|
@@ -92,41 +108,31 @@ yourself: `.claude/settings.json` changes require a team PR, and
|
|
|
92
108
|
`compose_permissions` MCP tool (the provider-agnostic delivery mechanism),
|
|
93
109
|
never hand-edited. Do NOT proceed while any permission is missing.
|
|
94
110
|
|
|
95
|
-
## Step 1 -- Run
|
|
111
|
+
## Step 1 -- Run the playbook
|
|
96
112
|
|
|
97
|
-
Run the playbook
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
113
|
+
Run the playbook exactly as written, at branch HEAD: every part it defines,
|
|
114
|
+
in the order it gives, running `## Setup` (if defined) where the playbook
|
|
115
|
+
places it. If Setup fails, do not run the parts that depend on it -- run
|
|
116
|
+
`## Teardown` (if defined) and report per "Missing-input behavior" above,
|
|
117
|
+
keeping the results of any part that already ran. No fail-fast across parts: a
|
|
118
|
+
failing test or part does not abort the pass. Record every failure and
|
|
119
|
+
continue with the next part. If the playbook defines a `## Teardown`, ALWAYS
|
|
120
|
+
run it once the parts are done, before doing anything else -- pass or fail.
|
|
102
121
|
|
|
103
|
-
**Waiting on a long-running run**:
|
|
122
|
+
**Waiting on a long-running run**: a part can legitimately take many
|
|
104
123
|
minutes. Never wait for it inside one silent blocking call -- your own
|
|
105
124
|
turn's output is the liveness signal the dispatch layer's inactivity
|
|
106
125
|
watchdog uses to know you are still working, and a long silent stretch
|
|
107
126
|
looks identical to a hang. Send the run to the background (or poll it in
|
|
108
127
|
short, bounded checks), and report progress explicitly at least every ~2
|
|
109
|
-
minutes while it runs (e.g. "
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
progress.
|
|
113
|
-
|
|
114
|
-
## Step 2 -- Run Part 2: the sandbox smoke test
|
|
115
|
-
|
|
116
|
-
Bring the sandbox up with the playbook's `## Setup` section, run the
|
|
117
|
-
playbook's `## Test scenario` inside it, then ALWAYS run `## Teardown`
|
|
118
|
-
before doing anything else -- pass or fail. Apply the same
|
|
119
|
-
long-running-run discipline as Step 1 (background it, poll with real tool
|
|
120
|
-
calls, visible interim output at least every ~2 minutes, never a silent
|
|
121
|
-
sleep loop, never end your turn mid-run).
|
|
122
|
-
|
|
123
|
-
If the playbook's Setup verify step fails, do not proceed to the Test
|
|
124
|
-
scenario: run Teardown and report per "Missing-input behavior" above.
|
|
128
|
+
minutes while it runs (e.g. "<part> still running (checked at HH:MM:SS) --
|
|
129
|
+
checking again shortly."). Do not chain sleeps to route around this. Do not
|
|
130
|
+
end your turn or report final results while a run is still in progress.
|
|
125
131
|
|
|
126
132
|
## Step 3 -- Filing failures: STANDALONE, PARENT-LESS beads only
|
|
127
133
|
|
|
128
134
|
**This is load-bearing -- read it carefully.** Every regression failure you
|
|
129
|
-
find, from
|
|
135
|
+
find, from any part of the playbook, is filed as a STANDALONE, PARENT-LESS
|
|
130
136
|
bead: `bd create` with NO `--parent` flag, and you must NOT `bd dep add` it
|
|
131
137
|
to the sprint's scope root, to any feature, or to any other sprint bead.
|
|
132
138
|
Title every one `[regression][carry-over] <short description>`.
|
|
@@ -154,7 +160,7 @@ No backticks, double quotes, `$`, or backslash; put formatted detail in `--descr
|
|
|
154
160
|
```bash
|
|
155
161
|
bd create \
|
|
156
162
|
--title="[regression][carry-over] <short description of failure>" \
|
|
157
|
-
--description="Part: <
|
|
163
|
+
--description="Part: <the playbook part that failed, as the playbook names it>
|
|
158
164
|
Expected: <what should happen>
|
|
159
165
|
Actual: <what happened>
|
|
160
166
|
Test: <which test/step failed and its output>
|
|
@@ -171,22 +177,38 @@ Priority rules:
|
|
|
171
177
|
|
|
172
178
|
## Step 4 -- Teardown, then return results
|
|
173
179
|
|
|
174
|
-
Confirm the playbook's `## Teardown`
|
|
175
|
-
|
|
176
|
-
it now if the
|
|
180
|
+
Confirm the playbook's `## Teardown` (if it defines one) has run -- Step 1
|
|
181
|
+
already ran it; if you stopped earlier via the missing-input paths above,
|
|
182
|
+
run it now if the playbook's environment was ever brought up. Then return:
|
|
177
183
|
|
|
178
|
-
- `passed`: `true` only if
|
|
179
|
-
|
|
180
|
-
- `
|
|
181
|
-
|
|
184
|
+
- `passed`: `true` only if every part the playbook defines passed AND no
|
|
185
|
+
`[regression][carry-over]` bead was filed this run
|
|
186
|
+
- `sections`: one `{ "name", "passed", "detail"? }` entry per part the
|
|
187
|
+
playbook defines, `name` exactly as the playbook names that part (a
|
|
188
|
+
playbook with a single part yields one entry)
|
|
182
189
|
- `bugsFiled`: array of the parent-less `[regression][carry-over]` bead ids created in Step 3 (empty array if none)
|
|
183
190
|
- `summary`: one paragraph describing what was run, what passed, what
|
|
184
191
|
failed, reiterating that this result is informational and any filed bugs
|
|
185
192
|
carry over to a future sprint
|
|
186
|
-
- `smokeEvidence` (optional): structured
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
193
|
+
- `smokeEvidence` (optional): structured evidence, in whatever shape the
|
|
194
|
+
target repo's own regression-test-playbook.md defines. Omit this field
|
|
195
|
+
(or return an empty object) if that playbook defines no structured
|
|
196
|
+
evidence.
|
|
197
|
+
- `verdict`, `testedSha`, `evidence` (optional): only per the Verdict-file
|
|
198
|
+
rule below; omit all three otherwise.
|
|
199
|
+
|
|
200
|
+
### Verdict-file rule
|
|
201
|
+
|
|
202
|
+
If the playbook names a machine-written verdict file (a file a tool or CI
|
|
203
|
+
run writes, not you), read it and copy its `verdict` (`PASS`, `FAIL` or
|
|
204
|
+
`INCONCLUSIVE`), `testedSha` (full 40-hex commit sha) and `evidence`
|
|
205
|
+
(`verdictRef` = where the file is, `runUrl`, `newFailures[]`,
|
|
206
|
+
`inventoryMissing[]`, as the file provides them) VERBATIM. NEVER author,
|
|
207
|
+
infer, or "correct" these values yourself; if the file is missing or
|
|
208
|
+
unreadable, omit them and report that in `summary`. When `verdict` is
|
|
209
|
+
present, set `passed` = (`verdict` == `"PASS"`), replacing the `passed` rule
|
|
210
|
+
above. `INCONCLUSIVE` means the run proved nothing either way -- report it
|
|
211
|
+
as such, never as a failure.
|
|
190
212
|
|
|
191
213
|
## Output schema
|
|
192
214
|
|
|
@@ -197,10 +219,12 @@ instance (valid JSON, not a pseudo-JSON placeholder):
|
|
|
197
219
|
```json
|
|
198
220
|
{
|
|
199
221
|
"passed": false,
|
|
200
|
-
"
|
|
201
|
-
|
|
222
|
+
"sections": [
|
|
223
|
+
{ "name": "Unit suite", "passed": true },
|
|
224
|
+
{ "name": "End-to-end scenario", "passed": false, "detail": "post-deploy assertion failed" }
|
|
225
|
+
],
|
|
202
226
|
"bugsFiled": ["BD-42"],
|
|
203
|
-
"summary": "Ran
|
|
227
|
+
"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.",
|
|
204
228
|
"smokeEvidence": {
|
|
205
229
|
"checksRun": ["..."],
|
|
206
230
|
"notes": "..."
|
|
@@ -224,7 +248,11 @@ directly.
|
|
|
224
248
|
- NEVER write or modify test code
|
|
225
249
|
- NEVER fix application bugs -- report them as parent-less carry-over beads
|
|
226
250
|
- NEVER `--parent` or `bd dep add` a bead you file here into the current sprint's scope tree
|
|
227
|
-
- NEVER skip the playbook's Teardown -- it runs after every run, pass or fail
|
|
251
|
+
- NEVER skip the playbook's Teardown (when it defines one) -- it runs after every run, pass or fail
|
|
228
252
|
- NEVER modify regression-test-playbook.md
|
|
229
253
|
- NEVER close beads -- this role only creates carry-over bugs, it does not close features or tasks
|
|
230
254
|
- Tag every new issue title with `[regression][carry-over]` so it is searchable and structurally distinguishable from `[integ]` and planned work
|
|
255
|
+
|
|
256
|
+
## Shell command discipline
|
|
257
|
+
|
|
258
|
+
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,48 +29,84 @@ 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
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
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
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
48
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
49
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
50
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
51
|
+
|
|
52
|
+
The `code_impact` and `kb_query` calls below are EXPECTED, not optional, whenever the
|
|
53
|
+
tools are present. If a tool is genuinely not present (or the KB or code index is not set
|
|
54
|
+
up for this repo), record that in `toolUse` (Output schema) and continue -- never skip
|
|
55
|
+
silently.
|
|
56
|
+
|
|
57
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
58
|
+
relevant to the files changed in this review round. An INFERRED entry may be an
|
|
59
|
+
unvalidated in-flight capture.
|
|
60
|
+
2. The `code_*` tools answer what the KB cannot: what the changed code actually connects
|
|
61
|
+
to. Call `code_impact` on each changed file (or its changed symbols) BEFORE judging
|
|
62
|
+
blast radius -- once per file or symbol; test, doc and fixture-only files are
|
|
63
|
+
exempt -- and `code_context`/`code_graph`/`code_query` to trace callers before
|
|
64
|
+
accepting a signature or behaviour change -- prefer them over grep for structural
|
|
65
|
+
questions. If they are absent, fail, or report the repo is not indexed, fall back to
|
|
66
|
+
reading the diff and grep and record it in `toolUse`; do not build an index. On
|
|
67
|
+
`E-CODE-INDEX-NOT-READY`, wait once for its `retry_after_ms`, retry once, then fall
|
|
68
|
+
back -- never poll `code_status` in a loop.
|
|
69
|
+
3. Call `kb_query` at least once per review, on the changed files' topics, to check the
|
|
70
|
+
doer's claims and the diff against what the KB already records, and to dedupe your
|
|
71
|
+
captures (item 4). This is for verification only; promotion candidates still come
|
|
72
|
+
solely from the block named in Step 5.
|
|
73
|
+
4. **Capture through output, not a tool call.** Add findings (gotchas, missed invariants,
|
|
74
|
+
non-obvious constraints) to the `kb_captures` array of your structured output (type
|
|
75
|
+
`knowledge`, `learning`, or `runbook`; shape in Output schema below); the engine
|
|
76
|
+
records them. Captures are clamped to INFERRED regardless of route -- CONFIRMED is
|
|
77
|
+
minted only via Step 5. Dedupe against the KB first (`kb_query` when present,
|
|
78
|
+
otherwise the block). Only durable, non-obvious findings qualify (no task logs, no
|
|
79
|
+
obvious facts); one concern per entry; cite real symbols and source_files. Do not
|
|
80
|
+
call `kb_list`, promote entries or write to the KB yourself (your session is not
|
|
81
|
+
served the promotion tool) -- promotions go through Step 5 and captures through
|
|
82
|
+
this field.
|
|
83
|
+
5. If a KB entry you retrieved proves wrong in practice, name the entry and what was
|
|
84
|
+
wrong in your review notes.
|
|
85
|
+
6. Report in `toolUse`: `kb` and `code` are each `used`, `unavailable` or `not_needed`;
|
|
86
|
+
`note` says why for anything not `used`. `used` means the expected call was made
|
|
87
|
+
(`kb_query` for kb -- `kb_session_prime` alone is not `used`; `code_impact`/
|
|
88
|
+
`code_context`/`code_graph` for code). `not_needed` only when no changed file called
|
|
89
|
+
for a lookup (e.g. docs-only). If your output schema has no `toolUse` field, put the
|
|
90
|
+
same statement in `notes`.
|
|
91
|
+
|
|
92
|
+
### Persistent Memories (operational rules)
|
|
93
|
+
|
|
94
|
+
Before starting code review, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
bd memories --json +all+
|
|
98
|
+
bd memories --json +reviewer+
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
102
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+reviewer+`.
|
|
71
103
|
|
|
72
104
|
## Step 1 -- Context recovery
|
|
73
105
|
|
|
106
|
+
If your dispatch prompt gives a diff range (`<commit-sha>..<branch>`), use exactly that
|
|
107
|
+
range wherever `<base-branch>..<branch>` appears below, for every `git diff` and
|
|
108
|
+
`git log`. Never diff against a local base branch in that case: it may be stale.
|
|
109
|
+
|
|
74
110
|
```bash
|
|
75
111
|
git log --oneline <base-branch>..<branch>
|
|
76
112
|
git diff <base-branch>..<branch> --stat
|
|
@@ -87,7 +123,8 @@ If a bead carries a doer-raised flag -- a "CRITERIA-DEFECT" note, or a skip repo
|
|
|
87
123
|
the doer's dispatch context (missing/defective criteria, mis-assigned container with
|
|
88
124
|
open children) -- evaluate the flag on its merits THIS round. If it holds, put the bead
|
|
89
125
|
in both `reopenIds` and `replanIds` now, with `notes` explaining the defect -- do not
|
|
90
|
-
demand implementation against criteria you agree are broken.
|
|
126
|
+
demand implementation against criteria you agree are broken. A criterion that can only
|
|
127
|
+
be met by a CI run is always a valid criteria defect (see Step 6).
|
|
91
128
|
|
|
92
129
|
## Step 3 -- Review the diff
|
|
93
130
|
|
|
@@ -144,25 +181,57 @@ foreground command, treat it as if you backgrounded it yourself; do not chain sh
|
|
|
144
181
|
sleeps to route around the sleep-block. Do not return a verdict while the suite is
|
|
145
182
|
still running -- a backgrounded run with no reported outcome is not a completed step.
|
|
146
183
|
|
|
147
|
-
## Step 5 -- Promote knowledge you verified
|
|
184
|
+
## Step 5 -- Promote, discard, or demote knowledge you verified
|
|
148
185
|
|
|
149
|
-
This step covers
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
186
|
+
This step covers judgements on existing candidates: promote an INFERRED one to
|
|
187
|
+
CONFIRMED, discard an INFERRED one you showed to be wrong, or demote a CONFIRMED one
|
|
188
|
+
back to INFERRED. Fresh findings go in `kb_captures` (Step 0, item 4) -- the fields are
|
|
189
|
+
independent and can all be returned. You are the only role permitted to mint CONFIRMED
|
|
190
|
+
or to demote it. **You do not call any `kb_*` tool for any of promotion, discard or
|
|
191
|
+
demotion** -- for all three, you RETURN your judgement in the named field of your
|
|
192
|
+
structured output (`kb_promotions`, `kb_discards`, `kb_demotions`), and the orchestrator
|
|
193
|
+
reads that output and executes your judgement on your behalf; you never touch the KB
|
|
194
|
+
directly.
|
|
154
195
|
|
|
155
196
|
1. Read the **KNOWLEDGE BANK -- promotion candidates** block in your dispatch prompt. It
|
|
156
197
|
lists every INFERRED entry for the repo under review as `{id, title, summary,
|
|
157
|
-
source_files}`. If that block is absent, there is nothing to promote
|
|
158
|
-
move on.
|
|
198
|
+
source_files}`. If that block is absent, there is nothing to promote or discard:
|
|
199
|
+
return `[]` for both and move on.
|
|
159
200
|
2. Promote **only** entries whose claim you independently verified during THIS review --
|
|
160
201
|
by reading the diff, running the tests, or checking the cited files yourself.
|
|
161
202
|
3. Return them in the `kb_promotions` field of your structured output as
|
|
162
203
|
`[{id, reason}]`, where `reason` states the evidence (minimum 20 characters), e.g.
|
|
163
204
|
`"verified against src/auth/token.ts:88 and the expired-token test"`. The orchestrator
|
|
164
|
-
makes the
|
|
205
|
+
makes the promotion calls.
|
|
165
206
|
4. Promote nothing else. `kb_promotions: []` is a valid, common answer.
|
|
207
|
+
5. **Discard** a candidate only when you showed its claim to be WRONG during this review
|
|
208
|
+
-- the cited code says otherwise, or a test you ran contradicts it. Return it in the
|
|
209
|
+
`kb_discards` field as `[{id, reason}]` with the same evidence bar (minimum 20
|
|
210
|
+
characters, stating what you checked that contradicts the claim). The orchestrator
|
|
211
|
+
discards it, so it drops out of every later read. An entry you merely could not
|
|
212
|
+
confirm is not wrong: leave it INFERRED. Never list the same id in both
|
|
213
|
+
`kb_promotions` and `kb_discards` -- the orchestrator refuses both.
|
|
214
|
+
`kb_discards: []` is a valid, common answer.
|
|
215
|
+
6. **Demote** a CONFIRMED entry when re-checking it during THIS review shows the claim
|
|
216
|
+
does not hold -- whether you are now less certain of it or have shown it wrong, it is
|
|
217
|
+
one judgement and one route. Read the **KNOWLEDGE BANK -- demotion candidates** block
|
|
218
|
+
in your dispatch prompt (if absent, there is nothing to demote: return
|
|
219
|
+
`kb_demotions: []`). A drifted or removed basis (the cited code changed or vanished)
|
|
220
|
+
is NOT a demote case -- the freshness sweep and the bible basis predicate already
|
|
221
|
+
handle that without you. Discarding an unconfirmed (INFERRED) capture you showed wrong
|
|
222
|
+
is `kb_discards` above, never a demotion, since demotion only ever applies to an
|
|
223
|
+
already-CONFIRMED entry. Return demotions in the `kb_demotions` field as
|
|
224
|
+
`[{id, reason, evidence_files}]`: the same reason bar (minimum 20 characters, stating
|
|
225
|
+
what you re-checked this review that the claim does not hold up against), and
|
|
226
|
+
`evidence_files` naming the files you re-checked -- at least one, each a real file in
|
|
227
|
+
the repo. A demotion without one is refused. Demoting nothing is a valid, common answer: `kb_demotions: []`.
|
|
228
|
+
Never list the same id in more than one of `kb_promotions`, `kb_discards` and
|
|
229
|
+
`kb_demotions` -- the orchestrator refuses it in every list it appears in.
|
|
230
|
+
A team can turn the demotion loop off (a sprint launch setting); then no
|
|
231
|
+
demotion candidates block appears and any `kb_demotions` you return are dropped.
|
|
232
|
+
Re-promotion limit: a demoted entry returns to INFERRED, but the promotion window is
|
|
233
|
+
entries whose `created_at` falls inside the current sprint, so an entry created in an
|
|
234
|
+
earlier sprint that gets demoted is never re-offered for promotion by the engine.
|
|
166
235
|
|
|
167
236
|
Hard limits:
|
|
168
237
|
|
|
@@ -175,18 +244,31 @@ Hard limits:
|
|
|
175
244
|
verified even when the code needs rework.
|
|
176
245
|
- **User-directives are off limits.** Activation is human-only; the orchestrator filters
|
|
177
246
|
them from your candidate list. If one appears anyway, leave it alone.
|
|
178
|
-
- **Never invent an id.** Only ids from the candidate block
|
|
179
|
-
|
|
247
|
+
- **Never invent an id.** Only ids from the candidate block in THIS dispatch are
|
|
248
|
+
promotable, discardable or demotable. The orchestrator refuses any other id, so an id
|
|
249
|
+
from anywhere else -- including one you remember from an earlier round -- is dropped
|
|
250
|
+
and logged, never applied.
|
|
180
251
|
|
|
181
|
-
Promotion
|
|
182
|
-
mutate beads" rule below. Report what you promoted
|
|
252
|
+
Promotion, discard and demotion are KB decisions, not beads mutations -- they do not
|
|
253
|
+
conflict with the "never mutate beads" rule below. Report what you promoted, discarded
|
|
254
|
+
or demoted in `notes` as well.
|
|
183
255
|
|
|
184
256
|
## Step 6 -- Verdict
|
|
185
257
|
|
|
258
|
+
**CI is out of scope.** Never trigger, wait for, poll or judge a CI run. If an
|
|
259
|
+
acceptance criterion depends on CI, treat that part as not checkable in this review:
|
|
260
|
+
say so in `notes` and judge only the locally checkable parts. A CI part is never a
|
|
261
|
+
reason to reopen a bead for rework, withhold APPROVED, return FAIL (final review) or
|
|
262
|
+
file a new task, and never write a CI-status criterion into a new task. One exception:
|
|
263
|
+
if a bead is still open because its doer flagged a CI-only criterion as a criteria
|
|
264
|
+
defect (Step 2), the flag holds -- put the bead in both `reopenIds` and `replanIds` so
|
|
265
|
+
the planner rewrites its criteria without the CI part. That is a replan, not a CI
|
|
266
|
+
judgement.
|
|
267
|
+
|
|
186
268
|
Return your structured output ONLY. You never call `bd update`, `bd close`, `bd create`,
|
|
187
269
|
or any other beads mutation yourself -- the orchestrator reads your structured output and
|
|
188
270
|
applies the reopen/create transitions:
|
|
189
|
-
- `verdict`: "APPROVED" or "
|
|
271
|
+
- `verdict`: "APPROVED", "CHANGES_NEEDED" or "NEEDS-DECISION"
|
|
190
272
|
- `notes`: specific findings with file and line references where possible
|
|
191
273
|
- `reopenIds`: array of beads task IDs that need rework (empty array if none)
|
|
192
274
|
- `replanIds`: optional array of ids among `reopenIds` whose ACCEPTANCE CRITERIA are
|
|
@@ -194,6 +276,11 @@ applies the reopen/create transitions:
|
|
|
194
276
|
needs a planner to rewrite the criteria before further development makes sense. Omit
|
|
195
277
|
it (equivalent to `[]`) when every reopened bead just needs rework against its
|
|
196
278
|
existing criteria.
|
|
279
|
+
- `buildFailing`: optional boolean -- `true` when the project's build or test suite FAILS
|
|
280
|
+
on the branch under review (omit or `false` when they pass). On CHANGES_NEEDED the
|
|
281
|
+
orchestrator guarantees a fix is dispatched for a red branch: if none of your
|
|
282
|
+
`reopenIds` can be reopened and no in-goal `newTasks` entry covers it, it files an
|
|
283
|
+
in-goal fix task carrying your `notes`.
|
|
197
284
|
- `newTasks`: array of `{ title, description, priority }` for follow-up work the review
|
|
198
285
|
surfaced that no existing task covers (empty array if none). `title` is PLAIN TEXT
|
|
199
286
|
ONLY: letters, digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -` -- no backticks,
|
|
@@ -209,6 +296,19 @@ applies the reopen/create transitions:
|
|
|
209
296
|
yourself. The orchestrator runs `bd update <id> --status=open` for each ID in `reopenIds`.
|
|
210
297
|
Notes must be specific: "auth_test.ts line 42: no test for expired token path".
|
|
211
298
|
|
|
299
|
+
**NEEDS-DECISION**: when a bead under review can be neither approved nor sent back for
|
|
300
|
+
rework until a human chooses between real alternatives (for example two acceptable
|
|
301
|
+
designs with different costs, or criteria that can only be met by an option the bead
|
|
302
|
+
does not authorize), return `verdict: "NEEDS-DECISION"` with a `decision` object:
|
|
303
|
+
`beadId` (the one bead the decision is about, from the beads you were asked to review),
|
|
304
|
+
`question` (self-contained: what you found and what must be decided), `options` (at
|
|
305
|
+
least two, each `{ "id": "a", "text": "..." }`) and `recommendation` (the option id you
|
|
306
|
+
recommend, and why). The orchestrator reopens that bead if needed, files the question
|
|
307
|
+
for an operator verbatim and sets the bead aside for the rest of the run; any other
|
|
308
|
+
`reopenIds` and `newTasks` on the same verdict are still applied. Do not use it for
|
|
309
|
+
ordinary rework (CHANGES_NEEDED) or for defective criteria a planner can rewrite
|
|
310
|
+
(`replanIds`).
|
|
311
|
+
|
|
212
312
|
## Output schema
|
|
213
313
|
|
|
214
314
|
The canonical machine-readable contract for this output lives in the sibling file
|
|
@@ -226,6 +326,12 @@ placeholder):
|
|
|
226
326
|
"kb_promotions": [
|
|
227
327
|
{ "id": "kb-0042", "reason": "verified against src/auth/token.ts:88 and the expired-token test" }
|
|
228
328
|
],
|
|
329
|
+
"kb_discards": [
|
|
330
|
+
{ "id": "kb-0051", "reason": "src/auth/session.ts:40 refreshes eagerly; the entry's lazy-refresh claim is wrong" }
|
|
331
|
+
],
|
|
332
|
+
"kb_demotions": [
|
|
333
|
+
{ "id": "kb-0033", "reason": "re-ran the reopen test this entry cites and it now fails", "evidence_files": ["test/reopen.test.mjs"] }
|
|
334
|
+
],
|
|
229
335
|
"kb_captures": [
|
|
230
336
|
{
|
|
231
337
|
"type": "knowledge",
|
|
@@ -234,12 +340,15 @@ placeholder):
|
|
|
234
340
|
"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.",
|
|
235
341
|
"source_files": ["src/auth/token.ts", "src/auth/retry.ts"]
|
|
236
342
|
}
|
|
237
|
-
]
|
|
343
|
+
],
|
|
344
|
+
"toolUse": { "kb": "used", "code": "used" }
|
|
238
345
|
}
|
|
239
346
|
```
|
|
240
347
|
|
|
241
|
-
`kb_promotions` and `kb_captures` are
|
|
242
|
-
have nothing to promote or capture
|
|
348
|
+
`kb_promotions`, `kb_discards`, `kb_demotions` and `kb_captures` are all optional --
|
|
349
|
+
omit them, or send `[]`, when you have nothing to promote, discard, demote or capture
|
|
350
|
+
this round. `toolUse` is
|
|
351
|
+
optional in the schema but expected: see Step 0.
|
|
243
352
|
|
|
244
353
|
**Precedence**: If your dispatch prompt includes a JSON schema instruction, that schema is
|
|
245
354
|
authoritative -- respond with exactly that JSON and nothing else. It is expected to match
|
|
@@ -257,3 +366,7 @@ or as prose if you are answering a human directly.
|
|
|
257
366
|
- NEVER mutate beads directly -- no `bd update`, `bd close`, `bd create`, `bd reopen`.
|
|
258
367
|
Return `reopenIds`/`newTasks` and let the orchestrator apply the transitions.
|
|
259
368
|
- NEVER write feedback.md -- return structured output only
|
|
369
|
+
|
|
370
|
+
## Shell command discipline
|
|
371
|
+
|
|
372
|
+
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
|
}
|
|
@@ -12,6 +12,11 @@
|
|
|
12
12
|
},
|
|
13
13
|
"notes": {
|
|
14
14
|
"type": "string"
|
|
15
|
+
},
|
|
16
|
+
"failedStep": {
|
|
17
|
+
"type": "string",
|
|
18
|
+
"enum": ["permissions"],
|
|
19
|
+
"description": "Set to \"permissions\" ONLY when you returned deployed: false because you stopped at Step 0a (the deploy.md Permissions check) before running any deploy command. The orchestrator then does not dispatch the deploy again this run. Omit it for every other outcome, including any failure after a deploy command ran."
|
|
15
20
|
}
|
|
16
21
|
}
|
|
17
22
|
}
|