@apralabs/apra-fleet 0.4.0 → 0.4.1

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 (427) hide show
  1. package/README.md +145 -7
  2. package/dist/agents/backlog-groomer.md +17 -1
  3. package/dist/agents/ci-watcher.md +13 -1
  4. package/dist/agents/deployer.md +15 -3
  5. package/dist/agents/doer.md +35 -1
  6. package/dist/agents/harvester.md +22 -3
  7. package/dist/agents/integ-test-runner.md +18 -2
  8. package/dist/agents/kb-reconciler.md +216 -0
  9. package/dist/agents/plan-reviewer.md +14 -1
  10. package/dist/agents/planner.md +88 -5
  11. package/dist/agents/regression-test-runner.md +19 -1
  12. package/dist/agents/reviewer.md +104 -3
  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 +2 -2
  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/reviewer-output.json +105 -8
  19. package/dist/cli/install.d.ts +1 -0
  20. package/dist/cli/install.d.ts.map +1 -1
  21. package/dist/cli/install.js +136 -5
  22. package/dist/cli/install.js.map +1 -1
  23. package/dist/cli/join.js +1 -1
  24. package/dist/cli/join.js.map +1 -1
  25. package/dist/cli/kb-commit.d.ts +12 -0
  26. package/dist/cli/kb-commit.d.ts.map +1 -0
  27. package/dist/cli/kb-commit.js +53 -0
  28. package/dist/cli/kb-commit.js.map +1 -0
  29. package/dist/cli/kb-directives.d.ts +17 -0
  30. package/dist/cli/kb-directives.d.ts.map +1 -0
  31. package/dist/cli/kb-directives.js +146 -0
  32. package/dist/cli/kb-directives.js.map +1 -0
  33. package/dist/cli/kb-import.d.ts +13 -0
  34. package/dist/cli/kb-import.d.ts.map +1 -0
  35. package/dist/cli/kb-import.js +56 -0
  36. package/dist/cli/kb-import.js.map +1 -0
  37. package/dist/cli/uninstall.d.ts.map +1 -1
  38. package/dist/cli/uninstall.js +11 -0
  39. package/dist/cli/uninstall.js.map +1 -1
  40. package/dist/cli/watch.d.ts +53 -4
  41. package/dist/cli/watch.d.ts.map +1 -1
  42. package/dist/cli/watch.js +118 -17
  43. package/dist/cli/watch.js.map +1 -1
  44. package/dist/commands/kb-server.d.ts +8 -0
  45. package/dist/commands/kb-server.d.ts.map +1 -0
  46. package/dist/commands/kb-server.js +221 -0
  47. package/dist/commands/kb-server.js.map +1 -0
  48. package/dist/index.js +77 -2
  49. package/dist/index.js.map +1 -1
  50. package/dist/os/linux.d.ts +1 -0
  51. package/dist/os/linux.d.ts.map +1 -1
  52. package/dist/os/linux.js +18 -1
  53. package/dist/os/linux.js.map +1 -1
  54. package/dist/os/os-commands.d.ts +5 -0
  55. package/dist/os/os-commands.d.ts.map +1 -1
  56. package/dist/os/windows.d.ts +35 -0
  57. package/dist/os/windows.d.ts.map +1 -1
  58. package/dist/os/windows.js +67 -31
  59. package/dist/os/windows.js.map +1 -1
  60. package/dist/providers/agy.d.ts +12 -1
  61. package/dist/providers/agy.d.ts.map +1 -1
  62. package/dist/providers/agy.js +134 -9
  63. package/dist/providers/agy.js.map +1 -1
  64. package/dist/providers/claude.d.ts +11 -1
  65. package/dist/providers/claude.d.ts.map +1 -1
  66. package/dist/providers/claude.js +47 -19
  67. package/dist/providers/claude.js.map +1 -1
  68. package/dist/providers/codex.d.ts +11 -1
  69. package/dist/providers/codex.d.ts.map +1 -1
  70. package/dist/providers/codex.js +29 -6
  71. package/dist/providers/codex.js.map +1 -1
  72. package/dist/providers/copilot.d.ts +11 -1
  73. package/dist/providers/copilot.d.ts.map +1 -1
  74. package/dist/providers/copilot.js +26 -6
  75. package/dist/providers/copilot.js.map +1 -1
  76. package/dist/providers/email/headers.d.ts +15 -0
  77. package/dist/providers/email/headers.d.ts.map +1 -0
  78. package/dist/providers/email/headers.js +42 -0
  79. package/dist/providers/email/headers.js.map +1 -0
  80. package/dist/providers/email/index.d.ts +18 -0
  81. package/dist/providers/email/index.d.ts.map +1 -0
  82. package/dist/providers/email/index.js +60 -0
  83. package/dist/providers/email/index.js.map +1 -0
  84. package/dist/providers/email/provider.d.ts +49 -0
  85. package/dist/providers/email/provider.d.ts.map +1 -0
  86. package/dist/providers/email/provider.js +2 -0
  87. package/dist/providers/email/provider.js.map +1 -0
  88. package/dist/providers/email/sendgrid.d.ts +12 -0
  89. package/dist/providers/email/sendgrid.d.ts.map +1 -0
  90. package/dist/providers/email/sendgrid.js +67 -0
  91. package/dist/providers/email/sendgrid.js.map +1 -0
  92. package/dist/providers/email/smtp.d.ts +65 -0
  93. package/dist/providers/email/smtp.d.ts.map +1 -0
  94. package/dist/providers/email/smtp.js +373 -0
  95. package/dist/providers/email/smtp.js.map +1 -0
  96. package/dist/providers/gemini.d.ts +11 -1
  97. package/dist/providers/gemini.d.ts.map +1 -1
  98. package/dist/providers/gemini.js +38 -4
  99. package/dist/providers/gemini.js.map +1 -1
  100. package/dist/providers/none.d.ts +11 -1
  101. package/dist/providers/none.d.ts.map +1 -1
  102. package/dist/providers/none.js +21 -0
  103. package/dist/providers/none.js.map +1 -1
  104. package/dist/providers/opencode.d.ts +11 -1
  105. package/dist/providers/opencode.d.ts.map +1 -1
  106. package/dist/providers/opencode.js +55 -4
  107. package/dist/providers/opencode.js.map +1 -1
  108. package/dist/providers/provider.d.ts +77 -0
  109. package/dist/providers/provider.d.ts.map +1 -1
  110. package/dist/providers/provider.js +44 -0
  111. package/dist/providers/provider.js.map +1 -1
  112. package/dist/services/agent-provisioner.d.ts.map +1 -1
  113. package/dist/services/agent-provisioner.js +3 -6
  114. package/dist/services/agent-provisioner.js.map +1 -1
  115. package/dist/services/cloud/lifecycle.d.ts.map +1 -1
  116. package/dist/services/cloud/lifecycle.js +3 -0
  117. package/dist/services/cloud/lifecycle.js.map +1 -1
  118. package/dist/services/cloud/task-wrapper.d.ts +18 -0
  119. package/dist/services/cloud/task-wrapper.d.ts.map +1 -1
  120. package/dist/services/cloud/task-wrapper.js +157 -0
  121. package/dist/services/cloud/task-wrapper.js.map +1 -1
  122. package/dist/services/github-app.d.ts.map +1 -1
  123. package/dist/services/github-app.js +11 -2
  124. package/dist/services/github-app.js.map +1 -1
  125. package/dist/services/knowledge/audn.d.ts +37 -0
  126. package/dist/services/knowledge/audn.d.ts.map +1 -0
  127. package/dist/services/knowledge/audn.js +219 -0
  128. package/dist/services/knowledge/audn.js.map +1 -0
  129. package/dist/services/knowledge/file-hash.d.ts +11 -0
  130. package/dist/services/knowledge/file-hash.d.ts.map +1 -0
  131. package/dist/services/knowledge/file-hash.js +123 -0
  132. package/dist/services/knowledge/file-hash.js.map +1 -0
  133. package/dist/services/knowledge/http-provider.d.ts +46 -0
  134. package/dist/services/knowledge/http-provider.d.ts.map +1 -0
  135. package/dist/services/knowledge/http-provider.js +254 -0
  136. package/dist/services/knowledge/http-provider.js.map +1 -0
  137. package/dist/services/knowledge/kb-providers.d.ts +15 -0
  138. package/dist/services/knowledge/kb-providers.d.ts.map +1 -0
  139. package/dist/services/knowledge/kb-providers.js +92 -0
  140. package/dist/services/knowledge/kb-providers.js.map +1 -0
  141. package/dist/services/knowledge/kb-scope-input.d.ts +5 -0
  142. package/dist/services/knowledge/kb-scope-input.d.ts.map +1 -0
  143. package/dist/services/knowledge/kb-scope-input.js +11 -0
  144. package/dist/services/knowledge/kb-scope-input.js.map +1 -0
  145. package/dist/services/knowledge/kb-service.d.ts +3 -0
  146. package/dist/services/knowledge/kb-service.d.ts.map +1 -0
  147. package/dist/services/knowledge/kb-service.js +2 -0
  148. package/dist/services/knowledge/kb-service.js.map +1 -0
  149. package/dist/services/knowledge/path-validation.d.ts +2 -0
  150. package/dist/services/knowledge/path-validation.d.ts.map +1 -0
  151. package/dist/services/knowledge/path-validation.js +13 -0
  152. package/dist/services/knowledge/path-validation.js.map +1 -0
  153. package/dist/services/knowledge/pre-init.d.ts +14 -0
  154. package/dist/services/knowledge/pre-init.d.ts.map +1 -0
  155. package/dist/services/knowledge/pre-init.js +147 -0
  156. package/dist/services/knowledge/pre-init.js.map +1 -0
  157. package/dist/services/knowledge/project-slug.d.ts +2 -0
  158. package/dist/services/knowledge/project-slug.d.ts.map +1 -0
  159. package/dist/services/knowledge/project-slug.js +49 -0
  160. package/dist/services/knowledge/project-slug.js.map +1 -0
  161. package/dist/services/knowledge/sqlite-provider.d.ts +147 -0
  162. package/dist/services/knowledge/sqlite-provider.d.ts.map +1 -0
  163. package/dist/services/knowledge/sqlite-provider.js +1646 -0
  164. package/dist/services/knowledge/sqlite-provider.js.map +1 -0
  165. package/dist/services/knowledge/types.d.ts +163 -0
  166. package/dist/services/knowledge/types.d.ts.map +1 -0
  167. package/dist/services/knowledge/types.js +9 -0
  168. package/dist/services/knowledge/types.js.map +1 -0
  169. package/dist/services/member-home.d.ts +89 -0
  170. package/dist/services/member-home.d.ts.map +1 -0
  171. package/dist/services/member-home.js +256 -0
  172. package/dist/services/member-home.js.map +1 -0
  173. package/dist/services/member-remote-url.d.ts +34 -0
  174. package/dist/services/member-remote-url.d.ts.map +1 -0
  175. package/dist/services/member-remote-url.js +39 -0
  176. package/dist/services/member-remote-url.js.map +1 -0
  177. package/dist/services/orphan-recovery.d.ts +5 -2
  178. package/dist/services/orphan-recovery.d.ts.map +1 -1
  179. package/dist/services/orphan-recovery.js +19 -8
  180. package/dist/services/orphan-recovery.js.map +1 -1
  181. package/dist/services/preflight-check.d.ts +56 -0
  182. package/dist/services/preflight-check.d.ts.map +1 -0
  183. package/dist/services/preflight-check.js +277 -0
  184. package/dist/services/preflight-check.js.map +1 -0
  185. package/dist/services/stall/log-path-resolver.d.ts +11 -8
  186. package/dist/services/stall/log-path-resolver.d.ts.map +1 -1
  187. package/dist/services/stall/log-path-resolver.js +17 -40
  188. package/dist/services/stall/log-path-resolver.js.map +1 -1
  189. package/dist/services/stall/stall-detector.d.ts +32 -0
  190. package/dist/services/stall/stall-detector.d.ts.map +1 -1
  191. package/dist/services/stall/stall-detector.js +149 -6
  192. package/dist/services/stall/stall-detector.js.map +1 -1
  193. package/dist/services/stall/stall-poller.d.ts +34 -0
  194. package/dist/services/stall/stall-poller.d.ts.map +1 -1
  195. package/dist/services/stall/stall-poller.js +134 -2
  196. package/dist/services/stall/stall-poller.js.map +1 -1
  197. package/dist/services/strategy.d.ts.map +1 -1
  198. package/dist/services/strategy.js +2 -2
  199. package/dist/services/strategy.js.map +1 -1
  200. package/dist/services/tool-registry.d.ts.map +1 -1
  201. package/dist/services/tool-registry.js +87 -1
  202. package/dist/services/tool-registry.js.map +1 -1
  203. package/dist/services/vcs/github.d.ts.map +1 -1
  204. package/dist/services/vcs/github.js +32 -1
  205. package/dist/services/vcs/github.js.map +1 -1
  206. package/dist/services/version-check.d.ts +22 -0
  207. package/dist/services/version-check.d.ts.map +1 -0
  208. package/dist/services/version-check.js +103 -0
  209. package/dist/services/version-check.js.map +1 -0
  210. package/dist/skills/fleet-sprint-cli/SKILL.md +13 -2
  211. package/dist/skills/pm/beads.md +6 -0
  212. package/dist/skills/pm/fleet-addendum.md +6 -0
  213. package/dist/skills/pm/index.md +56 -0
  214. package/dist/skills/pm/kb-reconcile.md +132 -0
  215. package/dist/skills/pm/kb-review.md +109 -0
  216. package/dist/tools/check-status.d.ts +47 -0
  217. package/dist/tools/check-status.d.ts.map +1 -1
  218. package/dist/tools/check-status.js +242 -0
  219. package/dist/tools/check-status.js.map +1 -1
  220. package/dist/tools/child-id-allocator.d.ts +2 -2
  221. package/dist/tools/code-intelligence-codebase-memory.d.ts +11 -0
  222. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +1 -0
  223. package/dist/tools/code-intelligence-codebase-memory.js +270 -0
  224. package/dist/tools/code-intelligence-codebase-memory.js.map +1 -0
  225. package/dist/tools/code-intelligence-freshness.d.ts +2 -0
  226. package/dist/tools/code-intelligence-freshness.d.ts.map +1 -0
  227. package/dist/tools/code-intelligence-freshness.js +26 -0
  228. package/dist/tools/code-intelligence-freshness.js.map +1 -0
  229. package/dist/tools/code-intelligence-gitnexus.d.ts +14 -0
  230. package/dist/tools/code-intelligence-gitnexus.d.ts.map +1 -0
  231. package/dist/tools/code-intelligence-gitnexus.js +475 -0
  232. package/dist/tools/code-intelligence-gitnexus.js.map +1 -0
  233. package/dist/tools/code-intelligence-kb-enrich.d.ts +2 -0
  234. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +1 -0
  235. package/dist/tools/code-intelligence-kb-enrich.js +65 -0
  236. package/dist/tools/code-intelligence-kb-enrich.js.map +1 -0
  237. package/dist/tools/code-intelligence-reindex.d.ts +7 -0
  238. package/dist/tools/code-intelligence-reindex.d.ts.map +1 -0
  239. package/dist/tools/code-intelligence-reindex.js +106 -0
  240. package/dist/tools/code-intelligence-reindex.js.map +1 -0
  241. package/dist/tools/code-intelligence-telemetry.d.ts +5 -0
  242. package/dist/tools/code-intelligence-telemetry.d.ts.map +1 -0
  243. package/dist/tools/code-intelligence-telemetry.js +52 -0
  244. package/dist/tools/code-intelligence-telemetry.js.map +1 -0
  245. package/dist/tools/code-intelligence-tests.d.ts +2 -0
  246. package/dist/tools/code-intelligence-tests.d.ts.map +1 -0
  247. package/dist/tools/code-intelligence-tests.js +24 -0
  248. package/dist/tools/code-intelligence-tests.js.map +1 -0
  249. package/dist/tools/code-intelligence.d.ts +114 -0
  250. package/dist/tools/code-intelligence.d.ts.map +1 -0
  251. package/dist/tools/code-intelligence.js +124 -0
  252. package/dist/tools/code-intelligence.js.map +1 -0
  253. package/dist/tools/compose-permissions.d.ts +26 -0
  254. package/dist/tools/compose-permissions.d.ts.map +1 -1
  255. package/dist/tools/compose-permissions.js +244 -33
  256. package/dist/tools/compose-permissions.js.map +1 -1
  257. package/dist/tools/execute-command.d.ts +2 -0
  258. package/dist/tools/execute-command.d.ts.map +1 -1
  259. package/dist/tools/execute-command.js +86 -16
  260. package/dist/tools/execute-command.js.map +1 -1
  261. package/dist/tools/execute-prompt.d.ts +13 -1
  262. package/dist/tools/execute-prompt.d.ts.map +1 -1
  263. package/dist/tools/execute-prompt.js +257 -45
  264. package/dist/tools/execute-prompt.js.map +1 -1
  265. package/dist/tools/kb-capture.d.ts +53 -0
  266. package/dist/tools/kb-capture.d.ts.map +1 -0
  267. package/dist/tools/kb-capture.js +130 -0
  268. package/dist/tools/kb-capture.js.map +1 -0
  269. package/dist/tools/kb-context.d.ts +17 -0
  270. package/dist/tools/kb-context.d.ts.map +1 -0
  271. package/dist/tools/kb-context.js +29 -0
  272. package/dist/tools/kb-context.js.map +1 -0
  273. package/dist/tools/kb-export.d.ts +19 -0
  274. package/dist/tools/kb-export.d.ts.map +1 -0
  275. package/dist/tools/kb-export.js +344 -0
  276. package/dist/tools/kb-export.js.map +1 -0
  277. package/dist/tools/kb-feedback.d.ts +23 -0
  278. package/dist/tools/kb-feedback.d.ts.map +1 -0
  279. package/dist/tools/kb-feedback.js +43 -0
  280. package/dist/tools/kb-feedback.js.map +1 -0
  281. package/dist/tools/kb-freshness-sweep.d.ts +14 -0
  282. package/dist/tools/kb-freshness-sweep.d.ts.map +1 -0
  283. package/dist/tools/kb-freshness-sweep.js +29 -0
  284. package/dist/tools/kb-freshness-sweep.js.map +1 -0
  285. package/dist/tools/kb-harvest.d.ts +20 -0
  286. package/dist/tools/kb-harvest.d.ts.map +1 -0
  287. package/dist/tools/kb-harvest.js +143 -0
  288. package/dist/tools/kb-harvest.js.map +1 -0
  289. package/dist/tools/kb-import.d.ts +44 -0
  290. package/dist/tools/kb-import.d.ts.map +1 -0
  291. package/dist/tools/kb-import.js +239 -0
  292. package/dist/tools/kb-import.js.map +1 -0
  293. package/dist/tools/kb-invalidate.d.ts +19 -0
  294. package/dist/tools/kb-invalidate.d.ts.map +1 -0
  295. package/dist/tools/kb-invalidate.js +34 -0
  296. package/dist/tools/kb-invalidate.js.map +1 -0
  297. package/dist/tools/kb-list.d.ts +32 -0
  298. package/dist/tools/kb-list.d.ts.map +1 -0
  299. package/dist/tools/kb-list.js +43 -0
  300. package/dist/tools/kb-list.js.map +1 -0
  301. package/dist/tools/kb-promote.d.ts +20 -0
  302. package/dist/tools/kb-promote.d.ts.map +1 -0
  303. package/dist/tools/kb-promote.js +20 -0
  304. package/dist/tools/kb-promote.js.map +1 -0
  305. package/dist/tools/kb-query.d.ts +35 -0
  306. package/dist/tools/kb-query.d.ts.map +1 -0
  307. package/dist/tools/kb-query.js +111 -0
  308. package/dist/tools/kb-query.js.map +1 -0
  309. package/dist/tools/kb-reconcile-prefilter.d.ts +14 -0
  310. package/dist/tools/kb-reconcile-prefilter.d.ts.map +1 -0
  311. package/dist/tools/kb-reconcile-prefilter.js +26 -0
  312. package/dist/tools/kb-reconcile-prefilter.js.map +1 -0
  313. package/dist/tools/kb-resolve-contradiction.d.ts +23 -0
  314. package/dist/tools/kb-resolve-contradiction.d.ts.map +1 -0
  315. package/dist/tools/kb-resolve-contradiction.js +37 -0
  316. package/dist/tools/kb-resolve-contradiction.js.map +1 -0
  317. package/dist/tools/kb-session-prime.d.ts +26 -0
  318. package/dist/tools/kb-session-prime.d.ts.map +1 -0
  319. package/dist/tools/kb-session-prime.js +392 -0
  320. package/dist/tools/kb-session-prime.js.map +1 -0
  321. package/dist/tools/kb-setup.d.ts +20 -0
  322. package/dist/tools/kb-setup.d.ts.map +1 -0
  323. package/dist/tools/kb-setup.js +49 -0
  324. package/dist/tools/kb-setup.js.map +1 -0
  325. package/dist/tools/kb-stats.d.ts +20 -0
  326. package/dist/tools/kb-stats.d.ts.map +1 -0
  327. package/dist/tools/kb-stats.js +115 -0
  328. package/dist/tools/kb-stats.js.map +1 -0
  329. package/dist/tools/member-detail.d.ts.map +1 -1
  330. package/dist/tools/member-detail.js +8 -0
  331. package/dist/tools/member-detail.js.map +1 -1
  332. package/dist/tools/monitor-task.d.ts.map +1 -1
  333. package/dist/tools/monitor-task.js +21 -3
  334. package/dist/tools/monitor-task.js.map +1 -1
  335. package/dist/tools/provision-auth.d.ts.map +1 -1
  336. package/dist/tools/provision-auth.js +10 -3
  337. package/dist/tools/provision-auth.js.map +1 -1
  338. package/dist/tools/register-member.d.ts +3 -0
  339. package/dist/tools/register-member.d.ts.map +1 -1
  340. package/dist/tools/register-member.js +30 -1
  341. package/dist/tools/register-member.js.map +1 -1
  342. package/dist/tools/remove-member.d.ts.map +1 -1
  343. package/dist/tools/remove-member.js +17 -3
  344. package/dist/tools/remove-member.js.map +1 -1
  345. package/dist/tools/report-status.d.ts.map +1 -1
  346. package/dist/tools/report-status.js +2 -1
  347. package/dist/tools/report-status.js.map +1 -1
  348. package/dist/tools/send-email.d.ts +69 -0
  349. package/dist/tools/send-email.d.ts.map +1 -0
  350. package/dist/tools/send-email.js +177 -0
  351. package/dist/tools/send-email.js.map +1 -0
  352. package/dist/tools/setup-ssh-key.d.ts.map +1 -1
  353. package/dist/tools/setup-ssh-key.js +2 -0
  354. package/dist/tools/setup-ssh-key.js.map +1 -1
  355. package/dist/tools/update-member.d.ts +3 -0
  356. package/dist/tools/update-member.d.ts.map +1 -1
  357. package/dist/tools/update-member.js +25 -1
  358. package/dist/tools/update-member.js.map +1 -1
  359. package/dist/types.d.ts +1 -0
  360. package/dist/types.d.ts.map +1 -1
  361. package/dist/utils/prompt-errors.js +1 -1
  362. package/dist/utils/prompt-errors.js.map +1 -1
  363. package/dist/utils/session-caller.d.ts +28 -0
  364. package/dist/utils/session-caller.d.ts.map +1 -0
  365. package/dist/utils/session-caller.js +24 -0
  366. package/dist/utils/session-caller.js.map +1 -0
  367. package/dist/utils/work-folder-validation.d.ts +39 -0
  368. package/dist/utils/work-folder-validation.d.ts.map +1 -0
  369. package/dist/utils/work-folder-validation.js +60 -0
  370. package/dist/utils/work-folder-validation.js.map +1 -0
  371. package/dist/workflows/auto-sprint.js +546 -6
  372. package/package.json +7 -4
  373. package/packages/apra-fleet-client/src/client/api.mjs +118 -4
  374. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +17 -1
  375. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +13 -1
  376. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +15 -3
  377. package/packages/apra-fleet-se/apra-pm/agents/doer.md +35 -1
  378. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +22 -3
  379. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +18 -2
  380. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +216 -0
  381. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +14 -1
  382. package/packages/apra-fleet-se/apra-pm/agents/planner.md +88 -5
  383. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +19 -1
  384. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +104 -3
  385. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +63 -3
  386. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-output.json +59 -2
  387. package/packages/apra-fleet-se/apra-pm/agents/schemas/integ-test-runner-output.json +2 -2
  388. package/packages/apra-fleet-se/apra-pm/agents/schemas/kb-reconciler-output.json +87 -0
  389. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +65 -0
  390. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +105 -8
  391. package/packages/apra-fleet-se/apra-pm/skills/pm/beads.md +6 -0
  392. package/packages/apra-fleet-se/apra-pm/skills/pm/fleet-addendum.md +6 -0
  393. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +56 -0
  394. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +132 -0
  395. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +109 -0
  396. package/packages/apra-fleet-se/bin/cli.mjs +7 -0
  397. package/packages/apra-fleet-se/bin/serve.mjs +14 -2
  398. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +31 -5
  399. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +1 -1
  400. package/packages/apra-fleet-se/fleet-sprint/docs/coach-role-design.md +23 -151
  401. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-manual-recovery-verified.md +256 -0
  402. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +1482 -0
  403. package/packages/apra-fleet-se/fleet-sprint/docs/escalate-to-llm-design.md +908 -0
  404. package/packages/apra-fleet-se/fleet-sprint/docs/shared-orchestrator-reservation-design.md +399 -0
  405. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +972 -0
  406. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +167 -101
  407. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +50 -6
  408. package/packages/apra-fleet-se/fleet-sprint/runner.js +1416 -116
  409. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +13 -2
  410. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +350 -0
  411. package/packages/apra-fleet-se/fleet-sprint/sprint-progress.mjs +101 -0
  412. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +30 -17
  413. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +62 -2
  414. package/packages/apra-fleet-se/package.json +1 -0
  415. package/packages/apra-fleet-workflow/src/viewer/index.mjs +127 -13
  416. package/packages/apra-fleet-workflow/src/viewer/run-title.mjs +60 -0
  417. package/packages/apra-fleet-workflow/src/workflow/index.mjs +8 -4
  418. package/skills/fleet/knowledge-agent.md +66 -0
  419. package/skills/fleet/permissions.md +28 -4
  420. package/skills/fleet/profiles/base-dev.json +10 -1
  421. package/skills/fleet/profiles/base-reviewer.json +8 -1
  422. package/skills/fleet/profiles/tag-kb-reconciler.json +20 -0
  423. package/version.json +1 -1
  424. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-tier2-runbook.md +0 -127
  425. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-path-b.mjs +0 -339
  426. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery-tier2.mjs +0 -360
  427. package/packages/apra-fleet-se/fleet-sprint/dolt-recovery.mjs +0 -363
