@apralabs/apra-fleet 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (997) hide show
  1. package/README.md +103 -34
  2. package/dist/agents/backlog-groomer.md +87 -14
  3. package/dist/agents/ci-watcher.md +35 -9
  4. package/dist/agents/deployer.md +63 -11
  5. package/dist/agents/doer.md +99 -41
  6. package/dist/agents/harvester.md +47 -27
  7. package/dist/agents/integ-test-runner.md +38 -10
  8. package/dist/agents/kb-reconciler.md +37 -7
  9. package/dist/agents/plan-reviewer.md +145 -32
  10. package/dist/agents/planner.md +180 -69
  11. package/dist/agents/regression-test-runner.md +98 -64
  12. package/dist/agents/reviewer.md +117 -45
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/doer-output.json +32 -0
  15. package/dist/agents/schemas/harvester-input.json +1 -5
  16. package/dist/agents/schemas/plan-reviewer-output.json +37 -0
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +62 -3
  20. package/dist/cli/agent-transform.d.ts +90 -2
  21. package/dist/cli/agent-transform.js +310 -20
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +66 -17
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +27 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/config.d.ts +31 -6
  31. package/dist/cli/config.js +113 -36
  32. package/dist/cli/dolt-install.d.ts +18 -2
  33. package/dist/cli/dolt-install.js +46 -15
  34. package/dist/cli/fleet-se-guard.d.ts +51 -0
  35. package/dist/cli/fleet-se-guard.js +215 -0
  36. package/dist/cli/install-guard.d.ts +54 -0
  37. package/dist/cli/install-guard.js +132 -4
  38. package/dist/cli/install.d.ts +100 -11
  39. package/dist/cli/install.js +864 -139
  40. package/dist/cli/kb-commit.d.ts +2 -1
  41. package/dist/cli/kb-commit.js +1 -1
  42. package/dist/cli/kb-directives.js +2 -1
  43. package/dist/cli/kb-import.d.ts +2 -1
  44. package/dist/cli/kb-import.js +1 -1
  45. package/dist/cli/register-member.js +26 -5
  46. package/dist/cli/remove-member.d.ts +4 -0
  47. package/dist/cli/remove-member.js +63 -0
  48. package/dist/cli/secret.js +9 -0
  49. package/dist/cli/start.js +59 -4
  50. package/dist/cli/status.d.ts +3 -0
  51. package/dist/cli/status.js +45 -12
  52. package/dist/cli/stop.js +64 -9
  53. package/dist/cli/uninstall.js +101 -15
  54. package/dist/cli/update.js +33 -2
  55. package/dist/cli/watch.js +1 -1
  56. package/dist/cli/workflow.js +3 -2
  57. package/dist/commands/kb-server.d.ts +3 -0
  58. package/dist/commands/kb-server.js +52 -5
  59. package/dist/hub-service/http-server.d.ts +5 -1
  60. package/dist/hub-service/http-server.js +55 -5
  61. package/dist/index.js +158 -11
  62. package/dist/os/child-env-bound.d.ts +77 -0
  63. package/dist/os/child-env-bound.js +171 -0
  64. package/dist/os/linux.d.ts +13 -2
  65. package/dist/os/linux.js +75 -16
  66. package/dist/os/macos.d.ts +1 -1
  67. package/dist/os/macos.js +2 -11
  68. package/dist/os/os-commands.d.ts +78 -4
  69. package/dist/os/windows-gitbash.d.ts +6 -0
  70. package/dist/os/windows-gitbash.js +32 -3
  71. package/dist/os/windows-wrapper.d.ts +0 -4
  72. package/dist/os/windows-wrapper.js +2 -1
  73. package/dist/os/windows.d.ts +11 -2
  74. package/dist/os/windows.js +121 -32
  75. package/dist/paths.d.ts +21 -0
  76. package/dist/paths.js +35 -0
  77. package/dist/providers/agy.d.ts +120 -7
  78. package/dist/providers/agy.js +741 -86
  79. package/dist/providers/claude-permission-denial.d.ts +7 -0
  80. package/dist/providers/claude-permission-denial.js +137 -0
  81. package/dist/providers/claude.d.ts +132 -6
  82. package/dist/providers/claude.js +644 -48
  83. package/dist/providers/codex.d.ts +4 -2
  84. package/dist/providers/codex.js +23 -2
  85. package/dist/providers/copilot.d.ts +4 -2
  86. package/dist/providers/copilot.js +24 -2
  87. package/dist/providers/none.d.ts +4 -2
  88. package/dist/providers/none.js +17 -2
  89. package/dist/providers/opencode.d.ts +12 -2
  90. package/dist/providers/opencode.js +135 -54
  91. package/dist/providers/provider.d.ts +368 -35
  92. package/dist/providers/provider.js +219 -2
  93. package/dist/services/agent-provisioner.d.ts +29 -0
  94. package/dist/services/agent-provisioner.js +107 -0
  95. package/dist/services/agent-shadow.d.ts +96 -0
  96. package/dist/services/agent-shadow.js +479 -0
  97. package/dist/services/agy-project.d.ts +103 -0
  98. package/dist/services/agy-project.js +354 -0
  99. package/dist/services/auth-socket.d.ts +25 -0
  100. package/dist/services/auth-socket.js +72 -27
  101. package/dist/services/auth-web.js +2 -2
  102. package/dist/services/budget-awareness.d.ts +11 -11
  103. package/dist/services/budget-awareness.js +15 -3
  104. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  105. package/dist/services/claude-local-scope-mcp.js +91 -0
  106. package/dist/services/cloud/aws.js +2 -1
  107. package/dist/services/cloud/lifecycle.js +52 -6
  108. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  109. package/dist/services/cloud/task-wrapper.js +15 -6
  110. package/dist/services/credential-cleanup.js +35 -17
  111. package/dist/services/event-loop-watchdog.d.ts +32 -0
  112. package/dist/services/event-loop-watchdog.js +140 -0
  113. package/dist/services/exit-drain.d.ts +44 -0
  114. package/dist/services/exit-drain.js +52 -0
  115. package/dist/services/github-app.js +32 -4
  116. package/dist/services/http-transport.d.ts +50 -1
  117. package/dist/services/http-transport.js +238 -25
  118. package/dist/services/in-flight-agents.d.ts +2 -0
  119. package/dist/services/in-flight-agents.js +4 -0
  120. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  121. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  122. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  123. package/dist/services/knowledge/bible-blob-id.js +113 -0
  124. package/dist/services/knowledge/bible-import.d.ts +65 -0
  125. package/dist/services/knowledge/bible-import.js +211 -0
  126. package/dist/services/knowledge/file-hash.d.ts +31 -0
  127. package/dist/services/knowledge/file-hash.js +153 -23
  128. package/dist/services/knowledge/http-provider.d.ts +4 -3
  129. package/dist/services/knowledge/http-provider.js +17 -5
  130. package/dist/services/knowledge/kb-config.d.ts +42 -0
  131. package/dist/services/knowledge/kb-config.js +54 -0
  132. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  133. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  134. package/dist/services/knowledge/kb-providers.d.ts +11 -1
  135. package/dist/services/knowledge/kb-providers.js +199 -17
  136. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  137. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  138. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  139. package/dist/services/knowledge/kb-scopes.js +47 -0
  140. package/dist/services/knowledge/kb-self.d.ts +91 -0
  141. package/dist/services/knowledge/kb-self.js +198 -0
  142. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  143. package/dist/services/knowledge/member-bible-view.js +194 -0
  144. package/dist/services/knowledge/pre-init.js +1 -0
  145. package/dist/services/knowledge/project-slug.js +2 -2
  146. package/dist/services/knowledge/require-sqlite-project.d.ts +32 -0
  147. package/dist/services/knowledge/require-sqlite-project.js +38 -0
  148. package/dist/services/knowledge/sqlite-provider.d.ts +64 -11
  149. package/dist/services/knowledge/sqlite-provider.js +303 -41
  150. package/dist/services/knowledge/types.d.ts +45 -2
  151. package/dist/services/member-access-secret.d.ts +70 -0
  152. package/dist/services/member-access-secret.js +195 -0
  153. package/dist/services/member-call-counts.d.ts +24 -0
  154. package/dist/services/member-call-counts.js +58 -0
  155. package/dist/services/member-config-io.d.ts +192 -0
  156. package/dist/services/member-config-io.js +443 -0
  157. package/dist/services/member-fleet-install.d.ts +710 -0
  158. package/dist/services/member-fleet-install.js +1895 -0
  159. package/dist/services/member-secret-env.d.ts +42 -0
  160. package/dist/services/member-secret-env.js +68 -0
  161. package/dist/services/member-tool-allowlist.d.ts +49 -0
  162. package/dist/services/member-tool-allowlist.js +111 -0
  163. package/dist/services/model-pricing.d.ts +19 -0
  164. package/dist/services/model-pricing.js +60 -10
  165. package/dist/services/port-holder.d.ts +86 -0
  166. package/dist/services/port-holder.js +351 -0
  167. package/dist/services/preflight-check.js +2 -0
  168. package/dist/services/registry.d.ts +13 -2
  169. package/dist/services/registry.js +27 -1
  170. package/dist/services/relay-strategy.d.ts +2 -0
  171. package/dist/services/relay-strategy.js +8 -0
  172. package/dist/services/secret-token.d.ts +38 -0
  173. package/dist/services/secret-token.js +51 -0
  174. package/dist/services/server-lifecycle.d.ts +26 -0
  175. package/dist/services/server-lifecycle.js +85 -0
  176. package/dist/services/service-manager/index.d.ts +7 -1
  177. package/dist/services/service-manager/index.js +17 -4
  178. package/dist/services/service-manager/linux.d.ts +1 -1
  179. package/dist/services/service-manager/linux.js +15 -7
  180. package/dist/services/service-manager/macos.d.ts +11 -1
  181. package/dist/services/service-manager/macos.js +45 -7
  182. package/dist/services/service-manager/service-path.d.ts +24 -0
  183. package/dist/services/service-manager/service-path.js +55 -0
  184. package/dist/services/service-manager/types.d.ts +39 -2
  185. package/dist/services/service-manager/types.js +29 -0
  186. package/dist/services/service-manager/windows.d.ts +194 -3
  187. package/dist/services/service-manager/windows.js +705 -30
  188. package/dist/services/service-notice.d.ts +14 -0
  189. package/dist/services/service-notice.js +62 -0
  190. package/dist/services/service-start-guard.d.ts +20 -0
  191. package/dist/services/service-start-guard.js +86 -0
  192. package/dist/services/session-cost.d.ts +24 -0
  193. package/dist/services/session-cost.js +105 -0
  194. package/dist/services/session-mcp-config.d.ts +83 -0
  195. package/dist/services/session-mcp-config.js +211 -0
  196. package/dist/services/sftp.d.ts +34 -0
  197. package/dist/services/sftp.js +304 -76
  198. package/dist/services/shell-probe.d.ts +0 -24
  199. package/dist/services/shell-probe.js +28 -3
  200. package/dist/services/singleton.d.ts +68 -2
  201. package/dist/services/singleton.js +168 -11
  202. package/dist/services/sprint-coordination.js +9 -3
  203. package/dist/services/ssh.d.ts +27 -0
  204. package/dist/services/ssh.js +287 -40
  205. package/dist/services/stall/find-log-file.js +12 -5
  206. package/dist/services/stall/index.d.ts +1 -1
  207. package/dist/services/stall/read-log-tail.d.ts +23 -0
  208. package/dist/services/stall/read-log-tail.js +53 -12
  209. package/dist/services/stall/stall-detector.d.ts +78 -5
  210. package/dist/services/stall/stall-detector.js +296 -39
  211. package/dist/services/stall/stall-poller.d.ts +16 -0
  212. package/dist/services/stall/stall-poller.js +50 -6
  213. package/dist/services/stopped-marker.d.ts +16 -0
  214. package/dist/services/stopped-marker.js +55 -0
  215. package/dist/services/strategy.d.ts +33 -1
  216. package/dist/services/strategy.js +165 -19
  217. package/dist/services/substitution-engine.js +2 -2
  218. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  219. package/dist/services/supervisor-service-cleanup.js +332 -0
  220. package/dist/services/tool-registry.d.ts +8 -1
  221. package/dist/services/tool-registry.js +164 -61
  222. package/dist/services/tool-scope.d.ts +58 -0
  223. package/dist/services/tool-scope.js +99 -0
  224. package/dist/services/vcs/azure-devops.d.ts +66 -1
  225. package/dist/services/vcs/azure-devops.js +192 -21
  226. package/dist/services/vcs/types.d.ts +1 -1
  227. package/dist/services/watch/project-resolver.js +1 -0
  228. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  229. package/dist/skills/fleet-sprint-cli/SKILL.md +48 -6
  230. package/dist/skills/pm/SKILL.md +4 -4
  231. package/dist/skills/pm/cost.md +0 -3
  232. package/dist/skills/pm/fleet-addendum.md +2 -2
  233. package/dist/skills/pm/index.md +4 -2
  234. package/dist/skills/pm/kb-reconcile.md +29 -14
  235. package/dist/skills/pm/kb-review.md +1 -0
  236. package/dist/skills/pm/sprint.md +5 -5
  237. package/dist/tools/check-status.d.ts +60 -9
  238. package/dist/tools/check-status.js +211 -52
  239. package/dist/tools/child-id-allocator.d.ts +2 -2
  240. package/dist/tools/child-id-allocator.js +1 -1
  241. package/dist/tools/code-index-heal.d.ts +8 -0
  242. package/dist/tools/code-index-heal.js +21 -0
  243. package/dist/tools/code-index-state.d.ts +45 -0
  244. package/dist/tools/code-index-state.js +115 -0
  245. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  246. package/dist/tools/code-intelligence-freshness.js +1 -1
  247. package/dist/tools/code-intelligence-gitnexus.d.ts +30 -0
  248. package/dist/tools/code-intelligence-gitnexus.js +333 -57
  249. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  250. package/dist/tools/code-intelligence-readiness.d.ts +99 -0
  251. package/dist/tools/code-intelligence-readiness.js +206 -0
  252. package/dist/tools/code-intelligence-reindex.d.ts +195 -0
  253. package/dist/tools/code-intelligence-reindex.js +530 -50
  254. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  255. package/dist/tools/code-intelligence-telemetry.js +12 -3
  256. package/dist/tools/code-intelligence.d.ts +81 -31
  257. package/dist/tools/code-intelligence.js +156 -52
  258. package/dist/tools/compose-permissions.d.ts +63 -2
  259. package/dist/tools/compose-permissions.js +673 -72
  260. package/dist/tools/credential-store-set.js +1 -1
  261. package/dist/tools/execute-command.d.ts +11 -0
  262. package/dist/tools/execute-command.js +111 -32
  263. package/dist/tools/execute-prompt.d.ts +69 -12
  264. package/dist/tools/execute-prompt.js +1610 -895
  265. package/dist/tools/kb-bible-commit.d.ts +65 -0
  266. package/dist/tools/kb-bible-commit.js +239 -0
  267. package/dist/tools/kb-capture.d.ts +15 -11
  268. package/dist/tools/kb-capture.js +71 -16
  269. package/dist/tools/kb-context.d.ts +27 -7
  270. package/dist/tools/kb-context.js +60 -9
  271. package/dist/tools/kb-export.d.ts +98 -9
  272. package/dist/tools/kb-export.js +230 -92
  273. package/dist/tools/kb-feedback.d.ts +13 -9
  274. package/dist/tools/kb-feedback.js +16 -8
  275. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  276. package/dist/tools/kb-freshness-sweep.js +10 -8
  277. package/dist/tools/kb-harvest.d.ts +11 -7
  278. package/dist/tools/kb-harvest.js +7 -7
  279. package/dist/tools/kb-import.d.ts +26 -10
  280. package/dist/tools/kb-import.js +170 -159
  281. package/dist/tools/kb-invalidate.d.ts +17 -10
  282. package/dist/tools/kb-invalidate.js +41 -8
  283. package/dist/tools/kb-list.d.ts +14 -10
  284. package/dist/tools/kb-list.js +33 -11
  285. package/dist/tools/kb-promote.d.ts +11 -7
  286. package/dist/tools/kb-promote.js +14 -8
  287. package/dist/tools/kb-query.d.ts +21 -11
  288. package/dist/tools/kb-query.js +76 -13
  289. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  290. package/dist/tools/kb-reconcile-prefilter.js +13 -9
  291. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  292. package/dist/tools/kb-resolve-contradiction.js +10 -8
  293. package/dist/tools/kb-session-prime.d.ts +14 -7
  294. package/dist/tools/kb-session-prime.js +44 -44
  295. package/dist/tools/kb-setup.d.ts +11 -4
  296. package/dist/tools/kb-setup.js +146 -27
  297. package/dist/tools/kb-stats.d.ts +11 -10
  298. package/dist/tools/kb-stats.js +84 -82
  299. package/dist/tools/list-members.d.ts +2 -2
  300. package/dist/tools/list-members.js +6 -2
  301. package/dist/tools/member-detail.d.ts +5 -2
  302. package/dist/tools/member-detail.js +105 -17
  303. package/dist/tools/member-reservation.d.ts +60 -3
  304. package/dist/tools/member-reservation.js +61 -20
  305. package/dist/tools/provision-auth.d.ts +118 -1
  306. package/dist/tools/provision-auth.js +402 -92
  307. package/dist/tools/provision-vcs-auth.d.ts +93 -3
  308. package/dist/tools/provision-vcs-auth.js +209 -49
  309. package/dist/tools/receive-files.js +3 -1
  310. package/dist/tools/register-member.d.ts +44 -15
  311. package/dist/tools/register-member.js +175 -70
  312. package/dist/tools/remove-member.js +118 -15
  313. package/dist/tools/send-email.d.ts +2 -2
  314. package/dist/tools/send-files.js +6 -4
  315. package/dist/tools/session-stats.d.ts +17 -0
  316. package/dist/tools/session-stats.js +27 -0
  317. package/dist/tools/setup-git-app.js +11 -7
  318. package/dist/tools/shutdown-server.d.ts +2 -0
  319. package/dist/tools/shutdown-server.js +28 -1
  320. package/dist/tools/update-agent-cli.d.ts +19 -0
  321. package/dist/tools/update-agent-cli.js +59 -2
  322. package/dist/tools/update-member.d.ts +23 -17
  323. package/dist/tools/update-member.js +181 -18
  324. package/dist/tools/vcs-credential-exec.d.ts +127 -0
  325. package/dist/tools/vcs-credential-exec.js +203 -0
  326. package/dist/types.d.ts +111 -1
  327. package/dist/utils/agent-helpers.js +2 -0
  328. package/dist/utils/auth-env.d.ts +15 -4
  329. package/dist/utils/auth-env.js +52 -23
  330. package/dist/utils/find-on-path.d.ts +37 -0
  331. package/dist/utils/find-on-path.js +85 -0
  332. package/dist/utils/log-helpers.d.ts +37 -0
  333. package/dist/utils/log-helpers.js +108 -22
  334. package/dist/utils/owner-only-fs.d.ts +56 -0
  335. package/dist/utils/owner-only-fs.js +98 -0
  336. package/dist/utils/process-utils.d.ts +28 -0
  337. package/dist/utils/process-utils.js +68 -0
  338. package/dist/utils/prompt-errors.js +11 -2
  339. package/dist/utils/session-caller.d.ts +4 -2
  340. package/dist/utils/session-caller.js +3 -2
  341. package/dist/utils/shell-escape.d.ts +58 -3
  342. package/dist/utils/shell-escape.js +91 -5
  343. package/dist/utils/ssh-error-messages.js +3 -0
  344. package/dist/utils/vcs-provider-detect.d.ts +65 -0
  345. package/dist/utils/vcs-provider-detect.js +109 -0
  346. package/dist/utils/workspace-trust.d.ts +26 -0
  347. package/dist/utils/workspace-trust.js +91 -1
  348. package/dist/workflows/auto-sprint.js +397 -56
  349. package/package.json +15 -10
  350. package/packages/apra-fleet-client/package.json +2 -2
  351. package/packages/apra-fleet-client/src/client/api.mjs +864 -31
  352. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  353. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  354. package/packages/apra-fleet-client/src/client/errors.mjs +6 -2
  355. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  356. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +137 -0
  357. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  358. package/packages/apra-fleet-client/src/client/transport.mjs +37 -3
  359. package/packages/apra-fleet-se/apra-pm/agents/_shared/GRAPH-SEMANTICS.md +10 -2
  360. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +87 -14
  361. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +35 -9
  362. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +63 -11
  363. package/packages/apra-fleet-se/apra-pm/agents/doer.md +99 -41
  364. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +47 -27
  365. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +38 -10
  366. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +37 -7
  367. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +145 -32
  368. package/packages/apra-fleet-se/apra-pm/agents/planner.md +180 -69
  369. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +98 -64
  370. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +117 -45
  371. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  372. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +32 -0
  373. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  374. package/packages/apra-fleet-se/apra-pm/agents/schemas/plan-reviewer-output.json +37 -0
  375. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  377. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +62 -3
  378. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +4 -4
  379. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -3
  380. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +2 -2
  381. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +4 -2
  382. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  383. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  384. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +5 -5
  385. package/packages/apra-fleet-se/bin/cli.mjs +326 -48
  386. package/packages/apra-fleet-se/bin/serve.mjs +218 -11
  387. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +517 -0
  388. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  389. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +646 -0
  390. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +825 -0
  391. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +217 -0
  392. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  393. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +745 -0
  394. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +447 -0
  395. package/packages/apra-fleet-se/fleet-sprint/branch-ensure.mjs +96 -0
  396. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  397. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +20 -0
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +121 -15
  399. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +539 -0
  400. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  401. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +204 -0
  402. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +1310 -0
  403. package/packages/apra-fleet-se/fleet-sprint/dispatch-safety-guard.mjs +216 -4
  404. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +53 -15
  405. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +281 -0
  406. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +1 -1
  407. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  408. package/packages/apra-fleet-se/fleet-sprint/docs/run-sprint-cycle-prelude-decision.md +215 -0
  409. package/packages/apra-fleet-se/fleet-sprint/dolt-literal-guard.mjs +56 -1
  410. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +1327 -44
  411. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +470 -4
  412. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +501 -0
  413. package/packages/apra-fleet-se/fleet-sprint/fatal-diagnostics.mjs +134 -0
  414. package/packages/apra-fleet-se/fleet-sprint/full-db-fetch-guard.mjs +102 -0
  415. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +747 -0
  416. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +543 -0
  417. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +613 -0
  418. package/packages/apra-fleet-se/fleet-sprint/inline-ladder-guard.mjs +216 -0
  419. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  420. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  421. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  422. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1684 -0
  423. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  424. package/packages/apra-fleet-se/fleet-sprint/mcp-result.mjs +75 -0
  425. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  426. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  427. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  428. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +699 -0
  429. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +802 -0
  430. package/packages/apra-fleet-se/fleet-sprint/member-target.mjs +93 -0
  431. package/packages/apra-fleet-se/fleet-sprint/newtask-text.mjs +266 -0
  432. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  433. package/packages/apra-fleet-se/fleet-sprint/parent-notes-staleness.mjs +201 -0
  434. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +218 -0
  435. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +869 -0
  436. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +295 -0
  437. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +466 -0
  438. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +212 -0
  439. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +358 -0
  440. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +395 -0
  441. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +345 -0
  442. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +264 -0
  443. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +179 -0
  444. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +230 -0
  445. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +365 -0
  446. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +259 -0
  447. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +617 -0
  448. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +1434 -0
  449. package/packages/apra-fleet-se/fleet-sprint/round-session.mjs +100 -0
  450. package/packages/apra-fleet-se/fleet-sprint/runner.js +2289 -9928
  451. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +24 -0
  452. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +147 -12
  453. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +111 -0
  454. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +347 -0
  455. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +48 -6
  456. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +98 -25
  457. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +590 -0
  458. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +339 -0
  459. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +185 -0
  460. package/packages/apra-fleet-se/fleet-sprint/unbracketed-push-guard.mjs +234 -0
  461. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +218 -0
  462. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +1445 -0
  463. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +284 -23
  464. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +170 -21
  465. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +28 -0
  466. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +354 -0
  467. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +189 -16
  468. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +9 -4
  469. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  470. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +311 -22
  471. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +559 -0
  472. package/packages/apra-fleet-se/package.json +2 -2
  473. package/packages/apra-fleet-se/src/supervisor/api.mjs +919 -0
  474. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  475. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  476. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  477. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  478. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  479. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1659 -0
  480. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +350 -0
  481. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  482. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +279 -0
  483. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  484. package/packages/apra-fleet-se/src/supervisor/history.mjs +328 -0
  485. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +521 -0
  486. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  487. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  488. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  489. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  490. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  491. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +474 -0
  492. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  493. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  494. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  495. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  496. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  497. package/packages/apra-fleet-se/src/supervisor/server.mjs +399 -0
  498. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +542 -0
  499. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  500. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +987 -0
  501. package/packages/apra-fleet-workflow/package.json +1 -1
  502. package/packages/apra-fleet-workflow/src/viewer/index.mjs +81 -15
  503. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  504. package/packages/apra-fleet-workflow/src/workflow/index.mjs +118 -10
  505. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  506. package/skills/fleet/SKILL.md +8 -8
  507. package/skills/fleet/auth-azdevops.md +14 -3
  508. package/skills/fleet/auth-bitbucket.md +2 -2
  509. package/skills/fleet/auth-github.md +5 -4
  510. package/skills/fleet/onboarding.md +3 -3
  511. package/skills/fleet/permissions.md +14 -1
  512. package/skills/fleet/profiles/node.json +1 -1
  513. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  514. package/skills/fleet/troubleshooting.md +3 -3
  515. package/version.json +1 -1
  516. package/dist/cli/agent-transform.d.ts.map +0 -1
  517. package/dist/cli/agent-transform.js.map +0 -1
  518. package/dist/cli/auth.d.ts.map +0 -1
  519. package/dist/cli/auth.js.map +0 -1
  520. package/dist/cli/config.d.ts.map +0 -1
  521. package/dist/cli/config.js.map +0 -1
  522. package/dist/cli/dolt-install.d.ts.map +0 -1
  523. package/dist/cli/dolt-install.js.map +0 -1
  524. package/dist/cli/install-guard.d.ts.map +0 -1
  525. package/dist/cli/install-guard.js.map +0 -1
  526. package/dist/cli/install.d.ts.map +0 -1
  527. package/dist/cli/install.js.map +0 -1
  528. package/dist/cli/join.d.ts.map +0 -1
  529. package/dist/cli/join.js.map +0 -1
  530. package/dist/cli/kb-commit.d.ts.map +0 -1
  531. package/dist/cli/kb-commit.js.map +0 -1
  532. package/dist/cli/kb-directives.d.ts.map +0 -1
  533. package/dist/cli/kb-directives.js.map +0 -1
  534. package/dist/cli/kb-import.d.ts.map +0 -1
  535. package/dist/cli/kb-import.js.map +0 -1
  536. package/dist/cli/register-member.d.ts.map +0 -1
  537. package/dist/cli/register-member.js.map +0 -1
  538. package/dist/cli/restart.d.ts.map +0 -1
  539. package/dist/cli/restart.js.map +0 -1
  540. package/dist/cli/secret.d.ts.map +0 -1
  541. package/dist/cli/secret.js.map +0 -1
  542. package/dist/cli/spoke.d.ts.map +0 -1
  543. package/dist/cli/spoke.js.map +0 -1
  544. package/dist/cli/start.d.ts.map +0 -1
  545. package/dist/cli/start.js.map +0 -1
  546. package/dist/cli/status.d.ts.map +0 -1
  547. package/dist/cli/status.js.map +0 -1
  548. package/dist/cli/stop.d.ts.map +0 -1
  549. package/dist/cli/stop.js.map +0 -1
  550. package/dist/cli/uninstall.d.ts.map +0 -1
  551. package/dist/cli/uninstall.js.map +0 -1
  552. package/dist/cli/update.d.ts.map +0 -1
  553. package/dist/cli/update.js.map +0 -1
  554. package/dist/cli/watch.d.ts.map +0 -1
  555. package/dist/cli/watch.js.map +0 -1
  556. package/dist/cli/workflow-assets.d.ts.map +0 -1
  557. package/dist/cli/workflow-assets.js.map +0 -1
  558. package/dist/cli/workflow.d.ts.map +0 -1
  559. package/dist/cli/workflow.js.map +0 -1
  560. package/dist/commands/kb-server.d.ts.map +0 -1
  561. package/dist/commands/kb-server.js.map +0 -1
  562. package/dist/delivery-mode.d.ts.map +0 -1
  563. package/dist/delivery-mode.js.map +0 -1
  564. package/dist/hub-service/activity.d.ts.map +0 -1
  565. package/dist/hub-service/activity.js.map +0 -1
  566. package/dist/hub-service/audit-log.d.ts.map +0 -1
  567. package/dist/hub-service/audit-log.js.map +0 -1
  568. package/dist/hub-service/db/pool.d.ts.map +0 -1
  569. package/dist/hub-service/db/pool.js.map +0 -1
  570. package/dist/hub-service/enrollment.d.ts.map +0 -1
  571. package/dist/hub-service/enrollment.js.map +0 -1
  572. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  573. package/dist/hub-service/envelope-routes.js.map +0 -1
  574. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  575. package/dist/hub-service/handlers/installers.js.map +0 -1
  576. package/dist/hub-service/http-server.d.ts.map +0 -1
  577. package/dist/hub-service/http-server.js.map +0 -1
  578. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  579. package/dist/hub-service/hub-jwt.js.map +0 -1
  580. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  581. package/dist/hub-service/jwt-revocation.js.map +0 -1
  582. package/dist/hub-service/machines.d.ts.map +0 -1
  583. package/dist/hub-service/machines.js.map +0 -1
  584. package/dist/hub-service/main.d.ts.map +0 -1
  585. package/dist/hub-service/main.js.map +0 -1
  586. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  587. package/dist/hub-service/member-tokens.js.map +0 -1
  588. package/dist/hub-service/member-view.d.ts.map +0 -1
  589. package/dist/hub-service/member-view.js.map +0 -1
  590. package/dist/hub-service/members.d.ts.map +0 -1
  591. package/dist/hub-service/members.js.map +0 -1
  592. package/dist/hub-service/presence.d.ts.map +0 -1
  593. package/dist/hub-service/presence.js.map +0 -1
  594. package/dist/hub-service/project-view.d.ts.map +0 -1
  595. package/dist/hub-service/project-view.js.map +0 -1
  596. package/dist/hub-service/projects.d.ts.map +0 -1
  597. package/dist/hub-service/projects.js.map +0 -1
  598. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  599. package/dist/hub-service/relay-queue.js.map +0 -1
  600. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  601. package/dist/hub-service/session-jwt.js.map +0 -1
  602. package/dist/hub-service/usage.d.ts.map +0 -1
  603. package/dist/hub-service/usage.js.map +0 -1
  604. package/dist/hub-service/users.d.ts.map +0 -1
  605. package/dist/hub-service/users.js.map +0 -1
  606. package/dist/hub-service/workspaces.d.ts.map +0 -1
  607. package/dist/hub-service/workspaces.js.map +0 -1
  608. package/dist/index.d.ts.map +0 -1
  609. package/dist/index.js.map +0 -1
  610. package/dist/onboarding/text.d.ts.map +0 -1
  611. package/dist/onboarding/text.js.map +0 -1
  612. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  613. package/dist/os/git-bash-candidates.js.map +0 -1
  614. package/dist/os/index.d.ts.map +0 -1
  615. package/dist/os/index.js.map +0 -1
  616. package/dist/os/linux.d.ts.map +0 -1
  617. package/dist/os/linux.js.map +0 -1
  618. package/dist/os/macos.d.ts.map +0 -1
  619. package/dist/os/macos.js.map +0 -1
  620. package/dist/os/os-commands.d.ts.map +0 -1
  621. package/dist/os/os-commands.js.map +0 -1
  622. package/dist/os/windows-gitbash.d.ts.map +0 -1
  623. package/dist/os/windows-gitbash.js.map +0 -1
  624. package/dist/os/windows-wrapper.d.ts.map +0 -1
  625. package/dist/os/windows-wrapper.js.map +0 -1
  626. package/dist/os/windows.d.ts.map +0 -1
  627. package/dist/os/windows.js.map +0 -1
  628. package/dist/paths.d.ts.map +0 -1
  629. package/dist/paths.js.map +0 -1
  630. package/dist/providers/agy.d.ts.map +0 -1
  631. package/dist/providers/agy.js.map +0 -1
  632. package/dist/providers/claude.d.ts.map +0 -1
  633. package/dist/providers/claude.js.map +0 -1
  634. package/dist/providers/codex.d.ts.map +0 -1
  635. package/dist/providers/codex.js.map +0 -1
  636. package/dist/providers/copilot.d.ts.map +0 -1
  637. package/dist/providers/copilot.js.map +0 -1
  638. package/dist/providers/email/headers.d.ts.map +0 -1
  639. package/dist/providers/email/headers.js.map +0 -1
  640. package/dist/providers/email/index.d.ts.map +0 -1
  641. package/dist/providers/email/index.js.map +0 -1
  642. package/dist/providers/email/provider.d.ts.map +0 -1
  643. package/dist/providers/email/provider.js.map +0 -1
  644. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  645. package/dist/providers/email/sendgrid.js.map +0 -1
  646. package/dist/providers/email/smtp.d.ts.map +0 -1
  647. package/dist/providers/email/smtp.js.map +0 -1
  648. package/dist/providers/index.d.ts.map +0 -1
  649. package/dist/providers/index.js.map +0 -1
  650. package/dist/providers/none.d.ts.map +0 -1
  651. package/dist/providers/none.js.map +0 -1
  652. package/dist/providers/opencode.d.ts.map +0 -1
  653. package/dist/providers/opencode.js.map +0 -1
  654. package/dist/providers/provider.d.ts.map +0 -1
  655. package/dist/providers/provider.js.map +0 -1
  656. package/dist/services/agent-provisioner.d.ts.map +0 -1
  657. package/dist/services/agent-provisioner.js.map +0 -1
  658. package/dist/services/auth-socket.d.ts.map +0 -1
  659. package/dist/services/auth-socket.js.map +0 -1
  660. package/dist/services/auth-web.d.ts.map +0 -1
  661. package/dist/services/auth-web.js.map +0 -1
  662. package/dist/services/budget-awareness.d.ts.map +0 -1
  663. package/dist/services/budget-awareness.js.map +0 -1
  664. package/dist/services/cloud/activity.d.ts.map +0 -1
  665. package/dist/services/cloud/activity.js.map +0 -1
  666. package/dist/services/cloud/aws.d.ts.map +0 -1
  667. package/dist/services/cloud/aws.js.map +0 -1
  668. package/dist/services/cloud/cost.d.ts.map +0 -1
  669. package/dist/services/cloud/cost.js.map +0 -1
  670. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  671. package/dist/services/cloud/idle-manager.js.map +0 -1
  672. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  673. package/dist/services/cloud/lifecycle.js.map +0 -1
  674. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  675. package/dist/services/cloud/task-wrapper.js.map +0 -1
  676. package/dist/services/cloud/types.d.ts.map +0 -1
  677. package/dist/services/cloud/types.js.map +0 -1
  678. package/dist/services/cloud-sync.d.ts.map +0 -1
  679. package/dist/services/cloud-sync.js.map +0 -1
  680. package/dist/services/context-admission.d.ts.map +0 -1
  681. package/dist/services/context-admission.js.map +0 -1
  682. package/dist/services/credential-cleanup.d.ts.map +0 -1
  683. package/dist/services/credential-cleanup.js.map +0 -1
  684. package/dist/services/credential-store.d.ts.map +0 -1
  685. package/dist/services/credential-store.js.map +0 -1
  686. package/dist/services/event-bus.d.ts.map +0 -1
  687. package/dist/services/event-bus.js.map +0 -1
  688. package/dist/services/file-chunker.d.ts.map +0 -1
  689. package/dist/services/file-chunker.js.map +0 -1
  690. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  691. package/dist/services/file-transfer-relay.js.map +0 -1
  692. package/dist/services/file-transfer.d.ts.map +0 -1
  693. package/dist/services/file-transfer.js.map +0 -1
  694. package/dist/services/git-config.d.ts.map +0 -1
  695. package/dist/services/git-config.js.map +0 -1
  696. package/dist/services/github-app.d.ts.map +0 -1
  697. package/dist/services/github-app.js.map +0 -1
  698. package/dist/services/http-transport.d.ts.map +0 -1
  699. package/dist/services/http-transport.js.map +0 -1
  700. package/dist/services/hub-client.d.ts.map +0 -1
  701. package/dist/services/hub-client.js.map +0 -1
  702. package/dist/services/icons.d.ts.map +0 -1
  703. package/dist/services/icons.js.map +0 -1
  704. package/dist/services/jwt.d.ts.map +0 -1
  705. package/dist/services/jwt.js.map +0 -1
  706. package/dist/services/knowledge/audn.d.ts.map +0 -1
  707. package/dist/services/knowledge/audn.js.map +0 -1
  708. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  709. package/dist/services/knowledge/file-hash.js.map +0 -1
  710. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  711. package/dist/services/knowledge/http-provider.js.map +0 -1
  712. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  713. package/dist/services/knowledge/kb-providers.js.map +0 -1
  714. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  715. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  716. package/dist/services/knowledge/kb-scope-input.js +0 -11
  717. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  718. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  719. package/dist/services/knowledge/kb-service.js.map +0 -1
  720. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  721. package/dist/services/knowledge/path-validation.js.map +0 -1
  722. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  723. package/dist/services/knowledge/pre-init.js.map +0 -1
  724. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  725. package/dist/services/knowledge/project-slug.js.map +0 -1
  726. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  727. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  728. package/dist/services/knowledge/types.d.ts.map +0 -1
  729. package/dist/services/knowledge/types.js.map +0 -1
  730. package/dist/services/known-hosts.d.ts.map +0 -1
  731. package/dist/services/known-hosts.js.map +0 -1
  732. package/dist/services/known-sessions.d.ts.map +0 -1
  733. package/dist/services/known-sessions.js.map +0 -1
  734. package/dist/services/member-home.d.ts.map +0 -1
  735. package/dist/services/member-home.js.map +0 -1
  736. package/dist/services/member-remote-url.d.ts.map +0 -1
  737. package/dist/services/member-remote-url.js.map +0 -1
  738. package/dist/services/model-pricing.d.ts.map +0 -1
  739. package/dist/services/model-pricing.js.map +0 -1
  740. package/dist/services/onboarding.d.ts.map +0 -1
  741. package/dist/services/onboarding.js.map +0 -1
  742. package/dist/services/orphan-recovery.d.ts.map +0 -1
  743. package/dist/services/orphan-recovery.js.map +0 -1
  744. package/dist/services/pending-responses.d.ts.map +0 -1
  745. package/dist/services/pending-responses.js.map +0 -1
  746. package/dist/services/preflight-check.d.ts.map +0 -1
  747. package/dist/services/preflight-check.js.map +0 -1
  748. package/dist/services/registry.d.ts.map +0 -1
  749. package/dist/services/registry.js.map +0 -1
  750. package/dist/services/relay-context.d.ts.map +0 -1
  751. package/dist/services/relay-context.js.map +0 -1
  752. package/dist/services/relay-executor.d.ts.map +0 -1
  753. package/dist/services/relay-executor.js.map +0 -1
  754. package/dist/services/relay-request.d.ts.map +0 -1
  755. package/dist/services/relay-request.js.map +0 -1
  756. package/dist/services/relay-strategy.d.ts.map +0 -1
  757. package/dist/services/relay-strategy.js.map +0 -1
  758. package/dist/services/service-manager/index.d.ts.map +0 -1
  759. package/dist/services/service-manager/index.js.map +0 -1
  760. package/dist/services/service-manager/linux.d.ts.map +0 -1
  761. package/dist/services/service-manager/linux.js.map +0 -1
  762. package/dist/services/service-manager/macos.d.ts.map +0 -1
  763. package/dist/services/service-manager/macos.js.map +0 -1
  764. package/dist/services/service-manager/types.d.ts.map +0 -1
  765. package/dist/services/service-manager/types.js.map +0 -1
  766. package/dist/services/service-manager/windows.d.ts.map +0 -1
  767. package/dist/services/service-manager/windows.js.map +0 -1
  768. package/dist/services/session-registry.d.ts.map +0 -1
  769. package/dist/services/session-registry.js.map +0 -1
  770. package/dist/services/sftp.d.ts.map +0 -1
  771. package/dist/services/sftp.js.map +0 -1
  772. package/dist/services/shell-probe.d.ts.map +0 -1
  773. package/dist/services/shell-probe.js.map +0 -1
  774. package/dist/services/singleton.d.ts.map +0 -1
  775. package/dist/services/singleton.js.map +0 -1
  776. package/dist/services/sprint-coordination.d.ts.map +0 -1
  777. package/dist/services/sprint-coordination.js.map +0 -1
  778. package/dist/services/ssh.d.ts.map +0 -1
  779. package/dist/services/ssh.js.map +0 -1
  780. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  781. package/dist/services/stall/find-log-file.js.map +0 -1
  782. package/dist/services/stall/index.d.ts.map +0 -1
  783. package/dist/services/stall/index.js.map +0 -1
  784. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  785. package/dist/services/stall/log-path-resolver.js.map +0 -1
  786. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  787. package/dist/services/stall/read-log-tail.js.map +0 -1
  788. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  789. package/dist/services/stall/stall-detector.js.map +0 -1
  790. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  791. package/dist/services/stall/stall-poller.js.map +0 -1
  792. package/dist/services/stall/time-utils.d.ts.map +0 -1
  793. package/dist/services/stall/time-utils.js.map +0 -1
  794. package/dist/services/statusline.d.ts.map +0 -1
  795. package/dist/services/statusline.js.map +0 -1
  796. package/dist/services/strategy.d.ts.map +0 -1
  797. package/dist/services/strategy.js.map +0 -1
  798. package/dist/services/substitution-engine.d.ts.map +0 -1
  799. package/dist/services/substitution-engine.js.map +0 -1
  800. package/dist/services/task-cleanup.d.ts.map +0 -1
  801. package/dist/services/task-cleanup.js.map +0 -1
  802. package/dist/services/token-issuer.d.ts.map +0 -1
  803. package/dist/services/token-issuer.js.map +0 -1
  804. package/dist/services/tool-registry.d.ts.map +0 -1
  805. package/dist/services/tool-registry.js.map +0 -1
  806. package/dist/services/update-check.d.ts.map +0 -1
  807. package/dist/services/update-check.js.map +0 -1
  808. package/dist/services/user-config.d.ts.map +0 -1
  809. package/dist/services/user-config.js.map +0 -1
  810. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  811. package/dist/services/vcs/azure-devops.js.map +0 -1
  812. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  813. package/dist/services/vcs/bitbucket.js.map +0 -1
  814. package/dist/services/vcs/constants.d.ts.map +0 -1
  815. package/dist/services/vcs/constants.js.map +0 -1
  816. package/dist/services/vcs/github.d.ts.map +0 -1
  817. package/dist/services/vcs/github.js.map +0 -1
  818. package/dist/services/vcs/types.d.ts.map +0 -1
  819. package/dist/services/vcs/types.js.map +0 -1
  820. package/dist/services/version-check.d.ts.map +0 -1
  821. package/dist/services/version-check.js.map +0 -1
  822. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  823. package/dist/services/watch/fleet-log.js.map +0 -1
  824. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  825. package/dist/services/watch/project-resolver.js.map +0 -1
  826. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  827. package/dist/services/watch/transcript-formatter.js.map +0 -1
  828. package/dist/smoke-test.d.ts.map +0 -1
  829. package/dist/smoke-test.js.map +0 -1
  830. package/dist/tools/check-status.d.ts.map +0 -1
  831. package/dist/tools/check-status.js.map +0 -1
  832. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  833. package/dist/tools/child-id-allocator.js.map +0 -1
  834. package/dist/tools/cloud-control.d.ts.map +0 -1
  835. package/dist/tools/cloud-control.js.map +0 -1
  836. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  837. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  838. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  839. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  840. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  841. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  842. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  843. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  844. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  845. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  846. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  847. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  848. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  849. package/dist/tools/code-intelligence-tests.js.map +0 -1
  850. package/dist/tools/code-intelligence.d.ts.map +0 -1
  851. package/dist/tools/code-intelligence.js.map +0 -1
  852. package/dist/tools/compose-permissions.d.ts.map +0 -1
  853. package/dist/tools/compose-permissions.js.map +0 -1
  854. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  855. package/dist/tools/credential-store-delete.js.map +0 -1
  856. package/dist/tools/credential-store-list.d.ts.map +0 -1
  857. package/dist/tools/credential-store-list.js.map +0 -1
  858. package/dist/tools/credential-store-set.d.ts.map +0 -1
  859. package/dist/tools/credential-store-set.js.map +0 -1
  860. package/dist/tools/credential-store-update.d.ts.map +0 -1
  861. package/dist/tools/credential-store-update.js.map +0 -1
  862. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  863. package/dist/tools/dolt-push-mutex.js.map +0 -1
  864. package/dist/tools/execute-command.d.ts.map +0 -1
  865. package/dist/tools/execute-command.js.map +0 -1
  866. package/dist/tools/execute-prompt.d.ts.map +0 -1
  867. package/dist/tools/execute-prompt.js.map +0 -1
  868. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  869. package/dist/tools/get-member-model-pricing.js.map +0 -1
  870. package/dist/tools/kb-capture.d.ts.map +0 -1
  871. package/dist/tools/kb-capture.js.map +0 -1
  872. package/dist/tools/kb-context.d.ts.map +0 -1
  873. package/dist/tools/kb-context.js.map +0 -1
  874. package/dist/tools/kb-export.d.ts.map +0 -1
  875. package/dist/tools/kb-export.js.map +0 -1
  876. package/dist/tools/kb-feedback.d.ts.map +0 -1
  877. package/dist/tools/kb-feedback.js.map +0 -1
  878. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  879. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  880. package/dist/tools/kb-harvest.d.ts.map +0 -1
  881. package/dist/tools/kb-harvest.js.map +0 -1
  882. package/dist/tools/kb-import.d.ts.map +0 -1
  883. package/dist/tools/kb-import.js.map +0 -1
  884. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  885. package/dist/tools/kb-invalidate.js.map +0 -1
  886. package/dist/tools/kb-list.d.ts.map +0 -1
  887. package/dist/tools/kb-list.js.map +0 -1
  888. package/dist/tools/kb-promote.d.ts.map +0 -1
  889. package/dist/tools/kb-promote.js.map +0 -1
  890. package/dist/tools/kb-query.d.ts.map +0 -1
  891. package/dist/tools/kb-query.js.map +0 -1
  892. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  893. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  894. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  895. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  896. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  897. package/dist/tools/kb-session-prime.js.map +0 -1
  898. package/dist/tools/kb-setup.d.ts.map +0 -1
  899. package/dist/tools/kb-setup.js.map +0 -1
  900. package/dist/tools/kb-stats.d.ts.map +0 -1
  901. package/dist/tools/kb-stats.js.map +0 -1
  902. package/dist/tools/list-members.d.ts.map +0 -1
  903. package/dist/tools/list-members.js.map +0 -1
  904. package/dist/tools/member-detail.d.ts.map +0 -1
  905. package/dist/tools/member-detail.js.map +0 -1
  906. package/dist/tools/member-reservation.d.ts.map +0 -1
  907. package/dist/tools/member-reservation.js.map +0 -1
  908. package/dist/tools/monitor-task.d.ts.map +0 -1
  909. package/dist/tools/monitor-task.js.map +0 -1
  910. package/dist/tools/provision-auth.d.ts.map +0 -1
  911. package/dist/tools/provision-auth.js.map +0 -1
  912. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  913. package/dist/tools/provision-vcs-auth.js.map +0 -1
  914. package/dist/tools/receive-files.d.ts.map +0 -1
  915. package/dist/tools/receive-files.js.map +0 -1
  916. package/dist/tools/register-member.d.ts.map +0 -1
  917. package/dist/tools/register-member.js.map +0 -1
  918. package/dist/tools/remove-member.d.ts.map +0 -1
  919. package/dist/tools/remove-member.js.map +0 -1
  920. package/dist/tools/report-status.d.ts.map +0 -1
  921. package/dist/tools/report-status.js.map +0 -1
  922. package/dist/tools/respond-to-message.d.ts.map +0 -1
  923. package/dist/tools/respond-to-message.js.map +0 -1
  924. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  925. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  926. package/dist/tools/send-email.d.ts.map +0 -1
  927. package/dist/tools/send-email.js.map +0 -1
  928. package/dist/tools/send-files.d.ts.map +0 -1
  929. package/dist/tools/send-files.js.map +0 -1
  930. package/dist/tools/send-message.d.ts.map +0 -1
  931. package/dist/tools/send-message.js.map +0 -1
  932. package/dist/tools/setup-git-app.d.ts.map +0 -1
  933. package/dist/tools/setup-git-app.js.map +0 -1
  934. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  935. package/dist/tools/setup-ssh-key.js.map +0 -1
  936. package/dist/tools/shutdown-server.d.ts.map +0 -1
  937. package/dist/tools/shutdown-server.js.map +0 -1
  938. package/dist/tools/stop-prompt.d.ts.map +0 -1
  939. package/dist/tools/stop-prompt.js.map +0 -1
  940. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  941. package/dist/tools/update-agent-cli.js.map +0 -1
  942. package/dist/tools/update-member.d.ts.map +0 -1
  943. package/dist/tools/update-member.js.map +0 -1
  944. package/dist/tools/version.d.ts.map +0 -1
  945. package/dist/tools/version.js.map +0 -1
  946. package/dist/types.d.ts.map +0 -1
  947. package/dist/types.js.map +0 -1
  948. package/dist/utils/agent-helpers.d.ts.map +0 -1
  949. package/dist/utils/agent-helpers.js.map +0 -1
  950. package/dist/utils/ansi.d.ts.map +0 -1
  951. package/dist/utils/ansi.js.map +0 -1
  952. package/dist/utils/auth-env.d.ts.map +0 -1
  953. package/dist/utils/auth-env.js.map +0 -1
  954. package/dist/utils/collect-secret.d.ts.map +0 -1
  955. package/dist/utils/collect-secret.js.map +0 -1
  956. package/dist/utils/credential-validation.d.ts.map +0 -1
  957. package/dist/utils/credential-validation.js.map +0 -1
  958. package/dist/utils/crypto.d.ts.map +0 -1
  959. package/dist/utils/crypto.js.map +0 -1
  960. package/dist/utils/deep-merge.d.ts.map +0 -1
  961. package/dist/utils/deep-merge.js.map +0 -1
  962. package/dist/utils/file-permissions.d.ts.map +0 -1
  963. package/dist/utils/file-permissions.js.map +0 -1
  964. package/dist/utils/gpu-parser.d.ts.map +0 -1
  965. package/dist/utils/gpu-parser.js.map +0 -1
  966. package/dist/utils/log-helpers.d.ts.map +0 -1
  967. package/dist/utils/log-helpers.js.map +0 -1
  968. package/dist/utils/oob-timeout.d.ts.map +0 -1
  969. package/dist/utils/oob-timeout.js.map +0 -1
  970. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  971. package/dist/utils/opencode-model-validation.js.map +0 -1
  972. package/dist/utils/pid-helpers.d.ts.map +0 -1
  973. package/dist/utils/pid-helpers.js.map +0 -1
  974. package/dist/utils/platform.d.ts.map +0 -1
  975. package/dist/utils/platform.js.map +0 -1
  976. package/dist/utils/process-utils.d.ts.map +0 -1
  977. package/dist/utils/process-utils.js.map +0 -1
  978. package/dist/utils/prompt-errors.d.ts.map +0 -1
  979. package/dist/utils/prompt-errors.js.map +0 -1
  980. package/dist/utils/resolve-member.d.ts.map +0 -1
  981. package/dist/utils/resolve-member.js.map +0 -1
  982. package/dist/utils/secure-input.d.ts.map +0 -1
  983. package/dist/utils/secure-input.js.map +0 -1
  984. package/dist/utils/session-caller.d.ts.map +0 -1
  985. package/dist/utils/session-caller.js.map +0 -1
  986. package/dist/utils/shell-escape.d.ts.map +0 -1
  987. package/dist/utils/shell-escape.js.map +0 -1
  988. package/dist/utils/skill-matrix.d.ts.map +0 -1
  989. package/dist/utils/skill-matrix.js.map +0 -1
  990. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  991. package/dist/utils/ssh-error-messages.js.map +0 -1
  992. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  993. package/dist/utils/work-folder-validation.js.map +0 -1
  994. package/dist/utils/workspace-trust.d.ts.map +0 -1
  995. package/dist/utils/workspace-trust.js.map +0 -1
  996. package/dist/version.d.ts.map +0 -1
  997. package/dist/version.js.map +0 -1
