@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
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Supervisor beads identity -- which .beads THIS supervisor process runs
|
|
3
|
+
// against, resolved once at startup and displayed everywhere it matters.
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// The supervisor runs `bd` itself in exactly three read-only places
|
|
7
|
+
// (backlog.mjs's full-tracker fetch, scope-overlap.mjs's two list calls),
|
|
8
|
+
// always in its own process cwd, so bd's walk-up discovery silently decides
|
|
9
|
+
// which database those reads hit. Every sprint child it spawns (spawner.mjs)
|
|
10
|
+
// inherits that cwd too. Nothing used to show which .beads that was, and a
|
|
11
|
+
// supervisor started from the wrong folder would happily serve an empty
|
|
12
|
+
// backlog or dispatch sprints against an unrelated tracker.
|
|
13
|
+
//
|
|
14
|
+
// This module is the supervisor half of the shared contract in
|
|
15
|
+
// ../../fleet-sprint/beads-identity.mjs (the pure parse/compare/format
|
|
16
|
+
// helpers both sides use):
|
|
17
|
+
// - discoverBeadsDir(): the same walk-up bd performs, done here so serve
|
|
18
|
+
// can WARN loudly at startup when no .beads is reachable (the server
|
|
19
|
+
// still starts, with the identity "unknown" -- see
|
|
20
|
+
// createBeadsIdentityState), and so the sprint children get the project
|
|
21
|
+
// root (not a subfolder) as cwd.
|
|
22
|
+
// - probeBeadsIdentity(): the three read-only probes (`bd where --json`,
|
|
23
|
+
// `bd config get sync.remote --json`, `git remote get-url origin`) run in
|
|
24
|
+
// that cwd and parsed into one { beadsDir, prefix, syncRemote,
|
|
25
|
+
// repoRemote } record. beadsDir comes from bd's OWN answer (bd is
|
|
26
|
+
// git-worktree aware and may resolve a worktree's .beads to the main
|
|
27
|
+
// checkout's database), which is why discovery alone is not the identity.
|
|
28
|
+
// - createBeadsIdentityState(): the resolved record, held for the health
|
|
29
|
+
// route / dashboard header / spawner (`--expect-beads`), re-probeable on
|
|
30
|
+
// demand (GET /api/health?refresh=1).
|
|
31
|
+
//
|
|
32
|
+
// Deliberately NOT here: setting BEADS_DIR, or any persisted config file.
|
|
33
|
+
// The operator's cwd (or an explicit `--beads-dir`) is the one input.
|
|
34
|
+
// =============================================================================
|
|
35
|
+
|
|
36
|
+
import fs from 'node:fs';
|
|
37
|
+
import path from 'node:path';
|
|
38
|
+
import { execFile as nodeExecFile } from 'node:child_process';
|
|
39
|
+
import { promisify } from 'node:util';
|
|
40
|
+
import { execBdAsync } from './lib/exec-bd.mjs';
|
|
41
|
+
import { parseBeadsIdentity } from '../../fleet-sprint/beads-identity.mjs';
|
|
42
|
+
|
|
43
|
+
const nodeExecFileAsync = promisify(nodeExecFile);
|
|
44
|
+
|
|
45
|
+
/** Directory name bd discovers by walking up from its cwd. */
|
|
46
|
+
export const BEADS_DIR_NAME = '.beads';
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Walks up from `cwd` (inclusive) to the filesystem root looking for the
|
|
50
|
+
* first directory that contains a `.beads` entry -- the same discovery bd
|
|
51
|
+
* performs. Returns `{ beadsDir, repoRoot }` (repoRoot = the directory that
|
|
52
|
+
* holds `.beads`) or `null` when no ancestor has one.
|
|
53
|
+
*
|
|
54
|
+
* `fs` is injectable so a test can drive an in-memory layout on any host
|
|
55
|
+
* without touching real disk; only `existsSync` (and optionally `statSync`)
|
|
56
|
+
* is used.
|
|
57
|
+
* @param {{ cwd?: string, fs?: { existsSync: (p: string) => boolean, statSync?: (p: string) => { isDirectory(): boolean } } }} [opts]
|
|
58
|
+
* @returns {{ beadsDir: string, repoRoot: string }|null}
|
|
59
|
+
*/
|
|
60
|
+
export function discoverBeadsDir(opts = {}) {
|
|
61
|
+
const fsImpl = opts.fs ?? fs;
|
|
62
|
+
let dir = path.resolve(opts.cwd ?? process.cwd());
|
|
63
|
+
for (;;) {
|
|
64
|
+
const candidate = path.join(dir, BEADS_DIR_NAME);
|
|
65
|
+
let found = false;
|
|
66
|
+
try {
|
|
67
|
+
found = fsImpl.existsSync(candidate)
|
|
68
|
+
&& (typeof fsImpl.statSync !== 'function' || fsImpl.statSync(candidate).isDirectory());
|
|
69
|
+
} catch {
|
|
70
|
+
found = false;
|
|
71
|
+
}
|
|
72
|
+
if (found) return { beadsDir: candidate, repoRoot: dir };
|
|
73
|
+
const parent = path.dirname(dir);
|
|
74
|
+
if (parent === dir) return null;
|
|
75
|
+
dir = parent;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Resolves an operator-supplied `--beads-dir` value to the directory the
|
|
81
|
+
* supervisor should chdir into before discovery: the value itself, or its
|
|
82
|
+
* parent when it names the `.beads` directory directly. Throws when the
|
|
83
|
+
* path does not exist or is not a directory. Pure apart from the injectable
|
|
84
|
+
* fs, so serve's arg handling is unit-testable.
|
|
85
|
+
* @param {string} value
|
|
86
|
+
* @param {{ fs?: { existsSync: (p: string) => boolean, statSync: (p: string) => { isDirectory(): boolean } } }} [opts]
|
|
87
|
+
* @returns {string} absolute directory path
|
|
88
|
+
*/
|
|
89
|
+
export function resolveBeadsDirArg(value, opts = {}) {
|
|
90
|
+
const fsImpl = opts.fs ?? fs;
|
|
91
|
+
if (typeof value !== 'string' || !value.trim()) {
|
|
92
|
+
throw new Error('--beads-dir requires a path');
|
|
93
|
+
}
|
|
94
|
+
const resolved = path.resolve(value.trim());
|
|
95
|
+
let isDir = false;
|
|
96
|
+
try {
|
|
97
|
+
isDir = fsImpl.existsSync(resolved) && fsImpl.statSync(resolved).isDirectory();
|
|
98
|
+
} catch {
|
|
99
|
+
isDir = false;
|
|
100
|
+
}
|
|
101
|
+
if (!isDir) {
|
|
102
|
+
throw new Error(`--beads-dir '${resolved}' does not exist or is not a directory`);
|
|
103
|
+
}
|
|
104
|
+
return path.basename(resolved) === BEADS_DIR_NAME ? path.dirname(resolved) : resolved;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
function textOf(v) {
|
|
108
|
+
if (v == null) return '';
|
|
109
|
+
if (Buffer.isBuffer(v)) return v.toString('utf-8');
|
|
110
|
+
return String(v);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* Runs the three identity probes in `cwd` and parses them into one record
|
|
115
|
+
* (see ../../fleet-sprint/beads-identity.mjs's parseBeadsIdentity()).
|
|
116
|
+
*
|
|
117
|
+
* - `bd where --json` failing (no reachable database, bd not installed)
|
|
118
|
+
* throws with a message that names the cwd -- there is no identity to
|
|
119
|
+
* report and the caller (serve) must not proceed.
|
|
120
|
+
* - an unset `sync.remote` is NOT an error (bd exits 0 with value ""):
|
|
121
|
+
* the field is simply ''. A failing `bd config get` is folded to '' too,
|
|
122
|
+
* since the where-probe above already proved the database is reachable.
|
|
123
|
+
* - `git remote get-url origin` failing (not a git repo, no origin) folds
|
|
124
|
+
* to '' for the same reason.
|
|
125
|
+
*
|
|
126
|
+
* `execBd`/`execGit` are injectable (same shapes as execBdAsync / the
|
|
127
|
+
* promisified execFile) so tests never need a real bd or git.
|
|
128
|
+
* @param {{
|
|
129
|
+
* cwd?: string,
|
|
130
|
+
* execBd?: (args: string[], options: object) => Promise<{ stdout: string|Buffer }>,
|
|
131
|
+
* execGit?: (file: string, args: string[], options: object) => Promise<{ stdout: string|Buffer }>,
|
|
132
|
+
* }} [opts]
|
|
133
|
+
* @returns {Promise<{ beadsDir: string, prefix: string, databasePath: string, syncRemote: string, repoRemote: string }>}
|
|
134
|
+
*/
|
|
135
|
+
export async function probeBeadsIdentity(opts = {}) {
|
|
136
|
+
const cwd = path.resolve(opts.cwd ?? process.cwd());
|
|
137
|
+
const execBd = opts.execBd ?? execBdAsync;
|
|
138
|
+
const execGit = opts.execGit ?? nodeExecFileAsync;
|
|
139
|
+
const execOpts = { cwd, encoding: 'utf-8', windowsHide: true };
|
|
140
|
+
|
|
141
|
+
let where;
|
|
142
|
+
try {
|
|
143
|
+
where = textOf((await execBd(['where', '--json'], execOpts)).stdout);
|
|
144
|
+
} catch (err) {
|
|
145
|
+
const detail = textOf(err && (err.stderr || err.stdout)).trim() || (err && err.message) || String(err);
|
|
146
|
+
throw new Error(`'bd where --json' failed in '${cwd}': ${detail}`);
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
let syncRemote = '';
|
|
150
|
+
try {
|
|
151
|
+
syncRemote = textOf((await execBd(['config', 'get', 'sync.remote', '--json'], execOpts)).stdout);
|
|
152
|
+
} catch {
|
|
153
|
+
syncRemote = '';
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
let repoRemote = '';
|
|
157
|
+
try {
|
|
158
|
+
repoRemote = textOf((await execGit('git', ['remote', 'get-url', 'origin'], execOpts)).stdout);
|
|
159
|
+
} catch {
|
|
160
|
+
repoRemote = '';
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
const identity = parseBeadsIdentity({ where, syncRemote, repoRemote });
|
|
164
|
+
if (!identity.beadsDir) {
|
|
165
|
+
throw new Error(`'bd where --json' in '${cwd}' returned no .beads path: ${where.trim() || '(empty output)'}`);
|
|
166
|
+
}
|
|
167
|
+
return identity;
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
// The operator-facing warning texts for an UNKNOWN identity. Each one says
|
|
171
|
+
// what was found and what to do; the same string goes to the startup log
|
|
172
|
+
// (`[supervisor] WARNING: ...`), GET /api/health (`beadsWarning`) and the
|
|
173
|
+
// dashboard header. Generic on purpose: no product paths.
|
|
174
|
+
const FIX_TAIL = 'then GET /api/health?refresh=1.';
|
|
175
|
+
|
|
176
|
+
/** No `.beads` reachable by walking up from `cwd`. */
|
|
177
|
+
export function formatNoBeadsWarning(cwd) {
|
|
178
|
+
return `no beads database found walking up from ${cwd}. ` +
|
|
179
|
+
"Backlog and scope-overlap checks are disabled and sprints will verify against the backlog member's beads instead. " +
|
|
180
|
+
`To fix: restart fleet-se from inside the project folder, or pass --beads-dir <project-or-.beads-path>, ${FIX_TAIL}`;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/** A `.beads` was found under `repoRoot` but the identity probe failed. */
|
|
184
|
+
export function formatProbeFailedWarning(repoRoot, error) {
|
|
185
|
+
const detail = error && error.message ? error.message : String(error);
|
|
186
|
+
return `could not resolve the beads identity under ${repoRoot}: ${detail}. ` +
|
|
187
|
+
"Backlog and scope-overlap checks may fail and sprints will verify against the backlog member's beads instead. " +
|
|
188
|
+
`To fix: run 'bd where' in ${repoRoot} to see the error, ensure bd is on PATH and the project is initialised (bd init / sync.remote set), ${FIX_TAIL}`;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* Holds the supervisor's resolved identity, or the warning explaining why
|
|
193
|
+
* it is unknown. `refresh()` re-runs the probes (GET /api/health?refresh=1)
|
|
194
|
+
* and REPLACES the held record only on success -- a transient probe failure
|
|
195
|
+
* leaves the last good identity in place and rethrows, so a reader never
|
|
196
|
+
* sees a half-updated record. When there is NO last good identity (startup
|
|
197
|
+
* found no .beads, or its probe failed) a successful refresh recovers it
|
|
198
|
+
* and clears the warning; a failed one refreshes the warning text so the
|
|
199
|
+
* health route and dashboard show the current reason.
|
|
200
|
+
* @param {{
|
|
201
|
+
* cwd?: string,
|
|
202
|
+
* probe?: (opts: { cwd: string }) => Promise<object>,
|
|
203
|
+
* initial?: object|null,
|
|
204
|
+
* warning?: string|null,
|
|
205
|
+
* }} [deps]
|
|
206
|
+
* @returns {{ get(): object|null, getWarning(): string|null, refresh(): Promise<object>, cwd: string }}
|
|
207
|
+
*/
|
|
208
|
+
export function createBeadsIdentityState(deps = {}) {
|
|
209
|
+
const cwd = path.resolve(deps.cwd ?? process.cwd());
|
|
210
|
+
const probe = deps.probe ?? probeBeadsIdentity;
|
|
211
|
+
let current = deps.initial ?? null;
|
|
212
|
+
let warning = current ? null : (deps.warning ?? null);
|
|
213
|
+
return {
|
|
214
|
+
cwd,
|
|
215
|
+
get() { return current; },
|
|
216
|
+
getWarning() { return current ? null : warning; },
|
|
217
|
+
async refresh() {
|
|
218
|
+
let next;
|
|
219
|
+
try {
|
|
220
|
+
next = await probe({ cwd });
|
|
221
|
+
} catch (err) {
|
|
222
|
+
if (!current) warning = formatProbeFailedWarning(cwd, err);
|
|
223
|
+
throw err;
|
|
224
|
+
}
|
|
225
|
+
current = next;
|
|
226
|
+
warning = null;
|
|
227
|
+
return next;
|
|
228
|
+
},
|
|
229
|
+
};
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
/**
|
|
233
|
+
* The four display fields the health route, ledger entry and dashboard all
|
|
234
|
+
* carry (never `databasePath` -- a host-local detail).
|
|
235
|
+
* @param {object|null} id
|
|
236
|
+
* @returns {{ dir: string, prefix: string, syncRemote: string, repoRemote: string }|null}
|
|
237
|
+
*/
|
|
238
|
+
export function toBeadsSummary(id) {
|
|
239
|
+
if (!id) return null;
|
|
240
|
+
return {
|
|
241
|
+
dir: id.beadsDir || '',
|
|
242
|
+
prefix: id.prefix || '',
|
|
243
|
+
syncRemote: id.syncRemote || '',
|
|
244
|
+
repoRemote: id.repoRemote || '',
|
|
245
|
+
};
|
|
246
|
+
}
|
|
@@ -0,0 +1,438 @@
|
|
|
1
|
+
// The supervisor's cached beads view.
|
|
2
|
+
//
|
|
3
|
+
// One in-memory copy of the RAW `bd list --all --limit 0 --json` rows for the
|
|
4
|
+
// supervisor's own .beads, kept current through the supervisor's backlog
|
|
5
|
+
// member (src/supervisor/backlog-member.mjs): every refresh first runs the
|
|
6
|
+
// engine's own D-pull (fleet-sprint/dolt-sync.mjs doltPullBefore()) on that
|
|
7
|
+
// member, whose remote-tip fingerprint turns an unchanged shared remote into a
|
|
8
|
+
// single `git ls-remote` -- no `bd dolt pull`, and no re-list either.
|
|
9
|
+
//
|
|
10
|
+
// Design decisions (already made upstream -- see the planning notes):
|
|
11
|
+
//
|
|
12
|
+
// * RAW rows only. Never a derived or claim-subtracted tree: claimed scope
|
|
13
|
+
// depends on the live ledger and watchdog classification at READ time.
|
|
14
|
+
// * One bulk list (bdListAllBeadsWithClosed, i.e. `bd list --all --limit 0
|
|
15
|
+
// --json`), never per-root subtree fetches.
|
|
16
|
+
// * The list runs IN-PROCESS with cwd = repoRoot, the same folder the
|
|
17
|
+
// backlog member's work folder is, so the pull and the list provably touch
|
|
18
|
+
// the same clone. A null/degraded backlog member records lastError with
|
|
19
|
+
// the reason and lists nothing (no silent list from an unpulled clone).
|
|
20
|
+
// * maxTransientRetries: 0 on the pull. runDoltStep() otherwise retries a
|
|
21
|
+
// lock/transient failure with backoff for minutes, and one busy lock would
|
|
22
|
+
// stall the single in-flight slot. A lock/busy round is SKIPPED instead
|
|
23
|
+
// (rows kept, lastSkip set, lastError untouched); the next refresh retries
|
|
24
|
+
// and the pull is idempotent.
|
|
25
|
+
// * No `settle`: the supervisor never runs conflict settlement.
|
|
26
|
+
// * ledger.setScopeFreshness() on EVERY successful check (a pull+re-list AND
|
|
27
|
+
// a confirmed unchanged tip) -- lastSyncedAt means "this clone is known
|
|
28
|
+
// current as of that moment". Never on a skip or failure.
|
|
29
|
+
// * Single in-flight: concurrent refresh() callers join one promise.
|
|
30
|
+
// * snapshot() never spawns or waits. refreshIfStale() starts a background
|
|
31
|
+
// refresh and returns immediately. freshForLaunch() is the only reader that
|
|
32
|
+
// waits, and it never returns rows it did not fetch in that very call.
|
|
33
|
+
//
|
|
34
|
+
// The supervisor performs no bead mutations of its own (only reads), so there
|
|
35
|
+
// is no invalidate-on-mutation seam here.
|
|
36
|
+
|
|
37
|
+
import { doltPullBefore as defaultDoltPullBefore, classifyDoltFailure } from '../../fleet-sprint/dolt-sync.mjs';
|
|
38
|
+
import { bdListAllBeadsWithClosed } from './scope-overlap.mjs';
|
|
39
|
+
|
|
40
|
+
/** refreshIfStale()'s default staleness bound. */
|
|
41
|
+
export const DEFAULT_BEADS_VIEW_MAX_AGE_MS = 15_000;
|
|
42
|
+
|
|
43
|
+
/** Per-step bound handed to doltPullBefore (forwarded to every member
|
|
44
|
+
* command as timeout_s): short, because a refresh holds the only slot. */
|
|
45
|
+
export const DEFAULT_BEADS_VIEW_PULL_TIMEOUT_S = 30;
|
|
46
|
+
|
|
47
|
+
/** freshForLaunch()'s default wall-clock bound (join + own check). */
|
|
48
|
+
export const DEFAULT_FRESH_FOR_LAUNCH_TIMEOUT_MS = 45_000;
|
|
49
|
+
|
|
50
|
+
/** A lock/busy failure named in error text the dolt classifier left 'unknown'. */
|
|
51
|
+
const LOCK_OR_BUSY_RE = /\block(?:ed|s)?\b|\bbusy\b/i;
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* Typed rejection of freshForLaunch(): the launch path answers 503 with
|
|
55
|
+
* `reason`.
|
|
56
|
+
*/
|
|
57
|
+
export class BeadsViewUnavailableError extends Error {
|
|
58
|
+
/**
|
|
59
|
+
* @param {string} reason - human-readable cause
|
|
60
|
+
* @param {{ kind?: 'timeout'|'skip'|'error'|'stopped' }} [opts]
|
|
61
|
+
*/
|
|
62
|
+
constructor(reason, opts = {}) {
|
|
63
|
+
super(`beads view unavailable: ${reason}`);
|
|
64
|
+
this.name = 'BeadsViewUnavailableError';
|
|
65
|
+
this.code = 'BEADS_VIEW_UNAVAILABLE';
|
|
66
|
+
this.reason = reason;
|
|
67
|
+
this.kind = opts.kind ?? 'error';
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Normalize an executeFleetCommand() result into the `{ ok, output }` /
|
|
73
|
+
* `{ ok: false, error }` shape doltPullBefore's command() contract expects.
|
|
74
|
+
*
|
|
75
|
+
* The fleet server's execute_command does not flag a non-zero exit as an
|
|
76
|
+
* error, so `ok` is derived from the real exit code: structured `exitCode`
|
|
77
|
+
* (with clean stdout) when the server sent it, else the `Exit code: N` prefix
|
|
78
|
+
* of the display text. Without this a failed `bd dolt pull` would read as a
|
|
79
|
+
* success, and `bd config get sync.remote --json` would never parse (the
|
|
80
|
+
* prefix is not JSON), silently disabling the remote-tip fingerprint.
|
|
81
|
+
*
|
|
82
|
+
* @param {any} res
|
|
83
|
+
* @returns {{ ok: true, output: string } | { ok: false, error: string }}
|
|
84
|
+
*/
|
|
85
|
+
export function normalizeFleetCommandResult(res) {
|
|
86
|
+
if (!res || typeof res !== 'object') return { ok: false, error: 'no result from execute_command' };
|
|
87
|
+
if (res.ok === false) return { ok: false, error: String(res.error ?? 'unknown error') };
|
|
88
|
+
if (typeof res.exitCode === 'number') {
|
|
89
|
+
const stdout = typeof res.stdout === 'string' ? res.stdout : '';
|
|
90
|
+
const stderr = typeof res.stderr === 'string' ? res.stderr : '';
|
|
91
|
+
if (res.exitCode !== 0) {
|
|
92
|
+
const body = [stderr, stdout].filter((s) => s && s.trim()).join('\n').trim();
|
|
93
|
+
return { ok: false, error: `Exit code ${res.exitCode}: ${body || '(no output)'}` };
|
|
94
|
+
}
|
|
95
|
+
return { ok: true, output: stdout };
|
|
96
|
+
}
|
|
97
|
+
const text = String(res.output ?? '');
|
|
98
|
+
const m = /^Exit code:\s*(-?\d+)\r?\n?/.exec(text);
|
|
99
|
+
if (m) {
|
|
100
|
+
const code = Number(m[1]);
|
|
101
|
+
const body = text.slice(m[0].length);
|
|
102
|
+
if (code !== 0) return { ok: false, error: `Exit code ${code}: ${body.trim() || '(no output)'}` };
|
|
103
|
+
return { ok: true, output: body };
|
|
104
|
+
}
|
|
105
|
+
// No recoverable exit code means the command never ran: every such
|
|
106
|
+
// execute_command reply is the tool's own refusal/failure text (`Member
|
|
107
|
+
// "<x>" not found.`, a credential refusal, `Failed to execute command on
|
|
108
|
+
// "<member>": ...`). Fail CLOSED -- reading it as success would let an
|
|
109
|
+
// unpulled clone be listed and reported fresh.
|
|
110
|
+
return { ok: false, error: text.trim() || 'execute_command returned no exit code and no output' };
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* Build the command() doltPullBefore expects -- `command(cmd, { member_name,
|
|
115
|
+
* silent, failSoft, label, timeout_s })` -> `{ ok, output }` / `{ ok: false,
|
|
116
|
+
* error }` -- over executeFleetCommand (fleet-members.mjs). `timeout_s` MUST
|
|
117
|
+
* be forwarded: executeFleetCommand's own default is 60s, which would cut off
|
|
118
|
+
* every real pull at 60s regardless of the step bound.
|
|
119
|
+
*
|
|
120
|
+
* @param {{ executeFleetCommand: Function, resolveConnection: Function, logger?: object }} deps
|
|
121
|
+
* @returns {(cmd: string, opts?: object) => Promise<{ ok: boolean, output?: string, error?: string }>}
|
|
122
|
+
*/
|
|
123
|
+
export function createBeadsViewCommand(deps = {}) {
|
|
124
|
+
const { executeFleetCommand, resolveConnection, logger } = deps;
|
|
125
|
+
if (typeof executeFleetCommand !== 'function') throw new TypeError('createBeadsViewCommand requires an executeFleetCommand() collaborator');
|
|
126
|
+
if (typeof resolveConnection !== 'function') throw new TypeError('createBeadsViewCommand requires a resolveConnection() collaborator');
|
|
127
|
+
return async function beadsViewCommand(cmd, opts = {}) {
|
|
128
|
+
const req = { member: opts.member_name, command: cmd, resolveConnection };
|
|
129
|
+
if (opts.timeout_s !== undefined && opts.timeout_s !== null) req.timeoutSeconds = opts.timeout_s;
|
|
130
|
+
if (logger) req.logger = logger;
|
|
131
|
+
let res;
|
|
132
|
+
try {
|
|
133
|
+
res = await executeFleetCommand(req);
|
|
134
|
+
} catch (err) {
|
|
135
|
+
return { ok: false, error: err && err.message ? err.message : String(err) };
|
|
136
|
+
}
|
|
137
|
+
return normalizeFleetCommandResult(res);
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
function errorText(err) {
|
|
142
|
+
if (!err) return 'unknown error';
|
|
143
|
+
const parts = [];
|
|
144
|
+
if (typeof err.doltOutput === 'string' && err.doltOutput) parts.push(err.doltOutput);
|
|
145
|
+
if (typeof err.stderr === 'string' && err.stderr) parts.push(err.stderr);
|
|
146
|
+
parts.push(err.message ? err.message : String(err));
|
|
147
|
+
return parts.join('\n');
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/**
|
|
151
|
+
* Is `err` a lock/busy/transient failure (skip the round) rather than a real
|
|
152
|
+
* failure (record lastError)? The dolt classifier decides first; only when it
|
|
153
|
+
* cannot place the text at all does a lock/busy mention count.
|
|
154
|
+
*/
|
|
155
|
+
export function isBusyFailure(err) {
|
|
156
|
+
const text = errorText(err);
|
|
157
|
+
const kind = classifyDoltFailure(text);
|
|
158
|
+
if (kind === 'transient') return true;
|
|
159
|
+
return kind === 'unknown' && LOCK_OR_BUSY_RE.test(text);
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* Create the cached beads view.
|
|
164
|
+
*
|
|
165
|
+
* @param {{
|
|
166
|
+
* backlogMember: { get: () => { member: { name: string }|null, status: string, reason?: string|null } },
|
|
167
|
+
* ledger?: { setScopeFreshness: (timestamp?: string) => Promise<unknown> } | null,
|
|
168
|
+
* command: Function,
|
|
169
|
+
* repoRoot?: string|null,
|
|
170
|
+
* listAllBeads?: (opts: { cwd?: string }) => Promise<object[]>,
|
|
171
|
+
* doltPullBefore?: Function,
|
|
172
|
+
* now?: () => number,
|
|
173
|
+
* logger?: { log?: Function, warn?: Function, error?: Function },
|
|
174
|
+
* pullTimeoutS?: number,
|
|
175
|
+
* setTimeout?: Function,
|
|
176
|
+
* clearTimeout?: Function,
|
|
177
|
+
* }} deps
|
|
178
|
+
*/
|
|
179
|
+
export function createBeadsView(deps = {}) {
|
|
180
|
+
const { backlogMember, command } = deps;
|
|
181
|
+
if (!backlogMember || typeof backlogMember.get !== 'function') {
|
|
182
|
+
throw new TypeError('createBeadsView requires a backlogMember handle with get()');
|
|
183
|
+
}
|
|
184
|
+
if (typeof command !== 'function') throw new TypeError('createBeadsView requires a command() collaborator');
|
|
185
|
+
const ledger = deps.ledger ?? null;
|
|
186
|
+
const repoRoot = deps.repoRoot ?? null;
|
|
187
|
+
const listAllBeads = deps.listAllBeads ?? bdListAllBeadsWithClosed;
|
|
188
|
+
const pull = deps.doltPullBefore ?? defaultDoltPullBefore;
|
|
189
|
+
const now = deps.now ?? Date.now;
|
|
190
|
+
const logger = deps.logger ?? console;
|
|
191
|
+
const log = (...a) => (logger.log ?? (() => {}))(...a);
|
|
192
|
+
const warn = (...a) => (logger.warn ?? logger.log ?? (() => {}))(...a);
|
|
193
|
+
const logError = (...a) => (logger.error ?? logger.log ?? (() => {}))(...a);
|
|
194
|
+
const pullTimeoutS = Number.isFinite(deps.pullTimeoutS) && deps.pullTimeoutS > 0 ? deps.pullTimeoutS : DEFAULT_BEADS_VIEW_PULL_TIMEOUT_S;
|
|
195
|
+
const setTimer = deps.setTimeout ?? setTimeout;
|
|
196
|
+
const clearTimer = deps.clearTimeout ?? clearTimeout;
|
|
197
|
+
|
|
198
|
+
let rows = null;
|
|
199
|
+
let asOf = null;
|
|
200
|
+
let lastCheckedAt = null;
|
|
201
|
+
let lastError = null;
|
|
202
|
+
let lastSkip = null;
|
|
203
|
+
let inFlight = null;
|
|
204
|
+
let stopped = false;
|
|
205
|
+
// True from the start of a pull until a check completes with current rows
|
|
206
|
+
// (see runCheck): a skipped/failed list after a successful pull must be
|
|
207
|
+
// retried even though the recorded remote tip no longer moves.
|
|
208
|
+
let listPending = false;
|
|
209
|
+
|
|
210
|
+
function snapshot() {
|
|
211
|
+
return { rows, asOf, lastCheckedAt, lastError, lastSkip, refreshing: inFlight !== null };
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
function recordSkip(reason) {
|
|
215
|
+
const at = now();
|
|
216
|
+
lastCheckedAt = at;
|
|
217
|
+
lastSkip = { reason, at };
|
|
218
|
+
warn(`[beads-view] refresh skipped (will retry on the next refresh): ${reason}`);
|
|
219
|
+
return { kind: 'skip', reason };
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
function recordError(reason) {
|
|
223
|
+
const at = now();
|
|
224
|
+
lastCheckedAt = at;
|
|
225
|
+
lastError = { message: reason, at };
|
|
226
|
+
logError(`[beads-view] ERROR: refresh failed; keeping the previously cached rows: ${reason}`);
|
|
227
|
+
return { kind: 'error', reason };
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
/**
|
|
231
|
+
* One check. `forceList` re-lists rows even when the remote tip is
|
|
232
|
+
* unchanged (freshForLaunch). Never throws.
|
|
233
|
+
*/
|
|
234
|
+
async function runCheck({ forceList }) {
|
|
235
|
+
const st = backlogMember.get() || {};
|
|
236
|
+
const memberName = st.member && typeof st.member.name === 'string' ? st.member.name : null;
|
|
237
|
+
if (st.status !== 'ready' || !memberName) {
|
|
238
|
+
return recordError(`backlog member not ready (${st.reason || st.status || 'no backlog member'}); the beads clone cannot be pulled`);
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
// doltPullBefore records the new remote tip as soon as the pull
|
|
242
|
+
// succeeds -- BEFORE the list below runs. If that list then skips or
|
|
243
|
+
// fails, the next check would see an "unchanged" tip and keep serving
|
|
244
|
+
// the pre-pull rows as fresh. So a list is owed from here until one
|
|
245
|
+
// succeeds (or a confirmed-current check clears it below).
|
|
246
|
+
const listOwed = listPending;
|
|
247
|
+
listPending = true;
|
|
248
|
+
|
|
249
|
+
let pullRes;
|
|
250
|
+
try {
|
|
251
|
+
pullRes = await pull(memberName, { command, log, maxTransientRetries: 0, timeoutS: pullTimeoutS });
|
|
252
|
+
} catch (err) {
|
|
253
|
+
if (isBusyFailure(err)) return recordSkip(`D-pull on backlog member '${memberName}' hit a lock/busy/transient failure: ${err && err.message ? err.message : err}`);
|
|
254
|
+
return recordError(`D-pull on backlog member '${memberName}' failed: ${err && err.message ? err.message : err}`);
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
const tipUnchanged = !!(pullRes && pullRes.skipped && pullRes.reason === 'remote-unchanged');
|
|
258
|
+
const needList = forceList || rows === null || !tipUnchanged || listOwed;
|
|
259
|
+
let listed = null;
|
|
260
|
+
if (needList) {
|
|
261
|
+
try {
|
|
262
|
+
listed = await listAllBeads(repoRoot ? { cwd: repoRoot } : {});
|
|
263
|
+
} catch (err) {
|
|
264
|
+
if (isBusyFailure(err)) return recordSkip(`bd list hit a lock/busy failure: ${err && err.message ? err.message : err}`);
|
|
265
|
+
return recordError(`bd list --all failed: ${err && err.message ? err.message : err}`);
|
|
266
|
+
}
|
|
267
|
+
if (!Array.isArray(listed)) return recordError('bd list --all returned a non-array result');
|
|
268
|
+
rows = listed;
|
|
269
|
+
}
|
|
270
|
+
listPending = false;
|
|
271
|
+
|
|
272
|
+
const at = now();
|
|
273
|
+
asOf = at;
|
|
274
|
+
lastCheckedAt = at;
|
|
275
|
+
lastError = null;
|
|
276
|
+
lastSkip = null;
|
|
277
|
+
if (ledger && typeof ledger.setScopeFreshness === 'function') {
|
|
278
|
+
try {
|
|
279
|
+
await ledger.setScopeFreshness(new Date(at).toISOString());
|
|
280
|
+
} catch (err) {
|
|
281
|
+
logError(`[beads-view] ERROR: could not record scope freshness in the ledger: ${err && err.message ? err.message : err}`);
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
return { kind: 'ok', rows: listed, listed: listed !== null, tipUnchanged };
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
/** Occupy the single in-flight slot with `fn`; the slot frees when it settles. */
|
|
288
|
+
function occupy(fn) {
|
|
289
|
+
const p = (async () => {
|
|
290
|
+
try {
|
|
291
|
+
return await fn();
|
|
292
|
+
} catch (err) {
|
|
293
|
+
// runCheck never throws; this is a last-resort guard so the
|
|
294
|
+
// slot can never hold a rejected promise that callers see.
|
|
295
|
+
return recordError(`unexpected beads view failure: ${err && err.message ? err.message : err}`);
|
|
296
|
+
} finally {
|
|
297
|
+
if (inFlight === p) inFlight = null;
|
|
298
|
+
}
|
|
299
|
+
})();
|
|
300
|
+
inFlight = p;
|
|
301
|
+
return p;
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
/** Refresh now (or join the refresh in flight). Resolves the snapshot; never rejects. */
|
|
305
|
+
async function refresh() {
|
|
306
|
+
if (!inFlight && !stopped) occupy(() => runCheck({ forceList: false }));
|
|
307
|
+
if (inFlight) await inFlight;
|
|
308
|
+
return snapshot();
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
/**
|
|
312
|
+
* Start a background refresh when the last check is older than
|
|
313
|
+
* `maxAgeMs` (or never happened) and nothing is in flight. Returns
|
|
314
|
+
* immediately: true when a refresh was started. Never rejects.
|
|
315
|
+
*/
|
|
316
|
+
function refreshIfStale(maxAgeMs = DEFAULT_BEADS_VIEW_MAX_AGE_MS) {
|
|
317
|
+
if (stopped || inFlight) return false;
|
|
318
|
+
if (lastCheckedAt !== null && now() - lastCheckedAt < maxAgeMs) return false;
|
|
319
|
+
occupy(() => runCheck({ forceList: false })).catch(() => {});
|
|
320
|
+
return true;
|
|
321
|
+
}
|
|
322
|
+
|
|
323
|
+
/**
|
|
324
|
+
* Rows fetched by THIS call, for the launch overlap guard. Joins any
|
|
325
|
+
* in-flight refresh first (never a second concurrent one), then runs its
|
|
326
|
+
* own check, which always re-lists. Rejects with BeadsViewUnavailableError
|
|
327
|
+
* on timeout, skip, failure, or a not-ready backlog member.
|
|
328
|
+
*
|
|
329
|
+
* @param {{ timeoutMs?: number }} [opts]
|
|
330
|
+
* @returns {Promise<object[]>}
|
|
331
|
+
*/
|
|
332
|
+
function freshForLaunch(opts = {}) {
|
|
333
|
+
const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : DEFAULT_FRESH_FOR_LAUNCH_TIMEOUT_MS;
|
|
334
|
+
if (stopped) return Promise.reject(new BeadsViewUnavailableError('the supervisor is shutting down', { kind: 'stopped' }));
|
|
335
|
+
let abandoned = false;
|
|
336
|
+
const work = (async () => {
|
|
337
|
+
// Join whatever is in flight; loop because another caller may
|
|
338
|
+
// have taken the slot again by the time we resume.
|
|
339
|
+
while (inFlight) await inFlight;
|
|
340
|
+
if (abandoned) return null;
|
|
341
|
+
if (stopped) throw new BeadsViewUnavailableError('the supervisor is shutting down', { kind: 'stopped' });
|
|
342
|
+
const outcome = await occupy(() => runCheck({ forceList: true }));
|
|
343
|
+
if (outcome.kind === 'ok' && Array.isArray(outcome.rows)) return outcome.rows;
|
|
344
|
+
if (outcome.kind === 'skip') throw new BeadsViewUnavailableError(outcome.reason, { kind: 'skip' });
|
|
345
|
+
throw new BeadsViewUnavailableError(outcome.reason || 'fresh beads check failed', { kind: 'error' });
|
|
346
|
+
})();
|
|
347
|
+
let timer = null;
|
|
348
|
+
const timeout = new Promise((_, reject) => {
|
|
349
|
+
timer = setTimer(() => {
|
|
350
|
+
abandoned = true;
|
|
351
|
+
reject(new BeadsViewUnavailableError(`fresh beads check did not finish within ${timeoutMs}ms`, { kind: 'timeout' }));
|
|
352
|
+
}, timeoutMs);
|
|
353
|
+
if (timer && typeof timer.unref === 'function') timer.unref();
|
|
354
|
+
});
|
|
355
|
+
// If the timeout wins, the work keeps holding the slot until it
|
|
356
|
+
// settles (so no second pull starts); its own outcome is discarded.
|
|
357
|
+
work.catch(() => {});
|
|
358
|
+
return Promise.race([work, timeout]).finally(() => clearTimer(timer));
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
function stop() {
|
|
362
|
+
stopped = true;
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
return { snapshot, refresh, refreshIfStale, freshForLaunch, stop };
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
/** Launch-path busy-skip retries (a sprint child briefly holding the clone lock). */
|
|
369
|
+
export const DEFAULT_LAUNCH_BUSY_RETRIES = 3;
|
|
370
|
+
/** Pause between launch-path busy-skip retries. */
|
|
371
|
+
export const DEFAULT_LAUNCH_BUSY_RETRY_DELAY_MS = 500;
|
|
372
|
+
|
|
373
|
+
/**
|
|
374
|
+
* The launch overlap guard's `listAllBeads`: rows fetched by a forced fresh
|
|
375
|
+
* check made in THIS call (view.freshForLaunch()), never cached rows. A busy
|
|
376
|
+
* /lock skip is retried a small bounded number of times inside ONE wall-clock
|
|
377
|
+
* bound (`timeoutMs`); a timeout or any non-transient failure rejects
|
|
378
|
+
* immediately with BeadsViewUnavailableError (the launch path answers 503).
|
|
379
|
+
*
|
|
380
|
+
* @param {{ freshForLaunch: Function }} view
|
|
381
|
+
* @param {{ timeoutMs?: number, busyRetries?: number, retryDelayMs?: number,
|
|
382
|
+
* now?: () => number, sleep?: (ms: number) => Promise<void> }} [opts]
|
|
383
|
+
* @returns {() => Promise<object[]>}
|
|
384
|
+
*/
|
|
385
|
+
export function createLaunchRowsFetcher(view, opts = {}) {
|
|
386
|
+
if (!view || typeof view.freshForLaunch !== 'function') throw new TypeError('createLaunchRowsFetcher requires a view with freshForLaunch()');
|
|
387
|
+
const timeoutMs = Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0 ? opts.timeoutMs : DEFAULT_FRESH_FOR_LAUNCH_TIMEOUT_MS;
|
|
388
|
+
const busyRetries = Number.isInteger(opts.busyRetries) && opts.busyRetries >= 0 ? opts.busyRetries : DEFAULT_LAUNCH_BUSY_RETRIES;
|
|
389
|
+
const retryDelayMs = Number.isFinite(opts.retryDelayMs) && opts.retryDelayMs >= 0 ? opts.retryDelayMs : DEFAULT_LAUNCH_BUSY_RETRY_DELAY_MS;
|
|
390
|
+
const now = opts.now ?? Date.now;
|
|
391
|
+
const sleep = opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
|
|
392
|
+
return async function listAllBeadsFresh() {
|
|
393
|
+
const deadline = now() + timeoutMs;
|
|
394
|
+
let retriesLeft = busyRetries;
|
|
395
|
+
for (;;) {
|
|
396
|
+
const remaining = deadline - now();
|
|
397
|
+
if (remaining <= 0) {
|
|
398
|
+
throw new BeadsViewUnavailableError(`fresh beads check did not finish within ${timeoutMs}ms`, { kind: 'timeout' });
|
|
399
|
+
}
|
|
400
|
+
try {
|
|
401
|
+
return await view.freshForLaunch({ timeoutMs: remaining });
|
|
402
|
+
} catch (err) {
|
|
403
|
+
const transient = err instanceof BeadsViewUnavailableError && err.kind === 'skip';
|
|
404
|
+
if (!transient || retriesLeft <= 0) throw err;
|
|
405
|
+
retriesLeft -= 1;
|
|
406
|
+
if (retryDelayMs > 0) await sleep(Math.min(retryDelayMs, Math.max(0, deadline - now())));
|
|
407
|
+
}
|
|
408
|
+
}
|
|
409
|
+
};
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
/**
|
|
413
|
+
* A rows reader over the view's snapshot for the dashboard/backlog: never
|
|
414
|
+
* spawns or waits (kicks refreshIfStale(maxAgeMs) in the background first).
|
|
415
|
+
* With no rows yet (startup, first refresh failed) it throws -- callers take
|
|
416
|
+
* their existing degraded path -- unless `emptyWhenNoRows` is set, in which
|
|
417
|
+
* case it returns [] (the backlog panel: an empty table plus the dashboard's
|
|
418
|
+
* freshness notice, instead of a failed panel). `openOnly` drops closed beads, reproducing the default
|
|
419
|
+
* `bd list --json --limit 0` set (the view holds `--all` rows). Difference
|
|
420
|
+
* documented: `bd list`'s default also hides gate-type issues; this filter
|
|
421
|
+
* does not -- gates are an agent-synchronisation construct this tracker does
|
|
422
|
+
* not use.
|
|
423
|
+
*
|
|
424
|
+
* @param {{ snapshot: Function, refreshIfStale?: Function }} view
|
|
425
|
+
* @param {{ maxAgeMs?: number, openOnly?: boolean, emptyWhenNoRows?: boolean }} [opts]
|
|
426
|
+
* @returns {() => object[]}
|
|
427
|
+
*/
|
|
428
|
+
export function createSnapshotRowsReader(view, opts = {}) {
|
|
429
|
+
if (!view || typeof view.snapshot !== 'function') throw new TypeError('createSnapshotRowsReader requires a view with snapshot()');
|
|
430
|
+
const maxAgeMs = opts.maxAgeMs ?? DEFAULT_BEADS_VIEW_MAX_AGE_MS;
|
|
431
|
+
return function readCachedRows() {
|
|
432
|
+
if (typeof view.refreshIfStale === 'function') view.refreshIfStale(maxAgeMs);
|
|
433
|
+
const snap = view.snapshot();
|
|
434
|
+
if (!Array.isArray(snap.rows) && opts.emptyWhenNoRows) return [];
|
|
435
|
+
if (!Array.isArray(snap.rows)) throw new Error('beads view has no rows yet (startup or first refresh failed)');
|
|
436
|
+
return opts.openOnly ? snap.rows.filter((b) => !(b && b.status === 'closed')) : snap.rows;
|
|
437
|
+
};
|
|
438
|
+
}
|