@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,517 @@
|
|
|
1
|
+
// Typed sprint-abort detection, abort-path PR publish and the newTask
|
|
2
|
+
// validation/persistence helpers for fleet-sprint (apra-fleet-3swo.3.6).
|
|
3
|
+
// Moved verbatim out of runner.js -- runner.js re-exports isTypedAbortError,
|
|
4
|
+
// finalizeAbort and persistNewTaskBestEffort so existing importers keep
|
|
5
|
+
// working. This is a move-only extraction: predicate logic, the finalizeAbort
|
|
6
|
+
// degrade-on-failed-provider-resolution path, and the persistNewTaskBestEffort
|
|
7
|
+
// non-fatal fallback ladder are all unchanged.
|
|
8
|
+
//
|
|
9
|
+
// Scope note (apra-fleet-3swo.3.6): the bead names only two new files
|
|
10
|
+
// (abort.mjs, branch-ensure.mjs) for three conceptual clusters -- abort
|
|
11
|
+
// predicates, the pure branch-selection helper, and newTask
|
|
12
|
+
// validation/persistence. branch-ensure.mjs's name is unambiguous (the
|
|
13
|
+
// branch-selection helper only), so the newTask validation/persistence
|
|
14
|
+
// cluster is folded into this file to stay within the bead's three-file
|
|
15
|
+
// budget (abort.mjs, branch-ensure.mjs, runner.js) rather than adding a
|
|
16
|
+
// fourth file for a small, self-contained cluster.
|
|
17
|
+
//
|
|
18
|
+
// SAFE_TEXT_RE, runGitStep, sanitizePrText and stageCommandBodyMemberSide stay
|
|
19
|
+
// in runner.js (out of this bead's scope -- each has a second, non-moving
|
|
20
|
+
// caller: SAFE_TEXT_RE/sanitizePrText also gate the Publish PR step's text,
|
|
21
|
+
// runGitStep is the main withGitSync dispatch bracket's own helper, and
|
|
22
|
+
// stageCommandBodyMemberSide also backs createChildBeadWithAllocatedId) and
|
|
23
|
+
// are imported back here; findDoltDivergedCause similarly stays (used
|
|
24
|
+
// elsewhere in runner.js) and is imported back for isTypedAbortError. The
|
|
25
|
+
// resulting runner.js <-> abort.mjs cycle is safe because every use is inside
|
|
26
|
+
// a function body, never at module-evaluation time.
|
|
27
|
+
import { CommandError, BudgetExceededError, CancelledError } from '@apralabs/apra-fleet-workflow';
|
|
28
|
+
import {
|
|
29
|
+
SprintPlanRejectedError, StalledSprintError, ReviewerContractViolationError, GitDivergedError,
|
|
30
|
+
UsageLimitWaitExhaustedError,
|
|
31
|
+
} from './errors.mjs';
|
|
32
|
+
import { ApraFleet } from '@apralabs/apra-fleet-client';
|
|
33
|
+
import { resolveProvider, capabilities as vcsCapabilities } from './vcs-module.mjs';
|
|
34
|
+
import { raiseVcsPrForMember, PR_SKIPPED_NO_MCP_CLIENT } from './vcs-auth.mjs';
|
|
35
|
+
import { buildSprintPrBody } from './pr-body.mjs';
|
|
36
|
+
import {
|
|
37
|
+
findDoltDivergedCause, runGitStep, sanitizePrText, stageCommandBodyMemberSide, SAFE_TEXT_RE,
|
|
38
|
+
} from './runner.js';
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Follow-up-task persistence is bookkeeping -- it must NEVER abort the sprint.
|
|
42
|
+
* Every persistence path degrades instead of throwing: bd create ->
|
|
43
|
+
* parent-bead notes -> this run log, in that order.
|
|
44
|
+
*/
|
|
45
|
+
export async function persistNewTaskBestEffort({ createFn, command, member, parentId, newTask, cycle, log = () => {}, stage }) {
|
|
46
|
+
try {
|
|
47
|
+
// createFn's return value (when it forwards createChildBeadWithAllocatedId's
|
|
48
|
+
// { childId }) lets callers log exactly which bead id was created, not just
|
|
49
|
+
// a count. Existing callers that ignore the return value are unaffected --
|
|
50
|
+
// this is still truthy either way.
|
|
51
|
+
const result = await createFn();
|
|
52
|
+
return result ?? true;
|
|
53
|
+
} catch (err) {
|
|
54
|
+
// Child ids the failed attempts consumed (never re-pooled), so the
|
|
55
|
+
// notes fallback names them alongside the finding.
|
|
56
|
+
const consumed = Array.isArray(err && err.consumedIds) ? err.consumedIds.filter(Boolean) : [];
|
|
57
|
+
const consumedNote = consumed.length > 0 ? ` [consumed child ids: ${consumed.join(', ')}]` : '';
|
|
58
|
+
log(`[fleet-sprint] newTask bd create FAILED (non-fatal, ${stage}): ${err.message}${consumedNote} -- falling back to parent-bead notes.`);
|
|
59
|
+
try {
|
|
60
|
+
await appendRejectedFindingToParentNotes({
|
|
61
|
+
command, member, parentId, newTask,
|
|
62
|
+
reason: `bd create failed (${stage}): ${err.message}${consumedNote}`, cycle, log,
|
|
63
|
+
});
|
|
64
|
+
} catch (err2) {
|
|
65
|
+
log(`[fleet-sprint] newTask persistence FAILED at every level (non-fatal, ${stage}); finding preserved VERBATIM in this run log: ${JSON.stringify(newTask)} -- last error: ${err2.message}`);
|
|
66
|
+
}
|
|
67
|
+
return false;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
const SAFE_DESCRIPTION_RE = /^[\t\n\r\x20-\x7E]+$/;
|
|
72
|
+
const SAFE_PRIORITY_RE = /^P[0-4]$/;
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* Rewrites the handful of common non-ASCII punctuation characters LLM
|
|
76
|
+
* reviewers routinely emit in newTask descriptions -- em/en dashes, curly
|
|
77
|
+
* quotes, ellipsis -- to ASCII equivalents before SAFE_DESCRIPTION_RE
|
|
78
|
+
* validation, so a description is not rejected wholesale over characters that
|
|
79
|
+
* lose no meaning when normalized. This is a fixed substitution table, not a
|
|
80
|
+
* general Unicode stripper: anything still outside the allowlist afterwards is
|
|
81
|
+
* still a hard rejection. See sanitizeNewTaskTitle() below for title's own,
|
|
82
|
+
* stricter table.
|
|
83
|
+
* @param {string} description
|
|
84
|
+
* @returns {string}
|
|
85
|
+
*/
|
|
86
|
+
export function sanitizeNewTaskDescription(description) {
|
|
87
|
+
return String(description ?? '')
|
|
88
|
+
.replace(/[\u2014\u2013]/g, '--') // em dash (\u2014), en dash (\u2013)
|
|
89
|
+
.replace(/[\u2018\u2019]/g, "'") // curly single quotes (\u2018 \u2019)
|
|
90
|
+
.replace(/[\u201C\u201D]/g, '"') // curly double quotes (\u201C \u201D)
|
|
91
|
+
.replace(/\u2026/g, '...'); // horizontal ellipsis (\u2026)
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* Same idea as sanitizeNewTaskDescription() above, for title -- but with a
|
|
96
|
+
* STRICTER substitution table, since title still has to pass the tighter
|
|
97
|
+
* SAFE_TEXT_RE shell-safety allowlist afterwards (it is interpolated inline
|
|
98
|
+
* into a `bd create "..."` command; description is not). Every substitution
|
|
99
|
+
* here maps to a character SAFE_TEXT_RE already admits, so this never
|
|
100
|
+
* reopens the injection surface that allowlist exists to close -- it only
|
|
101
|
+
* rescues titles that would otherwise be needlessly rejected over benign,
|
|
102
|
+
* common LLM punctuation choices. Observed live (apra-fleet-vk0a's sibling
|
|
103
|
+
* finding): a reviewer wrote a title referencing a CLI command in backticks
|
|
104
|
+
* (`` `apra-fleet status` ``, ordinary Markdown inline-code style), which
|
|
105
|
+
* SAFE_TEXT_RE rejects outright (backtick is excluded as a POSIX
|
|
106
|
+
* command-substitution risk) -- the finding was then silently demoted to a
|
|
107
|
+
* freetext note on the parent bead instead of becoming its own actionable
|
|
108
|
+
* task. Backtick has no special meaning in a bd title (bd has no
|
|
109
|
+
* code-formatting concept), so it is rewritten to a single quote here rather
|
|
110
|
+
* than dropped or preserved. A literal `"`/`$`/backslash in a title is NOT
|
|
111
|
+
* rewritten (there is no safe ASCII stand-in that preserves meaning without
|
|
112
|
+
* reopening the injection question) -- those still hard-reject via
|
|
113
|
+
* SAFE_TEXT_RE below, exactly as before this function existed.
|
|
114
|
+
* @param {string} title
|
|
115
|
+
* @returns {string}
|
|
116
|
+
*/
|
|
117
|
+
export function sanitizeNewTaskTitle(title) {
|
|
118
|
+
return String(title ?? '')
|
|
119
|
+
.replace(/[\u2014\u2013]/g, '--') // em dash (\u2014), en dash (\u2013)
|
|
120
|
+
.replace(/[\u2018\u2019]/g, "'") // curly single quotes (\u2018 \u2019)
|
|
121
|
+
.replace(/[\u201C\u201D]/g, "'") // curly double quotes -> single quote (a literal `"` stays disallowed in title, unlike description)
|
|
122
|
+
.replace(/\u2026/g, '...') // horizontal ellipsis (\u2026)
|
|
123
|
+
.replace(/`/g, "'"); // backtick (Markdown inline-code marker) -> single quote
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
/**
|
|
127
|
+
* Validates one reviewer-authored newTask entry. `title` is checked against
|
|
128
|
+
* SAFE_TEXT_RE because it is interpolated inline into a `bd create` command
|
|
129
|
+
* string; `description` is checked against the more permissive
|
|
130
|
+
* SAFE_DESCRIPTION_RE because it travels via `bd create --body-file` and is
|
|
131
|
+
* never shell-interpolated (see createChildBeadWithAllocatedId). Returns
|
|
132
|
+
* either `{ ok: true, title, description, priority }` (safe to use) or
|
|
133
|
+
* `{ ok: false, reason }`. A rejected entry must never reach `command()` as a
|
|
134
|
+
* `bd create` interpolation; rejection is non-fatal and the sprint continues.
|
|
135
|
+
* @param {{ title: unknown, description: unknown, priority: unknown }} newTask
|
|
136
|
+
* @returns {{ ok: true, title: string, description: string, priority: string } | { ok: false, reason: string }}
|
|
137
|
+
*/
|
|
138
|
+
export function validateNewTask(newTask) {
|
|
139
|
+
const priority = String(newTask && newTask.priority);
|
|
140
|
+
if (!SAFE_PRIORITY_RE.test(priority)) {
|
|
141
|
+
return { ok: false, reason: `priority '${priority}' does not match required pattern ${SAFE_PRIORITY_RE}` };
|
|
142
|
+
}
|
|
143
|
+
const sanitizedTitle = sanitizeNewTaskTitle(newTask && newTask.title);
|
|
144
|
+
if (!sanitizedTitle || !SAFE_TEXT_RE.test(sanitizedTitle)) {
|
|
145
|
+
return { ok: false, reason: `title fails safe-character allowlist ${SAFE_TEXT_RE} (or is empty): ${JSON.stringify(sanitizedTitle)}` };
|
|
146
|
+
}
|
|
147
|
+
// The title is the first positional argument of `bd create`, so a leading
|
|
148
|
+
// '-' would be parsed as a flag. Strip leading dashes (and the whitespace
|
|
149
|
+
// after them) shell-independently; when anything was stripped, keep the
|
|
150
|
+
// original title (JSON-escaped, ASCII) at the top of the description so
|
|
151
|
+
// nothing is lost. A title that is only dashes becomes empty and is
|
|
152
|
+
// rejected below, falling through to the parent-notes fallback.
|
|
153
|
+
const title = sanitizedTitle.replace(/^[-\s]+/, '');
|
|
154
|
+
if (!title) {
|
|
155
|
+
return { ok: false, reason: `title is empty after removing leading dashes: ${JSON.stringify(sanitizedTitle)}` };
|
|
156
|
+
}
|
|
157
|
+
let description = sanitizeNewTaskDescription(newTask && newTask.description);
|
|
158
|
+
if (description && title !== sanitizedTitle) {
|
|
159
|
+
description = `Original title: ${JSON.stringify(sanitizedTitle)}\n\n${description}`;
|
|
160
|
+
}
|
|
161
|
+
if (!description || !SAFE_DESCRIPTION_RE.test(description)) {
|
|
162
|
+
return { ok: false, reason: `description fails ASCII-printable validation ${SAFE_DESCRIPTION_RE} (or is empty): ${JSON.stringify(description)}` };
|
|
163
|
+
}
|
|
164
|
+
return { ok: true, title, description, priority };
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* Persists a newTask that failed validateNewTask() into the parent bead's
|
|
169
|
+
* notes, raw and unmodified (title/description/priority plus the rejection
|
|
170
|
+
* reason), so a rejected finding is still recoverable by a human or the next
|
|
171
|
+
* planner even though it was not filed as its own child bead. The note body
|
|
172
|
+
* goes through the same member-side staging seam as the description path
|
|
173
|
+
* (stageCommandBodyMemberSide) and is never interpolated into a shell string.
|
|
174
|
+
*
|
|
175
|
+
* A failure to append is logged AND re-thrown. Every call site wraps this in
|
|
176
|
+
* its own try/catch whose purpose is to log the raw finding verbatim as the
|
|
177
|
+
* last fallback rung; swallowing the failure here would make that rung
|
|
178
|
+
* unreachable on exactly the path it exists to cover. Re-throwing is still
|
|
179
|
+
* non-fatal to the sprint -- the caller's catch is what contains it.
|
|
180
|
+
* @param {{ command: Function, member: string, parentId: string, newTask: unknown, reason: string, cycle?: string|number, log?: Function }} opts
|
|
181
|
+
*/
|
|
182
|
+
export async function appendRejectedFindingToParentNotes({ command, member, parentId, newTask, reason, cycle, log = () => {} }) {
|
|
183
|
+
const raw = {
|
|
184
|
+
cycle,
|
|
185
|
+
rejectionReason: reason,
|
|
186
|
+
title: newTask && newTask.title,
|
|
187
|
+
description: newTask && newTask.description,
|
|
188
|
+
priority: newTask && newTask.priority,
|
|
189
|
+
};
|
|
190
|
+
const noteBody = `[fleet-sprint newTask REJECTED -- residual validation failure, appended verbatim]\n${JSON.stringify(raw, null, 2)}`;
|
|
191
|
+
try {
|
|
192
|
+
const noteFile = await stageCommandBodyMemberSide({
|
|
193
|
+
command, member, content: noteBody,
|
|
194
|
+
label: `Stage rejected newTask finding for ${parentId} notes`,
|
|
195
|
+
});
|
|
196
|
+
await command(
|
|
197
|
+
`bd note ${parentId} --file "${noteFile}"`,
|
|
198
|
+
{ member_name: member, silent: true, label: `Append rejected newTask finding to ${parentId} notes` }
|
|
199
|
+
);
|
|
200
|
+
log(`Rejected newTask finding appended verbatim to '${parentId}' notes (residual validation failure: ${reason}).`);
|
|
201
|
+
} catch (err) {
|
|
202
|
+
log(`[newTask notes-fallback] FAILED to append rejected finding to '${parentId}' notes: ${err.message}`);
|
|
203
|
+
throw err;
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
// ---------------------------------------------------------------------------
|
|
208
|
+
// Typed sprint-abort detection
|
|
209
|
+
// ---------------------------------------------------------------------------
|
|
210
|
+
//
|
|
211
|
+
// The single predicate deciding whether an error thrown out of
|
|
212
|
+
// runSprintCycle() is a "sprint-abort" the caller routes through
|
|
213
|
+
// finalizeAbort() plus a terminal history record, as opposed to an unexpected
|
|
214
|
+
// failure that keeps the plain grace-window/exit-1 path with no PR and no
|
|
215
|
+
// history record. The intended set is:
|
|
216
|
+
// - StalledSprintError, SprintPlanRejectedError and
|
|
217
|
+
// ReviewerContractViolationError (errors.mjs), which this runner throws
|
|
218
|
+
// itself, plus BudgetExceededError, which the workflow package throws on
|
|
219
|
+
// its behalf;
|
|
220
|
+
// - GitDivergedError and DoltDivergedError, the state-integrity divergences.
|
|
221
|
+
// A divergence means the single-writer invariant this engine relies on is
|
|
222
|
+
// already violated (or the shared beads DB genuinely cannot be
|
|
223
|
+
// fast-forwarded), so no retry or later phase can recover the run -- it
|
|
224
|
+
// must terminate with an operator-visible record. A DoltDivergedError also
|
|
225
|
+
// arrives WRAPPED one level down inside a PostDispatchSyncError (the D-push
|
|
226
|
+
// bracket's shape), so membership is decided by findDoltDivergedCause()
|
|
227
|
+
// walking the cause chain rather than by the outermost class. That the
|
|
228
|
+
// divergences belong in this set is not an inference: main()'s typed-abort
|
|
229
|
+
// catch below already calls resolveTerminalReason()/captureDoltConflictDump()
|
|
230
|
+
// precisely to report them as the distinct BEADS_SYNC_CONFLICT terminal
|
|
231
|
+
// state, which is dead code unless they reach it;
|
|
232
|
+
// - UsageLimitWaitExhaustedError (apra-fleet-hzeb.4.1/.4.2): the usage-limit
|
|
233
|
+
// pause/reprobe controller's own give-up error, thrown once its budget
|
|
234
|
+
// (role-policies.mjs's USAGE_LIMIT_BUDGET_DEFAULTS) is spent with no
|
|
235
|
+
// successful resume. A member still rate-limited past every allowed wait
|
|
236
|
+
// is as terminal as a stalled sprint -- no retry or later phase recovers it
|
|
237
|
+
// either -- so it gets the same finalizeAbort()/[ABORTED]-PR treatment;
|
|
238
|
+
// - the plain `Error` pre-sprint validation failures, which are not
|
|
239
|
+
// WorkflowError subclasses and are identified by the stable
|
|
240
|
+
// 'Pre-sprint validation failed:' message prefix every such throw site
|
|
241
|
+
// uses.
|
|
242
|
+
//
|
|
243
|
+
// Everything else is deliberately EXCLUDED, and the check is an explicit class
|
|
244
|
+
// list rather than the blanket `instanceof WorkflowError` it used to be --
|
|
245
|
+
// which swept in every routine, non-terminal failure and turned it into a
|
|
246
|
+
// spurious `verdict: 'ABORTED'`:
|
|
247
|
+
// - CancelledError: a cooperative cancellation is a requested shutdown, not
|
|
248
|
+
// an aborted sprint, and must keep flowing through its own 'cancelled'
|
|
249
|
+
// status path;
|
|
250
|
+
// - AgentOutputError, AgentDispatchError, FleetTransportError, CommandError:
|
|
251
|
+
// dispatch-level failures each phase's own retry/soft-fail policy owns;
|
|
252
|
+
// - GitSyncError, DoltSyncError, and a PostDispatchSyncError whose cause
|
|
253
|
+
// chain carries NO divergence: transient sync failures that are retried in
|
|
254
|
+
// place and, if they still surface, are ordinary run failures rather than
|
|
255
|
+
// sprint aborts;
|
|
256
|
+
// - SprintLockHeldError: structurally unreachable here. acquireSprintLock()
|
|
257
|
+
// runs in main() BEFORE its try block, so a held lock never reaches this
|
|
258
|
+
// predicate; there is also no sprint of our own to finalize when another
|
|
259
|
+
// engine already owns the branch.
|
|
260
|
+
export function isTypedAbortError(err) {
|
|
261
|
+
if (!err || err instanceof CancelledError) return false;
|
|
262
|
+
if (err instanceof StalledSprintError) return true;
|
|
263
|
+
if (err instanceof SprintPlanRejectedError) return true;
|
|
264
|
+
if (err instanceof ReviewerContractViolationError) return true;
|
|
265
|
+
if (err instanceof BudgetExceededError) return true;
|
|
266
|
+
if (err instanceof GitDivergedError) return true;
|
|
267
|
+
if (err instanceof UsageLimitWaitExhaustedError) return true;
|
|
268
|
+
// Bare DoltDivergedError, or one wrapped inside a PostDispatchSyncError.
|
|
269
|
+
if (findDoltDivergedCause(err)) return true;
|
|
270
|
+
return typeof err.message === 'string' && err.message.startsWith('Pre-sprint validation failed:');
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
// ---------------------------------------------------------------------------
|
|
274
|
+
// Abort-path PR publish
|
|
275
|
+
// ---------------------------------------------------------------------------
|
|
276
|
+
//
|
|
277
|
+
// The ordinary Publish PR step only runs when the sprint reaches a final
|
|
278
|
+
// PASS/FAIL verdict. A sprint that instead aborts by throwing a typed error
|
|
279
|
+
// would otherwise propagate straight to the CLI's top-level catch with no
|
|
280
|
+
// branch push and no PR, leaving any work a doer already committed visible
|
|
281
|
+
// only to someone willing to dig through git history. Called from the
|
|
282
|
+
// typed-abort catch site with the causing error, finalizeAbort():
|
|
283
|
+
// 1. counts commits on the sprint branch beyond base, which decides whether
|
|
284
|
+
// there is anything for a human to look at;
|
|
285
|
+
// 2. with >=1 commit, pushes the branch and raises an idempotent
|
|
286
|
+
// 'fleet-sprint [ABORTED]: <branch>' PR whose body carries the error's
|
|
287
|
+
// code/message/details, sanitized by sanitizePrText for the same reason
|
|
288
|
+
// the PASS/FAIL step sanitizes reviewer notes;
|
|
289
|
+
// 3. with 0 commits, raises no PR -- there is no diff, so the PR would be
|
|
290
|
+
// noise -- and reports that in its return value, so the caller can still
|
|
291
|
+
// write a terminal history record.
|
|
292
|
+
// `command` and `log` are dependency-injected rather than closed over
|
|
293
|
+
// `context`, so this is callable both from the catch site and directly from
|
|
294
|
+
// unit tests with a mock `command`.
|
|
295
|
+
/**
|
|
296
|
+
* @param {{
|
|
297
|
+
* error: { code?: string, message?: string, details?: unknown },
|
|
298
|
+
* branch: string,
|
|
299
|
+
* baseBranch: string,
|
|
300
|
+
* member: string,
|
|
301
|
+
* command: (cmd: string, opts: object) => Promise<any>,
|
|
302
|
+
* log?: (msg: string) => void,
|
|
303
|
+
* onAuthFailure?: (info: { member: string, label: string, cmd?: string, error: string, source: 'git'|'dolt', failureKind: string }) => Promise<void>,
|
|
304
|
+
* callTool?: (name: string, args: object) => Promise<any>,
|
|
305
|
+
* }} opts
|
|
306
|
+
* @returns {Promise<{ prUrl: string|null, reason: string, pushed: boolean, commitCount: number }>}
|
|
307
|
+
*/
|
|
308
|
+
export async function finalizeAbort({ error, branch, baseBranch, member, command, log = () => {}, onAuthFailure, callTool, runId }) {
|
|
309
|
+
// Built up-front (not just at the PR-creation step further down) so the
|
|
310
|
+
// SAME ApraFleet client can also resolve `member`'s VCS provider
|
|
311
|
+
// (apra-fleet-417.7) for the runGitStep calls below -- avoids
|
|
312
|
+
// constructing a second client just for that lookup. `null` when no
|
|
313
|
+
// callTool is wired (e.g. a mock-sprint scenario with no MCP client);
|
|
314
|
+
// every downstream use already guards on this being non-null.
|
|
315
|
+
const fleetApi = typeof callTool === 'function' ? new ApraFleet({ callTool }) : null;
|
|
316
|
+
|
|
317
|
+
// apra-fleet-417.7: resolve `member`'s VCS provider ONCE up-front so the
|
|
318
|
+
// git failures below (fetch/rev-list/push) classify via that member's own
|
|
319
|
+
// provider chain, not just the default 'github' one. Fails closed to
|
|
320
|
+
// `undefined` (today's default chain) on any error -- a provider-
|
|
321
|
+
// resolution hiccup here must never abort an otherwise-recoverable abort
|
|
322
|
+
// finalization.
|
|
323
|
+
let provider;
|
|
324
|
+
if (fleetApi) {
|
|
325
|
+
try {
|
|
326
|
+
({ provider } = await resolveProvider(member, { fleetApi }));
|
|
327
|
+
} catch (err) {
|
|
328
|
+
log(`finalizeAbort: could not resolve member '${member}'s VCS provider for git-failure classification (falling back to the default provider chain, no verdict change for GitHub members): ${err.message}`);
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
// 1. How many commits (if any) does the sprint branch carry beyond base?
|
|
333
|
+
// Every command() call below passes an explicit `member_name` -- this
|
|
334
|
+
// runner never lets a git/gh dispatch fall back to an ambient member.
|
|
335
|
+
//
|
|
336
|
+
// `member` need not be a member that ever checked out a LOCAL branch named
|
|
337
|
+
// `baseBranch`; it may only have the sprint branch. A bare
|
|
338
|
+
// `git rev-list base..branch` would then fail with "unknown revision", so
|
|
339
|
+
// fetch first and diff against the remote-tracking ref, which is always
|
|
340
|
+
// resolvable: baseBranch is the ref the sprint branch was created from.
|
|
341
|
+
//
|
|
342
|
+
// apra-fleet-5d5.1: these three git calls now go through runGitStep()
|
|
343
|
+
// (the same helper the main withGitSync dispatch bracket uses) instead of
|
|
344
|
+
// calling `command()` directly, so a git-auth failure here gets the SAME
|
|
345
|
+
// provision_vcs_auth self-heal-and-retry-once treatment instead of being
|
|
346
|
+
// silently swallowed (live: apra-fleet-l7n Cycle 3 abort hit exactly this
|
|
347
|
+
// -- "Authentication failed ... Password authentication is not
|
|
348
|
+
// supported" while writing the terminal history record, with no self-heal
|
|
349
|
+
// available). runGitStep never throws; a non-ok result here is re-thrown
|
|
350
|
+
// as a CommandError so finalizeAbort()'s own external throw-on-failure
|
|
351
|
+
// contract (see main()'s catch site, which falls back to "no PR lookup"
|
|
352
|
+
// on any thrown error) is unchanged for callers.
|
|
353
|
+
const fetchRes = await runGitStep({
|
|
354
|
+
command, member, cmd: `git fetch origin ${baseBranch}`,
|
|
355
|
+
label: `Fetch base branch '${baseBranch}' for abort-path diff`,
|
|
356
|
+
log, maxTransientRetries: 1, onAuthFailure, provider,
|
|
357
|
+
});
|
|
358
|
+
if (!fetchRes.ok) {
|
|
359
|
+
throw new CommandError(
|
|
360
|
+
`[Abort Finalize Failed] git fetch origin ${baseBranch} failed: ${fetchRes.error}`,
|
|
361
|
+
{ details: { branch, baseBranch, error: fetchRes.error, kind: fetchRes.kind } }
|
|
362
|
+
);
|
|
363
|
+
}
|
|
364
|
+
const revListRes = await runGitStep({
|
|
365
|
+
command, member, cmd: `git rev-list --count origin/${baseBranch}..${branch}`,
|
|
366
|
+
label: `Count commits beyond base for abort-path branch '${branch}'`,
|
|
367
|
+
log, maxTransientRetries: 1, onAuthFailure, provider,
|
|
368
|
+
});
|
|
369
|
+
if (!revListRes.ok) {
|
|
370
|
+
throw new CommandError(
|
|
371
|
+
`[Abort Finalize Failed] git rev-list --count origin/${baseBranch}..${branch} failed: ${revListRes.error}`,
|
|
372
|
+
{ details: { branch, baseBranch, error: revListRes.error, kind: revListRes.kind } }
|
|
373
|
+
);
|
|
374
|
+
}
|
|
375
|
+
const commitCount = parseInt(String(revListRes.output).trim(), 10) || 0;
|
|
376
|
+
|
|
377
|
+
if (commitCount < 1) {
|
|
378
|
+
log(`finalizeAbort: branch '${branch}' has 0 commits beyond '${baseBranch}' -- no [ABORTED] PR raised (zero-commit-abort policy).`);
|
|
379
|
+
return { prUrl: null, reason: 'zero-commit-abort', pushed: false, commitCount };
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
// 2. There is real work on the branch -- publish it and raise the PR.
|
|
383
|
+
const pushRes = await runGitStep({
|
|
384
|
+
command, member, cmd: `git push -u origin ${branch}`,
|
|
385
|
+
label: `Push abort-path sprint branch '${branch}'`,
|
|
386
|
+
log, maxTransientRetries: 1, onAuthFailure, provider,
|
|
387
|
+
});
|
|
388
|
+
if (!pushRes.ok) {
|
|
389
|
+
throw new CommandError(
|
|
390
|
+
`[Abort Finalize Failed] git push -u origin ${branch} failed: ${pushRes.error}`,
|
|
391
|
+
{ details: { branch, baseBranch, error: pushRes.error, kind: pushRes.kind } }
|
|
392
|
+
);
|
|
393
|
+
}
|
|
394
|
+
|
|
395
|
+
// Same origin-remote gate as the Publish PR step, via
|
|
396
|
+
// VCSModule.capabilities(): a remote whose provider cannot open a PR (a
|
|
397
|
+
// file:// bare mirror, or any other host with no hosting API support)
|
|
398
|
+
// must never hit raiseVcsPrForMember()'s doomed REST call, which would
|
|
399
|
+
// surface as a hard-to-diagnose failure while the sprint is already
|
|
400
|
+
// aborting. Resolving the remote is itself failSoft -- an unresolvable
|
|
401
|
+
// remote fails closed to canOpenPullRequest:false -- so a probe hiccup
|
|
402
|
+
// here degrades to "PR skipped", never a thrown error. The branch above
|
|
403
|
+
// is already pushed either way.
|
|
404
|
+
const originUrlRes = await command('git remote get-url origin', {
|
|
405
|
+
member_name: member,
|
|
406
|
+
silent: true,
|
|
407
|
+
failSoft: true,
|
|
408
|
+
label: 'Resolve origin remote URL for abort-path PR gate',
|
|
409
|
+
});
|
|
410
|
+
const originUrl = originUrlRes.ok ? originUrlRes.output.trim() : '';
|
|
411
|
+
const abortPathCapabilities = vcsCapabilities(originUrl);
|
|
412
|
+
if (!abortPathCapabilities.canOpenPullRequest) {
|
|
413
|
+
log(`finalizeAbort: origin remote '${originUrl || '(unresolved)'}' cannot open a pull request (host: ${abortPathCapabilities.host || 'unknown'}) -- skipping [ABORTED] PR creation; branch '${branch}' is still pushed.`);
|
|
414
|
+
return { prUrl: null, reason: 'non-hosted-remote', pushed: true, commitCount };
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
const prTitle = `fleet-sprint [ABORTED]: ${branch}`;
|
|
418
|
+
// The error's code/message/details can originate from agent output, and
|
|
419
|
+
// this text is embedded in a VCSModule-built PR body -- same sanitization
|
|
420
|
+
// rationale as the PASS/FAIL Publish PR step.
|
|
421
|
+
const safeCode = sanitizePrText(error && error.code);
|
|
422
|
+
const safeMessage = sanitizePrText(error && error.message);
|
|
423
|
+
const safeDetails = sanitizePrText(
|
|
424
|
+
error && error.details !== undefined ? JSON.stringify(error.details) : ''
|
|
425
|
+
);
|
|
426
|
+
// Same markdown body builder as the PASS/FAIL Publish PR step
|
|
427
|
+
// (pr-body.mjs), so an abort after an earlier PASS/FAIL run also rewrites
|
|
428
|
+
// the existing PR and carries that run forward in its history.
|
|
429
|
+
const abortNow = new Date();
|
|
430
|
+
const buildAbortBody = (previousBody = '') => buildSprintPrBody({
|
|
431
|
+
verdict: 'ABORTED',
|
|
432
|
+
branch,
|
|
433
|
+
baseBranch,
|
|
434
|
+
runId,
|
|
435
|
+
now: abortNow,
|
|
436
|
+
notesHeading: 'Abort details',
|
|
437
|
+
notes: [
|
|
438
|
+
'The sprint ABORTED before reaching a final PASS/FAIL verdict.',
|
|
439
|
+
'',
|
|
440
|
+
safeCode ? `- Error code: ${safeCode}` : null,
|
|
441
|
+
safeMessage ? `- Error message: ${safeMessage}` : null,
|
|
442
|
+
safeDetails ? `- Error details: ${safeDetails}` : null,
|
|
443
|
+
].filter((line) => line !== null).join('\n'),
|
|
444
|
+
previousBody,
|
|
445
|
+
});
|
|
446
|
+
const prBody = buildAbortBody();
|
|
447
|
+
|
|
448
|
+
// The reverted gh-based PR creation is gone (apra-fleet-tfx.8): raise the [ABORTED] PR via
|
|
449
|
+
// VCSModule's orchestrator-built curl command, dispatched to `member`
|
|
450
|
+
// through execute_command, using a push+pr credential minted
|
|
451
|
+
// just-in-time immediately before this one call (never at sprint setup).
|
|
452
|
+
// (fleetApi is built at the top of this function, above.)
|
|
453
|
+
if (!fleetApi) {
|
|
454
|
+
// Graceful degradation (apra-fleet-tfx.8.1): raising the [ABORTED] PR
|
|
455
|
+
// needs an MCP client to mint a just-in-time push+pr credential on
|
|
456
|
+
// `member`. When no callTool is wired (e.g. a mock-sprint scenario
|
|
457
|
+
// that never opted into an MCP client), the abort-path branch is
|
|
458
|
+
// ALREADY pushed above -- so instead of an unconditional hard-throw
|
|
459
|
+
// that would break every such pre-existing scenario, this degrades to
|
|
460
|
+
// a typed 'pr-skipped-no-mcp-client' outcome: a clear log line, the
|
|
461
|
+
// pushed branch still returned to the caller, only the auto-raised PR
|
|
462
|
+
// skipped. In production callTool is always wired (bin/cli.mjs), so
|
|
463
|
+
// this branch never runs there; it exists purely so PR creation is not
|
|
464
|
+
// a hard MCP dependency for callers that legitimately have none.
|
|
465
|
+
log(`[Publish Abort PR Skipped] no MCP callTool available to mint a push+pr credential for member '${member}' -- branch '${branch}' is pushed but the [ABORTED] PR was not raised.`);
|
|
466
|
+
return { prUrl: null, reason: PR_SKIPPED_NO_MCP_CLIENT, pushed: true, commitCount };
|
|
467
|
+
}
|
|
468
|
+
const prResult = await raiseVcsPrForMember({
|
|
469
|
+
fleetApi,
|
|
470
|
+
command,
|
|
471
|
+
member,
|
|
472
|
+
base: baseBranch,
|
|
473
|
+
head: branch,
|
|
474
|
+
title: prTitle,
|
|
475
|
+
body: prBody,
|
|
476
|
+
log,
|
|
477
|
+
logPrefix: '[Publish Abort PR]',
|
|
478
|
+
// Already resolved just above (the origin-remote PR-capability gate)
|
|
479
|
+
// via a real git-capable member -- skip re-deriving it a second time
|
|
480
|
+
// by shelling out to `member`, which may be backlogMember and
|
|
481
|
+
// have no git checkout of its own to read a remote from.
|
|
482
|
+
remoteUrlOverride: originUrl,
|
|
483
|
+
updateExisting: ({ body: oldBody }) => ({ title: prTitle, body: buildAbortBody(oldBody) }),
|
|
484
|
+
});
|
|
485
|
+
|
|
486
|
+
if (!prResult.ok) {
|
|
487
|
+
if (prResult.authFailure) {
|
|
488
|
+
// apra-fleet-647.1.1.1: a PR auth failure survives the reactive
|
|
489
|
+
// one-shot self-heal+retry inside raiseVcsPrForMember (i.e. the
|
|
490
|
+
// credential is still no good after re-provisioning) -- degrade
|
|
491
|
+
// to a logged, non-throwing outcome instead of a CommandError, so
|
|
492
|
+
// finalizeAbort() -- whose whole job is to record a sprint abort
|
|
493
|
+
// -- can never itself be killed by the very auth failure it is
|
|
494
|
+
// trying to report. The branch is still pushed (`pushed: true`)
|
|
495
|
+
// even though the [ABORTED] PR could not be raised.
|
|
496
|
+
log(`finalizeAbort: [Publish Abort PR] failed with an auth failure that survived the reactive self-heal retry for branch '${branch}' -> '${baseBranch}': ${prResult.error} -- degrading (not throwing) so the abort can still be recorded.`);
|
|
497
|
+
return { prUrl: null, reason: 'pr-auth-failed', pushed: true, commitCount };
|
|
498
|
+
}
|
|
499
|
+
throw new CommandError(
|
|
500
|
+
`[Publish Abort PR Failed] VCSModule create-pull-request failed for branch '${branch}' -> '${baseBranch}': ${prResult.error}`,
|
|
501
|
+
{ details: { branch, baseBranch, error: prResult.error } }
|
|
502
|
+
);
|
|
503
|
+
}
|
|
504
|
+
if (prResult.alreadyExists) {
|
|
505
|
+
// Idempotent: the desired end state -- a PR open for this branch --
|
|
506
|
+
// already holds, so this is swallowed rather than thrown.
|
|
507
|
+
log(`finalizeAbort: an [ABORTED] PR for branch '${branch}' already exists -- treating as idempotent success.`);
|
|
508
|
+
if (prResult.updated) {
|
|
509
|
+
log(`finalizeAbort: updated the existing PR for branch '${branch}' to this run's verdict (ABORTED)${prResult.prUrl ? `: ${prResult.prUrl}` : ''}.`);
|
|
510
|
+
} else {
|
|
511
|
+
log(`finalizeAbort: WARNING: could NOT update the existing PR for branch '${branch}' to this run's verdict (ABORTED) -- its title/body may still show an earlier run's verdict; update it by hand. Cause: ${prResult.updateError || '(unknown)'}`);
|
|
512
|
+
}
|
|
513
|
+
return { prUrl: prResult.prUrl, reason: 'already-exists', pushed: true, commitCount };
|
|
514
|
+
}
|
|
515
|
+
|
|
516
|
+
return { prUrl: prResult.prUrl, reason: 'aborted-pr-created', pushed: true, commitCount };
|
|
517
|
+
}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The backlog-role alias layer.
|
|
3
|
+
*
|
|
4
|
+
* `backlog` is the application-level pseudo-role naming the member whose beads
|
|
5
|
+
* clone the sprint runner issues its own `bd`/`git` commands against. Before
|
|
6
|
+
* 0.4.4 that role was spelled `orchestrator`; the old spelling is a deprecated
|
|
7
|
+
* alias, accepted in 0.4.4 and removed in v0.5. This module is the ONE place
|
|
8
|
+
* that knows the old spelling: callers pass an already key-normalized
|
|
9
|
+
* (trim + lowercase) roleMap and get back a roleMap carrying only `backlog`.
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
export const ROLE_BACKLOG = 'backlog';
|
|
13
|
+
export const ROLE_BACKLOG_ALIAS = 'orchestrator';
|
|
14
|
+
|
|
15
|
+
export const BACKLOG_ALIAS_WARNING =
|
|
16
|
+
'Deprecated: roleMap.orchestrator is a deprecated alias of roleMap.backlog; ' +
|
|
17
|
+
'use roleMap.backlog instead. The orchestrator alias will be removed in v0.5.';
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* @param {object|undefined} normalizedRoleMap - keys already normalized
|
|
21
|
+
* @returns {{ roleMap: object|undefined, warnings: string[] }}
|
|
22
|
+
* @throws {Error} when both keys are present with different member lists
|
|
23
|
+
*/
|
|
24
|
+
export function resolveBacklogRoleAlias(normalizedRoleMap) {
|
|
25
|
+
if (normalizedRoleMap === undefined) return { roleMap: undefined, warnings: [] };
|
|
26
|
+
const has = (k) => Object.prototype.hasOwnProperty.call(normalizedRoleMap, k);
|
|
27
|
+
if (!has(ROLE_BACKLOG_ALIAS)) return { roleMap: normalizedRoleMap, warnings: [] };
|
|
28
|
+
|
|
29
|
+
const aliasValue = normalizedRoleMap[ROLE_BACKLOG_ALIAS];
|
|
30
|
+
const roleMap = { ...normalizedRoleMap };
|
|
31
|
+
delete roleMap[ROLE_BACKLOG_ALIAS];
|
|
32
|
+
if (has(ROLE_BACKLOG)) {
|
|
33
|
+
const a = JSON.stringify(normalizedRoleMap[ROLE_BACKLOG]);
|
|
34
|
+
const b = JSON.stringify(aliasValue);
|
|
35
|
+
if (a !== b) {
|
|
36
|
+
throw new Error(
|
|
37
|
+
`roleMap has both "${ROLE_BACKLOG}" (${a}) and its deprecated alias "${ROLE_BACKLOG_ALIAS}" (${b}) ` +
|
|
38
|
+
`with different member lists. Use roleMap.${ROLE_BACKLOG} only.`
|
|
39
|
+
);
|
|
40
|
+
}
|
|
41
|
+
} else {
|
|
42
|
+
roleMap[ROLE_BACKLOG] = aliasValue;
|
|
43
|
+
}
|
|
44
|
+
return { roleMap, warnings: [BACKLOG_ALIAS_WARNING] };
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* The ONE backlog-member selector shared by every direct launch (runner.js and
|
|
49
|
+
* bin/cli.mjs). Never throws on an unmapped backlog: it auto-selects and says
|
|
50
|
+
* why, so the caller can report the choice loudly.
|
|
51
|
+
*
|
|
52
|
+
* Order (roleMap already key-normalized and alias-resolved):
|
|
53
|
+
* 1. roleMap.backlog non-empty -> its first entry (explicit).
|
|
54
|
+
* 2. the first member (members order) named in no roleMap value
|
|
55
|
+
* (no roleMap -> the first member).
|
|
56
|
+
* 3. the first member mapped to doer.
|
|
57
|
+
* 4. the first member.
|
|
58
|
+
*
|
|
59
|
+
* @param {{ roleMap?: object, members: string[] }} input
|
|
60
|
+
* @returns {{ member: string|undefined, explicit: boolean, reason: string }}
|
|
61
|
+
*/
|
|
62
|
+
export function selectBacklogMember({ roleMap, members } = {}) {
|
|
63
|
+
const list = Array.isArray(members) ? members : [];
|
|
64
|
+
const explicitList = roleMap && Array.isArray(roleMap[ROLE_BACKLOG]) ? roleMap[ROLE_BACKLOG] : [];
|
|
65
|
+
if (explicitList.length > 0) {
|
|
66
|
+
return { member: explicitList[0], explicit: true, reason: 'roleMap.backlog' };
|
|
67
|
+
}
|
|
68
|
+
const mapped = new Set();
|
|
69
|
+
if (roleMap) {
|
|
70
|
+
for (const v of Object.values(roleMap)) {
|
|
71
|
+
if (Array.isArray(v)) for (const m of v) mapped.add(m);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
if (!roleMap || mapped.size === 0) {
|
|
75
|
+
return { member: list[0], explicit: false, reason: 'no roleMap, first member' };
|
|
76
|
+
}
|
|
77
|
+
const generalist = list.find((m) => !mapped.has(m));
|
|
78
|
+
if (generalist !== undefined) {
|
|
79
|
+
return { member: generalist, explicit: false, reason: 'first member not mapped to any role' };
|
|
80
|
+
}
|
|
81
|
+
const doers = Array.isArray(roleMap.doer) ? roleMap.doer : [];
|
|
82
|
+
const doer = list.find((m) => doers.includes(m));
|
|
83
|
+
if (doer !== undefined) {
|
|
84
|
+
return { member: doer, explicit: false, reason: 'every member is role-mapped; first doer-mapped member' };
|
|
85
|
+
}
|
|
86
|
+
return { member: list[0], explicit: false, reason: 'every member is role-mapped and none is a doer; first member' };
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** The loud one-line report for an auto-selected backlog member (null when explicit). */
|
|
90
|
+
export function formatBacklogSelection(sel) {
|
|
91
|
+
if (!sel || sel.explicit) return null;
|
|
92
|
+
return `backlog: ${sel.member} (auto-selected: ${sel.reason})`;
|
|
93
|
+
}
|