@apralabs/apra-fleet 0.4.0 → 0.4.2

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 (548) hide show
  1. package/README.md +159 -13
  2. package/dist/agents/backlog-groomer.md +31 -19
  3. package/dist/agents/ci-watcher.md +16 -1
  4. package/dist/agents/deployer.md +37 -47
  5. package/dist/agents/doer.md +147 -114
  6. package/dist/agents/harvester.md +41 -34
  7. package/dist/agents/integ-test-runner.md +98 -114
  8. package/dist/agents/kb-reconciler.md +205 -0
  9. package/dist/agents/plan-reviewer.md +45 -44
  10. package/dist/agents/planner.md +121 -50
  11. package/dist/agents/regression-test-runner.md +84 -81
  12. package/dist/agents/reviewer.md +118 -44
  13. package/dist/agents/schemas/doer-output.json +63 -3
  14. package/dist/agents/schemas/harvester-output.json +59 -2
  15. package/dist/agents/schemas/integ-test-runner-output.json +3 -3
  16. package/dist/agents/schemas/kb-reconciler-output.json +87 -0
  17. package/dist/agents/schemas/planner-output.json +65 -0
  18. package/dist/agents/schemas/regression-test-runner-output.json +4 -17
  19. package/dist/agents/schemas/reviewer-output.json +105 -8
  20. package/dist/cli/auth.d.ts.map +1 -1
  21. package/dist/cli/auth.js +1 -2
  22. package/dist/cli/auth.js.map +1 -1
  23. package/dist/cli/config.d.ts +3 -3
  24. package/dist/cli/config.d.ts.map +1 -1
  25. package/dist/cli/config.js +4 -13
  26. package/dist/cli/config.js.map +1 -1
  27. package/dist/cli/install.d.ts +1 -0
  28. package/dist/cli/install.d.ts.map +1 -1
  29. package/dist/cli/install.js +141 -44
  30. package/dist/cli/install.js.map +1 -1
  31. package/dist/cli/join.js +1 -1
  32. package/dist/cli/join.js.map +1 -1
  33. package/dist/cli/kb-commit.d.ts +12 -0
  34. package/dist/cli/kb-commit.d.ts.map +1 -0
  35. package/dist/cli/kb-commit.js +53 -0
  36. package/dist/cli/kb-commit.js.map +1 -0
  37. package/dist/cli/kb-directives.d.ts +17 -0
  38. package/dist/cli/kb-directives.d.ts.map +1 -0
  39. package/dist/cli/kb-directives.js +146 -0
  40. package/dist/cli/kb-directives.js.map +1 -0
  41. package/dist/cli/kb-import.d.ts +13 -0
  42. package/dist/cli/kb-import.d.ts.map +1 -0
  43. package/dist/cli/kb-import.js +56 -0
  44. package/dist/cli/kb-import.js.map +1 -0
  45. package/dist/cli/register-member.js +1 -1
  46. package/dist/cli/start.d.ts.map +1 -1
  47. package/dist/cli/start.js +7 -0
  48. package/dist/cli/start.js.map +1 -1
  49. package/dist/cli/uninstall.d.ts.map +1 -1
  50. package/dist/cli/uninstall.js +16 -3
  51. package/dist/cli/uninstall.js.map +1 -1
  52. package/dist/cli/watch.d.ts +76 -4
  53. package/dist/cli/watch.d.ts.map +1 -1
  54. package/dist/cli/watch.js +150 -17
  55. package/dist/cli/watch.js.map +1 -1
  56. package/dist/commands/kb-server.d.ts +8 -0
  57. package/dist/commands/kb-server.d.ts.map +1 -0
  58. package/dist/commands/kb-server.js +221 -0
  59. package/dist/commands/kb-server.js.map +1 -0
  60. package/dist/index.js +77 -2
  61. package/dist/index.js.map +1 -1
  62. package/dist/os/git-bash-candidates.d.ts +35 -0
  63. package/dist/os/git-bash-candidates.d.ts.map +1 -0
  64. package/dist/os/git-bash-candidates.js +46 -0
  65. package/dist/os/git-bash-candidates.js.map +1 -0
  66. package/dist/os/index.d.ts +13 -4
  67. package/dist/os/index.d.ts.map +1 -1
  68. package/dist/os/index.js +17 -2
  69. package/dist/os/index.js.map +1 -1
  70. package/dist/os/linux.d.ts +1 -0
  71. package/dist/os/linux.d.ts.map +1 -1
  72. package/dist/os/linux.js +19 -2
  73. package/dist/os/linux.js.map +1 -1
  74. package/dist/os/os-commands.d.ts +12 -0
  75. package/dist/os/os-commands.d.ts.map +1 -1
  76. package/dist/os/os-commands.js.map +1 -1
  77. package/dist/os/windows-gitbash.d.ts +93 -0
  78. package/dist/os/windows-gitbash.d.ts.map +1 -0
  79. package/dist/os/windows-gitbash.js +244 -0
  80. package/dist/os/windows-gitbash.js.map +1 -0
  81. package/dist/os/windows.d.ts +35 -0
  82. package/dist/os/windows.d.ts.map +1 -1
  83. package/dist/os/windows.js +93 -35
  84. package/dist/os/windows.js.map +1 -1
  85. package/dist/providers/agy.d.ts +15 -3
  86. package/dist/providers/agy.d.ts.map +1 -1
  87. package/dist/providers/agy.js +145 -11
  88. package/dist/providers/agy.js.map +1 -1
  89. package/dist/providers/claude.d.ts +14 -3
  90. package/dist/providers/claude.d.ts.map +1 -1
  91. package/dist/providers/claude.js +69 -22
  92. package/dist/providers/claude.js.map +1 -1
  93. package/dist/providers/codex.d.ts +14 -3
  94. package/dist/providers/codex.d.ts.map +1 -1
  95. package/dist/providers/codex.js +34 -8
  96. package/dist/providers/codex.js.map +1 -1
  97. package/dist/providers/copilot.d.ts +14 -3
  98. package/dist/providers/copilot.d.ts.map +1 -1
  99. package/dist/providers/copilot.js +33 -8
  100. package/dist/providers/copilot.js.map +1 -1
  101. package/dist/providers/email/headers.d.ts +15 -0
  102. package/dist/providers/email/headers.d.ts.map +1 -0
  103. package/dist/providers/email/headers.js +42 -0
  104. package/dist/providers/email/headers.js.map +1 -0
  105. package/dist/providers/email/index.d.ts +18 -0
  106. package/dist/providers/email/index.d.ts.map +1 -0
  107. package/dist/providers/email/index.js +60 -0
  108. package/dist/providers/email/index.js.map +1 -0
  109. package/dist/providers/email/provider.d.ts +49 -0
  110. package/dist/providers/email/provider.d.ts.map +1 -0
  111. package/dist/providers/email/provider.js +2 -0
  112. package/dist/providers/email/provider.js.map +1 -0
  113. package/dist/providers/email/sendgrid.d.ts +12 -0
  114. package/dist/providers/email/sendgrid.d.ts.map +1 -0
  115. package/dist/providers/email/sendgrid.js +67 -0
  116. package/dist/providers/email/sendgrid.js.map +1 -0
  117. package/dist/providers/email/smtp.d.ts +65 -0
  118. package/dist/providers/email/smtp.d.ts.map +1 -0
  119. package/dist/providers/email/smtp.js +373 -0
  120. package/dist/providers/email/smtp.js.map +1 -0
  121. package/dist/providers/index.d.ts +0 -1
  122. package/dist/providers/index.d.ts.map +1 -1
  123. package/dist/providers/index.js +0 -3
  124. package/dist/providers/index.js.map +1 -1
  125. package/dist/providers/none.d.ts +14 -3
  126. package/dist/providers/none.d.ts.map +1 -1
  127. package/dist/providers/none.js +26 -2
  128. package/dist/providers/none.js.map +1 -1
  129. package/dist/providers/opencode.d.ts +14 -3
  130. package/dist/providers/opencode.d.ts.map +1 -1
  131. package/dist/providers/opencode.js +60 -6
  132. package/dist/providers/opencode.js.map +1 -1
  133. package/dist/providers/provider.d.ts +91 -5
  134. package/dist/providers/provider.d.ts.map +1 -1
  135. package/dist/providers/provider.js +45 -1
  136. package/dist/providers/provider.js.map +1 -1
  137. package/dist/services/agent-provisioner.d.ts.map +1 -1
  138. package/dist/services/agent-provisioner.js +5 -8
  139. package/dist/services/agent-provisioner.js.map +1 -1
  140. package/dist/services/cloud/activity.js +2 -2
  141. package/dist/services/cloud/activity.js.map +1 -1
  142. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  143. package/dist/services/cloud/lifecycle.js +3 -0
  144. package/dist/services/cloud/lifecycle.js.map +1 -1
  145. package/dist/services/cloud/task-wrapper.d.ts +18 -0
  146. package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
  147. package/dist/services/cloud/task-wrapper.js +157 -0
  148. package/dist/services/cloud/task-wrapper.js.map +1 -1
  149. package/dist/services/context-admission.d.ts.map +1 -1
  150. package/dist/services/context-admission.js +9 -7
  151. package/dist/services/context-admission.js.map +1 -1
  152. package/dist/services/credential-cleanup.d.ts.map +1 -1
  153. package/dist/services/credential-cleanup.js +22 -3
  154. package/dist/services/credential-cleanup.js.map +1 -1
  155. package/dist/services/github-app.d.ts.map +1 -1
  156. package/dist/services/github-app.js +11 -2
  157. package/dist/services/github-app.js.map +1 -1
  158. package/dist/services/knowledge/audn.d.ts +37 -0
  159. package/dist/services/knowledge/audn.d.ts.map +1 -0
  160. package/dist/services/knowledge/audn.js +219 -0
  161. package/dist/services/knowledge/audn.js.map +1 -0
  162. package/dist/services/knowledge/file-hash.d.ts +11 -0
  163. package/dist/services/knowledge/file-hash.d.ts.map +1 -0
  164. package/dist/services/knowledge/file-hash.js +123 -0
  165. package/dist/services/knowledge/file-hash.js.map +1 -0
  166. package/dist/services/knowledge/http-provider.d.ts +46 -0
  167. package/dist/services/knowledge/http-provider.d.ts.map +1 -0
  168. package/dist/services/knowledge/http-provider.js +254 -0
  169. package/dist/services/knowledge/http-provider.js.map +1 -0
  170. package/dist/services/knowledge/kb-providers.d.ts +15 -0
  171. package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
  172. package/dist/services/knowledge/kb-providers.js +92 -0
  173. package/dist/services/knowledge/kb-providers.js.map +1 -0
  174. package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
  175. package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
  176. package/dist/services/knowledge/kb-scope-input.js +11 -0
  177. package/dist/services/knowledge/kb-scope-input.js.map +1 -0
  178. package/dist/services/knowledge/kb-service.d.ts +3 -0
  179. package/dist/services/knowledge/kb-service.d.ts.map +1 -0
  180. package/dist/services/knowledge/kb-service.js +2 -0
  181. package/dist/services/knowledge/kb-service.js.map +1 -0
  182. package/dist/services/knowledge/path-validation.d.ts +2 -0
  183. package/dist/services/knowledge/path-validation.d.ts.map +1 -0
  184. package/dist/services/knowledge/path-validation.js +13 -0
  185. package/dist/services/knowledge/path-validation.js.map +1 -0
  186. package/dist/services/knowledge/pre-init.d.ts +14 -0
  187. package/dist/services/knowledge/pre-init.d.ts.map +1 -0
  188. package/dist/services/knowledge/pre-init.js +147 -0
  189. package/dist/services/knowledge/pre-init.js.map +1 -0
  190. package/dist/services/knowledge/project-slug.d.ts +2 -0
  191. package/dist/services/knowledge/project-slug.d.ts.map +1 -0
  192. package/dist/services/knowledge/project-slug.js +49 -0
  193. package/dist/services/knowledge/project-slug.js.map +1 -0
  194. package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
  195. package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
  196. package/dist/services/knowledge/sqlite-provider.js +1646 -0
  197. package/dist/services/knowledge/sqlite-provider.js.map +1 -0
  198. package/dist/services/knowledge/types.d.ts +163 -0
  199. package/dist/services/knowledge/types.d.ts.map +1 -0
  200. package/dist/services/knowledge/types.js +9 -0
  201. package/dist/services/knowledge/types.js.map +1 -0
  202. package/dist/services/member-home.d.ts +89 -0
  203. package/dist/services/member-home.d.ts.map +1 -0
  204. package/dist/services/member-home.js +259 -0
  205. package/dist/services/member-home.js.map +1 -0
  206. package/dist/services/member-remote-url.d.ts +34 -0
  207. package/dist/services/member-remote-url.d.ts.map +1 -0
  208. package/dist/services/member-remote-url.js +39 -0
  209. package/dist/services/member-remote-url.js.map +1 -0
  210. package/dist/services/model-pricing.d.ts.map +1 -1
  211. package/dist/services/model-pricing.js +0 -5
  212. package/dist/services/model-pricing.js.map +1 -1
  213. package/dist/services/orphan-recovery.d.ts +9 -3
  214. package/dist/services/orphan-recovery.d.ts.map +1 -1
  215. package/dist/services/orphan-recovery.js +22 -8
  216. package/dist/services/orphan-recovery.js.map +1 -1
  217. package/dist/services/preflight-check.d.ts +56 -0
  218. package/dist/services/preflight-check.d.ts.map +1 -0
  219. package/dist/services/preflight-check.js +277 -0
  220. package/dist/services/preflight-check.js.map +1 -0
  221. package/dist/services/shell-probe.d.ts +131 -0
  222. package/dist/services/shell-probe.d.ts.map +1 -0
  223. package/dist/services/shell-probe.js +210 -0
  224. package/dist/services/shell-probe.js.map +1 -0
  225. package/dist/services/singleton.d.ts +2 -0
  226. package/dist/services/singleton.d.ts.map +1 -1
  227. package/dist/services/singleton.js +1 -1
  228. package/dist/services/singleton.js.map +1 -1
  229. package/dist/services/ssh.js +2 -2
  230. package/dist/services/ssh.js.map +1 -1
  231. package/dist/services/stall/find-log-file.d.ts.map +1 -1
  232. package/dist/services/stall/find-log-file.js +22 -16
  233. package/dist/services/stall/find-log-file.js.map +1 -1
  234. package/dist/services/stall/log-path-resolver.d.ts +11 -8
  235. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  236. package/dist/services/stall/log-path-resolver.js +17 -40
  237. package/dist/services/stall/log-path-resolver.js.map +1 -1
  238. package/dist/services/stall/read-log-tail.d.ts.map +1 -1
  239. package/dist/services/stall/read-log-tail.js +6 -5
  240. package/dist/services/stall/read-log-tail.js.map +1 -1
  241. package/dist/services/stall/stall-detector.d.ts +32 -0
  242. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  243. package/dist/services/stall/stall-detector.js +149 -6
  244. package/dist/services/stall/stall-detector.js.map +1 -1
  245. package/dist/services/stall/stall-poller.d.ts +34 -0
  246. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  247. package/dist/services/stall/stall-poller.js +160 -35
  248. package/dist/services/stall/stall-poller.js.map +1 -1
  249. package/dist/services/strategy.d.ts +9 -0
  250. package/dist/services/strategy.d.ts.map +1 -1
  251. package/dist/services/strategy.js +41 -7
  252. package/dist/services/strategy.js.map +1 -1
  253. package/dist/services/tool-registry.d.ts.map +1 -1
  254. package/dist/services/tool-registry.js +87 -1
  255. package/dist/services/tool-registry.js.map +1 -1
  256. package/dist/services/user-config.js +1 -1
  257. package/dist/services/user-config.js.map +1 -1
  258. package/dist/services/vcs/azure-devops.d.ts +1 -1
  259. package/dist/services/vcs/azure-devops.d.ts.map +1 -1
  260. package/dist/services/vcs/azure-devops.js +105 -10
  261. package/dist/services/vcs/azure-devops.js.map +1 -1
  262. package/dist/services/vcs/bitbucket.d.ts.map +1 -1
  263. package/dist/services/vcs/bitbucket.js +16 -0
  264. package/dist/services/vcs/bitbucket.js.map +1 -1
  265. package/dist/services/vcs/github.d.ts.map +1 -1
  266. package/dist/services/vcs/github.js +56 -1
  267. package/dist/services/vcs/github.js.map +1 -1
  268. package/dist/services/vcs/types.d.ts +123 -2
  269. package/dist/services/vcs/types.d.ts.map +1 -1
  270. package/dist/services/version-check.d.ts +22 -0
  271. package/dist/services/version-check.d.ts.map +1 -0
  272. package/dist/services/version-check.js +103 -0
  273. package/dist/services/version-check.js.map +1 -0
  274. package/dist/skills/fleet-sprint-cli/SKILL.md +15 -3
  275. package/dist/skills/pm/SKILL.md +0 -1
  276. package/dist/skills/pm/beads.md +6 -0
  277. package/dist/skills/pm/cost.md +0 -1
  278. package/dist/skills/pm/fleet-addendum.md +6 -1
  279. package/dist/skills/pm/index.md +56 -0
  280. package/dist/skills/pm/kb-reconcile.md +132 -0
  281. package/dist/skills/pm/kb-review.md +109 -0
  282. package/dist/tools/check-status.d.ts +47 -0
  283. package/dist/tools/check-status.d.ts.map +1 -1
  284. package/dist/tools/check-status.js +245 -3
  285. package/dist/tools/check-status.js.map +1 -1
  286. package/dist/tools/child-id-allocator.d.ts +2 -2
  287. package/dist/tools/cloud-control.js +2 -2
  288. package/dist/tools/cloud-control.js.map +1 -1
  289. package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
  290. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
  291. package/dist/tools/code-intelligence-codebase-memory.js +270 -0
  292. package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
  293. package/dist/tools/code-intelligence-freshness.d.ts +2 -0
  294. package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
  295. package/dist/tools/code-intelligence-freshness.js +26 -0
  296. package/dist/tools/code-intelligence-freshness.js.map +1 -0
  297. package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
  298. package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
  299. package/dist/tools/code-intelligence-gitnexus.js +475 -0
  300. package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
  301. package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
  302. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
  303. package/dist/tools/code-intelligence-kb-enrich.js +65 -0
  304. package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
  305. package/dist/tools/code-intelligence-reindex.d.ts +7 -0
  306. package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
  307. package/dist/tools/code-intelligence-reindex.js +106 -0
  308. package/dist/tools/code-intelligence-reindex.js.map +1 -0
  309. package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
  310. package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
  311. package/dist/tools/code-intelligence-telemetry.js +52 -0
  312. package/dist/tools/code-intelligence-telemetry.js.map +1 -0
  313. package/dist/tools/code-intelligence-tests.d.ts +2 -0
  314. package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
  315. package/dist/tools/code-intelligence-tests.js +24 -0
  316. package/dist/tools/code-intelligence-tests.js.map +1 -0
  317. package/dist/tools/code-intelligence.d.ts +114 -0
  318. package/dist/tools/code-intelligence.d.ts.map +1 -0
  319. package/dist/tools/code-intelligence.js +124 -0
  320. package/dist/tools/code-intelligence.js.map +1 -0
  321. package/dist/tools/compose-permissions.d.ts +26 -0
  322. package/dist/tools/compose-permissions.d.ts.map +1 -1
  323. package/dist/tools/compose-permissions.js +257 -33
  324. package/dist/tools/compose-permissions.js.map +1 -1
  325. package/dist/tools/execute-command.d.ts +2 -0
  326. package/dist/tools/execute-command.d.ts.map +1 -1
  327. package/dist/tools/execute-command.js +114 -28
  328. package/dist/tools/execute-command.js.map +1 -1
  329. package/dist/tools/execute-prompt.d.ts +13 -1
  330. package/dist/tools/execute-prompt.d.ts.map +1 -1
  331. package/dist/tools/execute-prompt.js +310 -61
  332. package/dist/tools/execute-prompt.js.map +1 -1
  333. package/dist/tools/kb-capture.d.ts +53 -0
  334. package/dist/tools/kb-capture.d.ts.map +1 -0
  335. package/dist/tools/kb-capture.js +130 -0
  336. package/dist/tools/kb-capture.js.map +1 -0
  337. package/dist/tools/kb-context.d.ts +17 -0
  338. package/dist/tools/kb-context.d.ts.map +1 -0
  339. package/dist/tools/kb-context.js +29 -0
  340. package/dist/tools/kb-context.js.map +1 -0
  341. package/dist/tools/kb-export.d.ts +19 -0
  342. package/dist/tools/kb-export.d.ts.map +1 -0
  343. package/dist/tools/kb-export.js +344 -0
  344. package/dist/tools/kb-export.js.map +1 -0
  345. package/dist/tools/kb-feedback.d.ts +23 -0
  346. package/dist/tools/kb-feedback.d.ts.map +1 -0
  347. package/dist/tools/kb-feedback.js +43 -0
  348. package/dist/tools/kb-feedback.js.map +1 -0
  349. package/dist/tools/kb-freshness-sweep.d.ts +14 -0
  350. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
  351. package/dist/tools/kb-freshness-sweep.js +29 -0
  352. package/dist/tools/kb-freshness-sweep.js.map +1 -0
  353. package/dist/tools/kb-harvest.d.ts +20 -0
  354. package/dist/tools/kb-harvest.d.ts.map +1 -0
  355. package/dist/tools/kb-harvest.js +143 -0
  356. package/dist/tools/kb-harvest.js.map +1 -0
  357. package/dist/tools/kb-import.d.ts +44 -0
  358. package/dist/tools/kb-import.d.ts.map +1 -0
  359. package/dist/tools/kb-import.js +239 -0
  360. package/dist/tools/kb-import.js.map +1 -0
  361. package/dist/tools/kb-invalidate.d.ts +19 -0
  362. package/dist/tools/kb-invalidate.d.ts.map +1 -0
  363. package/dist/tools/kb-invalidate.js +34 -0
  364. package/dist/tools/kb-invalidate.js.map +1 -0
  365. package/dist/tools/kb-list.d.ts +32 -0
  366. package/dist/tools/kb-list.d.ts.map +1 -0
  367. package/dist/tools/kb-list.js +43 -0
  368. package/dist/tools/kb-list.js.map +1 -0
  369. package/dist/tools/kb-promote.d.ts +20 -0
  370. package/dist/tools/kb-promote.d.ts.map +1 -0
  371. package/dist/tools/kb-promote.js +20 -0
  372. package/dist/tools/kb-promote.js.map +1 -0
  373. package/dist/tools/kb-query.d.ts +35 -0
  374. package/dist/tools/kb-query.d.ts.map +1 -0
  375. package/dist/tools/kb-query.js +111 -0
  376. package/dist/tools/kb-query.js.map +1 -0
  377. package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
  378. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
  379. package/dist/tools/kb-reconcile-prefilter.js +26 -0
  380. package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
  381. package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
  382. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
  383. package/dist/tools/kb-resolve-contradiction.js +37 -0
  384. package/dist/tools/kb-resolve-contradiction.js.map +1 -0
  385. package/dist/tools/kb-session-prime.d.ts +26 -0
  386. package/dist/tools/kb-session-prime.d.ts.map +1 -0
  387. package/dist/tools/kb-session-prime.js +392 -0
  388. package/dist/tools/kb-session-prime.js.map +1 -0
  389. package/dist/tools/kb-setup.d.ts +20 -0
  390. package/dist/tools/kb-setup.d.ts.map +1 -0
  391. package/dist/tools/kb-setup.js +49 -0
  392. package/dist/tools/kb-setup.js.map +1 -0
  393. package/dist/tools/kb-stats.d.ts +20 -0
  394. package/dist/tools/kb-stats.d.ts.map +1 -0
  395. package/dist/tools/kb-stats.js +115 -0
  396. package/dist/tools/kb-stats.js.map +1 -0
  397. package/dist/tools/list-members.d.ts.map +1 -1
  398. package/dist/tools/list-members.js +6 -2
  399. package/dist/tools/list-members.js.map +1 -1
  400. package/dist/tools/member-detail.d.ts.map +1 -1
  401. package/dist/tools/member-detail.js +13 -3
  402. package/dist/tools/member-detail.js.map +1 -1
  403. package/dist/tools/member-reservation.d.ts.map +1 -1
  404. package/dist/tools/member-reservation.js +13 -1
  405. package/dist/tools/member-reservation.js.map +1 -1
  406. package/dist/tools/monitor-task.d.ts.map +1 -1
  407. package/dist/tools/monitor-task.js +38 -5
  408. package/dist/tools/monitor-task.js.map +1 -1
  409. package/dist/tools/provision-auth.d.ts.map +1 -1
  410. package/dist/tools/provision-auth.js +15 -8
  411. package/dist/tools/provision-auth.js.map +1 -1
  412. package/dist/tools/provision-vcs-auth.d.ts +5 -2
  413. package/dist/tools/provision-vcs-auth.d.ts.map +1 -1
  414. package/dist/tools/provision-vcs-auth.js +58 -52
  415. package/dist/tools/provision-vcs-auth.js.map +1 -1
  416. package/dist/tools/register-member.d.ts +21 -12
  417. package/dist/tools/register-member.d.ts.map +1 -1
  418. package/dist/tools/register-member.js +70 -3
  419. package/dist/tools/register-member.js.map +1 -1
  420. package/dist/tools/remove-member.d.ts.map +1 -1
  421. package/dist/tools/remove-member.js +19 -5
  422. package/dist/tools/remove-member.js.map +1 -1
  423. package/dist/tools/report-status.d.ts.map +1 -1
  424. package/dist/tools/report-status.js +2 -1
  425. package/dist/tools/report-status.js.map +1 -1
  426. package/dist/tools/revoke-vcs-auth.js +2 -2
  427. package/dist/tools/revoke-vcs-auth.js.map +1 -1
  428. package/dist/tools/send-email.d.ts +69 -0
  429. package/dist/tools/send-email.d.ts.map +1 -0
  430. package/dist/tools/send-email.js +177 -0
  431. package/dist/tools/send-email.js.map +1 -0
  432. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  433. package/dist/tools/setup-ssh-key.js +4 -1
  434. package/dist/tools/setup-ssh-key.js.map +1 -1
  435. package/dist/tools/stop-prompt.js +2 -2
  436. package/dist/tools/stop-prompt.js.map +1 -1
  437. package/dist/tools/update-agent-cli.js +2 -2
  438. package/dist/tools/update-agent-cli.js.map +1 -1
  439. package/dist/tools/update-member.d.ts +21 -12
  440. package/dist/tools/update-member.d.ts.map +1 -1
  441. package/dist/tools/update-member.js +43 -2
  442. package/dist/tools/update-member.js.map +1 -1
  443. package/dist/types.d.ts +12 -1
  444. package/dist/types.d.ts.map +1 -1
  445. package/dist/utils/agent-helpers.d.ts +36 -0
  446. package/dist/utils/agent-helpers.d.ts.map +1 -1
  447. package/dist/utils/agent-helpers.js +39 -1
  448. package/dist/utils/agent-helpers.js.map +1 -1
  449. package/dist/utils/platform.d.ts +7 -0
  450. package/dist/utils/platform.d.ts.map +1 -1
  451. package/dist/utils/platform.js +11 -1
  452. package/dist/utils/platform.js.map +1 -1
  453. package/dist/utils/prompt-errors.js +1 -1
  454. package/dist/utils/prompt-errors.js.map +1 -1
  455. package/dist/utils/session-caller.d.ts +28 -0
  456. package/dist/utils/session-caller.d.ts.map +1 -0
  457. package/dist/utils/session-caller.js +24 -0
  458. package/dist/utils/session-caller.js.map +1 -0
  459. package/dist/utils/work-folder-validation.d.ts +39 -0
  460. package/dist/utils/work-folder-validation.d.ts.map +1 -0
  461. package/dist/utils/work-folder-validation.js +60 -0
  462. package/dist/utils/work-folder-validation.js.map +1 -0
  463. package/dist/utils/workspace-trust.d.ts.map +1 -1
  464. package/dist/utils/workspace-trust.js +5 -1
  465. package/dist/utils/workspace-trust.js.map +1 -1
  466. package/dist/workflows/auto-sprint.js +550 -23
  467. package/package.json +7 -4
  468. package/packages/apra-fleet-client/src/client/api.mjs +210 -7
  469. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +31 -19
  470. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +16 -1
  471. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +37 -47
  472. package/packages/apra-fleet-se/apra-pm/agents/doer.md +147 -114
  473. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +41 -34
  474. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +98 -114
  475. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +205 -0
  476. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +45 -44
  477. package/packages/apra-fleet-se/apra-pm/agents/planner.md +121 -50
  478. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +84 -81
  479. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +118 -44
  480. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +63 -3
  481. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +59 -2
  482. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +3 -3
  483. package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
  484. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
  485. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +4 -17
  486. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +105 -8
  487. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +0 -1
  488. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +6 -0
  489. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +0 -1
  490. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +6 -1
  491. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
  492. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
  493. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
  494. package/packages/apra-fleet-se/bin/cli.mjs +139 -3
  495. package/packages/apra-fleet-se/bin/serve.mjs +49 -2
  496. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +182 -38
  497. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +23 -8
  498. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +258 -0
  499. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1487 -0
  500. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
  501. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
  502. package/packages/apra-fleet-se/fleet-sprint/docs/stabilization-log.md +14 -4
  503. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +1148 -0
  504. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +229 -112
  505. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +91 -6
  506. package/packages/apra-fleet-se/fleet-sprint/runner.js +2469 -238
  507. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +134 -0
  508. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +154 -0
  509. package/packages/apra-fleet-se/fleet-sprint/se-windows-gitbash.mjs +97 -0
  510. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +143 -0
  511. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +15 -3
  512. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
  513. package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
  514. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +51 -0
  515. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +657 -12
  516. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/dolt.mjs +33 -4
  517. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +60 -30
  518. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +205 -2
  519. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +164 -0
  520. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +141 -26
  521. package/packages/apra-fleet-se/package.json +1 -0
  522. package/packages/apra-fleet-workflow/src/viewer/index.mjs +294 -14
  523. package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
  524. package/packages/apra-fleet-workflow/src/workflow/index.mjs +443 -35
  525. package/skills/fleet/SKILL.md +20 -9
  526. package/skills/fleet/auth-azdevops.md +44 -5
  527. package/skills/fleet/auth-bitbucket.md +3 -3
  528. package/skills/fleet/auth-github.md +2 -2
  529. package/skills/fleet/beads-conflict-resolution.md +141 -0
  530. package/skills/fleet/beads.md +16 -12
  531. package/skills/fleet/knowledge-agent.md +66 -0
  532. package/skills/fleet/onboarding.md +4 -4
  533. package/skills/fleet/permissions.md +32 -8
  534. package/skills/fleet/profiles/base-dev.json +10 -1
  535. package/skills/fleet/profiles/base-reviewer.json +8 -1
  536. package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
  537. package/skills/fleet/skill-matrix.md +1 -1
  538. package/skills/fleet/troubleshooting.md +2 -1
  539. package/version.json +1 -1
  540. package/dist/providers/gemini.d.ts +0 -42
  541. package/dist/providers/gemini.d.ts.map +0 -1
  542. package/dist/providers/gemini.js +0 -202
  543. package/dist/providers/gemini.js.map +0 -1
  544. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +0 -151
  545. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +0 -127
  546. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +0 -339
  547. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +0 -360
  548. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +0 -363
