@apralabs/apra-fleet 0.4.3 → 0.4.5
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 +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- 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 +166 -5
- 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 +42 -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 +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- 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/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- 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 +62 -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 +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -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 +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- 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/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- 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 +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -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 +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -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 +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- 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 +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -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 +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -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 +115 -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 +352 -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 +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -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/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -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/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- 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 +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- 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/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- 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 +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -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 +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- 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 +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- 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 +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- 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 +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- 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 +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- 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/stop-prompt.js +3 -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 +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- 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 +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- 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/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- 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 +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- 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 +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- 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 +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -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-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -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 +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- 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 +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- 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-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- 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 +1896 -305
- 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 +454 -1
- 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 +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- 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 +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -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 +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -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 +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- 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/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- 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 +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -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 +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -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 +499 -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 +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.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/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
|
@@ -15,12 +15,20 @@ Check first: `curl -s -m 5 http://localhost:8787/api/sprints`. Connection
|
|
|
15
15
|
refused/timeout = not running. `{"sprints": [...]}` = already up, skip this.
|
|
16
16
|
|
|
17
17
|
Start it detached (it runs indefinitely -- exits only on `POST
|
|
18
|
-
/api/shutdown` or SIGINT/SIGTERM, never on its own)
|
|
18
|
+
/api/shutdown` or SIGINT/SIGTERM, never on its own). `apra-fleet install`
|
|
19
|
+
puts it under the user's home (needs Node.js 22.16+):
|
|
19
20
|
|
|
20
21
|
```bash
|
|
21
|
-
node
|
|
22
|
+
node ~/.apra-fleet/workflows/fleet-sprint/bin/serve.mjs # macOS / Linux
|
|
22
23
|
```
|
|
23
24
|
|
|
25
|
+
```powershell
|
|
26
|
+
node "$HOME\.apra-fleet\workflows\fleet-sprint\bin\serve.mjs" # Windows PowerShell
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
(From a source checkout of apra-fleet the same file is
|
|
30
|
+
`packages/apra-fleet-se/bin/serve.mjs`.)
|
|
31
|
+
|
|
24
32
|
Start it from INSIDE the target project (any folder under it): the
|
|
25
33
|
supervisor resolves the project's `.beads` by walking up from its cwd,
|
|
26
34
|
exactly like `bd`. Starting from elsewhere: pass `--beads-dir <project
|
|
@@ -31,20 +39,33 @@ top of the dashboard, and every sprint it launches is told to verify its
|
|
|
31
39
|
members against it. If NO `.beads` is found (or its probe fails) it still
|
|
32
40
|
starts, but logs `[supervisor] WARNING: no beads database found walking up
|
|
33
41
|
from <cwd> ... To fix: ...`, reports `beads: null` plus `beadsWarning` on
|
|
34
|
-
`/api/health`, shows an amber `Beads: NOT RESOLVED -- ...` header on the
|
|
35
|
-
dashboard
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
restart. `--port <n>`
|
|
42
|
+
`/api/health`, and shows an amber `Beads: NOT RESOLVED -- ...` header on the
|
|
43
|
+
dashboard. With NO `.beads` found it also has no backlog member, so every
|
|
44
|
+
launch answers `503` until you restart it from the right folder or with
|
|
45
|
+
`--beads-dir`. With a `.beads` found but a failed probe, launches still
|
|
46
|
+
work (without `--expect-beads`); fix the environment and hit
|
|
47
|
+
`GET /api/health?refresh=1` to recover without a restart. `--port <n>`
|
|
48
|
+
overrides the default (8787). Self-logs to
|
|
40
49
|
`<dataDir>/logs/supervisor.log` in addition to stdout.
|
|
41
50
|
|
|
51
|
+
**Backlog member.** At startup the supervisor ensures its own backlog
|
|
52
|
+
member: a local member with no LLM whose work folder is the project folder.
|
|
53
|
+
It adopts an LLM-less local member already registered for that folder (name
|
|
54
|
+
kept; adds the `backlog` tag and `unreservable` when missing), or registers
|
|
55
|
+
`backlog-<camelCaseFolderName>`. It logs `[supervisor] backlog member:
|
|
56
|
+
'<name>' (ready)`; `GET /api/health` reports `backlogMember: {status, name,
|
|
57
|
+
reason}`. It refuses to start (exit 1) if that name is taken by a member
|
|
58
|
+
for another folder. Fleet unreachable at startup is not fatal: status is
|
|
59
|
+
`degraded`, launches answer `503`, and a background retry fixes it.
|
|
60
|
+
|
|
42
61
|
Smoke test (a few seconds after launch -- give it time to bind):
|
|
43
62
|
```bash
|
|
44
63
|
curl -s -m 5 http://localhost:8787/api/sprints # expect {"sprints":[],...}
|
|
45
64
|
curl -s -m 5 http://localhost:8787/api/members # expect the registered fleet, non-empty
|
|
46
|
-
curl -s -m 5 http://localhost:8787/api/health # check `beads.dir`/`beads.prefix` is the intended tracker
|
|
65
|
+
curl -s -m 5 http://localhost:8787/api/health # check `beads.dir`/`beads.prefix` is the intended tracker, `backlogMember.status` is "ready"
|
|
47
66
|
```
|
|
67
|
+
(Windows PowerShell 5.1: `curl` is an alias of `Invoke-WebRequest`; use
|
|
68
|
+
`curl.exe` with the same arguments, or `Invoke-RestMethod <url>`.)
|
|
48
69
|
Both must succeed before treating the supervisor as up -- a bound port with
|
|
49
70
|
a 500 on `/api/members` still means something is broken. A wrong
|
|
50
71
|
`beads.prefix` means it was started from the wrong folder: stop it and
|
|
@@ -62,7 +83,7 @@ members run PowerShell, not POSIX.
|
|
|
62
83
|
### Graceful (preferred)
|
|
63
84
|
|
|
64
85
|
```bash
|
|
65
|
-
curl -s -X POST http://localhost:8787/api/shutdown
|
|
86
|
+
curl -s -X POST http://localhost:8787/api/shutdown -H "Content-Type: application/json"
|
|
66
87
|
```
|
|
67
88
|
Returns `{"status":"shutting-down"}` immediately; the process then finishes
|
|
68
89
|
tearing down every seam (ledger, watchdog, dashboard, etc) and exits on its
|
|
@@ -146,15 +167,24 @@ restart command exists:
|
|
|
146
167
|
run its smoke test (`GET /api/sprints`, `GET /api/members`) to confirm the
|
|
147
168
|
new process is actually serving before treating the restart as done.
|
|
148
169
|
|
|
170
|
+
**Upgrading apra-fleet.** A running supervisor keeps the code it started
|
|
171
|
+
with. Before upgrading, let running sprints finish (or stop them) and stop
|
|
172
|
+
the supervisor; start it again afterwards. A
|
|
173
|
+
supervisor started under 0.4.3 does not send the install's access secret, so
|
|
174
|
+
a 0.4.4 fleet server refuses its requests with HTTP 401. If a sprint was
|
|
175
|
+
still running during the upgrade, the first launch may 409 on its stale
|
|
176
|
+
member reservations -- see "Common launch-time crashes" below.
|
|
177
|
+
|
|
149
178
|
## Auto-start on login/boot
|
|
150
179
|
|
|
151
|
-
Instead of a human running `
|
|
180
|
+
Instead of a human running `serve.mjs` by hand each session, the
|
|
152
181
|
supervisor can be registered with the OS to start automatically on
|
|
153
182
|
login/boot. Resolve commands per the target member's own OS (`agent.os`) --
|
|
154
183
|
do not assume the orchestrator's shell; some members run PowerShell, not
|
|
155
|
-
POSIX.
|
|
156
|
-
|
|
157
|
-
|
|
184
|
+
POSIX. A service manager does not start in your project folder, so every
|
|
185
|
+
example passes `--beads-dir`. Substitute the real paths: the user's home
|
|
186
|
+
(`/Users/<user>`, `/home/<user>` or `C:\Users\<user>`) and the target
|
|
187
|
+
project folder (`/path/to/project` or `C:\path\to\project`). After registering (any OS),
|
|
158
188
|
run the same-process smoke test from section 0 above (`GET /api/sprints`,
|
|
159
189
|
`GET /api/members`) against the newly auto-started instance to confirm it is
|
|
160
190
|
actually serving, not just that the OS accepted the registration.
|
|
@@ -166,7 +196,7 @@ user's own session):
|
|
|
166
196
|
|
|
167
197
|
Register:
|
|
168
198
|
```cmd
|
|
169
|
-
schtasks /Create /TN "ApraFleetSupervisor" /TR "node C:\
|
|
199
|
+
schtasks /Create /TN "ApraFleetSupervisor" /TR "node C:\Users\<user>\.apra-fleet\workflows\fleet-sprint\bin\serve.mjs --beads-dir C:\path\to\project" /SC ONLOGON /RL LIMITED
|
|
170
200
|
```
|
|
171
201
|
De-register:
|
|
172
202
|
```cmd
|
|
@@ -182,8 +212,8 @@ in; requires NSSM installed and on PATH):
|
|
|
182
212
|
|
|
183
213
|
Register:
|
|
184
214
|
```cmd
|
|
185
|
-
nssm install ApraFleetSupervisor node "C:\
|
|
186
|
-
nssm set ApraFleetSupervisor AppDirectory "C:\path\to\
|
|
215
|
+
nssm install ApraFleetSupervisor node "C:\Users\<user>\.apra-fleet\workflows\fleet-sprint\bin\serve.mjs" --beads-dir "C:\path\to\project"
|
|
216
|
+
nssm set ApraFleetSupervisor AppDirectory "C:\path\to\project"
|
|
187
217
|
nssm start ApraFleetSupervisor
|
|
188
218
|
```
|
|
189
219
|
De-register:
|
|
@@ -206,7 +236,9 @@ Create `~/Library/LaunchAgents/com.apra-fleet.supervisor.plist`:
|
|
|
206
236
|
<key>ProgramArguments</key>
|
|
207
237
|
<array>
|
|
208
238
|
<string>/usr/local/bin/node</string>
|
|
209
|
-
<string>/
|
|
239
|
+
<string>/Users/<user>/.apra-fleet/workflows/fleet-sprint/bin/serve.mjs</string>
|
|
240
|
+
<string>--beads-dir</string>
|
|
241
|
+
<string>/path/to/project</string>
|
|
210
242
|
</array>
|
|
211
243
|
<key>RunAtLoad</key>
|
|
212
244
|
<true/>
|
|
@@ -246,9 +278,9 @@ Create `~/.config/systemd/user/apra-fleet-supervisor.service`:
|
|
|
246
278
|
Description=Apra Fleet supervisor
|
|
247
279
|
|
|
248
280
|
[Service]
|
|
249
|
-
ExecStart=/usr/bin/node /
|
|
281
|
+
ExecStart=/usr/bin/node /home/<user>/.apra-fleet/workflows/fleet-sprint/bin/serve.mjs --beads-dir /path/to/project
|
|
250
282
|
Restart=no
|
|
251
|
-
WorkingDirectory=/path/to/
|
|
283
|
+
WorkingDirectory=/path/to/project
|
|
252
284
|
|
|
253
285
|
[Install]
|
|
254
286
|
WantedBy=default.target
|
|
@@ -279,9 +311,13 @@ start with no login (`loginctl enable-linger <username>`).
|
|
|
279
311
|
`bd dolt commit` then `bd dolt push`. Members pull their own copy; a
|
|
280
312
|
sprint launched before the push works from stale scope.
|
|
281
313
|
2. Check no conflicting sprint is already running: `GET /api/sprints`.
|
|
282
|
-
3. Multi-member sprints
|
|
283
|
-
launch
|
|
284
|
-
member
|
|
314
|
+
3. Multi-member sprints align their members to the sprint base
|
|
315
|
+
automatically at launch (WIP preserved in a named stash, one `[Align]`
|
|
316
|
+
line per member) -- do not align members by hand. The launch refuses only
|
|
317
|
+
for an unreachable member, differing origin URLs, a base missing on
|
|
318
|
+
origin, a fetch auth failure or a diverged sprint branch, naming the
|
|
319
|
+
member, cause and fix. Don't guess a member list -- ask, or default to
|
|
320
|
+
one.
|
|
285
321
|
|
|
286
322
|
## 2. Start a sprint
|
|
287
323
|
|
|
@@ -302,18 +338,25 @@ Field names, exactly as the API expects them:
|
|
|
302
338
|
| Field | Required | Notes |
|
|
303
339
|
|---|---|---|
|
|
304
340
|
| `issue` | yes | comma-separated bead root IDs (parent/epic OR a standalone leaf bead). Alias: `target_issue`. |
|
|
305
|
-
| `branch` | yes | created from `base` if it doesn't exist yet. |
|
|
341
|
+
| `branch` | yes | created from `base` if it doesn't exist yet. Must differ from `base` (an equal pair is a 400; case and `origin/`/`refs/heads/` prefixes are ignored). |
|
|
306
342
|
| `base` | yes | alias: `base_branch`. This is what the sprint branches FROM -- pass the branch you actually want, not always `main`. |
|
|
307
343
|
| `members` | yes | array of registered member names. One member = safest default. |
|
|
308
344
|
| `goal` | no | `P1`, `P1/P2` (default), or `P1/P2/P3`. |
|
|
309
345
|
| `maxCycles` | no | default 5. |
|
|
310
346
|
| `allowMissingMembers` | no | bool. |
|
|
311
|
-
| `requirementsFile` | no | path. |
|
|
312
|
-
| `roleMap` | no | `{"doer":["m1","m2"], "reviewer":["m3"]}`. |
|
|
347
|
+
| `requirementsFile` | no | path on the supervisor's machine; a relative path resolves against the supervisor's project folder. Not found = a run-log warning only, so prefer an absolute path. |
|
|
348
|
+
| `roleMap` | no | `{"doer":["m1","m2"], "reviewer":["m3"]}`. Leave out `backlog`: the supervisor injects its own backlog member; naming any other member there is a 400. `orchestrator` is the deprecated alias of `backlog` (removed in v0.5). |
|
|
313
349
|
| `budget` | no | USD cap. |
|
|
350
|
+
| `phases` | no | `{"regression": "skip"}` skips the regression pass (`"run"` is the default). Any other key or value is a 400. |
|
|
351
|
+
| `kbDemotionLoop` | no | `"on"` (default) or `"off"`: the reviewer KB demotion loop switch, forwarded as `--kb-demotion-loop`. Any other value is a 400. |
|
|
314
352
|
| `overrideRelaunchGate` | no | bool. See below. |
|
|
315
353
|
|
|
316
|
-
Response has `sprintId`, `pid`, `port` (its own dashboard), `logPath
|
|
354
|
+
Response has `sprintId`, `pid`, `port` (its own dashboard), `logPath`, and
|
|
355
|
+
`warnings` (e.g. the deprecation notice when `roleMap.orchestrator` was
|
|
356
|
+
used). A `503` means nothing was launched: the backlog member is not ready,
|
|
357
|
+
the fleet member list could not be read, the fleet server was stopped by its
|
|
358
|
+
user (`apra-fleet stop`), or the beads could not be verified fresh -- the
|
|
359
|
+
`error` says which.
|
|
317
360
|
**A 201 response does NOT mean the sprint is alive** -- it can crash in the
|
|
318
361
|
first few seconds (bad topology, bad member, etc). Always verify (step 3)
|
|
319
362
|
a few seconds after launch.
|
|
@@ -337,7 +380,7 @@ Sprint-scoped dashboard (per-role activity, bead DAG, cost, PR link):
|
|
|
337
380
|
## 4. Kill a sprint
|
|
338
381
|
|
|
339
382
|
```bash
|
|
340
|
-
curl -s -X POST http://localhost:8787/api/sprints/<sprintId>/stop
|
|
383
|
+
curl -s -X POST http://localhost:8787/api/sprints/<sprintId>/stop -H "Content-Type: application/json"
|
|
341
384
|
```
|
|
342
385
|
|
|
343
386
|
## Relaunch gate
|
|
@@ -350,13 +393,25 @@ only use it once you know why the prior run died.
|
|
|
350
393
|
|
|
351
394
|
## Common launch-time crashes
|
|
352
395
|
|
|
353
|
-
- **Topology
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
396
|
+
- **Topology refusal**: members are aligned automatically (section 1), so
|
|
397
|
+
this names what could not be reconciled -- an unreachable member,
|
|
398
|
+
differing origin URLs, a base missing on origin, a fetch auth failure or
|
|
399
|
+
a diverged sprint branch. Fix what it names and relaunch; do not align
|
|
400
|
+
members by hand.
|
|
401
|
+
- **Beads identity** (`BeadsIdentityError`, before any dispatch): `bd`
|
|
402
|
+
missing on a member, a member resolving to a different beads project, or
|
|
403
|
+
a failed automatic beads set-up on a beads-reading member. The message
|
|
404
|
+
names the member and the fix.
|
|
357
405
|
- **Unregistered member**: `GET /api/members` to see valid names.
|
|
358
406
|
- **Stale LLM auth**: dispatch fails with `empty_response`. Re-run
|
|
359
407
|
`provision_llm_auth` for that member.
|
|
408
|
+
- **Stale member reservation** (`409 member overlap rejects launch: sprint
|
|
409
|
+
'<id or branch>' already claims [...]` while `GET /api/sprints` shows no
|
|
410
|
+
such sprint): a sprint died uncleanly (crash, or an upgrade with
|
|
411
|
+
`--ignore-running-sprints`) and left its members reserved on the fleet
|
|
412
|
+
server. Clear each listed member with the fleet MCP tool
|
|
413
|
+
`member_reservation {member_name: "<member>", action: "force_release"}`
|
|
414
|
+
(no supervisor HTTP route does this), then relaunch.
|
|
360
415
|
|
|
361
416
|
## Member layout: isolate deploy/test roles from dev roles
|
|
362
417
|
|
|
@@ -6,7 +6,10 @@
|
|
|
6
6
|
// unchanged. This is a move-only extraction: behaviour, validation order and
|
|
7
7
|
// error message text are all deliberately unchanged from the pre-move code.
|
|
8
8
|
import { normalizeRole, validateCredentialStoreName } from './contracts.mjs';
|
|
9
|
+
import { ROLE_KB_MAINTAINER } from './kb-maintainer.mjs';
|
|
9
10
|
import { parseExpectedIdentity } from './beads-identity.mjs';
|
|
11
|
+
import { resolveBacklogRoleAlias } from './backlog-role.mjs';
|
|
12
|
+
import { validateDecisionNotify } from './decision-notify.mjs';
|
|
10
13
|
|
|
11
14
|
// ---------------------------------------------------------------------------
|
|
12
15
|
// CLI -> runner argument contract
|
|
@@ -33,7 +36,7 @@ const GOAL_PATTERN = /^P[1-3](\/P[1-3]){0,2}$/;
|
|
|
33
36
|
|
|
34
37
|
const KNOWN_ARG_KEYS = new Set([
|
|
35
38
|
'target_issues', 'target_issue', 'members', 'branch', 'base_branch',
|
|
36
|
-
'goal', 'max_cycles', 'requirementsFile', 'roleMap', 'budget',
|
|
39
|
+
'goal', 'max_cycles', 'requirementsFile', 'roleMap', 'roleMapWarnings', 'budget',
|
|
37
40
|
// Per-dispatch time budget (timeout_s == max_total_s at every dispatch
|
|
38
41
|
// site; integ ceiling = 2x), bounding the cost of a hung dispatch.
|
|
39
42
|
'dispatch_timeout_s',
|
|
@@ -91,6 +94,15 @@ const KNOWN_ARG_KEYS = new Set([
|
|
|
91
94
|
// itself -- see docs/fleet-sprint-cli-contract.md's "Dormant argument
|
|
92
95
|
// audit" section for the full record.
|
|
93
96
|
'assignee',
|
|
97
|
+
// Explicitly skip the once-per-sprint regression pass (launch option:
|
|
98
|
+
// the CLI's --skip-regression, the supervisor's phases.regression:"skip").
|
|
99
|
+
// Never silent: the engine logs it and the sprint report and PR body say
|
|
100
|
+
// "skipped by launch option". The integration-test phase is unaffected.
|
|
101
|
+
'skip_regression',
|
|
102
|
+
// Reviewer KB demotion loop switch: 'on' (default when absent) or 'off'.
|
|
103
|
+
// Off: the reviewer is offered no demotion candidates and no kb_demote is
|
|
104
|
+
// issued. Any other value is rejected loudly (never a silent fallback).
|
|
105
|
+
'kb_demotion_loop',
|
|
94
106
|
// Multi-streak worklist dispatch mode when a develop round has more ready
|
|
95
107
|
// streaks than doers. 'resume' (default): per-streak dispatches that resume
|
|
96
108
|
// the SAME doer session by explicit session id (warm-context carryover,
|
|
@@ -126,6 +138,15 @@ const KNOWN_ARG_KEYS = new Set([
|
|
|
126
138
|
// formula units). Default DEFAULT_EFFORT_THRESHOLD.
|
|
127
139
|
// No CLI flag sets this today; only test/programmatic callers pass it.
|
|
128
140
|
'worklist_effort_budget',
|
|
141
|
+
// Engine CI gate arg -- DELIBERATELY NOT WIRED (2026-10-01). ci-gate.mjs
|
|
142
|
+
// runs CI per reviewer dispatch and hands the result to the reviewer; the
|
|
143
|
+
// agreed direction is the opposite (CI never blocks or reaches doer/
|
|
144
|
+
// reviewer loops; the integ-test phase owns CI via one reopenable bead;
|
|
145
|
+
// per-push vs end-of-cycle triggering per project). Until the "fleet-sprint
|
|
146
|
+
// must also utilize CI as a resource for quality" epic (apra-fleet-dv8i)
|
|
147
|
+
// designs that flow, ci_gate is not a known arg, so passing it fails loudly
|
|
148
|
+
// as an unknown arg. The gate module stays in place, unconfigured.
|
|
149
|
+
// 'ci_gate',
|
|
129
150
|
// An optional live `(name, args) => Promise<any>` MCP tool-call function,
|
|
130
151
|
// wired by bin/cli.mjs from its already-connected `mcpClient.callTool`.
|
|
131
152
|
// Consumed by createMemberSessionGuard() to call the fleet's own
|
|
@@ -144,8 +165,13 @@ const KNOWN_ARG_KEYS = new Set([
|
|
|
144
165
|
// `--expect-beads`, env fallback FLEET_SPRINT_EXPECT_BEADS, or an already
|
|
145
166
|
// parsed record from a programmatic caller). Consumed by the
|
|
146
167
|
// verifyBeadsIdentity precondition (beads-identity-check.mjs); absent, the
|
|
147
|
-
//
|
|
168
|
+
// backlog member's own probed identity becomes the expectation.
|
|
148
169
|
'expect_beads',
|
|
170
|
+
// Explicit operator-notification config for a pending NEEDS-DECISION
|
|
171
|
+
// (decision-notify.mjs): JSON string or object { message_member, email,
|
|
172
|
+
// dashboard_url, timeout_s }. Absent: each decision logs a loud
|
|
173
|
+
// 'no channel configured' notification failure; the sprint is unaffected.
|
|
174
|
+
'decision_notify',
|
|
149
175
|
]);
|
|
150
176
|
|
|
151
177
|
/**
|
|
@@ -170,6 +196,47 @@ export function validateExpectBeads(raw) {
|
|
|
170
196
|
return parsed;
|
|
171
197
|
}
|
|
172
198
|
|
|
199
|
+
/** Default CI gate timeout (seconds) when ci_gate omits timeout_s. */
|
|
200
|
+
export const DEFAULT_CI_GATE_TIMEOUT_S = 3600;
|
|
201
|
+
// A workflow file name ("ci.yml") or numeric workflow id -- interpolated into
|
|
202
|
+
// a provider REST path, so restrictive by design.
|
|
203
|
+
const CI_GATE_WORKFLOW_PATTERN = /^[A-Za-z0-9._-]+$/;
|
|
204
|
+
|
|
205
|
+
/**
|
|
206
|
+
* Validates the optional ci_gate arg: { workflow: string, timeout_s?: positive
|
|
207
|
+
* integer (default 3600) }. Accepts the object, or its JSON string form (the
|
|
208
|
+
* CLI forwards --ci-gate verbatim). Absent -> undefined (gate not configured).
|
|
209
|
+
* @param {unknown} raw
|
|
210
|
+
* @returns {{ workflow: string, timeoutS: number }|undefined}
|
|
211
|
+
*/
|
|
212
|
+
export function validateCiGate(raw) {
|
|
213
|
+
if (raw === undefined || raw === null || raw === '') return undefined;
|
|
214
|
+
let value = raw;
|
|
215
|
+
if (typeof raw === 'string') {
|
|
216
|
+
try {
|
|
217
|
+
value = JSON.parse(raw);
|
|
218
|
+
} catch {
|
|
219
|
+
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>}.`);
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
if (!value || typeof value !== 'object' || Array.isArray(value)) {
|
|
223
|
+
throw new Error('[Arg Contract] Invalid ci_gate: must be an object {"workflow": "<workflow file name or id>", "timeout_s": <positive integer, default 3600>}.');
|
|
224
|
+
}
|
|
225
|
+
const unknown = Object.keys(value).filter((k) => k !== 'workflow' && k !== 'timeout_s');
|
|
226
|
+
if (unknown.length > 0) {
|
|
227
|
+
throw new Error(`[Arg Contract] Invalid ci_gate: unknown key(s) ${unknown.join(', ')}. Known keys: workflow, timeout_s.`);
|
|
228
|
+
}
|
|
229
|
+
const workflow = value.workflow;
|
|
230
|
+
if (typeof workflow !== 'string' || workflow.length === 0 || !CI_GATE_WORKFLOW_PATTERN.test(workflow)) {
|
|
231
|
+
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}.`);
|
|
232
|
+
}
|
|
233
|
+
const timeoutS = value.timeout_s === undefined ? DEFAULT_CI_GATE_TIMEOUT_S : value.timeout_s;
|
|
234
|
+
if (typeof timeoutS !== 'number' || !Number.isInteger(timeoutS) || timeoutS <= 0) {
|
|
235
|
+
throw new Error(`[Arg Contract] Invalid ci_gate.timeout_s "${timeoutS}": must be a positive integer (seconds).`);
|
|
236
|
+
}
|
|
237
|
+
return { workflow, timeoutS };
|
|
238
|
+
}
|
|
239
|
+
|
|
173
240
|
/**
|
|
174
241
|
* Validates a single issue id against the shell-injection-safe pattern.
|
|
175
242
|
* Throws with a clear message on rejection.
|
|
@@ -198,6 +265,36 @@ export function validateBranchName(name, label) {
|
|
|
198
265
|
return name;
|
|
199
266
|
}
|
|
200
267
|
|
|
268
|
+
// Strip the ref prefixes a caller may legitimately pass for the same branch
|
|
269
|
+
// (refs/heads/<b>, origin/<b>, refs/remotes/origin/<b>) so "main",
|
|
270
|
+
// "origin/main" and "refs/heads/main" all compare equal. Compared
|
|
271
|
+
// case-insensitively: a pair differing only in case is never a legitimate
|
|
272
|
+
// sprint (case-insensitive filesystems and hosts treat them as one branch).
|
|
273
|
+
function normalizeBranchForCompare(name) {
|
|
274
|
+
let n = String(name).toLowerCase();
|
|
275
|
+
for (const prefix of ['refs/remotes/origin/', 'refs/heads/', 'origin/']) {
|
|
276
|
+
if (n.startsWith(prefix)) { n = n.slice(prefix.length); break; }
|
|
277
|
+
}
|
|
278
|
+
return n;
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
/**
|
|
282
|
+
* Rejects a sprint whose working branch is its base branch (GitHub #613):
|
|
283
|
+
* the review range base..branch would be empty, doer commits would land
|
|
284
|
+
* directly on the base, and the closing PR could never be opened (head ==
|
|
285
|
+
* base). Shared by validateArgs, bin/cli.mjs and the supervisor launch API so
|
|
286
|
+
* every entry point refuses the same pairs with the same message.
|
|
287
|
+
*
|
|
288
|
+
* @param {string} branch
|
|
289
|
+
* @param {string} base
|
|
290
|
+
*/
|
|
291
|
+
export function validateBranchPair(branch, base) {
|
|
292
|
+
if (typeof branch !== 'string' || typeof base !== 'string') return;
|
|
293
|
+
if (normalizeBranchForCompare(branch) === normalizeBranchForCompare(base)) {
|
|
294
|
+
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).`);
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
|
|
201
298
|
/**
|
|
202
299
|
* Validates and normalizes the args object passed into main(context).
|
|
203
300
|
* Rejects unknown keys and missing/malformed required keys loudly.
|
|
@@ -254,6 +351,7 @@ export function validateArgs(args) {
|
|
|
254
351
|
throw new Error('[Arg Contract] Missing required arg: base_branch (branch the sprint branch is created from and the PR targets).');
|
|
255
352
|
}
|
|
256
353
|
validateBranchName(args.base_branch, 'base_branch');
|
|
354
|
+
validateBranchPair(args.branch, args.base_branch);
|
|
257
355
|
|
|
258
356
|
// --- goal (optional, default 'P1/P2'; the priority band this sprint aims
|
|
259
357
|
// to clear, consumed by the exit-condition logic) ---
|
|
@@ -297,6 +395,41 @@ export function validateArgs(args) {
|
|
|
297
395
|
}
|
|
298
396
|
normalizedRoleMap[key] = value;
|
|
299
397
|
}
|
|
398
|
+
// kb_maintainer is an accepted roleMap key but NOT a dispatched role:
|
|
399
|
+
// it names the member(s) that receive every KB write for their own
|
|
400
|
+
// repository (kb-maintainer.mjs). Its members must be sprint members,
|
|
401
|
+
// since selection probes them through the sprint's member access.
|
|
402
|
+
if (Object.prototype.hasOwnProperty.call(normalizedRoleMap, ROLE_KB_MAINTAINER)) {
|
|
403
|
+
const list = normalizedRoleMap[ROLE_KB_MAINTAINER];
|
|
404
|
+
if (!Array.isArray(list) || list.some((m) => typeof m !== 'string' || m.length === 0)) {
|
|
405
|
+
throw new Error(`[Arg Contract] Invalid roleMap.${ROLE_KB_MAINTAINER}: must be an array of non-empty member names.`);
|
|
406
|
+
}
|
|
407
|
+
const stray = list.filter((m) => !args.members.includes(m));
|
|
408
|
+
if (stray.length > 0) {
|
|
409
|
+
const quoted = stray.map((m) => '"' + m + '"').join(', ');
|
|
410
|
+
throw new Error(`[Arg Contract] Invalid roleMap.${ROLE_KB_MAINTAINER}: ${quoted} not in members.`);
|
|
411
|
+
}
|
|
412
|
+
}
|
|
413
|
+
}
|
|
414
|
+
// Backlog-role alias: the deprecated 'orchestrator' key is folded into
|
|
415
|
+
// 'backlog' here (downstream readers only ever see 'backlog'); a conflict
|
|
416
|
+
// is an arg-contract error. Warnings -- plus any the CLI already collected
|
|
417
|
+
// (args.roleMapWarnings, since the CLI rewrites the key before the runner
|
|
418
|
+
// sees it) -- are surfaced on the validated object for the runner to log.
|
|
419
|
+
const roleMapWarnings = [];
|
|
420
|
+
if (normalizedRoleMap !== undefined) {
|
|
421
|
+
try {
|
|
422
|
+
const resolved = resolveBacklogRoleAlias(normalizedRoleMap);
|
|
423
|
+
normalizedRoleMap = resolved.roleMap;
|
|
424
|
+
roleMapWarnings.push(...resolved.warnings);
|
|
425
|
+
} catch (err) {
|
|
426
|
+
throw new Error(`[Arg Contract] Invalid roleMap: ${err.message}`);
|
|
427
|
+
}
|
|
428
|
+
}
|
|
429
|
+
if (Array.isArray(args.roleMapWarnings)) {
|
|
430
|
+
for (const w of args.roleMapWarnings) {
|
|
431
|
+
if (typeof w === 'string' && !roleMapWarnings.includes(w)) roleMapWarnings.push(w);
|
|
432
|
+
}
|
|
300
433
|
}
|
|
301
434
|
|
|
302
435
|
// --- budget (optional) -----------------------------------------------
|
|
@@ -379,6 +512,18 @@ export function validateArgs(args) {
|
|
|
379
512
|
throw new Error(`[Arg Contract] Invalid doer_worklist_mode "${doerWorklistMode}": must be 'resume' (default) or 'batch'.`);
|
|
380
513
|
}
|
|
381
514
|
|
|
515
|
+
// --- kb_demotion_loop (optional, default 'on') ---------------------------
|
|
516
|
+
const kbDemotionLoop = args.kb_demotion_loop === undefined ? 'on' : args.kb_demotion_loop;
|
|
517
|
+
if (kbDemotionLoop !== 'on' && kbDemotionLoop !== 'off') {
|
|
518
|
+
throw new Error(`[Arg Contract] Invalid kb_demotion_loop ${JSON.stringify(kbDemotionLoop)}: must be 'on' (default) or 'off'.`);
|
|
519
|
+
}
|
|
520
|
+
|
|
521
|
+
// --- skip_regression (optional, default false) -------------------------
|
|
522
|
+
const skipRegression = args.skip_regression === undefined ? false : args.skip_regression;
|
|
523
|
+
if (typeof skipRegression !== 'boolean') {
|
|
524
|
+
throw new Error(`[Arg Contract] Invalid skip_regression "${skipRegression}": must be a boolean.`);
|
|
525
|
+
}
|
|
526
|
+
|
|
382
527
|
// --- resume_model_switch (optional, default false) ---------------------
|
|
383
528
|
const resumeModelSwitch = args.resume_model_switch === undefined ? false : args.resume_model_switch;
|
|
384
529
|
if (typeof resumeModelSwitch !== 'boolean') {
|
|
@@ -429,6 +574,12 @@ export function validateArgs(args) {
|
|
|
429
574
|
// --- expect_beads (optional) ------------------------------------------
|
|
430
575
|
const expectBeads = validateExpectBeads(args.expect_beads);
|
|
431
576
|
|
|
577
|
+
const decisionNotify = validateDecisionNotify(args.decision_notify);
|
|
578
|
+
|
|
579
|
+
// --- ci_gate: NOT WIRED (see the KNOWN_ARG_KEYS note; apra-fleet-dv8i) ---
|
|
580
|
+
// const ciGate = validateCiGate(args.ci_gate);
|
|
581
|
+
const ciGate = undefined;
|
|
582
|
+
|
|
432
583
|
return {
|
|
433
584
|
targetIssues,
|
|
434
585
|
members: args.members,
|
|
@@ -438,6 +589,7 @@ export function validateArgs(args) {
|
|
|
438
589
|
maxCycles,
|
|
439
590
|
requirementsFile: args.requirementsFile,
|
|
440
591
|
roleMap: normalizedRoleMap,
|
|
592
|
+
roleMapWarnings,
|
|
441
593
|
budget: args.budget,
|
|
442
594
|
serviceUrl: args.serviceUrl,
|
|
443
595
|
runId: args.run_id,
|
|
@@ -446,9 +598,13 @@ export function validateArgs(args) {
|
|
|
446
598
|
azdevopsPatSecretName: args.azdevops_pat_secret_name,
|
|
447
599
|
doerWorklistMode,
|
|
448
600
|
resumeModelSwitch,
|
|
601
|
+
skipRegression,
|
|
602
|
+
kbDemotionLoop,
|
|
449
603
|
worklistEffortBudget: args.worklist_effort_budget,
|
|
450
604
|
usageLimitMaxWaitS: args.usage_limit_max_wait_s,
|
|
451
605
|
usageLimitMaxReprobes: args.usage_limit_max_reprobes,
|
|
452
606
|
expectBeads,
|
|
607
|
+
decisionNotify,
|
|
608
|
+
ciGate,
|
|
453
609
|
};
|
|
454
610
|
}
|