@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,276 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- process-free History view (apra-fleet-eft.6.5)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// Renders a finished sprint's persisted terminal state
|
|
6
|
+
// (<serviceDataDir>/old_runs/<sprintId>.json, apra-fleet-eft.2.3; falling
|
|
7
|
+
// back to the legacy <serviceDataDir>/old_sprints/<sprintId>.json for sprints
|
|
8
|
+
// that finished before the apra-fleet-eft.37.1 rename) using the SAME HTML
|
|
9
|
+
// template the live viewer serves (@apralabs/apra-fleet-workflow's
|
|
10
|
+
// viewer/index.mjs HTML_TEMPLATE), fed a FROZEN state object instead of the
|
|
11
|
+
// live view's fetch('/state') + EventSource('/events') polling loop. A
|
|
12
|
+
// finished sprint has zero running processes, so the page it serves issues
|
|
13
|
+
// zero outbound network requests, and Save/Stop (nothing left to save/stop)
|
|
14
|
+
// are omitted entirely -- see HTML_TEMPLATE's `opts.history` mode.
|
|
15
|
+
//
|
|
16
|
+
// This is a SEPARATE surface from the /sprints/:id/live reverse proxy's
|
|
17
|
+
// history fallthrough (eft.6.4, src/supervisor/proxy.mjs): that route's
|
|
18
|
+
// default renderer is a deliberately minimal compact page so a racing
|
|
19
|
+
// live->finished transition is never a dead proxy; this route
|
|
20
|
+
// (`GET /sprints/:id/history`) is the operator-facing "History" link and
|
|
21
|
+
// always renders the full template, unconditionally, straight from
|
|
22
|
+
// old_runs/ (merged with the legacy old_sprints/, apra-fleet-eft.37.1).
|
|
23
|
+
//
|
|
24
|
+
// PATH-TRAVERSAL DISCIPLINE (acceptance criterion)
|
|
25
|
+
// -------------------------------------------------
|
|
26
|
+
// A sprintId is an opaque identifier (a stable per-sprint id/UUID -- see
|
|
27
|
+
// @apralabs/apra-fleet-workflow/viewer/run-state-paths), never a path
|
|
28
|
+
// fragment. Any `:id` value containing a path separator or a bare '.'/'..'
|
|
29
|
+
// segment is rejected outright, and the resolved file path is verified
|
|
30
|
+
// (defense in depth) to still land directly inside old_runs/ or the legacy
|
|
31
|
+
// old_sprints/ before anything ever touches disk -- the renderer reads ONLY
|
|
32
|
+
// from the service data dir's old_runs/ or old_sprints/, never an arbitrary
|
|
33
|
+
// repo checkout path.
|
|
34
|
+
// =============================================================================
|
|
35
|
+
|
|
36
|
+
import fsp from 'node:fs/promises';
|
|
37
|
+
import path from 'node:path';
|
|
38
|
+
import { HTML_TEMPLATE } from '@apralabs/apra-fleet-workflow/viewer';
|
|
39
|
+
import { getOldRunsDir, getTerminalRunStatePath } from '@apralabs/apra-fleet-workflow/viewer/run-state-paths';
|
|
40
|
+
import { getFleetDataDir } from '@apralabs/apra-fleet-client/server-resolution';
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* BOUNDARY-COMPAT (apra-fleet-eft.37.1/37.2): the legacy pre-rename terminal
|
|
44
|
+
* state directory. old_runs/ is the canonical write target for every fresh
|
|
45
|
+
* run; this legacy directory is resolved read-only, purely so history for
|
|
46
|
+
* sprints that finished BEFORE the rename still renders. Remove once no
|
|
47
|
+
* legacy old_sprints/ files remain to serve.
|
|
48
|
+
* @param {NodeJS.ProcessEnv} env
|
|
49
|
+
* @returns {string}
|
|
50
|
+
*/
|
|
51
|
+
function getLegacyOldSprintsDir(env) {
|
|
52
|
+
return path.join(getFleetDataDir(env), 'old_sprints');
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* Writes a small text response with an explicit content-length. Exported
|
|
57
|
+
* (apra-fleet-ou7.2) so the sibling GET /sprints/:id/log route (api.mjs)
|
|
58
|
+
* reuses this SAME plain-text response helper instead of a second copy.
|
|
59
|
+
*/
|
|
60
|
+
export function sendPlain(res, status, text) {
|
|
61
|
+
const body = Buffer.from(String(text), 'utf-8');
|
|
62
|
+
res.writeHead(status, {
|
|
63
|
+
'content-type': 'text/plain; charset=utf-8',
|
|
64
|
+
'content-length': body.length,
|
|
65
|
+
});
|
|
66
|
+
res.end(body);
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* True iff `sprintId` is a bare, single path segment -- never a path
|
|
71
|
+
* fragment. sprintIds are opaque identifiers (a stable per-sprint id/UUID),
|
|
72
|
+
* so a path separator or a '.'/'..' segment can only be a path-traversal
|
|
73
|
+
* attempt against old_runs/ or old_sprints/.
|
|
74
|
+
* @param {unknown} sprintId
|
|
75
|
+
* @returns {boolean}
|
|
76
|
+
*/
|
|
77
|
+
export function isSafeSprintId(sprintId) {
|
|
78
|
+
if (typeof sprintId !== 'string' || sprintId.length === 0) return false;
|
|
79
|
+
if (sprintId === '.' || sprintId === '..') return false;
|
|
80
|
+
if (sprintId.includes('/') || sprintId.includes('\\')) return false;
|
|
81
|
+
return true;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Resolves a sprintId to its terminal state path, merging the canonical
|
|
86
|
+
* old_runs/<sprintId>.json with the legacy old_sprints/<sprintId>.json
|
|
87
|
+
* (apra-fleet-eft.37.1: getTerminalRunStatePath resolves old_runs/ first,
|
|
88
|
+
* falling back read-only to old_sprints/ for sprints that finished before the
|
|
89
|
+
* rename). Throws RangeError for an unsafe sprintId, or for the
|
|
90
|
+
* (should-be-impossible once isSafeSprintId has passed) case where the
|
|
91
|
+
* resolved path still lands outside one of those two directories -- defense
|
|
92
|
+
* in depth, never trusting a single check alone.
|
|
93
|
+
* @param {string} sprintId
|
|
94
|
+
* @param {NodeJS.ProcessEnv} env
|
|
95
|
+
* @returns {string}
|
|
96
|
+
*/
|
|
97
|
+
export function resolveOldSprintPath(sprintId, env) {
|
|
98
|
+
if (!isSafeSprintId(sprintId)) {
|
|
99
|
+
throw new RangeError(`refusing to resolve unsafe sprint id: ${JSON.stringify(sprintId)}`);
|
|
100
|
+
}
|
|
101
|
+
const filePath = getTerminalRunStatePath(sprintId, env);
|
|
102
|
+
const resolvedDir = path.dirname(path.resolve(filePath));
|
|
103
|
+
const runsDir = path.resolve(getOldRunsDir(env));
|
|
104
|
+
const legacyDir = path.resolve(getLegacyOldSprintsDir(env));
|
|
105
|
+
if (resolvedDir !== runsDir && resolvedDir !== legacyDir) {
|
|
106
|
+
throw new RangeError(`resolved path for sprint id '${sprintId}' escapes old_runs/ or old_sprints/`);
|
|
107
|
+
}
|
|
108
|
+
return filePath;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* BOUNDARY-COMPAT (apra-fleet-eft.37.3): before the M2 boundary refactor,
|
|
113
|
+
* core minted top-level `state.verdict`/`state.prUrl` by name; persisted
|
|
114
|
+
* old_runs/old_sprints files written before this release still have that
|
|
115
|
+
* shape. Core now stores the workflow script's own return value WHOLESALE
|
|
116
|
+
* and opaquely as `state.result` (docs/workflow-core-boundary-
|
|
117
|
+
* refactoring.md M2), which is what both the generic Result strip and this
|
|
118
|
+
* package's own verdict-badge/PR-link extension (fleet-sprint/
|
|
119
|
+
* viewer-extensions.mjs's `renderResultExtrasHtml`) read. Backfilling
|
|
120
|
+
* `state.result` here -- the se-owned reader shim -- is what lets a
|
|
121
|
+
* pre-rename file's verdict/PR still render in the History view without
|
|
122
|
+
* core ever having to know about this legacy shape. A file that already has
|
|
123
|
+
* a `result` object (post-M2) is left untouched: legacy top-level fields
|
|
124
|
+
* never override an already-opaque result. Remove one release after no
|
|
125
|
+
* legacy verdict/prUrl-shaped files remain to serve.
|
|
126
|
+
* @param {object} state
|
|
127
|
+
* @returns {object}
|
|
128
|
+
*/
|
|
129
|
+
function backfillLegacyResult(state) {
|
|
130
|
+
if (!state || typeof state !== 'object') return state;
|
|
131
|
+
if (state.result && typeof state.result === 'object') return state;
|
|
132
|
+
if (state.verdict === undefined && state.prUrl === undefined) return state;
|
|
133
|
+
return {
|
|
134
|
+
...state,
|
|
135
|
+
result: { verdict: state.verdict ?? null, prUrl: state.prUrl ?? null },
|
|
136
|
+
};
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Loads and parses a finished sprint's persisted terminal state from
|
|
141
|
+
* old_runs/<sprintId>.json (or the legacy old_sprints/<sprintId>.json).
|
|
142
|
+
* Returns `null` when no such file exists (the caller answers 404) or its
|
|
143
|
+
* content isn't valid JSON; throws only for a
|
|
144
|
+
* rejected (unsafe) sprintId or a genuine I/O failure other than ENOENT.
|
|
145
|
+
* @param {string} sprintId
|
|
146
|
+
* @param {NodeJS.ProcessEnv} [env]
|
|
147
|
+
* @param {(p: string, enc: string) => Promise<string>} [readFile]
|
|
148
|
+
* @returns {Promise<object|null>}
|
|
149
|
+
*/
|
|
150
|
+
export async function loadOldSprintState(sprintId, env = process.env, readFile) {
|
|
151
|
+
const read = readFile ?? fsp.readFile;
|
|
152
|
+
const filePath = resolveOldSprintPath(sprintId, env);
|
|
153
|
+
let raw;
|
|
154
|
+
try {
|
|
155
|
+
raw = await read(filePath, 'utf-8');
|
|
156
|
+
} catch (err) {
|
|
157
|
+
if (err && err.code === 'ENOENT') return null;
|
|
158
|
+
throw err;
|
|
159
|
+
}
|
|
160
|
+
try {
|
|
161
|
+
return backfillLegacyResult(JSON.parse(raw));
|
|
162
|
+
} catch {
|
|
163
|
+
return null;
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* Renders the process-free History view for one finished sprint: the SAME
|
|
169
|
+
* HTML_TEMPLATE the live viewer serves, fed the frozen state object directly
|
|
170
|
+
* -- no /events or /state polling, Save/Stop omitted (HTML_TEMPLATE's
|
|
171
|
+
* `opts.history` mode, apra-fleet-eft.6.5).
|
|
172
|
+
* @param {object} state - parsed old_runs/<sprintId>.json (or legacy old_sprints/)
|
|
173
|
+
* @param {Array} [dashboardExtensions]
|
|
174
|
+
* @returns {string}
|
|
175
|
+
*/
|
|
176
|
+
export function renderHistoryPageHtml(state, dashboardExtensions = []) {
|
|
177
|
+
return HTML_TEMPLATE(dashboardExtensions, { history: true, state });
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* Create the History view seam. Collaborators injected so tests can drive a
|
|
182
|
+
* temp dir / fake fs without touching the real service data dir.
|
|
183
|
+
*
|
|
184
|
+
* @param {{
|
|
185
|
+
* env?: NodeJS.ProcessEnv,
|
|
186
|
+
* readFile?: (p: string, enc: string) => Promise<string>,
|
|
187
|
+
* dashboardExtensions?: Array,
|
|
188
|
+
* logger?: { log?: Function, error?: Function },
|
|
189
|
+
* }} [deps]
|
|
190
|
+
* @returns {{
|
|
191
|
+
* name: string,
|
|
192
|
+
* start(): Promise<void>,
|
|
193
|
+
* stop(): Promise<void>,
|
|
194
|
+
* handleGet: Function,
|
|
195
|
+
* renderForSprint: (sprintId: string) => Promise<string|null>,
|
|
196
|
+
* }}
|
|
197
|
+
*/
|
|
198
|
+
export function createHistoryView(deps = {}) {
|
|
199
|
+
const env = deps.env ?? process.env;
|
|
200
|
+
const readFile = deps.readFile;
|
|
201
|
+
const dashboardExtensions = deps.dashboardExtensions ?? [];
|
|
202
|
+
const logger = deps.logger ?? console;
|
|
203
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
204
|
+
|
|
205
|
+
/**
|
|
206
|
+
* Renders one sprint's History page, or `null` when it has no persisted
|
|
207
|
+
* old_runs/ (or legacy old_sprints/) state (caller answers 404). Throws
|
|
208
|
+
* for an unsafe sprintId -- callers that want a rejection instead of a thrown error (this
|
|
209
|
+
* module's own `handleGet` below) check `isSafeSprintId()` themselves
|
|
210
|
+
* first; the live-proxy's `renderHistory` seam (src/supervisor/proxy.mjs)
|
|
211
|
+
* already treats a throwing renderer as "no history" and answers 404,
|
|
212
|
+
* which is itself a rejection of the path-traversal attempt.
|
|
213
|
+
* @param {string} sprintId
|
|
214
|
+
* @returns {Promise<string|null>}
|
|
215
|
+
*/
|
|
216
|
+
async function renderForSprint(sprintId) {
|
|
217
|
+
const state = await loadOldSprintState(sprintId, env, readFile);
|
|
218
|
+
if (state == null) return null;
|
|
219
|
+
return renderHistoryPageHtml(state, dashboardExtensions);
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
// GET /sprints/:id/history -- the dedicated "History" link (apra-fleet-eft.6,
|
|
223
|
+
// Plan Part 2.3): always renders from old_runs/ (merged with the legacy
|
|
224
|
+
// old_sprints/, apra-fleet-eft.37.1), regardless of whether
|
|
225
|
+
// the sprint is (still) live. Never proxies, never touches a live child
|
|
226
|
+
// port. This is a SEPARATE surface from /sprints/:id/live's history
|
|
227
|
+
// fallthrough (eft.6.4, proxy.mjs) -- both call the same `renderForSprint`
|
|
228
|
+
// rendering logic (bin/serve.mjs wires this seam's `renderForSprint` in as
|
|
229
|
+
// the live proxy's `renderHistory` collaborator too), so the SAME template
|
|
230
|
+
// serves live and history no matter which URL an operator followed.
|
|
231
|
+
async function handleGet(req, res, ctx) {
|
|
232
|
+
const sprintId = ctx?.params?.id;
|
|
233
|
+
if (!sprintId) { sendPlain(res, 400, 'missing sprint id in path'); return; }
|
|
234
|
+
if (!isSafeSprintId(sprintId)) {
|
|
235
|
+
sendPlain(res, 400, `invalid sprint id: ${sprintId}`);
|
|
236
|
+
return;
|
|
237
|
+
}
|
|
238
|
+
let html;
|
|
239
|
+
try {
|
|
240
|
+
html = await renderForSprint(sprintId);
|
|
241
|
+
} catch (err) {
|
|
242
|
+
logError('[history-view] failed to load state for', sprintId, err);
|
|
243
|
+
sendPlain(res, 400, `invalid sprint id: ${sprintId}`);
|
|
244
|
+
return;
|
|
245
|
+
}
|
|
246
|
+
if (html == null) {
|
|
247
|
+
sendPlain(res, 404, `No history for '${sprintId}'.`);
|
|
248
|
+
return;
|
|
249
|
+
}
|
|
250
|
+
const body = Buffer.from(html, 'utf-8');
|
|
251
|
+
res.writeHead(200, {
|
|
252
|
+
'content-type': 'text/html; charset=utf-8',
|
|
253
|
+
'content-length': body.length,
|
|
254
|
+
});
|
|
255
|
+
res.end(body);
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
return {
|
|
259
|
+
name: 'history-view',
|
|
260
|
+
async start() {},
|
|
261
|
+
async stop() {},
|
|
262
|
+
handleGet,
|
|
263
|
+
renderForSprint,
|
|
264
|
+
};
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
/**
|
|
268
|
+
* Registers `GET /sprints/:id/history` against a supervisor (server.mjs),
|
|
269
|
+
* mirroring the registration pattern of registerLiveRoutes()/
|
|
270
|
+
* registerDashboardRoutes().
|
|
271
|
+
* @param {{ route: (method: string, path: string, handler: Function) => void }} supervisor
|
|
272
|
+
* @param {ReturnType<typeof createHistoryView>} view
|
|
273
|
+
*/
|
|
274
|
+
export function registerHistoryViewRoutes(supervisor, view) {
|
|
275
|
+
supervisor.route('GET', '/sprints/:id/history', view.handleGet);
|
|
276
|
+
}
|
|
@@ -0,0 +1,328 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- sprint terminal-event history (apra-fleet-eft.5.4)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// A small, append-only, persisted log of TERMINAL sprint events that the live
|
|
6
|
+
// reservation ledger (src/supervisor/ledger.mjs) deliberately does NOT keep.
|
|
7
|
+
// The ledger is pure "who holds a reservation RIGHT NOW" storage: releasing a
|
|
8
|
+
// sprint erases it entirely. But two eft.5.4 flows need a durable record of WHY
|
|
9
|
+
// a reservation went away:
|
|
10
|
+
//
|
|
11
|
+
// * restart reconciliation marks a dead child's sprint `aborted-by-restart`,
|
|
12
|
+
// * a force-release records who/why a wedged reservation was torn down.
|
|
13
|
+
//
|
|
14
|
+
// This module owns that audit trail so the ledger stays torn-state-free. It is
|
|
15
|
+
// intentionally minimal: append + atomic replace (temp file + rename), the same
|
|
16
|
+
// durability discipline the ledger uses, so a reader never sees a torn file.
|
|
17
|
+
// =============================================================================
|
|
18
|
+
|
|
19
|
+
import fsp from 'node:fs/promises';
|
|
20
|
+
import path from 'node:path';
|
|
21
|
+
import os from 'node:os';
|
|
22
|
+
|
|
23
|
+
import { renameWithRetry } from './rename-with-retry.mjs';
|
|
24
|
+
|
|
25
|
+
/** On-disk schema version for the persisted history document. */
|
|
26
|
+
export const HISTORY_VERSION = 1;
|
|
27
|
+
|
|
28
|
+
/** Default file name for the persisted history inside the service data dir. */
|
|
29
|
+
export const HISTORY_FILENAME = 'sprint-history.json';
|
|
30
|
+
|
|
31
|
+
/** Recognized terminal event names recorded by eft.5.4 flows. */
|
|
32
|
+
export const HISTORY_EVENTS = Object.freeze({
|
|
33
|
+
ABORTED_BY_RESTART: 'aborted-by-restart',
|
|
34
|
+
FORCE_RELEASED: 'force-released',
|
|
35
|
+
// apra-fleet-k7b.3: the spawner's own SAME-INSTANCE `child.once('exit',
|
|
36
|
+
// ...)` observation -- NOT a terminal reservation event (the ledger
|
|
37
|
+
// reservation stays held; see ledger.mjs's recordExit() doc comment).
|
|
38
|
+
// Recorded here too (in addition to the ledger annotation) so the exit
|
|
39
|
+
// is visible in the durable audit trail even once the reservation is
|
|
40
|
+
// eventually released.
|
|
41
|
+
CHILD_EXITED: 'child-exited',
|
|
42
|
+
// apra-fleet-k7b.2: the watchdog observed a PID-gone sprint WITH a
|
|
43
|
+
// persisted terminal run-state (old_runs/, or the legacy branch-keyed
|
|
44
|
+
// fallback) -- i.e. classifySprint() returned FINISHED, not CRASHED.
|
|
45
|
+
// Recorded the first time this instance's watchdog classifies a given
|
|
46
|
+
// sprint FINISHED (see watchdog.mjs's `recordedFinishes` guard), same
|
|
47
|
+
// once-per-sprint discipline as apra-fleet-eft.20.3's CRASHED recorder.
|
|
48
|
+
FINISHED: 'finished',
|
|
49
|
+
// apra-fleet-0j1 / apra-fleet-cvb.1: the watchdog itself released a
|
|
50
|
+
// still-held reservation the moment it classified the sprint CRASHED or
|
|
51
|
+
// FINISHED -- mirroring reconcile()'s ABORTED_BY_RESTART (restart-time)
|
|
52
|
+
// and forceRelease()'s FORCE_RELEASED (operator-initiated) events, but
|
|
53
|
+
// for the AUTOMATIC, continuous, mid-run case neither of those covers.
|
|
54
|
+
AUTO_RELEASED: 'auto-released',
|
|
55
|
+
// apra-fleet-gey.1: the watchdog observed a sprint whose child exited
|
|
56
|
+
// within the configurable launch-failed window (default 60s) with no
|
|
57
|
+
// terminal state recorded -- a symptom of immediate child failure (e.g.
|
|
58
|
+
// a missing dependency, a hard-crash before first dispatch). Distinct
|
|
59
|
+
// from CRASHED to surface this diagnostic signal separately.
|
|
60
|
+
LAUNCH_FAILED: 'launch-failed',
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
/** An empty, well-formed history document. */
|
|
64
|
+
export function emptyHistoryDocument() {
|
|
65
|
+
return { version: HISTORY_VERSION, events: [] };
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
// apra-fleet-gey.2: the relaunch gate (api.mjs's launch()) needs "what was
|
|
69
|
+
// the prior incarnation of THIS issueRoot's terminal outcome" -- but only
|
|
70
|
+
// the RELEASE events (AUTO_RELEASED / FORCE_RELEASED / ABORTED_BY_RESTART,
|
|
71
|
+
// and CHILD_EXITED) carry `issueRoots` today (watchdog.mjs/reconcile.mjs
|
|
72
|
+
// always pass it through from the ledger entry being released/observed);
|
|
73
|
+
// the DETAIL events (FINISHED with its terminalReason/verdict, LAUNCH_FAILED
|
|
74
|
+
// with its reason) do not -- see defaultRecordFinished()/classifySprint()'s
|
|
75
|
+
// history.record() calls in watchdog.mjs. Both event shapes are always
|
|
76
|
+
// recorded under the SAME `sprintId` (the run-id, apra-fleet-k7b.1/.2) for
|
|
77
|
+
// one incarnation, so `latestForIssueRoot()` below correlates them by that
|
|
78
|
+
// shared key: find the most recent issueRoots-carrying event to identify
|
|
79
|
+
// WHICH sprintId was this root's last incarnation, then pull the actual
|
|
80
|
+
// terminal detail (FINISHED > LAUNCH_FAILED > the anchor event itself) from
|
|
81
|
+
// that sprintId's own event history.
|
|
82
|
+
|
|
83
|
+
/** Recognized terminal-event kinds latestForIssueRoot() reads its terminal-record shape's `event` from. */
|
|
84
|
+
const TERMINAL_DETAIL_EVENTS = Object.freeze([HISTORY_EVENTS.FINISHED, HISTORY_EVENTS.LAUNCH_FAILED]);
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* Terminal reasons the engine itself flags as "must not be retried blindly"
|
|
88
|
+
* (fleet-sprint/runner.js's resolveTerminalReason()/findDoltDivergedCause()):
|
|
89
|
+
* an unmergeable Dolt/beads sync conflict is the concrete case that motivated
|
|
90
|
+
* this gate (the apra-fleet-bnb-de118180 incident). Extend this set as more
|
|
91
|
+
* such reasons are identified elsewhere in the engine; an unlisted reason
|
|
92
|
+
* simply does not gate a relaunch (a false negative here only skips a
|
|
93
|
+
* warning -- it never blocks a legitimate relaunch).
|
|
94
|
+
*/
|
|
95
|
+
export const DETERMINISTIC_TERMINAL_REASONS = Object.freeze(new Set(['BEADS_SYNC_CONFLICT']));
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* True when a `latestForIssueRoot()` terminal record represents a reason
|
|
99
|
+
* that will almost certainly recur on an identical relaunch unless something
|
|
100
|
+
* about the request/environment changes first -- either:
|
|
101
|
+
* - a LAUNCH_FAILED incarnation (apra-fleet-gey.1: the child exited within
|
|
102
|
+
* the launch window before any dispatch ever ran -- e.g. an Arg Contract
|
|
103
|
+
* violation, a missing member beads DB -- always reproducible from the
|
|
104
|
+
* SAME request), or
|
|
105
|
+
* - a FINISHED incarnation whose terminalReason the engine flagged as
|
|
106
|
+
* must-not-be-retried-blindly (DETERMINISTIC_TERMINAL_REASONS above).
|
|
107
|
+
* @param {{ event?: string|null, terminalReason?: string|null }|null|undefined} record
|
|
108
|
+
* @returns {boolean}
|
|
109
|
+
*/
|
|
110
|
+
export function isDeterministicTerminalReason(record) {
|
|
111
|
+
if (!record) return false;
|
|
112
|
+
if (record.event === HISTORY_EVENTS.LAUNCH_FAILED) return true;
|
|
113
|
+
return typeof record.terminalReason === 'string' && DETERMINISTIC_TERMINAL_REASONS.has(record.terminalReason);
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/** The default service data directory (mirrors ledger.defaultDataDir()). */
|
|
117
|
+
export function defaultDataDir() {
|
|
118
|
+
return process.env.FLEET_SE_DATA_DIR
|
|
119
|
+
? path.resolve(process.env.FLEET_SE_DATA_DIR)
|
|
120
|
+
: path.join(os.homedir(), '.apra-fleet-se');
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
function cloneEvent(e) {
|
|
124
|
+
return {
|
|
125
|
+
sprintId: e.sprintId,
|
|
126
|
+
event: e.event,
|
|
127
|
+
reason: e.reason,
|
|
128
|
+
by: e.by ?? null,
|
|
129
|
+
members: [...(e.members ?? [])],
|
|
130
|
+
issueRoots: [...(e.issueRoots ?? [])],
|
|
131
|
+
at: e.at,
|
|
132
|
+
// apra-fleet-k7b.3: only meaningful for a CHILD_EXITED event; null for
|
|
133
|
+
// every other (pre-existing) event kind, matching `by`'s optional
|
|
134
|
+
// null-default convention above.
|
|
135
|
+
exitCode: e.exitCode === undefined ? null : e.exitCode,
|
|
136
|
+
signal: e.signal === undefined ? null : e.signal,
|
|
137
|
+
// apra-fleet-ou7.1: same optional/null-default convention -- the
|
|
138
|
+
// sprint's per-sprint raw log file path, recorded on a CHILD_EXITED
|
|
139
|
+
// event so it is still discoverable once the ledger reservation that
|
|
140
|
+
// originally carried it is released.
|
|
141
|
+
logPath: e.logPath === undefined ? null : e.logPath,
|
|
142
|
+
// apra-fleet-k7b.2: only meaningful for a FINISHED event -- the
|
|
143
|
+
// engine's own terminalReason / extensions.terminal.verdict, copied
|
|
144
|
+
// verbatim from the persisted terminal run-state so the durable
|
|
145
|
+
// audit trail carries the SAME words the watchdog log line and the
|
|
146
|
+
// History view do. Null for every other (pre-existing) event kind,
|
|
147
|
+
// same optional/null-default convention as the fields above.
|
|
148
|
+
terminalReason: e.terminalReason === undefined ? null : e.terminalReason,
|
|
149
|
+
verdict: e.verdict === undefined ? null : e.verdict,
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* Create the append-only sprint history log. Collaborators injected so tests
|
|
155
|
+
* can drive a temp dir and a fixed clock.
|
|
156
|
+
*
|
|
157
|
+
* @param {{
|
|
158
|
+
* dataDir?: string,
|
|
159
|
+
* filePath?: string,
|
|
160
|
+
* now?: () => string,
|
|
161
|
+
* fs?: {
|
|
162
|
+
* mkdir: typeof import('node:fs/promises').mkdir,
|
|
163
|
+
* readFile: typeof import('node:fs/promises').readFile,
|
|
164
|
+
* writeFile: typeof import('node:fs/promises').writeFile,
|
|
165
|
+
* rename: typeof import('node:fs/promises').rename,
|
|
166
|
+
* },
|
|
167
|
+
* logger?: { log?: Function, error?: Function },
|
|
168
|
+
* renameRetry?: {
|
|
169
|
+
* maxAttempts?: number,
|
|
170
|
+
* baseDelayMs?: number,
|
|
171
|
+
* sleep?: (ms: number) => Promise<void>,
|
|
172
|
+
* },
|
|
173
|
+
* apra-fleet-ed4.1: bounded EPERM/EBUSY retry options for the persist()
|
|
174
|
+
* rename step (see rename-with-retry.mjs) -- injectable so a test can
|
|
175
|
+
* drive a fake clock with no real sleeps. Defaults to
|
|
176
|
+
* renameWithRetry()'s own defaults (5 attempts, ~10ms escalating).
|
|
177
|
+
* }} [deps]
|
|
178
|
+
*/
|
|
179
|
+
export function createHistory(deps = {}) {
|
|
180
|
+
const dataDir = deps.dataDir ?? defaultDataDir();
|
|
181
|
+
const filePath = deps.filePath ?? path.join(dataDir, HISTORY_FILENAME);
|
|
182
|
+
const tmpPath = `${filePath}.tmp`;
|
|
183
|
+
const now = deps.now ?? (() => new Date().toISOString());
|
|
184
|
+
const fs = deps.fs ?? fsp;
|
|
185
|
+
const renameRetryOpts = deps.renameRetry ?? {};
|
|
186
|
+
|
|
187
|
+
/** @type {Array<object>} authoritative in-memory log, committed after persist. */
|
|
188
|
+
let events = [];
|
|
189
|
+
let loaded = false;
|
|
190
|
+
let txChain = Promise.resolve();
|
|
191
|
+
|
|
192
|
+
async function persist(list) {
|
|
193
|
+
await fs.mkdir(path.dirname(filePath), { recursive: true });
|
|
194
|
+
const doc = { version: HISTORY_VERSION, events: list };
|
|
195
|
+
const body = `${JSON.stringify(doc, null, 2)}\n`;
|
|
196
|
+
await fs.writeFile(tmpPath, body, 'utf-8');
|
|
197
|
+
// apra-fleet-ed4.1: bounded EPERM/EBUSY retry -- on Windows this
|
|
198
|
+
// rename can transiently fail while the destination is momentarily
|
|
199
|
+
// locked/open elsewhere, which used to silently drop this event.
|
|
200
|
+
await renameWithRetry(fs, tmpPath, filePath, renameRetryOpts);
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
async function load() {
|
|
204
|
+
let raw;
|
|
205
|
+
try {
|
|
206
|
+
raw = await fs.readFile(filePath, 'utf-8');
|
|
207
|
+
} catch (err) {
|
|
208
|
+
if (err && err.code === 'ENOENT') { events = []; loaded = true; return; }
|
|
209
|
+
throw err;
|
|
210
|
+
}
|
|
211
|
+
let doc;
|
|
212
|
+
try {
|
|
213
|
+
doc = JSON.parse(raw);
|
|
214
|
+
} catch (err) {
|
|
215
|
+
throw new Error(`history file ${filePath} is not valid JSON: ${err.message}`);
|
|
216
|
+
}
|
|
217
|
+
if (!doc || typeof doc !== 'object' || doc.version !== HISTORY_VERSION || !Array.isArray(doc.events)) {
|
|
218
|
+
throw new Error(`history file ${filePath} has an unexpected shape or version (expected ${HISTORY_VERSION})`);
|
|
219
|
+
}
|
|
220
|
+
events = doc.events.map(cloneEvent);
|
|
221
|
+
loaded = true;
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
return {
|
|
225
|
+
name: 'history',
|
|
226
|
+
filePath,
|
|
227
|
+
dataDir,
|
|
228
|
+
|
|
229
|
+
async start() { if (!loaded) await load(); },
|
|
230
|
+
async stop() { await txChain; },
|
|
231
|
+
load,
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* Append one terminal event and persist atomically. The in-memory log is
|
|
235
|
+
* committed only after the disk write succeeds.
|
|
236
|
+
* @param {{ sprintId: string, event: string, reason?: string, by?: string|null, members?: string[], issueRoots?: string[], at?: string, exitCode?: number|null, signal?: string|null, logPath?: string|null, terminalReason?: string|null, verdict?: string|null }} entry
|
|
237
|
+
* @returns {Promise<object>} a clone of the stored event
|
|
238
|
+
*/
|
|
239
|
+
async record(entry) {
|
|
240
|
+
if (!entry || typeof entry.sprintId !== 'string' || entry.sprintId.length === 0) {
|
|
241
|
+
throw new TypeError('history.record() requires a non-empty sprintId');
|
|
242
|
+
}
|
|
243
|
+
if (typeof entry.event !== 'string' || entry.event.length === 0) {
|
|
244
|
+
throw new TypeError('history.record() requires a non-empty event name');
|
|
245
|
+
}
|
|
246
|
+
const stored = cloneEvent({
|
|
247
|
+
sprintId: entry.sprintId,
|
|
248
|
+
event: entry.event,
|
|
249
|
+
reason: entry.reason ?? null,
|
|
250
|
+
by: entry.by ?? null,
|
|
251
|
+
members: entry.members,
|
|
252
|
+
issueRoots: entry.issueRoots,
|
|
253
|
+
at: typeof entry.at === 'string' ? entry.at : now(),
|
|
254
|
+
exitCode: entry.exitCode,
|
|
255
|
+
signal: entry.signal,
|
|
256
|
+
logPath: entry.logPath,
|
|
257
|
+
terminalReason: entry.terminalReason,
|
|
258
|
+
verdict: entry.verdict,
|
|
259
|
+
});
|
|
260
|
+
const run = txChain.then(async () => {
|
|
261
|
+
const next = [...events, stored];
|
|
262
|
+
await persist(next);
|
|
263
|
+
events = next; // commit only after the disk write succeeded
|
|
264
|
+
return cloneEvent(stored);
|
|
265
|
+
});
|
|
266
|
+
txChain = run.catch(() => {});
|
|
267
|
+
return run;
|
|
268
|
+
},
|
|
269
|
+
|
|
270
|
+
/** All recorded events (clones), in insertion order. */
|
|
271
|
+
list() { return events.map(cloneEvent); },
|
|
272
|
+
|
|
273
|
+
/** Every event for one sprint (clones), in insertion order. */
|
|
274
|
+
forSprint(sprintId) {
|
|
275
|
+
return events.filter((e) => e.sprintId === sprintId).map(cloneEvent);
|
|
276
|
+
},
|
|
277
|
+
|
|
278
|
+
/** The most recent event for one sprint, or undefined. */
|
|
279
|
+
latestFor(sprintId) {
|
|
280
|
+
for (let i = events.length - 1; i >= 0; i--) {
|
|
281
|
+
if (events[i].sprintId === sprintId) return cloneEvent(events[i]);
|
|
282
|
+
}
|
|
283
|
+
return undefined;
|
|
284
|
+
},
|
|
285
|
+
|
|
286
|
+
/**
|
|
287
|
+
* apra-fleet-gey.2: the most recent terminal record for one
|
|
288
|
+
* issueRoot -- used by the relaunch gate (api.mjs's launch()) to
|
|
289
|
+
* decide whether a same-root relaunch should be refused/warned. See
|
|
290
|
+
* this module's file-level "gey.2" doc comment above for why this
|
|
291
|
+
* correlates two different event shapes by their shared sprintId
|
|
292
|
+
* rather than reading a single event directly.
|
|
293
|
+
*
|
|
294
|
+
* Returns `undefined` when this issueRoot has no issueRoots-carrying
|
|
295
|
+
* event at all -- a true first launch (or one whose only prior
|
|
296
|
+
* incarnations are still live/running-unresponsive with nothing
|
|
297
|
+
* terminal yet) -- callers must treat that as "nothing to gate on".
|
|
298
|
+
* @param {string} issue
|
|
299
|
+
* @returns {{ sprintId: string, event: string|null, reason: string|null, terminalReason: string|null, verdict: string|null, at: string }|undefined}
|
|
300
|
+
*/
|
|
301
|
+
latestForIssueRoot(issue) {
|
|
302
|
+
if (typeof issue !== 'string' || issue.length === 0) return undefined;
|
|
303
|
+
let anchor;
|
|
304
|
+
for (let i = events.length - 1; i >= 0; i--) {
|
|
305
|
+
if ((events[i].issueRoots ?? []).includes(issue)) { anchor = events[i]; break; }
|
|
306
|
+
}
|
|
307
|
+
if (!anchor) return undefined;
|
|
308
|
+
let detail = anchor;
|
|
309
|
+
for (const kind of TERMINAL_DETAIL_EVENTS) {
|
|
310
|
+
let hit;
|
|
311
|
+
for (let i = events.length - 1; i >= 0; i--) {
|
|
312
|
+
if (events[i].sprintId === anchor.sprintId && events[i].event === kind) { hit = events[i]; break; }
|
|
313
|
+
}
|
|
314
|
+
if (hit) { detail = hit; break; }
|
|
315
|
+
}
|
|
316
|
+
return {
|
|
317
|
+
sprintId: anchor.sprintId,
|
|
318
|
+
event: detail.event ?? null,
|
|
319
|
+
reason: detail.reason ?? null,
|
|
320
|
+
terminalReason: detail.terminalReason ?? null,
|
|
321
|
+
verdict: detail.verdict ?? null,
|
|
322
|
+
at: anchor.at,
|
|
323
|
+
};
|
|
324
|
+
},
|
|
325
|
+
|
|
326
|
+
get size() { return events.length; },
|
|
327
|
+
};
|
|
328
|
+
}
|