@apralabs/apra-fleet 0.4.2 → 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 +38 -5
- package/dist/agents/backlog-groomer.md +25 -0
- package/dist/agents/ci-watcher.md +11 -0
- package/dist/agents/deployer.md +37 -2
- package/dist/agents/doer.md +36 -12
- package/dist/agents/harvester.md +11 -0
- package/dist/agents/integ-test-runner.md +11 -0
- package/dist/agents/kb-reconciler.md +9 -0
- package/dist/agents/plan-reviewer.md +110 -22
- package/dist/agents/planner.md +125 -37
- package/dist/agents/regression-test-runner.md +11 -0
- package/dist/agents/reviewer.md +13 -2
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- 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 +28 -9
- 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 -34
- 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 +290 -23
- 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 +6 -2
- package/dist/cli/register-member.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/linux.d.ts +6 -0
- package/dist/os/linux.d.ts.map +1 -1
- package/dist/os/linux.js +35 -2
- package/dist/os/linux.js.map +1 -1
- package/dist/os/os-commands.d.ts +61 -2
- package/dist/os/os-commands.d.ts.map +1 -1
- package/dist/os/windows-gitbash.d.ts +5 -0
- package/dist/os/windows-gitbash.d.ts.map +1 -1
- package/dist/os/windows-gitbash.js +15 -0
- package/dist/os/windows-gitbash.js.map +1 -1
- package/dist/os/windows.d.ts +6 -0
- package/dist/os/windows.d.ts.map +1 -1
- package/dist/os/windows.js +46 -3
- package/dist/os/windows.js.map +1 -1
- package/dist/providers/agy.d.ts +115 -6
- package/dist/providers/agy.d.ts.map +1 -1
- package/dist/providers/agy.js +569 -53
- package/dist/providers/agy.js.map +1 -1
- package/dist/providers/claude.d.ts +81 -3
- package/dist/providers/claude.d.ts.map +1 -1
- package/dist/providers/claude.js +344 -10
- package/dist/providers/claude.js.map +1 -1
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.d.ts.map +1 -1
- package/dist/providers/codex.js +19 -2
- package/dist/providers/codex.js.map +1 -1
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.d.ts.map +1 -1
- package/dist/providers/copilot.js +20 -2
- package/dist/providers/copilot.js.map +1 -1
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.d.ts.map +1 -1
- package/dist/providers/none.js +17 -2
- package/dist/providers/none.js.map +1 -1
- package/dist/providers/opencode.d.ts +3 -1
- package/dist/providers/opencode.d.ts.map +1 -1
- package/dist/providers/opencode.js +22 -2
- package/dist/providers/opencode.js.map +1 -1
- package/dist/providers/provider.d.ts +201 -6
- package/dist/providers/provider.d.ts.map +1 -1
- package/dist/providers/provider.js +56 -0
- package/dist/providers/provider.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/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/credential-cleanup.d.ts.map +1 -1
- package/dist/services/credential-cleanup.js +35 -17
- 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/model-pricing.d.ts.map +1 -1
- package/dist/services/model-pricing.js +7 -3
- package/dist/services/model-pricing.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/ssh.d.ts.map +1 -1
- package/dist/services/ssh.js +58 -2
- package/dist/services/ssh.js.map +1 -1
- package/dist/services/stall/read-log-tail.d.ts.map +1 -1
- package/dist/services/stall/read-log-tail.js +20 -10
- 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/strategy.d.ts.map +1 -1
- package/dist/services/strategy.js +79 -2
- 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/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.d.ts.map +1 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/azure-devops.js.map +1 -1
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/skills/fleet-sprint-cli/SKILL.md +18 -0
- package/dist/skills/pm/SKILL.md +1 -1
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- 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 +2 -0
- package/dist/tools/check-status.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 +182 -34
- 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 +31 -20
- 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 +1196 -892
- 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 +1 -0
- 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 +17 -0
- 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 +61 -20
- package/dist/tools/member-reservation.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 +142 -54
- package/dist/tools/provision-auth.js.map +1 -1
- package/dist/tools/provision-vcs-auth.d.ts +91 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/provision-vcs-auth.js.map +1 -1
- package/dist/tools/register-member.d.ts +12 -9
- package/dist/tools/register-member.d.ts.map +1 -1
- package/dist/tools/register-member.js +99 -12
- 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 +27 -2
- package/dist/tools/remove-member.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/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/update-member.d.ts +12 -9
- package/dist/tools/update-member.d.ts.map +1 -1
- package/dist/tools/update-member.js +43 -11
- 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 +13 -0
- package/dist/types.d.ts.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/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 +87 -1
- package/dist/utils/workspace-trust.js.map +1 -1
- package/dist/workflows/auto-sprint.js +176 -15
- package/package.json +6 -4
- package/packages/apra-fleet-client/src/client/api.mjs +319 -17
- 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 +25 -0
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +11 -0
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +37 -2
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +36 -12
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +11 -0
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +11 -0
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +9 -0
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +110 -22
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +125 -37
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +11 -0
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +13 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +1 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/bin/cli.mjs +149 -1
- package/packages/apra-fleet-se/bin/serve.mjs +78 -4
- 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 +61 -14
- 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 +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +276 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +996 -32
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +267 -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 +1467 -9798
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +17 -12
- 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 +18 -0
- 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 +153 -19
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +71 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +131 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +140 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +77 -2
- 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 +17 -6
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +49 -7
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +5 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
|
@@ -657,12 +657,37 @@ export class FleetWorkflow extends EventEmitter {
|
|
|
657
657
|
* guard is set, that guard returning truthy. Calling it while already
|
|
658
658
|
* paused or pause-requested is a no-op.
|
|
659
659
|
*
|
|
660
|
+
* (apra-fleet-hzeb.3) Also exposed on the script context (see
|
|
661
|
+
* _bindPrimitives), so a running workflow script can initiate a pause
|
|
662
|
+
* for a condition only IT can detect (e.g. a provider usage/rate limit
|
|
663
|
+
* signal) -- not just the dashboard/operator via requestStop()'s sibling
|
|
664
|
+
* instance-level API. A script-initiated pause is indistinguishable from
|
|
665
|
+
* an operator-initiated one downstream: it fires the exact same
|
|
666
|
+
* 'pause:requested'/'paused'/'resumed' events, so any existing listener
|
|
667
|
+
* (the dashboard viewer's state.pause wiring, fleet-sprint's
|
|
668
|
+
* cli.mjs `on('paused', releaseForPause)` /
|
|
669
|
+
* `setPreResumeHook(reReserveForResume)`) engages for it unchanged.
|
|
670
|
+
*
|
|
660
671
|
* @param {string} [reason]
|
|
672
|
+
* @param {{ resumeAt?: string, source?: string }} [opts] - Optional
|
|
673
|
+
* metadata carried on the 'pause:requested' payload (apra-fleet-hzeb.3):
|
|
674
|
+
* `resumeAt` is an ISO-8601 timestamp (or any caller-defined string) the
|
|
675
|
+
* caller expects the condition to clear by -- e.g. a provider's
|
|
676
|
+
* usage-limit reset time -- surfaced by the dashboard viewer in the
|
|
677
|
+
* paused banner. `source` identifies what requested the pause (e.g.
|
|
678
|
+
* `'usage_limit'`) for the same display purpose. Both are purely
|
|
679
|
+
* informational to the engine, which does not interpret or act on
|
|
680
|
+
* them. Omitting `opts` is fully backwards compatible with existing
|
|
681
|
+
* single-arg callers.
|
|
661
682
|
*/
|
|
662
|
-
requestPause(reason = 'Workflow run paused via requestPause()') {
|
|
683
|
+
requestPause(reason = 'Workflow run paused via requestPause()', opts = {}) {
|
|
663
684
|
if (this._paused || this._pauseRequested) return;
|
|
664
685
|
this._pauseRequested = true;
|
|
665
|
-
this.emit('pause:requested', this._pauseEventPayload({
|
|
686
|
+
this.emit('pause:requested', this._pauseEventPayload({
|
|
687
|
+
reason,
|
|
688
|
+
resumeAt: opts.resumeAt ?? null,
|
|
689
|
+
source: opts.source ?? null
|
|
690
|
+
}));
|
|
666
691
|
// If we're already quiescent (nothing in flight, guard permits), the
|
|
667
692
|
// pause engages right now; otherwise it engages later as in-flight
|
|
668
693
|
// work drains (_exitActivity) or the guard opens (setPauseGuard).
|
|
@@ -1257,7 +1282,15 @@ export class FleetWorkflow extends EventEmitter {
|
|
|
1257
1282
|
// result.usage is null and cost is null -- the viewer then
|
|
1258
1283
|
// tallies it as an unknown-cost activity rather than fiction.
|
|
1259
1284
|
this.emit('activity:end', { ...activityMeta, error: text, duration, usage: result.usage, cost, success: false });
|
|
1260
|
-
|
|
1285
|
+
// apra-fleet-hzeb.2: pure pass-through, no policy decisions here --
|
|
1286
|
+
// when execute_prompt relayed a provider usage-limit signal
|
|
1287
|
+
// (reason: 'usage_limit'), forward its usageLimit block and the
|
|
1288
|
+
// in-flight sessionId onto AgentDispatchError.details unchanged, so
|
|
1289
|
+
// the fleet-sprint pause/resume policy can read
|
|
1290
|
+
// err.details.usageLimit.resumeAt / err.details.sessionId directly
|
|
1291
|
+
// instead of re-parsing the failure text. A permission_denied
|
|
1292
|
+
// result forwards its permissionDenied block the same way.
|
|
1293
|
+
throw new AgentDispatchError(`[Workflow Error] Agent dispatch failed (${structured.reason || 'unknown'}): ${text}`, { details: { text, reason: structured.reason, member: opts.member_name || opts.member_id, ...(structured.usageLimit ? { usageLimit: structured.usageLimit } : {}), ...(structured.permissionDenied ? { permissionDenied: structured.permissionDenied } : {}), ...(structured.sessionId ? { sessionId: structured.sessionId } : {}) } });
|
|
1261
1294
|
}
|
|
1262
1295
|
|
|
1263
1296
|
// apra-fleet-eft.78.3: surface the resumable session id
|
|
@@ -1988,10 +2021,19 @@ export class FleetWorkflow extends EventEmitter {
|
|
|
1988
2021
|
endGroup: this.endGroup.bind(this),
|
|
1989
2022
|
// (apra-fleet-p2to.1) Script-facing: lets the workflow declare
|
|
1990
2023
|
// where a clean-state boundary is so a deferred pause engages
|
|
1991
|
-
// there.
|
|
1992
|
-
|
|
1993
|
-
//
|
|
1994
|
-
|
|
2024
|
+
// there.
|
|
2025
|
+
setPauseGuard: this.setPauseGuard.bind(this),
|
|
2026
|
+
// (apra-fleet-hzeb.3) Script-facing pause/resume: a running
|
|
2027
|
+
// script may PARK ITSELF on a condition only it can detect (a
|
|
2028
|
+
// provider usage/rate limit, an external gate) by calling these
|
|
2029
|
+
// directly -- they are the exact same requestPause()/
|
|
2030
|
+
// requestResume() the dashboard/operator use, so a
|
|
2031
|
+
// script-initiated pause fires the identical 'pause:requested'/
|
|
2032
|
+
// 'paused'/'resumed' lifecycle events as an operator-initiated
|
|
2033
|
+
// one. requestStop() remains instance-only/operator-only -- a
|
|
2034
|
+
// script has no business tearing down its own run.
|
|
2035
|
+
requestPause: this.requestPause.bind(this),
|
|
2036
|
+
requestResume: this.requestResume.bind(this)
|
|
1995
2037
|
};
|
|
1996
2038
|
}
|
|
1997
2039
|
|
package/skills/fleet/SKILL.md
CHANGED
|
@@ -55,13 +55,13 @@ Beads (`bd` CLI) is installed automatically by `apra-fleet install`. It gives fl
|
|
|
55
55
|
|
|
56
56
|
See `beads.md` for the full command reference and workflow examples.
|
|
57
57
|
|
|
58
|
-
##
|
|
58
|
+
## Secret variables
|
|
59
59
|
|
|
60
|
-
The `{{
|
|
60
|
+
The `{{secret.NAME}}` pattern lets you reference stored secrets in any command without ever exposing plaintext to the LLM or logs.
|
|
61
61
|
|
|
62
62
|
**How it works:**
|
|
63
63
|
1. Store a secret with `credential_store_set` - Fleet opens an OOB terminal prompt, so the value never appears in chat
|
|
64
|
-
2. Reference it as `{{
|
|
64
|
+
2. Reference it as `{{secret.NAME}}` anywhere in a command string passed to `execute_command`, `register_member`, `update_member`, `provision_vcs_auth`, `provision_llm_auth`, or `setup_git_app`
|
|
65
65
|
3. Fleet resolves the token server-side before execution; LLM does not see the secret.
|
|
66
66
|
|
|
67
67
|
**When to use:**
|
|
@@ -69,7 +69,7 @@ The `{{secure.NAME}}` pattern lets you reference stored secrets in any command w
|
|
|
69
69
|
- Rotating credentials: `credential_store_delete` then `credential_store_set` - no re-provisioning required
|
|
70
70
|
- Pre-loading secrets before a dispatch so members can authenticate in commands autonomously
|
|
71
71
|
|
|
72
|
-
NOTE: **`{{
|
|
72
|
+
NOTE: **`{{secret.NAME}}` only resolves in specific credential fields** (listed above). Using it in any other parameter (e.g. a prompt, a path field in a non-credential tool, or any other unsupported parameter) will pass the token string through literally - the secret will NOT be injected, and the raw handle name will be visible in logs. Only use `{{secret.NAME}}` in the fields documented above.
|
|
73
73
|
|
|
74
74
|
**Access control (scoping):** Credentials can be scoped to specific members.
|
|
75
75
|
- `members="*"` (default) - all members can access the credential
|
|
@@ -169,9 +169,9 @@ execute_prompt(
|
|
|
169
169
|
- If `substitutions` is omitted and file/prompt content contains `{{token}}` patterns, a warning is returned (call still succeeds).
|
|
170
170
|
|
|
171
171
|
**[SECURE] Secrets boundary -- never use substitutions for secrets:**
|
|
172
|
-
- Substitution keys with dots (e.g. `
|
|
173
|
-
- `{{
|
|
174
|
-
- Substitution values are never logged. But callers must not put plaintext secrets in substitution values; use `{{
|
|
172
|
+
- Substitution keys with dots (e.g. `secret.github_pat`) are rejected outright.
|
|
173
|
+
- `{{secret.NAME}}` patterns in file/prompt content pass through verbatim - they are resolved later only by `execute_command` via the credential store, not here.
|
|
174
|
+
- Substitution values are never logged. But callers must not put plaintext secrets in substitution values; use `{{secret.NAME}}` in `execute_command` for secrets.
|
|
175
175
|
|
|
176
176
|
## Permissions
|
|
177
177
|
|
|
@@ -253,7 +253,7 @@ Per-provider flag behaviour:
|
|
|
253
253
|
| Provider | `'auto'` flag | `'dangerous'` flag |
|
|
254
254
|
|----------|--------------|-------------------|
|
|
255
255
|
| Claude | `--permission-mode auto` | `--dangerously-skip-permissions` |
|
|
256
|
-
| Antigravity (agy) |
|
|
256
|
+
| Antigravity (agy) | `--mode accept-edits` (same as default; grants come from `compose_permissions`) | `--dangerously-skip-permissions` |
|
|
257
257
|
| OpenCode | `--auto` | `--dangerously-skip-permissions` |
|
|
258
258
|
| Codex | `--ask-for-approval auto-edit` | `--sandbox danger-full-access --ask-for-approval never` |
|
|
259
259
|
| Copilot | Not supported - warns and runs interactively | Not supported |
|
|
@@ -39,7 +39,7 @@ The credential is entered via the out-of-band prompt during `provision_vcs_auth`
|
|
|
39
39
|
|
|
40
40
|
```
|
|
41
41
|
credential_store_set name=azdevops_pat
|
|
42
|
-
execute_command command="curl -sf -u :{{
|
|
42
|
+
execute_command command="curl -sf -u :{{secret.azdevops_pat}} 'https://dev.azure.com/{org}/_apis/projects?api-version=7.1'"
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
**Per-sprint override:** To use a different credential name for a specific sprint (for example, when working with a different Azure DevOps organization or test repo), pass the `azdevops_pat_secret_name` argument to the sprint invocation (threaded through `packages/apra-fleet-se/fleet-sprint/runner.js`). It must name a credential already stored via `credential_store_set`; the runner validates it as a credential-store name at contract-validation time and uses it instead of the default `azdevops_pat` entry for provisioning, self-heal, and preflight checks on that sprint.
|
|
@@ -63,11 +63,22 @@ curl -sf -u :pat "https://dev.azure.com/{org}/_apis/projects?api-version=7.1&\$t
|
|
|
63
63
|
git ls-remote https://dev.azure.com/{org}/{project}/_git/{repo} HEAD
|
|
64
64
|
```
|
|
65
65
|
|
|
66
|
+
## Legacy `<org>.visualstudio.com` remotes
|
|
67
|
+
|
|
68
|
+
git looks credentials up by the remote's own hostname, so a PAT bound to
|
|
69
|
+
`dev.azure.com` is never offered for a push to `https://<org>.visualstudio.com/...`.
|
|
70
|
+
Pass `scope_url="https://<org>.visualstudio.com"` to `provision_vcs_auth`
|
|
71
|
+
(fleet-sprint does this automatically from the member's remote). `org_url`
|
|
72
|
+
stays `https://dev.azure.com/<org>` -- the REST API serves every org there.
|
|
73
|
+
An ssh remote (`vs-ssh.visualstudio.com` / `ssh.dev.azure.com`) cannot take a
|
|
74
|
+
PAT at all: push uses the member's SSH key; the PAT serves only REST calls.
|
|
75
|
+
|
|
66
76
|
## Troubleshooting
|
|
67
77
|
|
|
68
78
|
| Symptom | Fix |
|
|
69
79
|
|---------|-----|
|
|
70
80
|
| 401 Unauthorized | Create new PAT and re-deploy |
|
|
81
|
+
| push to `<org>.visualstudio.com` prompts / 401 while REST works | Re-provision with `scope_url="https://<org>.visualstudio.com"` |
|
|
71
82
|
| 403 Forbidden | Create PAT with broader scopes |
|
|
72
83
|
| TF400813: Resource not available | Verify org URL matches `https://dev.azure.com/{org}` |
|
|
73
84
|
| Clone prompts for password | Re-run `provision_vcs_auth` |
|
|
@@ -97,8 +108,8 @@ credential_store_set name=azdevops_pat
|
|
|
97
108
|
**Use it in a command on a member:**
|
|
98
109
|
|
|
99
110
|
```
|
|
100
|
-
execute_command command="curl -sf -u :{{
|
|
101
|
-
execute_command command="git remote set-url origin https://token:{{
|
|
111
|
+
execute_command command="curl -sf -u :{{secret.azdevops_pat}} 'https://dev.azure.com/{org}/_apis/projects?api-version=7.1'"
|
|
112
|
+
execute_command command="git remote set-url origin https://token:{{secret.azdevops_pat}}@dev.azure.com/{org}/{project}/_git/{repo}"
|
|
102
113
|
```
|
|
103
114
|
|
|
104
115
|
The token is resolved server-side and redacted in output (`[REDACTED:azdevops_pat]`) - it never appears in the LLM conversation or command logs.
|
|
@@ -49,8 +49,8 @@ credential_store_set name=bitbucket_token
|
|
|
49
49
|
**Use it in a command on a member:**
|
|
50
50
|
|
|
51
51
|
```
|
|
52
|
-
execute_command command="curl -sf -u me@example.com:{{
|
|
53
|
-
execute_command command="git remote set-url origin https://me@example.com:{{
|
|
52
|
+
execute_command command="curl -sf -u me@example.com:{{secret.bitbucket_token}} https://api.bitbucket.org/2.0/user"
|
|
53
|
+
execute_command command="git remote set-url origin https://me@example.com:{{secret.bitbucket_token}}@bitbucket.org/workspace/repo.git"
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
The token is resolved server-side and redacted in output (`[REDACTED:bitbucket_token]`) - it never appears in the LLM conversation or command logs.
|
|
@@ -10,14 +10,14 @@ When to use: Org repos where you have admin access to install a GitHub App.
|
|
|
10
10
|
|
|
11
11
|
Setup:
|
|
12
12
|
1. Create GitHub App at `https://github.com/organizations/{org}/settings/apps`
|
|
13
|
-
2. Grant permissions (Contents, Pull
|
|
13
|
+
2. Grant the Repository permissions every `git_access` level you will use needs -- exact table in `docs/github-app-setup.md` (fleet-sprint minimum = `push+pr`: Metadata R, Contents RW, Workflows RW, Pull requests RW, Actions RW). Missing any -> mint fails (no downgrade); after changing them an org owner must accept the new permissions on the installation.
|
|
14
14
|
3. Install on your organization
|
|
15
15
|
4. Download private key (.pem file)
|
|
16
16
|
5. Run `setup_git_app` with App ID, private key path, installation ID
|
|
17
17
|
|
|
18
18
|
Deploy:
|
|
19
19
|
```
|
|
20
|
-
provision_vcs_auth(member_id, provider: 'github')
|
|
20
|
+
provision_vcs_auth(member_id, provider: 'github') # needs git_access + git_repos on the member
|
|
21
21
|
provision_vcs_auth(member_id, provider: 'github', git_access: 'push', repos: ['Org/Repo'])
|
|
22
22
|
```
|
|
23
23
|
|
|
@@ -70,8 +70,8 @@ credential_store_set name=github_pat
|
|
|
70
70
|
**Use it in a command on a member:**
|
|
71
71
|
|
|
72
72
|
```
|
|
73
|
-
execute_command command="curl -H 'Authorization: Bearer {{
|
|
74
|
-
execute_command command="git remote set-url origin https://token:{{
|
|
73
|
+
execute_command command="curl -H 'Authorization: Bearer {{secret.github_pat}}' https://api.github.com/user"
|
|
74
|
+
execute_command command="git remote set-url origin https://token:{{secret.github_pat}}@github.com/Org/Repo.git"
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
The token is resolved server-side and redacted in output (`[REDACTED:github_pat]`) - it never appears in the LLM conversation or command logs.
|
|
@@ -81,6 +81,7 @@ The token is resolved server-side and redacted in output (`[REDACTED:github_pat]
|
|
|
81
81
|
| Symptom | Fix |
|
|
82
82
|
|---------|-----|
|
|
83
83
|
| 401 Bad credentials | Re-mint via `provision_vcs_auth` |
|
|
84
|
+
| `is not granted one or more of the requested permissions` | App lacks a permission for that level; re-minting won't fix it. Add it + accept on the installation -- see `docs/github-app-setup.md` |
|
|
84
85
|
| 403 Resource not accessible | Check App permissions or PAT scopes |
|
|
85
86
|
| Repository not found | Add repo to GitHub App installation |
|
|
86
87
|
| gh: command not found | Install via `brew install gh` or `apt install gh` |
|
|
@@ -75,8 +75,8 @@ If the task you are about to dispatch requires an API key, token, or password (e
|
|
|
75
75
|
|
|
76
76
|
**Steps:**
|
|
77
77
|
1. Call `credential_store_set` with a descriptive name (e.g., `github_pat`, `npm_token`, `openai_key`) - Fleet opens an OOB terminal prompt for the value
|
|
78
|
-
2. Reference the credential by NAME only in the task prompt (e.g. `"authenticate using credential github_pat"`) - never paste the raw `sec://NAME` handle into a prompt or command; `execute_command` rejects any command containing one. The secret value is only injected server-side when `{{
|
|
79
|
-
3. The member uses `{{
|
|
78
|
+
2. Reference the credential by NAME only in the task prompt (e.g. `"authenticate using credential github_pat"`) - never paste the raw `sec://NAME` handle into a prompt or command; `execute_command` rejects any command containing one. The secret value is only injected server-side when `{{secret.NAME}}` appears in an `execute_command` call - never in AI prompt text.
|
|
79
|
+
3. The member uses `{{secret.NAME}}` in `execute_command` - Fleet resolves the value server-side and redacts it from output before the LLM sees it
|
|
80
80
|
|
|
81
81
|
**Example - dispatching a member that needs to push code to GitHub:**
|
|
82
82
|
|
|
@@ -88,5 +88,5 @@ credential_store_set name=github_pat
|
|
|
88
88
|
"When pushing code to GitHub, authenticate using credential github_pat."
|
|
89
89
|
|
|
90
90
|
# Member uses it in a command transparently
|
|
91
|
-
execute_command command="git remote set-url origin https://token:{{
|
|
91
|
+
execute_command command="git remote set-url origin https://token:{{secret.github_pat}}@github.com/Org/Repo.git"
|
|
92
92
|
```
|
|
@@ -67,6 +67,9 @@ When `execute_prompt` output contains a permission denial, call `compose_permiss
|
|
|
67
67
|
|
|
68
68
|
> "Grant Bash(docker:*) to build-server, reason: integration tests, project folder ./my-project"
|
|
69
69
|
|
|
70
|
+
For an agy member the failure is structured: `reason: "permission_denied"` with
|
|
71
|
+
`permissionDenied.suggestedGrants` (primary grant first) - review them and pass them as `grant`.
|
|
72
|
+
|
|
70
73
|
The tool validates (wildcard-matched denylist -- blocks sudo/env, `bash -c`, catch-alls and shell chaining; see [Never auto-granted](#never-auto-granted)), expands co-occurrences (docker -> docker-compose), delivers the updated config, and appends to the project ledger for future use.
|
|
71
74
|
|
|
72
75
|
## Role switch
|
|
@@ -142,7 +145,8 @@ same channel `compose_permissions` already uses, so it works uniformly for local
|
|
|
142
145
|
remote (SSH) members. It logs distinctly whether it just seeded trust or found it
|
|
143
146
|
already present. Other providers no-op: OpenCode has its own trust gate
|
|
144
147
|
but already bypasses it per-dispatch (`--dangerously-skip-permissions`);
|
|
145
|
-
AGY
|
|
148
|
+
AGY needs no trust seeding (its grants bind through the member's own agy project,
|
|
149
|
+
`--project` on every dispatch); Codex/Copilot have no
|
|
146
150
|
known equivalent gate.
|
|
147
151
|
|
|
148
152
|
If `execute_prompt` fails with a `workspace_not_trusted` structured error, the CLI's own
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
{
|
|
2
2
|
"dev": ["Bash(npm:*)", "Bash(npx:*)", "Bash(node:*)", "Bash(yarn:*)", "Bash(pnpm:*)", "Bash(tsx:*)", "Bash(npm test*)", "Bash(npm run *)", "Bash(npx vitest *)"],
|
|
3
|
-
"reviewer": ["Bash(npm test:*)", "Bash(npm run test:*)", "Bash(npm run lint:*)", "Bash(npx:*)", "Bash(npm test*)", "Bash(npm run *)", "Bash(npx vitest *)"]
|
|
3
|
+
"reviewer": ["Bash(npm test:*)", "Bash(npm run test:*)", "Bash(npm run lint:*)", "Bash(npx:*)", "Bash(node:*)", "Bash(npm test*)", "Bash(npm run *)", "Bash(npx vitest *)"]
|
|
4
4
|
}
|
|
@@ -5,10 +5,10 @@
|
|
|
5
5
|
| Empty response | Check auth token expiry -> re-provision via `provision_vcs_auth` |
|
|
6
6
|
| Timeout (inactivity) | `timeout_s`: fires when no stdout/stderr output arrives for N seconds (default 300s / 5 min). Applies to all members and all providers - transport-level, not provider-specific. Common cause: test runners and build tools that buffer output (npm test, vitest, cargo build) producing no output for long stretches even while active. Fix: increase `timeout_s` to 600-1200 for build/test dispatches. |
|
|
7
7
|
| Timeout (total) | `max_total_s`: fires after N seconds of total elapsed time regardless of output activity. Provider-agnostic. Use for hard ceilings on long-running jobs. Set alongside `timeout_s` when you need both a silence guard and a wall-clock cap. |
|
|
8
|
-
| Permission denied | Run `compose_permissions` for the member - it produces provider-native config. Claude: check `.claude/settings.local.json`. Agy:
|
|
8
|
+
| Permission denied | Run `compose_permissions` for the member - it produces provider-native config. Claude: check `.claude/settings.local.json`. Agy: `execute_prompt` returns `reason: "permission_denied"` with `permissionDenied.suggestedGrants` - pass them to `compose_permissions` `grant`; grants live in `~/.gemini/config/projects/<agyProjectId>.json` on the member (`agyProjectId` from `member_detail`). Codex: check `.codex/config.toml` approval mode. Copilot: check `.github/copilot/settings.local.json`. |
|
|
9
9
|
| Stuck after reset | Escalate model (cheap->standard->premium). Still stuck? Flag to user |
|
|
10
10
|
| Auth error (401/403) | GitHub App: re-mint via `provision_vcs_auth`. Bitbucket/Azure DevOps: ask user for fresh token, provision, retry. See auth-*.md |
|
|
11
|
-
| Token/password appears in command output | Use `credential_store_set` to store the secret, then reference it as `{{
|
|
12
|
-
| Need to rotate a credential without re-provisioning | Run `credential_store_delete name=<NAME>` then `credential_store_set name=<NAME>` - the new value is picked up immediately on the next `execute_command` that references `{{
|
|
11
|
+
| Token/password appears in command output | Use `credential_store_set` to store the secret, then reference it as `{{secret.NAME}}` in `execute_command` - Fleet redacts it to `[REDACTED:NAME]` before the LLM sees the output |
|
|
12
|
+
| Need to rotate a credential without re-provisioning | Run `credential_store_delete name=<NAME>` then `credential_store_set name=<NAME>` - the new value is picked up immediately on the next `execute_command` that references `{{secret.NAME}}` |
|
|
13
13
|
| Tool execution issue (unexpected behavior, missing output, silent failure) | Check `APRA_FLEET_DATA_DIR/logs/fleet-<pid>.log` for detailed execution traces. Filter by member with `jq 'select(.member_id == "<uuid>")'` or by tool with `jq 'select(.tag == "<tool>")'`. See the **Fleet Logs** section in SKILL.md for full field reference and `jq` examples. |
|
|
14
14
|
| `bd dolt pull`/`push` fails with "merge conflicts in issues require operator resolution" | Real divergence, not corruption -- do NOT `bd init`/`bd init --from-jsonl`/delete `.beads/`. See `beads-conflict-resolution.md` for the manual dolt SQL recovery playbook. |
|
package/version.json
CHANGED