@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
|
@@ -70,18 +70,23 @@ export class SePosixCommands {
|
|
|
70
70
|
* Invoke an executable at `path` with `args`.
|
|
71
71
|
*
|
|
72
72
|
* QUOTING CONTRACT (differs per implementation on purpose -- pass `path`
|
|
73
|
-
* UNQUOTED
|
|
74
|
-
*
|
|
75
|
-
*
|
|
76
|
-
*
|
|
77
|
-
*
|
|
78
|
-
*
|
|
73
|
+
* UNQUOTED; this method adds its own quoting): POSIX double-quotes the path
|
|
74
|
+
* token so a member whose HOME contains whitespace (or other word-splitting
|
|
75
|
+
* characters) still resolves correctly -- `$HOME` still expands inside
|
|
76
|
+
* double quotes, it just no longer gets split on the result (apra-fleet-
|
|
77
|
+
* j918.12; the bare, unquoted form was a real production defect, pinned by
|
|
78
|
+
* apra-fleet-j918.6.3's round-trip harness before this fix). The PowerShell
|
|
79
|
+
* implementation adds both the call operator and double quotes, without
|
|
80
|
+
* which PowerShell merely echoes the path back as a string and the failure
|
|
81
|
+
* looks like success.
|
|
82
|
+
* @param {string} path unquoted; this method adds double quotes
|
|
79
83
|
* @param {string} [args]
|
|
80
84
|
* @returns {string}
|
|
81
85
|
*/
|
|
82
86
|
invoke(path, args = '') {
|
|
83
87
|
const suffix = String(args || '').trim();
|
|
84
|
-
|
|
88
|
+
const quoted = `"${path}"`;
|
|
89
|
+
return suffix ? `${quoted} ${suffix}` : quoted;
|
|
85
90
|
}
|
|
86
91
|
|
|
87
92
|
/**
|
|
@@ -101,11 +106,11 @@ export class SePosixCommands {
|
|
|
101
106
|
* -- on the PowerShell side the command itself is an opaque base64 blob, so
|
|
102
107
|
* the descriptor has to carry the readable path.
|
|
103
108
|
*
|
|
104
|
-
* NOTE: the POSIX label is intentionally NOT validated
|
|
105
|
-
*
|
|
106
|
-
*
|
|
107
|
-
*
|
|
108
|
-
*
|
|
109
|
+
* NOTE: the POSIX label is intentionally NOT validated, unlike the
|
|
110
|
+
* PowerShell implementation (which is newer and does validate). The path
|
|
111
|
+
* itself is now double-quoted by `invoke()` (apra-fleet-j918.12) so a
|
|
112
|
+
* member whose HOME contains whitespace still resolves; that quoting
|
|
113
|
+
* change does not extend to validating the label.
|
|
109
114
|
* @param {string} label
|
|
110
115
|
* @returns {{ command: string, descriptor: string }}
|
|
111
116
|
*/
|
|
@@ -0,0 +1,304 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
|
|
4
|
+
// =============================================================================
|
|
5
|
+
// shell-command guard checker -- fourth mechanical guard in this directory,
|
|
6
|
+
// modelled on dispatch-safety-guard.mjs, dolt-literal-guard.mjs and
|
|
7
|
+
// full-db-fetch-guard.mjs (same shape: a line scanner exported and
|
|
8
|
+
// parameterizable by path, with explicit carve-outs for full-line comments
|
|
9
|
+
// and import/require lines, so it can be pointed at BOTH the real guarded
|
|
10
|
+
// modules and a throwaway fixture that deliberately violates the invariant).
|
|
11
|
+
//
|
|
12
|
+
// INVARIANT UNDER TEST: a member-bound command string must NEVER rely on
|
|
13
|
+
// shell-level expansion performed in the orchestrator process's idea of a
|
|
14
|
+
// shell. The target member's shell may be PowerShell (or cmd.exe, or
|
|
15
|
+
// Git-for-Windows bash), not POSIX sh -- so none of the following may appear
|
|
16
|
+
// in a string this repo hands to command()/execute_command:
|
|
17
|
+
//
|
|
18
|
+
// - variable expansion, bare (`$HOME`, `$env:USERPROFILE`) or braced
|
|
19
|
+
// (a literal `${VAR}` reaching the member, i.e. one written inside a
|
|
20
|
+
// single/double-quoted JS string or escaped as `\${VAR}` in a template
|
|
21
|
+
// literal);
|
|
22
|
+
// - a leading tilde path (`~/...`) -- PowerShell and cmd.exe do not expand
|
|
23
|
+
// it the way POSIX sh does;
|
|
24
|
+
// - backtick command substitution (a literal backtick reaching the member),
|
|
25
|
+
// or its `$( ... )` POSIX equivalent.
|
|
26
|
+
//
|
|
27
|
+
// Paths must instead be resolved in JavaScript BEFORE the command string is
|
|
28
|
+
// built -- via probeCommandFor(targetOs, shell) in src/services/member-home.ts,
|
|
29
|
+
// or by branching on isPosixShell(agentOs, shell) in src/providers/claude.ts
|
|
30
|
+
// (see also fleet-sprint/se-os-commands.mjs's per-shell command classes,
|
|
31
|
+
// which are how this package does that branching).
|
|
32
|
+
//
|
|
33
|
+
// WHAT IS DELIBERATELY NOT FLAGGED
|
|
34
|
+
//
|
|
35
|
+
// 1. JS template interpolation. A bare `${expr}` inside a backtick template
|
|
36
|
+
// literal is resolved IN JAVASCRIPT before the string is ever dispatched;
|
|
37
|
+
// that is the prescribed fix, not the violation. Only a `${...}` that
|
|
38
|
+
// survives into the emitted text -- one inside a '...'/"..." string, or
|
|
39
|
+
// written `\${...}` inside a template -- is a violation.
|
|
40
|
+
// 2. Backticks used as JS template-literal delimiters. Only an ESCAPED
|
|
41
|
+
// backtick (`\`` -- a literal backtick surviving into the emitted
|
|
42
|
+
// string) is a violation. An UNescaped backtick inside a '...'/"..."
|
|
43
|
+
// JS string is DELIBERATELY NOT flagged, even though it sits inside a
|
|
44
|
+
// quoted string -- it is overwhelmingly a markdown code span in
|
|
45
|
+
// agent-prompt prose (runner.js has ~24 of them) or a JS fence-builder,
|
|
46
|
+
// not a dispatched shell substitution, so flagging those would make
|
|
47
|
+
// this guard pure noise. A reader should take away that a backtick-
|
|
48
|
+
// wrapped substitution written inside ordinary '...'/"..." quotes in a
|
|
49
|
+
// member-bound command string is UNGUARDED by this rule.
|
|
50
|
+
// 3. Secret token references. execute_command replaces each secret.NAME
|
|
51
|
+
// (or legacy secure.NAME) token with a value that has ALREADY been quoted for the target
|
|
52
|
+
// member's shell (escapePowerShellArg for windows members,
|
|
53
|
+
// escapeShellArg otherwise -- src/tools/execute-command.ts). Those
|
|
54
|
+
// tokens carry no `$`, `~/` or backtick, so they never match a rule
|
|
55
|
+
// here; a bare token reference is correct and must stay bare (wrapping
|
|
56
|
+
// one in extra quotes double-escapes the value and surfaces as a false
|
|
57
|
+
// 401 / invalid-token error). This guard must never push a caller toward
|
|
58
|
+
// adding those quotes.
|
|
59
|
+
//
|
|
60
|
+
// CARVE-OUTS (mirroring the sibling guards):
|
|
61
|
+
// - full-line comments (trimmed text starting with `//`, `*` or `/*`) --
|
|
62
|
+
// prose that merely DISCUSSES `$HOME`/`~/`/backticks is not a dispatch;
|
|
63
|
+
// runner.js's own RUNNER-WIDE POSIX-EXPANSION SWEEP note is exactly this;
|
|
64
|
+
// - `import`/`require` lines;
|
|
65
|
+
// - an explicit, documented per-line allow directive: a trailing
|
|
66
|
+
// `// shell-guard-allow: <reason>` comment on the offending line (or on
|
|
67
|
+
// the line immediately above it) suppresses that line, and the reason
|
|
68
|
+
// text is REQUIRED -- an allow with no reason is itself reported. This
|
|
69
|
+
// exists for the handful of genuinely deliberate cases where the member's
|
|
70
|
+
// own shell must do the expansion because the WRITE side used the same
|
|
71
|
+
// token (fleet-sprint/se-posix.mjs's `$HOME/...` credential-helper path
|
|
72
|
+
// is the canonical example: it must stay byte-identical to what
|
|
73
|
+
// src/os/linux.ts wrote).
|
|
74
|
+
// =============================================================================
|
|
75
|
+
|
|
76
|
+
/** Trailing/standalone directive that suppresses one line, with a required reason. */
|
|
77
|
+
const ALLOW_RE = /shell-guard-allow:\s*(\S.*)$/;
|
|
78
|
+
/** An allow directive with no reason text after the colon. */
|
|
79
|
+
const ALLOW_NO_REASON_RE = /shell-guard-allow:\s*$/;
|
|
80
|
+
|
|
81
|
+
function isCommentLine(text) {
|
|
82
|
+
const trimmed = text.trim();
|
|
83
|
+
return trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*');
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
function isImportLine(text) {
|
|
87
|
+
return /^\s*(import\b|export\b.*\bfrom\b|(const|let|var)\s.*\brequire\s*\()/.test(text);
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* Splits `text` into segments tagged with the JS quoting context they sit in,
|
|
92
|
+
* scanning a single line left to right. Returns an array of
|
|
93
|
+
* { kind, start, end } where kind is one of 'code', 'single', 'double',
|
|
94
|
+
* 'template'. Deliberately single-line (like dispatch-safety-guard.mjs's
|
|
95
|
+
* isInsideSameLineString): a whole-file quote scan misfires on apostrophes in
|
|
96
|
+
* prose. A template literal that opens on this line and does not close is
|
|
97
|
+
* treated as running to end of line, which is the conservative choice -- the
|
|
98
|
+
* bytes on THIS line are what we classify.
|
|
99
|
+
*/
|
|
100
|
+
export function segmentLine(text) {
|
|
101
|
+
const segments = [];
|
|
102
|
+
let kind = 'code';
|
|
103
|
+
let start = 0;
|
|
104
|
+
for (let i = 0; i < text.length; i++) {
|
|
105
|
+
const ch = text[i];
|
|
106
|
+
if (ch === '\\') { i++; continue; }
|
|
107
|
+
if (kind === 'code') {
|
|
108
|
+
if (ch === "'" || ch === '"' || ch === '`') {
|
|
109
|
+
segments.push({ kind: 'code', start, end: i });
|
|
110
|
+
kind = ch === "'" ? 'single' : ch === '"' ? 'double' : 'template';
|
|
111
|
+
start = i + 1;
|
|
112
|
+
}
|
|
113
|
+
} else {
|
|
114
|
+
const closer = kind === 'single' ? "'" : kind === 'double' ? '"' : '`';
|
|
115
|
+
if (ch === closer) {
|
|
116
|
+
segments.push({ kind, start, end: i });
|
|
117
|
+
kind = 'code';
|
|
118
|
+
start = i + 1;
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
segments.push({ kind, start, end: text.length });
|
|
123
|
+
return segments.filter((s) => s.end > s.start);
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/** True when `col` sits inside a JS template literal opened earlier on the same line. */
|
|
127
|
+
function segmentKindAt(segments, col) {
|
|
128
|
+
for (const s of segments) {
|
|
129
|
+
if (col >= s.start && col < s.end) return s.kind;
|
|
130
|
+
}
|
|
131
|
+
return 'code';
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
// A shell variable expansion with no braces: `$HOME`, `$env:USERPROFILE`,
|
|
135
|
+
// `$pid`. Not preceded by a `$` (so `$$` is not double-counted) and not
|
|
136
|
+
// followed by `{`.
|
|
137
|
+
const BARE_VAR_RE = /(?<!\$)\$([A-Za-z_][A-Za-z0-9_:]*)/g;
|
|
138
|
+
// A brace expansion written so it SURVIVES into the emitted string.
|
|
139
|
+
const BRACED_VAR_RE = /\$\{/g;
|
|
140
|
+
// POSIX command substitution.
|
|
141
|
+
const CMD_SUBST_RE = /\$\(/g;
|
|
142
|
+
// A leading tilde path.
|
|
143
|
+
const TILDE_RE = /(^|[\s'"`=(,:])~\//g;
|
|
144
|
+
|
|
145
|
+
/**
|
|
146
|
+
* Scans one line of source and returns an array of { column, reason } for
|
|
147
|
+
* every shell-expansion construct that would survive into a dispatched
|
|
148
|
+
* command string. Exported for direct unit testing.
|
|
149
|
+
*/
|
|
150
|
+
export function findLineViolations(text) {
|
|
151
|
+
const segments = segmentLine(text);
|
|
152
|
+
const found = [];
|
|
153
|
+
const inString = (col) => segmentKindAt(segments, col) !== 'code';
|
|
154
|
+
|
|
155
|
+
let m;
|
|
156
|
+
BARE_VAR_RE.lastIndex = 0;
|
|
157
|
+
while ((m = BARE_VAR_RE.exec(text)) !== null) {
|
|
158
|
+
if (!inString(m.index)) continue;
|
|
159
|
+
found.push({
|
|
160
|
+
column: m.index + 1,
|
|
161
|
+
reason:
|
|
162
|
+
`bare shell variable expansion "$${m[1]}" in a command string -- the target member's shell may be ` +
|
|
163
|
+
`PowerShell, not POSIX; resolve the value in JavaScript first (probeCommandFor(targetOs, shell) in ` +
|
|
164
|
+
`src/services/member-home.ts, or branch on isPosixShell(agentOs, shell))`,
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
CMD_SUBST_RE.lastIndex = 0;
|
|
169
|
+
while ((m = CMD_SUBST_RE.exec(text)) !== null) {
|
|
170
|
+
if (!inString(m.index)) continue;
|
|
171
|
+
found.push({
|
|
172
|
+
column: m.index + 1,
|
|
173
|
+
reason:
|
|
174
|
+
'POSIX command substitution "$(" in a command string -- run the probe as its own dispatch and ' + // shell-guard-allow: this guard's own violation-message text names the "$(" construct it detects; it is never dispatched as a command string.
|
|
175
|
+
'interpolate the result in JavaScript instead',
|
|
176
|
+
});
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
BRACED_VAR_RE.lastIndex = 0;
|
|
180
|
+
while ((m = BRACED_VAR_RE.exec(text)) !== null) {
|
|
181
|
+
const kind = segmentKindAt(segments, m.index);
|
|
182
|
+
const escaped = m.index > 0 && text[m.index - 1] === '\\';
|
|
183
|
+
// A bare `${...}` inside a template literal is JS interpolation --
|
|
184
|
+
// resolved before dispatch, which is the prescribed fix. Only a
|
|
185
|
+
// braced expansion that survives into the emitted text counts.
|
|
186
|
+
if (kind === 'template' && !escaped) continue;
|
|
187
|
+
if (kind === 'code') continue;
|
|
188
|
+
found.push({
|
|
189
|
+
column: m.index + 1,
|
|
190
|
+
reason:
|
|
191
|
+
'braced shell variable expansion "${...}" survives into the dispatched command string -- ' + // shell-guard-allow: this guard's own violation-message text names the "${...}" construct it detects; it is never dispatched as a command string.
|
|
192
|
+
'interpolate the value in JavaScript instead of leaving it for the member shell to expand',
|
|
193
|
+
});
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
TILDE_RE.lastIndex = 0;
|
|
197
|
+
while ((m = TILDE_RE.exec(text)) !== null) {
|
|
198
|
+
const col = m.index + m[1].length;
|
|
199
|
+
if (!inString(col)) continue;
|
|
200
|
+
found.push({
|
|
201
|
+
column: col + 1,
|
|
202
|
+
reason:
|
|
203
|
+
'leading tilde path "~/" in a command string -- PowerShell and cmd.exe do not expand it; resolve ' + // shell-guard-allow: this guard's own violation-message text names the "~/" construct it detects; it is never dispatched as a command string.
|
|
204
|
+
"the member's home directory in JavaScript (probeCommandFor(targetOs, shell))",
|
|
205
|
+
});
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
// Backticks: only an ESCAPED backtick counts -- see the rule note in this
|
|
209
|
+
// file's header. An UNescaped backtick inside a '...'/"..." JS string is
|
|
210
|
+
// overwhelmingly a markdown code span in agent-prompt prose (runner.js has
|
|
211
|
+
// ~24 of them) or a JS fence-builder, not a dispatched shell substitution,
|
|
212
|
+
// so flagging those makes the guard pure noise. `\`` in a template literal
|
|
213
|
+
// is the deliberate "emit a literal backtick into this command string"
|
|
214
|
+
// spelling, which is the construct this rule exists to catch.
|
|
215
|
+
for (let i = 0; i < text.length; i++) {
|
|
216
|
+
if (text[i] !== '`') continue;
|
|
217
|
+
const escaped = i > 0 && text[i - 1] === '\\';
|
|
218
|
+
if (!escaped) continue;
|
|
219
|
+
found.push({
|
|
220
|
+
column: i + 1,
|
|
221
|
+
reason:
|
|
222
|
+
'backtick command substitution in a command string -- run the probe as its own dispatch and ' +
|
|
223
|
+
'interpolate the result in JavaScript instead',
|
|
224
|
+
});
|
|
225
|
+
break; // one report per line is enough; a pair of backticks is one construct
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
return found.sort((a, b) => a.column - b.column);
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
/**
|
|
232
|
+
* Scans whole-file source `src`, applying the carve-outs, and returns an
|
|
233
|
+
* array of { line, column, reason, text } violations.
|
|
234
|
+
*/
|
|
235
|
+
export function findShellCommandViolations(src) {
|
|
236
|
+
const lines = src.split('\n');
|
|
237
|
+
const violations = [];
|
|
238
|
+
for (let i = 0; i < lines.length; i++) {
|
|
239
|
+
const text = lines[i];
|
|
240
|
+
const prev = i > 0 ? lines[i - 1] : '';
|
|
241
|
+
if (isCommentLine(text)) {
|
|
242
|
+
// A standalone allow directive with no reason is still reported,
|
|
243
|
+
// so a suppression can never be added without saying why.
|
|
244
|
+
if (ALLOW_NO_REASON_RE.test(text)) {
|
|
245
|
+
violations.push({
|
|
246
|
+
line: i + 1,
|
|
247
|
+
column: text.indexOf('shell-guard-allow') + 1,
|
|
248
|
+
reason: 'shell-guard-allow directive has no reason text -- state why the member shell must do the expansion',
|
|
249
|
+
text: text.trim(),
|
|
250
|
+
});
|
|
251
|
+
}
|
|
252
|
+
continue;
|
|
253
|
+
}
|
|
254
|
+
if (isImportLine(text)) continue;
|
|
255
|
+
const lineFindings = findLineViolations(text);
|
|
256
|
+
if (lineFindings.length === 0) continue;
|
|
257
|
+
if (ALLOW_NO_REASON_RE.test(text) || ALLOW_NO_REASON_RE.test(prev)) {
|
|
258
|
+
violations.push({
|
|
259
|
+
line: i + 1,
|
|
260
|
+
column: 1,
|
|
261
|
+
reason: 'shell-guard-allow directive has no reason text -- state why the member shell must do the expansion',
|
|
262
|
+
text: text.trim(),
|
|
263
|
+
});
|
|
264
|
+
continue;
|
|
265
|
+
}
|
|
266
|
+
if (ALLOW_RE.test(text) || ALLOW_RE.test(prev)) continue;
|
|
267
|
+
for (const f of lineFindings) {
|
|
268
|
+
violations.push({ line: i + 1, column: f.column, reason: f.reason, text: text.trim() });
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
return violations;
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* Reads and scans the source file at `filePath`, returning
|
|
276
|
+
* { violations } where each violation is { file, line, column, reason, text }
|
|
277
|
+
* -- `file` is the basename, matching how the sibling guards label a
|
|
278
|
+
* violation, so an aggregate run over several modules attributes each finding
|
|
279
|
+
* to the module it came from.
|
|
280
|
+
*/
|
|
281
|
+
export function checkShellCommandPath(filePath) {
|
|
282
|
+
const src = fs.readFileSync(filePath, 'utf8');
|
|
283
|
+
const file = path.basename(filePath);
|
|
284
|
+
const violations = findShellCommandViolations(src).map((v) => ({ file, ...v }));
|
|
285
|
+
return { violations };
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/**
|
|
289
|
+
* Aggregate entry point: scans EVERY path in `paths` (e.g. the shared guarded
|
|
290
|
+
* module list) and returns { violations, files } with each violation carrying
|
|
291
|
+
* the file it came from. Takes an explicit array so this module stays
|
|
292
|
+
* independent of any one registry.
|
|
293
|
+
*/
|
|
294
|
+
export function checkShellCommandPaths(paths) {
|
|
295
|
+
if (!Array.isArray(paths)) throw new TypeError('checkShellCommandPaths(paths): paths must be an array of file paths');
|
|
296
|
+
const violations = [];
|
|
297
|
+
for (const p of paths) violations.push(...checkShellCommandPath(p).violations);
|
|
298
|
+
return { violations, files: paths.map((p) => path.basename(p)) };
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
/** Human-readable rendering of one violation, for assertion messages and logs. */
|
|
302
|
+
export function formatShellCommandViolation(v) {
|
|
303
|
+
return `${v.file || '<unknown>'}:${v.line}:${v.column} ${v.reason}`;
|
|
304
|
+
}
|
|
@@ -26,6 +26,8 @@ apra-fleet workflow fleet-sprint \
|
|
|
26
26
|
[--viewer-port <port>] # default 8080
|
|
27
27
|
[--budget <usd>] # default unlimited
|
|
28
28
|
[--dispatch-timeout-s <s>] # default 9000
|
|
29
|
+
[--usage-limit-max-wait-s <s>] # usage-limit pause budget; default from role-policies
|
|
30
|
+
[--usage-limit-max-reprobes <n>]# usage-limit reprobe cap; default from role-policies
|
|
29
31
|
[--sync] # synced-topology mode
|
|
30
32
|
```
|
|
31
33
|
|
|
@@ -55,6 +57,11 @@ on this list -- flags evolve and this skill can drift.
|
|
|
55
57
|
or `@path/to/file.json`.
|
|
56
58
|
- `--goal` controls which bead priorities are in scope for the run.
|
|
57
59
|
- `--budget` caps total spend in USD; the run aborts when it is exhausted.
|
|
60
|
+
- `--usage-limit-max-wait-s` / `--usage-limit-max-reprobes` bound how long a
|
|
61
|
+
dispatch that hit a provider usage/rate limit is paused (and re-probed on a
|
|
62
|
+
backoff ladder) before the run gives up with a typed abort. Both are
|
|
63
|
+
optional; omitted, the engine uses its own defaults. A resumed member
|
|
64
|
+
re-dispatches without consuming a retry attempt.
|
|
58
65
|
|
|
59
66
|
## Preconditions to check first
|
|
60
67
|
|
|
@@ -73,6 +80,17 @@ on this list -- flags evolve and this skill can drift.
|
|
|
73
80
|
4. If a member's LLM session is stale or unauthenticated (dispatch fails
|
|
74
81
|
with `empty_response`, or "member CLI likely died"), re-run
|
|
75
82
|
`provision_llm_auth` for that member before retrying.
|
|
83
|
+
5. Beads identity: before any `bd` mutation, the sprint probes every
|
|
84
|
+
member's `bd where`/`sync.remote`/git origin and prints a `Beads:`
|
|
85
|
+
banner plus one `beads ok: <member> ...` line per member. A MISMATCH
|
|
86
|
+
(a field that resolved on both sides and differs) aborts with
|
|
87
|
+
`BeadsIdentityError` naming the member and field before anything is
|
|
88
|
+
mutated; fix by correcting that member's `workFolder` (wrong `.beads`)
|
|
89
|
+
or its `sync.remote` -- there is no bypass flag. A probe that fails or
|
|
90
|
+
resolves nothing is only a `[beads-identity] WARNING:` line (naming the
|
|
91
|
+
member, field, probe, error and the fix): that field is not compared and
|
|
92
|
+
the sprint proceeds -- read the warning and fix the member, but do not
|
|
93
|
+
treat it as an abort.
|
|
76
94
|
|
|
77
95
|
## Launching it
|
|
78
96
|
|
|
@@ -21,16 +21,35 @@ Start it detached (it runs indefinitely -- exits only on `POST
|
|
|
21
21
|
node packages/apra-fleet-se/bin/serve.mjs # background/detached, from repo root
|
|
22
22
|
```
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
Start it from INSIDE the target project (any folder under it): the
|
|
25
|
+
supervisor resolves the project's `.beads` by walking up from its cwd,
|
|
26
|
+
exactly like `bd`. Starting from elsewhere: pass `--beads-dir <project
|
|
27
|
+
folder or its .beads>` (a path that does not exist is a startup error). It
|
|
28
|
+
logs one `supervisor beads: <dir> | prefix=<p> | remote=<sync.remote>` line
|
|
29
|
+
at startup; the same identity is on `GET /api/health` (`beads`) and at the
|
|
30
|
+
top of the dashboard, and every sprint it launches is told to verify its
|
|
31
|
+
members against it. If NO `.beads` is found (or its probe fails) it still
|
|
32
|
+
starts, but logs `[supervisor] WARNING: no beads database found walking up
|
|
33
|
+
from <cwd> ... To fix: ...`, reports `beads: null` plus `beadsWarning` on
|
|
34
|
+
`/api/health`, shows an amber `Beads: NOT RESOLVED -- ...` header on the
|
|
35
|
+
dashboard, and launches sprints WITHOUT `--expect-beads` (they then verify
|
|
36
|
+
members against the orchestrator member's own beads). Treat that as
|
|
37
|
+
"restart from the right folder / with `--beads-dir`", or fix the
|
|
38
|
+
environment and hit `GET /api/health?refresh=1` to recover without a
|
|
39
|
+
restart. `--port <n>` overrides the default (8787). Self-logs to
|
|
25
40
|
`<dataDir>/logs/supervisor.log` in addition to stdout.
|
|
26
41
|
|
|
27
42
|
Smoke test (a few seconds after launch -- give it time to bind):
|
|
28
43
|
```bash
|
|
29
44
|
curl -s -m 5 http://localhost:8787/api/sprints # expect {"sprints":[],...}
|
|
30
45
|
curl -s -m 5 http://localhost:8787/api/members # expect the registered fleet, non-empty
|
|
46
|
+
curl -s -m 5 http://localhost:8787/api/health # check `beads.dir`/`beads.prefix` is the intended tracker
|
|
31
47
|
```
|
|
32
48
|
Both must succeed before treating the supervisor as up -- a bound port with
|
|
33
|
-
a 500 on `/api/members` still means something is broken.
|
|
49
|
+
a 500 on `/api/members` still means something is broken. A wrong
|
|
50
|
+
`beads.prefix` means it was started from the wrong folder: stop it and
|
|
51
|
+
restart with `--beads-dir`. `beads: null` with a `beadsWarning` means no
|
|
52
|
+
tracker was resolved at all: the warning text says what to do.
|
|
34
53
|
|
|
35
54
|
## Stop the supervisor
|
|
36
55
|
|