@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,613 @@
|
|
|
1
|
+
import path from 'path';
|
|
2
|
+
import { fileURLToPath } from 'url';
|
|
3
|
+
|
|
4
|
+
// =============================================================================
|
|
5
|
+
// SHARED GUARDED-MODULE LIST -- the single place a newly extracted fleet-sprint
|
|
6
|
+
// module is registered for mechanical guard coverage.
|
|
7
|
+
//
|
|
8
|
+
// WHY THIS EXISTS: every mechanical guard in this directory
|
|
9
|
+
// (dispatch-safety-guard.mjs, dolt-literal-guard.mjs, full-db-fetch-guard.mjs,
|
|
10
|
+
// shell-command-guard.mjs, unbracketed-push-guard.mjs) was originally pointed
|
|
11
|
+
// at ONE hard-coded file -- runner.js -- by each of its own tests. runner.js
|
|
12
|
+
// is being decomposed into smaller modules; under the old wiring, the moment
|
|
13
|
+
// a guarded construct moved out of runner.js into a newly extracted module,
|
|
14
|
+
// EVERY guard silently stopped covering it while continuing to report a green
|
|
15
|
+
// baseline. That is the exact failure mode this list prevents: extract a
|
|
16
|
+
// module, add ONE line here, and all five guards pick it up at once.
|
|
17
|
+
//
|
|
18
|
+
// REGISTERING A NEWLY EXTRACTED MODULE: add its filename to GUARDED_MODULES
|
|
19
|
+
// below. Do not add a second list anywhere else, and do not re-point an
|
|
20
|
+
// individual guard at its own private array of paths -- a guard that does not
|
|
21
|
+
// consume this list is a guard whose coverage silently rots.
|
|
22
|
+
//
|
|
23
|
+
// STANDING RULE (from apra-fleet-3swo.8): registering a newly extracted module
|
|
24
|
+
// is part of the extraction bead itself, not a follow-up bead. guarded-modules.mjs
|
|
25
|
+
// and the guard test files that consume it (dispatch-safety-guard.test.mjs,
|
|
26
|
+
// dolt-literal-guard.test.mjs, full-db-fetch-tripwire.test.mjs,
|
|
27
|
+
// guarded-modules-coverage.test.mjs, pause-guard-push-holes.test.mjs) are a
|
|
28
|
+
// single mutex resource; any future bead that adds a line here MUST belong to
|
|
29
|
+
// the same streak as, or run after, whatever else is editing them.
|
|
30
|
+
//
|
|
31
|
+
// NESTED ENTRIES ARE LEGAL (first used by apra-fleet-3swo.6.2's phases/*
|
|
32
|
+
// modules): guardedModulePath() path.joins a 'dir/file.mjs' entry, so it
|
|
33
|
+
// resolves and scans exactly like a flat one. What differs is REPORTING --
|
|
34
|
+
// every guard labels a scanned file by path.basename() -- so a baseline that
|
|
35
|
+
// compares a guard's `files` output must use guardedModuleBasenames(), never
|
|
36
|
+
// GUARDED_MODULES verbatim. Note the COMPLETENESS check in
|
|
37
|
+
// guarded-modules-coverage.test.mjs deliberately compares FULL RELATIVE PATHS
|
|
38
|
+
// instead, so a nested module can never ride on an unrelated entry that
|
|
39
|
+
// merely shares its bare filename.
|
|
40
|
+
//
|
|
41
|
+
// WHAT DOES *NOT* BELONG HERE: the per-shell command builders --
|
|
42
|
+
// se-posix.mjs, se-windows.mjs, se-windows-gitbash.mjs, se-os-commands.mjs and
|
|
43
|
+
// dolt-settle.mjs. They deliberately emit `$HOME`, `$env:USERPROFILE`,
|
|
44
|
+
// `$env:TEMP` and `$( )` because they ARE the OS-branched command surface the
|
|
45
|
+
// shell-command invariant tells everyone else to route through; scanning them
|
|
46
|
+
// would report their entire reason for existing as violations. Likewise
|
|
47
|
+
// dolt-sync.mjs, which legitimately builds the `bd dolt pull`/`bd dolt push`
|
|
48
|
+
// command strings (see DOLT_LITERAL_EXEMPT below and dolt-literal-guard.mjs's
|
|
49
|
+
// own header).
|
|
50
|
+
// =============================================================================
|
|
51
|
+
|
|
52
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Filenames (relative to this directory) of every fleet-sprint module the
|
|
56
|
+
* mechanical guards must scan. Add a newly extracted module here -- this is
|
|
57
|
+
* the single registration point.
|
|
58
|
+
*/
|
|
59
|
+
export const GUARDED_MODULES = [
|
|
60
|
+
'runner.js',
|
|
61
|
+
'vcs-auth.mjs',
|
|
62
|
+
'mcp-result.mjs',
|
|
63
|
+
'member-target.mjs',
|
|
64
|
+
'member-call.mjs',
|
|
65
|
+
'abort.mjs',
|
|
66
|
+
'branch-ensure.mjs',
|
|
67
|
+
'prompts.mjs',
|
|
68
|
+
'worklists.mjs',
|
|
69
|
+
'sprint-args.mjs',
|
|
70
|
+
'backlog-role.mjs',
|
|
71
|
+
'git-sync.mjs',
|
|
72
|
+
'coordination.mjs',
|
|
73
|
+
'kb.mjs',
|
|
74
|
+
// Per-repository kb_maintainer selection. Issues no fleet call itself
|
|
75
|
+
// (every member access is injected by runner.js), registered so a future
|
|
76
|
+
// direct call added here is scanned from the start.
|
|
77
|
+
'kb-maintainer.mjs',
|
|
78
|
+
// KB hint building and KNOWLEDGE BANK injection gating: pure / injected
|
|
79
|
+
// (the diff-file listing is a runner.js-supplied callback), no direct command().
|
|
80
|
+
'kb-hints.mjs',
|
|
81
|
+
'kb-injection.mjs',
|
|
82
|
+
// Pure lower-quality banner derivation; no command() site.
|
|
83
|
+
'lower-quality.mjs',
|
|
84
|
+
'beads-scope.mjs',
|
|
85
|
+
'beads-transitions.mjs',
|
|
86
|
+
'role-policies.mjs',
|
|
87
|
+
'inline-ladder-guard.mjs',
|
|
88
|
+
// apra-fleet-3swo.5.3: the dispatchRole engine. It hosts the ONE real
|
|
89
|
+
// agent() dispatch every migrated role ladder now runs through, so it
|
|
90
|
+
// must be scanned by dispatch-safety-guard (member_name at the call
|
|
91
|
+
// site) exactly like the runner.js ladders it replaces.
|
|
92
|
+
'dispatch-role.mjs',
|
|
93
|
+
// apra-fleet-3swo.6.1: the per-sprint resolved state (the sprint-scoped
|
|
94
|
+
// fleet client every settle-shell resolution shares, plus the relocated
|
|
95
|
+
// per-member VCS provider resolver). It builds no member-bound command
|
|
96
|
+
// string today, but it is the module every future phase module asks for
|
|
97
|
+
// the member's resolved shell -- exactly the input the shell-command
|
|
98
|
+
// invariant is about -- so it is registered from the start rather than
|
|
99
|
+
// retrofitted later.
|
|
100
|
+
'sprint-state.mjs',
|
|
101
|
+
// apra-fleet-3swo.6.2: the first two phase modules sliced out of
|
|
102
|
+
// runSprintCycle. These are the first NESTED entries in this list --
|
|
103
|
+
// guardedModulePath() path.joins them, so they resolve and scan
|
|
104
|
+
// correctly, but every guard labels a scanned file by path.basename(),
|
|
105
|
+
// so they are always REPORTED as 'ensure-sprint-branch.mjs' and
|
|
106
|
+
// 'plan.mjs'. Any baseline assertion must therefore compare against
|
|
107
|
+
// guardedModuleBasenames() rather than GUARDED_MODULES verbatim (see
|
|
108
|
+
// that function's doc comment below).
|
|
109
|
+
//
|
|
110
|
+
// ensure-sprint-branch.mjs took EIGHT member_name-bearing command() call
|
|
111
|
+
// sites out of runner.js (now TEN -- see the POST-EXTRACTION FIX note in
|
|
112
|
+
// that file's header for the two diagnostic-only tip-SHA probes added by
|
|
113
|
+
// apra-fleet-3swo's fleet-mac regression investigation) and plan.mjs took
|
|
114
|
+
// THREE, which is exactly why both are registered as part of the
|
|
115
|
+
// extraction rather than afterwards: guarded dispatch sites would
|
|
116
|
+
// otherwise leave runner.js's scanned surface and land in files no guard
|
|
117
|
+
// reads, with every guard still green.
|
|
118
|
+
'phases/ensure-sprint-branch.mjs',
|
|
119
|
+
'phases/plan.mjs',
|
|
120
|
+
// apra-fleet-3swo.6.7: the next two phase modules sliced out of
|
|
121
|
+
// runSprintCycle, both from INSIDE its Develop/Review round loop. Same
|
|
122
|
+
// nested-entry reporting caveat as the pair above (they are always
|
|
123
|
+
// REPORTED as 'replan.mjs' and 'develop.mjs'), so the same rule applies:
|
|
124
|
+
// compare a guard's `files` output against guardedModuleBasenames().
|
|
125
|
+
//
|
|
126
|
+
// Neither took a command() call site out of runner.js -- replan.mjs's only
|
|
127
|
+
// repo-side effect is a shared gitSync bracket, and develop.mjs reaches bd
|
|
128
|
+
// exclusively through runner-exported helpers it is handed -- but each
|
|
129
|
+
// took TWO dispatchRole() call sites (the scoped planner + scoped
|
|
130
|
+
// plan-reviewer, and the streak-assignment + doer ladders). Those are
|
|
131
|
+
// exactly what dispatch-safety-guard and the phase 3 dispatch census read,
|
|
132
|
+
// so registering them as part of the extraction is what keeps the census
|
|
133
|
+
// whole instead of quietly shrinking runner.js's scanned surface.
|
|
134
|
+
'phases/replan.mjs',
|
|
135
|
+
'phases/develop.mjs',
|
|
136
|
+
// apra-fleet-3swo.6.5: the per-round Review and the per-cycle Deploy
|
|
137
|
+
// phases. Same nested-entry reporting caveat as the four above (they are
|
|
138
|
+
// always REPORTED as 'review.mjs' and 'deploy.mjs'), so the same rule
|
|
139
|
+
// applies: compare a guard's `files` output against
|
|
140
|
+
// guardedModuleBasenames().
|
|
141
|
+
//
|
|
142
|
+
// review.mjs took ONE member_name-bearing command() call site out of
|
|
143
|
+
// runner.js (the `bd show <ids> --json` acceptance-criteria read) and NO
|
|
144
|
+
// dispatchRole site -- the reviewer ladder runs through runner.js's
|
|
145
|
+
// dispatchReview() helper, which the Review and Re-Review phases share
|
|
146
|
+
// (runner.js:2494 and :2762; Final Review does not receive it -- see the
|
|
147
|
+
// apra-fleet-3swo.65 correction below), so it stayed there. deploy.mjs
|
|
148
|
+
// took no command() site but ONE
|
|
149
|
+
// dispatchRole site (the deployer ladder). Registering both as part of the
|
|
150
|
+
// extraction is what keeps the guarded command census and the phase 3
|
|
151
|
+
// dispatch census whole instead of quietly shrinking runner.js's scanned
|
|
152
|
+
// surface.
|
|
153
|
+
'phases/review.mjs',
|
|
154
|
+
'phases/deploy.mjs',
|
|
155
|
+
// apra-fleet-3swo.6.8: the per-cycle Integ Test and the Re-Review that
|
|
156
|
+
// Cycle Evaluation dispatches when the goal-priority count reads 0 but no
|
|
157
|
+
// review ran this cycle. Same nested-entry reporting caveat as the six
|
|
158
|
+
// above (they are always REPORTED as 'integ-test.mjs' and
|
|
159
|
+
// 're-review.mjs'), so the same rule applies: compare a guard's `files`
|
|
160
|
+
// output against guardedModuleBasenames().
|
|
161
|
+
//
|
|
162
|
+
// integ-test.mjs took TWO member_name-bearing command() call sites out of
|
|
163
|
+
// runner.js -- the verify-fail bounce cap's `bd show <bugId> --json` parent
|
|
164
|
+
// lookup and its `bd update <parentId> --status=deferred --append-notes`
|
|
165
|
+
// deferral -- plus ONE dispatchRole site (the integ-test-runner ladder).
|
|
166
|
+
// re-review.mjs took NEITHER: its reopen/newTask writes go through
|
|
167
|
+
// applyGuardedReopens (beads-transitions.mjs) and
|
|
168
|
+
// createChildBeadWithAllocatedId/computeChildFloor, whose command() sites
|
|
169
|
+
// live in the modules that own them, and the reviewer ladder runs through
|
|
170
|
+
// runner.js's shared dispatchReview() helper, which the Review phase
|
|
171
|
+
// (runner.js:2494) also calls -- NOT Final Review, which passes no
|
|
172
|
+
// dispatchReview at all (runner.js:2834; see apra-fleet-3swo.65). A grep
|
|
173
|
+
// for `dispatchReview` across phases/ overcounts: the identifier also
|
|
174
|
+
// appears inside a shared boilerplate comment ("No duplicate log() dump
|
|
175
|
+
// -- see dispatchReview() for why") that SEVEN files carry verbatim --
|
|
176
|
+
// phases/harvest.mjs, phases/plan.mjs, phases/develop.mjs,
|
|
177
|
+
// phases/integ-test.mjs, phases/final-review.mjs, phases/deploy.mjs and
|
|
178
|
+
// phases/regression-test.mjs -- none of which actually receive the
|
|
179
|
+
// helper. Registering both as part of the extraction is what keeps the
|
|
180
|
+
// guarded command census and the phase 3 dispatch census whole instead of
|
|
181
|
+
// quietly shrinking runner.js's scanned surface.
|
|
182
|
+
'phases/integ-test.mjs',
|
|
183
|
+
'phases/re-review.mjs',
|
|
184
|
+
// apra-fleet-3swo.6.6: the sprint's closing Final Review and the
|
|
185
|
+
// once-per-sprint Regression Test. Same nested-entry reporting caveat as
|
|
186
|
+
// the eight above (they are always REPORTED as 'final-review.mjs' and
|
|
187
|
+
// 'regression-test.mjs'), so the same rule applies: compare a guard's
|
|
188
|
+
// `files` output against guardedModuleBasenames().
|
|
189
|
+
//
|
|
190
|
+
// NEITHER took a member_name-bearing command() call site out of runner.js
|
|
191
|
+
// -- final-review.mjs reads beads through the injected bdListScoped and
|
|
192
|
+
// writes them through applyGuardedReopens (beads-transitions.mjs) and
|
|
193
|
+
// computeChildFloor/createChildBeadWithAllocatedId, whose command() sites
|
|
194
|
+
// live in the modules that own them, and regression-test.mjs issues no
|
|
195
|
+
// bd/git command at all (its carry-over beads are filed by the DISPATCHED
|
|
196
|
+
// runner inside its own repo). Each took exactly ONE dispatchRole() site
|
|
197
|
+
// (the final-review and regression-test-runner ladders), which is what
|
|
198
|
+
// dispatch-safety-guard and the phase 3 dispatch census read.
|
|
199
|
+
// final-review.mjs additionally owns a real gitSync bracket at each end,
|
|
200
|
+
// including the findings D-push that apra-fleet-3swo.4.1 brought inside a
|
|
201
|
+
// bracket -- registering it here is what keeps unbracketed-push-guard
|
|
202
|
+
// covering that push instead of silently losing it.
|
|
203
|
+
'phases/final-review.mjs',
|
|
204
|
+
'phases/regression-test.mjs',
|
|
205
|
+
// apra-fleet-3swo.6.9: the LAST two phase modules -- Harvest and Publish
|
|
206
|
+
// PR -- which complete the runSprintCycle slice. Same nested-entry
|
|
207
|
+
// reporting caveat as the ten above (they are always REPORTED as
|
|
208
|
+
// 'harvest.mjs' and 'publish-pr.mjs'), so the same rule applies: compare a
|
|
209
|
+
// guard's `files` output against guardedModuleBasenames().
|
|
210
|
+
//
|
|
211
|
+
// harvest.mjs took NO member_name-bearing command() call site out of
|
|
212
|
+
// runner.js -- the docs/sprint-analysis commits are made by the
|
|
213
|
+
// DISPATCHED harvester inside its own repo and published by the 'harvester'
|
|
214
|
+
// policy row's pushCode/pushBeads bracket -- but it took ONE dispatchRole()
|
|
215
|
+
// site (the harvester ladder), which is what dispatch-safety-guard and the
|
|
216
|
+
// phase 3 dispatch census read.
|
|
217
|
+
//
|
|
218
|
+
// publish-pr.mjs is the opposite shape and the more urgent of the two to
|
|
219
|
+
// register: it took TWO member_name-bearing command() call sites out of
|
|
220
|
+
// runner.js (the `git remote get-url origin` capability probe on the
|
|
221
|
+
// git-capable publish member, and the per-target-issue `bd close` on the
|
|
222
|
+
// orchestrator for a remote that can never open a PR) and NO dispatchRole
|
|
223
|
+
// site, AND it owns the sprint branch's own push --
|
|
224
|
+
// gitSync.pushGitAfter(), the bracketed entry point apra-fleet-3swo.4.1
|
|
225
|
+
// put that push behind. Registering it here is what keeps
|
|
226
|
+
// unbracketed-push-guard covering that push instead of silently losing the
|
|
227
|
+
// one site the guard exists for.
|
|
228
|
+
'phases/harvest.mjs',
|
|
229
|
+
'phases/publish-pr.mjs',
|
|
230
|
+
// apra-fleet-3swo.6.3: the git-topology layer sliced out of runner.js --
|
|
231
|
+
// the pre-sprint multi-member topology precondition (checkMemberTopology),
|
|
232
|
+
// the ONE git-failure classifier (classifyGitFailure) and the fail-closed
|
|
233
|
+
// provider lookup that feeds it, the retrying git-command primitive every
|
|
234
|
+
// sync bracket issues its commands through (runGitStep), and the
|
|
235
|
+
// exit-code-based soft-git result adapter (commandResultToSoftGit).
|
|
236
|
+
//
|
|
237
|
+
// It took exactly ONE member_name-bearing command() call site out of
|
|
238
|
+
// runner.js -- runGitStep's single `command(cmd, { member_name: member,
|
|
239
|
+
// silent: true, failSoft: true, label })` dispatch, which EVERY bracketed
|
|
240
|
+
// git command in this package funnels through (syncMemberBefore/After/
|
|
241
|
+
// AfterOrdered here, detectAndAbortRebaseConflict in conflict-ladder.mjs,
|
|
242
|
+
// and abort.mjs's three finalize-path git calls). That makes it the single
|
|
243
|
+
// highest-traffic guarded dispatch site in fleet-sprint, so registering it
|
|
244
|
+
// with the extraction is what keeps dispatch-safety-guard covering it
|
|
245
|
+
// instead of silently losing it the moment it left runner.js.
|
|
246
|
+
'git-topology.mjs',
|
|
247
|
+
// apra-fleet-rsd9.1.1: launch-time member alignment (alignMembersToBase,
|
|
248
|
+
// prepareLaunchTopology). It issues every git command through an injected
|
|
249
|
+
// per-member runGit(cmd, member) -- fetches go through git-topology.mjs's
|
|
250
|
+
// runGitStep -- so it adds no command() call site of its own, but it
|
|
251
|
+
// builds member-bound command strings, which is exactly what the
|
|
252
|
+
// shell-command and dolt-literal guards must keep scanning.
|
|
253
|
+
'member-align.mjs',
|
|
254
|
+
// apra-fleet-3swo.6.10: the per-member git sync BRACKETS that sit on top of
|
|
255
|
+
// git-topology.mjs -- syncMemberBefore (G-pull), syncMemberAfter (G-push
|
|
256
|
+
// plus its bounded pull-rebase retry and Tier 2 conflict dispatch),
|
|
257
|
+
// syncMemberAfterOrdered (the ordered G-push-then-D-push post-dispatch
|
|
258
|
+
// step) and resyncReacquiredMember (the resume path's re-reconciliation).
|
|
259
|
+
//
|
|
260
|
+
// It took exactly ONE member_name-bearing command() call site out of
|
|
261
|
+
// runner.js -- syncMemberAfter's `command('git status --porcelain', {
|
|
262
|
+
// member_name: member, ... })` clean-state read, the mechanical re-check
|
|
263
|
+
// that decides whether a Tier 2 conflict-resolution dispatch really
|
|
264
|
+
// resolved anything. The other three brackets issue every git command
|
|
265
|
+
// through git-topology.mjs's runGitStep, and resyncReacquiredMember runs
|
|
266
|
+
// entirely on injected runners, so none of them adds a site here.
|
|
267
|
+
//
|
|
268
|
+
// Registering it with the extraction is load-bearing TWICE over, and the
|
|
269
|
+
// second reason is the subtle one: unbracketed-push-guard.mjs resolves its
|
|
270
|
+
// sanctioned-wrapper ranges (syncMemberAfterOrdered, verifyDoerStreakClosed)
|
|
271
|
+
// BY NAME WITHIN EACH SCANNED FILE. syncMemberAfterOrdered's bare
|
|
272
|
+
// syncMemberAfter() and DoltSync.syncAfter() calls are sanctioned only
|
|
273
|
+
// because the wrapper declaring them travelled here with them -- so this
|
|
274
|
+
// file must be scanned for that sanction to mean anything, and a future
|
|
275
|
+
// bare primitive added here outside that wrapper must still go red.
|
|
276
|
+
'member-sync.mjs',
|
|
277
|
+
// apra-fleet-3swo.6.12: the member-provisioning helpers sliced out of
|
|
278
|
+
// runner.js -- createMemberSessionGuard (the pre-resume stop_prompt
|
|
279
|
+
// guard), createUnattendedAutoProvisioner, createDeployPermissionsProvisioner
|
|
280
|
+
// and stageCommandBodyMemberSide.
|
|
281
|
+
//
|
|
282
|
+
// It took exactly TWO member_name-bearing command() call sites out of
|
|
283
|
+
// runner.js: createDeployPermissionsProvisioner's `node -e ...` read of
|
|
284
|
+
// deploy.md's Permissions section, and stageCommandBodyMemberSide's
|
|
285
|
+
// `node -e ...` member-side temp-file write. Both are shell-agnostic
|
|
286
|
+
// (base64-encoded argv, no `$`-expansion/backticks/template literals),
|
|
287
|
+
// which is exactly the invariant shell-command-guard.mjs enforces here.
|
|
288
|
+
// A THIRD site was added since: createPermissionConfigPreflight's
|
|
289
|
+
// per-OS/shell file-exists probe (SeOsCommands.fileExistsProbe, a
|
|
290
|
+
// validated literal path, no member environment reads).
|
|
291
|
+
// resolveSettleShell stayed in runner.js (module-private composition-root
|
|
292
|
+
// wiring anchored there by test/sprint-state.test.mjs) and is not part of
|
|
293
|
+
// this module's surface.
|
|
294
|
+
'member-provisioning.mjs',
|
|
295
|
+
// apra-fleet-3swo.6.13: the child-bead allocation and batched-claim
|
|
296
|
+
// command surface sliced out of runner.js -- computeChildFloor,
|
|
297
|
+
// createChildBeadWithAllocatedId, verifyDoerStreakClosed and
|
|
298
|
+
// claimBeadsBatched.
|
|
299
|
+
//
|
|
300
|
+
// It took exactly FIVE member_name-bearing command() call sites out of
|
|
301
|
+
// runner.js: computeChildFloor's `bd list --parent` read, createChild-
|
|
302
|
+
// BeadWithAllocatedId's TWO sites (`bd create --body-file` and the
|
|
303
|
+
// explicit-id path's `bd update --parent` link), verifyDoerStreakClosed's
|
|
304
|
+
// `bd show <ids> --json` post-D-pull read, and claimBeadsBatched's `bd
|
|
305
|
+
// update ... --claim --json` batch. Registering it with the extraction is
|
|
306
|
+
// load-bearing TWICE over, same as git-topology.mjs/member-sync.mjs
|
|
307
|
+
// above: verifyDoerStreakClosed is also one of unbracketed-push-guard.mjs's
|
|
308
|
+
// two SANCTIONED_WRAPPER_FUNCTIONS (its DoltSync.syncBefore() call is only
|
|
309
|
+
// sanctioned because that function's OWN declaration -- and therefore its
|
|
310
|
+
// body range -- is found by scanning this file), so this module must be
|
|
311
|
+
// scanned for that sanction to mean anything.
|
|
312
|
+
'beads-children.mjs',
|
|
313
|
+
// apra-fleet-3swo.6.14: the PR-body/cost-report text surface
|
|
314
|
+
// (sprint-report.mjs: sanitizePrText, buildAnalysisText, buildCostAnalysis,
|
|
315
|
+
// computeBranchSlug) and the verdict/newTask text surface
|
|
316
|
+
// (newtask-text.mjs: extractContestedBeadIds, SAFE_TEXT_RE,
|
|
317
|
+
// normalizeTierToken, trackRejectedNewTaskForResurfacing,
|
|
318
|
+
// clearResubmittedNewTask, reconcilePendingRejectedNewTasks,
|
|
319
|
+
// buildRejectedNewTaskResurfaceLines), both sliced out of runner.js.
|
|
320
|
+
//
|
|
321
|
+
// Neither took a member_name-bearing command() or agent() call site out of
|
|
322
|
+
// runner.js -- every one of these eleven symbols is pure text
|
|
323
|
+
// formatting/validation with no bd/git/dispatch surface of its own -- so
|
|
324
|
+
// both get a ZERO baseline in dispatch-safety-guard.test.mjs. The zero is
|
|
325
|
+
// not a formality: it is what turns a future raw command()/agent() landing
|
|
326
|
+
// in either file into a red test instead of a silently unguarded site.
|
|
327
|
+
'sprint-report.mjs',
|
|
328
|
+
// The sprint PR title/body builder (markdown, run-history block) shared by
|
|
329
|
+
// the Publish PR phase and the [ABORTED] PR path. Pure text: no command(),
|
|
330
|
+
// no agent(), no push -- registered so a future dispatch landing here is
|
|
331
|
+
// caught rather than silently unguarded.
|
|
332
|
+
'pr-body.mjs',
|
|
333
|
+
'newtask-text.mjs',
|
|
334
|
+
// apra-fleet-fsxg: the parent-NOTES staleness signal. Its pure core is text
|
|
335
|
+
// formatting, but collectParentNotesStalenessNotes carries TWO member_name-
|
|
336
|
+
// bearing command() call sites (`bd list --parent <id> --json` and `bd
|
|
337
|
+
// history <id> --json`), so it must be scanned by dispatch-safety-guard
|
|
338
|
+
// exactly like any other guarded command surface -- see its own explicit
|
|
339
|
+
// baseline (EXPECTED_PARENT_NOTES_STALENESS_COMMAND_COUNT) in
|
|
340
|
+
// dispatch-safety-guard.test.mjs.
|
|
341
|
+
'parent-notes-staleness.mjs',
|
|
342
|
+
// apra-fleet-3swo.6.15: the round-resume session registry
|
|
343
|
+
// (round-session.mjs: DEFAULT_CONTEXT_CEILING, createRoundSessionRegistry)
|
|
344
|
+
// and the dispatch-outcome classification surface (dispatch-failure.mjs:
|
|
345
|
+
// isTerminalSprintFailure, isNoMutationDispatchFailure,
|
|
346
|
+
// withDispatchWatchdog), both sliced out of runner.js.
|
|
347
|
+
//
|
|
348
|
+
// Neither took a member_name-bearing command() or agent() call site out of
|
|
349
|
+
// runner.js -- round-session.mjs is a pure in-memory session map with no
|
|
350
|
+
// bd/git/dispatch surface, and dispatch-failure.mjs only CLASSIFIES an
|
|
351
|
+
// already-thrown error or races an already-in-flight dispatch PROMISE
|
|
352
|
+
// (dispatch-role.mjs owns the one real agent() call site that promise
|
|
353
|
+
// comes from) -- so both get a ZERO baseline in
|
|
354
|
+
// dispatch-safety-guard.test.mjs. The zero is not a formality: it is what
|
|
355
|
+
// turns a future raw command()/agent() landing in either file into a red
|
|
356
|
+
// test instead of a silently unguarded site.
|
|
357
|
+
'round-session.mjs',
|
|
358
|
+
'dispatch-failure.mjs',
|
|
359
|
+
// apra-fleet-3swo.6.16: the fatal-diagnostics guard
|
|
360
|
+
// (installFatalDiagnosticsGuard) and the terminal-state Dolt-conflict
|
|
361
|
+
// classification helpers (findDoltDivergedCause, resolveTerminalReason,
|
|
362
|
+
// captureDoltConflictDump), sliced out of runner.js.
|
|
363
|
+
//
|
|
364
|
+
// None of the four owns a member_name-bearing command() or dispatchRole()
|
|
365
|
+
// call site out of runner.js -- installFatalDiagnosticsGuard only wires
|
|
366
|
+
// process-level event listeners, and the other three purely classify an
|
|
367
|
+
// already-thrown error's `.cause` chain -- so this module gets a ZERO
|
|
368
|
+
// baseline in dispatch-safety-guard.test.mjs, same as sprint-report.mjs/
|
|
369
|
+
// newtask-text.mjs/round-session.mjs/dispatch-failure.mjs above. The zero
|
|
370
|
+
// is not a formality: it is what turns a future raw command()/agent()
|
|
371
|
+
// landing in this file into a red test instead of a silently unguarded
|
|
372
|
+
// site.
|
|
373
|
+
'fatal-diagnostics.mjs',
|
|
374
|
+
// apra-fleet-3swo.25: the remaining fleet-sprint modules that scan clean
|
|
375
|
+
// (zero violations) across all five guards. Registered together so the
|
|
376
|
+
// completeness test (guarded-modules-coverage.test.mjs) has nothing left
|
|
377
|
+
// unaccounted for besides GUARD_REGISTRATION_EXEMPT below.
|
|
378
|
+
'conflict-ladder.mjs',
|
|
379
|
+
'contracts.mjs',
|
|
380
|
+
'dispatch-safety-guard.mjs',
|
|
381
|
+
'errors.mjs',
|
|
382
|
+
'full-db-fetch-guard.mjs',
|
|
383
|
+
'shell-command-guard.mjs',
|
|
384
|
+
'sprint-lock.mjs',
|
|
385
|
+
'sprint-progress.mjs',
|
|
386
|
+
// apra-fleet-hzeb.4.2: the usage-limit pause/resume/re-probe controller.
|
|
387
|
+
// It carries ONE real agent() re-probe dispatch, which names its member
|
|
388
|
+
// explicitly, so it scans clean under dispatch-safety-guard and is
|
|
389
|
+
// registered here (not exempted) to keep that live dispatch site guarded.
|
|
390
|
+
'usage-limit-controller.mjs',
|
|
391
|
+
'unbracketed-push-guard.mjs',
|
|
392
|
+
// apra-fleet-btj9.7: the explicit-id-create guard checker. Registered
|
|
393
|
+
// normally (not exempted) like unbracketed-push-guard.mjs above -- it
|
|
394
|
+
// issues no command()/agent() call of its own (its 'bd create' mentions
|
|
395
|
+
// are all prose inside comments/messages, never a dispatched call), so it
|
|
396
|
+
// scans clean under itself and every other guard rather than needing a
|
|
397
|
+
// GUARD_REGISTRATION_EXEMPT carve-out.
|
|
398
|
+
'explicit-id-create-guard.mjs',
|
|
399
|
+
// The beads identity contract (pure parse/compare helpers, no command()
|
|
400
|
+
// or agent() site -- zero baseline) and the precondition that runs its
|
|
401
|
+
// three read-only probes: beads-identity-check.mjs carries TWO
|
|
402
|
+
// member_name-bearing command() call sites (the probe loop and the
|
|
403
|
+
// member beads set-up runner; its beads pull goes through DoltSync),
|
|
404
|
+
// which is exactly what dispatch-safety-guard must keep scanning.
|
|
405
|
+
'beads-identity.mjs',
|
|
406
|
+
'beads-identity-check.mjs',
|
|
407
|
+
// The sprint-start token-usage memory sweep: TWO member_name-bearing
|
|
408
|
+
// command() sites (the memory list and the per-key forget), no agent(),
|
|
409
|
+
// and its push goes through an injected bracketed callback.
|
|
410
|
+
'beads-memory-hygiene.mjs',
|
|
411
|
+
// The engine CI gate: ONE member_name-bearing command() site (the
|
|
412
|
+
// origin-remote read on the git-capable member), no agent(), no push.
|
|
413
|
+
'ci-gate.mjs',
|
|
414
|
+
'vcs-module.mjs',
|
|
415
|
+
'viewer-extensions.mjs',
|
|
416
|
+
// Per-dispatch kb_* and code_* accounting: reads session_stats through the
|
|
417
|
+
// injected memberCall around each dispatch. No command() or agent() site.
|
|
418
|
+
'dispatch-accounting.mjs',
|
|
419
|
+
// The per-member sprint-init probe: kb_*/code_* calls through the injected
|
|
420
|
+
// memberCall, member_detail on the orchestrator session, and ONE
|
|
421
|
+
// member-bound command channel (fleetApi.executeCommand, command strings
|
|
422
|
+
// built by getSeCommands().wrapForMember) for the remote start-if-down.
|
|
423
|
+
'member-init-probe.mjs',
|
|
424
|
+
// In-run orphaned-claim bookkeeping (pure): no command() or agent() site;
|
|
425
|
+
// runner.js owns the fresh read, the session stop and the write.
|
|
426
|
+
'orphan-reclaim.mjs',
|
|
427
|
+
// Verify-block deadlock diagnosis (pure): no command() or agent() site;
|
|
428
|
+
// runner.js owns the runbook probes, the stop and the mid-run exit.
|
|
429
|
+
'verify-block.mjs',
|
|
430
|
+
'vcs-providers/azure-devops.mjs',
|
|
431
|
+
'vcs-providers/bitbucket.mjs',
|
|
432
|
+
'vcs-providers/dolt.mjs',
|
|
433
|
+
'vcs-providers/generic-git.mjs',
|
|
434
|
+
'vcs-providers/github.mjs',
|
|
435
|
+
'vcs-providers/index.mjs',
|
|
436
|
+
'vcs-providers/shell-helpers.mjs',
|
|
437
|
+
];
|
|
438
|
+
|
|
439
|
+
/**
|
|
440
|
+
* Modules the dolt-literal guard must NEVER scan, by basename. dolt-sync.mjs
|
|
441
|
+
* is the single permitted dolt command surface: it builds the literal
|
|
442
|
+
* `bd dolt pull` / `bd dolt push` strings on purpose (apra-fleet-417.2.1/
|
|
443
|
+
* 417.2.2), so pointing the dolt-literal guard at it would flag the sync
|
|
444
|
+
* module for being the sync module. Documented verbatim in
|
|
445
|
+
* dolt-literal-guard.mjs's header; enforced here so the exemption survives
|
|
446
|
+
* anyone adding dolt-sync.mjs to GUARDED_MODULES (or passing it explicitly).
|
|
447
|
+
*/
|
|
448
|
+
export const DOLT_LITERAL_EXEMPT = ['dolt-sync.mjs'];
|
|
449
|
+
|
|
450
|
+
/**
|
|
451
|
+
* Modules the unbracketed-push guard (unbracketed-push-guard.mjs) must NEVER
|
|
452
|
+
* scan, by basename. git-sync.mjs is the single module allowed to call the
|
|
453
|
+
* raw doltPushAfter()/syncMemberAfter()/DoltSync.syncBefore()/
|
|
454
|
+
* DoltSync.syncAfter() primitives directly: that IS the bracketed-entry-point
|
|
455
|
+
* implementation the guard exists to protect (apra-fleet-3swo.4.1/.4.2), so
|
|
456
|
+
* pointing the guard at git-sync.mjs itself would flag the module for being
|
|
457
|
+
* the module. Mirrors DOLT_LITERAL_EXEMPT's precedent for dolt-sync.mjs
|
|
458
|
+
* above.
|
|
459
|
+
*/
|
|
460
|
+
export const UNBRACKETED_PUSH_EXEMPT = ['git-sync.mjs'];
|
|
461
|
+
|
|
462
|
+
/**
|
|
463
|
+
* Modules the explicit-id create guard (explicit-id-create-guard.mjs) must
|
|
464
|
+
* NEVER scan, by basename. beads-children.mjs is the single module allowed to
|
|
465
|
+
* issue a `bd create` command AT ALL (the guard flags any `bd create` site,
|
|
466
|
+
* not just ones carrying a literal `--id` flag -- see that file's header for
|
|
467
|
+
* why): it is the only place the probe-and-refuse seam (assertChildIdFree(),
|
|
468
|
+
* called from createChildBeadWithAllocatedId, apra-fleet-btj9.7) sits
|
|
469
|
+
* immediately before that create, so pointing the guard at beads-children.mjs
|
|
470
|
+
* itself would flag the module for being the module. Mirrors
|
|
471
|
+
* DOLT_LITERAL_EXEMPT's precedent for dolt-sync.mjs above.
|
|
472
|
+
*/
|
|
473
|
+
export const EXPLICIT_ID_CREATE_EXEMPT = ['beads-children.mjs'];
|
|
474
|
+
|
|
475
|
+
/**
|
|
476
|
+
* apra-fleet-3swo.25: modules deliberately excluded from GUARDED_MODULES
|
|
477
|
+
* ENTIRELY -- never registered, never scanned by any of the five guards --
|
|
478
|
+
* keyed by filename (relative to this directory, same convention as
|
|
479
|
+
* GUARDED_MODULES) with a non-empty written reason as the value.
|
|
480
|
+
*
|
|
481
|
+
* This is a DIFFERENT kind of exemption than DOLT_LITERAL_EXEMPT/
|
|
482
|
+
* UNBRACKETED_PUSH_EXEMPT above: those two keep a module registered and
|
|
483
|
+
* scanned by the other four guards, filtering it out of ONE guard only. An
|
|
484
|
+
* entry here is not registered at all, because scanning it with ANY guard
|
|
485
|
+
* would report the module's entire reason for existing (or the guard's own
|
|
486
|
+
* detection logic) as a violation of itself.
|
|
487
|
+
* guarded-modules-coverage.test.mjs asserts every *.mjs/*.js file found by a
|
|
488
|
+
* RECURSIVE walk of this directory is present in either GUARDED_MODULES or
|
|
489
|
+
* this map -- so a module can no longer silently fall through both lists.
|
|
490
|
+
*/
|
|
491
|
+
export const GUARD_REGISTRATION_EXEMPT = {
|
|
492
|
+
// The five shell builders -- reasons reused verbatim from this file's own
|
|
493
|
+
// "WHAT DOES NOT BELONG HERE" header above (do not re-derive them).
|
|
494
|
+
'se-posix.mjs':
|
|
495
|
+
'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
|
|
496
|
+
'OS-branched command surface the shell-command invariant tells everyone else to route ' +
|
|
497
|
+
'through; scanning it would report its entire reason for existing as violations.',
|
|
498
|
+
'se-windows.mjs':
|
|
499
|
+
'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
|
|
500
|
+
'OS-branched command surface the shell-command invariant tells everyone else to route ' +
|
|
501
|
+
'through; scanning it would report its entire reason for existing as violations.',
|
|
502
|
+
'se-windows-gitbash.mjs':
|
|
503
|
+
'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
|
|
504
|
+
'OS-branched command surface the shell-command invariant tells everyone else to route ' +
|
|
505
|
+
'through; scanning it would report its entire reason for existing as violations.',
|
|
506
|
+
'se-os-commands.mjs':
|
|
507
|
+
'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
|
|
508
|
+
'OS-branched command surface the shell-command invariant tells everyone else to route ' +
|
|
509
|
+
'through; scanning it would report its entire reason for existing as violations.',
|
|
510
|
+
'dolt-settle.mjs':
|
|
511
|
+
'deliberately emits `$HOME`, `$env:USERPROFILE`, `$env:TEMP` and `$( )` because it IS the ' +
|
|
512
|
+
'OS-branched command surface the shell-command invariant tells everyone else to route ' +
|
|
513
|
+
'through; scanning it would report its entire reason for existing as violations.',
|
|
514
|
+
// dolt-sync.mjs -- reason reused verbatim from the same header (do not
|
|
515
|
+
// re-derive it).
|
|
516
|
+
'dolt-sync.mjs':
|
|
517
|
+
'legitimately builds the `bd dolt pull`/`bd dolt push` command strings (see ' +
|
|
518
|
+
'DOLT_LITERAL_EXEMPT above and dolt-literal-guard.mjs\'s own header).',
|
|
519
|
+
|
|
520
|
+
// apra-fleet-3swo.25: dolt-literal-guard.mjs -- confirmed guard-detection
|
|
521
|
+
// false positive. dolt-literal-guard.mjs has no per-line suppression
|
|
522
|
+
// mechanism (unlike shell-command-guard.mjs's shell-guard-allow
|
|
523
|
+
// directive, used instead for the other siblings this bead registers --
|
|
524
|
+
// see contracts.mjs, vcs-module.mjs and vcs-providers/{index,shell-
|
|
525
|
+
// helpers}.mjs, all now registered above with per-line allow comments),
|
|
526
|
+
// so this one file is exempted here rather than registered.
|
|
527
|
+
'dolt-literal-guard.mjs':
|
|
528
|
+
'dolt-literal-guard\'s own violation-message text builds the literal phrase \'bd dolt pull\'/' +
|
|
529
|
+
'\'bd dolt push\' to describe what it detects, which the guard then flags as a ' +
|
|
530
|
+
'self-referential violation of its own implementation, and the guard has no per-line ' +
|
|
531
|
+
'suppression mechanism (unlike shell-command-guard.mjs) to carve out just that one line.',
|
|
532
|
+
// guarded-modules.mjs itself: this map's own reason strings (and the
|
|
533
|
+
// shell-builder header above) necessarily QUOTE the shell-syntax
|
|
534
|
+
// substrings ($HOME, $(, ~/, 'bd dolt pull'/'bd dolt push', etc.) they
|
|
535
|
+
// describe, in real JS string literals -- which the dolt-literal and
|
|
536
|
+
// shell-command guards' naive text-matching then flags as this file
|
|
537
|
+
// issuing/emitting those constructs itself. Same self-referential class
|
|
538
|
+
// of false positive as dolt-literal-guard.mjs and shell-command-guard.mjs
|
|
539
|
+
// above (confirmed by scanning this file with GUARD_REGISTRATION_EXEMPT
|
|
540
|
+
// populated), not a real dispatched command or shell expansion.
|
|
541
|
+
'guarded-modules.mjs':
|
|
542
|
+
'this map\'s own reason strings (and the header above) necessarily quote the shell-syntax ' +
|
|
543
|
+
'and dolt-command substrings they describe, in real JS string literals, which the ' +
|
|
544
|
+
'dolt-literal and shell-command guards then flag as this file issuing/emitting those ' +
|
|
545
|
+
'constructs itself -- the same self-referential false positive as dolt-literal-guard.mjs ' +
|
|
546
|
+
'and shell-command-guard.mjs above.',
|
|
547
|
+
};
|
|
548
|
+
|
|
549
|
+
/** Absolute path to a fleet-sprint module by filename. */
|
|
550
|
+
export function guardedModulePath(fileName) {
|
|
551
|
+
return path.join(__dirname, fileName);
|
|
552
|
+
}
|
|
553
|
+
|
|
554
|
+
/**
|
|
555
|
+
* Absolute paths of every registered guarded module, plus any `extraPaths`
|
|
556
|
+
* the caller appends (tests pass a throwaway fixture module this way, proving
|
|
557
|
+
* the list is what the guards actually read rather than a hard-coded name).
|
|
558
|
+
*/
|
|
559
|
+
export function guardedModulePaths(extraPaths = []) {
|
|
560
|
+
if (!Array.isArray(extraPaths)) {
|
|
561
|
+
throw new TypeError('guardedModulePaths(extraPaths): extraPaths must be an array of file paths');
|
|
562
|
+
}
|
|
563
|
+
return [...GUARDED_MODULES.map(guardedModulePath), ...extraPaths];
|
|
564
|
+
}
|
|
565
|
+
|
|
566
|
+
/**
|
|
567
|
+
* Basenames of every registered guarded module, plus any `extraPaths`'
|
|
568
|
+
* basenames appended -- same `extraPaths` contract as guardedModulePaths().
|
|
569
|
+
*
|
|
570
|
+
* apra-fleet-3swo.14: every guard's aggregate entry point (checkModules(),
|
|
571
|
+
* checkDoltLiteralModules(), checkFullDbFetchModules(), checkShellCommandPaths())
|
|
572
|
+
* labels each scanned file by `path.basename(p)`, both in its `files` return
|
|
573
|
+
* value and in every violation string it emits -- so a nested GUARDED_MODULES
|
|
574
|
+
* entry (e.g. 'phases/plan.mjs', legal per guardedModulePath()'s path.join)
|
|
575
|
+
* resolves and scans correctly but is always reported as just 'plan.mjs'.
|
|
576
|
+
* Comparing a guard's `files` output against GUARDED_MODULES verbatim only
|
|
577
|
+
* holds while every entry is a bare filename with no directory component.
|
|
578
|
+
* Baseline tests must compare against THIS function's output instead of
|
|
579
|
+
* GUARDED_MODULES directly.
|
|
580
|
+
*/
|
|
581
|
+
export function guardedModuleBasenames(extraPaths = []) {
|
|
582
|
+
return guardedModulePaths(extraPaths).map((p) => path.basename(p));
|
|
583
|
+
}
|
|
584
|
+
|
|
585
|
+
/**
|
|
586
|
+
* The guarded-module list as the dolt-literal guard must see it: the shared
|
|
587
|
+
* list with DOLT_LITERAL_EXEMPT basenames filtered out. Takes the same
|
|
588
|
+
* `extraPaths` as guardedModulePaths so the exemption applies to caller-
|
|
589
|
+
* supplied paths too -- a fixture literally named dolt-sync.mjs is exempt,
|
|
590
|
+
* while byte-identical content under any other name is not.
|
|
591
|
+
*/
|
|
592
|
+
export function doltLiteralModulePaths(extraPaths = []) {
|
|
593
|
+
return guardedModulePaths(extraPaths).filter((p) => !DOLT_LITERAL_EXEMPT.includes(path.basename(p)));
|
|
594
|
+
}
|
|
595
|
+
|
|
596
|
+
/**
|
|
597
|
+
* The guarded-module list as the unbracketed-push guard must see it: the
|
|
598
|
+
* shared list with UNBRACKETED_PUSH_EXEMPT basenames filtered out. Same
|
|
599
|
+
* `extraPaths` contract as guardedModulePaths/doltLiteralModulePaths.
|
|
600
|
+
*/
|
|
601
|
+
export function unbracketedPushModulePaths(extraPaths = []) {
|
|
602
|
+
return guardedModulePaths(extraPaths).filter((p) => !UNBRACKETED_PUSH_EXEMPT.includes(path.basename(p)));
|
|
603
|
+
}
|
|
604
|
+
|
|
605
|
+
/**
|
|
606
|
+
* The guarded-module list as the explicit-id create guard must see it: the
|
|
607
|
+
* shared list with EXPLICIT_ID_CREATE_EXEMPT basenames filtered out. Same
|
|
608
|
+
* `extraPaths` contract as guardedModulePaths/doltLiteralModulePaths/
|
|
609
|
+
* unbracketedPushModulePaths.
|
|
610
|
+
*/
|
|
611
|
+
export function explicitIdCreateModulePaths(extraPaths = []) {
|
|
612
|
+
return guardedModulePaths(extraPaths).filter((p) => !EXPLICIT_ID_CREATE_EXEMPT.includes(path.basename(p)));
|
|
613
|
+
}
|