@apralabs/apra-fleet 0.4.3 → 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 +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- 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/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 +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- 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 +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +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.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- 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 +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- 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-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- 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/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 +54 -8
- 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/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 +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- 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 +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- 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 +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- 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 +53 -5
- package/dist/tools/check-status.js +210 -53
- 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 +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- 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 +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -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 +30 -10
- 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 +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +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/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- 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/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 +3 -3
- 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 +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- 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 +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- 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 +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,629 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- combined member + issue-scope reservation ledger
|
|
3
|
+
// (apra-fleet-eft.5.1, Plan Part 2.2)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// ONE combined, supervisor-owned ledger of every live sprint's reservations:
|
|
7
|
+
//
|
|
8
|
+
// reservations: {
|
|
9
|
+
// [sprintId]: { members, issueRoots, childPid, reservedAt, branch, base, goal }
|
|
10
|
+
// }
|
|
11
|
+
//
|
|
12
|
+
// apra-fleet-3i3.2: branch/base/goal are OPTIONAL launch metadata (persisted
|
|
13
|
+
// at claim() time, defaulting to null when omitted or absent from a
|
|
14
|
+
// pre-existing on-disk entry written before these fields existed) -- enough,
|
|
15
|
+
// together with the two reservation axes already stored, for a future
|
|
16
|
+
// Restart control to reconstruct the original POST /api/sprints request
|
|
17
|
+
// without operator re-entry. This module still does not know or care what a
|
|
18
|
+
// Restart DOES with them; it only stores and returns them like every other
|
|
19
|
+
// reservation field.
|
|
20
|
+
//
|
|
21
|
+
// The two reservation axes -- the member set and the issue-scope root ids -- are
|
|
22
|
+
// claimed and released in EXACT LOCKSTEP:
|
|
23
|
+
//
|
|
24
|
+
// * the SAME launch event claims members AND issueRoots,
|
|
25
|
+
// * the SAME terminal event releases BOTH,
|
|
26
|
+
// * in ONE atomic disk write, with ONE restart-reconciliation path.
|
|
27
|
+
//
|
|
28
|
+
// There is deliberately no separate "member ledger" and "issue ledger": a torn
|
|
29
|
+
// state where a sprint holds one axis but not the other is unrepresentable here.
|
|
30
|
+
//
|
|
31
|
+
// This module is pure storage + lockstep transactionality. Overlap DETECTION
|
|
32
|
+
// (member union all-or-nothing on POST /api/sprints, and live-expanded issue
|
|
33
|
+
// subtree recomputation) is layered on top by eft.5.2 / eft.5.3, which read this
|
|
34
|
+
// ledger via list()/get(). Restart PID-probe reconciliation (eft.5.4 / eft.4.5)
|
|
35
|
+
// likewise drives release() from the reloaded on-disk state.
|
|
36
|
+
//
|
|
37
|
+
// Atomicity guarantees (acceptance criteria):
|
|
38
|
+
// * claim() writes BOTH axes or NEITHER -- the in-memory reservation is
|
|
39
|
+
// committed only after the disk write succeeds, so an injected mid-write
|
|
40
|
+
// failure leaves the sprint entirely unreserved (not half-claimed).
|
|
41
|
+
// * The on-disk file is replaced atomically (temp file + rename), so a
|
|
42
|
+
// concurrent reader can never observe a torn/partial JSON document.
|
|
43
|
+
// * The ledger reloads EXACTLY from disk across a process restart.
|
|
44
|
+
//
|
|
45
|
+
// Intra-sprint memberLocks in fleet-sprint/runner.js is a DIFFERENT, orthogonal
|
|
46
|
+
// mechanism (role-level, within one sprint) and is intentionally left untouched.
|
|
47
|
+
// =============================================================================
|
|
48
|
+
|
|
49
|
+
import fsp from 'node:fs/promises';
|
|
50
|
+
import path from 'node:path';
|
|
51
|
+
import os from 'node:os';
|
|
52
|
+
|
|
53
|
+
import { renameWithRetry } from './rename-with-retry.mjs';
|
|
54
|
+
|
|
55
|
+
/** On-disk schema version for the persisted ledger document. */
|
|
56
|
+
export const LEDGER_VERSION = 1;
|
|
57
|
+
|
|
58
|
+
/** Default file name for the persisted ledger inside the service data dir. */
|
|
59
|
+
export const LEDGER_FILENAME = 'reservations.json';
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* The persisted-shape schema other eft.5 tasks build on. This is the contract
|
|
63
|
+
* for what claim()/release() write and what a restarted supervisor re-adopts.
|
|
64
|
+
*
|
|
65
|
+
* @typedef {object} Reservation
|
|
66
|
+
* @property {string[]} members Full member set reserved (union of members +
|
|
67
|
+
* every roleMap value incl. the backlog role).
|
|
68
|
+
* @property {string[]} issueRoots Root issue id(s) the sprint launched with;
|
|
69
|
+
* the identity key for the issue-scope axis.
|
|
70
|
+
* @property {number|null} childPid Detached child PID (for restart PID-probe
|
|
71
|
+
* reconciliation); null until known.
|
|
72
|
+
* @property {string} reservedAt ISO-8601 timestamp of the claim.
|
|
73
|
+
* @property {string|null} branch apra-fleet-3i3.2: the launch's `--branch`
|
|
74
|
+
* argv value, persisted so a Restart can
|
|
75
|
+
* reconstruct the original POST /api/sprints
|
|
76
|
+
* request without operator re-entry. Also
|
|
77
|
+
* (apra-fleet-k7b.2) the watchdog's
|
|
78
|
+
* hasTerminalState() fallback lookup key for
|
|
79
|
+
* a reservation claimed BEFORE k7b.1 shipped,
|
|
80
|
+
* whose terminal state (if any) was persisted
|
|
81
|
+
* under the pre-fix branch-keyed old_runs/
|
|
82
|
+
* filename, not this reservation's sprintId.
|
|
83
|
+
* Null for pre-existing on-disk entries
|
|
84
|
+
* written before this field existed.
|
|
85
|
+
* @property {string|null} base apra-fleet-3i3.2: the launch's `--base`
|
|
86
|
+
* argv value. Same null-for-legacy-entries
|
|
87
|
+
* contract as branch above.
|
|
88
|
+
* @property {string|null} goal apra-fleet-3i3.2: the launch's `--goal`
|
|
89
|
+
* argv value (undefined/omitted at launch
|
|
90
|
+
* normalizes to null, same as a legacy entry
|
|
91
|
+
* that predates this field).
|
|
92
|
+
* @property {number|null} exitCode apra-fleet-k7b.3: the detached child's own
|
|
93
|
+
* process 'exit' code, recorded by
|
|
94
|
+
* recordExit() the moment the SAME-instance
|
|
95
|
+
* spawner observes it exit; null until then
|
|
96
|
+
* (or forever, for an entry re-adopted after
|
|
97
|
+
* a restart with no in-memory exit listener).
|
|
98
|
+
* @property {string|null} signal apra-fleet-k7b.3: the signal that killed
|
|
99
|
+
* the child (e.g. 'SIGKILL'), or null if it
|
|
100
|
+
* exited normally / is unknown.
|
|
101
|
+
* @property {string|null} exitedAt apra-fleet-k7b.3: ISO-8601 timestamp of
|
|
102
|
+
* the recorded exit, or null until known.
|
|
103
|
+
* @property {string|null} logPath apra-fleet-ou7.1: path to this sprint's
|
|
104
|
+
* raw stdout/stderr log file (spawner.mjs's
|
|
105
|
+
* resolveSprintLogPath()), recorded at the
|
|
106
|
+
* SAME claim() call that sets childPid;
|
|
107
|
+
* null only for a reservation claimed
|
|
108
|
+
* before this field existed.
|
|
109
|
+
*
|
|
110
|
+
* @typedef {object} LedgerDocument
|
|
111
|
+
* @property {number} version Equals LEDGER_VERSION.
|
|
112
|
+
* @property {Record<string, Reservation>} reservations Keyed by sprintId.
|
|
113
|
+
* @property {string|null} [scopeFreshness.lastSyncedAt] ISO-8601 timestamp of
|
|
114
|
+
* the last successful bd sync,
|
|
115
|
+
* or null if never synced.
|
|
116
|
+
*/
|
|
117
|
+
export const LEDGER_SCHEMA = Object.freeze({
|
|
118
|
+
$id: 'apra-fleet-se/supervisor-reservation-ledger@1',
|
|
119
|
+
type: 'object',
|
|
120
|
+
required: ['version', 'reservations'],
|
|
121
|
+
additionalProperties: false,
|
|
122
|
+
properties: {
|
|
123
|
+
version: { const: LEDGER_VERSION },
|
|
124
|
+
reservations: {
|
|
125
|
+
type: 'object',
|
|
126
|
+
additionalProperties: {
|
|
127
|
+
type: 'object',
|
|
128
|
+
required: ['members', 'issueRoots', 'childPid', 'reservedAt'],
|
|
129
|
+
additionalProperties: false,
|
|
130
|
+
properties: {
|
|
131
|
+
members: { type: 'array', items: { type: 'string' } },
|
|
132
|
+
issueRoots: { type: 'array', items: { type: 'string' } },
|
|
133
|
+
childPid: { type: ['integer', 'null'] },
|
|
134
|
+
reservedAt: { type: 'string' },
|
|
135
|
+
// apra-fleet-3i3.2 / apra-fleet-k7b.2: optional launch
|
|
136
|
+
// metadata, persisted so a Restart can reconstruct the
|
|
137
|
+
// original POST /api/sprints request, and so the watchdog
|
|
138
|
+
// has a fallback branch-keyed lookup key. NOT in
|
|
139
|
+
// `required` -- a pre-existing on-disk entry written
|
|
140
|
+
// before this field existed must still load
|
|
141
|
+
// (normalizeReservation() below defaults each to null).
|
|
142
|
+
branch: { type: ['string', 'null'] },
|
|
143
|
+
base: { type: ['string', 'null'] },
|
|
144
|
+
goal: { type: ['string', 'null'] },
|
|
145
|
+
// apra-fleet-k7b.3: optional (not in `required`) so a
|
|
146
|
+
// ledger file persisted before this field existed still
|
|
147
|
+
// loads -- normalizeReservation() below defaults every
|
|
148
|
+
// one of these to null when absent.
|
|
149
|
+
exitCode: { type: ['integer', 'null'] },
|
|
150
|
+
signal: { type: ['string', 'null'] },
|
|
151
|
+
exitedAt: { type: ['string', 'null'] },
|
|
152
|
+
// apra-fleet-ou7.1: same optional/null-defaulted convention.
|
|
153
|
+
logPath: { type: ['string', 'null'] },
|
|
154
|
+
},
|
|
155
|
+
},
|
|
156
|
+
},
|
|
157
|
+
scopeFreshness: {
|
|
158
|
+
type: 'object',
|
|
159
|
+
additionalProperties: false,
|
|
160
|
+
properties: {
|
|
161
|
+
lastSyncedAt: { type: ['string', 'null'] },
|
|
162
|
+
},
|
|
163
|
+
},
|
|
164
|
+
},
|
|
165
|
+
});
|
|
166
|
+
|
|
167
|
+
/** An empty, well-formed ledger document. */
|
|
168
|
+
export function emptyLedgerDocument() {
|
|
169
|
+
return { version: LEDGER_VERSION, reservations: {}, scopeFreshness: { lastSyncedAt: null } };
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* The default service data directory. Overridable via the FLEET_SE_DATA_DIR env
|
|
174
|
+
* var, otherwise `~/.apra-fleet-se`.
|
|
175
|
+
* @returns {string}
|
|
176
|
+
*/
|
|
177
|
+
export function defaultDataDir() {
|
|
178
|
+
return process.env.FLEET_SE_DATA_DIR
|
|
179
|
+
? path.resolve(process.env.FLEET_SE_DATA_DIR)
|
|
180
|
+
: path.join(os.homedir(), '.apra-fleet-se');
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/** Normalize a claim's axes into a frozen, deduped, sorted-copy reservation. */
|
|
184
|
+
function normalizeReservation(input, now) {
|
|
185
|
+
const toStringArray = (v, label) => {
|
|
186
|
+
if (v == null) return [];
|
|
187
|
+
if (!Array.isArray(v)) throw new TypeError(`${label} must be an array of strings`);
|
|
188
|
+
const out = [];
|
|
189
|
+
const seen = new Set();
|
|
190
|
+
for (const item of v) {
|
|
191
|
+
if (typeof item !== 'string' || item.length === 0) {
|
|
192
|
+
throw new TypeError(`${label} must contain only non-empty strings`);
|
|
193
|
+
}
|
|
194
|
+
if (!seen.has(item)) { seen.add(item); out.push(item); }
|
|
195
|
+
}
|
|
196
|
+
return out;
|
|
197
|
+
};
|
|
198
|
+
|
|
199
|
+
const members = toStringArray(input.members, 'members');
|
|
200
|
+
const issueRoots = toStringArray(input.issueRoots, 'issueRoots');
|
|
201
|
+
let childPid = input.childPid;
|
|
202
|
+
if (childPid === undefined) childPid = null;
|
|
203
|
+
if (childPid !== null && !Number.isInteger(childPid)) {
|
|
204
|
+
throw new TypeError('childPid must be an integer or null');
|
|
205
|
+
}
|
|
206
|
+
const reservedAt = typeof input.reservedAt === 'string' ? input.reservedAt : now();
|
|
207
|
+
|
|
208
|
+
// apra-fleet-3i3.2 / apra-fleet-k7b.2: optional launch metadata.
|
|
209
|
+
// `undefined`/`null` both normalize to `null` -- this is what makes a
|
|
210
|
+
// pre-existing on-disk entry (written before these fields existed, so
|
|
211
|
+
// `input.branch` etc. are `undefined`) load without error, identically
|
|
212
|
+
// to a fresh launch that simply omitted `goal`. `branch` doubles as the
|
|
213
|
+
// watchdog's hasTerminalState() fallback lookup key for a reservation
|
|
214
|
+
// claimed BEFORE k7b.1 shipped, whose terminal state (if any) was
|
|
215
|
+
// persisted under the pre-fix branch-keyed old_runs/ filename, not under
|
|
216
|
+
// this reservation's own sprintId.
|
|
217
|
+
const toNullableString = (v, label) => {
|
|
218
|
+
if (v === undefined || v === null) return null;
|
|
219
|
+
if (typeof v !== 'string') throw new TypeError(`${label} must be a string or null`);
|
|
220
|
+
return v;
|
|
221
|
+
};
|
|
222
|
+
const branch = toNullableString(input.branch, 'branch');
|
|
223
|
+
const base = toNullableString(input.base, 'base');
|
|
224
|
+
const goal = toNullableString(input.goal, 'goal');
|
|
225
|
+
|
|
226
|
+
// apra-fleet-k7b.3: exitCode/signal/exitedAt default to null (unknown --
|
|
227
|
+
// the child hasn't exited, or this reservation predates the field/was
|
|
228
|
+
// re-adopted after a restart with no in-memory exit listener), exactly
|
|
229
|
+
// like childPid's own null-until-known convention above.
|
|
230
|
+
let exitCode = input.exitCode;
|
|
231
|
+
if (exitCode === undefined) exitCode = null;
|
|
232
|
+
if (exitCode !== null && !Number.isInteger(exitCode)) {
|
|
233
|
+
throw new TypeError('exitCode must be an integer or null');
|
|
234
|
+
}
|
|
235
|
+
let signal = input.signal;
|
|
236
|
+
if (signal === undefined) signal = null;
|
|
237
|
+
if (signal !== null && typeof signal !== 'string') {
|
|
238
|
+
throw new TypeError('signal must be a string or null');
|
|
239
|
+
}
|
|
240
|
+
let exitedAt = input.exitedAt;
|
|
241
|
+
if (exitedAt === undefined) exitedAt = null;
|
|
242
|
+
if (exitedAt !== null && typeof exitedAt !== 'string') {
|
|
243
|
+
throw new TypeError('exitedAt must be a string or null');
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
// apra-fleet-ou7.1: logPath defaults to null (unknown -- a reservation
|
|
247
|
+
// predating this field), same convention as above.
|
|
248
|
+
let logPath = input.logPath;
|
|
249
|
+
if (logPath === undefined) logPath = null;
|
|
250
|
+
if (logPath !== null && typeof logPath !== 'string') {
|
|
251
|
+
throw new TypeError('logPath must be a string or null');
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
// The beads identity the supervisor resolved when it launched this sprint
|
|
255
|
+
// (src/supervisor/beads-identity.mjs's toBeadsSummary() shape: dir,
|
|
256
|
+
// prefix, syncRemote, repoRemote -- all strings). null for a reservation
|
|
257
|
+
// predating this field, same convention as above.
|
|
258
|
+
const beads = normalizeBeadsSummary(input.beads);
|
|
259
|
+
|
|
260
|
+
return { members, issueRoots, childPid, reservedAt, branch, base, goal, exitCode, signal, exitedAt, logPath, beads };
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
/** @param {unknown} v @returns {{ dir: string, prefix: string, syncRemote: string, repoRemote: string }|null} */
|
|
264
|
+
function normalizeBeadsSummary(v) {
|
|
265
|
+
if (v === undefined || v === null) return null;
|
|
266
|
+
if (typeof v !== 'object' || Array.isArray(v)) throw new TypeError('beads must be an object or null');
|
|
267
|
+
const out = {};
|
|
268
|
+
for (const k of ['dir', 'prefix', 'syncRemote', 'repoRemote']) {
|
|
269
|
+
const f = v[k];
|
|
270
|
+
if (f !== undefined && f !== null && typeof f !== 'string') throw new TypeError(`beads.${k} must be a string`);
|
|
271
|
+
out[k] = f ?? '';
|
|
272
|
+
}
|
|
273
|
+
return out;
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
/** Deep-clone a reservation so callers can never mutate ledger-internal state. */
|
|
277
|
+
function cloneReservation(r) {
|
|
278
|
+
return {
|
|
279
|
+
members: [...r.members],
|
|
280
|
+
issueRoots: [...r.issueRoots],
|
|
281
|
+
childPid: r.childPid,
|
|
282
|
+
reservedAt: r.reservedAt,
|
|
283
|
+
branch: r.branch ?? null,
|
|
284
|
+
base: r.base ?? null,
|
|
285
|
+
goal: r.goal ?? null,
|
|
286
|
+
exitCode: r.exitCode ?? null,
|
|
287
|
+
signal: r.signal ?? null,
|
|
288
|
+
logPath: r.logPath ?? null,
|
|
289
|
+
exitedAt: r.exitedAt ?? null,
|
|
290
|
+
beads: r.beads ? { ...r.beads } : null,
|
|
291
|
+
};
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
/**
|
|
295
|
+
* Create the combined reservation ledger. Collaborators are injected so tests
|
|
296
|
+
* can drive an in-memory temp dir and simulate a mid-write failure.
|
|
297
|
+
*
|
|
298
|
+
* @param {{
|
|
299
|
+
* dataDir?: string,
|
|
300
|
+
* filePath?: string,
|
|
301
|
+
* now?: () => string,
|
|
302
|
+
* fs?: {
|
|
303
|
+
* mkdir: typeof import('node:fs/promises').mkdir,
|
|
304
|
+
* readFile: typeof import('node:fs/promises').readFile,
|
|
305
|
+
* writeFile: typeof import('node:fs/promises').writeFile,
|
|
306
|
+
* rename: typeof import('node:fs/promises').rename,
|
|
307
|
+
* rm?: typeof import('node:fs/promises').rm,
|
|
308
|
+
* },
|
|
309
|
+
* logger?: { log?: Function, error?: Function },
|
|
310
|
+
* reservationClient?: {
|
|
311
|
+
* reserve: (memberId: string, sprintId: string) => Promise<any>|any,
|
|
312
|
+
* release: (memberId: string, sprintId: string) => Promise<any>|any,
|
|
313
|
+
* },
|
|
314
|
+
* renameRetry?: {
|
|
315
|
+
* maxAttempts?: number,
|
|
316
|
+
* baseDelayMs?: number,
|
|
317
|
+
* sleep?: (ms: number) => Promise<void>,
|
|
318
|
+
* },
|
|
319
|
+
* apra-fleet-ed4.1: bounded EPERM/EBUSY retry options for the persist()
|
|
320
|
+
* rename step (see rename-with-retry.mjs) -- injectable so a test can
|
|
321
|
+
* drive a fake clock with no real sleeps. Defaults to
|
|
322
|
+
* renameWithRetry()'s own defaults (5 attempts, ~10ms escalating).
|
|
323
|
+
* }} [deps]
|
|
324
|
+
*
|
|
325
|
+
* apra-fleet-eft.10.3: when a `reservationClient` is injected, the ledger
|
|
326
|
+
* becomes a CLIENT of the fleet server's per-member reservation authority --
|
|
327
|
+
* every claim reserves each member on the server, and every release releases
|
|
328
|
+
* them. The server (member.reservedBy) is then what execute_prompt consults to
|
|
329
|
+
* reject a cross-sprint dispatch, with this ledger driving it. Without a client
|
|
330
|
+
* injected the ledger behaves exactly as before (pure local storage), so the
|
|
331
|
+
* server ops are opt-in and cannot break the storage-level contract.
|
|
332
|
+
*/
|
|
333
|
+
export function createLedger(deps = {}) {
|
|
334
|
+
const dataDir = deps.dataDir ?? defaultDataDir();
|
|
335
|
+
const filePath = deps.filePath ?? path.join(dataDir, LEDGER_FILENAME);
|
|
336
|
+
const tmpPath = `${filePath}.tmp`;
|
|
337
|
+
const now = deps.now ?? (() => new Date().toISOString());
|
|
338
|
+
const fs = deps.fs ?? fsp;
|
|
339
|
+
const logger = deps.logger ?? console;
|
|
340
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
341
|
+
const reservationClient = deps.reservationClient ?? null;
|
|
342
|
+
const renameRetryOpts = deps.renameRetry ?? {};
|
|
343
|
+
|
|
344
|
+
/**
|
|
345
|
+
* Drive the server reservation op for every member in a reservation. Best
|
|
346
|
+
* effort: a per-member failure is logged and does NOT roll back the local
|
|
347
|
+
* ledger commit (the ledger stays the durable, restart-surviving record;
|
|
348
|
+
* the server is a live overlay the watchdog reconciliation can re-drive).
|
|
349
|
+
* @param {'reserve'|'release'} op
|
|
350
|
+
* @param {string} sprintId
|
|
351
|
+
* @param {string[]} members
|
|
352
|
+
*/
|
|
353
|
+
async function driveServerReservation(op, sprintId, members) {
|
|
354
|
+
if (!reservationClient || typeof reservationClient[op] !== 'function') return;
|
|
355
|
+
for (const member of members) {
|
|
356
|
+
try {
|
|
357
|
+
await reservationClient[op](member, sprintId);
|
|
358
|
+
} catch (err) {
|
|
359
|
+
logError(`[ledger] server ${op} failed for member=${member} sprint=${sprintId}:`, err);
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
// Authoritative in-memory view. Committed to ONLY after a successful disk
|
|
365
|
+
// write, so a failed persist can never leave a half-claimed reservation.
|
|
366
|
+
/** @type {Map<string, Reservation>} */
|
|
367
|
+
let reservations = new Map();
|
|
368
|
+
let loaded = false;
|
|
369
|
+
// Track the timestamp of the last successful bd sync for scope freshness.
|
|
370
|
+
let lastSyncedAt = null;
|
|
371
|
+
|
|
372
|
+
// Serialize every transaction (draft build + atomic write + commit) so
|
|
373
|
+
// concurrent claim()/release() calls can never build a stale draft, nor
|
|
374
|
+
// interleave their temp-file writes and renames.
|
|
375
|
+
let txChain = Promise.resolve();
|
|
376
|
+
|
|
377
|
+
function currentDocument(map = reservations) {
|
|
378
|
+
const doc = emptyLedgerDocument();
|
|
379
|
+
for (const [sprintId, r] of map) {
|
|
380
|
+
doc.reservations[sprintId] = cloneReservation(r);
|
|
381
|
+
}
|
|
382
|
+
doc.scopeFreshness.lastSyncedAt = lastSyncedAt;
|
|
383
|
+
return doc;
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
/**
|
|
387
|
+
* Atomically replace the on-disk ledger with `doc` (temp file + rename).
|
|
388
|
+
* Never leaves a torn file for a concurrent reader.
|
|
389
|
+
*/
|
|
390
|
+
async function persist(doc) {
|
|
391
|
+
await fs.mkdir(path.dirname(filePath), { recursive: true });
|
|
392
|
+
const body = `${JSON.stringify(doc, null, 2)}\n`;
|
|
393
|
+
await fs.writeFile(tmpPath, body, 'utf-8');
|
|
394
|
+
// apra-fleet-ed4.1: bounded EPERM/EBUSY retry -- on Windows this
|
|
395
|
+
// rename can transiently fail while the destination is momentarily
|
|
396
|
+
// locked/open elsewhere, which used to silently drop this write.
|
|
397
|
+
await renameWithRetry(fs, tmpPath, filePath, renameRetryOpts);
|
|
398
|
+
}
|
|
399
|
+
|
|
400
|
+
/**
|
|
401
|
+
* Transactionally apply `mutate` to a clone of the CURRENT committed map,
|
|
402
|
+
* persist the resulting document to disk, and only THEN commit the clone as
|
|
403
|
+
* the live map. The whole transaction is serialized behind txChain, so each
|
|
404
|
+
* one sees the previous commit. If persistence throws, the live map is
|
|
405
|
+
* untouched -- both axes stay in their pre-call state (neither half-claimed
|
|
406
|
+
* nor half-released).
|
|
407
|
+
* @template T
|
|
408
|
+
* @param {(draft: Map<string, Reservation>) => T} mutate
|
|
409
|
+
* @returns {Promise<T>}
|
|
410
|
+
*/
|
|
411
|
+
function transact(mutate) {
|
|
412
|
+
const run = txChain.then(async () => {
|
|
413
|
+
const draft = new Map();
|
|
414
|
+
for (const [k, v] of reservations) draft.set(k, cloneReservation(v));
|
|
415
|
+
const result = mutate(draft);
|
|
416
|
+
await persist(currentDocument(draft));
|
|
417
|
+
reservations = draft; // commit only after the disk write succeeded
|
|
418
|
+
return result;
|
|
419
|
+
});
|
|
420
|
+
// Keep the chain alive regardless of this transaction's outcome so one
|
|
421
|
+
// failed write can't poison every later transaction; the error still
|
|
422
|
+
// propagates to this caller via the returned promise.
|
|
423
|
+
txChain = run.catch(() => {});
|
|
424
|
+
return run;
|
|
425
|
+
}
|
|
426
|
+
|
|
427
|
+
/**
|
|
428
|
+
* Load the ledger from disk into memory. A missing file yields an empty
|
|
429
|
+
* ledger. A corrupt/foreign-version file is a hard error -- the supervisor
|
|
430
|
+
* must not silently drop live reservations.
|
|
431
|
+
*/
|
|
432
|
+
async function load() {
|
|
433
|
+
let raw;
|
|
434
|
+
try {
|
|
435
|
+
raw = await fs.readFile(filePath, 'utf-8');
|
|
436
|
+
} catch (err) {
|
|
437
|
+
if (err && err.code === 'ENOENT') {
|
|
438
|
+
reservations = new Map();
|
|
439
|
+
lastSyncedAt = null;
|
|
440
|
+
loaded = true;
|
|
441
|
+
return;
|
|
442
|
+
}
|
|
443
|
+
throw err;
|
|
444
|
+
}
|
|
445
|
+
let doc;
|
|
446
|
+
try {
|
|
447
|
+
doc = JSON.parse(raw);
|
|
448
|
+
} catch (err) {
|
|
449
|
+
throw new Error(`ledger file ${filePath} is not valid JSON: ${err.message}`);
|
|
450
|
+
}
|
|
451
|
+
if (!doc || typeof doc !== 'object' || doc.version !== LEDGER_VERSION || typeof doc.reservations !== 'object') {
|
|
452
|
+
throw new Error(`ledger file ${filePath} has an unexpected shape or version (expected ${LEDGER_VERSION})`);
|
|
453
|
+
}
|
|
454
|
+
const next = new Map();
|
|
455
|
+
for (const [sprintId, r] of Object.entries(doc.reservations)) {
|
|
456
|
+
next.set(sprintId, normalizeReservation(r, now));
|
|
457
|
+
}
|
|
458
|
+
reservations = next;
|
|
459
|
+
lastSyncedAt = (doc.scopeFreshness && doc.scopeFreshness.lastSyncedAt) || null;
|
|
460
|
+
loaded = true;
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
return {
|
|
464
|
+
name: 'ledger',
|
|
465
|
+
filePath,
|
|
466
|
+
dataDir,
|
|
467
|
+
|
|
468
|
+
// -- seam lifecycle (server.mjs calls start()/stop()) ----------------
|
|
469
|
+
async start() { if (!loaded) await load(); },
|
|
470
|
+
async stop() { await txChain; },
|
|
471
|
+
|
|
472
|
+
load,
|
|
473
|
+
|
|
474
|
+
/**
|
|
475
|
+
* Claim BOTH axes for a sprint in one atomic write. Storage-level only:
|
|
476
|
+
* overlap rejection is layered on by eft.5.2/eft.5.3 before calling this.
|
|
477
|
+
* @param {string} sprintId
|
|
478
|
+
* @param {{ members?: string[], issueRoots?: string[], childPid?: number|null, reservedAt?: string, branch?: string|null, base?: string|null, goal?: string|null }} claimInput
|
|
479
|
+
* @returns {Promise<Reservation>} a clone of the stored reservation
|
|
480
|
+
*/
|
|
481
|
+
async claim(sprintId, claimInput = {}) {
|
|
482
|
+
if (typeof sprintId !== 'string' || sprintId.length === 0) {
|
|
483
|
+
throw new TypeError('claim() requires a non-empty sprintId');
|
|
484
|
+
}
|
|
485
|
+
const reservation = normalizeReservation(claimInput, now);
|
|
486
|
+
await transact((draft) => {
|
|
487
|
+
if (draft.has(sprintId)) {
|
|
488
|
+
throw new Error(`sprint ${sprintId} already holds a reservation; release it before re-claiming`);
|
|
489
|
+
}
|
|
490
|
+
draft.set(sprintId, reservation);
|
|
491
|
+
});
|
|
492
|
+
// eft.10.3: mirror the claim onto the server's per-member reservation
|
|
493
|
+
// authority so execute_prompt rejects cross-sprint dispatch. Only
|
|
494
|
+
// after the local commit succeeded (the ledger is the durable record).
|
|
495
|
+
await driveServerReservation('reserve', sprintId, reservation.members);
|
|
496
|
+
return cloneReservation(reservation);
|
|
497
|
+
},
|
|
498
|
+
|
|
499
|
+
/**
|
|
500
|
+
* Release BOTH axes for a sprint in one atomic write. Idempotent: a
|
|
501
|
+
* no-op (returns false) if the sprint held no reservation.
|
|
502
|
+
* @param {string} sprintId
|
|
503
|
+
* @returns {Promise<boolean>} whether a reservation was removed
|
|
504
|
+
*/
|
|
505
|
+
async release(sprintId) {
|
|
506
|
+
if (typeof sprintId !== 'string' || sprintId.length === 0) {
|
|
507
|
+
throw new TypeError('release() requires a non-empty sprintId');
|
|
508
|
+
}
|
|
509
|
+
// Capture the member set BEFORE the delete so the terminal-event
|
|
510
|
+
// server release (eft.10.3) can free exactly the members this sprint
|
|
511
|
+
// held. The delete stays the atomic, transactional source of truth.
|
|
512
|
+
const held = reservations.get(sprintId);
|
|
513
|
+
const members = held ? [...held.members] : [];
|
|
514
|
+
const removed = await transact((draft) => draft.delete(sprintId));
|
|
515
|
+
if (removed) {
|
|
516
|
+
await driveServerReservation('release', sprintId, members);
|
|
517
|
+
}
|
|
518
|
+
return removed;
|
|
519
|
+
},
|
|
520
|
+
|
|
521
|
+
/**
|
|
522
|
+
* Update the recorded child PID for a live reservation (used once the
|
|
523
|
+
* detached child is spawned). Same lockstep atomic-write discipline.
|
|
524
|
+
* @param {string} sprintId
|
|
525
|
+
* @param {number|null} childPid
|
|
526
|
+
* @returns {Promise<Reservation>}
|
|
527
|
+
*/
|
|
528
|
+
async setChildPid(sprintId, childPid) {
|
|
529
|
+
if (childPid !== null && !Number.isInteger(childPid)) {
|
|
530
|
+
throw new TypeError('childPid must be an integer or null');
|
|
531
|
+
}
|
|
532
|
+
let updated;
|
|
533
|
+
await transact((draft) => {
|
|
534
|
+
const r = draft.get(sprintId);
|
|
535
|
+
if (!r) {
|
|
536
|
+
throw new Error(`cannot set childPid: sprint ${sprintId} holds no reservation`);
|
|
537
|
+
}
|
|
538
|
+
r.childPid = childPid;
|
|
539
|
+
updated = r;
|
|
540
|
+
});
|
|
541
|
+
return cloneReservation(updated);
|
|
542
|
+
},
|
|
543
|
+
|
|
544
|
+
/**
|
|
545
|
+
* apra-fleet-k7b.3: record the detached child's own process exit
|
|
546
|
+
* (code/signal/timestamp) onto its still-held reservation -- called by
|
|
547
|
+
* the spawner's SAME-INSTANCE `child.once('exit', ...)` listener via
|
|
548
|
+
* bin/serve.mjs's wiring, the moment the child actually exits. This
|
|
549
|
+
* does NOT release the reservation (that stays reconcile.mjs's job on
|
|
550
|
+
* restart, or an operator force-release); it only annotates it so the
|
|
551
|
+
* watchdog can report e.g. "exited 1 at 2026-07-30T21:25:50.000Z"
|
|
552
|
+
* instead of a bare "pid gone" for any sprint whose exit this SAME
|
|
553
|
+
* supervisor instance actually witnessed.
|
|
554
|
+
* @param {string} sprintId
|
|
555
|
+
* @param {{ exitCode?: number|null, signal?: string|null, at?: string }} info
|
|
556
|
+
* @returns {Promise<Reservation>}
|
|
557
|
+
*/
|
|
558
|
+
async recordExit(sprintId, info = {}) {
|
|
559
|
+
if (typeof sprintId !== 'string' || sprintId.length === 0) {
|
|
560
|
+
throw new TypeError('recordExit() requires a non-empty sprintId');
|
|
561
|
+
}
|
|
562
|
+
let updated;
|
|
563
|
+
await transact((draft) => {
|
|
564
|
+
const r = draft.get(sprintId);
|
|
565
|
+
if (!r) {
|
|
566
|
+
throw new Error(`cannot record exit: sprint ${sprintId} holds no reservation`);
|
|
567
|
+
}
|
|
568
|
+
r.exitCode = info.exitCode === undefined ? null : info.exitCode;
|
|
569
|
+
r.signal = info.signal === undefined ? null : info.signal;
|
|
570
|
+
r.exitedAt = typeof info.at === 'string' ? info.at : now();
|
|
571
|
+
updated = r;
|
|
572
|
+
});
|
|
573
|
+
return cloneReservation(updated);
|
|
574
|
+
},
|
|
575
|
+
|
|
576
|
+
/**
|
|
577
|
+
* Return a clone of one sprint's reservation, or undefined.
|
|
578
|
+
* @param {string} sprintId
|
|
579
|
+
* @returns {Reservation|undefined}
|
|
580
|
+
*/
|
|
581
|
+
get(sprintId) {
|
|
582
|
+
const r = reservations.get(sprintId);
|
|
583
|
+
return r ? cloneReservation(r) : undefined;
|
|
584
|
+
},
|
|
585
|
+
|
|
586
|
+
/**
|
|
587
|
+
* Return clones of all reservations as `{ sprintId, ...reservation }`.
|
|
588
|
+
* @returns {Array<Reservation & { sprintId: string }>}
|
|
589
|
+
*/
|
|
590
|
+
list() {
|
|
591
|
+
return [...reservations.entries()].map(([sprintId, r]) => ({ sprintId, ...cloneReservation(r) }));
|
|
592
|
+
},
|
|
593
|
+
|
|
594
|
+
/** Current persisted-shape document (a clone). */
|
|
595
|
+
toDocument() { return currentDocument(); },
|
|
596
|
+
|
|
597
|
+
/** Number of live reservations. */
|
|
598
|
+
get size() { return reservations.size; },
|
|
599
|
+
|
|
600
|
+
/**
|
|
601
|
+
* Get the scope freshness information: timestamp of last successful bd sync
|
|
602
|
+
* and derived age in seconds, or 'never-synced' marker if unknown.
|
|
603
|
+
* @param {() => number} getNow optional function to get current timestamp in ms
|
|
604
|
+
* @returns {{ lastSyncedAt: string|null, ageSeconds: number|string }}
|
|
605
|
+
*/
|
|
606
|
+
getScopeFreshness(getNow) {
|
|
607
|
+
if (lastSyncedAt === null) {
|
|
608
|
+
return { lastSyncedAt: null, ageSeconds: 'never-synced' };
|
|
609
|
+
}
|
|
610
|
+
const lastTime = new Date(lastSyncedAt).getTime();
|
|
611
|
+
const currentTime = (getNow && getNow()) || Date.now();
|
|
612
|
+
const ageSeconds = Math.max(0, Math.floor((currentTime - lastTime) / 1000));
|
|
613
|
+
return { lastSyncedAt, ageSeconds };
|
|
614
|
+
},
|
|
615
|
+
|
|
616
|
+
/**
|
|
617
|
+
* Update the scope freshness timestamp to record a successful bd sync/pull.
|
|
618
|
+
* @param {string} [timestamp] ISO-8601 timestamp; defaults to current time
|
|
619
|
+
* @returns {Promise<{ lastSyncedAt: string, ageSeconds: number }>}
|
|
620
|
+
*/
|
|
621
|
+
async setScopeFreshness(timestamp) {
|
|
622
|
+
const newTimestamp = timestamp || now();
|
|
623
|
+
return transact(() => {
|
|
624
|
+
lastSyncedAt = newTimestamp;
|
|
625
|
+
return { lastSyncedAt: newTimestamp, ageSeconds: 0 };
|
|
626
|
+
});
|
|
627
|
+
},
|
|
628
|
+
};
|
|
629
|
+
}
|