@apralabs/apra-fleet 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -1,21 +1,24 @@
1
1
  import { z } from 'zod';
2
- import { getKbProviders } from '../services/knowledge/kb-providers.js';
3
- import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
2
+ import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
3
+ import { getSelfKbProviders } from '../services/knowledge/kb-self.js';
4
4
  import { KbCaptureRejected } from '../services/knowledge/types.js';
5
+ import { logWarn } from '../utils/log-helpers.js';
5
6
  export const kbHarvestSchema = 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.'),
9
7
  session_transcript: z.string().optional()
10
8
  .describe('Full session transcript text to scan for learnings'),
11
9
  session_id: z.string().optional()
12
10
  .describe('Session ID for attribution'),
11
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
12
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
13
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
13
14
  });
14
15
  const LEARNING_PATTERNS = [
15
16
  /(?:^|\n)\s*(?:I found that|Note:|Warning:|Bug:|Gotcha:|This means)\s*[:\-]?\s*(.+?)(?:\n\n|\n(?=[A-Z])|$)/gis,
16
17
  /(?:^|\n)\s*(?:The (?:issue|problem|fix|solution|root cause) (?:is|was))\s*[:\-]?\s*(.+?)(?:\n\n|\n(?=[A-Z])|$)/gis,
17
18
  /(?:^|\n)\s*(?:Important:|Key insight:|Lesson learned:|TIL:)\s*(.+?)(?:\n\n|\n(?=[A-Z])|$)/gis,
18
19
  ];
20
+ /** Longest first_error text carried into the kb_harvest response. */
21
+ const MAX_FIRST_ERROR_CHARS = 500;
19
22
  const FILE_PATH_RE = /(?:^|\s)((?:src|lib|tests?|docs?)\/[\w./-]+\.\w+)/g;
20
23
  const SYMBOL_RE = /`(\w{2,}(?:\.\w+)?(?:\(\))?)`/g;
