@apralabs/apra-fleet 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  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 +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  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 +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -10,11 +10,13 @@
10
10
  import { DatabaseSync } from 'node:sqlite';
11
11
  import path from 'node:path';
12
12
  import fs from 'node:fs';
13
- import { randomUUID } from 'node:crypto';
13
+ import { createHash, randomUUID } from 'node:crypto';
14
14
  import { FLEET_DIR } from '../../paths.js';
15
15
  import { resolveProjectSlug } from './project-slug.js';
16
16
  import { makeFtsQuery, makeAudnDecision, orJoinFtsTerms, } from './audn.js';
17
17
  import { computeFileHashBatch } from './file-hash.js';
18
+ import { validateFilePaths } from './path-validation.js';
19
+ import { clampBibleTimeToNow, standingAgainstTombstone } from './bible-import.js';
18
20
  import { KbCaptureRejected } from './types.js';
19
21
  const CONTENT_CAP = 4000;
20
22
  const TRUNCATION_SUFFIX = '...[truncated]';
@@ -32,12 +34,72 @@ const MIN_PROMOTE_REASON_LENGTH = 20;
32
34
  function isNonTrivialPromoteReason(reason) {
33
35
  return (reason ?? '').trim().length >= MIN_PROMOTE_REASON_LENGTH;
34
36
  }
37
+ /**
38
+ * Minimum length of a kb_demote reason, measured AFTER newlines are collapsed
39
+ * to spaces and the result trimmed. Same floor as kb_promote: withdrawing
40
+ * trust must be as auditable as granting it, and a reason that is only
41
+ * whitespace/newlines collapses to the empty string and is refused.
42
+ */
43
+ const MIN_DEMOTE_REASON_LENGTH = 20;
44
+ /**
45
+ * The single normalisation applied to a demote reason, used for BOTH the
46
+ * length gate and the note written into content -- so what was validated is
47
+ * exactly what is recorded. Every newline becomes a space (the note must stay
48
+ * one line, and must never be able to grow a second leading newline and so
49
+ * collide with the kb_feedback marker, which is two newlines + "[feedback ").
50
+ */
51
+ function normalizeDemoteReason(reason) {
52
+ return (reason ?? '').replace(/[\r\n]/g, ' ').trim();
53
+ }
54
+ /**
55
+ * The ONE demotion-note format, shared by kb_demote (demote()) and the bible
56
+ * tombstone path (applyBibleDemotion()), so a demotion that crosses clones
57
+ * reads identically to one applied locally.
58
+ *
59
+ * String concatenation (not a template literal) per the ASCII pre-commit hook
60
+ * gotcha: backslash-n escapes inside JS template literals false-positive on the
61
+ * hook's non-ASCII scan (same convention as promote()'s promotionNote and
62
+ * feedback()'s note).
63
+ *
64
+ * EXACTLY ONE leading newline. feedback() writes TWO ('\n\n[feedback ...'), so
65
+ * a demote note can never be mistaken for a feedback marker by anything
66
+ * scanning content for one.
67
+ */
68
+ function buildDemotionNote(normalizedReason, evidence, author) {
69
+ const evidenceClause = evidence.length > 0 ? ' | evidence: ' + evidence.join(', ') : '';
70
+ return '\n[Demoted: ' + normalizedReason + evidenceClause + ' -- ' + (author || 'unknown') + ']';
71
+ }
72
+ /**
73
+ * The reason recorded when a demotion arrives through the committed project
74
+ * bible rather than a local kb_demote. Must clear MIN_DEMOTE_REASON_LENGTH.
75
+ */
76
+ export const BIBLE_DEMOTION_REASON = 'demoted in the project bible';
35
77
  class NotImplementedError extends Error {
36
78
  constructor(method) {
37
79
  super(`SqliteProvider.${method}() not yet implemented`);
38
80
  this.name = 'NotImplementedError';
39
81
  }
40
82
  }
83
+ // SQL for the opt-in retrieval-trust filters (QueryOptions.confidence /
84
+ // exclude_disputed), shared by query() and relatedClaims() so the direct hits
85
+ // and the graph-expanded claims of one kb_query obey the same rule. An empty
86
+ // or absent filter yields no conditions -- the default-off contract.
87
+ function trustFilterSql(filter) {
88
+ const conditions = [];
89
+ const params = [];
90
+ if (filter?.confidence?.length) {
91
+ conditions.push(`e.confidence IN (${filter.confidence.map(() => '?').join(',')})`);
92
+ params.push(...filter.confidence);
93
+ }
94
+ if (filter?.exclude_disputed) {
95
+ conditions.push('e.flagged_for_review = 0 AND e.contradiction_of IS NULL');
96
+ }
97
+ if (filter?.owner_tag) {
98
+ conditions.push('EXISTS (SELECT 1 FROM json_each(e.tags) WHERE value = ?)');
99
+ params.push(filter.owner_tag);
100
+ }
101
+ return { conditions, params };
102
+ }
41
103
  export class SqliteProvider {
42
104
  db = null;
43
105
  dbPath;
@@ -64,6 +126,15 @@ export class SqliteProvider {
64
126
  this.dbPath = path.join(dir, 'kb.sqlite');
65
127
  }
66
128
  }
