@apralabs/apra-fleet 0.4.3 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -30
- package/dist/agents/backlog-groomer.md +75 -27
- package/dist/agents/ci-watcher.md +37 -22
- package/dist/agents/deployer.md +39 -22
- package/dist/agents/doer.md +74 -40
- package/dist/agents/harvester.md +49 -40
- package/dist/agents/integ-test-runner.md +40 -23
- package/dist/agents/kb-reconciler.md +28 -7
- package/dist/agents/plan-reviewer.md +49 -24
- package/dist/agents/planner.md +66 -43
- package/dist/agents/regression-test-runner.md +101 -78
- package/dist/agents/reviewer.md +117 -56
- package/dist/agents/schemas/backlog-groomer-output.json +1 -1
- package/dist/agents/schemas/doer-output.json +32 -0
- package/dist/agents/schemas/harvester-input.json +1 -5
- package/dist/agents/schemas/planner-output.json +1 -1
- package/dist/agents/schemas/regression-test-runner-output.json +41 -7
- package/dist/agents/schemas/reviewer-output.json +62 -3
- package/dist/cli/agent-transform.d.ts +7 -0
- package/dist/cli/agent-transform.js +46 -1
- package/dist/cli/auth.d.ts +1 -0
- package/dist/cli/auth.js +38 -8
- package/dist/cli/beads-install.d.ts +35 -0
- package/dist/cli/beads-install.js +125 -0
- package/dist/cli/beads-pin.d.ts +5 -0
- package/dist/cli/beads-pin.js +27 -0
- package/dist/cli/call.d.ts +27 -0
- package/dist/cli/call.js +177 -0
- package/dist/cli/config.d.ts +24 -1
- package/dist/cli/config.js +69 -2
- package/dist/cli/dolt-install.d.ts +18 -2
- package/dist/cli/dolt-install.js +46 -15
- package/dist/cli/fleet-se-guard.d.ts +51 -0
- package/dist/cli/fleet-se-guard.js +215 -0
- package/dist/cli/install-guard.d.ts +54 -0
- package/dist/cli/install-guard.js +132 -4
- package/dist/cli/install.d.ts +77 -21
- package/dist/cli/install.js +610 -152
- package/dist/cli/kb-commit.d.ts +2 -1
- package/dist/cli/kb-commit.js +1 -1
- package/dist/cli/kb-import.d.ts +2 -1
- package/dist/cli/kb-import.js +1 -1
- package/dist/cli/register-member.js +20 -3
- package/dist/cli/remove-member.d.ts +4 -0
- package/dist/cli/remove-member.js +63 -0
- package/dist/cli/secret.js +9 -0
- package/dist/cli/start.js +59 -4
- package/dist/cli/status.d.ts +3 -0
- package/dist/cli/status.js +45 -12
- package/dist/cli/stop.js +64 -9
- package/dist/cli/uninstall.js +101 -15
- package/dist/cli/update.js +33 -2
- package/dist/cli/watch.js +1 -1
- package/dist/cli/workflow.js +3 -2
- package/dist/commands/kb-server.js +9 -2
- package/dist/hub-service/http-server.d.ts +5 -1
- package/dist/hub-service/http-server.js +55 -5
- package/dist/index.js +155 -8
- package/dist/os/child-env-bound.d.ts +77 -0
- package/dist/os/child-env-bound.js +171 -0
- package/dist/os/linux.d.ts +7 -2
- package/dist/os/linux.js +40 -14
- package/dist/os/macos.d.ts +1 -1
- package/dist/os/macos.js +2 -11
- package/dist/os/os-commands.d.ts +17 -2
- package/dist/os/windows-gitbash.d.ts +1 -0
- package/dist/os/windows-gitbash.js +17 -3
- package/dist/os/windows-wrapper.d.ts +0 -4
- package/dist/os/windows-wrapper.js +2 -1
- package/dist/os/windows.d.ts +5 -2
- package/dist/os/windows.js +75 -29
- package/dist/paths.d.ts +21 -0
- package/dist/paths.js +35 -0
- package/dist/providers/agy.d.ts +6 -2
- package/dist/providers/agy.js +245 -106
- package/dist/providers/claude-permission-denial.d.ts +7 -0
- package/dist/providers/claude-permission-denial.js +137 -0
- package/dist/providers/claude.d.ts +86 -38
- package/dist/providers/claude.js +426 -164
- package/dist/providers/codex.js +5 -1
- package/dist/providers/copilot.js +5 -1
- package/dist/providers/opencode.d.ts +10 -2
- package/dist/providers/opencode.js +114 -53
- package/dist/providers/provider.d.ts +171 -33
- package/dist/providers/provider.js +164 -3
- package/dist/services/agent-provisioner.d.ts +29 -0
- package/dist/services/agent-provisioner.js +107 -0
- package/dist/services/agent-shadow.d.ts +96 -0
- package/dist/services/agent-shadow.js +479 -0
- package/dist/services/agy-project.d.ts +2 -1
- package/dist/services/agy-project.js +15 -17
- package/dist/services/auth-socket.d.ts +25 -0
- package/dist/services/auth-socket.js +68 -23
- package/dist/services/auth-web.js +1 -1
- package/dist/services/budget-awareness.d.ts +11 -11
- package/dist/services/budget-awareness.js +15 -3
- package/dist/services/claude-local-scope-mcp.d.ts +19 -0
- package/dist/services/claude-local-scope-mcp.js +91 -0
- package/dist/services/cloud/aws.js +2 -1
- package/dist/services/cloud/lifecycle.js +19 -2
- package/dist/services/cloud/task-wrapper.d.ts +0 -9
- package/dist/services/cloud/task-wrapper.js +15 -6
- package/dist/services/event-loop-watchdog.d.ts +32 -0
- package/dist/services/event-loop-watchdog.js +140 -0
- package/dist/services/http-transport.d.ts +49 -1
- package/dist/services/http-transport.js +190 -24
- package/dist/services/in-flight-agents.d.ts +2 -0
- package/dist/services/in-flight-agents.js +4 -0
- package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
- package/dist/services/knowledge/bible-basis-filter.js +134 -0
- package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
- package/dist/services/knowledge/bible-blob-id.js +113 -0
- package/dist/services/knowledge/bible-import.d.ts +65 -0
- package/dist/services/knowledge/bible-import.js +211 -0
- package/dist/services/knowledge/file-hash.d.ts +31 -0
- package/dist/services/knowledge/file-hash.js +153 -23
- package/dist/services/knowledge/http-provider.d.ts +4 -3
- package/dist/services/knowledge/http-provider.js +17 -5
- package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
- package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
- package/dist/services/knowledge/kb-providers.d.ts +4 -0
- package/dist/services/knowledge/kb-providers.js +8 -0
- package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
- package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
- package/dist/services/knowledge/kb-scopes.d.ts +14 -0
- package/dist/services/knowledge/kb-scopes.js +47 -0
- package/dist/services/knowledge/kb-self.d.ts +91 -0
- package/dist/services/knowledge/kb-self.js +198 -0
- package/dist/services/knowledge/member-bible-view.d.ts +21 -0
- package/dist/services/knowledge/member-bible-view.js +194 -0
- package/dist/services/knowledge/pre-init.js +1 -0
- package/dist/services/knowledge/project-slug.js +2 -2
- package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
- package/dist/services/knowledge/sqlite-provider.js +303 -41
- package/dist/services/knowledge/types.d.ts +45 -2
- package/dist/services/member-access-secret.d.ts +70 -0
- package/dist/services/member-access-secret.js +195 -0
- package/dist/services/member-call-counts.d.ts +24 -0
- package/dist/services/member-call-counts.js +58 -0
- package/dist/services/member-config-io.d.ts +192 -0
- package/dist/services/member-config-io.js +443 -0
- package/dist/services/member-fleet-install.d.ts +710 -0
- package/dist/services/member-fleet-install.js +1895 -0
- package/dist/services/member-secret-env.d.ts +42 -0
- package/dist/services/member-secret-env.js +68 -0
- package/dist/services/member-tool-allowlist.d.ts +49 -0
- package/dist/services/member-tool-allowlist.js +111 -0
- package/dist/services/model-pricing.d.ts +19 -0
- package/dist/services/model-pricing.js +54 -8
- package/dist/services/port-holder.d.ts +86 -0
- package/dist/services/port-holder.js +351 -0
- package/dist/services/preflight-check.js +2 -0
- package/dist/services/registry.d.ts +13 -2
- package/dist/services/registry.js +27 -1
- package/dist/services/relay-strategy.d.ts +2 -0
- package/dist/services/relay-strategy.js +8 -0
- package/dist/services/server-lifecycle.d.ts +26 -0
- package/dist/services/server-lifecycle.js +85 -0
- package/dist/services/service-manager/index.d.ts +7 -1
- package/dist/services/service-manager/index.js +17 -4
- package/dist/services/service-manager/linux.d.ts +1 -1
- package/dist/services/service-manager/linux.js +15 -7
- package/dist/services/service-manager/macos.d.ts +11 -1
- package/dist/services/service-manager/macos.js +45 -7
- package/dist/services/service-manager/service-path.d.ts +24 -0
- package/dist/services/service-manager/service-path.js +55 -0
- package/dist/services/service-manager/types.d.ts +38 -3
- package/dist/services/service-manager/types.js +29 -0
- package/dist/services/service-manager/windows.d.ts +181 -2
- package/dist/services/service-manager/windows.js +666 -49
- package/dist/services/service-notice.d.ts +14 -0
- package/dist/services/service-notice.js +62 -0
- package/dist/services/service-start-guard.d.ts +20 -0
- package/dist/services/service-start-guard.js +86 -0
- package/dist/services/session-cost.d.ts +24 -0
- package/dist/services/session-cost.js +105 -0
- package/dist/services/session-mcp-config.d.ts +83 -0
- package/dist/services/session-mcp-config.js +211 -0
- package/dist/services/sftp.d.ts +34 -0
- package/dist/services/sftp.js +304 -76
- package/dist/services/shell-probe.d.ts +0 -24
- package/dist/services/shell-probe.js +28 -3
- package/dist/services/singleton.d.ts +68 -2
- package/dist/services/singleton.js +168 -11
- package/dist/services/sprint-coordination.js +9 -3
- package/dist/services/ssh.d.ts +27 -0
- package/dist/services/ssh.js +229 -38
- package/dist/services/stall/find-log-file.js +12 -5
- package/dist/services/stall/index.d.ts +1 -1
- package/dist/services/stall/read-log-tail.d.ts +23 -0
- package/dist/services/stall/read-log-tail.js +33 -2
- package/dist/services/stall/stall-detector.d.ts +25 -1
- package/dist/services/stall/stall-detector.js +85 -6
- package/dist/services/stall/stall-poller.d.ts +16 -0
- package/dist/services/stall/stall-poller.js +50 -6
- package/dist/services/stopped-marker.d.ts +16 -0
- package/dist/services/stopped-marker.js +55 -0
- package/dist/services/strategy.d.ts +33 -1
- package/dist/services/strategy.js +86 -17
- package/dist/services/supervisor-service-cleanup.d.ts +52 -0
- package/dist/services/supervisor-service-cleanup.js +332 -0
- package/dist/services/tool-registry.d.ts +8 -1
- package/dist/services/tool-registry.js +160 -59
- package/dist/services/tool-scope.d.ts +58 -0
- package/dist/services/tool-scope.js +99 -0
- package/dist/services/watch/project-resolver.js +1 -0
- package/dist/skills/auto-sprint-args/SKILL.md +2 -2
- package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/dist/skills/pm/SKILL.md +3 -3
- package/dist/skills/pm/index.md +4 -2
- package/dist/skills/pm/kb-reconcile.md +29 -14
- package/dist/skills/pm/kb-review.md +1 -0
- package/dist/skills/pm/sprint.md +5 -5
- package/dist/tools/check-status.d.ts +53 -5
- package/dist/tools/check-status.js +210 -53
- package/dist/tools/child-id-allocator.d.ts +2 -2
- package/dist/tools/child-id-allocator.js +1 -1
- package/dist/tools/code-index-heal.d.ts +8 -0
- package/dist/tools/code-index-heal.js +21 -0
- package/dist/tools/code-index-state.d.ts +45 -0
- package/dist/tools/code-index-state.js +115 -0
- package/dist/tools/code-intelligence-codebase-memory.js +6 -33
- package/dist/tools/code-intelligence-freshness.js +1 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
- package/dist/tools/code-intelligence-gitnexus.js +333 -57
- package/dist/tools/code-intelligence-kb-enrich.js +7 -6
- package/dist/tools/code-intelligence-readiness.d.ts +99 -0
- package/dist/tools/code-intelligence-readiness.js +206 -0
- package/dist/tools/code-intelligence-reindex.d.ts +195 -0
- package/dist/tools/code-intelligence-reindex.js +530 -50
- package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
- package/dist/tools/code-intelligence-telemetry.js +12 -3
- package/dist/tools/code-intelligence.d.ts +81 -31
- package/dist/tools/code-intelligence.js +156 -52
- package/dist/tools/compose-permissions.d.ts +57 -2
- package/dist/tools/compose-permissions.js +497 -44
- package/dist/tools/execute-command.d.ts +11 -0
- package/dist/tools/execute-command.js +80 -12
- package/dist/tools/execute-prompt.d.ts +59 -15
- package/dist/tools/execute-prompt.js +544 -133
- package/dist/tools/kb-bible-commit.d.ts +65 -0
- package/dist/tools/kb-bible-commit.js +239 -0
- package/dist/tools/kb-capture.d.ts +13 -9
- package/dist/tools/kb-capture.js +42 -11
- package/dist/tools/kb-context.d.ts +27 -7
- package/dist/tools/kb-context.js +60 -9
- package/dist/tools/kb-export.d.ts +96 -7
- package/dist/tools/kb-export.js +228 -65
- package/dist/tools/kb-feedback.d.ts +13 -9
- package/dist/tools/kb-feedback.js +13 -7
- package/dist/tools/kb-freshness-sweep.d.ts +11 -7
- package/dist/tools/kb-freshness-sweep.js +7 -7
- package/dist/tools/kb-harvest.d.ts +11 -7
- package/dist/tools/kb-harvest.js +7 -7
- package/dist/tools/kb-import.d.ts +26 -10
- package/dist/tools/kb-import.js +169 -159
- package/dist/tools/kb-invalidate.d.ts +17 -10
- package/dist/tools/kb-invalidate.js +41 -8
- package/dist/tools/kb-list.d.ts +14 -10
- package/dist/tools/kb-list.js +30 -10
- package/dist/tools/kb-promote.d.ts +11 -7
- package/dist/tools/kb-promote.js +14 -8
- package/dist/tools/kb-query.d.ts +21 -11
- package/dist/tools/kb-query.js +76 -13
- package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
- package/dist/tools/kb-reconcile-prefilter.js +10 -8
- package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
- package/dist/tools/kb-resolve-contradiction.js +7 -7
- package/dist/tools/kb-session-prime.d.ts +14 -7
- package/dist/tools/kb-session-prime.js +44 -44
- package/dist/tools/kb-setup.d.ts +11 -4
- package/dist/tools/kb-setup.js +25 -11
- package/dist/tools/kb-stats.d.ts +11 -10
- package/dist/tools/kb-stats.js +22 -41
- package/dist/tools/list-members.js +5 -2
- package/dist/tools/member-detail.d.ts +3 -0
- package/dist/tools/member-detail.js +88 -17
- package/dist/tools/member-reservation.d.ts +2 -2
- package/dist/tools/provision-auth.d.ts +39 -1
- package/dist/tools/provision-auth.js +269 -47
- package/dist/tools/provision-vcs-auth.d.ts +2 -2
- package/dist/tools/receive-files.js +3 -1
- package/dist/tools/register-member.d.ts +34 -8
- package/dist/tools/register-member.js +76 -58
- package/dist/tools/remove-member.js +110 -32
- package/dist/tools/send-email.d.ts +2 -2
- package/dist/tools/send-files.js +6 -4
- package/dist/tools/session-stats.d.ts +17 -0
- package/dist/tools/session-stats.js +27 -0
- package/dist/tools/shutdown-server.js +5 -0
- package/dist/tools/update-agent-cli.d.ts +19 -0
- package/dist/tools/update-agent-cli.js +59 -2
- package/dist/tools/update-member.d.ts +13 -10
- package/dist/tools/update-member.js +138 -7
- package/dist/tools/vcs-credential-exec.js +8 -2
- package/dist/types.d.ts +98 -1
- package/dist/utils/agent-helpers.js +2 -0
- package/dist/utils/auth-env.d.ts +15 -4
- package/dist/utils/auth-env.js +52 -23
- package/dist/utils/find-on-path.d.ts +37 -0
- package/dist/utils/find-on-path.js +85 -0
- package/dist/utils/log-helpers.d.ts +37 -0
- package/dist/utils/log-helpers.js +106 -20
- package/dist/utils/owner-only-fs.d.ts +56 -0
- package/dist/utils/owner-only-fs.js +98 -0
- package/dist/utils/process-utils.d.ts +28 -0
- package/dist/utils/process-utils.js +68 -0
- package/dist/utils/prompt-errors.js +4 -1
- package/dist/utils/session-caller.d.ts +4 -2
- package/dist/utils/session-caller.js +3 -2
- package/dist/utils/shell-escape.d.ts +42 -3
- package/dist/utils/shell-escape.js +70 -4
- package/dist/utils/ssh-error-messages.js +3 -0
- package/dist/utils/workspace-trust.d.ts +24 -1
- package/dist/utils/workspace-trust.js +21 -17
- package/dist/workflows/auto-sprint.js +223 -43
- package/package.json +11 -8
- package/packages/apra-fleet-client/package.json +2 -2
- package/packages/apra-fleet-client/src/client/api.mjs +558 -27
- package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
- package/packages/apra-fleet-client/src/client/client.mjs +9 -0
- package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
- package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
- package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
- package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
- package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +75 -27
- package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +37 -22
- package/packages/apra-fleet-se/apra-pm/agents/deployer.md +39 -22
- package/packages/apra-fleet-se/apra-pm/agents/doer.md +74 -40
- package/packages/apra-fleet-se/apra-pm/agents/harvester.md +49 -40
- package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +40 -23
- package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +28 -7
- package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +49 -24
- package/packages/apra-fleet-se/apra-pm/agents/planner.md +66 -43
- package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +101 -78
- package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -56
- package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
- package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
- package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
- package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
- package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
- package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
- package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
- package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
- package/packages/apra-fleet-se/bin/cli.mjs +184 -54
- package/packages/apra-fleet-se/bin/serve.mjs +143 -10
- package/packages/apra-fleet-se/fleet-sprint/abort.mjs +56 -20
- package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +208 -53
- package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
- package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
- package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +114 -7
- package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
- package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
- package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
- package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +60 -1
- package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +25 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
- package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
- package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +205 -16
- package/packages/apra-fleet-se/fleet-sprint/docs/README.md +52 -14
- package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
- package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
- package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +339 -20
- package/packages/apra-fleet-se/fleet-sprint/errors.mjs +210 -11
- package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
- package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +200 -9
- package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +57 -9
- package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +53 -4
- package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
- package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
- package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1257 -301
- package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
- package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
- package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
- package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
- package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +447 -0
- package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
- package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +82 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +97 -50
- package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
- package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +81 -18
- package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +43 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
- package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +20 -15
- package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +60 -38
- package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +42 -10
- package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
- package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
- package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +72 -12
- package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
- package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +83 -25
- package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
- package/packages/apra-fleet-se/fleet-sprint/runner.js +834 -142
- package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
- package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +130 -0
- package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
- package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
- package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +84 -30
- package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +138 -2
- package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +111 -11
- package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +22 -0
- package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +180 -14
- package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +49 -0
- package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
- package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
- package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +235 -21
- package/packages/apra-fleet-se/package.json +2 -2
- package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
- package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
- package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
- package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
- package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
- package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
- package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
- package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
- package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
- package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
- package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
- package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
- package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
- package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
- package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
- package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
- package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
- package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
- package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
- package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
- package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
- package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
- package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
- package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
- package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
- package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
- package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
- package/packages/apra-fleet-workflow/package.json +1 -1
- package/packages/apra-fleet-workflow/src/viewer/index.mjs +64 -9
- package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
- package/packages/apra-fleet-workflow/src/workflow/index.mjs +71 -5
- package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
- package/skills/fleet/permissions.md +9 -0
- package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
- package/version.json +1 -1
- package/dist/cli/agent-transform.d.ts.map +0 -1
- package/dist/cli/agent-transform.js.map +0 -1
- package/dist/cli/auth.d.ts.map +0 -1
- package/dist/cli/auth.js.map +0 -1
- package/dist/cli/config.d.ts.map +0 -1
- package/dist/cli/config.js.map +0 -1
- package/dist/cli/dolt-install.d.ts.map +0 -1
- package/dist/cli/dolt-install.js.map +0 -1
- package/dist/cli/install-guard.d.ts.map +0 -1
- package/dist/cli/install-guard.js.map +0 -1
- package/dist/cli/install.d.ts.map +0 -1
- package/dist/cli/install.js.map +0 -1
- package/dist/cli/join.d.ts.map +0 -1
- package/dist/cli/join.js.map +0 -1
- package/dist/cli/kb-commit.d.ts.map +0 -1
- package/dist/cli/kb-commit.js.map +0 -1
- package/dist/cli/kb-directives.d.ts.map +0 -1
- package/dist/cli/kb-directives.js.map +0 -1
- package/dist/cli/kb-import.d.ts.map +0 -1
- package/dist/cli/kb-import.js.map +0 -1
- package/dist/cli/register-member.d.ts.map +0 -1
- package/dist/cli/register-member.js.map +0 -1
- package/dist/cli/restart.d.ts.map +0 -1
- package/dist/cli/restart.js.map +0 -1
- package/dist/cli/secret.d.ts.map +0 -1
- package/dist/cli/secret.js.map +0 -1
- package/dist/cli/spoke.d.ts.map +0 -1
- package/dist/cli/spoke.js.map +0 -1
- package/dist/cli/start.d.ts.map +0 -1
- package/dist/cli/start.js.map +0 -1
- package/dist/cli/status.d.ts.map +0 -1
- package/dist/cli/status.js.map +0 -1
- package/dist/cli/stop.d.ts.map +0 -1
- package/dist/cli/stop.js.map +0 -1
- package/dist/cli/uninstall.d.ts.map +0 -1
- package/dist/cli/uninstall.js.map +0 -1
- package/dist/cli/update.d.ts.map +0 -1
- package/dist/cli/update.js.map +0 -1
- package/dist/cli/watch.d.ts.map +0 -1
- package/dist/cli/watch.js.map +0 -1
- package/dist/cli/workflow-assets.d.ts.map +0 -1
- package/dist/cli/workflow-assets.js.map +0 -1
- package/dist/cli/workflow.d.ts.map +0 -1
- package/dist/cli/workflow.js.map +0 -1
- package/dist/commands/kb-server.d.ts.map +0 -1
- package/dist/commands/kb-server.js.map +0 -1
- package/dist/delivery-mode.d.ts.map +0 -1
- package/dist/delivery-mode.js.map +0 -1
- package/dist/hub-service/activity.d.ts.map +0 -1
- package/dist/hub-service/activity.js.map +0 -1
- package/dist/hub-service/audit-log.d.ts.map +0 -1
- package/dist/hub-service/audit-log.js.map +0 -1
- package/dist/hub-service/db/pool.d.ts.map +0 -1
- package/dist/hub-service/db/pool.js.map +0 -1
- package/dist/hub-service/enrollment.d.ts.map +0 -1
- package/dist/hub-service/enrollment.js.map +0 -1
- package/dist/hub-service/envelope-routes.d.ts.map +0 -1
- package/dist/hub-service/envelope-routes.js.map +0 -1
- package/dist/hub-service/handlers/installers.d.ts.map +0 -1
- package/dist/hub-service/handlers/installers.js.map +0 -1
- package/dist/hub-service/http-server.d.ts.map +0 -1
- package/dist/hub-service/http-server.js.map +0 -1
- package/dist/hub-service/hub-jwt.d.ts.map +0 -1
- package/dist/hub-service/hub-jwt.js.map +0 -1
- package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
- package/dist/hub-service/jwt-revocation.js.map +0 -1
- package/dist/hub-service/machines.d.ts.map +0 -1
- package/dist/hub-service/machines.js.map +0 -1
- package/dist/hub-service/main.d.ts.map +0 -1
- package/dist/hub-service/main.js.map +0 -1
- package/dist/hub-service/member-tokens.d.ts.map +0 -1
- package/dist/hub-service/member-tokens.js.map +0 -1
- package/dist/hub-service/member-view.d.ts.map +0 -1
- package/dist/hub-service/member-view.js.map +0 -1
- package/dist/hub-service/members.d.ts.map +0 -1
- package/dist/hub-service/members.js.map +0 -1
- package/dist/hub-service/presence.d.ts.map +0 -1
- package/dist/hub-service/presence.js.map +0 -1
- package/dist/hub-service/project-view.d.ts.map +0 -1
- package/dist/hub-service/project-view.js.map +0 -1
- package/dist/hub-service/projects.d.ts.map +0 -1
- package/dist/hub-service/projects.js.map +0 -1
- package/dist/hub-service/relay-queue.d.ts.map +0 -1
- package/dist/hub-service/relay-queue.js.map +0 -1
- package/dist/hub-service/session-jwt.d.ts.map +0 -1
- package/dist/hub-service/session-jwt.js.map +0 -1
- package/dist/hub-service/usage.d.ts.map +0 -1
- package/dist/hub-service/usage.js.map +0 -1
- package/dist/hub-service/users.d.ts.map +0 -1
- package/dist/hub-service/users.js.map +0 -1
- package/dist/hub-service/workspaces.d.ts.map +0 -1
- package/dist/hub-service/workspaces.js.map +0 -1
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/onboarding/text.d.ts.map +0 -1
- package/dist/onboarding/text.js.map +0 -1
- package/dist/os/git-bash-candidates.d.ts.map +0 -1
- package/dist/os/git-bash-candidates.js.map +0 -1
- package/dist/os/index.d.ts.map +0 -1
- package/dist/os/index.js.map +0 -1
- package/dist/os/linux.d.ts.map +0 -1
- package/dist/os/linux.js.map +0 -1
- package/dist/os/macos.d.ts.map +0 -1
- package/dist/os/macos.js.map +0 -1
- package/dist/os/os-commands.d.ts.map +0 -1
- package/dist/os/os-commands.js.map +0 -1
- package/dist/os/windows-gitbash.d.ts.map +0 -1
- package/dist/os/windows-gitbash.js.map +0 -1
- package/dist/os/windows-wrapper.d.ts.map +0 -1
- package/dist/os/windows-wrapper.js.map +0 -1
- package/dist/os/windows.d.ts.map +0 -1
- package/dist/os/windows.js.map +0 -1
- package/dist/paths.d.ts.map +0 -1
- package/dist/paths.js.map +0 -1
- package/dist/providers/agy.d.ts.map +0 -1
- package/dist/providers/agy.js.map +0 -1
- package/dist/providers/claude.d.ts.map +0 -1
- package/dist/providers/claude.js.map +0 -1
- package/dist/providers/codex.d.ts.map +0 -1
- package/dist/providers/codex.js.map +0 -1
- package/dist/providers/copilot.d.ts.map +0 -1
- package/dist/providers/copilot.js.map +0 -1
- package/dist/providers/email/headers.d.ts.map +0 -1
- package/dist/providers/email/headers.js.map +0 -1
- package/dist/providers/email/index.d.ts.map +0 -1
- package/dist/providers/email/index.js.map +0 -1
- package/dist/providers/email/provider.d.ts.map +0 -1
- package/dist/providers/email/provider.js.map +0 -1
- package/dist/providers/email/sendgrid.d.ts.map +0 -1
- package/dist/providers/email/sendgrid.js.map +0 -1
- package/dist/providers/email/smtp.d.ts.map +0 -1
- package/dist/providers/email/smtp.js.map +0 -1
- package/dist/providers/index.d.ts.map +0 -1
- package/dist/providers/index.js.map +0 -1
- package/dist/providers/none.d.ts.map +0 -1
- package/dist/providers/none.js.map +0 -1
- package/dist/providers/opencode.d.ts.map +0 -1
- package/dist/providers/opencode.js.map +0 -1
- package/dist/providers/provider.d.ts.map +0 -1
- package/dist/providers/provider.js.map +0 -1
- package/dist/services/agent-provisioner.d.ts.map +0 -1
- package/dist/services/agent-provisioner.js.map +0 -1
- package/dist/services/agy-project.d.ts.map +0 -1
- package/dist/services/agy-project.js.map +0 -1
- package/dist/services/auth-socket.d.ts.map +0 -1
- package/dist/services/auth-socket.js.map +0 -1
- package/dist/services/auth-web.d.ts.map +0 -1
- package/dist/services/auth-web.js.map +0 -1
- package/dist/services/budget-awareness.d.ts.map +0 -1
- package/dist/services/budget-awareness.js.map +0 -1
- package/dist/services/cloud/activity.d.ts.map +0 -1
- package/dist/services/cloud/activity.js.map +0 -1
- package/dist/services/cloud/aws.d.ts.map +0 -1
- package/dist/services/cloud/aws.js.map +0 -1
- package/dist/services/cloud/cost.d.ts.map +0 -1
- package/dist/services/cloud/cost.js.map +0 -1
- package/dist/services/cloud/idle-manager.d.ts.map +0 -1
- package/dist/services/cloud/idle-manager.js.map +0 -1
- package/dist/services/cloud/lifecycle.d.ts.map +0 -1
- package/dist/services/cloud/lifecycle.js.map +0 -1
- package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
- package/dist/services/cloud/task-wrapper.js.map +0 -1
- package/dist/services/cloud/types.d.ts.map +0 -1
- package/dist/services/cloud/types.js.map +0 -1
- package/dist/services/cloud-sync.d.ts.map +0 -1
- package/dist/services/cloud-sync.js.map +0 -1
- package/dist/services/context-admission.d.ts.map +0 -1
- package/dist/services/context-admission.js.map +0 -1
- package/dist/services/credential-cleanup.d.ts.map +0 -1
- package/dist/services/credential-cleanup.js.map +0 -1
- package/dist/services/credential-store.d.ts.map +0 -1
- package/dist/services/credential-store.js.map +0 -1
- package/dist/services/event-bus.d.ts.map +0 -1
- package/dist/services/event-bus.js.map +0 -1
- package/dist/services/exit-drain.d.ts.map +0 -1
- package/dist/services/exit-drain.js.map +0 -1
- package/dist/services/file-chunker.d.ts.map +0 -1
- package/dist/services/file-chunker.js.map +0 -1
- package/dist/services/file-transfer-relay.d.ts.map +0 -1
- package/dist/services/file-transfer-relay.js.map +0 -1
- package/dist/services/file-transfer.d.ts.map +0 -1
- package/dist/services/file-transfer.js.map +0 -1
- package/dist/services/git-config.d.ts.map +0 -1
- package/dist/services/git-config.js.map +0 -1
- package/dist/services/github-app.d.ts.map +0 -1
- package/dist/services/github-app.js.map +0 -1
- package/dist/services/http-transport.d.ts.map +0 -1
- package/dist/services/http-transport.js.map +0 -1
- package/dist/services/hub-client.d.ts.map +0 -1
- package/dist/services/hub-client.js.map +0 -1
- package/dist/services/icons.d.ts.map +0 -1
- package/dist/services/icons.js.map +0 -1
- package/dist/services/jwt.d.ts.map +0 -1
- package/dist/services/jwt.js.map +0 -1
- package/dist/services/knowledge/audn.d.ts.map +0 -1
- package/dist/services/knowledge/audn.js.map +0 -1
- package/dist/services/knowledge/file-hash.d.ts.map +0 -1
- package/dist/services/knowledge/file-hash.js.map +0 -1
- package/dist/services/knowledge/http-provider.d.ts.map +0 -1
- package/dist/services/knowledge/http-provider.js.map +0 -1
- package/dist/services/knowledge/kb-config.d.ts.map +0 -1
- package/dist/services/knowledge/kb-config.js.map +0 -1
- package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
- package/dist/services/knowledge/kb-providers.js.map +0 -1
- package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
- package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
- package/dist/services/knowledge/kb-scope-input.js +0 -11
- package/dist/services/knowledge/kb-scope-input.js.map +0 -1
- package/dist/services/knowledge/kb-service.d.ts.map +0 -1
- package/dist/services/knowledge/kb-service.js.map +0 -1
- package/dist/services/knowledge/path-validation.d.ts.map +0 -1
- package/dist/services/knowledge/path-validation.js.map +0 -1
- package/dist/services/knowledge/pre-init.d.ts.map +0 -1
- package/dist/services/knowledge/pre-init.js.map +0 -1
- package/dist/services/knowledge/project-slug.d.ts.map +0 -1
- package/dist/services/knowledge/project-slug.js.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
- package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
- package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
- package/dist/services/knowledge/sqlite-provider.js.map +0 -1
- package/dist/services/knowledge/types.d.ts.map +0 -1
- package/dist/services/knowledge/types.js.map +0 -1
- package/dist/services/known-hosts.d.ts.map +0 -1
- package/dist/services/known-hosts.js.map +0 -1
- package/dist/services/known-sessions.d.ts.map +0 -1
- package/dist/services/known-sessions.js.map +0 -1
- package/dist/services/member-home.d.ts.map +0 -1
- package/dist/services/member-home.js.map +0 -1
- package/dist/services/member-remote-url.d.ts.map +0 -1
- package/dist/services/member-remote-url.js.map +0 -1
- package/dist/services/model-pricing.d.ts.map +0 -1
- package/dist/services/model-pricing.js.map +0 -1
- package/dist/services/onboarding.d.ts.map +0 -1
- package/dist/services/onboarding.js.map +0 -1
- package/dist/services/orphan-recovery.d.ts.map +0 -1
- package/dist/services/orphan-recovery.js.map +0 -1
- package/dist/services/pending-responses.d.ts.map +0 -1
- package/dist/services/pending-responses.js.map +0 -1
- package/dist/services/preflight-check.d.ts.map +0 -1
- package/dist/services/preflight-check.js.map +0 -1
- package/dist/services/registry.d.ts.map +0 -1
- package/dist/services/registry.js.map +0 -1
- package/dist/services/relay-context.d.ts.map +0 -1
- package/dist/services/relay-context.js.map +0 -1
- package/dist/services/relay-executor.d.ts.map +0 -1
- package/dist/services/relay-executor.js.map +0 -1
- package/dist/services/relay-request.d.ts.map +0 -1
- package/dist/services/relay-request.js.map +0 -1
- package/dist/services/relay-strategy.d.ts.map +0 -1
- package/dist/services/relay-strategy.js.map +0 -1
- package/dist/services/secret-token.d.ts.map +0 -1
- package/dist/services/secret-token.js.map +0 -1
- package/dist/services/service-manager/index.d.ts.map +0 -1
- package/dist/services/service-manager/index.js.map +0 -1
- package/dist/services/service-manager/linux.d.ts.map +0 -1
- package/dist/services/service-manager/linux.js.map +0 -1
- package/dist/services/service-manager/macos.d.ts.map +0 -1
- package/dist/services/service-manager/macos.js.map +0 -1
- package/dist/services/service-manager/types.d.ts.map +0 -1
- package/dist/services/service-manager/types.js.map +0 -1
- package/dist/services/service-manager/windows.d.ts.map +0 -1
- package/dist/services/service-manager/windows.js.map +0 -1
- package/dist/services/session-registry.d.ts.map +0 -1
- package/dist/services/session-registry.js.map +0 -1
- package/dist/services/sftp.d.ts.map +0 -1
- package/dist/services/sftp.js.map +0 -1
- package/dist/services/shell-probe.d.ts.map +0 -1
- package/dist/services/shell-probe.js.map +0 -1
- package/dist/services/singleton.d.ts.map +0 -1
- package/dist/services/singleton.js.map +0 -1
- package/dist/services/sprint-coordination.d.ts.map +0 -1
- package/dist/services/sprint-coordination.js.map +0 -1
- package/dist/services/ssh.d.ts.map +0 -1
- package/dist/services/ssh.js.map +0 -1
- package/dist/services/stall/find-log-file.d.ts.map +0 -1
- package/dist/services/stall/find-log-file.js.map +0 -1
- package/dist/services/stall/index.d.ts.map +0 -1
- package/dist/services/stall/index.js.map +0 -1
- package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
- package/dist/services/stall/log-path-resolver.js.map +0 -1
- package/dist/services/stall/read-log-tail.d.ts.map +0 -1
- package/dist/services/stall/read-log-tail.js.map +0 -1
- package/dist/services/stall/stall-detector.d.ts.map +0 -1
- package/dist/services/stall/stall-detector.js.map +0 -1
- package/dist/services/stall/stall-poller.d.ts.map +0 -1
- package/dist/services/stall/stall-poller.js.map +0 -1
- package/dist/services/stall/time-utils.d.ts.map +0 -1
- package/dist/services/stall/time-utils.js.map +0 -1
- package/dist/services/statusline.d.ts.map +0 -1
- package/dist/services/statusline.js.map +0 -1
- package/dist/services/strategy.d.ts.map +0 -1
- package/dist/services/strategy.js.map +0 -1
- package/dist/services/substitution-engine.d.ts.map +0 -1
- package/dist/services/substitution-engine.js.map +0 -1
- package/dist/services/task-cleanup.d.ts.map +0 -1
- package/dist/services/task-cleanup.js.map +0 -1
- package/dist/services/token-issuer.d.ts.map +0 -1
- package/dist/services/token-issuer.js.map +0 -1
- package/dist/services/tool-registry.d.ts.map +0 -1
- package/dist/services/tool-registry.js.map +0 -1
- package/dist/services/update-check.d.ts.map +0 -1
- package/dist/services/update-check.js.map +0 -1
- package/dist/services/user-config.d.ts.map +0 -1
- package/dist/services/user-config.js.map +0 -1
- package/dist/services/vcs/azure-devops.d.ts.map +0 -1
- package/dist/services/vcs/azure-devops.js.map +0 -1
- package/dist/services/vcs/bitbucket.d.ts.map +0 -1
- package/dist/services/vcs/bitbucket.js.map +0 -1
- package/dist/services/vcs/constants.d.ts.map +0 -1
- package/dist/services/vcs/constants.js.map +0 -1
- package/dist/services/vcs/github.d.ts.map +0 -1
- package/dist/services/vcs/github.js.map +0 -1
- package/dist/services/vcs/types.d.ts.map +0 -1
- package/dist/services/vcs/types.js.map +0 -1
- package/dist/services/version-check.d.ts.map +0 -1
- package/dist/services/version-check.js.map +0 -1
- package/dist/services/watch/fleet-log.d.ts.map +0 -1
- package/dist/services/watch/fleet-log.js.map +0 -1
- package/dist/services/watch/project-resolver.d.ts.map +0 -1
- package/dist/services/watch/project-resolver.js.map +0 -1
- package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
- package/dist/services/watch/transcript-formatter.js.map +0 -1
- package/dist/smoke-test.d.ts.map +0 -1
- package/dist/smoke-test.js.map +0 -1
- package/dist/tools/check-status.d.ts.map +0 -1
- package/dist/tools/check-status.js.map +0 -1
- package/dist/tools/child-id-allocator.d.ts.map +0 -1
- package/dist/tools/child-id-allocator.js.map +0 -1
- package/dist/tools/cloud-control.d.ts.map +0 -1
- package/dist/tools/cloud-control.js.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
- package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
- package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
- package/dist/tools/code-intelligence-freshness.js.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
- package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
- package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
- package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
- package/dist/tools/code-intelligence-reindex.js.map +0 -1
- package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
- package/dist/tools/code-intelligence-telemetry.js.map +0 -1
- package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
- package/dist/tools/code-intelligence-tests.js.map +0 -1
- package/dist/tools/code-intelligence.d.ts.map +0 -1
- package/dist/tools/code-intelligence.js.map +0 -1
- package/dist/tools/compose-permissions.d.ts.map +0 -1
- package/dist/tools/compose-permissions.js.map +0 -1
- package/dist/tools/credential-store-delete.d.ts.map +0 -1
- package/dist/tools/credential-store-delete.js.map +0 -1
- package/dist/tools/credential-store-list.d.ts.map +0 -1
- package/dist/tools/credential-store-list.js.map +0 -1
- package/dist/tools/credential-store-set.d.ts.map +0 -1
- package/dist/tools/credential-store-set.js.map +0 -1
- package/dist/tools/credential-store-update.d.ts.map +0 -1
- package/dist/tools/credential-store-update.js.map +0 -1
- package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
- package/dist/tools/dolt-push-mutex.js.map +0 -1
- package/dist/tools/execute-command.d.ts.map +0 -1
- package/dist/tools/execute-command.js.map +0 -1
- package/dist/tools/execute-prompt.d.ts.map +0 -1
- package/dist/tools/execute-prompt.js.map +0 -1
- package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
- package/dist/tools/get-member-model-pricing.js.map +0 -1
- package/dist/tools/kb-capture.d.ts.map +0 -1
- package/dist/tools/kb-capture.js.map +0 -1
- package/dist/tools/kb-context.d.ts.map +0 -1
- package/dist/tools/kb-context.js.map +0 -1
- package/dist/tools/kb-export.d.ts.map +0 -1
- package/dist/tools/kb-export.js.map +0 -1
- package/dist/tools/kb-feedback.d.ts.map +0 -1
- package/dist/tools/kb-feedback.js.map +0 -1
- package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
- package/dist/tools/kb-freshness-sweep.js.map +0 -1
- package/dist/tools/kb-harvest.d.ts.map +0 -1
- package/dist/tools/kb-harvest.js.map +0 -1
- package/dist/tools/kb-import.d.ts.map +0 -1
- package/dist/tools/kb-import.js.map +0 -1
- package/dist/tools/kb-invalidate.d.ts.map +0 -1
- package/dist/tools/kb-invalidate.js.map +0 -1
- package/dist/tools/kb-list.d.ts.map +0 -1
- package/dist/tools/kb-list.js.map +0 -1
- package/dist/tools/kb-promote.d.ts.map +0 -1
- package/dist/tools/kb-promote.js.map +0 -1
- package/dist/tools/kb-query.d.ts.map +0 -1
- package/dist/tools/kb-query.js.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
- package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
- package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
- package/dist/tools/kb-resolve-contradiction.js.map +0 -1
- package/dist/tools/kb-session-prime.d.ts.map +0 -1
- package/dist/tools/kb-session-prime.js.map +0 -1
- package/dist/tools/kb-setup.d.ts.map +0 -1
- package/dist/tools/kb-setup.js.map +0 -1
- package/dist/tools/kb-stats.d.ts.map +0 -1
- package/dist/tools/kb-stats.js.map +0 -1
- package/dist/tools/list-members.d.ts.map +0 -1
- package/dist/tools/list-members.js.map +0 -1
- package/dist/tools/member-detail.d.ts.map +0 -1
- package/dist/tools/member-detail.js.map +0 -1
- package/dist/tools/member-reservation.d.ts.map +0 -1
- package/dist/tools/member-reservation.js.map +0 -1
- package/dist/tools/monitor-task.d.ts.map +0 -1
- package/dist/tools/monitor-task.js.map +0 -1
- package/dist/tools/provision-auth.d.ts.map +0 -1
- package/dist/tools/provision-auth.js.map +0 -1
- package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
- package/dist/tools/provision-vcs-auth.js.map +0 -1
- package/dist/tools/receive-files.d.ts.map +0 -1
- package/dist/tools/receive-files.js.map +0 -1
- package/dist/tools/register-member.d.ts.map +0 -1
- package/dist/tools/register-member.js.map +0 -1
- package/dist/tools/remove-member.d.ts.map +0 -1
- package/dist/tools/remove-member.js.map +0 -1
- package/dist/tools/report-status.d.ts.map +0 -1
- package/dist/tools/report-status.js.map +0 -1
- package/dist/tools/respond-to-message.d.ts.map +0 -1
- package/dist/tools/respond-to-message.js.map +0 -1
- package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
- package/dist/tools/revoke-vcs-auth.js.map +0 -1
- package/dist/tools/send-email.d.ts.map +0 -1
- package/dist/tools/send-email.js.map +0 -1
- package/dist/tools/send-files.d.ts.map +0 -1
- package/dist/tools/send-files.js.map +0 -1
- package/dist/tools/send-message.d.ts.map +0 -1
- package/dist/tools/send-message.js.map +0 -1
- package/dist/tools/setup-git-app.d.ts.map +0 -1
- package/dist/tools/setup-git-app.js.map +0 -1
- package/dist/tools/setup-ssh-key.d.ts.map +0 -1
- package/dist/tools/setup-ssh-key.js.map +0 -1
- package/dist/tools/shutdown-server.d.ts.map +0 -1
- package/dist/tools/shutdown-server.js.map +0 -1
- package/dist/tools/stop-prompt.d.ts.map +0 -1
- package/dist/tools/stop-prompt.js.map +0 -1
- package/dist/tools/update-agent-cli.d.ts.map +0 -1
- package/dist/tools/update-agent-cli.js.map +0 -1
- package/dist/tools/update-member.d.ts.map +0 -1
- package/dist/tools/update-member.js.map +0 -1
- package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
- package/dist/tools/vcs-credential-exec.js.map +0 -1
- package/dist/tools/version.d.ts.map +0 -1
- package/dist/tools/version.js.map +0 -1
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js.map +0 -1
- package/dist/utils/agent-helpers.d.ts.map +0 -1
- package/dist/utils/agent-helpers.js.map +0 -1
- package/dist/utils/ansi.d.ts.map +0 -1
- package/dist/utils/ansi.js.map +0 -1
- package/dist/utils/auth-env.d.ts.map +0 -1
- package/dist/utils/auth-env.js.map +0 -1
- package/dist/utils/collect-secret.d.ts.map +0 -1
- package/dist/utils/collect-secret.js.map +0 -1
- package/dist/utils/credential-validation.d.ts.map +0 -1
- package/dist/utils/credential-validation.js.map +0 -1
- package/dist/utils/crypto.d.ts.map +0 -1
- package/dist/utils/crypto.js.map +0 -1
- package/dist/utils/deep-merge.d.ts.map +0 -1
- package/dist/utils/deep-merge.js.map +0 -1
- package/dist/utils/file-permissions.d.ts.map +0 -1
- package/dist/utils/file-permissions.js.map +0 -1
- package/dist/utils/gpu-parser.d.ts.map +0 -1
- package/dist/utils/gpu-parser.js.map +0 -1
- package/dist/utils/log-helpers.d.ts.map +0 -1
- package/dist/utils/log-helpers.js.map +0 -1
- package/dist/utils/oob-timeout.d.ts.map +0 -1
- package/dist/utils/oob-timeout.js.map +0 -1
- package/dist/utils/opencode-model-validation.d.ts.map +0 -1
- package/dist/utils/opencode-model-validation.js.map +0 -1
- package/dist/utils/pid-helpers.d.ts.map +0 -1
- package/dist/utils/pid-helpers.js.map +0 -1
- package/dist/utils/platform.d.ts.map +0 -1
- package/dist/utils/platform.js.map +0 -1
- package/dist/utils/process-utils.d.ts.map +0 -1
- package/dist/utils/process-utils.js.map +0 -1
- package/dist/utils/prompt-errors.d.ts.map +0 -1
- package/dist/utils/prompt-errors.js.map +0 -1
- package/dist/utils/resolve-member.d.ts.map +0 -1
- package/dist/utils/resolve-member.js.map +0 -1
- package/dist/utils/secure-input.d.ts.map +0 -1
- package/dist/utils/secure-input.js.map +0 -1
- package/dist/utils/session-caller.d.ts.map +0 -1
- package/dist/utils/session-caller.js.map +0 -1
- package/dist/utils/shell-escape.d.ts.map +0 -1
- package/dist/utils/shell-escape.js.map +0 -1
- package/dist/utils/skill-matrix.d.ts.map +0 -1
- package/dist/utils/skill-matrix.js.map +0 -1
- package/dist/utils/ssh-error-messages.d.ts.map +0 -1
- package/dist/utils/ssh-error-messages.js.map +0 -1
- package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
- package/dist/utils/vcs-provider-detect.js.map +0 -1
- package/dist/utils/work-folder-validation.d.ts.map +0 -1
- package/dist/utils/work-folder-validation.js.map +0 -1
- package/dist/utils/workspace-trust.d.ts.map +0 -1
- package/dist/utils/workspace-trust.js.map +0 -1
- package/dist/version.d.ts.map +0 -1
- package/dist/version.js.map +0 -1
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
export declare const OWN_BIBLE_REL = ".fleet/kb-canonical.json";
|
|
2
|
+
/**
|
|
3
|
+
* Bytes read from the object store do not hash to the blob id they were read
|
|
4
|
+
* by (replace ref, alternates, overwritten loose object, crafted pack). The
|
|
5
|
+
* caller must import nothing.
|
|
6
|
+
*/
|
|
7
|
+
export declare class BibleBlobIntegrityError extends Error {
|
|
8
|
+
readonly blobId: string;
|
|
9
|
+
readonly source: string;
|
|
10
|
+
constructor(blobId: string, source: string);
|
|
11
|
+
}
|
|
12
|
+
/** The git blob id of `bytes` in the given object format (40-hex sha1, 64-hex sha256). */
|
|
13
|
+
export declare function gitBlobId(bytes: Buffer, format: 'sha1' | 'sha256'): string;
|
|
14
|
+
/** True when `bytes` are exactly the blob `id` (format chosen by the id length). */
|
|
15
|
+
export declare function blobBytesMatchId(id: string, bytes: Buffer): boolean;
|
|
16
|
+
/**
|
|
17
|
+
* A git rev the caller may name for the own bible (kb_import `ref`): a ref
|
|
18
|
+
* name or HEAD, never an option (leading '-') and never a rev expression
|
|
19
|
+
* (no ':', '..', '@{', '^', '~', whitespace).
|
|
20
|
+
*/
|
|
21
|
+
export declare function isSafeBibleRef(ref: string): boolean;
|
|
22
|
+
/**
|
|
23
|
+
* The bible at `rel` (default the own bible, a path relative to `folder`) as
|
|
24
|
+
* committed at `ref` (default HEAD): its blob id and its bytes, read as ONE
|
|
25
|
+
* object (the id is resolved first and the bytes are read by that id, then
|
|
26
|
+
* hashed in-process against it -- see the header). `./` resolves the path
|
|
27
|
+
* against `folder`, which need not be the repository top level. null when
|
|
28
|
+
* there is no committed copy (unresolvable or unsafe ref, unborn HEAD,
|
|
29
|
+
* bible not tracked at that ref, not a work tree, git missing). Throws
|
|
30
|
+
* BibleBlobIntegrityError when the bytes do not hash to the id.
|
|
31
|
+
*/
|
|
32
|
+
export declare function readCommittedBibleBlob(folder: string, ref?: string, rel?: string): Promise<{
|
|
33
|
+
blobId: string;
|
|
34
|
+
text: string;
|
|
35
|
+
} | null>;
|
|
36
|
+
/**
|
|
37
|
+
* The blob id git would store for `bytes` committed unfiltered in the
|
|
38
|
+
* repository containing `folder`, computed in-process (`git hash-object
|
|
39
|
+
* --no-filters` semantics; the object format comes from the repository,
|
|
40
|
+
* sha1 outside one or when git is too old to report it -- such a git reads
|
|
41
|
+
* only sha1 repositories).
|
|
42
|
+
*/
|
|
43
|
+
export declare function bibleBytesBlobId(folder: string, bytes: Buffer): Promise<string>;
|
|
44
|
+
//# sourceMappingURL=bible-blob-id.d.ts.map
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
// Git blob ids of the own bible (.fleet/kb-canonical.json), for the kb_import
|
|
2
|
+
// trust anchor.
|
|
3
|
+
//
|
|
4
|
+
// A member session without the kb_maintainer grant imports only the committed
|
|
5
|
+
// bible at HEAD. The member controls its own .git, so "committed" alone proves
|
|
6
|
+
// nothing: it can commit a hand-made bible locally, import it, and reset the
|
|
7
|
+
// commit away. The trust decision is therefore taken against a record OUTSIDE
|
|
8
|
+
// the checkout: the per-repo KB database on the hub, where the maintainer side
|
|
9
|
+
// (kb_bible_commit and FULL / kb_maintainer kb_import) records the blob id of
|
|
10
|
+
// every bible it writes or imports (SqliteProvider.recordTrustedBibleBlob). A
|
|
11
|
+
// blob id is the git object id of the bible bytes ("blob <len>\0<bytes>",
|
|
12
|
+
// hashed with the repository's object format), so the id recorded for bytes
|
|
13
|
+
// the maintainer wrote equals the HEAD:path blob id of the same bytes in any
|
|
14
|
+
// clone that checks them out.
|
|
15
|
+
//
|
|
16
|
+
// ID-TO-BYTES BINDING: the object store is member-writable too. A replace ref
|
|
17
|
+
// (git replace <trusted> <forged>), an overwritten loose object, an alternates
|
|
18
|
+
// entry or a crafted pack can all make `git cat-file blob <trusted id>` return
|
|
19
|
+
// bytes that are NOT the trusted blob. So the bytes read for an id are hashed
|
|
20
|
+
// IN-PROCESS and refused unless they hash to exactly that id; git is asked
|
|
21
|
+
// with --no-replace-objects as well (belt and braces). Ids are likewise
|
|
22
|
+
// computed in-process from the exact bytes written or parsed, never by
|
|
23
|
+
// `git hash-object` on a path (that would re-read the file and run the
|
|
24
|
+
// checkout's member-configured clean filters).
|
|
25
|
+
//
|
|
26
|
+
// Every helper runs git with array args and no shell (same on every OS) and
|
|
27
|
+
// returns null rather than throwing when git cannot answer.
|
|
28
|
+
import { execFile } from 'node:child_process';
|
|
29
|
+
import { createHash } from 'node:crypto';
|
|
30
|
+
export const OWN_BIBLE_REL = '.fleet/kb-canonical.json';
|
|
31
|
+
function gitBuffer(args, cwd) {
|
|
32
|
+
return new Promise((resolve) => {
|
|
33
|
+
execFile('git', ['--no-replace-objects', ...args], {
|
|
34
|
+
cwd, windowsHide: true, timeout: 30_000, maxBuffer: 256 * 1024 * 1024, encoding: 'buffer',
|
|
35
|
+
}, (err, stdout) => resolve(err ? null : stdout));
|
|
36
|
+
});
|
|
37
|
+
}
|
|
38
|
+
async function git(args, cwd) {
|
|
39
|
+
const out = await gitBuffer(args, cwd);
|
|
40
|
+
return out === null ? null : out.toString('utf-8');
|
|
41
|
+
}
|
|
42
|
+
const OBJECT_ID = /^[0-9a-f]{40}([0-9a-f]{24})?$/;
|
|
43
|
+
/**
|
|
44
|
+
* Bytes read from the object store do not hash to the blob id they were read
|
|
45
|
+
* by (replace ref, alternates, overwritten loose object, crafted pack). The
|
|
46
|
+
* caller must import nothing.
|
|
47
|
+
*/
|
|
48
|
+
export class BibleBlobIntegrityError extends Error {
|
|
49
|
+
blobId;
|
|
50
|
+
source;
|
|
51
|
+
constructor(blobId, source) {
|
|
52
|
+
super(`the git object store returned bytes for ${source} (blob ${blobId}) that do not hash to that blob id -- a replace ref, an alternates entry, an overwritten loose object or a crafted pack is substituting the bible; nothing was imported`);
|
|
53
|
+
this.blobId = blobId;
|
|
54
|
+
this.source = source;
|
|
55
|
+
this.name = 'BibleBlobIntegrityError';
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
/** The git blob id of `bytes` in the given object format (40-hex sha1, 64-hex sha256). */
|
|
59
|
+
export function gitBlobId(bytes, format) {
|
|
60
|
+
return createHash(format)
|
|
61
|
+
.update(Buffer.from('blob ' + bytes.length + '\0', 'utf-8'))
|
|
62
|
+
.update(bytes)
|
|
63
|
+
.digest('hex');
|
|
64
|
+
}
|
|
65
|
+
/** True when `bytes` are exactly the blob `id` (format chosen by the id length). */
|
|
66
|
+
export function blobBytesMatchId(id, bytes) {
|
|
67
|
+
if (!OBJECT_ID.test(id))
|
|
68
|
+
return false;
|
|
69
|
+
return gitBlobId(bytes, id.length === 64 ? 'sha256' : 'sha1') === id;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* A git rev the caller may name for the own bible (kb_import `ref`): a ref
|
|
73
|
+
* name or HEAD, never an option (leading '-') and never a rev expression
|
|
74
|
+
* (no ':', '..', '@{', '^', '~', whitespace).
|
|
75
|
+
*/
|
|
76
|
+
export function isSafeBibleRef(ref) {
|
|
77
|
+
return /^[A-Za-z0-9_][A-Za-z0-9._/-]*$/.test(ref) && !ref.includes('..') && !ref.endsWith('/') && !ref.endsWith('.lock');
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* The bible at `rel` (default the own bible, a path relative to `folder`) as
|
|
81
|
+
* committed at `ref` (default HEAD): its blob id and its bytes, read as ONE
|
|
82
|
+
* object (the id is resolved first and the bytes are read by that id, then
|
|
83
|
+
* hashed in-process against it -- see the header). `./` resolves the path
|
|
84
|
+
* against `folder`, which need not be the repository top level. null when
|
|
85
|
+
* there is no committed copy (unresolvable or unsafe ref, unborn HEAD,
|
|
86
|
+
* bible not tracked at that ref, not a work tree, git missing). Throws
|
|
87
|
+
* BibleBlobIntegrityError when the bytes do not hash to the id.
|
|
88
|
+
*/
|
|
89
|
+
export async function readCommittedBibleBlob(folder, ref = 'HEAD', rel = OWN_BIBLE_REL) {
|
|
90
|
+
if (!isSafeBibleRef(ref))
|
|
91
|
+
return null;
|
|
92
|
+
const id = (await git(['rev-parse', '--verify', '--quiet', ref + ':./' + rel], folder))?.trim() ?? '';
|
|
93
|
+
if (!OBJECT_ID.test(id))
|
|
94
|
+
return null;
|
|
95
|
+
const bytes = await gitBuffer(['cat-file', 'blob', id], folder);
|
|
96
|
+
if (bytes === null)
|
|
97
|
+
return null;
|
|
98
|
+
if (!blobBytesMatchId(id, bytes))
|
|
99
|
+
throw new BibleBlobIntegrityError(id, ref + ':' + rel);
|
|
100
|
+
return { blobId: id, text: bytes.toString('utf-8') };
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* The blob id git would store for `bytes` committed unfiltered in the
|
|
104
|
+
* repository containing `folder`, computed in-process (`git hash-object
|
|
105
|
+
* --no-filters` semantics; the object format comes from the repository,
|
|
106
|
+
* sha1 outside one or when git is too old to report it -- such a git reads
|
|
107
|
+
* only sha1 repositories).
|
|
108
|
+
*/
|
|
109
|
+
export async function bibleBytesBlobId(folder, bytes) {
|
|
110
|
+
const fmt = (await git(['rev-parse', '--show-object-format'], folder))?.trim();
|
|
111
|
+
return gitBlobId(bytes, fmt === 'sha256' ? 'sha256' : 'sha1');
|
|
112
|
+
}
|
|
113
|
+
//# sourceMappingURL=bible-blob-id.js.map
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import type { SqliteProvider } from './sqlite-provider.js';
|
|
2
|
+
export type KbBibleErrorCode = 'E-BIBLE-MALFORMED';
|
|
3
|
+
/**
|
|
4
|
+
* A bible file that exists but cannot be read as a bible: invalid JSON, or a
|
|
5
|
+
* shape that is neither the legacy bare array nor the v2 { entries } envelope.
|
|
6
|
+
* Never treated as an empty bible.
|
|
7
|
+
*/
|
|
8
|
+
export declare class KbBibleError extends Error {
|
|
9
|
+
readonly code: KbBibleErrorCode;
|
|
10
|
+
readonly biblePath: string;
|
|
11
|
+
readonly remediation: string;
|
|
12
|
+
constructor(message: string, biblePath: string);
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Read and parse a bible file into its raw entry array. Throws KbBibleError
|
|
16
|
+
* when the file is not valid JSON or not a bible shape. `label` prefixes the
|
|
17
|
+
* error message (e.g. 'kb_import'). A missing file surfaces as the fs error;
|
|
18
|
+
* callers decide whether missing is an error (kb_import) or empty (the view).
|
|
19
|
+
*
|
|
20
|
+
* The bible has THREE on-disk shapes and must accept all of them.
|
|
21
|
+
* v1 (legacy): a bare JSON array of entries.
|
|
22
|
+
* v2: { version, provenance: {commit, branch, entry_count}, entries }
|
|
23
|
+
* v3: the v2 envelope; entries may carry source_file_hashes.
|
|
24
|
+
* Selection is on Array.isArray (v2 and v3 share the envelope). The reader
|
|
25
|
+
* must never lag the writer.
|
|
26
|
+
*/
|
|
27
|
+
export declare function readBibleEntries(biblePath: string, label: string): unknown[];
|
|
28
|
+
/** Parse bible text already in memory (e.g. fetched from a remote member). */
|
|
29
|
+
export declare function parseBibleText(raw: string, biblePath: string, label: string): unknown[];
|
|
30
|
+
/**
|
|
31
|
+
* The basis a v3 bible entry carries, or null when it carries none or an
|
|
32
|
+
* invalid one. Valid means: a plain object, at least one key, every key
|
|
33
|
+
* repo-relative (isRepoRelativePath), every value a non-empty string, and
|
|
34
|
+
* every cited source_file present as a key. Anything else gets no verified
|
|
35
|
+
* basis -- never a partial carried map: capture() then stores a LOCAL
|
|
36
|
+
* freshness-only basis that is never exported or used for bible admission.
|
|
37
|
+
*/
|
|
38
|
+
export declare function carriedBasisOf(entry: {
|
|
39
|
+
source_files?: unknown;
|
|
40
|
+
source_file_hashes?: unknown;
|
|
41
|
+
}): Record<string, string> | null;
|
|
42
|
+
export interface BibleImportCounts {
|
|
43
|
+
imported: number;
|
|
44
|
+
skipped: number;
|
|
45
|
+
linked: number;
|
|
46
|
+
flagged: number;
|
|
47
|
+
rejected: number;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Import raw bible entries into a SqliteProvider through capture()'s INTERNAL
|
|
51
|
+
* import mode: bible confidence preserved for non-directive types, directives
|
|
52
|
+
* quarantined as pending proposals, source='import'. Malformed entries and
|
|
53
|
+
* entries whose id already exists are skipped; entries failing the capture
|
|
54
|
+
* basis check are counted as rejected. No freshness sweep (callers decide).
|
|
55
|
+
*/
|
|
56
|
+
export interface BibleImportOptions {
|
|
57
|
+
/**
|
|
58
|
+
* Load every valid entry verbatim (no AUDN dedupe/update/contradiction):
|
|
59
|
+
* bible id and bible confidence kept exactly. For the member bible view,
|
|
60
|
+
* which must reproduce the reviewed bible rather than re-curate it.
|
|
61
|
+
*/
|
|
62
|
+
verbatim?: boolean;
|
|
63
|
+
}
|
|
64
|
+
export declare function importBibleEntries(provider: SqliteProvider, bibleEntries: unknown[], options?: BibleImportOptions): Promise<BibleImportCounts>;
|
|
65
|
+
//# sourceMappingURL=bible-import.d.ts.map
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
// Bible (.fleet/kb-canonical.json) parsing and import-mode loading, shared by
|
|
2
|
+
// kb_import (src/tools/kb-import.ts) and the member bible view
|
|
3
|
+
// (member-bible-view.ts). One parser and one capture path: the view must rank,
|
|
4
|
+
// quarantine directives and preserve bible confidence exactly as an import
|
|
5
|
+
// into the per-repo DB does, so it reuses this code rather than a copy.
|
|
6
|
+
import fs from 'node:fs';
|
|
7
|
+
import { KbCaptureRejected } from './types.js';
|
|
8
|
+
import { isRepoRelativePath } from './bible-basis-filter.js';
|
|
9
|
+
/**
|
|
10
|
+
* A bible file that exists but cannot be read as a bible: invalid JSON, or a
|
|
11
|
+
* shape that is neither the legacy bare array nor the v2 { entries } envelope.
|
|
12
|
+
* Never treated as an empty bible.
|
|
13
|
+
*/
|
|
14
|
+
export class KbBibleError extends Error {
|
|
15
|
+
code;
|
|
16
|
+
biblePath;
|
|
17
|
+
remediation;
|
|
18
|
+
constructor(message, biblePath) {
|
|
19
|
+
super(message);
|
|
20
|
+
this.name = 'KbBibleError';
|
|
21
|
+
this.code = 'E-BIBLE-MALFORMED';
|
|
22
|
+
this.biblePath = biblePath;
|
|
23
|
+
this.remediation = `Fix or regenerate '${biblePath}' (kb_export writes it), or restore it from git.`;
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Read and parse a bible file into its raw entry array. Throws KbBibleError
|
|
28
|
+
* when the file is not valid JSON or not a bible shape. `label` prefixes the
|
|
29
|
+
* error message (e.g. 'kb_import'). A missing file surfaces as the fs error;
|
|
30
|
+
* callers decide whether missing is an error (kb_import) or empty (the view).
|
|
31
|
+
*
|
|
32
|
+
* The bible has THREE on-disk shapes and must accept all of them.
|
|
33
|
+
* v1 (legacy): a bare JSON array of entries.
|
|
34
|
+
* v2: { version, provenance: {commit, branch, entry_count}, entries }
|
|
35
|
+
* v3: the v2 envelope; entries may carry source_file_hashes.
|
|
36
|
+
* Selection is on Array.isArray (v2 and v3 share the envelope). The reader
|
|
37
|
+
* must never lag the writer.
|
|
38
|
+
*/
|
|
39
|
+
export function readBibleEntries(biblePath, label) {
|
|
40
|
+
return parseBibleText(fs.readFileSync(biblePath, 'utf-8'), biblePath, label);
|
|
41
|
+
}
|
|
42
|
+
/** Parse bible text already in memory (e.g. fetched from a remote member). */
|
|
43
|
+
export function parseBibleText(raw, biblePath, label) {
|
|
44
|
+
if (raw.charCodeAt(0) === 0xfeff)
|
|
45
|
+
raw = raw.slice(1);
|
|
46
|
+
let parsed;
|
|
47
|
+
try {
|
|
48
|
+
parsed = JSON.parse(raw);
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
throw new KbBibleError(`${label}: bible file is not valid JSON: ${biblePath}`, biblePath);
|
|
52
|
+
}
|
|
53
|
+
const entries = Array.isArray(parsed)
|
|
54
|
+
? parsed
|
|
55
|
+
: (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries))
|
|
56
|
+
? parsed.entries
|
|
57
|
+
: null;
|
|
58
|
+
if (entries === null) {
|
|
59
|
+
throw new KbBibleError(`${label}: bible file is not a JSON array of entries: ${biblePath}`, biblePath);
|
|
60
|
+
}
|
|
61
|
+
return entries;
|
|
62
|
+
}
|
|
63
|
+
const VALID_TYPES = ['context-cache', 'learning', 'knowledge', 'runbook', 'user-directive'];
|
|
64
|
+
const VALID_CONFIDENCE = ['CONFIRMED', 'INFERRED', 'UNVERIFIED'];
|
|
65
|
+
/**
|
|
66
|
+
* The basis a v3 bible entry carries, or null when it carries none or an
|
|
67
|
+
* invalid one. Valid means: a plain object, at least one key, every key
|
|
68
|
+
* repo-relative (isRepoRelativePath), every value a non-empty string, and
|
|
69
|
+
* every cited source_file present as a key. Anything else gets no verified
|
|
70
|
+
* basis -- never a partial carried map: capture() then stores a LOCAL
|
|
71
|
+
* freshness-only basis that is never exported or used for bible admission.
|
|
72
|
+
*/
|
|
73
|
+
export function carriedBasisOf(entry) {
|
|
74
|
+
const raw = entry.source_file_hashes;
|
|
75
|
+
if (!raw || typeof raw !== 'object' || Array.isArray(raw))
|
|
76
|
+
return null;
|
|
77
|
+
const map = raw;
|
|
78
|
+
const keys = Object.keys(map);
|
|
79
|
+
if (keys.length === 0)
|
|
80
|
+
return null;
|
|
81
|
+
const out = {};
|
|
82
|
+
for (const key of keys.sort()) {
|
|
83
|
+
if (!isRepoRelativePath(key))
|
|
84
|
+
return null;
|
|
85
|
+
const value = map[key];
|
|
86
|
+
if (typeof value !== 'string' || value.length === 0)
|
|
87
|
+
return null;
|
|
88
|
+
out[key] = value;
|
|
89
|
+
}
|
|
90
|
+
const files = Array.isArray(entry.source_files) ? entry.source_files : [];
|
|
91
|
+
for (const file of files) {
|
|
92
|
+
if (typeof file !== 'string' || !Object.prototype.hasOwnProperty.call(out, file))
|
|
93
|
+
return null;
|
|
94
|
+
}
|
|
95
|
+
return out;
|
|
96
|
+
}
|
|
97
|
+
// Validate a single parsed bible entry against the exported CanonicalEntry field
|
|
98
|
+
// set {id, type, title, summary, symbols, source_files, confidence, updated_at}
|
|
99
|
+
// (KB b9df569a -- NOTE: no content field). Malformed entries are tolerated and
|
|
100
|
+
// skipped individually rather than aborting the whole import.
|
|
101
|
+
function isValidBibleEntry(e) {
|
|
102
|
+
if (!e || typeof e !== 'object')
|
|
103
|
+
return false;
|
|
104
|
+
const r = e;
|
|
105
|
+
if (typeof r.id !== 'string' || r.id.length === 0)
|
|
106
|
+
return false;
|
|
107
|
+
if (typeof r.type !== 'string' || !VALID_TYPES.includes(r.type))
|
|
108
|
+
return false;
|
|
109
|
+
if (typeof r.title !== 'string' || r.title.length === 0)
|
|
110
|
+
return false;
|
|
111
|
+
if (typeof r.summary !== 'string' || r.summary.length === 0)
|
|
112
|
+
return false;
|
|
113
|
+
if (typeof r.confidence !== 'string' || !VALID_CONFIDENCE.includes(r.confidence))
|
|
114
|
+
return false;
|
|
115
|
+
if (r.symbols !== undefined && !Array.isArray(r.symbols))
|
|
116
|
+
return false;
|
|
117
|
+
if (r.source_files !== undefined && !Array.isArray(r.source_files))
|
|
118
|
+
return false;
|
|
119
|
+
return true;
|
|
120
|
+
}
|
|
121
|
+
// LOW-2: bible entries carry no content field, so synthesize content
|
|
122
|
+
// DETERMINISTICALLY from the summary. Determinism matters twice: (1) a re-import
|
|
123
|
+
// of the same bible produces byte-identical content so AUDN's content-equality
|
|
124
|
+
// 'none' path can dedupe an id-collision-with-identical-content case; (2) it
|
|
125
|
+
// keeps import a pure function of the bible file.
|
|
126
|
+
function synthesizeContent(entry) {
|
|
127
|
+
return entry.summary;
|
|
128
|
+
}
|
|
129
|
+
export async function importBibleEntries(provider, bibleEntries, options = {}) {
|
|
130
|
+
let imported = 0;
|
|
131
|
+
let skipped = 0;
|
|
132
|
+
let linked = 0;
|
|
133
|
+
let flagged = 0;
|
|
134
|
+
let rejected = 0;
|
|
135
|
+
for (const candidate of bibleEntries) {
|
|
136
|
+
// Malformed entry -> tolerate and skip individually.
|
|
137
|
+
if (!isValidBibleEntry(candidate)) {
|
|
138
|
+
skipped++;
|
|
139
|
+
continue;
|
|
140
|
+
}
|
|
141
|
+
const entry = candidate;
|
|
142
|
+
// ORDER OF OPERATIONS (LOW-2): id-exists check FIRST, before capture()/AUDN.
|
|
143
|
+
// This is what makes re-import EXACT even for symbol-less/file-less entries
|
|
144
|
+
// AUDN can never dedupe.
|
|
145
|
+
if (provider.hasEntry(entry.id)) {
|
|
146
|
+
skipped++;
|
|
147
|
+
continue;
|
|
148
|
+
}
|
|
149
|
+
const kbInput = {
|
|
150
|
+
type: entry.type,
|
|
151
|
+
title: entry.title,
|
|
152
|
+
summary: entry.summary,
|
|
153
|
+
content: synthesizeContent(entry),
|
|
154
|
+
source_files: entry.source_files ?? [],
|
|
155
|
+
symbols: entry.symbols ?? [],
|
|
156
|
+
tags: [],
|
|
157
|
+
content_hash: '',
|
|
158
|
+
content_hash_type: 'sha256',
|
|
159
|
+
flagged_for_review: false,
|
|
160
|
+
// Bible entries carry no author; the trusted channel is the provenance.
|
|
161
|
+
author: 'unknown',
|
|
162
|
+
source: 'import',
|
|
163
|
+
confidence: entry.confidence,
|
|
164
|
+
scope: 'project',
|
|
165
|
+
};
|
|
166
|
+
// Route through the AUDN choke point with the INTERNAL import mode and the
|
|
167
|
+
// preserved bible id. A user-directive is still forced through the directive
|
|
168
|
+
// gate (pending proposal) INSIDE capture() -- import mode does not bypass it.
|
|
169
|
+
// KB-TRUST PHASE 1: isolate each entry so one unfalsifiable bible entry is
|
|
170
|
+
// counted and the import continues, rather than aborting every entry after
|
|
171
|
+
// it. Import mode exempts the confidence clamp, never the basis check.
|
|
172
|
+
//
|
|
173
|
+
// Bible format v3: the entry's carried basis is stored EXACTLY (capture
|
|
174
|
+
// does not hash this clone's files for it). A v1/v2 entry, or one whose
|
|
175
|
+
// carried map is invalid (carriedBasis null), gets a LOCAL freshness-only
|
|
176
|
+
// basis hashed from this clone: it can go stale when code drifts, but the
|
|
177
|
+
// bible predicate never sees it, so the entry is not re-exported until it
|
|
178
|
+
// is recaptured.
|
|
179
|
+
let audn_decision;
|
|
180
|
+
try {
|
|
181
|
+
({ audn_decision } = await provider.capture(kbInput, {
|
|
182
|
+
importMode: true,
|
|
183
|
+
preferredId: entry.id,
|
|
184
|
+
verbatim: options.verbatim === true,
|
|
185
|
+
carriedBasis: carriedBasisOf(entry),
|
|
186
|
+
}));
|
|
187
|
+
}
|
|
188
|
+
catch (err) {
|
|
189
|
+
if (err instanceof KbCaptureRejected) {
|
|
190
|
+
rejected++;
|
|
191
|
+
continue;
|
|
192
|
+
}
|
|
193
|
+
throw err;
|
|
194
|
+
}
|
|
195
|
+
if (audn_decision === 'add')
|
|
196
|
+
imported++;
|
|
197
|
+
else if (audn_decision === 'none')
|
|
198
|
+
skipped++;
|
|
199
|
+
// AUDN 'update' means the entry was linked to a same-topic predecessor and
|
|
200
|
+
// BOTH stay live -- supersede is opt-in (input.supersedes) and kb_import
|
|
201
|
+
// never sets it, because a bible authored on another branch cannot name a
|
|
202
|
+
// local entry's id. Counting these as "superseded" reported a retirement
|
|
203
|
+
// that never happened.
|
|
204
|
+
else if (audn_decision === 'update')
|
|
205
|
+
linked++;
|
|
206
|
+
else if (audn_decision === 'flagged')
|
|
207
|
+
flagged++;
|
|
208
|
+
}
|
|
209
|
+
return { imported, skipped, linked, flagged, rejected };
|
|
210
|
+
}
|
|
211
|
+
//# sourceMappingURL=bible-import.js.map
|
|
@@ -8,4 +8,35 @@ export declare function computeFileHashBatch(filePaths: string[], opts?: {
|
|
|
8
8
|
cwd?: string;
|
|
9
9
|
}): Promise<Record<string, FileHashResult | null>>;
|
|
10
10
|
export declare function checkStaleness(entry: KBEntry): Promise<StalenessResult>;
|
|
11
|
+
/**
|
|
12
|
+
* The repo folder a HEAD-anchored hash was asked for is not inside a git work
|
|
13
|
+
* tree. Thrown instead of silently falling back to hashing files on disk:
|
|
14
|
+
* a disk hash is a working-tree hash, not a branch-HEAD hash.
|
|
15
|
+
*/
|
|
16
|
+
export declare class KbHeadHashError extends Error {
|
|
17
|
+
readonly code: "E-BIBLE-BASIS-NOT-GIT";
|
|
18
|
+
readonly folder: string;
|
|
19
|
+
readonly remediation: string;
|
|
20
|
+
constructor(folder: string, detail: string);
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Hash each file's content AT THE WORK TREE'S HEAD COMMIT (not the file on
|
|
24
|
+
* disk), keyed by the original path strings. Relative paths resolve against
|
|
25
|
+
* `cwd`, exactly as computeFileHashBatch({ cwd }) resolves them.
|
|
26
|
+
*
|
|
27
|
+
* Digest: the git blob id of HEAD:<path>. That is the same digest the stored
|
|
28
|
+
* basis carries -- computeFileHashBatch runs `git hash-object <file>`, which
|
|
29
|
+
* applies the same clean filters as `git add`, so a file whose on-disk content
|
|
30
|
+
* equals its HEAD content hashes to the HEAD blob id. Uncommitted edits
|
|
31
|
+
* therefore never change the result.
|
|
32
|
+
*
|
|
33
|
+
* A file absent at HEAD (untracked, deleted, a directory, a submodule) maps to
|
|
34
|
+
* null. An unborn HEAD (no commit yet) maps every file to null. A `cwd` that is
|
|
35
|
+
* not inside a git work tree throws KbHeadHashError -- never a disk fallback.
|
|
36
|
+
* Absolute paths are not supported (they map to null): HEAD content is only
|
|
37
|
+
* addressable repo-relatively.
|
|
38
|
+
*/
|
|
39
|
+
export declare function computeHeadFileHashBatch(filePaths: string[], opts: {
|
|
40
|
+
cwd: string;
|
|
41
|
+
}): Promise<Record<string, FileHashResult | null>>;
|
|
11
42
|
//# sourceMappingURL=file-hash.d.ts.map
|