@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
|
@@ -1,23 +1,36 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
3
|
"$id": "apra-pm/regression-test-runner-output@1",
|
|
4
|
-
"version":
|
|
4
|
+
"version": 3,
|
|
5
5
|
"title": "regression-test-runner output",
|
|
6
|
-
"description": "Canonical machine-readable output contract for the regression-test-runner role. See agents/regression-test-runner.md Step 4 for the prose contract this mirrors. This result is informational: it never gates the current sprint's PASS/FAIL verdict -- failures carry over to a future sprint as parent-less [regression][carry-over] beads.",
|
|
6
|
+
"description": "Canonical machine-readable output contract for the regression-test-runner role. See agents/regression-test-runner.md Step 4 for the prose contract this mirrors. This result is informational: it never gates the current sprint's PASS/FAIL verdict -- failures carry over to a future sprint as parent-less [regression][carry-over] beads. The target repo's regression-test-playbook.md defines what the pass consists of; this contract does not assume any particular structure.",
|
|
7
7
|
"type": "object",
|
|
8
|
-
"required": ["passed", "
|
|
8
|
+
"required": ["passed", "bugsFiled", "summary"],
|
|
9
9
|
"properties": {
|
|
10
10
|
"passed": {
|
|
11
11
|
"type": "boolean",
|
|
12
|
-
"description": "True only if
|
|
12
|
+
"description": "True only if every part of the pass the playbook defines passed AND no carry-over bug was filed this run."
|
|
13
|
+
},
|
|
14
|
+
"sections": {
|
|
15
|
+
"type": "array",
|
|
16
|
+
"items": {
|
|
17
|
+
"type": "object",
|
|
18
|
+
"required": ["name", "passed"],
|
|
19
|
+
"properties": {
|
|
20
|
+
"name": { "type": "string", "description": "The part's name exactly as the playbook names it." },
|
|
21
|
+
"passed": { "type": "boolean" },
|
|
22
|
+
"detail": { "type": "string", "description": "Optional one-line result detail (counts, failing step)." }
|
|
23
|
+
}
|
|
24
|
+
},
|
|
25
|
+
"description": "Per-part results, one entry per part the playbook defines (a playbook with a single part yields one entry). Omit only if the pass stopped before running any part."
|
|
13
26
|
},
|
|
14
27
|
"suitePassed": {
|
|
15
28
|
"type": "boolean",
|
|
16
|
-
"description": "
|
|
29
|
+
"description": "Deprecated legacy field from the earlier two-part contract; still accepted, never required. Report per-part results in sections instead."
|
|
17
30
|
},
|
|
18
31
|
"smokePassed": {
|
|
19
32
|
"type": "boolean",
|
|
20
|
-
"description": "
|
|
33
|
+
"description": "Deprecated legacy field from the earlier two-part contract; still accepted, never required. Report per-part results in sections instead."
|
|
21
34
|
},
|
|
22
35
|
"bugsFiled": {
|
|
23
36
|
"type": "array",
|
|
@@ -28,10 +41,31 @@
|
|
|
28
41
|
"type": "string",
|
|
29
42
|
"description": "One paragraph describing what was tested, what passed, what failed, and reiterating that the result is informational."
|
|
30
43
|
},
|
|
44
|
+
"verdict": {
|
|
45
|
+
"type": "string",
|
|
46
|
+
"enum": ["PASS", "FAIL", "INCONCLUSIVE"],
|
|
47
|
+
"description": "Optional. Present only when the playbook names a machine-written verdict file: copied from it verbatim, never authored by the runner. When present, passed must equal (verdict == \"PASS\"). INCONCLUSIVE means the pass could not prove anything either way; it is not a failure."
|
|
48
|
+
},
|
|
49
|
+
"testedSha": {
|
|
50
|
+
"type": "string",
|
|
51
|
+
"pattern": "^[0-9a-f]{40}$",
|
|
52
|
+
"description": "Optional. The full commit sha the verdict file says was tested, copied verbatim from it."
|
|
53
|
+
},
|
|
54
|
+
"evidence": {
|
|
55
|
+
"type": "object",
|
|
56
|
+
"additionalProperties": true,
|
|
57
|
+
"properties": {
|
|
58
|
+
"verdictRef": { "type": "string", "description": "Where the verdict file lives (path or URL)." },
|
|
59
|
+
"runUrl": { "type": "string", "description": "URL of the run that produced the verdict file." },
|
|
60
|
+
"newFailures": { "type": "array", "items": { "type": "string" }, "description": "New failure fingerprints, copied from the verdict file." },
|
|
61
|
+
"inventoryMissing": { "type": "array", "items": { "type": "string" }, "description": "Required coverage items the run did not cover, copied from the verdict file." }
|
|
62
|
+
},
|
|
63
|
+
"description": "Optional. Pointers to and key lists from the machine-written verdict file, copied verbatim from it."
|
|
64
|
+
},
|
|
31
65
|
"smokeEvidence": {
|
|
32
66
|
"type": "object",
|
|
33
67
|
"additionalProperties": true,
|
|
34
|
-
"description": "Optional structured evidence
|
|
68
|
+
"description": "Optional structured evidence, so the result is machine-checkable instead of self-reported prose. This schema does not define its shape -- the target repo's regression-test-playbook.md does (the field name is kept for compatibility). Omit if that playbook defines no structured evidence."
|
|
35
69
|
}
|
|
36
70
|
}
|
|
37
71
|
}
|
|
@@ -34,6 +34,10 @@
|
|
|
34
34
|
"type": "string"
|
|
35
35
|
}
|
|
36
36
|
},
|
|
37
|
+
"buildFailing": {
|
|
38
|
+
"type": "boolean",
|
|
39
|
+
"description": "Optional. true when the project's build or test suite FAILS on the branch under review. On a CHANGES_NEEDED verdict the orchestrator guarantees a fix is dispatched: if none of your reopenIds can be reopened and no in-goal newTask covers it, it files an in-goal fix task carrying your notes. Omit or false when the build and tests pass."
|
|
40
|
+
},
|
|
37
41
|
"newTasks": {
|
|
38
42
|
"type": "array",
|
|
39
43
|
"items": {
|
|
@@ -46,7 +50,7 @@
|
|
|
46
50
|
"properties": {
|
|
47
51
|
"title": {
|
|
48
52
|
"type": "string",
|
|
49
|
-
"description": "Plain text only: letters, digits, space, and . , : ; ! ? ( ) ' _ / [ ] - -- nothing else. No backticks, double quotes, $, or backslash (the title is interpolated into a shell command downstream). Do NOT wrap a command/flag/filename in backticks here -- write it plain (e.g. \"Surface the
|
|
53
|
+
"description": "Plain text only: letters, digits, space, and . , : ; ! ? ( ) ' _ / [ ] - -- nothing else. No backticks, double quotes, $, or backslash (the title is interpolated into a shell command downstream). Do NOT wrap a command/flag/filename in backticks here -- write it plain (e.g. \"Surface the service registration mode in the status output\") or move the formatted detail into description instead, which has no such restriction. NOT enforced as a hard schema constraint here (deliberately no \"pattern\"): a single out-of-allowlist newTask title must never make ajv reject/retry the WHOLE structured verdict (verdict, notes, reopenIds, and the other newTasks) -- see validateNewTask() in fleet-sprint/runner.js, the actual (per-item, non-fatal) enforcement point, applied after parsing."
|
|
50
54
|
},
|
|
51
55
|
"description": {
|
|
52
56
|
"type": "string"
|
|
@@ -80,6 +84,29 @@
|
|
|
80
84
|
}
|
|
81
85
|
}
|
|
82
86
|
},
|
|
87
|
+
"kb_discards": {
|
|
88
|
+
"type": "array",
|
|
89
|
+
"description": "Promotion candidates this reviewer showed to be WRONG and is discarding (the entry drops out of every later read). Reviewer-only, with the same evidence bar as kb_promotions. An id may not appear in both kb_promotions and kb_discards -- the engine refuses both. The engine makes the discard calls.",
|
|
90
|
+
"items": {
|
|
91
|
+
"type": "object",
|
|
92
|
+
"required": [
|
|
93
|
+
"id",
|
|
94
|
+
"reason"
|
|
95
|
+
],
|
|
96
|
+
"properties": {
|
|
97
|
+
"id": {
|
|
98
|
+
"type": "string",
|
|
99
|
+
"description": "The entry id, copied verbatim from the 'KNOWLEDGE BANK -- promotion candidates' block in your dispatch prompt. That block is the ONLY source of discardable ids -- do not call a kb_* tool to find one, and never invent one.",
|
|
100
|
+
"minLength": 1
|
|
101
|
+
},
|
|
102
|
+
"reason": {
|
|
103
|
+
"type": "string",
|
|
104
|
+
"description": "The evidence that the entry is wrong -- what you actually checked that contradicts its claim.",
|
|
105
|
+
"minLength": 20
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
},
|
|
83
110
|
"kb_captures": {
|
|
84
111
|
"type": "array",
|
|
85
112
|
"description": "Durable knowledge this role verified during its run. The engine makes the kb_capture calls; the role only decides. Optional -- omit or send [] to capture nothing.",
|
|
@@ -111,12 +138,12 @@
|
|
|
111
138
|
},
|
|
112
139
|
"content": {
|
|
113
140
|
"type": "string",
|
|
114
|
-
"description": "Full detail of the entry. REQUIRED --
|
|
141
|
+
"description": "Full detail of the entry. REQUIRED -- a capture without it is rejected and persists nothing.",
|
|
115
142
|
"minLength": 40
|
|
116
143
|
},
|
|
117
144
|
"source_files": {
|
|
118
145
|
"type": "array",
|
|
119
|
-
"description": "Files that make this claim checkable. At least one is REQUIRED --
|
|
146
|
+
"description": "Files that make this claim checkable. At least one is REQUIRED -- an entry with no basis is rejected, because the freshness sweep can never stale it.",
|
|
120
147
|
"items": {
|
|
121
148
|
"type": "string"
|
|
122
149
|
},
|
|
@@ -130,6 +157,38 @@
|
|
|
130
157
|
}
|
|
131
158
|
}
|
|
132
159
|
}
|
|
160
|
+
},
|
|
161
|
+
"toolUse": {
|
|
162
|
+
"type": "object",
|
|
163
|
+
"description": "How this run used the kb_* and code_* tools its role prompt expects (Step 0). Optional for backward compatibility, but expected: report \"unavailable\" or \"not_needed\" with a note rather than skipping the calls silently.",
|
|
164
|
+
"required": [
|
|
165
|
+
"kb",
|
|
166
|
+
"code"
|
|
167
|
+
],
|
|
168
|
+
"properties": {
|
|
169
|
+
"kb": {
|
|
170
|
+
"type": "string",
|
|
171
|
+
"enum": [
|
|
172
|
+
"used",
|
|
173
|
+
"unavailable",
|
|
174
|
+
"not_needed"
|
|
175
|
+
],
|
|
176
|
+
"description": "used = kb_query was called (kb_session_prime alone is not used)."
|
|
177
|
+
},
|
|
178
|
+
"code": {
|
|
179
|
+
"type": "string",
|
|
180
|
+
"enum": [
|
|
181
|
+
"used",
|
|
182
|
+
"unavailable",
|
|
183
|
+
"not_needed"
|
|
184
|
+
],
|
|
185
|
+
"description": "used = code_impact, code_context or code_graph was called."
|
|
186
|
+
},
|
|
187
|
+
"note": {
|
|
188
|
+
"type": "string",
|
|
189
|
+
"description": "Why a value is not \"used\": which tool was missing or failed, or why no lookup was needed."
|
|
190
|
+
}
|
|
191
|
+
}
|
|
133
192
|
}
|
|
134
193
|
}
|
|
135
194
|
}
|
|
@@ -4,9 +4,97 @@
|
|
|
4
4
|
* Claude frontmatter: name, description, tools (comma/list)
|
|
5
5
|
* OpenCode frontmatter: description, mode: subagent, permission map (no name)
|
|
6
6
|
*
|
|
7
|
-
* NOTE:
|
|
8
|
-
*
|
|
7
|
+
* NOTE: packages/apra-fleet-se/apra-pm/install.mjs is NOT an npm workspace (see the
|
|
8
|
+
* comment at its own transformAgentForAgy/transformAgentForOpenCode) and carries its
|
|
9
|
+
* own copies of the following symbols from this file -- keep BOTH sides in sync
|
|
10
|
+
* whenever adding new tool mappings or frontmatter fields:
|
|
11
|
+
* - transformAgentForOpenCode
|
|
12
|
+
* - transformAgentForAgy
|
|
13
|
+
* - agyToolMap
|
|
14
|
+
* - OPENCODE_NATIVE_TOOLS
|
|
15
|
+
* - CONDITIONAL_MARKER_RE
|
|
16
|
+
* - resolveConditionalBody
|
|
17
|
+
* - toolAvailability
|
|
18
|
+
* - readFrontmatterTools
|
|
19
|
+
* tests/agent-transform-apra-pm-sync.test.ts guards ALL of the above, in three
|
|
20
|
+
* complementary ways:
|
|
21
|
+
* - SOURCE-TEXT guard: agyToolMap and OPENCODE_NATIVE_TOOLS are extracted from
|
|
22
|
+
* both files and compared as parsed values, so an edit to one literal
|
|
23
|
+
* without the other fails the suite.
|
|
24
|
+
* - BEHAVIOURAL guard (frontmatter-less): one shared fixture corpus (if/else,
|
|
25
|
+
* else-less if, nested, repeated, tool-present, tool-absent, plus the four
|
|
26
|
+
* malformed cases) is fed through BOTH implementations for agy and
|
|
27
|
+
* opencode, and the outputs must be byte-identical strings / the thrown
|
|
28
|
+
* MESSAGES must match. That drives CONDITIONAL_MARKER_RE,
|
|
29
|
+
* resolveConditionalBody and toolAvailability's `declared === null` branch
|
|
30
|
+
* transitively through the exported transform entry points -- none of
|
|
31
|
+
* those three is exported on either side, and the test does not widen
|
|
32
|
+
* exports to reach them.
|
|
33
|
+
* - BEHAVIOURAL guard (declared frontmatter tools, apra-fleet-oomh.15): a
|
|
34
|
+
* second fixture corpus adds real `tools:` frontmatter declarations --
|
|
35
|
+
* including `tools: [*]` -- so toolAvailability's INTERSECTION branch
|
|
36
|
+
* (the intersection of declared tools and provider-supported tools) and isWildcardTools() /
|
|
37
|
+
* install.mjs's inlined `declared.some(t => t === '*')` are also driven on
|
|
38
|
+
* both sides, alongside readFrontmatterTools. Because transformAgentForAgy/
|
|
39
|
+
* ForOpenCode also rewrite the frontmatter itself when one is present
|
|
40
|
+
* (unlike .mjs's resolveAgentConditionals, see below), each fixture body is
|
|
41
|
+
* wrapped in sentinel strings and outputs are compared only in the
|
|
42
|
+
* sentinel-delimited region -- this keeps the comparison scoped to marker
|
|
43
|
+
* resolution and inert to frontmatter-rewrite differences.
|
|
44
|
+
*
|
|
45
|
+
* Note the two structural asymmetries the test documents and works around: the
|
|
46
|
+
* .mjs body resolver is named resolveAgentConditionals (not
|
|
47
|
+
* resolveConditionalBody) and takes a provider string rather than a predicate,
|
|
48
|
+
* and the .mjs transformAgentForAgy/ForOpenCode do NOT resolve body markers
|
|
49
|
+
* (install() does that in a separate pass). The one residual gap after
|
|
50
|
+
* apra-fleet-oomh.15: drift in the frontmatter-REWRITING half of
|
|
51
|
+
* transformAgentForAgy/transformAgentForOpenCode (name/description echoing,
|
|
52
|
+
* Claude-name -> provider-tool-name mapping, the agy auto-approve rules block,
|
|
53
|
+
* opencode's permission map) is still unguarded by this suite -- update those
|
|
54
|
+
* by hand on both sides.
|
|
55
|
+
*/
|
|
56
|
+
/**
|
|
57
|
+
* Thrown when a conditional block is unclosed, unmatched, or mismatched. Surfaced
|
|
58
|
+
* at install time rather than swallowed -- see the note above.
|
|
59
|
+
*/
|
|
60
|
+
export declare class ConditionalMarkerError extends Error {
|
|
61
|
+
constructor(label: string, detail: string);
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Resolve every conditional block in `text` against a tool-availability predicate.
|
|
65
|
+
*
|
|
66
|
+
* @param text any agent file content (frontmatter carries no markers)
|
|
67
|
+
* @param isAvailable answers "does this provider give the agent this tool?"
|
|
68
|
+
* @param label file label used in error messages
|
|
69
|
+
*/
|
|
70
|
+
export declare function resolveConditionalBody(text: string, isAvailable: (tool: string) => boolean, label: string): string;
|
|
71
|
+
/**
|
|
72
|
+
* OpenCode's native subagent toolset, in Claude tool names.
|
|
73
|
+
*
|
|
74
|
+
* transformAgentForOpenCode emits no `tools:` line at all (OpenCode grants its
|
|
75
|
+
* built-ins and gates the dangerous ones through the permission map), so unlike
|
|
76
|
+
* agy there is no emitted frontmatter to read availability back off. It has to be
|
|
77
|
+
* stated explicitly, and this is that statement: anything NOT listed here is
|
|
78
|
+
* unavailable under OpenCode and its prose is resolved to the else-branch.
|
|
9
79
|
*/
|
|
80
|
+
export declare const OPENCODE_NATIVE_TOOLS: string[];
|
|
10
81
|
export declare function transformAgentForOpenCode(content: string, _filename: string): string;
|
|
82
|
+
/**
|
|
83
|
+
* The Claude/raw install path. Claude reads the source frontmatter as-authored, so
|
|
84
|
+
* nothing is rewritten -- but the markers themselves must still be stripped, or they
|
|
85
|
+
* ship verbatim into the installed agent file. Every conditional keeps its if-branch,
|
|
86
|
+
* because for Claude the tool map is the identity map over the declared tools.
|
|
87
|
+
*
|
|
88
|
+
* Non-agent assets travel this path too (schemas/*.json, _shared/*.md); they carry no
|
|
89
|
+
* frontmatter and no markers, so they pass through untouched.
|
|
90
|
+
*/
|
|
91
|
+
export declare function transformAgentForClaude(content: string, filename: string): string;
|
|
92
|
+
/**
|
|
93
|
+
* The fleet's member-session tools, in Claude's MCP tool-name form
|
|
94
|
+
* (mcp__apra-fleet__kb_query, ...): every kb_* / code_* tool of the member
|
|
95
|
+
* allowlist (MEMBER_ALLOWED_TOOLS). Derived from that list, never hand-listed
|
|
96
|
+
* here; a new kb_/code_ tool is granted once it is added to the allowlist.
|
|
97
|
+
*/
|
|
98
|
+
export declare function memberMcpToolGrants(): string[];
|
|
11
99
|
export declare function transformAgentForAgy(content: string, _filename: string): string;
|
|
12
100
|
//# sourceMappingURL=agent-transform.d.ts.map
|
|
@@ -4,9 +4,221 @@
|
|
|
4
4
|
* Claude frontmatter: name, description, tools (comma/list)
|
|
5
5
|
* OpenCode frontmatter: description, mode: subagent, permission map (no name)
|
|
6
6
|
*
|
|
7
|
-
* NOTE:
|
|
8
|
-
*
|
|
7
|
+
* NOTE: packages/apra-fleet-se/apra-pm/install.mjs is NOT an npm workspace (see the
|
|
8
|
+
* comment at its own transformAgentForAgy/transformAgentForOpenCode) and carries its
|
|
9
|
+
* own copies of the following symbols from this file -- keep BOTH sides in sync
|
|
10
|
+
* whenever adding new tool mappings or frontmatter fields:
|
|
11
|
+
* - transformAgentForOpenCode
|
|
12
|
+
* - transformAgentForAgy
|
|
13
|
+
* - agyToolMap
|
|
14
|
+
* - OPENCODE_NATIVE_TOOLS
|
|
15
|
+
* - CONDITIONAL_MARKER_RE
|
|
16
|
+
* - resolveConditionalBody
|
|
17
|
+
* - toolAvailability
|
|
18
|
+
* - readFrontmatterTools
|
|
19
|
+
* tests/agent-transform-apra-pm-sync.test.ts guards ALL of the above, in three
|
|
20
|
+
* complementary ways:
|
|
21
|
+
* - SOURCE-TEXT guard: agyToolMap and OPENCODE_NATIVE_TOOLS are extracted from
|
|
22
|
+
* both files and compared as parsed values, so an edit to one literal
|
|
23
|
+
* without the other fails the suite.
|
|
24
|
+
* - BEHAVIOURAL guard (frontmatter-less): one shared fixture corpus (if/else,
|
|
25
|
+
* else-less if, nested, repeated, tool-present, tool-absent, plus the four
|
|
26
|
+
* malformed cases) is fed through BOTH implementations for agy and
|
|
27
|
+
* opencode, and the outputs must be byte-identical strings / the thrown
|
|
28
|
+
* MESSAGES must match. That drives CONDITIONAL_MARKER_RE,
|
|
29
|
+
* resolveConditionalBody and toolAvailability's `declared === null` branch
|
|
30
|
+
* transitively through the exported transform entry points -- none of
|
|
31
|
+
* those three is exported on either side, and the test does not widen
|
|
32
|
+
* exports to reach them.
|
|
33
|
+
* - BEHAVIOURAL guard (declared frontmatter tools, apra-fleet-oomh.15): a
|
|
34
|
+
* second fixture corpus adds real `tools:` frontmatter declarations --
|
|
35
|
+
* including `tools: [*]` -- so toolAvailability's INTERSECTION branch
|
|
36
|
+
* (the intersection of declared tools and provider-supported tools) and isWildcardTools() /
|
|
37
|
+
* install.mjs's inlined `declared.some(t => t === '*')` are also driven on
|
|
38
|
+
* both sides, alongside readFrontmatterTools. Because transformAgentForAgy/
|
|
39
|
+
* ForOpenCode also rewrite the frontmatter itself when one is present
|
|
40
|
+
* (unlike .mjs's resolveAgentConditionals, see below), each fixture body is
|
|
41
|
+
* wrapped in sentinel strings and outputs are compared only in the
|
|
42
|
+
* sentinel-delimited region -- this keeps the comparison scoped to marker
|
|
43
|
+
* resolution and inert to frontmatter-rewrite differences.
|
|
44
|
+
*
|
|
45
|
+
* Note the two structural asymmetries the test documents and works around: the
|
|
46
|
+
* .mjs body resolver is named resolveAgentConditionals (not
|
|
47
|
+
* resolveConditionalBody) and takes a provider string rather than a predicate,
|
|
48
|
+
* and the .mjs transformAgentForAgy/ForOpenCode do NOT resolve body markers
|
|
49
|
+
* (install() does that in a separate pass). The one residual gap after
|
|
50
|
+
* apra-fleet-oomh.15: drift in the frontmatter-REWRITING half of
|
|
51
|
+
* transformAgentForAgy/transformAgentForOpenCode (name/description echoing,
|
|
52
|
+
* Claude-name -> provider-tool-name mapping, the agy auto-approve rules block,
|
|
53
|
+
* opencode's permission map) is still unguarded by this suite -- update those
|
|
54
|
+
* by hand on both sides.
|
|
55
|
+
*/
|
|
56
|
+
import { MEMBER_ALLOWED_TOOLS, MEMBER_TOOL_PREFIXES } from '../services/member-tool-allowlist.js';
|
|
57
|
+
import { MEMBER_MCP_SERVER_NAME } from '../services/member-config-io.js';
|
|
58
|
+
// --- Provider-conditional body blocks ---------------------------------------
|
|
59
|
+
//
|
|
60
|
+
// Dropping a tool from a transformed agent's frontmatter is only half a fix: the
|
|
61
|
+
// PROSE that tells the agent to call that tool has to go with it, or the installed
|
|
62
|
+
// prompt instructs the agent to use a tool it does not have. This is the generic
|
|
63
|
+
// mechanism for that, keyed off the SAME notion of "which tools survive" that
|
|
64
|
+
// drives the frontmatter for each provider.
|
|
65
|
+
//
|
|
66
|
+
// Marker convention (HTML comments, so a marker is invisible in rendered markdown
|
|
67
|
+
// and inert if some other reader ignores it):
|
|
68
|
+
//
|
|
69
|
+
// <!-- if-tool: SomeTool -->
|
|
70
|
+
// ...prose that only makes sense when the agent has SomeTool...
|
|
71
|
+
// <!-- else-tool: SomeTool -->
|
|
72
|
+
// ...provider-neutral fallback prose...
|
|
73
|
+
// <!-- end-tool: SomeTool -->
|
|
74
|
+
//
|
|
75
|
+
// Resolution, per provider:
|
|
76
|
+
// tool available -> keep the if-branch, drop the else-branch, drop the markers
|
|
77
|
+
// tool unavailable -> keep the else-branch, drop the if-branch, drop the markers
|
|
78
|
+
//
|
|
79
|
+
// The else-branch is optional; `<!-- if-tool: X -->` ... `<!-- end-tool: X -->`
|
|
80
|
+
// with no else simply deletes the block when X is unavailable.
|
|
81
|
+
//
|
|
82
|
+
// Blocks nest and repeat: an inner block is resolved into its enclosing branch
|
|
83
|
+
// before that branch is chosen or discarded, so prose inside a discarded branch
|
|
84
|
+
// disappears along with it.
|
|
85
|
+
//
|
|
86
|
+
// This mechanism is deliberately tool-name-generic. It knows nothing about any
|
|
87
|
+
// particular tool, MCP server, or target repository -- the tool name is whatever
|
|
88
|
+
// the marker says, and availability is decided by the per-provider tool sets
|
|
89
|
+
// below. See docs/generic-engine-boundary.md.
|
|
90
|
+
//
|
|
91
|
+
// Malformed markers are a HARD ERROR, not a warning: a half-rendered prompt that
|
|
92
|
+
// ships is worse than an install that stops and says which file is broken.
|
|
93
|
+
/** Matches any conditional marker anywhere, swallowing its line when it sits alone. */
|
|
94
|
+
const CONDITIONAL_MARKER_RE = /[ \t]*<!--[ \t]*(if-tool|else-tool|end-tool):[ \t]*([^\s>]+)[ \t]*-->[ \t]*(?:\r?\n)?/g;
|
|
95
|
+
/**
|
|
96
|
+
* Thrown when a conditional block is unclosed, unmatched, or mismatched. Surfaced
|
|
97
|
+
* at install time rather than swallowed -- see the note above.
|
|
98
|
+
*/
|
|
99
|
+
export class ConditionalMarkerError extends Error {
|
|
100
|
+
constructor(label, detail) {
|
|
101
|
+
super(`[agent-transform] ${label}: ${detail}`);
|
|
102
|
+
this.name = 'ConditionalMarkerError';
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
function scanConditionalMarkers(text) {
|
|
106
|
+
const re = new RegExp(CONDITIONAL_MARKER_RE.source, 'g');
|
|
107
|
+
const markers = [];
|
|
108
|
+
let m;
|
|
109
|
+
while ((m = re.exec(text)) !== null) {
|
|
110
|
+
markers.push({
|
|
111
|
+
kind: m[1],
|
|
112
|
+
tool: m[2],
|
|
113
|
+
start: m.index,
|
|
114
|
+
end: m.index + m[0].length,
|
|
115
|
+
});
|
|
116
|
+
}
|
|
117
|
+
return markers;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Resolve every conditional block in `text` against a tool-availability predicate.
|
|
121
|
+
*
|
|
122
|
+
* @param text any agent file content (frontmatter carries no markers)
|
|
123
|
+
* @param isAvailable answers "does this provider give the agent this tool?"
|
|
124
|
+
* @param label file label used in error messages
|
|
125
|
+
*/
|
|
126
|
+
export function resolveConditionalBody(text, isAvailable, label) {
|
|
127
|
+
const markers = scanConditionalMarkers(text);
|
|
128
|
+
if (markers.length === 0)
|
|
129
|
+
return text;
|
|
130
|
+
const stack = [];
|
|
131
|
+
let root = '';
|
|
132
|
+
const append = (chunk) => {
|
|
133
|
+
if (!chunk)
|
|
134
|
+
return;
|
|
135
|
+
const top = stack[stack.length - 1];
|
|
136
|
+
if (!top) {
|
|
137
|
+
root += chunk;
|
|
138
|
+
}
|
|
139
|
+
else if (top.seenElse) {
|
|
140
|
+
top.elseBuf += chunk;
|
|
141
|
+
}
|
|
142
|
+
else {
|
|
143
|
+
top.ifBuf += chunk;
|
|
144
|
+
}
|
|
145
|
+
};
|
|
146
|
+
let cursor = 0;
|
|
147
|
+
for (const marker of markers) {
|
|
148
|
+
append(text.slice(cursor, marker.start));
|
|
149
|
+
cursor = marker.end;
|
|
150
|
+
const top = stack[stack.length - 1];
|
|
151
|
+
if (marker.kind === 'if-tool') {
|
|
152
|
+
stack.push({ tool: marker.tool, seenElse: false, ifBuf: '', elseBuf: '' });
|
|
153
|
+
continue;
|
|
154
|
+
}
|
|
155
|
+
if (!top) {
|
|
156
|
+
throw new ConditionalMarkerError(label, `<!-- ${marker.kind}: ${marker.tool} --> has no matching <!-- if-tool: ${marker.tool} -->`);
|
|
157
|
+
}
|
|
158
|
+
if (top.tool !== marker.tool) {
|
|
159
|
+
throw new ConditionalMarkerError(label, `<!-- ${marker.kind}: ${marker.tool} --> does not match the open ` +
|
|
160
|
+
`<!-- if-tool: ${top.tool} -->`);
|
|
161
|
+
}
|
|
162
|
+
if (marker.kind === 'else-tool') {
|
|
163
|
+
if (top.seenElse) {
|
|
164
|
+
throw new ConditionalMarkerError(label, `duplicate <!-- else-tool: ${marker.tool} --> in one conditional block`);
|
|
165
|
+
}
|
|
166
|
+
top.seenElse = true;
|
|
167
|
+
continue;
|
|
168
|
+
}
|
|
169
|
+
// end-tool: pop and fold the chosen branch into the enclosing buffer.
|
|
170
|
+
stack.pop();
|
|
171
|
+
append(isAvailable(top.tool) ? top.ifBuf : top.elseBuf);
|
|
172
|
+
}
|
|
173
|
+
append(text.slice(cursor));
|
|
174
|
+
if (stack.length > 0) {
|
|
175
|
+
const unclosed = stack[stack.length - 1];
|
|
176
|
+
throw new ConditionalMarkerError(label, `unclosed <!-- if-tool: ${unclosed.tool} --> (missing <!-- end-tool: ${unclosed.tool} -->)`);
|
|
177
|
+
}
|
|
178
|
+
return root;
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
* Tools Antigravity can express. The keys ARE the availability set for agy: a tool
|
|
182
|
+
* with no mapping is dropped from the frontmatter, so its prose must go too.
|
|
183
|
+
*/
|
|
184
|
+
const agyToolMap = {
|
|
185
|
+
'Read': ['view_file'],
|
|
186
|
+
'Grep': ['grep_search'],
|
|
187
|
+
'Glob': ['list_dir'],
|
|
188
|
+
'Bash': ['run_command'],
|
|
189
|
+
'Write': ['write_to_file', 'replace_file_content'],
|
|
190
|
+
'Edit': ['replace_file_content'],
|
|
191
|
+
'Agent': ['invoke_subagent', 'send_message']
|
|
192
|
+
};
|
|
193
|
+
/**
|
|
194
|
+
* OpenCode's native subagent toolset, in Claude tool names.
|
|
195
|
+
*
|
|
196
|
+
* transformAgentForOpenCode emits no `tools:` line at all (OpenCode grants its
|
|
197
|
+
* built-ins and gates the dangerous ones through the permission map), so unlike
|
|
198
|
+
* agy there is no emitted frontmatter to read availability back off. It has to be
|
|
199
|
+
* stated explicitly, and this is that statement: anything NOT listed here is
|
|
200
|
+
* unavailable under OpenCode and its prose is resolved to the else-branch.
|
|
201
|
+
*/
|
|
202
|
+
export const OPENCODE_NATIVE_TOOLS = ['Read', 'Grep', 'Glob', 'Bash', 'Write', 'Edit', 'Agent'];
|
|
203
|
+
/** A frontmatter `tools: [...]` list that means "everything this provider has". */
|
|
204
|
+
function isWildcardTools(tools) {
|
|
205
|
+
return tools.some(t => t === '*');
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* Build the availability predicate for a provider.
|
|
209
|
+
*
|
|
210
|
+
* @param declared frontmatter tools of the SOURCE (Claude-format) agent, or null
|
|
211
|
+
* when the file declares none (then the agent has whatever the
|
|
212
|
+
* provider gives it, so every tool counts as available)
|
|
213
|
+
* @param supported tools the provider can express, or null for "all of them"
|
|
214
|
+
* (the Claude/raw path, whose frontmatter is authored for it)
|
|
9
215
|
*/
|
|
216
|
+
function toolAvailability(declared, supported) {
|
|
217
|
+
const declaredSet = declared === null || isWildcardTools(declared) ? null : new Set(declared);
|
|
218
|
+
const supportedSet = supported === null ? null : new Set(supported);
|
|
219
|
+
return (tool) => (declaredSet === null || declaredSet.has(tool)) &&
|
|
220
|
+
(supportedSet === null || supportedSet.has(tool));
|
|
221
|
+
}
|
|
10
222
|
function parseToolsList(toolsRaw) {
|
|
11
223
|
return toolsRaw
|
|
12
224
|
.replace(/^\[/, '')
|
|
@@ -28,8 +240,10 @@ function buildDefaultPermissionMap() {
|
|
|
28
240
|
}
|
|
29
241
|
export function transformAgentForOpenCode(content, _filename) {
|
|
30
242
|
const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
|
|
31
|
-
|
|
32
|
-
|
|
243
|
+
// No frontmatter to rewrite, but markers must never survive on any path.
|
|
244
|
+
if (!fmMatch) {
|
|
245
|
+
return resolveConditionalBody(content, toolAvailability(null, OPENCODE_NATIVE_TOOLS), _filename);
|
|
246
|
+
}
|
|
33
247
|
const frontmatter = fmMatch[1];
|
|
34
248
|
const body = content.slice(fmMatch[0].length);
|
|
35
249
|
let description = '';
|
|
@@ -47,6 +261,7 @@ export function transformAgentForOpenCode(content, _filename) {
|
|
|
47
261
|
}
|
|
48
262
|
}
|
|
49
263
|
const perm = hasTools ? buildPermissionMap(tools) : buildDefaultPermissionMap();
|
|
264
|
+
const resolvedBody = resolveConditionalBody(body, toolAvailability(hasTools ? tools : null, OPENCODE_NATIVE_TOOLS), _filename);
|
|
50
265
|
const opencodeFm = [
|
|
51
266
|
'---',
|
|
52
267
|
`description: ${description}`,
|
|
@@ -58,12 +273,82 @@ export function transformAgentForOpenCode(content, _filename) {
|
|
|
58
273
|
'---',
|
|
59
274
|
'',
|
|
60
275
|
].join('\n');
|
|
61
|
-
return opencodeFm +
|
|
276
|
+
return opencodeFm + resolvedBody;
|
|
62
277
|
}
|
|
63
|
-
|
|
278
|
+
/**
|
|
279
|
+
* The Claude/raw install path. Claude reads the source frontmatter as-authored, so
|
|
280
|
+
* nothing is rewritten -- but the markers themselves must still be stripped, or they
|
|
281
|
+
* ship verbatim into the installed agent file. Every conditional keeps its if-branch,
|
|
282
|
+
* because for Claude the tool map is the identity map over the declared tools.
|
|
283
|
+
*
|
|
284
|
+
* Non-agent assets travel this path too (schemas/*.json, _shared/*.md); they carry no
|
|
285
|
+
* frontmatter and no markers, so they pass through untouched.
|
|
286
|
+
*/
|
|
287
|
+
export function transformAgentForClaude(content, filename) {
|
|
288
|
+
const declared = readFrontmatterTools(content);
|
|
289
|
+
const resolved = resolveConditionalBody(content, toolAvailability(declared, null), filename);
|
|
290
|
+
return grantMemberMcpTools(resolved, declared);
|
|
291
|
+
}
|
|
292
|
+
/**
|
|
293
|
+
* The fleet's member-session tools, in Claude's MCP tool-name form
|
|
294
|
+
* (mcp__apra-fleet__kb_query, ...): every kb_* / code_* tool of the member
|
|
295
|
+
* allowlist (MEMBER_ALLOWED_TOOLS). Derived from that list, never hand-listed
|
|
296
|
+
* here; a new kb_/code_ tool is granted once it is added to the allowlist.
|
|
297
|
+
*/
|
|
298
|
+
export function memberMcpToolGrants() {
|
|
299
|
+
return MEMBER_ALLOWED_TOOLS
|
|
300
|
+
.filter(t => MEMBER_TOOL_PREFIXES.some(p => t.startsWith(p)))
|
|
301
|
+
.map(t => `mcp__${MEMBER_MCP_SERVER_NAME}__${t}`);
|
|
302
|
+
}
|
|
303
|
+
/**
|
|
304
|
+
* A role dispatched on a member runs as `claude --agent <role>`, and an agent's
|
|
305
|
+
* `tools:` frontmatter is an ALLOWLIST for the whole session: a list with no
|
|
306
|
+
* mcp__ entries hides every MCP tool, so the role never sees the member's
|
|
307
|
+
* kb_* / code_* tools even though its apra-fleet server is connected. Append
|
|
308
|
+
* the member tool grants to every restrictive list (exact names, not the
|
|
309
|
+
* server-level `mcp__apra-fleet` pattern: a role run as a local subagent of an
|
|
310
|
+
* orchestrator session talks to that session's FULL fleet server, and must
|
|
311
|
+
* still only reach kb_* / code_*). A file with no tools list, or a wildcard
|
|
312
|
+
* one, already inherits every tool and is left as is. On a member the server
|
|
313
|
+
* itself serves only the member allowlist and the composed deny rules still
|
|
314
|
+
* apply, so the grant widens nothing beyond that.
|
|
315
|
+
*/
|
|
316
|
+
function grantMemberMcpTools(content, declared) {
|
|
317
|
+
if (declared === null || isWildcardTools(declared))
|
|
318
|
+
return content;
|
|
64
319
|
const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
|
|
65
320
|
if (!fmMatch)
|
|
66
321
|
return content;
|
|
322
|
+
const missing = memberMcpToolGrants().filter(t => !declared.includes(t));
|
|
323
|
+
if (missing.length === 0)
|
|
324
|
+
return content;
|
|
325
|
+
const lines = fmMatch[1].split('\n');
|
|
326
|
+
const idx = lines.findIndex(l => /^tools:\s*(.+)/.test(l));
|
|
327
|
+
if (idx === -1)
|
|
328
|
+
return content;
|
|
329
|
+
lines[idx] = `tools: [${[...declared, ...missing].join(', ')}]`;
|
|
330
|
+
const start = fmMatch[0].indexOf(fmMatch[1]);
|
|
331
|
+
const newFm = fmMatch[0].slice(0, start) + lines.join('\n') + fmMatch[0].slice(start + fmMatch[1].length);
|
|
332
|
+
return newFm + content.slice(fmMatch[0].length);
|
|
333
|
+
}
|
|
334
|
+
/** Source (Claude-format) frontmatter tools, or null when the file declares none. */
|
|
335
|
+
function readFrontmatterTools(content) {
|
|
336
|
+
const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
|
|
337
|
+
if (!fmMatch)
|
|
338
|
+
return null;
|
|
339
|
+
for (const line of fmMatch[1].split('\n')) {
|
|
340
|
+
const toolsMatch = line.match(/^tools:\s*(.+)/);
|
|
341
|
+
if (toolsMatch)
|
|
342
|
+
return parseToolsList(toolsMatch[1].trim());
|
|
343
|
+
}
|
|
344
|
+
return null;
|
|
345
|
+
}
|
|
346
|
+
export function transformAgentForAgy(content, _filename) {
|
|
347
|
+
const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
|
|
348
|
+
// No frontmatter to rewrite, but markers must never survive on any path.
|
|
349
|
+
if (!fmMatch) {
|
|
350
|
+
return resolveConditionalBody(content, toolAvailability(null, Object.keys(agyToolMap)), _filename);
|
|
351
|
+
}
|
|
67
352
|
const frontmatter = fmMatch[1];
|
|
68
353
|
const body = content.slice(fmMatch[0].length);
|
|
69
354
|
let name = '';
|
|
@@ -91,22 +376,24 @@ export function transformAgentForAgy(content, _filename) {
|
|
|
91
376
|
if (description)
|
|
92
377
|
agyFm += `description: ${description}\n`;
|
|
93
378
|
if (hasTools) {
|
|
94
|
-
const agyToolMap = {
|
|
95
|
-
'Read': ['view_file'],
|
|
96
|
-
'Grep': ['grep_search'],
|
|
97
|
-
'Glob': ['list_dir'],
|
|
98
|
-
'Bash': ['run_command'],
|
|
99
|
-
'Write': ['write_to_file', 'replace_file_content', 'multi_replace_file_content'],
|
|
100
|
-
'Edit': ['replace_file_content', 'multi_replace_file_content'],
|
|
101
|
-
'Agent': ['invoke_subagent', 'send_message']
|
|
102
|
-
};
|
|
103
379
|
const mappedTools = new Set();
|
|
380
|
+
const unmappedTools = [];
|
|
104
381
|
for (const tool of tools) {
|
|
105
|
-
const mapped = agyToolMap[tool]
|
|
106
|
-
|
|
107
|
-
|
|
382
|
+
const mapped = agyToolMap[tool];
|
|
383
|
+
if (mapped) {
|
|
384
|
+
for (const m of mapped)
|
|
385
|
+
mappedTools.add(m);
|
|
386
|
+
}
|
|
387
|
+
else {
|
|
388
|
+
unmappedTools.push(tool);
|
|
389
|
+
}
|
|
390
|
+
}
|
|
391
|
+
if (unmappedTools.length > 0) {
|
|
392
|
+
console.warn(`[agy] dropping tools with no Antigravity equivalent from agent "${name || _filename}": ${unmappedTools.join(', ')}`);
|
|
393
|
+
}
|
|
394
|
+
if (mappedTools.size > 0) {
|
|
395
|
+
agyFm += `tools: [${Array.from(mappedTools).join(', ')}]\n`;
|
|
108
396
|
}
|
|
109
|
-
agyFm += `tools: [${Array.from(mappedTools).join(', ')}]\n`;
|
|
110
397
|
}
|
|
111
398
|
agyFm += '---\n\n';
|
|
112
399
|
let agyRules = '';
|
|
@@ -135,6 +422,9 @@ export function transformAgentForAgy(content, _filename) {
|
|
|
135
422
|
}
|
|
136
423
|
agyRules += ' </auto_approve>\n</rule>\n';
|
|
137
424
|
}
|
|
138
|
-
|
|
425
|
+
// Same tool map that decided the frontmatter above decides the prose: a tool with
|
|
426
|
+
// no Antigravity equivalent loses its instructions along with its tools entry.
|
|
427
|
+
const resolvedBody = resolveConditionalBody(body, toolAvailability(hasTools ? tools : null, Object.keys(agyToolMap)), _filename);
|
|
428
|
+
return agyFm + resolvedBody.trim() + '\n' + agyRules;
|
|
139
429
|
}
|
|
140
430
|
//# sourceMappingURL=agent-transform.js.map
|