129
+ /**
130
+ * Re-anchor after loading. Used only by the remote member bible view: the
131
+ * member's checkout is not on this host, so entries are imported with no
132
+ * anchor (the basis gate cannot check files here), then the remote folder is
133
+ * bound so freshness reads treat the anchor as missing and issue no verdict.
134
+ */
135
+ bindRepoPath(repoPath) {
136
+ this.repoPath = repoPath;
137
+ }
67
138
  async init() {
68
139
  if (this.db !== null)
69
140
  return;
@@ -158,6 +229,86 @@ export class SqliteProvider {
158
229
  this.db.exec("ALTER TABLE entries ADD COLUMN source_file_hashes TEXT NOT NULL DEFAULT '{}'");
159
230
  }
160
231
  catch { }
232
+ // Why a row was retired (superseded_at set): 'superseded' (a contradiction
233
+ // loser, or replaced by a capture naming it in supersedes) or 'invalidated'
234
+ // (discarded by id through kb_invalidate). superseded_at alone cannot tell
235
+ // the two apart, and kb_bible_commit reports the reason for each bible
236
+ // entry it removes. Internal only: never surfaced on KBEntry. Rows retired
237
+ // before this column existed read NULL and count as 'superseded'.
238
+ try {
239
+ this.db.exec('ALTER TABLE entries ADD COLUMN retired_reason TEXT');
240
+ }
241
+ catch { }
242
+ // Legacy bible import (v1/v2 entry, or a v3 entry without a valid carried
243
+ // map): source_file_hashes then holds THIS clone's file hashes, a
244
+ // freshness-only basis. 1 = that basis feeds staleness checks only and is
245
+ // never exported, never used for bible admission, never used for a
246
+ // mechanical contradiction win (getSourceFileBases / reconcile prefilter
247
+ // read it as no basis). Internal only: never surfaced on KBEntry. Existing
248
+ // rows default to 0.
249
+ try {
250
+ this.db.exec('ALTER TABLE entries ADD COLUMN local_basis_only INTEGER NOT NULL DEFAULT 0');
251
+ }
252
+ catch { }
253
+ // kb_demote (CONFIRMED -> INFERRED): demoted_at records WHEN trust was
254
+ // withdrawn, demoted_basis_hashes the sha256 of each cited source file AS
255
+ // IT WAS ON DISK AT DEMOTE TIME. The second column is deliberately NOT a
256
+ // copy of source_file_hashes (which is the CAPTURE-time basis): the
257
+ // ping-pong guard built on top of it asks "has the tree moved on since we
258
+ // demoted?", and a capture-time copy answers the wrong question, so a file
259
+ // edited between capture and demote would look unchanged forever. Same
260
+ // guarded-ALTER pattern as scope/source_file_hashes above: it runs on a
261
+ // fresh DB (the columns are not in CREATE TABLE) and is a caught no-op on
262
+ // a DB that already has them.
263
+ try {
264
+ this.db.exec('ALTER TABLE entries ADD COLUMN demoted_at TEXT');
265
+ }
266
+ catch { }
267
+ try {
268
+ this.db.exec("ALTER TABLE entries ADD COLUMN demoted_basis_hashes TEXT NOT NULL DEFAULT '{}'");
269
+ }
270
+ catch { }
271
+ // The updated_at a bible carried for an entry this clone imported (capture
272
+ // opts.carriedUpdatedAt): when the exporting clone promoted it. Tombstones
273
+ // are judged against it (getBibleTrustTimes), never against the local
274
+ // import time. Internal only: never surfaced on KBEntry. NULL on every row
275
+ // that was not imported, and on rows imported before the column existed.
276
+ try {
277
+ this.db.exec('ALTER TABLE entries ADD COLUMN bible_updated_at TEXT');
278
+ }
279
+ catch { }
280
+ // kb_import trust anchor: git blob ids of bibles the maintainer side wrote
281
+ // or imported (kb_bible_commit and FULL / kb_maintainer kb_import). A
282
+ // member session without the kb_maintainer grant imports its committed
283
+ // bible only when that bible's blob id is recorded here -- this hub-side
284
+ // database is the one place the member's own checkout cannot write. See
285
+ // services/knowledge/bible-blob-id.ts. Created idempotently; existing DBs
286
+ // start with no rows (a fresh hub is seeded by the maintainer side).
287
+ this.db.exec(`
288
+ CREATE TABLE IF NOT EXISTS trusted_bible_blobs (
289
+ blob_id TEXT PRIMARY KEY,
290
+ source TEXT NOT NULL,
291
+ recorded_at TEXT NOT NULL
292
+ );
293
+ `);
294
+ }
295
+ /**
296
+ * Record `blobId` (a git object id of a bible's bytes) as written or
297
+ * imported by the maintainer side. Idempotent: re-recording keeps the first
298
+ * row. Only trusted callers (kb_bible_commit and kb_import from a FULL or
299
+ * kb_maintainer session) may call this.
300
+ */
301
+ recordTrustedBibleBlob(blobId, source) {
302
+ this.getDb()
303
+ .prepare('INSERT OR IGNORE INTO trusted_bible_blobs (blob_id, source, recorded_at) VALUES (?, ?, ?)')
304
+ .run(blobId.toLowerCase(), source, new Date().toISOString());
305
+ }
306
+ /** True when `blobId` was recorded by recordTrustedBibleBlob. */
307
+ isTrustedBibleBlob(blobId) {
308
+ const row = this.getDb()
309
+ .prepare('SELECT 1 AS ok FROM trusted_bible_blobs WHERE blob_id = ?')
310
+ .get(blobId.toLowerCase());
311
+ return row !== undefined;
161
312
  }
162
313
  getDb() {
163
314
  if (!this.db)
@@ -187,11 +338,15 @@ export class SqliteProvider {
187
338
  created_at: row.created_at,
188
339
  superseded_at: row.superseded_at,
189
340
  promoted_at: row.promoted_at,
341
+ // kb_demote columns. Tolerant of a row read before the migration ran
342
+ // (undefined) and of a legacy NULL/'' in demoted_basis_hashes.
343
+ demoted_at: row.demoted_at ?? undefined,
344
+ demoted_basis_hashes: JSON.parse(row.demoted_basis_hashes || '{}'),
190
345
  use_count: row.use_count,
191
346
  last_accessed: row.last_accessed,
192
347
  };
193
348
  }
