@apralabs/apra-fleet 0.4.3 → 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 +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- 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/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 +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- 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 +24 -1
- package/dist/cli/config.js +69 -2
- 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 +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- 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.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- 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 +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- 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 +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- 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 +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- 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 +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- 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-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- 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/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 +54 -8
- 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/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 +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- 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 +229 -38
- 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 +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- 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 +86 -17
- 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 +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- 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 +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- 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 +53 -5
- package/dist/tools/check-status.js +210 -53
- 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 +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- 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 +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- 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 +169 -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 +30 -10
- 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 +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- 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 +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- 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/shutdown-server.js +5 -0
- 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 +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -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 +106 -20
- 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 +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- 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/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/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- 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/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 +3 -3
- 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 +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- 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 +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -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 +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- 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 +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- 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/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.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/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.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-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.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/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.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/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.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/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.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/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.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
|
@@ -0,0 +1,270 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Per-dispatch kb_* / code_* tool call accounting from session_stats snapshots.
|
|
3
|
+
//
|
|
4
|
+
// The member's agent makes its kb_* and code_* calls against the fleet server
|
|
5
|
+
// its own MCP config points at -- for a remote member that is the member's OWN
|
|
6
|
+
// server, which the engine cannot observe. That server counts those calls per
|
|
7
|
+
// member (session_stats). So the engine reads session_stats AS the member
|
|
8
|
+
// (memberCall: a local in-process member session, or `apra-fleet call` on a
|
|
9
|
+
// remote member -- both are engine-origin sessions, whose own calls the server
|
|
10
|
+
// does not count) immediately before and immediately after each dispatch, and
|
|
11
|
+
// records the difference as that dispatch's calls.
|
|
12
|
+
//
|
|
13
|
+
// HONESTY RULE: a count is either a number read from two good snapshots or the
|
|
14
|
+
// string 'unknown' -- never a fabricated 0. Any of these yields 'unknown' for
|
|
15
|
+
// the dispatch (with a reason): no member session available, no member record
|
|
16
|
+
// for the dispatched member name, a failed or unparseable read, a changed
|
|
17
|
+
// `since` between the two snapshots (the member's server restarted mid-
|
|
18
|
+
// dispatch, so the counters were reset), or a negative difference.
|
|
19
|
+
//
|
|
20
|
+
// Accounting is best-effort and never fails or delays a dispatch beyond the
|
|
21
|
+
// bounded snapshot reads: every error is logged and recorded as 'unknown'.
|
|
22
|
+
//
|
|
23
|
+
// Records are appended to a caller-supplied array (the sprint state's
|
|
24
|
+
// dispatchToolCalls list) and optionally published to the viewer under
|
|
25
|
+
// DISPATCH_TOOL_CALLS_STATE_NAMESPACE.
|
|
26
|
+
// =============================================================================
|
|
27
|
+
|
|
28
|
+
/** The value recorded for a count the engine could not establish. */
|
|
29
|
+
export const UNKNOWN_COUNT = 'unknown';
|
|
30
|
+
|
|
31
|
+
/** publishState namespace for the per-dispatch records (viewer tab). */
|
|
32
|
+
export const DISPATCH_TOOL_CALLS_STATE_NAMESPACE = 'dispatch-tool-calls';
|
|
33
|
+
|
|
34
|
+
/** Default bound on one session_stats read. */
|
|
35
|
+
export const SNAPSHOT_READ_TIMEOUT_MS = 60_000;
|
|
36
|
+
|
|
37
|
+
function isCount(n) {
|
|
38
|
+
return typeof n === 'number' && Number.isInteger(n) && n >= 0;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Extract a session_stats snapshot { since, kb, code } from a tool result
|
|
43
|
+
* (MCP { content: [{ text }] } or an already-parsed object). Returns null for
|
|
44
|
+
* anything that is not a well-formed snapshot.
|
|
45
|
+
*/
|
|
46
|
+
export function parseSessionStats(result) {
|
|
47
|
+
let obj = result;
|
|
48
|
+
if (obj && Array.isArray(obj.content)) {
|
|
49
|
+
if (obj.isError) return null;
|
|
50
|
+
const text = obj.content.map((c) => (c && typeof c.text === 'string' ? c.text : '')).join('');
|
|
51
|
+
try { obj = JSON.parse(text); } catch { return null; }
|
|
52
|
+
}
|
|
53
|
+
if (!obj || typeof obj !== 'object') return null;
|
|
54
|
+
if (typeof obj.since !== 'string' || !isCount(obj.kb) || !isCount(obj.code)) return null;
|
|
55
|
+
return { since: obj.since, kb: obj.kb, code: obj.code };
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* The per-dispatch counts from a before/after pair of parsed snapshots (either
|
|
60
|
+
* may be null). Returns { kb, code, reason } where kb/code are numbers or
|
|
61
|
+
* UNKNOWN_COUNT and reason explains an unknown (null otherwise).
|
|
62
|
+
*/
|
|
63
|
+
export function snapshotDelta(before, after) {
|
|
64
|
+
if (!before || !after) {
|
|
65
|
+
return { kb: UNKNOWN_COUNT, code: UNKNOWN_COUNT, reason: !before ? 'before-snapshot read failed' : 'after-snapshot read failed' };
|
|
66
|
+
}
|
|
67
|
+
if (before.since !== after.since) {
|
|
68
|
+
return { kb: UNKNOWN_COUNT, code: UNKNOWN_COUNT, reason: 'member server restarted during the dispatch (counters reset)' };
|
|
69
|
+
}
|
|
70
|
+
const kb = after.kb - before.kb;
|
|
71
|
+
const code = after.code - before.code;
|
|
72
|
+
if (kb < 0 || code < 0) {
|
|
73
|
+
return { kb: UNKNOWN_COUNT, code: UNKNOWN_COUNT, reason: 'counters went backwards' };
|
|
74
|
+
}
|
|
75
|
+
return { kb, code, reason: null };
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* The reason text for a count that is unknown because the member's own tools
|
|
80
|
+
* were unavailable at sprint init: "member tools unavailable: <reason>" plus
|
|
81
|
+
* the short cause the init record carries (problem detail), when known.
|
|
82
|
+
* Returns null when the init record is absent or the member was verified.
|
|
83
|
+
*
|
|
84
|
+
* @param {{verified?: boolean, reason?: string|null, problems?: Array<{reason?: string, detail?: string}>}|null|undefined} init
|
|
85
|
+
* @returns {string|null}
|
|
86
|
+
*/
|
|
87
|
+
export function memberToolsReason(init) {
|
|
88
|
+
if (!init || typeof init !== 'object' || init.verified === true) return null;
|
|
89
|
+
const reason = init.reason ? String(init.reason) : 'unverified';
|
|
90
|
+
const p = Array.isArray(init.problems) ? init.problems.find((x) => x && x.reason === init.reason && x.detail) : null;
|
|
91
|
+
const cause = p ? String(p.detail).replace(/\s+/g, ' ').trim().slice(0, 120) : '';
|
|
92
|
+
return `member tools unavailable: ${reason}${cause ? ` -- ${cause}` : ''}`;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Format one count for text output: a number, or the literal 'unknown'. */
|
|
96
|
+
export function formatCount(n) {
|
|
97
|
+
return isCount(n) ? String(n) : UNKNOWN_COUNT;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* Per-member totals over a list of dispatch records. A member's total for a
|
|
102
|
+
* kind is a number only when every one of its dispatches has a number for
|
|
103
|
+
* that kind; otherwise it is UNKNOWN_COUNT (with the unknown dispatch count).
|
|
104
|
+
*/
|
|
105
|
+
export function memberTotals(records) {
|
|
106
|
+
const out = [];
|
|
107
|
+
const byMember = new Map();
|
|
108
|
+
for (const r of Array.isArray(records) ? records : []) {
|
|
109
|
+
if (!r || typeof r !== 'object') continue;
|
|
110
|
+
const name = String(r.member || '(unknown member)');
|
|
111
|
+
let t = byMember.get(name);
|
|
112
|
+
if (!t) {
|
|
113
|
+
t = { member: name, dispatches: 0, kb: 0, code: 0, unknownDispatches: 0, unknownReason: null };
|
|
114
|
+
byMember.set(name, t);
|
|
115
|
+
out.push(t);
|
|
116
|
+
}
|
|
117
|
+
t.dispatches++;
|
|
118
|
+
if (!isCount(r.kb) || !isCount(r.code)) {
|
|
119
|
+
t.unknownDispatches++;
|
|
120
|
+
if (!t.unknownReason && r.reason) t.unknownReason = String(r.reason);
|
|
121
|
+
}
|
|
122
|
+
t.kb = isCount(t.kb) && isCount(r.kb) ? t.kb + r.kb : UNKNOWN_COUNT;
|
|
123
|
+
t.code = isCount(t.code) && isCount(r.code) ? t.code + r.code : UNKNOWN_COUNT;
|
|
124
|
+
}
|
|
125
|
+
return out;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* Create the accounting helper.
|
|
130
|
+
*
|
|
131
|
+
* @param {object} deps
|
|
132
|
+
* @param {(member: object, tool: string, args: object) => Promise<object>} [deps.memberCall]
|
|
133
|
+
* the engine's memberCall (MEMBER-scoped, engine-origin); absent means
|
|
134
|
+
* every dispatch records 'unknown'.
|
|
135
|
+
* @param {(memberName: string) => object|null} [deps.getMemberInit]
|
|
136
|
+
* the member-init record for a member NAME (verified, reason, problems);
|
|
137
|
+
* an unknown count caused by a failed snapshot read or a missing member
|
|
138
|
+
* session then carries the member-tools reason instead of the bare read
|
|
139
|
+
* failure. Other unknowns (restart, counters backwards) keep their own.
|
|
140
|
+
* @param {(memberName: string) => object|null} [deps.memberOf]
|
|
141
|
+
* resolves a dispatched member NAME to its member record ({id, name, type}).
|
|
142
|
+
* @param {object[]} [deps.store] array records are appended to (sprint state).
|
|
143
|
+
* @param {(ns: string, payload: object) => void} [deps.publishState]
|
|
144
|
+
* @param {Function} [deps.log]
|
|
145
|
+
* @param {number} [deps.readTimeoutMs]
|
|
146
|
+
* @param {() => string} [deps.now] ISO timestamp source (tests).
|
|
147
|
+
*/
|
|
148
|
+
export function createDispatchAccounting(deps = {}) {
|
|
149
|
+
const {
|
|
150
|
+
memberCall,
|
|
151
|
+
memberOf,
|
|
152
|
+
getMemberInit,
|
|
153
|
+
publishState,
|
|
154
|
+
log = () => {},
|
|
155
|
+
readTimeoutMs = SNAPSHOT_READ_TIMEOUT_MS,
|
|
156
|
+
now = () => new Date().toISOString(),
|
|
157
|
+
} = deps;
|
|
158
|
+
const store = Array.isArray(deps.store) ? deps.store : [];
|
|
159
|
+
let seq = 0;
|
|
160
|
+
|
|
161
|
+
function publish() {
|
|
162
|
+
if (typeof publishState !== 'function') return;
|
|
163
|
+
try {
|
|
164
|
+
publishState(DISPATCH_TOOL_CALLS_STATE_NAMESPACE, { dispatches: store.slice() });
|
|
165
|
+
} catch (err) {
|
|
166
|
+
log(`[dispatch-accounting] could not publish dispatch tool-call records (non-fatal): ${err && err.message || err}`);
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
function withTimeout(promise) {
|
|
171
|
+
let timer;
|
|
172
|
+
return Promise.race([
|
|
173
|
+
promise,
|
|
174
|
+
new Promise((_, reject) => {
|
|
175
|
+
timer = setTimeout(() => reject(new Error(`session_stats read timed out after ${readTimeoutMs}ms`)), readTimeoutMs);
|
|
176
|
+
}),
|
|
177
|
+
]).finally(() => clearTimeout(timer));
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/** One snapshot read; null on any failure (logged). */
|
|
181
|
+
async function readSnapshot(record, memberName, which) {
|
|
182
|
+
try {
|
|
183
|
+
const res = await withTimeout(Promise.resolve().then(() => memberCall(record, 'session_stats', {})));
|
|
184
|
+
const snap = parseSessionStats(res);
|
|
185
|
+
if (!snap) log(`[dispatch-accounting] ${which} session_stats for member '${memberName}' was unparseable; counts for this dispatch are unknown.`);
|
|
186
|
+
return snap;
|
|
187
|
+
} catch (err) {
|
|
188
|
+
log(`[dispatch-accounting] ${which} session_stats read for member '${memberName}' failed (counts for this dispatch are unknown): ${err && err.message || err}`);
|
|
189
|
+
return null;
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
function resolveRecord(memberName) {
|
|
194
|
+
try {
|
|
195
|
+
return typeof memberOf === 'function' ? memberOf(memberName) : null;
|
|
196
|
+
} catch {
|
|
197
|
+
return null;
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
return {
|
|
202
|
+
/** The records so far (a copy). */
|
|
203
|
+
records() {
|
|
204
|
+
return store.slice();
|
|
205
|
+
},
|
|
206
|
+
/**
|
|
207
|
+
* Run `fn` (one dispatch to `memberName`) between two session_stats
|
|
208
|
+
* snapshots and record the per-dispatch counts. `fn`'s result or
|
|
209
|
+
* error passes through unchanged.
|
|
210
|
+
*/
|
|
211
|
+
async around({ memberName, role, label } = {}, fn) {
|
|
212
|
+
const index = ++seq;
|
|
213
|
+
const startedAt = now();
|
|
214
|
+
const record = memberName ? resolveRecord(memberName) : null;
|
|
215
|
+
let skipReason = null;
|
|
216
|
+
if (!memberName) skipReason = 'dispatch named no member';
|
|
217
|
+
else if (typeof memberCall !== 'function') skipReason = 'no member session available to read session_stats';
|
|
218
|
+
else if (!record || !(record.id || record.member_id)) skipReason = `no member record for '${memberName}'`;
|
|
219
|
+
const before = skipReason ? null : await readSnapshot(record, memberName, 'before');
|
|
220
|
+
try {
|
|
221
|
+
return await fn();
|
|
222
|
+
} finally {
|
|
223
|
+
const after = skipReason ? null : await readSnapshot(record, memberName, 'after');
|
|
224
|
+
const delta = skipReason
|
|
225
|
+
? { kb: UNKNOWN_COUNT, code: UNKNOWN_COUNT, reason: skipReason }
|
|
226
|
+
: snapshotDelta(before, after);
|
|
227
|
+
if (delta.reason && (skipReason || /snapshot read failed$/.test(delta.reason)) && memberName && typeof getMemberInit === 'function') {
|
|
228
|
+
let toolsReason = null;
|
|
229
|
+
try { toolsReason = memberToolsReason(getMemberInit(memberName)); } catch { /* informational only */ }
|
|
230
|
+
if (toolsReason) delta.reason = toolsReason;
|
|
231
|
+
}
|
|
232
|
+
store.push({
|
|
233
|
+
index,
|
|
234
|
+
member: memberName ? String(memberName) : '(unknown member)',
|
|
235
|
+
role: role ? String(role) : null,
|
|
236
|
+
label: label ? String(label) : null,
|
|
237
|
+
startedAt,
|
|
238
|
+
endedAt: now(),
|
|
239
|
+
kb: delta.kb,
|
|
240
|
+
code: delta.code,
|
|
241
|
+
reason: delta.reason,
|
|
242
|
+
});
|
|
243
|
+
publish();
|
|
244
|
+
}
|
|
245
|
+
},
|
|
246
|
+
};
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
/**
|
|
250
|
+
* Text lines for the sprint summary: calls per member per dispatch, then
|
|
251
|
+
* per-member totals. Pure. 'unknown' is printed as unknown, never 0.
|
|
252
|
+
*/
|
|
253
|
+
export function formatDispatchToolCalls(records) {
|
|
254
|
+
const list = (Array.isArray(records) ? records : []).filter((r) => r && typeof r === 'object');
|
|
255
|
+
if (list.length === 0) return ['No member dispatch was recorded this sprint.'];
|
|
256
|
+
const lines = [];
|
|
257
|
+
for (const r of list) {
|
|
258
|
+
const who = r.role ? `${r.role} on member '${r.member}'` : `member '${r.member}'`;
|
|
259
|
+
const label = r.label ? ` [${r.label}]` : '';
|
|
260
|
+
const why = (!isCount(r.kb) || !isCount(r.code)) && r.reason ? ` (unknown: ${r.reason})` : '';
|
|
261
|
+
lines.push(`- Dispatch ${r.index}: ${who}${label} -- kb_* calls: ${formatCount(r.kb)}, code_* calls: ${formatCount(r.code)}${why}.`);
|
|
262
|
+
}
|
|
263
|
+
lines.push('');
|
|
264
|
+
lines.push('Per-member totals:');
|
|
265
|
+
for (const t of memberTotals(list)) {
|
|
266
|
+
const unknown = t.unknownDispatches > 0 ? ` (${t.unknownDispatches} dispatch(es) with unknown counts)${t.unknownReason ? ` (unknown: ${t.unknownReason})` : ''}` : '';
|
|
267
|
+
lines.push(`- member '${t.member}': ${t.dispatches} dispatch(es), kb_* calls: ${formatCount(t.kb)}, code_* calls: ${formatCount(t.code)}${unknown}.`);
|
|
268
|
+
}
|
|
269
|
+
return lines;
|
|
270
|
+
}
|
|
@@ -57,7 +57,21 @@ export function isTerminalSprintFailure(err) {
|
|
|
57
57
|
// alive-but-silent, so the turn may have run to completion (a stalled
|
|
58
58
|
// planner can have created the whole DAG) with only the RESULT lost. The
|
|
59
59
|
// watchdog abandons the dispatch promise, not the member's work.
|
|
60
|
-
|
|
60
|
+
// - 'max_total_time': the server stopped a dispatch that had been running
|
|
61
|
+
// until its max_total_s ceiling -- the prompt was delivered and the agent
|
|
62
|
+
// worked for the whole budget, so partial work may exist. EXCEPT when the
|
|
63
|
+
// server marked it dispatched:false (details.dispatched === false): the
|
|
64
|
+
// budget ran out during setup, before anything was sent, so nothing ran.
|
|
65
|
+
// - 'permission_denied': the agent ran its turn and some of its tool calls
|
|
66
|
+
// were refused for lack of a grant (the dispatch engine heals it via
|
|
67
|
+
// compose_permissions). Calls it WAS allowed may have committed work.
|
|
68
|
+
// ('agent_never_started' is deliberately NOT here: the member process never
|
|
69
|
+
// produced a session, so nothing ran and nothing was mutated.)
|
|
70
|
+
const AGENT_RAN_DISPATCH_REASONS = new Set(['max_turns_exhausted', 'watchdog_timeout', 'max_total_time', 'permission_denied']);
|
|
71
|
+
|
|
72
|
+
function agentRan(details) {
|
|
73
|
+
return AGENT_RAN_DISPATCH_REASONS.has(details.reason) && details.dispatched !== false;
|
|
74
|
+
}
|
|
61
75
|
|
|
62
76
|
// True when a thrown dispatch error means the dispatch delivered no usable
|
|
63
77
|
// result and therefore produced no code/beads mutation to publish: a failed
|
|
@@ -85,10 +99,16 @@ const AGENT_RAN_DISPATCH_REASONS = new Set(['max_turns_exhausted', 'watchdog_tim
|
|
|
85
99
|
// command() throw it from inside the dispatch closure BEFORE any dispatch
|
|
86
100
|
// is issued (packages/apra-fleet-workflow/src/workflow/errors.mjs), so it
|
|
87
101
|
// alone provably mutated nothing.
|
|
102
|
+
//
|
|
103
|
+
// NOT a guarantee the member checkout is untouched: a transport drop can sever
|
|
104
|
+
// the channel while the member keeps working. The doer retry ladder therefore
|
|
105
|
+
// does not trust this predicate for its reset-onto-remote-tip decision; that
|
|
106
|
+
// reset salvages local work to a fleet-salvage/ side ref first (see the comment
|
|
107
|
+
// at retryFollowsPossibleMutation in dispatch-role.mjs).
|
|
88
108
|
export function isNoMutationDispatchFailure(err) {
|
|
89
109
|
if (!err) return false;
|
|
90
110
|
if (err instanceof AgentOutputError) return false;
|
|
91
|
-
if (err instanceof AgentDispatchError && err.details &&
|
|
111
|
+
if (err instanceof AgentDispatchError && err.details && agentRan(err.details)) {
|
|
92
112
|
return false;
|
|
93
113
|
}
|
|
94
114
|
return err instanceof AgentDispatchError || err instanceof FleetTransportError || err instanceof BudgetExceededError;
|
|
@@ -6,6 +6,9 @@ import {
|
|
|
6
6
|
isInfraDispatchFailure,
|
|
7
7
|
isUsageLimitDispatchError,
|
|
8
8
|
usageLimitOf,
|
|
9
|
+
isPermissionDeniedDispatchError,
|
|
10
|
+
permissionDeniedOf,
|
|
11
|
+
MemberPermissionDeniedError,
|
|
9
12
|
} from './errors.mjs';
|
|
10
13
|
import { AgentOutputError, AgentDispatchError, FleetTransportError, WorkflowError } from '@apralabs/apra-fleet-workflow';
|
|
11
14
|
|
|
@@ -71,14 +74,14 @@ const PLAN_REVIEWER_MAX_TURNS = 500;
|
|
|
71
74
|
const SCOPED_REPLAN_PLANNER_MAX_TURNS = 500;
|
|
72
75
|
/** Scoped replan plan-reviewer turn base. */
|
|
73
76
|
const SCOPED_REPLAN_REVIEWER_MAX_TURNS = 500;
|
|
74
|
-
/** Harvester turn base: it writes docs
|
|
77
|
+
/** Harvester turn base: it writes docs across the whole epic. */
|
|
75
78
|
const HARVESTER_MAX_TURNS = 500;
|
|
76
79
|
/** Deployer turn base: it runs real deploy commands per a runbook. */
|
|
77
80
|
const DEPLOYER_MAX_TURNS = 500;
|
|
78
81
|
/**
|
|
79
|
-
* Regression turn base:
|
|
80
|
-
*
|
|
81
|
-
*
|
|
82
|
+
* Regression turn base: one dispatch runs the target's whole regression
|
|
83
|
+
* playbook, which can poll a long-running suite (roughly one turn per
|
|
84
|
+
* liveness poll) for the better part of an hour.
|
|
82
85
|
*/
|
|
83
86
|
const REGRESSION_TEST_MAX_TURNS = 500;
|
|
84
87
|
/**
|
|
@@ -223,9 +226,21 @@ function turnBaseValue(name) {
|
|
|
223
226
|
return base;
|
|
224
227
|
}
|
|
225
228
|
|
|
229
|
+
/** The session id a failed dispatch's error reports, or null. */
|
|
230
|
+
function sessionIdOfError(err) {
|
|
231
|
+
const id = err && err.details && err.details.sessionId;
|
|
232
|
+
return typeof id === 'string' && id ? id : null;
|
|
233
|
+
}
|
|
234
|
+
|
|
226
235
|
/**
|
|
227
236
|
* The resume argument, resolved from `policy.resumeArg`:
|
|
228
|
-
* 'same-session' --
|
|
237
|
+
* 'same-session' -- opts.resumeSessionId, the EXPLICIT id of the session just
|
|
238
|
+
* run (the failed dispatch's err.details.sessionId). NEVER
|
|
239
|
+
* `true`: the server resolves `true` to the member's last
|
|
240
|
+
* SUCCESSFUL session, which on a member shared by several
|
|
241
|
+
* roles can be a reviewer's or planner's session. With no id
|
|
242
|
+
* it yields false (the caller starts a fresh full-prompt
|
|
243
|
+
* session instead of resuming)
|
|
229
244
|
* 'fresh-session' -- false (a self-contained one-off instruction)
|
|
230
245
|
* 'round-session' -- opts.resumeArg, the runner's per-round session lookup
|
|
231
246
|
* 'worklist' -- opts.resumeArg, the doer's per-worklist resume argument
|
|
@@ -244,7 +259,9 @@ function turnBaseValue(name) {
|
|
|
244
259
|
*/
|
|
245
260
|
export function resolveResumeArg(resumeArg, opts) {
|
|
246
261
|
if (!resumeArg) return false;
|
|
247
|
-
if (resumeArg.kind === 'same-session')
|
|
262
|
+
if (resumeArg.kind === 'same-session') {
|
|
263
|
+
return typeof opts.resumeSessionId === 'string' && opts.resumeSessionId ? opts.resumeSessionId : false;
|
|
264
|
+
}
|
|
248
265
|
if (resumeArg.kind === 'fresh-session') return false;
|
|
249
266
|
// A runner-supplied argument: already `false` or an explicit session id at
|
|
250
267
|
// every call site today. `?? false` keeps the never-undefined guarantee if
|
|
@@ -556,9 +573,16 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
556
573
|
// In-bracket pre-dispatch steps, then the caller's own preparation.
|
|
557
574
|
const inBracket = await runPreDispatchSteps(ctx, dispatch, member, opts, extra, 'in-bracket');
|
|
558
575
|
if (inBracket) return inBracket.value;
|
|
559
|
-
const prepared = opts.prepare ? await opts.prepare({ dispatch, ...extra }) : {};
|
|
576
|
+
const prepared = opts.prepare ? { ...(await opts.prepare({ dispatch, ...extra })) } : {};
|
|
577
|
+
// A fresh-session fallback (no explicit session id to resume) must
|
|
578
|
+
// never carry a resume argument, whatever prepare offered.
|
|
579
|
+
if (extra.freshSession) prepared.resumeArg = false;
|
|
560
580
|
const localBindings = { ...bindingsFor(extra.resumeAttempt || 0), ...(prepared.bindings || {}) };
|
|
561
|
-
const localOpts =
|
|
581
|
+
const localOpts = {
|
|
582
|
+
...opts,
|
|
583
|
+
...(prepared.resumeArg !== undefined ? { resumeArg: prepared.resumeArg } : {}),
|
|
584
|
+
resumeSessionId: extra.resumeSessionId || null,
|
|
585
|
+
};
|
|
562
586
|
const options = {
|
|
563
587
|
agentType: dispatch.agentType ?? undefined,
|
|
564
588
|
model: resolveModelTier(ctx, dispatch.model, localBindings),
|
|
@@ -569,6 +593,11 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
569
593
|
resume: resolveResumeArg(dispatch.resumeArg, localOpts),
|
|
570
594
|
onSessionId: opts.onSessionId,
|
|
571
595
|
label: prepared.label ?? defaultLabel,
|
|
596
|
+
// Strict permission handling: a refused tool call fails the
|
|
597
|
+
// dispatch (permission_denied) so no role trusts a result made
|
|
598
|
+
// without the refused tool's output, and the progressive heal
|
|
599
|
+
// (onPermissionDenied) can grant the missing permission.
|
|
600
|
+
fail_on_permission_denial: true,
|
|
572
601
|
};
|
|
573
602
|
for (const key of Object.keys(options)) {
|
|
574
603
|
if (options[key] === undefined) delete options[key];
|
|
@@ -633,8 +662,15 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
633
662
|
// turns can fix, so the escalation stops there.
|
|
634
663
|
let resumeAttempt = 0;
|
|
635
664
|
let lastResumeErr = err;
|
|
665
|
+
// The EXPLICIT id of the session the failed dispatch ran in. A
|
|
666
|
+
// resume targets exactly this id; with none, the resume becomes a
|
|
667
|
+
// fresh session carrying the FULL role prompt (never resume: true,
|
|
668
|
+
// which could reattach another role's session on a shared member).
|
|
669
|
+
let resumeSessionId = sessionIdOfError(err);
|
|
670
|
+
let sessionLostOnce = false;
|
|
636
671
|
while (resumeAttempt < Math.max(retry.resumeAttempts, resumesOnInfra ? 1 : 0)) {
|
|
637
672
|
resumeAttempt += 1;
|
|
673
|
+
const freshFallback = !resumeSessionId;
|
|
638
674
|
// A resume follows an agent that DID run (max_turns_exhausted is
|
|
639
675
|
// a resumable partial-work case, not a no-mutation failure), so
|
|
640
676
|
// it always runs the full pre-dispatch sync -- no attemptOpts.
|
|
@@ -667,14 +703,45 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
667
703
|
`(attempt ${resumeAttempt}/${retry.resumeAttempts}).`
|
|
668
704
|
);
|
|
669
705
|
}
|
|
706
|
+
if (freshFallback) {
|
|
707
|
+
ctx.log(
|
|
708
|
+
`${roleLabel}: starting a FRESH session with the full role prompt instead of resuming -- ` +
|
|
709
|
+
(sessionLostOnce
|
|
710
|
+
? 'the session to resume was not found on the member.'
|
|
711
|
+
: 'the failed dispatch reported no session id, so there is no explicit session to resume.')
|
|
712
|
+
);
|
|
713
|
+
} else {
|
|
714
|
+
ctx.log(`${roleLabel}: resuming explicit session '${resumeSessionId}'.`);
|
|
715
|
+
}
|
|
670
716
|
resumesIssued += 1;
|
|
671
717
|
try {
|
|
672
|
-
return await runDispatch(
|
|
718
|
+
return await runDispatch(
|
|
719
|
+
secondary,
|
|
720
|
+
freshFallback ? opts.prompt : opts.resumePrompt,
|
|
721
|
+
freshFallback ? opts.label : opts.resumeLabel,
|
|
722
|
+
undefined,
|
|
723
|
+
{ resumeAttempt, resumeSessionId, freshSession: freshFallback },
|
|
724
|
+
);
|
|
673
725
|
} catch (resumeErr) {
|
|
674
726
|
lastResumeErr = resumeErr;
|
|
675
727
|
const exhaustedAgain = resumeErr instanceof AgentDispatchError
|
|
676
728
|
&& resumeErr.details && resumeErr.details.reason === 'max_turns_exhausted';
|
|
677
|
-
|
|
729
|
+
// The explicit session is gone: fall back to a fresh
|
|
730
|
+
// full-prompt session, without charging the ladder.
|
|
731
|
+
const sessionNotFound = resumeErr instanceof AgentDispatchError
|
|
732
|
+
&& resumeErr.details && resumeErr.details.reason === 'session_not_found';
|
|
733
|
+
if (sessionNotFound && !freshFallback) {
|
|
734
|
+
sessionLostOnce = true;
|
|
735
|
+
resumeSessionId = null;
|
|
736
|
+
resumeAttempt -= 1;
|
|
737
|
+
continue;
|
|
738
|
+
}
|
|
739
|
+
if (retry.maxTurnsResume && exhaustedAgain) {
|
|
740
|
+
// A re-exhaustion moves the resume target to the NEW
|
|
741
|
+
// session's id (none -> a fresh full-prompt session).
|
|
742
|
+
resumeSessionId = sessionIdOfError(resumeErr);
|
|
743
|
+
continue;
|
|
744
|
+
}
|
|
678
745
|
throw resumeErr;
|
|
679
746
|
}
|
|
680
747
|
}
|
|
@@ -695,11 +762,12 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
695
762
|
// fresh one. Only reached when the failing attempt reported a sessionId and
|
|
696
763
|
// the role actually has a max-turns resume secondary; otherwise the caller
|
|
697
764
|
// re-runs runAttempt fresh.
|
|
698
|
-
const redispatchViaUsageLimitResume = async (attemptOpts) => {
|
|
765
|
+
const redispatchViaUsageLimitResume = async (attemptOpts, sessionId) => {
|
|
699
766
|
const secondary = policy.secondary;
|
|
700
767
|
const shortCircuit = await runPreDispatchSteps(ctx, secondary, member, opts, { resumeAttempt: 1 });
|
|
701
768
|
if (shortCircuit) return shortCircuit.value;
|
|
702
|
-
|
|
769
|
+
// Resumes the session the limit hit, by its explicit id.
|
|
770
|
+
return runDispatch(secondary, opts.resumePrompt ?? opts.prompt, opts.resumeLabel ?? opts.label, attemptOpts, { resumeAttempt: 1, resumeSessionId: sessionId });
|
|
703
771
|
};
|
|
704
772
|
|
|
705
773
|
let lastErr = null;
|
|
@@ -725,9 +793,88 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
725
793
|
// resume ladder. A usage-limit re-dispatch does NOT consume a ladder
|
|
726
794
|
// attempt (see the hook below), so it also skips the retry backoff.
|
|
727
795
|
let usageLimitRedispatch = null;
|
|
796
|
+
// The explicit id of the session the usage limit hit (for the resume above).
|
|
797
|
+
let usageLimitSessionId = null;
|
|
798
|
+
// A permission-refusal heal is PROGRESSIVE: each refusal is handed to
|
|
799
|
+
// ctx.onPermissionDenied, which grants what the member is missing (within
|
|
800
|
+
// its composed policy) and reports healed:true only when a new grant
|
|
801
|
+
// landed; the attempt is then re-run without charging the ladder (and
|
|
802
|
+
// without the backoff). The hook owns every stop rule (auto-mode refusal,
|
|
803
|
+
// no progress, per-member and per-ladder caps); this ladder only counts
|
|
804
|
+
// its own heals for the per-ladder cap.
|
|
805
|
+
let permissionHeals = 0;
|
|
806
|
+
let permissionHealRedispatch = false;
|
|
807
|
+
// Resolves null when the heal succeeded (re-run the attempt), else the
|
|
808
|
+
// MemberPermissionDeniedError that ends the sprint.
|
|
809
|
+
const healPermissionDenial = async (err) => {
|
|
810
|
+
const denial = permissionDeniedOf(err);
|
|
811
|
+
const actions = denial && denial.denials.length
|
|
812
|
+
? denial.denials.map((d) => (d.target ? `${d.action} "${d.target}"` : d.action))
|
|
813
|
+
: ((denial && denial.actions) || []);
|
|
814
|
+
const actionText = actions.length ? actions.join(', ') : 'unknown actions';
|
|
815
|
+
const suggested = (denial && denial.suggestedGrants) || [];
|
|
816
|
+
const fail = (step, why, heal) => {
|
|
817
|
+
const composeRole = (heal && heal.composeRole) || 'the role of its sprint roles';
|
|
818
|
+
const rejected = (heal && heal.rejectedGrants) || [];
|
|
819
|
+
const grantFix = rejected.length
|
|
820
|
+
? ` and grant ${JSON.stringify(rejected)} if that role should have them (they are outside the role policy, so the sprint never auto-grants them)`
|
|
821
|
+
: (suggested.length ? ` (suggested grants: ${JSON.stringify(suggested)})` : '');
|
|
822
|
+
if (step === 'not_healable') {
|
|
823
|
+
return new MemberPermissionDeniedError(
|
|
824
|
+
`${roleLabel} dispatch on member '${member}' was refused tool calls by its permission mode's safety checks: ${actionText}. ` +
|
|
825
|
+
`${why} The reply was not complete, so this is not a ${roleLabel} result. ` +
|
|
826
|
+
'No grant is added for a classifier or deny-rule refusal. To fix: review the refused calls; if the action is really intended, ' +
|
|
827
|
+
`grant it on member '${member}' by hand (compose_permissions grant) or change the role's task, then rerun the sprint.`,
|
|
828
|
+
{
|
|
829
|
+
member, role: policy.role, actions, suggestedGrants: [], rejectedGrants: [], step,
|
|
830
|
+
details: { hint: denial ? denial.hint : '' }, cause: err,
|
|
831
|
+
},
|
|
832
|
+
);
|
|
833
|
+
}
|
|
834
|
+
return new MemberPermissionDeniedError(
|
|
835
|
+
`${roleLabel} dispatch on member '${member}' was refused tool calls for lack of a permission grant: ${actionText}. ` +
|
|
836
|
+
`${why} This is a missing-permission failure, not a ${roleLabel} result. ` +
|
|
837
|
+
`To fix: run compose_permissions for member '${member}' with role ${composeRole}${grantFix}, then rerun the sprint.`,
|
|
838
|
+
{
|
|
839
|
+
member,
|
|
840
|
+
role: policy.role,
|
|
841
|
+
actions,
|
|
842
|
+
suggestedGrants: suggested,
|
|
843
|
+
rejectedGrants: rejected,
|
|
844
|
+
step,
|
|
845
|
+
details: { hint: denial ? denial.hint : '' },
|
|
846
|
+
cause: err,
|
|
847
|
+
},
|
|
848
|
+
);
|
|
849
|
+
};
|
|
850
|
+
if (typeof ctx.onPermissionDenied !== 'function') {
|
|
851
|
+
return fail('heal', 'No permission heal is wired for this run, so nothing re-composed the member.', null);
|
|
852
|
+
}
|
|
853
|
+
let heal;
|
|
854
|
+
try {
|
|
855
|
+
heal = await ctx.onPermissionDenied({ member, role: policy.role, roleLabel, denial, ladderHeals: permissionHeals });
|
|
856
|
+
} catch (healErr) {
|
|
857
|
+
heal = { healed: false, reason: healErr && healErr.message ? healErr.message : String(healErr) };
|
|
858
|
+
}
|
|
859
|
+
if (!heal || !heal.healed) {
|
|
860
|
+
const step = (heal && heal.step) || 'heal';
|
|
861
|
+
const why = step === 'heal'
|
|
862
|
+
? `The permission heal failed: ${(heal && heal.reason) || 'no result'}.`
|
|
863
|
+
: `The permission heal can make no further progress: ${(heal && heal.reason) || step}.`;
|
|
864
|
+
return fail(step, why, heal);
|
|
865
|
+
}
|
|
866
|
+
permissionHeals += 1;
|
|
867
|
+
ctx.log(
|
|
868
|
+
`${roleLabel} dispatch: member '${member}' was refused ${actionText}; granted ` +
|
|
869
|
+
`${(heal.grants || []).join(', ') || 'its missing permissions'} -- retrying (heal ${permissionHeals} of this dispatch, not charged to the ladder).`
|
|
870
|
+
);
|
|
871
|
+
return null;
|
|
872
|
+
};
|
|
728
873
|
|
|
729
874
|
for (let attempt = 1; attempt <= attempts; attempt++) {
|
|
730
|
-
|
|
875
|
+
const skipBackoff = Boolean(usageLimitRedispatch) || permissionHealRedispatch;
|
|
876
|
+
permissionHealRedispatch = false;
|
|
877
|
+
if (!skipBackoff && backoffMs && backoffMs[attempt - 1] > 0) {
|
|
731
878
|
ctx.log(
|
|
732
879
|
`${roleLabel} dispatch: waiting ${backoffMs[attempt - 1] / 1000}s before retry attempt ` +
|
|
733
880
|
`${attempt}/${backoffMs.length}...`
|
|
@@ -745,6 +892,19 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
745
892
|
// never fast-forward. Only after a failure that may have committed:
|
|
746
893
|
// an auth/trust failure provably ran nothing, so its retry keeps
|
|
747
894
|
// plain ff-only pre-dispatch sync.
|
|
895
|
+
//
|
|
896
|
+
// This is deliberately BROADER than isNoMutationDispatchFailure
|
|
897
|
+
// (dispatch-failure.mjs): a stall kill or a transport drop is
|
|
898
|
+
// classed no-mutation there (so the post-dispatch push is skipped),
|
|
899
|
+
// yet the member may still have committed or edited files before
|
|
900
|
+
// the channel died. The two are reconciled by making the reset
|
|
901
|
+
// itself non-destructive rather than by re-classifying those
|
|
902
|
+
// failures: syncMemberBefore's resetToRemoteTip mode always pins
|
|
903
|
+
// unpublished commits and uncommitted tracked changes on a local
|
|
904
|
+
// fleet-salvage/ side ref first and refuses to reset if it cannot
|
|
905
|
+
// (salvageBeforeReset in member-sync.mjs). Treating a failure as
|
|
906
|
+
// possibly-mutating here is therefore always safe, and nothing a
|
|
907
|
+
// killed attempt left behind is lost to the retry.
|
|
748
908
|
const retryFollowsPossibleMutation = attempt > 1 && lastErr
|
|
749
909
|
&& !isNonRetryableDispatchError(lastErr);
|
|
750
910
|
const attemptOpts = {
|
|
@@ -763,7 +923,7 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
763
923
|
const redispatchMode = usageLimitRedispatch;
|
|
764
924
|
usageLimitRedispatch = null;
|
|
765
925
|
value = redispatchMode === 'resume'
|
|
766
|
-
? await redispatchViaUsageLimitResume(attemptOpts)
|
|
926
|
+
? await redispatchViaUsageLimitResume(attemptOpts, usageLimitSessionId)
|
|
767
927
|
: await runAttempt(attemptOpts);
|
|
768
928
|
if (opts.afterAttempt) await opts.afterAttempt(value);
|
|
769
929
|
// A postResult step may REJECT the result (the reviewer's
|
|
@@ -825,6 +985,28 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
825
985
|
skipPreDispatchSyncNext = ctx.isNoMutationDispatchFailure(err);
|
|
826
986
|
}
|
|
827
987
|
|
|
988
|
+
// An agent permission refusal (reason 'permission_denied': the
|
|
989
|
+
// member CLI refused tool calls for lack of a grant) is a
|
|
990
|
+
// MISSING-PERMISSION failure, for every role -- never a role
|
|
991
|
+
// outcome. It is never degraded (a plan-reviewer's refusal text
|
|
992
|
+
// must not become a CHANGES_NEEDED verdict and charge a planning
|
|
993
|
+
// round), never retried blindly (the same config refuses the same
|
|
994
|
+
// call), and healed progressively: ctx.onPermissionDenied grants
|
|
995
|
+
// the missing permission within the member's composed policy, then
|
|
996
|
+
// the attempt is re-run without charging the ladder; a refusal of
|
|
997
|
+
// a different tool next time is healed the same way. When the hook
|
|
998
|
+
// can make no further progress (auto-mode refusal, refused again
|
|
999
|
+
// after its grant, outside policy, cap reached) or no hook is
|
|
1000
|
+
// wired, the sprint ends with MemberPermissionDeniedError naming
|
|
1001
|
+
// member, the denied actions and the fix.
|
|
1002
|
+
if (!completedButSyncFailed && isPermissionDeniedDispatchError(err)) {
|
|
1003
|
+
const healError = await healPermissionDenial(err);
|
|
1004
|
+
if (healError) throw healError;
|
|
1005
|
+
permissionHealRedispatch = true;
|
|
1006
|
+
attempt -= 1;
|
|
1007
|
+
continue;
|
|
1008
|
+
}
|
|
1009
|
+
|
|
828
1010
|
// Usage-limit pause/resume (apra-fleet-hzeb.4.2). A provider
|
|
829
1011
|
// rate/usage limit is neither a failure of this role nor something a
|
|
830
1012
|
// retry ladder can out-wait on its own budget -- it needs a real
|
|
@@ -863,6 +1045,7 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
863
1045
|
const canResumeSession = Boolean(failedSessionId) && retry.resumeAttempts > 0
|
|
864
1046
|
&& policy.secondary && policy.secondary.kind === 'max-turns-resume';
|
|
865
1047
|
usageLimitRedispatch = canResumeSession ? 'resume' : 'fresh';
|
|
1048
|
+
usageLimitSessionId = canResumeSession ? failedSessionId : null;
|
|
866
1049
|
attempt -= 1;
|
|
867
1050
|
continue;
|
|
868
1051
|
}
|
|
@@ -899,12 +1082,18 @@ export async function dispatchRole(ctx, roleName, opts = {}) {
|
|
|
899
1082
|
}
|
|
900
1083
|
ctx.log(
|
|
901
1084
|
`${roleLabel} dispatch threw a non-retryable error (auth/trust): ${err.message}. Aborting ` +
|
|
902
|
-
|
|
1085
|
+
`retries -- fix member '${member}' credentials/trust and re-run (for an LLM auth failure: re-login on the source machine with /login, then provision_llm_auth; or provision an API key).`
|
|
903
1086
|
);
|
|
904
1087
|
// A ladder whose own failure legitimately fails the whole
|
|
905
1088
|
// sprint propagates instead of degrading: with the dispatch
|
|
906
1089
|
// channel walled off there is no judgement to fabricate.
|
|
907
|
-
if (retry.rethrowsUnhealedNonRetryable)
|
|
1090
|
+
if (retry.rethrowsUnhealedNonRetryable) {
|
|
1091
|
+
if (isAuthDispatchError(err) && err && typeof err.message === 'string'
|
|
1092
|
+
&& !err.message.includes('provision_llm_auth')) {
|
|
1093
|
+
err.message += ` [LLM auth heal failed for member '${member}': re-login on the source machine with /login, then provision_llm_auth; or provision an API key]`;
|
|
1094
|
+
}
|
|
1095
|
+
throw err;
|
|
1096
|
+
}
|
|
908
1097
|
break;
|
|
909
1098
|
}
|
|
910
1099
|
|