@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,646 @@
|
|
|
1
|
+
// Child-bead allocation and batched-claim surface for fleet-sprint
|
|
2
|
+
// (apra-fleet-3swo.6.13). Extracted out of runner.js; runner.js re-exports
|
|
3
|
+
// every symbol it previously exported from this region, so existing importers
|
|
4
|
+
// of fleet-sprint/runner.js resolve unchanged.
|
|
5
|
+
//
|
|
6
|
+
// This module owns the bd COMMAND SITES that create/claim/verify child beads:
|
|
7
|
+
// - computeChildFloor: best-effort read of a parent's existing direct
|
|
8
|
+
// children, used to seed the id allocator's floor.
|
|
9
|
+
// - createChildBeadWithAllocatedId: the single bead-creation seam every
|
|
10
|
+
// proposed newTask flows through (allocate -> bd create -> bd update
|
|
11
|
+
// --parent -> confirm/release).
|
|
12
|
+
// - verifyDoerStreakClosed: the orchestrator's post-streak D-pull + `bd
|
|
13
|
+
// show` verification read.
|
|
14
|
+
// - claimBeadsBatched: the batched `bd update ... --claim --json` streak
|
|
15
|
+
// work-claiming call.
|
|
16
|
+
//
|
|
17
|
+
// Deliberately kept OUT of coordination.mjs: coordination.mjs owns the
|
|
18
|
+
// TRANSPORT clients for the child-id allocator and the dolt push mutex
|
|
19
|
+
// (createHttpChildIdAllocatorClient, createMcpChildIdAllocatorClient and
|
|
20
|
+
// friends) -- this module's four functions are the CALLERS that issue bd
|
|
21
|
+
// commands on top of that transport. Mixing them would put a bd command
|
|
22
|
+
// surface inside a module whose whole point is transport.
|
|
23
|
+
//
|
|
24
|
+
// resolveSettleShell did NOT move -- it is module-private composition-root
|
|
25
|
+
// wiring that test/sprint-state.test.mjs anchors to runner.js by symbol, and
|
|
26
|
+
// six of its seven call sites are runner.js's own orchestrator-side settle
|
|
27
|
+
// brackets -- so this module imports it back from runner.js, the same
|
|
28
|
+
// back-import pattern member-sync.mjs already uses.
|
|
29
|
+
|
|
30
|
+
import { parseBdJson } from './beads-scope.mjs';
|
|
31
|
+
import { stageCommandBodyMemberSide } from './member-provisioning.mjs';
|
|
32
|
+
import { DoltSync } from './dolt-sync.mjs';
|
|
33
|
+
import { buildSettleCallback } from './dolt-settle.mjs';
|
|
34
|
+
import { resolveSettleShell } from './runner.js';
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* The count of children a parent ALREADY has, i.e. the highest trailing `.N`
|
|
38
|
+
* segment across its direct children. Passed to the allocator as `floor` so
|
|
39
|
+
* that on its FIRST allocation under a parent it never mints an id colliding
|
|
40
|
+
* with a child created before the allocator's persisted state was seeded.
|
|
41
|
+
* Best-effort: a failed or unparseable list yields 0 (the allocator's own
|
|
42
|
+
* persisted high-water still guards against re-minting after that).
|
|
43
|
+
*
|
|
44
|
+
* MUST include closed children (documented `--all` flag): `bd list --parent`
|
|
45
|
+
* excludes closed issues by default, so once every existing child under a
|
|
46
|
+
* parent is closed an unfiltered list would return [], the floor would
|
|
47
|
+
* compute to 0, and the allocator would re-mint already-used ids (`.1`/`.2`,
|
|
48
|
+
* ...) -- the trigger for the id-collision bug (apra-fleet-btj9).
|
|
49
|
+
* `--all` ("Show all issues including closed") is `bd list`'s documented
|
|
50
|
+
* spelling for this, per `bd list --help` -- `--status
|
|
51
|
+
* all` is undocumented there (it is a documented value for `bd search`'s `-s`
|
|
52
|
+
* flag, not `bd list`'s).
|
|
53
|
+
*
|
|
54
|
+
* SILENT FAILURE, apra-fleet-btj9.3: every failure mode here -- `bd` exiting
|
|
55
|
+
* non-zero on a rejected flag, a dispatch timeout, unparseable JSON --
|
|
56
|
+
* collapses to "this parent has no children", re-seeding the floor to 0 and
|
|
57
|
+
* letting the allocator re-mint an already-used id. The best-effort RETURN
|
|
58
|
+
* VALUE (0) is deliberate and stays; the optional `log` callback below makes
|
|
59
|
+
* the failure itself visible to sprint output instead of vanishing into a
|
|
60
|
+
* bare catch, matching the injected-log convention this module's other
|
|
61
|
+
* functions already use (see createChildBeadWithAllocatedId's/
|
|
62
|
+
* claimBeadsBatched's `log = () => {}` default).
|
|
63
|
+
*
|
|
64
|
+
* SUCCESS-PATH LOG, apra-fleet-btj9.3: a non-zero result is ALSO logged (a
|
|
65
|
+
* zero floor -- the common "parent has no children yet" case -- is not, to
|
|
66
|
+
* stay non-noisy). This is the only externally observable signal that the
|
|
67
|
+
* `--all` closed-children read actually found and counted a prior child,
|
|
68
|
+
* which is what lets a replayed mock-sprint scenario prove end to end that
|
|
69
|
+
* this read reaches a genuine non-zero floor rather than only being covered
|
|
70
|
+
* by the direct unit tests in child-floor-includes-closed-children.test.mjs.
|
|
71
|
+
*
|
|
72
|
+
* @param {{ command: Function, member: string, parentId: string, log?: Function }} opts
|
|
73
|
+
* @returns {Promise<number>}
|
|
74
|
+
*/
|
|
75
|
+
export async function computeChildFloor({ command, member, parentId, log = () => {} }) {
|
|
76
|
+
try {
|
|
77
|
+
const label = `bd list --parent ${parentId} --json --all`;
|
|
78
|
+
const raw = await command(label, { member_name: member, silent: true });
|
|
79
|
+
const beads = parseBdJson(raw, label);
|
|
80
|
+
let max = 0;
|
|
81
|
+
const prefix = `${parentId}.`;
|
|
82
|
+
for (const b of beads) {
|
|
83
|
+
if (!b || typeof b.id !== 'string' || !b.id.startsWith(prefix)) continue;
|
|
84
|
+
const tail = b.id.slice(prefix.length);
|
|
85
|
+
// Only a DIRECT child (single trailing numeric segment) counts.
|
|
86
|
+
if (!/^\d+$/.test(tail)) continue;
|
|
87
|
+
const n = Number(tail);
|
|
88
|
+
if (Number.isInteger(n) && n > max) max = n;
|
|
89
|
+
}
|
|
90
|
+
if (max > 0) {
|
|
91
|
+
log(`[id-allocator] computeChildFloor: parent ${parentId} closed-children read found floor ${max}`);
|
|
92
|
+
}
|
|
93
|
+
return max;
|
|
94
|
+
} catch (err) {
|
|
95
|
+
log(`[id-allocator] computeChildFloor: bd list --parent ${parentId} --json --all failed or was unparseable (${err.message}); falling back to floor 0`);
|
|
96
|
+
return 0;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* Classifies a `bd show <id> --json` probe failure (apra-fleet-btj9.6) into
|
|
102
|
+
* one of two outcomes, so the collision guard above can tell a genuine "the
|
|
103
|
+
* id is free" result apart from "the probe itself could not be evaluated":
|
|
104
|
+
*
|
|
105
|
+
* - 'absent': the thrown error's payload positively matches bd's documented
|
|
106
|
+
* no-such-issue shape (`{"error": "no issues found matching the provided
|
|
107
|
+
* IDs", ...}`). This is the ordinary,
|
|
108
|
+
* expected outcome of probing a genuinely free id.
|
|
109
|
+
* - 'unknown': anything else -- unparseable output, a differently-shaped
|
|
110
|
+
* error payload, a transport/dispatch fault. The caller MUST fail closed
|
|
111
|
+
* on this outcome rather than assume the id is free.
|
|
112
|
+
*
|
|
113
|
+
* Reads `probeErr.details.text` first (the raw stdout a typed CommandError
|
|
114
|
+
* carries, see packages/apra-fleet-workflow/src/workflow/errors.mjs) and
|
|
115
|
+
* falls back to `probeErr.message` (which production's FleetWorkflow.command()
|
|
116
|
+
* also embeds the same raw stdout into, e.g. `Exit code 1: {...}`) for
|
|
117
|
+
* callers/fakes that only ever throw a plain Error.
|
|
118
|
+
*
|
|
119
|
+
* @param {Error} probeErr
|
|
120
|
+
* @returns {'absent'|'unknown'}
|
|
121
|
+
*/
|
|
122
|
+
export function classifyBdShowProbeError(probeErr) {
|
|
123
|
+
const text = (probeErr && probeErr.details && typeof probeErr.details.text === 'string')
|
|
124
|
+
? probeErr.details.text
|
|
125
|
+
: (probeErr && typeof probeErr.message === 'string' ? probeErr.message : '');
|
|
126
|
+
const match = text.match(/\{[\s\S]*\}/);
|
|
127
|
+
if (match) {
|
|
128
|
+
try {
|
|
129
|
+
const parsed = JSON.parse(match[0]);
|
|
130
|
+
if (parsed && typeof parsed.error === 'string' && /no issues found/i.test(parsed.error)) {
|
|
131
|
+
return 'absent';
|
|
132
|
+
}
|
|
133
|
+
} catch {
|
|
134
|
+
// Not JSON, or not the expected shape -- fall through to unknown.
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
return 'unknown';
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* The probe-and-refuse half of the explicit-id collision guard, extracted
|
|
142
|
+
* (apra-fleet-btj9.7) out of createChildBeadWithAllocatedId's inline block so
|
|
143
|
+
* it is a single reusable, exported seam rather than logic private to that one
|
|
144
|
+
* function. bd refuses a `bd create --id <id>` whose id is already held by a
|
|
145
|
+
* bead (open OR closed); this probe is an early, explicit check that names
|
|
146
|
+
* the occupying bead's status before any create is dispatched. It probes for
|
|
147
|
+
* an existing bead at `childId` and throws (tagging the error's
|
|
148
|
+
* `probeOutcome`) rather than let the caller dispatch a create that cannot
|
|
149
|
+
* succeed:
|
|
150
|
+
*
|
|
151
|
+
* - ABSENT (the common, expected case): resolves normally, no throw.
|
|
152
|
+
* - PRESENT: throws, naming the existing bead's status.
|
|
153
|
+
* - UNKNOWN (the probe itself could not be evaluated -- unparseable output,
|
|
154
|
+
* an unrecognized error payload, a transport/dispatch fault): throws,
|
|
155
|
+
* FAILING CLOSED rather than assuming the id is free (apra-fleet-btj9.6).
|
|
156
|
+
*
|
|
157
|
+
* Does NOT touch the allocator reservation itself (release/confirm) -- that
|
|
158
|
+
* stays the caller's responsibility, exactly as it was before extraction, so
|
|
159
|
+
* a future caller with a different reservation lifecycle can reuse this probe
|
|
160
|
+
* without inheriting allocator-specific side effects.
|
|
161
|
+
*
|
|
162
|
+
* @param {{ command: Function, member: string, childId: string, parentId: string }} opts
|
|
163
|
+
* @returns {Promise<void>}
|
|
164
|
+
*/
|
|
165
|
+
export async function assertChildIdFree({ command, member, childId, parentId }) {
|
|
166
|
+
const probeLabel = `bd show ${childId} --json`;
|
|
167
|
+
let existing = null;
|
|
168
|
+
try {
|
|
169
|
+
const raw = await command(probeLabel, { member_name: member, silent: true });
|
|
170
|
+
const beads = parseBdJson(raw, probeLabel);
|
|
171
|
+
const list = Array.isArray(beads) ? beads : (beads ? [beads] : []);
|
|
172
|
+
existing = list.find((b) => b && b.id === childId) || null;
|
|
173
|
+
} catch (probeErr) {
|
|
174
|
+
// `bd show <missing-id> --json` does NOT yield `[]` -- it exits non-zero and
|
|
175
|
+
// prints `{"error": "no issues found matching the provided IDs",
|
|
176
|
+
// "schema_version": 1}`. So the free-id case (the common, expected
|
|
177
|
+
// outcome of this probe) always lands here, indistinguishable at
|
|
178
|
+
// the throw site alone from a genuine dispatch fault. Classify the
|
|
179
|
+
// catch into ABSENT (bd positively reported no such issue -- proceed)
|
|
180
|
+
// vs UNKNOWN (anything else -- the probe could not be evaluated).
|
|
181
|
+
//
|
|
182
|
+
// FleetWorkflow.command() (packages/apra-fleet-workflow/src/workflow
|
|
183
|
+
// /index.mjs _commandDispatch) DOES surface the child process's raw
|
|
184
|
+
// stdout on a non-zero exit: a typed CommandError carries it on
|
|
185
|
+
// `.details.text`, and its `.message` also embeds it (`Exit code N:
|
|
186
|
+
// ${outText}`). That makes option 1 (parse the error payload)
|
|
187
|
+
// implementable, so it is used here rather than the parent-listing
|
|
188
|
+
// probe alternative.
|
|
189
|
+
const outcome = classifyBdShowProbeError(probeErr);
|
|
190
|
+
if (outcome === 'absent') {
|
|
191
|
+
// The id is free -- the common path. Stay fast and non-noisy:
|
|
192
|
+
// no log line, proceed to create exactly as before.
|
|
193
|
+
existing = null;
|
|
194
|
+
} else {
|
|
195
|
+
// UNKNOWN: the probe itself could not be evaluated (unparseable
|
|
196
|
+
// or unrecognized error payload, e.g. a transient dispatch
|
|
197
|
+
// fault). FAIL CLOSED rather than assume the id is free.
|
|
198
|
+
const err = new Error(
|
|
199
|
+
`[id-allocator] refusing to create child bead at id '${childId}': the collision probe could not be ` +
|
|
200
|
+
`evaluated (${probeErr.message}) -- treating as UNKNOWN, not a confirmed-free id; not creating at an id ` +
|
|
201
|
+
'that may be occupied.',
|
|
202
|
+
);
|
|
203
|
+
err.probeOutcome = 'unknown';
|
|
204
|
+
throw err;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
if (existing) {
|
|
208
|
+
const err = new Error(
|
|
209
|
+
`[id-allocator] refusing to create child bead at id '${childId}': a bead with that id already exists ` +
|
|
210
|
+
`(status: ${existing.status ?? 'unknown'}); a 'bd create --id' on that id cannot succeed.`,
|
|
211
|
+
);
|
|
212
|
+
err.probeOutcome = 'present';
|
|
213
|
+
throw err;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/**
|
|
218
|
+
* Create a child bead under `parentId` using an allocator-minted,
|
|
219
|
+
* collision-free explicit id. This is the single bead-creation seam every
|
|
220
|
+
* proposed newTask flows through, so that two concurrent sprints never mint
|
|
221
|
+
* the same child id.
|
|
222
|
+
*
|
|
223
|
+
* Sequence (mirrors the allocator's reserve -> confirm/release contract):
|
|
224
|
+
* 1. allocate() reserves the next distinct child id under the shared parent.
|
|
225
|
+
* 1a. Explicit-id path only: probe (`bd show <childId> --json`) that no bead
|
|
226
|
+
* already holds that id (bd itself refuses a duplicate --id; the probe
|
|
227
|
+
* just names the occupant before dispatching). An occupied id -- or one the
|
|
228
|
+
* probe cannot evaluate -- is CONSUMED (confirm()ed, never re-pooled: a
|
|
229
|
+
* re-pooled occupied id is re-minted every round, GitHub #615) and the
|
|
230
|
+
* sequence retries with a freshly allocated id.
|
|
231
|
+
* 2. `bd create` runs with `--id <childId>` (or, under the null client where
|
|
232
|
+
* childId is null, lets bd derive the id from `--parent`).
|
|
233
|
+
* 3. confirm() as soon as `bd create` lands (the id is now durably used --
|
|
234
|
+
* release() from here on would hand out an id that is genuinely
|
|
235
|
+
* occupied, apra-fleet-btj9.2). release() only fires for a failure
|
|
236
|
+
* BEFORE `bd create` is dispatched (staging the description), when the
|
|
237
|
+
* id is certainly still free. Once the create was dispatched, a failure
|
|
238
|
+
* (e.g. bd refusing a duplicate --id, or a transport fault that may hide
|
|
239
|
+
* a create that landed) leaves the id CONSUMED -- confirm()ed, never
|
|
240
|
+
* re-pooled -- and the whole sequence retries with a freshly allocated
|
|
241
|
+
* id, up to CHILD_CREATE_MAX_ATTEMPTS dispatches (GitHub #615). confirm()
|
|
242
|
+
* ITSELF can fail (allocator transport fault, apra-fleet-btj9.5); that
|
|
243
|
+
* failure is caught (never released -- the bead already exists) and
|
|
244
|
+
* reported via a distinct orphan-naming error after step 4 runs.
|
|
245
|
+
* 4. On the explicit-id path only, a follow-up `bd update <childId> --parent
|
|
246
|
+
* <parentId>` establishes the real parent edge, attempted regardless of
|
|
247
|
+
* whether confirm() in step 3 failed. A failure here does NOT release
|
|
248
|
+
* the reservation (the bead already exists) -- it throws a distinct
|
|
249
|
+
* "created but UNLINKED" error naming the orphan id so an operator can
|
|
250
|
+
* re-link it, rather than leaving the id allocator's next probe hit a
|
|
251
|
+
* confusing already-exists refusal. If step 3's confirm() ALSO failed,
|
|
252
|
+
* that failure is reported instead (with the link outcome folded in),
|
|
253
|
+
* never masked by this one.
|
|
254
|
+
*
|
|
255
|
+
* `bd create` REJECTS `--id` and `--parent` together, so on the explicit-id
|
|
256
|
+
* path `--parent` must be dropped: the allocator's `${parentId}.${seq}` id
|
|
257
|
+
* shape already encodes the hierarchy. A dotted id alone does NOT record the
|
|
258
|
+
* explicit parent edge, which is what the separate `bd update --parent`
|
|
259
|
+
* supplies; that link step is deliberately NOT best-effort -- a failure
|
|
260
|
+
* throws and degrades loudly rather than leaving an edgeless child, but
|
|
261
|
+
* (unlike the create step) it does NOT release the reservation, because by
|
|
262
|
+
* that point the bead genuinely exists at the allocated id.
|
|
263
|
+
*
|
|
264
|
+
* @param {{
|
|
265
|
+
* command: Function, allocator: { allocate: Function, confirm: Function, release: Function },
|
|
266
|
+
* member: string, title: string, description: string, priority: string,
|
|
267
|
+
* parentId: string, sprintId?: string, floor?: number, label?: string,
|
|
268
|
+
* log?: Function,
|
|
269
|
+
* }} opts
|
|
270
|
+
* @returns {Promise<{ childId: string|null }>}
|
|
271
|
+
*/
|
|
272
|
+
export async function createChildBeadWithAllocatedId(opts) {
|
|
273
|
+
const { maxAttempts = CHILD_CREATE_MAX_ATTEMPTS } = opts;
|
|
274
|
+
const attempts = Number.isInteger(maxAttempts) && maxAttempts >= 1 ? maxAttempts : CHILD_CREATE_MAX_ATTEMPTS;
|
|
275
|
+
const shared = { descriptionFile: null };
|
|
276
|
+
const consumedIds = [];
|
|
277
|
+
for (let attempt = 1; ; attempt += 1) {
|
|
278
|
+
const outcome = await createChildBeadAttempt(opts, shared, attempt, attempts);
|
|
279
|
+
if (outcome.created) return outcome.result;
|
|
280
|
+
// The attempt's id is consumed (occupied, unprobeable, or its create
|
|
281
|
+
// was dispatched and failed -- see createChildBeadAttempt). A failed
|
|
282
|
+
// create may still have LANDED behind the error (a transport fault
|
|
283
|
+
// after bd wrote the row): if the id now holds a bead with this very
|
|
284
|
+
// title, adopt it rather than create a duplicate under a fresh id.
|
|
285
|
+
if (outcome.phase === 'create' && outcome.childId) {
|
|
286
|
+
const adopted = await adoptLandedChild(opts, outcome.childId);
|
|
287
|
+
if (adopted) return adopted;
|
|
288
|
+
}
|
|
289
|
+
// Retry with a freshly allocated id while attempts remain; the
|
|
290
|
+
// null-allocator path (bd-derived id) never retries, since a fresh
|
|
291
|
+
// "allocation" there is the same request.
|
|
292
|
+
consumedIds.push(outcome.childId);
|
|
293
|
+
if (outcome.childId && attempt < attempts) continue;
|
|
294
|
+
if (attempt === 1) {
|
|
295
|
+
if (outcome.childId) outcome.error.consumedIds = [...consumedIds];
|
|
296
|
+
throw outcome.error;
|
|
297
|
+
}
|
|
298
|
+
const err = new Error(
|
|
299
|
+
`[id-allocator] creating a child under parent '${opts.parentId}' failed on all ${attempt} attempts ` +
|
|
300
|
+
`(consumed ids, never re-pooled: ${consumedIds.join(', ')}); last error: ${outcome.error.message}`,
|
|
301
|
+
);
|
|
302
|
+
err.consumedIds = [...consumedIds];
|
|
303
|
+
throw err;
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
/**
|
|
308
|
+
* A description as compared for adoption: line endings unified, trailing
|
|
309
|
+
* whitespace per line and surrounding blank space dropped, so bd's own
|
|
310
|
+
* whitespace handling of the staged body never defeats the match.
|
|
311
|
+
* @param {unknown} text
|
|
312
|
+
* @returns {string}
|
|
313
|
+
*/
|
|
314
|
+
function normalizeBodyForCompare(text) {
|
|
315
|
+
return String(text ?? '')
|
|
316
|
+
.replace(/\r\n?/g, '\n')
|
|
317
|
+
.split('\n')
|
|
318
|
+
.map((l) => l.replace(/[ \t]+$/, ''))
|
|
319
|
+
.join('\n')
|
|
320
|
+
.trim();
|
|
321
|
+
}
|
|
322
|
+
|
|
323
|
+
/**
|
|
324
|
+
* After a dispatched `bd create --id <childId>` reported failure: if the bead
|
|
325
|
+
* nevertheless exists at that id with the same title AND description, the create landed --
|
|
326
|
+
* link it under the parent and return it, so the retry does not mint a
|
|
327
|
+
* duplicate. Any probe failure means "not landed" (retry as normal).
|
|
328
|
+
* @returns {Promise<{ childId: string }|null>}
|
|
329
|
+
*/
|
|
330
|
+
async function adoptLandedChild(opts, childId) {
|
|
331
|
+
const { command, member, title, parentId, log = () => {} } = opts;
|
|
332
|
+
const probeLabel = `bd show ${childId} --json`;
|
|
333
|
+
let existing = null;
|
|
334
|
+
try {
|
|
335
|
+
const raw = await command(probeLabel, { member_name: member, silent: true });
|
|
336
|
+
const beads = parseBdJson(raw, probeLabel);
|
|
337
|
+
const list = Array.isArray(beads) ? beads : (beads ? [beads] : []);
|
|
338
|
+
existing = list.find((b) => b && b.id === childId) || null;
|
|
339
|
+
} catch {
|
|
340
|
+
return null;
|
|
341
|
+
}
|
|
342
|
+
if (!existing || existing.title !== title) return null;
|
|
343
|
+
// Title alone is not proof it is OUR create (a reviewer can repeat a
|
|
344
|
+
// title across findings): the body must match too.
|
|
345
|
+
if (normalizeBodyForCompare(existing.description) !== normalizeBodyForCompare(opts.description)) {
|
|
346
|
+
log(`[id-allocator] '${childId}' holds a bead with this title but a different description; not adopting it -- the id stays consumed and a fresh id is tried`);
|
|
347
|
+
return null;
|
|
348
|
+
}
|
|
349
|
+
log(`[id-allocator] bd create for '${childId}' reported failure but the bead landed with this title and description; adopting it instead of creating a duplicate`);
|
|
350
|
+
try {
|
|
351
|
+
await command(
|
|
352
|
+
`bd update ${childId} --parent ${parentId}`,
|
|
353
|
+
{ member_name: member, silent: true, label: `Link follow-up task ${childId} under ${parentId}` }
|
|
354
|
+
);
|
|
355
|
+
} catch (err) {
|
|
356
|
+
throw new Error(
|
|
357
|
+
`[id-allocator] child bead '${childId}' was created but is UNLINKED under parent '${parentId}': ` +
|
|
358
|
+
`the follow-up 'bd update ${childId} --parent ${parentId}' failed (${err.message}). The id is ` +
|
|
359
|
+
'genuinely in use -- re-link it manually rather than retrying newTask under this parent.',
|
|
360
|
+
);
|
|
361
|
+
}
|
|
362
|
+
return { childId };
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
/**
|
|
366
|
+
* How many `bd create` dispatches createChildBeadWithAllocatedId makes for one
|
|
367
|
+
* newTask before giving up -- each with a freshly allocated id (GitHub #615).
|
|
368
|
+
*/
|
|
369
|
+
export const CHILD_CREATE_MAX_ATTEMPTS = 3;
|
|
370
|
+
|
|
371
|
+
/**
|
|
372
|
+
* One allocate -> probe -> stage -> create -> confirm/link attempt.
|
|
373
|
+
* Resolves `{ created: true, result }` on success or `{ created: false,
|
|
374
|
+
* childId, error, phase }` when the id proved unusable (phase 'probe') or the
|
|
375
|
+
* `bd create` dispatch failed (phase 'create'); the caller may retry. Every
|
|
376
|
+
* other failure throws.
|
|
377
|
+
*/
|
|
378
|
+
async function createChildBeadAttempt(opts, shared, attempt, attempts) {
|
|
379
|
+
const { command, allocator, member, title, description, priority, parentId, sprintId, floor, label, log = () => {} } = opts;
|
|
380
|
+
const grant = await allocator.allocate(parentId, { pid: process.pid, sprintId, floor });
|
|
381
|
+
// The explicit-id path relies on the allocator's `${parentId}.${seq}` id
|
|
382
|
+
// shape to carry the hierarchy that `--parent` can no longer carry
|
|
383
|
+
// alongside `--id` (see the doc comment above). Fail loudly rather than
|
|
384
|
+
// create a child whose id does not place it under this parent at all.
|
|
385
|
+
if (grant.childId && !String(grant.childId).startsWith(`${parentId}.`)) {
|
|
386
|
+
await allocator.release(grant.token);
|
|
387
|
+
throw new Error(
|
|
388
|
+
`[id-allocator] allocated child id '${grant.childId}' is not a child of parent '${parentId}' ` +
|
|
389
|
+
'(expected the `<parentId>.<seq>` shape); released the reservation rather than creating an unparented bead',
|
|
390
|
+
);
|
|
391
|
+
}
|
|
392
|
+
// Collision guard: bd refuses `bd create --id <childId>` when a bead (open
|
|
393
|
+
// OR closed) already holds that id, so the probe below is an early,
|
|
394
|
+
// explicit refusal naming the occupant rather than the only guard.
|
|
395
|
+
// The allocator should never hand back an in-use id, but a crashed/partial
|
|
396
|
+
// prior run, a stale persisted high-water, or a manually-created bead can
|
|
397
|
+
// leave one occupied. So on the explicit-id path only, probe for an existing
|
|
398
|
+
// bead at that id FIRST via the shared assertChildIdFree() seam (apra-fleet-
|
|
399
|
+
// btj9.7). A PRESENT or UNKNOWN probe consumes the id (never re-pooled --
|
|
400
|
+
// computeChildFloor can miss unlinked children or fall back to floor 0, so
|
|
401
|
+
// a released occupied id would be re-minted every round) and the caller
|
|
402
|
+
// retries with a fresh id; a gap in the sequence costs nothing. The null-allocator path (`bd create --parent`) lets bd mint a
|
|
403
|
+
// fresh id natively and never collides, so it needs no probe.
|
|
404
|
+
if (grant.childId) {
|
|
405
|
+
try {
|
|
406
|
+
await assertChildIdFree({ command, member, childId: grant.childId, parentId });
|
|
407
|
+
} catch (probeErr) {
|
|
408
|
+
try {
|
|
409
|
+
await allocator.confirm(grant.token);
|
|
410
|
+
} catch (confirmErr) {
|
|
411
|
+
log(`[id-allocator] could not mark '${grant.childId}' consumed after its collision probe (${confirmErr.message}); its lease will lapse instead`);
|
|
412
|
+
}
|
|
413
|
+
const willRetry = attempt < attempts;
|
|
414
|
+
log(
|
|
415
|
+
`[id-allocator] '${grant.childId}' is not usable (probe: ${probeErr.probeOutcome || 'unknown'}, attempt ${attempt}/${attempts}); ` +
|
|
416
|
+
`id consumed (never re-pooled)${willRetry ? '; retrying with a freshly allocated id' : ''}: ${probeErr.message}`,
|
|
417
|
+
);
|
|
418
|
+
return { created: false, childId: grant.childId, error: probeErr, phase: 'probe' };
|
|
419
|
+
}
|
|
420
|
+
}
|
|
421
|
+
// `bd create` refuses `--id` together with `--parent`: carry EITHER the
|
|
422
|
+
// allocator-minted explicit id (hierarchy encoded in the id, parent edge
|
|
423
|
+
// linked immediately after the create) OR `--parent` and let bd derive the
|
|
424
|
+
// id (null-allocator path).
|
|
425
|
+
const parentageFlags = grant.childId ? `--id ${grant.childId}` : `--parent ${parentId}`;
|
|
426
|
+
// The description is LLM-authored free text: stage it to a member-local
|
|
427
|
+
// temp file (see stageCommandBodyMemberSide) and hand THAT path to `bd
|
|
428
|
+
// create --body-file` rather than interpolating it into the shell command
|
|
429
|
+
// string. Only `title` (short, allowlist-validated by validateNewTask)
|
|
430
|
+
// remains inline.
|
|
431
|
+
// Staged once and reused by every retry attempt.
|
|
432
|
+
if (shared.descriptionFile === null) {
|
|
433
|
+
try {
|
|
434
|
+
shared.descriptionFile = await stageCommandBodyMemberSide({
|
|
435
|
+
command, member, content: description,
|
|
436
|
+
label: `Stage newTask description for '${title}'`,
|
|
437
|
+
});
|
|
438
|
+
} catch (err) {
|
|
439
|
+
// Nothing was sent to bd yet, so the id is certainly still free:
|
|
440
|
+
// return it to the pool (no permanent gap), then re-throw.
|
|
441
|
+
await allocator.release(grant.token);
|
|
442
|
+
log(`[id-allocator] staging the newTask description failed before bd create was dispatched for '${grant.childId ?? '(bd-derived)'}'; released reservation: ${err.message}`);
|
|
443
|
+
throw err;
|
|
444
|
+
}
|
|
445
|
+
}
|
|
446
|
+
try {
|
|
447
|
+
await command(
|
|
448
|
+
`bd create "${title}" --body-file "${shared.descriptionFile}" -p "${priority}" ${parentageFlags} --silent`,
|
|
449
|
+
{ member_name: member, silent: true, label: label ?? `Create follow-up task: ${title}` }
|
|
450
|
+
);
|
|
451
|
+
} catch (err) {
|
|
452
|
+
// The create WAS dispatched. A failure here does not prove the id is
|
|
453
|
+
// free: bd refuses a duplicate --id (the id is then occupied by some
|
|
454
|
+
// other bead), and a transport fault can hide a create that landed.
|
|
455
|
+
// So never return this id to the pool -- re-pooling an occupied id is
|
|
456
|
+
// what made it re-minted every round and across sprints (GitHub
|
|
457
|
+
// #615). Consume it instead (confirm, so a lease-expiry reclaim
|
|
458
|
+
// cannot re-pool it either) and let the caller retry with a fresh id.
|
|
459
|
+
if (grant.childId) {
|
|
460
|
+
try {
|
|
461
|
+
await allocator.confirm(grant.token);
|
|
462
|
+
} catch (confirmErr) {
|
|
463
|
+
log(`[id-allocator] could not mark '${grant.childId}' consumed after its failed bd create (${confirmErr.message}); its lease will lapse instead`);
|
|
464
|
+
}
|
|
465
|
+
} else {
|
|
466
|
+
// Null-allocator path: bd derives the id, the allocator holds nothing.
|
|
467
|
+
await allocator.release(grant.token);
|
|
468
|
+
}
|
|
469
|
+
const willRetry = Boolean(grant.childId) && attempt < attempts;
|
|
470
|
+
log(
|
|
471
|
+
`[id-allocator] bd create failed for '${grant.childId ?? '(bd-derived)'}' (attempt ${attempt}/${attempts}); ` +
|
|
472
|
+
`${grant.childId ? 'id stays consumed (never re-pooled)' : 'no allocator id involved'}` +
|
|
473
|
+
`${willRetry ? '; retrying with a freshly allocated id' : ''}: ${err.message}`,
|
|
474
|
+
);
|
|
475
|
+
return { created: false, childId: grant.childId ?? null, error: err, phase: 'create' };
|
|
476
|
+
}
|
|
477
|
+
// The create landed locally -- durably commit the id BEFORE the D-push, so a
|
|
478
|
+
// crash after this point can never reclaim an id that now genuinely exists.
|
|
479
|
+
// From here on the reservation MUST stay confirmed: the bead already
|
|
480
|
+
// exists at grant.childId (or bd's own derived id), so releasing it back
|
|
481
|
+
// to the pool after this point would hand out an id that is genuinely
|
|
482
|
+
// occupied -- the exact collision assertChildIdFree exists to refuse
|
|
483
|
+
// (apra-fleet-btj9.2).
|
|
484
|
+
//
|
|
485
|
+
// confirm() itself can fail (an HTTP allocator route erroring, an MCP
|
|
486
|
+
// transport fault, a supervisor restart) -- apra-fleet-btj9.5. That
|
|
487
|
+
// failure sits OUTSIDE any release-on-failure try/catch, by design: the
|
|
488
|
+
// bead already exists at this id, so release() must NEVER fire here,
|
|
489
|
+
// exactly as for a link failure below. Capture the error instead of
|
|
490
|
+
// letting it propagate raw, so the caller gets an orphan-naming message
|
|
491
|
+
// rather than a bare transport-fault string with no indication that a
|
|
492
|
+
// child bead now exists, is possibly unlinked, and may not be durably
|
|
493
|
+
// confirmed in the allocator's own state.
|
|
494
|
+
let confirmError = null;
|
|
495
|
+
try {
|
|
496
|
+
await allocator.confirm(grant.token);
|
|
497
|
+
} catch (err) {
|
|
498
|
+
confirmError = err;
|
|
499
|
+
log(`[id-allocator] bd create landed for '${grant.childId ?? '(bd-derived)'}' but allocator.confirm() failed; reservation stays UNRELEASED (the id is genuinely in use) but may not be durably confirmed in the allocator's own state: ${err.message}`);
|
|
500
|
+
}
|
|
501
|
+
// Explicit-id path only: record the real parent edge that `--parent`
|
|
502
|
+
// would have recorded, had bd allowed it on the same create. Deliberately
|
|
503
|
+
// OUTSIDE the create's release-on-failure try/catch above: a failure here
|
|
504
|
+
// must not release grant.token (the id is already in use, not free) and
|
|
505
|
+
// must not be conflated with the create's own failure. Throw a distinct,
|
|
506
|
+
// orphan-naming error instead so an operator can re-link rather than hit
|
|
507
|
+
// an inexplicable id-already-exists refusal on the next newTask under
|
|
508
|
+
// this parent.
|
|
509
|
+
//
|
|
510
|
+
// DECISION (apra-fleet-btj9.5): the link is attempted even when confirm()
|
|
511
|
+
// above already failed. confirm() talks to the id-allocator's own
|
|
512
|
+
// bookkeeping (HTTP/MCP transport); the link is a separate `bd update`
|
|
513
|
+
// dispatch against bd itself, and a fault in the former says nothing
|
|
514
|
+
// about whether the latter would also fail -- attempting it anyway means
|
|
515
|
+
// a transient confirm blip does not ALSO cost the parent edge. If the
|
|
516
|
+
// link then also fails, the confirm failure is still reported (it is the
|
|
517
|
+
// more actionable signal: durable allocator state is what guards against
|
|
518
|
+
// a future re-mint) with the link outcome folded into the SAME message,
|
|
519
|
+
// rather than thrown separately, so the confirm failure is never masked
|
|
520
|
+
// by a later link error.
|
|
521
|
+
let linkError = null;
|
|
522
|
+
if (grant.childId) {
|
|
523
|
+
try {
|
|
524
|
+
await command(
|
|
525
|
+
`bd update ${grant.childId} --parent ${parentId}`,
|
|
526
|
+
{ member_name: member, silent: true, label: `Link follow-up task ${grant.childId} under ${parentId}` }
|
|
527
|
+
);
|
|
528
|
+
} catch (err) {
|
|
529
|
+
linkError = err;
|
|
530
|
+
log(`[id-allocator] bd create landed for '${grant.childId}' but the follow-up bd update --parent link failed; reservation stays confirmed (the id is genuinely in use): ${err.message}`);
|
|
531
|
+
}
|
|
532
|
+
}
|
|
533
|
+
if (confirmError) {
|
|
534
|
+
const idLabel = grant.childId ?? '(bd-derived id, unknown to the allocator)';
|
|
535
|
+
throw new Error(
|
|
536
|
+
`[id-allocator] child bead '${idLabel}' was created but allocator.confirm() FAILED: ${confirmError.message}. ` +
|
|
537
|
+
`The bead exists at that id and is ${linkError ? 'also UNLINKED from' : 'linked under'} parent '${parentId}', ` +
|
|
538
|
+
"and the reservation may not be durably confirmed in the allocator's own state -- do NOT release this id; " +
|
|
539
|
+
'investigate the allocator directly rather than retrying newTask under this parent.' +
|
|
540
|
+
(linkError ? ` (the follow-up parent-link dispatch also failed: ${linkError.message})` : ''),
|
|
541
|
+
);
|
|
542
|
+
}
|
|
543
|
+
if (linkError) {
|
|
544
|
+
throw new Error(
|
|
545
|
+
`[id-allocator] child bead '${grant.childId}' was created but is UNLINKED under parent '${parentId}': ` +
|
|
546
|
+
`the follow-up 'bd update ${grant.childId} --parent ${parentId}' failed (${linkError.message}). The id is ` +
|
|
547
|
+
'genuinely in use -- re-link it manually rather than retrying newTask under this parent.',
|
|
548
|
+
);
|
|
549
|
+
}
|
|
550
|
+
return { created: true, result: { childId: grant.childId ?? null } };
|
|
551
|
+
}
|
|
552
|
+
|
|
553
|
+
/**
|
|
554
|
+
* The orchestrator's post-streak verification read, with its mandatory
|
|
555
|
+
* D-pull. A remote doer closes its assigned beads in its OWN clone and
|
|
556
|
+
* D-pushes them, so the orchestrator MUST D-pull its own clone BEFORE the `bd
|
|
557
|
+
* show` -- otherwise it reads stale (still-open) status and falsely reports
|
|
558
|
+
* every remote doer streak as FAILED.
|
|
559
|
+
*
|
|
560
|
+
* Returns the ids that are NOT closed after the D-pull-then-read. An empty
|
|
561
|
+
* array means the streak genuinely closed everything it was assigned.
|
|
562
|
+
*
|
|
563
|
+
* @param {{ command: Function, backlogMember: string, beadIds: string[], log?: Function, args?: { callTool?: Function }, sprintState?: object }} opts
|
|
564
|
+
* @returns {Promise<string[]>} the still-unclosed bead ids
|
|
565
|
+
*/
|
|
566
|
+
export async function verifyDoerStreakClosed({ command, backlogMember, beadIds, log = () => {}, args, sprintState }) {
|
|
567
|
+
// D-pull FIRST so the orchestrator's clone observes the doer's just-pushed
|
|
568
|
+
// closes. Routed through the single dolt-sync module's purpose-based BEFORE
|
|
569
|
+
// bracket (apra-fleet-417.2.1); behavior is identical to the previous
|
|
570
|
+
// direct doltPullBefore() call.
|
|
571
|
+
// Thread the backlog member's REGISTERED shell into dolt-settle,
|
|
572
|
+
// guarded on args.callTool the same way the pre-dispatch bracket is
|
|
573
|
+
// (apra-fleet-7dir.24).
|
|
574
|
+
const shell = await resolveSettleShell({ args, member: backlogMember, log, sprintState });
|
|
575
|
+
await DoltSync.syncBefore(backlogMember, { command, log, fatal: true, settle: buildSettleCallback(backlogMember, { command, log, shell }) });
|
|
576
|
+
const label = `bd show ${beadIds.join(' ')} --json`;
|
|
577
|
+
const showRes = await command(label, { member_name: backlogMember, silent: true });
|
|
578
|
+
const showBeads = parseBdJson(showRes, label);
|
|
579
|
+
const statusById = new Map(showBeads.map((b) => [b.id, b.status]));
|
|
580
|
+
return beadIds.filter((id) => statusById.get(id) !== 'closed');
|
|
581
|
+
}
|
|
582
|
+
|
|
583
|
+
/**
|
|
584
|
+
* Batched per-streak work-claiming (apra-fleet-7h6n.7, audit R6): claims
|
|
585
|
+
* every id in `beadIds` with ONE `bd update <id...> --claim --json`
|
|
586
|
+
* invocation instead of one `bd update <id> --claim` call per bead.
|
|
587
|
+
*
|
|
588
|
+
* RESEARCH FINDING this batching relies on (verified against real `bd`,
|
|
589
|
+
* both by reading `bd update --help`'s `Usage: bd update [id...]`
|
|
590
|
+
* and by exercising a scratch sandbox DB): `bd update` DOES accept a
|
|
591
|
+
* variadic id list, and `--claim --json` on a MULTI-id invocation returns a
|
|
592
|
+
* JSON array containing ONLY the issues that were successfully claimed --
|
|
593
|
+
* an id that fails to resolve, or is already claimed by a DIFFERENT
|
|
594
|
+
* assignee, is silently dropped from the array (its error goes to stderr,
|
|
595
|
+
* not stdout) rather than aborting the whole call. Two non-obvious
|
|
596
|
+
* consequences, both load-bearing for this function's design:
|
|
597
|
+
* 1. This is NOT atomic in the transactional sense -- ids before a
|
|
598
|
+
* failing one are still committed, there is no all-or-nothing
|
|
599
|
+
* rollback. It IS enough to cut the streak's claim step from N
|
|
600
|
+
* subprocess spawns to 1, which is this bead's actual goal.
|
|
601
|
+
* 2. The process exit code stays 0 even when SOME ids in the batch
|
|
602
|
+
* failed to claim (verified: a lone failing id exits 1, but the exact
|
|
603
|
+
* same failure mixed into a multi-id batch with a succeeding id exits
|
|
604
|
+
* 0) -- so, unlike the old single-id-per-call loop, success can NEVER
|
|
605
|
+
* be inferred from "command() did not throw". The returned JSON array
|
|
606
|
+
* is the only reliable signal, which is why this function always
|
|
607
|
+
* diffs `beadIds` against the parsed array rather than relying on a
|
|
608
|
+
* catch block.
|
|
609
|
+
*
|
|
610
|
+
* A total call failure (command() itself throws -- e.g. a transient
|
|
611
|
+
* dispatch/network fault reaching the member) is treated the same way the
|
|
612
|
+
* old loop treated "every id failed": every id is reported skipped, never
|
|
613
|
+
* thrown, so one bad batch degrades the streak (all its beads stay
|
|
614
|
+
* unclaimed, caller decides whether to skip the streak) rather than
|
|
615
|
+
* crashing the sprint.
|
|
616
|
+
*
|
|
617
|
+
* @param {{ command: Function, backlogMember: string, beadIds: string[], log?: Function }} opts
|
|
618
|
+
* @returns {Promise<{ claimedBeadIds: string[], skippedBeadIds: string[] }>}
|
|
619
|
+
*/
|
|
620
|
+
export async function claimBeadsBatched({ command, backlogMember, beadIds, log = () => {} }) {
|
|
621
|
+
if (!Array.isArray(beadIds) || beadIds.length === 0) {
|
|
622
|
+
return { claimedBeadIds: [], skippedBeadIds: [] };
|
|
623
|
+
}
|
|
624
|
+
const label = `bd update ${beadIds.join(' ')} --claim --json`;
|
|
625
|
+
let raw;
|
|
626
|
+
try {
|
|
627
|
+
raw = await command(label, { member_name: backlogMember, silent: true });
|
|
628
|
+
} catch (err) {
|
|
629
|
+
// A dispatch/exec-level failure (member unreachable, transient
|
|
630
|
+
// network fault) degrades gracefully -- every id in this batch
|
|
631
|
+
// stays unclaimed, same as the old per-id loop's catch-and-skip.
|
|
632
|
+
// This is DISTINCT from a malformed-JSON parse failure below, which
|
|
633
|
+
// stays fatal (per parseBdJson's own doc comment: a parse failure
|
|
634
|
+
// must be LOUD, never silently swallowed as "everything skipped").
|
|
635
|
+
log(`Batched claim failed for [${beadIds.join(', ')}]: ${err.message}`);
|
|
636
|
+
return { claimedBeadIds: [], skippedBeadIds: [...beadIds] };
|
|
637
|
+
}
|
|
638
|
+
const claimed = parseBdJson(raw, label);
|
|
639
|
+
const claimedIds = new Set((Array.isArray(claimed) ? claimed : []).map((b) => b && b.id).filter(Boolean));
|
|
640
|
+
const claimedBeadIds = beadIds.filter((id) => claimedIds.has(id));
|
|
641
|
+
const skippedBeadIds = beadIds.filter((id) => !claimedIds.has(id));
|
|
642
|
+
if (skippedBeadIds.length > 0) {
|
|
643
|
+
log(`Batched claim: claimed ${claimedBeadIds.length} bead(s) [${claimedBeadIds.join(', ')}]; skipped ${skippedBeadIds.length} already-claimed/unresolvable bead(s) [${skippedBeadIds.join(', ')}].`);
|
|
644
|
+
}
|
|
645
|
+
return { claimedBeadIds, skippedBeadIds };
|
|
646
|
+
}
|