@apralabs/apra-fleet 0.4.3 → 0.4.5
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 +114 -33
- package/dist/agents/backlog-groomer.md +80 -27
- package/dist/agents/ci-watcher.md +42 -22
- package/dist/agents/deployer.md +59 -24
- package/dist/agents/doer.md +111 -41
- package/dist/agents/harvester.md +60 -48
- package/dist/agents/integ-test-runner.md +45 -23
- package/dist/agents/kb-reconciler.md +34 -7
- package/dist/agents/plan-reviewer.md +54 -24
- package/dist/agents/planner.md +71 -43
- package/dist/agents/regression-test-runner.md +106 -78
- package/dist/agents/reviewer.md +170 -57
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/deployer-output.json +5 -0
- package/dist/agents/schemas/doer-output.json +110 -2
- 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 +166 -5
- 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 +42 -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 +26 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/claude-mod.d.ts +75 -0
- package/dist/cli/claude-mod.js +288 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +19 -3
- package/dist/cli/dolt-install.js +51 -16
- package/dist/cli/fleet-se-guard.d.ts +59 -0
- package/dist/cli/fleet-se-guard.js +231 -0
- package/dist/cli/install-guard.d.ts +63 -0
- package/dist/cli/install-guard.js +156 -4
- package/dist/cli/install.d.ts +89 -21
- package/dist/cli/install.js +778 -160
- 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/kb-profile.d.ts +16 -0
- package/dist/cli/kb-profile.js +81 -0
- 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 +62 -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 +112 -16
- package/dist/cli/update.d.ts +4 -0
- package/dist/cli/update.js +52 -5
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.d.ts +10 -1
- package/dist/commands/kb-server.js +292 -11
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +177 -9
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/git-executable.d.ts +57 -0
- package/dist/os/git-executable.js +85 -0
- package/dist/os/go-concurrency.d.ts +44 -0
- package/dist/os/go-concurrency.js +53 -0
- package/dist/os/index.d.ts +1 -0
- package/dist/os/index.js +1 -0
- package/dist/os/linux.d.ts +9 -2
- package/dist/os/linux.js +50 -15
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +42 -2
- package/dist/os/os-commands.js +2 -0
- package/dist/os/windows-executable.d.ts +53 -0
- package/dist/os/windows-executable.js +185 -0
- package/dist/os/windows-gitbash.d.ts +24 -14
- package/dist/os/windows-gitbash.js +56 -18
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +7 -2
- package/dist/os/windows.js +109 -32
- package/dist/paths.d.ts +30 -0
- package/dist/paths.js +52 -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 +9 -2
- package/dist/services/agy-project.js +22 -19
- package/dist/services/auth-socket.d.ts +43 -0
- package/dist/services/auth-socket.js +97 -26
- 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/credential-store.d.ts +33 -0
- package/dist/services/credential-store.js +79 -2
- 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 +78 -1
- package/dist/services/http-transport.js +347 -52
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/kb-tool-profile.d.ts +36 -0
- package/dist/services/kb-tool-profile.js +88 -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 +122 -0
- package/dist/services/knowledge/bible-import.d.ts +173 -0
- package/dist/services/knowledge/bible-import.js +344 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +155 -24
- package/dist/services/knowledge/http-provider.d.ts +305 -21
- package/dist/services/knowledge/http-provider.js +801 -119
- package/dist/services/knowledge/kb-config.d.ts +65 -1
- package/dist/services/knowledge/kb-config.js +143 -3
- package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
- package/dist/services/knowledge/kb-http-auth-state.js +40 -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 +13 -2
- package/dist/services/knowledge/kb-providers.js +75 -37
- 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 +204 -0
- package/dist/services/knowledge/kb-self.js +358 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +207 -0
- package/dist/services/knowledge/path-validation.d.ts +7 -0
- package/dist/services/knowledge/path-validation.js +11 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +5 -4
- package/dist/services/knowledge/repository-header.d.ts +77 -0
- package/dist/services/knowledge/repository-header.js +233 -0
- package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
- package/dist/services/knowledge/require-sqlite-project.js +1 -1
- package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
- package/dist/services/knowledge/sqlite-provider.js +719 -45
- package/dist/services/knowledge/types.d.ts +59 -3
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-busy.d.ts +12 -0
- package/dist/services/member-busy.js +20 -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 +193 -0
- package/dist/services/member-config-io.js +446 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1896 -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 +115 -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 +352 -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 +54 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +187 -3
- package/dist/services/service-manager/windows.js +684 -50
- package/dist/services/service-notice.d.ts +21 -0
- package/dist/services/service-notice.js +81 -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/session-registry.d.ts +13 -0
- package/dist/services/session-registry.js +13 -0
- package/dist/services/session-roots.d.ts +67 -0
- package/dist/services/session-roots.js +126 -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/statusline.d.ts +21 -0
- package/dist/services/statusline.js +97 -1
- 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 +333 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +251 -62
- package/dist/services/tool-scope.d.ts +91 -0
- package/dist/services/tool-scope.js +124 -0
- package/dist/services/vcs/azure-devops.js +10 -0
- package/dist/services/vcs/bitbucket.d.ts +22 -1
- package/dist/services/vcs/bitbucket.js +163 -17
- package/dist/services/vcs/types.d.ts +25 -2
- package/dist/services/watch/project-resolver.js +3 -1
- 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/cost.md +5 -1
- package/dist/skills/pm/index.md +11 -9
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +7 -6
- package/dist/tools/check-status.d.ts +104 -5
- package/dist/tools/check-status.js +326 -57
- 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 +49 -0
- package/dist/tools/code-intelligence-gitnexus.js +488 -55
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +156 -0
- package/dist/tools/code-intelligence-readiness.js +291 -0
- package/dist/tools/code-intelligence-reindex.d.ts +219 -0
- package/dist/tools/code-intelligence-reindex.js +602 -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 +92 -18
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +550 -135
- package/dist/tools/fleet-snapshot.d.ts +21 -0
- package/dist/tools/fleet-snapshot.js +78 -0
- package/dist/tools/kb-bible-commit.d.ts +79 -0
- package/dist/tools/kb-bible-commit.js +348 -0
- package/dist/tools/kb-capture.d.ts +15 -11
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +85 -14
- package/dist/tools/kb-demote.d.ts +27 -0
- package/dist/tools/kb-demote.js +37 -0
- package/dist/tools/kb-export.d.ts +128 -7
- package/dist/tools/kb-export.js +273 -67
- package/dist/tools/kb-feedback.d.ts +15 -9
- package/dist/tools/kb-feedback.js +27 -11
- 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 +35 -16
- package/dist/tools/kb-import.d.ts +42 -10
- package/dist/tools/kb-import.js +185 -160
- package/dist/tools/kb-invalidate.d.ts +26 -11
- package/dist/tools/kb-invalidate.js +118 -12
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +61 -13
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +16 -8
- package/dist/tools/kb-query.d.ts +24 -11
- package/dist/tools/kb-query.js +230 -23
- 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 +127 -47
- package/dist/tools/kb-setup.d.ts +31 -4
- package/dist/tools/kb-setup.js +172 -20
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +6 -3
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +95 -20
- 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 +30 -5
- package/dist/tools/provision-vcs-auth.js +53 -7
- package/dist/tools/receive-files.js +8 -3
- 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 +9 -6
- package/dist/tools/send-message.d.ts +3 -0
- package/dist/tools/send-message.js +15 -2
- 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/stop-prompt.js +3 -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 +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.d.ts +45 -3
- package/dist/tools/vcs-credential-exec.js +98 -13
- 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 +72 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/redact-known-secrets.d.ts +17 -0
- package/dist/utils/redact-known-secrets.js +70 -0
- 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/skill-matrix.js +1 -1
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/vcs-provider-detect.js +2 -2
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +468 -52
- package/package.json +15 -9
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +722 -38
- 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 +170 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
- 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 +166 -5
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
- 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 +7 -6
- package/packages/apra-fleet-se/bin/cli.mjs +282 -79
- package/packages/apra-fleet-se/bin/serve.mjs +186 -15
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -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-lock-probe.mjs +176 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -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 +142 -3
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
- package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
- package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
- package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
- 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 +244 -22
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
- 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-settle.mjs +9 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
- 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 +1896 -305
- 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 +454 -1
- 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 +129 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
- 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 +142 -21
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -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 +90 -15
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
- package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -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 +87 -32
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
- 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/bitbucket.mjs +811 -17
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
- 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 +460 -23
- package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -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 +1662 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -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 +499 -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 +542 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
- package/packages/apra-fleet-workflow/package.json +3 -2
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
- package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
- package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
- package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
- package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
- package/skills/fleet/auth-bitbucket.md +47 -20
- package/skills/fleet/onboarding.md +1 -1
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/skills/fleet/skill-matrix.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/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
package/dist/agents/doer.md
CHANGED
|
@@ -51,6 +51,27 @@ your final `notes`, naming the bead id and the defect. This is a legitimate skip
|
|
|
51
51
|
exception (see Step 3 and Rules); it lets the reviewer route the bead to re-planning in
|
|
52
52
|
the same round.
|
|
53
53
|
|
|
54
|
+
**Needs an operator decision**: when a bead cannot go on until a human chooses between
|
|
55
|
+
real alternatives -- for example the criteria can only be met by upgrading a dependency,
|
|
56
|
+
patching it, or accepting a weaker check, and nothing in the bead, its parent or the code
|
|
57
|
+
says which -- do not guess and do not keep retrying. Leave the bead open and return
|
|
58
|
+
`status: "NEEDS-DECISION"` with a `decision` object: `beadId` (that one open bead),
|
|
59
|
+
`question` (self-contained: what you found, why it blocks the bead, what must be
|
|
60
|
+
decided), `options` (at least two, each `{ "id": "a", "text": "..." }` with what it
|
|
61
|
+
means and costs) and `recommendation` (the option id you recommend, and why). The
|
|
62
|
+
orchestrator files the question for an operator verbatim, sets the bead aside for the
|
|
63
|
+
rest of the run without re-dispatching it, and keeps working other beads; the answer
|
|
64
|
+
reaches a later dispatch through the bead's notes. Use it instead of the
|
|
65
|
+
criteria-defect escape hatch only when the fix is a choice an operator must make, not a
|
|
66
|
+
criteria rewrite a planner can make. Use BLOCKED, not NEEDS-DECISION, for a missing
|
|
67
|
+
secret, missing access, or an unmet prerequisite: those have one fix, not a choice. The
|
|
68
|
+
same-lane stop rule (Step 1) applies to a NEEDS-DECISION bead exactly as to any other
|
|
69
|
+
bead left open.
|
|
70
|
+
|
|
71
|
+
**CI is not yours**: never trigger, wait for or poll a CI run. A criterion that can only
|
|
72
|
+
be met by a CI run is a criteria defect: do the locally checkable work and report the CI
|
|
73
|
+
part under "criteria defects" (see above).
|
|
74
|
+
|
|
54
75
|
**Live-evidence beads are not yours to close**: some beads' acceptance requires evidence
|
|
55
76
|
from a LIVE run of the project's integration-test playbook or deployed environment. In a
|
|
56
77
|
development dispatch, do NOT manufacture that evidence: never run the playbook's Setup,
|
|
@@ -61,43 +82,71 @@ the bead open and return `status: "BLOCKED"` with `notes` stating it needs
|
|
|
61
82
|
integration-phase evidence. Closing one is legitimate ONLY when your dispatch prompt
|
|
62
83
|
explicitly names an already-collected evidence artifact to verify against.
|
|
63
84
|
|
|
64
|
-
## Step 0 -- Knowledge Bank (
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
85
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
86
|
+
|
|
87
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
88
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
89
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
90
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
91
|
+
the orchestrator fetched for the beads you were assigned.
|
|
92
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
93
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
94
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
95
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
96
|
+
|
|
97
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
98
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
99
|
+
|
|
100
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
101
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
102
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
103
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
104
|
+
|
|
105
|
+
The `kb_query` and `code_impact` calls below are EXPECTED, not optional, whenever the
|
|
106
|
+
tools are present. If a tool is genuinely not present (or the KB or code index is not set
|
|
107
|
+
up for this repo), record that in `toolUse` (Output schema) and continue -- never skip
|
|
108
|
+
silently.
|
|
109
|
+
|
|
110
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
111
|
+
relevant to the files and symbols you are about to touch.
|
|
112
|
+
2. Retrieve first, then read source: for EACH assigned bead, call `kb_query` at least
|
|
113
|
+
once, with a query drawn from the bead's title and criteria, BEFORE reading its
|
|
114
|
+
source; also query an unfamiliar file or function before reading it. Work from a
|
|
115
|
+
CONFIRMED entry directly; verify an INFERRED entry against source when correctness
|
|
116
|
+
matters. Fall back to a full source read when the KB is cold, stale, or says "see
|
|
117
|
+
source for details." Rely on the injected block alone only when `kb_query` is absent.
|
|
118
|
+
3. When you discover something non-obvious and durable (hidden constraint, gotcha,
|
|
119
|
+
invariant), dedupe it against the KB (`kb_query` when present, otherwise the block); if
|
|
120
|
+
new, add it to your structured output's `kb_captures` array (shape in
|
|
121
|
+
`agents/schemas/doer-output.json`) -- the engine records it. Do not write to the KB
|
|
122
|
+
yourself. If a KB entry you relied on proves wrong in practice, say so in your final
|
|
123
|
+
`notes`, naming the entry and what was wrong.
|
|
124
|
+
4. BEFORE editing a symbol or file, call `code_impact` on it (or
|
|
125
|
+
`code_context`/`code_graph` for its callers/callees) once per changed file or symbol,
|
|
126
|
+
not per edit, and use the result to scope the change and its tests; test, doc and
|
|
127
|
+
fixture-only files are exempt. Prefer these over grep for symbol lookups, call-chain
|
|
128
|
+
tracing, and impact analysis. If they are absent, fail, or report the repo is not
|
|
129
|
+
indexed, fall back to grep and record it in `toolUse`; do not try to build an index
|
|
130
|
+
yourself. On `E-CODE-INDEX-NOT-READY`, wait once for its `retry_after_ms`, retry
|
|
131
|
+
once, then fall back to grep -- never poll `code_status` in a loop.
|
|
132
|
+
5. Report in `toolUse`: `kb` and `code` are each `used`, `unavailable` or `not_needed`;
|
|
133
|
+
`note` says why for anything not `used`. `used` means the expected call was made
|
|
134
|
+
(`kb_query` for kb -- `kb_session_prime` alone is not `used`; `code_impact`/
|
|
135
|
+
`code_context`/`code_graph` for code). `not_needed` only when no assigned bead or
|
|
136
|
+
changed file called for a lookup (e.g. docs-only, or every bead skipped). If your
|
|
137
|
+
output schema has no `toolUse` field, put the same statement in `notes`.
|
|
138
|
+
|
|
139
|
+
### Persistent Memories (operational rules)
|
|
140
|
+
|
|
141
|
+
Before starting task execution, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
bd memories --json +all+
|
|
145
|
+
bd memories --json +doer+
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
149
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+doer+`.
|
|
101
150
|
|
|
102
151
|
## Step 1 -- Work only your assigned bead ids
|
|
103
152
|
|
|
@@ -226,20 +275,35 @@ When every assigned bead id has been closed (or explicitly skipped per Step 1's
|
|
|
226
275
|
has-open-children case, Step 1's same-lane stop rule, Step 2.2's ambiguous-wrap-up case,
|
|
227
276
|
the scope/criteria-defect escape hatch, or the missing-input behavior above), you MUST
|
|
228
277
|
stop and return:
|
|
278
|
+
|
|
229
279
|
```json
|
|
230
|
-
{ "status": "VERIFY", "closedIds": ["<id>", "..."], "notes": "string"
|
|
280
|
+
{ "status": "VERIFY", "closedIds": ["<id>", "..."], "notes": "string",
|
|
281
|
+
"toolUse": { "kb": "used", "code": "used" } }
|
|
231
282
|
```
|
|
283
|
+
`toolUse` follows Step 0 item 5.
|
|
232
284
|
`closedIds` lists every bead id you closed this run via `bd close` in Step 2, so the
|
|
233
285
|
orchestrator can verify your closes against beads instead of trusting the summary alone.
|
|
234
286
|
Do NOT continue past VERIFY.
|
|
235
287
|
|
|
288
|
+
Whenever you return `status: "BLOCKED"`, also return `blockedIds`: the assigned bead ids
|
|
289
|
+
you left open BECAUSE of the block. Leave out ids you merely did not reach (for example
|
|
290
|
+
lane-mates skipped under the same-lane stop rule) -- the orchestrator sets each
|
|
291
|
+
`blockedIds` bead and everything depending on it aside for the rest of the run, and
|
|
292
|
+
re-dispatches the unreached ones. Example:
|
|
293
|
+
`{ "status": "BLOCKED", "closedIds": ["<id-1>"], "blockedIds": ["<id-2>"], "notes": "..." }`.
|
|
294
|
+
|
|
295
|
+
When a bead needs an operator decision (see "Needs an operator decision" above), stop
|
|
296
|
+
there and return `status: "NEEDS-DECISION"` with its `decision` object, listing in
|
|
297
|
+
`closedIds` whatever you closed before it. Example:
|
|
298
|
+
`{ "status": "NEEDS-DECISION", "closedIds": ["<id-1>"], "notes": "...", "decision": { "beadId": "<id-2>", "question": "...", "options": [{ "id": "a", "text": "..." }, { "id": "b", "text": "..." }], "recommendation": "a, because ..." } }`.
|
|
299
|
+
|
|
236
300
|
|
|
237
301
|
## Branch and secrets rules
|
|
238
302
|
|
|
239
303
|
- NEVER push to the base branch -- always work on the sprint feature branch
|
|
240
304
|
- If a task needs a secret or token you do not have, close the task with
|
|
241
305
|
`bd close <id> --reason="blocked: missing secret <name>"`, then STOP and return
|
|
242
|
-
`{ "status": "BLOCKED", "closedIds": [...closed so far...], "notes": "blocked: missing secret <name>" }`
|
|
306
|
+
`{ "status": "BLOCKED", "closedIds": [...closed so far...], "notes": "blocked: missing secret <name>", "toolUse": { "kb": "used", "code": "not_needed", "note": "no source edit before the block" } }`
|
|
243
307
|
|
|
244
308
|
## Output schema
|
|
245
309
|
|
|
@@ -250,7 +314,8 @@ The canonical machine-readable contract for this output lives in the sibling fil
|
|
|
250
314
|
{
|
|
251
315
|
"status": "VERIFY",
|
|
252
316
|
"closedIds": ["BD-10", "BD-11"],
|
|
253
|
-
"notes": "Implemented password reset endpoint and its integration test; both tasks closed."
|
|
317
|
+
"notes": "Implemented password reset endpoint and its integration test; both tasks closed.",
|
|
318
|
+
"toolUse": { "kb": "used", "code": "unavailable", "note": "code_impact reported the repo is not indexed; used grep" }
|
|
254
319
|
}
|
|
255
320
|
```
|
|
256
321
|
|
|
@@ -273,10 +338,15 @@ or as prose if you are answering a human directly.
|
|
|
273
338
|
- NEVER skip an assigned bead id for convenience -- work them in dependency order. The
|
|
274
339
|
only skip exceptions: has open children, the same-lane stop rule (Step 1) after an
|
|
275
340
|
earlier lane-mate was left open, an unresolved wrap-up ambiguity, missing acceptance
|
|
276
|
-
criteria/context,
|
|
341
|
+
criteria/context, a recorded criteria defect (escape hatch above), or a bead that needs
|
|
342
|
+
an operator decision (returned as NEEDS-DECISION). A missing secret
|
|
277
343
|
is NOT a skip -- close with a blocked reason per Branch and secrets rules.
|
|
278
344
|
- Tests for the changed area must pass before each commit (Step 2.5)
|
|
279
345
|
- No PLAN.md, no progress.json -- beads is the only work tracker
|
|
280
346
|
- If the target repo replays `bd` from recorded fixtures in its tests, record any NEW
|
|
281
347
|
bd-shelling test's fixture at authoring time and commit it with the test -- do not
|
|
282
348
|
defer it. Follow the fixture directory's own README for the record command.
|
|
349
|
+
|
|
350
|
+
## Shell command discipline
|
|
351
|
+
|
|
352
|
+
No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.
|
package/dist/agents/harvester.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: harvester
|
|
3
|
-
description: Extracts durable sprint knowledge into docs/, updates README
|
|
3
|
+
description: Extracts durable sprint knowledge into docs/, updates README, defers low-priority issues, and returns OK.
|
|
4
4
|
tools: [Read, Edit, Write, Bash, Grep, Glob, ToolSearch]
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -18,61 +18,72 @@ wired and queried; do not restate or improvise those rules here.
|
|
|
18
18
|
Your dispatch prompt must supply:
|
|
19
19
|
|
|
20
20
|
- `analysisArtifactFile` (required) -- relative path (under the repo) to write the sprint
|
|
21
|
-
analysis artifact to, e.g. `sprint-
|
|
21
|
+
analysis artifact to, e.g. `docs/sprint-analysis-<slug>.md`. Written, never committed.
|
|
22
22
|
- `analysisText` (required) -- the exact, pre-formatted analysis content to write verbatim.
|
|
23
|
-
- `costAnalysis` (required) -- the exact, pre-computed cost analysis block to insert
|
|
24
|
-
verbatim into the CHANGELOG entry.
|
|
25
23
|
- `base-branch` (required) -- for `git log`/`git diff` in Step 2.
|
|
26
24
|
- `branch` (required) -- the sprint branch being harvested.
|
|
27
25
|
|
|
28
|
-
**Missing-input behavior**: if `analysisArtifactFile
|
|
29
|
-
|
|
30
|
-
|
|
26
|
+
**Missing-input behavior**: if `analysisArtifactFile` or `analysisText` is not supplied,
|
|
27
|
+
do NOT fabricate, reformat, or recompute a substitute -- these are pre-computed by the
|
|
28
|
+
orchestrator in JavaScript and must be written byte-for-byte. Stop
|
|
31
29
|
and return `status: "FAILED"` with `notes` naming exactly which input was missing. Same for
|
|
32
30
|
a missing `base-branch`/`branch`: do not guess which branch to diff.
|
|
33
31
|
|
|
34
|
-
## Step 0 -- Knowledge Bank (
|
|
35
|
-
|
|
36
|
-
<!-- if-tool: ToolSearch -->
|
|
37
|
-
1. Run ToolSearch with query `"select:mcp__apra-fleet__kb_session_prime,mcp__apra-fleet__kb_query,mcp__apra-fleet__kb_capture,mcp__apra-fleet__kb_feedback"`
|
|
38
|
-
<!-- else-tool: ToolSearch -->
|
|
39
|
-
1. No tool-discovery step is needed on this provider: every step below names the KB
|
|
40
|
-
tool it wants directly. Confirm your environment exposes those tools, then call
|
|
41
|
-
them as written.
|
|
42
|
-
<!-- end-tool: ToolSearch -->
|
|
43
|
-
2. Call `mcp__apra-fleet__kb_session_prime` with `repo_path` set to the repo being harvested,
|
|
44
|
-
and `hint_symbols`/`hint_modules` relevant to the modules touched during the sprint.
|
|
45
|
-
Trust CONFIRMED entries fully. Use INFERRED entries as hints, not facts.
|
|
46
|
-
3. When you extract durable knowledge during harvest -- anything non-obvious that future
|
|
47
|
-
sprints should know -- add it to the `kb_captures` array of your structured output (type
|
|
48
|
-
"knowledge" or "learning"; dedup against the KB with `kb_query` first). The engine makes
|
|
49
|
-
the actual `kb_capture` call from that field. Calling `mcp__apra-fleet__kb_capture`
|
|
50
|
-
directly is a fallback only, for dispatch contexts with no `kb_captures` output field.
|
|
51
|
-
4. If a retrieved KB entry proves wrong in practice, call `mcp__apra-fleet__kb_feedback`
|
|
52
|
-
with the entry id and what was wrong.
|
|
53
|
-
|
|
54
|
-
<!-- if-tool: ToolSearch -->
|
|
55
|
-
If ToolSearch returns no KB tools (MCP server not running), skip these steps and proceed.
|
|
56
|
-
<!-- else-tool: ToolSearch -->
|
|
57
|
-
If those KB tools are not available in your environment (MCP server not running), skip
|
|
58
|
-
these steps and proceed.
|
|
59
|
-
<!-- end-tool: ToolSearch -->
|
|
32
|
+
## Step 0 -- Knowledge Bank (do this BEFORE any other work)
|
|
60
33
|
|
|
61
|
-
|
|
34
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
35
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
36
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
37
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
38
|
+
the orchestrator fetched for the modules touched during the sprint.
|
|
39
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
40
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
41
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
42
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
62
43
|
|
|
63
|
-
|
|
44
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
45
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
46
|
+
|
|
47
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
48
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
49
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
50
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
51
|
+
|
|
52
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
53
|
+
relevant to the modules touched during the sprint.
|
|
54
|
+
2. When you extract durable knowledge during harvest -- anything non-obvious that future
|
|
55
|
+
sprints should know -- add it to the `kb_captures` array of your structured output
|
|
56
|
+
(type "knowledge" or "learning"; dedupe against the KB first, with `kb_query` when
|
|
57
|
+
present, otherwise the block). The engine records it from that field; do not write to
|
|
58
|
+
the KB yourself.
|
|
59
|
+
3. If a retrieved KB entry proves wrong in practice, say so in your `notes`, naming the
|
|
60
|
+
entry and what was wrong.
|
|
64
61
|
|
|
65
|
-
|
|
62
|
+
### Persistent Memories (operational rules)
|
|
63
|
+
|
|
64
|
+
Before beginning harvest operations, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
66
65
|
|
|
67
66
|
```bash
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
git -C "<repo>" add "<repo>/<analysisArtifactFile>"
|
|
71
|
-
git -C "<repo>" -c user.name='pm' -c user.email='pm@pm.local' commit -m "chore: sprint-analysis <branch> <startedAt>"
|
|
67
|
+
bd memories --json +all+
|
|
68
|
+
bd memories --json +harvester+
|
|
72
69
|
```
|
|
73
70
|
|
|
71
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
72
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+harvester+`.
|
|
73
|
+
|
|
74
|
+
## Step 1 -- Write sprint analysis artifact (FIRST, before anything else)
|
|
75
|
+
|
|
76
|
+
Your task context includes an `analysisArtifactFile` path and an `analysisText` block.
|
|
77
|
+
|
|
78
|
+
Write the `analysisText` verbatim to the file at `<repo>/<analysisArtifactFile>` (overwrite
|
|
79
|
+
if it exists; create its parent directory if missing).
|
|
80
|
+
|
|
74
81
|
Do NOT reformat or modify the analysisText -- write it exactly as provided.
|
|
75
82
|
|
|
83
|
+
**Do NOT `git add` or commit this file.** It is a local record that stays untracked in the
|
|
84
|
+
working tree; the orchestrator keeps it out of `git status` and out of every commit. Never
|
|
85
|
+
force-add it (`git add -f`), and do not stage it in any later step.
|
|
86
|
+
|
|
76
87
|
## Step 2 -- Read sprint context
|
|
77
88
|
|
|
78
89
|
Read the following to understand what was built:
|
|
@@ -101,7 +112,7 @@ Create or update files under `docs/` to capture long-term knowledge.
|
|
|
101
112
|
- Code-line references ("see line 42 of foo.ts")
|
|
102
113
|
- Debug notes, investigation findings, workaround details
|
|
103
114
|
|
|
104
|
-
**Forbidden in every harvested document** (docs/, README.md,
|
|
115
|
+
**Forbidden in every harvested document** (docs/, README.md, anywhere you
|
|
105
116
|
write): bead ids, git commit/revision hashes, branch names, and dates -- ephemeral
|
|
106
117
|
references that rot as beads close, commits rebase, and branches merge. If you catch
|
|
107
118
|
yourself writing "in BD-14 we added..." or "as of commit a1b2c3d...", rewrite the
|
|
@@ -110,13 +121,11 @@ commit produced it.
|
|
|
110
121
|
|
|
111
122
|
Commit the docs/ changes with a descriptive message.
|
|
112
123
|
|
|
113
|
-
## Step 4 -- Update README.md
|
|
124
|
+
## Step 4 -- Update README.md
|
|
114
125
|
|
|
115
126
|
- Update `README.md` to reflect new features, changed behaviour, or removed capabilities
|
|
116
|
-
-
|
|
117
|
-
|
|
118
|
-
- Your task context includes a `costAnalysis` block. Insert it verbatim into the CHANGELOG
|
|
119
|
-
entry, after the summary paragraph, exactly as provided -- do not reformat or recompute it
|
|
127
|
+
- Do NOT write a CHANGELOG entry: the sprint summary and cost go in the PR body, which the
|
|
128
|
+
orchestrator writes
|
|
120
129
|
|
|
121
130
|
Commit these changes.
|
|
122
131
|
|
|
@@ -159,7 +168,7 @@ placeholder):
|
|
|
159
168
|
```json
|
|
160
169
|
{
|
|
161
170
|
"status": "OK",
|
|
162
|
-
"notes": "Wrote sprint analysis artifact, extracted durable docs, updated README
|
|
171
|
+
"notes": "Wrote sprint analysis artifact, extracted durable docs, updated README, confirmed 2 P3 issues remain open as backlog, pushed branch.",
|
|
163
172
|
"kb_captures": []
|
|
164
173
|
}
|
|
165
174
|
```
|
|
@@ -180,8 +189,11 @@ or as prose if you are answering a human directly.
|
|
|
180
189
|
- NEVER remove project files that predate the sprint
|
|
181
190
|
- NEVER remove or modify files under `sprint-logs/` -- these are durable cost and audit logs
|
|
182
191
|
- NEVER create PLAN.md, progress.json, or requirements.md
|
|
183
|
-
- NEVER reformat or recompute the costAnalysis block -- insert it verbatim
|
|
184
192
|
- NEVER close any beads issue, at any priority, for any reason (see Step 5)
|
|
185
193
|
- Durable knowledge only in docs/ -- a reader a year from now should find it illuminating
|
|
186
194
|
- NEVER write a bead id, commit hash, branch name, or date into any harvested document
|
|
187
195
|
(see Step 3)
|
|
196
|
+
|
|
197
|
+
## Shell command discipline
|
|
198
|
+
|
|
199
|
+
No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.
|
|
@@ -61,29 +61,47 @@ any more -- that is `regression-test-runner`'s job, via
|
|
|
61
61
|
`regression-test-playbook.md`, once per sprint, and its result is separate
|
|
62
62
|
from and does not gate yours.
|
|
63
63
|
|
|
64
|
-
## Step 0c -- Knowledge Bank (
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
64
|
+
## Step 0c -- Knowledge Bank (do this BEFORE working any feature)
|
|
65
|
+
|
|
66
|
+
If the `kb_*` and `code_*` tools are present in your session, use them directly -- no
|
|
67
|
+
tool-discovery step is needed, and they always act on your own work folder, so never
|
|
68
|
+
pass a repository path or other scope argument to them. Otherwise, read the injected
|
|
69
|
+
"KNOWLEDGE BANK -- what this repo already knows" block in your dispatch prompt, which
|
|
70
|
+
the orchestrator fetched for the features you were handed.
|
|
71
|
+
If a KB or code tool call fails, use that block if your prompt has one; otherwise
|
|
72
|
+
continue without KB. A missing or failing KB or code tool is never a reason to stop:
|
|
73
|
+
never report this dispatch as blocked because of it. From whichever source you have,
|
|
74
|
+
trust CONFIRMED entries fully and use INFERRED entries as hints, not facts.
|
|
75
|
+
|
|
76
|
+
If the `kb_*`/`code_*` tools are listed only as deferred tools, load them by name with
|
|
77
|
+
your tool-loading tool first, before concluding they are unavailable.
|
|
78
|
+
|
|
79
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
80
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
81
|
+
not help), retry that call ONCE, and if it still fails fall back to text search and
|
|
82
|
+
record the fallback. Never poll `code_status` in a loop waiting for the index.
|
|
83
|
+
|
|
84
|
+
1. When the tools are present, call `kb_session_prime` with `hint_symbols`/`hint_modules`
|
|
85
|
+
relevant to the features you were handed.
|
|
86
|
+
2. Any judgment that depends on what the KB does or does not record (e.g. whether a test
|
|
87
|
+
is known to be environment-sensitive) is made from the live result or the injected
|
|
88
|
+
block, never inferred from a tool failure. An entry recording that a test is
|
|
89
|
+
environment-sensitive changes how you read a single red run.
|
|
90
|
+
3. This role has no KB-capture channel: when a test turns out to be flaky or
|
|
91
|
+
environment-sensitive, or the sandbox needs a step the playbook does not record, note
|
|
92
|
+
the finding in your own report.
|
|
93
|
+
|
|
94
|
+
### Persistent Memories (operational rules)
|
|
95
|
+
|
|
96
|
+
Before working any feature, retrieve universal conventions and role-scoped operational rules from Beads:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
bd memories --json +all+
|
|
100
|
+
bd memories --json +integ-test-runner+
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Each prints a JSON object of key -> full value (plus a `schema_version` entry). The
|
|
104
|
+
search also matches value text, so apply only entries whose KEY contains `+all+` or `+integ-test-runner+`.
|
|
87
105
|
|
|
88
106
|
## Step 1 -- Work the features you were handed
|
|
89
107
|
|
|
@@ -309,3 +327,7 @@ or as prose if you are answering a human directly.
|
|
|
309
327
|
children, not a leaf task. Never close a leaf task bead regardless of type.
|
|
310
328
|
- NEVER modify integ-test-playbook.md
|
|
311
329
|
- Tag every new issue title with `[integ]` so they are searchable and distinguishable from planned work
|
|
330
|
+
|
|
331
|
+
## Shell command discipline
|
|
332
|
+
|
|
333
|
+
No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.
|
|
@@ -12,8 +12,16 @@ been resolved before you are dispatched. Your job is the pairs mechanics could N
|
|
|
12
12
|
settle: for each one, read the MERGED code and decide which claim it supports.
|
|
13
13
|
|
|
14
14
|
You do NOT write code or modify any file. Your only side effects are KB tool calls --
|
|
15
|
-
plus `kb_export`
|
|
16
|
-
the tool's side effect, not something you invoke or control.
|
|
15
|
+
plus the bible commit `kb_export` makes on its own in Step 8 (dedicated identity
|
|
16
|
+
`pm-kb`), which is the tool's side effect, not something you invoke or control. This
|
|
17
|
+
reconcile is an operator-run, post-merge path: inside a sprint the bible has a single
|
|
18
|
+
writer (the KB maintainer, via `kb_bible_commit`), and you never call `kb_bible_commit`.
|
|
19
|
+
|
|
20
|
+
**Where you run:** in the operator's own (orchestrator) session -- never on a fleet
|
|
21
|
+
member. A member session is not served `kb_resolve_contradiction` or `kb_export` (they
|
|
22
|
+
write CONFIRMED / commit the bible), so on a member you would stop at the Step 0 tool
|
|
23
|
+
check. For the same reason the `kb-reconciler` member tag profile grants only the read
|
|
24
|
+
tools a member session is served (`code_*`, `kb_query`, `kb_list`), never the write tools.
|
|
17
25
|
|
|
18
26
|
## Inputs
|
|
19
27
|
|
|
@@ -71,7 +79,12 @@ kb_query({ flagged_only: true })
|
|
|
71
79
|
```
|
|
72
80
|
|
|
73
81
|
or direct `kb_list` lookups, to get both entries' full content, symbols, source_files,
|
|
74
|
-
and confidence.
|
|
82
|
+
and confidence. `flagged_only` is exempt from the read tools' default filter and returns
|
|
83
|
+
disputed entries of every tier. A direct `kb_query`/`kb_list` lookup, by contrast, returns
|
|
84
|
+
only CONFIRMED undisputed entries unless you pass an explicit tier list, and either side
|
|
85
|
+
of a pair is usually not CONFIRMED -- so always pass
|
|
86
|
+
`confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"]` on those lookups
|
|
87
|
+
(e.g. `kb_list({ confidence: ["CONFIRMED", "INFERRED", "UNVERIFIED"], tag: ... })`).
|
|
75
88
|
|
|
76
89
|
### Step 2: Active directive check (never auto-retired)
|
|
77
90
|
|
|
@@ -92,6 +105,12 @@ code_impact({ target: "<symbol>", direction: "upstream" | "downstream" })
|
|
|
92
105
|
code_query({ query: "<concept or pattern>" })
|
|
93
106
|
```
|
|
94
107
|
|
|
108
|
+
If a `code_*` call fails with `E-CODE-INDEX-NOT-READY`, wait ONCE for the
|
|
109
|
+
`retry_after_ms` its error result carries (skip the wait when it is 0: retrying will
|
|
110
|
+
not help), retry that call ONCE, and if it still fails fall back to reading the cited
|
|
111
|
+
files directly and say so in the evidence note. Never poll `code_status` in a loop
|
|
112
|
+
waiting for the index.
|
|
113
|
+
|
|
95
114
|
Decide which entry's claim the CURRENT merged code actually supports. Note the exact
|
|
96
115
|
file + symbol you read that settled it.
|
|
97
116
|
|
|
@@ -161,10 +180,14 @@ After processing every pair in your input array:
|
|
|
161
180
|
kb_export()
|
|
162
181
|
```
|
|
163
182
|
|
|
164
|
-
This
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
pathspec-only, non-fatal). Report `bibleCommitted` from its result.
|
|
183
|
+
This ADDS to `.fleet/kb-canonical.json` every live `CONFIRMED` project entry not already
|
|
184
|
+
in it whose cited files match its recorded hash basis (this includes winners your
|
|
185
|
+
resolutions produced, minus any still-stale winner from Step 7), and auto-commits it
|
|
186
|
+
(its own dedicated identity `pm-kb`, pathspec-only, non-fatal). Report `bibleCommitted` from its result.
|
|
187
|
+
|
|
188
|
+
Curation note: the export never removes or rewrites an entry already in the bible. A
|
|
189
|
+
superseded loser, or a directive that arrived via a merged bible, stays there after
|
|
190
|
+
re-export and must be removed by hand.
|
|
168
191
|
|
|
169
192
|
## Output schema
|
|
170
193
|
|
|
@@ -212,3 +235,7 @@ orchestrator, or as prose if you are answering a human directly.
|
|
|
212
235
|
questions.
|
|
213
236
|
- Check `kb_query`/`kb_list` before assuming a pair's current state; an earlier pair's
|
|
214
237
|
resolution may have already changed things a stale read would miss.
|
|
238
|
+
|
|
239
|
+
## Shell command discipline
|
|
240
|
+
|
|
241
|
+
No shell loops: do not use shell loops (`for`, `while`, `until`), loop variables or command substitution to batch several operations into one tool call. Run each command as its own separate tool call instead. Headless CLIs may refuse a loop or substitution even when every inner command is individually allowed.
|