@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
|
@@ -0,0 +1,590 @@
|
|
|
1
|
+
// CLI -> runner argument contract for fleet-sprint: the shell-injection-safe
|
|
2
|
+
// id/branch validators and the validated shape of `args`
|
|
3
|
+
// (apra-fleet-3swo.3.3). Moved verbatim out of runner.js -- runner.js
|
|
4
|
+
// re-exports every symbol this region previously exported, so existing
|
|
5
|
+
// importers of fleet-sprint/runner.js (including bin/cli.mjs) resolve
|
|
6
|
+
// unchanged. This is a move-only extraction: behaviour, validation order and
|
|
7
|
+
// error message text are all deliberately unchanged from the pre-move code.
|
|
8
|
+
import { normalizeRole, validateCredentialStoreName } from './contracts.mjs';
|
|
9
|
+
import { ROLE_KB_MAINTAINER } from './kb-maintainer.mjs';
|
|
10
|
+
import { parseExpectedIdentity } from './beads-identity.mjs';
|
|
11
|
+
import { resolveBacklogRoleAlias } from './backlog-role.mjs';
|
|
12
|
+
|
|
13
|
+
// ---------------------------------------------------------------------------
|
|
14
|
+
// CLI -> runner argument contract
|
|
15
|
+
// ---------------------------------------------------------------------------
|
|
16
|
+
//
|
|
17
|
+
// The canonical, validated shape of `args` (the `context.args` object
|
|
18
|
+
// WorkflowEngine.executeFile()/runWithContext() hands to main()). bin/cli.mjs
|
|
19
|
+
// must produce args matching this contract; unknown keys and missing required
|
|
20
|
+
// keys are both rejected loudly here so CLI/runner drift (a flag added on one
|
|
21
|
+
// side and forgotten on the other) fails fast instead of silently no-oping.
|
|
22
|
+
//
|
|
23
|
+
// Defense in depth: `target_issues`/`target_issue`, `branch`, and
|
|
24
|
+
// `base_branch` are validated against deliberately restrictive
|
|
25
|
+
// shell-injection-safe patterns here as well as in bin/cli.mjs (which imports
|
|
26
|
+
// validateIssueId/validateBranchName from this module -- single source of
|
|
27
|
+
// truth), so a malicious id or branch name can never reach a command()
|
|
28
|
+
// interpolation even if the CLI layer is bypassed. Validation runs before ANY
|
|
29
|
+
// agent()/command() dispatch, so a rejected arg produces zero fleet
|
|
30
|
+
// dispatches.
|
|
31
|
+
|
|
32
|
+
const ISSUE_ID_PATTERN = /^[A-Za-z0-9._-]+$/;
|
|
33
|
+
const BRANCH_NAME_PATTERN = /^[A-Za-z0-9._/-]+$/;
|
|
34
|
+
const GOAL_PATTERN = /^P[1-3](\/P[1-3]){0,2}$/;
|
|
35
|
+
|
|
36
|
+
const KNOWN_ARG_KEYS = new Set([
|
|
37
|
+
'target_issues', 'target_issue', 'members', 'branch', 'base_branch',
|
|
38
|
+
'goal', 'max_cycles', 'requirementsFile', 'roleMap', 'roleMapWarnings', 'budget',
|
|
39
|
+
// Per-dispatch time budget (timeout_s == max_total_s at every dispatch
|
|
40
|
+
// site; integ ceiling = 2x), bounding the cost of a hung dispatch.
|
|
41
|
+
'dispatch_timeout_s',
|
|
42
|
+
// apra-fleet-hzeb.4.2: usage-limit pause/resume budgets. The one
|
|
43
|
+
// CLI-overridable pair for the usage-limit controller (fleet-sprint/
|
|
44
|
+
// usage-limit-controller.mjs); both default from
|
|
45
|
+
// role-policies.mjs's USAGE_LIMIT_BUDGET_DEFAULTS when omitted.
|
|
46
|
+
// `usage_limit_max_wait_s` bounds total wall-clock a single dispatch may
|
|
47
|
+
// stay paused across all reprobes before giving up
|
|
48
|
+
// (UsageLimitWaitExhaustedError); `usage_limit_max_reprobes` bounds the
|
|
49
|
+
// reprobe count independently of elapsed wait.
|
|
50
|
+
'usage_limit_max_wait_s',
|
|
51
|
+
'usage_limit_max_reprobes',
|
|
52
|
+
// The always-on supervisor's base HTTP URL (e.g. http://127.0.0.1:8787).
|
|
53
|
+
// Set by bin/cli.mjs from the FLEET_SE_SERVICE_URL env var the supervisor's
|
|
54
|
+
// spawner injects into each detached child; absent for supervisor-less
|
|
55
|
+
// (single-process/dev/test) runs. When present it enables the cross-sprint
|
|
56
|
+
// coordination layers: the global dolt push mutex, the child-id allocator,
|
|
57
|
+
// and per-bead work-claiming. All three are no-ops without it -- a lone
|
|
58
|
+
// sprint has no sibling to coordinate with.
|
|
59
|
+
'serviceUrl',
|
|
60
|
+
// apra-fleet-5co8.37: this launch's incarnation-unique run identity -- the
|
|
61
|
+
// SAME string the supervisor's reservation ledger keys this sprint by
|
|
62
|
+
// (bin/cli.mjs forwards the supervisor's --run-id, falling back to the
|
|
63
|
+
// branch name for a direct/standalone launch, which is also what cli.mjs
|
|
64
|
+
// reserves members under). Threaded to the deployer so its active-sprints
|
|
65
|
+
// gate can tell this sprint's OWN reservation from a foreign one.
|
|
66
|
+
'run_id',
|
|
67
|
+
// The assignee identity this sprint claims beads as and filters ready work
|
|
68
|
+
// by (`bd update --claim` / `bd ready --assignee`). No CLI flag sets this
|
|
69
|
+
// today (bin/cli.mjs's buildRunnerArgs() does not accept it, and no
|
|
70
|
+
// apra-pm workflow under packages/apra-fleet-se/apra-pm sets it either --
|
|
71
|
+
// both verified by repo-wide search, apra-fleet-3swo.7.13); bead selection
|
|
72
|
+
// falls back to the unassigned `bd list --ready`.
|
|
73
|
+
//
|
|
74
|
+
// PRODUCTIZE-OR-PRUNE DECISION (apra-fleet-3swo.7.13): PRODUCTIZED, not
|
|
75
|
+
// pruned. This is NOT dead code -- it is a fully wired, load-bearing
|
|
76
|
+
// engine capability with no CLI surfacing yet: fleet-sprint/beads-
|
|
77
|
+
// scope.mjs actively rewrites its shared `bd list` query to
|
|
78
|
+
// `--assignee <id>` when this is set (so two sprints working the same
|
|
79
|
+
// beads project never select the same bead), and the doer's develop-phase
|
|
80
|
+
// claiming branch (fleet-sprint/phases/develop.mjs) batches a real
|
|
81
|
+
// `bd update <ids...> --claim --json` and narrows the streak to whatever
|
|
82
|
+
// it actually won. Both are exercised directly against the real functions
|
|
83
|
+
// by test/beads-scope-extraction.test.mjs ("--assignee narrows a filtered
|
|
84
|
+
// read...") and test/claim-beads-batched.test.mjs -- this is the "at
|
|
85
|
+
// least one test exercising it" bar, against the real
|
|
86
|
+
// beadsScopeConfig()/claimBeadsBatched() functions the engine itself
|
|
87
|
+
// calls, not a re-derivation of their logic. Documented in
|
|
88
|
+
// docs/cli-reference.md and docs/fleet-sprint-cli-contract.md. Left
|
|
89
|
+
// without a CLI flag deliberately: it exists for a multi-sprint-on-one-
|
|
90
|
+
// project deployment (the supervisor's own future coordination surface,
|
|
91
|
+
// or a direct WorkflowEngine.executeFile() caller), which is a real
|
|
92
|
+
// invocation path today even with no `--assignee` flag on `fleet-sprint`
|
|
93
|
+
// itself -- see docs/fleet-sprint-cli-contract.md's "Dormant argument
|
|
94
|
+
// audit" section for the full record.
|
|
95
|
+
'assignee',
|
|
96
|
+
// Explicitly skip the once-per-sprint regression pass (launch option:
|
|
97
|
+
// the CLI's --skip-regression, the supervisor's phases.regression:"skip").
|
|
98
|
+
// Never silent: the engine logs it and the sprint report and PR body say
|
|
99
|
+
// "skipped by launch option". The integration-test phase is unaffected.
|
|
100
|
+
'skip_regression',
|
|
101
|
+
// Multi-streak worklist dispatch mode when a develop round has more ready
|
|
102
|
+
// streaks than doers. 'resume' (default): per-streak dispatches that resume
|
|
103
|
+
// the SAME doer session by explicit session id (warm-context carryover,
|
|
104
|
+
// every engine checkpoint kept between streaks). 'batch' (config-gated,
|
|
105
|
+
// overhead-dominated scenarios): one dispatch carries a doer's whole
|
|
106
|
+
// ordered worklist, which REQUIRES a tier-homogeneous worklist.
|
|
107
|
+
// No CLI flag sets this today; only test/programmatic callers pass it.
|
|
108
|
+
//
|
|
109
|
+
// PRODUCTIZE-OR-PRUNE DECISION (apra-fleet-3swo.7.13): PRODUCTIZED. Fully
|
|
110
|
+
// wired (validated here, consumed by fleet-sprint/worklists.mjs's
|
|
111
|
+
// resolveWorklistTierPolicy and the develop-phase worklist packer) and
|
|
112
|
+
// exercised end-to-end through the real WorkflowEngine.executeFile()
|
|
113
|
+
// invocation path by test/mock-sprint-worklist-batch.test.mjs. Documented
|
|
114
|
+
// in docs/cli-reference.md and docs/fleet-sprint-cli-contract.md. See
|
|
115
|
+
// docs/fleet-sprint-cli-contract.md's "Dormant argument audit" section.
|
|
116
|
+
'doer_worklist_mode',
|
|
117
|
+
// Capability opt-in: the doer pool's provider supports changing model on a
|
|
118
|
+
// RESUMED session. Only then may a resumed-sequence worklist carry mixed
|
|
119
|
+
// tiers, each streak dispatching at its own tier; default false falls back
|
|
120
|
+
// to tier-homogeneous grouping. See resolveWorklistTierPolicy() for the
|
|
121
|
+
// capability-check seam.
|
|
122
|
+
// No CLI flag sets this today; only test/programmatic callers pass it.
|
|
123
|
+
//
|
|
124
|
+
// PRODUCTIZE-OR-PRUNE DECISION (apra-fleet-3swo.7.13): PRODUCTIZED. Fully
|
|
125
|
+
// wired and exercised end-to-end through the real
|
|
126
|
+
// WorkflowEngine.executeFile() invocation path by
|
|
127
|
+
// test/mock-sprint-worklist-resume.test.mjs and unit-tested against the
|
|
128
|
+
// real resolveWorklistTierPolicy() by test/worklist-assignment.test.mjs.
|
|
129
|
+
// Documented in docs/cli-reference.md and docs/fleet-sprint-cli-contract.md.
|
|
130
|
+
// See docs/fleet-sprint-cli-contract.md's "Dormant argument audit" section.
|
|
131
|
+
'resume_model_switch',
|
|
132
|
+
// Per-doer effort-point budget for worklist packing (planner.md effort
|
|
133
|
+
// formula units). Default DEFAULT_EFFORT_THRESHOLD.
|
|
134
|
+
// No CLI flag sets this today; only test/programmatic callers pass it.
|
|
135
|
+
'worklist_effort_budget',
|
|
136
|
+
// Engine CI gate arg -- DELIBERATELY NOT WIRED (2026-10-01). ci-gate.mjs
|
|
137
|
+
// runs CI per reviewer dispatch and hands the result to the reviewer; the
|
|
138
|
+
// agreed direction is the opposite (CI never blocks or reaches doer/
|
|
139
|
+
// reviewer loops; the integ-test phase owns CI via one reopenable bead;
|
|
140
|
+
// per-push vs end-of-cycle triggering per project). Until the "fleet-sprint
|
|
141
|
+
// must also utilize CI as a resource for quality" epic (apra-fleet-dv8i)
|
|
142
|
+
// designs that flow, ci_gate is not a known arg, so passing it fails loudly
|
|
143
|
+
// as an unknown arg. The gate module stays in place, unconfigured.
|
|
144
|
+
// 'ci_gate',
|
|
145
|
+
// An optional live `(name, args) => Promise<any>` MCP tool-call function,
|
|
146
|
+
// wired by bin/cli.mjs from its already-connected `mcpClient.callTool`.
|
|
147
|
+
// Consumed by createMemberSessionGuard() to call the fleet's own
|
|
148
|
+
// `stop_prompt` tool before a resume re-dispatch. This is a live function
|
|
149
|
+
// reference, not a JSON-serializable value -- safe only because
|
|
150
|
+
// WorkflowEngine.executeFile() runs runner.js in-process (dynamic
|
|
151
|
+
// `import()`, never across a subprocess boundary). Absent for direct
|
|
152
|
+
// runSprintCycle()/main() test calls, where the guard is a no-op.
|
|
153
|
+
'callTool',
|
|
154
|
+
// Per-sprint override for the Azure DevOps PAT secret name. When provided, this
|
|
155
|
+
// credential store entry name is used instead of the documented default
|
|
156
|
+
// (azdevops_pat). No CLI flag sets this today; only test/programmatic callers
|
|
157
|
+
// pass it.
|
|
158
|
+
'azdevops_pat_secret_name',
|
|
159
|
+
// The beads identity every member must resolve to (JSON string from
|
|
160
|
+
// `--expect-beads`, env fallback FLEET_SPRINT_EXPECT_BEADS, or an already
|
|
161
|
+
// parsed record from a programmatic caller). Consumed by the
|
|
162
|
+
// verifyBeadsIdentity precondition (beads-identity-check.mjs); absent, the
|
|
163
|
+
// backlog member's own probed identity becomes the expectation.
|
|
164
|
+
'expect_beads',
|
|
165
|
+
]);
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* Validates the raw `--expect-beads` value: a JSON string (the supervisor's
|
|
169
|
+
* serializeExpectedIdentity output) or a plain record. Malformed JSON is a
|
|
170
|
+
* hard arg error; undefined/empty means "no expectation".
|
|
171
|
+
* @param {unknown} raw
|
|
172
|
+
* @returns {object|undefined}
|
|
173
|
+
*/
|
|
174
|
+
export function validateExpectBeads(raw) {
|
|
175
|
+
if (raw === undefined || raw === null || raw === '') return undefined;
|
|
176
|
+
if (typeof raw !== 'string' && (typeof raw !== 'object' || Array.isArray(raw))) {
|
|
177
|
+
throw new Error('[Arg Contract] Invalid expect_beads: must be a JSON string or an object ({ beadsDir, prefix, syncRemote, repoRemote }).');
|
|
178
|
+
}
|
|
179
|
+
const parsed = parseExpectedIdentity(raw);
|
|
180
|
+
if (!parsed) {
|
|
181
|
+
throw new Error(`[Arg Contract] Invalid expect_beads: not valid JSON (${JSON.stringify(String(raw)).slice(0, 200)}).`);
|
|
182
|
+
}
|
|
183
|
+
if (!parsed.prefix && !parsed.syncRemote && !parsed.repoRemote) {
|
|
184
|
+
throw new Error('[Arg Contract] Invalid expect_beads: must carry at least one of prefix, syncRemote, repoRemote.');
|
|
185
|
+
}
|
|
186
|
+
return parsed;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/** Default CI gate timeout (seconds) when ci_gate omits timeout_s. */
|
|
190
|
+
export const DEFAULT_CI_GATE_TIMEOUT_S = 3600;
|
|
191
|
+
// A workflow file name ("ci.yml") or numeric workflow id -- interpolated into
|
|
192
|
+
// a provider REST path, so restrictive by design.
|
|
193
|
+
const CI_GATE_WORKFLOW_PATTERN = /^[A-Za-z0-9._-]+$/;
|
|
194
|
+
|
|
195
|
+
/**
|
|
196
|
+
* Validates the optional ci_gate arg: { workflow: string, timeout_s?: positive
|
|
197
|
+
* integer (default 3600) }. Accepts the object, or its JSON string form (the
|
|
198
|
+
* CLI forwards --ci-gate verbatim). Absent -> undefined (gate not configured).
|
|
199
|
+
* @param {unknown} raw
|
|
200
|
+
* @returns {{ workflow: string, timeoutS: number }|undefined}
|
|
201
|
+
*/
|
|
202
|
+
export function validateCiGate(raw) {
|
|
203
|
+
if (raw === undefined || raw === null || raw === '') return undefined;
|
|
204
|
+
let value = raw;
|
|
205
|
+
if (typeof raw === 'string') {
|
|
206
|
+
try {
|
|
207
|
+
value = JSON.parse(raw);
|
|
208
|
+
} catch {
|
|
209
|
+
throw new Error(`[Arg Contract] Invalid ci_gate: not valid JSON (${JSON.stringify(raw).slice(0, 200)}). Expected {"workflow": "<workflow file name or id>", "timeout_s": <positive integer>}.`);
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
if (!value || typeof value !== 'object' || Array.isArray(value)) {
|
|
213
|
+
throw new Error('[Arg Contract] Invalid ci_gate: must be an object {"workflow": "<workflow file name or id>", "timeout_s": <positive integer, default 3600>}.');
|
|
214
|
+
}
|
|
215
|
+
const unknown = Object.keys(value).filter((k) => k !== 'workflow' && k !== 'timeout_s');
|
|
216
|
+
if (unknown.length > 0) {
|
|
217
|
+
throw new Error(`[Arg Contract] Invalid ci_gate: unknown key(s) ${unknown.join(', ')}. Known keys: workflow, timeout_s.`);
|
|
218
|
+
}
|
|
219
|
+
const workflow = value.workflow;
|
|
220
|
+
if (typeof workflow !== 'string' || workflow.length === 0 || !CI_GATE_WORKFLOW_PATTERN.test(workflow)) {
|
|
221
|
+
throw new Error(`[Arg Contract] Invalid ci_gate.workflow "${workflow}": required; must be a workflow file name or numeric id matching ${CI_GATE_WORKFLOW_PATTERN}.`);
|
|
222
|
+
}
|
|
223
|
+
const timeoutS = value.timeout_s === undefined ? DEFAULT_CI_GATE_TIMEOUT_S : value.timeout_s;
|
|
224
|
+
if (typeof timeoutS !== 'number' || !Number.isInteger(timeoutS) || timeoutS <= 0) {
|
|
225
|
+
throw new Error(`[Arg Contract] Invalid ci_gate.timeout_s "${timeoutS}": must be a positive integer (seconds).`);
|
|
226
|
+
}
|
|
227
|
+
return { workflow, timeoutS };
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
/**
|
|
231
|
+
* Validates a single issue id against the shell-injection-safe pattern.
|
|
232
|
+
* Throws with a clear message on rejection.
|
|
233
|
+
* @param {unknown} id
|
|
234
|
+
* @returns {string}
|
|
235
|
+
*/
|
|
236
|
+
export function validateIssueId(id) {
|
|
237
|
+
if (typeof id !== 'string' || id.length === 0 || !ISSUE_ID_PATTERN.test(id)) {
|
|
238
|
+
throw new Error(`[Arg Contract] Invalid issue id "${id}": must match ${ISSUE_ID_PATTERN} (letters, digits, '.', '_', '-' only).`);
|
|
239
|
+
}
|
|
240
|
+
return id;
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
/**
|
|
244
|
+
* Validates a git branch name (sprint `branch` / `base_branch`) against a
|
|
245
|
+
* shell-injection-safe pattern before it is ever interpolated into a
|
|
246
|
+
* git/gh command() string.
|
|
247
|
+
* @param {unknown} name
|
|
248
|
+
* @param {string} label - human-readable arg name, used in the error message
|
|
249
|
+
* @returns {string}
|
|
250
|
+
*/
|
|
251
|
+
export function validateBranchName(name, label) {
|
|
252
|
+
if (typeof name !== 'string' || name.length === 0 || !BRANCH_NAME_PATTERN.test(name)) {
|
|
253
|
+
throw new Error(`[Arg Contract] Invalid ${label} "${name}": must match ${BRANCH_NAME_PATTERN} (letters, digits, '.', '_', '-', '/' only).`);
|
|
254
|
+
}
|
|
255
|
+
return name;
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
// Strip the ref prefixes a caller may legitimately pass for the same branch
|
|
259
|
+
// (refs/heads/<b>, origin/<b>, refs/remotes/origin/<b>) so "main",
|
|
260
|
+
// "origin/main" and "refs/heads/main" all compare equal. Compared
|
|
261
|
+
// case-insensitively: a pair differing only in case is never a legitimate
|
|
262
|
+
// sprint (case-insensitive filesystems and hosts treat them as one branch).
|
|
263
|
+
function normalizeBranchForCompare(name) {
|
|
264
|
+
let n = String(name).toLowerCase();
|
|
265
|
+
for (const prefix of ['refs/remotes/origin/', 'refs/heads/', 'origin/']) {
|
|
266
|
+
if (n.startsWith(prefix)) { n = n.slice(prefix.length); break; }
|
|
267
|
+
}
|
|
268
|
+
return n;
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
/**
|
|
272
|
+
* Rejects a sprint whose working branch is its base branch (GitHub #613):
|
|
273
|
+
* the review range base..branch would be empty, doer commits would land
|
|
274
|
+
* directly on the base, and the closing PR could never be opened (head ==
|
|
275
|
+
* base). Shared by validateArgs, bin/cli.mjs and the supervisor launch API so
|
|
276
|
+
* every entry point refuses the same pairs with the same message.
|
|
277
|
+
*
|
|
278
|
+
* @param {string} branch
|
|
279
|
+
* @param {string} base
|
|
280
|
+
*/
|
|
281
|
+
export function validateBranchPair(branch, base) {
|
|
282
|
+
if (typeof branch !== 'string' || typeof base !== 'string') return;
|
|
283
|
+
if (normalizeBranchForCompare(branch) === normalizeBranchForCompare(base)) {
|
|
284
|
+
throw new Error(`[Arg Contract] Invalid branch "${branch}": must differ from base_branch "${base}" (the sprint works on its own branch and opens a PR into the base).`);
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/**
|
|
289
|
+
* Validates and normalizes the args object passed into main(context).
|
|
290
|
+
* Rejects unknown keys and missing/malformed required keys loudly.
|
|
291
|
+
*
|
|
292
|
+
* @param {any} args
|
|
293
|
+
* @returns {{
|
|
294
|
+
* targetIssues: string[], members: string[], branch: string,
|
|
295
|
+
* baseBranch: string, goal: string, maxCycles: number,
|
|
296
|
+
* requirementsFile: string|undefined, roleMap: object|undefined,
|
|
297
|
+
* budget: number|undefined
|
|
298
|
+
* }}
|
|
299
|
+
*/
|
|
300
|
+
export function validateArgs(args) {
|
|
301
|
+
if (!args || typeof args !== 'object' || Array.isArray(args)) {
|
|
302
|
+
throw new Error('[Arg Contract] args must be an object.');
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
const unknown = Object.keys(args).filter((k) => !KNOWN_ARG_KEYS.has(k));
|
|
306
|
+
if (unknown.length > 0) {
|
|
307
|
+
throw new Error(`[Arg Contract] Unknown arg(s): ${unknown.join(', ')}. Known args: ${[...KNOWN_ARG_KEYS].join(', ')}.`);
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
// --- target issues: target_issues[] (preferred) or legacy single target_issue ---
|
|
311
|
+
let targetIssues;
|
|
312
|
+
if (Array.isArray(args.target_issues)) {
|
|
313
|
+
targetIssues = args.target_issues;
|
|
314
|
+
} else if (typeof args.target_issue === 'string') {
|
|
315
|
+
targetIssues = [args.target_issue];
|
|
316
|
+
} else {
|
|
317
|
+
throw new Error('[Arg Contract] Missing required arg: target_issues (non-empty array) or target_issue (string).');
|
|
318
|
+
}
|
|
319
|
+
if (targetIssues.length === 0) {
|
|
320
|
+
throw new Error('[Arg Contract] target_issues must be a non-empty array.');
|
|
321
|
+
}
|
|
322
|
+
targetIssues.forEach(validateIssueId);
|
|
323
|
+
|
|
324
|
+
// --- members ---
|
|
325
|
+
if (!Array.isArray(args.members) || args.members.length === 0) {
|
|
326
|
+
throw new Error('[Arg Contract] Missing required arg: members (non-empty array of member ids/names).');
|
|
327
|
+
}
|
|
328
|
+
args.members.forEach((m) => {
|
|
329
|
+
if (typeof m !== 'string' || m.length === 0) {
|
|
330
|
+
throw new Error(`[Arg Contract] Invalid member entry "${m}": must be a non-empty string.`);
|
|
331
|
+
}
|
|
332
|
+
});
|
|
333
|
+
|
|
334
|
+
// --- branch / base_branch (required; also the git/PR target) ---
|
|
335
|
+
if (typeof args.branch !== 'string' || args.branch.length === 0) {
|
|
336
|
+
throw new Error('[Arg Contract] Missing required arg: branch (sprint branch name).');
|
|
337
|
+
}
|
|
338
|
+
validateBranchName(args.branch, 'branch');
|
|
339
|
+
|
|
340
|
+
if (typeof args.base_branch !== 'string' || args.base_branch.length === 0) {
|
|
341
|
+
throw new Error('[Arg Contract] Missing required arg: base_branch (branch the sprint branch is created from and the PR targets).');
|
|
342
|
+
}
|
|
343
|
+
validateBranchName(args.base_branch, 'base_branch');
|
|
344
|
+
validateBranchPair(args.branch, args.base_branch);
|
|
345
|
+
|
|
346
|
+
// --- goal (optional, default 'P1/P2'; the priority band this sprint aims
|
|
347
|
+
// to clear, consumed by the exit-condition logic) ---
|
|
348
|
+
const goal = args.goal === undefined ? 'P1/P2' : args.goal;
|
|
349
|
+
if (typeof goal !== 'string' || !GOAL_PATTERN.test(goal)) {
|
|
350
|
+
throw new Error(`[Arg Contract] Invalid goal "${goal}": must match ${GOAL_PATTERN} (e.g. 'P1', 'P1/P2', 'P1/P2/P3').`);
|
|
351
|
+
}
|
|
352
|
+
|
|
353
|
+
// --- max_cycles (optional, default 5) ---
|
|
354
|
+
const maxCycles = args.max_cycles === undefined ? 5 : args.max_cycles;
|
|
355
|
+
if (typeof maxCycles !== 'number' || !Number.isInteger(maxCycles) || maxCycles < 1) {
|
|
356
|
+
throw new Error(`[Arg Contract] Invalid max_cycles "${maxCycles}": must be a positive integer.`);
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
// --- requirementsFile (optional) ---
|
|
360
|
+
if (args.requirementsFile !== undefined && (typeof args.requirementsFile !== 'string' || args.requirementsFile.length === 0)) {
|
|
361
|
+
throw new Error('[Arg Contract] Invalid requirementsFile: must be a non-empty string path.');
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
// --- roleMap (optional; consumed by getMemberForRole/getMembersForRole below) ---
|
|
365
|
+
if (args.roleMap !== undefined && (typeof args.roleMap !== 'object' || args.roleMap === null || Array.isArray(args.roleMap))) {
|
|
366
|
+
throw new Error('[Arg Contract] Invalid roleMap: must be an object mapping role -> member[].');
|
|
367
|
+
}
|
|
368
|
+
// This is the SINGLE normalization point for roleMap keys: every key is
|
|
369
|
+
// put through normalizeRole() (trim + lowercase) here, so any casing or
|
|
370
|
+
// whitespace variant resolves to its canonical form and downstream readers
|
|
371
|
+
// (getMemberForRole/getMembersForRole) may assume normalized keys and must
|
|
372
|
+
// never re-read `args.roleMap` directly. Two differently-cased input keys
|
|
373
|
+
// that normalize to the same key are rejected loudly (ambiguous authorial
|
|
374
|
+
// intent) rather than one silently clobbering the other.
|
|
375
|
+
let normalizedRoleMap;
|
|
376
|
+
if (args.roleMap !== undefined) {
|
|
377
|
+
normalizedRoleMap = {};
|
|
378
|
+
for (const [rawKey, value] of Object.entries(args.roleMap)) {
|
|
379
|
+
const key = normalizeRole(rawKey);
|
|
380
|
+
if (Object.prototype.hasOwnProperty.call(normalizedRoleMap, key)) {
|
|
381
|
+
throw new Error(
|
|
382
|
+
`[Arg Contract] Invalid roleMap: key "${rawKey}" normalizes to "${key}", which collides with ` +
|
|
383
|
+
`another key already present in roleMap. Use a single casing/whitespace variant per role.`
|
|
384
|
+
);
|
|
385
|
+
}
|
|
386
|
+
normalizedRoleMap[key] = value;
|
|
387
|
+
}
|
|
388
|
+
// kb_maintainer is an accepted roleMap key but NOT a dispatched role:
|
|
389
|
+
// it names the member(s) that receive every KB write for their own
|
|
390
|
+
// repository (kb-maintainer.mjs). Its members must be sprint members,
|
|
391
|
+
// since selection probes them through the sprint's member access.
|
|
392
|
+
if (Object.prototype.hasOwnProperty.call(normalizedRoleMap, ROLE_KB_MAINTAINER)) {
|
|
393
|
+
const list = normalizedRoleMap[ROLE_KB_MAINTAINER];
|
|
394
|
+
if (!Array.isArray(list) || list.some((m) => typeof m !== 'string' || m.length === 0)) {
|
|
395
|
+
throw new Error(`[Arg Contract] Invalid roleMap.${ROLE_KB_MAINTAINER}: must be an array of non-empty member names.`);
|
|
396
|
+
}
|
|
397
|
+
const stray = list.filter((m) => !args.members.includes(m));
|
|
398
|
+
if (stray.length > 0) {
|
|
399
|
+
const quoted = stray.map((m) => '"' + m + '"').join(', ');
|
|
400
|
+
throw new Error(`[Arg Contract] Invalid roleMap.${ROLE_KB_MAINTAINER}: ${quoted} not in members.`);
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
// Backlog-role alias: the deprecated 'orchestrator' key is folded into
|
|
405
|
+
// 'backlog' here (downstream readers only ever see 'backlog'); a conflict
|
|
406
|
+
// is an arg-contract error. Warnings -- plus any the CLI already collected
|
|
407
|
+
// (args.roleMapWarnings, since the CLI rewrites the key before the runner
|
|
408
|
+
// sees it) -- are surfaced on the validated object for the runner to log.
|
|
409
|
+
const roleMapWarnings = [];
|
|
410
|
+
if (normalizedRoleMap !== undefined) {
|
|
411
|
+
try {
|
|
412
|
+
const resolved = resolveBacklogRoleAlias(normalizedRoleMap);
|
|
413
|
+
normalizedRoleMap = resolved.roleMap;
|
|
414
|
+
roleMapWarnings.push(...resolved.warnings);
|
|
415
|
+
} catch (err) {
|
|
416
|
+
throw new Error(`[Arg Contract] Invalid roleMap: ${err.message}`);
|
|
417
|
+
}
|
|
418
|
+
}
|
|
419
|
+
if (Array.isArray(args.roleMapWarnings)) {
|
|
420
|
+
for (const w of args.roleMapWarnings) {
|
|
421
|
+
if (typeof w === 'string' && !roleMapWarnings.includes(w)) roleMapWarnings.push(w);
|
|
422
|
+
}
|
|
423
|
+
}
|
|
424
|
+
|
|
425
|
+
// --- budget (optional) -----------------------------------------------
|
|
426
|
+
// A USD ceiling for this run's total estimated spend. When provided,
|
|
427
|
+
// main() sets `context.budget.total` to this value BEFORE any dispatch, so
|
|
428
|
+
// `agent()`'s budget-exceeded check can actually fire. Omitted,
|
|
429
|
+
// `context.budget.total` stays `null` (unlimited).
|
|
430
|
+
if (args.budget !== undefined && (typeof args.budget !== 'number' || !Number.isFinite(args.budget) || args.budget < 0)) {
|
|
431
|
+
throw new Error(`[Arg Contract] Invalid budget "${args.budget}": must be a non-negative finite number (USD ceiling).`);
|
|
432
|
+
}
|
|
433
|
+
|
|
434
|
+
// --- run_id (optional) -------------------------------------------------
|
|
435
|
+
// Free-form supervisor-generated identity; only its shape is checked here.
|
|
436
|
+
if (args.run_id !== undefined && (typeof args.run_id !== 'string' || args.run_id.length === 0)) {
|
|
437
|
+
throw new Error('[Arg Contract] Invalid run_id: must be a non-empty string.');
|
|
438
|
+
}
|
|
439
|
+
|
|
440
|
+
// --- serviceUrl (optional) --------------------------------------------
|
|
441
|
+
// The always-on supervisor's base HTTP URL. Validated as an http(s) URL so
|
|
442
|
+
// a malformed value fails fast rather than silently disabling the
|
|
443
|
+
// cross-sprint coordination layers or, worse, being interpolated somewhere
|
|
444
|
+
// unsafe. Omitted (single-process/dev/test): the coordination layers stay
|
|
445
|
+
// dormant (a lone sprint has no sibling to serialize against).
|
|
446
|
+
if (args.serviceUrl !== undefined) {
|
|
447
|
+
if (typeof args.serviceUrl !== 'string' || args.serviceUrl.length === 0) {
|
|
448
|
+
throw new Error('[Arg Contract] Invalid serviceUrl: must be a non-empty http(s) URL string.');
|
|
449
|
+
}
|
|
450
|
+
let parsed;
|
|
451
|
+
try {
|
|
452
|
+
parsed = new URL(args.serviceUrl);
|
|
453
|
+
} catch {
|
|
454
|
+
throw new Error(`[Arg Contract] Invalid serviceUrl "${args.serviceUrl}": must be a valid http(s) URL.`);
|
|
455
|
+
}
|
|
456
|
+
if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
|
|
457
|
+
throw new Error(`[Arg Contract] Invalid serviceUrl "${args.serviceUrl}": must use the http: or https: scheme.`);
|
|
458
|
+
}
|
|
459
|
+
}
|
|
460
|
+
|
|
461
|
+
// --- assignee (optional) ----------------------------------------------
|
|
462
|
+
// The work-claiming identity. Constrained to a shell-injection-safe pattern
|
|
463
|
+
// because it is interpolated into `bd update --claim` / `bd ready
|
|
464
|
+
// --assignee` command strings, matching the same defense-in-depth posture
|
|
465
|
+
// as issue ids and branch names above.
|
|
466
|
+
if (args.assignee !== undefined) {
|
|
467
|
+
if (typeof args.assignee !== 'string' || args.assignee.length === 0 || !ISSUE_ID_PATTERN.test(args.assignee)) {
|
|
468
|
+
throw new Error(`[Arg Contract] Invalid assignee "${args.assignee}": must match ${ISSUE_ID_PATTERN} (letters, digits, '.', '_', '-' only).`);
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
|
|
472
|
+
// --- dispatch_timeout_s (optional, default 9000 = 150min/2.5h) ---------
|
|
473
|
+
// Per-dispatch time budget in seconds. This value is used to derive two
|
|
474
|
+
// distinct dispatched parameters sent to execute_prompt: timeout_s (the
|
|
475
|
+
// inactivity detector baseline, clamped to a maximum to prevent one run's
|
|
476
|
+
// budget from disabling stall detection entirely) and max_total_s (the full
|
|
477
|
+
// dispatch timeout, unclamped). These two are no longer equal: timeout_s
|
|
478
|
+
// drives the StallDetector's per-dispatch threshold for every provider; it
|
|
479
|
+
// ALSO drives the exec-channel rolling timer for Codex, Copilot, and
|
|
480
|
+
// OpenCode. Claude and AGY instead take their exec-level ceiling from
|
|
481
|
+
// max_total_s (falling back to a never-binds constant if max_total_s is
|
|
482
|
+
// absent), so they do not falsely kill a dispatch while a long silent tool
|
|
483
|
+
// call is legitimately being processed. Raised from the earlier 3600s
|
|
484
|
+
// default: an hour was tight enough to misclassify a slow-but-alive turn
|
|
485
|
+
// (a large diff, a chatty tool loop) as a stall, which is a false positive,
|
|
486
|
+
// not the genuine-hang protection this timer exists for. Lowering it still
|
|
487
|
+
// bounds the cost of a live-but-silent member hang, which no timer can
|
|
488
|
+
// otherwise distinguish from work. Floor 60: below that even healthy
|
|
489
|
+
// dispatches cannot complete a single turn. The integ-test dispatch
|
|
490
|
+
// ceiling is 2x this value and the regression-test ceiling is 3x, since
|
|
491
|
+
// those suites legitimately run past one budget.
|
|
492
|
+
const dispatchTimeoutS = args.dispatch_timeout_s === undefined ? 9000 : args.dispatch_timeout_s;
|
|
493
|
+
if (typeof dispatchTimeoutS !== 'number' || !Number.isInteger(dispatchTimeoutS) || dispatchTimeoutS < 60) {
|
|
494
|
+
throw new Error(`[Arg Contract] Invalid dispatch_timeout_s "${dispatchTimeoutS}": must be an integer >= 60 (seconds).`);
|
|
495
|
+
}
|
|
496
|
+
|
|
497
|
+
// --- doer_worklist_mode (optional, default 'resume') -------------------
|
|
498
|
+
// 'resume' walks a doer's worklist as a resumed sequence of dispatches;
|
|
499
|
+
// 'batch' hands the whole ordered worklist over in a single dispatch.
|
|
500
|
+
const doerWorklistMode = args.doer_worklist_mode === undefined ? 'resume' : args.doer_worklist_mode;
|
|
501
|
+
if (doerWorklistMode !== 'resume' && doerWorklistMode !== 'batch') {
|
|
502
|
+
throw new Error(`[Arg Contract] Invalid doer_worklist_mode "${doerWorklistMode}": must be 'resume' (default) or 'batch'.`);
|
|
503
|
+
}
|
|
504
|
+
|
|
505
|
+
// --- skip_regression (optional, default false) -------------------------
|
|
506
|
+
const skipRegression = args.skip_regression === undefined ? false : args.skip_regression;
|
|
507
|
+
if (typeof skipRegression !== 'boolean') {
|
|
508
|
+
throw new Error(`[Arg Contract] Invalid skip_regression "${skipRegression}": must be a boolean.`);
|
|
509
|
+
}
|
|
510
|
+
|
|
511
|
+
// --- resume_model_switch (optional, default false) ---------------------
|
|
512
|
+
const resumeModelSwitch = args.resume_model_switch === undefined ? false : args.resume_model_switch;
|
|
513
|
+
if (typeof resumeModelSwitch !== 'boolean') {
|
|
514
|
+
throw new Error(`[Arg Contract] Invalid resume_model_switch "${resumeModelSwitch}": must be a boolean.`);
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
// --- worklist_effort_budget (optional) ---------------------------------
|
|
518
|
+
if (args.worklist_effort_budget !== undefined
|
|
519
|
+
&& (typeof args.worklist_effort_budget !== 'number'
|
|
520
|
+
|| !Number.isFinite(args.worklist_effort_budget)
|
|
521
|
+
|| args.worklist_effort_budget <= 0)) {
|
|
522
|
+
throw new Error(`[Arg Contract] Invalid worklist_effort_budget "${args.worklist_effort_budget}": must be a positive finite number (effort points).`);
|
|
523
|
+
}
|
|
524
|
+
|
|
525
|
+
// --- usage_limit_max_wait_s (optional) ---------------------------------
|
|
526
|
+
// Total wall-clock seconds a single dispatch may stay paused across all
|
|
527
|
+
// usage-limit reprobes before the controller gives up
|
|
528
|
+
// (UsageLimitWaitExhaustedError -> typed sprint abort). Omitted, the
|
|
529
|
+
// controller uses role-policies.mjs's USAGE_LIMIT_BUDGET_DEFAULTS. Floor
|
|
530
|
+
// 60: a usage-limit window shorter than the minimum single wait is not a
|
|
531
|
+
// meaningful budget.
|
|
532
|
+
if (args.usage_limit_max_wait_s !== undefined
|
|
533
|
+
&& (typeof args.usage_limit_max_wait_s !== 'number'
|
|
534
|
+
|| !Number.isInteger(args.usage_limit_max_wait_s)
|
|
535
|
+
|| args.usage_limit_max_wait_s < 60)) {
|
|
536
|
+
throw new Error(`[Arg Contract] Invalid usage_limit_max_wait_s "${args.usage_limit_max_wait_s}": must be an integer >= 60 (seconds).`);
|
|
537
|
+
}
|
|
538
|
+
|
|
539
|
+
// --- usage_limit_max_reprobes (optional) -------------------------------
|
|
540
|
+
// Maximum reprobe attempts before the controller gives up, independent of
|
|
541
|
+
// elapsed wait. Omitted, the controller uses USAGE_LIMIT_BUDGET_DEFAULTS.
|
|
542
|
+
if (args.usage_limit_max_reprobes !== undefined
|
|
543
|
+
&& (typeof args.usage_limit_max_reprobes !== 'number'
|
|
544
|
+
|| !Number.isInteger(args.usage_limit_max_reprobes)
|
|
545
|
+
|| args.usage_limit_max_reprobes < 1)) {
|
|
546
|
+
throw new Error(`[Arg Contract] Invalid usage_limit_max_reprobes "${args.usage_limit_max_reprobes}": must be an integer >= 1.`);
|
|
547
|
+
}
|
|
548
|
+
|
|
549
|
+
// --- azdevops_pat_secret_name (optional) --------------------------------
|
|
550
|
+
// Override for the default Azure DevOps PAT secret name. When provided, this
|
|
551
|
+
// credential store entry name is used instead of the documented default
|
|
552
|
+
// (azdevops_pat). Validated as a credential-store name at contract-validation
|
|
553
|
+
// time, not mid-sprint, so invalid values fail fast and clearly.
|
|
554
|
+
if (args.azdevops_pat_secret_name !== undefined) {
|
|
555
|
+
validateCredentialStoreName(args.azdevops_pat_secret_name, 'azdevops_pat_secret_name');
|
|
556
|
+
}
|
|
557
|
+
|
|
558
|
+
// --- expect_beads (optional) ------------------------------------------
|
|
559
|
+
const expectBeads = validateExpectBeads(args.expect_beads);
|
|
560
|
+
|
|
561
|
+
// --- ci_gate: NOT WIRED (see the KNOWN_ARG_KEYS note; apra-fleet-dv8i) ---
|
|
562
|
+
// const ciGate = validateCiGate(args.ci_gate);
|
|
563
|
+
const ciGate = undefined;
|
|
564
|
+
|
|
565
|
+
return {
|
|
566
|
+
targetIssues,
|
|
567
|
+
members: args.members,
|
|
568
|
+
branch: args.branch,
|
|
569
|
+
baseBranch: args.base_branch,
|
|
570
|
+
goal,
|
|
571
|
+
maxCycles,
|
|
572
|
+
requirementsFile: args.requirementsFile,
|
|
573
|
+
roleMap: normalizedRoleMap,
|
|
574
|
+
roleMapWarnings,
|
|
575
|
+
budget: args.budget,
|
|
576
|
+
serviceUrl: args.serviceUrl,
|
|
577
|
+
runId: args.run_id,
|
|
578
|
+
assignee: args.assignee,
|
|
579
|
+
dispatchTimeoutS,
|
|
580
|
+
azdevopsPatSecretName: args.azdevops_pat_secret_name,
|
|
581
|
+
doerWorklistMode,
|
|
582
|
+
resumeModelSwitch,
|
|
583
|
+
skipRegression,
|
|
584
|
+
worklistEffortBudget: args.worklist_effort_budget,
|
|
585
|
+
usageLimitMaxWaitS: args.usage_limit_max_wait_s,
|
|
586
|
+
usageLimitMaxReprobes: args.usage_limit_max_reprobes,
|
|
587
|
+
expectBeads,
|
|
588
|
+
ciGate,
|
|
589
|
+
};
|
|
590
|
+
}
|