@apralabs/apra-fleet 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +166 -5
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +42 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +62 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +115 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +352 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/stop-prompt.js +3 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,303 @@
|
|
|
1
|
+
// Cross-platform 'bd' invocation helper (apra-fleet-2cc.1).
|
|
2
|
+
//
|
|
3
|
+
// VENDORED COPY (apra-fleet-n4lu.1): this file is a verbatim copy of
|
|
4
|
+
// scripts/lib/exec-bd.mjs, duplicated here so packages/apra-fleet-se/src/
|
|
5
|
+
// supervisor/{backlog.mjs,scope-overlap.mjs} import it from INSIDE the
|
|
6
|
+
// packaged/installed tree instead of via a repo-root-relative four-levels-up
|
|
7
|
+
// path reaching into the top-level scripts/lib/ dir. That path does not
|
|
8
|
+
// resolve in an installed tree (~/.apra-fleet/workflows/fleet-sprint) -- only
|
|
9
|
+
// packages/apra-fleet-se/ is shipped (scripts/ is excluded, see
|
|
10
|
+
// PACKAGE_TREE_EXCLUDE_DIRS in scripts/gen-sea-config.mjs / src/cli/
|
|
11
|
+
// install.ts), so the import used to fail with ERR_MODULE_NOT_FOUND once
|
|
12
|
+
// deployed. scripts/lib/exec-bd.mjs remains the canonical source (still used
|
|
13
|
+
// by scripts/sandbox-seed-beads.mjs and scripts/check-sandbox-sync-remote.mjs,
|
|
14
|
+
// and covered by tests/exec-bd.test.ts) -- keep this copy in sync with it by
|
|
15
|
+
// hand if either changes.
|
|
16
|
+
//
|
|
17
|
+
// Root cause (run-24-adjacent Windows breakage): on Windows the globally
|
|
18
|
+
// installed `bd` (npm's @beads/bd) resolves to npm's extensionless POSIX
|
|
19
|
+
// shim on PATH -- Windows' CreateProcess cannot exec a shebang script
|
|
20
|
+
// directly, so `execFileSync('bd', [...])` (no `{ shell: true }`) throws
|
|
21
|
+
// `spawnSync bd ENOENT` even though the exact same invocation works fine
|
|
22
|
+
// interactively (the interactive shell resolves the PATHEXT-eligible
|
|
23
|
+
// `bd.cmd`/`bd.ps1` shim itself).
|
|
24
|
+
//
|
|
25
|
+
// SAFETY (apra-fleet-2cc.1 review fix): `execBdSync` below does NOT route
|
|
26
|
+
// through `{ shell: true }` on Windows. A 2026-07-30 review found that
|
|
27
|
+
// `{ shell: true }` makes Node join `bd` + every arg into ONE shell command
|
|
28
|
+
// line WITHOUT quoting -- verified empirically that `&`, `;`, `$()` etc.
|
|
29
|
+
// inside an array-passed arg reach cmd.exe as separate tokens/commands, a
|
|
30
|
+
// real injection surface for `scripts/sandbox-seed-beads.mjs`'s
|
|
31
|
+
// caller-controlled `--prefix` and `pathToFileURL(...)`-derived `--remote`
|
|
32
|
+
// values (neither of which `pathToFileURL` percent-encodes). Instead, on
|
|
33
|
+
// win32, `resolveWindowsBdScript()` locates the npm-generated `bd.cmd` shim
|
|
34
|
+
// on PATH and parses out the underlying `.../bin/bd.js` script it wraps
|
|
35
|
+
// (every npm Windows shim, regardless of whether it finds its own bundled
|
|
36
|
+
// `node.exe`, ends in `"<js path>" %*` -- see that function's doc comment),
|
|
37
|
+
// and `execBdSync` invokes THAT script directly via
|
|
38
|
+
// `execFileSync(process.execPath, [scriptPath, ...args])` -- a normal
|
|
39
|
+
// argv-array child-process spawn, no shell involved at all, so no shell
|
|
40
|
+
// metacharacter in any arg can ever be reinterpreted. This is strictly safer
|
|
41
|
+
// than quoting for cmd.exe (notoriously easy to get subtly wrong) and avoids
|
|
42
|
+
// Windows' CreateProcess-cannot-exec-a-shebang-script problem at the same
|
|
43
|
+
// time, since we bypass the `.cmd` file (and its shebang/PATHEXT dance)
|
|
44
|
+
// entirely. On non-Windows platforms `resolveWindowsBdScript()` always
|
|
45
|
+
// returns `null` (a real `bd` binary/symlink there already execs fine via a
|
|
46
|
+
// plain, shell-less `execFileSync('bd', args)`), so POSIX behavior/safety is
|
|
47
|
+
// unchanged from before this fix -- no `{ shell: true }` there either now,
|
|
48
|
+
// closing the same injection surface on POSIX too.
|
|
49
|
+
//
|
|
50
|
+
// If `bd.cmd` cannot be found on PATH or its content does not match the
|
|
51
|
+
// expected npm-shim shape (e.g. a future npm shim-generator format change),
|
|
52
|
+
// `execBdSync` falls back to the pre-fix `{ shell: true }` invocation so a
|
|
53
|
+
// legitimately-installed `bd` still runs rather than hard-failing -- this
|
|
54
|
+
// fallback is the ONLY place this module still carries the shell-quoting
|
|
55
|
+
// risk described above, and is expected to be rare in practice.
|
|
56
|
+
//
|
|
57
|
+
// See also: `execBdAsync` (apra-fleet-xuo.2), the async counterpart used by
|
|
58
|
+
// `packages/apra-fleet-se/src/supervisor/backlog.mjs` and `scope-
|
|
59
|
+
// overlap.mjs`, which additionally validates every arg against an allowlist
|
|
60
|
+
// charset (`assertSafeArgs` below) before its own `{ shell: true }` fallback
|
|
61
|
+
// path could ever see it -- appropriate there because both of ITS callers
|
|
62
|
+
// only ever pass structured bd subcommands/flags/issue-ids, never the kind
|
|
63
|
+
// of free-text values (URLs, operator-supplied prefixes) `execBdSync`'s
|
|
64
|
+
// callers legitimately need to pass through untouched.
|
|
65
|
+
|
|
66
|
+
import { execFileSync as nodeExecFileSync, execFile as nodeExecFile } from 'node:child_process';
|
|
67
|
+
import { promisify } from 'node:util';
|
|
68
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
69
|
+
import path from 'node:path';
|
|
70
|
+
|
|
71
|
+
const nodeExecFileAsync = promisify(nodeExecFile);
|
|
72
|
+
|
|
73
|
+
// ---------------------------------------------------------------------------
|
|
74
|
+
// Child-process stdout buffer (dolt sync budget review round 2, item 1)
|
|
75
|
+
// ---------------------------------------------------------------------------
|
|
76
|
+
//
|
|
77
|
+
// Node's execFile/execFileSync default `maxBuffer` is 1MiB, and exceeding it
|
|
78
|
+
// does not truncate -- it KILLS the child and rejects with
|
|
79
|
+
// ERR_CHILD_PROCESS_STDIO_MAXBUFFER. Measured on this repo's tracker:
|
|
80
|
+
// `bd list --all --limit 0 --json` (scope-overlap.mjs's launch-overlap guard
|
|
81
|
+
// and dashboard.mjs's progress bars) emitted ~2.96MB at 766 issues, i.e. every
|
|
82
|
+
// `POST /api/sprints` launch failed; backlog.mjs's open-only fetch was already
|
|
83
|
+
// at ~967KB (92% of the default) for 234 open issues -- one moderately sized
|
|
84
|
+
// issue from the identical crash.
|
|
85
|
+
//
|
|
86
|
+
// The bound is therefore set HERE, once, so every caller inherits it rather
|
|
87
|
+
// than each call site needing to remember its own. 64MB against a measured
|
|
88
|
+
// ~3.9KB average full row is ~16,500 rows of headroom (the tracker peaked at
|
|
89
|
+
// 1,522 rows before a cleanup), and an unused buffer costs nothing -- Node
|
|
90
|
+
// allocates only what the child actually writes.
|
|
91
|
+
//
|
|
92
|
+
// A caller may still pass its own `maxBuffer` (it is spread AFTER this
|
|
93
|
+
// default, so an explicit value wins); omitting it gets 64MB, never 1MiB.
|
|
94
|
+
|
|
95
|
+
/** Explicit stdout/stderr ceiling for every `bd` invocation. */
|
|
96
|
+
export const BD_MAX_BUFFER_BYTES = 64 * 1024 * 1024;
|
|
97
|
+
|
|
98
|
+
/** Warn once an actual `bd` output crosses this, so growth toward the ceiling
|
|
99
|
+
* above is visible in logs instead of arriving as a silent cliff. */
|
|
100
|
+
export const BD_LARGE_OUTPUT_WARN_BYTES = 8 * 1024 * 1024;
|
|
101
|
+
|
|
102
|
+
/** @param {unknown} out @returns {number} */
|
|
103
|
+
function outputByteLength(out) {
|
|
104
|
+
if (out == null) return 0;
|
|
105
|
+
if (Buffer.isBuffer(out)) return out.length;
|
|
106
|
+
if (typeof out === 'string') return Buffer.byteLength(out);
|
|
107
|
+
return 0;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* Emit a warn line when a `bd` invocation's output crosses
|
|
112
|
+
* BD_LARGE_OUTPUT_WARN_BYTES. Never throws; returns the measured byte length.
|
|
113
|
+
* @param {string[]} args
|
|
114
|
+
* @param {unknown} out
|
|
115
|
+
* @param {(msg: string) => void} [warn]
|
|
116
|
+
* @returns {number}
|
|
117
|
+
*/
|
|
118
|
+
export function warnIfLargeBdOutput(args, out, warn = console.warn) {
|
|
119
|
+
const bytes = outputByteLength(out);
|
|
120
|
+
if (bytes > BD_LARGE_OUTPUT_WARN_BYTES) {
|
|
121
|
+
const mb = (bytes / (1024 * 1024)).toFixed(1);
|
|
122
|
+
const capMb = Math.round(BD_MAX_BUFFER_BYTES / (1024 * 1024));
|
|
123
|
+
try {
|
|
124
|
+
warn(`[exec-bd] WARNING: 'bd ${args.join(' ')}' returned ${mb}MB of output (buffer ceiling is ${capMb}MB). This grows with tracker size; raise BD_MAX_BUFFER_BYTES or narrow the query before it reaches the ceiling.`);
|
|
125
|
+
} catch {
|
|
126
|
+
// A broken logger must never break a bd invocation.
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
return bytes;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* Locates the npm-generated `bd.cmd` shim on PATH and extracts the
|
|
134
|
+
* underlying `bin/bd.js` script path it wraps, so callers can invoke that
|
|
135
|
+
* script directly (`execFileSync(process.execPath, [scriptPath, ...args])`)
|
|
136
|
+
* instead of the `.cmd` file itself -- no shell required at all. Returns
|
|
137
|
+
* `null` (never throws) when: not on win32, `bd.cmd` is not found on any
|
|
138
|
+
* PATH entry, or its content does not match npm's shim shape -- callers
|
|
139
|
+
* treat `null` as "fall back to the pre-fix `{ shell: true }` invocation".
|
|
140
|
+
*
|
|
141
|
+
* npm's Windows shim for a bin script always ends with a line invoking the
|
|
142
|
+
* wrapped script via a DOUBLE-QUOTED path ending in `.js`, immediately
|
|
143
|
+
* followed by `%*` (forward every argv on to the script) -- e.g.:
|
|
144
|
+
* "%_prog%" "%dp0%\node_modules\@beads\bd\bin\bd.js" %*
|
|
145
|
+
* regardless of which of the shim's own two branches picked `_prog` (its
|
|
146
|
+
* bundled `node.exe` if present, else a bare `node` on PATH) -- so matching
|
|
147
|
+
* on that trailing `"<...>.js"` immediately before `%*` is stable across
|
|
148
|
+
* both branches and does not depend on `_prog`'s value at all.
|
|
149
|
+
*
|
|
150
|
+
* @param {{
|
|
151
|
+
* env?: NodeJS.ProcessEnv,
|
|
152
|
+
* platform?: NodeJS.Platform,
|
|
153
|
+
* existsFn?: (p: string) => boolean,
|
|
154
|
+
* readFileFn?: (p: string, enc: string) => string,
|
|
155
|
+
* }} [deps] - injectable for tests, so this is testable on any host platform
|
|
156
|
+
* without depending on a real `bd` install.
|
|
157
|
+
* @returns {string|null}
|
|
158
|
+
*/
|
|
159
|
+
export function resolveWindowsBdScript(deps = {}) {
|
|
160
|
+
const env = deps.env ?? process.env;
|
|
161
|
+
const platform = deps.platform ?? process.platform;
|
|
162
|
+
const existsFn = deps.existsFn ?? existsSync;
|
|
163
|
+
const readFileFn = deps.readFileFn ?? readFileSync;
|
|
164
|
+
if (platform !== 'win32') return null;
|
|
165
|
+
|
|
166
|
+
// Deliberately path.win32, not the bare `path` import: this function
|
|
167
|
+
// models Windows PATH/path semantics (';'-delimited, '\'-separated) even
|
|
168
|
+
// when `platform: 'win32'` is injected on a host actually running
|
|
169
|
+
// POSIX (e.g. these unit tests on macOS/ubuntu CI runners) -- the bare
|
|
170
|
+
// `path` module's `.delimiter`/`.join` follow process.platform, NOT the
|
|
171
|
+
// injected `platform` param, so using it here silently breaks PATH
|
|
172
|
+
// splitting (a Windows PATH entry's drive-letter colon, e.g. 'C:\Users\
|
|
173
|
+
// ...', gets misread as a second POSIX PATH entry split on ':') and path
|
|
174
|
+
// joining (POSIX '/' separators) on any non-Windows host -- exactly the
|
|
175
|
+
// failure this comment fixed (apra-fleet CI regression: 'expected null'
|
|
176
|
+
// on macos-latest/ubuntu-latest, where resolveWindowsBdScript is only
|
|
177
|
+
// ever exercised via this injectable-platform test path).
|
|
178
|
+
const pathDirs = String(env.PATH ?? env.Path ?? '').split(path.win32.delimiter).filter(Boolean);
|
|
179
|
+
for (const dir of pathDirs) {
|
|
180
|
+
const cmdPath = path.win32.join(dir, 'bd.cmd');
|
|
181
|
+
if (!existsFn(cmdPath)) continue;
|
|
182
|
+
let content;
|
|
183
|
+
try {
|
|
184
|
+
content = readFileFn(cmdPath, 'utf-8');
|
|
185
|
+
} catch {
|
|
186
|
+
continue;
|
|
187
|
+
}
|
|
188
|
+
const match = content.match(/"%dp0%\\([^"]+\.js)"\s*%\*/);
|
|
189
|
+
if (!match) continue;
|
|
190
|
+
return path.win32.join(dir, match[1]);
|
|
191
|
+
}
|
|
192
|
+
return null;
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
/**
|
|
196
|
+
* Runs `bd <args>`, safely and cross-platform (see module doc above for the
|
|
197
|
+
* full rationale):
|
|
198
|
+
* - win32: resolves the real `.../bin/bd.js` script `bd.cmd` wraps
|
|
199
|
+
* (`resolveWindowsBdScript()`) and invokes it directly via
|
|
200
|
+
* `execFileSync(process.execPath, [scriptPath, ...args])` -- no shell.
|
|
201
|
+
* - everywhere else, or if that resolution fails: `execFileSync('bd', args)`
|
|
202
|
+
* directly (POSIX) / with `{ shell: true }` (the pre-fix Windows
|
|
203
|
+
* fallback, only reached if `bd.cmd` could not be resolved).
|
|
204
|
+
*
|
|
205
|
+
* @param {string[]} args - argv passed to `bd` (e.g. ['dolt', 'remote', 'list', '--json'])
|
|
206
|
+
* @param {import('node:child_process').ExecFileSyncOptions} [options] - forwarded as-is (cwd, encoding, stdio, ...).
|
|
207
|
+
* @param {typeof nodeExecFileSync} [execFileSyncImpl] - injectable for tests (same signature as `node:child_process`'s `execFileSync`); defaults to the real one.
|
|
208
|
+
* @param {typeof resolveWindowsBdScript} [resolveWindowsBd] - injectable for tests, so the win32-only resolution path is exercisable/deterministic on any host platform.
|
|
209
|
+
* @returns {Buffer|string}
|
|
210
|
+
*/
|
|
211
|
+
export function execBdSync(args, options = {}, execFileSyncImpl = nodeExecFileSync, resolveWindowsBd = resolveWindowsBdScript) {
|
|
212
|
+
if (!Array.isArray(args)) {
|
|
213
|
+
throw new TypeError('execBdSync requires args to be an array of strings');
|
|
214
|
+
}
|
|
215
|
+
const scriptPath = resolveWindowsBd();
|
|
216
|
+
if (scriptPath) {
|
|
217
|
+
const out = execFileSyncImpl(process.execPath, [scriptPath, ...args], { maxBuffer: BD_MAX_BUFFER_BYTES, windowsHide: true, ...options, shell: false });
|
|
218
|
+
warnIfLargeBdOutput(args, out);
|
|
219
|
+
return out;
|
|
220
|
+
}
|
|
221
|
+
// Fallback: pre-fix behavior. On POSIX this is what already worked (a
|
|
222
|
+
// real `bd` binary/symlink execs fine without a shell); on win32 this
|
|
223
|
+
// path is only reached when `bd.cmd` could not be resolved above, and
|
|
224
|
+
// still needs `{ shell: true }` to get past Windows' cannot-exec-a-
|
|
225
|
+
// shebang-script limitation -- see the module doc's fallback note for
|
|
226
|
+
// why this one remaining path still carries the quoting risk.
|
|
227
|
+
const needsShell = (process.platform === 'win32');
|
|
228
|
+
const out = execFileSyncImpl('bd', args, { maxBuffer: BD_MAX_BUFFER_BYTES, windowsHide: true, ...options, shell: needsShell });
|
|
229
|
+
warnIfLargeBdOutput(args, out);
|
|
230
|
+
return out;
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
// execBdAsync's two current callers (backlog.mjs's fetchAllBeadsRaw(),
|
|
234
|
+
// scope-overlap.mjs's bdListChildren()) only ever make structured list/query
|
|
235
|
+
// invocations: bd subcommands/flags (letters, digits, '-', '--'), issue ids
|
|
236
|
+
// (letters/digits/'.'/'_'/'-', same charset runner.js's ISSUE_ID_PATTERN /
|
|
237
|
+
// validateIssueId() already enforce at the launch API boundary), and small
|
|
238
|
+
// numeric values. This allowlist is scoped to THAT usage, not to 'bd' as a
|
|
239
|
+
// whole -- free-text values a different invocation might carry (e.g. `bd
|
|
240
|
+
// create --title "..."`, `--reason=...`) would legitimately contain
|
|
241
|
+
// characters this pattern rejects, which is exactly why `execBdSync` (used by
|
|
242
|
+
// callers that DO pass free text, e.g. sandbox-seed-beads.mjs) does not apply
|
|
243
|
+
// this same validation; a shared allowlist tight enough to be a real
|
|
244
|
+
// injection backstop cannot also cover arbitrary free text.
|
|
245
|
+
const SAFE_ARG_PATTERN = /^[A-Za-z0-9_.\-]+$/;
|
|
246
|
+
|
|
247
|
+
/**
|
|
248
|
+
* Rejects any arg containing a shell metacharacter before it can ever reach
|
|
249
|
+
* `{ shell: true }`. See `execBdAsync`'s doc comment for why this exists.
|
|
250
|
+
* @param {string[]} args
|
|
251
|
+
*/
|
|
252
|
+
function assertSafeArgs(args) {
|
|
253
|
+
for (const a of args) {
|
|
254
|
+
if (typeof a !== 'string' || !SAFE_ARG_PATTERN.test(a)) {
|
|
255
|
+
throw new TypeError(`execBdAsync: unsafe bd argument ${JSON.stringify(a)} (must match ${SAFE_ARG_PATTERN})`);
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
/**
|
|
261
|
+
* Async counterpart to `execBdSync`, for the `execFileAsync`-based callers
|
|
262
|
+
* (apra-fleet-xuo.2): `packages/apra-fleet-se/src/supervisor/backlog.mjs`'s
|
|
263
|
+
* `fetchAllBeadsRaw()` and `scope-overlap.mjs`'s `bdListChildren()` previously
|
|
264
|
+
* each hand-rolled `execFileAsync('bd', [...], { shell: true })` directly.
|
|
265
|
+
*
|
|
266
|
+
* Still uses `{ shell: true }` (required on Windows -- as of the Node
|
|
267
|
+
* CVE-2024-27980 fix, `execFile`/`spawn` refuse to invoke a `.bat`/`.cmd`
|
|
268
|
+
* file directly at all without it, throwing `spawn EINVAL`; there is no
|
|
269
|
+
* shell-free way to resolve the npm-installed `bd.cmd` shim). What changes
|
|
270
|
+
* from a bare `execFileAsync('bd', args, { shell: true })` is `assertSafeArgs()`
|
|
271
|
+
* below: every arg is validated against an allowlist charset BEFORE the
|
|
272
|
+
* shell ever sees it, so the metacharacter-injection risk `shell: true`
|
|
273
|
+
* carries (verified empirically: Node does not safely quote array args for
|
|
274
|
+
* `cmd.exe` -- `&`, `;`, `$()`, `()` inside an argument value all reach the
|
|
275
|
+
* shell as separate tokens/commands on Windows even though args are passed
|
|
276
|
+
* as an array) is closed at the helper level instead of depending on every
|
|
277
|
+
* call site remembering to validate its own caller-controlled values (as
|
|
278
|
+
* `scope-overlap.mjs` already did for `parentId` via `validateIssueId()`).
|
|
279
|
+
*
|
|
280
|
+
* @param {string[]} args - argv passed to `bd` (e.g. ['list', '--json', '--limit', '0']); every element must match `SAFE_ARG_PATTERN`.
|
|
281
|
+
* @param {import('node:child_process').ExecFileOptions} [options] - forwarded as-is (cwd, encoding, ...); `shell` is always forced to `true` regardless of what is passed here.
|
|
282
|
+
* @param {typeof nodeExecFileAsync} [execFileAsyncImpl] - injectable for tests (same signature as `promisify(require('node:child_process').execFile)`); defaults to the real one.
|
|
283
|
+
* @param {(msg: string) => void} [warn] - injectable warn sink for the large-output line.
|
|
284
|
+
* @returns {Promise<{stdout: string|Buffer, stderr: string|Buffer}>}
|
|
285
|
+
*/
|
|
286
|
+
export function execBdAsync(args, options = {}, execFileAsyncImpl = nodeExecFileAsync, warn = console.warn) {
|
|
287
|
+
// Deliberately NOT an `async function`: both argument-shape rejections
|
|
288
|
+
// below must throw SYNCHRONOUSLY (they are programmer errors, and callers
|
|
289
|
+
// /tests rely on it), so the promise chain only starts once the args are
|
|
290
|
+
// known safe.
|
|
291
|
+
if (!Array.isArray(args)) {
|
|
292
|
+
throw new TypeError('execBdAsync requires args to be an array of strings');
|
|
293
|
+
}
|
|
294
|
+
assertSafeArgs(args);
|
|
295
|
+
// maxBuffer first so an explicit caller-supplied value still wins; without
|
|
296
|
+
// it Node's 1MiB default kills the child on a large `bd list` (see the
|
|
297
|
+
// BD_MAX_BUFFER_BYTES block above).
|
|
298
|
+
return Promise.resolve(execFileAsyncImpl('bd', args, { maxBuffer: BD_MAX_BUFFER_BYTES, windowsHide: true, ...options, shell: true }))
|
|
299
|
+
.then((res) => {
|
|
300
|
+
warnIfLargeBdOutput(args, res ? res.stdout : null, warn);
|
|
301
|
+
return res;
|
|
302
|
+
});
|
|
303
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- shared ISO-timestamp log prefix (apra-fleet-k7b.2)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// The 2026-07-30 incident forensics had to recover crash times from
|
|
6
|
+
// `detectedAt` fields inside state files because supervisor-serve.log lines
|
|
7
|
+
// (watchdog/proxy/reconcile/readopt) carried none of their own -- there was
|
|
8
|
+
// no way to answer "when did this log line happen" without cross-referencing
|
|
9
|
+
// a different file. This module is the ONE shared wrapper every one of those
|
|
10
|
+
// four log sites uses, so every future log line an operator greps for in
|
|
11
|
+
// supervisor-serve.log already carries a timestamp, with no risk of the four
|
|
12
|
+
// call sites drifting into four slightly different formats.
|
|
13
|
+
//
|
|
14
|
+
// Deliberately a PREFIX, not a reformat: existing tests/operators grep for
|
|
15
|
+
// substrings like '[watchdog]' / '[reconcile]' / '[proxy]' / '[readopt]' in
|
|
16
|
+
// log output; prepending the ISO stamp before the existing tag preserves
|
|
17
|
+
// every one of those substring matches instead of restructuring the line.
|
|
18
|
+
// =============================================================================
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Wrap a logger so every log/error/warn call is prefixed with an ISO-8601
|
|
22
|
+
* timestamp, ahead of the caller's own message (which keeps its own
|
|
23
|
+
* '[tag]' prefix intact for existing substring-matching tests/greps).
|
|
24
|
+
* A method absent on the source logger (e.g. no `warn`) stays absent on the
|
|
25
|
+
* wrapped logger too, matching every existing `logger.foo?.()` call site's
|
|
26
|
+
* optional-chaining convention.
|
|
27
|
+
*
|
|
28
|
+
* @param {{ log?: Function, error?: Function, warn?: Function }} [logger]
|
|
29
|
+
* @param {() => string} [now] injectable clock, for deterministic tests
|
|
30
|
+
* @returns {{ log?: Function, error?: Function, warn?: Function }}
|
|
31
|
+
*/
|
|
32
|
+
export function withTimestamps(logger = console, now = () => new Date().toISOString()) {
|
|
33
|
+
const wrap = (fn) => {
|
|
34
|
+
if (typeof fn !== 'function') return undefined;
|
|
35
|
+
return (...args) => {
|
|
36
|
+
const [first, ...rest] = args;
|
|
37
|
+
fn(`${now()} ${first}`, ...rest);
|
|
38
|
+
};
|
|
39
|
+
};
|
|
40
|
+
// Deliberately no internal error->log / warn->log fallback here: every
|
|
41
|
+
// existing call site already does its OWN `(logger.error ?? logger.log)`
|
|
42
|
+
// fallback on whatever logger it was handed, so wrapping only the
|
|
43
|
+
// methods actually present (and leaving the rest undefined) keeps that
|
|
44
|
+
// fallback resolution happening exactly where it already did, just with
|
|
45
|
+
// a timestamped function on the other end of it.
|
|
46
|
+
return {
|
|
47
|
+
log: wrap(logger.log ? logger.log.bind(logger) : undefined),
|
|
48
|
+
error: wrap(logger.error ? logger.error.bind(logger) : undefined),
|
|
49
|
+
warn: wrap(logger.warn ? logger.warn.bind(logger) : undefined),
|
|
50
|
+
};
|
|
51
|
+
}
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// fleet-sprint supervisor -- raw per-sprint log serving (apra-fleet-ou7.2)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// Serves `GET /sprints/:id/log`: the raw stdout/stderr file the spawner tees
|
|
6
|
+
// a sprint child's process output to for its whole lifetime (apra-fleet-
|
|
7
|
+
// ou7.1, spawner.mjs's resolveSprintLogPath()). This is the ONE remaining
|
|
8
|
+
// way to see what a sprint's child actually printed once it is CRASHED or
|
|
9
|
+
// FINISHED -- exactly where the live SSE viewer (src/supervisor/proxy.mjs)
|
|
10
|
+
// is gone, since that proxy only reaches a still-running child's port.
|
|
11
|
+
//
|
|
12
|
+
// PATH-TRAVERSAL DISCIPLINE (acceptance criterion)
|
|
13
|
+
// -------------------------------------------------
|
|
14
|
+
// A sprint's logPath is a STORED value, recorded once at claim() time by the
|
|
15
|
+
// SAME resolveSprintLogPath() call that already sanitizes its runId
|
|
16
|
+
// component against traversal (spawner.mjs's own doc comment: no '/', '\\',
|
|
17
|
+
// or '..' can survive that sanitization). This route looks a sprint's
|
|
18
|
+
// logPath up by `:id` as a pure MAP KEY -- `ledger.get(id).logPath`, falling
|
|
19
|
+
// back to the durable history log's own recorded logPath for a sprint whose
|
|
20
|
+
// reservation has since been released -- `:id` is NEVER concatenated into a
|
|
21
|
+
// filesystem path here. A path-traversal payload in `:id` can, at most, fail
|
|
22
|
+
// to match any reservation/history entry and 404; it can never reach outside
|
|
23
|
+
// the logs/ directory. `isSafeSprintId()` (reused from history-view.mjs,
|
|
24
|
+
// never reimplemented) is still applied first, purely for defense in depth
|
|
25
|
+
// and to answer an obviously-malformed id with a clean 400 instead of a
|
|
26
|
+
// silent 404.
|
|
27
|
+
// =============================================================================
|
|
28
|
+
|
|
29
|
+
import fsp from 'node:fs/promises';
|
|
30
|
+
import { isSafeSprintId, sendPlain } from './history-view.mjs';
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Resolve a sprint's recorded raw log file path: the live/still-reserved
|
|
34
|
+
* ledger entry first (covers a running sprint AND any ended sprint whose
|
|
35
|
+
* reservation has not yet been released -- the common case, since finishing
|
|
36
|
+
* does not itself release a reservation), falling back to the durable
|
|
37
|
+
* history log's most recent recorded logPath for a sprint whose reservation
|
|
38
|
+
* HAS since been released (apra-fleet-eft.5.4 restart-abort, or an operator
|
|
39
|
+
* force-release). Returns `null` when neither source has one -- a sprint
|
|
40
|
+
* launched before apra-fleet-ou7.1 shipped never recorded a logPath at all.
|
|
41
|
+
* @param {{ ledger: { get: (id: string) => { logPath?: string|null }|undefined }, history?: { forSprint: (id: string) => Array<{ logPath?: string|null }> } }} deps
|
|
42
|
+
* @param {string} sprintId
|
|
43
|
+
* @returns {string|null}
|
|
44
|
+
*/
|
|
45
|
+
export function resolveLogPath({ ledger, history }, sprintId) {
|
|
46
|
+
const reservation = ledger.get(sprintId);
|
|
47
|
+
if (reservation && reservation.logPath) return reservation.logPath;
|
|
48
|
+
if (history && typeof history.forSprint === 'function') {
|
|
49
|
+
const events = history.forSprint(sprintId);
|
|
50
|
+
for (let i = events.length - 1; i >= 0; i--) {
|
|
51
|
+
if (events[i].logPath) return events[i].logPath;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
return null;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Returns the last `lineCount` non-empty-file lines of `text` (newline-
|
|
59
|
+
* delimited), preserving order. `lineCount` <= 0 or non-integer returns
|
|
60
|
+
* `text` unchanged (full file) -- callers only pass a validated positive
|
|
61
|
+
* integer here in practice (see `handleGet`'s `?tail=` parsing), but this
|
|
62
|
+
* stays defensive on its own.
|
|
63
|
+
* @param {string} text
|
|
64
|
+
* @param {number} lineCount
|
|
65
|
+
* @returns {string}
|
|
66
|
+
*/
|
|
67
|
+
export function tailLines(text, lineCount) {
|
|
68
|
+
if (!Number.isInteger(lineCount) || lineCount <= 0) return text;
|
|
69
|
+
// A log file's own trailing newline would otherwise count as one more
|
|
70
|
+
// (empty) "line" and get picked instead of real content -- strip it
|
|
71
|
+
// before splitting, then restore it on the result, matching the ordinary
|
|
72
|
+
// POSIX tail command's own line-count behavior.
|
|
73
|
+
const hadTrailingNewline = text.endsWith('\n');
|
|
74
|
+
const body = hadTrailingNewline ? text.slice(0, -1) : text;
|
|
75
|
+
const lines = body.split('\n');
|
|
76
|
+
const picked = lines.slice(Math.max(0, lines.length - lineCount)).join('\n');
|
|
77
|
+
return hadTrailingNewline ? `${picked}\n` : picked;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Create the raw-log view seam. Collaborators injected so tests can drive a
|
|
82
|
+
* fake ledger/history/fs without touching the real service data dir.
|
|
83
|
+
*
|
|
84
|
+
* @param {{
|
|
85
|
+
* ledger: { get: (id: string) => { logPath?: string|null }|undefined },
|
|
86
|
+
* history?: { forSprint: (id: string) => Array<object> },
|
|
87
|
+
* readFile?: (p: string, enc: string) => Promise<string>,
|
|
88
|
+
* logger?: { log?: Function, error?: Function },
|
|
89
|
+
* }} [deps]
|
|
90
|
+
* @returns {{
|
|
91
|
+
* name: string,
|
|
92
|
+
* start(): Promise<void>,
|
|
93
|
+
* stop(): Promise<void>,
|
|
94
|
+
* handleGet: Function,
|
|
95
|
+
* resolveLogPath: (sprintId: string) => string|null,
|
|
96
|
+
* }}
|
|
97
|
+
*/
|
|
98
|
+
export function createLogView(deps = {}) {
|
|
99
|
+
const ledger = deps.ledger;
|
|
100
|
+
if (!ledger || typeof ledger.get !== 'function') {
|
|
101
|
+
throw new TypeError('createLogView requires a ledger with a get() method');
|
|
102
|
+
}
|
|
103
|
+
const history = deps.history ?? null;
|
|
104
|
+
const readFile = deps.readFile ?? fsp.readFile;
|
|
105
|
+
const logger = deps.logger ?? console;
|
|
106
|
+
const logError = (...a) => (logger.error ?? logger.log)?.(...a);
|
|
107
|
+
|
|
108
|
+
// GET /sprints/:id/log -- the raw per-sprint log file, present whether the
|
|
109
|
+
// sprint is still live, CRASHED, or FINISHED (apra-fleet-ou7.2, Plan Part
|
|
110
|
+
// 2.3). Optional `?tail=<N>` returns only the last N lines instead of the
|
|
111
|
+
// full file; no other streaming/tailing UI (per the bead's own scope note).
|
|
112
|
+
async function handleGet(req, res, ctx) {
|
|
113
|
+
const sprintId = ctx?.params?.id;
|
|
114
|
+
if (!sprintId) { sendPlain(res, 400, 'missing sprint id in path'); return; }
|
|
115
|
+
if (!isSafeSprintId(sprintId)) {
|
|
116
|
+
sendPlain(res, 400, `invalid sprint id: ${sprintId}`);
|
|
117
|
+
return;
|
|
118
|
+
}
|
|
119
|
+
const logPath = resolveLogPath({ ledger, history }, sprintId);
|
|
120
|
+
if (!logPath) {
|
|
121
|
+
sendPlain(res, 404, `No log recorded for sprint '${sprintId}' (a sprint launched before apra-fleet-ou7.1 shipped never recorded one).`);
|
|
122
|
+
return;
|
|
123
|
+
}
|
|
124
|
+
let content;
|
|
125
|
+
try {
|
|
126
|
+
content = await readFile(logPath, 'utf-8');
|
|
127
|
+
} catch (err) {
|
|
128
|
+
if (err && err.code === 'ENOENT') {
|
|
129
|
+
sendPlain(res, 404, `Log file for sprint '${sprintId}' is recorded but missing on disk.`);
|
|
130
|
+
return;
|
|
131
|
+
}
|
|
132
|
+
logError(`[log-view] failed to read log for '${sprintId}':`, err);
|
|
133
|
+
sendPlain(res, 500, `failed to read log for sprint '${sprintId}'`);
|
|
134
|
+
return;
|
|
135
|
+
}
|
|
136
|
+
const tailParam = ctx?.url?.searchParams?.get('tail');
|
|
137
|
+
const tailN = tailParam != null ? Number(tailParam) : NaN;
|
|
138
|
+
const body = Number.isInteger(tailN) && tailN > 0 ? tailLines(content, tailN) : content;
|
|
139
|
+
sendPlain(res, 200, body);
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
return {
|
|
143
|
+
name: 'log-view',
|
|
144
|
+
async start() {},
|
|
145
|
+
async stop() {},
|
|
146
|
+
handleGet,
|
|
147
|
+
resolveLogPath: (sprintId) => resolveLogPath({ ledger, history }, sprintId),
|
|
148
|
+
};
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* Registers `GET /sprints/:id/log` against a supervisor (server.mjs),
|
|
153
|
+
* mirroring registerHistoryViewRoutes()'s registration pattern.
|
|
154
|
+
* @param {{ route: (method: string, path: string, handler: Function) => void }} supervisor
|
|
155
|
+
* @param {ReturnType<typeof createLogView>} view
|
|
156
|
+
*/
|
|
157
|
+
export function registerLogViewRoutes(supervisor, view) {
|
|
158
|
+
supervisor.route('GET', '/sprints/:id/log', view.handleGet);
|
|
159
|
+
}
|