@apralabs/apra-fleet 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +53 -5
- package/dist/tools/check-status.js +210 -53
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +30 -10
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -4,7 +4,8 @@ Reconcile a warm local KB against a merged bible after two or more branches
|
|
|
4
4
|
land -- absorb the incoming knowledge, revive entries whose basis matches
|
|
5
5
|
the merged worktree again, mechanically settle contradictions a file hash
|
|
6
6
|
can decide, and dispatch a reconciler agent for the rest. Ends with the
|
|
7
|
-
canonical bible re-exported
|
|
7
|
+
canonical bible re-exported: confirmed entries whose cited files still match
|
|
8
|
+
their hash basis are added, so the merged branch's bible gains the merged truth.
|
|
8
9
|
|
|
9
10
|
## When to run
|
|
10
11
|
|
|
@@ -28,19 +29,26 @@ already-exposed `kb_promote` surface (which can walk any entry
|
|
|
28
29
|
way -- a bible can never smuggle an active directive; activation stays
|
|
29
30
|
CLI-only (`apra-fleet kb approve-directive`).
|
|
30
31
|
|
|
32
|
+
Run every step of this command from the operator's own session, not a fleet
|
|
33
|
+
member session: a member session without the engine's kb_maintainer grant is
|
|
34
|
+
refused an explicit `kb_import` path (`E-KB-MAINTAINER-REQUIRED`) and is not
|
|
35
|
+
served `kb_reconcile_prefilter`, `kb_resolve_contradiction` or `kb_export`.
|
|
36
|
+
|
|
31
37
|
## Steps
|
|
32
38
|
|
|
33
39
|
### Step 1: Import the merged bible
|
|
34
40
|
|
|
35
41
|
```
|
|
36
|
-
kb_import({
|
|
42
|
+
kb_import({ path: "<merged worktree path>/.fleet/kb-canonical.json" })
|
|
37
43
|
```
|
|
38
44
|
|
|
39
|
-
or the CLI equivalent, `apra-fleet kb import --
|
|
40
|
-
running this post-merge by hand.
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
45
|
+
or the CLI equivalent, `apra-fleet kb import --path <file>`, for a human
|
|
46
|
+
running this post-merge by hand. `path` names the bible FILE only: kb tools
|
|
47
|
+
take no repo/scope argument and always write the calling session's own KB (a
|
|
48
|
+
member session uses its registered work folder; any other session the fleet
|
|
49
|
+
server's working folder). Omitting `path` resolves
|
|
50
|
+
`<own folder>/.fleet/kb-canonical.json` (the trusted channel); a bible from
|
|
51
|
+
anywhere else is caller-asserted trust (see above).
|
|
44
52
|
|
|
45
53
|
Report: `{ imported, skipped, linked, flagged, sweep }`. `kb_import`
|
|
46
54
|
already runs a freshness sweep internally at the end of its own run, scoped
|
|
@@ -92,11 +100,13 @@ Report: `{ pairs, resolved, left_for_agent, skipped_directive }`.
|
|
|
92
100
|
|
|
93
101
|
If `left_for_agent` is non-empty, dispatch the `kb-reconciler` agent
|
|
94
102
|
(`agents/kb-reconciler.md`, model tier cheap/standard)
|
|
95
|
-
with that array
|
|
103
|
+
with that array, as a subagent of THIS session -- never on a fleet member: a
|
|
104
|
+
member session is not served `kb_resolve_contradiction` or `kb_export`, so the
|
|
105
|
+
agent would stop at its tool check. It reads the MERGED code via `code_context`/`code_impact`/
|
|
96
106
|
`code_query` (never Glob/Grep) for each remaining pair, resolves what the
|
|
97
107
|
code decides via `kb_resolve_contradiction`, falls back to a trust-tier
|
|
98
108
|
tiebreak (`CONFIRMED > INFERRED > UNVERIFIED`) when the code is silent, and
|
|
99
|
-
leaves genuinely undecidable pairs flagged for `/pm kb-review`. Active
|
|
109
|
+
leaves genuinely undecidable pairs flagged for `/pm kb-review`. Any `kb_query`/`kb_list` lookup of a pair's entries must pass an explicit `confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"]` list: the read tools default to CONFIRMED undisputed entries only, and a disputed or unpromoted side would otherwise be invisible (`kb_query({ flagged_only: true })` is exempt). Active
|
|
100
110
|
user-directives are NEVER auto-retired. See `agents/kb-reconciler.md` for the
|
|
101
111
|
full process and the single-write-path rule.
|
|
102
112
|
|
|
@@ -108,11 +118,16 @@ If `left_for_agent` is empty, skip straight to Step 5.
|
|
|
108
118
|
kb_export()
|
|
109
119
|
```
|
|
110
120
|
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
121
|
+
ADDS to `.fleet/kb-canonical.json` every live `CONFIRMED` project entry not
|
|
122
|
+
already in it whose cited files still match its recorded hash basis -- which
|
|
123
|
+
includes the mechanical and agent-resolved winners -- and auto-commits it
|
|
124
|
+
(pathspec-only, identity `pm-kb`, non-fatal on any git failure). This is
|
|
125
|
+
existing `kb_export` machinery; no new commit step is needed here. Push is
|
|
126
|
+
not automatic; it rides the normal sprint push cadence.
|
|
127
|
+
|
|
128
|
+
The export never removes or rewrites an entry already in the bible: a
|
|
129
|
+
superseded loser, or an entry later retired, stays there after re-export and
|
|
130
|
+
must be removed by hand.
|
|
116
131
|
|
|
117
132
|
## Report
|
|
118
133
|
|
|
@@ -21,6 +21,7 @@ Call `kb_query(flagged_only=true)`.
|
|
|
21
21
|
|
|
22
22
|
- If the response says "No flagged contradictions found -- KB is clean.", report that to the user and stop.
|
|
23
23
|
- Otherwise, collect all returned entries.
|
|
24
|
+
- `flagged_only` is exempt from the default CONFIRMED-only read filter, so it returns disputed entries of every tier. If you need to look up any other entry (for example a counterpart that is not in the flagged list), a plain `kb_query`/`kb_list` returns only CONFIRMED undisputed entries by default -- pass an explicit `confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"]` list to see the rest.
|
|
24
25
|
|
|
25
26
|
### Step 2: Group into contradiction pairs
|
|
26
27
|
|
|
@@ -14,7 +14,7 @@ setup -> requirements -> design ->
|
|
|
14
14
|
Develop (doer-review loop: bd ready -> claim -> close, to a clean APPROVED)
|
|
15
15
|
Test (deploy + integration tests, if deploy.md + playbook present)
|
|
16
16
|
goal check -> exit | next cycle
|
|
17
|
-
Harvest (CI watch -> final review -> docs
|
|
17
|
+
Harvest (CI watch -> final review -> docs -> complete -> PR)
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
State lives in **beads** (all task state -- the plan, what is open/in-progress/closed,
|
|
@@ -182,7 +182,7 @@ calling the sprint done.**
|
|
|
182
182
|
MANDATORY CHECKLIST -- verify each before exiting:
|
|
183
183
|
[ ] 1. CI watch dispatched
|
|
184
184
|
[ ] 2. Final reviewer dispatched + APPROVED
|
|
185
|
-
[ ] 3. Harvester dispatched (docs/
|
|
185
|
+
[ ] 3. Harvester dispatched (docs/ in branch diff)
|
|
186
186
|
[ ] 4. Cost analysis committed (or skipped if no Node.js)
|
|
187
187
|
[ ] 5. Sprint root + delivered issues closed
|
|
188
188
|
[ ] 6. bd export committed to branch (.beads/*.jsonl updated)
|
|
@@ -200,12 +200,12 @@ MANDATORY CHECKLIST -- verify each before exiting:
|
|
|
200
200
|
and flag the user. `APPROVED` -> continue.
|
|
201
201
|
3. **Documentation harvest** -- dispatch `harvester` to extract long-term knowledge
|
|
202
202
|
from requirements.md, design.md, and the beads task tree (`bd list --tree
|
|
203
|
-
<sprint-id>`, `bd show <id>`) into `docs/` and update
|
|
203
|
+
<sprint-id>`, `bd show <id>`) into `docs/` and update README.
|
|
204
204
|
Structure inside `docs/` is content-driven (e.g. `docs/architecture.md`,
|
|
205
205
|
`docs/features/<name>.md`). Extract: architecture decisions, feature design, key
|
|
206
206
|
trade-offs, API contracts. Do NOT extract: task lists, code-line references, debug
|
|
207
|
-
notes, implementation steps. The harvester commits the `docs/`
|
|
208
|
-
|
|
207
|
+
notes, implementation steps. The harvester commits the `docs/` output to the
|
|
208
|
+
branch.
|
|
209
209
|
4. **Cost analysis and calibration update** (if Node.js available) -- run
|
|
210
210
|
`computeSprintAnalysis`, `buildSprintSummary`, and `computeUpdatedCalibration`
|
|
211
211
|
from `<skillDir>/cost.js` (the extracted module installed alongside this skill on
|
|
@@ -7,17 +7,19 @@ import { existsSync, realpathSync } from 'node:fs';
|
|
|
7
7
|
import { FleetWorkflow } from '@apralabs/apra-fleet-workflow';
|
|
8
8
|
import { WorkflowEngine } from '@apralabs/apra-fleet-workflow/engine';
|
|
9
9
|
import { createDashboardViewer } from '@apralabs/apra-fleet-workflow/viewer';
|
|
10
|
-
import { StreamableHttpTransport } from '@apralabs/apra-fleet-client/transport';
|
|
11
10
|
import { McpClient } from '@apralabs/apra-fleet-client/client';
|
|
12
11
|
import { ApraFleet } from '@apralabs/apra-fleet-client';
|
|
13
12
|
import {
|
|
14
13
|
resolveFleetServerCommand as sharedResolveFleetServerCommand,
|
|
15
14
|
resolveFleetServerConnection as sharedResolveFleetServerConnection,
|
|
15
|
+
createFleetHttpTransport,
|
|
16
16
|
getServerInfoPath,
|
|
17
17
|
} from '@apralabs/apra-fleet-client/server-resolution';
|
|
18
|
-
import { beadsExtension } from '../fleet-sprint/viewer-extensions.mjs';
|
|
19
|
-
import { validateIssueId, validateBranchName,
|
|
18
|
+
import { beadsExtension, kbCodeIntelExtension } from '../fleet-sprint/viewer-extensions.mjs';
|
|
19
|
+
import { validateIssueId, validateBranchName, validateBranchPair, createMemberReservationClient, resyncReacquiredMember, commandResultToSoftGit } from '../fleet-sprint/runner.js';
|
|
20
20
|
import { normalizeRole } from '../fleet-sprint/contracts.mjs';
|
|
21
|
+
import { prepareLaunchTopology, toAlignCommandResult } from '../fleet-sprint/member-align.mjs';
|
|
22
|
+
import { ROLE_BACKLOG, resolveBacklogRoleAlias, selectBacklogMember, formatBacklogSelection } from '../fleet-sprint/backlog-role.mjs';
|
|
21
23
|
import { BEADS_IDENTITY_PROBES, parseBeadsIdentity, formatBeadsIdentity, parseExpectedIdentity } from '../fleet-sprint/beads-identity.mjs';
|
|
22
24
|
|
|
23
25
|
const __filename = fileURLToPath(import.meta.url);
|
|
@@ -159,7 +161,7 @@ export function buildOptionsSpec() {
|
|
|
159
161
|
// The beads identity (JSON, serializeExpectedIdentity output) every
|
|
160
162
|
// member's bd must resolve to, injected by the supervisor's spawner;
|
|
161
163
|
// env fallback FLEET_SPRINT_EXPECT_BEADS. Omitted (direct launch):
|
|
162
|
-
// the runner takes the expectation from the
|
|
164
|
+
// the runner takes the expectation from the backlog member.
|
|
163
165
|
'expect-beads': { type: 'string' },
|
|
164
166
|
budget: { type: 'string' },
|
|
165
167
|
// Stabilization Issue 32: per-dispatch time budget in seconds
|
|
@@ -174,6 +176,15 @@ export function buildOptionsSpec() {
|
|
|
174
176
|
// dolt-probe precondition, differing HEADs allowed). Omitted => legacy
|
|
175
177
|
// shared-workspace mode (same-HEAD). Mode is never inferred silently.
|
|
176
178
|
sync: { type: 'boolean' },
|
|
179
|
+
// Explicitly skip the once-per-sprint regression pass (forwarded as the
|
|
180
|
+
// runner's skip_regression arg; the supervisor sets it from the launch
|
|
181
|
+
// body's phases.regression:"skip"). Never silent: logged, and reported in
|
|
182
|
+
// the sprint analysis and the PR body.
|
|
183
|
+
'skip-regression': { type: 'boolean' },
|
|
184
|
+
// --ci-gate is DELIBERATELY NOT WIRED (2026-10-01): the runner's
|
|
185
|
+
// ci_gate arg is disabled until the CI-as-quality-resource epic
|
|
186
|
+
// (apra-fleet-dv8i) designs the flow -- see fleet-sprint/sprint-args.mjs.
|
|
187
|
+
// 'ci-gate': { type: 'string' },
|
|
177
188
|
help: { type: 'boolean', short: 'h' },
|
|
178
189
|
};
|
|
179
190
|
}
|
|
@@ -206,14 +217,15 @@ Options:
|
|
|
206
217
|
--expect-beads <json> Beads identity every member must resolve to, as JSON
|
|
207
218
|
({"beadsDir","prefix","syncRemote","repoRemote"}). Normally injected by
|
|
208
219
|
the supervisor; env fallback FLEET_SPRINT_EXPECT_BEADS. Omitted: the
|
|
209
|
-
|
|
220
|
+
backlog member's own 'bd where' becomes the expectation and every
|
|
210
221
|
other member must match it. A mismatch aborts before any bd mutation.
|
|
211
222
|
--budget <usd> USD ceiling for this run's total estimated spend. Optional;
|
|
212
223
|
omitted (the default) means unlimited, identical to prior behavior.
|
|
213
|
-
--dispatch-timeout-s <s> Per-dispatch time budget in seconds (default
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
sprints so a hung dispatch costs minutes, not
|
|
224
|
+
--dispatch-timeout-s <s> Per-dispatch time budget in seconds (default 9000). The hard ceiling
|
|
225
|
+
on every agent dispatch (integration-test ceiling 2x, regression-test
|
|
226
|
+
ceiling 3x); the inactivity timeout is this value capped at 1800.
|
|
227
|
+
Lower it for small sprints so a hung dispatch costs minutes, not
|
|
228
|
+
hours. Minimum 60.
|
|
217
229
|
--usage-limit-max-wait-s <s> Total wall-clock seconds a dispatch may stay paused across all
|
|
218
230
|
usage-limit reprobes before giving up (typed sprint abort). Optional;
|
|
219
231
|
omitted uses the runner default. Minimum 60.
|
|
@@ -223,6 +235,8 @@ Options:
|
|
|
223
235
|
members may sit on differing HEADs but must share the same
|
|
224
236
|
origin URL and pass a 'bd dolt pull' probe. Omitted (default)
|
|
225
237
|
uses legacy shared-workspace mode (all members on the same HEAD).
|
|
238
|
+
--skip-regression Skip the once-per-sprint regression pass. Logged, and stated in the
|
|
239
|
+
sprint analysis and the PR body. Integration tests still run.
|
|
226
240
|
-h, --help Show this help message.
|
|
227
241
|
`.trim();
|
|
228
242
|
|
|
@@ -254,7 +268,18 @@ export function parseCliArgs(argv) {
|
|
|
254
268
|
* @returns {Promise<object|undefined>}
|
|
255
269
|
*/
|
|
256
270
|
export async function resolveRoleMap(rawValue, deps = {}) {
|
|
257
|
-
|
|
271
|
+
return (await resolveRoleMapWithWarnings(rawValue, deps)).roleMap;
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* Same as resolveRoleMap() but also returns the backlog-alias deprecation
|
|
276
|
+
* warnings, so main() can print them and forward them to the runner (which
|
|
277
|
+
* logs them in the run log -- the rewritten roleMap no longer carries the
|
|
278
|
+
* deprecated key, so the runner could not detect it itself).
|
|
279
|
+
* @returns {Promise<{ roleMap: object|undefined, warnings: string[] }>}
|
|
280
|
+
*/
|
|
281
|
+
export async function resolveRoleMapWithWarnings(rawValue, deps = {}) {
|
|
282
|
+
if (rawValue === undefined) return { roleMap: undefined, warnings: [] };
|
|
258
283
|
const readFile = deps.readFile || fs.readFile;
|
|
259
284
|
|
|
260
285
|
let jsonText = rawValue;
|
|
@@ -287,12 +312,12 @@ export async function resolveRoleMap(rawValue, deps = {}) {
|
|
|
287
312
|
// contracts.normalizeRole() (trim + lowercase) HERE -- this is where
|
|
288
313
|
// roleMap keys first enter the system from a user-supplied
|
|
289
314
|
// `--role-map`/`@file.json` value, so callers of `resolveRoleMap()`
|
|
290
|
-
// (including this CLI's own pre-transport `
|
|
315
|
+
// (including this CLI's own pre-transport `backlogMember` lookup
|
|
291
316
|
// below, and runner.js's `validateArgs()`, which normalizes again
|
|
292
317
|
// defensively for callers that bypass the CLI and pass a raw roleMap
|
|
293
318
|
// straight to `engine.executeFile()`) can rely on keys already being in
|
|
294
319
|
// canonical lowercase form. This also covers the 'orchestrator'
|
|
295
|
-
// application-level pseudo-role key (see runner.js's
|
|
320
|
+
// application-level pseudo-role key (see runner.js's ROLE_BACKLOG
|
|
296
321
|
// doc comment) -- it is not a vendored contracts.ROLES member but is
|
|
297
322
|
// still just a plain string key here, so the same normalization applies.
|
|
298
323
|
const normalized = {};
|
|
@@ -307,7 +332,12 @@ export async function resolveRoleMap(rawValue, deps = {}) {
|
|
|
307
332
|
normalized[key] = members;
|
|
308
333
|
}
|
|
309
334
|
|
|
310
|
-
|
|
335
|
+
// Deprecated 'orchestrator' key -> 'backlog'; a conflict throws.
|
|
336
|
+
try {
|
|
337
|
+
return resolveBacklogRoleAlias(normalized);
|
|
338
|
+
} catch (err) {
|
|
339
|
+
throw new Error(`Error: --role-map ${err.message}`);
|
|
340
|
+
}
|
|
311
341
|
}
|
|
312
342
|
|
|
313
343
|
/**
|
|
@@ -323,7 +353,7 @@ export async function resolveRoleMap(rawValue, deps = {}) {
|
|
|
323
353
|
* }} opts
|
|
324
354
|
* @returns {object}
|
|
325
355
|
*/
|
|
326
|
-
export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goal, maxCycles, requirementsFile, roleMap, budget, dispatchTimeoutS, usageLimitMaxWaitS, usageLimitMaxReprobes, serviceUrl, runId, expectBeads }) {
|
|
356
|
+
export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goal, maxCycles, requirementsFile, roleMap, roleMapWarnings, budget, dispatchTimeoutS, usageLimitMaxWaitS, usageLimitMaxReprobes, serviceUrl, runId, expectBeads, skipRegression, ciGate }) {
|
|
327
357
|
const args = {
|
|
328
358
|
target_issues: targetIssues,
|
|
329
359
|
members,
|
|
@@ -334,6 +364,7 @@ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goa
|
|
|
334
364
|
};
|
|
335
365
|
if (requirementsFile !== undefined) args.requirementsFile = requirementsFile;
|
|
336
366
|
if (roleMap !== undefined) args.roleMap = roleMap;
|
|
367
|
+
if (Array.isArray(roleMapWarnings) && roleMapWarnings.length > 0) args.roleMapWarnings = roleMapWarnings;
|
|
337
368
|
if (budget !== undefined) args.budget = budget;
|
|
338
369
|
if (dispatchTimeoutS !== undefined) args.dispatch_timeout_s = dispatchTimeoutS;
|
|
339
370
|
// apra-fleet-hzeb.4.2: the CLI-overridable usage-limit pause budgets,
|
|
@@ -352,9 +383,13 @@ export function buildRunnerArgs({ targetIssues, members, branch, baseBranch, goa
|
|
|
352
383
|
// dispatch so deploy.md's active-sprints gate can recognize this sprint's
|
|
353
384
|
// OWN reservation instead of stopping on it.
|
|
354
385
|
if (runId !== undefined) args.run_id = runId;
|
|
386
|
+
// Only forwarded when set, so a default launch's runner args are unchanged.
|
|
387
|
+
if (skipRegression === true) args.skip_regression = true;
|
|
355
388
|
// The raw --expect-beads JSON, forwarded verbatim; runner.js's
|
|
356
389
|
// validateArgs() parses it (validateExpectBeads) and rejects bad JSON.
|
|
357
390
|
if (expectBeads !== undefined) args.expect_beads = expectBeads;
|
|
391
|
+
// --ci-gate is not wired (apra-fleet-dv8i); ci_gate is never forwarded.
|
|
392
|
+
// if (ciGate !== undefined) args.ci_gate = ciGate;
|
|
358
393
|
return args;
|
|
359
394
|
}
|
|
360
395
|
|
|
@@ -373,7 +408,7 @@ export function resolveExpectBeads(flagValue, env = process.env) {
|
|
|
373
408
|
}
|
|
374
409
|
|
|
375
410
|
/**
|
|
376
|
-
* Runs `bd where --json` on the
|
|
411
|
+
* Runs `bd where --json` on the BACKLOG MEMBER (never locally -- the
|
|
377
412
|
* sprint's bd commands run in that member's workFolder, see
|
|
378
413
|
* checkIssuesExistOnMember below) so the startup banner can show which
|
|
379
414
|
* .beads the sprint is about to mutate, and so a member with no beads
|
|
@@ -461,9 +496,9 @@ export function resolveMemberValidation({ rawMembers, registeredNames, allowMiss
|
|
|
461
496
|
}
|
|
462
497
|
|
|
463
498
|
/**
|
|
464
|
-
* Verifies every target issue exists, run on the
|
|
499
|
+
* Verifies every target issue exists, run on the BACKLOG MEMBER via the
|
|
465
500
|
* fleet transport (`runBdShow`) -- NOT on the local machine. The sprint's own
|
|
466
|
-
* `bd` commands run against the
|
|
501
|
+
* `bd` commands run against the backlog member's beads DB (see
|
|
467
502
|
* fleet-sprint/runner.js's SUPPORTED-TOPOLOGY NOTE), which can be a different
|
|
468
503
|
* database than whatever is local to wherever this CLI process happens to
|
|
469
504
|
* run. Checking locally could pass (or worse, resolve a same-named-but-
|
|
@@ -548,6 +583,37 @@ export function attachViewerErrorHandler(server, port, opts = {}) {
|
|
|
548
583
|
// the failure -- and precisely which members block the resume -- is surfaced to
|
|
549
584
|
// the operator instead of lost to a console.error line. Extracted and exported
|
|
550
585
|
// so the rethrow-and-name behavior is unit-testable without a live engine.
|
|
586
|
+
// Launch ordering: launch alignment (prepareLaunchTopology) stashes WIP and
|
|
587
|
+
// switches branches on members, so it must never run on a member another
|
|
588
|
+
// sprint holds -- that sprint's in-flight work would be moved under it. Reserve
|
|
589
|
+
// first (reserveForLaunch reports members another sprint already holds and
|
|
590
|
+
// then hands back what it took), align only when nothing is held, and release
|
|
591
|
+
// every reservation again when alignment refuses or throws, so a refused
|
|
592
|
+
// launch leaves no reservation behind. Exported so the ordering is unit-
|
|
593
|
+
// testable without a live server.
|
|
594
|
+
export async function reserveThenAlign({ sprintReservation, align } = {}) {
|
|
595
|
+
const { held } = await sprintReservation.reserveForLaunch();
|
|
596
|
+
if (held.length > 0) {
|
|
597
|
+
return {
|
|
598
|
+
ok: false,
|
|
599
|
+
reserved: false,
|
|
600
|
+
message: `member(s) ${held.join(', ')} are reserved by another running sprint, so no member was aligned or changed. Wait for that sprint to finish or release its reservation (member_reservation), then launch again.`,
|
|
601
|
+
};
|
|
602
|
+
}
|
|
603
|
+
let topology;
|
|
604
|
+
try {
|
|
605
|
+
topology = await align();
|
|
606
|
+
} catch (err) {
|
|
607
|
+
await sprintReservation.releaseAll();
|
|
608
|
+
throw err;
|
|
609
|
+
}
|
|
610
|
+
if (!topology || !topology.ok) {
|
|
611
|
+
await sprintReservation.releaseAll();
|
|
612
|
+
return { ...(topology || { ok: false, message: 'launch alignment returned no result' }), reserved: false };
|
|
613
|
+
}
|
|
614
|
+
return { ...topology, reserved: true };
|
|
615
|
+
}
|
|
616
|
+
|
|
551
617
|
export async function reReserveOnResume({ sprintReservation, resyncMember, requestPause, log = () => {} } = {}) {
|
|
552
618
|
try {
|
|
553
619
|
return await sprintReservation.reReserveForResume({ resyncMember });
|
|
@@ -623,11 +689,14 @@ async function main() {
|
|
|
623
689
|
// is somehow bypassed -- both layers share the exact same validators
|
|
624
690
|
// (imported from runner.js) so there is a single source of truth.
|
|
625
691
|
let roleMap;
|
|
692
|
+
let roleMapWarnings = [];
|
|
626
693
|
try {
|
|
627
694
|
targetIssues.forEach(validateIssueId);
|
|
628
695
|
validateBranchName(branchName, 'branch');
|
|
629
696
|
validateBranchName(baseBranch, 'base');
|
|
630
|
-
|
|
697
|
+
validateBranchPair(branchName, baseBranch);
|
|
698
|
+
({ roleMap, warnings: roleMapWarnings } = await resolveRoleMapWithWarnings(values['role-map']));
|
|
699
|
+
for (const w of roleMapWarnings) console.warn(`Warning: ${w}`);
|
|
631
700
|
} catch (err) {
|
|
632
701
|
console.error(`Error: ${err.message}`);
|
|
633
702
|
process.exit(1);
|
|
@@ -677,7 +746,7 @@ async function main() {
|
|
|
677
746
|
// 1. Attach to the fleet MCP transport FIRST, so member validation, the
|
|
678
747
|
// "bd show" issue precondition (below), and the sprint itself all run
|
|
679
748
|
// against the same live client/connection -- and so the issue
|
|
680
|
-
// precondition can target the
|
|
749
|
+
// precondition can target the backlog MEMBER rather than the local
|
|
681
750
|
// machine (apra-fleet-unw2.16, N14 (d): the sprint's own `bd` commands
|
|
682
751
|
// run on the member via the fleet transport, which can be a different
|
|
683
752
|
// database than whatever is local to this CLI process).
|
|
@@ -691,7 +760,17 @@ async function main() {
|
|
|
691
760
|
// fail fast with a typed error naming the missing connection config --
|
|
692
761
|
// silently self-spawning a private stdio server here would defeat the
|
|
693
762
|
// whole point of sharing one fleet-server connection across N children.
|
|
694
|
-
|
|
763
|
+
let connection;
|
|
764
|
+
try {
|
|
765
|
+
connection = await resolveFleetServerConnection();
|
|
766
|
+
} catch (err) {
|
|
767
|
+
// e.g. the server was stopped with 'apra-fleet stop', or auto-start
|
|
768
|
+
// refused/failed: print the actionable message on stderr (the
|
|
769
|
+
// supervisor surfaces a launch's stderr tail), not a stack trace.
|
|
770
|
+
console.error(`Error: ${err && err.message ? err.message : err}`);
|
|
771
|
+
process.exit(1);
|
|
772
|
+
return;
|
|
773
|
+
}
|
|
695
774
|
if (connection.mode !== 'http') {
|
|
696
775
|
const err = new FleetServerUnreachableError(
|
|
697
776
|
'No reachable apra-fleet HTTP singleton was found. cli.mjs no longer ' +
|
|
@@ -707,7 +786,10 @@ async function main() {
|
|
|
707
786
|
process.exit(1);
|
|
708
787
|
return;
|
|
709
788
|
}
|
|
710
|
-
|
|
789
|
+
// Reconnecting HTTP transport: if the shared server dies mid-run it is
|
|
790
|
+
// re-probed (and auto-started when gone) before the next request; a request
|
|
791
|
+
// is retried once only when it provably never reached the server.
|
|
792
|
+
const transport = createFleetHttpTransport(connection, { dirname: __dirname, exists: existsSync });
|
|
711
793
|
await transport.start();
|
|
712
794
|
const mcpClient = new McpClient(transport);
|
|
713
795
|
|
|
@@ -717,9 +799,9 @@ async function main() {
|
|
|
717
799
|
let validMembers = [];
|
|
718
800
|
// apra-fleet: names flagged unreservable in the SAME list_members read --
|
|
719
801
|
// hoisted out of this try block so the topology filter below (item 4) can
|
|
720
|
-
// key on the actual unreservable flag, not on roleMap.
|
|
802
|
+
// key on the actual unreservable flag, not on roleMap.backlog
|
|
721
803
|
// membership (which would also match a real, git-having dispatch member
|
|
722
|
-
// that is ADDITIONALLY role-mapped as
|
|
804
|
+
// that is ADDITIONALLY role-mapped as backlog, and wrongly skip its
|
|
723
805
|
// legitimate same-HEAD topology check).
|
|
724
806
|
let unreservableNames = new Set();
|
|
725
807
|
try {
|
|
@@ -742,18 +824,21 @@ async function main() {
|
|
|
742
824
|
process.exit(1);
|
|
743
825
|
}
|
|
744
826
|
|
|
745
|
-
// 3. bd show issue precondition -- run on the
|
|
827
|
+
// 3. bd show issue precondition -- run on the backlog MEMBER via the
|
|
746
828
|
// fleet transport (apra-fleet-unw2.16, N14 (d)), immediately after the
|
|
747
829
|
// transport/initialize handshake above and before any sprint phase
|
|
748
|
-
// begins. The
|
|
749
|
-
// `getMemberForRole(
|
|
830
|
+
// begins. The backlog member mirrors fleet-sprint/runner.js's
|
|
831
|
+
// `getMemberForRole(ROLE_BACKLOG)` resolution: roleMap.backlog[0]
|
|
750
832
|
// if configured, else the first valid member. `roleMap` here is already
|
|
751
833
|
// key-normalized by `resolveRoleMap()` above (N15, apra-fleet-unw2.11),
|
|
752
|
-
// so the canonical lowercase '
|
|
834
|
+
// so the canonical lowercase 'backlog' key is the only one that can
|
|
753
835
|
// be present -- this must NOT read a capitalized 'Orchestrator' key (the
|
|
754
836
|
// N15 finding: that stray casing silently never matched a roleMap
|
|
755
837
|
// author's natural lowercase key).
|
|
756
|
-
const
|
|
838
|
+
const backlogSelection = selectBacklogMember({ roleMap, members: validMembers });
|
|
839
|
+
const backlogMember = backlogSelection.member;
|
|
840
|
+
const backlogSelectionLine = formatBacklogSelection(backlogSelection);
|
|
841
|
+
if (backlogSelectionLine) console.log(backlogSelectionLine);
|
|
757
842
|
const runProbe = async (cmd, member) => {
|
|
758
843
|
const res = await fleetApi.executeCommand({ command: cmd, member_name: member });
|
|
759
844
|
const text = res && res.content && res.content[0] ? res.content[0].text : '';
|
|
@@ -762,20 +847,20 @@ async function main() {
|
|
|
762
847
|
if (exitCode !== 0) throw new Error(text || `exit code ${exitCode}`);
|
|
763
848
|
return res && res.structuredContent && typeof res.structuredContent.stdout === 'string' ? res.structuredContent.stdout : text;
|
|
764
849
|
};
|
|
765
|
-
// Which .beads the
|
|
850
|
+
// Which .beads the backlog member's bd resolves to -- probed BEFORE
|
|
766
851
|
// the `bd show` precondition below so a member with no beads database
|
|
767
852
|
// is reported plainly (a warning with the fix) ahead of the bare bd
|
|
768
853
|
// error that precondition would otherwise be the first to show, and
|
|
769
854
|
// shown in the banner. A failed probe is a warning, not an exit: the
|
|
770
855
|
// existing preconditions decide. The runner repeats this for every
|
|
771
856
|
// member and hard-fails only a mismatch against --expect-beads.
|
|
772
|
-
const beadsProbe = await probeBeadsIdentityOnMember({ member:
|
|
857
|
+
const beadsProbe = await probeBeadsIdentityOnMember({ member: backlogMember, runCommand: runProbe });
|
|
773
858
|
if (!beadsProbe.ok) {
|
|
774
859
|
console.warn(beadsProbe.message);
|
|
775
860
|
}
|
|
776
861
|
const issueCheck = await checkIssuesExistOnMember({
|
|
777
862
|
targetIssues,
|
|
778
|
-
member:
|
|
863
|
+
member: backlogMember,
|
|
779
864
|
runBdShow: async (id, member) => fleetApi.executeCommand({ command: `bd show ${id}`, member_name: member }),
|
|
780
865
|
});
|
|
781
866
|
if (!issueCheck.ok) {
|
|
@@ -788,7 +873,7 @@ async function main() {
|
|
|
788
873
|
//
|
|
789
874
|
// LEGACY mode (default): the runner's cross-member coherence relies on
|
|
790
875
|
// every member sharing one workspace/DB -- every orchestrator-side `bd`
|
|
791
|
-
// command runs against the
|
|
876
|
+
// command runs against the backlog member's beads DB, and the sprint
|
|
792
877
|
// git branch is only coherent if every member operates on the same working
|
|
793
878
|
// state. Enforce that by comparing `git rev-parse HEAD` across members and
|
|
794
879
|
// refusing to start on a mismatch.
|
|
@@ -814,16 +899,16 @@ async function main() {
|
|
|
814
899
|
// fleet-sprint orchestrator, docs/design-orchestrator-worktree-model-v2.md)
|
|
815
900
|
// may have no real checkout at all, and `git rev-parse HEAD` on one
|
|
816
901
|
// hard-fails the launch (process.exit(1) just below). Deliberately keyed
|
|
817
|
-
// on the `unreservable` FLAG, not on roleMap.
|
|
902
|
+
// on the `unreservable` FLAG, not on roleMap.backlog membership: a
|
|
818
903
|
// real, git-having dispatch member that is ADDITIONALLY role-mapped as
|
|
819
|
-
//
|
|
904
|
+
// backlog (a supported topology, runner.js's branchEnsureMembers
|
|
820
905
|
// dedupe comment) must still pass its legitimate same-HEAD check against
|
|
821
|
-
// the other dispatch members -- filtering on roleMap.
|
|
906
|
+
// the other dispatch members -- filtering on roleMap.backlog alone
|
|
822
907
|
// would silently skip that check instead of just skipping a git-less
|
|
823
908
|
// member. This only matters when an operator also lists a shared member
|
|
824
|
-
// in --members (redundant with roleMap.
|
|
825
|
-
// a normal launch that passes the shared
|
|
826
|
-
// roleMap.
|
|
909
|
+
// in --members (redundant with roleMap.backlog, and not required);
|
|
910
|
+
// a normal launch that passes the shared backlog member ONLY via
|
|
911
|
+
// roleMap.backlog was never affected.
|
|
827
912
|
const topologyMembersFiltered = validMembers.filter((m) => !unreservableNames.has(m));
|
|
828
913
|
// Degrade back to the unfiltered list if excluding unreservable members
|
|
829
914
|
// would empty it out entirely -- checkMemberTopology refuses to start on
|
|
@@ -832,13 +917,54 @@ async function main() {
|
|
|
832
917
|
// the ORIGINAL single-member-trivial-pass behavior rather than a topology
|
|
833
918
|
// error about having no members at all.
|
|
834
919
|
const topologyMembers = topologyMembersFiltered.length > 0 ? topologyMembersFiltered : validMembers;
|
|
835
|
-
|
|
920
|
+
// apra-fleet-rsd9.1.1: in legacy mode, first ALIGN every topology member
|
|
921
|
+
// to the sprint base (fetch, preserve WIP in a named stash, check out the
|
|
922
|
+
// sprint branch -- see fleet-sprint/member-align.mjs), then run the
|
|
923
|
+
// topology check against the aligned state. Members that merely sat on
|
|
924
|
+
// other commits no longer refuse the launch; only what cannot be
|
|
925
|
+
// reconciled automatically (unreachable member, differing origin, base
|
|
926
|
+
// missing on origin, fetch auth failure, diverged sprint branch) does,
|
|
927
|
+
// and then before any member is moved. Synced mode is unchanged.
|
|
928
|
+
const runAlignGit = async (cmd, member) => {
|
|
929
|
+
try {
|
|
930
|
+
return toAlignCommandResult(await fleetApi.executeCommand({ command: cmd, member_name: member }));
|
|
931
|
+
} catch (err) {
|
|
932
|
+
return toAlignCommandResult(undefined, err);
|
|
933
|
+
}
|
|
934
|
+
};
|
|
935
|
+
// eft.26.1 reservation: a sprint launched directly through this CLI
|
|
936
|
+
// (never routed through the supervisor's POST /api/sprints) reserves its
|
|
937
|
+
// members server-side, on the SAME opaque sprint id runner.js uses for the
|
|
938
|
+
// dolt-mutex/allocator (the sprint branch name), so the supervisor's
|
|
939
|
+
// overlap guard and execute_prompt's dispatch-time reservedBy check can see
|
|
940
|
+
// it. It is taken BEFORE launch alignment (reserveThenAlign) and released
|
|
941
|
+
// on EVERY exit path below: a refused alignment, a viewer port failure,
|
|
942
|
+
// normal success, a caught failure/stall-abort, or SIGINT.
|
|
943
|
+
const sprintReservation = createMemberReservationClient({
|
|
944
|
+
callTool: (name, args) => mcpClient.callTool(name, args),
|
|
945
|
+
members: validMembers,
|
|
946
|
+
sprintId: branchName,
|
|
947
|
+
log: (msg) => console.log(msg),
|
|
948
|
+
});
|
|
949
|
+
// Ctrl-C between the reserve and the sprint's own SIGINT handler (below)
|
|
950
|
+
// must not leave the members reserved.
|
|
951
|
+
const onLaunchSigint = () => {
|
|
952
|
+
sprintReservation.releaseAll()
|
|
953
|
+
.catch((err) => console.error('[member-reservation] release-on-SIGINT failed:', err))
|
|
954
|
+
.finally(() => process.exit(130));
|
|
955
|
+
};
|
|
956
|
+
process.once('SIGINT', onLaunchSigint);
|
|
957
|
+
const topology = await reserveThenAlign({ sprintReservation, align: () => prepareLaunchTopology({
|
|
836
958
|
members: topologyMembers,
|
|
837
959
|
mode: syncedMode ? 'synced' : 'legacy',
|
|
960
|
+
baseBranch,
|
|
961
|
+
branch: branchName,
|
|
962
|
+
runGit: runAlignGit,
|
|
963
|
+
log: (msg) => console.log(msg),
|
|
838
964
|
getIdentity: (member) => runCommand('git rev-parse HEAD', member),
|
|
839
965
|
getOriginUrl: (member) => runCommand('git remote get-url origin', member),
|
|
840
966
|
doltProbe: (member) => runCommand('bd dolt pull', member),
|
|
841
|
-
});
|
|
967
|
+
}) });
|
|
842
968
|
if (!topology.ok) {
|
|
843
969
|
console.error(`Error: ${topology.message}`);
|
|
844
970
|
transport.stop();
|
|
@@ -848,13 +974,13 @@ async function main() {
|
|
|
848
974
|
console.log(topology.message);
|
|
849
975
|
}
|
|
850
976
|
|
|
851
|
-
console.log('Starting
|
|
977
|
+
console.log('Starting fleet-sprint');
|
|
852
978
|
console.log(`Target Issues: ${targetIssues.join(', ')}`);
|
|
853
979
|
console.log(`Sprint Branch: ${branchName} (Base: ${baseBranch})`);
|
|
854
980
|
console.log(`Goal Constraint: ${goal}`);
|
|
855
981
|
console.log(`Max Cycles: ${maxCycles}`);
|
|
856
982
|
console.log(`Active Members (${validMembers.length}): ${validMembers.join(', ')}`);
|
|
857
|
-
console.log(`Beads: ${formatBeadsIdentity(beadsProbe.identity, { label: `
|
|
983
|
+
console.log(`Beads: ${formatBeadsIdentity(beadsProbe.identity, { label: `backlog '${backlogMember}'` })}`);
|
|
858
984
|
if (expectedBeads) {
|
|
859
985
|
console.log(`Beads: ${formatBeadsIdentity(expectedBeads, { label: 'expected (--expect-beads)' })}`);
|
|
860
986
|
}
|
|
@@ -865,7 +991,9 @@ async function main() {
|
|
|
865
991
|
const server = createDashboardViewer(workflow, {
|
|
866
992
|
port: viewerPort,
|
|
867
993
|
name: 'Fleet-Sprint',
|
|
868
|
-
|
|
994
|
+
// kbCodeIntelExtension: its own tab (per-member, per-dispatch kb_* and
|
|
995
|
+
// code_* call counts), separate from the Tasks tab.
|
|
996
|
+
dashboardExtensions: [beadsExtension, kbCodeIntelExtension],
|
|
869
997
|
// apra-fleet-eft.37.1/37.2: the core viewer now speaks opts.runId
|
|
870
998
|
// (opts.sprintId is a deprecated BOUNDARY-COMPAT alias -- never use
|
|
871
999
|
// it from here).
|
|
@@ -884,7 +1012,7 @@ async function main() {
|
|
|
884
1012
|
runId: effectiveRunId,
|
|
885
1013
|
// BOUNDARY-COMPAT/user-facing convention (apra-fleet-eft.37.1): core's
|
|
886
1014
|
// crash-net snapshot defaults are domain-neutral (workflow-logs/run_)
|
|
887
|
-
// now that sprintId->runId is renamed;
|
|
1015
|
+
// now that sprintId->runId is renamed; fleet-sprint keeps its historical
|
|
888
1016
|
// sprint-logs/sprint_<HHMMSS>.json convention by passing these
|
|
889
1017
|
// explicitly rather than picking up the new core defaults.
|
|
890
1018
|
stateSnapshotDir: 'sprint-logs',
|
|
@@ -907,14 +1035,18 @@ async function main() {
|
|
|
907
1035
|
onError: (message) => {
|
|
908
1036
|
viewerFailed = true;
|
|
909
1037
|
console.error(`Error: ${message}`);
|
|
910
|
-
|
|
911
|
-
|
|
1038
|
+
sprintReservation.releaseAll()
|
|
1039
|
+
.catch((err) => console.error('[member-reservation] release on viewer failure failed:', err && err.message ? err.message : err))
|
|
1040
|
+
.finally(() => {
|
|
1041
|
+
transport.stop();
|
|
1042
|
+
process.exit(1);
|
|
1043
|
+
});
|
|
912
1044
|
},
|
|
913
1045
|
});
|
|
914
1046
|
|
|
915
1047
|
console.log(`Dashboard live at http://localhost:${viewerPort}`);
|
|
916
1048
|
|
|
917
|
-
if (viewerFailed) return; //
|
|
1049
|
+
if (viewerFailed) return; // onError releases the reservations, then exits
|
|
918
1050
|
|
|
919
1051
|
// apra-fleet-eft.26.1 (Reservation interop gap, Hole 1): a sprint
|
|
920
1052
|
// launched directly through this CLI (never routed through the
|
|
@@ -926,13 +1058,7 @@ async function main() {
|
|
|
926
1058
|
// for the dolt-mutex/allocator (the sprint branch name), and release on
|
|
927
1059
|
// EVERY exit path below: normal success, a caught failure/stall-abort,
|
|
928
1060
|
// or SIGINT.
|
|
929
|
-
|
|
930
|
-
callTool: (name, args) => mcpClient.callTool(name, args),
|
|
931
|
-
members: validMembers,
|
|
932
|
-
sprintId: branchName,
|
|
933
|
-
log: (msg) => console.log(msg),
|
|
934
|
-
});
|
|
935
|
-
await sprintReservation.reserveAll();
|
|
1061
|
+
// (The members were reserved above, before launch alignment.)
|
|
936
1062
|
|
|
937
1063
|
// apra-fleet-p2to.4.2: reservation handling across a cooperative
|
|
938
1064
|
// pause/resume (apra-fleet-p2to.1's engine primitive). On 'paused' hand
|
|
@@ -1009,6 +1135,7 @@ async function main() {
|
|
|
1009
1135
|
.catch((err) => console.error('[member-reservation] release-on-SIGINT failed:', err))
|
|
1010
1136
|
.finally(() => process.exit(130));
|
|
1011
1137
|
};
|
|
1138
|
+
process.removeListener('SIGINT', onLaunchSigint);
|
|
1012
1139
|
process.once('SIGINT', onSigint);
|
|
1013
1140
|
|
|
1014
1141
|
try {
|
|
@@ -1023,6 +1150,7 @@ async function main() {
|
|
|
1023
1150
|
maxCycles,
|
|
1024
1151
|
requirementsFile,
|
|
1025
1152
|
roleMap,
|
|
1153
|
+
roleMapWarnings,
|
|
1026
1154
|
budget,
|
|
1027
1155
|
dispatchTimeoutS,
|
|
1028
1156
|
usageLimitMaxWaitS,
|
|
@@ -1030,6 +1158,8 @@ async function main() {
|
|
|
1030
1158
|
serviceUrl,
|
|
1031
1159
|
runId: effectiveRunId,
|
|
1032
1160
|
expectBeads,
|
|
1161
|
+
skipRegression: Boolean(values['skip-regression']),
|
|
1162
|
+
// ciGate: values['ci-gate'], -- not wired (apra-fleet-dv8i)
|
|
1033
1163
|
}),
|
|
1034
1164
|
// apra-fleet-eft.75.1: wires this already-connected mcpClient
|
|
1035
1165
|
// through to runner.js's createMemberSessionGuard (see its doc
|