@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,365 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// PHASE MODULE: Review (apra-fleet-3swo.6.5).
|
|
3
|
+
//
|
|
4
|
+
// The FIFTH of runSprintCycle's twelve phase() boundaries -- the per-round
|
|
5
|
+
// REVIEW of the work the Develop phase just produced: gather the round's
|
|
6
|
+
// acceptance criteria, dispatch the reviewer, and then have the ORCHESTRATOR
|
|
7
|
+
// (never the LLM) apply every structured transition the verdict asks for --
|
|
8
|
+
// guarded reopens, the in-cycle replan fold-in, and validated newTask
|
|
9
|
+
// creation -- before D-pushing the beads it just mutated. Moved verbatim out
|
|
10
|
+
// of runner.js: every prompt, log line, dispatch option, validation branch and
|
|
11
|
+
// sync call is byte-identical to the inline version, so the golden transcript
|
|
12
|
+
// is unchanged. Move-only, no behaviour change.
|
|
13
|
+
//
|
|
14
|
+
// WHERE THIS PHASE STARTS AND STOPS. It starts at its own phase() call and
|
|
15
|
+
// ends at the post-mutation `gitSync.syncBeadsAfter(...)` that closes the
|
|
16
|
+
// `assignedBeadIds.length > 0` branch. The `await updateDashboard()` and the
|
|
17
|
+
// `readyLeafBeads()` still-open check that follow it in runner.js are NOT part
|
|
18
|
+
// of this phase: they are the round loop's own continue/break decision (the
|
|
19
|
+
// second one `break`s, which cannot be expressed from inside a function), and
|
|
20
|
+
// they run identically whether or not a review was dispatched this round.
|
|
21
|
+
//
|
|
22
|
+
// WHY devRounds IS PASSED IN ALREADY INCREMENTED. Same reason as
|
|
23
|
+
// ./replan.mjs and ./develop.mjs: `devRounds` is the round loop's own counter,
|
|
24
|
+
// so the increment stays next to the loop and the incremented value arrives
|
|
25
|
+
// here only to build the `Review C{cycle} R{devRounds}` label.
|
|
26
|
+
//
|
|
27
|
+
// EXPLICIT STATE, NOT A CLOSURE -- AND WHY THREE VALUES COME BACK. The inline
|
|
28
|
+
// version read its inputs off the enclosing runSprintCycle/round-loop scope.
|
|
29
|
+
// They arrive as one explicit state argument now. Most of what this phase
|
|
30
|
+
// writes is MUTATED IN PLACE on objects the caller still holds -- `replanIds`
|
|
31
|
+
// and `replannedThisCycle` (Sets), `perBeadFeedback` (a Map, written through
|
|
32
|
+
// applyGuardedReopens' onReopened hook) and `rejectedNewTasks` (an array) --
|
|
33
|
+
// which is exactly equivalent to the closure it replaces, because runner.js
|
|
34
|
+
// never reassigns those bindings either.
|
|
35
|
+
//
|
|
36
|
+
// Three values are genuinely REASSIGNED rather than mutated, so they cannot
|
|
37
|
+
// travel that way and are returned instead: `lastReviewVerdict` and
|
|
38
|
+
// `reviewedThisCycle`, which the Cycle Evaluation section reads to decide
|
|
39
|
+
// whether a real review happened this cycle and what it concluded, and
|
|
40
|
+
// `pendingRejectedNewTasks`, which trackRejectedNewTaskForResurfacing()/
|
|
41
|
+
// clearResubmittedNewTask() return a NEW list from every time. They are also
|
|
42
|
+
// passed IN, so the round where the empty-guard skips the review dispatch
|
|
43
|
+
// returns them unchanged and the caller's single destructuring assignment is
|
|
44
|
+
// a no-op -- which is what keeps the call site free of an `if`.
|
|
45
|
+
//
|
|
46
|
+
// WHY SOME HELPERS ARE INJECTED RATHER THAN IMPORTED. dispatchReview,
|
|
47
|
+
// bdListScoped, goalMax, recordReopen, childIdAllocator and sprintMutexId are
|
|
48
|
+
// runSprintCycle-scoped locals, so there is nothing to import. computeChildFloor,
|
|
49
|
+
// createChildBeadWithAllocatedId, trackRejectedNewTaskForResurfacing and
|
|
50
|
+
// clearResubmittedNewTask are exported BY runner.js; importing them here would
|
|
51
|
+
// make phases/review.mjs <-> runner.js a circular pair for the sake of four
|
|
52
|
+
// helpers, so they come through the state argument instead -- the same rule
|
|
53
|
+
// phases/plan.mjs's and phases/develop.mjs's headers state. The dependencies
|
|
54
|
+
// that live in real sibling modules (applyGuardedReopens/foldReplanIds from
|
|
55
|
+
// ../beads-transitions.mjs, validateNewTask/appendRejectedFindingToParentNotes/
|
|
56
|
+
// persistNewTaskBestEffort from ../abort.mjs) are imported directly.
|
|
57
|
+
//
|
|
58
|
+
// GUARD COVERAGE: registered as 'phases/review.mjs' in ../guarded-modules.mjs.
|
|
59
|
+
// It took ONE member_name-bearing command() call site out of runner.js (the
|
|
60
|
+
// `bd show <ids> --json` acceptance-criteria read); the reopen and newTask
|
|
61
|
+
// writes reach bd through injected helpers that issue their own command()
|
|
62
|
+
// calls in the modules that already own them, and its only push is the shared
|
|
63
|
+
// gitSync bracket at the end. It carries NO dispatchRole() call site of its
|
|
64
|
+
// own: the reviewer ladder runs through runner.js's dispatchReview() helper,
|
|
65
|
+
// which stays there because the Re-Review and Final Review phases call it too.
|
|
66
|
+
// =============================================================================
|
|
67
|
+
|
|
68
|
+
import { applyGuardedReopens, foldReplanIds, ensureRedBranchFixTask, isInGoalPriority } from '../beads-transitions.mjs';
|
|
69
|
+
import {
|
|
70
|
+
validateNewTask, appendRejectedFindingToParentNotes, persistNewTaskBestEffort,
|
|
71
|
+
} from '../abort.mjs';
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* The bead ids a round's Review covers: the union of every streak outcome's
|
|
75
|
+
* `closedIds` (the ENGINE's read-back of the shared beads DB -- the
|
|
76
|
+
* verify-streak-closed step on success, verifyDoerStreakClosed on the error
|
|
77
|
+
* path; never the doer's own claim), de-duplicated, minus outcomes whose
|
|
78
|
+
* closes were not published (`publishBlocked` for a permission-scope G-push
|
|
79
|
+
* refusal, `postDispatchSyncFailed` for any other post-dispatch sync failure:
|
|
80
|
+
* a failed G-push skips the D-push, so those closes never reached the shared
|
|
81
|
+
* DB). A failed or BLOCKED streak therefore still contributes the beads it
|
|
82
|
+
* verifiably closed; one that closed nothing contributes nothing.
|
|
83
|
+
*
|
|
84
|
+
* @param {object[]} streakOutcomes
|
|
85
|
+
* @returns {string[]} de-duplicated bead ids, in first-seen order
|
|
86
|
+
*/
|
|
87
|
+
export function reviewScopeBeadIds(streakOutcomes) {
|
|
88
|
+
const seen = new Set();
|
|
89
|
+
for (const o of streakOutcomes || []) {
|
|
90
|
+
if (!o || o.publishBlocked || o.postDispatchSyncFailed) continue;
|
|
91
|
+
for (const id of Array.isArray(o.closedIds) ? o.closedIds : []) seen.add(id);
|
|
92
|
+
}
|
|
93
|
+
return [...seen];
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* Runs ONE Review round: reviewer dispatch plus the orchestrator-applied
|
|
98
|
+
* transitions its verdict asks for.
|
|
99
|
+
*
|
|
100
|
+
* @param {object} state Explicit phase state; see this file's header.
|
|
101
|
+
* @returns {Promise<{
|
|
102
|
+
* lastReviewVerdict: string|undefined,
|
|
103
|
+
* reviewedThisCycle: boolean,
|
|
104
|
+
* pendingRejectedNewTasks: object[],
|
|
105
|
+
* }>} The three REASSIGNED values described in the header. Every other output
|
|
106
|
+
* of this phase is an in-place mutation of a Set/Map/array the caller still
|
|
107
|
+
* holds. On the empty-scope round (every streak failed) all three come back
|
|
108
|
+
* exactly as they were passed in.
|
|
109
|
+
*/
|
|
110
|
+
export async function runReviewPhase({
|
|
111
|
+
// Presentation + dispatch seams.
|
|
112
|
+
phase,
|
|
113
|
+
log,
|
|
114
|
+
command,
|
|
115
|
+
// Sprint identity/config.
|
|
116
|
+
cycle,
|
|
117
|
+
validated,
|
|
118
|
+
targetIssues,
|
|
119
|
+
backlogMember,
|
|
120
|
+
// The git/beads sync bracket this phase's post-mutation D-push goes
|
|
121
|
+
// through.
|
|
122
|
+
gitSync,
|
|
123
|
+
// Per-cycle state. `replanIds`, `replannedThisCycle`, `perBeadFeedback` and
|
|
124
|
+
// `rejectedNewTasks` are mutated in place (see header).
|
|
125
|
+
replanIds,
|
|
126
|
+
replannedThisCycle,
|
|
127
|
+
perBeadFeedback,
|
|
128
|
+
rejectedNewTasks,
|
|
129
|
+
// Per-round inputs. `devRounds` arrives already incremented (see header);
|
|
130
|
+
// the other two are this round's Develop phase output.
|
|
131
|
+
devRounds,
|
|
132
|
+
streakOutcomes,
|
|
133
|
+
readyTitleById,
|
|
134
|
+
// Reassigned, so passed in and returned (see header).
|
|
135
|
+
lastReviewVerdict,
|
|
136
|
+
reviewedThisCycle,
|
|
137
|
+
pendingRejectedNewTasks,
|
|
138
|
+
// runSprintCycle-scoped locals and runner.js-exported helpers, injected
|
|
139
|
+
// rather than imported (see header).
|
|
140
|
+
dispatchReview,
|
|
141
|
+
bdListScoped,
|
|
142
|
+
goalMax,
|
|
143
|
+
// Bead ids this sprint has dispatched or closed: a below-goal reopen of
|
|
144
|
+
// one of them is applied, not deferred (see isDeferredScopeReopen).
|
|
145
|
+
workedOnIds,
|
|
146
|
+
recordReopen,
|
|
147
|
+
childIdAllocator,
|
|
148
|
+
sprintMutexId,
|
|
149
|
+
computeChildFloor,
|
|
150
|
+
createChildBeadWithAllocatedId,
|
|
151
|
+
trackRejectedNewTaskForResurfacing,
|
|
152
|
+
clearResubmittedNewTask,
|
|
153
|
+
}) {
|
|
154
|
+
// --- Review: self-contained, schema-validated, orchestrator-applied ---
|
|
155
|
+
phase(`Review C${cycle} R${devRounds}`);
|
|
156
|
+
// Sort by (title, id) -- not raw outcome-recording order -- so this
|
|
157
|
+
// evidence-gathering step is deterministic. See the readyTitleById
|
|
158
|
+
// comment just above.
|
|
159
|
+
// Review scope = every bead the engine's own read-back confirmed
|
|
160
|
+
// closed AND published (see reviewScopeBeadIds), including beads a
|
|
161
|
+
// failed or BLOCKED streak closed before it stopped.
|
|
162
|
+
const assignedBeadIds = reviewScopeBeadIds(streakOutcomes)
|
|
163
|
+
.slice().sort((a, b) => {
|
|
164
|
+
const ta = readyTitleById.get(a) || a;
|
|
165
|
+
const tb = readyTitleById.get(b) || b;
|
|
166
|
+
return ta.localeCompare(tb) || a.localeCompare(b);
|
|
167
|
+
});
|
|
168
|
+
const acceptanceCriteriaJson = assignedBeadIds.length > 0
|
|
169
|
+
? await command(`bd show ${assignedBeadIds.join(' ')} --json`, { member_name: backlogMember, silent: true })
|
|
170
|
+
: '[]';
|
|
171
|
+
|
|
172
|
+
// Empty-guard: when EVERY streak this round failed, assignedBeadIds
|
|
173
|
+
// is [] and there is nothing for the Reviewer to look at. Skip the
|
|
174
|
+
// dispatch entirely rather than sending an empty-scope review: an
|
|
175
|
+
// empty review is prone to returning CHANGES_NEEDED with empty
|
|
176
|
+
// reopenIds+newTasks, which trips the contract-violation check below
|
|
177
|
+
// and, after the retry-once path, throws
|
|
178
|
+
// ReviewerContractViolationError -- a hard sprint abort over a round
|
|
179
|
+
// where no work happened at all. The `stillOpen` check just below
|
|
180
|
+
// still runs, so the loop correctly continues instead of prematurely
|
|
181
|
+
// treating the cycle as organically complete.
|
|
182
|
+
if (assignedBeadIds.length === 0) {
|
|
183
|
+
log(`Develop C${cycle} R${devRounds}: all streaks this round failed with no beadIds assigned -- skipping Review dispatch (nothing to review). Failed-streak beads remain ready for the next Develop round.`);
|
|
184
|
+
} else {
|
|
185
|
+
// dispatchReview() applies the shared contract-violation
|
|
186
|
+
// retry-once-then-throw rule (see its own doc comment and
|
|
187
|
+
// ReviewerContractViolationError) -- a CHANGES_NEEDED verdict with
|
|
188
|
+
// both reopenIds and newTasks empty is self-contradictory and must
|
|
189
|
+
// never be treated as an ordinary "more work needed" round.
|
|
190
|
+
const verdict = await dispatchReview({ beadIds: assignedBeadIds, acceptanceCriteriaJson });
|
|
191
|
+
// KB trust pipeline Phase 2: the reviewer decides, the engine
|
|
192
|
+
// executes. Reviewer is the ONLY role whose kb_promotions are
|
|
193
|
+
// honoured. apra-fleet-3swo.5.7: performed by the 'reviewer' row's
|
|
194
|
+
// 'kb-apply' postResult step inside dispatchReview, so BOTH of its
|
|
195
|
+
// call sites get it and a degraded round (which fabricates a
|
|
196
|
+
// verdict carrying no KB fields) does not.
|
|
197
|
+
// A5: the last reviewer verdict seen THIS cycle feeds the Cycle
|
|
198
|
+
// Evaluation section's completion check below -- goal-priority
|
|
199
|
+
// completion requires this to be exactly 'APPROVED', not just
|
|
200
|
+
// an empty ready-bead list.
|
|
201
|
+
lastReviewVerdict = verdict.verdict;
|
|
202
|
+
// A review genuinely ran THIS cycle -- the Cycle Evaluation section
|
|
203
|
+
// below only trusts `lastReviewVerdict` when this is true (see the
|
|
204
|
+
// `reviewedThisCycle` reset at the top of the cycle loop and the
|
|
205
|
+
// re-review dispatch it guards).
|
|
206
|
+
reviewedThisCycle = true;
|
|
207
|
+
|
|
208
|
+
// Orchestrator (this code) -- NOT the LLM -- applies every
|
|
209
|
+
// structured transition: reopenIds via `bd update --status=open`,
|
|
210
|
+
// newTasks via `bd create`. The reviewer's dispatch prompt above
|
|
211
|
+
// explicitly forbade it from mutating beads itself; this is the
|
|
212
|
+
// enforcement side of that contract (SKILL.md).
|
|
213
|
+
// Deterministic goal-scope guard on reopenIds: the prompt-side
|
|
214
|
+
// instruction (buildReviewerPrompt) asks the reviewer not to reopen
|
|
215
|
+
// below-goal beads, but the orchestrator enforces it -- reopening a
|
|
216
|
+
// DEFERRED P3 feature in a P1/P2 sprint injects out-of-scope work and
|
|
217
|
+
// pins the verdict at CHANGES_NEEDED forever.
|
|
218
|
+
// Ids actually reopened this round (survived the goal-scope
|
|
219
|
+
// allowlist) -- gates which `replanIds` entries below are trusted,
|
|
220
|
+
// so a reviewer naming a replanIds id that was never really
|
|
221
|
+
// reopened (out of scope, or simply absent from reopenIds) can
|
|
222
|
+
// never short-circuit the loop.
|
|
223
|
+
const reopenedIds = new Set(await applyGuardedReopens({
|
|
224
|
+
entries: verdict.reopenIds,
|
|
225
|
+
bdListScoped, goalMax, goal: validated.goal, log, command,
|
|
226
|
+
member: backlogMember,
|
|
227
|
+
workedOnIds,
|
|
228
|
+
logPrefix: 'Reviewer reopenIds',
|
|
229
|
+
buildReopenCommand: ({ id }) => ({
|
|
230
|
+
cmd: `bd update ${id} --status=open`,
|
|
231
|
+
label: `Reopen ${id} per reviewer verdict`,
|
|
232
|
+
}),
|
|
233
|
+
onReopened: ({ id }) => {
|
|
234
|
+
// Track per-bead reopen counts for reopen-thrash detection.
|
|
235
|
+
recordReopen(id);
|
|
236
|
+
// Per-bead feedback routing: only beads named in reopenIds
|
|
237
|
+
// carry this round's feedback into the next round's doer
|
|
238
|
+
// prompt -- never a blanket broadcast.
|
|
239
|
+
perBeadFeedback.set(id, verdict.notes);
|
|
240
|
+
},
|
|
241
|
+
}));
|
|
242
|
+
// Fold this round's reviewer `replanIds` (absent/undefined on
|
|
243
|
+
// verdicts that do not use it, so a no-op then) into the cycle's
|
|
244
|
+
// running union, consulted at the top of the next iteration's
|
|
245
|
+
// currentReady computation above. Only ids that were ACTUALLY
|
|
246
|
+
// reopened this round are tracked -- an id the reviewer named in
|
|
247
|
+
// replanIds without ALSO naming it in reopenIds (contrary to the
|
|
248
|
+
// buildReviewerPrompt instruction above) is dropped rather than
|
|
249
|
+
// silently ignored: logged here so the drop is visible in the run
|
|
250
|
+
// log instead of vanishing with no trace.
|
|
251
|
+
// This is the replan loop guard's single enforcement point. A bead
|
|
252
|
+
// that has ALREADY been through one in-cycle scoped replan this cycle
|
|
253
|
+
// (replannedThisCycle) is refused a SECOND: it stays reopened (real
|
|
254
|
+
// dev feedback still applies) but is NOT re-added to replanIds, so
|
|
255
|
+
// the develop loop above never dispatches a second scoped planner
|
|
256
|
+
// pass for it -- it is handed to the next cycle's planner instead.
|
|
257
|
+
// This is what makes "max one scoped replan per bead per cycle" hold
|
|
258
|
+
// regardless of the round budget.
|
|
259
|
+
for (const id of foldReplanIds({
|
|
260
|
+
replanIds: verdict.replanIds, reopenedIds, replannedThisCycle, cycle, log,
|
|
261
|
+
})) {
|
|
262
|
+
replanIds.add(id);
|
|
263
|
+
}
|
|
264
|
+
// newTasks that landed at an in-goal priority -- one of these (or a
|
|
265
|
+
// surviving reopen) is what keeps a red branch from being left with no
|
|
266
|
+
// dispatchable work (see ensureRedBranchFixTask below).
|
|
267
|
+
let inGoalNewTaskCount = 0;
|
|
268
|
+
for (const newTask of verdict.newTasks) {
|
|
269
|
+
// Validate BEFORE interpolation -- see validateNewTask() above
|
|
270
|
+
// for why this is an allowlist, not escaping. A rejection is
|
|
271
|
+
// logged, recorded for the final-review evidence summary, and
|
|
272
|
+
// skipped; it must never abort the sprint over one bad newTask.
|
|
273
|
+
const validation = validateNewTask(newTask);
|
|
274
|
+
if (!validation.ok) {
|
|
275
|
+
log(`Reviewer newTasks: REJECTED (not sent to bd create) -- ${validation.reason}`);
|
|
276
|
+
rejectedNewTasks.push({ cycle, reason: validation.reason, raw: newTask });
|
|
277
|
+
// Track it for resurfacing into the NEXT planning-phase
|
|
278
|
+
// dispatch too -- see trackRejectedNewTaskForResurfacing()'s
|
|
279
|
+
// doc comment.
|
|
280
|
+
pendingRejectedNewTasks = trackRejectedNewTaskForResurfacing(pendingRejectedNewTasks, {
|
|
281
|
+
title: newTask && newTask.title, description: newTask && newTask.description,
|
|
282
|
+
reason: validation.reason, cycle,
|
|
283
|
+
});
|
|
284
|
+
// A rejected finding must never simply vanish -- persist it
|
|
285
|
+
// verbatim to the parent bead's notes as a fallback (itself
|
|
286
|
+
// non-fatal: a notes write failure degrades to the run log,
|
|
287
|
+
// never an abort).
|
|
288
|
+
try {
|
|
289
|
+
await appendRejectedFindingToParentNotes({
|
|
290
|
+
command, member: backlogMember, parentId: targetIssues[0],
|
|
291
|
+
newTask, reason: validation.reason, cycle, log,
|
|
292
|
+
});
|
|
293
|
+
} catch (noteErr) {
|
|
294
|
+
log(`[fleet-sprint] rejected-finding notes fallback FAILED (non-fatal): ${noteErr.message}; finding preserved VERBATIM in this run log: ${JSON.stringify(newTask)}`);
|
|
295
|
+
}
|
|
296
|
+
continue;
|
|
297
|
+
}
|
|
298
|
+
const { title, description, priority } = validation;
|
|
299
|
+
// A bead can only have one parent -- see the matching
|
|
300
|
+
// comment on the re-review newTasks site below.
|
|
301
|
+
//
|
|
302
|
+
// Mint the child id through the supervisor-owned allocator so two
|
|
303
|
+
// concurrent sprints creating follow-up work under the SAME
|
|
304
|
+
// parent never derive the same child id. Under the null client
|
|
305
|
+
// (lone sprint) childId is null and bd derives the id as before.
|
|
306
|
+
const persisted = await persistNewTaskBestEffort({
|
|
307
|
+
command, member: backlogMember, parentId: targetIssues[0],
|
|
308
|
+
newTask, cycle, log, stage: 'develop-review',
|
|
309
|
+
createFn: async () => {
|
|
310
|
+
const floor = await computeChildFloor({ command, member: backlogMember, parentId: targetIssues[0], log });
|
|
311
|
+
await createChildBeadWithAllocatedId({
|
|
312
|
+
command, allocator: childIdAllocator, member: backlogMember,
|
|
313
|
+
title, description, priority, parentId: targetIssues[0],
|
|
314
|
+
sprintId: sprintMutexId, floor, log,
|
|
315
|
+
label: `Create follow-up task from reviewer newTasks: ${title}`,
|
|
316
|
+
});
|
|
317
|
+
},
|
|
318
|
+
});
|
|
319
|
+
// This title just landed as a real bead -- if it was a
|
|
320
|
+
// resubmission of an earlier rejected item, drop it from the
|
|
321
|
+
// pending resurface list so it stops reappearing in future
|
|
322
|
+
// planning prompts. Pass title+description (not just title) so a
|
|
323
|
+
// resubmission that also corrected its title still clears via its
|
|
324
|
+
// unchanged description.
|
|
325
|
+
if (persisted) {
|
|
326
|
+
pendingRejectedNewTasks = clearResubmittedNewTask(pendingRejectedNewTasks, { title, description });
|
|
327
|
+
if (isInGoalPriority(priority, goalMax)) inGoalNewTaskCount += 1;
|
|
328
|
+
}
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
// A red branch must never be left with zero open work: when the verdict
|
|
332
|
+
// reports failing build/tests and no reopen or in-goal newTask survived
|
|
333
|
+
// (all filtered by the goal-scope guard, or none named), file one in-goal
|
|
334
|
+
// fix task carrying the reviewer's notes.
|
|
335
|
+
await ensureRedBranchFixTask({
|
|
336
|
+
verdict,
|
|
337
|
+
reopenedCount: reopenedIds.size,
|
|
338
|
+
inGoalNewTaskCount,
|
|
339
|
+
skippedReopenIds: (verdict.reopenIds || []).filter((id) => typeof id === 'string' && !reopenedIds.has(id)),
|
|
340
|
+
goal: validated.goal,
|
|
341
|
+
site: `Review C${cycle} R${devRounds}`,
|
|
342
|
+
bdListScoped, log,
|
|
343
|
+
createTask: (task) => persistNewTaskBestEffort({
|
|
344
|
+
command, member: backlogMember, parentId: targetIssues[0],
|
|
345
|
+
newTask: task, cycle, log, stage: 'develop-review-red-branch',
|
|
346
|
+
createFn: async () => {
|
|
347
|
+
const floor = await computeChildFloor({ command, member: backlogMember, parentId: targetIssues[0], log });
|
|
348
|
+
return createChildBeadWithAllocatedId({
|
|
349
|
+
command, allocator: childIdAllocator, member: backlogMember,
|
|
350
|
+
title: task.title, description: task.description, priority: task.priority,
|
|
351
|
+
parentId: targetIssues[0], sprintId: sprintMutexId, floor, log,
|
|
352
|
+
label: `Create red-branch fix task: ${task.title}`,
|
|
353
|
+
});
|
|
354
|
+
},
|
|
355
|
+
}),
|
|
356
|
+
});
|
|
357
|
+
|
|
358
|
+
// The orchestrator just MUTATED beads (reopens + newTask creates) in
|
|
359
|
+
// its own clone -- D-push so members observe them on their next
|
|
360
|
+
// dispatch's D-pull.
|
|
361
|
+
await gitSync.syncBeadsAfter(backlogMember, { pushBeads: true });
|
|
362
|
+
} // end assignedBeadIds.length > 0 (Review dispatch + orchestrator-applied transitions)
|
|
363
|
+
|
|
364
|
+
return { lastReviewVerdict, reviewedThisCycle, pendingRejectedNewTasks };
|
|
365
|
+
}
|
|
@@ -0,0 +1,259 @@
|
|
|
1
|
+
// Sprint pull-request title/body builder for the Publish PR step and the
|
|
2
|
+
// [ABORTED] PR path (abort.mjs). Pure: no I/O, no clock reads unless the
|
|
3
|
+
// caller omits `now`.
|
|
4
|
+
//
|
|
5
|
+
// WHY THIS EXISTS. The PR body used to embed the final reviewer's notes
|
|
6
|
+
// through sanitizePrText() (sprint-report.mjs), a single-line shell-argument
|
|
7
|
+
// sanitizer that maps every newline to a space and collapses all whitespace
|
|
8
|
+
// -- so a reviewer's paragraphs and bullet list reached the PR as one
|
|
9
|
+
// unreadable paragraph. The body never needed that: every provider's
|
|
10
|
+
// create/update-pull-request builder JSON-encodes the body (newlines become
|
|
11
|
+
// the two characters `\n`) and quotes the JSON per member shell
|
|
12
|
+
// (vcs-providers/shell-helpers.mjs shQuoteJson), so a multi-line body is
|
|
13
|
+
// already transport-safe. What untrusted text DOES still need is
|
|
14
|
+
// markdown/transport hygiene, which sanitizePrMarkdown() below provides while
|
|
15
|
+
// keeping line structure.
|
|
16
|
+
//
|
|
17
|
+
// RUN HISTORY. Each sprint end rewrites the PR title/body with its own
|
|
18
|
+
// verdict; earlier runs are carried forward compactly in a hidden,
|
|
19
|
+
// engine-written HTML comment block (RUN_HISTORY_MARKER) that the next run
|
|
20
|
+
// parses back. A body without the block (a PR created before this format, or
|
|
21
|
+
// hand-edited) simply starts a fresh history.
|
|
22
|
+
//
|
|
23
|
+
// ASCII only.
|
|
24
|
+
|
|
25
|
+
import { PR_DESCRIPTION_MAX_LENGTH } from './vcs-module.mjs';
|
|
26
|
+
|
|
27
|
+
/** Opening token of the hidden run-history block. Versioned so a future
|
|
28
|
+
* format change can tell its own blocks from this one. */
|
|
29
|
+
export const RUN_HISTORY_MARKER = 'fleet-sprint:run-history v1';
|
|
30
|
+
|
|
31
|
+
/** Total runs (current + previous) kept in the history block. */
|
|
32
|
+
export const RUN_HISTORY_MAX_ENTRIES = 8;
|
|
33
|
+
|
|
34
|
+
/** Upper bound on the reviewer-notes section before the whole-body budget
|
|
35
|
+
* (PR_DESCRIPTION_MAX_LENGTH) is even considered. */
|
|
36
|
+
export const PR_NOTES_MAX_LENGTH = 2000;
|
|
37
|
+
|
|
38
|
+
const VERDICTS = new Set(['PASS', 'FAIL', 'ABORTED']);
|
|
39
|
+
const RUN_ID_UNSAFE_RE = /[^A-Za-z0-9._:/-]/g;
|
|
40
|
+
const RUN_ID_MAX = 64;
|
|
41
|
+
const DATE_RE = /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}Z)?$/;
|
|
42
|
+
const HUMAN_REVIEW_LINE = 'Do NOT auto-merge -- see pm skill R12; a human must review and merge this PR.';
|
|
43
|
+
|
|
44
|
+
// Common typographic code points LLM text carries, mapped to ASCII so the
|
|
45
|
+
// body stays ASCII end to end (PowerShell 5.1 argv and some REST stacks do
|
|
46
|
+
// not round-trip arbitrary UTF-8 reliably). Anything else non-ASCII becomes
|
|
47
|
+
// '?'.
|
|
48
|
+
const ASCII_MAP = new Map([
|
|
49
|
+
[0x2018, "'"], [0x2019, "'"], [0x201A, "'"], [0x201B, "'"],
|
|
50
|
+
[0x201C, '"'], [0x201D, '"'], [0x201E, '"'], [0x201F, '"'],
|
|
51
|
+
[0x2010, '-'], [0x2011, '-'], [0x2012, '-'], [0x2013, '-'], [0x2014, '--'], [0x2015, '--'],
|
|
52
|
+
[0x2026, '...'], [0x2022, '-'], [0x00B7, '-'], [0x00A0, ' '], [0x2009, ' '], [0x202F, ' '],
|
|
53
|
+
[0x2192, '->'], [0x2190, '<-'], [0x21D2, '=>'], [0x2264, '<='], [0x2265, '>='], [0x2260, '!='],
|
|
54
|
+
[0x2713, '[OK]'], [0x2714, '[OK]'], [0x2705, '[OK]'], [0x2717, '[X]'], [0x2718, '[X]'], [0x274C, '[X]'],
|
|
55
|
+
[0x00D7, 'x'],
|
|
56
|
+
].map(([cp, ascii]) => [String.fromCodePoint(cp), ascii]));
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Makes untrusted (LLM-authored) text safe to place inside the PR body while
|
|
60
|
+
* PRESERVING its paragraphs, bullet lists and line breaks:
|
|
61
|
+
* - CRLF/CR -> LF; tabs -> two spaces; other control characters dropped;
|
|
62
|
+
* - non-ASCII mapped to ASCII (see ASCII_MAP) or '?';
|
|
63
|
+
* - '<' -> '<' so no raw HTML, HTML comment (which could swallow the rest
|
|
64
|
+
* of the body or forge the run-history block) or autolink passes through;
|
|
65
|
+
* - '{{' / '}}' broken apart: the server-side credential handoff substitutes
|
|
66
|
+
* '{{...}}' placeholders anywhere in the dispatched command, so a note
|
|
67
|
+
* must never be able to spell one;
|
|
68
|
+
* - ATX headings ('# x') and setext '===' underlines escaped so the notes
|
|
69
|
+
* cannot outrank the body's own section headings;
|
|
70
|
+
* - runs of 3+ blank lines collapsed to one blank line.
|
|
71
|
+
* Code fences are balanced separately (closeOpenFences) AFTER any truncation.
|
|
72
|
+
* @param {unknown} text
|
|
73
|
+
* @returns {string}
|
|
74
|
+
*/
|
|
75
|
+
export function sanitizePrMarkdown(text) {
|
|
76
|
+
let s = String(text ?? '').replace(/\r\n?/g, '\n').replace(/\t/g, ' ');
|
|
77
|
+
let out = '';
|
|
78
|
+
for (const ch of s) {
|
|
79
|
+
const code = ch.codePointAt(0);
|
|
80
|
+
if (ch === '\n') out += ch;
|
|
81
|
+
else if (code < 0x20 || code === 0x7f) continue;
|
|
82
|
+
else if (code < 0x7f) out += ch;
|
|
83
|
+
else out += ASCII_MAP.has(ch) ? ASCII_MAP.get(ch) : '?';
|
|
84
|
+
}
|
|
85
|
+
s = out.replace(/</g, '<');
|
|
86
|
+
while (/\{\{|\}\}/.test(s)) s = s.replace(/\{\{/g, '{ {').replace(/\}\}/g, '} }');
|
|
87
|
+
s = s.split('\n').map((line) => line
|
|
88
|
+
.replace(/[ ]+$/, '')
|
|
89
|
+
.replace(/^( {0,3})(#{1,6})(?=\s|$)/, (_m, indent, marks) => indent + '\\' + marks)
|
|
90
|
+
.replace(/^( {0,3})(=+)$/, (_m, indent, marks) => indent + '\\' + marks))
|
|
91
|
+
.join('\n');
|
|
92
|
+
return s.replace(/\n{3,}/g, '\n\n').trim();
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Appends a closing fence when `text` leaves a ``` / ~~~ code fence open, so
|
|
96
|
+
* untrusted notes can never swallow the sections that follow them. */
|
|
97
|
+
export function closeOpenFences(text) {
|
|
98
|
+
let open = null;
|
|
99
|
+
for (const line of String(text).split('\n')) {
|
|
100
|
+
const m = /^ {0,3}(`{3,}|~{3,})/.exec(line);
|
|
101
|
+
if (!m) continue;
|
|
102
|
+
if (!open) {
|
|
103
|
+
open = m[1];
|
|
104
|
+
} else if (m[1][0] === open[0] && m[1].length >= open.length && /^ {0,3}(`{3,}|~{3,})\s*$/.test(line)) {
|
|
105
|
+
open = null;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
return open ? `${text}\n${open}` : text;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** Caps already-sanitized notes at `max` characters, cutting at a line
|
|
112
|
+
* boundary when one is reasonably close, with a visible marker. */
|
|
113
|
+
export function capNotes(text, max) {
|
|
114
|
+
const total = text.length;
|
|
115
|
+
if (total <= max) return closeOpenFences(text);
|
|
116
|
+
let cut = text.slice(0, Math.max(0, max));
|
|
117
|
+
const nl = cut.lastIndexOf('\n');
|
|
118
|
+
if (nl > max * 0.5) cut = cut.slice(0, nl);
|
|
119
|
+
cut = closeOpenFences(cut.replace(/\s+$/, ''));
|
|
120
|
+
return `${cut}\n\n*[... reviewer notes truncated: ${cut.length} of ${total} characters shown ...]*`;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** Normalizes a run id to the history-safe charset. */
|
|
124
|
+
export function normalizeRunId(runId) {
|
|
125
|
+
const v = String(runId ?? '').trim().replace(RUN_ID_UNSAFE_RE, '-').slice(0, RUN_ID_MAX);
|
|
126
|
+
return v || 'unnamed-run';
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** UTC minute stamp, e.g. 2026-10-01T09:30Z. */
|
|
130
|
+
export function runStamp(now = new Date()) {
|
|
131
|
+
return `${now.toISOString().slice(0, 16)}Z`;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* Reads the run-history block back out of an existing PR body. Returns [] for
|
|
136
|
+
* a body with no block, a malformed block, or no valid entries -- never
|
|
137
|
+
* throws. Every entry is re-validated (the body is editable by anyone with
|
|
138
|
+
* PR write access), so only well-formed { run, date, verdict } survive.
|
|
139
|
+
* @param {unknown} body
|
|
140
|
+
* @returns {Array<{ run: string, date: string, verdict: string }>}
|
|
141
|
+
*/
|
|
142
|
+
export function parseRunHistory(body) {
|
|
143
|
+
const text = String(body ?? '');
|
|
144
|
+
// \r?\n: a body saved from a web editor (GitHub's PR edit box) comes back
|
|
145
|
+
// with CRLF line endings; that must not silently reset the history.
|
|
146
|
+
const re = /<!-- fleet-sprint:run-history v1\r?\n([\s\S]*?)\r?\n-->/g;
|
|
147
|
+
let last = null;
|
|
148
|
+
for (const m of text.matchAll(re)) last = m[1];
|
|
149
|
+
if (last === null) return [];
|
|
150
|
+
let parsed;
|
|
151
|
+
try {
|
|
152
|
+
parsed = JSON.parse(last);
|
|
153
|
+
} catch {
|
|
154
|
+
return [];
|
|
155
|
+
}
|
|
156
|
+
if (!Array.isArray(parsed)) return [];
|
|
157
|
+
const out = [];
|
|
158
|
+
for (const e of parsed) {
|
|
159
|
+
if (!e || typeof e !== 'object') continue;
|
|
160
|
+
const run = typeof e.run === 'string' ? normalizeRunId(e.run) : null;
|
|
161
|
+
const date = typeof e.date === 'string' && DATE_RE.test(e.date) ? e.date : null;
|
|
162
|
+
const verdict = typeof e.verdict === 'string' && VERDICTS.has(e.verdict) ? e.verdict : null;
|
|
163
|
+
if (run && date && verdict) out.push({ run, date, verdict });
|
|
164
|
+
if (out.length >= RUN_HISTORY_MAX_ENTRIES) break;
|
|
165
|
+
}
|
|
166
|
+
return out;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
/** `fleet-sprint [<VERDICT>]: <branch>`. PRs opened before the rename carry the
|
|
170
|
+
* older `Auto-sprint [<VERDICT>]: <branch>` form; nothing in-repo matches on the
|
|
171
|
+
* title (an existing PR is found by head branch), so both forms coexist safely. */
|
|
172
|
+
export function buildSprintPrTitle({ verdict, branch }) {
|
|
173
|
+
return `fleet-sprint [${verdict}]: ${branch}`;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/** Markdown inline code span. Only ever applied to engine-validated tokens
|
|
177
|
+
* (branch names, normalized run ids), which cannot contain a backtick. */
|
|
178
|
+
function codeSpan(text) {
|
|
179
|
+
// shell-guard-allow: markdown inline-code backticks in PR body text (JSON-encoded into a curl -d payload by the VCS builders), never a command string evaluated by a shell.
|
|
180
|
+
return '`' + text + '`';
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
function inline(text) {
|
|
184
|
+
return sanitizePrMarkdown(text).replace(/\s*\n\s*/g, ' ');
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* Builds the sprint PR body as markdown.
|
|
189
|
+
*
|
|
190
|
+
* @param {object} opts
|
|
191
|
+
* @param {'PASS'|'FAIL'|'ABORTED'} opts.verdict
|
|
192
|
+
* @param {string} [opts.goal]
|
|
193
|
+
* @param {string} opts.branch
|
|
194
|
+
* @param {string} [opts.baseBranch]
|
|
195
|
+
* @param {string} [opts.runId]
|
|
196
|
+
* @param {Date} [opts.now]
|
|
197
|
+
* @param {string} [opts.notes] untrusted free text (reviewer notes / abort detail)
|
|
198
|
+
* @param {string} [opts.notesHeading]
|
|
199
|
+
* @param {string[]} [opts.details] engine-authored detail lines, rendered as list items
|
|
200
|
+
* @param {string} [opts.costAnalysis] engine-computed cost block, rendered in a fenced Cost section
|
|
201
|
+
* @param {string} [opts.previousBody] the existing PR's body, for history carry-forward
|
|
202
|
+
* @param {number} [opts.maxLength]
|
|
203
|
+
* @returns {string}
|
|
204
|
+
*/
|
|
205
|
+
export function buildSprintPrBody({
|
|
206
|
+
verdict, goal, branch, baseBranch, runId, now = new Date(),
|
|
207
|
+
notes, notesHeading = 'Reviewer notes', details = [], costAnalysis = '', previousBody = '',
|
|
208
|
+
maxLength = PR_DESCRIPTION_MAX_LENGTH,
|
|
209
|
+
}) {
|
|
210
|
+
const v = VERDICTS.has(verdict) ? verdict : 'FAIL';
|
|
211
|
+
const run = normalizeRunId(runId);
|
|
212
|
+
const stamp = runStamp(now);
|
|
213
|
+
const history = [{ run, date: stamp, verdict: v }];
|
|
214
|
+
for (const e of parseRunHistory(previousBody)) {
|
|
215
|
+
if (history.length >= RUN_HISTORY_MAX_ENTRIES) break;
|
|
216
|
+
history.push(e);
|
|
217
|
+
}
|
|
218
|
+
const previous = history.slice(1);
|
|
219
|
+
|
|
220
|
+
const head = [
|
|
221
|
+
`## Sprint verdict: ${v}`,
|
|
222
|
+
'',
|
|
223
|
+
goal ? `- **Goal:** ${inline(goal)}` : null,
|
|
224
|
+
`- **Branch:** ${codeSpan(inline(branch))}${baseBranch ? ` -> ${codeSpan(inline(baseBranch))}` : ''}`,
|
|
225
|
+
`- **Run:** ${codeSpan(run)} (${stamp})`,
|
|
226
|
+
'',
|
|
227
|
+
`### ${notesHeading}`,
|
|
228
|
+
'',
|
|
229
|
+
].filter((l) => l !== null).join('\n');
|
|
230
|
+
|
|
231
|
+
const detailLines = (details || []).filter(Boolean).map((d) => `- ${inline(d)}`);
|
|
232
|
+
// The cost block replaces the per-sprint CHANGELOG entry the harvester used
|
|
233
|
+
// to write (a shared prepend-only file that conflicted on every merge).
|
|
234
|
+
const cost = sanitizePrMarkdown(costAnalysis);
|
|
235
|
+
const costFence = '`'.repeat(Math.max(3, ...(cost.match(/`+/g) || []).map((r) => r.length + 1)));
|
|
236
|
+
const tail = [
|
|
237
|
+
'',
|
|
238
|
+
detailLines.length ? '### Details\n' : null,
|
|
239
|
+
detailLines.length ? detailLines.join('\n') : null,
|
|
240
|
+
detailLines.length ? '' : null,
|
|
241
|
+
cost ? `### Cost\n\n${costFence}\n${cost}\n${costFence}\n` : null,
|
|
242
|
+
'---',
|
|
243
|
+
'',
|
|
244
|
+
HUMAN_REVIEW_LINE,
|
|
245
|
+
previous.length ? '\n### Previous runs\n' : null,
|
|
246
|
+
previous.length ? previous.map((e) => `- ${codeSpan(e.run)} (${e.date}): ${e.verdict}`).join('\n') : null,
|
|
247
|
+
'',
|
|
248
|
+
`<!-- ${RUN_HISTORY_MARKER}`,
|
|
249
|
+
JSON.stringify(history),
|
|
250
|
+
'-->',
|
|
251
|
+
].filter((l) => l !== null).join('\n');
|
|
252
|
+
|
|
253
|
+
const cleanNotes = sanitizePrMarkdown(notes);
|
|
254
|
+
const budget = Math.min(PR_NOTES_MAX_LENGTH, maxLength - head.length - tail.length - 120);
|
|
255
|
+
const notesBlock = cleanNotes ? capNotes(cleanNotes, Math.max(200, budget)) : '*No notes were provided.*';
|
|
256
|
+
// Blank lines around the notes keep them their own block: notes ending in
|
|
257
|
+
// a paragraph directly above '---' would otherwise turn into a heading.
|
|
258
|
+
return `${head}\n${notesBlock}\n${tail}`;
|
|
259
|
+
}
|