21
24
  function extractFilePaths(text) {
@@ -80,17 +83,22 @@ function extractLearnings(transcript) {
80
83
  // entry captured here is forced to
81
84
  // confidence='UNVERIFIED' (never CONFIRMED, covered by the D1 clamp) with
82
85
  // author='harvest', source='harvest' so it is distinguishable in queries.
83
- export async function kbHarvest(input) {
86
+ export async function kbHarvest(input, anchor) {
84
87
  if (!input.session_transcript) {
85
- return JSON.stringify({ entries_captured: 0, entries_updated: 0, entries_skipped: 0, entries_rejected: 0 });
88
+ return JSON.stringify({ entries_captured: 0, entries_updated: 0, entries_skipped: 0, entries_rejected: 0, entries_failed: 0 });
86
89
  }
87
- const providers = await getKbProviders(input.repo_path, input.repo_remote_url);
90
+ const providers = await getSelfKbProviders(anchor);
88
91
  const provider = providers.project;
89
92
  const learnings = extractLearnings(input.session_transcript);
90
93
  let entries_captured = 0;
91
94
  let entries_updated = 0;
92
95
  let entries_skipped = 0;
93
96
  let entries_rejected = 0;
97
+ let entries_failed = 0;
98
+ // The first non-rejection failure, reported only when nothing landed, so a
99
+ // harvest whose every capture failed (a broken DB, a server that is down)
100
+ // says why instead of hiding it in the count.
101
+ let first_error;
94
102
  // D5 + revised D7 (T2.3): harvested entries are UNVERIFIED, regex-extracted,
95
103
  // low-trust captures from the execute_prompt autowire -- distinct provenance
96
104
  // from real KB-Agent captures (author='kb-agent', source='session'/'review').
@@ -111,12 +119,15 @@ export async function kbHarvest(input) {
111
119
  source,
112
120
  confidence: 'UNVERIFIED',
113
121
  };
114
- // KB-TRUST PHASE 1: capture now fails closed on an uncheckable basis, and
115
- // harvest is the highest-volume writer -- its regex extraction frequently
116
- // yields no file paths at all. Isolate each capture so one rejected entry
117
- // is counted and the loop continues; an unhandled throw here would abort
118
- // the remaining entries and die silently, because auto-harvest is
119
- // dispatched fire-and-forget with a bare .catch() in execute-prompt.ts.
122
+ // Isolate each capture so one failure never costs the learnings after
123
+ // it: an unhandled throw here would abort the remaining entries and die
124
+ // silently, because auto-harvest is dispatched fire-and-forget with a bare
125
+ // .catch() in execute-prompt.ts. A capture refused for its basis
126
+ // (KB-TRUST PHASE 1: harvest's regex extraction often yields no file
127
+ // paths) is counted as rejected. Any other failure -- e.g. a remote KB
128
+ // server that is down, where the http provider queues nothing -- is
129
+ // logged with the entry title and counted as failed, so the caller sees
130
+ // that the harvest must be repeated.
120
131
  let audn_decision;
121
132
  try {
122
133
  ({ audn_decision } = await provider.capture(entryInput));
@@ -126,7 +137,11 @@ export async function kbHarvest(input) {
126
137
  entries_rejected++;
127
138
  continue;
128
139
  }
129
- throw err;
140
+ entries_failed++;
141
+ const message = err instanceof Error ? err.message : String(err);
142
+ first_error ??= message.length > MAX_FIRST_ERROR_CHARS ? `${message.slice(0, MAX_FIRST_ERROR_CHARS)}...` : message;
143
+ logWarn('kb-harvest', `capture of "${entryInput.title}" failed and was not stored: ${message}`);
144
+ continue;
130
145
  }
131
146
  if (audn_decision === 'add' || audn_decision === 'flagged') {
132
147
  entries_captured++;
@@ -138,6 +153,10 @@ export async function kbHarvest(input) {
138
153
  entries_skipped++;
139
154
  }
140
155
  }
141
- return JSON.stringify({ entries_captured, entries_updated, entries_skipped, entries_rejected });
156
+ const landed = entries_captured + entries_updated + entries_skipped;
157
+ return JSON.stringify({
158
+ entries_captured, entries_updated, entries_skipped, entries_rejected, entries_failed,
159
+ ...(landed === 0 && first_error !== undefined ? { first_error } : {}),
160
+ });
142
161
  }
143
162
  //# sourceMappingURL=kb-harvest.js.map
@@ -1,24 +1,28 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
2
3
  export declare const kbImportSchema: z.ZodObject<{
4
+ repo_path: z.ZodOptional<z.ZodUnknown>;
5
+ repo: z.ZodOptional<z.ZodUnknown>;
6
+ repo_remote_url: z.ZodOptional<z.ZodUnknown>;
3
7
  path: z.ZodOptional<z.ZodString>;
4
- repo: z.ZodOptional<z.ZodString>;
5
- repo_path: z.ZodOptional<z.ZodString>;
8
+ ref: z.ZodOptional<z.ZodString>;
6
9
  scope: z.ZodOptional<z.ZodLiteral<"project">>;
7
10
  skip_sweep: z.ZodOptional<z.ZodBoolean>;
8
- repo_remote_url: z.ZodOptional<z.ZodString>;
9
11
  }, "strip", z.ZodTypeAny, {
10
12
  path?: string | undefined;
11
13
  scope?: "project" | undefined;
12
- repo_path?: string | undefined;
13
- repo_remote_url?: string | undefined;
14
- repo?: string | undefined;
14
+ repo?: unknown;
15
+ repo_path?: unknown;
16
+ repo_remote_url?: unknown;
17
+ ref?: string | undefined;
15
18
  skip_sweep?: boolean | undefined;
16
19
  }, {
17
20
  path?: string | undefined;
18
21
  scope?: "project" | undefined;
19
- repo_path?: string | undefined;
20
- repo_remote_url?: string | undefined;
21
- repo?: string | undefined;
22
+ repo?: unknown;
23
+ repo_path?: unknown;
24
+ repo_remote_url?: unknown;
25
+ ref?: string | undefined;
22
26
  skip_sweep?: boolean | undefined;
23
27
  }>;
24
28
  export type KbImportInput = z.infer<typeof kbImportSchema>;
@@ -34,11 +38,39 @@ export interface KbImportReport {
34
38
  * bible, so re-importing an old bible deliberately drops those entries.
35
39
  */
36
40
  rejected: number;
41
+ /**
42
+ * Local rows taken CONFIRMED -> INFERRED by an EXPLICIT demotion tombstone in
43
+ * the imported bible -- the cross-clone half of kb_demote. Counts rows
44
+ * actually changed, not tombstones read: a tombstone naming an id this clone
45
+ * does not hold, or one whose row was re-promoted after the demotion, adds
46
+ * nothing. An entry merely ABSENT from the bible is never demoted.
47
+ */
48
+ demoted: number;
37
49
  sweep: {
38
50
  checked: number;
39
51
  staled: number;
40
52
  unstaled: number;
41
53
  };
54
+ /**
55
+ * Present exactly when the bible was read from git rather than the file
56
+ * system: the ref read ('HEAD' for a member session without the
57
+ * kb_maintainer grant and no `ref`; otherwise the `ref` given).
58
+ */
59
+ bible_source?: string;
60
+ /**
61
+ * With bible_source: true when the work-tree .fleet/kb-canonical.json
62
+ * differed from (or was missing versus) the committed copy, so its
63
+ * uncommitted content was not imported.
64
+ */
65
+ worktree_ignored?: boolean;
66
+ /**
67
+ * Present (true) exactly when the project KB is the http provider: the KB
68
+ * server is the source of truth, so the bible is neither read nor imported
69
+ * and every count is 0. `reason` says why.
70
+ */
71
+ bible_skipped?: true;
72
+ reason?: string;
42
73
  }
43
- export declare function kbImport(input: KbImportInput): Promise<string>;
74
+ export declare const KB_IMPORT_HTTP_SKIP_REASON = "bible import is not used over the http KB provider: the KB server is the source of truth";
75
+ export declare function kbImport(input: KbImportInput, anchor?: KbAnchor): Promise<string>;
44
76
  //# sourceMappingURL=kb-import.d.ts.map
@@ -1,10 +1,13 @@
1
1
  import { z } from 'zod';
2
+ import { KB_REMOVED_SCOPE_KEYS_SHAPE } from '../services/knowledge/kb-removed-scope-keys.js';
2
3
  import fs from 'node:fs';
3
4
  import path from 'node:path';
4
5
  import { getKbProviders } from '../services/knowledge/kb-providers.js';
5
- import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
6
- import { KbCaptureRejected } from '../services/knowledge/types.js';
7
- import { requireSqliteProject } from '../services/knowledge/require-sqlite-project.js';
6
+ import { resolveKbAnchor } from '../services/knowledge/kb-self.js';
7
+ import { parseBibleDocument, importBibleEntries } from '../services/knowledge/bible-import.js';
8
+ import { requireSqliteProject, isSqliteProject } from '../services/knowledge/require-sqlite-project.js';
9
+ import { KbMaintainerGrantError, memberLacksKbMaintainer } from '../services/knowledge/kb-maintainer-grant.js';
10
+ import { OWN_BIBLE_REL, BibleBlobIntegrityError, bibleBytesBlobId, isSafeBibleRef, readCommittedBibleBlob, } from '../services/knowledge/bible-blob-id.js';
8
11
  // T2.1 (F4, D3 HARDENED): kb_import -- the trusted-channel write path that lets a
9
12
  // warm local KB absorb a merged-in bible (.fleet/kb-canonical.json). The
10
13
  // cold-seed in kb_session_prime is OUTPUT-ONLY and fires only under
@@ -30,21 +33,64 @@ import { requireSqliteProject } from '../services/knowledge/require-sqlite-proje
30
33
  // .fleet/kb-canonical.json; an explicit --path bible is CALLER-ASSERTED trust.
31
34
  // The unforgeable tier remains user-directives, which are CLI-gated -- the
32
35
  // directive gate quarantines them either way.
36
+ //
37
+ // MEMBER sessions: because an explicit path is equivalent in power to
38
+ // kb_promote (it keeps bible confidence, and a v3 bible's carried hashes are
39
+ // stored verbatim, so a hand-made bible can later pass kb_bible_commit
40
+ // admission), a member session WITHOUT the kb_maintainer grant is refused an
41
+ // explicit path with E-KB-MAINTAINER-REQUIRED -- the same sessions that are not
42
+ // served kb_promote. A path naming the session's own repo-resolved bible is
43
+ // the trusted channel and is allowed, as is no path at all (the engine's
44
+ // priming import). FULL sessions and the kb_maintainer session are unchanged.
45
+ //
46
+ // The own bible is only the trusted channel AS COMMITTED: the work-tree file
47
+ // is member-writable, so a member agent could hand-edit it (CONFIRMED entries
48
+ // plus v3 hashes matching HEAD) and import it without the grant. A member
49
+ // session WITHOUT the grant therefore reads the committed blob
50
+ // (HEAD:./.fleet/kb-canonical.json, git without a shell) and never the work-
51
+ // tree file. A clean tree or fresh clone yields the same bytes, so priming is
52
+ // unchanged; uncommitted edits are ignored and reported (worktree_ignored).
53
+ // With no committed copy (unborn HEAD, untracked bible, no git) nothing is
54
+ // imported: E-KB-MAINTAINER-REQUIRED, naming the cause.
55
+ //
56
+ // TRUST ANCHOR: committed is still not trusted on its own -- the member
57
+ // controls its own .git, so it can commit a hand-made bible locally, import
58
+ // it, and reset the commit away with nothing ever pushed. Pinning to a ref
59
+ // does not help either: every ref lives in the member-writable checkout. So
60
+ // the no-grant path imports the committed bible only when its git blob id is
61
+ // recorded in the hub-side per-repo KB DB (trusted_bible_blobs), which the
62
+ // maintainer side fills: kb_bible_commit records every bible it writes, and a
63
+ // FULL or kb_maintainer kb_import records every bible it imports. An
64
+ // unrecorded blob is refused with E-KB-MAINTAINER-REQUIRED and nothing is
65
+ // imported. The checkout supplies only the blob id and bytes to check: the
66
+ // bytes are hashed in-process and must equal that id (bible-blob-id.ts), so
67
+ // a replace ref, alternates entry or overwritten object in the member's .git
68
+ // cannot pair a trusted id with forged bytes; the trust decision itself is
69
+ // taken against the hub-side record alone.
70
+ //
71
+ // `ref`: read the bible as committed at that git ref (hash-verified the same
72
+ // way) instead of the file system. For a grant session this is what makes a
73
+ // seeding import independent of the maintainer's work tree.
74
+ //
75
+ // Bootstrap: a fresh clone whose bible came from the pushed base branch
76
+ // carries a blob the maintainer wrote (kb_bible_commit on this hub) and so
77
+ // imports normally. A bible this hub never saw (fresh hub, bible merged from
78
+ // elsewhere) is seeded by the engine's sprint-start priming, which imports
79
+ // through the repository's kb_maintainer session (a grant session the member
80
+ // agent cannot open) with `ref` naming the base branch's remote-tracking ref
81
+ // (refs/remotes/origin/<base>). Priming runs before anything cleans the
82
+ // maintainer's checkout (launch alignment runs only for multi-member legacy
83
+ // launches, and branch-ensure runs after priming), so it must not read the
84
+ // work tree or HEAD: only a bible on the fetched, reviewed base branch is
85
+ // seeded. Residual exposure: that ref is as fresh as the member's last fetch,
86
+ // and like every ref it lives in the member-writable .git -- the same
87
+ // boundary as the grant itself (a routing guard, not a security boundary
88
+ // against a process on the member's host).
33
89
  export const kbImportSchema = z.object({
34
- ...kbScopeFields,
35
90
  path: z.string().optional()
36
- .describe('Explicit path to a bible JSON file. When omitted, resolves to <repo>/.fleet/kb-canonical.json. TRUST NOTE: importing the repo-resolved .fleet/kb-canonical.json is the git-reviewed trusted channel; an explicit --path bible is caller-asserted trust (equivalent in power to kb_promote). Directives are quarantined to pending proposals either way.'),
37
- repo: z.string().optional()
38
- .describe('Repo root used to resolve <repo>/.fleet/kb-canonical.json when --path is omitted, and to anchor the post-import freshness sweep. Validated (must exist and be a directory) or the call fails; when omitted, falls back to the validated process working directory.'),
39
- // KB audit 2026-08-11: the apra-fleet-src trap again. Every other kb_* tool
40
- // names this input `repo_path`; kb_import alone took `repo`, and zod strips
41
- // unknown keys silently -- so calling it the way every sibling is called did
42
- // not error, it resolved against the SERVER's cwd and imported an unrelated
43
- // repo's bible. Invisible, because it still reports a successful import. The
44
- // sprint engine calls this per member, which is precisely the repo-blindness
45
- // class per-member path resolution exists to prevent.
46
- repo_path: z.string().optional()
47
- .describe('Alias for `repo`, matching the input name used by every other kb_* tool. Ignored when `repo` is also supplied.'),
91
+ .describe('Explicit path to a bible JSON file (e.g. <worktree>/.fleet/kb-canonical.json). This is a file path, not a scope selector: the KB written is always the calling session\'s own (a member session -> its work folder; otherwise the server folder). When omitted, resolves to <own folder>/.fleet/kb-canonical.json. TRUST NOTE: importing the repo-resolved .fleet/kb-canonical.json as committed is the git-reviewed trusted channel; an explicit --path bible is caller-asserted trust (equivalent in power to kb_promote). In a MEMBER session without the kb_maintainer grant an explicit path other than the session\'s own .fleet/kb-canonical.json is refused with E-KB-MAINTAINER-REQUIRED and nothing is imported, and the own bible is read as committed at HEAD (never the work-tree file); with no committed copy, or when that committed bible was never written or imported by the maintainer side (kb_bible_commit, or kb_import from the kb_maintainer or a FULL session), nothing is imported (E-KB-MAINTAINER-REQUIRED). Directives are quarantined to pending proposals either way.'),
92
+ ref: z.string().regex(/^[A-Za-z0-9_][A-Za-z0-9._/-]*$/).optional()
93
+ .describe('Read the bible as COMMITTED at this git ref (a ref name such as HEAD or refs/remotes/origin/main; no rev expressions) instead of the file on disk; with path, reads that repository-relative file at the ref. The bytes are verified in-process against the git blob id before import. A ref that does not hold the bible fails with E-BIBLE-NOT-FOUND and nothing is imported. In the kb_maintainer or a FULL session the verified blob is what gets recorded as trusted, so a seeding import does not depend on the work tree; in a member session without the grant the trust check still applies. Omitted: the file on disk (or, in a member session without the grant, HEAD).'),
48
94
  scope: z.literal('project').optional()
49
95
  .describe('Only project scope is supported (imports into the project KB). Global bibles are a separate concern.'),
50
96
  // KB audit 2026-08-12, found by a LIVE sprint rather than by review. The
@@ -58,160 +104,137 @@ export const kbImportSchema = z.object({
58
104
  // fire", by a side door. Opt-out, defaulting to today's behaviour.
59
105
  skip_sweep: z.boolean().optional()
60
106
  .describe('Skip the post-import freshness sweep. The sweep re-judges EVERY entry in the KB against this worktree, which is right for a deliberate audit but wrong for a routine import: an import performed to warm the KB should not mass-stale it because unrelated files have changed since capture. prime() still runs its own bounded freshness check on the entries it actually returns, so skipping this does not surface stale claims. Default false (sweep runs, unchanged).'),
107
+ // Removed pre-redesign scope keys: declared only so a caller still passing one
108
+ // is refused with E-SCOPE-KEY-REMOVED instead of silently re-scoped.
109
+ ...KB_REMOVED_SCOPE_KEYS_SHAPE,
61
110
  });
62
- // F4 (D3, KB d5193cb9): repo path resolution precedence, mirroring kb-export --
63
- // (1) explicit repo, validated (must exist and be a directory) or refuse; (2)
64
- // validated process working directory when repo is omitted (same check, not a
65
- // blind default); (3) neither validates -> throw. kb_import is an explicit
66
- // command, so it throws like kb_export rather than silently skipping.
67
- function resolveRepoPath(explicit) {
68
- const candidate = explicit || process.cwd();
69
- if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory()) {
70
- throw new Error('kb_import: repo does not exist or is not a directory: ' + candidate);
111
+ // The KB anchor is the calling session's own folder (kb-self.ts). kb_import
112
+ // reads the bible and sweeps against that folder on THIS host, so an anchor
113
+ // naming a folder on another host refuses rather than silently skipping.
114
+ function requireLocalFolder(folder) {
115
+ if (!fs.existsSync(folder) || !fs.statSync(folder).isDirectory()) {
116
+ throw new Error('kb_import: repo folder does not exist or is not a directory on this host: ' + folder);
71
117
  }
72
- return candidate;
118
+ return folder;
73
119
  }
74
- const VALID_TYPES = ['context-cache', 'learning', 'knowledge', 'runbook', 'user-directive'];
75
- const VALID_CONFIDENCE = ['CONFIRMED', 'INFERRED', 'UNVERIFIED'];
76
- // Validate a single parsed bible entry against the exported CanonicalEntry field
77
- // set {id, type, title, summary, symbols, source_files, confidence, updated_at}
78
- // (KB b9df569a -- NOTE: no content field). Malformed entries are tolerated and
79
- // skipped individually rather than aborting the whole import.
80
- function isValidBibleEntry(e) {
81
- if (!e || typeof e !== 'object')
82
- return false;
83
- const r = e;
84
- if (typeof r.id !== 'string' || r.id.length === 0)
85
- return false;
86
- if (typeof r.type !== 'string' || !VALID_TYPES.includes(r.type))
87
- return false;
88
- if (typeof r.title !== 'string' || r.title.length === 0)
89
- return false;
90
- if (typeof r.summary !== 'string' || r.summary.length === 0)
91
- return false;
92
- if (typeof r.confidence !== 'string' || !VALID_CONFIDENCE.includes(r.confidence))
93
- return false;
94
- if (r.symbols !== undefined && !Array.isArray(r.symbols))
95
- return false;
96
- if (r.source_files !== undefined && !Array.isArray(r.source_files))
97
- return false;
98
- return true;
99
- }
100
- // LOW-2: bible entries carry no content field, so synthesize content
101
- // DETERMINISTICALLY from the summary. Determinism matters twice: (1) a re-import
102
- // of the same bible produces byte-identical content so AUDN's content-equality
103
- // 'none' path can dedupe an id-collision-with-identical-content case; (2) it
104
- // keeps import a pure function of the bible file.
105
- function synthesizeContent(entry) {
106
- return entry.summary;
107
- }
108
- export async function kbImport(input) {
109
- // `repo` wins over the `repo_path` alias so existing callers are unaffected.
110
- const repoAnchor = resolveRepoPath(input.repo ?? input.repo_path);
111
- const biblePath = input.path ?? path.join(repoAnchor, '.fleet', 'kb-canonical.json');
112
- // Validate the file resolves and parses to the bible array shape BEFORE
113
- // importing anything (reject otherwise -- non-zero exit at the CLI).
114
- if (!fs.existsSync(biblePath)) {
115
- throw new Error('kb_import: bible file not found: ' + biblePath);
116
- }
117
- const raw = fs.readFileSync(biblePath, 'utf-8');
118
- let parsed;
119
- try {
120
- parsed = JSON.parse(raw);
121
- }
122
- catch {
123
- throw new Error('kb_import: bible file is not valid JSON: ' + biblePath);
120
+ export const KB_IMPORT_HTTP_SKIP_REASON = 'bible import is not used over the http KB provider: the KB server is the source of truth';
121
+ export async function kbImport(input, anchor) {
122
+ const resolved = resolveKbAnchor(anchor);
123
+ const repoAnchor = requireLocalFolder(resolved.folder);
124
+ const ownBible = path.join(repoAnchor, '.fleet', 'kb-canonical.json');
125
+ const biblePath = input.path ?? ownBible;
126
+ // Over http the KB server is the source of truth: the bible is not read
127
+ // and nothing is imported (decided before any bible read or grant check).
128
+ const providers = await getKbProviders(repoAnchor, resolved.remoteUrl);
129
+ if (!isSqliteProject(providers.project)) {
130
+ const skipped = {
131
+ imported: 0, skipped: 0, linked: 0, flagged: 0, rejected: 0, demoted: 0,
132
+ sweep: { checked: 0, staled: 0, unstaled: 0 },
133
+ bible_skipped: true, reason: KB_IMPORT_HTTP_SKIP_REASON,
134
+ };
135
+ return JSON.stringify(skipped);
124
136
  }
125
- // KB-TRUST PHASE 3a: the bible has TWO on-disk shapes and must accept both.
126
- //
127
- // v1 (legacy): a bare JSON array of entries.
128
- // v2: { version, provenance: {commit, branch, entry_count}, entries }
129
- //
130
- // Selection is on Array.isArray, exactly as the design specifies. This import
131
- // side ships BEFORE the export side starts writing v2 -- a v2 bible fed to an
132
- // older apra-fleet throws the not-a-JSON-array error below, which is expected
133
- // and acceptable, but it means the reader must never lag the writer.
134
- const bibleEntries = Array.isArray(parsed)
135
- ? parsed
136
- : (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries))
137
- ? parsed.entries
138
- : null;
139
- if (bibleEntries === null) {
140
- throw new Error('kb_import: bible file is not a JSON array of entries: ' + biblePath);
137
+ const lacksGrant = memberLacksKbMaintainer(anchor);
138
+ const namesOwnBible = input.path === undefined || path.resolve(input.path) === path.resolve(ownBible);
139
+ if (!namesOwnBible && lacksGrant) {
140
+ throw new KbMaintainerGrantError(`kb_import with an explicit path ('${input.path}') keeps the bible's confidence, which is equivalent to kb_promote, so it needs the kb_maintainer grant; this member session does not carry it and nothing was imported.`, 'Call kb_import without path to import your own checkout bible (.fleet/kb-canonical.json), or run the import from the kb_maintainer session or a FULL session.');
141
141
  }
142
- // repoAnchor (resolved above) selects the KB, so an import 'for' repo B can
143
- // never land in whichever repo the server process happens to sit in.
144
- const providers = await getKbProviders(repoAnchor, input.repo_remote_url);
145
- const provider = requireSqliteProject(providers.project, 'kb_import');
146
- let imported = 0;
147
- let skipped = 0;
148
- let linked = 0;
149
- let flagged = 0;
150
- let rejected = 0;
151
- for (const candidate of bibleEntries) {
152
- // Malformed entry -> tolerate and skip individually.
153
- if (!isValidBibleEntry(candidate)) {
154
- skipped++;
155
- continue;
156
- }
157
- const entry = candidate;
158
- // ORDER OF OPERATIONS (LOW-2): id-exists check FIRST, before capture()/AUDN.
159
- // This is what makes re-import EXACT even for symbol-less/file-less entries
160
- // AUDN can never dedupe.
161
- if (provider.hasEntry(entry.id)) {
162
- skipped++;
163
- continue;
142
+ // Validate the file resolves and parses to the bible array shape BEFORE
143
+ // importing anything (reject otherwise -- non-zero exit at the CLI).
144
+ // Parsing (both on-disk shapes) is shared with the member bible view
145
+ // (services/knowledge/bible-import.ts); a malformed file throws KbBibleError.
146
+ // The DOCUMENT parse, not the entries-only one: the demotion tombstones are
147
+ // the cross-clone half of this import and must come from the same parse.
148
+ let bibleDoc;
149
+ // Set whenever the bible was read from git (no-grant sessions always; any
150
+ // session passing `ref`): the ref read, the hash-verified blob id, and
151
+ // whether the work-tree copy differed.
152
+ let committedSource;
153
+ // Set when the bible was read from the file system (grant/FULL without ref):
154
+ // the exact bytes parsed, whose blob id is recorded below.
155
+ let fileBytes;
156
+ if (lacksGrant || input.ref !== undefined) {
157
+ const ref = input.ref ?? 'HEAD';
158
+ // namesOwnBible holds for a no-grant session (an explicit other path was
159
+ // refused above); a grant session may name another repository-relative
160
+ // file to read at `ref`.
161
+ const rel = path.relative(repoAnchor, path.resolve(biblePath)).split(path.sep).join('/');
162
+ const inRepo = rel !== '' && !rel.startsWith('../') && rel !== '..' && !path.isAbsolute(rel);
163
+ if (!isSafeBibleRef(ref)) {
164
+ throw new Error(`kb_import: ref '${ref}' is not a plain git ref name (no leading '-', no rev expressions); nothing was imported`);
164
165
  }
165
- const kbInput = {
166
- type: entry.type,
167
- title: entry.title,
168
- summary: entry.summary,
169
- content: synthesizeContent(entry),
170
- source_files: entry.source_files ?? [],
171
- symbols: entry.symbols ?? [],
172
- tags: [],
173
- content_hash: '',
174
- content_hash_type: 'sha256',
175
- flagged_for_review: false,
176
- // Bible entries carry no author; the trusted channel is the provenance.
177
- author: 'unknown',
178
- source: 'import',
179
- confidence: entry.confidence,
180
- scope: 'project',
181
- };
182
- // Route through the AUDN choke point with the INTERNAL import mode and the
183
- // preserved bible id. A user-directive is still forced through the directive
184
- // gate (pending proposal) INSIDE capture() -- import mode does not bypass it.
185
- // KB-TRUST PHASE 1: isolate each entry so one unfalsifiable bible entry is
186
- // counted and the import continues, rather than aborting every entry after
187
- // it. Import mode exempts the confidence clamp, never the basis check.
188
- let audn_decision;
166
+ let committed;
189
167
  try {
190
- ({ audn_decision } = await provider.capture(kbInput, {
191
- importMode: true,
192
- preferredId: entry.id,
193
- }));
168
+ committed = inRepo ? await readCommittedBibleBlob(repoAnchor, ref, rel) : null;
194
169
  }
195
170
  catch (err) {
196
- if (err instanceof KbCaptureRejected) {
197
- rejected++;
198
- continue;
199
- }
171
+ if (err instanceof BibleBlobIntegrityError)
172
+ throw new Error('kb_import: ' + err.message);
200
173
  throw err;
201
174
  }
202
- if (audn_decision === 'add')
203
- imported++;
204
- else if (audn_decision === 'none')
205
- skipped++;
206
- // AUDN 'update' means the entry was linked to a same-topic predecessor and
207
- // BOTH stay live -- supersede is opt-in (input.supersedes) and kb_import
208
- // never sets it, because a bible authored on another branch cannot name a
209
- // local entry's id. Counting these as "superseded" reported a retirement
210
- // that never happened.
211
- else if (audn_decision === 'update')
212
- linked++;
213
- else if (audn_decision === 'flagged')
214
- flagged++;
175
+ if (committed === null && input.ref !== undefined) {
176
+ throw new Error(`kb_import: bible file not found: ${ref}:${inRepo ? rel : biblePath}`);
177
+ }
178
+ // No bible anywhere (a repo that has not adopted one): the plain
179
+ // not-found error, as for every other session -- not a grant problem.
180
+ if (committed === null && !fs.existsSync(ownBible)) {
181
+ throw new Error('kb_import: bible file not found: ' + ownBible);
182
+ }
183
+ if (committed === null) {
184
+ throw new KbMaintainerGrantError(`kb_import in a member session without the kb_maintainer grant imports only the committed ${OWN_BIBLE_REL} (HEAD), and this checkout has no committed copy (unborn HEAD, untracked bible, or git unavailable); the work-tree file is not trusted at its own confidence and nothing was imported.`, `Commit ${OWN_BIBLE_REL} (the kb_maintainer's kb_bible_commit does this), or run the import from the kb_maintainer session or a FULL session.`);
185
+ }
186
+ let worktree = null;
187
+ try {
188
+ worktree = fs.readFileSync(biblePath, 'utf-8');
189
+ }
190
+ catch {
191
+ worktree = null;
192
+ }
193
+ // Line endings are normalized for the comparison only (autocrlf checkouts).
194
+ const lf = (t) => t.replace(/\r\n/g, '\n');
195
+ committedSource = { ref, worktree_ignored: worktree === null || lf(worktree) !== lf(committed.text), blobId: committed.blobId };
196
+ bibleDoc = parseBibleDocument(committed.text, ref + ':' + rel, 'kb_import');
197
+ }
198
+ else {
199
+ if (!fs.existsSync(biblePath)) {
200
+ throw new Error('kb_import: bible file not found: ' + biblePath);
201
+ }
202
+ // Read once: the bytes parsed are the bytes whose blob id is recorded.
203
+ fileBytes = fs.readFileSync(biblePath);
204
+ bibleDoc = parseBibleDocument(fileBytes.toString('utf-8'), biblePath, 'kb_import');
205
+ }
206
+ // repoAnchor (resolved above) selects the KB, so an import 'for' repo B can
207
+ // never land in whichever repo the server process happens to sit in.
208
+ const provider = requireSqliteProject(providers.project, 'kb_import');
209
+ // Trust anchor (see the header): a committed bible is imported by a member
210
+ // session without the grant only when the maintainer side recorded its
211
+ // blob id in this hub-side DB. Otherwise NOTHING is imported -- refusing the
212
+ // whole import rather than clamping CONFIRMED entries to a lower tier,
213
+ // because a clamped row would occupy its id, and the id-exists skip in
214
+ // importBibleEntries would then keep the genuine CONFIRMED entry out when
215
+ // the maintainer's bible arrives later; a refusal leaves the KB untouched.
216
+ if (lacksGrant && committedSource && !provider.isTrustedBibleBlob(committedSource.blobId)) {
217
+ throw new KbMaintainerGrantError(`kb_import in a member session without the kb_maintainer grant imports the committed ${OWN_BIBLE_REL} only when the maintainer side wrote or imported that exact bible, and this checkout's committed bible (blob ${committedSource.blobId}) was never recorded by it (a bible committed only in this checkout is not trusted at its own confidence); nothing was imported.`, `Import a bible the kb_maintainer published (kb_bible_commit) -- e.g. reset ${OWN_BIBLE_REL} to the base branch -- or run the import from the kb_maintainer session or a FULL session, which records the bible it imports.`);
218
+ }
219
+ // Same entry loop the member bible view uses: import mode (bible confidence
220
+ // preserved, directives quarantined), id-exists skip first, per-entry
221
+ // isolation of capture basis rejections.
222
+ // Tombstones ride along in the same call so entries and demotions can never
223
+ // be applied from two different reads of the file.
224
+ const { imported, skipped, linked, flagged, rejected, demoted } = await importBibleEntries(provider, bibleDoc.entries, { demotions: bibleDoc.demotions });
225
+ // A FULL or kb_maintainer session is trusted to import at bible confidence,
226
+ // so the bible it just imported becomes trusted for member sessions too:
227
+ // record the blob id the bytes would have as this repo's committed own
228
+ // bible: the hash-verified blob id for a `ref` read, else the in-process id
229
+ // of the exact file bytes parsed (no `git hash-object` on the path, so no
230
+ // re-read and no member-configured clean filter decides the id). This is
231
+ // also how a hub that never saw a bible (fresh hub, bible merged from
232
+ // elsewhere) is seeded: the engine's sprint-start priming imports the base
233
+ // branch's bible through the kb_maintainer session with `ref`. A member
234
+ // session without the grant never records (it only reads the record).
235
+ if (!lacksGrant) {
236
+ const blobId = committedSource ? committedSource.blobId : await bibleBytesBlobId(repoAnchor, fileBytes);
237
+ provider.recordTrustedBibleBlob(blobId, 'kb_import');
215
238
  }
216
239
  // After the entry loop, run freshnessSweep() (T1.3) so imported entries whose
217
240
  // basis does not match THIS worktree stale immediately rather than serving
@@ -234,7 +257,9 @@ export async function kbImport(input) {
234
257
  const sweep = input.skip_sweep
235
258
  ? { checked: 0, staled: 0, unstaled: 0 }
236
259
  : await provider.freshnessSweep(repoAnchor);
237
- const report = { imported, skipped, linked, flagged, rejected, sweep };
260
+ const report = committedSource
261
+ ? { imported, skipped, linked, flagged, rejected, demoted, sweep, bible_source: committedSource.ref, worktree_ignored: committedSource.worktree_ignored }
262
+ : { imported, skipped, linked, flagged, rejected, demoted, sweep };
238
263
  return JSON.stringify(report);
239
264
  }
240
265
  //# sourceMappingURL=kb-import.js.map
@@ -1,19 +1,34 @@
1
1
  import { z } from 'zod';
2
+ import { type KbAnchor } from '../services/knowledge/kb-self.js';
2
3
  export declare const kbInvalidateSchema: z.ZodObject<{
3
- repo_path: z.ZodOptional<z.ZodString>;
4
- files: z.ZodArray<z.ZodString, "many">;
5
- repo_remote_url: 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
+ files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
8
+ ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6
9
  }, "strip", z.ZodTypeAny, {
7
- files: string[];
8
- repo_path?: string | undefined;
9
- repo_remote_url?: string | undefined;
10
+ files?: string[] | undefined;
11
+ repo?: unknown;
12
+ ids?: string[] | undefined;
13
+ repo_path?: unknown;
14
+ repo_remote_url?: unknown;
10
15
  }, {
11
- files: string[];
12
- repo_path?: string | undefined;
13
- repo_remote_url?: string | undefined;
16
+ files?: string[] | undefined;
17
+ repo?: unknown;
18
+ ids?: string[] | undefined;
19
+ repo_path?: unknown;
20
+ repo_remote_url?: unknown;
14
21
  }>;
15
22
  export type KbInvalidateInput = z.infer<typeof kbInvalidateSchema>;
23
+ export declare const KB_HOOK_MARKER = "# apra-fleet KB invalidation hook";
16
24
  export declare const KB_POST_COMMIT_HOOK = "#!/bin/sh\n# apra-fleet KB invalidation hook\n# Marks context-cache entries stale for files changed in the last commit\ngit diff-tree --no-commit-id -r --name-only HEAD | while IFS= read -r f; do\n [ -n \"$f\" ] && node dist/index.js kb invalidate \"$f\" 2>/dev/null || true\ndone\n";
17
- export declare function installKbPostCommitHook(repoPath: string): void;
18
- export declare function kbInvalidate(input: KbInvalidateInput): Promise<string>;
25
+ export type KbHookInstallResult = {
26
+ installed: true;
27
+ hookPath: string;
28
+ } | {
29
+ installed: false;
30
+ reason: string;
31
+ };
32
+ export declare function installKbPostCommitHook(repoPath: string): KbHookInstallResult;
33
+ export declare function kbInvalidate(input: KbInvalidateInput, anchor?: KbAnchor): Promise<string>;
19
34
  //# sourceMappingURL=kb-invalidate.d.ts.map