@@ -0,0 +1,65 @@
1
+ import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
3
+ export declare const kbBibleCommitSchema: z.ZodObject<{
4
+ repo_path: z.ZodOptional<z.ZodUnknown>;
5
+ repo: z.ZodOptional<z.ZodUnknown>;
6
+ repo_remote_url: z.ZodOptional<z.ZodUnknown>;
7
+ ids: z.ZodArray<z.ZodString, "many">;
8
+ baseBranch: z.ZodString;
9
+ baseCommit: z.ZodString;
10
+ }, "strip", z.ZodTypeAny, {
11
+ baseBranch: string;
12
+ baseCommit: string;
13
+ ids: string[];
14
+ repo?: unknown;
15
+ repo_path?: unknown;
16
+ repo_remote_url?: unknown;
17
+ }, {
18
+ baseBranch: string;
19
+ baseCommit: string;
20
+ ids: string[];
21
+ repo?: unknown;
22
+ repo_path?: unknown;
23
+ repo_remote_url?: unknown;
24
+ }>;
25
+ export type KbBibleCommitInput = z.infer<typeof kbBibleCommitSchema>;
26
+ /**
27
+ * Why a requested id was not merged:
28
+ * - not_confirmed_or_unknown: not a live CONFIRMED entry in this KB;
29
+ * - no_source_files: CONFIRMED but cites no source file, so it has no basis
30
+ * that could ever be checked (retrying cannot change this);
31
+ * - basis_mismatch: CONFIRMED and cites files, but its recorded basis does not
32
+ * match those files at HEAD (can clear once the files or the basis agree).
33
+ */
34
+ export type KbBibleCommitSkipReason = 'not_confirmed_or_unknown' | 'no_source_files' | 'basis_mismatch';
35
+ export interface KbBibleCommitSkip {
36
+ id: string;
37
+ reason: KbBibleCommitSkipReason;
38
+ }
39
+ /** Why a bible entry was removed: the maintainer KB holds it as retired. */
40
+ export type KbBibleCommitRemovalReason = 'superseded' | 'invalidated';
41
+ export interface KbBibleCommitRemoval {
42
+ id: string;
43
+ reason: KbBibleCommitRemovalReason;
44
+ }
45
+ export interface KbBibleCommitResult {
46
+ path: string;
47
+ merged: string[];
48
+ skipped: KbBibleCommitSkip[];
49
+ removed: KbBibleCommitRemoval[];
50
+ entry_count: number;
51
+ /** How many existing bible entries gained source_file_hashes (legacy backfill). */
52
+ backfilled: number;
53
+ committed: boolean;
54
+ }
55
+ export declare function kbBibleCommit(input: KbBibleCommitInput, anchor?: KbAnchor): Promise<string>;
56
+ /**
57
+ * The bible commit message. The subject counts merged and removed entries;
58
+ * when entries were removed, the body lists each one as '- <id> (<reason>)'.
59
+ * With no removals and no backfill the message is the single pre-existing
60
+ * subject line. A legacy backfill (existing entries that gained
61
+ * source_file_hashes) adds a body line 'Backfilled source_file_hashes on <n>
62
+ * existing entries.'; a backfill-only commit names the count in its own subject.
63
+ */
64
+ export declare function bibleCommitMessage(mergedCount: number, removed: KbBibleCommitRemoval[], total: number, backfilled?: number): string;
65
+ //# sourceMappingURL=kb-bible-commit.d.ts.map
@@ -0,0 +1,239 @@
1
+ import { z } from 'zod';
2
+ import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
3
+ import fs from 'node:fs';
4
+ import path from 'node:path';
5
+ import { getKbProviders } from '../services/knowledge/kb-providers.js';
6
+ import { resolveKbAnchor } from '../services/knowledge/kb-self.js';
7
+ import { filterProjectBibleCandidates, hasCarriedBasis, selectLegacyBibleBackfill } from '../services/knowledge/bible-basis-filter.js';
8
+ import { logWarn } from '../utils/log-helpers.js';
9
+ import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
10
+ import { bibleBytesBlobId } from '../services/knowledge/bible-blob-id.js';
11
+ import { memberLacksKbMaintainer } from '../services/knowledge/kb-maintainer-grant.js';
12
+ import { asciiSafeStringify, assertNoDuplicateBibleIds, BIBLE_FORMAT_VERSION, bibleContentChanged, commitBiblePath, compareById, isGitRepo, readBibleEntries, requireLocalFolder, toCanonicalEntry, withSourceFileHashes, } from './kb-export.js';
13
+ // kb_bible_commit: the kb_maintainer commits one review round's confirmations
14
+ // to the bible, merging at ENTRY level: the given ids are added or replaced,
15
+ // and every entry already in <self>/.fleet/kb-canonical.json is kept UNLESS
16
+ // this (the maintainer's) KB holds it as superseded or invalidated -- those
17
+ // are removed, and each removal (id + reason) is listed in the response and in
18
+ // the commit message. Removal runs at every call, also with no ids. An entry
19
+ // in the file but absent from the DB is never dropped, nor is one the DB holds
20
+ // as CONFIRMED and current. That keeps a retry after a rejected push safe: the
21
+ // engine resets to the new remote HEAD (which may carry another clone's
22
+ // entries, unknown to this DB) and calls this again with the same ids -- the
23
+ // result holds both sets with no manual merge.
24
+ //
25
+ // A merely STALE entry (freshness sweep: its cited files moved) is NOT removed:
26
+ // the owner decision names only superseded and invalidated, and staleness can
27
+ // clear on its own (see SqliteProvider.getRetirementReasons).
28
+ //
29
+ // kb_export is untouched by this: it stays additive-only.
30
+ //
31
+ // Legacy backfill: an entry already in the bible with no source_file_hashes
32
+ // (carried over from a v1/v2 bible) gains the STORED basis this KB holds for
33
+ // the same id, when that basis passes the bible admission predicate at HEAD and
34
+ // the KB entry cites exactly the bible entry's source_files
35
+ // (selectLegacyBibleBackfill). Only source_file_hashes is added; id, text,
36
+ // confidence and every other field stay as they are, and an entry that does not
37
+ // qualify is kept unchanged (never dropped). A backfill is a change: the bible
38
+ // is rewritten at the current format version and committed, and the response
39
+ // and the commit message report the number of backfilled entries.
40
+ //
41
+ // Provenance records the sprint's TARGET BASE branch and the base commit the
42
+ // entries were verified against, as given by the caller -- never the HEAD of
43
+ // the working folder, which is typically a feature branch.
44
+ //
45
+ // The commit is local, pathspec-scoped to the bible file, with the pm-kb
46
+ // identity (shared with kb_export). It is NEVER pushed.
47
+ //
48
+ // Trust anchor: when called from a FULL or kb_maintainer session, the blob id
49
+ // of every bible this writes is recorded in the per-repo KB DB, which is what
50
+ // lets a member session without the grant import that bible (kb-import.ts).
51
+ export const kbBibleCommitSchema = z.object({
52
+ ids: z.array(z.string().min(1))
53
+ .describe('Ids of the entries confirmed this round. Each must be a live (non-stale, non-superseded) CONFIRMED entry in this repository\'s KB whose recorded file basis still matches the cited files at the repo\'s HEAD commit (the same rule kb_export applies; uncommitted edits are ignored); any other id is skipped and reported in skipped (reason not_confirmed_or_unknown, no_source_files for a CONFIRMED entry citing no source file, or basis_mismatch). Independently of the ids, every bible entry this KB holds as superseded or invalidated is removed and reported in removed; an empty list with no such entry makes no commit.'),
54
+ baseBranch: z.string().min(1)
55
+ .describe('The sprint\'s target base branch (the branch the work merges into). Written to provenance.branch.'),
56
+ baseCommit: z.string().min(1)
57
+ .describe('The base commit the entries were verified against. Written to provenance.commit.'),
58
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
59
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
60
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
61
+ });
62
+ export async function kbBibleCommit(input, anchor) {
63
+ const resolved = resolveKbAnchor(anchor);
64
+ const repoPath = requireLocalFolder(resolved.folder, 'kb_bible_commit');
65
+ const outPath = path.join(repoPath, '.fleet', 'kb-canonical.json');
66
+ const requested = Array.from(new Set(input.ids));
67
+ const done = (r) => JSON.stringify({ path: outPath, ...r });
68
+ // No ids and no bible entry that could be removed: nothing to do, and the
69
+ // KB is not opened.
70
+ const existingAtStart = readBibleEntries(outPath);
71
+ if (requested.length === 0 && (existingAtStart === null || existingAtStart.length === 0)) {
72
+ return done({ merged: [], skipped: [], removed: [], entry_count: existingAtStart?.length ?? 0, backfilled: 0, committed: false });
73
+ }
74
+ const providers = await getKbProviders(repoPath, resolved.remoteUrl);
75
+ const project = requireSqliteProject(providers.project, 'kb_bible_commit');
76
+ const confirmedEntries = await project.list({ confidence: ['CONFIRMED'] });
77
+ const requestedSet = new Set(requested);
78
+ // ONE admission rule with kb_export (scope=project): a CONFIRMED id is
79
+ // admitted only if it passes the shared bible basis predicate. (With no
80
+ // requested ids this is empty and admission, including its git check, is
81
+ // not run.)
82
+ const requestedConfirmed = confirmedEntries.filter(e => requestedSet.has(e.id));
83
+ const bases = project.getSourceFileBases(requestedConfirmed.map(e => e.id));
84
+ const qualifying = await filterProjectBibleCandidates(requestedConfirmed, bases, repoPath);
85
+ const qualifyingIds = new Set(qualifying.map(e => e.id));
86
+ const confirmedIds = new Set(requestedConfirmed.map(e => e.id));
87
+ const noSourceIds = new Set(requestedConfirmed
88
+ .filter(e => !Array.isArray(e.source_files) || e.source_files.length === 0)
89
+ .map(e => e.id));
90
+ const confirmed = new Map();
91
+ // Format v3: each merged entry carries the exact stored basis it was just
92
+ // admitted against (never re-hashed here).
93
+ for (const e of qualifying)
94
+ confirmed.set(e.id, toCanonicalEntry(e, bases.get(e.id)));
95
+ const merged = [];
96
+ const skipped = [];
97
+ for (const id of requested) {
98
+ if (qualifyingIds.has(id))
99
+ merged.push(id);
100
+ else if (noSourceIds.has(id)) {
101
+ // An id already in the bible keeps its existing entry: the merge never drops entries.
102
+ logWarn('kb_bible_commit', 'skipping ' + id + ': no_source_files (a CONFIRMED entry citing no source file has no checkable basis)');
103
+ skipped.push({ id, reason: 'no_source_files' });
104
+ }
105
+ else if (confirmedIds.has(id)) {
106
+ // An id already in the bible keeps its existing entry: the merge never drops entries.
107
+ logWarn('kb_bible_commit', 'skipping ' + id + ': basis_mismatch (cited files at HEAD changed or absent, or basis absent)');
108
+ skipped.push({ id, reason: 'basis_mismatch' });
109
+ }
110
+ else
111
+ skipped.push({ id, reason: 'not_confirmed_or_unknown' });
112
+ }
113
+ // A bible file that exists but cannot be parsed must not be overwritten: its
114
+ // entries are unknown, and writing over it would drop all of them.
115
+ const existing = existingAtStart;
116
+ if (existing === null && fs.existsSync(outPath)) {
117
+ throw new Error('kb_bible_commit: existing bible is not a readable bible file, refusing to overwrite it: ' + outPath);
118
+ }
119
+ // Removals: a bible entry this KB holds as superseded or invalidated. An id
120
+ // unknown to this KB, or known and not retired, is kept. A merged id is never
121
+ // retired (merging requires a live CONFIRMED entry), so the two never clash.
122
+ const retired = project.getRetirementReasons((existing ?? []).map(e => e.id));
123
+ const removed = (existing ?? [])
124
+ .filter(e => retired.has(e.id))
125
+ .map(e => ({ id: e.id, reason: retired.get(e.id) }))
126
+ .sort(compareById);
127
+ // Legacy backfill: existing entries with no carried basis, not merged (a
128
+ // merged id gets its fresh entry and basis anyway) and not removed. The
129
+ // predicate needs a git work tree; a folder that is not one has nothing
130
+ // backfilled (no disk fallback) rather than failing a removal-only call.
131
+ const mergedSet = new Set(merged);
132
+ const removedSet = new Set(removed.map(r => r.id));
133
+ const legacy = (existing ?? []).filter(e => !hasCarriedBasis(e) && !mergedSet.has(e.id) && !removedSet.has(e.id));
134
+ let backfill = new Map();
135
+ if (legacy.length > 0 && isGitRepo(repoPath)) {
136
+ const legacyIds = new Set(legacy.map(e => e.id));
137
+ const kbLegacy = confirmedEntries.filter(e => legacyIds.has(e.id));
138
+ if (kbLegacy.length > 0) {
139
+ backfill = await selectLegacyBibleBackfill(legacy, kbLegacy, project.getSourceFileBases(kbLegacy.map(e => e.id)), repoPath);
140
+ }
141
+ }
142
+ const backfilled = backfill.size;
143
+ if (merged.length === 0 && removed.length === 0 && backfilled === 0) {
144
+ return done({ merged, skipped, removed, entry_count: existing?.length ?? 0, backfilled, committed: false });
145
+ }
146
+ // Duplicate-id guard: an existing file holding one id twice would otherwise
147
+ // be silently collapsed by the id map below (dropping an entry). Refuse
148
+ // before anything is written.
149
+ assertNoDuplicateBibleIds(existing ?? [], 'kb_bible_commit');
150
+ const byId = new Map();
151
+ for (const e of existing ?? []) {
152
+ const basis = backfill.get(e.id);
153
+ byId.set(e.id, basis ? withSourceFileHashes(e, basis) : e);
154
+ }
155
+ for (const r of removed)
156
+ byId.delete(r.id);
157
+ for (const id of merged)
158
+ byId.set(id, confirmed.get(id));
159
+ const entries = Array.from(byId.values()).sort(compareById);
160
+ assertNoDuplicateBibleIds(entries, 'kb_bible_commit');
161
+ // Entries unchanged is a no-op: no rewrite, no commit (provenance alone never
162
+ // counts as a change, matching kb_export).
163
+ if (existing !== null && asciiSafeStringify(existing) === asciiSafeStringify(entries)) {
164
+ return done({ merged, skipped, removed, entry_count: entries.length, backfilled, committed: false });
165
+ }
166
+ const bible = {
167
+ version: BIBLE_FORMAT_VERSION,
168
+ provenance: {
169
+ commit: input.baseCommit,
170
+ branch: input.baseBranch,
171
+ entry_count: entries.length,
172
+ },
173
+ entries,
174
+ };
175
+ fs.mkdirSync(path.dirname(outPath), { recursive: true });
176
+ const written = Buffer.from(asciiSafeStringify(bible) + '\n', 'utf-8');
177
+ fs.writeFileSync(outPath, written);
178
+ let committed = false;
179
+ if (isGitRepo(repoPath) && bibleContentChanged(repoPath, outPath)) {
180
+ const message = bibleCommitMessage(merged.length, removed, entries.length, backfilled);
181
+ try {
182
+ commitBiblePath(repoPath, outPath, message);
183
+ }
184
+ catch (err) {
185
+ const reason = err instanceof Error ? err.message : String(err);
186
+ throw new Error('kb_bible_commit: bible written but the local commit failed: ' + reason);
187
+ }
188
+ committed = true;
189
+ }
190
+ // kb_import trust anchor: record the blob id of the bible just written, so
191
+ // a member session without the kb_maintainer grant may import it once it is
192
+ // committed in (or pulled into) any checkout of this repository. Only the
193
+ // maintainer side records: kb_bible_commit is served to every member
194
+ // session, and a session without the grant merges over whatever its own
195
+ // work-tree bible holds (possibly hand-edited), so its output must not
196
+ // become trusted. A FULL session and the kb_maintainer session record.
197
+ if (!memberLacksKbMaintainer(anchor)) {
198
+ // The id of the exact bytes written (LF, unfiltered), hashed in-process:
199
+ // never `git hash-object` on the path, which would re-read the file and
200
+ // run the checkout's member-configured clean filters.
201
+ project.recordTrustedBibleBlob(await bibleBytesBlobId(repoPath, written), 'kb_bible_commit');
202
+ }
203
+ return done({ merged, skipped, removed, entry_count: entries.length, backfilled, committed });
204
+ }
205
+ /**
206
+ * The bible commit message. The subject counts merged and removed entries;
207
+ * when entries were removed, the body lists each one as '- <id> (<reason>)'.
208
+ * With no removals and no backfill the message is the single pre-existing
209
+ * subject line. A legacy backfill (existing entries that gained
210
+ * source_file_hashes) adds a body line 'Backfilled source_file_hashes on <n>
211
+ * existing entries.'; a backfill-only commit names the count in its own subject.
212
+ */
213
+ export function bibleCommitMessage(mergedCount, removed, total, backfilled = 0) {
214
+ let subject;
215
+ if (mergedCount === 0 && removed.length === 0 && backfilled > 0) {
216
+ subject = 'chore(kb): backfill source_file_hashes on ' + backfilled + ' knowledge bible entries -- ' + total + ' total';
217
+ }
218
+ else if (removed.length === 0) {
219
+ subject = 'chore(kb): commit ' + mergedCount + ' confirmed entries to the knowledge bible -- ' + total + ' total';
220
+ }
221
+ else if (mergedCount === 0) {
222
+ subject = 'chore(kb): remove ' + removed.length + ' superseded/invalidated entries from the knowledge bible -- '
223
+ + total + ' total';
224
+ }
225
+ else {
226
+ subject = 'chore(kb): commit ' + mergedCount + ' confirmed entries to the knowledge bible, remove '
227
+ + removed.length + ' superseded/invalidated -- ' + total + ' total';
228
+ }
229
+ const body = [];
230
+ if (removed.length > 0)
231
+ body.push('Removed:\n' + removed.map(r => '- ' + r.id + ' (' + r.reason + ')').join('\n'));
232
+ // A backfill-only subject already names the count.
233
+ if (backfilled > 0 && (mergedCount > 0 || removed.length > 0))
234
+ body.push('Backfilled source_file_hashes on ' + backfilled + ' existing entries.');
235
+ if (body.length === 0)
236
+ return subject;
237
+ return subject + '\n\n' + body.join('\n\n');
238
+ }
239
+ //# sourceMappingURL=kb-bible-commit.js.map
@@ -1,6 +1,9 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
2
3
  export declare const kbCaptureSchema: z.ZodObject<{
3
- repo_path: z.ZodOptional<z.ZodString>;
4
+ repo_path: z.ZodOptional<z.ZodUnknown>;
5
+ repo: z.ZodOptional<z.ZodUnknown>;
6
+ repo_remote_url: z.ZodOptional<z.ZodUnknown>;
4
7
  type: z.ZodEnum<["context-cache", "learning", "knowledge", "runbook", "user-directive"]>;
5
8
  title: z.ZodString;
6
9
  summary: z.ZodString;
@@ -14,40 +17,41 @@ export declare const kbCaptureSchema: z.ZodObject<{
14
17
  confidence: z.ZodOptional<z.ZodEnum<["CONFIRMED", "INFERRED", "UNVERIFIED"]>>;
15
18
  scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
16
19
  supersedes: z.ZodOptional<z.ZodString>;
17
- repo_remote_url: z.ZodOptional<z.ZodString>;
18
20
  }, "strip", z.ZodTypeAny, {
19
21
  content: string;
20
22
  type: "knowledge" | "context-cache" | "learning" | "runbook" | "user-directive";
21
23
  title: string;
22
24
  summary: string;
23
- role?: string | undefined;
24
25
  tags?: string[] | undefined;
26
+ role?: string | undefined;
27
+ repo?: unknown;
25
28
  source_files?: string[] | undefined;
26
29
  symbols?: string[] | undefined;
27
30
  module?: string | undefined;
28
31
  supersedes?: string | undefined;
29
32
  confidence?: "CONFIRMED" | "INFERRED" | "UNVERIFIED" | undefined;
30
- scope?: "global" | "project" | undefined;
31
- repo_path?: string | undefined;
32
- repo_remote_url?: string | undefined;
33
+ scope?: "project" | "global" | undefined;
34
+ repo_path?: unknown;
35
+ repo_remote_url?: unknown;
33
36
  source_file?: string | undefined;
34
37
  }, {
35
38
  content: string;
36
39
  type: "knowledge" | "context-cache" | "learning" | "runbook" | "user-directive";
37
40
  title: string;
38
41
  summary: string;
39
- role?: string | undefined;
40
42
  tags?: string[] | undefined;
43
+ role?: string | undefined;
44
+ repo?: unknown;
41
45
  source_files?: string[] | undefined;
42
46
  symbols?: string[] | undefined;
43
47
  module?: string | undefined;
44
48
  supersedes?: string | undefined;
45
49
  confidence?: "CONFIRMED" | "INFERRED" | "UNVERIFIED" | undefined;
46
- scope?: "global" | "project" | undefined;
47
- repo_path?: string | undefined;
48
- repo_remote_url?: string | undefined;
50
+ scope?: "project" | "global" | undefined;
51
+ repo_path?: unknown;
52
+ repo_remote_url?: unknown;
49
53
  source_file?: string | undefined;
50
54
  }>;
51
55
  export type KbCaptureInput = z.infer<typeof kbCaptureSchema>;
52
- export declare function kbCapture(input: KbCaptureInput): Promise<string>;
56
+ export declare function kbCapture(input: KbCaptureInput, anchor?: KbAnchor): Promise<string>;
53
57
  //# sourceMappingURL=kb-capture.d.ts.map
@@ -1,8 +1,10 @@
1
1
  import { z } from 'zod';
2
+ import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
2
3
  import { computeFileHash } from '../services/knowledge/kb-service.js';
3
- import { getKbProviders } from '../services/knowledge/kb-providers.js';
4
+ import { getSelfKbProviders, memberOwnerTag } from '../services/knowledge/kb-self.js';
4
5
  import { validateFilePaths } from '../services/knowledge/path-validation.js';
5
- import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
6
+ import { memberLacksKbMaintainer } from '../services/knowledge/kb-maintainer-grant.js';
7
+ import { isSqliteProject } from '../services/knowledge/require-sqlite-project.js';
6
8
  // D5 (T2.3): the full Author enum. Kept as a plain array (not a zod enum on
7
9
  // the schema itself) so an invalid role hint degrades to 'unknown' at the
8
10
  // handler rather than rejecting the whole capture call at the schema layer.
@@ -17,9 +19,6 @@ function validateAuthor(role) {
17
19
  return 'unknown';
18
20
  }
19
21
  export const kbCaptureSchema = z.object({
20
- ...kbScopeFields,
21
- repo_path: z.string().optional()
22
- .describe('Path to the repo root this call is about. Selects WHICH project KB is read/written. When omitted, falls back to the calling process cwd, which is only correct for single-repo CLI use -- server-handled tool calls must pass it explicitly.'),
23
22
  type: z.enum(['context-cache', 'learning', 'knowledge', 'runbook', 'user-directive'])
24
23
  .describe('Content type: context-cache for file summaries, learning for session insights, knowledge for facts, runbook for procedures, user-directive for a standing user instruction/correction. NOTE (F1/D1): a user-directive captured here is stored as a PENDING PROPOSAL (UNVERIFIED, flagged for review, scope forced to project) -- it is NOT an active directive and does NOT gain any trust semantics until a human approves it in their own terminal via "apra-fleet kb approve-directive <id>". MCP cannot mint an active directive.'),
25
24
  title: z.string().min(1).describe('Short description (max ~80 chars)'),
@@ -37,14 +36,17 @@ export const kbCaptureSchema = z.object({
37
36
  scope: z.enum(['project', 'global']).optional()
38
37
  .describe('Scope: project (default) or global for team-wide conventions'),
39
38
  supersedes: z.string().optional()
40
- .describe('Id of an entry this capture REPLACES. Only honored when AUDN independently matches that same entry as a same-topic candidate (same type, overlapping symbols and source_files), so it cannot retire an arbitrary entry. Omit it unless you mean to retire something -- an ordinary refinement links to its predecessor and both stay live. The KB Agent sets this when resolving a flagged pair; doer/reviewer captures should not.'),
39
+ .describe('Id of an entry this capture REPLACES. Only honored when AUDN independently matches that same entry as a same-topic candidate (same type, overlapping symbols and source_files), so it cannot retire an arbitrary entry. Omit it unless you mean to retire something -- an ordinary refinement links to its predecessor and both stay live. The KB Agent sets this when resolving a flagged pair; doer/reviewer captures should not. In a MEMBER session without the kb_maintainer grant a CONFIRMED target is never retired: the capture links to it (refines, both stay live) and the response lists it in refused.'),
40
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
41
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
42
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
41
43
  });
42
- export async function kbCapture(input) {
44
+ export async function kbCapture(input, anchor) {
43
45
  if (input.source_files?.length)
44
46
  validateFilePaths(input.source_files);
45
47
  if (input.source_file)
46
48
  validateFilePaths([input.source_file]);
47
- const providers = await getKbProviders(input.repo_path, input.repo_remote_url);
49
+ const providers = await getSelfKbProviders(anchor);
48
50
  let content_hash = '';
49
51
  let content_hash_type = 'sha256';
50
52
  if (input.type === 'context-cache' && input.source_file) {
@@ -87,12 +89,44 @@ export async function kbCapture(input) {
87
89
  const requestedConfidence = input.confidence ?? 'INFERRED';
88
90
  let confidence = requestedConfidence;
89
91
  let content = input.content;
90
- let confidence_clamped = false;
91
- if (requestedConfidence === 'CONFIRMED') {
92
+ if (requestedConfidence === 'CONFIRMED' && input.type !== 'user-directive') {
92
93
  confidence = 'INFERRED';
93
- confidence_clamped = true;
94
94
  content = content + '\n\n[confidence clamped: CONFIRMED requires kb_promote]';
95
95
  }
96
+ // my-beads-db-0cd.14: the directive proposal-transformation is duplicated
97
+ // HERE, not left to SqliteProvider.capture() alone. That "single choke
98
+ // point" claim (see the F1 comment above) only holds when providers.project
99
+ // is a SqliteProvider. Now that it can be an HttpKbProvider, capture()
100
+ // forwards the payload to the remote verbatim -- the remote is not
101
+ // guaranteed to be a fleet SqliteProvider, so it would never apply the
102
+ // downgrade. Applying it here makes the quarantine (confidence UNVERIFIED,
103
+ // flagged_for_review true, tag 'directive:pending') hold for ANY provider.
104
+ // Harmless to duplicate against the SqliteProvider's own copy: same values,
105
+ // same dedup on the tag.
106
+ let tags = input.tags ?? [];
107
+ let flagged_for_review = false;
108
+ if (isUserDirective) {
109
+ confidence = 'UNVERIFIED';
110
+ flagged_for_review = true;
111
+ if (!tags.includes('directive:pending')) {
112
+ tags = [...tags, 'directive:pending'];
113
+ }
114
+ }
115
+ // A MEMBER session's capture lands in the machine's per-repo DB tagged with
116
+ // the caller's member:<uuid>, so its unconfirmed knowledge stays its own:
117
+ // MEMBER INFERRED/UNVERIFIED reads, kb_promote and kb_invalidate only ever
118
+ // see entries carrying that tag (kb-self.ts memberOwnerTag).
119
+ const ownerTag = memberOwnerTag(anchor);
120
+ if (ownerTag !== undefined && !tags.includes(ownerTag)) {
121
+ tags = [...tags, ownerTag];
122
+ }
123
+ // my-beads-db-0d3.2: derived, not set per branch. The flag used to be set
124
+ // only by the CONFIRMED clamp above, so a user-directive -- quarantined to
125
+ // UNVERIFIED just above -- reported false while its request was not
126
+ // honoured. It now means "stored confidence differs from requested",
127
+ // whatever the reason; a caller that needs the reason has it from the
128
+ // type it sent (user-directive => pending approval, else kb_promote).
129
+ const confidence_clamped = confidence !== requestedConfidence;
96
130
  // D5 (T2.3) + F1 (D1): provenance is stamped by this handler, never accepted
97
131
  // as a free string from the caller. author='user' is NO LONGER stamped on a
98
132
  // directive proposal -- MCP identity is forgeable, so a proposal records the
@@ -107,7 +141,18 @@ export async function kbCapture(input) {
107
141
  : author === 'reviewer'
108
142
  ? 'review'
109
143
  : 'session';
110
- const { id, audn_decision } = await target.capture({
144
+ // A MEMBER session WITHOUT the kb_maintainer grant may not retire a
145
+ // CONFIRMED entry through supersedes (a retired entry leaves the bible at the
146
+ // next kb_bible_commit), whoever owns it -- AUDN matches candidates across the
147
+ // whole per-repo DB. Over the per-repo SqliteProvider the explicit supersede
148
+ // of a CONFIRMED target degrades to the implicit link (refines, both live);
149
+ // a non-CONFIRMED target is still retired. A remote provider cannot be told
150
+ // about the grant, so there supersedes is dropped (fail closed) and the id
151
+ // reported. `refused` (E-RETIRE-NEEDS-KB-MAINTAINER, response field, same as
152
+ // kb_invalidate) is present exactly when such a session passed supersedes.
153
+ const keepConfirmed = input.supersedes !== undefined && memberLacksKbMaintainer(anchor);
154
+ const remoteRefused = keepConfirmed && !isSqliteProject(target);
155
+ const entryInput = {
111
156
  type: input.type,
112
157
  title: input.title,
113
158
  summary: input.summary,
@@ -115,16 +160,26 @@ export async function kbCapture(input) {
115
160
  source_files: input.source_files ?? [],
116
161
  symbols: input.symbols ?? [],
117
162
  module: input.module,
118
- tags: input.tags ?? [],
163
+ tags,
119
164
  content_hash,
120
165
  content_hash_type,
121
- flagged_for_review: false,
166
+ flagged_for_review,
122
167
  author,
123
168
  source,
124
169
  confidence,
125
170
  scope,
126
- supersedes: input.supersedes,
127
- });
171
+ supersedes: remoteRefused ? undefined : input.supersedes,
172
+ };
173
+ const result = keepConfirmed && isSqliteProject(target)
174
+ ? await target.capture(entryInput, { keepConfirmed: true })
175
+ : await target.capture(entryInput);
176
+ const { id, audn_decision } = result;
177
+ if (keepConfirmed) {
178
+ const refused = remoteRefused
179
+ ? [input.supersedes]
180
+ : ('refused' in result && Array.isArray(result.refused) ? result.refused : []);
181
+ return JSON.stringify({ id, audn_decision, confidence_clamped, refused });
182
+ }
128
183
  return JSON.stringify({ id, audn_decision, confidence_clamped });
129
184
  }
130
185
  //# sourceMappingURL=kb-capture.js.map
@@ -1,17 +1,37 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
2
3
  export declare const kbContextSchema: z.ZodObject<{
3
- repo_path: z.ZodOptional<z.ZodString>;
4
+ repo_path: z.ZodOptional<z.ZodUnknown>;
5
+ repo: z.ZodOptional<z.ZodUnknown>;
6
+ repo_remote_url: z.ZodOptional<z.ZodUnknown>;
7
+ confidence: z.ZodOptional<z.ZodArray<z.ZodEnum<["CONFIRMED", "INFERRED", "UNVERIFIED"]>, "many">>;
4
8
  files: z.ZodArray<z.ZodString, "many">;
5
- repo_remote_url: z.ZodOptional<z.ZodString>;
6
9
  }, "strip", z.ZodTypeAny, {
7
10
  files: string[];
8
- repo_path?: string | undefined;
9
- repo_remote_url?: string | undefined;
11
+ repo?: unknown;
12
+ confidence?: ("CONFIRMED" | "INFERRED" | "UNVERIFIED")[] | undefined;
13
+ repo_path?: unknown;
14
+ repo_remote_url?: unknown;
10
15
  }, {
11
16
  files: string[];
12
- repo_path?: string | undefined;
13
- repo_remote_url?: string | undefined;
17
+ repo?: unknown;
18
+ confidence?: ("CONFIRMED" | "INFERRED" | "UNVERIFIED")[] | undefined;
19
+ repo_path?: unknown;
20
+ repo_remote_url?: unknown;
14
21
  }>;
15
22
  export type KbContextInput = z.infer<typeof kbContextSchema>;
16
- export declare function kbContext(input: KbContextInput): Promise<string>;
23
+ type Tier = NonNullable<KbContextInput['confidence']>[number];
24
+ /**
25
+ * kb_context's default tier set when the caller names none: CONFIRMED and
26
+ * INFERRED, undisputed only. Unlike kb_query/kb_list (whose default is
27
+ * CONFIRMED-only, because their entries are claims a reader acts on), kb_context
28
+ * only answers "is my cached summary of this file still current?", and that is
29
+ * decided mechanically by the entry's content hash against the file on disk.
30
+ * kb_capture stores at most INFERRED and context-cache entries are rarely
31
+ * promoted, so a CONFIRMED-only default reported almost every file missing.
32
+ * UNVERIFIED (harvest output) stays opt-in.
33
+ */
34
+ export declare const KB_CONTEXT_DEFAULT_CONFIDENCE: readonly Tier[];
35
+ export declare function kbContext(input: KbContextInput, anchor?: KbAnchor): Promise<string>;
36
+ export {};
17
37
  //# sourceMappingURL=kb-context.d.ts.map
@@ -1,21 +1,72 @@
1
1
  import { z } from 'zod';
2
- import { getKbProviders } from '../services/knowledge/kb-providers.js';
2
+ import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
3
+ import { getSelfReadKb } from '../services/knowledge/kb-self.js';
4
+ import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
3
5
  import { validateFilePaths } from '../services/knowledge/path-validation.js';
4
- import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
5
6
  export const kbContextSchema = z.object({
6
- ...kbScopeFields,
7
- repo_path: z.string().optional()
8
- .describe('Path to the repo root this call is about. Selects WHICH project KB is read/written. When omitted, falls back to the calling process cwd, which is only correct for single-repo CLI use -- server-handled tool calls must pass it explicitly.'),
7
+ confidence: z.array(z.enum(['CONFIRMED', 'INFERRED', 'UNVERIFIED'])).min(1).optional()
8
+ .describe('Only consider cached file entries whose confidence tier is in this list. Default when omitted: ["CONFIRMED","INFERRED"], undisputed entries only -- a context-cache entry is verified by its content hash, and captures are stored at most INFERRED, so a CONFIRMED-only default would report almost every file missing. UNVERIFIED entries are considered only when listed explicitly.'),
9
9
  files: z.array(z.string()).min(1).describe('File paths to check freshness for'),
10
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
11
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
12
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
10
13
  });
11
- export async function kbContext(input) {
14
+ /**
15
+ * kb_context's default tier set when the caller names none: CONFIRMED and
16
+ * INFERRED, undisputed only. Unlike kb_query/kb_list (whose default is
17
+ * CONFIRMED-only, because their entries are claims a reader acts on), kb_context
18
+ * only answers "is my cached summary of this file still current?", and that is
19
+ * decided mechanically by the entry's content hash against the file on disk.
20
+ * kb_capture stores at most INFERRED and context-cache entries are rarely
21
+ * promoted, so a CONFIRMED-only default reported almost every file missing.
22
+ * UNVERIFIED (harvest output) stays opt-in.
23
+ */
24
+ export const KB_CONTEXT_DEFAULT_CONFIDENCE = Object.freeze(['CONFIRMED', 'INFERRED']);
25
+ const STATUS_RANK = { fresh: 2, stale: 1, missing: 0 };
26
+ /** Per file, the best of two result sets (fresh > stale > missing; first wins a tie). */
27
+ function mergeByFile(primary, secondary) {
28
+ const byFile = new Map(secondary.map(r => [r.file, r]));
29
+ return primary.map((r) => {
30
+ const other = byFile.get(r.file);
31
+ return other && STATUS_RANK[other.status] > STATUS_RANK[r.status] ? other : r;
32
+ });
33
+ }
34
+ export async function kbContext(input, anchor) {
12
35
  validateFilePaths(input.files);
13
- const providers = await getKbProviders(input.repo_path, input.repo_remote_url);
14
- let results = await providers.project.context(input.files);
36
+ const explicit = input.confidence?.length ? input.confidence : undefined;
37
+ const confidence = (explicit ?? [...KB_CONTEXT_DEFAULT_CONFIDENCE]);
38
+ // Default-trusted read: undisputed unless a tier list is given.
39
+ const excludeDisputed = explicit === undefined;
40
+ // MEMBER session -> the checkout bible view (kb-self.ts getSelfReadKb) for
41
+ // the CONFIRMED tier; an INFERRED/UNVERIFIED request goes to the per-repo DB,
42
+ // own captures only (ownerTag).
43
+ const read = await getSelfReadKb(anchor, explicit);
44
+ const { providers } = read;
45
+ let results;
46
+ if (explicit === undefined && read.memberView) {
47
+ // MEMBER default: the checkout bible's CONFIRMED entries merged with the
48
+ // member's OWN CONFIRMED/INFERRED captures from the per-repo DB, so the
49
+ // INFERRED half of the default never exposes another member's captures and
50
+ // never hides the bible's.
51
+ const own = await getSelfReadKb(anchor, confidence);
52
+ const fromBible = await providers.project.context(input.files, ['CONFIRMED'], excludeDisputed);
53
+ const fromOwn = await requireSqliteProject(own.providers.project, 'kb_context')
54
+ .context(input.files, confidence, excludeDisputed, own.ownerTag);
55
+ results = mergeByFile(fromBible, fromOwn);
56
+ }
57
+ else if (read.ownerTag !== undefined) {
58
+ results = await requireSqliteProject(providers.project, 'kb_context').context(input.files, confidence, excludeDisputed, read.ownerTag);
59
+ }
60
+ else {
61
+ results = await providers.project.context(input.files, confidence, excludeDisputed);
62
+ }
15
63
  // Fallback to global if project has no results
16
64
  const hasFresh = results.some(r => r.status === 'fresh');
17
65
  if (!hasFresh) {
18
- const globalResults = await providers.global.context(input.files);
66
+ // A MEMBER default read keeps the global fallback CONFIRMED-only: the global
67
+ // KB is machine-wide, so its INFERRED tier is not the member's own.
68
+ const globalTiers = explicit === undefined && read.memberView ? ['CONFIRMED'] : confidence;
69
+ const globalResults = await providers.global.context(input.files, globalTiers, excludeDisputed, read.ownerTag);
19
70
  const hasFreshGlobal = globalResults.some(r => r.status === 'fresh');
20
71
  if (hasFreshGlobal) {
21
72
  results = globalResults;