@apralabs/apra-fleet 0.4.3 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1027) hide show
  1. package/README.md +114 -33
  2. package/dist/agents/backlog-groomer.md +80 -27
  3. package/dist/agents/ci-watcher.md +42 -22
  4. package/dist/agents/deployer.md +59 -24
  5. package/dist/agents/doer.md +111 -41
  6. package/dist/agents/harvester.md +60 -48
  7. package/dist/agents/integ-test-runner.md +45 -23
  8. package/dist/agents/kb-reconciler.md +34 -7
  9. package/dist/agents/plan-reviewer.md +54 -24
  10. package/dist/agents/planner.md +71 -43
  11. package/dist/agents/regression-test-runner.md +106 -78
  12. package/dist/agents/reviewer.md +170 -57
  13. package/dist/agents/schemas/backlog-groomer-output.json +1 -1
  14. package/dist/agents/schemas/deployer-output.json +5 -0
  15. package/dist/agents/schemas/doer-output.json +110 -2
  16. package/dist/agents/schemas/harvester-input.json +1 -5
  17. package/dist/agents/schemas/planner-output.json +1 -1
  18. package/dist/agents/schemas/regression-test-runner-output.json +41 -7
  19. package/dist/agents/schemas/reviewer-output.json +166 -5
  20. package/dist/cli/agent-transform.d.ts +7 -0
  21. package/dist/cli/agent-transform.js +46 -1
  22. package/dist/cli/auth.d.ts +1 -0
  23. package/dist/cli/auth.js +42 -8
  24. package/dist/cli/beads-install.d.ts +35 -0
  25. package/dist/cli/beads-install.js +125 -0
  26. package/dist/cli/beads-pin.d.ts +5 -0
  27. package/dist/cli/beads-pin.js +26 -0
  28. package/dist/cli/call.d.ts +27 -0
  29. package/dist/cli/call.js +177 -0
  30. package/dist/cli/claude-mod.d.ts +75 -0
  31. package/dist/cli/claude-mod.js +288 -0
  32. package/dist/cli/config.d.ts +24 -1
  33. package/dist/cli/config.js +69 -2
  34. package/dist/cli/dolt-install.d.ts +19 -3
  35. package/dist/cli/dolt-install.js +51 -16
  36. package/dist/cli/fleet-se-guard.d.ts +59 -0
  37. package/dist/cli/fleet-se-guard.js +231 -0
  38. package/dist/cli/install-guard.d.ts +63 -0
  39. package/dist/cli/install-guard.js +156 -4
  40. package/dist/cli/install.d.ts +89 -21
  41. package/dist/cli/install.js +778 -160
  42. package/dist/cli/kb-commit.d.ts +2 -1
  43. package/dist/cli/kb-commit.js +1 -1
  44. package/dist/cli/kb-import.d.ts +2 -1
  45. package/dist/cli/kb-import.js +1 -1
  46. package/dist/cli/kb-profile.d.ts +16 -0
  47. package/dist/cli/kb-profile.js +81 -0
  48. package/dist/cli/register-member.js +20 -3
  49. package/dist/cli/remove-member.d.ts +4 -0
  50. package/dist/cli/remove-member.js +63 -0
  51. package/dist/cli/secret.js +9 -0
  52. package/dist/cli/start.js +62 -4
  53. package/dist/cli/status.d.ts +3 -0
  54. package/dist/cli/status.js +45 -12
  55. package/dist/cli/stop.js +64 -9
  56. package/dist/cli/uninstall.js +112 -16
  57. package/dist/cli/update.d.ts +4 -0
  58. package/dist/cli/update.js +52 -5
  59. package/dist/cli/watch.js +1 -1
  60. package/dist/cli/workflow.js +3 -2
  61. package/dist/commands/kb-server.d.ts +10 -1
  62. package/dist/commands/kb-server.js +292 -11
  63. package/dist/hub-service/http-server.d.ts +5 -1
  64. package/dist/hub-service/http-server.js +55 -5
  65. package/dist/index.js +177 -9
  66. package/dist/os/child-env-bound.d.ts +77 -0
  67. package/dist/os/child-env-bound.js +171 -0
  68. package/dist/os/git-executable.d.ts +57 -0
  69. package/dist/os/git-executable.js +85 -0
  70. package/dist/os/go-concurrency.d.ts +44 -0
  71. package/dist/os/go-concurrency.js +53 -0
  72. package/dist/os/index.d.ts +1 -0
  73. package/dist/os/index.js +1 -0
  74. package/dist/os/linux.d.ts +9 -2
  75. package/dist/os/linux.js +50 -15
  76. package/dist/os/macos.d.ts +1 -1
  77. package/dist/os/macos.js +2 -11
  78. package/dist/os/os-commands.d.ts +42 -2
  79. package/dist/os/os-commands.js +2 -0
  80. package/dist/os/windows-executable.d.ts +53 -0
  81. package/dist/os/windows-executable.js +185 -0
  82. package/dist/os/windows-gitbash.d.ts +24 -14
  83. package/dist/os/windows-gitbash.js +56 -18
  84. package/dist/os/windows-wrapper.d.ts +0 -4
  85. package/dist/os/windows-wrapper.js +2 -1
  86. package/dist/os/windows.d.ts +7 -2
  87. package/dist/os/windows.js +109 -32
  88. package/dist/paths.d.ts +30 -0
  89. package/dist/paths.js +52 -0
  90. package/dist/providers/agy.d.ts +6 -2
  91. package/dist/providers/agy.js +245 -106
  92. package/dist/providers/claude-permission-denial.d.ts +7 -0
  93. package/dist/providers/claude-permission-denial.js +137 -0
  94. package/dist/providers/claude.d.ts +86 -38
  95. package/dist/providers/claude.js +426 -164
  96. package/dist/providers/codex.js +5 -1
  97. package/dist/providers/copilot.js +5 -1
  98. package/dist/providers/opencode.d.ts +10 -2
  99. package/dist/providers/opencode.js +114 -53
  100. package/dist/providers/provider.d.ts +171 -33
  101. package/dist/providers/provider.js +164 -3
  102. package/dist/services/agent-provisioner.d.ts +29 -0
  103. package/dist/services/agent-provisioner.js +107 -0
  104. package/dist/services/agent-shadow.d.ts +96 -0
  105. package/dist/services/agent-shadow.js +479 -0
  106. package/dist/services/agy-project.d.ts +9 -2
  107. package/dist/services/agy-project.js +22 -19
  108. package/dist/services/auth-socket.d.ts +43 -0
  109. package/dist/services/auth-socket.js +97 -26
  110. package/dist/services/auth-web.js +1 -1
  111. package/dist/services/budget-awareness.d.ts +11 -11
  112. package/dist/services/budget-awareness.js +15 -3
  113. package/dist/services/claude-local-scope-mcp.d.ts +19 -0
  114. package/dist/services/claude-local-scope-mcp.js +91 -0
  115. package/dist/services/cloud/aws.js +2 -1
  116. package/dist/services/cloud/lifecycle.js +19 -2
  117. package/dist/services/cloud/task-wrapper.d.ts +0 -9
  118. package/dist/services/cloud/task-wrapper.js +15 -6
  119. package/dist/services/credential-store.d.ts +33 -0
  120. package/dist/services/credential-store.js +79 -2
  121. package/dist/services/event-loop-watchdog.d.ts +32 -0
  122. package/dist/services/event-loop-watchdog.js +140 -0
  123. package/dist/services/http-transport.d.ts +78 -1
  124. package/dist/services/http-transport.js +347 -52
  125. package/dist/services/in-flight-agents.d.ts +2 -0
  126. package/dist/services/in-flight-agents.js +4 -0
  127. package/dist/services/kb-tool-profile.d.ts +36 -0
  128. package/dist/services/kb-tool-profile.js +88 -0
  129. package/dist/services/knowledge/bible-basis-filter.d.ts +53 -0
  130. package/dist/services/knowledge/bible-basis-filter.js +134 -0
  131. package/dist/services/knowledge/bible-blob-id.d.ts +44 -0
  132. package/dist/services/knowledge/bible-blob-id.js +122 -0
  133. package/dist/services/knowledge/bible-import.d.ts +173 -0
  134. package/dist/services/knowledge/bible-import.js +344 -0
  135. package/dist/services/knowledge/file-hash.d.ts +31 -0
  136. package/dist/services/knowledge/file-hash.js +155 -24
  137. package/dist/services/knowledge/http-provider.d.ts +305 -21
  138. package/dist/services/knowledge/http-provider.js +801 -119
  139. package/dist/services/knowledge/kb-config.d.ts +65 -1
  140. package/dist/services/knowledge/kb-config.js +143 -3
  141. package/dist/services/knowledge/kb-http-auth-state.d.ts +26 -0
  142. package/dist/services/knowledge/kb-http-auth-state.js +40 -0
  143. package/dist/services/knowledge/kb-maintainer-grant.d.ts +15 -0
  144. package/dist/services/knowledge/kb-maintainer-grant.js +34 -0
  145. package/dist/services/knowledge/kb-providers.d.ts +13 -2
  146. package/dist/services/knowledge/kb-providers.js +75 -37
  147. package/dist/services/knowledge/kb-removed-scope-keys.d.ts +28 -0
  148. package/dist/services/knowledge/kb-removed-scope-keys.js +59 -0
  149. package/dist/services/knowledge/kb-scopes.d.ts +14 -0
  150. package/dist/services/knowledge/kb-scopes.js +47 -0
  151. package/dist/services/knowledge/kb-self.d.ts +204 -0
  152. package/dist/services/knowledge/kb-self.js +358 -0
  153. package/dist/services/knowledge/member-bible-view.d.ts +21 -0
  154. package/dist/services/knowledge/member-bible-view.js +207 -0
  155. package/dist/services/knowledge/path-validation.d.ts +7 -0
  156. package/dist/services/knowledge/path-validation.js +11 -0
  157. package/dist/services/knowledge/pre-init.js +1 -0
  158. package/dist/services/knowledge/project-slug.js +5 -4
  159. package/dist/services/knowledge/repository-header.d.ts +77 -0
  160. package/dist/services/knowledge/repository-header.js +233 -0
  161. package/dist/services/knowledge/require-sqlite-project.d.ts +1 -1
  162. package/dist/services/knowledge/require-sqlite-project.js +1 -1
  163. package/dist/services/knowledge/sqlite-provider.d.ts +233 -11
  164. package/dist/services/knowledge/sqlite-provider.js +719 -45
  165. package/dist/services/knowledge/types.d.ts +59 -3
  166. package/dist/services/member-access-secret.d.ts +70 -0
  167. package/dist/services/member-access-secret.js +195 -0
  168. package/dist/services/member-busy.d.ts +12 -0
  169. package/dist/services/member-busy.js +20 -0
  170. package/dist/services/member-call-counts.d.ts +24 -0
  171. package/dist/services/member-call-counts.js +58 -0
  172. package/dist/services/member-config-io.d.ts +193 -0
  173. package/dist/services/member-config-io.js +446 -0
  174. package/dist/services/member-fleet-install.d.ts +710 -0
  175. package/dist/services/member-fleet-install.js +1896 -0
  176. package/dist/services/member-secret-env.d.ts +42 -0
  177. package/dist/services/member-secret-env.js +68 -0
  178. package/dist/services/member-tool-allowlist.d.ts +49 -0
  179. package/dist/services/member-tool-allowlist.js +115 -0
  180. package/dist/services/model-pricing.d.ts +19 -0
  181. package/dist/services/model-pricing.js +54 -8
  182. package/dist/services/port-holder.d.ts +86 -0
  183. package/dist/services/port-holder.js +352 -0
  184. package/dist/services/preflight-check.js +2 -0
  185. package/dist/services/registry.d.ts +13 -2
  186. package/dist/services/registry.js +27 -1
  187. package/dist/services/relay-strategy.d.ts +2 -0
  188. package/dist/services/relay-strategy.js +8 -0
  189. package/dist/services/server-lifecycle.d.ts +26 -0
  190. package/dist/services/server-lifecycle.js +85 -0
  191. package/dist/services/service-manager/index.d.ts +7 -1
  192. package/dist/services/service-manager/index.js +17 -4
  193. package/dist/services/service-manager/linux.d.ts +1 -1
  194. package/dist/services/service-manager/linux.js +15 -7
  195. package/dist/services/service-manager/macos.d.ts +11 -1
  196. package/dist/services/service-manager/macos.js +45 -7
  197. package/dist/services/service-manager/service-path.d.ts +24 -0
  198. package/dist/services/service-manager/service-path.js +55 -0
  199. package/dist/services/service-manager/types.d.ts +54 -3
  200. package/dist/services/service-manager/types.js +29 -0
  201. package/dist/services/service-manager/windows.d.ts +187 -3
  202. package/dist/services/service-manager/windows.js +684 -50
  203. package/dist/services/service-notice.d.ts +21 -0
  204. package/dist/services/service-notice.js +81 -0
  205. package/dist/services/service-start-guard.d.ts +20 -0
  206. package/dist/services/service-start-guard.js +86 -0
  207. package/dist/services/session-cost.d.ts +24 -0
  208. package/dist/services/session-cost.js +105 -0
  209. package/dist/services/session-mcp-config.d.ts +83 -0
  210. package/dist/services/session-mcp-config.js +211 -0
  211. package/dist/services/session-registry.d.ts +13 -0
  212. package/dist/services/session-registry.js +13 -0
  213. package/dist/services/session-roots.d.ts +67 -0
  214. package/dist/services/session-roots.js +126 -0
  215. package/dist/services/sftp.d.ts +34 -0
  216. package/dist/services/sftp.js +304 -76
  217. package/dist/services/shell-probe.d.ts +0 -24
  218. package/dist/services/shell-probe.js +28 -3
  219. package/dist/services/singleton.d.ts +68 -2
  220. package/dist/services/singleton.js +168 -11
  221. package/dist/services/sprint-coordination.js +9 -3
  222. package/dist/services/ssh.d.ts +27 -0
  223. package/dist/services/ssh.js +229 -38
  224. package/dist/services/stall/find-log-file.js +12 -5
  225. package/dist/services/stall/index.d.ts +1 -1
  226. package/dist/services/stall/read-log-tail.d.ts +23 -0
  227. package/dist/services/stall/read-log-tail.js +33 -2
  228. package/dist/services/stall/stall-detector.d.ts +25 -1
  229. package/dist/services/stall/stall-detector.js +85 -6
  230. package/dist/services/stall/stall-poller.d.ts +16 -0
  231. package/dist/services/stall/stall-poller.js +50 -6
  232. package/dist/services/statusline.d.ts +21 -0
  233. package/dist/services/statusline.js +97 -1
  234. package/dist/services/stopped-marker.d.ts +16 -0
  235. package/dist/services/stopped-marker.js +55 -0
  236. package/dist/services/strategy.d.ts +33 -1
  237. package/dist/services/strategy.js +86 -17
  238. package/dist/services/supervisor-service-cleanup.d.ts +52 -0
  239. package/dist/services/supervisor-service-cleanup.js +333 -0
  240. package/dist/services/tool-registry.d.ts +8 -1
  241. package/dist/services/tool-registry.js +251 -62
  242. package/dist/services/tool-scope.d.ts +91 -0
  243. package/dist/services/tool-scope.js +124 -0
  244. package/dist/services/vcs/azure-devops.js +10 -0
  245. package/dist/services/vcs/bitbucket.d.ts +22 -1
  246. package/dist/services/vcs/bitbucket.js +163 -17
  247. package/dist/services/vcs/types.d.ts +25 -2
  248. package/dist/services/watch/project-resolver.js +3 -1
  249. package/dist/skills/auto-sprint-args/SKILL.md +2 -2
  250. package/dist/skills/fleet-sprint-cli/SKILL.md +39 -15
  251. package/dist/skills/pm/SKILL.md +3 -3
  252. package/dist/skills/pm/cost.md +5 -1
  253. package/dist/skills/pm/index.md +11 -9
  254. package/dist/skills/pm/kb-reconcile.md +29 -14
  255. package/dist/skills/pm/kb-review.md +1 -0
  256. package/dist/skills/pm/sprint.md +7 -6
  257. package/dist/tools/check-status.d.ts +104 -5
  258. package/dist/tools/check-status.js +326 -57
  259. package/dist/tools/child-id-allocator.d.ts +2 -2
  260. package/dist/tools/child-id-allocator.js +1 -1
  261. package/dist/tools/code-index-heal.d.ts +8 -0
  262. package/dist/tools/code-index-heal.js +21 -0
  263. package/dist/tools/code-index-state.d.ts +45 -0
  264. package/dist/tools/code-index-state.js +115 -0
  265. package/dist/tools/code-intelligence-codebase-memory.js +6 -33
  266. package/dist/tools/code-intelligence-freshness.js +1 -1
  267. package/dist/tools/code-intelligence-gitnexus.d.ts +49 -0
  268. package/dist/tools/code-intelligence-gitnexus.js +488 -55
  269. package/dist/tools/code-intelligence-kb-enrich.js +7 -6
  270. package/dist/tools/code-intelligence-readiness.d.ts +156 -0
  271. package/dist/tools/code-intelligence-readiness.js +291 -0
  272. package/dist/tools/code-intelligence-reindex.d.ts +219 -0
  273. package/dist/tools/code-intelligence-reindex.js +602 -50
  274. package/dist/tools/code-intelligence-telemetry.d.ts +6 -1
  275. package/dist/tools/code-intelligence-telemetry.js +12 -3
  276. package/dist/tools/code-intelligence.d.ts +81 -31
  277. package/dist/tools/code-intelligence.js +156 -52
  278. package/dist/tools/compose-permissions.d.ts +57 -2
  279. package/dist/tools/compose-permissions.js +497 -44
  280. package/dist/tools/execute-command.d.ts +11 -0
  281. package/dist/tools/execute-command.js +92 -18
  282. package/dist/tools/execute-prompt.d.ts +59 -15
  283. package/dist/tools/execute-prompt.js +550 -135
  284. package/dist/tools/fleet-snapshot.d.ts +21 -0
  285. package/dist/tools/fleet-snapshot.js +78 -0
  286. package/dist/tools/kb-bible-commit.d.ts +79 -0
  287. package/dist/tools/kb-bible-commit.js +348 -0
  288. package/dist/tools/kb-capture.d.ts +15 -11
  289. package/dist/tools/kb-capture.js +42 -11
  290. package/dist/tools/kb-context.d.ts +27 -7
  291. package/dist/tools/kb-context.js +85 -14
  292. package/dist/tools/kb-demote.d.ts +27 -0
  293. package/dist/tools/kb-demote.js +37 -0
  294. package/dist/tools/kb-export.d.ts +128 -7
  295. package/dist/tools/kb-export.js +273 -67
  296. package/dist/tools/kb-feedback.d.ts +15 -9
  297. package/dist/tools/kb-feedback.js +27 -11
  298. package/dist/tools/kb-freshness-sweep.d.ts +11 -7
  299. package/dist/tools/kb-freshness-sweep.js +7 -7
  300. package/dist/tools/kb-harvest.d.ts +11 -7
  301. package/dist/tools/kb-harvest.js +35 -16
  302. package/dist/tools/kb-import.d.ts +42 -10
  303. package/dist/tools/kb-import.js +185 -160
  304. package/dist/tools/kb-invalidate.d.ts +26 -11
  305. package/dist/tools/kb-invalidate.js +118 -12
  306. package/dist/tools/kb-list.d.ts +14 -10
  307. package/dist/tools/kb-list.js +61 -13
  308. package/dist/tools/kb-promote.d.ts +11 -7
  309. package/dist/tools/kb-promote.js +16 -8
  310. package/dist/tools/kb-query.d.ts +24 -11
  311. package/dist/tools/kb-query.js +230 -23
  312. package/dist/tools/kb-reconcile-prefilter.d.ts +11 -7
  313. package/dist/tools/kb-reconcile-prefilter.js +10 -8
  314. package/dist/tools/kb-resolve-contradiction.d.ts +11 -7
  315. package/dist/tools/kb-resolve-contradiction.js +7 -7
  316. package/dist/tools/kb-session-prime.d.ts +14 -7
  317. package/dist/tools/kb-session-prime.js +127 -47
  318. package/dist/tools/kb-setup.d.ts +31 -4
  319. package/dist/tools/kb-setup.js +172 -20
  320. package/dist/tools/kb-stats.d.ts +11 -10
  321. package/dist/tools/kb-stats.js +22 -41
  322. package/dist/tools/list-members.js +6 -3
  323. package/dist/tools/member-detail.d.ts +3 -0
  324. package/dist/tools/member-detail.js +95 -20
  325. package/dist/tools/member-reservation.d.ts +2 -2
  326. package/dist/tools/provision-auth.d.ts +39 -1
  327. package/dist/tools/provision-auth.js +269 -47
  328. package/dist/tools/provision-vcs-auth.d.ts +30 -5
  329. package/dist/tools/provision-vcs-auth.js +53 -7
  330. package/dist/tools/receive-files.js +8 -3
  331. package/dist/tools/register-member.d.ts +34 -8
  332. package/dist/tools/register-member.js +76 -58
  333. package/dist/tools/remove-member.js +110 -32
  334. package/dist/tools/send-email.d.ts +2 -2
  335. package/dist/tools/send-files.js +9 -6
  336. package/dist/tools/send-message.d.ts +3 -0
  337. package/dist/tools/send-message.js +15 -2
  338. package/dist/tools/session-stats.d.ts +17 -0
  339. package/dist/tools/session-stats.js +27 -0
  340. package/dist/tools/shutdown-server.js +5 -0
  341. package/dist/tools/stop-prompt.js +3 -1
  342. package/dist/tools/update-agent-cli.d.ts +19 -0
  343. package/dist/tools/update-agent-cli.js +59 -2
  344. package/dist/tools/update-member.d.ts +13 -10
  345. package/dist/tools/update-member.js +138 -7
  346. package/dist/tools/vcs-credential-exec.d.ts +45 -3
  347. package/dist/tools/vcs-credential-exec.js +98 -13
  348. package/dist/types.d.ts +98 -1
  349. package/dist/utils/agent-helpers.js +2 -0
  350. package/dist/utils/auth-env.d.ts +15 -4
  351. package/dist/utils/auth-env.js +52 -23
  352. package/dist/utils/find-on-path.d.ts +37 -0
  353. package/dist/utils/find-on-path.js +85 -0
  354. package/dist/utils/log-helpers.d.ts +37 -0
  355. package/dist/utils/log-helpers.js +106 -20
  356. package/dist/utils/owner-only-fs.d.ts +56 -0
  357. package/dist/utils/owner-only-fs.js +98 -0
  358. package/dist/utils/process-utils.d.ts +28 -0
  359. package/dist/utils/process-utils.js +72 -0
  360. package/dist/utils/prompt-errors.js +4 -1
  361. package/dist/utils/redact-known-secrets.d.ts +17 -0
  362. package/dist/utils/redact-known-secrets.js +70 -0
  363. package/dist/utils/session-caller.d.ts +4 -2
  364. package/dist/utils/session-caller.js +3 -2
  365. package/dist/utils/shell-escape.d.ts +42 -3
  366. package/dist/utils/shell-escape.js +70 -4
  367. package/dist/utils/skill-matrix.js +1 -1
  368. package/dist/utils/ssh-error-messages.js +3 -0
  369. package/dist/utils/vcs-provider-detect.js +2 -2
  370. package/dist/utils/workspace-trust.d.ts +24 -1
  371. package/dist/utils/workspace-trust.js +21 -17
  372. package/dist/workflows/auto-sprint.js +468 -52
  373. package/package.json +15 -9
  374. package/packages/apra-fleet-client/package.json +2 -2
  375. package/packages/apra-fleet-client/src/client/api.mjs +722 -38
  376. package/packages/apra-fleet-client/src/client/auto-start.mjs +434 -0
  377. package/packages/apra-fleet-client/src/client/client.mjs +9 -0
  378. package/packages/apra-fleet-client/src/client/factory.mjs +23 -4
  379. package/packages/apra-fleet-client/src/client/reconnecting-transport.mjs +170 -0
  380. package/packages/apra-fleet-client/src/client/server-resolution.mjs +267 -30
  381. package/packages/apra-fleet-client/src/client/transport.mjs +43 -3
  382. package/packages/apra-fleet-se/apra-pm/agents/backlog-groomer.md +80 -27
  383. package/packages/apra-fleet-se/apra-pm/agents/ci-watcher.md +42 -22
  384. package/packages/apra-fleet-se/apra-pm/agents/deployer.md +59 -24
  385. package/packages/apra-fleet-se/apra-pm/agents/doer.md +111 -41
  386. package/packages/apra-fleet-se/apra-pm/agents/harvester.md +60 -48
  387. package/packages/apra-fleet-se/apra-pm/agents/integ-test-runner.md +45 -23
  388. package/packages/apra-fleet-se/apra-pm/agents/kb-reconciler.md +34 -7
  389. package/packages/apra-fleet-se/apra-pm/agents/plan-reviewer.md +54 -24
  390. package/packages/apra-fleet-se/apra-pm/agents/planner.md +71 -43
  391. package/packages/apra-fleet-se/apra-pm/agents/regression-test-runner.md +106 -78
  392. package/packages/apra-fleet-se/apra-pm/agents/reviewer.md +170 -57
  393. package/packages/apra-fleet-se/apra-pm/agents/schemas/backlog-groomer-output.json +1 -1
  394. package/packages/apra-fleet-se/apra-pm/agents/schemas/deployer-output.json +5 -0
  395. package/packages/apra-fleet-se/apra-pm/agents/schemas/doer-output.json +110 -2
  396. package/packages/apra-fleet-se/apra-pm/agents/schemas/harvester-input.json +1 -5
  397. package/packages/apra-fleet-se/apra-pm/agents/schemas/planner-output.json +1 -1
  398. package/packages/apra-fleet-se/apra-pm/agents/schemas/regression-test-runner-output.json +41 -7
  399. package/packages/apra-fleet-se/apra-pm/agents/schemas/reviewer-output.json +166 -5
  400. package/packages/apra-fleet-se/apra-pm/skills/pm/SKILL.md +3 -3
  401. package/packages/apra-fleet-se/apra-pm/skills/pm/cost.md +5 -1
  402. package/packages/apra-fleet-se/apra-pm/skills/pm/index.md +11 -9
  403. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-reconcile.md +29 -14
  404. package/packages/apra-fleet-se/apra-pm/skills/pm/kb-review.md +1 -0
  405. package/packages/apra-fleet-se/apra-pm/skills/pm/sprint.md +7 -6
  406. package/packages/apra-fleet-se/bin/cli.mjs +282 -79
  407. package/packages/apra-fleet-se/bin/serve.mjs +186 -15
  408. package/packages/apra-fleet-se/fleet-sprint/abort.mjs +234 -46
  409. package/packages/apra-fleet-se/fleet-sprint/backlog-role.mjs +93 -0
  410. package/packages/apra-fleet-se/fleet-sprint/bd-sync-command.mjs +69 -0
  411. package/packages/apra-fleet-se/fleet-sprint/beads-children.mjs +229 -53
  412. package/packages/apra-fleet-se/fleet-sprint/beads-identity-check.mjs +576 -33
  413. package/packages/apra-fleet-se/fleet-sprint/beads-identity.mjs +9 -0
  414. package/packages/apra-fleet-se/fleet-sprint/beads-lock-probe.mjs +176 -0
  415. package/packages/apra-fleet-se/fleet-sprint/beads-memory-hygiene.mjs +201 -0
  416. package/packages/apra-fleet-se/fleet-sprint/beads-reachability.mjs +126 -0
  417. package/packages/apra-fleet-se/fleet-sprint/beads-scope.mjs +271 -7
  418. package/packages/apra-fleet-se/fleet-sprint/beads-transitions.mjs +154 -8
  419. package/packages/apra-fleet-se/fleet-sprint/ci-gate.mjs +353 -0
  420. package/packages/apra-fleet-se/fleet-sprint/conflict-ladder.mjs +12 -0
  421. package/packages/apra-fleet-se/fleet-sprint/contracts.mjs +142 -3
  422. package/packages/apra-fleet-se/fleet-sprint/coordination.mjs +48 -8
  423. package/packages/apra-fleet-se/fleet-sprint/decision-notify.mjs +338 -0
  424. package/packages/apra-fleet-se/fleet-sprint/decision-wait.mjs +731 -0
  425. package/packages/apra-fleet-se/fleet-sprint/decisions.mjs +372 -0
  426. package/packages/apra-fleet-se/fleet-sprint/dispatch-accounting.mjs +270 -0
  427. package/packages/apra-fleet-se/fleet-sprint/dispatch-failure.mjs +22 -2
  428. package/packages/apra-fleet-se/fleet-sprint/dispatch-role.mjs +244 -22
  429. package/packages/apra-fleet-se/fleet-sprint/docs/README.md +56 -15
  430. package/packages/apra-fleet-se/fleet-sprint/docs/dolt-sync-redesign.md +6 -1
  431. package/packages/apra-fleet-se/fleet-sprint/docs/fleet-sprint-diagram.md +3 -3
  432. package/packages/apra-fleet-se/fleet-sprint/dolt-settle.mjs +9 -3
  433. package/packages/apra-fleet-se/fleet-sprint/dolt-sync.mjs +651 -37
  434. package/packages/apra-fleet-se/fleet-sprint/errors.mjs +282 -15
  435. package/packages/apra-fleet-se/fleet-sprint/explicit-id-create-guard.mjs +4 -4
  436. package/packages/apra-fleet-se/fleet-sprint/git-sync.mjs +207 -10
  437. package/packages/apra-fleet-se/fleet-sprint/git-topology.mjs +169 -10
  438. package/packages/apra-fleet-se/fleet-sprint/guarded-modules.mjs +88 -5
  439. package/packages/apra-fleet-se/fleet-sprint/kb-hints.mjs +181 -0
  440. package/packages/apra-fleet-se/fleet-sprint/kb-injection.mjs +64 -0
  441. package/packages/apra-fleet-se/fleet-sprint/kb-maintainer.mjs +298 -0
  442. package/packages/apra-fleet-se/fleet-sprint/kb.mjs +1896 -305
  443. package/packages/apra-fleet-se/fleet-sprint/lower-quality.mjs +39 -0
  444. package/packages/apra-fleet-se/fleet-sprint/member-align.mjs +391 -0
  445. package/packages/apra-fleet-se/fleet-sprint/member-call.mjs +374 -0
  446. package/packages/apra-fleet-se/fleet-sprint/member-init-probe.mjs +644 -0
  447. package/packages/apra-fleet-se/fleet-sprint/member-provisioning.mjs +454 -1
  448. package/packages/apra-fleet-se/fleet-sprint/member-sync.mjs +250 -29
  449. package/packages/apra-fleet-se/fleet-sprint/orphan-reclaim.mjs +153 -0
  450. package/packages/apra-fleet-se/fleet-sprint/phases/deploy.mjs +129 -0
  451. package/packages/apra-fleet-se/fleet-sprint/phases/develop.mjs +302 -52
  452. package/packages/apra-fleet-se/fleet-sprint/phases/ensure-sprint-branch.mjs +1 -0
  453. package/packages/apra-fleet-se/fleet-sprint/phases/final-review.mjs +142 -21
  454. package/packages/apra-fleet-se/fleet-sprint/phases/harvest.mjs +118 -36
  455. package/packages/apra-fleet-se/fleet-sprint/phases/integ-test.mjs +6 -6
  456. package/packages/apra-fleet-se/fleet-sprint/phases/plan.mjs +27 -18
  457. package/packages/apra-fleet-se/fleet-sprint/phases/publish-pr.mjs +99 -52
  458. package/packages/apra-fleet-se/fleet-sprint/phases/re-review.mjs +58 -10
  459. package/packages/apra-fleet-se/fleet-sprint/phases/regression-test.mjs +16 -11
  460. package/packages/apra-fleet-se/fleet-sprint/phases/replan.mjs +36 -3
  461. package/packages/apra-fleet-se/fleet-sprint/phases/review.mjs +90 -15
  462. package/packages/apra-fleet-se/fleet-sprint/pr-body.mjs +272 -0
  463. package/packages/apra-fleet-se/fleet-sprint/prompts.mjs +113 -28
  464. package/packages/apra-fleet-se/fleet-sprint/role-policies.mjs +19 -1
  465. package/packages/apra-fleet-se/fleet-sprint/runner.js +1631 -213
  466. package/packages/apra-fleet-se/fleet-sprint/se-os-commands.mjs +26 -0
  467. package/packages/apra-fleet-se/fleet-sprint/se-posix.mjs +183 -0
  468. package/packages/apra-fleet-se/fleet-sprint/se-windows.mjs +138 -0
  469. package/packages/apra-fleet-se/fleet-sprint/set-aside.mjs +288 -0
  470. package/packages/apra-fleet-se/fleet-sprint/shell-command-guard.mjs +44 -1
  471. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-sprint-cli/SKILL.md +39 -15
  472. package/packages/apra-fleet-se/fleet-sprint/skills/fleet-supervisor/SKILL.md +87 -32
  473. package/packages/apra-fleet-se/fleet-sprint/sprint-args.mjs +158 -2
  474. package/packages/apra-fleet-se/fleet-sprint/sprint-report.mjs +132 -11
  475. package/packages/apra-fleet-se/fleet-sprint/sprint-state.mjs +31 -0
  476. package/packages/apra-fleet-se/fleet-sprint/usage-limit-controller.mjs +7 -0
  477. package/packages/apra-fleet-se/fleet-sprint/vcs-auth.mjs +774 -35
  478. package/packages/apra-fleet-se/fleet-sprint/vcs-module.mjs +134 -7
  479. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/azure-devops.mjs +99 -0
  480. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/bitbucket.mjs +811 -17
  481. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/github.mjs +223 -0
  482. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/index.mjs +138 -1
  483. package/packages/apra-fleet-se/fleet-sprint/vcs-providers/shell-helpers.mjs +8 -4
  484. package/packages/apra-fleet-se/fleet-sprint/verify-block.mjs +152 -0
  485. package/packages/apra-fleet-se/fleet-sprint/viewer-extensions.mjs +460 -23
  486. package/packages/apra-fleet-se/fleet-sprint/worklists.mjs +59 -3
  487. package/packages/apra-fleet-se/package.json +2 -2
  488. package/packages/apra-fleet-se/src/supervisor/api.mjs +1059 -0
  489. package/packages/apra-fleet-se/src/supervisor/backlog-member.mjs +332 -0
  490. package/packages/apra-fleet-se/src/supervisor/backlog.mjs +982 -0
  491. package/packages/apra-fleet-se/src/supervisor/beads-identity.mjs +246 -0
  492. package/packages/apra-fleet-se/src/supervisor/beads-view.mjs +438 -0
  493. package/packages/apra-fleet-se/src/supervisor/child-port.mjs +36 -0
  494. package/packages/apra-fleet-se/src/supervisor/dashboard.mjs +1662 -0
  495. package/packages/apra-fleet-se/src/supervisor/dolt-mutex.mjs +370 -0
  496. package/packages/apra-fleet-se/src/supervisor/dolt-orphan-sweep.mjs +338 -0
  497. package/packages/apra-fleet-se/src/supervisor/fleet-members.mjs +292 -0
  498. package/packages/apra-fleet-se/src/supervisor/history-view.mjs +276 -0
  499. package/packages/apra-fleet-se/src/supervisor/history.mjs +335 -0
  500. package/packages/apra-fleet-se/src/supervisor/id-allocator.mjs +611 -0
  501. package/packages/apra-fleet-se/src/supervisor/launch-form.mjs +444 -0
  502. package/packages/apra-fleet-se/src/supervisor/ledger.mjs +629 -0
  503. package/packages/apra-fleet-se/src/supervisor/lib/exec-bd.mjs +303 -0
  504. package/packages/apra-fleet-se/src/supervisor/log-timestamp.mjs +51 -0
  505. package/packages/apra-fleet-se/src/supervisor/log-view.mjs +159 -0
  506. package/packages/apra-fleet-se/src/supervisor/proxy.mjs +499 -0
  507. package/packages/apra-fleet-se/src/supervisor/readopt.mjs +136 -0
  508. package/packages/apra-fleet-se/src/supervisor/reconcile.mjs +263 -0
  509. package/packages/apra-fleet-se/src/supervisor/rename-with-retry.mjs +87 -0
  510. package/packages/apra-fleet-se/src/supervisor/scope-overlap.mjs +327 -0
  511. package/packages/apra-fleet-se/src/supervisor/self-log.mjs +133 -0
  512. package/packages/apra-fleet-se/src/supervisor/server.mjs +542 -0
  513. package/packages/apra-fleet-se/src/supervisor/spawner.mjs +544 -0
  514. package/packages/apra-fleet-se/src/supervisor/sprint-identity.mjs +96 -0
  515. package/packages/apra-fleet-se/src/supervisor/watchdog.mjs +993 -0
  516. package/packages/apra-fleet-workflow/package.json +3 -2
  517. package/packages/apra-fleet-workflow/src/viewer/index.mjs +150 -14
  518. package/packages/apra-fleet-workflow/src/viewer/request-guard.mjs +222 -0
  519. package/packages/apra-fleet-workflow/src/viewer/run-summary.mjs +127 -0
  520. package/packages/apra-fleet-workflow/src/workflow/index.mjs +105 -7
  521. package/packages/apra-fleet-workflow/src/workflow/pricing.mjs +75 -25
  522. package/plugins/claude-code/fleet-status/.claude-plugin/plugin.json +7 -0
  523. package/plugins/claude-code/fleet-status/hooks/hooks.json +1 -0
  524. package/plugins/claude-code/fleet-status/hooks/register.tsx +906 -0
  525. package/plugins/claude-code/fleet-status/types/index.d.ts +88 -0
  526. package/skills/fleet/auth-bitbucket.md +47 -20
  527. package/skills/fleet/onboarding.md +1 -1
  528. package/skills/fleet/permissions.md +9 -0
  529. package/skills/fleet/profiles/tag-kb-reconciler.json +2 -6
  530. package/skills/fleet/skill-matrix.md +3 -3
  531. package/version.json +1 -1
  532. package/dist/cli/agent-transform.d.ts.map +0 -1
  533. package/dist/cli/agent-transform.js.map +0 -1
  534. package/dist/cli/auth.d.ts.map +0 -1
  535. package/dist/cli/auth.js.map +0 -1
  536. package/dist/cli/config.d.ts.map +0 -1
  537. package/dist/cli/config.js.map +0 -1
  538. package/dist/cli/dolt-install.d.ts.map +0 -1
  539. package/dist/cli/dolt-install.js.map +0 -1
  540. package/dist/cli/install-guard.d.ts.map +0 -1
  541. package/dist/cli/install-guard.js.map +0 -1
  542. package/dist/cli/install.d.ts.map +0 -1
  543. package/dist/cli/install.js.map +0 -1
  544. package/dist/cli/join.d.ts.map +0 -1
  545. package/dist/cli/join.js.map +0 -1
  546. package/dist/cli/kb-commit.d.ts.map +0 -1
  547. package/dist/cli/kb-commit.js.map +0 -1
  548. package/dist/cli/kb-directives.d.ts.map +0 -1
  549. package/dist/cli/kb-directives.js.map +0 -1
  550. package/dist/cli/kb-import.d.ts.map +0 -1
  551. package/dist/cli/kb-import.js.map +0 -1
  552. package/dist/cli/register-member.d.ts.map +0 -1
  553. package/dist/cli/register-member.js.map +0 -1
  554. package/dist/cli/restart.d.ts.map +0 -1
  555. package/dist/cli/restart.js.map +0 -1
  556. package/dist/cli/secret.d.ts.map +0 -1
  557. package/dist/cli/secret.js.map +0 -1
  558. package/dist/cli/spoke.d.ts.map +0 -1
  559. package/dist/cli/spoke.js.map +0 -1
  560. package/dist/cli/start.d.ts.map +0 -1
  561. package/dist/cli/start.js.map +0 -1
  562. package/dist/cli/status.d.ts.map +0 -1
  563. package/dist/cli/status.js.map +0 -1
  564. package/dist/cli/stop.d.ts.map +0 -1
  565. package/dist/cli/stop.js.map +0 -1
  566. package/dist/cli/uninstall.d.ts.map +0 -1
  567. package/dist/cli/uninstall.js.map +0 -1
  568. package/dist/cli/update.d.ts.map +0 -1
  569. package/dist/cli/update.js.map +0 -1
  570. package/dist/cli/watch.d.ts.map +0 -1
  571. package/dist/cli/watch.js.map +0 -1
  572. package/dist/cli/workflow-assets.d.ts.map +0 -1
  573. package/dist/cli/workflow-assets.js.map +0 -1
  574. package/dist/cli/workflow.d.ts.map +0 -1
  575. package/dist/cli/workflow.js.map +0 -1
  576. package/dist/commands/kb-server.d.ts.map +0 -1
  577. package/dist/commands/kb-server.js.map +0 -1
  578. package/dist/delivery-mode.d.ts.map +0 -1
  579. package/dist/delivery-mode.js.map +0 -1
  580. package/dist/hub-service/activity.d.ts.map +0 -1
  581. package/dist/hub-service/activity.js.map +0 -1
  582. package/dist/hub-service/audit-log.d.ts.map +0 -1
  583. package/dist/hub-service/audit-log.js.map +0 -1
  584. package/dist/hub-service/db/pool.d.ts.map +0 -1
  585. package/dist/hub-service/db/pool.js.map +0 -1
  586. package/dist/hub-service/enrollment.d.ts.map +0 -1
  587. package/dist/hub-service/enrollment.js.map +0 -1
  588. package/dist/hub-service/envelope-routes.d.ts.map +0 -1
  589. package/dist/hub-service/envelope-routes.js.map +0 -1
  590. package/dist/hub-service/handlers/installers.d.ts.map +0 -1
  591. package/dist/hub-service/handlers/installers.js.map +0 -1
  592. package/dist/hub-service/http-server.d.ts.map +0 -1
  593. package/dist/hub-service/http-server.js.map +0 -1
  594. package/dist/hub-service/hub-jwt.d.ts.map +0 -1
  595. package/dist/hub-service/hub-jwt.js.map +0 -1
  596. package/dist/hub-service/jwt-revocation.d.ts.map +0 -1
  597. package/dist/hub-service/jwt-revocation.js.map +0 -1
  598. package/dist/hub-service/machines.d.ts.map +0 -1
  599. package/dist/hub-service/machines.js.map +0 -1
  600. package/dist/hub-service/main.d.ts.map +0 -1
  601. package/dist/hub-service/main.js.map +0 -1
  602. package/dist/hub-service/member-tokens.d.ts.map +0 -1
  603. package/dist/hub-service/member-tokens.js.map +0 -1
  604. package/dist/hub-service/member-view.d.ts.map +0 -1
  605. package/dist/hub-service/member-view.js.map +0 -1
  606. package/dist/hub-service/members.d.ts.map +0 -1
  607. package/dist/hub-service/members.js.map +0 -1
  608. package/dist/hub-service/presence.d.ts.map +0 -1
  609. package/dist/hub-service/presence.js.map +0 -1
  610. package/dist/hub-service/project-view.d.ts.map +0 -1
  611. package/dist/hub-service/project-view.js.map +0 -1
  612. package/dist/hub-service/projects.d.ts.map +0 -1
  613. package/dist/hub-service/projects.js.map +0 -1
  614. package/dist/hub-service/relay-queue.d.ts.map +0 -1
  615. package/dist/hub-service/relay-queue.js.map +0 -1
  616. package/dist/hub-service/session-jwt.d.ts.map +0 -1
  617. package/dist/hub-service/session-jwt.js.map +0 -1
  618. package/dist/hub-service/usage.d.ts.map +0 -1
  619. package/dist/hub-service/usage.js.map +0 -1
  620. package/dist/hub-service/users.d.ts.map +0 -1
  621. package/dist/hub-service/users.js.map +0 -1
  622. package/dist/hub-service/workspaces.d.ts.map +0 -1
  623. package/dist/hub-service/workspaces.js.map +0 -1
  624. package/dist/index.d.ts.map +0 -1
  625. package/dist/index.js.map +0 -1
  626. package/dist/onboarding/text.d.ts.map +0 -1
  627. package/dist/onboarding/text.js.map +0 -1
  628. package/dist/os/git-bash-candidates.d.ts.map +0 -1
  629. package/dist/os/git-bash-candidates.js.map +0 -1
  630. package/dist/os/index.d.ts.map +0 -1
  631. package/dist/os/index.js.map +0 -1
  632. package/dist/os/linux.d.ts.map +0 -1
  633. package/dist/os/linux.js.map +0 -1
  634. package/dist/os/macos.d.ts.map +0 -1
  635. package/dist/os/macos.js.map +0 -1
  636. package/dist/os/os-commands.d.ts.map +0 -1
  637. package/dist/os/os-commands.js.map +0 -1
  638. package/dist/os/windows-gitbash.d.ts.map +0 -1
  639. package/dist/os/windows-gitbash.js.map +0 -1
  640. package/dist/os/windows-wrapper.d.ts.map +0 -1
  641. package/dist/os/windows-wrapper.js.map +0 -1
  642. package/dist/os/windows.d.ts.map +0 -1
  643. package/dist/os/windows.js.map +0 -1
  644. package/dist/paths.d.ts.map +0 -1
  645. package/dist/paths.js.map +0 -1
  646. package/dist/providers/agy.d.ts.map +0 -1
  647. package/dist/providers/agy.js.map +0 -1
  648. package/dist/providers/claude.d.ts.map +0 -1
  649. package/dist/providers/claude.js.map +0 -1
  650. package/dist/providers/codex.d.ts.map +0 -1
  651. package/dist/providers/codex.js.map +0 -1
  652. package/dist/providers/copilot.d.ts.map +0 -1
  653. package/dist/providers/copilot.js.map +0 -1
  654. package/dist/providers/email/headers.d.ts.map +0 -1
  655. package/dist/providers/email/headers.js.map +0 -1
  656. package/dist/providers/email/index.d.ts.map +0 -1
  657. package/dist/providers/email/index.js.map +0 -1
  658. package/dist/providers/email/provider.d.ts.map +0 -1
  659. package/dist/providers/email/provider.js.map +0 -1
  660. package/dist/providers/email/sendgrid.d.ts.map +0 -1
  661. package/dist/providers/email/sendgrid.js.map +0 -1
  662. package/dist/providers/email/smtp.d.ts.map +0 -1
  663. package/dist/providers/email/smtp.js.map +0 -1
  664. package/dist/providers/index.d.ts.map +0 -1
  665. package/dist/providers/index.js.map +0 -1
  666. package/dist/providers/none.d.ts.map +0 -1
  667. package/dist/providers/none.js.map +0 -1
  668. package/dist/providers/opencode.d.ts.map +0 -1
  669. package/dist/providers/opencode.js.map +0 -1
  670. package/dist/providers/provider.d.ts.map +0 -1
  671. package/dist/providers/provider.js.map +0 -1
  672. package/dist/services/agent-provisioner.d.ts.map +0 -1
  673. package/dist/services/agent-provisioner.js.map +0 -1
  674. package/dist/services/agy-project.d.ts.map +0 -1
  675. package/dist/services/agy-project.js.map +0 -1
  676. package/dist/services/auth-socket.d.ts.map +0 -1
  677. package/dist/services/auth-socket.js.map +0 -1
  678. package/dist/services/auth-web.d.ts.map +0 -1
  679. package/dist/services/auth-web.js.map +0 -1
  680. package/dist/services/budget-awareness.d.ts.map +0 -1
  681. package/dist/services/budget-awareness.js.map +0 -1
  682. package/dist/services/cloud/activity.d.ts.map +0 -1
  683. package/dist/services/cloud/activity.js.map +0 -1
  684. package/dist/services/cloud/aws.d.ts.map +0 -1
  685. package/dist/services/cloud/aws.js.map +0 -1
  686. package/dist/services/cloud/cost.d.ts.map +0 -1
  687. package/dist/services/cloud/cost.js.map +0 -1
  688. package/dist/services/cloud/idle-manager.d.ts.map +0 -1
  689. package/dist/services/cloud/idle-manager.js.map +0 -1
  690. package/dist/services/cloud/lifecycle.d.ts.map +0 -1
  691. package/dist/services/cloud/lifecycle.js.map +0 -1
  692. package/dist/services/cloud/task-wrapper.d.ts.map +0 -1
  693. package/dist/services/cloud/task-wrapper.js.map +0 -1
  694. package/dist/services/cloud/types.d.ts.map +0 -1
  695. package/dist/services/cloud/types.js.map +0 -1
  696. package/dist/services/cloud-sync.d.ts.map +0 -1
  697. package/dist/services/cloud-sync.js.map +0 -1
  698. package/dist/services/context-admission.d.ts.map +0 -1
  699. package/dist/services/context-admission.js.map +0 -1
  700. package/dist/services/credential-cleanup.d.ts.map +0 -1
  701. package/dist/services/credential-cleanup.js.map +0 -1
  702. package/dist/services/credential-store.d.ts.map +0 -1
  703. package/dist/services/credential-store.js.map +0 -1
  704. package/dist/services/event-bus.d.ts.map +0 -1
  705. package/dist/services/event-bus.js.map +0 -1
  706. package/dist/services/exit-drain.d.ts.map +0 -1
  707. package/dist/services/exit-drain.js.map +0 -1
  708. package/dist/services/file-chunker.d.ts.map +0 -1
  709. package/dist/services/file-chunker.js.map +0 -1
  710. package/dist/services/file-transfer-relay.d.ts.map +0 -1
  711. package/dist/services/file-transfer-relay.js.map +0 -1
  712. package/dist/services/file-transfer.d.ts.map +0 -1
  713. package/dist/services/file-transfer.js.map +0 -1
  714. package/dist/services/git-config.d.ts.map +0 -1
  715. package/dist/services/git-config.js.map +0 -1
  716. package/dist/services/github-app.d.ts.map +0 -1
  717. package/dist/services/github-app.js.map +0 -1
  718. package/dist/services/http-transport.d.ts.map +0 -1
  719. package/dist/services/http-transport.js.map +0 -1
  720. package/dist/services/hub-client.d.ts.map +0 -1
  721. package/dist/services/hub-client.js.map +0 -1
  722. package/dist/services/icons.d.ts.map +0 -1
  723. package/dist/services/icons.js.map +0 -1
  724. package/dist/services/jwt.d.ts.map +0 -1
  725. package/dist/services/jwt.js.map +0 -1
  726. package/dist/services/knowledge/audn.d.ts.map +0 -1
  727. package/dist/services/knowledge/audn.js.map +0 -1
  728. package/dist/services/knowledge/file-hash.d.ts.map +0 -1
  729. package/dist/services/knowledge/file-hash.js.map +0 -1
  730. package/dist/services/knowledge/http-provider.d.ts.map +0 -1
  731. package/dist/services/knowledge/http-provider.js.map +0 -1
  732. package/dist/services/knowledge/kb-config.d.ts.map +0 -1
  733. package/dist/services/knowledge/kb-config.js.map +0 -1
  734. package/dist/services/knowledge/kb-providers.d.ts.map +0 -1
  735. package/dist/services/knowledge/kb-providers.js.map +0 -1
  736. package/dist/services/knowledge/kb-scope-input.d.ts +0 -5
  737. package/dist/services/knowledge/kb-scope-input.d.ts.map +0 -1
  738. package/dist/services/knowledge/kb-scope-input.js +0 -11
  739. package/dist/services/knowledge/kb-scope-input.js.map +0 -1
  740. package/dist/services/knowledge/kb-service.d.ts.map +0 -1
  741. package/dist/services/knowledge/kb-service.js.map +0 -1
  742. package/dist/services/knowledge/path-validation.d.ts.map +0 -1
  743. package/dist/services/knowledge/path-validation.js.map +0 -1
  744. package/dist/services/knowledge/pre-init.d.ts.map +0 -1
  745. package/dist/services/knowledge/pre-init.js.map +0 -1
  746. package/dist/services/knowledge/project-slug.d.ts.map +0 -1
  747. package/dist/services/knowledge/project-slug.js.map +0 -1
  748. package/dist/services/knowledge/require-sqlite-project.d.ts.map +0 -1
  749. package/dist/services/knowledge/require-sqlite-project.js.map +0 -1
  750. package/dist/services/knowledge/sqlite-provider.d.ts.map +0 -1
  751. package/dist/services/knowledge/sqlite-provider.js.map +0 -1
  752. package/dist/services/knowledge/types.d.ts.map +0 -1
  753. package/dist/services/knowledge/types.js.map +0 -1
  754. package/dist/services/known-hosts.d.ts.map +0 -1
  755. package/dist/services/known-hosts.js.map +0 -1
  756. package/dist/services/known-sessions.d.ts.map +0 -1
  757. package/dist/services/known-sessions.js.map +0 -1
  758. package/dist/services/member-home.d.ts.map +0 -1
  759. package/dist/services/member-home.js.map +0 -1
  760. package/dist/services/member-remote-url.d.ts.map +0 -1
  761. package/dist/services/member-remote-url.js.map +0 -1
  762. package/dist/services/model-pricing.d.ts.map +0 -1
  763. package/dist/services/model-pricing.js.map +0 -1
  764. package/dist/services/onboarding.d.ts.map +0 -1
  765. package/dist/services/onboarding.js.map +0 -1
  766. package/dist/services/orphan-recovery.d.ts.map +0 -1
  767. package/dist/services/orphan-recovery.js.map +0 -1
  768. package/dist/services/pending-responses.d.ts.map +0 -1
  769. package/dist/services/pending-responses.js.map +0 -1
  770. package/dist/services/preflight-check.d.ts.map +0 -1
  771. package/dist/services/preflight-check.js.map +0 -1
  772. package/dist/services/registry.d.ts.map +0 -1
  773. package/dist/services/registry.js.map +0 -1
  774. package/dist/services/relay-context.d.ts.map +0 -1
  775. package/dist/services/relay-context.js.map +0 -1
  776. package/dist/services/relay-executor.d.ts.map +0 -1
  777. package/dist/services/relay-executor.js.map +0 -1
  778. package/dist/services/relay-request.d.ts.map +0 -1
  779. package/dist/services/relay-request.js.map +0 -1
  780. package/dist/services/relay-strategy.d.ts.map +0 -1
  781. package/dist/services/relay-strategy.js.map +0 -1
  782. package/dist/services/secret-token.d.ts.map +0 -1
  783. package/dist/services/secret-token.js.map +0 -1
  784. package/dist/services/service-manager/index.d.ts.map +0 -1
  785. package/dist/services/service-manager/index.js.map +0 -1
  786. package/dist/services/service-manager/linux.d.ts.map +0 -1
  787. package/dist/services/service-manager/linux.js.map +0 -1
  788. package/dist/services/service-manager/macos.d.ts.map +0 -1
  789. package/dist/services/service-manager/macos.js.map +0 -1
  790. package/dist/services/service-manager/types.d.ts.map +0 -1
  791. package/dist/services/service-manager/types.js.map +0 -1
  792. package/dist/services/service-manager/windows.d.ts.map +0 -1
  793. package/dist/services/service-manager/windows.js.map +0 -1
  794. package/dist/services/session-registry.d.ts.map +0 -1
  795. package/dist/services/session-registry.js.map +0 -1
  796. package/dist/services/sftp.d.ts.map +0 -1
  797. package/dist/services/sftp.js.map +0 -1
  798. package/dist/services/shell-probe.d.ts.map +0 -1
  799. package/dist/services/shell-probe.js.map +0 -1
  800. package/dist/services/singleton.d.ts.map +0 -1
  801. package/dist/services/singleton.js.map +0 -1
  802. package/dist/services/sprint-coordination.d.ts.map +0 -1
  803. package/dist/services/sprint-coordination.js.map +0 -1
  804. package/dist/services/ssh.d.ts.map +0 -1
  805. package/dist/services/ssh.js.map +0 -1
  806. package/dist/services/stall/find-log-file.d.ts.map +0 -1
  807. package/dist/services/stall/find-log-file.js.map +0 -1
  808. package/dist/services/stall/index.d.ts.map +0 -1
  809. package/dist/services/stall/index.js.map +0 -1
  810. package/dist/services/stall/log-path-resolver.d.ts.map +0 -1
  811. package/dist/services/stall/log-path-resolver.js.map +0 -1
  812. package/dist/services/stall/read-log-tail.d.ts.map +0 -1
  813. package/dist/services/stall/read-log-tail.js.map +0 -1
  814. package/dist/services/stall/stall-detector.d.ts.map +0 -1
  815. package/dist/services/stall/stall-detector.js.map +0 -1
  816. package/dist/services/stall/stall-poller.d.ts.map +0 -1
  817. package/dist/services/stall/stall-poller.js.map +0 -1
  818. package/dist/services/stall/time-utils.d.ts.map +0 -1
  819. package/dist/services/stall/time-utils.js.map +0 -1
  820. package/dist/services/statusline.d.ts.map +0 -1
  821. package/dist/services/statusline.js.map +0 -1
  822. package/dist/services/strategy.d.ts.map +0 -1
  823. package/dist/services/strategy.js.map +0 -1
  824. package/dist/services/substitution-engine.d.ts.map +0 -1
  825. package/dist/services/substitution-engine.js.map +0 -1
  826. package/dist/services/task-cleanup.d.ts.map +0 -1
  827. package/dist/services/task-cleanup.js.map +0 -1
  828. package/dist/services/token-issuer.d.ts.map +0 -1
  829. package/dist/services/token-issuer.js.map +0 -1
  830. package/dist/services/tool-registry.d.ts.map +0 -1
  831. package/dist/services/tool-registry.js.map +0 -1
  832. package/dist/services/update-check.d.ts.map +0 -1
  833. package/dist/services/update-check.js.map +0 -1
  834. package/dist/services/user-config.d.ts.map +0 -1
  835. package/dist/services/user-config.js.map +0 -1
  836. package/dist/services/vcs/azure-devops.d.ts.map +0 -1
  837. package/dist/services/vcs/azure-devops.js.map +0 -1
  838. package/dist/services/vcs/bitbucket.d.ts.map +0 -1
  839. package/dist/services/vcs/bitbucket.js.map +0 -1
  840. package/dist/services/vcs/constants.d.ts.map +0 -1
  841. package/dist/services/vcs/constants.js.map +0 -1
  842. package/dist/services/vcs/github.d.ts.map +0 -1
  843. package/dist/services/vcs/github.js.map +0 -1
  844. package/dist/services/vcs/types.d.ts.map +0 -1
  845. package/dist/services/vcs/types.js.map +0 -1
  846. package/dist/services/version-check.d.ts.map +0 -1
  847. package/dist/services/version-check.js.map +0 -1
  848. package/dist/services/watch/fleet-log.d.ts.map +0 -1
  849. package/dist/services/watch/fleet-log.js.map +0 -1
  850. package/dist/services/watch/project-resolver.d.ts.map +0 -1
  851. package/dist/services/watch/project-resolver.js.map +0 -1
  852. package/dist/services/watch/transcript-formatter.d.ts.map +0 -1
  853. package/dist/services/watch/transcript-formatter.js.map +0 -1
  854. package/dist/smoke-test.d.ts.map +0 -1
  855. package/dist/smoke-test.js.map +0 -1
  856. package/dist/tools/check-status.d.ts.map +0 -1
  857. package/dist/tools/check-status.js.map +0 -1
  858. package/dist/tools/child-id-allocator.d.ts.map +0 -1
  859. package/dist/tools/child-id-allocator.js.map +0 -1
  860. package/dist/tools/cloud-control.d.ts.map +0 -1
  861. package/dist/tools/cloud-control.js.map +0 -1
  862. package/dist/tools/code-intelligence-codebase-memory.d.ts.map +0 -1
  863. package/dist/tools/code-intelligence-codebase-memory.js.map +0 -1
  864. package/dist/tools/code-intelligence-freshness.d.ts.map +0 -1
  865. package/dist/tools/code-intelligence-freshness.js.map +0 -1
  866. package/dist/tools/code-intelligence-gitnexus.d.ts.map +0 -1
  867. package/dist/tools/code-intelligence-gitnexus.js.map +0 -1
  868. package/dist/tools/code-intelligence-kb-enrich.d.ts.map +0 -1
  869. package/dist/tools/code-intelligence-kb-enrich.js.map +0 -1
  870. package/dist/tools/code-intelligence-reindex.d.ts.map +0 -1
  871. package/dist/tools/code-intelligence-reindex.js.map +0 -1
  872. package/dist/tools/code-intelligence-telemetry.d.ts.map +0 -1
  873. package/dist/tools/code-intelligence-telemetry.js.map +0 -1
  874. package/dist/tools/code-intelligence-tests.d.ts.map +0 -1
  875. package/dist/tools/code-intelligence-tests.js.map +0 -1
  876. package/dist/tools/code-intelligence.d.ts.map +0 -1
  877. package/dist/tools/code-intelligence.js.map +0 -1
  878. package/dist/tools/compose-permissions.d.ts.map +0 -1
  879. package/dist/tools/compose-permissions.js.map +0 -1
  880. package/dist/tools/credential-store-delete.d.ts.map +0 -1
  881. package/dist/tools/credential-store-delete.js.map +0 -1
  882. package/dist/tools/credential-store-list.d.ts.map +0 -1
  883. package/dist/tools/credential-store-list.js.map +0 -1
  884. package/dist/tools/credential-store-set.d.ts.map +0 -1
  885. package/dist/tools/credential-store-set.js.map +0 -1
  886. package/dist/tools/credential-store-update.d.ts.map +0 -1
  887. package/dist/tools/credential-store-update.js.map +0 -1
  888. package/dist/tools/dolt-push-mutex.d.ts.map +0 -1
  889. package/dist/tools/dolt-push-mutex.js.map +0 -1
  890. package/dist/tools/execute-command.d.ts.map +0 -1
  891. package/dist/tools/execute-command.js.map +0 -1
  892. package/dist/tools/execute-prompt.d.ts.map +0 -1
  893. package/dist/tools/execute-prompt.js.map +0 -1
  894. package/dist/tools/get-member-model-pricing.d.ts.map +0 -1
  895. package/dist/tools/get-member-model-pricing.js.map +0 -1
  896. package/dist/tools/kb-capture.d.ts.map +0 -1
  897. package/dist/tools/kb-capture.js.map +0 -1
  898. package/dist/tools/kb-context.d.ts.map +0 -1
  899. package/dist/tools/kb-context.js.map +0 -1
  900. package/dist/tools/kb-export.d.ts.map +0 -1
  901. package/dist/tools/kb-export.js.map +0 -1
  902. package/dist/tools/kb-feedback.d.ts.map +0 -1
  903. package/dist/tools/kb-feedback.js.map +0 -1
  904. package/dist/tools/kb-freshness-sweep.d.ts.map +0 -1
  905. package/dist/tools/kb-freshness-sweep.js.map +0 -1
  906. package/dist/tools/kb-harvest.d.ts.map +0 -1
  907. package/dist/tools/kb-harvest.js.map +0 -1
  908. package/dist/tools/kb-import.d.ts.map +0 -1
  909. package/dist/tools/kb-import.js.map +0 -1
  910. package/dist/tools/kb-invalidate.d.ts.map +0 -1
  911. package/dist/tools/kb-invalidate.js.map +0 -1
  912. package/dist/tools/kb-list.d.ts.map +0 -1
  913. package/dist/tools/kb-list.js.map +0 -1
  914. package/dist/tools/kb-promote.d.ts.map +0 -1
  915. package/dist/tools/kb-promote.js.map +0 -1
  916. package/dist/tools/kb-query.d.ts.map +0 -1
  917. package/dist/tools/kb-query.js.map +0 -1
  918. package/dist/tools/kb-reconcile-prefilter.d.ts.map +0 -1
  919. package/dist/tools/kb-reconcile-prefilter.js.map +0 -1
  920. package/dist/tools/kb-resolve-contradiction.d.ts.map +0 -1
  921. package/dist/tools/kb-resolve-contradiction.js.map +0 -1
  922. package/dist/tools/kb-session-prime.d.ts.map +0 -1
  923. package/dist/tools/kb-session-prime.js.map +0 -1
  924. package/dist/tools/kb-setup.d.ts.map +0 -1
  925. package/dist/tools/kb-setup.js.map +0 -1
  926. package/dist/tools/kb-stats.d.ts.map +0 -1
  927. package/dist/tools/kb-stats.js.map +0 -1
  928. package/dist/tools/list-members.d.ts.map +0 -1
  929. package/dist/tools/list-members.js.map +0 -1
  930. package/dist/tools/member-detail.d.ts.map +0 -1
  931. package/dist/tools/member-detail.js.map +0 -1
  932. package/dist/tools/member-reservation.d.ts.map +0 -1
  933. package/dist/tools/member-reservation.js.map +0 -1
  934. package/dist/tools/monitor-task.d.ts.map +0 -1
  935. package/dist/tools/monitor-task.js.map +0 -1
  936. package/dist/tools/provision-auth.d.ts.map +0 -1
  937. package/dist/tools/provision-auth.js.map +0 -1
  938. package/dist/tools/provision-vcs-auth.d.ts.map +0 -1
  939. package/dist/tools/provision-vcs-auth.js.map +0 -1
  940. package/dist/tools/receive-files.d.ts.map +0 -1
  941. package/dist/tools/receive-files.js.map +0 -1
  942. package/dist/tools/register-member.d.ts.map +0 -1
  943. package/dist/tools/register-member.js.map +0 -1
  944. package/dist/tools/remove-member.d.ts.map +0 -1
  945. package/dist/tools/remove-member.js.map +0 -1
  946. package/dist/tools/report-status.d.ts.map +0 -1
  947. package/dist/tools/report-status.js.map +0 -1
  948. package/dist/tools/respond-to-message.d.ts.map +0 -1
  949. package/dist/tools/respond-to-message.js.map +0 -1
  950. package/dist/tools/revoke-vcs-auth.d.ts.map +0 -1
  951. package/dist/tools/revoke-vcs-auth.js.map +0 -1
  952. package/dist/tools/send-email.d.ts.map +0 -1
  953. package/dist/tools/send-email.js.map +0 -1
  954. package/dist/tools/send-files.d.ts.map +0 -1
  955. package/dist/tools/send-files.js.map +0 -1
  956. package/dist/tools/send-message.d.ts.map +0 -1
  957. package/dist/tools/send-message.js.map +0 -1
  958. package/dist/tools/setup-git-app.d.ts.map +0 -1
  959. package/dist/tools/setup-git-app.js.map +0 -1
  960. package/dist/tools/setup-ssh-key.d.ts.map +0 -1
  961. package/dist/tools/setup-ssh-key.js.map +0 -1
  962. package/dist/tools/shutdown-server.d.ts.map +0 -1
  963. package/dist/tools/shutdown-server.js.map +0 -1
  964. package/dist/tools/stop-prompt.d.ts.map +0 -1
  965. package/dist/tools/stop-prompt.js.map +0 -1
  966. package/dist/tools/update-agent-cli.d.ts.map +0 -1
  967. package/dist/tools/update-agent-cli.js.map +0 -1
  968. package/dist/tools/update-member.d.ts.map +0 -1
  969. package/dist/tools/update-member.js.map +0 -1
  970. package/dist/tools/vcs-credential-exec.d.ts.map +0 -1
  971. package/dist/tools/vcs-credential-exec.js.map +0 -1
  972. package/dist/tools/version.d.ts.map +0 -1
  973. package/dist/tools/version.js.map +0 -1
  974. package/dist/types.d.ts.map +0 -1
  975. package/dist/types.js.map +0 -1
  976. package/dist/utils/agent-helpers.d.ts.map +0 -1
  977. package/dist/utils/agent-helpers.js.map +0 -1
  978. package/dist/utils/ansi.d.ts.map +0 -1
  979. package/dist/utils/ansi.js.map +0 -1
  980. package/dist/utils/auth-env.d.ts.map +0 -1
  981. package/dist/utils/auth-env.js.map +0 -1
  982. package/dist/utils/collect-secret.d.ts.map +0 -1
  983. package/dist/utils/collect-secret.js.map +0 -1
  984. package/dist/utils/credential-validation.d.ts.map +0 -1
  985. package/dist/utils/credential-validation.js.map +0 -1
  986. package/dist/utils/crypto.d.ts.map +0 -1
  987. package/dist/utils/crypto.js.map +0 -1
  988. package/dist/utils/deep-merge.d.ts.map +0 -1
  989. package/dist/utils/deep-merge.js.map +0 -1
  990. package/dist/utils/file-permissions.d.ts.map +0 -1
  991. package/dist/utils/file-permissions.js.map +0 -1
  992. package/dist/utils/gpu-parser.d.ts.map +0 -1
  993. package/dist/utils/gpu-parser.js.map +0 -1
  994. package/dist/utils/log-helpers.d.ts.map +0 -1
  995. package/dist/utils/log-helpers.js.map +0 -1
  996. package/dist/utils/oob-timeout.d.ts.map +0 -1
  997. package/dist/utils/oob-timeout.js.map +0 -1
  998. package/dist/utils/opencode-model-validation.d.ts.map +0 -1
  999. package/dist/utils/opencode-model-validation.js.map +0 -1
  1000. package/dist/utils/pid-helpers.d.ts.map +0 -1
  1001. package/dist/utils/pid-helpers.js.map +0 -1
  1002. package/dist/utils/platform.d.ts.map +0 -1
  1003. package/dist/utils/platform.js.map +0 -1
  1004. package/dist/utils/process-utils.d.ts.map +0 -1
  1005. package/dist/utils/process-utils.js.map +0 -1
  1006. package/dist/utils/prompt-errors.d.ts.map +0 -1
  1007. package/dist/utils/prompt-errors.js.map +0 -1
  1008. package/dist/utils/resolve-member.d.ts.map +0 -1
  1009. package/dist/utils/resolve-member.js.map +0 -1
  1010. package/dist/utils/secure-input.d.ts.map +0 -1
  1011. package/dist/utils/secure-input.js.map +0 -1
  1012. package/dist/utils/session-caller.d.ts.map +0 -1
  1013. package/dist/utils/session-caller.js.map +0 -1
  1014. package/dist/utils/shell-escape.d.ts.map +0 -1
  1015. package/dist/utils/shell-escape.js.map +0 -1
  1016. package/dist/utils/skill-matrix.d.ts.map +0 -1
  1017. package/dist/utils/skill-matrix.js.map +0 -1
  1018. package/dist/utils/ssh-error-messages.d.ts.map +0 -1
  1019. package/dist/utils/ssh-error-messages.js.map +0 -1
  1020. package/dist/utils/vcs-provider-detect.d.ts.map +0 -1
  1021. package/dist/utils/vcs-provider-detect.js.map +0 -1
  1022. package/dist/utils/work-folder-validation.d.ts.map +0 -1
  1023. package/dist/utils/work-folder-validation.js.map +0 -1
  1024. package/dist/utils/workspace-trust.d.ts.map +0 -1
  1025. package/dist/utils/workspace-trust.js.map +0 -1
  1026. package/dist/version.d.ts.map +0 -1
  1027. package/dist/version.js.map +0 -1
