@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,699 @@
|
|
|
1
|
+
// Member-provisioning helpers -- extracted move-only out of runner.js
|
|
2
|
+
// (apra-fleet-3swo.6.12). This module owns:
|
|
3
|
+
//
|
|
4
|
+
// 1. createMemberSessionGuard -- the pre-resume `stop_prompt` guard that
|
|
5
|
+
// kills a prior, presumed-dead-or-timed-out session on a member before a
|
|
6
|
+
// resume re-dispatch, so two live sessions never duplicate one logical
|
|
7
|
+
// dispatch's side effects.
|
|
8
|
+
// 2. createUnattendedAutoProvisioner -- best-effort sets a member's
|
|
9
|
+
// `unattended: 'auto'` registration before it is dispatched as deployer/
|
|
10
|
+
// integ-test-runner/regression-test-runner, cached per member for the
|
|
11
|
+
// lifetime of the returned function.
|
|
12
|
+
// 3. createDeployPermissionsProvisioner -- best-effort self-heal that reads
|
|
13
|
+
// deploy.md's own `## Permissions` section off the first target member
|
|
14
|
+
// it provisions and proactively grants every listed prefix via
|
|
15
|
+
// compose_permissions, so a runbook permissions change does not have to
|
|
16
|
+
// wait for a dispatch to fail before anyone notices.
|
|
17
|
+
// 4. stageCommandBodyMemberSide -- stages free-text content to a fresh,
|
|
18
|
+
// member-LOCAL temp file via a shell-agnostic `node -e` one-liner (base64
|
|
19
|
+
// argv, no `$`-expansion/backticks/template literals), so a `bd
|
|
20
|
+
// --body-file` read always finds its file on the same filesystem the
|
|
21
|
+
// subsequent `bd` command runs on.
|
|
22
|
+
//
|
|
23
|
+
// WHAT DID NOT MOVE -- resolveSettleShell. It sat in the middle of this group
|
|
24
|
+
// in runner.js and is module-private wiring: it resolves a member's settle
|
|
25
|
+
// shell from the per-sprint sprintState that sprint-state.mjs introduced,
|
|
26
|
+
// which is composition-root wiring rather than an implementation helper.
|
|
27
|
+
// test/sprint-state.test.mjs also anchors it to runner.js by symbol. It stays
|
|
28
|
+
// defined and exported from runner.js; nothing here imports it back, since
|
|
29
|
+
// none of the four moved symbols call it.
|
|
30
|
+
//
|
|
31
|
+
// runner.js re-exports every symbol it previously exported from this region,
|
|
32
|
+
// so existing importers of fleet-sprint/runner.js resolve unchanged.
|
|
33
|
+
//
|
|
34
|
+
// GUARD REGISTRATION: this module is registered in ./guarded-modules.mjs as
|
|
35
|
+
// part of this extraction (see that file's STANDING RULE). It carries the two
|
|
36
|
+
// member_name-bearing command() call sites this extraction took out of
|
|
37
|
+
// runner.js: createDeployPermissionsProvisioner's `node -e ...` read of
|
|
38
|
+
// deploy.md's Permissions section, and stageCommandBodyMemberSide's `node -e
|
|
39
|
+
// ...` member-side temp-file write. Both already avoid shell-level variable
|
|
40
|
+
// expansion (base64-encoded argv, no `$`/backtick/template-literal
|
|
41
|
+
// interpolation), which is exactly the invariant shell-command-guard.mjs
|
|
42
|
+
// enforces and reads GUARDED_MODULES to find.
|
|
43
|
+
// A third command() site was added later: createPermissionConfigPreflight's
|
|
44
|
+
// file-exists probe, built per member OS/shell by SeOsCommands.fileExistsProbe
|
|
45
|
+
// from a validated literal work-folder-relative path (no environment reads).
|
|
46
|
+
|
|
47
|
+
import os from 'node:os';
|
|
48
|
+
import { createHash } from 'node:crypto';
|
|
49
|
+
import path from 'node:path';
|
|
50
|
+
import { ApraFleet } from '@apralabs/apra-fleet-client';
|
|
51
|
+
import { resultText } from './mcp-result.mjs';
|
|
52
|
+
import { MemberPermissionConfigError } from './errors.mjs';
|
|
53
|
+
import { FILE_PROBE_PRESENT, FILE_PROBE_ABSENT } from './se-posix.mjs';
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* Guards every "resume" re-dispatch below against spawning a second
|
|
57
|
+
* concurrent session on a member whose PRIOR process for that same logical
|
|
58
|
+
* dispatch is presumed dead or timed out but may still be alive -- two live
|
|
59
|
+
* sessions for one dispatch duplicate whatever side effects the orphaned one
|
|
60
|
+
* performs.
|
|
61
|
+
*
|
|
62
|
+
* Before firing a resume, call the fleet's own `stop_prompt` tool
|
|
63
|
+
* (src/tools/stop-prompt.ts) for that member: it kills whatever process is
|
|
64
|
+
* still on record and is a no-op when nothing is running, so pid liveness is
|
|
65
|
+
* never reimplemented here.
|
|
66
|
+
*
|
|
67
|
+
* `callTool` is injected (the caller's MCP client), so this stays
|
|
68
|
+
* transport-agnostic and unit-testable without a live fleet server. When it
|
|
69
|
+
* is omitted, `killIfAlive()` is a no-op -- there is no live fleet connection
|
|
70
|
+
* to guard against, matching every other best-effort client in this file when
|
|
71
|
+
* its transport is absent.
|
|
72
|
+
*
|
|
73
|
+
* Best-effort by design: a `stop_prompt` failure is logged and swallowed
|
|
74
|
+
* rather than blocking the resume -- the resume is what the sprint needs to
|
|
75
|
+
* make progress, and this guard REDUCES rather than gates the chance of a
|
|
76
|
+
* duplicate concurrent session.
|
|
77
|
+
*
|
|
78
|
+
* @param {{ callTool?: (name: string, args: object) => Promise<any>, log?: Function }} opts
|
|
79
|
+
* @returns {{ killIfAlive: (member: string) => Promise<void> }}
|
|
80
|
+
*/
|
|
81
|
+
export function createMemberSessionGuard(opts = {}) {
|
|
82
|
+
const { callTool, log = () => {} } = opts;
|
|
83
|
+
const active = typeof callTool === 'function';
|
|
84
|
+
|
|
85
|
+
return {
|
|
86
|
+
async killIfAlive(member) {
|
|
87
|
+
if (!active || !member) return;
|
|
88
|
+
try {
|
|
89
|
+
const result = await callTool('stop_prompt', { member_name: member });
|
|
90
|
+
log(`[member-session-guard] pre-resume stop_prompt for '${member}': ${resultText(result) || '(no detail)'}`);
|
|
91
|
+
} catch (err) {
|
|
92
|
+
log(`[member-session-guard] pre-resume stop_prompt for '${member}' failed (non-fatal; resume proceeds): ${err.message}`);
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Best-effort provisions a member for unattended execution (`unattended:
|
|
100
|
+
* 'auto'`) before dispatching it as deployer, integ-test-runner, or
|
|
101
|
+
* regression-test-runner -- roles that run real deploy commands and test
|
|
102
|
+
* suites via a runbook and must never stall on an interactive permission
|
|
103
|
+
* prompt. Provisioning is a one-way member-registration change and is
|
|
104
|
+
* deliberately NOT reverted after the dispatch: `unattended` lives on the
|
|
105
|
+
* member (update_member), not on the dispatch, so there is nothing to revert
|
|
106
|
+
* to without also clobbering whatever the user set intentionally. In a
|
|
107
|
+
* single-member sprint the same member also plays doer/reviewer/etc, so it
|
|
108
|
+
* ends up unattended='auto' too -- accepted, not a bug.
|
|
109
|
+
*
|
|
110
|
+
* Cached per member for the lifetime of the returned function, so a sprint
|
|
111
|
+
* with many deploy/integ/regression dispatches across cycles calls
|
|
112
|
+
* update_member at most once per member. A failure (fleet unreachable,
|
|
113
|
+
* member not found) is logged and swallowed -- exactly like
|
|
114
|
+
* createMemberVcsProviderResolver above -- so a provisioning hiccup degrades
|
|
115
|
+
* to whatever permission mode the member already had, rather than aborting
|
|
116
|
+
* the phase.
|
|
117
|
+
*
|
|
118
|
+
* `callTool` is injected (the caller's MCP client), so this stays
|
|
119
|
+
* transport-agnostic and unit-testable without a live fleet server.
|
|
120
|
+
*
|
|
121
|
+
* @param {{ callTool: (name: string, args: object) => Promise<any>, log?: Function }} opts
|
|
122
|
+
* @returns {(member: string) => Promise<void>}
|
|
123
|
+
*/
|
|
124
|
+
export function createUnattendedAutoProvisioner(opts = {}) {
|
|
125
|
+
const { callTool, log = () => {} } = opts;
|
|
126
|
+
const fleetApi = new ApraFleet({ callTool });
|
|
127
|
+
/** @type {Set<string>} members already confirmed unattended='auto' this run. */
|
|
128
|
+
const provisioned = new Set();
|
|
129
|
+
|
|
130
|
+
return async function ensureUnattendedAuto(member) {
|
|
131
|
+
if (provisioned.has(member)) return;
|
|
132
|
+
try {
|
|
133
|
+
await fleetApi.updateMember({ member_name: member, unattended: 'auto' });
|
|
134
|
+
provisioned.add(member);
|
|
135
|
+
log(`[unattended] member '${member}' set to unattended='auto' for this dispatch.`);
|
|
136
|
+
} catch (err) {
|
|
137
|
+
log(`[unattended] could not set unattended='auto' on member '${member}' (continuing with its existing permission mode): ${err.message}`);
|
|
138
|
+
}
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/**
|
|
143
|
+
* Best-effort, self-heals the "Missing permission" class of deploy/integ/
|
|
144
|
+
* regression-test failure BEFORE it happens: reads deploy.md's own
|
|
145
|
+
* `## Permissions` section -- the exact list the deployer/integ-test-runner/
|
|
146
|
+
* regression-test-runner agent prompts already cross-check at their own
|
|
147
|
+
* Step 0a/0 -- and proactively grants every listed prefix to the target
|
|
148
|
+
* member via compose_permissions. Without this, a runbook permissions
|
|
149
|
+
* change (e.g. the `apra-fleet start` -> `apra-fleet run` swap, #395) only
|
|
150
|
+
* gets noticed when a dispatch fails, and only gets fixed once an operator
|
|
151
|
+
* greps deploy.md by hand and runs compose_permissions manually -- exactly
|
|
152
|
+
* the failure mode this closes the loop on.
|
|
153
|
+
*
|
|
154
|
+
* Reads deploy.md via `command()` against the FIRST target member it is asked
|
|
155
|
+
* to provision (that member is about to be dispatched as deployer/
|
|
156
|
+
* integ-test-runner/regression-test-runner, so its own checkout is the source
|
|
157
|
+
* of truth for what it is about to run) and caches the parsed prefix list for
|
|
158
|
+
* the lifetime of the returned function -- one read per sprint run, since
|
|
159
|
+
* deploy.md does not change mid-run on a healthy pipeline. Also caches per
|
|
160
|
+
* TARGET member, like createUnattendedAutoProvisioner above, so repeat cycles
|
|
161
|
+
* don't re-grant. Deliberately does NOT read via a separate orchestrator
|
|
162
|
+
* member: the orchestrator role may be shared/unreservable across concurrent
|
|
163
|
+
* sprints and carries no git checkout of its own to read from.
|
|
164
|
+
*
|
|
165
|
+
* Failure at any step (probe fails, deploy.md missing/unparseable,
|
|
166
|
+
* compose_permissions unreachable, a listed prefix hitting the
|
|
167
|
+
* NEVER_AUTO_GRANT denylist) is logged and swallowed. This is pure
|
|
168
|
+
* best-effort acceleration -- the deployer's own Step 0a check remains the
|
|
169
|
+
* authoritative, fail-closed backstop regardless of whether this succeeds.
|
|
170
|
+
*
|
|
171
|
+
* @param {{ callTool: (name: string, args: object) => Promise<any>, command: Function, log?: Function }} opts
|
|
172
|
+
* @returns {(member: string) => Promise<void>}
|
|
173
|
+
*/
|
|
174
|
+
export function createDeployPermissionsProvisioner(opts = {}) {
|
|
175
|
+
const { callTool, command, log = () => {} } = opts;
|
|
176
|
+
const fleetApi = new ApraFleet({ callTool });
|
|
177
|
+
/** @type {Set<string>} members already granted deploy.md's permissions this run. */
|
|
178
|
+
const provisioned = new Set();
|
|
179
|
+
/** @type {string[] | null | undefined} undefined = not yet attempted. */
|
|
180
|
+
let cachedPrefixes;
|
|
181
|
+
|
|
182
|
+
async function loadRequiredPrefixes(targetMember) {
|
|
183
|
+
if (cachedPrefixes !== undefined) return cachedPrefixes;
|
|
184
|
+
try {
|
|
185
|
+
const res = await command(
|
|
186
|
+
`node -e "const fs=require('fs'); if(fs.existsSync('deploy.md')) process.stdout.write(fs.readFileSync('deploy.md','utf8'))"`,
|
|
187
|
+
{ member_name: targetMember, silent: true, label: `Read deploy.md permissions`, failSoft: true },
|
|
188
|
+
);
|
|
189
|
+
if (!res.ok || !res.output) {
|
|
190
|
+
cachedPrefixes = null;
|
|
191
|
+
} else {
|
|
192
|
+
const section = res.output.split(/^## Permissions/m)[1]?.split(/^## /m)[0] ?? '';
|
|
193
|
+
const prefixes = [...section.matchAll(/^-\s*`([^`]+)`/gm)].map(m => m[1]);
|
|
194
|
+
cachedPrefixes = prefixes.length ? prefixes : null;
|
|
195
|
+
}
|
|
196
|
+
} catch (err) {
|
|
197
|
+
log(`[deploy-permissions] could not read deploy.md's Permissions section (continuing without auto-provisioning): ${err.message}`);
|
|
198
|
+
cachedPrefixes = null;
|
|
199
|
+
}
|
|
200
|
+
return cachedPrefixes;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
return async function ensureDeployPermissions(member) {
|
|
204
|
+
if (!member || provisioned.has(member)) return;
|
|
205
|
+
const prefixes = await loadRequiredPrefixes(member);
|
|
206
|
+
if (!prefixes) return;
|
|
207
|
+
try {
|
|
208
|
+
const result = await fleetApi.composePermissions({
|
|
209
|
+
member_name: member,
|
|
210
|
+
role: 'doer',
|
|
211
|
+
grant: prefixes,
|
|
212
|
+
grant_reason: "deploy.md's declared Permissions section, auto-provisioned before dispatch",
|
|
213
|
+
});
|
|
214
|
+
provisioned.add(member);
|
|
215
|
+
log(`[deploy-permissions] ensured deploy.md's required permissions on '${member}': ${result}`);
|
|
216
|
+
} catch (err) {
|
|
217
|
+
log(`[deploy-permissions] could not auto-provision deploy.md permissions on '${member}' (continuing -- the deployer's own Step 0a check remains the backstop): ${err.message}`);
|
|
218
|
+
}
|
|
219
|
+
};
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* Sprint roles whose members get compose_permissions' read-mostly 'reviewer'
|
|
224
|
+
* profile. A member serving ANY other role (or a mix) gets 'doer', the
|
|
225
|
+
* superset, so re-composing never narrows what one of its roles needs.
|
|
226
|
+
*/
|
|
227
|
+
export const PERMISSION_CONFIG_REVIEWER_ROLES = Object.freeze(['reviewer', 'plan-reviewer', 'ci-watcher']);
|
|
228
|
+
const REVIEWER_ROLE_SET = new Set(PERMISSION_CONFIG_REVIEWER_ROLES);
|
|
229
|
+
|
|
230
|
+
/**
|
|
231
|
+
* compose_permissions role for a member serving `roles`.
|
|
232
|
+
* @param {string[]} roles
|
|
233
|
+
* @returns {'doer'|'reviewer'}
|
|
234
|
+
*/
|
|
235
|
+
export function composeRoleForRoles(roles) {
|
|
236
|
+
const list = (roles || []).filter(Boolean);
|
|
237
|
+
return list.length > 0 && list.every((r) => REVIEWER_ROLE_SET.has(r)) ? 'reviewer' : 'doer';
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
const PERMISSION_PROBE_TIMEOUT_S = 60;
|
|
241
|
+
|
|
242
|
+
function memberDetailJson(res) {
|
|
243
|
+
const text = resultText(res);
|
|
244
|
+
return JSON.parse(text);
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
// A compose_permissions result that reports failure in its text (the tool
|
|
248
|
+
// returns its refusals/delivery failures as a text result, not a throw).
|
|
249
|
+
function composeFailureText(res) {
|
|
250
|
+
if (res && typeof res === 'object' && res.isError) return resultText(res) || 'compose_permissions reported an error';
|
|
251
|
+
const text = resultText(res).trim();
|
|
252
|
+
if (/^(\u274c|\[FAIL\])/.test(text)) return text;
|
|
253
|
+
return null;
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
/**
|
|
257
|
+
* Member-init check for every dispatch member's composed per-folder
|
|
258
|
+
* permission config (a re-cloned work folder, `git clean -xdf` or a fresh
|
|
259
|
+
* worktree loses it, and the member's role then has its tool calls -- bd
|
|
260
|
+
* included -- refused as "requires approval" while member init still reports
|
|
261
|
+
* OK). For each member, BEFORE any dispatch:
|
|
262
|
+
*
|
|
263
|
+
* 1. read the provider's permission config file(s) from member_detail
|
|
264
|
+
* (`permissionConfigPaths`, straight from the member's ProviderAdapter --
|
|
265
|
+
* never assumed to be Claude's);
|
|
266
|
+
* 2. probe each work-folder-relative one with a per-OS/shell command
|
|
267
|
+
* (memberShell(member).fileExistsProbe -- never shell-level expansion);
|
|
268
|
+
* 3. if any is missing, call compose_permissions ONCE for the member's
|
|
269
|
+
* role (composeRoleForRoles) and re-probe;
|
|
270
|
+
* 4. still missing, compose failing, or a probe that cannot answer ->
|
|
271
|
+
* MemberPermissionConfigError naming member, file(s) and the fix.
|
|
272
|
+
*
|
|
273
|
+
* Present configs are left untouched (no compose call). Home-anchored paths
|
|
274
|
+
* ("~/...", agy) are not work-folder files: they are logged and left to
|
|
275
|
+
* compose_permissions/execute_prompt, which provision them. A server too old
|
|
276
|
+
* to report permissionConfigPaths is logged and that member is not checked.
|
|
277
|
+
*
|
|
278
|
+
* `ledgerFolderFor(member)` (optional) names the member's compose_permissions
|
|
279
|
+
* ledger folder; a re-compose passes it as project_folder so grants an
|
|
280
|
+
* earlier sprint's permission heal recorded there are restored too.
|
|
281
|
+
*
|
|
282
|
+
* @param {{ callTool: Function, command: Function, memberShell: (member: string) => Promise<{ fileExistsProbe: (relPath: string) => string }>, ledgerFolderFor?: (member: string) => string|undefined, log?: Function }} opts
|
|
283
|
+
* @returns {(memberRoles: Map<string, string[]>) => Promise<{ composed: string[] }>}
|
|
284
|
+
*/
|
|
285
|
+
export function createPermissionConfigPreflight(opts = {}) {
|
|
286
|
+
const { callTool, command, memberShell, ledgerFolderFor = () => undefined, log = () => {} } = opts;
|
|
287
|
+
if (typeof callTool !== 'function') throw new TypeError('createPermissionConfigPreflight: callTool is required');
|
|
288
|
+
if (typeof command !== 'function') throw new TypeError('createPermissionConfigPreflight: command is required');
|
|
289
|
+
if (typeof memberShell !== 'function') throw new TypeError('createPermissionConfigPreflight: memberShell is required');
|
|
290
|
+
const fleetApi = new ApraFleet({ callTool });
|
|
291
|
+
|
|
292
|
+
const quoted = (files) => files.map((f) => "'" + f + "'").join(', ');
|
|
293
|
+
const fixFor = (member, role, files) =>
|
|
294
|
+
'run compose_permissions for ' + member + ' with role ' + role + ', check ' + quoted(files) +
|
|
295
|
+
" exists in that member's workFolder, then rerun the sprint";
|
|
296
|
+
|
|
297
|
+
const fail = (member, role, files, cause, details) => new MemberPermissionConfigError(
|
|
298
|
+
"Member preflight failed: member '" + member + "' is missing its composed permission config " + quoted(files) + ' (' + cause + '). ' +
|
|
299
|
+
'A role dispatched there would have its tool calls refused as requiring approval, so the sprint stops before any dispatch. ' +
|
|
300
|
+
`To fix: ${fixFor(member, role, files)}.`,
|
|
301
|
+
{ member, files, role, details }
|
|
302
|
+
);
|
|
303
|
+
|
|
304
|
+
async function probe(member, role, shell, file) {
|
|
305
|
+
let cmd;
|
|
306
|
+
try {
|
|
307
|
+
cmd = shell.fileExistsProbe(file);
|
|
308
|
+
} catch (err) {
|
|
309
|
+
throw fail(member, role, [file], `no probe could be built for it: ${err.message}`, { step: 'probe' });
|
|
310
|
+
}
|
|
311
|
+
let res;
|
|
312
|
+
try {
|
|
313
|
+
res = await command(cmd, { member_name: member, silent: true, failSoft: true, timeout_s: PERMISSION_PROBE_TIMEOUT_S, label: `Probe permission config ${file}` });
|
|
314
|
+
} catch (err) {
|
|
315
|
+
res = { ok: false, error: err && err.message ? err.message : String(err) };
|
|
316
|
+
}
|
|
317
|
+
if (res && typeof res === 'object' && res.ok === false) {
|
|
318
|
+
throw fail(member, role, [file], `its probe failed: ${String(res.error || 'command failed').replace(/\s+/g, ' ').slice(0, 300)}`, { step: 'probe' });
|
|
319
|
+
}
|
|
320
|
+
const out = (res && typeof res === 'object') ? String(res.output ?? '') : String(res ?? '');
|
|
321
|
+
const last = out.replace(/\r\n/g, '\n').split('\n').map((l) => l.trim()).filter(Boolean).pop() || '';
|
|
322
|
+
if (last === FILE_PROBE_PRESENT) return true;
|
|
323
|
+
if (last === FILE_PROBE_ABSENT) return false;
|
|
324
|
+
throw fail(member, role, [file], `its probe answered '${last.slice(0, 120)}', not '${FILE_PROBE_PRESENT}'/'${FILE_PROBE_ABSENT}'`, { step: 'probe' });
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
return async function verifyPermissionConfigs(memberRoles) {
|
|
328
|
+
const composed = [];
|
|
329
|
+
for (const [member, roles] of memberRoles) {
|
|
330
|
+
const role = composeRoleForRoles(roles);
|
|
331
|
+
// Which files to check comes only from member_detail. When it
|
|
332
|
+
// cannot say (unreachable, unparseable, or an older server without
|
|
333
|
+
// the field) there is nothing to probe: that is a loud WARNING, and
|
|
334
|
+
// an unreachable member then fails at its own first dispatch.
|
|
335
|
+
let detail = null;
|
|
336
|
+
let detailError = null;
|
|
337
|
+
try {
|
|
338
|
+
detail = memberDetailJson(await fleetApi.memberDetail({ member_name: member, format: 'json' }));
|
|
339
|
+
} catch (err) {
|
|
340
|
+
detailError = err && err.message ? err.message : String(err);
|
|
341
|
+
}
|
|
342
|
+
const reported = detail && typeof detail === 'object' ? detail.permissionConfigPaths : undefined;
|
|
343
|
+
if (!Array.isArray(reported)) {
|
|
344
|
+
const why = detailError
|
|
345
|
+
? 'member_detail could not be read (' + detailError.replace(/\s+/g, ' ').slice(0, 200) + ')'
|
|
346
|
+
: 'member_detail does not report permissionConfigPaths (older fleet server)';
|
|
347
|
+
log('[permission-config] WARNING: ' + why + " for member '" + member + "'; its composed permission config is not verified this sprint.");
|
|
348
|
+
continue;
|
|
349
|
+
}
|
|
350
|
+
const files = [];
|
|
351
|
+
for (const p of reported) {
|
|
352
|
+
const f = String(p || '');
|
|
353
|
+
if (!f) continue;
|
|
354
|
+
if (f.startsWith('~')) {
|
|
355
|
+
log(`[permission-config] member '${member}': '${f}' is home-anchored, not a workFolder file; left to compose_permissions/execute_prompt to provision.`);
|
|
356
|
+
continue;
|
|
357
|
+
}
|
|
358
|
+
files.push(f);
|
|
359
|
+
}
|
|
360
|
+
if (files.length === 0) continue;
|
|
361
|
+
const shell = await memberShell(member);
|
|
362
|
+
const missing = [];
|
|
363
|
+
for (const f of files) if (!(await probe(member, role, shell, f))) missing.push(f);
|
|
364
|
+
if (missing.length === 0) {
|
|
365
|
+
log(`[permission-config] member '${member}': composed permission config present (${files.join(', ')}).`);
|
|
366
|
+
continue;
|
|
367
|
+
}
|
|
368
|
+
log(`[permission-config] member '${member}' is missing its composed permission config (${missing.join(', ')}); re-composing it with compose_permissions role '${role}'.`);
|
|
369
|
+
let res;
|
|
370
|
+
try {
|
|
371
|
+
const ledger = ledgerFolderFor(member);
|
|
372
|
+
res = await fleetApi.composePermissions({ member_name: member, role, ...(ledger ? { project_folder: ledger } : {}) });
|
|
373
|
+
} catch (err) {
|
|
374
|
+
throw fail(member, role, missing, `compose_permissions failed: ${err && err.message ? err.message : err}`, { step: 'compose' });
|
|
375
|
+
}
|
|
376
|
+
const composeErr = composeFailureText(res);
|
|
377
|
+
if (composeErr) throw fail(member, role, missing, `compose_permissions failed: ${composeErr.replace(/\s+/g, ' ').slice(0, 300)}`, { step: 'compose' });
|
|
378
|
+
const still = [];
|
|
379
|
+
for (const f of missing) if (!(await probe(member, role, shell, f))) still.push(f);
|
|
380
|
+
if (still.length > 0) throw fail(member, role, still, 'it is still missing after compose_permissions', { step: 'verify' });
|
|
381
|
+
composed.push(member);
|
|
382
|
+
log(`[permission-config] member '${member}': permission config re-composed (${missing.join(', ')}).`);
|
|
383
|
+
}
|
|
384
|
+
return { composed };
|
|
385
|
+
};
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
// ---------------------------------------------------------------------------
|
|
389
|
+
// Mid-sprint permission-refusal heal (dispatch reason 'permission_denied')
|
|
390
|
+
// ---------------------------------------------------------------------------
|
|
391
|
+
|
|
392
|
+
/**
|
|
393
|
+
* The compose_permissions ledger folder (project_folder) for one member: a
|
|
394
|
+
* per-member folder under `baseDir` when given, else under the fleet server's
|
|
395
|
+
* data directory (APRA_FLEET_DATA_DIR, default ~/.apra-fleet/data) -- the
|
|
396
|
+
* same machine, since the server resolves project_folder on its own
|
|
397
|
+
* filesystem and the sprint engine runs beside it. compose_permissions
|
|
398
|
+
* creates the folder on its first grant. One folder per member keeps grants
|
|
399
|
+
* scoped to that member.
|
|
400
|
+
* @param {string} member
|
|
401
|
+
* @param {string} [baseDir]
|
|
402
|
+
* @returns {string|undefined}
|
|
403
|
+
*/
|
|
404
|
+
export function permissionLedgerFolder(member, baseDir) {
|
|
405
|
+
if (!member) return undefined;
|
|
406
|
+
const root = baseDir || path.join(process.env.APRA_FLEET_DATA_DIR || path.join(os.homedir(), '.apra-fleet', 'data'), 'permission-ledgers');
|
|
407
|
+
// Member names may contain dots, even be all dots ('..'). The folder name
|
|
408
|
+
// therefore keeps only [A-Za-z0-9_-] -- no dot, no separator, so it can
|
|
409
|
+
// never traverse out of `root` -- plus a hash of the raw name, so two
|
|
410
|
+
// names that sanitize alike still get distinct folders.
|
|
411
|
+
const raw = String(member);
|
|
412
|
+
const safe = raw.replace(/[^A-Za-z0-9_-]/g, '_').slice(0, 64);
|
|
413
|
+
const hash = createHash('sha256').update(raw).digest('hex').slice(0, 12);
|
|
414
|
+
return path.join(root, `${safe}-${hash}`);
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
/** Heals per member per sprint. Each heal re-runs a whole role dispatch, and
|
|
418
|
+
* real denial sets name one or two distinct tools, so three progressive
|
|
419
|
+
* grants (A, then B, then C) cover the observed cases while bounding the
|
|
420
|
+
* re-dispatch cost of a member that keeps reaching for new tools. */
|
|
421
|
+
export const PERMISSION_HEAL_MEMBER_CAP = 3;
|
|
422
|
+
/** Heals within one dispatch ladder (one role dispatch and its retries): a
|
|
423
|
+
* single dispatch that needs a third new tool after two grants is more likely
|
|
424
|
+
* wandering than blocked, and the member cap still allows a later dispatch
|
|
425
|
+
* to heal. */
|
|
426
|
+
export const PERMISSION_HEAL_LADDER_CAP = 2;
|
|
427
|
+
|
|
428
|
+
// A grant payload with any of these can chain or substitute another command,
|
|
429
|
+
// so it is never in policy whatever the composed list says (compose_permissions
|
|
430
|
+
// refuses the same set as NEVER_AUTO_GRANT).
|
|
431
|
+
const GRANT_CHAIN_RE = /[|;&`<>]|\$\(/;
|
|
432
|
+
|
|
433
|
+
/** Splits `Tool(payload)`; a bare tool name has payload null. */
|
|
434
|
+
function splitRule(rule) {
|
|
435
|
+
const s = String(rule || '').trim();
|
|
436
|
+
const m = /^([A-Za-z_][\w.-]*)\((.*)\)$/s.exec(s);
|
|
437
|
+
return m ? { tool: m[1], payload: m[2].trim().replace(/\s+/g, ' ') } : { tool: s, payload: null };
|
|
438
|
+
}
|
|
439
|
+
|
|
440
|
+
/** The literal prefix a wildcard payload matches (`x:*` and `x *` both mean
|
|
441
|
+
* "x, then anything"; `x*` is a raw prefix), or null for an exact payload. */
|
|
442
|
+
function wildcardBase(payload) {
|
|
443
|
+
if (payload.endsWith(':*')) return { base: payload.slice(0, -2), word: true };
|
|
444
|
+
if (payload.endsWith(' *')) return { base: payload.slice(0, -2), word: true };
|
|
445
|
+
if (payload.endsWith('*')) return { base: payload.slice(0, -1), word: false };
|
|
446
|
+
return null;
|
|
447
|
+
}
|
|
448
|
+
|
|
449
|
+
/** True when payload rule `rule` allows the literal command line `cmd`. */
|
|
450
|
+
function bashRuleAllows(rule, cmd) {
|
|
451
|
+
const w = wildcardBase(rule);
|
|
452
|
+
if (!w) return rule === cmd;
|
|
453
|
+
return w.word ? (cmd === w.base || cmd.startsWith(w.base + ' ')) : cmd.startsWith(w.base);
|
|
454
|
+
}
|
|
455
|
+
|
|
456
|
+
/** True when payload rule `rule` allows everything payload `wanted` allows. */
|
|
457
|
+
function bashRuleCovers(rule, wanted) {
|
|
458
|
+
if (rule === wanted) return true;
|
|
459
|
+
const ww = wildcardBase(wanted);
|
|
460
|
+
if (!ww) return bashRuleAllows(rule, wanted);
|
|
461
|
+
const rw = wildcardBase(rule);
|
|
462
|
+
if (!rw) return false;
|
|
463
|
+
return rw.word ? (ww.base === rw.base || ww.base.startsWith(rw.base + ' ')) : ww.base.startsWith(rw.base);
|
|
464
|
+
}
|
|
465
|
+
|
|
466
|
+
/**
|
|
467
|
+
* True when the composed allow list `policy` already covers `grant` -- the
|
|
468
|
+
* code-level guard that keeps a heal inside what the user's role profile
|
|
469
|
+
* (plus detected stacks) grants. A bare tool name in the policy covers any
|
|
470
|
+
* scoped form of that tool; a Bash rule covers a grant only if it allows
|
|
471
|
+
* everything the grant would.
|
|
472
|
+
* @param {string} grant
|
|
473
|
+
* @param {string[]} policy
|
|
474
|
+
*/
|
|
475
|
+
export function grantWithinPolicy(grant, policy) {
|
|
476
|
+
const g = splitRule(grant);
|
|
477
|
+
if (g.payload !== null && GRANT_CHAIN_RE.test(g.payload)) return false;
|
|
478
|
+
for (const raw of policy || []) {
|
|
479
|
+
const r = splitRule(raw);
|
|
480
|
+
if (r.tool !== g.tool) continue;
|
|
481
|
+
if (r.payload === null) return true;
|
|
482
|
+
if (g.payload === null) continue;
|
|
483
|
+
if (r.tool === 'Bash' ? bashRuleCovers(r.payload, g.payload) : r.payload === g.payload) return true;
|
|
484
|
+
}
|
|
485
|
+
return false;
|
|
486
|
+
}
|
|
487
|
+
|
|
488
|
+
/** True when an already-landed grant should have allowed this refused call. */
|
|
489
|
+
function grantAllowsCall(grant, item) {
|
|
490
|
+
const g = splitRule(grant);
|
|
491
|
+
// agy names a refused shell command 'command' or 'unsandboxed'; its
|
|
492
|
+
// grant is a Bash rule like Claude's.
|
|
493
|
+
const action = item.action === 'command' || item.action === 'unsandboxed' ? 'Bash' : item.action;
|
|
494
|
+
if (g.tool !== action) return false;
|
|
495
|
+
if (g.payload === null) return true;
|
|
496
|
+
if (typeof item.target !== 'string') return false;
|
|
497
|
+
const call = item.target.trim().replace(/\s+/g, ' ');
|
|
498
|
+
return g.tool === 'Bash' ? bashRuleAllows(g.payload, call) : g.payload === call;
|
|
499
|
+
}
|
|
500
|
+
|
|
501
|
+
const describeCall = (d) => (d.target ? `${d.action} "${d.target}"` : d.action);
|
|
502
|
+
|
|
503
|
+
/**
|
|
504
|
+
* Builds the dispatch engine's `onPermissionDenied` hook: a PROGRESSIVE heal
|
|
505
|
+
* of a member whose dispatch was refused tool calls for lack of a grant.
|
|
506
|
+
* Denied tool A -> grant A, retry; tool B denied next -> grant B, retry; it
|
|
507
|
+
* keeps going while each heal adds a grant that was not there before, and
|
|
508
|
+
* stops (healed: false, with a `step`) only when no progress is possible:
|
|
509
|
+
*
|
|
510
|
+
* not_healable the session ran in an auto/bypass permission mode: the
|
|
511
|
+
* refusal is the safety classifier or a deny rule, which no
|
|
512
|
+
* grant may override (only acceptEdits-mode sessions -- e.g.
|
|
513
|
+
* a model without auto support -- are healed), or the
|
|
514
|
+
* provider marked the denial cause 'policy_deny' (a tool the
|
|
515
|
+
* member's own config denies on purpose), in any mode;
|
|
516
|
+
* no_progress a call was refused again although a landed grant covers
|
|
517
|
+
* it (the grant did not take: something overrides it), a
|
|
518
|
+
* call maps to no grant, or a needed grant is outside the
|
|
519
|
+
* member's composed policy;
|
|
520
|
+
* cap PERMISSION_HEAL_MEMBER_CAP heals for this member this
|
|
521
|
+
* sprint, or PERMISSION_HEAL_LADDER_CAP in this ladder;
|
|
522
|
+
* heal compose_permissions failed or refused the grant (its
|
|
523
|
+
* NEVER_AUTO_GRANT floor); the grants are named.
|
|
524
|
+
*
|
|
525
|
+
* Security model: the member never grants itself anything -- the
|
|
526
|
+
* orchestrator grants on need, only grants the member's own composed policy
|
|
527
|
+
* already contains (compose_permissions dry_run for its role + stacks, not a
|
|
528
|
+
* hand-kept copy), and compose_permissions' NEVER_AUTO_GRANT floor still
|
|
529
|
+
* applies on the server.
|
|
530
|
+
*
|
|
531
|
+
* State is per sprint (this hook's lifetime) and per member: the grants that
|
|
532
|
+
* landed and the heal count. Only the member's FIRST heal re-composes its
|
|
533
|
+
* config from the role profile (restoring a config a re-clone dropped); later
|
|
534
|
+
* heals only ADD grants, because a proactive compose rewrites the allow list
|
|
535
|
+
* and would wipe the grants of earlier heals. Every grant is recorded in the
|
|
536
|
+
* member's ledger folder (`ledgerFolderFor`, passed as project_folder), so a
|
|
537
|
+
* later sprint's compose of that member keeps it.
|
|
538
|
+
*
|
|
539
|
+
* Resolves `{ healed, step?, composeRole, grants, rejectedGrants, reason }`;
|
|
540
|
+
* never throws. healed is true only when at least one new grant landed.
|
|
541
|
+
*
|
|
542
|
+
* @param {{ callTool: Function, memberRoles?: (member: string) => string[], ledgerFolderFor?: (member: string) => string|undefined, log?: Function }} opts
|
|
543
|
+
*/
|
|
544
|
+
export function createPermissionDenialHeal(opts = {}) {
|
|
545
|
+
const { callTool, memberRoles = () => [], ledgerFolderFor = () => undefined, log = () => {} } = opts;
|
|
546
|
+
if (typeof callTool !== 'function') throw new TypeError('createPermissionDenialHeal: callTool is required');
|
|
547
|
+
const fleetApi = new ApraFleet({ callTool });
|
|
548
|
+
|
|
549
|
+
/** @type {Map<string, { granted: string[], healCount: number, recomposed: boolean, policy: Map<string, string[]> }>} */
|
|
550
|
+
const state = new Map();
|
|
551
|
+
const stateFor = (member) => {
|
|
552
|
+
if (!state.has(member)) state.set(member, { granted: [], healCount: 0, recomposed: false, policy: new Map() });
|
|
553
|
+
return state.get(member);
|
|
554
|
+
};
|
|
555
|
+
|
|
556
|
+
const compose = async (args) => {
|
|
557
|
+
let res;
|
|
558
|
+
try {
|
|
559
|
+
res = await fleetApi.composePermissions(args);
|
|
560
|
+
} catch (err) {
|
|
561
|
+
return { error: `compose_permissions failed: ${err && err.message ? err.message : err}`, res: null };
|
|
562
|
+
}
|
|
563
|
+
const failure = composeFailureText(res);
|
|
564
|
+
return failure
|
|
565
|
+
? { error: `compose_permissions failed: ${failure.replace(/\s+/g, ' ').slice(0, 300)}`, res }
|
|
566
|
+
: { error: null, res };
|
|
567
|
+
};
|
|
568
|
+
|
|
569
|
+
const policyFor = async (member, st, composeRole) => {
|
|
570
|
+
if (st.policy.has(composeRole)) return { allow: st.policy.get(composeRole) };
|
|
571
|
+
const { error, res } = await compose({ member_name: member, role: composeRole, dry_run: true });
|
|
572
|
+
if (error) return { error };
|
|
573
|
+
let parsed = null;
|
|
574
|
+
try { parsed = JSON.parse(resultText(res)); } catch { /* checked below */ }
|
|
575
|
+
if (!parsed || parsed.dry_run !== true || !Array.isArray(parsed.allow)) {
|
|
576
|
+
return { error: 'compose_permissions dry_run did not return the composed allow list (fleet server too old?)' };
|
|
577
|
+
}
|
|
578
|
+
const allow = parsed.allow.filter((p) => typeof p === 'string');
|
|
579
|
+
st.policy.set(composeRole, allow);
|
|
580
|
+
return { allow };
|
|
581
|
+
};
|
|
582
|
+
|
|
583
|
+
return async function onPermissionDenied({ member, role, denial, ladderHeals = 0 }) {
|
|
584
|
+
const roles = [...new Set([...(memberRoles(member) || []), role].filter(Boolean))];
|
|
585
|
+
const composeRole = composeRoleForRoles(roles);
|
|
586
|
+
const st = stateFor(member);
|
|
587
|
+
const stop = (step, reason, rejectedGrants = []) => {
|
|
588
|
+
log(`[permission-heal] member '${member}' (${role}): not healed (${step}) -- ${reason}`);
|
|
589
|
+
return { healed: false, step, composeRole, grants: [], rejectedGrants, reason };
|
|
590
|
+
};
|
|
591
|
+
|
|
592
|
+
const items = denial && Array.isArray(denial.denials) ? denial.denials : [];
|
|
593
|
+
const what = items.length ? items.map(describeCall).join(', ') : ((denial && denial.actions.join(', ')) || 'unknown actions');
|
|
594
|
+
|
|
595
|
+
if (denial && denial.cause === 'policy_deny') {
|
|
596
|
+
return stop('not_healable', `${what} was refused by a deny rule the member's own permission config carries on purpose (a tool outside the member's allowlist); no grant is ever added for that.`);
|
|
597
|
+
}
|
|
598
|
+
if (denial && (denial.healable === false || denial.permissionMode === 'auto' || denial.permissionMode === 'bypassPermissions')) {
|
|
599
|
+
return stop('not_healable', `the session ran in ${denial.permissionMode || 'a non-healable'} permission mode, where ${what} was refused by the safety classifier or a deny rule; no grant is ever added for that.`);
|
|
600
|
+
}
|
|
601
|
+
if (st.healCount >= PERMISSION_HEAL_MEMBER_CAP) {
|
|
602
|
+
return stop('cap', `${st.healCount} permission heals already ran for this member this sprint (limit ${PERMISSION_HEAL_MEMBER_CAP}).`);
|
|
603
|
+
}
|
|
604
|
+
if (ladderHeals >= PERMISSION_HEAL_LADDER_CAP) {
|
|
605
|
+
return stop('cap', `${ladderHeals} permission heals already ran for this dispatch (limit ${PERMISSION_HEAL_LADDER_CAP}).`);
|
|
606
|
+
}
|
|
607
|
+
if (items.length === 0) return stop('no_progress', 'the refusal named no tool call to grant.');
|
|
608
|
+
|
|
609
|
+
// Refused again although a landed grant covers the call: the grant
|
|
610
|
+
// did not take (a deny rule or managed setting overrides it).
|
|
611
|
+
for (const item of items) {
|
|
612
|
+
const landed = st.granted.find((g) => grantAllowsCall(g, item));
|
|
613
|
+
if (landed) return stop('no_progress', `${describeCall(item)} was refused again after ${landed} was granted, so granting cannot fix it (a deny rule or managed setting likely overrides the grant).`);
|
|
614
|
+
}
|
|
615
|
+
|
|
616
|
+
const policy = await policyFor(member, st, composeRole);
|
|
617
|
+
if (policy.error) return stop('heal', policy.error);
|
|
618
|
+
|
|
619
|
+
const picked = new Set();
|
|
620
|
+
const alreadyGranted = new Set(st.granted);
|
|
621
|
+
const rejected = [];
|
|
622
|
+
for (const item of items) {
|
|
623
|
+
const options = Array.isArray(item.suggestedGrants) ? item.suggestedGrants : (denial.suggestedGrants || []);
|
|
624
|
+
if (options.length === 0) return stop('no_progress', `no compose_permissions grant maps to ${describeCall(item)} (e.g. a chained shell command).`);
|
|
625
|
+
const pick = options.find((g) => grantWithinPolicy(g, policy.allow));
|
|
626
|
+
if (!pick) { rejected.push(...options); continue; }
|
|
627
|
+
if (!alreadyGranted.has(pick)) picked.add(pick);
|
|
628
|
+
}
|
|
629
|
+
const newGrants = [...picked];
|
|
630
|
+
if (rejected.length) {
|
|
631
|
+
return stop('no_progress', `${[...new Set(rejected)].join(', ')} is outside the '${composeRole}' composed policy for this member; an operator must grant it deliberately.`, [...new Set(rejected)]);
|
|
632
|
+
}
|
|
633
|
+
if (newGrants.length === 0) return stop('no_progress', `every grant for ${what} is already in place.`);
|
|
634
|
+
|
|
635
|
+
const ledger = ledgerFolderFor(member);
|
|
636
|
+
const ledgerArg = ledger ? { project_folder: ledger } : {};
|
|
637
|
+
if (!st.recomposed) {
|
|
638
|
+
log(`[permission-heal] member '${member}' (${role}) was refused ${what}; re-composing its permissions with role '${composeRole}' (first heal this sprint).`);
|
|
639
|
+
const re = await compose({ member_name: member, role: composeRole, ...ledgerArg });
|
|
640
|
+
if (re.error) return stop('heal', re.error);
|
|
641
|
+
st.recomposed = true;
|
|
642
|
+
}
|
|
643
|
+
const granted = await compose({
|
|
644
|
+
member_name: member,
|
|
645
|
+
role: composeRole,
|
|
646
|
+
grant: newGrants,
|
|
647
|
+
grant_reason: `sprint ${role} dispatch was refused these tool calls`,
|
|
648
|
+
...ledgerArg,
|
|
649
|
+
});
|
|
650
|
+
// A refused grant call (compose_permissions' NEVER_AUTO_GRANT floor,
|
|
651
|
+
// or a delivery failure -- its own message says which) lands nothing:
|
|
652
|
+
// stop and name the grants for an operator.
|
|
653
|
+
if (granted.error) return stop('heal', granted.error, newGrants);
|
|
654
|
+
st.granted.push(...newGrants);
|
|
655
|
+
st.healCount += 1;
|
|
656
|
+
log(`[permission-heal] member '${member}': granted ${newGrants.join(', ')} (heal ${st.healCount}/${PERMISSION_HEAL_MEMBER_CAP} this sprint).`);
|
|
657
|
+
return { healed: true, composeRole, grants: newGrants, rejectedGrants: [], reason: null };
|
|
658
|
+
};
|
|
659
|
+
}
|
|
660
|
+
|
|
661
|
+
/**
|
|
662
|
+
* Stage `content` to a fresh temp file ON THE MEMBER that will run the
|
|
663
|
+
* subsequent `bd` command, and return that MEMBER-LOCAL absolute path.
|
|
664
|
+
* `command()` may dispatch `bd` to a different machine than the workflow
|
|
665
|
+
* engine runs on, so a body file written to the engine host's own tmpdir
|
|
666
|
+
* would not exist where `bd --body-file` reads it. Staging via `command()`
|
|
667
|
+
* (member_name: member) guarantees the file lands on the SAME filesystem.
|
|
668
|
+
*
|
|
669
|
+
* The write is performed by a member-side `node` one-liner -- `node` is
|
|
670
|
+
* present on every fleet member -- and the recipe is shell-agnostic: it
|
|
671
|
+
* contains no `$`-expansion, backticks, template literals, or `%`-vars, so it
|
|
672
|
+
* is inert as syntax in POSIX shells, PowerShell, and cmd.exe alike.
|
|
673
|
+
* `content` is base64-encoded and passed as a SINGLE argv token whose
|
|
674
|
+
* alphabet (A-Za-z0-9+/=) is likewise inert in all of those shells, and node
|
|
675
|
+
* decodes it back to the exact literal bytes. This is the injection-safety
|
|
676
|
+
* property: caller-supplied free text is NEVER interpolated into the shell
|
|
677
|
+
* command string. The staged file is a member-side OS temp file the member's
|
|
678
|
+
* OS reaps on its own.
|
|
679
|
+
* @param {{ command: Function, member: string, content: string, label?: string }} opts
|
|
680
|
+
* @returns {Promise<string>} the MEMBER-LOCAL temp file path
|
|
681
|
+
*/
|
|
682
|
+
export async function stageCommandBodyMemberSide({ command, member, content, label }) {
|
|
683
|
+
const b64 = Buffer.from(content, 'utf-8').toString('base64');
|
|
684
|
+
// No backticks / no `$` / no template literals: inert across POSIX,
|
|
685
|
+
// PowerShell, and cmd.exe. Reads the base64 body from argv[1] (the first
|
|
686
|
+
// arg after the `-e` script), decodes it to raw bytes, writes them to a
|
|
687
|
+
// fresh member-local temp file, and prints ONLY that path to stdout.
|
|
688
|
+
const stageScript =
|
|
689
|
+
"const os=require('os'),p=require('path'),fs=require('fs');" +
|
|
690
|
+
"const f=p.join(os.tmpdir(),'fleet-sprint-body-'+process.pid+'-'+Date.now()+'-'+Math.random().toString(36).slice(2)+'.txt');" +
|
|
691
|
+
"fs.writeFileSync(f,Buffer.from(process.argv[1],'base64'));process.stdout.write(f)";
|
|
692
|
+
const out = await command(
|
|
693
|
+
`node -e "${stageScript}" "${b64}"`,
|
|
694
|
+
{ member_name: member, silent: true, label: label ?? 'Stage bd body file member-side' }
|
|
695
|
+
);
|
|
696
|
+
const staged = String(out ?? '').trim();
|
|
697
|
+
if (!staged) throw new Error('member-side body staging returned an empty path');
|
|
698
|
+
return staged;
|
|
699
|
+
}
|