@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
|
@@ -7,17 +7,30 @@
|
|
|
7
7
|
// a sprint mutates. Nothing else in the engine verifies that the database a
|
|
8
8
|
// member resolves to is the project the supervisor launched the sprint for.
|
|
9
9
|
// This module runs the three read-only probes from beads-identity.mjs on the
|
|
10
|
-
//
|
|
10
|
+
// backlog member first and then on every other distinct member, and
|
|
11
11
|
// compares each answer against the expected identity. The expected identity
|
|
12
12
|
// is either the supervisor's (`--expect-beads`, args.expectBeads) or, absent
|
|
13
|
-
// that, the
|
|
13
|
+
// that, the backlog member's own probed identity -- in which case only
|
|
14
14
|
// the OTHER members are compared and the log says so.
|
|
15
15
|
//
|
|
16
16
|
// Severity model (deliberate):
|
|
17
17
|
// - MISMATCH is FATAL: a field that resolved on BOTH sides and differs
|
|
18
18
|
// means the member's bd points at a different project. Throws
|
|
19
19
|
// BeadsIdentityError (reason MISMATCH) before any bd mutation.
|
|
20
|
-
// -
|
|
20
|
+
// - bd MISSING is FATAL: a bd probe whose failure classifies as a
|
|
21
|
+
// missing-tool failure for bd itself (not installed / not on PATH) throws
|
|
22
|
+
// BeadsIdentityError (reason MISSING_TOOL) before any dispatch, naming
|
|
23
|
+
// the member and the fix -- every bd there would fail mid-sprint.
|
|
24
|
+
// - a beads-reading member with NO beads database, or with a database but
|
|
25
|
+
// no sync.remote while the expectation names one, is SET UP before any
|
|
26
|
+
// dispatch (setupMemberBeads below): `bd config set sync.remote
|
|
27
|
+
// <expected>` + `bd bootstrap`, which clones the database from that
|
|
28
|
+
// remote non-destructively (an existing database is never replaced). The
|
|
29
|
+
// member is then re-probed and must match. When that cannot be done the
|
|
30
|
+
// preflight throws BEADS_SETUP_FAILED naming the member, the cause and
|
|
31
|
+
// the fix -- never a warning followed by dispatches whose `bd show`
|
|
32
|
+
// cannot find the sprint's issues.
|
|
33
|
+
// - any other UNRESOLVED probe is a WARNING: a probe that failed, or answered
|
|
21
34
|
// something unparseable/empty, leaves that field out of the comparison.
|
|
22
35
|
// The warning names the member, the field, the probe, the error and the
|
|
23
36
|
// fix, so the operator can repair it; the first real bd on that member
|
|
@@ -37,8 +50,12 @@ import {
|
|
|
37
50
|
parseBeadsIdentity,
|
|
38
51
|
compareIdentity,
|
|
39
52
|
formatBeadsIdentity,
|
|
53
|
+
normalizeRemoteUrl,
|
|
54
|
+
hasBeadsDatabase,
|
|
40
55
|
} from './beads-identity.mjs';
|
|
41
|
-
import { BeadsIdentityError, BEADS_IDENTITY_FAILURE_REASONS } from './errors.mjs';
|
|
56
|
+
import { BeadsIdentityError, BEADS_IDENTITY_FAILURE_REASONS, VCS_FAILURE_KINDS } from './errors.mjs';
|
|
57
|
+
import { syncBefore as doltSyncBefore } from './dolt-sync.mjs';
|
|
58
|
+
import { classifyFailure, commandBinary } from './vcs-module.mjs';
|
|
42
59
|
|
|
43
60
|
// Short: three cheap local reads per member. A member that cannot answer
|
|
44
61
|
// `bd where` inside a minute is not a member this sprint should mutate.
|
|
@@ -118,6 +135,11 @@ export function createBeadsIdentityProber({ command, timeoutS = BEADS_IDENTITY_P
|
|
|
118
135
|
}
|
|
119
136
|
return pending;
|
|
120
137
|
},
|
|
138
|
+
// Drops the memoized answer so the next probe() re-runs the probes --
|
|
139
|
+
// used after the preflight itself changed the member's beads setup.
|
|
140
|
+
forget(member) {
|
|
141
|
+
cache.delete(member);
|
|
142
|
+
},
|
|
121
143
|
};
|
|
122
144
|
}
|
|
123
145
|
|
|
@@ -151,18 +173,466 @@ function unresolvedFieldWarning(member, field, probed) {
|
|
|
151
173
|
// One compared field is empty on the EXPECTED side (the supplied
|
|
152
174
|
// --expect-beads carries no value for it, or the orchestrator it was derived
|
|
153
175
|
// from could not report it), so no member can be checked on it.
|
|
154
|
-
function unresolvedExpectedWarning(field, expectedFrom,
|
|
155
|
-
const source = expectedFrom === '
|
|
156
|
-
? `the
|
|
176
|
+
function unresolvedExpectedWarning(field, expectedFrom, backlogMember) {
|
|
177
|
+
const source = expectedFrom === 'backlog'
|
|
178
|
+
? `the backlog member '${backlogMember}' it was derived from could not report ${field}`
|
|
157
179
|
: `the supplied expected beads identity carries no ${field}`;
|
|
158
180
|
return `${source}; ${field} is not compared on any member this sprint. ` +
|
|
159
|
-
`To fix: ${BEADS_IDENTITY_FIELD_FIX[field]}${expectedFrom === '
|
|
181
|
+
`To fix: ${BEADS_IDENTITY_FIELD_FIX[field]}${expectedFrom === 'backlog' ? ' (on the backlog member), or launch via the supervisor so --expect-beads is supplied' : ''}.`;
|
|
160
182
|
}
|
|
161
183
|
|
|
162
|
-
function noExpectationWarning(
|
|
163
|
-
return `no expected beads identity was supplied and the
|
|
184
|
+
function noExpectationWarning(backlogMember, probed) {
|
|
185
|
+
return `no expected beads identity was supplied and the backlog member '${backlogMember}' could not report its beads database ` +
|
|
164
186
|
`('${BEADS_IDENTITY_PROBES.where}' -> ${probeDetail(probed, 'where')}); no cross-member beads identity check will happen this sprint. ` +
|
|
165
|
-
`To restore it: fix the
|
|
187
|
+
`To restore it: fix the backlog member's beads (${BEADS_IDENTITY_FIELD_FIX.prefix}), or launch via the supervisor so --expect-beads is supplied.`;
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
export const BD_MISSING_FIX =
|
|
191
|
+
"install bd on that member (or fix that member's PATH) so 'bd --version' works in its workFolder shell " +
|
|
192
|
+
'(re-running the member fleet install places it in the member fleet bin dir), then relaunch';
|
|
193
|
+
|
|
194
|
+
// The one probe outcome that is fatal besides a mismatch -- the member cannot
|
|
195
|
+
// run bd AT ALL (not installed / not on PATH). Every later bd command on it
|
|
196
|
+
// would fail, and neither the sync self-heal nor the beads set-up below can
|
|
197
|
+
// fix a missing binary, so the sprint stops here with the fix named. Only a
|
|
198
|
+
// failure of a bd probe that classifies as missing-tool FOR bd counts (the
|
|
199
|
+
// shared VCS failure classifier); every other probe failure (no database,
|
|
200
|
+
// unset field, unrelated profile noise) stays a warning.
|
|
201
|
+
export function assertBdPresent(member, probed) {
|
|
202
|
+
for (const f of probed.failures) {
|
|
203
|
+
const tool = commandBinary(f.probe);
|
|
204
|
+
if (tool !== 'bd') continue;
|
|
205
|
+
const c = classifyFailure(f.error, { tool });
|
|
206
|
+
if (c.kind !== VCS_FAILURE_KINDS.MISSING_TOOL) continue;
|
|
207
|
+
throw new BeadsIdentityError(
|
|
208
|
+
`Beads identity check failed: 'bd' is not installed or not on PATH on member '${member}' ` +
|
|
209
|
+
`('${f.probe}' -> ${summarizeRaw(f.error)}). Every sprint role on it runs bd, so the sprint stops before any dispatch; ` +
|
|
210
|
+
're-provisioning credentials cannot fix a missing binary. To fix: ' + BD_MISSING_FIX + '.',
|
|
211
|
+
{ reason: BEADS_IDENTITY_FAILURE_REASONS.MISSING_TOOL, member, details: { tool: 'bd', probe: f.probe, error: f.error } }
|
|
212
|
+
);
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
// ---------------------------------------------------------------------------
|
|
217
|
+
// Member beads set-up (the one self-heal this preflight performs).
|
|
218
|
+
//
|
|
219
|
+
// A role that reads beads on a member (`bd show <root>`, `bd ready`, ...)
|
|
220
|
+
// reads the database bd resolves in THAT member's workFolder. A fresh clone
|
|
221
|
+
// with bd installed but no beads database -- or with a database whose
|
|
222
|
+
// sync.remote is unset, so no D-pull ever freshens it -- answers "not found"
|
|
223
|
+
// for every sprint issue. So before any dispatch the preflight sets the
|
|
224
|
+
// member up from the sprint's EXPECTED beads remote (verified against bd
|
|
225
|
+
// 1.3 on POSIX and PowerShell):
|
|
226
|
+
//
|
|
227
|
+
// both cases: git ls-files (modified / untracked beads paths, BEFORE any write)
|
|
228
|
+
// <ensure .beads/config.yaml exists> (bd config set refuses to write
|
|
229
|
+
// without a workspace; per-shell,
|
|
230
|
+
// never truncates)
|
|
231
|
+
// <ensure line 'sync.remote: "<expected>"' in .beads/config.local.yaml>
|
|
232
|
+
// (bd's untracked local layer: the
|
|
233
|
+
// durable record, see "target repo")
|
|
234
|
+
// bd config set sync.remote <expected>
|
|
235
|
+
// no database: bd bootstrap --dry-run --json (must plan a clone FROM <expected>;
|
|
236
|
+
// any other plan -- JSONL import,
|
|
237
|
+
// fresh database -- would yield a
|
|
238
|
+
// database with an unrelated history)
|
|
239
|
+
// bd bootstrap --yes (clones and wires the dolt remote
|
|
240
|
+
// 'origin'; never deletes data)
|
|
241
|
+
// database but
|
|
242
|
+
// no sync.remote: bd dolt remote list --json (bootstrap does NOT wire 'origin' on an
|
|
243
|
+
// existing database; an 'origin' pointing
|
|
244
|
+
// elsewhere is refused, never rewired)
|
|
245
|
+
// bd dolt remote add origin <expected> (only when 'origin' is absent)
|
|
246
|
+
// pull via DoltSync.syncBefore (proves the existing database is a
|
|
247
|
+
// clone of <expected> and brings it current)
|
|
248
|
+
// finally (success or failure):
|
|
249
|
+
// git checkout -- <each tracked beads file the set-up changed>
|
|
250
|
+
// <git info/exclude each beads path the set-up left untracked>
|
|
251
|
+
//
|
|
252
|
+
// Target repo: the member's work folder is a clone of the sprint's TARGET
|
|
253
|
+
// repository, and a doer's `git add -A` there must never carry the set-up
|
|
254
|
+
// into the target PR. bd rewrites tracked beads files during set-up (it
|
|
255
|
+
// reflows config.yaml and adds a sync block that would switch sync on for
|
|
256
|
+
// every user of the repo, appends to .gitignore, rewrites metadata.json) and
|
|
257
|
+
// leaves untracked ones (.beads.gate.lock at the root, config.local.yaml, a
|
|
258
|
+
// whole .beads/ when the repo tracks only issues.jsonl). So the tracked files
|
|
259
|
+
// it changed are restored from git -- bd keeps working: it reads sync.remote
|
|
260
|
+
// from config.local.yaml and the database is untouched -- and the new
|
|
261
|
+
// untracked paths go into the member's git info/exclude. Verified with real
|
|
262
|
+
// bd 1.3 on a fresh clone of a repo that commits its beads config: `git
|
|
263
|
+
// status --porcelain` is empty afterwards, `git add -A` stages nothing, and
|
|
264
|
+
// a later checkout/merge of an upstream change to config.yaml still works.
|
|
265
|
+
//
|
|
266
|
+
// Every step goes through the injected command() with the member named, so
|
|
267
|
+
// the runner's command() wrapper (DoltSync.noteMemberCommand) sees the
|
|
268
|
+
// `bd config set` / `bd bootstrap` / `bd dolt remote` and drops that member's
|
|
269
|
+
// sync.remote memo. The member's VCS credential is ensured first (the clone
|
|
270
|
+
// may need auth). The bd command strings are plain `bd ...` with the remote
|
|
271
|
+
// passed as one bare word: execute_command establishes the cwd per member
|
|
272
|
+
// OS/shell, and the remote is refused unless it is made only of characters
|
|
273
|
+
// every supported shell (POSIX, PowerShell, cmd) passes through verbatim --
|
|
274
|
+
// no quoting, no shell expansion.
|
|
275
|
+
//
|
|
276
|
+
// Older-schema remote: bd may auto-apply pending schema migrations to a
|
|
277
|
+
// freshly cloned database and leave them uncommitted in the working set, and
|
|
278
|
+
// the next D-pull then dies on "local changes would be stomped". A dispatch
|
|
279
|
+
// member must not publish a shared-schema migration on its own, so when any
|
|
280
|
+
// set-up output (or the re-probe after it) reports that, the preflight stops
|
|
281
|
+
// with BEADS_SETUP_FAILED naming the cause and the fix (publish the
|
|
282
|
+
// migration once, from the backlog member) instead of leaving the trap for
|
|
283
|
+
// the first dispatch.
|
|
284
|
+
// ---------------------------------------------------------------------------
|
|
285
|
+
|
|
286
|
+
// The roles whose contracts run bd on their member. deployer and ci-watcher
|
|
287
|
+
// do not; a member mapped ONLY to those is not set up (a missing database
|
|
288
|
+
// there stays the warning it was).
|
|
289
|
+
export const BEADS_READING_ROLES = Object.freeze([
|
|
290
|
+
'planner',
|
|
291
|
+
'plan-reviewer',
|
|
292
|
+
'doer',
|
|
293
|
+
'reviewer',
|
|
294
|
+
'integ-test-runner',
|
|
295
|
+
'regression-test-runner',
|
|
296
|
+
'harvester',
|
|
297
|
+
]);
|
|
298
|
+
|
|
299
|
+
// A bootstrap clones the whole beads history: allow it far longer than a probe.
|
|
300
|
+
export const BEADS_SETUP_TIMEOUT_S = 600;
|
|
301
|
+
const SETUP_LABEL = 'beads-setup';
|
|
302
|
+
|
|
303
|
+
// The work-folder-relative file whose presence makes the folder a beads
|
|
304
|
+
// workspace `bd config set` can write to.
|
|
305
|
+
export const BEADS_WORKSPACE_CONFIG_FILE = '.beads/config.yaml';
|
|
306
|
+
// bd's untracked, machine-local config layer (read over config.yaml). The
|
|
307
|
+
// sync remote is recorded HERE, because bd rewrites the (often tracked)
|
|
308
|
+
// config.yaml during set-up and the preflight restores that file afterwards.
|
|
309
|
+
export const BEADS_LOCAL_CONFIG_FILE = '.beads/config.local.yaml';
|
|
310
|
+
export const beadsLocalSyncRemoteLine = (url) => `sync.remote: "${url}"`;
|
|
311
|
+
|
|
312
|
+
export const BEADS_SETUP_COMMANDS = Object.freeze({
|
|
313
|
+
setSyncRemote: (url) => `bd config set sync.remote ${url}`,
|
|
314
|
+
plan: 'bd bootstrap --dry-run --json',
|
|
315
|
+
bootstrap: 'bd bootstrap --yes',
|
|
316
|
+
remoteList: 'bd dolt remote list --json',
|
|
317
|
+
addOrigin: (url) => `bd dolt remote add origin ${url}`,
|
|
318
|
+
// The pull itself is NOT a command here: every dolt pull/push goes
|
|
319
|
+
// through ./dolt-sync.mjs (DoltSync.syncBefore), which also brings its
|
|
320
|
+
// transient-retry ladder and the reactive VCS-auth self-heal.
|
|
321
|
+
});
|
|
322
|
+
|
|
323
|
+
// Characters a bare word keeps verbatim in POSIX shells, PowerShell and cmd
|
|
324
|
+
// (no $, %, backtick, quotes, spaces, ;, &, |, commas, parens, backslashes).
|
|
325
|
+
const SHELL_SAFE_REMOTE_RE = /^[A-Za-z0-9][A-Za-z0-9._~:/@+=-]*$/;
|
|
326
|
+
|
|
327
|
+
// bd's report that it migrated a database's schema locally, or that the
|
|
328
|
+
// remote is behind the local bd's schema. Matched against bd's own format
|
|
329
|
+
// strings (bd 1.3 source):
|
|
330
|
+
// "Smart gate (%s): auto-applying %d pending deterministic schema %s to a
|
|
331
|
+
// remote-backed database (...). Run `bd dolt push` after."
|
|
332
|
+
// "The database cloned from %s needs %d schema %s (v%d -> v%d)." ...
|
|
333
|
+
// "Re-running `%s` will NOT fix this -- the remote itself is behind."
|
|
334
|
+
// (the first reproduced verbatim by a live sprint; neither reproducible here
|
|
335
|
+
// without an older-schema remote).
|
|
336
|
+
const SCHEMA_MIGRATION_RE = /auto-applying\b[^\n]*\bschema migrations?|schema migrations?[^\n]*\bbd dolt push\b|\bneeds \d+ schema migrations?\b|remote itself is behind|remote[^\n]*\b(?:behind|older)\b[^\n]*\bschema|schema[^\n]*\bremote[^\n]*\b(?:behind|older)\b/i;
|
|
337
|
+
|
|
338
|
+
export function hasSchemaMigrationReport(text) {
|
|
339
|
+
return SCHEMA_MIGRATION_RE.test(String(text || ''));
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
function setupFix(url) {
|
|
343
|
+
return `in that member's workFolder create an empty '${BEADS_WORKSPACE_CONFIG_FILE}' if there is none, run 'bd config set sync.remote ${url || '<beads remote>'}' ` +
|
|
344
|
+
"then 'bd bootstrap --yes' (the member needs a VCS credential that can read that remote), check 'bd where' reports the project, then rerun the sprint";
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
const SCHEMA_FIX =
|
|
348
|
+
"the shared beads remote is at an older bd schema than the member's bd. Publish the migration once, from the backlog member: " +
|
|
349
|
+
'push its beads database to the beads remote from its workFolder (with a VCS credential that can push that remote), then rerun the sprint';
|
|
350
|
+
|
|
351
|
+
function setupFailed(member, cause, fix, details) {
|
|
352
|
+
return new BeadsIdentityError(
|
|
353
|
+
`Beads preflight failed: member '${member}' ${cause}. A beads-reading role dispatched there would read a database ` +
|
|
354
|
+
`without this sprint's issues, so the sprint stops before any dispatch. To fix: ${fix}.`,
|
|
355
|
+
{ reason: BEADS_IDENTITY_FAILURE_REASONS.BEADS_SETUP_FAILED, member, details }
|
|
356
|
+
);
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
function parseFirstJson(text, open = '{') {
|
|
360
|
+
const t = String(text || '');
|
|
361
|
+
const start = t.indexOf(open);
|
|
362
|
+
if (start < 0) return null;
|
|
363
|
+
try {
|
|
364
|
+
return JSON.parse(t.slice(start));
|
|
365
|
+
} catch {
|
|
366
|
+
return null;
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
|
|
370
|
+
// Paths the set-up can create or rewrite in the member's work tree, relative
|
|
371
|
+
// to it: `.beads/...` (bd reflows a tracked config.yaml, appends to a tracked
|
|
372
|
+
// .gitignore, rewrites metadata.json) and the `.beads.gate.lock` bd leaves at
|
|
373
|
+
// the work-folder root. Only lines of git output matching this are acted on.
|
|
374
|
+
const BEADS_TREE_PATH_RE = /^\.beads(?:\/[A-Za-z0-9._/-]*)?$|^\.beads\.gate\.lock$/;
|
|
375
|
+
|
|
376
|
+
export const BEADS_TREE_COMMANDS = Object.freeze({
|
|
377
|
+
// Tracked beads files with work-tree changes.
|
|
378
|
+
modified: 'git ls-files -m -- .beads',
|
|
379
|
+
// Untracked, not ignored; a wholly untracked directory collapses to one entry.
|
|
380
|
+
untracked: 'git ls-files --others --exclude-standard --directory -- .beads .beads.gate.lock',
|
|
381
|
+
restore: (relPath) => `git checkout -- ${relPath}`,
|
|
382
|
+
// The work folder's path below the repository root ('' at the root).
|
|
383
|
+
prefix: 'git rev-parse --show-prefix',
|
|
384
|
+
});
|
|
385
|
+
|
|
386
|
+
function beadsTreePaths(text) {
|
|
387
|
+
return String(text || '').split(/\r?\n/).map((l) => l.trim()).filter((l) => BEADS_TREE_PATH_RE.test(l) && !l.split('/').includes('..'));
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
/**
|
|
391
|
+
* Sets up one member's beads from `url` (see the section comment). Throws
|
|
392
|
+
* BeadsIdentityError(BEADS_SETUP_FAILED) on any step that fails; resolves
|
|
393
|
+
* when every step succeeded. Verifying the result is the caller's job (a
|
|
394
|
+
* fresh identity probe).
|
|
395
|
+
*
|
|
396
|
+
* The target repository must never receive the set-up's side effects through
|
|
397
|
+
* a later commit on the member (a doer's `git add -A`): bd rewrites tracked
|
|
398
|
+
* beads files (config.yaml gains the sync remote, .gitignore and
|
|
399
|
+
* metadata.json change) and adds untracked ones. So the beads paths that are
|
|
400
|
+
* modified/untracked are recorded BEFORE the first write, and afterwards --
|
|
401
|
+
* on success AND on failure, since a failed set-up may already have written
|
|
402
|
+
* -- every tracked file the set-up changed is restored (`git checkout --`;
|
|
403
|
+
* the sync remote survives in the untracked config.local.yaml) and every new
|
|
404
|
+
* untracked path is added to the member's git info/exclude
|
|
405
|
+
* (memberShell().ensureGitExcluded). The member's work tree then reports
|
|
406
|
+
* clean and `git add -A` stages nothing from the set-up.
|
|
407
|
+
*
|
|
408
|
+
* @param {{ command: Function, member: string, url: string, hasDb: boolean,
|
|
409
|
+
* memberShell?: (member: string) => Promise<{ ensureFile: (relPath: string) => string, ensureLine: (relPath: string, line: string) => string, ensureGitExcluded: (entry: string) => string }>,
|
|
410
|
+
* ensureVcsAuth?: (member: string) => Promise<void>, onAuthFailure?: Function,
|
|
411
|
+
* pullBeads?: Function, log?: Function, timeoutS?: number }} opts
|
|
412
|
+
* `memberShell` returns the member's OS/shell command builder (the SE
|
|
413
|
+
* command primitives); required. `onAuthFailure` is DoltSync's reactive
|
|
414
|
+
* VCS-auth self-heal for the pull; `pullBeads` replaces
|
|
415
|
+
* DoltSync.syncBefore (test seam).
|
|
416
|
+
* @returns {Promise<string[]>} the commands issued, in order
|
|
417
|
+
*/
|
|
418
|
+
export async function setupMemberBeads({ command, member, url, hasDb, memberShell, ensureVcsAuth, onAuthFailure, pullBeads, log = () => {}, timeoutS = BEADS_SETUP_TIMEOUT_S }) {
|
|
419
|
+
if (!SHELL_SAFE_REMOTE_RE.test(url)) {
|
|
420
|
+
throw setupFailed(member,
|
|
421
|
+
`needs its beads set up from the expected beads remote '${url}', which contains characters that cannot be passed verbatim to every member shell`,
|
|
422
|
+
setupFix(url), { step: 'validate', url });
|
|
423
|
+
}
|
|
424
|
+
const issued = [];
|
|
425
|
+
const run = async (cmd) => {
|
|
426
|
+
issued.push(cmd);
|
|
427
|
+
let res;
|
|
428
|
+
try {
|
|
429
|
+
res = await command(cmd, { member_name: member, silent: true, failSoft: true, label: SETUP_LABEL, timeout_s: timeoutS });
|
|
430
|
+
} catch (err) {
|
|
431
|
+
res = { ok: false, output: '', error: err && err.message ? err.message : String(err) };
|
|
432
|
+
}
|
|
433
|
+
const error = failureOf(res);
|
|
434
|
+
return { ok: error === null, output: outputOf(res), error };
|
|
435
|
+
};
|
|
436
|
+
const assertNoMigration = (step, r) => {
|
|
437
|
+
const text = `${r.output}\n${r.error || ''}`;
|
|
438
|
+
if (hasSchemaMigrationReport(text)) {
|
|
439
|
+
throw setupFailed(member,
|
|
440
|
+
`had its beads set up from '${url}', but bd reports a schema migration against that remote ('${step}' -> ${summarizeRaw(text)})`,
|
|
441
|
+
SCHEMA_FIX, { step, url, cause: 'schema-migration' });
|
|
442
|
+
}
|
|
443
|
+
};
|
|
444
|
+
|
|
445
|
+
let shell = null;
|
|
446
|
+
try {
|
|
447
|
+
shell = typeof memberShell === 'function' ? await memberShell(member) : null;
|
|
448
|
+
} catch (err) {
|
|
449
|
+
log(`[beads-identity] could not resolve the shell of member '${member}': ${err && err.message ? err.message : err}`);
|
|
450
|
+
}
|
|
451
|
+
if (!shell || typeof shell.ensureFile !== 'function' || typeof shell.ensureLine !== 'function' || typeof shell.ensureGitExcluded !== 'function') {
|
|
452
|
+
throw setupFailed(member, 'needs its beads set up, but no command could be built for its shell', setupFix(url), { step: 'shell', url });
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
// What git already reports for the beads paths, before any write.
|
|
456
|
+
const listTree = async () => {
|
|
457
|
+
const modified = await run(BEADS_TREE_COMMANDS.modified);
|
|
458
|
+
const untracked = await run(BEADS_TREE_COMMANDS.untracked);
|
|
459
|
+
if (!modified.ok || !untracked.ok) {
|
|
460
|
+
const bad = !modified.ok ? modified : untracked;
|
|
461
|
+
throw setupFailed(member,
|
|
462
|
+
`needs its beads set up, but its workFolder's git state cannot be read to keep the set-up out of commits (${summarizeRaw(bad.error || bad.output)})`,
|
|
463
|
+
`make sure the member's workFolder is a git clone with git on PATH, or ${setupFix(url)}`, { step: 'tree', url });
|
|
464
|
+
}
|
|
465
|
+
return { modified: new Set(beadsTreePaths(modified.output)), untracked: new Set(beadsTreePaths(untracked.output)) };
|
|
466
|
+
};
|
|
467
|
+
const before = await listTree();
|
|
468
|
+
if (before.modified.size) {
|
|
469
|
+
log(`${BEADS_IDENTITY_WARNING_PREFIX}member '${member}' already has local changes to ${[...before.modified].join(', ')}; ` +
|
|
470
|
+
'the beads set-up may add to them and will not restore them -- review those files before anything on that member is committed.');
|
|
471
|
+
}
|
|
472
|
+
// info/exclude patterns are relative to the repository root, git ls-files
|
|
473
|
+
// paths to the work folder: a work folder below the root needs its prefix.
|
|
474
|
+
const prefixRes = await run(BEADS_TREE_COMMANDS.prefix);
|
|
475
|
+
const rootPrefix = prefixRes.ok ? String(prefixRes.output || '').split(/\r?\n/).map((l) => l.trim()).find((l) => /^[A-Za-z0-9._/-]*\/$/.test(l) && !l.split('/').includes('..')) || '' : null;
|
|
476
|
+
if (rootPrefix === null) {
|
|
477
|
+
throw setupFailed(member,
|
|
478
|
+
`needs its beads set up, but its workFolder's position in its git clone cannot be read (${summarizeRaw(prefixRes.error || prefixRes.output)})`,
|
|
479
|
+
`make sure the member's workFolder is a git clone with git on PATH, or ${setupFix(url)}`, { step: 'tree', url });
|
|
480
|
+
}
|
|
481
|
+
|
|
482
|
+
log(`[beads-identity] member '${member}' ${hasDb ? 'has a beads database with no sync.remote' : 'has no beads database in its workFolder'}; setting it up from the expected beads remote ${url}.`);
|
|
483
|
+
if (typeof ensureVcsAuth === 'function') {
|
|
484
|
+
try {
|
|
485
|
+
await ensureVcsAuth(member);
|
|
486
|
+
} catch (err) {
|
|
487
|
+
log(`[beads-identity] could not refresh the VCS credential for member '${member}' before its beads set-up (continuing): ${err && err.message ? err.message : err}`);
|
|
488
|
+
}
|
|
489
|
+
}
|
|
490
|
+
|
|
491
|
+
const apply = async () => {
|
|
492
|
+
const runShell = async (build, what) => {
|
|
493
|
+
let cmd = '';
|
|
494
|
+
try {
|
|
495
|
+
cmd = String(build() || '');
|
|
496
|
+
} catch (err) {
|
|
497
|
+
log(`[beads-identity] could not build the command to ${what} for member '${member}': ${err && err.message ? err.message : err}`);
|
|
498
|
+
}
|
|
499
|
+
const r = cmd ? await run(cmd) : { ok: false, error: 'no command for this shell' };
|
|
500
|
+
if (!r.ok) {
|
|
501
|
+
throw setupFailed(member, `could not ${what} in its workFolder (${summarizeRaw(r.error || r.output)})`, setupFix(url), { step: 'workspace', url });
|
|
502
|
+
}
|
|
503
|
+
};
|
|
504
|
+
// bd refuses `config set` without a workspace config file.
|
|
505
|
+
await runShell(() => shell.ensureFile(BEADS_WORKSPACE_CONFIG_FILE), `create '${BEADS_WORKSPACE_CONFIG_FILE}'`);
|
|
506
|
+
// The durable record of the sync remote, in the untracked local layer.
|
|
507
|
+
await runShell(() => shell.ensureLine(BEADS_LOCAL_CONFIG_FILE, beadsLocalSyncRemoteLine(url)), `record the sync remote in '${BEADS_LOCAL_CONFIG_FILE}'`);
|
|
508
|
+
|
|
509
|
+
const setCmd = BEADS_SETUP_COMMANDS.setSyncRemote(url);
|
|
510
|
+
const set = await run(setCmd);
|
|
511
|
+
if (!set.ok) {
|
|
512
|
+
throw setupFailed(member, `could not set its sync.remote ('${setCmd}' -> ${summarizeRaw(set.error || set.output)})`, setupFix(url), { step: 'set-sync-remote', url });
|
|
513
|
+
}
|
|
514
|
+
|
|
515
|
+
if (!hasDb) {
|
|
516
|
+
const plan = await run(BEADS_SETUP_COMMANDS.plan);
|
|
517
|
+
const planObj = plan.ok ? parseFirstJson(plan.output) : null;
|
|
518
|
+
const planned = planObj && typeof planObj.action === 'string' ? planObj.action : '';
|
|
519
|
+
const plannedRemote = planObj && typeof planObj.sync_remote === 'string' ? planObj.sync_remote : '';
|
|
520
|
+
if (!plan.ok || planned !== 'sync' || normalizeRemoteUrl(plannedRemote) !== normalizeRemoteUrl(url)) {
|
|
521
|
+
const why = !plan.ok
|
|
522
|
+
? summarizeRaw(plan.error || plan.output)
|
|
523
|
+
: "planned action '" + (planned || '(none)') + "'"
|
|
524
|
+
+ (planObj && planObj.reason ? ' (' + summarizeRaw(planObj.reason) + ')' : '')
|
|
525
|
+
+ (plannedRemote ? " from '" + plannedRemote + "'" : '');
|
|
526
|
+
throw setupFailed(member,
|
|
527
|
+
`has no beads database and 'bd bootstrap' would not clone it from the expected beads remote '${url}' ('${BEADS_SETUP_COMMANDS.plan}' -> ${why}); ` +
|
|
528
|
+
'any other bootstrap would create a database with an unrelated history',
|
|
529
|
+
`make sure '${url}' holds the project's beads data and the member's VCS credential can read it, then ${setupFix(url)}`,
|
|
530
|
+
{ step: 'plan', url, plan: planObj });
|
|
531
|
+
}
|
|
532
|
+
|
|
533
|
+
const boot = await run(BEADS_SETUP_COMMANDS.bootstrap);
|
|
534
|
+
assertNoMigration(BEADS_SETUP_COMMANDS.bootstrap, boot);
|
|
535
|
+
if (!boot.ok) {
|
|
536
|
+
throw setupFailed(member, `could not bootstrap its beads from '${url}' ('${BEADS_SETUP_COMMANDS.bootstrap}' -> ${summarizeRaw(boot.error || boot.output)})`, setupFix(url), { step: 'bootstrap', url });
|
|
537
|
+
}
|
|
538
|
+
return issued;
|
|
539
|
+
}
|
|
540
|
+
|
|
541
|
+
// An existing database: make sure its dolt 'origin' is the expected
|
|
542
|
+
// remote (adding it when absent, refusing a different one), then pull.
|
|
543
|
+
const list = await run(BEADS_SETUP_COMMANDS.remoteList);
|
|
544
|
+
const remotes = list.ok ? parseFirstJson(list.output, '[') : null;
|
|
545
|
+
if (!Array.isArray(remotes)) {
|
|
546
|
+
throw setupFailed(member, `could not list its beads dolt remotes ('${BEADS_SETUP_COMMANDS.remoteList}' -> ${summarizeRaw(list.error || list.output)})`,
|
|
547
|
+
setupFix(url), { step: 'remote-list', url });
|
|
548
|
+
}
|
|
549
|
+
const origin = remotes.find((r) => r && r.name === 'origin');
|
|
550
|
+
if (origin && normalizeRemoteUrl(String(origin.url || '')) !== normalizeRemoteUrl(url)) {
|
|
551
|
+
throw setupFailed(member,
|
|
552
|
+
`has an existing beads database whose dolt remote 'origin' is '${origin.url}', not the expected beads remote '${url}'; it is not rewired automatically`,
|
|
553
|
+
`check which beads project that member's database belongs to; if it is this project, run 'bd dolt remote add origin ${url}' in its workFolder, otherwise move that database aside, then rerun the sprint`,
|
|
554
|
+
{ step: 'remote-list', url, origin: origin.url });
|
|
555
|
+
}
|
|
556
|
+
if (!origin) {
|
|
557
|
+
const addCmd = BEADS_SETUP_COMMANDS.addOrigin(url);
|
|
558
|
+
const add = await run(addCmd);
|
|
559
|
+
if (!add.ok) {
|
|
560
|
+
throw setupFailed(member, `could not add the dolt remote 'origin' ('${addCmd}' -> ${summarizeRaw(add.error || add.output)})`, setupFix(url), { step: 'remote-add', url });
|
|
561
|
+
}
|
|
562
|
+
}
|
|
563
|
+
// The pull goes through DoltSync (the single dolt pull/push surface):
|
|
564
|
+
// its retry ladder and reactive VCS-auth self-heal apply. The
|
|
565
|
+
// remote was configured just above, so its pre-gate is answered
|
|
566
|
+
// directly, and the tip fingerprint is skipped -- this first pull
|
|
567
|
+
// must be real.
|
|
568
|
+
let pulled = null;
|
|
569
|
+
let pullError = '';
|
|
570
|
+
try {
|
|
571
|
+
pulled = await (pullBeads || doltSyncBefore)(member, {
|
|
572
|
+
// DoltSync names the member on every command it issues.
|
|
573
|
+
command,
|
|
574
|
+
log,
|
|
575
|
+
fatal: true,
|
|
576
|
+
onAuthFailure,
|
|
577
|
+
checkSyncRemoteConfigured: async () => true,
|
|
578
|
+
remoteTipFingerprint: false,
|
|
579
|
+
});
|
|
580
|
+
} catch (err) {
|
|
581
|
+
pullError = [err && err.message, err && err.doltOutput].filter(Boolean).join('\n') || String(err);
|
|
582
|
+
}
|
|
583
|
+
if (pullError) assertNoMigration('beads pull', { output: '', error: pullError });
|
|
584
|
+
const pullOk = !pullError && pulled && pulled.ok !== false && !pulled.skipped && !pulled.degraded;
|
|
585
|
+
if (!pullOk) {
|
|
586
|
+
const why = pullError || `pull did not run (${summarizeRaw(JSON.stringify(pulled))})`;
|
|
587
|
+
throw setupFailed(member,
|
|
588
|
+
`has an existing beads database that cannot pull from the expected beads remote '${url}' (${summarizeRaw(why)}); ` +
|
|
589
|
+
'it is most likely not a clone of that remote',
|
|
590
|
+
"move that member's existing beads database aside (it is never deleted automatically) so the next sprint clones it from the remote, " +
|
|
591
|
+
`or ${setupFix(url)}`,
|
|
592
|
+
{ step: 'pull', url });
|
|
593
|
+
}
|
|
594
|
+
};
|
|
595
|
+
|
|
596
|
+
// Keep the set-up's work-tree changes out of every later commit on the
|
|
597
|
+
// member -- after success AND failure (a failed set-up may have written).
|
|
598
|
+
const protect = async () => {
|
|
599
|
+
const after = await listTree();
|
|
600
|
+
const changed = [...after.modified].filter((p) => !before.modified.has(p));
|
|
601
|
+
const added = [...after.untracked].filter((p) => !before.untracked.has(p));
|
|
602
|
+
for (const p of changed) {
|
|
603
|
+
const r = await run(BEADS_TREE_COMMANDS.restore(p));
|
|
604
|
+
if (!r.ok) {
|
|
605
|
+
throw setupFailed(member, `could not restore tracked '${p}' after its beads set-up rewrote it (${summarizeRaw(r.error || r.output)})`,
|
|
606
|
+
`in that member's workFolder run 'git checkout -- ${p}', then rerun the sprint`, { step: 'protect', url });
|
|
607
|
+
}
|
|
608
|
+
}
|
|
609
|
+
for (const p of added) {
|
|
610
|
+
const entry = `${rootPrefix}${p}`;
|
|
611
|
+
const r = await run(shell.ensureGitExcluded(entry));
|
|
612
|
+
if (!r.ok) {
|
|
613
|
+
throw setupFailed(member, `could not keep its set-up's untracked '${p}' out of commits (${summarizeRaw(r.error || r.output)})`,
|
|
614
|
+
`add '${entry}' to that member's git info/exclude, then rerun the sprint`, { step: 'protect', url });
|
|
615
|
+
}
|
|
616
|
+
}
|
|
617
|
+
if (changed.length || added.length) {
|
|
618
|
+
log(`[beads-identity] member '${member}': kept the beads set-up out of commits (restored: ${changed.join(', ') || 'none'}; excluded: ${added.join(', ') || 'none'}).`);
|
|
619
|
+
}
|
|
620
|
+
};
|
|
621
|
+
|
|
622
|
+
let failure = null;
|
|
623
|
+
try {
|
|
624
|
+
await apply();
|
|
625
|
+
} catch (err) {
|
|
626
|
+
failure = err;
|
|
627
|
+
}
|
|
628
|
+
try {
|
|
629
|
+
await protect();
|
|
630
|
+
} catch (err) {
|
|
631
|
+
if (!failure) failure = err;
|
|
632
|
+
else log(`[beads-identity] member '${member}': ${err && err.message ? err.message : err}`);
|
|
633
|
+
}
|
|
634
|
+
if (failure) throw failure;
|
|
635
|
+
return issued;
|
|
166
636
|
}
|
|
167
637
|
|
|
168
638
|
function assertMatches(member, expected, actual, cmp) {
|
|
@@ -176,30 +646,42 @@ function assertMatches(member, expected, actual, cmp) {
|
|
|
176
646
|
}
|
|
177
647
|
|
|
178
648
|
/**
|
|
179
|
-
* The precondition itself. Probes the
|
|
649
|
+
* The precondition itself. Probes the backlog member, then every other
|
|
180
650
|
* distinct member. Throws BeadsIdentityError (reason MISMATCH) before
|
|
181
|
-
* returning when a field that resolved on both sides differs
|
|
182
|
-
*
|
|
651
|
+
* returning when a field that resolved on both sides differs, and (reason
|
|
652
|
+
* MISSING_TOOL) when a member cannot run bd at all; every other probe that
|
|
653
|
+
* could not resolve a field is a logged + published warning instead.
|
|
654
|
+
* A beads-reading member with no database (or no sync.remote while the
|
|
655
|
+
* expectation names one) is set up first and re-verified; failing that it
|
|
656
|
+
* throws BEADS_SETUP_FAILED.
|
|
183
657
|
*
|
|
184
658
|
* @param {{
|
|
185
659
|
* command: Function, log?: Function, publishState?: Function,
|
|
186
|
-
*
|
|
660
|
+
* backlogMember: string, members: string[],
|
|
187
661
|
* expected?: object|null, prober?: object, timeoutS?: number,
|
|
662
|
+
* setupMembers?: string[], ensureVcsAuth?: (member: string) => Promise<void>,
|
|
663
|
+
* memberShell?: (member: string) => Promise<object>,
|
|
664
|
+
* onAuthFailure?: Function, pullBeads?: Function,
|
|
665
|
+
* setupTimeoutS?: number,
|
|
188
666
|
* }} opts
|
|
667
|
+
* `setupMembers` names the beads-reading members the preflight may set
|
|
668
|
+
* up (omitted: every member); `ensureVcsAuth` refreshes a member's VCS
|
|
669
|
+
* credential before its set-up; `memberShell` resolves the member's
|
|
670
|
+
* OS/shell command primitives (see setupMemberBeads).
|
|
189
671
|
* @returns {Promise<{
|
|
190
|
-
* expected: object|null, expectedFrom: 'args'|'
|
|
191
|
-
* members: Record<string, object>, warnings: string[],
|
|
672
|
+
* expected: object|null, expectedFrom: 'args'|'backlog'|'none',
|
|
673
|
+
* members: Record<string, object>, warnings: string[], setUp: string[],
|
|
192
674
|
* }>}
|
|
193
675
|
* `members[name]` is that member's probed identity record plus
|
|
194
676
|
* `unresolved: string[]` (the compared fields it could not report). A
|
|
195
677
|
* member with no beads database at all has NO entry -- only a warning.
|
|
196
678
|
*/
|
|
197
|
-
export async function verifyBeadsIdentity({ command, log = () => {}, publishState,
|
|
198
|
-
if (typeof
|
|
199
|
-
throw new TypeError('verifyBeadsIdentity:
|
|
679
|
+
export async function verifyBeadsIdentity({ command, log = () => {}, publishState, backlogMember, members, expected = null, prober, timeoutS, setupMembers, memberShell, ensureVcsAuth, onAuthFailure, pullBeads, setupTimeoutS }) {
|
|
680
|
+
if (typeof backlogMember !== 'string' || !backlogMember) {
|
|
681
|
+
throw new TypeError('verifyBeadsIdentity: backlogMember must be a non-empty string');
|
|
200
682
|
}
|
|
201
683
|
const p = prober || createBeadsIdentityProber({ command, timeoutS });
|
|
202
|
-
const ordered = [
|
|
684
|
+
const ordered = [backlogMember, ...(Array.isArray(members) ? members : [])]
|
|
203
685
|
.filter((m, i, arr) => typeof m === 'string' && m && arr.indexOf(m) === i);
|
|
204
686
|
|
|
205
687
|
const warnings = [];
|
|
@@ -207,20 +689,23 @@ export async function verifyBeadsIdentity({ command, log = () => {}, publishStat
|
|
|
207
689
|
warnings.push(text);
|
|
208
690
|
log(`${BEADS_IDENTITY_WARNING_PREFIX}${text}`);
|
|
209
691
|
};
|
|
210
|
-
const result = { expected: null, expectedFrom: 'args', members: {}, warnings };
|
|
692
|
+
const result = { expected: null, expectedFrom: 'args', members: {}, warnings, setUp: [] };
|
|
693
|
+
// Members whose beads the preflight may set up; omitted = every member.
|
|
694
|
+
const setupSet = setupMembers == null ? null : new Set(setupMembers);
|
|
211
695
|
|
|
212
|
-
|
|
213
|
-
|
|
696
|
+
let backlogProbe = await p.probe(backlogMember);
|
|
697
|
+
assertBdPresent(backlogMember, backlogProbe);
|
|
698
|
+
const backlogHasDb = !!backlogProbe.identity.beadsDir;
|
|
214
699
|
|
|
215
700
|
let expectedIdentity = expected;
|
|
216
701
|
if (!expectedIdentity) {
|
|
217
|
-
if (
|
|
218
|
-
result.expectedFrom = '
|
|
219
|
-
expectedIdentity = { ...
|
|
220
|
-
log(`[beads-identity] no expected beads identity was supplied; taking the expectation from the
|
|
702
|
+
if (backlogHasDb) {
|
|
703
|
+
result.expectedFrom = 'backlog';
|
|
704
|
+
expectedIdentity = { ...backlogProbe.identity };
|
|
705
|
+
log(`[beads-identity] no expected beads identity was supplied; taking the expectation from the backlog member '${backlogMember}'.`);
|
|
221
706
|
} else {
|
|
222
707
|
result.expectedFrom = 'none';
|
|
223
|
-
warn(noExpectationWarning(
|
|
708
|
+
warn(noExpectationWarning(backlogMember, backlogProbe));
|
|
224
709
|
}
|
|
225
710
|
}
|
|
226
711
|
result.expected = expectedIdentity;
|
|
@@ -232,7 +717,7 @@ export async function verifyBeadsIdentity({ command, log = () => {}, publishStat
|
|
|
232
717
|
for (const field of COMPARED_FIELDS) {
|
|
233
718
|
if (!String(expectedIdentity[field] ?? '').trim()) {
|
|
234
719
|
expectedUnresolved.add(field);
|
|
235
|
-
warn(unresolvedExpectedWarning(field, result.expectedFrom,
|
|
720
|
+
warn(unresolvedExpectedWarning(field, result.expectedFrom, backlogMember));
|
|
236
721
|
}
|
|
237
722
|
}
|
|
238
723
|
}
|
|
@@ -262,11 +747,68 @@ export async function verifyBeadsIdentity({ command, log = () => {}, publishStat
|
|
|
262
747
|
log(formatBeadsIdentity(probed.identity, { label: `beads ok: ${member}` }));
|
|
263
748
|
}
|
|
264
749
|
|
|
265
|
-
|
|
750
|
+
// Sets up a beads-reading member that has no database, or a database
|
|
751
|
+
// with no sync.remote while the expectation names one (see
|
|
752
|
+
// setupMemberBeads), then re-probes it and returns the fresh probe. A
|
|
753
|
+
// member that needs nothing -- or is not a beads reader -- is returned
|
|
754
|
+
// untouched, with no command issued.
|
|
755
|
+
async function ensureSetUp(member, probed) {
|
|
756
|
+
if (setupSet && !setupSet.has(member)) return probed;
|
|
757
|
+
const url = String((expectedIdentity && expectedIdentity.syncRemote) || '').trim();
|
|
758
|
+
const hasDb = hasBeadsDatabase(probed.identity);
|
|
759
|
+
if (hasDb && (String(probed.identity.syncRemote || '').trim() || !url)) return probed;
|
|
760
|
+
// A member that already resolves to a DIFFERENT project (prefix,
|
|
761
|
+
// sync.remote or origin that resolved and differs) is a MISMATCH,
|
|
762
|
+
// exactly as before: nothing is written to it.
|
|
763
|
+
if (expectedIdentity) {
|
|
764
|
+
assertMatches(member, expectedIdentity, probed.identity, compareIdentity(expectedIdentity, probed.identity, { skipUnresolved: true }));
|
|
765
|
+
}
|
|
766
|
+
if (!url) {
|
|
767
|
+
const state = probed.identity.beadsDir
|
|
768
|
+
? `has a beads workspace but no beads database (${probed.identity.beadsDir})`
|
|
769
|
+
: `reports no beads database in its workFolder ('${BEADS_IDENTITY_PROBES.where}' -> ${probeDetail(probed, 'where')})`;
|
|
770
|
+
throw setupFailed(member,
|
|
771
|
+
`${state} and the sprint has no expected beads remote to set one up from`,
|
|
772
|
+
`launch via the supervisor so --expect-beads carries the beads sync remote (or set sync.remote on the backlog member), or ${setupFix('')}`,
|
|
773
|
+
{ step: 'no-remote' });
|
|
774
|
+
}
|
|
775
|
+
await setupMemberBeads({ command, member, url, hasDb, memberShell, ensureVcsAuth, onAuthFailure, pullBeads, log, timeoutS: setupTimeoutS });
|
|
776
|
+
p.forget(member);
|
|
777
|
+
const again = await p.probe(member);
|
|
778
|
+
assertBdPresent(member, again);
|
|
779
|
+
const reprobeText = [...Object.values(again.raw), ...again.failures.map((f) => f.error)].join('\n');
|
|
780
|
+
if (hasSchemaMigrationReport(reprobeText)) {
|
|
781
|
+
throw setupFailed(member, `had its beads set up from '${url}', but bd reports a schema migration against that remote (${summarizeRaw(reprobeText)})`,
|
|
782
|
+
SCHEMA_FIX, { step: 'verify', url, cause: 'schema-migration' });
|
|
783
|
+
}
|
|
784
|
+
if (!hasBeadsDatabase(again.identity)) {
|
|
785
|
+
throw setupFailed(member, `still reports no beads database after its set-up from '${url}' ('${BEADS_IDENTITY_PROBES.where}' -> ${probeDetail(again, 'where')})`,
|
|
786
|
+
setupFix(url), { step: 'verify', url });
|
|
787
|
+
}
|
|
788
|
+
if (normalizeRemoteUrl(again.identity.syncRemote) !== normalizeRemoteUrl(url)) {
|
|
789
|
+
throw setupFailed(member, `reports sync.remote '${again.identity.syncRemote || '(unset)'}' after its set-up, not the expected '${url}'`,
|
|
790
|
+
setupFix(url), { step: 'verify', url });
|
|
791
|
+
}
|
|
792
|
+
const wantPrefix = String(expectedIdentity.prefix || '').trim();
|
|
793
|
+
if (wantPrefix && !String(again.identity.prefix || '').trim()) {
|
|
794
|
+
throw setupFailed(member, `cannot report its beads prefix after its set-up from '${url}' ('${BEADS_IDENTITY_PROBES.where}' -> ${probeDetail(again, 'where')})`,
|
|
795
|
+
setupFix(url), { step: 'verify', url });
|
|
796
|
+
}
|
|
797
|
+
result.setUp.push(member);
|
|
798
|
+
log(`[beads-identity] member '${member}' beads set up from ${url}; re-verifying its identity.`);
|
|
799
|
+
return again;
|
|
800
|
+
}
|
|
801
|
+
|
|
802
|
+
// The backlog member is only set up against a SUPPLIED expectation: when
|
|
803
|
+
// the expectation is derived from it there is nothing to set it up from.
|
|
804
|
+
if (expected) backlogProbe = await ensureSetUp(backlogMember, backlogProbe);
|
|
805
|
+
settle(backlogMember, backlogProbe, !!expected);
|
|
266
806
|
|
|
267
807
|
for (const member of ordered) {
|
|
268
|
-
if (member ===
|
|
269
|
-
|
|
808
|
+
if (member === backlogMember) continue;
|
|
809
|
+
let probed = await p.probe(member);
|
|
810
|
+
assertBdPresent(member, probed);
|
|
811
|
+
if (expectedIdentity || !probed.identity.beadsDir) probed = await ensureSetUp(member, probed);
|
|
270
812
|
settle(member, probed, !!expectedIdentity);
|
|
271
813
|
}
|
|
272
814
|
|
|
@@ -276,6 +818,7 @@ export async function verifyBeadsIdentity({ command, log = () => {}, publishStat
|
|
|
276
818
|
expectedFrom: result.expectedFrom,
|
|
277
819
|
members: result.members,
|
|
278
820
|
warnings: [...warnings],
|
|
821
|
+
setUp: [...result.setUp],
|
|
279
822
|
});
|
|
280
823
|
}
|
|
281
824
|
return result;
|