194
- insertEntry(db, id, input, content, now, sourceFileHashes = {}) {
349
+ insertEntry(db, id, input, content, now, sourceFileHashes = {}, localBasisOnly = false) {
195
350
  db.prepare(`
196
351
  INSERT INTO entries (
197
352
  id, type, title, summary, content,
@@ -199,7 +354,7 @@ export class SqliteProvider {
199
354
  content_hash, content_hash_type, stale,
200
355
  flagged_for_review, contradiction_of,
201
356
  author, source, confidence, scope, created_at,
202
- source_file_hashes,
357
+ source_file_hashes, local_basis_only,
203
358
  superseded_at, promoted_at, use_count
204
359
  ) VALUES (
205
360
  ?, ?, ?, ?, ?,
@@ -207,10 +362,10 @@ export class SqliteProvider {
207
362
  ?, ?, ?,
208
363
  ?, ?,
209
364
  ?, ?, ?, ?, ?,
210
- ?,
365
+ ?, ?,
211
366
  NULL, NULL, 0
212
367
  )
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));
368
+ `).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
369
  }
215
370
  /**
216
371
  * Resolve a source_files entry for existence checking. Absolute paths pass
@@ -286,13 +441,21 @@ export class SqliteProvider {
286
441
  // absent from the returned map (not an error). Bounded to the caller's own
287
442
  // source_files list. Non-fatal: any hashing error yields an empty basis
288
443
  // rather than failing the capture.
444
+ /**
445
+ * The ONLY way this provider hashes source files: relative paths anchor at
446
+ * the provider repo (never process.cwd()) when one is set. Every call site
447
+ * goes through here so a new call cannot forget the anchor.
448
+ */
449
+ hashAnchored(files, anchor = this.repoPath) {
450
+ return computeFileHashBatch(files, anchor !== undefined ? { cwd: anchor } : undefined);
451
+ }
289
452
  async computeSourceFileHashes(files) {
290
453
  if (files.length === 0)
291
454
  return {};
292
455
  try {
293
456
  // Anchor relative basis paths at this provider's repo, the same root the
294
457
  // capture gate checked them against and the one freshnessSweep(root) uses.
295
- const hashes = await computeFileHashBatch(files, this.repoPath !== undefined ? { cwd: this.repoPath } : undefined);
458
+ const hashes = await this.hashAnchored(files);
296
459
  const map = {};
297
460
  for (const file of Object.keys(hashes)) {
298
461
  const result = hashes[file];
@@ -380,6 +543,137 @@ export class SqliteProvider {
380
543
  return null;
381
544
  }
382
545
  }
546
+ /**
547
+ * Read-only accessor for the stored per-file hash basis (source_file_hashes)
548
+ * of the given entry ids. Each requested id maps to its parsed basis, or null
549
+ * when the basis is empty/unparseable or the id is unknown. Used by kb_export's
550
+ * project-scope bible filter and kb_bible_commit admission; internal to this
551
+ * provider, not an MCP surface. A local freshness-only basis
552
+ * (local_basis_only = 1, a legacy bible import) maps to null: it was hashed
553
+ * from this clone, never verified, so it must never be exported or admit an
554
+ * entry to the bible.
555
+ */
556
+ getSourceFileBases(ids) {
557
+ const out = new Map();
558
+ for (const id of ids)
559
+ out.set(id, null);
560
+ if (ids.length === 0)
561
+ return out;
562
+ const db = this.getDb();
563
+ // Chunk to stay well under SQLite's bound-parameter limit.
564
+ const CHUNK = 500;
565
+ for (let i = 0; i < ids.length; i += CHUNK) {
566
+ const chunk = ids.slice(i, i + CHUNK);
567
+ const rows = db.prepare(`SELECT id, source_file_hashes, local_basis_only FROM entries WHERE id IN (${chunk.map(() => '?').join(',')})`).all(...chunk);
568
+ for (const row of rows)
569
+ out.set(row.id, row.local_basis_only ? null : this.parseBasis(row.source_file_hashes));
570
+ }
571
+ return out;
572
+ }
573
+ /**
574
+ * The bible trust time of each given id that exists: when this clone's trust
575
+ * in the row dates from, as a bible records it. promoted_at when the row was
576
+ * promoted here; else the updated_at the bible carried when the row was
577
+ * imported (bible_updated_at); else null for an imported row from before that
578
+ * column existed -- its trust came from a bible, and the local import time
579
+ * says nothing about when it was promoted. Any other row falls back to
580
+ * created_at. An unknown id is absent from the map. Fed to
581
+ * standingAgainstTombstone (bible-import.ts) by kb_export, and used for the
582
+ * updated_at a bible writer records, so every clone compares the same value.
583
+ * Internal to this provider, not an MCP surface.
584
+ */
585
+ getBibleTrustTimes(ids) {
586
+ const out = new Map();
587
+ if (ids.length === 0)
588
+ return out;
589
+ const db = this.getDb();
590
+ // Chunk to stay well under SQLite's bound-parameter limit (as above).
591
+ const CHUNK = 500;
592
+ for (let i = 0; i < ids.length; i += CHUNK) {
593
+ const chunk = ids.slice(i, i + CHUNK);
594
+ const rows = db.prepare(`SELECT id, promoted_at, bible_updated_at, source, created_at FROM entries WHERE id IN (${chunk.map(() => '?').join(',')})`).all(...chunk);
595
+ for (const row of rows)
596
+ out.set(row.id, this.bibleTrustTimeOf(row));
597
+ }
598
+ return out;
599
+ }
600
+ /** getBibleTrustTimes' rule for one raw row (needs promoted_at, bible_updated_at, source, created_at). */
601
+ bibleTrustTimeOf(row) {
602
+ if (typeof row.promoted_at === 'string')
603
+ return row.promoted_at;
604
+ if (typeof row.bible_updated_at === 'string')
605
+ return row.bible_updated_at;
606
+ if (row.source === 'import')
607
+ return null;
608
+ return typeof row.created_at === 'string' ? row.created_at : null;
609
+ }
610
+ /**
611
+ * Read-only accessor for the demotion state of the given entry ids: the
612
+ * CURRENT confidence and demoted_at of each id that exists. An unknown id is
613
+ * simply absent from the map.
614
+ *
615
+ * Deliberately NOT routed through list(): list() excludes stale and superseded
616
+ * rows, and a demoted entry that later went stale is exactly the one whose
617
+ * tombstone other clones most need -- their bible still carries the entry.
618
+ * Policy (what counts as demoted enough to tombstone) lives in the caller
619
+ * (src/tools/kb-bible-commit.ts); this member only reports the two columns.
620
+ * Internal to this provider, not an MCP surface.
621
+ */
622
+ getDemotionState(ids) {
623
+ const out = new Map();
624
+ if (ids.length === 0)
625
+ return out;
626
+ const db = this.getDb();
627
+ // Chunk to stay well under SQLite's bound-parameter limit (as above).
628
+ const CHUNK = 500;
629
+ for (let i = 0; i < ids.length; i += CHUNK) {
630
+ const chunk = ids.slice(i, i + CHUNK);
631
+ const rows = db.prepare(`SELECT id, confidence, demoted_at FROM entries WHERE id IN (${chunk.map(() => '?').join(',')})`).all(...chunk);
632
+ for (const row of rows) {
633
+ out.set(row.id, {
634
+ confidence: row.confidence,
635
+ demoted_at: row.demoted_at ?? undefined,
636
+ });
637
+ }
638
+ }
639
+ return out;
640
+ }
641
+ /**
642
+ * For each of the given ids that EXISTS locally, whether that row is LIVE
643
+ * CONFIRMED: confidence is CONFIRMED and the row is not stale, not superseded
644
+ * and not flagged_for_review.
645
+ *
646
+ * An id with NO local row is simply ABSENT from the map -- the caller must be
647
+ * able to tell "I hold a row and it is no longer trustworthy" (do not surface
648
+ * the bible's version of it) from "I have never seen this id" (the cold-seed
649
+ * case the bible exists to serve). A boolean-only return would conflate them.
650
+ *
651
+ * ONE predicate, deliberately not a demoted_at check. A demotion is only one
652
+ * of the ways a row stops being live CONFIRMED; staleness, supersession and a
653
+ * review flag are the others, and a cold seed that re-surfaced the bible's
654
+ * CONFIRMED copy of any of them would be re-asserting knowledge this clone has
655
+ * already stopped trusting. Reads the rows DIRECTLY rather than through list(),
656
+ * which filters stale and superseded rows out and so cannot report them.
657
+ */
658
+ getLiveConfirmedState(ids) {
659
+ const out = new Map();
660
+ if (ids.length === 0)
661
+ return out;
662
+ const db = this.getDb();
663
+ // Chunk to stay well under SQLite's bound-parameter limit (as above).
664
+ const CHUNK = 500;
665
+ for (let i = 0; i < ids.length; i += CHUNK) {
666
+ const chunk = ids.slice(i, i + CHUNK);
667
+ const rows = db.prepare(`SELECT id, confidence, stale, superseded_at, flagged_for_review FROM entries WHERE id IN (${chunk.map(() => '?').join(',')})`).all(...chunk);
668
+ for (const row of rows) {
669
+ out.set(row.id, row.confidence === 'CONFIRMED'
670
+ && row.stale !== 1
671
+ && row.superseded_at === null
672
+ && row.flagged_for_review !== 1);
673
+ }
674
+ }
675
+ return out;
676
+ }
383
677
  // T1.3 (F2/D2 HARDENED): freshness check bounded to the primed set, now
384
678
  // BIDIRECTIONAL. Keyed off source_files with a per-file hash basis persisted
385
679
  // at capture time (source_file_hashes) -- NOT content_hash, which is only ever
@@ -429,7 +723,7 @@ export class SqliteProvider {
429
723
  // whenever the process cwd is not the repo -- which is the normal case in
430
724
  // the long-lived fleet server -- so every relative basis path would re-hash
431
725
  // 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);
726
+ const currentHashes = await this.hashAnchored([...fileSet]);
433
727
  const staleIds = [];
434
728
  const unstaleIds = [];
435
729
  for (const [id, basis] of basisById) {
@@ -514,7 +808,7 @@ export class SqliteProvider {
514
808
  for (const file of Object.keys(basis))
515
809
  fileSet.add(file);
516
810
  }
517
- const currentHashes = await computeFileHashBatch([...fileSet], anchor ? { cwd: anchor } : undefined);
811
+ const currentHashes = await this.hashAnchored([...fileSet], anchor || undefined);
518
812
  const staleIds = [];
519
813
  const unstaleIds = [];
520
814
  let checked = 0;
@@ -569,7 +863,7 @@ export class SqliteProvider {
569
863
  return [];
570
864
  }
571
865
  }
572
- evaluateAudn(db, input, candidates, newContent, now, sourceFileHashes) {
866
+ evaluateAudn(db, input, candidates, newContent, now, sourceFileHashes, localBasisOnly = false, keepConfirmed = false) {
573
867
  const decision = makeAudnDecision(input, candidates, newContent);
574
868
  if (!decision)
575
869
  return null;
@@ -579,13 +873,20 @@ export class SqliteProvider {
579
873
  if (decision.decision === 'flagged') {
580
874
  db.prepare('UPDATE entries SET flagged_for_review = 1 WHERE id = ?').run(decision.matchedId);
581
875
  const newId = randomUUID();
582
- this.insertEntry(db, newId, { ...input, ...decision.newEntryOverrides }, newContent, now, sourceFileHashes);
876
+ this.insertEntry(db, newId, { ...input, ...decision.newEntryOverrides }, newContent, now, sourceFileHashes, localBasisOnly);
583
877
  this.wireLinks(db, newId, input);
584
878
  return { id: newId, audn_decision: 'flagged' };
585
879
  }
586
880
  if (decision.decision === 'update') {
587
881
  const newId = randomUUID();
588
- if (input.supersedes === decision.matchedId) {
882
+ // keepConfirmed (a member session without the kb_maintainer grant): a
883
+ // CONFIRMED target is never retired by supersedes -- retiring it would
884
+ // remove it from the bible at the next kb_bible_commit. The capture
885
+ // takes the IMPLICIT path below instead (both live, 'refines' link) and
886
+ // the target id is reported, mirroring kb_invalidate's keepConfirmed.
887
+ const target = candidates.find(c => c.id === decision.matchedId);
888
+ const supersedeRefused = keepConfirmed && input.supersedes === decision.matchedId && target?.confidence === 'CONFIRMED';
889
+ if (input.supersedes === decision.matchedId && !supersedeRefused) {
589
890
  // EXPLICIT: the caller named what it replaces and AUDN independently
590
891
  // matched it. Retire it exactly as before -- superseded_at + stale = 1.
591
892
  // D2 (F2a): both flags are required so the old row is excluded from
@@ -594,9 +895,9 @@ export class SqliteProvider {
594
895
  // flagged_for_review is deliberately NOT cleared here; that is
595
896
  // resolveContradiction's behavior, and kb-review.md depends on the
596
897
  // difference (a kept entry stays listed under flagged_only).
597
- db.prepare('UPDATE entries SET superseded_at = ?, stale = 1 WHERE id = ?')
898
+ db.prepare("UPDATE entries SET superseded_at = ?, stale = 1, retired_reason = 'superseded' WHERE id = ?")
598
899
  .run(now, decision.matchedId);
599
- this.insertEntry(db, newId, input, newContent, now, sourceFileHashes);
900
+ this.insertEntry(db, newId, input, newContent, now, sourceFileHashes, localBasisOnly);
600
901
  this.wireLinks(db, newId, input);
601
902
  return { id: newId, audn_decision: 'update' };
602
903
  }
@@ -604,10 +905,12 @@ export class SqliteProvider {
604
905
  // That is a topicality signal, not consent to destroy -- two DISTINCT
605
906
  // facts about one symbol used to eat each other. Link and keep both;
606
907
  // curation retires what it means to retire, explicitly.
607
- this.insertEntry(db, newId, input, newContent, now, sourceFileHashes);
908
+ this.insertEntry(db, newId, input, newContent, now, sourceFileHashes, localBasisOnly);
608
909
  this.wireLinks(db, newId, input);
609
910
  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' };
911
+ return supersedeRefused
912
+ ? { id: newId, audn_decision: 'update', refused: [decision.matchedId] }
913
+ : { id: newId, audn_decision: 'update' };
611
914
  }
612
915
  return null;
613
916
  }
@@ -764,10 +1067,28 @@ export class SqliteProvider {
764
1067
  // T2.2 (F3 PART A): capture() is the single choke point every caller
765
1068
  // (kb_capture, kb_harvest, future paths) goes through, so every entry
766
1069
  // gets a hash basis here regardless of type.
767
- const sourceFileHashes = await this.computeSourceFileHashes(input.source_files ?? []);
768
- const candidates = this.findAudnCandidates(db, input);
1070
+ //
1071
+ // Bible format v3: an IMPORT carrying a basis (opts.carriedBasis, honoured
1072
+ // only under importMode, which no deserialized route can set) stores that
1073
+ // map verbatim instead -- the basis the entry was verified against on the
1074
+ // exporting clone. carriedBasis null (a v1/v2 entry, or an invalid carried
1075
+ // map) hashes this clone's files into a LOCAL freshness-only basis
1076
+ // (local_basis_only = 1): it lets the entry go stale when code drifts, but
1077
+ // is never exported, never admits it to the bible and never wins a
1078
+ // contradiction mechanically. Normal captures are unaffected.
1079
+ const carried = opts?.importMode === true && opts.carriedBasis !== undefined;
1080
+ const localBasisOnly = carried && opts?.carriedBasis === null;
1081
+ const sourceFileHashes = carried && !localBasisOnly
1082
+ ? { ...(opts?.carriedBasis ?? {}) }
1083
+ : await this.computeSourceFileHashes(input.source_files ?? []);
1084
+ // Verbatim (member bible view): the bible was reviewed and merged as a
1085
+ // whole; AUDN against its own sibling entries would flag, re-id and
1086
+ // demote them (a contradiction keyword in one summary disputes another
1087
+ // CONFIRMED entry). Skip AUDN and keep the bible id.
1088
+ const verbatim = opts?.verbatim === true && opts.importMode === true && opts.preferredId !== undefined;
1089
+ const candidates = verbatim ? [] : this.findAudnCandidates(db, input);
769
1090
  if (candidates.length > 0) {
770
- const result = this.evaluateAudn(db, input, candidates, content, now, sourceFileHashes);
1091
+ const result = this.evaluateAudn(db, input, candidates, content, now, sourceFileHashes, localBasisOnly, opts?.keepConfirmed === true);
771
1092
  if (result)
772
1093
  return result;
773
1094
  }
@@ -778,7 +1099,10 @@ export class SqliteProvider {
778
1099
  // always mint a fresh randomUUID -- an id collision with different content is
779
1100
  // resolved by AUDN under a new id, never by overwriting the preserved id.
780
1101
  const id = opts?.preferredId ?? randomUUID();
781
- this.insertEntry(db, id, input, content, now, sourceFileHashes);
1102
+ this.insertEntry(db, id, input, content, now, sourceFileHashes, localBasisOnly);
1103
+ if (opts?.importMode === true && opts.carriedUpdatedAt !== undefined) {
1104
+ db.prepare('UPDATE entries SET bible_updated_at = ? WHERE id = ?').run(opts.carriedUpdatedAt, id);
1105
+ }
782
1106
  this.wireLinks(db, id, input);
783
1107
  return { id, audn_decision: 'add' };
784
1108
  }
@@ -858,6 +1182,11 @@ export class SqliteProvider {
858
1182
  conditions.push('(e.flagged_for_review = 1 OR e.contradiction_of IS NOT NULL)');
859
1183
  }
860
1184
  else {
1185
+ // Retrieval-trust filters (opt-in). Not applied to flagged_only, whose
1186
+ // whole purpose is listing the disputed entries these would drop.
1187
+ const trust = trustFilterSql(opts);
1188
+ conditions.push(...trust.conditions);
1189
+ params.push(...trust.params);
861
1190
  // H2 (F1, D1, closes yashr-9ha): default retrieval NEVER surfaces a
862
1191
  // pending or rejected directive PROPOSAL (type='user-directive' with
863
1192
  // confidence != 'CONFIRMED'). Only an ACTIVE (CONFIRMED) directive
@@ -913,24 +1242,32 @@ export class SqliteProvider {
913
1242
  }
914
1243
  return { results, total: results.length, l1_only: opts.l1_only ?? false };
915
1244
  }
916
- async context(files) {
1245
+ async context(files, confidence, excludeDisputed, ownerTag) {
917
1246
  const db = this.getDb();
918
1247
  const results = [];
1248
+ const confClause = (confidence?.length
1249
+ ? `AND confidence IN (${confidence.map(() => '?').join(',')})`
1250
+ : '') + (excludeDisputed ? ' AND flagged_for_review = 0 AND contradiction_of IS NULL' : '')
1251
+ + (ownerTag ? ' AND EXISTS (SELECT 1 FROM json_each(tags) WHERE value = ?)' : '');
1252
+ const confParams = confidence?.length ? [...confidence] : [];
1253
+ if (ownerTag)
1254
+ confParams.push(ownerTag);
919
1255
  const fileEntries = new Map();
920
1256
  for (const file of files) {
921
1257
  const rows = db.prepare(`
922
1258
  SELECT * FROM entries
923
1259
  WHERE type = 'context-cache'
924
1260
  AND superseded_at IS NULL
1261
+ ${confClause}
925
1262
  AND EXISTS (SELECT 1 FROM json_each(source_files) WHERE value = ?)
926
1263
  ORDER BY created_at DESC
927
1264
  LIMIT 1
928
- `).all(file);
1265
+ `).all(...confParams, file);
929
1266
  if (rows.length > 0) {
930
1267
  fileEntries.set(file, this.rowToEntry(rows[0]));
931
1268
  }
932
1269
  }
933
- const hashes = await computeFileHashBatch(files);
1270
+ const hashes = await this.hashAnchored(files);
934
1271
  for (const file of files) {
935
1272
  const entry = fileEntries.get(file);
936
1273
  if (!entry) {
@@ -961,18 +1298,89 @@ export class SqliteProvider {
961
1298
  }
962
1299
  return results;
963
1300
  }
964
- async invalidate(files) {
1301
+ async discard(ids, opts) {
1302
+ const db = this.getDb();
1303
+ const result = { discarded: [], not_found: [], already_discarded: [] };
1304
+ if (opts?.keepConfirmed)
1305
+ result.refused = [];
1306
+ const now = new Date().toISOString();
1307
+ for (const id of new Set(ids)) {
1308
+ const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
1309
+ // An entry outside the caller's own scope is indistinguishable from an unknown id.
1310
+ if (!row || (opts?.ownerTag && !this.rowToEntry(row).tags.includes(opts.ownerTag))) {
1311
+ result.not_found.push(id);
1312
+ continue;
1313
+ }
1314
+ if (row.superseded_at) {
1315
+ result.already_discarded.push(id);
1316
+ continue;
1317
+ }
1318
+ // A member session without the kb_maintainer grant may not retire a
1319
+ // CONFIRMED entry: a discarded row is removed from the bible at the next
1320
+ // kb_bible_commit, so this would be a bible removal without the grant.
1321
+ if (opts?.keepConfirmed && row.confidence === 'CONFIRMED') {
1322
+ result.refused.push(id);
1323
+ continue;
1324
+ }
1325
+ db.prepare("UPDATE entries SET superseded_at = ?, stale = 1, retired_reason = 'invalidated' WHERE id = ?").run(now, id);
1326
+ result.discarded.push(id);
1327
+ }
1328
+ return result;
1329
+ }
1330
+ /**
1331
+ * For each id this KB holds as RETIRED, why: 'superseded' or 'invalidated'.
1332
+ * Ids that are unknown, or known and not retired, are absent from the map.
1333
+ *
1334
+ * Retired means superseded_at is set (reason from retired_reason; NULL, a
1335
+ * row retired before that column existed, counts as 'superseded'), or
1336
+ * content_hash = 'invalidated' (kb_invalidate by file) -> 'invalidated'.
1337
+ *
1338
+ * A merely STALE row (stale = 1 from the freshness sweep, superseded_at
1339
+ * NULL, content_hash not 'invalidated') is NOT retired: staleness means the
1340
+ * cited files moved, which the next capture or sweep can clear, while
1341
+ * superseded and invalidated are explicit curation decisions. Only those two
1342
+ * remove an entry from the bible (kb_bible_commit).
1343
+ */
1344
+ getRetirementReasons(ids) {
1345
+ const db = this.getDb();
1346
+ const out = new Map();
1347
+ const stmt = db.prepare('SELECT superseded_at, retired_reason, content_hash FROM entries WHERE id = ?');
1348
+ for (const id of new Set(ids)) {
1349
+ const row = stmt.get(id);
1350
+ if (!row)
1351
+ continue;
1352
+ if (row.superseded_at)
1353
+ out.set(id, row.retired_reason === 'invalidated' ? 'invalidated' : 'superseded');
1354
+ else if (row.content_hash === 'invalidated')
1355
+ out.set(id, 'invalidated');
1356
+ }
1357
+ return out;
1358
+ }
1359
+ async invalidate(files, opts) {
965
1360
  const db = this.getDb();
966
1361
  let invalidated = 0;
1362
+ // keepConfirmed: CONFIRMED rows are left untouched and reported (a
1363
+ // file-invalidated row is retired, and so removed from the bible by the
1364
+ // next kb_bible_commit -- see getRetirementReasons).
1365
+ const refused = new Set();
1366
+ // MEMBER own-scope: only entries carrying the caller's member tag.
1367
+ const ownerClause = opts?.ownerTag ? 'AND EXISTS (SELECT 1 FROM json_each(tags) WHERE value = ?)' : '';
1368
+ const ownerParams = opts?.ownerTag ? [opts.ownerTag] : [];
967
1369
  for (const file of files) {
968
- const rows = db.prepare(`
969
- SELECT id FROM entries
1370
+ const candidates = db.prepare(`
1371
+ SELECT id, confidence FROM entries
970
1372
  WHERE type = 'context-cache'
971
1373
  AND superseded_at IS NULL
1374
+ ${ownerClause}
972
1375
  AND EXISTS (
973
1376
  SELECT 1 FROM json_each(source_files) WHERE value = ?
974
1377
  )
975
- `).all(file);
1378
+ `).all(...ownerParams, file);
1379
+ const rows = opts?.keepConfirmed ? candidates.filter(r => r.confidence !== 'CONFIRMED') : candidates;
1380
+ if (opts?.keepConfirmed)
1381
+ for (const r of candidates)
1382
+ if (r.confidence === 'CONFIRMED')
1383
+ refused.add(r.id);
976
1384
  if (rows.length > 0) {
977
1385
  const ids = rows.map(r => r.id);
978
1386
  db.prepare(`
@@ -983,7 +1391,7 @@ export class SqliteProvider {
983
1391
  invalidated += ids.length;
984
1392
  }
985
1393
  }
986
- return { invalidated };
1394
+ return opts?.keepConfirmed ? { invalidated, refused: [...refused] } : { invalidated };
987
1395
  }
988
1396
  async getLinked(id) {
989
1397
  const db = this.getDb();
@@ -1013,14 +1421,21 @@ export class SqliteProvider {
1013
1421
  //
1014
1422
  // Superseded rows are excluded (they are already retired) and the input ids are
1015
1423
  // never echoed back. `limit` caps the total, since this rides into a prompt.
1016
- async relatedClaims(ids, limit = 5) {
1424
+ //
1425
+ // `filter` (optional) applies the same retrieval-trust filters kb_query's
1426
+ // direct hits use, so a CONFIRMED-only caller cannot be handed an INFERRED or
1427
+ // disputed claim through the graph instead.
1428
+ async relatedClaims(ids, limit = 5, filter) {
1017
1429
  if (ids.length === 0)
1018
1430
  return [];
1019
1431
  const db = this.getDb();
1020
1432
  const ph = ids.map(() => '?').join(',');
1433
+ const trust = trustFilterSql(filter);
1434
+ const trustWhere = trust.conditions.map(c => `AND ${c}`).join(' ');
1021
1435
  const rows = db.prepare(`
1022
1436
  SELECT DISTINCT e.* FROM entries e
1023
1437
  WHERE e.superseded_at IS NULL
1438
+ ${trustWhere}
1024
1439
  AND e.id NOT IN (${ph})
1025
1440
  AND (
1026
1441
  EXISTS (
@@ -1033,13 +1448,13 @@ export class SqliteProvider {
1033
1448
  OR e.id IN (SELECT contradiction_of FROM entries WHERE id IN (${ph}) AND contradiction_of IS NOT NULL)
1034
1449
  )
1035
1450
  LIMIT ?
1036
- `).all(...ids, ...ids, ...ids, ...ids, ...ids, limit);
1451
+ `).all(...trust.params, ...ids, ...ids, ...ids, ...ids, ...ids, limit);
1037
1452
  return rows.map(r => this.rowToEntry(r));
1038
1453
  }
1039
1454
  async prime(opts) {
1040
1455
  this.decayConceptEntries(this.getDb(), opts.decay_after_days ?? 30);
1041
1456
  const fileResults = opts.session_files?.length
1042
- ? await this.context(opts.session_files)
1457
+ ? await this.context(opts.session_files, opts.confidence, opts.exclude_disputed, opts.owner_tag)
1043
1458
  : [];
1044
1459
  const stale_files = fileResults
1045
1460
  .filter(r => r.status === 'stale' || r.status === 'missing')
@@ -1065,6 +1480,9 @@ export class SqliteProvider {
1065
1480
  l1_only: true,
1066
1481
  limit: 10,
1067
1482
  include_stale: false,
1483
+ confidence: opts.confidence,
1484
+ exclude_disputed: opts.exclude_disputed,
1485
+ owner_tag: opts.owner_tag,
1068
1486
  });
1069
1487
  top_entries = l1.results
1070
1488
  .filter(e => e.type !== 'context-cache')
@@ -1118,15 +1536,21 @@ export class SqliteProvider {
1118
1536
  // CONFIRMED set what we think it is") which should not perturb that
1119
1537
  // telemetry. A dedicated method keeps the two contracts textually distinct
1120
1538
  // instead of an easy-to-miss opt-out flag threaded through query(). Always
1121
- // excludes superseded and stale entries (no override -- this is an
1122
- // audit-the-live-set tool, not a full-history query).
1539
+ // excludes superseded entries, and stale ones unless include_stale is set
1540
+ // (kb_list never sets it -- it is an audit-the-live-set tool, not a
1541
+ // full-history query; the kb-server ownership lookup does).
1123
1542
  async list(opts) {
1124
1543
  const db = this.getDb();
1125
- const conditions = ['e.superseded_at IS NULL', 'e.stale = 0'];
1544
+ const conditions = ['e.superseded_at IS NULL'];
1545
+ if (!opts.include_stale)
1546
+ conditions.push('e.stale = 0');
1126
1547
  const params = [];
1127
- if (opts.confidence) {
1128
- conditions.push('e.confidence = ?');
1129
- params.push(opts.confidence);
1548
+ if (opts.exclude_disputed) {
1549
+ conditions.push('e.flagged_for_review = 0 AND e.contradiction_of IS NULL');
1550
+ }
1551
+ if (opts.confidence?.length) {
1552
+ conditions.push(`e.confidence IN (${opts.confidence.map(() => '?').join(',')})`);
1553
+ params.push(...opts.confidence);
1130
1554
  }
1131
1555
  if (opts.type) {
1132
1556
  conditions.push('e.type = ?');
@@ -1144,6 +1568,10 @@ export class SqliteProvider {
1144
1568
  conditions.push('EXISTS (SELECT 1 FROM json_each(e.tags) WHERE value = ?)');
1145
1569
  params.push(opts.tag);
1146
1570
  }
1571
+ if (opts.owner_tag) {
1572
+ conditions.push('EXISTS (SELECT 1 FROM json_each(e.tags) WHERE value = ?)');
1573
+ params.push(opts.owner_tag);
1574
+ }
1147
1575
  const where = 'WHERE ' + conditions.join(' AND ');
1148
1576
  const limitClause = opts.limit !== undefined ? 'LIMIT ?' : '';
1149
1577
  if (opts.limit !== undefined)
@@ -1156,12 +1584,16 @@ export class SqliteProvider {
1156
1584
  `).all(...params);
1157
1585
  return rows.map(r => this.rowToEntry(r));
1158
1586
  }
1159
- async promote(id, reason) {
1587
+ async promote(id, reason, opts) {
1160
1588
  const db = this.getDb();
1161
1589
  const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
1162
1590
  if (!row)
1163
1591
  throw new Error(`Entry not found: ${id}`);
1164
1592
  const entry = this.rowToEntry(row);
1593
+ // MEMBER own-scope: an entry the caller did not capture is indistinguishable
1594
+ // from an unknown id (same message, so its existence is not disclosed).
1595
+ if (opts?.ownerTag && !entry.tags.includes(opts.ownerTag))
1596
+ throw new Error(`Entry not found: ${id}`);
1165
1597
  if (entry.superseded_at)
1166
1598
  throw new Error(`Cannot promote superseded entry: ${id}`);
1167
1599
  // H1 (F1, D1, closes yashr-9ha): promote() REFUSES any user-directive entry.
@@ -1225,6 +1657,235 @@ export class SqliteProvider {
1225
1657
  .run(confidence_after, now, newContent, 'promotion', id);
1226
1658
  return { id, confidence_before, confidence_after };
1227
1659
  }
1660
+ /**
1661
+ * Evidence paths cited by a demote. Deliberately STRICTER than the basis
1662
+ * check promote() runs: a demote reason is an audit record, so a path that
1663
+ * cannot be pointed at inside this provider's anchor is refused rather than
1664
+ * recorded as an unverifiable string.
1665
+ *
1666
+ * Refuses, all with E-DEMOTE-EVIDENCE-UNRESOLVED:
1667
+ * - any path that is not anchor-relative -- an ABSOLUTE path, or one with
1668
+ * a '..' segment. Both are "out of the anchor": an absolute path names a
1669
+ * location the anchor does not contain, and was previously accepted and
1670
+ * recorded verbatim, which contradicted this very comment. The check is
1671
+ * delegated to validateFilePaths (path-validation.ts), the SAME guard
1672
+ * every other caller-supplied kb_* file list already runs (kb_capture,
1673
+ * kb_context, kb_invalidate, kb_session_prime and the HTTP routes), so
1674
+ * this is not a third hand-rolled path guard. It runs BEFORE existence,
1675
+ * so a path that happens to land on a real file outside the repo is
1676
+ * still refused, and it applies even on the shared-global no-anchor KB,
1677
+ * where nothing absolute could be verified against an anchor anyway;
1678
+ * - a path that does not resolve, via the SAME resolver promote uses
1679
+ * (unresolvableBasisFiles -> resolveBasisFile);
1680
+ * - a path that resolves to something that is not a regular file
1681
+ * (directories are not evidence).
1682
+ */
1683
+ assertResolvableDemoteEvidence(id, files) {
1684
+ const refuse = (why, offenders) => {
1685
+ throw new Error('E-DEMOTE-EVIDENCE-UNRESOLVED: kb_demote evidence ' + why + ': '
1686
+ + offenders.join(', ') + '. Entry: ' + id);
1687
+ };
1688
+ // Per-file so the message can name EVERY offender, not just the first one
1689
+ // validateFilePaths would throw on.
1690
+ const traversing = files.filter((f) => {
1691
+ try {
1692
+ validateFilePaths([f]);
1693
+ return false;
1694
+ }
1695
+ catch {
1696
+ return true;
1697
+ }
1698
+ });
1699
+ if (traversing.length > 0)
1700
+ refuse('is absolute or traverses out of the anchor', traversing);
1701
+ const unresolved = this.unresolvableBasisFiles(files);
1702
+ if (unresolved.length > 0)
1703
+ refuse('does not resolve', unresolved);
1704
+ const notFiles = files.filter((f) => {
1705
+ const resolved = this.resolveBasisFile(f);
1706
+ try {
1707
+ return !fs.statSync(resolved).isFile();
1708
+ }
1709
+ catch {
1710
+ // Unreadable here means unresolvableBasisFiles already cleared it (the
1711
+ // shared-global no-anchor case); nothing further to assert.
1712
+ return false;
1713
+ }
1714
+ });
1715
+ if (notFiles.length > 0)
1716
+ refuse('is not a file', notFiles);
1717
+ }
1718
+ /**
1719
+ * The demote-time basis snapshot: sha256 of each cited source file AS IT IS
1720
+ * ON DISK RIGHT NOW, keyed by the original (unresolved) path string, the
1721
+ * same key convention source_file_hashes uses.
1722
+ *
1723
+ * This MUST NOT be derived from the source_file_hashes column. That column
1724
+ * is the CAPTURE-time basis; copying it was the defect in the superseded
1725
+ * upstream attempt, and it silently breaks the ping-pong guard that asks
1726
+ * whether the tree has moved on SINCE the demotion. Files that cannot be
1727
+ * read are simply absent from the map (a demote is still allowed on an
1728
+ * entry whose basis has since disappeared -- unlike promote, which refuses).
1729
+ *
1730
+ * sha256 and not `git hash-object`: this snapshot is compared against a
1731
+ * later re-read of the same files by the same code, so it must not depend on
1732
+ * git being available or on the file being in a work tree.
1733
+ */
1734
+ demoteBasisHashes(files) {
1735
+ const hashes = {};
1736
+ for (const f of files) {
1737
+ try {
1738
+ hashes[f] = createHash('sha256').update(fs.readFileSync(this.resolveBasisFile(f))).digest('hex');
1739
+ }
1740
+ catch {
1741
+ // Unreadable/absent basis file: no entry, never a fabricated hash.
1742
+ }
1743
+ }
1744
+ return hashes;
1745
+ }
1746
+ /**
1747
+ * kb_demote: withdraw trust from a CONFIRMED entry, CONFIRMED -> INFERRED.
1748
+ *
1749
+ * The inverse of promote() in intent but NOT its mirror image in mechanics:
1750
+ *
1751
+ * - it is NOT a ladder. Only CONFIRMED is demotable; INFERRED/UNVERIFIED
1752
+ * are REFUSED (E-DEMOTE-NOT-CONFIRMED), never silently returned as a
1753
+ * no-op, so a caller can never believe it lowered trust that was already
1754
+ * at the floor;
1755
+ * - promoted_at and source are left untouched. promote() stamps
1756
+ * source='promotion'; a demotion must not erase the provenance of the
1757
+ * promotion it is reversing, and promoted_at stays as the record of when
1758
+ * the (now withdrawn) trust was granted;
1759
+ * - a STALE entry MAY be demoted. Staleness is a freshness verdict, trust
1760
+ * is a separate axis, and the entries most worth demoting are exactly the
1761
+ * ones the sweep has already flagged;
1762
+ * - evidence is REQUIRED, like promote's resolvable basis: at least one
1763
+ * evidence file, each of which must resolve inside the anchor
1764
+ * (E-DEMOTE-EVIDENCE-UNRESOLVED otherwise).
1765
+ *
1766
+ * EVERY refusal is checked BEFORE any write, in the order below, and the
1767
+ * order is load-bearing: the own-scope/unknown-id check comes first so a
1768
+ * member can never learn that an entry it does not own exists by probing for
1769
+ * a different refusal message.
1770
+ */
1771
+ async demote(id, reason, evidenceFiles, opts) {
1772
+ const db = this.getDb();
1773
+ const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
1774
+ // (1) Unknown id. MEMBER own-scope: an entry the caller did not capture is
1775
+ // indistinguishable from an unknown id -- the SAME message as promote(),
1776
+ // so its existence is not disclosed.
1777
+ if (!row)
1778
+ throw new Error('Entry not found: ' + id);
1779
+ const entry = this.rowToEntry(row);
1780
+ if (opts?.ownerTag && !entry.tags.includes(opts.ownerTag))
1781
+ throw new Error('Entry not found: ' + id);
1782
+ // (2) Superseded: the row is already out of every read path, so lowering
1783
+ // its confidence would be a write with no observable meaning.
1784
+ if (entry.superseded_at) {
1785
+ throw new Error('E-DEMOTE-SUPERSEDED: cannot demote a superseded entry. Entry: ' + id);
1786
+ }
1787
+ // (3) user-directive: directives are human-terminal in BOTH directions.
1788
+ // promote() refuses them so kb_promote cannot forge an active directive;
1789
+ // demote() refuses them so an agent cannot deactivate one the human set.
1790
+ if (entry.type === 'user-directive') {
1791
+ throw new Error('E-DEMOTE-REFUSED-DIRECTIVE: cannot demote a user-directive via kb_demote: directive state is '
1792
+ + 'human-terminal only. Run `apra-fleet kb reject-directive ' + id + '` to discard it. Entry: ' + id);
1793
+ }
1794
+ // (4) Not CONFIRMED. A REFUSAL, not a no-op return: see the method comment.
1795
+ if (entry.confidence !== 'CONFIRMED') {
1796
+ throw new Error('E-DEMOTE-NOT-CONFIRMED: kb_demote lowers CONFIRMED to INFERRED only; this entry is '
1797
+ + entry.confidence + '. Entry: ' + id);
1798
+ }
1799
+ // (5) Reason floor, measured on the normalised reason -- so a reason made
1800
+ // only of newlines collapses to empty and is refused here.
1801
+ const normalizedReason = normalizeDemoteReason(reason);
1802
+ if (normalizedReason.length < MIN_DEMOTE_REASON_LENGTH) {
1803
+ throw new Error('E-DEMOTE-REASON-REQUIRED: kb_demote requires a reason recording why trust is being withdrawn '
1804
+ + '(at least ' + MIN_DEMOTE_REASON_LENGTH + ' characters after collapsing newlines and trimming). Entry: ' + id);
1805
+ }
1806
+ // (6) Evidence: REQUIRED, like promote's basis. Withdrawing trust needs a
1807
+ // resolvable reason to believe less, not only a written one.
1808
+ const evidence = evidenceFiles ?? [];
1809
+ if (evidence.length === 0) {
1810
+ throw new Error('E-DEMOTE-EVIDENCE-UNRESOLVED: kb_demote requires at least one evidence file backing the demotion '
1811
+ + '(evidence_files). Entry: ' + id);
1812
+ }
1813
+ this.assertResolvableDemoteEvidence(id, evidence);
1814
+ // --- no refusal remains: everything below writes ---
1815
+ const now = new Date().toISOString();
1816
+ // The note format (one leading newline, ASCII-safe concatenation, the
1817
+ // feedback-marker collision rule) lives in buildDemotionNote, shared with
1818
+ // the bible tombstone path so both demotions read identically.
1819
+ const demotionNote = buildDemotionNote(normalizedReason, evidence, entry.author);
1820
+ const newContent = truncateContent(entry.content + demotionNote);
1821
+ const confidence_before = entry.confidence;
1822
+ const confidence_after = 'INFERRED';
1823
+ // ONE update. promoted_at and source are deliberately absent from the SET.
1824
+ db.prepare('UPDATE entries SET confidence = ?, demoted_at = ?, demoted_basis_hashes = ?, content = ? WHERE id = ?').run(confidence_after, now, JSON.stringify(this.demoteBasisHashes(entry.source_files)), newContent, id);
1825
+ return { id, confidence_before, confidence_after };
1826
+ }
1827
+ /**
1828
+ * Apply ONE explicit demotion tombstone from a committed project bible to the
1829
+ * local row, so a demotion recorded on another clone actually lands here.
1830
+ *
1831
+ * Returns true only when a row was written. Every "no" is a silent false, not
1832
+ * a throw: a bible carries tombstones for the whole project and most clones
1833
+ * hold only some of those ids, so an inapplicable tombstone is the normal
1834
+ * case, not an error.
1835
+ *
1836
+ * The rules, each of which silently corrupts another clone's KB if got wrong:
1837
+ *
1838
+ * - NEVER CREATE. A tombstoned id with no local row stays absent. A
1839
+ * tombstone withdraws trust in a row; it is not a way to author one.
1840
+ * - ONE RE-PROMOTION RULE. Demote only when standingAgainstTombstone
1841
+ * (bible-import.ts) says 'withdrawn' for the row's bible trust time
1842
+ * (getBibleTrustTimes): promoted_at, else the updated_at the bible carried
1843
+ * at import -- never the local import time. kb_export uses the same rule to
1844
+ * decide whether to re-add a tombstoned entry, so the two never disagree.
1845
+ * - demoted_at is stamped with the TOMBSTONE's value, not now(): it records
1846
+ * when trust was withdrawn, which happened on the other clone. That value
1847
+ * is clamped to now (clampBibleTimeToNow), so a future-dated tombstone
1848
+ * never stores a demoted_at that every later re-promotion falls before.
1849
+ * - NO ownerTag CHECK. Bible-imported rows carry no member tag (see
1850
+ * importBibleEntries, which builds its input with tags: [] and author
1851
+ * 'unknown'), so an owner check here would make every imported row
1852
+ * permanently undemotable. The trust boundary for this path is the
1853
+ * git-reviewed bible file, not entry ownership.
1854
+ *
1855
+ * ABSENCE IS NEVER A DEMOTION: this method is only ever called for an id that
1856
+ * carries an EXPLICIT tombstone. A local CONFIRMED row merely missing from the
1857
+ * bible (a local-only promotion, or one refused by the basis filter) is never
1858
+ * passed here and must stay untouched.
1859
+ *
1860
+ * Two refusals are inherited from demote() because they are invariants of the
1861
+ * store, not of the local/remote distinction: a superseded row is already out
1862
+ * of every read path (the write would have no observable meaning), and a
1863
+ * user-directive is human-terminal in both directions -- a bible must not be
1864
+ * able to deactivate a directive a human set here.
1865
+ */
1866
+ applyBibleDemotion(id, tombstoneAt) {
1867
+ const db = this.getDb();
1868
+ const row = db.prepare('SELECT * FROM entries WHERE id = ?').get(id);
1869
+ // NEVER CREATE.
1870
+ if (!row)
1871
+ return false;
1872
+ const entry = this.rowToEntry(row);
1873
+ if (entry.confidence !== 'CONFIRMED')
1874
+ return false;
1875
+ if (entry.superseded_at)
1876
+ return false;
1877
+ if (entry.type === 'user-directive')
1878
+ return false;
1879
+ const demotedAt = clampBibleTimeToNow(tombstoneAt);
1880
+ if (standingAgainstTombstone(this.bibleTrustTimeOf(row), demotedAt) !== 'withdrawn')
1881
+ return false;
1882
+ const demotionNote = buildDemotionNote(BIBLE_DEMOTION_REASON, [], entry.author);
1883
+ const newContent = truncateContent(entry.content + demotionNote);
1884
+ // Same SET as demote(): promoted_at and source stay untouched, so the
1885
+ // provenance of the promotion being reversed survives.
1886
+ db.prepare('UPDATE entries SET confidence = ?, demoted_at = ?, demoted_basis_hashes = ?, content = ? WHERE id = ?').run('INFERRED', demotedAt, JSON.stringify(this.demoteBasisHashes(entry.source_files)), newContent, id);
1887
+ return true;
1888
+ }
1228
1889
  // T3.1 (F8, D7): kb_feedback downvote path -- marks an entry stale=1 +
1229
1890
  // flagged_for_review=1 and appends an ASCII feedback note. NEVER deletes,
1230
1891
  // NEVER touches confidence: a downvoted CONFIRMED entry stays
@@ -1390,7 +2051,7 @@ export class SqliteProvider {
1390
2051
  if (revivable) {
1391
2052
  const basis = this.parseBasis(refreshedRow.source_file_hashes ?? null);
1392
2053
  if (basis) {
1393
- const currentHashes = await computeFileHashBatch(Object.keys(basis));
2054
+ const currentHashes = await this.hashAnchored(Object.keys(basis));
1394
2055
  if (this.basisFullyMatches(basis, currentHashes)) {
1395
2056
  db.prepare('UPDATE entries SET stale = 0 WHERE id = ?').run(winnerId);
1396
2057
  }
@@ -1401,7 +2062,7 @@ export class SqliteProvider {
1401
2062
  // left as-is on the loser (harmless, and preserves which pair this row
1402
2063
  // was once part of for later inspection); only flagged_for_review is
1403
2064
  // cleared per the stated invariant.
1404
- db.prepare('UPDATE entries SET superseded_at = ?, stale = 1, flagged_for_review = 0 WHERE id = ?').run(now, loserId);
2065
+ db.prepare("UPDATE entries SET superseded_at = ?, stale = 1, flagged_for_review = 0, retired_reason = 'superseded' WHERE id = ?").run(now, loserId);
1405
2066
  return { winnerId, loserId };
1406
2067
  }
1407
2068
  // T3.1 (F5 step 3, D4 HARDENED, resolution R1): kb_reconcile_prefilter's
@@ -1410,7 +2071,9 @@ export class SqliteProvider {
1410
2071
  // union of every basis file across every pair -- same batching discipline as
1411
2072
  // freshnessSweep): exactly one side fully matches -> that side WINS
1412
2073
  // mechanically via resolveContradiction with the verbatim evidence string
1413
- // "hash-basis match on merged worktree". Both match, both mismatch, or
2074
+ // "hash-basis match on merged worktree" -- EXCEPT when the would-be loser is
2075
+ // CONFIRMED: a CONFIRMED entry is never retired by hash basis alone, so such
2076
+ // a pair is left for the reconciler agent. Both match, both mismatch, or
1414
2077
  // EITHER side has an empty/missing basis -> left untouched for the T3.2
1415
2078
  // reconciler agent. Directive pairs are already excluded by flaggedPairs()
1416
2079
  // itself (MEDIUM-3 liveness contract); the explicit re-check here is
@@ -1436,9 +2099,12 @@ export class SqliteProvider {
1436
2099
  const allIds = liveTouchable.flatMap(p => [p.original.id, p.challenger.id]);
1437
2100
  const basisById = new Map();
1438
2101
  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));
2102
+ // A local freshness-only basis (legacy bible import) counts as no basis
2103
+ // here: it was never verified, so it must not win a pair mechanically.
2104
+ const basisRows = db.prepare(`SELECT id, source_file_hashes, local_basis_only FROM entries WHERE id IN (${allIds.map(() => '?').join(',')})`).all(...allIds);
2105
+ for (const row of basisRows) {
2106
+ basisById.set(row.id, row.local_basis_only ? null : this.parseBasis(row.source_file_hashes));
2107
+ }
1442
2108
  }
1443
2109
  const fileSet = new Set();
1444
2110
  for (const basis of basisById.values()) {
@@ -1446,13 +2112,21 @@ export class SqliteProvider {
1446
2112
  for (const file of Object.keys(basis))
1447
2113
  fileSet.add(file);
1448
2114
  }
1449
- const currentHashes = await computeFileHashBatch([...fileSet]);
2115
+ const currentHashes = await this.hashAnchored([...fileSet]);
1450
2116
  for (const pair of liveTouchable) {
1451
2117
  const originalBasis = basisById.get(pair.original.id) ?? null;
1452
2118
  const challengerBasis = basisById.get(pair.challenger.id) ?? null;
1453
2119
  const originalMatches = originalBasis ? this.basisFullyMatches(originalBasis, currentHashes) : false;
1454
2120
  const challengerMatches = challengerBasis ? this.basisFullyMatches(challengerBasis, currentHashes) : false;
1455
- if (originalMatches && !challengerMatches) {
2121
+ // A CONFIRMED entry is never retired by hash basis alone: a member can
2122
+ // capture a contradiction against a drifted CONFIRMED entry, and basis
2123
+ // match is no content judgement. Defer to the reconciler agent.
2124
+ const wouldLose = originalMatches && !challengerMatches ? pair.challenger
2125
+ : challengerMatches && !originalMatches ? pair.original : null;
2126
+ if (wouldLose && wouldLose.confidence === 'CONFIRMED') {
2127
+ left_for_agent.push({ originalId: pair.original.id, challengerId: pair.challenger.id });
2128
+ }
2129
+ else if (originalMatches && !challengerMatches) {
1456
2130
  await this.resolveContradiction(pair.original.id, pair.challenger.id, 'hash-basis match on merged worktree');
1457
2131
  resolved.push({ winnerId: pair.original.id, loserId: pair.challenger.id });
1458
2132
  }