@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -38,6 +38,26 @@ class NotImplementedError extends Error {
38
38
  this.name = 'NotImplementedError';
39
39
  }
40
40
  }
41
+ // SQL for the opt-in retrieval-trust filters (QueryOptions.confidence /
42
+ // exclude_disputed), shared by query() and relatedClaims() so the direct hits
43
+ // and the graph-expanded claims of one kb_query obey the same rule. An empty
44
+ // or absent filter yields no conditions -- the default-off contract.
45
+ function trustFilterSql(filter) {
46
+ const conditions = [];
47
+ const params = [];
48
+ if (filter?.confidence?.length) {
49
+ conditions.push(`e.confidence IN (${filter.confidence.map(() => '?').join(',')})`);
50
+ params.push(...filter.confidence);
51
+ }
52
+ if (filter?.exclude_disputed) {
53
+ conditions.push('e.flagged_for_review = 0 AND e.contradiction_of IS NULL');
54
+ }
55
+ if (filter?.owner_tag) {
56
+ conditions.push('EXISTS (SELECT 1 FROM json_each(e.tags) WHERE value = ?)');
57
+ params.push(filter.owner_tag);
58
+ }
59
+ return { conditions, params };
60
+ }
41
61
  export class SqliteProvider {
42
62
  db = null;
43
63
  dbPath;
@@ -64,6 +84,15 @@ export class SqliteProvider {
64
84
  this.dbPath = path.join(dir, 'kb.sqlite');
65
85
  }
66
86
  }
87
+ /**
88
+ * Re-anchor after loading. Used only by the remote member bible view: the
89
+ * member's checkout is not on this host, so entries are imported with no
90
+ * anchor (the basis gate cannot check files here), then the remote folder is
91
+ * bound so freshness reads treat the anchor as missing and issue no verdict.
92
+ */
93
+ bindRepoPath(repoPath) {
94
+ this.repoPath = repoPath;
95
+ }
67
96
  async init() {
68
97
  if (this.db !== null)
69
98
  return;
@@ -158,6 +187,59 @@ export class SqliteProvider {
158
187
  this.db.exec("ALTER TABLE entries ADD COLUMN source_file_hashes TEXT NOT NULL DEFAULT '{}'");
159
188
  }
160
189
  catch { }
190
+ // Why a row was retired (superseded_at set): 'superseded' (a contradiction
191
+ // loser, or replaced by a capture naming it in supersedes) or 'invalidated'
192
+ // (discarded by id through kb_invalidate). superseded_at alone cannot tell
193
+ // the two apart, and kb_bible_commit reports the reason for each bible
194
+ // entry it removes. Internal only: never surfaced on KBEntry. Rows retired
195
+ // before this column existed read NULL and count as 'superseded'.
196
+ try {
197
+ this.db.exec('ALTER TABLE entries ADD COLUMN retired_reason TEXT');
198
+ }
199
+ catch { }
200
+ // Legacy bible import (v1/v2 entry, or a v3 entry without a valid carried
201
+ // map): source_file_hashes then holds THIS clone's file hashes, a
202
+ // freshness-only basis. 1 = that basis feeds staleness checks only and is
203
+ // never exported, never used for bible admission, never used for a
204
+ // mechanical contradiction win (getSourceFileBases / reconcile prefilter
205
+ // read it as no basis). Internal only: never surfaced on KBEntry. Existing
206
+ // rows default to 0.
207
+ try {
208
+ this.db.exec('ALTER TABLE entries ADD COLUMN local_basis_only INTEGER NOT NULL DEFAULT 0');
209
+ }
210
+ catch { }
211
+ // kb_import trust anchor: git blob ids of bibles the maintainer side wrote
212
+ // or imported (kb_bible_commit and FULL / kb_maintainer kb_import). A
213
+ // member session without the kb_maintainer grant imports its committed
214
+ // bible only when that bible's blob id is recorded here -- this hub-side
215
+ // database is the one place the member's own checkout cannot write. See
216
+ // services/knowledge/bible-blob-id.ts. Created idempotently; existing DBs
217
+ // start with no rows (a fresh hub is seeded by the maintainer side).
218
+ this.db.exec(`
219
+ CREATE TABLE IF NOT EXISTS trusted_bible_blobs (
220
+ blob_id TEXT PRIMARY KEY,
221
+ source TEXT NOT NULL,
222
+ recorded_at TEXT NOT NULL
223
+ );
224
+ `);
225
+ }
226
+ /**
227
+ * Record `blobId` (a git object id of a bible's bytes) as written or
228
+ * imported by the maintainer side. Idempotent: re-recording keeps the first
229
+ * row. Only trusted callers (kb_bible_commit and kb_import from a FULL or
230
+ * kb_maintainer session) may call this.
231
+ */
232
+ recordTrustedBibleBlob(blobId, source) {
233
+ this.getDb()
234
+ .prepare('INSERT OR IGNORE INTO trusted_bible_blobs (blob_id, source, recorded_at) VALUES (?, ?, ?)')
235
+ .run(blobId.toLowerCase(), source, new Date().toISOString());
236
+ }
237
+ /** True when `blobId` was recorded by recordTrustedBibleBlob. */
238
+ isTrustedBibleBlob(blobId) {
239
+ const row = this.getDb()
240
+ .prepare('SELECT 1 AS ok FROM trusted_bible_blobs WHERE blob_id = ?')
241
+ .get(blobId.toLowerCase());
242
+ return row !== undefined;
161
243
  }
