@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
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export declare const fleetSnapshotSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
|
|
3
|
+
export type SnapshotStatus = 'busy' | 'idle' | 'offline' | 'unknown';
|
|
4
|
+
export interface SnapshotMember {
|
|
5
|
+
id: string;
|
|
6
|
+
name: string;
|
|
7
|
+
icon: string;
|
|
8
|
+
category: string | null;
|
|
9
|
+
status: SnapshotStatus;
|
|
10
|
+
/** While busy: seconds since the member's task last showed activity (the
|
|
11
|
+
* stall detector's clock -- the same figure as statusline's busy(mm:ss)). */
|
|
12
|
+
quietForS?: number;
|
|
13
|
+
reservedBy?: string;
|
|
14
|
+
}
|
|
15
|
+
export interface FleetSnapshot {
|
|
16
|
+
version: string;
|
|
17
|
+
members: SnapshotMember[];
|
|
18
|
+
}
|
|
19
|
+
export declare function buildFleetSnapshot(now?: number): FleetSnapshot;
|
|
20
|
+
export declare function fleetSnapshot(): Promise<string>;
|
|
21
|
+
//# sourceMappingURL=fleet-snapshot.d.ts.map
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
import { FLEET_DIR } from '../paths.js';
|
|
5
|
+
import { getAllAgents } from '../services/registry.js';
|
|
6
|
+
import { DEFAULT_ICON } from '../services/icons.js';
|
|
7
|
+
import { getStallDetector } from '../services/stall/index.js';
|
|
8
|
+
import { isOrphanedBusy } from '../services/statusline.js';
|
|
9
|
+
import { serverVersion } from '../version.js';
|
|
10
|
+
// fleet_snapshot: the cheap, read-only fleet view the Claude Code fleet-status
|
|
11
|
+
// mod polls (plugins/claude-code/fleet-status). Built only from what is already on
|
|
12
|
+
// this host -- the registry, the last-known per-member states the statusline
|
|
13
|
+
// writer persists, and this process's stall detector. It never probes a
|
|
14
|
+
// member over SSH and never writes anything, so polling it every few seconds
|
|
15
|
+
// costs a file read. fleet_status stays the live (probing) view.
|
|
16
|
+
export const fleetSnapshotSchema = z.object({});
|
|
17
|
+
const STATE_PATH = path.join(FLEET_DIR, 'statusline-state.json');
|
|
18
|
+
function readStates() {
|
|
19
|
+
try {
|
|
20
|
+
return JSON.parse(fs.readFileSync(STATE_PATH, 'utf-8'));
|
|
21
|
+
}
|
|
22
|
+
catch {
|
|
23
|
+
return {};
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
/** "busy(02:14)" -> busy; anything unrecognised -> unknown. */
|
|
27
|
+
function normalizeStatus(raw) {
|
|
28
|
+
const base = (raw ?? 'idle').replace(/\(.*\)$/, '').trim().toLowerCase();
|
|
29
|
+
if (base === 'busy' || base === 'idle' || base === 'offline' || base === 'unknown')
|
|
30
|
+
return base;
|
|
31
|
+
return 'unknown';
|
|
32
|
+
}
|
|
33
|
+
/** "busy(02:14)" -> 134, "busy(1:02:05)" -> 3725; undefined when absent. */
|
|
34
|
+
function parseClock(raw) {
|
|
35
|
+
const m = /\((\d+(?::\d{1,2}){1,2})\)$/.exec(raw ?? '');
|
|
36
|
+
if (!m)
|
|
37
|
+
return undefined;
|
|
38
|
+
return m[1].split(':').reduce((acc, part) => acc * 60 + Number(part), 0);
|
|
39
|
+
}
|
|
40
|
+
export function buildFleetSnapshot(now = Date.now()) {
|
|
41
|
+
const states = readStates();
|
|
42
|
+
const stall = getStallDetector();
|
|
43
|
+
const members = getAllAgents().map((a) => {
|
|
44
|
+
let status = normalizeStatus(states[a.id]);
|
|
45
|
+
const entry = stall.getEntry(a.id);
|
|
46
|
+
if (entry?.stallReported)
|
|
47
|
+
status = 'unknown';
|
|
48
|
+
// A persisted busy whose writing server process is dead can never be
|
|
49
|
+
// cleared by that process -- report it as idle, not busy forever.
|
|
50
|
+
if (status === 'busy' && !entry && isOrphanedBusy(a.id))
|
|
51
|
+
status = 'idle';
|
|
52
|
+
const m = {
|
|
53
|
+
id: a.id,
|
|
54
|
+
name: a.friendlyName,
|
|
55
|
+
icon: a.icon ?? DEFAULT_ICON,
|
|
56
|
+
category: a.category?.trim() || null,
|
|
57
|
+
status,
|
|
58
|
+
};
|
|
59
|
+
if (status === 'busy' && entry && !entry.provisional) {
|
|
60
|
+
m.quietForS = Math.max(0, Math.round((now - entry.lastActivityAt) / 1000));
|
|
61
|
+
}
|
|
62
|
+
else if (status === 'busy') {
|
|
63
|
+
// No live entry in this process (the task runs under another server
|
|
64
|
+
// process): fall back to the persisted busy(mm:ss) label.
|
|
65
|
+
const q = parseClock(states[a.id]);
|
|
66
|
+
if (q !== undefined)
|
|
67
|
+
m.quietForS = q;
|
|
68
|
+
}
|
|
69
|
+
if (a.reservedBy)
|
|
70
|
+
m.reservedBy = a.reservedBy;
|
|
71
|
+
return m;
|
|
72
|
+
});
|
|
73
|
+
return { version: serverVersion, members };
|
|
74
|
+
}
|
|
75
|
+
export async function fleetSnapshot() {
|
|
76
|
+
return JSON.stringify(buildFleetSnapshot());
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=fleet-snapshot.js.map
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
3
|
+
export declare const kbBibleCommitSchema: z.ZodObject<{
|
|
4
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
5
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
6
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
7
|
+
ids: z.ZodArray<z.ZodString, "many">;
|
|
8
|
+
demoted_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
9
|
+
baseBranch: z.ZodString;
|
|
10
|
+
baseCommit: z.ZodString;
|
|
11
|
+
}, "strip", z.ZodTypeAny, {
|
|
12
|
+
ids: string[];
|
|
13
|
+
baseBranch: string;
|
|
14
|
+
baseCommit: string;
|
|
15
|
+
repo?: unknown;
|
|
16
|
+
repo_path?: unknown;
|
|
17
|
+
repo_remote_url?: unknown;
|
|
18
|
+
demoted_ids?: string[] | undefined;
|
|
19
|
+
}, {
|
|
20
|
+
ids: string[];
|
|
21
|
+
baseBranch: string;
|
|
22
|
+
baseCommit: string;
|
|
23
|
+
repo?: unknown;
|
|
24
|
+
repo_path?: unknown;
|
|
25
|
+
repo_remote_url?: unknown;
|
|
26
|
+
demoted_ids?: string[] | undefined;
|
|
27
|
+
}>;
|
|
28
|
+
export type KbBibleCommitInput = z.infer<typeof kbBibleCommitSchema>;
|
|
29
|
+
/**
|
|
30
|
+
* Why a requested id was not merged:
|
|
31
|
+
* - not_confirmed_or_unknown: not a live CONFIRMED entry in this KB;
|
|
32
|
+
* - no_source_files: CONFIRMED but cites no source file, so it has no basis
|
|
33
|
+
* that could ever be checked (retrying cannot change this);
|
|
34
|
+
* - basis_mismatch: CONFIRMED and cites files, but its recorded basis does not
|
|
35
|
+
* match those files at HEAD (can clear once the files or the basis agree);
|
|
36
|
+
* - not_demoted_or_unknown: named in demoted_ids, but the local entry is
|
|
37
|
+
* unknown, was never demoted, or is CONFIRMED again.
|
|
38
|
+
*/
|
|
39
|
+
export type KbBibleCommitSkipReason = 'not_confirmed_or_unknown' | 'no_source_files' | 'basis_mismatch' | 'not_demoted_or_unknown';
|
|
40
|
+
export interface KbBibleCommitSkip {
|
|
41
|
+
id: string;
|
|
42
|
+
reason: KbBibleCommitSkipReason;
|
|
43
|
+
}
|
|
44
|
+
/** Why a bible entry was removed: the maintainer KB holds it as retired. */
|
|
45
|
+
export type KbBibleCommitRemovalReason = 'superseded' | 'invalidated';
|
|
46
|
+
export interface KbBibleCommitRemoval {
|
|
47
|
+
id: string;
|
|
48
|
+
reason: KbBibleCommitRemovalReason;
|
|
49
|
+
}
|
|
50
|
+
export interface KbBibleCommitResult {
|
|
51
|
+
path: string;
|
|
52
|
+
merged: string[];
|
|
53
|
+
/** Ids admitted from demoted_ids: removed from entries, tombstoned. */
|
|
54
|
+
demoted: string[];
|
|
55
|
+
skipped: KbBibleCommitSkip[];
|
|
56
|
+
removed: KbBibleCommitRemoval[];
|
|
57
|
+
/** ENTRIES only -- a tombstone is not an entry. */
|
|
58
|
+
entry_count: number;
|
|
59
|
+
/** How many existing bible entries gained source_file_hashes (legacy backfill). */
|
|
60
|
+
backfilled: number;
|
|
61
|
+
committed: boolean;
|
|
62
|
+
/** True when the call was skipped because the project KB is not SQLite-backed (http). */
|
|
63
|
+
bible_skipped?: true;
|
|
64
|
+
/** Why the call was skipped; present only with bible_skipped. */
|
|
65
|
+
reason?: string;
|
|
66
|
+
}
|
|
67
|
+
/** Reason reported when kb_bible_commit is skipped under the http KB provider. */
|
|
68
|
+
export declare const KB_BIBLE_COMMIT_HTTP_SKIP_REASON = "bible commit is not supported over the http KB provider";
|
|
69
|
+
export declare function kbBibleCommit(input: KbBibleCommitInput, anchor?: KbAnchor): Promise<string>;
|
|
70
|
+
/**
|
|
71
|
+
* The bible commit message. The subject counts merged, removed and demoted
|
|
72
|
+
* entries; when entries were removed, the body lists each one as
|
|
73
|
+
* '- <id> (<reason>)'. With no removals and no backfill the message is the
|
|
74
|
+
* single pre-existing subject line. A legacy backfill (existing entries that
|
|
75
|
+
* gained source_file_hashes) adds a body line 'Backfilled source_file_hashes on
|
|
76
|
+
* <n> existing entries.'; a backfill-only commit names the count in its own subject.
|
|
77
|
+
*/
|
|
78
|
+
export declare function bibleCommitMessage(mergedCount: number, removed: KbBibleCommitRemoval[], total: number, backfilled?: number, demotedCount?: number): string;
|
|
79
|
+
//# sourceMappingURL=kb-bible-commit.d.ts.map
|
|
@@ -0,0 +1,348 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
|
|
3
|
+
import fs from 'node:fs';
|
|
4
|
+
import path from 'node:path';
|
|
5
|
+
import { getKbProviders } from '../services/knowledge/kb-providers.js';
|
|
6
|
+
import { resolveKbAnchor } from '../services/knowledge/kb-self.js';
|
|
7
|
+
import { filterProjectBibleCandidates, hasCarriedBasis, selectLegacyBibleBackfill } from '../services/knowledge/bible-basis-filter.js';
|
|
8
|
+
import { logWarn } from '../utils/log-helpers.js';
|
|
9
|
+
import { isSqliteProject } from '../services/knowledge/require-sqlite-project.js';
|
|
10
|
+
import { TOMBSTONE_DEMOTED, standingAgainstTombstone } from '../services/knowledge/bible-import.js';
|
|
11
|
+
import { bibleBytesBlobId } from '../services/knowledge/bible-blob-id.js';
|
|
12
|
+
import { memberLacksKbMaintainer } from '../services/knowledge/kb-maintainer-grant.js';
|
|
13
|
+
import { asciiSafeStringify, assertNoDuplicateBibleIds, BIBLE_FORMAT_VERSION, bibleContentChanged, commitBiblePath, compareById, isGitRepo, readBibleDocument, requireLocalFolder, toCanonicalEntry, withSourceFileHashes, } from './kb-export.js';
|
|
14
|
+
// kb_bible_commit: the kb_maintainer commits one review round's confirmations
|
|
15
|
+
// to the bible, merging at ENTRY level: the given ids are added or replaced,
|
|
16
|
+
// and every entry already in <self>/.fleet/kb-canonical.json is kept UNLESS
|
|
17
|
+
// this (the maintainer's) KB holds it as superseded or invalidated -- those
|
|
18
|
+
// are removed, and each removal (id + reason) is listed in the response and in
|
|
19
|
+
// the commit message. Removal runs at every call, also with no ids. An entry
|
|
20
|
+
// in the file but absent from the DB is never dropped, nor is one the DB holds
|
|
21
|
+
// as CONFIRMED and current. That keeps a retry after a rejected push safe: the
|
|
22
|
+
// engine resets to the new remote HEAD (which may carry another clone's
|
|
23
|
+
// entries, unknown to this DB) and calls this again with the same ids -- the
|
|
24
|
+
// result holds both sets with no manual merge.
|
|
25
|
+
//
|
|
26
|
+
// A merely STALE entry (freshness sweep: its cited files moved) is NOT removed:
|
|
27
|
+
// the owner decision names only superseded and invalidated, and staleness can
|
|
28
|
+
// clear on its own (see SqliteProvider.getRetirementReasons).
|
|
29
|
+
//
|
|
30
|
+
// kb_export is untouched by this: it stays additive-only.
|
|
31
|
+
//
|
|
32
|
+
// Legacy backfill: an entry already in the bible with no source_file_hashes
|
|
33
|
+
// (carried over from a v1/v2 bible) gains the STORED basis this KB holds for
|
|
34
|
+
// the same id, when that basis passes the bible admission predicate at HEAD and
|
|
35
|
+
// the KB entry cites exactly the bible entry's source_files
|
|
36
|
+
// (selectLegacyBibleBackfill). Only source_file_hashes is added; id, text,
|
|
37
|
+
// confidence and every other field stay as they are, and an entry that does not
|
|
38
|
+
// qualify is kept unchanged (never dropped). A backfill is a change: the bible
|
|
39
|
+
// is rewritten at the current format version and committed, and the response
|
|
40
|
+
// and the commit message report the number of backfilled entries.
|
|
41
|
+
//
|
|
42
|
+
// Provenance records the sprint's TARGET BASE branch and the base commit the
|
|
43
|
+
// entries were verified against, as given by the caller -- never the HEAD of
|
|
44
|
+
// the working folder, which is typically a feature branch.
|
|
45
|
+
//
|
|
46
|
+
// The commit is local, pathspec-scoped to the bible file, with the pm-kb
|
|
47
|
+
// identity (shared with kb_export). It is NEVER pushed.
|
|
48
|
+
//
|
|
49
|
+
// Trust anchor: when called from a FULL or kb_maintainer session, the blob id
|
|
50
|
+
// of every bible this writes is recorded in the per-repo KB DB, which is what
|
|
51
|
+
// lets a member session without the grant import that bible (kb-import.ts).
|
|
52
|
+
export const kbBibleCommitSchema = z.object({
|
|
53
|
+
ids: z.array(z.string().min(1))
|
|
54
|
+
.describe('Ids of the entries confirmed this round. Each must be a live (non-stale, non-superseded) CONFIRMED entry in this repository\'s KB whose recorded file basis still matches the cited files at the repo\'s HEAD commit (the same rule kb_export applies; uncommitted edits are ignored); any other id is skipped and reported in skipped (reason not_confirmed_or_unknown, no_source_files for a CONFIRMED entry citing no source file, or basis_mismatch). Independently of the ids, every bible entry this KB holds as superseded or invalidated is removed and reported in removed; an empty list with no such entry makes no commit.'),
|
|
55
|
+
demoted_ids: z.array(z.string().min(1)).optional()
|
|
56
|
+
.describe('Ids demoted this round (kb_demote). Each must name a local entry that HAS a demoted_at and is now below CONFIRMED; any other id is skipped and reported in skipped with reason not_demoted_or_unknown. An admitted id is REMOVED from entries and recorded as an explicit tombstone {id, at, reason: "demoted"} in the bible demotions array, so other clones can apply the demotion instead of inferring it from an absence. Independently, every call does the same for each bible entry this KB holds as demoted, unless that bible entry was promoted after the local demotion (another clone re-promoted it). Re-admitting the same id through ids (a re-promotion) clears its tombstone.'),
|
|
57
|
+
baseBranch: z.string().min(1)
|
|
58
|
+
.describe('The sprint\'s target base branch (the branch the work merges into). Written to provenance.branch.'),
|
|
59
|
+
baseCommit: z.string().min(1)
|
|
60
|
+
.describe('The base commit the entries were verified against. Written to provenance.commit.'),
|
|
61
|
+
// Removed pre-redesign scope keys: declared only so a caller still passing one
|
|
62
|
+
// is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
|
|
63
|
+
...KB_REMOVED_SCOPE_KEYS_SHAPE,
|
|
64
|
+
});
|
|
65
|
+
/** Reason reported when kb_bible_commit is skipped under the http KB provider. */
|
|
66
|
+
export const KB_BIBLE_COMMIT_HTTP_SKIP_REASON = 'bible commit is not supported over the http KB provider';
|
|
67
|
+
export async function kbBibleCommit(input, anchor) {
|
|
68
|
+
const resolved = resolveKbAnchor(anchor);
|
|
69
|
+
const repoPath = requireLocalFolder(resolved.folder, 'kb_bible_commit');
|
|
70
|
+
const outPath = path.join(repoPath, '.fleet', 'kb-canonical.json');
|
|
71
|
+
const requested = Array.from(new Set(input.ids));
|
|
72
|
+
// An id named in BOTH lists is a caller bug, and admitting it twice would make
|
|
73
|
+
// the outcome depend on merge order. ids (a confirmation) wins: a re-promoted
|
|
74
|
+
// entry belongs in the bible, and the demotion half is reported as skipped by
|
|
75
|
+
// the normal not_demoted_or_unknown rule below (it is CONFIRMED, not demoted).
|
|
76
|
+
const requestedDemotions = Array.from(new Set(input.demoted_ids ?? []));
|
|
77
|
+
const done = (r) => JSON.stringify({ path: outPath, ...r });
|
|
78
|
+
// No ids, no demotions and no bible entry that could be removed: nothing to
|
|
79
|
+
// do, and the KB is not opened.
|
|
80
|
+
const existingDoc = readBibleDocument(outPath);
|
|
81
|
+
const existingAtStart = existingDoc?.entries ?? null;
|
|
82
|
+
if (requested.length === 0 && requestedDemotions.length === 0
|
|
83
|
+
&& (existingAtStart === null || existingAtStart.length === 0)) {
|
|
84
|
+
return done({
|
|
85
|
+
merged: [], demoted: [], skipped: [], removed: [],
|
|
86
|
+
entry_count: existingAtStart?.length ?? 0, backfilled: 0, committed: false,
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
const providers = await getKbProviders(repoPath, resolved.remoteUrl);
|
|
90
|
+
const project = providers.project;
|
|
91
|
+
if (!isSqliteProject(project)) {
|
|
92
|
+
// The bible is built from the local SQLite store; over http there is
|
|
93
|
+
// nothing to merge. Skip before any KB read, write, or git commit. The
|
|
94
|
+
// bible file was only read leniently above (readBibleEntries never
|
|
95
|
+
// throws): entry_count reports its size when parseable, and an unparseable
|
|
96
|
+
// file is logged, never thrown over -- the skip is provider-wide.
|
|
97
|
+
if (existingAtStart === null && fs.existsSync(outPath)) {
|
|
98
|
+
logWarn('kb_bible_commit', 'bible file is not readable, reporting entry_count 0 under the http KB provider: ' + outPath);
|
|
99
|
+
}
|
|
100
|
+
return done({
|
|
101
|
+
merged: [], demoted: [], skipped: [], removed: [], entry_count: existingAtStart?.length ?? 0, backfilled: 0, committed: false,
|
|
102
|
+
bible_skipped: true, reason: KB_BIBLE_COMMIT_HTTP_SKIP_REASON,
|
|
103
|
+
});
|
|
104
|
+
}
|
|
105
|
+
const confirmedEntries = await project.list({ confidence: ['CONFIRMED'] });
|
|
106
|
+
const requestedSet = new Set(requested);
|
|
107
|
+
// ONE admission rule with kb_export (scope=project): a CONFIRMED id is
|
|
108
|
+
// admitted only if it passes the shared bible basis predicate. (With no
|
|
109
|
+
// requested ids this is empty and admission, including its git check, is
|
|
110
|
+
// not run.)
|
|
111
|
+
const requestedConfirmed = confirmedEntries.filter(e => requestedSet.has(e.id));
|
|
112
|
+
const bases = project.getSourceFileBases(requestedConfirmed.map(e => e.id));
|
|
113
|
+
const qualifying = await filterProjectBibleCandidates(requestedConfirmed, bases, repoPath);
|
|
114
|
+
const qualifyingIds = new Set(qualifying.map(e => e.id));
|
|
115
|
+
const confirmedIds = new Set(requestedConfirmed.map(e => e.id));
|
|
116
|
+
const noSourceIds = new Set(requestedConfirmed
|
|
117
|
+
.filter(e => !Array.isArray(e.source_files) || e.source_files.length === 0)
|
|
118
|
+
.map(e => e.id));
|
|
119
|
+
const confirmed = new Map();
|
|
120
|
+
// Format v3: each merged entry carries the exact stored basis it was just
|
|
121
|
+
// admitted against (never re-hashed here).
|
|
122
|
+
const trustTimes = project.getBibleTrustTimes(qualifying.map(e => e.id));
|
|
123
|
+
for (const e of qualifying)
|
|
124
|
+
confirmed.set(e.id, toCanonicalEntry(e, bases.get(e.id), trustTimes.get(e.id)));
|
|
125
|
+
const merged = [];
|
|
126
|
+
const skipped = [];
|
|
127
|
+
for (const id of requested) {
|
|
128
|
+
if (qualifyingIds.has(id))
|
|
129
|
+
merged.push(id);
|
|
130
|
+
else if (noSourceIds.has(id)) {
|
|
131
|
+
// An id already in the bible keeps its existing entry: the merge never drops entries.
|
|
132
|
+
logWarn('kb_bible_commit', 'skipping ' + id + ': no_source_files (a CONFIRMED entry citing no source file has no checkable basis)');
|
|
133
|
+
skipped.push({ id, reason: 'no_source_files' });
|
|
134
|
+
}
|
|
135
|
+
else if (confirmedIds.has(id)) {
|
|
136
|
+
// An id already in the bible keeps its existing entry: the merge never drops entries.
|
|
137
|
+
logWarn('kb_bible_commit', 'skipping ' + id + ': basis_mismatch (cited files at HEAD changed or absent, or basis absent)');
|
|
138
|
+
skipped.push({ id, reason: 'basis_mismatch' });
|
|
139
|
+
}
|
|
140
|
+
else
|
|
141
|
+
skipped.push({ id, reason: 'not_confirmed_or_unknown' });
|
|
142
|
+
}
|
|
143
|
+
// DEMOTION ADMISSION. A tombstone asserts "this clone withdrew trust", so the
|
|
144
|
+
// local row must actually say so: it exists, it carries a demoted_at, and its
|
|
145
|
+
// confidence is now below CONFIRMED. The state is read straight from the row
|
|
146
|
+
// (not through list()) so a demoted entry that has since gone stale can still
|
|
147
|
+
// be tombstoned: other clones' bibles still carry it.
|
|
148
|
+
//
|
|
149
|
+
// Two sources, one rule. A demoted_ids id that does not qualify -- unknown,
|
|
150
|
+
// never demoted, or demoted and since re-promoted -- is skipped with a reason.
|
|
151
|
+
// And on EVERY call, each entry already in the bible that this KB holds as
|
|
152
|
+
// demoted is tombstoned too, named or not: that is what restores a demotion
|
|
153
|
+
// after an older writer (0.4.4) rewrote the bible without its tombstones.
|
|
154
|
+
// Except when the bible entry was promoted AFTER this clone's demotion (same
|
|
155
|
+
// standingAgainstTombstone rule; a bible time later than now never counts):
|
|
156
|
+
// another clone re-promoted it, and tombstoning it again would undo that
|
|
157
|
+
// re-promotion.
|
|
158
|
+
const bibleEntries = existingDoc?.entries ?? [];
|
|
159
|
+
const bibleIds = bibleEntries.map(e => e.id);
|
|
160
|
+
const demotionState = project.getDemotionState([...requestedDemotions, ...bibleIds]);
|
|
161
|
+
const tombstoneFor = (id) => {
|
|
162
|
+
const state = demotionState.get(id);
|
|
163
|
+
if (!state || !state.demoted_at || state.confidence === 'CONFIRMED' || qualifyingIds.has(id))
|
|
164
|
+
return null;
|
|
165
|
+
return { id, at: state.demoted_at, reason: TOMBSTONE_DEMOTED };
|
|
166
|
+
};
|
|
167
|
+
const admittedDemotions = [];
|
|
168
|
+
for (const id of requestedDemotions) {
|
|
169
|
+
const tombstone = tombstoneFor(id);
|
|
170
|
+
if (tombstone)
|
|
171
|
+
admittedDemotions.push(tombstone);
|
|
172
|
+
else
|
|
173
|
+
skipped.push({ id, reason: 'not_demoted_or_unknown' });
|
|
174
|
+
}
|
|
175
|
+
const requestedDemotionSet = new Set(requestedDemotions);
|
|
176
|
+
for (const entry of bibleEntries) {
|
|
177
|
+
if (requestedDemotionSet.has(entry.id))
|
|
178
|
+
continue;
|
|
179
|
+
const tombstone = tombstoneFor(entry.id);
|
|
180
|
+
if (tombstone && !repromotedAfter(entry, tombstone))
|
|
181
|
+
admittedDemotions.push(tombstone);
|
|
182
|
+
}
|
|
183
|
+
const demoted = admittedDemotions.map(d => d.id);
|
|
184
|
+
// A bible file that exists but cannot be parsed must not be overwritten: its
|
|
185
|
+
// entries are unknown, and writing over it would drop all of them.
|
|
186
|
+
if (existingDoc === null && fs.existsSync(outPath)) {
|
|
187
|
+
throw new Error('kb_bible_commit: existing bible is not a readable bible file, refusing to overwrite it: ' + outPath);
|
|
188
|
+
}
|
|
189
|
+
const existing = existingDoc?.entries ?? null;
|
|
190
|
+
// Removals: a bible entry this KB holds as superseded or invalidated. An id
|
|
191
|
+
// unknown to this KB, or known and not retired, is kept. A merged id is never
|
|
192
|
+
// retired (merging requires a live CONFIRMED entry), so the two never clash.
|
|
193
|
+
const retired = project.getRetirementReasons((existing ?? []).map(e => e.id));
|
|
194
|
+
const removed = (existing ?? [])
|
|
195
|
+
.filter(e => retired.has(e.id))
|
|
196
|
+
.map(e => ({ id: e.id, reason: retired.get(e.id) }))
|
|
197
|
+
.sort(compareById);
|
|
198
|
+
// Legacy backfill: existing entries with no carried basis, not merged (a
|
|
199
|
+
// merged id gets its fresh entry and basis anyway) and not removed. The
|
|
200
|
+
// predicate needs a git work tree; a folder that is not one has nothing
|
|
201
|
+
// backfilled (no disk fallback) rather than failing a removal-only call.
|
|
202
|
+
const mergedSet = new Set(merged);
|
|
203
|
+
const removedSet = new Set(removed.map(r => r.id));
|
|
204
|
+
const legacy = (existing ?? []).filter(e => !hasCarriedBasis(e) && !mergedSet.has(e.id) && !removedSet.has(e.id));
|
|
205
|
+
let backfill = new Map();
|
|
206
|
+
if (legacy.length > 0 && isGitRepo(repoPath)) {
|
|
207
|
+
const legacyIds = new Set(legacy.map(e => e.id));
|
|
208
|
+
const kbLegacy = confirmedEntries.filter(e => legacyIds.has(e.id));
|
|
209
|
+
if (kbLegacy.length > 0) {
|
|
210
|
+
backfill = await selectLegacyBibleBackfill(legacy, kbLegacy, project.getSourceFileBases(kbLegacy.map(e => e.id)), repoPath);
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
const backfilled = backfill.size;
|
|
214
|
+
if (merged.length === 0 && removed.length === 0 && admittedDemotions.length === 0 && backfilled === 0) {
|
|
215
|
+
return done({ merged, demoted, skipped, removed, entry_count: existing?.length ?? 0, backfilled, committed: false });
|
|
216
|
+
}
|
|
217
|
+
// Duplicate-id guard: an existing file holding one id twice would otherwise
|
|
218
|
+
// be silently collapsed by the id map below (dropping an entry). Refuse
|
|
219
|
+
// before anything is written.
|
|
220
|
+
assertNoDuplicateBibleIds(existing ?? [], 'kb_bible_commit');
|
|
221
|
+
const byId = new Map();
|
|
222
|
+
for (const e of existing ?? []) {
|
|
223
|
+
const basis = backfill.get(e.id);
|
|
224
|
+
byId.set(e.id, basis ? withSourceFileHashes(e, basis) : e);
|
|
225
|
+
}
|
|
226
|
+
for (const r of removed)
|
|
227
|
+
byId.delete(r.id);
|
|
228
|
+
for (const id of merged)
|
|
229
|
+
byId.set(id, confirmed.get(id));
|
|
230
|
+
// An admitted demotion REMOVES the entry.
|
|
231
|
+
for (const id of demoted)
|
|
232
|
+
byId.delete(id);
|
|
233
|
+
const entries = Array.from(byId.values()).sort(compareById);
|
|
234
|
+
assertNoDuplicateBibleIds(entries, 'kb_bible_commit');
|
|
235
|
+
// TOMBSTONE MERGE. Tombstones already in the file are PRESERVED (a later
|
|
236
|
+
// commit carrying unrelated ids must not silently resurrect their entries on
|
|
237
|
+
// other clones), the admitted ones are upserted, and an id re-admitted as a
|
|
238
|
+
// CONFIRMED entry has its tombstone CLEARED -- it was re-promoted, so the
|
|
239
|
+
// demotion no longer holds.
|
|
240
|
+
const tombstones = new Map();
|
|
241
|
+
for (const d of existingDoc?.demotions ?? [])
|
|
242
|
+
tombstones.set(d.id, d);
|
|
243
|
+
for (const d of admittedDemotions)
|
|
244
|
+
tombstones.set(d.id, d);
|
|
245
|
+
for (const id of merged)
|
|
246
|
+
tombstones.delete(id);
|
|
247
|
+
const demotions = Array.from(tombstones.values()).sort(compareById);
|
|
248
|
+
// Unchanged content is a no-op: no rewrite, no commit (provenance alone never
|
|
249
|
+
// counts as a change, matching kb_export). Both halves count as content.
|
|
250
|
+
const demotionsUnchanged = asciiSafeStringify(existingDoc?.demotions ?? [])
|
|
251
|
+
=== asciiSafeStringify(demotions);
|
|
252
|
+
if (existing !== null && demotionsUnchanged
|
|
253
|
+
&& asciiSafeStringify(existing) === asciiSafeStringify(entries)) {
|
|
254
|
+
return done({ merged, demoted, skipped, removed, entry_count: entries.length, backfilled, committed: false });
|
|
255
|
+
}
|
|
256
|
+
const bible = {
|
|
257
|
+
version: BIBLE_FORMAT_VERSION,
|
|
258
|
+
provenance: {
|
|
259
|
+
commit: input.baseCommit,
|
|
260
|
+
branch: input.baseBranch,
|
|
261
|
+
// Entries only -- a tombstone is not an entry.
|
|
262
|
+
entry_count: entries.length,
|
|
263
|
+
},
|
|
264
|
+
entries,
|
|
265
|
+
// Omitted entirely when there are none, so a bible that never saw a
|
|
266
|
+
// demotion stays byte-identical to one written before the field existed.
|
|
267
|
+
...(demotions.length > 0 ? { demotions } : {}),
|
|
268
|
+
};
|
|
269
|
+
fs.mkdirSync(path.dirname(outPath), { recursive: true });
|
|
270
|
+
const written = Buffer.from(asciiSafeStringify(bible) + '\n', 'utf-8');
|
|
271
|
+
fs.writeFileSync(outPath, written);
|
|
272
|
+
let committed = false;
|
|
273
|
+
if (isGitRepo(repoPath) && bibleContentChanged(repoPath, outPath)) {
|
|
274
|
+
const message = bibleCommitMessage(merged.length, removed, entries.length, backfilled, demoted.length);
|
|
275
|
+
try {
|
|
276
|
+
commitBiblePath(repoPath, outPath, message);
|
|
277
|
+
}
|
|
278
|
+
catch (err) {
|
|
279
|
+
const reason = err instanceof Error ? err.message : String(err);
|
|
280
|
+
throw new Error('kb_bible_commit: bible written but the local commit failed: ' + reason);
|
|
281
|
+
}
|
|
282
|
+
committed = true;
|
|
283
|
+
}
|
|
284
|
+
// kb_import trust anchor: record the blob id of the bible just written, so
|
|
285
|
+
// a member session without the kb_maintainer grant may import it once it is
|
|
286
|
+
// committed in (or pulled into) any checkout of this repository. Only the
|
|
287
|
+
// maintainer side records: kb_bible_commit is served to every member
|
|
288
|
+
// session, and a session without the grant merges over whatever its own
|
|
289
|
+
// work-tree bible holds (possibly hand-edited), so its output must not
|
|
290
|
+
// become trusted. A FULL session and the kb_maintainer session record.
|
|
291
|
+
if (!memberLacksKbMaintainer(anchor)) {
|
|
292
|
+
// The id of the exact bytes written (LF, unfiltered), hashed in-process:
|
|
293
|
+
// never `git hash-object` on the path, which would re-read the file and
|
|
294
|
+
// run the checkout's member-configured clean filters.
|
|
295
|
+
project.recordTrustedBibleBlob(await bibleBytesBlobId(repoPath, written), 'kb_bible_commit');
|
|
296
|
+
}
|
|
297
|
+
return done({ merged, demoted, skipped, removed, entry_count: entries.length, backfilled, committed });
|
|
298
|
+
}
|
|
299
|
+
/**
|
|
300
|
+
* True when the bible entry's own updated_at postdates the local demotion. An
|
|
301
|
+
* updated_at later than now is NOT a re-promotion: clamping it to now would
|
|
302
|
+
* still put it after every past demoted_at, so a future-dated entry would block
|
|
303
|
+
* the tombstone forever.
|
|
304
|
+
*/
|
|
305
|
+
function repromotedAfter(entry, tombstone, now = new Date()) {
|
|
306
|
+
if (typeof entry.updated_at !== 'string' || entry.updated_at.length === 0)
|
|
307
|
+
return false;
|
|
308
|
+
const updatedAt = Date.parse(entry.updated_at);
|
|
309
|
+
if (Number.isNaN(updatedAt) || updatedAt > now.getTime())
|
|
310
|
+
return false;
|
|
311
|
+
return standingAgainstTombstone(entry.updated_at, tombstone.at) === 'repromoted';
|
|
312
|
+
}
|
|
313
|
+
/**
|
|
314
|
+
* The bible commit message. The subject counts merged, removed and demoted
|
|
315
|
+
* entries; when entries were removed, the body lists each one as
|
|
316
|
+
* '- <id> (<reason>)'. With no removals and no backfill the message is the
|
|
317
|
+
* single pre-existing subject line. A legacy backfill (existing entries that
|
|
318
|
+
* gained source_file_hashes) adds a body line 'Backfilled source_file_hashes on
|
|
319
|
+
* <n> existing entries.'; a backfill-only commit names the count in its own subject.
|
|
320
|
+
*/
|
|
321
|
+
export function bibleCommitMessage(mergedCount, removed, total, backfilled = 0, demotedCount = 0) {
|
|
322
|
+
let head;
|
|
323
|
+
if (mergedCount === 0 && removed.length === 0 && backfilled > 0) {
|
|
324
|
+
head = 'chore(kb): backfill source_file_hashes on ' + backfilled + ' knowledge bible entries';
|
|
325
|
+
}
|
|
326
|
+
else if (removed.length === 0) {
|
|
327
|
+
head = 'chore(kb): commit ' + mergedCount + ' confirmed entries to the knowledge bible';
|
|
328
|
+
}
|
|
329
|
+
else if (mergedCount === 0) {
|
|
330
|
+
head = 'chore(kb): remove ' + removed.length + ' superseded/invalidated entries from the knowledge bible';
|
|
331
|
+
}
|
|
332
|
+
else {
|
|
333
|
+
head = 'chore(kb): commit ' + mergedCount + ' confirmed entries to the knowledge bible, remove '
|
|
334
|
+
+ removed.length + ' superseded/invalidated';
|
|
335
|
+
}
|
|
336
|
+
const demotedClause = demotedCount > 0 ? ', ' + demotedCount + ' demoted' : '';
|
|
337
|
+
const subject = head + demotedClause + ' -- ' + total + ' total';
|
|
338
|
+
const body = [];
|
|
339
|
+
if (removed.length > 0)
|
|
340
|
+
body.push('Removed:\n' + removed.map(r => '- ' + r.id + ' (' + r.reason + ')').join('\n'));
|
|
341
|
+
// A backfill-only subject already names the count.
|
|
342
|
+
if (backfilled > 0 && (mergedCount > 0 || removed.length > 0))
|
|
343
|
+
body.push('Backfilled source_file_hashes on ' + backfilled + ' existing entries.');
|
|
344
|
+
if (body.length === 0)
|
|
345
|
+
return subject;
|
|
346
|
+
return subject + '\n\n' + body.join('\n\n');
|
|
347
|
+
}
|
|
348
|
+
//# sourceMappingURL=kb-bible-commit.js.map
|
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { type KbAnchor } from '../services/knowledge/kb-self.js';
|
|
2
3
|
export declare const kbCaptureSchema: z.ZodObject<{
|
|
3
|
-
repo_path: z.ZodOptional<z.
|
|
4
|
+
repo_path: z.ZodOptional<z.ZodUnknown>;
|
|
5
|
+
repo: z.ZodOptional<z.ZodUnknown>;
|
|
6
|
+
repo_remote_url: z.ZodOptional<z.ZodUnknown>;
|
|
4
7
|
type: z.ZodEnum<["context-cache", "learning", "knowledge", "runbook", "user-directive"]>;
|
|
5
8
|
title: z.ZodString;
|
|
6
9
|
summary: z.ZodString;
|
|
@@ -14,40 +17,41 @@ export declare const kbCaptureSchema: z.ZodObject<{
|
|
|
14
17
|
confidence: z.ZodOptional<z.ZodEnum<["CONFIRMED", "INFERRED", "UNVERIFIED"]>>;
|
|
15
18
|
scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
|
|
16
19
|
supersedes: z.ZodOptional<z.ZodString>;
|
|
17
|
-
repo_remote_url: z.ZodOptional<z.ZodString>;
|
|
18
20
|
}, "strip", z.ZodTypeAny, {
|
|
19
21
|
content: string;
|
|
20
22
|
type: "knowledge" | "context-cache" | "learning" | "runbook" | "user-directive";
|
|
21
23
|
title: string;
|
|
22
24
|
summary: string;
|
|
23
|
-
role?: string | undefined;
|
|
24
25
|
tags?: string[] | undefined;
|
|
26
|
+
role?: string | undefined;
|
|
27
|
+
scope?: "project" | "global" | undefined;
|
|
28
|
+
repo?: unknown;
|
|
25
29
|
source_files?: string[] | undefined;
|
|
26
30
|
symbols?: string[] | undefined;
|
|
27
31
|
module?: string | undefined;
|
|
28
32
|
supersedes?: string | undefined;
|
|
29
33
|
confidence?: "CONFIRMED" | "INFERRED" | "UNVERIFIED" | undefined;
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
repo_remote_url?: string | undefined;
|
|
34
|
+
repo_path?: unknown;
|
|
35
|
+
repo_remote_url?: unknown;
|
|
33
36
|
source_file?: string | undefined;
|
|
34
37
|
}, {
|
|
35
38
|
content: string;
|
|
36
39
|
type: "knowledge" | "context-cache" | "learning" | "runbook" | "user-directive";
|
|
37
40
|
title: string;
|
|
38
41
|
summary: string;
|
|
39
|
-
role?: string | undefined;
|
|
40
42
|
tags?: string[] | undefined;
|
|
43
|
+
role?: string | undefined;
|
|
44
|
+
scope?: "project" | "global" | undefined;
|
|
45
|
+
repo?: unknown;
|
|
41
46
|
source_files?: string[] | undefined;
|
|
42
47
|
symbols?: string[] | undefined;
|
|
43
48
|
module?: string | undefined;
|
|
44
49
|
supersedes?: string | undefined;
|
|
45
50
|
confidence?: "CONFIRMED" | "INFERRED" | "UNVERIFIED" | undefined;
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
repo_remote_url?: string | undefined;
|
|
51
|
+
repo_path?: unknown;
|
|
52
|
+
repo_remote_url?: unknown;
|
|
49
53
|
source_file?: string | undefined;
|
|
50
54
|
}>;
|
|
51
55
|
export type KbCaptureInput = z.infer<typeof kbCaptureSchema>;
|
|
52
|
-
export declare function kbCapture(input: KbCaptureInput): Promise<string>;
|
|
56
|
+
export declare function kbCapture(input: KbCaptureInput, anchor?: KbAnchor): Promise<string>;
|
|
53
57
|
//# sourceMappingURL=kb-capture.d.ts.map
|