@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,123 @@
1
+ import { execFile } from 'node:child_process';
2
+ import { createHash } from 'node:crypto';
3
+ import fs from 'node:fs';
4
+ import path from 'node:path';
5
+ // T3.1 (D4 fold-in, Phase 2 review MEDIUM yashr-d8b): computeFileHashBatch
6
+ // gains an optional { cwd } anchor so a caller resolving a bible/basis against
7
+ // a DIFFERENT repo root (e.g. kb_import's --repo) never needs to mutate the
8
+ // process-wide working directory (process.chdir) to get relative paths to
9
+ // resolve correctly. When cwd is given, every relative path is resolved
10
+ // against it for existence/read/git-hash purposes; the RETURNED map is still
11
+ // keyed by the ORIGINAL (unresolved) path strings, matching every existing
12
+ // caller's basis-map key expectations. Absolute paths are unaffected (already
13
+ // cwd-independent). Omitting cwd preserves the exact previous behavior
14
+ // (implicit process.cwd() resolution via fs/execFile defaults).
15
+ function execFileAsync(cmd, args, opts) {
16
+ return new Promise((resolve, reject) => {
17
+ execFile(cmd, args, opts ?? {}, (err, stdout, stderr) => {
18
+ if (err)
19
+ reject(err);
20
+ else
21
+ resolve({ stdout: stdout.toString(), stderr: stderr.toString() });
22
+ });
23
+ });
24
+ }
25
+ function sha256File(filePath) {
26
+ const data = fs.readFileSync(filePath);
27
+ return createHash('sha256').update(data).digest('hex');
28
+ }
29
+ export async function computeFileHash(filePath) {
30
+ if (!fs.existsSync(filePath))
31
+ return null;
32
+ try {
33
+ const { stdout } = await execFileAsync('git', ['hash-object', filePath]);
34
+ const hash = stdout.trim();
35
+ if (hash.length > 0) {
36
+ return { hash, type: 'git' };
37
+ }
38
+ }
39
+ catch {
40
+ // fall through to sha256
41
+ }
42
+ const hash = sha256File(filePath);
43
+ return { hash, type: 'sha256' };
44
+ }
45
+ export async function computeFileHashBatch(filePaths, opts) {
46
+ const result = {};
47
+ if (filePaths.length === 0)
48
+ return result;
49
+ const root = opts?.cwd;
50
+ // Resolve a possibly-relative basis path against the explicit root WITHOUT
51
+ // touching process.cwd(). Absolute paths pass through unchanged.
52
+ const resolvePath = (p) => root && !path.isAbsolute(p) ? path.join(root, p) : p;
53
+ const existing = filePaths.filter(p => fs.existsSync(resolvePath(p)));
54
+ const missing = filePaths.filter(p => !fs.existsSync(resolvePath(p)));
55
+ for (const p of missing) {
56
+ result[p] = null;
57
+ }
58
+ if (existing.length === 0)
59
+ return result;
60
+ let gitSucceeded = false;
61
+ try {
62
+ const { stdout } = await execFileAsync('git', ['hash-object', ...existing.map(resolvePath)], root ? { cwd: root } : undefined);
63
+ const lines = stdout.trim().split('\n');
64
+ if (lines.length === existing.length) {
65
+ for (let i = 0; i < existing.length; i++) {
66
+ const hash = lines[i].trim();
67
+ if (hash.length > 0) {
68
+ result[existing[i]] = { hash, type: 'git' };
69
+ }
70
+ else {
71
+ result[existing[i]] = { hash: sha256File(resolvePath(existing[i])), type: 'sha256' };
72
+ }
73
+ }
74
+ gitSucceeded = true;
75
+ }
76
+ }
77
+ catch {
78
+ // fall through to per-file sha256
79
+ }
80
+ if (!gitSucceeded) {
81
+ for (const p of existing) {
82
+ if (!result[p]) {
83
+ result[p] = { hash: sha256File(resolvePath(p)), type: 'sha256' };
84
+ }
85
+ }
86
+ }
87
+ return result;
88
+ }
89
+ export async function checkStaleness(entry) {
90
+ if (entry.type !== 'context-cache')
91
+ return { stale: false };
92
+ if (entry.content_hash === 'invalidated') {
93
+ return { stale: true, reason: 'invalidated' };
94
+ }
95
+ const sourceFile = entry.source_files[0];
96
+ if (!sourceFile)
97
+ return { stale: false };
98
+ if (!fs.existsSync(sourceFile)) {
99
+ return { stale: true, reason: 'file_missing' };
100
+ }
101
+ try {
102
+ let currentHash;
103
+ if (entry.content_hash_type === 'git') {
104
+ const result = await computeFileHash(sourceFile);
105
+ if (!result)
106
+ return { stale: true, reason: 'file_missing' };
107
+ currentHash = result.hash;
108
+ }
109
+ else {
110
+ currentHash = sha256File(sourceFile);
111
+ }
112
+ const stale = currentHash !== entry.content_hash;
113
+ return { stale, currentHash };
114
+ }
115
+ catch (err) {
116
+ const code = err.code;
117
+ if (code === 'EACCES' || code === 'EPERM') {
118
+ return { stale: true, reason: 'unreadable' };
119
+ }
120
+ throw err;
121
+ }
122
+ }
123
+ //# sourceMappingURL=file-hash.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-hash.js","sourceRoot":"","sources":["../../../src/services/knowledge/file-hash.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,46 @@
1
+ import { SqliteProvider } from './sqlite-provider.js';
2
+ import type { MemoryProvider, KBEntry, KBEntryInput, QueryOptions, KBResult, FileContextResult, PrimeOptions, PrimedContext, SyncOptions, SyncResult, AudnDecision, Confidence, ProviderStats } from './types.js';
3
+ type QueuedOperation = {
4
+ op: 'capture';
5
+ input: KBEntryInput;
6
+ } | {
7
+ op: 'invalidate';
8
+ files: string[];
9
+ };
10
+ export declare class HttpKbProvider implements MemoryProvider {
11
+ private baseUrl;
12
+ private readonly token;
13
+ private readonly fallback;
14
+ readonly offlineQueue: QueuedOperation[];
15
+ private readonly beforeExitHandler;
16
+ constructor(url: string, token: string, fallback?: SqliteProvider);
17
+ dispose(): void;
18
+ private enqueue;
19
+ private rawRequest;
20
+ private tryFlushQueue;
21
+ init(): Promise<void>;
22
+ capture(input: KBEntryInput): Promise<{
23
+ id: string;
24
+ audn_decision: AudnDecision;
25
+ }>;
26
+ query(opts: QueryOptions): Promise<KBResult>;
27
+ context(files: string[]): Promise<FileContextResult[]>;
28
+ invalidate(files: string[]): Promise<{
29
+ invalidated: number;
30
+ }>;
31
+ getLinked(id: string): Promise<KBEntry[]>;
32
+ touch(ids: string[]): Promise<number>;
33
+ relatedClaims(ids: string[], limit?: number): Promise<KBEntry[]>;
34
+ prime(opts: PrimeOptions): Promise<PrimedContext>;
35
+ promote(id: string, reason?: string): Promise<{
36
+ id: string;
37
+ confidence_before: Confidence;
38
+ confidence_after: Confidence;
39
+ }>;
40
+ sync(_opts?: SyncOptions): Promise<SyncResult>;
41
+ stats(_opts?: {
42
+ symbols?: string[];
43
+ }): Promise<ProviderStats>;
44
+ }
45
+ export {};
46
+ //# sourceMappingURL=http-provider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-provider.d.ts","sourceRoot":"","sources":["../../../src/services/knowledge/http-provider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACd,MAAM,YAAY,CAAC;AAKpB,KAAK,eAAe,GAChB;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAgB1C,qBAAa,cAAe,YAAW,cAAc;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE,CAAM;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;gBAEnC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc;IAgBjE,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,UAAU;YAkEJ,aAAa;IAmBrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,YAAY,CAAA;KAAE,CAAC;IAelF,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoB5C,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAetD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAe7D,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAOzC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAWrC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQhE,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAYjD,OAAO,CACX,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,UAAU,CAAC;QAAC,gBAAgB,EAAE,UAAU,CAAA;KAAE,CAAC;IAIjF,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ9C,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAgBpE"}
@@ -0,0 +1,254 @@
1
+ import http from 'node:http';
2
+ import https from 'node:https';
3
+ import { randomBytes } from 'node:crypto';
4
+ import { SqliteProvider } from './sqlite-provider.js';
5
+ const MAX_QUEUE_SIZE = 1000;
6
+ const REQUEST_TIMEOUT_MS = 5000;
7
+ function isConnectionError(err) {
8
+ if (!(err instanceof Error))
9
+ return false;
10
+ const code = err.code;
11
+ return (code === 'ECONNREFUSED' ||
12
+ code === 'ENOTFOUND' ||
13
+ code === 'ETIMEDOUT' ||
14
+ code === 'ECONNRESET' ||
15
+ err.message.includes('ECONNREFUSED') ||
16
+ err.message.includes('ETIMEDOUT') ||
17
+ err.message.includes('socket hang up'));
18
+ }
19
+ export class HttpKbProvider {
20
+ baseUrl;
21
+ token;
22
+ fallback;
23
+ offlineQueue = [];
24
+ beforeExitHandler;
25
+ constructor(url, token, fallback) {
26
+ this.baseUrl = url.replace(/\/$/, '');
27
+ this.token = token;
28
+ this.fallback = fallback ?? new SqliteProvider();
29
+ this.beforeExitHandler = () => {
30
+ if (this.offlineQueue.length > 0) {
31
+ process.stderr.write(`[KB] WARNING: offline queue has ${this.offlineQueue.length} unsaved captures. ` +
32
+ `Reconnect to the KB server and run kb_harvest to recover from the session transcript.\n`);
33
+ }
34
+ };
35
+ process.on('beforeExit', this.beforeExitHandler);
36
+ }
37
+ dispose() {
38
+ process.removeListener('beforeExit', this.beforeExitHandler);
39
+ }
40
+ enqueue(op) {
41
+ if (this.offlineQueue.length >= MAX_QUEUE_SIZE) {
42
+ this.offlineQueue.shift();
43
+ process.stderr.write('[KB] WARNING: offline queue full (1000), dropping oldest entry\n');
44
+ }
45
+ this.offlineQueue.push(op);
46
+ }
47
+ rawRequest(method, pathname, body, queryParams) {
48
+ return new Promise((resolve, reject) => {
49
+ const parsedUrl = new URL(this.baseUrl);
50
+ let reqPath = parsedUrl.pathname.replace(/\/$/, '') + pathname;
51
+ if (queryParams && Object.keys(queryParams).length > 0) {
52
+ reqPath += '?' + new URLSearchParams(queryParams).toString();
53
+ }
54
+ const bodyStr = body !== undefined ? JSON.stringify(body) : undefined;
55
+ const headers = {
56
+ 'Content-Type': 'application/json',
57
+ 'Authorization': `Bearer ${this.token}`,
58
+ };
59
+ if (bodyStr)
60
+ headers['Content-Length'] = Buffer.byteLength(bodyStr).toString();
61
+ const options = {
62
+ hostname: parsedUrl.hostname,
63
+ port: parsedUrl.port
64
+ ? parseInt(parsedUrl.port, 10)
65
+ : parsedUrl.protocol === 'https:' ? 443 : 80,
66
+ path: reqPath,
67
+ method,
68
+ headers,
69
+ };
70
+ const transport = parsedUrl.protocol === 'https:' ? https : http;
71
+ const req = transport.request(options, (res) => {
72
+ let data = '';
73
+ res.on('data', (chunk) => { data += chunk.toString(); });
74
+ res.on('end', () => {
75
+ try {
76
+ const parsed = JSON.parse(data);
77
+ if (res.statusCode !== undefined && res.statusCode >= 400) {
78
+ const httpErr = new Error(`HTTP ${res.statusCode}: ${parsed.error ?? data}`);
79
+ httpErr.code = `HTTP_${res.statusCode}`;
80
+ reject(httpErr);
81
+ }
82
+ else {
83
+ resolve(parsed);
84
+ }
85
+ }
86
+ catch {
87
+ reject(new Error(`Invalid JSON response from KB server`));
88
+ }
89
+ });
90
+ res.on('error', reject);
91
+ });
92
+ req.setTimeout(REQUEST_TIMEOUT_MS, () => {
93
+ const err = new Error('ETIMEDOUT: KB server request timed out');
94
+ err.code = 'ETIMEDOUT';
95
+ req.destroy(err);
96
+ });
97
+ req.on('error', reject);
98
+ if (bodyStr)
99
+ req.write(bodyStr);
100
+ req.end();
101
+ });
102
+ }
103
+ async tryFlushQueue() {
104
+ while (this.offlineQueue.length > 0) {
105
+ const op = this.offlineQueue[0];
106
+ try {
107
+ if (op.op === 'capture') {
108
+ await this.rawRequest('POST', '/api/kb/capture', op.input);
109
+ }
110
+ else if (op.op === 'invalidate') {
111
+ await this.rawRequest('POST', '/api/kb/invalidate', { files: op.files });
112
+ }
113
+ this.offlineQueue.shift();
114
+ }
115
+ catch (err) {
116
+ if (isConnectionError(err)) {
117
+ break;
118
+ }
119
+ this.offlineQueue.shift();
120
+ }
121
+ }
122
+ }
123
+ async init() {
124
+ await this.fallback.init();
125
+ }
126
+ async capture(input) {
127
+ await this.tryFlushQueue();
128
+ try {
129
+ return await this.rawRequest('POST', '/api/kb/capture', input);
130
+ }
131
+ catch (err) {
132
+ if (isConnectionError(err)) {
133
+ this.enqueue({ op: 'capture', input });
134
+ return { id: `offline-${randomBytes(8).toString('hex')}`, audn_decision: 'add' };
135
+ }
136
+ throw err;
137
+ }
138
+ }
139
+ async query(opts) {
140
+ await this.tryFlushQueue();
141
+ const params = {};
142
+ if (opts.query)
143
+ params.query = opts.query;
144
+ if (opts.type)
145
+ params.type = opts.type;
146
+ if (opts.limit !== undefined)
147
+ params.limit = String(opts.limit);
148
+ if (opts.l1_only)
149
+ params.l1_only = 'true';
150
+ if (opts.include_stale)
151
+ params.include_stale = 'true';
152
+ if (opts.include_superseded)
153
+ params.include_superseded = 'true';
154
+ try {
155
+ return await this.rawRequest('GET', '/api/kb/query', undefined, params);
156
+ }
157
+ catch (err) {
158
+ if (isConnectionError(err)) {
159
+ return this.fallback.query(opts);
160
+ }
161
+ throw err;
162
+ }
163
+ }
164
+ async context(files) {
165
+ await this.tryFlushQueue();
166
+ try {
167
+ const result = await this.rawRequest('GET', '/api/kb/context', undefined, { files: files.join(',') });
168
+ return result.results;
169
+ }
170
+ catch (err) {
171
+ if (isConnectionError(err)) {
172
+ return this.fallback.context(files);
173
+ }
174
+ throw err;
175
+ }
176
+ }
177
+ async invalidate(files) {
178
+ await this.tryFlushQueue();
179
+ try {
180
+ return await this.rawRequest('POST', '/api/kb/invalidate', { files });
181
+ }
182
+ catch (err) {
183
+ if (isConnectionError(err)) {
184
+ this.enqueue({ op: 'invalidate', files });
185
+ return { invalidated: 0 };
186
+ }
187
+ throw err;
188
+ }
189
+ }
190
+ async getLinked(id) {
191
+ return this.fallback.getLinked(id);
192
+ }
193
+ // Delegated to the local fallback store like getLinked: delivery telemetry is
194
+ // a property of the KB the entries were read out of, and there is no remote
195
+ // route for it. Never throws -- a telemetry write must not fail a prime.
196
+ async touch(ids) {
197
+ try {
198
+ return await this.fallback.touch(ids);
199
+ }
200
+ catch {
201
+ return 0;
202
+ }
203
+ }
204
+ // Delegated to the local store like getLinked: the graph lives alongside the
205
+ // entries, and there is no remote route for it. Never throws -- a graph miss
206
+ // must degrade to "no related claims", not fail a prime.
207
+ async relatedClaims(ids, limit) {
208
+ try {
209
+ return await this.fallback.relatedClaims(ids, limit);
210
+ }
211
+ catch {
212
+ return [];
213
+ }
214
+ }
215
+ async prime(opts) {
216
+ await this.tryFlushQueue();
217
+ try {
218
+ return await this.rawRequest('POST', '/api/kb/prime', opts);
219
+ }
220
+ catch (err) {
221
+ if (isConnectionError(err)) {
222
+ return this.fallback.prime(opts);
223
+ }
224
+ throw err;
225
+ }
226
+ }
227
+ async promote(id, reason) {
228
+ return this.fallback.promote(id, reason);
229
+ }
230
+ async sync(_opts) {
231
+ return { synced: false, reason: 'local-only provider' };
232
+ }
233
+ // T2.1 (F5, D4): no /api/kb/stats route exists on the remote KB server yet,
234
+ // so this is a documented not-supported result -- NEVER throw. Returns a
235
+ // shape-complete ProviderStats (all-zero/null) so callers do not need a
236
+ // separate branch just to render an unsupported provider.
237
+ async stats(_opts) {
238
+ return {
239
+ supported: false,
240
+ reason: 'kb_stats is not supported over the remote HTTP KB provider',
241
+ totals: {
242
+ by_confidence: { CONFIRMED: 0, INFERRED: 0, UNVERIFIED: 0 },
243
+ by_type: { 'context-cache': 0, learning: 0, knowledge: 0, runbook: 0, 'user-directive': 0 },
244
+ total: 0,
245
+ },
246
+ stale: 0,
247
+ flagged: 0,
248
+ superseded: 0,
249
+ retrieval: { entries_retrieved: 0, total_uses: 0, hit_rate: null },
250
+ promote_ratio: null,
251
+ };
252
+ }
253
+ }
254
+ //# sourceMappingURL=http-provider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-provider.js","sourceRoot":"","sources":["../../../src/services/knowledge/http-provider.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import { SqliteProvider } from './sqlite-provider.js';
2
+ export interface KbProviders {
3
+ project: SqliteProvider;
4
+ global: SqliteProvider;
5
+ projectSlug: string;
6
+ }
7
+ export declare function createKbProviders(cwd?: string, remoteUrl?: string): Promise<KbProviders>;
8
+ /**
9
+ * Resolve the KB providers for a repo. `cwd` should be the repo the call is
10
+ * about -- omitting it falls back to the calling process's cwd, which is only
11
+ * correct for single-repo CLI invocations, never for server-handled tool calls.
12
+ */
13
+ export declare function getKbProviders(cwd?: string, remoteUrl?: string): Promise<KbProviders>;
14
+ export declare function resetKbProviders(): void;
15
+ //# sourceMappingURL=kb-providers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-providers.d.ts","sourceRoot":"","sources":["../../../src/services/knowledge/kb-providers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAE9F;AAiED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAe3F;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC"}
@@ -0,0 +1,92 @@
1
+ import path from 'path';
2
+ import fs from 'fs';
3
+ import { SqliteProvider } from './sqlite-provider.js';
4
+ import { resolveProjectSlug } from './project-slug.js';
5
+ import { FLEET_DIR } from '../../paths.js';
6
+ export async function createKbProviders(cwd, remoteUrl) {
7
+ return createKbProvidersForSlug(slugFor(cwd, remoteUrl), cwd ?? process.cwd());
8
+ }
9
+ // There is exactly ONE global KB, shared by every project. Now that providers
10
+ // are cached per project slug, building it inside the per-slug factory would
11
+ // open a separate connection to the same file for every repo the process
12
+ // touches -- so it gets its own single-slot cache.
13
+ let _globalProvider = null;
14
+ function getGlobalProvider() {
15
+ if (!_globalProvider) {
16
+ _globalProvider = (async () => {
17
+ const globalDir = path.join(FLEET_DIR, 'knowledge', 'global');
18
+ fs.mkdirSync(globalDir, { recursive: true });
19
+ const provider = new SqliteProvider(path.join(globalDir, 'kb.sqlite'));
20
+ await provider.init();
21
+ return provider;
22
+ })();
23
+ }
24
+ return _globalProvider;
25
+ }
26
+ // repoPath is the root the project provider anchors relative source_files at
27
+ // (the Phase 1 capture basis check and the basis hashes both use it). The global
28
+ // provider gets none on purpose: one shared KB spans every repo, so no single
29
+ // root is correct for it.
30
+ async function createKbProvidersForSlug(slug, repoPath) {
31
+ const projectDir = path.join(FLEET_DIR, 'knowledge', slug);
32
+ fs.mkdirSync(projectDir, { recursive: true });
33
+ const projectProvider = new SqliteProvider(path.join(projectDir, 'kb.sqlite'), repoPath);
34
+ await projectProvider.init();
35
+ const globalProvider = await getGlobalProvider();
36
+ return { project: projectProvider, global: globalProvider, projectSlug: slug };
37
+ }
38
+ // Keyed by (slug, repoPath), NOT slug alone and NOT a single slot. The fleet
39
+ // server is a long-lived process serving many members across many repos; a
40
+ // single memoised provider meant the first kb_* call bound every later call
41
+ // -- from every repo -- to one database. Keying by slug alone still let the
42
+ // first caller to resolve a given slug fix repoPath (load-bearing for the
43
+ // capture basis check and freshness sweep) for every later caller resolving
44
+ // to that same slug. Joined with NUL, which cannot appear in either
45
+ // component, so distinct pairs cannot collide into one key.
46
+ const _providers = new Map();
47
+ function providerKey(slug, repoPath) {
48
+ return `${slug}\0${repoPath}`;
49
+ }
50
+ // resolveProjectSlug shells out to git, so cache per (cwd, remoteUrl) pair --
51
+ // keying by cwd alone would let the first call for a directory pin its slug,
52
+ // leaving a later call that does supply a remote URL stuck with the stale
53
+ // value. Joined with NUL, which cannot appear in a path or URL, so distinct
54
+ // pairs cannot collide into one key.
55
+ const _slugCache = new Map();
56
+ function slugFor(cwd, remoteUrl) {
57
+ const dir = cwd ?? process.cwd();
58
+ const key = `${dir}\0${remoteUrl ?? ''}`;
59
+ let slug = _slugCache.get(key);
60
+ if (slug === undefined) {
61
+ slug = resolveProjectSlug(dir, remoteUrl);
62
+ _slugCache.set(key, slug);
63
+ }
64
+ return slug;
65
+ }
66
+ /**
67
+ * Resolve the KB providers for a repo. `cwd` should be the repo the call is
68
+ * about -- omitting it falls back to the calling process's cwd, which is only
69
+ * correct for single-repo CLI invocations, never for server-handled tool calls.
70
+ */
71
+ export async function getKbProviders(cwd, remoteUrl) {
72
+ const slug = slugFor(cwd, remoteUrl);
73
+ const repoPath = cwd ?? process.cwd();
74
+ const key = providerKey(slug, repoPath);
75
+ let pending = _providers.get(key);
76
+ if (!pending) {
77
+ // Store the promise, not the resolved value, so concurrent callers for the
78
+ // same (slug, repoPath) pair share one provider instead of racing to build
79
+ // two. Two different repoPaths sharing a slug get two SqliteProvider
80
+ // handles on the same kb.sqlite file -- safe, since SqliteProvider.init
81
+ // sets WAL + busy_timeout=5000.
82
+ pending = createKbProvidersForSlug(slug, repoPath);
83
+ _providers.set(key, pending);
84
+ }
85
+ return pending;
86
+ }
87
+ export function resetKbProviders() {
88
+ _providers.clear();
89
+ _slugCache.clear();
90
+ _globalProvider = null;
91
+ }
92
+ //# sourceMappingURL=kb-providers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-providers.js","sourceRoot":"","sources":["../../../src/services/knowledge/kb-providers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import { z } from 'zod';
2
+ export declare const kbScopeFields: {
3
+ repo_remote_url: z.ZodOptional<z.ZodString>;
4
+ };
5
+ //# sourceMappingURL=kb-scope-input.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-scope-input.d.ts","sourceRoot":"","sources":["../../../src/services/knowledge/kb-scope-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,aAAa;;CAGzB,CAAC"}
@@ -0,0 +1,11 @@
1
+ import { z } from 'zod';
2
+ // Single reusable zod fragment for the repo_remote_url input, spread into
3
+ // every kb_* tool schema that already takes repo_path. Keeping ONE definition
4
+ // avoids the kb_stats repo/repo_path divergence: zod strips unknown keys
5
+ // silently, so a misnamed or re-typed copy of this field would fail by
6
+ // reporting an empty KB rather than erroring.
7
+ export const kbScopeFields = {
8
+ repo_remote_url: z.string().optional()
9
+ .describe('Origin remote URL of the repo this call is about. Supply it when repo_path is a path on another host (a remote member work folder), where git cannot be shelled out. When omitted, scope is derived from repo_path as before.'),
10
+ };
11
+ //# sourceMappingURL=kb-scope-input.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-scope-input.js","sourceRoot":"","sources":["../../../src/services/knowledge/kb-scope-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0EAA0E;AAC1E,8EAA8E;AAC9E,yEAAyE;AACzE,uEAAuE;AACvE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC,QAAQ,CAAC,+NAA+N,CAAC;CAC7O,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { computeFileHash, computeFileHashBatch, checkStaleness } from './file-hash.js';
2
+ export type { FileHashResult } from './file-hash.js';
3
+ //# sourceMappingURL=kb-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-service.d.ts","sourceRoot":"","sources":["../../../src/services/knowledge/kb-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvF,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { computeFileHash, computeFileHashBatch, checkStaleness } from './file-hash.js';
2
+ //# sourceMappingURL=kb-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kb-service.js","sourceRoot":"","sources":["../../../src/services/knowledge/kb-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare function validateFilePaths(files: string[]): void;
2
+ //# sourceMappingURL=path-validation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"path-validation.d.ts","sourceRoot":"","sources":["../../../src/services/knowledge/path-validation.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAUvD"}
@@ -0,0 +1,13 @@
1
+ import path from 'node:path';
2
+ export function validateFilePaths(files) {
3
+ for (const file of files) {
4
+ if (path.isAbsolute(file)) {
5
+ throw new Error(`Path traversal rejected: absolute path not allowed: ${file}`);
6
+ }
7
+ const normalized = path.normalize(file);
8
+ if (normalized.startsWith('..') || normalized.includes(`..${path.sep}`) || normalized.includes(`${path.sep}..`)) {
9
+ throw new Error(`Path traversal rejected: ${file}`);
10
+ }
11
+ }
12
+ }
13
+ //# sourceMappingURL=path-validation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"path-validation.js","sourceRoot":"","sources":["../../../src/services/knowledge/path-validation.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,uDAAuD,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;YAChH,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC"}