@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,731 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// PAUSED AWAITING A DECISION, AND RESUMING ON THE ANSWER.
|
|
3
|
+
//
|
|
4
|
+
// decisions.mjs records a NEEDS-DECISION request and sets its bead aside.
|
|
5
|
+
// When the run then reaches the point where it used to throw
|
|
6
|
+
// StalledSprintError -- nothing is ready and every open in-scope bead is set
|
|
7
|
+
// aside or stuck behind a set-aside bead -- and at least one decision is
|
|
8
|
+
// still pending, runner.js calls awaitAnswer() below instead of throwing.
|
|
9
|
+
//
|
|
10
|
+
// UNFILED DECISION: a decision whose decision bead could not be filed (the
|
|
11
|
+
// best-effort `bd create` in decisions.mjs failed) has no answer path, so it
|
|
12
|
+
// never holds the run: a stall on it alone still throws StalledSprintError,
|
|
13
|
+
// whose set-aside reason names it with its full question and says the
|
|
14
|
+
// decision bead could not be filed. recordDecisionAnswer refuses it.
|
|
15
|
+
//
|
|
16
|
+
// MIXED CASE (decided): the run pauses while ANY decision is pending, even if
|
|
17
|
+
// some other remaining bead is set aside for a non-decision reason (a doer
|
|
18
|
+
// BLOCKED, a set-aside deploy): answering the decision may unblock work. Only
|
|
19
|
+
// a stall with NO pending decision still throws StalledSprintError, exactly as
|
|
20
|
+
// before.
|
|
21
|
+
//
|
|
22
|
+
// THE WAIT parks the run ONCE through the engine's EXISTING cooperative pause
|
|
23
|
+
// (the requestPause/requestResume pair the usage-limit controller drives),
|
|
24
|
+
// with the typed source 'needs_decision', and then stays parked -- members
|
|
25
|
+
// reserved and idle -- until an answer is available or the operator stops:
|
|
26
|
+
//
|
|
27
|
+
// requestPause(reason, { source: 'needs_decision' }) -- ONCE; state
|
|
28
|
+
// 'paused-awaiting-decision' (sprintState.decisionWait and the
|
|
29
|
+
// 'decisions' published state namespace)
|
|
30
|
+
// issue ONE read of the pending decision beads (`bd show`), which blocks
|
|
31
|
+
// at the engine's pause gate: it runs only once the run is released,
|
|
32
|
+
// and an operator stop rejects it
|
|
33
|
+
// every poll interval (a non-blocking timer; woken at once by
|
|
34
|
+
// recordDecisionAnswer) check ONLY the in-process answer queue -- no
|
|
35
|
+
// command, no log line, no resume
|
|
36
|
+
// every read poll interval, ONE pause-exempt `bd show --json` of the
|
|
37
|
+
// holding decision beads on the backlog member (command() with
|
|
38
|
+
// opts.pauseExempt: it skips the pause gate and is not an in-flight
|
|
39
|
+
// activity) -- no pull, no resync, no member release, no pause/resume
|
|
40
|
+
// an answer is queued, or the read reports a holding decision bead
|
|
41
|
+
// closed: requestResume(...) ONCE -- the engine's pre-resume hook runs
|
|
42
|
+
// as for any resume (the CLI skips its re-reserve/resync for this
|
|
43
|
+
// pause, because it never handed the reservations back) -- the blocked
|
|
44
|
+
// read runs, a queued answer is applied, and `bd comments` is read for
|
|
45
|
+
// every decision bead the read reports closed
|
|
46
|
+
//
|
|
47
|
+
// ANSWER SOURCES. (a) The in-process answer queue: recordDecisionAnswer /
|
|
48
|
+
// answerPendingDecision, which the run's own viewer action and the
|
|
49
|
+
// supervisor's POST /api/sprints/:id/decisions/:decisionId reach. It needs no
|
|
50
|
+
// member command, so the 60s poll checks only it. (b) An operator running
|
|
51
|
+
// `bd human respond` elsewhere: the read poll above sees the decision bead
|
|
52
|
+
// closed and resumes the run on its own, within one read poll interval -- no
|
|
53
|
+
// dashboard Resume needed. The read targets the backlog member (the
|
|
54
|
+
// supervisor-owned, unreservable member on the project beads folder), so it
|
|
55
|
+
// touches no reserved sprint member. An operator Resume still works as
|
|
56
|
+
// before: it runs the blocked read, pulls the beads clone and reads once more
|
|
57
|
+
// when nothing is answered yet. A release with no answer logs ONE line and,
|
|
58
|
+
// after one poll interval (an answer or a stop ends it early), parks the run
|
|
59
|
+
// again -- never a tight loop.
|
|
60
|
+
//
|
|
61
|
+
// A decision bead CLOSED by `bd human respond` is an answer; its last
|
|
62
|
+
// "Response: ..." comment is the answer text (a bead closed some other way,
|
|
63
|
+
// e.g. `bd human dismiss`, counts as answered with no text). For each answer
|
|
64
|
+
// the work bead's notes gain the chosen answer (appended), the set-aside
|
|
65
|
+
// entries recorded for that decision (the bead and its blocks dependents) are
|
|
66
|
+
// cleared, the decision moves from sprintState.pendingDecisions to
|
|
67
|
+
// sprintState.answeredDecisions, and the run continues: the released bead
|
|
68
|
+
// re-enters through the ordinary ready set.
|
|
69
|
+
//
|
|
70
|
+
// POLL INTERVALS: DECISION_POLL_INTERVAL_MS_DEFAULT (60s, the in-process
|
|
71
|
+
// queue check), overridable with the APRA_FLEET_DECISION_POLL_MS environment
|
|
72
|
+
// variable, and DECISION_READ_POLL_INTERVAL_MS_DEFAULT (5 minutes, the
|
|
73
|
+
// decision bead read), overridable with APRA_FLEET_DECISION_READ_POLL_MS (each
|
|
74
|
+
// a positive integer, in milliseconds). Never a tight loop. Logging is one
|
|
75
|
+
// line per state change (paused, an out-of-process answer seen, a failed
|
|
76
|
+
// resume or a failed read -- once per distinct error --, released without an
|
|
77
|
+
// answer, resumed), never one per poll.
|
|
78
|
+
//
|
|
79
|
+
// IDLE TIMEOUT: the ~30 minute DEFAULT_IDLE_TIMEOUT_MS is the fleet server's
|
|
80
|
+
// cloud idle manager, which STOPS an idle cloud member's VM; it never aborts a
|
|
81
|
+
// sprint. The engine itself has no pause timeout, and this wait has no total
|
|
82
|
+
// budget of its own: a decision may take hours. Nothing touches the sprint
|
|
83
|
+
// members while waiting (the read poll goes to the backlog member only), so a
|
|
84
|
+
// cloud member may be stopped as idle; the next dispatch to it restarts it
|
|
85
|
+
// transparently, as after a usage-limit pause.
|
|
86
|
+
//
|
|
87
|
+
// RESERVATIONS: unlike the usage-limit pause, the members stay reserved by
|
|
88
|
+
// this sprint for the whole wait: the CLI's 'paused' handler skips the
|
|
89
|
+
// hand-back when the pause source is 'needs_decision' (and its pre-resume
|
|
90
|
+
// hook then has nothing to re-acquire or resync), so no other sprint can take
|
|
91
|
+
// a member meanwhile. The sprint lock is held too: a paused run is running.
|
|
92
|
+
//
|
|
93
|
+
// STOP: an operator stop during the wait rejects at once with a CancelledError
|
|
94
|
+
// -- through the engine's stop signal (context.stopSignal()), which also
|
|
95
|
+
// cancels an in-flight pause-exempt read, and through the read blocked at the
|
|
96
|
+
// pause gate -- and it is propagated (never swallowed),
|
|
97
|
+
// so the run tears down immediately, with no further dispatch. The wait never
|
|
98
|
+
// re-parks a run whose stop signal has fired.
|
|
99
|
+
//
|
|
100
|
+
// recordDecisionAnswer(decisionId, answer) is the programmatic answer entry
|
|
101
|
+
// point (for a dashboard route). It only VALIDATES and QUEUES the answer and
|
|
102
|
+
// resolves as soon as it is recorded ({ status: 'recorded' }); it never awaits
|
|
103
|
+
// a resume, a member command or a push, and it never calls pushBeads itself.
|
|
104
|
+
// The queued answer is applied exactly once, through the SAME
|
|
105
|
+
// `bd human respond` command an operator runs, so the bead state is identical:
|
|
106
|
+
// - while the run is waiting: the wait is woken at once, resumes the run
|
|
107
|
+
// once and applies it;
|
|
108
|
+
// - while the run is running: the runner calls applyRecordedAnswers() inside
|
|
109
|
+
// its next beads sync bracket (the start of the next cycle, after the
|
|
110
|
+
// bracket's pull), which writes the `bd human respond` / `bd note`
|
|
111
|
+
// commands and pushes once, all inside that bracket and under the dolt
|
|
112
|
+
// push mutex -- never a free-standing push overlapping a phase's own.
|
|
113
|
+
// An apply error surfaces in the log and in the published 'decisions' state
|
|
114
|
+
// (answerErrors), not through the route; the decision stays pending so it can
|
|
115
|
+
// be answered again.
|
|
116
|
+
// =============================================================================
|
|
117
|
+
|
|
118
|
+
import { stageCommandBodyMemberSide } from './member-provisioning.mjs';
|
|
119
|
+
import { collectSetAsideEntries } from './set-aside.mjs';
|
|
120
|
+
import { removeStagedBody } from './decisions.mjs';
|
|
121
|
+
import { CancelledError } from '@apralabs/apra-fleet-workflow';
|
|
122
|
+
|
|
123
|
+
/** The run state while waiting (sprintState.decisionWait.state, published under 'decisions'). */
|
|
124
|
+
export const PAUSED_AWAITING_DECISION = 'paused-awaiting-decision';
|
|
125
|
+
|
|
126
|
+
/** requestPause's typed source for this pause. */
|
|
127
|
+
export const DECISION_PAUSE_SOURCE = 'needs_decision';
|
|
128
|
+
|
|
129
|
+
/** The published state namespace. */
|
|
130
|
+
export const DECISIONS_STATE_NAMESPACE = 'decisions';
|
|
131
|
+
|
|
132
|
+
export const DECISION_POLL_INTERVAL_MS_DEFAULT = 60_000;
|
|
133
|
+
|
|
134
|
+
/** How often a paused run reads its decision beads for an out-of-process answer. */
|
|
135
|
+
export const DECISION_READ_POLL_INTERVAL_MS_DEFAULT = 5 * 60_000;
|
|
136
|
+
|
|
137
|
+
// Every decision wait currently paused in this process. An in-process answer
|
|
138
|
+
// route (the sprint's own viewer/dashboard) finds the run to answer here.
|
|
139
|
+
const liveWaits = new Set();
|
|
140
|
+
|
|
141
|
+
// Every decision wait created in this process, so an in-process answer route
|
|
142
|
+
// can find the run owning a pending decision whether or not that run is
|
|
143
|
+
// currently paused (a decision may be pending while other beads still run).
|
|
144
|
+
// Pruned of idle entries on each creation so it cannot grow without bound.
|
|
145
|
+
const allWaits = new Set();
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* Answers a pending decision through whichever run in this process owns it.
|
|
149
|
+
* Same bead state as `bd human respond`; the run resumes without relaunch.
|
|
150
|
+
* Throws when no run has that pending decision.
|
|
151
|
+
* @param {string} decisionId
|
|
152
|
+
* @param {string} answer
|
|
153
|
+
* @returns {Promise<object>}
|
|
154
|
+
*/
|
|
155
|
+
export async function answerPendingDecision(decisionId, answer) {
|
|
156
|
+
for (const w of allWaits) {
|
|
157
|
+
if (w.pending().some((d) => d.decisionId === decisionId)) return w.recordDecisionAnswer(decisionId, answer);
|
|
158
|
+
}
|
|
159
|
+
throw new Error(`no pending decision ${JSON.stringify(decisionId)}`);
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/** The pending decisions of every run in this process (full, untruncated). */
|
|
163
|
+
export function allPendingDecisions() {
|
|
164
|
+
return [...allWaits].flatMap((w) => w.pending());
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* The decision waits currently paused in this process: each exposes
|
|
169
|
+
* pending() (the pending decision records) and recordDecisionAnswer().
|
|
170
|
+
* @returns {Array<{ pending: () => object[], recordDecisionAnswer: (decisionId: string, answer: string) => Promise<object> }>}
|
|
171
|
+
*/
|
|
172
|
+
export function activeDecisionWaits() {
|
|
173
|
+
return [...liveWaits];
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/** The poll interval: APRA_FLEET_DECISION_POLL_MS when it is a positive integer, else the default. */
|
|
177
|
+
export function decisionPollIntervalMs(env = process.env) {
|
|
178
|
+
const raw = env && env.APRA_FLEET_DECISION_POLL_MS;
|
|
179
|
+
const n = Number(raw);
|
|
180
|
+
return raw !== undefined && raw !== '' && Number.isInteger(n) && n > 0 ? n : DECISION_POLL_INTERVAL_MS_DEFAULT;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* The decision bead read interval while paused: APRA_FLEET_DECISION_READ_POLL_MS
|
|
185
|
+
* when it is a positive integer, else the default (5 minutes).
|
|
186
|
+
*/
|
|
187
|
+
export function decisionReadPollIntervalMs(env = process.env) {
|
|
188
|
+
const raw = env && env.APRA_FLEET_DECISION_READ_POLL_MS;
|
|
189
|
+
const n = Number(raw);
|
|
190
|
+
return raw !== undefined && raw !== '' && Number.isInteger(n) && n > 0 ? n : DECISION_READ_POLL_INTERVAL_MS_DEFAULT;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/**
|
|
194
|
+
* The answer text from a decision bead's comments: the last comment written
|
|
195
|
+
* by `bd human respond` ("Response: <text>"), else the last comment, else ''.
|
|
196
|
+
* @param {Array<{ text?: string }>} comments
|
|
197
|
+
* @returns {string}
|
|
198
|
+
*/
|
|
199
|
+
export function answerFromComments(comments) {
|
|
200
|
+
const list = Array.isArray(comments) ? comments.filter((c) => c && typeof c.text === 'string') : [];
|
|
201
|
+
for (let i = list.length - 1; i >= 0; i--) {
|
|
202
|
+
const m = list[i].text.match(/^Response:\s*([\s\S]*)$/);
|
|
203
|
+
if (m) return m[1].trim();
|
|
204
|
+
}
|
|
205
|
+
return list.length > 0 ? list[list.length - 1].text.trim() : '';
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* The note appended to the work bead once its decision is answered.
|
|
210
|
+
* @param {object} decision a pendingDecisions record
|
|
211
|
+
* @param {string} answer
|
|
212
|
+
* @param {string} via 'bd human respond' or 'recordDecisionAnswer'
|
|
213
|
+
* @returns {string}
|
|
214
|
+
*/
|
|
215
|
+
export function formatDecisionAnswerNote(decision, answer, via) {
|
|
216
|
+
return [
|
|
217
|
+
`[fleet-sprint] OPERATOR DECISION on ${decision.beadId}` +
|
|
218
|
+
(decision.decisionBeadId ? ` (decision bead ${decision.decisionBeadId}, via ${via})` : ` (via ${via})`),
|
|
219
|
+
'',
|
|
220
|
+
'Answer:',
|
|
221
|
+
answer || '(closed without a response text)',
|
|
222
|
+
'',
|
|
223
|
+
'Question was:',
|
|
224
|
+
decision.question,
|
|
225
|
+
'',
|
|
226
|
+
'Options were:',
|
|
227
|
+
...decision.options.map((o) => `(${o.id}) ${o.text}`),
|
|
228
|
+
'',
|
|
229
|
+
`Recommendation was: ${decision.recommendation}`,
|
|
230
|
+
'',
|
|
231
|
+
'Follow this answer when working the bead.',
|
|
232
|
+
].join('\n');
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
/** "5 minutes", "90 seconds": a poll cadence as the operator reads it. */
|
|
236
|
+
export function formatInterval(ms) {
|
|
237
|
+
if (ms >= 60_000 && ms % 60_000 === 0) return `${ms / 60_000} minute${ms === 60_000 ? '' : 's'}`;
|
|
238
|
+
const sec = Math.max(1, Math.round(ms / 1000));
|
|
239
|
+
return `${sec} second${sec === 1 ? '' : 's'}`;
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
function parseJson(raw) {
|
|
243
|
+
if (raw && typeof raw === 'object') return raw;
|
|
244
|
+
const text = String(raw ?? '').trim();
|
|
245
|
+
if (!text) return null;
|
|
246
|
+
const start = text.search(/[[{]/);
|
|
247
|
+
return JSON.parse(start > 0 ? text.slice(start) : text);
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
/**
|
|
251
|
+
* Builds the decision wait for one run.
|
|
252
|
+
*
|
|
253
|
+
* @param {object} deps
|
|
254
|
+
* @param {object} deps.sprintState
|
|
255
|
+
* @param {(reason: string, opts?: object) => (void|Promise<void>)} deps.requestPause
|
|
256
|
+
* @param {(reason: string) => Promise<void>} deps.requestResume
|
|
257
|
+
* @param {Function} deps.command the workflow command() seam (must honour
|
|
258
|
+
* opts.pauseExempt for the read made while paused)
|
|
259
|
+
* @param {string} deps.member the member whose beads clone the engine reads and
|
|
260
|
+
* writes: the runner passes its backlog member, which no sprint reserves
|
|
261
|
+
* @param {(member: string) => Promise<any>} [deps.pullBeads] pull that clone before a poll read
|
|
262
|
+
* @param {(member: string) => Promise<any>} [deps.pushBeads] push it after applying answers
|
|
263
|
+
* @param {(namespace: string, data: object) => void} [deps.publishState]
|
|
264
|
+
* @param {(msg: string) => void} [deps.log]
|
|
265
|
+
* @param {number} [deps.pollIntervalMs] the in-process answer queue check interval
|
|
266
|
+
* @param {number} [deps.readPollIntervalMs] the pause-exempt decision bead read interval
|
|
267
|
+
* @param {() => number} [deps.now]
|
|
268
|
+
* @param {() => (AbortSignal|undefined)} [deps.stopSignal] the engine's run
|
|
269
|
+
* stop signal (context.stopSignal); without it a stop is seen only through
|
|
270
|
+
* the read blocked at the pause gate
|
|
271
|
+
* @returns {{
|
|
272
|
+
* pending: () => object[],
|
|
273
|
+
* hasPending: () => boolean,
|
|
274
|
+
* awaitAnswer: (opts: { where: string, cycle?: number }) => Promise<object[]>,
|
|
275
|
+
* recordDecisionAnswer: (decisionId: string, answer: string) => Promise<object>,
|
|
276
|
+
* }}
|
|
277
|
+
*/
|
|
278
|
+
export function createDecisionWait({
|
|
279
|
+
sprintState,
|
|
280
|
+
requestPause,
|
|
281
|
+
requestResume,
|
|
282
|
+
command,
|
|
283
|
+
member,
|
|
284
|
+
pullBeads = async () => {},
|
|
285
|
+
pushBeads = async () => {},
|
|
286
|
+
publishState = () => {},
|
|
287
|
+
log = () => {},
|
|
288
|
+
pollIntervalMs = decisionPollIntervalMs(),
|
|
289
|
+
readPollIntervalMs = decisionReadPollIntervalMs(),
|
|
290
|
+
now = () => Date.now(),
|
|
291
|
+
stopSignal = () => undefined,
|
|
292
|
+
}) {
|
|
293
|
+
let waiting = false;
|
|
294
|
+
let wake = null;
|
|
295
|
+
const queued = new Map(); // decisionId -> { answer, recordedAt }
|
|
296
|
+
const answerErrors = new Map(); // decisionId -> last apply error message
|
|
297
|
+
|
|
298
|
+
const pendingMap = () => (sprintState.pendingDecisions instanceof Map ? sprintState.pendingDecisions : new Map());
|
|
299
|
+
const setAside = () => (sprintState.doctorBlockedIds instanceof Map ? sprintState.doctorBlockedIds : new Map());
|
|
300
|
+
// Pending decisions whose bead is still set aside for them.
|
|
301
|
+
const settingAside = () => [...pendingMap().values()].filter((d) => {
|
|
302
|
+
const e = setAside().get(d.beadId);
|
|
303
|
+
return e && e.decisionId === d.decisionId;
|
|
304
|
+
});
|
|
305
|
+
// A decision only holds the run while its bead is still set aside for it
|
|
306
|
+
// AND it has a decision bead. One whose decision bead could not be filed
|
|
307
|
+
// has no answer path (polling reads decision beads; bd human respond and
|
|
308
|
+
// recordDecisionAnswer both respond on one), so waiting on it could never
|
|
309
|
+
// end: it does not hold the run, and a stall on it throws
|
|
310
|
+
// StalledSprintError naming it with its full question, as before.
|
|
311
|
+
const holding = () => settingAside().filter((d) => d.decisionBeadId);
|
|
312
|
+
|
|
313
|
+
const publish = (state) => {
|
|
314
|
+
const pending = [...pendingMap().values()].map((d) => ({
|
|
315
|
+
decisionId: d.decisionId, beadId: d.beadId, decisionBeadId: d.decisionBeadId,
|
|
316
|
+
question: d.question, options: d.options, recommendation: d.recommendation,
|
|
317
|
+
raisedBy: d.raisedBy, cycle: d.cycle, round: d.round, raisedAt: d.raisedAt || null,
|
|
318
|
+
notification: d.notification || {},
|
|
319
|
+
answerRecorded: queued.has(d.decisionId),
|
|
320
|
+
}));
|
|
321
|
+
try {
|
|
322
|
+
publishState(DECISIONS_STATE_NAMESPACE, {
|
|
323
|
+
state, pending,
|
|
324
|
+
waitingSince: sprintState.decisionWait ? sprintState.decisionWait.since : null,
|
|
325
|
+
setAside: collectSetAsideEntries(sprintState),
|
|
326
|
+
answerErrors: [...answerErrors].map(([decisionId, error]) => ({ decisionId, error })),
|
|
327
|
+
});
|
|
328
|
+
} catch (err) {
|
|
329
|
+
log(`decision wait: publishing state failed (non-fatal): ${err.message}`);
|
|
330
|
+
}
|
|
331
|
+
};
|
|
332
|
+
|
|
333
|
+
// Applies one answer: note on the work bead, release of its set-aside,
|
|
334
|
+
// bookkeeping. `respond` first runs `bd human respond` (programmatic path).
|
|
335
|
+
const applyAnswer = async (decision, answer, { via, respond }) => {
|
|
336
|
+
if (respond) {
|
|
337
|
+
if (!decision.decisionBeadId) throw new Error(`decision ${decision.decisionId} has no decision bead to respond on`);
|
|
338
|
+
const file = await stageCommandBodyMemberSide({
|
|
339
|
+
command, member, content: answer, label: `Stage operator answer for ${decision.decisionBeadId}`,
|
|
340
|
+
});
|
|
341
|
+
try {
|
|
342
|
+
await command(
|
|
343
|
+
`bd human respond ${decision.decisionBeadId} --file "${file}"`,
|
|
344
|
+
{ member_name: member, silent: true, label: `Record operator answer on ${decision.decisionBeadId}` },
|
|
345
|
+
);
|
|
346
|
+
} finally {
|
|
347
|
+
await removeStagedBody({ command, member, file, log });
|
|
348
|
+
}
|
|
349
|
+
}
|
|
350
|
+
let noteFile = null;
|
|
351
|
+
try {
|
|
352
|
+
noteFile = await stageCommandBodyMemberSide({
|
|
353
|
+
command, member, content: formatDecisionAnswerNote(decision, answer, via),
|
|
354
|
+
label: `Stage decision answer note for ${decision.beadId}`,
|
|
355
|
+
});
|
|
356
|
+
await command(
|
|
357
|
+
`bd note ${decision.beadId} --file "${noteFile}"`,
|
|
358
|
+
{ member_name: member, silent: true, label: `Append operator decision to ${decision.beadId} notes` },
|
|
359
|
+
);
|
|
360
|
+
} catch (err) {
|
|
361
|
+
if (err && err.name === 'CancelledError') throw err;
|
|
362
|
+
log(`decision ${decision.decisionId}: appending the answer to '${decision.beadId}' notes FAILED (non-fatal): ${err.message}`);
|
|
363
|
+
}
|
|
364
|
+
await removeStagedBody({ command, member, file: noteFile, log });
|
|
365
|
+
const released = [];
|
|
366
|
+
for (const [id, e] of [...setAside()]) {
|
|
367
|
+
if (e && e.decisionId === decision.decisionId) {
|
|
368
|
+
setAside().delete(id);
|
|
369
|
+
released.push(id);
|
|
370
|
+
}
|
|
371
|
+
}
|
|
372
|
+
pendingMap().delete(decision.decisionId);
|
|
373
|
+
sprintState.answeredDecisions = sprintState.answeredDecisions instanceof Map ? sprintState.answeredDecisions : new Map();
|
|
374
|
+
const record = { ...decision, answer, via, answeredAt: new Date(now()).toISOString(), released };
|
|
375
|
+
sprintState.answeredDecisions.set(decision.decisionId, record);
|
|
376
|
+
log(
|
|
377
|
+
`Decision ${decision.decisionId} answered via ${via}: released [${released.join(', ')}] for dispatch; ` +
|
|
378
|
+
`the answer is in ${decision.beadId}'s notes. Answer: ${answer || '(none)'}`,
|
|
379
|
+
);
|
|
380
|
+
return record;
|
|
381
|
+
};
|
|
382
|
+
|
|
383
|
+
// The ids one poll reads: each holding decision's decision bead (a
|
|
384
|
+
// decision without one never holds the run, see holding()).
|
|
385
|
+
const pollIds = (decisions) => [...new Set(decisions.map((d) => d.decisionBeadId).filter(Boolean))];
|
|
386
|
+
|
|
387
|
+
const readBeads = async (ids, label, extraOpts = {}) => {
|
|
388
|
+
if (ids.length === 0) return [];
|
|
389
|
+
const shown = parseJson(await command(
|
|
390
|
+
`bd show ${ids.join(' ')} --json`,
|
|
391
|
+
{ member_name: member, silent: true, label, ...extraOpts },
|
|
392
|
+
));
|
|
393
|
+
return Array.isArray(shown) ? shown : (shown ? [shown] : []);
|
|
394
|
+
};
|
|
395
|
+
|
|
396
|
+
// Which of `decisions` have a decision bead that `shown` reports closed
|
|
397
|
+
// (answered), with the answer text from its comments.
|
|
398
|
+
const closedAnswers = async (decisions, shown) => {
|
|
399
|
+
const closed = new Set((shown || []).filter((b) => b && b.status === 'closed').map((b) => String(b.id)));
|
|
400
|
+
const out = [];
|
|
401
|
+
for (const d of decisions) {
|
|
402
|
+
if (!d.decisionBeadId || !closed.has(d.decisionBeadId)) continue;
|
|
403
|
+
let answer = '';
|
|
404
|
+
try {
|
|
405
|
+
const comments = parseJson(await command(
|
|
406
|
+
`bd comments ${d.decisionBeadId} --json`,
|
|
407
|
+
{ member_name: member, silent: true, label: `Read the answer on ${d.decisionBeadId}` },
|
|
408
|
+
));
|
|
409
|
+
answer = answerFromComments(comments);
|
|
410
|
+
} catch (err) {
|
|
411
|
+
if (err && err.name === 'CancelledError') throw err;
|
|
412
|
+
log(`decision ${d.decisionId}: reading the response on ${d.decisionBeadId} failed (${err.message}); treating it as answered without text.`);
|
|
413
|
+
}
|
|
414
|
+
out.push({ decision: d, answer });
|
|
415
|
+
}
|
|
416
|
+
return out;
|
|
417
|
+
};
|
|
418
|
+
|
|
419
|
+
// Applies every queued answer (bd human respond + note + set-aside
|
|
420
|
+
// release). An apply error is logged and published, the answer dropped and
|
|
421
|
+
// its decision left pending (so it can be answered again, and a failing
|
|
422
|
+
// answer can never spin the wait); a stop propagates.
|
|
423
|
+
const drainQueued = async () => {
|
|
424
|
+
const results = [];
|
|
425
|
+
let failed = false;
|
|
426
|
+
for (const [decisionId, q] of [...queued]) {
|
|
427
|
+
queued.delete(decisionId);
|
|
428
|
+
const decision = pendingMap().get(decisionId);
|
|
429
|
+
if (!decision) continue;
|
|
430
|
+
try {
|
|
431
|
+
const rec = await applyAnswer(decision, q.answer, { via: 'recordDecisionAnswer', respond: true });
|
|
432
|
+
answerErrors.delete(decisionId);
|
|
433
|
+
results.push(rec);
|
|
434
|
+
} catch (err) {
|
|
435
|
+
if (err && err.name === 'CancelledError') throw err;
|
|
436
|
+
const msg = err && err.message ? err.message : String(err);
|
|
437
|
+
answerErrors.set(decisionId, msg);
|
|
438
|
+
failed = true;
|
|
439
|
+
log(`decision ${decisionId}: applying the recorded answer FAILED (${msg}); the decision stays pending and can be answered again.`);
|
|
440
|
+
}
|
|
441
|
+
}
|
|
442
|
+
if (failed) publish(waiting ? PAUSED_AWAITING_DECISION : 'running');
|
|
443
|
+
return results;
|
|
444
|
+
};
|
|
445
|
+
|
|
446
|
+
let api = null;
|
|
447
|
+
|
|
448
|
+
const signalOf = () => {
|
|
449
|
+
try { return stopSignal() || null; } catch { return null; }
|
|
450
|
+
};
|
|
451
|
+
const stopError = (signal) => (signal.reason instanceof Error
|
|
452
|
+
? signal.reason
|
|
453
|
+
: new CancelledError(`[Workflow Error] ${signal.reason ? String(signal.reason) : 'run stopped'}`));
|
|
454
|
+
const throwIfStopped = () => {
|
|
455
|
+
const signal = signalOf();
|
|
456
|
+
if (signal && signal.aborted) throw stopError(signal);
|
|
457
|
+
};
|
|
458
|
+
// Settles when `promise` does, or rejects at once on a stop.
|
|
459
|
+
const untilStopped = (promise, cleanup = () => {}) => {
|
|
460
|
+
const signal = signalOf();
|
|
461
|
+
let onAbort = null;
|
|
462
|
+
return new Promise((resolve, reject) => {
|
|
463
|
+
if (signal) {
|
|
464
|
+
onAbort = () => reject(stopError(signal));
|
|
465
|
+
if (signal.aborted) { onAbort(); return; }
|
|
466
|
+
signal.addEventListener('abort', onAbort, { once: true });
|
|
467
|
+
}
|
|
468
|
+
promise.then(resolve, reject);
|
|
469
|
+
}).finally(() => {
|
|
470
|
+
if (signal && onAbort) signal.removeEventListener('abort', onAbort);
|
|
471
|
+
cleanup();
|
|
472
|
+
});
|
|
473
|
+
};
|
|
474
|
+
|
|
475
|
+
// Parks the run ONCE and holds it parked -- no member release, no resume
|
|
476
|
+
// -- until it is released. The one gated read is issued while the run is
|
|
477
|
+
// paused, so it blocks at the engine's pause gate and only runs on
|
|
478
|
+
// release. Two timers run meanwhile:
|
|
479
|
+
// - every pollIntervalMs (and every recordDecisionAnswer wake): check
|
|
480
|
+
// the in-process answer queue; no command;
|
|
481
|
+
// - every readPollIntervalMs: ONE pause-exempt `bd show` of the holding
|
|
482
|
+
// decision beads on the backlog member (command opts.pauseExempt:
|
|
483
|
+
// it skips the pause gate and is not an in-flight activity). No pull,
|
|
484
|
+
// no resync, no release, no pause/resume per read. A read failure is
|
|
485
|
+
// logged once per distinct error and the wait keeps going.
|
|
486
|
+
// A queued answer, or a decision bead the read reports closed (answered
|
|
487
|
+
// out of process with `bd human respond`), resumes the run ONCE. A failed
|
|
488
|
+
// resume (the pre-resume hook threw) keeps the run parked and is retried
|
|
489
|
+
// on the next interval, logged once per distinct error. Any other release
|
|
490
|
+
// (an operator Resume) also ends the hold. Returns the gated read and
|
|
491
|
+
// whether this wait did the resume; rejects with a CancelledError on a
|
|
492
|
+
// stop.
|
|
493
|
+
const holdUntilReleased = async (reason, ids) => {
|
|
494
|
+
throwIfStopped();
|
|
495
|
+
// Captured now, inside the run: the timers below may fire outside the
|
|
496
|
+
// run's async context, where stopSignal() can no longer find it.
|
|
497
|
+
const runSignal = signalOf();
|
|
498
|
+
await requestPause(reason, { source: DECISION_PAUSE_SOURCE });
|
|
499
|
+
let selfResume = false;
|
|
500
|
+
let resuming = false;
|
|
501
|
+
let lastResumeError = null;
|
|
502
|
+
let lastReadError = null;
|
|
503
|
+
let answeredOutOfProcess = false;
|
|
504
|
+
let reading = false;
|
|
505
|
+
let released = false;
|
|
506
|
+
let timer = null;
|
|
507
|
+
let readTimer = null;
|
|
508
|
+
const stopped = () => !!(runSignal && runSignal.aborted);
|
|
509
|
+
const tryResume = () => {
|
|
510
|
+
if (resuming || selfResume || (queued.size === 0 && !answeredOutOfProcess)) return;
|
|
511
|
+
if (stopped()) return;
|
|
512
|
+
resuming = true;
|
|
513
|
+
selfResume = true;
|
|
514
|
+
const why = queued.size > 0
|
|
515
|
+
? 'an operator answer to a pending decision was recorded'
|
|
516
|
+
: 'an operator answered a pending decision with bd human respond';
|
|
517
|
+
Promise.resolve()
|
|
518
|
+
.then(() => requestResume(why))
|
|
519
|
+
.then(() => { resuming = false; }, (err) => {
|
|
520
|
+
resuming = false;
|
|
521
|
+
selfResume = false;
|
|
522
|
+
const msg = err && err.message ? err.message : String(err);
|
|
523
|
+
if (msg !== lastResumeError) {
|
|
524
|
+
lastResumeError = msg;
|
|
525
|
+
log(`decision wait: resume failed, staying paused and retrying every ${Math.round(pollIntervalMs / 1000)}s while an answer is waiting: ${msg}`);
|
|
526
|
+
}
|
|
527
|
+
});
|
|
528
|
+
};
|
|
529
|
+
// One pause-exempt read of the holding decision beads (never two at
|
|
530
|
+
// once, none after an answer was seen or the run was released/stopped).
|
|
531
|
+
const pollRead = async () => {
|
|
532
|
+
if (reading || answeredOutOfProcess || released || stopped()) return;
|
|
533
|
+
reading = true;
|
|
534
|
+
try {
|
|
535
|
+
// The run's stop signal is passed explicitly: this read is
|
|
536
|
+
// issued from a timer, outside any guarantee that the run's
|
|
537
|
+
// async context (where command() finds it) is still current.
|
|
538
|
+
const shown = await readBeads(
|
|
539
|
+
ids, 'Check pending decision beads for an answer (read while paused)',
|
|
540
|
+
{ pauseExempt: true, ...(runSignal ? { signal: runSignal } : {}) },
|
|
541
|
+
);
|
|
542
|
+
if (released || stopped()) return;
|
|
543
|
+
const closedIds = shown.filter((b) => b && b.status === 'closed').map((b) => String(b.id)).filter((id) => ids.includes(id));
|
|
544
|
+
if (closedIds.length > 0) {
|
|
545
|
+
answeredOutOfProcess = true;
|
|
546
|
+
log(`Decision bead(s) ${closedIds.join(', ')} answered with bd human respond; resuming the sprint to apply the answer.`);
|
|
547
|
+
tryResume();
|
|
548
|
+
}
|
|
549
|
+
} catch (err) {
|
|
550
|
+
if (err && err.name === 'CancelledError') return; // a stop: untilStopped reports it
|
|
551
|
+
const msg = err && err.message ? err.message : String(err);
|
|
552
|
+
if (msg !== lastReadError) {
|
|
553
|
+
lastReadError = msg;
|
|
554
|
+
log(`decision wait: reading the decision bead(s) for an answer failed (non-fatal; retrying every ${Math.round(readPollIntervalMs / 1000)}s): ${msg}`);
|
|
555
|
+
}
|
|
556
|
+
} finally {
|
|
557
|
+
reading = false;
|
|
558
|
+
}
|
|
559
|
+
};
|
|
560
|
+
const tick = () => {
|
|
561
|
+
tryResume();
|
|
562
|
+
timer = setTimeout(tick, pollIntervalMs);
|
|
563
|
+
};
|
|
564
|
+
const readTick = () => {
|
|
565
|
+
pollRead().then(() => tryResume(), () => {});
|
|
566
|
+
readTimer = setTimeout(readTick, readPollIntervalMs);
|
|
567
|
+
};
|
|
568
|
+
timer = setTimeout(tick, pollIntervalMs);
|
|
569
|
+
if (ids.length > 0) readTimer = setTimeout(readTick, readPollIntervalMs);
|
|
570
|
+
wake = tryResume;
|
|
571
|
+
const read = readBeads(ids, 'Read pending decisions once the run is released (waits at the pause gate)');
|
|
572
|
+
read.catch(() => {}); // a stop rejects it; untilStopped reports that
|
|
573
|
+
tryResume();
|
|
574
|
+
const shown = await untilStopped(read, () => {
|
|
575
|
+
released = true;
|
|
576
|
+
clearTimeout(timer);
|
|
577
|
+
clearTimeout(readTimer);
|
|
578
|
+
wake = null;
|
|
579
|
+
});
|
|
580
|
+
return { shown, resumedBySelf: selfResume };
|
|
581
|
+
};
|
|
582
|
+
|
|
583
|
+
// One poll interval while the run is NOT parked (after a release with no
|
|
584
|
+
// answer): ends early on a recordDecisionAnswer wake, rejects on a stop.
|
|
585
|
+
const idleInterval = () => {
|
|
586
|
+
let timer = null;
|
|
587
|
+
const elapsed = new Promise((resolve) => {
|
|
588
|
+
timer = setTimeout(resolve, pollIntervalMs);
|
|
589
|
+
wake = resolve;
|
|
590
|
+
if (queued.size > 0) resolve();
|
|
591
|
+
});
|
|
592
|
+
return untilStopped(elapsed, () => { clearTimeout(timer); wake = null; });
|
|
593
|
+
};
|
|
594
|
+
|
|
595
|
+
api = {
|
|
596
|
+
/** Re-publishes the decisions namespace (e.g. after a new decision or a notification outcome). */
|
|
597
|
+
publish() {
|
|
598
|
+
publish(waiting ? PAUSED_AWAITING_DECISION : 'running');
|
|
599
|
+
},
|
|
600
|
+
|
|
601
|
+
pending() {
|
|
602
|
+
return [...pendingMap().values()];
|
|
603
|
+
},
|
|
604
|
+
|
|
605
|
+
hasPending() {
|
|
606
|
+
return holding().length > 0;
|
|
607
|
+
},
|
|
608
|
+
|
|
609
|
+
/** Whether a recorded answer is waiting to be applied. */
|
|
610
|
+
hasQueuedAnswers() {
|
|
611
|
+
return queued.size > 0;
|
|
612
|
+
},
|
|
613
|
+
|
|
614
|
+
/**
|
|
615
|
+
* Applies the answers recorded while the run was running, and pushes
|
|
616
|
+
* once when any applied. The runner calls this INSIDE an open beads
|
|
617
|
+
* sync bracket (after its pull); this is the only place a mid-run
|
|
618
|
+
* answer's bd writes and push happen. Returns the applied records.
|
|
619
|
+
*/
|
|
620
|
+
async applyRecordedAnswers() {
|
|
621
|
+
if (waiting || queued.size === 0) return [];
|
|
622
|
+
const applied = await drainQueued();
|
|
623
|
+
if (applied.length > 0) {
|
|
624
|
+
await pushBeads(member);
|
|
625
|
+
publish('running');
|
|
626
|
+
}
|
|
627
|
+
return applied;
|
|
628
|
+
},
|
|
629
|
+
|
|
630
|
+
/**
|
|
631
|
+
* Pending decisions still setting their bead aside whose decision
|
|
632
|
+
* bead could NOT be filed: nothing can answer them in this run.
|
|
633
|
+
*/
|
|
634
|
+
unfiled() {
|
|
635
|
+
return settingAside().filter((d) => !d.decisionBeadId);
|
|
636
|
+
},
|
|
637
|
+
|
|
638
|
+
/**
|
|
639
|
+
* Pauses until at least one pending decision is answered; returns the
|
|
640
|
+
* applied answers. Throws whatever a resume or poll throws (an
|
|
641
|
+
* operator stop's CancelledError included).
|
|
642
|
+
*/
|
|
643
|
+
async awaitAnswer({ where, cycle = null } = {}) {
|
|
644
|
+
const decisions = holding();
|
|
645
|
+
if (decisions.length === 0) return [];
|
|
646
|
+
waiting = true;
|
|
647
|
+
sprintState.decisionWait = {
|
|
648
|
+
state: PAUSED_AWAITING_DECISION, since: new Date(now()).toISOString(), where, cycle,
|
|
649
|
+
decisionIds: decisions.map((d) => d.decisionId),
|
|
650
|
+
};
|
|
651
|
+
const names = decisions.map((d) => `${d.beadId} (${d.decisionBeadId || 'no decision bead'})`).join(', ');
|
|
652
|
+
log(
|
|
653
|
+
`Sprint ${PAUSED_AWAITING_DECISION} (${where}): nothing else can run until an operator answers ` +
|
|
654
|
+
`${decisions.length} pending decision(s): ${names}. Members stay reserved and idle. Answer from the ` +
|
|
655
|
+
`sprint dashboard's decision banner (resumes at once), or with ` +
|
|
656
|
+
`bd human respond <decision bead> "<answer>" (picked up within ${formatInterval(readPollIntervalMs)}, no Resume needed).`,
|
|
657
|
+
);
|
|
658
|
+
publish(PAUSED_AWAITING_DECISION);
|
|
659
|
+
liveWaits.add(api);
|
|
660
|
+
let loggedRelease = false;
|
|
661
|
+
try {
|
|
662
|
+
for (;;) {
|
|
663
|
+
if (holding().length === 0 && queued.size === 0) return [];
|
|
664
|
+
const { shown, resumedBySelf } = await holdUntilReleased(`awaiting operator decision(s): ${names}`, pollIds(holding()));
|
|
665
|
+
const answered = await drainQueued();
|
|
666
|
+
let polled = await closedAnswers(holding(), shown);
|
|
667
|
+
if (answered.length === 0 && polled.length === 0 && holding().length > 0) {
|
|
668
|
+
// Released with nothing answered in the local clone:
|
|
669
|
+
// pull, then read once more (an operator may have
|
|
670
|
+
// answered elsewhere with bd human respond).
|
|
671
|
+
await pullBeads(member);
|
|
672
|
+
polled = await closedAnswers(holding(), await readBeads(pollIds(holding()), 'Read pending decisions after a beads pull'));
|
|
673
|
+
}
|
|
674
|
+
for (const { decision, answer } of polled) {
|
|
675
|
+
answered.push(await applyAnswer(decision, answer, { via: 'bd human respond', respond: false }));
|
|
676
|
+
}
|
|
677
|
+
if (answered.length > 0) {
|
|
678
|
+
await pushBeads(member);
|
|
679
|
+
log(`Sprint resumed (${where}): ${answered.length} decision(s) answered; the released bead(s) return to the ready pool.`);
|
|
680
|
+
return answered;
|
|
681
|
+
}
|
|
682
|
+
if (!loggedRelease) {
|
|
683
|
+
loggedRelease = true;
|
|
684
|
+
log(
|
|
685
|
+
`Sprint released from ${PAUSED_AWAITING_DECISION} (${where}) ${resumedBySelf ? 'after a failed answer' : 'by a resume'} ` +
|
|
686
|
+
`with no decision answered yet; parking it again after ${Math.round(pollIntervalMs / 1000)}s.`,
|
|
687
|
+
);
|
|
688
|
+
}
|
|
689
|
+
await idleInterval();
|
|
690
|
+
}
|
|
691
|
+
} finally {
|
|
692
|
+
liveWaits.delete(api);
|
|
693
|
+
waiting = false;
|
|
694
|
+
wake = null;
|
|
695
|
+
sprintState.decisionWait = null;
|
|
696
|
+
publish('running');
|
|
697
|
+
}
|
|
698
|
+
},
|
|
699
|
+
|
|
700
|
+
/**
|
|
701
|
+
* Programmatic answer: same bead state as `bd human respond`.
|
|
702
|
+
* @param {string} decisionId
|
|
703
|
+
* @param {string} answer
|
|
704
|
+
*/
|
|
705
|
+
async recordDecisionAnswer(decisionId, answer) {
|
|
706
|
+
const decision = pendingMap().get(decisionId);
|
|
707
|
+
if (!decision) throw new Error(`recordDecisionAnswer: no pending decision ${JSON.stringify(decisionId)}`);
|
|
708
|
+
if (!decision.decisionBeadId) {
|
|
709
|
+
throw new Error(
|
|
710
|
+
`recordDecisionAnswer: decision ${decisionId} on '${decision.beadId}' has no decision bead (filing it failed), ` +
|
|
711
|
+
'so there is no bd human respond path to record the answer on; the run cannot be resumed with it. ' +
|
|
712
|
+
`Record the decision in '${decision.beadId}' notes and re-run the sprint.`,
|
|
713
|
+
);
|
|
714
|
+
}
|
|
715
|
+
const text = String(answer ?? '').trim();
|
|
716
|
+
if (!text) throw new Error('recordDecisionAnswer: the answer is empty');
|
|
717
|
+
if (queued.has(decisionId)) {
|
|
718
|
+
throw new Error(`recordDecisionAnswer: an answer for decision ${JSON.stringify(decisionId)} is already recorded and awaiting apply`);
|
|
719
|
+
}
|
|
720
|
+
queued.set(decisionId, { answer: text, recordedAt: new Date(now()).toISOString() });
|
|
721
|
+
answerErrors.delete(decisionId);
|
|
722
|
+
log(`Decision ${decisionId}: answer recorded; it is applied ${waiting ? 'now (the paused run is woken)' : 'in the next beads sync bracket'}.`);
|
|
723
|
+
publish(waiting ? PAUSED_AWAITING_DECISION : 'running');
|
|
724
|
+
if (wake) wake();
|
|
725
|
+
return { status: 'recorded', decisionId, released: [] };
|
|
726
|
+
},
|
|
727
|
+
};
|
|
728
|
+
for (const w of [...allWaits]) if (w.pending().length === 0) allWaits.delete(w);
|
|
729
|
+
allWaits.add(api);
|
|
730
|
+
return api;
|
|
731
|
+
}
|