@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,339 @@
|
|
|
1
|
+
// PR-body and cost-report text surface for fleet-sprint (apra-fleet-3swo.6.14).
|
|
2
|
+
// Extracted out of runner.js; runner.js re-exports every symbol it previously
|
|
3
|
+
// exported from this region, so existing importers of fleet-sprint/runner.js
|
|
4
|
+
// resolve unchanged.
|
|
5
|
+
//
|
|
6
|
+
// This module owns:
|
|
7
|
+
// - sanitizePrText: the PR title/body sanitizer the Publish PR step runs
|
|
8
|
+
// the final verdict's LLM-authored notes through before handing them to
|
|
9
|
+
// VCSModule's create-pull-request command builder.
|
|
10
|
+
// - buildAnalysisText: the Harvester dispatch's `analysisText` block
|
|
11
|
+
// builder (module-private -- it is the body builder buildCostAnalysis
|
|
12
|
+
// and the PR text path share, so it moves with them rather than staying
|
|
13
|
+
// behind).
|
|
14
|
+
// - buildCostAnalysis: the sprint cost block (appended to analysisText and
|
|
15
|
+
// rendered in the PR body), reporting budget/spend honestly from the live
|
|
16
|
+
// `budget` object.
|
|
17
|
+
// - computeBranchSlug: the collision-resistant filesystem slug for
|
|
18
|
+
// `docs/sprint-analysis-<slug>.md`.
|
|
19
|
+
//
|
|
20
|
+
// sanitizePrText depends on SAFE_TEXT_RE, which moved to newtask-text.mjs
|
|
21
|
+
// (apra-fleet-3swo.6.14 Part Two) alongside the newTask-title validation
|
|
22
|
+
// surface it also guards -- imported back here rather than duplicated.
|
|
23
|
+
|
|
24
|
+
import { createHash } from 'crypto';
|
|
25
|
+
import { SAFE_TEXT_RE } from './newtask-text.mjs';
|
|
26
|
+
import { formatDispatchToolCalls } from './dispatch-accounting.mjs';
|
|
27
|
+
|
|
28
|
+
// ---------------------------------------------------------------------------
|
|
29
|
+
// PR body/title text sanitization. The final reviewer's verdict notes are LLM
|
|
30
|
+
// output embedded in the PR title/body that the Publish PR step passes into
|
|
31
|
+
// VCSModule's create-pull-request command builder, which JSON-encodes them
|
|
32
|
+
// into the curl request payload -- the same injection class SAFE_TEXT_RE
|
|
33
|
+
// exists to close for newTask titles, at a different call site.
|
|
34
|
+
//
|
|
35
|
+
// Unlike validateNewTask(), rejecting is not an option here: the PR must still
|
|
36
|
+
// carry the sprint's verdict to a human even when the notes are malformed, and
|
|
37
|
+
// failing closed would drop the one thing that human most needs to read. So
|
|
38
|
+
// this strips instead: every character outside SAFE_TEXT_RE becomes a space,
|
|
39
|
+
// keeping the notes readable while nothing that could break out of the
|
|
40
|
+
// shell-quoted command string VCSModule builds around it.
|
|
41
|
+
/**
|
|
42
|
+
* Sanitizes LLM-authored free text (e.g. finalVerdictResult.notes) before it
|
|
43
|
+
* is embedded in a VCSModule-built PR title/body and dispatched via
|
|
44
|
+
* `command()`. Replaces every character outside SAFE_TEXT_RE with a space,
|
|
45
|
+
* collapses the resulting whitespace, and returns the readable remainder.
|
|
46
|
+
* @param {unknown} text
|
|
47
|
+
* @returns {string}
|
|
48
|
+
*/
|
|
49
|
+
export function sanitizePrText(text) {
|
|
50
|
+
const str = String(text ?? '');
|
|
51
|
+
let out = '';
|
|
52
|
+
for (const ch of str) {
|
|
53
|
+
// Newlines and tabs collapse to a space along with every other
|
|
54
|
+
// disallowed character: SAFE_TEXT_RE has no multi-line allowance,
|
|
55
|
+
// because a literal newline inside a double-quoted command-string
|
|
56
|
+
// argument is not reliably safe across mixed POSIX/Windows shells.
|
|
57
|
+
out += SAFE_TEXT_RE.test(ch) ? ch : ' ';
|
|
58
|
+
}
|
|
59
|
+
return out.replace(/\s+/g, ' ').trim();
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
// The Regression Test phase is informational-only and must never gate the
|
|
63
|
+
// sprint; packages/apra-fleet-se/test/regression-phase-never-gates.test.mjs
|
|
64
|
+
// enforces that.
|
|
65
|
+
// ---------------------------------------------------------------------------
|
|
66
|
+
// Finalization prompt builders
|
|
67
|
+
// ---------------------------------------------------------------------------
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* " (<part>: pass, <part>: fail)" from the playbook-defined `sections`, or
|
|
71
|
+
* from the deprecated two-part fields when an older runner returned those;
|
|
72
|
+
* '' when neither is present. The part names are the target playbook's own.
|
|
73
|
+
* @param {object} r regression-test-runner result
|
|
74
|
+
* @returns {string}
|
|
75
|
+
*/
|
|
76
|
+
export function formatRegressionParts(r) {
|
|
77
|
+
const pf = (v) => (v === true ? 'pass' : 'fail');
|
|
78
|
+
let parts = [];
|
|
79
|
+
if (Array.isArray(r.sections) && r.sections.length > 0) {
|
|
80
|
+
parts = r.sections.map((s) => `${s.name}: ${pf(s.passed)}`);
|
|
81
|
+
} else {
|
|
82
|
+
if (typeof r.suitePassed === 'boolean') parts.push(`part 1: ${pf(r.suitePassed)}`);
|
|
83
|
+
if (typeof r.smokePassed === 'boolean') parts.push(`part 2: ${pf(r.smokePassed)}`);
|
|
84
|
+
}
|
|
85
|
+
return parts.length ? ` (${parts.join(', ')})` : '';
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
const REGRESSION_VERDICTS = ['PASS', 'FAIL', 'INCONCLUSIVE'];
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* The regression verdict, or null when the runner reported none. A verdict
|
|
92
|
+
* is copied verbatim from a machine-written verdict file (see
|
|
93
|
+
* agents/regression-test-runner.md), so it outranks the boolean `passed`:
|
|
94
|
+
* INCONCLUSIVE must never be rendered as a failure.
|
|
95
|
+
* @param {object} r regression-test-runner result
|
|
96
|
+
* @returns {'PASS'|'FAIL'|'INCONCLUSIVE'|null}
|
|
97
|
+
*/
|
|
98
|
+
export function regressionVerdictOf(r) {
|
|
99
|
+
return r && REGRESSION_VERDICTS.includes(r.verdict) ? r.verdict : null;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* One-line headline for a regression result: "Regression: <VERDICT> @ <sha12>
|
|
104
|
+
* (parts) [evidence counts] <runUrl>" when a verdict is present, else the legacy
|
|
105
|
+
* "Regression pass: PASSED|FAILED (parts)". No trailing period.
|
|
106
|
+
* @param {object} r regression-test-runner result
|
|
107
|
+
* @returns {string}
|
|
108
|
+
*/
|
|
109
|
+
export function formatRegressionHeadline(r) {
|
|
110
|
+
const verdict = regressionVerdictOf(r);
|
|
111
|
+
if (verdict) {
|
|
112
|
+
const sha = typeof r.testedSha === 'string' && r.testedSha ? ` @ ${r.testedSha.slice(0, 12)}` : '';
|
|
113
|
+
const ev = r.evidence && typeof r.evidence === 'object' ? r.evidence : {};
|
|
114
|
+
const counts = [];
|
|
115
|
+
if (Array.isArray(ev.newFailures)) counts.push(`${ev.newFailures.length} new failure(s)`);
|
|
116
|
+
if (Array.isArray(ev.inventoryMissing)) counts.push(`${ev.inventoryMissing.length} inventory missing`);
|
|
117
|
+
const evText = counts.length ? ` [${counts.join(', ')}]` : '';
|
|
118
|
+
const url = typeof ev.runUrl === 'string' && ev.runUrl ? ` ${ev.runUrl}` : '';
|
|
119
|
+
return `Regression: ${verdict}${sha}${formatRegressionParts(r)}${evText}${url}`;
|
|
120
|
+
}
|
|
121
|
+
return `Regression pass: ${r.passed === true ? 'PASSED' : 'FAILED'}${formatRegressionParts(r)}`;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/**
|
|
125
|
+
* Assembles the `analysisText` block for the Harvester dispatch from this
|
|
126
|
+
* run's in-memory tracking state: cycle-by-cycle closed-bead progress,
|
|
127
|
+
* deploy/integration outcomes, rejected reviewer newTasks, the final verdict,
|
|
128
|
+
* and the regression pass. Pure formatting -- every value is computed
|
|
129
|
+
* elsewhere. harvester.md requires this content be written verbatim to
|
|
130
|
+
* `analysisArtifactFile`.
|
|
131
|
+
* @param {object} opts
|
|
132
|
+
* @returns {string}
|
|
133
|
+
*/
|
|
134
|
+
export function buildAnalysisText({
|
|
135
|
+
targetIssues, branch, baseBranch, cyclesRun,
|
|
136
|
+
closedCountHistory, highWaterClosedCount,
|
|
137
|
+
deployFailures, integFailures, rejectedNewTasks,
|
|
138
|
+
finalVerdictResult, finalClosedCount, finalOpenAtGoalCount,
|
|
139
|
+
// apra-fleet-rp7a.1: the ids excluded from finalOpenAtGoalCount because
|
|
140
|
+
// they are DEFERRED. Reported as their own line rather than folded into
|
|
141
|
+
// the count, so "Final open-at-goal-priority count: 0" can never be read
|
|
142
|
+
// as "nothing was skipped".
|
|
143
|
+
finalDeferredAtGoalIds = [],
|
|
144
|
+
regressionResult = null,
|
|
145
|
+
// Set when the pass was deliberately skipped (e.g. 'launch option'), so the
|
|
146
|
+
// report says so instead of the misleading "no playbook" line.
|
|
147
|
+
regressionSkippedBy = null,
|
|
148
|
+
// Per-dispatch kb_* and code_* call records (sprint state's dispatchToolCalls,
|
|
149
|
+
// from session_stats snapshots). Omitted -> no section; an unknown count
|
|
150
|
+
// is printed as unknown, never 0.
|
|
151
|
+
dispatchToolCalls = null,
|
|
152
|
+
// The KB work client's unpublishedBible(): per repository, confirmations
|
|
153
|
+
// still not in a pushed bible commit. Rendered as a loud section only
|
|
154
|
+
// when any are, so a sprint whose bible was published reads as before.
|
|
155
|
+
kbBibleUnpublished = null,
|
|
156
|
+
}) {
|
|
157
|
+
// The once-per-sprint Regression Test phase runs after the final verdict
|
|
158
|
+
// and never gates it. Its failures are filed as parent-less carry-over
|
|
159
|
+
// beads, so they never appear in the open-at-goal count and are reported
|
|
160
|
+
// separately here.
|
|
161
|
+
const regressionLines = regressionSkippedBy
|
|
162
|
+
? [`Regression pass: skipped by ${regressionSkippedBy} -- not run this sprint.`]
|
|
163
|
+
: regressionResult === null
|
|
164
|
+
? ['Regression pass: not run this sprint (no regression-test-playbook.md, or the probe failed).']
|
|
165
|
+
: [
|
|
166
|
+
`${formatRegressionHeadline(regressionResult)}.`,
|
|
167
|
+
`Carry-over beads filed: ${(regressionResult.bugsFiled || []).join(', ') || 'none'}.`,
|
|
168
|
+
`Summary: ${regressionResult.summary || '(none reported)'}`,
|
|
169
|
+
'Informational only -- this pass ran after the final verdict and did not gate it; any bead '
|
|
170
|
+
+ 'above is parent-less by design and carries over to a future sprint.',
|
|
171
|
+
];
|
|
172
|
+
const lines = [
|
|
173
|
+
`# Sprint Analysis: ${branch}`,
|
|
174
|
+
'',
|
|
175
|
+
`Scope issue id(s): ${targetIssues.join(', ') || '(none specified)'}.`,
|
|
176
|
+
`Base branch: ${baseBranch}.`,
|
|
177
|
+
`Cycles run: ${cyclesRun}.`,
|
|
178
|
+
'',
|
|
179
|
+
'## Progress',
|
|
180
|
+
'',
|
|
181
|
+
`Closed-bead count history (per cycle evaluation): [${closedCountHistory.join(', ') || 'none recorded'}].`,
|
|
182
|
+
`High-water-mark closed count this sprint: ${highWaterClosedCount}.`,
|
|
183
|
+
`Final closed count: ${finalClosedCount}.`,
|
|
184
|
+
`Final open-at-goal-priority count: ${finalOpenAtGoalCount}.`,
|
|
185
|
+
finalDeferredAtGoalIds.length > 0
|
|
186
|
+
? `Deferred bead(s) at/above goal priority, excluded from that count and treated as out of scope `
|
|
187
|
+
+ `(a deferred bead is never dispatchable, so no cycle could advance it): ${finalDeferredAtGoalIds.join(', ')}.`
|
|
188
|
+
: 'No beads were deferred out of scope at/above goal priority this sprint.',
|
|
189
|
+
'',
|
|
190
|
+
'## Deploy/Integration outcomes',
|
|
191
|
+
'',
|
|
192
|
+
deployFailures.length > 0
|
|
193
|
+
? `Deploy failures (${deployFailures.length}): ` + deployFailures.map((f) => `C${f.cycle}: ${f.notes}`).join(' | ')
|
|
194
|
+
: 'No deploy failures recorded this sprint.',
|
|
195
|
+
integFailures.length > 0
|
|
196
|
+
? `Integration test failures (${integFailures.length}): ` + integFailures.map((f) => `C${f.cycle}: ${f.notes} (bugs filed: ${(f.bugsFiled || []).join(', ') || 'none'})`).join(' | ')
|
|
197
|
+
: 'No integration test failures recorded this sprint.',
|
|
198
|
+
'',
|
|
199
|
+
'## Reviewer-proposed newTask rejections',
|
|
200
|
+
'',
|
|
201
|
+
rejectedNewTasks.length > 0
|
|
202
|
+
? `${rejectedNewTasks.length} newTask(s) rejected before reaching bd create: ` + rejectedNewTasks.map((r) => `C${r.cycle}: ${r.reason}`).join(' | ')
|
|
203
|
+
: 'None.',
|
|
204
|
+
'',
|
|
205
|
+
'## Final verdict',
|
|
206
|
+
'',
|
|
207
|
+
`${finalVerdictResult.verdict}${finalVerdictResult.notes ? ` -- ${finalVerdictResult.notes}` : ''}`,
|
|
208
|
+
'',
|
|
209
|
+
'## Regression pass (once per sprint, informational)',
|
|
210
|
+
'',
|
|
211
|
+
...regressionLines,
|
|
212
|
+
...kbBibleLines(kbBibleUnpublished),
|
|
213
|
+
];
|
|
214
|
+
if (Array.isArray(dispatchToolCalls)) {
|
|
215
|
+
lines.push(
|
|
216
|
+
'',
|
|
217
|
+
'## KB and code tool calls per member per dispatch',
|
|
218
|
+
'',
|
|
219
|
+
"Counted by each member's own fleet server (session_stats before/after each dispatch; the engine's own reads are excluded). 'unknown' means the count could not be read -- it is not zero.",
|
|
220
|
+
'',
|
|
221
|
+
...formatDispatchToolCalls(dispatchToolCalls),
|
|
222
|
+
);
|
|
223
|
+
}
|
|
224
|
+
return lines.join('\n');
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
/**
|
|
228
|
+
* The analysis section for KB confirmations that never reached a pushed bible
|
|
229
|
+
* commit (the push kept failing, the maintainer stayed busy or unreachable, or
|
|
230
|
+
* bible commits were sealed). Empty when every confirmation was published.
|
|
231
|
+
* @param {{ repos?: Array<{ repo: string, count: number }>, sealedReason?: string|null }|null} unpublished
|
|
232
|
+
* @returns {string[]}
|
|
233
|
+
*/
|
|
234
|
+
function kbBibleLines(unpublished) {
|
|
235
|
+
const repos = unpublished && Array.isArray(unpublished.repos) ? unpublished.repos.filter((r) => r && r.count > 0) : [];
|
|
236
|
+
if (repos.length === 0) return [];
|
|
237
|
+
return [
|
|
238
|
+
'',
|
|
239
|
+
'## KB bible',
|
|
240
|
+
'',
|
|
241
|
+
'WARNING: bible not published -- these KB confirmations are not in a pushed bible commit on the sprint branch'
|
|
242
|
+
+ ' as of this analysis (the harvest round retries once more after it is written):',
|
|
243
|
+
...repos.map((r) => `- ${r.repo}: ${r.count} unpublished confirmation(s).`),
|
|
244
|
+
...(unpublished.sealedReason ? [`Bible commits were sealed: ${unpublished.sealedReason}.`] : []),
|
|
245
|
+
];
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/**
|
|
249
|
+
* Builds the sprint cost block (appended to the analysis document and rendered
|
|
250
|
+
* in the PR body) from the live `budget` object. Reports only what is known:
|
|
251
|
+
* an unset ceiling, an absent spent() and an unpriced-model spend gap are each
|
|
252
|
+
* stated as such rather than backfilled with a fabricated number, since the
|
|
253
|
+
* block is published verbatim and never recomputed. The remaining budget is derived from
|
|
254
|
+
* `total` and `spent()`, not read from the budget object.
|
|
255
|
+
* @param {{ total: number|null, spent?: () => number, pricingSummary?: () => { real: number, fallback: number } }} budget
|
|
256
|
+
* @param {{ spend?: number, dispatchCount?: number }} [integTestRunnerStats] -- apra-fleet-nwh.1:
|
|
257
|
+
* this sprint's own tracked integ-test-runner spend (a before/after
|
|
258
|
+
* `budget.spent()` delta accumulated by the caller around each Integ Test
|
|
259
|
+
* phase dispatch, see runSprintCycle's integTestRunnerSpend/
|
|
260
|
+
* integTestRunnerDispatchCount) and how many times that phase dispatched.
|
|
261
|
+
* Reported as its OWN line, distinct from doer/reviewer/overhead, instead
|
|
262
|
+
* of being silently folded into "overhead" -- often the single longest/
|
|
263
|
+
* most expensive phase (a full playbook run against a real sandbox).
|
|
264
|
+
* @returns {string}
|
|
265
|
+
*/
|
|
266
|
+
export function buildCostAnalysis(budget, integTestRunnerStats = {}) {
|
|
267
|
+
const total = budget && budget.total;
|
|
268
|
+
const spent = budget && typeof budget.spent === 'function' ? budget.spent() : null;
|
|
269
|
+
const lines = [
|
|
270
|
+
total !== null && total !== undefined
|
|
271
|
+
? `Budget ceiling: $${total.toFixed(4)}.`
|
|
272
|
+
: 'Budget ceiling: not set (no --budget flag) -- unlimited for this run.',
|
|
273
|
+
typeof spent === 'number'
|
|
274
|
+
? `Tracked spend (priced dispatches only): $${spent.toFixed(4)}.`
|
|
275
|
+
: 'Tracked spend: not tracked -- the budget object did not expose spent() for this run.',
|
|
276
|
+
];
|
|
277
|
+
if (total !== null && total !== undefined && typeof spent === 'number') {
|
|
278
|
+
lines.push(`Remaining budget: $${(total - spent).toFixed(4)}.`);
|
|
279
|
+
} else {
|
|
280
|
+
lines.push('Remaining budget: unknown/unbounded.');
|
|
281
|
+
}
|
|
282
|
+
// apra-fleet-nwh.1: an explicit integ-test-runner spend line, broken out
|
|
283
|
+
// of the totals above (it is a SUBSET of `spent`, not additional spend)
|
|
284
|
+
// so this often-longest phase is never silently bucketed into
|
|
285
|
+
// "overhead" by a reader of this block. Honest about all three states:
|
|
286
|
+
// the phase never dispatched this run, it dispatched but spend was not
|
|
287
|
+
// trackable (same `spent()`-unavailable case as above), or a real
|
|
288
|
+
// tracked figure.
|
|
289
|
+
const integDispatchCount = Number.isInteger(integTestRunnerStats.dispatchCount) ? integTestRunnerStats.dispatchCount : 0;
|
|
290
|
+
if (integDispatchCount === 0) {
|
|
291
|
+
lines.push('Integ-test-runner spend: $0.0000 -- no integ-test-runner dispatch ran this sprint (no playbook found, or deploy never succeeded).');
|
|
292
|
+
} else if (typeof spent !== 'number') {
|
|
293
|
+
lines.push(`Integ-test-runner spend: not tracked -- ${integDispatchCount} dispatch(es) ran but the budget object did not expose spent() for this run.`);
|
|
294
|
+
} else {
|
|
295
|
+
const integSpend = typeof integTestRunnerStats.spend === 'number' ? integTestRunnerStats.spend : 0;
|
|
296
|
+
lines.push(`Integ-test-runner spend: $${integSpend.toFixed(4)} across ${integDispatchCount} dispatch(es) this sprint (a subset of the tracked spend above, broken out of overhead/doer/reviewer).`);
|
|
297
|
+
}
|
|
298
|
+
// Report the SOURCE of each priced dispatch's cost -- real per-member
|
|
299
|
+
// rates vs. pricing.mjs's tier-band fallback -- so the figures above are
|
|
300
|
+
// not read as uniformly exact.
|
|
301
|
+
const summary = budget && typeof budget.pricingSummary === 'function' ? budget.pricingSummary() : null;
|
|
302
|
+
if (summary) {
|
|
303
|
+
const { real, fallback } = summary;
|
|
304
|
+
if (real === 0 && fallback === 0) {
|
|
305
|
+
lines.push('Pricing source: no dispatch was priced this run.');
|
|
306
|
+
} else if (real > 0 && fallback === 0) {
|
|
307
|
+
lines.push(`Pricing source: all ${real} priced dispatch(es) used real per-member rates (get_member_model_pricing).`);
|
|
308
|
+
} else if (real === 0 && fallback > 0) {
|
|
309
|
+
lines.push(`Pricing source: all ${fallback} priced dispatch(es) used the tier-band/concrete-model fallback estimate (real per-member pricing was unavailable) -- see pricing.mjs.`);
|
|
310
|
+
} else {
|
|
311
|
+
lines.push(`Pricing source: mixed -- ${real} dispatch(es) priced via real per-member rates, ${fallback} via the tier-band/concrete-model fallback estimate.`);
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
lines.push(
|
|
315
|
+
'Note: dispatches using an unpriced model id are not reflected above (see N10, feedback-reassessment.md) -- '
|
|
316
|
+
+ 'this figure is a lower bound on actual spend, not a complete total, and is reported honestly rather than fabricated.'
|
|
317
|
+
);
|
|
318
|
+
return lines.join('\n');
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
/**
|
|
322
|
+
* Computes the collision-resistant filesystem slug used for
|
|
323
|
+
* `docs/sprint-analysis-<slug>.md`, the harvester's `analysisArtifactFile`
|
|
324
|
+
* input.
|
|
325
|
+
*
|
|
326
|
+
* Replacing separators alone is not collision-free: two branches differing
|
|
327
|
+
* only in a `/` versus a pre-existing `-` at the same position (e.g.
|
|
328
|
+
* `feat/fleet-reorg` and `feat-fleet-reorg`) would collapse to the same slug
|
|
329
|
+
* and clobber each other's artifact. Appending a short hash of the RAW branch
|
|
330
|
+
* name disambiguates them while staying deterministic per branch, so reruns
|
|
331
|
+
* still produce the same slug.
|
|
332
|
+
* @param {string} branch
|
|
333
|
+
* @returns {string}
|
|
334
|
+
*/
|
|
335
|
+
export function computeBranchSlug(branch) {
|
|
336
|
+
const humanReadablePrefix = branch.replace(/[\\/]+/g, '-');
|
|
337
|
+
const disambiguatingHash = createHash('sha256').update(branch).digest('hex').slice(0, 8);
|
|
338
|
+
return `${humanReadablePrefix}-${disambiguatingHash}`;
|
|
339
|
+
}
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
import { ApraFleet } from '@apralabs/apra-fleet-client';
|
|
2
|
+
import { resolveMemberTarget } from './member-target.mjs';
|
|
3
|
+
import { createMemberVcsProviderResolver } from './vcs-auth.mjs';
|
|
4
|
+
|
|
5
|
+
// =============================================================================
|
|
6
|
+
// PER-SPRINT RESOLVED STATE (apra-fleet-3swo.6.1).
|
|
7
|
+
//
|
|
8
|
+
// One explicit object, created ONCE at sprint start (runSprintCycle) and
|
|
9
|
+
// threaded into every site that used to re-derive the same two things per
|
|
10
|
+
// call:
|
|
11
|
+
//
|
|
12
|
+
// 1. the fleet MCP client used to resolve a member's registered shell for
|
|
13
|
+
// the dolt-settle call sites. runner.js's `resolveSettleShell` built a
|
|
14
|
+
// brand new `ApraFleet({ callTool })` on EVERY invocation, at seven call
|
|
15
|
+
// sites, several of them per dispatch -- a fresh wrapper object per
|
|
16
|
+
// settle-shell resolution for the whole sprint. The wrapper is pure
|
|
17
|
+
// transport plumbing over the injected `callTool`, so exactly one is
|
|
18
|
+
// needed per sprint.
|
|
19
|
+
// 2. the per-member VCS provider resolver
|
|
20
|
+
// (`createMemberVcsProviderResolver`). This one was ALREADY constructed
|
|
21
|
+
// once per sprint inside runSprintCycle and already carries its own
|
|
22
|
+
// per-member Map cache; this module RELOCATES that single construction
|
|
23
|
+
// so the phase modules Phase 4 slices out of runSprintCycle receive it
|
|
24
|
+
// through sprint state instead of closing over a runSprintCycle local.
|
|
25
|
+
// It is deliberately NOT first-time caching, and no phase module may
|
|
26
|
+
// construct a second resolver of its own -- there must stay exactly one
|
|
27
|
+
// construction site in this directory (pinned by
|
|
28
|
+
// test/sprint-state.test.mjs).
|
|
29
|
+
//
|
|
30
|
+
// WHAT THIS MODULE DELIBERATELY DOES *NOT* CACHE -- READ BEFORE ADDING A MAP.
|
|
31
|
+
//
|
|
32
|
+
// The resolved { os, shell } pair is NOT memoized here, per member or
|
|
33
|
+
// otherwise. member-target.mjs owns that cache and deliberately caches ONLY a
|
|
34
|
+
// genuine member_detail-derived result: a member that was asleep, flaky over
|
|
35
|
+
// SSH or hit an MCP hiccup degrades to { os: 'linux', shell: '' } UNCACHED, so
|
|
36
|
+
// the next call re-resolves it instead of pinning it to POSIX command
|
|
37
|
+
// construction for the rest of the runner process (the auth-retry credential
|
|
38
|
+
// read at raiseVcsPrForMember depends on exactly that recovery --
|
|
39
|
+
// apra-fleet-ot2z.13).
|
|
40
|
+
//
|
|
41
|
+
// A sprint-state object that resolved every member once at sprint start and
|
|
42
|
+
// froze whatever it got would cache that fallback BY CONSTRUCTION and silently
|
|
43
|
+
// undo it. So this module holds the CLIENT (sprint-lifetime, cheap, stateless)
|
|
44
|
+
// and re-asks member-target.mjs on every resolution (which is a no-op for any
|
|
45
|
+
// member already resolved successfully). Do not "optimize" that into a shell
|
|
46
|
+
// cache here.
|
|
47
|
+
//
|
|
48
|
+
// CONTRACT: the resolved shell value set is unchanged for its three downstream
|
|
49
|
+
// consumers (dolt-settle.mjs, vcs-providers/azure-devops.mjs,
|
|
50
|
+
// vcs-providers/shell-helpers.mjs) -- 'gitbash', 'pwsh7', 'powershell5' or the
|
|
51
|
+
// empty string. Sites with no `callTool` wired (mock-sprint scenarios with no
|
|
52
|
+
// MCP client) keep the pre-shell-aware default of the empty string, exactly as
|
|
53
|
+
// runner.js's guarded `resolveSettleShell` did.
|
|
54
|
+
// =============================================================================
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Logged once per constructed sprint-scoped fleet client. Exported so a test
|
|
58
|
+
* can count constructions over a whole simulated sprint cycle from the run's
|
|
59
|
+
* logs without reaching into this module's internals.
|
|
60
|
+
*/
|
|
61
|
+
export const SPRINT_STATE_CLIENT_CONSTRUCTED_LOG =
|
|
62
|
+
'[sprint-state] constructed the sprint-scoped fleet client (one per sprint; every settle-shell resolution shares it).';
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Prefix logged on every settle-shell resolution served through the
|
|
66
|
+
* sprint-scoped client. Exported for the same reason as the constant above:
|
|
67
|
+
* it is the observable that distinguishes "resolved through sprint state" from
|
|
68
|
+
* "re-derived at the call site".
|
|
69
|
+
*/
|
|
70
|
+
export const SPRINT_STATE_SETTLE_SHELL_LOG_PREFIX = '[sprint-state] settle shell for member';
|
|
71
|
+
|
|
72
|
+
// callTool -> the single ApraFleet wrapper built over it. Keyed by the
|
|
73
|
+
// injected callTool function identity (which a sprint has exactly one of, from
|
|
74
|
+
// bin/cli.mjs's connected MCP client), so the call sites that receive only
|
|
75
|
+
// `args` -- syncMemberAfterOrdered, reached from git-sync.mjs's withGitSync
|
|
76
|
+
// teardown, which has no sprint-state to thread -- share the SAME client as
|
|
77
|
+
// the sprint-state object rather than reintroducing a per-call construction.
|
|
78
|
+
// A WeakMap so a finished sprint's callTool (and its client) stay collectable.
|
|
79
|
+
let fleetApiByCallTool = new WeakMap();
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Test seam: the client memo is process-lifetime state keyed by function
|
|
83
|
+
* identity, so a test that counts constructions must be able to drop it.
|
|
84
|
+
*/
|
|
85
|
+
export function clearSprintStateClientCache() {
|
|
86
|
+
fleetApiByCallTool = new WeakMap();
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* The one fleet client per `callTool`. Returns null when no callTool is wired
|
|
91
|
+
* (no MCP client -- nothing to build a client over), which every caller treats
|
|
92
|
+
* as "keep the pre-shell-aware default".
|
|
93
|
+
*
|
|
94
|
+
* @param {{ callTool?: Function, log?: Function, createFleetApi?: (opts: object) => object }} opts
|
|
95
|
+
* `createFleetApi` is an injectable construction seam (defaults to
|
|
96
|
+
* `new ApraFleet(...)`) so a test can COUNT constructions -- the property
|
|
97
|
+
* this hoist creates is unobservable through callTool alone, since building
|
|
98
|
+
* the wrapper makes no MCP call.
|
|
99
|
+
* @returns {object|null}
|
|
100
|
+
*/
|
|
101
|
+
export function sprintScopedFleetApi({ callTool, log = () => {}, createFleetApi } = {}) {
|
|
102
|
+
if (typeof callTool !== 'function') return null;
|
|
103
|
+
const cached = fleetApiByCallTool.get(callTool);
|
|
104
|
+
if (cached) return cached;
|
|
105
|
+
const construct = typeof createFleetApi === 'function' ? createFleetApi : (opts) => new ApraFleet(opts);
|
|
106
|
+
const fleetApi = construct({ callTool });
|
|
107
|
+
fleetApiByCallTool.set(callTool, fleetApi);
|
|
108
|
+
log(SPRINT_STATE_CLIENT_CONSTRUCTED_LOG);
|
|
109
|
+
return fleetApi;
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* Resolves `member`'s registered shell through an already-built client. No
|
|
114
|
+
* memoization here on purpose (see this file's header): member-target.mjs is
|
|
115
|
+
* the single owner of the { os, shell } cache and of the deliberately
|
|
116
|
+
* UNCACHED degrade, so a transiently-unreachable member is re-resolved on the
|
|
117
|
+
* next call.
|
|
118
|
+
*
|
|
119
|
+
* @param {{ fleetApi?: object|null, member: string, log?: Function }} opts
|
|
120
|
+
* @returns {Promise<string>} 'gitbash' | 'pwsh7' | 'powershell5' | ''
|
|
121
|
+
*/
|
|
122
|
+
export async function resolveSettleShellWith({ fleetApi, member, log = () => {} }) {
|
|
123
|
+
if (!fleetApi) return '';
|
|
124
|
+
const target = await resolveMemberTarget({ fleetApi, member, log });
|
|
125
|
+
log(`${SPRINT_STATE_SETTLE_SHELL_LOG_PREFIX} '${member}' resolved to '${target.shell}' through the sprint-scoped fleet client.`);
|
|
126
|
+
return target.shell;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/**
|
|
130
|
+
* Builds the sprint's resolved state. Called exactly ONCE per sprint, at the
|
|
131
|
+
* top of runSprintCycle, and threaded from there -- never rebuilt per phase or
|
|
132
|
+
* per call site.
|
|
133
|
+
*
|
|
134
|
+
* @param {{ callTool?: Function, log?: Function, createFleetApi?: (opts: object) => object }} opts
|
|
135
|
+
* @returns {{
|
|
136
|
+
* callTool: Function|undefined,
|
|
137
|
+
* fleetApi: object|null,
|
|
138
|
+
* resolveMemberProvider: ((member: string) => Promise<string|undefined>)|undefined,
|
|
139
|
+
* resolveSettleShell: (opts: { member: string, log?: Function }) => Promise<string>,
|
|
140
|
+
* dispatchToolCalls: object[],
|
|
141
|
+
* memberInit: object[],
|
|
142
|
+
* startedAtMs: number,
|
|
143
|
+
* }}
|
|
144
|
+
*
|
|
145
|
+
* `dispatchToolCalls` is the sprint's per-dispatch kb_* and code_* call record
|
|
146
|
+
* list (dispatch-accounting.mjs appends one entry per member dispatch, from
|
|
147
|
+
* session_stats snapshots taken before and after it). The sprint summary and
|
|
148
|
+
* the viewer read it from here.
|
|
149
|
+
*
|
|
150
|
+
* `memberInit` holds one record per member from the sprint-init probe
|
|
151
|
+
* (member-init-probe.mjs MemberInitRecord): verified status, fleetMcp, tool
|
|
152
|
+
* presence, CONFIRMED count and code index state. Filled once at sprint init
|
|
153
|
+
* and read by the KNOWLEDGE BANK injection and the viewer.
|
|
154
|
+
*/
|
|
155
|
+
export function createSprintState({ callTool, log = () => {}, createFleetApi } = {}) {
|
|
156
|
+
const active = typeof callTool === 'function';
|
|
157
|
+
const fleetApi = active ? sprintScopedFleetApi({ callTool, log, createFleetApi }) : null;
|
|
158
|
+
// The RELOCATED single construction (see this file's header, point 2).
|
|
159
|
+
// Undefined when no callTool is wired, which is the pre-existing tier-3
|
|
160
|
+
// behavior at runSprintCycle's old construction site: every runGitStep
|
|
161
|
+
// falls back to the default provider chain. A provider that fails to
|
|
162
|
+
// resolve still degrades to that same default chain with a logged
|
|
163
|
+
// non-fatal message and no throw, and an unresolvable member is still
|
|
164
|
+
// cached as undefined exactly once -- all of that lives in
|
|
165
|
+
// createMemberVcsProviderResolver and is unchanged by the relocation.
|
|
166
|
+
const resolveMemberProvider = active ? createMemberVcsProviderResolver({ callTool, log }) : undefined;
|
|
167
|
+
|
|
168
|
+
// The sprint's ONE start stamp, taken when the state is built at the top
|
|
169
|
+
// of runSprintCycle. Every "since this sprint started" decision reads it
|
|
170
|
+
// (the stale in_progress reclaim, the KB promotion-candidate window)
|
|
171
|
+
// rather than taking its own Date.now().
|
|
172
|
+
const startedAtMs = Date.now();
|
|
173
|
+
|
|
174
|
+
return {
|
|
175
|
+
startedAtMs,
|
|
176
|
+
callTool: active ? callTool : undefined,
|
|
177
|
+
fleetApi,
|
|
178
|
+
resolveMemberProvider,
|
|
179
|
+
resolveSettleShell({ member, log: callLog = log } = {}) {
|
|
180
|
+
return resolveSettleShellWith({ fleetApi, member, log: callLog });
|
|
181
|
+
},
|
|
182
|
+
dispatchToolCalls: [],
|
|
183
|
+
memberInit: [],
|
|
184
|
+
};
|
|
185
|
+
}
|