@apralabs/apra-fleet 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -121,6 +121,90 @@ function buildGitHubCommentCommand({ repo, issue_number: issueNumber, body, toke
|
|
|
121
121
|
};
|
|
122
122
|
}
|
|
123
123
|
|
|
124
|
+
/** Map one GitHub pull object (list or single) to the provider-neutral
|
|
125
|
+
* { id, title, body, url } shape the existing-PR update path reads. */
|
|
126
|
+
function mapGitHubPull(pr) {
|
|
127
|
+
const src = (pr && typeof pr === 'object') ? pr : {};
|
|
128
|
+
const id = typeof src.number === 'number' && Number.isFinite(src.number) ? src.number : null;
|
|
129
|
+
return {
|
|
130
|
+
id,
|
|
131
|
+
title: typeof src.title === 'string' ? src.title : '',
|
|
132
|
+
body: typeof src.body === 'string' ? src.body : '',
|
|
133
|
+
url: typeof src.html_url === 'string' ? src.html_url : null,
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/** Build the GitHub REST "find the open pull request for head -> base" curl
|
|
138
|
+
* command, used on the already-exists path to learn the existing PR's
|
|
139
|
+
* number and current body (the create call's 422 carries neither).
|
|
140
|
+
* GET /repos/{owner}/{repo}/pulls?head={owner}:{branch}&base={base}&state=open
|
|
141
|
+
* -- see https://docs.github.com/en/rest/pulls/pulls#list-pull-requests
|
|
142
|
+
* The URL carries '&', so it is quoted like every other argument. */
|
|
143
|
+
function buildGitHubFindPrCommand({ repo, base, head, token, os, shell }) {
|
|
144
|
+
const safeRepo = assertRepo(repo);
|
|
145
|
+
const safeToken = assertToken(token);
|
|
146
|
+
if (!base) throw new Error('ERROR: VCSModule: "base" branch is required to build a find-pull-request command.');
|
|
147
|
+
if (!head) throw new Error('ERROR: VCSModule: "head" branch is required to build a find-pull-request command.');
|
|
148
|
+
const owner = safeRepo.split('/')[0];
|
|
149
|
+
const query = `head=${encodeURIComponent(`${owner}:${head}`)}&base=${encodeURIComponent(base)}&state=open&per_page=10`;
|
|
150
|
+
const url = `${GITHUB_API}/repos/${safeRepo}/pulls?${query}`;
|
|
151
|
+
|
|
152
|
+
const buildCurl = (authToken) => [
|
|
153
|
+
`${curlBinary(os)} -sS -X GET`,
|
|
154
|
+
`-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
|
|
155
|
+
`-H ${shQuote('Accept: application/vnd.github+json', os, shell)}`,
|
|
156
|
+
`-H ${shQuote('X-GitHub-Api-Version: 2022-11-28', os, shell)}`,
|
|
157
|
+
`-w ${shQuote('\n%{http_code}', os, shell)}`,
|
|
158
|
+
shQuote(url, os, shell),
|
|
159
|
+
].join(' ');
|
|
160
|
+
|
|
161
|
+
return {
|
|
162
|
+
provider: 'github',
|
|
163
|
+
action: 'find-pull-request',
|
|
164
|
+
command: buildCurl(safeToken),
|
|
165
|
+
logSafeCommand: buildCurl(REDACTED),
|
|
166
|
+
interpret: { successStatusRange: [200, 299] },
|
|
167
|
+
/** 2xx body (an array of pulls) -> [{ id, title, body, url }]. */
|
|
168
|
+
mapResponse: (respBody) => (Array.isArray(respBody) ? respBody.map(mapGitHubPull).filter((p) => p.id !== null) : []),
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/** Build the GitHub REST "update a pull request" curl command (title + body).
|
|
173
|
+
* PATCH /repos/{owner}/{repo}/pulls/{pull_number} -- see
|
|
174
|
+
* https://docs.github.com/en/rest/pulls/pulls#update-a-pull-request */
|
|
175
|
+
function buildGitHubUpdatePrCommand({ repo, pull_request_id: pullRequestId, title, body, token, os, shell }) {
|
|
176
|
+
const safeRepo = assertRepo(repo);
|
|
177
|
+
const safeToken = assertToken(token);
|
|
178
|
+
const id = String(pullRequestId ?? '').trim();
|
|
179
|
+
if (!/^\d+$/.test(id)) throw new Error('ERROR: VCSModule: a numeric "pull_request_id" is required to build an update-pull-request command.');
|
|
180
|
+
if (!title) throw new Error('ERROR: VCSModule: "title" is required to build an update-pull-request command.');
|
|
181
|
+
|
|
182
|
+
const payload = { title };
|
|
183
|
+
if (body !== undefined) payload.body = body;
|
|
184
|
+
const payloadJson = JSON.stringify(payload);
|
|
185
|
+
const url = `${GITHUB_API}/repos/${safeRepo}/pulls/${id}`;
|
|
186
|
+
|
|
187
|
+
const buildCurl = (authToken) => [
|
|
188
|
+
`${curlBinary(os)} -sS -X PATCH`,
|
|
189
|
+
`-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
|
|
190
|
+
`-H ${shQuote('Accept: application/vnd.github+json', os, shell)}`,
|
|
191
|
+
`-H ${shQuote('Content-Type: application/json', os, shell)}`,
|
|
192
|
+
`-H ${shQuote('X-GitHub-Api-Version: 2022-11-28', os, shell)}`,
|
|
193
|
+
`-d ${shQuoteJson(payloadJson, os, shell)}`,
|
|
194
|
+
`-w ${shQuote('\n%{http_code}', os, shell)}`,
|
|
195
|
+
url,
|
|
196
|
+
].join(' ');
|
|
197
|
+
|
|
198
|
+
return {
|
|
199
|
+
provider: 'github',
|
|
200
|
+
action: 'update-pull-request',
|
|
201
|
+
command: buildCurl(safeToken),
|
|
202
|
+
logSafeCommand: buildCurl(REDACTED),
|
|
203
|
+
interpret: { successStatusRange: [200, 299] },
|
|
204
|
+
mapResponse: (respBody) => mapGitHubPull(respBody),
|
|
205
|
+
};
|
|
206
|
+
}
|
|
207
|
+
|
|
124
208
|
// ---------------------------------------------------------------------------
|
|
125
209
|
// Pull-request RESPONSE mapping (apra-fleet-lzfv.4)
|
|
126
210
|
// ---------------------------------------------------------------------------
|
|
@@ -345,6 +429,141 @@ function capabilitiesForHost(_host) {
|
|
|
345
429
|
return { canOpenPullRequest: true };
|
|
346
430
|
}
|
|
347
431
|
|
|
432
|
+
// ---------------------------------------------------------------------------
|
|
433
|
+
// Engine CI gate axis (see ../ci-gate.mjs and ./index.mjs's `ciGate` contract)
|
|
434
|
+
// ---------------------------------------------------------------------------
|
|
435
|
+
//
|
|
436
|
+
// The orchestrator -- never a doer -- triggers and awaits the target repo's
|
|
437
|
+
// CI workflow on the sprint branch head, so "CI is green" becomes an
|
|
438
|
+
// engine-verified fact handed to the reviewer instead of an acceptance
|
|
439
|
+
// criterion a doer dispatch cannot satisfy (a doer's credential is refused
|
|
440
|
+
// workflow_dispatch with HTTP 403 "Resource not accessible by integration").
|
|
441
|
+
//
|
|
442
|
+
// Every GitHub REST literal the gate needs lives HERE; ../ci-gate.mjs only
|
|
443
|
+
// sequences the five actions below and reads their answers through the parse
|
|
444
|
+
// hooks, so it never learns a GitHub field name. All five are plain curl
|
|
445
|
+
// commands built the same way as the PR builders above (token placeholder
|
|
446
|
+
// substituted server-side by vcs_credential_exec, -w '\n%{http_code}' status
|
|
447
|
+
// trailer), so they run through the same credential handoff.
|
|
448
|
+
//
|
|
449
|
+
// REST endpoints:
|
|
450
|
+
// branch-head GET /repos/{r}/branches/{branch}
|
|
451
|
+
// find-runs GET /repos/{r}/actions/workflows/{wf}/runs?head_sha={sha}
|
|
452
|
+
// dispatch POST /repos/{r}/actions/workflows/{wf}/dispatches {ref}
|
|
453
|
+
// get-run GET /repos/{r}/actions/runs/{id}
|
|
454
|
+
// list-jobs GET /repos/{r}/actions/runs/{id}/jobs
|
|
455
|
+
|
|
456
|
+
const CI_WORKFLOW_RE = /^[A-Za-z0-9._-]+$/;
|
|
457
|
+
const CI_SHA_RE = /^[0-9a-f]{7,64}$/i;
|
|
458
|
+
const CI_BRANCH_RE = /^[A-Za-z0-9._/-]+$/;
|
|
459
|
+
|
|
460
|
+
function assertCiParam(value, re, label) {
|
|
461
|
+
const text = String(value ?? '');
|
|
462
|
+
if (!re.test(text)) {
|
|
463
|
+
throw new Error(`ERROR: VCSModule: invalid CI gate ${label} "${value}".`);
|
|
464
|
+
}
|
|
465
|
+
return text;
|
|
466
|
+
}
|
|
467
|
+
|
|
468
|
+
/** Build one CI-gate curl command. `action` is one of the five above. */
|
|
469
|
+
function buildGitHubCiCommand(action, { repo, workflow, branch, sha, runId, token, os, shell }) {
|
|
470
|
+
const safeRepo = assertRepo(repo);
|
|
471
|
+
const safeToken = assertToken(token);
|
|
472
|
+
const base = `${GITHUB_API}/repos/${safeRepo}`;
|
|
473
|
+
let method = 'GET';
|
|
474
|
+
let url;
|
|
475
|
+
let payloadJson = null;
|
|
476
|
+
switch (action) {
|
|
477
|
+
case 'branch-head':
|
|
478
|
+
url = `${base}/branches/${assertCiParam(branch, CI_BRANCH_RE, 'branch')}`;
|
|
479
|
+
break;
|
|
480
|
+
case 'find-runs':
|
|
481
|
+
url = `${base}/actions/workflows/${assertCiParam(workflow, CI_WORKFLOW_RE, 'workflow')}/runs?head_sha=${assertCiParam(sha, CI_SHA_RE, 'head sha')}&per_page=20`;
|
|
482
|
+
break;
|
|
483
|
+
case 'dispatch':
|
|
484
|
+
method = 'POST';
|
|
485
|
+
url = `${base}/actions/workflows/${assertCiParam(workflow, CI_WORKFLOW_RE, 'workflow')}/dispatches`;
|
|
486
|
+
payloadJson = JSON.stringify({ ref: assertCiParam(branch, CI_BRANCH_RE, 'branch') });
|
|
487
|
+
break;
|
|
488
|
+
case 'get-run':
|
|
489
|
+
url = `${base}/actions/runs/${assertCiParam(runId, /^\d+$/, 'run id')}`;
|
|
490
|
+
break;
|
|
491
|
+
case 'list-jobs':
|
|
492
|
+
url = `${base}/actions/runs/${assertCiParam(runId, /^\d+$/, 'run id')}/jobs?per_page=100`;
|
|
493
|
+
break;
|
|
494
|
+
default:
|
|
495
|
+
throw new Error(`ERROR: VCSModule: unknown CI gate action "${action}".`);
|
|
496
|
+
}
|
|
497
|
+
const buildCurl = (authToken) => [
|
|
498
|
+
`${curlBinary(os)} -sS -X ${method}`,
|
|
499
|
+
`-H ${shQuote(`Authorization: Bearer ${authToken}`, os, shell)}`,
|
|
500
|
+
`-H ${shQuote('Accept: application/vnd.github+json', os, shell)}`,
|
|
501
|
+
`-H ${shQuote('X-GitHub-Api-Version: 2022-11-28', os, shell)}`,
|
|
502
|
+
...(payloadJson !== null
|
|
503
|
+
? [`-H ${shQuote('Content-Type: application/json', os, shell)}`, `-d ${shQuoteJson(payloadJson, os, shell)}`]
|
|
504
|
+
: []),
|
|
505
|
+
`-w ${shQuote('\n%{http_code}', os, shell)}`,
|
|
506
|
+
shQuote(url, os, shell),
|
|
507
|
+
].join(' ');
|
|
508
|
+
return {
|
|
509
|
+
provider: 'github',
|
|
510
|
+
action: `ci-${action}`,
|
|
511
|
+
command: buildCurl(safeToken),
|
|
512
|
+
logSafeCommand: buildCurl(REDACTED),
|
|
513
|
+
};
|
|
514
|
+
}
|
|
515
|
+
|
|
516
|
+
function normalizeGitHubRun(run) {
|
|
517
|
+
if (!run || typeof run !== 'object') return null;
|
|
518
|
+
const id = typeof run.id === 'number' || (typeof run.id === 'string' && /^\d+$/.test(run.id)) ? String(run.id) : null;
|
|
519
|
+
if (!id) return null;
|
|
520
|
+
return {
|
|
521
|
+
id,
|
|
522
|
+
url: typeof run.html_url === 'string' ? run.html_url : null,
|
|
523
|
+
headSha: typeof run.head_sha === 'string' ? run.head_sha : null,
|
|
524
|
+
status: typeof run.status === 'string' ? run.status : null,
|
|
525
|
+
conclusion: typeof run.conclusion === 'string' ? run.conclusion : null,
|
|
526
|
+
createdAt: typeof run.created_at === 'string' ? run.created_at : null,
|
|
527
|
+
};
|
|
528
|
+
}
|
|
529
|
+
|
|
530
|
+
const githubCiGate = Object.freeze({
|
|
531
|
+
/** What an operator must grant for the gate to trigger a run. Quoted
|
|
532
|
+
* verbatim into the FAILED-TO-RUN log line. */
|
|
533
|
+
requiredPermission: "actions:write on the workflow (GitHub App 'Actions' repository permission: Read and write)",
|
|
534
|
+
build: buildGitHubCiCommand,
|
|
535
|
+
/** A trigger/read refusal that is a missing permission, not a transient
|
|
536
|
+
* failure: 403, or GitHub's integration-scope wording at any status. */
|
|
537
|
+
isPermissionRefusal(status, text) {
|
|
538
|
+
return status === 403 || /Resource not accessible by (integration|personal access token)/i.test(String(text || ''));
|
|
539
|
+
},
|
|
540
|
+
parseBranchHead(body) {
|
|
541
|
+
const sha = body && body.commit && typeof body.commit.sha === 'string' ? body.commit.sha : null;
|
|
542
|
+
return sha && CI_SHA_RE.test(sha) ? sha : null;
|
|
543
|
+
},
|
|
544
|
+
/** Newest run in a find-runs listing whose head sha is exactly `sha`. */
|
|
545
|
+
parseFindRuns(body, sha) {
|
|
546
|
+
const runs = body && Array.isArray(body.workflow_runs) ? body.workflow_runs : [];
|
|
547
|
+
const matching = runs.map(normalizeGitHubRun).filter((r) => r && r.headSha === sha);
|
|
548
|
+
matching.sort((a, b) => Number(b.id) - Number(a.id));
|
|
549
|
+
return matching[0] || null;
|
|
550
|
+
},
|
|
551
|
+
parseRun: normalizeGitHubRun,
|
|
552
|
+
isRunComplete(run) {
|
|
553
|
+
return !!run && run.status === 'completed';
|
|
554
|
+
},
|
|
555
|
+
isRunSuccess(run) {
|
|
556
|
+
return !!run && run.conclusion === 'success';
|
|
557
|
+
},
|
|
558
|
+
parseJobs(body) {
|
|
559
|
+
const jobs = body && Array.isArray(body.jobs) ? body.jobs : [];
|
|
560
|
+
return jobs.map((j) => ({
|
|
561
|
+
name: typeof j.name === 'string' ? j.name : '(unnamed job)',
|
|
562
|
+
conclusion: typeof j.conclusion === 'string' ? j.conclusion : (typeof j.status === 'string' ? j.status : 'unknown'),
|
|
563
|
+
}));
|
|
564
|
+
},
|
|
565
|
+
});
|
|
566
|
+
|
|
348
567
|
export const GitHubVCS = Object.freeze({
|
|
349
568
|
name: 'github',
|
|
350
569
|
extends: 'generic-git',
|
|
@@ -374,9 +593,13 @@ export const GitHubVCS = Object.freeze({
|
|
|
374
593
|
// apra-fleet-lzfv.4: GitHub's create-pull-request response dialect, stated
|
|
375
594
|
// explicitly instead of left implicit in a caller (see above).
|
|
376
595
|
pullRequestResponse,
|
|
596
|
+
// Engine CI gate axis (see above and ./index.mjs supportsCiGate()).
|
|
597
|
+
ciGate: githubCiGate,
|
|
377
598
|
builders: Object.freeze({
|
|
378
599
|
'create-pull-request': buildGitHubCreatePrCommand,
|
|
379
600
|
comment: buildGitHubCommentCommand,
|
|
601
|
+
'find-pull-request': buildGitHubFindPrCommand,
|
|
602
|
+
'update-pull-request': buildGitHubUpdatePrCommand,
|
|
380
603
|
}),
|
|
381
604
|
});
|
|
382
605
|
|
|
@@ -81,7 +81,7 @@
|
|
|
81
81
|
* // literal -- out of the shared
|
|
82
82
|
* // callers. Only meaningful
|
|
83
83
|
* // alongside parseRepoRef.
|
|
84
|
-
* buildProvisionArgs: (ctx) => { args, note? }|{ error } // OPTIONAL;
|
|
84
|
+
* buildProvisionArgs: (ctx) => { args, note? }|{ skip: true, note? }|{ error } // OPTIONAL;
|
|
85
85
|
* // provisioning axis. Build the
|
|
86
86
|
* // provision_vcs_auth argument
|
|
87
87
|
* // object for a member of this
|
|
@@ -112,6 +112,20 @@
|
|
|
112
112
|
* // optional `note` string next to
|
|
113
113
|
* // `args` is logged as an advisory,
|
|
114
114
|
* // never treated as a failure.
|
|
115
|
+
* // A THIRD answer, `{ skip: true }`,
|
|
116
|
+
* // means "nothing to provision for
|
|
117
|
+
* // this request -- proceed on the
|
|
118
|
+
* // credential already deployed":
|
|
119
|
+
* // for a provider whose credential
|
|
120
|
+
* // is deployed out of band and has
|
|
121
|
+
* // no scope axis to widen, a
|
|
122
|
+
* // just-in-time re-provision is
|
|
123
|
+
* // both impossible and pointless,
|
|
124
|
+
* // and failing it would abort the
|
|
125
|
+
* // call it exists to enable (see
|
|
126
|
+
* // ./bitbucket.mjs). Pair it with a
|
|
127
|
+
* // `note` so the skip is never
|
|
128
|
+
* // silent.
|
|
115
129
|
* defaultAuthMode: string|null // OPTIONAL, but declaring it (even
|
|
116
130
|
* // as null) is what makes a provider
|
|
117
131
|
* // part of resolveProvider()'s/
|
|
@@ -170,6 +184,62 @@
|
|
|
170
184
|
* // not yet implemented" (fails
|
|
171
185
|
* // closed with a typed ERROR:,
|
|
172
186
|
* // never a silently wrong command)
|
|
187
|
+
* httpFailureHint: (statusOrCtx) => string|{ hint, remedy } // OPTIONAL;
|
|
188
|
+
* // REST failure explanation.
|
|
189
|
+
* // Called with a bare status
|
|
190
|
+
* // (legacy; returns a diagnosis
|
|
191
|
+
* // string, '' for none) or with
|
|
192
|
+
* // { status, body, headers,
|
|
193
|
+
* // availableSecrets, memberName,
|
|
194
|
+
* // repoRef, repo, local? } --
|
|
195
|
+
* // headers are the RESPONSE
|
|
196
|
+
* // headers (lowercased names) a
|
|
197
|
+
* // builder captured with curl
|
|
198
|
+
* // `-D -`; availableSecrets is
|
|
199
|
+
* // the credential-store name list
|
|
200
|
+
* // (null when unreadable). The
|
|
201
|
+
* // ctx form returns { hint,
|
|
202
|
+
* // remedy }: `hint` diagnoses the
|
|
203
|
+
* // failure from the response, and
|
|
204
|
+
* // a non-empty `remedy` REPLACES
|
|
205
|
+
* // authRemedy.hint for this one
|
|
206
|
+
* // failure (lead with the one-line
|
|
207
|
+
* // fix). Providers that ignore the
|
|
208
|
+
* // ctx keep working: a string
|
|
209
|
+
* // answer is used as the hint and
|
|
210
|
+
* // the generic remedy stays.
|
|
211
|
+
* credentialProbe: { // OPTIONAL; preflight credential
|
|
212
|
+
* build: (params) => { command, // probe axis, only consulted for
|
|
213
|
+
* logSafeCommand, interpret }, // a non-re-mintable provider
|
|
214
|
+
* expectedUsername?: string, // (authRemedy.serverSideReMintable
|
|
215
|
+
* remedy?: (ctx) => string // === false). With it, the VCS
|
|
216
|
+
* } // preflight (vcs-auth.mjs
|
|
217
|
+
* // createVcsAuthPreflightCallback)
|
|
218
|
+
* // runs git ls-remote AND `build`'s
|
|
219
|
+
* // REST command through
|
|
220
|
+
* // vcs_credential_exec with the
|
|
221
|
+
* // provider label (params: repoRef,
|
|
222
|
+
* // token = the {{vcs_token_inline}}
|
|
223
|
+
* // placeholder, os, shell) -- the
|
|
224
|
+
* // exact credential Publish PR
|
|
225
|
+
* // reads -- and, when
|
|
226
|
+
* // expectedUsername is set, checks
|
|
227
|
+
* // the helper's username= line
|
|
228
|
+
* // (read member-side, token line
|
|
229
|
+
* // never printed). ok only if all
|
|
230
|
+
* // pass. A REST refusal is worded
|
|
231
|
+
* // via httpFailureHint(ctx);
|
|
232
|
+
* // `remedy(ctx)` (ctx:
|
|
233
|
+
* // availableSecrets, memberName,
|
|
234
|
+
* // repoRef, local) words the fix
|
|
235
|
+
* // for every other failure. Omit it
|
|
236
|
+
* // and the preflight probes with
|
|
237
|
+
* // git ls-remote only, as before.
|
|
238
|
+
* findBeforeCreate: boolean, // OPTIONAL; create is not an upsert.
|
|
239
|
+
* // raiseVcsPrForMember runs
|
|
240
|
+
* // find-pull-request first and
|
|
241
|
+
* // updates a hit (PUT) instead of
|
|
242
|
+
* // POSTing a duplicate.
|
|
173
243
|
* authRemedy: { // OPTIONAL; auth-self-heal axis
|
|
174
244
|
* serverSideReMintable: boolean, // (apra-fleet-5co8.4.2). Whether
|
|
175
245
|
* hint: string // the REACTIVE self-heal callback
|
|
@@ -251,6 +321,21 @@
|
|
|
251
321
|
* // every AUTH_DENIED it produces
|
|
252
322
|
* // keeps today's self-heal
|
|
253
323
|
* // treatment.
|
|
324
|
+
* ciGate: { // OPTIONAL; engine CI gate axis
|
|
325
|
+
* requiredPermission: string, // (../ci-gate.mjs). Lets the
|
|
326
|
+
* build(action, params), // orchestrator trigger and await
|
|
327
|
+
* isPermissionRefusal(status, text),// a CI workflow run on the sprint
|
|
328
|
+
* parseBranchHead(body), // branch head. `build` returns a
|
|
329
|
+
* parseFindRuns(body, sha), // { command, logSafeCommand }
|
|
330
|
+
* parseRun(body), // curl for one of 'branch-head',
|
|
331
|
+
* isRunComplete(run), // 'find-runs', 'dispatch',
|
|
332
|
+
* isRunSuccess(run), // 'get-run', 'list-jobs'; the
|
|
333
|
+
* parseJobs(body), // parse hooks keep every REST
|
|
334
|
+
* } // field name in the provider.
|
|
335
|
+
* // Omitted = no CI support:
|
|
336
|
+
* // supportsCiGate() is false and
|
|
337
|
+
* // a configured gate fails loudly
|
|
338
|
+
* // naming the provider.
|
|
254
339
|
* }
|
|
255
340
|
*
|
|
256
341
|
* The manifest is an explicit import list rather than a directory scan on
|
|
@@ -368,6 +453,24 @@ export function registerVcsProvider(impl) {
|
|
|
368
453
|
throw new Error(`ERROR: VCSModule: provider "${impl.name}" has an \`authRemedy\` with no non-empty string \`hint\`.`); // shell-guard-allow: escaped backtick is markdown-style inline-code formatting in a thrown developer-facing Error message, never a shell command string -- shell-command-guard flags any literal backtick in any JS string, not just dispatched command-string arguments.
|
|
369
454
|
}
|
|
370
455
|
}
|
|
456
|
+
// The preflight credential-probe axis. OPTIONAL, validated up front for
|
|
457
|
+
// the same reason as the hooks above: a malformed probe must fail at
|
|
458
|
+
// registration, not inside a sprint preflight that never throws.
|
|
459
|
+
if (impl.httpFailureHint != null && typeof impl.httpFailureHint !== 'function') {
|
|
460
|
+
throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a non-function httpFailureHint.`);
|
|
461
|
+
}
|
|
462
|
+
if (impl.credentialProbe != null) {
|
|
463
|
+
const probe = impl.credentialProbe;
|
|
464
|
+
if (typeof probe !== 'object' || typeof probe.build !== 'function') {
|
|
465
|
+
throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a credentialProbe with no build function.`);
|
|
466
|
+
}
|
|
467
|
+
if (probe.expectedUsername != null && (typeof probe.expectedUsername !== 'string' || !probe.expectedUsername.trim())) {
|
|
468
|
+
throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a credentialProbe with a non-string or empty expectedUsername.`);
|
|
469
|
+
}
|
|
470
|
+
if (probe.remedy != null && typeof probe.remedy !== 'function') {
|
|
471
|
+
throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a credentialProbe with a non-function remedy.`);
|
|
472
|
+
}
|
|
473
|
+
}
|
|
371
474
|
// The permission-scope axis. OPTIONAL (omitting it means "this provider
|
|
372
475
|
// declares no permission-scope rules", i.e. today's behavior for every
|
|
373
476
|
// AUTH_DENIED it produces), but validated up front for the same reason as
|
|
@@ -404,10 +507,44 @@ export function registerVcsProvider(impl) {
|
|
|
404
507
|
}
|
|
405
508
|
}
|
|
406
509
|
}
|
|
510
|
+
if (impl.ciGate != null) {
|
|
511
|
+
if (typeof impl.ciGate !== 'object') {
|
|
512
|
+
throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a non-object ciGate.`);
|
|
513
|
+
}
|
|
514
|
+
for (const hook of CI_GATE_HOOKS) {
|
|
515
|
+
if (typeof impl.ciGate[hook] !== 'function') {
|
|
516
|
+
throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a ciGate with a non-function ${hook}.`);
|
|
517
|
+
}
|
|
518
|
+
}
|
|
519
|
+
if (typeof impl.ciGate.requiredPermission !== 'string' || !impl.ciGate.requiredPermission.trim()) {
|
|
520
|
+
throw new Error(`ERROR: VCSModule: provider "${impl.name}" has a ciGate with no non-empty string requiredPermission.`);
|
|
521
|
+
}
|
|
522
|
+
}
|
|
407
523
|
registry.set(impl.name, impl);
|
|
408
524
|
return impl.name;
|
|
409
525
|
}
|
|
410
526
|
|
|
527
|
+
/** Every function a provider's `ciGate` descriptor must declare (see the
|
|
528
|
+
* header's ciGate contract and ../ci-gate.mjs, its only consumer). */
|
|
529
|
+
const CI_GATE_HOOKS = Object.freeze([
|
|
530
|
+
'build', 'isPermissionRefusal', 'parseBranchHead', 'parseFindRuns',
|
|
531
|
+
'parseRun', 'isRunComplete', 'isRunSuccess', 'parseJobs',
|
|
532
|
+
]);
|
|
533
|
+
|
|
534
|
+
/**
|
|
535
|
+
* The engine CI gate's provider capability flag: whether `impl` can trigger
|
|
536
|
+
* and await a CI workflow run on a branch head (its descriptor declares a
|
|
537
|
+
* `ciGate`). A provider without it (generic-git, bitbucket, azure-devops
|
|
538
|
+
* today) makes a configured gate FAIL LOUDLY naming the provider -- never a
|
|
539
|
+
* silent skip (see ../ci-gate.mjs).
|
|
540
|
+
*
|
|
541
|
+
* @param {object|undefined} impl
|
|
542
|
+
* @returns {boolean}
|
|
543
|
+
*/
|
|
544
|
+
export function supportsCiGate(impl) {
|
|
545
|
+
return !!impl && !!impl.ciGate && typeof impl.ciGate === 'object';
|
|
546
|
+
}
|
|
547
|
+
|
|
411
548
|
/** Remove a registered provider. Intended for tests that register a throwaway
|
|
412
549
|
* provider and must not leak it into later cases. */
|
|
413
550
|
export function unregisterVcsProvider(name) {
|
|
@@ -88,7 +88,7 @@ function usesPowerShellQuoting(os, shell) {
|
|
|
88
88
|
* NOT toggle on it -- so for a value carrying BOTH whitespace and quotes
|
|
89
89
|
* the two parsers disagree about whether that whitespace is "inside
|
|
90
90
|
* quotes", the binder skips its wrapping, and the CRT splits the argument
|
|
91
|
-
* at the whitespace (observed: a JSON title '
|
|
91
|
+
* at the whitespace (observed: a JSON title 'fleet-sprint [PASS]: x'
|
|
92
92
|
* arrived as two argv entries). There is no escape sequence both parsers
|
|
93
93
|
* read the same way, so a caller must keep such a value whitespace-free --
|
|
94
94
|
* see shQuoteJson() below, which does exactly that for JSON payloads (the
|
|
@@ -112,8 +112,10 @@ function shQuote(value, os, shell) {
|
|
|
112
112
|
// above (what the NATIVE child parses), then PowerShell's own
|
|
113
113
|
// single-quoted-string escape (what PowerShell parses to get the
|
|
114
114
|
// value it hands the binder) -- a lone `'` inside a `'...'` string
|
|
115
|
-
// is written as `''`.
|
|
116
|
-
|
|
115
|
+
// is written as `''`. PowerShell also ends a single-quoted string on
|
|
116
|
+
// U+2018..U+201B (common in LLM-written PR text), so each of those is
|
|
117
|
+
// doubled as itself too.
|
|
118
|
+
return `'${escapeForWindowsArgv(value).replace(/['\u2018-\u201B]/g, '$&$&')}'`;
|
|
117
119
|
}
|
|
118
120
|
return `'${String(value).replace(/'/g, `'\\''`)}'`;
|
|
119
121
|
}
|
|
@@ -129,7 +131,9 @@ function shQuote(value, os, shell) {
|
|
|
129
131
|
* exact JSON the caller built. Whitespace cannot appear outside a string
|
|
130
132
|
* in JSON.stringify() output, so the rewrite is always inside a string. */
|
|
131
133
|
function shQuoteJson(json, os, shell) {
|
|
132
|
-
|
|
134
|
+
// A raw backtick can only occur inside a JSON string here; ` decodes
|
|
135
|
+
// back to it, and keeps backticks out of the dispatched command text.
|
|
136
|
+
const text = String(json).replace(/`/g, '\\u0060');
|
|
133
137
|
if (!usesPowerShellQuoting(os, shell)) return shQuote(text, os, shell);
|
|
134
138
|
const noWhitespace = text.replace(/\s/g, (ch) => `\\u${ch.charCodeAt(0).toString(16).padStart(4, '0')}`);
|
|
135
139
|
return shQuote(noWhitespace, os, shell);
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// VERIFY-BLOCK DEADLOCK DIAGNOSIS (GitHub #717).
|
|
3
|
+
//
|
|
4
|
+
// A verify-routed bead (classifyVerifySet in beads-scope.mjs: childful, every
|
|
5
|
+
// child closed, no unmet blocker) closes ONLY in the Integration Test phase,
|
|
6
|
+
// and that phase runs only when integ-test-playbook.md exists AND deploy.md
|
|
7
|
+
// exists AND the deploy succeeded this cycle. A bead whose only unmet `blocks`
|
|
8
|
+
// dependencies are verify-routed beads can therefore never become ready while
|
|
9
|
+
// the Integration Test phase cannot run -- the sprint used to loop, paying for
|
|
10
|
+
// cycles, until the stall net ended it FAIL with no diagnosis.
|
|
11
|
+
//
|
|
12
|
+
// This module is the pure half of the fix: the one integCanRun predicate, the
|
|
13
|
+
// shape detector and the diagnosis text (which names every blocked bead, its
|
|
14
|
+
// verify-routed blockers and the exact fix). runner.js owns the runbook
|
|
15
|
+
// probes, the pre-sprint stop and the mid-run exit; phases/final-review.mjs
|
|
16
|
+
// applies the verdict gate. Diagnose only: nothing here rewrites the DAG.
|
|
17
|
+
//
|
|
18
|
+
// GUARD COVERAGE: registered in guarded-modules.mjs. It carries no command()
|
|
19
|
+
// or agent() call site.
|
|
20
|
+
// =============================================================================
|
|
21
|
+
|
|
22
|
+
const NOT_DONE = new Set(['open', 'in_progress', 'blocked']);
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Whether the Integration Test phase can run (and so close verify-routed
|
|
26
|
+
* beads): integ-test-playbook.md present AND deploy.md present AND the deploy
|
|
27
|
+
* either succeeded this cycle or has not been attempted yet.
|
|
28
|
+
* @param {{ hasPlaybook: boolean, hasDeploy: boolean, deployAttempted?: boolean, deployedThisCycle?: boolean }} s
|
|
29
|
+
*/
|
|
30
|
+
export function integCanRun({ hasPlaybook, hasDeploy, deployAttempted = false, deployedThisCycle = false }) {
|
|
31
|
+
return Boolean(hasPlaybook) && Boolean(hasDeploy) && (!deployAttempted || Boolean(deployedThisCycle));
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Why the Integration Test phase cannot run, in the precedence an operator
|
|
36
|
+
* has to fix it in; null when it can run.
|
|
37
|
+
* @returns {'no-playbook'|'no-deploy'|'deploy-failed'|null}
|
|
38
|
+
*/
|
|
39
|
+
export function integBlockCause({ hasPlaybook, hasDeploy, deployAttempted = false, deployedThisCycle = false }) {
|
|
40
|
+
if (!hasPlaybook) return 'no-playbook';
|
|
41
|
+
if (!hasDeploy) return 'no-deploy';
|
|
42
|
+
if (deployAttempted && !deployedThisCycle) return 'deploy-failed';
|
|
43
|
+
return null;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Not-done beads whose unmet `blocks` dependencies are ALL verify-routed
|
|
48
|
+
* beads (and at least one exists). A dependency on a bead the snapshot does
|
|
49
|
+
* not know counts as unmet and NOT verify-routed, so it never produces a
|
|
50
|
+
* false diagnosis.
|
|
51
|
+
*
|
|
52
|
+
* @param {object[]} candidateBeads the beads to check (the sprint scope)
|
|
53
|
+
* @param {object[]} allBeads a full any-status snapshot for status lookup
|
|
54
|
+
* @param {string[]} verifyIds verify-routed bead ids
|
|
55
|
+
* @returns {{ id: string, title: string, priority: number|null, blockerIds: string[] }[]}
|
|
56
|
+
*/
|
|
57
|
+
export function findVerifyBlockedBeads(candidateBeads, allBeads, verifyIds) {
|
|
58
|
+
const verify = new Set(verifyIds || []);
|
|
59
|
+
if (verify.size === 0) return [];
|
|
60
|
+
const statusById = new Map((allBeads || []).map((b) => [b.id, b.status]));
|
|
61
|
+
const out = [];
|
|
62
|
+
for (const bead of candidateBeads || []) {
|
|
63
|
+
if (!bead || verify.has(bead.id) || !NOT_DONE.has(bead.status)) continue;
|
|
64
|
+
const unmet = (bead.dependencies || [])
|
|
65
|
+
.filter((d) => d && d.type === 'blocks')
|
|
66
|
+
.map((d) => d.depends_on_id)
|
|
67
|
+
.filter((depId) => statusById.get(depId) !== 'closed');
|
|
68
|
+
if (unmet.length === 0 || !unmet.every((depId) => verify.has(depId))) continue;
|
|
69
|
+
out.push({
|
|
70
|
+
id: bead.id,
|
|
71
|
+
title: bead.title || '',
|
|
72
|
+
priority: Number.isInteger(bead.priority) ? bead.priority : null,
|
|
73
|
+
blockerIds: [...new Set(unmet)].sort(),
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
return out.sort((a, b) => a.id.localeCompare(b.id));
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Split blocked beads into goal-priority (stop) and below-goal (warn only).
|
|
81
|
+
* `goalMax` is goalPriorityMax()'s 'Pn' token (a bare number is accepted
|
|
82
|
+
* too); a bead with no recorded priority counts as at-goal.
|
|
83
|
+
*/
|
|
84
|
+
export function partitionByGoal(blocked, goalMax) {
|
|
85
|
+
const max = typeof goalMax === 'number' ? goalMax : Number(String(goalMax).replace(/^P/i, ''));
|
|
86
|
+
if (!Number.isFinite(max)) {
|
|
87
|
+
throw new TypeError(`partitionByGoal: goalMax must be a 'Pn' priority token or a number; got ${JSON.stringify(goalMax)}`);
|
|
88
|
+
}
|
|
89
|
+
const atGoal = [];
|
|
90
|
+
const belowGoal = [];
|
|
91
|
+
for (const b of blocked || []) {
|
|
92
|
+
if (b.priority === null || b.priority <= max) atGoal.push(b);
|
|
93
|
+
else belowGoal.push(b);
|
|
94
|
+
}
|
|
95
|
+
return { atGoal, belowGoal };
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
const CAUSE_TEXT = {
|
|
99
|
+
'no-playbook': {
|
|
100
|
+
why: 'integ-test-playbook.md is missing, so the Integration Test phase never runs',
|
|
101
|
+
fix: 'add integ-test-playbook.md so the Integration Test phase can verify and close the verify-routed blocker(s)',
|
|
102
|
+
},
|
|
103
|
+
'no-deploy': {
|
|
104
|
+
why: 'deploy.md is missing, so there is no deployed build and the Integration Test phase never runs',
|
|
105
|
+
fix: 'add deploy.md so the build can be deployed and the Integration Test phase can verify and close the verify-routed blocker(s)',
|
|
106
|
+
},
|
|
107
|
+
'deploy-failed': {
|
|
108
|
+
why: 'the deploy failed this cycle, so the Integration Test phase did not run',
|
|
109
|
+
fix: 'fix the failing deploy (see the deploy notes) and re-run the sprint, so the Integration Test phase can verify and close the verify-routed blocker(s)',
|
|
110
|
+
},
|
|
111
|
+
};
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* The named diagnosis: every blocked bead, its verify-routed blockers, why the
|
|
115
|
+
* Integration Test phase cannot run, and the exact fix -- either make it able
|
|
116
|
+
* to run, or (when the ordering is not real) remove the dependency with the
|
|
117
|
+
* exact `bd dep remove <blocked> <blocker>` command.
|
|
118
|
+
* @param {{ blocked: object[], cause: string, deployNotes?: string|null }} opts
|
|
119
|
+
*/
|
|
120
|
+
export function buildVerifyBlockDiagnosis({ blocked, cause, deployNotes = null }) {
|
|
121
|
+
const text = CAUSE_TEXT[cause] || CAUSE_TEXT['no-playbook'];
|
|
122
|
+
const list = blocked
|
|
123
|
+
.map((b) => `${b.id}${b.title ? ` (${b.title})` : ''} is blocked only by verify-routed bead(s) ${b.blockerIds.join(', ')}`)
|
|
124
|
+
.join('; ');
|
|
125
|
+
const depRemovals = blocked
|
|
126
|
+
.flatMap((b) => b.blockerIds.map((blocker) => `bd dep remove ${b.id} ${blocker}`))
|
|
127
|
+
.join('; ');
|
|
128
|
+
return (
|
|
129
|
+
`Verify-block deadlock: ${blocked.length} bead(s) can never become ready -- every unmet blocker is a ` +
|
|
130
|
+
'verify-routed bead (all of its children closed), which only the Integration Test phase can close, and ' +
|
|
131
|
+
`${text.why}${cause === 'deploy-failed' && deployNotes ? ` (${deployNotes})` : ''}. ${list}. ` +
|
|
132
|
+
`Fix: ${text.fix}; or, if the ordering is not a real need, remove the dependency: ${depRemovals}.`
|
|
133
|
+
);
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* The verdict gate for a sprint that ended on a verify-block deadlock: never
|
|
138
|
+
* PASS. Mirrors the deploy-failure gate in phases/deploy.mjs -- the verdict
|
|
139
|
+
* becomes FAIL and the diagnosis leads the notes.
|
|
140
|
+
*/
|
|
141
|
+
export function applyVerifyBlockVerdictGate(verdictResult, diagnosis) {
|
|
142
|
+
if (!diagnosis) return verdictResult;
|
|
143
|
+
const prior = verdictResult && typeof verdictResult.notes === 'string' ? verdictResult.notes : '';
|
|
144
|
+
const overridden = !verdictResult || verdictResult.verdict === 'PASS';
|
|
145
|
+
return {
|
|
146
|
+
...(verdictResult || {}),
|
|
147
|
+
verdict: 'FAIL',
|
|
148
|
+
notes: diagnosis +
|
|
149
|
+
(overridden ? ' (Final Review returned PASS; the engine overrode it to FAIL.)' : '') +
|
|
150
|
+
(prior ? `\n\n${prior}` : ''),
|
|
151
|
+
};
|
|
152
|
+
}
|