@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,353 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// ENGINE CI GATE.
|
|
3
|
+
//
|
|
4
|
+
// STATUS: DORMANT. Nothing in the sprint runtime calls this module: CI never
|
|
5
|
+
// blocks or reaches doer/reviewer loops, no sprint arg configures a gate, and
|
|
6
|
+
// no prompt carries a CI result. The module (and its unit tests) are kept as a
|
|
7
|
+
// building block for a future design where CI is owned by a dedicated phase.
|
|
8
|
+
//
|
|
9
|
+
// WHAT IT DOES. Triggers (or locates) a workflow run on a branch head with the
|
|
10
|
+
// caller's VCS credential, awaits it with a bounded timeout and records run
|
|
11
|
+
// id/url/head sha/per-job conclusion.
|
|
12
|
+
//
|
|
13
|
+
// NEVER A SILENT SKIP. Every way the gate can fail to produce a real verdict
|
|
14
|
+
// -- the trigger refused for a missing permission, a provider with no CI
|
|
15
|
+
// support, an unreadable remote, a credential that cannot be provisioned, a
|
|
16
|
+
// run that never finishes -- is logged loudly and recorded as a NON-pass
|
|
17
|
+
// outcome (FAILED-TO-RUN or TIMEOUT). Only a completed run whose conclusion
|
|
18
|
+
// the provider calls success is ever PASS.
|
|
19
|
+
//
|
|
20
|
+
// PROVIDER-AGNOSTIC. Every REST literal lives in the provider's `ciGate`
|
|
21
|
+
// descriptor (vcs-providers/github.mjs); this module only sequences the five
|
|
22
|
+
// actions (branch-head, find-runs, dispatch, get-run, list-jobs) and reads the
|
|
23
|
+
// answers through the provider's parse hooks. The HTTP layer is an injected
|
|
24
|
+
// `transport(built) -> { status, body, bodyText }`, so the gate is unit-
|
|
25
|
+
// testable with no network (see test/ci-gate*.test.mjs). In production the
|
|
26
|
+
// transport is the server-side vcs_credential_exec handoff, the same one
|
|
27
|
+
// Publish PR uses -- the orchestrator never sees a plaintext token.
|
|
28
|
+
//
|
|
29
|
+
// GENERIC ENGINE. No target repo's workflow names, OS matrix or job names
|
|
30
|
+
// appear here; they arrive as config and as provider responses.
|
|
31
|
+
//
|
|
32
|
+
// ASCII only.
|
|
33
|
+
// =============================================================================
|
|
34
|
+
|
|
35
|
+
import { capabilities as vcsCapabilities, resolveVcsProviderForHost } from './vcs-module.mjs';
|
|
36
|
+
import { supportsCiGate } from './vcs-providers/index.mjs';
|
|
37
|
+
import {
|
|
38
|
+
parseOwnerRepoFromRemoteUrl, vcsCredentialLabelForProvider, provisionPrCapableAuthForMember,
|
|
39
|
+
} from './vcs-auth.mjs';
|
|
40
|
+
import { resolveMemberTarget } from './member-target.mjs';
|
|
41
|
+
import { resultText } from './mcp-result.mjs';
|
|
42
|
+
|
|
43
|
+
/** Gate outcomes. Only PASS is a pass; everything else is a recorded non-pass. */
|
|
44
|
+
export const CI_GATE_OUTCOME = Object.freeze({
|
|
45
|
+
PASS: 'PASS',
|
|
46
|
+
FAIL: 'FAIL',
|
|
47
|
+
FAILED_TO_RUN: 'FAILED-TO-RUN',
|
|
48
|
+
TIMEOUT: 'TIMEOUT',
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
/** The single log line an unconfigured gate emits (once per sprint). */
|
|
52
|
+
export const CI_GATE_NOT_CONFIGURED_LOG =
|
|
53
|
+
'[CI Gate] CI gate not configured -- the engine does not trigger or check CI.';
|
|
54
|
+
|
|
55
|
+
const DEFAULT_POLL_INTERVAL_MS = 30_000;
|
|
56
|
+
const LOG_PREFIX = '[CI Gate]';
|
|
57
|
+
|
|
58
|
+
/** Split a curl stdout carrying the "-w '\n%{http_code}'" trailer. */
|
|
59
|
+
export function parseCurlStatusOutput(output) {
|
|
60
|
+
const text = String(output || '');
|
|
61
|
+
const lines = text.split('\n');
|
|
62
|
+
const statusLine = lines.length ? lines[lines.length - 1].trim() : '';
|
|
63
|
+
const status = /^\d{3}$/.test(statusLine) ? parseInt(statusLine, 10) : null;
|
|
64
|
+
const bodyText = (status !== null ? lines.slice(0, -1) : lines).join('\n').trim();
|
|
65
|
+
let body = null;
|
|
66
|
+
if (bodyText) {
|
|
67
|
+
try { body = JSON.parse(bodyText); } catch { body = null; }
|
|
68
|
+
}
|
|
69
|
+
return { status, body, bodyText };
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
function isOk(res) {
|
|
73
|
+
return !!res && typeof res.status === 'number' && res.status >= 200 && res.status <= 299;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
function responseText(res) {
|
|
77
|
+
if (!res) return '(no response)';
|
|
78
|
+
const msg = res.body && typeof res.body.message === 'string' ? res.body.message : '';
|
|
79
|
+
return `HTTP ${res.status ?? '(unknown)'}${msg ? `: ${msg}` : (res.bodyText ? `: ${String(res.bodyText).slice(0, 300)}` : '')}`;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* Run the CI gate once against the current head of `branch`.
|
|
84
|
+
*
|
|
85
|
+
* @param {{
|
|
86
|
+
* ciGate: { workflow: string, timeoutS: number },
|
|
87
|
+
* provider: object|null|undefined, // the resolved VCS provider descriptor
|
|
88
|
+
* providerLabel?: string, // name to report when provider is absent
|
|
89
|
+
* repo: string, // provider repo coordinates (owner/name)
|
|
90
|
+
* branch: string,
|
|
91
|
+
* transport: (built: object) => Promise<{ status: number|null, body: any, bodyText?: string }>,
|
|
92
|
+
* credential?: string, // human description of the credential in use
|
|
93
|
+
* os?: string, shell?: string,
|
|
94
|
+
* log?: Function,
|
|
95
|
+
* sleep?: (ms: number) => Promise<void>,
|
|
96
|
+
* now?: () => number,
|
|
97
|
+
* pollIntervalMs?: number,
|
|
98
|
+
* previous?: object|null, // the last recorded result, reused for an unchanged head
|
|
99
|
+
* }} opts
|
|
100
|
+
* @returns {Promise<object>} the gate record (see CI_GATE_OUTCOME)
|
|
101
|
+
*/
|
|
102
|
+
export async function runCiGate({
|
|
103
|
+
ciGate, provider, providerLabel, repo, branch, transport, credential = '(unspecified credential)',
|
|
104
|
+
os, shell, log = () => {}, sleep = (ms) => new Promise((r) => setTimeout(r, ms)), now = () => Date.now(),
|
|
105
|
+
pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, previous = null,
|
|
106
|
+
}) {
|
|
107
|
+
const providerName = (provider && provider.name) || providerLabel || '(unknown provider)';
|
|
108
|
+
const record = {
|
|
109
|
+
outcome: null,
|
|
110
|
+
workflow: ciGate.workflow,
|
|
111
|
+
provider: providerName,
|
|
112
|
+
repo: repo || null,
|
|
113
|
+
branch,
|
|
114
|
+
headSha: null,
|
|
115
|
+
runId: null,
|
|
116
|
+
runUrl: null,
|
|
117
|
+
conclusion: null,
|
|
118
|
+
jobs: [],
|
|
119
|
+
reason: null,
|
|
120
|
+
};
|
|
121
|
+
const finish = (outcome, reason) => {
|
|
122
|
+
record.outcome = outcome;
|
|
123
|
+
record.reason = reason || null;
|
|
124
|
+
if (outcome === CI_GATE_OUTCOME.PASS) {
|
|
125
|
+
log(`${LOG_PREFIX} PASS: workflow '${record.workflow}' run ${record.runId} (${record.runUrl || 'no url'}) on ${record.branch}@${record.headSha}; jobs: ${formatJobs(record.jobs)}.`);
|
|
126
|
+
} else {
|
|
127
|
+
log(`${LOG_PREFIX} ERROR: ${outcome} for workflow '${record.workflow}' on ${record.branch}${record.headSha ? `@${record.headSha}` : ''}${record.runId ? ` (run ${record.runId}, ${record.runUrl || 'no url'})` : ''}: ${record.reason}`);
|
|
128
|
+
}
|
|
129
|
+
return record;
|
|
130
|
+
};
|
|
131
|
+
|
|
132
|
+
if (!supportsCiGate(provider)) {
|
|
133
|
+
return finish(CI_GATE_OUTCOME.FAILED_TO_RUN,
|
|
134
|
+
`VCS provider '${providerName}' has no CI-trigger support, but a ci_gate is configured. Remove ci_gate for this target or use a provider that supports it -- the gate is NOT treated as passed.`);
|
|
135
|
+
}
|
|
136
|
+
if (!repo) {
|
|
137
|
+
return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, 'could not derive the repository from the sprint origin remote.');
|
|
138
|
+
}
|
|
139
|
+
const ci = provider.ciGate;
|
|
140
|
+
const deadline = now() + ciGate.timeoutS * 1000;
|
|
141
|
+
const call = async (action, params) => {
|
|
142
|
+
const built = ci.build(action, { repo, workflow: ciGate.workflow, branch, token: '{{vcs_token_inline}}', os, shell, ...params });
|
|
143
|
+
return transport(built);
|
|
144
|
+
};
|
|
145
|
+
const permissionReason = (what, res) => (
|
|
146
|
+
`${what} was refused (${responseText(res)}). Missing permission: ${ci.requiredPermission}. `
|
|
147
|
+
+ `Credential in use: ${credential}. Grant that permission to this credential; CI is NOT verified for this head.`
|
|
148
|
+
);
|
|
149
|
+
// Sleep one poll interval (never past the deadline). false = deadline
|
|
150
|
+
// already reached, so the caller records TIMEOUT instead of polling.
|
|
151
|
+
const waitOrTimeout = async () => {
|
|
152
|
+
const remaining = deadline - now();
|
|
153
|
+
if (remaining <= 0) return false;
|
|
154
|
+
await sleep(Math.min(pollIntervalMs, remaining));
|
|
155
|
+
return true;
|
|
156
|
+
};
|
|
157
|
+
|
|
158
|
+
try {
|
|
159
|
+
// 1. Resolve the branch head sha on the remote (what CI actually runs).
|
|
160
|
+
const headRes = await call('branch-head', {});
|
|
161
|
+
if (!isOk(headRes)) {
|
|
162
|
+
return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, ci.isPermissionRefusal(headRes && headRes.status, responseText(headRes))
|
|
163
|
+
? permissionReason(`Reading branch '${branch}'`, headRes)
|
|
164
|
+
: `could not read the head of branch '${branch}' (${responseText(headRes)}).`);
|
|
165
|
+
}
|
|
166
|
+
const sha = ci.parseBranchHead(headRes.body);
|
|
167
|
+
if (!sha) return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, `the provider returned no head sha for branch '${branch}'.`);
|
|
168
|
+
record.headSha = sha;
|
|
169
|
+
|
|
170
|
+
// An unchanged head already has a terminal verdict -- do not re-run CI.
|
|
171
|
+
if (previous && previous.headSha === sha && previous.workflow === ciGate.workflow
|
|
172
|
+
&& (previous.outcome === CI_GATE_OUTCOME.PASS || previous.outcome === CI_GATE_OUTCOME.FAIL)) {
|
|
173
|
+
log(`${LOG_PREFIX} head ${sha} unchanged since run ${previous.runId}; reusing its ${previous.outcome} result.`);
|
|
174
|
+
return { ...previous };
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
// 2. Locate a run already triggered for this sha, else trigger one.
|
|
178
|
+
const findRun = async () => {
|
|
179
|
+
const res = await call('find-runs', { sha });
|
|
180
|
+
if (!isOk(res)) return { error: res };
|
|
181
|
+
return { run: ci.parseFindRuns(res.body, sha) };
|
|
182
|
+
};
|
|
183
|
+
let found = await findRun();
|
|
184
|
+
if (found.error) {
|
|
185
|
+
return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, ci.isPermissionRefusal(found.error.status, responseText(found.error))
|
|
186
|
+
? permissionReason(`Listing runs of workflow '${ciGate.workflow}'`, found.error)
|
|
187
|
+
: `could not list runs of workflow '${ciGate.workflow}' (${responseText(found.error)}).`);
|
|
188
|
+
}
|
|
189
|
+
if (!found.run) {
|
|
190
|
+
log(`${LOG_PREFIX} no '${ciGate.workflow}' run found for ${branch}@${sha}; triggering one.`);
|
|
191
|
+
const dispatchRes = await call('dispatch', {});
|
|
192
|
+
if (!isOk(dispatchRes)) {
|
|
193
|
+
return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, ci.isPermissionRefusal(dispatchRes && dispatchRes.status, responseText(dispatchRes))
|
|
194
|
+
? permissionReason(`Triggering workflow '${ciGate.workflow}' on '${branch}'`, dispatchRes)
|
|
195
|
+
: `triggering workflow '${ciGate.workflow}' on '${branch}' failed (${responseText(dispatchRes)}).`);
|
|
196
|
+
}
|
|
197
|
+
// The dispatch API returns no run id: poll until the run appears.
|
|
198
|
+
while (!found.run) {
|
|
199
|
+
if (!(await waitOrTimeout())) {
|
|
200
|
+
return finish(CI_GATE_OUTCOME.TIMEOUT,
|
|
201
|
+
`the triggered run for ${sha} did not appear within ${ciGate.timeoutS}s.`);
|
|
202
|
+
}
|
|
203
|
+
found = await findRun();
|
|
204
|
+
if (found.error) {
|
|
205
|
+
return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, `could not list runs of workflow '${ciGate.workflow}' (${responseText(found.error)}).`);
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
let run = found.run;
|
|
210
|
+
record.runId = run.id;
|
|
211
|
+
record.runUrl = run.url;
|
|
212
|
+
log(`${LOG_PREFIX} awaiting '${ciGate.workflow}' run ${run.id} (${run.url || 'no url'}) on ${branch}@${sha} (timeout ${ciGate.timeoutS}s).`);
|
|
213
|
+
|
|
214
|
+
// 3. Poll the run to completion, bounded by the timeout.
|
|
215
|
+
while (!ci.isRunComplete(run)) {
|
|
216
|
+
if (!(await waitOrTimeout())) {
|
|
217
|
+
return finish(CI_GATE_OUTCOME.TIMEOUT,
|
|
218
|
+
`run did not complete within ${ciGate.timeoutS}s (last status: ${run.status || 'unknown'}); see ${run.url || 'the run page'}.`);
|
|
219
|
+
}
|
|
220
|
+
const runRes = await call('get-run', { runId: run.id });
|
|
221
|
+
if (!isOk(runRes)) {
|
|
222
|
+
return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, `could not read run ${run.id} (${responseText(runRes)}).`);
|
|
223
|
+
}
|
|
224
|
+
run = ci.parseRun(runRes.body) || run;
|
|
225
|
+
if (run.url) record.runUrl = run.url;
|
|
226
|
+
}
|
|
227
|
+
record.conclusion = run.conclusion;
|
|
228
|
+
|
|
229
|
+
// 4. Per-job conclusions.
|
|
230
|
+
const jobsRes = await call('list-jobs', { runId: run.id });
|
|
231
|
+
if (isOk(jobsRes)) {
|
|
232
|
+
record.jobs = ci.parseJobs(jobsRes.body);
|
|
233
|
+
} else {
|
|
234
|
+
log(`${LOG_PREFIX} could not list jobs of run ${run.id} (${responseText(jobsRes)}); recording the run conclusion only.`);
|
|
235
|
+
}
|
|
236
|
+
return ci.isRunSuccess(run)
|
|
237
|
+
? finish(CI_GATE_OUTCOME.PASS, null)
|
|
238
|
+
: finish(CI_GATE_OUTCOME.FAIL, `run concluded '${run.conclusion}'; jobs: ${formatJobs(record.jobs)}.`);
|
|
239
|
+
} catch (err) {
|
|
240
|
+
return finish(CI_GATE_OUTCOME.FAILED_TO_RUN, `CI gate error: ${err && err.message ? err.message : err} (credential in use: ${credential}).`);
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
function formatJobs(jobs) {
|
|
245
|
+
if (!Array.isArray(jobs) || jobs.length === 0) return '(no job detail)';
|
|
246
|
+
return jobs.map((j) => `${j.name}=${j.conclusion}`).join(', ');
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
/**
|
|
250
|
+
* Sprint-scoped CI gate. Logs CI_GATE_NOT_CONFIGURED_LOG exactly once when
|
|
251
|
+
* `ciGate` is absent and then never touches a provider. When configured,
|
|
252
|
+
* `check()` resolves the run context (provider, repo, credential transport)
|
|
253
|
+
* and runs the gate, reusing the previous terminal result for an unchanged
|
|
254
|
+
* head, and records every result in `results`.
|
|
255
|
+
*
|
|
256
|
+
* @param {{
|
|
257
|
+
* ciGate: { workflow: string, timeoutS: number }|undefined,
|
|
258
|
+
* branch: string,
|
|
259
|
+
* log?: Function,
|
|
260
|
+
* resolveContext: () => Promise<object>, // -> { provider, providerLabel, repo, transport, credential, os, shell } | { error }
|
|
261
|
+
* gateOptions?: object, // test seam: sleep/now/pollIntervalMs
|
|
262
|
+
* }} opts
|
|
263
|
+
*/
|
|
264
|
+
export function createCiGate({ ciGate, branch, log = () => {}, resolveContext, gateOptions = {} }) {
|
|
265
|
+
const results = [];
|
|
266
|
+
if (!ciGate) {
|
|
267
|
+
log(CI_GATE_NOT_CONFIGURED_LOG);
|
|
268
|
+
return { configured: false, results, async check() { return null; } };
|
|
269
|
+
}
|
|
270
|
+
log(`${LOG_PREFIX} configured: workflow '${ciGate.workflow}', timeout ${ciGate.timeoutS}s -- run before each reviewer dispatch on the ${branch} head.`);
|
|
271
|
+
return {
|
|
272
|
+
configured: true,
|
|
273
|
+
results,
|
|
274
|
+
async check({ label } = {}) {
|
|
275
|
+
const previous = results.length > 0 ? results[results.length - 1] : null;
|
|
276
|
+
let ctx;
|
|
277
|
+
try {
|
|
278
|
+
ctx = await resolveContext();
|
|
279
|
+
} catch (err) {
|
|
280
|
+
ctx = { error: err && err.message ? err.message : String(err) };
|
|
281
|
+
}
|
|
282
|
+
let result;
|
|
283
|
+
if (ctx && ctx.error) {
|
|
284
|
+
result = {
|
|
285
|
+
outcome: CI_GATE_OUTCOME.FAILED_TO_RUN, workflow: ciGate.workflow, provider: ctx.providerLabel || null,
|
|
286
|
+
repo: null, branch, headSha: null, runId: null, runUrl: null, conclusion: null, jobs: [],
|
|
287
|
+
reason: ctx.error,
|
|
288
|
+
};
|
|
289
|
+
log(`${LOG_PREFIX} ERROR: ${CI_GATE_OUTCOME.FAILED_TO_RUN} for workflow '${ciGate.workflow}' on ${branch}: ${ctx.error}`);
|
|
290
|
+
} else {
|
|
291
|
+
result = await runCiGate({ ciGate, branch, log, previous, ...ctx, ...gateOptions });
|
|
292
|
+
}
|
|
293
|
+
result.label = label || null;
|
|
294
|
+
results.push(result);
|
|
295
|
+
return result;
|
|
296
|
+
},
|
|
297
|
+
};
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
/**
|
|
301
|
+
* Production context resolver: origin remote -> provider + repo; just-in-time
|
|
302
|
+
* push+pr credential on the orchestrator (the level that carries the CI
|
|
303
|
+
* trigger permission); a vcs_credential_exec transport. Every failure becomes
|
|
304
|
+
* `{ error }` so the gate records FAILED-TO-RUN loudly instead of throwing.
|
|
305
|
+
*
|
|
306
|
+
* @param {{ fleetApi: object|null, command: Function, backlogMember: string, gitMember: string, log?: Function }} opts
|
|
307
|
+
* @returns {() => Promise<object>}
|
|
308
|
+
*/
|
|
309
|
+
export function createCiGateContextResolver({ fleetApi, command, backlogMember, gitMember, log = () => {} }) {
|
|
310
|
+
return async function resolveCiGateContext() {
|
|
311
|
+
const originRes = await command('git remote get-url origin', {
|
|
312
|
+
member_name: gitMember, silent: true, failSoft: true, label: 'CI gate: resolve origin remote URL',
|
|
313
|
+
});
|
|
314
|
+
const originUrl = originRes && originRes.ok ? String(originRes.output || '').trim() : '';
|
|
315
|
+
if (!originUrl) {
|
|
316
|
+
return { error: `could not read the origin remote on member '${gitMember}' (${(originRes && originRes.error) || 'empty'}).` };
|
|
317
|
+
}
|
|
318
|
+
const caps = vcsCapabilities(originUrl);
|
|
319
|
+
const provider = caps.host ? resolveVcsProviderForHost(caps.host) : null;
|
|
320
|
+
const providerLabel = provider ? provider.name : `none (origin '${originUrl}' has no hosting provider)`;
|
|
321
|
+
if (!supportsCiGate(provider)) {
|
|
322
|
+
// runCiGate reports the unsupported provider loudly by name.
|
|
323
|
+
return { provider, providerLabel, repo: null, transport: async () => ({ status: null, body: null }) };
|
|
324
|
+
}
|
|
325
|
+
if (!fleetApi || typeof fleetApi.vcsCredentialExec !== 'function') {
|
|
326
|
+
return { providerLabel, error: `no fleet MCP client with vcs_credential_exec is available to run the CI gate for provider '${provider.name}'.` };
|
|
327
|
+
}
|
|
328
|
+
const label = vcsCredentialLabelForProvider(provider.name);
|
|
329
|
+
const credential = `the '${label}' push+pr VCS credential on member '${backlogMember}'`;
|
|
330
|
+
let repo;
|
|
331
|
+
try {
|
|
332
|
+
({ repo } = await provisionPrCapableAuthForMember({
|
|
333
|
+
fleetApi, command, member: backlogMember, log, logPrefix: LOG_PREFIX, remoteUrlOverride: originUrl,
|
|
334
|
+
}));
|
|
335
|
+
} catch (err) {
|
|
336
|
+
return { providerLabel, error: `could not provision ${credential}: ${err && err.message ? err.message : err}` };
|
|
337
|
+
}
|
|
338
|
+
repo = repo || parseOwnerRepoFromRemoteUrl(originUrl);
|
|
339
|
+
const { os, shell } = await resolveMemberTarget({ fleetApi, member: backlogMember, log });
|
|
340
|
+
const transport = async (built) => {
|
|
341
|
+
const execRes = await fleetApi.vcsCredentialExec({ member_name: backlogMember, label, command: built.command });
|
|
342
|
+
const handoff = (execRes && execRes.structuredContent) || {};
|
|
343
|
+
if (!handoff.ok && handoff.reason !== 'dispatch_failed') {
|
|
344
|
+
throw new Error(`vcs_credential_exec could not use ${credential} (reason: ${handoff.reason || '(none)'}): ${resultText(execRes) || '(no detail)'}`);
|
|
345
|
+
}
|
|
346
|
+
if (!handoff.ok || (typeof handoff.exitCode === 'number' && handoff.exitCode !== 0)) {
|
|
347
|
+
throw new Error(`CI request failed to run (${built.logSafeCommand}): ${handoff.stderr || resultText(execRes) || '(no detail)'}`);
|
|
348
|
+
}
|
|
349
|
+
return parseCurlStatusOutput(handoff.stdout);
|
|
350
|
+
};
|
|
351
|
+
return { provider, providerLabel, repo, transport, credential, os, shell };
|
|
352
|
+
};
|
|
353
|
+
}
|
|
@@ -172,6 +172,26 @@ export async function dispatchConflictResolutionAgent({ agent, member, branch, u
|
|
|
172
172
|
member_name: member,
|
|
173
173
|
label: `Tier 2 conflict resolution [${unmergedPaths.join(', ')}]`,
|
|
174
174
|
model,
|
|
175
|
+
// EXPLICITLY a fresh session. The runbook above is entirely
|
|
176
|
+
// self-contained (it names the member, the branch and every
|
|
177
|
+
// conflicted path), and the member's stored last session is whatever
|
|
178
|
+
// role dispatch happened to run there -- resuming it would drop a git
|
|
179
|
+
// conflict-resolution instruction into an unrelated conversation.
|
|
180
|
+
// Never rely on an omitted `resume`: execute_prompt defaults it to
|
|
181
|
+
// true, i.e. best-effort reattachment to exactly that stale session.
|
|
182
|
+
resume: false,
|
|
183
|
+
// STRICT on a refused tool call (fail_on_permission_denial, as every
|
|
184
|
+
// role dispatch passes). The runbook is a series of git commands: a
|
|
185
|
+
// Claude reply that completes after the member CLI refused one of them
|
|
186
|
+
// would otherwise be a warning, and a runbook that silently skipped a
|
|
187
|
+
// refused git command must not be read as a resolved conflict. A
|
|
188
|
+
// permission_denied outcome surfaces as a thrown dispatch error, which
|
|
189
|
+
// the caller (member-sync.mjs) already catches, logs and does NOT
|
|
190
|
+
// retry; it then re-verifies the real git state (porcelain + re-push)
|
|
191
|
+
// and, if still unresolved, restores a clean tree and fails with the
|
|
192
|
+
// typed GitDivergedError -- a clear ladder failure, never an uncaught
|
|
193
|
+
// error and never a claim taken on the agent's word.
|
|
194
|
+
fail_on_permission_denial: true,
|
|
175
195
|
timeout_s: 1800,
|
|
176
196
|
max_total_s: 1800,
|
|
177
197
|
});
|
|
@@ -281,9 +281,12 @@ export function majorVersionFromId(id) {
|
|
|
281
281
|
export function assertVersionPin(role, schema, expectedMajor) {
|
|
282
282
|
const actualMajor = majorVersionFromId(schema && schema.$id);
|
|
283
283
|
if (actualMajor !== expectedMajor) {
|
|
284
|
+
// GENERIC-BOUNDARY-EXCEPTION: developer-facing Error about this product's own vendored schema --
|
|
285
|
+
// thrown at module load and read by an apra-fleet developer, never dispatched to a sprint
|
|
286
|
+
// agent; it must name the package whose vendored schema drifted (docs/generic-engine-boundary.md).
|
|
284
287
|
throw new Error(
|
|
285
288
|
`[contracts] Version-pin mismatch for role "${role}": this module was written against ` +
|
|
286
|
-
`schema $id major version ${expectedMajor}, but the vendored schema's $id is ` +
|
|
289
|
+
`schema $id major version ${expectedMajor}, but the vendored schema's $id is ` + // shell-guard-allow: "$id" here and on the next line is the JSON Schema $id property name (schema.$id), not a shell variable expansion -- this text is a thrown JS Error, never dispatched as a command string.
|
|
287
290
|
`${JSON.stringify(schema && schema.$id)}. A packages/apra-fleet-se/apra-pm package update changed this ` +
|
|
288
291
|
`role's contract -- update contracts.mjs (and re-verify every call site that consumes ` +
|
|
289
292
|
`this schema) before accepting the new vendored version.`,
|
|
@@ -423,6 +426,47 @@ const FALLBACK_planReviewerVerdict = {
|
|
|
423
426
|
properties: {
|
|
424
427
|
verdict: { type: 'string', enum: ['APPROVED', 'CHANGES_NEEDED'] },
|
|
425
428
|
notes: { type: 'string' },
|
|
429
|
+
// apra-fleet-3swo.7.8: optional, deliberately NOT in `required` below
|
|
430
|
+
// -- mirrors packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json.
|
|
431
|
+
// Machine-readable per-bead findings, so a CHANGES_NEEDED verdict can
|
|
432
|
+
// be routed to the beads it concerns WITHOUT scanning free-text notes
|
|
433
|
+
// for literal bead ids (the job extractContestedBeadIds does today in
|
|
434
|
+
// fleet-sprint/newtask-text.mjs; retiring that scraper is a separate
|
|
435
|
+
// task). An EMPTY array is meaningful -- it is the explicit
|
|
436
|
+
// "plan-wide objection, no individual bead named" signal, which is the
|
|
437
|
+
// same thing the prose scan expressed by matching no id. An ABSENT
|
|
438
|
+
// field is schema-valid and means "this verdict predates the findings
|
|
439
|
+
// contract", so the consumer may still fall back to notes for one
|
|
440
|
+
// release; keeping it out of `required` is what makes that fallback
|
|
441
|
+
// window possible.
|
|
442
|
+
findings: {
|
|
443
|
+
type: 'array',
|
|
444
|
+
items: {
|
|
445
|
+
type: 'object',
|
|
446
|
+
properties: {
|
|
447
|
+
id: { type: 'string' },
|
|
448
|
+
kind: {
|
|
449
|
+
type: 'string',
|
|
450
|
+
enum: [
|
|
451
|
+
'coverage',
|
|
452
|
+
'missing_test_task',
|
|
453
|
+
'acceptance_criteria',
|
|
454
|
+
'task_size',
|
|
455
|
+
'dependency_wiring',
|
|
456
|
+
'scope_creep',
|
|
457
|
+
'duplicate_work',
|
|
458
|
+
'feasibility',
|
|
459
|
+
'ready_work',
|
|
460
|
+
'model_metadata',
|
|
461
|
+
'lane_cohesion',
|
|
462
|
+
'other',
|
|
463
|
+
],
|
|
464
|
+
},
|
|
465
|
+
detail: { type: 'string', minLength: 1 },
|
|
466
|
+
},
|
|
467
|
+
required: ['id', 'kind', 'detail'],
|
|
468
|
+
},
|
|
469
|
+
},
|
|
426
470
|
taskAssignments: { type: 'array', items: taskAssignmentSchema },
|
|
427
471
|
},
|
|
428
472
|
required: ['verdict', 'notes', 'taskAssignments'],
|
|
@@ -446,6 +490,11 @@ const FALLBACK_reviewerVerdict = {
|
|
|
446
490
|
// schema-valid and semantically a no-op, preserving pre-eft.67
|
|
447
491
|
// behavior exactly.
|
|
448
492
|
replanIds: { type: 'array', items: { type: 'string' } },
|
|
493
|
+
// Optional, NOT required: true when the build or test suite fails on
|
|
494
|
+
// the branch under review. Lets the orchestrator file an in-goal fix
|
|
495
|
+
// task when no reopen/newTask survives (ensureRedBranchFixTask in
|
|
496
|
+
// beads-transitions.mjs). Mirrors reviewer-output.json.
|
|
497
|
+
buildFailing: { type: 'boolean' },
|
|
449
498
|
newTasks: {
|
|
450
499
|
type: 'array',
|
|
451
500
|
items: {
|
|
@@ -575,16 +624,43 @@ const FALLBACK_regressionReport = {
|
|
|
575
624
|
type: 'object',
|
|
576
625
|
properties: {
|
|
577
626
|
passed: { type: 'boolean' },
|
|
627
|
+
sections: {
|
|
628
|
+
type: 'array',
|
|
629
|
+
items: {
|
|
630
|
+
type: 'object',
|
|
631
|
+
properties: {
|
|
632
|
+
name: { type: 'string' },
|
|
633
|
+
passed: { type: 'boolean' },
|
|
634
|
+
detail: { type: 'string' },
|
|
635
|
+
},
|
|
636
|
+
required: ['name', 'passed'],
|
|
637
|
+
},
|
|
638
|
+
},
|
|
639
|
+
// Deprecated two-part fields: still accepted, never required.
|
|
578
640
|
suitePassed: { type: 'boolean' },
|
|
579
641
|
smokePassed: { type: 'boolean' },
|
|
580
642
|
bugsFiled: { type: 'array', items: { type: 'string' } },
|
|
581
643
|
summary: { type: 'string' },
|
|
644
|
+
// Optional verdict fields, copied verbatim from a machine-written
|
|
645
|
+
// verdict file when the target playbook names one.
|
|
646
|
+
verdict: { type: 'string', enum: ['PASS', 'FAIL', 'INCONCLUSIVE'] },
|
|
647
|
+
testedSha: { type: 'string', pattern: '^[0-9a-f]{40}$' },
|
|
648
|
+
evidence: {
|
|
649
|
+
type: 'object',
|
|
650
|
+
additionalProperties: true,
|
|
651
|
+
properties: {
|
|
652
|
+
verdictRef: { type: 'string' },
|
|
653
|
+
runUrl: { type: 'string' },
|
|
654
|
+
newFailures: { type: 'array', items: { type: 'string' } },
|
|
655
|
+
inventoryMissing: { type: 'array', items: { type: 'string' } },
|
|
656
|
+
},
|
|
657
|
+
},
|
|
582
658
|
smokeEvidence: {
|
|
583
659
|
type: 'object',
|
|
584
660
|
additionalProperties: true,
|
|
585
661
|
},
|
|
586
662
|
},
|
|
587
|
-
required: ['passed', '
|
|
663
|
+
required: ['passed', 'bugsFiled', 'summary'],
|
|
588
664
|
};
|
|
589
665
|
|
|
590
666
|
// Fallback for role "ci-watcher". Canonical source:
|
|
@@ -684,6 +760,33 @@ export const finalVerdict = {
|
|
|
684
760
|
required: ['id', 'reason'],
|
|
685
761
|
},
|
|
686
762
|
},
|
|
763
|
+
// The Final Review's DISCARD judgement, mirroring reviewer-output.json's
|
|
764
|
+
// kb_discards: same {id, reason} shape as kb_promotions, executed by the
|
|
765
|
+
// same kbWork.apply path. Optional: discarding nothing is the common answer.
|
|
766
|
+
// The reason minLength is the engine's evidence bar (kb.mjs
|
|
767
|
+
// KB_MIN_PROMOTE_REASON, enforced in vetKbWork); kept as a literal so
|
|
768
|
+
// this schema module stays dependency-free, pinned equal by
|
|
769
|
+
// test/kb-review-judgements.test.mjs.
|
|
770
|
+
kb_discards: {
|
|
771
|
+
type: 'array',
|
|
772
|
+
description: 'Promotion candidates the final review showed to be WRONG and is discarding (the entry drops out of every later read). Same evidence bar as kb_promotions. An id may not appear in both kb_promotions and kb_discards -- the engine refuses both. The engine makes the discard calls.',
|
|
773
|
+
items: {
|
|
774
|
+
type: 'object',
|
|
775
|
+
properties: {
|
|
776
|
+
id: {
|
|
777
|
+
type: 'string',
|
|
778
|
+
description: "The entry id, copied verbatim from the 'KNOWLEDGE BANK -- promotion candidates' block in your dispatch prompt. Never invent one.",
|
|
779
|
+
minLength: 1,
|
|
780
|
+
},
|
|
781
|
+
reason: {
|
|
782
|
+
type: 'string',
|
|
783
|
+
description: 'The evidence that the entry is wrong -- what you actually checked that contradicts its claim.',
|
|
784
|
+
minLength: 20,
|
|
785
|
+
},
|
|
786
|
+
},
|
|
787
|
+
required: ['id', 'reason'],
|
|
788
|
+
},
|
|
789
|
+
},
|
|
687
790
|
},
|
|
688
791
|
required: ['verdict', 'notes'],
|
|
689
792
|
};
|
|
@@ -928,19 +1031,22 @@ function longestBacktickRun(content) {
|
|
|
928
1031
|
}
|
|
929
1032
|
|
|
930
1033
|
/**
|
|
931
|
-
* The pattern src/
|
|
932
|
-
*
|
|
933
|
-
*
|
|
1034
|
+
* The pattern src/services/secret-token.ts (SECRET_TOKEN_RE) matches to
|
|
1035
|
+
* reject a dispatch outright / redact untrusted content. Mirrored here as a
|
|
1036
|
+
* literal rather than imported: this module deliberately has no dependency
|
|
1037
|
+
* on the fleet server sources. Accepts both the canonical {{secret.NAME}}
|
|
1038
|
+
* spelling and the deprecated {{secure.NAME}} one.
|
|
934
1039
|
*/
|
|
935
|
-
const
|
|
1040
|
+
const SECRET_TOKEN_RE_G = /\{\{(secret|secure)\.([a-zA-Z0-9_-]{1,64})\}\}/g;
|
|
936
1041
|
|
|
937
|
-
const
|
|
938
|
-
+ '(
|
|
1042
|
+
const SECRET_REDACTION_NOTE = 'NOTE: secret-token braces were redacted from the block above '
|
|
1043
|
+
+ '(secret.NAME is shown without its surrounding double braces). Write the braced form when '
|
|
939
1044
|
+ 'you actually use the token in an execute_command call.';
|
|
940
1045
|
|
|
941
1046
|
/**
|
|
942
|
-
* Strips the surrounding double braces from any
|
|
943
|
-
*
|
|
1047
|
+
* Strips the surrounding double braces from any secret-token reference
|
|
1048
|
+
* (either {{secret.NAME}} or the deprecated {{secure.NAME}}) in untrusted
|
|
1049
|
+
* content, keeping the "secret.NAME"/"secure.NAME" text so it still reads.
|
|
944
1050
|
*
|
|
945
1051
|
* Why this must happen before the content reaches a prompt: execute_prompt
|
|
946
1052
|
* rejects the ENTIRE dispatch -- no LLM call, an error string returned in
|
|
@@ -953,17 +1059,17 @@ const SECURE_REDACTION_NOTE = 'NOTE: secure-token braces were redacted from the
|
|
|
953
1059
|
* @param {string} content
|
|
954
1060
|
* @returns {{text: string, redacted: boolean}}
|
|
955
1061
|
*/
|
|
956
|
-
function
|
|
1062
|
+
function redactSecretTokens(content) {
|
|
957
1063
|
let text = content;
|
|
958
1064
|
let redacted = false;
|
|
959
1065
|
// Run to a fixed point rather than a single pass: replacing the inner
|
|
960
|
-
// token in `{{{{
|
|
1066
|
+
// token in `{{{{secret.A}}}}` leaves `{{secret.A}}`, so the surrounding
|
|
961
1067
|
// braces close over the redacted name and rebuild exactly the pattern
|
|
962
1068
|
// being removed. Untrusted content is attacker-influenced free-text, so
|
|
963
1069
|
// one pass is not enough. Guaranteed to terminate -- every replacement
|
|
964
1070
|
// removes four brace characters, so `text` strictly shrinks.
|
|
965
1071
|
for (;;) {
|
|
966
|
-
const next = text.replace(
|
|
1072
|
+
const next = text.replace(SECRET_TOKEN_RE_G, (_match, kind, name) => `${kind}.${name}`);
|
|
967
1073
|
if (next === text) break;
|
|
968
1074
|
text = next;
|
|
969
1075
|
redacted = true;
|
|
@@ -996,7 +1102,7 @@ export function wrapUntrustedBlock(sourceLabel, content) {
|
|
|
996
1102
|
if (typeof content !== 'string') {
|
|
997
1103
|
throw new TypeError('[contracts] wrapUntrustedBlock requires content to be a string');
|
|
998
1104
|
}
|
|
999
|
-
const { text: safeContent, redacted } =
|
|
1105
|
+
const { text: safeContent, redacted } = redactSecretTokens(content);
|
|
1000
1106
|
const fenceLength = Math.max(MIN_FENCE_LENGTH, longestBacktickRun(safeContent) + 1);
|
|
1001
1107
|
const fence = '`'.repeat(fenceLength);
|
|
1002
1108
|
return [
|
|
@@ -1005,7 +1111,7 @@ export function wrapUntrustedBlock(sourceLabel, content) {
|
|
|
1005
1111
|
`${fence}${UNTRUSTED_BLOCK_FENCE_LABEL}`,
|
|
1006
1112
|
safeContent,
|
|
1007
1113
|
fence,
|
|
1008
|
-
...(redacted ? [
|
|
1114
|
+
...(redacted ? [SECRET_REDACTION_NOTE] : []),
|
|
1009
1115
|
].join('\n');
|
|
1010
1116
|
}
|
|
1011
1117
|
|