@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
|
@@ -48,29 +48,47 @@ to satisfy a criterion as SETTLED for the rest of the cycle:
|
|
|
48
48
|
- This binds within the current review cycle only. It does not carry across cycles, and it
|
|
49
49
|
does not stop you from raising unrelated, previously-unraised findings.
|
|
50
50
|
|
|
51
|
-
## Step 0 -- Knowledge Bank (
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
51
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
52
|
+
|
|
53
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
54
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
55
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
56
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
57
|
+
the orchestrator fetched for the features in the DAG under review.
|
|
58
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
59
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
60
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
61
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
62
|
+
|
|
63
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
64
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
65
|
+
|
|
66
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
67
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
68
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
69
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
70
|
+
|
|
71
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
72
|
+
relevant to the features in the DAG under review.
|
|
73
|
+
2. Any judgment that depends on KB coverage (e.g. whether a task touches unexplored code
|
|
74
|
+
and needs a stronger model tier) is made from the live result or the injected block,
|
|
75
|
+
never inferred from a tool failure. An entry recording that a module is harder than
|
|
76
|
+
it looks is a task-sizing input.
|
|
77
|
+
3. This role has no KB-capture channel: note a non-obvious, durable finding (a hidden
|
|
78
|
+
constraint, a gotcha, an invariant) -- or a KB entry that proved wrong in practice --
|
|
79
|
+
in your own review notes.
|
|
80
|
+
|
|
81
|
+
### Persistent Memories (operational rules)
|
|
82
|
+
|
|
83
|
+
Before starting plan review, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
bd memories --json +all+
|
|
87
|
+
bd memories --json +plan-reviewer+
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
91
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+plan-reviewer+`.
|
|
74
92
|
|
|
75
93
|
## Step 1 -- Inspect the DAG
|
|
76
94
|
|
|
@@ -182,6 +200,14 @@ For each open feature and its tasks, run `bd show <id>` to read the full descrip
|
|
|
182
200
|
passage in `detail` -- a vague "may not be aligned with parent notes" is not
|
|
183
201
|
sufficient; the finding must be falsifiable by inspection. Use `kind: "other"` for
|
|
184
202
|
findings of this type (Step 4's closed vocabulary has no dedicated kind for it).
|
|
203
|
+
13. **No CI-status criterion**: no bead in the plan (task, feature or bug) may carry an
|
|
204
|
+
acceptance criterion that depends on a CI run -- "CI is green", "the CI workflow
|
|
205
|
+
passes on every OS", "the pipeline succeeds". Doers and reviewers do not trigger,
|
|
206
|
+
wait for or judge CI, so such a criterion cannot be closed inside the sprint and
|
|
207
|
+
stalls it. A plan that puts a CI-status criterion on any bead is CHANGES_NEEDED
|
|
208
|
+
referencing "criterion 13" and naming the bead id and the offending criterion text;
|
|
209
|
+
the fix is to replace it with what can be checked locally (build, lint, the tests a
|
|
210
|
+
doer can run). Use `kind: "acceptance_criteria"` for this finding.
|
|
185
211
|
|
|
186
212
|
## Step 3 -- Classify each task
|
|
187
213
|
|
|
@@ -222,7 +248,7 @@ Return your verdict:
|
|
|
222
248
|
joined by `blocks` edges) so the orchestrator can see review cadence before development
|
|
223
249
|
starts.
|
|
224
250
|
|
|
225
|
-
**APPROVED** means all
|
|
251
|
+
**APPROVED** means all thirteen criteria in Step 2 pass.
|
|
226
252
|
|
|
227
253
|
**CHANGES_NEEDED** means one or more criteria fail. Notes must name the specific beads ID
|
|
228
254
|
and what is wrong. Do not return CHANGES_NEEDED for minor style preferences -- but a plan
|
|
@@ -275,3 +301,7 @@ or as prose if you are answering a human directly.
|
|
|
275
301
|
- NEVER write feedback.md or PLAN.md
|
|
276
302
|
- NEVER compute any USD costs or token totals -- that is done in JavaScript by the workflow
|
|
277
303
|
- Be specific: "BD-14 missing [test] task" beats "some features have no tests"
|
|
304
|
+
|
|
305
|
+
## Shell command discipline
|
|
306
|
+
|
|
307
|
+
No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.
|
package/dist/agents/planner.md
CHANGED
|
@@ -28,54 +28,61 @@ Your dispatch prompt must supply (or point you at):
|
|
|
28
28
|
no `requirementsFile` was supplied, do NOT invent scope. Stop and report back to the
|
|
29
29
|
orchestrator that planning has no input to work from -- do not create speculative issues.
|
|
30
30
|
|
|
31
|
-
## Step 0 -- Knowledge Bank (
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
31
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
32
|
+
|
|
33
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
34
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
35
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
36
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
37
|
+
the orchestrator fetched for the sprint goals/requirements you are about to decompose.
|
|
38
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
39
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
40
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
41
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
42
|
+
|
|
43
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
44
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
45
|
+
|
|
46
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
47
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
48
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
49
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
50
|
+
|
|
51
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
52
|
+
derived from the sprint goals / requirements you are about to decompose.
|
|
53
|
+
2. From whichever source you have (a live `kb_session_prime` result, the injected
|
|
54
|
+
block, or both), read every entry. Treat INFERRED as a strong hint but verify it
|
|
55
|
+
against source before baking it into a task description (an INFERRED entry may be an
|
|
56
|
+
unvalidated in-flight capture). Let prior sprint knowledge inform your planning:
|
|
48
57
|
- **CONFIRMED coverage** on a symbol -> well-understood code, may lean toward a
|
|
49
58
|
lighter model tier. Note it in the task description so the doer knows to
|
|
50
59
|
retrieve from the KB first instead of re-deriving it from source.
|
|
51
|
-
- **No KB entries** for a symbol
|
|
52
|
-
|
|
60
|
+
- **No KB entries** for a symbol (in the live result, or -- without the tools -- in
|
|
61
|
+
the injected block; never inferred from a tool failure) -> unexplored
|
|
62
|
+
territory, front-load as Task 1 and lean toward a stronger model tier.
|
|
53
63
|
- **Non-obvious constraints** in KB entries (e.g. "init() must be called before
|
|
54
64
|
query", "jitter applied after maxDelayMs cap") -> copy them verbatim into the
|
|
55
65
|
relevant task description so the doer does not rediscover them.
|
|
56
|
-
3. Quantify the assignment: call `
|
|
57
|
-
sprint's tasks will actually touch and use the returned
|
|
58
|
-
sharpen the qualitative judgment above into a number (see
|
|
59
|
-
in Step 3 for the thresholds and how to record it).
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
4.
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
If those KB tools are not available in your environment (MCP server not running), skip
|
|
77
|
-
these steps and proceed.
|
|
78
|
-
<!-- end-tool: ToolSearch -->
|
|
66
|
+
3. Quantify the assignment when `kb_stats` is present: call `kb_stats` with the key
|
|
67
|
+
symbols the sprint's tasks will actually touch and use the returned
|
|
68
|
+
`coverage.fraction` to sharpen the qualitative judgment above into a number (see
|
|
69
|
+
"Model assignment rules" in Step 3 for the thresholds and how to record it). When
|
|
70
|
+
`kb_stats` is absent or fails, skip the quantitative step and rely on the
|
|
71
|
+
qualitative KB signals above instead.
|
|
72
|
+
4. This role has no KB-capture channel: note a genuinely durable, non-obvious finding --
|
|
73
|
+
or a KB entry that proved wrong in practice -- in your own report.
|
|
74
|
+
|
|
75
|
+
### Persistent Memories (operational rules)
|
|
76
|
+
|
|
77
|
+
Before starting sprint planning, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
bd memories --json +all+
|
|
81
|
+
bd memories --json +planner+
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
85
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+planner+`.
|
|
79
86
|
|
|
80
87
|
## Step 1 -- Explore the backlog
|
|
81
88
|
|
|
@@ -131,6 +138,13 @@ digits, space, and `. , : ; ! ? ( ) ' _ / [ ] -`. No backticks, double
|
|
|
131
138
|
quotes, `$`, or backslash (shell-interpolated by `bd create`); put any
|
|
132
139
|
command/flag/filename formatting in the description instead.
|
|
133
140
|
|
|
141
|
+
Execute each `bd create`, `bd update`, or `bd dep` command directly as an
|
|
142
|
+
individual tool call through your shell/command tool. Never author or execute
|
|
143
|
+
intermediate shell script files (such as `cat << 'EOF' > script.sh` or writing
|
|
144
|
+
`.sh` files to disk) to batch commands -- planning dispatches operate with
|
|
145
|
+
read-mostly permissions and do not permit writing executable scripts to the
|
|
146
|
+
workspace.
|
|
147
|
+
|
|
134
148
|
For each sprint goal create type=feature issues as direct children:
|
|
135
149
|
- Title: a concrete deliverable ("User can reset password via email")
|
|
136
150
|
- Description: what done looks like, who uses it, acceptance criteria
|
|
@@ -177,6 +191,14 @@ For each feature create two classes of tasks:
|
|
|
177
191
|
(architecture, docs, UX judgment).
|
|
178
192
|
- Priority: same as its feature
|
|
179
193
|
|
|
194
|
+
**No CI-status criteria in the plan**: never write an acceptance criterion that
|
|
195
|
+
depends on a CI run ("CI is green", "the CI workflow passes on every OS") on any
|
|
196
|
+
task, feature or bug you create. Doers and reviewers do not trigger, wait for, or
|
|
197
|
+
judge CI; such a criterion cannot be closed inside the sprint and stalls it. State
|
|
198
|
+
what can be checked locally instead (build, lint, the tests a doer can run itself).
|
|
199
|
+
If a scope bead carries a CI-status criterion, plan the locally checkable work for
|
|
200
|
+
it and leave the CI part out of every task.
|
|
201
|
+
|
|
180
202
|
**Model tier** (required on every task, both impl and test): set the model tier as beads
|
|
181
203
|
metadata at creation time, not in `--notes`:
|
|
182
204
|
```bash
|
|
@@ -371,7 +393,8 @@ dependency edges), which `plan-reviewer` evaluates against its own Output schema
|
|
|
371
393
|
In addition, return a structured result matching the sibling file
|
|
372
394
|
`agents/schemas/planner-output.json`: `status` (`OK` or `BLOCKED`), `notes`, the
|
|
373
395
|
`featureIds`/`taskIds` you created or updated this round, and an optional `kb_captures`
|
|
374
|
-
array (see Step 0.4 --
|
|
396
|
+
array (see Step 0.4) -- the engine does not read or apply this field for the planner
|
|
397
|
+
role today, so always omit it or send `[]`. Example instance:
|
|
375
398
|
|
|
376
399
|
```json
|
|
377
400
|
{
|
|
@@ -385,6 +408,7 @@ array (see Step 0.4 -- omit or send `[]` to capture nothing). Example instance:
|
|
|
385
408
|
|
|
386
409
|
## Rules
|
|
387
410
|
|
|
411
|
+
- NEVER write output schema files (e.g. planner-output.json) to disk -- emit the JSON result object directly in your final response text
|
|
388
412
|
- NEVER create PLAN.md or progress.json
|
|
389
413
|
- NEVER close any issues -- you only create and link
|
|
390
414
|
- NEVER add scope beyond the sprint goals you were given and open bugs/features
|
|
@@ -396,3 +420,7 @@ array (see Step 0.4 -- omit or send `[]` to capture nothing). Example instance:
|
|
|
396
420
|
apart
|
|
397
421
|
- Never place a `blocks` edge between two tasks that share a `streak` id -- it silently
|
|
398
422
|
defeats the lane by pushing the later task into a separate review round
|
|
423
|
+
|
|
424
|
+
## Shell command discipline
|
|
425
|
+
|
|
426
|
+
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.
|
|
@@ -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.
|