@@ -1,9 +1,63 @@
1
1
  import http from 'node:http';
2
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;
3
+ import { DEFAULT_REQUEST_TIMEOUT_MS } from './kb-config.js';
4
+ import { isAbsoluteOrTraversing } from './path-validation.js';
5
+ import { lookupServerSecret } from '../credential-store.js';
6
+ import { recordKbHttpSuccess, recordKbHttpRejected } from './kb-http-auth-state.js';
7
+ import { REPOSITORY_HEADER, REPOSITORY_COMMIT_HEADER, REPOSITORY_BRANCH_HEADER, COMMIT_SHA, isValidRepositoryValue, isValidBranchValue, } from './repository-header.js';
8
+ export { DEFAULT_REQUEST_TIMEOUT_MS };
9
+ // Most entries one owner-tag lookup reads back. An owned entry beyond it is
10
+ // reported not-found (a refusal, never a wrong promote).
11
+ const OWNED_LOOKUP_LIMIT = 1000;
12
+ /**
13
+ * E-KB-HTTP-AUTH: the remote KB's token comes from a named fleet secret and
14
+ * that secret is missing, expired, unreadable, or was rejected by the server
15
+ * (HTTP 401) on the request and on one retry after re-reading it. The message
16
+ * names the secret and the reason, never the value. Nothing is queued: the
17
+ * caller decides whether to repeat the operation once the secret is fixed.
18
+ */
19
+ export class KbHttpAuthError extends Error {
20
+ code = 'E-KB-HTTP-AUTH';
21
+ secretName;
22
+ reason;
23
+ remediation;
24
+ /** The problem sentence, without the code prefix and remediation. */
25
+ problem;
26
+ constructor(secretName, reason, problem) {
27
+ const remediation = `apra-fleet secret --set ${secretName} --persist -y (the next KB call uses the new value; no restart needed)`;
28
+ super(`E-KB-HTTP-AUTH: ${problem} Remediation: ${remediation}`);
29
+ this.name = 'KbHttpAuthError';
30
+ this.secretName = secretName;
31
+ this.reason = reason;
32
+ this.remediation = remediation;
33
+ this.problem = problem;
34
+ }
35
+ }
36
+ /**
37
+ * A 5xx or 429: the server (or a gateway in front of it) answered, but could
38
+ * not serve the request now.
39
+ */
40
+ function isServerUnavailable(err) {
41
+ const code = err instanceof Error ? err.code : undefined;
42
+ return typeof code === 'string' && (code === 'HTTP_429' || /^HTTP_5\d\d$/.test(code));
43
+ }
44
+ /**
45
+ * A 429 or 503: the server (or a gateway in front of it) refused the request
46
+ * before handling it -- rate limiting, a restarting server, a gateway with no
47
+ * backend -- so the identical request is safe to repeat. Every other 5xx may
48
+ * follow a handled request.
49
+ */
50
+ function isRetryableStatus(err) {
51
+ const code = err instanceof Error ? err.code : undefined;
52
+ return code === 'HTTP_429' || code === 'HTTP_503';
53
+ }
54
+ function isHttp401(err) {
55
+ return err instanceof Error && err.code === 'HTTP_401';
56
+ }
57
+ /** Defensive: a server that echoes the Authorization header must not leak the token into an error. */
58
+ function redactToken(text, token) {
59
+ return token ? text.split(token).join('[REDACTED]') : text;
60
+ }
7
61
  function isConnectionError(err) {
8
62
  if (!(err instanceof Error))
9
63
  return false;
@@ -16,35 +70,333 @@ function isConnectionError(err) {
16
70
  err.message.includes('ETIMEDOUT') ||
17
71
  err.message.includes('socket hang up'));
18
72
  }