162
244
  getDb() {
163
245
  if (!this.db)
@@ -191,7 +273,7 @@ export class SqliteProvider {
191
273
  last_accessed: row.last_accessed,
192
274
  };
193
275
  }
194
- insertEntry(db, id, input, content, now, sourceFileHashes = {}) {
276
+ insertEntry(db, id, input, content, now, sourceFileHashes = {}, localBasisOnly = false) {
195
277
  db.prepare(`
196
278
  INSERT INTO entries (
197
279
  id, type, title, summary, content,
@@ -199,7 +281,7 @@ export class SqliteProvider {
199
281
  content_hash, content_hash_type, stale,
200
282
  flagged_for_review, contradiction_of,
201
283
  author, source, confidence, scope, created_at,
202
- source_file_hashes,
284
+ source_file_hashes, local_basis_only,
203
285
  superseded_at, promoted_at, use_count
204
286
  ) VALUES (
205
287
  ?, ?, ?, ?, ?,
@@ -207,10 +289,10 @@ export class SqliteProvider {
207
289
  ?, ?, ?,
208
290
  ?, ?,
209
291
  ?, ?, ?, ?, ?,
210
- ?,
292
+ ?, ?,
211
293
  NULL, NULL, 0
212
294
  )
213
- `).run(id, input.type, input.title, input.summary, content, JSON.stringify(input.source_files ?? []), JSON.stringify(input.symbols ?? []), input.module ?? null, JSON.stringify(input.tags ?? []), input.content_hash ?? '', input.content_hash_type ?? 'sha256', 0, input.flagged_for_review ? 1 : 0, input.contradiction_of ?? null, input.author ?? '', input.source, input.confidence, input.scope ?? 'project', now, JSON.stringify(sourceFileHashes));
295
+ `).run(id, input.type, input.title, input.summary, content, JSON.stringify(input.source_files ?? []), JSON.stringify(input.symbols ?? []), input.module ?? null, JSON.stringify(input.tags ?? []), input.content_hash ?? '', input.content_hash_type ?? 'sha256', 0, input.flagged_for_review ? 1 : 0, input.contradiction_of ?? null, input.author ?? '', input.source, input.confidence, input.scope ?? 'project', now, JSON.stringify(sourceFileHashes), localBasisOnly ? 1 : 0);
214
296
  }
215
297
  /**
216
298
  * Resolve a source_files entry for existence checking. Absolute paths pass
@@ -286,13 +368,21 @@ export class SqliteProvider {
286
368
  // absent from the returned map (not an error). Bounded to the caller's own
287
369
  // source_files list. Non-fatal: any hashing error yields an empty basis
288
370
  // rather than failing the capture.
371
+ /**
372
+ * The ONLY way this provider hashes source files: relative paths anchor at
373
+ * the provider repo (never process.cwd()) when one is set. Every call site
374
+ * goes through here so a new call cannot forget the anchor.
375
+ */
376
+ hashAnchored(files, anchor = this.repoPath) {
377
+ return computeFileHashBatch(files, anchor !== undefined ? { cwd: anchor } : undefined);
378
+ }
289
379
  async computeSourceFileHashes(files) {
290
380
  if (files.length === 0)
291
381
  return {};
292
382
  try {
293
383
  // Anchor relative basis paths at this provider's repo, the same root the
294
384
  // capture gate checked them against and the one freshnessSweep(root) uses.
295
- const hashes = await computeFileHashBatch(files, this.repoPath !== undefined ? { cwd: this.repoPath } : undefined);
385
+ const hashes = await this.hashAnchored(files);
296
386
  const map = {};
297
387
  for (const file of Object.keys(hashes)) {
298
388
  const result = hashes[file];
@@ -380,6 +470,33 @@ export class SqliteProvider {
380
470
  return null;
381
471
  }
382
472
  }
473
+ /**
474
+ * Read-only accessor for the stored per-file hash basis (source_file_hashes)
475
+ * of the given entry ids. Each requested id maps to its parsed basis, or null
476
+ * when the basis is empty/unparseable or the id is unknown. Used by kb_export's
477
+ * project-scope bible filter and kb_bible_commit admission; internal to this
478
+ * provider, not an MCP surface. A local freshness-only basis
479
+ * (local_basis_only = 1, a legacy bible import) maps to null: it was hashed
480
+ * from this clone, never verified, so it must never be exported or admit an
481
+ * entry to the bible.
482
+ */
483
+ getSourceFileBases(ids) {
484
+ const out = new Map();
485
+ for (const id of ids)
486
+ out.set(id, null);
487
+ if (ids.length === 0)
488
+ return out;
489
+ const db = this.getDb();
490
+ // Chunk to stay well under SQLite's bound-parameter limit.
491
+ const CHUNK = 500;
492
+ for (let i = 0; i < ids.length; i += CHUNK) {
493
+ const chunk = ids.slice(i, i + CHUNK);
494
+ const rows = db.prepare(`SELECT id, source_file_hashes, local_basis_only FROM entries WHERE id IN (${chunk.map(() => '?').join(',')})`).all(...chunk);
495
+ for (const row of rows)
496
+ out.set(row.id, row.local_basis_only ? null : this.parseBasis(row.source_file_hashes));
497
+ }
498
+ return out;
499
+ }
383
500
  // T1.3 (F2/D2 HARDENED): freshness check bounded to the primed set, now
384
501
  // BIDIRECTIONAL. Keyed off source_files with a per-file hash basis persisted
385
502
  // at capture time (source_file_hashes) -- NOT content_hash, which is only ever
@@ -429,7 +546,7 @@ export class SqliteProvider {
429
546
  // whenever the process cwd is not the repo -- which is the normal case in
430
547
  // the long-lived fleet server -- so every relative basis path would re-hash
431
548
  // to a different value and prime would stale healthy entries on sight.
432
- const currentHashes = await computeFileHashBatch([...fileSet], this.repoPath !== undefined ? { cwd: this.repoPath } : undefined);
549
+ const currentHashes = await this.hashAnchored([...fileSet]);
433
550
  const staleIds = [];
434
551
  const unstaleIds = [];
435
552
  for (const [id, basis] of basisById) {
@@ -514,7 +631,7 @@ export class SqliteProvider {
514
631
  for (const file of Object.keys(basis))
515
632
  fileSet.add(file);
516
633
  }
517
- const currentHashes = await computeFileHashBatch([...fileSet], anchor ? { cwd: anchor } : undefined);
634
+ const currentHashes = await this.hashAnchored([...fileSet], anchor || undefined);
518
635
  const staleIds = [];
519
636
  const unstaleIds = [];
520
637
  let checked = 0;
@@ -569,7 +686,7 @@ export class SqliteProvider {
569
686
  return [];
570
687
  }
571
688
  }
572
- evaluateAudn(db, input, candidates, newContent, now, sourceFileHashes) {
689
+ evaluateAudn(db, input, candidates, newContent, now, sourceFileHashes, localBasisOnly = false, keepConfirmed = false) {
573
690
  const decision = makeAudnDecision(input, candidates, newContent);
574
691
  if (!decision)
575
692
  return null;
@@ -579,13 +696,20 @@ export class SqliteProvider {
579
696
  if (decision.decision === 'flagged') {
580
697
  db.prepare('UPDATE entries SET flagged_for_review = 1 WHERE id = ?').run(decision.matchedId);
581
698
  const newId = randomUUID();
582
- this.insertEntry(db, newId, { ...input, ...decision.newEntryOverrides }, newContent, now, sourceFileHashes);
699
+ this.insertEntry(db, newId, { ...input, ...decision.newEntryOverrides }, newContent, now, sourceFileHashes, localBasisOnly);
583
700
  this.wireLinks(db, newId, input);
584
701
  return { id: newId, audn_decision: 'flagged' };
585
702
  }
586
703
  if (decision.decision === 'update') {
587
704
  const newId = randomUUID();
588
- if (input.supersedes === decision.matchedId) {
705
+ // keepConfirmed (a member session without the kb_maintainer grant): a
706
+ // CONFIRMED target is never retired by supersedes -- retiring it would
707
+ // remove it from the bible at the next kb_bible_commit. The capture
708
+ // takes the IMPLICIT path below instead (both live, 'refines' link) and
709
+ // the target id is reported, mirroring kb_invalidate's keepConfirmed.
710
+ const target = candidates.find(c => c.id === decision.matchedId);
711
+ const supersedeRefused = keepConfirmed && input.supersedes === decision.matchedId && target?.confidence === 'CONFIRMED';
712
+ if (input.supersedes === decision.matchedId && !supersedeRefused) {
589
713
  // EXPLICIT: the caller named what it replaces and AUDN independently
590
714
  // matched it. Retire it exactly as before -- superseded_at + stale = 1.
591
715
  // D2 (F2a): both flags are required so the old row is excluded from
@@ -594,9 +718,9 @@ export class SqliteProvider {
594
718
  // flagged_for_review is deliberately NOT cleared here; that is
595
719
  // resolveContradiction's behavior, and kb-review.md depends on the
596
720
  // difference (a kept entry stays listed under flagged_only).
597
- db.prepare('UPDATE entries SET superseded_at = ?, stale = 1 WHERE id = ?')
721
+ db.prepare("UPDATE entries SET superseded_at = ?, stale = 1, retired_reason = 'superseded' WHERE id = ?")
598
722
  .run(now, decision.matchedId);
599
- this.insertEntry(db, newId, input, newContent, now, sourceFileHashes);
723
+ this.insertEntry(db, newId, input, newContent, now, sourceFileHashes, localBasisOnly);
600
724
  this.wireLinks(db, newId, input);
601
725
  return { id: newId, audn_decision: 'update' };
602
726
  }
@@ -604,10 +728,12 @@ export class SqliteProvider {
604
728
  // That is a topicality signal, not consent to destroy -- two DISTINCT
605
729
  // facts about one symbol used to eat each other. Link and keep both;
606
730
  // curation retires what it means to retire, explicitly.
607
- this.insertEntry(db, newId, input, newContent, now, sourceFileHashes);
731
+ this.insertEntry(db, newId, input, newContent, now, sourceFileHashes, localBasisOnly);
608
732
  this.wireLinks(db, newId, input);
609
733
  db.prepare('INSERT OR IGNORE INTO links (from_id, to_id, link_type) VALUES (?, ?, ?)').run(newId, decision.matchedId, 'refines');
610
- return { id: newId, audn_decision: 'update' };
734
+ return supersedeRefused
735
+ ? { id: newId, audn_decision: 'update', refused: [decision.matchedId] }
736
+ : { id: newId, audn_decision: 'update' };
611
737
  }
612
738
  return null;
613
739
  }
@@ -764,10 +890,28 @@ export class SqliteProvider {
764
890
  // T2.2 (F3 PART A): capture() is the single choke point every caller
765
891
  // (kb_capture, kb_harvest, future paths) goes through, so every entry
766
892
  // gets a hash basis here regardless of type.
767
- const sourceFileHashes = await this.computeSourceFileHashes(input.source_files ?? []);
768
- const candidates = this.findAudnCandidates(db, input);
893
+ //
894
+ // Bible format v3: an IMPORT carrying a basis (opts.carriedBasis, honoured
895
+ // only under importMode, which no deserialized route can set) stores that
896
+ // map verbatim instead -- the basis the entry was verified against on the
897
+ // exporting clone. carriedBasis null (a v1/v2 entry, or an invalid carried
898
+ // map) hashes this clone's files into a LOCAL freshness-only basis
899
+ // (local_basis_only = 1): it lets the entry go stale when code drifts, but
900
+ // is never exported, never admits it to the bible and never wins a
901
+ // contradiction mechanically. Normal captures are unaffected.
902
+ const carried = opts?.importMode === true && opts.carriedBasis !== undefined;
903
+ const localBasisOnly = carried && opts?.carriedBasis === null;
904
+ const sourceFileHashes = carried && !localBasisOnly
905
+ ? { ...(opts?.carriedBasis ?? {}) }
906
+ : await this.computeSourceFileHashes(input.source_files ?? []);
907
+ // Verbatim (member bible view): the bible was reviewed and merged as a
908
+ // whole; AUDN against its own sibling entries would flag, re-id and
909
+ // demote them (a contradiction keyword in one summary disputes another
910
+ // CONFIRMED entry). Skip AUDN and keep the bible id.
911
+ const verbatim = opts?.verbatim === true && opts.importMode === true && opts.preferredId !== undefined;
912
+ const candidates = verbatim ? [] : this.findAudnCandidates(db, input);
769
913
  if (candidates.length > 0) {
770
- const result = this.evaluateAudn(db, input, candidates, content, now, sourceFileHashes);
914
+ const result = this.evaluateAudn(db, input, candidates, content, now, sourceFileHashes, localBasisOnly, opts?.keepConfirmed === true);
771
915
  if (result)
772
916
  return result;
773
917
  }
@@ -778,7 +922,7 @@ export class SqliteProvider {
778
922
  // always mint a fresh randomUUID -- an id collision with different content is
779
923
  // resolved by AUDN under a new id, never by overwriting the preserved id.
780
924
  const id = opts?.preferredId ?? randomUUID();
781
- this.insertEntry(db, id, input, content, now, sourceFileHashes);
925
+ this.insertEntry(db, id, input, content, now, sourceFileHashes, localBasisOnly);
782
926
  this.wireLinks(db, id, input);
783
927
  return { id, audn_decision: 'add' };
784
928
  }
@@ -858,6 +1002,11 @@ export class SqliteProvider {
858
1002
  conditions.push('(e.flagged_for_review = 1 OR e.contradiction_of IS NOT NULL)');
859
1003
  }
860
1004
  else {
1005
+ // Retrieval-trust filters (opt-in). Not applied to flagged_only, whose
1006
+ // whole purpose is listing the disputed entries these would drop.
1007
+ const trust = trustFilterSql(opts);
1008
+ conditions.push(...trust.conditions);
1009
+ params.push(...trust.params);
861
1010
  // H2 (F1, D1, closes yashr-9ha): default retrieval NEVER surfaces a
862
1011
  // pending or rejected directive PROPOSAL (type='user-directive' with
863
1012
  // confidence != 'CONFIRMED'). Only an ACTIVE (CONFIRMED) directive
@@ -913,24 +1062,32 @@ export class SqliteProvider {
913
1062
  }
914
1063
  return { results, total: results.length, l1_only: opts.l1_only ?? false };
915
1064
  }
916
- async context(files) {
1065
+ async context(files, confidence, excludeDisputed, ownerTag) {
917
1066
  const db = this.getDb();
918
1067
  const results = [];
1068
+ const confClause = (confidence?.length
1069
+ ? `AND confidence IN (${confidence.map(() => '?').join(',')})`
1070
+ : '') + (excludeDisputed ? ' AND flagged_for_review = 0 AND contradiction_of IS NULL' : '')
1071
+ + (ownerTag ? ' AND EXISTS (SELECT 1 FROM json_each(tags) WHERE value = ?)' : '');
1072
+ const confParams = confidence?.length ? [...confidence] : [];
1073
+ if (ownerTag)
1074
+ confParams.push(ownerTag);
919
1075
  const fileEntries = new Map();
920
1076
  for (const file of files) {
921
1077
  const rows = db.prepare(`
922
1078
  SELECT * FROM entries
923
1079
  WHERE type = 'context-cache'
924
1080
  AND superseded_at IS NULL
1081
+ ${confClause}
925
1082
  AND EXISTS (SELECT 1 FROM json_each(source_files) WHERE value = ?)
926
1083
  ORDER BY created_at DESC
927
1084
  LIMIT 1
928
- `).all(file);
1085
+ `).all(...confParams, file);
929
1086
  if (rows.length > 0) {
930
1087
  fileEntries.set(file, this.rowToEntry(rows[0]));
931
1088
  }
932
1089
  }
