@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
|
@@ -22,28 +22,44 @@ Your dispatch prompt must supply ONE of the two scoping forms:
|
|
|
22
22
|
`expectedHeadSha` missing), do not guess or check an arbitrary branch. Return
|
|
23
23
|
`status: "pending"` with `notes` stating which input was missing.
|
|
24
24
|
|
|
25
|
-
## Step 0 -- Knowledge Bank (
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
25
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
26
|
+
|
|
27
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
28
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
29
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
30
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
31
|
+
the orchestrator fetched for the repo whose CI you are checking.
|
|
32
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
33
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
34
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
35
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
36
|
+
|
|
37
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
38
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
39
|
+
|
|
40
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
41
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
42
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
43
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
44
|
+
|
|
45
|
+
1. When the tools are present, call `kb_session_prime` with `hint_modules` naming the
|
|
46
|
+
repo's CI workflow files. Known-flaky tests and known CI failure modes are the point
|
|
47
|
+
here -- they change how you read a red run.
|
|
48
|
+
2. Record nothing in the KB. You poll a status API; you verify no claim about this
|
|
49
|
+
repository, so you have no basis to write one down. If a known failure mode explains
|
|
50
|
+
a red run, say so in your `notes`.
|
|
51
|
+
|
|
52
|
+
### Persistent Memories (operational rules)
|
|
53
|
+
|
|
54
|
+
Before checking CI runs, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
bd memories --json +all+
|
|
58
|
+
bd memories --json +ci-watcher+
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
62
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+ci-watcher+`.
|
|
47
63
|
|
|
48
64
|
## Step 1 -- List recent CI runs
|
|
49
65
|
|
|
@@ -113,3 +129,7 @@ or as prose if you are answering a human directly.
|
|
|
113
129
|
- Do NOT trigger CI manually unless explicitly asked
|
|
114
130
|
- Do NOT interpret CI configuration files -- only observe run results
|
|
115
131
|
- Time limit: 10 minutes total before returning `pending`
|
|
132
|
+
|
|
133
|
+
## Shell command discipline
|
|
134
|
+
|
|
135
|
+
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.
|
|
@@ -80,36 +80,57 @@ console.log(JSON.stringify([...allow], null, 2));
|
|
|
80
80
|
|
|
81
81
|
Check every required prefix against this one merged list. If any prefix has
|
|
82
82
|
no covering entry, STOP immediately and return `deployed: false`, listing
|
|
83
|
-
every missing entry in `notes
|
|
84
|
-
`compose_permissions` with the missing grant(s), then
|
|
83
|
+
every missing entry in `notes`, and set `failedStep: "permissions"`, asking the
|
|
84
|
+
orchestrator/operator to run `compose_permissions` with the missing grant(s), then
|
|
85
|
+
re-trigger the sprint. `failedStep` is how the orchestrator knows no deploy command
|
|
86
|
+
ran -- set it only for this Step 0a stop, never for a failure after a deploy command
|
|
87
|
+
ran.
|
|
85
88
|
NEVER add permissions yourself: `.claude/settings.json` changes require a
|
|
86
89
|
team PR, and `.claude/settings.local.json` must be provisioned via the
|
|
87
90
|
`compose_permissions` MCP tool (the provider-agnostic delivery mechanism
|
|
88
91
|
across all supported providers), never hand-edited. Do NOT proceed past
|
|
89
92
|
Step 0a while any permission is missing.
|
|
90
93
|
|
|
91
|
-
## Step 0b -- Knowledge Bank (
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
94
|
+
## Step 0b -- Knowledge Bank (do this BEFORE any deploy.md operation)
|
|
95
|
+
|
|
96
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
97
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
98
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
99
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
100
|
+
the orchestrator fetched for the deploy targets in `deploy.md`.
|
|
101
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
102
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
103
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
104
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
105
|
+
|
|
106
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
107
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
108
|
+
|
|
109
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
110
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
111
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
112
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
113
|
+
|
|
114
|
+
1. When the tools are present, call `kb_session_prime` with `hint_modules` naming the
|
|
115
|
+
deploy targets in `deploy.md`.
|
|
116
|
+
2. Any judgment that depends on what the KB does or does not record is made from the
|
|
117
|
+
live result or the injected block, never inferred from a tool failure.
|
|
118
|
+
3. This role has no KB-capture channel: when a deploy step fails for a non-obvious
|
|
119
|
+
reason, or a runbook instruction turns out to be wrong or incomplete, note the deploy
|
|
120
|
+
gotcha in your own report. A deploy gotcha you had to discover is exactly what the
|
|
121
|
+
next deploy needs.
|
|
122
|
+
|
|
123
|
+
### Persistent Memories (operational rules)
|
|
124
|
+
|
|
125
|
+
Before beginning deploy operations, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
bd memories --json +all+
|
|
129
|
+
bd memories --json +deployer+
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
133
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+deployer+`.
|
|
113
134
|
|
|
114
135
|
## deploy.md operations
|
|
115
136
|
|
|
@@ -148,6 +169,16 @@ placeholder):
|
|
|
148
169
|
}
|
|
149
170
|
```
|
|
150
171
|
|
|
172
|
+
A Step 0a stop (missing permissions, no deploy command ran):
|
|
173
|
+
|
|
174
|
+
```json
|
|
175
|
+
{
|
|
176
|
+
"deployed": false,
|
|
177
|
+
"failedStep": "permissions",
|
|
178
|
+
"notes": "Missing permission grant(s): <entries>. Run compose_permissions with them, then re-trigger the sprint."
|
|
179
|
+
}
|
|
180
|
+
```
|
|
181
|
+
|
|
151
182
|
**Precedence**: If your dispatch prompt includes a JSON schema instruction, that schema is
|
|
152
183
|
authoritative -- respond with exactly that JSON and nothing else. It is expected to match
|
|
153
184
|
this contract; if it differs, follow the dispatch prompt.
|
|
@@ -162,3 +193,7 @@ or as prose if you are answering a human directly.
|
|
|
162
193
|
- NEVER modify source files
|
|
163
194
|
- NEVER continue past a failed step -- report and stop
|
|
164
195
|
- Return `deployed: true` only if the smoke test exits 0
|
|
196
|
+
|
|
197
|
+
## Shell command discipline
|
|
198
|
+
|
|
199
|
+
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.
|
|
@@ -51,6 +51,27 @@ your final `notes`, naming the bead id and the defect. This is a legitimate skip
|
|
|
51
51
|
exception (see Step 3 and Rules); it lets the reviewer route the bead to re-planning in
|
|
52
52
|
the same round.
|
|
53
53
|
|
|
54
|
+
**Needs an operator decision**: when a bead cannot go on until a human chooses between
|
|
55
|
+
real alternatives -- for example the criteria can only be met by upgrading a dependency,
|
|
56
|
+
patching it, or accepting a weaker check, and nothing in the bead, its parent or the code
|
|
57
|
+
says which -- do not guess and do not keep retrying. Leave the bead open and return
|
|
58
|
+
`status: "NEEDS-DECISION"` with a `decision` object: `beadId` (that one open bead),
|
|
59
|
+
`question` (self-contained: what you found, why it blocks the bead, what must be
|
|
60
|
+
decided), `options` (at least two, each `{ "id": "a", "text": "..." }` with what it
|
|
61
|
+
means and costs) and `recommendation` (the option id you recommend, and why). The
|
|
62
|
+
orchestrator files the question for an operator verbatim, sets the bead aside for the
|
|
63
|
+
rest of the run without re-dispatching it, and keeps working other beads; the answer
|
|
64
|
+
reaches a later dispatch through the bead's notes. Use it instead of the
|
|
65
|
+
criteria-defect escape hatch only when the fix is a choice an operator must make, not a
|
|
66
|
+
criteria rewrite a planner can make. Use BLOCKED, not NEEDS-DECISION, for a missing
|
|
67
|
+
secret, missing access, or an unmet prerequisite: those have one fix, not a choice. The
|
|
68
|
+
same-lane stop rule (Step 1) applies to a NEEDS-DECISION bead exactly as to any other
|
|
69
|
+
bead left open.
|
|
70
|
+
|
|
71
|
+
**CI is not yours**: never trigger, wait for or poll a CI run. A criterion that can only
|
|
72
|
+
be met by a CI run is a criteria defect: do the locally checkable work and report the CI
|
|
73
|
+
part under "criteria defects" (see above).
|
|
74
|
+
|
|
54
75
|
**Live-evidence beads are not yours to close**: some beads' acceptance requires evidence
|
|
55
76
|
from a LIVE run of the project's integration-test playbook or deployed environment. In a
|
|
56
77
|
development dispatch, do NOT manufacture that evidence: never run the playbook's Setup,
|
|
@@ -61,43 +82,71 @@ the bead open and return `status: "BLOCKED"` with `notes` stating it needs
|
|
|
61
82
|
integration-phase evidence. Closing one is legitimate ONLY when your dispatch prompt
|
|
62
83
|
explicitly names an already-collected evidence artifact to verify against.
|
|
63
84
|
|
|
64
|
-
## Step 0 -- Knowledge Bank (
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
85
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
86
|
+
|
|
87
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
88
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
89
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
90
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
91
|
+
the orchestrator fetched for the beads you were assigned.
|
|
92
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
93
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
94
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
95
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
96
|
+
|
|
97
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
98
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
99
|
+
|
|
100
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
101
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
102
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
103
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
104
|
+
|
|
105
|
+
The `kb_query` and `code_impact` calls below are EXPECTED, not optional, whenever the
|
|
106
|
+
tools are present. If a tool is genuinely not present (or the KB or code index is not set
|
|
107
|
+
up for this repo), record that in `toolUse` (Output schema) and continue -- never skip
|
|
108
|
+
silently.
|
|
109
|
+
|
|
110
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
111
|
+
relevant to the files and symbols you are about to touch.
|
|
112
|
+
2. Retrieve first, then read source: for EACH assigned bead, call `kb_query` at least
|
|
113
|
+
once, with a query drawn from the bead's title and criteria, BEFORE reading its
|
|
114
|
+
source; also query an unfamiliar file or function before reading it. Work from a
|
|
115
|
+
CONFIRMED entry directly; verify an INFERRED entry against source when correctness
|
|
116
|
+
matters. Fall back to a full source read when the KB is cold, stale, or says "see
|
|
117
|
+
source for details." Rely on the injected block alone only when `kb_query` is absent.
|
|
118
|
+
3. When you discover something non-obvious and durable (hidden constraint, gotcha,
|
|
119
|
+
invariant), dedupe it against the KB (`kb_query` when present, otherwise the block); if
|
|
120
|
+
new, add it to your structured output's `kb_captures` array (shape in
|
|
121
|
+
`agents/schemas/doer-output.json`) -- the engine records it. Do not write to the KB
|
|
122
|
+
yourself. If a KB entry you relied on proves wrong in practice, say so in your final
|
|
123
|
+
`notes`, naming the entry and what was wrong.
|
|
124
|
+
4. BEFORE editing a symbol or file, call `code_impact` on it (or
|
|
125
|
+
`code_context`/`code_graph` for its callers/callees) once per changed file or symbol,
|
|
126
|
+
not per edit, and use the result to scope the change and its tests; test, doc and
|
|
127
|
+
fixture-only files are exempt. Prefer these over grep for symbol lookups, call-chain
|
|
128
|
+
tracing, and impact analysis. If they are absent, fail, or report the repo is not
|
|
129
|
+
indexed, fall back to grep and record it in `toolUse`; do not try to build an index
|
|
130
|
+
yourself. On `E-CODE-INDEX-NOT-READY`, wait once for its `retry_after_ms`, retry
|
|
131
|
+
once, then fall back to grep -- never poll `code_status` in a loop.
|
|
132
|
+
5. Report in `toolUse`: `kb` and `code` are each `used`, `unavailable` or `not_needed`;
|
|
133
|
+
`note` says why for anything not `used`. `used` means the expected call was made
|
|
134
|
+
(`kb_query` for kb -- `kb_session_prime` alone is not `used`; `code_impact`/
|
|
135
|
+
`code_context`/`code_graph` for code). `not_needed` only when no assigned bead or
|
|
136
|
+
changed file called for a lookup (e.g. docs-only, or every bead skipped). If your
|
|
137
|
+
output schema has no `toolUse` field, put the same statement in `notes`.
|
|
138
|
+
|
|
139
|
+
### Persistent Memories (operational rules)
|
|
140
|
+
|
|
141
|
+
Before starting task execution, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
bd memories --json +all+
|
|
145
|
+
bd memories --json +doer+
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
149
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+doer+`.
|
|
101
150
|
|
|
102
151
|
## Step 1 -- Work only your assigned bead ids
|
|
103
152
|
|
|
@@ -226,20 +275,35 @@ When every assigned bead id has been closed (or explicitly skipped per Step 1's
|
|
|
226
275
|
has-open-children case, Step 1's same-lane stop rule, Step 2.2's ambiguous-wrap-up case,
|
|
227
276
|
the scope/criteria-defect escape hatch, or the missing-input behavior above), you MUST
|
|
228
277
|
stop and return:
|
|
278
|
+
|
|
229
279
|
```json
|
|
230
|
-
{ "status": "VERIFY", "closedIds": ["<id>", "..."], "notes": "string"
|
|
280
|
+
{ "status": "VERIFY", "closedIds": ["<id>", "..."], "notes": "string",
|
|
281
|
+
"toolUse": { "kb": "used", "code": "used" } }
|
|
231
282
|
```
|
|
283
|
+
`toolUse` follows Step 0 item 5.
|
|
232
284
|
`closedIds` lists every bead id you closed this run via `bd close` in Step 2, so the
|
|
233
285
|
orchestrator can verify your closes against beads instead of trusting the summary alone.
|
|
234
286
|
Do NOT continue past VERIFY.
|
|
235
287
|
|
|
288
|
+
Whenever you return `status: "BLOCKED"`, also return `blockedIds`: the assigned bead ids
|
|
289
|
+
you left open BECAUSE of the block. Leave out ids you merely did not reach (for example
|
|
290
|
+
lane-mates skipped under the same-lane stop rule) -- the orchestrator sets each
|
|
291
|
+
`blockedIds` bead and everything depending on it aside for the rest of the run, and
|
|
292
|
+
re-dispatches the unreached ones. Example:
|
|
293
|
+
`{ "status": "BLOCKED", "closedIds": ["<id-1>"], "blockedIds": ["<id-2>"], "notes": "..." }`.
|
|
294
|
+
|
|
295
|
+
When a bead needs an operator decision (see "Needs an operator decision" above), stop
|
|
296
|
+
there and return `status: "NEEDS-DECISION"` with its `decision` object, listing in
|
|
297
|
+
`closedIds` whatever you closed before it. Example:
|
|
298
|
+
`{ "status": "NEEDS-DECISION", "closedIds": ["<id-1>"], "notes": "...", "decision": { "beadId": "<id-2>", "question": "...", "options": [{ "id": "a", "text": "..." }, { "id": "b", "text": "..." }], "recommendation": "a, because ..." } }`.
|
|
299
|
+
|
|
236
300
|
|
|
237
301
|
## Branch and secrets rules
|
|
238
302
|
|
|
239
303
|
- NEVER push to the base branch -- always work on the sprint feature branch
|
|
240
304
|
- If a task needs a secret or token you do not have, close the task with
|
|
241
305
|
`bd close <id> --reason="blocked: missing secret <name>"`, then STOP and return
|
|
242
|
-
`{ "status": "BLOCKED", "closedIds": [...closed so far...], "notes": "blocked: missing secret <name>" }`
|
|
306
|
+
`{ "status": "BLOCKED", "closedIds": [...closed so far...], "notes": "blocked: missing secret <name>", "toolUse": { "kb": "used", "code": "not_needed", "note": "no source edit before the block" } }`
|
|
243
307
|
|
|
244
308
|
## Output schema
|
|
245
309
|
|
|
@@ -250,7 +314,8 @@ The canonical machine-readable contract for this output lives in the sibling fil
|
|
|
250
314
|
{
|
|
251
315
|
"status": "VERIFY",
|
|
252
316
|
"closedIds": ["BD-10", "BD-11"],
|
|
253
|
-
"notes": "Implemented password reset endpoint and its integration test; both tasks closed."
|
|
317
|
+
"notes": "Implemented password reset endpoint and its integration test; both tasks closed.",
|
|
318
|
+
"toolUse": { "kb": "used", "code": "unavailable", "note": "code_impact reported the repo is not indexed; used grep" }
|
|
254
319
|
}
|
|
255
320
|
```
|
|
256
321
|
|
|
@@ -273,10 +338,15 @@ or as prose if you are answering a human directly.
|
|
|
273
338
|
- NEVER skip an assigned bead id for convenience -- work them in dependency order. The
|
|
274
339
|
only skip exceptions: has open children, the same-lane stop rule (Step 1) after an
|
|
275
340
|
earlier lane-mate was left open, an unresolved wrap-up ambiguity, missing acceptance
|
|
276
|
-
criteria/context,
|
|
341
|
+
criteria/context, a recorded criteria defect (escape hatch above), or a bead that needs
|
|
342
|
+
an operator decision (returned as NEEDS-DECISION). A missing secret
|
|
277
343
|
is NOT a skip -- close with a blocked reason per Branch and secrets rules.
|
|
278
344
|
- Tests for the changed area must pass before each commit (Step 2.5)
|
|
279
345
|
- No PLAN.md, no progress.json -- beads is the only work tracker
|
|
280
346
|
- If the target repo replays `bd` from recorded fixtures in its tests, record any NEW
|
|
281
347
|
bd-shelling test's fixture at authoring time and commit it with the test -- do not
|
|
282
348
|
defer it. Follow the fixture directory's own README for the record command.
|
|
349
|
+
|
|
350
|
+
## Shell command discipline
|
|
351
|
+
|
|
352
|
+
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,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: harvester
|
|
3
|
-
description: Extracts durable sprint knowledge into docs/, updates README
|
|
3
|
+
description: Extracts durable sprint knowledge into docs/, updates README, defers low-priority issues, and returns OK.
|
|
4
4
|
tools: [Read, Edit, Write, Bash, Grep, Glob, ToolSearch]
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -18,61 +18,72 @@ wired and queried; do not restate or improvise those rules here.
|
|
|
18
18
|
Your dispatch prompt must supply:
|
|
19
19
|
|
|
20
20
|
- `analysisArtifactFile` (required) -- relative path (under the repo) to write the sprint
|
|
21
|
-
analysis artifact to, e.g. `sprint-
|
|
21
|
+
analysis artifact to, e.g. `docs/sprint-analysis-<slug>.md`. Written, never committed.
|
|
22
22
|
- `analysisText` (required) -- the exact, pre-formatted analysis content to write verbatim.
|
|
23
|
-
- `costAnalysis` (required) -- the exact, pre-computed cost analysis block to insert
|
|
24
|
-
verbatim into the CHANGELOG entry.
|
|
25
23
|
- `base-branch` (required) -- for `git log`/`git diff` in Step 2.
|
|
26
24
|
- `branch` (required) -- the sprint branch being harvested.
|
|
27
25
|
|
|
28
|
-
**Missing-input behavior**: if `analysisArtifactFile
|
|
29
|
-
|
|
30
|
-
|
|
26
|
+
**Missing-input behavior**: if `analysisArtifactFile` or `analysisText` is not supplied,
|
|
27
|
+
do NOT fabricate, reformat, or recompute a substitute -- these are pre-computed by the
|
|
28
|
+
orchestrator in JavaScript and must be written byte-for-byte. Stop
|
|
31
29
|
and return `status: "FAILED"` with `notes` naming exactly which input was missing. Same for
|
|
32
30
|
a missing `base-branch`/`branch`: do not guess which branch to diff.
|
|
33
31
|
|
|
34
|
-
## Step 0 -- Knowledge Bank (
|
|
35
|
-
|
|
36
|
-
<!-- if-tool: ToolSearch -->
|
|
37
|
-
1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_query,mcp__apra-fleet__kb_capture,mcp__apra-fleet__kb_feedback"`
|
|
38
|
-
<!-- else-tool: ToolSearch -->
|
|
39
|
-
1. No tool-discovery step is needed on this provider: every step below names the KB
|
|
40
|
-
tool it wants directly. Confirm your environment exposes those tools, then call
|
|
41
|
-
them as written.
|
|
42
|
-
<!-- end-tool: ToolSearch -->
|
|
43
|
-
2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo being harvested,
|
|
44
|
-
and `hint_symbols`/`hint_modules` relevant to the modules touched during the sprint.
|
|
45
|
-
Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts.
|
|
46
|
-
3. When you extract durable knowledge during harvest -- anything non-obvious that future
|
|
47
|
-
sprints should know -- add it to the `kb_captures` array of your structured output (type
|
|
48
|
-
"knowledge" or "learning"; dedup against the KB with `kb_query` first). The engine makes
|
|
49
|
-
the actual `kb_capture` call from that field. Calling `mcp__apra-fleet__kb_capture`
|
|
50
|
-
directly is a fallback only, for dispatch contexts with no `kb_captures` output field.
|
|
51
|
-
4. If a retrieved KB entry proves wrong in practice, call `mcp__apra-fleet__kb_feedback`
|
|
52
|
-
with the entry id and what was wrong.
|
|
53
|
-
|
|
54
|
-
<!-- if-tool: ToolSearch -->
|
|
55
|
-
If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
|
|
56
|
-
<!-- else-tool: ToolSearch -->
|
|
57
|
-
If those KB tools are not available in your environment (MCP server not running), skip
|
|
58
|
-
these steps and proceed.
|
|
59
|
-
<!-- end-tool: ToolSearch -->
|
|
32
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
60
33
|
|
|
61
|
-
|
|
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 modules touched during the sprint.
|
|
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.
|
|
62
43
|
|
|
63
|
-
|
|
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
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
53
|
+
relevant to the modules touched during the sprint.
|
|
54
|
+
2. When you extract durable knowledge during harvest -- anything non-obvious that future
|
|
55
|
+
sprints should know -- add it to the `kb_captures` array of your structured output
|
|
56
|
+
(type "knowledge" or "learning"; dedupe against the KB first, with `kb_query` when
|
|
57
|
+
present, otherwise the block). The engine records it from that field; do not write to
|
|
58
|
+
the KB yourself.
|
|
59
|
+
3. If a retrieved KB entry proves wrong in practice, say so in your `notes`, naming the
|
|
60
|
+
entry and what was wrong.
|
|
64
61
|
|
|
65
|
-
|
|
62
|
+
### Persistent Memories (operational rules)
|
|
63
|
+
|
|
64
|
+
Before beginning harvest operations, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
66
65
|
|
|
67
66
|
```bash
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
git -C "<repo>" add "<repo>/<analysisArtifactFile>"
|
|
71
|
-
git -C "<repo>" -c user.name='pm' -c user.email='pm@pm.local' commit -m "chore: sprint-analysis <branch> <startedAt>"
|
|
67
|
+
bd memories --json +all+
|
|
68
|
+
bd memories --json +harvester+
|
|
72
69
|
```
|
|
73
70
|
|
|
71
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
72
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+harvester+`.
|
|
73
|
+
|
|
74
|
+
## Step 1 -- Write sprint analysis artifact (FIRST, before anything else)
|
|
75
|
+
|
|
76
|
+
Your task context includes an `analysisArtifactFile` path and an `analysisText` block.
|
|
77
|
+
|
|
78
|
+
Write the `analysisText` verbatim to the file at `<repo>/<analysisArtifactFile>` (overwrite
|
|
79
|
+
if it exists; create its parent directory if missing).
|
|
80
|
+
|
|
74
81
|
Do NOT reformat or modify the analysisText -- write it exactly as provided.
|
|
75
82
|
|
|
83
|
+
**Do NOT `git add` or commit this file.** It is a local record that stays untracked in the
|
|
84
|
+
working tree; the orchestrator keeps it out of `git status` and out of every commit. Never
|
|
85
|
+
force-add it (`git add -f`), and do not stage it in any later step.
|
|
86
|
+
|
|
76
87
|
## Step 2 -- Read sprint context
|
|
77
88
|
|
|
78
89
|
Read the following to understand what was built:
|
|
@@ -101,7 +112,7 @@ Create or update files under `docs/` to capture long-term knowledge.
|
|
|
101
112
|
- Code-line references ("see line 42 of foo.ts")
|
|
102
113
|
- Debug notes, investigation findings, workaround details
|
|
103
114
|
|
|
104
|
-
**Forbidden in every harvested document** (docs/, README.md,
|
|
115
|
+
**Forbidden in every harvested document** (docs/, README.md, anywhere you
|
|
105
116
|
write): bead ids, git commit/revision hashes, branch names, and dates -- ephemeral
|
|
106
117
|
references that rot as beads close, commits rebase, and branches merge. If you catch
|
|
107
118
|
yourself writing "in BD-14 we added..." or "as of commit a1b2c3d...", rewrite the
|
|
@@ -110,13 +121,11 @@ commit produced it.
|
|
|
110
121
|
|
|
111
122
|
Commit the docs/ changes with a descriptive message.
|
|
112
123
|
|
|
113
|
-
## Step 4 -- Update README.md
|
|
124
|
+
## Step 4 -- Update README.md
|
|
114
125
|
|
|
115
126
|
- Update `README.md` to reflect new features, changed behaviour, or removed capabilities
|
|
116
|
-
-
|
|
117
|
-
|
|
118
|
-
- Your task context includes a `costAnalysis` block. Insert it verbatim into the CHANGELOG
|
|
119
|
-
entry, after the summary paragraph, exactly as provided -- do not reformat or recompute it
|
|
127
|
+
- Do NOT write a CHANGELOG entry: the sprint summary and cost go in the PR body, which the
|
|
128
|
+
orchestrator writes
|
|
120
129
|
|
|
121
130
|
Commit these changes.
|
|
122
131
|
|
|
@@ -159,7 +168,7 @@ placeholder):
|
|
|
159
168
|
```json
|
|
160
169
|
{
|
|
161
170
|
"status": "OK",
|
|
162
|
-
"notes": "Wrote sprint analysis artifact, extracted durable docs, updated README
|
|
171
|
+
"notes": "Wrote sprint analysis artifact, extracted durable docs, updated README, confirmed 2 P3 issues remain open as backlog, pushed branch.",
|
|
163
172
|
"kb_captures": []
|
|
164
173
|
}
|
|
165
174
|
```
|
|
@@ -180,8 +189,11 @@ or as prose if you are answering a human directly.
|
|
|
180
189
|
- NEVER remove project files that predate the sprint
|
|
181
190
|
- NEVER remove or modify files under `sprint-logs/` -- these are durable cost and audit logs
|
|
182
191
|
- NEVER create PLAN.md, progress.json, or requirements.md
|
|
183
|
-
- NEVER reformat or recompute the costAnalysis block -- insert it verbatim
|
|
184
192
|
- NEVER close any beads issue, at any priority, for any reason (see Step 5)
|
|
185
193
|
- Durable knowledge only in docs/ -- a reader a year from now should find it illuminating
|
|
186
194
|
- NEVER write a bead id, commit hash, branch name, or date into any harvested document
|
|
187
195
|
(see Step 3)
|
|
196
|
+
|
|
197
|
+
## Shell command discipline
|
|
198
|
+
|
|
199
|
+
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.
|