73
+ /** Longest server error text carried into a tool result. */
74
+ export const MAX_ERROR_TEXT_CHARS = 300;
75
+ /**
76
+ * Server error text made safe for a tool result: markup stripped, whitespace
77
+ * collapsed, and capped at MAX_ERROR_TEXT_CHARS (a proxy or a crashed server
78
+ * can answer with a whole HTML page).
79
+ */
80
+ export function boundErrorText(text) {
81
+ const plain = text.replace(/<[^>]*>/g, ' ').replace(/\s+/g, ' ').trim();
82
+ if (plain.length === 0)
83
+ return '(empty response body)';
84
+ if (plain.length <= MAX_ERROR_TEXT_CHARS)
85
+ return plain;
86
+ return `${plain.slice(0, MAX_ERROR_TEXT_CHARS)}... (truncated, ${plain.length} chars)`;
87
+ }
88
+ /**
89
+ * Human-readable text for an error-status response body. Handles
90
+ * problem+json (title/detail/code), the plain {error} shape, and bodies
91
+ * that are not JSON at all (never a parse failure). Always bounded.
92
+ */
93
+ function describeErrorBody(data) {
94
+ let parsed;
95
+ try {
96
+ parsed = JSON.parse(data);
97
+ }
98
+ catch {
99
+ return boundErrorText(data);
100
+ }
101
+ if (parsed === null || typeof parsed !== 'object')
102
+ return boundErrorText(data);
103
+ const body = parsed;
104
+ if (typeof body.error === 'string') {
105
+ // A problem+json body that also carries a flat `error` string (a server
106
+ // may send both) keeps its taxonomy `code` in the text too.
107
+ const code = typeof body.code === 'string' && body.code.length > 0 && !body.error.includes(body.code)
108
+ ? ` [${body.code}]` : '';
109
+ return boundErrorText(body.error + code);
110
+ }
111
+ const parts = [body.title, body.code, body.detail]
112
+ .filter((v) => typeof v === 'string' && v.length > 0);
113
+ return boundErrorText(parts.length > 0 ? parts.join(' - ') : data);
114
+ }
115
+ /** The string `code` of a JSON error body, or undefined. */
116
+ function bodyCodeOf(data) {
117
+ try {
118
+ const body = JSON.parse(data);
119
+ if (body !== null && typeof body === 'object' && typeof body.code === 'string') {
120
+ return body.code;
121
+ }
122
+ }
123
+ catch {
124
+ // not JSON: no code
125
+ }
126
+ return undefined;
127
+ }
128
+ /** True when `text` parses as JSON. */
129
+ function isJsonText(text) {
130
+ try {
131
+ JSON.parse(text);
132
+ return true;
133
+ }
134
+ catch {
135
+ return false;
136
+ }
137
+ }
138
+ /** `url` with any user:password removed, for error text. */
139
+ export function redactUrlUserinfo(url) {
140
+ try {
141
+ const parsed = new URL(url);
142
+ if (parsed.username === '' && parsed.password === '')
143
+ return url;
144
+ parsed.username = '';
145
+ parsed.password = '';
146
+ return parsed.toString().replace(/\/$/, '');
147
+ }
148
+ catch {
149
+ return url.replace(/\/\/[^/@]*@/, '//');
150
+ }
151
+ }
152
+ /**
153
+ * The two project slugs of a kb-server 409 PROJECT_MISMATCH body, or null for
154
+ * any other 409 (which is then reported as a plain HTTP error).
155
+ */
156
+ function projectMismatchOf(data) {
157
+ try {
158
+ const body = JSON.parse(data);
159
+ if (body.code !== 'PROJECT_MISMATCH')
160
+ return null;
161
+ return { server: String(body.server_project), client: String(body.client_project) };
162
+ }
163
+ catch {
164
+ return null;
165
+ }
166
+ }
167
+ /**
168
+ * A promote the server answered 404: the same "Entry not found: <id>" the
169
+ * SQLite provider throws, followed by the server's own answer (whose text
170
+ * already carries the status and the problem+json title/code/detail). The
171
+ * HTTP_404 code is kept.
172
+ */
173
+ function entryNotFoundOnServer(id, err) {
174
+ const notFound = new Error(`Entry not found: ${id} (the KB server answered ${err.message})`);
175
+ notFound.code = err.code;
176
+ return notFound;
177
+ }
178
+ /** True when the entry carries `tag`; an entry without a tags array is never owned. */
179
+ function hasTag(entry, tag) {
180
+ return Array.isArray(entry.tags) && entry.tags.includes(tag);
181
+ }
182
+ /**
183
+ * E-KB-HTTP-UNREACHABLE: the KB server could not be reached (connection
184
+ * refused, DNS failure, timeout, reset), its capabilities read answered a
185
+ * 5xx or 429 (so the request itself was never sent), or the request itself
186
+ * was answered 429 or 503 (refused before it was handled). Over http the server is
187
+ * the only source of truth, so nothing is answered from a local store or the
188
+ * checkout bible instead. Nothing is queued: the error is retryable, and the
189
+ * caller decides whether to repeat the call (the sprint engine keeps its own
190
+ * KB write queued and repeats it on its next flush).
191
+ */
192
+ export class KbHttpUnreachableError extends Error {
193
+ code = 'E-KB-HTTP-UNREACHABLE';
194
+ /** The connection error text (e.g. "connect ECONNREFUSED ..."). */
195
+ causeText;
196
+ constructor(serverUrl, operation, causeText) {
197
+ super(`E-KB-HTTP-UNREACHABLE: ${operation}: the KB server at ${serverUrl} is unreachable (${causeText}); `
198
+ + 'nothing was read or written, and no local store or bible is used instead. '
199
+ + 'Remediation: start the KB server or restore the network path to it, then repeat the call; or use a local SQLite KB (kb_setup provider sqlite).');
200
+ this.name = 'KbHttpUnreachableError';
201
+ this.causeText = causeText;
202
+ }
203
+ }
204
+ /**
205
+ * E-KB-HTTP-SERVER-ERROR: the KB server (or a gateway in front of it) answered
206
+ * a request itself with a 5xx other than 503. For a write the request reached
207
+ * the server, so whether the write took effect is unknown (a 502 or 504 can
208
+ * follow a stored write). It is not retried and nothing is queued: repeating
209
+ * it blindly could apply it twice, and a server that always answers 500 would
210
+ * be retried forever. For a read nothing was read, and no local store or
211
+ * bible answers instead.
212
+ */
213
+ export class KbHttpServerError extends Error {
214
+ code = 'E-KB-HTTP-SERVER-ERROR';
215
+ constructor(serverUrl, operation, answer, kind = 'write') {
216
+ super(`E-KB-HTTP-SERVER-ERROR: ${operation}: the KB server at ${serverUrl} answered ${answer}; `
217
+ + (kind === 'write'
218
+ ? 'whether the write took effect is unknown, so it was not retried or queued. '
219
+ + 'Remediation: check the KB server (or the gateway in front of it); once it answers normally, read the entry back (kb_query) before repeating the write.'
220
+ : 'nothing was read, and no local store or bible is used instead. '
221
+ + 'Remediation: check the KB server (or the gateway in front of it), then repeat the call.'));
222
+ this.name = 'KbHttpServerError';
223
+ }
224
+ }
225
+ /**
226
+ * Typed refusal for an operation the http KB provider does not support (and
227
+ * deliberately does not emulate through a local store).
228
+ */
229
+ export class KbHttpUnsupportedError extends Error {
230
+ code = 'E-KB-HTTP-UNSUPPORTED';
231
+ constructor(operation, outcome = 'nothing was discarded', remediation = 'run it against a local SQLite KB (kb_setup provider sqlite), or use kb_invalidate with files.') {
232
+ super(`E-KB-HTTP-UNSUPPORTED: ${operation} is not supported by the http KB provider; ${outcome}. `
233
+ + `Remediation: ${remediation}`);
234
+ this.name = 'KbHttpUnsupportedError';
235
+ }
236
+ }
237
+ /**
238
+ * Typed refusal for a KB server that serves a different project than the one
239
+ * the request is for (HTTP 409). Never answered from a local store: the
240
+ * server is reachable, it is just the wrong one.
241
+ */
242
+ export class KbHttpProjectMismatchError extends Error {
243
+ code = 'E-KB-HTTP-PROJECT-MISMATCH';
244
+ constructor(serverUrl, serverProject, clientProject) {
245
+ super(`E-KB-HTTP-PROJECT-MISMATCH: the KB server at ${serverUrl} serves project "${serverProject}", `
246
+ + `not "${clientProject}"; nothing was read or written. `
247
+ + 'Remediation: point this repo at the KB server for its own project (kb_setup provider http), '
248
+ + 'or use a local SQLite KB (kb_setup provider sqlite).');
249
+ this.name = 'KbHttpProjectMismatchError';
250
+ }
251
+ }
252
+ /** Routes every contract KB server serves. */
253
+ export const KB_REQUIRED_ROUTES = ['capture', 'query', 'promote'];
254
+ /** Routes a contract KB server may leave out; it lists the ones it serves in its capabilities. */
255
+ export const KB_OPTIONAL_ROUTES = ['context', 'prime', 'invalidate', 'feedback', 'list', 'demote'];
256
+ const KNOWN_ROUTES = [...KB_REQUIRED_ROUTES, ...KB_OPTIONAL_ROUTES];
257
+ /**
258
+ * Assumed for a server that does not serve GET /api/kb/capabilities (404 or
259
+ * 501): the route set servers had before capabilities existed. demote is not
260
+ * in it.
261
+ */
262
+ export const KB_DEFAULT_CAPABILITIES = Object.freeze({
263
+ contract: 'v1',
264
+ routes: ['capture', 'query', 'promote', 'context', 'prime', 'invalidate', 'feedback', 'list'],
265
+ branch_aware: false,
266
+ });
267
+ function defaultCapabilities() {
268
+ return { ...KB_DEFAULT_CAPABILITIES, routes: [...KB_DEFAULT_CAPABILITIES.routes] };
269
+ }
270
+ /** Body codes meaning "no entry with that id" on a 404 from an id route. */
271
+ const ENTRY_NOT_FOUND_CODES = new Set(['ENTRY_NOT_FOUND', 'E-ENTRY-NOT-FOUND']);
272
+ /** The `code` field of an HTTP error's server body, when it had one. */
273
+ function serverCodeOf(err) {
274
+ return err.serverCode;
275
+ }
276
+ /** Header carrying the project slug on every request (checked by kb-server). */
277
+ export const KB_PROJECT_HEADER = 'X-KB-Project';
19
278
  export class HttpKbProvider {
20
279
  baseUrl;
21
- token;
22
- fallback;
23
- offlineQueue = [];
24
- beforeExitHandler;
25
- constructor(url, token, fallback) {
280
+ /** baseUrl with any user:password removed: the only form put in error text. */
281
+ displayUrl;
282
+ tokenSource;
283
+ projectSlug;
284
+ requestTimeoutMs;
285
+ repository;
286
+ /**
287
+ * The server's capabilities, read once per connection: cleared when a
288
+ * request finds the server unreachable, so the first request after a
289
+ * reconnect reads them again.
290
+ */
291
+ capabilitiesRead;
292
+ // The KB server is the only source of truth: no local store or checkout
293
+ // bible answers for it, online or offline.
294
+ constructor(url, token, options = {}) {
295
+ this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
296
+ this.repository = options.repository && isValidRepositoryValue(options.repository.remote)
297
+ ? options.repository
298
+ : undefined;
26
299
  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);
300
+ this.displayUrl = redactUrlUserinfo(this.baseUrl);
301
+ this.tokenSource = token;
302
+ this.projectSlug = options.projectSlug;
303
+ }
304
+ // Nothing to release: the provider holds no queue, listener or handle.
305
+ // Kept so callers that retire a provider need not know its type.
306
+ dispose() { }
307
+ // The repository headers for one request. The commit and branch are best
308
+ // effort: an unreadable, throwing or malformed value omits that header and
309
+ // never fails the request.
310
+ repositoryHeaders() {
311
+ if (!this.repository)
312
+ return {};
313
+ const headers = { [REPOSITORY_HEADER]: this.repository.remote };
314
+ let commit;
315
+ try {
316
+ commit = this.repository.commitOf?.();
317
+ }
318
+ catch {
319
+ commit = undefined;
320
+ }
321
+ if (commit && COMMIT_SHA.test(commit))
322
+ headers[REPOSITORY_COMMIT_HEADER] = commit;
323
+ let branch;
324
+ try {
325
+ branch = this.repository.branchOf?.();
326
+ }
327
+ catch {
328
+ branch = undefined;
329
+ }
330
+ if (typeof branch === 'string' && isValidBranchValue(branch))
331
+ headers[REPOSITORY_BRANCH_HEADER] = branch;
332
+ return headers;
36
333
  }
37
- dispose() {
38
- process.removeListener('beforeExit', this.beforeExitHandler);
334
+ /**
335
+ * The token to send now. A literal is returned as is. A secret name is
336
+ * looked up (server-side lookup: allowedMembers does not apply, an expired
337
+ * record is reported and kept) and a missing/expired/unreadable secret
338
+ * raises E-KB-HTTP-AUTH before any request is sent.
339
+ */
340
+ resolveToken() {
341
+ const source = this.tokenSource;
342
+ if (typeof source === 'string')
343
+ return source;
344
+ const name = source.secretName;
345
+ let found;
346
+ try {
347
+ found = lookupServerSecret(name);
348
+ }
349
+ catch {
350
+ // Fixed text: the underlying parser/decrypt error can quote ciphertext.
351
+ throw new KbHttpAuthError(name, 'unreadable', `the KB server token comes from fleet secret "${name}", which could not be read (credential store unreadable or value could not be decrypted).`);
352
+ }
353
+ if (found.status === 'missing') {
354
+ throw new KbHttpAuthError(name, 'missing', `the KB server token comes from fleet secret "${name}", which does not exist.`);
355
+ }
356
+ if (found.status === 'expired') {
357
+ throw new KbHttpAuthError(name, 'expired', `the KB server token comes from fleet secret "${name}", which expired at ${found.expiresAt}.`);
358
+ }
359
+ return found.value;
39
360
  }
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');
361
+ /**
362
+ * One authenticated request. Literal token: exactly the old behaviour (a
363
+ * 401 is thrown as the plain HTTP_401 error, no retry). Secret name: the
364
+ * secret is looked up for this request; on 401 it is looked up once more
365
+ * and the request retried once; a second 401 raises E-KB-HTTP-AUTH.
366
+ * Records the last success / last 401 for fleet_status either way.
367
+ */
368
+ async request(method, pathname, body, queryParams) {
369
+ const secretName = typeof this.tokenSource === 'string' ? undefined : this.tokenSource.secretName;
370
+ const attempts = secretName === undefined ? 1 : 2;
371
+ // Computed once, after the first secret lookup succeeds: a missing secret
372
+ // fails before the commit and branch are read, and the 401 retry sends the
373
+ // same commit and branch.
374
+ let repoHeaders;
375
+ for (let attempt = 1;; attempt++) {
376
+ const token = this.resolveToken();
377
+ repoHeaders ??= this.repositoryHeaders();
378
+ try {
379
+ const result = await this.rawRequest(token, method, pathname, body, queryParams, secretName !== undefined, repoHeaders);
380
+ recordKbHttpSuccess(this.baseUrl);
381
+ return result;
382
+ }
383
+ catch (err) {
384
+ if (isConnectionError(err)) {
385
+ this.capabilitiesRead = undefined;
386
+ throw new KbHttpUnreachableError(this.displayUrl, `${method} ${pathname}`, err.message);
387
+ }
388
+ if (!isHttp401(err))
389
+ throw err;
390
+ recordKbHttpRejected(this.baseUrl);
391
+ if (secretName === undefined)
392
+ throw err;
393
+ if (attempt >= attempts) {
394
+ throw new KbHttpAuthError(secretName, 'rejected', `the KB server rejected the token from fleet secret "${secretName}" (HTTP 401), also on one retry after re-reading the secret.`);
395
+ }
396
+ }
44
397
  }
45
- this.offlineQueue.push(op);
46
398
  }
47
- rawRequest(method, pathname, body, queryParams) {
399
+ rawRequest(token, method, pathname, body, queryParams, nonJson401IsAuth = false, extraHeaders = {}) {
48
400
  return new Promise((resolve, reject) => {
49
401
  const parsedUrl = new URL(this.baseUrl);
50
402
  let reqPath = parsedUrl.pathname.replace(/\/$/, '') + pathname;
@@ -54,8 +406,12 @@ export class HttpKbProvider {
54
406
  const bodyStr = body !== undefined ? JSON.stringify(body) : undefined;
55
407
  const headers = {
56
408
  'Content-Type': 'application/json',
57
- 'Authorization': `Bearer ${this.token}`,
409
+ ...extraHeaders,
410
+ // Set last so no extra header can replace the bearer token.
411
+ 'Authorization': `Bearer ${token}`,
58
412
  };
413
+ if (this.projectSlug !== undefined)
414
+ headers[KB_PROJECT_HEADER] = this.projectSlug;
59
415
  if (bodyStr)
60
416
  headers['Content-Length'] = Buffer.byteLength(bodyStr).toString();
61
417
  const options = {
@@ -72,25 +428,40 @@ export class HttpKbProvider {
72
428
  let data = '';
73
429
  res.on('data', (chunk) => { data += chunk.toString(); });
74
430
  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);
431
+ const status = res.statusCode;
432
+ if (status === 409) {
433
+ const mismatch = projectMismatchOf(data);
434
+ if (mismatch) {
435
+ reject(new KbHttpProjectMismatchError(this.displayUrl, mismatch.server, mismatch.client));
436
+ return;
84
437
  }
85
438
  }
439
+ if (status !== undefined && status >= 400) {
440
+ // An auth proxy in front of the KB answers 401 with
441
+ // an empty or HTML body. For a named-secret token the message is
442
+ // fixed text, so the proxy's page never reaches the tool result.
443
+ const text = nonJson401IsAuth && status === 401 && !isJsonText(data)
444
+ ? 'KB server rejected the token'
445
+ : describeErrorBody(data);
446
+ const httpErr = new Error(redactToken(`HTTP ${status}: ${text}`, token));
447
+ httpErr.code = `HTTP_${status}`;
448
+ const serverCode = bodyCodeOf(data);
449
+ if (serverCode !== undefined)
450
+ httpErr.serverCode = serverCode;
451
+ reject(httpErr);
452
+ return;
453
+ }
454
+ try {
455
+ resolve(JSON.parse(data));
456
+ }
86
457
  catch {
87
458
  reject(new Error(`Invalid JSON response from KB server`));
88
459
  }
89
460
  });
90
461
  res.on('error', reject);
91
462
  });
92
- req.setTimeout(REQUEST_TIMEOUT_MS, () => {
93
- const err = new Error('ETIMEDOUT: KB server request timed out');
463
+ req.setTimeout(this.requestTimeoutMs, () => {
464
+ const err = new Error(`ETIMEDOUT: KB server request timed out after ${this.requestTimeoutMs} ms`);
94
465
  err.code = 'ETIMEDOUT';
95
466
  req.destroy(err);
96
467
  });
@@ -100,44 +471,170 @@ export class HttpKbProvider {
100
471
  req.end();
101
472
  });
102
473
  }
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
- }
474
+ /**
475
+ * GET /api/kb/capabilities, read once per connection (again after a
476
+ * reconnect). A server without the route is assumed to serve
477
+ * KB_DEFAULT_CAPABILITIES: it answers 404 or 501, or (a catch-all handler)
478
+ * a body carrying none of contract/routes/branch_aware. Auth,
479
+ * project-mismatch and connection errors are thrown as they are for any
480
+ * route; a body that carries some of those fields but not all, well typed,
481
+ * is E-KB-HTTP-UNSUPPORTED.
482
+ */
483
+ async capabilities() {
484
+ this.capabilitiesRead ??= this.readCapabilities();
485
+ try {
486
+ return await this.capabilitiesRead;
487
+ }
488
+ catch (err) {
489
+ this.capabilitiesRead = undefined;
490
+ throw err;
121
491
  }
122
492
  }
123
- async init() {
124
- await this.fallback.init();
493
+ async readCapabilities() {
494
+ let body;
495
+ try {
496
+ body = await this.request('GET', '/api/kb/capabilities');
497
+ }
498
+ catch (err) {
499
+ const code = err.code;
500
+ if (code === 'HTTP_404' || code === 'HTTP_501')
501
+ return defaultCapabilities();
502
+ throw this.capabilitiesHttpError(err);
503
+ }
504
+ const caps = body;
505
+ const isObject = caps !== null && typeof caps === 'object' && !Array.isArray(caps);
506
+ if (!isObject || !('contract' in caps || 'routes' in caps || 'branch_aware' in caps))
507
+ return defaultCapabilities();
508
+ if (typeof caps.contract !== 'string'
509
+ || !Array.isArray(caps.routes) || !caps.routes.every(r => typeof r === 'string')
510
+ || typeof caps.branch_aware !== 'boolean') {
511
+ throw new KbHttpUnsupportedError(`GET /api/kb/capabilities (the KB server at ${this.displayUrl} answered without {contract, routes, branch_aware})`, 'nothing was sent', 'fix the KB server so its capabilities answer carries contract (string), routes (array of route names) and branch_aware (boolean).');
512
+ }
513
+ // Unknown route names are ignored: a newer server may list routes this client does not call.
514
+ const routes = caps.routes.filter((r) => KNOWN_ROUTES.includes(r));
515
+ return { contract: caps.contract, routes, branch_aware: caps.branch_aware };
125
516
  }
126
- async capture(input) {
127
- await this.tryFlushQueue();
517
+ /**
518
+ * A failed capabilities read as the typed error callers see. A 401 (literal
519
+ * token) and the already-typed errors pass through as on any route. Any
520
+ * other HTTP status is never a raw HTTP error: a 5xx or 429 (a restarting or
521
+ * rate-limiting server, a gateway with no backend) is E-KB-HTTP-UNREACHABLE
522
+ * naming the status (the caller's own request was never sent, so it is safe
523
+ * to retry); any other status (403/405 from a gateway) is
524
+ * E-KB-HTTP-UNSUPPORTED naming the capabilities read.
525
+ */
526
+ capabilitiesHttpError(err) {
527
+ const code = err.code;
528
+ if (typeof code !== 'string' || !code.startsWith('HTTP_') || code === 'HTTP_401')
529
+ return err;
530
+ const status = Number(code.slice(5));
531
+ if (isServerUnavailable(err))
532
+ return this.serverUnavailableError('GET /api/kb/capabilities', err);
533
+ return new KbHttpUnsupportedError(`GET /api/kb/capabilities (the KB server at ${this.displayUrl} answered HTTP ${status})`, 'nothing was sent', 'fix the KB server (or the gateway in front of it) so GET /api/kb/capabilities answers {contract, routes, branch_aware}, or 404/501 when it has no such route.');
534
+ }
535
+ /**
536
+ * E-KB-HTTP-UNREACHABLE for a 5xx or 429 answer to the capabilities read,
537
+ * or a 429 or 503 answer to `operation` itself: the server's state
538
+ * (restarting, rate limiting, a gateway with no backend), never the fault
539
+ * of the request.
540
+ */
541
+ serverUnavailableError(operation, err) {
542
+ return new KbHttpUnreachableError(this.displayUrl, operation, `${operation} answered ${err.message}`);
543
+ }
544
+ /** E-KB-HTTP-UNSUPPORTED naming `route`: the server does not serve it. */
545
+ routeUnsupported(route, why) {
546
+ return new KbHttpUnsupportedError(`the ${route} route (the KB server at ${this.displayUrl} ${why})`, 'nothing was sent', `use a KB server that serves the ${route} route, or a local SQLite KB (kb_setup provider sqlite).`);
547
+ }
548
+ /** Throws E-KB-HTTP-UNSUPPORTED naming `route` unless the server's capabilities list it. */
549
+ async requireRoute(route) {
550
+ const caps = await this.capabilities();
551
+ if (!caps.routes.includes(route))
552
+ throw this.routeUnsupported(route, 'does not list it in GET /api/kb/capabilities');
553
+ }
554
+ /** True when the server's capabilities list `route`. */
555
+ async servesRoute(route) {
556
+ return (await this.capabilities()).routes.includes(route);
557
+ }
558
+ /**
559
+ * One request to a route: refused before sending when the server's
560
+ * capabilities do not list it. For an optional route a 404 or 501 also means
561
+ * "not served" and becomes E-KB-HTTP-UNSUPPORTED, never a raw HTTP error --
562
+ * except a 404 whose body code says the ENTRY is unknown (ENTRY_NOT_FOUND /
563
+ * E-ENTRY-NOT-FOUND), which is passed on for the caller to report.
564
+ */
565
+ async routeRequest(route, method, pathname, body, queryParams) {
566
+ try {
567
+ await this.requireRoute(route);
568
+ }
569
+ catch (err) {
570
+ // Name the operation the caller asked for, not the capabilities read.
571
+ if (err instanceof KbHttpUnreachableError) {
572
+ throw new KbHttpUnreachableError(this.displayUrl, `${method} ${pathname}`, err.causeText);
573
+ }
574
+ throw err;
575
+ }
128
576
  try {
129
- return await this.rawRequest('POST', '/api/kb/capture', input);
577
+ return await this.request(method, pathname, body, queryParams);
130
578
  }
131
579
  catch (err) {
132
- if (isConnectionError(err)) {
133
- this.enqueue({ op: 'capture', input });
134
- return { id: `offline-${randomBytes(8).toString('hex')}`, audn_decision: 'add' };
580
+ const code = err.code;
581
+ const optional = KB_OPTIONAL_ROUTES.includes(route);
582
+ const entryNotFound = code === 'HTTP_404' && ENTRY_NOT_FOUND_CODES.has(serverCodeOf(err) ?? '');
583
+ if (optional && !entryNotFound && (code === 'HTTP_404' || code === 'HTTP_501')) {
584
+ throw this.routeUnsupported(route, `answered ${method} ${pathname} with HTTP ${code.slice(5)}`);
135
585
  }
136
586
  throw err;
137
587
  }
138
588
  }
589
+ // Nothing to open locally: every operation is a request to the server.
590
+ async init() { }
591
+ /**
592
+ * One write request (capture, invalidate with files, feedback, promote,
593
+ * demote). Nothing is queued. Never a raw HTTP error:
594
+ * - a 429 or 503 answering the write is E-KB-HTTP-UNREACHABLE naming the
595
+ * status: the server refused it before handling it, so the caller may
596
+ * repeat it;
597
+ * - any other 5xx is E-KB-HTTP-SERVER-ERROR: the request reached the
598
+ * server, so whether it took effect is unknown and it must not be
599
+ * retried blindly;
600
+ * - a server that cannot be reached (or whose capabilities read answers
601
+ * 5xx/429, so the write is never sent) is E-KB-HTTP-UNREACHABLE, thrown
602
+ * as is for the caller to retry.
603
+ */
604
+ async writeRequest(route, pathname, body) {
605
+ try {
606
+ return await this.routeRequest(route, 'POST', pathname, body);
607
+ }
608
+ catch (err) {
609
+ throw this.answeredError(err, `POST ${pathname}`, 'write');
610
+ }
611
+ }
612
+ /**
613
+ * One read request (query, context, prime, list). A 5xx or 429 answering it
614
+ * is never a raw HTTP error: 429 and 503 are E-KB-HTTP-UNREACHABLE naming
615
+ * the status, any other 5xx is E-KB-HTTP-SERVER-ERROR naming the status.
616
+ * Nothing is answered from a local store or the bible instead.
617
+ */
618
+ async readRequest(route, method, pathname, body, queryParams) {
619
+ try {
620
+ return await this.routeRequest(route, method, pathname, body, queryParams);
621
+ }
622
+ catch (err) {
623
+ throw this.answeredError(err, `${method} ${pathname}`, 'read');
624
+ }
625
+ }
626
+ /** A 5xx or 429 answering `operation` as its typed error; any other error as is. */
627
+ answeredError(err, operation, kind) {
628
+ if (isRetryableStatus(err))
629
+ return this.serverUnavailableError(operation, err);
630
+ if (isServerUnavailable(err))
631
+ return new KbHttpServerError(this.displayUrl, operation, err.message, kind);
632
+ return err;
633
+ }
634
+ async capture(input) {
635
+ return this.writeRequest('capture', '/api/kb/capture', input);
636
+ }
139
637
  async query(opts) {
140
- await this.tryFlushQueue();
141
638
  const params = {};
142
639
  if (opts.query)
143
640
  params.query = opts.query;
@@ -151,81 +648,266 @@ export class HttpKbProvider {
151
648
  params.include_stale = 'true';
152
649
  if (opts.include_superseded)
153
650
  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
- }
651
+ if (opts.confidence?.length)
652
+ params.confidence = opts.confidence.join(',');
653
+ if (opts.exclude_disputed)
654
+ params.exclude_disputed = 'true';
655
+ if (opts.flagged_only)
656
+ params.flagged_only = 'true';
657
+ // Discrete FTS terms travel as a JSON array (a term may contain a comma).
658
+ if (opts.fts_terms?.length)
659
+ params.fts_terms = JSON.stringify(opts.fts_terms);
660
+ // Exact-id lookup (kb_query's L2 fetch), also a JSON array.
661
+ if (opts.ids?.length)
662
+ params.ids = JSON.stringify(opts.ids);
663
+ // MEMBER own-scope: the server narrows on the owner tag when the caller
664
+ // set no tag of its own; the result is re-filtered below either way, at
665
+ // every tier. A MEMBER mixed-tier read gets the other members' CONFIRMED
666
+ // entries from its CONFIRMED half (kb-self.ts getMemberSplitRead), never
667
+ // from an owner-tagged read.
668
+ const tag = opts.tag ?? opts.owner_tag;
669
+ if (tag)
670
+ params.tag = tag;
671
+ const result = await this.readRequest('query', 'GET', '/api/kb/query', undefined, params);
672
+ return opts.owner_tag ? this.keepOwned(result, opts.owner_tag, opts.tag) : result;
163
673
  }
164
- async context(files) {
165
- await this.tryFlushQueue();
166
- try {
167
- const result = await this.rawRequest('GET', '/api/kb/context', undefined, { files: files.join(',') });
674
+ async context(files, confidence, excludeDisputed, ownerTag) {
675
+ const ctxParams = { files: files.join(',') };
676
+ if (confidence?.length)
677
+ ctxParams.confidence = confidence.join(',');
678
+ if (excludeDisputed)
679
+ ctxParams.exclude_disputed = 'true';
680
+ // MEMBER own-scope: the server picks each file's newest entry among the
681
+ // caller's own (as the SQLite provider does in SQL), so another member's
682
+ // newer entry cannot hide it; ownership is re-checked below.
683
+ if (ownerTag)
684
+ ctxParams.tag = ownerTag;
685
+ const result = await this.readRequest('context', 'GET', '/api/kb/context', undefined, ctxParams);
686
+ if (!ownerTag)
168
687
  return result.results;
169
- }
170
- catch (err) {
171
- if (isConnectionError(err)) {
172
- return this.fallback.context(files);
173
- }
174
- throw err;
175
- }
688
+ return this.keepOwnedSummaries(result.results, await this.ownedIds(ownerTag));
689
+ }
690
+ async discard(_ids, _opts) {
691
+ throw new KbHttpUnsupportedError('kb_invalidate {ids} (id-level discard)');
176
692
  }
177
693
  async invalidate(files) {
178
- await this.tryFlushQueue();
694
+ return this.writeRequest('invalidate', '/api/kb/invalidate', { files });
695
+ }
696
+ /**
697
+ * kb_feedback over the remote KB: POST /api/kb/feedback with the
698
+ * memory-contract v1 kb_feedback request body {id, reason, role} (role
699
+ * carries the already-validated author). The server owns the entry, so the
700
+ * server decides stale/flagged; this method returns its response as is and
701
+ * never writes or invents confidence, and never touches a local store.
702
+ * Nothing is queued: an unreachable server or a 429/503 answer
703
+ * (E-KB-HTTP-UNREACHABLE), any other 5xx answer (E-KB-HTTP-SERVER-ERROR)
704
+ * or a refused token
705
+ * (E-KB-HTTP-AUTH) is thrown for the caller to handle.
706
+ */
707
+ async feedback(id, reason, author) {
708
+ return this.writeRequest('feedback', '/api/kb/feedback', { id, reason, role: author });
709
+ }
710
+ // No remote route for the entry graph, and no local store stands in for the
711
+ // server: an entry's links are not known here.
712
+ async getLinked(_id) {
713
+ return [];
714
+ }
715
+ // Delivery telemetry has no remote route. Nothing is written locally: the
716
+ // per-repo DB is not this KB.
717
+ async touch(_ids) {
718
+ return 0;
719
+ }
720
+ // "Is the row I hold still live CONFIRMED" is a question about a local
721
+ // store; over http there is none. The prime cold seed (the only caller)
722
+ // never runs under an http provider, so reaching this is a bug: refuse
723
+ // rather than answer from a local store.
724
+ getLiveConfirmedState(_ids) {
725
+ throw new KbHttpUnsupportedError('the bible liveness check', 'nothing was read', 'this is an internal call that must not run under the http KB provider; report it.');
726
+ }
727
+ // No remote route for related claims: degrade to "no related claims"
728
+ // rather than reading a local store.
729
+ async relatedClaims(_ids, _limit, _filter) {
730
+ return [];
731
+ }
732
+ async prime(opts) {
733
+ // owner_tag is internal (never part of the contract body); it is applied
734
+ // to the server's answer here instead.
735
+ const { owner_tag: ownerTag, ...body } = opts;
736
+ const primed = await this.readRequest('prime', 'POST', '/api/kb/prime', body);
737
+ if (!ownerTag)
738
+ return primed;
739
+ const owned = await this.ownedIds(ownerTag);
740
+ return {
741
+ ...primed,
742
+ top_entries: (primed.top_entries ?? []).filter(e => hasTag(e, ownerTag)),
743
+ fresh_summaries: this.keepOwnedSummaries(primed.fresh_summaries ?? [], owned),
744
+ };
745
+ }
746
+ // Remote-only: the id exists on the server, so a connection error is
747
+ // surfaced instead of falling back to the local store.
748
+ // Promote by id, with no list lookup first: the server refuses an unknown,
749
+ // superseded or out-of-scope id itself, and that refusal is surfaced (a 404
750
+ // as the same "Entry not found: <id>" the SQLite provider throws, any other
751
+ // status with the server's own title/code/detail). opts.ownerTag (MEMBER
752
+ // own-scope) is not checked here: which entries a caller may promote is the
753
+ // server's scope decision, not a fleet-side tag check.
754
+ async promote(id, reason, opts) {
755
+ const body = { id };
756
+ if (reason !== undefined)
757
+ body.reason = reason;
758
+ let result;
179
759
  try {
180
- return await this.rawRequest('POST', '/api/kb/invalidate', { files });
760
+ result = await this.writeRequest('promote', '/api/kb/promote', body);
181
761
  }
182
762
  catch (err) {
183
- if (isConnectionError(err)) {
184
- this.enqueue({ op: 'invalidate', files });
185
- return { invalidated: 0 };
763
+ if (err.code === 'HTTP_404') {
764
+ if (ENTRY_NOT_FOUND_CODES.has(serverCodeOf(err) ?? '')) {
765
+ throw entryNotFoundOnServer(id, err);
766
+ }
767
+ // Spec 2.9.1: an unknown entry is 404 with body code ENTRY_NOT_FOUND.
768
+ // Any other 404 is the route itself missing (a server older than
769
+ // the capabilities route that never served promote), not the entry.
770
+ throw new KbHttpUnsupportedError(`the promote route (the KB server at ${this.displayUrl} answered POST /api/kb/promote with ${err.message}, without body code ENTRY_NOT_FOUND)`, 'nothing was promoted', 'upgrade the KB server to one that serves POST /api/kb/promote and answers an unknown entry 404 with body code ENTRY_NOT_FOUND (memory-contract v1 spec 2.9.1).');
186
771
  }
187
772
  throw err;
188
773
  }
774
+ const before = result?.previous_confidence;
775
+ const after = result?.new_confidence;
776
+ if (typeof before !== 'string' || typeof after !== 'string') {
777
+ throw new Error(`kb_promote: KB server at ${this.displayUrl} returned a promote response without `
778
+ + `previous_confidence/new_confidence: ${JSON.stringify(result)}`);
779
+ }
780
+ return {
781
+ id: typeof result.id === 'string' ? result.id : id,
782
+ confidence_before: before,
783
+ confidence_after: after,
784
+ };
189
785
  }
190
- async getLinked(id) {
191
- return this.fallback.getLinked(id);
786
+ /**
787
+ * GET /api/kb/list, an optional route: a server that does not list it, or
788
+ * answers it 404/501, is E-KB-HTTP-UNSUPPORTED rather than a bare HTTP error.
789
+ */
790
+ async listRequest(params) {
791
+ return this.readRequest('list', 'GET', '/api/kb/list', undefined, params);
192
792
  }
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;
793
+ /**
794
+ * Every live entry the server holds with `ownerTag`, any tier. Reads the
795
+ * no-bump list route, so an ownership check is not counted as a retrieval.
796
+ * Asks the server to narrow on the tag and re-checks each entry, so a server
797
+ * that ignores the tag parameter cannot widen the result. Throws
798
+ * KbHttpUnsupportedError when the server returns entries without a tags
799
+ * array: ownership cannot be decided then.
800
+ */
801
+ async ownedEntries(ownerTag) {
802
+ const result = await this.listRequest({
803
+ tag: ownerTag,
804
+ confidence: 'CONFIRMED,INFERRED,UNVERIFIED',
805
+ include_stale: 'true',
806
+ limit: String(OWNED_LOOKUP_LIMIT),
807
+ });
808
+ const entries = result.results ?? [];
809
+ if (entries.some(e => !Array.isArray(e.tags))) {
810
+ throw new KbHttpUnsupportedError('member own-scope (the server returned entries without tags)', 'nothing was read', 'use a KB server that returns entry tags, or a local SQLite KB (kb_setup provider sqlite).');
202
811
  }
812
+ return entries.filter(e => hasTag(e, ownerTag));
203
813
  }
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
- }
814
+ async ownedIds(ownerTag) {
815
+ return new Set((await this.ownedEntries(ownerTag)).map(e => e.id));
214
816
  }
215
- async prime(opts) {
216
- await this.tryFlushQueue();
817
+ /**
818
+ * kb_list over the server's no-bump GET /api/kb/list route, with the same
819
+ * options as SqliteProvider.list. A MEMBER own-scope read (owner_tag) asks
820
+ * the server to narrow on that tag when the caller set no tag of its own,
821
+ * and is re-filtered on the entries' tags either way. Remote-only: the
822
+ * listing is not answered from a local store when the server is down.
823
+ */
824
+ async list(opts) {
825
+ const params = {};
826
+ if (opts.confidence?.length)
827
+ params.confidence = opts.confidence.join(',');
828
+ if (opts.type)
829
+ params.type = opts.type;
830
+ if (opts.module)
831
+ params.module = opts.module;
832
+ if (opts.symbol)
833
+ params.symbol = opts.symbol;
834
+ if (opts.exclude_disputed)
835
+ params.exclude_disputed = 'true';
836
+ if (opts.include_stale)
837
+ params.include_stale = 'true';
838
+ const tag = opts.tag ?? opts.owner_tag;
839
+ if (tag)
840
+ params.tag = tag;
841
+ // A limit is only exact when the server applied every filter itself: with
842
+ // both a caller tag and an owner tag, the owner filter runs here, after.
843
+ const filteredHere = opts.owner_tag !== undefined && opts.tag !== undefined;
844
+ if (opts.limit !== undefined && !filteredHere)
845
+ params.limit = String(opts.limit);
846
+ const result = await this.listRequest(params);
847
+ const entries = result.results ?? [];
848
+ if (opts.owner_tag === undefined)
849
+ return entries;
850
+ const owned = entries.filter(e => hasTag(e, opts.owner_tag) && (opts.tag === undefined || hasTag(e, opts.tag)));
851
+ return opts.limit !== undefined ? owned.slice(0, opts.limit) : owned;
852
+ }
853
+ /**
854
+ * Query results restricted to entries carrying ownerTag (and the caller's
855
+ * own tag filter, when it set one). Filtering happens after the server's
856
+ * limit, so a member can get fewer results than it asked for.
857
+ */
858
+ keepOwned(result, ownerTag, tag) {
859
+ const results = (result.results ?? [])
860
+ .filter(e => hasTag(e, ownerTag) && (tag === undefined || hasTag(e, tag)));
861
+ return { ...result, results, total: results.length };
862
+ }
863
+ /**
864
+ * Context summaries carry only an entry id, so ownership is decided against
865
+ * the caller's own entry ids. A summary from another member's entry, or one
866
+ * with no entry id (ownership unknown), is reported as missing for that
867
+ * file, as the SQLite provider does when the caller has no entry for it.
868
+ */
869
+ keepOwnedSummaries(results, owned) {
870
+ return results.map(r => r.entry_id === undefined || !owned.has(r.entry_id) ? { file: r.file, status: 'missing' } : r);
871
+ }
872
+ /**
873
+ * POST /api/kb/demote {id, reason, evidence_files}: an OPTIONAL route. Only
874
+ * sent when the server's capabilities list demote; otherwise (or on a 404 /
875
+ * 501 from the route) E-KB-HTTP-UNSUPPORTED naming the route, and nothing
876
+ * is changed. Like promote(), sent by id with no fleet-side tag check: the
877
+ * server enforces which ids the caller may demote (opts.ownerTag is not
878
+ * sent). An entry the server does not know is "Entry not found".
879
+ * The server validates evidence_files (spec 2.9.1); fleet checks first that
880
+ * each is repo-relative with no '..' segment and sends nothing otherwise.
881
+ */
882
+ async demote(id, reason, evidenceFiles, _opts) {
883
+ const outside = evidenceFiles.filter(isAbsoluteOrTraversing);
884
+ if (outside.length > 0) {
885
+ throw new Error(`E-DEMOTE-EVIDENCE-UNRESOLVED: kb_demote evidence is absolute or contains a '..' segment: ${outside.join(', ')}. `
886
+ + `Evidence paths are repo-relative; nothing was sent to the KB server. Entry: ${id}`);
887
+ }
888
+ let result;
217
889
  try {
218
- return await this.rawRequest('POST', '/api/kb/prime', opts);
890
+ result = await this.writeRequest('demote', '/api/kb/demote', {
891
+ id, reason, evidence_files: evidenceFiles,
892
+ });
219
893
  }
220
894
  catch (err) {
221
- if (isConnectionError(err)) {
222
- return this.fallback.prime(opts);
895
+ if (err.code === 'HTTP_404') {
896
+ throw entryNotFoundOnServer(id, err);
223
897
  }
224
898
  throw err;
225
899
  }
226
- }
227
- async promote(id, reason) {
228
- return this.fallback.promote(id, reason);
900
+ const before = result?.previous_confidence;
901
+ const after = result?.new_confidence;
902
+ if (typeof before !== 'string' || typeof after !== 'string') {
903
+ throw new Error(`kb_demote: KB server at ${this.displayUrl} returned a demote response without `
904
+ + `previous_confidence/new_confidence: ${JSON.stringify(result)}`);
905
+ }
906
+ return {
907
+ id: typeof result.id === 'string' ? result.id : id,
908
+ confidence_before: before,
909
+ confidence_after: after,
910
+ };
229
911
  }
230
912
  async sync(_opts) {
231
913
  return { synced: false, reason: 'local-only provider' };