@@ -0,0 +1,143 @@
1
+ import { z } from 'zod';
2
+ import { getKbProviders } from '../services/knowledge/kb-providers.js';
3
+ import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
4
+ import { KbCaptureRejected } from '../services/knowledge/types.js';
5
+ 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
+ session_transcript: z.string().optional()
10
+ .describe('Full session transcript text to scan for learnings'),
11
+ session_id: z.string().optional()
12
+ .describe('Session ID for attribution'),
13
+ });
14
+ const LEARNING_PATTERNS = [
15
+ /(?:^|\n)\s*(?:I found that|Note:|Warning:|Bug:|Gotcha:|This means)\s*[:\-]?\s*(.+?)(?:\n\n|\n(?=[A-Z])|$)/gis,
16
+ /(?:^|\n)\s*(?:The (?:issue|problem|fix|solution|root cause) (?:is|was))\s*[:\-]?\s*(.+?)(?:\n\n|\n(?=[A-Z])|$)/gis,
17
+ /(?:^|\n)\s*(?:Important:|Key insight:|Lesson learned:|TIL:)\s*(.+?)(?:\n\n|\n(?=[A-Z])|$)/gis,
18
+ ];
19
+ const FILE_PATH_RE = /(?:^|\s)((?:src|lib|tests?|docs?)\/[\w./-]+\.\w+)/g;
20
+ const SYMBOL_RE = /`(\w{2,}(?:\.\w+)?(?:\(\))?)`/g;
21
+ function extractFilePaths(text) {
22
+ const matches = new Set();
23
+ let m;
24
+ const re = new RegExp(FILE_PATH_RE.source, FILE_PATH_RE.flags);
25
+ while ((m = re.exec(text)) !== null) {
26
+ matches.add(m[1]);
27
+ }
28
+ return [...matches];
29
+ }
30
+ function extractSymbols(text) {
31
+ const matches = new Set();
32
+ let m;
33
+ const re = new RegExp(SYMBOL_RE.source, SYMBOL_RE.flags);
34
+ while ((m = re.exec(text)) !== null) {
35
+ const sym = m[1].replace(/\(\)$/, '');
36
+ if (sym.length >= 2 && !/^(the|and|for|not|but|was|are|has|had|can|will|this|that|with|from)$/i.test(sym)) {
37
+ matches.add(sym);
38
+ }
39
+ }
40
+ return [...matches];
41
+ }
42
+ function extractLearnings(transcript) {
43
+ const results = [];
44
+ const seen = new Set();
45
+ for (const pattern of LEARNING_PATTERNS) {
46
+ const re = new RegExp(pattern.source, pattern.flags);
47
+ let match;
48
+ while ((match = re.exec(transcript)) !== null) {
49
+ const raw = match[1].trim();
50
+ if (raw.length < 20 || seen.has(raw))
51
+ continue;
52
+ seen.add(raw);
53
+ const title = raw.length > 80 ? raw.slice(0, 77) + '...' : raw;
54
+ const summary = raw.length > 200 ? raw.slice(0, 200) + '...' : raw;
55
+ const source_files = extractFilePaths(raw);
56
+ const symbols = extractSymbols(raw);
57
+ results.push({
58
+ title,
59
+ summary,
60
+ content: raw,
61
+ source_files,
62
+ symbols,
63
+ });
64
+ }
65
+ }
66
+ return results;
67
+ }
68
+ // T3.2 (F7, revised D7): kb_harvest is auto-dispatched fire-and-forget by
69
+ // src/tools/execute-prompt.ts after every successful execute_prompt, which
70
+ // passes the full session transcript -- the one thing the agent whose
71
+ // session just ended does not itself have reliable access to. That autowire
72
+ // is the ONLY path that produces entries; do not remove it (see
73
+ // tests/knowledge/kb-harvest-autowire.test.ts). Calling this tool manually
74
+ // with no session_transcript (the "call kb_harvest yourself at session end"
75
+ // pattern once documented in the role prompts) is a no-op -- see the early
76
+ // return below -- and that instruction has been removed from agents/doer.md,
77
+ // agents/reviewer.md, etc. (they now note kb_harvest is an automatic
78
+ // backstop, not something they need to call). This is a separate, low-trust,
79
+ // regex-extracted path from a role's own kb_capture/kb_captures flow: every
80
+ // entry captured here is forced to
81
+ // confidence='UNVERIFIED' (never CONFIRMED, covered by the D1 clamp) with
82
+ // author='harvest', source='harvest' so it is distinguishable in queries.
83
+ export async function kbHarvest(input) {
84
+ if (!input.session_transcript) {
85
+ return JSON.stringify({ entries_captured: 0, entries_updated: 0, entries_skipped: 0, entries_rejected: 0 });
86
+ }
87
+ const providers = await getKbProviders(input.repo_path, input.repo_remote_url);
88
+ const provider = providers.project;
89
+ const learnings = extractLearnings(input.session_transcript);
90
+ let entries_captured = 0;
91
+ let entries_updated = 0;
92
+ let entries_skipped = 0;
93
+ let entries_rejected = 0;
94
+ // D5 + revised D7 (T2.3): harvested entries are UNVERIFIED, regex-extracted,
95
+ // low-trust captures from the execute_prompt autowire -- distinct provenance
96
+ // from real KB-Agent captures (author='kb-agent', source='session'/'review').
97
+ const source = 'harvest';
98
+ for (const learning of learnings) {
99
+ const entryInput = {
100
+ type: 'learning',
101
+ title: learning.title,
102
+ summary: learning.summary,
103
+ content: learning.content,
104
+ source_files: learning.source_files,
105
+ symbols: learning.symbols,
106
+ tags: input.session_id ? [`session:${input.session_id}`] : [],
107
+ content_hash: '',
108
+ content_hash_type: 'sha256',
109
+ flagged_for_review: false,
110
+ author: 'harvest',
111
+ source,
112
+ confidence: 'UNVERIFIED',
113
+ };
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.
120
+ let audn_decision;
121
+ try {
122
+ ({ audn_decision } = await provider.capture(entryInput));
123
+ }
124
+ catch (err) {
125
+ if (err instanceof KbCaptureRejected) {
126
+ entries_rejected++;
127
+ continue;
128
+ }
129
+ throw err;
130
+ }
131
+ if (audn_decision === 'add' || audn_decision === 'flagged') {
132
+ entries_captured++;
133
+ }
134
+ else if (audn_decision === 'update') {
135
+ entries_updated++;
136
+ }
137
+ else {
138
+ entries_skipped++;
139
+ }
140
+ }
141
+ return JSON.stringify({ entries_captured, entries_updated, entries_skipped, entries_rejected });
142
+ }
143
+ //# sourceMappingURL=kb-harvest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-harvest.js","sourceRoot":"","sources":["../../src/tools/kb-harvest.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ import { z } from 'zod';
2
+ export declare const kbImportSchema: z.ZodObject<{
3
+ path: z.ZodOptional<z.ZodString>;
4
+ repo: z.ZodOptional<z.ZodString>;
5
+ repo_path: z.ZodOptional<z.ZodString>;
6
+ scope: z.ZodOptional<z.ZodLiteral<"project">>;
7
+ skip_sweep: z.ZodOptional<z.ZodBoolean>;
8
+ repo_remote_url: z.ZodOptional<z.ZodString>;
9
+ }, "strip", z.ZodTypeAny, {
10
+ path?: string | undefined;
11
+ scope?: "project" | undefined;
12
+ repo_path?: string | undefined;
13
+ repo_remote_url?: string | undefined;
14
+ repo?: string | undefined;
15
+ skip_sweep?: boolean | undefined;
16
+ }, {
17
+ path?: string | undefined;
18
+ scope?: "project" | undefined;
19
+ repo_path?: string | undefined;
20
+ repo_remote_url?: string | undefined;
21
+ repo?: string | undefined;
22
+ skip_sweep?: boolean | undefined;
23
+ }>;
24
+ export type KbImportInput = z.infer<typeof kbImportSchema>;
25
+ export interface KbImportReport {
26
+ imported: number;
27
+ skipped: number;
28
+ linked: number;
29
+ flagged: number;
30
+ /**
31
+ * Bible entries refused by the Phase 1 capture basis check -- no source_files,
32
+ * or source_files absent from this worktree. Import is NOT exempt: an
33
+ * unfalsifiable entry must not enter through any path, including a legacy
34
+ * bible, so re-importing an old bible deliberately drops those entries.
35
+ */
36
+ rejected: number;
37
+ sweep: {
38
+ checked: number;
39
+ staled: number;
40
+ unstaled: number;
41
+ };
42
+ }
43
+ export declare function kbImport(input: KbImportInput): Promise<string>;
44
+ //# sourceMappingURL=kb-import.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-import.d.ts","sourceRoot":"","sources":["../../src/tools/kb-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EA4BzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAuD3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAwIpE"}
@@ -0,0 +1,239 @@
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
+ import { KbCaptureRejected } from '../services/knowledge/types.js';
7
+ // T2.1 (F4, D3 HARDENED): kb_import -- the trusted-channel write path that lets a
8
+ // warm local KB absorb a merged-in bible (.fleet/kb-canonical.json). The
9
+ // cold-seed in kb_session_prime is OUTPUT-ONLY and fires only under
10
+ // COLD_KB_MAX=3; it never writes the DB. This tool is that missing write path.
11
+ //
12
+ // Each bible entry routes through provider.capture() (the AUDN choke point) so
13
+ // dedupe/supersede/flag semantics apply, with an INTERNAL import mode (a second,
14
+ // non-deserializable capture() parameter -- R4) that (a) preserves the entry's
15
+ // bible confidence for NON-directive types (the SOLE clamp exemption -- the
16
+ // bible is a git-reviewed, human-merged artifact), stamping source='import';
17
+ // (b) forces type='user-directive' entries through the existing directive gate
18
+ // so they land as pending proposals, never active -- a bible cannot smuggle an
19
+ // active directive; and (c) suppresses provenance normalization so the tool's
20
+ // source='import' survives. After the loop it runs freshnessSweep() so imported
21
+ // entries whose basis does not match THIS worktree are staled immediately.
22
+ //
23
+ // TRUST BOUNDARY (LOW-1, honest statement): kb_import reads a caller-named local
24
+ // file. A local caller with tool access could hand-craft a bible and import it.
25
+ // This is equivalent in power to the already-MCP-exposed kb_promote surface
26
+ // (which walks any entry INFERRED->CONFIRMED one call at a time), so
27
+ // import-from-path adds bulk convenience, not a new privilege class. The
28
+ // "git-reviewed artifact" rationale only holds for the repo-resolved
29
+ // .fleet/kb-canonical.json; an explicit --path bible is CALLER-ASSERTED trust.
30
+ // The unforgeable tier remains user-directives, which are CLI-gated -- the
31
+ // directive gate quarantines them either way.
32
+ export const kbImportSchema = z.object({
33
+ ...kbScopeFields,
34
+ path: z.string().optional()
35
+ .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.'),
36
+ repo: z.string().optional()
37
+ .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.'),
38
+ // KB audit 2026-08-11: the apra-fleet-src trap again. Every other kb_* tool
39
+ // names this input `repo_path`; kb_import alone took `repo`, and zod strips
40
+ // unknown keys silently -- so calling it the way every sibling is called did
41
+ // not error, it resolved against the SERVER's cwd and imported an unrelated
42
+ // repo's bible. Invisible, because it still reports a successful import. The
43
+ // sprint engine calls this per member, which is precisely the repo-blindness
44
+ // class per-member path resolution exists to prevent.
45
+ repo_path: z.string().optional()
46
+ .describe('Alias for `repo`, matching the input name used by every other kb_* tool. Ignored when `repo` is also supplied.'),
47
+ scope: z.literal('project').optional()
48
+ .describe('Only project scope is supported (imports into the project KB). Global bibles are a separate concern.'),
49
+ // KB audit 2026-08-12, found by a LIVE sprint rather than by review. The
50
+ // sprint engine imports the bible per member at sprint start; the sweep that
51
+ // follows re-judged the WHOLE KB against that worktree and staled 16 of 17
52
+ // CONFIRMED entries, purely because the repo had moved on since capture.
53
+ // Three observed consequences in one run: retrieval degraded to a single
54
+ // matchable entry, kb_export tried to write 9 over a 17-entry bible, and
55
+ // kb_list (which filters stale=0) handed the reviewer an EMPTY promotion
56
+ // candidate list -- reintroducing apra-fleet-0ef, "kb_promote can never
57
+ // fire", by a side door. Opt-out, defaulting to today's behaviour.
58
+ skip_sweep: z.boolean().optional()
59
+ .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).'),
60
+ });
61
+ // F4 (D3, KB d5193cb9): repo path resolution precedence, mirroring kb-export --
62
+ // (1) explicit repo, validated (must exist and be a directory) or refuse; (2)
63
+ // validated process working directory when repo is omitted (same check, not a
64
+ // blind default); (3) neither validates -> throw. kb_import is an explicit
65
+ // command, so it throws like kb_export rather than silently skipping.
66
+ function resolveRepoPath(explicit) {
67
+ const candidate = explicit || process.cwd();
68
+ if (!fs.existsSync(candidate) || !fs.statSync(candidate).isDirectory()) {
69
+ throw new Error('kb_import: repo does not exist or is not a directory: ' + candidate);
70
+ }
71
+ return candidate;
72
+ }
73
+ const VALID_TYPES = ['context-cache', 'learning', 'knowledge', 'runbook', 'user-directive'];
74
+ const VALID_CONFIDENCE = ['CONFIRMED', 'INFERRED', 'UNVERIFIED'];
75
+ // Validate a single parsed bible entry against the exported CanonicalEntry field
76
+ // set {id, type, title, summary, symbols, source_files, confidence, updated_at}
77
+ // (KB b9df569a -- NOTE: no content field). Malformed entries are tolerated and
78
+ // skipped individually rather than aborting the whole import.
79
+ function isValidBibleEntry(e) {
80
+ if (!e || typeof e !== 'object')
81
+ return false;
82
+ const r = e;
83
+ if (typeof r.id !== 'string' || r.id.length === 0)
84
+ return false;
85
+ if (typeof r.type !== 'string' || !VALID_TYPES.includes(r.type))
86
+ return false;
87
+ if (typeof r.title !== 'string' || r.title.length === 0)
88
+ return false;
89
+ if (typeof r.summary !== 'string' || r.summary.length === 0)
90
+ return false;
91
+ if (typeof r.confidence !== 'string' || !VALID_CONFIDENCE.includes(r.confidence))
92
+ return false;
93
+ if (r.symbols !== undefined && !Array.isArray(r.symbols))
94
+ return false;
95
+ if (r.source_files !== undefined && !Array.isArray(r.source_files))
96
+ return false;
97
+ return true;
98
+ }
99
+ // LOW-2: bible entries carry no content field, so synthesize content
100
+ // DETERMINISTICALLY from the summary. Determinism matters twice: (1) a re-import
101
+ // of the same bible produces byte-identical content so AUDN's content-equality
102
+ // 'none' path can dedupe an id-collision-with-identical-content case; (2) it
103
+ // keeps import a pure function of the bible file.
104
+ function synthesizeContent(entry) {
105
+ return entry.summary;
106
+ }
107
+ export async function kbImport(input) {
108
+ // `repo` wins over the `repo_path` alias so existing callers are unaffected.
109
+ const repoAnchor = resolveRepoPath(input.repo ?? input.repo_path);
110
+ const biblePath = input.path ?? path.join(repoAnchor, '.fleet', 'kb-canonical.json');
111
+ // Validate the file resolves and parses to the bible array shape BEFORE
112
+ // importing anything (reject otherwise -- non-zero exit at the CLI).
113
+ if (!fs.existsSync(biblePath)) {
114
+ throw new Error('kb_import: bible file not found: ' + biblePath);
115
+ }
116
+ const raw = fs.readFileSync(biblePath, 'utf-8');
117
+ let parsed;
118
+ try {
119
+ parsed = JSON.parse(raw);
120
+ }
121
+ catch {
122
+ throw new Error('kb_import: bible file is not valid JSON: ' + biblePath);
123
+ }
124
+ // KB-TRUST PHASE 3a: the bible has TWO on-disk shapes and must accept both.
125
+ //
126
+ // v1 (legacy): a bare JSON array of entries.
127
+ // v2: { version, provenance: {commit, branch, entry_count}, entries }
128
+ //
129
+ // Selection is on Array.isArray, exactly as the design specifies. This import
130
+ // side ships BEFORE the export side starts writing v2 -- a v2 bible fed to an
131
+ // older apra-fleet throws the not-a-JSON-array error below, which is expected
132
+ // and acceptable, but it means the reader must never lag the writer.
133
+ const bibleEntries = Array.isArray(parsed)
134
+ ? parsed
135
+ : (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries))
136
+ ? parsed.entries
137
+ : null;
138
+ if (bibleEntries === null) {
139
+ throw new Error('kb_import: bible file is not a JSON array of entries: ' + biblePath);
140
+ }
141
+ // repoAnchor (resolved above) selects the KB, so an import 'for' repo B can
142
+ // never land in whichever repo the server process happens to sit in.
143
+ const providers = await getKbProviders(repoAnchor, input.repo_remote_url);
144
+ const provider = providers.project;
145
+ let imported = 0;
146
+ let skipped = 0;
147
+ let linked = 0;
148
+ let flagged = 0;
149
+ let rejected = 0;
150
+ for (const candidate of bibleEntries) {
151
+ // Malformed entry -> tolerate and skip individually.
152
+ if (!isValidBibleEntry(candidate)) {
153
+ skipped++;
154
+ continue;
155
+ }
156
+ const entry = candidate;
157
+ // ORDER OF OPERATIONS (LOW-2): id-exists check FIRST, before capture()/AUDN.
158
+ // This is what makes re-import EXACT even for symbol-less/file-less entries
159
+ // AUDN can never dedupe.
160
+ if (provider.hasEntry(entry.id)) {
161
+ skipped++;
162
+ continue;
163
+ }
164
+ const kbInput = {
165
+ type: entry.type,
166
+ title: entry.title,
167
+ summary: entry.summary,
168
+ content: synthesizeContent(entry),
169
+ source_files: entry.source_files ?? [],
170
+ symbols: entry.symbols ?? [],
171
+ tags: [],
172
+ content_hash: '',
173
+ content_hash_type: 'sha256',
174
+ flagged_for_review: false,
175
+ // Bible entries carry no author; the trusted channel is the provenance.
176
+ author: 'unknown',
177
+ source: 'import',
178
+ confidence: entry.confidence,
179
+ scope: 'project',
180
+ };
181
+ // Route through the AUDN choke point with the INTERNAL import mode and the
182
+ // preserved bible id. A user-directive is still forced through the directive
183
+ // gate (pending proposal) INSIDE capture() -- import mode does not bypass it.
184
+ // KB-TRUST PHASE 1: isolate each entry so one unfalsifiable bible entry is
185
+ // counted and the import continues, rather than aborting every entry after
186
+ // it. Import mode exempts the confidence clamp, never the basis check.
187
+ let audn_decision;
188
+ try {
189
+ ({ audn_decision } = await provider.capture(kbInput, {
190
+ importMode: true,
191
+ preferredId: entry.id,
192
+ }));
193
+ }
194
+ catch (err) {
195
+ if (err instanceof KbCaptureRejected) {
196
+ rejected++;
197
+ continue;
198
+ }
199
+ throw err;
200
+ }
201
+ if (audn_decision === 'add')
202
+ imported++;
203
+ else if (audn_decision === 'none')
204
+ skipped++;
205
+ // AUDN 'update' means the entry was linked to a same-topic predecessor and
206
+ // BOTH stay live -- supersede is opt-in (input.supersedes) and kb_import
207
+ // never sets it, because a bible authored on another branch cannot name a
208
+ // local entry's id. Counting these as "superseded" reported a retirement
209
+ // that never happened.
210
+ else if (audn_decision === 'update')
211
+ linked++;
212
+ else if (audn_decision === 'flagged')
213
+ flagged++;
214
+ }
215
+ // After the entry loop, run freshnessSweep() (T1.3) so imported entries whose
216
+ // basis does not match THIS worktree stale immediately rather than serving
217
+ // wrong-branch claims (D3).
218
+ //
219
+ // T3.1 (D4 fold-in, Phase 2 review MEDIUM yashr-d8b) sweep anchoring:
220
+ // freshnessSweep() re-hashes each entry's stored basis via
221
+ // computeFileHashBatch, which resolves RELATIVE paths against an explicit
222
+ // root when given. A bible imported into THIS worktree carries repo-relative
223
+ // basis paths, so the sweep anchors at the resolved repo -- previously via a
224
+ // global process.chdir(repoAnchor)/process.chdir(prevCwd) pair straddling
225
+ // the await (a process-wide mutation any other concurrent async work in this
226
+ // process would also observe); now via freshnessSweep's own `root` parameter,
227
+ // which threads the anchor straight into computeFileHashBatch's { cwd }
228
+ // option with no global side effect at all. Behavior is unchanged (absolute
229
+ // basis paths remain cwd-independent either way).
230
+ // skip_sweep (audit 2026-08-12): report the same shape with zeroes rather
231
+ // than omitting the field, so every existing caller reading report.sweep
232
+ // keeps working.
233
+ const sweep = input.skip_sweep
234
+ ? { checked: 0, staled: 0, unstaled: 0 }
235
+ : await provider.freshnessSweep(repoAnchor);
236
+ const report = { imported, skipped, linked, flagged, rejected, sweep };
237
+ return JSON.stringify(report);
238
+ }
239
+ //# sourceMappingURL=kb-import.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-import.js","sourceRoot":"","sources":["../../src/tools/kb-import.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import { z } from 'zod';
2
+ 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>;
6
+ }, "strip", z.ZodTypeAny, {
7
+ files: string[];
8
+ repo_path?: string | undefined;
9
+ repo_remote_url?: string | undefined;
10
+ }, {
11
+ files: string[];
12
+ repo_path?: string | undefined;
13
+ repo_remote_url?: string | undefined;
14
+ }>;
15
+ export type KbInvalidateInput = z.infer<typeof kbInvalidateSchema>;
16
+ 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>;
19
+ //# sourceMappingURL=kb-invalidate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-invalidate.d.ts","sourceRoot":"","sources":["../../src/tools/kb-invalidate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,eAAO,MAAM,mBAAmB,gSAM/B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAO9D;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5E"}
@@ -0,0 +1,34 @@
1
+ import { z } from 'zod';
2
+ import path from 'node:path';
3
+ import fs from 'node:fs';
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
+ export const kbInvalidateSchema = z.object({
8
+ ...kbScopeFields,
9
+ repo_path: z.string().optional()
10
+ .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.'),
11
+ files: z.array(z.string()).min(1).describe('File paths to invalidate (context-cache entries for these files will be marked stale)'),
12
+ });
13
+ export const KB_POST_COMMIT_HOOK = `#!/bin/sh
14
+ # apra-fleet KB invalidation hook
15
+ # Marks context-cache entries stale for files changed in the last commit
16
+ git diff-tree --no-commit-id -r --name-only HEAD | while IFS= read -r f; do
17
+ [ -n "$f" ] && node dist/index.js kb invalidate "$f" 2>/dev/null || true
18
+ done
19
+ `;
20
+ export function installKbPostCommitHook(repoPath) {
21
+ const hookDir = path.join(repoPath, '.git', 'hooks');
22
+ if (!fs.existsSync(hookDir)) {
23
+ fs.mkdirSync(hookDir, { recursive: true });
24
+ }
25
+ const hookPath = path.join(hookDir, 'post-commit');
26
+ fs.writeFileSync(hookPath, KB_POST_COMMIT_HOOK, { mode: 0o755 });
27
+ }
28
+ export async function kbInvalidate(input) {
29
+ validateFilePaths(input.files);
30
+ const providers = await getKbProviders(input.repo_path, input.repo_remote_url);
31
+ const { invalidated } = await providers.project.invalidate(input.files);
32
+ return JSON.stringify({ invalidated, files: input.files });
33
+ }
34
+ //# sourceMappingURL=kb-invalidate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-invalidate.js","sourceRoot":"","sources":["../../src/tools/kb-invalidate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,GAAG,aAAa;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,QAAQ,CAAC,8OAA8O,CAAC;IAC3P,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uFAAuF,CAAC;CACpI,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;CAMlC,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACnD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE/B,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/E,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;AAC7D,CAAC"}
@@ -0,0 +1,32 @@
1
+ import { z } from 'zod';
2
+ export declare const kbListSchema: z.ZodObject<{
3
+ repo_path: z.ZodOptional<z.ZodString>;
4
+ confidence: z.ZodOptional<z.ZodEnum<["CONFIRMED", "INFERRED", "UNVERIFIED"]>>;
5
+ type: z.ZodOptional<z.ZodEnum<["context-cache", "learning", "knowledge", "runbook", "user-directive"]>>;
6
+ module: z.ZodOptional<z.ZodString>;
7
+ symbol: z.ZodOptional<z.ZodString>;
8
+ tag: z.ZodOptional<z.ZodString>;
9
+ limit: z.ZodOptional<z.ZodNumber>;
10
+ repo_remote_url: z.ZodOptional<z.ZodString>;
11
+ }, "strip", z.ZodTypeAny, {
12
+ symbol?: string | undefined;
13
+ tag?: string | undefined;
14
+ type?: "knowledge" | "context-cache" | "learning" | "runbook" | "user-directive" | undefined;
15
+ module?: string | undefined;
16
+ confidence?: "CONFIRMED" | "INFERRED" | "UNVERIFIED" | undefined;
17
+ limit?: number | undefined;
18
+ repo_path?: string | undefined;
19
+ repo_remote_url?: string | undefined;
20
+ }, {
21
+ symbol?: string | undefined;
22
+ tag?: string | undefined;
23
+ type?: "knowledge" | "context-cache" | "learning" | "runbook" | "user-directive" | undefined;
24
+ module?: string | undefined;
25
+ confidence?: "CONFIRMED" | "INFERRED" | "UNVERIFIED" | undefined;
26
+ limit?: number | undefined;
27
+ repo_path?: string | undefined;
28
+ repo_remote_url?: string | undefined;
29
+ }>;
30
+ export type KbListInput = z.infer<typeof kbListSchema>;
31
+ export declare function kbList(input: KbListInput): Promise<string>;
32
+ //# sourceMappingURL=kb-list.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-list.d.ts","sourceRoot":"","sources":["../../src/tools/kb-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYvB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBhE"}
@@ -0,0 +1,43 @@
1
+ import { z } from 'zod';
2
+ import { getKbProviders } from '../services/knowledge/kb-providers.js';
3
+ import { kbScopeFields } from '../services/knowledge/kb-scope-input.js';
4
+ // T3.3 (F8a, D8): kb_list -- a read-only audit view over the CONFIRMED (or any
5
+ // filtered) set. Distinct from kb_query: no FTS, no L2 expansion, and
6
+ // (CHOICE, see SqliteProvider.list) it does NOT bump use_count/last_accessed,
7
+ // since inspecting the KB's trust tiers is not "retrieval" for the purposes
8
+ // of that telemetry.
9
+ export const kbListSchema = z.object({
10
+ ...kbScopeFields,
11
+ repo_path: z.string().optional()
12
+ .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.'),
13
+ confidence: z.enum(['CONFIRMED', 'INFERRED', 'UNVERIFIED']).optional()
14
+ .describe('Filter by confidence tier'),
15
+ type: z.enum(['context-cache', 'learning', 'knowledge', 'runbook', 'user-directive']).optional()
16
+ .describe('Filter by content type'),
17
+ module: z.string().optional().describe('Filter by exact module name'),
18
+ symbol: z.string().optional().describe('Filter to entries whose symbols array contains this value'),
19
+ tag: z.string().optional().describe('Filter to entries whose tags array contains this value (exact match)'),
20
+ limit: z.number().optional().describe('Max entries to return (default: no limit)'),
21
+ });
22
+ export async function kbList(input) {
23
+ const providers = await getKbProviders(input.repo_path, input.repo_remote_url);
24
+ const entries = await providers.project.list({
25
+ confidence: input.confidence,
26
+ type: input.type,
27
+ module: input.module,
28
+ symbol: input.symbol,
29
+ tag: input.tag,
30
+ limit: input.limit,
31
+ });
32
+ const results = entries.map(e => ({
33
+ id: e.id,
34
+ type: e.type,
35
+ confidence: e.confidence,
36
+ title: e.title,
37
+ summary: e.summary,
38
+ symbols: e.symbols,
39
+ source_files: e.source_files,
40
+ }));
41
+ return JSON.stringify({ results, total: results.length });
42
+ }
43
+ //# sourceMappingURL=kb-list.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-list.js","sourceRoot":"","sources":["../../src/tools/kb-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,+EAA+E;AAC/E,sEAAsE;AACtE,8EAA8E;AAC9E,4EAA4E;AAC5E,qBAAqB;AACrB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,aAAa;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,QAAQ,CAAC,8OAA8O,CAAC;IAC3P,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;SACnE,QAAQ,CAAC,2BAA2B,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC7F,QAAQ,CAAC,wBAAwB,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IACnG,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;IAC3G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACnF,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAkB;IAC7C,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAE/E,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3C,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChC,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,YAAY,EAAE,CAAC,CAAC,YAAY;KAC7B,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5D,CAAC"}
@@ -0,0 +1,20 @@
1
+ import { z } from 'zod';
2
+ export declare const kbPromoteSchema: z.ZodObject<{
3
+ repo_path: z.ZodOptional<z.ZodString>;
4
+ id: z.ZodString;
5
+ reason: z.ZodOptional<z.ZodString>;
6
+ repo_remote_url: z.ZodOptional<z.ZodString>;
7
+ }, "strip", z.ZodTypeAny, {
8
+ id: string;
9
+ reason?: string | undefined;
10
+ repo_path?: string | undefined;
11
+ repo_remote_url?: string | undefined;
12
+ }, {
13
+ id: string;
14
+ reason?: string | undefined;
15
+ repo_path?: string | undefined;
16
+ repo_remote_url?: string | undefined;
17
+ }>;
18
+ export type KbPromoteInput = z.infer<typeof kbPromoteSchema>;
19
+ export declare function kbPromote(input: KbPromoteInput): Promise<string>;
20
+ //# sourceMappingURL=kb-promote.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-promote.d.ts","sourceRoot":"","sources":["../../src/tools/kb-promote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAM1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAStE"}