@apralabs/apra-fleet 0.4.2 → 0.4.4
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 +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- 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 +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- 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/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- 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 +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -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/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -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 +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -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 +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- 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 +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// apra-fleet-unw.15 -- typed error(s) local to the
|
|
1
|
+
// apra-fleet-unw.15 -- typed error(s) local to the fleet-sprint runner.
|
|
2
2
|
//
|
|
3
3
|
// SprintPlanRejectedError is sprint-specific (it is only ever thrown by
|
|
4
4
|
// runner.js's Plan phase) so it lives here rather than in
|
|
@@ -50,6 +50,15 @@ import { WorkflowError } from '@apralabs/apra-fleet-workflow';
|
|
|
50
50
|
// UNSUPPORTED_OPERATION The requested action is not implemented for this
|
|
51
51
|
// provider. A programming/config error; retrying and
|
|
52
52
|
// re-authenticating are both pointless.
|
|
53
|
+
// MISSING_TOOL The command's binary (bd, dolt, git, ...) could not
|
|
54
|
+
// be found on the member at all: PowerShell's "is not
|
|
55
|
+
// recognized as the name of a cmdlet", cmd.exe's "is
|
|
56
|
+
// not recognized as an internal or external command",
|
|
57
|
+
// POSIX "command not found" / ": not found", exit code
|
|
58
|
+
// 127, spawn ENOENT. Checked BEFORE every provider
|
|
59
|
+
// rule (GitHub #616). Never retried and never routed
|
|
60
|
+
// to the credential self-heal -- re-provisioning
|
|
61
|
+
// cannot install a binary or fix a PATH.
|
|
53
62
|
// UNKNOWN Explicitly unrecognized. Never retried, never
|
|
54
63
|
// self-healed -- an unmatched stderr must surface, not
|
|
55
64
|
// be guessed at.
|
|
@@ -68,6 +77,7 @@ export const VCS_FAILURE_KINDS = Object.freeze({
|
|
|
68
77
|
EMPTY_REMOTE: 'EMPTY_REMOTE',
|
|
69
78
|
REMOTE_UNREACHABLE: 'REMOTE_UNREACHABLE',
|
|
70
79
|
UNSUPPORTED_OPERATION: 'UNSUPPORTED_OPERATION',
|
|
80
|
+
MISSING_TOOL: 'MISSING_TOOL',
|
|
71
81
|
UNKNOWN: 'UNKNOWN',
|
|
72
82
|
});
|
|
73
83
|
|
|
@@ -346,6 +356,25 @@ export class DoltSyncError extends WorkflowError {
|
|
|
346
356
|
}
|
|
347
357
|
}
|
|
348
358
|
|
|
359
|
+
/**
|
|
360
|
+
* Thrown by preflightBeadsHealthGate() when the backlog member's beads clone
|
|
361
|
+
* holds local schema migrations bd auto-applied but never published (the
|
|
362
|
+
* pre-dispatch D-pull fails "local changes would be stomped by merge") AND the
|
|
363
|
+
* publish-and-retry heal could not recover. A DoltSyncError subtype, so every
|
|
364
|
+
* existing DoltSyncError handler still applies; the message names the cause
|
|
365
|
+
* and the exact fix commands.
|
|
366
|
+
*/
|
|
367
|
+
export class UnpublishedSchemaMigrationsError extends DoltSyncError {
|
|
368
|
+
/**
|
|
369
|
+
* @param {string} message
|
|
370
|
+
* @param {{ member?: string|null, doltOutput?: string|null, details?: object, cause?: unknown }} [opts]
|
|
371
|
+
*/
|
|
372
|
+
constructor(message, opts = {}) {
|
|
373
|
+
super(message, { ...opts, details: { kind: 'unpublished-schema-migrations', ...opts.details } });
|
|
374
|
+
this.name = 'UnpublishedSchemaMigrationsError';
|
|
375
|
+
}
|
|
376
|
+
}
|
|
377
|
+
|
|
349
378
|
/**
|
|
350
379
|
* apra-fleet dolt-settle redesign (see fleet-sprint/docs/dolt-sync-redesign.md
|
|
351
380
|
* Part 5) -- thrown by settleDoltConflicts() when a member has no usable,
|
|
@@ -402,7 +431,7 @@ export class DoltBinaryUnavailableError extends WorkflowError {
|
|
|
402
431
|
// AgentDispatchError -- checked FIRST below since it can't be fooled by
|
|
403
432
|
// auth-like noise in an unrelated failure's message text; the regex remains
|
|
404
433
|
// as a fallback for older/mocked errors that only ever set `.message`.
|
|
405
|
-
const NON_RETRYABLE_DISPATCH_RE = /authentication failed|not logged in|workspace not trusted|has not been trusted/i;
|
|
434
|
+
const NON_RETRYABLE_DISPATCH_RE = /authentication failed|failed to authenticate|oauth session expired|could not be refreshed|not logged in|workspace not trusted|has not been trusted/i;
|
|
406
435
|
|
|
407
436
|
/**
|
|
408
437
|
* True when a dispatch error can NEVER be fixed by retrying (auth /
|
|
@@ -422,7 +451,7 @@ export function isNonRetryableDispatchError(err) {
|
|
|
422
451
|
// LLM credential failure (as opposed to workspace-trust, which
|
|
423
452
|
// provision_llm_auth cannot fix -- that needs an operator to run `claude
|
|
424
453
|
// --dangerously-skip-permissions` or trust the folder interactively).
|
|
425
|
-
const AUTH_DISPATCH_RE = /authentication failed|not logged in/i;
|
|
454
|
+
const AUTH_DISPATCH_RE = /authentication failed|failed to authenticate|oauth session expired|could not be refreshed|not logged in/i;
|
|
426
455
|
|
|
427
456
|
/**
|
|
428
457
|
* True when a dispatch error is specifically an LLM auth/credential failure
|
|
@@ -460,6 +489,20 @@ export function isAuthDispatchError(err) {
|
|
|
460
489
|
// remote pid and aborted the in-flight dispatch
|
|
461
490
|
// (apra-fleet-3c9.1). Like the others, no test
|
|
462
491
|
// verdict was ever produced.
|
|
492
|
+
// - 'agent_never_started' -- the member's session log never appeared at
|
|
493
|
+
// its authoritative path within the inactivity
|
|
494
|
+
// threshold; the process was killed before it
|
|
495
|
+
// ever ran the task.
|
|
496
|
+
// - 'max_total_time' -- the dispatch ran out of max_total_s (measured
|
|
497
|
+
// from the call, setup included) and was
|
|
498
|
+
// stopped. Before this reason existed the same
|
|
499
|
+
// kill surfaced as 'dispatch_failed'.
|
|
500
|
+
// - 'transport_failure' -- the fleet tool call itself failed at the
|
|
501
|
+
// transport (e.g. the SSH channel to the member
|
|
502
|
+
// could not be opened) and the server reported
|
|
503
|
+
// it as a bare tool error, not a classified
|
|
504
|
+
// execute_prompt result (agent() in the
|
|
505
|
+
// workflow engine). No result envelope exists.
|
|
463
506
|
//
|
|
464
507
|
// For an integ-test-runner dispatch, all of these mean "no test verdict was
|
|
465
508
|
// ever produced" -- the run never reported pass or fail. Treating them as a
|
|
@@ -468,7 +511,7 @@ export function isAuthDispatchError(err) {
|
|
|
468
511
|
// check on an infra fault. Callers use this classifier to (a) retry once via a
|
|
469
512
|
// session resume and (b) failing that, record the cycle as INCONCLUSIVE rather
|
|
470
513
|
// than a test FAIL -- exactly as the part-2 stale-evidence path already does.
|
|
471
|
-
const INFRA_DISPATCH_REASONS = new Set(['empty_response', 'dispatch_failed', 'orphan_recovery_timeout', 'stalled', 'preflight_offline']);
|
|
514
|
+
const INFRA_DISPATCH_REASONS = new Set(['empty_response', 'dispatch_failed', 'orphan_recovery_timeout', 'stalled', 'agent_never_started', 'max_total_time', 'preflight_offline', 'transport_failure']);
|
|
472
515
|
|
|
473
516
|
/**
|
|
474
517
|
* True when a dispatch error is an INFRASTRUCTURE failure (the member CLI never
|
|
@@ -481,6 +524,86 @@ export function isInfraDispatchFailure(err) {
|
|
|
481
524
|
return INFRA_DISPATCH_REASONS.has(err?.details?.reason);
|
|
482
525
|
}
|
|
483
526
|
|
|
527
|
+
// ---------------------------------------------------------------------------
|
|
528
|
+
// apra-fleet-hzeb.4.1 -- usage-limit dispatch classification
|
|
529
|
+
// ---------------------------------------------------------------------------
|
|
530
|
+
//
|
|
531
|
+
// execute_prompt relays a provider's usage-limit signal (e.g. Claude's 429
|
|
532
|
+
// classified via detectUsageLimit) as a structured `details.reason ===
|
|
533
|
+
// 'usage_limit'` on the AgentDispatchError it throws (src/tools/execute-
|
|
534
|
+
// prompt.ts), mirroring the existing `details.reason` classifiers above
|
|
535
|
+
// (isInfraDispatchFailure, isNonRetryableDispatchError). This is the ONLY
|
|
536
|
+
// vocabulary a caller may key on -- NEVER regex on message text, since a
|
|
537
|
+
// usage-limit message is provider-specific prose that can drift or be
|
|
538
|
+
// localized (see isInfraDispatchFailure's own header for the same
|
|
539
|
+
// discipline).
|
|
540
|
+
export const USAGE_LIMIT_DISPATCH_REASON = 'usage_limit';
|
|
541
|
+
|
|
542
|
+
/**
|
|
543
|
+
* True when a dispatch error is a provider usage-limit hit, keyed off the
|
|
544
|
+
* server's structured `details.reason` -- never on message text.
|
|
545
|
+
* @param {unknown} err
|
|
546
|
+
* @returns {boolean}
|
|
547
|
+
*/
|
|
548
|
+
export function isUsageLimitDispatchError(err) {
|
|
549
|
+
return err?.details?.reason === USAGE_LIMIT_DISPATCH_REASON;
|
|
550
|
+
}
|
|
551
|
+
|
|
552
|
+
/**
|
|
553
|
+
* The provider's usage-limit signal object (see providers/provider.ts's
|
|
554
|
+
* UsageLimitSignal contract) carried on a usage-limit dispatch error, or
|
|
555
|
+
* `null` when the error carries none (e.g. it is not a usage-limit error at
|
|
556
|
+
* all, or a provider that classified the reason but supplied no signal
|
|
557
|
+
* detail).
|
|
558
|
+
* @param {unknown} err
|
|
559
|
+
* @returns {object|null}
|
|
560
|
+
*/
|
|
561
|
+
export function usageLimitOf(err) {
|
|
562
|
+
return err?.details?.usageLimit ?? null;
|
|
563
|
+
}
|
|
564
|
+
|
|
565
|
+
/**
|
|
566
|
+
* Thrown by the fleet-sprint usage-limit pause/resume controller
|
|
567
|
+
* (apra-fleet-hzeb.4.2, the follow-up to this task) when a dispatch has been
|
|
568
|
+
* paused and re-probed until its budget (USAGE_LIMIT_MAX_WAIT_S /
|
|
569
|
+
* USAGE_LIMIT_MAX_REPROBES in role-policies.mjs) is exhausted with no
|
|
570
|
+
* successful resume. Registered in isTypedAbortError() (abort.mjs) so a
|
|
571
|
+
* give-up routes through finalizeAbort() / an [ABORTED] PR, exactly like
|
|
572
|
+
* every other unrecoverable sprint-abort class in that curated list -- a
|
|
573
|
+
* member permanently rate-limited past every allowed wait/reprobe is exactly
|
|
574
|
+
* as terminal as a stalled sprint or an unmergeable divergence.
|
|
575
|
+
*
|
|
576
|
+
* @property {string|null} member - the member whose dispatch hit the usage limit
|
|
577
|
+
* @property {string|null} roleLabel - the role/label of the dispatch that was paused
|
|
578
|
+
* @property {number|null} firstHitAt - epoch ms of the first usage-limit hit
|
|
579
|
+
* @property {number|null} lastResumeAt - epoch ms of the provider's last reported resumeAt
|
|
580
|
+
* @property {number} reprobes - how many re-probe attempts were made before giving up
|
|
581
|
+
* @property {number} waitedMs - total wall-clock time spent paused across all reprobes
|
|
582
|
+
*/
|
|
583
|
+
export class UsageLimitWaitExhaustedError extends WorkflowError {
|
|
584
|
+
/**
|
|
585
|
+
* @param {string} message
|
|
586
|
+
* @param {{ member?: string|null, roleLabel?: string|null, firstHitAt?: number|null, lastResumeAt?: number|null, reprobes?: number, waitedMs?: number, details?: object, cause?: unknown }} [opts]
|
|
587
|
+
*/
|
|
588
|
+
constructor(message, opts = {}) {
|
|
589
|
+
const {
|
|
590
|
+
member = null, roleLabel = null, firstHitAt = null, lastResumeAt = null,
|
|
591
|
+
reprobes = 0, waitedMs = 0, details, cause,
|
|
592
|
+
} = opts;
|
|
593
|
+
super(message, {
|
|
594
|
+
code: 'USAGE_LIMIT_WAIT_EXHAUSTED',
|
|
595
|
+
details: { member, roleLabel, firstHitAt, lastResumeAt, reprobes, waitedMs, ...details },
|
|
596
|
+
cause,
|
|
597
|
+
});
|
|
598
|
+
this.member = member;
|
|
599
|
+
this.roleLabel = roleLabel;
|
|
600
|
+
this.firstHitAt = firstHitAt;
|
|
601
|
+
this.lastResumeAt = lastResumeAt;
|
|
602
|
+
this.reprobes = reprobes;
|
|
603
|
+
this.waitedMs = waitedMs;
|
|
604
|
+
}
|
|
605
|
+
}
|
|
606
|
+
|
|
484
607
|
// ---------------------------------------------------------------------------
|
|
485
608
|
// apra-fleet-eft.75.2 -- sprint-launch machine-local pidfile mutex
|
|
486
609
|
// ---------------------------------------------------------------------------
|
|
@@ -655,3 +778,346 @@ export class MemberReservationResumeError extends WorkflowError {
|
|
|
655
778
|
this.members = members;
|
|
656
779
|
}
|
|
657
780
|
}
|
|
781
|
+
|
|
782
|
+
// ---------------------------------------------------------------------------
|
|
783
|
+
// apra-fleet-3swo.4.9 -- sync-bracket mutual-exclusion violation
|
|
784
|
+
// ---------------------------------------------------------------------------
|
|
785
|
+
|
|
786
|
+
/**
|
|
787
|
+
* Thrown by git-sync.mjs's createSyncBrackets() when two brackets sharing the
|
|
788
|
+
* same `exclusiveKey` genuinely OVERLAP rather than nest -- i.e. the bracket
|
|
789
|
+
* that opened FIRST closes while a bracket that opened LATER (for the same
|
|
790
|
+
* key) is still open. Proper nesting (LIFO open/close for the same key) never
|
|
791
|
+
* throws this; only a crossing close does, which is precisely the shape a
|
|
792
|
+
* broken bracket pairing (or a regression in the external serialization gate
|
|
793
|
+
* that is supposed to keep code-writing dispatches sequential, e.g. runner.js
|
|
794
|
+
* 's `globalDoerTurn`) would produce. Every OTHER key stays fully
|
|
795
|
+
* independent: two brackets with different `exclusiveKey`s (or no key at all)
|
|
796
|
+
* may overlap in any order and never trigger this -- that is legitimate,
|
|
797
|
+
* relied-upon concurrency (e.g. multiple members' D-pushes serialized by
|
|
798
|
+
* their own dolt push mutex, not by this counter).
|
|
799
|
+
*
|
|
800
|
+
* @property {string} exclusiveKey - the shared key the two brackets collided on.
|
|
801
|
+
* @property {string} closingLabel - the bracket that was closing when the
|
|
802
|
+
* violation was detected.
|
|
803
|
+
* @property {string[]} stillOpenLabels - the other bracket(s) sharing this key
|
|
804
|
+
* that were still open at that moment.
|
|
805
|
+
*/
|
|
806
|
+
export class ConcurrentSyncBracketError extends WorkflowError {
|
|
807
|
+
/**
|
|
808
|
+
* @param {string} message
|
|
809
|
+
* @param {{ exclusiveKey: string, closingLabel: string, stillOpenLabels: string[], details?: object, cause?: unknown }} opts
|
|
810
|
+
*/
|
|
811
|
+
constructor(message, opts = {}) {
|
|
812
|
+
const { exclusiveKey, closingLabel, stillOpenLabels = [], details, cause } = opts;
|
|
813
|
+
super(message, {
|
|
814
|
+
code: 'CONCURRENT_SYNC_BRACKET',
|
|
815
|
+
details: { exclusiveKey, closingLabel, stillOpenLabels, ...details },
|
|
816
|
+
cause,
|
|
817
|
+
});
|
|
818
|
+
this.exclusiveKey = exclusiveKey;
|
|
819
|
+
this.closingLabel = closingLabel;
|
|
820
|
+
this.stillOpenLabels = stillOpenLabels;
|
|
821
|
+
}
|
|
822
|
+
}
|
|
823
|
+
|
|
824
|
+
// ---------------------------------------------------------------------------
|
|
825
|
+
// Pre-sprint validation refusals
|
|
826
|
+
// ---------------------------------------------------------------------------
|
|
827
|
+
//
|
|
828
|
+
// Every refusal raised by runSprintCycle's pre-sprint validation block, as a
|
|
829
|
+
// closed machine-readable vocabulary. Before this existed the block threw bare
|
|
830
|
+
// `Error`s whose only discriminator was their prose, so a caller could not
|
|
831
|
+
// tell "there is genuinely no ready work" (an operator-facing, often benign
|
|
832
|
+
// outcome) from "this backlog member's bd clone cannot see the target beads at
|
|
833
|
+
// all" (a sync fault) or "the scope is deadlocked" (a graph fault) without
|
|
834
|
+
// substring-matching a human-readable sentence.
|
|
835
|
+
//
|
|
836
|
+
// TARGET_NOT_VISIBLE One or more target issue ids are not present in the
|
|
837
|
+
// backlog member's own bd clone AT ALL. NOT the
|
|
838
|
+
// same as those beads being closed: they are invisible
|
|
839
|
+
// here, usually because they were created/mutated on a
|
|
840
|
+
// different clone that was never dolt-pushed to the
|
|
841
|
+
// shared remote. A SYNC fault, fixable by syncing.
|
|
842
|
+
// NOTHING_TO_DO The scope resolves to zero open/in-progress/blocked/
|
|
843
|
+
// deferred beads -- every target issue is genuinely
|
|
844
|
+
// done. Benign: there is no work, not a fault.
|
|
845
|
+
// CYCLE_REPAIR_FAILED The scope is deadlocked by parent-child + blocks
|
|
846
|
+
// cycle(s), the precise offending edges were computed,
|
|
847
|
+
// and the mechanical auto-repair (`bd dep remove`)
|
|
848
|
+
// ITSELF failed. Distinct from DEADLOCKED: the fix is
|
|
849
|
+
// known and was attempted, but could not be applied.
|
|
850
|
+
// DEADLOCKED Not-done beads remain in scope but none are ready,
|
|
851
|
+
// and the repairable cycle shape does not explain it.
|
|
852
|
+
// Needs a human to break the dependency deadlock.
|
|
853
|
+
//
|
|
854
|
+
// NOT in this vocabulary, deliberately: the VERIFY-ONLY sprint path. An empty
|
|
855
|
+
// ready set with implementation-complete beads routed to verify PROCEEDS, so
|
|
856
|
+
// it is not a refusal and must never raise. Nor is the stale-in-progress
|
|
857
|
+
// reclaim a refusal -- it runs BEFORE any of these are raised, precisely
|
|
858
|
+
// because an empty `--ready` set can be an artifact of an interrupted run
|
|
859
|
+
// rather than an absence of work.
|
|
860
|
+
export const PRE_SPRINT_REFUSAL_REASONS = Object.freeze({
|
|
861
|
+
TARGET_NOT_VISIBLE: 'TARGET_NOT_VISIBLE',
|
|
862
|
+
NOTHING_TO_DO: 'NOTHING_TO_DO',
|
|
863
|
+
CYCLE_REPAIR_FAILED: 'CYCLE_REPAIR_FAILED',
|
|
864
|
+
DEADLOCKED: 'DEADLOCKED',
|
|
865
|
+
// GitHub #717: a goal-priority bead is blocked only by verify-routed beads
|
|
866
|
+
// and the Integration Test phase cannot run (no integ-test-playbook.md or
|
|
867
|
+
// no deploy.md), so it can never become ready.
|
|
868
|
+
VERIFY_BLOCKED: 'VERIFY_BLOCKED',
|
|
869
|
+
});
|
|
870
|
+
|
|
871
|
+
/**
|
|
872
|
+
* Thrown when runSprintCycle's pre-sprint validation refuses to start a
|
|
873
|
+
* sprint. Adds a machine-readable `reason` discriminator (one of
|
|
874
|
+
* PRE_SPRINT_REFUSAL_REASONS) to what was previously an untyped `Error`
|
|
875
|
+
* distinguishable only by its prose.
|
|
876
|
+
*
|
|
877
|
+
* The human-readable message is deliberately UNCHANGED from the prose each
|
|
878
|
+
* refusal already emitted -- this adds a type and a discriminator, it does not
|
|
879
|
+
* restyle the operator-facing text.
|
|
880
|
+
*
|
|
881
|
+
* Like the other sprint-fatal errors here it is never caught inside the
|
|
882
|
+
* pre-sprint block, so it unwinds runWithContext()'s promise and fails the run
|
|
883
|
+
* before any dispatch occurs.
|
|
884
|
+
*
|
|
885
|
+
* @property {string} reason - one of PRE_SPRINT_REFUSAL_REASONS
|
|
886
|
+
* @property {string|null} scope - the sprint filter the refusal was raised for
|
|
887
|
+
* @property {string[]} [invisibleTargets] - TARGET_NOT_VISIBLE: the ids missing
|
|
888
|
+
* from the backlog member's clone
|
|
889
|
+
* @property {Array<{blockedIssue: string, blockedBy: string}>} [cyclePairs] -
|
|
890
|
+
* CYCLE_REPAIR_FAILED: the parent-child + blocks edge pairs whose removal
|
|
891
|
+
* was attempted
|
|
892
|
+
* @property {string[]} [deadlockedIds] - DEADLOCKED: the not-done bead ids that
|
|
893
|
+
* remain in scope with none ready
|
|
894
|
+
*/
|
|
895
|
+
export class PreSprintValidationError extends WorkflowError {
|
|
896
|
+
/**
|
|
897
|
+
* @param {string} message
|
|
898
|
+
* @param {{ reason: string, scope?: string|null, invisibleTargets?: string[], cyclePairs?: Array<{blockedIssue: string, blockedBy: string}>, deadlockedIds?: string[], details?: object, cause?: unknown }} opts
|
|
899
|
+
*/
|
|
900
|
+
constructor(message, opts = {}) {
|
|
901
|
+
const { reason, scope = null, invisibleTargets, cyclePairs, deadlockedIds, details, cause } = opts;
|
|
902
|
+
if (!Object.prototype.hasOwnProperty.call(PRE_SPRINT_REFUSAL_REASONS, String(reason))) {
|
|
903
|
+
// A refusal with no recognized discriminator is the exact failure
|
|
904
|
+
// this type exists to prevent, so it fails loudly at construction
|
|
905
|
+
// rather than shipping an untyped refusal wearing a typed name.
|
|
906
|
+
throw new TypeError(
|
|
907
|
+
`PreSprintValidationError requires a reason from PRE_SPRINT_REFUSAL_REASONS ` +
|
|
908
|
+
`(${Object.keys(PRE_SPRINT_REFUSAL_REASONS).join(', ')}); got ${JSON.stringify(reason)}`
|
|
909
|
+
);
|
|
910
|
+
}
|
|
911
|
+
super(message, {
|
|
912
|
+
code: 'PRE_SPRINT_VALIDATION',
|
|
913
|
+
details: { reason, scope, invisibleTargets, cyclePairs, deadlockedIds, ...details },
|
|
914
|
+
cause,
|
|
915
|
+
});
|
|
916
|
+
this.reason = reason;
|
|
917
|
+
this.scope = scope;
|
|
918
|
+
if (invisibleTargets) this.invisibleTargets = invisibleTargets;
|
|
919
|
+
if (cyclePairs) this.cyclePairs = cyclePairs;
|
|
920
|
+
if (deadlockedIds) this.deadlockedIds = deadlockedIds;
|
|
921
|
+
}
|
|
922
|
+
}
|
|
923
|
+
|
|
924
|
+
// ---------------------------------------------------------------------------
|
|
925
|
+
// Beads identity (which .beads a member's bd actually resolves to)
|
|
926
|
+
// ---------------------------------------------------------------------------
|
|
927
|
+
|
|
928
|
+
export const BEADS_IDENTITY_FAILURE_REASONS = Object.freeze({
|
|
929
|
+
MISMATCH: 'MISMATCH',
|
|
930
|
+
// The member cannot run bd at all (not installed / not on PATH): every
|
|
931
|
+
// bd a role or the engine runs there would fail mid-sprint, so refuse up
|
|
932
|
+
// front.
|
|
933
|
+
MISSING_TOOL: 'MISSING_TOOL',
|
|
934
|
+
// A beads-reading member had no usable beads database (or no
|
|
935
|
+
// sync.remote) and the preflight could not set one up from the sprint's
|
|
936
|
+
// expected beads remote -- dispatching would hand the role a database
|
|
937
|
+
// that does not hold the sprint's issues, so refuse up front.
|
|
938
|
+
BEADS_SETUP_FAILED: 'BEADS_SETUP_FAILED',
|
|
939
|
+
});
|
|
940
|
+
|
|
941
|
+
/**
|
|
942
|
+
* Thrown by verifyBeadsIdentity (beads-identity-check.mjs) BEFORE any
|
|
943
|
+
* mutating bd command when a member's probed identity (`bd where` / `bd
|
|
944
|
+
* config get sync.remote` / `git remote get-url origin`) DIFFERS from the
|
|
945
|
+
* expected one (the supervisor's expectation, or the backlog member's
|
|
946
|
+
* own identity) on a field that resolved on both sides (reason MISMATCH), or
|
|
947
|
+
* when a member cannot run bd at all -- a bd probe failed because bd is not
|
|
948
|
+
* installed or not on PATH (reason MISSING_TOOL), so every later bd command
|
|
949
|
+
* there would fail too, or (reason BEADS_SETUP_FAILED) when a beads-reading
|
|
950
|
+
* member had no database / no sync.remote and setting it up from the
|
|
951
|
+
* expected remote failed. Any other probe that fails or cannot be parsed is a
|
|
952
|
+
* logged warning, never this error.
|
|
953
|
+
*
|
|
954
|
+
* A WorkflowError so main()'s terminal record names the reason, but
|
|
955
|
+
* deliberately NOT a typed abort: nothing has been dispatched or mutated, so
|
|
956
|
+
* there is no partial work for finalizeAbort() to push or open a PR for.
|
|
957
|
+
*
|
|
958
|
+
* @property {string} reason - one of BEADS_IDENTITY_FAILURE_REASONS
|
|
959
|
+
* @property {string} member - the member whose identity mismatched
|
|
960
|
+
* @property {Array<{field: string, expected: string, actual: string}>} [mismatches]
|
|
961
|
+
*/
|
|
962
|
+
export class BeadsIdentityError extends WorkflowError {
|
|
963
|
+
/**
|
|
964
|
+
* @param {string} message
|
|
965
|
+
* @param {{ reason: string, member: string, mismatches?: Array<{field: string, expected: string, actual: string}>, details?: object, cause?: unknown }} opts
|
|
966
|
+
*/
|
|
967
|
+
constructor(message, opts = {}) {
|
|
968
|
+
const { reason, member, mismatches, details, cause } = opts;
|
|
969
|
+
if (!Object.prototype.hasOwnProperty.call(BEADS_IDENTITY_FAILURE_REASONS, String(reason))) {
|
|
970
|
+
throw new TypeError(
|
|
971
|
+
`BeadsIdentityError requires a reason from BEADS_IDENTITY_FAILURE_REASONS ` +
|
|
972
|
+
`(${Object.keys(BEADS_IDENTITY_FAILURE_REASONS).join(', ')}); got ${JSON.stringify(reason)}`
|
|
973
|
+
);
|
|
974
|
+
}
|
|
975
|
+
super(message, {
|
|
976
|
+
code: 'BEADS_IDENTITY',
|
|
977
|
+
details: { reason, member, mismatches, ...details },
|
|
978
|
+
cause,
|
|
979
|
+
});
|
|
980
|
+
this.reason = reason;
|
|
981
|
+
this.member = member;
|
|
982
|
+
if (mismatches) this.mismatches = mismatches;
|
|
983
|
+
}
|
|
984
|
+
}
|
|
985
|
+
|
|
986
|
+
// ---------------------------------------------------------------------------
|
|
987
|
+
// Member permission config (the provider's composed per-folder config)
|
|
988
|
+
// ---------------------------------------------------------------------------
|
|
989
|
+
|
|
990
|
+
/**
|
|
991
|
+
* Thrown by the member permission-config preflight
|
|
992
|
+
* (member-provisioning.mjs createPermissionConfigPreflight) BEFORE any
|
|
993
|
+
* dispatch when a dispatch member's composed per-folder permission config
|
|
994
|
+
* (its provider's permissionConfigPaths(), as reported by member_detail) is
|
|
995
|
+
* missing from its work folder -- a re-clone, `git clean -xdf` or fresh
|
|
996
|
+
* worktree drops it -- and re-composing it with compose_permissions failed or
|
|
997
|
+
* did not bring it back, or it could not be probed at all. Dispatching would
|
|
998
|
+
* hand the role a session whose tool calls (e.g. bd) are refused as
|
|
999
|
+
* "requires approval".
|
|
1000
|
+
*
|
|
1001
|
+
* Like BeadsIdentityError, a WorkflowError but deliberately NOT a typed
|
|
1002
|
+
* abort: nothing has been dispatched, so there is no partial work to push.
|
|
1003
|
+
*
|
|
1004
|
+
* @property {string} member - the member whose config is missing
|
|
1005
|
+
* @property {string[]} files - the missing (or unprobeable) config file(s)
|
|
1006
|
+
* @property {string} role - the compose_permissions role the fix names
|
|
1007
|
+
*/
|
|
1008
|
+
export class MemberPermissionConfigError extends WorkflowError {
|
|
1009
|
+
/**
|
|
1010
|
+
* @param {string} message
|
|
1011
|
+
* @param {{ member: string, files?: string[], role?: string, details?: object, cause?: unknown }} opts
|
|
1012
|
+
*/
|
|
1013
|
+
constructor(message, opts = {}) {
|
|
1014
|
+
const { member, files = [], role, details, cause } = opts;
|
|
1015
|
+
super(message, {
|
|
1016
|
+
code: 'MEMBER_PERMISSION_CONFIG',
|
|
1017
|
+
details: { member, files, role, ...details },
|
|
1018
|
+
cause,
|
|
1019
|
+
});
|
|
1020
|
+
this.member = member;
|
|
1021
|
+
this.files = files;
|
|
1022
|
+
this.role = role;
|
|
1023
|
+
}
|
|
1024
|
+
}
|
|
1025
|
+
|
|
1026
|
+
// ---------------------------------------------------------------------------
|
|
1027
|
+
// Agent permission refusals during a dispatch (reason 'permission_denied')
|
|
1028
|
+
// ---------------------------------------------------------------------------
|
|
1029
|
+
//
|
|
1030
|
+
// execute_prompt reports a dispatch whose member CLI refused tool calls for
|
|
1031
|
+
// lack of a grant as a structured `reason: 'permission_denied'` with a
|
|
1032
|
+
// `permissionDenied` block ({ actions, denials, suggestedGrants, hint,
|
|
1033
|
+
// signals }); the workflow layer forwards both onto AgentDispatchError.details.
|
|
1034
|
+
// It is a MISSING-PERMISSION failure, healed by compose_permissions -- never a
|
|
1035
|
+
// role outcome. In particular the refusal text must never be fed to a caller
|
|
1036
|
+
// as a plan-review/review verdict. Keyed on the structured reason only, like
|
|
1037
|
+
// isUsageLimitDispatchError: never on the provider's prose.
|
|
1038
|
+
export const PERMISSION_DENIED_DISPATCH_REASON = 'permission_denied';
|
|
1039
|
+
|
|
1040
|
+
/**
|
|
1041
|
+
* True when a dispatch error is an agent permission refusal.
|
|
1042
|
+
* @param {unknown} err
|
|
1043
|
+
* @returns {boolean}
|
|
1044
|
+
*/
|
|
1045
|
+
export function isPermissionDeniedDispatchError(err) {
|
|
1046
|
+
return err?.details?.reason === PERMISSION_DENIED_DISPATCH_REASON;
|
|
1047
|
+
}
|
|
1048
|
+
|
|
1049
|
+
/**
|
|
1050
|
+
* The permissionDenied block carried on a permission-refusal dispatch error,
|
|
1051
|
+
* normalised to `{ actions: string[], denials: {action, target?,
|
|
1052
|
+
* suggestedGrants?}[], suggestedGrants: string[], hint: string,
|
|
1053
|
+
* permissionMode?: string, healable?: boolean }`, or null when the error
|
|
1054
|
+
* carries none. `healable: false` means the session's permission mode (Claude
|
|
1055
|
+
* auto/bypass) makes the refusal a classifier or deny-rule decision that no
|
|
1056
|
+
* grant may ever override.
|
|
1057
|
+
* @param {unknown} err
|
|
1058
|
+
* @returns {{actions: string[], denials: Array<{action: string, target?: string, suggestedGrants?: string[]}>, suggestedGrants: string[], hint: string, permissionMode?: string, healable?: boolean}|null}
|
|
1059
|
+
*/
|
|
1060
|
+
export function permissionDeniedOf(err) {
|
|
1061
|
+
const d = err?.details?.permissionDenied;
|
|
1062
|
+
if (!d || typeof d !== 'object') return null;
|
|
1063
|
+
const strings = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === 'string') : []);
|
|
1064
|
+
const denials = Array.isArray(d.denials)
|
|
1065
|
+
? d.denials.filter((x) => x && typeof x.action === 'string')
|
|
1066
|
+
.map((x) => ({
|
|
1067
|
+
action: x.action,
|
|
1068
|
+
...(typeof x.target === 'string' ? { target: x.target } : {}),
|
|
1069
|
+
...(Array.isArray(x.suggestedGrants) ? { suggestedGrants: strings(x.suggestedGrants) } : {}),
|
|
1070
|
+
}))
|
|
1071
|
+
: [];
|
|
1072
|
+
return {
|
|
1073
|
+
actions: strings(d.actions),
|
|
1074
|
+
denials,
|
|
1075
|
+
suggestedGrants: strings(d.suggestedGrants),
|
|
1076
|
+
hint: typeof d.hint === 'string' ? d.hint : '',
|
|
1077
|
+
...(typeof d.permissionMode === 'string' ? { permissionMode: d.permissionMode } : {}),
|
|
1078
|
+
...(typeof d.healable === 'boolean' ? { healable: d.healable } : {}),
|
|
1079
|
+
};
|
|
1080
|
+
}
|
|
1081
|
+
|
|
1082
|
+
/**
|
|
1083
|
+
* Thrown by the dispatch engine (dispatch-role.mjs) when a role's dispatch
|
|
1084
|
+
* was refused tool calls and the progressive heal (createPermissionDenialHeal:
|
|
1085
|
+
* grant within the member's composed policy, retry, repeat while each heal
|
|
1086
|
+
* adds a new grant) can make no further progress. Ends the sprint naming the
|
|
1087
|
+
* member, the denied actions and the fix; no plan-review or review round is
|
|
1088
|
+
* ever charged for it.
|
|
1089
|
+
*
|
|
1090
|
+
* A WorkflowError (so the run records a terminal reason) but deliberately
|
|
1091
|
+
* NOT a typed abort, like MemberPermissionConfigError: the fix is a member
|
|
1092
|
+
* grant, after which the sprint is simply re-run.
|
|
1093
|
+
*
|
|
1094
|
+
* @property {string} member - the member whose tool calls were refused
|
|
1095
|
+
* @property {string|null} role - the sprint role whose dispatch was refused
|
|
1096
|
+
* @property {string[]} actions - the denied actions (e.g. 'Bash "bd show x"')
|
|
1097
|
+
* @property {string[]} suggestedGrants - compose_permissions grants that would allow them
|
|
1098
|
+
* @property {string[]} rejectedGrants - suggested grants outside the role policy, never auto-added
|
|
1099
|
+
* @property {string} step - 'heal' (compose_permissions failed or no heal is wired),
|
|
1100
|
+
* 'not_healable' (auto/bypass-mode refusal: classifier or deny rule, never granted),
|
|
1101
|
+
* 'no_progress' (refused again after its grant, outside policy, NEVER_AUTO_GRANT, or no
|
|
1102
|
+
* grant maps to the call) or 'cap' (heal limit per member per sprint or per ladder reached)
|
|
1103
|
+
*/
|
|
1104
|
+
export class MemberPermissionDeniedError extends WorkflowError {
|
|
1105
|
+
/**
|
|
1106
|
+
* @param {string} message
|
|
1107
|
+
* @param {{ member: string, role?: string|null, actions?: string[], suggestedGrants?: string[], rejectedGrants?: string[], step: string, details?: object, cause?: unknown }} opts
|
|
1108
|
+
*/
|
|
1109
|
+
constructor(message, opts = {}) {
|
|
1110
|
+
const { member, role = null, actions = [], suggestedGrants = [], rejectedGrants = [], step, details, cause } = opts;
|
|
1111
|
+
super(message, {
|
|
1112
|
+
code: 'MEMBER_PERMISSION_DENIED',
|
|
1113
|
+
details: { member, role, actions, suggestedGrants, rejectedGrants, step, ...details },
|
|
1114
|
+
cause,
|
|
1115
|
+
});
|
|
1116
|
+
this.member = member;
|
|
1117
|
+
this.role = role;
|
|
1118
|
+
this.actions = actions;
|
|
1119
|
+
this.suggestedGrants = suggestedGrants;
|
|
1120
|
+
this.rejectedGrants = rejectedGrants;
|
|
1121
|
+
this.step = step;
|
|
1122
|
+
}
|
|
1123
|
+
}
|