@apralabs/apra-fleet 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +103 -34
- package/dist/agents/backlog-groomer.md +87 -14
- package/dist/agents/ci-watcher.md +35 -9
- package/dist/agents/deployer.md +63 -11
- package/dist/agents/doer.md +99 -41
- package/dist/agents/harvester.md +47 -27
- package/dist/agents/integ-test-runner.md +38 -10
- package/dist/agents/kb-reconciler.md +37 -7
- package/dist/agents/plan-reviewer.md +145 -32
- package/dist/agents/planner.md +180 -69
- package/dist/agents/regression-test-runner.md +98 -64
- package/dist/agents/reviewer.md +117 -45
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/plan-reviewer-output.json +37 -0
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +90 -2
- package/dist/cli/agent-transform.js +310 -20
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +66 -17
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +31 -6
- package/dist/cli/config.js +113 -36
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +100 -11
- package/dist/cli/install.js +864 -139
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-directives.js +2 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +26 -5
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +3 -0
- package/dist/commands/kb-server.js +52 -5
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +158 -11
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +13 -2
- package/dist/os/linux.js +75 -16
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +78 -4
- package/dist/os/windows-gitbash.d.ts +6 -0
- package/dist/os/windows-gitbash.js +32 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +11 -2
- package/dist/os/windows.js +121 -32
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +120 -7
- package/dist/providers/agy.js +741 -86
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +132 -6
- package/dist/providers/claude.js +644 -48
- package/dist/providers/codex.d.ts +4 -2
- package/dist/providers/codex.js +23 -2
- package/dist/providers/copilot.d.ts +4 -2
- package/dist/providers/copilot.js +24 -2
- package/dist/providers/none.d.ts +4 -2
- package/dist/providers/none.js +17 -2
- package/dist/providers/opencode.d.ts +12 -2
- package/dist/providers/opencode.js +135 -54
- package/dist/providers/provider.d.ts +368 -35
- package/dist/providers/provider.js +219 -2
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +103 -0
- package/dist/services/agy-project.js +354 -0
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +72 -27
- package/dist/services/auth-web.js +2 -2
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +52 -6
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/credential-cleanup.js +35 -17
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/exit-drain.d.ts +44 -0
- package/dist/services/exit-drain.js +52 -0
- package/dist/services/github-app.js +32 -4
- package/dist/services/http-transport.d.ts +50 -1
- package/dist/services/http-transport.js +238 -25
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-config.d.ts +42 -0
- package/dist/services/knowledge/kb-config.js +54 -0
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +11 -1
- package/dist/services/knowledge/kb-providers.js +199 -17
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
- package/dist/services/knowledge/require-sqlite-project.js +38 -0
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +60 -10
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/secret-token.d.ts +38 -0
- package/dist/services/secret-token.js +51 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +39 -2
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +194 -3
- package/dist/services/service-manager/windows.js +705 -30
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +287 -40
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +53 -12
- package/dist/services/stall/stall-detector.d.ts +78 -5
- package/dist/services/stall/stall-detector.js +296 -39
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +165 -19
- package/dist/services/substitution-engine.js +2 -2
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +164 -61
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/vcs/azure-devops.d.ts +66 -1
- package/dist/services/vcs/azure-devops.js +192 -21
- package/dist/services/vcs/types.d.ts +1 -1
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/dist/skills/pm/SKILL.md +4 -4
- package/dist/skills/pm/cost.md +0 -3
- package/dist/skills/pm/fleet-addendum.md +2 -2
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +60 -9
- package/dist/tools/check-status.js +211 -52
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +63 -2
- package/dist/tools/compose-permissions.js +673 -72
- package/dist/tools/credential-store-set.js +1 -1
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +111 -32
- package/dist/tools/execute-prompt.d.ts +69 -12
- package/dist/tools/execute-prompt.js +1610 -895
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +71 -16
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +98 -9
- package/dist/tools/kb-export.js +230 -92
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +16 -8
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +10 -8
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +170 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +33 -11
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +13 -9
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +10 -8
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +146 -27
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +84 -82
- package/dist/tools/list-members.d.ts +2 -2
- package/dist/tools/list-members.js +6 -2
- package/dist/tools/member-detail.d.ts +5 -2
- package/dist/tools/member-detail.js +105 -17
- package/dist/tools/member-reservation.d.ts +60 -3
- package/dist/tools/member-reservation.js +61 -20
- package/dist/tools/provision-auth.d.ts +118 -1
- package/dist/tools/provision-auth.js +402 -92
- package/dist/tools/provision-vcs-auth.d.ts +93 -3
- package/dist/tools/provision-vcs-auth.js +209 -49
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +44 -15
- package/dist/tools/register-member.js +175 -70
- package/dist/tools/remove-member.js +118 -15
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/setup-git-app.js +11 -7
- package/dist/tools/shutdown-server.d.ts +2 -0
- package/dist/tools/shutdown-server.js +28 -1
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +23 -17
- package/dist/tools/update-member.js +181 -18
- package/dist/tools/vcs-credential-exec.d.ts +127 -0
- package/dist/tools/vcs-credential-exec.js +203 -0
- package/dist/types.d.ts +111 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +108 -22
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +11 -2
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +58 -3
- package/dist/utils/shell-escape.js +91 -5
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.d.ts +65 -0
- package/dist/utils/vcs-provider-detect.js +109 -0
- package/dist/utils/workspace-trust.d.ts +26 -0
- package/dist/utils/workspace-trust.js +91 -1
- package/dist/workflows/auto-sprint.js +397 -56
- package/package.json +15 -10
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +864 -31
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +326 -48
- package/packages/apra-fleet-se/bin/serve.mjs +218 -11
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
- package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
- package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
- package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
- package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
- package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
- package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
- package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
- package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
- package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/SKILL.md +8 -8
- package/skills/fleet/auth-azdevops.md +14 -3
- package/skills/fleet/auth-bitbucket.md +2 -2
- package/skills/fleet/auth-github.md +5 -4
- package/skills/fleet/onboarding.md +3 -3
- package/skills/fleet/permissions.md +14 -1
- package/skills/fleet/profiles/node.json +1 -1
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/troubleshooting.md +3 -3
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,234 @@
|
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
import { isInsideSameLineString, skipStringLiteral, maskComments, canStartRegex, skipRegexLiteral } from './dispatch-safety-guard.mjs';
|
|
4
|
+
import { unbracketedPushModulePaths, UNBRACKETED_PUSH_EXEMPT } from './guarded-modules.mjs';
|
|
5
|
+
|
|
6
|
+
// =============================================================================
|
|
7
|
+
// apra-fleet-3swo.4.2 -- unbracketed-push guard checker.
|
|
8
|
+
//
|
|
9
|
+
// Invariant under test: NO scanned module may issue a bare, real call site of
|
|
10
|
+
// doltPushAfter(), syncMemberAfter(), DoltSync.syncBefore() or
|
|
11
|
+
// DoltSync.syncAfter() -- the four raw sync/push primitives -- outside the
|
|
12
|
+
// two structurally-sanctioned wrapper functions (SANCTIONED_WRAPPER_FUNCTIONS
|
|
13
|
+
// below) that are themselves only ever reached from inside an already-open
|
|
14
|
+
// sync bracket (git-sync.mjs's withGitSync() calls syncMemberAfterOrdered();
|
|
15
|
+
// every runner.js call site of verifyDoerStreakClosed() wraps it in
|
|
16
|
+
// gitSync.withOpenSyncBracket()). Every other caller must route through one
|
|
17
|
+
// of createGitSync()'s bracketed entry points (withGitSync,
|
|
18
|
+
// syncBeadsBefore/After, pushBeadsAfter, pushGitAfter) instead of reaching
|
|
19
|
+
// for a primitive directly -- a bare call is exactly the kind of hole
|
|
20
|
+
// apra-fleet-3swo.4.1 closed for the two sites the epic named, and this scan
|
|
21
|
+
// is the regression lock that keeps a future one from reopening either by
|
|
22
|
+
// construction or by adding a NEW hand-rolled call site.
|
|
23
|
+
//
|
|
24
|
+
// MODULE-LIST GENERALIZATION, mirroring dispatch-safety-guard.mjs /
|
|
25
|
+
// dolt-literal-guard.mjs: this guard reads the SHARED guarded-module list
|
|
26
|
+
// (./guarded-modules.mjs) rather than a single hard-coded file, so a bare
|
|
27
|
+
// call that moves out of runner.js into a newly extracted module stays
|
|
28
|
+
// covered. git-sync.mjs is exempted via UNBRACKETED_PUSH_EXEMPT -- it is the
|
|
29
|
+
// ONE module allowed to call these primitives directly, since that IS its
|
|
30
|
+
// bracketed-entry-point implementation (mirrors DOLT_LITERAL_EXEMPT's
|
|
31
|
+
// dolt-sync.mjs precedent for the sibling dolt-literal guard).
|
|
32
|
+
//
|
|
33
|
+
// PER-SITE, NOT PER-FILE: an earlier version of this scan required "exactly
|
|
34
|
+
// one sanctioned call" per whole file, keyed off a local variable name
|
|
35
|
+
// (`gPush = await syncMemberAfter(...)`). That broke on every module with
|
|
36
|
+
// ZERO calls to these primitives (a legitimate, common case once the guard
|
|
37
|
+
// scans the full module list, not just runner.js) and was brittle against an
|
|
38
|
+
// unrelated rename. This version flags each REAL call site individually,
|
|
39
|
+
// exempting only those whose containing function body is one of the two
|
|
40
|
+
// structurally-sanctioned wrappers -- meaningful for any module, including
|
|
41
|
+
// ones that never mention these primitives at all (zero call sites is not a
|
|
42
|
+
// violation).
|
|
43
|
+
// =============================================================================
|
|
44
|
+
|
|
45
|
+
/** The four raw sync/push primitives no module but git-sync.mjs may call bare. */
|
|
46
|
+
const SCANNED_PRIMITIVES = ['doltPushAfter', 'syncMemberAfter', 'DoltSync.syncBefore', 'DoltSync.syncAfter'];
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Function names whose ENTIRE body is only ever reached through an
|
|
50
|
+
* already-open sync bracket, so a bare primitive call inside one is
|
|
51
|
+
* sanctioned:
|
|
52
|
+
* - syncMemberAfterOrdered: git-sync.mjs's withGitSync() is the only
|
|
53
|
+
* caller, and withGitSync() itself always runs inside
|
|
54
|
+
* brackets.withOpenSyncBracket(...).
|
|
55
|
+
* - verifyDoerStreakClosed: every call site in runner.js wraps it in
|
|
56
|
+
* gitSync.withOpenSyncBracket(() => verifyDoerStreakClosed(...)).
|
|
57
|
+
*/
|
|
58
|
+
const SANCTIONED_WRAPPER_FUNCTIONS = ['syncMemberAfterOrdered', 'verifyDoerStreakClosed'];
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Finds every real (non-comment, non-same-line-string, non-declaration) call
|
|
62
|
+
* site of `fnName(` in `src` (fnName may be dotted, e.g. `DoltSync.syncAfter`).
|
|
63
|
+
* Returns `{ index, line, lineText }` for each -- `index` is the character
|
|
64
|
+
* offset of the match, used to test containment inside a sanctioned wrapper's
|
|
65
|
+
* body range.
|
|
66
|
+
*/
|
|
67
|
+
export function findRealCallSites(src, fnName) {
|
|
68
|
+
const escaped = fnName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
69
|
+
const callRe = new RegExp(`(?<![.\\w])${escaped}\\(`, 'g');
|
|
70
|
+
const sites = [];
|
|
71
|
+
let m;
|
|
72
|
+
while ((m = callRe.exec(src)) !== null) {
|
|
73
|
+
const lineStart = src.lastIndexOf('\n', m.index) + 1;
|
|
74
|
+
const lineEnd = src.indexOf('\n', m.index);
|
|
75
|
+
const lineNo = src.slice(0, m.index).split('\n').length;
|
|
76
|
+
const lineText = src.slice(lineStart, lineEnd === -1 ? src.length : lineEnd);
|
|
77
|
+
const trimmed = lineText.trim();
|
|
78
|
+
if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*')) continue;
|
|
79
|
+
if (/^(export\s+)?(async\s+)?function\b/.test(trimmed)) continue; // the function's own declaration
|
|
80
|
+
const col = m.index - lineStart;
|
|
81
|
+
if (isInsideSameLineString(lineText, col)) continue;
|
|
82
|
+
sites.push({ index: m.index, line: lineNo, lineText: trimmed });
|
|
83
|
+
}
|
|
84
|
+
return sites;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* Returns the [start, end) character-offset range of `fnName`'s body --
|
|
89
|
+
* from its opening `{` through the matching closing `}` -- or `null` if no
|
|
90
|
+
* top-level `function fnName(` declaration is found. Tracks brace depth while
|
|
91
|
+
* skipping over string/template-literal contents and comments so a `{`/`}`
|
|
92
|
+
* embedded in a quoted value or a comment never disturbs the count.
|
|
93
|
+
*
|
|
94
|
+
* WHY THIS WALKS A maskComments()-MASKED COPY (apra-fleet-btj9.10): this used
|
|
95
|
+
* to re-implement its own inline comment-skip (`//`, `/*`) ahead of the
|
|
96
|
+
* quote-skip, the exact shape dispatch-safety-guard.mjs's maskComments() had
|
|
97
|
+
* before it learned to recognize regex literals. A regex literal containing
|
|
98
|
+
* a quote or apostrophe inside a SANCTIONED_WRAPPER_FUNCTIONS body (e.g.
|
|
99
|
+
* `const RE = /it's fine/;`) opened the same kind of phantom string that
|
|
100
|
+
* bug produced elsewhere: with no matching apostrophe later in the file, the
|
|
101
|
+
* "string" ran to end-of-file, so every subsequent `}` was read as string
|
|
102
|
+
* content and never closed the wrapper's body -- inflating its detected
|
|
103
|
+
* range to the WHOLE REST OF THE FILE and silently sanctioning every bare
|
|
104
|
+
* primitive call site after it (measured: a `doltPushAfter()` call in a
|
|
105
|
+
* later, unrelated function went unreported). Delegating to the same
|
|
106
|
+
* maskComments() the reference implementation (dispatch-safety-guard.mjs)
|
|
107
|
+
* uses closes this the same way for both call sites -- see that function's
|
|
108
|
+
* own header for the regex-literal handling.
|
|
109
|
+
*
|
|
110
|
+
* A SECOND, subtler instance of the same class of bug (also apra-fleet-
|
|
111
|
+
* btj9.10): maskComments() copies a regex literal's body through VERBATIM,
|
|
112
|
+
* so a quote embedded in one (e.g. `const RE = /it's fine/;`) is still
|
|
113
|
+
* sitting in the returned `masked` text. This function's own quote-skip
|
|
114
|
+
* below, walking that already-masked text a SECOND time, would otherwise
|
|
115
|
+
* re-discover that same apostrophe and misread it as opening a real string
|
|
116
|
+
* -- exactly dispatch-safety-guard.mjs's extractBalancedCall() had to guard
|
|
117
|
+
* against for the identical reason. canStartRegex()/skipRegexLiteral() are
|
|
118
|
+
* reused here (not re-derived) so both walks treat a `/` as a regex start in
|
|
119
|
+
* exactly the same cases maskComments() itself does.
|
|
120
|
+
*/
|
|
121
|
+
function findFunctionBodyRange(src, fnName) {
|
|
122
|
+
const declRe = new RegExp(`(?:export\\s+)?(?:async\\s+)?function\\s+${fnName}\\s*\\(`);
|
|
123
|
+
const decl = declRe.exec(src);
|
|
124
|
+
if (!decl) return null;
|
|
125
|
+
|
|
126
|
+
const masked = maskComments(src);
|
|
127
|
+
|
|
128
|
+
// Skip past the parameter list (balanced parens, so default values
|
|
129
|
+
// containing '(' -- e.g. `opts = {}` never does, but a future
|
|
130
|
+
// `(a = f())` shape would -- do not end the scan early).
|
|
131
|
+
let depth = 0;
|
|
132
|
+
let i = masked.indexOf('(', decl.index);
|
|
133
|
+
for (; i < masked.length; i++) {
|
|
134
|
+
const ch = masked[i];
|
|
135
|
+
if (ch === '(') depth++;
|
|
136
|
+
else if (ch === ')') {
|
|
137
|
+
depth--;
|
|
138
|
+
if (depth === 0) break;
|
|
139
|
+
} else if (ch === '/' && canStartRegex(masked, i)) {
|
|
140
|
+
const end = skipRegexLiteral(masked, i);
|
|
141
|
+
if (end !== -1) i = end;
|
|
142
|
+
} else if (ch === '"' || ch === "'" || ch === '`') {
|
|
143
|
+
i = skipStringLiteral(masked, i, ch);
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
const braceOpen = masked.indexOf('{', i);
|
|
148
|
+
if (braceOpen === -1) return null;
|
|
149
|
+
|
|
150
|
+
depth = 0;
|
|
151
|
+
for (let j = braceOpen; j < masked.length; j++) {
|
|
152
|
+
const ch = masked[j];
|
|
153
|
+
if (ch === '/' && canStartRegex(masked, j)) {
|
|
154
|
+
const end = skipRegexLiteral(masked, j);
|
|
155
|
+
if (end !== -1) j = end;
|
|
156
|
+
continue;
|
|
157
|
+
}
|
|
158
|
+
if (ch === '"' || ch === "'" || ch === '`') {
|
|
159
|
+
j = skipStringLiteral(masked, j, ch);
|
|
160
|
+
continue;
|
|
161
|
+
}
|
|
162
|
+
if (ch === '{') depth++;
|
|
163
|
+
else if (ch === '}') {
|
|
164
|
+
depth--;
|
|
165
|
+
if (depth === 0) return [braceOpen, j];
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
return [braceOpen, masked.length - 1];
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
/**
|
|
172
|
+
* The mechanical scan itself: given a source string, returns every violation
|
|
173
|
+
* -- a real call site of one of SCANNED_PRIMITIVES that does NOT sit inside
|
|
174
|
+
* one of SANCTIONED_WRAPPER_FUNCTIONS' bodies. A module with zero call sites
|
|
175
|
+
* of these primitives reports zero violations (it simply never touches them
|
|
176
|
+
* -- not every module needs to).
|
|
177
|
+
*/
|
|
178
|
+
export function findUnbracketedPushViolations(src, fileLabel = 'source') {
|
|
179
|
+
const violations = [];
|
|
180
|
+
const wrapperRanges = SANCTIONED_WRAPPER_FUNCTIONS
|
|
181
|
+
.map((name) => findFunctionBodyRange(src, name))
|
|
182
|
+
.filter((range) => range !== null);
|
|
183
|
+
|
|
184
|
+
for (const primitive of SCANNED_PRIMITIVES) {
|
|
185
|
+
for (const site of findRealCallSites(src, primitive)) {
|
|
186
|
+
const sanctioned = wrapperRanges.some(([start, end]) => site.index > start && site.index < end);
|
|
187
|
+
if (sanctioned) continue;
|
|
188
|
+
violations.push(`${fileLabel}:${site.line} bare ${primitive}() call site outside any bracket: ${site.lineText}`);
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
return violations;
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
/**
|
|
195
|
+
* Reads and scans the source file at `filePath`, returning { violations }.
|
|
196
|
+
* The path-parameterized entry point -- callers pass a fixture path to prove
|
|
197
|
+
* the scan actually detects a violation without mutating real source.
|
|
198
|
+
*/
|
|
199
|
+
export function checkUnbracketedPushPath(filePath) {
|
|
200
|
+
const src = fs.readFileSync(filePath, 'utf8');
|
|
201
|
+
const fileLabel = path.basename(filePath);
|
|
202
|
+
return { violations: findUnbracketedPushViolations(src, fileLabel) };
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/**
|
|
206
|
+
* Aggregate entry point: scans every module in the SHARED guarded-module list
|
|
207
|
+
* (./guarded-modules.mjs), MINUS UNBRACKETED_PUSH_EXEMPT, and returns the
|
|
208
|
+
* union of their violations. Follows checkModules()/checkDoltLiteralModules()
|
|
209
|
+
* -- the dispatch-safety-guard.mjs / dolt-literal-guard.mjs reference
|
|
210
|
+
* implementations -- so a bare primitive call that moves out of runner.js
|
|
211
|
+
* into a newly extracted module stays covered instead of silently falling
|
|
212
|
+
* out of scan scope. Defines no list of its own.
|
|
213
|
+
*
|
|
214
|
+
* @param {string[]} [paths]
|
|
215
|
+
* @returns {{ violations: string[], files: string[], skipped: string[] }}
|
|
216
|
+
*/
|
|
217
|
+
export function checkUnbracketedPushModules(paths = unbracketedPushModulePaths()) {
|
|
218
|
+
if (!Array.isArray(paths)) {
|
|
219
|
+
throw new TypeError('checkUnbracketedPushModules(paths): paths must be an array of file paths');
|
|
220
|
+
}
|
|
221
|
+
const violations = [];
|
|
222
|
+
const files = [];
|
|
223
|
+
const skipped = [];
|
|
224
|
+
for (const p of paths) {
|
|
225
|
+
const file = path.basename(p);
|
|
226
|
+
if (UNBRACKETED_PUSH_EXEMPT.includes(file)) {
|
|
227
|
+
skipped.push(file);
|
|
228
|
+
continue;
|
|
229
|
+
}
|
|
230
|
+
files.push(file);
|
|
231
|
+
violations.push(...checkUnbracketedPushPath(p).violations);
|
|
232
|
+
}
|
|
233
|
+
return { violations, files, skipped };
|
|
234
|
+
}
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
// apra-fleet-hzeb.4.2 -- fleet-sprint usage-limit pause/resume/re-probe
|
|
2
|
+
// controller.
|
|
3
|
+
//
|
|
4
|
+
// This module owns the cooperative-pause control loop a role dispatch enters
|
|
5
|
+
// when a provider reports a usage/rate limit (execute_prompt relays it as an
|
|
6
|
+
// AgentDispatchError whose details.reason === 'usage_limit', carrying the
|
|
7
|
+
// provider's UsageLimitSignal on details.usageLimit). It is INJECTED into
|
|
8
|
+
// dispatch-role.mjs as ctx.onUsageLimit by runner.js -- never imported there,
|
|
9
|
+
// so the engine stays free of runner-side primitives (requestPause/
|
|
10
|
+
// requestResume/agent) and this loop stays unit-testable with an injected
|
|
11
|
+
// clock, sleep and agent (no real waits, no live fleet).
|
|
12
|
+
//
|
|
13
|
+
// WHY A DEDICATED MODULE (not inline in runner.js): the probe is a REAL
|
|
14
|
+
// agent() dispatch, and runner.js's dispatch-safety census pins its own
|
|
15
|
+
// agent() call-site count at zero now that every role ladder runs through the
|
|
16
|
+
// dispatchRole engine. Housing the probe here keeps that census intact while
|
|
17
|
+
// still guarding this dispatch site under the shared guarded-module list
|
|
18
|
+
// (member_name is spelled explicitly at the call site, exactly as
|
|
19
|
+
// dispatch-safety-guard.mjs requires).
|
|
20
|
+
//
|
|
21
|
+
// WHAT THIS DOES NOT DO: it never invents its own wait window. The guessed
|
|
22
|
+
// one-hour fallback is the PROVIDER adapter's (provider.ts's
|
|
23
|
+
// DEFAULT_USAGE_LIMIT_RESUME_MS, surfaced on the signal's resumeAt); this
|
|
24
|
+
// controller only ever reads the signal's resumeAt or steps the reprobe
|
|
25
|
+
// backoff ladder from role-policies.mjs. It deliberately hard-codes no
|
|
26
|
+
// millisecond wait window of its own.
|
|
27
|
+
//
|
|
28
|
+
// KNOWN SIMPLIFICATIONS (apra-fleet-hzeb.10 -- documented, not fixed here):
|
|
29
|
+
// (1) the pause this controller requests is SPRINT-WIDE, not per-member --
|
|
30
|
+
// only the rate-limited `member` is re-probed above; every other member's
|
|
31
|
+
// dispatches are simply gated by the engine's cooperative pause rather than
|
|
32
|
+
// each being individually probed for its own usage limit.
|
|
33
|
+
// (2) a pause held longer than ~30 minutes (DEFAULT_IDLE_TIMEOUT_MS in
|
|
34
|
+
// src/services/cloud/idle-manager.ts) can let the idle manager suspend a
|
|
35
|
+
// cloud member's VM while it sits reservation-released during the wait;
|
|
36
|
+
// ensureCloudReady (src/tools/execute-prompt.ts) transparently restarts it
|
|
37
|
+
// on the probe dispatch above, so this is logged but given no special
|
|
38
|
+
// handling here.
|
|
39
|
+
import { CancelledError } from '@apralabs/apra-fleet-workflow';
|
|
40
|
+
import { isUsageLimitDispatchError, usageLimitOf, UsageLimitWaitExhaustedError } from './errors.mjs';
|
|
41
|
+
import { USAGE_LIMIT_BUDGET_DEFAULTS } from './role-policies.mjs';
|
|
42
|
+
|
|
43
|
+
// A minimal, target-agnostic probe. Its ONLY purpose is to observe whether the
|
|
44
|
+
// member still trips the usage limit, so it is the shortest possible real
|
|
45
|
+
// dispatch: one turn, a one-line generic prompt (no target-repo assumptions,
|
|
46
|
+
// no bead ids -- check-generic-boundary.mjs), a fresh session, a short timeout.
|
|
47
|
+
const PROBE_PROMPT = 'Reply with the single word: ok.';
|
|
48
|
+
const PROBE_TIMEOUT_S = 60;
|
|
49
|
+
|
|
50
|
+
/** The default injected sleep: a non-blocking timer that keeps the event loop
|
|
51
|
+
* (and the viewer's /state endpoint) responsive while the sprint is paused. */
|
|
52
|
+
function defaultSleep(ms) {
|
|
53
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* Builds the ctx.onUsageLimit controller dispatch-role.mjs arms when a role's
|
|
58
|
+
* retry.usageLimitPause is set.
|
|
59
|
+
*
|
|
60
|
+
* @param {object} deps
|
|
61
|
+
* @param {(reason: string, opts?: { resumeAt?: string, source?: string }) => (void|Promise<void>)} deps.requestPause
|
|
62
|
+
* engine cooperative-pause primitive (script-facing, apra-fleet-hzeb.3): pausing
|
|
63
|
+
* releases member reservations, the watchdog reads PAUSED, and the dashboard
|
|
64
|
+
* shows the expected resume time.
|
|
65
|
+
* @param {(reason: string) => Promise<void>} deps.requestResume
|
|
66
|
+
* engine resume primitive; its pre-resume hook re-reserves + resyncs the
|
|
67
|
+
* member as a HARD BARRIER before the probe dispatch runs.
|
|
68
|
+
* @param {(prompt: string, opts: object) => Promise<any>} deps.agent the
|
|
69
|
+
* runner's dispatch function, used for the one real re-probe dispatch.
|
|
70
|
+
* @param {(msg: string) => void} [deps.log]
|
|
71
|
+
* @param {object} [deps.budgets] usage-limit budgets (USAGE_LIMIT_MAX_WAIT_S,
|
|
72
|
+
* USAGE_LIMIT_MAX_REPROBES, USAGE_LIMIT_MIN_WAIT_S,
|
|
73
|
+
* USAGE_LIMIT_REPROBE_BACKOFF_MS); each falls back to
|
|
74
|
+
* USAGE_LIMIT_BUDGET_DEFAULTS.
|
|
75
|
+
* @param {() => number} [deps.now] injected epoch-ms clock (default Date.now).
|
|
76
|
+
* @param {(ms: number) => Promise<void>} [deps.sleep] injected timer (default a
|
|
77
|
+
* real non-blocking setTimeout).
|
|
78
|
+
* @returns {(args: { member: string, roleLabel: string, signal: object|null,
|
|
79
|
+
* sessionId?: string|null, tier?: string }) =>
|
|
80
|
+
* Promise<{ resumed: true } | { resumed: false, error: Error }>}
|
|
81
|
+
*/
|
|
82
|
+
export function createUsageLimitPauseController({
|
|
83
|
+
requestPause,
|
|
84
|
+
requestResume,
|
|
85
|
+
agent,
|
|
86
|
+
log = () => {},
|
|
87
|
+
budgets = {},
|
|
88
|
+
now = () => Date.now(),
|
|
89
|
+
sleep = defaultSleep,
|
|
90
|
+
} = {}) {
|
|
91
|
+
const maxWaitS = budgets.USAGE_LIMIT_MAX_WAIT_S ?? USAGE_LIMIT_BUDGET_DEFAULTS.USAGE_LIMIT_MAX_WAIT_S;
|
|
92
|
+
const maxReprobes = budgets.USAGE_LIMIT_MAX_REPROBES ?? USAGE_LIMIT_BUDGET_DEFAULTS.USAGE_LIMIT_MAX_REPROBES;
|
|
93
|
+
const minWaitS = budgets.USAGE_LIMIT_MIN_WAIT_S ?? USAGE_LIMIT_BUDGET_DEFAULTS.USAGE_LIMIT_MIN_WAIT_S;
|
|
94
|
+
const backoffLadder = budgets.USAGE_LIMIT_REPROBE_BACKOFF_MS ?? USAGE_LIMIT_BUDGET_DEFAULTS.USAGE_LIMIT_REPROBE_BACKOFF_MS;
|
|
95
|
+
const maxWaitMs = maxWaitS * 1000;
|
|
96
|
+
const minWaitMs = minWaitS * 1000;
|
|
97
|
+
|
|
98
|
+
// `sessionId` (the session that hit the limit) is part of the caller's
|
|
99
|
+
// payload but deliberately unused here: the probe is a FRESH dispatch
|
|
100
|
+
// (resume:false), so it never resumes the limited session. It is left off
|
|
101
|
+
// the destructure rather than bound-and-ignored to keep the linter quiet.
|
|
102
|
+
return async function onUsageLimit({ member, roleLabel, signal, tier } = {}) {
|
|
103
|
+
const firstHitAt = now();
|
|
104
|
+
// The signal that drives THIS pause: the failing dispatch's signal
|
|
105
|
+
// first, then whatever fresh signal each reprobe reports (or null,
|
|
106
|
+
// which drops onto the backoff ladder).
|
|
107
|
+
let currentSignal = signal || null;
|
|
108
|
+
let reprobes = 0;
|
|
109
|
+
let waitedMs = 0;
|
|
110
|
+
let lastResumeAt = currentSignal && currentSignal.resumeAt ? currentSignal.resumeAt : null;
|
|
111
|
+
|
|
112
|
+
const exhausted = () => new UsageLimitWaitExhaustedError(
|
|
113
|
+
`Usage limit on member ${member} (${roleLabel}) did not clear within the allowed ` +
|
|
114
|
+
`wait budget (${maxWaitS}s / ${maxReprobes} reprobes)` +
|
|
115
|
+
(lastResumeAt ? `; last reported resume time was ${lastResumeAt}.` : '.'),
|
|
116
|
+
{
|
|
117
|
+
member,
|
|
118
|
+
roleLabel,
|
|
119
|
+
firstHitAt,
|
|
120
|
+
lastResumeAt: lastResumeAt ? new Date(lastResumeAt).getTime() : null,
|
|
121
|
+
reprobes,
|
|
122
|
+
waitedMs,
|
|
123
|
+
}
|
|
124
|
+
);
|
|
125
|
+
|
|
126
|
+
for (;;) {
|
|
127
|
+
const remainingMs = maxWaitMs - waitedMs;
|
|
128
|
+
if (remainingMs <= 0) return { resumed: false, error: exhausted() };
|
|
129
|
+
|
|
130
|
+
// Wait for THIS pause. Trust the provider's own resumeAt when it
|
|
131
|
+
// gave one (parsed or guessed -- either way it is the signal's, not
|
|
132
|
+
// ours); otherwise step the reprobe backoff ladder. NEVER a
|
|
133
|
+
// hard-coded window here.
|
|
134
|
+
let targetMs;
|
|
135
|
+
let source;
|
|
136
|
+
if (currentSignal && currentSignal.resumeAt) {
|
|
137
|
+
targetMs = new Date(currentSignal.resumeAt).getTime() - now();
|
|
138
|
+
source = currentSignal.resumeAtSource || 'parsed';
|
|
139
|
+
lastResumeAt = currentSignal.resumeAt;
|
|
140
|
+
} else {
|
|
141
|
+
targetMs = backoffLadder[Math.min(reprobes, backoffLadder.length - 1)];
|
|
142
|
+
source = 'backoff';
|
|
143
|
+
}
|
|
144
|
+
// Clamp: never below the floor, never past the remaining budget.
|
|
145
|
+
const waitMs = Math.min(Math.max(targetMs, minWaitMs), remainingMs);
|
|
146
|
+
|
|
147
|
+
log(
|
|
148
|
+
`usage limit on member ${member} (${roleLabel}): source=${source}` +
|
|
149
|
+
(lastResumeAt ? `, resumeAt=${lastResumeAt}` : '') +
|
|
150
|
+
`, pausing ~${Math.round(waitMs / 1000)}s (reprobe ${reprobes}/${maxReprobes}).`
|
|
151
|
+
);
|
|
152
|
+
|
|
153
|
+
// Pause the whole run through the engine primitive. dispatch-role.mjs
|
|
154
|
+
// guarantees this runs OUTSIDE any git-sync bracket, so the
|
|
155
|
+
// clean-state pause guard engages the pause here rather than
|
|
156
|
+
// deferring it forever.
|
|
157
|
+
await requestPause(
|
|
158
|
+
`usage limit on member ${member} (${roleLabel})`,
|
|
159
|
+
{ ...(lastResumeAt ? { resumeAt: lastResumeAt } : {}), source: 'usage_limit' }
|
|
160
|
+
);
|
|
161
|
+
// Sleep on the injected timer (never a blocking loop). A cooperative
|
|
162
|
+
// stop taken here surfaces on the next resume/probe below and is
|
|
163
|
+
// propagated, never swallowed.
|
|
164
|
+
await sleep(waitMs);
|
|
165
|
+
waitedMs += waitMs;
|
|
166
|
+
// Resume: the engine's pre-resume hook re-reserves + resyncs the
|
|
167
|
+
// member (a MemberReservationResumeError propagates as today).
|
|
168
|
+
await requestResume(`usage limit wait elapsed on member ${member} (${roleLabel})`);
|
|
169
|
+
|
|
170
|
+
// Probe before trusting the clock: one real dispatch to the same
|
|
171
|
+
// member at the same tier.
|
|
172
|
+
try {
|
|
173
|
+
// Deliberately NOT strict (no fail_on_permission_denial): the
|
|
174
|
+
// probe only tests whether the member answers at all after a
|
|
175
|
+
// usage-limit wait, it runs no tools, and a permission refusal
|
|
176
|
+
// there says nothing about the usage limit. A refusal must not
|
|
177
|
+
// be read as a usage limit (isUsageLimitDispatchError matches
|
|
178
|
+
// only the usage_limit reason) nor abort the wait: any such
|
|
179
|
+
// outcome falls through to the inconclusive-probe handling below.
|
|
180
|
+
await agent(PROBE_PROMPT, {
|
|
181
|
+
member_name: member,
|
|
182
|
+
...(tier ? { model: tier } : {}),
|
|
183
|
+
max_turns: 1,
|
|
184
|
+
resume: false,
|
|
185
|
+
timeout_s: PROBE_TIMEOUT_S,
|
|
186
|
+
label: `usage-limit re-probe: ${member}`,
|
|
187
|
+
});
|
|
188
|
+
// Probe succeeded -- the member is usable again.
|
|
189
|
+
return { resumed: true };
|
|
190
|
+
} catch (probeErr) {
|
|
191
|
+
// A cooperative stop (requestStop -> CancelledError) taken
|
|
192
|
+
// during the pause is NOT a probe failure: propagate it so an
|
|
193
|
+
// operator stop still tears the run down mid-pause. Never
|
|
194
|
+
// swallowed by the inconclusive-probe path below.
|
|
195
|
+
if (probeErr instanceof CancelledError) throw probeErr;
|
|
196
|
+
if (isUsageLimitDispatchError(probeErr)) {
|
|
197
|
+
reprobes += 1;
|
|
198
|
+
// Prefer the probe's OWN fresh signal (a new parsed
|
|
199
|
+
// resumeAt); absent one, the next pass drops onto the
|
|
200
|
+
// backoff ladder.
|
|
201
|
+
currentSignal = usageLimitOf(probeErr) || null;
|
|
202
|
+
if (reprobes > maxReprobes || waitedMs >= maxWaitMs) {
|
|
203
|
+
return { resumed: false, error: exhausted() };
|
|
204
|
+
}
|
|
205
|
+
continue;
|
|
206
|
+
}
|
|
207
|
+
// Any OTHER probe outcome (a transient busy/transport error) is
|
|
208
|
+
// inconclusive: log it and let the real re-dispatch be the final
|
|
209
|
+
// test rather than burning a reprobe on an unrelated fault.
|
|
210
|
+
log(
|
|
211
|
+
`usage limit re-probe for member ${member} (${roleLabel}) was inconclusive ` +
|
|
212
|
+
`(${probeErr && probeErr.message ? probeErr.message : probeErr}) -- proceeding to re-dispatch.`
|
|
213
|
+
);
|
|
214
|
+
return { resumed: true };
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
};
|
|
218
|
+
}
|