@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
|
@@ -0,0 +1,216 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
import { guardedModulePaths } from './guarded-modules.mjs';
|
|
4
|
+
import { findCallSites } from './dispatch-safety-guard.mjs';
|
|
5
|
+
import { ROLE_POLICIES, migratedRoleNames } from './role-policies.mjs';
|
|
6
|
+
|
|
7
|
+
// =============================================================================
|
|
8
|
+
// apra-fleet-3swo.5.8 -- inline-ladder guard checker.
|
|
9
|
+
//
|
|
10
|
+
// WHY THIS EXISTS: the dispatchRole(ctx, roleName, opts) migration
|
|
11
|
+
// (apra-fleet-3swo.5.3/.5.6) moves each role's hand-written agent() dispatch
|
|
12
|
+
// ladder out of runner.js onto a shared engine driven by
|
|
13
|
+
// fleet-sprint/role-policies.mjs's data table. A migration is only real once
|
|
14
|
+
// the OLD inline ladder for that role is gone -- a migration that adds the
|
|
15
|
+
// dispatchRole call but forgets to delete the original agent() ladder would
|
|
16
|
+
// leave the role dispatching TWICE (or dispatching from whichever code path
|
|
17
|
+
// happens to run first) while every other guard and pin stays green, because
|
|
18
|
+
// none of them assert absence of an inline call once a role is marked done.
|
|
19
|
+
// This guard closes that hole: for every role role-policies.mjs marks
|
|
20
|
+
// `migrated: true`, it flags any surviving inline agent() call site that
|
|
21
|
+
// still routes to that role's member.
|
|
22
|
+
//
|
|
23
|
+
// STANDING RULE, same as dispatch-safety-guard.mjs/dolt-literal-guard.mjs/
|
|
24
|
+
// full-db-fetch-guard.mjs/shell-command-guard.mjs/unbracketed-push-guard.mjs:
|
|
25
|
+
// this guard takes its scanned-file list from the SHARED guarded-module list
|
|
26
|
+
// (./guarded-modules.mjs) and defines no private path array of its own -- a
|
|
27
|
+
// guard that does not consume that list is a guard whose coverage silently
|
|
28
|
+
// rots the moment a dispatch ladder moves into a newly extracted module.
|
|
29
|
+
//
|
|
30
|
+
// TODAY'S BASELINE: no role is marked migrated yet (role-policies.mjs's
|
|
31
|
+
// migratedRoleNames() returns []), so checkModules() reports zero violations
|
|
32
|
+
// against the current tree by construction -- there is nothing yet to flag.
|
|
33
|
+
// That green baseline is the floor the dispatchRole migration beads must
|
|
34
|
+
// keep green as they migrate roles one at a time.
|
|
35
|
+
//
|
|
36
|
+
// HOW A ROLE'S INLINE LADDER IS RECOGNISED: role-policies.mjs's `member`
|
|
37
|
+
// field already records, as data, the resolution kind and argument a role's
|
|
38
|
+
// dispatch routes to ('role' -> getMemberForRole(role), 'pool-head' -> a
|
|
39
|
+
// runner-local binding expression e.g. reviewerPool[0], 'runtime' -> a
|
|
40
|
+
// runner-local binding expression e.g. doerMember). memberExprFor() below
|
|
41
|
+
// rebuilds the exact source expression runner.js's ladders write for ALL
|
|
42
|
+
// THREE kinds: a 'role'-kind member becomes getMemberForRole(role); a
|
|
43
|
+
// 'pool-head'/'runtime'-kind member becomes its own recorded `binding`
|
|
44
|
+
// string verbatim (runner.js writes `member_name: reviewerPool[0]` /
|
|
45
|
+
// `member_name: doerMember` at its real call sites -- see doer and
|
|
46
|
+
// reviewer's real policy entries in role-policies.mjs). This matters because
|
|
47
|
+
// the two execution-role migration beads in this phase migrate doer
|
|
48
|
+
// (runtime member) and reviewer (pool-head member), not just role-kind
|
|
49
|
+
// roles -- a guard that only recognised 'role'-kind members would stay
|
|
50
|
+
// silently green for exactly those two roles' surviving inline ladders,
|
|
51
|
+
// which is the one failure mode this guard exists to prevent.
|
|
52
|
+
//
|
|
53
|
+
// MEMBER EXPRESSION ALONE IS NOT ROLE-UNIQUE (apra-fleet-3swo.24): three
|
|
54
|
+
// policies share roleMember('planner') (planner, scoped-replan-planner,
|
|
55
|
+
// streak-assignment) and two share roleMember('plan-reviewer') (plan-reviewer,
|
|
56
|
+
// scoped-replan-plan-reviewer). Neither agentType nor schema disambiguates
|
|
57
|
+
// them either. So memberExprFor()'s expression is only a coarse PRE-FILTER
|
|
58
|
+
// here: a call site is only reported once it ALSO contains that dispatch's
|
|
59
|
+
// `ladderAnchor` (role-policies.mjs) -- a literal substring unique to that
|
|
60
|
+
// dispatch's own real call site. A call site matching the member expression
|
|
61
|
+
// but not the anchor belongs to a sibling ladder and is never reported.
|
|
62
|
+
// =============================================================================
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* The source expression a policy's `member` resolves to at its real inline
|
|
66
|
+
* call site (see header): 'role' -> getMemberForRole(role); 'pool-head' and
|
|
67
|
+
* 'runtime' -> the member's own recorded `binding` string verbatim (that is
|
|
68
|
+
* exactly what runner.js's ladders write, e.g. `member_name: doerMember` /
|
|
69
|
+
* `member_name: reviewerPool[0]`). Returns null for a missing/unrecognised
|
|
70
|
+
* member or a 'pool-head'/'runtime' member with no binding recorded, so
|
|
71
|
+
* callers can skip it rather than falsely matching on an unresolvable
|
|
72
|
+
* expression.
|
|
73
|
+
*
|
|
74
|
+
* @param {{kind:string, role?:string, binding?:string}} member
|
|
75
|
+
* @returns {string|null}
|
|
76
|
+
*/
|
|
77
|
+
export function memberExprFor(member) {
|
|
78
|
+
if (!member) return null;
|
|
79
|
+
if (member.kind === 'role') return `getMemberForRole('${member.role}')`;
|
|
80
|
+
if (member.kind === 'pool-head' || member.kind === 'runtime') {
|
|
81
|
+
return typeof member.binding === 'string' && member.binding.length > 0 ? member.binding : null;
|
|
82
|
+
}
|
|
83
|
+
return null;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* Scans `src` for `agent(` call sites whose call text still carries one of
|
|
88
|
+
* `migratedRoles`' member-routing expressions AND that dispatch's
|
|
89
|
+
* `ladderAnchor` -- an inline ladder that has not been removed even though
|
|
90
|
+
* role-policies.mjs says this role's dispatch has moved onto the engine.
|
|
91
|
+
*
|
|
92
|
+
* The member expression alone is a coarse pre-filter, never the sole
|
|
93
|
+
* discriminator (apra-fleet-3swo.24): several policies share the same
|
|
94
|
+
* member-routing expression (see this file's header), so a site is only
|
|
95
|
+
* reported once it ALSO contains the specific dispatch's ladderAnchor.
|
|
96
|
+
*
|
|
97
|
+
* @param {string} src
|
|
98
|
+
* @param {string} fileLabel
|
|
99
|
+
* @param {string[]} migratedRoles
|
|
100
|
+
* @param {Record<string, object>} rolePolicies
|
|
101
|
+
* @returns {string[]}
|
|
102
|
+
*/
|
|
103
|
+
export function findInlineLadderViolations(src, fileLabel, migratedRoles, rolePolicies) {
|
|
104
|
+
if (migratedRoles.length === 0) return [];
|
|
105
|
+
const agentSites = findCallSites(src).filter((s) => s.fnName === 'agent');
|
|
106
|
+
if (agentSites.length === 0) return [];
|
|
107
|
+
|
|
108
|
+
const violations = [];
|
|
109
|
+
for (const role of migratedRoles) {
|
|
110
|
+
const entry = rolePolicies[role];
|
|
111
|
+
if (!entry) continue;
|
|
112
|
+
// A role's main dispatch and its secondary (max-turns-resume /
|
|
113
|
+
// semantic-repair-re-ask) each carry their OWN ladderAnchor (the two
|
|
114
|
+
// are distinct real call sites in runner.js), so pair each dispatch's
|
|
115
|
+
// member expression with its own anchor rather than pooling all
|
|
116
|
+
// exprs together -- pooling would let one dispatch's anchor match
|
|
117
|
+
// against a site that only satisfies a DIFFERENT dispatch's member
|
|
118
|
+
// expression. De-duplicate identical (expr, anchor) pairs so a
|
|
119
|
+
// dispatch variant that happens to repeat both is never matched
|
|
120
|
+
// twice.
|
|
121
|
+
const pairs = new Set();
|
|
122
|
+
for (const dispatch of [entry, entry.secondary]) {
|
|
123
|
+
if (!dispatch) continue;
|
|
124
|
+
const expr = memberExprFor(dispatch.member);
|
|
125
|
+
if (!expr) {
|
|
126
|
+
// apra-fleet-3swo.66: a dispatch that HAS a member but whose
|
|
127
|
+
// kind memberExprFor() does not recognise (or whose
|
|
128
|
+
// pool-head/runtime binding is missing) must fail loudly, the
|
|
129
|
+
// same way an empty ladderAnchor does just below -- silently
|
|
130
|
+
// `continue`-ing here means this role is scanned for zero
|
|
131
|
+
// call sites and checkModules() reports zero violations for
|
|
132
|
+
// it, indistinguishable from a genuinely clean tree. That is
|
|
133
|
+
// the exact false-negative this guard exists to prevent. A
|
|
134
|
+
// dispatch with NO member at all is not this hazard (there is
|
|
135
|
+
// nothing routing-related to fail to resolve), so it still
|
|
136
|
+
// falls through to a plain `continue`.
|
|
137
|
+
if (dispatch.member) {
|
|
138
|
+
const kind = dispatch.member.kind;
|
|
139
|
+
const recognisedKind = kind === 'role' || kind === 'pool-head' || kind === 'runtime';
|
|
140
|
+
throw new Error(
|
|
141
|
+
recognisedKind
|
|
142
|
+
? `inline-ladder-guard: role '${role}' has a '${kind}' member with no binding recorded -- ` +
|
|
143
|
+
'memberExprFor() cannot build a search expression for it, so this guard cannot verify ' +
|
|
144
|
+
`the old inline ladder for '${role}' was removed and would silently report zero ` +
|
|
145
|
+
'violations for it.'
|
|
146
|
+
: `inline-ladder-guard: role '${role}' has a member with an unrecognised kind ` +
|
|
147
|
+
`(${JSON.stringify(kind)}) -- memberExprFor() has no case for it, so this guard cannot ` +
|
|
148
|
+
`verify the old inline ladder for '${role}' was removed and would silently report zero ` +
|
|
149
|
+
`violations for it. Add a memberExprFor() case for kind ${JSON.stringify(kind)}.`
|
|
150
|
+
);
|
|
151
|
+
}
|
|
152
|
+
continue;
|
|
153
|
+
}
|
|
154
|
+
if (typeof dispatch.ladderAnchor !== 'string' || dispatch.ladderAnchor.length === 0) {
|
|
155
|
+
throw new Error(
|
|
156
|
+
`inline-ladder-guard: role '${role}' has no non-empty ladderAnchor -- every dispatch role-policies.mjs ` +
|
|
157
|
+
'can mark migrated must carry a unique ladder anchor so this guard can tell sibling ladders apart.'
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
pairs.add(JSON.stringify([expr, dispatch.ladderAnchor]));
|
|
161
|
+
}
|
|
162
|
+
// One real call site must never be reported twice for the same role,
|
|
163
|
+
// even if (implausibly) more than one (expr, anchor) pair matched it.
|
|
164
|
+
const reportedSites = new Set();
|
|
165
|
+
for (const pairKey of pairs) {
|
|
166
|
+
const [expr, anchor] = JSON.parse(pairKey);
|
|
167
|
+
for (const site of agentSites) {
|
|
168
|
+
if (reportedSites.has(site)) continue;
|
|
169
|
+
if (site.callText.includes(expr) && site.callText.includes(anchor)) {
|
|
170
|
+
reportedSites.add(site);
|
|
171
|
+
// NOTE: deliberately spelled with a space before the
|
|
172
|
+
// opening paren ("agent (") rather than "agent(" -- the
|
|
173
|
+
// latter is the literal substring dispatch-safety-guard's
|
|
174
|
+
// findCallSites() (which this module itself is built on)
|
|
175
|
+
// treats as a real call site, and this file is itself a
|
|
176
|
+
// GUARDED_MODULES entry.
|
|
177
|
+
violations.push(
|
|
178
|
+
`${fileLabel}:${site.line} (fnName=${site.fnName}) still dispatches role '${role}' ` +
|
|
179
|
+
`inline via a raw agent () call -- role-policies.mjs marks '${role}' migrated, so ` +
|
|
180
|
+
'this ladder must route through dispatchRole() instead.'
|
|
181
|
+
);
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
return violations;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* Aggregate entry point, mirroring dispatch-safety-guard.mjs's
|
|
191
|
+
* checkModules(): scans every module in `paths` (default: the shared
|
|
192
|
+
* guarded-module list) for a surviving inline agent() ladder belonging to a
|
|
193
|
+
* role `rolePolicies` marks migrated (default: role-policies.mjs's real
|
|
194
|
+
* table, via migratedRoleNames()).
|
|
195
|
+
*
|
|
196
|
+
* @param {{paths?: string[], migratedRoles?: string[], rolePolicies?: Record<string, object>}} [opts]
|
|
197
|
+
* @returns {{ violations: string[], files: string[] }}
|
|
198
|
+
*/
|
|
199
|
+
export function checkModules({
|
|
200
|
+
paths = guardedModulePaths(),
|
|
201
|
+
migratedRoles = migratedRoleNames(),
|
|
202
|
+
rolePolicies = ROLE_POLICIES,
|
|
203
|
+
} = {}) {
|
|
204
|
+
if (!Array.isArray(paths)) {
|
|
205
|
+
throw new TypeError('checkModules(opts): opts.paths must be an array of file paths');
|
|
206
|
+
}
|
|
207
|
+
const violations = [];
|
|
208
|
+
const files = [];
|
|
209
|
+
for (const p of paths) {
|
|
210
|
+
const file = path.basename(p);
|
|
211
|
+
files.push(file);
|
|
212
|
+
const src = fs.readFileSync(p, 'utf8');
|
|
213
|
+
violations.push(...findInlineLadderViolations(src, file, migratedRoles, rolePolicies));
|
|
214
|
+
}
|
|
215
|
+
return { violations, files };
|
|
216
|
+
}
|