@@ -0,0 +1,392 @@
1
+ import { z } from 'zod';
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import { getKbProviders } from '../services/knowledge/kb-providers.js';
5
+ import { validateFilePaths } from '../services/knowledge/path-validation.js';
6
+ import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
7
+ import { getProvider } from './code-intelligence.js';
8
+ import { FLEET_DIR } from '../paths.js';
9
+ export const kbSessionPrimeSchema = z.object({
10
+ ...kbScopeFields,
11
+ session_files: z.array(z.string()).optional().describe('Files the agent expects to touch this session'),
12
+ hint_symbols: z.array(z.string()).optional().describe('Symbols likely to be relevant'),
13
+ hint_modules: z.array(z.string()).optional().describe('Module names likely to be relevant'),
14
+ // F4 (T1.6): repo path resolution precedence for the canonical-bible
15
+ // cold-seed below -- (1) this explicit repo_path input, validated (must
16
+ // exist and be a directory); (2) validated session context -- this
17
+ // process's own working directory, used ONLY when repo_path is omitted,
18
+ // put through the exact same existence + isDirectory check, never trusted
19
+ // blindly; (3) neither validates -- the cold-seed block is skipped
20
+ // silently (the existing non-fatal hard-skip contract: prime must never
21
+ // fail because the repo root could not be validated). There is no bare
22
+ // process.cwd() fallback: the fallback tier is validated the same way
23
+ // explicit input is.
24
+ repo_path: z.string().optional().describe('Repo root for the canonical-bible cold-seed (.fleet/kb-canonical.json). Precedence: this explicit input, when given and valid, wins; otherwise falls back to the validated session working directory; if neither validates, the cold-seed merge is skipped silently.'),
25
+ });
26
+ // Graph-neighbor expansion caps (T1.3 P4b, design D4). Exported for tests.
27
+ // NEIGHBOR_CAP: max distinct neighbor symbols carried into the extra KB query.
28
+ export const NEIGHBOR_CAP = 10;
29
+ // ADDED_ENTRY_CAP: max neighbor-derived KB entries appended to top_entries.
30
+ export const ADDED_ENTRY_CAP = 5;
31
+ // T3.5 (F8c, D8): fewer than this many top_entries after ALL merges above
32
+ // (direct hits + global-append + graph-neighbor) counts as a cold local KB,
33
+ // triggering the canonical-bible cold-seed below. Exported for tests.
34
+ export const COLD_KB_MAX = 3;
35
+ // A bible file on disk is one of TWO shapes, and the read path must accept
36
+ // both -- exactly as kb_import already does:
37
+ // - legacy: a bare JSON array of entries
38
+ // - v2 (what kb_export has written since KB-TRUST PHASE 3a):
39
+ // { version: 2, provenance: {commit, branch, entry_count}, entries: [...] }
40
+ // Accepting only the bare array silently killed the cold-start fallback for
41
+ // every bible the current exporter produces (apra-fleet's own bible holds 17
42
+ // CONFIRMED entries prime could not read). Anything else -- a non-array
43
+ // `entries`, a scalar, null -- yields [] so the caller's existing hard-skip
44
+ // contract still applies.
45
+ function bibleEntries(parsed) {
46
+ if (Array.isArray(parsed))
47
+ return parsed;
48
+ if (parsed && typeof parsed === 'object') {
49
+ const envelope = parsed.entries;
50
+ if (Array.isArray(envelope))
51
+ return envelope;
52
+ }
53
+ return [];
54
+ }
55
+ function isCanonicalBibleEntry(value) {
56
+ if (!value || typeof value !== 'object')
57
+ return false;
58
+ const e = value;
59
+ return (typeof e.id === 'string' &&
60
+ typeof e.type === 'string' &&
61
+ typeof e.title === 'string' &&
62
+ typeof e.summary === 'string' &&
63
+ Array.isArray(e.symbols) &&
64
+ Array.isArray(e.source_files));
65
+ }
66
+ // Prefer canonical entries whose symbols overlap hint_symbols, or whose
67
+ // source_files contain a hint_module as a substring (canonical entries carry
68
+ // no separate "module" field -- hint_modules in practice are path-like
69
+ // strings, e.g. "src/tools", that match against source_files directly).
70
+ function canonicalMatchesHints(entry, hintSymbols, hintModules) {
71
+ if (hintSymbols.length > 0 && entry.symbols.some(s => hintSymbols.includes(s)))
72
+ return true;
73
+ if (hintModules.length > 0 && entry.source_files.some(f => hintModules.some(m => f.includes(m))))
74
+ return true;
75
+ return false;
76
+ }
77
+ // F4 (T1.6): shared validation for both precedence tiers -- an explicit
78
+ // repo_path (tier 1) and the session working directory fallback (tier 2, used
79
+ // only when repo_path is omitted) go through the identical existence +
80
+ // isDirectory check. Neither tier is ever trusted without it. Returns null
81
+ // (rather than throwing) when nothing validates, so the caller can hard-skip
82
+ // per the existing non-fatal cold-seed contract.
83
+ function resolveRepoPath(explicit) {
84
+ const candidate = explicit || process.cwd();
85
+ if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory())
86
+ return null;
87
+ return candidate;
88
+ }
89
+ // T3.5 (F9c, D8): `via` param added, defaulting to 'canonical-bible' so the
90
+ // existing project-bible call site below is byte-for-byte unchanged. The new
91
+ // global-bible cold-seed block passes via='canonical-bible-global' so those
92
+ // entries are distinguishable in top_entries (D8's via marker requirement).
93
+ function toCanonicalKBEntry(e, via = 'canonical-bible') {
94
+ return {
95
+ id: e.id,
96
+ type: e.type,
97
+ title: e.title,
98
+ summary: e.summary,
99
+ content: '',
100
+ source_files: e.source_files,
101
+ symbols: e.symbols,
102
+ tags: [],
103
+ content_hash: '',
104
+ content_hash_type: 'sha256',
105
+ stale: false,
106
+ flagged_for_review: false,
107
+ author: via,
108
+ source: 'promotion',
109
+ confidence: e.confidence ?? 'CONFIRMED',
110
+ created_at: e.updated_at ?? '',
111
+ use_count: 0,
112
+ via,
113
+ };
114
+ }
115
+ // Pull neighbor symbol names out of a code-intelligence `context` result.
116
+ // The provider returns a normal MCP result object -- a `content` array of text
117
+ // blocks plus an optional `isError` flag -- whose text block (when the symbol
118
+ // is found) is a JSON string of shape:
119
+ // { status, symbol, incoming: { calls: [{ name }] }, outgoing: { calls: [...] } }
120
+ // (see docs/code-intelligence-child-surface.md). Parse defensively: isError,
121
+ // missing/!array content, no text block, unparseable JSON, or an ambiguous
122
+ // candidate response (no incoming/outgoing) all mean "no neighbors".
123
+ function parseContextNeighbors(result) {
124
+ try {
125
+ if (!result || typeof result !== 'object')
126
+ return [];
127
+ const r = result;
128
+ if (r.isError)
129
+ return [];
130
+ if (!Array.isArray(r.content))
131
+ return [];
132
+ const textBlock = r.content.find((c) => !!c && typeof c === 'object' && c.type === 'text' &&
133
+ typeof c.text === 'string');
134
+ if (!textBlock)
135
+ return [];
136
+ const parsed = JSON.parse(textBlock.text);
137
+ const names = [];
138
+ for (const group of [parsed.incoming?.calls, parsed.outgoing?.calls]) {
139
+ if (!Array.isArray(group))
140
+ continue;
141
+ for (const call of group) {
142
+ const name = call?.name;
143
+ if (typeof name === 'string' && name.length > 0)
144
+ names.push(name);
145
+ }
146
+ }
147
+ return names;
148
+ }
149
+ catch {
150
+ return [];
151
+ }
152
+ }
153
+ export async function kbSessionPrime(input) {
154
+ if (input.session_files?.length)
155
+ validateFilePaths(input.session_files);
156
+ // Prime the KB belonging to the repo being primed, not the server's cwd.
157
+ //
158
+ // apra-fleet-b4g.4: an explicitly supplied repo_path is passed through
159
+ // VERBATIM, even when it does not exist on this host (a remote member's
160
+ // Windows work folder). Routing it through resolveRepoPath() here turned
161
+ // such a path into null and then, via `?? undefined`, into getKbProviders'
162
+ // `cwd ?? process.cwd()` -- so the provider serving that member ended up
163
+ // anchored at the FLEET SERVER'S OWN working directory while repo_remote_url
164
+ // pointed it at the real shared project KB, and prime re-hashed every
165
+ // candidate entry's basis against a tree that does not describe it. Keeping
166
+ // the caller's path means the anchor is honestly "a path this host cannot
167
+ // see", which SqliteProvider.anchorIsMissing() handles by declining to
168
+ // produce a freshness verdict at all. resolveRepoPath still guards the
169
+ // omitted-repo_path fallback (never a bare process.cwd()) and the cold-seed
170
+ // block below, which does need a readable directory.
171
+ const providers = await getKbProviders(input.repo_path ?? resolveRepoPath() ?? undefined, input.repo_remote_url);
172
+ const result = await providers.project.prime({
173
+ session_files: input.session_files,
174
+ hint_symbols: input.hint_symbols,
175
+ hint_modules: input.hint_modules,
176
+ });
177
+ // Append up to 3 global knowledge entries. D4 (T2.1): pass raw terms (a raw
178
+ // session file path or a hint symbol) via fts_terms -- query() sanitizes
179
+ // each term through ftsSafeTerm and OR-joins them centrally, so FTS-hostile
180
+ // characters in a raw file path ('/', '.') cannot throw into the catch
181
+ // below, and multiple terms surface entries matching ANY of them instead of
182
+ // requiring ALL of them (implicit AND, KB finding 83726d75 / feedback.md
183
+ // finding 3).
184
+ const searchTerms = input.session_files?.length ? input.session_files : (input.hint_symbols ?? []);
185
+ if (searchTerms.length) {
186
+ try {
187
+ const globalResult = await providers.global.query({
188
+ fts_terms: searchTerms,
189
+ l1_only: true,
190
+ limit: 10,
191
+ include_stale: false,
192
+ });
193
+ const globalEntries = globalResult.results
194
+ .filter(e => e.type === 'knowledge')
195
+ .slice(0, 3);
196
+ if (globalEntries.length > 0) {
197
+ result.top_entries = [...(result.top_entries ?? []), ...globalEntries];
198
+ }
199
+ }
200
+ catch { }
201
+ }
202
+ // Graph-neighbor expansion (T1.3 P4b, design D4). Join the code-intelligence
203
+ // graph one layer up so it works for both KB providers without touching
204
+ // SqliteProvider.prime / HttpKbProvider.prime. For each hint symbol, ask the
205
+ // CI provider for its neighbors (callers/callees via `context`), run ONE extra
206
+ // KB query batch over the collected neighbors, and append the resulting
207
+ // entries BELOW all direct hits. The ENTIRE block is a hard-skip: any failure
208
+ // (graph offline, no index, unparseable response, KB query error) leaves
209
+ // `result` exactly as prime returned it -- no throw, no error text. Also
210
+ // skipped when hint_symbols is empty/absent.
211
+ if (input.hint_symbols?.length) {
212
+ try {
213
+ const provider = await getProvider();
214
+ // Collect distinct neighbor names not already in hint_symbols, capped at
215
+ // NEIGHBOR_CAP. A per-symbol try/catch keeps one bad symbol from aborting
216
+ // the sweep.
217
+ const seen = new Set(input.hint_symbols);
218
+ const neighbors = [];
219
+ for (const symbol of input.hint_symbols) {
220
+ if (neighbors.length >= NEIGHBOR_CAP)
221
+ break;
222
+ let ctxResult;
223
+ try {
224
+ ctxResult = await provider.context({ name: symbol });
225
+ }
226
+ catch {
227
+ continue;
228
+ }
229
+ for (const name of parseContextNeighbors(ctxResult)) {
230
+ if (neighbors.length >= NEIGHBOR_CAP)
231
+ break;
232
+ if (seen.has(name))
233
+ continue;
234
+ seen.add(name);
235
+ neighbors.push(name);
236
+ }
237
+ }
238
+ if (neighbors.length > 0) {
239
+ // D4 (T2.1): pass raw neighbor names via fts_terms -- query()
240
+ // sanitizes per-neighbor (a single FTS-hostile name degrades to
241
+ // skipping that neighbor rather than killing the whole batch query)
242
+ // AND OR-joins across neighbors so an entry matching ANY neighbor
243
+ // surfaces instead of requiring ALL of them (implicit AND).
244
+ const neighborResult = await providers.project.query({
245
+ fts_terms: neighbors,
246
+ l1_only: true,
247
+ limit: 10,
248
+ include_stale: false,
249
+ });
250
+ // Merge below direct hits: skip ids already present (direct + global),
251
+ // mark each addition via "graph-neighbor", cap at ADDED_ENTRY_CAP.
252
+ const existingIds = new Set((result.top_entries ?? []).map(e => e.id));
253
+ const additions = [];
254
+ for (const entry of neighborResult.results) {
255
+ if (additions.length >= ADDED_ENTRY_CAP)
256
+ break;
257
+ if (existingIds.has(entry.id))
258
+ continue;
259
+ existingIds.add(entry.id);
260
+ additions.push({ ...entry, via: 'graph-neighbor' });
261
+ }
262
+ if (additions.length > 0) {
263
+ result.top_entries = [...(result.top_entries ?? []), ...additions];
264
+ }
265
+ }
266
+ }
267
+ catch {
268
+ // Hard skip: leave `result` exactly as prime returned it.
269
+ }
270
+ }
271
+ // T3.5 (F8c, D8): cold-KB seed from the canonical git bible -- LAST
272
+ // sequenced merge, after direct hits + global-append + graph-neighbor
273
+ // above. When the local KB still returns few top_entries (COLD_KB_MAX),
274
+ // fall back to <repo>/.fleet/kb-canonical.json (written by kb_export after
275
+ // promotion) so a fresh clone or cold project still gets team knowledge.
276
+ // Entries are marked via:'canonical-bible' and always appended BELOW every
277
+ // live-KB hit gathered above. Non-fatal: the entire block is a hard skip --
278
+ // missing file, unreadable/malformed JSON, or a bad shape leaves `result`
279
+ // exactly as built above (same contract as the neighbor block).
280
+ if ((result.top_entries ?? []).length < COLD_KB_MAX) {
281
+ try {
282
+ const repoRoot = resolveRepoPath(input.repo_path);
283
+ const canonicalPath = repoRoot ? path.join(repoRoot, '.fleet', 'kb-canonical.json') : null;
284
+ if (canonicalPath && fs.existsSync(canonicalPath)) {
285
+ const raw = fs.readFileSync(canonicalPath, 'utf-8');
286
+ const entries = bibleEntries(JSON.parse(raw));
287
+ if (entries.length > 0) {
288
+ const existingIds = new Set((result.top_entries ?? []).map(e => e.id));
289
+ const hintSymbols = input.hint_symbols ?? [];
290
+ const hintModules = input.hint_modules ?? [];
291
+ const valid = entries
292
+ .filter(isCanonicalBibleEntry)
293
+ .filter(e => !existingIds.has(e.id));
294
+ let ordered = valid;
295
+ if (hintSymbols.length > 0 || hintModules.length > 0) {
296
+ const matched = valid.filter(e => canonicalMatchesHints(e, hintSymbols, hintModules));
297
+ const matchedIds = new Set(matched.map(e => e.id));
298
+ const rest = valid.filter(e => !matchedIds.has(e.id));
299
+ ordered = [...matched, ...rest];
300
+ }
301
+ const additions = [];
302
+ for (const e of ordered) {
303
+ if (additions.length >= ADDED_ENTRY_CAP)
304
+ break;
305
+ additions.push(toCanonicalKBEntry(e));
306
+ }
307
+ if (additions.length > 0) {
308
+ result.top_entries = [...(result.top_entries ?? []), ...additions];
309
+ // Delivery is retrieval. Live hits above were bumped by query()
310
+ // inside prime(); a bible entry never passes through query(), so
311
+ // without this it reaches an agent while staying invisible to
312
+ // use_count / last_accessed / kb_stats.retrieval -- which is
313
+ // exactly why hit_rate read 0 across six sprints. Awaited but
314
+ // isolated: telemetry must never cost us the priming result.
315
+ try {
316
+ await providers.project.touch(additions.map(e => e.id));
317
+ }
318
+ catch { }
319
+ }
320
+ }
321
+ }
322
+ }
323
+ catch {
324
+ // Hard skip: leave `result` exactly as built above.
325
+ }
326
+ }
327
+ // T3.5 (F9c, D8): global-bible cold-seed -- APPENDED AFTER the existing
328
+ // project-bible cold-seed block above (design Phasing note: F9 appends
329
+ // after the existing cold-seed block; this is deliberately the LAST merge
330
+ // in the whole function). Reads the INSTALLED global bible at
331
+ // FLEET_DIR/knowledge/global/kb-canonical-global.json -- the homedir-based
332
+ // machine-wide copy the T3.4 installer step places there (NOT anything
333
+ // under the session's repo root, unlike the project bible above). Entries
334
+ // are marked via:'canonical-bible-global' and ordered BELOW every
335
+ // project-bible entry (this block only ever appends, after the project
336
+ // block has already run). Re-checks the SAME shared COLD_KB_MAX threshold
337
+ // against top_entries as built by every merge above (direct hits + global-
338
+ // KB append + graph-neighbor + project-bible), so this runs only when the
339
+ // session is still cold after all of that. Same dedupe-by-id, same
340
+ // ADDED_ENTRY_CAP, and the identical hard-skip non-fatal contract as the
341
+ // project-bible block: missing file, unreadable/malformed JSON, or a bad
342
+ // shape leaves `result` exactly as built above -- warm sessions (>=
343
+ // COLD_KB_MAX) never reach this block at all.
344
+ if ((result.top_entries ?? []).length < COLD_KB_MAX) {
345
+ try {
346
+ const globalBiblePath = path.join(FLEET_DIR, 'knowledge', 'global', 'kb-canonical-global.json');
347
+ if (fs.existsSync(globalBiblePath)) {
348
+ const raw = fs.readFileSync(globalBiblePath, 'utf-8');
349
+ const entries = bibleEntries(JSON.parse(raw));
350
+ if (entries.length > 0) {
351
+ const existingIds = new Set((result.top_entries ?? []).map(e => e.id));
352
+ const hintSymbols = input.hint_symbols ?? [];
353
+ const hintModules = input.hint_modules ?? [];
354
+ const valid = entries
355
+ .filter(isCanonicalBibleEntry)
356
+ .filter(e => !existingIds.has(e.id));
357
+ let ordered = valid;
358
+ if (hintSymbols.length > 0 || hintModules.length > 0) {
359
+ const matched = valid.filter(e => canonicalMatchesHints(e, hintSymbols, hintModules));
360
+ const matchedIds = new Set(matched.map(e => e.id));
361
+ const rest = valid.filter(e => !matchedIds.has(e.id));
362
+ ordered = [...matched, ...rest];
363
+ }
364
+ const additions = [];
365
+ for (const e of ordered) {
366
+ if (additions.length >= ADDED_ENTRY_CAP)
367
+ break;
368
+ additions.push(toCanonicalKBEntry(e, 'canonical-bible-global'));
369
+ }
370
+ if (additions.length > 0) {
371
+ result.top_entries = [...(result.top_entries ?? []), ...additions];
372
+ // Delivery is retrieval. Live hits above were bumped by query()
373
+ // inside prime(); a bible entry never passes through query(), so
374
+ // without this it reaches an agent while staying invisible to
375
+ // use_count / last_accessed / kb_stats.retrieval -- which is
376
+ // exactly why hit_rate read 0 across six sprints. Awaited but
377
+ // isolated: telemetry must never cost us the priming result.
378
+ try {
379
+ await providers.project.touch(additions.map(e => e.id));
380
+ }
381
+ catch { }
382
+ }
383
+ }
384
+ }
385
+ }
386
+ catch {
387
+ // Hard skip: leave `result` exactly as built above.
388
+ }
389
+ }
390
+ return JSON.stringify(result);
391
+ }
392
+ //# sourceMappingURL=kb-session-prime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-session-prime.js","sourceRoot":"","sources":["../../src/tools/kb-session-prime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,GAAG,aAAa;IAChB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACvG,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACtF,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC3F,qEAAqE;IACrE,wEAAwE;IACxE,mEAAmE;IACnE,wEAAwE;IACxE,0EAA0E;IAC1E,mEAAmE;IACnE,wEAAwE;IACxE,uEAAuE;IACvE,sEAAsE;IACtE,qBAAqB;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sQAAsQ,CAAC;CAClT,CAAC,CAAC;AAIH,2EAA2E;AAC3E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC,0EAA0E;AAC1E,4EAA4E;AAC5E,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAkB7B,2EAA2E;AAC3E,6CAA6C;AAC7C,2CAA2C;AAC3C,+DAA+D;AAC/D,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,4EAA4E;AAC5E,0BAA0B;AAC1B,SAAS,YAAY,CAAC,MAAe;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAI,MAAgC,CAAC,OAAO,CAAC;QAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAC3B,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACxB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,6EAA6E;AAC7E,uEAAuE;AACvE,wEAAwE;AACxE,SAAS,qBAAqB,CAC5B,KAA0B,EAC1B,WAAqB,EACrB,WAAqB;IAErB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5F,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9G,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wEAAwE;AACxE,8EAA8E;AAC9E,uEAAuE;AACvE,2EAA2E;AAC3E,6EAA6E;AAC7E,iDAAiD;AACjD,SAAS,eAAe,CAAC,QAAiB;IACxC,MAAM,SAAS,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;QAAE,OAAO,IAAI,CAAC;IACpF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAC5E,4EAA4E;AAC5E,SAAS,kBAAkB,CAAC,CAAsB,EAAE,MAAc,iBAAiB;IACjF,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAuB;QAC/B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,IAAI,EAAE,EAAE;QACR,YAAY,EAAE,EAAE;QAChB,iBAAiB,EAAE,QAAQ;QAC3B,KAAK,EAAE,KAAK;QACZ,kBAAkB,EAAE,KAAK;QACzB,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,WAAW;QACnB,UAAU,EAAG,CAAC,CAAC,UAAoC,IAAI,WAAW;QAClE,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;QAC9B,SAAS,EAAE,CAAC;QACZ,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,+EAA+E;AAC/E,8EAA8E;AAC9E,uCAAuC;AACvC,oFAAoF;AACpF,6EAA6E;AAC7E,2EAA2E;AAC3E,qEAAqE;AACrE,SAAS,qBAAqB,CAAC,MAAe;IAC5C,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACrD,MAAM,CAAC,GAAG,MAAkD,CAAC;QAC7D,IAAI,CAAC,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAuC,EAAE,CACzC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAK,CAAwB,CAAC,IAAI,KAAK,MAAM;YACzE,OAAQ,CAAwB,CAAC,IAAI,KAAK,QAAQ,CACrD,CAAC;QACF,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAGvC,CAAC;QACF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,SAAS;YACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAI,IAA2B,EAAE,IAAI,CAAC;gBAChD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA0B;IAC7D,IAAI,KAAK,CAAC,aAAa,EAAE,MAAM;QAAE,iBAAiB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAExE,yEAAyE;IACzE,EAAE;IACF,uEAAuE;IACvE,wEAAwE;IACxE,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,6EAA6E;IAC7E,sEAAsE;IACtE,4EAA4E;IAC5E,0EAA0E;IAC1E,uEAAuE;IACvE,uEAAuE;IACvE,4EAA4E;IAC5E,qDAAqD;IACrD,MAAM,SAAS,GAAG,MAAM,cAAc,CACpC,KAAK,CAAC,SAAS,IAAI,eAAe,EAAE,IAAI,SAAS,EACjD,KAAK,CAAC,eAAe,CACtB,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;QAC3C,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,yEAAyE;IACzE,cAAc;IACd,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACnG,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;gBAChD,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,EAAE;gBACT,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;YACH,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO;iBACvC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;iBACnC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACf,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,WAAW,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,6EAA6E;IAC7E,wEAAwE;IACxE,6EAA6E;IAC7E,+EAA+E;IAC/E,wEAAwE;IACxE,8EAA8E;IAC9E,yEAAyE;IACzE,yEAAyE;IACzE,6CAA6C;IAC7C,IAAI,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;YAErC,yEAAyE;YACzE,0EAA0E;YAC1E,aAAa;YACb,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACzC,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACxC,IAAI,SAAS,CAAC,MAAM,IAAI,YAAY;oBAAE,MAAM;gBAC5C,IAAI,SAAkB,CAAC;gBACvB,IAAI,CAAC;oBACH,SAAS,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvD,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,KAAK,MAAM,IAAI,IAAI,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC;oBACpD,IAAI,SAAS,CAAC,MAAM,IAAI,YAAY;wBAAE,MAAM;oBAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;wBAAE,SAAS;oBAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACf,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,8DAA8D;gBAC9D,gEAAgE;gBAChE,oEAAoE;gBACpE,kEAAkE;gBAClE,4DAA4D;gBAC5D,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;oBACnD,SAAS,EAAE,SAAS;oBACpB,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,EAAE;oBACT,aAAa,EAAE,KAAK;iBACrB,CAAC,CAAC;gBAEH,uEAAuE;gBACvE,mEAAmE;gBACnE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACvE,MAAM,SAAS,GAAqC,EAAE,CAAC;gBACvD,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;oBAC3C,IAAI,SAAS,CAAC,MAAM,IAAI,eAAe;wBAAE,MAAM;oBAC/C,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;wBAAE,SAAS;oBACxC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBAC1B,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACtD,CAAC;gBACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,MAAM,CAAC,WAAW,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,sEAAsE;IACtE,wEAAwE;IACxE,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,gEAAgE;IAChE,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3F,IAAI,aAAa,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBAClD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;gBACpD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC,CAAC;gBAEzD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACvE,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;oBAC7C,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;oBAE7C,MAAM,KAAK,GAAG,OAAO;yBAClB,MAAM,CAAC,qBAAqB,CAAC;yBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAEvC,IAAI,OAAO,GAAG,KAAK,CAAC;oBACpB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;wBACtF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wBACnD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wBACtD,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;oBAClC,CAAC;oBAED,MAAM,SAAS,GAAqC,EAAE,CAAC;oBACvD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;wBACxB,IAAI,SAAS,CAAC,MAAM,IAAI,eAAe;4BAAE,MAAM;wBAC/C,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;oBACxC,CAAC;oBAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzB,MAAM,CAAC,WAAW,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;wBACnE,gEAAgE;wBAChE,iEAAiE;wBACjE,8DAA8D;wBAC9D,6DAA6D;wBAC7D,8DAA8D;wBAC9D,6DAA6D;wBAC7D,IAAI,CAAC;4BACH,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wBAC1D,CAAC;wBAAC,MAAM,CAAC,CAAA,CAAC;oBACZ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,uEAAuE;IACvE,0EAA0E;IAC1E,8DAA8D;IAC9D,2EAA2E;IAC3E,uEAAuE;IACvE,0EAA0E;IAC1E,kEAAkE;IAClE,uEAAuE;IACvE,0EAA0E;IAC1E,2EAA2E;IAC3E,0EAA0E;IAC1E,mEAAmE;IACnE,yEAAyE;IACzE,yEAAyE;IACzE,oEAAoE;IACpE,8CAA8C;IAC9C,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,0BAA0B,CAAC,CAAC;YAChG,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;gBACtD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC,CAAC;gBAEzD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACvE,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;oBAC7C,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;oBAE7C,MAAM,KAAK,GAAG,OAAO;yBAClB,MAAM,CAAC,qBAAqB,CAAC;yBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAEvC,IAAI,OAAO,GAAG,KAAK,CAAC;oBACpB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;wBACtF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wBACnD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wBACtD,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;oBAClC,CAAC;oBAED,MAAM,SAAS,GAAqC,EAAE,CAAC;oBACvD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;wBACxB,IAAI,SAAS,CAAC,MAAM,IAAI,eAAe;4BAAE,MAAM;wBAC/C,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC;oBAClE,CAAC;oBAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzB,MAAM,CAAC,WAAW,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;wBACnE,gEAAgE;wBAChE,iEAAiE;wBACjE,8DAA8D;wBAC9D,6DAA6D;wBAC7D,8DAA8D;wBAC9D,6DAA6D;wBAC7D,IAAI,CAAC;4BACH,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wBAC1D,CAAC;wBAAC,MAAM,CAAC,CAAA,CAAC;oBACZ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}
@@ -0,0 +1,20 @@
1
+ import { z } from 'zod';
2
+ export declare const kbSetupSchema: z.ZodObject<{
3
+ repo_path: z.ZodOptional<z.ZodString>;
4
+ provider: z.ZodOptional<z.ZodEnum<["sqlite", "http"]>>;
5
+ remote: z.ZodOptional<z.ZodString>;
6
+ token: z.ZodOptional<z.ZodString>;
7
+ }, "strip", z.ZodTypeAny, {
8
+ remote?: string | undefined;
9
+ provider?: "http" | "sqlite" | undefined;
10
+ token?: string | undefined;
11
+ repo_path?: string | undefined;
12
+ }, {
13
+ remote?: string | undefined;
14
+ provider?: "http" | "sqlite" | undefined;
15
+ token?: string | undefined;
16
+ repo_path?: string | undefined;
17
+ }>;
18
+ export type KbSetupInput = z.infer<typeof kbSetupSchema>;
19
+ export declare function kbSetup(input: KbSetupInput): Promise<string>;
20
+ //# sourceMappingURL=kb-setup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-setup.d.ts","sourceRoot":"","sources":["../../src/tools/kb-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EASxB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAKzD,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClE"}
@@ -0,0 +1,49 @@
1
+ import { z } from 'zod';
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import { FLEET_DIR } from '../paths.js';
5
+ import { installKbPostCommitHook } from './kb-invalidate.js';
6
+ import { encryptPassword } from '../utils/crypto.js';
7
+ export const kbSetupSchema = z.object({
8
+ repo_path: z.string().optional()
9
+ .describe('Path to git repository for post-commit hook installation (default: current directory)'),
10
+ provider: z.enum(['sqlite', 'http']).optional()
11
+ .describe('KB provider type (default: sqlite)'),
12
+ remote: z.string().optional()
13
+ .describe('Remote KB server URL (required when provider=http)'),
14
+ token: z.string().optional()
15
+ .describe('Authentication token for remote KB server (stored encrypted, never logged)'),
16
+ });
17
+ const KB_CONFIG_DIR = path.join(FLEET_DIR, 'knowledge');
18
+ const KB_CONFIG_PATH = path.join(KB_CONFIG_DIR, 'config.json');
19
+ export async function kbSetup(input) {
20
+ const steps = [];
21
+ // Install git post-commit hook
22
+ const repoPath = input.repo_path || process.cwd();
23
+ const gitDir = path.join(repoPath, '.git');
24
+ if (fs.existsSync(gitDir)) {
25
+ installKbPostCommitHook(repoPath);
26
+ steps.push('Installed git post-commit hook for KB invalidation');
27
+ }
28
+ else {
29
+ steps.push('Skipped git hook: no .git directory found at ' + repoPath);
30
+ }
31
+ // Write provider config
32
+ if (!fs.existsSync(KB_CONFIG_DIR)) {
33
+ fs.mkdirSync(KB_CONFIG_DIR, { recursive: true });
34
+ }
35
+ const config = {
36
+ provider: input.provider || (input.remote ? 'http' : 'sqlite'),
37
+ };
38
+ if (input.remote) {
39
+ config.url = input.remote;
40
+ }
41
+ if (input.token) {
42
+ config.token_encrypted = encryptPassword(input.token);
43
+ steps.push('Stored remote token encrypted (AES-256-GCM)');
44
+ }
45
+ fs.writeFileSync(KB_CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });
46
+ steps.push('Wrote KB config to ' + KB_CONFIG_PATH);
47
+ return JSON.stringify({ success: true, steps });
48
+ }
49
+ //# sourceMappingURL=kb-setup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-setup.js","sourceRoot":"","sources":["../../src/tools/kb-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,QAAQ,CAAC,uFAAuF,CAAC;IACpG,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC5C,QAAQ,CAAC,oCAAoC,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B,QAAQ,CAAC,oDAAoD,CAAC;IACjE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,4EAA4E,CAAC;CAC1F,CAAC,CAAC;AAIH,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACxD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAmB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACnE,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+CAA+C,GAAG,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAA2B;QACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;KAC/D,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC5D,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,qBAAqB,GAAG,cAAc,CAAC,CAAC;IAEnD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC"}
@@ -0,0 +1,20 @@
1
+ import { z } from 'zod';
2
+ export declare const kbStatsSchema: z.ZodObject<{
3
+ repo: z.ZodOptional<z.ZodString>;
4
+ repo_path: z.ZodOptional<z.ZodString>;
5
+ symbols: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6
+ repo_remote_url: z.ZodOptional<z.ZodString>;
7
+ }, "strip", z.ZodTypeAny, {
8
+ symbols?: string[] | undefined;
9
+ repo_path?: string | undefined;
10
+ repo_remote_url?: string | undefined;
11
+ repo?: string | undefined;
12
+ }, {
13
+ symbols?: string[] | undefined;
14
+ repo_path?: string | undefined;
15
+ repo_remote_url?: string | undefined;
16
+ repo?: string | undefined;
17
+ }>;
18
+ export type KbStatsInput = z.infer<typeof kbStatsSchema>;
19
+ export declare function kbStats(input: KbStatsInput): Promise<string>;
20
+ //# sourceMappingURL=kb-stats.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-stats.d.ts","sourceRoot":"","sources":["../../src/tools/kb-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAexB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAezD,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFlE"}
@@ -0,0 +1,115 @@
1
+ import { z } from 'zod';
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import { getKbProviders } from '../services/knowledge/kb-providers.js';
5
+ import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
6
+ // T2.1 (F5, D4): kb_stats -- a read-only aggregation tool, following the
7
+ // kb_list no-bump pattern (SqliteProvider.stats() never touches use_count/
8
+ // last_accessed). Reports the KB's health: confidence/type totals,
9
+ // stale/flagged/superseded counts, retrieval hit_rate, promote_ratio, canon-
10
+ // ical-bible drift (D5), and optional per-symbol coverage.
11
+ //
12
+ // D5 constraint (stated here per the tool description, verbatim intent):
13
+ // bible drift is VISIBILITY for the machine that owns the KB -- CI cannot see
14
+ // the local kb.sqlite, so no CI gate reads this tool or its drift number.
15
+ export const kbStatsSchema = z.object({
16
+ ...kbScopeFields,
17
+ repo: z.string().optional()
18
+ .describe('Path to the repo root for the canonical-bible drift check (.fleet/kb-canonical.json). Precedence: this explicit input, when given and valid, wins; otherwise falls back to repo_path, then to the validated session working directory (same validation as kb_export/kb_session_prime); if none validates, bible.present is reported false and drift equals the full live-CONFIRMED count -- kb_stats never fails because of this.'),
19
+ // apra-fleet-src: every other kb_* tool (kb_list, kb_capture, kb_promote,
20
+ // kb_session_prime, kb_export) names this input `repo_path`. kb_stats alone
21
+ // took `repo`, and zod strips unknown keys silently -- so calling it the way
22
+ // every sibling is called did not error, it fell back to the SERVER's cwd and
23
+ // reported a fully-zeroed KB for a populated repo. A confidently wrong "there
24
+ // is nothing here" is worse than a failure, because kb_stats is exactly the
25
+ // tool an operator reaches for to ask whether the KB is working.
26
+ repo_path: z.string().optional()
27
+ .describe('Alias for `repo`, matching the input name used by every other kb_* tool. Ignored when `repo` is also supplied.'),
28
+ symbols: z.array(z.string()).optional()
29
+ .describe('Symbols to check coverage for: per-symbol boolean (a live CONFIRMED entry whose symbols array contains it, exact match) plus the overall fraction.'),
30
+ });
31
+ // F4 (T1.6) precedence pattern, reused here: explicit input > validated
32
+ // process.cwd() > null (non-fatal -- kb_stats never throws over a bad repo
33
+ // path, it just reports bible.present = false).
34
+ function resolveRepoPath(explicit) {
35
+ const candidate = explicit || process.cwd();
36
+ if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory())
37
+ return null;
38
+ return candidate;
39
+ }
40
+ export async function kbStats(input) {
41
+ // `repo` wins over the `repo_path` alias so existing callers are unaffected.
42
+ const requestedRepo = input.repo ?? input.repo_path;
43
+ // Stats must describe the repo asked about, not the server's cwd.
44
+ //
45
+ // apra-fleet-b4g.7: an explicitly supplied repo path is passed through
46
+ // VERBATIM, exactly as kb_session_prime does (see the note at
47
+ // kb-session-prime.ts:186). Routing it through resolveRepoPath() here turned
48
+ // a remote member's unreachable work folder into null and then, via
49
+ // `?? undefined`, into getKbProviders' `cwd ?? process.cwd()` -- so the slug
50
+ // came from repo_remote_url (the REAL shared project KB) while the anchor
51
+ // became the fleet server's own working directory, and every basis hash was
52
+ // computed against a tree that does not describe those entries. Keeping the
53
+ // caller's path means the anchor is honestly "a path this host cannot see",
54
+ // which SqliteProvider.anchorIsMissing() handles by declining to produce a
55
+ // freshness verdict at all. resolveRepoPath still guards the omitted-path
56
+ // fallback and the bible-drift read below, which does need a readable dir.
57
+ const providers = await getKbProviders(requestedRepo ?? resolveRepoPath() ?? undefined, input.repo_remote_url);
58
+ const providerStats = await providers.project.stats({ symbols: input.symbols });
59
+ // D5: bible.drift = count of live CONFIRMED entries whose updated_at
60
+ // (promoted_at || created_at, matching kb_export's own field) is newer than
61
+ // the bible's newest updated_at. Absent/unreadable/malformed file -> drift =
62
+ // ALL live CONFIRMED entries, present = false. list({confidence:'CONFIRMED'})
63
+ // already returns exactly the "live CONFIRMED" set (superseded_at IS NULL
64
+ // AND stale = 0 are list()'s hardcoded defaults) without bumping use_count.
65
+ let bible = { present: false, entries: 0, drift: 0 };
66
+ try {
67
+ const liveConfirmed = await providers.project.list({ confidence: 'CONFIRMED' });
68
+ const liveUpdatedAts = liveConfirmed.map(e => e.promoted_at || e.created_at);
69
+ // Degraded-safe fallback shared by every "can't use the bible file" path
70
+ // below (absent, unreadable, malformed JSON, non-array shape): drift
71
+ // equals ALL live CONFIRMED entries per D5, never silently lost to 0.
72
+ bible = { present: false, entries: 0, drift: liveConfirmed.length };
73
+ const repoPath = resolveRepoPath(requestedRepo);
74
+ const biblePath = repoPath ? path.join(repoPath, '.fleet', 'kb-canonical.json') : null;
75
+ if (biblePath && fs.existsSync(biblePath)) {
76
+ try {
77
+ const raw = fs.readFileSync(biblePath, 'utf-8');
78
+ const parsed = JSON.parse(raw);
79
+ // KB-TRUST PHASE 3a: the bible has two shapes -- a legacy bare array and
80
+ // the v2 { version, provenance, entries } envelope. Handle BOTH: reading
81
+ // only the array shape would silently report present:false and a drift
82
+ // of every live CONFIRMED entry against a perfectly good v2 bible, and
83
+ // this block degrades quietly by design, so that would never be noticed.
84
+ const entries = Array.isArray(parsed)
85
+ ? parsed
86
+ : (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries))
87
+ ? parsed.entries
88
+ : null;
89
+ if (entries !== null) {
90
+ let newest = null;
91
+ for (const entry of entries) {
92
+ const updatedAt = entry?.updated_at;
93
+ if (typeof updatedAt === 'string' && (!newest || updatedAt > newest))
94
+ newest = updatedAt;
95
+ }
96
+ const drift = newest === null
97
+ ? liveConfirmed.length
98
+ : liveUpdatedAts.filter(u => u > newest).length;
99
+ bible = { present: true, entries: entries.length, drift };
100
+ }
101
+ }
102
+ catch {
103
+ // Malformed/unreadable bible file: leave the absent-shape fallback
104
+ // (drift = all live CONFIRMED) set above.
105
+ }
106
+ }
107
+ }
108
+ catch {
109
+ // Degraded-safe: kb_stats never throws over the bible file. Falls back to
110
+ // the "absent, drift 0" shape initialized above (only reachable if the
111
+ // list({confidence:'CONFIRMED'}) read itself failed).
112
+ }
113
+ return JSON.stringify({ ...providerStats, bible });
114
+ }
115
+ //# sourceMappingURL=kb-stats.js.map