933
- const hashes = await computeFileHashBatch(files);
1090
+ const hashes = await this.hashAnchored(files);
934
1091
  for (const file of files) {
935
1092
  const entry = fileEntries.get(file);
936
1093
  if (!entry) {
@@ -961,18 +1118,89 @@ export class SqliteProvider {
961
1118
  }
962
1119
  return results;
963
1120
  }
964
- async invalidate(files) {
1121
+ async discard(ids, opts) {
1122
+ const db = this.getDb();
1123
+ const result = { discarded: [], not_found: [], already_discarded: [] };
1124
+ if (opts?.keepConfirmed)
1125
+ result.refused = [];
1126
+ const now = new Date().toISOString();
1127
+ for (const id of new Set(ids)) {
1128
+ const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
1129
+ // An entry outside the caller's own scope is indistinguishable from an unknown id.
1130
+ if (!row || (opts?.ownerTag && !this.rowToEntry(row).tags.includes(opts.ownerTag))) {
1131
+ result.not_found.push(id);
1132
+ continue;
1133
+ }
1134
+ if (row.superseded_at) {
1135
+ result.already_discarded.push(id);
1136
+ continue;
1137
+ }
1138
+ // A member session without the kb_maintainer grant may not retire a
1139
+ // CONFIRMED entry: a discarded row is removed from the bible at the next
1140
+ // kb_bible_commit, so this would be a bible removal without the grant.
1141
+ if (opts?.keepConfirmed && row.confidence === 'CONFIRMED') {
1142
+ result.refused.push(id);
1143
+ continue;
1144
+ }
1145
+ db.prepare("UPDATE entries SET superseded_at = ?, stale = 1, retired_reason = 'invalidated' WHERE id = ?").run(now, id);
1146
+ result.discarded.push(id);
1147
+ }
1148
+ return result;
1149
+ }
1150
+ /**
1151
+ * For each id this KB holds as RETIRED, why: 'superseded' or 'invalidated'.
1152
+ * Ids that are unknown, or known and not retired, are absent from the map.
1153
+ *
1154
+ * Retired means superseded_at is set (reason from retired_reason; NULL, a
1155
+ * row retired before that column existed, counts as 'superseded'), or
1156
+ * content_hash = 'invalidated' (kb_invalidate by file) -> 'invalidated'.
1157
+ *
1158
+ * A merely STALE row (stale = 1 from the freshness sweep, superseded_at
1159
+ * NULL, content_hash not 'invalidated') is NOT retired: staleness means the
1160
+ * cited files moved, which the next capture or sweep can clear, while
1161
+ * superseded and invalidated are explicit curation decisions. Only those two
1162
+ * remove an entry from the bible (kb_bible_commit).
1163
+ */
1164
+ getRetirementReasons(ids) {
1165
+ const db = this.getDb();
1166
+ const out = new Map();
1167
+ const stmt = db.prepare('SELECT superseded_at, retired_reason, content_hash FROM entries WHERE id = ?');
1168
+ for (const id of new Set(ids)) {
1169
+ const row = stmt.get(id);
1170
+ if (!row)
1171
+ continue;
1172
+ if (row.superseded_at)
1173
+ out.set(id, row.retired_reason === 'invalidated' ? 'invalidated' : 'superseded');
1174
+ else if (row.content_hash === 'invalidated')
1175
+ out.set(id, 'invalidated');
1176
+ }
1177
+ return out;
1178
+ }
1179
+ async invalidate(files, opts) {
965
1180
  const db = this.getDb();
966
1181
  let invalidated = 0;
1182
+ // keepConfirmed: CONFIRMED rows are left untouched and reported (a
1183
+ // file-invalidated row is retired, and so removed from the bible by the
1184
+ // next kb_bible_commit -- see getRetirementReasons).
1185
+ const refused = new Set();
1186
+ // MEMBER own-scope: only entries carrying the caller's member tag.
1187
+ const ownerClause = opts?.ownerTag ? 'AND EXISTS (SELECT 1 FROM json_each(tags) WHERE value = ?)' : '';
1188
+ const ownerParams = opts?.ownerTag ? [opts.ownerTag] : [];
967
1189
  for (const file of files) {
968
- const rows = db.prepare(`
969
- SELECT id FROM entries
1190
+ const candidates = db.prepare(`
1191
+ SELECT id, confidence FROM entries
970
1192
  WHERE type = 'context-cache'
971
1193
  AND superseded_at IS NULL
1194
+ ${ownerClause}
972
1195
  AND EXISTS (
973
1196
  SELECT 1 FROM json_each(source_files) WHERE value = ?
974
1197
  )
975
- `).all(file);
1198
+ `).all(...ownerParams, file);
1199
+ const rows = opts?.keepConfirmed ? candidates.filter(r => r.confidence !== 'CONFIRMED') : candidates;
1200
+ if (opts?.keepConfirmed)
1201
+ for (const r of candidates)
1202
+ if (r.confidence === 'CONFIRMED')
1203
+ refused.add(r.id);
976
1204
  if (rows.length > 0) {
977
1205
  const ids = rows.map(r => r.id);
978
1206
  db.prepare(`
@@ -983,7 +1211,7 @@ export class SqliteProvider {
983
1211
  invalidated += ids.length;
984
1212
  }
985
1213
  }
986
- return { invalidated };
1214
+ return opts?.keepConfirmed ? { invalidated, refused: [...refused] } : { invalidated };
987
1215
  }
988
1216
  async getLinked(id) {
989
1217
  const db = this.getDb();
@@ -1013,14 +1241,21 @@ export class SqliteProvider {
1013
1241
  //
1014
1242
  // Superseded rows are excluded (they are already retired) and the input ids are
1015
1243
  // never echoed back. `limit` caps the total, since this rides into a prompt.
1016
- async relatedClaims(ids, limit = 5) {
1244
+ //
1245
+ // `filter` (optional) applies the same retrieval-trust filters kb_query's
1246
+ // direct hits use, so a CONFIRMED-only caller cannot be handed an INFERRED or
1247
+ // disputed claim through the graph instead.
1248
+ async relatedClaims(ids, limit = 5, filter) {
1017
1249
  if (ids.length === 0)
1018
1250
  return [];
1019
1251
  const db = this.getDb();
1020
1252
  const ph = ids.map(() => '?').join(',');
1253
+ const trust = trustFilterSql(filter);
1254
+ const trustWhere = trust.conditions.map(c => `AND ${c}`).join(' ');
1021
1255
  const rows = db.prepare(`
1022
1256
  SELECT DISTINCT e.* FROM entries e
1023
1257
  WHERE e.superseded_at IS NULL
1258
+ ${trustWhere}
1024
1259
  AND e.id NOT IN (${ph})
1025
1260
  AND (
1026
1261
  EXISTS (
@@ -1033,13 +1268,13 @@ export class SqliteProvider {
1033
1268
  OR e.id IN (SELECT contradiction_of FROM entries WHERE id IN (${ph}) AND contradiction_of IS NOT NULL)
1034
1269
  )
1035
1270
  LIMIT ?
1036
- `).all(...ids, ...ids, ...ids, ...ids, ...ids, limit);
1271
+ `).all(...trust.params, ...ids, ...ids, ...ids, ...ids, ...ids, limit);
1037
1272
  return rows.map(r => this.rowToEntry(r));
1038
1273
  }
1039
1274
  async prime(opts) {
1040
1275
  this.decayConceptEntries(this.getDb(), opts.decay_after_days ?? 30);
1041
1276
  const fileResults = opts.session_files?.length
1042
- ? await this.context(opts.session_files)
1277
+ ? await this.context(opts.session_files, opts.confidence, opts.exclude_disputed, opts.owner_tag)
1043
1278
  : [];
1044
1279
  const stale_files = fileResults
1045
1280
  .filter(r => r.status === 'stale' || r.status === 'missing')
@@ -1065,6 +1300,9 @@ export class SqliteProvider {
1065
1300
  l1_only: true,
1066
1301
  limit: 10,
1067
1302
  include_stale: false,
1303
+ confidence: opts.confidence,
1304
+ exclude_disputed: opts.exclude_disputed,
1305
+ owner_tag: opts.owner_tag,
1068
1306
  });
1069
1307
  top_entries = l1.results
1070
1308
  .filter(e => e.type !== 'context-cache')
@@ -1124,9 +1362,12 @@ export class SqliteProvider {
1124
1362
  const db = this.getDb();
1125
1363
  const conditions = ['e.superseded_at IS NULL', 'e.stale = 0'];
1126
1364
  const params = [];
1127
- if (opts.confidence) {
1128
- conditions.push('e.confidence = ?');
1129
- params.push(opts.confidence);
1365
+ if (opts.exclude_disputed) {
1366
+ conditions.push('e.flagged_for_review = 0 AND e.contradiction_of IS NULL');
1367
+ }
1368
+ if (opts.confidence?.length) {
1369
+ conditions.push(`e.confidence IN (${opts.confidence.map(() => '?').join(',')})`);
1370
+ params.push(...opts.confidence);
1130
1371
  }
1131
1372
  if (opts.type) {
1132
1373
  conditions.push('e.type = ?');
@@ -1144,6 +1385,10 @@ export class SqliteProvider {
1144
1385
  conditions.push('EXISTS (SELECT 1 FROM json_each(e.tags) WHERE value = ?)');
1145
1386
  params.push(opts.tag);
1146
1387
  }
1388
+ if (opts.owner_tag) {
1389
+ conditions.push('EXISTS (SELECT 1 FROM json_each(e.tags) WHERE value = ?)');
1390
+ params.push(opts.owner_tag);
1391
+ }
1147
1392
  const where = 'WHERE ' + conditions.join(' AND ');
1148
1393
  const limitClause = opts.limit !== undefined ? 'LIMIT ?' : '';
1149
1394
  if (opts.limit !== undefined)
@@ -1156,12 +1401,16 @@ export class SqliteProvider {
1156
1401
  `).all(...params);
1157
1402
  return rows.map(r => this.rowToEntry(r));
1158
1403
  }
1159
- async promote(id, reason) {
1404
+ async promote(id, reason, opts) {
1160
1405
  const db = this.getDb();
1161
1406
  const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
1162
1407
  if (!row)
1163
1408
  throw new Error(`Entry not found: ${id}`);
1164
1409
  const entry = this.rowToEntry(row);
1410
+ // MEMBER own-scope: an entry the caller did not capture is indistinguishable
1411
+ // from an unknown id (same message, so its existence is not disclosed).
1412
+ if (opts?.ownerTag && !entry.tags.includes(opts.ownerTag))
1413
+ throw new Error(`Entry not found: ${id}`);
1165
1414
  if (entry.superseded_at)
1166
1415
  throw new Error(`Cannot promote superseded entry: ${id}`);
1167
1416
  // H1 (F1, D1, closes yashr-9ha): promote() REFUSES any user-directive entry.
@@ -1390,7 +1639,7 @@ export class SqliteProvider {
1390
1639
  if (revivable) {
1391
1640
  const basis = this.parseBasis(refreshedRow.source_file_hashes ?? null);
1392
1641
  if (basis) {
1393
- const currentHashes = await computeFileHashBatch(Object.keys(basis));
1642
+ const currentHashes = await this.hashAnchored(Object.keys(basis));
1394
1643
  if (this.basisFullyMatches(basis, currentHashes)) {
1395
1644
  db.prepare('UPDATE entries SET stale = 0 WHERE id = ?').run(winnerId);
1396
1645
  }
@@ -1401,7 +1650,7 @@ export class SqliteProvider {
1401
1650
  // left as-is on the loser (harmless, and preserves which pair this row
1402
1651
  // was once part of for later inspection); only flagged_for_review is
1403
1652
  // cleared per the stated invariant.
1404
- db.prepare('UPDATE entries SET superseded_at = ?, stale = 1, flagged_for_review = 0 WHERE id = ?').run(now, loserId);
1653
+ db.prepare("UPDATE entries SET superseded_at = ?, stale = 1, flagged_for_review = 0, retired_reason = 'superseded' WHERE id = ?").run(now, loserId);
1405
1654
  return { winnerId, loserId };
1406
1655
  }
1407
1656
  // T3.1 (F5 step 3, D4 HARDENED, resolution R1): kb_reconcile_prefilter's
@@ -1410,7 +1659,9 @@ export class SqliteProvider {
1410
1659
  // union of every basis file across every pair -- same batching discipline as
1411
1660
  // freshnessSweep): exactly one side fully matches -> that side WINS
1412
1661
  // mechanically via resolveContradiction with the verbatim evidence string
1413
- // "hash-basis match on merged worktree". Both match, both mismatch, or
1662
+ // "hash-basis match on merged worktree" -- EXCEPT when the would-be loser is
1663
+ // CONFIRMED: a CONFIRMED entry is never retired by hash basis alone, so such
1664
+ // a pair is left for the reconciler agent. Both match, both mismatch, or
1414
1665
  // EITHER side has an empty/missing basis -> left untouched for the T3.2
1415
1666
  // reconciler agent. Directive pairs are already excluded by flaggedPairs()
1416
1667
  // itself (MEDIUM-3 liveness contract); the explicit re-check here is
@@ -1436,9 +1687,12 @@ export class SqliteProvider {
1436
1687
  const allIds = liveTouchable.flatMap(p => [p.original.id, p.challenger.id]);
1437
1688
  const basisById = new Map();
1438
1689
  if (allIds.length > 0) {
1439
- const basisRows = db.prepare(`SELECT id, source_file_hashes FROM entries WHERE id IN (${allIds.map(() => '?').join(',')})`).all(...allIds);
1440
- for (const row of basisRows)
1441
- basisById.set(row.id, this.parseBasis(row.source_file_hashes));
1690
+ // A local freshness-only basis (legacy bible import) counts as no basis
1691
+ // here: it was never verified, so it must not win a pair mechanically.
1692
+ const basisRows = db.prepare(`SELECT id, source_file_hashes, local_basis_only FROM entries WHERE id IN (${allIds.map(() => '?').join(',')})`).all(...allIds);
1693
+ for (const row of basisRows) {
1694
+ basisById.set(row.id, row.local_basis_only ? null : this.parseBasis(row.source_file_hashes));
1695
+ }
1442
1696
  }
1443
1697
  const fileSet = new Set();
1444
1698
  for (const basis of basisById.values()) {
@@ -1446,13 +1700,21 @@ export class SqliteProvider {
1446
1700
  for (const file of Object.keys(basis))
1447
1701
  fileSet.add(file);
1448
1702
  }
1449
- const currentHashes = await computeFileHashBatch([...fileSet]);
1703
+ const currentHashes = await this.hashAnchored([...fileSet]);
1450
1704
  for (const pair of liveTouchable) {
1451
1705
  const originalBasis = basisById.get(pair.original.id) ?? null;
1452
1706
  const challengerBasis = basisById.get(pair.challenger.id) ?? null;
1453
1707
  const originalMatches = originalBasis ? this.basisFullyMatches(originalBasis, currentHashes) : false;
1454
1708
  const challengerMatches = challengerBasis ? this.basisFullyMatches(challengerBasis, currentHashes) : false;
1455
- if (originalMatches && !challengerMatches) {
1709
+ // A CONFIRMED entry is never retired by hash basis alone: a member can
1710
+ // capture a contradiction against a drifted CONFIRMED entry, and basis
1711
+ // match is no content judgement. Defer to the reconciler agent.
1712
+ const wouldLose = originalMatches && !challengerMatches ? pair.challenger
1713
+ : challengerMatches && !originalMatches ? pair.original : null;
1714
+ if (wouldLose && wouldLose.confidence === 'CONFIRMED') {
1715
+ left_for_agent.push({ originalId: pair.original.id, challengerId: pair.challenger.id });
1716
+ }
1717
+ else if (originalMatches && !challengerMatches) {
1456
1718
  await this.resolveContradiction(pair.original.id, pair.challenger.id, 'hash-basis match on merged worktree');
1457
1719
  resolved.push({ winnerId: pair.original.id, loserId: pair.challenger.id });
1458
1720
  }