@apralabs/apra-fleet 0.4.1 → 0.4.3
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 +53 -12
- package/dist/agents/backlog-groomer.md +42 -21
- package/dist/agents/ci-watcher.md +14 -0
- package/dist/agents/deployer.md +59 -46
- package/dist/agents/doer.md +157 -134
- package/dist/agents/harvester.md +31 -32
- package/dist/agents/integ-test-runner.md +92 -113
- package/dist/agents/kb-reconciler.md +40 -42
- package/dist/agents/plan-reviewer.md +139 -63
- package/dist/agents/planner.md +176 -100
- package/dist/agents/regression-test-runner.md +77 -81
- package/dist/agents/reviewer.md +69 -85
- package/dist/agents/schemas/integ-test-runner-output.json +1 -1
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/regression-test-runner-output.json +4 -17
- package/dist/cli/agent-transform.d.ts +83 -2
- package/dist/cli/agent-transform.d.ts.map +1 -1
- package/dist/cli/agent-transform.js +266 -21
- package/dist/cli/agent-transform.js.map +1 -1
- package/dist/cli/auth.d.ts.map +1 -1
- package/dist/cli/auth.js +29 -11
- package/dist/cli/auth.js.map +1 -1
- package/dist/cli/config.d.ts +7 -5
- package/dist/cli/config.d.ts.map +1 -1
- package/dist/cli/config.js +44 -43
- package/dist/cli/config.js.map +1 -1
- package/dist/cli/install.d.ts +33 -0
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +294 -61
- package/dist/cli/install.js.map +1 -1
- package/dist/cli/kb-directives.d.ts.map +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-directives.js.map +1 -1
- package/dist/cli/register-member.d.ts.map +1 -1
- package/dist/cli/register-member.js +7 -3
- package/dist/cli/register-member.js.map +1 -1
- package/dist/cli/start.d.ts.map +1 -1
- package/dist/cli/start.js +7 -0
- package/dist/cli/start.js.map +1 -1
- package/dist/cli/uninstall.d.ts.map +1 -1
- package/dist/cli/uninstall.js +5 -3
- package/dist/cli/uninstall.js.map +1 -1
- package/dist/cli/watch.d.ts +26 -3
- package/dist/cli/watch.d.ts.map +1 -1
- package/dist/cli/watch.js +41 -9
- package/dist/cli/watch.js.map +1 -1
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.d.ts.map +1 -1
- package/dist/commands/kb-server.js +43 -3
- package/dist/commands/kb-server.js.map +1 -1
- package/dist/index.js +3 -3
- package/dist/os/git-bash-candidates.d.ts +35 -0
- package/dist/os/git-bash-candidates.d.ts.map +1 -0
- package/dist/os/git-bash-candidates.js +46 -0
- package/dist/os/git-bash-candidates.js.map +1 -0
- package/dist/os/index.d.ts +13 -4
- package/dist/os/index.d.ts.map +1 -1
- package/dist/os/index.js +17 -2
- package/dist/os/index.js.map +1 -1
- package/dist/os/linux.d.ts +6 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +36 -3
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +68 -2
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/os-commands.js.map +1 -1
- package/dist/os/windows-gitbash.d.ts +98 -0
- package/dist/os/windows-gitbash.d.ts.map +1 -0
- package/dist/os/windows-gitbash.js +259 -0
- package/dist/os/windows-gitbash.js.map +1 -0
- package/dist/os/windows.d.ts +6 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +73 -8
- package/dist/os/windows.js.map +1 -1
- package/dist/providers/agy.d.ts +118 -8
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +580 -55
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +83 -4
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +365 -12
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +7 -4
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +24 -4
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +7 -4
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +27 -4
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/index.d.ts +0 -1
- package/dist/providers/index.d.ts.map +1 -1
- package/dist/providers/index.js +0 -3
- package/dist/providers/index.js.map +1 -1
- package/dist/providers/none.d.ts +7 -4
- package/dist/providers/none.d.ts.map +1 -1
- package/dist/providers/none.js +22 -4
- package/dist/providers/none.js.map +1 -1
- package/dist/providers/opencode.d.ts +6 -3
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +27 -4
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +215 -11
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +58 -2
- package/dist/providers/provider.js.map +1 -1
- package/dist/services/agent-provisioner.js +2 -2
- package/dist/services/agent-provisioner.js.map +1 -1
- package/dist/services/agy-project.d.ts +102 -0
- package/dist/services/agy-project.d.ts.map +1 -0
- package/dist/services/agy-project.js +356 -0
- package/dist/services/agy-project.js.map +1 -0
- package/dist/services/auth-socket.js +4 -4
- package/dist/services/auth-web.js +1 -1
- package/dist/services/cloud/activity.js +2 -2
- package/dist/services/cloud/activity.js.map +1 -1
- package/dist/services/cloud/lifecycle.d.ts.map +1 -1
- package/dist/services/cloud/lifecycle.js +33 -4
- package/dist/services/cloud/lifecycle.js.map +1 -1
- package/dist/services/context-admission.d.ts.map +1 -1
- package/dist/services/context-admission.js +9 -7
- package/dist/services/context-admission.js.map +1 -1
- package/dist/services/credential-cleanup.d.ts.map +1 -1
- package/dist/services/credential-cleanup.js +47 -10
- package/dist/services/credential-cleanup.js.map +1 -1
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.d.ts.map +1 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/exit-drain.js.map +1 -0
- package/dist/services/github-app.d.ts.map +1 -1
- package/dist/services/github-app.js +32 -4
- package/dist/services/github-app.js.map +1 -1
- package/dist/services/http-transport.d.ts +1 -0
- package/dist/services/http-transport.d.ts.map +1 -1
- package/dist/services/http-transport.js +48 -1
- package/dist/services/http-transport.js.map +1 -1
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.d.ts.map +1 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-config.js.map +1 -0
- package/dist/services/knowledge/kb-providers.d.ts +7 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +1 -1
- package/dist/services/knowledge/kb-providers.js +191 -17
- package/dist/services/knowledge/kb-providers.js.map +1 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +1 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/require-sqlite-project.js.map +1 -0
- package/dist/services/member-home.d.ts +1 -1
- package/dist/services/member-home.d.ts.map +1 -1
- package/dist/services/member-home.js +15 -12
- package/dist/services/member-home.js.map +1 -1
- package/dist/services/model-pricing.d.ts.map +1 -1
- package/dist/services/model-pricing.js +7 -8
- package/dist/services/model-pricing.js.map +1 -1
- package/dist/services/orphan-recovery.d.ts +6 -3
- package/dist/services/orphan-recovery.d.ts.map +1 -1
- package/dist/services/orphan-recovery.js +17 -14
- package/dist/services/orphan-recovery.js.map +1 -1
- package/dist/services/preflight-check.js +2 -2
- package/dist/services/preflight-check.js.map +1 -1
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.d.ts.map +1 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/secret-token.js.map +1 -0
- package/dist/services/service-manager/types.d.ts +3 -1
- package/dist/services/service-manager/types.d.ts.map +1 -1
- package/dist/services/service-manager/windows.d.ts +14 -2
- package/dist/services/service-manager/windows.d.ts.map +1 -1
- package/dist/services/service-manager/windows.js +65 -7
- package/dist/services/service-manager/windows.js.map +1 -1
- package/dist/services/shell-probe.d.ts +131 -0
- package/dist/services/shell-probe.d.ts.map +1 -0
- package/dist/services/shell-probe.js +210 -0
- package/dist/services/shell-probe.js.map +1 -0
- package/dist/services/singleton.d.ts +2 -0
- package/dist/services/singleton.d.ts.map +1 -1
- package/dist/services/singleton.js +1 -1
- package/dist/services/singleton.js.map +1 -1
- package/dist/services/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +60 -4
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/find-log-file.d.ts.map +1 -1
- package/dist/services/stall/find-log-file.js +22 -16
- package/dist/services/stall/find-log-file.js.map +1 -1
- package/dist/services/stall/read-log-tail.d.ts.map +1 -1
- package/dist/services/stall/read-log-tail.js +26 -15
- package/dist/services/stall/read-log-tail.js.map +1 -1
- package/dist/services/stall/stall-detector.d.ts +53 -4
- package/dist/services/stall/stall-detector.d.ts.map +1 -1
- package/dist/services/stall/stall-detector.js +212 -34
- package/dist/services/stall/stall-detector.js.map +1 -1
- package/dist/services/stall/stall-poller.d.ts.map +1 -1
- package/dist/services/stall/stall-poller.js +35 -42
- package/dist/services/stall/stall-poller.js.map +1 -1
- package/dist/services/strategy.d.ts +9 -0
- package/dist/services/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +119 -8
- package/dist/services/strategy.js.map +1 -1
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/substitution-engine.js.map +1 -1
- package/dist/services/tool-registry.d.ts.map +1 -1
- package/dist/services/tool-registry.js +5 -3
- package/dist/services/tool-registry.js.map +1 -1
- package/dist/services/user-config.js +1 -1
- package/dist/services/user-config.js.map +1 -1
- package/dist/services/vcs/azure-devops.d.ts +67 -2
- package/dist/services/vcs/azure-devops.d.ts.map +1 -1
- package/dist/services/vcs/azure-devops.js +281 -15
- package/dist/services/vcs/azure-devops.js.map +1 -1
- package/dist/services/vcs/bitbucket.d.ts.map +1 -1
- package/dist/services/vcs/bitbucket.js +16 -0
- package/dist/services/vcs/bitbucket.js.map +1 -1
- package/dist/services/vcs/github.d.ts.map +1 -1
- package/dist/services/vcs/github.js +24 -0
- package/dist/services/vcs/github.js.map +1 -1
- package/dist/services/vcs/types.d.ts +123 -2
- package/dist/services/vcs/types.d.ts.map +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +20 -1
- package/dist/skills/pm/SKILL.md +1 -2
- package/dist/skills/pm/cost.md +0 -4
- package/dist/skills/pm/fleet-addendum.md +2 -3
- package/dist/tools/check-status.d.ts +7 -4
- package/dist/tools/check-status.d.ts.map +1 -1
- package/dist/tools/check-status.js +5 -3
- package/dist/tools/check-status.js.map +1 -1
- package/dist/tools/cloud-control.js +2 -2
- package/dist/tools/cloud-control.js.map +1 -1
- package/dist/tools/compose-permissions.d.ts +6 -0
- package/dist/tools/compose-permissions.d.ts.map +1 -1
- package/dist/tools/compose-permissions.js +211 -50
- package/dist/tools/compose-permissions.js.map +1 -1
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts.map +1 -1
- package/dist/tools/execute-command.js +56 -29
- package/dist/tools/execute-command.js.map +1 -1
- package/dist/tools/execute-prompt.d.ts +15 -2
- package/dist/tools/execute-prompt.d.ts.map +1 -1
- package/dist/tools/execute-prompt.js +1214 -873
- package/dist/tools/execute-prompt.js.map +1 -1
- package/dist/tools/kb-capture.d.ts +2 -2
- package/dist/tools/kb-capture.d.ts.map +1 -1
- package/dist/tools/kb-capture.js +29 -5
- package/dist/tools/kb-capture.js.map +1 -1
- package/dist/tools/kb-export.d.ts +2 -2
- package/dist/tools/kb-export.d.ts.map +1 -1
- package/dist/tools/kb-export.js +3 -28
- package/dist/tools/kb-export.js.map +1 -1
- package/dist/tools/kb-feedback.d.ts.map +1 -1
- package/dist/tools/kb-feedback.js +3 -1
- package/dist/tools/kb-feedback.js.map +1 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +1 -1
- package/dist/tools/kb-freshness-sweep.js +3 -1
- package/dist/tools/kb-freshness-sweep.js.map +1 -1
- package/dist/tools/kb-import.d.ts.map +1 -1
- package/dist/tools/kb-import.js +2 -1
- package/dist/tools/kb-import.js.map +1 -1
- package/dist/tools/kb-list.d.ts.map +1 -1
- package/dist/tools/kb-list.js +3 -1
- package/dist/tools/kb-list.js.map +1 -1
- package/dist/tools/kb-query.d.ts +2 -2
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -1
- package/dist/tools/kb-reconcile-prefilter.js +3 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +1 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -1
- package/dist/tools/kb-resolve-contradiction.js +3 -1
- package/dist/tools/kb-resolve-contradiction.js.map +1 -1
- package/dist/tools/kb-setup.d.ts.map +1 -1
- package/dist/tools/kb-setup.js +125 -20
- package/dist/tools/kb-setup.js.map +1 -1
- package/dist/tools/kb-stats.d.ts.map +1 -1
- package/dist/tools/kb-stats.js +64 -43
- package/dist/tools/kb-stats.js.map +1 -1
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.d.ts.map +1 -1
- package/dist/tools/list-members.js +7 -2
- package/dist/tools/list-members.js.map +1 -1
- package/dist/tools/member-detail.d.ts +2 -2
- package/dist/tools/member-detail.d.ts.map +1 -1
- package/dist/tools/member-detail.js +22 -3
- package/dist/tools/member-detail.js.map +1 -1
- package/dist/tools/member-reservation.d.ts +58 -1
- package/dist/tools/member-reservation.d.ts.map +1 -1
- package/dist/tools/member-reservation.js +71 -18
- package/dist/tools/member-reservation.js.map +1 -1
- package/dist/tools/monitor-task.d.ts.map +1 -1
- package/dist/tools/monitor-task.js +17 -2
- package/dist/tools/monitor-task.js.map +1 -1
- package/dist/tools/provision-auth.d.ts +80 -1
- package/dist/tools/provision-auth.d.ts.map +1 -1
- package/dist/tools/provision-auth.js +147 -59
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +96 -3
- package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
- package/dist/tools/provision-vcs-auth.js +254 -88
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +21 -12
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +141 -16
- package/dist/tools/register-member.js.map +1 -1
- package/dist/tools/remove-member.d.ts.map +1 -1
- package/dist/tools/remove-member.js +29 -4
- package/dist/tools/remove-member.js.map +1 -1
- package/dist/tools/revoke-vcs-auth.js +2 -2
- package/dist/tools/revoke-vcs-auth.js.map +1 -1
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/setup-git-app.d.ts.map +1 -1
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/setup-git-app.js.map +1 -1
- package/dist/tools/setup-ssh-key.d.ts.map +1 -1
- package/dist/tools/setup-ssh-key.js +2 -1
- package/dist/tools/setup-ssh-key.js.map +1 -1
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.d.ts.map +1 -1
- package/dist/tools/shutdown-server.js +23 -1
- package/dist/tools/shutdown-server.js.map +1 -1
- package/dist/tools/stop-prompt.js +2 -2
- package/dist/tools/stop-prompt.js.map +1 -1
- package/dist/tools/update-agent-cli.js +2 -2
- package/dist/tools/update-agent-cli.js.map +1 -1
- package/dist/tools/update-member.d.ts +21 -12
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +61 -12
- package/dist/tools/update-member.js.map +1 -1
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.d.ts.map +1 -0
- package/dist/tools/vcs-credential-exec.js +197 -0
- package/dist/tools/vcs-credential-exec.js.map +1 -0
- package/dist/types.d.ts +24 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/agent-helpers.d.ts +36 -0
- package/dist/utils/agent-helpers.d.ts.map +1 -1
- package/dist/utils/agent-helpers.js +39 -1
- package/dist/utils/agent-helpers.js.map +1 -1
- package/dist/utils/log-helpers.d.ts.map +1 -1
- package/dist/utils/log-helpers.js +2 -2
- package/dist/utils/log-helpers.js.map +1 -1
- package/dist/utils/platform.d.ts +7 -0
- package/dist/utils/platform.d.ts.map +1 -1
- package/dist/utils/platform.js +11 -1
- package/dist/utils/platform.js.map +1 -1
- package/dist/utils/prompt-errors.d.ts.map +1 -1
- package/dist/utils/prompt-errors.js +7 -1
- package/dist/utils/prompt-errors.js.map +1 -1
- package/dist/utils/shell-escape.d.ts +16 -0
- package/dist/utils/shell-escape.d.ts.map +1 -1
- package/dist/utils/shell-escape.js +22 -2
- package/dist/utils/shell-escape.js.map +1 -1
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.d.ts.map +1 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/vcs-provider-detect.js.map +1 -0
- package/dist/utils/workspace-trust.d.ts +20 -17
- package/dist/utils/workspace-trust.d.ts.map +1 -1
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/utils/workspace-trust.js.map +1 -1
- package/dist/workflows/auto-sprint.js +180 -32
- package/package.json +7 -5
- package/packages/apra-fleet-client/src/client/api.mjs +403 -12
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +42 -21
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +14 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -46
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +157 -134
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +31 -32
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +92 -113
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +40 -42
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +139 -63
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +176 -100
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +77 -81
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +69 -85
- package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -3
- package/packages/apra-fleet-se/bin/cli.mjs +280 -3
- package/packages/apra-fleet-se/bin/serve.mjs +114 -5
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +481 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +491 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +282 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +208 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +638 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +301 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +8 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +199 -34
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +516 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +184 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1121 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +10 -8
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +285 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +12 -12
- package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +275 -99
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1054 -39
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +308 -0
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +556 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +495 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +564 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +728 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +252 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +581 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +136 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +822 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +294 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +403 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +180 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +390 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +323 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +232 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +174 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +197 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +305 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +559 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1416 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1672 -9072
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +159 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +304 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +20 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +21 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +454 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +239 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +163 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +211 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1279 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +204 -19
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +707 -12
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +191 -43
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +333 -6
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +165 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +167 -37
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +178 -1
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +478 -32
- package/skills/fleet/SKILL.md +27 -16
- package/skills/fleet/auth-azdevops.md +57 -7
- package/skills/fleet/auth-bitbucket.md +5 -5
- package/skills/fleet/auth-github.md +7 -6
- package/skills/fleet/beads-conflict-resolution.md +141 -0
- package/skills/fleet/beads.md +16 -12
- package/skills/fleet/onboarding.md +6 -6
- package/skills/fleet/permissions.md +11 -7
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/skill-matrix.md +1 -1
- package/skills/fleet/troubleshooting.md +4 -3
- package/version.json +1 -1
- package/dist/providers/gemini.d.ts +0 -52
- package/dist/providers/gemini.d.ts.map +0 -1
- package/dist/providers/gemini.js +0 -236
- package/dist/providers/gemini.js.map +0 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -23
|
@@ -12,19 +12,28 @@ analyze AND mutate beads directly -- but you never touch code beyond reading it.
|
|
|
12
12
|
|
|
13
13
|
## Step 0 -- Knowledge Bank (required -- do this BEFORE any grooming decision)
|
|
14
14
|
|
|
15
|
+
<!-- if-tool: ToolSearch -->
|
|
15
16
|
1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_capture"`
|
|
17
|
+
<!-- else-tool: ToolSearch -->
|
|
18
|
+
1. No tool-discovery step is needed on this provider: every step below names the KB
|
|
19
|
+
tool it wants directly. Confirm your environment exposes those tools, then call
|
|
20
|
+
them as written.
|
|
21
|
+
<!-- end-tool: ToolSearch -->
|
|
16
22
|
2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo whose backlog
|
|
17
23
|
you are grooming, and `hint_modules` naming the subsystems the assigned beads touch.
|
|
18
24
|
Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts. This matters
|
|
19
|
-
most for duplicate detection and sprint-set grouping
|
|
20
|
-
are often the same underlying issue, and the KB is where that has already been written
|
|
21
|
-
down.
|
|
25
|
+
most for duplicate detection and sprint-set grouping.
|
|
22
26
|
3. When grooming turns up a durable backlog fact -- two ids that are genuinely the same
|
|
23
27
|
work, a dependency between beads that their text does not state, or a recurring reason
|
|
24
28
|
items land unactionable -- call `mcp__apra-fleet__kb_capture` with type "knowledge".
|
|
25
29
|
Do not capture per-sprint churn; capture what stays true.
|
|
26
30
|
|
|
31
|
+
<!-- if-tool: ToolSearch -->
|
|
27
32
|
If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
|
|
33
|
+
<!-- else-tool: ToolSearch -->
|
|
34
|
+
If those KB tools are not available in your environment (MCP server not running), skip
|
|
35
|
+
these steps and proceed.
|
|
36
|
+
<!-- end-tool: ToolSearch -->
|
|
28
37
|
|
|
29
38
|
## Usage modes
|
|
30
39
|
|
|
@@ -94,24 +103,23 @@ The canonical machine-readable contract lives in the sibling file
|
|
|
94
103
|
|
|
95
104
|
## Beads semantics
|
|
96
105
|
|
|
97
|
-
|
|
106
|
+
Graph semantics (`parent-child` = grouping, `blocks` = ordering, epic rules, `bd epic
|
|
107
|
+
status` gotchas) are canonical in `_shared/GRAPH-SEMANTICS.md`, the sibling file
|
|
108
|
+
installed alongside this one -- read it; do not restate or improvise those rules here.
|
|
109
|
+
Semantics specific to this role:
|
|
110
|
+
|
|
98
111
|
- `assignee` is set explicitly (`bd update <id> --assignee <identity>`) or via
|
|
99
112
|
`bd update <id> --claim` (also flips status to `in_progress`). Fall back to `owner`
|
|
100
|
-
(static, set
|
|
101
|
-
-
|
|
102
|
-
|
|
103
|
-
`open`/`in_progress`.
|
|
104
|
-
- `epic -> feature -> task` is a loose convention. The one hard rule: an epic may
|
|
105
|
-
`blocks` only another epic -- bd does not enforce same-type pairs.
|
|
106
|
-
- `bd epic status <id>` only rolls up correctly when `<id>` is actually typed `epic`;
|
|
107
|
-
on a non-epic id it silently returns unrelated epics.
|
|
113
|
+
(static, set at creation) only when `assignee` is empty.
|
|
114
|
+
- Only three things hide a bead from ready work: an unclosed child, an unmet `blocks`
|
|
115
|
+
dependency, or status not `open`/`in_progress`. `issue_type` never does.
|
|
108
116
|
- `gate` (`bd create --type=gate --await-type=<kind> --await-id=<id>`) blocks dependents
|
|
109
117
|
until an external condition resolves. Documented await-types are GitHub-shaped; when
|
|
110
118
|
recommending a gate, describe the pattern and let the operator pick an await-type
|
|
111
119
|
matching their actual VCS/CI.
|
|
112
|
-
- Title prefixes are convention, not schema, but widely matched on: `[test]` =
|
|
113
|
-
work
|
|
114
|
-
|
|
120
|
+
- Title prefixes are convention, not schema, but widely matched on: `[test]` =
|
|
121
|
+
verification work; `[impl]` = implementation; `[integ]` = filed by an integration
|
|
122
|
+
pass; `[regression][carry-over]` = rolled-over regression bug.
|
|
115
123
|
|
|
116
124
|
## Step 1 -- Load the backlog, scoped to identity
|
|
117
125
|
|
|
@@ -127,9 +135,8 @@ Fall back to non-`--json`/non-`--assignee` forms if unsupported, then filter cli
|
|
|
127
135
|
visibly separate. `bd show <id> --json` before any judgment call -- never flag
|
|
128
136
|
description quality from a summary line alone.
|
|
129
137
|
|
|
130
|
-
If a `bd` JSON payload is too large to read directly, redirect it
|
|
131
|
-
|
|
132
|
-
existing `.beads/` gitignore entry) -- never write scratch JSON to the repo root.
|
|
138
|
+
If a `bd` JSON payload is too large to read directly, redirect it to a gitignored
|
|
139
|
+
scratch path (e.g. `.beads/tmp/<name>.json`) -- never to the repo root.
|
|
133
140
|
|
|
134
141
|
## Step 2 -- Structural deadlock scan (every time)
|
|
135
142
|
|
|
@@ -193,6 +200,20 @@ Cross `priority`/urgency-language against content quality for every in-scope bea
|
|
|
193
200
|
- **Priority x age**: compare `created_at`/`updated_at` to now, always jointly with
|
|
194
201
|
priority. Old+low = noise; old+high = an explicit "still worth pursuing or stale?" call.
|
|
195
202
|
|
|
203
|
+
## Step 6a -- Hygiene sweep (every time)
|
|
204
|
+
|
|
205
|
+
Same identity scope as everything else: beads assigned to other people are never touched.
|
|
206
|
+
|
|
207
|
+
- **Follow-ups under closed parents**: an open bead whose parent (epic or otherwise) is
|
|
208
|
+
closed is a leftover. Groom it -- close with evidence if landed or duplicate; otherwise
|
|
209
|
+
append the parent's context to its notes (parent title, goal, relevant decisions, key
|
|
210
|
+
files, originating branch/PR) so it stands alone, then detach it
|
|
211
|
+
(`bd update <id> --parent ""`) and label it `from-epic:<parent-id>`.
|
|
212
|
+
- **Fully closed epics** (epic and every descendant closed): list them as deletion
|
|
213
|
+
candidates with descendant counts. Never `bd delete` without operator confirmation.
|
|
214
|
+
- **No token-estimate memories**: never write per-bead or aggregate token/cost estimates
|
|
215
|
+
with `bd remember`; flag any found for `bd forget`.
|
|
216
|
+
|
|
196
217
|
## Step 7 -- Cohesive sprint-set proposal (1b)
|
|
197
218
|
|
|
198
219
|
From the ready, verified, well-formed, non-duplicate subset only:
|
|
@@ -241,10 +262,10 @@ The canonical machine-readable contract for this output lives in the sibling fil
|
|
|
241
262
|
```json
|
|
242
263
|
{
|
|
243
264
|
"status": "OK",
|
|
244
|
-
"identity": "
|
|
265
|
+
"identity": "dev@example.com",
|
|
245
266
|
"notes": "12 ready, 2 sprint sets proposed, 1 duplicate merged, 3 needing grooming.",
|
|
246
267
|
"ready": [
|
|
247
|
-
{ "id": "BD-14", "type": "task", "priority": "P1", "status": "open", "assignee": "
|
|
268
|
+
{ "id": "BD-14", "type": "task", "priority": "P1", "status": "open", "assignee": "dev@example.com", "ageDays": 4, "size": "M", "rationale": "No blockers, clear AC, feeds the auth epic." }
|
|
248
269
|
],
|
|
249
270
|
"sprintSets": [
|
|
250
271
|
{ "label": "auth-hardening", "beadIds": ["BD-14", "BD-15"], "reason": "Shared parent BD-10, sequential blocks edge." }
|
|
@@ -263,7 +284,7 @@ The canonical machine-readable contract for this output lives in the sibling fil
|
|
|
263
284
|
],
|
|
264
285
|
"notYours": [],
|
|
265
286
|
"stale": [
|
|
266
|
-
{ "id": "BD-60", "type": "bug", "priority": "P1", "status": "open", "assignee": "
|
|
287
|
+
{ "id": "BD-60", "type": "bug", "priority": "P1", "status": "open", "assignee": "dev@example.com", "ageDays": 95, "size": "S", "rationale": "P1, 95 days untouched -- likely dropped, confirm before continuing to carry it." }
|
|
267
288
|
],
|
|
268
289
|
"structuralIssues": [
|
|
269
290
|
{ "kind": "deadlock", "description": "BD-70 blocks its own parent BD-71", "beadIds": ["BD-70", "BD-71"] }
|
|
@@ -24,7 +24,13 @@ Your dispatch prompt must supply ONE of the two scoping forms:
|
|
|
24
24
|
|
|
25
25
|
## Step 0 -- Knowledge Bank (required -- do this BEFORE any other work)
|
|
26
26
|
|
|
27
|
+
<!-- if-tool: ToolSearch -->
|
|
27
28
|
1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime"`
|
|
29
|
+
<!-- else-tool: ToolSearch -->
|
|
30
|
+
1. No tool-discovery step is needed on this provider: every step below names the KB
|
|
31
|
+
tool it wants directly. Confirm your environment exposes those tools, then call
|
|
32
|
+
them as written.
|
|
33
|
+
<!-- end-tool: ToolSearch -->
|
|
28
34
|
2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo whose CI you
|
|
29
35
|
are checking, and `hint_modules` naming its CI workflow files. Trust CONFIRMED entries
|
|
30
36
|
fully. Use INFERRED entries as hints, not facts. Known-flaky tests and known CI failure
|
|
@@ -32,7 +38,12 @@ Your dispatch prompt must supply ONE of the two scoping forms:
|
|
|
32
38
|
3. Do NOT capture. You poll a status API; you verify no claim about this repository, so you
|
|
33
39
|
have no basis to write one down.
|
|
34
40
|
|
|
41
|
+
<!-- if-tool: ToolSearch -->
|
|
35
42
|
If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
|
|
43
|
+
<!-- else-tool: ToolSearch -->
|
|
44
|
+
If those KB tools are not available in your environment (MCP server not running), skip
|
|
45
|
+
these steps and proceed.
|
|
46
|
+
<!-- end-tool: ToolSearch -->
|
|
36
47
|
|
|
37
48
|
## Step 1 -- List recent CI runs
|
|
38
49
|
|
|
@@ -48,6 +59,9 @@ gh run list --pr <prNumber> --limit 5 --json databaseId,status,conclusion,headSh
|
|
|
48
59
|
(In PR-scoped mode, apply Step 2 to the runs for the PR's head commit instead of
|
|
49
60
|
`expectedHeadSha`.)
|
|
50
61
|
|
|
62
|
+
If `gh` is unavailable or the repo's remote is not GitHub, do not guess at another CI
|
|
63
|
+
system: return `status: "not_configured"` with `notes` naming what was found.
|
|
64
|
+
|
|
51
65
|
## Step 2 -- Interpret the result
|
|
52
66
|
|
|
53
67
|
**No runs returned**: CI has never been triggered on this branch.
|
|
@@ -11,6 +11,25 @@ code or modify project files. You do NOT run `integ-test-playbook.md` -- the
|
|
|
11
11
|
test sandbox lifecycle (Setup / Reset / Teardown) and the tests themselves
|
|
12
12
|
belong to `integ-test-runner`, which owns that playbook end to end.
|
|
13
13
|
|
|
14
|
+
## Choose the right deploy mode FIRST
|
|
15
|
+
|
|
16
|
+
If `deploy.md` offers both a production deploy section and a sandbox /
|
|
17
|
+
test-isolated deploy section, decide which one applies before running
|
|
18
|
+
anything:
|
|
19
|
+
|
|
20
|
+
- **Dispatched for integration or regression testing** (a sprint-dispatched
|
|
21
|
+
deploy always is, and the dispatch prompt says so explicitly) -> use the
|
|
22
|
+
SANDBOX section. It stands up an isolated instance alongside whatever is
|
|
23
|
+
already running, so you never stop, kill, or restart live infrastructure.
|
|
24
|
+
- **A real production rollout** (an operator asked for one directly) -> use
|
|
25
|
+
the production section.
|
|
26
|
+
|
|
27
|
+
When in doubt, prefer the sandbox section and say so in `notes`: deploying in
|
|
28
|
+
isolation is recoverable, restarting a machine's shared production singleton
|
|
29
|
+
is not. Never stop or restart a running server just to make a test deploy
|
|
30
|
+
succeed -- if the runbook's production path seems to require that and you were
|
|
31
|
+
dispatched for testing, you are in the wrong section.
|
|
32
|
+
|
|
14
33
|
## Inputs
|
|
15
34
|
|
|
16
35
|
Your dispatch prompt must supply:
|
|
@@ -30,27 +49,19 @@ not improvise deploy steps that are not written down in the runbook.
|
|
|
30
49
|
|
|
31
50
|
## Step 0a -- Check permissions before running anything
|
|
32
51
|
|
|
33
|
-
Read `deploy.md`.
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
`.claude/settings.json` (
|
|
37
|
-
`.claude/settings.local.json` (
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
Run the merge MECHANICALLY, in one command, rather than reading each file
|
|
48
|
-
separately and merging by eye -- two sequential `cat`s invite stopping at the
|
|
49
|
-
first (often-empty) file and never getting to the second, which silently
|
|
50
|
-
reports a real grant as missing (observed live, apra-fleet: `settings.json`
|
|
51
|
-
legitimately carries no `permissions.allow` in this repo's convention -- every
|
|
52
|
-
grant lives in `settings.local.json` -- so a by-eye read that stops at the
|
|
53
|
-
first empty file always concludes "nothing is granted" even when it is):
|
|
52
|
+
Read `deploy.md`. If it has a `## Permissions` section, verify each listed
|
|
53
|
+
command prefix is covered by the MERGED effective permission set -- on
|
|
54
|
+
Claude Code, the union of `permissions.allow` from BOTH
|
|
55
|
+
`.claude/settings.json` (team-committed baseline) AND
|
|
56
|
+
`.claude/settings.local.json` (per-checkout, gitignored -- the only file the
|
|
57
|
+
fleet's `compose_permissions` tool writes to; see
|
|
58
|
+
`skills/fleet/permissions.md`). A grant in either file counts; a broader
|
|
59
|
+
prefix counts too (e.g. `Bash(docker:*)` covers `docker compose`). Other
|
|
60
|
+
providers keep the equivalent allowlist in their own native config file.
|
|
61
|
+
|
|
62
|
+
Compute the union MECHANICALLY, in one command -- reading the files
|
|
63
|
+
separately and merging by eye reliably misses grants when the first file is
|
|
64
|
+
empty:
|
|
54
65
|
|
|
55
66
|
```bash
|
|
56
67
|
node -e '
|
|
@@ -67,33 +78,25 @@ console.log(JSON.stringify([...allow], null, 2));
|
|
|
67
78
|
# use your provider's native config file(s) otherwise
|
|
68
79
|
```
|
|
69
80
|
|
|
70
|
-
Check every required
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
grant(s), then re-trigger the sprint.
|
|
80
|
-
|
|
81
|
-
Do NOT attempt to add the permissions yourself, by editing any file directly:
|
|
82
|
-
- `.claude/settings.json` is the team-committed baseline -- changes there
|
|
83
|
-
require the team/a PR, never a self-edit.
|
|
84
|
-
- `.claude/settings.local.json` is the correct target for an individual/local
|
|
85
|
-
grant, but it must be provisioned via the `compose_permissions` MCP tool
|
|
86
|
-
(grant mode), NOT hand-edited either -- that tool is the provider-agnostic
|
|
87
|
-
delivery mechanism (this repo supports non-Claude providers too: Gemini,
|
|
88
|
-
AGY, OpenCode, Codex -- each has its own native config path via the same
|
|
89
|
-
tool).
|
|
90
|
-
The correct escalation when a required permission is missing from the merged
|
|
91
|
-
effective set is: ask the orchestrator/operator to run `compose_permissions`
|
|
92
|
-
with the missing grant. Do NOT proceed past Step 0a if any permissions are missing.
|
|
81
|
+
Check every required prefix against this one merged list. If any prefix has
|
|
82
|
+
no covering entry, STOP immediately and return `deployed: false`, listing
|
|
83
|
+
every missing entry in `notes` and asking the orchestrator/operator to run
|
|
84
|
+
`compose_permissions` with the missing grant(s), then re-trigger the sprint.
|
|
85
|
+
NEVER add permissions yourself: `.claude/settings.json` changes require a
|
|
86
|
+
team PR, and `.claude/settings.local.json` must be provisioned via the
|
|
87
|
+
`compose_permissions` MCP tool (the provider-agnostic delivery mechanism
|
|
88
|
+
across all supported providers), never hand-edited. Do NOT proceed past
|
|
89
|
+
Step 0a while any permission is missing.
|
|
93
90
|
|
|
94
91
|
## Step 0b -- Knowledge Bank (required -- do this BEFORE any deploy.md operation)
|
|
95
92
|
|
|
93
|
+
<!-- if-tool: ToolSearch -->
|
|
96
94
|
1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_capture"`
|
|
95
|
+
<!-- else-tool: ToolSearch -->
|
|
96
|
+
1. No tool-discovery step is needed on this provider: every step below names the KB
|
|
97
|
+
tool it wants directly. Confirm your environment exposes those tools, then call
|
|
98
|
+
them as written.
|
|
99
|
+
<!-- end-tool: ToolSearch -->
|
|
97
100
|
2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo being deployed,
|
|
98
101
|
and `hint_modules` naming the deploy targets in `deploy.md`. Trust CONFIRMED entries
|
|
99
102
|
fully. Use INFERRED entries as hints, not facts.
|
|
@@ -101,17 +104,27 @@ with the missing grant. Do NOT proceed past Step 0a if any permissions are missi
|
|
|
101
104
|
be wrong or incomplete, call `mcp__apra-fleet__kb_capture` with type "runbook" or
|
|
102
105
|
"learning". A deploy gotcha you had to discover is exactly what the next deploy needs.
|
|
103
106
|
|
|
107
|
+
<!-- if-tool: ToolSearch -->
|
|
104
108
|
If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
|
|
109
|
+
<!-- else-tool: ToolSearch -->
|
|
110
|
+
If those KB tools are not available in your environment (MCP server not running), skip
|
|
111
|
+
these steps and proceed.
|
|
112
|
+
<!-- end-tool: ToolSearch -->
|
|
105
113
|
|
|
106
114
|
## deploy.md operations
|
|
107
115
|
|
|
108
116
|
When asked to deploy:
|
|
109
117
|
|
|
110
118
|
1. Read `deploy.md` -- understand the Deploy, Smoke test, and CI sections
|
|
111
|
-
2. Execute every command in the `## Deploy
|
|
112
|
-
|
|
119
|
+
2. Execute every command in the section chosen above (`## Deploy`, or the
|
|
120
|
+
sandbox section) in order
|
|
121
|
+
3. Run that section's smoke test
|
|
113
122
|
- Exit 0 = healthy -> return `deployed: true`
|
|
114
123
|
- Any other exit or error -> return `deployed: false`, include full error output in `notes`
|
|
124
|
+
4. If the section says the deployed instance stays RUNNING for the test
|
|
125
|
+
phase that follows, leave it running -- do not tear it down after a
|
|
126
|
+
successful deploy. Report in `notes` whatever the runbook says a later
|
|
127
|
+
phase needs to locate it.
|
|
115
128
|
|
|
116
129
|
If a command fails mid-deploy, stop immediately and return `deployed: false`
|
|
117
130
|
with the failing command and its output in `notes`.
|