@apralabs/apra-fleet 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +53 -5
- package/dist/tools/check-status.js +210 -53
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +30 -10
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -40,9 +40,17 @@
|
|
|
40
40
|
// expansion (base64-encoded argv, no `$`/backtick/template-literal
|
|
41
41
|
// interpolation), which is exactly the invariant shell-command-guard.mjs
|
|
42
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).
|
|
43
46
|
|
|
47
|
+
import os from 'node:os';
|
|
48
|
+
import { createHash } from 'node:crypto';
|
|
49
|
+
import path from 'node:path';
|
|
44
50
|
import { ApraFleet } from '@apralabs/apra-fleet-client';
|
|
45
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';
|
|
46
54
|
|
|
47
55
|
/**
|
|
48
56
|
* Guards every "resume" re-dispatch below against spawning a second
|
|
@@ -211,6 +219,445 @@ export function createDeployPermissionsProvisioner(opts = {}) {
|
|
|
211
219
|
};
|
|
212
220
|
}
|
|
213
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
|
+
|
|
214
661
|
/**
|
|
215
662
|
* Stage `content` to a fresh temp file ON THE MEMBER that will run the
|
|
216
663
|
* subsequent `bd` command, and return that MEMBER-LOCAL absolute path.
|